Enum ErrorCategory 

#[non_exhaustive]
pub enum ErrorCategory {
    BusinessLogic,
    External,
    Internal,
    Client,
    Transient,
}

High-level categorization of errors for routing and handling decisions.

Use LlmError::category() to get the category for any error.

Example

use multi_llm::{LlmError, error::ErrorCategory};

fn should_alert_ops(err: &LlmError) -> bool {
    matches!(err.category(), ErrorCategory::Internal | ErrorCategory::External)
}

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.

BusinessLogic

Expected business logic outcomes (not typically errors).

These are “errors” that represent normal application flow, like “user not found” when checking if a user exists.

External

External service failures (LLM providers, network issues).

The LLM provider or network had an issue. May be transient or indicate a provider outage.

Internal

Internal system errors (bugs, invariant violations).

Something went wrong in the code itself. These should be logged and investigated.

Client

Client errors (invalid input, authentication, configuration).

The caller made a mistake that they can fix (wrong API key, invalid parameters, etc.).

Transient

Temporary failures that should be retried.

Rate limits, timeouts, and other transient issues. Retry with exponential backoff.

Trait Implementations

impl Clone for ErrorCategory

fn clone(&self) -> ErrorCategory

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ErrorCategory

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

Formats the value using the given formatter.

impl Default for ErrorCategory

fn default() -> ErrorCategory

Returns the “default value” for a type.

impl PartialEq for ErrorCategory

fn eq(&self, other: &ErrorCategory) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for ErrorCategory

impl Eq for ErrorCategory

impl StructuralPartialEq for ErrorCategory