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

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

@@ -1,8 +1,45 @@
+import type { AgentLLM, AgentLogger } from "@roll-agent/sdk";
+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"];
+export type LocationSignalInquiryType = (typeof LocationSignalInquiryTypeValues)[number];
+export type LocationSignalResolution = {
+    readonly signals: readonly CandidateLocationSignal[];
+    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 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;
@@ -12,3 +49,4 @@ export declare function resolveConversationSignals(input: {
     expectedPosition: string;
     preferredBrand?: string;
 };
+export {};

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

@@ -4,7 +4,7 @@ type NativePreviewTarget = {
 export declare class NativeReplyPreviewVisualSession {
     private readonly target;
     constructor(target: NativePreviewTarget);
-    begin(label: string): Promise<boolean>;
+    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>;

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

@@ -4,7 +4,7 @@ import { openZhipinNativePagePort } from "../pages/zhipin/native-page.ts";
 import type { ZhipinNativePagePort } from "../pages/zhipin/native-page.ts";
 import { savePreparedReply } from "../reply-authority/prepared-reply-store.ts";
 import { NativeReplyPreviewVisualSession } from "../reply-authority/reply-preview-visual.ts";
-type NativeVisualActivitySessionLike = Pick<NativeVisualActivitySession, "begin" | "highlightSelector" | "succeed" | "fail">;
+type NativeVisualActivitySessionLike = Pick<NativeVisualActivitySession, "begin" | "highlightSelector" | "succeed" | "fail" | "clear">;
 type ReplyPreviewVisualSessionLike = Pick<NativeReplyPreviewVisualSession, "begin" | "updateStatus" | "updateDraft" | "complete" | "fail">;
 type ZhipinGenerateReplyPreviewDeps = {
     readonly openNativePagePort: typeof openZhipinNativePagePort;
@@ -18,20 +18,28 @@ export declare const zhipinGenerateReplyPreview: import("@roll-agent/sdk").ToolD
     index?: number | undefined;
     conversationId?: string | undefined;
     candidateName?: string | undefined;
-    maxMessages?: number | undefined;
     reasoning?: {
         enabled: boolean;
         effort?: "high" | "low" | "medium" | undefined;
         scope?: "all" | "reply" | undefined;
     } | undefined;
+    maxMessages?: number | undefined;
 }, {
     success: boolean;
     error?: string | undefined;
+    confidence?: number | undefined;
     requestId?: string | undefined;
+    expiresAt?: number | undefined;
     suggestedReply?: string | undefined;
-    confidence?: number | undefined;
     stage?: string | undefined;
     preparedReplyId?: string | undefined;
-    expiresAt?: number | undefined;
+    timing?: {
+        totalLatencyMs: number;
+        preparedContextHit: boolean;
+        replyLatencyMs?: number | undefined;
+        turnPlanningLatencyMs?: number | undefined;
+        contextBuildingLatencyMs?: number | undefined;
+    } | undefined;
+    gateRewritten?: boolean | undefined;
 }>;
 export {};

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

@@ -1,3 +1,4 @@
+import { prepareReplyContext } 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";
@@ -5,7 +6,9 @@ type NativeVisualActivitySessionLike = Pick<NativeVisualActivitySession, "begin"
 type ZhipinGetCandidateInfoDeps = {
     readonly openNativePagePort: typeof openZhipinNativePagePort;
     readonly createNativeVisualActivitySession: (page: ZhipinNativePagePort) => NativeVisualActivitySessionLike;
+    readonly prepareReplyContext: typeof prepareReplyContext;
 };
+export declare function resetPrepareReplyContextCooldownForTests(): void;
 export declare function setZhipinGetCandidateInfoDepsForTests(override: Partial<ZhipinGetCandidateInfoDeps> | undefined): void;
 export declare const zhipinGetCandidateInfo: import("@roll-agent/sdk").ToolDefinition<{
     index?: number | undefined;
@@ -33,6 +36,13 @@ export declare const zhipinGetCandidateInfo: import("@roll-agent/sdk").ToolDefin
         recruiterMessages: number;
         systemMessages: number;
     };
+    locationSignals: {
+        source: "candidate_message" | "conversation_history" | "candidate_expected_location" | "communication_position";
+        text: string;
+        confidence: number;
+        city?: string | undefined;
+        intent?: "nearby_store" | "store_address" | "expected_area" | undefined;
+    }[];
     chatMessages: {
         index: number;
         content: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roll-agent/browser-use-agent",
-  "version": "0.16.2",
+  "version": "0.18.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -45,9 +45,9 @@
   },
   "dependencies": {
     "zod": "^3.25.76",
-    "@roll-agent/reply-authority-client": "0.1.2",
-    "@roll-agent/browser": "0.9.0",
-    "@roll-agent/sdk": "0.2.0"
+    "@roll-agent/reply-authority-client": "0.3.0",
+    "@roll-agent/sdk": "0.2.0",
+    "@roll-agent/browser": "0.9.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"

package/references/zhipin-workflows.md

@@ -140,6 +140,49 @@ recommend-list  -> 推荐牛人列表，默认向下滚动，去重主键 candid
 - 没有分隔符时不输出。
 - 禁止用通用岗位名或 `zhipin_get_candidate_list.company` 伪造品牌。
 
+## 地点证据（服务端提取）
+
+地点证据提取已收编进 Reply Authority 服务端的 turn_planning 阶段（RFC pipeline-latency-restructure M1）：browser-use 只上送原始对话与候选人资料，服务端 `planTurn` 合并提取地点信号并做逐字证据校验，再交给 geocode 与门店/岗位距离匹配。
+
+`zhipin_generate_reply_preview` 通过 SSE `location.resolved` 事件回显服务端提取结果：
+
+```json
+{
+  "type": "location.resolved",
+  "inquiryType": "location_inquiry",
+  "analysisPath": "llm",
+  "signals": [
+    {
+      "text": "人民广场",
+      "source": "candidate_message",
+      "city": "上海",
+      "intent": "nearby_store",
+      "confidence": 0.93
+    }
+  ]
+}
+```
+
+`source` 取值（与 `@roll-agent/reply-authority-client` 契约一致）：
+
+| `source` | 含义 |
+| --- | --- |
+| `candidate_message` | 候选人消息中的地点片段（最高优先级） |
+| `conversation_history` | 近几轮对话中的地点引用 |
+| `candidate_expected_location` | 候选人资料里的期望城市/区域（弱信号） |
+| `communication_position` | 沟通岗位文本中可确认的城市/门店片段 |
+
+`intent` 常见取值：`nearby_store`（附近门店/岗位）、`store_address`（门店地址）、`expected_area`（期望区域）。`analysisPath` 取值：`llm`（planTurn 合并提取）、`speculative`（词典投机命中）、`none`（无地点信号）。
+
+规则与边界：
+
+1. browser-use 不抽取地点、不调用外部地图、不做 geocode、不计算门店距离；上送的对话原文是服务端提取的唯一证据源。
+2. `candidateInfo.expectedLocation` 只作城市边界弱信号（服务端 confidence 封顶 0.6），不能替代候选人本轮追问的具体 POI。
+3. orchestrator 不要自行构造或改写地点信号：`generate_reply` 请求中的 `locationSignals` 字段已废弃，服务端过渡期内会逐字校验后合并，两个版本周期后忽略。
+4. `zhipin_get_candidate_info` 输出中的 `locationSignals` 恒为空数组，仅为输出契约兼容保留，不要依赖。
+5. 岗位/门店事实源仍是下游同步的岗位配置；外部地图 POI 不能当作门店或岗位事实。
+6. `smart-reply-agent.generate_reply` 只校验 schema 并原样转发（deprecated 字段同样适用），不做地点推断。
+
 ## Reply Authority
 
 `zhipin_send_prepared_reply` 只接受 `zhipin_generate_reply_preview` 生成的 `preparedReplyId`，内部再取回 Reply Authority Service 签发的 envelope 并完成验签。