@cereworker/browser 26.324.4 → 26.324.6

package/dist/tools.js

@@ -1,7 +1,5 @@
 import { z } from 'zod';
-import { navigateTo, getPageText, screenshot, clickElement, typeText, evaluateJs, waitForSelector, getPageUrl, closeBrowser, setMode, getMode, } from './puppeteer.js';
-import { connectCdp, disconnectCdp } from './cdp.js';
-function wrapBrowserTool(fn) {
+function wrap(fn) {
     return async (args) => {
         try {
             return await fn(args);
@@ -11,99 +9,106 @@ function wrapBrowserTool(fn) {
         }
     };
 }
-export const browserToolDefinitions = {
-    browserNavigate: {
-        description: 'Navigate the browser to a URL. Requires a running Chrome browser — prefer httpFetch for API calls.',
-        parameters: z.object({
-            url: z.string().describe('The URL to navigate to'),
-        }),
-        execute: wrapBrowserTool((args) => navigateTo(args.url)),
-    },
-    browserGetText: {
-        description: 'Get the visible text content of the current page',
-        parameters: z.object({}),
-        execute: wrapBrowserTool(async () => getPageText()),
-    },
-    browserScreenshot: {
-        description: 'Take a screenshot of the current page',
-        parameters: z.object({
-            path: z.string().optional().describe('File path to save screenshot'),
-        }),
-        execute: wrapBrowserTool(async (args) => screenshot(args.path)),
-    },
-    browserClick: {
-        description: 'Click an element on the page by CSS selector',
-        parameters: z.object({
-            selector: z.string().describe('CSS selector of the element to click'),
-        }),
-        execute: wrapBrowserTool(async (args) => clickElement(args.selector)),
-    },
-    browserType: {
-        description: 'Type text into an input element on the page',
-        parameters: z.object({
-            selector: z.string().describe('CSS selector of the input element'),
-            text: z.string().describe('Text to type'),
-        }),
-        execute: wrapBrowserTool(async (args) => typeText(args.selector, args.text)),
-    },
-    browserEval: {
-        description: 'Execute JavaScript code in the browser page context',
-        parameters: z.object({
-            code: z.string().describe('JavaScript code to evaluate'),
-        }),
-        execute: wrapBrowserTool(async (args) => evaluateJs(args.code)),
-    },
-    browserWait: {
-        description: 'Wait for a CSS selector to appear on the page',
-        parameters: z.object({
-            selector: z.string().describe('CSS selector to wait for'),
-            timeout: z.number().optional().default(5000).describe('Timeout in milliseconds'),
-        }),
-        execute: wrapBrowserTool(async (args) => waitForSelector(args.selector, args.timeout)),
-    },
-    browserGetUrl: {
-        description: 'Get the current URL of the browser page',
-        parameters: z.object({}),
-        execute: wrapBrowserTool(async () => getPageUrl()),
-    },
-    browserConnect: {
-        description: 'Connect to an existing Chrome browser via CDP (Chrome DevTools Protocol). Chrome must be running with --remote-debugging-port.',
-        parameters: z.object({
-            port: z.number().optional().default(9222).describe('Chrome remote debugging port'),
-            wsEndpoint: z.string().optional().describe('Direct WebSocket endpoint URL (overrides port)'),
-        }),
-        execute: async (args) => {
-            try {
-                setMode('connect', { port: args.port, wsEndpoint: args.wsEndpoint });
-                const s = await connectCdp({ port: args.port, wsEndpoint: args.wsEndpoint });
-                const url = s.page.url();
-                return `Connected to Chrome via CDP. Current page: ${url}`;
-            }
-            catch (err) {
-                setMode('launch');
-                return `Failed to connect: ${err instanceof Error ? err.message : String(err)}`;
-            }
+export function createBrowserTools(backend) {
+    return {
+        browserNavigate: {
+            description: 'Navigate the browser to a URL. Prefer httpFetch for API calls.',
+            parameters: z.object({
+                url: z.string().describe('The URL to navigate to'),
+            }),
+            execute: wrap((args) => backend.navigate(args.url)),
         },
-    },
-    browserDisconnect: {
-        description: 'Disconnect from Chrome without closing it (CDP mode only)',
-        parameters: z.object({}),
-        execute: async () => {
-            if (getMode() !== 'connect') {
-                return 'Not in CDP mode. Use browserClose to close a launched browser.';
-            }
-            await disconnectCdp();
-            setMode('launch');
-            return 'Disconnected from Chrome';
+        browserGetText: {
+            description: 'Get the visible text content of the current page',
+            parameters: z.object({}),
+            execute: wrap(async () => backend.getPageText()),
         },
-    },
-    browserClose: {
-        description: 'Close the browser (launch mode) or disconnect (CDP mode)',
-        parameters: z.object({}),
-        execute: async () => {
-            await closeBrowser();
-            return getMode() === 'connect' ? 'Disconnected from Chrome' : 'Browser closed';
+        browserScreenshot: {
+            description: 'Take a screenshot of the current page',
+            parameters: z.object({
+                path: z.string().optional().describe('File path to save screenshot'),
+            }),
+            execute: wrap(async (args) => backend.screenshot(args.path)),
         },
-    },
-};
+        browserClick: {
+            description: 'Click an element on the page by CSS selector',
+            parameters: z.object({
+                selector: z.string().describe('CSS selector of the element to click'),
+            }),
+            execute: wrap(async (args) => backend.click(args.selector)),
+        },
+        browserType: {
+            description: 'Type text into an input element on the page',
+            parameters: z.object({
+                selector: z.string().describe('CSS selector of the input element'),
+                text: z.string().describe('Text to type'),
+            }),
+            execute: wrap(async (args) => backend.type(args.selector, args.text)),
+        },
+        browserEval: {
+            description: 'Execute JavaScript code in the browser page context',
+            parameters: z.object({
+                code: z.string().describe('JavaScript code to evaluate'),
+            }),
+            execute: wrap(async (args) => backend.evaluate(args.code)),
+        },
+        browserWait: {
+            description: 'Wait for a CSS selector to appear on the page',
+            parameters: z.object({
+                selector: z.string().describe('CSS selector to wait for'),
+                timeout: z.number().optional().default(5000).describe('Timeout in milliseconds'),
+            }),
+            execute: wrap(async (args) => backend.waitForSelector(args.selector, args.timeout)),
+        },
+        browserGetUrl: {
+            description: 'Get the current URL of the browser page',
+            parameters: z.object({}),
+            execute: wrap(async () => backend.getPageUrl()),
+        },
+        browserListTabs: {
+            description: 'List all open browser tabs with their URLs',
+            parameters: z.object({}),
+            execute: wrap(async () => {
+                const tabs = await backend.listTabs();
+                if (tabs.length === 0)
+                    return 'No tabs open.';
+                return tabs.map((t) => `${t.active ? '→ ' : '  '}[${t.id}] ${t.url}${t.title ? ` - ${t.title}` : ''}`).join('\n');
+            }),
+        },
+        browserSwitchTab: {
+            description: 'Switch to a different browser tab by its ID',
+            parameters: z.object({
+                tabId: z.string().describe('Tab ID from browserListTabs'),
+            }),
+            execute: wrap(async (args) => backend.switchTab(args.tabId)),
+        },
+        browserNewTab: {
+            description: 'Open a new browser tab, optionally navigating to a URL',
+            parameters: z.object({
+                url: z.string().optional().describe('URL to navigate to in the new tab'),
+            }),
+            execute: wrap(async (args) => backend.newTab(args.url)),
+        },
+        browserCloseTab: {
+            description: 'Close a browser tab by ID, or close the current tab',
+            parameters: z.object({
+                tabId: z.string().optional().describe('Tab ID to close (current tab if omitted)'),
+            }),
+            execute: wrap(async (args) => backend.closeTab(args.tabId)),
+        },
+        browserConnect: {
+            description: 'Connect to the browser backend. In extension mode, waits for the Chrome extension.',
+            parameters: z.object({}),
+            execute: wrap(async () => backend.connect()),
+        },
+        browserDisconnect: {
+            description: 'Disconnect from the browser without closing it',
+            parameters: z.object({}),
+            execute: wrap(async () => {
+                await backend.disconnect();
+                return 'Disconnected from browser';
+            }),
+        },
+    };
+}
 //# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/extension/background.js

@@ -0,0 +1,339 @@
+// CereWorker Browser Bridge — Service Worker
+// Connects to the CereWorker relay server via WebSocket and executes commands
+// using Chrome extension APIs (tabs, scripting).
+
+let ws = null;
+let connected = false;
+let reconnectDelay = 1000;
+const MAX_RECONNECT_DELAY = 30000;
+
+// Default config
+let config = { port: 18900, token: '' };
+
+// Load config from storage
+chrome.storage.local.get(['relayPort', 'relayToken'], (result) => {
+  if (result.relayPort) config.port = result.relayPort;
+  if (result.relayToken) config.token = result.relayToken;
+});
+
+// Listen for config changes
+chrome.storage.onChanged.addListener((changes) => {
+  if (changes.relayPort) config.port = changes.relayPort.newValue;
+  if (changes.relayToken) config.token = changes.relayToken.newValue;
+  // Reconnect with new config
+  if (ws) {
+    ws.close();
+  }
+});
+
+// Keep service worker alive with alarms
+chrome.alarms.create('keepalive', { periodInMinutes: 0.4 });
+chrome.alarms.onAlarm.addListener((alarm) => {
+  if (alarm.name === 'keepalive' && connected) {
+    // Ping is handled by WebSocket protocol; alarm just keeps SW alive
+  }
+});
+
+// Toggle connection on icon click
+chrome.action.onClicked.addListener(() => {
+  if (connected) {
+    disconnect();
+  } else {
+    connectToRelay();
+  }
+});
+
+function setBadge(text, color) {
+  chrome.action.setBadgeText({ text });
+  chrome.action.setBadgeBackgroundColor({ color });
+}
+
+function disconnect() {
+  if (ws) {
+    ws.close();
+    ws = null;
+  }
+  connected = false;
+  setBadge('', '#888');
+}
+
+function connectToRelay() {
+  if (ws && ws.readyState <= 1) return; // Already open or connecting
+
+  const tokenParam = config.token ? `?token=${encodeURIComponent(config.token)}` : '';
+  const url = `ws://127.0.0.1:${config.port}/extension${tokenParam}`;
+
+  setBadge('...', '#F59E0B');
+
+  try {
+    ws = new WebSocket(url);
+  } catch (err) {
+    setBadge('!', '#EF4444');
+    scheduleReconnect();
+    return;
+  }
+
+  ws.onopen = () => {
+    connected = true;
+    reconnectDelay = 1000;
+    setBadge('ON', '#22C55E');
+    // Send hello
+    ws.send(JSON.stringify({ type: 'hello', version: '1.0.0' }));
+  };
+
+  ws.onclose = () => {
+    connected = false;
+    setBadge('', '#888');
+    ws = null;
+    scheduleReconnect();
+  };
+
+  ws.onerror = () => {
+    setBadge('!', '#EF4444');
+  };
+
+  ws.onmessage = async (event) => {
+    let msg;
+    try {
+      msg = JSON.parse(event.data);
+    } catch {
+      return;
+    }
+
+    if (msg.type !== 'command' || !msg.id || !msg.method) return;
+
+    try {
+      const result = await handleCommand(msg.method, msg.params || {});
+      sendResult(msg.id, result);
+    } catch (err) {
+      sendResult(msg.id, null, err.message || String(err));
+    }
+  };
+}
+
+function sendResult(id, result, error) {
+  if (!ws || ws.readyState !== 1) return;
+  const msg = { type: 'result', id };
+  if (error) {
+    msg.error = error;
+  } else {
+    msg.result = result;
+  }
+  ws.send(JSON.stringify(msg));
+}
+
+function scheduleReconnect() {
+  setTimeout(() => {
+    if (!connected) connectToRelay();
+  }, reconnectDelay);
+  reconnectDelay = Math.min(reconnectDelay * 2, MAX_RECONNECT_DELAY);
+}
+
+// --- Command handlers ---
+
+async function handleCommand(method, params) {
+  switch (method) {
+    case 'navigate': return cmdNavigate(params);
+    case 'getPageText': return cmdGetPageText();
+    case 'screenshot': return cmdScreenshot();
+    case 'click': return cmdClick(params);
+    case 'type': return cmdType(params);
+    case 'evaluate': return cmdEvaluate(params);
+    case 'waitForSelector': return cmdWaitForSelector(params);
+    case 'getPageUrl': return cmdGetPageUrl();
+    case 'listTabs': return cmdListTabs();
+    case 'switchTab': return cmdSwitchTab(params);
+    case 'newTab': return cmdNewTab(params);
+    case 'closeTab': return cmdCloseTab(params);
+    default: throw new Error(`Unknown method: ${method}`);
+  }
+}
+
+async function getActiveTab() {
+  const [tab] = await chrome.tabs.query({ active: true, currentWindow: true });
+  if (!tab) throw new Error('No active tab');
+  return tab;
+}
+
+async function cmdNavigate({ url }) {
+  if (!url) throw new Error('url is required');
+  const tab = await getActiveTab();
+  await chrome.tabs.update(tab.id, { url });
+  // Wait for load
+  await new Promise((resolve) => {
+    const listener = (tabId, info) => {
+      if (tabId === tab.id && info.status === 'complete') {
+        chrome.tabs.onUpdated.removeListener(listener);
+        resolve();
+      }
+    };
+    chrome.tabs.onUpdated.addListener(listener);
+    // Timeout after 30s
+    setTimeout(() => {
+      chrome.tabs.onUpdated.removeListener(listener);
+      resolve();
+    }, 30000);
+  });
+  const updated = await chrome.tabs.get(tab.id);
+  return `Navigated to ${updated.url} - Title: ${updated.title || ''}`;
+}
+
+async function cmdGetPageText() {
+  const tab = await getActiveTab();
+  const [result] = await chrome.scripting.executeScript({
+    target: { tabId: tab.id },
+    func: () => {
+      const text = document.body.innerText;
+      return text.length > 10000 ? text.slice(0, 10000) + '\n... (truncated)' : text;
+    },
+  });
+  return result?.result ?? '';
+}
+
+async function cmdScreenshot() {
+  const dataUrl = await chrome.tabs.captureVisibleTab(null, { format: 'png' });
+  return dataUrl; // Base64 data URL
+}
+
+async function cmdClick({ selector }) {
+  if (!selector) throw new Error('selector is required');
+  const tab = await getActiveTab();
+  const [result] = await chrome.scripting.executeScript({
+    target: { tabId: tab.id },
+    func: (sel) => {
+      const el = document.querySelector(sel);
+      if (!el) return `Element not found: ${sel}`;
+      el.click();
+      return `Clicked: ${sel}`;
+    },
+    args: [selector],
+  });
+  return result?.result ?? `Element not found: ${selector}`;
+}
+
+async function cmdType({ selector, text }) {
+  if (!selector || text === undefined) throw new Error('selector and text are required');
+  const tab = await getActiveTab();
+  const [result] = await chrome.scripting.executeScript({
+    target: { tabId: tab.id },
+    func: (sel, txt) => {
+      const el = document.querySelector(sel);
+      if (!el) return `Element not found: ${sel}`;
+      el.focus();
+      // Set value and dispatch input event
+      el.value = txt;
+      el.dispatchEvent(new Event('input', { bubbles: true }));
+      el.dispatchEvent(new Event('change', { bubbles: true }));
+      return `Typed into: ${sel}`;
+    },
+    args: [selector, text],
+  });
+  return result?.result ?? `Element not found: ${selector}`;
+}
+
+async function cmdEvaluate({ code }) {
+  if (!code) throw new Error('code is required');
+  const tab = await getActiveTab();
+  const [result] = await chrome.scripting.executeScript({
+    target: { tabId: tab.id },
+    func: (c) => {
+      try {
+        const r = eval(c);
+        return String(r ?? '(no result)');
+      } catch (err) {
+        return `Error: ${err.message || String(err)}`;
+      }
+    },
+    args: [code],
+  });
+  return result?.result ?? '(no result)';
+}
+
+async function cmdWaitForSelector({ selector, timeout = 5000 }) {
+  if (!selector) throw new Error('selector is required');
+  const tab = await getActiveTab();
+  const [result] = await chrome.scripting.executeScript({
+    target: { tabId: tab.id },
+    func: (sel, ms) => {
+      return new Promise((resolve) => {
+        if (document.querySelector(sel)) {
+          resolve(`Found: ${sel}`);
+          return;
+        }
+        const observer = new MutationObserver(() => {
+          if (document.querySelector(sel)) {
+            observer.disconnect();
+            resolve(`Found: ${sel}`);
+          }
+        });
+        observer.observe(document.body, { childList: true, subtree: true });
+        setTimeout(() => {
+          observer.disconnect();
+          resolve(`Timeout waiting for: ${sel}`);
+        }, ms);
+      });
+    },
+    args: [selector, timeout],
+  });
+  return result?.result ?? `Timeout waiting for: ${selector}`;
+}
+
+async function cmdGetPageUrl() {
+  const tab = await getActiveTab();
+  return tab.url || '';
+}
+
+async function cmdListTabs() {
+  const tabs = await chrome.tabs.query({ currentWindow: true });
+  const result = tabs.map((t) => ({
+    id: String(t.id),
+    title: t.title || '',
+    url: t.url || '',
+    active: t.active,
+  }));
+  return JSON.stringify(result);
+}
+
+async function cmdSwitchTab({ tabId }) {
+  if (!tabId) throw new Error('tabId is required');
+  const id = parseInt(tabId, 10);
+  await chrome.tabs.update(id, { active: true });
+  const tab = await chrome.tabs.get(id);
+  return `Switched to tab ${id}: ${tab.url}`;
+}
+
+async function cmdNewTab({ url }) {
+  const tab = await chrome.tabs.create({ url: url || undefined });
+  if (url) {
+    // Wait for load
+    await new Promise((resolve) => {
+      const listener = (tabId, info) => {
+        if (tabId === tab.id && info.status === 'complete') {
+          chrome.tabs.onUpdated.removeListener(listener);
+          resolve();
+        }
+      };
+      chrome.tabs.onUpdated.addListener(listener);
+      setTimeout(() => {
+        chrome.tabs.onUpdated.removeListener(listener);
+        resolve();
+      }, 30000);
+    });
+  }
+  const updated = await chrome.tabs.get(tab.id);
+  return `Opened new tab: ${updated.url || 'about:blank'}`;
+}
+
+async function cmdCloseTab({ tabId }) {
+  if (tabId) {
+    const id = parseInt(tabId, 10);
+    await chrome.tabs.remove(id);
+    return `Closed tab ${id}`;
+  }
+  const tab = await getActiveTab();
+  await chrome.tabs.remove(tab.id);
+  return 'Closed current tab';
+}
+
+// Auto-connect on startup
+connectToRelay();

package/extension/manifest.json

@@ -0,0 +1,37 @@
+{
+  "manifest_version": 3,
+  "name": "CereWorker Browser Bridge",
+  "version": "1.0.0",
+  "description": "Connects CereWorker agent to your browser for automation",
+  "permissions": [
+    "tabs",
+    "scripting",
+    "activeTab",
+    "storage",
+    "alarms"
+  ],
+  "host_permissions": [
+    "http://127.0.0.1/*",
+    "http://localhost/*",
+    "<all_urls>"
+  ],
+  "background": {
+    "service_worker": "background.js"
+  },
+  "options_page": "options.html",
+  "action": {
+    "default_title": "CereWorker Bridge",
+    "default_icon": {
+      "16": "icons/icon16.png",
+      "32": "icons/icon32.png",
+      "48": "icons/icon48.png",
+      "128": "icons/icon128.png"
+    }
+  },
+  "icons": {
+    "16": "icons/icon16.png",
+    "32": "icons/icon32.png",
+    "48": "icons/icon48.png",
+    "128": "icons/icon128.png"
+  }
+}

package/extension/options.html

@@ -0,0 +1,34 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <title>CereWorker Browser Bridge - Options</title>
+  <style>
+    body { font-family: system-ui, sans-serif; padding: 24px; max-width: 400px; }
+    h1 { font-size: 18px; margin-bottom: 16px; }
+    label { display: block; margin-top: 12px; font-weight: 500; font-size: 14px; }
+    input { display: block; width: 100%; padding: 8px; margin-top: 4px; border: 1px solid #ccc; border-radius: 4px; box-sizing: border-box; }
+    .status { margin-top: 16px; padding: 8px 12px; border-radius: 4px; font-size: 13px; }
+    .status.ok { background: #dcfce7; color: #166534; }
+    .status.error { background: #fee2e2; color: #991b1b; }
+    .status.checking { background: #fef9c3; color: #854d0e; }
+    button { margin-top: 16px; padding: 8px 16px; background: #2563eb; color: white; border: none; border-radius: 4px; cursor: pointer; }
+    button:hover { background: #1d4ed8; }
+  </style>
+</head>
+<body>
+  <h1>CereWorker Browser Bridge</h1>
+
+  <label for="port">Relay Port</label>
+  <input type="number" id="port" value="18900" min="1024" max="65535">
+
+  <label for="token">Token (optional)</label>
+  <input type="text" id="token" placeholder="Leave empty if no token configured">
+
+  <button id="save">Save & Test Connection</button>
+
+  <div id="status" class="status" style="display:none"></div>
+
+  <script src="options.js"></script>
+</body>
+</html>