Enum CodexErr 

pub enum CodexErr {
    TurnAborted,
    SessionBudgetExceeded,
    Stream(String, Option<Duration>),
    ContextWindowExceeded,
    ThreadNotFound(ThreadId),
    AgentLimitReached {
        max_threads: usize,
    },
    SessionConfiguredNotFirstEvent,
    Timeout,
    RequestTimeout,
    Spawn,
    Interrupted,
    UnexpectedStatus(UnexpectedResponseError),
    InvalidRequest(String),
    InvalidImageRequest(),
    UsageLimitReached(UsageLimitReachedError),
    ServerOverloaded,
    CyberPolicy {
        message: String,
    },
    ResponseStreamFailed(ResponseStreamFailed),
    ConnectionFailed(ConnectionFailedError),
    QuotaExceeded,
    UsageNotIncluded,
    InternalServerError,
    RetryLimit(RetryLimitReachedError),
    InternalAgentDied,
    Sandbox(SandboxErr),
    LandlockSandboxExecutableNotProvided,
    UnsupportedOperation(String),
    RefreshTokenFailed(RefreshTokenFailedError),
    Fatal(String),
    Io(Error),
    Json(Error),
    LandlockRuleset(RulesetError),
    LandlockPathFd(PathFdError),
    TokioJoin(JoinError),
    EnvVar(EnvVarError),
}

Variants

TurnAborted

SessionBudgetExceeded

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.

ContextWindowExceeded

ThreadNotFound(ThreadId)

AgentLimitReached

Fields

max_threads: usize

SessionConfiguredNotFirstEvent

Timeout

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

RequestTimeout

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(UnexpectedResponseError)

Unexpected HTTP status code.

InvalidRequest(String)

Invalid request.

InvalidImageRequest()

Invalid image.

UsageLimitReached(UsageLimitReachedError)

ServerOverloaded

CyberPolicy

Fields

message: String

ResponseStreamFailed(ResponseStreamFailed)

ConnectionFailed(ConnectionFailedError)

QuotaExceeded

UsageNotIncluded

InternalServerError

RetryLimit(RetryLimitReachedError)

Retry limit exceeded.

InternalAgentDied

Agent loop died unexpectedly

Sandbox(SandboxErr)

Sandbox error

LandlockSandboxExecutableNotProvided

UnsupportedOperation(String)

RefreshTokenFailed(RefreshTokenFailedError)

Fatal(String)

Io(Error)

Json(Error)

LandlockRuleset(RulesetError)

LandlockPathFd(PathFdError)

TokioJoin(JoinError)

EnvVar(EnvVarError)

Implementations

impl CodexErr

pub fn is_retryable(&self) -> bool

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.

pub fn to_codex_protocol_error(&self) -> CodexErrorInfo

Translate core error to client-facing protocol error.

pub fn to_error_event(&self, message_prefix: Option<String>) -> ErrorEvent

pub fn http_status_code_value(&self) -> Option<u16>

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<CancelErr> for CodexErr

fn from(_: CancelErr) -> 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.