Enum Error 

pub enum Error {
    Api {
        message: String,
        error_type: String,
        code: Option<String>,
    },
    ServerError {
        message: String,
        request_id: Option<String>,
        retry_suggested: bool,
        user_message: String,
    },
    BadGateway {
        retry_after: Option<u64>,
        status_code: u16,
    },
    ServiceUnavailable {
        retry_after: Option<u64>,
        retry_message: String,
    },
    GatewayTimeout {
        retry_after: Option<u64>,
    },
    RateLimited {
        retry_after: Option<u64>,
        retry_message: String,
        limit_type: Option<String>,
    },
    AuthenticationFailed {
        message: String,
        suggestion: String,
    },
    AuthorizationFailed {
        message: String,
        suggestion: String,
    },
    ClientError {
        message: String,
        status_code: u16,
        field: Option<String>,
        suggestion: Option<String>,
    },
    ContainerExpired {
        message: String,
        auto_handled: bool,
    },
    Http(Error),
    HttpStatus(StatusCode),
    Json(Error),
    Stream(String),
    InvalidApiKey,
    ApiKeyNotFound,
    ContextRecovery(String),
    MaxRetriesExceeded {
        attempts: u32,
    },
}

Error type for the crate

Variants

Api

API error

Fields

message: String

Error message

error_type: String

Error type

code: Option<String>

Error code

ServerError

Server error (500 Internal Server Error)

Fields

message: String

Error message

request_id: Option<String>

Request ID for debugging

retry_suggested: bool

Whether retry is suggested

user_message: String

User-friendly message

BadGateway

Bad Gateway error (502)

Fields

retry_after: Option<u64>

When to retry (seconds from now)

status_code: u16

Original status code

ServiceUnavailable

Service Unavailable error (503)

Fields

retry_after: Option<u64>

When to retry (seconds from now)

retry_message: String

Formatted retry message

GatewayTimeout

Gateway Timeout error (504)

Fields

retry_after: Option<u64>

When to retry (seconds from now)

RateLimited

Rate limiting error (429)

Fields

retry_after: Option<u64>

When the rate limit resets

retry_message: String

Formatted retry message

limit_type: Option<String>

Rate limit type (requests, tokens, etc.)

AuthenticationFailed

Authentication error (401)

Fields

message: String

Error message

suggestion: String

Suggested action for user

AuthorizationFailed

Authorization error (403)

Fields

message: String

Error message

suggestion: String

Suggested action for user

ClientError

Client error (400, 422)

Fields

message: String

Error message

status_code: u16

HTTP status code

field: Option<String>

Field that caused the error (if available)

suggestion: Option<String>

Suggested fix

ContainerExpired

Container expired error (special case of API error)

Fields

message: String

Error message

auto_handled: bool

Whether this error was automatically handled

Http(Error)

HTTP error

HttpStatus(StatusCode)

HTTP status error (fallback for unhandled status codes)

Json(Error)

JSON error

Stream(String)

Stream error

InvalidApiKey

Invalid API key

ApiKeyNotFound

API key not found in environment

ContextRecovery(String)

Context recovery error

MaxRetriesExceeded

Maximum retry attempts exceeded

Fields

attempts: u32

Implementations

impl Error

pub fn is_container_expired(&self) -> bool

Returns true if this error indicates a container has expired

pub fn is_recoverable(&self) -> bool

Returns true if this error can be automatically recovered from

pub fn is_transient(&self) -> bool

Returns true if this is a transient error that should be retried

pub fn retry_after(&self) -> Option<u64>

Returns the suggested retry delay in seconds

pub fn user_message(&self) -> String

Returns a user-friendly error message

pub fn container_expired(message: impl Into<String>, auto_handled: bool) -> Self

Creates a container expired error

pub fn server_error( message: impl Into<String>, request_id: Option<String>, retry_suggested: bool, ) -> Self

Creates a server error with retry suggestion

pub fn bad_gateway(retry_after: Option<u64>) -> Self

Creates a bad gateway error

pub fn service_unavailable(retry_after: Option<u64>) -> Self

Creates a service unavailable error

pub fn gateway_timeout(retry_after: Option<u64>) -> Self

Creates a gateway timeout error

pub fn rate_limited( retry_after: Option<u64>, limit_type: Option<String>, ) -> Self

Creates a rate limited error

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.