@roll-agent/browser-use-agent 0.10.0 → 0.11.0

package/dist/pages/platform-page.d.ts

@@ -1,7 +1,7 @@
-import type { BrowserContextManager, BrowserInspectablePage, BrowserRuntime, Page, Platform } from "@roll-agent/browser";
+import type { BrowserContextManager, BrowserInspectablePage, BrowserRuntime, BrowserActionPolicyOptions, Page, Platform } from "@roll-agent/browser";
 export declare function findTrackedPlatformPage(ctxManager: BrowserContextManager, platform: Platform): Promise<Page | undefined>;
 export declare function findOpenPlatformTarget(runtime: BrowserRuntime, platform: Platform): Promise<BrowserInspectablePage | undefined>;
-export declare function openPlatformHomeTarget(runtime: BrowserRuntime, platform: Platform): Promise<{
+export declare function openPlatformHomeTarget(runtime: BrowserRuntime, platform: Platform, options?: BrowserActionPolicyOptions): Promise<{
     page: BrowserInspectablePage;
     reusedExistingPage: boolean;
 }>;

package/dist/pages/yupao/chat.d.ts

@@ -1,6 +1,6 @@
-import type { Page } from "@roll-agent/browser";
+import { type BrowserActionPolicyOptions, type Page } from "@roll-agent/browser";
 /** 在指定对话中发送回复消息 */
-export declare function sendReply(page: Page, conversationId: string, message: string): Promise<{
+export declare function sendReply(page: Page, conversationId: string, message: string, options?: BrowserActionPolicyOptions): Promise<{
     success: boolean;
     error?: string;
 }>;

package/dist/pages/yupao/navigation.d.ts

@@ -1,9 +1,9 @@
-import type { Page } from "@roll-agent/browser";
+import { type BrowserActionPolicyOptions, type Page } from "@roll-agent/browser";
 /** 导航到消息列表页 */
-export declare function ensureOnMessageList(page: Page): Promise<void>;
+export declare function ensureOnMessageList(page: Page, options?: BrowserActionPolicyOptions): Promise<void>;
 /** 导航到登录页 */
-export declare function goToLoginPage(page: Page): Promise<void>;
+export declare function goToLoginPage(page: Page, options?: BrowserActionPolicyOptions): Promise<void>;
 /** 导航到指定对话 */
-export declare function goToConversation(page: Page, conversationId: string): Promise<void>;
+export declare function goToConversation(page: Page, conversationId: string, options?: BrowserActionPolicyOptions): Promise<void>;
 /** 检测是否已登录 */
 export declare function isLoggedIn(page: Page): Promise<boolean>;

package/dist/reply-authority/prepared-reply-store.d.ts

@@ -14,6 +14,8 @@ export type PreparedReplyConsumeResult = {
     readonly ok: false;
     readonly reason: "not_found" | "expired" | "consumed";
 };
+export type PreparedReplyInspectResult = PreparedReplyConsumeResult;
 export declare function savePreparedReply(input: Omit<PreparedReplyRecord, "preparedReplyId">, nowSeconds?: number): PreparedReplyRecord;
 export declare function consumePreparedReply(preparedReplyId: string, nowSeconds?: number): PreparedReplyConsumeResult;
+export declare function inspectPreparedReply(preparedReplyId: string, nowSeconds?: number): PreparedReplyInspectResult;
 export declare function resetPreparedReplyStoreForTests(): void;

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

@@ -47,6 +47,7 @@ export declare const ReplyAuthorityEnvelopePayloadSchema: z.ZodObject<{
     platform: "zhipin";
     conversationId: string;
     candidateId: string;
+    reply: string;
     tenantId: string;
     recruiterBinding: {
         platform: "zhipin";
@@ -60,12 +61,12 @@ export declare const ReplyAuthorityEnvelopePayloadSchema: z.ZodObject<{
     iat: number;
     exp: number;
     aud: "browser-use-agent/zhipin_send_reply";
-    reply: string;
     policyVersion: string;
 }, {
     platform: "zhipin";
     conversationId: string;
     candidateId: string;
+    reply: string;
     tenantId: string;
     recruiterBinding: {
         platform: "zhipin";
@@ -79,7 +80,6 @@ export declare const ReplyAuthorityEnvelopePayloadSchema: z.ZodObject<{
     iat: number;
     exp: number;
     aud: "browser-use-agent/zhipin_send_reply";
-    reply: string;
     policyVersion: string;
 }>;
 export declare const ReplyAuthorityPublicKeySchema: z.ZodObject<{

package/dist/runtime-config.d.ts

@@ -0,0 +1,2 @@
+import type { BrowserRuntimeConfig } from "@roll-agent/browser";
+export declare function loadRuntimeConfigFromEnv(env?: NodeJS.ProcessEnv): BrowserRuntimeConfig;

package/dist/tool-action-approval.d.ts

@@ -0,0 +1,35 @@
+import { z } from "zod";
+export declare const ToolActionApprovalSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export type ToolActionApproval = z.infer<typeof ToolActionApprovalSchema>;
+export type ToolActionApprovalSubject = {
+    readonly tool: string;
+    readonly target: string;
+    readonly digest: string;
+    readonly summary?: string;
+};
+export type ToolActionApprovalRequest = {
+    readonly id: string;
+    readonly expiresAt: string;
+    readonly tool: string;
+    readonly target: string;
+    readonly summary?: string;
+    readonly retryInput: {
+        readonly toolActionApproval: ToolActionApproval;
+    };
+};
+export declare function createToolActionApprovalRequest(subject: ToolActionApprovalSubject, ttlMs: number, nowMs?: number): ToolActionApprovalRequest;
+export declare function approveToolAction(input: {
+    readonly approval: ToolActionApproval;
+    readonly subject: ToolActionApprovalSubject;
+}): boolean;
+export declare function isToolActionApprovalValid(input: {
+    readonly approval: ToolActionApproval;
+    readonly subject: ToolActionApprovalSubject;
+}): boolean;
+export declare function resetToolActionApprovalsForTests(): void;

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

@@ -1,17 +1,33 @@
 export declare const browserStatus: import("@roll-agent/sdk").ToolDefinition<{}, {
-    running: boolean;
-    headless: boolean;
     mode: "managed-cdp" | "remote-cdp" | "existing-session";
+    headless: boolean;
+    security: {
+        domainAllowlist?: string[] | undefined;
+        maxPageContentBytes?: number | undefined;
+        maxSnapshotNodes?: number | undefined;
+        actionPolicy?: "log" | "deny" | "confirm" | undefined;
+    };
+    running: boolean;
     activeSessions: {
         platform: "zhipin" | "yupao";
         pagesOpen: number;
         hasLoginState: boolean | null;
-        loginStateSource: "none" | "unknown" | "snapshot" | "profile";
+        loginStateSource: "snapshot" | "profile" | "none" | "unknown";
         currentUrl?: string | undefined;
     }[];
     replyAuthorityKeysLoaded: boolean;
     visualCursorEnabled: boolean;
     visualActivityEnabled: boolean;
+    toolPolicy: {
+        tools?: Record<string, {
+            policy: "log" | "deny" | "confirm";
+        }> | undefined;
+        approvalTtlMs?: number | undefined;
+    };
+    policyWarnings: {
+        code: "unknown_tool_policy" | "double_confirmation" | "browser_action_policy_not_recommended";
+        message: string;
+    }[];
     effectiveEnvSources: Record<string, {
         present: boolean;
         fingerprint?: string | undefined;

package/dist/tools/list-pages.d.ts

@@ -2,9 +2,9 @@ export declare const listPages: import("@roll-agent/sdk").ToolDefinition<{
     platform?: "zhipin" | "yupao" | undefined;
 }, {
     pages: {
+        pageId: string;
         url: string;
         title: string;
-        pageId: string;
         boundPlatform: "zhipin" | "yupao" | null;
         detectedPlatform: "zhipin" | "yupao" | null;
         isSelectedForPlatform: boolean;

package/dist/tools/navigate-active-tab.d.ts

@@ -13,12 +13,15 @@ type NavigateActiveTabDeps = {
 export declare function setNavigateActiveTabDepsForTests(override: Partial<NavigateActiveTabDeps> | undefined): void;
 export declare const navigateActiveTab: import("@roll-agent/sdk").ToolDefinition<{
     url: string;
+    browserActionApproval?: {
+        id: string;
+    } | undefined;
 }, {
     success: boolean;
     page: {
+        pageId: string;
         url: string;
         title: string;
-        pageId: string;
         boundPlatform: "zhipin" | "yupao" | null;
         detectedPlatform: "zhipin" | "yupao" | null;
         isSelectedForPlatform: boolean;

package/dist/tools/open-platform.d.ts

@@ -1,11 +1,14 @@
 export declare const openPlatform: import("@roll-agent/sdk").ToolDefinition<{
     platform: "zhipin" | "yupao";
+    browserActionApproval?: {
+        id: string;
+    } | undefined;
 }, {
     success: boolean;
     page: {
+        pageId: string;
         url: string;
         title: string;
-        pageId: string;
         boundPlatform: "zhipin" | "yupao" | null;
         detectedPlatform: "zhipin" | "yupao" | null;
         isSelectedForPlatform: boolean;

package/dist/tools/select-page.d.ts

@@ -4,9 +4,9 @@ export declare const selectPage: import("@roll-agent/sdk").ToolDefinition<{
 }, {
     success: boolean;
     page: {
+        pageId: string;
         url: string;
         title: string;
-        pageId: string;
         boundPlatform: "zhipin" | "yupao" | null;
         detectedPlatform: "zhipin" | "yupao" | null;
         isSelectedForPlatform: boolean;

package/dist/tools/yupao-send-reply.d.ts

@@ -1,6 +1,9 @@
 export declare const yupaoSendReply: import("@roll-agent/sdk").ToolDefinition<{
     message: string;
     conversationId: string;
+    browserActionApproval?: {
+        id: string;
+    } | undefined;
 }, {
     success: boolean;
     conversationId: string;

package/dist/tools/zhipin-diagnose-browser-state.d.ts

@@ -16,7 +16,7 @@ declare const StorageEntrySummarySchema: z.ZodObject<{
     area: "localStorage" | "sessionStorage";
     valueLength: number;
     valueKind: "string" | "empty" | "json";
-    jsonKind?: "string" | "number" | "boolean" | "object" | "array" | "null" | undefined;
+    jsonKind?: "string" | "number" | "boolean" | "object" | "null" | "array" | undefined;
     jsonTopLevelKeys?: string[] | undefined;
     jsonArrayLength?: number | undefined;
     numericFields?: Record<string, number> | undefined;
@@ -27,7 +27,7 @@ declare const StorageEntrySummarySchema: z.ZodObject<{
     area: "localStorage" | "sessionStorage";
     valueLength: number;
     valueKind: "string" | "empty" | "json";
-    jsonKind?: "string" | "number" | "boolean" | "object" | "array" | "null" | undefined;
+    jsonKind?: "string" | "number" | "boolean" | "object" | "null" | "array" | undefined;
     jsonTopLevelKeys?: string[] | undefined;
     jsonArrayLength?: number | undefined;
     numericFields?: Record<string, number> | undefined;
@@ -172,9 +172,9 @@ export declare const zhipinDiagnoseBrowserState: import("@roll-agent/sdk").ToolD
     success: boolean;
     requestedPhase: "native" | "native-watch" | "native-ws-connect" | "native-page-bring-front" | "native-evaluate-url-no-runtime-enable" | "native-dom-read-no-runtime-enable" | "native-input-move-no-runtime-enable" | "native-runtime-enable" | "native-evaluate-url" | "native-dom-read" | "browser-attach" | "page-attach" | "network-watch" | "page-evaluate" | "detector-fingerprint" | "storage-summary";
     nativePages: {
+        pageId: string;
         url: string;
         title: string;
-        pageId: string;
         boundPlatform: "zhipin" | "yupao" | null;
         detectedPlatform: "zhipin" | "yupao" | null;
         isSelectedForPlatform: boolean;
@@ -189,9 +189,9 @@ export declare const zhipinDiagnoseBrowserState: import("@roll-agent/sdk").ToolD
         titleChangedFromPrevious: boolean;
         currentUrl?: string | undefined;
         page?: {
+            pageId: string;
             url: string;
             title: string;
-            pageId: string;
             boundPlatform: "zhipin" | "yupao" | null;
             detectedPlatform: "zhipin" | "yupao" | null;
             isSelectedForPlatform: boolean;
@@ -214,9 +214,9 @@ export declare const zhipinDiagnoseBrowserState: import("@roll-agent/sdk").ToolD
         hasFocus: boolean;
     } | undefined;
     targetPage?: {
+        pageId: string;
         url: string;
         title: string;
-        pageId: string;
         boundPlatform: "zhipin" | "yupao" | null;
         detectedPlatform: "zhipin" | "yupao" | null;
         isSelectedForPlatform: boolean;
@@ -288,7 +288,7 @@ export declare const zhipinDiagnoseBrowserState: import("@roll-agent/sdk").ToolD
             area: "localStorage" | "sessionStorage";
             valueLength: number;
             valueKind: "string" | "empty" | "json";
-            jsonKind?: "string" | "number" | "boolean" | "object" | "array" | "null" | undefined;
+            jsonKind?: "string" | "number" | "boolean" | "object" | "null" | "array" | undefined;
             jsonTopLevelKeys?: string[] | undefined;
             jsonArrayLength?: number | undefined;
             numericFields?: Record<string, number> | undefined;
@@ -300,7 +300,7 @@ export declare const zhipinDiagnoseBrowserState: import("@roll-agent/sdk").ToolD
             area: "localStorage" | "sessionStorage";
             valueLength: number;
             valueKind: "string" | "empty" | "json";
-            jsonKind?: "string" | "number" | "boolean" | "object" | "array" | "null" | undefined;
+            jsonKind?: "string" | "number" | "boolean" | "object" | "null" | "array" | undefined;
             jsonTopLevelKeys?: string[] | undefined;
             jsonArrayLength?: number | undefined;
             numericFields?: Record<string, number> | undefined;

package/dist/tools/zhipin-generate-reply-preview.d.ts

@@ -19,6 +19,11 @@ export declare const zhipinGenerateReplyPreview: import("@roll-agent/sdk").ToolD
     conversationId?: string | undefined;
     candidateName?: string | undefined;
     maxMessages?: number | undefined;
+    reasoning?: {
+        enabled: boolean;
+        effort?: "high" | "low" | "medium" | undefined;
+        scope?: "all" | "reply" | undefined;
+    } | undefined;
 }, {
     success: boolean;
     error?: string | undefined;

package/dist/tools/zhipin-get-candidate-info.d.ts

@@ -34,9 +34,9 @@ export declare const zhipinGetCandidateInfo: import("@roll-agent/sdk").ToolDefin
         systemMessages: number;
     };
     chatMessages: {
+        index: number;
         time: string;
         content: string;
-        index: number;
         sender: "candidate" | "recruiter" | "system";
         messageType: "text" | "resume" | "system" | "wechat-exchange";
     }[];

package/dist/tools/zhipin-get-candidate-list.d.ts

@@ -14,8 +14,8 @@ export declare const zhipinGetCandidateList: import("@roll-agent/sdk").ToolDefin
 }, {
     success: boolean;
     candidates: {
-        name: string;
         index: number;
+        name: string;
         candidateId: string;
         age: string;
         experience: string;

package/dist/tools/zhipin-open-chat-page.d.ts

@@ -16,9 +16,9 @@ export declare const zhipinOpenChatPage: import("@roll-agent/sdk").ToolDefinitio
     chatReady: boolean;
     error?: string | undefined;
     page?: {
+        pageId: string;
         url: string;
         title: string;
-        pageId: string;
         boundPlatform: "zhipin" | "yupao" | null;
         detectedPlatform: "zhipin" | "yupao" | null;
         isSelectedForPlatform: boolean;

package/dist/tools/zhipin-open-recommend-page.d.ts

@@ -16,9 +16,9 @@ export declare const zhipinOpenRecommendPage: import("@roll-agent/sdk").ToolDefi
     recommendReady: boolean;
     error?: string | undefined;
     page?: {
+        pageId: string;
         url: string;
         title: string;
-        pageId: string;
         boundPlatform: "zhipin" | "yupao" | null;
         detectedPlatform: "zhipin" | "yupao" | null;
         isSelectedForPlatform: boolean;

package/dist/tools/zhipin-send-prepared-reply.d.ts

@@ -1,7 +1,19 @@
+import { sendSignedZhipinReply } from "./zhipin-send-reply.ts";
+type ZhipinSendPreparedReplyDeps = {
+    readonly sendSignedZhipinReply: typeof sendSignedZhipinReply;
+};
+export declare function setZhipinSendPreparedReplyDepsForTests(override: Partial<ZhipinSendPreparedReplyDeps> | undefined): void;
 export declare const zhipinSendPreparedReply: import("@roll-agent/sdk").ToolDefinition<{
     preparedReplyId: string;
+    browserActionApproval?: {
+        id: string;
+    } | undefined;
+    toolActionApproval?: {
+        id: string;
+    } | undefined;
 }, {
     success: boolean;
     sentMessage: string;
     error?: string | undefined;
 }>;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roll-agent/browser-use-agent",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -45,9 +45,9 @@
   },
   "dependencies": {
     "zod": "^3.25.76",
-    "@roll-agent/reply-authority-client": "0.1.1",
-    "@roll-agent/sdk": "0.1.6",
-    "@roll-agent/browser": "0.3.1"
+    "@roll-agent/reply-authority-client": "0.1.2",
+    "@roll-agent/sdk": "0.2.0",
+    "@roll-agent/browser": "0.4.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"

package/references/env.yaml

@@ -23,6 +23,14 @@ optional:
     purpose: 招聘事件 Open API base URL；工具成功后会调用 `/api/v1/recruitment-events`
     default: https://huajune.duliday.com
     example: https://example.com
+  - name: BROWSER_SECURITY_JSON
+    purpose: 浏览器安全策略 JSON；可配置 domainAllowlist、maxPageContentBytes、maxSnapshotNodes、actionPolicy
+    default: '{"domainAllowlist":[],"maxPageContentBytes":102400,"maxSnapshotNodes":500,"actionPolicy":"log"}'
+    example: '{"domainAllowlist":["zhipin.com"],"maxPageContentBytes":102400,"maxSnapshotNodes":500,"actionPolicy":"log"}'
+  - name: BROWSER_USE_POLICY_JSON
+    purpose: browser-use 工具级业务策略 JSON；可按 exact tool name 配置 log、deny、confirm
+    default: '{"approvalTtlMs":300000,"tools":{}}'
+    example: '{"approvalTtlMs":300000,"tools":{"zhipin_send_prepared_reply":{"policy":"confirm"}}}'
   - name: BROWSER_VISUAL_CURSOR
     purpose: 在可见浏览器页面内显示 browser-use 的页内虚拟指针和点击波纹；默认开启，设为 `"false"` 可关闭
     default: "true"