Codex System Handbook

Core end-to-end session, transport, tool, and feature suites

stage-23.2.485 files

This stage is a large end-to-end test area for Codex’s live user sessions. It checks the main work loop and the shared support around it: sending requests to AI models, receiving streamed replies, remembering conversation state, choosing models, using tools, asking for approvals, and working with helper agents or remote machines.

The transport suites test the “wires” to model providers, including HTTP, WebSocket, realtime, retries, headers, quotas, and streamed responses. The history and persistence suites test Codex’s memory: saving sessions, compacting long chats, resuming, forking, and restoring tool logs. The prompt and model-selection suites check that each model request is packed with the right instructions, context, tools, and limits. The multi-agent suites test child agents, delegation, shared limits, job queues, and remote environments. The approvals and hooks suites test safety gates that pause, block, review, or modify actions. The tool and runtime item suites test shell commands, patches, plugins, external app tools, images, searches, and the user-visible event stream. Together, these tests prove the whole session behaves safely and predictably.

Sub-stages