Enum AgentLoopError 

pub enum AgentLoopError {
    Llm(String),
    RequestTooLarge(String),
    ModelNotAvailable(String),
    ToolExecution(String),
    MessageStore(String),
    EventEmission(String),
    Configuration(String),
    MaxIterationsReached(usize),
    Cancelled,
    NoMessages,
    AgentNotFound(AgentId),
    HarnessNotFound(HarnessId),
    SessionNotFound(SessionId),
    Internal(Error),
    DriverNotRegistered(String),
}

Errors that can occur during agent loop execution

Variants

Llm(String)

LLM provider error

RequestTooLarge(String)

Request too large error (context length exceeded, token limits, etc.) Contains the original error message for logging

ModelNotAvailable(String)

Model not available (404, model not found, access denied for model) Contains the model_id string that was requested

ToolExecution(String)

Tool execution error

MessageStore(String)

Message store error

EventEmission(String)

Event emission error

Configuration(String)

Configuration error

MaxIterationsReached(usize)

Loop terminated due to max iterations

Cancelled

Loop was cancelled

NoMessages

No messages to process

AgentNotFound(AgentId)

Agent not found

HarnessNotFound(HarnessId)

Harness not found

SessionNotFound(SessionId)

Session not found

Internal(Error)

Internal error

DriverNotRegistered(String)

Driver not registered for provider type

Implementations

impl AgentLoopError

pub fn llm(msg: impl Into<String>) -> Self

Create an LLM error

pub fn tool(msg: impl Into<String>) -> Self

Create a tool execution error

pub fn store(msg: impl Into<String>) -> Self

Create a message store error

pub fn event(msg: impl Into<String>) -> Self

Create an event emission error

pub fn config(msg: impl Into<String>) -> Self

Create a configuration error

pub fn agent_not_found(agent_id: AgentId) -> Self

Create an agent not found error

pub fn harness_not_found(harness_id: HarnessId) -> Self

Create a harness not found error

pub fn session_not_found(session_id: SessionId) -> Self

Create a session not found error

pub fn driver_not_registered(provider_type: impl Into<String>) -> Self

Create a driver not registered error

pub fn request_too_large(msg: impl Into<String>) -> Self

Create a request too large error

pub fn model_not_available(model_id: impl Into<String>) -> Self

Create a model not available error

pub fn is_request_too_large(&self) -> bool

Check if this is a request-too-large error

pub fn is_model_not_available(&self) -> bool

Check if this is a model-not-available error

pub fn model_not_available_id(&self) -> Option<&str>

Get the model ID if this is a model-not-available error

pub fn is_rate_limited(&self) -> bool

Check if this is a rate-limit error (HTTP 429 or rate-limit keywords)

pub fn is_auth_error(&self) -> bool

Check if this is an authentication/authorization error (HTTP 401/403)

pub fn is_server_error(&self) -> bool

Check if this is a server error (HTTP 5xx or transient provider issue)

pub fn is_non_retryable(&self) -> bool

Check if this error is deterministic and should never be retried.

Non-retryable errors reference data that is permanently gone (e.g. a deleted message, a missing agent). Retrying will never succeed and only burns attempts while keeping the workflow stuck.

Note: the durable worker currently uses string-matching via is_non_retryable_task_error because task errors arrive as strings. This method provides the typed equivalent for callers that have access to a structured AgentLoopError.

pub fn user_facing_message(&self) -> String

Get user-facing error message based on error classification

pub fn user_facing_error( &self, context: UserFacingErrorContext, ) -> UserFacingError

Get structured user-facing error metadata based on error classification.

Trait Implementations

impl Debug for AgentLoopError

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

Formats the value using the given formatter.

impl Display for AgentLoopError

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

Formats the value using the given formatter.

impl Error for AgentLoopError

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<Error> for AgentLoopError

fn from(source: Error) -> Self

Converts to this type from the input type.