Enum AgentClientError 

pub enum AgentClientError {
    Connect {
        path: PathBuf,
        source: Error,
    },
    Handshake(String),
    SandboxNotFound(String),
    InvalidSandboxName(String),
    Io(Error),
    WebSocket(String),
    Protocol(ProtocolError),
    Cbor(String),
    InvalidPacket(String),
    UnsupportedOperation {
        msg_type: &'static str,
        needs: u8,
        peer: u8,
    },
    ReaderClosed(u32),
    Closed,
    IdRangeExhausted,
    NotImplemented(&'static str),
}

Errors raised by AgentClient.

Variants

Connect

Failed to open the Unix socket connection to the relay.

Fields

path: PathBuf

Socket path that was attempted.

source: Error

Underlying I/O error.

Handshake(String)

Handshake with the relay failed (timeout, EOF, or malformed frame).

SandboxNotFound(String)

Sandbox name could not be resolved to an agent socket path.

InvalidSandboxName(String)

Sandbox name failed SDK validation before socket resolution.

Io(Error)

An I/O error occurred on the socket after connect.

WebSocket(String)

A WebSocket transport error occurred.

Protocol(ProtocolError)

A wire-protocol error (framing, CBOR, oversize frame).

Cbor(String)

CBOR encoding or decoding failed.

InvalidPacket(String)

The supplied packet did not contain exactly one complete transport frame.

UnsupportedOperation

The connected sandbox’s runtime is older than the requested feature needs.

Raised before any bytes go out, so a feature the runtime is too old to handle fails on its own without disturbing the rest of the session. Restarting the sandbox re-provisions agentd at the current version, which is the fix. See VERSIONING.md in microsandbox-protocol.

Fields

msg_type: &'static str

Wire name of the message type that was gated.

needs: u8

Generation the message type was introduced in.

peer: u8

Generation negotiated with the connected sandbox.

ReaderClosed(u32)

The reader task closed (socket EOF or client closed) before the in-flight request received its response.

Closed

The client has been closed.

IdRangeExhausted

The relay-assigned correlation ID range has no available IDs.

NotImplemented(&'static str)

The operation is not implemented yet.

Trait Implementations

impl Debug for AgentClientError

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

Formats the value using the given formatter.

impl Display for AgentClientError

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

Formats the value using the given formatter.

impl Error for AgentClientError

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 AgentClientError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ProtocolError> for AgentClientError

fn from(source: ProtocolError) -> Self

Converts to this type from the input type.