Enum AcpError 

pub enum AcpError {
    Transport(String),
    ClientError(String),
    CapabilityUnavailable(String),
    ChannelClosed,
    TerminalTimeout {
        output: String,
    },
    StdinTooLarge {
        size: usize,
    },
    BrokenPipe,
    ResourceLink(String),
}

Errors produced by the ACP server and its subsystems.

Each variant corresponds to a distinct failure domain so callers can handle or propagate them appropriately.

Examples

use zeph_acp::AcpError;

let err = AcpError::Transport("connection reset".to_owned());
assert!(err.to_string().contains("transport error"));

let err = AcpError::TerminalTimeout { output: "partial".to_owned() };
assert!(err.to_string().contains("timed out"));

Variants

Transport(String)

The underlying JSON-RPC transport (stdio, HTTP, WebSocket) encountered an I/O error.

ClientError(String)

The connected IDE returned a protocol-level error response.

CapabilityUnavailable(String)

The IDE did not advertise the required ACP capability.

ChannelClosed

The internal async channel between the agent loop and the ACP handler was dropped.

This typically means the session has already terminated.

TerminalTimeout

A terminal command did not complete within the configured timeout.

output contains whatever the terminal produced before the timeout.

Fields

output: String

StdinTooLarge

The stdin data payload exceeds the 64 KiB limit.

Fields

size: usize

BrokenPipe

The terminal’s stdin channel was closed by the IDE before the write completed.

ResourceLink(String)

A ResourceLink URI could not be resolved (bad scheme, path traversal, SSRF, etc.).

Trait Implementations

impl Debug for AcpError

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

Formats the value using the given formatter.

impl Display for AcpError

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

Formats the value using the given formatter.

impl Error for AcpError

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.