claude-chrome-parallel 2.1.1 → 2.2.0

package/README.md

@@ -149,6 +149,19 @@ All sessions work without conflicts!
 | `javascript_tool` | Execute JavaScript |
 | `tabs_context_mcp` | Get available tabs |
 | `tabs_create_mcp` | Create new tab |
+| `network` | Simulate network conditions (3G, 4G, offline, custom) |
+
+### Network Simulation
+
+Test how your app behaves under different network conditions:
+
+```
+You: Simulate 3G network and navigate to myapp.com
+
+Claude: [Applies 3G throttling: 1.5Mbps down, 750Kbps up, 100ms latency]
+```
+
+Available presets: `offline`, `slow-2g`, `2g`, `3g`, `4g`, `fast-wifi`, `custom`, `clear`
 
 ---
 
@@ -196,6 +209,15 @@ claude-chrome-parallel serve --port 9223
 
 # Check installation health
 claude-chrome-parallel doctor
+
+# View session status and statistics
+claude-chrome-parallel status
+
+# View status as JSON (for automation)
+claude-chrome-parallel status --json
+
+# Clean up stale sessions and old backups
+claude-chrome-parallel cleanup --max-age 24 --keep-backups 10
 ```
 
 ---
@@ -259,6 +281,9 @@ claude-chrome-parallel recover --list-backups
 | Connection type | Shared extension state | Independent CDP |
 | Max concurrent sessions | 1 | 20+ tested |
 | Auto Chrome launch | ❌ | ✅ |
+| Network simulation | ❌ | ✅ 3G/4G/offline presets |
+| Session auto-cleanup | ❌ | ✅ TTL-based |
+| Connection pooling | ❌ | ✅ Pre-warmed pages |
 
 ---
 

package/dist/cdp/connection-pool.d.ts

@@ -0,0 +1,88 @@
+/**
+ * CDP Connection Pool - Pre-allocate and manage page instances for faster session creation
+ */
+import { Page } from 'puppeteer-core';
+import { CDPClient } from './client';
+export interface PoolConfig {
+    /** Minimum number of pre-allocated pages to keep ready (default: 2) */
+    minPoolSize?: number;
+    /** Maximum number of pre-allocated pages (default: 10) */
+    maxPoolSize?: number;
+    /** Page idle timeout in ms before returning to pool (default: 5 minutes) */
+    pageIdleTimeout?: number;
+    /** Whether to pre-warm pages on startup (default: true) */
+    preWarm?: boolean;
+}
+export interface PoolStats {
+    /** Number of pages currently in the pool (ready to use) */
+    availablePages: number;
+    /** Number of pages currently in use */
+    inUsePages: number;
+    /** Total pages created since pool initialization */
+    totalPagesCreated: number;
+    /** Number of pages reused from pool */
+    pagesReused: number;
+    /** Number of pages created on-demand (pool was empty) */
+    pagesCreatedOnDemand: number;
+    /** Average time to acquire a page (ms) */
+    avgAcquireTimeMs: number;
+}
+export declare class CDPConnectionPool {
+    private cdpClient;
+    private config;
+    private availablePages;
+    private inUsePages;
+    private maintenanceTimer;
+    private isInitialized;
+    private totalPagesCreated;
+    private pagesReused;
+    private pagesCreatedOnDemand;
+    private acquireTimes;
+    constructor(cdpClient?: CDPClient, config?: PoolConfig);
+    /**
+     * Initialize the pool with pre-warmed pages
+     */
+    initialize(): Promise<void>;
+    /**
+     * Acquire a page from the pool
+     */
+    acquirePage(): Promise<Page>;
+    /**
+     * Release a page back to the pool
+     */
+    releasePage(page: Page): Promise<void>;
+    /**
+     * Create a new page
+     */
+    private createNewPage;
+    /**
+     * Ensure minimum number of pages in pool
+     */
+    private ensureMinimumPages;
+    /**
+     * Replenish pool asynchronously
+     */
+    private replenishPoolAsync;
+    /**
+     * Perform maintenance on the pool
+     */
+    private performMaintenance;
+    /**
+     * Get pool statistics
+     */
+    getStats(): PoolStats;
+    /**
+     * Get current configuration
+     */
+    getConfig(): Required<PoolConfig>;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<PoolConfig>): void;
+    /**
+     * Shutdown the pool
+     */
+    shutdown(): Promise<void>;
+}
+export declare function getCDPConnectionPool(config?: PoolConfig): CDPConnectionPool;
+//# sourceMappingURL=connection-pool.d.ts.map

package/dist/cdp/connection-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-pool.d.ts","sourceRoot":"","sources":["../../src/cdp/connection-pool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,SAAS,EAAgB,MAAM,UAAU,CAAC;AAEnD,MAAM,WAAW,UAAU;IACzB,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,0CAA0C;IAC1C,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAeD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,cAAc,CAAoB;IAC1C,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,aAAa,CAAS;IAG9B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,YAAY,CAAgB;gBAExB,SAAS,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,UAAU;IAKtD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBjC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IA2ClC;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAmD5C;;OAEG;YACW,aAAa;IAM3B;;OAEG;YACW,kBAAkB;IAsBhC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;OAEG;YACW,kBAAkB;IAiChC;;OAEG;IACH,QAAQ,IAAI,SAAS;IAgBrB;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,UAAU,CAAC;IAIjC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI;IAI/C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA6BhC;AAKD,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,iBAAiB,CAK3E"}

package/dist/cdp/connection-pool.js

@@ -0,0 +1,280 @@
+"use strict";
+/**
+ * CDP Connection Pool - Pre-allocate and manage page instances for faster session creation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CDPConnectionPool = void 0;
+exports.getCDPConnectionPool = getCDPConnectionPool;
+const client_1 = require("./client");
+const DEFAULT_CONFIG = {
+    minPoolSize: 2,
+    maxPoolSize: 10,
+    pageIdleTimeout: 5 * 60 * 1000, // 5 minutes
+    preWarm: true,
+};
+class CDPConnectionPool {
+    cdpClient;
+    config;
+    availablePages = [];
+    inUsePages = new Map();
+    maintenanceTimer = null;
+    isInitialized = false;
+    // Stats
+    totalPagesCreated = 0;
+    pagesReused = 0;
+    pagesCreatedOnDemand = 0;
+    acquireTimes = [];
+    constructor(cdpClient, config) {
+        this.cdpClient = cdpClient || (0, client_1.getCDPClient)();
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Initialize the pool with pre-warmed pages
+     */
+    async initialize() {
+        if (this.isInitialized)
+            return;
+        await this.cdpClient.connect();
+        if (this.config.preWarm) {
+            console.error(`[Pool] Pre-warming ${this.config.minPoolSize} pages...`);
+            await this.ensureMinimumPages();
+        }
+        // Start maintenance timer
+        this.maintenanceTimer = setInterval(() => {
+            this.performMaintenance();
+        }, 30000); // Every 30 seconds
+        this.maintenanceTimer.unref();
+        this.isInitialized = true;
+        console.error('[Pool] Connection pool initialized');
+    }
+    /**
+     * Acquire a page from the pool
+     */
+    async acquirePage() {
+        const startTime = Date.now();
+        // Ensure initialized
+        if (!this.isInitialized) {
+            await this.initialize();
+        }
+        let page;
+        let pooledPage;
+        // Try to get from pool
+        if (this.availablePages.length > 0) {
+            pooledPage = this.availablePages.pop();
+            page = pooledPage.page;
+            pooledPage.lastUsedAt = Date.now();
+            this.pagesReused++;
+        }
+        else {
+            // Create new page on demand
+            page = await this.createNewPage();
+            pooledPage = {
+                page,
+                createdAt: Date.now(),
+                lastUsedAt: Date.now(),
+            };
+            this.pagesCreatedOnDemand++;
+        }
+        this.inUsePages.set(page, pooledPage);
+        // Track acquire time
+        const acquireTime = Date.now() - startTime;
+        this.acquireTimes.push(acquireTime);
+        if (this.acquireTimes.length > 100) {
+            this.acquireTimes.shift();
+        }
+        // Replenish pool in background if needed
+        this.replenishPoolAsync();
+        return page;
+    }
+    /**
+     * Release a page back to the pool
+     */
+    async releasePage(page) {
+        const pooledPage = this.inUsePages.get(page);
+        if (!pooledPage) {
+            // Page not managed by this pool, just close it
+            try {
+                await page.close();
+            }
+            catch {
+                // Ignore close errors
+            }
+            return;
+        }
+        this.inUsePages.delete(page);
+        // Check if pool is at max capacity
+        if (this.availablePages.length >= this.config.maxPoolSize) {
+            // Close the page instead of returning to pool
+            try {
+                await page.close();
+            }
+            catch {
+                // Ignore close errors
+            }
+            return;
+        }
+        // Reset the page state before returning to pool
+        try {
+            // Navigate to blank page to clear state
+            await page.goto('about:blank', { waitUntil: 'domcontentloaded', timeout: 5000 });
+            // Clear cookies and storage
+            const client = await page.createCDPSession();
+            await client.send('Network.clearBrowserCookies');
+            await client.send('Storage.clearDataForOrigin', {
+                origin: '*',
+                storageTypes: 'all',
+            }).catch(() => { }); // Ignore if not supported
+            await client.detach();
+            pooledPage.lastUsedAt = Date.now();
+            this.availablePages.push(pooledPage);
+        }
+        catch {
+            // Failed to reset, close the page
+            try {
+                await page.close();
+            }
+            catch {
+                // Ignore close errors
+            }
+        }
+    }
+    /**
+     * Create a new page
+     */
+    async createNewPage() {
+        const page = await this.cdpClient.createPage();
+        this.totalPagesCreated++;
+        return page;
+    }
+    /**
+     * Ensure minimum number of pages in pool
+     */
+    async ensureMinimumPages() {
+        const pagesToCreate = this.config.minPoolSize - this.availablePages.length;
+        if (pagesToCreate <= 0)
+            return;
+        const promises = [];
+        for (let i = 0; i < pagesToCreate; i++) {
+            promises.push(this.createNewPage().then((page) => {
+                this.availablePages.push({
+                    page,
+                    createdAt: Date.now(),
+                    lastUsedAt: Date.now(),
+                });
+            }).catch((err) => {
+                console.error('[Pool] Failed to pre-warm page:', err);
+            }));
+        }
+        await Promise.all(promises);
+    }
+    /**
+     * Replenish pool asynchronously
+     */
+    replenishPoolAsync() {
+        if (this.availablePages.length < this.config.minPoolSize) {
+            this.ensureMinimumPages().catch((err) => {
+                console.error('[Pool] Failed to replenish pool:', err);
+            });
+        }
+    }
+    /**
+     * Perform maintenance on the pool
+     */
+    async performMaintenance() {
+        const now = Date.now();
+        const pagesToRemove = [];
+        // Find pages that have been idle too long
+        for (const pooledPage of this.availablePages) {
+            const idleTime = now - pooledPage.lastUsedAt;
+            if (idleTime > this.config.pageIdleTimeout &&
+                this.availablePages.length > this.config.minPoolSize) {
+                pagesToRemove.push(pooledPage);
+            }
+        }
+        // Remove idle pages
+        for (const pooledPage of pagesToRemove) {
+            const index = this.availablePages.indexOf(pooledPage);
+            if (index !== -1) {
+                this.availablePages.splice(index, 1);
+                try {
+                    await pooledPage.page.close();
+                }
+                catch {
+                    // Ignore close errors
+                }
+            }
+        }
+        if (pagesToRemove.length > 0) {
+            console.error(`[Pool] Maintenance: closed ${pagesToRemove.length} idle page(s)`);
+        }
+    }
+    /**
+     * Get pool statistics
+     */
+    getStats() {
+        const avgAcquireTime = this.acquireTimes.length > 0
+            ? this.acquireTimes.reduce((a, b) => a + b, 0) / this.acquireTimes.length
+            : 0;
+        return {
+            availablePages: this.availablePages.length,
+            inUsePages: this.inUsePages.size,
+            totalPagesCreated: this.totalPagesCreated,
+            pagesReused: this.pagesReused,
+            pagesCreatedOnDemand: this.pagesCreatedOnDemand,
+            avgAcquireTimeMs: Math.round(avgAcquireTime * 100) / 100,
+        };
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    /**
+     * Shutdown the pool
+     */
+    async shutdown() {
+        if (this.maintenanceTimer) {
+            clearInterval(this.maintenanceTimer);
+            this.maintenanceTimer = null;
+        }
+        // Close all available pages
+        for (const pooledPage of this.availablePages) {
+            try {
+                await pooledPage.page.close();
+            }
+            catch {
+                // Ignore close errors
+            }
+        }
+        this.availablePages = [];
+        // Close all in-use pages
+        for (const [page] of this.inUsePages) {
+            try {
+                await page.close();
+            }
+            catch {
+                // Ignore close errors
+            }
+        }
+        this.inUsePages.clear();
+        this.isInitialized = false;
+        console.error('[Pool] Connection pool shutdown');
+    }
+}
+exports.CDPConnectionPool = CDPConnectionPool;
+// Singleton instance
+let poolInstance = null;
+function getCDPConnectionPool(config) {
+    if (!poolInstance) {
+        poolInstance = new CDPConnectionPool(undefined, config);
+    }
+    return poolInstance;
+}
+//# sourceMappingURL=connection-pool.js.map

package/dist/cdp/connection-pool.js.map

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

package/dist/cli/index.js

@@ -354,6 +354,134 @@ program
     console.log('⚠️ Could not recover - created new empty config');
     console.log('Your corrupted file has been backed up');
 });
+program
+    .command('status')
+    .description('Show session manager status and statistics')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+    const sessionsDir = getSessionsDir();
+    const backupDir = path.join(os.homedir(), '.claude-chrome-parallel', 'backups');
+    const configPath = path.join(os.homedir(), '.claude.json');
+    // Gather statistics
+    let activeSessions = 0;
+    let totalSessionsSize = 0;
+    const sessionDetails = [];
+    if (fs.existsSync(sessionsDir)) {
+        const entries = fs.readdirSync(sessionsDir, { withFileTypes: true });
+        const now = Date.now();
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const sessionDir = path.join(sessionsDir, entry.name);
+            const metadataPath = path.join(sessionDir, '.session-metadata.json');
+            activeSessions++;
+            const size = getDirSize(sessionDir);
+            totalSessionsSize += size;
+            let age = 'unknown';
+            if (fs.existsSync(metadataPath)) {
+                try {
+                    const metadata = JSON.parse(fs.readFileSync(metadataPath, 'utf8'));
+                    const createdAt = new Date(metadata.createdAt).getTime();
+                    age = formatDuration(now - createdAt);
+                }
+                catch {
+                    // ignore
+                }
+            }
+            sessionDetails.push({
+                id: entry.name,
+                age,
+                size: formatBytes(size),
+            });
+        }
+    }
+    // Count backups
+    let backupCount = 0;
+    let backupSize = 0;
+    if (fs.existsSync(backupDir)) {
+        const backups = fs.readdirSync(backupDir).filter(f => f.startsWith('.claude.json.'));
+        backupCount = backups.length;
+        for (const backup of backups) {
+            const stats = fs.statSync(path.join(backupDir, backup));
+            backupSize += stats.size;
+        }
+    }
+    // Check config health
+    let configHealthy = true;
+    let configError = '';
+    if (fs.existsSync(configPath)) {
+        const content = fs.readFileSync(configPath, 'utf8');
+        if (!isValidJson(content)) {
+            configHealthy = false;
+            configError = 'Invalid JSON (corrupted)';
+        }
+    }
+    // Memory usage
+    const memUsage = process.memoryUsage();
+    const status = {
+        sessions: {
+            active: activeSessions,
+            totalSize: formatBytes(totalSessionsSize),
+            details: sessionDetails,
+        },
+        backups: {
+            count: backupCount,
+            totalSize: formatBytes(backupSize),
+        },
+        config: {
+            healthy: configHealthy,
+            error: configError || undefined,
+        },
+        memory: {
+            heapUsed: formatBytes(memUsage.heapUsed),
+            heapTotal: formatBytes(memUsage.heapTotal),
+            rss: formatBytes(memUsage.rss),
+        },
+    };
+    if (options.json) {
+        console.log(JSON.stringify(status, null, 2));
+        return;
+    }
+    // Pretty print
+    console.log('Claude Chrome Parallel Status');
+    console.log('═'.repeat(40));
+    console.log();
+    // Sessions
+    console.log('Sessions');
+    console.log('─'.repeat(20));
+    console.log(`  Active: ${activeSessions}`);
+    console.log(`  Total Size: ${formatBytes(totalSessionsSize)}`);
+    if (sessionDetails.length > 0) {
+        console.log('  Details:');
+        for (const s of sessionDetails) {
+            console.log(`    - ${s.id} (${s.age}, ${s.size})`);
+        }
+    }
+    console.log();
+    // Backups
+    console.log('Backups');
+    console.log('─'.repeat(20));
+    console.log(`  Count: ${backupCount}`);
+    console.log(`  Total Size: ${formatBytes(backupSize)}`);
+    console.log();
+    // Config
+    console.log('Config Health');
+    console.log('─'.repeat(20));
+    if (configHealthy) {
+        console.log('  ✅ .claude.json is healthy');
+    }
+    else {
+        console.log(`  ❌ .claude.json: ${configError}`);
+        console.log('     Run: claude-chrome-parallel recover');
+    }
+    console.log();
+    // Memory
+    console.log('Memory');
+    console.log('─'.repeat(20));
+    console.log(`  Heap Used: ${formatBytes(memUsage.heapUsed)}`);
+    console.log(`  Heap Total: ${formatBytes(memUsage.heapTotal)}`);
+    console.log(`  RSS: ${formatBytes(memUsage.rss)}`);
+});
 program
     .command('cleanup')
     .description('Clean up stale sessions and old backups')
@@ -506,6 +634,44 @@ function formatBytes(bytes) {
     const i = Math.floor(Math.log(bytes) / Math.log(k));
     return parseFloat((bytes / Math.pow(k, i)).toFixed(1)) + ' ' + sizes[i];
 }
+/**
+ * Format duration in milliseconds as human readable string
+ */
+function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (days > 0)
+        return `${days}d ${hours % 24}h`;
+    if (hours > 0)
+        return `${hours}h ${minutes % 60}m`;
+    if (minutes > 0)
+        return `${minutes}m ${seconds % 60}s`;
+    return `${seconds}s`;
+}
+/**
+ * Get total size of a directory recursively
+ */
+function getDirSize(dirPath) {
+    let totalSize = 0;
+    try {
+        const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dirPath, entry.name);
+            if (entry.isDirectory()) {
+                totalSize += getDirSize(fullPath);
+            }
+            else if (entry.isFile()) {
+                totalSize += fs.statSync(fullPath).size;
+            }
+        }
+    }
+    catch {
+        // Permission denied or other errors
+    }
+    return totalSize;
+}
 /**
  * Attempt to recover valid JSON from corrupted content
  */