Enum RouterError 

#[non_exhaustive]
pub enum RouterError {
    Empty,
    AllFailed {
        tried: usize,
        last: Box<dyn Error + Send + Sync>,
    },
    Model {
        model: String,
        source: Box<dyn Error + Send + Sync>,
    },
    RateLimited {
        model: String,
        reason: RateLimitReason,
    },
    BudgetExceeded(BudgetExceeded),
}

Unified error for RouterLLM.

Aggregates heterogeneous provider errors behind Box<dyn Error> so a single router can mix providers whose native error types differ.

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.

Empty

No models were configured on the router.

AllFailed

Every candidate model was tried and all failed. tried is the number of models attempted; last is the final error.

Fields

tried: usize

The number of models attempted.

last: Box<dyn Error + Send + Sync>

The final error from the last attempted model.

Model

A single model failed (wrapped when propagating from an adapter).

Fields

model: String

The name of the model that failed.

source: Box<dyn Error + Send + Sync>

The underlying provider error.

RateLimited

The slot’s per-model rate limiter could not admit the call in time. The router treats this like a model failure and tries the next slot.

Fields

model: String

The name of the rate-limited model.

reason: RateLimitReason

Whether the queue was full or the wait timed out.

BudgetExceeded(BudgetExceeded)

The router budget would have been exceeded by the projected call. The router skips that slot (free slots remain reachable) and tries the next candidate; this surfaces as the final error only when every candidate was skipped.

Tuple Fields

0: BudgetExceeded

Snapshot of the exceeded dimension, used amount and limit.

Trait Implementations

impl Debug for RouterError

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

Formats the value using the given formatter.

impl Display for RouterError

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

Formats the value using the given formatter.

impl Error for RouterError

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<RouterError> for CoreError

fn from(source: RouterError) -> Self

Converts to this type from the input type.