Open-source AI browser agent for Chrome and Firefox (monorepo) 🧠
JavaScript ai-agentai-agentsai-toolsbrowser-aibrowser-automationbrowser-extensionchrome-aichrome-devtoolschrome-extensionchrome-extensionsfirefox-addonfirefox-addonsfirefox-extensionfirefox-extensionsgemmagemma4minimaxoffline-aioffline-llmqwen
Add opt-in Cloud Bridge browser registration and approval (#3122)
mitchou10fdac040720a8
diff --git a/docs/cloud-bridge-browser-approval.md b/docs/cloud-bridge-browser-approval.mdnew file mode 100644index 000000000..e71c8f32e--- /dev/null+++ b/docs/cloud-bridge-browser-approval.md@@ -0,0 +1,134 @@+# Cloud Bridge browser registration & approval++A backend can require explicit approval of a WebBrain installation before it is allowed to run `cloud_*` commands. The feature is opt-in: **without a Cloud Bridge token the bridge behaves exactly as before** (local MCP server, no approval step).++## Architecture++```+background (cloud-runs.js) --cloud-bridge-start {url, token, browserId, installationId, extensionVersion}--> offscreen (cloud-bridge.js) <== WebSocket ==> backend+```++```mermaid+flowchart LR+ subgraph Browser["User's browser (Chrome)"]+ direction TB+ S["Settings → Cloud Bridge<br/>URL · token · browser name"]+ ST[("chrome.storage.local<br/>url, token, browserId, installationId")]+ BG["Background (cloud-runs.js)<br/>reads config, runs cloud_*"]+ OFF["Offscreen (cloud-bridge.js)<br/>WebSocket + approval state"]+ AG["Agent WebBrain<br/>+ permissions navigate / click…"]+ TAB["Web tabs<br/>(user's sessions)"]+ S --> ST --> BG+ BG -- "cloud-bridge-start + identité" --> OFF+ OFF -- "approved commands" --> BG+ BG --> AG --> TAB+ end+ subgraph Backend["Backend (today: local ws:// only)"]+ SRV["WebSocket server<br/>checks token<br/>approves / rejects"]+ end+ OFF <== "WebSocket opened by the extension" ==> SRV+```++The French guide ([cloud-bridge-test-guide.fr.md](cloud-bridge-test-guide.fr.md)) also has a message-sequence diagram.++**Chrome vs Firefox.** Chrome (MV3) hosts the socket in an offscreen document (`src/chrome/src/offscreen/cloud-bridge.js`). Firefox (MV2) has no offscreen documents, so `src/firefox/src/cloud-bridge.js` is a module that runs in the persistent background page and hands commands directly to `handleMessage`. The protocol, storage keys, approval rules and Settings tab are identical; `src/firefox/src/cloud-runs.js` mirrors the Chrome controller and receives the bridge as an injected dependency.++- `cloud-runs.js` reads the persistent identity from `chrome.storage.local` and passes it to the offscreen page with the existing `cloud-bridge-start` message (the offscreen page has no storage access).+- `offscreen/cloud-bridge.js` sends the enriched `hello` and tracks the approval state **per socket**.+- Command routing (`cloud_run`, `cloud_status`, `cloud_respond`, `cloud_abort`, workflows, scheduled jobs) and payloads are unchanged.++## Local configuration++Keys in `chrome.storage.local` (the existing mechanism; the URL and enable toggle are already in Settings):++| Key | Meaning |+| --- | --- |+| `webbrainCloudBridgeEnabled` | existing toggle |+| `webbrainCloudBridgeUrl` | existing, `ws://` on localhost only |+| `webbrainCloudBridgeToken` | Cloud Bridge credential. Distinct from provider API keys. Setting it turns approval on. |+| `webbrainCloudBridgeBrowserId` | Backend-visible name; defaults to the installation id |+| `webbrainCloudBridgeInstallationId` | Generated once (`crypto.randomUUID()`) |++All of these are editable in **Settings → Cloud Bridge**: enable toggle, backend URL, token, browser name (`browserId`), the read-only installation ID, and a **Save & test connection** button. The test saves the form, (re)starts the bridge and reports one of: backend unreachable, connected (no approval needed), waiting for approval, approved, or rejected (with the reason).++To try it end to end: run `node examples/cloud-bridge-approval-server.mjs --token dev-token`, enter `dev-token` in the tab, press **Save & test connection** (status: waiting for approval), then type `approve` in the server terminal (status: approved) or `reject`.++The older Display → MCP block controls the same enable/URL keys; it is not refreshed live when the new tab changes them (reload Settings).++Changing the token or browserId reconnects the socket.++## Messages++Extension → backend, on every socket open:++```json+{+ "type": "hello",+ "client": "webbrain-extension",+ "protocolVersion": 2,+ "capabilities": ["saved_workflows_v1", "run_modes_v1", "scheduled_jobs_v1"],+ "auth": { "type": "bearer", "token": "dev-token" },+ "browserId": "my-laptop",+ "installationId": "0b0c6a3e-…",+ "browser": { "name": "Chrome", "version": "126.0.0.0" },+ "extensionVersion": "38.0.13",+ "platform": "Linux x86_64",+ "status": { "enabled": true, "approval": "pending", "…": "…" }+}+```++`auth`, `browserId` and `installationId` are only sent when a token is configured. The token is never included in `status`.++Backend → extension:++```json+{ "type": "connection_pending", "browserId": "my-laptop" }+{ "type": "connection_approved", "browserId": "my-laptop" }+{ "type": "connection_rejected", "browserId": "my-laptop", "reason": "Rejected by user" }+```++- `browserId` is optional; if present and different from the local one, the message is ignored.+- `connection_rejected` closes the socket and **stops auto-reconnect** until the settings change or the bridge is restarted.++Until `connection_approved`, any `cloud_*` command gets (and is not forwarded to the background):++```json+{ "id": "c1", "ok": false, "error": "Connection not approved", "code": "connection_not_approved", "status": 403 }+```++After approval, commands are exactly the existing format:++```json+{ "id": "c2", "action": "cloud_status", "payload": { "runId": "run_123" } }+```++`status().approval` is one of `not_required | pending | approved | rejected`.++## Reconnection++Approval belongs to one WebSocket. Every new socket (reconnect, URL/identity change) starts `pending`, resends `hello`, and must be approved again.++## Local test server++`examples/cloud-bridge-approval-server.mjs` is a dependency-free backend for testing:++```bash+node examples/cloud-bridge-approval-server.mjs --token dev-token # manual approval+node examples/cloud-bridge-approval-server.mjs --token dev-token --auto-approve+```++It replies `connection_pending` after a valid `hello` (or `connection_rejected` for a bad token). On stdin, type `approve`, `reject`, or `send {"id":"1","action":"cloud_status","payload":{"runId":"run_x"}}`.++Automated tests (unit with a fake WebSocket + one end-to-end run against that server):++```bash+npm run test:cloud-bridge-approval+```++## Limits & security++- The bridge URL is still restricted to `ws://` on localhost/127.0.0.1/::1. A remote backend needs a local relay, or a deliberate relaxation (needs TLS and a decision upstream).+- The token travels in the `hello` over that local socket; it is stored in plain `chrome.storage.local` like other settings.+- The backend is responsible for validating the token and for the user-facing approval UI; the extension only enforces "no approval, no commands".+- The extension still only accepts the `cloud_*` run actions; no cookies, tabs, history, provider keys or configuration are exposed.+- Approval is not persisted and not revocable from the extension side other than by disabling the bridge or rotating the token.diff --git a/docs/cloud-bridge-test-guide.fr.md b/docs/cloud-bridge-test-guide.fr.mdnew file mode 100644index 000000000..e6419f767--- /dev/null+++ b/docs/cloud-bridge-test-guide.fr.md@@ -0,0 +1,237 @@+# Guide de test (FR) — Cloud Bridge : enregistrement et approbation du navigateur++Guide pas à pas pour installer l'extension en mode développeur et tester la feature de bout en bout. Pour la description technique du protocole, voir [cloud-bridge-browser-approval.md](cloud-bridge-browser-approval.md).++## Schémas++### Architecture++```mermaid+flowchart LR+ subgraph Browser["Navigateur de l'utilisateur (Chrome)"]+ direction TB+ S["Settings → Cloud Bridge<br/>URL · token · nom du navigateur"]+ ST[("chrome.storage.local<br/>url, token, browserId, installationId")]+ BG["Background (cloud-runs.js)<br/>lit la config, exécute les cloud_*"]+ OFF["Offscreen (cloud-bridge.js)<br/>socket WebSocket + état d'approbation"]+ AG["Agent WebBrain<br/>+ permissions navigate / click…"]+ TAB["Onglets web<br/>(sessions de l'utilisateur)"]+ S --> ST --> BG+ BG -- "cloud-bridge-start + identité" --> OFF+ OFF -- "commandes approuvées" --> BG+ BG --> AG --> TAB+ end+ subgraph Backend["Backend (aujourd'hui : ws:// en local uniquement)"]+ SRV["Serveur WebSocket<br/>vérifie le token<br/>approuve / refuse"]+ end+ OFF <== "WebSocket initié par l'extension" ==> SRV+```++### Échange de messages++```mermaid+sequenceDiagram+ participant E as Extension (offscreen)+ participant B as Backend+ participant U as Utilisateur+ E->>B: connexion WebSocket+ E->>B: hello {auth.token, browserId, installationId, navigateur, version, plateforme, capabilities}+ alt token invalide+ B-->>E: connection_rejected+ Note over E: socket fermée, pas de reconnexion auto+ else token valide+ B-->>E: connection_pending+ B->>E: cloud_run (avant approbation)+ E-->>B: ok:false, connection_not_approved (403)+ B->>U: demande de validation du navigateur+ U-->>B: approuve+ B-->>E: connection_approved+ B->>E: cloud_run {task}+ E-->>B: runId, status running+ Note over E: l'agent agit dans le navigateur+ E-->>B: needs_user_input (permission navigate)+ B->>E: cloud_respond {answer: once}+ B->>E: cloud_status {runId}+ E-->>B: status completed + résultat+ end+ Note over E,B: coupure réseau → nouvelle socket → nouveau hello → repart en pending+```++## 1. Prérequis++- Node.js 22 ou plus (`node -v`)+- Google Chrome (ou Chromium)+- Le dépôt, sur la branche de la feature :++```bash+cd ~/Documents/webbrain+git checkout feat/cloud-bridge-browser-approval+npm ci --ignore-scripts # une seule fois, installe les dépendances de dev+```++## 2. Installer l'extension en mode développeur++L'extension Chrome est directement chargeable depuis `src/chrome` (pas de build nécessaire).++1. Ouvrir `chrome://extensions`.+2. Activer **Mode développeur** (interrupteur en haut à droite).+3. Cliquer sur **Charger l'extension non empaquetée**.+4. Sélectionner le dossier `~/Documents/webbrain/src/chrome` (celui qui contient `manifest.json`).+5. WebBrain apparaît dans la liste. Épingler l'icône dans la barre d'outils si besoin.++> Après chaque modification du code : sur `chrome://extensions`, cliquer sur l'icône ↻ de WebBrain, puis recharger la page Settings.++### Firefox++1. Ouvrir `about:debugging#/runtime/this-firefox`.+2. **Charger un module complémentaire temporaire…** et choisir `~/Documents/webbrain/src/firefox/manifest.json`.+3. Ouvrir les préférences de WebBrain (`about:addons` → WebBrain → Préférences, ou la page Settings du panneau latéral) et aller dans l'onglet **Cloud Bridge**. Le reste du guide (serveur de test, scénarios A à F) est identique.++Le module est temporaire : il disparaît au redémarrage de Firefox. Sur Firefox, la socket vit dans la page d'arrière-plan (pas de document offscreen) ; pour déboguer, `about:debugging` → WebBrain → **Inspecter**.++Alternative (copie construite) : `npm run build:chrome` génère `build/chrome`, à charger de la même façon.++## 3. Lancer le serveur de test local++Dans un terminal (le laisser ouvert) :++```bash+cd ~/Documents/webbrain+node examples/cloud-bridge-approval-server.mjs --token dev-token+```++Vous devez voir : `Listening on ws://127.0.0.1:17374/extension`.++Options : `--port 17374` (défaut), `--auto-approve` (approuve automatiquement, pratique pour tester les commandes).++Ce terminal sert à la fois de **backend** (il affiche tout ce que l'extension envoie, préfixé par `<-`) et de **console d'approbation**.++## 4. Configurer l'extension++1. Ouvrir les Settings de WebBrain (clic droit sur l'icône → Options, ou la roue dentée du panneau latéral).+2. Aller dans l'onglet **Cloud Bridge**.+3. Remplir :+ - **Backend WebSocket URL** : `ws://127.0.0.1:17374/extension` (seul `ws://` en local est accepté)+ - **Cloud Bridge token** : `dev-token` (le même que `--token` du serveur)+ - **Browser name** : par exemple `mon-chrome` (optionnel ; sinon l'ID d'installation sert de nom)+4. Cliquer sur **Save & test connection** (cela active aussi l'interrupteur).++Le statut passe à : *Connected — waiting for the backend to approve this browser.*++Dans le terminal du serveur, vous voyez le `hello` reçu, par exemple :++```json+{"type":"hello","client":"webbrain-extension","protocolVersion":2,+ "capabilities":["saved_workflows_v1","run_modes_v1","scheduled_jobs_v1"],+ "auth":{"type":"bearer","token":"dev-token"},+ "browserId":"mon-chrome","installationId":"…",+ "browser":{"name":"Chrome","version":"…"},"extensionVersion":"38.0.13","platform":"Linux", …}+```++## 5. Scénarios à tester++### A. Commande avant approbation (doit être refusée)++Dans le terminal du serveur, taper :++```+send {"id":"1","action":"cloud_status","payload":{"runId":"x"}}+```++Réponse attendue (affichée par le serveur) :++```json+{"id":"1","ok":false,"error":"Connection not approved","code":"connection_not_approved","status":403}+```++### B. Approbation, puis commande++```+approve+```++Le statut dans Settings devient *Connected and approved.* (il se rafraîchit toutes les 2 s). Puis :++```+send {"id":"2","action":"cloud_status","payload":{"runId":"x"}}+```++Réponse attendue : `"ok":false,"error":"Unknown cloud run."` — c'est normal, le run `x` n'existe pas ; ce qui compte est que la commande a **atteint** WebBrain (plus de `connection_not_approved`).++Pour lancer un vrai run, voir le format existant de `cloud_run` dans la doc technique (même payload qu'avant la feature).++### C. Refus++Dans le terminal : `reject`. Le statut devient *Rejected by the backend: …*, la socket est fermée et l'extension **ne se reconnecte plus** toute seule. Pour réessayer : **Save & test connection**.++### D. Reconnexion++1. Arrêter le serveur (Ctrl+C) puis le relancer : l'extension se reconnecte automatiquement (délai croissant, jusqu'à 30 s).+2. Elle renvoie un `hello`, et la connexion est de nouveau **en attente** : toute commande est refusée tant que vous n'avez pas retapé `approve`.++Note connue : juste après une reconnexion, le texte de statut de la page Settings peut rester sur « approved » alors que la connexion est repassée en attente ; les commandes sont bien refusées. Cliquer sur **Save & test connection** pour resynchroniser l'affichage.++### E. Mauvais token++Mettre un autre token dans Settings puis **Save & test connection** : le serveur répond `connection_rejected` (« Invalid token »).++### F. Mode historique (sans token)++Vider le champ token et sauvegarder : plus aucune approbation n'est exigée, le comportement est celui d'avant la feature (serveur MCP local inchangé). Le serveur de test ne l'acceptera pas (il exige un token) ; ce mode se teste avec le serveur MCP du dépôt (`mcp-server/`).++## 6. Inspecter / déboguer++- **Console du service worker** : `chrome://extensions` → WebBrain → *service worker* → Console.+- **Voir la config stockée** (même console) :++```js+chrome.storage.local.get(null, v => console.log(+ Object.fromEntries(Object.entries(v).filter(([k]) => k.startsWith('webbrainCloudBridge')))))+```++- **Statut du bridge** : dans cette console, `chrome.runtime.sendMessage({target:'background', action:'cloud_bridge_status'}).then(console.log)` — renvoie `approval` (`not_required | pending | approved | rejected`), jamais le token.+- **Repartir de zéro** : `chrome.storage.local.remove(['webbrainCloudBridgeToken','webbrainCloudBridgeBrowserId','webbrainCloudBridgeInstallationId','webbrainCloudBridgeEnabled'])`.++Problèmes fréquents :++| Symptôme | Cause probable |+| --- | --- |+| *Backend unreachable* | Le serveur n'est pas lancé, mauvais port, ou URL autre que `ws://127.0.0.1/localhost` |+| Rien ne change après modification du code | Extension non rechargée (↻ sur `chrome://extensions`) |+| Reste « Rejected » | Normal : pas de reconnexion auto après un refus, cliquer sur **Save & test connection** |+| Port 17374 déjà utilisé | Un serveur MCP tourne déjà : l'arrêter ou utiliser `--port` (et changer l'URL dans Settings) |++## 7. Tests automatisés++```bash+npm run test:cloud-bridge-approval # 18 tests (Chrome + Firefox) : hello, pending, approved, rejected, commande avant/après, reconnexion, minuteur annulé après refus, mode sans token, identité unique, e2e vs serveur d'exemple+node test/run.js # suite complète existante (≈ 2400 tests)+```++## 8. Bonnes pratiques de sécurité pour vos essais++- Utilisez un token de test (`dev-token`), jamais une vraie clé API de provider : le token du Cloud Bridge est distinct.+- Le token est stocké en clair dans `chrome.storage.local` et envoyé dans le `hello` (en local uniquement).+- Le serveur d'exemple est un outil de test local, pas un backend de production.++## 9. Test réel : lancer une vraie tâche (`cloud_run`)++Pré-requis côté WebBrain : un **provider LLM configuré** (onglet Providers, avec sa clé API) et un onglet web ouvert (le run s'exécute dans l'onglet actif). Les permissions habituelles de WebBrain s'appliquent comme pour un utilisateur humain.++Avec le serveur d'exemple, après `approve` :++```+run Ouvre example.com et dis-moi le titre de la page+status # liste les runs+status run_xxxxx # état d'un run (l'id est dans la réponse de cloud_run)+```++`run <texte>` envoie `{"action":"cloud_run","payload":{"task":"<texte>","mode":"act"}}` ; la réponse contient un `runId` et `status: "running"`. Interrogez ensuite avec `cloud_status`. Si l'agent pose une question (`pendingInput`), répondez avec `send {"id":"r1","action":"cloud_respond","payload":{"runId":"run_xxxxx","clarifyId":"…","answer":"…"}}` ; `cloud_abort` (`payload: {"runId":"…"}`) interrompt le run.++### Avec votre propre backend++Votre backend doit :+1. **Écouter en WebSocket** sur une URL `ws://127.0.0.1` / `localhost` / `::1` (l'extension se connecte *vers* lui). Un backend distant n'est pas accepté tel quel : utilisez un relais local ou voyez la décision « URL localhost uniquement » dans la doc technique.+2. À la réception du `hello`, vérifier `auth.token`, puis répondre `{"type":"connection_pending"}` puis, après validation côté utilisateur, `{"type":"connection_approved"}` (ou `connection_rejected`).+3. Envoyer ensuite les commandes `{"id","action","payload"}` et lire les réponses `{"id","ok","result"|"error"}`.+diff --git a/examples/cloud-bridge-approval-server.mjs b/examples/cloud-bridge-approval-server.mjsnew file mode 100644index 000000000..aca4983e0--- /dev/null+++ b/examples/cloud-bridge-approval-server.mjs@@ -0,0 +1,131 @@+#!/usr/bin/env node+// Minimal local WebSocket backend for the Cloud Bridge browser approval flow.+// Dependency-free (RFC 6455 text frames only). For local testing, not production.+//+// node examples/cloud-bridge-approval-server.mjs --token dev-token [--port 17374] [--auto-approve]+//+// Interactive commands on stdin once a browser is pending/approved:+// approve | reject | run <task> | status [runId] | send {"id":"1","action":"cloud_status","payload":{"runId":"run_x"}}++import { createHash } from 'node:crypto';+import { createServer } from 'node:http';+import { createInterface } from 'node:readline';+import { fileURLToPath } from 'node:url';++const GUID = '258EAFA5-E914-47DA-95CA-C5AB0DC85B11';++function encodeFrame(text) {+ const payload = Buffer.from(text);+ const n = payload.length;+ const head = n < 126 ? Buffer.from([0x81, n])+ : n < 65536 ? Buffer.from([0x81, 126, n >> 8, n & 255])+ : Buffer.concat([Buffer.from([0x81, 127]), Buffer.alloc(4), Buffer.from([n >>> 24, (n >> 16) & 255, (n >> 8) & 255, n & 255])]);+ return Buffer.concat([head, payload]);+}++// Returns { messages, rest, close } for the frames buffered so far.+function decodeFrames(buf) {+ const messages = [];+ let close = false;+ while (buf.length >= 2) {+ const opcode = buf[0] & 15;+ let len = buf[1] & 127;+ let off = 2;+ if (len === 126) { if (buf.length < 4) break; len = buf.readUInt16BE(2); off = 4; }+ else if (len === 127) { if (buf.length < 10) break; len = Number(buf.readBigUInt64BE(2)); off = 10; }+ const masked = (buf[1] & 128) !== 0;+ if (buf.length < off + (masked ? 4 : 0) + len) break;+ const mask = masked ? buf.subarray(off, off + 4) : null;+ if (masked) off += 4;+ const data = Buffer.from(buf.subarray(off, off + len));+ if (mask) for (let i = 0; i < data.length; i++) data[i] ^= mask[i % 4];+ buf = buf.subarray(off + len);+ if (opcode === 8) { close = true; break; }+ if (opcode === 1) messages.push(data.toString('utf8'));+ }+ return { messages, rest: buf, close };+}++export function startApprovalServer({ port = 17374, host = '127.0.0.1', token = 'dev-token', autoApprove = false, onMessage = () => {} } = {}) {+ const sessions = new Set();+ const server = createServer((_req, res) => { res.writeHead(426).end(); });+ server.on('upgrade', (req, socket) => {+ const key = req.headers['sec-websocket-key'];+ if (!key) { socket.destroy(); return; }+ socket.write([+ 'HTTP/1.1 101 Switching Protocols',+ 'Upgrade: websocket',+ 'Connection: Upgrade',+ `Sec-WebSocket-Accept: ${createHash('sha1').update(key + GUID).digest('base64')}`,+ '', '',+ ].join('\r\n'));+ const session = {+ socket,+ hello: null,+ state: 'connected',+ send: (obj) => socket.write(encodeFrame(JSON.stringify(obj))),+ approve() {+ session.state = 'approved';+ session.send({ type: 'connection_approved', browserId: session.hello?.browserId });+ },+ reject(reason = 'Rejected by user') {+ session.state = 'rejected';+ session.send({ type: 'connection_rejected', browserId: session.hello?.browserId, reason });+ },+ };+ sessions.add(session);+ let buffered = Buffer.alloc(0);+ socket.on('data', (chunk) => {+ const decoded = decodeFrames(Buffer.concat([buffered, chunk]));+ buffered = decoded.rest;+ for (const text of decoded.messages) {+ let msg;+ try { msg = JSON.parse(text); } catch { continue; }+ if (msg.type === 'hello') {+ session.hello = msg;+ if (msg.auth?.token !== token || !msg.browserId) session.reject('Invalid token');+ else {+ session.state = 'pending';+ session.send({ type: 'connection_pending', browserId: msg.browserId });+ if (autoApprove) session.approve();+ }+ }+ onMessage(msg, session);+ }+ if (decoded.close) socket.end();+ });+ socket.on('close', () => sessions.delete(session));+ socket.on('error', () => sessions.delete(session));+ });+ return new Promise((resolve) => server.listen(port, host, () => resolve({+ port: server.address().port,+ sessions,+ close: () => new Promise((done) => {+ for (const s of sessions) s.socket.destroy();+ server.closeAllConnections?.();+ server.close(done);+ }),+ })));+}++if (process.argv[1] === fileURLToPath(import.meta.url)) {+ const args = process.argv.slice(2);+ const opt = (name, fallback) => (args.includes(name) ? args[args.indexOf(name) + 1] : fallback);+ const srv = await startApprovalServer({+ port: Number(opt('--port', 17374)),+ token: opt('--token', 'dev-token'),+ autoApprove: args.includes('--auto-approve'),+ onMessage: (msg) => console.log('<-', JSON.stringify(msg)),+ });+ console.log(`Listening on ws://127.0.0.1:${srv.port}/extension`);+ const current = () => [...srv.sessions].at(-1);+ createInterface({ input: process.stdin }).on('line', (line) => {+ const session = current();+ if (!session) return console.log('No browser connected.');+ if (line === 'approve') session.approve();+ else if (line === 'reject') session.reject();+ else if (line.startsWith('run ')) session.send({ id: `run-${Date.now()}`, action: 'cloud_run', payload: { task: line.slice(4), mode: 'act' } });+ else if (line.startsWith('status')) session.send({ id: `st-${Date.now()}`, action: 'cloud_status', payload: line.slice(6).trim() ? { runId: line.slice(6).trim() } : {} });+ else if (line.startsWith('send ')) session.send(JSON.parse(line.slice(5)));+ });+}diff --git a/package.json b/package.jsonindex 4473ac773..be2b5597f 100644--- a/package.json+++ b/package.json@@ -5,7 +5,7 @@"private": true,"type": "module","scripts": {- "test": "npm run test:cms && npm run test:markdown && npm run test:systemone && npm run test:systemone:fast && node --test test/browser-dialogs.mjs test/capsolver-cloud-broker.mjs test/captcha-providers.mjs test/captcha-weighted-fallback.mjs test/captcha-hcaptcha-providers.mjs test/captcha-native-providers.mjs test/captcha-runtime-policy.mjs test/captcha-callback-bridge.mjs test/captcha-aws-recovery.mjs test/captcha-documented-contracts.mjs test/huggingface-signup-recovery.mjs test/trace-full-export.mjs && npm run test:firefox-bidi && npm run test:runtime-lifecycle && npm run test:provider-limits && npm run test:accessibility-tree-benchmark && npm run test:toolbar-guard && npm run test:discord && npm run test:pdf-read && npm run test:pdf-selection && npm run test:social-contract && npm run test:safesocial && npm run test:build-unpacked && npm run test:attachment-drop && npm run test:workflow-editor && node --test test/profile-sync-stats.mjs && node test/run.js && node test/selection-scope-restoration.mjs && node scripts/benchmark-offline-relevance.mjs && npm run test:security",+ "test": "npm run test:cms && npm run test:markdown && npm run test:systemone && npm run test:systemone:fast && node --test test/browser-dialogs.mjs test/capsolver-cloud-broker.mjs test/captcha-providers.mjs test/captcha-weighted-fallback.mjs test/captcha-hcaptcha-providers.mjs test/captcha-native-providers.mjs test/captcha-runtime-policy.mjs test/captcha-callback-bridge.mjs test/captcha-aws-recovery.mjs test/captcha-documented-contracts.mjs test/huggingface-signup-recovery.mjs test/trace-full-export.mjs && npm run test:firefox-bidi && npm run test:runtime-lifecycle && npm run test:provider-limits && npm run test:accessibility-tree-benchmark && npm run test:toolbar-guard && npm run test:cloud-bridge-approval && npm run test:discord && npm run test:pdf-read && npm run test:pdf-selection && npm run test:social-contract && npm run test:safesocial && npm run test:build-unpacked && npm run test:attachment-drop && npm run test:workflow-editor && node --test test/profile-sync-stats.mjs && node test/run.js && node test/selection-scope-restoration.mjs && node scripts/benchmark-offline-relevance.mjs && npm run test:security","test:captcha:ui": "node test/captcha-settings-ui.mjs && node test/captcha-application-ui.mjs","test:captcha:bridge:ui": "node test/captcha-callback-bridge-ui.mjs","test:provider-limits": "node test/provider-model-limits.mjs",@@ -14,6 +14,7 @@"test:attachment-drop": "node test/attachment-drop.mjs","test:workflow-editor": "node --test test/workflow-editor.mjs","test:security": "node test/security/injection-corpus.mjs",+ "test:cloud-bridge-approval": "node --test test/cloud-bridge-approval.mjs","test:discord": "node --test test/discord-guard.mjs","test:toolbar-guard": "node test/rich-text-toolbar-guard.mjs","test:pdf-read": "node test/pdf-read.mjs",diff --git a/src/chrome/src/background.js b/src/chrome/src/background.jsindex 95a7fe3ee..19f0d9ebf 100644--- a/src/chrome/src/background.js+++ b/src/chrome/src/background.js@@ -1212,7 +1212,8 @@ chrome.storage.onChanged.addListener((changes, areaName) => {}if (PROFILE_SYNC_DATA_KEYS.some((key) => changes[key])) profileSync.noteChanges(changes).catch(() => {});if (changes.providers || changes.activeProvider || changes.helpImproveWebBrain) providerManager.load().catch(() => {});- if (changes.webbrainCloudBridgeEnabled || changes.webbrainCloudBridgeUrl) {+ if (changes.webbrainCloudBridgeEnabled || changes.webbrainCloudBridgeUrl+ || changes.webbrainCloudBridgeToken || changes.webbrainCloudBridgeBrowserId) {cloudRunController.syncBridge().catch(() => {});}if (changes.maxAgentSteps) {diff --git a/src/chrome/src/cloud-runs.js b/src/chrome/src/cloud-runs.jsindex 68b72707c..6be36b3bc 100644--- a/src/chrome/src/cloud-runs.js+++ b/src/chrome/src/cloud-runs.js@@ -1391,9 +1391,47 @@ export function createCloudRunController({return cloudSnapshot(run);}+ // Persistent bridge identity (chrome.storage.local). The token is the Cloud+ // Bridge credential only; it is unrelated to provider API keys.+ //+ // Concurrent starts (a settings save triggers syncBridge while the page also+ // sends cloud_bridge_start) must not each mint an installation id, so the+ // read-or-create step is single-flight.+ let installationIdInit = null;+ function ensureInstallationId() {+ if (!installationIdInit) {+ installationIdInit = (async () => {+ const stored = await api.storage.local.get('webbrainCloudBridgeInstallationId');+ if (stored.webbrainCloudBridgeInstallationId) return stored.webbrainCloudBridgeInstallationId;+ const created = crypto.randomUUID();+ await api.storage.local.set({ webbrainCloudBridgeInstallationId: created });+ return created;+ })().finally(() => { installationIdInit = null; });+ }+ return installationIdInit;+ }++ async function bridgeIdentity() {+ const installationId = await ensureInstallationId();+ const stored = await api.storage.local.get([+ 'webbrainCloudBridgeToken',+ 'webbrainCloudBridgeBrowserId',+ ]);+ return {+ token: stored.webbrainCloudBridgeToken || '',+ browserId: stored.webbrainCloudBridgeBrowserId || installationId,+ installationId,+ extensionVersion: api.runtime.getManifest?.().version || '',+ };+ }+async function startBridge(url = DEFAULT_CLOUD_BRIDGE_URL) {await ensureOffscreen();- return api.runtime.sendMessage({ type: 'cloud-bridge-start', url: normalizeCloudBridgeUrl(url) });+ return api.runtime.sendMessage({+ type: 'cloud-bridge-start',+ url: normalizeCloudBridgeUrl(url),+ ...(await bridgeIdentity()),+ });}async function stopBridge() {diff --git a/src/chrome/src/offscreen/cloud-bridge.js b/src/chrome/src/offscreen/cloud-bridge.jsindex 45708756c..19d9fd488 100644--- a/src/chrome/src/offscreen/cloud-bridge.js+++ b/src/chrome/src/offscreen/cloud-bridge.js@@ -28,6 +28,24 @@let reconnectTimer = null;let reconnectAttempt = 0;let lastError = '';+ // Browser registration/approval. Identity is pushed by the background worker+ // with `cloud-bridge-start` (the offscreen page has no storage access). When+ // a token is configured the backend must approve each new socket before any+ // cloud_* command runs; without a token the legacy local behaviour is kept.+ let identity = { token: '', browserId: '', installationId: '', extensionVersion: '' };+ let approval = 'not_required'; // not_required | pending | approved | rejected++ function browserInfo() {+ const ua = (typeof navigator !== 'undefined' && navigator.userAgent) || '';+ const match = /(Edg|Firefox|Chrome)\/([\d.]+)/.exec(ua);+ const names = { Edg: 'Edge', Firefox: 'Firefox', Chrome: 'Chrome' };+ return { name: match ? names[match[1]] : 'unknown', version: match ? match[2] : '' };+ }++ function platformName() {+ if (typeof navigator === 'undefined') return '';+ return navigator.userAgentData?.platform || navigator.platform || '';+ }function normalizeBridgeUrl(value) {const url = new URL(String(value || 'ws://127.0.0.1:17374/extension'));@@ -44,6 +62,9 @@return {enabled,url: bridgeUrl,+ browserId: identity.browserId || null,+ installationId: identity.installationId || null,+ approval,connected: socket?.readyState === WebSocket.OPEN,readyState: socket ? socket.readyState : null,reconnectAttempt,@@ -79,13 +100,24 @@if (socket !== nextSocket) return;reconnectAttempt = 0;lastError = '';- sendJson({+ // Every new socket starts unapproved; approval never carries over.+ approval = identity.token ? 'pending' : 'not_required';+ const hello = {type: 'hello',client: 'webbrain-extension',protocolVersion: BRIDGE_PROTOCOL_VERSION,capabilities: BRIDGE_CAPABILITIES,+ browser: browserInfo(),+ extensionVersion: identity.extensionVersion,+ platform: platformName(),status: status(),- }, nextSocket);+ };+ if (identity.token) {+ hello.auth = { type: 'bearer', token: identity.token };+ hello.browserId = identity.browserId;+ hello.installationId = identity.installationId;+ }+ sendJson(hello, nextSocket);});nextSocket.addEventListener('message', async (event) => {if (socket !== nextSocket) return;@@ -97,6 +129,25 @@return;}+ if (msg.type === 'connection_pending' || msg.type === 'connection_approved' || msg.type === 'connection_rejected') {+ if (!identity.token) return;+ if (msg.browserId && msg.browserId !== identity.browserId) return;+ if (msg.type === 'connection_pending') {+ if (approval !== 'approved') approval = 'pending';+ } else if (msg.type === 'connection_approved') {+ approval = 'approved';+ lastError = '';+ } else {+ approval = 'rejected';+ lastError = String(msg.reason || 'Connection rejected by backend');+ // A backoff timer from an earlier socket must not reconnect a rejected browser.+ if (reconnectTimer) clearTimeout(reconnectTimer);+ reconnectTimer = null;+ try { nextSocket.close(); } catch {}+ }+ return;+ }+const id = msg.id || null;const action = msg.action || msg.command;const payload = msg.payload || msg;@@ -109,6 +160,11 @@return;}+ if (identity.token && approval !== 'approved') {+ sendJson({ id, ok: false, error: 'Connection not approved', code: 'connection_not_approved', status: 403 }, nextSocket);+ return;+ }+try {const response = await chrome.runtime.sendMessage({...payload,@@ -130,6 +186,9 @@nextSocket.addEventListener('close', () => {if (socket !== nextSocket) return;socket = null;+ // A rejected browser stays rejected until the settings change.+ if (approval === 'rejected') return;+ approval = identity.token ? 'pending' : 'not_required';scheduleReconnect();});nextSocket.addEventListener('error', () => {@@ -153,9 +212,21 @@sendResponse({ ...status(), error: lastError });return false;}- const changed = bridgeUrl && bridgeUrl !== nextUrl;+ const nextIdentity = {+ token: String(msg.token || ''),+ browserId: String(msg.browserId || ''),+ installationId: String(msg.installationId || ''),+ extensionVersion: String(msg.extensionVersion || ''),+ };+ const identityChanged = JSON.stringify(nextIdentity) !== JSON.stringify(identity);+ const changed = (bridgeUrl && bridgeUrl !== nextUrl) || identityChanged;enabled = true;bridgeUrl = nextUrl;+ identity = nextIdentity;+ if (identityChanged) {+ approval = identity.token ? 'pending' : 'not_required';+ reconnectAttempt = 0;+ }if (changed && socket) {const previousSocket = socket;socket = null;diff --git a/src/chrome/src/ui/locales/ar.js b/src/chrome/src/ui/locales/ar.jsindex bd174f183..64a9cbdc0 100644--- a/src/chrome/src/ui/locales/ar.js+++ b/src/chrome/src/ui/locales/ar.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Arabic (ar).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'تكبير واجهة الإضافة','sp.ui_scale.decrease': 'تصغير واجهة الإضافة','sp.ui_scale.increase': 'تكبير واجهة الإضافة',diff --git a/src/chrome/src/ui/locales/bn.js b/src/chrome/src/ui/locales/bn.jsindex 638da186e..7f82d980e 100644--- a/src/chrome/src/ui/locales/bn.js+++ b/src/chrome/src/ui/locales/bn.js@@ -1,10 +1,12 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Bengali — translated from the canonical English locale.import { getApocalypseModeCopy } from './apocalypse-copy.mjs';import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'এক্সটেনশনের UI জুম','sp.ui_scale.decrease': 'এক্সটেনশনের UI ছোট করুন','sp.ui_scale.increase': 'এক্সটেনশনের UI বড় করুন',diff --git a/src/chrome/src/ui/locales/cloud-bridge-copy.mjs b/src/chrome/src/ui/locales/cloud-bridge-copy.mjsnew file mode 100644index 000000000..4df7ff44d--- /dev/null+++ b/src/chrome/src/ui/locales/cloud-bridge-copy.mjs@@ -0,0 +1,22 @@+// English fallback for the Cloud Bridge settings tab; shared to keep locale keys aligned.+export default {+ "st.cb.invalid_url": "Use a local ws:// URL with 127.0.0.1, localhost, or ::1.",+ "st.cb.status_disabled": "Bridge disabled",+ "st.cb.status_error": "Connection error: {error}",+ "st.tab.cloudbridge": 'Cloud Bridge',+ "st.cb.enabled": 'Let a backend control this browser',+ "st.cb.desc": 'WebBrain connects out to the backend below and waits for cloud_* commands. With a token set, the backend must approve this browser before any command runs.',+ "st.cb.url": 'Backend WebSocket URL (local ws:// only)',+ "st.cb.token": 'Cloud Bridge token',+ "st.cb.token_hint": 'Leave empty for a plain local controller (no approval step). This is not a provider API key.',+ "st.cb.browser_name": 'Browser name',+ "st.cb.installation_id": 'Installation ID:',+ "st.cb.test": 'Save & test connection',+ "st.cb.testing": 'Testing…',+ "st.cb.connected": 'Connected (no approval required).',+ "st.cb.pending": 'Connected — waiting for the backend to approve this browser.',+ "st.cb.approved": 'Connected and approved.',+ "st.cb.rejected": 'Rejected by the backend: {reason}',+ "st.cb.unreachable": 'Backend unreachable at {url}.',+ "st.cb.howto_html": 'To try it locally, run <code>node examples/cloud-bridge-approval-server.mjs --token YOUR_TOKEN</code> from the WebBrain checkout, enter the same token here, then press “Save & test connection”. Type <code>approve</code> in that terminal. <a href="https://github.com/webbrain-one/webbrain/blob/main/docs/cloud-bridge-browser-approval.md" target="_blank" rel="noopener noreferrer">Documentation</a>',+};diff --git a/src/chrome/src/ui/locales/de.js b/src/chrome/src/ui/locales/de.jsindex c8a9eb233..69d9cca3c 100644--- a/src/chrome/src/ui/locales/de.js+++ b/src/chrome/src/ui/locales/de.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// German (de).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Erweiterungsoberfläche zoomen','sp.ui_scale.decrease': 'Erweiterungsoberfläche verkleinern','sp.ui_scale.increase': 'Erweiterungsoberfläche vergrößern',diff --git a/src/chrome/src/ui/locales/en.js b/src/chrome/src/ui/locales/en.jsindex 7dd7d1552..b9671a21e 100644--- a/src/chrome/src/ui/locales/en.js+++ b/src/chrome/src/ui/locales/en.js@@ -1,10 +1,12 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// English — canonical locale. Other locales inherit key names from this file.import apocalypseModeCopy from './apocalypse-copy.mjs';import emergencyCopy from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Extension UI zoom','sp.ui_scale.decrease': 'Zoom extension UI out','sp.ui_scale.increase': 'Zoom extension UI in',diff --git a/src/chrome/src/ui/locales/es.js b/src/chrome/src/ui/locales/es.jsindex 401c31a78..ed6ad68f6 100644--- a/src/chrome/src/ui/locales/es.js+++ b/src/chrome/src/ui/locales/es.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Spanish (es).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Zoom de la interfaz de la extensión','sp.ui_scale.decrease': 'Reducir el zoom de la interfaz','sp.ui_scale.increase': 'Aumentar el zoom de la interfaz',diff --git a/src/chrome/src/ui/locales/fa.js b/src/chrome/src/ui/locales/fa.jsindex 42e4a1007..b8cd251c9 100644--- a/src/chrome/src/ui/locales/fa.js+++ b/src/chrome/src/ui/locales/fa.js@@ -1,10 +1,12 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Persian — translated from the canonical English locale.import { getApocalypseModeCopy } from './apocalypse-copy.mjs';import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'بزرگنمایی رابط کاربری افزونه','sp.ui_scale.decrease': 'کاهش بزرگنمایی رابط افزونه','sp.ui_scale.increase': 'افزایش بزرگنمایی رابط افزونه',diff --git a/src/chrome/src/ui/locales/fr.js b/src/chrome/src/ui/locales/fr.jsindex e97b32b84..51a178e0c 100644--- a/src/chrome/src/ui/locales/fr.js+++ b/src/chrome/src/ui/locales/fr.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// French (fr).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Zoom de l’interface de l’extension','sp.ui_scale.decrease': 'Réduire le zoom de l’interface','sp.ui_scale.increase': 'Augmenter le zoom de l’interface',diff --git a/src/chrome/src/ui/locales/he.js b/src/chrome/src/ui/locales/he.jsindex 6e4ccfb7c..75c357e06 100644--- a/src/chrome/src/ui/locales/he.js+++ b/src/chrome/src/ui/locales/he.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Hebrew (he).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'הגדלת ממשק התוסף','sp.ui_scale.decrease': 'הקטנת תצוגת ממשק התוסף','sp.ui_scale.increase': 'הגדלת תצוגת ממשק התוסף',diff --git a/src/chrome/src/ui/locales/hi.js b/src/chrome/src/ui/locales/hi.jsindex d4e2e4d25..24eedae5c 100644--- a/src/chrome/src/ui/locales/hi.js+++ b/src/chrome/src/ui/locales/hi.js@@ -1,10 +1,12 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Hindi — translated from the canonical English locale.import { getApocalypseModeCopy } from './apocalypse-copy.mjs';import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'एक्सटेंशन UI ज़ूम','sp.ui_scale.decrease': 'एक्सटेंशन UI को छोटा करें','sp.ui_scale.increase': 'एक्सटेंशन UI को बड़ा करें',diff --git a/src/chrome/src/ui/locales/id.js b/src/chrome/src/ui/locales/id.jsindex f5eadb61e..dd7062268 100644--- a/src/chrome/src/ui/locales/id.js+++ b/src/chrome/src/ui/locales/id.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Indonesian (id).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Zoom UI ekstensi','sp.ui_scale.decrease': 'Perkecil UI ekstensi','sp.ui_scale.increase': 'Perbesar UI ekstensi',diff --git a/src/chrome/src/ui/locales/ja.js b/src/chrome/src/ui/locales/ja.jsindex ee0e9c5cf..52f8935e7 100644--- a/src/chrome/src/ui/locales/ja.js+++ b/src/chrome/src/ui/locales/ja.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Japanese (ja).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': '拡張機能 UI のズーム','sp.ui_scale.decrease': '拡張機能 UI を縮小','sp.ui_scale.increase': '拡張機能 UI を拡大',diff --git a/src/chrome/src/ui/locales/ko.js b/src/chrome/src/ui/locales/ko.jsindex aaa30d4b6..72e161971 100644--- a/src/chrome/src/ui/locales/ko.js+++ b/src/chrome/src/ui/locales/ko.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Korean (ko).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': '확장 프로그램 UI 확대/축소','sp.ui_scale.decrease': '확장 프로그램 UI 축소','sp.ui_scale.increase': '확장 프로그램 UI 확대',diff --git a/src/chrome/src/ui/locales/ms.js b/src/chrome/src/ui/locales/ms.jsindex 8359ae65e..753ca906a 100644--- a/src/chrome/src/ui/locales/ms.js+++ b/src/chrome/src/ui/locales/ms.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Malay (ms).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Zum UI sambungan','sp.ui_scale.decrease': 'Kecilkan UI sambungan','sp.ui_scale.increase': 'Besarkan UI sambungan',diff --git a/src/chrome/src/ui/locales/nl.js b/src/chrome/src/ui/locales/nl.jsindex 25d0f06ae..bfc48f311 100644--- a/src/chrome/src/ui/locales/nl.js+++ b/src/chrome/src/ui/locales/nl.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Dutch (nl).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Zoom van extensie-interface','sp.ui_scale.decrease': 'Extensie-interface uitzoomen','sp.ui_scale.increase': 'Extensie-interface inzoomen',diff --git a/src/chrome/src/ui/locales/pl.js b/src/chrome/src/ui/locales/pl.jsindex 7a3a048dc..9eda77a06 100644--- a/src/chrome/src/ui/locales/pl.js+++ b/src/chrome/src/ui/locales/pl.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Polski — translated from en.js. Keys mirror the English canonical file.import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Powiększenie interfejsu rozszerzenia','sp.ui_scale.decrease': 'Pomniejsz interfejs rozszerzenia','sp.ui_scale.increase': 'Powiększ interfejs rozszerzenia',diff --git a/src/chrome/src/ui/locales/pt.js b/src/chrome/src/ui/locales/pt.jsindex 1c1faf538..54979297b 100644--- a/src/chrome/src/ui/locales/pt.js+++ b/src/chrome/src/ui/locales/pt.js@@ -1,10 +1,12 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Portuguese — translated from the canonical English locale.import { getApocalypseModeCopy } from './apocalypse-copy.mjs';import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Zoom da interface da extensão','sp.ui_scale.decrease': 'Reduzir o zoom da interface','sp.ui_scale.increase': 'Aumentar o zoom da interface',diff --git a/src/chrome/src/ui/locales/ru.js b/src/chrome/src/ui/locales/ru.jsindex 82910a1f8..d03c85d5e 100644--- a/src/chrome/src/ui/locales/ru.js+++ b/src/chrome/src/ui/locales/ru.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Russian (ru).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Масштаб интерфейса расширения','sp.ui_scale.decrease': 'Уменьшить интерфейс расширения','sp.ui_scale.increase': 'Увеличить интерфейс расширения',diff --git a/src/chrome/src/ui/locales/th.js b/src/chrome/src/ui/locales/th.jsindex 82bf6e398..0e25d184a 100644--- a/src/chrome/src/ui/locales/th.js+++ b/src/chrome/src/ui/locales/th.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Thai (th).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'ซูม UI ของส่วนขยาย','sp.ui_scale.decrease': 'ย่อ UI ของส่วนขยาย','sp.ui_scale.increase': 'ขยาย UI ของส่วนขยาย',diff --git a/src/chrome/src/ui/locales/tl.js b/src/chrome/src/ui/locales/tl.jsindex 69b6e42ed..6e4ffe9e2 100644--- a/src/chrome/src/ui/locales/tl.js+++ b/src/chrome/src/ui/locales/tl.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Filipino / Tagalog (tl).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Pag-zoom ng UI ng extension','sp.ui_scale.decrease': 'Bawasan ang zoom ng UI ng extension','sp.ui_scale.increase': 'Dagdagan ang zoom ng UI ng extension',diff --git a/src/chrome/src/ui/locales/tr.js b/src/chrome/src/ui/locales/tr.jsindex aee4d10a1..8003eb410 100644--- a/src/chrome/src/ui/locales/tr.js+++ b/src/chrome/src/ui/locales/tr.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Turkish (tr).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Uzantı arayüzü yakınlaştırması','sp.ui_scale.decrease': 'Uzantı arayüzünü uzaklaştır','sp.ui_scale.increase': 'Uzantı arayüzünü yakınlaştır',diff --git a/src/chrome/src/ui/locales/uk.js b/src/chrome/src/ui/locales/uk.jsindex 763b53fb7..aade09141 100644--- a/src/chrome/src/ui/locales/uk.js+++ b/src/chrome/src/ui/locales/uk.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Ukrainian (uk).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Масштаб інтерфейсу розширення','sp.ui_scale.decrease': 'Зменшити інтерфейс розширення','sp.ui_scale.increase': 'Збільшити інтерфейс розширення',diff --git a/src/chrome/src/ui/locales/vi.js b/src/chrome/src/ui/locales/vi.jsindex 5aa09db74..0793e70dd 100644--- a/src/chrome/src/ui/locales/vi.js+++ b/src/chrome/src/ui/locales/vi.js@@ -1,10 +1,12 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Vietnamese — translated from the canonical English locale.import { getApocalypseModeCopy } from './apocalypse-copy.mjs';import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Thu phóng giao diện tiện ích','sp.ui_scale.decrease': 'Thu nhỏ giao diện tiện ích','sp.ui_scale.increase': 'Phóng to giao diện tiện ích',diff --git a/src/chrome/src/ui/locales/zh.js b/src/chrome/src/ui/locales/zh.jsindex 7d9a1ba06..d80d9056c 100644--- a/src/chrome/src/ui/locales/zh.js+++ b/src/chrome/src/ui/locales/zh.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Simplified Chinese (zh).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': '插件界面缩放','sp.ui_scale.decrease': '缩小插件界面','sp.ui_scale.increase': '放大插件界面',diff --git a/src/chrome/src/ui/settings-cloud-bridge.js b/src/chrome/src/ui/settings-cloud-bridge.jsnew file mode 100644index 000000000..c1ea16918--- /dev/null+++ b/src/chrome/src/ui/settings-cloud-bridge.js@@ -0,0 +1,121 @@+// Settings → Cloud Bridge tab: URL, token, browser name, connection test.+// Uses the same storage keys as the Display → MCP block; identity keys are+// read by cloud-runs.js when the bridge starts.+import { t } from './i18n.js';++const KEYS = {+ enabled: 'webbrainCloudBridgeEnabled',+ url: 'webbrainCloudBridgeUrl',+ token: 'webbrainCloudBridgeToken',+ browserId: 'webbrainCloudBridgeBrowserId',+ installationId: 'webbrainCloudBridgeInstallationId',+};+const DEFAULT_URL = 'ws://127.0.0.1:17374/extension';+const $ = (id) => document.getElementById(id);+const enabled = $('cb-enabled');+const urlInput = $('cb-url');+const tokenInput = $('cb-token');+const nameInput = $('cb-browser-id');+const installationEl = $('cb-installation-id');+const statusEl = $('cb-status');+const statusText = $('cb-status-text');+const testBtn = $('cb-test');++function send(action, data = {}) {+ return new Promise((resolve, reject) => {+ chrome.runtime.sendMessage({ target: 'background', action, ...data }, (response) => {+ if (chrome.runtime.lastError) reject(new Error(chrome.runtime.lastError.message));+ else if (response?.error) reject(new Error(response.error));+ else resolve(response);+ });+ });+}++function setStatus(state, message) {+ statusEl.dataset.state = state;+ statusText.textContent = message;+}++function normalizeUrl(value) {+ const url = new URL(String(value || DEFAULT_URL));+ if (url.protocol !== 'ws:' || !['127.0.0.1', 'localhost', '::1', '[::1]'].includes(url.hostname.toLowerCase())) {+ throw new Error(t('st.cb.invalid_url'));+ }+ return url.href;+}++function render(status = {}) {+ if (!enabled.checked || status.enabled === false) return setStatus('disabled', t('st.cb.status_disabled'));+ if (status.installationId) installationEl.textContent = status.installationId;+ if (status.approval === 'rejected') return setStatus('error', t('st.cb.rejected', { reason: status.lastError || '' }));+ if (status.connected) {+ if (status.approval === 'approved') return setStatus('connected', t('st.cb.approved'));+ if (status.approval === 'pending') return setStatus('waiting', t('st.cb.pending'));+ return setStatus('connected', t('st.cb.connected'));+ }+ if (status.lastError && status.lastError !== 'WebSocket error') return setStatus('error', t('st.cb.status_error', { error: status.lastError }));+ setStatus('waiting', t('st.cb.unreachable', { url: status.url || urlInput.value || DEFAULT_URL }));+}++async function load() {+ const stored = await chrome.storage.local.get(Object.values(KEYS));+ enabled.checked = !!stored[KEYS.enabled];+ urlInput.value = stored[KEYS.url] || DEFAULT_URL;+ tokenInput.value = stored[KEYS.token] || '';+ nameInput.value = stored[KEYS.browserId] || '';+ installationEl.textContent = stored[KEYS.installationId] || '—';+ if (enabled.checked) refresh();+ else render({ enabled: false });+}++async function refresh() {+ if (!enabled.checked || document.hidden) return;+ try { render(await send('cloud_bridge_status')); } catch (e) { setStatus('error', e.message); }+}++async function save() {+ const url = normalizeUrl(urlInput.value);+ urlInput.value = url;+ const patch = { [KEYS.url]: url, [KEYS.enabled]: enabled.checked, [KEYS.token]: tokenInput.value.trim() };+ const name = nameInput.value.trim();+ await chrome.storage.local.set(patch);+ if (name) await chrome.storage.local.set({ [KEYS.browserId]: name });+ else await chrome.storage.local.remove(KEYS.browserId);+ return url;+}++async function testConnection() {+ testBtn.disabled = true;+ setStatus('waiting', t('st.cb.testing'));+ try {+ enabled.checked = true; // testing implies connecting+ const url = await save();+ let status = await send('cloud_bridge_start', { url });+ for (let i = 0; i < 16; i++) {+ await new Promise((r) => setTimeout(r, 500));+ status = await send('cloud_bridge_status');+ if (status.approval === 'rejected' || status.approval === 'approved' || (status.connected && status.approval === 'not_required')) break;+ }+ render(status);+ const stored = await chrome.storage.local.get(KEYS.installationId);+ installationEl.textContent = stored[KEYS.installationId] || '—';+ } catch (e) {+ setStatus('error', e.message);+ } finally {+ testBtn.disabled = false;+ }+}++enabled.addEventListener('change', async () => {+ try {+ await save();+ if (enabled.checked) render(await send('cloud_bridge_start', { url: urlInput.value }));+ else { await send('cloud_bridge_stop').catch(() => null); render({ enabled: false }); }+ } catch (e) { setStatus('error', e.message); }+});+testBtn.addEventListener('click', testConnection);+setInterval(refresh, 2000);+chrome.storage.onChanged.addListener((changes, area) => {+ if (area === 'local' && Object.values(KEYS).some((k) => changes[k]) && !document.activeElement?.closest('#cb-card')) load();+});+load();diff --git a/src/chrome/src/ui/settings.html b/src/chrome/src/ui/settings.htmlindex bc7212510..c4eefcf9f 100644--- a/src/chrome/src/ui/settings.html+++ b/src/chrome/src/ui/settings.html@@ -1429,6 +1429,7 @@<button class="tab-btn" type="button" role="tab" data-tab="memory" data-i18n="st.tab.memory"></button><button class="tab-btn" type="button" role="tab" data-tab="skills" data-i18n="st.tab.skills"></button><button class="tab-btn" type="button" role="tab" data-tab="permissions" data-i18n="st.tab.permissions"></button>+ <button class="tab-btn" type="button" role="tab" data-tab="cloudbridge" data-i18n="st.tab.cloudbridge"></button></nav><section class="tab-panel" data-panel="display" role="tabpanel">@@ -1719,7 +1720,7 @@</label><div class="cloud-bridge-status" id="cloud-bridge-status" data-state="disabled" role="status" aria-live="polite"><span class="cloud-bridge-status-dot" aria-hidden="true"></span>- <span id="cloud-bridge-status-text" data-i18n="st.display.cloud_bridge.status_disabled"></span>+ <span id="cloud-bridge-status-text" data-i18n="st.cb.status_disabled"></span></div></div><div class="setting-row">@@ -2497,12 +2498,50 @@</div></section>+ <section class="tab-panel" data-panel="cloudbridge" role="tabpanel">+ <div class="provider-card" id="cb-card">+ <div class="setting-row">+ <div class="setting-info">+ <div class="setting-label" id="cb-enabled-label" data-i18n="st.cb.enabled"></div>+ <div class="setting-desc" data-i18n="st.cb.desc"></div>+ </div>+ <label class="toggle">+ <input type="checkbox" id="cb-enabled" aria-labelledby="cb-enabled-label">+ <span class="toggle-slider"></span>+ </label>+ </div>+ <label class="cloud-bridge-url-field" for="cb-url">+ <span class="cloud-bridge-url-label" data-i18n="st.cb.url"></span>+ <input class="setting-input" type="text" id="cb-url" inputmode="url" autocomplete="off" spellcheck="false" placeholder="ws://127.0.0.1:17374/extension">+ </label>+ <label class="cloud-bridge-url-field" for="cb-token" style="margin-top:12px;">+ <span class="cloud-bridge-url-label" data-i18n="st.cb.token"></span>+ <input class="setting-input" type="password" id="cb-token" autocomplete="off" spellcheck="false">+ </label>+ <div class="setting-desc" style="margin-top:4px;" data-i18n="st.cb.token_hint"></div>+ <label class="cloud-bridge-url-field" for="cb-browser-id" style="margin-top:12px;">+ <span class="cloud-bridge-url-label" data-i18n="st.cb.browser_name"></span>+ <input class="setting-input" type="text" id="cb-browser-id" autocomplete="off" spellcheck="false" maxlength="64">+ </label>+ <div class="setting-desc" style="margin-top:12px;"><span data-i18n="st.cb.installation_id"></span> <code id="cb-installation-id">—</code></div>+ <div class="btn-row" style="margin-top:14px;">+ <button class="btn-secondary" id="cb-test" data-i18n="st.cb.test"></button>+ </div>+ <div class="cloud-bridge-status" id="cb-status" data-state="disabled" role="status" aria-live="polite" style="margin-top:12px;">+ <span class="cloud-bridge-status-dot" aria-hidden="true"></span>+ <span id="cb-status-text" data-i18n="st.cb.status_disabled"></span>+ </div>+ <div class="info-box" style="margin-top:16px;" data-i18n-html="st.cb.howto_html"></div>+ </div>+ </section>+<!-- Tab switcher must be an external script — Manifest V3's defaultCSP (`script-src 'self'`) blocks inline <script> execution. --><script src="settings-tabs.js"></script><script type="module" src="apocalypse-comm.js"></script><script type="module" src="download-tracker.js"></script><script src="settings.js" type="module"></script>+ <script src="settings-cloud-bridge.js" type="module"></script><script src="safesocial-settings.js" type="module"></script></body></html>diff --git a/src/firefox/src/agent/agent.js b/src/firefox/src/agent/agent.jsindex 3c07b7d77..668b911b0 100644--- a/src/firefox/src/agent/agent.js+++ b/src/firefox/src/agent/agent.js@@ -915,6 +915,7 @@ export class Agent extends LoopDetector {this.pendingAdapterMatchTraces = new Map(); // tabId -> Map(adapter@revision -> content-free match metadata)this.adapterMatchTraceKeys = new Map(); // runId -> Map(adapter@revision -> OR-merged match metadata)this.apiAllowedTabs = new Set();+ this.temporaryApiAllowedTabs = new Set();// Global Advanced-setting opt-in. Keep it separate from the tab set so// /reset clears only the conversation override and live setting changes// can revoke global permission without erasing explicit /allow-api state.@@ -7224,6 +7225,30 @@ export class Agent extends LoopDetector {}}+ setTemporaryApiMutationsAllowed(tabId, allowed) {+ if (allowed) {+ this.temporaryApiAllowedTabs.add(tabId);+ return;+ }++ this.temporaryApiAllowedTabs.delete(tabId);+ // A user may have enabled /allow-api or the global setting while the run+ // was active. In that case the injected authorization is still current.+ if (this.isApiMutationsAllowed(tabId)) return;++ if (this.apiAllowedInjected.has(tabId)) {+ const messages = this.conversations.get(tabId);+ if (Array.isArray(messages)) {+ messages.push(this._appOwnedUserMessage(+ '[CURRENT API MUTATION AUTHORIZATION — NOT ALLOWED: The temporary API mutation authorization for the completed browser run has ended. This current state supersedes any earlier [USER OVERRIDE — API MUTATIONS ALLOWED] note. Do not plan or call POST/PUT/PATCH/DELETE requests through fetch_url or research_url unless the user explicitly enables /allow-api for this conversation. Continue through the visible UI or ask for /allow-api.]',+ 'api_authorization_state',+ ));+ this._persist(tabId);+ }+ this.apiAllowedInjected.delete(tabId);+ }+ }+setAlwaysAllowApiMutations(allowed) {const nextAllowed = allowed === true;const revoked = this.alwaysAllowApiMutations && !nextAllowed;@@ -7234,7 +7259,7 @@ export class Agent extends LoopDetector {// system prompt cannot retract it. Append the live state only for chats// that actually saw that note and lost their effective authorization.for (const tabId of [...this.apiAllowedInjected]) {- if (this.apiAllowedTabs.has(tabId)) continue;+ if (this.isApiMutationsAllowed(tabId)) continue;const messages = this.conversations.get(tabId);if (Array.isArray(messages)) {messages.push(this._appOwnedUserMessage(@@ -7248,7 +7273,9 @@ export class Agent extends LoopDetector {}isApiMutationsAllowed(tabId) {- return this.alwaysAllowApiMutations || this.apiAllowedTabs.has(tabId);+ return this.alwaysAllowApiMutations+ || this.apiAllowedTabs.has(tabId)+ || this.temporaryApiAllowedTabs.has(tabId);}// Browser-free loop detection is inherited from LoopDetector. These@@ -23987,6 +24014,7 @@ Rules: no prose intro, no conclusion, no "this screenshot shows...", no layout dthis._compactCooldown.delete(tabId);this.hydratedTabs.delete(tabId);this.apiAllowedTabs.delete(tabId);+ this.temporaryApiAllowedTabs.delete(tabId);this.apiAllowedInjected.delete(tabId);this._cleanupTab(tabId, { preserveRunGuard: true });const t = this.persistTimers.get(tabId);diff --git a/src/firefox/src/background.js b/src/firefox/src/background.jsindex 48f1901ec..a128d478b 100644--- a/src/firefox/src/background.js+++ b/src/firefox/src/background.js@@ -16,6 +16,8 @@ import {refreshBuiltInSkillRecord,} from './agent/skills.js';import { ScheduledJobManager } from './agent/scheduler.js';+import { cloudSafeScheduledJob, createCloudRunController } from './cloud-runs.js';+import { createCloudBridge } from './cloud-bridge.js';import { APOCALYPSE_DOWNLOAD_ALARM, APOCALYPSE_UPDATE_ALARM, createApocalypseController, sweepOpfsSwapFiles } from './agent/apocalypse-mode.js';import { createEmergencyDownloadController } from './agent/emergency-download-controller.js';import { createHostedOfflineRagIndexClient } from './agent/offline-rag-index-host.js';@@ -175,7 +177,8 @@ const teacherSessionStore = createTeacherSessionStore(browser.storage.session);const teacherRunInterlock = createTeacherRunInterlock(teacherSessionStore, {automationOwnsTab: (tabId) => agent.isRunning(tabId)|| detachedRunStarts.has(tabId)- || scheduler.isRunning(tabId),+ || scheduler.isRunning(tabId)+ || cloudRunController.isRunning(tabId),});agent.setRunStartGuard((tabId) => teacherRunInterlock.guardRunStart(tabId));const profileSync = new ProfileSyncManager(browser.storage.local);@@ -210,6 +213,20 @@ const scheduler = new ScheduledJobManager({agent.setScheduler(scheduler);scheduler.start();+// Firefox has no offscreen document, so the Cloud Bridge socket lives in this+// background page and hands commands straight to handleMessage.+const cloudBridge = createCloudBridge({ dispatch: (msg) => handleMessage(msg, null) });+const cloudRunController = createCloudRunController({+ chromeApi: browser,+ agent,+ bridge: cloudBridge,+ sendIndicator: (tabId, type) => sendIndicatorMessage(tabId, type),+ workflowTrace,+});+alwaysAllowApiMutationsReady+ .then(() => cloudRunController.syncBridge())+ .catch(() => {});+const MAX_AGENT_STEPS_DEFAULT = 130;const MAX_AGENT_STEPS_UNLIMITED_SENTINEL = 200;const CONTEXT_MENU_ASK_SELECTION_ID = 'webbrain-ask-selection';@@ -1048,6 +1065,7 @@ browser.runtime.onInstalled.addListener(async (details) => {await loadClarifyTimeout();await loadAutoScreenshot();await syncAgentUserMemoryFromStorage().catch(() => {});+ await cloudRunController.syncBridge().catch(() => {});scheduleUserMemoryExtractionDrain(5000);console.log('[WebBrain] Extension installed, providers loaded.');});@@ -1055,6 +1073,7 @@ browser.runtime.onInstalled.addListener(async (details) => {browser.runtime.onStartup?.addListener?.(async () => {await createContextMenus();syncAgentUserMemoryFromStorage().catch(() => {});+ cloudRunController.syncBridge().catch(() => {});scheduleUserMemoryExtractionDrain(5000);});@@ -1098,6 +1117,10 @@ browser.storage.onChanged.addListener((changes) => {const value = changes[API_MUTATION_OBSERVER_KEY].newValue;setApiMutationObserverEnabled(value === undefined || value === true);}+ if (changes.webbrainCloudBridgeEnabled || changes.webbrainCloudBridgeUrl+ || changes.webbrainCloudBridgeToken || changes.webbrainCloudBridgeBrowserId) {+ cloudRunController.syncBridge().catch(() => {});+ }if (changes.strictSecretMode) {agent.strictSecretMode = changes.strictSecretMode.newValue === true;// Strict mode also appends a global system note after enabled skills, so@@ -3413,6 +3436,40 @@ async function handleMessage(msg, sender) {return { ok: true, enabled: msg.enabled };}+ case 'cloud_run':+ return await cloudRunController.startRun(msg);+ case 'cloud_workflow_compile':+ return await cloudRunController.compileWorkflow(msg);+ case 'cloud_workflow_run':+ return await cloudRunController.startWorkflowRun(msg);+ case 'cloud_status':+ return await cloudRunController.status(msg);+ case 'cloud_scheduled_jobs': {+ const jobIds = [...new Set((msg.jobIds || msg.job_ids || [])+ .map(value => String(value || '').trim())+ .filter(Boolean))].slice(0, 100);+ if (!jobIds.length) {+ return { error: 'cloud_scheduled_jobs requires expected job IDs.', status: 400 };+ }+ const expected = new Set(jobIds);+ const jobs = await scheduler.listJobs({ tabId: null });+ return {+ ok: true,+ jobs: jobs+ .filter(job => expected.has(String(job?.id || '')))+ .map(job => cloudSafeScheduledJob(job, { strictSecretMode: agent.strictSecretMode === true })),+ };+ }+ case 'cloud_respond':+ return await cloudRunController.respond(msg);+ case 'cloud_abort':+ return await cloudRunController.abort(msg);+ case 'cloud_bridge_start':+ return await cloudRunController.startBridge(msg.url);+ case 'cloud_bridge_stop':+ return await cloudRunController.stopBridge();+ case 'cloud_bridge_status':+ return await cloudRunController.bridgeStatus();case 'get_providers': {return { providers: providerManager.getAll(), active: providerManager.activeProviderId };}diff --git a/src/firefox/src/cloud-bridge.js b/src/firefox/src/cloud-bridge.jsnew file mode 100644index 000000000..01d0ba3a7--- /dev/null+++ b/src/firefox/src/cloud-bridge.js@@ -0,0 +1,235 @@+/**+ * Outbound WebSocket bridge for MCP and other controllers (Firefox).+ *+ * Mirror of src/chrome/src/offscreen/cloud-bridge.js. Firefox MV2 has a+ * persistent background page and no offscreen documents, so the socket lives+ * in the background page and commands are handed to `dispatch` directly+ * instead of through runtime.sendMessage (a page does not receive its own+ * runtime messages). Keep the protocol identical to the Chrome file.+ */++export const BRIDGE_PROTOCOL_VERSION = 2;+const BRIDGE_CAPABILITIES = ['saved_workflows_v1', 'run_modes_v1', 'scheduled_jobs_v1'];+const ALLOWED_BRIDGE_ACTIONS = new Set([+ 'cloud_run',+ 'cloud_workflow_compile',+ 'cloud_workflow_run',+ 'cloud_status',+ 'cloud_scheduled_jobs',+ 'cloud_respond',+ 'cloud_abort',+]);++export function createCloudBridge({ dispatch, WebSocketImpl = globalThis.WebSocket, nav = globalThis.navigator } = {}) {+ let socket = null;+ let bridgeUrl = null;+ let enabled = false;+ let reconnectTimer = null;+ let reconnectAttempt = 0;+ let lastError = '';+ // With a token configured the backend must approve each new socket before+ // any cloud_* command runs; without one the legacy local behaviour is kept.+ let identity = { token: '', browserId: '', installationId: '', extensionVersion: '' };+ let approval = 'not_required'; // not_required | pending | approved | rejected++ function browserInfo() {+ const match = /(Edg|Firefox|Chrome)\/([\d.]+)/.exec(nav?.userAgent || '');+ const names = { Edg: 'Edge', Firefox: 'Firefox', Chrome: 'Chrome' };+ return { name: match ? names[match[1]] : 'unknown', version: match ? match[2] : '' };+ }++ function normalizeBridgeUrl(value) {+ const url = new URL(String(value || 'ws://127.0.0.1:17374/extension'));+ const host = url.hostname.toLowerCase();+ if (url.protocol !== 'ws:' || !['127.0.0.1', 'localhost', '::1', '[::1]'].includes(host)) {+ throw new Error('MCP URL must use ws:// on localhost.');+ }+ return url.href;+ }++ function status() {+ return {+ enabled,+ url: bridgeUrl,+ browserId: identity.browserId || null,+ installationId: identity.installationId || null,+ approval,+ connected: socket?.readyState === WebSocketImpl.OPEN,+ readyState: socket ? socket.readyState : null,+ reconnectAttempt,+ lastError,+ };+ }++ function sendJson(obj, target = socket) {+ if (!target || target.readyState !== WebSocketImpl.OPEN) return;+ try {+ target.send(JSON.stringify(obj));+ } catch (e) {+ lastError = e.message || String(e);+ }+ }++ function scheduleReconnect() {+ if (!enabled || !bridgeUrl || reconnectTimer) return;+ const delay = Math.min(30000, 500 * Math.pow(2, reconnectAttempt++));+ reconnectTimer = setTimeout(() => {+ reconnectTimer = null;+ connect();+ }, delay);+ }++ function connect() {+ if (!enabled || !bridgeUrl) return;+ if (socket && (socket.readyState === WebSocketImpl.OPEN || socket.readyState === WebSocketImpl.CONNECTING)) return;+ try {+ const nextSocket = new WebSocketImpl(bridgeUrl);+ socket = nextSocket;+ nextSocket.addEventListener('open', () => {+ if (socket !== nextSocket) return;+ reconnectAttempt = 0;+ lastError = '';+ // Every new socket starts unapproved; approval never carries over.+ approval = identity.token ? 'pending' : 'not_required';+ const hello = {+ type: 'hello',+ client: 'webbrain-extension',+ protocolVersion: BRIDGE_PROTOCOL_VERSION,+ capabilities: BRIDGE_CAPABILITIES,+ browser: browserInfo(),+ extensionVersion: identity.extensionVersion,+ platform: nav?.platform || '',+ status: status(),+ };+ if (identity.token) {+ hello.auth = { type: 'bearer', token: identity.token };+ hello.browserId = identity.browserId;+ hello.installationId = identity.installationId;+ }+ sendJson(hello, nextSocket);+ });+ nextSocket.addEventListener('message', async (event) => {+ if (socket !== nextSocket) return;+ let msg;+ try {+ msg = JSON.parse(event.data);+ } catch (e) {+ sendJson({ ok: false, error: `Invalid JSON message: ${e.message}` }, nextSocket);+ return;+ }++ if (msg.type === 'connection_pending' || msg.type === 'connection_approved' || msg.type === 'connection_rejected') {+ if (!identity.token) return;+ if (msg.browserId && msg.browserId !== identity.browserId) return;+ if (msg.type === 'connection_pending') {+ if (approval !== 'approved') approval = 'pending';+ } else if (msg.type === 'connection_approved') {+ approval = 'approved';+ lastError = '';+ } else {+ approval = 'rejected';+ lastError = String(msg.reason || 'Connection rejected by backend');+ // A backoff timer from an earlier socket must not reconnect a rejected browser.+ if (reconnectTimer) clearTimeout(reconnectTimer);+ reconnectTimer = null;+ try { nextSocket.close(); } catch {}+ }+ return;+ }++ const id = msg.id || null;+ const action = msg.action || msg.command;+ const payload = msg.payload || msg;+ if (!action) {+ sendJson({ id, ok: false, error: 'Missing action' }, nextSocket);+ return;+ }+ if (!ALLOWED_BRIDGE_ACTIONS.has(action)) {+ sendJson({ id, ok: false, error: `Unsupported cloud bridge action: ${action}` }, nextSocket);+ return;+ }+ if (identity.token && approval !== 'approved') {+ sendJson({ id, ok: false, error: 'Connection not approved', code: 'connection_not_approved', status: 403 }, nextSocket);+ return;+ }++ try {+ const response = await dispatch({ ...payload, target: 'background', action });+ const isRunSnapshot = !!response+ && (response.runId != null || response.run_id != null)+ && typeof response.status === 'string';+ if (response?.error && !isRunSnapshot) {+ sendJson({ id, ok: false, error: response.error, status: response.status || 500 }, nextSocket);+ } else {+ sendJson({ id, ok: true, result: response }, nextSocket);+ }+ } catch (e) {+ sendJson({ id, ok: false, error: e.message || String(e) }, nextSocket);+ }+ });+ nextSocket.addEventListener('close', () => {+ if (socket !== nextSocket) return;+ socket = null;+ // A rejected browser stays rejected until the settings change.+ if (approval === 'rejected') return;+ approval = identity.token ? 'pending' : 'not_required';+ scheduleReconnect();+ });+ nextSocket.addEventListener('error', () => {+ if (socket !== nextSocket) return;+ lastError = 'WebSocket error';+ });+ } catch (e) {+ lastError = e.message || String(e);+ socket = null;+ scheduleReconnect();+ }+ }++ function start(msg = {}) {+ let nextUrl;+ try {+ nextUrl = normalizeBridgeUrl(msg.url || bridgeUrl);+ } catch (error) {+ lastError = error.message || String(error);+ return { ...status(), error: lastError };+ }+ const nextIdentity = {+ token: String(msg.token || ''),+ browserId: String(msg.browserId || ''),+ installationId: String(msg.installationId || ''),+ extensionVersion: String(msg.extensionVersion || ''),+ };+ const identityChanged = JSON.stringify(nextIdentity) !== JSON.stringify(identity);+ const changed = (bridgeUrl && bridgeUrl !== nextUrl) || identityChanged;+ enabled = true;+ bridgeUrl = nextUrl;+ identity = nextIdentity;+ if (identityChanged) {+ approval = identity.token ? 'pending' : 'not_required';+ reconnectAttempt = 0;+ }+ if (changed && socket) {+ const previousSocket = socket;+ socket = null;+ try { previousSocket.close(); } catch {}+ }+ connect();+ return status();+ }++ function stop() {+ enabled = false;+ if (reconnectTimer) clearTimeout(reconnectTimer);+ reconnectTimer = null;+ reconnectAttempt = 0;+ if (socket) {+ const previousSocket = socket;+ socket = null;+ try { previousSocket.close(); } catch {}+ }+ return status();+ }++ return { start, stop, status };+}diff --git a/src/firefox/src/cloud-runs.js b/src/firefox/src/cloud-runs.jsnew file mode 100644index 000000000..f4a08e83f--- /dev/null+++ b/src/firefox/src/cloud-runs.js@@ -0,0 +1,1466 @@+import {+ compileSuccessfulWorkflowByRunId,+ finalizeSavedWorkflowDraft,+ normalizeSavedWorkflow,+} from './agent/workflows.js';+import { isCredentialField } from './agent/credential-fields.js';++const DEFAULT_CLOUD_BRIDGE_URL = 'ws://127.0.0.1:17374/extension';+const CLOUD_RUN_STORAGE_KEY = 'webbrainCloudRunSnapshots';+const CLOUD_UPDATE_LIMIT = 200;+const CLOUD_RUN_LIMIT = 50;+const CLOUD_STRING_LIMIT = 16 * 1024;+const CLOUD_RUN_PERSIST_BYTES_LIMIT = 256 * 1024;+const CLOUD_PERSIST_BYTES_LIMIT = 4 * 1024 * 1024;+const TERMINAL_STATUSES = new Set(['completed', 'failed', 'aborted']);+// Suffix match on normalized keys (non-alnum stripped). Avoid bare `pin` as a+// suffix — it over-matches `spin`, `mapPin`, etc. Short exact keys live in the set.+const SENSITIVE_CLOUD_KEY = /(?:authorization|cookie|password|passwd|passphrase|passcode|pincode|(?:verification|confirmation|security|auth|email|twofactor|2fa|mfa|onetime|recovery)code|secret|credential|privatekey|apikey|token|accesskeyid|secretaccesskey)$/i;+const SENSITIVE_CLOUD_KEY_EXACT = new Set(['code', 'pin', 'otp', 'cvv', 'cvc', 'ssn']);+const LARGE_IMAGE_KEY = /(?:attachimage|screenshot|image|imagedata|dataurl)$/i;+const CLOUD_TEXT_ENTRY_TOOLS = new Set(['set_field', 'type_ax', 'type_text', 'iframe_type']);+const VERIFY_FORM_VALUE_KEYS = new Set(['value', 'controlvalue', 'valueprefix', 'valuesuffix']);+// Strict-secret mode is deny-by-default: an update leaves the browser carrying+// only the evidence a cloud caller needs to score the run. A per-tool allowlist+// is the wrong shape here — a secret typed into a visible field comes straight+// back out of the next page read, and model prose repeats it in plain text.+// These are the narrow carve-outs that survive, keyed by what grading reads.+const CLOUD_STRICT_MODEL_TEXT_TYPES = new Set(['text', 'text_delta']);+// `error` and `run_status` carry the model's final response as `message`.+const CLOUD_STRICT_DROPPED_MESSAGE_TYPES = new Set(['error', 'run_status']);+// done_json and verify_form keep their shape through dedicated value-level+// redactors below; every other tool result is reduced to a bare envelope.+const CLOUD_STRICT_STRUCTURED_RESULT_TOOLS = new Set(['done_json', 'verify_form']);+// Scalar, non-page-derived argument keys. `fetch_url` is handled separately so+// its URL is reduced to origin-only evidence rather than dropped.+const CLOUD_STRICT_ARG_EVIDENCE_KEYS = new Set(['skill_id', 'method', 'url_origin']);+// A caller has to read a clarification to answer it, so `clarify` cannot be+// blanked the way model prose is. Prompt instructions are not a redaction+// boundary either, so strict runs additionally redact by *value*: every secret+// this run typed into a page is remembered and struck from the text of every+// later update, clarifications included. That leaves a usable question while+// removing the literal the key-based scrubber cannot recognize.+const CLOUD_STRICT_SECRET_VALUE_LIMIT = 256;+// Short values would mangle ordinary prose on a coincidental substring match.+// Numeric PIN/CVV fragments are still security-sensitive, so they are tracked+// with boundary-aware replacement below.+const CLOUD_STRICT_SECRET_MIN_LENGTH = 4;+const WORKFLOW_PARAMETER_VALUE_LIMIT = 10_000;+const SENSITIVE_URL_COMPONENT_KEY = /(?:^|[-_.\s])(?:auth(?:orization)?|api[-_.\s]?key|key|token|secret|signature|sig|code|credential|password|passcode|otp)(?:$|[-_.\s])/i;+const SENSITIVE_URL_PATH_LABELS = new Set([+ 'auth', 'authorization', 'apikey', 'key', 'token', 'accesstoken', 'refreshtoken',+ 'secret', 'signature', 'sig', 'code', 'authcode', 'verificationcode',+ 'credential', 'password', 'passcode', 'otp', 'downloadkey', 'sharetoken',+]);++function cloudRunError(message, status) {+ return Object.assign(new Error(message), { status });+}++export function normalizeCloudRunMode(value, fallback = 'act') {+ const mode = String(value ?? '').trim().toLowerCase();+ if (!mode) return fallback;+ if (!['ask', 'act'].includes(mode)) {+ throw cloudRunError('Cloud run `mode` must be `ask` or `act`.', 400);+ }+ return mode;+}++function normalizedCloudKey(key) {+ return String(key || '').replace(/[^a-z0-9]/gi, '');+}++export function normalizeCloudBridgeUrl(value = DEFAULT_CLOUD_BRIDGE_URL) {+ const url = new URL(String(value || DEFAULT_CLOUD_BRIDGE_URL));+ const host = url.hostname.toLowerCase();+ // WHATWG URL keeps the brackets on IPv6 literals: ws://[::1]/… parses to+ // hostname "[::1]", so both spellings must be allowlisted (same as+ // LOCAL_OLLAMA_HOSTS in ollama-handoff.js).+ if (url.protocol !== 'ws:' || !['127.0.0.1', 'localhost', '::1', '[::1]'].includes(host)) {+ throw new Error('WebBrain cloud bridge URL must use ws:// on localhost.');+ }+ return url.href;+}++export function isSensitiveCloudKey(key) {+ const normalizedKey = normalizedCloudKey(key);+ if (!normalizedKey) return false;+ return SENSITIVE_CLOUD_KEY.test(normalizedKey) || SENSITIVE_CLOUD_KEY_EXACT.has(normalizedKey);+}++function hasCloudOutputSchema(value) {+ return value !== null && value !== undefined;+}++function scrubCloudValue(value) {+ try {+ return JSON.parse(JSON.stringify(value, (key, item) => {+ const normalizedKey = normalizedCloudKey(key);+ if (normalizedKey && isSensitiveCloudKey(key)) {+ return '[redacted]';+ }+ if (typeof item === 'string' && /^data:image\//i.test(item)) {+ return `[image omitted: ${item.length} chars]`;+ }+ if (LARGE_IMAGE_KEY.test(normalizedKey) && typeof item === 'string' && item.length > 500) {+ return `[large payload omitted: ${item.length} chars]`;+ }+ if (typeof item === 'string' && item.length > CLOUD_STRING_LIMIT) {+ return `${item.slice(0, CLOUD_STRING_LIMIT)}\n[truncated ${item.length - CLOUD_STRING_LIMIT} chars for cloud persistence]`;+ }+ return item;+ }));+ } catch {+ return { unserializable: true };+ }+}++function cloudUrlEvidence(value) {+ try {+ const url = new URL(String(value || ''));+ if (!['http:', 'https:'].includes(url.protocol)) return {};+ return { url_origin: url.origin };+ } catch {+ return {};+ }+}++function cloudTerminalUrl(value, { strictSecretMode = false } = {}) {+ if (!strictSecretMode) return value;+ return cloudUrlEvidence(value).url_origin || '';+}++function redactVerifyFormValues(value) {+ try {+ return JSON.parse(JSON.stringify(value, (key, item) => (+ VERIFY_FORM_VALUE_KEYS.has(normalizedCloudKey(key).toLowerCase())+ ? '[redacted form value]'+ : item+ )));+ } catch {+ return { success: false, sensitivePayloadRedacted: true };+ }+}++// Every leaf a secret can be encoded in goes, not just strings: a six-digit OTP+// serialized as `verification_code: 481920` is a number, and no key pattern+// recognizes that field name. Booleans and null survive because neither can+// carry a credential — which is also what makes a strict structured run+// gradable, since a `true` outcome flag comes through intact. A strict run's+// structured output is therefore assertable on booleans only.+function redactStrictStructuredValues(value) {+ try {+ return JSON.parse(JSON.stringify(value, (_key, item) => {+ if (typeof item === 'string') return '[redacted strict value]';+ if (typeof item === 'number' || typeof item === 'bigint') return '[redacted strict number]';+ return item;+ }));+ } catch {+ return { sensitivePayloadRedacted: true };+ }+}++function cloudSafeUpdateData(type, data, { strictSecretMode = false } = {}) {+ if (!data || typeof data !== 'object') return data;+ const name = String(data.name || data.tool || '');+ if (strictSecretMode && CLOUD_STRICT_MODEL_TEXT_TYPES.has(type)) {+ return {+ ...data,+ ...(Object.hasOwn(data, 'content') ? { content: '[redacted strict text]' } : {}),+ };+ }+ if (strictSecretMode && CLOUD_STRICT_DROPPED_MESSAGE_TYPES.has(type)) {+ // Dropped rather than replaced so the run-level fallbacks below still pick+ // their own descriptive constant instead of storing a placeholder.+ const { message: _message, ...rest } = data;+ return rest;+ }+ if (!strictSecretMode && type === 'tool_call' && CLOUD_TEXT_ENTRY_TOOLS.has(name)) {+ const args = data.args && typeof data.args === 'object' ? data.args : {};+ return {+ ...data,+ args: {+ ...args,+ ...(Object.hasOwn(args, 'text') ? { text: '[redacted typed text]' } : {}),+ ...(Object.hasOwn(args, 'value') ? { value: '[redacted typed text]' } : {}),+ },+ };+ }+ if (strictSecretMode && type === 'tool_call' && name === 'fetch_url') {+ const args = data.args && typeof data.args === 'object' ? data.args : {};+ const method = String(args.method || '').toUpperCase();+ return {+ ...data,+ args: {+ ...(['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS'].includes(method) ? { method } : {}),+ ...cloudUrlEvidence(args.url),+ ...(Object.hasOwn(args, 'body') ? { body: '[redacted request body]' } : {}),+ },+ };+ }+ if (strictSecretMode && type === 'tool_result' && name === 'fetch_url') {+ const result = data.result && typeof data.result === 'object' ? data.result : {};+ return {+ ...data,+ result: {+ success: result.success === true,+ ...(Number.isFinite(Number(result.status)) ? { status: Number(result.status) } : {}),+ sensitivePayloadRedacted: true,+ },+ };+ }+ if (strictSecretMode && type === 'tool_result' && name === 'verify_form') {+ return {+ ...data,+ result: redactVerifyFormValues(data.result),+ };+ }+ if (strictSecretMode && type === 'tool_call' && name === 'done_json') {+ const args = data.args && typeof data.args === 'object' ? data.args : {};+ return {+ ...data,+ args: {+ ...args,+ ...(Object.hasOwn(args, 'result') ? { result: redactStrictStructuredValues(args.result) } : {}),+ ...(Object.hasOwn(args, 'summary') ? { summary: '[redacted strict summary]' } : {}),+ },+ };+ }+ if (strictSecretMode && type === 'tool_result' && name === 'done_json') {+ const result = data.result && typeof data.result === 'object' ? data.result : {};+ return {+ ...data,+ result: {+ ...result,+ ...(Object.hasOwn(result, 'result') ? { result: redactStrictStructuredValues(result.result) } : {}),+ ...(Object.hasOwn(result, 'cloudResult') ? { cloudResult: redactStrictStructuredValues(result.cloudResult) } : {}),+ ...(Object.hasOwn(result, 'invalidResult') ? { invalidResult: redactStrictStructuredValues(result.invalidResult) } : {}),+ ...(Object.hasOwn(result, 'summary') ? { summary: '[redacted strict summary]' } : {}),+ },+ };+ }+ if (strictSecretMode && type === 'tool_call') {+ const args = data.args && typeof data.args === 'object' ? data.args : {};+ const evidence = Object.fromEntries(Object.entries(args).filter(([key, value]) => (+ CLOUD_STRICT_ARG_EVIDENCE_KEYS.has(key) && (typeof value !== 'object' || value === null)+ )));+ return {+ ...data,+ args: { ...evidence, sensitiveArgsRedacted: true },+ };+ }+ if (strictSecretMode && type === 'tool_result' && !CLOUD_STRICT_STRUCTURED_RESULT_TOOLS.has(name)) {+ // Any read tool echoes back whatever was typed into the page, so success+ // and HTTP status are all a result may carry out of a strict run.+ const result = data.result && typeof data.result === 'object' ? data.result : {};+ return {+ ...data,+ result: {+ success: result.success === true,+ ...(Number.isFinite(Number(result.status)) ? { status: Number(result.status) } : {}),+ sensitivePayloadRedacted: true,+ },+ };+ }+ return data;+}++// Walks a raw tool result for string or numeric values sitting under a key the+// scrubber already treats as sensitive. Depth-bounded: a page read can be+// enormous, and this runs on every update.+function collectSensitiveStrings(value, into, depth = 0, sensitiveParent = false) {+ if (depth > 6 || into.length > CLOUD_STRICT_SECRET_VALUE_LIMIT) return;+ if (typeof value === 'string') {+ if (sensitiveParent) into.push(value);+ return;+ }+ if (typeof value === 'number') {+ if (sensitiveParent && Number.isFinite(value)) into.push(String(value));+ return;+ }+ if (Array.isArray(value)) {+ for (const item of value) collectSensitiveStrings(item, into, depth + 1, sensitiveParent);+ return;+ }+ if (!value || typeof value !== 'object') return;+ for (const [key, item] of Object.entries(value)) {+ collectSensitiveStrings(+ item,+ into,+ depth + 1,+ sensitiveParent || isSensitiveCloudKey(key),+ );+ if (into.length > CLOUD_STRICT_SECRET_VALUE_LIMIT) return;+ }+}++function isSensitiveUrlComponentKey(value) {+ const text = String(value || '');+ return isSensitiveCloudKey(text)+ || SENSITIVE_URL_COMPONENT_KEY.test(text)+ || /(?:Key|Code|Signature|Token|Secret|Password)$/.test(text);+}++function isSensitiveUrlPathLabel(value) {+ return SENSITIVE_URL_PATH_LABELS.has(normalizedCloudKey(value).toLowerCase());+}++// URL paths and queries are withheld wholesale from strict trace evidence, but+// the value registry must be narrower: registering `/profile` or `?tab=activity`+// as a secret corrupts legitimate caller-visible results. Remember userinfo,+// values under credential-like query keys, and path/hash components that either+// carry credential vocabulary themselves or follow an explicit credential label.+function collectUrlSecretStrings(value, into) {+ let url;+ try {+ url = new URL(String(value || ''));+ } catch {+ return;+ }+ if (!['http:', 'https:'].includes(url.protocol)) return;+ const add = (candidate) => {+ const text = String(candidate || '');+ if (text && into.length <= CLOUD_STRICT_SECRET_VALUE_LIMIT) into.push(text);+ };+ const addEncoded = (candidate) => {+ add(candidate);+ try {+ add(decodeURIComponent(String(candidate || '')));+ } catch {}+ };+ addEncoded(url.username);+ addEncoded(url.password);+ let followsSensitivePathLabel = false;+ for (const segment of url.pathname.split('/').filter(Boolean)) {+ let decoded = segment;+ try { decoded = decodeURIComponent(segment); } catch {}+ const isLabel = isSensitiveUrlPathLabel(decoded);+ if (followsSensitivePathLabel || (!isLabel && isSensitiveUrlComponentKey(decoded))) {+ addEncoded(segment);+ }+ followsSensitivePathLabel = isLabel;+ }+ for (const [key, item] of url.searchParams) {+ if (isSensitiveUrlComponentKey(key)) addEncoded(item);+ }+ const hash = url.hash.replace(/^#/, '');+ if (hash) {+ let decodedHash = hash;+ try { decodedHash = decodeURIComponent(hash); } catch {}+ let foundSensitiveHashParam = false;+ if (decodedHash.includes('=')) {+ const hashParams = new URLSearchParams(decodedHash.replace(/^\?/, ''));+ for (const [key, item] of hashParams) {+ if (!isSensitiveUrlComponentKey(key)) continue;+ foundSensitiveHashParam = true;+ addEncoded(item);+ }+ }+ if (!foundSensitiveHashParam+ && !isSensitiveUrlPathLabel(decodedHash)+ && isSensitiveUrlComponentKey(decodedHash)) {+ addEncoded(hash);+ }+ }+}++// URL credentials are not unique to fetch_url: navigate, new_tab, read tools,+// downloads, custom skills, and tool results can all carry URL-shaped fields.+// Walk only fields whose normalized name ends in url/urls, but follow arrays+// and nested containers below such a field so credential-like components in+// every concrete http(s) value are registered before later prose is published.+function collectUrlSecretsFromNamedFields(value, into, depth = 0, urlBearing = false) {+ if (depth > 6 || into.length > CLOUD_STRICT_SECRET_VALUE_LIMIT) return;+ if (typeof value === 'string') {+ if (urlBearing) collectUrlSecretStrings(value, into);+ return;+ }+ if (Array.isArray(value)) {+ for (const item of value) collectUrlSecretsFromNamedFields(item, into, depth + 1, urlBearing);+ return;+ }+ if (!value || typeof value !== 'object') return;+ for (const [key, item] of Object.entries(value)) {+ const normalizedKey = normalizedCloudKey(key).toLowerCase();+ collectUrlSecretsFromNamedFields(+ item,+ into,+ depth + 1,+ urlBearing || /urls?$/.test(normalizedKey),+ );+ if (into.length > CLOUD_STRICT_SECRET_VALUE_LIMIT) return;+ }+}++// Full URLs are trace-only sensitive in strict mode even when their individual+// path/query components are ordinary public data. Keep this registry separate+// from credential values so a repeated URL is removed from prose updates while+// a schema-valid result such as `{ section: 'profile' }` stays intact.+function collectUrlTraceStringsFromNamedFields(value, into, depth = 0, urlBearing = false) {+ if (depth > 6 || into.length > CLOUD_STRICT_SECRET_VALUE_LIMIT) return;+ if (typeof value === 'string') {+ if (!urlBearing) return;+ try {+ const url = new URL(value);+ if (!['http:', 'https:'].includes(url.protocol)) return;+ into.push(value);+ if (url.href !== value) into.push(url.href);+ } catch {}+ return;+ }+ if (Array.isArray(value)) {+ for (const item of value) collectUrlTraceStringsFromNamedFields(item, into, depth + 1, urlBearing);+ return;+ }+ if (!value || typeof value !== 'object') return;+ for (const [key, item] of Object.entries(value)) {+ const normalizedKey = normalizedCloudKey(key).toLowerCase();+ collectUrlTraceStringsFromNamedFields(+ item,+ into,+ depth + 1,+ urlBearing || /urls?$/.test(normalizedKey),+ );+ if (into.length > CLOUD_STRICT_SECRET_VALUE_LIMIT) return;+ }+}++// verify_form represents an input's identity and value as siblings, for+// example `{ name: 'api_key', value: 'secret' }`. The generic key walk above+// cannot connect those fields, so reuse the same credential detector that+// classifies fields when they are filled and register only that field record's+// value-bearing leaves.+function collectCredentialFieldValues(value, into, depth = 0) {+ if (depth > 6 || into.length > CLOUD_STRICT_SECRET_VALUE_LIMIT) return;+ if (Array.isArray(value)) {+ for (const item of value) collectCredentialFieldValues(item, into, depth + 1);+ return;+ }+ if (!value || typeof value !== 'object') return;+ const credential = isCredentialField({+ type: value.type,+ name: value.name,+ id: value.id,+ autocomplete: value.autocomplete,+ ariaLabel: value.ariaLabel ?? value.aria_label,+ placeholder: value.placeholder,+ labelText: value.labelText ?? value.label,+ }).sensitive;+ if (credential) {+ for (const [key, item] of Object.entries(value)) {+ if (!VERIFY_FORM_VALUE_KEYS.has(normalizedCloudKey(key).toLowerCase())) continue;+ if (typeof item === 'string') into.push(item);+ else if (typeof item === 'number' && Number.isFinite(item)) into.push(String(item));+ }+ }+ for (const item of Object.values(value)) {+ if (item && typeof item === 'object') collectCredentialFieldValues(item, into, depth + 1);+ if (into.length > CLOUD_STRICT_SECRET_VALUE_LIMIT) return;+ }+}++// A request body is a string argument, so the key-walk above cannot see into+// it. Both encodings a mutating call realistically uses are cheap to parse.+function collectRequestBodySecrets(body, into) {+ if (typeof body !== 'string' || !body) return false;+ // Do not silently skip a body that is too large for bounded inspection. The+ // caller marks the run as overflowed so every later scalar is redacted rather+ // than relying on the model not to repeat an unknown credential.+ if (body.length > WORKFLOW_PARAMETER_VALUE_LIMIT) return true;+ try {+ collectSensitiveStrings(JSON.parse(body), into);+ return false;+ } catch {+ // Not JSON — fall through to the form encoding.+ }+ try {+ for (const [key, value] of new URLSearchParams(body)) {+ if (isSensitiveCloudKey(key)) into.push(value);+ }+ } catch {+ // Undecodable body: nothing to register, and the argument is dropped anyway.+ }+ return false;+}++function redactWorkflowRuntimeValues(value, runtimeValues = [], label = '[workflow parameter]') {+ if (value == null) return value;+ const variants = new Set();+ for (const parameterValue of runtimeValues) {+ if (typeof parameterValue !== 'string' || !parameterValue.length) continue;+ variants.add(parameterValue);+ try {+ const componentEncoded = encodeURIComponent(parameterValue);+ variants.add(componentEncoded);+ variants.add(componentEncoded.replace(/%20/g, '+'));+ variants.add(encodeURI(parameterValue));+ const formEncoded = new URLSearchParams([['value', parameterValue]])+ .toString()+ .slice('value='.length);+ variants.add(formEncoded);+ } catch {+ // Raw replacement above still protects malformed strings that URI+ // encoders cannot represent (for example, lone UTF-16 surrogates).+ }+ }+ const values = [...variants]+ .sort((a, b) => b.length - a.length);+ if (!values.length) return value;+ const normalizePercentEscapes = input => input.replace(+ /%[0-9a-f]{2}/gi,+ match => match.toUpperCase(),+ );+ const redactString = (input) => values.reduce((text, parameterValue) => {+ const normalizedText = normalizePercentEscapes(text);+ const normalizedValue = normalizePercentEscapes(parameterValue);+ if (!normalizedText.includes(normalizedValue)) return text;+ let result = '';+ let offset = 0;+ let index = normalizedText.indexOf(normalizedValue, offset);+ while (index !== -1) {+ const boundaryMatch = parameterValue.length >= CLOUD_STRICT_SECRET_MIN_LENGTH+ || (+ (index === 0 || !/[A-Za-z0-9]/.test(normalizedText[index - 1]))+ && (+ index + normalizedValue.length === normalizedText.length+ || !/[A-Za-z0-9]/.test(normalizedText[index + normalizedValue.length])+ )+ );+ if (!boundaryMatch) {+ const nextOffset = index + normalizedValue.length;+ result += text.slice(offset, nextOffset);+ offset = nextOffset;+ index = normalizedText.indexOf(normalizedValue, offset);+ continue;+ }+ result += `${text.slice(offset, index)}${label}`;+ offset = index + parameterValue.length;+ index = normalizedText.indexOf(normalizedValue, offset);+ }+ return result + text.slice(offset);+ }, input);+ try {+ return JSON.parse(JSON.stringify(value, (_key, item) => (+ // A secret typed as text can come back as a JSON number — a six-digit OTP+ // is the obvious case. Match on the number's exact string form: a+ // substring rule would strike an unrelated `3` out of `481920`.+ typeof item === 'number' && values.includes(String(item))+ ? label+ : (typeof item === 'string' ? redactString(item) : item)+ )));+ } catch {+ return { unserializable: true };+ }+}++function serializedBytes(value) {+ return new TextEncoder().encode(JSON.stringify(value)).length;+}++function compactCloudRunForPersistence(run) {+ const row = scrubCloudValue(run);+ row.structured = row.structured ?? hasCloudOutputSchema(run?.outputSchema);+ if (serializedBytes(row) <= CLOUD_RUN_PERSIST_BYTES_LIMIT) return row;++ const omittedUpdates = Array.isArray(row.updates) ? row.updates.length : 0;+ row.updates = [];+ row.persistenceTruncated = { omittedUpdates };+ if (serializedBytes(row) <= CLOUD_RUN_PERSIST_BYTES_LIMIT) return row;++ row.content = '';+ row.outputSchema = null;+ row.persistenceTruncated.omittedContent = true;+ row.persistenceTruncated.omittedSchema = true;+ if (serializedBytes(row) <= CLOUD_RUN_PERSIST_BYTES_LIMIT) return row;++ delete row.result;+ row.persistenceTruncated.omittedResult = true;+ if (serializedBytes(row) <= CLOUD_RUN_PERSIST_BYTES_LIMIT) return row;++ return scrubCloudValue({+ runId: run?.runId,+ status: run?.status,+ workflowId: run?.workflowId || null,+ traceRunId: run?.traceRunId || null,+ parentRunId: run?.parentRunId || null,+ mode: run?.mode || 'act',+ captchaDiagnostics: run?.captchaDiagnostics || null,+ tabId: run?.tabId,+ task: run?.task,+ structured: hasCloudOutputSchema(run?.outputSchema) || run?.structured === true,+ pendingInput: run?.pendingInput || null,+ summary: run?.summary,+ content: '',+ finalUrl: run?.finalUrl,+ error: run?.error,+ createdAt: run?.createdAt,+ updatedAt: run?.updatedAt,+ completedAt: run?.completedAt,+ updates: [],+ persistenceTruncated: { omittedUpdates, omittedResult: true, omittedSchema: true },+ });+}++/**+ * Scheduled jobs answer a cloud query over the same bridge as run updates, so+ * they need the same strict-secret treatment: a summarized job otherwise ships+ * `lastResult`, `lastError`, `pendingClarify`, `target.url`, and+ * `watch.lastObservation` — a child task's raw prompt and output — straight past+ * every redaction applied to the parent run. Strict mode keeps only structural+ * and enumerated fields; free text and URLs are dropped.+ */+export function cloudSafeScheduledJob(job, { strictSecretMode = false } = {}) {+ if (!job || !strictSecretMode) return job;+ return {+ id: job.id,+ kind: job.kind,+ source: job.source || null,+ status: job.status,+ scheduledAt: job.scheduledAt,+ nextRunAt: job.nextRunAt || job.scheduledAt,+ lastOutcome: job.lastOutcome || null,+ needsUserInput: job.needsUserInput === true,+ clarificationRequired: job.clarificationRequired === true,+ completedAt: job.completedAt || null,+ createdAt: job.createdAt,+ updatedAt: job.updatedAt,+ sensitiveFieldsRedacted: true,+ };+}++export function buildCloudPersistenceRows(runs) {+ const values = Array.isArray(runs) ? [...runs] : [...(runs?.values?.() || [])];+ const candidates = values+ .sort((a, b) => String(b?.createdAt || '').localeCompare(String(a?.createdAt || '')))+ .slice(0, CLOUD_RUN_LIMIT)+ .map(compactCloudRunForPersistence);+ const rows = [];+ let totalBytes = 2;+ for (const row of candidates) {+ const rowBytes = serializedBytes(row) + (rows.length ? 1 : 0);+ if (totalBytes + rowBytes > CLOUD_PERSIST_BYTES_LIMIT) continue;+ rows.push(row);+ totalBytes += rowBytes;+ }+ return rows;+}++function cloudSnapshot(run, { includeUpdates = true } = {}) {+ if (!run) return null;+ return {+ runId: run.runId,+ status: run.status,+ workflowId: run.workflowId || null,+ parentRunId: run.parentRunId || null,+ mode: run.mode || 'act',+ tabId: run.tabId,+ task: run.task,+ structured: run.structured ?? hasCloudOutputSchema(run.outputSchema),+ pendingInput: run.pendingInput || null,+ ...(run.captchaDiagnostics ? { captchaDiagnostics: run.captchaDiagnostics } : {}),+ result: run.result,+ persistenceTruncated: run.persistenceTruncated,+ summary: run.summary,+ content: run.content,+ finalUrl: run.finalUrl,+ error: run.error,+ createdAt: run.createdAt,+ updatedAt: run.updatedAt,+ completedAt: run.completedAt,+ updates: includeUpdates ? run.updates : undefined,+ };+}++function isUsableCloudTab(tab) {+ if (tab?.id == null) return false;+ try {+ // Chrome can leave an unpacked-extension startup tab's `url` empty while+ // exposing the loaded page through `pendingUrl`, even with status=complete.+ const url = new URL(tab.url || tab.pendingUrl || '');+ return ['http:', 'https:', 'file:'].includes(url.protocol) || url.href === 'about:blank';+ } catch {+ return false;+ }+}++export function createCloudRunController({+ chromeApi,+ agent,+ // Firefox MV2 has no offscreen document: the bridge runs in the background+ // page (see cloud-bridge.js) and is injected here.+ bridge,+ sendIndicator = () => {},+ startRecording = null,+ stopRecording = null,+ workflowTrace = null,+ now = () => new Date(),+ makeRunId = () => `run_${globalThis.crypto.randomUUID()}`,+} = {}) {+ const api = chromeApi;+ const runs = new Map();+ const startingTabs = new Set();+ let hydratePromise = null;+ let persistQueue = Promise.resolve();+ let persistTimer = null;++ const isoNow = () => now().toISOString();++ async function persist() {+ if (!api.storage?.session?.set) return;+ const rows = buildCloudPersistenceRows(runs);+ persistQueue = persistQueue+ .catch(() => {})+ .then(() => api.storage.session.set({ [CLOUD_RUN_STORAGE_KEY]: rows }));+ await persistQueue;+ }++ function schedulePersist() {+ if (persistTimer) return;+ persistTimer = setTimeout(() => {+ persistTimer = null;+ persist().catch(() => {});+ }, 100);+ }++ async function hydrate() {+ if (hydratePromise) return hydratePromise;+ hydratePromise = (async () => {+ if (!api.storage?.session?.get) return;+ const stored = await api.storage.session.get(CLOUD_RUN_STORAGE_KEY).catch(() => ({}));+ const rows = Array.isArray(stored?.[CLOUD_RUN_STORAGE_KEY]) ? stored[CLOUD_RUN_STORAGE_KEY] : [];+ let changed = false;+ for (const row of rows) {+ if (!row?.runId) continue;+ const rawUpdates = Array.isArray(row.updates) ? row.updates : [];+ let nextUpdateSeq = 0;+ const updates = rawUpdates.map((update) => {+ const candidate = Number(update?.seq);+ const seq = Number.isSafeInteger(candidate) && candidate > nextUpdateSeq+ ? candidate+ : nextUpdateSeq + 1;+ if (seq !== candidate) changed = true;+ nextUpdateSeq = seq;+ return { ...update, seq };+ });+ const restored = { ...row, updates, nextUpdateSeq };+ if (!TERMINAL_STATUSES.has(restored.status)) {+ const at = isoNow();+ restored.status = restored.status === 'aborting' ? 'aborted' : 'failed';+ restored.pendingInput = null;+ restored.error = restored.status === 'aborted'+ ? 'Run aborted when the WebBrain service worker restarted.'+ : 'Run interrupted when the WebBrain service worker restarted.';+ restored.updatedAt = at;+ restored.completedAt = at;+ changed = true;+ }+ runs.set(restored.runId, restored);+ }+ if (changed) await persist();+ })();+ return hydratePromise;+ }++ async function activateTab(tab) {+ if (!tab?.id) return tab;+ await api.tabs.update(tab.id, { active: true }).catch(() => {});+ if (tab.windowId != null && api.windows?.update) {+ await api.windows.update(tab.windowId, { focused: true }).catch(() => {});+ }+ return tab;+ }++ async function resolveTabId(requestedTabId) {+ if (requestedTabId != null && requestedTabId !== '') {+ const tab = await api.tabs.get(Number(requestedTabId));+ if (!isUsableCloudTab(tab)) throw new Error(`Tab ${requestedTabId} is not a controllable webpage.`);+ return tab.id;+ }++ const active = await api.tabs.query({ active: true, lastFocusedWindow: true });+ const activeTab = active.find(isUsableCloudTab);+ if (activeTab) return activeTab.id;++ const allTabs = await api.tabs.query({});+ const fallback = allTabs.find(isUsableCloudTab);+ if (fallback) return fallback.id;++ const created = await api.tabs.create({ url: 'about:blank', active: true });+ if (created?.id == null) throw new Error('Could not create a browser tab for the cloud run.');+ return created.id;+ }++ async function getTabUrl(tabId) {+ try {+ return (await api.tabs.get(tabId))?.url || '';+ } catch {+ return '';+ }+ }++ // Kept out of the run object so a literal secret can never reach session+ // storage or a persistence row. Dropped when the run leaves the map.+ const strictSecretValues = new Map();+ const strictTraceValues = new Map();+ const strictSecretOverflowRuns = new Set();+ const strictTraceOverflowRuns = new Set();++ function rememberStrictCandidates(run, candidates, registry, overflowRuns) {+ if (!candidates.length) return;+ const known = registry.get(run.runId) || [];+ for (const candidate of candidates) {+ if (typeof candidate !== 'string') continue;+ const shortNumericSecret = /^\d{1,3}$/.test(candidate);+ if (candidate.length < CLOUD_STRICT_SECRET_MIN_LENGTH && !shortNumericSecret) continue;+ if (candidate.length > WORKFLOW_PARAMETER_VALUE_LIMIT) continue;+ if (known.includes(candidate)) continue;+ if (known.length >= CLOUD_STRICT_SECRET_VALUE_LIMIT) {+ // Never evict an earlier credential or trace-only URL and silently+ // expose it later. Losing free-text utility is preferable to leakage.+ overflowRuns.add(run.runId);+ break;+ }+ known.push(candidate);+ }+ if (known.length) registry.set(run.runId, known);+ }++ // Whatever a strict run types into a page is a value the caller must never+ // read back, wherever it later resurfaces — a clarification question, a+ // warning, a captcha diagnostic. Remember it here, before the redactors drop+ // the argument that carried it.+ function rememberStrictSecrets(run, type, data) {+ const name = String(data?.name || data?.tool || '');+ const candidates = [];+ const traceCandidates = [];+ if (type === 'tool_call') {+ const args = data?.args && typeof data.args === 'object' ? data.args : {};+ if (CLOUD_TEXT_ENTRY_TOOLS.has(name)) candidates.push(args.text, args.value);+ collectUrlSecretsFromNamedFields(args, candidates);+ collectUrlTraceStringsFromNamedFields(args, traceCandidates);+ // A credential does not have to be typed into a page to exist. The+ // disposable-signup scenario mints its account password inside the JSON+ // body of `POST /accounts` and never types it, so registering only+ // text-entry arguments left it unknown to the value redactor.+ collectSensitiveStrings(args, candidates);+ if (collectRequestBodySecrets(args.body, candidates)) {+ strictSecretOverflowRuns.add(run.runId);+ }+ } else if (type === 'tool_result') {+ // The value under a sensitive key is already known to be a secret; the+ // key-based scrubber only masks it in place, so register the literal and+ // strike it from later prose as well.+ //+ // Known limit: a secret the model only ever *reads* out of an+ // unremarkable field — an OTP in the body text of an inbox message — is+ // never seen here in a form this can recognize, so a clarification that+ // quotes it is covered by the strict system prompt alone. Closing that+ // would mean either blanking clarification text, which makes a strict run+ // unanswerable, or entropy guessing at prose.+ collectSensitiveStrings(data?.result, candidates);+ collectUrlSecretsFromNamedFields(data?.result, candidates);+ collectUrlTraceStringsFromNamedFields(data?.result, traceCandidates);+ if (name === 'verify_form') collectCredentialFieldValues(data?.result, candidates);+ }+ rememberStrictCandidates(run, candidates, strictSecretValues, strictSecretOverflowRuns);+ rememberStrictCandidates(run, traceCandidates, strictTraceValues, strictTraceOverflowRuns);+ }++ function redactStrictSecretValues(run, value, strictSecretMode) {+ if (!strictSecretMode) return value;+ if (strictSecretOverflowRuns.has(run.runId)) return redactStrictStructuredValues(value);+ const known = strictSecretValues.get(run.runId);+ if (!known?.length) return value;+ return redactWorkflowRuntimeValues(value, known, '[redacted strict value]');+ }++ function redactStrictTraceValues(run, value, strictSecretMode) {+ const withoutSecrets = redactStrictSecretValues(run, value, strictSecretMode);+ if (!strictSecretMode || strictSecretOverflowRuns.has(run.runId)) return withoutSecrets;+ if (strictTraceOverflowRuns.has(run.runId)) return redactStrictStructuredValues(withoutSecrets);+ const known = strictTraceValues.get(run.runId);+ if (!known?.length) return withoutSecrets;+ return redactWorkflowRuntimeValues(withoutSecrets, known, '[redacted strict URL]');+ }++ // Terminal prose reaches the caller by the same two routes as an update row,+ // so it takes both secret and trace-only URL redaction. A structured+ // `run.result` is handled separately below and takes only credential-value+ // redaction so ordinary schema-valid URL components remain usable.+ function redactStrictTerminal(run, value, strictSecretMode) {+ return redactStrictTraceValues(run, value, strictSecretMode);+ }++ function pushUpdate(run, type, data, runtimeValues = []) {+ run.updatedAt = isoNow();+ const previous = run.updates.at(-1);+ const strictSecretMode = agent.strictSecretMode === true;+ if (strictSecretMode) rememberStrictSecrets(run, type, data);+ // Consecutive text_delta events upsert the same seq: content grows in place+ // and ts advances. Full-array pollers are fine; append-only / seq-cursor+ // clients must re-read that row (or take a full snapshot) rather than+ // assuming each seq is immutable.+ if (type === 'text_delta' && previous?.type === 'text_delta') {+ // Deltas must pass through the same redaction as any other update: this+ // branch used to append raw model output straight onto the stored row.+ const safeDelta = cloudSafeUpdateData(type, data, { strictSecretMode });+ previous.data = scrubCloudValue(redactStrictTraceValues(run, redactWorkflowRuntimeValues({+ ...previous.data,+ content: strictSecretMode+ ? (safeDelta?.content || '')+ : `${previous.data?.content || ''}${safeDelta?.content || ''}`,+ }, runtimeValues), strictSecretMode));+ previous.ts = run.updatedAt;+ schedulePersist();+ return;+ }+ run.nextUpdateSeq = (Number(run.nextUpdateSeq) || 0) + 1;+ const safeData = cloudSafeUpdateData(type, data, { strictSecretMode });+ const scrubbedData = scrubCloudValue(+ redactStrictTraceValues(run, redactWorkflowRuntimeValues(safeData, runtimeValues), strictSecretMode),+ );+ run.updates.push({ seq: run.nextUpdateSeq, type, data: scrubbedData, ts: run.updatedAt });+ if (run.updates.length > CLOUD_UPDATE_LIMIT) {+ run.updates.splice(0, run.updates.length - CLOUD_UPDATE_LIMIT);+ }+ if (type === 'tool_result' && scrubbedData?.name === 'done_json') {+ const result = data.result || {};+ const safeResult = scrubbedData.result || {};+ // Two different jobs, so two different redactors. The update row above is+ // trace and persistence with no contract to honour, and takes the blunt+ // leaf-type redaction. `run.result` and `run.summary` are the caller's+ // answer — the schema they asked for — so they take value redaction:+ // registered credentials are struck and everything else the contract+ // declares survives. Redacting those by leaf type returned `completed`+ // with every string and number replaced by a placeholder, which satisfies+ // strict mode by making the run useless.+ const publicSummary = strictSecretMode+ ? redactStrictTraceValues(run, result.summary, true)+ : safeResult.summary;+ if (result.cloudFailed) {+ run.status = 'failed';+ run.error = safeResult.error || 'done_json failed';+ run.summary = publicSummary || run.summary;+ } else if (Object.prototype.hasOwnProperty.call(result, 'cloudResult')) {+ run.result = strictSecretMode+ ? redactStrictSecretValues(run, result.cloudResult, true)+ : result.cloudResult;+ run.summary = publicSummary || run.summary;+ }+ }+ if (type === 'captcha_gate') {+ // Keep the latest sanitized frame/vendor snapshot at run level so it+ // survives the rolling 200-update window in exported cloud traces.+ run.captchaDiagnostics = { ...scrubbedData, observedAt: run.updatedAt };+ }+ if (type === 'clarify' && scrubbedData?.clarifyId && !TERMINAL_STATUSES.has(run.status)) {+ run.status = 'needs_user_input';+ run.pendingInput = scrubbedData;+ }+ if (type === 'clarify_timeout_extended' && scrubbedData?.clarifyId+ && (run.pendingInput?.clarifyId || run.pendingInput?.clarify_id) === scrubbedData.clarifyId+ && run.status === 'needs_user_input' && Number(scrubbedData.deadlineTs) > 0) {+ run.pendingInput = { ...run.pendingInput, deadlineTs: Number(scrubbedData.deadlineTs) };+ }+ if (type === 'clarify_auto' && scrubbedData?.clarifyId+ && (run.pendingInput?.clarifyId || run.pendingInput?.clarify_id) === scrubbedData.clarifyId+ && run.status === 'needs_user_input') {+ run.status = 'running';+ run.pendingInput = null;+ }+ if (type === 'run_status'+ && ['clarification_required', 'captcha_manual_required'].includes(scrubbedData?.status)+ && run.status !== 'aborting'+ && run.status !== 'aborted') {+ run.status = 'failed';+ run.error = scrubbedData.message+ || (scrubbedData.status === 'captcha_manual_required'+ ? 'Cloud run stopped because manual CAPTCHA completion is required.'+ : 'Cloud run stopped because explicit clarification authorization is required.');+ run.pendingInput = null;+ }+ if (type === 'plan_review' && run.status === 'running') {+ run.status = 'failed';+ run.error = 'Managed cloud runs cannot wait for interactive plan review.';+ agent.abort(run.tabId);+ }+ schedulePersist();+ }++ function validateWorkflowParameters(workflow, input) {+ if (!input || typeof input !== 'object' || Array.isArray(input)) {+ throw cloudRunError('`parameters` must be an object.', 400);+ }+ const descriptors = new Map((workflow.parameters || []).map(parameter => [parameter.id, parameter]));+ const parameters = Object.create(null);+ for (const [id, value] of Object.entries(input)) {+ if (!descriptors.has(id)) throw cloudRunError(`Unknown workflow parameter: ${id}`, 400);+ if (typeof value !== 'string') throw cloudRunError(`Workflow parameter ${id} must be a string.`, 400);+ if (value.length > WORKFLOW_PARAMETER_VALUE_LIMIT) {+ throw cloudRunError(`Workflow parameter ${id} exceeds ${WORKFLOW_PARAMETER_VALUE_LIMIT} characters.`, 400);+ }+ parameters[id] = value;+ }+ for (const descriptor of descriptors.values()) {+ if (descriptor.required !== false && !Object.hasOwn(parameters, descriptor.id)) {+ throw cloudRunError(`Missing workflow parameter: ${descriptor.id}`, 400);+ }+ }+ return parameters;+ }++ async function startRun(msg = {}) {+ await hydrate();+ const suppliedRunId = msg.runId ?? msg.run_id;+ const requestedRunId = suppliedRunId == null ? '' : String(suppliedRunId).trim();+ const parentRunId = String(msg.parentRunId || msg.parent_run_id || '').trim() || null;+ let parentRun = null;+ let requestedTabId = msg.tabId ?? msg.tab_id;+ if (parentRunId) {+ parentRun = runs.get(parentRunId) || null;+ if (parentRun) {+ if (!TERMINAL_STATUSES.has(parentRun.status)) {+ throw cloudRunError('Parent cloud run must be finished before it can be continued.', 409);+ }+ const existingChild = [...runs.values()].find(candidate => candidate.parentRunId === parentRunId);+ if (existingChild) {+ throw cloudRunError(`Cloud run has already been continued as ${existingChild.runId}.`, 409);+ }+ requestedTabId = parentRun.tabId;+ } else if (requestedTabId == null || requestedTabId === '') {+ throw cloudRunError('Parent cloud run is no longer available and has no saved tab.', 409);+ }+ }+ const tabId = await resolveTabId(requestedTabId);+ const workflow = msg._workflow || null;+ const mode = workflow ? 'act' : normalizeCloudRunMode(msg.mode, parentRun?.mode || 'act');+ const workflowParameters = msg._workflowParameters || {};+ const workflowParameterValues = workflow ? Object.values(workflowParameters) : [];+ const redactWorkflowValue = value => redactWorkflowRuntimeValues(value, workflowParameterValues);+ const task = workflow+ ? `Run saved workflow: ${workflow.name}`+ : String(msg.task || msg.text || '').trim();+ if (!task) throw new Error('cloud_run requires `task`.');+ if (startingTabs.has(tabId) || agent.isRunning(tabId)) {+ throw new Error(`Tab ${tabId} already has an active WebBrain run.`);+ }++ const apiMutationsAllowed = msg.apiMutationsAllowed === true || msg.api_mutations_allowed === true;+ if (apiMutationsAllowed && mode !== 'act') {+ throw cloudRunError('API mutation permission requires cloud_run mode `act`.', 400);+ }+ const grantApiMutationsForRun = apiMutationsAllowed+ && agent.isApiMutationsAllowed?.(tabId) !== true;+ const outputSchema = workflow+ ? null+ : msg.outputSchema ?? msg.output_schema ?? msg.responseFormat?.schema ?? msg.response_format?.schema ?? null;+ const structured = hasCloudOutputSchema(outputSchema);+ const runId = requestedRunId || String(makeRunId());+ // Cloud-assigned IDs are valid correlation keys, but they must not replace+ // an active or persisted run. Besides losing the older run from status+ // queries, replacement aliases both runs' strict-secret registries; the+ // first run to finish would then clear the second run's redaction state.+ if (runs.has(runId)) {+ throw cloudRunError(`Cloud run ${runId} already exists.`, 409);+ }+ startingTabs.add(tabId);+ try {+ await agent.assertRunStartAllowed?.(tabId, 'cloud', { cloudRun: true });+ const targetTab = await api.tabs.get(tabId);+ await activateTab(targetTab);+ } catch (error) {+ startingTabs.delete(tabId);+ throw error;+ }+ const createdAt = isoNow();+ const run = {+ runId,+ status: 'running',+ workflowId: workflow?.id || null,+ traceRunId: null,+ parentRunId,+ mode,+ tabId,+ task,+ structured,+ outputSchema,+ capture: msg.capture === 'video' ? 'video' : 'none',+ result: undefined,+ summary: '',+ content: '',+ finalUrl: '',+ error: '',+ pendingInput: null,+ updates: [],+ nextUpdateSeq: 0,+ createdAt,+ updatedAt: createdAt,+ completedAt: null,+ };+ runs.set(run.runId, run);+ try {+ await persist();+ } catch (error) {+ runs.delete(run.runId);+ startingTabs.delete(tabId);+ throw error;+ }++ (async () => {+ let recordingId = null;+ const strictSecretMode = agent.strictSecretMode === true;+ try {+ // A continuation starts only after its parent has finished, so the+ // agent's active-run map cannot identify the parent here. The cloud+ // run record keeps the actual trace id; resolve its session from that+ // trace instead of attaching the tab's potentially unrelated session.+ const parentTraceRunId = parentRun?.traceRunId || null;+ let parentTraceSessionId = null;+ if (parentTraceRunId && typeof workflowTrace?.getRun === 'function') {+ try {+ const parentTrace = await workflowTrace.getRun(parentTraceRunId);+ parentTraceSessionId = parentTrace?.conversationId || null;+ } catch { /* lineage lookup is best-effort and must not fail a run */ }+ }+ if (run.capture === 'video') {+ try {+ if (!startRecording || !stopRecording) throw new Error('Cloud run video capture is unavailable.');+ const recording = await startRecording(tabId, {+ video: true,+ mic: false,+ showBanner: false,+ filename: `webbrain-ci-${run.runId}.webm`,+ });+ if (!recording?.ok) throw new Error(recording?.error || 'Cloud run video capture could not start.');+ recordingId = recording.state?.recordingId || null;+ } catch (captureError) {+ pushUpdate(run, 'capture_error', {+ kind: 'video',+ message: captureError?.message || String(captureError),+ });+ throw captureError;+ }+ pushUpdate(run, 'artifact_started', {+ kind: 'video',+ filename: `webbrain-ci-${run.runId}.webm`,+ });+ }+ if (grantApiMutationsForRun) agent.setTemporaryApiMutationsAllowed(tabId, true);+ sendIndicator(tabId, 'WB_SHOW_AGENT_INDICATORS');+ const publishUpdate = (type, data) => pushUpdate(+ run,+ type,+ workflow && type === 'text_delta'+ ? { ...(data || {}), content: '[workflow output redacted]' }+ : data,+ workflowParameterValues,+ );+ let content;+ if (workflow) {+ const replay = await agent.replaySavedWorkflow(+ tabId,+ workflow,+ workflowParameters,+ publishUpdate,+ { cloudRun: true, independentRun: true },+ );+ content = redactWorkflowValue(replay.summary || '');+ run.summary = redactWorkflowValue(replay.summary || run.summary);+ if (replay.status === 'fallback') {+ pushUpdate(run, 'workflow_fallback', {+ workflowId: workflow.id,+ stepIndex: replay.stepIndex,+ reason: replay.reason,+ });+ content = redactWorkflowValue(await agent.processMessage(+ tabId, replay.prompt, publishUpdate, 'act', [], {+ cloudRun: true,+ independentRun: true,+ preserveRichTextToolbarAudit: true,+ },+ ));+ } else if (replay.status === 'stopped') {+ run.status = 'failed';+ run.error = redactWorkflowValue(+ replay.summary || replay.reason || 'Saved workflow stopped safely.'+ );+ }+ } else {+ content = await agent.processMessage(tabId, task, publishUpdate, mode, [], {+ cloudRun: true,+ independentRun: true,+ apiMutationsDenied: mode === 'ask',+ outputSchema,+ onTraceStarted(traceRunId) {+ run.traceRunId = traceRunId;+ schedulePersist();+ },+ parentRunId: parentTraceRunId,+ parentSessionId: parentTraceSessionId,+ });+ }+ run.pendingInput = null;+ // Terminal fields are published over the bridge and persisted just like+ // update rows, so they get the same strict treatment — structured or+ // not. An unstructured strict run used to return its final answer raw,+ // which is where a model is most likely to repeat the credential it was+ // told not to. Value redaction rather than blanking, because for an+ // unstructured run this text *is* the result: the answer survives with+ // the literal struck.+ run.content = strictSecretMode && structured+ ? (run.summary || '[redacted strict structured completion]')+ : redactStrictTerminal(run, redactWorkflowValue(content), strictSecretMode);+ run.finalUrl = cloudTerminalUrl(redactWorkflowValue(await getTabUrl(tabId)), { strictSecretMode });+ if (run.status === 'aborting') {+ run.status = 'aborted';+ run.error = run.error || 'Aborted by cloud_abort.';+ } else if (run.status !== 'failed') {+ if (structured && run.result === undefined) {+ run.status = 'failed';+ run.error = 'Structured cloud run finished without a valid done_json result.';+ } else {+ run.status = 'completed';+ if (!structured) {+ run.result = redactStrictTerminal(run, redactWorkflowValue(content), strictSecretMode);+ }+ }+ }+ } catch (error) {+ run.pendingInput = null;+ run.status = run.status === 'aborting' ? 'aborted' : 'failed';+ run.error = redactStrictTerminal(+ run, redactWorkflowValue(error?.message || String(error)), strictSecretMode,+ );+ run.finalUrl = cloudTerminalUrl(redactWorkflowValue(await getTabUrl(tabId)), { strictSecretMode });+ } finally {+ startingTabs.delete(tabId);+ // The bridge flag is a run-scoped grant, not the sidebar's persistent+ // /allow-api setting. Revoke only permission this run added; preserve a+ // pre-existing per-conversation or global user grant.+ if (grantApiMutationsForRun) agent.setTemporaryApiMutationsAllowed(tabId, false);++ // Do not expose a terminal status until the requested recording has+ // finished flushing to Downloads; pollers use terminality as the cue+ // that traces and artifacts are complete.+ const terminalStatus = recordingId && TERMINAL_STATUSES.has(run.status)+ ? run.status+ : null;+ if (terminalStatus) run.status = 'running';+ if (recordingId) {+ try {+ const capture = await stopRecording({ expectedRecordingId: recordingId });+ if (!capture?.ok) throw new Error(capture?.error || 'Cloud run video capture could not stop.');+ pushUpdate(run, 'artifact', {+ kind: 'video',+ filename: capture.filename || `webbrain-ci-${run.runId}.webm`,+ });+ } catch (captureError) {+ pushUpdate(run, 'capture_error', {+ kind: 'video',+ message: captureError?.message || String(captureError),+ });+ }+ }+ if (terminalStatus) run.status = terminalStatus;+ run.completedAt = isoNow();+ run.updatedAt = run.completedAt;+ // The run is over, so nothing more can quote these; do not hold the+ // literals in memory any longer than the run that typed them.+ strictSecretValues.delete(run.runId);+ strictTraceValues.delete(run.runId);+ strictSecretOverflowRuns.delete(run.runId);+ strictTraceOverflowRuns.delete(run.runId);+ sendIndicator(tabId, 'WB_HIDE_AGENT_INDICATORS');+ await persist().catch(() => {});+ }+ })();++ return cloudSnapshot(run, { includeUpdates: false });+ }++ async function startWorkflowRun(msg = {}) {+ const workflow = normalizeSavedWorkflow(msg.workflow);+ if (!workflow) throw cloudRunError('Saved workflow is missing or invalid.', 400);+ if (msg.parentRunId || msg.parent_run_id) {+ throw cloudRunError('Saved workflow runs cannot be continuations.', 400);+ }+ const parameters = validateWorkflowParameters(+ workflow,+ msg.parameters ?? {},+ );+ return startRun({+ ...msg,+ task: '',+ text: '',+ outputSchema: null,+ output_schema: null,+ _workflow: workflow,+ _workflowParameters: parameters,+ });+ }++ async function compileWorkflow(msg = {}) {+ await hydrate();+ const runId = String(msg.runId || msg.run_id || '').trim();+ const name = String(msg.name || '').trim();+ if (!runId) return { ok: false, status: 400, reason: 'run_required', warnings: [] };+ if (!name) return { ok: false, status: 400, reason: 'name_required', warnings: [] };+ const run = runs.get(runId);+ if (!run) return { ok: false, status: 404, reason: 'run_not_found', warnings: [] };+ if (run.workflowId) {+ return { ok: false, status: 422, reason: 'workflow_run_not_compilable', warnings: [] };+ }+ if (run.status !== 'completed') {+ return { ok: false, status: 409, reason: 'successful_run_required', warnings: [] };+ }+ if (!run.traceRunId || !workflowTrace) {+ return { ok: false, status: 409, reason: 'trace_unavailable', warnings: [] };+ }+ const draft = typeof agent.getLatestWorkflowDraft === 'function'+ ? await agent.getLatestWorkflowDraft(run.tabId)+ : null;+ let compiled = draft?.sourceRunId === run.traceRunId+ ? finalizeSavedWorkflowDraft(draft, { name })+ : null;+ if (!compiled) {+ for (let attempt = 0; attempt < 10; attempt += 1) {+ compiled = await compileSuccessfulWorkflowByRunId(workflowTrace, {+ runId: run.traceRunId,+ name,+ });+ if (compiled.workflow || compiled.reason !== 'successful_run_required') break;+ await new Promise(resolve => setTimeout(resolve, 50));+ }+ }+ if (!compiled?.workflow) {+ return {+ ok: false,+ status: compiled?.reason === 'no_replayable_steps' ? 422 : 409,+ reason: compiled?.reason || 'workflow_compilation_failed',+ warnings: compiled?.warnings || [],+ };+ }+ return { ok: true, workflow: compiled.workflow, warnings: compiled.warnings || [] };+ }++ async function status(msg = {}) {+ await hydrate();+ const runId = msg.runId || msg.run_id;+ if (!runId) return { runs: [...runs.values()].map(run => cloudSnapshot(run, { includeUpdates: false })) };+ const run = runs.get(runId);+ if (!run) throw new Error('Unknown cloud run.');+ return cloudSnapshot(run);+ }++ async function abort(msg = {}) {+ await hydrate();+ const run = runs.get(msg.runId || msg.run_id);+ if (!run) throw new Error('Unknown cloud run.');+ if (run.status === 'running' || run.status === 'needs_user_input') {+ run.status = 'aborting';+ run.pendingInput = null;+ run.error = 'Abort requested.';+ run.updatedAt = isoNow();+ agent.abort(run.tabId);+ await persist();+ }+ return cloudSnapshot(run);+ }++ async function respond(msg = {}) {+ await hydrate();+ const run = runs.get(msg.runId || msg.run_id);+ if (!run) throw cloudRunError('Unknown cloud run.', 404);+ if (run.status !== 'needs_user_input') {+ throw cloudRunError('Cloud run is not waiting for user input.', 409);+ }+ const clarifyId = String(msg.clarifyId || msg.clarify_id || '').trim();+ if (!clarifyId) throw cloudRunError('cloud_respond requires `clarify_id`.', 400);+ const pendingClarifyId = String(run.pendingInput?.clarifyId || run.pendingInput?.clarify_id || '').trim();+ if (!pendingClarifyId || clarifyId !== pendingClarifyId) {+ throw cloudRunError('Clarification is no longer pending for this cloud run.', 409);+ }+ const answer = String(msg.answer ?? '').trim();+ if (!answer) throw cloudRunError('cloud_respond requires `answer`.', 400);+ if (!agent.submitClarifyResponse(run.tabId, clarifyId, answer, 'cloud_api')) {+ throw cloudRunError('Clarification is no longer available in the active WebBrain run.', 409);+ }+ run.status = 'running';+ run.pendingInput = null;+ run.error = '';+ pushUpdate(run, 'clarify_response', { clarifyId, source: 'cloud_api' });+ await persist();+ return cloudSnapshot(run);+ }++ // Persistent bridge identity (chrome.storage.local). The token is the Cloud+ // Bridge credential only; it is unrelated to provider API keys.+ //+ // Concurrent starts (a settings save triggers syncBridge while the page also+ // sends cloud_bridge_start) must not each mint an installation id, so the+ // read-or-create step is single-flight.+ let installationIdInit = null;+ function ensureInstallationId() {+ if (!installationIdInit) {+ installationIdInit = (async () => {+ const stored = await api.storage.local.get('webbrainCloudBridgeInstallationId');+ if (stored.webbrainCloudBridgeInstallationId) return stored.webbrainCloudBridgeInstallationId;+ const created = crypto.randomUUID();+ await api.storage.local.set({ webbrainCloudBridgeInstallationId: created });+ return created;+ })().finally(() => { installationIdInit = null; });+ }+ return installationIdInit;+ }++ async function bridgeIdentity() {+ const installationId = await ensureInstallationId();+ const stored = await api.storage.local.get([+ 'webbrainCloudBridgeToken',+ 'webbrainCloudBridgeBrowserId',+ ]);+ return {+ token: stored.webbrainCloudBridgeToken || '',+ browserId: stored.webbrainCloudBridgeBrowserId || installationId,+ installationId,+ extensionVersion: api.runtime.getManifest?.().version || '',+ };+ }++ async function startBridge(url = DEFAULT_CLOUD_BRIDGE_URL) {+ return bridge.start({+ url: normalizeCloudBridgeUrl(url),+ ...(await bridgeIdentity()),+ });+ }++ async function stopBridge() {+ return bridge.stop();+ }++ async function bridgeStatus() {+ return bridge.status();+ }++ async function syncBridge() {+ const stored = await api.storage.local.get(['webbrainCloudBridgeEnabled', 'webbrainCloudBridgeUrl']);+ if (!stored.webbrainCloudBridgeEnabled) return stopBridge().catch(() => ({ enabled: false, connected: false }));+ return startBridge(stored.webbrainCloudBridgeUrl || DEFAULT_CLOUD_BRIDGE_URL);+ }++ return {+ runs,+ isRunning: (tabId) => startingTabs.has(tabId),+ startRun,+ startWorkflowRun,+ compileWorkflow,+ status,+ respond,+ abort,+ startBridge,+ stopBridge,+ bridgeStatus,+ syncBridge,+ hydrate,+ };+}diff --git a/src/firefox/src/ui/locales/ar.js b/src/firefox/src/ui/locales/ar.jsindex 4d21438da..9ffd96384 100644--- a/src/firefox/src/ui/locales/ar.js+++ b/src/firefox/src/ui/locales/ar.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Arabic (ar).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'تكبير واجهة الإضافة','sp.ui_scale.decrease': 'تصغير واجهة الإضافة','sp.ui_scale.increase': 'تكبير واجهة الإضافة',diff --git a/src/firefox/src/ui/locales/bn.js b/src/firefox/src/ui/locales/bn.jsindex 4474e21bf..cdc4906f5 100644--- a/src/firefox/src/ui/locales/bn.js+++ b/src/firefox/src/ui/locales/bn.js@@ -1,10 +1,12 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Bengali — translated from the canonical English locale.import { getApocalypseModeCopy } from './apocalypse-copy.mjs';import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'এক্সটেনশনের UI জুম','sp.ui_scale.decrease': 'এক্সটেনশনের UI ছোট করুন','sp.ui_scale.increase': 'এক্সটেনশনের UI বড় করুন',diff --git a/src/firefox/src/ui/locales/cloud-bridge-copy.mjs b/src/firefox/src/ui/locales/cloud-bridge-copy.mjsnew file mode 100644index 000000000..4df7ff44d--- /dev/null+++ b/src/firefox/src/ui/locales/cloud-bridge-copy.mjs@@ -0,0 +1,22 @@+// English fallback for the Cloud Bridge settings tab; shared to keep locale keys aligned.+export default {+ "st.cb.invalid_url": "Use a local ws:// URL with 127.0.0.1, localhost, or ::1.",+ "st.cb.status_disabled": "Bridge disabled",+ "st.cb.status_error": "Connection error: {error}",+ "st.tab.cloudbridge": 'Cloud Bridge',+ "st.cb.enabled": 'Let a backend control this browser',+ "st.cb.desc": 'WebBrain connects out to the backend below and waits for cloud_* commands. With a token set, the backend must approve this browser before any command runs.',+ "st.cb.url": 'Backend WebSocket URL (local ws:// only)',+ "st.cb.token": 'Cloud Bridge token',+ "st.cb.token_hint": 'Leave empty for a plain local controller (no approval step). This is not a provider API key.',+ "st.cb.browser_name": 'Browser name',+ "st.cb.installation_id": 'Installation ID:',+ "st.cb.test": 'Save & test connection',+ "st.cb.testing": 'Testing…',+ "st.cb.connected": 'Connected (no approval required).',+ "st.cb.pending": 'Connected — waiting for the backend to approve this browser.',+ "st.cb.approved": 'Connected and approved.',+ "st.cb.rejected": 'Rejected by the backend: {reason}',+ "st.cb.unreachable": 'Backend unreachable at {url}.',+ "st.cb.howto_html": 'To try it locally, run <code>node examples/cloud-bridge-approval-server.mjs --token YOUR_TOKEN</code> from the WebBrain checkout, enter the same token here, then press “Save & test connection”. Type <code>approve</code> in that terminal. <a href="https://github.com/webbrain-one/webbrain/blob/main/docs/cloud-bridge-browser-approval.md" target="_blank" rel="noopener noreferrer">Documentation</a>',+};diff --git a/src/firefox/src/ui/locales/de.js b/src/firefox/src/ui/locales/de.jsindex 09d18072c..6891babaa 100644--- a/src/firefox/src/ui/locales/de.js+++ b/src/firefox/src/ui/locales/de.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// German (de).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Erweiterungsoberfläche zoomen','sp.ui_scale.decrease': 'Erweiterungsoberfläche verkleinern','sp.ui_scale.increase': 'Erweiterungsoberfläche vergrößern',diff --git a/src/firefox/src/ui/locales/en.js b/src/firefox/src/ui/locales/en.jsindex 5769c6be6..62e5d6f21 100644--- a/src/firefox/src/ui/locales/en.js+++ b/src/firefox/src/ui/locales/en.js@@ -1,10 +1,12 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// English — canonical locale. Other locales inherit key names from this file.import apocalypseModeCopy from './apocalypse-copy.mjs';import emergencyCopy from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Extension UI zoom','sp.ui_scale.decrease': 'Zoom extension UI out','sp.ui_scale.increase': 'Zoom extension UI in',diff --git a/src/firefox/src/ui/locales/es.js b/src/firefox/src/ui/locales/es.jsindex 80b1e0c5b..777825e4c 100644--- a/src/firefox/src/ui/locales/es.js+++ b/src/firefox/src/ui/locales/es.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Spanish (es).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Zoom de la interfaz de la extensión','sp.ui_scale.decrease': 'Reducir el zoom de la interfaz','sp.ui_scale.increase': 'Aumentar el zoom de la interfaz',diff --git a/src/firefox/src/ui/locales/fa.js b/src/firefox/src/ui/locales/fa.jsindex d7022c6a5..c2f05f43c 100644--- a/src/firefox/src/ui/locales/fa.js+++ b/src/firefox/src/ui/locales/fa.js@@ -1,10 +1,12 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Persian — translated from the canonical English locale.import { getApocalypseModeCopy } from './apocalypse-copy.mjs';import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'بزرگنمایی رابط کاربری افزونه','sp.ui_scale.decrease': 'کاهش بزرگنمایی رابط افزونه','sp.ui_scale.increase': 'افزایش بزرگنمایی رابط افزونه',diff --git a/src/firefox/src/ui/locales/fr.js b/src/firefox/src/ui/locales/fr.jsindex b8a0df62d..ae3b9f7bd 100644--- a/src/firefox/src/ui/locales/fr.js+++ b/src/firefox/src/ui/locales/fr.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// French (fr).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Zoom de l’interface de l’extension','sp.ui_scale.decrease': 'Réduire le zoom de l’interface','sp.ui_scale.increase': 'Augmenter le zoom de l’interface',diff --git a/src/firefox/src/ui/locales/he.js b/src/firefox/src/ui/locales/he.jsindex 98434aef9..4d8358a36 100644--- a/src/firefox/src/ui/locales/he.js+++ b/src/firefox/src/ui/locales/he.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Hebrew (he).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'הגדלת ממשק התוסף','sp.ui_scale.decrease': 'הקטנת תצוגת ממשק התוסף','sp.ui_scale.increase': 'הגדלת תצוגת ממשק התוסף',diff --git a/src/firefox/src/ui/locales/hi.js b/src/firefox/src/ui/locales/hi.jsindex 91e12d9fe..bafcaf317 100644--- a/src/firefox/src/ui/locales/hi.js+++ b/src/firefox/src/ui/locales/hi.js@@ -1,10 +1,12 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Hindi — translated from the canonical English locale.import { getApocalypseModeCopy } from './apocalypse-copy.mjs';import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'एक्सटेंशन UI ज़ूम','sp.ui_scale.decrease': 'एक्सटेंशन UI को छोटा करें','sp.ui_scale.increase': 'एक्सटेंशन UI को बड़ा करें',diff --git a/src/firefox/src/ui/locales/id.js b/src/firefox/src/ui/locales/id.jsindex e27bad9e5..1f4249354 100644--- a/src/firefox/src/ui/locales/id.js+++ b/src/firefox/src/ui/locales/id.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Indonesian (id).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Zoom UI ekstensi','sp.ui_scale.decrease': 'Perkecil UI ekstensi','sp.ui_scale.increase': 'Perbesar UI ekstensi',diff --git a/src/firefox/src/ui/locales/ja.js b/src/firefox/src/ui/locales/ja.jsindex 18dde6bda..bc3d0fe10 100644--- a/src/firefox/src/ui/locales/ja.js+++ b/src/firefox/src/ui/locales/ja.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Japanese (ja).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': '拡張機能 UI のズーム','sp.ui_scale.decrease': '拡張機能 UI を縮小','sp.ui_scale.increase': '拡張機能 UI を拡大',diff --git a/src/firefox/src/ui/locales/ko.js b/src/firefox/src/ui/locales/ko.jsindex 3a1ad07b2..c17bcaa68 100644--- a/src/firefox/src/ui/locales/ko.js+++ b/src/firefox/src/ui/locales/ko.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Korean (ko).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': '확장 프로그램 UI 확대/축소','sp.ui_scale.decrease': '확장 프로그램 UI 축소','sp.ui_scale.increase': '확장 프로그램 UI 확대',diff --git a/src/firefox/src/ui/locales/ms.js b/src/firefox/src/ui/locales/ms.jsindex 951012b13..5062754b3 100644--- a/src/firefox/src/ui/locales/ms.js+++ b/src/firefox/src/ui/locales/ms.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Malay (ms).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Zum UI sambungan','sp.ui_scale.decrease': 'Kecilkan UI sambungan','sp.ui_scale.increase': 'Besarkan UI sambungan',diff --git a/src/firefox/src/ui/locales/nl.js b/src/firefox/src/ui/locales/nl.jsindex 506d1e93f..17cc09884 100644--- a/src/firefox/src/ui/locales/nl.js+++ b/src/firefox/src/ui/locales/nl.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Dutch (nl).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Zoom van extensie-interface','sp.ui_scale.decrease': 'Extensie-interface uitzoomen','sp.ui_scale.increase': 'Extensie-interface inzoomen',diff --git a/src/firefox/src/ui/locales/pl.js b/src/firefox/src/ui/locales/pl.jsindex 472d4d8f2..4a74e171d 100644--- a/src/firefox/src/ui/locales/pl.js+++ b/src/firefox/src/ui/locales/pl.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Polski — translated from en.js. Keys mirror the English canonical file.import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Powiększenie interfejsu rozszerzenia','sp.ui_scale.decrease': 'Pomniejsz interfejs rozszerzenia','sp.ui_scale.increase': 'Powiększ interfejs rozszerzenia',diff --git a/src/firefox/src/ui/locales/pt.js b/src/firefox/src/ui/locales/pt.jsindex 5a31427f6..a239fbdd0 100644--- a/src/firefox/src/ui/locales/pt.js+++ b/src/firefox/src/ui/locales/pt.js@@ -1,10 +1,12 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Portuguese — translated from the canonical English locale.import { getApocalypseModeCopy } from './apocalypse-copy.mjs';import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Zoom da interface da extensão','sp.ui_scale.decrease': 'Reduzir o zoom da interface','sp.ui_scale.increase': 'Aumentar o zoom da interface',diff --git a/src/firefox/src/ui/locales/ru.js b/src/firefox/src/ui/locales/ru.jsindex 4a5a6d8e0..f14672599 100644--- a/src/firefox/src/ui/locales/ru.js+++ b/src/firefox/src/ui/locales/ru.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Russian (ru).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Масштаб интерфейса расширения','sp.ui_scale.decrease': 'Уменьшить интерфейс расширения','sp.ui_scale.increase': 'Увеличить интерфейс расширения',diff --git a/src/firefox/src/ui/locales/th.js b/src/firefox/src/ui/locales/th.jsindex 4309916e5..f747b25f1 100644--- a/src/firefox/src/ui/locales/th.js+++ b/src/firefox/src/ui/locales/th.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Thai (th).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'ซูม UI ของส่วนขยาย','sp.ui_scale.decrease': 'ย่อ UI ของส่วนขยาย','sp.ui_scale.increase': 'ขยาย UI ของส่วนขยาย',diff --git a/src/firefox/src/ui/locales/tl.js b/src/firefox/src/ui/locales/tl.jsindex 4f38631d8..d120bd0f8 100644--- a/src/firefox/src/ui/locales/tl.js+++ b/src/firefox/src/ui/locales/tl.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Filipino / Tagalog (tl).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Pag-zoom ng UI ng extension','sp.ui_scale.decrease': 'Bawasan ang zoom ng UI ng extension','sp.ui_scale.increase': 'Dagdagan ang zoom ng UI ng extension',diff --git a/src/firefox/src/ui/locales/tr.js b/src/firefox/src/ui/locales/tr.jsindex 83b6922fd..fc32d5029 100644--- a/src/firefox/src/ui/locales/tr.js+++ b/src/firefox/src/ui/locales/tr.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Turkish (tr).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Uzantı arayüzü yakınlaştırması','sp.ui_scale.decrease': 'Uzantı arayüzünü uzaklaştır','sp.ui_scale.increase': 'Uzantı arayüzünü yakınlaştır',diff --git a/src/firefox/src/ui/locales/uk.js b/src/firefox/src/ui/locales/uk.jsindex 4b5492f9f..130f03bc4 100644--- a/src/firefox/src/ui/locales/uk.js+++ b/src/firefox/src/ui/locales/uk.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Ukrainian (uk).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Масштаб інтерфейсу розширення','sp.ui_scale.decrease': 'Зменшити інтерфейс розширення','sp.ui_scale.increase': 'Збільшити інтерфейс розширення',diff --git a/src/firefox/src/ui/locales/vi.js b/src/firefox/src/ui/locales/vi.jsindex be0c47b3f..f296405d0 100644--- a/src/firefox/src/ui/locales/vi.js+++ b/src/firefox/src/ui/locales/vi.js@@ -1,10 +1,12 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Vietnamese — translated from the canonical English locale.import { getApocalypseModeCopy } from './apocalypse-copy.mjs';import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': 'Thu phóng giao diện tiện ích','sp.ui_scale.decrease': 'Thu nhỏ giao diện tiện ích','sp.ui_scale.increase': 'Phóng to giao diện tiện ích',diff --git a/src/firefox/src/ui/locales/zh.js b/src/firefox/src/ui/locales/zh.jsindex 16ed61f32..cddf7eb1c 100644--- a/src/firefox/src/ui/locales/zh.js+++ b/src/firefox/src/ui/locales/zh.js@@ -1,4 +1,5 @@import bidiCopy from './bidi-copy.mjs';+import cloudBridgeCopy from './cloud-bridge-copy.mjs';// Simplified Chinese (zh).import chromeWebStoreLocale from './chrome-web-store.mjs';@@ -7,6 +8,7 @@ import { getEmergencyBoxCopy } from './emergency-copy.mjs';export default {...bidiCopy,+ ...cloudBridgeCopy,'sp.ui_scale.label': '插件界面缩放','sp.ui_scale.decrease': '缩小插件界面','sp.ui_scale.increase': '放大插件界面',diff --git a/src/firefox/src/ui/settings-cloud-bridge.js b/src/firefox/src/ui/settings-cloud-bridge.jsnew file mode 100644index 000000000..ef96246ef--- /dev/null+++ b/src/firefox/src/ui/settings-cloud-bridge.js@@ -0,0 +1,117 @@+// Settings → Cloud Bridge tab: URL, token, browser name, connection test.+// Uses the same storage keys as the Display → MCP block; identity keys are+// read by cloud-runs.js when the bridge starts.+import { t } from './i18n.js';++const KEYS = {+ enabled: 'webbrainCloudBridgeEnabled',+ url: 'webbrainCloudBridgeUrl',+ token: 'webbrainCloudBridgeToken',+ browserId: 'webbrainCloudBridgeBrowserId',+ installationId: 'webbrainCloudBridgeInstallationId',+};+const DEFAULT_URL = 'ws://127.0.0.1:17374/extension';+const $ = (id) => document.getElementById(id);+const enabled = $('cb-enabled');+const urlInput = $('cb-url');+const tokenInput = $('cb-token');+const nameInput = $('cb-browser-id');+const installationEl = $('cb-installation-id');+const statusEl = $('cb-status');+const statusText = $('cb-status-text');+const testBtn = $('cb-test');++async function send(action, data = {}) {+ const response = await browser.runtime.sendMessage({ target: 'background', action, ...data });+ if (response?.error) throw new Error(response.error);+ return response;+}++function setStatus(state, message) {+ statusEl.dataset.state = state;+ statusText.textContent = message;+}++function normalizeUrl(value) {+ const url = new URL(String(value || DEFAULT_URL));+ if (url.protocol !== 'ws:' || !['127.0.0.1', 'localhost', '::1', '[::1]'].includes(url.hostname.toLowerCase())) {+ throw new Error(t('st.cb.invalid_url'));+ }+ return url.href;+}++function render(status = {}) {+ if (!enabled.checked || status.enabled === false) return setStatus('disabled', t('st.cb.status_disabled'));+ if (status.installationId) installationEl.textContent = status.installationId;+ if (status.approval === 'rejected') return setStatus('error', t('st.cb.rejected', { reason: status.lastError || '' }));+ if (status.connected) {+ if (status.approval === 'approved') return setStatus('connected', t('st.cb.approved'));+ if (status.approval === 'pending') return setStatus('waiting', t('st.cb.pending'));+ return setStatus('connected', t('st.cb.connected'));+ }+ if (status.lastError && status.lastError !== 'WebSocket error') return setStatus('error', t('st.cb.status_error', { error: status.lastError }));+ setStatus('waiting', t('st.cb.unreachable', { url: status.url || urlInput.value || DEFAULT_URL }));+}++async function load() {+ const stored = await browser.storage.local.get(Object.values(KEYS));+ enabled.checked = !!stored[KEYS.enabled];+ urlInput.value = stored[KEYS.url] || DEFAULT_URL;+ tokenInput.value = stored[KEYS.token] || '';+ nameInput.value = stored[KEYS.browserId] || '';+ installationEl.textContent = stored[KEYS.installationId] || '—';+ if (enabled.checked) refresh();+ else render({ enabled: false });+}++async function refresh() {+ if (!enabled.checked || document.hidden) return;+ try { render(await send('cloud_bridge_status')); } catch (e) { setStatus('error', e.message); }+}++async function save() {+ const url = normalizeUrl(urlInput.value);+ urlInput.value = url;+ const patch = { [KEYS.url]: url, [KEYS.enabled]: enabled.checked, [KEYS.token]: tokenInput.value.trim() };+ const name = nameInput.value.trim();+ await browser.storage.local.set(patch);+ if (name) await browser.storage.local.set({ [KEYS.browserId]: name });+ else await browser.storage.local.remove(KEYS.browserId);+ return url;+}++async function testConnection() {+ testBtn.disabled = true;+ setStatus('waiting', t('st.cb.testing'));+ try {+ enabled.checked = true; // testing implies connecting+ const url = await save();+ let status = await send('cloud_bridge_start', { url });+ for (let i = 0; i < 16; i++) {+ await new Promise((r) => setTimeout(r, 500));+ status = await send('cloud_bridge_status');+ if (status.approval === 'rejected' || status.approval === 'approved' || (status.connected && status.approval === 'not_required')) break;+ }+ render(status);+ const stored = await browser.storage.local.get(KEYS.installationId);+ installationEl.textContent = stored[KEYS.installationId] || '—';+ } catch (e) {+ setStatus('error', e.message);+ } finally {+ testBtn.disabled = false;+ }+}++enabled.addEventListener('change', async () => {+ try {+ await save();+ if (enabled.checked) render(await send('cloud_bridge_start', { url: urlInput.value }));+ else { await send('cloud_bridge_stop').catch(() => null); render({ enabled: false }); }+ } catch (e) { setStatus('error', e.message); }+});+testBtn.addEventListener('click', testConnection);+setInterval(refresh, 2000);+browser.storage.onChanged.addListener((changes, area) => {+ if (area === 'local' && Object.values(KEYS).some((k) => changes[k]) && !document.activeElement?.closest('#cb-card')) load();+});+load();diff --git a/src/firefox/src/ui/settings.html b/src/firefox/src/ui/settings.htmlindex 5dc4ed834..7dbef702b 100644--- a/src/firefox/src/ui/settings.html+++ b/src/firefox/src/ui/settings.html@@ -912,6 +912,57 @@font-size: 11px;cursor: pointer;}+ .cloud-bridge-url-field {+ display: block;+ width: 100%;+ }+ .cloud-bridge-url-label {+ display: block;+ margin-bottom: 5px;+ color: var(--text2);+ font-size: 10px;+ font-weight: 700;+ letter-spacing: 0.55px;+ text-transform: uppercase;+ }+ .cloud-bridge-url-field .setting-input {+ width: 100%;+ max-width: none;+ font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;+ font-size: 11px;+ }+ .cloud-bridge-url-field .setting-input[aria-invalid="true"] {+ border-color: var(--error);+ box-shadow: 0 0 0 2px rgba(244,67,54,0.16);+ }+ .cloud-bridge-status {+ display: flex;+ align-items: center;+ gap: 7px;+ min-height: 16px;+ color: var(--text2);+ font-size: 11px;+ line-height: 1.35;+ }+ .cloud-bridge-status-dot {+ width: 7px;+ height: 7px;+ flex: 0 0 7px;+ border-radius: 50%;+ background: currentColor;+ }+ .cloud-bridge-status[data-state="connected"] { color: var(--success); }+ .cloud-bridge-status[data-state="waiting"] { color: var(--accent); }+ .cloud-bridge-status[data-state="error"] { color: var(--error); }+ .cloud-bridge-status[data-state="waiting"] .cloud-bridge-status-dot {+ animation: cloud-bridge-pulse 1.4s ease-in-out infinite;+ }+ @keyframes cloud-bridge-pulse {+ 50% { opacity: 0.35; transform: scale(0.78); }+ }+ @media (prefers-reduced-motion: reduce) {+ .cloud-bridge-status[data-state="waiting"] .cloud-bridge-status-dot { animation: none; }+ }.skill-source {max-width: 340px;overflow: hidden;@@ -1269,6 +1320,7 @@<button class="tab-btn" type="button" role="tab" data-tab="memory" data-i18n="st.tab.memory"></button><button class="tab-btn" type="button" role="tab" data-tab="skills" data-i18n="st.tab.skills"></button><button class="tab-btn" type="button" role="tab" data-tab="permissions" data-i18n="st.tab.permissions"></button>+ <button class="tab-btn" type="button" role="tab" data-tab="cloudbridge" data-i18n="st.tab.cloudbridge"></button></nav><section class="tab-panel" data-panel="display" role="tabpanel">@@ -2281,12 +2333,50 @@</div></section>+ <section class="tab-panel" data-panel="cloudbridge" role="tabpanel">+ <div class="provider-card" id="cb-card">+ <div class="setting-row">+ <div class="setting-info">+ <div class="setting-label" id="cb-enabled-label" data-i18n="st.cb.enabled"></div>+ <div class="setting-desc" data-i18n="st.cb.desc"></div>+ </div>+ <label class="toggle">+ <input type="checkbox" id="cb-enabled" aria-labelledby="cb-enabled-label">+ <span class="toggle-slider"></span>+ </label>+ </div>+ <label class="cloud-bridge-url-field" for="cb-url">+ <span class="cloud-bridge-url-label" data-i18n="st.cb.url"></span>+ <input class="setting-input" type="text" id="cb-url" inputmode="url" autocomplete="off" spellcheck="false" placeholder="ws://127.0.0.1:17374/extension">+ </label>+ <label class="cloud-bridge-url-field" for="cb-token" style="margin-top:12px;">+ <span class="cloud-bridge-url-label" data-i18n="st.cb.token"></span>+ <input class="setting-input" type="password" id="cb-token" autocomplete="off" spellcheck="false">+ </label>+ <div class="setting-desc" style="margin-top:4px;" data-i18n="st.cb.token_hint"></div>+ <label class="cloud-bridge-url-field" for="cb-browser-id" style="margin-top:12px;">+ <span class="cloud-bridge-url-label" data-i18n="st.cb.browser_name"></span>+ <input class="setting-input" type="text" id="cb-browser-id" autocomplete="off" spellcheck="false" maxlength="64">+ </label>+ <div class="setting-desc" style="margin-top:12px;"><span data-i18n="st.cb.installation_id"></span> <code id="cb-installation-id">—</code></div>+ <div class="btn-row" style="margin-top:14px;">+ <button class="btn-secondary" id="cb-test" data-i18n="st.cb.test"></button>+ </div>+ <div class="cloud-bridge-status" id="cb-status" data-state="disabled" role="status" aria-live="polite" style="margin-top:12px;">+ <span class="cloud-bridge-status-dot" aria-hidden="true"></span>+ <span id="cb-status-text" data-i18n="st.cb.status_disabled"></span>+ </div>+ <div class="info-box" style="margin-top:16px;" data-i18n-html="st.cb.howto_html"></div>+ </div>+ </section>+<!-- Tab switcher must be an external script — Manifest V3's defaultCSP (`script-src 'self'`) blocks inline <script> execution. --><script src="settings-tabs.js"></script><script type="module" src="apocalypse-comm.js"></script><script type="module" src="download-tracker.js"></script><script src="settings.js" type="module"></script>+ <script src="settings-cloud-bridge.js" type="module"></script><script src="safesocial-settings.js" type="module"></script></body></html>diff --git a/test/cloud-bridge-approval.mjs b/test/cloud-bridge-approval.mjsnew file mode 100644index 000000000..d1a8394fb--- /dev/null+++ b/test/cloud-bridge-approval.mjs@@ -0,0 +1,376 @@+import test from 'node:test';+import assert from 'node:assert/strict';+import fs from 'node:fs';+import path from 'node:path';+import vm from 'node:vm';+import { fileURLToPath } from 'node:url';+import { startApprovalServer } from '../examples/cloud-bridge-approval-server.mjs';++const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');+const source = fs.readFileSync(path.join(ROOT, 'src/chrome/src/offscreen/cloud-bridge.js'), 'utf8');+const IDENTITY = { token: 'secret-token', browserId: 'browser-1', installationId: 'install-1', extensionVersion: '1.2.3' };+const tick = (ms = 0) => new Promise(resolve => setTimeout(resolve, ms));++function harness({ WebSocketImpl, sendMessage = async () => ({ runId: 'r1', status: 'running' }) } = {}) {+ const sockets = [];+ const timers = [];+ const runtimeCalls = [];+ let listener;+ class FakeWebSocket {+ static CONNECTING = 0; static OPEN = 1; static CLOSING = 2; static CLOSED = 3;+ constructor(url) { this.url = url; this.readyState = 0; this.listeners = new Map(); this.sent = []; sockets.push(this); }+ addEventListener(type, cb) { this.listeners.set(type, cb); }+ send(v) { this.sent.push(JSON.parse(v)); }+ close() { this.readyState = 2; this.emit('close'); }+ emit(type, value = {}) {+ if (type === 'open') this.readyState = 1;+ if (type === 'close') this.readyState = 3;+ this.listeners.get(type)?.(value);+ }+ receive(obj) { return this.emit('message', { data: JSON.stringify(obj) }); }+ }+ vm.runInNewContext(source, {+ URL,+ WebSocket: WebSocketImpl || FakeWebSocket,+ navigator: { userAgent: 'Mozilla/5.0 Chrome/126.0.1 Safari/537.36', platform: 'Linux x86_64' },+ chrome: { runtime: {+ onMessage: { addListener: cb => { listener = cb; } },+ sendMessage: async m => { runtimeCalls.push(m); return sendMessage(m); },+ } },+ setTimeout: (callback, delay) => { timers.push({ callback, delay, cleared: false }); return timers.length; },+ clearTimeout: (id) => { if (timers[id - 1]) timers[id - 1].cleared = true; },+ });+ const start = (extra = IDENTITY, url = 'ws://127.0.0.1:17374/extension') => {+ let out; listener({ type: 'cloud-bridge-start', url, ...extra }, null, v => { out = v; }); return out;+ };+ const status = () => { let out; listener({ type: 'cloud-bridge-status' }, null, v => { out = v; }); return out; };+ return { sockets, timers, runtimeCalls, start, status };+}++const cmd = { id: 'c1', action: 'cloud_status', payload: { runId: 'r1' } };++test('hello carries identity, token, browser, version and platform', () => {+ const h = harness();+ h.start();+ h.sockets[0].emit('open');+ const hello = h.sockets[0].sent[0];+ assert.equal(hello.type, 'hello');+ assert.deepEqual(hello.auth, { type: 'bearer', token: 'secret-token' });+ assert.equal(hello.browserId, 'browser-1');+ assert.equal(hello.installationId, 'install-1');+ assert.deepEqual({ ...hello.browser }, { name: 'Chrome', version: '126.0.1' });+ assert.equal(hello.extensionVersion, '1.2.3');+ assert.equal(hello.platform, 'Linux x86_64');+ assert.deepEqual([...hello.capabilities], ['saved_workflows_v1', 'run_modes_v1', 'scheduled_jobs_v1']);+ assert.equal(JSON.stringify(hello.status).includes('secret-token'), false, 'status must not leak the token');+ assert.equal(JSON.stringify(h.status()).includes('secret-token'), false);+});++test('pending connection refuses cloud commands without calling the background', async () => {+ const h = harness();+ h.start();+ const s = h.sockets[0];+ s.emit('open');+ s.receive({ type: 'connection_pending', browserId: 'browser-1' });+ assert.equal(h.status().approval, 'pending');+ s.receive(cmd);+ await tick();+ const reply = s.sent.find(m => m.id === 'c1');+ assert.equal(reply.ok, false);+ assert.equal(reply.code, 'connection_not_approved');+ assert.equal(h.runtimeCalls.length, 0);+});++test('commands are refused before any approval message too', async () => {+ const h = harness();+ h.start();+ h.sockets[0].emit('open');+ h.sockets[0].receive(cmd);+ await tick();+ assert.equal(h.sockets[0].sent.find(m => m.id === 'c1').ok, false);+ assert.equal(h.runtimeCalls.length, 0);+});++test('approved connection runs commands with the unchanged payload format', async () => {+ const h = harness();+ h.start();+ const s = h.sockets[0];+ s.emit('open');+ s.receive({ type: 'connection_pending' });+ s.receive({ type: 'connection_approved', browserId: 'browser-1' });+ assert.equal(h.status().approval, 'approved');+ s.receive(cmd);+ await tick();+ assert.deepEqual({ ...h.runtimeCalls[0] }, { runId: 'r1', target: 'background', action: 'cloud_status' });+ const reply = s.sent.find(m => m.id === 'c1');+ assert.equal(reply.ok, true);+ assert.equal(reply.result.status, 'running');+});++test('approval for another browserId is ignored', async () => {+ const h = harness();+ h.start();+ h.sockets[0].emit('open');+ h.sockets[0].receive({ type: 'connection_approved', browserId: 'someone-else' });+ assert.equal(h.status().approval, 'pending');+});++test('rejected connection closes, blocks commands and does not reconnect', async () => {+ const h = harness();+ h.start();+ const s = h.sockets[0];+ s.emit('open');+ s.receive({ type: 'connection_rejected', reason: 'nope' });+ assert.equal(h.status().approval, 'rejected');+ assert.equal(h.status().lastError, 'nope');+ assert.equal(s.readyState, 3);+ assert.equal(h.timers.length, 0, 'no reconnect after rejection');+ s.receive(cmd);+ await tick();+ assert.equal(h.runtimeCalls.length, 0);+});++test('reconnect requires a fresh approval', async () => {+ const h = harness();+ h.start();+ const first = h.sockets[0];+ first.emit('open');+ first.receive({ type: 'connection_approved' });+ first.close();+ assert.equal(h.status().approval, 'pending');+ h.timers[0].callback();+ const second = h.sockets[1];+ second.emit('open');+ assert.equal(second.sent[0].type, 'hello');+ assert.equal(second.sent[0].auth.token, 'secret-token');+ second.receive(cmd);+ await tick();+ assert.equal(second.sent.find(m => m.id === 'c1').code, 'connection_not_approved');+ assert.equal(h.runtimeCalls.length, 0);+ second.receive({ type: 'connection_approved' });+ second.receive(cmd);+ await tick();+ assert.equal(h.runtimeCalls.length, 1);+});++test('rejection cancels a pending backoff timer so the browser cannot reconnect', async () => {+ const h = harness();+ h.start();+ h.sockets[0].emit('open');+ h.sockets[0].close(); // schedules a reconnect timer+ assert.equal(h.timers.length, 1);+ h.start(); // restart during backoff opens a new socket right away+ h.sockets[1].emit('open');+ h.sockets[1].receive({ type: 'connection_rejected', reason: 'nope' });+ assert.equal(h.timers[0].cleared, true, 'pending timer must be cancelled');+});++test('without a token the legacy behaviour is unchanged', async () => {+ const h = harness();+ h.start({});+ const s = h.sockets[0];+ s.emit('open');+ assert.equal(s.sent[0].auth, undefined);+ assert.equal(h.status().approval, 'not_required');+ s.receive(cmd);+ await tick();+ assert.equal(h.runtimeCalls.length, 1);+});++test('end to end against the example server', async () => {+ const received = [];+ const server = await startApprovalServer({ port: 0, token: 'secret-token', onMessage: m => received.push(m) });+ const h = harness({ WebSocketImpl: WebSocket });+ try {+ h.start(IDENTITY, `ws://127.0.0.1:${server.port}/extension`);+ for (let i = 0; i < 50 && ![...server.sessions].some(s => s.state === 'pending'); i++) await tick(20);+ const session = [...server.sessions][0];+ assert.equal(session.state, 'pending');+ assert.equal(session.hello.browserId, 'browser-1');+ session.send(cmd);+ for (let i = 0; i < 50 && !received.some(m => m.id === 'c1'); i++) await tick(20);+ assert.equal(received.find(m => m.id === 'c1').code, 'connection_not_approved');+ session.approve();+ session.send({ ...cmd, id: 'c2' });+ for (let i = 0; i < 50 && !received.some(m => m.id === 'c2'); i++) await tick(20);+ assert.equal(received.find(m => m.id === 'c2').ok, true);+ } finally {+ await server.close();+ }+});++// ---- Firefox: same protocol, socket lives in the background page ----+const { createCloudBridge } = await import('../src/firefox/src/cloud-bridge.js');+const { createCloudRunController: createFxController } = await import('../src/firefox/src/cloud-runs.js');++function fxHarness({ WebSocketImpl, dispatch } = {}) {+ const sockets = [];+ const calls = [];+ class FakeWebSocket {+ static CONNECTING = 0; static OPEN = 1; static CLOSING = 2; static CLOSED = 3;+ constructor(url) { this.url = url; this.readyState = 0; this.listeners = new Map(); this.sent = []; sockets.push(this); }+ addEventListener(type, cb) { this.listeners.set(type, cb); }+ send(v) { this.sent.push(JSON.parse(v)); }+ close() { this.readyState = 3; this.listeners.get('close')?.({}); }+ emit(type, value = {}) { if (type === 'open') this.readyState = 1; this.listeners.get(type)?.(value); }+ receive(obj) { return this.emit('message', { data: JSON.stringify(obj) }); }+ }+ const bridge = createCloudBridge({+ WebSocketImpl: WebSocketImpl || FakeWebSocket,+ nav: { userAgent: 'Mozilla/5.0 (X11; Linux x86_64; rv:140.0) Gecko/20100101 Firefox/140.0', platform: 'Linux x86_64' },+ dispatch: dispatch || (async (m) => { calls.push(m); return { runId: 'r1', status: 'running' }; }),+ });+ return { bridge, sockets, calls };+}++test('firefox: hello, pending refusal, approval, rejection', async () => {+ const h = fxHarness();+ h.bridge.start({ url: 'ws://127.0.0.1:17374/extension', ...IDENTITY });+ const s = h.sockets[0];+ s.emit('open');+ const hello = s.sent[0];+ assert.deepEqual({ ...hello.browser }, { name: 'Firefox', version: '140.0' });+ assert.equal(hello.auth.token, 'secret-token');+ assert.equal(hello.browserId, 'browser-1');+ assert.equal(hello.platform, 'Linux x86_64');+ assert.equal(JSON.stringify(h.bridge.status()).includes('secret-token'), false);++ s.receive({ type: 'connection_pending' });+ s.receive(cmd);+ await tick();+ assert.equal(s.sent.find(m => m.id === 'c1').code, 'connection_not_approved');+ assert.equal(h.calls.length, 0);++ s.receive({ type: 'connection_approved', browserId: 'browser-1' });+ s.receive({ ...cmd, id: 'c2' });+ await tick();+ assert.equal(s.sent.find(m => m.id === 'c2').ok, true);+ assert.deepEqual({ ...h.calls[0] }, { runId: 'r1', target: 'background', action: 'cloud_status' });++ s.receive({ id: 'bad', action: 'get_providers', payload: {} });+ await tick();+ assert.match(s.sent.find(m => m.id === 'bad').error, /unsupported/i);++ s.receive({ type: 'connection_rejected', reason: 'no' });+ assert.equal(h.bridge.status().approval, 'rejected');+ assert.equal(s.readyState, 3);+ h.bridge.stop();+});++test('firefox: reconnect requires a fresh approval', async () => {+ const h = fxHarness();+ h.bridge.start({ url: 'ws://127.0.0.1:17374/extension', ...IDENTITY });+ const first = h.sockets[0];+ first.emit('open');+ first.receive({ type: 'connection_approved' });+ first.close();+ assert.equal(h.bridge.status().approval, 'pending');+ await tick(700); // first backoff is 500 ms+ const second = h.sockets[1];+ assert.ok(second, 'reconnected');+ second.emit('open');+ second.receive(cmd);+ await tick();+ assert.equal(second.sent.find(m => m.id === 'c1').code, 'connection_not_approved');+ assert.equal(h.calls.length, 0);+ h.bridge.stop();+});++test('firefox: rejection cancels a pending backoff timer', async () => {+ const h = fxHarness();+ h.bridge.start({ url: 'ws://127.0.0.1:17374/extension', ...IDENTITY });+ h.sockets[0].emit('open');+ h.sockets[0].close(); // schedules a 500 ms reconnect+ h.bridge.start({ url: 'ws://127.0.0.1:17374/extension', ...IDENTITY });+ h.sockets[1].emit('open');+ h.sockets[1].receive({ type: 'connection_rejected' });+ await tick(700);+ assert.equal(h.sockets.length, 2, 'no third socket after rejection');+ h.bridge.stop();+});++test('firefox: without a token behaviour is legacy', async () => {+ const h = fxHarness();+ h.bridge.start({ url: 'ws://127.0.0.1:17374/extension' });+ h.sockets[0].emit('open');+ assert.equal(h.sockets[0].sent[0].auth, undefined);+ h.sockets[0].receive(cmd);+ await tick();+ assert.equal(h.calls.length, 1);+ assert.throws(() => { throw new Error(h.bridge.start({ url: 'wss://evil.example/x' }).error); }, /localhost/);+ h.bridge.stop();+});++test('firefox: controller persists identity and feeds it to the bridge', async () => {+ const store = {};+ const started = [];+ const api = {+ storage: { local: {+ get: async (keys) => Object.fromEntries([].concat(keys).map(k => [k, store[k]]).filter(([, v]) => v !== undefined)),+ set: async (obj) => { Object.assign(store, obj); },+ } },+ runtime: { getManifest: () => ({ version: '9.9.9' }) },+ };+ const controller = createFxController({+ chromeApi: api,+ agent: {},+ bridge: { start: (m) => { started.push(m); return { enabled: true }; }, stop: () => ({ enabled: false }), status: () => ({}) },+ });+ store.webbrainCloudBridgeEnabled = true;+ store.webbrainCloudBridgeToken = 'tok';+ await controller.syncBridge();+ assert.equal(started[0].token, 'tok');+ assert.equal(started[0].extensionVersion, '9.9.9');+ assert.ok(store.webbrainCloudBridgeInstallationId, 'installation id generated once');+ assert.equal(started[0].browserId, store.webbrainCloudBridgeInstallationId, 'browserId defaults to the installation id');+ await controller.syncBridge();+ assert.equal(started[1].installationId, started[0].installationId, 'installation id is stable');+});++test('firefox: end to end against the example server', async () => {+ const received = [];+ const server = await startApprovalServer({ port: 0, token: 'secret-token', onMessage: m => received.push(m) });+ const h = fxHarness({ WebSocketImpl: WebSocket });+ try {+ h.bridge.start({ url: `ws://127.0.0.1:${server.port}/extension`, ...IDENTITY });+ for (let i = 0; i < 50 && ![...server.sessions].some(s => s.state === 'pending'); i++) await tick(20);+ const session = [...server.sessions][0];+ assert.equal(session.state, 'pending');+ session.send(cmd);+ for (let i = 0; i < 50 && !received.some(m => m.id === 'c1'); i++) await tick(20);+ assert.equal(received.find(m => m.id === 'c1').code, 'connection_not_approved');+ session.approve();+ session.send({ ...cmd, id: 'c2' });+ for (let i = 0; i < 50 && !received.some(m => m.id === 'c2'); i++) await tick(20);+ assert.equal(received.find(m => m.id === 'c2').ok, true);+ } finally {+ h.bridge.stop();+ await server.close();+ }+});++for (const [label, createController] of [['chrome', null], ['firefox', createFxController]]) {+ test(`${label}: concurrent bridge starts share one installation id`, async () => {+ const { createCloudRunController: make } = label === 'chrome'+ ? await import('../src/chrome/src/cloud-runs.js')+ : { createCloudRunController: createController };+ const store = {};+ const started = [];+ const api = {+ storage: { local: {+ // yield so two callers can interleave between read and write+ get: async (keys) => { await tick(5); return Object.fromEntries([].concat(keys).map(k => [k, store[k]]).filter(([, v]) => v !== undefined)); },+ set: async (obj) => { await tick(5); Object.assign(store, obj); },+ } },+ runtime: { getManifest: () => ({ version: '1.0.0' }) },+ };+ const bridge = { start: (m) => { started.push(m); return {}; }, stop: () => ({}), status: () => ({}) };+ const controller = make({ chromeApi: api, agent: {}, ensureOffscreen: async () => {}, bridge });+ store.webbrainCloudBridgeEnabled = true;+ if (label === 'chrome') api.runtime.sendMessage = async (m) => { started.push(m); return {}; };+ await Promise.all([controller.syncBridge(), controller.startBridge(), controller.syncBridge()]);+ const ids = new Set(started.map(m => m.installationId));+ assert.equal(ids.size, 1, 'all concurrent starts must use the same installation id');+ assert.equal([...ids][0], store.webbrainCloudBridgeInstallationId, 'and it matches the persisted one');+ });+}diff --git a/test/run.js b/test/run.jsindex 76e8dd734..98dd6fdae 100644--- a/test/run.js+++ b/test/run.js@@ -26047,7 +26047,24 @@ test('trace lineage: _startTraceRun and replay plumb parent ids in both builds',assert.match(chromeCloudRuns, /const parentTraceRunId = parentRun\?\.traceRunId \|\| null;/, 'cloud-runs does not use the completed parent trace');assert.match(chromeCloudRuns, /workflowTrace\.getRun\(parentTraceRunId\)/, 'cloud-runs does not resolve the parent trace session');assert.match(chromeCloudRuns, /parentRunId: parentTraceRunId,[\s\S]*?parentSessionId: parentTraceSessionId,/, 'cloud-runs does not thread resolved parent lineage');- assert.ok(!fs.existsSync(path.join(ROOT, 'src/firefox/src/cloud-runs.js')), 'Firefox has no cloud-runs module — lineage threading is Chrome-only by platform boundary');+ const firefoxCloudRuns = fs.readFileSync(path.join(ROOT, 'src/firefox/src/cloud-runs.js'), 'utf8');+ assert.match(firefoxCloudRuns, /const parentTraceRunId = parentRun\?\.traceRunId \|\| null;/, 'Firefox cloud-runs does not use the completed parent trace');+ assert.match(firefoxCloudRuns, /parentRunId: parentTraceRunId,[\s\S]*?parentSessionId: parentTraceSessionId,/, 'Firefox cloud-runs does not thread resolved parent lineage');+});++test('firefox: revoking the global API setting keeps a temporary cloud-run grant', () => {+ const agent = new AgentFx({ getActive: () => ({ model: 'test-model' }) });+ const tabId = 17855;+ agent.conversations.set(tabId, []);+ agent.setTemporaryApiMutationsAllowed(tabId, true);+ agent.apiAllowedInjected.add(tabId);+ agent.setAlwaysAllowApiMutations(true);+ agent.setAlwaysAllowApiMutations(false);+ assert.equal(agent.isApiMutationsAllowed(tabId), true);+ assert.equal(agent.conversations.get(tabId).length, 0, 'no NOT ALLOWED note while the temporary grant is active');+ assert.equal(agent.apiAllowedInjected.has(tabId), true);+ agent.setTemporaryApiMutationsAllowed(tabId, false);+ assert.equal(agent.conversations.get(tabId).length, 1, 'the note is appended once the last grant ends');});test('saved workflow replay captures its source lineage before claiming the tab', async () => {