agent-web-interface 4.4.0 → 4.5.0

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,CAK3D"}

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

@@ -0,0 +1,24 @@
+/**
+ * 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,
+    };
+}
+//# 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;KAChB,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,CA6Df"}

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

@@ -2,64 +2,131 @@
  * 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
+    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;
+    const shouldConnect = !!(cdpUrl ?? config.autoConnect);
+    if (shouldConnect) {
+        logger.info('Lazy browser initialization triggered', { mode: 'connect' });
+        try {
             await session.connect({
-                browserURL: options.browserUrl,
-                browserWSEndpoint: options.wsEndpoint,
-                autoConnect: options.autoConnect,
-                userDataDir: options.userDataDir,
+                endpointUrl: cdpUrl,
+                autoConnect: config.autoConnect,
             });
+            logger.info('Browser initialized successfully', { mode: 'connect' });
         }
-        else {
-            // Launch new browser
-            await session.launch({
-                headless: options.headless ?? false,
-                isolated: options.isolated ?? false,
-                userDataDir: options.userDataDir,
-                channel: options.channel,
-                executablePath: options.executablePath,
+        catch (error) {
+            logger.error('Browser initialization failed', error instanceof Error ? error : undefined, {
+                mode: 'connect',
             });
+            throw error;
         }
-        logger.info('Browser initialized successfully', { mode });
+        return;
+    }
+    // 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;
+        }
         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,
         });
         throw error;
     }
 }
+/**
+ * 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),
+        });
+        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/session-manager.d.ts

@@ -10,12 +10,17 @@ import type { ConnectionHealth } from '../state/health.types.js';
 import type { ConnectionState, ConnectionStateChangeEvent, StorageState, LaunchOptions, ConnectOptions } from './session-manager.types.js';
 /** Type alias for Puppeteer Page (exported for downstream use) */
 export type { Page };
+/** Default user data directory for persistent browser profiles */
+export declare const DEFAULT_USER_DATA_DIR: string;
 /**
  * Manages browser lifecycle and page creation.
  *
  * Supports two modes:
  * - launch(): Start a new browser instance
  * - connect(): Connect to an existing browser via CDP
+ *
+ * Each SessionController owns its own SessionManager instance for
+ * per-session browser isolation.
  */
 export declare class SessionManager {
     private browser;
@@ -31,11 +36,18 @@ export declare class SessionManager {
     private browserDisconnectHandler;
     /** Last known WebSocket endpoint, saved during detach() for potential reconnection */
     private _lastWsEndpoint;
+    /** Promise for in-flight launch/connect operation */
+    private _connectionPromise;
     constructor();
     /**
      * Get current connection state
      */
     get connectionState(): ConnectionState;
+    /**
+     * Get the in-flight connection promise, if any.
+     * Callers can await this instead of starting a duplicate launch/connect.
+     */
+    get connectionPromise(): Promise<void> | null;
     /**
      * Get the last known WebSocket endpoint URL.
      * Saved during detach() for potential reconnection to the same browser.
@@ -56,6 +68,10 @@ export declare class SessionManager {
      * @throws BrowserSessionError if browser is already running or connection in progress
      */
     launch(options?: LaunchOptions): Promise<void>;
+    /**
+     * Internal launch implementation with timeout.
+     */
+    private _doLaunch;
     /**
      * Connect to an existing browser via CDP.
      *
@@ -80,6 +96,10 @@ export declare class SessionManager {
      * ```
      */
     connect(options?: ConnectOptions): Promise<void>;
+    /**
+     * Internal connect implementation.
+     */
+    private _doConnect;
     /**
      * Get the number of pages in the browser context.
      *

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

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