@roll-agent/browser-use-agent 0.25.1 → 0.26.0

package/dist/reply-authority/schemas.d.ts

@@ -45,9 +45,9 @@ export declare const ReplyAuthorityEnvelopePayloadSchema: z.ZodObject<{
     }>;
 }, "strip", z.ZodTypeAny, {
     platform: "zhipin";
+    reply: string;
     conversationId: string;
     candidateId: string;
-    reply: string;
     tenantId: string;
     recruiterBinding: {
         platform: "zhipin";
@@ -64,9 +64,9 @@ export declare const ReplyAuthorityEnvelopePayloadSchema: z.ZodObject<{
     policyVersion: string;
 }, {
     platform: "zhipin";
+    reply: string;
     conversationId: string;
     candidateId: string;
-    reply: string;
     tenantId: string;
     recruiterBinding: {
         platform: "zhipin";

package/dist/tools/browser-dom-action-candidates.d.ts

@@ -1,6 +1,7 @@
 import type { BrowserDomActionHint, NativeCdpController } from "@roll-agent/browser";
 type DomActionCandidateController = Pick<NativeCdpController, "createIsolatedWorld" | "describeNode" | "evaluateJson" | "getDocument" | "querySelectorAllByNodeId">;
 type DomActionCandidateOptions = {
+    readonly scope?: string;
     readonly frameId?: string;
     readonly maxCandidates?: number;
 };

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

@@ -0,0 +1,152 @@
+export declare const browserExecute: import("@roll-agent/sdk").ToolDefinition<{
+    source: string;
+    pageId: string;
+    capabilities: ("navigate" | "read" | "interact" | "capture")[];
+    allowedOrigins: string[];
+    args?: Record<string, unknown> | undefined;
+    timeoutMs?: number | undefined;
+    maxCalls?: number | undefined;
+    preconditions?: ({
+        target: {
+            css: string;
+            scope?: string | undefined;
+            frameId?: string | undefined;
+        } | {
+            role: string;
+            name: string;
+            scope?: string | undefined;
+            frameId?: string | undefined;
+        } | {
+            ref: string;
+            snapshotId: string;
+        };
+        state: "disabled" | "attached" | "visible" | "hidden" | "absent" | "enabled" | "checked" | "unchecked";
+    } | {
+        text: string;
+        target: {
+            css: string;
+            scope?: string | undefined;
+            frameId?: string | undefined;
+        } | {
+            role: string;
+            name: string;
+            scope?: string | undefined;
+            frameId?: string | undefined;
+        } | {
+            ref: string;
+            snapshotId: string;
+        };
+        match?: "equals" | "contains" | undefined;
+    } | {
+        value: string;
+        target: {
+            css: string;
+            scope?: string | undefined;
+            frameId?: string | undefined;
+        } | {
+            role: string;
+            name: string;
+            scope?: string | undefined;
+            frameId?: string | undefined;
+        } | {
+            ref: string;
+            snapshotId: string;
+        };
+    } | {
+        url: string;
+        match?: "startsWith" | "equals" | undefined;
+    })[] | undefined;
+    postconditions?: ({
+        target: {
+            css: string;
+            scope?: string | undefined;
+            frameId?: string | undefined;
+        } | {
+            role: string;
+            name: string;
+            scope?: string | undefined;
+            frameId?: string | undefined;
+        } | {
+            ref: string;
+            snapshotId: string;
+        };
+        state: "disabled" | "attached" | "visible" | "hidden" | "absent" | "enabled" | "checked" | "unchecked";
+    } | {
+        text: string;
+        target: {
+            css: string;
+            scope?: string | undefined;
+            frameId?: string | undefined;
+        } | {
+            role: string;
+            name: string;
+            scope?: string | undefined;
+            frameId?: string | undefined;
+        } | {
+            ref: string;
+            snapshotId: string;
+        };
+        match?: "equals" | "contains" | undefined;
+    } | {
+        value: string;
+        target: {
+            css: string;
+            scope?: string | undefined;
+            frameId?: string | undefined;
+        } | {
+            role: string;
+            name: string;
+            scope?: string | undefined;
+            frameId?: string | undefined;
+        } | {
+            ref: string;
+            snapshotId: string;
+        };
+    } | {
+        url: string;
+        match?: "startsWith" | "equals" | undefined;
+    })[] | undefined;
+    scriptApproval?: {
+        id: string;
+    } | undefined;
+}, {
+    status: "failed" | "completed" | "cancelled" | "timed_out";
+    verification: "not_requested" | "passed" | "failed";
+    executionId: string;
+    logs: string[];
+    actions: {
+        index: number;
+        method: string;
+        executed: boolean;
+        verification: "not_requested" | "passed" | "failed";
+        elapsedMs: number;
+        errorCode?: string | undefined;
+    }[];
+    checks: {
+        passed: boolean;
+        elapsedMs: number;
+        kind: string;
+        actual?: Record<string, string | number | boolean | null> | undefined;
+    }[];
+    observation: {
+        changed: boolean;
+        beforeUrl?: string | undefined;
+        afterUrl?: string | undefined;
+        changes?: string[] | undefined;
+    };
+    artifacts: {
+        path: string;
+        id: string;
+        mimeType: "image/png";
+    }[];
+    metrics: {
+        elapsedMs: number;
+        helperCalls: number;
+        verifiedAssertions: number;
+    };
+    value?: unknown;
+    error?: {
+        code: string;
+        message: string;
+    } | undefined;
+}>;

package/dist/tools/browser-ref-frame-guard.d.ts

@@ -0,0 +1,8 @@
+import type { BrowserRuntime, NativeCdpController } from "@roll-agent/browser";
+/** Preserve native method receivers while checking the last, externally observable input boundary. */
+export declare function createBrowserRefFrameGuard(controller: NativeCdpController, input: {
+    frameId?: string;
+    runtime: Pick<BrowserRuntime, "getConfig">;
+    approvedByConfirmation: boolean;
+    signal?: AbortSignal;
+}): NativeCdpController;

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

@@ -13,9 +13,9 @@ export declare const BrowserElementRefTargetSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     x: number;
     y: number;
-    ref: string;
     role: string;
     name: string;
+    ref: string;
     disabled: boolean;
     resolvedBy: "backend_node_id" | "role_name_nth";
     backendNodeId?: number | undefined;
@@ -23,9 +23,9 @@ export declare const BrowserElementRefTargetSchema: z.ZodObject<{
 }, {
     x: number;
     y: number;
-    ref: string;
     role: string;
     name: string;
+    ref: string;
     disabled: boolean;
     resolvedBy: "backend_node_id" | "role_name_nth";
     backendNodeId?: number | undefined;
@@ -48,9 +48,9 @@ export declare const BrowserElementRefActionOutputSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         x: number;
         y: number;
-        ref: string;
         role: string;
         name: string;
+        ref: string;
         disabled: boolean;
         resolvedBy: "backend_node_id" | "role_name_nth";
         backendNodeId?: number | undefined;
@@ -58,9 +58,9 @@ export declare const BrowserElementRefActionOutputSchema: z.ZodObject<{
     }, {
         x: number;
         y: number;
-        ref: string;
         role: string;
         name: string;
+        ref: string;
         disabled: boolean;
         resolvedBy: "backend_node_id" | "role_name_nth";
         backendNodeId?: number | undefined;
@@ -71,9 +71,9 @@ export declare const BrowserElementRefActionOutputSchema: z.ZodObject<{
     target: {
         x: number;
         y: number;
-        ref: string;
         role: string;
         name: string;
+        ref: string;
         disabled: boolean;
         resolvedBy: "backend_node_id" | "role_name_nth";
         backendNodeId?: number | undefined;
@@ -86,9 +86,9 @@ export declare const BrowserElementRefActionOutputSchema: z.ZodObject<{
     target: {
         x: number;
         y: number;
-        ref: string;
         role: string;
         name: string;
+        ref: string;
         disabled: boolean;
         resolvedBy: "backend_node_id" | "role_name_nth";
         backendNodeId?: number | undefined;

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

@@ -1,6 +1,6 @@
-import { type BrowserAxNode } from "@roll-agent/browser";
 export declare const browserSnapshot: import("@roll-agent/sdk").ToolDefinition<{
     pageId?: string | undefined;
+    scope?: string | undefined;
     maxNodes?: number | undefined;
     interactiveOnly?: boolean | undefined;
     maxDepth?: number | undefined;
@@ -15,19 +15,38 @@ export declare const browserSnapshot: import("@roll-agent/sdk").ToolDefinition<{
     };
     snapshot: {
         truncated: boolean;
-        nodes: BrowserAxNode[];
+        nodes: import("@roll-agent/browser").BrowserAxNode[];
         refs: {
-            ref: string;
             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;
         }[];
         nodeCount: number;
         maxNodes: number;
         interactiveOnly: boolean;
+        browserInstance?: string | undefined;
+        pageId?: string | undefined;
+        scope?: string | undefined;
+        snapshotId?: string | undefined;
+        documentId?: string | undefined;
+        coverageWarnings?: string[] | undefined;
         maxDepth?: number | undefined;
     };
 }>;