AgentKit Studio
Reference

Error codes

All 198 error codes: the top 30 map code to user action, the rest are grouped into 45 namespaces with meaning and triage entry.

How codes are counted

198 codes in total: 193 from code: '...' literals under src/** and 5 from the wire boundary (STUDIO_WIRE_ERRORS); the sets overlap and are unioned.

A code is a stable contract: it appears in client branches, logs and triage docs. Renaming one is a breaking change.

Wire boundary errors

These five codes come from the control protocol codec. status is the suggested HTTP status; 0 means the connection terminated without an HTTP response.

CodestatusMeaningSource
agentkit/not-found404Unknown operationsrc/contracts/definitions.mjs:13
STUDIO_REQUEST_INVALID400Non-serializable JSON requestsrc/contracts/definitions.mjs:14
STUDIO_RESPONSE_INVALID502Malformed response envelopesrc/contracts/definitions.mjs:15
gateway/cancelled0Caller or owning Host cancelledsrc/contracts/definitions.mjs:16
agentkit/server-unavailable0Unclassified domain failuresrc/contracts/definitions.mjs:17

Top 30: code → action

Ordered by how soon a user hits them. Every action is directly executable without reading source.

CodeSourceAction
AGENT_NOT_FOUNDsrc/host/routes/agents.mjs:13Check whether the Agent was deleted; recreate it in this workspace
INVALID_AGENT_IDsrc/host/routes/agents.mjs:52Check that agentId is non-empty and well formed
MODEL_CREDENTIAL_MISSINGsrc/model-service.mjs:71Add the API Key for that model profile in settings
MODEL_NOT_FOUNDsrc/model-service.mjs:61Refresh the model catalog; for a custom endpoint check OPENAI_BASE_URL
MODEL_URL_INVALIDsrc/model-service.mjs:37The endpoint must be an absolute http(s):// URL
CLOUD_CONFIGURATION_REQUIREDsrc/remote/control-client.mjs:439Configure cloud credentials and the control plane endpoint first
CLOUD_EXECUTION_MODE_DENIEDsrc/host/routes/agents.mjs:118The policy denied this execution mode; request a lower tier
MCP_NOT_FOUNDsrc/mcp-probes.mjs:21Confirm the MCP server still exists in the resource list
MCP_CONFIGURATION_REQUIREDsrc/template-resource-library.mjs:36Complete the MCP connection config (command or URL)
SKILL_MANIFEST_MISSINGsrc/skill-files.mjs:35Check that the Skill package contains SKILL.md
SKILL_DOWNLOAD_URL_MISSINGsrc/providers/native-skill-service.mjs:285Provide a download URL for the remote Skill
SKILL_AUTHORIZATION_EXPIREDsrc/providers/native-skill-service.mjs:152Re-authorize the Skill source
TEMPLATE_SERVER_CREDENTIAL_MISSINGsrc/template-catalog-client.mjs:14Add the expert template service credential
TEAM_TEMPLATE_INVALIDsrc/team-template-audit.mjs:53Check kind, id, version and required text
TEAM_TEMPLATE_ROLE_INVALIDsrc/team-template-contract.mjs:58roles[0].name must be lead; role names must be unique
TEAM_RUNTIME_UNAVAILABLEsrc/studio-team-runtime.mjs:105A role runtime must be dsh-native or harness
DEPLOYMENT_CREATE_INTERRUPTEDsrc/studio-deployments.mjs:364Reconcile the cloud side before retrying
DEPLOYMENT_UPDATE_INTERRUPTEDsrc/deployment-rollouts.mjs:167Same; do not retry the update repeatedly
SESSION_NOT_FOUNDsrc/host/routes/sessions.mjs:27Confirm sessionId belongs to this Host
SESSION_ID_INVALIDsrc/prompt-prediction/host.mjs:196sessionId must not be empty
BUILD_NOT_READYsrc/host-remote.mjs:166Wait for the build to become available before downloading
RUNTIME_UNSUPPORTEDsrc/runtime-contract.mjs:67runtime.type is not one of STUDIO_RUNTIME_TYPES
RUN_IDENTITY_INVALIDsrc/providers/dsh-runtime.mjs:41Fill in agentId / sessionId / runId / buildId
REQUEST_TOO_LARGEsrc/model-proxy-handler.mjs:47Shrink the request body or switch to chunked upload
INVALID_QUERYsrc/agent-catalog.mjs:9Check the query string types and enum values
CREDENTIAL_VALUE_MISSINGsrc/host/routes/credentials.mjs:7Fill in the value for that credential reference
EVALUATION_TARGET_NOT_FOUNDsrc/host/services/automation.mjs:47Register the evaluation target first
CHANNEL_URL_INVALIDsrc/channel-connector.mjs:8A channel URL must be an absolute HTTPS URL
STUDIO_HOST_INCOMPATIBLEsrc/host/compatibility.mjs:40Upgrade the DSH base to the version studio.plugin.json requires
DSH_PLUGIN_INDEX_UNAVAILABLEsrc/dsh-plugin-index.mjs:58Check index reachability; on failure the market keeps the last result

Namespace index

The remaining 170 codes are grouped by namespace, with meaning and the first triage entry per group.

NamespaceSizeMeaningTriage entry
STUDIO25Studio host and routing.src/agent-preset-admission.mjs:162
NATIVE16Native engine, A2A and web authorization.src/agent-preset-admission.mjs:337
CLOUD15Cloud execution modes and streaming responses.src/cloud-execution-modes.mjs:41
CODEX11Codex App Server and plugin market.src/client/dsh/codex-tool.mjs:33
SKILL10Skill download, authorization and runtime.src/providers/native-skill-connection.mjs:92
INVALID8Input validation.src/agent-catalog.mjs:9
MANAGED8Managed runtime, resources and input conflicts.src/host/bootstrap.mjs:158
MODEL8Model catalog, endpoints and credentials.src/model-endpoint.mjs:9
DSH7DSH base and plugin index.src/agent-preset-admission.mjs:345
RUNTIME7Runtime routing and transport.src/cloud-runtime-fetch.mjs:6
MCP6MCP server binding and configuration.src/host/services/resource-tools.mjs:21
RESOURCE5Resource catalog and adapters.src/host/services/optional-resource.mjs:10
SESSION5Session identity and export.src/host/routes/sessions.mjs:19
TEMPLATE5Expert template service.src/template-catalog-client.mjs:14
AUTOMATION4Automation runs and delivery.src/native-automation-runner.mjs:21
CHANNEL4Channel connection and turns.src/channel-connector.mjs:8
HOST4Host connection and tool calls.src/providers/dsh-runtime-plugin.mjs:167
RESPONSES4Responses protocol projection.src/frozen-build-runtime.mjs:88
TEAM4Team roles and templates.src/providers/codex-resource-context.mjs:18
AGENTKIT3Standalone codes without a namespace prefix.src/contracts/definitions.mjs:17
BUILTIN3Built-in Skill manifests.src/builtin-skills.mjs:44
UPSTREAM3Upstream streaming.src/model-proxy-handler.mjs:150
A2A2Agent-to-Agent control plane.src/providers/native-a2a-receipt.mjs:97
AGENT2Agent catalog and revision resolution.src/host/routes/agents.mjs:13
BUILD2Builds and frozen runtime.src/agent-preset-admission.mjs:327
CREDENTIAL2Credential references and values.src/host/routes/credentials.mjs:6
DEPLOYMENT2Deployment interruption and recovery.src/deployment-rollouts.mjs:167
DISCOVERY2MCP and Skill discovery.src/dsh-plugin-discovery.mjs:244
EVALUATION2Evaluation targets and runs.src/host/routes/evaluations.mjs:8
REQUEST2Request body and cancellation.src/model-proxy-handler.mjs:47
RUN2Run identity.src/providers/dsh-runtime.mjs:41
STAR2Local Star Harness install, version and workspace binding.src/host/routes/http.mjs:65
BOUND1Resource binding resolution.src/providers/codex-resource-context.mjs:137
CHANNELS1Channel subsystem availability.src/host/routes/channels.mjs:8
GATEWAY1Standalone codes without a namespace prefix.src/host/routes/dispatcher.mjs:28
LOCAL1Local harness lifecycle.src/host/routes/http.mjs:24
MEMORY1Memory store outcomes.src/providers/native-cloud-memory-turn.mjs:113
OBSERVABILITY1Observability export.src/host/routes/traces.mjs:9
SCHEDULE1Schedules.src/host/services/automation.mjs:29
SCHEDULER1Host scheduler.src/host/routes/schedules.mjs:14
SERVER1Server connection.src/remote/compatibility-methods.mjs:57
STATELESS1Stateless call input.src/model-proxy-handler.mjs:55
SUMMON1Template summon conflicts.src/template-summon.mjs:108
TOOL1Tool lookup.src/providers/dsh-presentation-tools.mjs:7
USER1User question validation.src/providers/user-question-tool.mjs:54

Full list

Every code by namespace. Search the repo for a code to find where it is thrown.

STUDIO (25) — STUDIO_AGENT_REQUIRED · STUDIO_BUILD_ENGINE_UNSUPPORTED · STUDIO_DEPLOYMENT_REQUIRED · STUDIO_DSH_A2A_UNAVAILABLE · STUDIO_HOST_INCOMPATIBLE · STUDIO_IMAGE_ATTACHMENT_UNAVAILABLE · STUDIO_INPUT_REQUIRED · STUDIO_LEGACY_HARNESS_RETIRED · STUDIO_NATIVE_AGENT_POLICY_INVALID · STUDIO_NATIVE_AGENT_POLICY_UNAVAILABLE · STUDIO_NATIVE_APPROVAL_DECISION_INVALID · STUDIO_NATIVE_BUILTIN_UNAVAILABLE · STUDIO_NATIVE_EXACT_NUMBER_UNSUPPORTED · STUDIO_NATIVE_MCP_SCHEMA_ENGINE_REQUIRED · STUDIO_NATIVE_PRESENTATION_UNAVAILABLE · STUDIO_NATIVE_TURN_REQUIRED · STUDIO_PRESET_AGENT_ID_MISSING · STUDIO_PRESET_REGISTRY_RETIRED · STUDIO_PRESET_RESOURCES_UNAVAILABLE · STUDIO_PRESET_RUNTIME_UNSUPPORTED · STUDIO_PRESET_SCOPE_CLOSED · STUDIO_REQUEST_INVALID · STUDIO_RESPONSE_INVALID · STUDIO_ROUTE_MISSING · STUDIO_SCOPE_DISPOSED

NATIVE (16) — NATIVE_A2A_ASSERT_CURRENT_REQUIRED · NATIVE_A2A_AUTHORIZE_REQUIRED · NATIVE_A2A_BINDING_DESCRIPTION_REQUIRED · NATIVE_A2A_DISCOVERY_REQUIRED · NATIVE_A2A_EXPOSURE_PLAN_REQUIRED · NATIVE_A2A_SCOPE_REQUIRED · NATIVE_ENGINE_CONFIG_INVALID · NATIVE_ENGINE_MODEL_UNAVAILABLE · NATIVE_ENGINE_TOOL_EFFECT_UNAVAILABLE · NATIVE_ENGINE_TOOL_POLICY_UNAVAILABLE · NATIVE_ENGINE_TOOLS_CLOSED · NATIVE_ENGINE_UNAVAILABLE · NATIVE_ENGINE_VERIFICATION_UNAVAILABLE · NATIVE_ENGINE_WORKSPACE_UNAVAILABLE · NATIVE_EXECUTION_NOT_COMPLETED · NATIVE_WEB_AUTHORIZE_REQUIRED

CLOUD (15) — CLOUD_AGENT_DELETED · CLOUD_AGENT_ID_INVALID · CLOUD_CONFIGURATION_REQUIRED · CLOUD_DELETE_UNAVAILABLE · CLOUD_EXECUTION_MODE_DENIED · CLOUD_EXECUTION_MODE_INVALID · CLOUD_EXECUTION_MODE_UNAVAILABLE · CLOUD_EXECUTION_MODE_UNSUPPORTED · CLOUD_IMAGE_INPUT_UNAVAILABLE · CLOUD_RUN_CANCELLED · CLOUD_RUN_FAILED · CLOUD_STREAM_INCOMPLETE · CLOUD_STREAM_INVALID · CLOUD_STREAM_ITEM_CHANGED · CLOUD_SUBACCOUNT_REQUIRED

CODEX (11) — CODEX_AGENT_REQUIRED · CODEX_MARKETPLACE_PARTIAL · CODEX_MODEL_PROVIDER_UNAVAILABLE · CODEX_PLUGIN_DETAILS_INVALID · CODEX_PLUGIN_INVENTORY_UNAVAILABLE · CODEX_PLUGIN_MARKETPLACE_MISSING · CODEX_PLUGIN_METADATA_UNAVAILABLE · CODEX_PLUGIN_NOT_FOUND · CODEX_TOOL_CONVERSION_FAILED · CODEX_TOOL_OUTCOME_UNKNOWN · CODEX_WORKSPACE_UNAVAILABLE

SKILL (10) — SKILL_AUTHORIZATION_EXPIRED · SKILL_BINDING_INVALID · SKILL_DOWNLOAD_INVALID · SKILL_DOWNLOAD_URL_INVALID · SKILL_DOWNLOAD_URL_MISSING · SKILL_LOAD_AUTHORITY_CHANGED · SKILL_MANIFEST_MISSING · SKILL_PAGE_BUDGET_INVALID · SKILL_RUNTIME_DEADLINE · SKILL_SERVICE_INVALID_RESPONSE

INVALID (8) — INVALID_AGENT_ID · INVALID_CONVERSATION_INPUT · INVALID_FEEDBACK · INVALID_JSON · INVALID_QUERY · INVALID_RESOURCE_CURSOR · INVALID_RESOURCE_SOURCE · INVALID_SESSION_ID

MANAGED (8) — MANAGED_HARNESS_RUN_INCOMPLETE · MANAGED_HOST_INPUT_CONFLICT · MANAGED_RESOURCE_IDENTITY_UNAVAILABLE · MANAGED_RESOURCE_INVALID · MANAGED_RESOURCE_PERMIT_REQUIRED · MANAGED_RUNTIME_DELETE_UNCONFIRMED · MANAGED_RUNTIME_MODEL_INVALID · MANAGED_RUNTIME_REQUIRED

MODEL (8) — MODEL_CATALOG_FAILED · MODEL_CREDENTIAL_MISSING · MODEL_ENDPOINT_INVALID · MODEL_NOT_FOUND · MODEL_PROFILE_EXISTS · MODEL_PROFILE_INVALID · MODEL_UPSTREAM_ERROR · MODEL_URL_INVALID

DSH (7) — DSH_PLUGIN_INDEX_TIMEOUT · DSH_PLUGIN_INDEX_UNAVAILABLE · DSH_PLUGIN_INDEX_URL_REJECTED · DSH_PRESET_COMPOSITION_UNAVAILABLE · DSH_PRESET_REGISTRY_UNAVAILABLE · DSH_PRESET_ROUTE_UNAVAILABLE · DSH_TURN_FAILED

RUNTIME (7) — RUNTIME_HOST_CAPABILITY_UNAVAILABLE · RUNTIME_MODEL_UNAVAILABLE · RUNTIME_REQUEST_CONFLICT · RUNTIME_REQUEST_HISTORY_UNAVAILABLE · RUNTIME_REQUEST_METADATA_UNAVAILABLE · RUNTIME_TRANSPORT_CLOSED · RUNTIME_UNSUPPORTED

MCP (6) — MCP_BINDING_AMBIGUOUS · MCP_CONFIGURATION_REQUIRED · MCP_ID_INVALID · MCP_NOT_FOUND · MCP_RESOURCE_ADAPTER_MISSING · MCP_RESOURCE_NOT_BOUND

RESOURCE (5) — RESOURCE_ADAPTER_MISSING · RESOURCE_CATALOG_INVALID_RESPONSE · RESOURCE_CATALOG_TOO_LARGE · RESOURCE_OVERVIEW_TRUNCATED · RESOURCE_SERVICE_UNAVAILABLE

SESSION (5) — SESSION_EXPORT_TOO_LARGE · SESSION_EXPORT_UNAVAILABLE · SESSION_ID_INVALID · SESSION_ID_MISSING · SESSION_NOT_FOUND

TEMPLATE (5) — TEMPLATE_CANCELLED · TEMPLATE_INTERRUPTED · TEMPLATE_SERVER_CREDENTIAL_MISSING · TEMPLATE_SERVER_REJECTED · TEMPLATE_SERVICE_CLOSED

AUTOMATION (4) — AUTOMATION_OUTCOME_UNKNOWN · AUTOMATION_SERVICE_UNAVAILABLE · AUTOMATION_SESSION_NOT_DURABLE · AUTOMATION_TIMEOUT

CHANNEL (4) — CHANNEL_AGENT_UNAVAILABLE · CHANNEL_REQUEST_NOT_FOUND · CHANNEL_TURN_INCOMPLETE · CHANNEL_URL_INVALID

HOST (4) — HOST_CONNECTION_MISSING · HOST_TOOL_OUTCOME_UNAVAILABLE · HOST_TOOL_REJECTED · HOST_TOOL_RUN_MISMATCH

RESPONSES (4) — RESPONSES_FROZEN_MODEL_MISMATCH · RESPONSES_PREVIOUS_NOT_COMPLETED · RESPONSES_PREVIOUS_NOT_FOUND · RESPONSES_PROJECTION_NOT_JSON

TEAM (4) — TEAM_PRESET_CONFLICT · TEAM_ROLE_UNAVAILABLE · TEAM_RUNTIME_UNAVAILABLE · TEAM_TEMPLATE_NONE

AGENTKIT (3) — agentkit/bad-request · agentkit/not-found · agentkit/server-unavailable

BUILTIN (3) — BUILTIN_META_TOOL_FORBIDDEN · BUILTIN_SKILL_MANIFEST_EMPTY · BUILTIN_SKILL_MANIFEST_MISSING

UPSTREAM (3) — UPSTREAM_EVENT_TOO_LARGE · UPSTREAM_STREAM_ERROR · UPSTREAM_STREAM_TRUNCATED

A2A (2) — A2A_QUESTION_STALE · A2A_TOOL_ACTIVITY_UNAVAILABLE

AGENT (2) — AGENT_NOT_FOUND · AGENT_REVISION_INVALID

BUILD (2) — BUILD_NOT_READY · BUILD_RUNTIME_UNSUPPORTED

CREDENTIAL (2) — CREDENTIAL_NAME_INVALID · CREDENTIAL_VALUE_MISSING

DEPLOYMENT (2) — DEPLOYMENT_CREATE_INTERRUPTED · DEPLOYMENT_UPDATE_INTERRUPTED

DISCOVERY (2) — DISCOVERY_TIMEOUT · DISCOVERY_UNAVAILABLE

EVALUATION (2) — EVALUATION_TARGET_NOT_FOUND · EVALUATION_UNAVAILABLE

REQUEST (2) — REQUEST_CANCELLED · REQUEST_TOO_LARGE

RUN (2) — RUN_IDENTITY_INVALID · RUN_IDENTITY_MISMATCH

STAR (2) — STAR_HARNESS_OWNER_REQUIRED · STAR_HARNESS_UNSUPPORTED

BOUND (1) — BOUND_TOOL_NOT_FOUND

CHANNELS (1) — CHANNELS_UNAVAILABLE

GATEWAY (1) — gateway/cancelled

LOCAL (1) — LOCAL_HARNESS_RETIRED

MEMORY (1) — MEMORY_OUTCOME_UNKNOWN

OBSERVABILITY (1) — OBSERVABILITY_UNAVAILABLE

SCHEDULE (1) — SCHEDULE_AGENT_NOT_LOCAL

SCHEDULER (1) — SCHEDULER_UNAVAILABLE

SERVER (1) — SERVER_CONNECTION_MISSING

STATELESS (1) — STATELESS_INPUT_REQUIRED

SUMMON (1) — SUMMON_REQUEST_CONFLICT

TOOL (1) — TOOL_NOT_FOUND

USER (1) — USER_QUESTION_INVALID

Version and compatibility

ItemValueNotes
Total codes198Additive only; a rename needs an alias
Wire codes5src/contracts/definitions.mjs
Namespaces45First underscore-delimited segment
Excluded non-codesENOTFOUND · UNKNOWN · CLOUDNode errno / A2A envelope / tool label, not a Studio error code

Developer entry points

ItemSource
Wire error definitionssrc/contracts/definitions.mjs
Runtime codessrc/runtime-contract.mjs
Template codessrc/team-template-contract.mjs
Catalog codessrc/dsh-plugin-catalog.mjs
Troubleshooting pagecontent/docs/help/troubleshooting.mdx

Related tests:

Test fileLocation
desktop-module-graph.test.mjstests/desktop-module-graph.test.mjs
studio-wire-contracts.test.mjstests/studio-wire-contracts.test.mjs

On this page