Enum ClassifiedError 

pub enum ClassifiedError {
    RateLimited {
        provider: String,
        retry_after: Option<Duration>,
    },
    ProviderUnavailable {
        provider: String,
        reason: String,
    },
    AuthFailed {
        provider: String,
    },
    ContextOverflow {
        tokens: u32,
    },
    OutputTruncated,
    StreamTimeout(Duration),
    ToolError {
        tool: String,
        message: String,
    },
    ToolNotFound(String),
    BudgetExhausted(u32),
    Io(String),
    Http(String),
    Parse(String),
    Config(String),
    Session(String),
    Storage(String),
    Runtime(String),
    Internal(String),
}

Classified error with recovery semantics.

Variants

RateLimited

Provider returned 429 / quota exceeded.

Fields

provider: String

retry_after: Option<Duration>

ProviderUnavailable

Provider is unreachable, 5xx, or degraded.

Fields

provider: String

reason: String

AuthFailed

Credential rejected (401/403).

Fields

provider: String

ContextOverflow

Request size exceeds model context window.

Fields

tokens: u32

OutputTruncated

Response truncated at max_tokens.

StreamTimeout(Duration)

SSE stream produced no chunk for the configured idle window.

ToolError

Tool reported a domain error (non-fatal).

Fields

tool: String

message: String

ToolNotFound(String)

Referenced tool name is not registered.

BudgetExhausted(u32)

Iteration budget exhausted (including grace call).

Io(String)

Filesystem or OS error.

Http(String)

HTTP transport error.

Parse(String)

JSON or protocol parsing error.

Config(String)

Configuration or setup problem.

Session(String)

Session or conversation state problem.

Storage(String)

Storage / persistence problem (file I/O, L3 write).

Runtime(String)

Runtime / agent loop problem.

Internal(String)

Invariant violation inside Roma itself.

Implementations

impl ClassifiedError

pub fn variant_name(&self) -> &'static str

Return the variant name as a static string.

pub fn from_tagged(kind: &str, msg: &str, retry_after_secs: Option<u64>) -> Self

Reconstruct an error from its serialized parts.

retry_after_secs is only used for the RateLimited variant.

pub fn is_retryable(&self) -> bool

Whether the error is worth retrying (same or different provider).

pub fn recovery_hint(&self) -> RecoveryAction

Suggested recovery action.

Trait Implementations

impl Clone for ClassifiedError

fn clone(&self) -> ClassifiedError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClassifiedError

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

Formats the value using the given formatter.

impl Display for ClassifiedError

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

Formats the value using the given formatter.

impl Error for ClassifiedError

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 ClassifiedError

fn from(err: Error) -> Self

Converts to this type from the input type.