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

package/dist/goal/form-context.d.ts

@@ -0,0 +1,639 @@
+import { z } from "zod";
+import type { taskElements } from "./task-policy.ts";
+export declare const FormFieldSchema: z.ZodDiscriminatedUnion<"intent", [z.ZodObject<{
+    name: z.ZodString;
+    intent: z.ZodLiteral<"set">;
+    valueName: z.ZodString;
+    comparison: z.ZodDefault<z.ZodEnum<["auto", "literal", "semantic"]>>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    intent: "set";
+    comparison: "auto" | "literal" | "semantic";
+    valueName: string;
+}, {
+    name: string;
+    intent: "set";
+    valueName: string;
+    comparison?: "auto" | "literal" | "semantic" | undefined;
+}>, z.ZodObject<{
+    name: z.ZodString;
+    intent: z.ZodLiteral<"preserve">;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    intent: "preserve";
+}, {
+    name: string;
+    intent: "preserve";
+}>]>;
+export declare const FormTaskSchema: z.ZodObject<{
+    mode: z.ZodEnum<["create", "edit"]>;
+    stopAt: z.ZodDefault<z.ZodEnum<["applied", "current-view"]>>;
+    fields: z.ZodEffects<z.ZodArray<z.ZodDiscriminatedUnion<"intent", [z.ZodObject<{
+        name: z.ZodString;
+        intent: z.ZodLiteral<"set">;
+        valueName: z.ZodString;
+        comparison: z.ZodDefault<z.ZodEnum<["auto", "literal", "semantic"]>>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        intent: "set";
+        comparison: "auto" | "literal" | "semantic";
+        valueName: string;
+    }, {
+        name: string;
+        intent: "set";
+        valueName: string;
+        comparison?: "auto" | "literal" | "semantic" | undefined;
+    }>, z.ZodObject<{
+        name: z.ZodString;
+        intent: z.ZodLiteral<"preserve">;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        intent: "preserve";
+    }, {
+        name: string;
+        intent: "preserve";
+    }>]>, "many">, ({
+        name: string;
+        intent: "set";
+        comparison: "auto" | "literal" | "semantic";
+        valueName: string;
+    } | {
+        name: string;
+        intent: "preserve";
+    })[], ({
+        name: string;
+        intent: "set";
+        valueName: string;
+        comparison?: "auto" | "literal" | "semantic" | undefined;
+    } | {
+        name: string;
+        intent: "preserve";
+    })[]>;
+}, "strict", z.ZodTypeAny, {
+    mode: "create" | "edit";
+    stopAt: "applied" | "current-view";
+    fields: ({
+        name: string;
+        intent: "set";
+        comparison: "auto" | "literal" | "semantic";
+        valueName: string;
+    } | {
+        name: string;
+        intent: "preserve";
+    })[];
+}, {
+    mode: "create" | "edit";
+    fields: ({
+        name: string;
+        intent: "set";
+        valueName: string;
+        comparison?: "auto" | "literal" | "semantic" | undefined;
+    } | {
+        name: string;
+        intent: "preserve";
+    })[];
+    stopAt?: "applied" | "current-view" | undefined;
+}>;
+export type FormTask = z.infer<typeof FormTaskSchema>;
+export type FormControl = ReturnType<typeof taskElements>[number];
+export declare const FormFieldStateSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    intent: z.ZodEnum<["set", "preserve"]>;
+    comparison: z.ZodEnum<["auto", "literal", "semantic"]>;
+    expected: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodObject<{
+        identity: z.ZodString;
+        readOnlyDisplay: z.ZodOptional<z.ZodLiteral<true>>;
+        key: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        role: z.ZodString;
+        fieldLabel: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        role: string;
+        name: string;
+        identity: string;
+        key?: string | undefined;
+        fieldLabel?: string | undefined;
+        readOnlyDisplay?: true | undefined;
+    }, {
+        role: string;
+        name: string;
+        identity: string;
+        key?: string | undefined;
+        fieldLabel?: string | undefined;
+        readOnlyDisplay?: true | undefined;
+    }>>;
+    entry: z.ZodOptional<z.ZodObject<{
+        identity: z.ZodString;
+        readOnlyDisplay: z.ZodOptional<z.ZodLiteral<true>>;
+        key: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        role: z.ZodString;
+        fieldLabel: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        role: string;
+        name: string;
+        identity: string;
+        key?: string | undefined;
+        fieldLabel?: string | undefined;
+        readOnlyDisplay?: true | undefined;
+    }, {
+        role: string;
+        name: string;
+        identity: string;
+        key?: string | undefined;
+        fieldLabel?: string | undefined;
+        readOnlyDisplay?: true | undefined;
+    }>>;
+    entryProof: z.ZodOptional<z.ZodObject<{
+        fingerprint: z.ZodString;
+        status: z.ZodEnum<["satisfied", "unsatisfied", "unknown"]>;
+    }, "strip", z.ZodTypeAny, {
+        status: "unknown" | "satisfied" | "unsatisfied";
+        fingerprint: string;
+    }, {
+        status: "unknown" | "satisfied" | "unsatisfied";
+        fingerprint: string;
+    }>>;
+    initial: z.ZodOptional<z.ZodString>;
+    current: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<["unknown", "unsatisfied", "satisfied"]>;
+    reason: z.ZodString;
+    fingerprint: z.ZodOptional<z.ZodString>;
+    target: z.ZodOptional<z.ZodObject<{
+        key: z.ZodString;
+        label: z.ZodString;
+        optionsKey: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        key: string;
+        optionsKey: string;
+    }, {
+        label: string;
+        key: string;
+        optionsKey: string;
+    }>>;
+    semanticProof: z.ZodOptional<z.ZodObject<{
+        fingerprint: z.ZodString;
+        status: z.ZodEnum<["satisfied", "unsatisfied"]>;
+    }, "strip", z.ZodTypeAny, {
+        status: "satisfied" | "unsatisfied";
+        fingerprint: string;
+    }, {
+        status: "satisfied" | "unsatisfied";
+        fingerprint: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    status: "unknown" | "satisfied" | "unsatisfied";
+    id: string;
+    name: string;
+    reason: string;
+    intent: "set" | "preserve";
+    comparison: "auto" | "literal" | "semantic";
+    expected?: string | undefined;
+    target?: {
+        label: string;
+        key: string;
+        optionsKey: string;
+    } | undefined;
+    fingerprint?: string | undefined;
+    binding?: {
+        role: string;
+        name: string;
+        identity: string;
+        key?: string | undefined;
+        fieldLabel?: string | undefined;
+        readOnlyDisplay?: true | undefined;
+    } | undefined;
+    entry?: {
+        role: string;
+        name: string;
+        identity: string;
+        key?: string | undefined;
+        fieldLabel?: string | undefined;
+        readOnlyDisplay?: true | undefined;
+    } | undefined;
+    entryProof?: {
+        status: "unknown" | "satisfied" | "unsatisfied";
+        fingerprint: string;
+    } | undefined;
+    initial?: string | undefined;
+    current?: string | undefined;
+    semanticProof?: {
+        status: "satisfied" | "unsatisfied";
+        fingerprint: string;
+    } | undefined;
+}, {
+    status: "unknown" | "satisfied" | "unsatisfied";
+    id: string;
+    name: string;
+    reason: string;
+    intent: "set" | "preserve";
+    comparison: "auto" | "literal" | "semantic";
+    expected?: string | undefined;
+    target?: {
+        label: string;
+        key: string;
+        optionsKey: string;
+    } | undefined;
+    fingerprint?: string | undefined;
+    binding?: {
+        role: string;
+        name: string;
+        identity: string;
+        key?: string | undefined;
+        fieldLabel?: string | undefined;
+        readOnlyDisplay?: true | undefined;
+    } | undefined;
+    entry?: {
+        role: string;
+        name: string;
+        identity: string;
+        key?: string | undefined;
+        fieldLabel?: string | undefined;
+        readOnlyDisplay?: true | undefined;
+    } | undefined;
+    entryProof?: {
+        status: "unknown" | "satisfied" | "unsatisfied";
+        fingerprint: string;
+    } | undefined;
+    initial?: string | undefined;
+    current?: string | undefined;
+    semanticProof?: {
+        status: "satisfied" | "unsatisfied";
+        fingerprint: string;
+    } | undefined;
+}>;
+export declare const FormStateSchema: z.ZodObject<{
+    mode: z.ZodEnum<["create", "edit"]>;
+    stopAt: z.ZodEnum<["applied", "current-view"]>;
+    fields: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        intent: z.ZodEnum<["set", "preserve"]>;
+        comparison: z.ZodEnum<["auto", "literal", "semantic"]>;
+        expected: z.ZodOptional<z.ZodString>;
+        binding: z.ZodOptional<z.ZodObject<{
+            identity: z.ZodString;
+            readOnlyDisplay: z.ZodOptional<z.ZodLiteral<true>>;
+            key: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            role: z.ZodString;
+            fieldLabel: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            role: string;
+            name: string;
+            identity: string;
+            key?: string | undefined;
+            fieldLabel?: string | undefined;
+            readOnlyDisplay?: true | undefined;
+        }, {
+            role: string;
+            name: string;
+            identity: string;
+            key?: string | undefined;
+            fieldLabel?: string | undefined;
+            readOnlyDisplay?: true | undefined;
+        }>>;
+        entry: z.ZodOptional<z.ZodObject<{
+            identity: z.ZodString;
+            readOnlyDisplay: z.ZodOptional<z.ZodLiteral<true>>;
+            key: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            role: z.ZodString;
+            fieldLabel: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            role: string;
+            name: string;
+            identity: string;
+            key?: string | undefined;
+            fieldLabel?: string | undefined;
+            readOnlyDisplay?: true | undefined;
+        }, {
+            role: string;
+            name: string;
+            identity: string;
+            key?: string | undefined;
+            fieldLabel?: string | undefined;
+            readOnlyDisplay?: true | undefined;
+        }>>;
+        entryProof: z.ZodOptional<z.ZodObject<{
+            fingerprint: z.ZodString;
+            status: z.ZodEnum<["satisfied", "unsatisfied", "unknown"]>;
+        }, "strip", z.ZodTypeAny, {
+            status: "unknown" | "satisfied" | "unsatisfied";
+            fingerprint: string;
+        }, {
+            status: "unknown" | "satisfied" | "unsatisfied";
+            fingerprint: string;
+        }>>;
+        initial: z.ZodOptional<z.ZodString>;
+        current: z.ZodOptional<z.ZodString>;
+        status: z.ZodEnum<["unknown", "unsatisfied", "satisfied"]>;
+        reason: z.ZodString;
+        fingerprint: z.ZodOptional<z.ZodString>;
+        target: z.ZodOptional<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+            optionsKey: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            key: string;
+            optionsKey: string;
+        }, {
+            label: string;
+            key: string;
+            optionsKey: string;
+        }>>;
+        semanticProof: z.ZodOptional<z.ZodObject<{
+            fingerprint: z.ZodString;
+            status: z.ZodEnum<["satisfied", "unsatisfied"]>;
+        }, "strip", z.ZodTypeAny, {
+            status: "satisfied" | "unsatisfied";
+            fingerprint: string;
+        }, {
+            status: "satisfied" | "unsatisfied";
+            fingerprint: string;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        status: "unknown" | "satisfied" | "unsatisfied";
+        id: string;
+        name: string;
+        reason: string;
+        intent: "set" | "preserve";
+        comparison: "auto" | "literal" | "semantic";
+        expected?: string | undefined;
+        target?: {
+            label: string;
+            key: string;
+            optionsKey: string;
+        } | undefined;
+        fingerprint?: string | undefined;
+        binding?: {
+            role: string;
+            name: string;
+            identity: string;
+            key?: string | undefined;
+            fieldLabel?: string | undefined;
+            readOnlyDisplay?: true | undefined;
+        } | undefined;
+        entry?: {
+            role: string;
+            name: string;
+            identity: string;
+            key?: string | undefined;
+            fieldLabel?: string | undefined;
+            readOnlyDisplay?: true | undefined;
+        } | undefined;
+        entryProof?: {
+            status: "unknown" | "satisfied" | "unsatisfied";
+            fingerprint: string;
+        } | undefined;
+        initial?: string | undefined;
+        current?: string | undefined;
+        semanticProof?: {
+            status: "satisfied" | "unsatisfied";
+            fingerprint: string;
+        } | undefined;
+    }, {
+        status: "unknown" | "satisfied" | "unsatisfied";
+        id: string;
+        name: string;
+        reason: string;
+        intent: "set" | "preserve";
+        comparison: "auto" | "literal" | "semantic";
+        expected?: string | undefined;
+        target?: {
+            label: string;
+            key: string;
+            optionsKey: string;
+        } | undefined;
+        fingerprint?: string | undefined;
+        binding?: {
+            role: string;
+            name: string;
+            identity: string;
+            key?: string | undefined;
+            fieldLabel?: string | undefined;
+            readOnlyDisplay?: true | undefined;
+        } | undefined;
+        entry?: {
+            role: string;
+            name: string;
+            identity: string;
+            key?: string | undefined;
+            fieldLabel?: string | undefined;
+            readOnlyDisplay?: true | undefined;
+        } | undefined;
+        entryProof?: {
+            status: "unknown" | "satisfied" | "unsatisfied";
+            fingerprint: string;
+        } | undefined;
+        initial?: string | undefined;
+        current?: string | undefined;
+        semanticProof?: {
+            status: "satisfied" | "unsatisfied";
+            fingerprint: string;
+        } | undefined;
+    }>, "many">;
+    focus: z.ZodOptional<z.ZodString>;
+    panel: z.ZodOptional<z.ZodObject<{
+        key: z.ZodString;
+        status: z.ZodEnum<["pending", "accepted", "rejected"]>;
+        queryIdentity: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "pending" | "rejected" | "accepted";
+        key: string;
+        queryIdentity?: string | undefined;
+    }, {
+        status: "pending" | "rejected" | "accepted";
+        key: string;
+        queryIdentity?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    mode: "create" | "edit";
+    stopAt: "applied" | "current-view";
+    fields: {
+        status: "unknown" | "satisfied" | "unsatisfied";
+        id: string;
+        name: string;
+        reason: string;
+        intent: "set" | "preserve";
+        comparison: "auto" | "literal" | "semantic";
+        expected?: string | undefined;
+        target?: {
+            label: string;
+            key: string;
+            optionsKey: string;
+        } | undefined;
+        fingerprint?: string | undefined;
+        binding?: {
+            role: string;
+            name: string;
+            identity: string;
+            key?: string | undefined;
+            fieldLabel?: string | undefined;
+            readOnlyDisplay?: true | undefined;
+        } | undefined;
+        entry?: {
+            role: string;
+            name: string;
+            identity: string;
+            key?: string | undefined;
+            fieldLabel?: string | undefined;
+            readOnlyDisplay?: true | undefined;
+        } | undefined;
+        entryProof?: {
+            status: "unknown" | "satisfied" | "unsatisfied";
+            fingerprint: string;
+        } | undefined;
+        initial?: string | undefined;
+        current?: string | undefined;
+        semanticProof?: {
+            status: "satisfied" | "unsatisfied";
+            fingerprint: string;
+        } | undefined;
+    }[];
+    panel?: {
+        status: "pending" | "rejected" | "accepted";
+        key: string;
+        queryIdentity?: string | undefined;
+    } | undefined;
+    focus?: string | undefined;
+}, {
+    mode: "create" | "edit";
+    stopAt: "applied" | "current-view";
+    fields: {
+        status: "unknown" | "satisfied" | "unsatisfied";
+        id: string;
+        name: string;
+        reason: string;
+        intent: "set" | "preserve";
+        comparison: "auto" | "literal" | "semantic";
+        expected?: string | undefined;
+        target?: {
+            label: string;
+            key: string;
+            optionsKey: string;
+        } | undefined;
+        fingerprint?: string | undefined;
+        binding?: {
+            role: string;
+            name: string;
+            identity: string;
+            key?: string | undefined;
+            fieldLabel?: string | undefined;
+            readOnlyDisplay?: true | undefined;
+        } | undefined;
+        entry?: {
+            role: string;
+            name: string;
+            identity: string;
+            key?: string | undefined;
+            fieldLabel?: string | undefined;
+            readOnlyDisplay?: true | undefined;
+        } | undefined;
+        entryProof?: {
+            status: "unknown" | "satisfied" | "unsatisfied";
+            fingerprint: string;
+        } | undefined;
+        initial?: string | undefined;
+        current?: string | undefined;
+        semanticProof?: {
+            status: "satisfied" | "unsatisfied";
+            fingerprint: string;
+        } | undefined;
+    }[];
+    panel?: {
+        status: "pending" | "rejected" | "accepted";
+        key: string;
+        queryIdentity?: string | undefined;
+    } | undefined;
+    focus?: string | undefined;
+}>;
+export type FormState = z.infer<typeof FormStateSchema>;
+export declare const formControlValue: (c: FormControl) => string | undefined;
+export declare const comparableControl: (c: FormControl) => boolean;
+/** Presentation text on a picker is its mutable value, never its identity. */
+export declare const controlBindingKey: (c: FormControl) => string;
+export declare const usesSemanticComparison: (field: FormState["fields"][number], c: FormControl) => boolean;
+export declare const formOptions: (c: FormControl, controls: readonly FormControl[]) => {
+    id: string;
+    label: string;
+}[];
+export declare const formTargetKey: (c: FormControl, expected: string | undefined) => string;
+export declare const formOptionsKey: (options: ReturnType<typeof formOptions>) => string;
+export declare const controlFingerprint: (c: FormControl) => string;
+/** Keep the surrounding label, excluding this entry's mutable displayed summary. */
+export declare const entryBindingKey: (c: FormControl) => string;
+export declare const entryFingerprint: (c: FormControl) => string;
+/** Only the node's own displayed text is evidence; surrounding context is never a value. */
+export declare const preserveDisplayValue: (c: FormControl) => string | undefined;
+export declare const preserveDisplayInitialKey: (c: FormControl) => string;
+export declare const currentFormEntry: (field: FormState["fields"][number], controls: readonly FormControl[]) => {
+    ref: string;
+    identity: string;
+    role: string;
+    name: string;
+    disabled: boolean;
+    readonly: string | number | boolean | undefined;
+    value: string | undefined;
+    valueKind: string;
+    displayText: string | undefined;
+    checked: string | number | boolean | undefined;
+    selected: string | number | boolean | undefined;
+    fieldLabel: string | undefined;
+    pickerIdentity: string | undefined;
+    readable: boolean | undefined;
+    peerGroup: {
+        count: number;
+        key: string;
+        position: number;
+    } | undefined;
+    pickerOwnerPath: string | undefined;
+    pickerOptionPath: string | undefined;
+    pickerOptionLabel: string | undefined;
+    required: boolean | 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;
+    position: {
+        left: number;
+        top: number;
+    } | undefined;
+    scrollContainerPaths: string[] | undefined;
+    revealViaScroll: boolean | undefined;
+    inputType: string | undefined;
+    expanded: string | number | boolean | undefined;
+    validationErrors: string[] | undefined;
+    invalid: string | number | boolean | undefined;
+    context: string[];
+    availability: "hidden" | "ready" | "offscreen" | "covered" | "unavailable";
+    editable: boolean | undefined;
+    layer: string | undefined;
+    modal: boolean | undefined;
+    nativeSelect: boolean | undefined;
+    options: {
+        value: string;
+        label: string;
+        disabled: boolean;
+        selected: boolean;
+    }[] | undefined;
+    optionsTruncated: boolean | undefined;
+} | undefined;
+/** Fields independently assigned to the same observed entry share only that local editor. */
+export declare const editorFieldIds: (form: FormState) => string[];
+export declare function createFormState(contract: FormTask, values: readonly {
+    name: string;
+    text: string;
+}[]): FormState;
+export declare function updateFormState(form: FormState, controls: readonly FormControl[], initial: ReadonlyMap<string, string>, panelKeys: readonly string[]): boolean;
+export declare function formValuesSatisfied(form: FormState): boolean;