openchrome-mcp 1.7.16 → 1.8.4

package/dist/chrome/pool.d.ts

@@ -1,6 +1,7 @@
 /**
  * ChromePool - Manages multiple Chrome instances on different ports
  * to solve the CDP same-origin renderer process contention issue.
+ * Also supports profile-aware instance routing for multi-profile workflows.
  */
 import { ChromeLauncher } from './launcher';
 export interface ChromePoolConfig {
@@ -14,20 +15,34 @@ export interface PooledInstance {
     origins: Set<string>;
     tabCount: number;
     isPreExisting: boolean;
+    profileDirectory?: string;
 }
 export declare class ChromePool {
     private config;
     private instances;
+    private profileLaunchInFlight;
     constructor(config?: Partial<ChromePoolConfig>);
     /**
      * Acquire a Chrome instance that does NOT already have a tab open to the given origin.
      * If all instances have the origin, launch a new one (up to maxInstances).
      */
     acquireInstance(origin: string): Promise<PooledInstance>;
+    /**
+     * Acquire a Chrome instance running a specific profile.
+     * Returns an existing instance if one is already running this profile,
+     * otherwise launches a new Chrome process with --profile-directory.
+     * Uses in-flight deduplication to prevent concurrent launches for the same profile.
+     */
+    acquireInstanceForProfile(profileDirectory: string, origin?: string): Promise<PooledInstance>;
     /**
      * Mark that an origin is no longer using a port.
      */
     releaseInstance(port: number, origin: string): void;
+    /**
+     * Decrement tab count for a profile instance (P1-2 fix).
+     * Used when a profile worker is deleted but has no poolOrigin.
+     */
+    releaseProfileInstance(port: number): void;
     /**
      * Close all instances we launched (not pre-existing ones).
      */
@@ -40,4 +55,6 @@ export declare class ChromePool {
     private nextAvailablePort;
 }
 export declare function getChromePool(config?: Partial<ChromePoolConfig>): ChromePool;
+/** Reset the singleton — for tests only. */
+export declare function resetChromePool(): void;
 //# sourceMappingURL=pool.d.ts.map

package/dist/chrome/pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/chrome/pool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAiC,MAAM,YAAY,CAAC;AAE3E,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;CACxB;AA2CD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,SAAS,CAA0C;gBAE/C,MAAM,GAAE,OAAO,CAAC,gBAAgB,CAAM;IAIlD;;;OAGG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA6C9D;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAenD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB9B;;OAEG;IACH,YAAY,IAAI,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC;YAQrC,iBAAiB;IAoC/B,OAAO,CAAC,iBAAiB;CAW1B;AAQD,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,UAAU,CAK5E"}
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/chrome/pool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,cAAc,EAAiC,MAAM,YAAY,CAAC;AAE3E,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AA2CD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,SAAS,CAA0C;IAE3D,OAAO,CAAC,qBAAqB,CAAmD;gBAEpE,MAAM,GAAE,OAAO,CAAC,gBAAgB,CAAM;IAIlD;;;OAGG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA6C9D;;;;;OAKG;IACG,yBAAyB,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA+CnG;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAenD;;;OAGG;IACH,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAW1C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB9B;;OAEG;IACH,YAAY,IAAI,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC;YAQrC,iBAAiB;IA+C/B,OAAO,CAAC,iBAAiB;CAW1B;AAQD,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,UAAU,CAQ5E;AAED,4CAA4C;AAC5C,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/chrome/pool.js

@@ -2,6 +2,7 @@
 /**
  * ChromePool - Manages multiple Chrome instances on different ports
  * to solve the CDP same-origin renderer process contention issue.
+ * Also supports profile-aware instance routing for multi-profile workflows.
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -39,7 +40,10 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ChromePool = void 0;
 exports.getChromePool = getChromePool;
+exports.resetChromePool = resetChromePool;
 const http = __importStar(require("http"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
 const launcher_1 = require("./launcher");
 const DEFAULT_POOL_CONFIG = {
     maxInstances: 5,
@@ -81,6 +85,8 @@ async function checkDebugPort(port) {
 class ChromePool {
     config;
     instances = new Map();
+    // In-flight dedup: prevent concurrent launches for the same profile (P1-3 fix)
+    profileLaunchInFlight = new Map();
     constructor(config = {}) {
         this.config = { ...DEFAULT_POOL_CONFIG, ...config };
     }
@@ -122,6 +128,51 @@ class ChromePool {
         leastLoaded.tabCount++;
         return leastLoaded;
     }
+    /**
+     * Acquire a Chrome instance running a specific profile.
+     * Returns an existing instance if one is already running this profile,
+     * otherwise launches a new Chrome process with --profile-directory.
+     * Uses in-flight deduplication to prevent concurrent launches for the same profile.
+     */
+    async acquireInstanceForProfile(profileDirectory, origin) {
+        // 1. Find an existing instance already running this profile
+        for (const [, instance] of this.instances) {
+            if (instance.profileDirectory === profileDirectory) {
+                if (origin)
+                    instance.origins.add(origin);
+                instance.tabCount++;
+                console.error(`[ChromePool] Reusing existing instance on port ${instance.port} for profile "${profileDirectory}"`);
+                return instance;
+            }
+        }
+        // 2. Check for in-flight launch of the same profile (P1-3: race condition fix)
+        const inflight = this.profileLaunchInFlight.get(profileDirectory);
+        if (inflight) {
+            console.error(`[ChromePool] Waiting for in-flight launch of profile "${profileDirectory}"`);
+            const inst = await inflight;
+            if (origin)
+                inst.origins.add(origin);
+            inst.tabCount++;
+            return inst;
+        }
+        // 3. No instance with this profile — launch a new one
+        if (this.instances.size >= this.config.maxInstances) {
+            throw new Error(`[ChromePool] Cannot launch Chrome for profile "${profileDirectory}": ` +
+                `pool is at max capacity (${this.config.maxInstances} instances). ` +
+                `Close unused profiles first.`);
+        }
+        // Set in-flight guard before async launch
+        const launchPromise = this.launchNewInstance(profileDirectory).finally(() => {
+            this.profileLaunchInFlight.delete(profileDirectory);
+        });
+        this.profileLaunchInFlight.set(profileDirectory, launchPromise);
+        const newInstance = await launchPromise;
+        if (origin)
+            newInstance.origins.add(origin);
+        newInstance.tabCount++;
+        console.error(`[ChromePool] Launched new instance on port ${newInstance.port} for profile "${profileDirectory}"`);
+        return newInstance;
+    }
     /**
      * Mark that an origin is no longer using a port.
      */
@@ -137,6 +188,19 @@ class ChromePool {
         console.error(`[ChromePool] Released origin "${origin}" from port ${port}. ` +
             `Remaining origins: ${instance.tabCount}`);
     }
+    /**
+     * Decrement tab count for a profile instance (P1-2 fix).
+     * Used when a profile worker is deleted but has no poolOrigin.
+     */
+    releaseProfileInstance(port) {
+        const instance = this.instances.get(port);
+        if (!instance)
+            return;
+        if (instance.tabCount > 0) {
+            instance.tabCount--;
+        }
+        console.error(`[ChromePool] Released profile instance on port ${port}. Tab count: ${instance.tabCount}`);
+    }
     /**
      * Close all instances we launched (not pre-existing ones).
      */
@@ -153,6 +217,7 @@ class ChromePool {
         }
         await Promise.all(closurePromises);
         this.instances.clear();
+        this.profileLaunchInFlight.clear();
         console.error('[ChromePool] Cleanup complete.');
     }
     /**
@@ -164,12 +229,21 @@ class ChromePool {
     // ---------------------------------------------------------------------------
     // Private helpers
     // ---------------------------------------------------------------------------
-    async launchNewInstance() {
+    async launchNewInstance(profileDirectory) {
         const port = this.nextAvailablePort();
         const launcher = new launcher_1.ChromeLauncher(port);
+        // SingletonLock isolation: Chrome's SingletonLock is per --user-data-dir,
+        // NOT per --profile-directory. Two Chrome processes sharing the same
+        // --user-data-dir will conflict even with different --profile-directory.
+        // Each profile instance gets its own isolated user-data-dir.
+        const profileUserDataDir = profileDirectory
+            ? path.join(os.homedir(), '.openchrome', 'profiles', profileDirectory.replace(/[^a-zA-Z0-9_\- ]/g, '_'))
+            : undefined;
         const launchOptions = {
             port,
-            autoLaunch: this.config.autoLaunch,
+            autoLaunch: profileDirectory ? true : this.config.autoLaunch,
+            ...(profileDirectory && { profileDirectory }),
+            ...(profileUserDataDir && { userDataDir: profileUserDataDir }),
         };
         let isPreExisting = false;
         // Check if something is already on this port
@@ -189,6 +263,7 @@ class ChromePool {
             origins: new Set(),
             tabCount: 0,
             isPreExisting,
+            profileDirectory,
         };
         this.instances.set(port, pooled);
         return pooled;
@@ -214,6 +289,14 @@ function getChromePool(config) {
     if (!poolInstance) {
         poolInstance = new ChromePool(config);
     }
+    else if (config && Object.keys(config).length > 0) {
+        // P1-5: warn when config is passed to an already-initialized singleton
+        console.error('[ChromePool] Warning: getChromePool called with config after initialization; config ignored.');
+    }
     return poolInstance;
 }
+/** Reset the singleton — for tests only. */
+function resetChromePool() {
+    poolInstance = null;
+}
 //# sourceMappingURL=pool.js.map

package/dist/chrome/pool.js.map

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

package/dist/chrome/process-watchdog.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Chrome Process Watchdog — monitors Chrome process health.
+ * Detects Chrome crashes within intervalMs and emits events for recovery.
+ * Part of #347 Layer 3: Chrome Process Supervisor.
+ */
+import { EventEmitter } from 'events';
+import { ChromeLauncher } from './launcher';
+export interface ProcessWatchdogOptions {
+    /** Check interval in milliseconds. Default: 10000 (10s) */
+    intervalMs?: number;
+}
+export interface ProcessWatchdogEvents {
+    'chrome-died': {
+        pid: number;
+        timestamp: number;
+    };
+    'chrome-relaunched': {
+        pid: number;
+        timestamp: number;
+    };
+    'relaunch-failed': {
+        error: Error;
+        timestamp: number;
+    };
+    'watchdog-exhausted': {
+        count: number;
+        timestamp: number;
+    };
+}
+export declare class ChromeProcessWatchdog extends EventEmitter {
+    private timer;
+    private readonly intervalMs;
+    private readonly launcher;
+    private lastKnownPid;
+    private relaunching;
+    private cooldownUntil;
+    private relaunchCount;
+    private readonly maxRelaunchCycles;
+    constructor(launcher: ChromeLauncher, opts?: ProcessWatchdogOptions);
+    /**
+     * Start monitoring Chrome process.
+     * Timer is .unref()'d so it doesn't prevent process exit.
+     */
+    start(): void;
+    /**
+     * Stop monitoring.
+     */
+    stop(): void;
+    /**
+     * Check if Chrome process is still alive.
+     * Uses process.kill(pid, 0) — signal 0 checks existence without killing.
+     */
+    private check;
+    /**
+     * Whether the watchdog is currently running.
+     */
+    isRunning(): boolean;
+    /**
+     * Get the last known Chrome PID being monitored.
+     */
+    getLastKnownPid(): number | null;
+}
+//# sourceMappingURL=process-watchdog.d.ts.map

package/dist/chrome/process-watchdog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-watchdog.d.ts","sourceRoot":"","sources":["../../src/chrome/process-watchdog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,sBAAsB;IACrC,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,mBAAmB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,iBAAiB,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,oBAAoB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D;AAED,qBAAa,qBAAsB,SAAQ,YAAY;IACrD,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAM;gBAE5B,QAAQ,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,sBAAsB;IAMnE;;;OAGG;IACH,KAAK,IAAI,IAAI;IAWb;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;;OAGG;YACW,KAAK;IAyDnB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,eAAe,IAAI,MAAM,GAAG,IAAI;CAGjC"}

package/dist/chrome/process-watchdog.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * Chrome Process Watchdog — monitors Chrome process health.
+ * Detects Chrome crashes within intervalMs and emits events for recovery.
+ * Part of #347 Layer 3: Chrome Process Supervisor.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChromeProcessWatchdog = void 0;
+const events_1 = require("events");
+class ChromeProcessWatchdog extends events_1.EventEmitter {
+    timer = null;
+    intervalMs;
+    launcher;
+    lastKnownPid = null;
+    relaunching = false;
+    cooldownUntil = 0;
+    relaunchCount = 0;
+    maxRelaunchCycles = 10;
+    constructor(launcher, opts) {
+        super();
+        this.launcher = launcher;
+        this.intervalMs = opts?.intervalMs ?? 10000;
+    }
+    /**
+     * Start monitoring Chrome process.
+     * Timer is .unref()'d so it doesn't prevent process exit.
+     */
+    start() {
+        this.stop(); // clear any existing timer
+        this.timer = setInterval(() => {
+            this.check().catch((err) => {
+                console.error('[ProcessWatchdog] Unexpected error in check():', err);
+            });
+        }, this.intervalMs);
+        this.timer.unref();
+    }
+    /**
+     * Stop monitoring.
+     */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        // Do NOT reset relaunching — async check() may still be in-flight
+    }
+    /**
+     * Check if Chrome process is still alive.
+     * Uses process.kill(pid, 0) — signal 0 checks existence without killing.
+     */
+    async check() {
+        if (this.relaunching)
+            return; // already handling a crash
+        // Cooldown after recent relaunch to let CDPClient fully reconnect
+        if (Date.now() < this.cooldownUntil) {
+            return;
+        }
+        if (this.launcher.intentionalStop)
+            return; // Chrome was stopped intentionally — do not relaunch
+        const instance = this.launcher.getInstance();
+        if (!instance)
+            return; // Chrome not launched by us — nothing to watch
+        const pid = instance.process?.pid;
+        if (!pid)
+            return; // no PID tracked
+        this.lastKnownPid = pid;
+        try {
+            process.kill(pid, 0); // signal 0 = check existence only
+            return; // process alive
+        }
+        catch (err) {
+            if (err?.code === 'EPERM') {
+                return; // process exists but owned by another user (Windows)
+            }
+            // ESRCH = process truly dead, continue to relaunch
+        }
+        // Process is dead
+        console.error(`[ProcessWatchdog] Chrome process (PID ${pid}) is dead, attempting relaunch...`);
+        this.emit('chrome-died', { pid, timestamp: Date.now() });
+        this.relaunching = true;
+        try {
+            await this.launcher.ensureChrome({ autoLaunch: true });
+            const newInstance = this.launcher.getInstance();
+            const newPid = newInstance?.process?.pid;
+            console.error(`[ProcessWatchdog] Chrome relaunched successfully (PID ${newPid})`);
+            this.emit('chrome-relaunched', { pid: newPid ?? 0, timestamp: Date.now() });
+            this.relaunchCount++;
+            // Cooldown: skip 3 check intervals to let CDPClient reconnect
+            this.cooldownUntil = Date.now() + this.intervalMs * 3;
+            if (this.relaunchCount >= this.maxRelaunchCycles) {
+                console.error(`[ProcessWatchdog] Relaunch limit (${this.maxRelaunchCycles}) reached, stopping watchdog`);
+                this.emit('watchdog-exhausted', { count: this.relaunchCount, timestamp: Date.now() });
+                this.stop();
+            }
+        }
+        catch (error) {
+            console.error('[ProcessWatchdog] Chrome relaunch failed:', error);
+            this.emit('relaunch-failed', {
+                error: error instanceof Error ? error : new Error(String(error)),
+                timestamp: Date.now(),
+            });
+        }
+        finally {
+            this.relaunching = false;
+        }
+    }
+    /**
+     * Whether the watchdog is currently running.
+     */
+    isRunning() {
+        return this.timer !== null;
+    }
+    /**
+     * Get the last known Chrome PID being monitored.
+     */
+    getLastKnownPid() {
+        return this.lastKnownPid;
+    }
+}
+exports.ChromeProcessWatchdog = ChromeProcessWatchdog;
+//# sourceMappingURL=process-watchdog.js.map

package/dist/chrome/process-watchdog.js.map

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

package/dist/config/defaults.d.ts

@@ -52,6 +52,10 @@ export declare const DEFAULT_PAGE_CONFIG_TIMEOUT_MS = 5000;
 export declare const DEFAULT_COOKIE_CONTEXT_TIMEOUT_MS = 5000;
 /** Storage state restore timeout in milliseconds. */
 export declare const DEFAULT_STORAGE_STATE_RESTORE_TIMEOUT_MS = 10000;
+/** Storage state watchdog interval in milliseconds.
+ *  How frequently cookies and localStorage are persisted to disk.
+ *  Override with OPENCHROME_WATCHDOG_INTERVAL_MS environment variable. */
+export declare const DEFAULT_WATCHDOG_INTERVAL_MS = 30000;
 /** createTarget aggregate timeout in milliseconds. Safety net for entire tab creation chain. */
 export declare const DEFAULT_CREATE_TARGET_TIMEOUT_MS = 60000;
 /** CDP session operation timeout for direct createCDPSession calls. */
@@ -69,6 +73,18 @@ export declare const DEFAULT_CHROME_LAUNCH_TIMEOUT_MS = 60000;
  *  Must be LONGER than DEFAULT_CHROME_LAUNCH_TIMEOUT_MS (60s) to allow the launcher's
  *  own error (with stderr diagnostics) to propagate instead of a generic timeout. */
 export declare const DEFAULT_SESSION_INIT_TIMEOUT_AUTO_LAUNCH_MS = 75000;
+/** Heartbeat interval in milliseconds. How frequently the CDP connection health is probed.
+ *  Override with OPENCHROME_HEARTBEAT_INTERVAL_MS environment variable.
+ *  Lower values detect disconnects faster but increase Chrome CPU overhead. */
+export declare const DEFAULT_HEARTBEAT_INTERVAL_MS = 5000;
+/** Maximum number of reconnection attempts after a disconnect.
+ *  Override with OPENCHROME_MAX_RECONNECT_ATTEMPTS environment variable.
+ *  Set higher for long-running sessions where transient failures are expected. */
+export declare const DEFAULT_MAX_RECONNECT_ATTEMPTS = 5;
+/** Base delay between reconnection attempts in milliseconds.
+ *  Actual delay uses exponential backoff: baseDelay * 2^(attempt-1) + jitter.
+ *  Override with OPENCHROME_RECONNECT_DELAY_MS environment variable. */
+export declare const DEFAULT_RECONNECT_DELAY_MS = 1000;
 /** Heartbeat active ping timeout in milliseconds.
  *  Sends Browser.getVersion to detect half-open WebSocket connections
  *  (e.g., after macOS sleep/wake) that browser.isConnected() misses.
@@ -99,9 +115,52 @@ export declare const DEFAULT_COMPRESSION_LEVEL = "light";
 export declare const DEFAULT_VERBOSITY = "normal";
 /** Minimum response size in bytes before compression is applied. */
 export declare const COMPRESSION_MIN_BYTES = 500;
+/** Per-call timeout for CDPClient.send() in milliseconds.
+ *  Prevents a hung Chrome renderer from blocking indefinitely.
+ *  The 120s tool execution timeout is the outer safety net, but this
+ *  catches hangs at the individual CDP command level (15s). */
+export declare const DEFAULT_CDP_SEND_TIMEOUT_MS = 15000;
 /** Completion lock acquisition timeout in milliseconds.
  *  Safety net for the promise-based mutex in WorkflowEngine.
  *  If a previous lock holder's release() is never called (e.g. due to an
  *  unhandled exception outside the try/finally), this prevents permanent deadlock. */
 export declare const DEFAULT_COMPLETION_LOCK_TIMEOUT_MS = 30000;
+/** Chrome process watchdog check interval in milliseconds.
+ *  How often to verify Chrome PID is still alive.
+ *  Override with OPENCHROME_PROCESS_WATCHDOG_INTERVAL_MS environment variable. */
+export declare const DEFAULT_PROCESS_WATCHDOG_INTERVAL_MS = 10000;
+/** Per-tab renderer health probe interval in milliseconds.
+ *  How often to check idle tabs for frozen/crashed renderers.
+ *  Override with OPENCHROME_TAB_HEALTH_PROBE_INTERVAL_MS environment variable. */
+export declare const DEFAULT_TAB_HEALTH_PROBE_INTERVAL_MS = 60000;
+/** Per-tab renderer health probe timeout in milliseconds.
+ *  Maximum time to wait for a tab's page.evaluate('1') to respond. */
+export declare const DEFAULT_TAB_HEALTH_PROBE_TIMEOUT_MS = 5000;
+/** Consecutive tab probe failures before marking as unhealthy. */
+export declare const DEFAULT_TAB_UNHEALTHY_THRESHOLD = 3;
+/** Consecutive tab probe failures before auto-eviction. */
+export declare const DEFAULT_TAB_EVICTION_THRESHOLD = 5;
+/** Session state persistence debounce interval in milliseconds.
+ *  How long to wait after a session mutation before saving to disk. */
+export declare const DEFAULT_SESSION_PERSIST_DEBOUNCE_MS = 5000;
+/** Event loop monitor check interval in milliseconds. */
+export declare const DEFAULT_EVENT_LOOP_CHECK_INTERVAL_MS = 200;
+/** Event loop block warning threshold in milliseconds.
+ *  Emit warning when blocked longer than this.
+ *  Low enough to catch stalls before CDP commands time out. */
+export declare const DEFAULT_EVENT_LOOP_WARN_THRESHOLD_MS = 200;
+/** Health endpoint HTTP port. Avoids conflict with Node.js inspector (9229) and Chrome DevTools (9222).
+ *  Override with OPENCHROME_HEALTH_PORT environment variable. */
+export declare const DEFAULT_HEALTH_ENDPOINT_PORT = 9090;
+/** Idle timeout for adaptive heartbeat mode transition in milliseconds.
+ *  Switch to idle heartbeat mode after this long without tool calls. */
+export declare const DEFAULT_HEARTBEAT_IDLE_TIMEOUT_MS = 300000;
+/** Recovery mode duration in milliseconds.
+ *  How long to use fast heartbeat (1s) after reconnection before switching to active. */
+export declare const DEFAULT_HEARTBEAT_RECOVERY_DURATION_MS = 30000;
+/** Stealth navigation settle time in milliseconds.
+ *  How long to wait with no CDP attached before attaching to the page.
+ *  Turnstile challenges typically complete in 6-8 seconds.
+ *  Override with stealthSettleMs parameter on navigate tool. */
+export declare const DEFAULT_STEALTH_SETTLE_MS = 8000;
 //# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+FAA+F;AAC/F,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,sGAAsG;AACtG,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AAEtC,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB;;;CAAyC,CAAC;AAEvE,kDAAkD;AAClD,eAAO,MAAM,6BAA6B,QAAQ,CAAC;AAEnD,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;yEACyE;AACzE,eAAO,MAAM,2BAA2B,QAAQ,CAAC;AAEjD,oFAAoF;AACpF,eAAO,MAAM,6BAA6B,QAAQ,CAAC;AAEnD,+FAA+F;AAC/F,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAEhD,uGAAuG;AACvG,eAAO,MAAM,iCAAiC,QAAoB,CAAC;AAEnE,wGAAwG;AACxG,eAAO,MAAM,8BAA8B,OAAO,CAAC;AAEnD,2FAA2F;AAC3F,eAAO,MAAM,yCAAyC,OAAO,CAAC;AAE9D,6DAA6D;AAC7D,eAAO,MAAM,kCAAkC,IAAI,CAAC;AAEpD,mDAAmD;AACnD,eAAO,MAAM,8BAA8B,QAAQ,CAAC;AAEpD,qFAAqF;AACrF,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAElD,iGAAiG;AACjG,eAAO,MAAM,6BAA6B,SAAS,CAAC;AAEpD,6GAA6G;AAC7G,eAAO,MAAM,iCAAiC,SAAS,CAAC;AAExD,uFAAuF;AACvF,eAAO,MAAM,+BAA+B,QAAQ,CAAC;AAErD,uFAAuF;AACvF,eAAO,MAAM,4BAA4B,QAAQ,CAAC;AAElD,oGAAoG;AACpG,eAAO,MAAM,2BAA2B,QAAQ,CAAC;AAEjD,sEAAsE;AACtE,eAAO,MAAM,8BAA8B,OAAO,CAAC;AAEnD,wDAAwD;AACxD,eAAO,MAAM,iCAAiC,OAAO,CAAC;AAEtD,qDAAqD;AACrD,eAAO,MAAM,wCAAwC,QAAQ,CAAC;AAE9D,gGAAgG;AAChG,eAAO,MAAM,gCAAgC,QAAQ,CAAC;AAEtD,uEAAuE;AACvE,eAAO,MAAM,iCAAiC,QAAQ,CAAC;AAEvD,sFAAsF;AACtF,eAAO,MAAM,iCAAiC,SAAS,CAAC;AAExD;;gGAEgG;AAChG,eAAO,MAAM,oCAAoC,QAAQ,CAAC;AAE1D;mEACmE;AACnE,eAAO,MAAM,gCAAgC,QAAQ,CAAC;AAEtD;;qFAEqF;AACrF,eAAO,MAAM,2CAA2C,QAAQ,CAAC;AAEjE;;;;6EAI6E;AAC7E,eAAO,MAAM,iCAAiC,QAAQ,CAAC;AAEvD;;+DAE+D;AAC/D,eAAO,MAAM,mCAAmC,QAAQ,CAAC;AAEzD;;wDAEwD;AACxD,eAAO,MAAM,kCAAkC,OAAO,CAAC;AAEvD;wFACwF;AACxF,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C;yFACyF;AACzF,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAEjD,qEAAqE;AACrE,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,2EAA2E;AAC3E,eAAO,MAAM,kCAAkC,MAAM,CAAC;AAEtD,0DAA0D;AAC1D,eAAO,MAAM,yBAAyB,UAAU,CAAC;AAEjD,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAE1C,oEAAoE;AACpE,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC;;;sFAGsF;AACtF,eAAO,MAAM,kCAAkC,QAAQ,CAAC"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"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"}

package/dist/config/defaults.js

@@ -6,7 +6,8 @@
  * Update this single file instead of hunting across tools/cdp/chrome.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_COMPLETION_LOCK_TIMEOUT_MS = exports.COMPRESSION_MIN_BYTES = exports.DEFAULT_VERBOSITY = exports.DEFAULT_COMPRESSION_LEVEL = exports.DEFAULT_FILL_FORM_POLL_INTERVAL_MS = exports.DEFAULT_FILL_FORM_POLL_MS = exports.DEFAULT_FORM_SUBMIT_SETTLE_MS = exports.DEFAULT_DOM_SETTLE_DELAY_MS = exports.DEFAULT_SCREENSHOT_RACE_TIMEOUT_MS = exports.DEFAULT_CONNECT_VERIFY_STALENESS_MS = exports.DEFAULT_HEARTBEAT_PING_TIMEOUT_MS = exports.DEFAULT_SESSION_INIT_TIMEOUT_AUTO_LAUNCH_MS = exports.DEFAULT_CHROME_LAUNCH_TIMEOUT_MS = exports.DEFAULT_PUPPETEER_CONNECT_TIMEOUT_MS = exports.DEFAULT_OPERATION_GATE_TIMEOUT_MS = exports.DEFAULT_CDP_SESSION_OP_TIMEOUT_MS = exports.DEFAULT_CREATE_TARGET_TIMEOUT_MS = exports.DEFAULT_STORAGE_STATE_RESTORE_TIMEOUT_MS = exports.DEFAULT_COOKIE_CONTEXT_TIMEOUT_MS = exports.DEFAULT_PAGE_CONFIG_TIMEOUT_MS = exports.DEFAULT_NEW_PAGE_TIMEOUT_MS = exports.DEFAULT_RECONNECT_TIMEOUT_MS = exports.DEFAULT_SESSION_INIT_TIMEOUT_MS = exports.DEFAULT_TOOL_EXECUTION_TIMEOUT_MS = exports.DEFAULT_QUEUE_ITEM_TIMEOUT_MS = exports.DEFAULT_SAFE_TITLE_TIMEOUT_MS = exports.DEFAULT_COOKIE_COPY_TIMEOUT_MS = exports.DEFAULT_COOKIE_SCAN_MAX_CANDIDATES = exports.DEFAULT_COOKIE_SCAN_PER_TARGET_TIMEOUT_MS = exports.DEFAULT_COOKIE_SCAN_TIMEOUT_MS = exports.DEFAULT_MEMORY_PRESSURE_THRESHOLD = exports.DEFAULT_MAX_TARGETS_PER_WORKER = exports.DEFAULT_SCREENSHOT_TIMEOUT_MS = exports.DEFAULT_PROTOCOL_TIMEOUT_MS = exports.MAX_SEARCH_CANDIDATES = exports.DEFAULT_NAVIGATION_TIMEOUT_MS = exports.DEFAULT_VIEWPORT = exports.MAX_OUTPUT_CHARS = exports.DEFAULT_SCREENSHOT_QUALITY = void 0;
+exports.DEFAULT_SESSION_PERSIST_DEBOUNCE_MS = exports.DEFAULT_TAB_EVICTION_THRESHOLD = exports.DEFAULT_TAB_UNHEALTHY_THRESHOLD = exports.DEFAULT_TAB_HEALTH_PROBE_TIMEOUT_MS = exports.DEFAULT_TAB_HEALTH_PROBE_INTERVAL_MS = exports.DEFAULT_PROCESS_WATCHDOG_INTERVAL_MS = exports.DEFAULT_COMPLETION_LOCK_TIMEOUT_MS = exports.DEFAULT_CDP_SEND_TIMEOUT_MS = exports.COMPRESSION_MIN_BYTES = exports.DEFAULT_VERBOSITY = exports.DEFAULT_COMPRESSION_LEVEL = exports.DEFAULT_FILL_FORM_POLL_INTERVAL_MS = exports.DEFAULT_FILL_FORM_POLL_MS = exports.DEFAULT_FORM_SUBMIT_SETTLE_MS = exports.DEFAULT_DOM_SETTLE_DELAY_MS = exports.DEFAULT_SCREENSHOT_RACE_TIMEOUT_MS = exports.DEFAULT_CONNECT_VERIFY_STALENESS_MS = exports.DEFAULT_HEARTBEAT_PING_TIMEOUT_MS = exports.DEFAULT_RECONNECT_DELAY_MS = exports.DEFAULT_MAX_RECONNECT_ATTEMPTS = exports.DEFAULT_HEARTBEAT_INTERVAL_MS = exports.DEFAULT_SESSION_INIT_TIMEOUT_AUTO_LAUNCH_MS = exports.DEFAULT_CHROME_LAUNCH_TIMEOUT_MS = exports.DEFAULT_PUPPETEER_CONNECT_TIMEOUT_MS = exports.DEFAULT_OPERATION_GATE_TIMEOUT_MS = exports.DEFAULT_CDP_SESSION_OP_TIMEOUT_MS = exports.DEFAULT_CREATE_TARGET_TIMEOUT_MS = exports.DEFAULT_WATCHDOG_INTERVAL_MS = exports.DEFAULT_STORAGE_STATE_RESTORE_TIMEOUT_MS = exports.DEFAULT_COOKIE_CONTEXT_TIMEOUT_MS = exports.DEFAULT_PAGE_CONFIG_TIMEOUT_MS = exports.DEFAULT_NEW_PAGE_TIMEOUT_MS = exports.DEFAULT_RECONNECT_TIMEOUT_MS = exports.DEFAULT_SESSION_INIT_TIMEOUT_MS = exports.DEFAULT_TOOL_EXECUTION_TIMEOUT_MS = exports.DEFAULT_QUEUE_ITEM_TIMEOUT_MS = exports.DEFAULT_SAFE_TITLE_TIMEOUT_MS = exports.DEFAULT_COOKIE_COPY_TIMEOUT_MS = exports.DEFAULT_COOKIE_SCAN_MAX_CANDIDATES = exports.DEFAULT_COOKIE_SCAN_PER_TARGET_TIMEOUT_MS = exports.DEFAULT_COOKIE_SCAN_TIMEOUT_MS = exports.DEFAULT_MEMORY_PRESSURE_THRESHOLD = exports.DEFAULT_MAX_TARGETS_PER_WORKER = exports.DEFAULT_SCREENSHOT_TIMEOUT_MS = exports.DEFAULT_PROTOCOL_TIMEOUT_MS = exports.MAX_SEARCH_CANDIDATES = exports.DEFAULT_NAVIGATION_TIMEOUT_MS = exports.DEFAULT_VIEWPORT = exports.MAX_OUTPUT_CHARS = exports.DEFAULT_SCREENSHOT_QUALITY = void 0;
+exports.DEFAULT_STEALTH_SETTLE_MS = exports.DEFAULT_HEARTBEAT_RECOVERY_DURATION_MS = exports.DEFAULT_HEARTBEAT_IDLE_TIMEOUT_MS = exports.DEFAULT_HEALTH_ENDPOINT_PORT = exports.DEFAULT_EVENT_LOOP_WARN_THRESHOLD_MS = exports.DEFAULT_EVENT_LOOP_CHECK_INTERVAL_MS = void 0;
 /** WebP screenshot quality (0-100). Directly affects LLM token consumption via base64 size. */
 exports.DEFAULT_SCREENSHOT_QUALITY = 60;
 /** Maximum characters returned in page content output (read_page, DOM serializer, batch_paginate). */
@@ -52,6 +53,10 @@ exports.DEFAULT_PAGE_CONFIG_TIMEOUT_MS = 5000;
 exports.DEFAULT_COOKIE_CONTEXT_TIMEOUT_MS = 5000;
 /** Storage state restore timeout in milliseconds. */
 exports.DEFAULT_STORAGE_STATE_RESTORE_TIMEOUT_MS = 10000;
+/** Storage state watchdog interval in milliseconds.
+ *  How frequently cookies and localStorage are persisted to disk.
+ *  Override with OPENCHROME_WATCHDOG_INTERVAL_MS environment variable. */
+exports.DEFAULT_WATCHDOG_INTERVAL_MS = 30000;
 /** createTarget aggregate timeout in milliseconds. Safety net for entire tab creation chain. */
 exports.DEFAULT_CREATE_TARGET_TIMEOUT_MS = 60000;
 /** CDP session operation timeout for direct createCDPSession calls. */
@@ -69,6 +74,18 @@ exports.DEFAULT_CHROME_LAUNCH_TIMEOUT_MS = 60000;
  *  Must be LONGER than DEFAULT_CHROME_LAUNCH_TIMEOUT_MS (60s) to allow the launcher's
  *  own error (with stderr diagnostics) to propagate instead of a generic timeout. */
 exports.DEFAULT_SESSION_INIT_TIMEOUT_AUTO_LAUNCH_MS = 75000;
+/** Heartbeat interval in milliseconds. How frequently the CDP connection health is probed.
+ *  Override with OPENCHROME_HEARTBEAT_INTERVAL_MS environment variable.
+ *  Lower values detect disconnects faster but increase Chrome CPU overhead. */
+exports.DEFAULT_HEARTBEAT_INTERVAL_MS = 5000;
+/** Maximum number of reconnection attempts after a disconnect.
+ *  Override with OPENCHROME_MAX_RECONNECT_ATTEMPTS environment variable.
+ *  Set higher for long-running sessions where transient failures are expected. */
+exports.DEFAULT_MAX_RECONNECT_ATTEMPTS = 5;
+/** Base delay between reconnection attempts in milliseconds.
+ *  Actual delay uses exponential backoff: baseDelay * 2^(attempt-1) + jitter.
+ *  Override with OPENCHROME_RECONNECT_DELAY_MS environment variable. */
+exports.DEFAULT_RECONNECT_DELAY_MS = 1000;
 /** Heartbeat active ping timeout in milliseconds.
  *  Sends Browser.getVersion to detect half-open WebSocket connections
  *  (e.g., after macOS sleep/wake) that browser.isConnected() misses.
@@ -99,9 +116,53 @@ exports.DEFAULT_COMPRESSION_LEVEL = 'light';
 exports.DEFAULT_VERBOSITY = 'normal';
 /** Minimum response size in bytes before compression is applied. */
 exports.COMPRESSION_MIN_BYTES = 500;
+/** Per-call timeout for CDPClient.send() in milliseconds.
+ *  Prevents a hung Chrome renderer from blocking indefinitely.
+ *  The 120s tool execution timeout is the outer safety net, but this
+ *  catches hangs at the individual CDP command level (15s). */
+exports.DEFAULT_CDP_SEND_TIMEOUT_MS = 15000;
 /** Completion lock acquisition timeout in milliseconds.
  *  Safety net for the promise-based mutex in WorkflowEngine.
  *  If a previous lock holder's release() is never called (e.g. due to an
  *  unhandled exception outside the try/finally), this prevents permanent deadlock. */
 exports.DEFAULT_COMPLETION_LOCK_TIMEOUT_MS = 30000;
+// ─── Self-Healing Architecture (#347) ──────────────────────────────────────
+/** Chrome process watchdog check interval in milliseconds.
+ *  How often to verify Chrome PID is still alive.
+ *  Override with OPENCHROME_PROCESS_WATCHDOG_INTERVAL_MS environment variable. */
+exports.DEFAULT_PROCESS_WATCHDOG_INTERVAL_MS = 10000;
+/** Per-tab renderer health probe interval in milliseconds.
+ *  How often to check idle tabs for frozen/crashed renderers.
+ *  Override with OPENCHROME_TAB_HEALTH_PROBE_INTERVAL_MS environment variable. */
+exports.DEFAULT_TAB_HEALTH_PROBE_INTERVAL_MS = 60000;
+/** Per-tab renderer health probe timeout in milliseconds.
+ *  Maximum time to wait for a tab's page.evaluate('1') to respond. */
+exports.DEFAULT_TAB_HEALTH_PROBE_TIMEOUT_MS = 5000;
+/** Consecutive tab probe failures before marking as unhealthy. */
+exports.DEFAULT_TAB_UNHEALTHY_THRESHOLD = 3;
+/** Consecutive tab probe failures before auto-eviction. */
+exports.DEFAULT_TAB_EVICTION_THRESHOLD = 5;
+/** Session state persistence debounce interval in milliseconds.
+ *  How long to wait after a session mutation before saving to disk. */
+exports.DEFAULT_SESSION_PERSIST_DEBOUNCE_MS = 5000;
+/** Event loop monitor check interval in milliseconds. */
+exports.DEFAULT_EVENT_LOOP_CHECK_INTERVAL_MS = 200;
+/** Event loop block warning threshold in milliseconds.
+ *  Emit warning when blocked longer than this.
+ *  Low enough to catch stalls before CDP commands time out. */
+exports.DEFAULT_EVENT_LOOP_WARN_THRESHOLD_MS = 200;
+/** Health endpoint HTTP port. Avoids conflict with Node.js inspector (9229) and Chrome DevTools (9222).
+ *  Override with OPENCHROME_HEALTH_PORT environment variable. */
+exports.DEFAULT_HEALTH_ENDPOINT_PORT = 9090;
+/** Idle timeout for adaptive heartbeat mode transition in milliseconds.
+ *  Switch to idle heartbeat mode after this long without tool calls. */
+exports.DEFAULT_HEARTBEAT_IDLE_TIMEOUT_MS = 300000;
+/** Recovery mode duration in milliseconds.
+ *  How long to use fast heartbeat (1s) after reconnection before switching to active. */
+exports.DEFAULT_HEARTBEAT_RECOVERY_DURATION_MS = 30000;
+/** Stealth navigation settle time in milliseconds.
+ *  How long to wait with no CDP attached before attaching to the page.
+ *  Turnstile challenges typically complete in 6-8 seconds.
+ *  Override with stealthSettleMs parameter on navigate tool. */
+exports.DEFAULT_STEALTH_SETTLE_MS = 8000;
 //# sourceMappingURL=defaults.js.map