@roll-agent/browser-use-agent 0.7.7 → 0.8.0

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

@@ -82,6 +82,36 @@ export type NativeRecommendCardInspection = {
 export type NativeRecommendGreetResult = NativeRecommendCardInspection & {
     readonly clicked: boolean;
 };
+export type NativeRecommendJobOption = {
+    readonly index: number;
+    readonly value: string;
+    readonly label: string;
+    readonly isCurrent: boolean;
+};
+export type NativeRecommendJobSelectorState = {
+    readonly found: boolean;
+    readonly isOpen: boolean;
+    readonly currentLabel: string;
+    readonly currentValue: string;
+    readonly options: readonly NativeRecommendJobOption[];
+};
+export type NativeRecommendJobSelectRequest = {
+    readonly jobValue?: string;
+    readonly jobName?: string;
+    readonly index?: number;
+    readonly searchKeyword?: string;
+    readonly useSearch?: boolean;
+};
+export type NativeRecommendJobSelectResult = {
+    readonly success: boolean;
+    readonly status: "selected" | "already_selected" | "not_found" | "recommend_not_ready" | "selector_not_found";
+    readonly requested: NativeRecommendJobSelectRequest;
+    readonly current?: NativeRecommendJobOption;
+    readonly selected?: NativeRecommendJobOption;
+    readonly options: readonly NativeRecommendJobOption[];
+    readonly matchedCount: number;
+    readonly error?: string;
+};
 export type NativeWechatExchangeResult = {
     readonly success: boolean;
     readonly exchanged: boolean;
@@ -137,6 +167,14 @@ export declare class ZhipinNativePagePort {
     private dispatchNativeClick;
     hasRecommendList(): Promise<boolean>;
     waitForRecommendList(timeoutMs?: number): Promise<boolean>;
+    readRecommendJobSelectorState(): Promise<NativeRecommendJobSelectorState>;
+    private openRecommendJobSelector;
+    private setRecommendJobSearch;
+    private selectRecommendJobMatch;
+    private getCurrentRecommendJobOption;
+    private currentRecommendJobMatchesRequest;
+    private clickRecommendJobOption;
+    selectRecommendJob(request: NativeRecommendJobSelectRequest, options?: NativeClickOptions): Promise<NativeRecommendJobSelectResult>;
     clickSidebarSection(section: "chat" | "recommend", options?: NativeClickOptions): Promise<boolean>;
     scrollSurface(surface: ZhipinListSurface, options?: {
         readonly direction?: ScrollDirection;

package/dist/tools/zhipin-scroll-view.d.ts

@@ -35,11 +35,16 @@ export declare const zhipinScrollView: import("@roll-agent/sdk").ToolDefinition<
         atEnd: boolean;
         itemCount: number;
     };
+    position: "unknown" | "middle" | "top" | "bottom" | "only-page";
     direction: "up" | "down";
     stepsRequested: number;
     stepsCompleted: number;
     reachedBoundary: boolean;
     surface: "chat-list" | "chat-history" | "recommend-list";
+    atTop: boolean;
+    atBottom: boolean;
+    canScrollUp: boolean;
+    canScrollDown: boolean;
     error?: string | undefined;
 }>;
 export {};

package/dist/tools/zhipin-select-recommend-job.d.ts

@@ -0,0 +1,47 @@
+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";
+type NativeVisualActivitySessionLike = Pick<NativeVisualActivitySession, "begin" | "highlightSelector" | "previewMouseMotion" | "succeed" | "fail">;
+type ZhipinSelectRecommendJobDeps = {
+    readonly openNativePagePort: typeof openZhipinNativePagePort;
+    readonly createNativeVisualActivitySession: (page: ZhipinNativePagePort) => NativeVisualActivitySessionLike;
+};
+export declare function setZhipinSelectRecommendJobDepsForTests(override: Partial<ZhipinSelectRecommendJobDeps> | undefined): void;
+export declare const zhipinSelectRecommendJob: import("@roll-agent/sdk").ToolDefinition<{
+    index?: number | undefined;
+    jobValue?: string | undefined;
+    jobName?: string | undefined;
+    searchKeyword?: string | undefined;
+    useSearch?: boolean | undefined;
+}, {
+    options: {
+        value: string;
+        index: number;
+        label: string;
+        isCurrent: boolean;
+    }[];
+    status: "not_found" | "recommend_not_ready" | "selected" | "already_selected" | "selector_not_found";
+    success: boolean;
+    requested: {
+        index?: number | undefined;
+        jobValue?: string | undefined;
+        jobName?: string | undefined;
+        searchKeyword?: string | undefined;
+        useSearch?: boolean | undefined;
+    };
+    matchedCount: number;
+    error?: string | undefined;
+    current?: {
+        value: string;
+        index: number;
+        label: string;
+        isCurrent: boolean;
+    } | undefined;
+    selected?: {
+        value: string;
+        index: number;
+        label: string;
+        isCurrent: boolean;
+    } | undefined;
+}>;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roll-agent/browser-use-agent",
-  "version": "0.7.7",
+  "version": "0.8.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -45,8 +45,8 @@
   },
   "dependencies": {
     "zod": "^3.25.76",
-    "@roll-agent/sdk": "0.1.6",
-    "@roll-agent/browser": "0.3.0"
+    "@roll-agent/browser": "0.3.0",
+    "@roll-agent/sdk": "0.1.6"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"

package/references/zhipin-workflows.md

@@ -19,6 +19,25 @@
 4. `smart-reply-agent.generate_reply(..., target)`。
 5. `zhipin_send_reply(signedEnvelope)`。
 
+## 推荐岗位筛选
+
+推荐牛人页顶部岗位下拉的稳定主键是 `.job-list .job-item[value]`。
+
+优先级：
+
+1. 已知岗位 `value` 时，调用 `zhipin_select_recommend_job({ jobValue })`。
+2. 只知道标题时，调用 `zhipin_select_recommend_job({ jobName })`；工具会先匹配当前下拉项，未命中再使用下拉搜索框。
+3. `index` 只表示当前下拉快照顺序，筛选、搜索或岗位列表刷新后必须重新读取/选择，不要跨步骤长期保存。
+
+推荐链路：
+
+```text
+zhipin_open_recommend_page()
+  -> zhipin_select_recommend_job({ jobValue | jobName })
+  -> zhipin_filter_recommend_candidates(...)
+  -> zhipin_get_candidate_list(...)
+```
+
 ## 动态列表
 
 BOSS 页面通常不是整页滚动，而是内部容器滚动：
@@ -33,9 +52,10 @@ recommend-list  -> 推荐牛人列表，默认向下滚动，去重主键 candid
 
 1. 业务读取优先用自带 `autoScroll` 的工具：`zhipin_read_messages`、`zhipin_get_candidate_list`。
 2. `zhipin_scroll_view` 只用于显式翻页、调试和补救。
-3. `onlyUnread=true` 时不要依赖 `limit` 提前停止；未读会话可能在首屏之后。
-4. `maxScrolls` 用于成本控制，需要更完整列表时显式调大。
-5. 推荐列表若 `total < maxResults`，先看 `scrollStats.stopReason`：
+3. 只想检查聊天列表是否到顶/到底时调用 `zhipin_scroll_view({ surface: "chat-list", steps: 0 })`，读取顶层 `atTop` / `atBottom` / `canScrollUp` / `canScrollDown` / `position`。
+4. `onlyUnread=true` 时不要依赖 `limit` 提前停止；未读会话可能在首屏之后。
+5. `maxScrolls` 用于成本控制，需要更完整列表时显式调大。
+6. 推荐列表若 `total < maxResults`，先看 `scrollStats.stopReason`：
    - `target-count`：已达到目标数量。
    - `boundary`：触底并等待追加数据后仍无新增。
    - `no-new-items`：连续滚动没有新去重项。