Enum LiterLlmError 

#[non_exhaustive]
pub enum LiterLlmError {
    Authentication {
        message: String,
    },
    RateLimited {
        message: String,
        retry_after: Option<Duration>,
    },
    BadRequest {
        message: String,
    },
    ContextWindowExceeded {
        message: String,
    },
    ContentPolicy {
        message: String,
    },
    NotFound {
        message: String,
    },
    ServerError {
        message: String,
    },
    ServiceUnavailable {
        message: String,
    },
    Timeout,
    Network(Error),
    Streaming {
        message: String,
    },
    EndpointNotSupported {
        endpoint: String,
        provider: String,
    },
    InvalidHeader {
        name: String,
        reason: String,
    },
    Serialization(Error),
    BudgetExceeded {
        message: String,
        model: Option<String>,
    },
    HookRejected {
        message: String,
    },
    InternalError {
        message: String,
    },
}

All errors that can occur when using liter-llm.

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

Fields

message: String

RateLimited

Fields

message: String

retry_after: Option<Duration>

BadRequest

Fields

message: String

ContextWindowExceeded

Fields

message: String

ContentPolicy

Fields

message: String

NotFound

Fields

message: String

ServerError

Fields

message: String

ServiceUnavailable

Fields

message: String

Timeout

Network(Error)

Streaming

A catch-all for errors that occur during streaming response processing.

This variant covers multiple sub-conditions including UTF-8 decoding failures, CRC/checksum mismatches (AWS EventStream), JSON parse errors in individual SSE chunks, and buffer overflow conditions. The message field contains a human-readable description of the specific failure.

Fields

message: String

EndpointNotSupported

Fields

endpoint: String

provider: String

InvalidHeader

Fields

name: String

reason: String

Serialization(Error)

BudgetExceeded

Fields

message: String

model: Option<String>

HookRejected

Fields

message: String

InternalError

An internal logic error (e.g. unexpected Tower response variant).

This should never surface in normal operation — if it does, it indicates a bug in the library.

Fields

message: String

Implementations

impl LiterLlmError

pub fn is_transient(&self) -> bool

Returns true for errors that are worth retrying on a different service or deployment (transient failures).

Used by [crate::tower::fallback::FallbackService] and [crate::tower::router::Router] to decide whether to route to an alternative endpoint.

pub fn error_type(&self) -> &'static str

Return the OpenTelemetry error.type string for this error variant.

Used by the tracing middleware to record the error.type span attribute on failed requests per the GenAI semantic conventions.

pub fn from_status( status: u16, body: &str, retry_after: Option<Duration>, ) -> Self

Create from an HTTP status code, an API error response body, and an optional Retry-After duration already parsed from the response header.

The retry_after value is forwarded into LiterLlmError::RateLimited so callers can honour the server-requested delay without re-parsing the header.

Trait Implementations

impl Debug for LiterLlmError

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

Formats the value using the given formatter.

impl Display for LiterLlmError

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

Formats the value using the given formatter.

impl Error for LiterLlmError

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<Error> for LiterLlmError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for LiterLlmError

fn from(source: Error) -> Self

Converts to this type from the input type.