@producible/cereworker-browser 26.520.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Producible
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/backend.d.ts

@@ -0,0 +1,28 @@
+export interface TabInfo {
+    id: string;
+    title: string;
+    url: string;
+    active: boolean;
+}
+export interface BrowserCommandOptions {
+    abortSignal?: AbortSignal;
+}
+export interface BrowserBackend {
+    navigate(url: string, options?: BrowserCommandOptions): Promise<string>;
+    getPageText(options?: BrowserCommandOptions): Promise<string>;
+    screenshot(path?: string, options?: BrowserCommandOptions): Promise<string>;
+    click(selector: string, options?: BrowserCommandOptions): Promise<string>;
+    clickByText(text: string, role?: string, options?: BrowserCommandOptions): Promise<string>;
+    type(selector: string, text: string, options?: BrowserCommandOptions): Promise<string>;
+    evaluate(code: string, options?: BrowserCommandOptions): Promise<string>;
+    waitForSelector(selector: string, timeoutMs?: number, options?: BrowserCommandOptions): Promise<string>;
+    getPageUrl(options?: BrowserCommandOptions): Promise<string>;
+    listTabs(options?: BrowserCommandOptions): Promise<TabInfo[]>;
+    switchTab(tabId: string, options?: BrowserCommandOptions): Promise<string>;
+    newTab(url?: string, options?: BrowserCommandOptions): Promise<string>;
+    closeTab(tabId?: string, options?: BrowserCommandOptions): Promise<string>;
+    connect(options?: BrowserCommandOptions): Promise<string>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+}
+//# sourceMappingURL=backend.d.ts.map

package/dist/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAE7B,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxE,WAAW,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9D,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5E,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1E,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3F,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvF,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzE,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxG,UAAU,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAG7D,QAAQ,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9D,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3E,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAG3E,OAAO,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,WAAW,IAAI,OAAO,CAAC;CACxB"}

package/dist/backend.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=backend.js.map

package/dist/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":""}

package/dist/cdp.d.ts

@@ -0,0 +1,29 @@
+import type { BrowserBackend, BrowserCommandOptions, TabInfo } from './backend.js';
+export interface CdpConnectionOptions {
+    port?: number;
+    wsEndpoint?: string;
+}
+export declare class CdpBackend implements BrowserBackend {
+    private browser;
+    private page;
+    private options;
+    constructor(options?: CdpConnectionOptions);
+    private ensureConnected;
+    navigate(url: string, _options?: BrowserCommandOptions): Promise<string>;
+    getPageText(_options?: BrowserCommandOptions): Promise<string>;
+    screenshot(path?: string, _options?: BrowserCommandOptions): Promise<string>;
+    click(selector: string, _options?: BrowserCommandOptions): Promise<string>;
+    clickByText(text: string, role?: string, _options?: BrowserCommandOptions): Promise<string>;
+    type(selector: string, text: string, _options?: BrowserCommandOptions): Promise<string>;
+    evaluate(code: string, _options?: BrowserCommandOptions): Promise<string>;
+    waitForSelector(selector: string, timeoutMs?: number, _options?: BrowserCommandOptions): Promise<string>;
+    getPageUrl(_options?: BrowserCommandOptions): Promise<string>;
+    listTabs(_options?: BrowserCommandOptions): Promise<TabInfo[]>;
+    switchTab(tabId: string, _options?: BrowserCommandOptions): Promise<string>;
+    newTab(url?: string, _options?: BrowserCommandOptions): Promise<string>;
+    closeTab(tabId?: string, _options?: BrowserCommandOptions): Promise<string>;
+    connect(_options?: BrowserCommandOptions): Promise<string>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+}
+//# sourceMappingURL=cdp.d.ts.map

package/dist/cdp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp.d.ts","sourceRoot":"","sources":["../src/cdp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEnF,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,UAAW,YAAW,cAAc;IAC/C,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,OAAO,CAAuB;gBAE1B,OAAO,CAAC,EAAE,oBAAoB;YAI5B,eAAe;IAuBvB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAMxE,WAAW,CAAC,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAO9D,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAO5E,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAU1E,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAiB3F,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAUvF,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAUzE,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,SAAO,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAUtG,UAAU,CAAC,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAK7D,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAW9D,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAY3E,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAWvE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAuB3E,OAAO,CAAC,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAK1D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC,WAAW,IAAI,OAAO;CAGvB"}

package/dist/cdp.js

@@ -0,0 +1,180 @@
+import puppeteer from 'puppeteer';
+export class CdpBackend {
+    browser = null;
+    page = null;
+    options;
+    constructor(options) {
+        this.options = options ?? {};
+    }
+    async ensureConnected() {
+        if (this.browser && this.page)
+            return { browser: this.browser, page: this.page };
+        try {
+            let wsEndpoint = this.options.wsEndpoint;
+            if (!wsEndpoint) {
+                const port = this.options.port ?? 9222;
+                const response = await fetch(`http://localhost:${port}/json/version`);
+                const data = (await response.json());
+                wsEndpoint = data.webSocketDebuggerUrl;
+            }
+            this.browser = await puppeteer.connect({ browserWSEndpoint: wsEndpoint });
+            const pages = await this.browser.pages();
+            this.page = pages[0] ?? (await this.browser.newPage());
+            return { browser: this.browser, page: this.page };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`Cannot connect to Chrome via CDP (${msg}). ` +
+                'Start Chrome with --remote-debugging-port=9222, or use httpFetch/shell tools instead.');
+        }
+    }
+    async navigate(url, _options) {
+        const { page } = await this.ensureConnected();
+        await page.goto(url, { waitUntil: 'networkidle2', timeout: 30000 });
+        return `Navigated to ${page.url()} - Title: ${await page.title()}`;
+    }
+    async getPageText(_options) {
+        const { page } = await this.ensureConnected();
+        const text = await page.evaluate(() => document.body.innerText);
+        const maxLen = 10000;
+        return text.length > maxLen ? text.slice(0, maxLen) + '\n... (truncated)' : text;
+    }
+    async screenshot(path, _options) {
+        const { page } = await this.ensureConnected();
+        const filePath = path ?? `/tmp/cereworker-screenshot-${Date.now()}.png`;
+        await page.screenshot({ path: filePath, fullPage: false });
+        return `Screenshot saved to ${filePath}`;
+    }
+    async click(selector, _options) {
+        const { page } = await this.ensureConnected();
+        try {
+            await page.click(selector);
+            return `Clicked: ${selector}`;
+        }
+        catch {
+            return `Element not found: ${selector}`;
+        }
+    }
+    async clickByText(text, role, _options) {
+        const { page } = await this.ensureConnected();
+        try {
+            const selector = role ? `[role="${role}"]` : 'button, [role="button"], a';
+            const clicked = await page.evaluate((sel, txt) => {
+                const els = Array.from(document.querySelectorAll(sel));
+                for (const el of els) {
+                    if (el.textContent?.trim() === txt) {
+                        el.click();
+                        return true;
+                    }
+                }
+                return false;
+            }, selector, text);
+            return clicked ? `Clicked element with text: "${text}"` : `No clickable element found with text: "${text}"`;
+        }
+        catch {
+            return `No clickable element found with text: "${text}"`;
+        }
+    }
+    async type(selector, text, _options) {
+        const { page } = await this.ensureConnected();
+        try {
+            await page.type(selector, text);
+            return `Typed into: ${selector}`;
+        }
+        catch {
+            return `Element not found: ${selector}`;
+        }
+    }
+    async evaluate(code, _options) {
+        const { page } = await this.ensureConnected();
+        try {
+            const result = await page.evaluate(code);
+            return String(result ?? '(no result)');
+        }
+        catch (err) {
+            return `Error: ${err instanceof Error ? err.message : String(err)}`;
+        }
+    }
+    async waitForSelector(selector, timeoutMs = 5000, _options) {
+        const { page } = await this.ensureConnected();
+        try {
+            await page.waitForSelector(selector, { timeout: timeoutMs });
+            return `Found: ${selector}`;
+        }
+        catch {
+            return `Timeout waiting for: ${selector}`;
+        }
+    }
+    async getPageUrl(_options) {
+        const { page } = await this.ensureConnected();
+        return page.url();
+    }
+    async listTabs(_options) {
+        const { browser, page } = await this.ensureConnected();
+        const pages = await browser.pages();
+        return pages.map((p, i) => ({
+            id: String(i),
+            title: '',
+            url: p.url(),
+            active: p === page,
+        }));
+    }
+    async switchTab(tabId, _options) {
+        const { browser } = await this.ensureConnected();
+        const pages = await browser.pages();
+        const idx = parseInt(tabId, 10);
+        if (isNaN(idx) || idx < 0 || idx >= pages.length) {
+            return `Invalid tab id: ${tabId}. Use browserListTabs to see available tabs.`;
+        }
+        this.page = pages[idx];
+        await this.page.bringToFront();
+        return `Switched to tab ${idx}: ${this.page.url()}`;
+    }
+    async newTab(url, _options) {
+        const { browser } = await this.ensureConnected();
+        const page = await browser.newPage();
+        if (url) {
+            await page.goto(url, { waitUntil: 'networkidle2', timeout: 30000 });
+        }
+        this.page = page;
+        const pages = await browser.pages();
+        return `Opened new tab (${pages.length} total)${url ? `: ${page.url()}` : ''}`;
+    }
+    async closeTab(tabId, _options) {
+        const { browser } = await this.ensureConnected();
+        const pages = await browser.pages();
+        if (pages.length <= 1)
+            return 'Cannot close the last tab.';
+        if (tabId !== undefined) {
+            const idx = parseInt(tabId, 10);
+            if (isNaN(idx) || idx < 0 || idx >= pages.length)
+                return `Invalid tab id: ${tabId}`;
+            const wasActive = pages[idx] === this.page;
+            await pages[idx].close();
+            if (wasActive) {
+                const remaining = await browser.pages();
+                this.page = remaining[remaining.length - 1];
+            }
+            return `Closed tab ${idx}`;
+        }
+        await this.page.close();
+        const remaining = await browser.pages();
+        this.page = remaining[remaining.length - 1];
+        return `Closed current tab. Now on: ${this.page.url()}`;
+    }
+    async connect(_options) {
+        const { page } = await this.ensureConnected();
+        return `Connected to Chrome via CDP. Current page: ${page.url()}`;
+    }
+    async disconnect() {
+        if (this.browser) {
+            this.browser.disconnect();
+            this.browser = null;
+            this.page = null;
+        }
+    }
+    isConnected() {
+        return this.browser !== null && this.browser.connected;
+    }
+}
+//# sourceMappingURL=cdp.js.map

package/dist/cdp.js.map

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

package/dist/extension-backend.d.ts

@@ -0,0 +1,23 @@
+import type { BrowserBackend, BrowserCommandOptions, TabInfo } from './backend.js';
+import type { BrowserRelay } from './relay.js';
+export declare class ExtensionBackend implements BrowserBackend {
+    private relay;
+    constructor(relay: BrowserRelay);
+    navigate(url: string, options?: BrowserCommandOptions): Promise<string>;
+    getPageText(options?: BrowserCommandOptions): Promise<string>;
+    screenshot(path?: string, options?: BrowserCommandOptions): Promise<string>;
+    click(selector: string, options?: BrowserCommandOptions): Promise<string>;
+    clickByText(text: string, role?: string, options?: BrowserCommandOptions): Promise<string>;
+    type(selector: string, text: string, options?: BrowserCommandOptions): Promise<string>;
+    evaluate(code: string, options?: BrowserCommandOptions): Promise<string>;
+    waitForSelector(selector: string, timeoutMs?: number, options?: BrowserCommandOptions): Promise<string>;
+    getPageUrl(options?: BrowserCommandOptions): Promise<string>;
+    listTabs(options?: BrowserCommandOptions): Promise<TabInfo[]>;
+    switchTab(tabId: string, options?: BrowserCommandOptions): Promise<string>;
+    newTab(url?: string, options?: BrowserCommandOptions): Promise<string>;
+    closeTab(tabId?: string, options?: BrowserCommandOptions): Promise<string>;
+    connect(_options?: BrowserCommandOptions): Promise<string>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+}
+//# sourceMappingURL=extension-backend.d.ts.map

package/dist/extension-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-backend.d.ts","sourceRoot":"","sources":["../src/extension-backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,qBAAa,gBAAiB,YAAW,cAAc;IACrD,OAAO,CAAC,KAAK,CAAe;gBAEhB,KAAK,EAAE,YAAY;IAIzB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIvE,WAAW,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7D,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3E,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIzE,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI1F,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAItF,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIxE,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,SAAO,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIrG,UAAU,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI5D,QAAQ,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAK7D,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI1E,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAItE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI1E,OAAO,CAAC,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAU1D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,WAAW,IAAI,OAAO;CAGvB"}

package/dist/extension-backend.js

@@ -0,0 +1,60 @@
+export class ExtensionBackend {
+    relay;
+    constructor(relay) {
+        this.relay = relay;
+    }
+    async navigate(url, options) {
+        return this.relay.send('navigate', { url }, 30_000, options?.abortSignal);
+    }
+    async getPageText(options) {
+        return this.relay.send('getPageText', undefined, 30_000, options?.abortSignal);
+    }
+    async screenshot(path, options) {
+        return this.relay.send('screenshot', { path }, 30_000, options?.abortSignal);
+    }
+    async click(selector, options) {
+        return this.relay.send('click', { selector }, 30_000, options?.abortSignal);
+    }
+    async clickByText(text, role, options) {
+        return this.relay.send('clickByText', { text, role }, 30_000, options?.abortSignal);
+    }
+    async type(selector, text, options) {
+        return this.relay.send('type', { selector, text }, 30_000, options?.abortSignal);
+    }
+    async evaluate(code, options) {
+        return this.relay.send('evaluate', { code }, 30_000, options?.abortSignal);
+    }
+    async waitForSelector(selector, timeoutMs = 5000, options) {
+        return this.relay.send('waitForSelector', { selector, timeout: timeoutMs }, timeoutMs + 5000, options?.abortSignal);
+    }
+    async getPageUrl(options) {
+        return this.relay.send('getPageUrl', undefined, 30_000, options?.abortSignal);
+    }
+    async listTabs(options) {
+        const result = await this.relay.send('listTabs', undefined, 30_000, options?.abortSignal);
+        return JSON.parse(result);
+    }
+    async switchTab(tabId, options) {
+        return this.relay.send('switchTab', { tabId }, 30_000, options?.abortSignal);
+    }
+    async newTab(url, options) {
+        return this.relay.send('newTab', { url }, 30_000, options?.abortSignal);
+    }
+    async closeTab(tabId, options) {
+        return this.relay.send('closeTab', { tabId }, 30_000, options?.abortSignal);
+    }
+    async connect(_options) {
+        if (!this.relay.isExtensionConnected()) {
+            throw new Error('Chrome extension not connected. Load the CereWorker extension in Chrome, ' +
+                'configure the relay port and token in extension options, then click the extension icon.');
+        }
+        return 'Connected to Chrome via extension';
+    }
+    async disconnect() {
+        // Extension stays connected — nothing to tear down from backend side
+    }
+    isConnected() {
+        return this.relay.isExtensionConnected();
+    }
+}
+//# sourceMappingURL=extension-backend.js.map

package/dist/extension-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-backend.js","sourceRoot":"","sources":["../src/extension-backend.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,gBAAgB;IACnB,KAAK,CAAe;IAE5B,YAAY,KAAmB;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAW,EAAE,OAA+B;QACzD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAA+B;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IACjF,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAa,EAAE,OAA+B;QAC7D,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAC/E,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,OAA+B;QAC3D,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAY,EAAE,IAAa,EAAE,OAA+B;QAC5E,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IACtF,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAgB,EAAE,IAAY,EAAE,OAA+B;QACxE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IACnF,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,OAA+B;QAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAC7E,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,QAAgB,EAAE,SAAS,GAAG,IAAI,EAAE,OAA+B;QACvF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IACtH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAA+B;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAChF,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAA+B;QAC5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;QAC1F,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAc,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAa,EAAE,OAA+B;QAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAC/E,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAY,EAAE,OAA+B;QACxD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAc,EAAE,OAA+B;QAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAgC;QAC5C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CACb,2EAA2E;gBAC3E,yFAAyF,CAC1F,CAAC;QACJ,CAAC;QACD,OAAO,mCAAmC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,UAAU;QACd,qEAAqE;IACvE,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE,CAAC;IAC3C,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { BrowserBackend, BrowserCommandOptions, TabInfo } from './backend.js';
+export { PuppeteerBackend, type BrowserSession } from './puppeteer.js';
+export { CdpBackend, type CdpConnectionOptions } from './cdp.js';
+export { createBrowserTools, type BrowserTools, type BrowserToolName } from './tools.js';
+export { BrowserRelay, type RelayConfig, type RelayCommand, type RelayResult } from './relay.js';
+export { ExtensionBackend } from './extension-backend.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,KAAK,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { PuppeteerBackend } from './puppeteer.js';
+export { CdpBackend } from './cdp.js';
+export { createBrowserTools } from './tools.js';
+export { BrowserRelay } from './relay.js';
+export { ExtensionBackend } from './extension-backend.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAuB,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,UAAU,EAA6B,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAA2C,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,YAAY,EAAyD,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/puppeteer.d.ts

@@ -0,0 +1,31 @@
+import { type Browser, type Page } from 'puppeteer';
+import type { BrowserBackend, BrowserCommandOptions, TabInfo } from './backend.js';
+export interface BrowserSession {
+    browser: Browser;
+    page: Page;
+}
+export declare class PuppeteerBackend implements BrowserBackend {
+    private session;
+    private headless;
+    constructor(options?: {
+        headless?: boolean;
+    });
+    private getSession;
+    navigate(url: string, _options?: BrowserCommandOptions): Promise<string>;
+    getPageText(_options?: BrowserCommandOptions): Promise<string>;
+    screenshot(path?: string, _options?: BrowserCommandOptions): Promise<string>;
+    click(selector: string, _options?: BrowserCommandOptions): Promise<string>;
+    clickByText(text: string, role?: string, _options?: BrowserCommandOptions): Promise<string>;
+    type(selector: string, text: string, _options?: BrowserCommandOptions): Promise<string>;
+    evaluate(code: string, _options?: BrowserCommandOptions): Promise<string>;
+    waitForSelector(selector: string, timeoutMs?: number, _options?: BrowserCommandOptions): Promise<string>;
+    getPageUrl(_options?: BrowserCommandOptions): Promise<string>;
+    listTabs(_options?: BrowserCommandOptions): Promise<TabInfo[]>;
+    switchTab(tabId: string, _options?: BrowserCommandOptions): Promise<string>;
+    newTab(url?: string, _options?: BrowserCommandOptions): Promise<string>;
+    closeTab(tabId?: string, _options?: BrowserCommandOptions): Promise<string>;
+    connect(_options?: BrowserCommandOptions): Promise<string>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+}
+//# sourceMappingURL=puppeteer.d.ts.map

package/dist/puppeteer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"puppeteer.d.ts","sourceRoot":"","sources":["../src/puppeteer.ts"],"names":[],"mappings":"AAAA,OAAkB,EAAE,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEnF,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,qBAAa,gBAAiB,YAAW,cAAc;IACrD,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,QAAQ,CAAU;gBAEd,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE;YAI9B,UAAU;IAoBlB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAMxE,WAAW,CAAC,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAO9D,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAO5E,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAU1E,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAiB3F,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAUvF,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAUzE,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,SAAO,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAUtG,UAAU,CAAC,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAK7D,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAW9D,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAa3E,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAavE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IA4B3E,OAAO,CAAC,QAAQ,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAK1D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC,WAAW,IAAI,OAAO;CAGvB"}

package/dist/puppeteer.js

@@ -0,0 +1,182 @@
+import puppeteer from 'puppeteer';
+export class PuppeteerBackend {
+    session = null;
+    headless;
+    constructor(options) {
+        this.headless = options?.headless ?? true;
+    }
+    async getSession() {
+        if (this.session)
+            return this.session;
+        try {
+            const browser = await puppeteer.launch({
+                headless: this.headless ? 'shell' : false,
+                args: ['--no-sandbox', '--disable-setuid-sandbox'],
+            });
+            const page = await browser.newPage();
+            await page.setViewport({ width: 1280, height: 800 });
+            this.session = { browser, page };
+            return this.session;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`No browser available (${msg}). ` +
+                'Use httpFetch/shell tools for API calls, or install Chrome for browser automation.');
+        }
+    }
+    async navigate(url, _options) {
+        const s = await this.getSession();
+        await s.page.goto(url, { waitUntil: 'networkidle2', timeout: 30000 });
+        return `Navigated to ${s.page.url()} - Title: ${await s.page.title()}`;
+    }
+    async getPageText(_options) {
+        const s = await this.getSession();
+        const text = await s.page.evaluate(() => document.body.innerText);
+        const maxLen = 10000;
+        return text.length > maxLen ? text.slice(0, maxLen) + '\n... (truncated)' : text;
+    }
+    async screenshot(path, _options) {
+        const s = await this.getSession();
+        const filePath = path ?? `/tmp/cereworker-screenshot-${Date.now()}.png`;
+        await s.page.screenshot({ path: filePath, fullPage: false });
+        return `Screenshot saved to ${filePath}`;
+    }
+    async click(selector, _options) {
+        const s = await this.getSession();
+        try {
+            await s.page.click(selector);
+            return `Clicked: ${selector}`;
+        }
+        catch {
+            return `Element not found: ${selector}`;
+        }
+    }
+    async clickByText(text, role, _options) {
+        const s = await this.getSession();
+        try {
+            const selector = role ? `[role="${role}"]` : 'button, [role="button"], a';
+            const clicked = await s.page.evaluate((sel, txt) => {
+                const els = Array.from(document.querySelectorAll(sel));
+                for (const el of els) {
+                    if (el.textContent?.trim() === txt) {
+                        el.click();
+                        return true;
+                    }
+                }
+                return false;
+            }, selector, text);
+            return clicked ? `Clicked element with text: "${text}"` : `No clickable element found with text: "${text}"`;
+        }
+        catch {
+            return `No clickable element found with text: "${text}"`;
+        }
+    }
+    async type(selector, text, _options) {
+        const s = await this.getSession();
+        try {
+            await s.page.type(selector, text);
+            return `Typed into: ${selector}`;
+        }
+        catch {
+            return `Element not found: ${selector}`;
+        }
+    }
+    async evaluate(code, _options) {
+        const s = await this.getSession();
+        try {
+            const result = await s.page.evaluate(code);
+            return String(result ?? '(no result)');
+        }
+        catch (err) {
+            return `Error: ${err instanceof Error ? err.message : String(err)}`;
+        }
+    }
+    async waitForSelector(selector, timeoutMs = 5000, _options) {
+        const s = await this.getSession();
+        try {
+            await s.page.waitForSelector(selector, { timeout: timeoutMs });
+            return `Found: ${selector}`;
+        }
+        catch {
+            return `Timeout waiting for: ${selector}`;
+        }
+    }
+    async getPageUrl(_options) {
+        const s = await this.getSession();
+        return s.page.url();
+    }
+    async listTabs(_options) {
+        const s = await this.getSession();
+        const pages = await s.browser.pages();
+        return pages.map((p, i) => ({
+            id: String(i),
+            title: '', // title() is async, keep lightweight
+            url: p.url(),
+            active: p === s.page,
+        }));
+    }
+    async switchTab(tabId, _options) {
+        const s = await this.getSession();
+        const pages = await s.browser.pages();
+        const idx = parseInt(tabId, 10);
+        if (isNaN(idx) || idx < 0 || idx >= pages.length) {
+            return `Invalid tab id: ${tabId}. Use browserListTabs to see available tabs.`;
+        }
+        s.page = pages[idx];
+        this.session = s;
+        await s.page.bringToFront();
+        return `Switched to tab ${idx}: ${s.page.url()}`;
+    }
+    async newTab(url, _options) {
+        const s = await this.getSession();
+        const page = await s.browser.newPage();
+        await page.setViewport({ width: 1280, height: 800 });
+        if (url) {
+            await page.goto(url, { waitUntil: 'networkidle2', timeout: 30000 });
+        }
+        s.page = page;
+        this.session = s;
+        const pages = await s.browser.pages();
+        return `Opened new tab (${pages.length} total)${url ? `: ${page.url()}` : ''}`;
+    }
+    async closeTab(tabId, _options) {
+        const s = await this.getSession();
+        const pages = await s.browser.pages();
+        if (pages.length <= 1)
+            return 'Cannot close the last tab.';
+        if (tabId !== undefined) {
+            const idx = parseInt(tabId, 10);
+            if (isNaN(idx) || idx < 0 || idx >= pages.length) {
+                return `Invalid tab id: ${tabId}`;
+            }
+            await pages[idx].close();
+            if (pages[idx] === s.page) {
+                const remaining = await s.browser.pages();
+                s.page = remaining[remaining.length - 1];
+                this.session = s;
+            }
+            return `Closed tab ${idx}`;
+        }
+        // Close current tab
+        const current = s.page;
+        await current.close();
+        const remaining = await s.browser.pages();
+        s.page = remaining[remaining.length - 1];
+        this.session = s;
+        return `Closed current tab. Now on: ${s.page.url()}`;
+    }
+    async connect(_options) {
+        const s = await this.getSession();
+        return `Browser launched (headless: ${this.headless}). Page: ${s.page.url()}`;
+    }
+    async disconnect() {
+        if (this.session) {
+            await this.session.browser.close();
+            this.session = null;
+        }
+    }
+    isConnected() {
+        return this.session !== null && this.session.browser.connected;
+    }
+}
+//# sourceMappingURL=puppeteer.js.map