agent-web-interface 4.0.0

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

@@ -0,0 +1,353 @@
+/**
+ * State System Types
+ *
+ * Type definitions for the StateHandle + Diff + Actionables system.
+ * Universal and domain-agnostic - works on any website.
+ */
+import type { BaseSnapshot, ReadableNode } from '../snapshot/snapshot.types.js';
+import type { ObservationGroups } from '../observation/observation.types.js';
+/**
+ * Complete state response returned after every action.
+ * Now returned as a dense XML string.
+ */
+export type StateResponse = string;
+/**
+ * Internal state response object before rendering.
+ */
+export interface StateResponseObject {
+    /** Current state metadata */
+    state: StateHandle;
+    /** Diff or baseline mode */
+    diff: DiffResponse | BaselineResponse;
+    /** Capped list of actionable elements */
+    actionables: ActionableInfo[];
+    /** Count metadata */
+    counts: {
+        shown: number;
+        total_in_layer: number;
+    };
+    /** Limits applied to response */
+    limits: {
+        max_actionables: number;
+        actionables_capped: boolean;
+    };
+    /** Universal UI state atoms */
+    atoms: Atoms;
+    /** Estimated token count for this response */
+    tokens: number;
+    /**
+     * DOM observations - significant elements that appeared or disappeared.
+     * Optional, only present if observations were captured.
+     */
+    observations?: ObservationGroups;
+}
+/**
+ * Options for rendering and response generation.
+ */
+export interface RenderOptions {
+    /** When true, trim large regions to head+tail elements with a comment marker. */
+    trimRegions?: boolean;
+}
+/**
+ * State handle - always returned with every response.
+ */
+export interface StateHandle {
+    /** Session ID (unique per page) */
+    sid: string;
+    /** Monotonic step counter */
+    step: number;
+    /** Document metadata */
+    doc: {
+        url: string;
+        origin: string;
+        title: string;
+        doc_id: string;
+        nav_type: 'soft' | 'hard';
+        history_idx: number;
+    };
+    /** Layer stack and active layer */
+    layer: {
+        active: 'main' | 'modal' | 'drawer' | 'popover';
+        stack: string[];
+        focus_eid?: string;
+        pointer_lock: boolean;
+    };
+    /** Timing metadata */
+    timing: {
+        ts: string;
+        dom_ready: boolean;
+        network_busy: boolean;
+    };
+    /** State hashes for change detection */
+    hash: {
+        ui: string;
+        layer: string;
+    };
+}
+/**
+ * Baseline response (full state, no diff).
+ *
+ * Baselines are only sent when the LLM truly needs full context:
+ * - first: No previous snapshot (LLM has no prior context)
+ * - navigation: URL changed (old elements no longer exist)
+ * - error: State corrupted, need to resync
+ *
+ * For same-page mutations, diffs are always used regardless of
+ * how many elements changed - the LLM already has context.
+ */
+export interface BaselineResponse {
+    mode: 'baseline';
+    /** Reason for sending baseline instead of diff */
+    reason: 'first' | 'navigation' | 'error';
+    /** Error message if reason is 'error' */
+    error?: string;
+}
+/**
+ * Text content change in a readable element.
+ */
+export interface TextChange {
+    /** Element ID (rd-* prefix for readable nodes) */
+    eid: string;
+    /** Previous text content */
+    from: string;
+    /** Current text content */
+    to: string;
+}
+/**
+ * Status/alert element that appeared.
+ */
+export interface StatusNode {
+    /** Element ID (rd-* prefix for readable nodes) */
+    eid: string;
+    /** ARIA role (status, alert, log, progressbar) */
+    role: string;
+    /** Text content */
+    text: string;
+}
+/**
+ * Diff response (incremental changes).
+ */
+export interface DiffResponse {
+    mode: 'diff';
+    diff: {
+        doc?: {
+            from: {
+                url: string;
+                title: string;
+            };
+            to: {
+                url: string;
+                title: string;
+            };
+            nav_type: 'soft' | 'hard';
+        };
+        layer?: {
+            stack_from: string[];
+            stack_to: string[];
+        };
+        actionables: {
+            added: string[];
+            removed: string[];
+            changed: DiffChange[];
+        };
+        /** Readable content mutations (status changes, text updates) */
+        mutations: {
+            /** Text content that changed in status/alert/log/progressbar elements */
+            textChanged: TextChange[];
+            /** Status/alert/log/progressbar elements that appeared */
+            statusAppeared: StatusNode[];
+        };
+        /** True if no actionables or mutations changed */
+        isEmpty: boolean;
+        atoms: AtomChange[];
+    };
+}
+/**
+ * A single property change in an actionable.
+ */
+export interface DiffChange {
+    eid: string;
+    k: string;
+    from: unknown;
+    to: unknown;
+}
+/**
+ * A single property change in atoms.
+ */
+export interface AtomChange {
+    k: string;
+    from: unknown;
+    to: unknown;
+}
+/**
+ * Element target reference for direct interaction.
+ * Enables action tools to target elements directly without re-querying.
+ */
+export interface ElementTargetRef {
+    /** Snapshot that produced this ref */
+    snapshot_id: string;
+    /** CDP backend node ID - primary targeting method */
+    backend_node_id: number;
+    /** CDP frame ID - for cross-frame targeting */
+    frame_id?: string;
+    /** CDP loader ID - changes on navigation */
+    loader_id?: string;
+}
+/**
+ * Actionable element information (returned to LLM).
+ */
+export interface ActionableInfo {
+    /** Stable semantic element ID */
+    eid: string;
+    /** Element kind */
+    kind: string;
+    /** Accessible name / label */
+    name: string;
+    /** ARIA role */
+    role: string;
+    /** Visible */
+    vis: boolean;
+    /** Enabled */
+    ena: boolean;
+    /** Element target reference for direct interaction */
+    ref: ElementTargetRef;
+    /** Locators for this element */
+    loc: LocatorInfo;
+    /** Context metadata */
+    ctx: {
+        layer: string;
+        region: string;
+        group?: string;
+    };
+    /** Optional state flags (only if true) */
+    chk?: boolean;
+    sel?: boolean;
+    exp?: boolean;
+    foc?: boolean;
+    req?: boolean;
+    inv?: boolean;
+    rdo?: boolean;
+    /** Optional attributes */
+    val_hint?: string;
+    placeholder?: string;
+    href?: string;
+    type?: string;
+}
+/**
+ * Locator information for an element.
+ */
+export interface LocatorInfo {
+    /** Preferred locator (accessibility tree) */
+    preferred: {
+        ax: string;
+    };
+    /** Fallback locator (CSS) */
+    fallback?: {
+        css: string;
+    };
+}
+/**
+ * Result of layer detection.
+ */
+export interface LayerDetectionResult {
+    /** Layer stack (bottom to top) */
+    stack: LayerInfo[];
+    /** Active layer (topmost) */
+    active: 'main' | 'modal' | 'drawer' | 'popover';
+    /** Currently focused element ID */
+    focusEid?: string;
+    /** Pointer lock active */
+    pointerLock: boolean;
+}
+/**
+ * Information about a detected layer.
+ */
+export interface LayerInfo {
+    type: 'main' | 'modal' | 'drawer' | 'popover';
+    rootEid?: string;
+    zIndex?: number;
+    isModal: boolean;
+}
+/**
+ * Internal layer candidate during detection.
+ */
+export interface LayerCandidate extends LayerInfo {
+    confidence: number;
+}
+/**
+ * Universal UI state atoms.
+ */
+export interface Atoms {
+    /** Viewport dimensions */
+    viewport: {
+        w: number;
+        h: number;
+        dpr: number;
+    };
+    /** Scroll position */
+    scroll: {
+        x: number;
+        y: number;
+    };
+    /** Loading indicators (optional) */
+    loading?: {
+        network_busy: boolean;
+        spinners: number;
+        progress?: number;
+    };
+    /** Form state (optional) */
+    forms?: {
+        dirty: boolean;
+        focused_field?: string;
+        validation_errors: number;
+    };
+    /** Notifications (optional) */
+    notifications?: {
+        toasts: number;
+        banners: number;
+    };
+}
+/**
+ * State manager context (internal state).
+ */
+export interface StateManagerContext {
+    /** Session tracking */
+    sessionId: string;
+    pageId: string;
+    stepCounter: number;
+    /** Snapshot versioning */
+    currentSnapshot: BaseSnapshot | null;
+    previousSnapshot: BaseSnapshot | null;
+    /** Document tracking */
+    currentDocId: string | null;
+    /** Configuration */
+    config: StateManagerConfig;
+}
+/**
+ * State manager configuration.
+ */
+export interface StateManagerConfig {
+    /** Maximum actionables to return */
+    maxActionables: number;
+}
+/**
+ * Scoring context for actionables filtering.
+ */
+export interface ScoringContext {
+    /** Primary CTA from FactPack (if available) */
+    primaryCTA?: {
+        node_id: string;
+        label: string;
+    };
+    /** Active layer */
+    activeLayer: string;
+}
+/**
+ * EID to node mapping.
+ */
+export type EidMap = Map<string, ReadableNode>;
+/**
+ * Hash function type.
+ */
+export type HashFunction = (...components: string[]) => string;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/state/types.js

@@ -0,0 +1,8 @@
+/**
+ * State System Types
+ *
+ * Type definitions for the StateHandle + Diff + Actionables system.
+ * Universal and domain-agnostic - works on any website.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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

package/dist/src/tools/browser-tools.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Browser Tools
+ *
+ * MCP tool handlers for browser automation.
+ */
+import type { SessionManager } from '../browser/session-manager.js';
+import { SnapshotStore } from '../snapshot/index.js';
+/**
+ * Initialize tools with a session manager instance.
+ * Must be called before using any tool handlers.
+ *
+ * @param manager - SessionManager instance
+ */
+export declare function initializeTools(manager: SessionManager): void;
+/**
+ * Get the snapshot store.
+ */
+export declare function getSnapshotStore(): SnapshotStore;
+/**
+ * List all open browser pages with their metadata.
+ *
+ * Syncs with browser context to ensure all tabs are registered,
+ * including tabs opened externally or after reconnection.
+ *
+ * @returns XML result with page list
+ */
+export declare function listPages(): Promise<import('./tool-schemas.js').ListPagesOutput>;
+/**
+ * Close a specific page.
+ *
+ * @param rawInput - Close options (will be validated)
+ * @returns Close result
+ */
+export declare function closePage(rawInput: unknown): Promise<import('./tool-schemas.js').ClosePageOutput>;
+/**
+ * Close the entire browser session.
+ *
+ * @param rawInput - Close options (will be validated)
+ * @returns Close result
+ */
+export declare function closeSession(rawInput: unknown): Promise<import('./tool-schemas.js').CloseSessionOutput>;
+/**
+ * Navigate to a URL.
+ *
+ * @param rawInput - Navigation options (will be validated)
+ * @returns Navigation result with snapshot data
+ */
+export declare function navigate(rawInput: unknown): Promise<import('./tool-schemas.js').NavigateOutput>;
+/**
+ * Go back in browser history.
+ *
+ * @param rawInput - Navigation options (will be validated)
+ * @returns Navigation result with snapshot data
+ */
+export declare function goBack(rawInput: unknown): Promise<import('./tool-schemas.js').GoBackOutput>;
+/**
+ * Go forward in browser history.
+ *
+ * @param rawInput - Navigation options (will be validated)
+ * @returns Navigation result with snapshot data
+ */
+export declare function goForward(rawInput: unknown): Promise<import('./tool-schemas.js').GoForwardOutput>;
+/**
+ * Reload the current page.
+ *
+ * @param rawInput - Navigation options (will be validated)
+ * @returns Navigation result with snapshot data
+ */
+export declare function reload(rawInput: unknown): Promise<import('./tool-schemas.js').ReloadOutput>;
+/**
+ * Capture a fresh snapshot of the current page.
+ *
+ * @param rawInput - Capture options (will be validated)
+ * @returns Snapshot data for the current page
+ */
+export declare function captureSnapshot(rawInput: unknown): Promise<import('./tool-schemas.js').CaptureSnapshotOutput>;
+/**
+ * Find elements by semantic criteria.
+ *
+ * @param rawInput - Query filters (will be validated)
+ * @returns Matched nodes
+ */
+export declare function findElements(rawInput: unknown): import('./tool-schemas.js').FindElementsOutput;
+/**
+ * Get full details for a specific node.
+ *
+ * @param rawInput - Node details request (will be validated)
+ * @returns Full node details
+ */
+export declare function getNodeDetails(rawInput: unknown): import('./tool-schemas.js').GetNodeDetailsOutput;
+/**
+ * Scroll an element into view.
+ *
+ * @param rawInput - Scroll options (will be validated)
+ * @returns Scroll result with delta
+ */
+export declare function scrollElementIntoView(rawInput: unknown): Promise<import('./tool-schemas.js').ScrollElementIntoViewOutput>;
+/**
+ * Scroll the page up or down.
+ *
+ * @param rawInput - Scroll options (will be validated)
+ * @returns Scroll result with delta
+ */
+export declare function scrollPage(rawInput: unknown): Promise<import('./tool-schemas.js').ScrollPageOutput>;
+/**
+ * Click an element.
+ *
+ * @param rawInput - Click options (will be validated)
+ * @returns Click result with navigation-aware outcome
+ */
+export declare function click(rawInput: unknown): Promise<import('./tool-schemas.js').ClickOutput>;
+/**
+ * Type text into an element.
+ *
+ * @param rawInput - Type options (will be validated)
+ * @returns Type result with delta
+ */
+export declare function type(rawInput: unknown): Promise<import('./tool-schemas.js').TypeOutput>;
+/**
+ * Press a keyboard key (no agent_version).
+ *
+ * @param rawInput - Press options (will be validated)
+ * @returns Press result with delta
+ */
+export declare function press(rawInput: unknown): Promise<import('./tool-schemas.js').PressOutput>;
+/**
+ * Select a dropdown option.
+ *
+ * @param rawInput - Select options (will be validated)
+ * @returns Select result with delta
+ */
+export declare function select(rawInput: unknown): Promise<import('./tool-schemas.js').SelectOutput>;
+/**
+ * Hover over an element.
+ *
+ * @param rawInput - Hover options (will be validated)
+ * @returns Hover result with delta
+ */
+export declare function hover(rawInput: unknown): Promise<import('./tool-schemas.js').HoverOutput>;
+//# sourceMappingURL=browser-tools.d.ts.map

package/dist/src/tools/browser-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/browser-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EACL,aAAa,EAQd,MAAM,sBAAsB,CAAC;AA6D9B;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAE7D;AAYD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAqRD;;;;;;;GAOG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,OAAO,mBAAmB,EAAE,eAAe,CAAC,CAUtF;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,OAAO,mBAAmB,EAAE,eAAe,CAAC,CAUtD;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,OAAO,mBAAmB,EAAE,kBAAkB,CAAC,CAUzD;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,OAAO,mBAAmB,EAAE,cAAc,CAAC,CAsBrD;AAED;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,mBAAmB,EAAE,YAAY,CAAC,CAGjG;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,OAAO,mBAAmB,EAAE,eAAe,CAAC,CAGtD;AAED;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,mBAAmB,EAAE,YAAY,CAAC,CAGjG;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,OAAO,mBAAmB,EAAE,qBAAqB,CAAC,CA8B5D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,mBAAmB,EAAE,kBAAkB,CA0F9F;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,OAAO,GAChB,OAAO,mBAAmB,EAAE,oBAAoB,CAqDlD;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,OAAO,mBAAmB,EAAE,2BAA2B,CAAC,CAuBlE;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,OAAO,mBAAmB,EAAE,gBAAgB,CAAC,CAkBvD;AAED;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,mBAAmB,EAAE,WAAW,CAAC,CAuB/F;AAED;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,mBAAmB,EAAE,UAAU,CAAC,CAyB7F;AAED;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,mBAAmB,EAAE,WAAW,CAAC,CAkB/F;AAED;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,mBAAmB,EAAE,YAAY,CAAC,CAuBjG;AAED;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,mBAAmB,EAAE,WAAW,CAAC,CAuB/F"}