@browserbasehq/orca 3.1.0-patch.3 → 3.2.0-middleware.1

package/dist/cjs/tests/unit/agent-captcha-hooks.test.js

@@ -0,0 +1,285 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const captchaSolver_js_1 = require("../../lib/v3/agent/utils/captchaSolver.js");
+const v3AgentHandler_js_1 = require("../../lib/v3/handlers/v3AgentHandler.js");
+const SOLVING_STARTED = "browserbase-solving-started";
+const SOLVING_FINISHED = "browserbase-solving-finished";
+const SOLVING_ERRORED = "browserbase-solving-errored";
+class MockPage {
+    listeners = new Set();
+    captchaBoxes = [];
+    on(event, listener) {
+        if (event === "console") {
+            this.listeners.add(listener);
+        }
+    }
+    off(event, listener) {
+        if (event === "console") {
+            this.listeners.delete(listener);
+        }
+    }
+    emitConsole(text) {
+        const message = { text: () => text };
+        for (const listener of this.listeners) {
+            listener(message);
+        }
+    }
+    url() {
+        return "https://example.com";
+    }
+    async screenshot() {
+        return Buffer.from("fake-image");
+    }
+    async evaluate() {
+        return this.captchaBoxes;
+    }
+    mainFrame() {
+        return {
+            evaluate: async () => ({ w: 1288, h: 711 }),
+        };
+    }
+}
+class FakeCuaClient {
+    contextNotes = [];
+    preStepHook;
+    actionHandler;
+    executeImpl = vitest_1.vi.fn(async (options) => {
+        void options;
+        return {
+            success: true,
+            message: "ok",
+            actions: [],
+            completed: true,
+        };
+    });
+    captureScreenshot = vitest_1.vi.fn(async () => null);
+    setViewport = vitest_1.vi.fn();
+    setCurrentUrl = vitest_1.vi.fn();
+    setScreenshotProvider = vitest_1.vi.fn();
+    setSafetyConfirmationHandler = vitest_1.vi.fn();
+    setActionHandler(handler) {
+        this.actionHandler = handler;
+    }
+    setPreStepHook(handler) {
+        this.preStepHook = handler;
+    }
+    addContextNote(note) {
+        this.contextNotes.push(note);
+    }
+    async execute(options) {
+        return this.executeImpl(options);
+    }
+}
+let fakeCuaClient;
+vitest_1.vi.mock("../../lib/v3/agent/AgentProvider", () => ({
+    AgentProvider: class {
+        constructor(logger) {
+            void logger;
+        }
+        getClient() {
+            return fakeCuaClient;
+        }
+    },
+}));
+const v3CuaAgentHandler_js_1 = require("../../lib/v3/handlers/v3CuaAgentHandler.js");
+function collectUserMessages(messages) {
+    return messages.filter((message) => message.role === "user" && typeof message.content === "string");
+}
+(0, vitest_1.describe)("agent captcha hooks", () => {
+    let page;
+    let logs;
+    let logger;
+    (0, vitest_1.beforeEach)(() => {
+        page = new MockPage();
+        logs = [];
+        logger = (line) => {
+            logs.push(line);
+        };
+        fakeCuaClient = new FakeCuaClient();
+    });
+    (0, vitest_1.it)("blocks regular agent prepareStep until the solver finishes and injects one solved message", async () => {
+        const handler = new v3AgentHandler_js_1.V3AgentHandler({
+            isCaptchaAutoSolveEnabled: true,
+        }, logger, {});
+        const solver = new captchaSolver_js_1.CaptchaSolver();
+        solver.init(async () => page);
+        const userCallback = vitest_1.vi.fn(async (options) => options);
+        const prepareStep = handler.createPrepareStep(userCallback, solver);
+        const options = {
+            messages: [{ role: "user", content: "start" }],
+        };
+        await prepareStep(options);
+        page.emitConsole(SOLVING_STARTED);
+        const secondCall = prepareStep(options);
+        await Promise.resolve();
+        (0, vitest_1.expect)(userCallback).toHaveBeenCalledTimes(1);
+        page.emitConsole(SOLVING_FINISHED);
+        await secondCall;
+        (0, vitest_1.expect)(userCallback).toHaveBeenCalledTimes(2);
+        (0, vitest_1.expect)(collectUserMessages(options.messages).filter((message) => message.content.includes("automatically detected and solved"))).toHaveLength(1);
+    });
+    (0, vitest_1.it)("injects one error message when the regular agent solver errors", async () => {
+        const handler = new v3AgentHandler_js_1.V3AgentHandler({
+            isCaptchaAutoSolveEnabled: true,
+        }, logger, {});
+        const solver = new captchaSolver_js_1.CaptchaSolver();
+        solver.init(async () => page);
+        const prepareStep = handler.createPrepareStep(undefined, solver);
+        const options = {
+            messages: [{ role: "user", content: "start" }],
+        };
+        await prepareStep(options);
+        page.emitConsole(SOLVING_STARTED);
+        const pending = prepareStep(options);
+        page.emitConsole(SOLVING_ERRORED);
+        await pending;
+        (0, vitest_1.expect)(collectUserMessages(options.messages).filter((message) => message.content.includes("automatic captcha solver failed"))).toHaveLength(1);
+    });
+    (0, vitest_1.it)("pauses the CUA loop at prepareStep while Browserbase solves a captcha", async () => {
+        let secondPrepareStarted = false;
+        fakeCuaClient.executeImpl = vitest_1.vi.fn(async () => {
+            await fakeCuaClient.preStepHook?.();
+            page.emitConsole(SOLVING_STARTED);
+            const blockedPrepare = fakeCuaClient.preStepHook?.() ?? Promise.resolve();
+            secondPrepareStarted = true;
+            await blockedPrepare;
+            return {
+                success: true,
+                message: "ok",
+                actions: [],
+                completed: true,
+            };
+        });
+        const handler = new v3CuaAgentHandler_js_1.V3CuaAgentHandler({
+            context: {
+                awaitActivePage: async () => page,
+            },
+            bus: { emit: vitest_1.vi.fn() },
+            isCaptchaAutoSolveEnabled: true,
+            isAdvancedStealth: false,
+            configuredViewport: { width: 1288, height: 711 },
+            isAgentReplayActive: () => false,
+            updateMetrics: vitest_1.vi.fn(),
+        }, logger, {
+            modelName: "anthropic/claude-haiku-4-5-20251001",
+            clientOptions: { waitBetweenActions: 1 },
+        });
+        const execution = handler.execute({
+            instruction: "Describe the page briefly.",
+            highlightCursor: false,
+        });
+        await vitest_1.vi.waitFor(() => {
+            (0, vitest_1.expect)(secondPrepareStarted).toBe(true);
+            (0, vitest_1.expect)(logs.some((line) => line.message.includes("waiting for Browserbase to solve"))).toBe(true);
+        });
+        (0, vitest_1.expect)(logs.some((line) => line.message.includes("Captcha solved"))).toBe(false);
+        page.emitConsole(SOLVING_FINISHED);
+        await execution;
+        (0, vitest_1.expect)(fakeCuaClient.contextNotes).toEqual([
+            vitest_1.expect.stringContaining("automatically detected and solved"),
+        ]);
+        (0, vitest_1.expect)(logs.some((line) => line.message.includes("Captcha solved"))).toBe(true);
+    });
+    (0, vitest_1.it)("pauses CUA actions until the captcha solver finishes", async () => {
+        let actionStarted = false;
+        fakeCuaClient.executeImpl = vitest_1.vi.fn(async () => {
+            await fakeCuaClient.preStepHook?.();
+            page.emitConsole(SOLVING_STARTED);
+            const pendingAction = fakeCuaClient.actionHandler?.({ type: "screenshot" }) ??
+                Promise.resolve();
+            actionStarted = true;
+            await pendingAction;
+            return {
+                success: true,
+                message: "ok",
+                actions: [],
+                completed: true,
+            };
+        });
+        const handler = new v3CuaAgentHandler_js_1.V3CuaAgentHandler({
+            context: {
+                awaitActivePage: async () => page,
+            },
+            bus: { emit: vitest_1.vi.fn() },
+            isCaptchaAutoSolveEnabled: true,
+            isAdvancedStealth: false,
+            configuredViewport: { width: 1288, height: 711 },
+            isAgentReplayActive: () => false,
+            updateMetrics: vitest_1.vi.fn(),
+        }, logger, {
+            modelName: "anthropic/claude-haiku-4-5-20251001",
+            clientOptions: { waitBetweenActions: 1 },
+        });
+        const executeActionSpy = vitest_1.vi
+            .spyOn(handler, "executeAction")
+            .mockResolvedValue({ success: true });
+        vitest_1.vi.spyOn(handler, "captureAndSendScreenshot").mockResolvedValue(null);
+        const execution = handler.execute({
+            instruction: "Describe the page briefly.",
+            highlightCursor: false,
+        });
+        await vitest_1.vi.waitFor(() => {
+            (0, vitest_1.expect)(actionStarted).toBe(true);
+        });
+        (0, vitest_1.expect)(executeActionSpy).not.toHaveBeenCalled();
+        page.emitConsole(SOLVING_FINISHED);
+        await execution;
+        (0, vitest_1.expect)(executeActionSpy).toHaveBeenCalledTimes(1);
+        (0, vitest_1.expect)(fakeCuaClient.contextNotes).toEqual([
+            vitest_1.expect.stringContaining("automatically detected and solved"),
+        ]);
+        (0, vitest_1.expect)(logs.some((line) => line.message.includes("Captcha solved"))).toBe(true);
+    });
+    (0, vitest_1.it)("skips post-solve clicks on the captcha widget and injects another note", async () => {
+        page.captchaBoxes = [{ left: 0, top: 400, right: 140, bottom: 470 }];
+        fakeCuaClient.executeImpl = vitest_1.vi.fn(async () => {
+            await fakeCuaClient.preStepHook?.();
+            page.emitConsole(SOLVING_STARTED);
+            const blockedPrepare = fakeCuaClient.preStepHook?.() ?? Promise.resolve();
+            page.emitConsole(SOLVING_FINISHED);
+            await blockedPrepare;
+            await fakeCuaClient.actionHandler?.({
+                type: "click",
+                button: "left",
+                x: 63,
+                y: 436,
+            });
+            return {
+                success: true,
+                message: "ok",
+                actions: [],
+                completed: true,
+            };
+        });
+        const handler = new v3CuaAgentHandler_js_1.V3CuaAgentHandler({
+            context: {
+                awaitActivePage: async () => page,
+            },
+            bus: { emit: vitest_1.vi.fn() },
+            isCaptchaAutoSolveEnabled: true,
+            isAdvancedStealth: false,
+            configuredViewport: { width: 1288, height: 711 },
+            isAgentReplayActive: () => false,
+            updateMetrics: vitest_1.vi.fn(),
+        }, logger, {
+            modelName: "anthropic/claude-haiku-4-5-20251001",
+            clientOptions: { waitBetweenActions: 1 },
+        });
+        const executeActionSpy = vitest_1.vi
+            .spyOn(handler, "executeAction")
+            .mockResolvedValue({ success: true });
+        vitest_1.vi.spyOn(handler, "captureAndSendScreenshot").mockResolvedValue(null);
+        await handler.execute({
+            instruction: "Describe the page briefly.",
+            highlightCursor: false,
+        });
+        (0, vitest_1.expect)(executeActionSpy).not.toHaveBeenCalled();
+        (0, vitest_1.expect)(fakeCuaClient.contextNotes).toEqual([
+            vitest_1.expect.stringContaining("automatically detected and solved"),
+            vitest_1.expect.stringContaining("Original task: Describe the page briefly."),
+        ]);
+        (0, vitest_1.expect)(logs.some((line) => line.message.includes("Skipped click on solved captcha widget"))).toBe(true);
+    });
+});
+//# sourceMappingURL=agent-captcha-hooks.test.js.map

package/dist/cjs/tests/unit/agent-captcha-hooks.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-captcha-hooks.test.js","sourceRoot":"","sources":["../../../../tests/unit/agent-captcha-hooks.test.ts"],"names":[],"mappings":";;AAAA,mCAA8D;AAE9D,gFAA0E;AAC1E,+EAAyE;AAEzE,MAAM,eAAe,GAAG,6BAA6B,CAAC;AACtD,MAAM,gBAAgB,GAAG,8BAA8B,CAAC;AACxD,MAAM,eAAe,GAAG,6BAA6B,CAAC;AAItD,MAAM,QAAQ;IACJ,SAAS,GAAG,IAAI,GAAG,EAAmB,CAAC;IACxC,YAAY,GAKd,EAAE,CAAC;IAER,EAAE,CAAC,KAAa,EAAE,QAAyB;QACzC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,GAAG,CAAC,KAAa,EAAE,QAAyB;QAC1C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,WAAW,CAAC,IAAY;QACtB,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;QACrC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,GAAG;QACD,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,OAAO,IAAI,CAAC,YAAiB,CAAC;IAChC,CAAC;IAED,SAAS;QACP,OAAO;YACL,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;SAC5C,CAAC;IACJ,CAAC;CACF;AAED,MAAM,aAAa;IACV,YAAY,GAAa,EAAE,CAAC;IAC5B,WAAW,CAAuB;IAClC,aAAa,CAAsD;IACnE,WAAW,GAAG,WAAE,CAAC,EAAE,CAAC,KAAK,EAAE,OAAgB,EAAE,EAAE;QACpD,KAAK,OAAO,CAAC;QACb,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,IAAI;SAChB,CAAC;IACJ,CAAC,CAAC,CAAC;IACI,iBAAiB,GAAG,WAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;IAC5C,WAAW,GAAG,WAAE,CAAC,EAAE,EAAE,CAAC;IACtB,aAAa,GAAG,WAAE,CAAC,EAAE,EAAE,CAAC;IACxB,qBAAqB,GAAG,WAAE,CAAC,EAAE,EAAE,CAAC;IAChC,4BAA4B,GAAG,WAAE,CAAC,EAAE,EAAE,CAAC;IAE9C,gBAAgB,CACd,OAA2D;QAE3D,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;IAC/B,CAAC;IAED,cAAc,CAAC,OAA4B;QACzC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;IAC7B,CAAC;IAED,cAAc,CAAC,IAAY;QACzB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAgB;QAM5B,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;CACF;AAED,IAAI,aAA4B,CAAC;AAEjC,WAAE,CAAC,IAAI,CAAC,kCAAkC,EAAE,GAAG,EAAE,CAAC,CAAC;IACjD,aAAa,EAAE;QACb,YAAY,MAAe;YACzB,KAAK,MAAM,CAAC;QACd,CAAC;QAED,SAAS;YACP,OAAO,aAAa,CAAC;QACvB,CAAC;KACF;CACF,CAAC,CAAC,CAAC;AAEJ,qFAA+E;AAE/E,SAAS,mBAAmB,CAC1B,QAAmD;IAEnD,OAAO,QAAQ,CAAC,MAAM,CACpB,CAAC,OAAO,EAAgD,EAAE,CACxD,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CACjE,CAAC;AACJ,CAAC;AAED,IAAA,iBAAQ,EAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,IAAI,IAAc,CAAC;IACnB,IAAI,IAAe,CAAC;IACpB,IAAI,MAA+B,CAAC;IAEpC,IAAA,mBAAU,EAAC,GAAG,EAAE;QACd,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QACtB,IAAI,GAAG,EAAE,CAAC;QACV,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE;YAChB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC,CAAC;QACF,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,2FAA2F,EAAE,KAAK,IAAI,EAAE;QACzG,MAAM,OAAO,GAAG,IAAI,kCAAc,CAChC;YACE,yBAAyB,EAAE,IAAI;SACvB,EACV,MAAM,EACN,EAAW,CACZ,CAAC;QACF,MAAM,MAAM,GAAG,IAAI,gCAAa,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,IAAa,CAAC,CAAC;QAEvC,MAAM,YAAY,GAAG,WAAE,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;QACvD,MAAM,WAAW,GACf,OAMD,CAAC,iBAAiB,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QAE1C,MAAM,OAAO,GAAG;YACd,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;SAC/C,CAAC;QAEF,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;QAElC,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACxB,IAAA,eAAM,EAAC,YAAY,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAE9C,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;QACnC,MAAM,UAAU,CAAC;QAEjB,IAAA,eAAM,EAAC,YAAY,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC9C,IAAA,eAAM,EACJ,mBAAmB,CACjB,OAAO,CAAC,QAAqD,CAC9D,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CACnB,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,mCAAmC,CAAC,CAC9D,CACF,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,OAAO,GAAG,IAAI,kCAAc,CAChC;YACE,yBAAyB,EAAE,IAAI;SACvB,EACV,MAAM,EACN,EAAW,CACZ,CAAC;QACF,MAAM,MAAM,GAAG,IAAI,gCAAa,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,IAAa,CAAC,CAAC;QAEvC,MAAM,WAAW,GACf,OAMD,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAEvC,MAAM,OAAO,GAAG;YACd,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;SAC/C,CAAC;QAEF,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;QAElC,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;QAClC,MAAM,OAAO,CAAC;QAEd,IAAA,eAAM,EACJ,mBAAmB,CACjB,OAAO,CAAC,QAAqD,CAC9D,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CACnB,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,iCAAiC,CAAC,CAC5D,CACF,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;QACrF,IAAI,oBAAoB,GAAG,KAAK,CAAC;QAEjC,aAAa,CAAC,WAAW,GAAG,WAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE;YAC3C,MAAM,aAAa,CAAC,WAAW,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;YAElC,MAAM,cAAc,GAAG,aAAa,CAAC,WAAW,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1E,oBAAoB,GAAG,IAAI,CAAC;YAC5B,MAAM,cAAc,CAAC;YAErB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,EAAE;gBACX,SAAS,EAAE,IAAI;aAChB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,IAAI,wCAAiB,CACnC;YACE,OAAO,EAAE;gBACP,eAAe,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;aAClC;YACD,GAAG,EAAE,EAAE,IAAI,EAAE,WAAE,CAAC,EAAE,EAAE,EAAE;YACtB,yBAAyB,EAAE,IAAI;YAC/B,iBAAiB,EAAE,KAAK;YACxB,kBAAkB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;YAChD,mBAAmB,EAAE,GAAG,EAAE,CAAC,KAAK;YAChC,aAAa,EAAE,WAAE,CAAC,EAAE,EAAE;SACd,EACV,MAAM,EACN;YACE,SAAS,EAAE,qCAAqC;YAChD,aAAa,EAAE,EAAE,kBAAkB,EAAE,CAAC,EAAE;SAChC,CACX,CAAC;QAEF,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;YAChC,WAAW,EAAE,4BAA4B;YACzC,eAAe,EAAE,KAAK;SACvB,CAAC,CAAC;QAEH,MAAM,WAAE,CAAC,OAAO,CAAC,GAAG,EAAE;YACpB,IAAA,eAAM,EAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxC,IAAA,eAAM,EACJ,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACjB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,kCAAkC,CAAC,CAC1D,CACF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CACvE,KAAK,CACN,CAAC;QAEF,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;QACnC,MAAM,SAAS,CAAC;QAEhB,IAAA,eAAM,EAAC,aAAa,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;YACzC,eAAM,CAAC,gBAAgB,CAAC,mCAAmC,CAAC;SAC7D,CAAC,CAAC;QACH,IAAA,eAAM,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CACvE,IAAI,CACL,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,IAAI,aAAa,GAAG,KAAK,CAAC;QAE1B,aAAa,CAAC,WAAW,GAAG,WAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE;YAC3C,MAAM,aAAa,CAAC,WAAW,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;YAElC,MAAM,aAAa,GACjB,aAAa,CAAC,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;gBACrD,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,aAAa,GAAG,IAAI,CAAC;YACrB,MAAM,aAAa,CAAC;YAEpB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,EAAE;gBACX,SAAS,EAAE,IAAI;aAChB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,IAAI,wCAAiB,CACnC;YACE,OAAO,EAAE;gBACP,eAAe,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;aAClC;YACD,GAAG,EAAE,EAAE,IAAI,EAAE,WAAE,CAAC,EAAE,EAAE,EAAE;YACtB,yBAAyB,EAAE,IAAI;YAC/B,iBAAiB,EAAE,KAAK;YACxB,kBAAkB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;YAChD,mBAAmB,EAAE,GAAG,EAAE,CAAC,KAAK;YAChC,aAAa,EAAE,WAAE,CAAC,EAAE,EAAE;SACd,EACV,MAAM,EACN;YACE,SAAS,EAAE,qCAAqC;YAChD,aAAa,EAAE,EAAE,kBAAkB,EAAE,CAAC,EAAE;SAChC,CACX,CAAC;QACF,MAAM,gBAAgB,GAAG,WAAE;aACxB,KAAK,CACJ,OAEC,EACD,eAAe,CAChB;aACA,iBAAiB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,WAAE,CAAC,KAAK,CAAC,OAAO,EAAE,0BAA0B,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAEtE,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;YAChC,WAAW,EAAE,4BAA4B;YACzC,eAAe,EAAE,KAAK;SACvB,CAAC,CAAC;QAEH,MAAM,WAAE,CAAC,OAAO,CAAC,GAAG,EAAE;YACpB,IAAA,eAAM,EAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAChD,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;QACnC,MAAM,SAAS,CAAC;QAEhB,IAAA,eAAM,EAAC,gBAAgB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAClD,IAAA,eAAM,EAAC,aAAa,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;YACzC,eAAM,CAAC,gBAAgB,CAAC,mCAAmC,CAAC;SAC7D,CAAC,CAAC;QACH,IAAA,eAAM,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CACvE,IAAI,CACL,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,IAAI,CAAC,YAAY,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAErE,aAAa,CAAC,WAAW,GAAG,WAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE;YAC3C,MAAM,aAAa,CAAC,WAAW,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;YAElC,MAAM,cAAc,GAAG,aAAa,CAAC,WAAW,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1E,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;YACnC,MAAM,cAAc,CAAC;YAErB,MAAM,aAAa,CAAC,aAAa,EAAE,CAAC;gBAClC,IAAI,EAAE,OAAO;gBACb,MAAM,EAAE,MAAM;gBACd,CAAC,EAAE,EAAE;gBACL,CAAC,EAAE,GAAG;aACP,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,EAAE;gBACX,SAAS,EAAE,IAAI;aAChB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,IAAI,wCAAiB,CACnC;YACE,OAAO,EAAE;gBACP,eAAe,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;aAClC;YACD,GAAG,EAAE,EAAE,IAAI,EAAE,WAAE,CAAC,EAAE,EAAE,EAAE;YACtB,yBAAyB,EAAE,IAAI;YAC/B,iBAAiB,EAAE,KAAK;YACxB,kBAAkB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;YAChD,mBAAmB,EAAE,GAAG,EAAE,CAAC,KAAK;YAChC,aAAa,EAAE,WAAE,CAAC,EAAE,EAAE;SACd,EACV,MAAM,EACN;YACE,SAAS,EAAE,qCAAqC;YAChD,aAAa,EAAE,EAAE,kBAAkB,EAAE,CAAC,EAAE;SAChC,CACX,CAAC;QACF,MAAM,gBAAgB,GAAG,WAAE;aACxB,KAAK,CACJ,OAEC,EACD,eAAe,CAChB;aACA,iBAAiB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,WAAE,CAAC,KAAK,CAAC,OAAO,EAAE,0BAA0B,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAEtE,MAAM,OAAO,CAAC,OAAO,CAAC;YACpB,WAAW,EAAE,4BAA4B;YACzC,eAAe,EAAE,KAAK;SACvB,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAChD,IAAA,eAAM,EAAC,aAAa,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;YACzC,eAAM,CAAC,gBAAgB,CAAC,mCAAmC,CAAC;YAC5D,eAAM,CAAC,gBAAgB,CAAC,2CAA2C,CAAC;SACrE,CAAC,CAAC;QACH,IAAA,eAAM,EACJ,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACjB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,wCAAwC,CAAC,CAChE,CACF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { beforeEach, describe, expect, it, vi } from \"vitest\";\nimport type { LogLine } from \"../../lib/v3/types/public/logs.js\";\nimport { CaptchaSolver } from \"../../lib/v3/agent/utils/captchaSolver.js\";\nimport { V3AgentHandler } from \"../../lib/v3/handlers/v3AgentHandler.js\";\n\nconst SOLVING_STARTED = \"browserbase-solving-started\";\nconst SOLVING_FINISHED = \"browserbase-solving-finished\";\nconst SOLVING_ERRORED = \"browserbase-solving-errored\";\n\ntype ConsoleListener = (message: { text: () => string }) => void;\n\nclass MockPage {\n  private listeners = new Set<ConsoleListener>();\n  public captchaBoxes: Array<{\n    left: number;\n    top: number;\n    right: number;\n    bottom: number;\n  }> = [];\n\n  on(event: string, listener: ConsoleListener): void {\n    if (event === \"console\") {\n      this.listeners.add(listener);\n    }\n  }\n\n  off(event: string, listener: ConsoleListener): void {\n    if (event === \"console\") {\n      this.listeners.delete(listener);\n    }\n  }\n\n  emitConsole(text: string): void {\n    const message = { text: () => text };\n    for (const listener of this.listeners) {\n      listener(message);\n    }\n  }\n\n  url(): string {\n    return \"https://example.com\";\n  }\n\n  async screenshot(): Promise<Buffer> {\n    return Buffer.from(\"fake-image\");\n  }\n\n  async evaluate<T>(): Promise<T> {\n    return this.captchaBoxes as T;\n  }\n\n  mainFrame(): { evaluate: () => Promise<{ w: number; h: number }> } {\n    return {\n      evaluate: async () => ({ w: 1288, h: 711 }),\n    };\n  }\n}\n\nclass FakeCuaClient {\n  public contextNotes: string[] = [];\n  public preStepHook?: () => Promise<void>;\n  public actionHandler?: (action: Record<string, unknown>) => Promise<void>;\n  public executeImpl = vi.fn(async (options: unknown) => {\n    void options;\n    return {\n      success: true,\n      message: \"ok\",\n      actions: [],\n      completed: true,\n    };\n  });\n  public captureScreenshot = vi.fn(async () => null);\n  public setViewport = vi.fn();\n  public setCurrentUrl = vi.fn();\n  public setScreenshotProvider = vi.fn();\n  public setSafetyConfirmationHandler = vi.fn();\n\n  setActionHandler(\n    handler: (action: Record<string, unknown>) => Promise<void>,\n  ): void {\n    this.actionHandler = handler;\n  }\n\n  setPreStepHook(handler: () => Promise<void>): void {\n    this.preStepHook = handler;\n  }\n\n  addContextNote(note: string): void {\n    this.contextNotes.push(note);\n  }\n\n  async execute(options: unknown): Promise<{\n    success: boolean;\n    message: string;\n    actions: unknown[];\n    completed: boolean;\n  }> {\n    return this.executeImpl(options);\n  }\n}\n\nlet fakeCuaClient: FakeCuaClient;\n\nvi.mock(\"../../lib/v3/agent/AgentProvider\", () => ({\n  AgentProvider: class {\n    constructor(logger: unknown) {\n      void logger;\n    }\n\n    getClient(): FakeCuaClient {\n      return fakeCuaClient;\n    }\n  },\n}));\n\nimport { V3CuaAgentHandler } from \"../../lib/v3/handlers/v3CuaAgentHandler.js\";\n\nfunction collectUserMessages(\n  messages: Array<{ role: string; content: unknown }>,\n): Array<{ role: \"user\"; content: string }> {\n  return messages.filter(\n    (message): message is { role: \"user\"; content: string } =>\n      message.role === \"user\" && typeof message.content === \"string\",\n  );\n}\n\ndescribe(\"agent captcha hooks\", () => {\n  let page: MockPage;\n  let logs: LogLine[];\n  let logger: (line: LogLine) => void;\n\n  beforeEach(() => {\n    page = new MockPage();\n    logs = [];\n    logger = (line) => {\n      logs.push(line);\n    };\n    fakeCuaClient = new FakeCuaClient();\n  });\n\n  it(\"blocks regular agent prepareStep until the solver finishes and injects one solved message\", async () => {\n    const handler = new V3AgentHandler(\n      {\n        isCaptchaAutoSolveEnabled: true,\n      } as never,\n      logger,\n      {} as never,\n    );\n    const solver = new CaptchaSolver();\n    solver.init(async () => page as never);\n\n    const userCallback = vi.fn(async (options) => options);\n    const prepareStep = (\n      handler as unknown as {\n        createPrepareStep: (\n          callback?: (options: Record<string, unknown>) => Promise<unknown>,\n          captchaSolver?: CaptchaSolver,\n        ) => (options: Record<string, unknown>) => Promise<unknown>;\n      }\n    ).createPrepareStep(userCallback, solver);\n\n    const options = {\n      messages: [{ role: \"user\", content: \"start\" }],\n    };\n\n    await prepareStep(options);\n    page.emitConsole(SOLVING_STARTED);\n\n    const secondCall = prepareStep(options);\n    await Promise.resolve();\n    expect(userCallback).toHaveBeenCalledTimes(1);\n\n    page.emitConsole(SOLVING_FINISHED);\n    await secondCall;\n\n    expect(userCallback).toHaveBeenCalledTimes(2);\n    expect(\n      collectUserMessages(\n        options.messages as Array<{ role: string; content: unknown }>,\n      ).filter((message) =>\n        message.content.includes(\"automatically detected and solved\"),\n      ),\n    ).toHaveLength(1);\n  });\n\n  it(\"injects one error message when the regular agent solver errors\", async () => {\n    const handler = new V3AgentHandler(\n      {\n        isCaptchaAutoSolveEnabled: true,\n      } as never,\n      logger,\n      {} as never,\n    );\n    const solver = new CaptchaSolver();\n    solver.init(async () => page as never);\n\n    const prepareStep = (\n      handler as unknown as {\n        createPrepareStep: (\n          callback?: (options: Record<string, unknown>) => Promise<unknown>,\n          captchaSolver?: CaptchaSolver,\n        ) => (options: Record<string, unknown>) => Promise<unknown>;\n      }\n    ).createPrepareStep(undefined, solver);\n\n    const options = {\n      messages: [{ role: \"user\", content: \"start\" }],\n    };\n\n    await prepareStep(options);\n    page.emitConsole(SOLVING_STARTED);\n\n    const pending = prepareStep(options);\n    page.emitConsole(SOLVING_ERRORED);\n    await pending;\n\n    expect(\n      collectUserMessages(\n        options.messages as Array<{ role: string; content: unknown }>,\n      ).filter((message) =>\n        message.content.includes(\"automatic captcha solver failed\"),\n      ),\n    ).toHaveLength(1);\n  });\n\n  it(\"pauses the CUA loop at prepareStep while Browserbase solves a captcha\", async () => {\n    let secondPrepareStarted = false;\n\n    fakeCuaClient.executeImpl = vi.fn(async () => {\n      await fakeCuaClient.preStepHook?.();\n      page.emitConsole(SOLVING_STARTED);\n\n      const blockedPrepare = fakeCuaClient.preStepHook?.() ?? Promise.resolve();\n      secondPrepareStarted = true;\n      await blockedPrepare;\n\n      return {\n        success: true,\n        message: \"ok\",\n        actions: [],\n        completed: true,\n      };\n    });\n\n    const handler = new V3CuaAgentHandler(\n      {\n        context: {\n          awaitActivePage: async () => page,\n        },\n        bus: { emit: vi.fn() },\n        isCaptchaAutoSolveEnabled: true,\n        isAdvancedStealth: false,\n        configuredViewport: { width: 1288, height: 711 },\n        isAgentReplayActive: () => false,\n        updateMetrics: vi.fn(),\n      } as never,\n      logger,\n      {\n        modelName: \"anthropic/claude-haiku-4-5-20251001\",\n        clientOptions: { waitBetweenActions: 1 },\n      } as never,\n    );\n\n    const execution = handler.execute({\n      instruction: \"Describe the page briefly.\",\n      highlightCursor: false,\n    });\n\n    await vi.waitFor(() => {\n      expect(secondPrepareStarted).toBe(true);\n      expect(\n        logs.some((line) =>\n          line.message.includes(\"waiting for Browserbase to solve\"),\n        ),\n      ).toBe(true);\n    });\n\n    expect(logs.some((line) => line.message.includes(\"Captcha solved\"))).toBe(\n      false,\n    );\n\n    page.emitConsole(SOLVING_FINISHED);\n    await execution;\n\n    expect(fakeCuaClient.contextNotes).toEqual([\n      expect.stringContaining(\"automatically detected and solved\"),\n    ]);\n    expect(logs.some((line) => line.message.includes(\"Captcha solved\"))).toBe(\n      true,\n    );\n  });\n\n  it(\"pauses CUA actions until the captcha solver finishes\", async () => {\n    let actionStarted = false;\n\n    fakeCuaClient.executeImpl = vi.fn(async () => {\n      await fakeCuaClient.preStepHook?.();\n      page.emitConsole(SOLVING_STARTED);\n\n      const pendingAction =\n        fakeCuaClient.actionHandler?.({ type: \"screenshot\" }) ??\n        Promise.resolve();\n      actionStarted = true;\n      await pendingAction;\n\n      return {\n        success: true,\n        message: \"ok\",\n        actions: [],\n        completed: true,\n      };\n    });\n\n    const handler = new V3CuaAgentHandler(\n      {\n        context: {\n          awaitActivePage: async () => page,\n        },\n        bus: { emit: vi.fn() },\n        isCaptchaAutoSolveEnabled: true,\n        isAdvancedStealth: false,\n        configuredViewport: { width: 1288, height: 711 },\n        isAgentReplayActive: () => false,\n        updateMetrics: vi.fn(),\n      } as never,\n      logger,\n      {\n        modelName: \"anthropic/claude-haiku-4-5-20251001\",\n        clientOptions: { waitBetweenActions: 1 },\n      } as never,\n    );\n    const executeActionSpy = vi\n      .spyOn(\n        handler as unknown as {\n          executeAction: (action: Record<string, unknown>) => Promise<unknown>;\n        },\n        \"executeAction\",\n      )\n      .mockResolvedValue({ success: true });\n    vi.spyOn(handler, \"captureAndSendScreenshot\").mockResolvedValue(null);\n\n    const execution = handler.execute({\n      instruction: \"Describe the page briefly.\",\n      highlightCursor: false,\n    });\n\n    await vi.waitFor(() => {\n      expect(actionStarted).toBe(true);\n    });\n\n    expect(executeActionSpy).not.toHaveBeenCalled();\n    page.emitConsole(SOLVING_FINISHED);\n    await execution;\n\n    expect(executeActionSpy).toHaveBeenCalledTimes(1);\n    expect(fakeCuaClient.contextNotes).toEqual([\n      expect.stringContaining(\"automatically detected and solved\"),\n    ]);\n    expect(logs.some((line) => line.message.includes(\"Captcha solved\"))).toBe(\n      true,\n    );\n  });\n\n  it(\"skips post-solve clicks on the captcha widget and injects another note\", async () => {\n    page.captchaBoxes = [{ left: 0, top: 400, right: 140, bottom: 470 }];\n\n    fakeCuaClient.executeImpl = vi.fn(async () => {\n      await fakeCuaClient.preStepHook?.();\n      page.emitConsole(SOLVING_STARTED);\n\n      const blockedPrepare = fakeCuaClient.preStepHook?.() ?? Promise.resolve();\n      page.emitConsole(SOLVING_FINISHED);\n      await blockedPrepare;\n\n      await fakeCuaClient.actionHandler?.({\n        type: \"click\",\n        button: \"left\",\n        x: 63,\n        y: 436,\n      });\n\n      return {\n        success: true,\n        message: \"ok\",\n        actions: [],\n        completed: true,\n      };\n    });\n\n    const handler = new V3CuaAgentHandler(\n      {\n        context: {\n          awaitActivePage: async () => page,\n        },\n        bus: { emit: vi.fn() },\n        isCaptchaAutoSolveEnabled: true,\n        isAdvancedStealth: false,\n        configuredViewport: { width: 1288, height: 711 },\n        isAgentReplayActive: () => false,\n        updateMetrics: vi.fn(),\n      } as never,\n      logger,\n      {\n        modelName: \"anthropic/claude-haiku-4-5-20251001\",\n        clientOptions: { waitBetweenActions: 1 },\n      } as never,\n    );\n    const executeActionSpy = vi\n      .spyOn(\n        handler as unknown as {\n          executeAction: (action: Record<string, unknown>) => Promise<unknown>;\n        },\n        \"executeAction\",\n      )\n      .mockResolvedValue({ success: true });\n    vi.spyOn(handler, \"captureAndSendScreenshot\").mockResolvedValue(null);\n\n    await handler.execute({\n      instruction: \"Describe the page briefly.\",\n      highlightCursor: false,\n    });\n\n    expect(executeActionSpy).not.toHaveBeenCalled();\n    expect(fakeCuaClient.contextNotes).toEqual([\n      expect.stringContaining(\"automatically detected and solved\"),\n      expect.stringContaining(\"Original task: Describe the page briefly.\"),\n    ]);\n    expect(\n      logs.some((line) =>\n        line.message.includes(\"Skipped click on solved captcha widget\"),\n      ),\n    ).toBe(true);\n  });\n});\n"]}

package/dist/cjs/tests/unit/agent-execution-model.test.d.ts

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

package/dist/cjs/tests/unit/agent-execution-model.test.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const act_js_1 = require("../../lib/v3/agent/tools/act.js");
+const extract_js_1 = require("../../lib/v3/agent/tools/extract.js");
+const fillform_js_1 = require("../../lib/v3/agent/tools/fillform.js");
+/**
+ * Minimal mock of V3 that captures how tools pass `model` options
+ * into v3.act(), v3.extract(), and v3.observe().
+ */
+function createMockV3() {
+    const calls = [];
+    const mock = {
+        logger: vitest_1.vi.fn(),
+        recordAgentReplayStep: vitest_1.vi.fn(),
+        act: vitest_1.vi.fn(async (_instruction, options) => {
+            calls.push({ method: "act", model: options?.model });
+            return {
+                success: true,
+                message: "ok",
+                actionDescription: "clicked",
+                actions: [],
+            };
+        }),
+        extract: vitest_1.vi.fn(async (_instruction, _schema, options) => {
+            calls.push({ method: "extract", model: options?.model });
+            return { extraction: "data" };
+        }),
+        observe: vitest_1.vi.fn(async (_instruction, options) => {
+            calls.push({ method: "observe", model: options?.model });
+            return [];
+        }),
+        calls,
+    };
+    return mock;
+}
+(0, vitest_1.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",
+    };
+    (0, vitest_1.it)("actTool passes AgentModelConfig object to v3.act()", async () => {
+        const v3 = createMockV3();
+        const tool = (0, act_js_1.actTool)(v3, modelConfig);
+        await tool.execute({ action: "click the button" }, {
+            toolCallId: "t1",
+            messages: [],
+            abortSignal: new AbortController().signal,
+        });
+        (0, vitest_1.expect)(v3.calls).toHaveLength(1);
+        (0, vitest_1.expect)(v3.calls[0].method).toBe("act");
+        (0, vitest_1.expect)(v3.calls[0].model).toBe(modelConfig);
+    });
+    (0, vitest_1.it)("extractTool passes AgentModelConfig object to v3.extract()", async () => {
+        const v3 = createMockV3();
+        const tool = (0, extract_js_1.extractTool)(v3, modelConfig);
+        await tool.execute({ instruction: "get the title", schema: undefined }, {
+            toolCallId: "t2",
+            messages: [],
+            abortSignal: new AbortController().signal,
+        });
+        (0, vitest_1.expect)(v3.calls).toHaveLength(1);
+        (0, vitest_1.expect)(v3.calls[0].method).toBe("extract");
+        (0, vitest_1.expect)(v3.calls[0].model).toBe(modelConfig);
+    });
+    (0, vitest_1.it)("fillFormTool passes AgentModelConfig object to v3.observe()", async () => {
+        const v3 = createMockV3();
+        const tool = (0, fillform_js_1.fillFormTool)(v3, modelConfig);
+        await tool.execute({ fields: [{ action: "type hello into name" }] }, {
+            toolCallId: "t3",
+            messages: [],
+            abortSignal: new AbortController().signal,
+        });
+        (0, vitest_1.expect)(v3.calls).toHaveLength(1);
+        (0, vitest_1.expect)(v3.calls[0].method).toBe("observe");
+        (0, vitest_1.expect)(v3.calls[0].model).toBe(modelConfig);
+    });
+    (0, vitest_1.it)("actTool passes undefined when no executionModel is set", async () => {
+        const v3 = createMockV3();
+        const tool = (0, act_js_1.actTool)(v3, undefined);
+        await tool.execute({ action: "click the button" }, {
+            toolCallId: "t4",
+            messages: [],
+            abortSignal: new AbortController().signal,
+        });
+        (0, vitest_1.expect)(v3.calls).toHaveLength(1);
+        (0, vitest_1.expect)(v3.calls[0].model).toBeUndefined();
+    });
+    (0, vitest_1.it)("actTool passes plain string executionModel to v3.act()", async () => {
+        const v3 = createMockV3();
+        const tool = (0, act_js_1.actTool)(v3, "openai/gpt-4o-mini");
+        await tool.execute({ action: "click the button" }, {
+            toolCallId: "t5",
+            messages: [],
+            abortSignal: new AbortController().signal,
+        });
+        (0, vitest_1.expect)(v3.calls).toHaveLength(1);
+        (0, vitest_1.expect)(v3.calls[0].model).toBe("openai/gpt-4o-mini");
+    });
+});
+(0, vitest_1.describe)("executionModel fallback logic", () => {
+    // This mirrors the resolution in V3.prepareAgentExecution (v3.ts:1682):
+    //   const resolvedExecutionModel = options?.executionModel ?? options?.model;
+    function resolveExecutionModel(options) {
+        return options?.executionModel ?? options?.model;
+    }
+    (0, vitest_1.it)("prefers explicit executionModel over model", () => {
+        const result = resolveExecutionModel({
+            executionModel: "openai/gpt-4o-mini",
+            model: "anthropic/claude-sonnet-4-20250514",
+        });
+        (0, vitest_1.expect)(result).toBe("openai/gpt-4o-mini");
+    });
+    (0, vitest_1.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 });
+        (0, vitest_1.expect)(result).toBe(modelConfig);
+    });
+    (0, vitest_1.it)("returns undefined when neither is set", () => {
+        (0, vitest_1.expect)(resolveExecutionModel({})).toBeUndefined();
+        (0, vitest_1.expect)(resolveExecutionModel(undefined)).toBeUndefined();
+    });
+});
+//# sourceMappingURL=agent-execution-model.test.js.map

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

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

package/dist/cjs/tests/unit/api-multiregion.test.d.ts

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

package/dist/cjs/tests/unit/api-multiregion.test.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const api_1 = require("../../lib/v3/api");
+(0, vitest_1.describe)("Multi-region API URL mapping", () => {
+    (0, vitest_1.describe)("REGION_API_URLS constant", () => {
+        (0, vitest_1.it)("should have the correct URL for us-west-2 (default)", () => {
+            (0, vitest_1.expect)(api_1.REGION_API_URLS["us-west-2"]).toBe("https://api.stagehand.browserbase.com");
+        });
+        (0, vitest_1.it)("should have the correct URL for us-east-1", () => {
+            (0, vitest_1.expect)(api_1.REGION_API_URLS["us-east-1"]).toBe("https://api.use1.stagehand.browserbase.com");
+        });
+        (0, vitest_1.it)("should have the correct URL for eu-central-1", () => {
+            (0, vitest_1.expect)(api_1.REGION_API_URLS["eu-central-1"]).toBe("https://api.euc1.stagehand.browserbase.com");
+        });
+        (0, vitest_1.it)("should have the correct URL for ap-southeast-1", () => {
+            (0, vitest_1.expect)(api_1.REGION_API_URLS["ap-southeast-1"]).toBe("https://api.apse1.stagehand.browserbase.com");
+        });
+    });
+    (0, vitest_1.describe)("getApiUrlForRegion", () => {
+        (0, vitest_1.it)("should return the correct URL for us-west-2", () => {
+            (0, vitest_1.expect)((0, api_1.getApiUrlForRegion)("us-west-2")).toBe("https://api.stagehand.browserbase.com/v1");
+        });
+        (0, vitest_1.it)("should return the correct URL for us-east-1", () => {
+            (0, vitest_1.expect)((0, api_1.getApiUrlForRegion)("us-east-1")).toBe("https://api.use1.stagehand.browserbase.com/v1");
+        });
+        (0, vitest_1.it)("should return the correct URL for eu-central-1", () => {
+            (0, vitest_1.expect)((0, api_1.getApiUrlForRegion)("eu-central-1")).toBe("https://api.euc1.stagehand.browserbase.com/v1");
+        });
+        (0, vitest_1.it)("should return the correct URL for ap-southeast-1", () => {
+            (0, vitest_1.expect)((0, api_1.getApiUrlForRegion)("ap-southeast-1")).toBe("https://api.apse1.stagehand.browserbase.com/v1");
+        });
+        (0, vitest_1.it)("should return the default us-west-2 URL when no region is specified", () => {
+            (0, vitest_1.expect)((0, api_1.getApiUrlForRegion)(undefined)).toBe("https://api.stagehand.browserbase.com/v1");
+        });
+        (0, vitest_1.it)("should return the default us-west-2 URL for unknown regions", () => {
+            // @ts-expect-error - testing invalid region
+            (0, vitest_1.expect)((0, api_1.getApiUrlForRegion)("invalid-region")).toBe("https://api.stagehand.browserbase.com/v1");
+        });
+    });
+    (0, vitest_1.describe)("URL /v1 suffix handling", () => {
+        (0, vitest_1.it)("getApiUrlForRegion always includes /v1 suffix for consistency", () => {
+            // getApiUrlForRegion returns a URL with /v1
+            // This documents the expected contract that all API base URLs include /v1
+            const url = (0, api_1.getApiUrlForRegion)("us-west-2");
+            (0, vitest_1.expect)(url.endsWith("/v1")).toBe(true);
+        });
+        (0, vitest_1.it)("all regional URLs should be base URLs without /v1 in REGION_API_URLS", () => {
+            // Verify REGION_API_URLS contains base URLs (without /v1)
+            // The /v1 suffix is added by getApiUrlForRegion
+            for (const [region, baseUrl] of Object.entries(api_1.REGION_API_URLS)) {
+                (0, vitest_1.expect)(baseUrl.endsWith("/v1")).toBe(false);
+                (0, vitest_1.expect)((0, api_1.getApiUrlForRegion)(region)).toBe(`${baseUrl}/v1`);
+            }
+        });
+    });
+});
+//# sourceMappingURL=api-multiregion.test.js.map

package/dist/cjs/tests/unit/api-multiregion.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-multiregion.test.js","sourceRoot":"","sources":["../../../../tests/unit/api-multiregion.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { getApiUrlForRegion, REGION_API_URLS } from \"../../lib/v3/api\";\n\ndescribe(\"Multi-region API URL mapping\", () => {\n  describe(\"REGION_API_URLS constant\", () => {\n    it(\"should have the correct URL for us-west-2 (default)\", () => {\n      expect(REGION_API_URLS[\"us-west-2\"]).toBe(\n        \"https://api.stagehand.browserbase.com\",\n      );\n    });\n\n    it(\"should have the correct URL for us-east-1\", () => {\n      expect(REGION_API_URLS[\"us-east-1\"]).toBe(\n        \"https://api.use1.stagehand.browserbase.com\",\n      );\n    });\n\n    it(\"should have the correct URL for eu-central-1\", () => {\n      expect(REGION_API_URLS[\"eu-central-1\"]).toBe(\n        \"https://api.euc1.stagehand.browserbase.com\",\n      );\n    });\n\n    it(\"should have the correct URL for ap-southeast-1\", () => {\n      expect(REGION_API_URLS[\"ap-southeast-1\"]).toBe(\n        \"https://api.apse1.stagehand.browserbase.com\",\n      );\n    });\n  });\n\n  describe(\"getApiUrlForRegion\", () => {\n    it(\"should return the correct URL for us-west-2\", () => {\n      expect(getApiUrlForRegion(\"us-west-2\")).toBe(\n        \"https://api.stagehand.browserbase.com/v1\",\n      );\n    });\n\n    it(\"should return the correct URL for us-east-1\", () => {\n      expect(getApiUrlForRegion(\"us-east-1\")).toBe(\n        \"https://api.use1.stagehand.browserbase.com/v1\",\n      );\n    });\n\n    it(\"should return the correct URL for eu-central-1\", () => {\n      expect(getApiUrlForRegion(\"eu-central-1\")).toBe(\n        \"https://api.euc1.stagehand.browserbase.com/v1\",\n      );\n    });\n\n    it(\"should return the correct URL for ap-southeast-1\", () => {\n      expect(getApiUrlForRegion(\"ap-southeast-1\")).toBe(\n        \"https://api.apse1.stagehand.browserbase.com/v1\",\n      );\n    });\n\n    it(\"should return the default us-west-2 URL when no region is specified\", () => {\n      expect(getApiUrlForRegion(undefined)).toBe(\n        \"https://api.stagehand.browserbase.com/v1\",\n      );\n    });\n\n    it(\"should return the default us-west-2 URL for unknown regions\", () => {\n      // @ts-expect-error - testing invalid region\n      expect(getApiUrlForRegion(\"invalid-region\")).toBe(\n        \"https://api.stagehand.browserbase.com/v1\",\n      );\n    });\n  });\n\n  describe(\"URL /v1 suffix handling\", () => {\n    it(\"getApiUrlForRegion always includes /v1 suffix for consistency\", () => {\n      // getApiUrlForRegion returns a URL with /v1\n      // This documents the expected contract that all API base URLs include /v1\n      const url = getApiUrlForRegion(\"us-west-2\");\n      expect(url.endsWith(\"/v1\")).toBe(true);\n    });\n\n    it(\"all regional URLs should be base URLs without /v1 in REGION_API_URLS\", () => {\n      // Verify REGION_API_URLS contains base URLs (without /v1)\n      // The /v1 suffix is added by getApiUrlForRegion\n      for (const [region, baseUrl] of Object.entries(REGION_API_URLS)) {\n        expect(baseUrl.endsWith(\"/v1\")).toBe(false);\n        expect(getApiUrlForRegion(region as keyof typeof REGION_API_URLS)).toBe(\n          `${baseUrl}/v1`,\n        );\n      }\n    });\n  });\n});\n"]}

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

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