cleveragents/cleveragents-core
4
0
Fork 3
Code Issues 6.0k Pull Requests 115 Actions Packages Projects Releases Wiki Activity

feat(a2a): implement A2A stdio transport for local mode #713

Closed
freemo wants to merge 3 commits from feature/m9-a2a-stdio into master
pull from: feature/m9-a2a-stdio
merge into: cleveragents:master
Conversation 6 Commits 3 Files Changed 59
+4474 -854

3 Commits

Author SHA1 Message Date
freemo 680cc8c352 feat(a2a): implement A2A stdio transport for local mode
CI / benchmark-publish (pull_request) Has been skipped
Details
CI / lint (pull_request) Successful in 15s
Details
CI / build (pull_request) Successful in 19s
Details
CI / quality (pull_request) Successful in 19s
Details
CI / security (pull_request) Successful in 36s
Details
CI / typecheck (pull_request) Successful in 38s
Details
CI / unit_tests (pull_request) Successful in 3m0s
Details
CI / integration_tests (pull_request) Successful in 3m27s
Details
CI / docker (pull_request) Successful in 41s
Details
CI / coverage (pull_request) Successful in 5m31s
Details
CI / benchmark-regression (pull_request) Successful in 35m39s
Details 
Add A2aStdioTransport class that manages subprocess lifecycle and
communicates via newline-delimited JSON-RPC 2.0 messages over
stdin/stdout. Add A2aTransport protocol (typing.Protocol) defining
the abstract transport interface. Add A2aTransportSelector that
picks A2aStdioTransport in local mode (no server URL) or
A2aHttpTransport in server mode.

New files:
- transport_protocol.py: A2aTransport Protocol
- stdio_transport.py: A2aStdioTransport with subprocess management
- transport_selector.py: A2aTransportSelector configuration-based
- echo_agent.py: Minimal echo agent fixture for tests

Tests:
- 20 Behave BDD scenarios covering protocol conformance, construction,
  subprocess lifecycle, send/receive, context manager, transport
  selector, and contract round-trip tests
- 7 Robot Framework integration tests with helper script

ISSUES CLOSED: #691
 2026-03-12 01:52:41 +00:00
freemo 33900eab03 feat(a2a): implement JSON-RPC 2.0 wire format and method routing
CI / benchmark-publish (pull_request) Has been skipped
Details
CI / lint (pull_request) Successful in 14s
Details
CI / build (pull_request) Successful in 16s
Details
CI / quality (pull_request) Successful in 18s
Details
CI / security (pull_request) Successful in 35s
Details
CI / typecheck (pull_request) Successful in 55s
Details
CI / unit_tests (pull_request) Successful in 2m57s
Details
CI / integration_tests (pull_request) Successful in 3m23s
Details
CI / docker (pull_request) Successful in 41s
Details
CI / coverage (pull_request) Successful in 5m36s
Details
CI / benchmark-regression (pull_request) Successful in 35m11s
Details 
Implement the JSON-RPC 2.0 wire format layer and method routing for the
A2A protocol, building on the ACP-to-A2A rename from #688.

New modules in src/cleveragents/a2a/:
- jsonrpc_models.py: Pydantic v2 models for JSON-RPC 2.0 request,
  response, error, and notification envelopes
- jsonrpc_router.py: Method router that dispatches JSON-RPC requests
  to registered handlers, with support for standard A2A methods and
  _cleveragents/ extension methods
- jsonrpc_handlers.py: Handlers for standard A2A methods (message/send,
  message/stream, tasks/get, tasks/cancel) and extension method factory
  that delegates to A2aLocalFacade
- jsonrpc_errors.py: Maps domain error taxonomy to JSON-RPC 2.0 error
  codes (standard -32700 to -32603, application -32001 to -32008)
- agent_card.py: Agent Card model and generation for the
  /.well-known/agent.json capability advertisement endpoint

Standard A2A methods:
- message/send: Create/update tasks via messages
- message/stream: Streaming variant with SSE event indicators
- tasks/get: Retrieve task by ID
- tasks/cancel: Cancel running tasks

CleverAgents extension methods (_cleveragents/ prefix):
- plan/use, execute, status, diff, apply, cancel
- registry/list_tools, list_resources
- context/show
- sync/status
- namespace/list
- health

Tests:
- Behave BDD: features/a2a_jsonrpc.feature (28 scenarios)
- Robot Framework: robot/a2a_jsonrpc.robot (9 integration tests)

ISSUES CLOSED: #690
 2026-03-12 01:00:37 +00:00
freemo 2fe95d1b38 refactor(a2a): rename ACP module and symbols to A2A standard
CI / benchmark-publish (pull_request) Has been skipped
Details
CI / lint (pull_request) Successful in 20s
Details
CI / build (pull_request) Successful in 16s
Details
CI / quality (pull_request) Successful in 35s
Details
CI / security (pull_request) Successful in 47s
Details
CI / typecheck (pull_request) Successful in 1m37s
Details
CI / integration_tests (pull_request) Successful in 3m38s
Details
CI / unit_tests (pull_request) Successful in 4m44s
Details
CI / docker (pull_request) Successful in 1m6s
Details
CI / coverage (pull_request) Successful in 5m30s
Details
CI / benchmark-regression (pull_request) Successful in 35m37s
Details 
Renamed src/cleveragents/acp/ to src/cleveragents/a2a/ and all 13
Acp* classes to A2a* per ADR-047 (A2A Standard Adoption). Updated
all imports, structlog event names (acp.* → a2a.*), field names
(acp_version → a2a_version), and test references across the entire
codebase. This is a cosmetic rename only — no behavioral changes.

ISSUES CLOSED: #688
 2026-03-11 22:10:25 +00:00