Skip to content

Browser Tools CLI with MCP parity and navigate (AGE-482) - #252

Merged
tedjames merged 3 commits into
mainfrom
ted/age-482-browser-tools-cli-that-mirrors-every-mcp-tool-plus-a
Oct 27, 2026
Merged

tedjames merged 3 commits into
mainfrom
ted/age-482-browser-tools-cli-that-mirrors-every-mcp-tool-plus-a

Conversation

@tedjames

Copy link
Copy Markdown
Member

Summary

Implements AGE-482 v1 on top of merged #251 (capability gates) and #250 (local API policy).

  • New browser-tools npm bin mirrors every MCP tool via shared tool-invoke handlers, plus resource subcommands for MCP resources.
  • navigateBrowser MCP tool and connector route: extension service worker loads URLs with tabs.update({ active: false }), gated through checkCapability("navigate", …) (popup switch + --allow-input / origins).
  • CLI capability flag: browser-tools uses --allow-actions only (argv, no env), mapped to connector allowInput. It rejects --allow-eval / --allow-input so agents do not see two flag models. browser-tools-mcp unchanged (--allow-eval, --allow-input).
  • Keeps AGE-522: Vitest 5 and local API hardening #250 pieces on the rebased base: decideApiAccess middleware, /.pair + extensionId, query-string token rejection, originless Bearer auth.

Test plan

  • npm run build in browser-tools-mcp
  • npx vitest run --project unit --project integration (558 passed)

Notes

  • Hexagonal / ports-adapters refactor and AGE-584 tab tools are explicitly out of scope for this PR.
Open in Web Open in Cursor 

cursoragent and others added 3 commits October 26, 2026 22:29
Adds the browser-tools CLI binary that invokes the same tool handlers as the
MCP server, plus resource subcommands. Introduces navigateBrowser with service
worker tabs.update (active: false) behind capability gates from #251.

The CLI exposes --allow-actions (argv only), mapped to connector allow-input;
browser-tools-mcp keeps --allow-eval and --allow-input. Preserves #250 local
API policy, extension-id pairing, and websocket token rules on top of #251.

Co-authored-by: werbel.ted <werbel.ted@gmail.com>
Without a live worker, popup-gated actions cannot be confirmed. Return
GateReason.popupOff instead of switchUnconfirmed so disconnect races match
dropConnection semantics and capability-gates integration tests.

Co-authored-by: werbel.ted <werbel.ted@gmail.com>
Page actions are confirmed from the popup (#251); panel.js no longer
references allowActions or bridge action-confirmation APIs.

Co-authored-by: werbel.ted <werbel.ted@gmail.com>
@tedjames
tedjames merged commit a480993 into main Oct 27, 2026
8 checks passed
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