retoor
cc1c130b51
- Agent side: --cap-manifest plus --cap-speak stream-json binding with transcript-diff frames, diff/transcript artifacts, session config - Orchestrator: PTY driver (settle heuristics on PtyProc/TuiVtScreen), stream-json, ACP-stdio (permission/elicit/fs/terminal serving) and A2A drivers (dual draft/current spelling, SSE mapping) - Sessions, fleets: worktrees, master plans, mediated routing, budget refusal, audit log, research auto-answerer, --cap CLI - cap.md contract with drift tests; research/cap-protocol archive - Suites 1119 + 16 green
48 lines
1.7 KiB
Markdown
48 lines
1.7 KiB
Markdown
# ACP transports (JSON-RPC stdio)
|
|
|
|
## Metadata
|
|
|
|
| Field | Value |
|
|
|---|---|
|
|
| Institute | Molodetz Institute — Research & Retrieval Division |
|
|
| Subject | cap-protocol |
|
|
| Document type | Source Dossier |
|
|
| Tier | 1 |
|
|
| Source title | ACP Transports |
|
|
| Source URL | https://agentclientprotocol.com/protocol/v1/transports.md |
|
|
| Source type | specification |
|
|
| Source date (published) | Unknown, not stated (living docs) |
|
|
| Date researched | 2026-10-18 |
|
|
| Researched by | tai (agent), model: Muse Spark, on behalf of retoor |
|
|
| Research method | direct page fetch, read in full (57 lines) |
|
|
| Confidence | High |
|
|
| Status | Active |
|
|
|
|
## Summary
|
|
|
|
ACP stdio: client launches agent subprocess, NDJSON JSON-RPC both ways (no embedded newlines), UTF-8, agent logs on stderr only, stdout carries nothing but ACP messages, teardown is close-stdin plus terminate.
|
|
|
|
## Key findings
|
|
|
|
- Newline-delimited JSON-RPC with no embedded newlines: tai's stdlib json + pipes implementation needs no framing layer beyond line splitting.
|
|
- stderr is log-only and MAY be ignored: tai's driver can capture it for diagnostics without protocol risk.
|
|
- Streamable HTTP is draft-only; custom transports MUST preserve JSON-RPC message format and lifecycle.
|
|
|
|
## Pros / strengths
|
|
|
|
- Minimal transport contract; a few dozen lines of stdlib implement it fully.
|
|
|
|
## Cons / limitations / caveats
|
|
|
|
- No heartbeat/keepalive specified; hung agents are detected only via timeouts tai must choose itself.
|
|
|
|
## Relevance to tai
|
|
|
|
The exact transport contract for the Phase 5 ACP-stdio driver (and its tests: NDJSON framing, stderr tolerance, close-stdin teardown).
|
|
|
|
## Changelog
|
|
|
|
| Date | Change |
|
|
|---|---|
|
|
| 2026-10-18 | Initial dossier created. |
|