Enum LoopError 

pub enum LoopError {
    ProviderFailure(Box<ProviderFailure>),
    InvalidState(String),
    Cancelled,
    ContextRecoveryDeadlineExceeded,
    Provider(String),
    Tool(ToolError),
    Mutator(String),
    Unsupported(String),
}

Errors that can occur while driving the agent loop.

Variants

ProviderFailure(Box<ProviderFailure>)

Typed, sanitized model failure with retry accounting.

InvalidState(String)

The driver was in an unexpected state for the requested operation.

Cancelled

The current turn was cancelled via the CancellationHandle.

ContextRecoveryDeadlineExceeded

The absolute context-recovery budget expired.

Provider(String)

An error originating from the model provider.

Tool(ToolError)

An error originating from tool execution.

Mutator(String)

An error reported by a LoopMutator (compaction, redaction, repair).

Unsupported(String)

The requested operation is not supported.

Implementations

impl LoopError

pub fn is_context_length_exceeded(&self) -> bool

True only for structured, confirmed upstream context-length rejection. Only the exact typed code is accepted; error types, messages, generic client errors, cancellation, and replay-unsafe failures are ignored.

pub fn provider_failure(&self) -> Option<&ProviderFailure>

Returns structured provider metadata without parsing a rendered error.

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

fn from(source: ToolError) -> Self

Converts to this type from the input type.