@roll-agent/browser-use-agent 0.13.0 → 0.15.0

package/dist/pages/zhipin/semantic-refs.d.ts

@@ -35,6 +35,7 @@ export declare function rememberZhipinCandidateRefs(candidates: readonly ZhipinC
 export declare function rememberZhipinRecommendJobRefs(jobs: readonly ZhipinRecommendJobRefSource[]): ZhipinRecommendJobRefTarget[];
 export declare function clearZhipinCandidateRefsForTests(): void;
 export declare function clearZhipinRecommendJobRefsForTests(): void;
+export declare function runWithZhipinSemanticRefScopeForTests<T>(scope: string, run: () => T): T;
 export declare function resolveZhipinCandidateRefTarget(candidateRef: string): ZhipinCandidateRefTarget;
 export declare function resolveZhipinRecommendJobRefTarget(jobRef: string): ZhipinRecommendJobRefTarget;
 export declare function resolveZhipinCandidateTargets(input: {

package/dist/runtime-config.d.ts

@@ -1,2 +1,336 @@
 import type { BrowserRuntimeConfig } from "@roll-agent/browser";
+import { z } from "zod";
+export declare const BrowserInstanceConfigSchema: z.ZodEffects<z.ZodObject<{
+    platform: z.ZodOptional<z.ZodEnum<["zhipin", "yupao"]>>;
+    mode: z.ZodDefault<z.ZodEnum<["managed-cdp", "remote-cdp", "existing-session"]>>;
+    headless: z.ZodOptional<z.ZodBoolean>;
+    cdpUrl: z.ZodOptional<z.ZodString>;
+    cdpHost: z.ZodDefault<z.ZodString>;
+    cdpPort: z.ZodOptional<z.ZodNumber>;
+    channel: z.ZodDefault<z.ZodEnum<["chrome", "chromium", "msedge"]>>;
+    executablePath: z.ZodOptional<z.ZodString>;
+    userDataDir: z.ZodString;
+    sessionsDir: z.ZodOptional<z.ZodString>;
+    args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    profileName: z.ZodOptional<z.ZodString>;
+    profileColor: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    windowBounds: z.ZodOptional<z.ZodObject<{
+        x: z.ZodOptional<z.ZodNumber>;
+        y: z.ZodOptional<z.ZodNumber>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        x?: number | undefined;
+        y?: number | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    }, {
+        x?: number | undefined;
+        y?: number | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    }>>;
+    trackingAgentId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    mode: "managed-cdp" | "remote-cdp" | "existing-session";
+    cdpHost: string;
+    channel: "chrome" | "chromium" | "msedge";
+    userDataDir: string;
+    headless?: boolean | undefined;
+    profileName?: string | undefined;
+    profileColor?: string | undefined;
+    cdpUrl?: string | undefined;
+    cdpPort?: number | undefined;
+    executablePath?: string | undefined;
+    args?: string[] | undefined;
+    windowBounds?: {
+        x?: number | undefined;
+        y?: number | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    } | undefined;
+    sessionsDir?: string | undefined;
+    platform?: "zhipin" | "yupao" | undefined;
+    trackingAgentId?: string | undefined;
+}, {
+    userDataDir: string;
+    mode?: "managed-cdp" | "remote-cdp" | "existing-session" | undefined;
+    headless?: boolean | undefined;
+    profileName?: string | undefined;
+    profileColor?: string | undefined;
+    cdpUrl?: string | undefined;
+    cdpHost?: string | undefined;
+    cdpPort?: number | undefined;
+    channel?: "chrome" | "chromium" | "msedge" | undefined;
+    executablePath?: string | undefined;
+    args?: string[] | undefined;
+    windowBounds?: {
+        x?: number | undefined;
+        y?: number | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    } | undefined;
+    sessionsDir?: string | undefined;
+    platform?: "zhipin" | "yupao" | undefined;
+    trackingAgentId?: string | undefined;
+}>, {
+    mode: "managed-cdp" | "remote-cdp" | "existing-session";
+    cdpHost: string;
+    channel: "chrome" | "chromium" | "msedge";
+    userDataDir: string;
+    headless?: boolean | undefined;
+    profileName?: string | undefined;
+    profileColor?: string | undefined;
+    cdpUrl?: string | undefined;
+    cdpPort?: number | undefined;
+    executablePath?: string | undefined;
+    args?: string[] | undefined;
+    windowBounds?: {
+        x?: number | undefined;
+        y?: number | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    } | undefined;
+    sessionsDir?: string | undefined;
+    platform?: "zhipin" | "yupao" | undefined;
+    trackingAgentId?: string | undefined;
+}, {
+    userDataDir: string;
+    mode?: "managed-cdp" | "remote-cdp" | "existing-session" | undefined;
+    headless?: boolean | undefined;
+    profileName?: string | undefined;
+    profileColor?: string | undefined;
+    cdpUrl?: string | undefined;
+    cdpHost?: string | undefined;
+    cdpPort?: number | undefined;
+    channel?: "chrome" | "chromium" | "msedge" | undefined;
+    executablePath?: string | undefined;
+    args?: string[] | undefined;
+    windowBounds?: {
+        x?: number | undefined;
+        y?: number | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+    } | undefined;
+    sessionsDir?: string | undefined;
+    platform?: "zhipin" | "yupao" | undefined;
+    trackingAgentId?: string | undefined;
+}>;
+export declare const BrowserInstancesConfigSchema: z.ZodEffects<z.ZodObject<{
+    defaultInstance: z.ZodOptional<z.ZodString>;
+    instances: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
+        platform: z.ZodOptional<z.ZodEnum<["zhipin", "yupao"]>>;
+        mode: z.ZodDefault<z.ZodEnum<["managed-cdp", "remote-cdp", "existing-session"]>>;
+        headless: z.ZodOptional<z.ZodBoolean>;
+        cdpUrl: z.ZodOptional<z.ZodString>;
+        cdpHost: z.ZodDefault<z.ZodString>;
+        cdpPort: z.ZodOptional<z.ZodNumber>;
+        channel: z.ZodDefault<z.ZodEnum<["chrome", "chromium", "msedge"]>>;
+        executablePath: z.ZodOptional<z.ZodString>;
+        userDataDir: z.ZodString;
+        sessionsDir: z.ZodOptional<z.ZodString>;
+        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        profileName: z.ZodOptional<z.ZodString>;
+        profileColor: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        windowBounds: z.ZodOptional<z.ZodObject<{
+            x: z.ZodOptional<z.ZodNumber>;
+            y: z.ZodOptional<z.ZodNumber>;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            x?: number | undefined;
+            y?: number | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        }, {
+            x?: number | undefined;
+            y?: number | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        }>>;
+        trackingAgentId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "managed-cdp" | "remote-cdp" | "existing-session";
+        cdpHost: string;
+        channel: "chrome" | "chromium" | "msedge";
+        userDataDir: string;
+        headless?: boolean | undefined;
+        profileName?: string | undefined;
+        profileColor?: string | undefined;
+        cdpUrl?: string | undefined;
+        cdpPort?: number | undefined;
+        executablePath?: string | undefined;
+        args?: string[] | undefined;
+        windowBounds?: {
+            x?: number | undefined;
+            y?: number | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        } | undefined;
+        sessionsDir?: string | undefined;
+        platform?: "zhipin" | "yupao" | undefined;
+        trackingAgentId?: string | undefined;
+    }, {
+        userDataDir: string;
+        mode?: "managed-cdp" | "remote-cdp" | "existing-session" | undefined;
+        headless?: boolean | undefined;
+        profileName?: string | undefined;
+        profileColor?: string | undefined;
+        cdpUrl?: string | undefined;
+        cdpHost?: string | undefined;
+        cdpPort?: number | undefined;
+        channel?: "chrome" | "chromium" | "msedge" | undefined;
+        executablePath?: string | undefined;
+        args?: string[] | undefined;
+        windowBounds?: {
+            x?: number | undefined;
+            y?: number | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        } | undefined;
+        sessionsDir?: string | undefined;
+        platform?: "zhipin" | "yupao" | undefined;
+        trackingAgentId?: string | undefined;
+    }>, {
+        mode: "managed-cdp" | "remote-cdp" | "existing-session";
+        cdpHost: string;
+        channel: "chrome" | "chromium" | "msedge";
+        userDataDir: string;
+        headless?: boolean | undefined;
+        profileName?: string | undefined;
+        profileColor?: string | undefined;
+        cdpUrl?: string | undefined;
+        cdpPort?: number | undefined;
+        executablePath?: string | undefined;
+        args?: string[] | undefined;
+        windowBounds?: {
+            x?: number | undefined;
+            y?: number | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        } | undefined;
+        sessionsDir?: string | undefined;
+        platform?: "zhipin" | "yupao" | undefined;
+        trackingAgentId?: string | undefined;
+    }, {
+        userDataDir: string;
+        mode?: "managed-cdp" | "remote-cdp" | "existing-session" | undefined;
+        headless?: boolean | undefined;
+        profileName?: string | undefined;
+        profileColor?: string | undefined;
+        cdpUrl?: string | undefined;
+        cdpHost?: string | undefined;
+        cdpPort?: number | undefined;
+        channel?: "chrome" | "chromium" | "msedge" | undefined;
+        executablePath?: string | undefined;
+        args?: string[] | undefined;
+        windowBounds?: {
+            x?: number | undefined;
+            y?: number | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        } | undefined;
+        sessionsDir?: string | undefined;
+        platform?: "zhipin" | "yupao" | undefined;
+        trackingAgentId?: string | undefined;
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    instances: Record<string, {
+        mode: "managed-cdp" | "remote-cdp" | "existing-session";
+        cdpHost: string;
+        channel: "chrome" | "chromium" | "msedge";
+        userDataDir: string;
+        headless?: boolean | undefined;
+        profileName?: string | undefined;
+        profileColor?: string | undefined;
+        cdpUrl?: string | undefined;
+        cdpPort?: number | undefined;
+        executablePath?: string | undefined;
+        args?: string[] | undefined;
+        windowBounds?: {
+            x?: number | undefined;
+            y?: number | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        } | undefined;
+        sessionsDir?: string | undefined;
+        platform?: "zhipin" | "yupao" | undefined;
+        trackingAgentId?: string | undefined;
+    }>;
+    defaultInstance?: string | undefined;
+}, {
+    instances?: Record<string, {
+        userDataDir: string;
+        mode?: "managed-cdp" | "remote-cdp" | "existing-session" | undefined;
+        headless?: boolean | undefined;
+        profileName?: string | undefined;
+        profileColor?: string | undefined;
+        cdpUrl?: string | undefined;
+        cdpHost?: string | undefined;
+        cdpPort?: number | undefined;
+        channel?: "chrome" | "chromium" | "msedge" | undefined;
+        executablePath?: string | undefined;
+        args?: string[] | undefined;
+        windowBounds?: {
+            x?: number | undefined;
+            y?: number | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        } | undefined;
+        sessionsDir?: string | undefined;
+        platform?: "zhipin" | "yupao" | undefined;
+        trackingAgentId?: string | undefined;
+    }> | undefined;
+    defaultInstance?: string | undefined;
+}>, {
+    instances: Record<string, {
+        mode: "managed-cdp" | "remote-cdp" | "existing-session";
+        cdpHost: string;
+        channel: "chrome" | "chromium" | "msedge";
+        userDataDir: string;
+        headless?: boolean | undefined;
+        profileName?: string | undefined;
+        profileColor?: string | undefined;
+        cdpUrl?: string | undefined;
+        cdpPort?: number | undefined;
+        executablePath?: string | undefined;
+        args?: string[] | undefined;
+        windowBounds?: {
+            x?: number | undefined;
+            y?: number | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        } | undefined;
+        sessionsDir?: string | undefined;
+        platform?: "zhipin" | "yupao" | undefined;
+        trackingAgentId?: string | undefined;
+    }>;
+    defaultInstance?: string | undefined;
+}, {
+    instances?: Record<string, {
+        userDataDir: string;
+        mode?: "managed-cdp" | "remote-cdp" | "existing-session" | undefined;
+        headless?: boolean | undefined;
+        profileName?: string | undefined;
+        profileColor?: string | undefined;
+        cdpUrl?: string | undefined;
+        cdpHost?: string | undefined;
+        cdpPort?: number | undefined;
+        channel?: "chrome" | "chromium" | "msedge" | undefined;
+        executablePath?: string | undefined;
+        args?: string[] | undefined;
+        windowBounds?: {
+            x?: number | undefined;
+            y?: number | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+        } | undefined;
+        sessionsDir?: string | undefined;
+        platform?: "zhipin" | "yupao" | undefined;
+        trackingAgentId?: string | undefined;
+    }> | undefined;
+    defaultInstance?: string | undefined;
+}>;
+export type BrowserInstancesConfig = z.infer<typeof BrowserInstancesConfigSchema>;
 export declare function loadRuntimeConfigFromEnv(env?: NodeJS.ProcessEnv): BrowserRuntimeConfig;
+export declare function loadBrowserInstancesConfigFromEnv(env?: NodeJS.ProcessEnv): BrowserInstancesConfig | undefined;

package/dist/runtime-holder.d.ts

@@ -1,14 +1,23 @@
 import { BrowserRuntime, BrowserContextManager, SessionStore } from "@roll-agent/browser";
 import type { BrowserRuntimeConfig } from "@roll-agent/browser";
-export declare function initRuntime(config: BrowserRuntimeConfig): Promise<void>;
+import { BrowserInstancePool, type BrowserRuntimeBundle } from "./browser-instance-pool.ts";
+import type { BrowserInstancesConfig } from "./runtime-config.ts";
+export declare function initRuntime(config: BrowserRuntimeConfig, instancesConfig?: BrowserInstancesConfig): Promise<void>;
 export declare function getRuntime(): BrowserRuntime;
 export declare function getContextManager(): BrowserContextManager;
 export declare function getSessionStore(): SessionStore;
 export declare function setReplyAuthorityKeysLoaded(loaded: boolean): void;
 export declare function getReplyAuthorityKeysLoaded(): boolean;
+export declare function getBrowserInstancePoolOrUndefined(): BrowserInstancePool | undefined;
+export declare function getBrowserInstancePool(): BrowserInstancePool;
+export declare function ensureCurrentBundleStarted(): Promise<void>;
+export declare function isConfiguredMultiBrowserInstancePool(): boolean;
+export declare function resolveRecruitmentTrackingAgentId(defaultAgentId?: string): string | undefined;
+export declare function getCurrentBrowserBundle(): BrowserRuntimeBundle;
 export declare function setRuntimeStateForTests(state: {
     readonly runtime?: BrowserRuntime;
     readonly contextManager?: BrowserContextManager;
     readonly sessionStore?: SessionStore;
+    readonly instancePool?: BrowserInstancePool;
 }): void;
 export declare function shutdownRuntime(): Promise<void>;

package/dist/tools/browser-instance-input.d.ts

@@ -0,0 +1,8 @@
+import type { AnyToolDefinition } from "@roll-agent/sdk";
+import type { Platform } from "@roll-agent/browser";
+export interface BrowserInstanceToolOptions {
+    readonly startRuntime?: boolean;
+    readonly expectedPlatform?: Platform;
+}
+export declare function inferExpectedPlatformFromToolName(toolName: string): Platform | undefined;
+export declare function withBrowserInstanceInput(tool: AnyToolDefinition, options?: BrowserInstanceToolOptions): AnyToolDefinition;

package/dist/tools/browser-instance-platform.d.ts

@@ -0,0 +1,3 @@
+import type { Platform } from "@roll-agent/browser";
+export declare function assertBrowserInstancePlatform(platform: Platform | undefined): void;
+export declare function readPlatformFromToolInput(input: unknown): Platform | undefined;

package/dist/tools/browser-ref-schemas.d.ts

@@ -11,22 +11,22 @@ export declare const BrowserElementRefTargetSchema: z.ZodObject<{
     frameId: z.ZodOptional<z.ZodString>;
     disabled: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
+    x: number;
+    y: number;
     ref: string;
     role: string;
     name: string;
     disabled: boolean;
-    x: number;
-    y: number;
     resolvedBy: "backend_node_id" | "role_name_nth";
     backendNodeId?: number | undefined;
     frameId?: string | undefined;
 }, {
+    x: number;
+    y: number;
     ref: string;
     role: string;
     name: string;
     disabled: boolean;
-    x: number;
-    y: number;
     resolvedBy: "backend_node_id" | "role_name_nth";
     backendNodeId?: number | undefined;
     frameId?: string | undefined;
@@ -46,22 +46,22 @@ export declare const BrowserElementRefActionOutputSchema: z.ZodObject<{
         frameId: z.ZodOptional<z.ZodString>;
         disabled: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
+        x: number;
+        y: number;
         ref: string;
         role: string;
         name: string;
         disabled: boolean;
-        x: number;
-        y: number;
         resolvedBy: "backend_node_id" | "role_name_nth";
         backendNodeId?: number | undefined;
         frameId?: string | undefined;
     }, {
+        x: number;
+        y: number;
         ref: string;
         role: string;
         name: string;
         disabled: boolean;
-        x: number;
-        y: number;
         resolvedBy: "backend_node_id" | "role_name_nth";
         backendNodeId?: number | undefined;
         frameId?: string | undefined;
@@ -69,12 +69,12 @@ export declare const BrowserElementRefActionOutputSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     ref: string;
     target: {
+        x: number;
+        y: number;
         ref: string;
         role: string;
         name: string;
         disabled: boolean;
-        x: number;
-        y: number;
         resolvedBy: "backend_node_id" | "role_name_nth";
         backendNodeId?: number | undefined;
         frameId?: string | undefined;
@@ -84,12 +84,12 @@ export declare const BrowserElementRefActionOutputSchema: z.ZodObject<{
 }, {
     ref: string;
     target: {
+        x: number;
+        y: number;
         ref: string;
         role: string;
         name: string;
         disabled: boolean;
-        x: number;
-        y: number;
         resolvedBy: "backend_node_id" | "role_name_nth";
         backendNodeId?: number | undefined;
         frameId?: string | undefined;

package/dist/tools/browser-status.d.ts

@@ -14,6 +14,7 @@ export declare const browserStatus: import("@roll-agent/sdk").ToolDefinition<{},
         pagesOpen: number;
         hasLoginState: boolean | null;
         loginStateSource: "snapshot" | "profile" | "none" | "unknown";
+        browserInstance?: string | undefined;
         currentUrl?: string | undefined;
     }[];
     replyAuthorityKeysLoaded: boolean;
@@ -33,4 +34,26 @@ export declare const browserStatus: import("@roll-agent/sdk").ToolDefinition<{},
         present: boolean;
         fingerprint?: string | undefined;
     }>;
+    defaultInstanceId?: string | undefined;
+    primaryInstanceId?: string | undefined;
+    instances?: {
+        id: string;
+        mode: "managed-cdp" | "remote-cdp" | "existing-session";
+        profile: {
+            exists: boolean;
+            writable: boolean;
+            userDataDir?: string | undefined;
+        };
+        cdp: {
+            endpoint: string;
+            versionReachable: boolean;
+            listReachable: boolean;
+            port?: number | undefined;
+        };
+        tracking: {
+            source: "instance" | "default-env" | "missing";
+            agentIdFingerprint?: string | undefined;
+        };
+        platform?: "zhipin" | "yupao" | undefined;
+    }[] | undefined;
 }>;

package/dist/tools/browser-stop.d.ts

@@ -0,0 +1,80 @@
+import { z } from "zod";
+import { type BrowserInstanceStopResult } from "../browser-instance-pool.ts";
+declare const BrowserStopInputSchema: z.ZodEffects<z.ZodObject<{
+    browserInstance: z.ZodOptional<z.ZodString>;
+    browserInstances: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    all: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    browserInstance?: string | undefined;
+    browserInstances?: string[] | undefined;
+    all?: boolean | undefined;
+}, {
+    browserInstance?: string | undefined;
+    browserInstances?: string[] | undefined;
+    all?: boolean | undefined;
+}>, {
+    browserInstance?: string | undefined;
+    browserInstances?: string[] | undefined;
+    all?: boolean | undefined;
+}, {
+    browserInstance?: string | undefined;
+    browserInstances?: string[] | undefined;
+    all?: boolean | undefined;
+}>;
+declare const BrowserStopOutputSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    stopped: z.ZodNumber;
+    results: z.ZodArray<z.ZodObject<{
+        browserInstance: z.ZodString;
+        status: z.ZodEnum<["stopped", "not_running", "not_found", "failed"]>;
+        mode: z.ZodOptional<z.ZodEnum<["managed-cdp", "remote-cdp", "existing-session"]>>;
+        message: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "not_found" | "failed" | "stopped" | "not_running";
+        browserInstance: string;
+        message?: string | undefined;
+        mode?: "managed-cdp" | "remote-cdp" | "existing-session" | undefined;
+    }, {
+        status: "not_found" | "failed" | "stopped" | "not_running";
+        browserInstance: string;
+        message?: string | undefined;
+        mode?: "managed-cdp" | "remote-cdp" | "existing-session" | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    stopped: number;
+    ok: boolean;
+    results: {
+        status: "not_found" | "failed" | "stopped" | "not_running";
+        browserInstance: string;
+        message?: string | undefined;
+        mode?: "managed-cdp" | "remote-cdp" | "existing-session" | undefined;
+    }[];
+}, {
+    stopped: number;
+    ok: boolean;
+    results: {
+        status: "not_found" | "failed" | "stopped" | "not_running";
+        browserInstance: string;
+        message?: string | undefined;
+        mode?: "managed-cdp" | "remote-cdp" | "existing-session" | undefined;
+    }[];
+}>;
+type BrowserStopInput = z.infer<typeof BrowserStopInputSchema>;
+type BrowserStopOutput = z.infer<typeof BrowserStopOutputSchema>;
+export declare const browserStop: import("@roll-agent/sdk").ToolDefinition<{
+    browserInstance?: string | undefined;
+    browserInstances?: string[] | undefined;
+    all?: boolean | undefined;
+}, {
+    stopped: number;
+    ok: boolean;
+    results: {
+        status: "not_found" | "failed" | "stopped" | "not_running";
+        browserInstance: string;
+        message?: string | undefined;
+        mode?: "managed-cdp" | "remote-cdp" | "existing-session" | undefined;
+    }[];
+}>;
+export declare function resolveBrowserStopTargets(input: BrowserStopInput, availableInstances: readonly string[]): readonly string[];
+export declare function createBrowserStopOutput(results: readonly BrowserInstanceStopResult[]): BrowserStopOutput;
+export {};

package/dist/tools/click-ref.d.ts

@@ -7,12 +7,12 @@ export declare const clickRef: import("@roll-agent/sdk").ToolDefinition<{
 }, {
     ref: string;
     target: {
+        x: number;
+        y: number;
         ref: string;
         role: string;
         name: string;
         disabled: boolean;
-        x: number;
-        y: number;
         resolvedBy: "backend_node_id" | "role_name_nth";
         backendNodeId?: number | undefined;
         frameId?: string | undefined;

package/dist/tools/type-ref.d.ts

@@ -9,12 +9,12 @@ export declare const typeRef: import("@roll-agent/sdk").ToolDefinition<{
 }, {
     ref: string;
     target: {
+        x: number;
+        y: number;
         ref: string;
         role: string;
         name: string;
         disabled: boolean;
-        x: number;
-        y: number;
         resolvedBy: "backend_node_id" | "role_name_nth";
         backendNodeId?: number | undefined;
         frameId?: string | undefined;

package/dist/tools/zhipin-get-username.d.ts

@@ -11,8 +11,8 @@ export declare function setZhipinGetUsernameDepsForTests(override: Partial<Zhipi
 export declare const zhipinGetUsername: import("@roll-agent/sdk").ToolDefinition<{}, {
     success: boolean;
     username: string;
-    error?: string | undefined;
     source?: string | undefined;
+    error?: string | undefined;
     usedSelector?: string | undefined;
     usedStrategy?: string | undefined;
 }>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roll-agent/browser-use-agent",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -47,7 +47,7 @@
     "zod": "^3.25.76",
     "@roll-agent/reply-authority-client": "0.1.2",
     "@roll-agent/sdk": "0.2.0",
-    "@roll-agent/browser": "0.6.0"
+    "@roll-agent/browser": "0.8.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"

package/references/env.yaml

@@ -9,7 +9,7 @@ required:
     purpose: Reply Authority Service 公钥分发端点；`zhipin_send_prepared_reply` 启动预热和本地 Ed25519 验签都依赖它
     example: https://reply-authority.duliday.com/.well-known/reply-authority-keys
   - name: RECRUITMENT_EVENTS_DEFAULT_AGENT_ID
-    purpose: 单 browser-use 实例 / 单 Boss 账号部署下的默认招聘业务 Agent ID；招聘事件默认启用，上报时必须用它做归因
+    purpose: 单 browser-use 实例 / 单 Boss 账号部署下的默认招聘业务 Agent ID；多 browser.instances 下仅作为实例缺少 trackingAgentId 时的 fallback；招聘事件默认启用，上报时必须有可解析归因
     example: zhipin-shanghai-kfc-001
   - name: RECRUITMENT_EVENTS_API_TOKEN
     purpose: 招聘事件 Open API Bearer token；公开 npm 包不内置兜底 token，必须由部署环境提供
@@ -31,6 +31,12 @@ optional:
     purpose: browser-use 工具级业务策略 JSON；可按 exact tool name 配置 log、deny、confirm
     default: '{"approvalTtlMs":300000,"tools":{}}'
     example: '{"approvalTtlMs":300000,"tools":{"zhipin_send_prepared_reply":{"policy":"confirm"}}}'
+  - name: BROWSER_PROFILE_COLOR
+    purpose: legacy 单浏览器运行时的 Chrome profile 颜色，格式为 `#RRGGBB`；配置了 `browser.instances` 时由每个实例的 profileColor 接管，此 env 会被忽略
+    example: "#2563EB"
+  - name: BROWSER_INSTANCES_JSON
+    purpose: Roll core 注入的多浏览器实例声明 JSON；由 `browser.instances` 派生，包含每个实例的 profile、CDP 端口、session 目录、可选 profileName/profileColor/windowBounds 和招聘事件归因 ID；orchestrator 不应手工拼接，手工配置时必须保持 cdpPort/userDataDir 唯一
+    example: '{"defaultInstance":"boss-a","instances":{"boss-a":{"platform":"zhipin","mode":"managed-cdp","cdpPort":9222,"userDataDir":"/tmp/roll-browser/profiles/boss-a","profileName":"boss-a","profileColor":"#2563EB","windowBounds":{"x":0,"y":0,"width":680,"height":1000},"trackingAgentId":"zhipin-boss-a"}}}'
   - name: BROWSER_VISUAL_CURSOR
     purpose: 在可见浏览器页面内显示 browser-use 的页内虚拟指针和点击波纹；默认开启，设为 `"false"` 可关闭
     default: "true"