invalid_submission | 400 | Submission | Correct empty input/key; do not retry unchanged. | runs.ts |
idempotency_conflict | 409 | Submission | Original request exists. Compare exact input/origin; reuse original intent, not a fresh key. | runs.ts |
session_busy | 409 | Submission | An active Run exists; observe it and queue follow-up work in your application. | runs.ts |
session_closed | 409 | Submission | Inspect current Session state; create a deliberate new context only when appropriate. | runs.ts |
sandbox_expired | 409 | Submission | Inspect original resource cleanup before new work. | runs.ts |
connection_not_ready | 409 | Submission | Inspect validation, enablement and pinned version before retrying; a new connection revision does not rewrite existing Sessions, and old resources may still exist. | runs.ts |
context_file_missing | 409 | Submission | Upload the referenced file to the same Session while its initial-upload window is open; after execution starts, inspect the pinned context instead of assuming upload can repair it. | runs.ts |
context_file_changed | 409 | Submission | Compare pinned SHA-256 and uploaded bytes; do not ignore the mismatch. | runs.ts |
context_file_encoding | 400 | Submission | Supply valid UTF-8 text without NUL. | runs.ts |
context_file_too_large | 413 | Submission | Reduce referenced background text; see limits. | runs.ts |
input_too_large | 413 | Submission | Reduce input plus compiled background bytes. | runs.ts |
initialization_too_large | 413 | Initialization | Reduce serialized/compiled initialization. | initialization.ts |
upload_too_large | 413 | Upload | Reduce decoded total or split valid batches; per-file limits remain. | inputs.ts |
connection_changed_during_validation | 409 | Connection validation | Read current configuration and validate that revision again. | connections.ts |
connection_in_use | 409 | Connection deletion | Inspect dependent Sessions/definitions; settle dependencies without losing cleanup access. | connections.ts |
harness_version_conflict | 409 | Registration | Inspect both OCI and source-package registrations: they share id/version. Reuse an identical OCI definition or deliberately choose a new version; do not overwrite the old identity. | images.ts |
preview_session_unavailable | 409 | Preview | Check Session/resource state; do not interpret unavailable preview as failed Run. | previews.ts |
preview_unauthorized | 401 | Preview access | Check grant expiry/revocation and authorized access; never log the grant URL. | previews.ts |
tool_call_conflict | 409 | Tool call / resolution | Compare call identity/arguments and exact request hash; never replace evidence to force acceptance. | broker.ts |
tool_call_in_flight | 409 | Tool resolution | Wait for the broker lock to settle, then re-query; do not concurrently resolve. | reconciliation.ts |
tool_outcome_not_unknown | 409 | Tool resolution | Read current call state; resolution is only for unknown outcomes. | reconciliation.ts |
tool_resolution_conflict | 409 | Tool resolution | An incompatible resolution was recorded; inspect it rather than overwriting. | reconciliation.ts |
tool_authorization_not_pending | 409 | Authorization refusal | Re-query the original call; its authorization wait has changed. | reconciliation.ts |
tool_run_not_active | 409 | Tool decision | Do not revive terminal/cancelling work; inspect recorded effects. | broker.ts |
tool_account_changed | 409 | Tool dispatch | Reconcile account identity and pinned binding; do not silently switch accounts. | broker.ts |
mcp_schema_changed | 409 | Tool dispatch | Revalidate discovery and choose a new compatible binding/Session as needed. | broker.ts |
tool_operation_unavailable | 400 | Tool dispatch | Check selected and pinned operation catalogs; do not broaden permissions automatically. | broker.ts |
lease_lost | 409 | Worker update | Stale execution authority: let current owner recover; never force a duplicate invocation. | artifacts.ts |
invalid_artifact_manifest | 400 | Artifact capture | Inspect duplicates and aggregate size; failed capture does not undo the task. | artifacts.ts |
artifact_integrity_failed | 400 | Artifact capture | Check size, canonical Base64 and SHA-256; do not return corrupted output. | artifacts.ts |
artifact_conflict | 409 | Artifact capture | Same Run/name already has different bytes; retain and investigate both claims. | artifacts.ts |
duplicate_input_path | 400 | Upload | Remove duplicate paths within the request; no upload transaction has begun. | inputs.ts |
reserved_initialization_path | 400 | Upload | Do not replace SOUL.md when initialization owns it; choose another project file path. | inputs.ts |
workspace_already_started | 409 | Upload | Initial inputs are closed after a Run or allocation; continue through Agent work, not another upload. | inputs.ts |
ambiguous_variables | 400 | Definition | Supply variables or nonempty env, not both; existing Sessions are not rewritten. | sessions.ts |
connection_kind_mismatch | 400 | Binding | Use sandbox/model/tool/http IDs in their matching fields; do not copy credential values into ID fields. | sessions.ts |
missing_tool_binding | 400 | Session creation | Bind every declared Tool by name; optional readiness does not mean the binding can be omitted. | sessions.ts |
agent_archived | 409 | Agent use/update | Inspect the archived template; use an active template or explicit new definition for new Sessions. | sessions.ts |
agent_revision_changed | 409 | Agent update | Reload the current revision and reconcile the full replacement before retrying. | sessions.ts |
stale_approval | 409 | Approval decision | Refresh the exact approval and Run; cancellation or another decision may have settled it. | runs.ts |
session_connection_changed | 409 | Credential access | Pinned connection version differs; inspect current binding, settle old work and create a deliberate replacement Session if needed. | access.ts |