@lobu/connector-sdk 6.0.1

package/dist/browser/cdp-page.js

@@ -0,0 +1,165 @@
+/**
+ * Lightweight CDP Page
+ *
+ * A minimal Page-like interface over raw Chrome DevTools Protocol.
+ * Used when Playwright's connectOverCDP crashes on browsers with many tabs
+ * (it tries to enumerate all targets, which fails on real user browsers).
+ *
+ * Supports the subset of Playwright's Page API used by DOM scraper connectors:
+ * goto, evaluate, waitForSelector, waitForTimeout, click, close.
+ */
+import { sdkLogger } from '../logger.js';
+export class CdpPage {
+    ws;
+    sessionId;
+    targetId;
+    msgId = 1;
+    constructor(ws, sessionId, targetId) {
+        this.ws = ws;
+        this.sessionId = sessionId;
+        this.targetId = targetId;
+    }
+    /**
+     * Create a new tab in the browser and return a CdpPage handle.
+     * Does NOT enumerate existing tabs — avoids the Playwright crash.
+     */
+    static async create(browserWsUrl) {
+        const ws = new WebSocket(browserWsUrl);
+        await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => reject(new Error('CDP WebSocket connection timeout')), 10000);
+            ws.onopen = () => {
+                clearTimeout(timer);
+                resolve();
+            };
+            ws.onerror = () => {
+                clearTimeout(timer);
+                reject(new Error('CDP WebSocket connection failed'));
+            };
+        });
+        const sendBrowser = (method, params = {}) => {
+            return new Promise((resolve, reject) => {
+                const id = Math.floor(Math.random() * 1e9);
+                const timer = setTimeout(() => reject(new Error(`${method} timeout`)), 15000);
+                const handler = (event) => {
+                    const data = JSON.parse(event.data);
+                    if (data.id === id) {
+                        clearTimeout(timer);
+                        ws.removeEventListener('message', handler);
+                        data.error ? reject(new Error(data.error.message)) : resolve(data.result);
+                    }
+                };
+                ws.addEventListener('message', handler);
+                ws.send(JSON.stringify({ id, method, params }));
+            });
+        };
+        const { targetId } = await sendBrowser('Target.createTarget', { url: 'about:blank' });
+        const { sessionId } = await sendBrowser('Target.attachToTarget', {
+            targetId,
+            flatten: true,
+        });
+        const page = new CdpPage(ws, sessionId, targetId);
+        await page.send('Page.enable');
+        await page.send('Runtime.enable');
+        await page.send('DOM.enable');
+        sdkLogger.info({ targetId }, '[CdpPage] Created tab');
+        return page;
+    }
+    send(method, params = {}) {
+        return new Promise((resolve, reject) => {
+            const id = this.msgId++;
+            const timer = setTimeout(() => reject(new Error(`${method} timeout`)), 30000);
+            const handler = (event) => {
+                const data = JSON.parse(event.data);
+                if (data.id === id) {
+                    clearTimeout(timer);
+                    this.ws.removeEventListener('message', handler);
+                    data.error ? reject(new Error(data.error.message)) : resolve(data.result);
+                }
+            };
+            this.ws.addEventListener('message', handler);
+            this.ws.send(JSON.stringify({ id, method, params, sessionId: this.sessionId }));
+        });
+    }
+    /** Navigate to a URL and wait for the page to load. */
+    async goto(url, options) {
+        const timeout = options?.timeout ?? 30000;
+        await this.send('Page.navigate', { url });
+        // Wait for load event
+        await new Promise((resolve) => {
+            const timer = setTimeout(() => resolve(), timeout);
+            const handler = (event) => {
+                const data = JSON.parse(event.data);
+                if (data.method === 'Page.loadEventFired' && data.sessionId === this.sessionId) {
+                    clearTimeout(timer);
+                    this.ws.removeEventListener('message', handler);
+                    resolve();
+                }
+            };
+            this.ws.addEventListener('message', handler);
+        });
+    }
+    /** Evaluate a JavaScript expression in the page and return the result. */
+    async evaluate(expression) {
+        const code = typeof expression === 'function' ? `(${expression.toString()})()` : expression;
+        const { result, exceptionDetails } = await this.send('Runtime.evaluate', {
+            expression: code,
+            returnByValue: true,
+            awaitPromise: true,
+        });
+        if (exceptionDetails) {
+            throw new Error(`evaluate failed: ${exceptionDetails.text || exceptionDetails.exception?.description || 'unknown error'}`);
+        }
+        return result.value;
+    }
+    /**
+     * Wait for a CSS selector to appear in the DOM.
+     * Returns true if found, false on timeout.
+     */
+    async waitForSelector(selector, options) {
+        const timeout = options?.timeout ?? 10000;
+        const start = Date.now();
+        while (Date.now() - start < timeout) {
+            const found = await this.evaluate(`!!document.querySelector(${JSON.stringify(selector)})`);
+            if (found)
+                return true;
+            await this.waitForTimeout(500);
+        }
+        return false;
+    }
+    /** Click the first element matching a CSS selector. */
+    async click(selector) {
+        await this.evaluate(`document.querySelector(${JSON.stringify(selector)})?.click()`);
+    }
+    /** Wait for a fixed duration. */
+    async waitForTimeout(ms) {
+        await new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /** Get the current page URL. */
+    async url() {
+        return this.evaluate('location.href');
+    }
+    /** Get the page title. */
+    async title() {
+        return this.evaluate('document.title');
+    }
+    /** Close the tab and disconnect. */
+    async close() {
+        try {
+            await this.send('Page.close').catch(() => { });
+            // Also close via Target API as fallback
+            const id = this.msgId++;
+            this.ws.send(JSON.stringify({
+                id,
+                method: 'Target.closeTarget',
+                params: { targetId: this.targetId },
+            }));
+            await new Promise((r) => setTimeout(r, 300));
+            this.ws.close();
+        }
+        catch {
+            // Best-effort cleanup
+        }
+        sdkLogger.info({ targetId: this.targetId }, '[CdpPage] Tab closed');
+    }
+}
+//# sourceMappingURL=cdp-page.js.map

package/dist/browser/cdp-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-page.js","sourceRoot":"","sources":["../../src/browser/cdp-page.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,OAAO,OAAO;IACV,EAAE,CAAY;IACd,SAAS,CAAS;IAClB,QAAQ,CAAS;IACjB,KAAK,GAAG,CAAC,CAAC;IAElB,YAAoB,EAAa,EAAE,SAAiB,EAAE,QAAgB;QACpE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,YAAoB;QACtC,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,YAAY,CAAC,CAAC;QACvC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAC7F,EAAE,CAAC,MAAM,GAAG,GAAG,EAAE;gBACf,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;YACF,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE;gBAChB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC;YACvD,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,CAAC,MAAc,EAAE,SAAkC,EAAE,EAAgB,EAAE;YACzF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACrC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;gBAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,MAAM,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;gBAC9E,MAAM,OAAO,GAAG,CAAC,KAAmB,EAAE,EAAE;oBACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAc,CAAC,CAAC;oBAC9C,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;wBACnB,YAAY,CAAC,KAAK,CAAC,CAAC;wBACpB,EAAE,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;wBAC3C,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBAC5E,CAAC;gBACH,CAAC,CAAC;gBACF,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;gBACxC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;YAClD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,WAAW,CAAC,qBAAqB,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC;QACtF,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,WAAW,CAAC,uBAAuB,EAAE;YAC/D,QAAQ;YACR,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QAClD,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC/B,MAAM,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAClC,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAE9B,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,uBAAuB,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,IAAI,CAAC,MAAc,EAAE,SAAkC,EAAE;QAC/D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,MAAM,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAC9E,MAAM,OAAO,GAAG,CAAC,KAAmB,EAAE,EAAE;gBACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAc,CAAC,CAAC;gBAC9C,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;oBACnB,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,IAAI,CAAC,EAAE,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;oBAChD,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC5E,CAAC;YACH,CAAC,CAAC;YACF,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC7C,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAClF,CAAC,CAAC,CAAC;IACL,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,IAAI,CAAC,GAAW,EAAE,OAAkD;QACxE,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,KAAK,CAAC;QAC1C,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QAE1C,sBAAsB;QACtB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;YACnD,MAAM,OAAO,GAAG,CAAC,KAAmB,EAAE,EAAE;gBACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAc,CAAC,CAAC;gBAC9C,IAAI,IAAI,CAAC,MAAM,KAAK,qBAAqB,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;oBAC/E,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,IAAI,CAAC,EAAE,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;oBAChD,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,CAAC;YACF,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,0EAA0E;IAC1E,KAAK,CAAC,QAAQ,CAAc,UAA8B;QACxD,MAAM,IAAI,GAAG,OAAO,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC;QAC5F,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE;YACvE,UAAU,EAAE,IAAI;YAChB,aAAa,EAAE,IAAI;YACnB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QACH,IAAI,gBAAgB,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,oBAAoB,gBAAgB,CAAC,IAAI,IAAI,gBAAgB,CAAC,SAAS,EAAE,WAAW,IAAI,eAAe,EAAE,CAC1G,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,KAAU,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CAAC,QAAgB,EAAE,OAA8B;QACpE,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,KAAK,CAAC;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,OAAO,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAC/B,4BAA4B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CACxD,CAAC;YACF,IAAI,KAAK;gBAAE,OAAO,IAAI,CAAC;YACvB,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,KAAK,CAAC,QAAgB;QAC1B,MAAM,IAAI,CAAC,QAAQ,CAAC,0BAA0B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IACtF,CAAC;IAED,iCAAiC;IACjC,KAAK,CAAC,cAAc,CAAC,EAAU;QAC7B,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,gCAAgC;IAChC,KAAK,CAAC,GAAG;QACP,OAAO,IAAI,CAAC,QAAQ,CAAS,eAAe,CAAC,CAAC;IAChD,CAAC;IAED,0BAA0B;IAC1B,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,QAAQ,CAAS,gBAAgB,CAAC,CAAC;IACjD,CAAC;IAED,oCAAoC;IACpC,KAAK,CAAC,KAAK;QACT,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAC9C,wCAAwC;YACxC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACxB,IAAI,CAAC,EAAE,CAAC,IAAI,CACV,IAAI,CAAC,SAAS,CAAC;gBACb,EAAE;gBACF,MAAM,EAAE,oBAAoB;gBAC5B,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE;aACpC,CAAC,CACH,CAAC;YACF,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YAC7C,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,sBAAsB,CAAC,CAAC;IACtE,CAAC;CACF"}

package/dist/browser/cdp.d.ts

@@ -0,0 +1,44 @@
+export interface CdpVersionInfo {
+    Browser?: string;
+    webSocketDebuggerUrl?: string;
+    /** Whether the browser is headless (test/automation instance) */
+    isHeadless?: boolean;
+}
+export declare function normalizeCdpUrl(value: string): string;
+export declare function fetchCdpVersionInfo(baseUrl: string): Promise<CdpVersionInfo | null>;
+/**
+ * Try connecting to a Chrome DevTools endpoint via direct WebSocket.
+ * Chrome's DevTools remote debugging UI (chrome://inspect/#remote-debugging)
+ * exposes CDP over WebSocket at ws://{host}:{port}/devtools/browser
+ * without the HTTP /json/version endpoint.
+ */
+export declare function tryWebSocketCdp(host: string, port: number, timeoutMs?: number): Promise<CdpVersionInfo | null>;
+/**
+ * Discover Chrome processes listening on TCP ports by parsing `lsof` output.
+ * Returns ports for processes named "Google" (Chrome) on macOS/Linux.
+ */
+export declare function discoverChromeListeningPorts(): Promise<number[]>;
+/**
+ * Discover Chrome processes launched with --remote-debugging-port flag.
+ * Returns http:// URLs for those endpoints.
+ */
+export declare function discoverChromeProcessCdpUrls(): Promise<string[]>;
+export interface ResolveCdpOptions {
+    defaultUrls?: string[];
+    loggerLabel?: string;
+    /** If true, prefer non-headless (real user) browsers over headless instances */
+    preferRealBrowser?: boolean;
+}
+/**
+ * Resolve a CDP endpoint URL. Tries multiple discovery strategies:
+ *
+ * 1. Explicit URL (if not 'auto')
+ * 2. WebSocket probe on Chrome listening ports (new DevTools UI style)
+ * 3. HTTP /json/version on --remote-debugging-port URLs (old style)
+ * 4. HTTP /json/version on default ports (9222, 9223)
+ *
+ * When `preferRealBrowser` is true (default), non-headless browsers are
+ * returned first. Returns the `ws://` URL for direct WebSocket connections.
+ */
+export declare function resolveCdpUrl(input?: string | null, options?: ResolveCdpOptions): Promise<string>;
+//# sourceMappingURL=cdp.d.ts.map

package/dist/browser/cdp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp.d.ts","sourceRoot":"","sources":["../../src/browser/cdp.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iEAAiE;IACjE,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIrD;AAMD,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAgBzF;AAMD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,SAAO,GACf,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAoDhC;AAMD;;;GAGG;AACH,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAuBtE;AAED;;;GAGG;AACH,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAuBtE;AAMD,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAgGjB"}

package/dist/browser/cdp.js

@@ -0,0 +1,252 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { sdkLogger } from '../logger.js';
+const execFileAsync = promisify(execFile);
+const DEFAULT_CDP_URLS = [
+    'http://127.0.0.1:9222',
+    'http://localhost:9222',
+    'http://127.0.0.1:9223',
+];
+export function normalizeCdpUrl(value) {
+    let end = value.length;
+    while (end > 0 && value.charCodeAt(end - 1) === 47)
+        end--;
+    return end === value.length ? value : value.slice(0, end);
+}
+// ---------------------------------------------------------------------------
+// HTTP-based discovery (old style: --remote-debugging-port)
+// ---------------------------------------------------------------------------
+export async function fetchCdpVersionInfo(baseUrl) {
+    const url = normalizeCdpUrl(baseUrl);
+    try {
+        const resp = await fetch(`${url}/json/version`, { headers: { Host: 'localhost' } });
+        if (!resp.ok)
+            return null;
+        const info = (await resp.json());
+        if (!info.webSocketDebuggerUrl)
+            return null;
+        const ua = info['User-Agent'];
+        info.isHeadless = ua ? /headless/i.test(ua) : false;
+        return info;
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// WebSocket-based discovery (new style: chrome://inspect remote debugging UI)
+// ---------------------------------------------------------------------------
+/**
+ * Try connecting to a Chrome DevTools endpoint via direct WebSocket.
+ * Chrome's DevTools remote debugging UI (chrome://inspect/#remote-debugging)
+ * exposes CDP over WebSocket at ws://{host}:{port}/devtools/browser
+ * without the HTTP /json/version endpoint.
+ */
+export async function tryWebSocketCdp(host, port, timeoutMs = 3000) {
+    const wsUrl = `ws://${host}:${port}/devtools/browser`;
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => {
+            try {
+                ws.close();
+            }
+            catch { }
+            resolve(null);
+        }, timeoutMs);
+        let ws;
+        try {
+            ws = new WebSocket(wsUrl);
+        }
+        catch {
+            clearTimeout(timer);
+            resolve(null);
+            return;
+        }
+        ws.onopen = () => {
+            ws.send(JSON.stringify({ id: 1, method: 'Browser.getVersion' }));
+        };
+        ws.onmessage = (event) => {
+            clearTimeout(timer);
+            try {
+                const data = JSON.parse(event.data);
+                const result = data?.result;
+                if (!result?.product) {
+                    ws.close();
+                    resolve(null);
+                    return;
+                }
+                const ua = result.userAgent;
+                ws.close();
+                resolve({
+                    Browser: result.product,
+                    webSocketDebuggerUrl: wsUrl,
+                    isHeadless: ua ? /headless/i.test(ua) : false,
+                });
+            }
+            catch {
+                ws.close();
+                resolve(null);
+            }
+        };
+        ws.onerror = () => {
+            clearTimeout(timer);
+            resolve(null);
+        };
+    });
+}
+// ---------------------------------------------------------------------------
+// Port discovery
+// ---------------------------------------------------------------------------
+/**
+ * Discover Chrome processes listening on TCP ports by parsing `lsof` output.
+ * Returns ports for processes named "Google" (Chrome) on macOS/Linux.
+ */
+export async function discoverChromeListeningPorts() {
+    if (process.platform === 'win32')
+        return [];
+    try {
+        const { stdout } = await execFileAsync('lsof', ['-iTCP', '-sTCP:LISTEN', '-P', '-n'], {
+            timeout: 5000,
+        });
+        const ports = [];
+        for (const line of stdout.split('\n')) {
+            // Match Chrome processes: "Google" (macOS Chrome) or "chrome"/"chromium" (Linux)
+            if (!/^Google\s|^chrome\s|^chromium\s/i.test(line))
+                continue;
+            const portMatch = line.match(/:(\d+)\s+\(LISTEN\)/);
+            if (portMatch) {
+                ports.push(Number(portMatch[1]));
+            }
+        }
+        return [...new Set(ports)];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Discover Chrome processes launched with --remote-debugging-port flag.
+ * Returns http:// URLs for those endpoints.
+ */
+export async function discoverChromeProcessCdpUrls() {
+    if (process.platform === 'win32')
+        return [];
+    try {
+        const { stdout } = await execFileAsync('ps', ['-ax', '-o', 'command=']);
+        const urls = new Set();
+        for (const line of stdout.split('\n')) {
+            if (!/chrome|chromium|google chrome/i.test(line))
+                continue;
+            const portMatch = line.match(/--remote-debugging-port(?:=|\s+)(\d+)/);
+            if (!portMatch)
+                continue;
+            const addressMatch = line.match(/--remote-debugging-address(?:=|\s+)([^\s]+)/);
+            const host = addressMatch?.[1] && addressMatch[1] !== '0.0.0.0' ? addressMatch[1] : '127.0.0.1';
+            urls.add(`http://${host}:${portMatch[1]}`);
+        }
+        return [...urls];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Resolve a CDP endpoint URL. Tries multiple discovery strategies:
+ *
+ * 1. Explicit URL (if not 'auto')
+ * 2. WebSocket probe on Chrome listening ports (new DevTools UI style)
+ * 3. HTTP /json/version on --remote-debugging-port URLs (old style)
+ * 4. HTTP /json/version on default ports (9222, 9223)
+ *
+ * When `preferRealBrowser` is true (default), non-headless browsers are
+ * returned first. Returns the `ws://` URL for direct WebSocket connections.
+ */
+export async function resolveCdpUrl(input, options) {
+    const label = options?.loggerLabel;
+    const preferReal = options?.preferRealBrowser ?? true;
+    const normalizedInput = input?.trim();
+    // Explicit URL — resolve to ws:// if possible
+    if (normalizedInput && normalizedInput.toLowerCase() !== 'auto') {
+        const url = normalizeCdpUrl(normalizedInput);
+        if (url.startsWith('ws://') || url.startsWith('wss://'))
+            return url;
+        // Try HTTP /json/version to get the ws:// URL
+        const info = await fetchCdpVersionInfo(url);
+        if (info?.webSocketDebuggerUrl)
+            return info.webSocketDebuggerUrl;
+        // No HTTP endpoint — assume new-style DevTools UI. Build ws:// URL from the http:// URL.
+        // Don't probe via WS here to avoid triggering Chrome's permission dialog.
+        try {
+            const parsed = new URL(url);
+            return `ws://${parsed.hostname}:${parsed.port}/devtools/browser`;
+        }
+        catch {
+            return url;
+        }
+    }
+    // --- Strategy 1: Probe Chrome listening ports ---
+    // HTTP-only discovery: check /json/version on each port. This is non-intrusive
+    // and doesn't trigger Chrome's "Allow remote debugging?" permission dialog.
+    //
+    // For Chrome's new DevTools UI style (WS-only, no HTTP), we can't probe without
+    // triggering the dialog. Instead we build a ws:// candidate URL for any Chrome
+    // port that doesn't serve HTTP. The actual connection happens once in
+    // acquireBrowser() via connectOverCDP(), which is when the user clicks "Allow".
+    const listeningPorts = await discoverChromeListeningPorts();
+    const discovered = [];
+    for (const port of listeningPorts) {
+        const httpInfo = await fetchCdpVersionInfo(`http://127.0.0.1:${port}`);
+        if (httpInfo?.webSocketDebuggerUrl) {
+            discovered.push({ wsUrl: httpInfo.webSocketDebuggerUrl, info: httpInfo });
+        }
+        else {
+            // No HTTP endpoint — assume new-style DevTools UI (ws-only).
+            // Add as a candidate without probing. We mark it as non-headless because
+            // the DevTools UI checkbox is only available in the user's real Chrome.
+            discovered.push({
+                wsUrl: `ws://127.0.0.1:${port}/devtools/browser`,
+                info: {
+                    Browser: 'Chrome (DevTools UI)',
+                    webSocketDebuggerUrl: `ws://127.0.0.1:${port}/devtools/browser`,
+                    isHeadless: false,
+                },
+            });
+        }
+    }
+    // --- Strategy 2: Also check --remote-debugging-port processes + default ports ---
+    const processUrls = await discoverChromeProcessCdpUrls();
+    const extraCandidates = new Set([
+        ...processUrls,
+        ...(options?.defaultUrls ?? DEFAULT_CDP_URLS),
+    ]);
+    // Remove ports we already probed
+    const probedPorts = new Set(listeningPorts);
+    for (const candidate of extraCandidates) {
+        try {
+            const port = Number(new URL(candidate).port);
+            if (probedPorts.has(port))
+                continue;
+        }
+        catch {
+            /* ignore parse errors */
+        }
+        const info = await fetchCdpVersionInfo(candidate);
+        if (info?.webSocketDebuggerUrl) {
+            discovered.push({ wsUrl: info.webSocketDebuggerUrl, info });
+        }
+    }
+    // Pick the best: prefer real (non-headless) browsers
+    if (discovered.length > 0) {
+        const sorted = preferReal
+            ? discovered.sort((a, b) => a.info.isHeadless === b.info.isHeadless ? 0 : a.info.isHeadless ? 1 : -1)
+            : discovered;
+        const best = sorted[0];
+        if (label) {
+            sdkLogger.info({ wsUrl: best.wsUrl, browser: best.info.Browser, headless: best.info.isHeadless }, `[${label}] Auto-detected CDP endpoint`);
+        }
+        return best.wsUrl;
+    }
+    throw new Error('Could not auto-detect a Chrome DevTools endpoint.\n' +
+        'Enable remote debugging in Chrome: chrome://inspect/#remote-debugging\n' +
+        'Or start Chrome with: --remote-debugging-port=9222');
+}
+//# sourceMappingURL=cdp.js.map

package/dist/browser/cdp.js.map

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

package/dist/browser/launcher.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Browser Launcher Utility
+ * Provides Playwright-based browser automation
+ */
+import type { Env } from '../types.js';
+export interface BrowserLaunchOptions {
+    debug?: boolean;
+    trace?: boolean;
+    screenshotDir?: string;
+    stealth?: boolean;
+}
+export interface EnhancedBrowser {
+    browser: any;
+    isPlaywright: boolean;
+    screenshotDir: string;
+}
+/**
+ * Launch browser with Playwright
+ */
+export declare function launchBrowser(_env: Env, options?: BrowserLaunchOptions): Promise<EnhancedBrowser>;
+/**
+ * Capture error artifacts (screenshot, HTML, trace) when feed fails
+ */
+export declare function captureErrorArtifacts(page: any, error: Error, feedType: string, screenshotDir: string): Promise<void>;
+/**
+ * Wrap feed execution with error artifact capture
+ */
+export declare function withErrorCapture<T>(fn: () => Promise<T>, page: any, feedType: string, screenshotDir: string): Promise<T>;
+//# sourceMappingURL=launcher.d.ts.map

package/dist/browser/launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.d.ts","sourceRoot":"","sources":["../../src/browser/launcher.ts"],"names":[],"mappings":"AACA;;;GAGG;AAKH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAGvC,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,GAAG,CAAC;IACb,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAiBD;;GAEG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,GAAG,EACT,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,eAAe,CAAC,CA8E1B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,GAAG,EACT,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CA6Df;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,EAAE,GAAG,EACT,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,CAAC,CAAC,CAOZ"}