ARVN AI guide
Technical reference
ARVN AI Error and Blocker Reference
A complete reference for public ARVN AI error codes, blockers, safe diagnostic steps, retry guidance and escalation boundaries.
291 named codes10 diagnostic categoriesUpdated August 8, 2026
Safe-code scope
This reference documents fixed public codes and named diagnostic contracts across ARVN chat, planning, preview, confirmation, execution, audit and operator paths. Raw provider messages, secrets and stack traces are intentionally excluded.
Find a code
Use your browser Find command and paste the exact uppercase code. Follow the safe response instead of repeated blind retries.
Errors versus findings
Module audit findings are domain diagnostics, not runtime errors. Their explanation and recommendation appear inside the relevant audit or module workflow.
Error family
Access and rollout
| Code | Meaning | Safe response | Retry |
|---|---|---|---|
ACTING_USER_UNAUTHORIZED | An identity, tenant, feature gate or rollout requirement blocked the request (acting user unauthorized). | Verify user, server and feature access. Only an authorized operator may change rollout configuration after preflight. | After correction |
ARVN_AI_CAPABILITY_PLAN_REQUIRED | The active plan permits ARVN AI but not the specific requested capability or execution package. | Use a capability included in the active plan or upgrade through billing. Never edit plan metadata or package requirements manually. | After correction |
ARVN_AI_PLAN_REQUIRED | The server's active commercial plan does not include access to ARVN AI. | Upgrade the server through the supported billing flow. Admin status, beta flags and provider output must never widen commercial entitlement. | After correction |
ARVN_BETA_CHAT_DISABLED | An identity, tenant, feature gate or rollout requirement blocked the request (arvn beta chat disabled). | Verify user, server and feature access. Only an authorized operator may change rollout configuration after preflight. | After correction |
ARVN_BETA_DISABLED | An identity, tenant, feature gate or rollout requirement blocked the request (arvn beta disabled). | Verify user, server and feature access. Only an authorized operator may change rollout configuration after preflight. | After correction |
ARVN_BETA_EXECUTION_DISABLED | An identity, tenant, feature gate or rollout requirement blocked the request (arvn beta execution disabled). | Verify user, server and feature access. Only an authorized operator may change rollout configuration after preflight. | After correction |
ARVN_BETA_EXECUTION_GUILD_NOT_ALLOWLISTED | An identity, tenant, feature gate or rollout requirement blocked the request (arvn beta execution guild not allowlisted). | Verify user, server and feature access. Only an authorized operator may change rollout configuration after preflight. | After correction |
ARVN_BETA_PREVIEW_DISABLED | An identity, tenant, feature gate or rollout requirement blocked the request (arvn beta preview disabled). | Verify user, server and feature access. Only an authorized operator may change rollout configuration after preflight. | After correction |
INFRASTRUCTURE_TENANT_MISMATCH | An identity, tenant, feature gate or rollout requirement blocked the request (infrastructure tenant mismatch). | Verify user, server and feature access. Only an authorized operator may change rollout configuration after preflight. | After correction |
MODULE_DISABLED | An identity, tenant, feature gate or rollout requirement blocked the request (module disabled). | Verify user, server and feature access. Only an authorized operator may change rollout configuration after preflight. | After correction |
NOT_ENABLED | An identity, tenant, feature gate or rollout requirement blocked the request (not enabled). | Verify user, server and feature access. Only an authorized operator may change rollout configuration after preflight. | After correction |
OPERATOR_DRAFT_TENANT_MISMATCH | An identity, tenant, feature gate or rollout requirement blocked the request (operator draft tenant mismatch). | Verify user, server and feature access. Only an authorized operator may change rollout configuration after preflight. | After correction |
UNAUTHORIZED | An identity, tenant, feature gate or rollout requirement blocked the request (unauthorized). | Verify user, server and feature access. Only an authorized operator may change rollout configuration after preflight. | After correction |
Error family
AI provider and chat
| Code | Meaning | Safe response | Retry |
|---|---|---|---|
AI_CHAT_GENERATE_FAILED | The AI response path could not produce a safe usable result (ai chat generate failed). | Keep the original message, retry once if temporary, and escalate with safe code and timestamp if repeated. | Usually |
AI_CHAT_STREAM_FAILED | The AI response path could not produce a safe usable result (ai chat stream failed). | Keep the original message, retry once if temporary, and escalate with safe code and timestamp if repeated. | Usually |
AI_PARSE_ERROR | The AI response path could not produce a safe usable result (ai parse error). | Keep the original message, retry once if temporary, and escalate with safe code and timestamp if repeated. | Usually |
AI_PROVIDER_AUTH_FAILED | The configured AI provider rejected its credentials. | An operator must verify the provider key and project configuration without exposing credentials in chat or logs. | Operator only |
AI_PROVIDER_ERROR | The AI response path could not produce a safe usable result (ai provider error). | Keep the original message, retry once if temporary, and escalate with safe code and timestamp if repeated. | Usually |
AI_PROVIDER_QUOTA_EXCEEDED | The provider account has no remaining quota or billing capacity for this request. | Check provider quota and billing. Do not weaken structured-output or safety validation to save tokens. | Operator only |
AI_PROVIDER_RATE_LIMITED | The provider request-rate limit was reached. | Wait for the provider window to reset, then retry once. Repeated retries add pressure and do not create quota. | Usually |
AI_PROVIDER_REFUSAL | The provider refused or safety-blocked the completion. | Rephrase only if the task is legitimate. A refusal must never become an executable plan. | After correction |
AI_PROVIDER_REQUEST_REJECTED | The AI response path could not produce a safe usable result (ai provider request rejected). | Keep the original message, retry once if temporary, and escalate with safe code and timestamp if repeated. | Usually |
AI_PROVIDER_TIMEOUT | The provider did not finish within the allowed time. | Retry once. If it repeats, preserve the timestamp and safe code for diagnostics. | Usually |
AI_PROVIDER_UNAVAILABLE | The AI response path could not produce a safe usable result (ai provider unavailable). | Keep the original message, retry once if temporary, and escalate with safe code and timestamp if repeated. | Usually |
AI_RATE_LIMITED | The AI response path could not produce a safe usable result (ai rate limited). | Keep the original message, retry once if temporary, and escalate with safe code and timestamp if repeated. | Usually |
AI_STREAM_ERROR | The AI response path could not produce a safe usable result (ai stream error). | Keep the original message, retry once if temporary, and escalate with safe code and timestamp if repeated. | Usually |
AI_PROVIDER_DEADLINE_EXCEEDED | A provider call was not started because the remaining turn budget was too small. | Retry once; if the turn repeatedly runs out of time, shorten the request or try again later. | Usually |
Error family
Planning and capability binding
| Code | Meaning | Safe response | Retry |
|---|---|---|---|
CAPABILITY_BINDING_MISMATCH | The plan or persisted capability evidence failed its binding contract (capability binding mismatch). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
MISSING_CAPABILITY_ARTIFACTS | The plan or persisted capability evidence failed its binding contract (missing capability artifacts). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
PILOT_CAPABILITY_VERSION_NOT_ALLOWLISTED | The plan or persisted capability evidence failed its binding contract (pilot capability version not allowlisted). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
PLAN_HASH_MISMATCH | The plan or persisted capability evidence failed its binding contract (plan hash mismatch). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
PLAN_NOT_FOUND | The plan or persisted capability evidence failed its binding contract (plan not found). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
PLAN_REVISION_MISMATCH | The plan or persisted capability evidence failed its binding contract (plan revision mismatch). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
SEMANTIC_SHADOW_FAILED | The plan or persisted capability evidence failed its binding contract (semantic shadow failed). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
UNGROUNDED_RECOMMENDATION | The plan or persisted capability evidence failed its binding contract (ungrounded recommendation). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
UNKNOWN_BUILDER_MODULE | The plan or persisted capability evidence failed its binding contract (unknown builder module). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
CAPABILITY_ARTIFACTS_NOT_BOUND_TO_FINAL_PLAN | The plan or persisted capability evidence failed its binding contract (capability artifacts not bound to final plan). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
CAPABILITY_BINDING_CONFLICT | The plan or persisted capability evidence failed its binding contract (capability binding conflict). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
CAPABILITY_BINDING_FAILED | The plan or persisted capability evidence failed its binding contract (capability binding failed). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
CAPABILITY_DEPENDENCY_MISSING | The plan or persisted capability evidence failed its binding contract (capability dependency missing). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
CAPABILITY_DUPLICATE_ID | The plan or persisted capability evidence failed its binding contract (capability duplicate id). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
CAPABILITY_HANDLER_NOT_REGISTERED | The plan or persisted capability evidence failed its binding contract (capability handler not registered). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
CAPABILITY_MANIFEST_INVALID | The plan or persisted capability evidence failed its binding contract (capability manifest invalid). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
CAPABILITY_MODULE_NOT_ACTIVE | The plan or persisted capability evidence failed its binding contract (capability module not active). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
CAPABILITY_NOT_AVAILABLE | The plan or persisted capability evidence failed its binding contract (capability not available). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
CAPABILITY_NOT_REGISTERED | The plan or persisted capability evidence failed its binding contract (capability not registered). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
CAPABILITY_OPERATOR_MISSING | The plan or persisted capability evidence failed its binding contract (capability operator missing). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
CAPABILITY_PERMISSION_MISSING | The plan or persisted capability evidence failed its binding contract (capability permission missing). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
CAPABILITY_PLAN_LIMIT_EXCEEDED | The plan or persisted capability evidence failed its binding contract (capability plan limit exceeded). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
CAPABILITY_RESULT_INVALID | The plan or persisted capability evidence failed its binding contract (capability result invalid). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
CAPABILITY_RESULT_NOT_FOUND | The plan or persisted capability evidence failed its binding contract (capability result not found). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
CAPABILITY_RESULT_PERSISTENCE_FAILED | The plan or persisted capability evidence failed its binding contract (capability result persistence failed). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
CAPABILITY_ROUTE_NOT_SUPPORTED | The plan or persisted capability evidence failed its binding contract (capability route not supported). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
CAPABILITY_VERSION_MISMATCH | The plan or persisted capability evidence failed its binding contract (capability version mismatch). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
PLAN_ARTIFACT_MISMATCH | The plan or persisted capability evidence failed its binding contract (plan artifact mismatch). | Regenerate from current session/server context. Never manually seed or weaken capability artifacts. | After correction |
Error family
Confirmation and handoff
| Code | Meaning | Safe response | Retry |
|---|---|---|---|
CHALLENGE_INVALID | The approval or execution-handoff boundary rejected the request (challenge invalid). | Review the latest plan and issue a fresh confirmation. Never reuse an old challenge or nonce. | After correction |
CONFIRMATION_EXPIRED | The confirmation challenge expired before consumption. | Generate and review a fresh plan and confirmation. Never revive the expired challenge. | After correction |
CONFIRMATION_NOT_CONSUMED | The approval or execution-handoff boundary rejected the request (confirmation not consumed). | Review the latest plan and issue a fresh confirmation. Never reuse an old challenge or nonce. | After correction |
CONFIRMATION_NOT_FOUND | The approval or execution-handoff boundary rejected the request (confirmation not found). | Review the latest plan and issue a fresh confirmation. Never reuse an old challenge or nonce. | After correction |
HANDOFF_ALREADY_TERMINAL | The approval or execution-handoff boundary rejected the request (handoff already terminal). | Review the latest plan and issue a fresh confirmation. Never reuse an old challenge or nonce. | After correction |
HANDOFF_NOT_AVAILABLE | The approval or execution-handoff boundary rejected the request (handoff not available). | Review the latest plan and issue a fresh confirmation. Never reuse an old challenge or nonce. | After correction |
HANDOFF_NOT_EXECUTABLE | The approval or execution-handoff boundary rejected the request (handoff not executable). | Review the latest plan and issue a fresh confirmation. Never reuse an old challenge or nonce. | After correction |
HANDOFF_NOT_FOUND | The approval or execution-handoff boundary rejected the request (handoff not found). | Review the latest plan and issue a fresh confirmation. Never reuse an old challenge or nonce. | After correction |
HANDOFF_PERSISTENCE_DISABLED | The approval or execution-handoff boundary rejected the request (handoff persistence disabled). | Review the latest plan and issue a fresh confirmation. Never reuse an old challenge or nonce. | After correction |
NONCE_INVALID | The approval or execution-handoff boundary rejected the request (nonce invalid). | Review the latest plan and issue a fresh confirmation. Never reuse an old challenge or nonce. | After correction |
SECOND_CONFIRMATION_EXPIRED | The approval or execution-handoff boundary rejected the request (second confirmation expired). | Review the latest plan and issue a fresh confirmation. Never reuse an old challenge or nonce. | After correction |
SECOND_CONFIRMATION_INVALID_NONCE | The approval or execution-handoff boundary rejected the request (second confirmation invalid nonce). | Review the latest plan and issue a fresh confirmation. Never reuse an old challenge or nonce. | After correction |
SECOND_CONFIRMATION_NOT_FOUND | The approval or execution-handoff boundary rejected the request (second confirmation not found). | Review the latest plan and issue a fresh confirmation. Never reuse an old challenge or nonce. | After correction |
SECOND_CONFIRMATION_REPLAYED | The approval or execution-handoff boundary rejected the request (second confirmation replayed). | Review the latest plan and issue a fresh confirmation. Never reuse an old challenge or nonce. | After correction |
SECOND_CONFIRMATION_REQUIRED | The operation risk requires a second, separate confirmation. | Read and answer the second risk question explicitly; the first confirmation is intentionally insufficient. | After correction |
SECOND_CONFIRMATION_STALE | The approval or execution-handoff boundary rejected the request (second confirmation stale). | Review the latest plan and issue a fresh confirmation. Never reuse an old challenge or nonce. | After correction |
CONFIRMATION_INVALID | The approval or execution-handoff boundary rejected the request (confirmation invalid). | Review the latest plan and issue a fresh confirmation. Never reuse an old challenge or nonce. | After correction |
CONFIRMATION_REPLAYED | The approval or execution-handoff boundary rejected the request (confirmation replayed). | Review the latest plan and issue a fresh confirmation. Never reuse an old challenge or nonce. | After correction |
Error family
Canonical package and pilot
| Code | Meaning | Safe response | Retry |
|---|---|---|---|
CANONICAL_PACKAGE_REPLAY_INVALID | The canonical package or controlled rollout policy rejected the request (canonical package replay invalid). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
CANONICAL_PACKAGE_REQUIRED | The canonical package or controlled rollout policy rejected the request (canonical package required). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
CANONICAL_VALIDATION_FAILURE | The canonical package or controlled rollout policy rejected the request (canonical validation failure). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PACKAGE_BINDING_MISMATCH | The canonical package or controlled rollout policy rejected the request (package binding mismatch). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PACKAGE_EXPIRED | The canonical package or controlled rollout policy rejected the request (package expired). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PACKAGE_HASH_INVALID | The canonical package or controlled rollout policy rejected the request (package hash invalid). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PACKAGE_HASH_MISMATCH | The canonical package or controlled rollout policy rejected the request (package hash mismatch). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PACKAGE_LOAD_ERROR | The canonical package or controlled rollout policy rejected the request (package load error). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PACKAGE_NOT_APPROVED | The canonical package or controlled rollout policy rejected the request (package not approved). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PACKAGE_NOT_READY | The canonical package or controlled rollout policy rejected the request (package not ready). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PACKAGE_PLAN_TIER_INVALID | The execution package contains an unknown or malformed required commercial plan tier. | Reject the package and rebuild it from the authoritative capability registry. Never normalize an unknown tier into a valid entitlement. | After correction |
PACKAGE_SCHEMA_MISMATCH | The canonical package or controlled rollout policy rejected the request (package schema mismatch). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PILOT_ALLOWLIST_EXPIRED | The canonical package or controlled rollout policy rejected the request (pilot allowlist expired). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PILOT_ALLOWLIST_MISMATCH | The canonical package or controlled rollout policy rejected the request (pilot allowlist mismatch). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PILOT_BOT_PERMISSIONS_INSUFFICIENT | The canonical package or controlled rollout policy rejected the request (pilot bot permissions insufficient). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PILOT_DISCORD_INACTIVE | The canonical package or controlled rollout policy rejected the request (pilot discord inactive). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PILOT_ENGINE_INACTIVE | The canonical package or controlled rollout policy rejected the request (pilot engine inactive). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PILOT_EVIDENCE_STALE | The canonical package or controlled rollout policy rejected the request (pilot evidence stale). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PILOT_EXECUTION_IDENTITY_MISSING | The canonical package or controlled rollout policy rejected the request (pilot execution identity missing). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PILOT_NOT_ENABLED | The canonical package or controlled rollout policy rejected the request (pilot not enabled). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PILOT_OPERATION_NOT_ALLOWLISTED | The canonical package or controlled rollout policy rejected the request (pilot operation not allowlisted). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PILOT_PACKAGE_SHAPE_EXPIRED | The canonical package or controlled rollout policy rejected the request (pilot package shape expired). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PILOT_PACKAGE_SHAPE_MISMATCH | The canonical package or controlled rollout policy rejected the request (pilot package shape mismatch). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PILOT_PACKAGE_SHAPE_NOT_DEFINED | The canonical package or controlled rollout policy rejected the request (pilot package shape not defined). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PILOT_PERMISSION_EVIDENCE_MISSING | The canonical package or controlled rollout policy rejected the request (pilot permission evidence missing). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PILOT_RISK_LEVEL_NOT_ALLOWLISTED | The canonical package or controlled rollout policy rejected the request (pilot risk level not allowlisted). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PILOT_SERVER_NOT_ALLOWLISTED | The canonical package or controlled rollout policy rejected the request (pilot server not allowlisted). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PILOT_TOO_MANY_OPERATIONS | The canonical package or controlled rollout policy rejected the request (pilot too many operations). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PILOT_USER_AUTHORIZATION_INSUFFICIENT | The canonical package or controlled rollout policy rejected the request (pilot user authorization insufficient). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
PILOT_USER_NOT_ALLOWLISTED | The canonical package or controlled rollout policy rejected the request (pilot user not allowlisted). | Do not bypass the gate. Rebuild the package or have an authorized operator correct the exact rollout mismatch. | Operator only |
Error family
Credits and settlement
| Code | Meaning | Safe response | Retry |
|---|---|---|---|
AI_CREDIT_RESERVATION_INVALID | The credit lifecycle could not prove a safe financial transition (ai credit reservation invalid). | Use supported billing/reconciliation surfaces. Never patch ledger or reservation rows manually. | Operator only |
AI_NOT_ENOUGH_CREDITS | The credit lifecycle could not prove a safe financial transition (ai not enough credits). | Use supported billing/reconciliation surfaces. Never patch ledger or reservation rows manually. | Operator only |
AMBIGUOUS_RECONCILIATION | The credit lifecycle could not prove a safe financial transition (ambiguous reconciliation). | Use supported billing/reconciliation surfaces. Never patch ledger or reservation rows manually. | Operator only |
BUDGET_RESERVATION_EXPIRED | The execution credit reservation expired. | Generate a fresh confirmation path. Never edit reservation rows manually. | After correction |
BUDGET_RESERVATION_INVALID | The credit lifecycle could not prove a safe financial transition (budget reservation invalid). | Use supported billing/reconciliation surfaces. Never patch ledger or reservation rows manually. | Operator only |
BUDGET_RESERVATION_MISSING | The credit lifecycle could not prove a safe financial transition (budget reservation missing). | Use supported billing/reconciliation surfaces. Never patch ledger or reservation rows manually. | Operator only |
INSUFFICIENT_CREDITS | The server lacks enough available credits for the bound operation budget. | Review balance or billing, then create a fresh reservation through the normal flow. | After correction |
RESERVATION_FAILURE | The credit lifecycle could not prove a safe financial transition (reservation failure). | Use supported billing/reconciliation surfaces. Never patch ledger or reservation rows manually. | Operator only |
SETTLEMENT_TRANSACTION_FAILED | Credit settlement and terminal execution finalization could not complete atomically. | Preserve the record and use authorized reconciliation; never guess the charge outcome. | Operator only |
UNSAFE_RECONCILIATION_STATE | Stored evidence is insufficient for a safe reconciliation decision. | Escalate for manual evidence review. Do not commit or release credits from assumptions. | Operator only |
AI_CREDIT_RESERVATION_MISSING | The credit lifecycle could not prove a safe financial transition (ai credit reservation missing). | Use supported billing/reconciliation surfaces. Never patch ledger or reservation rows manually. | Operator only |
NOT_RECONCILIATION_REQUIRED | The credit lifecycle could not prove a safe financial transition (not reconciliation required). | Use supported billing/reconciliation surfaces. Never patch ledger or reservation rows manually. | Operator only |
Error family
Discord state and permissions
| Code | Meaning | Safe response | Retry |
|---|---|---|---|
AUTOMOD_EXEMPTION_LOOKUP_FAILED | A fresh Discord state, permission, hierarchy or scope check failed (automod exemption lookup failed). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
AUTOMOD_EXEMPT_CHANNEL_NOT_IN_GUILD | A fresh Discord state, permission, hierarchy or scope check failed (automod exempt channel not in guild). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
AUTOMOD_EXEMPT_ROLE_NOT_IN_GUILD | A fresh Discord state, permission, hierarchy or scope check failed (automod exempt role not in guild). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
BAN_LOOKUP_FAILED | A fresh Discord state, permission, hierarchy or scope check failed (ban lookup failed). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
BOT_MEMBER_LOOKUP_FAILED | A fresh Discord state, permission, hierarchy or scope check failed (bot member lookup failed). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
CATEGORY_HAS_CHILDREN | Category deletion was blocked because channels still reference it. | Move or deliberately remove child channels first, then prepare a new deletion plan. | After correction |
CHANNEL_LOOKUP_FAILED | A fresh Discord state, permission, hierarchy or scope check failed (channel lookup failed). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
CHANNEL_NOT_IN_GUILD | A fresh Discord state, permission, hierarchy or scope check failed (channel not in guild). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
ESCALATION_ROLE_PROTECTED | A fresh Discord state, permission, hierarchy or scope check failed (escalation role protected). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
EVERYONE_ROLE_PROTECTED | The request targets the protected @everyone role in an unsupported way. | Use a supported @everyone permission operation or a normal role; never spoof the sentinel. | After correction |
HIERARCHY_CHECK_FAILED | A fresh Discord state, permission, hierarchy or scope check failed (hierarchy check failed). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
INVALID_PERMISSION_KEYS | A fresh Discord state, permission, hierarchy or scope check failed (invalid permission keys). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
INVITE_LOOKUP_FAILED | A fresh Discord state, permission, hierarchy or scope check failed (invite lookup failed). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
MANAGED_ROLE_PROTECTED | A fresh Discord state, permission, hierarchy or scope check failed (managed role protected). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
MEMBER_HIERARCHY_BLOCKED | A fresh Discord state, permission, hierarchy or scope check failed (member hierarchy blocked). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
MEMBER_LOOKUP_FAILED | A fresh Discord state, permission, hierarchy or scope check failed (member lookup failed). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
MEMBER_ROLE_HIERARCHY_BLOCKED | A fresh Discord state, permission, hierarchy or scope check failed (member role hierarchy blocked). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
MESSAGE_LOOKUP_FAILED | A fresh Discord state, permission, hierarchy or scope check failed (message lookup failed). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
MISSING_BOT_PERMISSION | A fresh Discord state, permission, hierarchy or scope check failed (missing bot permission). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
OWNER_LOOKUP_FAILED | A fresh Discord state, permission, hierarchy or scope check failed (owner lookup failed). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
OWNER_PROTECTED | The request would moderate or alter a protected server-owner target. | Choose a permissible target. This boundary is not bypassable through ARVN. | No |
PERMISSION_CHECK_FAILED | A fresh Discord state, permission, hierarchy or scope check failed (permission check failed). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
PERMISSION_ESCALATION_BLOCKED | A fresh Discord state, permission, hierarchy or scope check failed (permission escalation blocked). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
ROLE_HIERARCHY_BLOCKED | A fresh Discord state, permission, hierarchy or scope check failed (role hierarchy blocked). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
ROLE_LOOKUP_FAILED | A fresh Discord state, permission, hierarchy or scope check failed (role lookup failed). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
ROLE_NOT_IN_GUILD | A fresh Discord state, permission, hierarchy or scope check failed (role not in guild). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
SERVER_STATE_DRIFT | Relevant Discord state changed after the reviewed plan was prepared. | Inspect the live change, regenerate against current state and confirm the new plan. | After correction |
SERVER_STATE_UNAVAILABLE | A fresh Discord state, permission, hierarchy or scope check failed (server state unavailable). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
AI_EXISTING_PERMISSION_EDIT_FAILED | A fresh Discord state, permission, hierarchy or scope check failed (ai existing permission edit failed). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
EXISTING_PERMISSION_EDIT_INVALID_JSON | A fresh Discord state, permission, hierarchy or scope check failed (existing permission edit invalid json). | Re-read the live guild, target, bot rights and hierarchy. Correct the narrow cause, then prepare a fresh plan. | After correction |
Error family
Execution, replay and recovery
| Code | Meaning | Safe response | Retry |
|---|---|---|---|
CANCELLED | The executor could not safely continue, replay or recover the operation (cancelled). | Stop blind retries; inspect executionId, intent, results and live Discord state, then use supported recovery. | Operator only |
DEPENDENCY_CYCLE | The executor could not safely continue, replay or recover the operation (dependency cycle). | Stop blind retries; inspect executionId, intent, results and live Discord state, then use supported recovery. | Operator only |
DEPENDENCY_FAILED | The executor could not safely continue, replay or recover the operation (dependency failed). | Stop blind retries; inspect executionId, intent, results and live Discord state, then use supported recovery. | Operator only |
DRIFT_DETECTED | A target or precondition no longer matches the fresh execution-time read. | Do not force the old operation. Refresh context, review differences and prepare a new plan. | After correction |
EXECUTION_STEP_TIMEOUT | The executor could not safely continue, replay or recover the operation (execution step timeout). | Stop blind retries; inspect executionId, intent, results and live Discord state, then use supported recovery. | Operator only |
INVALID_CHECKPOINT | The executor could not safely continue, replay or recover the operation (invalid checkpoint). | Stop blind retries; inspect executionId, intent, results and live Discord state, then use supported recovery. | Operator only |
LEASE_LOST | The executor could not safely continue, replay or recover the operation (lease lost). | Stop blind retries; inspect executionId, intent, results and live Discord state, then use supported recovery. | Operator only |
LEASE_LOST_AFTER_EXTERNAL_MUTATION | Worker ownership was lost after Discord may already have received a mutation. | Stop blind retries and inspect durable intent, Discord state and execution history before reconciliation. | Operator only |
LEASE_OR_STEP_LOST | The executor could not safely continue, replay or recover the operation (lease or step lost). | Stop blind retries; inspect executionId, intent, results and live Discord state, then use supported recovery. | Operator only |
MISSING_DEPENDENCY | The executor could not safely continue, replay or recover the operation (missing dependency). | Stop blind retries; inspect executionId, intent, results and live Discord state, then use supported recovery. | Operator only |
MUTATION_INTENT_MISMATCH | The executor could not safely continue, replay or recover the operation (mutation intent mismatch). | Stop blind retries; inspect executionId, intent, results and live Discord state, then use supported recovery. | Operator only |
PRECONDITION_READ_FAILED | The executor could not safely continue, replay or recover the operation (precondition read failed). | Stop blind retries; inspect executionId, intent, results and live Discord state, then use supported recovery. | Operator only |
REPLAY_NOT_SUPPORTED | The executor could not safely continue, replay or recover the operation (replay not supported). | Stop blind retries; inspect executionId, intent, results and live Discord state, then use supported recovery. | Operator only |
REPLAY_VALIDATION_FAILED | The executor could not safely continue, replay or recover the operation (replay validation failed). | Stop blind retries; inspect executionId, intent, results and live Discord state, then use supported recovery. | Operator only |
REPLAY_VERIFICATION_FAILED | The executor could not safely continue, replay or recover the operation (replay verification failed). | Stop blind retries; inspect executionId, intent, results and live Discord state, then use supported recovery. | Operator only |
ARVN_MUTATION_INTENT_CHECKPOINT_FAILED | The executor could not safely continue, replay or recover the operation (arvn mutation intent checkpoint failed). | Stop blind retries; inspect executionId, intent, results and live Discord state, then use supported recovery. | Operator only |
Error family
Module operators and audits
| Code | Meaning | Safe response | Retry |
|---|---|---|---|
ANNOUNCEMENT_CONFIG_INVALID | A module draft, operator, preview or audit workflow could not complete (announcement config invalid). | Correct the draft validation or staleness issue and generate a fresh preview before applying. | After correction |
AUDIT_NOT_FOUND | A module draft, operator, preview or audit workflow could not complete (audit not found). | Correct the draft validation or staleness issue and generate a fresh preview before applying. | After correction |
AUDIT_RATE_LIMITED | A module draft, operator, preview or audit workflow could not complete (audit rate limited). | Correct the draft validation or staleness issue and generate a fresh preview before applying. | After correction |
COMMAND_CENTER_OPERATOR_APPLY_FAILED | A module draft, operator, preview or audit workflow could not complete (command center operator apply failed). | Correct the draft validation or staleness issue and generate a fresh preview before applying. | After correction |
CREATOR_NEXUS_CONFIG_INVALID | A module draft, operator, preview or audit workflow could not complete (creator nexus config invalid). | Correct the draft validation or staleness issue and generate a fresh preview before applying. | After correction |
DRAFT_ALREADY_APPLIED | A module draft, operator, preview or audit workflow could not complete (draft already applied). | Correct the draft validation or staleness issue and generate a fresh preview before applying. | After correction |
DRAFT_NOT_FOUND | A module draft, operator, preview or audit workflow could not complete (draft not found). | Correct the draft validation or staleness issue and generate a fresh preview before applying. | After correction |
DRAFT_NOT_READY | A module draft, operator, preview or audit workflow could not complete (draft not ready). | Correct the draft validation or staleness issue and generate a fresh preview before applying. | After correction |
DRAFT_STALE | A module draft, operator, preview or audit workflow could not complete (draft stale). | Correct the draft validation or staleness issue and generate a fresh preview before applying. | After correction |
DRY_RUN_FAILED | A module draft, operator, preview or audit workflow could not complete (dry run failed). | Correct the draft validation or staleness issue and generate a fresh preview before applying. | After correction |
DUPLICATE_MODULE_DRAFT | A module draft, operator, preview or audit workflow could not complete (duplicate module draft). | Correct the draft validation or staleness issue and generate a fresh preview before applying. | After correction |
FINDING_NOT_FOUND | A module draft, operator, preview or audit workflow could not complete (finding not found). | Correct the draft validation or staleness issue and generate a fresh preview before applying. | After correction |
GUARDIAN_CONFIG_INVALID | A module draft, operator, preview or audit workflow could not complete (guardian config invalid). | Correct the draft validation or staleness issue and generate a fresh preview before applying. | After correction |
MODULE_CONFIG_APPLY_ERROR | A module draft, operator, preview or audit workflow could not complete (module config apply error). | Correct the draft validation or staleness issue and generate a fresh preview before applying. | After correction |
MODULE_CONFIG_OPERATOR_APPLY_FAILED | A module draft, operator, preview or audit workflow could not complete (module config operator apply failed). | Correct the draft validation or staleness issue and generate a fresh preview before applying. | After correction |
MODULE_CONFIG_OPERATOR_REVERT_FAILED | A module draft, operator, preview or audit workflow could not complete (module config operator revert failed). | Correct the draft validation or staleness issue and generate a fresh preview before applying. | After correction |
NO_FINDINGS | A module draft, operator, preview or audit workflow could not complete (no findings). | Correct the draft validation or staleness issue and generate a fresh preview before applying. | After correction |
PRIVATE_SPACES_CONFIG_INVALID | A module draft, operator, preview or audit workflow could not complete (private spaces config invalid). | Correct the draft validation or staleness issue and generate a fresh preview before applying. | After correction |
PULSE_XP_CONFIG_INVALID | A module draft, operator, preview or audit workflow could not complete (pulse xp config invalid). | Correct the draft validation or staleness issue and generate a fresh preview before applying. | After correction |
WELCOME_CONFIG_INVALID | A module draft, operator, preview or audit workflow could not complete (welcome config invalid). | Correct the draft validation or staleness issue and generate a fresh preview before applying. | After correction |
AUDIT_REASON_REQUIRED | A module draft, operator, preview or audit workflow could not complete (audit reason required). | Correct the draft validation or staleness issue and generate a fresh preview before applying. | After correction |
MODULE_OPERATOR_NOT_FOUND | A module draft, operator, preview or audit workflow could not complete (module operator not found). | Correct the draft validation or staleness issue and generate a fresh preview before applying. | After correction |
Error family
Input and support boundaries
| Code | Meaning | Safe response | Retry |
|---|---|---|---|
ACTION_ALREADY_EXECUTED | The action tied to this message was already carried out for real before an edit or regenerate was attempted. | Do not rewind a message once its action has executed. Start a new request instead of editing history that already took effect. | No |
ACTIVE_SESSIONS_PER_SERVER_EXCEEDED | This server already holds the maximum number of active ARVN AI sessions. | Archive or delete an old session, or contact support to raise the server limit. No credits were charged. | After correction |
ACTIVE_SESSIONS_PER_USER_EXCEEDED | You already own the maximum number of active ARVN AI sessions across all servers. | Close an existing session or ask a server admin to raise your per-user limit. No credits were charged. | After correction |
AI_CONTEXT_TOO_LARGE | The current message and safely bounded conversation context do not fit within the provider prompt limit. | Start a fresh chat or divide the request into smaller steps. Do not truncate the current instruction or bypass the prompt boundary. | After correction |
AI_DYNAMIC_QUOTE_EXCEEDED | The final dynamically calculated credit charge exceeded the amount authorized by the reservation. | Do not charge past the authorization. Release or reconcile the reservation and retry only with a fresh quote and sufficient available credits. | After correction |
AI_SERVER_NOT_FOUND | A required input, reference, schema or supported-operation contract was not satisfied (ai server not found). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
AI_SESSION_NOT_FOUND | A required input, reference, schema or supported-operation contract was not satisfied (ai session not found). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
AI_TASK_BUDGET_EXHAUSTED | A required input, reference, schema or supported-operation contract was not satisfied (ai task budget exhausted). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
AI_TURN_DEADLINE_EXCEEDED | The complete ARVN turn exceeded its end-to-end time budget before finishing safely. | Shorten the request or try again when the server is less busy. Any reserved credits were released. | Usually |
BOT_IDENTITY_UNKNOWN | A required input, reference, schema or supported-operation contract was not satisfied (bot identity unknown). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
COMMAND_CENTER_APPLY_ERROR | A required input, reference, schema or supported-operation contract was not satisfied (command center apply error). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
COMMUNITY_SNAPSHOT_READ_FAILED | A required input, reference, schema or supported-operation contract was not satisfied (community snapshot read failed). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
DUPLICATE_OPERATION_ID | A required input, reference, schema or supported-operation contract was not satisfied (duplicate operation id). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
GUILD_BINDING_MISMATCH | A required input, reference, schema or supported-operation contract was not satisfied (guild binding mismatch). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
GUILD_NOT_FOUND | A required input, reference, schema or supported-operation contract was not satisfied (guild not found). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
INVALID_AUTOMOD_EXEMPTIONS | A required input, reference, schema or supported-operation contract was not satisfied (invalid automod exemptions). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
INVALID_AUTOMOD_KEYWORDS | A required input, reference, schema or supported-operation contract was not satisfied (invalid automod keywords). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
INVALID_INPUT | A required input, reference, schema or supported-operation contract was not satisfied (invalid input). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
INVALID_NAME | A required input, reference, schema or supported-operation contract was not satisfied (invalid name). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
INVALID_OPERATION | A required input, reference, schema or supported-operation contract was not satisfied (invalid operation). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
INVALID_PARENT_TYPE | A required input, reference, schema or supported-operation contract was not satisfied (invalid parent type). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
INVALID_PATCH | A required input, reference, schema or supported-operation contract was not satisfied (invalid patch). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
INVALID_REFERENCE | A required input, reference, schema or supported-operation contract was not satisfied (invalid reference). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
INVALID_SERVER_SETTINGS | A required input, reference, schema or supported-operation contract was not satisfied (invalid server settings). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
INVITE_NOT_FOUND | A required input, reference, schema or supported-operation contract was not satisfied (invite not found). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
KNOWLEDGE_LOCK_STALE | A required input, reference, schema or supported-operation contract was not satisfied (knowledge lock stale). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
MESSAGE_CONTENT_TOO_LONG | The message content exceeds the maximum supported length. | Split or shorten your message and try again. No credits were charged. | After correction |
MESSAGE_CREATE_RATE_LIMITED | Too many messages were stored in a short window for this server and user. | Wait for the rate-limit window to reset, then retry. No credits were charged. | Usually |
MESSAGES_PER_SESSION_EXCEEDED | This session has reached the maximum number of stored messages. | Start a new session or archive older messages. No credits were charged for this storage limit. | After correction |
METADATA_DEPTH_EXCEEDED | The provided metadata is nested more deeply than allowed. | Flatten the metadata structure and retry. No credits were charged. | After correction |
METADATA_JSON_TOO_LONG | The provided metadata JSON exceeds the maximum allowed size. | Reduce the metadata size and retry. No credits were charged. | After correction |
MISSING_CONTENT | A required input, reference, schema or supported-operation contract was not satisfied (missing content). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
MISSING_NAME | A required input, reference, schema or supported-operation contract was not satisfied (missing name). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
MISSING_PRECONDITION | A required input, reference, schema or supported-operation contract was not satisfied (missing precondition). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
MISSING_REFERENCE | A required input, reference, schema or supported-operation contract was not satisfied (missing reference). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
MISSING_RESOURCE | A required input, reference, schema or supported-operation contract was not satisfied (missing resource). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
NOT_LATEST_MESSAGE | Only the user's most recent message may be edited, and only the current assistant reply may be regenerated. | Refresh the conversation and act on the latest message only; earlier messages in the thread can no longer be edited or regenerated. | After correction |
NO_BOT_MESSAGE_FOUND | A required input, reference, schema or supported-operation contract was not satisfied (no bot message found). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
PARENT_NOT_FOUND | A required input, reference, schema or supported-operation contract was not satisfied (parent not found). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
REFERENCE_NOT_FOUND | A required input, reference, schema or supported-operation contract was not satisfied (reference not found). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
REFERENCE_UNRESOLVED | A required input, reference, schema or supported-operation contract was not satisfied (reference unresolved). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
RESOURCE_VALIDATION_FAILED | A required input, reference, schema or supported-operation contract was not satisfied (resource validation failed). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
ROLE_NOT_FOUND | A required input, reference, schema or supported-operation contract was not satisfied (role not found). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
SCHEMA_INVALID | A required input, reference, schema or supported-operation contract was not satisfied (schema invalid). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
SELF_MODERATION_BLOCKED | A required input, reference, schema or supported-operation contract was not satisfied (self moderation blocked). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
SERVER_NOT_FOUND | A required input, reference, schema or supported-operation contract was not satisfied (server not found). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
SERVER_SETTINGS_READ_FAILED | A required input, reference, schema or supported-operation contract was not satisfied (server settings read failed). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
STALE_CONFIG | A required input, reference, schema or supported-operation contract was not satisfied (stale config). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
TARGET_ALREADY_ABSENT | The target is absent without a matching durable deletion intent proving ARVN removed it. | Inspect current state. Treat absence as success only when the checkpoint proves ownership of the deletion. | After correction |
TARGET_NOT_A_MEMBER | A required input, reference, schema or supported-operation contract was not satisfied (target not a member). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
TARGET_NOT_FOUND | A required input, reference, schema or supported-operation contract was not satisfied (target not found). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
UNSUPPORTED_AUTOMOD_ACTION | A required input, reference, schema or supported-operation contract was not satisfied (unsupported automod action). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
UNSUPPORTED_AUTOMOD_RULE | A required input, reference, schema or supported-operation contract was not satisfied (unsupported automod rule). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
UNSUPPORTED_AUTOMOD_TRIGGER | A required input, reference, schema or supported-operation contract was not satisfied (unsupported automod trigger). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
UNSUPPORTED_DOMAIN | A required input, reference, schema or supported-operation contract was not satisfied (unsupported domain). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
UNSUPPORTED_MODULE | A required input, reference, schema or supported-operation contract was not satisfied (unsupported module). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
UNSUPPORTED_OPERATION | A required input, reference, schema or supported-operation contract was not satisfied (unsupported operation). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
UNSUPPORTED_RESOURCE_TYPE | A required input, reference, schema or supported-operation contract was not satisfied (unsupported resource type). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
UNSUPPORTED_SCHEMA_VERSION | A required input, reference, schema or supported-operation contract was not satisfied (unsupported schema version). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
UNSUPPORTED_TARGET | A required input, reference, schema or supported-operation contract was not satisfied (unsupported target). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
ACTIVE_TASK_EXISTS | A required input, reference, schema or supported-operation contract was not satisfied (active task exists). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
ACTIVE_TASK_NOT_FOUND | A required input, reference, schema or supported-operation contract was not satisfied (active task not found). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
AI_AUTOMOD_EDIT_FAILED | A required input, reference, schema or supported-operation contract was not satisfied (ai automod edit failed). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
AI_CHANNEL_CREATE_PILOT_FAILED | A required input, reference, schema or supported-operation contract was not satisfied (ai channel create pilot failed). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
AI_CHANNEL_CREATE_PILOT_REVISION_BLOCKED | A required input, reference, schema or supported-operation contract was not satisfied (ai channel create pilot revision blocked). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
AI_COMMUNITY_MODE_FAILED | A required input, reference, schema or supported-operation contract was not satisfied (ai community mode failed). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
AI_EXISTING_RESOURCE_DELETE_FAILED | A required input, reference, schema or supported-operation contract was not satisfied (ai existing resource delete failed). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
AI_EXISTING_RESOURCE_EDIT_FAILED | A required input, reference, schema or supported-operation contract was not satisfied (ai existing resource edit failed). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
AI_EXISTING_ROLE_EDIT_FAILED | A required input, reference, schema or supported-operation contract was not satisfied (ai existing role edit failed). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
AI_EXTENDED_RESOURCE_CREATE_FAILED | A required input, reference, schema or supported-operation contract was not satisfied (ai extended resource create failed). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
AI_INVITE_REVOKE_FAILED | A required input, reference, schema or supported-operation contract was not satisfied (ai invite revoke failed). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
AI_MEMBER_MODERATION_FAILED | A required input, reference, schema or supported-operation contract was not satisfied (ai member moderation failed). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
AI_MEMBER_ROLE_CHANGE_FAILED | A required input, reference, schema or supported-operation contract was not satisfied (ai member role change failed). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
AI_MEMBER_VOICE_STATE_FAILED | A required input, reference, schema or supported-operation contract was not satisfied (ai member voice state failed). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
AI_MESSAGE_BULK_DELETE_FAILED | A required input, reference, schema or supported-operation contract was not satisfied (ai message bulk delete failed). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
AI_MESSAGE_DELETE_FAILED | A required input, reference, schema or supported-operation contract was not satisfied (ai message delete failed). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
AI_MESSAGE_SEND_FAILED | A required input, reference, schema or supported-operation contract was not satisfied (ai message send failed). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
AI_SERVER_BLUEPRINT_FAILED | A required input, reference, schema or supported-operation contract was not satisfied (ai server blueprint failed). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
AI_SERVER_SETTINGS_UPDATE_FAILED | A required input, reference, schema or supported-operation contract was not satisfied (ai server settings update failed). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
AUTOMOD_CREATE_ROUTE_BINDING_MISMATCH | A required input, reference, schema or supported-operation contract was not satisfied (automod create route binding mismatch). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
AUTOMOD_EDIT_ROUTE_BINDING_MISMATCH | A required input, reference, schema or supported-operation contract was not satisfied (automod edit route binding mismatch). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
COMMUNITY_MODE_ROUTE_BINDING_MISMATCH | A required input, reference, schema or supported-operation contract was not satisfied (community mode route binding mismatch). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
CONVERSATION_ACCESS_DENIED | A required input, reference, schema or supported-operation contract was not satisfied (conversation access denied). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
CONVERSATION_NOT_FOUND | A required input, reference, schema or supported-operation contract was not satisfied (conversation not found). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
CONVERSATION_STATE_CONFLICT | A required input, reference, schema or supported-operation contract was not satisfied (conversation state conflict). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
EXISTING_RESOURCE_DELETE_INVALID_JSON | A required input, reference, schema or supported-operation contract was not satisfied (existing resource delete invalid json). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
INVITE_REVOKE_ROUTE_BINDING_MISMATCH | A required input, reference, schema or supported-operation contract was not satisfied (invite revoke route binding mismatch). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
MEMBER_MODERATION_ROUTE_BINDING_MISMATCH | A required input, reference, schema or supported-operation contract was not satisfied (member moderation route binding mismatch). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
MEMBER_ROLE_CHANGE_ROUTE_BINDING_MISMATCH | A required input, reference, schema or supported-operation contract was not satisfied (member role change route binding mismatch). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
MEMBER_VOICE_STATE_ROUTE_BINDING_MISMATCH | A required input, reference, schema or supported-operation contract was not satisfied (member voice state route binding mismatch). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
MESSAGE_BULK_DELETE_ROUTE_BINDING_MISMATCH | A required input, reference, schema or supported-operation contract was not satisfied (message bulk delete route binding mismatch). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
MESSAGE_DELETE_ROUTE_BINDING_MISMATCH | A required input, reference, schema or supported-operation contract was not satisfied (message delete route binding mismatch). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
MESSAGE_SEND_ROUTE_BINDING_MISMATCH | A required input, reference, schema or supported-operation contract was not satisfied (message send route binding mismatch). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
MODULE_PROPOSAL_ACCESS_DENIED | A required input, reference, schema or supported-operation contract was not satisfied (module proposal access denied). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
NOT_FOUND | A required input, reference, schema or supported-operation contract was not satisfied (not found). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
NO_STREAM_OUTPUT | A required input, reference, schema or supported-operation contract was not satisfied (no stream output). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
PLANNING_ACTIVE_TASK_MISMATCH | A required input, reference, schema or supported-operation contract was not satisfied (planning active task mismatch). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
PLANNING_ARTIFACT_BINDING_FAILED | A required input, reference, schema or supported-operation contract was not satisfied (planning artifact binding failed). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
PLANNING_ARTIFACTS_NOT_FOUND | A required input, reference, schema or supported-operation contract was not satisfied (planning artifacts not found). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
PLANNING_PLAN_ID_MISMATCH | A required input, reference, schema or supported-operation contract was not satisfied (planning plan id mismatch). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
PLANNING_PLAN_REVISION_MISMATCH | A required input, reference, schema or supported-operation contract was not satisfied (planning plan revision mismatch). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
PLANNING_SESSION_MISMATCH | A required input, reference, schema or supported-operation contract was not satisfied (planning session mismatch). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
RESOLUTION_CONFLICT | A required input, reference, schema or supported-operation contract was not satisfied (resolution conflict). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
SCHEDULED_EVENT_CREATE_ROUTE_BINDING_MISMATCH | A required input, reference, schema or supported-operation contract was not satisfied (scheduled event create route binding mismatch). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
SERVER_SETTINGS_EMPTY_UPDATE | A required input, reference, schema or supported-operation contract was not satisfied (server settings empty update). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
SERVER_SETTINGS_GUILD_BINDING_UNAVAILABLE | A required input, reference, schema or supported-operation contract was not satisfied (server settings guild binding unavailable). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
THREAD_CREATE_ROUTE_BINDING_MISMATCH | A required input, reference, schema or supported-operation contract was not satisfied (thread create route binding mismatch). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
WEBHOOK_CREATE_ROUTE_BINDING_MISMATCH | A required input, reference, schema or supported-operation contract was not satisfied (webhook create route binding mismatch). | Correct the named input or unsupported shape and create a new plan. Never invent or silently drop fields. | After correction |
Dynamic families
Codes generated from bounded status
HTTP_<status>The client received a non-success HTTP response without a more specific safe ARVN code.
Response: Record status, route and timestamp; inspect the safe server response.
DRAFT_<status>A module draft exposed its persisted lifecycle status as the blocker.
Response: Open the latest draft and resolve its missing, stale, not-ready or terminal state.
Provider/operator validation codeA closed provider or module operator returned a registered validation code through a pass-through contract.
Response: Use the safe message and module findings; never expose raw provider text.
Still cannot identify the cause?
Preserve the safe code, timestamp, server/session context and executionId when available. Do not share bot tokens, API keys, nonces, raw provider messages or database dumps. Return to the diagnostic sequence before escalating.