agent-web-interface 4.0.0

package/dist/src/factpack/dialog-detector.js

@@ -0,0 +1,354 @@
+/**
+ * Dialog Detector
+ *
+ * Detects dialogs/modals in a BaseSnapshot.
+ *
+ * Design: Generic First, Specific Second
+ * 1. Detect ALL visible dialogs (always works)
+ * 2. Optionally classify type (may return 'unknown')
+ */
+import { QueryEngine } from '../query/query-engine.js';
+import { normalizeText } from '../lib/text-utils.js';
+// ============================================================================
+// Classification Patterns
+// ============================================================================
+/** Patterns for cookie consent dialogs */
+const COOKIE_PATTERNS = [
+    /\bcookie/i,
+    /\bconsent/i,
+    /\baccept all/i,
+    /\bprivacy policy/i,
+    /\bprivacy settings/i,
+    /\bmanage cookies/i,
+    /\bgdpr/i,
+    /\bccpa/i,
+];
+/** Patterns for newsletter dialogs */
+const NEWSLETTER_PATTERNS = [
+    /\bsubscribe/i,
+    /\bnewsletter/i,
+    /\bemail updates/i,
+    /\bsign up for/i,
+    /\bstay (in )?touch/i,
+    /\bjoin our/i,
+];
+/** Patterns for age gate dialogs */
+const AGE_GATE_PATTERNS = [
+    /\bage verification/i,
+    /\b21\+/i,
+    /\b18\+/i,
+    /\bverify (your )?age/i,
+    /\bare you (over|at least)/i,
+    /\bdate of birth/i,
+];
+/** Patterns for login prompt dialogs */
+const LOGIN_PATTERNS = [
+    /\bsign in/i,
+    /\blog in/i,
+    /\bpassword/i,
+    /\bauthenticate/i,
+    /\benter your credentials/i,
+];
+/** Patterns for primary action buttons */
+const PRIMARY_ACTION_PATTERNS = [
+    /\baccept/i,
+    /\bagree/i,
+    /\bconfirm/i,
+    /\bsubmit/i,
+    /\bcontinue/i,
+    /\bok\b/i,
+    /\byes/i,
+    /\bsave/i,
+    /\bdone/i,
+];
+/** Patterns for secondary action buttons */
+const SECONDARY_ACTION_PATTERNS = [
+    /\bdecline/i,
+    /\breject/i,
+    /\bno thanks/i,
+    /\bno\b/i,
+    /\bcancel/i,
+    /\bskip/i,
+    /\blater/i,
+    /\bnot now/i,
+];
+/** Patterns for dismiss buttons */
+const DISMISS_PATTERNS = [/\bclose/i, /\bdismiss/i, /\b[x×]\b/i, /^x$/i];
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Check if text matches any pattern in the list.
+ */
+function matchesPatterns(text, patterns) {
+    const normalized = normalizeText(text);
+    return patterns.some((pattern) => pattern.test(normalized));
+}
+/**
+ * Count pattern matches in text.
+ */
+function countPatternMatches(text, patterns) {
+    const normalized = normalizeText(text);
+    return patterns.filter((pattern) => pattern.test(normalized)).length;
+}
+/**
+ * Determine detection method from node attributes.
+ */
+function getDetectionMethod(node) {
+    const role = node.attributes?.role?.toLowerCase();
+    if (role === 'alertdialog') {
+        return 'role-alertdialog';
+    }
+    if (role === 'dialog') {
+        return 'role-dialog';
+    }
+    // Check if it's an HTML dialog element (kind will be 'dialog')
+    if (node.kind === 'dialog') {
+        // Could be role or HTML - default to role-dialog if role attr present
+        if (role) {
+            return 'role-dialog';
+        }
+        return 'html-dialog';
+    }
+    return 'heuristic';
+}
+/**
+ * Determine action role from label.
+ */
+function classifyActionRole(label) {
+    if (matchesPatterns(label, DISMISS_PATTERNS)) {
+        return 'dismiss';
+    }
+    if (matchesPatterns(label, PRIMARY_ACTION_PATTERNS)) {
+        return 'primary';
+    }
+    if (matchesPatterns(label, SECONDARY_ACTION_PATTERNS)) {
+        return 'secondary';
+    }
+    return 'unknown';
+}
+/**
+ * Extract dialog title from nearby heading context or first heading-like element.
+ */
+function extractDialogTitle(dialogNode, engine) {
+    // First try heading context
+    if (dialogNode.where.heading_context) {
+        return dialogNode.where.heading_context;
+    }
+    // Look for headings in the dialog's group
+    if (dialogNode.where.group_id) {
+        const headings = engine.find({
+            kind: 'heading',
+            group_id: dialogNode.where.group_id,
+            limit: 1,
+        });
+        if (headings.matches.length > 0) {
+            return headings.matches[0].node.label;
+        }
+    }
+    return undefined;
+}
+/**
+ * Find interactive actions within a dialog.
+ */
+function extractDialogActions(dialogNode, engine) {
+    const actions = [];
+    // Find buttons and links in the same group or region as the dialog
+    const interactiveKinds = ['button', 'link'];
+    for (const kind of interactiveKinds) {
+        // Try by group_id first
+        if (dialogNode.where.group_id) {
+            const matches = engine.find({
+                kind,
+                group_id: dialogNode.where.group_id,
+                state: { visible: true },
+                limit: 10,
+            });
+            for (const match of matches.matches) {
+                const node = match.node;
+                if (node.node_id === dialogNode.node_id)
+                    continue; // Skip the dialog itself
+                actions.push({
+                    node_id: node.node_id,
+                    backend_node_id: node.backend_node_id,
+                    label: node.label,
+                    role: classifyActionRole(node.label),
+                    kind: node.kind,
+                });
+            }
+        }
+        // If no group_id or few results, try by region
+        if (actions.length < 2 && dialogNode.where.region === 'dialog') {
+            const regionMatches = engine.find({
+                kind,
+                region: 'dialog',
+                state: { visible: true },
+                limit: 10,
+            });
+            for (const match of regionMatches.matches) {
+                const node = match.node;
+                // Avoid duplicates
+                if (actions.some((a) => a.node_id === node.node_id))
+                    continue;
+                if (node.node_id === dialogNode.node_id)
+                    continue;
+                actions.push({
+                    node_id: node.node_id,
+                    backend_node_id: node.backend_node_id,
+                    label: node.label,
+                    role: classifyActionRole(node.label),
+                    kind: node.kind,
+                });
+            }
+        }
+    }
+    // Sort: primary first, then secondary, then dismiss, then unknown
+    const roleOrder = {
+        primary: 0,
+        secondary: 1,
+        dismiss: 2,
+        unknown: 3,
+    };
+    actions.sort((a, b) => roleOrder[a.role] - roleOrder[b.role]);
+    return actions;
+}
+/**
+ * Collect all text content from dialog for pattern matching.
+ */
+function collectDialogText(dialogNode, actions) {
+    const parts = [];
+    if (dialogNode.label) {
+        parts.push(dialogNode.label);
+    }
+    if (dialogNode.where.heading_context) {
+        parts.push(dialogNode.where.heading_context);
+    }
+    for (const action of actions) {
+        if (action.label) {
+            parts.push(action.label);
+        }
+    }
+    return parts.join(' ');
+}
+/**
+ * Classify dialog type based on content patterns.
+ * Returns 'unknown' with low confidence if no patterns match.
+ */
+function classifyDialogType(dialogNode, dialogText, detectionMethod) {
+    const signals = [];
+    let type = 'unknown';
+    let confidence = 0.3; // Default low confidence for unknown
+    // Check for alertdialog role first
+    if (detectionMethod === 'role-alertdialog') {
+        type = 'alert';
+        confidence = 0.9;
+        signals.push('role-alertdialog');
+        return { type, confidence, signals };
+    }
+    // Count pattern matches for each type
+    const cookieMatches = countPatternMatches(dialogText, COOKIE_PATTERNS);
+    const newsletterMatches = countPatternMatches(dialogText, NEWSLETTER_PATTERNS);
+    const ageGateMatches = countPatternMatches(dialogText, AGE_GATE_PATTERNS);
+    const loginMatches = countPatternMatches(dialogText, LOGIN_PATTERNS);
+    // Find best match (require at least 2 pattern matches for classification)
+    const matches = [
+        { type: 'cookie-consent', count: cookieMatches, patterns: 'cookie-patterns' },
+        { type: 'newsletter', count: newsletterMatches, patterns: 'newsletter-patterns' },
+        { type: 'age-gate', count: ageGateMatches, patterns: 'age-gate-patterns' },
+        { type: 'login-prompt', count: loginMatches, patterns: 'login-patterns' },
+    ];
+    matches.sort((a, b) => b.count - a.count);
+    if (matches[0].count >= 2) {
+        type = matches[0].type;
+        // Confidence based on match count
+        confidence = Math.min(0.95, 0.6 + matches[0].count * 0.1);
+        signals.push(`${matches[0].patterns}:${matches[0].count}`);
+    }
+    else if (matches[0].count === 1) {
+        // Single match - still set type but with low confidence
+        type = matches[0].type;
+        confidence = 0.5;
+        signals.push(`${matches[0].patterns}:1:weak`);
+    }
+    else {
+        // No patterns matched - could be generic modal or confirm
+        type = 'modal';
+        confidence = 0.4;
+        signals.push('no-pattern-match');
+    }
+    return { type, confidence, signals };
+}
+// ============================================================================
+// Main Detection Function
+// ============================================================================
+/**
+ * Detect dialogs in a BaseSnapshot.
+ *
+ * @param snapshot - The snapshot to analyze
+ * @returns Detection result with all dialogs and metadata
+ */
+export function detectDialogs(snapshot) {
+    const startTime = performance.now();
+    const engine = new QueryEngine(snapshot);
+    // Step 1: Find ALL dialog nodes (generic detection)
+    // Query by kind='dialog' and region='dialog'
+    const dialogByKind = engine.find({
+        kind: 'dialog',
+        state: { visible: true },
+        limit: 50,
+    });
+    const dialogByRegion = engine.find({
+        region: 'dialog',
+        state: { visible: true },
+        limit: 50,
+    });
+    // Combine and deduplicate
+    const seenIds = new Set();
+    const allDialogNodes = [];
+    for (const match of dialogByKind.matches) {
+        if (!seenIds.has(match.node.node_id)) {
+            seenIds.add(match.node.node_id);
+            allDialogNodes.push(match.node);
+        }
+    }
+    for (const match of dialogByRegion.matches) {
+        if (!seenIds.has(match.node.node_id)) {
+            seenIds.add(match.node.node_id);
+            allDialogNodes.push(match.node);
+        }
+    }
+    // Step 2: For each dialog, extract info and classify
+    const dialogs = [];
+    for (const dialogNode of allDialogNodes) {
+        const detectionMethod = getDetectionMethod(dialogNode);
+        const title = extractDialogTitle(dialogNode, engine);
+        const actions = extractDialogActions(dialogNode, engine);
+        const dialogText = collectDialogText(dialogNode, actions);
+        const classification = classifyDialogType(dialogNode, dialogText, detectionMethod);
+        // Determine if modal (alertdialog or has aria-modal)
+        const isModal = detectionMethod === 'role-alertdialog' || dialogNode.attributes?.role === 'alertdialog';
+        dialogs.push({
+            node_id: dialogNode.node_id,
+            backend_node_id: dialogNode.backend_node_id,
+            bbox: dialogNode.layout.bbox,
+            is_modal: isModal,
+            title,
+            actions,
+            detection_method: detectionMethod,
+            type: classification.type,
+            type_confidence: classification.confidence,
+            classification_signals: classification.signals,
+        });
+    }
+    const detectionTimeMs = performance.now() - startTime;
+    return {
+        dialogs,
+        has_blocking_dialog: dialogs.some((d) => d.is_modal),
+        meta: {
+            total_detected: dialogs.length,
+            classified_count: dialogs.filter((d) => d.type !== 'unknown').length,
+            detection_time_ms: detectionTimeMs,
+        },
+    };
+}
+//# sourceMappingURL=dialog-detector.js.map

package/dist/src/factpack/dialog-detector.js.map

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

package/dist/src/factpack/form-detector.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Form Detector
+ *
+ * Detects forms and extracts field information from a BaseSnapshot.
+ *
+ * Design: Generic First, Specific Second
+ * 1. Detect ALL forms with their fields (always works)
+ * 2. Infer field semantics (may return 'unknown')
+ * 3. Infer form purpose (may return 'generic')
+ */
+import type { BaseSnapshot } from '../snapshot/snapshot.types.js';
+import type { FormDetectionResult } from './types.js';
+/**
+ * Options for form detection.
+ */
+export interface FormDetectionOptions {
+    /** Include disabled fields (default: true) */
+    include_disabled_fields?: boolean;
+}
+/**
+ * Detect forms in a BaseSnapshot.
+ *
+ * @param snapshot - The snapshot to analyze
+ * @param options - Detection options
+ * @returns Detection result with all forms and metadata
+ */
+export declare function detectForms(snapshot: BaseSnapshot, options?: FormDetectionOptions): FormDetectionResult;
+//# sourceMappingURL=form-detector.d.ts.map

package/dist/src/factpack/form-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-detector.d.ts","sourceRoot":"","sources":["../../../src/factpack/form-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAA0B,MAAM,+BAA+B,CAAC;AAG1F,OAAO,KAAK,EACV,mBAAmB,EAOpB,MAAM,YAAY,CAAC;AAigBpB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,oBAAyB,GACjC,mBAAmB,CAqErB"}