Enum Disposition 

#[non_exhaustive]
pub enum Disposition {
    Terminal,
    RetryAfter,
    NeedsConfig,
}

What a caller should DO about a failure, as opposed to what happened.

docs/ERRORS.md §2 has carried per-code retry guidance since Phase 0 and it is good guidance — but it is a markdown table, and the agent making the retry decision never reads it. Its only signal was the NAME of the code, and several names point the wrong way: NO_OA_AVAILABLE is the most common failure there is, and “no OA available” invites an unbounded retry loop for something that will not change until the configuration does (#506).

Three states, not two. “Retryable / not retryable” cannot express the case that matters most here — the answer will not change by itself, but a named one-line change makes it change. Facing that, an agent should neither loop nor give up silently; it should surface the specific change to a human.

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.

Terminal

The answer will not change. Do not retry, and do not wait for it.

Includes failures a caller can act on by issuing a DIFFERENT request (INVALID_REF, AMBIGUOUS, TEXT_UNAVAILABLE): this call is settled, which is what the disposition is about.

RetryAfter

The answer may change on its own. Retry, with backoff.

NeedsConfig

The answer will not change by itself, but a named change makes it. Surface it; do not loop.

Implementations

impl Disposition

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

The wire token, allocation-free.

Trait Implementations

impl Clone for Disposition

fn clone(&self) -> Disposition

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Disposition

impl Debug for Disposition

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Disposition

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Disposition

impl PartialEq for Disposition

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Disposition

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Disposition