Enum ProviderErrorKind 

pub enum ProviderErrorKind {
    AuthMissing {
        var_hint: Option<String>,
    },
    AuthMalformed {
        hint: Option<String>,
    },
    AuthRejected {
        hint: Option<String>,
    },
    AuthExpired,
    RateLimit {
        retry_after: Option<Duration>,
        scope: RateLimitScope,
    },
    QuotaExceeded {
        hint: Option<String>,
    },
    ContextOverflow {
        used: Option<u64>,
        limit: Option<u64>,
    },
    MaxTokensInvalid {
        requested: Option<u64>,
        limit: Option<u64>,
    },
    ModelNotFound {
        model: String,
    },
    BadRequest {
        hint: Option<String>,
    },
    InvalidToolSchema {
        tool: String,
        hint: Option<String>,
    },
    InputBlocked {
        policy: Option<String>,
    },
    OutputBlocked {
        policy: Option<String>,
    },
    ServerError {
        status: Option<u16>,
        hint: Option<String>,
    },
    ServerStreamAborted {
        hint: Option<String>,
    },
    Malformed(BoxError),
    ProtocolViolation {
        hint: String,
    },
    Transport(BoxError),
    Timeout {
        phase: TimeoutPhase,
    },
    Canceled,
    Other(BoxError),
}

Semantic classification of provider errors.

Fallback principle: if a category of errors repeatedly falls into ProviderErrorKind::Other, prefer to extract it as a new variant rather than letting Other become the default.

Variants

AuthMissing

Missing credential.

Fields

var_hint: Option<String>

AuthMalformed

Malformed credential.

Fields

hint: Option<String>

AuthRejected

Credential rejected by the server (401).

Fields

hint: Option<String>

AuthExpired

OAuth/STS token expired.

RateLimit

Request-level rate limiting.

Fields

retry_after: Option<Duration>

scope: RateLimitScope

QuotaExceeded

Quota exhausted / monthly allowance depleted.

Fields

hint: Option<String>

ContextOverflow

Context window overflow.

Fields

used: Option<u64>

limit: Option<u64>

MaxTokensInvalid

The requested max_tokens exceeds the model’s limit or was rejected by the server.

Fields

requested: Option<u64>

limit: Option<u64>

ModelNotFound

Model ID does not exist or is unavailable.

Fields

model: String

BadRequest

Request body rejected by the wire service validation (schema error, conflicting mutually exclusive fields).

Fields

hint: Option<String>

InvalidToolSchema

The tool schema referenced in the request was rejected by the server.

Fields

tool: String

hint: Option<String>

InputBlocked

Input triggered a safety filter.

Fields

policy: Option<String>

OutputBlocked

Model output blocked by safety filter.

Fields

policy: Option<String>

ServerError

A 5xx or server-reported internal error.

Fields

status: Option<u16>

hint: Option<String>

ServerStreamAborted

The server aborted the stream during generation.

Fields

hint: Option<String>

Malformed(BoxError)

Failed to parse wire JSON / SSE.

ProtocolViolation

The server responded with a wire type or field not defined in the protocol specification.

Fields

hint: String

Transport(BoxError)

Transport-layer error (DNS, TCP, TLS, HTTP).

Timeout

Request timed out.

Fields

phase: TimeoutPhase

Canceled

Canceled by the user or upper layer.

Other(BoxError)

Catch-all variant; prefer to extract cases from here when adding new categories.

Trait Implementations

impl Debug for ProviderErrorKind

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

Formats the value using the given formatter.

impl Display for ProviderErrorKind

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

Formats the value using the given formatter.

impl Error for ProviderErrorKind

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.