@roll-agent/browser-use-agent 0.26.1 → 0.27.0

package/dist/goal/observation.d.ts

@@ -0,0 +1,981 @@
+import { z } from "zod";
+import type { ReadDocument } from "./task-progress.ts";
+import type { BrowserAxSnapshot, NativeCdpController } from "@roll-agent/browser";
+export declare const GoalRequiredSourceSchema: z.ZodEnum<["html", "aria", "label-required", "label-optional"]>;
+export declare const GoalControlConstraintsSchema: z.ZodObject<{
+    min: z.ZodOptional<z.ZodString>;
+    max: z.ZodOptional<z.ZodString>;
+    step: z.ZodOptional<z.ZodString>;
+    minlength: z.ZodOptional<z.ZodString>;
+    maxlength: z.ZodOptional<z.ZodString>;
+    pattern: z.ZodOptional<z.ZodString>;
+    multiple: z.ZodOptional<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    multiple?: boolean | undefined;
+    pattern?: string | undefined;
+    min?: string | undefined;
+    max?: string | undefined;
+    step?: string | undefined;
+    minlength?: string | undefined;
+    maxlength?: string | undefined;
+}, {
+    multiple?: boolean | undefined;
+    pattern?: string | undefined;
+    min?: string | undefined;
+    max?: string | undefined;
+    step?: string | undefined;
+    minlength?: string | undefined;
+    maxlength?: string | undefined;
+}>;
+export declare const GoalControlSchema: z.ZodObject<{
+    availability: z.ZodEnum<["ready", "offscreen", "covered", "hidden", "unavailable"]>;
+    editable: z.ZodDefault<z.ZodBoolean>;
+    /** Fresh applied DOM readback can remain readable while pointer input is covered. */
+    readable: z.ZodOptional<z.ZodBoolean>;
+    domSemantics: z.ZodOptional<z.ZodObject<{
+        tag: z.ZodString;
+        role: z.ZodString;
+        disabled: z.ZodBoolean;
+        readOnly: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        role: string;
+        disabled: boolean;
+        tag: string;
+        readOnly: boolean;
+    }, {
+        role: string;
+        disabled: boolean;
+        tag: string;
+        readOnly: boolean;
+    }>>;
+    expanded: z.ZodOptional<z.ZodBoolean>;
+    picker: z.ZodOptional<z.ZodObject<{
+        part: z.ZodEnum<["trigger", "option"]>;
+        relationship: z.ZodEnum<["aria", "local-dom", "unknown"]>;
+        triggerPath: z.ZodOptional<z.ZodString>;
+        panelPaths: z.ZodArray<z.ZodString, "many">;
+        label: z.ZodOptional<z.ZodString>;
+        labelSource: z.ZodOptional<z.ZodEnum<["label", "placeholder", "empty-display"]>>;
+        expanded: z.ZodOptional<z.ZodBoolean>;
+        panelVisible: z.ZodOptional<z.ZodBoolean>;
+        selection: z.ZodEnum<["empty", "value", "unknown"]>;
+        selectionEvidence: z.ZodEnum<["native-select", "backing-input", "unknown"]>;
+        committedText: z.ZodOptional<z.ZodString>;
+        queryText: z.ZodOptional<z.ZodString>;
+        optionText: z.ZodOptional<z.ZodString>;
+        optionLabel: z.ZodOptional<z.ZodString>;
+        optionPath: z.ZodOptional<z.ZodString>;
+        optionSelected: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        selection: "value" | "unknown" | "empty";
+        part: "option" | "trigger";
+        relationship: "unknown" | "aria" | "local-dom";
+        panelPaths: string[];
+        selectionEvidence: "unknown" | "native-select" | "backing-input";
+        label?: string | undefined;
+        expanded?: boolean | undefined;
+        triggerPath?: string | undefined;
+        labelSource?: "label" | "placeholder" | "empty-display" | undefined;
+        panelVisible?: boolean | undefined;
+        committedText?: string | undefined;
+        queryText?: string | undefined;
+        optionText?: string | undefined;
+        optionLabel?: string | undefined;
+        optionPath?: string | undefined;
+        optionSelected?: boolean | undefined;
+    }, {
+        selection: "value" | "unknown" | "empty";
+        part: "option" | "trigger";
+        relationship: "unknown" | "aria" | "local-dom";
+        panelPaths: string[];
+        selectionEvidence: "unknown" | "native-select" | "backing-input";
+        label?: string | undefined;
+        expanded?: boolean | undefined;
+        triggerPath?: string | undefined;
+        labelSource?: "label" | "placeholder" | "empty-display" | undefined;
+        panelVisible?: boolean | undefined;
+        committedText?: string | undefined;
+        queryText?: string | undefined;
+        optionText?: string | undefined;
+        optionLabel?: string | undefined;
+        optionPath?: string | undefined;
+        optionSelected?: boolean | undefined;
+    }>>;
+    htmlId: z.ZodOptional<z.ZodString>;
+    controlsIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    ancestorIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    ownerPaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    ancestorPaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    position: z.ZodOptional<z.ZodObject<{
+        top: z.ZodNumber;
+        left: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        left: number;
+        top: number;
+    }, {
+        left: number;
+        top: number;
+    }>>;
+    /** Nearest-first scrollable ancestor paths, including same-origin parent frames. */
+    scrollContainerPaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** An edge overlay requires explicit scroll; native visibility reveal alone is insufficient. */
+    revealViaScroll: z.ZodOptional<z.ZodBoolean>;
+    labelledByIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    fieldLabel: z.ZodOptional<z.ZodString>;
+    peerGroup: z.ZodOptional<z.ZodObject<{
+        key: z.ZodString;
+        position: z.ZodNumber;
+        count: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        count: number;
+        key: string;
+        position: number;
+    }, {
+        count: number;
+        key: string;
+        position: number;
+    }>>;
+    validationErrors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    requiredSource: z.ZodOptional<z.ZodEnum<["html", "aria", "label-required", "label-optional"]>>;
+    constraints: z.ZodOptional<z.ZodObject<{
+        min: z.ZodOptional<z.ZodString>;
+        max: z.ZodOptional<z.ZodString>;
+        step: z.ZodOptional<z.ZodString>;
+        minlength: z.ZodOptional<z.ZodString>;
+        maxlength: z.ZodOptional<z.ZodString>;
+        pattern: z.ZodOptional<z.ZodString>;
+        multiple: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        multiple?: boolean | undefined;
+        pattern?: string | undefined;
+        min?: string | undefined;
+        max?: string | undefined;
+        step?: string | undefined;
+        minlength?: string | undefined;
+        maxlength?: string | undefined;
+    }, {
+        multiple?: boolean | undefined;
+        pattern?: string | undefined;
+        min?: string | undefined;
+        max?: string | undefined;
+        step?: string | undefined;
+        minlength?: string | undefined;
+        maxlength?: string | undefined;
+    }>>;
+    inputType: z.ZodOptional<z.ZodString>;
+    observedValue: z.ZodOptional<z.ZodString>;
+    actionValue: z.ZodOptional<z.ZodString>;
+    displayText: z.ZodOptional<z.ZodString>;
+    observedName: z.ZodOptional<z.ZodString>;
+    context: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    layer: z.ZodOptional<z.ZodString>;
+    layerKey: z.ZodOptional<z.ZodString>;
+    modal: z.ZodOptional<z.ZodBoolean>;
+    checked: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"mixed">]>>;
+    nativeSelect: z.ZodOptional<z.ZodBoolean>;
+    options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+        selected: z.ZodBoolean;
+        disabled: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        label: string;
+        disabled: boolean;
+        selected: boolean;
+    }, {
+        value: string;
+        label: string;
+        disabled: boolean;
+        selected: boolean;
+    }>, "many">>;
+    optionsTruncated: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    context: string[];
+    editable: boolean;
+    availability: "hidden" | "ready" | "offscreen" | "covered" | "unavailable";
+    options?: {
+        value: string;
+        label: string;
+        disabled: boolean;
+        selected: boolean;
+    }[] | undefined;
+    checked?: boolean | "mixed" | undefined;
+    expanded?: boolean | undefined;
+    required?: boolean | undefined;
+    readable?: boolean | undefined;
+    domSemantics?: {
+        role: string;
+        disabled: boolean;
+        tag: string;
+        readOnly: boolean;
+    } | undefined;
+    picker?: {
+        selection: "value" | "unknown" | "empty";
+        part: "option" | "trigger";
+        relationship: "unknown" | "aria" | "local-dom";
+        panelPaths: string[];
+        selectionEvidence: "unknown" | "native-select" | "backing-input";
+        label?: string | undefined;
+        expanded?: boolean | undefined;
+        triggerPath?: string | undefined;
+        labelSource?: "label" | "placeholder" | "empty-display" | undefined;
+        panelVisible?: boolean | undefined;
+        committedText?: string | undefined;
+        queryText?: string | undefined;
+        optionText?: string | undefined;
+        optionLabel?: string | undefined;
+        optionPath?: string | undefined;
+        optionSelected?: boolean | undefined;
+    } | undefined;
+    htmlId?: string | undefined;
+    controlsIds?: string[] | undefined;
+    ancestorIds?: string[] | undefined;
+    ownerPaths?: string[] | undefined;
+    ancestorPaths?: string[] | undefined;
+    position?: {
+        left: number;
+        top: number;
+    } | undefined;
+    scrollContainerPaths?: string[] | undefined;
+    revealViaScroll?: boolean | undefined;
+    labelledByIds?: string[] | undefined;
+    fieldLabel?: string | undefined;
+    peerGroup?: {
+        count: number;
+        key: string;
+        position: number;
+    } | undefined;
+    validationErrors?: string[] | undefined;
+    requiredSource?: "html" | "aria" | "label-required" | "label-optional" | undefined;
+    constraints?: {
+        multiple?: boolean | undefined;
+        pattern?: string | undefined;
+        min?: string | undefined;
+        max?: string | undefined;
+        step?: string | undefined;
+        minlength?: string | undefined;
+        maxlength?: string | undefined;
+    } | undefined;
+    inputType?: string | undefined;
+    observedValue?: string | undefined;
+    actionValue?: string | undefined;
+    displayText?: string | undefined;
+    observedName?: string | undefined;
+    layer?: string | undefined;
+    layerKey?: string | undefined;
+    modal?: boolean | undefined;
+    nativeSelect?: boolean | undefined;
+    optionsTruncated?: boolean | undefined;
+}, {
+    availability: "hidden" | "ready" | "offscreen" | "covered" | "unavailable";
+    options?: {
+        value: string;
+        label: string;
+        disabled: boolean;
+        selected: boolean;
+    }[] | undefined;
+    context?: string[] | undefined;
+    editable?: boolean | undefined;
+    checked?: boolean | "mixed" | undefined;
+    expanded?: boolean | undefined;
+    required?: boolean | undefined;
+    readable?: boolean | undefined;
+    domSemantics?: {
+        role: string;
+        disabled: boolean;
+        tag: string;
+        readOnly: boolean;
+    } | undefined;
+    picker?: {
+        selection: "value" | "unknown" | "empty";
+        part: "option" | "trigger";
+        relationship: "unknown" | "aria" | "local-dom";
+        panelPaths: string[];
+        selectionEvidence: "unknown" | "native-select" | "backing-input";
+        label?: string | undefined;
+        expanded?: boolean | undefined;
+        triggerPath?: string | undefined;
+        labelSource?: "label" | "placeholder" | "empty-display" | undefined;
+        panelVisible?: boolean | undefined;
+        committedText?: string | undefined;
+        queryText?: string | undefined;
+        optionText?: string | undefined;
+        optionLabel?: string | undefined;
+        optionPath?: string | undefined;
+        optionSelected?: boolean | undefined;
+    } | undefined;
+    htmlId?: string | undefined;
+    controlsIds?: string[] | undefined;
+    ancestorIds?: string[] | undefined;
+    ownerPaths?: string[] | undefined;
+    ancestorPaths?: string[] | undefined;
+    position?: {
+        left: number;
+        top: number;
+    } | undefined;
+    scrollContainerPaths?: string[] | undefined;
+    revealViaScroll?: boolean | undefined;
+    labelledByIds?: string[] | undefined;
+    fieldLabel?: string | undefined;
+    peerGroup?: {
+        count: number;
+        key: string;
+        position: number;
+    } | undefined;
+    validationErrors?: string[] | undefined;
+    requiredSource?: "html" | "aria" | "label-required" | "label-optional" | undefined;
+    constraints?: {
+        multiple?: boolean | undefined;
+        pattern?: string | undefined;
+        min?: string | undefined;
+        max?: string | undefined;
+        step?: string | undefined;
+        minlength?: string | undefined;
+        maxlength?: string | undefined;
+    } | undefined;
+    inputType?: string | undefined;
+    observedValue?: string | undefined;
+    actionValue?: string | undefined;
+    displayText?: string | undefined;
+    observedName?: string | undefined;
+    layer?: string | undefined;
+    layerKey?: string | undefined;
+    modal?: boolean | undefined;
+    nativeSelect?: boolean | undefined;
+    optionsTruncated?: boolean | undefined;
+}>;
+export type GoalControl = z.infer<typeof GoalControlSchema>;
+export declare const GoalDependencyControlSchema: z.ZodObject<{
+    ref: z.ZodObject<{
+        ref: z.ZodString;
+        backendNodeId: z.ZodOptional<z.ZodNumber>;
+        frameId: z.ZodOptional<z.ZodString>;
+        role: z.ZodString;
+        name: z.ZodString;
+        nth: z.ZodNumber;
+        disabled: z.ZodBoolean;
+        context: z.ZodOptional<z.ZodObject<{
+            form: z.ZodOptional<z.ZodString>;
+            dialog: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            form?: string | undefined;
+            dialog?: string | undefined;
+            label?: string | undefined;
+        }, {
+            form?: string | undefined;
+            dialog?: string | undefined;
+            label?: string | undefined;
+        }>>;
+        locator: z.ZodOptional<z.ZodObject<{
+            css: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            scope: z.ZodOptional<z.ZodString>;
+            unique: z.ZodLiteral<true>;
+        }, "strip", z.ZodTypeAny, {
+            unique: true;
+            css?: string | undefined;
+            role?: string | undefined;
+            name?: string | undefined;
+            scope?: string | undefined;
+        }, {
+            unique: true;
+            css?: string | undefined;
+            role?: string | undefined;
+            name?: string | undefined;
+            scope?: string | undefined;
+        }>>;
+        strict: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        role: string;
+        name: string;
+        ref: string;
+        nth: number;
+        disabled: boolean;
+        backendNodeId?: number | undefined;
+        frameId?: string | undefined;
+        context?: {
+            form?: string | undefined;
+            dialog?: string | undefined;
+            label?: string | undefined;
+        } | undefined;
+        locator?: {
+            unique: true;
+            css?: string | undefined;
+            role?: string | undefined;
+            name?: string | undefined;
+            scope?: string | undefined;
+        } | undefined;
+        strict?: boolean | undefined;
+    }, {
+        role: string;
+        name: string;
+        ref: string;
+        nth: number;
+        disabled: boolean;
+        backendNodeId?: number | undefined;
+        frameId?: string | undefined;
+        context?: {
+            form?: string | undefined;
+            dialog?: string | undefined;
+            label?: string | undefined;
+        } | undefined;
+        locator?: {
+            unique: true;
+            css?: string | undefined;
+            role?: string | undefined;
+            name?: string | undefined;
+            scope?: string | undefined;
+        } | undefined;
+        strict?: boolean | undefined;
+    }>;
+    control: z.ZodObject<{
+        availability: z.ZodEnum<["ready", "offscreen", "covered", "hidden", "unavailable"]>;
+        editable: z.ZodDefault<z.ZodBoolean>;
+        /** Fresh applied DOM readback can remain readable while pointer input is covered. */
+        readable: z.ZodOptional<z.ZodBoolean>;
+        domSemantics: z.ZodOptional<z.ZodObject<{
+            tag: z.ZodString;
+            role: z.ZodString;
+            disabled: z.ZodBoolean;
+            readOnly: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            role: string;
+            disabled: boolean;
+            tag: string;
+            readOnly: boolean;
+        }, {
+            role: string;
+            disabled: boolean;
+            tag: string;
+            readOnly: boolean;
+        }>>;
+        expanded: z.ZodOptional<z.ZodBoolean>;
+        picker: z.ZodOptional<z.ZodObject<{
+            part: z.ZodEnum<["trigger", "option"]>;
+            relationship: z.ZodEnum<["aria", "local-dom", "unknown"]>;
+            triggerPath: z.ZodOptional<z.ZodString>;
+            panelPaths: z.ZodArray<z.ZodString, "many">;
+            label: z.ZodOptional<z.ZodString>;
+            labelSource: z.ZodOptional<z.ZodEnum<["label", "placeholder", "empty-display"]>>;
+            expanded: z.ZodOptional<z.ZodBoolean>;
+            panelVisible: z.ZodOptional<z.ZodBoolean>;
+            selection: z.ZodEnum<["empty", "value", "unknown"]>;
+            selectionEvidence: z.ZodEnum<["native-select", "backing-input", "unknown"]>;
+            committedText: z.ZodOptional<z.ZodString>;
+            queryText: z.ZodOptional<z.ZodString>;
+            optionText: z.ZodOptional<z.ZodString>;
+            optionLabel: z.ZodOptional<z.ZodString>;
+            optionPath: z.ZodOptional<z.ZodString>;
+            optionSelected: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            selection: "value" | "unknown" | "empty";
+            part: "option" | "trigger";
+            relationship: "unknown" | "aria" | "local-dom";
+            panelPaths: string[];
+            selectionEvidence: "unknown" | "native-select" | "backing-input";
+            label?: string | undefined;
+            expanded?: boolean | undefined;
+            triggerPath?: string | undefined;
+            labelSource?: "label" | "placeholder" | "empty-display" | undefined;
+            panelVisible?: boolean | undefined;
+            committedText?: string | undefined;
+            queryText?: string | undefined;
+            optionText?: string | undefined;
+            optionLabel?: string | undefined;
+            optionPath?: string | undefined;
+            optionSelected?: boolean | undefined;
+        }, {
+            selection: "value" | "unknown" | "empty";
+            part: "option" | "trigger";
+            relationship: "unknown" | "aria" | "local-dom";
+            panelPaths: string[];
+            selectionEvidence: "unknown" | "native-select" | "backing-input";
+            label?: string | undefined;
+            expanded?: boolean | undefined;
+            triggerPath?: string | undefined;
+            labelSource?: "label" | "placeholder" | "empty-display" | undefined;
+            panelVisible?: boolean | undefined;
+            committedText?: string | undefined;
+            queryText?: string | undefined;
+            optionText?: string | undefined;
+            optionLabel?: string | undefined;
+            optionPath?: string | undefined;
+            optionSelected?: boolean | undefined;
+        }>>;
+        htmlId: z.ZodOptional<z.ZodString>;
+        controlsIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        ancestorIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        ownerPaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        ancestorPaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        position: z.ZodOptional<z.ZodObject<{
+            top: z.ZodNumber;
+            left: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            left: number;
+            top: number;
+        }, {
+            left: number;
+            top: number;
+        }>>;
+        /** Nearest-first scrollable ancestor paths, including same-origin parent frames. */
+        scrollContainerPaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** An edge overlay requires explicit scroll; native visibility reveal alone is insufficient. */
+        revealViaScroll: z.ZodOptional<z.ZodBoolean>;
+        labelledByIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        fieldLabel: z.ZodOptional<z.ZodString>;
+        peerGroup: z.ZodOptional<z.ZodObject<{
+            key: z.ZodString;
+            position: z.ZodNumber;
+            count: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            count: number;
+            key: string;
+            position: number;
+        }, {
+            count: number;
+            key: string;
+            position: number;
+        }>>;
+        validationErrors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        requiredSource: z.ZodOptional<z.ZodEnum<["html", "aria", "label-required", "label-optional"]>>;
+        constraints: z.ZodOptional<z.ZodObject<{
+            min: z.ZodOptional<z.ZodString>;
+            max: z.ZodOptional<z.ZodString>;
+            step: z.ZodOptional<z.ZodString>;
+            minlength: z.ZodOptional<z.ZodString>;
+            maxlength: z.ZodOptional<z.ZodString>;
+            pattern: z.ZodOptional<z.ZodString>;
+            multiple: z.ZodOptional<z.ZodBoolean>;
+        }, "strict", z.ZodTypeAny, {
+            multiple?: boolean | undefined;
+            pattern?: string | undefined;
+            min?: string | undefined;
+            max?: string | undefined;
+            step?: string | undefined;
+            minlength?: string | undefined;
+            maxlength?: string | undefined;
+        }, {
+            multiple?: boolean | undefined;
+            pattern?: string | undefined;
+            min?: string | undefined;
+            max?: string | undefined;
+            step?: string | undefined;
+            minlength?: string | undefined;
+            maxlength?: string | undefined;
+        }>>;
+        inputType: z.ZodOptional<z.ZodString>;
+        observedValue: z.ZodOptional<z.ZodString>;
+        actionValue: z.ZodOptional<z.ZodString>;
+        displayText: z.ZodOptional<z.ZodString>;
+        observedName: z.ZodOptional<z.ZodString>;
+        context: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        layer: z.ZodOptional<z.ZodString>;
+        layerKey: z.ZodOptional<z.ZodString>;
+        modal: z.ZodOptional<z.ZodBoolean>;
+        checked: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodLiteral<"mixed">]>>;
+        nativeSelect: z.ZodOptional<z.ZodBoolean>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodString;
+            selected: z.ZodBoolean;
+            disabled: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            label: string;
+            disabled: boolean;
+            selected: boolean;
+        }, {
+            value: string;
+            label: string;
+            disabled: boolean;
+            selected: boolean;
+        }>, "many">>;
+        optionsTruncated: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        context: string[];
+        editable: boolean;
+        availability: "hidden" | "ready" | "offscreen" | "covered" | "unavailable";
+        options?: {
+            value: string;
+            label: string;
+            disabled: boolean;
+            selected: boolean;
+        }[] | undefined;
+        checked?: boolean | "mixed" | undefined;
+        expanded?: boolean | undefined;
+        required?: boolean | undefined;
+        readable?: boolean | undefined;
+        domSemantics?: {
+            role: string;
+            disabled: boolean;
+            tag: string;
+            readOnly: boolean;
+        } | undefined;
+        picker?: {
+            selection: "value" | "unknown" | "empty";
+            part: "option" | "trigger";
+            relationship: "unknown" | "aria" | "local-dom";
+            panelPaths: string[];
+            selectionEvidence: "unknown" | "native-select" | "backing-input";
+            label?: string | undefined;
+            expanded?: boolean | undefined;
+            triggerPath?: string | undefined;
+            labelSource?: "label" | "placeholder" | "empty-display" | undefined;
+            panelVisible?: boolean | undefined;
+            committedText?: string | undefined;
+            queryText?: string | undefined;
+            optionText?: string | undefined;
+            optionLabel?: string | undefined;
+            optionPath?: string | undefined;
+            optionSelected?: boolean | undefined;
+        } | undefined;
+        htmlId?: string | undefined;
+        controlsIds?: string[] | undefined;
+        ancestorIds?: string[] | undefined;
+        ownerPaths?: string[] | undefined;
+        ancestorPaths?: string[] | undefined;
+        position?: {
+            left: number;
+            top: number;
+        } | undefined;
+        scrollContainerPaths?: string[] | undefined;
+        revealViaScroll?: boolean | undefined;
+        labelledByIds?: string[] | undefined;
+        fieldLabel?: string | undefined;
+        peerGroup?: {
+            count: number;
+            key: string;
+            position: number;
+        } | undefined;
+        validationErrors?: string[] | undefined;
+        requiredSource?: "html" | "aria" | "label-required" | "label-optional" | undefined;
+        constraints?: {
+            multiple?: boolean | undefined;
+            pattern?: string | undefined;
+            min?: string | undefined;
+            max?: string | undefined;
+            step?: string | undefined;
+            minlength?: string | undefined;
+            maxlength?: string | undefined;
+        } | undefined;
+        inputType?: string | undefined;
+        observedValue?: string | undefined;
+        actionValue?: string | undefined;
+        displayText?: string | undefined;
+        observedName?: string | undefined;
+        layer?: string | undefined;
+        layerKey?: string | undefined;
+        modal?: boolean | undefined;
+        nativeSelect?: boolean | undefined;
+        optionsTruncated?: boolean | undefined;
+    }, {
+        availability: "hidden" | "ready" | "offscreen" | "covered" | "unavailable";
+        options?: {
+            value: string;
+            label: string;
+            disabled: boolean;
+            selected: boolean;
+        }[] | undefined;
+        context?: string[] | undefined;
+        editable?: boolean | undefined;
+        checked?: boolean | "mixed" | undefined;
+        expanded?: boolean | undefined;
+        required?: boolean | undefined;
+        readable?: boolean | undefined;
+        domSemantics?: {
+            role: string;
+            disabled: boolean;
+            tag: string;
+            readOnly: boolean;
+        } | undefined;
+        picker?: {
+            selection: "value" | "unknown" | "empty";
+            part: "option" | "trigger";
+            relationship: "unknown" | "aria" | "local-dom";
+            panelPaths: string[];
+            selectionEvidence: "unknown" | "native-select" | "backing-input";
+            label?: string | undefined;
+            expanded?: boolean | undefined;
+            triggerPath?: string | undefined;
+            labelSource?: "label" | "placeholder" | "empty-display" | undefined;
+            panelVisible?: boolean | undefined;
+            committedText?: string | undefined;
+            queryText?: string | undefined;
+            optionText?: string | undefined;
+            optionLabel?: string | undefined;
+            optionPath?: string | undefined;
+            optionSelected?: boolean | undefined;
+        } | undefined;
+        htmlId?: string | undefined;
+        controlsIds?: string[] | undefined;
+        ancestorIds?: string[] | undefined;
+        ownerPaths?: string[] | undefined;
+        ancestorPaths?: string[] | undefined;
+        position?: {
+            left: number;
+            top: number;
+        } | undefined;
+        scrollContainerPaths?: string[] | undefined;
+        revealViaScroll?: boolean | undefined;
+        labelledByIds?: string[] | undefined;
+        fieldLabel?: string | undefined;
+        peerGroup?: {
+            count: number;
+            key: string;
+            position: number;
+        } | undefined;
+        validationErrors?: string[] | undefined;
+        requiredSource?: "html" | "aria" | "label-required" | "label-optional" | undefined;
+        constraints?: {
+            multiple?: boolean | undefined;
+            pattern?: string | undefined;
+            min?: string | undefined;
+            max?: string | undefined;
+            step?: string | undefined;
+            minlength?: string | undefined;
+            maxlength?: string | undefined;
+        } | undefined;
+        inputType?: string | undefined;
+        observedValue?: string | undefined;
+        actionValue?: string | undefined;
+        displayText?: string | undefined;
+        observedName?: string | undefined;
+        layer?: string | undefined;
+        layerKey?: string | undefined;
+        modal?: boolean | undefined;
+        nativeSelect?: boolean | undefined;
+        optionsTruncated?: boolean | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    ref: {
+        role: string;
+        name: string;
+        ref: string;
+        nth: number;
+        disabled: boolean;
+        backendNodeId?: number | undefined;
+        frameId?: string | undefined;
+        context?: {
+            form?: string | undefined;
+            dialog?: string | undefined;
+            label?: string | undefined;
+        } | undefined;
+        locator?: {
+            unique: true;
+            css?: string | undefined;
+            role?: string | undefined;
+            name?: string | undefined;
+            scope?: string | undefined;
+        } | undefined;
+        strict?: boolean | undefined;
+    };
+    control: {
+        context: string[];
+        editable: boolean;
+        availability: "hidden" | "ready" | "offscreen" | "covered" | "unavailable";
+        options?: {
+            value: string;
+            label: string;
+            disabled: boolean;
+            selected: boolean;
+        }[] | undefined;
+        checked?: boolean | "mixed" | undefined;
+        expanded?: boolean | undefined;
+        required?: boolean | undefined;
+        readable?: boolean | undefined;
+        domSemantics?: {
+            role: string;
+            disabled: boolean;
+            tag: string;
+            readOnly: boolean;
+        } | undefined;
+        picker?: {
+            selection: "value" | "unknown" | "empty";
+            part: "option" | "trigger";
+            relationship: "unknown" | "aria" | "local-dom";
+            panelPaths: string[];
+            selectionEvidence: "unknown" | "native-select" | "backing-input";
+            label?: string | undefined;
+            expanded?: boolean | undefined;
+            triggerPath?: string | undefined;
+            labelSource?: "label" | "placeholder" | "empty-display" | undefined;
+            panelVisible?: boolean | undefined;
+            committedText?: string | undefined;
+            queryText?: string | undefined;
+            optionText?: string | undefined;
+            optionLabel?: string | undefined;
+            optionPath?: string | undefined;
+            optionSelected?: boolean | undefined;
+        } | undefined;
+        htmlId?: string | undefined;
+        controlsIds?: string[] | undefined;
+        ancestorIds?: string[] | undefined;
+        ownerPaths?: string[] | undefined;
+        ancestorPaths?: string[] | undefined;
+        position?: {
+            left: number;
+            top: number;
+        } | undefined;
+        scrollContainerPaths?: string[] | undefined;
+        revealViaScroll?: boolean | undefined;
+        labelledByIds?: string[] | undefined;
+        fieldLabel?: string | undefined;
+        peerGroup?: {
+            count: number;
+            key: string;
+            position: number;
+        } | undefined;
+        validationErrors?: string[] | undefined;
+        requiredSource?: "html" | "aria" | "label-required" | "label-optional" | undefined;
+        constraints?: {
+            multiple?: boolean | undefined;
+            pattern?: string | undefined;
+            min?: string | undefined;
+            max?: string | undefined;
+            step?: string | undefined;
+            minlength?: string | undefined;
+            maxlength?: string | undefined;
+        } | undefined;
+        inputType?: string | undefined;
+        observedValue?: string | undefined;
+        actionValue?: string | undefined;
+        displayText?: string | undefined;
+        observedName?: string | undefined;
+        layer?: string | undefined;
+        layerKey?: string | undefined;
+        modal?: boolean | undefined;
+        nativeSelect?: boolean | undefined;
+        optionsTruncated?: boolean | undefined;
+    };
+}, {
+    ref: {
+        role: string;
+        name: string;
+        ref: string;
+        nth: number;
+        disabled: boolean;
+        backendNodeId?: number | undefined;
+        frameId?: string | undefined;
+        context?: {
+            form?: string | undefined;
+            dialog?: string | undefined;
+            label?: string | undefined;
+        } | undefined;
+        locator?: {
+            unique: true;
+            css?: string | undefined;
+            role?: string | undefined;
+            name?: string | undefined;
+            scope?: string | undefined;
+        } | undefined;
+        strict?: boolean | undefined;
+    };
+    control: {
+        availability: "hidden" | "ready" | "offscreen" | "covered" | "unavailable";
+        options?: {
+            value: string;
+            label: string;
+            disabled: boolean;
+            selected: boolean;
+        }[] | undefined;
+        context?: string[] | undefined;
+        editable?: boolean | undefined;
+        checked?: boolean | "mixed" | undefined;
+        expanded?: boolean | undefined;
+        required?: boolean | undefined;
+        readable?: boolean | undefined;
+        domSemantics?: {
+            role: string;
+            disabled: boolean;
+            tag: string;
+            readOnly: boolean;
+        } | undefined;
+        picker?: {
+            selection: "value" | "unknown" | "empty";
+            part: "option" | "trigger";
+            relationship: "unknown" | "aria" | "local-dom";
+            panelPaths: string[];
+            selectionEvidence: "unknown" | "native-select" | "backing-input";
+            label?: string | undefined;
+            expanded?: boolean | undefined;
+            triggerPath?: string | undefined;
+            labelSource?: "label" | "placeholder" | "empty-display" | undefined;
+            panelVisible?: boolean | undefined;
+            committedText?: string | undefined;
+            queryText?: string | undefined;
+            optionText?: string | undefined;
+            optionLabel?: string | undefined;
+            optionPath?: string | undefined;
+            optionSelected?: boolean | undefined;
+        } | undefined;
+        htmlId?: string | undefined;
+        controlsIds?: string[] | undefined;
+        ancestorIds?: string[] | undefined;
+        ownerPaths?: string[] | undefined;
+        ancestorPaths?: string[] | undefined;
+        position?: {
+            left: number;
+            top: number;
+        } | undefined;
+        scrollContainerPaths?: string[] | undefined;
+        revealViaScroll?: boolean | undefined;
+        labelledByIds?: string[] | undefined;
+        fieldLabel?: string | undefined;
+        peerGroup?: {
+            count: number;
+            key: string;
+            position: number;
+        } | undefined;
+        validationErrors?: string[] | undefined;
+        requiredSource?: "html" | "aria" | "label-required" | "label-optional" | undefined;
+        constraints?: {
+            multiple?: boolean | undefined;
+            pattern?: string | undefined;
+            min?: string | undefined;
+            max?: string | undefined;
+            step?: string | undefined;
+            minlength?: string | undefined;
+            maxlength?: string | undefined;
+        } | undefined;
+        inputType?: string | undefined;
+        observedValue?: string | undefined;
+        actionValue?: string | undefined;
+        displayText?: string | undefined;
+        observedName?: string | undefined;
+        layer?: string | undefined;
+        layerKey?: string | undefined;
+        modal?: boolean | undefined;
+        nativeSelect?: boolean | undefined;
+        optionsTruncated?: boolean | undefined;
+    };
+}>;
+export type GoalDependencyControl = z.infer<typeof GoalDependencyControlSchema>;
+export declare const GoalPageStateSchema: z.ZodObject<{
+    panels: z.ZodArray<z.ZodString, "many">;
+    selectedTabs: z.ZodArray<z.ZodString, "many">;
+    busy: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    panels: string[];
+    selectedTabs: string[];
+    busy: boolean;
+}, {
+    panels: string[];
+    selectedTabs: string[];
+    busy: boolean;
+}>;
+export type GoalSnapshot = BrowserAxSnapshot & {
+    readDocuments?: ReadDocument[];
+    pageState?: z.infer<typeof GoalPageStateSchema>;
+    /** Fresh read-only evidence for modal-hidden dependencies; never actionable refs. */
+    dependencyControls?: Record<string, GoalDependencyControl>;
+    controls?: Record<string, GoalControl>;
+    pageText?: string;
+    pageTextTruncated?: boolean;
+};
+export declare const INSPECT_GOAL_CONTROL = "function(origins) {\n  const el=this, doc=el.ownerDocument, view=doc && doc.defaultView;\n  if (!doc || !view || !origins.includes(view.location.origin)) return {availability:'unavailable'};\n  if (el.nodeType!==1 || !el.isConnected) return {availability:'unavailable'};\n  const r=el.getBoundingClientRect(), style=view.getComputedStyle(el);\n  if (!r.width || !r.height || style.display==='none' || style.visibility!=='visible' || style.opacity==='0' || el.closest('[inert]')) return {availability:'hidden'};\n  const {availability,revealViaScroll}=(function(el,origins) {\n  let revealViaScroll=false;\n  const result=(availability)=>({availability,...(availability==='offscreen' && revealViaScroll?{revealViaScroll:true}:{})});\n  const transformed=s=>s.transform!=='none' || s.perspective!=='none' || (s.translate && s.translate!=='none') || (s.rotate && s.rotate!=='none') || (s.scale && s.scale!=='none') || (s.zoom && s.zoom!=='normal' && Number(s.zoom)!==1);\n  const layer=(node,view)=>{for(let p=node;p;p=p.parentElement){if(p.matches('dialog[open],[role=\"dialog\"],[aria-modal=\"true\"]'))return p;const s=view.getComputedStyle(p);if(s.position==='fixed' || s.position==='sticky')return p;}return null;};\n  const modal=node=>node && (node.matches('dialog[open],[role=\"dialog\"],[aria-modal=\"true\"]') || Boolean(node.closest('dialog[open],[role=\"dialog\"],[aria-modal=\"true\"]')));\n  const edgeLayer=(cover,ownLayer,view)=>{\n    if(!cover || cover===ownLayer || modal(cover))return false;\n    const cr=cover.getBoundingClientRect();\n    return (cr.height<view.innerHeight/2 && (cr.top<=1 || cr.bottom>=view.innerHeight-1)) || (cr.width<view.innerWidth/2 && (cr.left<=1 || cr.right>=view.innerWidth-1));\n  };\n  const bounds=(node)=>{const r=node.getBoundingClientRect();return {left:r.left+node.clientLeft,top:r.top+node.clientTop,right:r.left+node.clientLeft+node.clientWidth,bottom:r.top+node.clientTop+node.clientHeight};};\n  const room=(node,axis,direction)=>{const offset=axis==='x'?node.scrollLeft:node.scrollTop,max=axis==='x'?node.scrollWidth-node.clientWidth:node.scrollHeight-node.clientHeight;return direction<0?offset>1:offset<max-1;};\n  try {\n    let view=el.ownerDocument.defaultView,node=el;\n    if(!view || !origins.includes(view.location.origin))return result('unavailable');\n    const r=el.getBoundingClientRect();let point={x:r.left+r.width/2,y:r.top+r.height/2},reveal=false;\n    for(let depth=0;depth<33;depth++){\n      if(depth===32 || !origins.includes(view.location.origin))return result('unavailable');\n      const doc=node.ownerDocument,root=doc.scrollingElement,ownLayer=layer(node,view);\n      const activeModal=[...doc.querySelectorAll('dialog[open],[aria-modal=\"true\"]')].find(p=>{const s=view.getComputedStyle(p);return p.getClientRects().length && s.display!=='none' && s.visibility==='visible' && s.opacity!=='0' && !p.contains(node);});\n      if(activeModal)return result('covered');\n      const viewport={left:0,top:0,right:view.innerWidth,bottom:view.innerHeight};\n      let scope=node,visible={...viewport},localReveal=false;\n      const movable=[];\n      for(let p=node;p;p=p.parentElement){\n        const s=view.getComputedStyle(p);\n        if(transformed(s))return result('unavailable');\n        if(s.display==='none' || s.visibility!=='visible' || s.opacity==='0' || p.hasAttribute('inert'))return result('covered');\n        if(p===node || p===root || p===doc.body)continue;\n        const b=bounds(p);\n        const axes=[['x','overflowX','left','right'],['y','overflowY','top','bottom']];\n        for(const [axis,overflow,low,high] of axes){\n          if(!/^(auto|scroll|hidden|clip)$/.test(s[overflow]))continue;\n          const scrollable=/^(auto|scroll)$/.test(s[overflow]);\n          if(scrollable)movable.push({node:p,axis,b});\n          if(point[axis]<b[low] || point[axis]>=b[high]){\n            if(!scrollable || !room(p,axis,point[axis]<b[low]?-1:1))return result('covered');\n            point[axis]=Math.max(b[low]+1,Math.min(b[high]-2,point[axis]));scope=p;localReveal=true;visible={left:Math.max(0,b.left),top:Math.max(0,b.top),right:Math.min(view.innerWidth,b.right),bottom:Math.min(view.innerHeight,b.bottom)};\n          }\n          visible[low]=Math.max(visible[low],b[low]);visible[high]=Math.min(visible[high],b[high]);\n        }\n      }\n      const rootStyle=root && view.getComputedStyle(root),bodyStyle=doc.body && view.getComputedStyle(doc.body);\n      for(const [axis,overflow,low,high] of [['x','overflowX','left','right'],['y','overflowY','top','bottom']]){\n        const scrollable=root && !ownLayer && ![rootStyle?.[overflow],bodyStyle?.[overflow]].some(value=>value==='hidden' || value==='clip');\n        if(scrollable)movable.push({node:root,axis,b:viewport});\n        if(point[axis]<viewport[low] || point[axis]>=viewport[high]){\n          if(!scrollable || !room(root,axis,point[axis]<viewport[low]?-1:1))return result('covered');\n          point[axis]=Math.max(viewport[low]+1,Math.min(viewport[high]-2,point[axis]));scope=root;localReveal=true;visible={...viewport};\n        }\n      }\n      const same=(hit)=>hit && (hit===node || node.contains(hit));\n      const exposed=(hit,container)=>{\n        if(!hit || !(hit===container || container.contains(hit)))return false;\n        const hitLayer=layer(hit,view);\n        return !hitLayer || hitLayer===ownLayer;\n      };\n      const sample=(container,region)=>{\n        if(region.right-region.left<4 || region.bottom-region.top<4)return null;\n        for(const fy of [0.5,0.25,0.75,0.05,0.95])for(const fx of [0.5,0.25,0.75,0.05,0.95]){\n          const p={x:region.left+(region.right-region.left)*fx,y:region.top+(region.bottom-region.top)*fy};\n          if(exposed(doc.elementFromPoint(p.x,p.y),container))return p;\n        }\n        return null;\n      };\n      const hit=doc.elementFromPoint(point.x,point.y);\n      if(localReveal){\n        if(!exposed(hit,scope)){\n          if(!edgeLayer(hit && layer(hit,view),ownLayer,view))return result('covered');\n          revealViaScroll=true;\n        }\n        const probe=exposed(hit,scope)?point:sample(scope,visible);\n        if(!probe)return result('covered');point=probe;reveal=true;\n      }else if(!same(hit)){\n        // A small edge-docked fixed/sticky toolbar may cover a scrollable target.\n        // Dialogs, central overlays and full-screen layers are never reveal routes.\n        const cover=hit && layer(hit,view),cr=cover && cover.getBoundingClientRect();\n        if(!edgeLayer(cover,ownLayer,view))return result('covered');\n        let probe=null;\n        for(const candidate of movable){\n          const axis=candidate.axis,coordinate=axis==='x'?point.x:point.y;\n          const start=axis==='x'?cr.left:cr.top,end=axis==='x'?cr.right:cr.bottom;\n          if(coordinate<start || coordinate>=end)continue;\n          const towardStart=start>=(axis==='x'?view.innerWidth:view.innerHeight)/2;\n          if(!room(candidate.node,axis,towardStart?1:-1))continue;\n          const region={left:Math.max(visible.left,candidate.b.left),top:Math.max(visible.top,candidate.b.top),right:Math.min(visible.right,candidate.b.right),bottom:Math.min(visible.bottom,candidate.b.bottom)};\n          if(axis==='y'){if(towardStart)region.bottom=Math.min(region.bottom,cr.top);else region.top=Math.max(region.top,cr.bottom);}\n          else if(towardStart)region.right=Math.min(region.right,cr.left);else region.left=Math.max(region.left,cr.right);\n          probe=sample(candidate.node,region);if(probe)break;\n        }\n        if(!probe)return result('covered');point=probe;reveal=true;revealViaScroll=true;\n      }\n      if(view===view.top)return result(reveal?'offscreen':'ready');\n      const owner=view.frameElement,parent=owner?.ownerDocument.defaultView;\n      if(!owner || !parent || !origins.includes(parent.location.origin))return result('unavailable');\n      const box=owner.getBoundingClientRect();point={x:point.x+box.left+owner.clientLeft,y:point.y+box.top+owner.clientTop};\n      node=owner;view=parent;\n    }\n  }catch{return result('unavailable');}\n  return result('unavailable');\n})(el,origins);\n  if(availability==='unavailable')return {availability};\n  let frameView=view,projectedTop=r.top,projectedLeft=r.left;\n  for(let depth=0;frameView!==frameView.top;depth++){\n    if(depth>=32)return {availability:'unavailable'};\n    const owner=frameView.frameElement,parent=owner && owner.ownerDocument.defaultView;\n    if(!owner || !parent || !origins.includes(parent.location.origin))return {availability:'unavailable'};\n    const box=owner.getBoundingClientRect();\n    projectedLeft+=box.left+owner.clientLeft;projectedTop+=box.top+owner.clientTop;frameView=parent;\n  }\n  const position={top:projectedTop+frameView.scrollY,left:projectedLeft+frameView.scrollX};\n  const documentPath=node=>{\n    const parts=[];\n    for(let p=node,depth=0;p && p.nodeType===1; p=p.parentElement,depth++){\n      if(depth>=64)return undefined;\n      let ordinal=1;for(let sibling=p.previousElementSibling;sibling;sibling=sibling.previousElementSibling)if(sibling.tagName===p.tagName)ordinal++;\n      parts.unshift(p.tagName.toLowerCase()+'['+ordinal+']');\n    }\n    return '/'+parts.join('/');\n  };\n  const framePaths=[];let pathView=view,pathComplete=true;\n  for(let depth=0;pathView!==pathView.top;depth++){\n    if(depth>=32){pathComplete=false;break;}\n    const owner=pathView.frameElement, parent=owner && owner.ownerDocument.defaultView;\n    if(!owner || !parent || !origins.includes(parent.location.origin)){pathComplete=false;break;}\n    const path=documentPath(owner);if(!path){pathComplete=false;break;}\n    framePaths.unshift(path);pathView=parent;\n  }\n  const pathFor=node=>{const path=documentPath(node);return pathComplete && path ? [...framePaths,path].join('!') : undefined;};\n  const scrollContainerPaths=[];\n  const scrollPath=node=>{\n    const own=documentPath(node);if(!own)return undefined;\n    const paths=[own];let v=node.ownerDocument.defaultView;\n    for(let depth=0;v && v!==v.top;depth++){\n      if(depth>=32)return undefined;\n      const owner=v.frameElement,parent=owner && owner.ownerDocument.defaultView;\n      if(!owner || !parent || !origins.includes(parent.location.origin))return undefined;\n      const path=documentPath(owner);if(!path)return undefined;\n      paths.unshift(path);v=parent;\n    }\n    return paths.join('!');\n  };\n  let scrollNode=el,scrollView=view;\n  for(let depth=0;depth<32;depth++){\n    const root=scrollNode.ownerDocument.scrollingElement;let fixed=false;\n    for(let p=scrollNode;p;p=p.parentElement){\n      const s=scrollView.getComputedStyle(p);\n      if(s.position==='fixed')fixed=true;\n      const rootNode=p===root,body=scrollNode.ownerDocument.body,bs=body && scrollView.getComputedStyle(body);\n      const axis=(overflow,size,client)=>p[size]>p[client]+1 && (rootNode?!fixed && ![s[overflow],bs?.[overflow]].some(v=>v==='hidden'||v==='clip'):/^(auto|scroll)$/.test(s[overflow]));\n      if(axis('overflowX','scrollWidth','clientWidth') || axis('overflowY','scrollHeight','clientHeight')){\n        const path=scrollPath(p);if(path && !scrollContainerPaths.includes(path))scrollContainerPaths.push(path);\n      }\n    }\n    if(scrollView===scrollView.top)break;\n    const owner=scrollView.frameElement,parent=owner && owner.ownerDocument.defaultView;\n    if(!owner || !parent || !origins.includes(parent.location.origin))break;\n    scrollNode=owner;scrollView=parent;\n  }\n  const fixedLayer=node=>{for(let p=node;p && p!==doc.body;p=p.parentElement){if(p.matches('dialog[open],[role=\"dialog\"],[aria-modal=\"true\"]'))return p;const s=view.getComputedStyle(p);if(s.position==='fixed' && Number(s.zIndex)>0)return p;}return null;};\n  const ownLayer=fixedLayer(el);\n  const nativeFieldSelector='input:not([type=\"hidden\"]):not([type=\"button\"]):not([type=\"submit\"]):not([type=\"reset\"]),textarea,select,[role=\"textbox\"],[role=\"combobox\"],[role=\"spinbutton\"]';\n  const fieldCandidateSelector=nativeFieldSelector+',[tabindex],[aria-haspopup],button,[role=\"button\"]';\n  const isField=node=>{\n    if(node.matches(nativeFieldSelector))return true;\n    if(node.tabIndex<0)return false;\n    const popup=node.getAttribute('aria-haspopup');\n    const controlled=(node.getAttribute('aria-controls')||'').trim().split(/\\s+/).filter(Boolean).map(id=>doc.getElementById(id));\n    const picker=Boolean(popup && popup!=='false') || controlled.some(panel=>panel && panel.matches('[role=\"listbox\"],[role=\"tree\"],[role=\"grid\"]'));\n    return picker || Boolean(node.querySelector('input[type=\"hidden\"]'));\n  };\n  const fieldsWithin=node=>[...node.querySelectorAll(fieldCandidateSelector)].filter(isField);\n  const ids=attribute=>(el.getAttribute(attribute)||'').trim().split(/\\s+/).filter(Boolean);\n  const relatedText=[...ids('aria-describedby'),...ids('aria-errormessage'),...ids('aria-labelledby')].map(id=>doc.getElementById(id)).filter(Boolean);\n  // Live page summaries are global evidence, not every nearby field's constraint.\n  // Explicit accessibility relationships keep field-specific hints and errors local.\n  const liveSelector='[role=\"status\"],[role=\"alert\"],[role=\"timer\"],[role=\"log\"],[aria-live]:not([aria-live=\"off\"]),output';\n  const unrelatedLive=node=>{\n    if(relatedText.some(related=>related===node || related.contains(node)))return false;\n    return Boolean(node.closest(liveSelector));\n  };\n  const contextText=node=>{\n    if(!node.matches(liveSelector) && !node.closest(liveSelector) && !node.querySelector(liveSelector))return node.innerText || '';\n    const parts=[],walker=doc.createTreeWalker(node,4);let text;\n    while((text=walker.nextNode())){\n      const parent=text.parentElement;\n      if(!parent || unrelatedLive(parent) || parent.closest('script,style') || !parent.getClientRects().length)continue;\n      const style=view.getComputedStyle(parent);\n      if(style.display!=='none' && style.visibility==='visible')parts.push(text.textContent||'');\n    }\n    return parts.join(' ');\n  };\n  let peerGroup;\n  const context=[], ownerPaths=[], localParents=[], sharedLabels=[], own=(el.innerText || '').trim();\n  const addContext=text=>{text=text.replace(/\\s+/g,' ').trim();if(context.length<2 && text && text!==own && text.length<=400 && !context.includes(text))context.push(text);};\n  const sharedContext=boundary=>{\n    let branch=el;\n    while(branch.parentElement && branch.parentElement!==boundary)branch=branch.parentElement;\n    for(let parent=boundary,depth=0;parent && parent!==doc.body && depth<3;branch=parent,parent=parent.parentElement,depth++){\n      for(const child of parent.children){\n        if(child===branch || child.contains(el) || isField(child) || fieldsWithin(child).length)continue;\n        if(child.matches('button,a,[role=\"button\"],[role=\"option\"],[role=\"listbox\"],[role=\"menu\"],[role=\"menuitem\"]') || child.querySelector('button,a,[role=\"button\"],[role=\"option\"],[role=\"listbox\"],[role=\"menuitem\"]'))continue;\n        const style=view.getComputedStyle(child);\n        if(!child.getClientRects().length || style.display==='none' || style.visibility!=='visible' || style.cursor==='pointer')continue;\n        const text=contextText(child).replace(/\\s+/g,' ').trim();\n        if(!text || text.length>240)continue;\n        addContext(text);\n        if(!unrelatedLive(child))sharedLabels.push(child);\n      }\n    }\n  };\n  for(let p=el.parentElement, depth=0;p && p!==doc.body && depth<7;p=p.parentElement,depth++){\n    const independent=fieldsWithin(p).some(other=>{\n      if(other===el || el.contains(other) || other.contains(el))return false;\n      if(['radio','checkbox'].includes(el.type) && el.name && other.type===el.type && other.name===el.name)return false;\n      return true;\n    });\n    if(independent){\n      const fields=fieldsWithin(p), roots=fields.filter(f=>!fields.some(other=>other!==f && other.contains(f)));\n      const peers=roots.filter(f=>f.getClientRects().length).sort((a,b)=>{const ar=a.getBoundingClientRect(),br=b.getBoundingClientRect();return Math.abs(ar.top-br.top)>8?ar.top-br.top:ar.left-br.left;});\n      const position=peers.findIndex(f=>f===el || f.contains(el));\n      const key=pathFor(p);\n      if(key && position>=0 && peers.length<=8)peerGroup={key,position:position+1,count:peers.length};\n      sharedContext(p);break;\n    }\n    localParents.push(p);\n    const path=pathFor(p);if(path)ownerPaths.push(path);\n    addContext(contextText(p));\n  }\n  for(const related of relatedText){\n    const text=(related.textContent||'').replace(/\\s+/g,' ').trim();\n    if(text && text.length<=400 && !context.includes(text))context.push(text);\n  }\n  const layer=ownLayer && ((ownLayer.querySelector('h1,h2,h3,h4,[role=heading]')?.textContent || ownLayer.innerText || '').replace(/\\s+/g,' ').trim().slice(0,240));\n  const tag=el.tagName.toLowerCase(), type=(el.getAttribute('type') || '').toLowerCase();\n  const editable=(tag==='textarea' || (tag==='input' && !['password','button','submit','reset','checkbox','radio','file','hidden','image'].includes(type)) || el.isContentEditable) && !el.readOnly && !el.matches(':disabled');\n  const modal=Boolean(ownLayer && (ownLayer.matches('dialog,[role=\"dialog\"],[aria-modal=\"true\"]') || /dialog|modal|popup/i.test(String(ownLayer.className))));\n  const layerKey=ownLayer ? [ownLayer.tagName,ownLayer.id,String(ownLayer.className)].join('|') : undefined;\n  const checkables=el.matches('input[type=\"checkbox\"],input[type=\"radio\"],[role=\"checkbox\"],[role=\"radio\"]') ? [el] : [...el.querySelectorAll('input[type=\"checkbox\"],input[type=\"radio\"],[role=\"checkbox\"],[role=\"radio\"]')];\n  const customToggle=/check[-_]?box|radio[-_]?box|checkmark/i.test(String(el.className)) && !(el.innerText||'').trim();\n  const checkbox=checkables.length===1?checkables[0]:undefined;\n  const checked=checkbox ? (checkbox.getAttribute('aria-checked')==='mixed'?'mixed':Boolean(checkbox.checked || checkbox.getAttribute('aria-checked')==='true')) : customToggle ? /(^|[\\s_-])(checked|selected|on)([\\s_-]|$)/i.test(String(el.className)) : undefined;\n  const nativeSelect=tag==='select';\n  const constraints={};\n  if(['input','textarea','select'].includes(tag)){\n    for(const attribute of ['min','max','step','minlength','maxlength','pattern'])if(el.hasAttribute(attribute))constraints[attribute]=el.getAttribute(attribute);\n    if(el.hasAttribute('multiple') && typeof el.multiple==='boolean')constraints.multiple=el.multiple;\n  }\n  const options=nativeSelect?[...el.options].slice(0,100).map(o=>({label:o.label,value:o.value,selected:o.selected,disabled:Boolean(o.disabled||o.closest('optgroup[disabled]'))})):undefined;\n  const labelledByIds=ids('aria-labelledby');\n  const fieldLabel=(el.getAttribute('aria-label') || [...(el.labels||[])].map(label=>label.textContent||'').join(' ') || labelledByIds.map(id=>doc.getElementById(id)?.textContent||'').join(' ')).trim();\n  const labelText=label=>{\n    const parts=[],walker=doc.createTreeWalker(label,4);let node;\n    while((node=walker.nextNode()))if(node.parentElement && !unrelatedLive(node.parentElement) && !node.parentElement.closest('input,textarea,select,button,script,style'))parts.push(node.textContent||'');\n    return parts.join(' ');\n  };\n  const nativeLabels=[...(el.labels||[])], namedLabels=labelledByIds.map(id=>doc.getElementById(id)).filter(Boolean);\n  const labelNodes=[...nativeLabels,...namedLabels,...sharedLabels];\n  for(const parent of localParents)for(const child of parent.children){\n    if(child===el || child.contains(el) || child.matches('input,textarea,select,button,a,[role=\"button\"],[role=\"alert\"],[aria-live]') || child.querySelector('input,textarea,select,button,a,[role=\"button\"]'))continue;\n    const text=contextText(child).replace(/\\s+/g,' ').trim();\n    if(text && text.length<=120 && child.getClientRects().length && !labelNodes.includes(child))labelNodes.push(child);\n  }\n  const labelTexts=[el.getAttribute('aria-label')||'',...labelNodes.map(label=>{\n    const generated=['::before','::after'].map(pseudo=>view.getComputedStyle(label,pseudo).content).map(text=>text && text!=='none' && text!=='normal'?text.replace(/^[\"']|[\"']$/g,''):'');\n    return [generated[0]||'',labelText(label),generated[1]||''].join(' ').replace(/\\s+/g,' ').trim();\n  })];\n  const markedRequired=labelTexts.some(text=>/^\\s*[*\uFF0A\uFE61\u2731]|[*\uFF0A\uFE61\u2731]\\s*$|(?:^|[\uFF08(\\s])(?:\u5FC5\u586B|required)(?:[\uFF09)\\s:\uFF1A]|$)/i.test(text));\n  const markedOptional=labelTexts.some(text=>/(?:^|[\uFF08(\\s])(?:optional|\u9009\u586B|\u53EF\u8865\u5145)(?:[\uFF09)\\s.,\uFF0C\u3002:\uFF1A]|$)/i.test(text));\n  let required,requiredSource;\n  if(el.required){required=true;requiredSource='html';}\n  else if(el.getAttribute('aria-required')==='true'){required=true;requiredSource='aria';}\n  else if(markedRequired){required=true;requiredSource='label-required';}\n  else if(el.getAttribute('aria-required')==='false'){required=false;requiredSource='aria';}\n  else if(markedOptional){required=false;requiredSource='label-optional';}\n  const validationErrors=[el.validationMessage||'',...ids('aria-errormessage').map(id=>doc.getElementById(id)?.textContent||'')].filter(Boolean);\n  const ancestorIds=[],ancestorPaths=[];for(let p=el.parentElement,depth=0;p && depth<12;p=p.parentElement,depth++){if(p.id)ancestorIds.push(p.id);const path=pathFor(p);if(path)ancestorPaths.push(path);}\n  const actionControl=tag==='button' || (tag==='input' && ['button','submit','reset','image'].includes(type));\n  const valueControl=['textarea','select','output'].includes(tag) || (tag==='input' && !actionControl);\n  const observedValue=valueControl && typeof el.value==='string'?el.value:el.isContentEditable?(el.textContent||''):undefined;\n  const actionValue=actionControl && typeof el.value==='string'?el.value:undefined;\n  const displayText=['input','textarea','select'].includes(tag)?undefined:(el.innerText||'').trim().slice(0,2000);\n  const observedName=(fieldLabel || el.getAttribute('placeholder') || el.innerText || el.getAttribute('title') || '').trim().slice(0,2000);\n  const picker=(function(pathFor) {\n  const el=this, doc=el.ownerDocument, view=doc.defaultView;\n  if(el.getRootNode()!==doc)return undefined;\n  const clean=s=>String(s||'').replace(/[\\uE000-\\uF8FF]/g,'').replace(/\\s+/g,' ').trim();\n  const panelSelector='ul,ol,[role=\"listbox\"],[role=\"menu\"],[role=\"tree\"],[role=\"grid\"],[role=\"dialog\"],dialog';\n  const optionSelector='li,option,[role=\"option\"],[role=\"menuitem\"],[role=\"treeitem\"]';\n  const triggerSelector='input,select,button,[tabindex],[role=\"combobox\"],[aria-haspopup],[aria-controls],[aria-owns]';\n  const ids=node=>[...(node.getAttribute('aria-controls')||'').split(/\\s+/),...(node.getAttribute('aria-owns')||'').split(/\\s+/)].filter(Boolean);\n  const explicitPanels=node=>ids(node).map(id=>doc.getElementById(id)).filter(p=>p && p!==node);\n  const hiddenValue=node=>{\n    const inputs=[...node.querySelectorAll('input[type=\"hidden\"]')];\n    return inputs.length===1?inputs[0]:undefined;\n  };\n  // A unique visible text input paired with one hidden selection token is a\n  // grounded autocomplete even when the application omits ARIA combobox markup.\n  const inputBacking=node=>{\n    if(node.tagName!=='INPUT' || !['text','search',''].includes(node.getAttribute('type')||''))return undefined;\n    for(let p=node.parentElement,depth=0;p && p!==doc.body && p.tagName!=='FORM' && depth<2;p=p.parentElement,depth++){\n      const fields=[...p.querySelectorAll('input:not([type=\"hidden\"]),textarea,select')];\n      if(fields.length>1)return undefined;\n      const hidden=[...p.querySelectorAll('input[type=\"hidden\"]')];\n      if(fields.length===1 && fields[0]===node && hidden.length===1)return hidden[0];\n    }\n    return undefined;\n  };\n  const triggerLike=node=>Boolean(inputBacking(node)) ||node.tagName==='SELECT' || node.getAttribute('role')==='combobox' ||\n    Boolean(node.getAttribute('aria-haspopup') && node.getAttribute('aria-haspopup')!=='false') ||\n    explicitPanels(node).some(p=>p.matches(panelSelector)||p.querySelector('[role=\"listbox\"],[role=\"menu\"],[role=\"tree\"]')) ||\n    (node.tabIndex>=0 && hiddenValue(node));\n  const triggersWithin=node=>{\n    const all=[...node.querySelectorAll(triggerSelector)].filter(triggerLike);\n    return all.filter(t=>!all.some(other=>other!==t && other.contains(t)));\n  };\n  const visible=node=>{\n    if(!node.isConnected || !node.getClientRects().length)return false;\n    for(let p=node;p;p=p.parentElement){const s=view.getComputedStyle(p);if(p.hidden || p.getAttribute('aria-hidden')==='true' || s.display==='none' || s.visibility!=='visible' || s.opacity==='0')return false;}\n    return true;\n  };\n  const localPanels=trigger=>{\n    if(trigger.tagName==='SELECT')return [];\n    const nested=[...trigger.querySelectorAll(panelSelector)].filter(p=>p.querySelector(optionSelector));\n    if(nested.length && !triggersWithin(trigger).length)return nested.filter(p=>!nested.some(other=>other!==p && other.contains(p)));\n    for(let parent=trigger.parentElement,depth=0;parent && parent!==doc.body && depth<5;parent=parent.parentElement,depth++){\n      const triggers=triggersWithin(parent);\n      if(triggers.length>1)return [];\n      if(triggers.length!==1 || triggers[0]!==trigger)continue;\n      const panels=[...parent.querySelectorAll(panelSelector)].filter(p=>!trigger.contains(p) && p.querySelector(optionSelector));\n      if(panels.length)return panels.filter(p=>!panels.some(other=>other!==p && other.contains(p)));\n    }\n    return [];\n  };\n  const option=el.closest(optionSelector);\n  const ownRole=option && option.getAttribute('role');\n  let trigger,panels=[],relationship='unknown',part;\n  if(triggerLike(el) && !option){\n    trigger=el;part='trigger';panels=explicitPanels(el);\n    if(panels.length)relationship='aria';else {panels=localPanels(el);if(panels.length)relationship='local-dom';}\n    if(el.tagName!=='SELECT' && !panels.length && !el.hasAttribute('aria-haspopup') && el.getAttribute('role')!=='combobox' && !inputBacking(el))return undefined;\n  }else if(option){\n    part='option';const panel=option.closest(panelSelector);\n    if(!panel && option.tagName!=='OPTION')return undefined;\n    const all=[...doc.querySelectorAll('[aria-controls],[aria-owns]')];\n    const explicit=all.length<=512 ? all.filter(t=>triggerLike(t) && explicitPanels(t).some(p=>p.contains(option))) : [];\n    let ambiguous=explicit.length>1 || all.length>512;\n    if(explicit.length===1){trigger=explicit[0];panels=explicitPanels(trigger);relationship='aria';}\n    if(!trigger && !ambiguous && panel){\n      for(let parent=panel.parentElement,depth=0;parent && parent!==doc.body && depth<5;parent=parent.parentElement,depth++){\n        const triggers=triggersWithin(parent).filter(t=>!panel.contains(t));\n        if(triggers.length>1){ambiguous=true;break;}\n        if(triggers.length===1){\n          const candidate=triggers[0],owned=explicitPanels(candidate).length?explicitPanels(candidate):localPanels(candidate);\n          if(owned.some(p=>p.contains(option))){trigger=candidate;panels=owned;relationship='local-dom';break;}\n        }\n      }\n    }\n    if(!trigger && !ambiguous && !['option','menuitem','treeitem'].includes(ownRole))return undefined;\n  }else return undefined;\n  const result={part,relationship,panelPaths:panels.map(pathFor).filter(Boolean),selection:'unknown',selectionEvidence:'unknown'};\n  if(option && part==='option'){\n    result.optionText=clean(option.innerText||option.textContent).slice(0,2000);\n    result.optionLabel=clean(option.getAttribute('aria-label') || (option.innerText||option.textContent||'').split(/\\n/).find(line=>line.trim()) || '').slice(0,2000);\n    const optionPath=pathFor(option);if(optionPath)result.optionPath=optionPath;\n    if(option.hasAttribute('aria-selected'))result.optionSelected=option.getAttribute('aria-selected')==='true';\n    else if(option.tagName==='OPTION')result.optionSelected=option.selected;\n  }\n  if(!trigger)return result;\n  const path=pathFor(trigger);if(path)result.triggerPath=path;else result.relationship='unknown';\n  const label=clean(trigger.getAttribute('aria-label') || [...(trigger.labels||[])].map(l=>l.textContent).join(' ') ||\n    (trigger.getAttribute('aria-labelledby')||'').split(/\\s+/).map(id=>doc.getElementById(id)?.textContent||'').join(' '));\n  if(label){result.label=label.slice(0,200);result.labelSource='label';}\n  const backing=inputBacking(trigger);\n  const hidden=hiddenValue(trigger)||backing,display=[];\n  const walker=doc.createTreeWalker(trigger,4);let node;\n  while((node=walker.nextNode())){\n    const parent=node.parentElement;\n    if(parent && visible(parent) && !parent.closest('script,style') && !panels.some(p=>p.contains(parent)))display.push(node.textContent||'');\n  }\n  const text=backing?clean(trigger.value):clean(display.join(''));\n  if(trigger.tagName==='SELECT'){\n    result.selection=trigger.selectedIndex<0 || (trigger.required && trigger.value==='')?'empty':'value';result.selectionEvidence='native-select';\n    if(result.selection==='value')result.committedText=[...trigger.selectedOptions].map(o=>o.label).join(', ');\n  }else if(hidden){\n    result.selection=hidden.value!==''?'value':hidden.hasAttribute('value')?'unknown':'empty';result.selectionEvidence='backing-input';\n    if(result.selection==='value' && text)result.committedText=text.slice(0,2000);\n    if(!label && result.selection==='empty' && text){result.label=text.slice(0,200);result.labelSource='empty-display';}\n  }\n  if(['INPUT','TEXTAREA'].includes(trigger.tagName) && trigger.type!=='hidden'){\n    if(!backing || !hidden.value || panels.some(visible))result.queryText=trigger.value;\n    if(!label && trigger.placeholder){result.label=clean(trigger.placeholder).slice(0,200);result.labelSource='placeholder';}\n  }\n  if(panels.length)result.panelVisible=panels.some(visible);\n  if(trigger.hasAttribute('aria-expanded'))result.expanded=trigger.getAttribute('aria-expanded')==='true';\n  else if(panels.length)result.expanded=result.panelVisible;\n  return result;\n}).call(el,pathFor);\n  return {availability,...(revealViaScroll?{revealViaScroll}:{}),editable,readable:true,...(peerGroup?{peerGroup}:{}),...(picker?{picker}:{}),domSemantics:{tag:el.tagName.toLowerCase(),role:el.getAttribute(\"role\")||\"\",disabled:Boolean(el.disabled)||el.getAttribute(\"aria-disabled\")===\"true\",readOnly:Boolean(el.readOnly)||el.getAttribute(\"aria-readonly\")===\"true\"},context,modal,nativeSelect,observedValue,observedName,...(Object.keys(constraints).length?{constraints}:{}),...(actionValue===undefined?{}:{actionValue}),...(displayText===undefined?{}:{displayText}),htmlId:el.id,controlsIds:[...ids('aria-controls'),...ids('aria-owns')],ancestorIds,ownerPaths,ancestorPaths,position,scrollContainerPaths,labelledByIds,fieldLabel,validationErrors,...(required===undefined?{}:{required,requiredSource}),inputType:type,...(el.hasAttribute('aria-expanded')?{expanded:el.getAttribute('aria-expanded')==='true'}:{}),...(nativeSelect?{options,optionsTruncated:el.options.length>100}:{}),...(layer?{layer}:{}),...(layerKey?{layerKey}:{}),...(checked===undefined?{}:{checked})};\n}";
+export declare function inspectGoalControls(controller: Pick<NativeCdpController, "resolveBackendNode" | "callFunctionOnObject" | "releaseObject">, snapshot: BrowserAxSnapshot, origins: readonly string[], signal: AbortSignal): Promise<GoalSnapshot>;