Enum ProviderError 

#[non_exhaustive]
pub enum ProviderError {
    Authentication {
        provider: ProviderId,
    },
    BadRequest {
        provider: ProviderId,
        message: String,
    },
    RateLimited {
        provider: ProviderId,
        retry_after: Option<Duration>,
    },
    Timeout {
        provider: ProviderId,
    },
    Overloaded {
        provider: ProviderId,
    },
    Unsupported {
        provider: ProviderId,
        feature: String,
    },
    Transport {
        provider: ProviderId,
        source: TransportError,
    },
    Decode {
        provider: ProviderId,
        message: String,
    },
    Provider {
        provider: ProviderId,
        status: Option<u16>,
        message: String,
    },
}

Errors produced by provider implementations.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Authentication

Provider credentials were rejected.

Fields

provider: ProviderId

Provider that rejected authentication.

BadRequest

Request payload was invalid for the target provider.

Fields

provider: ProviderId

Provider that rejected the request.

message: String

Provider-facing validation message.

RateLimited

Provider asked the caller to slow down.

Fields

provider: ProviderId

Provider that rate limited the request.

retry_after: Option<Duration>

Suggested delay before retrying.

Timeout

Provider call exceeded the configured timeout.

Fields

provider: ProviderId

Provider that timed out.

Overloaded

Provider is temporarily overloaded.

Fields

provider: ProviderId

Provider that reported overload.

Unsupported

Requested provider feature is unavailable.

Fields

provider: ProviderId

Provider that cannot serve the feature.

feature: String

Feature name, such as chat_stream or embedding.

Transport

Transport layer failed before a provider response was decoded.

Fields

provider: ProviderId

Provider reached by the transport.

source: TransportError

Lower-level HTTP client error.

Decode

Provider response could not be decoded into the neutral schema.

Fields

provider: ProviderId

Provider that returned an invalid response.

message: String

Decode failure summary.

Provider

Provider returned a structured error response.

Fields

provider: ProviderId

Provider that returned the error.

status: Option<u16>

Optional HTTP status or provider-specific status code.

message: String

Human-readable provider error message.

Implementations

impl ProviderError

pub const fn is_retryable(&self) -> bool

Returns true when retrying the same request may succeed.

pub fn is_context_overflow(&self) -> bool

Returns true when the error indicates the request exceeded the model’s context window and should be retried after compaction.

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.

impl From<ProviderError> for Error

fn from(source: ProviderError) -> Self

Converts to this type from the input type.