v0.4.0

Overview

v0.4.0 makes codex-a2a substantially more production-ready. This release adds a fuller client integration layer, introduces database-backed persistence for tasks and runtime state, and removes several sources of operational ambiguity around long-lived sessions.

Highlights

• Added a more complete A2A client integration path for upstream and embedded runtime scenarios
• Introduced database-backed persistence for tasks, runtime state, and interrupt/session recovery flows
• Decoupled persisted session continuity from in-memory cache TTL so database-backed deployments behave predictably across restarts
• Updated CI and publish workflows to use Node 24 compatible GitHub Actions

Capabilities

Client and Runtime Integration

• The client integration layer is more complete and hardened, making upstream Codex-backed flows easier to operate end to end
• Internal boundaries were tightened so transport, runtime, and client responsibilities are cleaner and easier to evolve

Persistence and Session Continuity

• Tasks and runtime state can now be stored in a database instead of living only in process memory
• Session binding and related persisted state now survive restarts without being coupled to the in-memory cache TTL model
• Interrupt-related persistence paths were hardened to better support recovery-oriented flows

Documentation and Operations

• README and capability documentation were refreshed to better explain architecture and runtime behavior
• GitHub Actions workflows were updated to remove Node 20 deprecation noise and align with current action runtimes

Full Changelog

v0.3.0...v0.4.0

v0.3.0

Overview

v0.3.0 is a consolidation release. It turns the service from an early working runtime into a cleaner, more coherent codex-a2a package with sharper capability contracts, stronger interrupt semantics, and a more intentional project layout.

Highlights

• Unified interrupt and capability contracts so SDK, transport, and runtime behavior line up more cleanly
• Improved stream keepalive behavior and tightened engineering hygiene across typing, docs, and module boundaries
• Renamed the package and CLI from codex-a2a-server to codex-a2a to better match the actual product surface

Capabilities

Runtime Contract Convergence

• Capability publication, profile semantics, and output contracts are more consistent across the Agent Card, transport layer, and runtime-facing APIs
• Interrupt metadata and asked-details handling were aligned so clients and hubs have a clearer contract to integrate against

Engineering and Runtime Clarity

• Source layout was reorganized around responsibility boundaries rather than historical layering
• Stream keepalive behavior is more explicit, helping long-lived SSE flows behave more predictably
• Mypy coverage and repository hygiene were tightened to reduce ambiguity in ongoing development

Full Changelog

v0.2.1...v0.3.0

v0.2.1

Overview

v0.2.1 is a focused follow-up release that trims unnecessary surface area and sharpens the runtime startup path after the broader v0.2.0 contract and operations work.

Highlights

• Removed dead code to reduce maintenance noise and keep the runtime easier to reason about
• Narrowed the package to the actual runtime startup responsibilities instead of carrying thin or ambiguous wrappers

Full Changelog

v0.2.0...v0.2.1

v0.2.0

Overview

v0.2.0 turns the initial v0.1.0 service baseline into a clearer and more production-oriented Codex A2A runtime. This release focuses on sharper client-facing contracts, safer deploy behavior, stronger auth boundaries, and better observability around streams, sessions, and interrupts.

Highlights

• Clearer A2A capability contracts through explicit wire-contract and compatibility-profile publication
• More consistent session-query behavior with aligned pagination semantics and cleaner method result contracts
• Safer deployment operations with release-oriented entrypoints, friendlier sudo handling, and authenticated health probes
• Better runtime diagnostics through correlation IDs, lightweight stream metrics, and idle-stream troubleshooting hooks
• Stronger request and session ownership boundaries with hashed bearer identity propagation and tighter cancel/session guard behavior

Capabilities

Runtime Contract Clarity

• Agent Card and OpenAPI now expose a clearer machine-readable contract for supported methods, extensions, and compatibility expectations
• Unsupported JSON-RPC methods are described more explicitly for stricter clients and hubs
• Session-query contract shape is more self-consistent, including pagination behavior and method-level result definitions

Streaming, Sessions, and Interrupt Operations

• Streaming internals were split and hardened to make stream orchestration easier to reason about and debug
• Lightweight metrics and idle diagnostics improve visibility into stream health during development and operations
• Session ownership, cancellation, and interrupt-related flows were tightened to reduce ambiguity around long-lived interactions

Deployment and Security Posture

• The deployment path is more clearly aligned with published releases rather than source-only assumptions
• /health is now treated as an authenticated operational endpoint, with deploy probes updated accordingly
• Request context now carries a hashed bearer-derived identity to support safer ownership and audit-oriented behavior without exposing raw tokens

Full Changelog

v0.1.0...v0.2.0

v0.1.0

Overview

v0.1.0 is the first public release of codex-a2a-server: an A2A-facing service layer for Codex with session continuity, normalized streaming, interrupt-aware interaction flow, and deployable runtime boundaries.

Highlights

• A2A gateway for Codex over both HTTP+JSON and JSON-RPC
• Normalized streaming output for text, reasoning, and tool_call blocks
• Session continuity and Codex session query/control extensions for stateful workflows
• Interrupt-aware task handling for permission and question-style interactions
• Safer deployment baseline with bearer auth, logging controls, and systemd automation
• Release-ready packaging with PyPI distribution and uv tool install support

Capabilities

Agent Runtime Interop

• Standard A2A transport support over HTTP+JSON and JSON-RPC
• Task send, stream, cancel, and subscription flows mapped onto Codex runtime behavior
• Agent Card and extension contracts for session binding, stream hints, interrupts, and provider-facing runtime metadata

Stateful Sessions and Streaming

• Session reuse through shared metadata and explicit session query extensions
• Stream normalization for text, reasoning, and tool_call event blocks
• Better consistency hardening around fanout, task lifecycle, and upstream event handling

Deployment and Operations

• Bearer-protected A2A service boundary with safer payload logging controls
• Repository scripts for initialization, managed deployment, and long-running systemd instances
• PyPI-published CLI distribution for release-based install and upgrade flows

Full Changelog

https://github.com/liujuanjuan1984/codex-a2a-server/commits/v0.1.0