Enum LlmErrorKind 

pub enum LlmErrorKind {
    Authentication,
    QuotaExhausted,
    RateLimited,
    Unavailable,
    InvalidRequest,
    Other,
}

Semantic classification of an LLM provider error, assigned by the driver at the provider boundary where the HTTP status and response body are still available. Downstream consumers prefer this over re-parsing error strings; LlmErrorKind::Other falls back to string classification (classify_runtime_error_message) so untyped errors keep working.

Variants

Authentication

Invalid or missing credentials, or access denied (401/403, bad API key).

QuotaExhausted

Provider account is out of credits/quota (billing). Non-transient: needs operator action, unlike a regular rate limit.

RateLimited

Transient rate limit (429).

Unavailable

Provider outage or unreachable (5xx, 529, network failure).

InvalidRequest

Provider rejected the request shape (4xx that is not auth/quota/429).

Other

Unclassified; downstream falls back to string classification.

Implementations

impl LlmErrorKind

pub fn from_provider_status(status: u16, body: &str) -> Self

Classify a provider HTTP error from status code + response body.

Quota/billing patterns are checked before the status code because providers surface exhausted billing under different statuses (OpenAI: 429 insufficient_quota, Anthropic: 400 “credit balance is too low”).

pub fn from_error_text(text: &str) -> Self

Keyword-based classification for drivers without an HTTP status at the error site (e.g. Bedrock SDK errors).

Trait Implementations

impl Clone for LlmErrorKind

fn clone(&self) -> LlmErrorKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for LlmErrorKind

impl Debug for LlmErrorKind

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LlmErrorKind

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for LlmErrorKind

impl PartialEq for LlmErrorKind

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for LlmErrorKind

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for LlmErrorKind