@btraut/browser-bridge 0.2.0 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +51 -0
- package/README.md +37 -7
- package/dist/api.js +1652 -1528
- package/dist/api.js.map +4 -4
- package/dist/index.js +636 -22
- package/dist/index.js.map +4 -4
- package/extension/dist/background.js +96 -2
- package/extension/dist/background.js.map +3 -3
- package/package.json +4 -2
- package/skills/browser-bridge/SKILL.md +12 -0
- package/skills/browser-bridge/skill.json +4 -0
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to this project will be documented in this file.
|
|
4
|
+
|
|
5
|
+
The format is based on "Keep a Changelog", and this project adheres to Semantic Versioning.
|
|
6
|
+
|
|
7
|
+
## [Unreleased]
|
|
8
|
+
|
|
9
|
+
### Added
|
|
10
|
+
|
|
11
|
+
_TBD_
|
|
12
|
+
|
|
13
|
+
### Fixed
|
|
14
|
+
|
|
15
|
+
_TBD_
|
|
16
|
+
|
|
17
|
+
## [0.4.0] - 2026-02-06
|
|
18
|
+
|
|
19
|
+
### Added
|
|
20
|
+
|
|
21
|
+
- Core idle session TTL cleanup (configurable via `BROWSER_BRIDGE_SESSION_TTL_MS`).
|
|
22
|
+
- Diagnostics now include a session summary (count and max age/idle time).
|
|
23
|
+
|
|
24
|
+
### Fixed
|
|
25
|
+
|
|
26
|
+
- Sanitize Chrome extension error messages before forwarding them to clients (remove file paths and redact URLs to origin).
|
|
27
|
+
- Share the core <-> extension protocol types via `@btraut/browser-bridge-shared` (remove manual sync).
|
|
28
|
+
- Refactor InspectService internals into `packages/core/src/inspect/*` modules and expand unit test coverage (no API changes).
|
|
29
|
+
- Stabilize `scripts/cli-full-tool-smoke.sh` dialog steps by refreshing debugger attachment before opening JS dialogs.
|
|
30
|
+
|
|
31
|
+
## [0.3.0] - 2026-02-06
|
|
32
|
+
|
|
33
|
+
### Added
|
|
34
|
+
|
|
35
|
+
- `browser-bridge install` interactive installer for skills and MCP.
|
|
36
|
+
- `browser-bridge skill install` and `browser-bridge skill status`.
|
|
37
|
+
- `browser-bridge mcp install` for Codex, Claude, and Cursor.
|
|
38
|
+
- Skill version manifest (`skill.json`) to detect out-of-date installs.
|
|
39
|
+
- `browser-bridge mcp serve` (while keeping `browser-bridge mcp` working).
|
|
40
|
+
|
|
41
|
+
## [0.2.0] - 2026-02-05
|
|
42
|
+
|
|
43
|
+
### Added
|
|
44
|
+
|
|
45
|
+
- `browser-bridge inspect dom-snapshot --max-nodes <n>` (AX format only) to bound snapshot size for agent/LLM consumption.
|
|
46
|
+
|
|
47
|
+
## [0.1.1] - 2026-02-05
|
|
48
|
+
|
|
49
|
+
### Added
|
|
50
|
+
|
|
51
|
+
- Initial release.
|
package/README.md
CHANGED
|
@@ -37,10 +37,9 @@ npm run build
|
|
|
37
37
|
|
|
38
38
|
## Quickstart
|
|
39
39
|
|
|
40
|
-
1. Install the extension
|
|
41
|
-
2.
|
|
42
|
-
3.
|
|
43
|
-
4. Run a quick CLI check:
|
|
40
|
+
1. Install the extension.
|
|
41
|
+
2. Run `browser-bridge install` (skill + optional MCP).
|
|
42
|
+
3. Run a quick CLI check:
|
|
44
43
|
|
|
45
44
|
```bash
|
|
46
45
|
browser-bridge session create
|
|
@@ -56,7 +55,20 @@ Notes:
|
|
|
56
55
|
|
|
57
56
|
## Skills (Codex + Claude Code)
|
|
58
57
|
|
|
59
|
-
|
|
58
|
+
Easiest option (recommended):
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
browser-bridge install
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
Skill only:
|
|
65
|
+
|
|
66
|
+
```bash
|
|
67
|
+
browser-bridge skill install
|
|
68
|
+
browser-bridge skill status
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
Or copy the Browser Bridge skill into your agent skills directory (advanced):
|
|
60
72
|
|
|
61
73
|
```bash
|
|
62
74
|
# From this repo:
|
|
@@ -74,11 +86,14 @@ Restart your agent app if it does not pick up the new skill automatically.
|
|
|
74
86
|
|
|
75
87
|
The MCP server runs over stdio and forwards tool calls to Core. It is optional, since you can use the CLI directly. MCP clients launch it automatically when needed, so you typically do not run it yourself.
|
|
76
88
|
|
|
89
|
+
- Easiest option: `browser-bridge mcp install`
|
|
77
90
|
- Manual start (debugging): `browser-bridge mcp`
|
|
78
91
|
- Use your MCP client to call `tools/list`, then `session.create`
|
|
79
92
|
- Override Core host/port with `--host`, `--port`, or `BROWSER_BRIDGE_CORE_HOST` / `BROWSER_BRIDGE_CORE_PORT`.
|
|
80
93
|
|
|
81
|
-
##
|
|
94
|
+
## Manual MCP Setup (Advanced)
|
|
95
|
+
|
|
96
|
+
Codex:
|
|
82
97
|
|
|
83
98
|
```bash
|
|
84
99
|
codex mcp add browser-bridge -- browser-bridge mcp
|
|
@@ -93,7 +108,7 @@ codex mcp add browser-bridge \
|
|
|
93
108
|
-- browser-bridge mcp
|
|
94
109
|
```
|
|
95
110
|
|
|
96
|
-
|
|
111
|
+
Claude Code:
|
|
97
112
|
|
|
98
113
|
```bash
|
|
99
114
|
claude mcp add --transport stdio browser-bridge -- browser-bridge mcp
|
|
@@ -113,6 +128,21 @@ claude mcp add --transport stdio browser-bridge \
|
|
|
113
128
|
- CLI: `browser-bridge diagnostics doctor --session-id <id>`
|
|
114
129
|
- Reports extension and debugger status alongside session state.
|
|
115
130
|
|
|
131
|
+
## Session TTL (Core Daemon)
|
|
132
|
+
|
|
133
|
+
The Core daemon keeps sessions in memory. By default, it automatically cleans up idle sessions after 1 hour.
|
|
134
|
+
|
|
135
|
+
- `BROWSER_BRIDGE_SESSION_TTL_MS`: Idle session TTL in milliseconds. Set to `0` to disable cleanup.
|
|
136
|
+
- `BROWSER_BRIDGE_SESSION_CLEANUP_INTERVAL_MS`: Cleanup interval in milliseconds. Defaults to a small value relative to the TTL.
|
|
137
|
+
|
|
138
|
+
## Changelog
|
|
139
|
+
|
|
140
|
+
See `CHANGELOG.md`.
|
|
141
|
+
|
|
142
|
+
## Releasing
|
|
143
|
+
|
|
144
|
+
See `docs/releasing.md`.
|
|
145
|
+
|
|
116
146
|
## Security Model (v1)
|
|
117
147
|
|
|
118
148
|
- Extension <-> Core WebSocket has no authentication; trust local machine only.
|