agent-web-interface 4.4.0 → 4.5.1

package/README.md

@@ -100,8 +100,6 @@ Example workflows include:
 - Handling login and consent flows
 - Performing multi-step UI interactions with lower token usage
 
-See the `examples/` directory for concrete agent workflows.
-
 ---
 
 ## Claude Code
@@ -110,33 +108,30 @@ See the `examples/` directory for concrete agent workflows.
 # Basic (auto-launches browser)
 claude mcp add agent-web-interface -- npx agent-web-interface@latest
 
-# With auto-connect to your Chrome profile
-claude mcp add agent-web-interface -- npx agent-web-interface@latest --autoConnect
-
-# Headless mode
-claude mcp add agent-web-interface -- npx agent-web-interface@latest --headless
+# With auto-connect to your Chrome profile (set via env var)
+claude mcp add agent-web-interface -e AWI_CDP_URL=http://localhost:9222 -- npx agent-web-interface@latest
 ```
 
 ---
 
 ## CLI Arguments
 
-The server accepts the following arguments to configure browser initialization:
+The server accepts transport-level arguments only. Browser configuration is per-session via the `navigate` tool.
 
-| Argument                 | Description                                                     | Default          |
-| ------------------------ | --------------------------------------------------------------- | ---------------- |
-| `--headless=true\|false` | Run browser in headless mode                                    | `false`          |
-| `--browserUrl`           | HTTP endpoint to connect to existing browser                    | -                |
-| `--wsEndpoint`           | WebSocket endpoint to connect to existing browser               | -                |
-| `--autoConnect`          | Auto-connect to Chrome 144+ via DevToolsActivePort              | `false`          |
-| `--isolated`             | Use isolated temp profile instead of persistent                 | `false`          |
-| `--userDataDir`          | Chrome user data directory                                      | Platform default |
-| `--channel`              | Chrome channel (chrome, chrome-canary, chrome-beta, chrome-dev) | `chrome`         |
-| `--executablePath`       | Path to Chrome executable                                       | -                |
+| Argument      | Description                       | Default |
+| ------------- | --------------------------------- | ------- |
+| `--transport` | Transport mode: `stdio` or `http` | `stdio` |
+| `--port`      | Port for HTTP transport           | `3000`  |
 
-### Automatic Browser Initialization
+### Browser Session Configuration
 
-The browser is automatically launched or connected on the first tool call. No explicit initialization is needed.
+Browser initialization is automatic on the first tool call. The `navigate` tool accepts optional parameters to configure the session:
+
+| Parameter      | Description                                        | Default |
+| -------------- | -------------------------------------------------- | ------- |
+| `headless`     | Run browser in headless mode                       | `false` |
+| `isolated`     | Use an isolated temp profile instead of persistent | `false` |
+| `auto_connect` | Auto-connect to Chrome 144+ via DevToolsActivePort | `false` |
 
 Examples:
 
@@ -144,14 +139,11 @@ Examples:
 # Auto-launch visible browser (default)
 npx agent-web-interface
 
-# Launch headless browser
-npx agent-web-interface --headless
-
-# Auto-connect to Chrome with remote debugging enabled
-npx agent-web-interface --autoConnect
+# HTTP transport mode
+npx agent-web-interface --transport http --port 8080
 
-# Connect to specific endpoint
-npx agent-web-interface --browserUrl http://localhost:9222
+# Connect to existing CDP endpoint via env var
+AWI_CDP_URL=http://localhost:9222 npx agent-web-interface
 ```
 
 ---
@@ -162,14 +154,17 @@ To connect with your bookmarks, extensions, and logged-in sessions:
 
 1. Navigate to `chrome://inspect/#remote-debugging` in Chrome
 2. Enable remote debugging and allow the connection
-3. Use `--autoConnect` CLI argument
+3. Use the `auto_connect` parameter on the `navigate` tool, or set `AWI_CDP_URL`
 
 ```json
 {
   "mcpServers": {
     "agent-web-interface": {
       "command": "npx",
-      "args": ["agent-web-interface@latest", "--autoConnect"]
+      "args": ["agent-web-interface@latest"],
+      "env": {
+        "AWI_CDP_URL": "http://localhost:9222"
+      }
     }
   }
 }
@@ -179,11 +174,17 @@ To connect with your bookmarks, extensions, and logged-in sessions:
 
 ## Environment Variables
 
-| Variable           | Description                                        | Default     |
-| ------------------ | -------------------------------------------------- | ----------- |
-| `AWI_TRIM_REGIONS` | Set to `false` to disable region trimming globally | `true`      |
-| `CEF_BRIDGE_HOST`  | CDP host for browser connection                    | `127.0.0.1` |
-| `CEF_BRIDGE_PORT`  | CDP port for browser connection                    | `9223`      |
+| Variable           | Description                                              | Default     |
+| ------------------ | -------------------------------------------------------- | ----------- |
+| `AWI_CDP_URL`      | CDP endpoint (http or ws) to connect to existing browser | -           |
+| `AWI_TRIM_REGIONS` | Set to `false` to disable region trimming globally       | `true`      |
+| `TRANSPORT`        | Transport mode override (`http`)                         | -           |
+| `HTTP_HOST`        | Host for HTTP transport                                  | `127.0.0.1` |
+| `HTTP_PORT`        | Port for HTTP transport                                  | `3000`      |
+| `LOG_LEVEL`        | Logging level                                            | `info`      |
+| `CEF_BRIDGE_HOST`  | CDP host for CEF bridge connection                       | `127.0.0.1` |
+| `CEF_BRIDGE_PORT`  | CDP port for CEF bridge connection                       | `9223`      |
+| `CHROME_PATH`      | Path to Chrome executable (multi-tenant)                 | -           |
 
 ---
 

package/dist/src/browser/browser-session-config.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Browser Session Config
+ *
+ * Defines the browser configuration that agents can specify per session.
+ * Each session can independently choose to launch a new browser or connect
+ * to an existing one, with its own headless/headed preference.
+ *
+ * Env var AWI_CDP_URL overrides to connect to an existing CDP endpoint.
+ *
+ * @module browser/browser-session-config
+ */
+/**
+ * Per-session browser configuration.
+ *
+ * Agents pass browser preferences via the `navigate` tool's optional parameters.
+ * If not provided, sensible defaults are used (launch, headed, persistent profile).
+ */
+export interface BrowserSessionConfig {
+    /** Run browser in headless mode. Default: false */
+    headless?: boolean;
+    /** Use an isolated temp profile instead of persistent. Default: false */
+    isolated?: boolean;
+    /** Auto-connect to Chrome 144+ via DevToolsActivePort */
+    autoConnect?: boolean;
+}
+/**
+ * Returns sensible default browser configuration.
+ *
+ * Launch a headed Chrome with a persistent profile — the most common
+ * configuration for interactive browser automation.
+ */
+export declare function defaultBrowserConfig(): BrowserSessionConfig;
+//# sourceMappingURL=browser-session-config.d.ts.map

package/dist/src/browser/browser-session-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-session-config.d.ts","sourceRoot":"","sources":["../../../src/browser/browser-session-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,oBAAoB,CAM3D"}

package/dist/src/browser/browser-session-config.js

@@ -0,0 +1,25 @@
+/**
+ * Browser Session Config
+ *
+ * Defines the browser configuration that agents can specify per session.
+ * Each session can independently choose to launch a new browser or connect
+ * to an existing one, with its own headless/headed preference.
+ *
+ * Env var AWI_CDP_URL overrides to connect to an existing CDP endpoint.
+ *
+ * @module browser/browser-session-config
+ */
+/**
+ * Returns sensible default browser configuration.
+ *
+ * Launch a headed Chrome with a persistent profile — the most common
+ * configuration for interactive browser automation.
+ */
+export function defaultBrowserConfig() {
+    return {
+        headless: false,
+        isolated: false,
+        autoConnect: true,
+    };
+}
+//# sourceMappingURL=browser-session-config.js.map

package/dist/src/browser/browser-session-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-session-config.js","sourceRoot":"","sources":["../../../src/browser/browser-session-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAmBH;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,IAAI;KAClB,CAAC;AACJ,CAAC"}

package/dist/src/browser/ensure-browser.d.ts

@@ -2,38 +2,23 @@
  * Lazy Browser Initialization
  *
  * Ensures a browser is ready before tool execution.
- * If no browser is running, launches or connects based on CLI configuration.
+ * If no browser is running, launches or connects based on session configuration.
+ *
+ * When a persistent profile is in use and Chrome is already running (from a
+ * previous session or another agent), reconnects via DevToolsActivePort instead
+ * of failing on the profile lock.
+ *
+ * CDP endpoint can be set via AWI_CDP_URL env var (http or ws) to connect
+ * to an existing browser instead of launching.
  */
 import type { SessionManager } from './session-manager.js';
-/**
- * Options for lazy browser initialization.
- */
-export interface EnsureBrowserOptions {
-    /** Run browser in headless mode (default: false) */
-    headless?: boolean;
-    /** Use isolated temp profile (default: false) */
-    isolated?: boolean;
-    /** HTTP endpoint URL for connecting to existing browser */
-    browserUrl?: string;
-    /** WebSocket endpoint URL for connecting to existing browser */
-    wsEndpoint?: string;
-    /** Auto-connect to Chrome 144+ via DevToolsActivePort */
-    autoConnect?: boolean;
-    /** Chrome user data directory */
-    userDataDir?: string;
-    /** Chrome channel */
-    channel?: 'chrome' | 'chrome-canary' | 'chrome-beta' | 'chrome-dev';
-    /** Path to Chrome executable */
-    executablePath?: string;
-}
+import type { BrowserSessionConfig } from './browser-session-config.js';
 /**
  * Ensure browser is ready for tool execution.
  *
  * If browser is already running, returns immediately.
- * Otherwise, launches or connects based on provided options.
- *
- * @param session - SessionManager instance
- * @param options - Configuration options from CLI
+ * Otherwise, launches or connects based on provided config.
+ * Set AWI_CDP_URL env var to connect to an existing CDP endpoint.
  */
-export declare function ensureBrowserReady(session: SessionManager, options: EnsureBrowserOptions): Promise<void>;
+export declare function ensureBrowserReady(session: SessionManager, config: BrowserSessionConfig): Promise<void>;
 //# sourceMappingURL=ensure-browser.d.ts.map

package/dist/src/browser/ensure-browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ensure-browser.d.ts","sourceRoot":"","sources":["../../../src/browser/ensure-browser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,qBAAqB;IACrB,OAAO,CAAC,EAAE,QAAQ,GAAG,eAAe,GAAG,aAAa,GAAG,YAAY,CAAC;IAEpE,gCAAgC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AASD;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAwCf"}
+{"version":3,"file":"ensure-browser.d.ts","sourceRoot":"","sources":["../../../src/browser/ensure-browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AASxE;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAwFf"}

package/dist/src/browser/ensure-browser.js

@@ -2,64 +2,156 @@
  * Lazy Browser Initialization
  *
  * Ensures a browser is ready before tool execution.
- * If no browser is running, launches or connects based on CLI configuration.
+ * If no browser is running, launches or connects based on session configuration.
+ *
+ * When a persistent profile is in use and Chrome is already running (from a
+ * previous session or another agent), reconnects via DevToolsActivePort instead
+ * of failing on the profile lock.
+ *
+ * CDP endpoint can be set via AWI_CDP_URL env var (http or ws) to connect
+ * to an existing browser instead of launching.
  */
+import fs from 'node:fs';
+import path from 'node:path';
+import { DEFAULT_USER_DATA_DIR } from './session-manager.js';
+import { extractErrorMessage } from './connection-utils.js';
 import { getLogger } from '../shared/services/logging.service.js';
 const logger = getLogger();
-/**
- * Determine if we should connect to an existing browser vs launch new one.
- */
-function shouldConnect(options) {
-    return !!(options.browserUrl ?? options.wsEndpoint ?? options.autoConnect);
-}
+/** Short timeout for reconnect attempts — these are fast pre-checks, not full connections */
+const RECONNECT_TIMEOUT_MS = 5000;
 /**
  * Ensure browser is ready for tool execution.
  *
  * If browser is already running, returns immediately.
- * Otherwise, launches or connects based on provided options.
- *
- * @param session - SessionManager instance
- * @param options - Configuration options from CLI
+ * Otherwise, launches or connects based on provided config.
+ * Set AWI_CDP_URL env var to connect to an existing CDP endpoint.
  */
-export async function ensureBrowserReady(session, options) {
-    // Fast path: browser already running
+export async function ensureBrowserReady(session, config) {
     if (session.isRunning()) {
         return;
     }
-    const mode = shouldConnect(options) ? 'connect' : 'launch';
-    logger.info('Lazy browser initialization triggered', { mode });
-    try {
-        if (shouldConnect(options)) {
-            // Connect to existing browser
-            await session.connect({
-                browserURL: options.browserUrl,
-                browserWSEndpoint: options.wsEndpoint,
-                autoConnect: options.autoConnect,
-                userDataDir: options.userDataDir,
+    const inFlightPromise = session.connectionPromise;
+    if (session.connectionState === 'connecting' && inFlightPromise) {
+        logger.info('Awaiting in-flight browser connection');
+        await inFlightPromise;
+        return;
+    }
+    // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- empty string must be falsy
+    const cdpUrl = process.env.AWI_CDP_URL?.trim() || undefined;
+    // Explicit CDP URL — connect only, no fallback to launch
+    if (cdpUrl) {
+        logger.info('Lazy browser initialization triggered', { mode: 'connect', cdpUrl });
+        try {
+            await session.connect({ endpointUrl: cdpUrl });
+            logger.info('Browser initialized successfully', { mode: 'connect' });
+        }
+        catch (error) {
+            const msg = extractErrorMessage(error);
+            logger.error('Browser initialization failed', error instanceof Error ? error : undefined, {
+                mode: 'connect',
             });
+            throw new Error(`Failed to connect to CDP endpoint (${cdpUrl}): ${msg}. ` +
+                'Try removing AWI_CDP_URL to auto-connect to a running Chrome, or launch a new browser with auto_connect=false.');
         }
-        else {
-            // Launch new browser
-            await session.launch({
-                headless: options.headless ?? false,
-                isolated: options.isolated ?? false,
-                userDataDir: options.userDataDir,
-                channel: options.channel,
-                executablePath: options.executablePath,
+        return;
+    }
+    // Auto-connect: try connecting to an existing Chrome first, fall back to launch
+    if (config.autoConnect) {
+        logger.info('Attempting auto-connect to existing Chrome');
+        try {
+            await session.connect({ autoConnect: true });
+            logger.info('Auto-connected to existing Chrome');
+            return;
+        }
+        catch (error) {
+            logger.info('Auto-connect failed, falling back to launch', {
+                error: extractErrorMessage(error),
             });
         }
-        logger.info('Browser initialized successfully', { mode });
+    }
+    // Launch mode — try reconnecting to an existing browser first (persistent profiles only)
+    const profileDir = config.isolated ? undefined : DEFAULT_USER_DATA_DIR;
+    if (profileDir && (await hasPortFile(profileDir)) && (await tryReconnect(session, profileDir))) {
+        return;
+    }
+    // Launch a new browser
+    logger.info('Lazy browser initialization triggered', { mode: 'launch' });
+    try {
+        await session.launch({
+            headless: config.headless ?? false,
+            isolated: config.isolated ?? false,
+        });
+        logger.info('Browser initialized successfully', { mode: 'launch' });
     }
     catch (error) {
+        // Another process may have grabbed the profile between our reconnect attempt
+        // and launch (race condition). Try reconnecting one more time.
+        if (profileDir && isProfileLockError(error) && (await tryReconnect(session, profileDir))) {
+            return;
+        }
+        const msg = extractErrorMessage(error);
         logger.error('Browser initialization failed', error instanceof Error ? error : undefined, {
-            mode,
-            browserUrl: options.browserUrl,
-            wsEndpoint: options.wsEndpoint,
-            autoConnect: options.autoConnect,
-            headless: options.headless,
-            userDataDir: options.userDataDir,
+            mode: 'launch',
+            headless: config.headless,
+        });
+        const suggestions = [];
+        if (!config.headless) {
+            suggestions.push('try headless=true if no display is available');
+        }
+        if (!config.isolated) {
+            suggestions.push('try isolated=true to use a fresh profile');
+        }
+        if (config.headless) {
+            suggestions.push('try headless=false to launch a visible browser');
+        }
+        const hint = suggestions.length > 0 ? ` Suggestions: ${suggestions.join('; ')}.` : '';
+        throw new Error(`Failed to launch browser: ${msg}.${hint}`);
+    }
+}
+/**
+ * Check if DevToolsActivePort file exists in the profile directory.
+ * Used to skip the reconnect attempt entirely on cold starts where
+ * Chrome has never run, avoiding wasted I/O.
+ */
+async function hasPortFile(profileDir) {
+    try {
+        await fs.promises.access(path.join(profileDir, 'DevToolsActivePort'), fs.constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Attempt to reconnect to an existing Chrome via its DevToolsActivePort file.
+ * Returns true on success. On failure, returns false.
+ * Uses a short timeout since this is a fast pre-check, not a full connection attempt.
+ */
+async function tryReconnect(session, profileDir) {
+    try {
+        await session.connect({
+            autoConnect: true,
+            userDataDir: profileDir,
+            ownedReconnect: true,
+            timeout: RECONNECT_TIMEOUT_MS,
+        });
+        logger.info('Reconnected to existing browser');
+        return true;
+    }
+    catch (error) {
+        logger.warning('Reconnect to existing browser failed', {
+            error: extractErrorMessage(error),
         });
-        throw error;
+        return false;
     }
 }
+/**
+ * Detect Chrome profile-lock errors from Puppeteer.
+ * Matches against Puppeteer's error text which includes "already running for <path>"
+ * when the SingletonLock file prevents a second Chrome instance.
+ */
+function isProfileLockError(error) {
+    const msg = extractErrorMessage(error);
+    return /already running for|already in use|SingletonLock/i.test(msg);
+}
 //# sourceMappingURL=ensure-browser.js.map

package/dist/src/browser/ensure-browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"ensure-browser.js","sourceRoot":"","sources":["../../../src/browser/ensure-browser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAElE,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;AA+B3B;;GAEG;AACH,SAAS,aAAa,CAAC,OAA6B;IAClD,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;AAC7E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAuB,EACvB,OAA6B;IAE7B,qCAAqC;IACrC,IAAI,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC3D,MAAM,CAAC,IAAI,CAAC,uCAAuC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/D,IAAI,CAAC;QACH,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,8BAA8B;YAC9B,MAAM,OAAO,CAAC,OAAO,CAAC;gBACpB,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,iBAAiB,EAAE,OAAO,CAAC,UAAU;gBACrC,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,WAAW,EAAE,OAAO,CAAC,WAAW;aACjC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,qBAAqB;YACrB,MAAM,OAAO,CAAC,MAAM,CAAC;gBACnB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;gBACnC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;gBACnC,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,cAAc,EAAE,OAAO,CAAC,cAAc;aACvC,CAAC,CAAC;QACL,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE;YACxF,IAAI;YACJ,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAC;QACH,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"ensure-browser.js","sourceRoot":"","sources":["../../../src/browser/ensure-browser.ts"],"names":[],"mappings":"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"}

package/dist/src/browser/index.d.ts

@@ -5,6 +5,7 @@
  */
 export { PageRegistry, type PageHandle } from './page-registry.js';
 export { SessionManager } from './session-manager.js';
-export type { LaunchOptions, ConnectOptions, ConnectionState, ConnectionStateChangeEvent, } from './session-manager.types.js';
+export type { ChromeChannel, LaunchOptions, ConnectOptions, ConnectionState, ConnectionStateChangeEvent, } from './session-manager.types.js';
+export { CHROME_CHANNELS } from './session-manager.types.js';
 export { extractErrorMessage } from './connection-utils.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/browser/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EACV,aAAa,EACb,cAAc,EACd,eAAe,EACf,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EACV,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/src/browser/index.js

@@ -5,5 +5,6 @@
  */
 export { PageRegistry } from './page-registry.js';
 export { SessionManager } from './session-manager.js';
+export { CHROME_CHANNELS } from './session-manager.types.js';
 export { extractErrorMessage } from './connection-utils.js';
 //# sourceMappingURL=index.js.map

package/dist/src/browser/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAmB,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAOtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAmB,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQtD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/src/browser/page-network-recorder.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Page Network Recorder
+ *
+ * Records network request/response details per page for the
+ * list_network_calls and search_network_calls tools.
+ *
+ * Uses Puppeteer page events (request, requestfinished, requestfailed)
+ * to capture entries. Memory-bounded via a ring buffer with
+ * configurable max entries.
+ *
+ * Follows the same lifecycle pattern as PageNetworkTracker:
+ * attach() → markNavigation() → detach()
+ */
+import type { Page } from 'puppeteer-core';
+export interface NetworkEntry {
+    id: number;
+    url: string;
+    method: string;
+    resource_type: string;
+    is_navigation: boolean;
+    request_headers: Record<string, string>;
+    post_data: string | null;
+    started_at: number;
+    status: number | null;
+    status_text: string | null;
+    response_headers: Record<string, string> | null;
+    mime_type: string | null;
+    duration_ms: number | null;
+    failed: boolean;
+    failure_text: string | null;
+    navigation_id: number;
+}
+export interface NetworkFilter {
+    url_pattern?: string;
+    url_regex?: boolean;
+    method?: string;
+    resource_type?: string;
+    status_min?: number;
+    status_max?: number;
+    failed_only?: boolean;
+}
+export interface NetworkQueryResult {
+    entries: NetworkEntry[];
+    total: number;
+}
+/**
+ * Records network request/response details for a single page.
+ *
+ * Uses a ring buffer (fixed-size array with head pointer) for O(1)
+ * insertion and eviction instead of Array.shift().
+ */
+export declare class PageNetworkRecorder {
+    private buffer;
+    private head;
+    private count;
+    private nextId;
+    private navigationId;
+    private maxEntries;
+    private page;
+    private generation;
+    private currentGeneration;
+    /** Map from HTTPRequest to NetworkEntry for response correlation */
+    private pending;
+    private onRequest;
+    private onRequestFinished;
+    private onRequestFailed;
+    constructor(maxEntries?: number);
+    attach(page: Page): void;
+    detach(): void;
+    markNavigation(): void;
+    getEntries(filter?: NetworkFilter, offset?: number, limit?: number): NetworkQueryResult;
+    search(urlPattern: string, isRegex?: boolean, filter?: NetworkFilter, limit?: number): NetworkQueryResult;
+    clear(): void;
+    getStats(): {
+        total: number;
+        pending: number;
+        failed: number;
+        by_resource_type: Record<string, number>;
+    };
+    isAttached(): boolean;
+    /** Iterate entries in insertion order (oldest first). */
+    private iterEntries;
+    /** Compile a URL regex once, with a safety check for pathological patterns. */
+    private compileUrlRegex;
+    private applyFilter;
+    /** Add an entry, evicting the oldest if at capacity. O(1). */
+    private addEntry;
+    private pickHeaders;
+    private createAndAttachHandlers;
+    private removeHandlers;
+}
+export declare function getOrCreateRecorder(page: Page, maxEntries?: number): PageNetworkRecorder;
+export declare function removeRecorder(page: Page): void;
+export declare function hasRecorder(page: Page): boolean;
+//# sourceMappingURL=page-network-recorder.d.ts.map

package/dist/src/browser/page-network-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-network-recorder.d.ts","sourceRoot":"","sources":["../../../src/browser/page-network-recorder.ts"],"names":[],"mappings":"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"}