openai/codex · error · anyhow::Error

terminal end referenced unknown operation {operation_id}

Error message

terminal end referenced unknown operation {operation_id}

What it means

Error "terminal end referenced unknown operation {operation_id}" thrown in openai/codex.

Source

Thrown at codex-rs/rollout-trace/src/reducer/tool/terminal.rs:171

    ///
    /// Non-terminal tools flow through the same generic tool lifecycle, so callers
    /// may invoke this unconditionally and receive Ok for unrelated tool kinds.
    pub(in crate::reducer) fn end_terminal_operation(
        &mut self,
        seq: RawEventSeq,
        wall_time_unix_ms: i64,
        thread_id: &str,
        operation_id: &str,
        status: ExecutionStatus,
        response_payload: Option<&RawPayloadRef>,
    ) -> Result<()> {
        let Some(operation_kind) = self
            .rollout
            .terminal_operations
            .get(operation_id)
            .map(|operation| operation.kind.clone())
        else {
            bail!("terminal end referenced unknown operation {operation_id}");
        };
        let response = response_payload
            .map(|payload| {
                let value = self.read_payload_json(payload)?;
                let response = parse_terminal_response_payload(
                    value,
                    &operation_kind,
                    &payload.raw_payload_id,
                )?;
                Ok::<_, anyhow::Error>((payload.raw_payload_id.clone(), response))
            })
            .transpose()?;

        let (terminal_id, started_at_unix_ms, started_seq) = {
            let Some(operation) = self.rollout.terminal_operations.get_mut(operation_id) else {
                bail!("terminal end referenced unknown operation {operation_id}");
            };
            operation.execution.ended_at_unix_ms = Some(wall_time_unix_ms);

View on GitHub (pinned to 339751715c)

When it happens

Trigger: Thrown at codex-rs/rollout-trace/src/reducer/tool/terminal.rs:171 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of openai/codex@339751715c (2026-08-25). Data as JSON: /api/errors/089e2b25a4de204c. Report an issue: GitHub.