Enum ProxyError 

pub enum ProxyError {
    UnknownModel(String),
    NoHealthyDeployment(String),
    Upstream {
        status: u16,
        body: String,
        retry_after_secs: Option<u64>,
    },
    RateLimited,
    BudgetExceeded,
    ModelNotAllowed,
    Transport(String),
    Unauthorized,
    BadRequest(String),
    Internal(Error),
}

Errors from request parsing, translation, and (in an embedder’s runtime) upstream transport. http_status/log_status map each variant to the wire and log mappings an ingress surface would use; the variants are shared here so a mapped request carries one error type end to end.

Variants

UnknownModel(String)

NoHealthyDeployment(String)

Upstream

Fields

status: u16

body: String

retry_after_secs: Option<u64>

Upstream-supplied backoff hint (Retry-After seconds), when present. None on errors constructed without a response (timeouts, bad JSON).

RateLimited

BudgetExceeded

ModelNotAllowed

Transport(String)

Unauthorized

BadRequest(String)

Internal(Error)

Implementations

impl ProxyError

pub fn upstream(status: u16, body: String) -> Self

pub fn log_status(&self) -> i64

Status recorded in a spend/request log for this failure. Unlike http_status(), a client-side disconnect mid-stream is logged as 503 (the client’s problem), and unknown-internal as 500 — the log table intentionally diverges from the wire mapping.

pub fn http_status(&self) -> u16

HTTP status for this error on the wire. Individual dialects may override (the Anthropic dialect maps BudgetExceeded to Anthropic-style 429 — see dialect/anthropic/out.rs).

Trait Implementations

impl Debug for ProxyError

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

Formats the value using the given formatter.

impl Display for ProxyError

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

Formats the value using the given formatter.

impl Error for ProxyError

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 ProxyError

fn from(source: Error) -> Self

Converts to this type from the input type.