[Feat]: feat(transport): add stdio transport to run A2A protocol over process pipes
Maintainers usually reply within 2 days
@muscariello is already working on this.
Since Oct 31, 2025.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 35/100
Research direction
Look at the existing transport implementations (likely HTTP, gRPC) in the SDK's transport module. Understand the ClientTransport interface and the A2A protocol's JSON-RPC message format. The work involves creating a new transport class that manages a child process, reads/writes line-delimited JSON over stdin/stdout, and integrates with the existing request/response and event streaming logic. Testing will require spawning an agent process with a --stdio flag.
Written by the indexing model from the issue text.
Description
Is your feature request related to a problem? Please describe.
Support a2a protocol over stdio in the Python SDK.
Describe the solution you'd like
A stdio transport for A2A lets the Python client speak the existing A2A protocol directly over a spawned process’s stdin/stdout instead of HTTP or gRPC, enabling fully local, port‑less, hermetic agent execution. The SDK would launch an agent (or model/runtime) with a --stdio flag, exchange line‑delimited JSON-RPC messages, and multiplex streaming task events through a single reader loop that dispatches responses and updates by request ID. This approach reduces overhead and dependencies (no network stack), improves security by narrowing exposure to a private child process, and unlocks embedding scenarios (CI, plugins, air‑gapped systems) while preserving the current ClientTransport interface, interceptors, telemetry, and error semantics.
Describe alternatives you've considered
No response
Additional context
No response
Code of Conduct
- I agree to follow this project's Code of Conduct
- Dominant language
- Python
- Stars
- 2.2k
- Forks
- 540
- Avg merge
- 2d 10h
- Merged PRs (30d)
- 57
Getting set up
- No Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from a2aproject/a2a-python
-
[Bug]: REST task/request id sanitizationMay be free again A pull request for this issue was closed without being merged. Openmaintainers-only
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
a2aproject/a2a-python#805 · 1 comment ·
Maintainers usually reply within 2 days
-
[Bug]: v0.3 JSON-RPC `tasks/pushNotificationConfig/delete` succeeds with no `result` memberPossibly taken @rohityan claimed this today. Open
a2aproject/a2a-python#1480 · 2 assignees ·
Maintainers usually reply within 2 days
-
[Bug]: A2ACardResolver.get_agent_card raises UnicodeDecodeError and RecursionError instead of AgentCardResolutionErrorPossibly taken @rohityan claimed this 1 day ago. Open
a2aproject/a2a-python#1478 · 2 assignees ·
Maintainers usually reply within 2 days
-
[Bug]: JSON-RPC client ignores the JSON-RPC error body when the HTTP status is not 2xxPossibly taken @rohityan claimed this 1 day ago. Open
a2aproject/a2a-python#1475 · 1 assignee ·
Maintainers usually reply within 2 days
-
[Feat]: validate_input_modes: match media ranges such as image/* declared in the agent cardPossibly taken @rohityan claimed this 3 days ago. Opencomponent: core status:awaiting response
a2aproject/a2a-python#1468 · 1 comment · 1 assignee ·
Maintainers usually reply within 2 days
All issues in a2aproject/a2a-python
Similar issues
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 77/100
canonical/paas-charm#407 · 1 comment ·
Maintainers usually reply within 5 days
-
bug
Difficulty 1/5 Under an hour Newbie friendliness 90/100
FAIRmat-NFDI/pynxtools-spm#136 ·
Maintainers usually reply within 1 day
-
enhancement tooling
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
Maintainers usually reply within 1 day
-
`read_nexus` entry point points to a function that no longer existsPossibly taken @RubelMozumder claimed this today. Openannotator bug
Difficulty 1/5 Under an hour Newbie friendliness 88/100
FAIRmat-NFDI/pynxtools#876 · 1 comment ·
Maintainers usually reply within 1 day
-
[Bug]: HTTP 499 (Client Closed Request) is classified as a non-retryable format_error, so a mid-flight abort fails the turn over instead of retryingPossibly taken @yipinghuang1991 claimed this today. Opencomp/agent P2 type/bug
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
NousResearch/hermes-agent#156837 ·
Maintainers usually reply within 1 day