@browserbasehq/orca 3.4.0-preview-4 → 3.4.0-preview-5

package/dist/esm/tests/unit/api-optional-model-api-key.test.js

@@ -1,153 +0,0 @@
-import { describe, expect, it, vi, beforeEach, afterEach } from "vitest";
-import { StagehandAPIClient } from "../../lib/v3/api";
-/**
- * Tests that modelApiKey is optional when calling StagehandAPIClient.init().
- *
- * Previously, init() would throw "modelApiKey is required" if the key was not
- * provided. After the fix, sessions can be started without a model API key
- * (the server may provide its own key or the user may not need one).
- * When provided, the key should still be sent via the x-model-api-key header.
- */
-describe("StagehandAPIClient - optional modelApiKey", () => {
-    const logger = vi.fn();
-    // We mock fetch to avoid real network calls; we just need to verify
-    // that init() doesn't throw when modelApiKey is omitted and that
-    // the header is conditionally included.
-    let originalFetch;
-    function createSessionStartResponse(sessionId) {
-        return new Response(JSON.stringify({
-            success: true,
-            data: { sessionId, available: true },
-        }), {
-            status: 200,
-            headers: { "Content-Type": "application/json" },
-        });
-    }
-    beforeEach(() => {
-        originalFetch = globalThis.fetch;
-        logger.mockClear();
-    });
-    afterEach(() => {
-        globalThis.fetch = originalFetch;
-        delete process.env.STAGEHAND_BASE_URL;
-        delete process.env.STAGEHAND_API_URL;
-        vi.restoreAllMocks();
-    });
-    it("should NOT throw when modelApiKey is omitted", async () => {
-        globalThis.fetch = vi
-            .fn()
-            .mockResolvedValue(createSessionStartResponse("sess-123"));
-        const client = new StagehandAPIClient({
-            apiKey: "test-api-key",
-            logger,
-        });
-        // Should not throw "modelApiKey is required"
-        await expect(client.init({
-            modelName: "openai/gpt-4.1-mini",
-        })).resolves.toBeDefined();
-    });
-    it("should NOT throw when modelApiKey is undefined", async () => {
-        globalThis.fetch = vi
-            .fn()
-            .mockResolvedValue(createSessionStartResponse("sess-456"));
-        const client = new StagehandAPIClient({
-            apiKey: "test-api-key",
-            logger,
-        });
-        await expect(client.init({
-            modelName: "openai/gpt-4.1-mini",
-            modelApiKey: undefined,
-        })).resolves.toBeDefined();
-    });
-    it("should send x-model-api-key header when modelApiKey IS provided", async () => {
-        const fetchSpy = vi
-            .fn()
-            .mockResolvedValue(createSessionStartResponse("sess-789"));
-        globalThis.fetch = fetchSpy;
-        const client = new StagehandAPIClient({
-            apiKey: "test-api-key",
-            logger,
-        });
-        await client.init({
-            modelName: "openai/gpt-4.1-mini",
-            modelApiKey: "my-model-key",
-        });
-        // Verify the fetch was called with x-model-api-key header
-        const [, requestInit] = fetchSpy.mock.calls[0];
-        expect(requestInit.headers["x-model-api-key"]).toBe("my-model-key");
-    });
-    it("should NOT send x-model-api-key header when modelApiKey is omitted", async () => {
-        const fetchSpy = vi
-            .fn()
-            .mockResolvedValue(createSessionStartResponse("sess-012"));
-        globalThis.fetch = fetchSpy;
-        const client = new StagehandAPIClient({
-            apiKey: "test-api-key",
-            logger,
-        });
-        await client.init({
-            modelName: "openai/gpt-4.1-mini",
-        });
-        // Verify x-model-api-key header is NOT present
-        const [, requestInit] = fetchSpy.mock.calls[0];
-        expect(requestInit.headers["x-model-api-key"]).toBeUndefined();
-    });
-    it("should use STAGEHAND_API_URL for the API base URL", async () => {
-        process.env.STAGEHAND_API_URL = "http://localhost:5000";
-        const fetchSpy = vi
-            .fn()
-            .mockResolvedValue(createSessionStartResponse("sess-api-url"));
-        globalThis.fetch = fetchSpy;
-        const client = new StagehandAPIClient({
-            apiKey: "test-api-key",
-            logger,
-        });
-        await client.init({
-            modelName: "openai/gpt-4.1-mini",
-        });
-        const [url] = fetchSpy.mock.calls[0];
-        expect(url.toString()).toBe("http://localhost:5000/v1/sessions/start");
-    });
-    it("should use STAGEHAND_BASE_URL as a legacy fallback", async () => {
-        process.env.STAGEHAND_BASE_URL = "http://localhost:5001";
-        const fetchSpy = vi
-            .fn()
-            .mockResolvedValue(createSessionStartResponse("sess-base-url"));
-        globalThis.fetch = fetchSpy;
-        const client = new StagehandAPIClient({
-            apiKey: "test-api-key",
-            logger,
-        });
-        await client.init({
-            modelName: "openai/gpt-4.1-mini",
-        });
-        const [url] = fetchSpy.mock.calls[0];
-        expect(url.toString()).toBe("http://localhost:5001/v1/sessions/start");
-        expect(logger).toHaveBeenCalledWith(expect.objectContaining({
-            category: "config",
-            message: "STAGEHAND_BASE_URL is deprecated. Use STAGEHAND_API_URL instead.",
-            level: 0,
-        }));
-    });
-    it("should prefer STAGEHAND_API_URL over STAGEHAND_BASE_URL", async () => {
-        process.env.STAGEHAND_BASE_URL = "http://localhost:5002";
-        process.env.STAGEHAND_API_URL = "http://localhost:5003";
-        const fetchSpy = vi
-            .fn()
-            .mockResolvedValue(createSessionStartResponse("sess-base-precedence"));
-        globalThis.fetch = fetchSpy;
-        const client = new StagehandAPIClient({
-            apiKey: "test-api-key",
-            logger,
-        });
-        await client.init({
-            modelName: "openai/gpt-4.1-mini",
-        });
-        const [url] = fetchSpy.mock.calls[0];
-        expect(url.toString()).toBe("http://localhost:5003/v1/sessions/start");
-        expect(logger).not.toHaveBeenCalledWith(expect.objectContaining({
-            message: "STAGEHAND_BASE_URL is deprecated. Use STAGEHAND_API_URL instead.",
-        }));
-    });
-});
-//# sourceMappingURL=api-optional-model-api-key.test.js.map

package/dist/esm/tests/unit/api-optional-model-api-key.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"api-optional-model-api-key.test.js","sourceRoot":"","sources":["../../../../tests/unit/api-optional-model-api-key.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it, vi, beforeEach, afterEach } from \"vitest\";\nimport { StagehandAPIClient } from \"../../lib/v3/api\";\n\n/**\n * Tests that modelApiKey is optional when calling StagehandAPIClient.init().\n *\n * Previously, init() would throw \"modelApiKey is required\" if the key was not\n * provided. After the fix, sessions can be started without a model API key\n * (the server may provide its own key or the user may not need one).\n * When provided, the key should still be sent via the x-model-api-key header.\n */\ndescribe(\"StagehandAPIClient - optional modelApiKey\", () => {\n  const logger = vi.fn();\n\n  // We mock fetch to avoid real network calls; we just need to verify\n  // that init() doesn't throw when modelApiKey is omitted and that\n  // the header is conditionally included.\n  let originalFetch: typeof globalThis.fetch;\n\n  function createSessionStartResponse(sessionId: string) {\n    return new Response(\n      JSON.stringify({\n        success: true,\n        data: { sessionId, available: true },\n      }),\n      {\n        status: 200,\n        headers: { \"Content-Type\": \"application/json\" },\n      },\n    );\n  }\n\n  beforeEach(() => {\n    originalFetch = globalThis.fetch;\n    logger.mockClear();\n  });\n\n  afterEach(() => {\n    globalThis.fetch = originalFetch;\n    delete process.env.STAGEHAND_BASE_URL;\n    delete process.env.STAGEHAND_API_URL;\n    vi.restoreAllMocks();\n  });\n\n  it(\"should NOT throw when modelApiKey is omitted\", async () => {\n    globalThis.fetch = vi\n      .fn()\n      .mockResolvedValue(createSessionStartResponse(\"sess-123\"));\n\n    const client = new StagehandAPIClient({\n      apiKey: \"test-api-key\",\n      logger,\n    });\n\n    // Should not throw \"modelApiKey is required\"\n    await expect(\n      client.init({\n        modelName: \"openai/gpt-4.1-mini\",\n      }),\n    ).resolves.toBeDefined();\n  });\n\n  it(\"should NOT throw when modelApiKey is undefined\", async () => {\n    globalThis.fetch = vi\n      .fn()\n      .mockResolvedValue(createSessionStartResponse(\"sess-456\"));\n\n    const client = new StagehandAPIClient({\n      apiKey: \"test-api-key\",\n      logger,\n    });\n\n    await expect(\n      client.init({\n        modelName: \"openai/gpt-4.1-mini\",\n        modelApiKey: undefined,\n      }),\n    ).resolves.toBeDefined();\n  });\n\n  it(\"should send x-model-api-key header when modelApiKey IS provided\", async () => {\n    const fetchSpy = vi\n      .fn()\n      .mockResolvedValue(createSessionStartResponse(\"sess-789\"));\n    globalThis.fetch = fetchSpy;\n\n    const client = new StagehandAPIClient({\n      apiKey: \"test-api-key\",\n      logger,\n    });\n\n    await client.init({\n      modelName: \"openai/gpt-4.1-mini\",\n      modelApiKey: \"my-model-key\",\n    });\n\n    // Verify the fetch was called with x-model-api-key header\n    const [, requestInit] = fetchSpy.mock.calls[0];\n    expect(requestInit.headers[\"x-model-api-key\"]).toBe(\"my-model-key\");\n  });\n\n  it(\"should NOT send x-model-api-key header when modelApiKey is omitted\", async () => {\n    const fetchSpy = vi\n      .fn()\n      .mockResolvedValue(createSessionStartResponse(\"sess-012\"));\n    globalThis.fetch = fetchSpy;\n\n    const client = new StagehandAPIClient({\n      apiKey: \"test-api-key\",\n      logger,\n    });\n\n    await client.init({\n      modelName: \"openai/gpt-4.1-mini\",\n    });\n\n    // Verify x-model-api-key header is NOT present\n    const [, requestInit] = fetchSpy.mock.calls[0];\n    expect(requestInit.headers[\"x-model-api-key\"]).toBeUndefined();\n  });\n\n  it(\"should use STAGEHAND_API_URL for the API base URL\", async () => {\n    process.env.STAGEHAND_API_URL = \"http://localhost:5000\";\n    const fetchSpy = vi\n      .fn()\n      .mockResolvedValue(createSessionStartResponse(\"sess-api-url\"));\n    globalThis.fetch = fetchSpy;\n\n    const client = new StagehandAPIClient({\n      apiKey: \"test-api-key\",\n      logger,\n    });\n\n    await client.init({\n      modelName: \"openai/gpt-4.1-mini\",\n    });\n\n    const [url] = fetchSpy.mock.calls[0];\n    expect(url.toString()).toBe(\"http://localhost:5000/v1/sessions/start\");\n  });\n\n  it(\"should use STAGEHAND_BASE_URL as a legacy fallback\", async () => {\n    process.env.STAGEHAND_BASE_URL = \"http://localhost:5001\";\n    const fetchSpy = vi\n      .fn()\n      .mockResolvedValue(createSessionStartResponse(\"sess-base-url\"));\n    globalThis.fetch = fetchSpy;\n\n    const client = new StagehandAPIClient({\n      apiKey: \"test-api-key\",\n      logger,\n    });\n\n    await client.init({\n      modelName: \"openai/gpt-4.1-mini\",\n    });\n\n    const [url] = fetchSpy.mock.calls[0];\n    expect(url.toString()).toBe(\"http://localhost:5001/v1/sessions/start\");\n    expect(logger).toHaveBeenCalledWith(\n      expect.objectContaining({\n        category: \"config\",\n        message:\n          \"STAGEHAND_BASE_URL is deprecated. Use STAGEHAND_API_URL instead.\",\n        level: 0,\n      }),\n    );\n  });\n\n  it(\"should prefer STAGEHAND_API_URL over STAGEHAND_BASE_URL\", async () => {\n    process.env.STAGEHAND_BASE_URL = \"http://localhost:5002\";\n    process.env.STAGEHAND_API_URL = \"http://localhost:5003\";\n    const fetchSpy = vi\n      .fn()\n      .mockResolvedValue(createSessionStartResponse(\"sess-base-precedence\"));\n    globalThis.fetch = fetchSpy;\n\n    const client = new StagehandAPIClient({\n      apiKey: \"test-api-key\",\n      logger,\n    });\n\n    await client.init({\n      modelName: \"openai/gpt-4.1-mini\",\n    });\n\n    const [url] = fetchSpy.mock.calls[0];\n    expect(url.toString()).toBe(\"http://localhost:5003/v1/sessions/start\");\n    expect(logger).not.toHaveBeenCalledWith(\n      expect.objectContaining({\n        message:\n          \"STAGEHAND_BASE_URL is deprecated. Use STAGEHAND_API_URL instead.\",\n      }),\n    );\n  });\n});\n"]}

package/dist/esm/tests/unit/api-variables-schema.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/esm/tests/unit/api-variables-schema.test.js

@@ -1,67 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { Api } from "../../lib/v3/types/public/index.js";
-describe("API variable schemas", () => {
-    it("accepts rich variables for act requests", () => {
-        const result = Api.ActRequestSchema.safeParse({
-            input: "type %username% into the email field",
-            options: {
-                variables: {
-                    username: {
-                        value: "john@example.com",
-                        description: "The login email",
-                    },
-                    rememberMe: true,
-                },
-            },
-        });
-        expect(result.success).toBe(true);
-    });
-    it("accepts rich variables for observe requests", () => {
-        const result = Api.ObserveRequestSchema.safeParse({
-            instruction: "find the field where %username% should be entered",
-            options: {
-                variables: {
-                    username: {
-                        value: "john@example.com",
-                        description: "The login email",
-                    },
-                    rememberMe: true,
-                },
-                ignoreSelectors: [".cookie-banner", "#sidebar-ads"],
-            },
-        });
-        expect(result.success).toBe(true);
-        if (!result.success)
-            throw result.error;
-        expect(result.data.options?.ignoreSelectors).toEqual([
-            ".cookie-banner",
-            "#sidebar-ads",
-        ]);
-    });
-    it("preserves variables for agent execute requests", () => {
-        const result = Api.AgentExecuteRequestSchema.safeParse({
-            agentConfig: { mode: "dom" },
-            executeOptions: {
-                instruction: "fill the form with %username% and %password%",
-                variables: {
-                    username: "john@example.com",
-                    password: {
-                        value: "secret-password",
-                        description: "The login password",
-                    },
-                },
-            },
-        });
-        expect(result.success).toBe(true);
-        if (!result.success)
-            throw result.error;
-        expect(result.data.executeOptions.variables).toEqual({
-            username: "john@example.com",
-            password: {
-                value: "secret-password",
-                description: "The login password",
-            },
-        });
-    });
-});
-//# sourceMappingURL=api-variables-schema.test.js.map

package/dist/esm/tests/unit/api-variables-schema.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"api-variables-schema.test.js","sourceRoot":"","sources":["../../../../tests/unit/api-variables-schema.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,oCAAoC,CAAC;AAEzD,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAC,SAAS,CAAC;YAC5C,KAAK,EAAE,sCAAsC;YAC7C,OAAO,EAAE;gBACP,SAAS,EAAE;oBACT,QAAQ,EAAE;wBACR,KAAK,EAAE,kBAAkB;wBACzB,WAAW,EAAE,iBAAiB;qBAC/B;oBACD,UAAU,EAAE,IAAI;iBACjB;aACF;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,GAAG,CAAC,oBAAoB,CAAC,SAAS,CAAC;YAChD,WAAW,EAAE,mDAAmD;YAChE,OAAO,EAAE;gBACP,SAAS,EAAE;oBACT,QAAQ,EAAE;wBACR,KAAK,EAAE,kBAAkB;wBACzB,WAAW,EAAE,iBAAiB;qBAC/B;oBACD,UAAU,EAAE,IAAI;iBACjB;gBACD,eAAe,EAAE,CAAC,gBAAgB,EAAE,cAAc,CAAC;aACpD;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,MAAM,CAAC,KAAK,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,OAAO,CAAC;YACnD,gBAAgB;YAChB,cAAc;SACf,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,MAAM,GAAG,GAAG,CAAC,yBAAyB,CAAC,SAAS,CAAC;YACrD,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;YAC5B,cAAc,EAAE;gBACd,WAAW,EAAE,8CAA8C;gBAC3D,SAAS,EAAE;oBACT,QAAQ,EAAE,kBAAkB;oBAC5B,QAAQ,EAAE;wBACR,KAAK,EAAE,iBAAiB;wBACxB,WAAW,EAAE,oBAAoB;qBAClC;iBACF;aACF;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,MAAM,CAAC,KAAK,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC;YACnD,QAAQ,EAAE,kBAAkB;YAC5B,QAAQ,EAAE;gBACR,KAAK,EAAE,iBAAiB;gBACxB,WAAW,EAAE,oBAAoB;aAClC;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { Api } from \"../../lib/v3/types/public/index.js\";\n\ndescribe(\"API variable schemas\", () => {\n  it(\"accepts rich variables for act requests\", () => {\n    const result = Api.ActRequestSchema.safeParse({\n      input: \"type %username% into the email field\",\n      options: {\n        variables: {\n          username: {\n            value: \"john@example.com\",\n            description: \"The login email\",\n          },\n          rememberMe: true,\n        },\n      },\n    });\n\n    expect(result.success).toBe(true);\n  });\n\n  it(\"accepts rich variables for observe requests\", () => {\n    const result = Api.ObserveRequestSchema.safeParse({\n      instruction: \"find the field where %username% should be entered\",\n      options: {\n        variables: {\n          username: {\n            value: \"john@example.com\",\n            description: \"The login email\",\n          },\n          rememberMe: true,\n        },\n        ignoreSelectors: [\".cookie-banner\", \"#sidebar-ads\"],\n      },\n    });\n\n    expect(result.success).toBe(true);\n    if (!result.success) throw result.error;\n    expect(result.data.options?.ignoreSelectors).toEqual([\n      \".cookie-banner\",\n      \"#sidebar-ads\",\n    ]);\n  });\n\n  it(\"preserves variables for agent execute requests\", () => {\n    const result = Api.AgentExecuteRequestSchema.safeParse({\n      agentConfig: { mode: \"dom\" },\n      executeOptions: {\n        instruction: \"fill the form with %username% and %password%\",\n        variables: {\n          username: \"john@example.com\",\n          password: {\n            value: \"secret-password\",\n            description: \"The login password\",\n          },\n        },\n      },\n    });\n\n    expect(result.success).toBe(true);\n    if (!result.success) throw result.error;\n    expect(result.data.executeOptions.variables).toEqual({\n      username: \"john@example.com\",\n      password: {\n        value: \"secret-password\",\n        description: \"The login password\",\n      },\n    });\n  });\n});\n"]}

package/dist/esm/tests/unit/browserbase-session-accessors.test.d.ts

@@ -1 +0,0 @@
-export {};

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

@@ -1,140 +0,0 @@
-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() {
-            // noop
-        }
-    }
-    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);
-            expect(v3.isCaptchaAutoSolveEnabled).toBe(true);
-        }
-        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();
-    });
-    it("disables captcha solving when solveCaptchas is explicitly false", async () => {
-        const v3 = new V3({
-            env: "BROWSERBASE",
-            disableAPI: true,
-            verbose: 0,
-            browserbaseSessionCreateParams: {
-                browserSettings: {
-                    solveCaptchas: false,
-                },
-            },
-        });
-        try {
-            await v3.init();
-            expect(v3.isCaptchaAutoSolveEnabled).toBe(false);
-        }
-        finally {
-            await v3.close().catch(() => { });
-        }
-    });
-    it("treats verified Browserbase sessions as managed fingerprinting mode", async () => {
-        const v3 = new V3({
-            env: "BROWSERBASE",
-            disableAPI: true,
-            verbose: 0,
-            browserbaseSessionCreateParams: {
-                browserSettings: {
-                    verified: true,
-                },
-            },
-        });
-        try {
-            await v3.init();
-            expect(v3.isVerified).toBe(true);
-            expect(v3.isAdvancedStealth).toBe(true);
-        }
-        finally {
-            await v3.close().catch(() => { });
-        }
-    });
-});
-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/unit/browserbase-session-accessors.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"browserbase-session-accessors.test.js","sourceRoot":"","sources":["../../../../tests/unit/browserbase-session-accessors.test.ts"],"names":[],"mappings":"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","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      expect(v3.isCaptchaAutoSolveEnabled).toBe(true);\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  it(\"disables captcha solving when solveCaptchas is explicitly false\", async () => {\n    const v3 = new V3({\n      env: \"BROWSERBASE\",\n      disableAPI: true,\n      verbose: 0,\n      browserbaseSessionCreateParams: {\n        browserSettings: {\n          solveCaptchas: false,\n        },\n      },\n    });\n\n    try {\n      await v3.init();\n      expect(v3.isCaptchaAutoSolveEnabled).toBe(false);\n    } finally {\n      await v3.close().catch(() => {});\n    }\n  });\n\n  it(\"treats verified Browserbase sessions as managed fingerprinting mode\", async () => {\n    const v3 = new V3({\n      env: \"BROWSERBASE\",\n      disableAPI: true,\n      verbose: 0,\n      browserbaseSessionCreateParams: {\n        browserSettings: {\n          verified: true,\n        },\n      },\n    });\n\n    try {\n      await v3.init();\n      expect(v3.isVerified).toBe(true);\n      expect(v3.isAdvancedStealth).toBe(true);\n    } finally {\n      await v3.close().catch(() => {});\n    }\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"]}

package/dist/esm/tests/unit/cache-llm-resolution.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/esm/tests/unit/cache-llm-resolution.test.js

@@ -1,184 +0,0 @@
-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: undefined,
-        });
-        const context = {
-            instruction: "click button",
-            cacheKey: "abc",
-            pageUrl: "https://example.com",
-            variableKeys: [],
-            variables: undefined,
-        };
-        const result = await cache.tryReplay(context, {}, undefined, 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: 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: () => undefined,
-            domSettleTimeoutMs: undefined,
-            act: vi.fn(),
-        });
-        const context = {
-            instruction: "fill form",
-            startUrl: "https://example.com",
-            options: {},
-            configSignature: "sig",
-            cacheKey: "agent-key",
-            variableKeys: [],
-        };
-        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: 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: () => undefined,
-            domSettleTimeoutMs: undefined,
-            act: vi.fn(),
-        });
-        const context = {
-            instruction: "navigate home",
-            startUrl: "https://example.com/source",
-            options: {},
-            configSignature: "sig",
-            cacheKey: "agent-goto",
-            variableKeys: [],
-        };
-        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/unit/cache-llm-resolution.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cache-llm-resolution.test.js","sourceRoot":"","sources":["../../../../tests/unit/cache-llm-resolution.test.ts"],"names":[],"mappings":"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","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      variableKeys: [],\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      variableKeys: [],\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"]}

package/dist/esm/tests/unit/captcha-solver.test.d.ts

@@ -1 +0,0 @@
-export {};