@browserbasehq/orca 3.1.0-patch.0 → 3.1.0-patch.2

package/dist/cjs/lib/v3/v3.d.ts

@@ -0,0 +1,191 @@
+import { EventEmitter } from "events";
+import { z } from "zod";
+import { InferStagehandSchema, StagehandZodSchema } from "./zodCompat.js";
+import { LLMClient } from "./llm/LLMClient.js";
+import { AgentReplayStep } from "./types/private/index.js";
+import { AgentConfig, AgentExecuteOptions, AgentStreamExecuteOptions, AgentResult, LogLine, StagehandMetrics, Action, ActOptions, ActResult, defaultExtractSchema, ExtractOptions, HistoryEntry, ObserveOptions, pageTextSchema, V3FunctionName, V3Options, AgentStreamResult } from "./types/public/index.js";
+import { V3Context } from "./understudy/context.js";
+/**
+ * V3
+ *
+ * Purpose:
+ * A high-level orchestrator for Stagehand V3. Abstracts away whether the browser
+ * runs **locally via Chrome** or remotely on **Browserbase**, and exposes simple
+ * entrypoints (`act`, `extract`, `observe`) that delegate to the corresponding
+ * handler classes.
+ *
+ * Responsibilities:
+ * - Bootstraps Chrome or Browserbase, ensures a working CDP WebSocket, and builds a `V3Context`.
+ * - Manages lifecycle: init, context access, cleanup.
+ * - Bridges external page objects (Playwright/Puppeteer) into internal frameIds for handlers.
+ * - Provides a stable API surface for downstream code regardless of runtime environment.
+ */
+export declare class V3 {
+    private readonly opts;
+    private state;
+    private actHandler;
+    private extractHandler;
+    private observeHandler;
+    private ctx;
+    llmClient: LLMClient;
+    /**
+     * Event bus for internal communication.
+     * Emits events like 'screenshot' when screenshots are captured during agent execution.
+     */
+    readonly bus: EventEmitter;
+    private modelName;
+    private modelClientOptions;
+    private llmProvider;
+    private overrideLlmClients;
+    private readonly domSettleTimeoutMs?;
+    private _isClosing;
+    browserbaseSessionId?: string;
+    private browserbaseSessionUrl?;
+    private browserbaseDebugUrl?;
+    get browserbaseSessionID(): string | undefined;
+    get browserbaseSessionURL(): string | undefined;
+    get browserbaseDebugURL(): string | undefined;
+    /**
+     * Returns true if the browser is running on Browserbase.
+     */
+    get isBrowserbase(): boolean;
+    /**
+     * Returns true if advancedStealth is enabled in Browserbase settings.
+     */
+    get isAdvancedStealth(): boolean;
+    /**
+     * Returns the configured viewport dimensions from launch options.
+     * Falls back to default 1288x711 if not configured.
+     */
+    get configuredViewport(): {
+        width: number;
+        height: number;
+    };
+    private _onCdpClosed;
+    readonly experimental: boolean;
+    readonly logInferenceToFile: boolean;
+    readonly disableAPI: boolean;
+    private externalLogger?;
+    verbose: 0 | 1 | 2;
+    private stagehandLogger;
+    private _history;
+    private readonly instanceId;
+    private static _processGuardsInstalled;
+    private static _instances;
+    private cacheStorage;
+    private actCache;
+    private agentCache;
+    private apiClient;
+    private keepAlive?;
+    private shutdownSupervisor;
+    stagehandMetrics: StagehandMetrics;
+    constructor(opts: V3Options);
+    /**
+     * Async property for metrics so callers can `await v3.metrics`.
+     * When using API mode, fetches metrics from the API. Otherwise returns local metrics.
+     */
+    get metrics(): Promise<StagehandMetrics>;
+    private resolveLlmClient;
+    private beginAgentReplayRecording;
+    private endAgentReplayRecording;
+    private discardAgentReplayRecording;
+    private isAgentReplayRecording;
+    isAgentReplayActive(): boolean;
+    recordAgentReplayStep(step: AgentReplayStep): void;
+    /**
+     * Async property for history so callers can `await v3.history`.
+     * Returns a frozen copy to avoid external mutation.
+     */
+    get history(): Promise<ReadonlyArray<HistoryEntry>>;
+    addToHistory(method: HistoryEntry["method"], parameters: unknown, result?: unknown): void;
+    updateMetrics(functionName: V3FunctionName, promptTokens: number, completionTokens: number, reasoningTokens: number, cachedInputTokens: number, inferenceTimeMs: number): void;
+    private updateTotalMetrics;
+    private _immediateShutdown;
+    /** Spawn a crash-only supervisor that cleans up when this process dies. */
+    private startShutdownSupervisor;
+    /** Stop the supervisor during a normal shutdown. */
+    private stopShutdownSupervisor;
+    /**
+     * Entrypoint: initializes handlers, launches Chrome or Browserbase,
+     * and sets up a CDP context.
+     */
+    init(): Promise<void>;
+    /** Apply post-connect local browser options that require CDP. */
+    private _applyPostConnectLocalOptions;
+    private _ensureBrowserbaseDownloadsEnabled;
+    private resetBrowserbaseSessionMetadata;
+    /**
+     * Run an "act" instruction through the ActHandler.
+     *
+     * New API:
+     * - act(instruction: string, options?: ActOptions)
+     * - act(action: Action, options?: ActOptions)
+     */
+    act(instruction: string, options?: ActOptions): Promise<ActResult>;
+    act(action: Action, options?: ActOptions): Promise<ActResult>;
+    /**
+     * Run an "extract" instruction through the ExtractHandler.
+     *
+     * Accepted forms:
+     * - extract() → pageText
+     * - extract(options) → pageText
+     * - extract(instruction) → defaultExtractSchema
+     * - extract(instruction, schema) → schema-inferred
+     * - extract(instruction, schema, options)
+     */
+    extract(): Promise<z.infer<typeof pageTextSchema>>;
+    extract(options: ExtractOptions): Promise<z.infer<typeof pageTextSchema>>;
+    extract(instruction: string, options?: ExtractOptions): Promise<z.infer<typeof defaultExtractSchema>>;
+    extract<T extends StagehandZodSchema>(instruction: string, schema: T, options?: ExtractOptions): Promise<InferStagehandSchema<T>>;
+    /**
+     * Run an "observe" instruction through the ObserveHandler.
+     */
+    observe(): Promise<Action[]>;
+    observe(options: ObserveOptions): Promise<Action[]>;
+    observe(instruction: string, options?: ObserveOptions): Promise<Action[]>;
+    /** Return the browser-level CDP WebSocket endpoint. */
+    connectURL(): string;
+    /** Expose the current CDP-backed context. */
+    get context(): V3Context;
+    /** Best-effort cleanup of context and launched resources. */
+    close(opts?: {
+        force?: boolean;
+    }): Promise<void>;
+    /** Guard: ensure Browserbase credentials exist in options. */
+    private requireBrowserbaseCreds;
+    get logger(): (logLine: LogLine) => void;
+    /**
+     * Normalize a Playwright/Puppeteer page object into its top frame id,
+     * so handlers can resolve it to a `Page` within our V3Context.
+     */
+    private resolveTopFrameId;
+    private isPlaywrightPage;
+    private isPatchrightPage;
+    private isPuppeteerPage;
+    /** Resolve an external page reference or fall back to the active V3 page. */
+    private resolvePage;
+    private normalizeToV3Page;
+    private _logBrowserbaseSessionStatus;
+    /**
+     * Prepares shared context for agent execution (both execute and stream).
+     * Extracts duplicated setup logic into a single helper.
+     */
+    private prepareAgentExecution;
+    /**
+     * Create a v3 agent instance (AISDK tool-based) with execute().
+     * Mirrors the v2 Stagehand.agent() tool mode (no CUA provider here).
+     *
+     * @overload When stream: true, returns a streaming agent where execute() returns AgentStreamResult
+     * @overload When stream is false/undefined, returns a non-streaming agent where execute() returns AgentResult
+     */
+    agent(options: AgentConfig & {
+        stream: true;
+    }): {
+        execute: (instructionOrOptions: string | AgentStreamExecuteOptions) => Promise<AgentStreamResult>;
+    };
+    agent(options?: AgentConfig & {
+        stream?: false;
+    }): {
+        execute: (instructionOrOptions: string | AgentExecuteOptions) => Promise<AgentResult>;
+    };
+}

package/dist/cjs/lib/v3/zodCompat.d.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+import type { ZodObject as Zod4Object, ZodRawShape as Zod4RawShape, ZodTypeAny as Zod4TypeAny } from "zod";
+import type * as z3 from "zod/v3";
+export type StagehandZodSchema = Zod4TypeAny | z3.ZodTypeAny;
+export type StagehandZodObject = Zod4Object<Zod4RawShape> | z3.ZodObject<z3.ZodRawShape>;
+export type InferStagehandSchema<T extends StagehandZodSchema> = T extends z3.ZodTypeAny ? z3.infer<T> : T extends Zod4TypeAny ? z.infer<T> : never;
+export declare const isZod4Schema: (schema: StagehandZodSchema) => schema is Zod4TypeAny & {
+    _zod: unknown;
+};
+export declare const isZod3Schema: (schema: StagehandZodSchema) => schema is z3.ZodTypeAny;
+export type JsonSchemaDocument = Record<string, unknown>;
+export declare function toJsonSchema(schema: StagehandZodSchema): JsonSchemaDocument;

package/dist/cjs/lib/v3Evaluator.d.ts

@@ -0,0 +1,19 @@
+/**
+ * V3Evaluator mirrors Evaluator but operates on a V3 instance instead of Stagehand.
+ * It uses the V3 page/screenshot APIs and constructs an LLM client to run
+ * structured evaluations (YES/NO with reasoning) on screenshots and/or text.
+ */
+import type { AvailableModel, ClientOptions } from "./v3/types/public/model.js";
+import type { EvaluateOptions, BatchAskOptions, EvaluationResult } from "./v3/types/private/evaluator.js";
+import { V3 } from "./v3/v3.js";
+export declare class V3Evaluator {
+    private v3;
+    private modelName;
+    private modelClientOptions;
+    private silentLogger;
+    constructor(v3: V3, modelName?: AvailableModel, modelClientOptions?: ClientOptions);
+    private getClient;
+    ask(options: EvaluateOptions): Promise<EvaluationResult>;
+    batchAsk(options: BatchAskOptions): Promise<EvaluationResult[]>;
+    private _evaluateWithMultipleScreenshots;
+}

package/dist/cjs/lib/version.d.ts

@@ -0,0 +1,5 @@
+/**
+ * AUTO-GENERATED — DO NOT EDIT BY HAND
+ *  Run `pnpm run gen-version` to refresh.
+ */
+export declare const STAGEHAND_VERSION: "3.0.8";

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/cjs/tests/browserbase-session-accessors.test.js

@@ -0,0 +1,101 @@
+var import_vitest = require("vitest");
+var import_v3 = require("../lib/v3/v3.js");
+const MOCK_SESSION_ID = "session-123";
+const MOCK_SESSION_URL = `https://www.browserbase.com/sessions/${MOCK_SESSION_ID}`;
+const MOCK_DEBUG_URL = `https://debug.browserbase.com/${MOCK_SESSION_ID}`;
+import_vitest.vi.mock("../lib/v3/understudy/context", () => {
+  class MockConnection {
+    onTransportClosed = import_vitest.vi.fn();
+    offTransportClosed = import_vitest.vi.fn();
+    send = import_vitest.vi.fn(async () => {
+    });
+  }
+  class MockV3Context {
+    static async create() {
+      return new MockV3Context();
+    }
+    conn = new MockConnection();
+    pages() {
+      return [];
+    }
+    async close() {
+    }
+  }
+  return { V3Context: MockV3Context };
+});
+import_vitest.vi.mock("../lib/v3/launch/browserbase", () => ({
+  createBrowserbaseSession: import_vitest.vi.fn(async () => ({
+    ws: "wss://mock-browserbase",
+    sessionId: MOCK_SESSION_ID,
+    bb: {
+      sessions: {
+        debug: import_vitest.vi.fn(async () => ({ debuggerUrl: MOCK_DEBUG_URL }))
+      }
+    }
+  }))
+}));
+import_vitest.vi.mock("../lib/v3/launch/local", () => ({
+  launchLocalChrome: import_vitest.vi.fn(async () => ({
+    ws: "ws://local-cdp",
+    chrome: { kill: import_vitest.vi.fn(async () => {
+    }) }
+  }))
+}));
+(0, import_vitest.describe)("browserbase accessors", () => {
+  (0, import_vitest.beforeEach)(() => {
+    process.env.BROWSERBASE_API_KEY = "fake-key";
+    process.env.BROWSERBASE_PROJECT_ID = "fake-project";
+  });
+  (0, import_vitest.afterEach)(() => {
+    delete process.env.BROWSERBASE_API_KEY;
+    delete process.env.BROWSERBASE_PROJECT_ID;
+    import_vitest.vi.clearAllMocks();
+  });
+  (0, import_vitest.it)("exposes Browserbase session and debug URLs after init", async () => {
+    const v3 = new import_v3.V3({
+      env: "BROWSERBASE",
+      disableAPI: true,
+      verbose: 0
+    });
+    try {
+      await v3.init();
+      (0, import_vitest.expect)(v3.browserbaseSessionURL).toBe(MOCK_SESSION_URL);
+      (0, import_vitest.expect)(v3.browserbaseDebugURL).toBe(MOCK_DEBUG_URL);
+    } finally {
+      await v3.close().catch(() => {
+      });
+    }
+  });
+  (0, import_vitest.it)("clears stored URLs after close", async () => {
+    const v3 = new import_v3.V3({
+      env: "BROWSERBASE",
+      disableAPI: true,
+      verbose: 0
+    });
+    await v3.init();
+    await v3.close();
+    (0, import_vitest.expect)(v3.browserbaseSessionURL).toBeUndefined();
+    (0, import_vitest.expect)(v3.browserbaseDebugURL).toBeUndefined();
+  });
+});
+(0, import_vitest.describe)("local accessors", () => {
+  (0, import_vitest.it)("stay empty for LOCAL environments", async () => {
+    const v3 = new import_v3.V3({
+      env: "LOCAL",
+      disableAPI: true,
+      verbose: 0,
+      localBrowserLaunchOptions: {
+        cdpUrl: "ws://local-existing-session"
+      }
+    });
+    try {
+      await v3.init();
+      (0, import_vitest.expect)(v3.browserbaseSessionURL).toBeUndefined();
+      (0, import_vitest.expect)(v3.browserbaseDebugURL).toBeUndefined();
+    } finally {
+      await v3.close().catch(() => {
+      });
+    }
+  });
+});
+//# sourceMappingURL=browserbase-session-accessors.test.js.map

package/dist/cjs/tests/browserbase-session-accessors.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../tests/browserbase-session-accessors.test.ts"],
+  "sourcesContent": ["import { describe, expect, it, vi, beforeEach, afterEach } from \"vitest\";\nimport { V3 } from \"../lib/v3/v3.js\";\n\nconst MOCK_SESSION_ID = \"session-123\";\nconst MOCK_SESSION_URL = `https://www.browserbase.com/sessions/${MOCK_SESSION_ID}`;\nconst MOCK_DEBUG_URL = `https://debug.browserbase.com/${MOCK_SESSION_ID}`;\n\nvi.mock(\"../lib/v3/understudy/context\", () => {\n  class MockConnection {\n    onTransportClosed = vi.fn();\n    offTransportClosed = vi.fn();\n    send = vi.fn(async () => {});\n  }\n\n  class MockV3Context {\n    static async create(): Promise<MockV3Context> {\n      return new MockV3Context();\n    }\n\n    conn = new MockConnection();\n\n    pages(): never[] {\n      return [];\n    }\n\n    async close(): Promise<void> {\n      // noop\n    }\n  }\n\n  return { V3Context: MockV3Context };\n});\n\nvi.mock(\"../lib/v3/launch/browserbase\", () => ({\n  createBrowserbaseSession: vi.fn(async () => ({\n    ws: \"wss://mock-browserbase\",\n    sessionId: MOCK_SESSION_ID,\n    bb: {\n      sessions: {\n        debug: vi.fn(async () => ({ debuggerUrl: MOCK_DEBUG_URL })),\n      },\n    },\n  })),\n}));\n\nvi.mock(\"../lib/v3/launch/local\", () => ({\n  launchLocalChrome: vi.fn(async () => ({\n    ws: \"ws://local-cdp\",\n    chrome: { kill: vi.fn(async () => {}) },\n  })),\n}));\n\ndescribe(\"browserbase accessors\", () => {\n  beforeEach(() => {\n    process.env.BROWSERBASE_API_KEY = \"fake-key\";\n    process.env.BROWSERBASE_PROJECT_ID = \"fake-project\";\n  });\n\n  afterEach(() => {\n    delete process.env.BROWSERBASE_API_KEY;\n    delete process.env.BROWSERBASE_PROJECT_ID;\n    vi.clearAllMocks();\n  });\n\n  it(\"exposes Browserbase session and debug URLs after init\", async () => {\n    const v3 = new V3({\n      env: \"BROWSERBASE\",\n      disableAPI: true,\n      verbose: 0,\n    });\n\n    try {\n      await v3.init();\n\n      expect(v3.browserbaseSessionURL).toBe(MOCK_SESSION_URL);\n      expect(v3.browserbaseDebugURL).toBe(MOCK_DEBUG_URL);\n    } finally {\n      await v3.close().catch(() => {});\n    }\n  });\n\n  it(\"clears stored URLs after close\", async () => {\n    const v3 = new V3({\n      env: \"BROWSERBASE\",\n      disableAPI: true,\n      verbose: 0,\n    });\n\n    await v3.init();\n    await v3.close();\n\n    expect(v3.browserbaseSessionURL).toBeUndefined();\n    expect(v3.browserbaseDebugURL).toBeUndefined();\n  });\n});\n\ndescribe(\"local accessors\", () => {\n  it(\"stay empty for LOCAL environments\", async () => {\n    const v3 = new V3({\n      env: \"LOCAL\",\n      disableAPI: true,\n      verbose: 0,\n      localBrowserLaunchOptions: {\n        cdpUrl: \"ws://local-existing-session\",\n      },\n    });\n\n    try {\n      await v3.init();\n      expect(v3.browserbaseSessionURL).toBeUndefined();\n      expect(v3.browserbaseDebugURL).toBeUndefined();\n    } finally {\n      await v3.close().catch(() => {});\n    }\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/tests/cache-llm-resolution.test.js

@@ -0,0 +1,187 @@
+var import_vitest = require("vitest");
+var import_ActCache = require("../lib/v3/cache/ActCache.js");
+var import_AgentCache = require("../lib/v3/cache/AgentCache.js");
+function createFakeStorage(entry) {
+  return {
+    enabled: true,
+    readJson: import_vitest.vi.fn().mockResolvedValue({ value: entry }),
+    writeJson: import_vitest.vi.fn().mockResolvedValue({}),
+    directory: "/tmp/cache"
+  };
+}
+(0, import_vitest.describe)("Cache LLM client selection", () => {
+  (0, import_vitest.it)("ActCache uses provided override client during replay", async () => {
+    const action = {
+      selector: "xpath=/html/body/button",
+      description: "click button",
+      method: "click",
+      arguments: []
+    };
+    const entry = {
+      version: 1,
+      instruction: "click button",
+      url: "https://example.com",
+      variableKeys: [],
+      actions: [action],
+      actionDescription: "click button",
+      message: "done"
+    };
+    const storage = createFakeStorage(entry);
+    const handler = {
+      takeDeterministicAction: import_vitest.vi.fn().mockResolvedValue({
+        success: true,
+        message: "ok",
+        actionDescription: "click button",
+        actions: [action]
+      })
+    };
+    const defaultClient = { id: "default" };
+    const overrideClient = { id: "override" };
+    const cache = new import_ActCache.ActCache({
+      storage,
+      logger: import_vitest.vi.fn(),
+      getActHandler: () => handler,
+      getDefaultLlmClient: () => defaultClient,
+      domSettleTimeoutMs: void 0
+    });
+    const context = {
+      instruction: "click button",
+      cacheKey: "abc",
+      pageUrl: "https://example.com",
+      variableKeys: [],
+      variables: void 0
+    };
+    const result = await cache.tryReplay(
+      context,
+      {},
+      void 0,
+      overrideClient
+    );
+    (0, import_vitest.expect)(result?.success).toBe(true);
+    (0, import_vitest.expect)(handler.takeDeterministicAction).toHaveBeenCalledTimes(1);
+    const call = import_vitest.vi.mocked(handler.takeDeterministicAction).mock.calls[0];
+    (0, import_vitest.expect)(call?.[3]).toBe(overrideClient);
+  });
+  (0, import_vitest.it)("AgentCache uses provided override client during replay", async () => {
+    const action = {
+      selector: "xpath=/html/body/input",
+      description: "type email",
+      method: "type",
+      arguments: ["test@example.com"]
+    };
+    const agentStep = {
+      type: "act",
+      instruction: "type email",
+      actions: [action]
+    };
+    const entry = {
+      version: 1,
+      instruction: "fill form",
+      startUrl: "https://example.com",
+      options: {},
+      configSignature: "sig",
+      steps: [agentStep],
+      result: { success: true, actions: [] },
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    const storage = {
+      enabled: true,
+      readJson: import_vitest.vi.fn().mockImplementation(async () => ({ value: entry })),
+      writeJson: import_vitest.vi.fn().mockResolvedValue({}),
+      directory: "/tmp/cache"
+    };
+    const handler = {
+      takeDeterministicAction: import_vitest.vi.fn().mockResolvedValue({
+        success: true,
+        message: "ok",
+        actionDescription: "type email",
+        actions: [action]
+      })
+    };
+    const fakePage = {};
+    const ctx = {
+      awaitActivePage: import_vitest.vi.fn().mockResolvedValue(fakePage)
+    };
+    const defaultClient = { id: "default-agent" };
+    const overrideClient = { id: "override-agent" };
+    const cache = new import_AgentCache.AgentCache({
+      storage,
+      logger: import_vitest.vi.fn(),
+      getActHandler: () => handler,
+      getContext: () => ctx,
+      getDefaultLlmClient: () => defaultClient,
+      getBaseModelName: () => "openai/gpt-4.1-mini",
+      getSystemPrompt: () => void 0,
+      domSettleTimeoutMs: void 0,
+      act: import_vitest.vi.fn()
+    });
+    const context = {
+      instruction: "fill form",
+      startUrl: "https://example.com",
+      options: {},
+      configSignature: "sig",
+      cacheKey: "agent-key"
+    };
+    const result = await cache.tryReplay(context, overrideClient);
+    (0, import_vitest.expect)(result?.success).toBe(true);
+    (0, import_vitest.expect)(handler.takeDeterministicAction).toHaveBeenCalledTimes(1);
+    const call = import_vitest.vi.mocked(handler.takeDeterministicAction).mock.calls[0];
+    (0, import_vitest.expect)(call?.[3]).toBe(overrideClient);
+  });
+  (0, import_vitest.it)("AgentCache replays non-act steps without requiring an override client", async () => {
+    const gotoEntry = {
+      version: 1,
+      instruction: "navigate home",
+      startUrl: "https://example.com/source",
+      options: {},
+      configSignature: "sig",
+      steps: [
+        {
+          type: "goto",
+          url: "https://example.com/target",
+          waitUntil: "load"
+        }
+      ],
+      result: { success: true, actions: [] },
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    const storage = {
+      enabled: true,
+      readJson: import_vitest.vi.fn().mockResolvedValue({ value: gotoEntry }),
+      writeJson: import_vitest.vi.fn().mockResolvedValue({}),
+      directory: "/tmp/cache"
+    };
+    const handler = {
+      takeDeterministicAction: import_vitest.vi.fn()
+    };
+    const fakePage = { goto: import_vitest.vi.fn() };
+    const ctx = {
+      awaitActivePage: import_vitest.vi.fn().mockResolvedValue(fakePage)
+    };
+    const cache = new import_AgentCache.AgentCache({
+      storage,
+      logger: import_vitest.vi.fn(),
+      getActHandler: () => handler,
+      getContext: () => ctx,
+      getDefaultLlmClient: () => ({ id: "default" }),
+      getBaseModelName: () => "openai/gpt-4.1-mini",
+      getSystemPrompt: () => void 0,
+      domSettleTimeoutMs: void 0,
+      act: import_vitest.vi.fn()
+    });
+    const context = {
+      instruction: "navigate home",
+      startUrl: "https://example.com/source",
+      options: {},
+      configSignature: "sig",
+      cacheKey: "agent-goto"
+    };
+    const result = await cache.tryReplay(context);
+    (0, import_vitest.expect)(result?.success).toBe(true);
+    (0, import_vitest.expect)(handler.takeDeterministicAction).not.toHaveBeenCalled();
+    (0, import_vitest.expect)(fakePage.goto).toHaveBeenCalledWith("https://example.com/target", {
+      waitUntil: "load"
+    });
+  });
+});
+//# sourceMappingURL=cache-llm-resolution.test.js.map

package/dist/cjs/tests/cache-llm-resolution.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../tests/cache-llm-resolution.test.ts"],
+  "sourcesContent": ["import { describe, expect, it, vi } from \"vitest\";\nimport { ActCache } from \"../lib/v3/cache/ActCache.js\";\nimport { AgentCache } from \"../lib/v3/cache/AgentCache.js\";\nimport type { CacheStorage } from \"../lib/v3/cache/CacheStorage.js\";\nimport type { ActHandler } from \"../lib/v3/handlers/actHandler.js\";\nimport type { LLMClient } from \"../lib/v3/llm/LLMClient.js\";\nimport type { Page } from \"../lib/v3/understudy/page.js\";\nimport type { V3Context } from \"../lib/v3/understudy/context.js\";\nimport type {\n  ActCacheContext,\n  CachedActEntry,\n  CachedAgentEntry,\n  AgentCacheContext,\n  AgentReplayActStep,\n} from \"../lib/v3/types/private/index.js\";\nimport type {\n  Action,\n  AgentResult,\n  AvailableModel,\n} from \"../lib/v3/types/public/index.js\";\n\nfunction createFakeStorage<T>(entry: T): CacheStorage {\n  return {\n    enabled: true,\n    readJson: vi.fn().mockResolvedValue({ value: entry }),\n    writeJson: vi.fn().mockResolvedValue({}),\n    directory: \"/tmp/cache\",\n  } as unknown as CacheStorage;\n}\n\ndescribe(\"Cache LLM client selection\", () => {\n  it(\"ActCache uses provided override client during replay\", async () => {\n    const action: Action = {\n      selector: \"xpath=/html/body/button\",\n      description: \"click button\",\n      method: \"click\",\n      arguments: [],\n    };\n\n    const entry: CachedActEntry = {\n      version: 1,\n      instruction: \"click button\",\n      url: \"https://example.com\",\n      variableKeys: [],\n      actions: [action],\n      actionDescription: \"click button\",\n      message: \"done\",\n    };\n\n    const storage = createFakeStorage(entry);\n    const handler = {\n      takeDeterministicAction: vi.fn().mockResolvedValue({\n        success: true,\n        message: \"ok\",\n        actionDescription: \"click button\",\n        actions: [action],\n      }),\n    } as unknown as ActHandler;\n    const defaultClient = { id: \"default\" } as unknown as LLMClient;\n    const overrideClient = { id: \"override\" } as unknown as LLMClient;\n\n    const cache = new ActCache({\n      storage,\n      logger: vi.fn(),\n      getActHandler: () => handler,\n      getDefaultLlmClient: () => defaultClient,\n      domSettleTimeoutMs: undefined,\n    });\n\n    const context: ActCacheContext = {\n      instruction: \"click button\",\n      cacheKey: \"abc\",\n      pageUrl: \"https://example.com\",\n      variableKeys: [],\n      variables: undefined,\n    };\n\n    const result = await cache.tryReplay(\n      context,\n      {} as Page,\n      undefined,\n      overrideClient,\n    );\n\n    expect(result?.success).toBe(true);\n    expect(handler.takeDeterministicAction).toHaveBeenCalledTimes(1);\n    const call = vi.mocked(handler.takeDeterministicAction).mock.calls[0];\n    expect(call?.[3]).toBe(overrideClient);\n  });\n\n  it(\"AgentCache uses provided override client during replay\", async () => {\n    const action: Action = {\n      selector: \"xpath=/html/body/input\",\n      description: \"type email\",\n      method: \"type\",\n      arguments: [\"test@example.com\"],\n    };\n\n    const agentStep: AgentReplayActStep = {\n      type: \"act\",\n      instruction: \"type email\",\n      actions: [action],\n    };\n\n    const entry: CachedAgentEntry = {\n      version: 1,\n      instruction: \"fill form\",\n      startUrl: \"https://example.com\",\n      options: {},\n      configSignature: \"sig\",\n      steps: [agentStep],\n      result: { success: true, actions: [] } as AgentResult,\n      timestamp: new Date().toISOString(),\n    };\n\n    const storage = {\n      enabled: true,\n      readJson: vi.fn().mockImplementation(async () => ({ value: entry })),\n      writeJson: vi.fn().mockResolvedValue({}),\n      directory: \"/tmp/cache\",\n    } as unknown as CacheStorage;\n\n    const handler = {\n      takeDeterministicAction: vi.fn().mockResolvedValue({\n        success: true,\n        message: \"ok\",\n        actionDescription: \"type email\",\n        actions: [action],\n      }),\n    } as unknown as ActHandler;\n\n    const fakePage = {} as Page;\n    const ctx = {\n      awaitActivePage: vi.fn().mockResolvedValue(fakePage),\n    } as unknown as V3Context;\n\n    const defaultClient = { id: \"default-agent\" } as unknown as LLMClient;\n    const overrideClient = { id: \"override-agent\" } as unknown as LLMClient;\n\n    const cache = new AgentCache({\n      storage,\n      logger: vi.fn(),\n      getActHandler: () => handler,\n      getContext: () => ctx,\n      getDefaultLlmClient: () => defaultClient,\n      getBaseModelName: () => \"openai/gpt-4.1-mini\" as AvailableModel,\n      getSystemPrompt: () => undefined,\n      domSettleTimeoutMs: undefined,\n      act: vi.fn(),\n    });\n\n    const context: AgentCacheContext = {\n      instruction: \"fill form\",\n      startUrl: \"https://example.com\",\n      options: {},\n      configSignature: \"sig\",\n      cacheKey: \"agent-key\",\n    };\n\n    const result = await cache.tryReplay(context, overrideClient);\n\n    expect(result?.success).toBe(true);\n    expect(handler.takeDeterministicAction).toHaveBeenCalledTimes(1);\n    const call = vi.mocked(handler.takeDeterministicAction).mock.calls[0];\n    expect(call?.[3]).toBe(overrideClient);\n  });\n\n  it(\"AgentCache replays non-act steps without requiring an override client\", async () => {\n    const gotoEntry: CachedAgentEntry = {\n      version: 1,\n      instruction: \"navigate home\",\n      startUrl: \"https://example.com/source\",\n      options: {},\n      configSignature: \"sig\",\n      steps: [\n        {\n          type: \"goto\",\n          url: \"https://example.com/target\",\n          waitUntil: \"load\",\n        },\n      ],\n      result: { success: true, actions: [] } as AgentResult,\n      timestamp: new Date().toISOString(),\n    };\n\n    const storage = {\n      enabled: true,\n      readJson: vi.fn().mockResolvedValue({ value: gotoEntry }),\n      writeJson: vi.fn().mockResolvedValue({}),\n      directory: \"/tmp/cache\",\n    } as unknown as CacheStorage;\n\n    const handler = {\n      takeDeterministicAction: vi.fn(),\n    } as unknown as ActHandler;\n\n    const fakePage = { goto: vi.fn() } as unknown as Page;\n    const ctx = {\n      awaitActivePage: vi.fn().mockResolvedValue(fakePage),\n    } as unknown as V3Context;\n\n    const cache = new AgentCache({\n      storage,\n      logger: vi.fn(),\n      getActHandler: () => handler,\n      getContext: () => ctx,\n      getDefaultLlmClient: () => ({ id: \"default\" }) as unknown as LLMClient,\n      getBaseModelName: () => \"openai/gpt-4.1-mini\" as AvailableModel,\n      getSystemPrompt: () => undefined,\n      domSettleTimeoutMs: undefined,\n      act: vi.fn(),\n    });\n\n    const context: AgentCacheContext = {\n      instruction: \"navigate home\",\n      startUrl: \"https://example.com/source\",\n      options: {},\n      configSignature: \"sig\",\n      cacheKey: \"agent-goto\",\n    };\n\n    const result = await cache.tryReplay(context);\n\n    expect(result?.success).toBe(true);\n    expect(handler.takeDeterministicAction).not.toHaveBeenCalled();\n    expect(fakePage.goto).toHaveBeenCalledWith(\"https://example.com/target\", {\n      waitUntil: \"load\",\n    });\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/tests/helpers/mockCDPSession.js

@@ -0,0 +1,50 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var mockCDPSession_exports = {};
+__export(mockCDPSession_exports, {
+  MockCDPSession: () => MockCDPSession
+});
+module.exports = __toCommonJS(mockCDPSession_exports);
+class MockCDPSession {
+  constructor(handlers = {}, sessionId = "mock-session") {
+    this.handlers = handlers;
+    this.id = sessionId;
+  }
+  id;
+  calls = [];
+  async send(method, params = {}) {
+    this.calls.push({ method, params });
+    const handler = this.handlers[method];
+    if (!handler) return {};
+    return await handler(params);
+  }
+  on() {
+  }
+  off() {
+  }
+  async close() {
+  }
+  callsFor(method) {
+    return this.calls.filter((call) => call.method === method).map(({ params }) => ({ params }));
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MockCDPSession
+});
+//# sourceMappingURL=mockCDPSession.js.map

package/dist/cjs/tests/helpers/mockCDPSession.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../tests/helpers/mockCDPSession.ts"],
+  "sourcesContent": ["import type { CDPSessionLike } from \"../../lib/v3/understudy/cdp.js\";\n\ntype Handler = (params?: Record<string, unknown>) => Promise<unknown> | unknown;\n\nexport class MockCDPSession implements CDPSessionLike {\n  public readonly id: string;\n  public readonly calls: Array<{\n    method: string;\n    params?: Record<string, unknown>;\n  }> = [];\n\n  constructor(\n    private readonly handlers: Record<string, Handler> = {},\n    sessionId = \"mock-session\",\n  ) {\n    this.id = sessionId;\n  }\n\n  async send<R = unknown>(\n    method: string,\n    params: Record<string, unknown> = {},\n  ): Promise<R> {\n    this.calls.push({ method, params });\n    const handler = this.handlers[method];\n    if (!handler) return {} as R;\n    return (await handler(params)) as R;\n  }\n\n  on(): void {}\n  off(): void {}\n  async close(): Promise<void> {}\n\n  callsFor(method: string): Array<{ params?: Record<string, unknown> }> {\n    return this.calls\n      .filter((call) => call.method === method)\n      .map(({ params }) => ({ params }));\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIO,MAAM,eAAyC;AAAA,EAOpD,YACmB,WAAoC,CAAC,GACtD,YAAY,gBACZ;AAFiB;AAGjB,SAAK,KAAK;AAAA,EACZ;AAAA,EAXgB;AAAA,EACA,QAGX,CAAC;AAAA,EASN,MAAM,KACJ,QACA,SAAkC,CAAC,GACvB;AACZ,SAAK,MAAM,KAAK,EAAE,QAAQ,OAAO,CAAC;AAClC,UAAM,UAAU,KAAK,SAAS,MAAM;AACpC,QAAI,CAAC,QAAS,QAAO,CAAC;AACtB,WAAQ,MAAM,QAAQ,MAAM;AAAA,EAC9B;AAAA,EAEA,KAAW;AAAA,EAAC;AAAA,EACZ,MAAY;AAAA,EAAC;AAAA,EACb,MAAM,QAAuB;AAAA,EAAC;AAAA,EAE9B,SAAS,QAA6D;AACpE,WAAO,KAAK,MACT,OAAO,CAAC,SAAS,KAAK,WAAW,MAAM,EACvC,IAAI,CAAC,EAAE,OAAO,OAAO,EAAE,OAAO,EAAE;AAAA,EACrC;AACF;",
+  "names": []
+}