chrome-jig 0.4.0 → 0.6.1

package/README.md

@@ -8,6 +8,8 @@ The DevTools console, from your terminal and editor.
 
 **Named script injection with auto-reload.** Register scripts in `.cjig.json`, inject by name, watch files for changes, auto re-inject. The modify → re-inject → exercise loop without leaving your editor.
 
+**Chrome lifecycle management.** Launch Chrome with isolated profiles, load unpacked extensions, attach to running instances. `cjig connection-info` exports connection details so Playwright scripts (or MCP browser tools) can connect to the same Chrome.
+
 **Editor-native via nREPL.** Evaluate ClojureScript from Neovim/Conjure buffers directly in the browser. No browser tab switching, no copy-paste.
 
 **Independent developer workflow.** The CLI is usable without any LLM. `cjig launch && cjig inject my-script && cjig repl` is a complete development loop with no AI in the path.
@@ -44,6 +46,45 @@ cjig eval-file bundle.js
 cjig repl
 ```
 
+## Working with MCP Tools
+
+cjig and MCP browser tools complement each other — both connect to Chrome via CDP on the same port.
+
+**cjig manages Chrome, MCP provides automation:**
+
+```bash
+# cjig launches Chrome with extensions and a debug port
+cjig launch --extensions ./my-extension/dist
+
+# Playwright MCP connects to the same Chrome
+# In your MCP client config:
+```
+
+```json
+{
+  "mcpServers": {
+    "playwright": {
+      "command": "npx",
+      "args": ["@playwright/mcp@latest", "--cdp-endpoint", "http://localhost:9222"]
+    }
+  }
+}
+```
+
+**If MCP already launched Chrome**, attach to it:
+
+```bash
+cjig attach --port 9222
+cjig eval "document.title"    # Now cjig commands work against MCP's Chrome
+```
+
+**Export connection info** for scripts:
+
+```bash
+cjig connection-info --json
+# {"host":"localhost","port":9222,"endpoint":"http://localhost:9222","webSocketDebuggerUrl":"ws://...","source":"launched","profile":"default"}
+```
+
 ## How It Works
 
 All evaluation uses CDP `Runtime.evaluate` in the page's **main world** — the same context as the DevTools console:
@@ -59,10 +100,13 @@ Each CLI invocation is a **fresh process**. Tab state does not persist between i
 ### Chrome Management
 
 ```bash
-cjig launch                    # Launch with default profile
-cjig launch --profile=testing  # Named profile
-cjig status                    # Check if Chrome is running
-cjig status --host=192.168.1.5 # Check remote Chrome
+cjig launch                           # Launch with default profile
+cjig launch --profile=testing         # Named profile
+cjig launch --extensions /path/to/ext # Load unpacked extension
+cjig attach --port 9333               # Attach to running Chrome
+cjig status                           # Check if Chrome is running
+cjig connection-info                  # Show connection details
+cjig connection-info --json           # JSON output for scripts
 ```
 
 ### Tab Operations
@@ -72,6 +116,9 @@ cjig tabs                          # List open tabs (index + title + URL)
 cjig tab "GitHub"                  # Select by title or URL fragment
 cjig tab 2                         # Select by index
 cjig open https://example.com      # Open new tab
+cjig open --timeout 60000 https://heavy-page.com  # Custom timeout
+cjig open --wait-until domcontentloaded https://example.com
+cjig open --no-wait https://slow-page.com          # Fire-and-forget
 ```
 
 Tab selector: numbers are positional indices, strings search URL and title.
@@ -113,6 +160,45 @@ Editors discover the port via `.nrepl-port` written to the current directory.
 
 The REPL and nREPL share a single connection. Tab switches in the REPL (`.tab`) take effect for nREPL evaluations too — no reconnection needed.
 
+### Profiles
+
+```bash
+cjig profiles list                                # List known profiles
+cjig profiles create myext --extensions /path/ext  # Create profile with extensions
+cjig launch --profile=myext                        # Launch with profile config
+```
+
+Profile configs live at `~/.config/cjig/profiles/<name>.json` and remember extensions, flags, and default URL. Login sessions persist across launches in the profile's Chrome user-data directory.
+
+### Extension Loading
+
+```bash
+# Via CLI flag
+cjig launch --extensions /path/to/unpacked-extension
+
+# Via project config (.cjig.json)
+{
+  "extensions": ["/path/to/unpacked-extension"]
+}
+
+# Via profile config
+cjig profiles create dev --extensions /path/to/ext
+cjig launch --profile=dev
+```
+
+Extensions from CLI flags, project config, profile config, and global config are merged (deduplicated by path).
+
+## Connecting from Playwright Scripts
+
+```js
+import { getConnectionInfo } from 'chrome-jig';
+import { chromium } from 'playwright';
+
+const { info } = await getConnectionInfo('localhost', 9222);
+const browser = await chromium.connectOverCDP(info.endpoint);
+// Now use Playwright's full API against cjig-managed Chrome
+```
+
 ## REPL Commands
 
 ```
@@ -144,6 +230,12 @@ The REPL and nREPL share a single connection. Tab switches in the REPL (`.tab`)
   "chrome": {
     "path": "/path/to/chrome",
     "flags": ["--disable-background-timer-throttling"]
+  },
+  "extensions": ["/path/to/global-extension"],
+  "connection": {
+    "retries": 3,
+    "retryDelayMs": 500,
+    "fallbackHosts": ["127.0.0.1"]
   }
 }
 ```
@@ -164,6 +256,7 @@ The REPL and nREPL share a single connection. Tab switches in the REPL (`.tab`)
       }
     }
   },
+  "extensions": ["/path/to/project-extension"],
   "watch": {
     "paths": ["dist/harnesses/*.js"],
     "debounce": 300
@@ -174,6 +267,64 @@ The REPL and nREPL share a single connection. Tab switches in the REPL (`.tab`)
 }
 ```
 
+### Profile Config (`~/.config/cjig/profiles/<name>.json`)
+
+```json
+{
+  "extensions": ["/path/to/extension"],
+  "flags": ["--auto-open-devtools-for-tabs"],
+  "url": "http://localhost:3000"
+}
+```
+
+Extension merge priority: CLI flags > project config > profile config > global config.
+
+### Connection Settings
+
+Connection resilience settings can be configured at any level (global, project, or CLI flags):
+
+```json
+{
+  "connection": {
+    "retries": 3,
+    "retryDelayMs": 500,
+    "timeout": 30000,
+    "waitUntil": "domcontentloaded",
+    "fallbackHosts": ["127.0.0.1"]
+  }
+}
+```
+
+| Field | Default | Description |
+|-------|---------|-------------|
+| `retries` | `3` | Number of connection retry attempts |
+| `retryDelayMs` | `500` | Initial delay between retries (doubles each attempt) |
+| `timeout` | (Playwright default) | Navigation timeout in ms for `open` |
+| `waitUntil` | `load` | Navigation strategy: `load`, `domcontentloaded`, `networkidle` |
+| `fallbackHosts` | `[]` | Additional hosts to try on connect failure (e.g. `["127.0.0.1"]` for IPv6/IPv4 issues) |
+
+CLI flags `--retries`, `--retry-delay`, `--timeout`, `--wait-until`, and `--no-wait` override config values.
+
+## Error Handling
+
+cjig uses typed exit codes for machine-parseable error handling:
+
+| Exit Code | Category | Retryable | Meaning |
+|-----------|----------|-----------|---------|
+| 0 | — | — | Success |
+| 1 | — | — | Unknown error |
+| 2 | `connection` | yes | Cannot connect to Chrome |
+| 3 | `timeout` | yes | Navigation timed out |
+| 4 | `no-page` | no | No page/tab available |
+| 5 | `evaluation` | no | JavaScript evaluation error |
+
+With `--json`, errors are emitted as structured JSON on stderr:
+
+```bash
+cjig eval --json --port 9999 "1+1"
+# stderr: {"error":"Failed to connect...","category":"connection","retryable":true,"exitCode":2}
+```
+
 ## Environment Variables
 
 | Variable       | Default       | Description       |
@@ -210,11 +361,13 @@ Then Claude can use it via the SKILL.md instructions.
 ```
 ~/.config/cjig/
 ├── config.json           # Global config
-└── profiles/             # Named config profiles
+└── profiles/             # Named profile configs
+    └── myext.json
 
 ~/.local/share/cjig/
 └── chrome-profiles/      # Chrome user-data dirs
-    └── default/
+    ├── default/
+    └── myext/
 
 ~/.local/state/cjig/
 └── last-session.json     # Session state

package/SKILL.md

@@ -1,24 +1,51 @@
+---
+name: chrome-jig
+description: CSP-proof browser debugging and JavaScript evaluation in Chrome via CDP. Use when you need to launch/attach Chrome, list tabs, inject scripts, evaluate JS/CLJS, or bridge Chrome to Playwright.
+---
+
 # Chrome Jig — Claude Skill
 
-## Purpose
+## What Chrome Jig Is
+
+CSP-proof JavaScript evaluation and injection CLI. Interactive browser debugging. Chrome lifecycle manager (profiles, extensions, sessions).
+
+## What Chrome Jig Is NOT
+
+Not a browser automation framework. Not a Playwright replacement. For scripted navigation, screenshots, DOM assertions, multi-page workflows — use Playwright directly.
+
+## The Handoff Model
+
+- cjig manages Chrome (launch, profiles, extensions, attach)
+- cjig provides CSP-proof eval/injection (Runtime.evaluate via CDP)
+- Playwright provides automation (connectOverCDP to cjig's Chrome)
+- `cjig connection-info` bridges the two
 
-Drive harness development workflows in Chrome from the command line. Launch isolated Chrome sessions, inject scripts, evaluate JavaScript, and manage the full inject → exercise → modify → re-inject development loop.
+## When to Use cjig vs Playwright
 
-## Mental Model
+| Task | Use | Why |
+|------|-----|-----|
+| Eval JS on a page you don't own (CSP) | `cjig eval` | CDP Runtime.evaluate bypasses CSP |
+| Inject a library into a live page | `cjig inject` | Server-side fetch + CDP eval, bypasses CSP and CORS |
+| Evaluate a file on any page | `cjig eval-file` | CSP-proof file evaluation |
+| Interactive browser debugging | `cjig repl` | Persistent session, dot-commands |
+| Launch Chrome with extensions | `cjig launch --extensions` | Managed profiles, separate user-data-dir |
+| Connect to MCP browser Chrome | `cjig attach` | Records session state for other cjig commands |
+| Get connection details for Playwright | `cjig connection-info` | JSON output with endpoint and wsUrl |
+| Scripted multi-page automation | Playwright directly | Not cjig's purpose |
+| Screenshots, assertions, DOM queries | Playwright directly | Playwright's native strengths |
+| Extension service worker testing | Playwright `launchPersistentContext` | Requires Target.attachToTarget |
 
-- **Session** = Chrome instance + profile + persisted state (cookies, localStorage, etc.)
-- **Harness** = named script from the project's script registry, injected into a page
-- **Lifecycle**: launch → navigate → inject → exercise → [modify → auto-reinject] → exercise
+## Before Using cjig for Automation
 
-The project's `.cjig.json` is the source of truth. Read it first to understand what scripts are available, what build hooks exist, and what file paths are watched.
+If your task involves scripted navigation, clicking, form filling, or multi-step browser automation: skip cjig and use Playwright directly. cjig's value is in what Playwright can't easily do from the outside (CSP bypass, script registry, interactive REPL).
 
 ## How It Works: CDP Evaluation
 
-All evaluation uses CDP `Runtime.evaluate` — the same mechanism as the DevTools console. This means:
+All evaluation uses CDP `Runtime.evaluate` in the page's **main world** — the same context as the DevTools console:
 
-- **CSP bypass**: Both `eval` and `inject` work on any page regardless of Content-Security-Policy headers. There are no script tags involved.
+- **CSP bypass**: Both `eval` and `inject` work on any page regardless of Content-Security-Policy headers. No script tags involved.
 - **Globals persist**: Variables assigned via `globalThis.foo = ...` survive across calls and are visible to page scripts.
-- **`inject` fetches server-side**: `cjig inject` fetches the script URL in the Node.js process (bypassing CORS), then evaluates the content via CDP. It does not create `<script>` elements.
+- **`inject` fetches server-side**: `cjig inject` fetches the script URL in the Node.js process (bypassing CORS), then evaluates the content via CDP.
 
 ## Speed Principle
 
@@ -31,59 +58,33 @@ Prefer `cjig` CLI commands over Chrome DevTools MCP tools whenever possible:
 
 **Fall back to Chrome DevTools MCP** only for capabilities the CLI lacks: screenshots, performance traces, network inspection, DOM snapshots, and visual page interaction.
 
-## When to Use What
-
-| Need | Tool | Why |
-|------|------|-----|
-| One expression, current tab | `cjig eval "expr"` | One-shot, fast |
-| One expression, specific tab | `cjig eval --tab <sel> "expr"` | Tab targeting in one process |
-| Inject a file into any page | `cjig eval-file bundle.js` | CSP-proof file evaluation |
-| Inject a named harness | `cjig inject <name>` | Registry lookup + CSP-proof inject |
-| Multi-step exploration | `cjig repl` | Persistent session, dot-commands |
-| Live dev with file watching | `cjig repl` then `.watch on` | Auto re-inject on file save |
-| Multi-page scripted automation | Playwright | Not cjig's purpose |
-
-Each CLI invocation is a **fresh process** — tab state does not persist between invocations. Use `--tab` to target a specific tab per command, or use the REPL for persistent sessions.
-
 ## Session Management
 
-- `cjig status` — check if Chrome is running
-- `cjig launch` — start Chrome with default profile
-- `cjig launch --profile=testing` — start with a named profile
-- Profiles are isolated from the user's normal browser
-- State persists across runs in `~/.local/share/cjig/chrome-profiles/`
-- Session metadata stored at `~/.local/state/cjig/`
-
-## Harness Workflow
-
-1. **Read project config**: check `.cjig.json` in the project root for `scripts.registry`
-2. **Launch Chrome** if not running: `cjig launch`
-3. **Navigate** to the target page: `cjig eval "location.href = 'http://...'"`
-4. **Inject harness** by name: `cjig inject <name>`
-5. **Exercise** via eval using `windowApi` or `alias` from the registry: `cjig eval "BS.overlayOn()"`
-6. **For iterative development**, suggest `.watch on` in the REPL for live reload on file save
-
-## Command Reference
-
-### Session
-
 | Command | Description |
 |---|---|
-| `cjig launch [--profile=NAME]` | Launch Chrome with debugging enabled |
+| `cjig launch` | Launch Chrome with default profile |
+| `cjig launch --profile=NAME` | Launch with named profile |
+| `cjig launch --extensions /path/to/ext` | Launch with unpacked extension |
+| `cjig attach --port 9333` | Attach to already-running Chrome |
 | `cjig status` | Check if Chrome is running |
+| `cjig connection-info` | Export connection info as JSON |
+| `cjig connection-info --json` | Machine-readable JSON output |
 
-### Tab Targeting
+## Tab Targeting
 
 | Command | Description |
 |---|---|
 | `cjig tabs` | List open tabs (index + title + URL) |
 | `cjig tab <pattern\|index>` | Switch to a tab by title/URL pattern or index |
 | `cjig open <url>` | Open a new tab |
+| `cjig open --timeout <ms> <url>` | Open with custom navigation timeout |
+| `cjig open --wait-until <strategy> <url>` | Wait strategy: `domcontentloaded\|load\|networkidle` |
+| `cjig open --no-wait <url>` | Fire-and-forget (don't wait for navigation) |
 | `--tab <selector>` | Flag for eval, eval-file, inject, cljs-eval |
 
 Tab selector: numbers select by index (0, 1, 2...), strings search URL and title.
 
-### Evaluation
+## Evaluation
 
 | Command | Description |
 |---|---|
@@ -94,14 +95,24 @@ Tab selector: numbers select by index (0, 1, 2...), strings search URL and title
 | `cjig cljs-eval <code>` | Compile ClojureScript and evaluate |
 | `cjig repl` | Start interactive REPL |
 
-### Harness
+## Harness
 
 | Command | Description |
 |---|---|
 | `cjig inject <name\|url>` | Inject a script by registry name or URL |
 | `cjig inject --tab <sel> <name>` | Inject into a specific tab |
 
-### Configuration
+## Profiles
+
+| Command | Description |
+|---|---|
+| `cjig profiles list` | List known profiles |
+| `cjig profiles create <name> --extensions ...` | Create a named profile with extensions |
+| `cjig launch --profile=NAME` | Launch with profile's saved config |
+
+Profiles remember extensions, flags, and default URL. Config stored at `~/.config/cjig/profiles/<name>.json`.
+
+## Configuration
 
 | Command | Description |
 |---|---|
@@ -111,6 +122,26 @@ Tab selector: numbers select by index (0, 1, 2...), strings search URL and title
 | `cjig install-skill` | Symlink skill to `~/.claude/skills/` |
 | `cjig uninstall-skill` | Remove skill symlink |
 
+## Connecting Playwright to cjig's Chrome
+
+```js
+import { getConnectionInfo } from 'chrome-jig';
+import { chromium } from 'playwright';
+
+const { info } = await getConnectionInfo('localhost', 9222);
+const browser = await chromium.connectOverCDP(info.endpoint);
+```
+
+Or from the command line:
+
+```bash
+# Get the endpoint
+cjig connection-info --json | jq -r '.endpoint'
+
+# Use with Playwright MCP
+# Configure --cdp-endpoint to point at cjig's Chrome port
+```
+
 ## Reading Project Config
 
 The `.cjig.json` file defines the development environment:
@@ -128,29 +159,61 @@ The `.cjig.json` file defines the development environment:
       }
     }
   },
+  "extensions": ["/path/to/unpacked-extension"],
+  "connection": {
+    "retries": 3,
+    "fallbackHosts": ["127.0.0.1"]
+  },
   "watch": {
     "paths": ["dist/harnesses/*.js"],
     "debounce": 300
-  },
-  "hooks": {
-    "preBuild": "pnpm build:harnesses"
   }
 }
 ```
 
 Key fields:
 
+- `extensions` — unpacked extension paths to load on launch
+- `connection.retries` — retry count for transient connect failures (default: 3)
+- `connection.fallbackHosts` — additional hosts to try (e.g. `["127.0.0.1"]` for IPv6 issues)
 - `scripts.registry[name].path` — script filename, resolved against `scripts.baseUrl`
-- `scripts.registry[name].windowApi` — the global object the script exposes (e.g., `window.BlockSegmenter`)
-- `scripts.registry[name].alias` — short name for the API (e.g., `BS`)
+- `scripts.registry[name].windowApi` — the global object the script exposes
+- `scripts.registry[name].alias` — short name for the API
 - `scripts.registry[name].quickStart` — example expression to try after injection
 - `watch.paths` — glob patterns for auto-reinject on file change
-- `hooks.preBuild` — build command run before injection
+
+## Harness Workflow
+
+1. **Read project config**: check `.cjig.json` in the project root for `scripts.registry`
+2. **Launch Chrome** if not running: `cjig launch`
+3. **Navigate** to the target page: `cjig eval "location.href = 'http://...'"`
+4. **Inject harness** by name: `cjig inject <name>`
+5. **Exercise** via eval using `windowApi` or `alias` from the registry
+6. **For iterative development**, suggest `.watch on` in the REPL for live reload
+
+## Connection Reliability
+
+All connection-using commands automatically retry up to 3 times with exponential backoff on transient failures (EPERM, ECONNREFUSED, timeout). Override with `--retries <n>` and `--retry-delay <ms>`.
+
+## Error Handling
+
+cjig uses typed exit codes:
+
+| Exit Code | Category | Meaning |
+|-----------|----------|---------|
+| 0 | — | Success |
+| 2 | `connection` | Cannot connect to Chrome |
+| 3 | `timeout` | Navigation timed out |
+| 4 | `no-page` | No page/tab available |
+| 5 | `evaluation` | JavaScript evaluation error |
+
+With `--json`, errors are structured JSON on stderr: `{"error":"...","category":"connection","retryable":true,"exitCode":2}`
 
 ## Limitations
 
-- Each `cjig` CLI invocation is a **fresh process**. Tab state does not persist between invocations. Use `--tab` to target a specific tab, or use `cjig repl` for a persistent session.
-- cjig is a **debugging and development tool**, not a browser automation framework. For scripted multi-page workflows across N URLs, use Playwright directly.
+- **Main world only**: All evaluation runs in the page's main world. No isolated world or extension service worker eval.
+- **Fresh process per invocation**: Tab state does not persist between CLI calls. Use `--tab` to target, or `cjig repl` for a persistent session.
+- **Not a browser automation framework**: For scripted multi-page workflows, use Playwright directly.
 - The REPL and nREPL share a single connection. Tab switches in the REPL (`.tab`) affect nREPL evaluations too.
 
 ## Anti-Patterns
@@ -160,3 +223,4 @@ Key fields:
 - Do not forget to check `cjig status` before attempting to connect
 - Do not skip reading `.cjig.json` — it tells you what harnesses exist and how to use them
 - Do not chain separate `cjig tab` + `cjig eval` invocations expecting tab state to persist — use `cjig eval --tab` instead
+- Do not use cjig for scripted automation — use Playwright and connect it to cjig's Chrome via `connection-info`

package/dist/chrome/connection.d.ts

@@ -13,6 +13,11 @@ export interface ConnectionOptions {
     host: string;
     port: number;
 }
+export interface OpenPageOptions {
+    timeout?: number;
+    waitUntil?: 'load' | 'domcontentloaded' | 'networkidle';
+    noWait?: boolean;
+}
 export declare class ChromeConnection {
     private options;
     private browser;
@@ -62,7 +67,7 @@ export declare class ChromeConnection {
     /**
      * Open a new page with the given URL
      */
-    openPage(url: string): Promise<Page>;
+    openPage(url: string, options?: OpenPageOptions): Promise<Page>;
     /**
      * Evaluate JavaScript in the current page via CDP Runtime.evaluate.
      * Runs in the page's main world (same as the browser console),

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

@@ -1 +1 @@
-{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/chrome/connection.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAqC,IAAI,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEtF,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,gBAAgB;IAMf,OAAO,CAAC,OAAO;IAL3B,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,UAAU,CAA2B;gBAEzB,OAAO,EAAE,iBAAiB;IAE9C,OAAO,CAAC,cAAc;IAKtB,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IASnC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAU1D;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAU5C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAe9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAKjC;;OAEG;IACH,cAAc,IAAI,IAAI,GAAG,IAAI;IAI7B;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAgBvD;;OAEG;IACG,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAW5D;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW1C;;;;OAIG;IACG,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAsBjD;;;;OAIG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9C;;;OAGG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ7B;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;CAW3C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GAAG,gBAAgB,CAK3F"}
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/chrome/connection.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAqC,IAAI,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGtF,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,aAAa,CAAC;IACxD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,gBAAgB;IAMf,OAAO,CAAC,OAAO;IAL3B,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,UAAU,CAA2B;gBAEzB,OAAO,EAAE,iBAAiB;IAE9C,OAAO,CAAC,cAAc;IAKtB,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IASnC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAU1D;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAU5C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAe9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAKjC;;OAEG;IACH,cAAc,IAAI,IAAI,GAAG,IAAI;IAI7B;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAgBvD;;OAEG;IACG,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAW5D;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BrE;;;;OAIG;IACG,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAsBjD;;;;OAIG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9C;;;OAGG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ7B;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;CAW3C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GAAG,gBAAgB,CAK3F"}

package/dist/chrome/connection.js

@@ -2,6 +2,7 @@
  * Chrome DevTools Protocol connection via Playwright
  */
 import { chromium } from 'playwright-core';
+import { NoPageError, EvaluationError, TimeoutError } from '../errors.js';
 export class ChromeConnection {
     options;
     browser = null;
@@ -136,12 +137,29 @@ export class ChromeConnection {
     /**
      * Open a new page with the given URL
      */
-    async openPage(url) {
+    async openPage(url, options) {
         if (!this.context) {
-            throw new Error('Not connected to Chrome');
+            throw new NoPageError('Not connected to Chrome');
         }
         const page = await this.context.newPage();
-        await page.goto(url);
+        if (options?.noWait) {
+            page.goto(url).catch(() => { }); // fire-and-forget
+        }
+        else {
+            try {
+                await page.goto(url, {
+                    timeout: options?.timeout,
+                    waitUntil: options?.waitUntil,
+                });
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                if (msg.toLowerCase().includes('timeout')) {
+                    throw new TimeoutError(`Navigation timed out: ${url}`);
+                }
+                throw err;
+            }
+        }
         this.setCurrentPage(page);
         return page;
     }
@@ -152,7 +170,7 @@ export class ChromeConnection {
      */
     async evaluate(expression) {
         if (!this.currentPage) {
-            throw new Error('No page selected');
+            throw new NoPageError();
         }
         const cdp = await this.getCDPSession();
         const result = await cdp.send('Runtime.evaluate', {
@@ -164,7 +182,7 @@ export class ChromeConnection {
             const text = result.exceptionDetails.exception?.description
                 ?? result.exceptionDetails.text
                 ?? 'Evaluation failed';
-            throw new Error(text);
+            throw new EvaluationError(text);
         }
         return result.result.value;
     }
@@ -193,7 +211,7 @@ export class ChromeConnection {
      */
     async reload() {
         if (!this.currentPage) {
-            throw new Error('No page selected');
+            throw new NoPageError();
         }
         await this.currentPage.reload();
     }
@@ -202,7 +220,7 @@ export class ChromeConnection {
      */
     async getCDPSession() {
         if (!this.currentPage) {
-            throw new Error('No page selected');
+            throw new NoPageError();
         }
         if (!this.cdpSession) {
             this.cdpSession = await this.currentPage.context().newCDPSession(this.currentPage);

package/dist/chrome/connection.js.map

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

package/dist/chrome/launcher.d.ts

@@ -6,6 +6,7 @@ export interface LaunchOptions {
     profile: string;
     chromePath?: string;
     chromeFlags?: string[];
+    extensions?: string[];
     url?: string;
 }
 export interface LaunchResult {
@@ -15,10 +16,12 @@ export interface LaunchResult {
     port?: number;
     profile?: string;
 }
-interface SessionState {
+export interface SessionState {
     pid?: number;
     port: number;
+    host: string;
     profile: string;
+    source: 'launched' | 'attached';
     startedAt: string;
 }
 /**
@@ -33,6 +36,10 @@ export declare function isProfileLocked(profileDir: string): boolean;
  * Check if Chrome is already running on the specified port
  */
 export declare function isPortInUse(port: number, host?: string): Promise<boolean>;
+/**
+ * Save session state for later recovery
+ */
+export declare function saveSessionState(state: SessionState): void;
 /**
  * Load session state
  */
@@ -49,5 +56,4 @@ export declare function getStatus(host?: string, port?: number): Promise<{
     version?: Record<string, string>;
     session?: SessionState;
 }>;
-export {};
 //# sourceMappingURL=launcher.d.ts.map