Release notes

FEATURE

Add configurable grace period for optional MCP server tool discovery

When connecting to optional MCP (Model Context Protocol) servers, tool discovery will no longer fail immediately if an external tool takes a moment to respond. Codex introduces a configurable grace period for discovering tools from optional MCP servers. This gives background or remote servers enough time to complete initialization and register their tools.

FEATURE

Extensions can inspect or replace MCP tool results before reaching the model

Developers who need to sanitize tool outputs or adjust formats can now intercept data directly in the pipeline. Extensions can now inspect or replace MCP (Model Context Protocol) tool execution results before they are delivered to the model. This allows custom logic to filter out sensitive data or rewrite payload structures before the model processes them.

FEATURE

Plugin catalogs combine repository configs and report invalid marketplaces

Managing plugin sources across projects is now much more reliable. Plugin catalogs now combine per-repository configuration into their listings. Furthermore, when a project contains an invalid marketplace, the system reports the issue clearly without hiding the remaining valid plugins. You can troubleshoot broken marketplace links while continuing to use all working extensions.

FEATURE

Preserve restored permission profiles in TUI and prevent /cd sandbox weakening

Security consistency in the terminal interface is now reinforced. Restored permission profiles are properly preserved across turns in the TUI (terminal user interface). Switching directories using the /cd command is strictly prevented from loosening or bypassing active sandbox restrictions, keeping execution boundaries intact.

FEATURE

Keep tool availability and reasoning effort correct across model switches and fallbacks

Switching models mid-task no longer disrupts tool setups or reasoning levels. When you manually switch models or trigger a fallback to an alternative model, Codex now keeps tool availability and reasoning effort aligned with the target model. This prevents tools from vanishing unexpectedly and ensures reasoning parameters remain valid for the active provider.

FEATURE

Improve remote sandbox enforcement using actual executor environment details

Running commands in remote environments now benefits from accurate isolation boundaries. Remote sandbox enforcement now aligns with the executor's actual home directory, operating system, and path conventions. This eliminates authorization discrepancies caused by mismatched path separators, root structures, or platform conventions between local and remote hosts.

FEATURE

Preserve structured MCP tool and resource errors in app-server responses

When external services encounter issues, app-server responses now preserve structured MCP (Model Context Protocol) tool and resource errors. Rather than flattening error responses into plain text strings, the system keeps structured fields intact so client applications and developers can programmatically handle failures and identify root causes.

FEATURE

Count nested subagent token usage toward root goal budgets

Budget tracking across multi-agent workflows is now strictly enforced. When a primary task delegates work to nested subagents across multiple tiers, token consumption from every child agent is counted toward the root goal budget. This prevents deep subagent branches from silently exceeding the project token allocation.

FEATURE

Prevent stale Guardian classifications from authorizing actions after permission changes

Security enforcement now reacts instantly whenever authorization rules change. Previously cached classifications from Guardian (the security component that categorizes action risks) are no longer used after permission states change. The system invalidates stale classification data immediately upon permission updates, ensuring that outdated approvals cannot authorize new actions after permission state changes.

FEATURE

Add telemetry for escalated stdin reviews and remote executor MCP discovery

Observability into security reviews and remote connections is now expanded. Codex introduces dedicated telemetry tracking for escalated stdin reviews whenever interactive input requires elevated approval. It also logs remote executor MCP (Model Context Protocol) discovery events, giving maintainers clearer visibility into tool registration flows.

BUGFIX

Stabilize Guardian WebSocket and core fixture tests in slow or concurrent CI

Guardian WebSocket connections and core fixture tests now run reliably under high load or network latency. Guardian WebSocket connections and core test fixtures have been hardened against timing issues. Even when test suites run on slow CI (continuous integration) runners or under heavy concurrency, core fixture tests complete predictably without false alarms.

Original changelog

Original changelogAdd configurable grace period for optional MCP server tool discovery
Added a configurable grace period for discovering tools from optional MCP servers. (#41199)
Original changelogExtensions can inspect or replace MCP tool results before reaching the model
Extensions can now inspect or replace MCP tool results before they reach the model. (#41202)
Original changelogPlugin catalogs combine repository configs and report invalid marketplaces
Plugin catalogs now combine per-repository configuration and report invalid project marketplaces without hiding valid plugins. (#41208)
Original changelogPreserve restored permission profiles in TUI and prevent /cd sandbox weakening
Preserved restored permission profiles across TUI turns and prevented `/cd` from weakening sandbox restrictions. (#41192)
Original changelogKeep tool availability and reasoning effort correct across model switches and fallbacks
Kept tool availability and reasoning effort correct when switching models or falling back to another model. (#41195, #41206)
Original changelogImprove remote sandbox enforcement using actual executor environment details
Improved remote sandbox enforcement using the executor’s actual home directory, operating system, and path conventions. (#41196, #41204, #41207, #41209)
Original changelogPreserve structured MCP tool and resource errors in app-server responses
Preserved structured MCP tool and resource errors in app-server responses. (#41196)
Original changelogCount nested subagent token usage toward root goal budgets
Counted nested subagent token usage toward root goal budgets. (#41183)
Original changelogPrevent stale Guardian classifications from authorizing actions after permission changes
Prevented stale Guardian classifications from authorizing actions after permission state changes. (#41196)
Original changelogAdd telemetry for escalated stdin reviews and remote executor MCP discovery
Added telemetry for escalated stdin reviews and remote executor MCP discovery. (#41189, #41205)
Original changelogStabilize Guardian WebSocket and core fixture tests in slow or concurrent CI
Stabilized Guardian WebSocket and core fixture tests under slow or highly concurrent CI. (#41191, #41194)