agent-web-interface 4.3.0 → 4.5.0

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

@@ -0,0 +1,102 @@
+/**
+ * Session Manager Types
+ *
+ * Type definitions for browser session management.
+ */
+/**
+ * Supported Chrome release channels.
+ * Single source of truth — used by LaunchOptions, BrowserSessionConfig, and Zod schemas.
+ */
+export declare const CHROME_CHANNELS: readonly ["chrome", "chrome-canary", "chrome-beta", "chrome-dev"];
+/** Chrome release channel type derived from the canonical const array. */
+export type ChromeChannel = (typeof CHROME_CHANNELS)[number];
+/**
+ * Connection state machine states
+ */
+export type ConnectionState = 'idle' | 'connecting' | 'connected' | 'disconnecting' | 'failed';
+/**
+ * Event emitted on connection state changes
+ */
+export interface ConnectionStateChangeEvent {
+    previousState: ConnectionState;
+    currentState: ConnectionState;
+    timestamp: Date;
+}
+/**
+ * Storage state for cookies and localStorage.
+ * Puppeteer doesn't have a built-in storageState type like Playwright.
+ */
+export interface StorageState {
+    cookies: {
+        name: string;
+        value: string;
+        domain: string;
+        path: string;
+        expires: number;
+        httpOnly: boolean;
+        secure: boolean;
+        sameSite?: 'Strict' | 'Lax' | 'None';
+    }[];
+    origins: {
+        origin: string;
+        localStorage: {
+            name: string;
+            value: string;
+        }[];
+    }[];
+}
+/**
+ * Options for launching a new browser
+ */
+export interface LaunchOptions {
+    /** Run browser in headless mode (default: false) */
+    headless?: boolean;
+    /** Viewport dimensions */
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    /** Chrome channel to use */
+    channel?: ChromeChannel;
+    /** Path to Chrome executable (overrides channel) */
+    executablePath?: string;
+    /** Use isolated temp profile instead of persistent (default: false) */
+    isolated?: boolean;
+    /** Directory for persistent browser profile (user data dir) */
+    userDataDir?: string;
+    /** Additional Chrome command-line arguments */
+    args?: string[];
+    /** Use pipe transport instead of WebSocket. Defaults to true for isolated profiles, false for persistent (enables reconnection). */
+    pipe?: boolean;
+}
+/**
+ * Options for connecting to an existing browser via CDP
+ */
+export interface ConnectOptions {
+    /** WebSocket endpoint URL (e.g., ws://localhost:9222/devtools/browser/...) */
+    browserWSEndpoint?: string;
+    /** HTTP endpoint URL for Puppeteer to discover WebSocket (e.g., http://localhost:9222) */
+    browserURL?: string;
+    /** CDP endpoint URL (legacy, converted to browserURL) */
+    endpointUrl?: string;
+    /** CDP host (default: 127.0.0.1) - used if no endpoint provided */
+    host?: string;
+    /** CDP port (default: 9223) - used if no endpoint provided */
+    port?: number;
+    /** Connection timeout in ms (default: 30000) */
+    timeout?: number;
+    /**
+     * Auto-connect to Chrome 144+ with UI-based remote debugging enabled.
+     * Reads DevToolsActivePort file from Chrome's user data directory.
+     * Requires user to enable remote debugging at chrome://inspect/#remote-debugging
+     */
+    autoConnect?: boolean;
+    /** Chrome user data directory for autoConnect (default: ~/.config/google-chrome on Linux) */
+    userDataDir?: string;
+    /**
+     * Treat connected browser as owned (close on shutdown instead of disconnect).
+     * Use when reconnecting to a browser that this server originally launched.
+     */
+    ownedReconnect?: boolean;
+}
+//# sourceMappingURL=session-manager.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.types.d.ts","sourceRoot":"","sources":["../../../src/browser/session-manager.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe,mEAAoE,CAAC;AAEjG,0EAA0E;AAC1E,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,eAAe,GAAG,QAAQ,CAAC;AAE/F;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,eAAe,CAAC;IAC/B,YAAY,EAAE,eAAe,CAAC;IAC9B,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,OAAO,CAAC;QAClB,MAAM,EAAE,OAAO,CAAC;QAChB,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;KACtC,EAAE,CAAC;IACJ,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KACjD,EAAE,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAE7C,4BAA4B;IAC5B,OAAO,CAAC,EAAE,aAAa,CAAC;IAExB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,oIAAoI;IACpI,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,6FAA6F;IAC7F,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B"}

package/dist/src/browser/session-manager.types.js

@@ -0,0 +1,11 @@
+/**
+ * Session Manager Types
+ *
+ * Type definitions for browser session management.
+ */
+/**
+ * Supported Chrome release channels.
+ * Single source of truth — used by LaunchOptions, BrowserSessionConfig, and Zod schemas.
+ */
+export const CHROME_CHANNELS = ['chrome', 'chrome-canary', 'chrome-beta', 'chrome-dev'];
+//# sourceMappingURL=session-manager.types.js.map

package/dist/src/browser/session-manager.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.types.js","sourceRoot":"","sources":["../../../src/browser/session-manager.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,CAAU,CAAC"}

package/dist/src/cli/args.d.ts

@@ -2,28 +2,22 @@
  * CLI Argument Parsing
  *
  * Parses command-line arguments for server configuration.
- * All browser initialization is controlled via these arguments.
+ * Browser configuration is per-session (via navigate tool params),
+ * so only transport-level settings remain here.
  */
+/** Transport mode for the MCP server */
+export type TransportMode = 'stdio' | 'http';
 /**
- * Server configuration from CLI arguments
+ * Server configuration from CLI arguments.
+ *
+ * Contains only server-level settings. Browser preferences are
+ * per-session and configured via the navigate tool's optional parameters.
  */
 export interface ServerArgs {
-    /** Run browser in headless mode (default: false) */
-    headless: boolean;
-    /** Use isolated temp profile instead of persistent (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 to use */
-    channel?: 'chrome' | 'chrome-canary' | 'chrome-beta' | 'chrome-dev';
-    /** Path to Chrome executable */
-    executablePath?: string;
+    /** Transport mode: stdio (default) or http */
+    transport: TransportMode;
+    /** Port for HTTP transport (default: 3000) */
+    port: number;
 }
 /**
  * Parse command-line arguments into ServerArgs.

package/dist/src/cli/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../../src/cli/args.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,oDAAoD;IACpD,QAAQ,EAAE,OAAO,CAAC;IAElB,uEAAuE;IACvE,QAAQ,EAAE,OAAO,CAAC;IAElB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,yDAAyD;IACzD,WAAW,EAAE,OAAO,CAAC;IAErB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,QAAQ,GAAG,eAAe,GAAG,aAAa,GAAG,YAAY,CAAC;IAEpE,gCAAgC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAwBD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAmCpD"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../../src/cli/args.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wCAAwC;AACxC,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,8CAA8C;IAC9C,SAAS,EAAE,aAAa,CAAC;IAEzB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;CACd;AAeD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA2CpD"}

package/dist/src/cli/args.js

@@ -2,19 +2,11 @@
  * CLI Argument Parsing
  *
  * Parses command-line arguments for server configuration.
- * All browser initialization is controlled via these arguments.
+ * Browser configuration is per-session (via navigate tool params),
+ * so only transport-level settings remain here.
  */
 /** Known CLI argument base names for validation */
-const KNOWN_ARG_NAMES = new Set([
-    'headless',
-    'isolated',
-    'autoConnect',
-    'browserUrl',
-    'wsEndpoint',
-    'userDataDir',
-    'channel',
-    'executablePath',
-]);
+const KNOWN_ARG_NAMES = new Set(['transport', 'port']);
 /**
  * Check if an argument is a known CLI flag (handles --arg and --arg=value forms).
  */
@@ -33,44 +25,47 @@ function isKnownArg(arg) {
  */
 export function parseArgs(argv) {
     const args = {
-        headless: false,
-        isolated: false,
-        autoConnect: false,
+        transport: 'stdio',
+        port: 3000,
     };
     for (let i = 0; i < argv.length; i++) {
         const arg = argv[i];
-        if (arg === '--headless=false' || arg === '--headless=0') {
-            args.headless = false;
+        if (arg === '--transport' && argv[i + 1]) {
+            const value = argv[++i];
+            if (value === 'stdio' || value === 'http') {
+                args.transport = value;
+            }
+            else {
+                console.warn(`Warning: Unknown transport "${value}" - defaulting to stdio`);
+            }
         }
-        else if (arg === '--headless=true' || arg === '--headless=1' || arg === '--headless') {
-            args.headless = true;
-        }
-        else if (arg === '--isolated') {
-            args.isolated = true;
-        }
-        else if (arg === '--autoConnect') {
-            args.autoConnect = true;
-        }
-        else if (arg === '--browserUrl' && argv[i + 1]) {
-            args.browserUrl = argv[++i];
-        }
-        else if (arg === '--wsEndpoint' && argv[i + 1]) {
-            args.wsEndpoint = argv[++i];
-        }
-        else if (arg === '--userDataDir' && argv[i + 1]) {
-            args.userDataDir = argv[++i];
-        }
-        else if (arg === '--channel' && argv[i + 1]) {
-            args.channel = argv[++i];
-        }
-        else if (arg === '--executablePath' && argv[i + 1]) {
-            args.executablePath = argv[++i];
+        else if (arg === '--port' && argv[i + 1]) {
+            const parsed = parseInt(argv[++i], 10);
+            if (isNaN(parsed) || parsed < 1 || parsed > 65535) {
+                console.warn(`Warning: Invalid port "${argv[i]}" - defaulting to 3000`);
+            }
+            else {
+                args.port = parsed;
+            }
         }
         else if (!isKnownArg(arg)) {
-            // Warn about unknown arguments to catch typos like --hedless
+            // Warn about unknown arguments to catch typos
             console.warn(`Warning: Unknown argument "${arg}" - ignored`);
         }
     }
+    // Environment variable overrides for transport settings
+    if (process.env.TRANSPORT === 'http') {
+        args.transport = 'http';
+    }
+    if (process.env.HTTP_PORT) {
+        const parsed = parseInt(process.env.HTTP_PORT, 10);
+        if (isNaN(parsed) || parsed < 1 || parsed > 65535) {
+            console.warn(`Warning: Invalid HTTP_PORT "${process.env.HTTP_PORT}" - defaulting to 3000`);
+        }
+        else {
+            args.port = parsed;
+        }
+    }
     return args;
 }
 //# sourceMappingURL=args.js.map

package/dist/src/cli/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../../../src/cli/args.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+BH,mDAAmD;AACnD,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,UAAU;IACV,UAAU;IACV,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,SAAS;IACT,gBAAgB;CACjB,CAAC,CAAC;AAEH;;GAEG;AACH,SAAS,UAAU,CAAC,GAAW;IAC7B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,8BAA8B;IACtE,MAAM,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,OAAO,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,IAAI,GAAe;QACvB,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,KAAK;KACnB,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpB,IAAI,GAAG,KAAK,kBAAkB,IAAI,GAAG,KAAK,cAAc,EAAE,CAAC;YACzD,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACxB,CAAC;aAAM,IAAI,GAAG,KAAK,iBAAiB,IAAI,GAAG,KAAK,cAAc,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;YACvF,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACvB,CAAC;aAAM,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;YAChC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACvB,CAAC;aAAM,IAAI,GAAG,KAAK,eAAe,EAAE,CAAC;YACnC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC;aAAM,IAAI,GAAG,KAAK,cAAc,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,GAAG,KAAK,cAAc,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,GAAG,KAAK,eAAe,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/B,CAAC;aAAM,IAAI,GAAG,KAAK,WAAW,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC9C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,CAA0B,CAAC;QACpD,CAAC;aAAM,IAAI,GAAG,KAAK,kBAAkB,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACrD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAClC,CAAC;aAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,6DAA6D;YAC7D,OAAO,CAAC,IAAI,CAAC,8BAA8B,GAAG,aAAa,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../../src/cli/args.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmBH,mDAAmD;AACnD,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvD;;GAEG;AACH,SAAS,UAAU,CAAC,GAAW;IAC7B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,8BAA8B;IACtE,MAAM,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,OAAO,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,IAAI,GAAe;QACvB,SAAS,EAAE,OAAO;QAClB,IAAI,EAAE,IAAI;KACX,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpB,IAAI,GAAG,KAAK,aAAa,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACxB,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;gBAC1C,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,+BAA+B,KAAK,yBAAyB,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvC,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,KAAK,EAAE,CAAC;gBAClD,OAAO,CAAC,IAAI,CAAC,0BAA0B,IAAI,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC;YAC1E,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC;YACrB,CAAC;QACH,CAAC;aAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,8CAA8C;YAC9C,OAAO,CAAC,IAAI,CAAC,8BAA8B,GAAG,aAAa,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,wDAAwD;IACxD,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACnD,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,KAAK,EAAE,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,+BAA+B,OAAO,CAAC,GAAG,CAAC,SAAS,wBAAwB,CAAC,CAAC;QAC7F,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/form/constraint-extraction.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Constraint Extraction
+ *
+ * Extracts validation constraints and options for form fields
+ * including required state, radio options, and select options.
+ *
+ * @module form/constraint-extraction
+ */
+import type { BaseSnapshot, ReadableNode } from '../snapshot/snapshot.types.js';
+import type { FieldConstraints, FieldOption } from './types.js';
+/**
+ * Extract constraints for a field.
+ */
+export declare function extractConstraints(node: ReadableNode, snapshot: BaseSnapshot): FieldConstraints;
+/**
+ * Check if two radio nodes belong to the same group.
+ * Uses `name` attribute as primary signal, falls back to heading/group context.
+ */
+export declare function sameRadioGroup(a: ReadableNode, b: ReadableNode): boolean;
+/**
+ * Extract options for radio button groups.
+ */
+export declare function extractRadioOptions(node: ReadableNode, snapshot: BaseSnapshot): FieldOption[];
+/**
+ * Extract options for select/combobox elements.
+ *
+ * Attempts to find option elements by looking for:
+ * 1. Nodes in the same group with 'listitem' kind
+ * 2. Nodes with 'menuitem' kind that share the same region/group
+ * 3. If value is set, creates a single option representing current selection
+ *
+ * Note: Full option extraction may require additional CDP calls.
+ * This provides a best-effort extraction from available snapshot data.
+ */
+export declare function extractSelectOptions(node: ReadableNode, snapshot: BaseSnapshot): FieldOption[];
+//# sourceMappingURL=constraint-extraction.d.ts.map

package/dist/src/form/constraint-extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraint-extraction.d.ts","sourceRoot":"","sources":["../../../src/form/constraint-extraction.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEhE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,GAAG,gBAAgB,CAkC/F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,OAAO,CAMxE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,GAAG,WAAW,EAAE,CAgB7F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,GAAG,WAAW,EAAE,CAwC9F"}

package/dist/src/form/constraint-extraction.js

@@ -0,0 +1,117 @@
+/**
+ * Constraint Extraction
+ *
+ * Extracts validation constraints and options for form fields
+ * including required state, radio options, and select options.
+ *
+ * @module form/constraint-extraction
+ */
+/**
+ * Extract constraints for a field.
+ */
+export function extractConstraints(node, snapshot) {
+    const constraints = {
+        required: false,
+        required_confidence: 0,
+    };
+    // Check required state
+    if (node.state?.required) {
+        constraints.required = true;
+        constraints.required_confidence = 1.0;
+    }
+    else {
+        // Check label for required indicators
+        const label = node.label.toLowerCase();
+        if (label.includes('*') || label.includes('required')) {
+            constraints.required = true;
+            constraints.required_confidence = 0.8;
+        }
+    }
+    // Extract options for select/radio/combobox
+    if (node.kind === 'radio') {
+        // Find related radio buttons with same name pattern
+        constraints.options = extractRadioOptions(node, snapshot);
+    }
+    else if (node.kind === 'combobox' || node.kind === 'select') {
+        // Extract options for select/combobox elements
+        constraints.options = extractSelectOptions(node, snapshot);
+    }
+    // TODO: Extract more constraints from DOM attributes
+    // - minlength, maxlength
+    // - min, max, step
+    // - pattern
+    return constraints;
+}
+/**
+ * Check if two radio nodes belong to the same group.
+ * Uses `name` attribute as primary signal, falls back to heading/group context.
+ */
+export function sameRadioGroup(a, b) {
+    if (a.where.region !== b.where.region)
+        return false;
+    if (a.attributes?.name && b.attributes?.name)
+        return a.attributes.name === b.attributes.name;
+    return (a.where.heading_context === b.where.heading_context || a.where.group_id === b.where.group_id);
+}
+/**
+ * Extract options for radio button groups.
+ */
+export function extractRadioOptions(node, snapshot) {
+    const options = [];
+    const radioButtons = snapshot.nodes.filter((n) => n.kind === 'radio' && sameRadioGroup(node, n));
+    for (const radio of radioButtons) {
+        options.push({
+            value: radio.label,
+            label: radio.label,
+            selected: radio.state?.checked === true || radio.state?.checked === 'mixed',
+            disabled: !(radio.state?.enabled ?? true),
+            eid: radio.node_id,
+        });
+    }
+    return options;
+}
+/**
+ * Extract options for select/combobox elements.
+ *
+ * Attempts to find option elements by looking for:
+ * 1. Nodes in the same group with 'listitem' kind
+ * 2. Nodes with 'menuitem' kind that share the same region/group
+ * 3. If value is set, creates a single option representing current selection
+ *
+ * Note: Full option extraction may require additional CDP calls.
+ * This provides a best-effort extraction from available snapshot data.
+ */
+export function extractSelectOptions(node, snapshot) {
+    const options = [];
+    // Look for listitem or menuitem nodes in the same group_id
+    if (node.where.group_id) {
+        const potentialOptions = snapshot.nodes.filter((n) => (n.kind === 'listitem' || n.kind === 'menuitem') &&
+            n.where.group_id === node.where.group_id &&
+            n.node_id !== node.node_id);
+        for (const opt of potentialOptions) {
+            const isSelected = opt.state?.selected ?? false;
+            options.push({
+                value: opt.label,
+                label: opt.label,
+                selected: isSelected,
+                disabled: !(opt.state?.enabled ?? true),
+                eid: opt.node_id,
+            });
+        }
+    }
+    // If we found options, return them
+    if (options.length > 0) {
+        return options;
+    }
+    // Fallback: if node has a value, create a single option for the current selection
+    // This at least lets us know what's currently selected even if we can't see all options
+    if (node.attributes?.value) {
+        options.push({
+            value: node.attributes.value,
+            label: node.attributes.value,
+            selected: true,
+        });
+    }
+    return options;
+}
+//# sourceMappingURL=constraint-extraction.js.map

package/dist/src/form/constraint-extraction.js.map

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

package/dist/src/form/field-extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field-extractor.d.ts","sourceRoot":"","sources":["../../../src/form/field-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EACV,SAAS,EAMT,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAuNpB;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,EAAE,mBAAmB,GAC1B,SAAS,EAAE,CAmBb;AAyVD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,YAAY,EACtB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,mBAAmB,GAC1B,SAAS,GAAG,IAAI,CAIlB"}
+{"version":3,"file":"field-extractor.d.ts","sourceRoot":"","sources":["../../../src/form/field-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAKjE;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,EAAE,mBAAmB,GAC1B,SAAS,EAAE,CAmBb;AAuED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,YAAY,EACtB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,mBAAmB,GAC1B,SAAS,GAAG,IAAI,CAIlB"}