Enum Error 

pub enum Error {
    Json(Error),
    Io(Error),
    Protocol(String),
    ConnectionClosed,
    Deserialization(String),
    ProcessFailed(i32, String),
    JsonRpc {
        code: i64,
        message: String,
    },
    ServerClosed,
    BinaryNotFound {
        name: String,
    },
    Unknown(String),
}

All possible errors from codex-codes operations.

Variants

Json(Error)

JSON serialization or deserialization failed.

Returned when request parameters can’t be serialized or response payloads don’t match expected types.

Io(Error)

An I/O error occurred communicating with the app-server process.

Common causes: process not found, pipe broken, permission denied.

Protocol(String)

A protocol-level error (e.g., missing stdin/stdout pipes).

ConnectionClosed

The app-server connection was closed unexpectedly.

Deserialization(String)

A message from the server could not be deserialized.

Includes the raw message text for debugging. If you encounter this, please report it — it likely indicates a protocol change.

ProcessFailed(i32, String)

The app-server process exited with a non-zero status.

JsonRpc

The server returned a JSON-RPC error response.

Contains the error code and message from the server. See the Codex CLI docs for error code meanings.

Fields

code: i64

message: String

ServerClosed

The server closed the connection (EOF on stdout).

Returned by request() if the server exits mid-conversation.

BinaryNotFound

The CLI binary could not be found on PATH.

Fields

name: String

Unknown(String)

An unclassified error.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.