agent-web-interface 4.2.0 → 4.4.0

package/dist/src/state/layer-detectors/modal-detector.js

@@ -0,0 +1,127 @@
+/**
+ * Modal Detector
+ *
+ * Detect modal layers in the snapshot.
+ * Patterns: role="dialog" + aria-modal, <dialog open>, portal containers.
+ */
+import { computeEid } from '../element-identity.js';
+/**
+ * Detect if node is a modal layer.
+ *
+ * Patterns:
+ * - role="dialog" or role="alertdialog" + aria-modal="true"
+ * - <dialog open>
+ * - High z-index (>1000) with dialog role
+ * - React/Vue portal containers with modal content
+ *
+ * @param node - Node to check
+ * @returns Layer candidate or null
+ */
+export function detectModal(node) {
+    const attrs = node.attributes;
+    const role = node.attributes?.role;
+    // Pattern 1: role="dialog" or role="alertdialog" + aria-modal="true"
+    if ((role === 'dialog' || role === 'alertdialog') && attrs?.['aria-modal'] === 'true') {
+        return {
+            type: 'modal',
+            rootEid: computeEid(node, 'modal'),
+            zIndex: node.layout.zIndex ?? 0,
+            isModal: true,
+            confidence: 1.0,
+        };
+    }
+    // Pattern 2: <dialog> element with open attribute
+    if (node.kind === 'dialog' && attrs?.open === true) {
+        return {
+            type: 'modal',
+            rootEid: computeEid(node, 'modal'),
+            zIndex: node.layout.zIndex ?? 0,
+            isModal: true,
+            confidence: 0.95,
+        };
+    }
+    // Pattern 3: alertdialog without aria-modal (still modal by nature)
+    if (role === 'alertdialog') {
+        return {
+            type: 'modal',
+            rootEid: computeEid(node, 'modal'),
+            zIndex: node.layout.zIndex ?? 0,
+            isModal: true,
+            confidence: 0.9,
+        };
+    }
+    // Pattern 4: High z-index dialog (>1000)
+    if (role === 'dialog' && (node.layout.zIndex ?? 0) > 1000) {
+        return {
+            type: 'modal',
+            rootEid: computeEid(node, 'modal'),
+            zIndex: node.layout.zIndex ?? 0,
+            isModal: true,
+            confidence: 0.8,
+        };
+    }
+    // Pattern 5: Portal container detection (React/Vue/Angular)
+    // Common portal container patterns
+    if (isPortalContainer(node, attrs)) {
+        return {
+            type: 'modal',
+            rootEid: computeEid(node, 'modal'),
+            zIndex: node.layout.zIndex ?? 0,
+            isModal: true,
+            confidence: 0.75,
+        };
+    }
+    return null;
+}
+/**
+ * Check if node is a portal container (React/Vue/Angular patterns).
+ *
+ * @param node - Node to check
+ * @param attrs - Node attributes
+ * @returns True if portal container
+ */
+export function isPortalContainer(node, attrs) {
+    const zIndex = node.layout.zIndex ?? 0;
+    // Must have high z-index
+    if (zIndex < 100) {
+        return false;
+    }
+    // Check for common portal container attributes/classes
+    const className = attrs?.class ?? attrs?.className;
+    if (typeof className === 'string') {
+        const portalPatterns = [
+            'modal',
+            'dialog',
+            'overlay',
+            'portal',
+            'ReactModal',
+            'MuiModal',
+            'chakra-modal',
+            'ant-modal',
+            'el-dialog', // Element UI
+            'v-dialog', // Vuetify
+        ];
+        const lowerClassName = className.toLowerCase();
+        if (portalPatterns.some((p) => lowerClassName.includes(p.toLowerCase()))) {
+            return true;
+        }
+    }
+    // Check for data attributes indicating portal
+    const dataPortal = attrs?.['data-portal'];
+    const dataOverlay = attrs?.['data-overlay'];
+    const dataModal = attrs?.['data-modal'];
+    if (dataPortal === true || dataOverlay === true || dataModal === true) {
+        return true;
+    }
+    // Check for aria-hidden siblings pattern (portal often has aria-hidden on root)
+    // This is detected by high z-index + covering most of viewport
+    const bbox = node.layout.bbox;
+    if (bbox && zIndex > 500) {
+        // If element covers significant viewport area with high z-index
+        if (bbox.w > 200 && bbox.h > 200) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=modal-detector.js.map

package/dist/src/state/layer-detectors/modal-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modal-detector.js","sourceRoot":"","sources":["../../../../src/state/layer-detectors/modal-detector.ts"],"names":[],"mappings":"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"}

package/dist/src/state/layer-detectors/popover-detector.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Popover Detector
+ *
+ * Detect popover layers in the snapshot.
+ * Patterns: role="menu", "listbox", "tooltip" + z-index > 100.
+ */
+import type { ReadableNode } from '../../snapshot/snapshot.types.js';
+import type { LayerCandidate } from '../types.js';
+/**
+ * Detect if node is a popover layer.
+ *
+ * Patterns:
+ * - role="menu", "listbox", "tooltip", "dialog" (non-modal) + z-index > 100
+ * - Dropdown/popup class patterns
+ *
+ * @param node - Node to check
+ * @returns Layer candidate or null
+ */
+export declare function detectPopover(node: ReadableNode): LayerCandidate | null;
+//# sourceMappingURL=popover-detector.d.ts.map

package/dist/src/state/layer-detectors/popover-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"popover-detector.d.ts","sourceRoot":"","sources":["../../../../src/state/layer-detectors/popover-detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,GAAG,IAAI,CA+DvE"}

package/dist/src/state/layer-detectors/popover-detector.js

@@ -0,0 +1,76 @@
+/**
+ * Popover Detector
+ *
+ * Detect popover layers in the snapshot.
+ * Patterns: role="menu", "listbox", "tooltip" + z-index > 100.
+ */
+import { computeEid } from '../element-identity.js';
+/**
+ * Detect if node is a popover layer.
+ *
+ * Patterns:
+ * - role="menu", "listbox", "tooltip", "dialog" (non-modal) + z-index > 100
+ * - Dropdown/popup class patterns
+ *
+ * @param node - Node to check
+ * @returns Layer candidate or null
+ */
+export function detectPopover(node) {
+    const role = node.attributes?.role;
+    const zIndex = node.layout.zIndex ?? 0;
+    const attrs = node.attributes;
+    if (zIndex <= 100) {
+        return null;
+    }
+    // Pattern 1: Standard popover roles
+    const popoverRoles = ['menu', 'listbox', 'tooltip', 'tree'];
+    if (role && popoverRoles.includes(role)) {
+        return {
+            type: 'popover',
+            rootEid: computeEid(node, 'popover'),
+            zIndex,
+            isModal: false,
+            confidence: 0.8,
+        };
+    }
+    // Pattern 2: Non-modal dialog (popup)
+    if (role === 'dialog' && attrs?.['aria-modal'] !== 'true') {
+        return {
+            type: 'popover',
+            rootEid: computeEid(node, 'popover'),
+            zIndex,
+            isModal: false,
+            confidence: 0.6,
+        };
+    }
+    // Pattern 3: Common popover/dropdown class patterns
+    const className = attrs?.class ?? attrs?.className;
+    if (typeof className === 'string') {
+        const popoverPatterns = [
+            'dropdown',
+            'popover',
+            'popup',
+            'tooltip',
+            'menu',
+            'autocomplete',
+            'suggestions',
+            'MuiPopover',
+            'MuiMenu',
+            'ant-dropdown',
+            'el-dropdown',
+            'el-popover',
+        ];
+        const lowerClassName = className.toLowerCase();
+        if (popoverPatterns.some((p) => lowerClassName.includes(p.toLowerCase()))) {
+            return {
+                type: 'popover',
+                rootEid: computeEid(node, 'popover'),
+                zIndex,
+                isModal: false,
+                confidence: 0.65,
+            };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=popover-detector.js.map

package/dist/src/state/layer-detectors/popover-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"popover-detector.js","sourceRoot":"","sources":["../../../../src/state/layer-detectors/popover-detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,IAAkB;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAiD,CAAC;IAErE,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oCAAoC;IACpC,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC5D,IAAI,IAAI,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,OAAO;YACL,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC;YACpC,MAAM;YACN,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,GAAG;SAChB,CAAC;IACJ,CAAC;IAED,sCAAsC;IACtC,IAAI,IAAI,KAAK,QAAQ,IAAI,KAAK,EAAE,CAAC,YAAY,CAAC,KAAK,MAAM,EAAE,CAAC;QAC1D,OAAO;YACL,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC;YACpC,MAAM;YACN,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,GAAG;SAChB,CAAC;IACJ,CAAC;IAED,oDAAoD;IACpD,MAAM,SAAS,GAAG,KAAK,EAAE,KAAK,IAAI,KAAK,EAAE,SAAS,CAAC;IACnD,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClC,MAAM,eAAe,GAAG;YACtB,UAAU;YACV,SAAS;YACT,OAAO;YACP,SAAS;YACT,MAAM;YACN,cAAc;YACd,aAAa;YACb,YAAY;YACZ,SAAS;YACT,cAAc;YACd,aAAa;YACb,YAAY;SACb,CAAC;QAEF,MAAM,cAAc,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;QAC/C,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC;YAC1E,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC;gBACpC,MAAM;gBACN,OAAO,EAAE,KAAK;gBACd,UAAU,EAAE,IAAI;aACjB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/state/layer-detectors/toast-detector.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Toast Detector
+ *
+ * Detect toast/alert overlay layers in the snapshot.
+ * Toast layers are non-blocking and never become the active layer.
+ */
+import type { ReadableNode } from '../../snapshot/snapshot.types.js';
+import type { LayerCandidate } from '../types.js';
+export declare const TOAST_ROLES: Set<string>;
+/**
+ * Detect if node is a toast/alert overlay layer.
+ *
+ * Patterns:
+ * - role="alert" or role="status" with high z-index (non-modal)
+ * - Live region kinds: alert, status, log, timer, progressbar with high z-index
+ *
+ * Toast layers are non-blocking — they appear in the layer stack but never
+ * become the active layer.
+ *
+ * @param node - Node to check
+ * @returns Layer candidate or null
+ */
+export declare function detectToast(node: ReadableNode): LayerCandidate | null;
+//# sourceMappingURL=toast-detector.d.ts.map

package/dist/src/state/layer-detectors/toast-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast-detector.d.ts","sourceRoot":"","sources":["../../../../src/state/layer-detectors/toast-detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlD,eAAO,MAAM,WAAW,aAA+B,CAAC;AAExD;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,GAAG,IAAI,CA4BrE"}

package/dist/src/state/layer-detectors/toast-detector.js

@@ -0,0 +1,48 @@
+/**
+ * Toast Detector
+ *
+ * Detect toast/alert overlay layers in the snapshot.
+ * Toast layers are non-blocking and never become the active layer.
+ */
+import { computeEid } from '../element-identity.js';
+import { isLiveRegionKind } from '../actionables-filter.js';
+// Roles that indicate toast-like overlays (non-modal alert/status patterns)
+export const TOAST_ROLES = new Set(['alert', 'status']);
+/**
+ * Detect if node is a toast/alert overlay layer.
+ *
+ * Patterns:
+ * - role="alert" or role="status" with high z-index (non-modal)
+ * - Live region kinds: alert, status, log, timer, progressbar with high z-index
+ *
+ * Toast layers are non-blocking — they appear in the layer stack but never
+ * become the active layer.
+ *
+ * @param node - Node to check
+ * @returns Layer candidate or null
+ */
+export function detectToast(node) {
+    const role = node.attributes?.role;
+    const zIndex = node.layout.zIndex ?? 0;
+    const attrs = node.attributes;
+    // Must have z-index > 100 to be considered a toast overlay
+    if (zIndex <= 100) {
+        return null;
+    }
+    // Must NOT be aria-modal (those are modals/alertdialogs, not toasts)
+    if (attrs?.['aria-modal'] === 'true') {
+        return null;
+    }
+    const hasToastRole = role !== undefined && TOAST_ROLES.has(role);
+    if (hasToastRole || isLiveRegionKind(node.kind)) {
+        return {
+            type: 'toast',
+            rootEid: computeEid(node, 'toast'),
+            zIndex,
+            isModal: false,
+            confidence: 0.7,
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=toast-detector.js.map

package/dist/src/state/layer-detectors/toast-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast-detector.js","sourceRoot":"","sources":["../../../../src/state/layer-detectors/toast-detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,4EAA4E;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAExD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CAAC,IAAkB;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAiD,CAAC;IAErE,2DAA2D;IAC3D,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qEAAqE;IACrE,IAAI,KAAK,EAAE,CAAC,YAAY,CAAC,KAAK,MAAM,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,KAAK,SAAS,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAEjE,IAAI,YAAY,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,OAAO;YACL,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC;YAClC,MAAM;YACN,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,GAAG;SAChB,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/state/region-mapping.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Region Mapping
+ *
+ * Extracts region-to-EID mappings from actionables for deduplication.
+ *
+ * @module state/region-mapping
+ */
+import type { ActionableInfo } from './types.js';
+/**
+ * Extract region → ordered eid list mapping from actionables.
+ */
+export declare function extractRegionEidMapping(actionables: ActionableInfo[]): Map<string, string[]>;
+//# sourceMappingURL=region-mapping.d.ts.map

package/dist/src/state/region-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"region-mapping.d.ts","sourceRoot":"","sources":["../../../src/state/region-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAc5F"}

package/dist/src/state/region-mapping.js

@@ -0,0 +1,25 @@
+/**
+ * Region Mapping
+ *
+ * Extracts region-to-EID mappings from actionables for deduplication.
+ *
+ * @module state/region-mapping
+ */
+import { normalizeRegion } from './state-renderer.js';
+/**
+ * Extract region → ordered eid list mapping from actionables.
+ */
+export function extractRegionEidMapping(actionables) {
+    const regions = new Map();
+    for (const item of actionables) {
+        const region = normalizeRegion(item.ctx.region);
+        let eids = regions.get(region);
+        if (!eids) {
+            eids = [];
+            regions.set(region, eids);
+        }
+        eids.push(item.eid);
+    }
+    return regions;
+}
+//# sourceMappingURL=region-mapping.js.map

package/dist/src/state/region-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"region-mapping.js","sourceRoot":"","sources":["../../../src/state/region-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,WAA6B;IACnE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE5C,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/state/state-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state-manager.d.ts","sourceRoot":"","sources":["../../../src/state/state-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EACV,aAAa,EAIb,kBAAkB,EAOlB,aAAa,EACd,MAAM,YAAY,CAAC;AASpB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AA0ExD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,eAAe,CAAkB;IAEzC;;;;OAIG;gBACS,OAAO,EAAE;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;KACtC;IAcD;;;OAGG;IACH,kBAAkB,IAAI,eAAe;IAIrC;;;OAGG;IACH,mBAAmB,IAAI,YAAY,GAAG,IAAI;IAI1C;;;OAGG;IACH,cAAc,IAAI,MAAM;IAQxB;;;;;OAKG;IACH,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa;IAI1D;;;;;;OAMG;IACH,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,aAAa;IAkChF;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyH1B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,eAAe;IAgBvB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IA+C3B;;;OAGG;IACH,OAAO,CAAC,mCAAmC;IAuE3C;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyC3B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAkFzB;;OAEG;IACH,OAAO,CAAC,cAAc;CAIvB"}
+{"version":3,"file":"state-manager.d.ts","sourceRoot":"","sources":["../../../src/state/state-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EACV,aAAa,EAIb,kBAAkB,EAOlB,aAAa,EACd,MAAM,YAAY,CAAC;AASpB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAoBxD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,eAAe,CAAkB;IAEzC;;;;OAIG;gBACS,OAAO,EAAE;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;KACtC;IAcD;;;OAGG;IACH,kBAAkB,IAAI,eAAe;IAIrC;;;OAGG;IACH,mBAAmB,IAAI,YAAY,GAAG,IAAI;IAI1C;;;OAGG;IACH,cAAc,IAAI,MAAM;IAQxB;;;;;OAKG;IACH,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa;IAI1D;;;;;;OAMG;IACH,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,aAAa;IAkChF;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyH1B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,eAAe;IAgBvB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IA+C3B;;;OAGG;IACH,OAAO,CAAC,mCAAmC;IAuE3C;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyC3B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAkFzB;;OAEG;IACH,OAAO,CAAC,cAAc;CAIvB"}

package/dist/src/state/state-manager.js

@@ -7,18 +7,22 @@
  * Security: Masks sensitive values (passwords, tokens) and sanitizes URLs.
  * Reliability: Includes concurrency protection and error recovery.
  */
-import { createHash, randomUUID } from 'crypto';
+import { randomUUID } from 'crypto';
 import { computeEid, resolveEidCollision } from './element-identity.js';
 import { detectLayers } from './layer-detector.js';
 import { computeDiff } from './diff-engine.js';
-import { selectActionables, isInteractiveKind } from './actionables-filter.js';
+import { selectActionables, isInteractiveKind, isLiveRegionKind } from './actionables-filter.js';
 import { getNodeLayer, INCLUSIVE_OVERLAY_LAYERS } from './node-layer.js';
 import { extractAtoms } from './atoms-extractor.js';
 import { linkObservationsToSnapshot } from '../observation/index.js';
 import { generateLocator } from './locator-generator.js';
 import { ElementRegistry } from './element-registry.js';
 import { validateSnapshotHealth, isErrorHealth } from '../snapshot/snapshot-health.js';
-import { renderStateXml, normalizeRegion } from './state-renderer.js';
+import { renderStateXml } from './state-renderer.js';
+import { maskValue } from './value-masking.js';
+import { sanitizeUrl, sanitizeHref } from './url-sanitization.js';
+import { computeDocId, computeUiHash, computeLayerHash } from './hash-utils.js';
+import { extractRegionEidMapping } from './region-mapping.js';
 // ============================================================================
 // Default Configuration
 // ============================================================================
@@ -26,59 +30,6 @@ const DEFAULT_CONFIG = {
     maxActionables: 1000, // Show all elements (practically unlimited)
 };
 // ============================================================================
-// Security: Sensitive Field Detection
-// ============================================================================
-/**
- * Sensitive field name patterns (case-insensitive).
- * Values in these fields will be masked.
- */
-const SENSITIVE_FIELD_PATTERNS = [
-    'password',
-    'passwd',
-    'pass',
-    'secret',
-    'token',
-    'auth',
-    'key',
-    'api_key',
-    'apikey',
-    'otp',
-    'pin',
-    'cvv',
-    'cvc',
-    'ssn',
-    'social',
-    'credit',
-    'card',
-];
-/**
- * Input types that should always be masked.
- */
-const MASKED_INPUT_TYPES = ['password'];
-/**
- * Input types with partial masking (show first/last chars).
- */
-const PARTIAL_MASK_TYPES = ['email', 'tel', 'phone'];
-/**
- * URL query parameters that are safe to keep.
- * All others will be stripped.
- */
-const SAFE_QUERY_PARAMS = new Set([
-    'page',
-    'p',
-    'sort',
-    'order',
-    'q',
-    'query',
-    'search',
-    'tab',
-    'view',
-    'limit',
-    'offset',
-    'lang',
-    'locale',
-]);
-// ============================================================================
 // State Manager Class
 // ============================================================================
 /**
@@ -225,7 +176,7 @@ export class StateManager {
         const actionables = this.formatActionables(actionableNodes, layerResult.active, snapshot.snapshot_id);
         // Count total actionables in active layer
         const skipLayerFilter = INCLUSIVE_OVERLAY_LAYERS.has(layerResult.active);
-        const totalInLayer = snapshot.nodes.filter((n) => isInteractiveKind(n.kind) &&
+        const totalInLayer = snapshot.nodes.filter((n) => (isInteractiveKind(n.kind) || isLiveRegionKind(n.kind)) &&
             n.state?.visible &&
             (skipLayerFilter || getNodeLayer(n, layerResult.active) === layerResult.active)).length;
         const counts = {
@@ -509,139 +460,4 @@ export class StateManager {
         return Math.ceil(jsonString.length / 4);
     }
 }
-// ============================================================================
-// Security: Value Masking
-// ============================================================================
-/**
- * Mask sensitive values in val_hint.
- *
- * Rules:
- * - password type: always full mask
- * - sensitive field names: always full mask
- * - email/tel: partial mask (show first/last chars)
- * - default: truncate to 12 chars, mask middle
- */
-function maskValue(value, inputType, label) {
-    // Strip newlines first
-    const cleanValue = value.replace(/[\r\n]/g, ' ').trim();
-    if (!cleanValue)
-        return '';
-    // Password type: always full mask
-    if (inputType && MASKED_INPUT_TYPES.includes(inputType.toLowerCase())) {
-        return '••••••••';
-    }
-    // Check sensitive field names
-    const lowerLabel = (label ?? '').toLowerCase();
-    for (const pattern of SENSITIVE_FIELD_PATTERNS) {
-        if (lowerLabel.includes(pattern)) {
-            return '***';
-        }
-    }
-    // Email/tel: partial mask
-    if (inputType && PARTIAL_MASK_TYPES.includes(inputType.toLowerCase())) {
-        return partialMask(cleanValue);
-    }
-    // Default: truncate and partial mask if long
-    if (cleanValue.length <= 12) {
-        return cleanValue;
-    }
-    return partialMask(cleanValue.substring(0, 12));
-}
-/**
- * Partial mask: show first 2 and last 2 chars.
- * Example: "example@email.com" -> "ex•••om"
- */
-function partialMask(value) {
-    if (value.length <= 4) {
-        return '••••';
-    }
-    const first = value.substring(0, 2);
-    const last = value.substring(value.length - 2);
-    return `${first}•••${last}`;
-}
-// ============================================================================
-// Security: URL Sanitization
-// ============================================================================
-/**
- * Sanitize URL by stripping sensitive query parameters.
- * Only keeps safe params like page, sort, q.
- */
-function sanitizeUrl(rawUrl) {
-    try {
-        const url = new URL(rawUrl);
-        // Build new search params with only safe ones
-        const safeParams = new URLSearchParams();
-        for (const [key, value] of url.searchParams) {
-            if (SAFE_QUERY_PARAMS.has(key.toLowerCase())) {
-                safeParams.set(key, value);
-            }
-        }
-        // Reconstruct URL with sanitized params
-        url.search = safeParams.toString();
-        return url.toString();
-    }
-    catch {
-        // If URL parsing fails, return origin only
-        return rawUrl.split('?')[0];
-    }
-}
-/**
- * Sanitize href attribute (remove tokens from URLs).
- */
-function sanitizeHref(href) {
-    // For relative URLs, return as-is
-    if (!href.startsWith('http://') && !href.startsWith('https://')) {
-        return href;
-    }
-    return sanitizeUrl(href);
-}
-// ============================================================================
-// Utilities
-// ============================================================================
-/**
- * Extract region → ordered eid list mapping from actionables.
- */
-function extractRegionEidMapping(actionables) {
-    const regions = new Map();
-    for (const item of actionables) {
-        const region = normalizeRegion(item.ctx.region);
-        let eids = regions.get(region);
-        if (!eids) {
-            eids = [];
-            regions.set(region, eids);
-        }
-        eids.push(item.eid);
-    }
-    return regions;
-}
-/**
- * Compute document ID from snapshot.
- *
- * Uses only URL origin + pathname for navigation detection.
- * This ensures DOM mutations (like autocomplete suggestions appearing)
- * are NOT falsely detected as navigation events.
- *
- * NOTE: Previously this included a hash of the first 10 interactive node IDs,
- * which caused false navigation detection when typing triggered autocomplete
- * or other dynamic UI updates. See: https://github.com/lespaceman/agent-web-interface/issues/XXX
- */
-function computeDocId(snapshot) {
-    const url = new URL(snapshot.url);
-    // Only use origin + pathname for navigation detection
-    // Query params and fragments are ignored (same page, different state)
-    return hash(`${url.origin}:${url.pathname}`);
-}
-function computeUiHash(snapshot) {
-    const interactiveNodeIds = snapshot.nodes
-        .filter((n) => isInteractiveKind(n.kind) && n.state?.visible)
-        .map((n) => computeEid(n))
-        .join(',');
-    return hash(interactiveNodeIds).substring(0, 6);
-}
-function computeLayerHash(stack) {
-    return hash(stack.join(',')).substring(0, 6);
-}
-function hash(input) {
-    return createHash('sha256').update(input).digest('hex').substring(0, 12);
-}
 //# sourceMappingURL=state-manager.js.map