@roll-agent/browser-use-agent 0.16.1 → 0.17.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"];
+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,18 +18,18 @@ 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;
     suggestedReply?: string | undefined;
-    confidence?: number | undefined;
     stage?: string | undefined;
     preparedReplyId?: string | undefined;
     expiresAt?: number | undefined;

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

@@ -33,6 +33,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.1",
+  "version": "0.17.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -45,7 +45,7 @@
   },
   "dependencies": {
     "zod": "^3.25.76",
-    "@roll-agent/reply-authority-client": "0.1.2",
+    "@roll-agent/reply-authority-client": "0.2.0",
     "@roll-agent/sdk": "0.2.0",
     "@roll-agent/browser": "0.9.0"
   },

package/references/zhipin-workflows.md

@@ -140,6 +140,49 @@ recommend-list  -> 推荐牛人列表，默认向下滚动，去重主键 candid
 - 没有分隔符时不输出。
 - 禁止用通用岗位名或 `zhipin_get_candidate_list.company` 伪造品牌。
 
+## locationSignals
+
+`zhipin_get_candidate_info` 和 `zhipin_generate_reply_preview` 会在读取聊天记录后输出/透传结构化地点证据 `locationSignals`，供下游 Reply Authority 做 geocode 与门店/岗位距离匹配。
+
+字段形状（与 `@roll-agent/reply-authority-client` 契约一致）：
+
+```json
+{
+  "text": "人民广场",
+  "source": "candidate_message",
+  "city": "上海",
+  "intent": "nearby_store",
+  "confidence": 0.93
+}
+```
+
+`source` 取值：
+
+| `source` | 含义 |
+| --- | --- |
+| `candidate_message` | 候选人消息中的地点片段（最高优先级） |
+| `conversation_history` | 近几轮对话中的地点引用 |
+| `candidate_expected_location` | 候选人资料里的期望城市/区域（弱信号） |
+| `communication_position` | 沟通岗位文本中可确认的城市/门店片段 |
+
+`intent` 常见取值：`nearby_store`（附近门店/岗位）、`store_address`（门店地址）、`expected_area`（期望区域）。
+
+抽取规则：
+
+1. browser-use 通过指挥官 LLM 抽取，并在超时或失败时回退到规则匹配；`text` 必须来自输入原文，不改写成下游门店名。
+2. 多轮对话会扫描全部候选人消息（去重），避免「历史问过地点、最新一句非地点」时丢失证据。
+3. `candidateInfo.expectedLocation` 只作城市边界弱信号（confidence 通常 ≤ 0.6），不能替代候选人本轮追问的具体 POI。
+4. 问候/职位介绍类消息可能跳过 LLM 抽取，仅保留 `expectedLocation` 弱信号。
+5. orchestrator 不要自行构造或改写 `locationSignals`；需要地点证据时调用 `zhipin_get_candidate_info` 或 `zhipin_generate_reply_preview`，由工具自动填充。
+
+边界：
+
+- browser-use **不**调用外部地图、**不**做 geocode、**不**计算门店距离。
+- 岗位/门店事实源仍是下游同步的岗位配置；外部地图 POI 不能当作门店或岗位事实。
+- `smart-reply-agent.generate_reply` 只校验 schema 并原样转发 `locationSignals`，不做地点推断。
+
+`zhipin_generate_reply_preview` 会把非空 `locationSignals` 写入 Reply Authority stream input；`zhipin_get_candidate_info` 在 output 中返回同结构数组，便于编排器先读证据再决定是否生成回复。
+
 ## Reply Authority
 
 `zhipin_send_prepared_reply` 只接受 `zhipin_generate_reply_preview` 生成的 `preparedReplyId`，内部再取回 Reply Authority Service 签发的 envelope 并完成验签。