Errors
Each error and warning in this manual has one class, one package that raises it, and one line at the pin, and the text below is copied from a capture.
This page is the lookup by class. Symptom, cause, fix is the lookup by symptom, with the fix for each message. Each message is copied from a capture file or a lab recording. A class marked "not in a capture" is copied from the source code. Text in angle brackets, such as <seconds>, is a mask of the capture kit. A long message is cut after its first sentence, and a cut line ends where the capture continues.
langchain
| Class | Message |
|---|---|
AssertionError | Please remove duplicate middleware instances. |
ValueError | Unable to infer model provider for model='qwen3:4b'. Please specify 'model_provider' directly. |
StructuredOutputValidationError, not in a capture | Failed to parse structured output for tool 'Answer': Failed to parse data to Answer: 1 validation error for Answer |
StructuredOutputValidationError | Failed to parse structured output for tool 'Answer': Native structured output expected valid JSON for Answer, but parsing failed |
MultipleStructuredOutputsError, sent to the model as text | Error: Model incorrectly returned multiple structured responses (Answer, Refusal) when only one is expected. |
ValueError | Unsupported schema type: <class 'typing._UnionGenericAlias'>. |
ModelCallLimitExceededError | Model call limits exceeded: run limit (1/1) |
ToolCallLimitExceededError | Tool call limit reached: run limit exceeded (2/1 calls). |
ValueError | ToolErrorMiddleware requires , then the names of the two handlers |
ValueError | ProviderToolSearchMiddleware requires a provider with server-side tool search, but got 'ollama'; supported providers: anthropic, openai |
PIIDetectionError | Detected 1 instance(s) of email in text content |
ValueError | Number of human decisions (1) does not match number of hanging tool calls (2). |
ValueError | MCP target 'server.py' is not a valid URL. |
NotImplementedError, sent to the model as an error ToolMessage after Error calling tool 'ask_legacy': | This MCP server asked for input over the legacy server-initiated elicitation path, which interrupt-based elicitation cannot answer. |
The retry text of ToolStrategy is the template Error: {error}\n Please fix your mistakes.. The agent sends it to the model as a ToolMessage, and the run goes on.
langchain-core
| Class | Message |
|---|---|
ModelRefusalError, not in a capture | Model refused to produce the requested output: I can't help with that. |
ValueError, not in a capture | No generations found in stream. |
NotImplementedError | stream_events(version='v2') is not supported. |
NotImplementedError, empty text | raised by bind_tools on a stock fake chat model |
ModelRefusalError is a subclass of ModelError. ModelRefusalMiddleware raises it from a refusal block.
langgraph
| Class | Message | Raised at |
|---|---|---|
GraphRecursionError | Recursion limit of 10007 reached without hitting a stop condition. You can increase the limit by setting the , then recursion_limit and config key. | |
InvalidUpdateError | At key 'value': Can receive only one value per step. Use an Annotated key to handle multiple values. | |
ValueError | Checkpointer requires one or more of the following 'configurable' keys: thread_id, checkpoint_ns, checkpoint_id | |
AttributeError | 'SyncPregelLoop' object has no attribute '_put_checkpoint_fut' | |
NodeTimeoutError | Node 'slow' exceeded its run timeout of 0.050s (elapsed: <seconds>). | |
TypeError | stream_events(version='v3') / astream_events(version='v3') do not accept stream_mode; | |
UnknownInterruptError | Unknown or already-consumed interrupt: <id> | |
RuntimeError | When there are multiple pending interrupts, you must specify the interrupt id when resuming. | |
RuntimeError, not in a capture | Cannot use Command(resume=...) without checkpointer | |
KeyError | 'checkpoint_ns' | lab T17-claims-mac |
KeyError | '__pregel_scratchpad', from interrupt() outside a graph, such as an MCP tool that asks for input | |
TypeError | Tool lookup returned unexpected type: <class 'str'>, for a tool named lookup |
The other error classes of langgraph.errors are GraphBubbleUp, GraphInterrupt, NodeInterrupt, ParentCommand, EmptyInputError, TaskNotFound, NodeCancelledError, and GraphDrained. GraphBubbleUp is the base class of GraphInterrupt, ParentCommand, and GraphDrained. These carry control flow, and the loop handles them. You see them only when you call a node outside a graph.
The checkpoint and store packages
| Class | Message | Raised at |
|---|---|---|
InvalidNamespaceError | Invalid namespace label 'bob.x' found in ('users', 'bob.x'). Namespace labels cannot contain periods ('.'). | |
TypeError | Type is not msgpack serializable: Plain | the ormsgpack encoder, in lab T13-serde-mac |
ValueError | LANGGRAPH_AES_KEY environment variable is not set. |
Other packages, from the lab
| Class | Message | Raised by | Lab folder |
|---|---|---|---|
MCPError | Connection closed | mcp, when a stdio server exits during a call | T12-mcp-mac |
MCPError | Request 'tools/call' timed out | mcp, at the timeout of a fastmcp.Client | T12-mcp-mac |
RemoteProtocolError | Server disconnected without sending a response. | httpx, when an HTTP server exits during a call | T12-mcp-mac |
MCPError | Elicitation not supported | mcp, for a client with no elicitation handler on protocol 2026-07-28 | T20-mcp-edges-mac |
MCPError | Tool 'ask_name' returned an InputRequiredResult to request client input, but the multi-round-trip result type (SEP-2322) only exists at MCP 2026-07-28; this connection negotiated '2025-11-25'. | the FastMCP server, on a legacy connection | T20-mcp-edges-mac |
LangSmithConnectionError | Connection error caused failure to GET /datasets in LangSmith API. Please confirm your internet connection. | langsmith, from the pytest plugin with tracking on and no connection | T19-pytest-plugin-x86 |
ValueError | log_outputs should only be called within a pytest test decorated with @pytest.mark.langsmith, and with tracing enabled (by setting the LANGSMITH_TRACING environment variable to 'true'). | langsmith, for an unmarked test with tracking on | T19-pytest-plugin-x86 |
ValueError, as a pytest INTERNALERROR with exit code 3 | --langsmith-output not supported when env varLANGSMITH_TEST_TRACKING='false'. Please remove the'--langsmith-output' option or enable test tracking. The two missing spaces are in the code | langsmith, at | T19-pytest-plugin-x86 |
ValueError | log_inputs should only be called within a pytest test decorated with @pytest.mark.langsmith, and with tracing enabled (by setting the LANGSMITH_TRACING environment variable to 'true'). | langsmith, for a marked test with tracking on and LANGSMITH_TRACING unset, at | T21-langsmith-account-mac |
LangSmithConflictError, from HTTP 409 | Nothing to commit: prompt has not changed since latest commit | the hosted API, for push_prompt with an unchanged prompt | T21-langsmith-account-mac |
LangSmithNotFoundError, from HTTP 404 | Commit not found | the hosted API, for pull_prompt with a tag that does not exist | T21-langsmith-account-mac |
LangSmithNotFoundError | Project healthy-coast-30 not found | langsmith, for a read of the experiment_name that evaluate(upload_results=False) returned | T21-langsmith-account-mac |
| CLI error, exit code 2 | Error: Docker not installed or not running | langgraph-cli 0.4.43, for langgraph up with no Docker daemon, before any check of the key | T21-langsmith-account-mac |
| HTTP 409 | Thread is already running a task. Wait for it to finish or choose a different multitask strategy. | langgraph-api 0.18.0, strategy reject | T15-agent-server-x86 |
ValueError | License verification failed. Please ensure proper configuration: | langgraph-api 0.18.0 under langgraph up | T15-agent-server-x86 |
Warnings
| Category | Message | Raised at |
|---|---|---|
LangChainBetaWarning | the module name langchain.mcp, then is in beta. It is actively being worked on, so the API may change. | |
LangChainBetaWarning | The middleware , then ModelRouterMiddleware and is in beta. | |
LangChainBetaWarning | The v3 streaming protocol on Pregel is experimental. | |
LangGraphDeprecatedSinceV10 | the name checkpoint_during, then is deprecated and will be removed. Please use, the name durability, and instead. | |
LangGraphDeprecatedSinceV10 | NodeInterrupt is deprecated. Please use , then langgraph.types.interrupt and instead. | |
LangGraphDeprecatedSinceV10 | Importing Send from langgraph.constants is deprecated. | |
LangGraphDeprecatedSinceV11 | Accessing GraphOutput via, then result[key] and is deprecated. | capture 24-stream-v2.txt |
UserWarning, from warnings.warn | the name durability, then has no effect when no checkpointer is present. | |
| a logged warning | Deserializing unregistered type __main__.Color from checkpoint. This will be blocked in a future version. | |
LangSmithBetaWarning | 'upload_results' parameter is in beta. | |
LangSmithDeprecationWarning | list_runs() is deprecated and will be removed after Jan 31, 2027., then the name of the new call | |
UserWarning | Pydantic serializer warnings:, then PydanticSerializationUnexpectedValue for the field context | pydantic, for a context dict on an agent with no context_schema |
LangChain (Python): langchain, langchain-core, langgraph, deepagents, langsmith 1.5.0 · c2f4036 · 2026-11-11 · Edition 2026.11