kyvvu-langchain

LangChain and LangGraph callback handlers for Kyvvu.

Releases use LANGCHAIN_VERSION in the repository's VERSIONS file and langchain-v* tags. Changes are recorded in CHANGELOG.md.

pip install kyvvu-langchain

from kyvvu import Kyvvu
from kyvvu_langchain import KyvvuLangChainHandler, KyvvuLangGraphHandler

kv = Kyvvu(api_url="https://platform.kyvvu.com", api_key="...", agent_key="bot")
handler = KyvvuLangChainHandler(kv)
# Pass handler through config={"callbacks": [handler]} when invoking a chain.

Install langgraph separately to run LangGraph agents. The package includes both handlers; KyvvuLangGraphHandler adds node metadata and interrupt support when LangGraph is installed.

Interrupts and resumed runs

An interrupt() is recorded as a step.gate with output.decision == "deny" and output.status == "interrupted". LangGraph then finishes the root run normally, so the task closes with task.end.

In 1.0 a resumed graph run (Command(resume=...)) is recorded as a new task. Linking an interrupted task to its resumption is planned. Until then, the root task.start of each run carries the checkpointer's properties.langgraph.thread_id (and checkpoint_ns when LangGraph supplies one), which both runs share.