@roll-agent/browser-use-agent 0.27.3 → 0.27.4

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

@@ -1,12 +1,12 @@
 export declare const browserExecute: import("@roll-agent/sdk").ToolDefinition<{
-    source: string;
     pageId: string;
+    source: string;
+    args: Record<string, unknown>;
     capabilities: ("navigate" | "read" | "interact" | "capture")[];
     allowedOrigins: string[];
-    args?: Record<string, unknown> | undefined;
-    timeoutMs?: number | undefined;
-    maxCalls?: number | undefined;
-    preconditions?: ({
+    timeoutMs: number;
+    maxCalls: number;
+    preconditions: ({
         target: {
             css: string;
             scope?: string | undefined;
@@ -22,7 +22,6 @@ export declare const browserExecute: import("@roll-agent/sdk").ToolDefinition<{
         };
         state: "disabled" | "attached" | "visible" | "hidden" | "absent" | "enabled" | "checked" | "unchecked";
     } | {
-        text: string;
         target: {
             css: string;
             scope?: string | undefined;
@@ -36,9 +35,9 @@ export declare const browserExecute: import("@roll-agent/sdk").ToolDefinition<{
             ref: string;
             snapshotId: string;
         };
-        match?: "equals" | "contains" | undefined;
+        text: string;
+        match: "equals" | "contains";
     } | {
-        value: string;
         target: {
             css: string;
             scope?: string | undefined;
@@ -52,11 +51,12 @@ export declare const browserExecute: import("@roll-agent/sdk").ToolDefinition<{
             ref: string;
             snapshotId: string;
         };
+        value: string;
     } | {
         url: string;
-        match?: "startsWith" | "equals" | undefined;
-    })[] | undefined;
-    postconditions?: ({
+        match: "startsWith" | "equals";
+    })[];
+    postconditions: ({
         target: {
             css: string;
             scope?: string | undefined;
@@ -72,7 +72,6 @@ export declare const browserExecute: import("@roll-agent/sdk").ToolDefinition<{
         };
         state: "disabled" | "attached" | "visible" | "hidden" | "absent" | "enabled" | "checked" | "unchecked";
     } | {
-        text: string;
         target: {
             css: string;
             scope?: string | undefined;
@@ -86,9 +85,9 @@ export declare const browserExecute: import("@roll-agent/sdk").ToolDefinition<{
             ref: string;
             snapshotId: string;
         };
-        match?: "equals" | "contains" | undefined;
+        text: string;
+        match: "equals" | "contains";
     } | {
-        value: string;
         target: {
             css: string;
             scope?: string | undefined;
@@ -102,17 +101,18 @@ export declare const browserExecute: import("@roll-agent/sdk").ToolDefinition<{
             ref: string;
             snapshotId: string;
         };
+        value: string;
     } | {
         url: string;
-        match?: "startsWith" | "equals" | undefined;
-    })[] | undefined;
+        match: "startsWith" | "equals";
+    })[];
     scriptApproval?: {
         id: string;
     } | undefined;
 }, {
+    executionId: string;
     status: "failed" | "completed" | "cancelled" | "timed_out";
     verification: "not_requested" | "passed" | "failed";
-    executionId: string;
     logs: string[];
     actions: {
         index: number;
@@ -124,8 +124,8 @@ export declare const browserExecute: import("@roll-agent/sdk").ToolDefinition<{
     }[];
     checks: {
         passed: boolean;
-        elapsedMs: number;
         kind: string;
+        elapsedMs: number;
         actual?: Record<string, string | number | boolean | null> | undefined;
     }[];
     observation: {
@@ -135,8 +135,8 @@ export declare const browserExecute: import("@roll-agent/sdk").ToolDefinition<{
         changes?: string[] | undefined;
     };
     artifacts: {
-        path: string;
         id: string;
+        path: string;
         mimeType: "image/png";
     }[];
     metrics: {

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

@@ -1,28 +1,30 @@
 export declare const browserOperate: import("@roll-agent/sdk").ToolDefinition<{
     pageId: string;
-    allowedOrigins: string[];
     goal: string;
-    values?: {
+    values: {
         name: string;
         text: string;
-    }[] | undefined;
-    timeoutMs?: number | undefined;
-    model?: string | undefined;
-    browserActionApproval?: {
-        id: string;
-    } | undefined;
+    }[];
+    delegatedDecisions: string[];
+    maxTextCalls: number;
+    maxRecoveryDecisions: number;
+    allowedOrigins: string[];
+    blockedNames: string[];
+    strategy: "task" | "fields";
+    maxSteps: number;
+    timeoutMs: number;
     formTask?: {
         mode: "create" | "edit";
+        stopAt: "applied" | "current-view";
         fields: ({
             name: string;
             intent: "set";
             valueName: string;
-            comparison?: "auto" | "literal" | "semantic" | undefined;
+            comparison: "literal" | "auto" | "semantic";
         } | {
             name: string;
             intent: "preserve";
         })[];
-        stopAt?: "applied" | "current-view" | undefined;
     } | undefined;
     readTask?: {
         target: string;
@@ -33,220 +35,218 @@ export declare const browserOperate: import("@roll-agent/sdk").ToolDefinition<{
             selectedTab?: string | undefined;
         };
     } | undefined;
-    delegatedDecisions?: string[] | undefined;
-    maxTextCalls?: number | undefined;
-    maxRecoveryDecisions?: number | undefined;
-    blockedNames?: string[] | undefined;
     engine?: "jev" | "sampling" | undefined;
-    strategy?: "task" | "fields" | undefined;
-    maxSteps?: number | undefined;
+    model?: string | undefined;
+    browserActionApproval?: {
+        id: string;
+    } | undefined;
 }, {
     status: "failed" | "cancelled" | "needs_input" | "model_done" | "interaction_done" | "needs_reasoning" | "blocked" | "step_limit";
-    elapsedMs: number;
     verified: false;
+    elapsedMs: number;
     steps: {
-        executed: boolean;
         step: number;
-        provider: string;
-        requestedModel: string;
-        resolvedModel: string;
-        operation: string;
         observationMs: number;
         decisionMs: number;
         actionMs: number;
+        operation: string;
+        executed: boolean;
+        requestedModel: string;
+        resolvedModel: string;
+        provider: string;
+        decisionAttempts?: number | undefined;
+        textMs?: number | undefined;
+        recovery?: boolean | undefined;
+        distributions?: Record<string, {
+            probabilities: Record<string, number>;
+            confidence?: number | undefined;
+        }> | undefined;
+        requirement?: string | undefined;
         target?: string | undefined;
+        valueName?: string | undefined;
         error?: string | undefined;
         usage?: {
-            cost?: number | undefined;
             inputTokens?: number | undefined;
             outputTokens?: number | undefined;
+            cost?: number | undefined;
         } | undefined;
-        distributions?: Record<string, {
-            probabilities: Record<string, number>;
-            confidence?: number | undefined;
-        }> | undefined;
-        valueName?: string | undefined;
-        decisionAttempts?: number | undefined;
-        textMs?: number | undefined;
-        recovery?: boolean | undefined;
-        requirement?: string | undefined;
     }[];
-    error?: string | undefined;
+    handoff?: {
+        observationFresh: boolean;
+        diagnosticsOmitted: true;
+        totalSteps: number;
+        omittedSteps: number;
+        fields: {
+            id: string;
+            name: string;
+            reason: string;
+            status: "unknown" | "satisfied" | "unsatisfied";
+            intent: "set" | "preserve";
+            valueTruncated: boolean;
+            expected?: string | undefined;
+            current?: string | undefined;
+        }[];
+        next: string;
+    } | undefined;
     progress?: {
-        missing: string[];
         taskRunId: string;
         contractDigest: string;
         phase: "collect" | "return" | "done";
         evidence: {
             id: string;
-            url: string;
-            frameId: string;
-            documentId: string;
-            text: string;
             field: string;
-            end: number;
-            observedAt: string;
+            text: string;
             observationId: string;
+            documentId: string;
+            frameId: string;
+            url: string;
             regionId: string;
             regionName: string;
             start: number;
+            end: number;
+            observedAt: string;
             attribution: "model-selected-observed-text";
         }[];
         invalidatedEvidence: {
             id: string;
-            url: string;
-            frameId: string;
-            documentId: string;
-            text: string;
             field: string;
-            end: number;
-            observedAt: string;
+            text: string;
             observationId: string;
+            documentId: string;
+            frameId: string;
+            url: string;
             regionId: string;
             regionName: string;
             start: number;
+            end: number;
+            observedAt: string;
             attribution: "model-selected-observed-text";
         }[];
+        missing: string[];
         conflicts: number;
         capturedRegion?: {
-            id: string;
+            documentId: string;
+            frameId: string;
             url: string;
+            id: string;
             name: string;
-            frameId: string;
-            documentId: string;
             digest: string;
         } | undefined;
     } | undefined;
     execution?: {
+        invocationId: string;
+        revision: number;
+        documentChanged: boolean;
         changes: {
-            scope: "delegated" | "preserved" | "unassigned";
-            kind: "changed" | "became_unknown" | "appeared";
-            field: string;
             observationId: string;
             identity: string;
+            field: string;
+            kind: "changed" | "became_unknown" | "appeared";
+            scope: "delegated" | "preserved" | "unassigned";
             before?: string | undefined;
             after?: string | undefined;
             afterAction?: string | undefined;
         }[];
-        revision: number;
-        invocationId: string;
-        documentChanged: boolean;
+        latestObservation?: string | undefined;
+        focus?: string | undefined;
+        lastAction?: {
+            operation: string;
+            executed: boolean;
+            target?: string | undefined;
+            error?: string | undefined;
+        } | undefined;
         form?: {
             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";
+                comparison: "literal" | "auto" | "semantic";
+                status: "unknown" | "satisfied" | "unsatisfied";
+                reason: string;
                 expected?: string | undefined;
-                target?: {
-                    label: string;
-                    key: string;
-                    optionsKey: string;
-                } | undefined;
-                fingerprint?: string | undefined;
                 binding?: {
-                    role: string;
-                    name: string;
                     identity: string;
+                    name: string;
+                    role: string;
+                    readOnlyDisplay?: true | undefined;
                     key?: string | undefined;
                     fieldLabel?: string | undefined;
-                    readOnlyDisplay?: true | undefined;
                 } | undefined;
                 entry?: {
-                    role: string;
-                    name: string;
                     identity: string;
+                    name: string;
+                    role: string;
+                    readOnlyDisplay?: true | undefined;
                     key?: string | undefined;
                     fieldLabel?: string | undefined;
-                    readOnlyDisplay?: true | undefined;
                 } | undefined;
                 entryProof?: {
-                    status: "unknown" | "satisfied" | "unsatisfied";
                     fingerprint: string;
+                    status: "unknown" | "satisfied" | "unsatisfied";
                 } | undefined;
                 initial?: string | undefined;
                 current?: string | undefined;
+                fingerprint?: string | undefined;
+                target?: {
+                    key: string;
+                    label: string;
+                    optionsKey: string;
+                } | undefined;
                 semanticProof?: {
-                    status: "satisfied" | "unsatisfied";
                     fingerprint: string;
+                    status: "satisfied" | "unsatisfied";
                 } | undefined;
             }[];
+            focus?: string | undefined;
             panel?: {
-                status: "pending" | "rejected" | "accepted";
                 key: string;
+                status: "pending" | "rejected" | "accepted";
                 queryIdentity?: string | undefined;
             } | undefined;
-            focus?: string | undefined;
-        } | undefined;
-        focus?: string | undefined;
-        latestObservation?: string | undefined;
-        lastAction?: {
-            executed: boolean;
-            operation: string;
-            target?: string | undefined;
-            error?: string | undefined;
         } | undefined;
     } | undefined;
-    resolvedValues?: {
-        source: "selected" | "supplied" | "derived" | "generated";
-        text: string;
-        field: string;
-        evidence: string;
-        sourceIds: string[];
-        targetKey?: string | undefined;
-    }[] | undefined;
+    error?: string | undefined;
     question?: string | undefined;
-    handoff?: {
-        fields: {
-            status: "unknown" | "satisfied" | "unsatisfied";
-            id: string;
-            name: string;
-            reason: string;
-            intent: "set" | "preserve";
-            valueTruncated: boolean;
-            expected?: string | undefined;
-            current?: string | undefined;
-        }[];
-        observationFresh: boolean;
-        diagnosticsOmitted: true;
-        totalSteps: number;
-        omittedSteps: number;
-        next: string;
-    } | undefined;
     recoveryDecisions?: number | undefined;
     fieldEvidence?: {
-        status: "pending" | "preserved" | "applied";
         field: string;
         instruction: string;
+        status: "pending" | "preserved" | "applied";
         targetKey: string;
         expected?: string | undefined;
-        source?: string | undefined;
         current?: string | undefined;
+        source?: string | undefined;
     }[] | undefined;
     pendingRequirements?: string[] | undefined;
     finalObservation?: unknown;
+    resolvedValues?: {
+        text: string;
+        source: "selected" | "supplied" | "derived" | "generated";
+        sourceIds: string[];
+        evidence: string;
+        field: string;
+        targetKey?: string | undefined;
+    }[] | undefined;
     textCalls?: {
-        elapsedMs: number;
         purpose: "preflight" | "resolve_value" | "resolve_batch" | "validate_value" | "validate_batch" | "review_field" | "review" | "clarify";
+        elapsedMs: number;
         cached: boolean;
         startedAtMs?: number | undefined;
         endedAtMs?: number | undefined;
         modelCalls?: {
-            elapsedMs: number;
             provider: string;
             requestedModel: string;
             resolvedModel: string;
+            elapsedMs: number;
+            fallback?: boolean | undefined;
             error?: string | undefined;
             usage?: {
-                cost?: number | undefined;
                 inputTokens?: number | undefined;
                 outputTokens?: number | undefined;
+                cost?: number | undefined;
             } | undefined;
-            fallback?: boolean | undefined;
         }[] | undefined;
     }[] | undefined;
 }>;

package/dist/tools/browser-ref-schemas.d.ts

@@ -1,99 +1,41 @@
 import { z } from "zod";
-export declare const BrowserElementRefResolveStrategySchema: z.ZodEnum<["backend_node_id", "role_name_nth"]>;
+export declare const BrowserElementRefResolveStrategySchema: z.ZodEnum<{
+    backend_node_id: "backend_node_id";
+    role_name_nth: "role_name_nth";
+}>;
 export declare const BrowserElementRefTargetSchema: z.ZodObject<{
     ref: z.ZodString;
     role: z.ZodString;
     name: z.ZodString;
     x: z.ZodNumber;
     y: z.ZodNumber;
-    resolvedBy: z.ZodEnum<["backend_node_id", "role_name_nth"]>;
+    resolvedBy: z.ZodEnum<{
+        backend_node_id: "backend_node_id";
+        role_name_nth: "role_name_nth";
+    }>;
     backendNodeId: z.ZodOptional<z.ZodNumber>;
     frameId: z.ZodOptional<z.ZodString>;
     disabled: z.ZodBoolean;
-}, "strip", z.ZodTypeAny, {
-    x: number;
-    y: number;
-    role: string;
-    name: string;
-    ref: string;
-    disabled: boolean;
-    resolvedBy: "backend_node_id" | "role_name_nth";
-    backendNodeId?: number | undefined;
-    frameId?: string | undefined;
-}, {
-    x: number;
-    y: number;
-    role: string;
-    name: string;
-    ref: string;
-    disabled: boolean;
-    resolvedBy: "backend_node_id" | "role_name_nth";
-    backendNodeId?: number | undefined;
-    frameId?: string | undefined;
-}>;
+}, z.core.$strip>;
 export declare const BrowserElementRefActionOutputSchema: z.ZodObject<{
     success: z.ZodLiteral<true>;
     ref: z.ZodString;
-    resolvedBy: z.ZodEnum<["backend_node_id", "role_name_nth"]>;
+    resolvedBy: z.ZodEnum<{
+        backend_node_id: "backend_node_id";
+        role_name_nth: "role_name_nth";
+    }>;
     target: z.ZodObject<{
         ref: z.ZodString;
         role: z.ZodString;
         name: z.ZodString;
         x: z.ZodNumber;
         y: z.ZodNumber;
-        resolvedBy: z.ZodEnum<["backend_node_id", "role_name_nth"]>;
+        resolvedBy: z.ZodEnum<{
+            backend_node_id: "backend_node_id";
+            role_name_nth: "role_name_nth";
+        }>;
         backendNodeId: z.ZodOptional<z.ZodNumber>;
         frameId: z.ZodOptional<z.ZodString>;
         disabled: z.ZodBoolean;
-    }, "strip", z.ZodTypeAny, {
-        x: number;
-        y: number;
-        role: string;
-        name: string;
-        ref: string;
-        disabled: boolean;
-        resolvedBy: "backend_node_id" | "role_name_nth";
-        backendNodeId?: number | undefined;
-        frameId?: string | undefined;
-    }, {
-        x: number;
-        y: number;
-        role: string;
-        name: string;
-        ref: string;
-        disabled: boolean;
-        resolvedBy: "backend_node_id" | "role_name_nth";
-        backendNodeId?: number | undefined;
-        frameId?: string | undefined;
-    }>;
-}, "strip", z.ZodTypeAny, {
-    ref: string;
-    target: {
-        x: number;
-        y: number;
-        role: string;
-        name: string;
-        ref: string;
-        disabled: boolean;
-        resolvedBy: "backend_node_id" | "role_name_nth";
-        backendNodeId?: number | undefined;
-        frameId?: string | undefined;
-    };
-    success: true;
-    resolvedBy: "backend_node_id" | "role_name_nth";
-}, {
-    ref: string;
-    target: {
-        x: number;
-        y: number;
-        role: string;
-        name: string;
-        ref: string;
-        disabled: boolean;
-        resolvedBy: "backend_node_id" | "role_name_nth";
-        backendNodeId?: number | undefined;
-        frameId?: string | undefined;
-    };
-    success: true;
-    resolvedBy: "backend_node_id" | "role_name_nth";
-}>;
+    }, z.core.$strip>;
+}, z.core.$strip>;

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

@@ -1,9 +1,9 @@
 export declare const browserSnapshot: import("@roll-agent/sdk").ToolDefinition<{
-    pageId?: string | undefined;
+    interactiveOnly: boolean;
     scope?: string | undefined;
-    maxNodes?: number | undefined;
-    interactiveOnly?: boolean | undefined;
+    pageId?: string | undefined;
     maxDepth?: number | undefined;
+    maxNodes?: number | undefined;
 }, {
     page: {
         pageId: string;
@@ -14,12 +14,11 @@ export declare const browserSnapshot: import("@roll-agent/sdk").ToolDefinition<{
         isSelectedForPlatform: boolean;
     };
     snapshot: {
-        truncated: boolean;
         nodes: import("@roll-agent/browser").BrowserAxNode[];
         refs: {
+            ref: string;
             role: string;
             name: string;
-            ref: string;
             nth: number;
             disabled: boolean;
             backendNodeId?: number | undefined;
@@ -39,13 +38,14 @@ export declare const browserSnapshot: import("@roll-agent/sdk").ToolDefinition<{
             strict?: boolean | undefined;
         }[];
         nodeCount: number;
+        truncated: boolean;
         maxNodes: number;
         interactiveOnly: boolean;
+        snapshotId?: string | undefined;
         browserInstance?: string | undefined;
         pageId?: string | undefined;
-        scope?: string | undefined;
-        snapshotId?: string | undefined;
         documentId?: string | undefined;
+        scope?: string | undefined;
         coverageWarnings?: string[] | undefined;
         maxDepth?: number | undefined;
     };