Enum ProviderError 

pub enum ProviderError {
    RateLimit {
        retry_after: Option<Duration>,
    },
    Overloaded,
    ServerError,
    Auth,
    Billing,
    ContextOverflow,
    Invalid(String),
    Transport,
}

Why a provider call failed, coarsely enough to decide policy per class.

Classification is by status and by message text, because the text is sometimes the only signal — no backend gives context overflow a usable code, which is the lesson is_context_overflow already encodes.

Variants

RateLimit

HTTP 429 — Retry-After is honoured when it is sane; a provider can name a wait long enough that the process is simply asleep.

Fields

retry_after: Option<Duration>

Overloaded

The provider says it is drowning (529, or a 503 that says so).

ServerError

Any other 5xx.

Auth

401/403 — terminal; the same key fails the same way every time.

Billing

Credit exhausted — terminal, and retrying it spends nothing but time.

ContextOverflow

The prompt does not fit. Never retried here: the compaction path in the loop owns this one, and a retry with the same payload cannot fit any better.

Invalid(String)

Any other 4xx — the same payload fails the same way.

Transport

Connect failures, timeouts, aborted writes. The pooled-connection race lands here.

Implementations

impl ProviderError

pub fn transient(&self) -> bool

Whether another identical request could plausibly succeed. This is also what the failover wrapper keys on: an error without this property fails the same way on every provider (Invalid, ContextOverflow) or must not be retried at all.

Trait Implementations

impl Clone for ProviderError

fn clone(&self) -> ProviderError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

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, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for ProviderError

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.

impl PartialEq for ProviderError

fn eq(&self, other: &ProviderError) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ProviderError