Enum LlmError 

#[non_exhaustive]
pub enum LlmError {
    Network(String),
    Timeout,
    RateLimit {
        retry_after_secs: u32,
    },
    Unauthorized,
    BadRequest(String),
    Server(String),
    Decoding(String),
    Unsupported(String),
    Cancelled,
    Suspended {
        reason: String,
    },
}

LLM provider errors.

Marked #[non_exhaustive] so additional variants can be introduced without a major-version bump on impl crates that match on the enum.

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.

Network(String)

Network transport failure (connection refused, DNS, etc).

Timeout

Request exceeded its deadline.

RateLimit

Provider returned a 429-equivalent rate-limit signal.

Fields

retry_after_secs: u32

Server-suggested retry delay.

Unauthorized

Authentication or authorisation failure.

BadRequest(String)

Provider rejected the request shape.

Server(String)

Provider returned a 5xx-equivalent.

Decoding(String)

Response payload could not be decoded.

Unsupported(String)

Capability declared unsupported by the client.

Cancelled

Operation was cooperatively cancelled. Surfaced from the streaming runtime when ctx.cancel fires mid-stream so consumers can distinguish a cooperative cancel from a provider failure.

Suspended

The run suspended at a human-review gate (ADR-045) rather than failing. Emitted as the streaming path’s terminal item when a ReviewPolicy pauses a step: the durable RunCheckpoint was persisted to RunOptions::checkpoint_kv_bucket, and the run resumes via resume_from_checkpoint. Not retryable — and not a failure, so the streaming driver records no Episode::Failed for it.

Fields

reason: String

Short, human-readable pause explanation — the same string carried by the blocking path’s Error::Suspended, safe to surface to operators.

Implementations

impl LlmError

pub fn retryable(&self) -> bool

Returns true if the runtime should retry the operation.

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

fn from(source: LlmError) -> Self

Converts to this type from the input type.