agent-web-interface 4.3.0 → 4.4.0

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

@@ -0,0 +1,90 @@
+/**
+ * Session Manager Types
+ *
+ * Type definitions for browser session management.
+ */
+/**
+ * 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?: 'chrome' | 'chrome-canary' | 'chrome-beta' | 'chrome-dev';
+    /** 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 (default: true, more secure) */
+    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;
+}
+//# 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;;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,QAAQ,GAAG,eAAe,GAAG,aAAa,GAAG,YAAY,CAAC;IAEpE,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,2EAA2E;IAC3E,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;CACtB"}

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

@@ -0,0 +1,7 @@
+/**
+ * Session Manager Types
+ *
+ * Type definitions for browser session management.
+ */
+export {};
+//# 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"}

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

@@ -0,0 +1,31 @@
+/**
+ * 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;
+/**
+ * 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;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,GAAG,WAAW,EAAE,CAuB7F;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,110 @@
+/**
+ * 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;
+}
+/**
+ * Extract options for radio button groups.
+ */
+export function extractRadioOptions(node, snapshot) {
+    const options = [];
+    // Find all radio buttons in the same region/group
+    const radioButtons = snapshot.nodes.filter((n) => n.kind === 'radio' &&
+        n.where.region === node.where.region &&
+        (n.where.heading_context === node.where.heading_context ||
+            n.where.group_id === node.where.group_id));
+    for (const radio of radioButtons) {
+        options.push({
+            value: radio.label,
+            label: radio.label,
+            selected: radio.state?.checked ?? false,
+            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;AAiED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,YAAY,EACtB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,mBAAmB,GAC1B,SAAS,GAAG,IAAI,CAIlB"}