Enum ErrorCode 

#[non_exhaustive]
pub enum ErrorCode {
    TypesInvalidId,
    TypesValidation,
    TypesSerde,
    ToolNotFound,
    ToolInvalidArgs,
    ToolExecution,
    ToolTimeout,
    ToolCancelled,
    ToolDenied,
    ToolApprovalDenied,
    ToolStreamProtocol,
    ToolRateLimited,
    ToolConcurrencyLimit,
    ToolNetwork,
    ToolServiceUnavailable,
    LlmProvider,
    LlmCancelled,
    LlmInvalidResponse,
    LlmAuth,
    LlmRateLimit,
    LlmIdleTimeout,
    LlmEmptyResponse,
    LlmTruncated,
    AgentInvalidDefinition,
    AgentBuild,
    AgentNotFound,
    RuntimeMaxSteps,
    RuntimeCancelled,
    RuntimeGate,
    RuntimeStructuredOutput,
    RuntimeDeadline,
    RuntimeStationarity,
    HostSpawn,
    HostBudget,
    HostDepth,
    HostConcurrency,
    HostUnsupported,
    HostCancelled,
    HostIsolation,
    WorkflowScript,
    WorkflowDivergence,
    WorkflowJournal,
    WorkflowBudget,
    WorkflowCancelled,
    WorkflowValidate,
    StateInvariant,
    StatePersistence,
    CompactionFailed,
    CompactionOverflow,
    Internal,
}

Machine-stable error code for control-plane handling.

Codes use dotted domain.reason strings via ErrorCode::as_str.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

TypesInvalidId

Invalid or empty identifier.

TypesValidation

Message or payload failed validation.

TypesSerde

Serialization failure.

ToolNotFound

Tool not found in registry.

ToolInvalidArgs

Tool arguments failed schema/parse.

ToolExecution

Tool execution failed.

ToolTimeout

Tool timed out.

ToolCancelled

Tool cancelled.

ToolDenied

Tool denied by policy/capability.

ToolApprovalDenied

Tool call rejected by approval gate.

ToolStreamProtocol

Tool stream ended without a terminal item (protocol violation).

ToolRateLimited

Tool rate limited by upstream service.

ToolConcurrencyLimit

Tool concurrency limit exceeded.

ToolNetwork

Tool network failure.

ToolServiceUnavailable

Tool upstream service unavailable.

LlmProvider

LLM transport or provider failure.

LlmCancelled

LLM request cancelled.

LlmInvalidResponse

LLM response invalid.

LlmAuth

LLM authentication / authorization failure.

LlmRateLimit

LLM rate limited.

LlmIdleTimeout

Stream/sample idle timeout between chunks.

LlmEmptyResponse

Provider returned an empty completion (no text / tool calls).

LlmTruncated

Output truncated (max tokens / length limit).

AgentInvalidDefinition

Agent definition invalid.

AgentBuild

Agent build failure.

AgentNotFound

Agent type / definition not found for resolution.

RuntimeMaxSteps

Turn hit max steps.

RuntimeCancelled

Turn cancelled.

RuntimeGate

Runtime gate rejected the outcome.

RuntimeStructuredOutput

Structured output failed schema validation after retries.

RuntimeDeadline

Turn deadline exceeded.

RuntimeStationarity

Identical tool calls repeated past the stationarity hard stop.

HostSpawn

Host spawn failed.

HostBudget

Agent budget exhausted.

HostDepth

Nested spawn depth exceeded.

HostConcurrency

Concurrent nested agent cap exceeded.

HostUnsupported

Host capability unsupported.

HostCancelled

Host cancelled.

HostIsolation

Isolation backend failure.

WorkflowScript

Workflow script compile/runtime failure.

WorkflowDivergence

Journal divergence on resume.

WorkflowJournal

Journal I/O or integrity failure.

WorkflowBudget

Workflow agent budget exceeded.

WorkflowCancelled

Workflow cancelled.

WorkflowValidate

Workflow validation / probe failure.

StateInvariant

Conversation state invariant violated (e.g. dangling tool call).

StatePersistence

Persistence backend I/O failure.

CompactionFailed

Compaction strategy failed.

CompactionOverflow

Context still exceeds limits after compaction.

Internal

Generic internal failure.

Implementations

impl ErrorCode

pub const fn as_str(self) -> &'static str

Stable snake_case dotted code string.

pub const fn domain(self) -> &'static str

Domain prefix (types, tool, llm, …).

pub const fn default_retry(self) -> RetryClass

Default retry classification for this code.

Kernel paths set an explicit RetryClass when they know more; this is the baseline hosts may consult.

Trait Implementations

impl Clone for ErrorCode

fn clone(&self) -> ErrorCode

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ErrorCode

impl Debug for ErrorCode

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ErrorCode

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ErrorCode

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for ErrorCode

impl Hash for ErrorCode

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ErrorCode

fn eq(&self, other: &ErrorCode) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ErrorCode

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ErrorCode