Support a wasm / browser based acp client #527

Activity

1. jcarver989

   added

   size:LLarge change requiring an implementation planLarge change requiring an implementation plan

   assign-agentApply after an optional size:S/M/L label to assign the issue to AetherApply after an optional size:S/M/L label to assign the issue to Aether

   on Sep 26, 2026
2. contextbridge-pr-automation commented on Sep 26, 2026

   

   contextbridge-pr-automationbot

   on Sep 26, 2026

   Contributor

   More actions

   Plan saved to docs/aether/plans/issue-527-plan.md (force-added since plans/ is gitignored) and committed as 81dc5bc3 on aether/issue-527.

   Summary of the plan:

   • Phase 0 — Bump ACP 2.1.0 → 2.2.0: verified via registry sources that 2.2.0's wasm delta is the opt-in wasm_js feature (Web Crypto UUID backend, PR fix(aether-lspd): Race condition with lsp events #308), unstable_tool_call_name is stabilized (must drop that feature flag), and the ConnectTo: Send + 'static bound is retained — so the plan works within it via executor choice rather than a trait fork.
   • Phase 1 — New aether-acp-core crate: moves serde-only wire types (meta, config_option_id, notifications split, AcpEvent, AcpClientError) out of tokio-coupled acp-utils, adds a Spawner trait (TokioSpawner / WasmSpawner) and a spawner-generic connect_acp_client ported onto futures::channel (same primitives ACP core uses internally).
   • Phase 2 — Pure reducer: extracts conversation folding from wisp's TUI-coupled acp_reducer.rs into reduce() → (snapshot, effects) over schema::v2 types.
   • Phase 3 — WebSysTransport: message-based web-sys::WebSocket → Lines adapter (no byte-stream shim possible in browsers), mirroring binary-reject/close/backpressure semantics of websocket.rs.
   • Phase 4 — aether-acp-wasm facade: thin wasm-bindgen WasmAcpClient (connect/session/prompt/cancel/event-subscribe) + packages/aether-acp-wasm TS wrapper reusing the AetherMessage shape; deliberately not extending the Node-only aether-sdk.
   • Phase 5 — Hardening/CI: wasm32-unknown-unknown + wasm-pack test jobs, 409/reconnect semantics, remote.mdx browser docs.

   Pushed to aether/issue-527. See the run.
3. jcarver989

   closed this as completedin #529on Sep 27, 2026