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 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 PartialEq for StreamErrorKind

fn eq(&self, other: &StreamErrorKind) -> 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 StreamErrorKind

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for StreamErrorKind

impl Eq for StreamErrorKind

impl StructuralPartialEq for StreamErrorKind