claude-chrome-parallel 3.4.0 → 3.4.2

package/README.md

@@ -1,4 +1,4 @@
-# Claude Chrome Parallel
+# Claude Chrome Parallel (CCP)
 
 > **Ultrafast parallel browser MCP.**
 
@@ -37,7 +37,16 @@ CCP (parallel, zero auth):
 
 ## Why CCP Is Fast
 
-The speed advantage **compounds** with every site. Playwright MCP has two bottlenecks that multiply:
+This is not a speed optimization. It's a **structural change**.
+
+```
+Playwright MCP:  [blank browser] → login → task → close  (repeat per site)
+CCP:             [your Chrome]   → task                   (already logged in)
+```
+
+Playwright creates a new browser per site. Each one needs: navigate → type email → type password → solve 2FA → wait for redirect. That's 30-120s per site, and it's sequential. **You're spending 95% of the time on authentication, not the actual task.**
+
+CCP connects to your existing Chrome via CDP. You're already logged in to everything. Workers run in parallel. The speed advantage **compounds** with every site:
 
 | Sites | Playwright MCP | CCP | Speedup |
 |:-----:|:--------------:|:---:|:-------:|
@@ -46,16 +55,18 @@ The speed advantage **compounds** with every site. Playwright MCP has two bottle
 | 5 | ~250s | ~3s | **80x** |
 | 10 | ~500s | ~3s | **160x** |
 
-**Why?** Playwright launches a blank browser per site. Each needs: navigate → type email → type password → solve 2FA → wait for redirect. That's 30-120s **per site**, and it's **sequential**.
-
-CCP connects to your existing Chrome. You're already logged into everything. Workers run in parallel. The task that takes 250s with Playwright takes 3s with CCP.
-
 ### Memory
 
 Playwright spawns a **separate browser process** per session (~500MB each). Five sites = 2.5GB.
 
 CCP uses **one Chrome** with lightweight browser contexts (like incognito windows sharing the same process). Five Workers = ~300MB total. That's **8x less memory** — and it stays flat whether you run 5 or 20 Workers.
 
+### Bot Detection Immunity
+
+Playwright runs headless browsers with detectable fingerprints. Cloudflare, reCAPTCHA, and anti-bot systems can flag them.
+
+CCP uses **your actual Chrome** — real fingerprint, real cookies, real browsing history. It's indistinguishable from you clicking around manually, because it literally is your browser.
+
 ---
 
 ## Core Features
@@ -168,54 +179,84 @@ Claude: [3 Workers, 3 sites, simultaneously]
 
 ## What You Can Do
 
-### Multi-Account Operations
+### 20-Site Parallel Crawling
 
 ```
-You: ccp check my personal and work Gmail at the same time
-
-Claude: [Creates 2 isolated Workers]
-        Personal account: 3 unread emails
-        Work account: 7 unread emails
-        Time: 2.1s (parallel)
+You: ccp crawl these 20 competitor sites and extract their pricing
+
+Claude: [20 Workers, 20 sites, simultaneously — all in your logged-in Chrome]
+        site-01:  $49/mo  ✓  (1.2s)
+        site-02:  $59/mo  ✓  (0.9s)
+        ...
+        site-20:  $39/mo  ✓  (1.4s)
+        Total: 2.8s | Sequential: ~60s | Speedup: 21x
 ```
 
-### Price Comparison Across Sites
+Each Worker runs in an isolated browser context. One Chrome process, 20 parallel sessions, ~300MB total. Not 20 separate browsers eating 10GB of RAM.
 
-```
-You: ccp find the cheapest iPhone 15 on Amazon, eBay, and Walmart
+### Multi-Cloud Dashboard Monitoring
 
-Claude: [3 Workers, 3 sites, simultaneously]
-        Amazon:  $999
-        eBay:    $945  ← lowest
-        Walmart: $979
-        Time: 1.3s total (not 3.9s)
 ```
+You: ccp screenshot my AWS billing, GCP console, Azure portal, Stripe,
+     and Datadog — all at once
+
+Claude: [5 Workers — already logged into every cloud provider]
+        aws-billing.png      $12,847/mo  ✓
+        gcp-console.png      $8,291/mo   ✓
+        azure-portal.png     $3,104/mo   ✓
+        stripe-revenue.png   $47,230 MRR ✓
+        datadog-metrics.png  99.7% uptime ✓
+        Time: 3.1s (not 10+ minutes of login screens)
+```
+
+No OAuth tokens. No service accounts. No API keys to rotate. You're already logged in.
 
-### Authenticated Dashboard Monitoring
+### Automated Regression Testing
 
+```bash
+# Full regression suite — 10 flows, 10 Workers, one command
+claude -p "ccp test these 10 critical flows on staging.myapp.com:
+  login, signup, checkout, search, profile-edit,
+  password-reset, file-upload, notifications, admin-panel, API-docs"
+
+# Sequential: ~15 minutes.  CCP: ~90 seconds.
+# Run this before every deploy.
 ```
-You: ccp screenshot my AWS billing, Stripe dashboard, and Vercel usage
 
-Claude: [All 3 require login — but you're already authenticated]
-        aws-billing.png    ✓
-        stripe-revenue.png ✓
-        vercel-usage.png   ✓
+Each Worker gets an isolated session — no cookie contamination between test flows. Test multi-user scenarios (admin + regular user) simultaneously.
+
+### Competitive Intelligence at Scale
+
+```
+You: ccp monitor pricing on Amazon, Walmart, Target, Best Buy, and Costco
+     for "Sony WH-1000XM5" — compare and find the lowest
+
+Claude: [5 Workers, 5 retailers, parallel]
+        Amazon:    $278
+        Walmart:   $298
+        Target:    $279
+        Best Buy:  $249 ← lowest (sale)
+        Costco:    $269 (members only)
+        Time: 2.4s | All prices from live pages, not cached APIs
 ```
 
-### Parallel QA Testing
+Works on sites with bot detection because it's your real Chrome — real cookies, real fingerprint, real browsing history.
 
-```bash
-# 5 tests, 5 terminals, all at once
-claude -p "ccp test login flow on myapp.com"       # Worker 1
-claude -p "ccp test checkout on myapp.com"          # Worker 2
-claude -p "ccp test admin panel on myapp.com"       # Worker 3
-claude -p "ccp test mobile view on myapp.com"       # Worker 4
-claude -p "ccp test form validation on myapp.com"   # Worker 5
-
-# Sequential: ~5 minutes.  Parallel with CCP: ~1 minute.
-# That's your entire smoke test suite before lunch.
+### Multi-Account Operations
+
+```
+You: ccp check order status on my personal and business Amazon accounts,
+     plus my eBay seller dashboard — all at the same time
+
+Claude: [3 Workers, 3 isolated sessions]
+        Amazon Personal:  2 packages arriving tomorrow
+        Amazon Business:  Purchase order #4521 approved
+        eBay Seller:      3 new orders, $847 revenue today
+        Time: 2.1s
 ```
 
+Same site, different accounts, simultaneously. Each Worker has its own cookies and session state.
+
 ---
 
 ## Comparison
@@ -240,7 +281,9 @@ claude -p "ccp test form validation on myapp.com"   # Worker 5
 
 ## Adaptive Guidance
 
-Every tool response includes contextual hints that prevent the LLM from wasting time on wrong approaches. 21 static rules + an adaptive memory system that learns from your usage patterns.
+The biggest time sink in LLM browser automation isn't execution speed — it's **wrong tool choices, missed page state, and pointless retries**. Each mistake costs 3-10 seconds of LLM inference. Three mistakes and you've wasted 30 seconds before anything useful happens.
+
+CCP injects contextual `_hint` fields into every tool response to prevent this:
 
 ```
 click_element → Error: "ref not found"
@@ -250,9 +293,13 @@ click_element → Error: "ref not found"
 navigate → title contains "Login"
   _hint: "Login page detected. Use fill_form for credentials."
   → LLM skips straight to form filling.
+
+find → computer(click) pattern detected
+  _hint: "Use click_element to find+click in one call."
+  → Eliminates unnecessary intermediate steps.
 ```
 
-**Adaptive Memory**: The system observes which tool resolves each error type. After seeing the same recovery pattern 3 times, it promotes it to a permanent hint — persisted across sessions in `.chrome-parallel/hints/learned-patterns.json`.
+21 static rules across 6 priority tiers + an **adaptive memory** system that learns from your usage. When the same error→recovery pattern appears 3 times, it's promoted to a permanent hint — persisted across sessions in `.chrome-parallel/hints/learned-patterns.json`.
 
 <details>
 <summary>Rule priority tiers</summary>
@@ -356,16 +403,18 @@ navigate → title contains "Login"
 ## CLI
 
 ```bash
-npx claude-chrome-parallel setup                  # Auto-configure (global)
-npx claude-chrome-parallel setup --scope project  # Auto-configure (project only)
-npx claude-chrome-parallel serve --auto-launch    # Start with auto Chrome launch
-npx claude-chrome-parallel serve --headless-shell # Headless mode (15-30% less memory)
-npx claude-chrome-parallel serve -p <port>        # Custom debugging port (default: 9222)
-npx claude-chrome-parallel doctor                 # Diagnose installation
-npx claude-chrome-parallel status                 # View sessions
-npx claude-chrome-parallel cleanup                # Clean up old sessions
+ccp setup                         # Auto-configure (global)
+ccp setup --scope project         # Auto-configure (project only)
+ccp serve --auto-launch           # Start with auto Chrome launch
+ccp serve --headless-shell        # Headless mode (15-30% less memory)
+ccp serve -p <port>               # Custom debugging port (default: 9222)
+ccp doctor                        # Diagnose installation
+ccp status                        # View sessions
+ccp cleanup                       # Clean up old sessions
 ```
 
+> `ccp` requires global install (`npm i -g claude-chrome-parallel`). All commands also work via `npx claude-chrome-parallel <command>`.
+
 ---
 
 <details>
@@ -389,6 +438,23 @@ cd claude-chrome-parallel
 npm install && npm run build && npm test
 ```
 
+## Compatibility
+
+CCP is a standard **MCP server** (stdio JSON-RPC). While optimized for Claude Code, it works with any MCP-compatible client:
+
+```json
+{
+  "mcpServers": {
+    "chrome-parallel": {
+      "command": "npx",
+      "args": ["-y", "claude-chrome-parallel", "serve", "--auto-launch"]
+    }
+  }
+}
+```
+
+Cursor, Windsurf, Codex CLI, or any editor that supports MCP can use CCP with the config above. See [Contributing](CONTRIBUTING.md) for multi-client testing status.
+
 ## License
 
 MIT — [LICENSE](LICENSE)

package/dist/cdp/client.d.ts

@@ -32,6 +32,8 @@ export declare class CDPClient {
     private autoLaunch;
     private cookieSourceCache;
     private cookieDataCache;
+    private targetIdIndex;
+    private inFlightCookieScans;
     private static readonly COOKIE_CACHE_TTL;
     constructor(options?: CDPClientOptions);
     /**
@@ -117,14 +119,25 @@ export declare class CDPClient {
      */
     private domainMatchScore;
     /**
-     * Find an authenticated page with cookies to copy from
-     * Returns the targetId of a page that has cookies in Chrome's default context
+     * Find an authenticated page with cookies to copy from.
+     * Returns the targetId of a page that has cookies in Chrome's default context.
+     *
+     * Promise coalescing: concurrent callers for the same domain share one probe
+     * instead of independently hammering Chrome with 20 simultaneous scans.
+     *
      * @param targetDomain Optional domain to prioritize when selecting cookie source
      */
     findAuthenticatedPageTargetId(targetDomain?: string): Promise<string | null>;
     /**
-     * Copy all cookies from authenticated page to destination page
-     * Uses raw WebSocket CDP connection to bypass Puppeteer's context isolation
+     * Internal implementation of the authenticated-page probe.
+     * Uses Target.attachToTarget (multiplexed CDP) instead of raw WebSocket connections.
+     * Uses Target.getTargets result directly instead of /json/list HTTP calls.
+     */
+    private _doFindAuthenticatedPageTargetId;
+    /**
+     * Copy all cookies from authenticated page to destination page.
+     * Uses Target.attachToTarget (multiplexed CDP) to bypass Puppeteer's context isolation —
+     * no raw WebSocket connections, no /json/list HTTP calls.
      */
     copyCookiesViaCDP(sourceTargetId: string, destPage: Page): Promise<number>;
     /**

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

@@ -32,7 +32,9 @@ class CDPClient {
     autoLaunch;
     cookieSourceCache = new Map();
     cookieDataCache = new Map();
-    static COOKIE_CACHE_TTL = 30000; // 30 seconds
+    targetIdIndex = new Map();
+    inFlightCookieScans = new Map();
+    static COOKIE_CACHE_TTL = 300000; // 5 minutes
     constructor(options = {}) {
         const globalConfig = (0, global_1.getGlobalConfig)();
         this.port = options.port || globalConfig.port;
@@ -82,6 +84,7 @@ class CDPClient {
         }
         // Clean up cookie data cache for this target
         this.cookieDataCache.delete(targetId);
+        this.targetIdIndex.delete(targetId);
         for (const listener of this.targetDestroyedListeners) {
             try {
                 listener(targetId);
@@ -158,6 +161,8 @@ class CDPClient {
         });
         // Clear existing sessions
         this.sessions.clear();
+        this.targetIdIndex.clear();
+        this.inFlightCookieScans.clear();
         this.browser = null;
         // Attempt reconnection
         while (this.reconnectAttempts < this.maxReconnectAttempts) {
@@ -212,6 +217,20 @@ class CDPClient {
             console.error(`[CDPClient] Target destroyed: ${targetId}`);
             this.onTargetDestroyed(targetId);
         });
+        // Maintain target-to-page index for O(1) lookups
+        this.browser.on('targetcreated', async (target) => {
+            if (target.type() === 'page') {
+                try {
+                    const page = await target.page();
+                    if (page) {
+                        this.targetIdIndex.set(getTargetId(target), page);
+                    }
+                }
+                catch {
+                    // Target may have been destroyed before we could index it
+                }
+            }
+        });
         this.connectionState = 'connected';
         this.emitConnectionEvent({
             type: 'connected',
@@ -371,8 +390,12 @@ class CDPClient {
         }
     }
     /**
-     * Find an authenticated page with cookies to copy from
-     * Returns the targetId of a page that has cookies in Chrome's default context
+     * Find an authenticated page with cookies to copy from.
+     * Returns the targetId of a page that has cookies in Chrome's default context.
+     *
+     * Promise coalescing: concurrent callers for the same domain share one probe
+     * instead of independently hammering Chrome with 20 simultaneous scans.
+     *
      * @param targetDomain Optional domain to prioritize when selecting cookie source
      */
     async findAuthenticatedPageTargetId(targetDomain) {
@@ -383,7 +406,28 @@ class CDPClient {
             console.error(`[CDPClient] Cache hit for cookie source (domain: ${cacheKey}): ${cached.targetId.slice(0, 8)}`);
             return cached.targetId;
         }
-        const WebSocket = require('ws');
+        // Promise coalescing: if a scan for this domain is already in-flight, reuse it
+        const existing = this.inFlightCookieScans.get(cacheKey);
+        if (existing) {
+            console.error(`[CDPClient] Coalescing cookie scan for domain: ${cacheKey}`);
+            return existing;
+        }
+        // Start the scan and register it so concurrent callers share this promise
+        const scanPromise = this._doFindAuthenticatedPageTargetId(targetDomain, cacheKey);
+        this.inFlightCookieScans.set(cacheKey, scanPromise);
+        try {
+            return await scanPromise;
+        }
+        finally {
+            this.inFlightCookieScans.delete(cacheKey);
+        }
+    }
+    /**
+     * Internal implementation of the authenticated-page probe.
+     * Uses Target.attachToTarget (multiplexed CDP) instead of raw WebSocket connections.
+     * Uses Target.getTargets result directly instead of /json/list HTTP calls.
+     */
+    async _doFindAuthenticatedPageTargetId(targetDomain, cacheKey) {
         const browser = this.getBrowser();
         const session = await browser.target().createCDPSession();
         try {
@@ -417,42 +461,34 @@ class CDPClient {
                 });
                 console.error(`[CDPClient] Sorted ${candidates.length} candidates by domain match to ${targetDomain}`);
             }
-            // Get target list with WebSocket URLs
-            const listResponse = await fetch(`http://127.0.0.1:${this.port}/json/list`);
-            const targets = await listResponse.json();
-            // Check each candidate to find one with actual cookies (in priority order)
+            // Check each candidate to find one with actual cookies (in priority order).
+            // Uses Target.attachToTarget over the existing multiplexed session — no raw WebSocket,
+            // no /json/list HTTP round-trip.
             for (const candidate of candidates) {
-                const targetInfo = targets.find(t => t.id === candidate.targetId);
-                if (!targetInfo || !targetInfo.webSocketDebuggerUrl) {
-                    continue;
-                }
-                // Check if this page has cookies (pages in Chrome's default context have cookies,
-                // while Puppeteer-created pages have empty cookies)
-                const cookieCount = await new Promise((resolve) => {
-                    const ws = new WebSocket(targetInfo.webSocketDebuggerUrl);
-                    const timeout = setTimeout(() => { ws.close(); resolve(0); }, 2000);
-                    ws.on('open', () => {
-                        ws.send(JSON.stringify({ id: 1, method: 'Network.getAllCookies' }));
-                    });
-                    ws.on('message', (data) => {
-                        const msg = JSON.parse(data.toString());
-                        if (msg.id === 1) {
-                            clearTimeout(timeout);
-                            ws.close();
-                            resolve(msg.result?.cookies?.length || 0);
-                        }
-                    });
-                    ws.on('error', () => {
-                        clearTimeout(timeout);
-                        resolve(0);
+                let attachedSessionId = null;
+                try {
+                    const { sessionId } = await session.send('Target.attachToTarget', {
+                        targetId: candidate.targetId,
+                        flatten: true,
                     });
-                });
-                if (cookieCount > 0) {
-                    const domainScore = targetDomain ? this.domainMatchScore(candidate.url, targetDomain) : 0;
-                    console.error(`[CDPClient] Found authenticated page ${candidate.targetId.slice(0, 8)} at ${candidate.url.slice(0, 50)} (${cookieCount} cookies, domain score: ${domainScore})`);
-                    // Store in cache
-                    this.cookieSourceCache.set(cacheKey, { targetId: candidate.targetId, timestamp: Date.now() });
-                    return candidate.targetId;
+                    attachedSessionId = sessionId;
+                    // Send Network.getAllCookies through the flat CDP session
+                    const result = await session.send('Network.getAllCookies', undefined, { sessionId });
+                    const cookieCount = result?.cookies?.length || 0;
+                    if (cookieCount > 0) {
+                        const domainScore = targetDomain ? this.domainMatchScore(candidate.url, targetDomain) : 0;
+                        console.error(`[CDPClient] Found authenticated page ${candidate.targetId.slice(0, 8)} at ${candidate.url.slice(0, 50)} (${cookieCount} cookies, domain score: ${domainScore})`);
+                        this.cookieSourceCache.set(cacheKey, { targetId: candidate.targetId, timestamp: Date.now() });
+                        return candidate.targetId;
+                    }
+                }
+                catch {
+                    // Target may be unresponsive or already detached — skip
+                }
+                finally {
+                    if (attachedSessionId) {
+                        await session.send('Target.detachFromTarget', { sessionId: attachedSessionId }).catch(() => { });
+                    }
                 }
             }
             console.error('[CDPClient] No pages with cookies found');
@@ -463,17 +499,17 @@ class CDPClient {
         }
     }
     /**
-     * Copy all cookies from authenticated page to destination page
-     * Uses raw WebSocket CDP connection to bypass Puppeteer's context isolation
+     * Copy all cookies from authenticated page to destination page.
+     * Uses Target.attachToTarget (multiplexed CDP) to bypass Puppeteer's context isolation —
+     * no raw WebSocket connections, no /json/list HTTP calls.
      */
     async copyCookiesViaCDP(sourceTargetId, destPage) {
-        const WebSocket = require('ws');
         console.error(`[CDPClient] copyCookiesViaCDP called with sourceTargetId: ${sourceTargetId.slice(0, 8)}`);
         try {
-            // Check cookie data cache first
+            // Check cookie data cache first — avoids re-probing Chrome entirely
             const cachedData = this.cookieDataCache.get(sourceTargetId);
             if (cachedData && Date.now() - cachedData.timestamp < CDPClient.COOKIE_CACHE_TTL) {
-                console.error(`[CDPClient] Cache hit for cookie data (${cachedData.cookies.length} cookies), skipping WebSocket`);
+                console.error(`[CDPClient] Cache hit for cookie data (${cachedData.cookies.length} cookies), skipping CDP attach`);
                 const destSession = await destPage.createCDPSession();
                 try {
                     const cookiesToSet = cachedData.cookies.map(c => ({
@@ -494,69 +530,65 @@ class CDPClient {
                     await destSession.detach().catch(() => { });
                 }
             }
-            // Get target's WebSocket URL
-            const listResponse = await fetch(`http://127.0.0.1:${this.port}/json/list`);
-            const targets = await listResponse.json();
-            const sourceTarget = targets.find(t => t.id === sourceTargetId);
-            if (!sourceTarget || !sourceTarget.webSocketDebuggerUrl) {
-                console.error(`[CDPClient] Source target not found in /json/list. Looking for: ${sourceTargetId}`);
-                console.error(`[CDPClient] Available targets: ${targets.map(t => t.id.slice(0, 8) + ' ' + t.url.slice(0, 40)).join(', ')}`);
-                return 0;
-            }
-            console.error(`[CDPClient] Connecting to source target at ${sourceTarget.url.slice(0, 50)}`);
-            // Get cookies via WebSocket
-            const cookies = await new Promise((resolve, reject) => {
-                const ws = new WebSocket(sourceTarget.webSocketDebuggerUrl);
-                const timeout = setTimeout(() => {
-                    ws.close();
-                    reject(new Error('WebSocket timeout'));
-                }, 5000);
-                ws.on('open', () => {
-                    ws.send(JSON.stringify({ id: 1, method: 'Network.getAllCookies' }));
-                });
-                ws.on('message', (data) => {
-                    const msg = JSON.parse(data.toString());
-                    if (msg.id === 1) {
-                        clearTimeout(timeout);
-                        ws.close();
-                        resolve(msg.result?.cookies || []);
-                    }
-                });
-                ws.on('error', (err) => {
-                    clearTimeout(timeout);
-                    reject(err);
-                });
-            });
-            // Store in cookie data cache
-            this.cookieDataCache.set(sourceTargetId, { cookies, timestamp: Date.now() });
-            if (cookies.length === 0) {
-                console.error(`[CDPClient] No cookies found in source page`);
-                return 0;
-            }
-            console.error(`[CDPClient] Found ${cookies.length} cookies, setting on destination page`);
-            // Set cookies on destination page
-            const destSession = await destPage.createCDPSession();
+            // Attach to the source target via the multiplexed browser CDP session
+            const browser = this.getBrowser();
+            const browserSession = await browser.target().createCDPSession();
+            let attachedSessionId = null;
             try {
-                const cookiesToSet = cookies.map(c => ({
-                    name: c.name,
-                    value: c.value,
-                    domain: c.domain,
-                    path: c.path,
-                    expires: c.expires,
-                    httpOnly: c.httpOnly,
-                    secure: c.secure,
-                    sameSite: c.sameSite,
-                }));
-                await destSession.send('Network.setCookies', { cookies: cookiesToSet });
-                console.error(`[CDPClient] Successfully copied ${cookies.length} cookies`);
-                return cookies.length;
+                // Verify the target exists before attaching
+                const { targetInfos } = await browserSession.send('Target.getTargets');
+                const sourceInfo = targetInfos.find(t => t.targetId === sourceTargetId);
+                if (!sourceInfo) {
+                    console.error(`[CDPClient] Source target not found: ${sourceTargetId.slice(0, 8)}`);
+                    console.error(`[CDPClient] Available targets: ${targetInfos.map(t => t.targetId.slice(0, 8) + ' ' + t.url.slice(0, 40)).join(', ')}`);
+                    return 0;
+                }
+                console.error(`[CDPClient] Attaching to source target at ${sourceInfo.url.slice(0, 50)}`);
+                const { sessionId } = await browserSession.send('Target.attachToTarget', {
+                    targetId: sourceTargetId,
+                    flatten: true,
+                });
+                attachedSessionId = sessionId;
+                // Fetch cookies through the flat session (no raw WebSocket, no /json/list)
+                const result = await browserSession.send('Network.getAllCookies', undefined, { sessionId });
+                const cookies = result?.cookies || [];
+                // Store in cookie data cache
+                this.cookieDataCache.set(sourceTargetId, { cookies, timestamp: Date.now() });
+                if (cookies.length === 0) {
+                    console.error('[CDPClient] No cookies found in source page');
+                    return 0;
+                }
+                console.error(`[CDPClient] Found ${cookies.length} cookies, setting on destination page`);
+                // Set cookies on destination page via its own CDPSession
+                const destSession = await destPage.createCDPSession();
+                try {
+                    const cookiesToSet = cookies.map(c => ({
+                        name: c.name,
+                        value: c.value,
+                        domain: c.domain,
+                        path: c.path,
+                        expires: c.expires,
+                        httpOnly: c.httpOnly,
+                        secure: c.secure,
+                        sameSite: c.sameSite,
+                    }));
+                    await destSession.send('Network.setCookies', { cookies: cookiesToSet });
+                    console.error(`[CDPClient] Successfully copied ${cookies.length} cookies`);
+                    return cookies.length;
+                }
+                finally {
+                    await destSession.detach().catch(() => { });
+                }
             }
             finally {
-                await destSession.detach().catch(() => { });
+                if (attachedSessionId) {
+                    await browserSession.send('Target.detachFromTarget', { sessionId: attachedSessionId }).catch(() => { });
+                }
+                await browserSession.detach().catch(() => { });
             }
         }
         catch (error) {
-            console.error(`[CDPClient] Error in copyCookiesViaCDP:`, error);
+            console.error('[CDPClient] Error in copyCookiesViaCDP:', error);
             return 0;
         }
     }
@@ -611,14 +643,26 @@ class CDPClient {
      * Get page by target ID
      */
     async getPageByTargetId(targetId) {
+        // Fast path: check index first (O(1))
+        const indexed = this.targetIdIndex.get(targetId);
+        if (indexed && !indexed.isClosed()) {
+            return indexed;
+        }
+        // Fallback: linear scan (for pages created before indexing started)
         const browser = this.getBrowser();
         const targets = browser.targets();
         for (const target of targets) {
             if (getTargetId(target) === targetId && target.type() === 'page') {
                 const page = await target.page();
+                if (page) {
+                    // Populate index for future lookups
+                    this.targetIdIndex.set(targetId, page);
+                }
                 return page;
             }
         }
+        // Clean stale index entry
+        this.targetIdIndex.delete(targetId);
         return null;
     }
     /**