Enum LLMError 

pub enum LLMError {
    HttpError(String),
    AuthError {
        message: String,
        status_code: Option<u16>,
        response_body: Option<Box<str>>,
    },
    RateLimitError {
        status_code: u16,
        message: String,
        response_body: Box<str>,
        retry_after: Option<Duration>,
        provider_code: Option<Box<str>>,
    },
    HttpStatusError {
        status_code: u16,
        message: String,
        response_body: Box<str>,
        retry_after: Option<Duration>,
        provider_code: Option<Box<str>>,
    },
    InvalidRequest {
        message: String,
        status_code: Option<u16>,
        response_body: Option<Box<str>>,
    },
    ProviderError(String),
    ResponseFormatError {
        message: String,
        raw_response: String,
    },
    Generic(String),
    JsonError(String),
    ToolConfigError(String),
    NoToolSupport(String),
    GuardrailBlocked {
        phase: GuardrailPhase,
        guard: Box<str>,
        rule_id: Box<str>,
        category: Box<str>,
        severity: Box<str>,
        message: Box<str>,
    },
    GuardrailExecutionFailed {
        guard: String,
        message: String,
    },
}

Error types that can occur when interacting with LLM providers.

Variants

HttpError(String)

HTTP transport failures (connection, timeout, DNS, etc.).

AuthError

Authentication and authorization errors (missing local API key or HTTP 401/403).

Fields

message: String

status_code: Option<u16>

response_body: Option<Box<str>>

RateLimitError

Rate limit or provider overload (HTTP 429, 529).

Fields

status_code: u16

message: String

response_body: Box<str>

retry_after: Option<Duration>

provider_code: Option<Box<str>>

HttpStatusError

Non-success HTTP response that is not auth or rate-limit.

Fields

status_code: u16

message: String

response_body: Box<str>

retry_after: Option<Duration>

provider_code: Option<Box<str>>

InvalidRequest

Invalid request parameters, format, or client-side HTTP 4xx rejection.

Fields

message: String

status_code: Option<u16>

response_body: Option<Box<str>>

ProviderError(String)

Errors returned by the LLM provider in a parsed response payload.

ResponseFormatError

API response parsing or format error on a successful HTTP response.

Fields

message: String

raw_response: String

Generic(String)

Generic error (unsupported features, internal stubs).

JsonError(String)

JSON serialization/deserialization errors.

ToolConfigError(String)

Tool configuration error.

NoToolSupport(String)

Provider does not support tool calling.

GuardrailBlocked

Guardrail blocked the request/response.

Fields

phase: GuardrailPhase

guard: Box<str>

rule_id: Box<str>

category: Box<str>

severity: Box<str>

message: Box<str>

GuardrailExecutionFailed

Guardrail execution failed unexpectedly.

Fields

guard: String

message: String

Implementations

impl LLMError

pub fn missing_api_key(message: impl Into<String>) -> Self

Local configuration error when an API key is missing.

pub fn invalid_request(message: impl Into<String>) -> Self

Local validation error for invalid request parameters or configuration.

pub fn is_retryable(&self) -> bool

Returns true when the error represents a transient failure worth retrying.

pub fn http_status_code(&self) -> Option<u16>

HTTP status code when the error originated from a non-success response.

pub fn response_body(&self) -> Option<&str>

Provider response body attached to HTTP-related errors.

pub fn is_transport_retryable(&self) -> bool

Returns true when this HttpError represents a retryable transport failure.

Trait Implementations

impl Clone for LLMError

fn clone(&self) -> LLMError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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, f: &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

Available on non-WebAssembly only.

Converts reqwest HTTP errors into LLMErrors, preserving transport context.

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for LLMError

fn from(err: Error) -> Self

Converts to this type from the input type.