openchrome-mcp 1.7.16 → 1.8.4

package/dist/cdp/client.d.ts

@@ -30,6 +30,7 @@ export declare class CDPClient {
     private targetDestroyedListeners;
     private reconnectAttempts;
     private consecutiveHeartbeatFailures;
+    private consecutiveHeartbeatSuccesses;
     private checkConnectionInFlight;
     private autoLaunch;
     private cookieSourceCache;
@@ -40,6 +41,12 @@ export declare class CDPClient {
     private pendingConnect;
     /** Timestamp of last successful connection verification (heartbeat or active probe). */
     private lastVerifiedAt;
+    private heartbeatMode;
+    private lastCommandAt;
+    private heartbeatModeTimer;
+    private reconnectCount;
+    private pingLatencies;
+    private static readonly MAX_PING_SAMPLES;
     private static readonly COOKIE_CACHE_TTL;
     constructor(options?: CDPClientOptions);
     /**
@@ -78,6 +85,33 @@ export declare class CDPClient {
      * Stop heartbeat monitoring
      */
     private stopHeartbeat;
+    /**
+     * Set heartbeat mode. Restarts the heartbeat timer with the new interval.
+     */
+    setHeartbeatMode(mode: 'idle' | 'active' | 'heavy' | 'recovery'): void;
+    /**
+     * Get effective heartbeat interval based on current mode.
+     */
+    private getEffectiveHeartbeatInterval;
+    /**
+     * Record that a command was executed (for idle detection).
+     */
+    recordCommandActivity(): void;
+    /**
+     * Get current heartbeat mode.
+     */
+    getHeartbeatMode(): 'idle' | 'active' | 'heavy' | 'recovery';
+    /**
+     * Get connection health metrics.
+     */
+    getConnectionMetrics(): {
+        msSinceLastVerified: number;
+        reconnectCount: number;
+        avgPingLatencyMs: number;
+        heartbeatMode: string;
+        consecutiveSuccesses: number;
+        lastVerifiedAt: number;
+    };
     /**
      * Check connection health.
      * Sends an active CDP probe (Browser.getVersion) to detect half-open WebSocket
@@ -206,7 +240,8 @@ export declare class CDPClient {
      */
     getCDPSession(page: Page): Promise<CDPSession>;
     /**
-     * Execute CDP command on a page
+     * Execute CDP command on a page.
+     * Wrapped with per-call timeout to prevent hung renderers from blocking indefinitely.
      */
     send<T = unknown>(page: Page, method: string, params?: Record<string, unknown>): Promise<T>;
     /**

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

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

package/dist/cdp/client.js

@@ -49,6 +49,18 @@ const smart_goto_1 = require("../utils/smart-goto");
 const puppeteer_helpers_1 = require("../utils/puppeteer-helpers");
 const ref_id_manager_1 = require("../utils/ref-id-manager");
 const defaults_1 = require("../config/defaults");
+const with_timeout_1 = require("../utils/with-timeout");
+function parseEnvInt(name, fallback) {
+    const raw = process.env[name];
+    if (raw === undefined)
+        return fallback;
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        console.error(`[CDPClient] Invalid value for ${name}="${raw}", using default ${fallback}`);
+        return fallback;
+    }
+    return parsed;
+}
 class CDPClient {
     browser = null;
     sessions = new Map();
@@ -62,6 +74,7 @@ class CDPClient {
     targetDestroyedListeners = [];
     reconnectAttempts = 0;
     consecutiveHeartbeatFailures = 0;
+    consecutiveHeartbeatSuccesses = 0;
     checkConnectionInFlight = false;
     autoLaunch;
     cookieSourceCache = new Map();
@@ -72,13 +85,21 @@ class CDPClient {
     pendingConnect = null;
     /** Timestamp of last successful connection verification (heartbeat or active probe). */
     lastVerifiedAt = 0;
+    // Adaptive heartbeat state
+    heartbeatMode = 'active';
+    lastCommandAt = 0;
+    heartbeatModeTimer = null;
+    // Connection health metrics
+    reconnectCount = 0;
+    pingLatencies = []; // rolling window
+    static MAX_PING_SAMPLES = 60; // ~5 min at 5s interval
     static COOKIE_CACHE_TTL = 300000; // 5 minutes
     constructor(options = {}) {
         const globalConfig = (0, global_1.getGlobalConfig)();
         this.port = options.port || globalConfig.port;
-        this.maxReconnectAttempts = options.maxReconnectAttempts || 3;
-        this.reconnectDelayMs = options.reconnectDelayMs || 1000;
-        this.heartbeatIntervalMs = options.heartbeatIntervalMs || 5000;
+        this.maxReconnectAttempts = options.maxReconnectAttempts ?? parseEnvInt('OPENCHROME_MAX_RECONNECT_ATTEMPTS', defaults_1.DEFAULT_MAX_RECONNECT_ATTEMPTS);
+        this.reconnectDelayMs = options.reconnectDelayMs ?? parseEnvInt('OPENCHROME_RECONNECT_DELAY_MS', defaults_1.DEFAULT_RECONNECT_DELAY_MS);
+        this.heartbeatIntervalMs = options.heartbeatIntervalMs ?? parseEnvInt('OPENCHROME_HEARTBEAT_INTERVAL_MS', defaults_1.DEFAULT_HEARTBEAT_INTERVAL_MS);
         // Use explicit option if provided, otherwise use global config
         this.autoLaunch = options.autoLaunch !== undefined ? options.autoLaunch : globalConfig.autoLaunch;
     }
@@ -181,8 +202,15 @@ class CDPClient {
                 });
                 return;
             }
+            // Check for idle transition: no commands for 5 minutes → switch to idle mode
+            if ((this.heartbeatMode === 'active' || this.heartbeatMode === 'heavy')
+                && this.lastCommandAt > 0
+                && now - this.lastCommandAt > 300000) {
+                this.setHeartbeatMode('idle');
+                return; // setHeartbeatMode restarts the timer with new interval
+            }
             this.checkConnection();
-        }, this.heartbeatIntervalMs);
+        }, this.getEffectiveHeartbeatInterval());
     }
     /**
      * Stop heartbeat monitoring
@@ -193,6 +221,76 @@ class CDPClient {
             this.heartbeatTimer = null;
         }
     }
+    /**
+     * Set heartbeat mode. Restarts the heartbeat timer with the new interval.
+     */
+    setHeartbeatMode(mode) {
+        if (this.heartbeatMode === mode)
+            return;
+        const oldMode = this.heartbeatMode;
+        this.heartbeatMode = mode;
+        console.error(`[CDPClient] Heartbeat mode: ${oldMode} → ${mode} (interval: ${this.getEffectiveHeartbeatInterval()}ms)`);
+        // Restart heartbeat with new interval
+        if (this.heartbeatTimer) {
+            this.startHeartbeat();
+        }
+        // Auto-transition from recovery to active after 30s
+        if (this.heartbeatModeTimer) {
+            clearTimeout(this.heartbeatModeTimer);
+            this.heartbeatModeTimer = null;
+        }
+        if (mode === 'recovery') {
+            this.heartbeatModeTimer = setTimeout(() => {
+                this.heartbeatModeTimer = null;
+                if (this.heartbeatMode === 'recovery') {
+                    this.setHeartbeatMode('active');
+                }
+            }, 30000);
+            this.heartbeatModeTimer.unref();
+        }
+    }
+    /**
+     * Get effective heartbeat interval based on current mode.
+     */
+    getEffectiveHeartbeatInterval() {
+        switch (this.heartbeatMode) {
+            case 'idle': return Math.max(this.heartbeatIntervalMs * 3, 15000); // 3x base or 15s min
+            case 'active': return this.heartbeatIntervalMs; // default (5s)
+            case 'heavy': return Math.max(Math.floor(this.heartbeatIntervalMs / 2), 2000); // half or 2s min
+            case 'recovery': return 1000; // 1s fixed during recovery
+        }
+    }
+    /**
+     * Record that a command was executed (for idle detection).
+     */
+    recordCommandActivity() {
+        this.lastCommandAt = Date.now();
+        if (this.heartbeatMode === 'idle') {
+            this.setHeartbeatMode('active');
+        }
+    }
+    /**
+     * Get current heartbeat mode.
+     */
+    getHeartbeatMode() {
+        return this.heartbeatMode;
+    }
+    /**
+     * Get connection health metrics.
+     */
+    getConnectionMetrics() {
+        const avgLatency = this.pingLatencies.length > 0
+            ? Math.round(this.pingLatencies.reduce((a, b) => a + b, 0) / this.pingLatencies.length)
+            : 0;
+        return {
+            msSinceLastVerified: this.lastVerifiedAt > 0 ? Date.now() - this.lastVerifiedAt : 0,
+            reconnectCount: this.reconnectCount,
+            avgPingLatencyMs: avgLatency,
+            heartbeatMode: this.heartbeatMode,
+            consecutiveSuccesses: this.consecutiveHeartbeatSuccesses,
+            lastVerifiedAt: this.lastVerifiedAt,
+        };
+    }
     /**
      * Check connection health.
      * Sends an active CDP probe (Browser.getVersion) to detect half-open WebSocket
@@ -215,6 +313,7 @@ class CDPClient {
             // Active probe: round-trip CDP command to detect dead WebSocket connections.
             // browser.isConnected() only checks a local flag — half-open TCP connections
             // (macOS sleep/wake, Chrome crash) pass the flag check but hang on real commands.
+            const pingStart = Date.now();
             let pingTid;
             await Promise.race([
                 this.browser.version().finally(() => clearTimeout(pingTid)),
@@ -223,10 +322,17 @@ class CDPClient {
                 }),
             ]);
             this.lastVerifiedAt = Date.now();
+            const pingLatency = Date.now() - pingStart;
+            this.pingLatencies.push(pingLatency);
+            if (this.pingLatencies.length > CDPClient.MAX_PING_SAMPLES) {
+                this.pingLatencies.shift();
+            }
+            this.consecutiveHeartbeatSuccesses++;
             this.consecutiveHeartbeatFailures = 0;
             return true;
         }
         catch (error) {
+            this.consecutiveHeartbeatSuccesses = 0;
             this.consecutiveHeartbeatFailures++;
             if (this.consecutiveHeartbeatFailures < 2) {
                 // First failure: warn but don't disconnect. Chrome may be under heavy load.
@@ -256,6 +362,11 @@ class CDPClient {
             type: 'disconnected',
             timestamp: Date.now(),
         });
+        // Clear heartbeat mode timer to prevent 30s recovery timer from leaking
+        if (this.heartbeatModeTimer) {
+            clearTimeout(this.heartbeatModeTimer);
+            this.heartbeatModeTimer = null;
+        }
         // Clear existing sessions and stale state
         this.sessions.clear();
         this.targetIdIndex.clear();
@@ -275,6 +386,10 @@ class CDPClient {
         while (this.reconnectAttempts < this.maxReconnectAttempts) {
             this.reconnectAttempts++;
             console.error(`[CDPClient] Reconnect attempt ${this.reconnectAttempts}/${this.maxReconnectAttempts}...`);
+            // Invalidate launcher cache at start of each attempt so ensureChrome()
+            // re-probes Chrome's HTTP endpoint to discover the new WebSocket UUID
+            // after a relaunch by the process watchdog
+            (0, launcher_1.getChromeLauncher)(this.port).invalidateInstance();
             this.emitConnectionEvent({
                 type: 'reconnecting',
                 timestamp: Date.now(),
@@ -284,6 +399,8 @@ class CDPClient {
                 await this.connectInternal({ autoLaunch: false });
                 console.error('[CDPClient] Reconnection successful');
                 this.reconnectAttempts = 0;
+                this.reconnectCount++;
+                this.setHeartbeatMode('recovery');
                 this.emitConnectionEvent({
                     type: 'reconnected',
                     timestamp: Date.now(),
@@ -293,7 +410,10 @@ class CDPClient {
             catch (error) {
                 console.error(`[CDPClient] Reconnect attempt ${this.reconnectAttempts} failed:`, error);
                 if (this.reconnectAttempts < this.maxReconnectAttempts) {
-                    await new Promise(resolve => setTimeout(resolve, this.reconnectDelayMs));
+                    // Exponential backoff with jitter: baseDelay * 2^(attempt-1) + random(0..baseDelay/2)
+                    const backoffDelay = Math.min(this.reconnectDelayMs * Math.pow(2, this.reconnectAttempts - 1) + Math.floor(Math.random() * this.reconnectDelayMs / 2), 30000);
+                    console.error(`[CDPClient] Waiting ${backoffDelay}ms before next attempt (exponential backoff)...`);
+                    await new Promise(resolve => setTimeout(resolve, backoffDelay));
                 }
             }
         }
@@ -514,6 +634,10 @@ class CDPClient {
         // Invalidate any in-flight connect() — we're replacing the connection entirely
         this.pendingConnect = null;
         this.stopHeartbeat();
+        if (this.heartbeatModeTimer) {
+            clearTimeout(this.heartbeatModeTimer);
+            this.heartbeatModeTimer = null;
+        }
         if (this.browser) {
             try {
                 this.browser.removeAllListeners('disconnected');
@@ -556,6 +680,10 @@ class CDPClient {
      */
     async disconnect() {
         this.stopHeartbeat();
+        if (this.heartbeatModeTimer) {
+            clearTimeout(this.heartbeatModeTimer);
+            this.heartbeatModeTimer = null;
+        }
         if (this.browser) {
             try {
                 this.browser.removeAllListeners('disconnected');
@@ -980,7 +1108,7 @@ class CDPClient {
      * @param settleMs Milliseconds to wait before attaching CDP (default 5000, range 1000-30000)
      * @returns        The Puppeteer Page and its targetId
      */
-    async createTargetStealth(url, settleMs = 5000) {
+    async createTargetStealth(url, settleMs = 8000) {
         const browser = this.getBrowser();
         // Step 1: Create target via CDP Target.createTarget.
         // Puppeteer's ChromeTargetManager uses Target.setAutoAttach with { exclude: true }
@@ -998,6 +1126,16 @@ class CDPClient {
             throw new Error(`Stealth navigation: failed to create target: ${createErr instanceof Error ? createErr.message : String(createErr)}`);
         }
         console.error(`[CDPClient] Stealth tab created: ${targetId}, settling for ${settleMs}ms`);
+        // Warn if headless — Turnstile detection is nearly guaranteed in headless mode
+        try {
+            const version = await browser.version();
+            if (version.toLowerCase().includes('headless')) {
+                console.error('[CDPClient] WARNING: Stealth mode in headless Chrome is unlikely to bypass Turnstile. Use headed Chrome (--visible) for anti-bot pages.');
+            }
+        }
+        catch {
+            // Version check failed — continue
+        }
         // Step 2: Wait for the page to load without CDP observation (Turnstile runs here)
         await new Promise(resolve => setTimeout(resolve, settleMs));
         // Step 3: Attach to the target via CDP to bring it into Puppeteer's attached set
@@ -1101,6 +1239,37 @@ class CDPClient {
                     configurable: true,
                 });
             }
+            // 6. window dimensions — headless Chrome returns 0
+            if (window.outerWidth === 0) {
+                Object.defineProperty(window, 'outerWidth', { get: () => window.innerWidth, configurable: true });
+            }
+            if (window.outerHeight === 0) {
+                Object.defineProperty(window, 'outerHeight', { get: () => window.innerHeight + 85, configurable: true });
+            }
+            // 7. navigator.mimeTypes — headless has 0 mimeTypes
+            if (navigator.mimeTypes.length === 0) {
+                Object.defineProperty(navigator, 'mimeTypes', {
+                    get: () => {
+                        const mt = typeof MimeTypeArray !== 'undefined' ? Object.create(MimeTypeArray.prototype) : [];
+                        mt[0] = { type: 'application/pdf', suffixes: 'pdf', description: 'Portable Document Format' };
+                        Object.defineProperty(mt, 'length', { value: 1 });
+                        mt.item = (i) => mt[i] || null;
+                        mt.namedItem = (name) => name === 'application/pdf' ? mt[0] : null;
+                        return mt;
+                    },
+                    configurable: true,
+                });
+            }
+            // 8. chrome.app and chrome.loadTimes stubs
+            if (window.chrome) {
+                const c = window.chrome;
+                if (!c.app) {
+                    c.app = { isInstalled: false, getDetails: () => null, getIsInstalled: () => false, installState: () => 'disabled' };
+                }
+                if (!c.loadTimes) {
+                    c.loadTimes = () => ({});
+                }
+            }
         }).catch(() => { });
         console.error(`[CDPClient] Stealth tab ${targetId} attached after settle period`);
         return { page, targetId };
@@ -1216,6 +1385,40 @@ class CDPClient {
                 });
             }
         }).catch(() => { });
+        // Defense 4: window dimensions + chrome stubs (anti-headless, #361)
+        page.evaluateOnNewDocument(() => {
+            // outerWidth/outerHeight — headless Chrome returns 0
+            if (window.outerWidth === 0) {
+                Object.defineProperty(window, 'outerWidth', { get: () => window.innerWidth, configurable: true });
+            }
+            if (window.outerHeight === 0) {
+                Object.defineProperty(window, 'outerHeight', { get: () => window.innerHeight + 85, configurable: true });
+            }
+            // navigator.mimeTypes — headless has 0 mimeTypes
+            if (navigator.mimeTypes.length === 0) {
+                Object.defineProperty(navigator, 'mimeTypes', {
+                    get: () => {
+                        const mt = typeof MimeTypeArray !== 'undefined' ? Object.create(MimeTypeArray.prototype) : [];
+                        mt[0] = { type: 'application/pdf', suffixes: 'pdf', description: 'Portable Document Format' };
+                        Object.defineProperty(mt, 'length', { value: 1 });
+                        mt.item = (i) => mt[i] || null;
+                        mt.namedItem = (name) => name === 'application/pdf' ? mt[0] : null;
+                        return mt;
+                    },
+                    configurable: true,
+                });
+            }
+            // chrome.app and chrome.loadTimes stubs
+            if (window.chrome) {
+                const c = window.chrome;
+                if (!c.app) {
+                    c.app = { isInstalled: false, getDetails: () => null, getIsInstalled: () => false, installState: () => 'disabled' };
+                }
+                if (!c.loadTimes) {
+                    c.loadTimes = () => ({});
+                }
+            }
+        }).catch(() => { });
         // Deny file downloads by default — Content-Disposition: attachment
         // responses block the navigation promise indefinitely.
         this.send(page, 'Page.setDownloadBehavior', { behavior: 'deny' }).catch(() => { });
@@ -1310,11 +1513,12 @@ class CDPClient {
         return session;
     }
     /**
-     * Execute CDP command on a page
+     * Execute CDP command on a page.
+     * Wrapped with per-call timeout to prevent hung renderers from blocking indefinitely.
      */
     async send(page, method, params) {
         const session = await this.getCDPSession(page);
-        return session.send(method, params);
+        return (0, with_timeout_1.withTimeout)(session.send(method, params), defaults_1.DEFAULT_CDP_SEND_TIMEOUT_MS, `CDP ${method}`);
     }
     /**
      * Get all targets