Enum ProviderError 

pub enum ProviderError {
    Transport(String),
    RateLimited {
        retry_after: Option<Duration>,
    },
    Api {
        status: u16,
        message: String,
    },
    ContextOverflow,
    Quota,
    Auth(String),
    Decode(String),
    Config(String),
}

Why a model call failed (ADR-0007).

An exhaustive taxonomy (not #[non_exhaustive]): like Grok’s SamplingError and Codex’s CodexErr, ProviderError::retryable matches every variant with no wildcard, so a new error cannot be added without classifying it. Distinct terminal variants (context overflow, quota, auth) follow Codex; the general ProviderError::Api is the escape hatch for unclassified HTTP statuses.

Variants

Transport(String)

A transport/network failure (connection reset, DNS, TLS). Retryable.

RateLimited

Rate limited (HTTP 429). Surfaced, not silently hammered; a bounded retry honors retry_after when present.

Fields

retry_after: Option<Duration>

The server-requested delay before retrying, if given (Retry-After).

Api

A general API error carrying the HTTP status; retryable iff 5xx/overloaded.

Fields

status: u16

The HTTP status code.

message: String

The error message from the response body.

ContextOverflow

The request exceeded the model’s context window. Terminal.

Quota

The account’s quota/usage limit is exhausted. Terminal.

Auth(String)

Authentication failed (e.g. 401 after a refresh attempt). Terminal here; refresh-and-retry-once is the wire’s job before surfacing this.

Decode(String)

The response could not be parsed into a Completion. Terminal.

Config(String)

The request configuration is invalid for this wire (e.g. an unknown reasoning-effort tier on a fixed-mapping wire). Terminal, pre-send.

Implementations

impl ProviderError

pub fn retryable(&self) -> bool

Whether the loop/transport should retry this error (vs treat it as terminal).

Api is retryable for any 5xx plus 408/409 — Claude Code’s retryable set (Task-12 plan §4.6); everything 4xx-terminal stays terminal.

Trait Implementations

impl Debug for ProviderError

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

Formats the value using the given formatter.

impl Display for ProviderError

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

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.