agent-web-interface 4.4.0 → 4.5.0

package/dist/src/tools/tool-schemas.d.ts

@@ -5,141 +5,6 @@
  * Used for validation and type inference.
  */
 import { z } from 'zod';
-/**
- * Snapshot health codes - specific reasons for snapshot failures.
- */
-export declare const SnapshotHealthCodeSchema: z.ZodEnum<["HEALTHY", "PENDING_DOM", "AX_EMPTY", "DOM_EMPTY", "CDP_SESSION_DEAD", "UNKNOWN"]>;
-/**
- * CDP session health status.
- */
-export declare const CdpHealthSchema: z.ZodObject<{
-    /** Whether CDP session is operational */
-    ok: z.ZodBoolean;
-    /** Whether recovery was attempted and succeeded */
-    recovered: z.ZodOptional<z.ZodBoolean>;
-    /** Recovery method used if recovery occurred */
-    recovery_method: z.ZodOptional<z.ZodLiteral<"rebind">>;
-    /** Error message if not ok */
-    error: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    ok: boolean;
-    error?: string | undefined;
-    recovered?: boolean | undefined;
-    recovery_method?: "rebind" | undefined;
-}, {
-    ok: boolean;
-    error?: string | undefined;
-    recovered?: boolean | undefined;
-    recovery_method?: "rebind" | undefined;
-}>;
-/**
- * Snapshot capture health status.
- */
-export declare const SnapshotCaptureHealthSchema: z.ZodObject<{
-    /** Whether snapshot is usable */
-    ok: z.ZodBoolean;
-    /** Whether recovery was attempted */
-    recovered: z.ZodOptional<z.ZodBoolean>;
-    /** Health code explaining status */
-    code: z.ZodEnum<["HEALTHY", "PENDING_DOM", "AX_EMPTY", "DOM_EMPTY", "CDP_SESSION_DEAD", "UNKNOWN"]>;
-    /** Number of capture attempts */
-    attempts: z.ZodOptional<z.ZodNumber>;
-    /** Human-readable message */
-    message: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    code: "HEALTHY" | "PENDING_DOM" | "AX_EMPTY" | "DOM_EMPTY" | "CDP_SESSION_DEAD" | "UNKNOWN";
-    ok: boolean;
-    message?: string | undefined;
-    attempts?: number | undefined;
-    recovered?: boolean | undefined;
-}, {
-    code: "HEALTHY" | "PENDING_DOM" | "AX_EMPTY" | "DOM_EMPTY" | "CDP_SESSION_DEAD" | "UNKNOWN";
-    ok: boolean;
-    message?: string | undefined;
-    attempts?: number | undefined;
-    recovered?: boolean | undefined;
-}>;
-/**
- * Runtime health info included in tool responses.
- * Enables LLM to understand CDP/snapshot recovery status.
- */
-export declare const RuntimeHealthSchema: z.ZodObject<{
-    /** CDP session health */
-    cdp: z.ZodObject<{
-        /** Whether CDP session is operational */
-        ok: z.ZodBoolean;
-        /** Whether recovery was attempted and succeeded */
-        recovered: z.ZodOptional<z.ZodBoolean>;
-        /** Recovery method used if recovery occurred */
-        recovery_method: z.ZodOptional<z.ZodLiteral<"rebind">>;
-        /** Error message if not ok */
-        error: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        ok: boolean;
-        error?: string | undefined;
-        recovered?: boolean | undefined;
-        recovery_method?: "rebind" | undefined;
-    }, {
-        ok: boolean;
-        error?: string | undefined;
-        recovered?: boolean | undefined;
-        recovery_method?: "rebind" | undefined;
-    }>;
-    /** Snapshot capture health */
-    snapshot: z.ZodObject<{
-        /** Whether snapshot is usable */
-        ok: z.ZodBoolean;
-        /** Whether recovery was attempted */
-        recovered: z.ZodOptional<z.ZodBoolean>;
-        /** Health code explaining status */
-        code: z.ZodEnum<["HEALTHY", "PENDING_DOM", "AX_EMPTY", "DOM_EMPTY", "CDP_SESSION_DEAD", "UNKNOWN"]>;
-        /** Number of capture attempts */
-        attempts: z.ZodOptional<z.ZodNumber>;
-        /** Human-readable message */
-        message: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        code: "HEALTHY" | "PENDING_DOM" | "AX_EMPTY" | "DOM_EMPTY" | "CDP_SESSION_DEAD" | "UNKNOWN";
-        ok: boolean;
-        message?: string | undefined;
-        attempts?: number | undefined;
-        recovered?: boolean | undefined;
-    }, {
-        code: "HEALTHY" | "PENDING_DOM" | "AX_EMPTY" | "DOM_EMPTY" | "CDP_SESSION_DEAD" | "UNKNOWN";
-        ok: boolean;
-        message?: string | undefined;
-        attempts?: number | undefined;
-        recovered?: boolean | undefined;
-    }>;
-}, "strip", z.ZodTypeAny, {
-    cdp: {
-        ok: boolean;
-        error?: string | undefined;
-        recovered?: boolean | undefined;
-        recovery_method?: "rebind" | undefined;
-    };
-    snapshot: {
-        code: "HEALTHY" | "PENDING_DOM" | "AX_EMPTY" | "DOM_EMPTY" | "CDP_SESSION_DEAD" | "UNKNOWN";
-        ok: boolean;
-        message?: string | undefined;
-        attempts?: number | undefined;
-        recovered?: boolean | undefined;
-    };
-}, {
-    cdp: {
-        ok: boolean;
-        error?: string | undefined;
-        recovered?: boolean | undefined;
-        recovery_method?: "rebind" | undefined;
-    };
-    snapshot: {
-        code: "HEALTHY" | "PENDING_DOM" | "AX_EMPTY" | "DOM_EMPTY" | "CDP_SESSION_DEAD" | "UNKNOWN";
-        ok: boolean;
-        message?: string | undefined;
-        attempts?: number | undefined;
-        recovered?: boolean | undefined;
-    };
-}>;
-export type RuntimeHealth = z.infer<typeof RuntimeHealthSchema>;
 /** Full node details including location, layout, state, and attributes */
 export declare const NodeDetailsSchema: z.ZodObject<{
     /** Stable element ID for use with action tools */
@@ -208,33 +73,36 @@ export declare const NodeDetailsSchema: z.ZodObject<{
     state: z.ZodOptional<z.ZodObject<{
         visible: z.ZodOptional<z.ZodBoolean>;
         enabled: z.ZodOptional<z.ZodBoolean>;
-        checked: z.ZodOptional<z.ZodBoolean>;
+        checked: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"mixed">]>>;
         expanded: z.ZodOptional<z.ZodBoolean>;
         selected: z.ZodOptional<z.ZodBoolean>;
+        pressed: z.ZodOptional<z.ZodBoolean>;
         focused: z.ZodOptional<z.ZodBoolean>;
         required: z.ZodOptional<z.ZodBoolean>;
         invalid: z.ZodOptional<z.ZodBoolean>;
         readonly: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        readonly?: boolean | undefined;
-        required?: boolean | undefined;
         visible?: boolean | undefined;
         enabled?: boolean | undefined;
-        checked?: boolean | undefined;
-        expanded?: boolean | undefined;
+        checked?: boolean | "mixed" | undefined;
         selected?: boolean | undefined;
+        expanded?: boolean | undefined;
         focused?: boolean | undefined;
+        required?: boolean | undefined;
         invalid?: boolean | undefined;
-    }, {
         readonly?: boolean | undefined;
-        required?: boolean | undefined;
+        pressed?: boolean | undefined;
+    }, {
         visible?: boolean | undefined;
         enabled?: boolean | undefined;
-        checked?: boolean | undefined;
-        expanded?: boolean | undefined;
+        checked?: boolean | "mixed" | undefined;
         selected?: boolean | undefined;
+        expanded?: boolean | undefined;
         focused?: boolean | undefined;
+        required?: boolean | undefined;
         invalid?: boolean | undefined;
+        readonly?: boolean | undefined;
+        pressed?: boolean | undefined;
     }>>;
     /** Locator strategies */
     find: z.ZodOptional<z.ZodObject<{
@@ -262,33 +130,35 @@ export declare const NodeDetailsSchema: z.ZodObject<{
         role: z.ZodOptional<z.ZodString>;
         test_id: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        src?: string | undefined;
+        placeholder?: string | undefined;
         method?: string | undefined;
-        value?: string | undefined;
+        autocomplete?: string | undefined;
         role?: string | undefined;
-        placeholder?: string | undefined;
+        value?: string | undefined;
         alt?: string | undefined;
         href?: string | undefined;
+        src?: string | undefined;
         action?: string | undefined;
-        autocomplete?: string | undefined;
         input_type?: string | undefined;
         heading_level?: number | undefined;
         test_id?: string | undefined;
     }, {
-        src?: string | undefined;
+        placeholder?: string | undefined;
         method?: string | undefined;
-        value?: string | undefined;
+        autocomplete?: string | undefined;
         role?: string | undefined;
-        placeholder?: string | undefined;
+        value?: string | undefined;
         alt?: string | undefined;
         href?: string | undefined;
+        src?: string | undefined;
         action?: string | undefined;
-        autocomplete?: string | undefined;
         input_type?: string | undefined;
         heading_level?: number | undefined;
         test_id?: string | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
+    eid: string;
+    label: string;
     layout: {
         bbox: {
             x: number;
@@ -299,8 +169,6 @@ export declare const NodeDetailsSchema: z.ZodObject<{
         display?: string | undefined;
         screen_zone?: string | undefined;
     };
-    eid: string;
-    label: string;
     kind: string;
     where: {
         region: string;
@@ -313,31 +181,34 @@ export declare const NodeDetailsSchema: z.ZodObject<{
         alternates?: string[] | undefined;
     } | undefined;
     state?: {
-        readonly?: boolean | undefined;
-        required?: boolean | undefined;
         visible?: boolean | undefined;
         enabled?: boolean | undefined;
-        checked?: boolean | undefined;
-        expanded?: boolean | undefined;
+        checked?: boolean | "mixed" | undefined;
         selected?: boolean | undefined;
+        expanded?: boolean | undefined;
         focused?: boolean | undefined;
+        required?: boolean | undefined;
         invalid?: boolean | undefined;
+        readonly?: boolean | undefined;
+        pressed?: boolean | undefined;
     } | undefined;
     attributes?: {
-        src?: string | undefined;
+        placeholder?: string | undefined;
         method?: string | undefined;
-        value?: string | undefined;
+        autocomplete?: string | undefined;
         role?: string | undefined;
-        placeholder?: string | undefined;
+        value?: string | undefined;
         alt?: string | undefined;
         href?: string | undefined;
+        src?: string | undefined;
         action?: string | undefined;
-        autocomplete?: string | undefined;
         input_type?: string | undefined;
         heading_level?: number | undefined;
         test_id?: string | undefined;
     } | undefined;
 }, {
+    eid: string;
+    label: string;
     layout: {
         bbox: {
             x: number;
@@ -348,8 +219,6 @@ export declare const NodeDetailsSchema: z.ZodObject<{
         display?: string | undefined;
         screen_zone?: string | undefined;
     };
-    eid: string;
-    label: string;
     kind: string;
     where: {
         region: string;
@@ -362,1778 +231,33 @@ export declare const NodeDetailsSchema: z.ZodObject<{
         alternates?: string[] | undefined;
     } | undefined;
     state?: {
-        readonly?: boolean | undefined;
-        required?: boolean | undefined;
         visible?: boolean | undefined;
         enabled?: boolean | undefined;
-        checked?: boolean | undefined;
-        expanded?: boolean | undefined;
+        checked?: boolean | "mixed" | undefined;
         selected?: boolean | undefined;
+        expanded?: boolean | undefined;
         focused?: boolean | undefined;
+        required?: boolean | undefined;
         invalid?: boolean | undefined;
+        readonly?: boolean | undefined;
+        pressed?: boolean | undefined;
     } | undefined;
     attributes?: {
-        src?: string | undefined;
+        placeholder?: string | undefined;
         method?: string | undefined;
-        value?: string | undefined;
+        autocomplete?: string | undefined;
         role?: string | undefined;
-        placeholder?: string | undefined;
+        value?: string | undefined;
         alt?: string | undefined;
         href?: string | undefined;
+        src?: string | undefined;
         action?: string | undefined;
-        autocomplete?: string | undefined;
         input_type?: string | undefined;
         heading_level?: number | undefined;
         test_id?: string | undefined;
     } | undefined;
 }>;
 export type NodeDetails = z.infer<typeof NodeDetailsSchema>;
-/**
- * Locator information for element targeting.
- */
-export declare const LocatorInfoSchema: z.ZodObject<{
-    preferred: z.ZodObject<{
-        ax: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        ax: string;
-    }, {
-        ax: string;
-    }>;
-    fallback: z.ZodOptional<z.ZodObject<{
-        css: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        css: string;
-    }, {
-        css: string;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    preferred: {
-        ax: string;
-    };
-    fallback?: {
-        css: string;
-    } | undefined;
-}, {
-    preferred: {
-        ax: string;
-    };
-    fallback?: {
-        css: string;
-    } | undefined;
-}>;
-/**
- * Element target reference - for direct targeting via backend_node_id.
- * Included in actionables to enable direct element interaction.
- */
-export declare const ElementTargetRefSchema: z.ZodObject<{
-    /** Snapshot that produced this ref */
-    snapshot_id: z.ZodString;
-    /** CDP backend node ID - primary targeting method */
-    backend_node_id: z.ZodNumber;
-    /** CDP frame ID - for cross-frame targeting */
-    frame_id: z.ZodOptional<z.ZodString>;
-    /** CDP loader ID - changes on navigation */
-    loader_id: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    snapshot_id: string;
-    backend_node_id: number;
-    frame_id?: string | undefined;
-    loader_id?: string | undefined;
-}, {
-    snapshot_id: string;
-    backend_node_id: number;
-    frame_id?: string | undefined;
-    loader_id?: string | undefined;
-}>;
-/**
- * Actionable element information.
- * Returned as a capped list of interactive elements in the active layer.
- *
- * NEW: Includes `ref` for direct element targeting. Use `eid` for stable
- * identity across snapshots, and `ref.backend_node_id` for immediate actions.
- */
-export declare const ActionableInfoSchema: z.ZodObject<{
-    eid: z.ZodString;
-    kind: z.ZodString;
-    name: z.ZodString;
-    role: z.ZodString;
-    vis: z.ZodBoolean;
-    ena: z.ZodBoolean;
-    /** Element target reference for direct interaction */
-    ref: z.ZodObject<{
-        /** Snapshot that produced this ref */
-        snapshot_id: z.ZodString;
-        /** CDP backend node ID - primary targeting method */
-        backend_node_id: z.ZodNumber;
-        /** CDP frame ID - for cross-frame targeting */
-        frame_id: z.ZodOptional<z.ZodString>;
-        /** CDP loader ID - changes on navigation */
-        loader_id: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        snapshot_id: string;
-        backend_node_id: number;
-        frame_id?: string | undefined;
-        loader_id?: string | undefined;
-    }, {
-        snapshot_id: string;
-        backend_node_id: number;
-        frame_id?: string | undefined;
-        loader_id?: string | undefined;
-    }>;
-    loc: z.ZodObject<{
-        preferred: z.ZodObject<{
-            ax: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            ax: string;
-        }, {
-            ax: string;
-        }>;
-        fallback: z.ZodOptional<z.ZodObject<{
-            css: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            css: string;
-        }, {
-            css: string;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        preferred: {
-            ax: string;
-        };
-        fallback?: {
-            css: string;
-        } | undefined;
-    }, {
-        preferred: {
-            ax: string;
-        };
-        fallback?: {
-            css: string;
-        } | undefined;
-    }>;
-    ctx: z.ZodObject<{
-        layer: z.ZodString;
-        group: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        layer: string;
-        group?: string | undefined;
-    }, {
-        layer: string;
-        group?: string | undefined;
-    }>;
-    chk: z.ZodOptional<z.ZodBoolean>;
-    sel: z.ZodOptional<z.ZodBoolean>;
-    exp: z.ZodOptional<z.ZodBoolean>;
-    foc: z.ZodOptional<z.ZodBoolean>;
-    req: z.ZodOptional<z.ZodBoolean>;
-    inv: z.ZodOptional<z.ZodBoolean>;
-    rdo: z.ZodOptional<z.ZodBoolean>;
-    val_hint: z.ZodOptional<z.ZodString>;
-    placeholder: z.ZodOptional<z.ZodString>;
-    href: z.ZodOptional<z.ZodString>;
-    type: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    role: string;
-    eid: string;
-    vis: boolean;
-    ena: boolean;
-    kind: string;
-    ref: {
-        snapshot_id: string;
-        backend_node_id: number;
-        frame_id?: string | undefined;
-        loader_id?: string | undefined;
-    };
-    loc: {
-        preferred: {
-            ax: string;
-        };
-        fallback?: {
-            css: string;
-        } | undefined;
-    };
-    ctx: {
-        layer: string;
-        group?: string | undefined;
-    };
-    type?: string | undefined;
-    placeholder?: string | undefined;
-    href?: string | undefined;
-    chk?: boolean | undefined;
-    sel?: boolean | undefined;
-    exp?: boolean | undefined;
-    foc?: boolean | undefined;
-    req?: boolean | undefined;
-    inv?: boolean | undefined;
-    rdo?: boolean | undefined;
-    val_hint?: string | undefined;
-}, {
-    name: string;
-    role: string;
-    eid: string;
-    vis: boolean;
-    ena: boolean;
-    kind: string;
-    ref: {
-        snapshot_id: string;
-        backend_node_id: number;
-        frame_id?: string | undefined;
-        loader_id?: string | undefined;
-    };
-    loc: {
-        preferred: {
-            ax: string;
-        };
-        fallback?: {
-            css: string;
-        } | undefined;
-    };
-    ctx: {
-        layer: string;
-        group?: string | undefined;
-    };
-    type?: string | undefined;
-    placeholder?: string | undefined;
-    href?: string | undefined;
-    chk?: boolean | undefined;
-    sel?: boolean | undefined;
-    exp?: boolean | undefined;
-    foc?: boolean | undefined;
-    req?: boolean | undefined;
-    inv?: boolean | undefined;
-    rdo?: boolean | undefined;
-    val_hint?: string | undefined;
-}>;
-/**
- * State handle - core state metadata.
- */
-export declare const StateHandleSchema: z.ZodObject<{
-    sid: z.ZodString;
-    step: z.ZodNumber;
-    doc: z.ZodObject<{
-        url: z.ZodString;
-        origin: z.ZodString;
-        title: z.ZodString;
-        doc_id: z.ZodString;
-        nav_type: z.ZodEnum<["soft", "hard"]>;
-        history_idx: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        url: string;
-        title: string;
-        origin: string;
-        nav_type: "soft" | "hard";
-        doc_id: string;
-        history_idx: number;
-    }, {
-        url: string;
-        title: string;
-        origin: string;
-        nav_type: "soft" | "hard";
-        doc_id: string;
-        history_idx: number;
-    }>;
-    layer: z.ZodObject<{
-        active: z.ZodEnum<["main", "modal", "drawer", "popover"]>;
-        stack: z.ZodArray<z.ZodString, "many">;
-        focus_eid: z.ZodOptional<z.ZodString>;
-        pointer_lock: z.ZodBoolean;
-    }, "strip", z.ZodTypeAny, {
-        stack: string[];
-        active: "main" | "modal" | "drawer" | "popover";
-        pointer_lock: boolean;
-        focus_eid?: string | undefined;
-    }, {
-        stack: string[];
-        active: "main" | "modal" | "drawer" | "popover";
-        pointer_lock: boolean;
-        focus_eid?: string | undefined;
-    }>;
-    timing: z.ZodObject<{
-        ts: z.ZodString;
-        dom_ready: z.ZodBoolean;
-        network_busy: z.ZodBoolean;
-    }, "strip", z.ZodTypeAny, {
-        network_busy: boolean;
-        ts: string;
-        dom_ready: boolean;
-    }, {
-        network_busy: boolean;
-        ts: string;
-        dom_ready: boolean;
-    }>;
-    hash: z.ZodObject<{
-        ui: z.ZodString;
-        layer: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        layer: string;
-        ui: string;
-    }, {
-        layer: string;
-        ui: string;
-    }>;
-}, "strip", z.ZodTypeAny, {
-    doc: {
-        url: string;
-        title: string;
-        origin: string;
-        nav_type: "soft" | "hard";
-        doc_id: string;
-        history_idx: number;
-    };
-    layer: {
-        stack: string[];
-        active: "main" | "modal" | "drawer" | "popover";
-        pointer_lock: boolean;
-        focus_eid?: string | undefined;
-    };
-    sid: string;
-    step: number;
-    timing: {
-        network_busy: boolean;
-        ts: string;
-        dom_ready: boolean;
-    };
-    hash: {
-        layer: string;
-        ui: string;
-    };
-}, {
-    doc: {
-        url: string;
-        title: string;
-        origin: string;
-        nav_type: "soft" | "hard";
-        doc_id: string;
-        history_idx: number;
-    };
-    layer: {
-        stack: string[];
-        active: "main" | "modal" | "drawer" | "popover";
-        pointer_lock: boolean;
-        focus_eid?: string | undefined;
-    };
-    sid: string;
-    step: number;
-    timing: {
-        network_busy: boolean;
-        ts: string;
-        dom_ready: boolean;
-    };
-    hash: {
-        layer: string;
-        ui: 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
- */
-export declare const BaselineResponseSchema: z.ZodObject<{
-    mode: z.ZodLiteral<"baseline">;
-    reason: z.ZodEnum<["first", "navigation", "error"]>;
-    error: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    reason: "error" | "first" | "navigation";
-    mode: "baseline";
-    error?: string | undefined;
-}, {
-    reason: "error" | "first" | "navigation";
-    mode: "baseline";
-    error?: string | undefined;
-}>;
-/**
- * Diff change for actionables.
- */
-export declare const DiffChangeSchema: z.ZodObject<{
-    eid: z.ZodString;
-    k: z.ZodString;
-    from: z.ZodUnknown;
-    to: z.ZodUnknown;
-}, "strip", z.ZodTypeAny, {
-    eid: string;
-    k: string;
-    from?: unknown;
-    to?: unknown;
-}, {
-    eid: string;
-    k: string;
-    from?: unknown;
-    to?: unknown;
-}>;
-/**
- * Atom change.
- */
-export declare const AtomChangeSchema: z.ZodObject<{
-    k: z.ZodString;
-    from: z.ZodUnknown;
-    to: z.ZodUnknown;
-}, "strip", z.ZodTypeAny, {
-    k: string;
-    from?: unknown;
-    to?: unknown;
-}, {
-    k: string;
-    from?: unknown;
-    to?: unknown;
-}>;
-/**
- * Diff response (incremental changes).
- */
-export declare const DiffResponseSchema: z.ZodObject<{
-    mode: z.ZodLiteral<"diff">;
-    diff: z.ZodObject<{
-        doc: z.ZodOptional<z.ZodObject<{
-            from: z.ZodObject<{
-                url: z.ZodString;
-                title: z.ZodString;
-            }, "strip", z.ZodTypeAny, {
-                url: string;
-                title: string;
-            }, {
-                url: string;
-                title: string;
-            }>;
-            to: z.ZodObject<{
-                url: z.ZodString;
-                title: z.ZodString;
-            }, "strip", z.ZodTypeAny, {
-                url: string;
-                title: string;
-            }, {
-                url: string;
-                title: string;
-            }>;
-            nav_type: z.ZodEnum<["soft", "hard"]>;
-        }, "strip", z.ZodTypeAny, {
-            nav_type: "soft" | "hard";
-            from: {
-                url: string;
-                title: string;
-            };
-            to: {
-                url: string;
-                title: string;
-            };
-        }, {
-            nav_type: "soft" | "hard";
-            from: {
-                url: string;
-                title: string;
-            };
-            to: {
-                url: string;
-                title: string;
-            };
-        }>>;
-        layer: z.ZodOptional<z.ZodObject<{
-            stack_from: z.ZodArray<z.ZodString, "many">;
-            stack_to: z.ZodArray<z.ZodString, "many">;
-        }, "strip", z.ZodTypeAny, {
-            stack_from: string[];
-            stack_to: string[];
-        }, {
-            stack_from: string[];
-            stack_to: string[];
-        }>>;
-        actionables: z.ZodObject<{
-            added: z.ZodArray<z.ZodString, "many">;
-            removed: z.ZodArray<z.ZodString, "many">;
-            changed: z.ZodArray<z.ZodObject<{
-                eid: z.ZodString;
-                k: z.ZodString;
-                from: z.ZodUnknown;
-                to: z.ZodUnknown;
-            }, "strip", z.ZodTypeAny, {
-                eid: string;
-                k: string;
-                from?: unknown;
-                to?: unknown;
-            }, {
-                eid: string;
-                k: string;
-                from?: unknown;
-                to?: unknown;
-            }>, "many">;
-        }, "strip", z.ZodTypeAny, {
-            added: string[];
-            removed: string[];
-            changed: {
-                eid: string;
-                k: string;
-                from?: unknown;
-                to?: unknown;
-            }[];
-        }, {
-            added: string[];
-            removed: string[];
-            changed: {
-                eid: string;
-                k: string;
-                from?: unknown;
-                to?: unknown;
-            }[];
-        }>;
-        atoms: z.ZodArray<z.ZodObject<{
-            k: z.ZodString;
-            from: z.ZodUnknown;
-            to: z.ZodUnknown;
-        }, "strip", z.ZodTypeAny, {
-            k: string;
-            from?: unknown;
-            to?: unknown;
-        }, {
-            k: string;
-            from?: unknown;
-            to?: unknown;
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        actionables: {
-            added: string[];
-            removed: string[];
-            changed: {
-                eid: string;
-                k: string;
-                from?: unknown;
-                to?: unknown;
-            }[];
-        };
-        atoms: {
-            k: string;
-            from?: unknown;
-            to?: unknown;
-        }[];
-        doc?: {
-            nav_type: "soft" | "hard";
-            from: {
-                url: string;
-                title: string;
-            };
-            to: {
-                url: string;
-                title: string;
-            };
-        } | undefined;
-        layer?: {
-            stack_from: string[];
-            stack_to: string[];
-        } | undefined;
-    }, {
-        actionables: {
-            added: string[];
-            removed: string[];
-            changed: {
-                eid: string;
-                k: string;
-                from?: unknown;
-                to?: unknown;
-            }[];
-        };
-        atoms: {
-            k: string;
-            from?: unknown;
-            to?: unknown;
-        }[];
-        doc?: {
-            nav_type: "soft" | "hard";
-            from: {
-                url: string;
-                title: string;
-            };
-            to: {
-                url: string;
-                title: string;
-            };
-        } | undefined;
-        layer?: {
-            stack_from: string[];
-            stack_to: string[];
-        } | undefined;
-    }>;
-}, "strip", z.ZodTypeAny, {
-    diff: {
-        actionables: {
-            added: string[];
-            removed: string[];
-            changed: {
-                eid: string;
-                k: string;
-                from?: unknown;
-                to?: unknown;
-            }[];
-        };
-        atoms: {
-            k: string;
-            from?: unknown;
-            to?: unknown;
-        }[];
-        doc?: {
-            nav_type: "soft" | "hard";
-            from: {
-                url: string;
-                title: string;
-            };
-            to: {
-                url: string;
-                title: string;
-            };
-        } | undefined;
-        layer?: {
-            stack_from: string[];
-            stack_to: string[];
-        } | undefined;
-    };
-    mode: "diff";
-}, {
-    diff: {
-        actionables: {
-            added: string[];
-            removed: string[];
-            changed: {
-                eid: string;
-                k: string;
-                from?: unknown;
-                to?: unknown;
-            }[];
-        };
-        atoms: {
-            k: string;
-            from?: unknown;
-            to?: unknown;
-        }[];
-        doc?: {
-            nav_type: "soft" | "hard";
-            from: {
-                url: string;
-                title: string;
-            };
-            to: {
-                url: string;
-                title: string;
-            };
-        } | undefined;
-        layer?: {
-            stack_from: string[];
-            stack_to: string[];
-        } | undefined;
-    };
-    mode: "diff";
-}>;
-/**
- * Universal UI state atoms.
- */
-export declare const AtomsSchema: z.ZodObject<{
-    viewport: z.ZodObject<{
-        w: z.ZodNumber;
-        h: z.ZodNumber;
-        dpr: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        w: number;
-        h: number;
-        dpr: number;
-    }, {
-        w: number;
-        h: number;
-        dpr: number;
-    }>;
-    scroll: z.ZodObject<{
-        x: z.ZodNumber;
-        y: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        x: number;
-        y: number;
-    }, {
-        x: number;
-        y: number;
-    }>;
-    loading: z.ZodOptional<z.ZodObject<{
-        network_busy: z.ZodBoolean;
-        spinners: z.ZodNumber;
-        progress: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        network_busy: boolean;
-        spinners: number;
-        progress?: number | undefined;
-    }, {
-        network_busy: boolean;
-        spinners: number;
-        progress?: number | undefined;
-    }>>;
-    forms: z.ZodOptional<z.ZodObject<{
-        dirty: z.ZodBoolean;
-        focused_field: z.ZodOptional<z.ZodString>;
-        validation_errors: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        dirty: boolean;
-        validation_errors: number;
-        focused_field?: string | undefined;
-    }, {
-        dirty: boolean;
-        validation_errors: number;
-        focused_field?: string | undefined;
-    }>>;
-    notifications: z.ZodOptional<z.ZodObject<{
-        toasts: z.ZodNumber;
-        banners: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        toasts: number;
-        banners: number;
-    }, {
-        toasts: number;
-        banners: number;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    viewport: {
-        w: number;
-        h: number;
-        dpr: number;
-    };
-    scroll: {
-        x: number;
-        y: number;
-    };
-    notifications?: {
-        toasts: number;
-        banners: number;
-    } | undefined;
-    loading?: {
-        network_busy: boolean;
-        spinners: number;
-        progress?: number | undefined;
-    } | undefined;
-    forms?: {
-        dirty: boolean;
-        validation_errors: number;
-        focused_field?: string | undefined;
-    } | undefined;
-}, {
-    viewport: {
-        w: number;
-        h: number;
-        dpr: number;
-    };
-    scroll: {
-        x: number;
-        y: number;
-    };
-    notifications?: {
-        toasts: number;
-        banners: number;
-    } | undefined;
-    loading?: {
-        network_busy: boolean;
-        spinners: number;
-        progress?: number | undefined;
-    } | undefined;
-    forms?: {
-        dirty: boolean;
-        validation_errors: number;
-        focused_field?: string | undefined;
-    } | undefined;
-}>;
-/**
- * Internal state response object structure (for reference/documentation).
- * The actual StateResponse is an XML string for LLM context efficiency.
- */
-export declare const StateResponseObjectSchema: z.ZodObject<{
-    state: z.ZodObject<{
-        sid: z.ZodString;
-        step: z.ZodNumber;
-        doc: z.ZodObject<{
-            url: z.ZodString;
-            origin: z.ZodString;
-            title: z.ZodString;
-            doc_id: z.ZodString;
-            nav_type: z.ZodEnum<["soft", "hard"]>;
-            history_idx: z.ZodNumber;
-        }, "strip", z.ZodTypeAny, {
-            url: string;
-            title: string;
-            origin: string;
-            nav_type: "soft" | "hard";
-            doc_id: string;
-            history_idx: number;
-        }, {
-            url: string;
-            title: string;
-            origin: string;
-            nav_type: "soft" | "hard";
-            doc_id: string;
-            history_idx: number;
-        }>;
-        layer: z.ZodObject<{
-            active: z.ZodEnum<["main", "modal", "drawer", "popover"]>;
-            stack: z.ZodArray<z.ZodString, "many">;
-            focus_eid: z.ZodOptional<z.ZodString>;
-            pointer_lock: z.ZodBoolean;
-        }, "strip", z.ZodTypeAny, {
-            stack: string[];
-            active: "main" | "modal" | "drawer" | "popover";
-            pointer_lock: boolean;
-            focus_eid?: string | undefined;
-        }, {
-            stack: string[];
-            active: "main" | "modal" | "drawer" | "popover";
-            pointer_lock: boolean;
-            focus_eid?: string | undefined;
-        }>;
-        timing: z.ZodObject<{
-            ts: z.ZodString;
-            dom_ready: z.ZodBoolean;
-            network_busy: z.ZodBoolean;
-        }, "strip", z.ZodTypeAny, {
-            network_busy: boolean;
-            ts: string;
-            dom_ready: boolean;
-        }, {
-            network_busy: boolean;
-            ts: string;
-            dom_ready: boolean;
-        }>;
-        hash: z.ZodObject<{
-            ui: z.ZodString;
-            layer: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            layer: string;
-            ui: string;
-        }, {
-            layer: string;
-            ui: string;
-        }>;
-    }, "strip", z.ZodTypeAny, {
-        doc: {
-            url: string;
-            title: string;
-            origin: string;
-            nav_type: "soft" | "hard";
-            doc_id: string;
-            history_idx: number;
-        };
-        layer: {
-            stack: string[];
-            active: "main" | "modal" | "drawer" | "popover";
-            pointer_lock: boolean;
-            focus_eid?: string | undefined;
-        };
-        sid: string;
-        step: number;
-        timing: {
-            network_busy: boolean;
-            ts: string;
-            dom_ready: boolean;
-        };
-        hash: {
-            layer: string;
-            ui: string;
-        };
-    }, {
-        doc: {
-            url: string;
-            title: string;
-            origin: string;
-            nav_type: "soft" | "hard";
-            doc_id: string;
-            history_idx: number;
-        };
-        layer: {
-            stack: string[];
-            active: "main" | "modal" | "drawer" | "popover";
-            pointer_lock: boolean;
-            focus_eid?: string | undefined;
-        };
-        sid: string;
-        step: number;
-        timing: {
-            network_busy: boolean;
-            ts: string;
-            dom_ready: boolean;
-        };
-        hash: {
-            layer: string;
-            ui: string;
-        };
-    }>;
-    diff: z.ZodUnion<[z.ZodObject<{
-        mode: z.ZodLiteral<"baseline">;
-        reason: z.ZodEnum<["first", "navigation", "error"]>;
-        error: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        reason: "error" | "first" | "navigation";
-        mode: "baseline";
-        error?: string | undefined;
-    }, {
-        reason: "error" | "first" | "navigation";
-        mode: "baseline";
-        error?: string | undefined;
-    }>, z.ZodObject<{
-        mode: z.ZodLiteral<"diff">;
-        diff: z.ZodObject<{
-            doc: z.ZodOptional<z.ZodObject<{
-                from: z.ZodObject<{
-                    url: z.ZodString;
-                    title: z.ZodString;
-                }, "strip", z.ZodTypeAny, {
-                    url: string;
-                    title: string;
-                }, {
-                    url: string;
-                    title: string;
-                }>;
-                to: z.ZodObject<{
-                    url: z.ZodString;
-                    title: z.ZodString;
-                }, "strip", z.ZodTypeAny, {
-                    url: string;
-                    title: string;
-                }, {
-                    url: string;
-                    title: string;
-                }>;
-                nav_type: z.ZodEnum<["soft", "hard"]>;
-            }, "strip", z.ZodTypeAny, {
-                nav_type: "soft" | "hard";
-                from: {
-                    url: string;
-                    title: string;
-                };
-                to: {
-                    url: string;
-                    title: string;
-                };
-            }, {
-                nav_type: "soft" | "hard";
-                from: {
-                    url: string;
-                    title: string;
-                };
-                to: {
-                    url: string;
-                    title: string;
-                };
-            }>>;
-            layer: z.ZodOptional<z.ZodObject<{
-                stack_from: z.ZodArray<z.ZodString, "many">;
-                stack_to: z.ZodArray<z.ZodString, "many">;
-            }, "strip", z.ZodTypeAny, {
-                stack_from: string[];
-                stack_to: string[];
-            }, {
-                stack_from: string[];
-                stack_to: string[];
-            }>>;
-            actionables: z.ZodObject<{
-                added: z.ZodArray<z.ZodString, "many">;
-                removed: z.ZodArray<z.ZodString, "many">;
-                changed: z.ZodArray<z.ZodObject<{
-                    eid: z.ZodString;
-                    k: z.ZodString;
-                    from: z.ZodUnknown;
-                    to: z.ZodUnknown;
-                }, "strip", z.ZodTypeAny, {
-                    eid: string;
-                    k: string;
-                    from?: unknown;
-                    to?: unknown;
-                }, {
-                    eid: string;
-                    k: string;
-                    from?: unknown;
-                    to?: unknown;
-                }>, "many">;
-            }, "strip", z.ZodTypeAny, {
-                added: string[];
-                removed: string[];
-                changed: {
-                    eid: string;
-                    k: string;
-                    from?: unknown;
-                    to?: unknown;
-                }[];
-            }, {
-                added: string[];
-                removed: string[];
-                changed: {
-                    eid: string;
-                    k: string;
-                    from?: unknown;
-                    to?: unknown;
-                }[];
-            }>;
-            atoms: z.ZodArray<z.ZodObject<{
-                k: z.ZodString;
-                from: z.ZodUnknown;
-                to: z.ZodUnknown;
-            }, "strip", z.ZodTypeAny, {
-                k: string;
-                from?: unknown;
-                to?: unknown;
-            }, {
-                k: string;
-                from?: unknown;
-                to?: unknown;
-            }>, "many">;
-        }, "strip", z.ZodTypeAny, {
-            actionables: {
-                added: string[];
-                removed: string[];
-                changed: {
-                    eid: string;
-                    k: string;
-                    from?: unknown;
-                    to?: unknown;
-                }[];
-            };
-            atoms: {
-                k: string;
-                from?: unknown;
-                to?: unknown;
-            }[];
-            doc?: {
-                nav_type: "soft" | "hard";
-                from: {
-                    url: string;
-                    title: string;
-                };
-                to: {
-                    url: string;
-                    title: string;
-                };
-            } | undefined;
-            layer?: {
-                stack_from: string[];
-                stack_to: string[];
-            } | undefined;
-        }, {
-            actionables: {
-                added: string[];
-                removed: string[];
-                changed: {
-                    eid: string;
-                    k: string;
-                    from?: unknown;
-                    to?: unknown;
-                }[];
-            };
-            atoms: {
-                k: string;
-                from?: unknown;
-                to?: unknown;
-            }[];
-            doc?: {
-                nav_type: "soft" | "hard";
-                from: {
-                    url: string;
-                    title: string;
-                };
-                to: {
-                    url: string;
-                    title: string;
-                };
-            } | undefined;
-            layer?: {
-                stack_from: string[];
-                stack_to: string[];
-            } | undefined;
-        }>;
-    }, "strip", z.ZodTypeAny, {
-        diff: {
-            actionables: {
-                added: string[];
-                removed: string[];
-                changed: {
-                    eid: string;
-                    k: string;
-                    from?: unknown;
-                    to?: unknown;
-                }[];
-            };
-            atoms: {
-                k: string;
-                from?: unknown;
-                to?: unknown;
-            }[];
-            doc?: {
-                nav_type: "soft" | "hard";
-                from: {
-                    url: string;
-                    title: string;
-                };
-                to: {
-                    url: string;
-                    title: string;
-                };
-            } | undefined;
-            layer?: {
-                stack_from: string[];
-                stack_to: string[];
-            } | undefined;
-        };
-        mode: "diff";
-    }, {
-        diff: {
-            actionables: {
-                added: string[];
-                removed: string[];
-                changed: {
-                    eid: string;
-                    k: string;
-                    from?: unknown;
-                    to?: unknown;
-                }[];
-            };
-            atoms: {
-                k: string;
-                from?: unknown;
-                to?: unknown;
-            }[];
-            doc?: {
-                nav_type: "soft" | "hard";
-                from: {
-                    url: string;
-                    title: string;
-                };
-                to: {
-                    url: string;
-                    title: string;
-                };
-            } | undefined;
-            layer?: {
-                stack_from: string[];
-                stack_to: string[];
-            } | undefined;
-        };
-        mode: "diff";
-    }>]>;
-    actionables: z.ZodArray<z.ZodObject<{
-        eid: z.ZodString;
-        kind: z.ZodString;
-        name: z.ZodString;
-        role: z.ZodString;
-        vis: z.ZodBoolean;
-        ena: z.ZodBoolean;
-        /** Element target reference for direct interaction */
-        ref: z.ZodObject<{
-            /** Snapshot that produced this ref */
-            snapshot_id: z.ZodString;
-            /** CDP backend node ID - primary targeting method */
-            backend_node_id: z.ZodNumber;
-            /** CDP frame ID - for cross-frame targeting */
-            frame_id: z.ZodOptional<z.ZodString>;
-            /** CDP loader ID - changes on navigation */
-            loader_id: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            snapshot_id: string;
-            backend_node_id: number;
-            frame_id?: string | undefined;
-            loader_id?: string | undefined;
-        }, {
-            snapshot_id: string;
-            backend_node_id: number;
-            frame_id?: string | undefined;
-            loader_id?: string | undefined;
-        }>;
-        loc: z.ZodObject<{
-            preferred: z.ZodObject<{
-                ax: z.ZodString;
-            }, "strip", z.ZodTypeAny, {
-                ax: string;
-            }, {
-                ax: string;
-            }>;
-            fallback: z.ZodOptional<z.ZodObject<{
-                css: z.ZodString;
-            }, "strip", z.ZodTypeAny, {
-                css: string;
-            }, {
-                css: string;
-            }>>;
-        }, "strip", z.ZodTypeAny, {
-            preferred: {
-                ax: string;
-            };
-            fallback?: {
-                css: string;
-            } | undefined;
-        }, {
-            preferred: {
-                ax: string;
-            };
-            fallback?: {
-                css: string;
-            } | undefined;
-        }>;
-        ctx: z.ZodObject<{
-            layer: z.ZodString;
-            group: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            layer: string;
-            group?: string | undefined;
-        }, {
-            layer: string;
-            group?: string | undefined;
-        }>;
-        chk: z.ZodOptional<z.ZodBoolean>;
-        sel: z.ZodOptional<z.ZodBoolean>;
-        exp: z.ZodOptional<z.ZodBoolean>;
-        foc: z.ZodOptional<z.ZodBoolean>;
-        req: z.ZodOptional<z.ZodBoolean>;
-        inv: z.ZodOptional<z.ZodBoolean>;
-        rdo: z.ZodOptional<z.ZodBoolean>;
-        val_hint: z.ZodOptional<z.ZodString>;
-        placeholder: z.ZodOptional<z.ZodString>;
-        href: z.ZodOptional<z.ZodString>;
-        type: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        role: string;
-        eid: string;
-        vis: boolean;
-        ena: boolean;
-        kind: string;
-        ref: {
-            snapshot_id: string;
-            backend_node_id: number;
-            frame_id?: string | undefined;
-            loader_id?: string | undefined;
-        };
-        loc: {
-            preferred: {
-                ax: string;
-            };
-            fallback?: {
-                css: string;
-            } | undefined;
-        };
-        ctx: {
-            layer: string;
-            group?: string | undefined;
-        };
-        type?: string | undefined;
-        placeholder?: string | undefined;
-        href?: string | undefined;
-        chk?: boolean | undefined;
-        sel?: boolean | undefined;
-        exp?: boolean | undefined;
-        foc?: boolean | undefined;
-        req?: boolean | undefined;
-        inv?: boolean | undefined;
-        rdo?: boolean | undefined;
-        val_hint?: string | undefined;
-    }, {
-        name: string;
-        role: string;
-        eid: string;
-        vis: boolean;
-        ena: boolean;
-        kind: string;
-        ref: {
-            snapshot_id: string;
-            backend_node_id: number;
-            frame_id?: string | undefined;
-            loader_id?: string | undefined;
-        };
-        loc: {
-            preferred: {
-                ax: string;
-            };
-            fallback?: {
-                css: string;
-            } | undefined;
-        };
-        ctx: {
-            layer: string;
-            group?: string | undefined;
-        };
-        type?: string | undefined;
-        placeholder?: string | undefined;
-        href?: string | undefined;
-        chk?: boolean | undefined;
-        sel?: boolean | undefined;
-        exp?: boolean | undefined;
-        foc?: boolean | undefined;
-        req?: boolean | undefined;
-        inv?: boolean | undefined;
-        rdo?: boolean | undefined;
-        val_hint?: string | undefined;
-    }>, "many">;
-    counts: z.ZodObject<{
-        shown: z.ZodNumber;
-        total_in_layer: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        shown: number;
-        total_in_layer: number;
-    }, {
-        shown: number;
-        total_in_layer: number;
-    }>;
-    limits: z.ZodObject<{
-        max_actionables: z.ZodNumber;
-        actionables_capped: z.ZodBoolean;
-    }, "strip", z.ZodTypeAny, {
-        max_actionables: number;
-        actionables_capped: boolean;
-    }, {
-        max_actionables: number;
-        actionables_capped: boolean;
-    }>;
-    atoms: z.ZodObject<{
-        viewport: z.ZodObject<{
-            w: z.ZodNumber;
-            h: z.ZodNumber;
-            dpr: z.ZodNumber;
-        }, "strip", z.ZodTypeAny, {
-            w: number;
-            h: number;
-            dpr: number;
-        }, {
-            w: number;
-            h: number;
-            dpr: number;
-        }>;
-        scroll: z.ZodObject<{
-            x: z.ZodNumber;
-            y: z.ZodNumber;
-        }, "strip", z.ZodTypeAny, {
-            x: number;
-            y: number;
-        }, {
-            x: number;
-            y: number;
-        }>;
-        loading: z.ZodOptional<z.ZodObject<{
-            network_busy: z.ZodBoolean;
-            spinners: z.ZodNumber;
-            progress: z.ZodOptional<z.ZodNumber>;
-        }, "strip", z.ZodTypeAny, {
-            network_busy: boolean;
-            spinners: number;
-            progress?: number | undefined;
-        }, {
-            network_busy: boolean;
-            spinners: number;
-            progress?: number | undefined;
-        }>>;
-        forms: z.ZodOptional<z.ZodObject<{
-            dirty: z.ZodBoolean;
-            focused_field: z.ZodOptional<z.ZodString>;
-            validation_errors: z.ZodNumber;
-        }, "strip", z.ZodTypeAny, {
-            dirty: boolean;
-            validation_errors: number;
-            focused_field?: string | undefined;
-        }, {
-            dirty: boolean;
-            validation_errors: number;
-            focused_field?: string | undefined;
-        }>>;
-        notifications: z.ZodOptional<z.ZodObject<{
-            toasts: z.ZodNumber;
-            banners: z.ZodNumber;
-        }, "strip", z.ZodTypeAny, {
-            toasts: number;
-            banners: number;
-        }, {
-            toasts: number;
-            banners: number;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        viewport: {
-            w: number;
-            h: number;
-            dpr: number;
-        };
-        scroll: {
-            x: number;
-            y: number;
-        };
-        notifications?: {
-            toasts: number;
-            banners: number;
-        } | undefined;
-        loading?: {
-            network_busy: boolean;
-            spinners: number;
-            progress?: number | undefined;
-        } | undefined;
-        forms?: {
-            dirty: boolean;
-            validation_errors: number;
-            focused_field?: string | undefined;
-        } | undefined;
-    }, {
-        viewport: {
-            w: number;
-            h: number;
-            dpr: number;
-        };
-        scroll: {
-            x: number;
-            y: number;
-        };
-        notifications?: {
-            toasts: number;
-            banners: number;
-        } | undefined;
-        loading?: {
-            network_busy: boolean;
-            spinners: number;
-            progress?: number | undefined;
-        } | undefined;
-        forms?: {
-            dirty: boolean;
-            validation_errors: number;
-            focused_field?: string | undefined;
-        } | undefined;
-    }>;
-    tokens: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    diff: {
-        reason: "error" | "first" | "navigation";
-        mode: "baseline";
-        error?: string | undefined;
-    } | {
-        diff: {
-            actionables: {
-                added: string[];
-                removed: string[];
-                changed: {
-                    eid: string;
-                    k: string;
-                    from?: unknown;
-                    to?: unknown;
-                }[];
-            };
-            atoms: {
-                k: string;
-                from?: unknown;
-                to?: unknown;
-            }[];
-            doc?: {
-                nav_type: "soft" | "hard";
-                from: {
-                    url: string;
-                    title: string;
-                };
-                to: {
-                    url: string;
-                    title: string;
-                };
-            } | undefined;
-            layer?: {
-                stack_from: string[];
-                stack_to: string[];
-            } | undefined;
-        };
-        mode: "diff";
-    };
-    state: {
-        doc: {
-            url: string;
-            title: string;
-            origin: string;
-            nav_type: "soft" | "hard";
-            doc_id: string;
-            history_idx: number;
-        };
-        layer: {
-            stack: string[];
-            active: "main" | "modal" | "drawer" | "popover";
-            pointer_lock: boolean;
-            focus_eid?: string | undefined;
-        };
-        sid: string;
-        step: number;
-        timing: {
-            network_busy: boolean;
-            ts: string;
-            dom_ready: boolean;
-        };
-        hash: {
-            layer: string;
-            ui: string;
-        };
-    };
-    actionables: {
-        name: string;
-        role: string;
-        eid: string;
-        vis: boolean;
-        ena: boolean;
-        kind: string;
-        ref: {
-            snapshot_id: string;
-            backend_node_id: number;
-            frame_id?: string | undefined;
-            loader_id?: string | undefined;
-        };
-        loc: {
-            preferred: {
-                ax: string;
-            };
-            fallback?: {
-                css: string;
-            } | undefined;
-        };
-        ctx: {
-            layer: string;
-            group?: string | undefined;
-        };
-        type?: string | undefined;
-        placeholder?: string | undefined;
-        href?: string | undefined;
-        chk?: boolean | undefined;
-        sel?: boolean | undefined;
-        exp?: boolean | undefined;
-        foc?: boolean | undefined;
-        req?: boolean | undefined;
-        inv?: boolean | undefined;
-        rdo?: boolean | undefined;
-        val_hint?: string | undefined;
-    }[];
-    atoms: {
-        viewport: {
-            w: number;
-            h: number;
-            dpr: number;
-        };
-        scroll: {
-            x: number;
-            y: number;
-        };
-        notifications?: {
-            toasts: number;
-            banners: number;
-        } | undefined;
-        loading?: {
-            network_busy: boolean;
-            spinners: number;
-            progress?: number | undefined;
-        } | undefined;
-        forms?: {
-            dirty: boolean;
-            validation_errors: number;
-            focused_field?: string | undefined;
-        } | undefined;
-    };
-    tokens: number;
-    counts: {
-        shown: number;
-        total_in_layer: number;
-    };
-    limits: {
-        max_actionables: number;
-        actionables_capped: boolean;
-    };
-}, {
-    diff: {
-        reason: "error" | "first" | "navigation";
-        mode: "baseline";
-        error?: string | undefined;
-    } | {
-        diff: {
-            actionables: {
-                added: string[];
-                removed: string[];
-                changed: {
-                    eid: string;
-                    k: string;
-                    from?: unknown;
-                    to?: unknown;
-                }[];
-            };
-            atoms: {
-                k: string;
-                from?: unknown;
-                to?: unknown;
-            }[];
-            doc?: {
-                nav_type: "soft" | "hard";
-                from: {
-                    url: string;
-                    title: string;
-                };
-                to: {
-                    url: string;
-                    title: string;
-                };
-            } | undefined;
-            layer?: {
-                stack_from: string[];
-                stack_to: string[];
-            } | undefined;
-        };
-        mode: "diff";
-    };
-    state: {
-        doc: {
-            url: string;
-            title: string;
-            origin: string;
-            nav_type: "soft" | "hard";
-            doc_id: string;
-            history_idx: number;
-        };
-        layer: {
-            stack: string[];
-            active: "main" | "modal" | "drawer" | "popover";
-            pointer_lock: boolean;
-            focus_eid?: string | undefined;
-        };
-        sid: string;
-        step: number;
-        timing: {
-            network_busy: boolean;
-            ts: string;
-            dom_ready: boolean;
-        };
-        hash: {
-            layer: string;
-            ui: string;
-        };
-    };
-    actionables: {
-        name: string;
-        role: string;
-        eid: string;
-        vis: boolean;
-        ena: boolean;
-        kind: string;
-        ref: {
-            snapshot_id: string;
-            backend_node_id: number;
-            frame_id?: string | undefined;
-            loader_id?: string | undefined;
-        };
-        loc: {
-            preferred: {
-                ax: string;
-            };
-            fallback?: {
-                css: string;
-            } | undefined;
-        };
-        ctx: {
-            layer: string;
-            group?: string | undefined;
-        };
-        type?: string | undefined;
-        placeholder?: string | undefined;
-        href?: string | undefined;
-        chk?: boolean | undefined;
-        sel?: boolean | undefined;
-        exp?: boolean | undefined;
-        foc?: boolean | undefined;
-        req?: boolean | undefined;
-        inv?: boolean | undefined;
-        rdo?: boolean | undefined;
-        val_hint?: string | undefined;
-    }[];
-    atoms: {
-        viewport: {
-            w: number;
-            h: number;
-            dpr: number;
-        };
-        scroll: {
-            x: number;
-            y: number;
-        };
-        notifications?: {
-            toasts: number;
-            banners: number;
-        } | undefined;
-        loading?: {
-            network_busy: boolean;
-            spinners: number;
-            progress?: number | undefined;
-        } | undefined;
-        forms?: {
-            dirty: boolean;
-            validation_errors: number;
-            focused_field?: string | undefined;
-        } | undefined;
-    };
-    tokens: number;
-    counts: {
-        shown: number;
-        total_in_layer: number;
-    };
-    limits: {
-        max_actionables: number;
-        actionables_capped: boolean;
-    };
-}>;
-export type StateResponseObject = z.infer<typeof StateResponseObjectSchema>;
-/**
- * State response - returned after every action as a dense XML string.
- *
- * This is the NEW response format that replaces page_summary.
- * It's rendered as XML for maximum LLM context efficiency.
- * Contains:
- * - StateHandle: Current state metadata
- * - Diff: Incremental changes since last action (or baseline)
- * - Actionables: Capped list of interactive elements from active layer
- * - Atoms: Universal UI state facts
- */
-export declare const StateResponseSchema: z.ZodString;
-export type StateResponse = z.infer<typeof StateResponseSchema>;
-/**
- * Click outcome - result of a click action with navigation awareness.
- * Differentiates between "element gone due to navigation" vs "element stale due to DOM mutation".
- */
-export declare const ClickOutcomeSchema: z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
-    status: z.ZodLiteral<"success">;
-    /** Whether the click triggered a page navigation */
-    navigated: z.ZodBoolean;
-}, "strip", z.ZodTypeAny, {
-    status: "success";
-    navigated: boolean;
-}, {
-    status: "success";
-    navigated: boolean;
-}>, z.ZodObject<{
-    status: z.ZodLiteral<"stale_element">;
-    /** Why the element became stale */
-    reason: z.ZodEnum<["dom_mutation", "navigation"]>;
-    /** Whether retry was attempted */
-    retried: z.ZodBoolean;
-}, "strip", z.ZodTypeAny, {
-    status: "stale_element";
-    reason: "navigation" | "dom_mutation";
-    retried: boolean;
-}, {
-    status: "stale_element";
-    reason: "navigation" | "dom_mutation";
-    retried: boolean;
-}>, z.ZodObject<{
-    status: z.ZodLiteral<"element_not_found">;
-    /** The eid that wasn't found */
-    eid: z.ZodString;
-    /** Last known label for debugging */
-    last_known_label: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    status: "element_not_found";
-    eid: string;
-    last_known_label?: string | undefined;
-}, {
-    status: "element_not_found";
-    eid: string;
-    last_known_label?: string | undefined;
-}>, z.ZodObject<{
-    status: z.ZodLiteral<"error">;
-    /** Error message */
-    message: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    status: "error";
-}, {
-    message: string;
-    status: "error";
-}>]>;
-export type ClickOutcome = z.infer<typeof ClickOutcomeSchema>;
 export declare const ListPagesInputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
 /** Returns XML result string */
 export declare const ListPagesOutputSchema: z.ZodString;
@@ -2151,22 +275,29 @@ export declare const ClosePageInputSchema: z.ZodObject<{
 export declare const ClosePageOutputSchema: z.ZodString;
 export type ClosePageInput = z.infer<typeof ClosePageInputSchema>;
 export type ClosePageOutput = z.infer<typeof ClosePageOutputSchema>;
-export declare const CloseSessionInputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
-/** Returns XML result string */
-export declare const CloseSessionOutputSchema: z.ZodString;
-export type CloseSessionInput = z.infer<typeof CloseSessionInputSchema>;
-export type CloseSessionOutput = z.infer<typeof CloseSessionOutputSchema>;
 export declare const NavigateInputSchema: z.ZodObject<{
     /** URL to navigate to */
     url: z.ZodString;
     /** Page ID. If omitted, operates on the most recently used page */
     page_id: z.ZodOptional<z.ZodString>;
+    /** Launch browser without a visible window. Ignored if browser is already running. */
+    headless: z.ZodOptional<z.ZodBoolean>;
+    /** Use a fresh temporary profile instead of the persistent one. Ignored if browser is already running. */
+    isolated: z.ZodOptional<z.ZodBoolean>;
+    /** Connect to an already-running Chrome instead of launching a new one. Ignored if browser is already running. */
+    auto_connect: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     url: string;
     page_id?: string | undefined;
+    headless?: boolean | undefined;
+    isolated?: boolean | undefined;
+    auto_connect?: boolean | undefined;
 }, {
     url: string;
     page_id?: string | undefined;
+    headless?: boolean | undefined;
+    isolated?: boolean | undefined;
+    auto_connect?: boolean | undefined;
 }>;
 /** Returns XML state response string directly */
 export declare const NavigateOutputSchema: z.ZodString;
@@ -2236,16 +367,16 @@ export declare const FindElementsInputSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     limit: number;
     page_id?: string | undefined;
-    region?: "main" | "header" | "nav" | "footer" | undefined;
     label?: string | undefined;
-    kind?: "alert" | "image" | "link" | "button" | "combobox" | "checkbox" | "radio" | "heading" | "canvas" | "textbox" | undefined;
+    region?: "main" | "header" | "nav" | "footer" | undefined;
+    kind?: "alert" | "link" | "button" | "combobox" | "checkbox" | "radio" | "heading" | "image" | "canvas" | "textbox" | undefined;
     include_readable?: boolean | undefined;
 }, {
     page_id?: string | undefined;
-    region?: "main" | "header" | "nav" | "footer" | undefined;
     label?: string | undefined;
+    region?: "main" | "header" | "nav" | "footer" | undefined;
     limit?: number | undefined;
-    kind?: "alert" | "image" | "link" | "button" | "combobox" | "checkbox" | "radio" | "heading" | "canvas" | "textbox" | undefined;
+    kind?: "alert" | "link" | "button" | "combobox" | "checkbox" | "radio" | "heading" | "image" | "canvas" | "textbox" | undefined;
     include_readable?: boolean | undefined;
 }>;
 /** Returns XML result string */
@@ -2317,8 +448,6 @@ export declare const ScrollPageInputSchema: z.ZodObject<{
 export declare const ScrollPageOutputSchema: z.ZodString;
 export type ScrollPageInput = z.infer<typeof ScrollPageInputSchema>;
 export type ScrollPageOutput = z.infer<typeof ScrollPageOutputSchema>;
-/** Supported keyboard keys */
-export declare const SupportedKeys: readonly ["Enter", "Tab", "Escape", "Backspace", "Delete", "Space", "ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight", "Home", "End", "PageUp", "PageDown"];
 declare const ClickInputSchemaBase: z.ZodObject<{
     /** Page ID. If omitted, operates on the most recently used page */
     page_id: z.ZodOptional<z.ZodString>;
@@ -2332,16 +461,16 @@ declare const ClickInputSchemaBase: z.ZodObject<{
     modifiers: z.ZodOptional<z.ZodArray<z.ZodEnum<["Control", "Shift", "Alt", "Meta"]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     page_id?: string | undefined;
+    eid?: string | undefined;
     x?: number | undefined;
     y?: number | undefined;
     modifiers?: ("Control" | "Shift" | "Alt" | "Meta")[] | undefined;
-    eid?: string | undefined;
 }, {
     page_id?: string | undefined;
+    eid?: string | undefined;
     x?: number | undefined;
     y?: number | undefined;
     modifiers?: ("Control" | "Shift" | "Alt" | "Meta")[] | undefined;
-    eid?: string | undefined;
 }>;
 export declare const ClickInputSchema: z.ZodObject<{
     /** Page ID. If omitted, operates on the most recently used page */
@@ -2356,16 +485,16 @@ export declare const ClickInputSchema: z.ZodObject<{
     modifiers: z.ZodOptional<z.ZodArray<z.ZodEnum<["Control", "Shift", "Alt", "Meta"]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     page_id?: string | undefined;
+    eid?: string | undefined;
     x?: number | undefined;
     y?: number | undefined;
     modifiers?: ("Control" | "Shift" | "Alt" | "Meta")[] | undefined;
-    eid?: string | undefined;
 }, {
     page_id?: string | undefined;
+    eid?: string | undefined;
     x?: number | undefined;
     y?: number | undefined;
     modifiers?: ("Control" | "Shift" | "Alt" | "Meta")[] | undefined;
-    eid?: string | undefined;
 }>;
 export { ClickInputSchemaBase };
 /** Returns XML state response string directly */
@@ -2445,12 +574,12 @@ declare const SelectInputSchemaBase: z.ZodObject<{
     /** Page ID. If omitted, operates on the most recently used page */
     page_id: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    value: string;
     eid: string;
+    value: string;
     page_id?: string | undefined;
 }, {
-    value: string;
     eid: string;
+    value: string;
     page_id?: string | undefined;
 }>;
 export declare const SelectInputSchema: z.ZodObject<{
@@ -2461,12 +590,12 @@ export declare const SelectInputSchema: z.ZodObject<{
     /** Page ID. If omitted, operates on the most recently used page */
     page_id: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    value: string;
     eid: string;
+    value: string;
     page_id?: string | undefined;
 }, {
-    value: string;
     eid: string;
+    value: string;
     page_id?: string | undefined;
 }>;
 export { SelectInputSchemaBase };
@@ -2576,13 +705,13 @@ export declare const TakeScreenshotOutputSchema: z.ZodDiscriminatedUnion<"type",
     sizeBytes: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
     type: "file";
-    mimeType: string;
     path: string;
+    mimeType: string;
     sizeBytes: number;
 }, {
     type: "file";
-    mimeType: string;
     path: string;
+    mimeType: string;
     sizeBytes: number;
 }>]>;
 export type TakeScreenshotOutput = z.infer<typeof TakeScreenshotOutputSchema>;
@@ -2607,16 +736,16 @@ declare const DragInputSchemaBase: z.ZodObject<{
     target_x: number;
     target_y: number;
     page_id?: string | undefined;
-    modifiers?: ("Control" | "Shift" | "Alt" | "Meta")[] | undefined;
     eid?: string | undefined;
+    modifiers?: ("Control" | "Shift" | "Alt" | "Meta")[] | undefined;
 }, {
     source_x: number;
     source_y: number;
     target_x: number;
     target_y: number;
     page_id?: string | undefined;
-    modifiers?: ("Control" | "Shift" | "Alt" | "Meta")[] | undefined;
     eid?: string | undefined;
+    modifiers?: ("Control" | "Shift" | "Alt" | "Meta")[] | undefined;
 }>;
 export declare const DragInputSchema: z.ZodObject<{
     /** Source X coordinate */
@@ -2639,16 +768,16 @@ export declare const DragInputSchema: z.ZodObject<{
     target_x: number;
     target_y: number;
     page_id?: string | undefined;
-    modifiers?: ("Control" | "Shift" | "Alt" | "Meta")[] | undefined;
     eid?: string | undefined;
+    modifiers?: ("Control" | "Shift" | "Alt" | "Meta")[] | undefined;
 }, {
     source_x: number;
     source_y: number;
     target_x: number;
     target_y: number;
     page_id?: string | undefined;
-    modifiers?: ("Control" | "Shift" | "Alt" | "Meta")[] | undefined;
     eid?: string | undefined;
+    modifiers?: ("Control" | "Shift" | "Alt" | "Meta")[] | undefined;
 }>;
 export { DragInputSchemaBase };
 /** Returns XML state response string directly */
@@ -2676,16 +805,16 @@ declare const WheelInputSchemaBase: z.ZodObject<{
     deltaX: number;
     deltaY: number;
     page_id?: string | undefined;
-    modifiers?: ("Control" | "Shift" | "Alt" | "Meta")[] | undefined;
     eid?: string | undefined;
+    modifiers?: ("Control" | "Shift" | "Alt" | "Meta")[] | undefined;
 }, {
     x: number;
     y: number;
     deltaY: number;
     page_id?: string | undefined;
+    eid?: string | undefined;
     modifiers?: ("Control" | "Shift" | "Alt" | "Meta")[] | undefined;
     deltaX?: number | undefined;
-    eid?: string | undefined;
 }>;
 export declare const WheelInputSchema: z.ZodObject<{
     /** X coordinate where wheel event is dispatched */
@@ -2708,16 +837,16 @@ export declare const WheelInputSchema: z.ZodObject<{
     deltaX: number;
     deltaY: number;
     page_id?: string | undefined;
-    modifiers?: ("Control" | "Shift" | "Alt" | "Meta")[] | undefined;
     eid?: string | undefined;
+    modifiers?: ("Control" | "Shift" | "Alt" | "Meta")[] | undefined;
 }, {
     x: number;
     y: number;
     deltaY: number;
     page_id?: string | undefined;
+    eid?: string | undefined;
     modifiers?: ("Control" | "Shift" | "Alt" | "Meta")[] | undefined;
     deltaX?: number | undefined;
-    eid?: string | undefined;
 }>;
 export { WheelInputSchemaBase };
 /** Returns XML state response string directly */
@@ -2774,4 +903,16 @@ export declare const InspectCanvasInputSchema: z.ZodObject<{
 }>;
 export { InspectCanvasInputSchemaBase };
 export type InspectCanvasInput = z.infer<typeof InspectCanvasInputSchema>;
+export declare const ReadPageInputSchema: z.ZodObject<{
+    /** Page ID. If omitted, operates on the most recently used page */
+    page_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    page_id?: string | undefined;
+}, {
+    page_id?: string | undefined;
+}>;
+/** Returns XML result string */
+export declare const ReadPageOutputSchema: z.ZodString;
+export type ReadPageInput = z.infer<typeof ReadPageInputSchema>;
+export type ReadPageOutput = z.infer<typeof ReadPageOutputSchema>;
 //# sourceMappingURL=tool-schemas.d.ts.map