claude-chrome-parallel 2.3.0 → 3.0.0

package/README.md

@@ -5,9 +5,22 @@
 [![npm version](https://badge.fury.io/js/claude-chrome-parallel.svg)](https://www.npmjs.com/package/claude-chrome-parallel)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
+## The Power of Authenticated Browser Sessions
+
+Unlike traditional web scraping or automation tools, Claude Chrome Parallel operates within **your already logged-in Chrome browser**. This means:
+
+- **Access authenticated services** - Gmail, Salesforce, LinkedIn, banking portals, admin dashboards
+- **No credential management** - Session cookies and OAuth tokens are already active
+- **Bypass bot detection** - Uses your real browser profile, not headless automation
+- **Access personalized data** - Dashboards, account settings, member-only content
+
+**This is not just a development tool.** While the parallel session feature solves a technical problem for developers, the real power lies in automating *any* web task that requires authentication - tasks that were previously impossible to automate without building complex auth flows.
+
+---
+
 ## Why This Exists
 
-[Claude Chrome](https://claude.ai/chrome) is a powerful tool that lets you debug **production environments while logged in** - no need to replicate auth states or mock sessions. But when you try to run multiple Claude Code sessions with browser automation simultaneously, you get:
+[Claude Chrome](https://claude.ai/chrome) lets you debug **production environments while logged in**. But when you try to run multiple Claude Code sessions with browser automation simultaneously:
 
 ```
 Error: Detached while handling command
@@ -29,9 +42,171 @@ Each session gets isolated browser control. No shared state = No conflicts.
 
 ## Use Cases
 
-### Multi-Session QA Testing
+### Beyond Development: Real-World Automation
+
+The combination of **authenticated sessions** + **natural language control** + **parallel execution** enables automation scenarios that were previously impractical:
+
+---
+
+### 1. Business Process Automation
+
+#### ERP/SaaS Dashboard Data Collection
+Extract reports from login-required services (Salesforce, HubSpot, Zendesk):
+
+```
+You: Navigate to our Salesforce dashboard and extract this month's sales pipeline data
+
+Claude: [Navigates to authenticated Salesforce, parses tables, extracts structured data]
+```
+
+#### Invoice & Receipt Collection
+Automatically download monthly invoices from multiple services:
+
+```
+You: Go to AWS billing console and download last month's invoice PDF
+
+Claude: [Navigates to authenticated AWS console, finds invoice, triggers download]
+```
+
+#### Repetitive Admin Tasks
+Process approvals, submit forms, update records:
+
+```
+You: Go to our HR portal and approve all pending time-off requests from my team
+
+Claude: [Navigates to HR system, finds pending items, processes each approval]
+```
+
+---
+
+### 2. Research & Data Collection
+
+#### Competitive Analysis (Login-Required Platforms)
+Gather intelligence from premium platforms:
+
+```
+You: Search LinkedIn Sales Navigator for CTOs at fintech startups in NYC and list their profiles
+
+Claude: [Uses your LinkedIn Premium session to search and extract profile data]
+```
+
+#### Academic Database Research
+Access institutional databases that require authentication:
+
+```
+You: Search IEEE Xplore for papers on "transformer architecture" from 2023 and list titles with citations
+
+Claude: [Uses your university library login to search and extract paper metadata]
+```
+
+#### Financial & Real Estate Data
+Access member-only pricing and transaction data:
+
+```
+You: Check my Schwab portfolio and summarize today's gains/losses by sector
+
+Claude: [Navigates authenticated brokerage account, extracts and analyzes positions]
+```
+
+---
+
+### 3. Social Media Management
+
+#### Multi-Account Content Publishing
+Post content across platforms:
+
+```
+You: Post this announcement to our company LinkedIn, Twitter, and Facebook pages
+
+Claude: [Navigates to each platform with saved sessions, composes and publishes posts]
+```
+
+#### Message & Inquiry Management
+Handle customer messages with templates:
+
+```
+You: Check our Instagram business inbox and reply to product inquiries with our standard response
+
+Claude: [Reads DMs, identifies product questions, sends templated responses]
+```
+
+#### Analytics Collection
+Gather engagement metrics across platforms:
+
+```
+You: Get our Twitter analytics for the past week and summarize engagement trends
+
+Claude: [Accesses Twitter Analytics dashboard, extracts metrics, provides summary]
+```
+
+---
+
+### 4. E-Commerce Automation
+
+#### Member Price Monitoring
+Track prices that require membership login:
+
+```
+You: Check the member price for this Costco item and compare with last week
+
+Claude: [Logs into Costco account, finds item, extracts member-only pricing]
+```
+
+#### Inventory & Order Management
+Manage seller accounts across marketplaces:
+
+```
+You: Check our Amazon Seller Central for any new orders and list items running low on inventory
+
+Claude: [Navigates seller dashboard, extracts order and inventory data]
+```
+
+#### Review Management
+Respond to customer reviews at scale:
+
+```
+You: Find all unanswered 4-star reviews on our Shopify store and draft personalized thank-you responses
+
+Claude: [Navigates store admin, identifies reviews, generates contextual responses]
+```
+
+---
+
+### 5. Personal Productivity
+
+#### Email Organization
+Manage your inbox intelligently:
+
+```
+You: In Gmail, find all newsletters from the past month and add the "Newsletters" label
+
+Claude: [Searches Gmail, selects matching emails, applies labels]
+```
+
+#### Calendar Management
+Bulk calendar operations:
 
-Run parallel test scenarios against your production or staging environment:
+```
+You: Add these 5 meetings to my Google Calendar with the details from this spreadsheet
+
+Claude: [Creates each calendar event with proper dates, times, and descriptions]
+```
+
+#### Bookmark & Archive Management
+Organize saved content:
+
+```
+You: Save this article to my Notion reading list with its title and summary
+
+Claude: [Extracts metadata, navigates to Notion, creates database entry]
+```
+
+---
+
+### 6. QA & Testing
+
+#### Multi-Session QA Testing
+Run parallel test scenarios against production:
 
 ```bash
 # Terminal 1: Test user login flow
@@ -44,28 +219,149 @@ claude -p "Test the checkout flow on https://myapp.com/cart"
 claude -p "Take screenshots of https://myapp.com/admin every 30 seconds"
 ```
 
-### Parallel Debugging
+#### Network Condition Testing
+Test performance under various network conditions:
 
-Debug multiple pages or user journeys at the same time:
+```
+You: Simulate 3G network and test if our checkout page loads within 5 seconds
+
+Claude: [Applies network throttling, measures load time, reports results]
+```
+
+#### Accessibility Auditing
+Analyze page accessibility via the accessibility tree:
 
-```bash
-# Debug as different users
-Terminal 1: "Log in as admin and check permissions on /settings"
-Terminal 2: "Log in as regular user and verify they can't access /settings"
 ```
+You: Check the accessibility tree of our signup form and identify any missing labels
 
-### Automated Regression Testing
+Claude: [Parses full accessibility tree, identifies WCAG compliance issues]
+```
 
-Run comprehensive browser tests across multiple sessions:
+---
 
-```bash
-# Run 5 parallel test sessions
-for i in {1..5}; do
-  claude -p "Run test suite $i on https://staging.myapp.com" &
-done
+### 7. Security & Compliance
+
+#### Personal Data Audit
+Check what data services have stored:
+
+```
+You: Navigate to my Google Account privacy settings and list all third-party apps with access
+
+Claude: [Navigates account settings, extracts connected app list]
+```
+
+#### Session Verification
+Verify active sessions across services:
+
+```
+You: Check my GitHub security settings and list all active sessions
+
+Claude: [Navigates GitHub settings, extracts session information]
 ```
 
-### Tested Concurrency
+---
+
+## Core Features
+
+### Isolated Workers (Parallel Browser Contexts)
+
+The killer feature of Claude Chrome Parallel is **worker isolation**. Each worker has:
+
+- **Separate browser context** with its own cookies, localStorage, and sessionStorage
+- **Independent tab management** - tabs are scoped to their worker
+- **Complete state isolation** - one worker's login doesn't affect another
+
+```
+You: Create a worker named "google-shopping"
+
+Claude: [Creates isolated browser context]
+        Worker: google-shopping
+        Context: Isolated (separate cookies/storage)
+
+You: In google-shopping worker, search for laptops
+
+Claude: [Opens tab in google-shopping worker context]
+        Any login, preferences, or state is isolated to this worker
+```
+
+**Why This Matters:**
+- Log into different accounts simultaneously (e.g., multiple Gmail accounts)
+- Run parallel price comparisons without cookie conflicts
+- Test multi-user scenarios with complete isolation
+
+### Automatic Task Distribution
+
+When you have multiple tabs open, operations are automatically distributed:
+
+```
+You: Take screenshots of all open tabs
+
+Claude: [Parallel execution across all tabs]
+        Tab 1: Screenshot taken (500ms)
+        Tab 2: Screenshot taken (480ms)
+        Tab 3: Screenshot taken (520ms)
+        Total: ~500ms (parallel) vs ~1500ms (sequential)
+```
+
+### Workflow Orchestration
+
+For complex multi-site operations, use the orchestration tools:
+
+```typescript
+// Initialize a parallel workflow
+workflow_init({
+  name: "Price Comparison",
+  workers: [
+    { name: "amazon", url: "https://amazon.com", task: "Search iPhone 15 price" },
+    { name: "ebay", url: "https://ebay.com", task: "Search iPhone 15 price" },
+    { name: "walmart", url: "https://walmart.com", task: "Search iPhone 15 price" }
+  ]
+})
+
+// Each worker executes in parallel with isolated contexts
+// Results are collected via workflow_collect
+```
+
+---
+
+## Available MCP Tools
+
+### Browser Automation Tools
+
+| Tool | Description | Key Use Cases |
+|------|-------------|---------------|
+| `navigate` | Navigate to URL, back/forward history | Multi-page workflows |
+| `computer` | Screenshots, mouse clicks, keyboard, scrolling | Non-standard UI interaction |
+| `read_page` | Parse page via accessibility tree | Dynamic content extraction |
+| `find` | Find elements by natural language | "search box", "submit button" |
+| `form_input` | Set form values directly | Fast data entry |
+| `javascript_tool` | Execute arbitrary JavaScript | Complex DOM operations |
+| `network` | Simulate network conditions | Performance testing |
+
+### Tab & Worker Management Tools
+
+| Tool | Description | Key Use Cases |
+|------|-------------|---------------|
+| `tabs_context_mcp` | Get available tabs by worker | Session overview |
+| `tabs_create_mcp` | Create new tab in worker | Parallel tab operations |
+| `worker_create` | Create isolated browser context | Multi-account scenarios |
+| `worker_list` | List all workers and their tabs | Session management |
+| `worker_delete` | Delete worker and close its tabs | Cleanup |
+
+### Orchestration Tools
+
+| Tool | Description | Key Use Cases |
+|------|-------------|---------------|
+| `workflow_init` | Initialize multi-worker workflow | Parallel site operations |
+| `workflow_status` | Get orchestration progress | Monitoring |
+| `workflow_collect` | Collect results from workers | Data aggregation |
+| `workflow_cleanup` | Clean up workflow resources | Session cleanup |
+| `worker_update` | Update worker progress | Progress tracking |
+| `worker_complete` | Mark worker as complete | Workflow completion |
+
+---
+
+## Tested Concurrency
 
 | Sessions | Success Rate |
 |----------|-------------|
@@ -94,13 +390,15 @@ Add to your Claude Code MCP settings (`~/.claude.json`):
 {
   "mcpServers": {
     "chrome-parallel": {
-      "command": "claude-chrome-parallel",
+      "command": "ccp",
       "args": ["serve"]
     }
   }
 }
 ```
 
+> **Note:** `ccp` is a shorthand alias. You can also use the full name `claude-chrome-parallel`.
+
 Restart Claude Code for changes to take effect.
 
 ---
@@ -137,20 +435,6 @@ claude
 
 All sessions work without conflicts!
 
-### Available Browser Tools
-
-| Tool | Description |
-|------|-------------|
-| `navigate` | Navigate to URL or use history |
-| `computer` | Screenshots, mouse clicks, keyboard input, scrolling |
-| `read_page` | Read page content via accessibility tree |
-| `find` | Find elements by description |
-| `form_input` | Fill form fields |
-| `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:
@@ -197,27 +481,29 @@ Each Claude Code session spawns its own MCP server process with a dedicated CDP
 
 ## CLI Commands
 
+> **Tip:** Use `ccp` as a shorthand for `claude-chrome-parallel` in all commands below.
+
 ```bash
 # Start MCP server (used by Claude Code automatically)
-claude-chrome-parallel serve
+ccp serve
 
 # Check Chrome connection status
-claude-chrome-parallel check
+ccp check
 
 # Use custom Chrome debugging port
-claude-chrome-parallel serve --port 9223
+ccp serve --port 9223
 
 # Check installation health
-claude-chrome-parallel doctor
+ccp doctor
 
 # View session status and statistics
-claude-chrome-parallel status
+ccp status
 
 # View status as JSON (for automation)
-claude-chrome-parallel status --json
+ccp status --json
 
 # Clean up stale sessions and old backups
-claude-chrome-parallel cleanup --max-age 24 --keep-backups 10
+ccp cleanup --max-age 24 --keep-backups 10
 ```
 
 ---
@@ -251,11 +537,11 @@ When running multiple Claude Code instances, they can corrupt `~/.claude.json` d
 
 ```bash
 # Run Claude Code with isolated config directory
-claude-chrome-parallel launch
+ccp launch
 
 # Pass any claude flags
-claude-chrome-parallel launch --dangerously-skip-permissions
-claude-chrome-parallel launch -p "Your prompt"
+ccp launch --dangerously-skip-permissions
+ccp launch -p "Your prompt"
 ```
 
 ### Config Recovery
@@ -264,10 +550,10 @@ If your `.claude.json` gets corrupted:
 
 ```bash
 # Auto-recover corrupted config
-claude-chrome-parallel recover
+ccp recover
 
 # List available backups
-claude-chrome-parallel recover --list-backups
+ccp recover --list-backups
 ```
 
 ---
@@ -287,13 +573,34 @@ claude-chrome-parallel recover --list-backups
 
 ---
 
+## Considerations
+
+### Strengths
+- **Authenticated access** - Automate any login-required service
+- **Natural language element finding** - Resilient to DOM changes
+- **JavaScript execution** - Handle complex SPAs
+- **Visual verification** - Screenshots for evidence/debugging
+
+### Limitations
+- CAPTCHA/bot detection on some services
+- 2FA re-authentication may require manual intervention
+- For high-volume tasks, native APIs are more efficient when available
+- Rate limiting applies to automated interactions
+
+### Recommended Patterns
+1. **Small/critical tasks** → Use this MCP
+2. **High-volume tasks** → Prefer native APIs when available
+3. **Services without APIs** → This MCP is often the only option
+
+---
+
 ## Troubleshooting
 
 ### Chrome not connecting
 
 ```bash
 # Check status
-claude-chrome-parallel check
+ccp check
 
 # Manually start Chrome with debugging
 chrome --remote-debugging-port=9222

package/dist/cdp/client.d.ts

@@ -1,7 +1,7 @@
 /**
  * CDP Client - Wrapper around puppeteer-core for Chrome DevTools Protocol
  */
-import { Browser, Page, Target, CDPSession } from 'puppeteer-core';
+import { Browser, BrowserContext, Page, Target, CDPSession } from 'puppeteer-core';
 export interface CDPClientOptions {
     port?: number;
     maxReconnectAttempts?: number;
@@ -27,6 +27,7 @@ export declare class CDPClient {
     private heartbeatTimer;
     private connectionState;
     private eventListeners;
+    private targetDestroyedListeners;
     private reconnectAttempts;
     private autoLaunch;
     constructor(options?: CDPClientOptions);
@@ -42,6 +43,14 @@ export declare class CDPClient {
      * Remove connection event listener
      */
     removeConnectionListener(listener: (event: ConnectionEvent) => void): void;
+    /**
+     * Add target destroyed listener
+     */
+    addTargetDestroyedListener(listener: (targetId: string) => void): void;
+    /**
+     * Handle target destroyed event
+     */
+    private onTargetDestroyed;
     /**
      * Emit connection event
      */
@@ -82,10 +91,25 @@ export declare class CDPClient {
      * Get browser instance
      */
     getBrowser(): Browser;
+    static readonly DEFAULT_VIEWPORT: {
+        width: number;
+        height: number;
+    };
+    /**
+     * Create a new isolated browser context for session isolation
+     * Each context has its own cookies, localStorage, sessionStorage
+     */
+    createBrowserContext(): Promise<BrowserContext>;
+    /**
+     * Close a browser context and all its pages
+     */
+    closeBrowserContext(context: BrowserContext): Promise<void>;
     /**
-     * Create a new page
+     * Create a new page with default viewport
+     * @param url Optional URL to navigate to
+     * @param context Optional browser context for session isolation
      */
-    createPage(url?: string): Promise<Page>;
+    createPage(url?: string, context?: BrowserContext): Promise<Page>;
     /**
      * Get all page targets
      */

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":"AAAA;;GAEG;AAEH,OAAkB,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAI9F,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,CAAC;AAE3F,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,GAAG,cAAc,GAAG,cAAc,GAAG,kBAAkB,CAAC;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,eAAe,CAAmC;IAC1D,OAAO,CAAC,cAAc,CAA4C;IAClE,OAAO,CAAC,wBAAwB,CAAsC;IACtE,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,UAAU,CAAU;gBAEhB,OAAO,GAAE,gBAAqB;IAU1C;;OAEG;IACH,kBAAkB,IAAI,eAAe;IAIrC;;OAEG;IACH,qBAAqB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI;IAIvE;;OAEG;IACH,wBAAwB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI;IAO1E;;OAEG;IACH,0BAA0B,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAItE;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;YACW,eAAe;IAoB7B;;OAEG;YACW,gBAAgB;IAoD9B;;OAEG;YACW,eAAe;IA6B7B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B9B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBrC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBjC;;OAEG;IACH,UAAU,IAAI,OAAO;IAQrB,MAAM,CAAC,QAAQ,CAAC,gBAAgB;;;MAAiC;IAEjE;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC,cAAc,CAAC;IAOrD;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjE;;;;OAIG;IACG,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBvE;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAKjC;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAc/D;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;IAapD;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IAKb;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAItB;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIhD;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhD;;OAEG;IACH,WAAW,IAAI,OAAO;CAGvB;AAKD,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAKlE"}

package/dist/cdp/client.js

@@ -26,6 +26,7 @@ class CDPClient {
     heartbeatTimer = null;
     connectionState = 'disconnected';
     eventListeners = [];
+    targetDestroyedListeners = [];
     reconnectAttempts = 0;
     autoLaunch;
     constructor(options = {}) {
@@ -58,6 +59,26 @@ class CDPClient {
             this.eventListeners.splice(index, 1);
         }
     }
+    /**
+     * Add target destroyed listener
+     */
+    addTargetDestroyedListener(listener) {
+        this.targetDestroyedListeners.push(listener);
+    }
+    /**
+     * Handle target destroyed event
+     */
+    onTargetDestroyed(targetId) {
+        this.sessions.delete(targetId);
+        for (const listener of this.targetDestroyedListeners) {
+            try {
+                listener(targetId);
+            }
+            catch (e) {
+                console.error('[CDPClient] Target destroyed listener error:', e);
+            }
+        }
+    }
     /**
      * Emit connection event
      */
@@ -173,6 +194,12 @@ class CDPClient {
             console.error('[CDPClient] Browser disconnected');
             this.handleDisconnect();
         });
+        // Set up target destroyed handler
+        this.browser.on('targetdestroyed', (target) => {
+            const targetId = getTargetId(target);
+            console.error(`[CDPClient] Target destroyed: ${targetId}`);
+            this.onTargetDestroyed(targetId);
+        });
         this.connectionState = 'connected';
         this.emitConnectionEvent({
             type: 'connected',
@@ -257,12 +284,49 @@ class CDPClient {
         }
         return this.browser;
     }
+    // Default viewport for consistent debugging experience
+    static DEFAULT_VIEWPORT = { width: 1920, height: 1080 };
     /**
-     * Create a new page
+     * Create a new isolated browser context for session isolation
+     * Each context has its own cookies, localStorage, sessionStorage
      */
-    async createPage(url) {
+    async createBrowserContext() {
         const browser = this.getBrowser();
-        const page = await browser.newPage();
+        const context = await browser.createBrowserContext();
+        console.error(`[CDPClient] Created new browser context`);
+        return context;
+    }
+    /**
+     * Close a browser context and all its pages
+     */
+    async closeBrowserContext(context) {
+        try {
+            await context.close();
+            console.error(`[CDPClient] Closed browser context`);
+        }
+        catch (e) {
+            // Context may already be closed
+            console.error(`[CDPClient] Error closing browser context:`, e);
+        }
+    }
+    /**
+     * Create a new page with default viewport
+     * @param url Optional URL to navigate to
+     * @param context Optional browser context for session isolation
+     */
+    async createPage(url, context) {
+        let page;
+        if (context) {
+            // Create page in isolated context
+            page = await context.newPage();
+        }
+        else {
+            // Create page in default context
+            const browser = this.getBrowser();
+            page = await browser.newPage();
+        }
+        // Set default viewport for consistent debugging experience
+        await page.setViewport(CDPClient.DEFAULT_VIEWPORT);
         if (url) {
             await page.goto(url, { waitUntil: 'domcontentloaded' });
         }