{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_2fu6ft3an928","handle":"codex-a2a-server","url":"https://wellknown.network/agents/codex-a2a-server","links":{"self":"https://wellknown.network/agents/codex-a2a-server/record.json","html":"https://wellknown.network/agents/codex-a2a-server","markdown":"https://wellknown.network/agents/codex-a2a-server/record.md","api":"https://wellknown.network/api/v1/agents/codex-a2a-server","status":"https://wellknown.network/api/v1/agents/codex-a2a-server/status","claim":"https://wellknown.network/agents/codex-a2a-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/codex-a2a-server/claim.json","badge":"https://wellknown.network/agents/codex-a2a-server/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::agent:codex-a2a-server","type":"application/a2a-agent-card+json"},"kind":"agent","declared":{"name":"codex-a2a-server","summary":"A2A wrapper service for codex","description":"# codex-a2a-server\n\n> Turn Codex into a stateful, production-oriented A2A agent service.\n\n`codex-a2a-server` exposes Codex through standard A2A interfaces and adds the\noperational pieces that raw agent runtimes usually do not provide by default:\nauthentication, session continuity, streaming contracts, interrupt handling,\nand documentation for running it as a service.\n\n## Why This Project Exists\n\nMost coding agents are built first as interactive tools, not as reusable\nservice endpoints. This project turns Codex into an agent service that can be\nembedded into applications, gateways, and orchestration systems without\nforcing each consumer to re-implement transport bridging, auth, or runtime\noperations.\n\nIn practice, `codex-a2a-server` acts as:\n\n- a protocol bridge from A2A to Codex\n- a security boundary around the Codex runtime\n- a stable contract layer for session, streaming, and interrupt behaviors\n\n## Vision\n\nBuild a reusable adapter layer that lets coding agents behave like service\ninfrastructure rather than local-only tools:\n\n- standard transport contracts instead of provider-specific glue\n- explicit runtime boundaries instead of ad-hoc shell wrappers\n- production-friendly runtime behavior and observability instead of demo-only setups\n\n## What It Already Provides\n\n- A2A HTTP+JSON and JSON-RPC entrypoints for Codex\n- SSE streaming with normalized `text`, `reasoning`, and `tool_call` blocks\n- session continuation and session query extensions\n- interrupt lifecycle mapping and callback validation\n- bearer-token auth, payload logging controls, and secret-handling guardrails\n- released-CLI startup and source-based runtime paths\n\n## Logical Components\n\n```mermaid\nflowchart TD\n    A[\"A2A client\"] --> B[\"FastAPI transport layer\"]\n    B --> C[\"A2A task/message mapping\"]\n    C --> D[\"Codex client adapter\"]\n    D --> E[\"Codex app-server / CLI\"]\n\n    B --> F[\"Auth and request logging\"]\n    C --> G[\"Shared contract normalization\"]\n    G --> H[\"Streaming blocks\"]\n    G --> I[\"S…","publisher":{"name":"liujuanjuan1984@Intelligent-Internet","url":null},"homepage":"https://github.com/liujuanjuan1984/codex-a2a-server","repository":"https://github.com/liujuanjuan1984/codex-a2a-server","version":"0.2.1","license":null,"protocols":["a2a"],"tags":["a2a","codex","fastapi","json-rpc","sse"],"pricing":null,"endpoints":[{"url":"pypi:codex-a2a-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"security.identity","name":"Identity & Access","confidence":0.825,"provenance":"derived"}],"categories":["security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"codex-a2a-server","registry":"pypi","observedAt":"2026-09-09T12:29:31.301Z","publishedAt":"2026-03-19T08:22:03.209931Z","latestVersion":"0.2.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"codex-a2a-server","url":"https://pypi.org/project/codex-a2a-server/","firstSeenAt":"2026-09-09T12:27:06.090Z","fetchedAt":"2026-09-09T13:19:53.702Z","normalizedAt":"2026-09-09T13:19:53.702Z"}]},"firstSeenAt":"2026-09-09T12:27:06.090Z","updatedAt":"2026-09-09T12:29:31.301Z"}