Enum AgentRuntimeError 

#[non_exhaustive]
pub enum AgentRuntimeError {
    Memory(String),
    Graph(String),
    Orchestration(String),
    AgentLoop(String),
    NotConfigured(&'static str),
    CircuitOpen {
        service: String,
    },
    BackpressureShed {
        depth: usize,
        capacity: usize,
    },
    DeduplicationConflict {
        key: String,
    },
    Provider(String),
    Persistence(String),
    Validation {
        field: String,
        code: String,
        message: String,
    },
}

Unified error type returned by all public agent-runtime APIs.

Marked #[non_exhaustive] so that adding new variants in future minor releases does not break external match arms.

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.

Memory(String)

A memory subsystem operation failed (episodic, semantic, or working memory).

Graph(String)

A graph subsystem operation failed (entity/relationship management or traversal).

Orchestration(String)

The orchestration pipeline or one of its stages failed.

AgentLoop(String)

The ReAct agent loop encountered an unrecoverable error.

NotConfigured(&'static str)

The runtime was used before a required subsystem was configured.

CircuitOpen

Circuit breaker is open — fast-fail without attempting the operation.

Fields

service: String

Name of the service whose circuit breaker is open.

BackpressureShed

Backpressure threshold exceeded — caller must shed or wait.

Fields

depth: usize

Current in-flight request count at the time of rejection.

capacity: usize

Maximum allowed in-flight request count.

DeduplicationConflict

A deduplication key collision was detected.

Fields

key: String

The duplicated request key.

Provider(String)

An LLM provider call failed.

Persistence(String)

A persistence operation failed.

Validation

A tool argument validation failed.

Fields

field: String

The argument field that failed validation.

code: String

A short machine-readable code (e.g. “out_of_range”, “pattern_mismatch”).

message: String

Human-readable description of the failure.

Implementations

impl AgentRuntimeError

pub fn is_circuit_open(&self) -> bool

Return true if this is a CircuitOpen error.

pub fn is_backpressure(&self) -> bool

Return true if this is a BackpressureShed error.

pub fn is_provider(&self) -> bool

Return true if this is a Provider error.

pub fn is_validation(&self) -> bool

Return true if this is a Validation error.

pub fn is_memory(&self) -> bool

Return true if this is a Memory error.

pub fn is_graph(&self) -> bool

Return true if this is a Graph error.

pub fn is_agent_loop(&self) -> bool

Return true if this is an AgentLoop error.

pub fn is_orchestration(&self) -> bool

Return true if this is an Orchestration error.

pub fn is_persistence(&self) -> bool

Return true if this is a Persistence error.

pub fn is_not_configured(&self) -> bool

Return true if this is a NotConfigured error.

pub fn is_deduplication_conflict(&self) -> bool

Return true if this is a DeduplicationConflict error.

pub fn is_retryable(&self) -> bool

Return true if this error is likely transient and safe to retry.

Provider and Persistence errors (e.g. network timeouts, I/O failures) are classified as retryable. Logic errors (Memory, Graph, Orchestration, AgentLoop, NotConfigured, Validation, CircuitOpen, BackpressureShed, DeduplicationConflict) are not.

pub fn message(&self) -> String

Extract the primary message string from this error.

For simple string-carrying variants (Memory, Graph, Orchestration, AgentLoop, Provider, Persistence) this returns the inner String. For structured variants the Display representation is returned so callers always get a non-empty, human-readable string.

Trait Implementations

impl Debug for AgentRuntimeError

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

Formats the value using the given formatter.

impl Display for AgentRuntimeError

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

Formats the value using the given formatter.

impl Error for AgentRuntimeError

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 AgentRuntimeError

fn from(e: AgentError) -> Self

Converts to this type from the input type.

impl From<Box<dyn Error + Send + Sync>> for AgentRuntimeError

fn from(e: Box<dyn Error + Send + Sync>) -> Self

Convert any boxed Send + Sync error into an AgentRuntimeError::AgentLoop.

This is a catch-all conversion that lets library users propagate arbitrary errors through ? in tool handlers and inference closures without having to manually map each error type. The error message is preserved verbatim.

impl From<Error> for AgentRuntimeError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for AgentRuntimeError

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<MemGraphError> for AgentRuntimeError

fn from(e: MemGraphError) -> Self

Converts to this type from the input type.