Enum RuntimeError 

pub enum RuntimeError {
    ProviderNotFound(String),
    SessionNotFound(Uuid),
    RunNotFound(RunId),
    InvalidRunState {
        expected: String,
        actual: String,
    },
    IterationLimitExceeded(usize),
    TokenBudgetExceeded {
        used: usize,
        limit: usize,
    },
    ContextOverflow {
        context: u32,
        estimated: usize,
    },
    SessionBusy(Uuid),
    ToolTimeout {
        tool: String,
    },
    Provider(ProviderError),
    Context(ContextError),
    Storage(StorageError),
    Tool(ToolError),
    RecoveryFailed(String),
    DoomLoopDetected {
        description: String,
    },
    InputRejected {
        input_id: InputId,
        reason: String,
    },
    InputAdmissionFailed(String),
}

Errors that can occur during runtime execution.

Covers provider resolution, session management, run lifecycle, policy enforcement, tool execution, storage, snapshot recovery, doom-loop detection, and input admission failures.

Variants

ProviderNotFound(String)

The requested provider was not found in the registry.

SessionNotFound(Uuid)

The requested session does not exist.

RunNotFound(RunId)

The requested run was not found.

InvalidRunState

Operation cannot proceed because the run is in an unexpected state.

Fields

expected: String

Expected state descriptor.

actual: String

Actual state descriptor.

IterationLimitExceeded(usize)

The run exceeded the maximum allowed model call iterations.

TokenBudgetExceeded

Accumulated token usage exceeded the configured budget.

Fields

used: usize

Tokens consumed so far.

limit: usize

Maximum allowed tokens.

ContextOverflow

Estimated context size exceeds the model’s maximum context window.

Fields

context: u32

Model’s maximum context window size.

estimated: usize

Estimated token usage for the full context.

SessionBusy(Uuid)

Session is locked by another concurrent run.

ToolTimeout

A tool call exceeded its configured execution timeout.

Fields

tool: String

Name of the timed-out tool.

Provider(ProviderError)

An error propagated from the provider layer.

Context(ContextError)

An error propagated from the context layer.

Storage(StorageError)

An error propagated from the storage layer.

Tool(ToolError)

An error propagated from the tool layer.

RecoveryFailed(String)

Snapshot persistence or recovery failed.

DoomLoopDetected

Doom loop detected — agent is stuck in a repetitive tool call pattern.

Fields

description: String

Human-readable description of the detected pattern.

InputRejected

Input was rejected by the admission pipeline.

Fields

input_id: InputId

Identifier of the rejected input.

reason: String

Reason for rejection.

InputAdmissionFailed(String)

Internal error during input admission processing.

Trait Implementations

impl Debug for RuntimeError

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

Formats the value using the given formatter.

impl Display for RuntimeError

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

Formats the value using the given formatter.

impl Error for RuntimeError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<ContextError> for RuntimeError

fn from(source: ContextError) -> RuntimeError

Converts to this type from the input type.

impl From<ProviderError> for RuntimeError

fn from(source: ProviderError) -> RuntimeError

Converts to this type from the input type.

impl From<RuntimeError> for InvocationError

fn from(source: RuntimeError) -> InvocationError

Converts to this type from the input type.

impl From<StorageError> for RuntimeError

fn from(source: StorageError) -> RuntimeError

Converts to this type from the input type.

impl From<ToolError> for RuntimeError

fn from(source: ToolError) -> RuntimeError

Converts to this type from the input type.