Implement or drive the Agent Client Protocol (ACP) in any TypeScript repo via two paths. (1) BUILD a full ACP client/host when you need live streaming into your own UI — the NDJSON/JSON-RPC stdio transport, bidirectional request/notification routing, the session/prompt turn lifecycle, streaming session/update content blocks, client-side handlers (fs, terminal, permissions, elicitation), subprocess spawn plus process-group cleanup plus orphan reaping, per-agent quirks, and forwarding the agent stream to a browser (the SSE streaming problem) — includes a dependency-free runnable reference implementation. (2) SHELL OUT to the acpx CLI when you do not care about live streaming and just want a fast, headless, scriptable, CI agent run (prompt in, result out, no logs, with sessions, permissions, and auth already handled). USE THIS whenever wiring or driving an ACP agent (Claude, Codex, Cursor, OpenCode, Gemini, Qwen, Droid, etc.) from a TS or Node app, building an ACP client/host, running agents headlessly via acpx,
2026-06-05