agent-web-interface 4.0.0

package/dist/src/factpack/types.d.ts

@@ -0,0 +1,307 @@
+/**
+ * FactPack Types
+ *
+ * Shared type definitions for FactPack extractors.
+ *
+ * Design Philosophy: Generic First, Specific Second
+ * - Base detection (always populated) - generic facts that work on any page
+ * - Classification (optional) - specific categorization with confidence scores
+ * - 'unknown'/'generic' are valid results, not failures
+ */
+import type { NodeKind, SemanticRegion, BBox } from '../snapshot/snapshot.types.js';
+/**
+ * Dialog type classification.
+ * May be 'unknown' if dialog is detected but type cannot be determined.
+ */
+export type DialogType = 'modal' | 'alert' | 'confirm' | 'cookie-consent' | 'newsletter' | 'login-prompt' | 'age-gate' | 'unknown';
+/** How the dialog was detected */
+export type DialogDetectionMethod = 'role-dialog' | 'role-alertdialog' | 'html-dialog' | 'aria-modal' | 'heuristic';
+/** Action role within a dialog */
+export type DialogActionRole = 'primary' | 'secondary' | 'dismiss' | 'unknown';
+/**
+ * An interactive action within a dialog.
+ */
+export interface DialogAction {
+    node_id: string;
+    backend_node_id: number;
+    label: string;
+    role: DialogActionRole;
+    kind: NodeKind;
+}
+/**
+ * A detected dialog element.
+ * Base detection fields are always populated.
+ * Classification fields may indicate 'unknown'.
+ */
+export interface DetectedDialog {
+    /** Container node ID */
+    node_id: string;
+    /** Backend node ID for CDP interaction */
+    backend_node_id: number;
+    /** Bounding box */
+    bbox: BBox;
+    /** Is this a modal (blocks interaction with rest of page)? */
+    is_modal: boolean;
+    /** Title/heading if found */
+    title?: string;
+    /** Interactive elements within dialog */
+    actions: DialogAction[];
+    /** How was this detected? */
+    detection_method: DialogDetectionMethod;
+    /** Classified type (may be 'unknown') */
+    type: DialogType;
+    /** Classification confidence (0-1). Low for 'unknown'. */
+    type_confidence: number;
+    /** Signals that contributed to classification */
+    classification_signals: string[];
+}
+/**
+ * Result of dialog detection.
+ */
+export interface DialogDetectionResult {
+    /** All detected dialogs (always includes generically detected ones) */
+    dialogs: DetectedDialog[];
+    /** Is any blocking dialog present? */
+    has_blocking_dialog: boolean;
+    /** Stats */
+    meta: {
+        total_detected: number;
+        /** How many have type !== 'unknown' */
+        classified_count: number;
+        detection_time_ms: number;
+    };
+}
+/**
+ * Form purpose (inferred).
+ * May be 'generic' if form is detected but purpose cannot be determined.
+ */
+export type FormPurpose = 'login' | 'signup' | 'checkout' | 'contact' | 'search' | 'newsletter' | 'shipping' | 'billing' | 'profile' | 'password-reset' | 'generic';
+/**
+ * Field semantic type (inferred).
+ * May be 'unknown' if field purpose cannot be determined.
+ */
+export type FieldSemanticType = 'username' | 'email' | 'password' | 'password-confirm' | 'phone' | 'first-name' | 'last-name' | 'full-name' | 'address-line1' | 'address-line2' | 'city' | 'state' | 'postal-code' | 'country' | 'card-number' | 'card-expiry' | 'card-cvv' | 'search-query' | 'message' | 'date' | 'number' | 'url' | 'unknown';
+/**
+ * A form field with extracted information.
+ */
+export interface FormField {
+    node_id: string;
+    backend_node_id: number;
+    kind: NodeKind;
+    label: string;
+    /** From attributes.input_type or 'text' */
+    input_type: string;
+    required: boolean;
+    invalid: boolean;
+    disabled: boolean;
+    readonly: boolean;
+    /** Whether field has a value (not the value itself for privacy) */
+    has_value: boolean;
+    placeholder?: string;
+    autocomplete?: string;
+    /** Inferred semantic type (may be 'unknown') */
+    semantic_type: FieldSemanticType;
+    /** Confidence in semantic_type (0-1) */
+    semantic_confidence: number;
+}
+/**
+ * Submit button for a form.
+ */
+export interface FormSubmitButton {
+    node_id: string;
+    backend_node_id: number;
+    label: string;
+    enabled: boolean;
+    visible: boolean;
+}
+/**
+ * Form validation state.
+ */
+export interface FormValidation {
+    has_errors: boolean;
+    error_count: number;
+    required_unfilled: number;
+    /** Can form likely be submitted? (enabled submit + no errors) */
+    ready_to_submit: boolean;
+}
+/**
+ * A detected form with extracted fields.
+ * Base detection fields are always populated.
+ * Purpose inference may indicate 'generic'.
+ */
+export interface DetectedForm {
+    node_id: string;
+    backend_node_id: number;
+    /** Heading context or title */
+    title?: string;
+    /** Form method/action (if explicit form element) */
+    action?: string;
+    method?: string;
+    /** Fields in document order */
+    fields: FormField[];
+    /** Submit button (may be undefined for implicit forms) */
+    submit_button?: FormSubmitButton;
+    /** Validation state */
+    validation: FormValidation;
+    /** Inferred purpose (may be 'generic') */
+    purpose: FormPurpose;
+    /** Confidence in purpose (0-1) */
+    purpose_confidence: number;
+    /** Signals that contributed to purpose inference */
+    purpose_signals: string[];
+}
+/**
+ * Result of form detection.
+ */
+export interface FormDetectionResult {
+    /** All detected forms */
+    forms: DetectedForm[];
+    /** Primary form (largest/most prominent) */
+    primary_form?: DetectedForm;
+    /** Stats */
+    meta: {
+        total_detected: number;
+        /** How many have purpose !== 'generic' */
+        classified_count: number;
+        detection_time_ms: number;
+    };
+}
+/**
+ * Page type classification.
+ * May be 'unknown' if page type cannot be determined.
+ */
+export type PageType = 'homepage' | 'product' | 'product-listing' | 'category' | 'search-results' | 'article' | 'login' | 'signup' | 'checkout' | 'cart' | 'account' | 'contact' | 'about' | 'documentation' | 'error' | 'unknown';
+/** Source of a classification signal */
+export type PageSignalSource = 'url' | 'title' | 'content' | 'form' | 'element';
+/**
+ * A signal that contributed to page classification.
+ */
+export interface PageSignal {
+    source: PageSignalSource;
+    /** Signal identifier (e.g., 'url-pattern-product', 'form-purpose-login') */
+    signal: string;
+    /** Human-readable evidence */
+    evidence: string;
+    /** Weight contribution (0-1) */
+    weight: number;
+}
+/** Type of extracted page entity */
+export type PageEntityType = 'product-name' | 'price' | 'article-title' | 'error-code' | 'search-query' | 'category-name' | 'unknown';
+/**
+ * An extracted entity from the page.
+ */
+export interface PageEntity {
+    type: PageEntityType;
+    value: string;
+    node_id?: string;
+    confidence: number;
+}
+/**
+ * Page classification result.
+ * Summary fields (has_forms, has_navigation, etc.) are always useful
+ * even when type is 'unknown'.
+ */
+export interface PageClassification {
+    /** Primary page type (may be 'unknown') */
+    type: PageType;
+    /** Confidence (0-1). Low confidence for 'unknown'. */
+    confidence: number;
+    /** Alternative type if ambiguous */
+    secondary_type?: PageType;
+    secondary_confidence?: number;
+    /** Signals that contributed to classification */
+    signals: PageSignal[];
+    /** Extracted entities (may be empty) */
+    entities: PageEntity[];
+    /** Does page have forms? */
+    has_forms: boolean;
+    /** Does page have navigation? */
+    has_navigation: boolean;
+    /** Primary content region detected? */
+    has_main_content: boolean;
+    /** Is there a search box? */
+    has_search: boolean;
+}
+/**
+ * Result of page classification.
+ */
+export interface PageClassificationResult {
+    classification: PageClassification;
+    meta: {
+        signals_evaluated: number;
+        classification_time_ms: number;
+    };
+}
+/**
+ * Action category.
+ * May be 'generic' if action cannot be categorized.
+ */
+export type ActionCategory = 'primary-cta' | 'secondary-cta' | 'navigation' | 'form-submit' | 'search' | 'cart-action' | 'auth-action' | 'dialog-action' | 'media-control' | 'generic';
+/**
+ * A signal that contributed to action scoring.
+ */
+export interface ActionSignal {
+    type: string;
+    weight: number;
+}
+/**
+ * A selected key action.
+ */
+export interface SelectedAction {
+    node_id: string;
+    backend_node_id: number;
+    label: string;
+    kind: NodeKind;
+    region: SemanticRegion;
+    /** Locator for interaction */
+    locator: string;
+    /** Is action enabled? */
+    enabled: boolean;
+    /** Relevance score (0-1) */
+    score: number;
+    /** Scoring signals */
+    signals: ActionSignal[];
+    /** Action category (may be 'generic') */
+    category: ActionCategory;
+    /** Confidence in category (0-1) */
+    category_confidence: number;
+}
+/**
+ * Result of action selection.
+ */
+export interface ActionSelectionResult {
+    /** Top actions sorted by score */
+    actions: SelectedAction[];
+    /** Highest-scoring primary CTA (if identifiable) */
+    primary_cta?: SelectedAction;
+    /** Stats */
+    meta: {
+        candidates_evaluated: number;
+        selection_time_ms: number;
+    };
+}
+/**
+ * Complete FactPack extraction result.
+ */
+export interface FactPack {
+    page_type: PageClassificationResult;
+    dialogs: DialogDetectionResult;
+    forms: FormDetectionResult;
+    actions: ActionSelectionResult;
+    meta: {
+        snapshot_id: string;
+        extraction_time_ms: number;
+    };
+}
+/**
+ * Options for FactPack extraction.
+ */
+export interface FactPackOptions {
+    /** Max actions to select (default: 12) */
+    max_actions?: number;
+    /** Min action score threshold (default: 0.2) */
+    min_action_score?: number;
+    /** Include disabled form fields (default: true) */
+    include_disabled_fields?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/factpack/types.d.ts.map

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

package/dist/src/factpack/types.js

@@ -0,0 +1,12 @@
+/**
+ * FactPack Types
+ *
+ * Shared type definitions for FactPack extractors.
+ *
+ * Design Philosophy: Generic First, Specific Second
+ * - Base detection (always populated) - generic facts that work on any page
+ * - Classification (optional) - specific categorization with confidence scores
+ * - 'unknown'/'generic' are valid results, not failures
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/factpack/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/factpack/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/src/form/dependency-tracker.d.ts

@@ -0,0 +1,108 @@
+/**
+ * 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
+ */
+import type { FieldDependency, ObservedEffect } from './types.js';
+/**
+ * Dependency tracker configuration
+ */
+export interface DependencyTrackerConfig {
+    /** Minimum confidence to report a dependency (default: 0.3) */
+    minConfidence: number;
+    /** Maximum number of observations to keep per trigger (default: 10) */
+    maxObservationsPerTrigger: number;
+    /** Time window to consider effects as caused by action (ms, default: 2000) */
+    effectTimeWindow: number;
+}
+/**
+ * Dependency Tracker class.
+ *
+ * Maintains a per-page record of observed dependencies between fields.
+ * Dependencies are inferred from action->effect correlations.
+ */
+export declare class DependencyTracker {
+    private readonly config;
+    /** Observed effects per page: pageId -> triggerEid -> effects */
+    private readonly effectsByPage;
+    /** Tracked dependencies per page: pageId -> Map<"source:target", TrackedDependency> */
+    private readonly dependenciesByPage;
+    constructor(config?: Partial<DependencyTrackerConfig>);
+    /**
+     * Record an observed effect after an action.
+     *
+     * @param pageId - Page identifier
+     * @param effect - The observed effect
+     */
+    recordEffect(pageId: string, effect: ObservedEffect): void;
+    /**
+     * Update tracked dependencies based on an observed effect.
+     */
+    private updateDependencies;
+    /**
+     * Track or update a dependency.
+     */
+    private trackDependency;
+    /**
+     * 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: string, targetEid: string): FieldDependency[];
+    /**
+     * Get all observed dependencies for a page.
+     *
+     * @param pageId - Page identifier
+     * @returns Map of target EID -> dependencies
+     */
+    getAllDependencies(pageId: string): Map<string, FieldDependency[]>;
+    /**
+     * 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: string, sourceEid: string): string[];
+    /**
+     * Compute confidence score for a tracked dependency.
+     */
+    private computeConfidence;
+    /**
+     * Clear all tracked data for a page.
+     *
+     * @param pageId - Page identifier
+     */
+    clearPage(pageId: string): void;
+    /**
+     * Clear all tracked data.
+     */
+    clearAll(): void;
+}
+/**
+ * Get the global dependency tracker instance.
+ */
+export declare function getDependencyTracker(): DependencyTracker;
+/**
+ * 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 declare function createObservedEffect(triggerEid: string, actionType: ObservedEffect['action_type'], beforeEids: Map<string, boolean>, afterEids: Map<string, boolean>, beforeVisible: Set<string>, afterVisible: Set<string>, valueChanges?: string[]): ObservedEffect;
+//# sourceMappingURL=dependency-tracker.d.ts.map

package/dist/src/form/dependency-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-tracker.d.ts","sourceRoot":"","sources":["../../../src/form/dependency-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,eAAe,EAGf,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC;IAEtB,uEAAuE;IACvE,yBAAyB,EAAE,MAAM,CAAC;IAElC,8EAA8E;IAC9E,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAoBD;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IAEjD,iEAAiE;IACjE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6C;IAE3E,uFAAuF;IACvF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA8C;gBAErE,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC;IAMrD;;;;;OAKG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI;IAyB1D;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmD1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAyBvB;;;;;;OAMG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,EAAE;IAuBxE;;;;;OAKG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;IAsBlE;;;;;;OAMG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE;IAoB5D;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B;;OAEG;IACH,QAAQ,IAAI,IAAI;CAIjB;AAQD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,CAGxD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,cAAc,CAAC,aAAa,CAAC,EACzC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,EAC1B,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,EACzB,YAAY,GAAE,MAAM,EAAO,GAC1B,cAAc,CAsDhB"}