@roll-agent/browser-use-agent 0.7.4 → 0.7.6

package/dist/native-visual-activity-session.d.ts

@@ -0,0 +1,24 @@
+import type { VisualActivityTone } from "./visual-activity.ts";
+type NativeVisualTarget = {
+    evaluateJson<T = unknown>(expression: string): Promise<T>;
+};
+type NativeVisualHighlightOptions = {
+    readonly label?: string;
+    readonly padding?: number;
+    readonly tone?: VisualActivityTone;
+};
+type NativeVisualPointOptions = {
+    readonly durationMs?: number;
+};
+export declare class NativeVisualActivitySession {
+    private readonly target;
+    constructor(target: NativeVisualTarget);
+    begin(label: string, tone?: VisualActivityTone): Promise<boolean>;
+    highlightSelector(selector: string, options?: NativeVisualHighlightOptions): Promise<boolean>;
+    highlightPoint(x: number, y: number, options?: NativeVisualPointOptions): Promise<boolean>;
+    succeed(label: string, lingerMs?: number): Promise<boolean>;
+    fail(label: string, lingerMs?: number): Promise<boolean>;
+    clear(): Promise<boolean>;
+    private render;
+}
+export {};

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

@@ -0,0 +1,196 @@
+import type { BrowserContextManager, BrowserInspectablePage, BrowserRuntime, NativeCdpController } from "@roll-agent/browser";
+import type { DynamicListCollectionStopReason, DynamicListScrollResult, ScrollDirection } from "../shared/dynamic-list-scroller.ts";
+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 { UsernameEvidence } from "./username.ts";
+export type ZhipinNativePagePortOptions = {
+    readonly target: BrowserInspectablePage;
+    readonly controller: NativeCdpController;
+};
+export type ReadNativeChatCandidatesOptions = {
+    readonly targetCount?: number;
+    readonly autoScroll?: boolean;
+    readonly maxScrolls?: number;
+};
+export type NativeRecommendCandidateCard = {
+    readonly index: number;
+    readonly candidateId: string;
+    readonly name: string;
+    readonly age: string;
+    readonly experience: string;
+    readonly education: string;
+    readonly workStatus: string;
+    readonly company: string;
+    readonly currentPosition: string;
+    readonly expectedLocation: string;
+    readonly expectedPosition: string;
+    readonly expectedSalary: string;
+    readonly tags: string[];
+    readonly buttonText: string;
+};
+export type ReadNativeRecommendCandidatesOptions = {
+    readonly targetCount?: number;
+    readonly autoScroll?: boolean;
+    readonly maxScrolls?: number;
+};
+export type OpenNativeChatOptions = ChatTarget & {
+    readonly preferUnread?: boolean;
+    readonly maxScrolls?: number;
+};
+export type NativeChatMessage = {
+    readonly index: number;
+    readonly sender: "candidate" | "recruiter" | "system";
+    readonly messageType: "text" | "system" | "resume" | "wechat-exchange";
+    readonly content: string;
+    readonly time: string;
+};
+export type NativeChatPanelInfo = {
+    readonly candidateName: string;
+};
+export type NativeSelectedChatTarget = {
+    readonly conversationId: string;
+    readonly candidateId: string;
+    readonly candidateName: string;
+};
+export type NativeCandidateInfo = {
+    readonly name: string;
+    readonly age: string;
+    readonly experience: string;
+    readonly education: string;
+    readonly communicationPosition: string;
+    readonly expectedJobText: string;
+    readonly expectedSalary: string;
+    readonly tags: readonly string[];
+};
+export type NativeCandidateChatDetails = {
+    readonly selectedTarget: NativeSelectedChatTarget | null;
+    readonly activePanel: NativeChatPanelInfo | null;
+    readonly candidateInfo: NativeCandidateInfo;
+    readonly messages: readonly NativeChatMessage[];
+};
+export type NativeRecommendCardInspection = {
+    readonly found: boolean;
+    readonly cardSelector: string;
+    readonly candidateId: string;
+    readonly name: string;
+    readonly hasGreetButton: boolean;
+    readonly error?: string;
+};
+export type NativeRecommendGreetResult = NativeRecommendCardInspection & {
+    readonly clicked: boolean;
+};
+export type NativeWechatExchangeResult = {
+    readonly success: boolean;
+    readonly exchanged: boolean;
+    readonly wechatNumber?: string;
+    readonly error?: string;
+};
+export type NativeSendReplyResult = {
+    readonly success: boolean;
+    readonly error?: string;
+};
+export type NativeDynamicListCollectionResult<TItem> = DynamicListScrollResult & {
+    readonly items: readonly TItem[];
+    readonly uniqueCount: number;
+    readonly duplicateCount: number;
+    readonly noNewRounds: number;
+    readonly stopReason: DynamicListCollectionStopReason;
+};
+type NativeClickTarget = {
+    readonly found: boolean;
+    readonly x: number;
+    readonly y: number;
+};
+type NativeClickOptions = {
+    readonly onTargetResolved?: (target: NativeClickTarget) => Promise<void>;
+    readonly preClickDelayMs?: number;
+    readonly pressDurationMs?: number;
+    readonly settleMs?: number;
+};
+type NativePageResolutionOptions = {
+    readonly requireChatPage?: boolean;
+};
+export declare function openZhipinNativePagePort(options?: NativePageResolutionOptions, deps?: {
+    readonly ctxManager?: BrowserContextManager;
+    readonly runtime?: BrowserRuntime;
+}): Promise<ZhipinNativePagePort>;
+export declare class ZhipinNativePagePort {
+    private readonly target;
+    private readonly controller;
+    private recommendFrameContextId;
+    private recommendFrameContextFrameId;
+    constructor(options: ZhipinNativePagePortOptions);
+    get targetId(): string;
+    inspectPage(): Promise<BrowserInspectablePage>;
+    url(): Promise<string>;
+    title(): Promise<string>;
+    waitForSelector(selector: string, timeoutMs?: number): Promise<boolean>;
+    evaluateJson<T = unknown>(expression: string): Promise<T>;
+    bringToFront(): Promise<void>;
+    isChatSurfaceOpen(): Promise<boolean>;
+    waitForChatSurface(timeoutMs?: number): Promise<boolean>;
+    isRecommendSurfaceOpen(): Promise<boolean>;
+    waitForRecommendSurface(timeoutMs?: number): Promise<boolean>;
+    private resolveRecommendFrameContextId;
+    private evaluateRecommendFrameJson;
+    private readRecommendFrameOffset;
+    private resolveRecommendClickTarget;
+    private dispatchNativeClick;
+    hasRecommendList(): Promise<boolean>;
+    waitForRecommendList(timeoutMs?: number): Promise<boolean>;
+    clickSidebarSection(section: "chat" | "recommend", options?: NativeClickOptions): Promise<boolean>;
+    scrollSurface(surface: ZhipinListSurface, options?: {
+        readonly direction?: ScrollDirection;
+        readonly steps?: number;
+        readonly distance?: number;
+        readonly settleMs?: number;
+    }): Promise<DynamicListScrollResult>;
+    readChatCandidates(options?: ReadNativeChatCandidatesOptions): Promise<ChatListItem[]>;
+    openChat(options: OpenNativeChatOptions): Promise<OpenChatResult>;
+    readSelectedChatTarget(): Promise<NativeSelectedChatTarget | null>;
+    readActiveChatPanel(): Promise<NativeChatPanelInfo | null>;
+    waitForChatMessages(timeoutMs?: number): Promise<boolean>;
+    readCandidateChatDetails(maxMessages: number): Promise<NativeCandidateChatDetails>;
+    inspectRecommendCard(index: number): Promise<NativeRecommendCardInspection>;
+    clickRecommendGreet(index: number, options?: NativeClickOptions): Promise<NativeRecommendGreetResult>;
+    exchangeWechat(options?: NativeClickOptions): Promise<NativeWechatExchangeResult>;
+    sendChatReply(message: string, options?: NativeClickOptions): Promise<NativeSendReplyResult>;
+    applyRecommendFilter(requested: ZhipinRecommendFilterRequest, options?: NativeClickOptions): Promise<ZhipinRecommendFilterApplyResult>;
+    readRecommendCandidates(options?: ReadNativeRecommendCandidatesOptions): Promise<NativeDynamicListCollectionResult<NativeRecommendCandidateCard>>;
+    readUsernameEvidence(): Promise<UsernameEvidence[]>;
+    close(): void;
+    private buildRecommendCardInspectionExpression;
+    private buildRecommendGreetClickExpression;
+    private waitForWechatExchangeDialog;
+    private readWechatNumber;
+    private selectAllFocusedText;
+    private waitForRecommendFilterSurface;
+    private isRecommendFilterPanelVisible;
+    private openRecommendFilterPanel;
+    private dismissPreviousFilterPrompt;
+    private clickRecommendFilterOption;
+    private detectVipModal;
+    private readNativeAgeState;
+    private resolveNativeAgeSlider;
+    private dispatchNativeDrag;
+    private dragAgeHandleToRatio;
+    private estimateAgeRatio;
+    private clampRatio;
+    private setAgeHandleToNumber;
+    private isDesiredAgeState;
+    private setRecommendAgeRange;
+    private readSelectedRecommendOptionText;
+    private readNativeAppliedFilterState;
+    private clickRecommendFilterSubmit;
+    private readRecommendFilterButtonText;
+    private readVisibleChatCandidates;
+    private waitForNativeChatReady;
+    private clickChatCandidate;
+    private readVisibleRecommendCandidates;
+    private inspectSurface;
+    private scrollSurfaceWithWheel;
+    private scrollSurfaceOnce;
+    private scrollChatList;
+}
+export {};

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

@@ -0,0 +1,43 @@
+export declare const ZHIPIN_RESUME_RECOMMEND_FRAME_NAME: "recommendFrame";
+export declare const ZHIPIN_RESUME_RECOMMEND_FRAME_URL_MARKER: "recommend";
+export declare const ZHIPIN_RESUME_RECOMMEND_FRAME_SELECTOR: "#recommendFrame";
+export declare const ZHIPIN_RESUME_CARD_PRIMARY_SELECTOR: ".candidate-card-wrap";
+export declare const ZHIPIN_RESUME_CARD_FALLBACK_SELECTOR: "[data-geek], .geek-item";
+export declare const ZHIPIN_RESUME_CARD_LIST_SELECTOR: ".candidate-card-wrap, [data-geek], .geek-item";
+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_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";
+export declare const ZHIPIN_RESUME_RECOMMEND_TARGET_KINDS: readonly ["named-frame", "recommend-url-frame", "main-page"];
+export type ZhipinResumeRecommendTargetKind = (typeof ZHIPIN_RESUME_RECOMMEND_TARGET_KINDS)[number];
+export type ZhipinResumeCandidateIdentityInput = {
+    readonly ownDataGeek?: string | null;
+    readonly childDataGeek?: string | null;
+    readonly nameText?: string | null;
+};
+export type ZhipinResumeCandidateIdentity = {
+    readonly candidateId: string;
+    readonly name: string;
+};
+export type ZhipinResumeCanvasRect = {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+};
+export declare function resolveRecommendTargetKind(input: {
+    readonly hasNamedRecommendFrame: boolean;
+    readonly hasRecommendUrlFrame: boolean;
+}): ZhipinResumeRecommendTargetKind;
+export declare function resolveResumeCardSelector(primaryCardCount: number): string;
+export declare function resolveResumeCandidateIdentity(input: ZhipinResumeCandidateIdentityInput): ZhipinResumeCandidateIdentity;
+export declare function composeResumeCanvasArea(input: {
+    readonly recommendFrameRect?: Pick<ZhipinResumeCanvasRect, "x" | "y"> | null;
+    readonly resumeFrameRect?: Pick<ZhipinResumeCanvasRect, "x" | "y"> | null;
+    readonly canvasRect: ZhipinResumeCanvasRect;
+}): ZhipinResumeCanvasRect;

package/dist/pages/zhipin/selectors.d.ts

@@ -90,7 +90,7 @@ export declare const ZHIPIN_SELECTORS: {
     readonly nav: {
         readonly sidebar: ".side-wrap.side-wrap-v2";
         readonly chatLink: ".side-wrap.side-wrap-v2 a[href*=\"/web/chat/index\"]";
-        readonly recommendLink: ".side-wrap.side-wrap-v2 a[href*=\"/web/geek/recommend\"]";
+        readonly recommendLink: ".side-wrap.side-wrap-v2 a[href*=\"/web/chat/recommend\"]";
     };
     readonly recommend: {
         readonly iframe: "#recommendFrame";

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

@@ -0,0 +1,332 @@
+import { z } from "zod";
+declare const StorageAreaSchema: z.ZodEnum<["localStorage", "sessionStorage"]>;
+declare const StorageEntrySummarySchema: z.ZodObject<{
+    area: z.ZodEnum<["localStorage", "sessionStorage"]>;
+    key: z.ZodString;
+    valueLength: z.ZodNumber;
+    valueKind: z.ZodEnum<["empty", "json", "string"]>;
+    jsonKind: z.ZodOptional<z.ZodEnum<["array", "object", "string", "number", "boolean", "null"]>>;
+    jsonTopLevelKeys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    jsonArrayLength: z.ZodOptional<z.ZodNumber>;
+    numericFields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    booleanFields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+    arrayLengths: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    area: "localStorage" | "sessionStorage";
+    valueLength: number;
+    valueKind: "string" | "empty" | "json";
+    jsonKind?: "string" | "number" | "boolean" | "object" | "array" | "null" | undefined;
+    jsonTopLevelKeys?: string[] | undefined;
+    jsonArrayLength?: number | undefined;
+    numericFields?: Record<string, number> | undefined;
+    booleanFields?: Record<string, boolean> | undefined;
+    arrayLengths?: Record<string, number> | undefined;
+}, {
+    key: string;
+    area: "localStorage" | "sessionStorage";
+    valueLength: number;
+    valueKind: "string" | "empty" | "json";
+    jsonKind?: "string" | "number" | "boolean" | "object" | "array" | "null" | undefined;
+    jsonTopLevelKeys?: string[] | undefined;
+    jsonArrayLength?: number | undefined;
+    numericFields?: Record<string, number> | undefined;
+    booleanFields?: Record<string, boolean> | undefined;
+    arrayLengths?: Record<string, number> | undefined;
+}>;
+declare const CookieSummarySchema: z.ZodObject<{
+    name: z.ZodString;
+    domain: z.ZodString;
+    path: z.ZodString;
+    expires: z.ZodString;
+    valueLength: z.ZodNumber;
+    httpOnly: z.ZodBoolean;
+    secure: z.ZodBoolean;
+    sameSite: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    name: string;
+    valueLength: number;
+    domain: string;
+    expires: string;
+    httpOnly: boolean;
+    secure: boolean;
+    sameSite?: string | undefined;
+}, {
+    path: string;
+    name: string;
+    valueLength: number;
+    domain: string;
+    expires: string;
+    httpOnly: boolean;
+    secure: boolean;
+    sameSite?: string | undefined;
+}>;
+declare const StorageCounterDiffSchema: z.ZodObject<{
+    area: z.ZodEnum<["localStorage", "sessionStorage"]>;
+    key: z.ZodString;
+    beforePresent: z.ZodBoolean;
+    afterPresent: z.ZodBoolean;
+    numericDeltas: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        before: z.ZodOptional<z.ZodNumber>;
+        after: z.ZodOptional<z.ZodNumber>;
+        delta: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        before?: number | undefined;
+        after?: number | undefined;
+        delta?: number | undefined;
+    }, {
+        before?: number | undefined;
+        after?: number | undefined;
+        delta?: number | undefined;
+    }>>>;
+    booleanChanges: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        before: z.ZodOptional<z.ZodBoolean>;
+        after: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        before?: boolean | undefined;
+        after?: boolean | undefined;
+    }, {
+        before?: boolean | undefined;
+        after?: boolean | undefined;
+    }>>>;
+    arrayLengthDeltas: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        before: z.ZodOptional<z.ZodNumber>;
+        after: z.ZodOptional<z.ZodNumber>;
+        delta: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        before?: number | undefined;
+        after?: number | undefined;
+        delta?: number | undefined;
+    }, {
+        before?: number | undefined;
+        after?: number | undefined;
+        delta?: number | undefined;
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    area: "localStorage" | "sessionStorage";
+    beforePresent: boolean;
+    afterPresent: boolean;
+    numericDeltas?: Record<string, {
+        before?: number | undefined;
+        after?: number | undefined;
+        delta?: number | undefined;
+    }> | undefined;
+    booleanChanges?: Record<string, {
+        before?: boolean | undefined;
+        after?: boolean | undefined;
+    }> | undefined;
+    arrayLengthDeltas?: Record<string, {
+        before?: number | undefined;
+        after?: number | undefined;
+        delta?: number | undefined;
+    }> | undefined;
+}, {
+    key: string;
+    area: "localStorage" | "sessionStorage";
+    beforePresent: boolean;
+    afterPresent: boolean;
+    numericDeltas?: Record<string, {
+        before?: number | undefined;
+        after?: number | undefined;
+        delta?: number | undefined;
+    }> | undefined;
+    booleanChanges?: Record<string, {
+        before?: boolean | undefined;
+        after?: boolean | undefined;
+    }> | undefined;
+    arrayLengthDeltas?: Record<string, {
+        before?: number | undefined;
+        after?: number | undefined;
+        delta?: number | undefined;
+    }> | undefined;
+}>;
+type StorageArea = z.infer<typeof StorageAreaSchema>;
+type StorageEntrySummary = z.infer<typeof StorageEntrySummarySchema>;
+type CookieSummary = z.infer<typeof CookieSummarySchema>;
+type StorageCounterDiff = z.infer<typeof StorageCounterDiffSchema>;
+type RawStorageEntry = {
+    readonly key: string;
+    readonly value: string;
+};
+export declare function summarizeStorageEntry(area: StorageArea, entry: RawStorageEntry): StorageEntrySummary;
+export declare function summarizeCookie(cookie: {
+    readonly name: string;
+    readonly value: string;
+    readonly domain: string;
+    readonly path: string;
+    readonly expires: number;
+    readonly httpOnly: boolean;
+    readonly secure: boolean;
+    readonly sameSite?: string;
+}): 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;
+    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";
+    nativePages: {
+        url: string;
+        title: string;
+        pageId: string;
+        boundPlatform: "zhipin" | "yupao" | null;
+        detectedPlatform: "zhipin" | "yupao" | null;
+        isSelectedForPlatform: boolean;
+    }[];
+    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";
+        capturedAt: string;
+        targetFound: boolean;
+        urlChangedFromPrevious: boolean;
+        titleChangedFromPrevious: boolean;
+        currentUrl?: string | undefined;
+        page?: {
+            url: string;
+            title: string;
+            pageId: string;
+            boundPlatform: "zhipin" | "yupao" | null;
+            detectedPlatform: "zhipin" | "yupao" | null;
+            isSelectedForPlatform: boolean;
+        } | undefined;
+        previousUrl?: string | undefined;
+        previousTitle?: string | undefined;
+        currentTitle?: string | undefined;
+    }[];
+    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";
+        error?: string | undefined;
+    }[];
+    warnings: string[];
+    evaluate?: {
+        url: string;
+        title: string;
+        visibilityState: string;
+        hasFocus: boolean;
+    } | undefined;
+    targetPage?: {
+        url: string;
+        title: string;
+        pageId: string;
+        boundPlatform: "zhipin" | "yupao" | null;
+        detectedPlatform: "zhipin" | "yupao" | null;
+        isSelectedForPlatform: boolean;
+    } | undefined;
+    networkEvents?: {
+        url: string;
+        reason: "apm-action-log" | "device-action-report" | "boss-risk-report" | "zhipin-security";
+        capturedAt: string;
+        kind: "request" | "response";
+        status?: number | undefined;
+        method?: string | undefined;
+        resourceType?: string | undefined;
+    }[] | undefined;
+    navigationEvents?: {
+        url: string;
+        capturedAt: string;
+    }[] | undefined;
+    nativeCdp?: {
+        targetId: string;
+        connected: boolean;
+        websocketUrlAvailable: boolean;
+        input?: {
+            type: "mouseMoved";
+            x: number;
+            y: number;
+        } | undefined;
+        pageBroughtToFront?: boolean | undefined;
+        runtimeEnabled?: boolean | undefined;
+        evaluate?: {
+            url: string;
+            title: string;
+            visibilityState: string;
+            hasFocus: boolean;
+        } | undefined;
+        dom?: {
+            rootNodeId: number;
+            rootNodeName: string;
+            childNodeCount?: number | undefined;
+            bodyTextLength?: number | undefined;
+            elementCount?: number | undefined;
+        } | undefined;
+    } | undefined;
+    detectorFingerprint?: {
+        userAgentContainsHeadless: boolean;
+        languagesLength: number;
+        pluginsLength: number;
+        hasChromeRuntime: boolean;
+        hasPlaywrightBinding: boolean;
+        hasPwInitScripts: boolean;
+        cdcKeys: string[];
+        webdriverKeys: string[];
+        automationLikeWindowKeys: string[];
+        navigatorWebdriver?: boolean | undefined;
+        permissionQueryIsNative?: boolean | undefined;
+    } | undefined;
+    storage?: {
+        cookies: {
+            path: string;
+            name: string;
+            valueLength: number;
+            domain: string;
+            expires: string;
+            httpOnly: boolean;
+            secure: boolean;
+            sameSite?: string | undefined;
+        }[];
+        localStorage: {
+            key: string;
+            area: "localStorage" | "sessionStorage";
+            valueLength: number;
+            valueKind: "string" | "empty" | "json";
+            jsonKind?: "string" | "number" | "boolean" | "object" | "array" | "null" | undefined;
+            jsonTopLevelKeys?: string[] | undefined;
+            jsonArrayLength?: number | undefined;
+            numericFields?: Record<string, number> | undefined;
+            booleanFields?: Record<string, boolean> | undefined;
+            arrayLengths?: Record<string, number> | undefined;
+        }[];
+        sessionStorage: {
+            key: string;
+            area: "localStorage" | "sessionStorage";
+            valueLength: number;
+            valueKind: "string" | "empty" | "json";
+            jsonKind?: "string" | "number" | "boolean" | "object" | "array" | "null" | undefined;
+            jsonTopLevelKeys?: string[] | undefined;
+            jsonArrayLength?: number | undefined;
+            numericFields?: Record<string, number> | undefined;
+            booleanFields?: Record<string, boolean> | undefined;
+            arrayLengths?: Record<string, number> | undefined;
+        }[];
+        counterDiffs: {
+            key: string;
+            area: "localStorage" | "sessionStorage";
+            beforePresent: boolean;
+            afterPresent: boolean;
+            numericDeltas?: Record<string, {
+                before?: number | undefined;
+                after?: number | undefined;
+                delta?: number | undefined;
+            }> | undefined;
+            booleanChanges?: Record<string, {
+                before?: boolean | undefined;
+                after?: boolean | undefined;
+            }> | undefined;
+            arrayLengthDeltas?: Record<string, {
+                before?: number | undefined;
+                after?: number | undefined;
+                delta?: number | undefined;
+            }> | undefined;
+        }[];
+    } | undefined;
+}>;
+export {};

package/dist/tools/zhipin-exchange-wechat.d.ts

@@ -1,14 +1,20 @@
+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" | "highlightPoint" | "succeed" | "fail">;
+type ZhipinExchangeWechatDeps = {
+    readonly openNativePagePort: typeof openZhipinNativePagePort;
+    readonly createNativeVisualActivitySession: (page: ZhipinNativePagePort) => NativeVisualActivitySessionLike;
+};
+export declare function setZhipinExchangeWechatDepsForTests(override: Partial<ZhipinExchangeWechatDeps> | undefined): void;
 export declare const zhipinExchangeWechat: import("@roll-agent/sdk").ToolDefinition<{
+    index?: number | undefined;
     conversationId?: string | undefined;
     candidateName?: string | undefined;
-    index?: number | undefined;
 }, {
     success: boolean;
     exchanged: boolean;
-    error: string | undefined;
-} | {
-    wechatNumber?: string;
-    success: boolean;
-    exchanged: boolean;
-    error?: never;
+    error?: string | undefined;
+    wechatNumber?: string | undefined;
 }>;
+export {};

package/dist/tools/zhipin-filter-recommend-candidates.d.ts

@@ -1,17 +1,10 @@
-import { getContextManager } from "../runtime-holder.ts";
-import { applyRecommendFilter, waitForRecommendFilterSurface, type RecommendTarget } from "../pages/zhipin/recommend-filter.ts";
-import { getRecommendTarget } from "../pages/zhipin/recommend-list.ts";
-import { VisualActivitySession } from "../visual-activity-session.ts";
-import { moveVisualCursorToLocator, showVisualClickOnLocator } from "../visual-cursor.ts";
-type VisualActivitySessionLike = Pick<VisualActivitySession, "begin" | "highlightSelector" | "retarget" | "succeed" | "fail">;
+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" | "highlightPoint" | "succeed" | "fail">;
 type ZhipinFilterRecommendCandidatesDeps = {
-    readonly getContextManager: typeof getContextManager;
-    readonly getRecommendTarget: typeof getRecommendTarget;
-    readonly waitForRecommendFilterSurface: typeof waitForRecommendFilterSurface;
-    readonly applyRecommendFilter: typeof applyRecommendFilter;
-    readonly moveVisualCursorToLocator: typeof moveVisualCursorToLocator;
-    readonly showVisualClickOnLocator: typeof showVisualClickOnLocator;
-    readonly createVisualActivitySession: (target: RecommendTarget) => VisualActivitySessionLike;
+    readonly openNativePagePort: typeof openZhipinNativePagePort;
+    readonly createNativeVisualActivitySession: (page: ZhipinNativePagePort) => NativeVisualActivitySessionLike;
 };
 export declare function setZhipinFilterRecommendCandidatesDepsForTests(override: Partial<ZhipinFilterRecommendCandidatesDeps> | undefined): void;
 export declare const zhipinFilterRecommendCandidates: import("@roll-agent/sdk").ToolDefinition<{