@roll-agent/browser-use-agent 0.24.1 → 0.25.0

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

@@ -4,6 +4,7 @@ import type { DynamicListCollectionStopReason, DynamicListScrollResult, ScrollDi
 import { type ChatListItem, type ChatTarget, type OpenChatResult } from "./chat-navigation.ts";
 import { type ZhipinListSurface } from "./list-surfaces.ts";
 import type { ZhipinRecommendFilterApplyResult, ZhipinRecommendFilterRequest } from "./recommend-filter.ts";
+import { type ZhipinResumeCanvasRect } from "./resume-dom-contract.ts";
 import type { UsernameEvidence } from "./username.ts";
 export type ZhipinNativePagePortOptions = {
     readonly target: BrowserInspectablePage;
@@ -113,6 +114,34 @@ export type NativeRecommendCardInspection = {
 export type NativeRecommendGreetResult = NativeRecommendCardInspection & {
     readonly clicked: boolean;
 };
+export type NativeResumeDialogState = {
+    readonly dialogVisible: boolean;
+    readonly iframeFound: boolean;
+    readonly iframeVisible: boolean;
+    readonly canvasReady: boolean;
+};
+export type NativeResumeCanvasCapture = {
+    readonly found: boolean;
+    readonly screenshotArea?: ZhipinResumeCanvasRect;
+    readonly canvasSize?: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly dataUrl?: string;
+    readonly dataUrlError?: string;
+    readonly blank?: boolean;
+    readonly error?: string;
+};
+export type NativeResumeStitchProgress = {
+    readonly round: number;
+    readonly scrolledPx: number;
+    readonly totalPx: number;
+};
+export type NativeResumeCloseResult = {
+    readonly closed: boolean;
+    readonly method?: "close-button" | "escape";
+    readonly error?: string;
+};
 export type NativeRecommendJobOption = {
     readonly index: number;
     readonly value: string;
@@ -239,6 +268,16 @@ export declare class ZhipinNativePagePort {
     readCandidateChatDetails(maxMessages: number): Promise<NativeCandidateChatDetails>;
     inspectRecommendCard(index: number): Promise<NativeRecommendCardInspection>;
     clickRecommendGreet(index: number, options?: NativeClickOptions): Promise<NativeRecommendGreetResult>;
+    clickRecommendCardSurface(index: number, options?: NativeClickOptions): Promise<boolean>;
+    waitForResumeDialog(timeoutMs?: number): Promise<NativeResumeDialogState>;
+    readResumeCanvasGeometry(): Promise<NativeResumeCanvasCapture>;
+    private buildResumeCanvasGeometryExpression;
+    captureResumeCanvas(onProgress?: (progress: NativeResumeStitchProgress) => void | Promise<void>): Promise<NativeResumeCanvasCapture>;
+    captureViewportClip(clip: ZhipinResumeCanvasRect, scale?: number): Promise<string>;
+    readResumeDialogClipArea(): Promise<ZhipinResumeCanvasRect | undefined>;
+    closeResumeDialog(options?: NativeClickOptions): Promise<NativeResumeCloseResult>;
+    private readResumeDialogState;
+    private waitForResumeDialogGone;
     exchangeWechat(options?: NativeClickOptions): Promise<NativeWechatExchangeResult>;
     sendChatReply(message: string, options?: NativeClickOptions): Promise<NativeSendReplyResult>;
     applyRecommendFilter(requested: ZhipinRecommendFilterRequest, options?: NativeClickOptions): Promise<ZhipinRecommendFilterApplyResult>;
@@ -246,7 +285,15 @@ export declare class ZhipinNativePagePort {
     readUsernameEvidence(): Promise<UsernameEvidence[]>;
     close(): void;
     private buildRecommendCardInspectionExpression;
+    private buildRecommendCardTargetClickExpression;
     private buildRecommendGreetClickExpression;
+    private buildRecommendCardOpenClickExpression;
+    private buildResumeDialogStateExpression;
+    private buildResumeStitchInitExpression;
+    private buildResumeStitchStepExpression;
+    private buildResumeStitchExportExpression;
+    private buildResumeDialogRectExpression;
+    private buildResumeCloseTargetExpression;
     private waitForWechatExchangeDialog;
     private readWechatNumber;
     private selectAllFocusedText;

package/dist/pages/zhipin/resume-dom-contract.d.ts

@@ -7,9 +7,9 @@ export declare const ZHIPIN_RESUME_CARD_LIST_SELECTOR: ".candidate-card-wrap, [d
 export declare const ZHIPIN_RESUME_CARD_CLICK_SURFACE_SELECTOR: "[data-geek], .card-inner, .geek-item";
 export declare const ZHIPIN_RESUME_CANDIDATE_ID_SELECTOR: "[data-geek]";
 export declare const ZHIPIN_RESUME_CANDIDATE_NAME_SELECTOR: ".name";
-export declare const ZHIPIN_RESUME_IFRAME_CLOSE_SELECTORS: readonly [".recommendV2 .boss-popup__close", ".dialog-lib-resume .boss-popup__close", ".boss-dialog .boss-popup__close", ".boss-popup__close", ".close-btn", ".dialog-close"];
-export declare const ZHIPIN_RESUME_PAGE_CLOSE_SELECTORS: readonly [".boss-popup__close", ".close-btn", ".dialog-close", ".modal-close"];
-export declare const ZHIPIN_RESUME_DIALOG_SELECTOR: ".boss-popup__wrapper, .dialog-lib-resume, .boss-dialog";
+export declare const ZHIPIN_RESUME_DIALOG_SELECTOR: ".boss-popup__wrapper, .dialog-lib-resume, .boss-dialog, [data-type=\"boss-dialog\"]";
+export declare const ZHIPIN_RESUME_CLOSE_SCOPE_SELECTOR: ".boss-popup__wrapper, .dialog-lib-resume, .boss-dialog, [data-type=\"boss-dialog\"], .recommendV2";
+export declare const ZHIPIN_RESUME_CLOSE_ELEMENT_SELECTORS: readonly [".boss-popup__close", ".close-btn", ".dialog-close", ".modal-close"];
 export declare const ZHIPIN_RESUME_PAGE_DIALOG_SELECTOR: ".boss-popup__wrapper";
 export declare const ZHIPIN_RESUME_IFRAME_SELECTOR: "iframe[src*=\"c-resume\"]";
 export declare const ZHIPIN_RESUME_CANVAS_SELECTOR: "canvas#resume, div#resume canvas";

package/dist/tools/zhipin-capture-resume.d.ts

@@ -0,0 +1,25 @@
+import { openZhipinNativePagePort } from "../pages/zhipin/native-page.ts";
+type ZhipinCaptureResumeDeps = {
+    readonly openNativePagePort: typeof openZhipinNativePagePort;
+    readonly writePngFile: (path: string, base64Data: string) => Promise<void>;
+    readonly now: () => number;
+};
+export declare function setZhipinCaptureResumeDepsForTests(override: Partial<ZhipinCaptureResumeDeps> | undefined): void;
+export declare const zhipinCaptureResume: import("@roll-agent/sdk").ToolDefinition<{
+    outputPath?: string | undefined;
+}, {
+    success: boolean;
+    error?: string | undefined;
+    mcpImages?: {
+        data: string;
+        mimeType: string;
+    }[] | undefined;
+    note?: string | undefined;
+    canvasSize?: {
+        width: number;
+        height: number;
+    } | undefined;
+    imagePath?: string | undefined;
+    captureMode?: "canvas-data-url" | "viewport-clip" | "dom-screenshot" | undefined;
+}>;
+export {};

package/dist/tools/zhipin-close-resume.d.ts

@@ -1,5 +1,12 @@
+import { openZhipinNativePagePort } from "../pages/zhipin/native-page.ts";
+type ZhipinCloseResumeDeps = {
+    readonly openNativePagePort: typeof openZhipinNativePagePort;
+};
+export declare function setZhipinCloseResumeDepsForTests(override: Partial<ZhipinCloseResumeDeps> | undefined): void;
 export declare const zhipinCloseResume: import("@roll-agent/sdk").ToolDefinition<{}, {
     success: boolean;
     closed: boolean;
     error?: string | undefined;
+    method?: "close-button" | "escape" | undefined;
 }>;
+export {};

package/dist/tools/zhipin-diagnose-browser-state.d.ts

@@ -163,14 +163,14 @@ export declare function summarizeCookie(cookie: {
 }): CookieSummary;
 export declare function diffStorageCounters(beforeEntries: ReadonlyArray<StorageEntrySummary>, afterEntries: ReadonlyArray<StorageEntrySummary>): StorageCounterDiff[];
 export declare const zhipinDiagnoseBrowserState: import("@roll-agent/sdk").ToolDefinition<{
-    phase?: "native" | "native-watch" | "native-ws-connect" | "native-page-bring-front" | "native-evaluate-url-no-runtime-enable" | "native-dom-read-no-runtime-enable" | "native-input-move-no-runtime-enable" | "native-runtime-enable" | "native-evaluate-url" | "native-dom-read" | "browser-attach" | "page-attach" | "network-watch" | "page-evaluate" | "detector-fingerprint" | "storage-summary" | undefined;
+    phase?: "native" | "native-watch" | "native-ws-connect" | "native-page-bring-front" | "native-evaluate-url-no-runtime-enable" | "native-dom-read-no-runtime-enable" | "native-input-move-no-runtime-enable" | "native-runtime-enable" | "native-evaluate-url" | "native-dom-read" | "resume-canvas" | "browser-attach" | "page-attach" | "network-watch" | "page-evaluate" | "detector-fingerprint" | "storage-summary" | undefined;
     targetPageId?: string | undefined;
     watchMs?: number | undefined;
     networkEventLimit?: number | undefined;
 }, {
     mode: string;
     success: boolean;
-    requestedPhase: "native" | "native-watch" | "native-ws-connect" | "native-page-bring-front" | "native-evaluate-url-no-runtime-enable" | "native-dom-read-no-runtime-enable" | "native-input-move-no-runtime-enable" | "native-runtime-enable" | "native-evaluate-url" | "native-dom-read" | "browser-attach" | "page-attach" | "network-watch" | "page-evaluate" | "detector-fingerprint" | "storage-summary";
+    requestedPhase: "native" | "native-watch" | "native-ws-connect" | "native-page-bring-front" | "native-evaluate-url-no-runtime-enable" | "native-dom-read-no-runtime-enable" | "native-input-move-no-runtime-enable" | "native-runtime-enable" | "native-evaluate-url" | "native-dom-read" | "resume-canvas" | "browser-attach" | "page-attach" | "network-watch" | "page-evaluate" | "detector-fingerprint" | "storage-summary";
     nativePages: {
         pageId: string;
         url: string;
@@ -182,7 +182,7 @@ export declare const zhipinDiagnoseBrowserState: import("@roll-agent/sdk").ToolD
     browserAttached: boolean;
     pageAttached: boolean;
     nativeTimeline: {
-        phase: "native" | "native-watch" | "native-ws-connect" | "native-page-bring-front" | "native-evaluate-url-no-runtime-enable" | "native-dom-read-no-runtime-enable" | "native-input-move-no-runtime-enable" | "native-runtime-enable" | "native-evaluate-url" | "native-dom-read" | "browser-attach" | "page-attach" | "network-watch" | "page-evaluate" | "detector-fingerprint" | "storage-summary" | "native-ws-connect-watch" | "native-page-bring-front-watch" | "native-evaluate-url-no-runtime-enable-watch" | "native-dom-read-no-runtime-enable-watch" | "native-input-move-no-runtime-enable-watch" | "native-runtime-enable-watch" | "native-evaluate-url-watch" | "native-dom-read-watch" | "browser-attach-watch";
+        phase: "native" | "native-watch" | "native-ws-connect" | "native-page-bring-front" | "native-evaluate-url-no-runtime-enable" | "native-dom-read-no-runtime-enable" | "native-input-move-no-runtime-enable" | "native-runtime-enable" | "native-evaluate-url" | "native-dom-read" | "resume-canvas" | "browser-attach" | "page-attach" | "network-watch" | "page-evaluate" | "detector-fingerprint" | "storage-summary" | "native-ws-connect-watch" | "native-page-bring-front-watch" | "native-evaluate-url-no-runtime-enable-watch" | "native-dom-read-no-runtime-enable-watch" | "native-input-move-no-runtime-enable-watch" | "native-runtime-enable-watch" | "native-evaluate-url-watch" | "native-dom-read-watch" | "browser-attach-watch";
         capturedAt: string;
         targetFound: boolean;
         urlChangedFromPrevious: boolean;
@@ -203,7 +203,7 @@ export declare const zhipinDiagnoseBrowserState: import("@roll-agent/sdk").ToolD
     phases: {
         success: boolean;
         durationMs: number;
-        phase: "native" | "native-watch" | "native-ws-connect" | "native-page-bring-front" | "native-evaluate-url-no-runtime-enable" | "native-dom-read-no-runtime-enable" | "native-input-move-no-runtime-enable" | "native-runtime-enable" | "native-evaluate-url" | "native-dom-read" | "browser-attach" | "page-attach" | "network-watch" | "page-evaluate" | "detector-fingerprint" | "storage-summary";
+        phase: "native" | "native-watch" | "native-ws-connect" | "native-page-bring-front" | "native-evaluate-url-no-runtime-enable" | "native-dom-read-no-runtime-enable" | "native-input-move-no-runtime-enable" | "native-runtime-enable" | "native-evaluate-url" | "native-dom-read" | "resume-canvas" | "browser-attach" | "page-attach" | "network-watch" | "page-evaluate" | "detector-fingerprint" | "storage-summary";
         error?: string | undefined;
     }[];
     warnings: string[];
@@ -224,8 +224,8 @@ export declare const zhipinDiagnoseBrowserState: import("@roll-agent/sdk").ToolD
     networkEvents?: {
         url: string;
         reason: "apm-action-log" | "device-action-report" | "boss-risk-report" | "zhipin-security";
-        capturedAt: string;
         kind: "request" | "response";
+        capturedAt: string;
         status?: number | undefined;
         method?: string | undefined;
         resourceType?: string | undefined;
@@ -243,14 +243,14 @@ export declare const zhipinDiagnoseBrowserState: import("@roll-agent/sdk").ToolD
             x: number;
             y: number;
         } | undefined;
-        pageBroughtToFront?: boolean | undefined;
-        runtimeEnabled?: boolean | undefined;
         evaluate?: {
             url: string;
             title: string;
             visibilityState: string;
             hasFocus: boolean;
         } | undefined;
+        pageBroughtToFront?: boolean | undefined;
+        runtimeEnabled?: boolean | undefined;
         dom?: {
             rootNodeId: number;
             rootNodeName: string;
@@ -259,6 +259,23 @@ export declare const zhipinDiagnoseBrowserState: import("@roll-agent/sdk").ToolD
             elementCount?: number | undefined;
         } | undefined;
     } | undefined;
+    resumeCanvas?: {
+        dialogVisible: boolean;
+        iframeFound: boolean;
+        iframeVisible: boolean;
+        canvasReady: boolean;
+        error?: string | undefined;
+        canvasSize?: {
+            width: number;
+            height: number;
+        } | undefined;
+        screenshotArea?: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        } | undefined;
+    } | undefined;
     detectorFingerprint?: {
         userAgentContainsHeadless: boolean;
         languagesLength: number;

package/dist/tools/zhipin-open-resume.d.ts

@@ -1,3 +1,8 @@
+import { openZhipinNativePagePort } from "../pages/zhipin/native-page.ts";
+type ZhipinOpenResumeDeps = {
+    readonly openNativePagePort: typeof openZhipinNativePagePort;
+};
+export declare function setZhipinOpenResumeDepsForTests(override: Partial<ZhipinOpenResumeDeps> | undefined): void;
 export declare const zhipinOpenResume: import("@roll-agent/sdk").ToolDefinition<{
     index?: number | undefined;
     candidateRef?: string | undefined;
@@ -7,4 +12,6 @@ export declare const zhipinOpenResume: import("@roll-agent/sdk").ToolDefinition<
     candidateName: string;
     error?: string | undefined;
     candidateRef?: string | undefined;
+    resumeReady?: boolean | undefined;
 }>;
+export {};

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

@@ -15,6 +15,9 @@ export declare const zhipinScrollView: import("@roll-agent/sdk").ToolDefinition<
     settleMs?: number | undefined;
 }, {
     success: boolean;
+    direction: "up" | "down";
+    stepsRequested: number;
+    stepsCompleted: number;
     before: {
         containerFound: boolean;
         containerLabel: string;
@@ -35,11 +38,8 @@ 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;
+    position: "unknown" | "middle" | "top" | "bottom" | "only-page";
     surface: "chat-list" | "chat-history" | "recommend-list";
     atTop: boolean;
     atBottom: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roll-agent/browser-use-agent",
-  "version": "0.24.1",
+  "version": "0.25.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -46,8 +46,8 @@
   "dependencies": {
     "zod": "^3.25.76",
     "@roll-agent/reply-authority-client": "0.7.0",
-    "@roll-agent/browser": "0.9.1",
-    "@roll-agent/sdk": "0.4.0"
+    "@roll-agent/sdk": "0.5.0",
+    "@roll-agent/browser": "0.10.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"

package/dist/tools/zhipin-locate-resume-canvas.d.ts

@@ -1,14 +0,0 @@
-export declare const zhipinLocateResumeCanvas: import("@roll-agent/sdk").ToolDefinition<{}, {
-    success: boolean;
-    error?: string | undefined;
-    screenshotArea?: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    } | undefined;
-    canvasInfo?: {
-        width: number;
-        height: number;
-    } | undefined;
-}>;