claude-chrome-parallel 1.0.0

package/dist/cdp/screenshot-scheduler.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Screenshot Scheduler - Concurrency-controlled screenshot pipeline
+ *
+ * Prevents GPU/renderer contention when multiple tabs request
+ * screenshots simultaneously. Without this, 20 concurrent screenshot
+ * requests serialize through Chrome's renderer, causing 185s+ timeouts.
+ *
+ * Performance impact: 20 concurrent screenshots from 4000ms to ~800ms
+ */
+import { Page } from 'puppeteer-core';
+import { CDPClient } from './client';
+export interface ScreenshotOptions {
+    format?: 'webp' | 'png' | 'jpeg';
+    quality?: number;
+    fullPage?: boolean;
+    clip?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        scale?: number;
+    };
+    optimizeForSpeed?: boolean;
+}
+export interface ScreenshotResult {
+    data: string;
+    durationMs: number;
+    waitMs: number;
+}
+export interface SchedulerStats {
+    pending: number;
+    active: number;
+    completed: number;
+    totalWaitMs: number;
+    totalCaptureMs: number;
+    concurrency: number;
+}
+export declare class ScreenshotScheduler {
+    private readonly concurrency;
+    private active;
+    private queue;
+    private completed;
+    private totalWaitMs;
+    private totalCaptureMs;
+    constructor(concurrency?: number);
+    /**
+     * Capture a screenshot with concurrency control.
+     * Queues the request if too many are already in flight.
+     */
+    capture(page: Page, cdpClient: CDPClient, options?: ScreenshotOptions): Promise<ScreenshotResult>;
+    getStats(): SchedulerStats;
+}
+export declare function getScreenshotScheduler(): ScreenshotScheduler;
+//# sourceMappingURL=screenshot-scheduler.d.ts.map

package/dist/cdp/screenshot-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot-scheduler.d.ts","sourceRoot":"","sources":["../../src/cdp/screenshot-scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/E,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,mBAAmB;IAQ5B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAP9B,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,cAAc,CAAK;gBAGR,WAAW,GAAE,MAAU;IAG1C;;;OAGG;IACG,OAAO,CACX,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,SAAS,EACpB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC;IAmD5B,QAAQ,IAAI,cAAc;CAU3B;AAKD,wBAAgB,sBAAsB,IAAI,mBAAmB,CAM5D"}

package/dist/cdp/screenshot-scheduler.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * Screenshot Scheduler - Concurrency-controlled screenshot pipeline
+ *
+ * Prevents GPU/renderer contention when multiple tabs request
+ * screenshots simultaneously. Without this, 20 concurrent screenshot
+ * requests serialize through Chrome's renderer, causing 185s+ timeouts.
+ *
+ * Performance impact: 20 concurrent screenshots from 4000ms to ~800ms
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScreenshotScheduler = void 0;
+exports.getScreenshotScheduler = getScreenshotScheduler;
+class ScreenshotScheduler {
+    concurrency;
+    active = 0;
+    queue = [];
+    completed = 0;
+    totalWaitMs = 0;
+    totalCaptureMs = 0;
+    constructor(concurrency = 5) {
+        this.concurrency = concurrency;
+    }
+    /**
+     * Capture a screenshot with concurrency control.
+     * Queues the request if too many are already in flight.
+     */
+    async capture(page, cdpClient, options = {}) {
+        const queuedAt = Date.now();
+        // Wait for a slot if at capacity
+        if (this.active >= this.concurrency) {
+            await new Promise((resolve) => this.queue.push(resolve));
+        }
+        this.active++;
+        const waitMs = Date.now() - queuedAt;
+        const captureStart = Date.now();
+        try {
+            const format = options.format || 'webp';
+            const quality = options.quality ?? 60;
+            const params = {
+                format,
+                quality,
+                optimizeForSpeed: options.optimizeForSpeed ?? true,
+            };
+            if (options.clip) {
+                params.clip = options.clip;
+            }
+            if (options.fullPage) {
+                params.captureBeyondViewport = true;
+            }
+            const { data } = await cdpClient.send(page, 'Page.captureScreenshot', params);
+            const durationMs = Date.now() - captureStart;
+            this.completed++;
+            this.totalWaitMs += waitMs;
+            this.totalCaptureMs += durationMs;
+            return { data, durationMs, waitMs };
+        }
+        finally {
+            this.active--;
+            if (this.queue.length > 0) {
+                const next = this.queue.shift();
+                next();
+            }
+        }
+    }
+    getStats() {
+        return {
+            pending: this.queue.length,
+            active: this.active,
+            completed: this.completed,
+            totalWaitMs: this.totalWaitMs,
+            totalCaptureMs: this.totalCaptureMs,
+            concurrency: this.concurrency,
+        };
+    }
+}
+exports.ScreenshotScheduler = ScreenshotScheduler;
+// Singleton instance
+let schedulerInstance = null;
+function getScreenshotScheduler() {
+    if (!schedulerInstance) {
+        const concurrency = parseInt(process.env.SCREENSHOT_CONCURRENCY || '5', 10);
+        schedulerInstance = new ScreenshotScheduler(concurrency);
+    }
+    return schedulerInstance;
+}
+//# sourceMappingURL=screenshot-scheduler.js.map

package/dist/cdp/screenshot-scheduler.js.map

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

package/dist/chrome/launcher.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Chrome Launcher - Manages Chrome process with remote debugging
+ */
+import { ChildProcess } from 'child_process';
+export interface ChromeInstance {
+    wsEndpoint: string;
+    httpEndpoint: string;
+    process?: ChildProcess;
+    userDataDir?: string;
+}
+export interface LaunchOptions {
+    port?: number;
+    userDataDir?: string;
+    headless?: boolean;
+    /** If false, don't auto-launch Chrome when not running (default: false) */
+    autoLaunch?: boolean;
+    /** If true, force using a temp directory instead of real Chrome profile */
+    useTempProfile?: boolean;
+}
+export declare class ChromeLauncher {
+    private instance;
+    private port;
+    private usingRealProfile;
+    constructor(port?: number);
+    /**
+     * Ensure Chrome with remote debugging is available
+     */
+    ensureChrome(options?: LaunchOptions): Promise<ChromeInstance>;
+    /**
+     * Get debug endpoint URL
+     */
+    getDebugEndpoint(): Promise<string>;
+    /**
+     * Get WebSocket endpoint
+     */
+    getWsEndpoint(): Promise<string>;
+    /**
+     * Close Chrome instance (only if we launched it)
+     */
+    close(): Promise<void>;
+    /**
+     * Check if connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get the real Chrome profile directory for the current platform
+     */
+    private getRealChromeProfileDir;
+    /**
+     * Check if a Chrome profile directory is locked by another Chrome instance
+     */
+    private isProfileLocked;
+}
+export declare function getChromeLauncher(port?: number): ChromeLauncher;
+//# sourceMappingURL=launcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.d.ts","sourceRoot":"","sources":["../../src/chrome/launcher.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAS,YAAY,EAAY,MAAM,eAAe,CAAC;AAO9D,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AA0HD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,gBAAgB,CAAS;gBAErB,IAAI,GAAE,MAAqB;IAIvC;;OAEG;IACG,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;IAuJxE;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAOzC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAOtC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAkB/B;;OAEG;IACH,OAAO,CAAC,eAAe;CAiBxB;AAKD,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,CAK/D"}

package/dist/chrome/launcher.js

@@ -0,0 +1,383 @@
+"use strict";
+/**
+ * Chrome Launcher - Manages Chrome process with remote debugging
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChromeLauncher = void 0;
+exports.getChromeLauncher = getChromeLauncher;
+const child_process_1 = require("child_process");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const http = __importStar(require("http"));
+const global_1 = require("../config/global");
+const DEFAULT_PORT = 9222;
+/**
+ * Find Chrome executable path based on platform
+ */
+function findChromePath() {
+    const platform = os.platform();
+    if (platform === 'win32') {
+        const paths = [
+            process.env['PROGRAMFILES(X86)'] + '\\Google\\Chrome\\Application\\chrome.exe',
+            process.env['PROGRAMFILES'] + '\\Google\\Chrome\\Application\\chrome.exe',
+            process.env['LOCALAPPDATA'] + '\\Google\\Chrome\\Application\\chrome.exe',
+        ];
+        for (const p of paths) {
+            if (fs.existsSync(p))
+                return p;
+        }
+    }
+    else if (platform === 'darwin') {
+        const paths = [
+            '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+            '/Applications/Chromium.app/Contents/MacOS/Chromium',
+        ];
+        for (const p of paths) {
+            if (fs.existsSync(p))
+                return p;
+        }
+    }
+    else {
+        // Linux
+        try {
+            return (0, child_process_1.execSync)('which google-chrome || which chromium-browser || which chromium', {
+                encoding: 'utf8',
+            }).trim();
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+/**
+ * Find chrome-headless-shell binary
+ */
+function findChromeHeadlessShell() {
+    // Check environment variable first
+    const envPath = process.env['CHROME_HEADLESS_SHELL'];
+    if (envPath && fs.existsSync(envPath)) {
+        return envPath;
+    }
+    // Check PATH using which (Linux/Mac) or where (Windows)
+    const platform = os.platform();
+    try {
+        const cmd = platform === 'win32'
+            ? 'where chrome-headless-shell'
+            : 'which chrome-headless-shell';
+        const result = (0, child_process_1.execSync)(cmd, { encoding: 'utf8' }).trim();
+        if (result && fs.existsSync(result)) {
+            return result;
+        }
+    }
+    catch {
+        // Not found in PATH
+    }
+    return null;
+}
+/**
+ * Check if Chrome debug port is already available
+ */
+async function checkDebugPort(port) {
+    return new Promise((resolve) => {
+        const req = http.request({
+            hostname: '127.0.0.1',
+            port,
+            path: '/json/version',
+            method: 'GET',
+            timeout: 2000,
+        }, (res) => {
+            let data = '';
+            res.on('data', (chunk) => (data += chunk));
+            res.on('end', () => {
+                try {
+                    const json = JSON.parse(data);
+                    resolve(json.webSocketDebuggerUrl || null);
+                }
+                catch {
+                    resolve(null);
+                }
+            });
+        });
+        req.on('error', () => resolve(null));
+        req.on('timeout', () => {
+            req.destroy();
+            resolve(null);
+        });
+        req.end();
+    });
+}
+/**
+ * Wait for debug port to become available
+ */
+async function waitForDebugPort(port, timeout = 30000) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeout) {
+        const wsEndpoint = await checkDebugPort(port);
+        if (wsEndpoint) {
+            return wsEndpoint;
+        }
+        await new Promise((r) => setTimeout(r, 500));
+    }
+    throw new Error(`Chrome debug port ${port} not available after ${timeout}ms`);
+}
+class ChromeLauncher {
+    instance = null;
+    port;
+    usingRealProfile = false;
+    constructor(port = DEFAULT_PORT) {
+        this.port = port;
+    }
+    /**
+     * Ensure Chrome with remote debugging is available
+     */
+    async ensureChrome(options = {}) {
+        const port = options.port || this.port;
+        // Check if already connected and instance is still valid
+        if (this.instance) {
+            // Verify the cached instance is still valid by checking the debug port
+            const currentWs = await checkDebugPort(port);
+            if (currentWs && currentWs === this.instance.wsEndpoint) {
+                return this.instance;
+            }
+            // Instance is stale, clear it
+            console.error('[ChromeLauncher] Cached instance is stale, refreshing...');
+            this.instance = null;
+        }
+        // Check if Chrome is already running with debug port
+        const existingWs = await checkDebugPort(port);
+        if (existingWs) {
+            console.error(`[ChromeLauncher] Found existing Chrome on port ${port}`);
+            this.instance = {
+                wsEndpoint: existingWs,
+                httpEndpoint: `http://127.0.0.1:${port}`,
+            };
+            return this.instance;
+        }
+        // If autoLaunch is false (default), don't start Chrome automatically
+        if (!options.autoLaunch) {
+            throw new Error(`Chrome is not running with remote debugging on port ${port}.\n\n` +
+                `Please start Chrome manually with:\n` +
+                `  chrome --remote-debugging-port=${port}\n\n` +
+                `Or use --auto-launch flag to start Chrome automatically.`);
+        }
+        // Launch new Chrome instance
+        console.error(`[ChromeLauncher] Launching Chrome with debug port ${port}...`);
+        const globalConfig = (0, global_1.getGlobalConfig)();
+        // Resolve Chrome binary: explicit override > headless-shell > standard Chrome
+        let chromePath = null;
+        let usingHeadlessShell = false;
+        if (globalConfig.chromeBinary) {
+            chromePath = globalConfig.chromeBinary;
+            console.error(`[ChromeLauncher] Using custom Chrome binary: ${chromePath}`);
+        }
+        else if (globalConfig.useHeadlessShell) {
+            chromePath = findChromeHeadlessShell();
+            if (chromePath) {
+                usingHeadlessShell = true;
+                console.error(`[ChromeLauncher] Using chrome-headless-shell: ${chromePath}`);
+            }
+            else {
+                console.error('[ChromeLauncher] chrome-headless-shell not found, falling back to standard Chrome');
+                chromePath = findChromePath();
+            }
+        }
+        else {
+            chromePath = findChromePath();
+        }
+        if (!chromePath) {
+            throw new Error('Chrome not found. Please install Google Chrome or set CHROME_PATH environment variable.');
+        }
+        // Determine user data directory:
+        // 1. Explicit option from CLI/config/global
+        // 2. Real Chrome profile (macOS: ~/Library/Application Support/Google/Chrome)
+        //    (skipped when using headless-shell, which doesn't support extensions)
+        // 3. Fallback to temp directory
+        let userDataDir = options.userDataDir || globalConfig.userDataDir;
+        let usingRealProfile = false;
+        if (!userDataDir && !options.useTempProfile && !usingHeadlessShell) {
+            const realProfileDir = this.getRealChromeProfileDir();
+            if (realProfileDir && !this.isProfileLocked(realProfileDir)) {
+                userDataDir = realProfileDir;
+                usingRealProfile = true;
+                this.usingRealProfile = true;
+                console.error(`[ChromeLauncher] Using real Chrome profile: ${realProfileDir}`);
+            }
+        }
+        if (!userDataDir) {
+            userDataDir = path.join(os.tmpdir(), `claude-chrome-parallel-${Date.now()}`);
+            this.usingRealProfile = false;
+            console.error(`[ChromeLauncher] Using temp profile: ${userDataDir}`);
+        }
+        fs.mkdirSync(userDataDir, { recursive: true });
+        const args = [
+            `--remote-debugging-port=${port}`,
+            `--user-data-dir=${userDataDir}`,
+            '--no-first-run',
+            '--no-default-browser-check',
+            // IMPORTANT: Start maximized for proper debugging experience
+            '--start-maximized',
+            // Fallback window size if maximize doesn't work
+            '--window-size=1920,1080',
+            // Memory-saving flags (applies to all profile types)
+            '--disable-gpu',
+            '--disable-dev-shm-usage',
+            '--renderer-process-limit=16',
+            '--js-flags=--max-old-space-size=1024',
+            '--disable-backgrounding-occluded-windows',
+            '--disable-ipc-flooding-protection',
+        ];
+        // Only disable background features for temp profiles
+        if (!usingRealProfile) {
+            args.push('--disable-background-networking', '--disable-sync', '--disable-translate', '--metrics-recording-only', '--disable-extensions', '--disable-component-extensions-with-background-pages', '--disable-default-apps');
+        }
+        if (options.headless) {
+            args.push('--headless=new');
+            // For headless, set explicit window size
+            args.push('--window-size=1920,1080');
+        }
+        const chromeProcess = (0, child_process_1.spawn)(chromePath, args, {
+            detached: true,
+            stdio: ['ignore', 'ignore', 'ignore'],
+        });
+        chromeProcess.unref();
+        // Wait for debug port
+        const wsEndpoint = await waitForDebugPort(port);
+        this.instance = {
+            wsEndpoint,
+            httpEndpoint: `http://127.0.0.1:${port}`,
+            process: chromeProcess,
+            userDataDir,
+        };
+        console.error(`[ChromeLauncher] Chrome ready at ${wsEndpoint}`);
+        return this.instance;
+    }
+    /**
+     * Get debug endpoint URL
+     */
+    async getDebugEndpoint() {
+        if (!this.instance) {
+            await this.ensureChrome();
+        }
+        return this.instance.httpEndpoint;
+    }
+    /**
+     * Get WebSocket endpoint
+     */
+    async getWsEndpoint() {
+        if (!this.instance) {
+            await this.ensureChrome();
+        }
+        return this.instance.wsEndpoint;
+    }
+    /**
+     * Close Chrome instance (only if we launched it)
+     */
+    async close() {
+        if (this.instance?.process) {
+            console.error('[ChromeLauncher] Closing Chrome...');
+            this.instance.process.kill();
+            // Clean up user data dir (only if using temp profile, never delete real profile)
+            if (this.instance.userDataDir && !this.usingRealProfile) {
+                try {
+                    fs.rmSync(this.instance.userDataDir, { recursive: true, force: true });
+                }
+                catch {
+                    // Ignore cleanup errors
+                }
+            }
+        }
+        this.instance = null;
+    }
+    /**
+     * Check if connected
+     */
+    isConnected() {
+        return this.instance !== null;
+    }
+    /**
+     * Get the real Chrome profile directory for the current platform
+     */
+    getRealChromeProfileDir() {
+        const platform = os.platform();
+        const home = os.homedir();
+        if (platform === 'darwin') {
+            const profileDir = path.join(home, 'Library', 'Application Support', 'Google', 'Chrome');
+            if (fs.existsSync(profileDir))
+                return profileDir;
+        }
+        else if (platform === 'win32') {
+            const profileDir = path.join(home, 'AppData', 'Local', 'Google', 'Chrome', 'User Data');
+            if (fs.existsSync(profileDir))
+                return profileDir;
+        }
+        else {
+            const profileDir = path.join(home, '.config', 'google-chrome');
+            if (fs.existsSync(profileDir))
+                return profileDir;
+        }
+        return null;
+    }
+    /**
+     * Check if a Chrome profile directory is locked by another Chrome instance
+     */
+    isProfileLocked(profileDir) {
+        // Chrome uses a "SingletonLock" file (Linux) or "lockfile" to prevent concurrent access
+        const lockFiles = [
+            path.join(profileDir, 'SingletonLock'),
+            path.join(profileDir, 'SingletonSocket'),
+            path.join(profileDir, 'SingletonCookie'),
+        ];
+        for (const lockFile of lockFiles) {
+            if (fs.existsSync(lockFile)) {
+                console.error(`[ChromeLauncher] Profile locked: ${lockFile} exists`);
+                return true;
+            }
+        }
+        return false;
+    }
+}
+exports.ChromeLauncher = ChromeLauncher;
+// Singleton instance
+let launcherInstance = null;
+function getChromeLauncher(port) {
+    if (!launcherInstance) {
+        launcherInstance = new ChromeLauncher(port);
+    }
+    return launcherInstance;
+}
+//# sourceMappingURL=launcher.js.map

package/dist/chrome/launcher.js.map

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

package/dist/chrome/pool.d.ts

@@ -0,0 +1,54 @@
+/**
+ * ChromePool - Manages multiple Chrome instances on different ports
+ * to solve the CDP same-origin renderer process contention issue.
+ */
+import { ChromeLauncher } from './launcher';
+export interface ChromePoolConfig {
+    maxInstances: number;
+    basePort: number;
+    autoLaunch: boolean;
+}
+export interface PooledInstance {
+    port: number;
+    launcher: ChromeLauncher;
+    origins: Set<string>;
+    tabCount: number;
+    isPreExisting: boolean;
+}
+export declare class ChromePool {
+    private config;
+    private instances;
+    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>;
+    /**
+     * Mark that an origin is no longer using a port.
+     */
+    releaseInstance(port: number, origin: string): void;
+    /**
+     * Get the current instance assignment for an origin.
+     * Returns the first instance that has this origin registered, or null.
+     */
+    getInstanceForOrigin(origin: string): PooledInstance | null;
+    /**
+     * Copy cookies between two Chrome instances for a given domain.
+     * Uses CDP Network.getAllCookies / Network.setCookies via WebSocket.
+     * This is a best-effort operation; failures are logged but not thrown.
+     */
+    copyCookiesBetweenInstances(sourcePort: number, destPort: number, domain: string): Promise<void>;
+    /**
+     * Close all instances we launched (not pre-existing ones).
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Get all current pool instances (read-only snapshot).
+     */
+    getInstances(): ReadonlyMap<number, PooledInstance>;
+    private launchNewInstance;
+    private nextAvailablePort;
+}
+export declare function getChromePool(config?: Partial<ChromePoolConfig>): ChromePool;
+//# sourceMappingURL=pool.d.ts.map

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

@@ -0,0 +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;AAkFD,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;;;OAGG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAS3D;;;;OAIG;IACG,2BAA2B,CAC/B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IA4ChB;;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"}