feat(acp): browser control via MCP-over-ACP + stdio bridge (Phase 2)#1447

Draft

brettchien wants to merge 48 commits into

openabdev:mainfrom

brettchien:feat/acp-mcp-browser

Commits on Jul 24, 2026

docs(acp): add MCP-over-ACP browser-control implementation blueprint (§7)

brettchien
and
claude
committed
docs(adr): resolve MCP-over-ACP browser-control design (D1-D4) + flow diagrams

brettchien
and
claude
committed
feat(gateway/acp): server-initiated request direction (T1.2/1.3)

brettchien
and
claude
committed
refactor(gateway/acp): construct trivial responses from generated types (T2.1)

brettchien
and
claude
committed
feat(gateway/acp): MCP-over-ACP tunnel frame API (T4.1)

brettchien
and
claude
committed
feat(core): scaffold MCP proxy server deps + static browser toolset (T5.1a)

brettchien
and
claude
committed
feat(core): MCP proxy ServerHandler + loopback server (T5.1b)

brettchien
and
claude
committed
feat(core): bearer gate on the MCP proxy server (T5.2 part 1)

brettchien
and
claude
committed
docs(adr): correct runtime diagram — mcp/message flattens, no inner id

brettchien
and
claude
committed
feat(gateway/acp): parse + record client-declared type:acp mcpServers (T4)

brettchien
and
claude
committed
docs: MCP-over-ACP tunnel contract for the extension (T4.3)

brettchien
and
claude
committed
feat(gateway/acp): TunnelHandle — per-connection MCP tunnel handle (T5.3)

brettchien
and
claude
committed
feat(gateway/acp): tunnel registry + establish_and_register_tunnel (T5.3)

brettchien
and
claude
committed
feat(gateway): thread AcpTunnelRegistry through AppState (T5.3)

brettchien
and
claude
committed
feat(gateway/acp): open MCP tunnels on session/new + cleanup (T5.3)

brettchien
and
claude
committed
feat(core): BrowserTunnel trait + ProxyHandler forwards tool calls (T5.3, D6-a')

brettchien
and
claude
committed
feat(core): start_session_server — per-session server + .cursor/mcp.json (T5.2/D5-a)

brettchien
and
claude
committed
feat(core): start per-session MCP proxy on agent spawn (T5.2/D5-a)

brettchien
and
claude
committed
feat(root): wire the browser tunnel bridge end-to-end (T5.3, D6-a')

brettchien
and
claude
committed
docs(adr): record the as-built OpenAB side (D5-a + D6-a', end-to-end)

brettchien
and
claude
committed
test(e2e): MCP-over-ACP tunnel producer section in acp-ws-smoke (T7)

brettchien
and
claude
committed
test(e2e): complete the MCP-over-ACP tunnel suite (fan-out + filtering)

brettchien
and
claude
committed
fix(acp-mcp): address Mira review nits — constant-time bearer + string-number id

brettchien
and
claude
committed
fix(acp-mcp): establish the browser tunnel on session/resume, not just session/new

brettchien
and
claude
committed
chore(acp-mcp): log browser tunnel open/register for live-session observability

brettchien
and
claude
committed
fix(acp-mcp): raise ACP frame cap 1→8 MiB for browser-tool results

brettchien
and
claude
committed
fix(acp-mcp): one browser tunnel per session — fix fan-out overwrite/orphan (M-B1)

brettchien
and
claude
committed
fix(acp-mcp): 0600 mcp.json + strip stale bearer on evict (M-B2)

brettchien
and
claude
committed
chore(acp-mcp): lock subtle dependency

brettchien
and
claude
committed
feat(mcp-proxy): write openab-browser into kiro-cli config too, not just Cursor

brettchien
and
claude
committed
docs: browser MCP agent setup — per-variant mcp.json how-to (Phase 2 #8)

brettchien
and
claude
committed
feat(mcp-proxy): per-pod browser-bridge socket server (Option C, P1)

brettchien
and
claude
committed
feat(cli): openab browser-bridge subcommand — stdio MCP relay to the browser socket (Option C, P2)

brettchien
and
claude
committed
feat(acp): inject OPENAB_BROWSER_CHANNEL into the agent env (Option C, P3)

brettchien
and
claude
committed
feat(mcp-proxy): static write-once browser-bridge config (Option C, P4)

brettchien
and
claude
committed
feat: OPENAB_BROWSER_MODE proxy|bridge toggle wiring (Option C, P5)

brettchien
and
claude
committed
fix(browser-bridge): resolve channel via process-ancestry, not env (Option C, b2 B1)

brettchien
and
claude
committed
feat(mcp-proxy): revert bridge config to pure {command,args} (Option C, b2 B2)

brettchien
and
claude
committed
fix(acp): add acp_mcp_servers to test-only AcpSession initializers

brettchien
and
claude
committed
docs(acp): split into reverse-MCP mechanism ADR + browser-control ADR, embed diagrams

brettchien
and
claude
committed
docs(adr): correct D4 list_changed overclaim in browser ADR

brettchien
and
claude
committed
refactor(acp): compound-key (channel_id,server_id) tunnel registry + rename BrowserTunnel->AcpMcpTunnel (P1, Fork A)

brettchien
and
claude
committed

Commits on Jul 25, 2026