Enum AgentError 

pub enum AgentError {
    SessionNotFound(String),
    LLM(String),
    LLMOverflow(String),
    StreamTimeout(String),
    Tool(String),
    HookSuspended(String),
    Budget(String),
    Cancelled,
    WorkerUnresponsive(String),
}

Errors that can occur during agent operations

Variants

SessionNotFound(String)

Session with the specified ID was not found

LLM(String)

Error from LLM provider (API error, network error, etc.)

LLMOverflow(String)

LLM request exceeded provider context/input limits and requires host-side overflow recovery before retry.

StreamTimeout(String)

An LLM stream watchdog expired. The attached diagnostic identifies whether transport liveness, first semantic output, or midstream semantic progress stalled. Kept distinct from LLM so generic retry logic cannot replay partial output or tool-call state (#618).

Tool(String)

Error during tool execution

HookSuspended(String)

A lifecycle hook deliberately suspended this activation. The outer runner converts this control signal into a normal persisted suspension.

Budget(String)

Token budget exceeded error

Cancelled

Agent execution was cancelled by user

WorkerUnresponsive(String)

An actor child worker produced no first frame within the deadline — it is presumed dead (e.g. a pooled worker that exited after its liveness check but before handling the Run). Signals the runner to reap it and retry on a fresh worker, rather than waiting forever on a queued Run nobody serves.

Implementations

impl AgentError

pub fn is_cancelled(&self) -> bool

Returns true if this error represents a user-initiated cancellation.

Prefer this over substring-matching the error message: a reworded or localized message must not silently break cancellation/terminal-status logic.

pub fn is_hook_suspended(&self) -> bool

Returns true when a lifecycle hook intentionally suspended the run.

Trait Implementations

impl Debug for AgentError

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

Formats the value using the given formatter.

impl Display for AgentError

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

Formats the value using the given formatter.

impl Error for AgentError

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.