mirror of
https://github.com/openai/codex.git
synced 2026-10-27 18:48:37 +00:00
Add an experimental codex/events MCP capability so external servers can opt into runtime event notifications during initialize. Servers advertise the exact event types they want via capabilities.experimental["codex/events"].eventTypes, and Codex only forwards matching events to those servers. Forwarded notifications use method codex/event and preserve the existing event payload shape used by the built-in MCP server: params._meta.threadId carries the conversation/thread identifier, while the Event itself is flattened into params.id and params.msg. That keeps context metadata separate from the event body while avoiding an extra wrapper object. The core session now publishes each event to the existing tx_event channel as before, then performs best-effort fanout to the MCP connection manager. Fanout skips servers that are still starting up, ignores servers that did not subscribe to the emitted msg.type, and logs notification failures without breaking the main turn flow. Add tests for generic experimental capability detection and for loading codex/events eventTypes from the MCP initialize response, including the no-eventTypes case which intentionally subscribes to nothing.