Enum StreamErrorKind 

pub enum StreamErrorKind {
    Transient,
    ProviderRateLimited,
    ZeroOutputTransport,
    Fatal,
    Empty,
    Aborted,
    ContextOverflow,
}

Coarse classification of a stream error.

ContextOverflow is split out from Fatal so the loop can apply recovery (re-run with a smaller context) instead of terminating. Without this split, providers that surface a prompt_too_long / context_length_exceeded error look identical to permanent failures (auth, schema, model id) and the loop has no signal to distinguish “trim and retry” from “give up”.

Variants

Transient

ProviderRateLimited

The selected model/provider is temporarily rate-limited. This remains retryable at the transport boundary, but surfaces as a distinct terminal kind if every retry fails.

ZeroOutputTransport

Transport failed before the provider produced any actionable assistant turn. Hidden reasoning/details, usage, or an unusable burst of partial tool-call deltas may have arrived, but the loop still has no runnable next step, so this is safer to replay than a generic transient stream error.

Fatal

Empty

Aborted

ContextOverflow

Provider rejected the request because the assembled context exceeds the model’s window. Distinct from Fatal so a future recovery layer (Phase 2 in the compaction roadmap) can compact more aggressively and retry rather than ending the run.

Trait Implementations

impl Clone for StreamErrorKind

fn clone(&self) -> StreamErrorKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for StreamErrorKind

impl Debug for StreamErrorKind

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for StreamErrorKind

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for StreamErrorKind

impl PartialEq for StreamErrorKind

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for StreamErrorKind

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 StreamErrorKind