ErrLookup › langchain-ai/deepagents
langchain-ai/deepagents
The batteries-included agent harness. · Python · 394 source files
Analyzed at a1af029e6e on 2026-08-29. 725 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| modes can only be provided when agent is a factory | exception | error | python, validation, model-spec, config |
| models can only be provided when agent is a factory | exception | error | python, validation, model-spec, config |
-32601 Method not found: session/load | error_code | error | python, model-spec, format, config |
-32002 Resource not found: session_id | error_code | error | python, toml, type-error, config, allowlist |
-32602 cwd: must match the working directory used to create the session | error_code | error | python, toml, validation, config, allowlist |
| session/load requires an agent compiled with a checkpointer | exception | error | python, toml, config-file, oserror, io |
| Agent initialization failed | exception | critical | acp, agent-initialization, factory, runtime-error |
-32600 ACP limitation: this agent raised a free-form LangGraph interrupt(), which ACP c | error_code | error | acp, interrupt, human-in-the-loop, protocol-limitation, json-rpc |
| Audio is not currently supported. | exception | error | acp, audio, not-implemented, content-blocks |
| Could not parse embedded resource block. Block expected eith | exception | error | acp, embedded-resource, validation, schema, valueerror |
| dcode: {message} | console | error | cli, startup, environment, exit-code-2, dcode |
| question text must not be blank | validation | error | validation, ask-user, dcode, valueerror |
| choice has a blank 'value': {choice!r} | validation | error | validation, ask-user, dcode, valueerror, choices |
| {question_type} question {question_text!r} requires a non-em | validation | error | validation, ask-user, dcode, valueerror, choices |
| {question_type} question {question_text!r} must not define ' | validation | error | validation, ask-user, dcode, valueerror, schema |
| ask_user requires at least one question | validation | error | validation, ask-user, dcode, valueerror |
| debug log directory is not a real directory: {path} | exception | error | security, filesystem, symlink, windows |
| debug log directory is not owned by the current user: {path} | exception | error | permissions, ownership, filesystem, security |
| Invalid agent name: {agent_name!r}. Agent names can only con | validation | error | validation, input-validation, path-traversal |
| Invalid agent name: {agent_name!r} is reserved for dcode's o | validation | error | validation, naming, reserved-names |
| {what} must be absolute: {path} | validation | error | validation, paths, configuration |
| Could not determine the home directory: set $HOME, or set DE | exception | error | environment, home-directory, containers, configuration |
| Home directory is not absolute: {launch_home}. Set $HOME to | exception | error | environment, paths, configuration, validation |
| Cannot determine whether {str(left)!r} is {str(right)!r}: {e | exception | error | permissions, filesystem, configuration, security |
| Invalid DEEPAGENTS_HOME {str(root)!r}: exists but cannot be | exception | error | permissions, filesystem, configuration |
| Invalid DEEPAGENTS_HOME {str(root)!r}: exists but is not a d | exception | error | filesystem, paths, configuration |
| Invalid DEEPAGENTS_HOME {configured!r}: use an absolute path | exception | error | configuration, environment, path-validation |
| Repository root must be an absolute contained path: {root!r} | validation | error | path-validation, security, configuration |
| Local filesystem backend is unavailable. | exception | error | backend, runtime, path-validation |
| Failed to parse {SERVER_ENV_PREFIX}{suffix} as JSON: {exc}. | validation | error | json, environment, configuration, parsing |
| Invalid {SERVER_ENV_PREFIX}{suffix}: expected a JSON string | validation | error | json, environment, type-validation, configuration |
| Invalid {SERVER_ENV_PREFIX}ALLOW_FS_TOOLS value: unknown fil | validation | error | configuration, env-var, validation, valueerror |
| Invalid {SERVER_ENV_PREFIX}ALLOW_FS_TOOLS value: {raw!r}; ex | validation | error | configuration, env-var, json, validation |
| interpreter.enable_interpreter is missing from the config ma | exception | error | configuration, manifest, internal-error, runtimeerror |
| shell_allow_list must be None or non-empty | validation | error | configuration, validation, dataclass, valueerror |
| allow_fs_tools must be None or a non-empty list | validation | error | configuration, security, validation, allowlist |
| allow_fs_tools must include 'read_file' | validation | error | config-validation, valueerror, filesystem-tools |
| rubric_max_iterations must be None or a positive integer | validation | error | config-validation, valueerror, integer-range |
| cli_max_retries must be None or a non-negative integer | validation | error | config-validation, valueerror, integer-range |
| recursion_limit must be None or a positive integer | validation | error | config, validation, python |
| Could not resolve {label} path {raw_path!r}: {exc}. Ensure t | validation | error | filesystem, cli, config |
| Textual's LinuxDriver no longer stores its output stream in | exception | error | textual, tui, version-incompatibility, terminal |
| Cannot enforce --allow-fs-tools on compiled subagent {subage | validation | error | agent, security, subagents, config |
| SDK {name} tool is unavailable. | exception | error | python, runtime, sdk-version, middleware |
| Context tool names conflict with rubric-grader tools: {names | validation | error | python, naming-conflict, tool-registry, validation |
| allow_list must not be empty; disable shell access instead | validation | error | python, configuration, validation, shell |
| SHELL_ALLOW_ALL should not be used with ShellAllowListMiddle | validation | error | python, configuration, type-error, shell, security |
| interpreter_ptc='all' exposes every host tool to PTC calls t | validation | error | python, configuration, security, hitl, validation |
| Invalid interpreter_ptc string {ptc!r}; expected 'safe', 'al | validation | error | python, configuration, valueerror, validation |
| interpreter_ptc list entries cannot include 'all'; use 'all' | validation | error | python, configuration, valueerror, validation |
| interpreter_ptc must be False, 'safe', 'all', or a list of t | validation | error | python, type-error, configuration, validation |
| shell.allow_list is missing from the configuration manifest | exception | error | python, runtime-error, configuration-manifest, installation |
| Error: Source agent '{source_agent}' not found or has no AGE | console | error | cli, agents, file-not-found, exit-code |
| enable_interpreter=True is not supported with a remote sandb | validation | error | python, configuration, sandbox, cli |
| shell.allow_list is missing from the configuration manifest | exception | error | python, configuration, manifest, version-skew |
| --model-params requires a JSON object value | validation | error | cli, argument-parsing, json, python |
| Unclosed {quote} in --model-params value | validation | error | cli, argument-parsing, quoting, shell |
| Unbalanced braces in --model-params value | validation | error | cli, argument-parsing, json, shell |
| Invalid JSON in --model-params: {json_str!r}. Expected forma | validation | error | cli, json-parsing, argument-validation |
| --model-params must be a JSON object, got {type} | validation | error | cli, type-error, argument-validation |
| goal application requires a non-empty objective and rubric | validation | error | validation, dataclass, goal-state |
| row has {len} cells, expected {expected} | validation | error | markdown, rendering, data-shape |
| output_as_app_message requires incognito=True; refusing to b | validation | error | shell, flag-combination, argument-validation |
| preloaded thread history requires resume_thread_id | validation | error | remote-agent, thread-state, argument-validation |
| Provide exactly one of mode or auto_approve | validation | error | approval-mode, api-misuse, mutually-exclusive-args |
| Invalid approval mode: {mode!r} | validation | error | approval-mode, enum, invalid-value |
| ask_user failed internally after its arguments were validate | exception | error | internal-error, pydantic, tool-schema |
| Failed to read credential file {path}: {exc}. Check the file | exception | error | filesystem, permissions, credentials |
| Failed to parse credential file {path}: {exc}. Delete the fi | exception | error | auth, file-corruption, json, local-storage |
| Credential file {path} is not a JSON object. Delete it and r | exception | error | auth, json, schema-mismatch, local-storage |
| Credential file {path} has unsupported version {version!r} ( | exception | error | auth, version-mismatch, schema-migration, local-storage |
| Failed to write credential file {auth_path()}: {exc}. Check | exception | error | auth, filesystem, permissions, disk-space |
| Provider name cannot be empty | validation | error | auth, validation, input-error |
| API key cannot be empty | validation | error | auth, validation, input-error |
| project is only valid for the langsmith service, not {provid | validation | error | auth, validation, langsmith, argument-mismatch |
| tool_call_id must not be empty | validation | error | pydantic, validation, llm-output, auto-mode |
| deny decisions require a reason | validation | error | pydantic, validation, llm-output, auto-mode |
| suffix must be empty or a short extension such as .md | validation | error | validation, filesystem, temp-files, input-error |
| could not write the complete temporary artifact | exception | error | filesystem, disk-full, temp-file, io |
| temporary artifact is not a regular file | exception | error | filesystem, temp-file, security, validation |
| temporary artifact is not owned by this user | exception | error | filesystem, permissions, security, temp-file, toctou |
| temporary artifact permissions are too broad | exception | error | filesystem, permissions, security, temp-file, umask |
| trusted thread, turn, and tool-call identity are required | validation | error | validation, tool-call, identity, auto-mode |
| temporary artifact provenance is invalid | exception | error | security, validation, temp-file, path-safety |
| temporary artifact identity changed | exception | error | filesystem, race-condition, security, temp-file, inode |
| Auto mode requires every proposed tool call to have an ID | validation | error | auto-mode, tool-call, validation, model-output |
| Auto mode rejects action batches with duplicate tool-call ID | validation | error | auto-mode, tool-call, validation, duplicate |
| Human decision count does not match Manual pending calls | validation | error | auto-mode, human-in-the-loop, validation, approval |
| Human decision count does not match pending approval calls | validation | error | validation, human-in-the-loop, auto-mode |
| Classifier result did not contain exactly one decision per r | validation | error | classifier, validation, auto-mode, llm-output |
| trusted_ask_user_tool must be named ask_user | validation | error | validation, naming, auto-mode, constructor |
| trusted_compaction_tool must be named compact_conversation | validation | error | validation, naming, auto-mode, constructor |
| {name} must be a positive finite number, got {budget!r} | validation | error | validation, timeout, configuration, auto-mode |
| The selected Python runtime does not contain Deep Agents Cod | console | critical | environment, python-runtime, missing-dependency, script |
| Could not import Deep Agents Code dependencies or locate dco | console | critical | environment, missing-dependency, path, script |
| Invalid DEEPAGENTS_HOME {configured!r}: use an absolute path | console | error | environment, configuration, path-validation, script |
| Sessions database not found: {resolved} | console | error | file-not-found, sqlite, script, configuration |
| Not a supported sessions database; missing tables: {names} | console | error | sqlite, schema-validation, script, file-not-found |
| Thread not found: {value} | console | error | cli, not-found, thread-id |
| Thread prefix is ambiguous: {rendered} | console | error | cli, ambiguity, thread-id |
| --max-content must be positive | validation | error | cli, argument-validation |
| --list must be positive | validation | error | cli, argument-validation |
| Provide a thread ID or use --list N | validation | error | cli, missing-argument, usage |
| Use either a thread ID or --list N, not both | validation | error | cli, argument-conflict, usage |
| Server process exited with code {process.returncode} | exception | critical | process, server-startup, subprocess |
| Server did not become healthy within {timeout}s | exception | critical | timeout, health-check, network |
| Failed to rescaffold server workspace at {work_dir}: {exc} | exception | error | filesystem, permissions, scaffold |
| langgraph.json not found in {work_dir}. Call generate_langgr | exception | error | config, missing-file, scaffold |
| Server process is not running | exception | error | lifecycle, subprocess, runtime-error |
| Server process exited with code {self._process.returncode} | exception | critical | subprocess, startup, langgraph |
| Server graph '{graph_name}' did not initialize within {timeo | exception | error | timeout, network, startup |
| Server graph '{graph_name}' failed readiness check (status: | exception | error | http, health-check, langgraph |
| persistent server env overrides must use the {SERVER_ENV_PRE | validation | error | validation, environment, valueerror |
| {db_path_var} not set. The app must set this env var before | exception | critical | environment, sqlite, checkpointer |
| MCP config file not found: {mcp_config_path} | exception | error | mcp, config, file-not-found |
| Invalid MCP config at {mcp_config_path}: {exc} | validation | error | mcp, config, validation, json |
| A workspace is required to start the remote agent. | exception | error | workspace, lifecycle, runtime-error |
| {message} | exception | error | headless, hitl, iteration-limit, permissions |
| shell.allow_list is missing from the configuration manifest | exception | error | config, manifest, shell, internal-consistency |
| Permission interrupted by hook | exception | error | hooks, permissions, hitl, interrupt |
| Compact session start stopped by hook | exception | error | hooks, compaction, session-start, headless |
| Session start stopped by hook | exception | error | hooks, session-start, headless, lifecycle |
| Offload server returned an invalid cancellation acknowledgem | exception | error | network, protocol, offload, remote |
| Offload server completed without a typed result. | exception | error | offload, protocol, validation, remote |
| Offload result has no status. | exception | error | offload, protocol, validation, remote |
| Offload result field {field!r} must be an integer, got {type | exception | error | offload, protocol, validation, types |
| thread_id is required in config.configurable | validation | error | config, validation, thread-id, langgraph |
| This server does not provide dcode's /offload operation. Use | exception | error | network, http-404, version-mismatch, offload, server |
| Offload server returned a non-object response. | exception | error | protocol, schema, offload, server-response |
| Offload server returned an invalid operation response. | exception | error | protocol, schema, offload, hooks |
| Offload hook request has no invocation id. | exception | error | protocol, offload, hooks, invocation-id |
| Offload did not complete after {_OFFLOAD_MAX_RESUME_ROUNDS} | exception | error | offload, hooks, retry-limit, protocol |
| Pending graph work remained on thread {thread_id} after clea | exception | error | langgraph, state, cancellation, recovery |
| RemoteAgent workspace is not configured. | exception | error | configuration, workspace, setup, remote-agent |
| Workspace server returned an invalid binding response. | exception | error | protocol, schema, workspace, server-response |
| Workspace policy and fingerprint must be configured together | validation | error | configuration, validation, workspace, policy |
| RewarmEstimate costs must be finite, got cold={self.cold_cos | validation | error | validation, dataclass, config |
| RewarmEstimate costs must be non-negative, got cold={self.co | validation | error | validation, dataclass, config |
| RewarmEstimate incremental cost {self.incremental_cost_usd!r | validation | error | validation, dataclass, config |
| ColdCacheWarning age_seconds={self.age_seconds!r} does not p | validation | error | validation, dataclass, invariant |
| MODE_PREFIXES and MODE_DISPLAY_GLYPHS have mismatched keys: | exception | critical | import-time, internal-consistency, config |
| Cannot combine 'all' with other commands in --shell-allow-li | validation | error | cli, config, security, validation |
| `interpreter_ptc` cannot be set to True; use 'safe', 'all', | validation | error | config, toml, validation |
| Invalid `interpreter_ptc` string {raw!r}; expected 'safe', ' | validation | error | config, toml, validation |
| `interpreter_ptc` list entries must be non-empty strings; go | validation | error | config, toml, validation |
| `interpreter_ptc` list entries cannot include 'all'; use 'al | validation | error | config, toml, validation, security |
| No credentials are configured for any model in models.allowe | exception | error | config, credentials, model-policy, startup |
| No credentials configured. Please set one of: ANTHROPIC_API_ | exception | error | config, credentials, env-var, startup |
| Google Cloud location is required for provider 'google_anthr | exception | error | gcp, vertex-ai, config, env-var |
| Invalid class_path '{class_path}' for provider '{provider}': | validation | error | config, import, validation |
| Could not import module '{module_path}' for provider '{provi | exception | error | import, python, config, dependency |
| Class '{class_name}' not found in module '{module_path}' for | exception | error | config, import, attribute |
| '{class_path}' is not a BaseChatModel subclass (got {type(cl | validation | error | config, langchain, type-check |
| Failed to instantiate '{class_path}' for '{provider}:{model_ | exception | error | config, instantiation, kwargs |
| Missing package for provider '{provider}'. {install_hint}, t | exception | error | dependency, langchain, installation, provider |
| Provider package '{package}' is installed but failed to impo | exception | error | dependency, import, langchain, corruption |
| Unable to infer a model provider for {model_spec!r}. Specify | exception | error | model-config, provider-inference, langchain |
| Invalid model configuration for '{provider}:{model_name}': { | validation | error | model-config, langchain, validation |
| Failed to initialize model '{spec}': {e} | exception | error | network, auth, sdk, model-init |
| model_retries must be an int, got {self.model_retries!r} | validation | error | type-error, retry-budget, validation |
| model_retries must be >= 0, got {self.model_retries} | validation | error | validation, retry-budget |
| cli_max_retries must be None or an int, got {self.cli_max_re | validation | error | type-error, retry-budget, validation |
| cli_max_retries must be >= 0, got {self.cli_max_retries} | validation | error | validation, retry-budget, cli |
| Could not apply {label} to model '{model_name}': {exc}. The | exception | error | model-config, profile-override, langchain |
| Invalid model spec '{model_spec}': model name is required (e | validation | error | model-config, validation, parsing |
| Claude model '{model_name}' uses the Anthropic Messages API | validation | error | model-config, provider-routing, gcp, vertex-ai |
| Not signed in to ChatGPT. Run `/auth` and select openai_code | exception | error | authentication, oauth, chatgpt, codex, config |
| No credentials found for provider '{provider}'. Please set t | exception | error | authentication, api-key, env-var, config |
| Failed to apply provider profile for '{spec}': {exc}. Check | exception | error | model-config, dependency, provider-integration, version-mismatch |
| ChatGPT session expired. Run `/auth` and select openai_codex | exception | error | authentication, token-expired, oauth, codex, chatgpt |
| Failed to initialize Codex model '{provider}:{model_name}': | exception | error | model-config, codex, initialization, corrupted-state |
| a provider already serves rank {provider.rank} | validation | error | configuration, resolver, rank-conflict, api-misuse |
| a different CLI provider is already installed for this proce | validation | error | configuration, resolver, cli, process-state, caching |
| managed_snapshot is a different generation than the one in f | validation | error | configuration, resolver, snapshot, generation-mismatch, caching |
| shared config resolver has no managed TOML provider | exception | error | configuration, resolver, internal-api, missing-provider, testing |
| remote source must be an absolute HTTPS URL | validation | error | validation, configuration, url, https |
| remote source must not contain credentials | validation | error | validation, security, url, credentials |
| remote source must not contain a query string or fragment | validation | error | validation, url, canonicalization |
| remote source has an invalid port | validation | error | validation, url, port |
| remote_source must be a validated absolute HTTPS URL | validation | error | validation, configuration, url, https |
| a {self.status.health.value} snapshot must carry no data; an | validation | error | invariant, configuration, toml, state-consistency |
| a failed write must carry an error detail | validation | error | invariant, configuration, file-write |
| a failed write cannot have changed the file | validation | error | invariant, configuration, file-write |
| a successful write cannot carry an error detail | validation | error | invariant, configuration, file-write |
| Refused pricing catalog with {fetched_count} providers ({bun | validation | error | pricing, data-validation, network, safety-guard |
| DiffStats counts cannot be negative, got additions={self.add | validation | error | diff, validation, dataclass, input-error |
| Editor command resolved to no arguments | exception | error | editor, configuration, environment, missing-editor |
| External editor executable or temporary file was not found | exception | error | editor, file-not-found, path, environment |
| External editor failed | exception | error | editor, subprocess, process-failure |
| Unknown external event kind: {self.kind!r} | validation | error | event-bus, validation, schema, input-error |
| External event payload must be a non-empty string | validation | error | event-bus, validation, empty-payload, input-error |
| Unknown external signal: {self.payload!r}; expected one of { | validation | error | event-bus, validation, signal, input-error |
| UnixSocketEventSource is already started | exception | error | event-bus, lifecycle, unix-socket, double-start |
| UnixSocketEventSource.serve_forever called before start() | exception | error | event-bus, lifecycle, asyncio, unix-socket |
| Refusing to remove non-socket external event path: {path} | exception | error | filesystem, unix-socket, event-bus |
| External event must be valid JSON: {exc.msg} | validation | error | json, ipc, event-bus, validation |
| External event must be a JSON object | validation | error | json, ipc, event-bus, schema |
| External event kind must be one of {sorted(_VALID_KINDS)}; g | validation | error | json, event-bus, validation, schema |
| External event bypass must be a valid bypass tier: {exc} | validation | error | json, event-bus, enum, validation |
| External event correlation_id must be a string when present | validation | error | json, event-bus, validation |
| Extension registration is closed for this session | exception | error | extensions, lifecycle, registration |
| Could not construct middleware {middleware!r}: {exc} | exception | error | extensions, middleware, instantiation |
| Registered middleware must be an AgentMiddleware, got {kind} | validation | error | extensions, middleware, type-check |
| Could not convert {name} into a tool: {exc} | exception | error | extensions, tool-registration, type-annotations |
| Invalid backend route prefix {prefix!r}: use lowercase path | validation | error | extensions, backend-route, validation |
| Backend route {prefix!r} got {type(backend).__name__}, which | validation | error | extensions, backend-route, type-check |
| Shutdown hook is not callable | validation | error | extensions, shutdown-hook, type-check |
| Entry point {entry.name!r} does not resolve to a Python modu | exception | error | extensions, entry-point, discovery, import |
| Extension backend route {item.name!r} from {item.source.labe | exception | error | extensions, backend-route, policy, namespace-collision |
| Extension backend route {item.name!r} from {item.source.labe | exception | error | extensions, backend-route, sandbox, security-policy |
| Could not import extension {source.path} | exception | error | extensions, loader, import, file-not-found |
| Extension import in {source.path} attempted to exit: {exc} | exception | error | extensions, loader, systemexit, import |
| Failed to import {source.path}: {exc} | exception | error | extensions, loader, import, dependency |
| {source.path} does not define a callable 'extension' factory | validation | error | extensions, plugin-loading, python |
| Extension factory in {source.path} must be declared with 'as | validation | error | extensions, async, plugin-loading |
| Extension factory in {source.path} attempted to exit: {exc} | exception | error | extensions, systemexit, plugin-loading |
| Extension factory in {source.path} failed: {exc} | exception | error | extensions, plugin-loading, exception-wrapping |
| Extension options are missing from the config manifest | exception | error | configuration, extensions, internal-consistency |
| Distribution {distribution_name!r} not found; cannot preserv | exception | error | packaging, metadata, extras |
| Could not parse optional-dependency metadata; cannot preserv | exception | error | packaging, metadata, parsing |
| Missing core dependency for the interpreter. Reinstall dcode | exception | critical | dependencies, interpreter, startup |
| must contain non-whitespace text | validation | error | validation, pydantic, goal-rubric |
| Goal criteria request must be an object. | validation | error | validation, type-error, agent-hooks |
| Goal criteria request requires a request_id. | validation | error | validation, valueerror, goal-criteria |
| Goal criteria request kind must be create or amend. | validation | error | validation, valueerror, enum-mismatch |
| Goal criteria request requires an objective. | validation | error | validation, valueerror, goal-criteria |
| Goal criteria request field {key} must be text. | validation | error | validation, typeerror, type-mismatch |
| Goal amendment requests require criteria and feedback. | validation | error | validation, valueerror, goal-criteria |
| The server criteria agent returned no complete proposal. | exception | error | llm, parsing, runtime-error, goal-criteria |
| Context tool names conflict with criteria-agent tools: {name | exception | error | configuration, naming-conflict, valueerror, tools |
| {label} is {actual} characters; maximum is {limit}. Remove a | validation | error | limit-exceeded, goal-state, size-limit |
| Expected UserPromptSubmitDecision, got {type(decision).__nam | exception | error | hooks, type-validation, typeerror |
| Expected PreCompactDecision, got {type(decision).__name__} | exception | error | hooks, type-validation, typeerror |
| Expected PermissionRequestDecision, got {type(decision).__na | exception | error | hooks, permissions, type-validation, typeerror |
| Expected NotificationDecision, got {type(decision).__name__} | exception | warning | hooks, notifications, stop-hook |
| Notification stopped by hook | exception | warning | hooks, notifications, stop-hook |
| Hook resume invocation_id mismatch: expected {invocation_id} | validation | error | hooks, interrupt, resume, identity-check |
| Hook resume snapshot_id mismatch: expected {snapshot_id}, go | validation | error | hooks, interrupt, resume, snapshot, identity-check |
| Received hook invocation interrupt without a HooksRuntime | exception | error | hooks, runtime, initialization, interrupt |
| Failed to parse hook interrupt | exception | error | hooks, interrupt, payload-parsing |
| argv must be a non-empty list of strings when provided. | validation | error | validation, pydantic, config, hooks |
| argv[0] must be a non-empty executable path. | validation | error | validation, pydantic, config, hooks |
| async command hooks are not yet supported. | validation | error | validation, unsupported-feature, hooks, config |
| Unsupported hook event: {type(event).__name__} | exception | error | typeerror, hooks, internal-invariant, projection |
| SubagentStop requires a materialized agent transcript path | exception | error | valueerror, hooks, transcript, subagent |
| Unsupported notification type: {value} | exception | error | valueerror, hooks, mapping, notification |
| Unsupported hook-specific output: {type(specific).__name__} | exception | error | typeerror, hooks, reducer, internal-invariant |
| Unsupported hook event: {event} | exception | error | valueerror, hooks, reducer, internal-invariant |
| Hook process pipes are unavailable | exception | error | brokenpipe, asyncio, subprocess, hooks |
| Hook process stdin is unavailable | exception | error | brokenpipe, asyncio, subprocess, stdin, hooks |
| Project hooks cannot execute before workspace trust is grant | exception | error | security, hooks, workspace-trust |
| Post-tool hooks must preserve committed ToolMessage results | exception | error | hooks, type-error, middleware |
| Expected {expected.__name__}, got {type(decision).__name__} | exception | error | hooks, type-error, decision |
| hooks_snapshot_id is required to emit server-owned hook even | exception | error | hooks, session, runtime-error |
| PreCompact requires a stable tool-call identity | exception | error | hooks, identity, value-error |
| Provided snapshot_id does not match canonical configuration | validation | error | hooks, snapshot, integrity-check |
| retention_revisions must be nonnegative | validation | error | validation, transcript, value-error |
| hooks trust store projects must be an object: {path} | validation | error | trust, schema-validation, json |
| hooks trust store must be a JSON object: {path} | validation | error | trust, schema-validation, json |
| Unsupported hooks trust store version: {version!r} | validation | error | trust, versioning, migration |
| `unreadable_reason` implies the token is not usable; `logged | validation | error | python, validation, dataclass, invariant |
| `expires_at` must be set when `logged_in` is True. | validation | error | python, validation, dataclass, auth |
| `expires_at` is only meaningful when `logged_in` is True. | validation | error | python, validation, dataclass, state |
| `is_expired` is only meaningful when `logged_in` is True. | validation | error | python, validation, dataclass, state |
| Failed while waiting for Vercel sandbox startup. | exception | error | python, sandbox, vercel, startup, network |
| Missing dependencies for '{provider}' sandbox. {install_hint | exception | error | python, sandbox, dependency, import, installation |
| Invalid class_path '{class_path}': must be in module.path:Cl | validation | error | python, config, validation, dynamic-import |
| Class '{class_name}' not found in module '{module_path}' | exception | error | python, config, dynamic-import, import |
| Sandbox provider '{name}' config is missing 'class_path' | validation | error | python, config, sandbox, validation |
| Unknown sandbox provider: {name}. Available providers: {', ' | validation | error | python, sandbox, config, unknown-provider |
| Unknown sandbox provider: {name} | validation | error | configuration, sandbox, unknown-provider |
| thread display options are missing from the configuration ma | exception | error | configuration, manifest, cli |
| manifest option 'interpreter.enable_interpreter' is missing; | exception | error | configuration, manifest, interpreter |
| interpreter.enable_interpreter is missing from the config ma | exception | error | configuration, manifest, interpreter |
| Could not read rubric file {path!r}: {exc}. | validation | error | filesystem, encoding, cli |
| Rubric file {path!r} is empty. | validation | error | validation, cli, rubric |
| --rubric must not be empty. | validation | error | validation, cli, rubric |
| Download of {url} exceeded {_DOWNLOAD_TIMEOUT_SECONDS}s dead | exception | error | network, timeout, download |
| Checksum mismatch for {path.name}: expected {expected_hex}, | exception | error | security, checksum, download |
| Could not find {target_name} inside {archive.name} | exception | error | archive, install, filesystem |
| Invalid MCP server name {server_name!r}: token storage names | validation | error | mcp, validation, configuration, path-traversal |
| Failed to read MCP token file {path}: {exc}. Delete the file | exception | error | mcp, file-io, corrupt-file, json |
| MCP token file {path} is not a JSON object (found {type(data | exception | error | mcp, json, schema-validation, corrupt-file |
| MCP token file {path} has unsupported version ({type(data.ge | exception | error | mcp, versioning, schema-validation, migration |
| MCPReauthRequiredError({server_name}) | exception | error | mcp, oauth, authentication, non-interactive |
| Authorization denied by provider: {err_code}{detail} | exception | error | mcp, oauth, authorization, callback |
| Callback URL is missing the 'code' parameter. | exception | error | mcp, oauth, callback, validation |
| Device code request failed: HTTP {response.status_code} from | exception | error | mcp, oauth, device-flow, http, network |
| Device code response from {device_code_url} is missing requi | exception | error | mcp, oauth, device-flow, schema-validation, http |
| Device flow failed: {err}: {body.get('error_description', '' | exception | error | oauth, device-flow, github, authentication |
| Token request failed: HTTP {token_response.status_code} from | exception | error | oauth, http-status, github, network |
| Token response from {token_url} is not a valid OAuth token p | exception | error | oauth, schema-validation, pydantic, github |
| Device flow timed out. Try logging in again. | exception | error | oauth, device-flow, timeout, github |
| Server '{server_name}' uses {transport!r} transport; OAuth l | validation | error | oauth, configuration, transport, stdio, mcp |
| {str(exc)} | exception | error | mcp, oauth, config-validation, env-var |
| {field} references unset env var {name}. Set {name} in the e | exception | error | mcp, env-var, config-validation |
| {field} contains a malformed '${{...}}' reference. Use '${VA | exception | error | mcp, config-validation, syntax |
| {field} must be a string, got {type(value).__name__} | validation | error | mcp, type-error, config-validation |
| {prefix}.args must be a list, got {type(args).__name__} | validation | error | mcp, type-error, config-validation, stdio |
| {prefix}.{name} must be a dictionary, got {type(values).__na | validation | error | mcp, config, type-error, schema |
| mcp.disabled_servers is missing from the config manifest | exception | error | mcp, config-manifest, runtime-error, versioning |
| ManagedConfigError(provider.status) | exception | error | mcp, config, provider-health, managed-config |
| ManagedConfigError(ProviderStatus(name, path, ProviderHealth | exception | error | mcp, config, corrupt, managed-config |
| ConfigResolution must have at least one used path | validation | error | mcp, config, invariant, value-error |
| ServerSelection.server_name must not be empty | validation | error | mcp, oauth, validation, value-error |
| No callback URL received (stdin closed). Re-run `dcode mcp l | exception | error | mcp, oauth, stdin, interactive |
| No MCP OAuth provider matched {server_url!r} | exception | error | mcp, oauth, registry, provider |
| MCPServerInfo {self.name!r}: status='ok' cannot carry an err | validation | error | mcp, invariant, value-error, dataclass |
| MCPServerInfo {self.name!r}: status={self.status!r} requires | validation | error | mcp, invariant, value-error, dataclass |
| MCPServerInfo {self.name!r}: status={self.status!r} cannot c | validation | error | mcp, validation, configuration |
| MCPServerInfo {self.name!r}: pending_reconnect requires stat | validation | error | mcp, validation, state-management |
| Cannot configure a closed MCP session manager | exception | error | mcp, lifecycle, runtime-error |
| Cannot reconfigure MCP session manager after sessions are ac | exception | error | mcp, lifecycle, configuration |
| Cannot create an MCP session after cleanup | exception | error | mcp, lifecycle, runtime-error |
| Couldn't find an MCP server named '{server_name}', expected | validation | error | mcp, configuration, keyerror |
| Invalid server name {server_name!r}: server names must conta | validation | error | mcp, validation, naming |
| Server '{server_name}' config must be a dictionary | validation | error | mcp, validation, configuration |
| Server '{server_name}' with type '{server_type}' missing req | validation | error | mcp, validation, configuration |
| Server '{server_name}' has type '{server_type}' (remote) but | validation | error | mcp, validation, configuration |
| Server '{server_name}' 'headers' must be a dictionary | validation | error | mcp, config-validation, typeerror |
| Server '{server_name}' header {name!r} must be a string, got | validation | error | mcp, config-validation, typeerror, http-headers |
| Server '{server_name}' missing required 'command' field | validation | error | mcp, config-validation, stdio, missing-field |
| Server '{server_name}' has type 'stdio' but also declares a | validation | error | mcp, config-validation, stdio, conflicting-fields |
| Server '{server_name}' 'args' must be a list | validation | error | mcp, config-validation, typeerror, stdio |
| Server '{server_name}' 'env' must be a dictionary | validation | error | mcp, config-validation, typeerror, stdio, environment |
| Server '{server_name}' has unsupported transport type '{serv | validation | error | mcp, config-validation, transport, unsupported-type |
| Server '{server_name}' has unsupported auth value {auth!r}. | validation | error | mcp, config-validation, auth, oauth |
| Server '{server_name}' uses stdio transport; 'auth: oauth' i | validation | error | mcp, config-validation, auth, oauth, stdio |
| Server '{server_name}' cannot combine 'auth: oauth' with an | validation | error | mcp, config-validation, auth, oauth, http-headers |
| Server '{server_name}' cannot set both 'allowedTools' and 'd | validation | error | config, mcp, validation, tool-filtering |
| Server '{server_name}' '{field_name}' must be a list of stri | validation | error | config, mcp, type-error, validation |
| Server '{server_name}' '{field_name}' must be non-empty; omi | validation | error | config, mcp, validation, tool-filtering |
| MCP config file not found: {config_path} | exception | error | config, mcp, filesystem, file-not-found |
| MCP config must contain 'mcpServers' field. Expected format: | validation | error | config, mcp, validation, json-schema |
| 'mcpServers' field must be a dictionary | validation | error | config, mcp, type-error, validation |
| 'mcpServers' field is empty - no servers configured | validation | error | config, mcp, validation, empty-config |
| {self.scope} MCP config {need} a project root: {self.path} | validation | error | mcp, invariant, dataclass, config-scope |
| MCP server '{server_name}': missing 'command' in config. | validation | error | mcp, config, stdio, validation |
| MCP server '{server_name}': configured command not found on | validation | error | mcp, stdio, path, environment |
| Package {package_root} is not installed | exception | error | python, import, dependency-missing, config |
| Cannot determine location for {package_root} | exception | error | python, import, packaging |
| Profile module not found: {profiles_path} | exception | error | python, import, file-not-found, version-mismatch |
| Could not create module spec for {profiles_path} | exception | error | python, import, importlib |
| {name} must be a table | validation | error | python, toml, config, type-error |
| Invalid recent startup mode: {mode!r} | validation | error | python, validation, config, enum |
| Invalid sort_order {sort_order!r}; expected 'updated_at' or | validation | error | python, validation, config, enum |
| Invalid scope {scope!r}; expected 'cwd' or 'all' | validation | error | python, validation, config, enum |
| call_id and failed_attempt must be provided together | exception | error | python, validation, api, correlation |
| phase must be one of {sorted(_ATTEMPT_PHASES)}, got {phase!r | validation | error | python, validation, api, enum |
| max_retries must be an int, got {type(max_retries).__name__} | validation | error | python, validation, retry, type-error |
| max_retries must be >= 0 | validation | error | python, validation, retry, value-error |
| stream_output_is_visible must be a bool, got {type(stream_ou | validation | error | python, validation, type-error, streaming |
| PendingNotification.key must be non-empty | validation | error | python, validation, notifications, dataclass |
| PendingNotification {self.key!r} must declare at least one a | validation | error | python, validation, notifications, dataclass |
| PendingNotification {self.key!r} has {primaries} primary act | validation | error | python, validation, notifications, dataclass |
| Path is not a directory: {path} | exception | error | filesystem, permissions, offload, oserror |
| Directory is owned by another user: {path} | exception | error | filesystem, permissions, offload, permission-error, ownership |
| context.{key} must be a string or null, got {type(value).__n | validation | error | python, validation, type-error, context, offload |
| context.{key} must be an object, got {type(value).__name__}. | validation | error | python, validation, type-error, context, offload |
| context.model_context_limit must be an integer or null, got | validation | error | type-error, validation, python, offload-api |
| context.auto_approve must be a boolean or null, got {type(au | validation | error | type-error, validation, python, config |
| context.hooks_server_events must be a list of strings or nul | validation | error | type-error, validation, python, hooks |
| Offload request must be a JSON object. | validation | error | type-error, json, validation, payload |
| operation_id must be a non-empty string. | validation | error | type-error, validation, payload, required-field |
| context must be a JSON object. | validation | error | type-error, validation, payload, json |
| hook_responses must be a JSON object. | validation | error | type-error, validation, hooks, payload |
| LangGraph returned non-object thread state. | exception | error | langgraph, server-response, thread-state, type-error |
| LangGraph returned a non-list messages channel. | exception | error | langgraph, thread-state, messages, type-error |
| thread_id path parameter must be non-empty. | validation | error | type-error, validation, thread-id, configuration |
| Server offload operations may not write {sorted(forbidden)} | exception | error | security, checkpoint, offload, state-validation |
| {type(helper).__name__} exposes no {name!r} slot, so dcode c | exception | error | version-compatibility, sdk-internals, monkeypatch, attributeerror |
| archive backend returned no response for {path} | exception | error | archive, backend, offload, empty-response |
| archive read failed for {path}: {response.error} | exception | error | archive, backend, io, offload |
| archive rollback failed for {self.path}: {result.error} | exception | critical | archive, rollback, consistency, offload |
| An offload {status!r} result must carry a reason. | validation | error | validation, api-contract, offload |
| Offload operation must use the agent's composite backend | validation | error | wiring, backend, offload, configuration |
| archive read failed; refusing to overwrite existing history | exception | error | archive, read-failure, safety, offload |
| Offload compaction requires checkpointed conversation messag | validation | error | compaction, validation, offload, empty-state |
| Summarizer returned a {type(summary_message).__name__} summa | exception | error | summarization, type-mismatch, compaction, schema |
| Failed to install {args.plugin_id}: {exc} | console | error | cli, plugin-install, marketplace |
| Failed to {command} {args.plugin_id}: {exc} | console | error | cli, plugin-enable, plugin-disable |
| Failed to add marketplace {source}: {redact_urls_in_text(str | console | error | cli, marketplace, credential-redaction |
| Plugin {plugin_id!r} is not installed | exception | error | plugin, registry, marketplace-error |
| {str(exc)} from split_plugin_id (invalid plugin id) | exception | error | plugin-id, argument-validation |
| Marketplace {marketplace_name!r} is not configured | exception | error | marketplace, configuration |
| Plugin {plugin_id!r} not found in marketplace {marketplace_n | exception | error | marketplace, plugin-not-found |
| {unresolved_source_message(plugin_id, entry, rejections)} | exception | error | plugin-install, source-materialization, symlink |
| Cannot install {plugin_id}: {exc} | exception | error | manifest, plugin-install, validation |
| Installed {plugin_id} but failed to load from cache: {detail | exception | error | plugins, marketplace, install, cache |
| Marketplace {record.name!r} now declares the name {marketpla | exception | error | plugins, marketplace, auto-update, identity-mismatch |
| Plugin {plugin_id} has an unusable source path ({rejections} | exception | error | plugins, marketplace, auto-update, source-path |
| Invalid plugin name: {name!r} | exception | error | plugins, manifest, naming, validation |
| Invalid JSON syntax in {manifest_path}: {exc} | exception | error | plugins, manifest, json, parse-error |
| Could not read plugin manifest {manifest_path}: {exc} | exception | error | plugins, manifest, filesystem, permissions |
| Plugin manifest {manifest_path} must be a JSON object | exception | error | plugins, manifest, json, schema |
| Please enter a marketplace source | exception | warning | plugins, marketplace, input-validation, ux |
| Remote marketplace sources must use https | exception | error | validation, https, security, url |
| Invalid marketplace URL | exception | error | validation, url, urlparse |
| GitHub marketplace URLs must contain exactly owner/repo | exception | error | validation, github, url |
| Invalid marketplace source format. Try: owner/repo, https:// | exception | error | validation, input-parsing, marketplace |
| Path does not exist: {path} | exception | error | filesystem, path, validation |
| File path must point to a .json marketplace file: {path} | exception | error | filesystem, validation, json |
| Path is neither a file nor a directory: {path} | exception | error | filesystem, edge-case, symlink |
| Git is required to add repository-backed plugin marketplaces | exception | error | git, environment, missing-dependency, subprocess |
| Failed to run git: {redact_urls_in_text(str(exc))} | exception | error | git, subprocess, timeout, network |
| Git command failed: {redact_urls_in_text(detail)} | exception | error | git, subprocess, authentication, network |
| Marketplace redirect must use https: {detail} | exception | error | network, security, https, redirect |
| Marketplace URL must use https: {_redact_url_credentials(url | exception | error | network, security, https, validation |
| Marketplace response must use https: {detail} | exception | error | network, security, https, redirect |
| Failed to download marketplace from {_redact_url_credentials | exception | error | network, http, json, timeout |
| Marketplace URL must return a JSON object: {_redact_url_cred | exception | error | json, schema, validation |
| GitHub marketplace source is missing repository metadata | exception | error | configuration, types, github, marketplace |
| Git marketplace source is missing repository metadata | exception | error | configuration, types, git, marketplace |
| Unsupported marketplace source type: {source.source_type} | exception | error | configuration, validation, marketplace |
| Marketplace URL {_redact_url_credentials(url)} contains plug | exception | error | marketplace, plugins, configuration, validation |
| Marketplace URL {_redact_url_credentials(url)} only download | exception | error | marketplace, plugins, configuration, filesystem |
| Invalid JSON syntax in {manifest_path}: {exc} | exception | error | json, config, marketplace, parsing |
| Could not read marketplace manifest {manifest_path}: {exc} | exception | error | filesystem, permissions, marketplace, io |
| Marketplace manifest {manifest_path} must be a JSON object | exception | error | json, schema, marketplace, validation |
| Invalid plugin name: {name!r} | exception | error | validation, naming, marketplace, config |
| Marketplace {name} must contain a plugins array | exception | error | json, schema, marketplace, validation |
| No marketplace manifest found under {root} | exception | error | marketplace, config, path, discovery |
| Plugin id {self.plugin_id!r} does not match {expected!r} | validation | error | validation, dataclass, plugin-id, invariant |
| Invalid plugin id {plugin_id!r}; expected name@marketplace | validation | error | plugin-id, parsing, validation |
| Plugin state file {path} {detail} | exception | error | state, corruption, json, persistence |
| Plugin source directory not found: {source} | exception | error | plugins, filesystem, path, install |
| user_cwd must be absolute, got {self.user_cwd!r} | validation | error | path, validation, configuration |
| project_root must be absolute, got {self.project_root!r} | validation | error | path, validation, configuration |
| Agent backend did not publish its offload operation; /offloa | exception | critical | runtime, backend, startup, offload |
| Server configuration changed after the workspace was bound. | exception | error | workspace, configuration, drift, session |
| A thread id and workspace context are required for execution | validation | error | graph, thread, validation, invocation |
| Invalid sort_by {sort_by!r}; expected 'updated' or 'created' | validation | warning | validation, sessions, arguments |
| Error: Invalid skill name: {error_msg} | console | warning | skills, cli, validation, naming |
| Error: Not in a project directory. | console | warning | skills, cli, git, project |
| Error: Could not create project skills directory. | console | error | cli, filesystem, permissions |
| Error: {path_error} | console | error | cli, path-traversal, validation |
| Error: Skill '{skill_name}' not found. | console | error | cli, not-found, skills |
| Error: Cannot determine base skills directory. Refusing to d | console | error | cli, filesystem, safety |
| Error: Skill directory is a symlink. Refusing to delete for | console | error | cli, symlink, safety |
| Error: Failed to fully delete skill: {e} Warning: Some files | console | error | filesystem, permissions, cli |
| Error: Could not read the skill trust store: {exc} | console | error | cli, trust-store, json |
| Error: Could not revoke trust for: {target} | console | error | cli, trust-store, revocation |
| Error: Could not clear trusted directories. | console | error | cli, trust-store, filesystem |
| Error: Invalid agent name: {error_msg} | console | error | cli, validation, argument-parsing |
| skills.extra_allowed_dirs is missing from the configuration | exception | error | config, invariant, internal |
| Skill path {skill_path} resolves outside all allowed skill d | exception | error | security, symlink, path-validation |
| Skill trust store {store_path} is not a JSON object | exception | error | trust-store, json, schema-validation |
| Skill trust store {store_path} has an unrecognized schema ve | exception | error | trust-store, schema-version, forward-compatibility |
| ThemeColors.{f.name} must be a 7-char hex color (#RRGGBB), g | validation | error | validation, config, theme |
| ThemeEntry.label must be a non-empty string | validation | error | validation, theme, config |
| Compiled agent does not expose a LangGraph tool node | exception | error | langgraph, sdk-incompatibility, tooling |
| Approval-mode Store writer is unavailable | exception | error | store, persistence, approval-mode |
| User prompt submission stopped by hook | exception | warning | hooks, lifecycle, prompt |
| Compact session start stopped by hook | exception | warning | hooks, compaction, lifecycle |
| Manual approval mode could not be persisted; graph execution | exception | error | persistence, approval-mode, store |
| Manual mode callback is unavailable | exception | error | hitl, approval-mode, callback |
| Manual mode could not be persisted | exception | error | hitl, approval-mode, persistence |
| MCP login was cancelled before the prompt could be shown. | exception | info | mcp, auth, ui-cancel |
| uv tool receipt not found at {receipt_path} | exception | error | uv, filesystem, installation, receipt-missing |
| Could not read uv tool receipt at {receipt_path}: {exc} | exception | error | uv, toml, file-corruption, permissions |
| uv tool receipt is missing `[tool].requirements` | exception | error | uv, receipt-schema, validation |
| uv tool receipt contains a non-table requirement entry | exception | error | uv, receipt-schema, validation |
| uv tool receipt contains a requirement without a package nam | exception | error | uv, receipt-schema, validation |
| uv tool receipt is missing `[tool]` | exception | error | uv, receipt-schema, validation |
| uv tool receipt contains an invalid `[tool].python` value | exception | error | uv, receipt-schema, type-error |
| uv tool receipt requirement {name!r} uses source fields that | exception | error | uv, receipt-schema, unsupported-source |
| uv tool receipt contains invalid extras on the tool requirem | exception | error | uv, extras, validation |
| uv tool receipt contains duplicate canonical extra names | exception | error | uv, extras, duplicates, validation |
| Extra {extra!r} is a base dependency and cannot be removed. | exception | error | extras, validation, protected-dependency |
| Extra {extra!r} is also provided by {listed} and cannot be r | exception | error | extras, conflict, dependencies |
| Extra {extra!r} is not installed. Selected extras: {listed} | exception | error | extras, validation, not-installed |
| missing update option: {option_key} | exception | error | config, validation, update-check |
| could not update {DEFAULT_CONFIG_PATH} | exception | error | filesystem, permissions, config, io |
| workspace.{field} must be a non-empty absolute path | validation | error | validation, path, workspace |
| workspace.{field} must be an absolute path without traversal | validation | error | validation, path, workspace, security |
| workspace.{field} is unavailable: {value} | validation | error | filesystem, path, workspace |
| workspace.{field} is not a directory: {value} | validation | error | filesystem, path, workspace, validation |
| workspace_config must be an object | validation | error | workspace, type-error, validation, config |
| workspace configuration must be JSON serializable | validation | error | workspace, json, serialization, validation |
| workspace configuration is too large | validation | error | workspace, config, limit-exceeded, validation |
| workspace binding was not persisted for thread {thread_id} | exception | error | workspace, sqlite, persistence, race-condition |
| thread {thread_id} is already bound to a different workspace | exception | error | workspace, conflict, binding, thread |
| thread_id must be non-empty | validation | error | workspace, validation, thread-id, argument-error |
| workspace context is required | validation | error | workspace, type-error, context, validation |
| thread {thread_id} has no workspace binding | exception | error | workspace, conflict, binding, thread |
| workspace context does not match thread {thread_id} | exception | error | workspace, conflict, context-mismatch, thread |
| workspace configuration does not match thread {thread_id} | exception | error | workspace, conflict, fingerprint, config |
| workspace binding schema is unsupported for thread {thread_i | exception | error | workspace, schema-version, conflict, state |
| workspace identity changed for thread {thread_id} | exception | error | workspace, identity, conflict, state |
| HarnessProfile.excluded_middleware is invalid: - required | validation | error | configuration, harness-profile, middleware, validation |
| HarnessProfile.excluded_middleware name entry matched multip | validation | error | configuration, harness-profile, middleware, ambiguity |
| HarnessProfile.excluded_middleware entries matched no middle | validation | error | configuration, harness-profile, middleware, typo |
| Default backend doesn't support command execution (SandboxBa | exception | error | backend, execution, sandbox, not-implemented |
| Context Hub cache failed to initialize | exception | error | context-hub, cache, initialization, remote |
| Context Hub mutation deadline is missing | exception | error | context-hub, concurrency, batching, internal-invariant |
| Context Hub commit succeeded but its hash could not be resol | exception | error | context-hub, commit, remote, consistency |
| Context Hub conflict retry loop exhausted unexpectedly | exception | error | python, concurrency, internal-invariant, context-hub |
| Path traversal not allowed | validation | error | python, path-traversal, security, filesystem |
| Path:{full} outside root directory: {self.cwd} | validation | error | python, path-traversal, symlink, sandbox, filesystem |
| context_lines must be non-negative | validation | error | python, argument-validation, grep |
| timeout must be positive, got {timeout} | validation | error | python, argument-validation, configuration, shell |
| timeout must be positive, got {effective_timeout} | exception | error | python, argument-validation, shell, timeout |
| ReadResult.start_line and end_line must be set together or b | validation | error | python, dataclass-invariant, protocol, pagination |
| ReadResult.no_lines_requested describes an uninspected windo | validation | error | python, dataclass-invariant, protocol |
| ReadResult.next_offset requires start_line and end_line to b | validation | error | python, dataclass-invariant, protocol, pagination |
| ReadResult.total_lines requires start_line and end_line to b | validation | error | validation, dataclass, backend-protocol |
| ReadResult window must satisfy 1 <= start_line <= end_line, | validation | error | validation, off-by-one, backend-protocol |
| ReadResult.total_lines ({self.total_lines}) cannot be less t | validation | error | validation, pagination, backend-protocol |
| ReadResult.next_offset ({self.next_offset}) must equal end_l | validation | error | validation, pagination, backend-protocol |
| NotImplementedError raised by abstract `ls` (backend does no | exception | error | not-implemented, abstract-method, backend-protocol |
| NotImplementedError raised by abstract `read` (backend does | exception | error | not-implemented, abstract-method, backend-protocol |
| NotImplementedError raised by abstract `grep` (backend does | exception | error | not-implemented, abstract-method, backend-protocol |
| NotImplementedError raised by abstract `glob` (backend does | exception | error | not-implemented, abstract-method, backend-protocol |
| NotImplementedError raised by abstract `write` (backend does | exception | error | not-implemented, abstract-method, backend-protocol |
| NotImplementedError raised by abstract `edit` (backend does | exception | error | not-implemented, abstract-method, backend-protocol |
| NotImplementedError raised by abstract `delete` (backend doe | exception | error | python, not-implemented, backend-protocol, optional-capability |
| NotImplementedError raised by abstract `upload_files` (backe | exception | error | python, not-implemented, backend-protocol, file-upload |
| NotImplementedError raised by abstract `download_files` (bac | exception | error | python, not-implemented, backend-protocol, file-download |
| NotImplementedError raised by abstract `id` property (backen | exception | error | python, not-implemented, sandbox, abstract-property |
| NotImplementedError raised by abstract `execute` (backend do | exception | error | python, not-implemented, sandbox, shell-execution |
| StateBackend must be used inside a LangGraph graph execution | exception | error | python, langgraph, state-backend, misuse, runtime-error |
| StateBackend requires CONFIG_KEY_READ / CONFIG_KEY_SEND in t | exception | error | python, langgraph, state-backend, config, runtime-error |
| Namespace tuple must not be empty. | validation | error | python, validation, store-backend, namespace, value-error |
| Namespace component at index {i} must be a string, got {type | validation | error | python, validation, type-error, store-backend, namespace |
| Namespace component at index {i} must not be empty. | validation | error | python, validation, store-backend, namespace, value-error |
| Namespace component at index {i} contains disallowed charact | validation | error | validation, namespace, store |
| StoreBackend must be used inside a LangGraph graph execution | exception | error | runtime-context, store, langgraph |
| The namespace factory tried to read the Runtime, but it is u | exception | error | runtime-context, namespace, langgraph |
| Store item does not contain valid content field. Got: {store | validation | error | store, schema, data-corruption |
| Store item `content` must be a `str` or legacy `list[str]`, | validation | error | store, type-error, schema |
| Path traversal not allowed in glob pattern {pattern!r} | validation | error | path-traversal, glob, security |
| Invalid glob pattern {pattern!r}: {exc} | validation | error | glob, validation, pattern |
| File content must be a string or a legacy list of strings, g | validation | error | type-error, file-data, validation |
| Path traversal not allowed: {path} | validation | error | path-traversal, security, validation |
| Windows absolute paths are not supported: {path}. Please use | validation | error | path-traversal, windows, validation |
| Path traversal detected after normalization: {path} -> {norm | validation | error | path-traversal, security, validation |
| Path must start with one of {allowed_prefixes}: {path} | validation | error | path-traversal, security, allowlist |
| Path cannot be empty | validation | error | validation, path |
| module {__name__!r} has no attribute {name!r} | exception | error | python, attributeerror, deprecated-api |
| Reading video files requires the optional video dependencies | exception | error | optional-dependency, video, import-error |
| offset_seconds must be >= 0, got {offset_seconds!r} | exception | error | video, validation, argument-error |
| Video stream has no time_base; cannot determine frame timest | exception | error | video, media-metadata, pyav |
| Video stream time_base is zero; cannot determine frame times | exception | error | video, media-metadata, pyav |
| Failed to decode video frames: {exc} | exception | error | video, decoding, pyav, codec |
| No frames decoded for window [{offset_seconds:.3f}s, {end_se | exception | error | video, empty-result, pyav |
| sampling_rate must be > 0, got {sampling_rate!r} | validation | error | python, validation, argument-error |
| duration_seconds must be > 0, got {duration_seconds!r} | validation | error | python, validation, argument-error |
| Failed to open video payload: {exc} | exception | error | video, pyav, decoding, corrupt-input |
| Video payload contains no video stream | exception | error | video, pyav, missing-stream, audio-only |
| Video frame dimensions {width}x{height} exceed the maximum { | exception | error | video, image-size, resource-limit, security |
| Video decoding exceeded the {MAX_VIDEO_DECODE_SECONDS:.1f}s | exception | error | video, timeout, resource-limit, performance |
| Video frame output exceeded the {MAX_VIDEO_EMITTED_BYTES} by | exception | error | video, resource-limit, payload-size, encoding |
| Async subagent '{name}' has no url configured. ASGI transpor | validation | error | python, langgraph, async, configuration |
| Failed to get run status: {e} | console | error | python, langgraph, network, error-handling |
| Failed to cancel run: {e} | console | error | python, langgraph, network, error-handling |
| At least one async subagent must be specified | validation | error | python, configuration, validation |
| Duplicate async subagent names: {dupes} | validation | error | python, configuration, validation |
| Permission path must start with '/': {path!r} | validation | error | python, filesystem, validation, configuration |
| Permission path must not contain '..': {path!r} | validation | error | python, filesystem, security, validation |
| Permission path must not contain '~': {path!r} | exception | error | python, filesystem, configuration |
| read_file must be included in tools; it is required by Files | validation | error | python, filesystem, configuration, validation |
| max_execute_timeout must be positive, got {max_execute_timeo | validation | error | python, filesystem, configuration, validation |
| grep_max_count must be positive or None, got {grep_max_count | validation | error | python, validation, filesystem, config |
| backend must be an initialized backend instance. Backend fac | validation | error | python, breaking-change, backend, migration |
| FilesystemMiddleware does not yet support permissions with b | exception | error | python, not-implemented, permissions, sandbox |
| system_prompt must be str or None, got {type(system_prompt). | validation | error | python, type-error, memory, prompt |
| system_prompt must contain the `{agent_memory}` format slot | validation | error | python, validation, memory, prompt-template |
| Failed to download {path}: {response.error} | exception | error | python, memory, backend, file-download |
| GraderResponse: result='satisfied' but at least one criterio | validation | error | python, validation, pydantic, rubric, llm |
| GraderResponse: result='needs_revision' but every criterion | validation | error | python, validation, pydantic, rubric, llm |
| RubricMiddleware: `model` is required. | validation | error | python, validation, rubric, config, llm |
| RubricMiddleware: `max_iterations` must be an int, got {type | validation | error | python, validation, constructor, type-error |
| RubricMiddleware: `max_iterations` must be positive, got {ma | validation | error | python, validation, constructor, value-error |
| RubricMiddleware: `grader_state_schema` is required with `bu | validation | error | python, validation, constructor, value-error |
| RubricMiddleware: `{name}` must be callable. | exception | error | python, validation, constructor, type-error |
| RubricMiddleware: `build_grader_state` cannot set `messages` | validation | error | python, rubric, runtime-error, value-error |
| RubricMiddleware grader did not return a structured_response | exception | error | python, rubric, structured-output, runtime-error |
| RubricMiddleware grader returned unexpected structured_respo | exception | error | python, rubric, structured-output, type-error |
| Invalid skill source: expected str or (str, str) tuple, got | exception | error | python, skills, validation, type-error |
| system_prompt must be str or None, got {type(system_prompt). | exception | error | python, skills, validation, type-error |
| system_prompt missing required format slot(s): {', '.join(mi | validation | error | python, skills, validation, value-error |
| SubAgent '{spec['name']}' must specify 'model' | validation | error | python, subagents, validation, valueerror |
| SubAgent '{spec['name']}' must specify 'tools' | validation | error | python, subagents, validation, valueerror |
| response_schema cannot be used with compiled subagent "{spec | validation | error | python, subagents, structured-output, incompatible-args |
| CompiledSubAgent must return a state containing a 'messages' | validation | error | python, langgraph, subagents, state-schema |
| Tool call ID is required for subagent invocation | validation | error | python, subagents, tool-call, valueerror |
| At least one subagent must be specified | validation | error | python, subagents, middleware, initialization |
| `history_path_prefix` was removed in deepagents 0.7. Configu | exception | error | python, summarization, deprecated-api, migration, typeerror |
| `create_summarization_middleware` expects `model` to be a `B | exception | error | python, summarization, typeerror, model-instance |
| system_prompt must be str or None, got {type(system_prompt). | exception | error | python, summarization, typeerror, type-validation |
| Profile key must be a non-empty string. | validation | error | python, profiles, validation |
| Profile key {key!r} has leading or trailing whitespace; expe | validation | error | python, profiles, whitespace |
| Profile key {key!r} has more than one ':'; expected 'provide | validation | error | python, profiles, validation |
| Profile key {key!r} has an empty provider or model half; exp | validation | error | python, profiles, validation |
| Profile key {key!r} has whitespace adjacent to ':'; expected | validation | error | python, profiles, whitespace |
| Unknown keys in GeneralPurposeSubagentProfile dict: {sorted( | exception | error | python, profiles, schema-validation |
| `enabled` must be bool or None, got {type(enabled).__name__} | exception | error | python, profiles, type-error |
| `description` must be str or None, got {type(description).__ | exception | error | python, profiles, type-error |
| `system_prompt` must be str or None, got {type(system_prompt | exception | error | python, profiles, type-error |
| HarnessProfile.excluded_middleware is invalid: - required | validation | error | python, profiles, middleware, config |
| Unknown keys in HarnessProfileConfig dict: {sorted(unknown)} | exception | error | python, validation, configuration, schema |
| HarnessProfileConfig.from_harness_profile() cannot export `e | validation | error | python, serialization, middleware, configuration |
| `{field_name}` must be str or None, got {type(value).__name_ | exception | error | python, type-error, validation, deserialization |
| `{field_name}` must be a mapping, got {type(value).__name__} | exception | error | python, type-error, validation, mapping |
| `{field_name}` keys and values must be strings | exception | error | python, type-error, validation, mapping |
| `{field_name}` must be a list/set of strings, got {type(valu | exception | error | python, type-error, validation, set |
| `{field_name}` entries must be strings, got {type(entry).__n | exception | error | python, type-error, validation, set |
| `general_purpose_subagent` must be a mapping, got {type(valu | exception | error | python, type-error, validation, deserialization |
| `{field_name}` entries must be non-empty, non-whitespace str | validation | error | config, validation, middleware |
| `{field_name}` entries must be plain middleware names; class | validation | error | config, validation, middleware, naming |
| `{field_name}` entry {entry!r} cannot start with '_' (unders | validation | error | config, validation, middleware, naming |
| HarnessProfileConfig.from_harness_profile() cannot serialize | validation | error | serialization, middleware, config |
| deepagents requires langchain-openrouter>={OPENROUTER_MIN_VE | exception | error | dependency, version, openrouter, import |
| The subagent `task` tool cannot be exposed via `ptc`. It is | validation | error | ptc, quickjs, reserved-name, tools |
| ptc list entries must be str or BaseTool | validation | error | ptc, type-error, tools, validation |
| Unsupported `ptc` config type. Use a list of tool names, lis | validation | error | ptc, type-error, config, validation |
| PTC tool name {tool.name!r} cannot be exposed as JavaScript | validation | error | ptc, javascript, naming, tools |
| QuickJS context is closed | exception | error | lifecycle, quickjs, use-after-close |
| task() requires non-empty string field `description` | validation | error | validation, quickjs, task-bridge |
| task() requires non-empty string field `subagentType` | validation | error | validation, quickjs, task-bridge |
| task() field `label` must be a string when provided | validation | error | validation, quickjs, task-bridge |
| task() field `responseSchema` must be an object when provide | validation | error | validation, quickjs, task-bridge |
| task() requires an active ToolRuntime | exception | error | quickjs, task-bridge, missing-runtime |
| task tool not configured for this eval | exception | error | quickjs, task-bridge, missing-tool |
| task bridge called outside active eval | exception | error | concurrency, quickjs, task-bridge |
| task call limiter not initialized | exception | error | quickjs, task-bridge, initialization |
| tool '{camel}' not registered | exception | error | concurrency, quickjs, tool-bridge, race-condition |
| PTC bridge called outside active eval | exception | error | concurrency, state, eval-lifecycle, quickjs |
| `snapshot_signing_key` must be a non-empty str or bytes. | validation | error | validation, configuration, hmac, snapshots |
| task() requires an active ToolRuntime | exception | error | runtime, subagent, state, quickjs |
| response_schema exceeds {_SCHEMA_MAX_BYTES} byte limit ({len | validation | error | validation, schema, limits, subagent |
| response_schema exceeds maximum nesting depth of {_SCHEMA_MA | validation | error | validation, schema, limits, recursion |
| response_schema exceeds maximum of {_SCHEMA_MAX_PROPERTIES} | validation | error | validation, schema, limits |
| `mode` must be one of 'thread', 'turn', or 'call'. | validation | error | validation, configuration, middleware, snapshots |
| `max_ptc_calls` must be >= 1 or None | validation | error | validation, configuration, limits, ptc |
| `max_snapshot_bytes` must be >= 1 or None | validation | error | validation, configuration, limits, snapshots |
| Failed to list blueprints: {e} | exception | error | network, api, blueprint, provider, runloop |
| Blueprint '{blueprint_name}' exists but its last build faile | exception | error | runloop, blueprint, build-failed, dockerfile |
| Failed to build blueprint '{blueprint_name}': {create_err} | exception | error | runloop, blueprint, dockerfile, build-failed |
| Received unsupported arguments: {list(kwargs.keys())} | validation | error | python, api-misuse, typeerror, unsupported-arguments |
| {sandbox_id} | exception | error | runloop, not-found, keyerror, stale-id |
| Runloop rejected the credentials; check RUNLOOP_API_KEY (or | exception | error | authentication, api-key, runloop, credentials |
| Runloop API unreachable (transient — safe to retry): {e} | exception | error | network, timeout, transient, runloop, retryable |
| Failed to create Runloop devbox from '{target}': {e} | exception | error | runloop, devbox, api-error, rate-limit |
| Blueprint name is required when no blueprint ID is set | exception | error | runloop, blueprint, api-misuse, internal |
| timeout must be non-negative, got {timeout} | validation | error | python, validation, vercel, valueerror, timeout |
| chunk limit must be positive | validation | error | python, validation, valueerror, messaging, chunking |
| {config.provider} self exposure requires {operator_var}; set | validation | error | config, env, validation |
| str(exc) (re-raised from resolve_bounded_media_path) | exception | error | media, path-validation, security |
| media file does not exist: {path} | exception | error | media, filesystem |
| media file type {detected!r} does not match requested type { | exception | error | media, validation, type-mismatch |
| media file is too large: {size} bytes exceeds {max_bytes} | exception | error | media, size-limit, validation |
| {MAX_MEDIA_BYTES_ENV} must be a positive integer byte count | validation | error | config, env, validation |
| expected {label} value, got {value!r} | validation | error | config, env, parsing |
| {media.media_type} media is too large: {size} bytes exceeds | exception | error | media, size-limit, validation |
| invalid {provider} exposure mode {value!r}; expected one of: | validation | error | config, env, enum-validation |
| {config.provider} exposure mode 'open' allows arbitrary send | validation | error | security, configuration, env-var, channels |
| unsupported media file type: {path} | exception | error | media, validation, channels |
| unsupported media mime type: {mime} | exception | error | media, validation, channels |
| Telegram bot token is required (DEEPAGENTS_TALON_TELEGRAM_BO | validation | error | telegram, env-var, configuration, bot-token |
| Telegram media is too large: {file_size} bytes exceeds {self | exception | error | telegram, media, size-limit, download |
| media file is too large: {expected} bytes exceeds {max_bytes | exception | error | telegram, media, size-limit, download, http |
| media file is too large: {total} bytes exceeds {max_bytes} | exception | error | telegram, media, size-limit, download, streaming |
| assistant id is required | validation | error | configuration, env-var, assistant-id |
| assistant id must be 1-128 characters and contain only lette | validation | error | configuration, validation, assistant-id |
| cron schedules must be at least 1 minute | validation | error | cron, scheduling, validation |
| schedule must look like 'in 30m' or 'every 15m' | validation | error | validation, cron, input-format |
| repeat cap must be at least 1 | validation | error | validation, cron, dataclass |
| repeat completed count cannot be negative | validation | error | validation, cron, state |
| repeat cap is only valid for recurring jobs | validation | error | validation, cron, api-misuse |
| cron job not found in current conversation: {job_id} | exception | error | cron, not-found, scope-mismatch, state-management |
| cron retention window cannot be negative | validation | error | cron, validation, argument-error, retention |
| cron jobs file must contain a JSON list | validation | error | cron, json, corrupt-state, schema |
| schedule duration must be a single value such as '30m' | validation | error | cron, parsing, schedule, validation |
| schedule duration must use 'm' for minutes or 'h' for hours | validation | error | cron, validation, scheduling, argument-parsing |
| schedule duration must be a positive integer | validation | error | cron, validation, integer-parsing |
| schedule duration must be at least 1 minute | validation | error | cron, validation, minimum-value |
| tick_seconds must be positive | validation | error | scheduler, asyncio, validation, constructor |
| {key} must be a non-negative integer | validation | error | env, configuration, integer-parsing, data-lifecycle |
| AGENTS.md: missing required root prompt | exception | error | import, zip, validation, fleet |
| {source}: invalid zip file | exception | error | import, zip, file-format, corrupt-file |
| {target}: {exc} | exception | error | import, filesystem, permissions, io |
| {info.filename}: unsafe zip path | exception | critical | security, zip-slip, path-traversal, import |
| {name}: symlink entries are not supported | error_code | error | security, zip, symlink, validation |
| {archive.filename}: too many zip entries | error_code | error | zip, limits, resource-exhaustion |
| {name}: zip entry uncompressed size exceeds limit | error_code | error | zip, limits, size-limit, validation |
| {name}: zip entry compression ratio exceeds limit | error_code | error | security, zip, zip-bomb, compression |
| {info.filename}: zip entry expanded beyond declared size | error_code | error | security, zip, zip-bomb, integrity |
| {path}: unsafe subagent name {name!r} | error_code | error | validation, zip, naming, path-safety |
| {source}: {_display_path(path)}: malformed tools.json: {exc. | error_code | error | json, validation, config, zip |
| {source}: {_display_path(path)}: {exc} | error_code | error | filesystem, io, zip, environment |
| {source}: {_display_path(path)}: malformed tools.json: expec | error_code | error | json, schema-validation, config, zip |
| {source}: {_display_path(path)}: malformed tools.json: expec | error_code | error | json, config, validation, mcp |
| {source}: {_display_path(path)}: tools[{index}] must be an o | error_code | error | json, config, validation, mcp |
| {source}: {_display_path(path)}: tools[{index}].{key} must b | error_code | error | json, config, validation, mcp |
| str(exc) | error_code | error | mcp, config, json, wrapping |
| unsupported outbound media file type: {path} | validation | error | media, validation, filetype |
| media path must be a local filesystem path: {path} | validation | error | media, path, validation, security |
| media path must be a local relative path under the outbound | validation | error | media, path, validation, security |
| media path must not contain parent-directory traversal: {pat | validation | error | media, path, security, traversal |
| media file is unavailable: {path} | validation | error | media, filesystem, path |
| media path escapes outbound root: {path} | validation | error | media, path, security, symlink |
| media path is not a regular file: {path} | validation | error | filesystem, validation, media |
| recursion_limit must be positive | validation | error | configuration, validation, env |
| max_retries must be at least 1 | validation | error | configuration, validation, retry |
| max_continuations cannot be negative | validation | error | configuration, validation |
| DeepAgentRuntime must be started before invoke | exception | error | lifecycle, async, runtime |
| agent invocation retry loop exited unexpectedly | exception | error | runtime, retry, internal-invariant |
| Deep Agents graph does not expose async invocation | exception | error | async, compatibility, graph |
| agent hit tool approval interrupt limit | exception | error | human-in-the-loop, interrupts, limit |
| agent returned approval interrupts without resumable ids | exception | error | interrupts, schema, human-in-the-loop |
| {key} must be a positive integer | validation | error | env, configuration, validation |
| Could not apply {CONTEXT_SIZE_ENV_KEY} to model profile | validation | error | configuration, model, env-var, profile |
| cron tools must be called from within a Talon conversation | exception | error | runtime, context, cron, misuse |
| Local voice transcription dependencies are missing. Install | exception | error | dependencies, import, voice, install |
| ffmpeg not found on PATH; install ffmpeg to enable voice tra | exception | error | ffmpeg, voice, path, environment |
| ffmpeg timed out while converting {path} | exception | error | ffmpeg, voice, timeout, performance |
| ffmpeg conversion failed with exit code {proc.returncode}: { | exception | error | ffmpeg, voice, conversion, media |
| Offloading conversation history to backend failed during sum | console | warning | summarization, backend, storage, data-loss |
| Skipping {group} plugin {plugin_label}: entry point {ep.valu | console | warning | plugins, entry-points, profiles, configuration |
| <dynamic deprecation warning message from captured record> | console | warning | deprecation, python, api-migration, langchain |
| Conversation history was offloaded to {file_path}, but {fail | console | warning | summarization, media, storage, data-loss, python |
| Failed to enumerate {group} entry points; no third-party plu | console | warning | plugins, entry-points, packaging, environment, python |
| Skipping {group} plugin {plugin_label}: failed to load entry | console | error | plugins, entry-points, import-error, dependencies, python |
| Skipping {group} plugin {plugin_label}: registration callabl | console | error | plugins, entry-points, registration, configuration, python |