Enum Error 

pub enum Error {
    Provider {
        message: String,
        status_code: Option<u16>,
    },
    ToolExecution {
        tool_name: String,
        message: String,
    },
    Memory(String),
    Config(String),
    Runtime(String),
    Serialization(Error),
    Io(Error),
}

Errors that can occur during agent operation.

Variants

Provider

Error from the LLM provider.

Fields

message: String

Error message from the provider.

status_code: Option<u16>

Optional HTTP status code (for retry classification).

ToolExecution

Error during tool execution.

Fields

tool_name: String

Name of the tool that failed.

message: String

Error message describing the failure.

Memory(String)

Error from the memory system.

Config(String)

Configuration error (e.g., missing required fields).

Runtime(String)

Runtime error during agent loop execution.

Serialization(Error)

Serialization/deserialization error.

Io(Error)

IO error.

Implementations

impl Error

pub fn provider(message: impl Display) -> Self

Create a provider error.

pub fn provider_with_status(message: impl Display, status_code: u16) -> Self

Create a provider error with an HTTP status code.

pub fn tool_execution(tool_name: impl Display, message: impl Display) -> Self

Create a tool execution error.

pub fn is_retryable(&self) -> bool

Check whether this error is safe to retry.

Returns true for transient provider errors (429, 500, 502, 503, 504) and provider errors without a status code (e.g., timeouts).

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.