Struct ChatError 

pub struct ChatError {
    pub source: AppError,
    pub finish_reason: Option<String>,
    pub prompt_tokens: Option<u32>,
    pub completion_tokens: Option<u32>,
    pub retry_class: AttemptOutcome,
}

OpenRouterChatClient::complete failure (GAP-SG-72-chat / GAP-SG-72 reauditor addendum).

Wraps the underlying AppError with whatever truncation diagnostics were available at the point of failure. finish_reason/token fields are None when the failure happened before a response was parsed (network error, a permanent 4xx, or exhausted retries) — only failures that occur AFTER a ChatResponse was successfully decoded (JSON-repair or shape-guard failures) carry them.

retry_class is the retry verdict computed AT THE ORIGIN (the exact HTTP status, or the provider’s structured error code), never inferred downstream from source.to_string(). The enrich queue consumes this field directly instead of pattern-matching the formatted message.

Fields

source: AppError

Underlying cause, preserved via source() rather than restated.

finish_reason: Option<String>

choices[0].finish_reason from the response that led to this error, when one was decoded.

prompt_tokens: Option<u32>

usage.prompt_tokens from the response that led to this error, when one was decoded.

completion_tokens: Option<u32>

usage.completion_tokens from the response that led to this error, when one was decoded.

retry_class: AttemptOutcome

Typed retry verdict computed where the failure originated (HTTP status / provider code), not by matching source’s message.

Trait Implementations

impl Debug for ChatError

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

Formats the value using the given formatter.

impl Display for ChatError

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

Formats the value using the given formatter.

impl Error for ChatError

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.