langchain agents langgraph code
- Repo stars 0
- Author repo skills-registry
- Domain
- AI
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @tomevault-io · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- macOS · Linux · Windows
- Runtime requirements
- Node.js · Python
- Detected file/system behavior
-
- Read-only
- Shell exec
- Network behavior
- External requests
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# LangGraph: editorial guidance
For API reference (signatures, imports, exhaustive method lists), use the **`mcpdoc` MCP tools**: `fetch_docs("https://docs.langchain.com/oss/python/langgraph/...")`. This skill is the *opinions* layer; the docs are the *facts* layer.
## When to drop down to raw `StateGraph`
Most agents do NOT need this. Use `create_agent(...)` + middleware first (see the `langchain-agents-middleware` skill). Drop down to `StateGraph` only when:
- Multiple LLM calls in a single graph with custom routing between them.
- Branches that run in parallel and merge.
- Non-message state (custom dataclasses, dicts, dataframes flowing through nodes).
- Multi-graph workflows where one graph calls another as a subgraph.
If your problem fits "one model, some tools, in a loop" — even if the loop is complex — `create_agent` is the right tool. Don't reach for `StateGraph` out of habit.
## Things the docs won't warn you about
- A node returning `{}` is a no-op; return `None` to signal "no state change" cleanly.
- `add_conditional_edges` mappings must include `END` if any branch terminates — leaving it out is a silent bug, not an error.
- `compile()` is not idempotent across `bind_tools` — rebind tools, then re-compile.
- `langgraph dev` reloads on file change; if it stops reloading, the graph likely failed to import — check the terminal for the exception.
- A graph with `interrupt()` calls but no checkpointer will throw at *invoke time*, not at *compile time*. Always pair `interrupt()` with `compile(checkpointer=...)`.
## Production essentials (rules of thumb)
- **Always pass a `thread_id`** in `config={"configurable": {"thread_id": ...}}` for any agent with persistent state. A missing `thread_id` silently starts a fresh thread.
- **`InMemorySaver` is for dev only.** Production = `PostgresSaver` (multi-instance safe) or `SqliteSaver` (single-node, low-volume). State dies with the process for `InMemorySaver`.
- **Resume an interrupted thread by passing `None` as input** with the same `thread_id`. The runtime picks up where the interrupt fired.
- **Custom state schemas need reducers.** `Annotated[list, add_messages]` appends; without the reducer, each node *replaces* the field instead of accumulating.
- **For node-level retries on raw `StateGraph`, use `RetryPolicy`.** For `create_agent` agents, prefer `ToolRetryMiddleware` / `ModelRetryMiddleware` — same effect, cleaner composition.
## Doc URLs to fetch with mcpdoc
- `https://docs.langchain.com/oss/python/langgraph/graph-api.md` — `StateGraph`, nodes, edges
- `https://docs.langchain.com/oss/python/langgraph/durable-execution.md` — checkpointers + `thread_id`
- `https://docs.langchain.com/oss/python/langgraph/streaming.md` — `stream_mode` modes
- `https://docs.langchain.com/oss/python/langgraph/persistence.md` — Postgres / Sqlite checkpointers
- `https://docs.langchain.com/oss/python/langgraph/subgraphs.md` — multi-graph composition
When the user is mid-task and you need a method signature or import path, fetch from these URLs. Don't guess.
---
> Source: [cwijayasundara/agent_cli_langchain](https://github.com/cwijayasundara/agent_cli_langchain) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-23 -->
Sections and files
Listed in source order.
sections -> When to drop down to raw StateGraph → Things the docs won't warn you about → Production essentials (rules of thumb) → Doc URLs to fetch with mcpdoc
terms -> mcpdoc MCP tools · Always pass a threadid · InMemorySaver is for dev only. · Resume an interrupted thread by passing None as input · Custom state schemas need reducers. · For node-level retries on raw StateGraph, use RetryPolicy.
files/cmd -> mcpdoc · fetch_docs("https://docs.langchain.com/oss/python/langgraph/...") · StateGraph · create_agent(...) · langchain-agents-middleware · create_agent · None · add_conditional_edges
body sha256 -> 37cd5df31a65
When to drop down to raw StateGraph
Most agents do NOT need this. Use
create_agent(...)+ middleware first (see thelangchain-agents-middlewareskill). Drop down toStateGraphonly when: Multiple LLM calls in a single graph with custom routing between them. Branches that run in parallel and merge. Non-message state (custom dataclasses, dicts, dataframes flowing through nodes). Multi-graph workflows where one graph calls another as a subgraph.Things the docs won't warn you about
A node returning
{}is a no-op; returnNoneto signal "no state change" cleanly.add_conditional_edgesmappings must includeENDif any branch terminates — leaving it out is a silent bug, not an error.compile()is not idempotent acrossbind_tools— rebind tools, then re-compile.langgraph devreloads on file change; if it stops reloading, the graph likely failed to import — check the terminal for the exception.Production essentials (rules of thumb)
Always pass a
thread_idinconfig={"configurable": {"thread_id": ...}}for any agent with persistent state. A missingthread_idsilently starts a fresh thread.InMemorySaveris for dev only. Production =PostgresSaver(multi-instance safe) orSqliteSaver(single-node, low-volume). State dies with the process forInMemorySaver. Resume an interrupted thread by passingNoneas input with the samethread_id. The runtime picks up where the interrupt fired.Doc URLs to fetch with mcpdoc
https://docs.langchain.com/oss/python/langgraph/graph-api.md—StateGraph, nodes, edgeshttps://docs.langchain.com/oss/python/langgraph/durable-execution.md— checkpointers +thread_idhttps://docs.langchain.com/oss/python/langgraph/streaming.md—stream_modemodeshttps://docs.langchain.com/oss/python/langgraph/persistence.md— Postgres / Sqlite checkpointershttps://docs.langchain.com/oss/python/langgraph/subgraphs.md— multi-graph composition