Skip to content

docs: design for browser-only agents via just-bash CLI mode + WASM - #235

Merged
timesler merged 2 commits into
mainfrom
copilot/add-mcp-compressor-design-md
Jul 6, 2026
Merged

docs: design for browser-only agents via just-bash CLI mode + WASM#235
timesler merged 2 commits into
mainfrom
copilot/add-mcp-compressor-design-md

Conversation

Copilot AI commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Adds a detailed design document for running mcp-compressor just-bash CLI mode entirely in a browser (except LLM vendor calls), covering how to bridge the Rust-native / napi-rs dependency gap via WebAssembly.

What's added

  • docs/browser-agent-design.md — full design covering:
    • mcp-compressor-wasm crate: wasm-bindgen wrapper around the pure-computation half of the Rust core (compression, cli/parser, cli/help, ffi/pure) behind a pure-only Cargo feature that strips Tokio/axum/reqwest/rmcp
    • BrowserMcpClient: TypeScript fetch-based MCP Streamable HTTP transport replacing the Rust session manager
    • Just-bash browser integration: existing createJustBashCommandRegistrations / installJustBashRegistrations are already pure TS, work unchanged once WASM provides the pure functions
    • OAuth PKCE helper replacing the loopback callback server
    • Optional Service Worker pattern for persistent cross-tab sessions
    • Browser package entry point (./browser export) wiring the WASM adapter behind the same NativeCore interface
    • Tradeoffs, constraints table, and a 3-phase implementation roadmap
    • 6 mermaid diagrams (overall architecture, fetch sequence, agent command lifecycle, OAuth PKCE flow, today-vs-new-work breakdown, Gantt roadmap)
  • mkdocs.yml — nav entry under Development

@atlassian-cla-bot

Copy link
Copy Markdown

Thank you for your submission! Like many open source projects, we ask that you sign our CLA (Contributor License Agreement) before we can accept your contribution.
If your email is listed below, please ensure that you sign the CLA with the same email address.

The following users still need to sign our CLA:
❌Copilot

Already signed the CLA? To re-check, try refreshing the page.

@timesler
timesler marked this pull request as ready for review July 6, 2026 17:56
Copilot AI temporarily deployed to atlassian-mcp-integration July 6, 2026 17:56 Inactive
@timesler
timesler temporarily deployed to atlassian-mcp-integration July 6, 2026 17:56 — with GitHub Actions Inactive
@timesler
timesler merged commit ae73b9b into main Jul 6, 2026
29 of 30 checks passed
@timesler
timesler deleted the copilot/add-mcp-compressor-design-md branch July 6, 2026 18:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants