Enum CodexAskError 

pub enum CodexAskError {
    NotFound,
    NoSessionId {
        types_seen: Vec<String>,
    },
    TeeOpen {
        message: String,
    },
    Timeout {
        timeout_sec: f64,
    },
    Invocation {
        exit_code: i32,
        message: String,
    },
    SigkillEscalated {
        partial_exit_code: i32,
    },
    OsError {
        message: String,
    },
    Interrupted,
}

Errors from the codex ask path. Each variant maps to a specific Python- compatible exit code.

Variants

NotFound

codex binary not found (FileNotFoundError) — exit 127.

NoSessionId

JSONL stream ended without a thread.started event — exit 11. types_seen carries the observed event types for forensics (LD14).

Fields

types_seen: Vec<String>

TeeOpen

Cannot open the output.jsonl tee (EACCES/ENOSPC/etc.) — exit 12.

Fields

message: String

Timeout

Wall-clock timeout — exit 15.

Fields

timeout_sec: f64

Invocation

codex exited non-zero and no reply was captured — exit = exit_code. Also used for other OSError at spawn time — exit 1.

Fields

exit_code: i32

message: String

SigkillEscalated

SIGKILL escalation during reap — always exit 1 regardless of exit_code. A partial reply + SIGKILL is never a success (Python silent-failure-hunter row 4).

Fields

partial_exit_code: i32

OsError

Non-transient OSError at Popen time (not NotFound) — exit 1.

Fields

message: String

Interrupted

Operator SIGINT (Ctrl-C) forwarded to the codex group — exit 130. Mirrors Python’s KeyboardInterrupt -> CPython exit 130 (ab-e7fdbcb6).

Implementations

impl CodexAskError

pub fn exit_code(&self) -> i32

Python-compatible exit code for this error.

NotFound maps to 14 (“provider unavailable”) directly here, mirroring Python’s dispatch.py mapping of CodexInvocationError(127) -> dispatch_create’s select_provider -> 14. Centralizing the remap on the error type means both dispatch paths (create and resume) see the same final exit code (sigma-review type-design HIGH: previously only dispatch_create carried the inline if exit_code == 127 { 14 } remap; dispatch_resume would have leaked 127 for the same error). SigkillEscalated carries the partial exit code so a SIGKILL’d codex that exited with codex-reported non-zero before the signal preserves that code (matches codex.py:524 silent-failure-hunter row 4).

Trait Implementations

impl Debug for CodexAskError

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

Formats the value using the given formatter.

impl Display for CodexAskError

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

Formats the value using the given formatter.

impl Error for CodexAskError

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.