Enum AgentError 

pub enum AgentError {
    SessionNotFound(String),
    SessionAlreadyExists(String),
    SessionClosed(String),
    NotConnected,
    ConnectionFailed(String),
    ConnectionTimeout(u64),
    AlreadyConnected,
    AuthRequired,
    InvalidApiKey,
    InvalidMode(String),
    EmptyPrompt,
    PromptTooLong {
        length: usize,
        max: usize,
    },
    StreamingError(String),
    NotificationFailed(String),
    ToolExecutionFailed(String),
    ToolNotFound(String),
    ToolPermissionDenied(String),
    ConfigError(String),
    MissingConfig(String),
    ClaudeSdk(ClaudeError),
    Io(Error),
    Json(Error),
    Internal(String),
    Cancelled,
}

Main error type for the ACP Agent

Variants

SessionNotFound(String)

Session not found

SessionAlreadyExists(String)

Session already exists

SessionClosed(String)

Session is closed

NotConnected

Client not connected

ConnectionFailed(String)

Connection failed

ConnectionTimeout(u64)

Connection timeout

AlreadyConnected

Already connected

AuthRequired

Authentication required

InvalidApiKey

Invalid API key

InvalidMode(String)

Invalid mode

EmptyPrompt

Empty prompt

PromptTooLong

Prompt too long

Fields

length: usize

max: usize

StreamingError(String)

Streaming error

NotificationFailed(String)

Notification send failed

ToolExecutionFailed(String)

Tool execution failed

ToolNotFound(String)

Tool not found

ToolPermissionDenied(String)

Tool permission denied

ConfigError(String)

Configuration error

MissingConfig(String)

Missing required configuration

ClaudeSdk(ClaudeError)

Claude SDK error

Io(Error)

IO error

Json(Error)

JSON error

Internal(String)

Internal error

Cancelled

Cancelled

Implementations

impl AgentError

pub fn error_code(&self) -> ErrorCode

Get the ACP error code for this error

pub fn is_retryable(&self) -> bool

Check if this error is retryable

pub fn is_client_error(&self) -> bool

Check if this error is a client error (caused by invalid input)

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

Create an internal error

pub fn session_not_found(session_id: impl Into<String>) -> Self

Create a session not found error

pub fn session_already_exists(session_id: impl Into<String>) -> Self

Create a session already exists error

pub fn invalid_mode(mode: impl Into<String>) -> Self

Create an invalid mode error

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

Create a tool execution failed error

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

Create a connection failed error

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

Create a streaming error

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

Create a notification failed error

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

Create a configuration error

pub fn missing_config(key: impl Into<String>) -> Self

Create a missing config error

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

fn trace_error(&self) -> &Self

Log error with full context including error code, retryable status, and error chain

impl From<ClaudeError> for AgentError

fn from(source: ClaudeError) -> Self

Converts to this type from the input type.

impl From<Error> for AgentError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for AgentError

fn from(source: Error) -> Self

Converts to this type from the input type.