@roll-agent/browser-use-agent 0.18.0 → 0.20.0

package/dist/pages/zhipin/job-signals.d.ts

@@ -1,5 +1,4 @@
-import type { AgentLLM, AgentLogger } from "@roll-agent/sdk";
-import { type CandidateLocationSignal } from "@roll-agent/reply-authority-client";
+import type { CandidateLocationSignal } from "@roll-agent/reply-authority-client";
 export declare const LocationSignalAnalysisPathValues: readonly ["llm", "fallback", "profile_only", "speculative", "none"];
 export type LocationSignalAnalysisPath = (typeof LocationSignalAnalysisPathValues)[number];
 export declare const LocationSignalInquiryTypeValues: readonly ["location_inquiry", "non_location_inquiry"];
@@ -9,37 +8,13 @@ export type LocationSignalResolution = {
     readonly analysisPath: LocationSignalAnalysisPath;
     readonly inquiryType?: LocationSignalInquiryType;
 };
-export type LocationSignalMessage = {
-    readonly index: number;
-    readonly sender: "candidate" | "recruiter" | "system";
-    readonly content: string;
-};
-type LocationSignalEvidenceInput = {
-    readonly latestCandidateMessage: string;
-    readonly recentMessages: readonly LocationSignalMessage[];
-    readonly expectedLocation: string;
-    readonly communicationPosition: string;
-};
-type ResolveLocationSignalsInput = {
-    readonly llm: AgentLLM;
-    readonly logger?: Pick<AgentLogger, "warn"> | undefined;
-    readonly messages: readonly LocationSignalMessage[];
-    readonly expectedLocation: string;
-    readonly communicationPosition: string;
-    readonly timeoutMs?: number | undefined;
-};
-export declare function resolveLocationSignalsFromLlmText(input: LocationSignalEvidenceInput & {
-    readonly llmText: string;
-}): CandidateLocationSignal[];
-export declare function resolveLocationSignals(input: ResolveLocationSignalsInput): Promise<LocationSignalResolution>;
-export declare function clearLocationSignalResolutionCacheForTest(): void;
-export declare function resolveLocationSignalsWithLlm(input: ResolveLocationSignalsInput): Promise<CandidateLocationSignal[]>;
+export declare function formatLocationSignalsVisualLabel(resolution: LocationSignalResolution | readonly CandidateLocationSignal[]): string;
+export declare function resolvePreferredBrandId(communicationPosition: string): number | undefined;
 export declare function resolvePreferredBrand(communicationPosition: string): string | undefined;
 export declare function resolveExpectedSignals(expectedJobText: string): {
     expectedLocation: string;
     expectedPosition: string;
 };
-export declare function formatLocationSignalsVisualLabel(resolution: LocationSignalResolution | readonly CandidateLocationSignal[]): string;
 export declare function resolveConversationSignals(input: {
     communicationPosition: string;
     expectedJobText: string;
@@ -48,5 +23,5 @@ export declare function resolveConversationSignals(input: {
     expectedLocation: string;
     expectedPosition: string;
     preferredBrand?: string;
+    preferredBrandId?: number;
 };
-export {};

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

@@ -87,6 +87,12 @@ export type NativeCandidateChatDetails = {
     readonly candidateInfo: NativeCandidateInfo;
     readonly messages: readonly NativeChatMessage[];
 };
+export type NativeCandidateProfileSummary = {
+    readonly age: string;
+    readonly experience: string;
+    readonly education: string;
+};
+export declare function parseZhipinCandidateProfileTokens(rawTexts: readonly string[]): NativeCandidateProfileSummary;
 export type NativeRecommendCardInspection = {
     readonly found: boolean;
     readonly cardSelector: string;

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

@@ -1,3 +1,30 @@
+import type { ReplyGateAdvisoryCode, ReplyVariantKind } from "@roll-agent/reply-authority-client";
+export declare const PreparedReplyOptionValues: readonly ["option_1", "option_2"];
+export type PreparedReplyOption = (typeof PreparedReplyOptionValues)[number];
+export type PreparedReplyVariantOption = {
+    readonly option: PreparedReplyOption;
+    readonly variant: ReplyVariantKind;
+    readonly suggestedReply: string;
+    readonly signedEnvelope: string;
+    readonly envelopeExp: number;
+};
+export type PreparedReplyVariantFinding = {
+    readonly code: ReplyGateAdvisoryCode;
+    readonly description: string;
+};
+export type PreparedReplyVariantGroup = {
+    readonly groupId: string;
+    readonly options: readonly PreparedReplyVariantOption[];
+    readonly findings: readonly PreparedReplyVariantFinding[];
+    readonly rubricVersion: string;
+    readonly rubricHash: string;
+    readonly target: {
+        readonly platform: "zhipin";
+        readonly tenantId: string;
+        readonly conversationId: string;
+    };
+    readonly recommendedOption: PreparedReplyOption;
+};
 export type PreparedReplyRecord = {
     readonly preparedReplyId: string;
     readonly signedEnvelope: string;
@@ -7,6 +34,7 @@ export type PreparedReplyRecord = {
     readonly expiresAt: number;
     readonly requestId?: string;
     readonly unreadCountBeforeReply?: number;
+    readonly variantGroup?: PreparedReplyVariantGroup;
 };
 export type PreparedReplyConsumeResult = {
     readonly ok: true;

package/dist/reply-authority/reply-preview-visual.d.ts

@@ -1,13 +1,25 @@
 type NativePreviewTarget = {
     evaluateJson<T = unknown>(expression: string): Promise<T>;
 };
+export interface NativeReplyPreviewVariantOption {
+    readonly option: string;
+    readonly suggestedReply: string;
+}
+export interface NativeReplyPreviewFinding {
+    readonly code: string;
+    readonly description: string;
+}
+export interface NativeReplyPreviewVariantSelection {
+    readonly options: readonly NativeReplyPreviewVariantOption[];
+    readonly findings: readonly NativeReplyPreviewFinding[];
+}
 export declare class NativeReplyPreviewVisualSession {
     private readonly target;
     constructor(target: NativePreviewTarget);
     begin(label: string, locationSummary?: string): Promise<boolean>;
     updateStatus(label: string): Promise<boolean>;
     updateDraft(draftText: string, provisional: boolean): Promise<boolean>;
-    complete(label: string, finalReply: string): Promise<boolean>;
+    complete(label: string, finalReply: string, variantSelection?: NativeReplyPreviewVariantSelection): Promise<boolean>;
     fail(label: string): Promise<boolean>;
     clear(): Promise<boolean>;
     private render;

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

@@ -1,4 +1,4 @@
-import { streamGenerateSignedReply } from "@roll-agent/reply-authority-client";
+import { fetchReplyFeedbackRubric, streamGenerateSignedReply } from "@roll-agent/reply-authority-client";
 import { NativeVisualActivitySession } from "../native-visual-activity-session.ts";
 import { openZhipinNativePagePort } from "../pages/zhipin/native-page.ts";
 import type { ZhipinNativePagePort } from "../pages/zhipin/native-page.ts";
@@ -11,7 +11,9 @@ type ZhipinGenerateReplyPreviewDeps = {
     readonly createNativeVisualActivitySession: (page: ZhipinNativePagePort) => NativeVisualActivitySessionLike;
     readonly createReplyPreviewVisualSession: (page: ZhipinNativePagePort) => ReplyPreviewVisualSessionLike;
     readonly streamGenerateSignedReply: typeof streamGenerateSignedReply;
+    readonly fetchReplyFeedbackRubric: typeof fetchReplyFeedbackRubric;
     readonly savePreparedReply: typeof savePreparedReply;
+    readonly random: () => number;
 };
 export declare function setZhipinGenerateReplyPreviewDepsForTests(override: Partial<ZhipinGenerateReplyPreviewDeps> | undefined): void;
 export declare const zhipinGenerateReplyPreview: import("@roll-agent/sdk").ToolDefinition<{
@@ -41,5 +43,20 @@ export declare const zhipinGenerateReplyPreview: import("@roll-agent/sdk").ToolD
         contextBuildingLatencyMs?: number | undefined;
     } | undefined;
     gateRewritten?: boolean | undefined;
+    replyVariantSelection?: {
+        options: {
+            option: "option_1" | "option_2";
+            expiresAt: number;
+            suggestedReply: string;
+        }[];
+        groupId: string;
+        findings: {
+            code: string;
+            description: string;
+        }[];
+        rubricVersion: string;
+        rubricHash: string;
+    } | undefined;
+    errorKind?: "timeout" | "rejected" | "server_error" | undefined;
 }>;
 export {};

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

@@ -22,8 +22,8 @@ export declare const zhipinGetCandidateInfo: import("@roll-agent/sdk").ToolDefin
     candidateInfo: {
         name: string;
         age: string;
-        experience: string;
         education: string;
+        experience: string;
         expectedLocation: string;
         expectedPosition: string;
         expectedSalary: string;
@@ -53,5 +53,6 @@ export declare const zhipinGetCandidateInfo: import("@roll-agent/sdk").ToolDefin
     formattedHistory: string[];
     error?: string | undefined;
     preferredBrand?: string | undefined;
+    preferredBrandId?: number | undefined;
 }>;
 export {};

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

@@ -18,8 +18,8 @@ export declare const zhipinGetCandidateList: import("@roll-agent/sdk").ToolDefin
         index: number;
         candidateId: string;
         age: string;
-        experience: string;
         education: string;
+        experience: string;
         workStatus: string;
         company: string;
         currentPosition: string;

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

@@ -0,0 +1,21 @@
+import { fetchReplyFeedbackRubric } from "@roll-agent/reply-authority-client";
+type ZhipinJudgePreparedReplyDeps = {
+    readonly fetchReplyFeedbackRubric: typeof fetchReplyFeedbackRubric;
+};
+export declare function setZhipinJudgePreparedReplyDepsForTests(override: Partial<ZhipinJudgePreparedReplyDeps> | undefined): void;
+export declare const zhipinJudgePreparedReply: import("@roll-agent/sdk").ToolDefinition<{
+    preparedReplyId: string;
+    judgeModel?: string | undefined;
+}, {
+    success: boolean;
+    error?: string | undefined;
+    fallback?: boolean | undefined;
+    recommendedOption?: "option_1" | "option_2" | undefined;
+    variantDecision?: {
+        reason: string;
+        chosenOption: "option_1" | "option_2";
+        confirmedFindingCodes?: ("too_many_questions" | "audit_tone" | "reply_overpacked" | "off_axis_fact_disclosure")[] | undefined;
+        judgeModel?: string | undefined;
+    } | undefined;
+}>;
+export {};

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

@@ -1,6 +1,8 @@
+import { postReplyFeedback } from "@roll-agent/reply-authority-client";
 import { sendSignedZhipinReply } from "./zhipin-send-reply.ts";
 type ZhipinSendPreparedReplyDeps = {
     readonly sendSignedZhipinReply: typeof sendSignedZhipinReply;
+    readonly postReplyFeedback: typeof postReplyFeedback;
 };
 export declare function setZhipinSendPreparedReplyDepsForTests(override: Partial<ZhipinSendPreparedReplyDeps> | undefined): void;
 export declare const zhipinSendPreparedReply: import("@roll-agent/sdk").ToolDefinition<{
@@ -8,6 +10,12 @@ export declare const zhipinSendPreparedReply: import("@roll-agent/sdk").ToolDefi
     browserActionApproval?: {
         id: string;
     } | undefined;
+    variantDecision?: {
+        reason: string;
+        chosenOption: "option_1" | "option_2";
+        confirmedFindingCodes?: ("too_many_questions" | "audit_tone" | "reply_overpacked" | "off_axis_fact_disclosure")[] | undefined;
+        judgeModel?: string | undefined;
+    } | undefined;
     toolActionApproval?: {
         id: string;
     } | undefined;
@@ -15,5 +23,7 @@ export declare const zhipinSendPreparedReply: import("@roll-agent/sdk").ToolDefi
     success: boolean;
     sentMessage: string;
     error?: string | undefined;
+    feedbackStatus?: "failed" | "accepted" | "duplicate" | "skipped" | undefined;
+    feedbackError?: string | undefined;
 }>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roll-agent/browser-use-agent",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -45,7 +45,7 @@
   },
   "dependencies": {
     "zod": "^3.25.76",
-    "@roll-agent/reply-authority-client": "0.3.0",
+    "@roll-agent/reply-authority-client": "0.5.0",
     "@roll-agent/sdk": "0.2.0",
     "@roll-agent/browser": "0.9.0"
   },

package/references/zhipin-workflows.md

@@ -125,20 +125,20 @@ recommend-list  -> 推荐牛人列表，默认向下滚动，去重主键 candid
    - `no-new-items`：连续滚动没有新去重项。
    - `max-steps`：达到滚动步数上限。
 
-## preferredBrand
+## preferredBrand / preferredBrandId
 
-`zhipin_get_candidate_info` 会从 `candidateInfo.communicationPosition` 中解析：
+`zhipin_get_candidate_info` 会从页面信号中解析：
 
-- `expectedLocation`
-- `expectedPosition`
-- `preferredBrand`
+- `expectedLocation` / `expectedPosition`（来自期望职位文本）
+- `preferredBrandId` 或 `preferredBrand`（来自 `candidateInfo.communicationPosition`，互斥，最多输出一个）
 
-`preferredBrand` 规则：
+沟通职位有两种命名格式，解析规则：
 
-- 仅当 `communicationPosition` 含连字符类分隔符时输出：`-` / `－` / `—` / `–`。
-- 取分隔符前的第一段，例如 `肯德基-服务员` -> `preferredBrand: "肯德基"`。
-- 没有分隔符时不输出。
-- 禁止用通用岗位名或 `zhipin_get_candidate_list.company` 伪造品牌。
+- 新格式 `自定义描述…[品牌ID]`（末尾方括号包数字，兼容全角 `【】` / `［］` 与括号内空白）：输出 `preferredBrandId`，例如 `咖啡早班店员-接受小白-免费咖啡[10027]` -> `preferredBrandId: 10027`。此时**不输出** `preferredBrand`——新格式第一段是岗位描述，不是品牌名。
+- 老格式 `品牌名-职位`（含连字符类分隔符 `-` / `－` / `—` / `–`，且无 ID 尾缀）：取第一段输出 `preferredBrand`，例如 `肯德基-服务员` -> `preferredBrand: "肯德基"`。
+- 两者都不满足时不输出任何品牌字段。
+- 编排器原样透传工具输出即可，不要自行解析 `communicationPosition`；Reply Authority 服务端会以 `candidateInfo.communicationPosition` 为权威再次提取品牌 ID 并与 `preferredBrandId` 对账（不一致以服务端提取为准）。
+- 禁止用通用岗位名或 `zhipin_get_candidate_list.company` 伪造品牌；禁止把新格式的第一段当品牌名。
 
 ## 地点证据（服务端提取）