Enum LlmError 

pub enum LlmError {
    HttpError(String),
    JsonError(String),
    ParseError(String),
    InvalidInput(String),
    IoError(String),
    NotFound(String),
    MissingApiKey(String),
    InvalidParameter(String),
    ApiError {
        code: u16,
        message: String,
        details: Option<Value>,
    },
    AuthenticationError(String),
    RateLimitError(String),
    QuotaExceededError(String),
    ModelNotSupported(String),
    StreamError(String),
    TimeoutError(String),
    ConnectionError(String),
    ProviderError {
        provider: String,
        message: String,
        error_code: Option<String>,
    },
    ConfigurationError(String),
    InternalError(String),
    UnsupportedOperation(String),
    ProcessingError(String),
    ToolCallError(String),
    ToolValidationError(String),
    UnsupportedToolType(String),
    ContextualError {
        context: String,
        message: String,
        source_error: Option<Box<LlmError>>,
        metadata: HashMap<String, String>,
    },
    Other(String),
}

The primary error type for the LLM library.

Variants

HttpError(String)

HTTP request error

JsonError(String)

JSON serialization/deserialization error

ParseError(String)

Response parsing error

InvalidInput(String)

Invalid input error

IoError(String)

IO error

NotFound(String)

Not found error

MissingApiKey(String)

Missing API key

InvalidParameter(String)

Invalid parameter

ApiError

API error response

Fields

code: u16

message: String

details: Option<Value>

AuthenticationError(String)

Authentication error

RateLimitError(String)

Rate limit error

QuotaExceededError(String)

Quota exceeded error

ModelNotSupported(String)

Model not supported error

StreamError(String)

Stream processing error

TimeoutError(String)

Timeout error

ConnectionError(String)

Network connection error

ProviderError

Provider-specific error

Fields

provider: String

message: String

error_code: Option<String>

ConfigurationError(String)

Configuration error

InternalError(String)

Internal error

UnsupportedOperation(String)

Unsupported operation

ProcessingError(String)

Processing error

ToolCallError(String)

Tool call error

ToolValidationError(String)

Tool validation error

UnsupportedToolType(String)

Unsupported tool type

ContextualError

Context-aware error with additional metadata

Fields

context: String

message: String

source_error: Option<Box<LlmError>>

metadata: HashMap<String, String>

Other(String)

Other errors

Implementations

impl LlmError

pub fn api_error(code: u16, message: impl Into<String>) -> LlmError

Creates a new API error.

pub fn api_error_with_details( code: u16, message: impl Into<String>, details: Value, ) -> LlmError

Creates a new API error with details.

pub fn provider_error( provider: impl Into<String>, message: impl Into<String>, ) -> LlmError

Creates a new provider error.

pub fn provider_error_with_code( provider: impl Into<String>, message: impl Into<String>, error_code: impl Into<String>, ) -> LlmError

Creates a new provider error with an error code.

pub fn contextual_error( context: impl Into<String>, message: impl Into<String>, ) -> LlmError

Creates a new contextual error with metadata.

pub fn contextual_error_with_source( context: impl Into<String>, message: impl Into<String>, source: LlmError, ) -> LlmError

Creates a contextual error with a source error.

pub fn contextual_error_with_metadata( context: impl Into<String>, message: impl Into<String>, metadata: HashMap<String, String>, ) -> LlmError

Creates a contextual error with metadata.

pub fn is_retryable(&self) -> bool

Checks if the error is retryable with more sophisticated logic.

pub const fn is_auth_error(&self) -> bool

Checks if the error is an authentication-related error.

pub const fn is_rate_limit_error(&self) -> bool

Checks if the error is a rate limit error.

pub const fn status_code(&self) -> Option<u16>

Gets the HTTP status code of the error, if available.

pub fn category(&self) -> ErrorCategory

Gets the error category for better error handling.

pub fn user_message(&self) -> String

Gets a user-friendly error message.

pub fn recovery_suggestions(&self) -> Vec<String>

Gets suggested recovery actions for the error with more detailed guidance.

pub const fn recommended_retry_delay(&self) -> Option<u64>

Gets the recommended retry delay in seconds based on error type.

pub const fn max_retry_attempts(&self) -> u32

Gets the maximum number of retry attempts recommended for this error.

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<(), Error>

Formats the value using the given formatter.

impl Display for LlmError

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

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(err: Error) -> LlmError

Converts to this type from the input type.