Enum CodeError 

pub enum CodeError {
    Config(String),
    Llm(String),
    Tool {
        tool: String,
        message: String,
    },
    Session(String),
    SessionConfiguration {
        field: &'static str,
        message: String,
    },
    SessionInitialization {
        resource: SessionBuildResource,
        message: String,
    },
    AsyncSessionBuildRequired {
        resource: SessionBuildResource,
    },
    SessionClosed {
        session_id: String,
    },
    SessionBusy {
        session_id: String,
    },
    BudgetExhausted {
        resource: String,
        reason: String,
    },
    Security(String),
    Context(String),
    Mcp(String),
    Queue(String),
    Io(Error),
    Serialization(Error),
    Internal(Error),
}

Categorized error type for A3S Code Core.

SDK bindings (Python/Node) can match on the variant to expose typed exceptions (e.g., CodeConfigError, CodeLlmError).

Variants

Config(String)

Configuration loading or parsing error

Llm(String)

LLM provider communication error

Tool

Tool execution error

Fields

tool: String

message: String

Session(String)

Session management error

SessionConfiguration

A session option is missing, malformed, or conflicts with another option.

Fields

field: &'static str

message: String

SessionInitialization

A session resource could not be initialized.

Fields

resource: SessionBuildResource

message: String

AsyncSessionBuildRequired

The synchronous compatibility factory was asked to initialize an async-only resource. Call Agent::session_builder(...).build().await.

Fields

resource: SessionBuildResource

SessionClosed

Session has been closed; further operations are rejected.

Returned by send/stream (and their variants) after AgentSession::close — or Agent::close — has been called.

Fields

session_id: String

SessionBusy

Another conversation operation is already active on this session.

Sessions serialize conversation state, so callers must wait for the active operation’s returned future or stream handle to finish before starting another one.

Fields

session_id: String

BudgetExhausted

A host-supplied BudgetGuard denied the operation. The session is not closed — callers can re-try after the host has re-allocated budget.

Fields

resource: String

reason: String

Security(String)

Security subsystem error

Context(String)

Context provider or context store error

Mcp(String)

MCP (Model Context Protocol) error

Queue(String)

Queue or lane error

Io(Error)

I/O error

Serialization(Error)

JSON serialization/deserialization error

Internal(Error)

Catch-all for errors not yet migrated to a specific variant.

The #[from] anyhow::Error conversion enables gradual migration: any function returning anyhow::Result can be called with ? from a function returning crate::error::Result without changes.

Implementations

impl CodeError

pub const fn code(&self) -> &'static str

Stable machine-readable code for SDK and service boundaries.

Trait Implementations

impl Debug for CodeError

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

Formats the value using the given formatter.

impl Display for CodeError

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

Formats the value using the given formatter.

impl Error for CodeError

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 CodeError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for CodeError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for CodeError

fn from(source: Error) -> Self

Converts to this type from the input type.