Enum LlmError 

pub enum LlmError {
    MissingApiKey(String),
    HttpClientCreation(String),
    Provider(ProviderError),
    IoError(String),
    JsonParsing(String),
    ToolParameterParsing {
        tool_name: String,
        error: String,
    },
    OAuthError(String),
    UnsupportedContent(String),
    MissingProviderUrl {
        provider: String,
    },
    UnknownProvider {
        provider: String,
    },
    EmptyModelSpec,
    DuplicateProvider {
        provider: String,
        field: String,
    },
    InvalidModelSpec(String),
    ProviderRequest(String),
    InvalidArgument(String),
}

Errors that can occur when interacting with LLM providers.

Other variants

Authentication

• MissingApiKey – A required environment variable (e.g. ANTHROPIC_API_KEY) is not set.
• OAuthError – OAuth authentication failed (when the oauth feature is enabled).

Request/Response

• HttpClientCreation – Failed to create the HTTP client (e.g. TLS configuration error).

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).

Model parsing

• UnknownProvider – Provider name is not registered with the model parser.
• EmptyModelSpec – The model spec did not yield any usable provider.
• DuplicateProvider – A single-model-only config field was reused across multiple models of the same provider within one alloy spec (e.g. bedrock inferenceProfileArn or openai-compatible requestModel).
• InvalidModelSpec – A provider:model identity could not be parsed.
• MissingProviderUrl – Provider endpoint URL has not been configured.
• ProviderRequest – A provider request, header, or signature could not be constructed (e.g. an SDK builder rejected the input or contained malformed data).
• InvalidArgument – An upstream client library rejected an argument as invalid.

Type alias

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

Variants

MissingApiKey(String)

Environment variable not set or invalid

HttpClientCreation(String)

HTTP client creation failed

Provider(ProviderError)

Normalized provider-side failure carrying retry classification and support diagnostics (HTTP status, request ID, provider error code).

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

MissingProviderUrl

Provider endpoint URL has not been configured.

Fields

provider: String

UnknownProvider

Provider name is not registered with the model parser.

Fields

provider: String

EmptyModelSpec

The model spec did not yield any usable provider.

DuplicateProvider

A single-model-only config field was reused across multiple models of the same provider within one alloy spec (e.g. bedrock inferenceProfileArn or openai-compatible requestModel).

Fields

provider: String

field: String

InvalidModelSpec(String)

A provider:model identity could not be parsed.

ProviderRequest(String)

A provider request body could not be constructed (e.g. an SDK builder rejected the input or contained malformed data).

InvalidArgument(String)

An upstream client library rejected an argument as invalid.

Implementations

impl LlmError

pub fn is_retryable(&self) -> bool

pub fn provider(&self) -> Option<&ProviderError>

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 codex 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.

impl From<ProviderError> for LlmError

fn from(source: ProviderError) -> Self

Converts to this type from the input type.

impl From<SdkError<ConverseStreamError, Response>> for LlmError

fn from(e: SdkError<ConverseStreamError>) -> Self

Converts to this type from the input type.

impl From<SdkError<ConverseStreamOutputError, RawMessage>> for LlmError

fn from(e: SdkError<ConverseStreamOutputError, RawMessage>) -> Self

Converts to this type from the input type.