@roll-agent/browser-use-agent 0.22.0 → 0.22.2

package/dist/pages/zhipin/native-page.d.ts

@@ -202,6 +202,9 @@ export declare class ZhipinNativePagePort {
     reload(options: ZhipinNativeReloadOptions): Promise<void>;
     isChatSurfaceOpen(): Promise<boolean>;
     waitForChatSurface(timeoutMs?: number): Promise<boolean>;
+    waitForChatListReady(options?: {
+        readonly expectedConversationId?: string;
+    }, timeoutMs?: number): Promise<boolean>;
     isRecommendSurfaceOpen(): Promise<boolean>;
     waitForRecommendSurface(timeoutMs?: number): Promise<boolean>;
     private resolveRecommendFrameContextId;

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

@@ -15,6 +15,7 @@ export declare const zhipinOpenChatPage: import("@roll-agent/sdk").ToolDefinitio
         id: string;
     } | undefined;
     forceReload?: boolean | undefined;
+    expectedConversationId?: string | undefined;
 }, {
     success: boolean;
     alreadyOnChat: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roll-agent/browser-use-agent",
-  "version": "0.22.0",
+  "version": "0.22.2",
   "type": "module",
   "repository": {
     "type": "git",
@@ -47,7 +47,7 @@
     "zod": "^3.25.76",
     "@roll-agent/reply-authority-client": "0.5.0",
     "@roll-agent/sdk": "0.3.0",
-    "@roll-agent/browser": "0.9.0"
+    "@roll-agent/browser": "0.9.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"

package/references/env.yaml

@@ -1,47 +1,71 @@
 required:
   - name: REPLY_AUTHORITY_URL
+    secret: false
+    type: url
     purpose: Reply Authority Service API base URL；`zhipin_generate_reply_preview` 使用 SSE 直接生成并展示回复
     example: https://reply-authority.duliday.com
   - name: REPLY_AUTHORITY_BEARER_TOKEN
+    secret: true
     purpose: 调用 Reply Authority Service `POST /generate-signed-reply` 的 Bearer token；只用于生成 prepared reply，不会返回给 orchestrator
     example: token_xxx
   - name: REPLY_AUTHORITY_KEYS_URL
+    secret: false
+    type: url
     purpose: Reply Authority Service 公钥分发端点；`zhipin_send_prepared_reply` 启动预热和本地 Ed25519 验签都依赖它
     example: https://reply-authority.duliday.com/.well-known/reply-authority-keys
   - name: RECRUITMENT_EVENTS_DEFAULT_AGENT_ID
+    secret: false
     purpose: 单 browser-use 实例 / 单 Boss 账号部署下的默认招聘业务 Agent ID；多 browser.instances 下仅作为实例缺少 trackingAgentId 时的 fallback；招聘事件默认启用，上报时必须有可解析归因
     example: zhipin-shanghai-kfc-001
   - name: RECRUITMENT_EVENTS_API_TOKEN
+    secret: true
     purpose: 招聘事件 Open API Bearer token；公开 npm 包不内置兜底 token，必须由部署环境提供
     example: token_xxx
 optional:
   - name: RECRUITMENT_EVENTS_ENABLED
+    secret: false
+    type: boolean
     purpose: 是否启用招聘事件埋点上报；未设置时默认启用，设为 `"false"` 可关闭
     default: "true"
     example: "false"
   - name: RECRUITMENT_EVENTS_API_BASE_URL
+    secret: false
+    type: url
     purpose: 招聘事件 Open API base URL；工具成功后会调用 `/api/v1/recruitment-events`
     default: https://huajune.duliday.com
     example: https://example.com
   - name: BROWSER_SECURITY_JSON
+    secret: false
+    type: json
     purpose: 浏览器安全策略 JSON；可配置 domainAllowlist、maxPageContentBytes、maxSnapshotNodes、actionPolicy、foregroundPolicy；foregroundPolicy 默认 when-minimized，无需显式配置
     default: '{"domainAllowlist":[],"maxPageContentBytes":102400,"maxSnapshotNodes":500,"actionPolicy":"log","foregroundPolicy":"when-minimized"}'
     example: '{"domainAllowlist":["zhipin.com"],"maxPageContentBytes":102400,"maxSnapshotNodes":500,"actionPolicy":"log","foregroundPolicy":"when-minimized"}'
   - name: BROWSER_USE_POLICY_JSON
+    secret: false
+    type: 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_PROFILE_COLOR
+    secret: false
     purpose: legacy 单浏览器运行时的 Chrome profile 颜色，格式为 `#RRGGBB`；配置了 `browser.instances` 时由每个实例的 profileColor 接管，此 env 会被忽略
     example: "#2563EB"
   - name: BROWSER_INSTANCES_JSON
+    secret: false
+    type: json
+    configurable: false
+    sourcePath: [browser, instances]
     purpose: Roll core 注入的多浏览器实例声明 JSON；由 `browser.instances` 派生，包含每个实例的 profile、CDP 端口、session 目录、可选 profileName/profileColor/windowBounds 和招聘事件归因 ID；orchestrator 不应手工拼接，手工配置时必须保持 cdpPort/userDataDir 唯一
     example: '{"defaultInstance":"boss-a","instances":{"boss-a":{"platform":"zhipin","mode":"managed-cdp","cdpPort":9222,"userDataDir":"/tmp/roll-browser/profiles/boss-a","profileName":"boss-a","profileColor":"#2563EB","windowBounds":{"x":0,"y":0,"width":680,"height":1000},"trackingAgentId":"zhipin-boss-a"}}}'
   - name: BROWSER_VISUAL_CURSOR
+    secret: false
+    type: boolean
     purpose: 在可见浏览器页面内显示 browser-use 的页内虚拟指针和点击波纹；默认开启，设为 `"false"` 可关闭
     default: "true"
     example: "false"
   - name: BROWSER_VISUAL_ACTIVITY
+    secret: false
+    type: boolean
     purpose: 在消息读取、账号识别、聊天详情提取等非点击型操作期间显示页内状态胶囊、区域柔光和完成态反馈；默认开启，设为 `"false"` 可关闭
     default: "true"
     example: "true"