Enum ProviderError 

pub enum ProviderError {
    Api(String),
    Network(String),
    Auth(String),
    RateLimited {
        retry_after_ms: Option<u64>,
    },
    ContextOverflow {
        message: String,
    },
    Cancelled,
    Other(String),
    SchemaMismatch {
        reason: String,
    },
}

Variants

Api(String)

A non-transient API error (bad request, server error, etc.).

Network(String)

Network/transport failure — connection refused, timeout, TLS error, etc.

Auth(String)

Authentication failure — bad or missing API key (HTTP 401/403).

RateLimited

Rate limit hit (HTTP 429). retry_after_ms is the server-specified delay if present.

Fields

retry_after_ms: Option<u64>

ContextOverflow

Input exceeds the model’s context window. Caller should compact and retry.

Fields

message: String

Cancelled

The caller cancelled the request via CancellationToken.

Other(String)

Catch-all for errors that don’t fit another category.

SchemaMismatch

Returned by structured-output paths when the requested ResponseFormat is unsupported by the provider, or when extracting JSON from a response fails (Message::extract_json::<T>() returns this on parse / deserialise errors).

Fields

reason: String

Implementations

impl ProviderError

pub fn is_retryable(&self) -> bool

Whether this error is safe to retry.

Retryable: rate limits (429) and network/transient errors. Not retryable: auth errors, API errors (bad request), cancellation.

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

If this is a rate limit with a server-specified retry delay, return it.

impl ProviderError

pub fn classify(status: u16, message: &str) -> Self

Classify an HTTP error response into the appropriate error variant.

Detects context overflow, rate limits, auth errors, and general API errors from the HTTP status code and response body.

pub fn is_context_overflow(&self) -> bool

Returns true if this error indicates a context overflow.

Trait Implementations

impl Debug for ProviderError

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

Formats the value using the given formatter.

impl Display for ProviderError

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

Formats the value using the given formatter.

impl Error for ProviderError

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.