Enum ProviderError 

#[non_exhaustive]
pub enum ProviderError {
    OpenAI(OpenAIError),
    Anthropic(AnthropicError),
    Gemini(GeminiError),
    Azure(AzureOpenAIError),
    Cohere(CohereError),
    Ollama(OllamaError),
    Assistant(AssistantError),
    Responses(ResponsesError),
    DeepSeek(OpenAIError),
    Qwen(OpenAIError),
    Moonshot(OpenAIError),
    Zhipu(OpenAIError),
    Mistral(OpenAIError),
    OpenAICompatible {
        provider: String,
        source: OpenAIError,
    },
    Config(String),
    Testkit(String),
}

Unified error type that aggregates all LLM provider errors.

This allows using ? across provider boundaries without manually mapping error types. Each variant wraps the original provider error, preserving full context.

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.

OpenAI(OpenAIError)

OpenAI API error.

Anthropic(AnthropicError)

Anthropic API error.

Gemini(GeminiError)

Gemini API error.

Azure(AzureOpenAIError)

Azure OpenAI API error.

Cohere(CohereError)

Cohere API error.

Ollama(OllamaError)

Ollama API error.

Assistant(AssistantError)

OpenAI Assistants API error.

Responses(ResponsesError)

OpenAI Responses API error.

DeepSeek(OpenAIError)

DeepSeek API error (OpenAI-compatible endpoint).

Qwen(OpenAIError)

Qwen (Alibaba) API error (OpenAI-compatible endpoint).

Moonshot(OpenAIError)

Moonshot (Kimi) API error (OpenAI-compatible endpoint).

Zhipu(OpenAIError)

Zhipu (ChatGLM) API error (OpenAI-compatible endpoint).

Mistral(OpenAIError)

Mistral API error (OpenAI-compatible endpoint).

OpenAICompatible

B5: any OpenAI-compatible endpoint reached through the generic client (Groq, OpenRouter, xAI, vLLM, LM Studio, private gateways, …). The provider label identifies which preset or custom endpoint failed.

Fields

provider: String

Endpoint label ("groq", "openrouter", "xai", "openai-compatible").

source: OpenAIError

Underlying OpenAI-protocol error.

Config(String)

Configuration error (missing/malformed environment variables, etc.).

Testkit(String)

Testkit harness error (recording/replay failures from lc-testkit).

Trait Implementations

impl Debug for ProviderError

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

Formats the value using the given formatter.

impl Display for ProviderError

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

Formats the value using the given formatter.

impl Error for ProviderError

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<AnthropicError> for ProviderError

fn from(e: AnthropicError) -> Self

Converts to this type from the input type.

impl From<AssistantError> for ProviderError

fn from(e: AssistantError) -> Self

Converts to this type from the input type.

impl From<AzureOpenAIError> for ProviderError

fn from(e: AzureOpenAIError) -> Self

Converts to this type from the input type.

impl From<CohereError> for ProviderError

fn from(e: CohereError) -> Self

Converts to this type from the input type.

impl From<GeminiError> for ProviderError

fn from(e: GeminiError) -> Self

Converts to this type from the input type.

impl From<OllamaError> for ProviderError

fn from(e: OllamaError) -> Self

Converts to this type from the input type.

impl From<OpenAIError> for ProviderError

fn from(e: OpenAIError) -> Self

Converts to this type from the input type.

impl From<ProviderError> for LcelError

Allow ProviderError to convert into LcelError for LCEL pipeline compatibility. This enables LLM providers to participate in pipe() chains.

fn from(err: ProviderError) -> Self

Converts to this type from the input type.

impl From<ProviderError> for OpenAIError

fn from(e: ProviderError) -> Self

Converts to this type from the input type.

impl From<ResponsesError> for ProviderError

fn from(e: ResponsesError) -> Self

Converts to this type from the input type.

impl From<String> for ProviderError

Allow testkit harness errors (recording/replay) to surface through the provider error chain. lc-testkit is an external crate and cannot construct #[non_exhaustive] variants, so this is the sole entry point.

fn from(msg: String) -> Self

Converts to this type from the input type.