Enum LlmError 

pub enum LlmError {
    CircuitOpen,
    Transport(Error),
    Api {
        status: u16,
        body: String,
    },
    Decode(Error),
    StreamProtocol(String),
    InvalidUtf8(FromUtf8Error),
    AllRetriesFailed {
        attempts: u32,
        source: Box<LlmError>,
    },
}

Everything that can go wrong on the way to a completion.

Mirrors the failure modes of the Python llm_completion wrapper, but where that returned None and swallowed the cause, we keep a typed error so the caller decides how to degrade.

Variants

CircuitOpen

Circuit breaker is open — we fail fast without hitting the provider.

Transport(Error)

Transport-level failure (connection, TLS, timeout).

Api

Provider returned a non-2xx status.

Fields

status: u16

body: String

Decode(Error)

Response body could not be decoded into the expected shape.

StreamProtocol(String)

A streaming response violated the SSE completion contract.

InvalidUtf8(FromUtf8Error)

A streaming response contained bytes that were not valid UTF-8.

AllRetriesFailed

All retry attempts were exhausted. Carries the last error seen.

Fields

attempts: u32

source: Box<LlmError>

Implementations

impl LlmError

pub fn is_retryable(&self) -> bool

Whether retrying this error class could plausibly succeed.

A 4xx (except 408/429) is the caller’s fault and will fail identically on retry; transport errors and 5xx/408/429 are worth another attempt.

Trait Implementations

impl Debug for LlmError

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

Formats the value using the given formatter.

impl Display for LlmError

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

Formats the value using the given formatter.

impl Error for LlmError

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 LlmError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for LlmError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<FromUtf8Error> for LlmError

fn from(source: FromUtf8Error) -> Self

Converts to this type from the input type.