@browserbasehq/orca 3.0.9-alpha-3 → 3.1.0-patch.0

package/dist/esm/package.json

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

package/dist/esm/tests/agent-execution-model.test.js

@@ -0,0 +1,139 @@
+import { describe, expect, it, vi } from "vitest";
+import { actTool } from "../lib/v3/agent/tools/act.js";
+import { extractTool } from "../lib/v3/agent/tools/extract.js";
+import { fillFormTool } from "../lib/v3/agent/tools/fillform.js";
+function createMockV3() {
+  const calls = [];
+  const mock = {
+    logger: vi.fn(),
+    recordAgentReplayStep: vi.fn(),
+    act: vi.fn(async (_instruction, options) => {
+      calls.push({ method: "act", model: options?.model });
+      return {
+        success: true,
+        message: "ok",
+        actionDescription: "clicked",
+        actions: []
+      };
+    }),
+    extract: vi.fn(
+      async (_instruction, _schema, options) => {
+        calls.push({ method: "extract", model: options?.model });
+        return { extraction: "data" };
+      }
+    ),
+    observe: vi.fn(
+      async (_instruction, options) => {
+        calls.push({ method: "observe", model: options?.model });
+        return [];
+      }
+    ),
+    calls
+  };
+  return mock;
+}
+describe("agent tools pass full executionModel config to v3 methods", () => {
+  const modelConfig = {
+    modelName: "openai/gpt-4o-mini",
+    apiKey: "sk-test-key",
+    baseURL: "https://custom.api"
+  };
+  it("actTool passes AgentModelConfig object to v3.act()", async () => {
+    const v3 = createMockV3();
+    const tool = actTool(v3, modelConfig);
+    await tool.execute(
+      { action: "click the button" },
+      {
+        toolCallId: "t1",
+        messages: [],
+        abortSignal: new AbortController().signal
+      }
+    );
+    expect(v3.calls).toHaveLength(1);
+    expect(v3.calls[0].method).toBe("act");
+    expect(v3.calls[0].model).toBe(modelConfig);
+  });
+  it("extractTool passes AgentModelConfig object to v3.extract()", async () => {
+    const v3 = createMockV3();
+    const tool = extractTool(v3, modelConfig);
+    await tool.execute(
+      { instruction: "get the title", schema: void 0 },
+      {
+        toolCallId: "t2",
+        messages: [],
+        abortSignal: new AbortController().signal
+      }
+    );
+    expect(v3.calls).toHaveLength(1);
+    expect(v3.calls[0].method).toBe("extract");
+    expect(v3.calls[0].model).toBe(modelConfig);
+  });
+  it("fillFormTool passes AgentModelConfig object to v3.observe()", async () => {
+    const v3 = createMockV3();
+    const tool = fillFormTool(v3, modelConfig);
+    await tool.execute(
+      { fields: [{ action: "type hello into name", value: "hello" }] },
+      {
+        toolCallId: "t3",
+        messages: [],
+        abortSignal: new AbortController().signal
+      }
+    );
+    expect(v3.calls).toHaveLength(1);
+    expect(v3.calls[0].method).toBe("observe");
+    expect(v3.calls[0].model).toBe(modelConfig);
+  });
+  it("actTool passes undefined when no executionModel is set", async () => {
+    const v3 = createMockV3();
+    const tool = actTool(v3, void 0);
+    await tool.execute(
+      { action: "click the button" },
+      {
+        toolCallId: "t4",
+        messages: [],
+        abortSignal: new AbortController().signal
+      }
+    );
+    expect(v3.calls).toHaveLength(1);
+    expect(v3.calls[0].model).toBeUndefined();
+  });
+  it("actTool passes plain string executionModel to v3.act()", async () => {
+    const v3 = createMockV3();
+    const tool = actTool(v3, "openai/gpt-4o-mini");
+    await tool.execute(
+      { action: "click the button" },
+      {
+        toolCallId: "t5",
+        messages: [],
+        abortSignal: new AbortController().signal
+      }
+    );
+    expect(v3.calls).toHaveLength(1);
+    expect(v3.calls[0].model).toBe("openai/gpt-4o-mini");
+  });
+});
+describe("executionModel fallback logic", () => {
+  function resolveExecutionModel(options) {
+    return options?.executionModel ?? options?.model;
+  }
+  it("prefers explicit executionModel over model", () => {
+    const result = resolveExecutionModel({
+      executionModel: "openai/gpt-4o-mini",
+      model: "anthropic/claude-sonnet-4-20250514"
+    });
+    expect(result).toBe("openai/gpt-4o-mini");
+  });
+  it("falls back to model when executionModel is not set", () => {
+    const modelConfig = {
+      modelName: "anthropic/claude-sonnet-4-20250514",
+      apiKey: "sk-test"
+    };
+    const result = resolveExecutionModel({ model: modelConfig });
+    expect(result).toBe(modelConfig);
+  });
+  it("returns undefined when neither is set", () => {
+    expect(resolveExecutionModel({})).toBeUndefined();
+    expect(resolveExecutionModel(void 0)).toBeUndefined();
+  });
+});
+//# sourceMappingURL=agent-execution-model.test.js.map

package/dist/esm/tests/agent-execution-model.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../tests/agent-execution-model.test.ts"],
+  "sourcesContent": ["import { describe, expect, it, vi } from \"vitest\";\nimport { actTool } from \"../lib/v3/agent/tools/act.js\";\nimport { extractTool } from \"../lib/v3/agent/tools/extract.js\";\nimport { fillFormTool } from \"../lib/v3/agent/tools/fillform.js\";\nimport type { V3 } from \"../lib/v3/v3.js\";\n\n/**\n * Minimal mock of V3 that captures how tools pass `model` options\n * into v3.act(), v3.extract(), and v3.observe().\n */\nfunction createMockV3() {\n  const calls: { method: string; model: unknown }[] = [];\n\n  const mock = {\n    logger: vi.fn(),\n    recordAgentReplayStep: vi.fn(),\n    act: vi.fn(async (_instruction: unknown, options?: { model?: unknown }) => {\n      calls.push({ method: \"act\", model: options?.model });\n      return {\n        success: true,\n        message: \"ok\",\n        actionDescription: \"clicked\",\n        actions: [],\n      };\n    }),\n    extract: vi.fn(\n      async (\n        _instruction: unknown,\n        _schema: unknown,\n        options?: { model?: unknown },\n      ) => {\n        calls.push({ method: \"extract\", model: options?.model });\n        return { extraction: \"data\" };\n      },\n    ),\n    observe: vi.fn(\n      async (_instruction: unknown, options?: { model?: unknown }) => {\n        calls.push({ method: \"observe\", model: options?.model });\n        return [];\n      },\n    ),\n    calls,\n  };\n\n  return mock as unknown as V3 & { calls: typeof calls };\n}\n\ndescribe(\"agent tools pass full executionModel config to v3 methods\", () => {\n  const modelConfig = {\n    modelName: \"openai/gpt-4o-mini\",\n    apiKey: \"sk-test-key\",\n    baseURL: \"https://custom.api\",\n  };\n\n  it(\"actTool passes AgentModelConfig object to v3.act()\", async () => {\n    const v3 = createMockV3();\n    const tool = actTool(v3, modelConfig);\n    await tool.execute!(\n      { action: \"click the button\" },\n      {\n        toolCallId: \"t1\",\n        messages: [],\n        abortSignal: new AbortController().signal,\n      },\n    );\n\n    expect(v3.calls).toHaveLength(1);\n    expect(v3.calls[0].method).toBe(\"act\");\n    expect(v3.calls[0].model).toBe(modelConfig);\n  });\n\n  it(\"extractTool passes AgentModelConfig object to v3.extract()\", async () => {\n    const v3 = createMockV3();\n    const tool = extractTool(v3, modelConfig);\n    await tool.execute!(\n      { instruction: \"get the title\", schema: undefined },\n      {\n        toolCallId: \"t2\",\n        messages: [],\n        abortSignal: new AbortController().signal,\n      },\n    );\n\n    expect(v3.calls).toHaveLength(1);\n    expect(v3.calls[0].method).toBe(\"extract\");\n    expect(v3.calls[0].model).toBe(modelConfig);\n  });\n\n  it(\"fillFormTool passes AgentModelConfig object to v3.observe()\", async () => {\n    const v3 = createMockV3();\n    const tool = fillFormTool(v3, modelConfig);\n    await tool.execute!(\n      { fields: [{ action: \"type hello into name\", value: \"hello\" }] },\n      {\n        toolCallId: \"t3\",\n        messages: [],\n        abortSignal: new AbortController().signal,\n      },\n    );\n\n    expect(v3.calls).toHaveLength(1);\n    expect(v3.calls[0].method).toBe(\"observe\");\n    expect(v3.calls[0].model).toBe(modelConfig);\n  });\n\n  it(\"actTool passes undefined when no executionModel is set\", async () => {\n    const v3 = createMockV3();\n    const tool = actTool(v3, undefined);\n    await tool.execute!(\n      { action: \"click the button\" },\n      {\n        toolCallId: \"t4\",\n        messages: [],\n        abortSignal: new AbortController().signal,\n      },\n    );\n\n    expect(v3.calls).toHaveLength(1);\n    expect(v3.calls[0].model).toBeUndefined();\n  });\n\n  it(\"actTool passes plain string executionModel to v3.act()\", async () => {\n    const v3 = createMockV3();\n    const tool = actTool(v3, \"openai/gpt-4o-mini\");\n    await tool.execute!(\n      { action: \"click the button\" },\n      {\n        toolCallId: \"t5\",\n        messages: [],\n        abortSignal: new AbortController().signal,\n      },\n    );\n\n    expect(v3.calls).toHaveLength(1);\n    expect(v3.calls[0].model).toBe(\"openai/gpt-4o-mini\");\n  });\n});\n\ndescribe(\"executionModel fallback logic\", () => {\n  // This mirrors the resolution in V3.prepareAgentExecution (v3.ts:1682):\n  //   const resolvedExecutionModel = options?.executionModel ?? options?.model;\n  function resolveExecutionModel(options?: {\n    executionModel?: string | { modelName: string };\n    model?: string | { modelName: string };\n  }) {\n    return options?.executionModel ?? options?.model;\n  }\n\n  it(\"prefers explicit executionModel over model\", () => {\n    const result = resolveExecutionModel({\n      executionModel: \"openai/gpt-4o-mini\",\n      model: \"anthropic/claude-sonnet-4-20250514\",\n    });\n    expect(result).toBe(\"openai/gpt-4o-mini\");\n  });\n\n  it(\"falls back to model when executionModel is not set\", () => {\n    const modelConfig = {\n      modelName: \"anthropic/claude-sonnet-4-20250514\",\n      apiKey: \"sk-test\",\n    };\n    const result = resolveExecutionModel({ model: modelConfig });\n    expect(result).toBe(modelConfig);\n  });\n\n  it(\"returns undefined when neither is set\", () => {\n    expect(resolveExecutionModel({})).toBeUndefined();\n    expect(resolveExecutionModel(undefined)).toBeUndefined();\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

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

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

package/dist/esm/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/esm/tests/cache-llm-resolution.test.js

@@ -0,0 +1,187 @@
+import { describe, expect, it, vi } from "vitest";
+import { ActCache } from "../lib/v3/cache/ActCache.js";
+import { AgentCache } from "../lib/v3/cache/AgentCache.js";
+function createFakeStorage(entry) {
+  return {
+    enabled: true,
+    readJson: vi.fn().mockResolvedValue({ value: entry }),
+    writeJson: vi.fn().mockResolvedValue({}),
+    directory: "/tmp/cache"
+  };
+}
+describe("Cache LLM client selection", () => {
+  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: vi.fn().mockResolvedValue({
+        success: true,
+        message: "ok",
+        actionDescription: "click button",
+        actions: [action]
+      })
+    };
+    const defaultClient = { id: "default" };
+    const overrideClient = { id: "override" };
+    const cache = new ActCache({
+      storage,
+      logger: 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
+    );
+    expect(result?.success).toBe(true);
+    expect(handler.takeDeterministicAction).toHaveBeenCalledTimes(1);
+    const call = vi.mocked(handler.takeDeterministicAction).mock.calls[0];
+    expect(call?.[3]).toBe(overrideClient);
+  });
+  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: vi.fn().mockImplementation(async () => ({ value: entry })),
+      writeJson: vi.fn().mockResolvedValue({}),
+      directory: "/tmp/cache"
+    };
+    const handler = {
+      takeDeterministicAction: vi.fn().mockResolvedValue({
+        success: true,
+        message: "ok",
+        actionDescription: "type email",
+        actions: [action]
+      })
+    };
+    const fakePage = {};
+    const ctx = {
+      awaitActivePage: vi.fn().mockResolvedValue(fakePage)
+    };
+    const defaultClient = { id: "default-agent" };
+    const overrideClient = { id: "override-agent" };
+    const cache = new AgentCache({
+      storage,
+      logger: vi.fn(),
+      getActHandler: () => handler,
+      getContext: () => ctx,
+      getDefaultLlmClient: () => defaultClient,
+      getBaseModelName: () => "openai/gpt-4.1-mini",
+      getSystemPrompt: () => void 0,
+      domSettleTimeoutMs: void 0,
+      act: vi.fn()
+    });
+    const context = {
+      instruction: "fill form",
+      startUrl: "https://example.com",
+      options: {},
+      configSignature: "sig",
+      cacheKey: "agent-key"
+    };
+    const result = await cache.tryReplay(context, overrideClient);
+    expect(result?.success).toBe(true);
+    expect(handler.takeDeterministicAction).toHaveBeenCalledTimes(1);
+    const call = vi.mocked(handler.takeDeterministicAction).mock.calls[0];
+    expect(call?.[3]).toBe(overrideClient);
+  });
+  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: vi.fn().mockResolvedValue({ value: gotoEntry }),
+      writeJson: vi.fn().mockResolvedValue({}),
+      directory: "/tmp/cache"
+    };
+    const handler = {
+      takeDeterministicAction: vi.fn()
+    };
+    const fakePage = { goto: vi.fn() };
+    const ctx = {
+      awaitActivePage: vi.fn().mockResolvedValue(fakePage)
+    };
+    const cache = new AgentCache({
+      storage,
+      logger: vi.fn(),
+      getActHandler: () => handler,
+      getContext: () => ctx,
+      getDefaultLlmClient: () => ({ id: "default" }),
+      getBaseModelName: () => "openai/gpt-4.1-mini",
+      getSystemPrompt: () => void 0,
+      domSettleTimeoutMs: void 0,
+      act: vi.fn()
+    });
+    const context = {
+      instruction: "navigate home",
+      startUrl: "https://example.com/source",
+      options: {},
+      configSignature: "sig",
+      cacheKey: "agent-goto"
+    };
+    const result = await cache.tryReplay(context);
+    expect(result?.success).toBe(true);
+    expect(handler.takeDeterministicAction).not.toHaveBeenCalled();
+    expect(fakePage.goto).toHaveBeenCalledWith("https://example.com/target", {
+      waitUntil: "load"
+    });
+  });
+});
+//# sourceMappingURL=cache-llm-resolution.test.js.map

package/dist/esm/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/esm/tests/helpers/mockCDPSession.js

@@ -0,0 +1,27 @@
+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 }));
+  }
+}
+export {
+  MockCDPSession
+};
+//# sourceMappingURL=mockCDPSession.js.map

package/dist/esm/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": "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": []
+}

package/dist/esm/tests/llm-provider.test.js

@@ -0,0 +1,57 @@
+import { describe, expect, it } from "vitest";
+import { getAISDKLanguageModel } from "../lib/v3/llm/LLMProvider.js";
+describe("getAISDKLanguageModel", () => {
+  describe("ollama provider", () => {
+    it("works without clientOptions", () => {
+      const model = getAISDKLanguageModel("ollama", "llama3.2");
+      expect(model).toBeDefined();
+    });
+    it("works with empty clientOptions", () => {
+      const model = getAISDKLanguageModel("ollama", "llama3.2", {});
+      expect(model).toBeDefined();
+    });
+    it("works with clientOptions containing only undefined values", () => {
+      const model = getAISDKLanguageModel("ollama", "llama3.2", {
+        apiKey: void 0
+      });
+      expect(model).toBeDefined();
+    });
+    it("works with clientOptions containing only null values", () => {
+      const model = getAISDKLanguageModel("ollama", "llama3.2", {
+        apiKey: null
+      });
+      expect(model).toBeDefined();
+    });
+    it("works with custom baseURL", () => {
+      const model = getAISDKLanguageModel("ollama", "llama3.2", {
+        baseURL: "http://custom-ollama:11434"
+      });
+      expect(model).toBeDefined();
+    });
+    it("works even when apiKey is mistakenly provided", () => {
+      const model = getAISDKLanguageModel("ollama", "llama3.2", {
+        apiKey: "unnecessary-key"
+      });
+      expect(model).toBeDefined();
+    });
+  });
+  describe("providers with API keys", () => {
+    it("openai requires valid clientOptions for custom configuration", () => {
+      const defaultModel = getAISDKLanguageModel("openai", "gpt-4o");
+      expect(defaultModel).toBeDefined();
+      const customModel = getAISDKLanguageModel("openai", "gpt-4o", {
+        apiKey: "test-key"
+      });
+      expect(customModel).toBeDefined();
+    });
+  });
+  describe("hasValidOptions logic", () => {
+    it("treats undefined apiKey as no options", () => {
+      const model = getAISDKLanguageModel("ollama", "llama3.2", {
+        apiKey: void 0
+      });
+      expect(model).toBeDefined();
+    });
+  });
+});
+//# sourceMappingURL=llm-provider.test.js.map

package/dist/esm/tests/llm-provider.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../tests/llm-provider.test.ts"],
+  "sourcesContent": ["import { describe, expect, it } from \"vitest\";\nimport { getAISDKLanguageModel } from \"../lib/v3/llm/LLMProvider.js\";\n\ndescribe(\"getAISDKLanguageModel\", () => {\n  describe(\"ollama provider\", () => {\n    it(\"works without clientOptions\", () => {\n      const model = getAISDKLanguageModel(\"ollama\", \"llama3.2\");\n      expect(model).toBeDefined();\n    });\n\n    it(\"works with empty clientOptions\", () => {\n      const model = getAISDKLanguageModel(\"ollama\", \"llama3.2\", {});\n      expect(model).toBeDefined();\n    });\n\n    it(\"works with clientOptions containing only undefined values\", () => {\n      const model = getAISDKLanguageModel(\"ollama\", \"llama3.2\", {\n        apiKey: undefined,\n      });\n      expect(model).toBeDefined();\n    });\n\n    it(\"works with clientOptions containing only null values\", () => {\n      const model = getAISDKLanguageModel(\"ollama\", \"llama3.2\", {\n        apiKey: null as unknown as string,\n      });\n      expect(model).toBeDefined();\n    });\n\n    it(\"works with custom baseURL\", () => {\n      const model = getAISDKLanguageModel(\"ollama\", \"llama3.2\", {\n        baseURL: \"http://custom-ollama:11434\",\n      });\n      expect(model).toBeDefined();\n    });\n\n    it(\"works even when apiKey is mistakenly provided\", () => {\n      // Ollama doesn't need an API key, but users might set one anyway\n      const model = getAISDKLanguageModel(\"ollama\", \"llama3.2\", {\n        apiKey: \"unnecessary-key\",\n      });\n      expect(model).toBeDefined();\n    });\n  });\n\n  describe(\"providers with API keys\", () => {\n    it(\"openai requires valid clientOptions for custom configuration\", () => {\n      // Without clientOptions, uses default provider\n      const defaultModel = getAISDKLanguageModel(\"openai\", \"gpt-4o\");\n      expect(defaultModel).toBeDefined();\n\n      // With valid apiKey, uses custom provider\n      const customModel = getAISDKLanguageModel(\"openai\", \"gpt-4o\", {\n        apiKey: \"test-key\",\n      });\n      expect(customModel).toBeDefined();\n    });\n  });\n\n  describe(\"hasValidOptions logic\", () => {\n    it(\"treats undefined apiKey as no options\", () => {\n      // This should use the default provider path (AISDKProviders)\n      // not the custom provider path (AISDKProvidersWithAPIKey)\n      const model = getAISDKLanguageModel(\"ollama\", \"llama3.2\", {\n        apiKey: undefined,\n      });\n      expect(model).toBeDefined();\n    });\n  });\n});\n"],
+  "mappings": "AAAA,SAAS,UAAU,QAAQ,UAAU;AACrC,SAAS,6BAA6B;AAEtC,SAAS,yBAAyB,MAAM;AACtC,WAAS,mBAAmB,MAAM;AAChC,OAAG,+BAA+B,MAAM;AACtC,YAAM,QAAQ,sBAAsB,UAAU,UAAU;AACxD,aAAO,KAAK,EAAE,YAAY;AAAA,IAC5B,CAAC;AAED,OAAG,kCAAkC,MAAM;AACzC,YAAM,QAAQ,sBAAsB,UAAU,YAAY,CAAC,CAAC;AAC5D,aAAO,KAAK,EAAE,YAAY;AAAA,IAC5B,CAAC;AAED,OAAG,6DAA6D,MAAM;AACpE,YAAM,QAAQ,sBAAsB,UAAU,YAAY;AAAA,QACxD,QAAQ;AAAA,MACV,CAAC;AACD,aAAO,KAAK,EAAE,YAAY;AAAA,IAC5B,CAAC;AAED,OAAG,wDAAwD,MAAM;AAC/D,YAAM,QAAQ,sBAAsB,UAAU,YAAY;AAAA,QACxD,QAAQ;AAAA,MACV,CAAC;AACD,aAAO,KAAK,EAAE,YAAY;AAAA,IAC5B,CAAC;AAED,OAAG,6BAA6B,MAAM;AACpC,YAAM,QAAQ,sBAAsB,UAAU,YAAY;AAAA,QACxD,SAAS;AAAA,MACX,CAAC;AACD,aAAO,KAAK,EAAE,YAAY;AAAA,IAC5B,CAAC;AAED,OAAG,iDAAiD,MAAM;AAExD,YAAM,QAAQ,sBAAsB,UAAU,YAAY;AAAA,QACxD,QAAQ;AAAA,MACV,CAAC;AACD,aAAO,KAAK,EAAE,YAAY;AAAA,IAC5B,CAAC;AAAA,EACH,CAAC;AAED,WAAS,2BAA2B,MAAM;AACxC,OAAG,gEAAgE,MAAM;AAEvE,YAAM,eAAe,sBAAsB,UAAU,QAAQ;AAC7D,aAAO,YAAY,EAAE,YAAY;AAGjC,YAAM,cAAc,sBAAsB,UAAU,UAAU;AAAA,QAC5D,QAAQ;AAAA,MACV,CAAC;AACD,aAAO,WAAW,EAAE,YAAY;AAAA,IAClC,CAAC;AAAA,EACH,CAAC;AAED,WAAS,yBAAyB,MAAM;AACtC,OAAG,yCAAyC,MAAM;AAGhD,YAAM,QAAQ,sBAAsB,UAAU,YAAY;AAAA,QACxD,QAAQ;AAAA,MACV,CAAC;AACD,aAAO,KAAK,EAAE,YAAY;AAAA,IAC5B,CAAC;AAAA,EACH,CAAC;AACH,CAAC;",
+  "names": []
+}