Skip to content

Error codes

Safe errors contain code, message and retryable. Interpret the current operation and Run together; retryable is not permission to repeat an uncertain effect.

CodeInterpretation
INVALID_REQUESTInput/configuration/credential precondition failed
NOT_FOUNDIdentity/resource absent
CONFLICTStale revision, changed state or competing identity
BUSYAnother operation owns the resource
STORAGE_ERRORFormal persistence failed
KERNEL_UNAVAILABLEResources/execution unavailable
RUN_STOPPEDExplicit cancellation
RUN_INTERRUPTEDUnsupported or uncertain restart boundary
RUN_CHECKPOINT_FAILEDCould not save continuation
STAGE_STATE_INVALIDSchema/JSON validation failed
STAGE_STATE_EXISTS / STAGE_STATE_NOT_FOUNDState write precondition failed
STAGE_STATE_INACTIVE / EXECUTION_OWNERSHIP_LOSTExpired capability or result
STEP_OUTCOME_NOT_HANDLED / INVALID_TRANSITIONInvalid outcome routing
STEP_RESULT_INVALIDCode result is not outcome-only
LLM_REQUEST_FAILED / LLM_RESPONSE_INVALIDProvider request/response failed
AGENT_OUTPUT_INVALIDFinal structured output failed validation
TOOL_EXECUTION_FAILED / STEP_EXECUTION_FAILEDTool or Step failed
CLI_SERVICE_PROTOCOL_MISMATCHExpected Service API returned non-JSON HTTP 404; check CLI/Service compatibility and explicitly stop/start to reload
CLI_RESULT_INVALIDResponse JSON, envelope or requested project/instance/request identity is invalid
CLI_SERVICE_UNAVAILABLEHTTP rejection without a valid business result
CLI_SERVICE_OFFLINE / CLI_SERVICE_TIMEOUTConnection failed / response timed out
REQUEST_OUTCOME_UNKNOWNTransmitted write has no valid receipt; query the original operation before another submission
CLI_INIT_TARGET_NOT_EMPTYInitialization target contains files
CLI_OUTPUT_EXISTS / CLI_ARTIFACT_EXPORT_FAILEDLocal export failed
MCP_CONFIG_INVALID / MCP_CONFIG_CONFLICTInvalid or conflicting client config
MIRROR_RESTORE_FAILEDImage cannot restore into prepared target

These are common categories, not all Workflow-defined business codes. Inspect lastError, cursor, logs and prior commits.

Transport errors can report outcome: unknown while execution continues. Query the original Run or operation identity before retrying. A commit or file change before failure can remain applied.

For Compiler codes, see Compiler. Follow troubleshooting for diagnostic steps.