codex-a2a-server

# codex-a2a-server > Turn Codex into a stateful, production-oriented A2A agent service. `codex-a2a-server` exposes Codex through standard A2A interfaces and adds the operational pieces that raw agent runtimes usually do not provide by default: authentication, session continuity, streaming contracts, interrupt handling, and documentation for running it as a service. ## Why This Project Exists Most coding agents are built first as interactive tools, not as reusable service endpoints. This project turns Codex into an agent service that can be embedded into applications, gateways, and orchestration systems without forcing each consumer to re-implement transport bridging, auth, or runtime operations. In practice, `codex-a2a-server` acts as: - a protocol bridge from A2A to Codex - a security boundary around the Codex runtime - a stable contract layer for session, streaming, and interrupt behaviors ## Vision Build a reusable adapter layer that lets coding agents behave like service infrastructure rather than local-only tools: - standard transport contracts instead of provider-specific glue - explicit runtime boundaries instead of ad-hoc shell wrappers - production-friendly runtime behavior and observability instead of demo-only setups ## What It Already Provides - A2A HTTP+JSON and JSON-RPC entrypoints for Codex - SSE streaming with normalized `text`, `reasoning`, and `tool_call` blocks - session continuation and session query extensions - interrupt lifecycle mapping and callback validation - bearer-token auth, payload logging controls, and secret-handling guardrails - released-CLI startup and source-based runtime paths ## Logical Components ```mermaid flowchart TD A["A2A client"] --> B["FastAPI transport layer"] B --> C["A2A task/message mapping"] C --> D["Codex client adapter"] D --> E["Codex app-server / CLI"] B --> F["Auth and request logging"] C --> G["Shared contract normalization"] G --> H["Streaming blocks"] G --> I["S…