Enum CodexErr 

pub enum CodexErr {
    Stream(String, Option<Duration>),
    ConversationNotFound(Uuid),
    SessionConfiguredNotFirstEvent,
    Timeout,
    Spawn,
    Interrupted,
    UnexpectedStatus(StatusCode, String),
    UsageLimitReached(UsageLimitReachedError),
    UsageNotIncluded,
    InternalServerError,
    RetryLimit(StatusCode),
    InternalAgentDied,
    Sandbox(SandboxErr),
    LandlockSandboxExecutableNotProvided,
    Io(Error),
    Reqwest(Error),
    Json(Error),
    LandlockRuleset(RulesetError),
    LandlockPathFd(PathFdError),
    TokioJoin(JoinError),
    EnvVar(EnvVarError),
    McpServer(String),
    McpClientStart {
        server: String,
        error: String,
    },
    McpToolNotFound(String),
    InvalidConfig(String),
    InvalidWorkingDirectory(String),
    ModeRestriction(String),
    NoBranchPointAvailable,
    NoCurrentStateForCheckpoint,
    SnapshotNotFound(Uuid),
    BranchNotFound(Uuid),
    UndoStackEmpty,
    RedoStackEmpty,
    MemoryLimitExceeded {
        current: usize,
        limit: usize,
    },
    General(String),
}

Variants

Stream(String, Option<Duration>)

Returned by ResponsesClient when the SSE stream disconnects or errors out after the HTTP handshake has succeeded but before it finished emitting response.completed.

The Session loop treats this as a transient error and will automatically retry the turn.

Optionally includes the requested delay before retrying the turn.

ConversationNotFound(Uuid)

SessionConfiguredNotFirstEvent

Timeout

Returned by run_command_stream when the spawned child process timed out (10s).

Spawn

Returned by run_command_stream when the child could not be spawned (its stdout/stderr pipes could not be captured). Analogous to the previous CodexError::Spawn variant.

Interrupted

Returned by run_command_stream when the user pressed Ctrl‑C (SIGINT). Session uses this to surface a polite FunctionCallOutput back to the model instead of crashing the CLI.

UnexpectedStatus(StatusCode, String)

Unexpected HTTP status code.

UsageLimitReached(UsageLimitReachedError)

UsageNotIncluded

InternalServerError

RetryLimit(StatusCode)

Retry limit exceeded.

InternalAgentDied

Agent loop died unexpectedly

Sandbox(SandboxErr)

Sandbox error

LandlockSandboxExecutableNotProvided

Io(Error)

Reqwest(Error)

Json(Error)

LandlockRuleset(RulesetError)

LandlockPathFd(PathFdError)

TokioJoin(JoinError)

EnvVar(EnvVarError)

McpServer(String)

McpClientStart

Fields

server: String

error: String

McpToolNotFound(String)

InvalidConfig(String)

InvalidWorkingDirectory(String)

ModeRestriction(String)

NoBranchPointAvailable

NoCurrentStateForCheckpoint

SnapshotNotFound(Uuid)

BranchNotFound(Uuid)

UndoStackEmpty

RedoStackEmpty

MemoryLimitExceeded

Fields

current: usize

limit: usize

General(String)

Implementations

impl CodexErr

pub fn downcast_ref<T: Any>(&self) -> Option<&T>

Minimal shim so that existing e.downcast_ref::<CodexErr>() checks continue to compile after replacing anyhow::Error in the return signature. This mirrors the behavior of anyhow::Error::downcast_ref but works directly on our concrete enum.

Trait Implementations

impl Debug for CodexErr

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

Formats the value using the given formatter.

impl Display for CodexErr

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

Formats the value using the given formatter.

impl Error for CodexErr

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 CodexErr

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for CodexErr

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for CodexErr

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<JoinError> for CodexErr

fn from(source: JoinError) -> Self

Converts to this type from the input type.

impl From<PathFdError> for CodexErr

fn from(source: PathFdError) -> Self

Converts to this type from the input type.

impl From<RulesetError> for CodexErr

fn from(source: RulesetError) -> Self

Converts to this type from the input type.

impl From<SandboxErr> for CodexErr

fn from(source: SandboxErr) -> Self

Converts to this type from the input type.