R.6

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

ClassMessage
AssertionErrorPlease remove duplicate middleware instances.
ValueErrorUnable to infer model provider for model='qwen3:4b'. Please specify 'model_provider' directly.
StructuredOutputValidationError, not in a captureFailed to parse structured output for tool 'Answer': Failed to parse data to Answer: 1 validation error for Answer
StructuredOutputValidationErrorFailed to parse structured output for tool 'Answer': Native structured output expected valid JSON for Answer, but parsing failed
MultipleStructuredOutputsError, sent to the model as textError: Model incorrectly returned multiple structured responses (Answer, Refusal) when only one is expected.
ValueErrorUnsupported schema type: <class 'typing._UnionGenericAlias'>.
ModelCallLimitExceededErrorModel call limits exceeded: run limit (1/1)
ToolCallLimitExceededErrorTool call limit reached: run limit exceeded (2/1 calls).
ValueErrorToolErrorMiddleware requires , then the names of the two handlers
ValueErrorProviderToolSearchMiddleware requires a provider with server-side tool search, but got 'ollama'; supported providers: anthropic, openai
PIIDetectionErrorDetected 1 instance(s) of email in text content
ValueErrorNumber of human decisions (1) does not match number of hanging tool calls (2).
ValueErrorMCP 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

ClassMessage
ModelRefusalError, not in a captureModel refused to produce the requested output: I can't help with that.
ValueError, not in a captureNo generations found in stream.
NotImplementedErrorstream_events(version='v2') is not supported.
NotImplementedError, empty textraised by bind_tools on a stock fake chat model

ModelRefusalError is a subclass of ModelError. ModelRefusalMiddleware raises it from a refusal block.

langgraph

ClassMessageRaised at
GraphRecursionErrorRecursion limit of 10007 reached without hitting a stop condition. You can increase the limit by setting the , then recursion_limit and config key.
InvalidUpdateErrorAt key 'value': Can receive only one value per step. Use an Annotated key to handle multiple values.
ValueErrorCheckpointer requires one or more of the following 'configurable' keys: thread_id, checkpoint_ns, checkpoint_id
AttributeError'SyncPregelLoop' object has no attribute '_put_checkpoint_fut'
NodeTimeoutErrorNode 'slow' exceeded its run timeout of 0.050s (elapsed: <seconds>).
TypeErrorstream_events(version='v3') / astream_events(version='v3') do not accept stream_mode;
UnknownInterruptErrorUnknown or already-consumed interrupt: <id>
RuntimeErrorWhen there are multiple pending interrupts, you must specify the interrupt id when resuming.
RuntimeError, not in a captureCannot 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
TypeErrorTool 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

ClassMessageRaised at
InvalidNamespaceErrorInvalid namespace label 'bob.x' found in ('users', 'bob.x'). Namespace labels cannot contain periods ('.').
TypeErrorType is not msgpack serializable: Plainthe ormsgpack encoder, in lab T13-serde-mac
ValueErrorLANGGRAPH_AES_KEY environment variable is not set.

Other packages, from the lab

ClassMessageRaised byLab folder
MCPErrorConnection closedmcp, when a stdio server exits during a callT12-mcp-mac
MCPErrorRequest 'tools/call' timed outmcp, at the timeout of a fastmcp.ClientT12-mcp-mac
RemoteProtocolErrorServer disconnected without sending a response.httpx, when an HTTP server exits during a callT12-mcp-mac
MCPErrorElicitation not supportedmcp, for a client with no elicitation handler on protocol 2026-07-28T20-mcp-edges-mac
MCPErrorTool '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 connectionT20-mcp-edges-mac
LangSmithConnectionErrorConnection error caused failure to GET /datasets in LangSmith API. Please confirm your internet connection.langsmith, from the pytest plugin with tracking on and no connectionT19-pytest-plugin-x86
ValueErrorlog_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 onT19-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 codelangsmith, atT19-pytest-plugin-x86
ValueErrorlog_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, atT21-langsmith-account-mac
LangSmithConflictError, from HTTP 409Nothing to commit: prompt has not changed since latest committhe hosted API, for push_prompt with an unchanged promptT21-langsmith-account-mac
LangSmithNotFoundError, from HTTP 404Commit not foundthe hosted API, for pull_prompt with a tag that does not existT21-langsmith-account-mac
LangSmithNotFoundErrorProject healthy-coast-30 not foundlangsmith, for a read of the experiment_name that evaluate(upload_results=False) returnedT21-langsmith-account-mac
CLI error, exit code 2Error: Docker not installed or not runninglanggraph-cli 0.4.43, for langgraph up with no Docker daemon, before any check of the keyT21-langsmith-account-mac
HTTP 409Thread is already running a task. Wait for it to finish or choose a different multitask strategy.langgraph-api 0.18.0, strategy rejectT15-agent-server-x86
ValueErrorLicense verification failed. Please ensure proper configuration:langgraph-api 0.18.0 under langgraph upT15-agent-server-x86

Warnings

CategoryMessageRaised at
LangChainBetaWarningthe module name langchain.mcp, then is in beta. It is actively being worked on, so the API may change.
LangChainBetaWarningThe middleware , then ModelRouterMiddleware and is in beta.
LangChainBetaWarningThe v3 streaming protocol on Pregel is experimental.
LangGraphDeprecatedSinceV10the name checkpoint_during, then is deprecated and will be removed. Please use, the name durability, and instead.
LangGraphDeprecatedSinceV10NodeInterrupt is deprecated. Please use , then langgraph.types.interrupt and instead.
LangGraphDeprecatedSinceV10Importing Send from langgraph.constants is deprecated.
LangGraphDeprecatedSinceV11Accessing GraphOutput via, then result[key] and is deprecated.capture 24-stream-v2.txt
UserWarning, from warnings.warnthe name durability, then has no effect when no checkpointer is present.
a logged warningDeserializing unregistered type __main__.Color from checkpoint. This will be blocked in a future version.
LangSmithBetaWarning'upload_results' parameter is in beta.
LangSmithDeprecationWarninglist_runs() is deprecated and will be removed after Jan 31, 2027., then the name of the new call
UserWarningPydantic serializer warnings:, then PydanticSerializationUnexpectedValue for the field contextpydantic, 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