Skip to content

Agent Error Catalog

ErrorInvariantDocsFix
agent_os.backend_protocol_parse_failureinvariant.boundary.runtime-validation-external-onlybackend-protocol.mdDecode backend protocol payloads at the protocol boundary and reject malformed external input before it reaches runtime logic.
agent_os.boundary_commit_rejectedinvariant.d10.namespace-integrity, invariant.d10.truth-identityboundary-contract.mdCommit through the owning BoundaryContract with matching event vocabulary, scopeRef, effectAuthorityRef, and claim identity.
agent_os.capability_rejectedinvariant.d10.namespace-integrityboundary-contract.mdRegister the extension capability that owns the event prefix before committing or dispatching the fact.
agent_os.cloudflare_worker_bundle_resolution_failureinvariant.boundary.runtime-validation-external-onlydeploy-cloudflare.mdResolve Cloudflare worker bundle references before deploy composition and fail the provider boundary when the bundle cannot be located.
agent_os.cloudflare_worker_deploy_resolution_failureinvariant.boundary.runtime-validation-external-onlydeploy-cloudflare.mdResolve deploy target bindings and provider configuration before emitting deploy facts.
agent_os.dispatch_binding_ref_malformedinvariant.d10.truth-identitybackend-cloudflare-do.mdUse a valid binding MaterialRef for dispatch targets and reject malformed target refs at the backend boundary.
agent_os.dispatch_payload_parse_failureinvariant.boundary.runtime-validation-external-onlybackend-protocol.mdDecode dispatch payloads through the backend protocol parser before committing inbound or outbound dispatch facts.
agent_os.dispatch_scope_mismatchinvariant.d10.truth-identitybackend-cloudflare-do.mdDispatch only to the exact target scopeRef and effectAuthorityRef; do not reuse a scope-wide derived key as truth.
agent_os.dispatch_target_not_foundinvariant.d10.truth-identitybackend-cloudflare-do.mdRegister or resolve the dispatch target binding before enqueueing delivery.
agent_os.durable_trigger_acquire_cancelledinvariant.ledger.single-commit-sourcedurable-process-algebra.mdKeep trigger acquisition and cancellation in the durable trigger lifecycle contract so a claimed row always has a recoverable terminal path.
agent_os.durable_trigger_commit_returned_thenableinvariant.ledger.single-commit-sourcedurable-process-algebra.mdKeep trigger commit callbacks synchronous inside the backend transaction and move asynchronous work after durable commit.
agent_os.durable_trigger_drain_limit_exceededinvariant.ledger.single-commit-sourcedurable-process-algebra.mdDrain due work through the durable trigger scheduler with an explicit limit and retry the remaining due work later.
agent_os.dynamic_worker_failureinvariant.boundary.runtime-validation-external-onlydynamic-worker.mdSurface dynamic worker provider failures through the provider boundary instead of converting them into successful runtime output.
agent_os.dynamic_worker_policy_deniedinvariant.boundary.runtime-validation-external-onlydynamic-worker.mdReject disallowed dynamic worker requests at policy evaluation before provider execution.
agent_os.dynamic_worker_policy_violationinvariant.boundary.runtime-validation-external-onlydynamic-worker.mdMove policy-violating dynamic worker input back to the caller boundary and require a valid provider policy.
agent_os.dynamic_worker_provider_failureinvariant.boundary.runtime-validation-external-onlydynamic-worker.mdClassify provider failures at the dynamic worker adapter and keep product logic out of provider error parsing.
agent_os.effect_ai_abortedinvariant.boundary.runtime-validation-external-onlyllm-transport-effect-ai.mdPropagate Effect AI aborts through LlmTransport and let submit own terminal runtime facts.
agent_os.effect_ai_json_encode_failedinvariant.algebra.single-code-sourcellm-transport-effect-ai.mdEncode structured provider payloads through the Effect AI transport adapter and fail before committing runtime evidence.
agent_os.effect_ai_missing_usageinvariant.algebra.single-code-sourcellm-transport-effect-ai.mdKeep provider usage accounting in the LlmTransport output schema and reject responses that cannot produce runtime usage evidence.
agent_os.effect_ai_prompt_errorinvariant.boundary.runtime-validation-external-onlyllm-transport-effect-ai.mdBuild prompts at the provider adapter boundary and surface prompt construction failures before submit records terminal facts.
agent_os.effect_ai_provider_executed_tool_rejectedinvariant.algebra.single-code-sourcellm-transport-effect-ai.mdDisable provider-executed tool paths for agentOS tools; tool execution must flow through runtime admission and ledger settlement.
agent_os.effect_ai_tool_handler_calledinvariant.algebra.single-code-sourcellm-transport-effect-ai.mdTreat provider-side tool handler invocation as an adapter violation; runtime owns tool calls and settlements.
agent_os.effect_ai_unsupported_output_partinvariant.algebra.single-code-sourcellm-transport-effect-ai.mdMap provider output parts through the runtime output-item algebra and reject parts without a runtime representation.
agent_os.effect_ai_unsupported_routeinvariant.boundary.runtime-validation-external-onlyllm-transport-effect-ai.mdChoose a route supported by the Effect AI transport adapter or add an explicit adapter branch for the provider.
agent_os.extension_capability_conflictinvariant.d10.namespace-integrityboundary-contract.mdDeclare one owner for each extension capability and event namespace; remove duplicate capability declarations.
agent_os.invalid_resource_amountinvariant.algebra.type-or-boot-proofresource-carrier.mdReject non-positive or non-finite resource amounts before committing resource or quota facts.
agent_os.invalid_schedule_atinvariant.ledger.single-commit-sourcedurable-process-algebra.mdSchedule durable work with a valid future timestamp and keep scheduling inside the durable process contract.
agent_os.invalid_trace_contextinvariant.boundary.runtime-validation-external-onlyruntime.mdDecode trace context at the runtime boundary and reject malformed trace metadata before provider or ledger projection consumes it.
agent_os.json_stringify_errorinvariant.ledger.single-commit-sourcedurable-truth.mdEncode final payloads before commit side effects consume them; reject unstringifiable payloads before projection application.
agent_os.legacy_ledger_schemainvariant.d10.truth-identitydurable-truth.mdDelete old local backend state and initialize the D10 schema; no legacy row migration is supported.
agent_os.llm_call_timed_outinvariant.boundary.runtime-validation-external-onlyruntime.mdPropagate LLM call timeout through submit and commit a runtime-owned terminal abort fact.
agent_os.llm_call_timeoutinvariant.boundary.runtime-validation-external-onlyruntime.mdUse the timeout marker only as abort metadata and let runtime terminal events expose the durable failure.
agent_os.postgres_harness_errorinvariant.boundary.runtime-validation-external-onlybackend-node-postgres.mdStart and clean up the runtime contract Postgres harness at the test boundary, mapping Docker, psql, and config failures into the harness error channel.
agent_os.projection_application_errorinvariant.d10.truth-identitymaterialized-projections.mdKeep projection reducers pure and make malformed facts explicit failures rather than alternate truth.
agent_os.projection_reducer_returned_thenableinvariant.d10.truth-identitymaterialized-projections.mdMove asynchronous work to the ledger writer or backend transaction hook; projection reducers must be synchronous.
agent_os.projection_registry_errorinvariant.d10.truth-identitymaterialized-projections.mdBuild a projection registry with unique projection kinds and valid projection definitions.
agent_os.projection_wait_timed_outinvariant.d10.truth-identitymaterialized-projections.mdWait on the ledger-derived projection with a bounded Effect retry policy, or commit the missing ledger fact before reading the projection.
agent_os.provider_http_failureinvariant.boundary.runtime-validation-external-onlyagent-schema.mdHandle provider transport failures at the LLM transport boundary and let submit record the runtime terminal fact.
agent_os.provider_output_decode_errorinvariant.algebra.single-code-sourceagent-schema.mdDecode provider output through the runtime output-item schema instead of product-side fallback parsing.
agent_os.ref_resolution_failedinvariant.boundary.runtime-validation-external-onlycarriers-and-material.mdResolve symbolic material refs at the adapter boundary and fail closed when a required ref cannot be resolved.
agent_os.resource_insufficientinvariant.ledger.single-commit-sourceresource-carrier.mdGrant or release resources through the resource ledger before attempting a reservation that would exceed available capacity.
agent_os.resource_reservation_closedinvariant.ledger.single-commit-sourceresource-carrier.mdDo not consume or release a reservation after its terminal resource fact has already been committed.
agent_os.resource_reservation_not_foundinvariant.ledger.single-commit-sourceresource-carrier.mdCommit or look up the resource reservation under the exact ledger identity before consuming or releasing it.
agent_os.sandbox_failureinvariant.boundary.runtime-validation-external-onlysandbox.mdClassify sandbox provider failures at the sandbox execution-domain adapter and return a closed tool result.
agent_os.sandbox_policy_deniedinvariant.algebra.type-or-boot-proofsandbox.mdReject sandbox requests that violate the declared sandbox policy before provider execution.
agent_os.scope_missinginvariant.d10.truth-identitydurable-truth.mdResolve the structured scopeRef before runtime or backend operations; do not fall back to an implicit scope.
agent_os.sql_errorinvariant.ledger.single-commit-sourcedurable-truth.mdKeep SQL writes inside the backend-owned ledger commit primitive and return typed SqlError at the backend boundary.
agent_os.stream_identity_errorinvariant.d10.truth-identitybackend-cloudflare-do.mdStream only with an exact scopeRef and effectAuthorityRef identity and reject malformed stream identity input.
agent_os.tenant_credential_resolver_configuration_errorinvariant.boundary.runtime-validation-external-onlytenant-material.mdConfigure tenant credential resolution before binding provider credentials to material refs.
agent_os.trigger_factory_errorinvariant.ledger.single-commit-sourcedurable-process-algebra.mdKeep durable trigger factory output synchronous, typed, and registered before scheduling or claiming trigger work.
agent_os.unregistered_durable_trigger_kindinvariant.ledger.single-commit-sourcedurable-process-algebra.mdRegister the durable trigger kind before scheduling, claiming, or dispatching due work.
agent_os.unregistered_projection_kindinvariant.d10.truth-identitymaterialized-projections.mdRegister the projection definition before reading, status-checking, or rebuilding that projection kind.
agent_os.unsupported_scope_refinvariant.d10.truth-identitydurable-truth.mdUse a backend-supported scopeRef kind or add an explicit backend adapter branch for that scope kind.
agent_os.workspace_job_candidate_missinginvariant.workspace-job.verified-terminalworkspace-job.mdTreat a missing candidate as a workspace_job.failed terminal fact before finalization or verification can produce a deliverable.
agent_os.workspace_job_data_plane_failedinvariant.workspace-job.verified-terminalworkspace-job.mdKeep seed and terminal build/write/read failures inside the workspace job data-plane boundary and settle them through workspace_job.failed.
agent_os.workspace_job_run_id_mismatchinvariant.workspace-job.verified-terminalworkspace-job.mdReject terminal builder output whose run id does not match the requested workspace job before verifier checks can mark it deliverable.
agent_os.workspace_job_verifier_failedinvariant.workspace-job.verified-terminalworkspace-job.mdMap verifier exceptions to workspace_job.failed; reserve verifier_rejected for successful product-domain verifier verdicts.