Enum CoreError 

pub enum CoreError {
    UnknownTool(String),
    ToolInputValidation(String),
    ToolOutput(String),
    ModelProvider(String),
    ModelResponse(String),
    Transport(String),
    Cancelled(String),
    TurnTimeout {
        ms: u64,
    },
}

Errors raised by the core agent/model layer.

Variants

UnknownTool(String)

A tool call referenced an unknown tool.

ToolInputValidation(String)

Tool input failed JSON-schema validation.

ToolOutput(String)

Tool output failed to serialize or validate.

ModelProvider(String)

The model provider rejected the request.

ModelResponse(String)

The model response could not be parsed.

Transport(String)

An I/O or transport error talking to a provider.

Cancelled(String)

A caller cancelled the operation (e.g. SIGINT, token triggered).

Distinct from CoreError::TurnTimeout: a caller-initiated abort, not a deadline elapsing. Keeping the two separate lets the CLI map a turn-budget timeout to exit code 124 without string-matching the message (the headless runner contract distinguishes them).

TurnTimeout

A per-turn deadline elapsed (the agent loop’s turn_timeout_ms).

Mapped to exit code 124 by the CLI headless runner (matching the timeout(1) convention used by the bash tool). This is a deadline event, not caller-initiated cancellation — see CoreError::Cancelled.

Fields

ms: u64

The per-turn deadline that was exceeded, in milliseconds.

Trait Implementations

impl Debug for CoreError

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

Formats the value using the given formatter.

impl Display for CoreError

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

Formats the value using the given formatter.

impl Error for CoreError

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.