Enum ModelError 

pub enum ModelError {
    Backend(BackendError),
    Config(ConfigError),
    ModelNotFound {
        model: String,
        searched: Vec<String>,
    },
    Timeout {
        operation: String,
        duration_secs: u64,
    },
    RateLimit {
        retry_after: Option<u64>,
        message: Option<String>,
    },
    InvalidRequest(String),
    ParseError {
        message: String,
        raw: Option<String>,
    },
    StreamError(String),
    Authentication(String),
    Unsupported {
        feature: String,
    },
    Cancelled,
}

Top-level error type for all model operations

Variants

Backend(BackendError)

Backend-specific error (connection, API, etc)

Config(ConfigError)

Configuration error (invalid settings, missing keys, etc)

ModelNotFound

Model not found or unavailable

Fields

model: String

searched: Vec<String>

Timeout

Request timeout

Fields

operation: String

duration_secs: u64

RateLimit

Rate limit exceeded. retry_after is the server’s Retry-After in seconds when it sent one; message is the human-readable reason from the 429 response body when one could be extracted (e.g. Cloudflare’s “used up your daily free allocation of 10,000 neurons”) — the difference between “wait a moment” and “upgrade your plan”.

Fields

retry_after: Option<u64>

message: Option<String>

InvalidRequest(String)

Invalid request (malformed input, bad parameters)

ParseError

Response parsing error

Fields

message: String

raw: Option<String>

StreamError(String)

Stream error (connection dropped, incomplete response)

Authentication(String)

Authentication error

Unsupported

The adapter does not implement the requested feature (e.g. an Anthropic adapter has no list_models endpoint, so the trait’s default impl returns this).

Fields

feature: String

Cancelled

The provider call was aborted by the turn’s cancellation token. The effect runner swallows this silently — the terminal Msg::TurnCancelled is emitted from drop_scope after the scope’s JoinSet drains, so no UpstreamError should reach the reducer for cancelled turns.

Implementations

impl ModelError

pub fn to_user_facing(&self) -> UserFacingError

Convert to user-facing error with actionable suggestions

Trait Implementations

impl Debug for ModelError

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

Formats the value using the given formatter.

impl Display for ModelError

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

Formats the value using the given formatter.

impl Error for ModelError

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 ModelError

Conversion from anyhow::Error (for gradual migration)

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ModelError

Conversion from reqwest::Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ModelError

Conversion from serde_json::Error

fn from(err: Error) -> Self

Converts to this type from the input type.