@btraut/browser-bridge 0.3.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 +22 -0
- package/README.md +23 -7
- package/dist/api.js +1652 -1528
- package/dist/api.js.map +4 -4
- package/dist/index.js +6 -1
- package/dist/index.js.map +3 -3
- package/extension/dist/background.js +96 -2
- package/extension/dist/background.js.map +3 -3
- package/package.json +1 -1
- package/skills/browser-bridge/SKILL.md +12 -0
- package/skills/browser-bridge/skill.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,28 @@ The format is based on "Keep a Changelog", and this project adheres to Semantic
|
|
|
6
6
|
|
|
7
7
|
## [Unreleased]
|
|
8
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
|
+
|
|
9
31
|
## [0.3.0] - 2026-02-06
|
|
10
32
|
|
|
11
33
|
### Added
|
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
|
|
@@ -62,7 +61,14 @@ Easiest option (recommended):
|
|
|
62
61
|
browser-bridge install
|
|
63
62
|
```
|
|
64
63
|
|
|
65
|
-
|
|
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):
|
|
66
72
|
|
|
67
73
|
```bash
|
|
68
74
|
# From this repo:
|
|
@@ -80,11 +86,14 @@ Restart your agent app if it does not pick up the new skill automatically.
|
|
|
80
86
|
|
|
81
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.
|
|
82
88
|
|
|
89
|
+
- Easiest option: `browser-bridge mcp install`
|
|
83
90
|
- Manual start (debugging): `browser-bridge mcp`
|
|
84
91
|
- Use your MCP client to call `tools/list`, then `session.create`
|
|
85
92
|
- Override Core host/port with `--host`, `--port`, or `BROWSER_BRIDGE_CORE_HOST` / `BROWSER_BRIDGE_CORE_PORT`.
|
|
86
93
|
|
|
87
|
-
##
|
|
94
|
+
## Manual MCP Setup (Advanced)
|
|
95
|
+
|
|
96
|
+
Codex:
|
|
88
97
|
|
|
89
98
|
```bash
|
|
90
99
|
codex mcp add browser-bridge -- browser-bridge mcp
|
|
@@ -99,7 +108,7 @@ codex mcp add browser-bridge \
|
|
|
99
108
|
-- browser-bridge mcp
|
|
100
109
|
```
|
|
101
110
|
|
|
102
|
-
|
|
111
|
+
Claude Code:
|
|
103
112
|
|
|
104
113
|
```bash
|
|
105
114
|
claude mcp add --transport stdio browser-bridge -- browser-bridge mcp
|
|
@@ -119,6 +128,13 @@ claude mcp add --transport stdio browser-bridge \
|
|
|
119
128
|
- CLI: `browser-bridge diagnostics doctor --session-id <id>`
|
|
120
129
|
- Reports extension and debugger status alongside session state.
|
|
121
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
|
+
|
|
122
138
|
## Changelog
|
|
123
139
|
|
|
124
140
|
See `CHANGELOG.md`.
|