Enum LlmError 

pub enum LlmError {
    MissingApiKey(String),
    InvalidApiKey(String),
    HttpClientCreation(String),
    ApiRequest(String),
    ApiError(String),
    ContextOverflow(ContextOverflowError),
    IoError(String),
    JsonParsing(String),
    ToolParameterParsing {
        tool_name: String,
        error: String,
    },
    OAuthError(String),
    UnsupportedContent(String),
    Other(String),
}

Errors that can occur when interacting with LLM providers.

Variants

Authentication

• MissingApiKey – A required environment variable (e.g. ANTHROPIC_API_KEY) is not set.
• InvalidApiKey – The API key format is invalid or was rejected by the provider.
• OAuthError – OAuth authentication failed (when the oauth feature is enabled).

Request/Response

• HttpClientCreation – Failed to create the HTTP client (e.g. TLS configuration error).
• ApiRequest – The HTTP request to the provider failed (network error, timeout).
• ApiError – The provider returned an error response (rate limit, server error).
• ContextOverflow – The prompt exceeded the model’s context window. Contains a ContextOverflowError with provider, model, and token details.

Parsing

• JsonParsing – Failed to parse or serialize JSON (response body, tool arguments).
• ToolParameterParsing – Failed to parse tool parameters for a specific tool.
• IoError – IO error while reading the response stream.

Content

• UnsupportedContent – The message contained only content types this provider doesn’t support (e.g. sending audio to a text-only model).

Other

• Other – Catch-all for cases that don’t fit the above categories.

From implementations

LlmError converts automatically from common error types: reqwest::Error, serde_json::Error, std::io::Error, reqwest::header::InvalidHeaderValue, async_openai::error::OpenAIError, and OAuthError (with the oauth feature).

Type alias

The crate provides type Result<T> = std::result::Result<T, LlmError> for convenience.

Variants

MissingApiKey(String)

Environment variable not set or invalid

InvalidApiKey(String)

Invalid API key format

HttpClientCreation(String)

HTTP client creation failed

ApiRequest(String)

API request failed

ApiError(String)

API returned an error response

ContextOverflow(ContextOverflowError)

API rejected the request because the prompt exceeded the model’s context window.

IoError(String)

IO error while reading stream

JsonParsing(String)

JSON parsing/serialization error

ToolParameterParsing

Tool parameter parsing error

Fields

tool_name: String

error: String

OAuthError(String)

OAuth authentication error

UnsupportedContent(String)

The message contained only content types this provider doesn’t support

Other(String)

Generic error for other cases

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, __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(error: Error) -> Self

Converts to this type from the input type.

impl From<Error> for LlmError

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<Error> for LlmError

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<InvalidHeaderValue> for LlmError

fn from(error: InvalidHeaderValue) -> Self

Converts to this type from the input type.

impl From<OAuthError> for LlmError

Available on crate feature oauth only.

fn from(error: OAuthError) -> Self

Converts to this type from the input type.

impl From<OpenAIError> for LlmError

fn from(error: OpenAIError) -> Self

Converts to this type from the input type.