Enum AgentError 

#[non_exhaustive]
pub enum AgentError {
    Model(ModelError),
    Tool(ToolError),
    Retrieval(RetrievalError),
    Budget(BudgetExceeded),
    Gateway(GatewayError),
    Journal(JournalError),
    Checkpoint(CheckpointError),
    Effect(EffectExecutorError),
    AmbiguousCheckpoint {
        turn: u32,
    },
    InvalidConfig(String),
    Protocol(String),
    MaxTurns {
        max_turns: u32,
    },
    ToolOutputNotVisible {
        tool: String,
    },
}

Failure of an agent run.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Model(ModelError)

Model invocation failed.

Tool(ToolError)

Tool execution failed.

Retrieval(RetrievalError)

Static or dynamic context retrieval failed.

Budget(BudgetExceeded)

A shared run-tree budget was exceeded.

Gateway(GatewayError)

Agent delegation failed.

Journal(JournalError)

Structured event recording failed.

Checkpoint(CheckpointError)

Checkpoint persistence or validation failed.

Effect(EffectExecutorError)

Write-ahead effect coordination failed.

AmbiguousCheckpoint

Recovery would silently retry a possibly partial external turn.

Fields

turn: u32

One-based interrupted turn number.

InvalidConfig(String)

Agent configuration is invalid.

Protocol(String)

Model output violated the agent-loop protocol.

MaxTurns

The configured local turn bound was reached.

Fields

max_turns: u32

Configured local turn bound.

ToolOutputNotVisible

A tool produced output that policy forbids exposing to the model.

Fields

tool: String

Tool name.

Trait Implementations

impl Debug for AgentError

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

Formats the value using the given formatter.

impl Display for AgentError

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

Formats the value using the given formatter.

impl Error for AgentError

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<AgentError> for AgentPromptError

fn from(source: AgentError) -> Self

Converts to this type from the input type.

impl From<AgentError> for StructuredAgentError

fn from(source: AgentError) -> Self

Converts to this type from the input type.

impl From<BudgetExceeded> for AgentError

fn from(source: BudgetExceeded) -> Self

Converts to this type from the input type.

impl From<CheckpointError> for AgentError

fn from(source: CheckpointError) -> Self

Converts to this type from the input type.

impl From<EffectExecutorError> for AgentError

fn from(source: EffectExecutorError) -> Self

Converts to this type from the input type.

impl From<GatewayError> for AgentError

fn from(source: GatewayError) -> Self

Converts to this type from the input type.

impl From<JournalError> for AgentError

fn from(source: JournalError) -> Self

Converts to this type from the input type.

impl From<ModelError> for AgentError

fn from(source: ModelError) -> Self

Converts to this type from the input type.

impl From<RetrievalError> for AgentError

fn from(source: RetrievalError) -> Self

Converts to this type from the input type.

impl From<ToolError> for AgentError

fn from(source: ToolError) -> Self

Converts to this type from the input type.