agent-web-interface 4.0.0

package/dist/src/form/dependency-tracker.js

@@ -0,0 +1,298 @@
+/**
+ * Dependency Tracker
+ *
+ * Tracks observed dependencies between form fields by correlating
+ * actions with their effects. Dependencies are learned through
+ * interaction, not predicted.
+ *
+ * Key concept: After each action, record "what changed" and
+ * attribute the change to the action with a confidence score.
+ *
+ * @module form/dependency-tracker
+ */
+const DEFAULT_CONFIG = {
+    minConfidence: 0.3,
+    maxObservationsPerTrigger: 10,
+    effectTimeWindow: 2000,
+};
+/**
+ * Dependency Tracker class.
+ *
+ * Maintains a per-page record of observed dependencies between fields.
+ * Dependencies are inferred from action->effect correlations.
+ */
+export class DependencyTracker {
+    config;
+    /** Observed effects per page: pageId -> triggerEid -> effects */
+    effectsByPage;
+    /** Tracked dependencies per page: pageId -> Map<"source:target", TrackedDependency> */
+    dependenciesByPage;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.effectsByPage = new Map();
+        this.dependenciesByPage = new Map();
+    }
+    /**
+     * Record an observed effect after an action.
+     *
+     * @param pageId - Page identifier
+     * @param effect - The observed effect
+     */
+    recordEffect(pageId, effect) {
+        // Get or create page entry
+        if (!this.effectsByPage.has(pageId)) {
+            this.effectsByPage.set(pageId, new Map());
+        }
+        const pageEffects = this.effectsByPage.get(pageId);
+        // Get or create trigger entry
+        if (!pageEffects.has(effect.trigger_eid)) {
+            pageEffects.set(effect.trigger_eid, []);
+        }
+        const triggerEffects = pageEffects.get(effect.trigger_eid);
+        // Add effect
+        triggerEffects.push(effect);
+        // Trim old effects
+        if (triggerEffects.length > this.config.maxObservationsPerTrigger) {
+            triggerEffects.shift();
+        }
+        // Update dependencies based on this effect
+        this.updateDependencies(pageId, effect);
+    }
+    /**
+     * Update tracked dependencies based on an observed effect.
+     */
+    updateDependencies(pageId, effect) {
+        if (!this.dependenciesByPage.has(pageId)) {
+            this.dependenciesByPage.set(pageId, new Map());
+        }
+        const pageDeps = this.dependenciesByPage.get(pageId);
+        // Process enabled elements -> 'enables' dependency
+        for (const targetEid of effect.enabled) {
+            this.trackDependency(pageDeps, effect.trigger_eid, targetEid, 'enables', 'observed_state_change');
+        }
+        // Process disabled elements -> 'enables' dependency (inverse)
+        for (const targetEid of effect.disabled) {
+            // Track as 'enables' with reverse logic
+            this.trackDependency(pageDeps, effect.trigger_eid, targetEid, 'enables', 'observed_state_change');
+        }
+        // Process appeared elements -> 'reveals' dependency
+        for (const targetEid of effect.appeared) {
+            this.trackDependency(pageDeps, effect.trigger_eid, targetEid, 'reveals', 'observed_mutation');
+        }
+        // Process disappeared elements -> 'reveals' dependency (inverse)
+        for (const targetEid of effect.disappeared) {
+            this.trackDependency(pageDeps, effect.trigger_eid, targetEid, 'reveals', 'observed_mutation');
+        }
+        // Process value changed elements -> 'populates' dependency
+        for (const targetEid of effect.value_changed) {
+            this.trackDependency(pageDeps, effect.trigger_eid, targetEid, 'populates', 'observed_state_change');
+        }
+    }
+    /**
+     * Track or update a dependency.
+     */
+    trackDependency(pageDeps, sourceEid, targetEid, type, detectionMethod) {
+        const key = `${sourceEid}:${targetEid}:${type}`;
+        if (pageDeps.has(key)) {
+            const existing = pageDeps.get(key);
+            existing.observations++;
+            existing.lastSeen = new Date().toISOString();
+        }
+        else {
+            pageDeps.set(key, {
+                source_eid: sourceEid,
+                target_eid: targetEid,
+                type,
+                observations: 1,
+                lastSeen: new Date().toISOString(),
+                detectionMethod,
+            });
+        }
+    }
+    /**
+     * Get dependencies for a specific field.
+     *
+     * @param pageId - Page identifier
+     * @param targetEid - EID of the field to get dependencies for
+     * @returns Array of dependencies that affect this field
+     */
+    getDependenciesFor(pageId, targetEid) {
+        const pageDeps = this.dependenciesByPage.get(pageId);
+        if (!pageDeps)
+            return [];
+        const dependencies = [];
+        for (const tracked of pageDeps.values()) {
+            if (tracked.target_eid !== targetEid)
+                continue;
+            const confidence = this.computeConfidence(tracked);
+            if (confidence < this.config.minConfidence)
+                continue;
+            dependencies.push({
+                source_eid: tracked.source_eid,
+                type: tracked.type,
+                confidence,
+                detection_method: tracked.detectionMethod,
+            });
+        }
+        return dependencies;
+    }
+    /**
+     * Get all observed dependencies for a page.
+     *
+     * @param pageId - Page identifier
+     * @returns Map of target EID -> dependencies
+     */
+    getAllDependencies(pageId) {
+        const result = new Map();
+        const pageDeps = this.dependenciesByPage.get(pageId);
+        if (!pageDeps)
+            return result;
+        for (const tracked of pageDeps.values()) {
+            const confidence = this.computeConfidence(tracked);
+            if (confidence < this.config.minConfidence)
+                continue;
+            const deps = result.get(tracked.target_eid) ?? [];
+            deps.push({
+                source_eid: tracked.source_eid,
+                type: tracked.type,
+                confidence,
+                detection_method: tracked.detectionMethod,
+            });
+            result.set(tracked.target_eid, deps);
+        }
+        return result;
+    }
+    /**
+     * Get fields that depend on a given source field.
+     *
+     * @param pageId - Page identifier
+     * @param sourceEid - EID of the source field
+     * @returns Array of field EIDs that depend on the source
+     */
+    getDependentsOf(pageId, sourceEid) {
+        const pageDeps = this.dependenciesByPage.get(pageId);
+        if (!pageDeps)
+            return [];
+        const dependents = [];
+        for (const tracked of pageDeps.values()) {
+            if (tracked.source_eid !== sourceEid)
+                continue;
+            const confidence = this.computeConfidence(tracked);
+            if (confidence < this.config.minConfidence)
+                continue;
+            if (!dependents.includes(tracked.target_eid)) {
+                dependents.push(tracked.target_eid);
+            }
+        }
+        return dependents;
+    }
+    /**
+     * Compute confidence score for a tracked dependency.
+     */
+    computeConfidence(tracked) {
+        // Base confidence from observations
+        // More observations = higher confidence (up to a point)
+        const observationFactor = Math.min(1.0, tracked.observations / 3);
+        // Method-based confidence boost
+        const methodBoost = {
+            aria_controls: 0.3,
+            data_attribute: 0.25,
+            observed_mutation: 0.1,
+            observed_state_change: 0.15,
+            structural_inference: 0.05,
+            naming_convention: 0.05,
+        };
+        const boost = methodBoost[tracked.detectionMethod] ?? 0;
+        return Math.min(1.0, 0.3 + observationFactor * 0.5 + boost);
+    }
+    /**
+     * Clear all tracked data for a page.
+     *
+     * @param pageId - Page identifier
+     */
+    clearPage(pageId) {
+        this.effectsByPage.delete(pageId);
+        this.dependenciesByPage.delete(pageId);
+    }
+    /**
+     * Clear all tracked data.
+     */
+    clearAll() {
+        this.effectsByPage.clear();
+        this.dependenciesByPage.clear();
+    }
+}
+/**
+ * Global dependency tracker instance.
+ * Used across the application for consistent tracking.
+ */
+let globalTracker = null;
+/**
+ * Get the global dependency tracker instance.
+ */
+export function getDependencyTracker() {
+    globalTracker ??= new DependencyTracker();
+    return globalTracker;
+}
+/**
+ * Create an ObservedEffect from before/after state comparison.
+ *
+ * @param triggerEid - EID of the element that was acted upon
+ * @param actionType - Type of action performed
+ * @param beforeEids - Map of EID -> enabled state before action
+ * @param afterEids - Map of EID -> enabled state after action
+ * @param beforeVisible - Set of EIDs that were visible before
+ * @param afterVisible - Set of EIDs that are visible after
+ * @param valueChanges - EIDs of fields whose values changed
+ * @returns ObservedEffect object
+ */
+export function createObservedEffect(triggerEid, actionType, beforeEids, afterEids, beforeVisible, afterVisible, valueChanges = []) {
+    const enabled = [];
+    const disabled = [];
+    const appeared = [];
+    const disappeared = [];
+    // Find enabled/disabled changes
+    for (const [eid, wasEnabled] of beforeEids) {
+        const isEnabled = afterEids.get(eid);
+        if (isEnabled !== undefined) {
+            if (!wasEnabled && isEnabled) {
+                enabled.push(eid);
+            }
+            else if (wasEnabled && !isEnabled) {
+                disabled.push(eid);
+            }
+        }
+    }
+    // Check for newly enabled elements
+    for (const [eid, isEnabled] of afterEids) {
+        if (!beforeEids.has(eid) && isEnabled) {
+            enabled.push(eid);
+        }
+    }
+    // Find appeared/disappeared elements
+    for (const eid of afterVisible) {
+        if (!beforeVisible.has(eid)) {
+            appeared.push(eid);
+        }
+    }
+    for (const eid of beforeVisible) {
+        if (!afterVisible.has(eid)) {
+            disappeared.push(eid);
+        }
+    }
+    // Compute confidence based on number of changes
+    const totalChanges = enabled.length + disabled.length + appeared.length + disappeared.length + valueChanges.length;
+    const confidence = totalChanges > 0 ? Math.min(1.0, 0.5 + totalChanges * 0.1) : 0.3;
+    return {
+        trigger_eid: triggerEid,
+        action_type: actionType,
+        timestamp: new Date().toISOString(),
+        enabled,
+        disabled,
+        appeared,
+        disappeared,
+        value_changed: valueChanges,
+        confidence,
+    };
+}
+//# sourceMappingURL=dependency-tracker.js.map

package/dist/src/form/dependency-tracker.js.map

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

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

@@ -0,0 +1,32 @@
+/**
+ * Field Extractor
+ *
+ * Extracts rich metadata for form fields from a BaseSnapshot.
+ * Handles purpose inference, constraint extraction, and state tracking.
+ *
+ * Purpose inference priority:
+ * 1. input type attribute
+ * 2. autocomplete attribute
+ * 3. aria-label
+ * 4. label text
+ * 5. placeholder
+ * 6. name attribute
+ *
+ * @module form/field-extractor
+ */
+import type { BaseSnapshot } from '../snapshot/snapshot.types.js';
+import type { FormField, FormDetectionConfig } from './types.js';
+/**
+ * Extract form fields from a snapshot for given field EIDs.
+ *
+ * @param snapshot - BaseSnapshot containing the nodes
+ * @param fieldEids - Array of node IDs to extract as fields
+ * @param config - Form detection configuration
+ * @returns Array of FormField objects
+ */
+export declare function extractFields(snapshot: BaseSnapshot, fieldEids: string[], config: FormDetectionConfig): FormField[];
+/**
+ * Extract a single field by EID.
+ */
+export declare function extractFieldByEid(snapshot: BaseSnapshot, eid: string, config: FormDetectionConfig): FormField | null;
+//# sourceMappingURL=field-extractor.d.ts.map

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

@@ -0,0 +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"}