Enum AgentError 

pub enum AgentError {
    Tool {
        tool_name: String,
        message: String,
    },
    Stream(String),
    State(String),
    Config(String),
    Model {
        model_id: String,
        message: String,
    },
    MaxIterations {
        iterations: usize,
    },
    RateLimited {
        retry_after_secs: u64,
    },
    RetriesExhausted {
        attempts: usize,
        last_error: String,
    },
    FallbackFailed {
        primary_model: String,
        primary_error: String,
        fallback_model: String,
        fallback_error: String,
    },
}

Agent-specific errors

Variants

Tool

Error originating from a tool.

Fields

tool_name: String

Name of the tool that failed.

message: String

Human-readable error message.

Stream(String)

Stream / provider communication error

State(String)

State management error

Config(String)

Configuration error

Model

Model not found or unavailable.

Fields

model_id: String

Identifier of the model.

message: String

Error detail.

MaxIterations

Maximum iterations reached.

Fields

iterations: usize

Number of iterations that were executed.

RateLimited

Rate limited – retry after N seconds.

Fields

retry_after_secs: u64

Seconds to wait before retrying.

RetriesExhausted

A retriable error that failed after exhausting retries.

Fields

attempts: usize

Number of retry attempts made.

last_error: String

Error from the final attempt.

FallbackFailed

Fallback failed – both primary and fallback model errored

Fields

primary_model: String

Name of the primary model.

primary_error: String

Error from the primary model.

fallback_model: String

Name of the fallback model.

fallback_error: String

Error from the fallback model.

Implementations

impl AgentError

pub fn is_retryable(&self) -> bool

Check if this error is retryable.

pub fn user_friendly(&self) -> String

Produce a short, user-friendly message suitable for TUI display.

Trait Implementations

impl Debug for AgentError

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

Formats the value using the given formatter.

impl Display for AgentError

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

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.

impl From<Error> for AgentError

fn from(err: Error) -> Self

Converts to this type from the input type.