Enum StatusRow 

#[non_exhaustive]
pub enum StatusRow {
    Unauthorized,
    Forbidden,
    NotFound,
    RequestTimeout,
    ConnectionReset,
    TooManyRequests,
    ContextLength,
    BadRequest,
    InternalServerError,
    ServiceUnavailable,
    ContentFilter,
    ExpiredCredential,
    QuotaExhausted,
}

One wire failure and the error kind an adapter must map it onto.

Growable: match with a _ arm.

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.

Unauthorized

HTTP 401 must become Authentication — not Authorization. The key is wrong, and no other candidate configured with the same key will do better.

Forbidden

HTTP 403 must become Authorization. The key is fine and this model is not entitled to it, which is a different thing to tell an operator.

NotFound

HTTP 404 must become ModelNotFound, so the router moves to a candidate that exists instead of retrying a name that does not.

RequestTimeout

HTTP 408 must become Timeout. The provider is saying the deadline passed on its side; it means the same as the deadline passing on ours.

ConnectionReset

A socket that dies mid-call must become Timeout or Transport — never a server error, and never something fatal.

TooManyRequests

HTTP 429 must become RateLimited, carrying whatever delay the response advertised.

ContextLength

An HTTP 400 the provider describes as a context-length problem must become ContextOverflow, so the runtime shrinks the prompt instead of re-sending it.

BadRequest

An HTTP 400 that is genuinely a bad request must become InvalidRequest: our request is wrong and every other provider will reject it too.

InternalServerError

HTTP 500 must become Server.

ServiceUnavailable

HTTP 503 must become Server as well: a busy provider is retryable, not fatal.

ContentFilter

A safety filter must surface as ContentFilter or Refusal — as a kind, or as a response finishing that way — never as a server error a policy layer would retry.

ExpiredCredential

The vendor’s expired credential signal must become CredentialExpired, not Authentication.

Most vendors report it with the same 401 they use for a wrong key, so only the body tells them apart and only the adapter knows the shape. Getting it wrong strands a caller that holds a refresher: it is told the key is bad when refreshing would have fixed the call.

QuotaExhausted

The vendor’s quota or billing signal must become QuotaExhausted, not RateLimited.

Several vendors report an exhausted quota or an empty credit balance with HTTP 429, the same status as a rate limit. An adapter that reads the status alone makes the runtime sleep on a delay that will not help, burning the turn’s deadline for a balance only a human can refill.

Implementations

impl StatusRow

pub const ALL: [StatusRow; 13]

Every per-status row, in the order a run reports them.

pub const fn as_str(self) -> &'static str

Stable snake-case label, unique across every Check.

pub const fn http_status(self) -> Option<u16>

The HTTP status this row puts on the wire, when it is one.

ConnectionReset has none — the point is that no status ever arrives — and ContentFilter leaves the framing to the vendor.

pub const fn scenario(self) -> Option<Scenario>

The scenario a fixture mounts for this row.

ConnectionReset returns None: the suite owns that one, because a reset is produced by a socket rather than by a mock response.

pub const fn expected_kinds(self) -> &'static [&'static str]

The ProviderErrorKind labels this row accepts.

One entry for every row but the two documented at the module level.

pub const fn expected_retry_class(self) -> RetryClass

The RetryClass the kind this row requires must carry.

Every row has exactly one, including the two that accept two kinds: timeout and transport are both Retry, and content_filter and refusal are both Fatal. The class is asserted separately from the kind because they can drift apart, and it is the class the policy layer actually acts on.

pub const fn wire_description(self) -> &'static str

How a failure message names what was put on the wire.

pub const fn accepts_finish(self, finish: FinishReason) -> bool

Returns true when a successful response finishing this way is an acceptable answer for this row.

Only the content-filter row has one: every other row exists because a call failed, and a response where a failure was required is a defect.

Trait Implementations

impl Clone for StatusRow

fn clone(&self) -> StatusRow

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for StatusRow

impl Debug for StatusRow

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

Formats the value using the given formatter.

impl Display for StatusRow

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

Formats the value using the given formatter.

impl Eq for StatusRow

impl Hash for StatusRow

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for StatusRow

fn cmp(&self, other: &StatusRow) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for StatusRow

fn eq(&self, other: &StatusRow) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for StatusRow

fn partial_cmp(&self, other: &StatusRow) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for StatusRow