@agentruntime-labs/browser-agent 0.1.1 → 0.2.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.
Files changed (161) hide show
  1. package/LICENSE +202 -0
  2. package/NOTICE +6 -0
  3. package/README.md +64 -34
  4. package/bin/browser-agent.js +1 -0
  5. package/cli/control.mjs +477 -0
  6. package/cli/daemon.mjs +143 -0
  7. package/cli/hosts.mjs +1 -0
  8. package/cli/main.mjs +24 -0
  9. package/cli/mcp.mjs +1 -0
  10. package/docs/ARCHITECTURE.md +73 -0
  11. package/docs/DESKTOP_MCP.md +41 -0
  12. package/docs/EXTENSION_MANIFEST.md +163 -0
  13. package/docs/HYBRID.md +12 -0
  14. package/docs/MANAGED_BROWSER.md +111 -0
  15. package/docs/MCP_TOOLS.md +486 -0
  16. package/docs/MESSAGES.md +272 -0
  17. package/docs/MVP.md +76 -0
  18. package/docs/PRIVACY_POLICY.md +50 -0
  19. package/docs/README.md +27 -0
  20. package/docs/REFERENCE_PROJECTS.md +24 -0
  21. package/docs/RELEASE_CHECKLIST.md +49 -0
  22. package/docs/REPEATED_DOCS.md +27 -0
  23. package/docs/SAFETY.md +92 -0
  24. package/docs/SHELL_QUOTING.md +30 -0
  25. package/docs/SPLIT_REPOS.md +46 -0
  26. package/docs/THIRD_PARTY_LICENSES.md +182 -0
  27. package/docs/VISION.md +38 -0
  28. package/docs/WEB_STORE_SUBMISSION.md +117 -0
  29. package/extension/approval.js +1 -0
  30. package/extension/assets/agentruntime-logo.svg +77 -0
  31. package/extension/assets/agentruntime-mark-512.png +0 -0
  32. package/extension/background.js +776 -62
  33. package/extension/cdp.js +577 -0
  34. package/extension/constants.js +1 -0
  35. package/extension/content.js +69 -9
  36. package/extension/devtools-grant.html +31 -0
  37. package/extension/devtools-grant.js +29 -0
  38. package/extension/icons/icon128.png +0 -0
  39. package/extension/icons/icon16.png +0 -0
  40. package/extension/icons/icon32.png +0 -0
  41. package/extension/icons/icon48.png +0 -0
  42. package/extension/manifest.json +50 -23
  43. package/extension/policy.js +102 -0
  44. package/extension/popup.html +190 -56
  45. package/extension/popup.js +376 -166
  46. package/extension/soft.js +301 -0
  47. package/extension/welcome.html +91 -0
  48. package/extension/welcome.js +13 -0
  49. package/package.json +6 -2
  50. package/server/dist/arBrowserPaths.d.ts.map +1 -1
  51. package/server/dist/arBrowserPaths.js +1 -0
  52. package/server/dist/arBrowserPaths.js.map +1 -1
  53. package/server/dist/automationBackend.d.ts +46 -0
  54. package/server/dist/automationBackend.d.ts.map +1 -0
  55. package/server/dist/automationBackend.js +20 -0
  56. package/server/dist/automationBackend.js.map +1 -0
  57. package/server/dist/automationSession.d.ts.map +1 -1
  58. package/server/dist/automationSession.js +1 -0
  59. package/server/dist/automationSession.js.map +1 -1
  60. package/server/dist/bridge.d.ts +17 -4
  61. package/server/dist/bridge.d.ts.map +1 -1
  62. package/server/dist/bridge.js +132 -33
  63. package/server/dist/bridge.js.map +1 -1
  64. package/server/dist/browserToolsExtras.d.ts +2 -2
  65. package/server/dist/browserToolsExtras.d.ts.map +1 -1
  66. package/server/dist/browserToolsExtras.js +70 -1
  67. package/server/dist/browserToolsExtras.js.map +1 -1
  68. package/server/dist/cdpTools.d.ts +5 -0
  69. package/server/dist/cdpTools.d.ts.map +1 -0
  70. package/server/dist/cdpTools.js +411 -0
  71. package/server/dist/cdpTools.js.map +1 -0
  72. package/server/dist/compositeTools.d.ts +2 -2
  73. package/server/dist/compositeTools.d.ts.map +1 -1
  74. package/server/dist/compositeTools.js.map +1 -1
  75. package/server/dist/debugSnapshot.d.ts +2 -2
  76. package/server/dist/debugSnapshot.d.ts.map +1 -1
  77. package/server/dist/debugSnapshot.js.map +1 -1
  78. package/server/dist/guardrails.d.ts.map +1 -1
  79. package/server/dist/guardrails.js +1 -0
  80. package/server/dist/guardrails.js.map +1 -1
  81. package/server/dist/humanLike.d.ts.map +1 -1
  82. package/server/dist/humanLike.js +1 -0
  83. package/server/dist/humanLike.js.map +1 -1
  84. package/server/dist/main.js +56 -15
  85. package/server/dist/main.js.map +1 -1
  86. package/server/dist/managedBridge.d.ts +58 -0
  87. package/server/dist/managedBridge.d.ts.map +1 -0
  88. package/server/dist/managedBridge.js +619 -0
  89. package/server/dist/managedBridge.js.map +1 -0
  90. package/server/dist/managedDom.d.ts +58 -0
  91. package/server/dist/managedDom.d.ts.map +1 -0
  92. package/server/dist/managedDom.js +310 -0
  93. package/server/dist/managedDom.js.map +1 -0
  94. package/server/dist/policyTiers.d.ts.map +1 -1
  95. package/server/dist/policyTiers.js +3 -1
  96. package/server/dist/policyTiers.js.map +1 -1
  97. package/server/dist/protocol.d.ts +4 -0
  98. package/server/dist/protocol.d.ts.map +1 -1
  99. package/server/dist/protocol.js +1 -0
  100. package/server/dist/protocol.js.map +1 -1
  101. package/server/dist/recorder.d.ts +22 -0
  102. package/server/dist/recorder.d.ts.map +1 -0
  103. package/server/dist/recorder.js +82 -0
  104. package/server/dist/recorder.js.map +1 -0
  105. package/server/dist/richEditorFill.d.ts.map +1 -1
  106. package/server/dist/richEditorFill.js +1 -0
  107. package/server/dist/richEditorFill.js.map +1 -1
  108. package/server/dist/screenshotCrop.d.ts.map +1 -1
  109. package/server/dist/screenshotCrop.js +1 -0
  110. package/server/dist/screenshotCrop.js.map +1 -1
  111. package/server/dist/sessionLog.d.ts +1 -0
  112. package/server/dist/sessionLog.d.ts.map +1 -1
  113. package/server/dist/sessionLog.js +1 -0
  114. package/server/dist/sessionLog.js.map +1 -1
  115. package/server/dist/sessionPhase.d.ts.map +1 -1
  116. package/server/dist/sessionPhase.js.map +1 -1
  117. package/server/dist/sessionSummary.d.ts.map +1 -1
  118. package/server/dist/sessionSummary.js +1 -0
  119. package/server/dist/sessionSummary.js.map +1 -1
  120. package/server/dist/shotUtil.d.ts +44 -0
  121. package/server/dist/shotUtil.d.ts.map +1 -0
  122. package/server/dist/shotUtil.js +89 -0
  123. package/server/dist/shotUtil.js.map +1 -0
  124. package/server/dist/skillsInstructions.d.ts.map +1 -1
  125. package/server/dist/skillsInstructions.js +1 -0
  126. package/server/dist/skillsInstructions.js.map +1 -1
  127. package/server/dist/snapshotText.d.ts +47 -0
  128. package/server/dist/snapshotText.d.ts.map +1 -0
  129. package/server/dist/snapshotText.js +99 -0
  130. package/server/dist/snapshotText.js.map +1 -0
  131. package/server/dist/structureFilter.d.ts.map +1 -1
  132. package/server/dist/structureFilter.js.map +1 -1
  133. package/server/dist/surveyCatalog.d.ts.map +1 -1
  134. package/server/dist/surveyCatalog.js +1 -0
  135. package/server/dist/surveyCatalog.js.map +1 -1
  136. package/server/dist/surveyRunner.d.ts.map +1 -1
  137. package/server/dist/surveyRunner.js.map +1 -1
  138. package/server/dist/toolHelpers.d.ts +27 -2
  139. package/server/dist/toolHelpers.d.ts.map +1 -1
  140. package/server/dist/toolHelpers.js +67 -1
  141. package/server/dist/toolHelpers.js.map +1 -1
  142. package/server/dist/toolRuntime.d.ts +4 -0
  143. package/server/dist/toolRuntime.d.ts.map +1 -1
  144. package/server/dist/toolRuntime.js +12 -6
  145. package/server/dist/toolRuntime.js.map +1 -1
  146. package/server/dist/toolSchemas.d.ts +37 -1
  147. package/server/dist/toolSchemas.d.ts.map +1 -1
  148. package/server/dist/toolSchemas.js +33 -1
  149. package/server/dist/toolSchemas.js.map +1 -1
  150. package/server/dist/tools.d.ts +2 -2
  151. package/server/dist/tools.d.ts.map +1 -1
  152. package/server/dist/tools.js +65 -11
  153. package/server/dist/tools.js.map +1 -1
  154. package/server/dist/verdictExtract.d.ts.map +1 -1
  155. package/server/dist/verdictExtract.js +1 -0
  156. package/server/dist/verdictExtract.js.map +1 -1
  157. package/server/dist/workflowTools.d.ts +2 -2
  158. package/server/dist/workflowTools.d.ts.map +1 -1
  159. package/server/dist/workflowTools.js +16 -4
  160. package/server/dist/workflowTools.js.map +1 -1
  161. package/skills/browser-agent/SKILL.md +89 -0
@@ -1,166 +1,376 @@
1
- import { DEFAULT_WS_PORT } from './constants.js';
2
-
3
- function setStatus(text, cls) {
4
- const el = document.getElementById('status');
5
- el.textContent = text;
6
- el.className = 'status ' + (cls || '');
7
- }
8
-
9
- async function formatTargetTabStatus(connectedTabId) {
10
- if (connectedTabId != null) {
11
- try {
12
- await chrome.tabs.get(connectedTabId);
13
- return ` | pinned tab #${connectedTabId}`;
14
- } catch {
15
- await chrome.storage.local.remove('connectedTabId');
16
- }
17
- }
18
- const [tab] = await chrome.tabs.query({ active: true, lastFocusedWindow: true });
19
- if (tab?.id) {
20
- return ` | active tab #${tab.id} (default)`;
21
- }
22
- return ' | no active tab';
23
- }
24
-
25
- async function load() {
26
- if (location.hash.length > 1) {
27
- const q = new URLSearchParams(location.hash.slice(1));
28
- const p = q.get('port');
29
- const t = q.get('token');
30
- if (p) {
31
- document.getElementById('port').value = p;
32
- }
33
- if (t !== null) {
34
- document.getElementById('token').value = t;
35
- }
36
- }
37
- const { wsPort, sessionToken, connectedTabId, serverBridgePort } = await chrome.storage.local.get([
38
- 'wsPort',
39
- 'sessionToken',
40
- 'connectedTabId',
41
- 'serverBridgePort'
42
- ]);
43
- if (wsPort) {
44
- document.getElementById('port').value = String(wsPort);
45
- }
46
- if (sessionToken) {
47
- document.getElementById('token').value = String(sessionToken);
48
- }
49
- const st = await chrome.runtime.sendMessage({ type: 'get-ws-status' }).catch(() => ({
50
- connected: false
51
- }));
52
- const extra = await formatTargetTabStatus(connectedTabId);
53
- const srv =
54
- typeof serverBridgePort === 'number' && serverBridgePort > 0
55
- ? ` | last server port ${serverBridgePort}`
56
- : '';
57
- setStatus(
58
- (st.connected ? 'WebSocket: connected' : 'WebSocket: disconnected') + extra + srv,
59
- st.connected ? 'ok' : ''
60
- );
61
- }
62
-
63
- document.getElementById('connect').onclick = async () => {
64
- const port = parseInt(document.getElementById('port').value, 10);
65
- const token = document.getElementById('token').value.trim();
66
- if (!Number.isFinite(port) || port <= 0) {
67
- setStatus('Invalid port', 'err');
68
- return;
69
- }
70
- await chrome.storage.local.set({ wsPort: port, sessionToken: token });
71
- const r = await chrome.runtime.sendMessage({ type: 'connect', port, token });
72
- if (r?.ok) {
73
- setStatus('Connected.', 'ok');
74
- } else {
75
- setStatus('Connect failed: ' + (r?.error || 'unknown'), 'err');
76
- }
77
- };
78
-
79
- document.getElementById('disconnect').onclick = async () => {
80
- await chrome.runtime.sendMessage({ type: 'disconnect' });
81
- setStatus('Disconnected.');
82
- };
83
-
84
- document.getElementById('setTab').onclick = async () => {
85
- const [tab] = await chrome.tabs.query({ active: true, currentWindow: true });
86
- if (!tab?.id) {
87
- setStatus('No active tab', 'err');
88
- return;
89
- }
90
- await chrome.storage.local.set({ connectedTabId: tab.id });
91
- setStatus(`Pinned tab #${tab.id}`, 'ok');
92
- };
93
-
94
- document.getElementById('clearPin').onclick = async () => {
95
- await chrome.storage.local.remove('connectedTabId');
96
- const extra = await formatTargetTabStatus(null);
97
- setStatus('Using active tab' + extra, 'ok');
98
- };
99
-
100
- document.getElementById('copyMcpSnippet').onclick = async () => {
101
- const { serverBridgePort } = await chrome.storage.local.get('serverBridgePort');
102
- const portField = parseInt(document.getElementById('port').value, 10);
103
- const port =
104
- typeof serverBridgePort === 'number' && serverBridgePort > 0
105
- ? serverBridgePort
106
- : Number.isFinite(portField)
107
- ? portField
108
- : DEFAULT_WS_PORT;
109
- const obj = {
110
- mcpServers: {
111
- 'browser-automation': {
112
- command: 'node',
113
- args: ['REPLACE_WITH_ABSOLUTE_PATH_TO_REPO/server/dist/main.js'],
114
- env: {
115
- BROWSER_AUTOMATION_WS_PORT: String(port),
116
- BROWSER_AUTOMATION_CONFIRM_CROSS_ORIGIN: '0',
117
- BROWSER_AUTOMATION_CONFIRM_TAB_CLOSE: '0',
118
- BROWSER_AUTOMATION_ALLOW_EVAL: '0'
119
- }
120
- }
121
- }
122
- };
123
- try {
124
- await navigator.clipboard.writeText(JSON.stringify(obj, null, 2));
125
- setStatus(
126
- 'Copied MCP JSON. Replace REPLACE_WITH_ABSOLUTE_PATH_TO_REPO in args[0]; set env flags to 1 if you want prompts or eval.',
127
- 'ok'
128
- );
129
- } catch {
130
- setStatus('Clipboard failed.', 'err');
131
- }
132
- };
133
-
134
- document.getElementById('copyPairing').onclick = async () => {
135
- const portField = parseInt(document.getElementById('port').value, 10);
136
- const token = document.getElementById('token').value.trim();
137
- const { serverBridgePort } = await chrome.storage.local.get('serverBridgePort');
138
- const port =
139
- typeof serverBridgePort === 'number' && serverBridgePort > 0
140
- ? serverBridgePort
141
- : Number.isFinite(portField)
142
- ? portField
143
- : '';
144
- if (!port) {
145
- setStatus('Set a port or connect so the server can confirm it.', 'err');
146
- return;
147
- }
148
- const block = [
149
- `WebSocket port: ${port}`,
150
- `SESSION token: ${token || '(empty — use --insecure-no-token server)'}`,
151
- '',
152
- 'Use one Node MCP server with this port. If you also run npm start or another MCP host,',
153
- 'only one can own this port — match BRIDGE_PORT from that process stderr.',
154
- '',
155
- 'Deep link (bookmark): ' +
156
- chrome.runtime.getURL(`popup.html#port=${encodeURIComponent(String(port))}`)
157
- ].join('\n');
158
- try {
159
- await navigator.clipboard.writeText(block);
160
- setStatus('Copied pairing block to clipboard.', 'ok');
161
- } catch {
162
- setStatus('Clipboard failed — copy port/token manually.', 'err');
163
- }
164
- };
165
-
166
- void load();
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { DEFAULT_WS_PORT } from './constants.js';
3
+
4
+ const $ = (id) => document.getElementById(id);
5
+ let statusTimer = null;
6
+ /** After the user presses Connect: show "Connecting..." (not the install message) until connected or this time passes. */
7
+ let connectingUntil = 0;
8
+ let firstRender = true;
9
+
10
+ function setStatus(text, cls) {
11
+ const el = $('status');
12
+ el.textContent = text;
13
+ el.className = cls || '';
14
+ clearTimeout(statusTimer);
15
+ if (text) {
16
+ statusTimer = setTimeout(() => {
17
+ el.textContent = '';
18
+ el.className = '';
19
+ }, 6000);
20
+ }
21
+ }
22
+
23
+ function ago(ms) {
24
+ const s = Math.max(0, Math.round((Date.now() - ms) / 1000));
25
+ if (s < 60) return `${s}s ago`;
26
+ if (s < 3600) return `${Math.round(s / 60)} min ago`;
27
+ return `${Math.round(s / 3600)} h ago`;
28
+ }
29
+
30
+ const MODE_HELP = {
31
+ freeform: 'Agents can use any tab: open tabs, switch between them, open windows and close tabs.',
32
+ follow: 'Agents can only use the tab you are on. When you switch tabs, they move with you. They cannot open or touch other tabs.',
33
+ pinned: 'Agents can only use the tabs you pin below (one or several). They cannot open or touch any other tab.'
34
+ };
35
+
36
+ async function tabInfo(id) {
37
+ try {
38
+ const t = await chrome.tabs.get(id);
39
+ return `${(t.title || t.url || '').slice(0, 44)} (#${id})`;
40
+ } catch {
41
+ return null;
42
+ }
43
+ }
44
+
45
+ // ---- connection: ONE state, ONE message, the matching action ------------------------------------------------
46
+ // This block is the first thing in the popup. Anyone who has not installed the helper must see, at once, that it
47
+ // is needed and exactly what to run; nobody should have to scroll or wait to learn that.
48
+ // connected agents can use this browser [Disconnect]
49
+ // paused you pressed Disconnect [Connect]
50
+ // notfound nothing to connect to: show the install step [Copy] [Setup guide] [Connect now]
51
+ const INSTALL_CMD = 'npx @agentruntime-labs/browser-agent install';
52
+ const START_CMD = 'browser-agent daemon';
53
+
54
+ function connState(st) {
55
+ if (st.connected) return 'connected';
56
+ if (Date.now() < connectingUntil) return 'connecting';
57
+ if (st.autoConnectOff) return 'paused';
58
+ // Seen a helper before: it is installed but not running. Never seen one: it probably is not installed yet.
59
+ return st.everConnected ? 'stopped' : 'notfound';
60
+ }
61
+
62
+ function mkButton(label, cls, onClick) {
63
+ const b = document.createElement('button');
64
+ b.type = 'button';
65
+ b.textContent = label;
66
+ if (cls) b.className = cls;
67
+ b.onclick = onClick;
68
+ return b;
69
+ }
70
+
71
+ function renderConnection(st, ports) {
72
+ const state = connState(st);
73
+ const view = {
74
+ connected: { pill: 'Connected', title: 'Connected', text: 'Agents can use this browser.' },
75
+ connecting: { pill: 'Connecting...', title: 'Connecting...', text: 'Looking for the helper on this computer. This takes a few seconds.' },
76
+ paused: { pill: 'Paused', title: 'Paused', text: 'You pressed Disconnect, so agents cannot use this browser until you connect again.' },
77
+ stopped: {
78
+ pill: 'Not connected',
79
+ title: 'Helper not running',
80
+ text: 'The helper stopped, or your AI app is closed. Start Claude Desktop or Cursor, or run the command below. This connects by itself as soon as it is running.'
81
+ },
82
+ notfound: {
83
+ pill: 'Not connected',
84
+ title: 'Install the helper to start',
85
+ text: 'This extension needs a small free helper on your computer (Node.js 18 or newer). Run this once in a terminal, then restart Claude Desktop or Cursor. Already installed? It connects by itself in a few seconds.'
86
+ }
87
+ }[state];
88
+ $('pill').className = 'pill' + (state === 'connected' ? ' on' : '');
89
+ $('pillText').textContent = view.pill;
90
+ $('connTitle').textContent = view.title;
91
+ $('connText').textContent = view.text;
92
+
93
+ const cmd = $('cmdBox');
94
+ cmd.hidden = state !== 'notfound' && state !== 'stopped';
95
+ cmd.textContent = state === 'stopped' ? START_CMD : INSTALL_CMD;
96
+
97
+ const agents = $('agents');
98
+ agents.textContent = '';
99
+ if (state === 'connected') {
100
+ for (const p of ports) {
101
+ const row = document.createElement('div');
102
+ row.className = 'agent';
103
+ const a = document.createElement('span');
104
+ a.textContent = `Helper on port ${p}`;
105
+ const b = document.createElement('span');
106
+ b.textContent = st.lastRequest && st.lastRequest.port === p ? `${st.lastRequest.method}, ${ago(st.lastRequest.at)}` : 'idle';
107
+ row.append(a, b);
108
+ agents.appendChild(row);
109
+ }
110
+ }
111
+
112
+ const actions = $('connActions');
113
+ actions.textContent = '';
114
+ const more = $('connMore');
115
+ more.textContent = '';
116
+ if (state === 'connecting') {
117
+ const b = mkButton('Connecting...', '', () => {});
118
+ b.disabled = true;
119
+ actions.append(b);
120
+ } else if (state === 'connected') {
121
+ actions.append(mkButton('Disconnect', 'small', () => $('disconnect').click()));
122
+ } else if (state === 'paused') {
123
+ actions.append(mkButton('Connect', 'primary', () => $('connect').click()));
124
+ } else if (state === 'stopped') {
125
+ actions.append(
126
+ mkButton('Connect now', 'primary', () => $('connect').click()),
127
+ mkButton('Copy command', '', async () => {
128
+ try {
129
+ await navigator.clipboard.writeText(START_CMD);
130
+ setStatus('Copied. Paste it in a terminal.', 'ok');
131
+ } catch {
132
+ setStatus('Could not copy. Select the command above.', 'err');
133
+ }
134
+ }),
135
+ mkButton('Setup guide', 'small', () => $('openGuide').click())
136
+ );
137
+ more.textContent = 'Reinstalling or setting up again? Run: ' + INSTALL_CMD;
138
+ } else {
139
+ actions.append(
140
+ mkButton('Copy command', 'primary', async () => {
141
+ try {
142
+ await navigator.clipboard.writeText(INSTALL_CMD);
143
+ setStatus('Copied. Paste it in a terminal.', 'ok');
144
+ } catch {
145
+ setStatus('Could not copy. Select the command above and copy it.', 'err');
146
+ }
147
+ }),
148
+ mkButton('Setup guide', '', () => $('openGuide').click()),
149
+ mkButton('Connect now', 'small', () => $('connect').click())
150
+ );
151
+ more.textContent = 'Helper installed but not running? Start Claude Desktop or Cursor, or run: browser-agent daemon';
152
+ }
153
+ }
154
+
155
+ async function render() {
156
+ $('ver').textContent = ' v' + chrome.runtime.getManifest().version;
157
+ const stored = await chrome.storage.local.get(['wsPort', 'sessionToken', 'connectedTabId', 'profileLabel']);
158
+ if (firstRender && location.hash.length > 1) {
159
+ const q = new URLSearchParams(location.hash.slice(1));
160
+ if (q.get('port')) $('port').value = q.get('port');
161
+ if (q.get('token') !== null) $('token').value = q.get('token');
162
+ }
163
+ if (firstRender) {
164
+ if (stored.wsPort && !location.hash) $('port').value = String(stored.wsPort);
165
+ if (stored.sessionToken && !location.hash) $('token').value = String(stored.sessionToken);
166
+ firstRender = false;
167
+ }
168
+
169
+ const st = await chrome.runtime.sendMessage({ type: 'get-ws-status' }).catch(() => ({ connected: false }));
170
+
171
+ // Profile name: show the name agents actually see, including the automatic one.
172
+ if (document.activeElement !== $('label')) {
173
+ $('label').value = stored.profileLabel || st.label || '';
174
+ }
175
+ $('labelHint').textContent = stored.profileLabel
176
+ ? 'Agents see this name when they choose a browser profile.'
177
+ : 'Automatic name. Rename it so agents can tell your profiles apart.';
178
+ $('instanceId').textContent = st.instanceId ? `profile id ${st.instanceId.slice(0, 8)}` : '';
179
+
180
+ const ports = st.ports ?? [];
181
+ renderConnection(st, ports);
182
+
183
+ const mode = st.tabMode || 'freeform';
184
+ for (const [id, m] of [['modeFreeform', 'freeform'], ['modeFollow', 'follow'], ['modePinned', 'pinned']]) {
185
+ $(id).classList.toggle('active', mode === m);
186
+ }
187
+ $('modeHelp').textContent = MODE_HELP[mode];
188
+ $('pinBox').hidden = mode !== 'pinned';
189
+ if (mode === 'pinned') {
190
+ const list = $('pinList');
191
+ list.textContent = '';
192
+ const ids = st.pinned ?? [];
193
+ if (!ids.length) {
194
+ const d = document.createElement('div');
195
+ d.className = 'hint';
196
+ d.textContent = 'No tab pinned yet. Go to the tab you want and click Pin this tab.';
197
+ list.appendChild(d);
198
+ }
199
+ for (const id of ids) {
200
+ const row = document.createElement('div');
201
+ row.className = 'agent';
202
+ const name = document.createElement('span');
203
+ name.textContent = (await tabInfo(id)) ?? `#${id}`;
204
+ const x = document.createElement('button');
205
+ x.className = 'small';
206
+ x.type = 'button';
207
+ x.textContent = 'Unpin';
208
+ x.onclick = () => unpin(id);
209
+ row.append(name, x);
210
+ list.appendChild(row);
211
+ }
212
+ }
213
+ const live = st.lastRequest?.tabId != null ? await tabInfo(st.lastRequest.tabId) : null;
214
+ $('tabLive').textContent = live ? `Last acted on: ${live}` : '';
215
+ }
216
+
217
+ // ---- connection -------------------------------------------------------------------------------
218
+ $('connect').onclick = async () => {
219
+ const port = parseInt($('port').value, 10);
220
+ const token = $('token').value.trim();
221
+ if (!Number.isFinite(port) || port <= 0) {
222
+ setStatus('Invalid port', 'err');
223
+ return;
224
+ }
225
+ connectingUntil = Date.now() + 8000;
226
+ void render();
227
+ const poll = setInterval(() => void render(), 600);
228
+ await chrome.storage.local.set({ wsPort: port, sessionToken: token });
229
+ const r = await chrome.runtime.sendMessage({ type: 'connect', port, token });
230
+ connectingUntil = 0;
231
+ clearInterval(poll);
232
+ setStatus(r?.ok ? 'Connected.' : 'No helper found yet. It will connect by itself when it is running.', r?.ok ? 'ok' : 'err');
233
+ await render();
234
+ };
235
+
236
+ $('disconnect').onclick = async () => {
237
+ await chrome.runtime.sendMessage({ type: 'disconnect' });
238
+ setStatus('Disconnected. Auto-connect is off until you press Connect.');
239
+ await render();
240
+ };
241
+
242
+ // ---- which tabs agents can use ---------------------------------------------------------------------
243
+ // Only this popup changes the mode or the pins: no agent tool or CLI command can, so the pin really is a lock.
244
+ async function pinnedIds() {
245
+ const o = await chrome.storage.local.get(['pinnedTabs', 'connectedTabId']);
246
+ if (Array.isArray(o.pinnedTabs)) return o.pinnedTabs;
247
+ return o.connectedTabId != null ? [o.connectedTabId] : [];
248
+ }
249
+ async function setMode(mode) {
250
+ await chrome.storage.local.set({ tabMode: mode });
251
+ await render();
252
+ }
253
+ async function pinCurrent() {
254
+ const [tab] = await chrome.tabs.query({ active: true, currentWindow: true });
255
+ if (!tab?.id) {
256
+ setStatus('No tab to pin', 'err');
257
+ return;
258
+ }
259
+ const ids = await pinnedIds();
260
+ if (!ids.includes(tab.id)) ids.push(tab.id);
261
+ await chrome.storage.local.set({ pinnedTabs: ids, tabMode: 'pinned' });
262
+ setStatus(`Pinned: ${(tab.title || '').slice(0, 40)}`, 'ok');
263
+ await render();
264
+ }
265
+ async function unpin(id) {
266
+ await chrome.storage.local.set({ pinnedTabs: (await pinnedIds()).filter((x) => x !== id) });
267
+ await render();
268
+ }
269
+ $('modeFreeform').onclick = () => setMode('freeform');
270
+ $('modeFollow').onclick = () => setMode('follow');
271
+ $('modePinned').onclick = () => setMode('pinned');
272
+ $('pinThis').onclick = pinCurrent;
273
+
274
+ // ---- profile name -----------------------------------------------------------------------------
275
+ $('saveLabel').onclick = async () => {
276
+ const r = await chrome.runtime.sendMessage({ type: 'set-label', label: $('label').value });
277
+ setStatus(r?.ok ? `Saved as "${r.label}". Reconnecting...` : 'Could not save the name.', r?.ok ? 'ok' : 'err');
278
+ $('label').blur();
279
+ setTimeout(render, 800);
280
+ };
281
+ $('label').addEventListener('keydown', (e) => {
282
+ if (e.key === 'Enter') $('saveLabel').click();
283
+ });
284
+
285
+ // ---- DevTools permission ----------------------------------------------------------------------
286
+ async function refreshDevtools() {
287
+ const o = await chrome.storage.local.get(['devtoolsMode', 'devtoolsUntil']);
288
+ const always = o.devtoolsMode === 'always';
289
+ const left = typeof o.devtoolsUntil === 'number' ? Math.ceil((o.devtoolsUntil - Date.now()) / 60000) : 0;
290
+ $('devtools').checked = always || left > 0;
291
+ $('devtoolsNote').textContent = always
292
+ ? 'Allowed until you turn it off. Chrome shows its debugging bar only during calls that need it.'
293
+ : left > 0
294
+ ? `Allowed for about ${left} more minute${left === 1 ? '' : 's'}. Chrome shows its debugging bar only during calls that need it.`
295
+ : 'Off. No Chrome debugging bar. Needed only for dark-mode emulation and full-page screenshots.';
296
+ }
297
+ $('devtools').onchange = async (e) => {
298
+ if (e.target.checked) {
299
+ await chrome.storage.local.set({ devtoolsMode: 'always' });
300
+ } else {
301
+ await chrome.storage.local.remove(['devtoolsMode', 'devtoolsUntil']);
302
+ }
303
+ await refreshDevtools();
304
+ };
305
+ chrome.storage.local.get('autoDevtools').then(({ autoDevtools }) => {
306
+ $('autoDevtools').checked = autoDevtools !== false;
307
+ });
308
+ $('autoDevtools').onchange = (e) => {
309
+ void chrome.storage.local.set({ autoDevtools: e.target.checked });
310
+ };
311
+
312
+ // ---- copy helpers -----------------------------------------------------------------------------
313
+ async function bridgePort() {
314
+ const { serverBridgePort } = await chrome.storage.local.get('serverBridgePort');
315
+ const field = parseInt($('port').value, 10);
316
+ if (typeof serverBridgePort === 'number' && serverBridgePort > 0) return serverBridgePort;
317
+ return Number.isFinite(field) ? field : DEFAULT_WS_PORT;
318
+ }
319
+
320
+ $('copyMcpSnippet').onclick = async () => {
321
+ const port = await bridgePort();
322
+ const obj = {
323
+ mcpServers: {
324
+ 'browser-automation': {
325
+ command: 'node',
326
+ args: ['REPLACE_WITH_ABSOLUTE_PATH_TO_REPO/server/dist/main.js'],
327
+ env: {
328
+ BROWSER_AUTOMATION_WS_PORT: String(port),
329
+ BROWSER_AUTOMATION_CONFIRM_CROSS_ORIGIN: '0',
330
+ BROWSER_AUTOMATION_CONFIRM_TAB_CLOSE: '0',
331
+ BROWSER_AUTOMATION_ALLOW_EVAL: '0'
332
+ }
333
+ }
334
+ }
335
+ };
336
+ try {
337
+ await navigator.clipboard.writeText(JSON.stringify(obj, null, 2));
338
+ setStatus('Copied. Replace REPLACE_WITH_ABSOLUTE_PATH_TO_REPO in args[0].', 'ok');
339
+ } catch {
340
+ setStatus('Clipboard failed.', 'err');
341
+ }
342
+ };
343
+
344
+ $('copyPairing').onclick = async () => {
345
+ const port = await bridgePort();
346
+ const token = $('token').value.trim();
347
+ const block = [
348
+ `WebSocket port: ${port}`,
349
+ `SESSION token: ${token || '(empty: use --insecure-no-token server)'}`,
350
+ '',
351
+ 'Deep link: ' + chrome.runtime.getURL(`popup.html#port=${encodeURIComponent(String(port))}`)
352
+ ].join('\n');
353
+ try {
354
+ await navigator.clipboard.writeText(block);
355
+ setStatus('Copied pairing info.', 'ok');
356
+ } catch {
357
+ setStatus('Clipboard failed.', 'err');
358
+ }
359
+ };
360
+
361
+ chrome.storage.local.get('allowEval').then(({ allowEval }) => {
362
+ $('allowEval').checked = allowEval === true;
363
+ });
364
+ $('allowEval').onchange = (e) => {
365
+ void chrome.storage.local.set({ allowEval: e.target.checked });
366
+ setStatus(e.target.checked ? 'Script evaluation allowed for agents.' : 'Script evaluation switched off.', e.target.checked ? 'err' : 'ok');
367
+ };
368
+
369
+ $('openGuide').onclick = (e) => {
370
+ e.preventDefault();
371
+ void chrome.tabs.create({ url: chrome.runtime.getURL('welcome.html') });
372
+ };
373
+
374
+ void render();
375
+ void refreshDevtools();
376
+ setInterval(() => void render(), 3000);