Enum LoopError 

pub enum LoopError {
    Stream(StreamError),
    Aborted,
    ToolFatal {
        tool: String,
        reason: String,
    },
    InvalidContinuation(String),
    EmptyOutcomeBudgetExhausted {
        budget: usize,
        observed: usize,
    },
}

Why the loop terminated abnormally.

A successful run returns Ok(messages) with no error. The loop’s natural stop condition (no more tool calls + no follow-up) does not produce an error.

Variants

Stream(StreamError)

Stream transport raised an unrecoverable error. The provider implementation decides what’s recoverable; everything that bubbles up through StreamFn::stream ends the run.

Aborted

Caller cancelled via the abort signal.

ToolFatal

A tool encountered an unrecoverable failure and requested that the loop stop immediately rather than append a recoverable context event.

Fields

tool: String

reason: String

InvalidContinuation(String)

Cannot continue without a starting message: run_continue was called on an empty context, or the trailing message is assistant (which the model would not respond to).

EmptyOutcomeBudgetExhausted

The model repeatedly stopped without any tool call after the configured no-tool recovery budget had already been spent.

Fields

budget: usize

observed: usize

Trait Implementations

impl Debug for LoopError

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

Formats the value using the given formatter.

impl Display for LoopError

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

Formats the value using the given formatter.

impl Error for LoopError

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<StreamError> for LoopError

fn from(source: StreamError) -> Self

Converts to this type from the input type.