@browserbasehq/orca 3.1.0-patch.4 → 3.2.0-middleware.2

package/dist/cjs/tests/unit/aisdk-reasoning-effort.test.js

@@ -0,0 +1,153 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const aisdk_js_1 = require("../../lib/v3/llm/aisdk.js");
+/**
+ * Creates a mock LanguageModelV2 that records doGenerate calls and returns
+ * a valid JSON response so generateObject / generateText succeed.
+ */
+function createCapturingModel(modelId) {
+    const calls = [];
+    const model = {
+        provider: "mock",
+        modelId,
+        specificationVersion: "v2",
+        supportedUrls: {},
+        doGenerate: vitest_1.vi.fn(async (options) => {
+            calls.push(options);
+            return {
+                content: [{ type: "text", text: '{"value":"ok"}' }],
+                finishReason: "stop",
+                usage: {
+                    inputTokens: 1,
+                    outputTokens: 1,
+                    totalTokens: 2,
+                    reasoningTokens: 0,
+                    cachedInputTokens: 0,
+                },
+                warnings: [],
+            };
+        }),
+        doStream: vitest_1.vi.fn(),
+    };
+    return { model, calls };
+}
+async function callWithSchema(client) {
+    const { z } = await Promise.resolve().then(() => __importStar(require("zod")));
+    await client.createChatCompletion({
+        options: {
+            messages: [{ role: "user", content: "test" }],
+            response_model: {
+                name: "Test",
+                schema: z.object({ value: z.string() }),
+            },
+        },
+        logger: () => { },
+    });
+}
+(0, vitest_1.describe)("AISdkClient reasoning effort resolution", () => {
+    (0, vitest_1.it)("defaults to 'none' for GPT-5.x sub-models", async () => {
+        const { model, calls } = createCapturingModel("gpt-5.1-nano");
+        const client = new aisdk_js_1.AISdkClient({ model });
+        await callWithSchema(client);
+        (0, vitest_1.expect)(calls[0].providerOptions).toEqual({
+            openai: {
+                textVerbosity: "low",
+                reasoningEffort: "none",
+            },
+        });
+    });
+    (0, vitest_1.it)("does not set providerOptions for base gpt-5", async () => {
+        const { model, calls } = createCapturingModel("gpt-5");
+        const client = new aisdk_js_1.AISdkClient({ model });
+        await callWithSchema(client);
+        (0, vitest_1.expect)(calls[0].providerOptions).toBeUndefined();
+    });
+    (0, vitest_1.it)("does not set providerOptions for codex models (gpt-5.x variant)", async () => {
+        const { model, calls } = createCapturingModel("codex-gpt-5.1");
+        const client = new aisdk_js_1.AISdkClient({ model });
+        await callWithSchema(client);
+        (0, vitest_1.expect)(calls[0].providerOptions).toBeUndefined();
+    });
+    (0, vitest_1.it)("does not set providerOptions for non-GPT-5 models by default", async () => {
+        const { model, calls } = createCapturingModel("openai/gpt-4o");
+        const client = new aisdk_js_1.AISdkClient({ model });
+        await callWithSchema(client);
+        (0, vitest_1.expect)(calls[0].providerOptions).toBeUndefined();
+    });
+    (0, vitest_1.it)("user override applies to GPT-5.x sub-models", async () => {
+        const { model, calls } = createCapturingModel("gpt-5.1-nano");
+        const client = new aisdk_js_1.AISdkClient({
+            model,
+            clientOptions: { reasoningEffort: "medium" },
+        });
+        await callWithSchema(client);
+        (0, vitest_1.expect)(calls[0].providerOptions).toEqual({
+            openai: {
+                textVerbosity: "low",
+                reasoningEffort: "medium",
+            },
+        });
+    });
+    (0, vitest_1.it)("user override applies to non-GPT-5 models", async () => {
+        const { model, calls } = createCapturingModel("openai/o4-mini");
+        const client = new aisdk_js_1.AISdkClient({
+            model,
+            clientOptions: { reasoningEffort: "high" },
+        });
+        await callWithSchema(client);
+        (0, vitest_1.expect)(calls[0].providerOptions).toEqual({
+            openai: {
+                reasoningEffort: "high",
+            },
+        });
+    });
+    (0, vitest_1.it)("user override applies to base gpt-5", async () => {
+        const { model, calls } = createCapturingModel("gpt-5");
+        const client = new aisdk_js_1.AISdkClient({
+            model,
+            clientOptions: { reasoningEffort: "low" },
+        });
+        await callWithSchema(client);
+        (0, vitest_1.expect)(calls[0].providerOptions).toEqual({
+            openai: {
+                textVerbosity: "low",
+                reasoningEffort: "low",
+            },
+        });
+    });
+});
+//# sourceMappingURL=aisdk-reasoning-effort.test.js.map

package/dist/cjs/tests/unit/aisdk-reasoning-effort.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aisdk-reasoning-effort.test.js","sourceRoot":"","sources":["../../../../tests/unit/aisdk-reasoning-effort.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it, vi } from \"vitest\";\nimport type {\n  LanguageModelV2,\n  LanguageModelV2CallOptions,\n} from \"@ai-sdk/provider\";\nimport { AISdkClient } from \"../../lib/v3/llm/aisdk.js\";\n\n/**\n * Creates a mock LanguageModelV2 that records doGenerate calls and returns\n * a valid JSON response so generateObject / generateText succeed.\n */\nfunction createCapturingModel(modelId: string) {\n  const calls: LanguageModelV2CallOptions[] = [];\n\n  const model: LanguageModelV2 = {\n    provider: \"mock\",\n    modelId,\n    specificationVersion: \"v2\",\n    supportedUrls: {},\n    doGenerate: vi.fn(async (options: LanguageModelV2CallOptions) => {\n      calls.push(options);\n      return {\n        content: [{ type: \"text\" as const, text: '{\"value\":\"ok\"}' }],\n        finishReason: \"stop\" as const,\n        usage: {\n          inputTokens: 1,\n          outputTokens: 1,\n          totalTokens: 2,\n          reasoningTokens: 0,\n          cachedInputTokens: 0,\n        },\n        warnings: [],\n      };\n    }),\n    doStream: vi.fn(),\n  } as unknown as LanguageModelV2;\n\n  return { model, calls };\n}\n\nasync function callWithSchema(client: AISdkClient) {\n  const { z } = await import(\"zod\");\n  await client.createChatCompletion({\n    options: {\n      messages: [{ role: \"user\", content: \"test\" }],\n      response_model: {\n        name: \"Test\",\n        schema: z.object({ value: z.string() }),\n      },\n    },\n    logger: () => {},\n  });\n}\n\ndescribe(\"AISdkClient reasoning effort resolution\", () => {\n  it(\"defaults to 'none' for GPT-5.x sub-models\", async () => {\n    const { model, calls } = createCapturingModel(\"gpt-5.1-nano\");\n    const client = new AISdkClient({ model });\n    await callWithSchema(client);\n\n    expect(calls[0].providerOptions).toEqual({\n      openai: {\n        textVerbosity: \"low\",\n        reasoningEffort: \"none\",\n      },\n    });\n  });\n\n  it(\"does not set providerOptions for base gpt-5\", async () => {\n    const { model, calls } = createCapturingModel(\"gpt-5\");\n    const client = new AISdkClient({ model });\n    await callWithSchema(client);\n\n    expect(calls[0].providerOptions).toBeUndefined();\n  });\n\n  it(\"does not set providerOptions for codex models (gpt-5.x variant)\", async () => {\n    const { model, calls } = createCapturingModel(\"codex-gpt-5.1\");\n    const client = new AISdkClient({ model });\n    await callWithSchema(client);\n\n    expect(calls[0].providerOptions).toBeUndefined();\n  });\n\n  it(\"does not set providerOptions for non-GPT-5 models by default\", async () => {\n    const { model, calls } = createCapturingModel(\"openai/gpt-4o\");\n    const client = new AISdkClient({ model });\n    await callWithSchema(client);\n\n    expect(calls[0].providerOptions).toBeUndefined();\n  });\n\n  it(\"user override applies to GPT-5.x sub-models\", async () => {\n    const { model, calls } = createCapturingModel(\"gpt-5.1-nano\");\n    const client = new AISdkClient({\n      model,\n      clientOptions: { reasoningEffort: \"medium\" },\n    });\n    await callWithSchema(client);\n\n    expect(calls[0].providerOptions).toEqual({\n      openai: {\n        textVerbosity: \"low\",\n        reasoningEffort: \"medium\",\n      },\n    });\n  });\n\n  it(\"user override applies to non-GPT-5 models\", async () => {\n    const { model, calls } = createCapturingModel(\"openai/o4-mini\");\n    const client = new AISdkClient({\n      model,\n      clientOptions: { reasoningEffort: \"high\" },\n    });\n    await callWithSchema(client);\n\n    expect(calls[0].providerOptions).toEqual({\n      openai: {\n        reasoningEffort: \"high\",\n      },\n    });\n  });\n\n  it(\"user override applies to base gpt-5\", async () => {\n    const { model, calls } = createCapturingModel(\"gpt-5\");\n    const client = new AISdkClient({\n      model,\n      clientOptions: { reasoningEffort: \"low\" },\n    });\n    await callWithSchema(client);\n\n    expect(calls[0].providerOptions).toEqual({\n      openai: {\n        textVerbosity: \"low\",\n        reasoningEffort: \"low\",\n      },\n    });\n  });\n});\n"]}

package/dist/cjs/tests/unit/api-client-observe-variables.test.d.ts

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

package/dist/cjs/tests/unit/api-client-observe-variables.test.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const api_js_1 = require("../../lib/v3/api.js");
+(0, vitest_1.describe)("StagehandAPIClient variable serialization", () => {
+    (0, vitest_1.it)("preserves rich variables when sending the act request", async () => {
+        const client = new api_js_1.StagehandAPIClient({
+            apiKey: "bb-test",
+            logger: vitest_1.vi.fn(),
+        });
+        const executeMock = vitest_1.vi.fn().mockResolvedValue({
+            success: true,
+            message: "ok",
+            actionDescription: "typed",
+            actions: [],
+        });
+        client.execute = executeMock;
+        await client.act({
+            input: "type %username% into the email field",
+            options: {
+                variables: {
+                    username: {
+                        value: "john@example.com",
+                        description: "The login email",
+                    },
+                    password: "secret",
+                },
+            },
+        });
+        (0, vitest_1.expect)(executeMock).toHaveBeenCalledWith({
+            method: "act",
+            args: {
+                input: "type %username% into the email field",
+                options: {
+                    variables: {
+                        username: {
+                            value: "john@example.com",
+                            description: "The login email",
+                        },
+                        password: "secret",
+                    },
+                },
+                frameId: undefined,
+            },
+            serverCache: undefined,
+        });
+    });
+    (0, vitest_1.it)("preserves rich variables when sending the observe request", async () => {
+        const client = new api_js_1.StagehandAPIClient({
+            apiKey: "bb-test",
+            logger: vitest_1.vi.fn(),
+        });
+        const executeMock = vitest_1.vi.fn().mockResolvedValue([]);
+        client.execute = executeMock;
+        await client.observe({
+            instruction: "find the field where %username% should be entered",
+            options: {
+                variables: {
+                    username: {
+                        value: "john@example.com",
+                        description: "The login email",
+                    },
+                    password: "secret",
+                },
+            },
+        });
+        (0, vitest_1.expect)(executeMock).toHaveBeenCalledWith({
+            method: "observe",
+            args: {
+                instruction: "find the field where %username% should be entered",
+                options: {
+                    variables: {
+                        username: {
+                            value: "john@example.com",
+                            description: "The login email",
+                        },
+                        password: "secret",
+                    },
+                },
+                frameId: undefined,
+            },
+            serverCache: undefined,
+        });
+    });
+});
+//# sourceMappingURL=api-client-observe-variables.test.js.map

package/dist/cjs/tests/unit/api-client-observe-variables.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client-observe-variables.test.js","sourceRoot":"","sources":["../../../../tests/unit/api-client-observe-variables.test.ts"],"names":[],"mappings":";;AAAA,mCAAkD;AAClD,gDAAyD;AAEzD,IAAA,iBAAQ,EAAC,2CAA2C,EAAE,GAAG,EAAE;IACzD,IAAA,WAAE,EAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,MAAM,GAAG,IAAI,2BAAkB,CAAC;YACpC,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,WAAE,CAAC,EAAE,EAAE;SAChB,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,WAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YAC5C,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,IAAI;YACb,iBAAiB,EAAE,OAAO;YAC1B,OAAO,EAAE,EAAE;SACZ,CAAC,CAAC;QAGD,MAGD,CAAC,OAAO,GAAG,WAAW,CAAC;QAExB,MAAM,MAAM,CAAC,GAAG,CAAC;YACf,KAAK,EAAE,sCAAsC;YAC7C,OAAO,EAAE;gBACP,SAAS,EAAE;oBACT,QAAQ,EAAE;wBACR,KAAK,EAAE,kBAAkB;wBACzB,WAAW,EAAE,iBAAiB;qBAC/B;oBACD,QAAQ,EAAE,QAAQ;iBACnB;aACF;SACF,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,WAAW,CAAC,CAAC,oBAAoB,CAAC;YACvC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE;gBACJ,KAAK,EAAE,sCAAsC;gBAC7C,OAAO,EAAE;oBACP,SAAS,EAAE;wBACT,QAAQ,EAAE;4BACR,KAAK,EAAE,kBAAkB;4BACzB,WAAW,EAAE,iBAAiB;yBAC/B;wBACD,QAAQ,EAAE,QAAQ;qBACnB;iBACF;gBACD,OAAO,EAAE,SAAS;aACnB;YACD,WAAW,EAAE,SAAS;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,MAAM,GAAG,IAAI,2BAAkB,CAAC;YACpC,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,WAAE,CAAC,EAAE,EAAE;SAChB,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,WAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QAGhD,MAGD,CAAC,OAAO,GAAG,WAAW,CAAC;QAExB,MAAM,MAAM,CAAC,OAAO,CAAC;YACnB,WAAW,EAAE,mDAAmD;YAChE,OAAO,EAAE;gBACP,SAAS,EAAE;oBACT,QAAQ,EAAE;wBACR,KAAK,EAAE,kBAAkB;wBACzB,WAAW,EAAE,iBAAiB;qBAC/B;oBACD,QAAQ,EAAE,QAAQ;iBACnB;aACF;SACF,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,WAAW,CAAC,CAAC,oBAAoB,CAAC;YACvC,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE;gBACJ,WAAW,EAAE,mDAAmD;gBAChE,OAAO,EAAE;oBACP,SAAS,EAAE;wBACT,QAAQ,EAAE;4BACR,KAAK,EAAE,kBAAkB;4BACzB,WAAW,EAAE,iBAAiB;yBAC/B;wBACD,QAAQ,EAAE,QAAQ;qBACnB;iBACF;gBACD,OAAO,EAAE,SAAS;aACnB;YACD,WAAW,EAAE,SAAS;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it, vi } from \"vitest\";\nimport { StagehandAPIClient } from \"../../lib/v3/api.js\";\n\ndescribe(\"StagehandAPIClient variable serialization\", () => {\n  it(\"preserves rich variables when sending the act request\", async () => {\n    const client = new StagehandAPIClient({\n      apiKey: \"bb-test\",\n      logger: vi.fn(),\n    });\n    const executeMock = vi.fn().mockResolvedValue({\n      success: true,\n      message: \"ok\",\n      actionDescription: \"typed\",\n      actions: [],\n    });\n\n    (\n      client as unknown as {\n        execute: typeof executeMock;\n      }\n    ).execute = executeMock;\n\n    await client.act({\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          password: \"secret\",\n        },\n      },\n    });\n\n    expect(executeMock).toHaveBeenCalledWith({\n      method: \"act\",\n      args: {\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            password: \"secret\",\n          },\n        },\n        frameId: undefined,\n      },\n      serverCache: undefined,\n    });\n  });\n\n  it(\"preserves rich variables when sending the observe request\", async () => {\n    const client = new StagehandAPIClient({\n      apiKey: \"bb-test\",\n      logger: vi.fn(),\n    });\n    const executeMock = vi.fn().mockResolvedValue([]);\n\n    (\n      client as unknown as {\n        execute: typeof executeMock;\n      }\n    ).execute = executeMock;\n\n    await client.observe({\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          password: \"secret\",\n        },\n      },\n    });\n\n    expect(executeMock).toHaveBeenCalledWith({\n      method: \"observe\",\n      args: {\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            password: \"secret\",\n          },\n        },\n        frameId: undefined,\n      },\n      serverCache: undefined,\n    });\n  });\n});\n"]}

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

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

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

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const index_js_1 = require("../../lib/v3/types/public/index.js");
+(0, vitest_1.describe)("API variable schemas", () => {
+    (0, vitest_1.it)("accepts rich variables for act requests", () => {
+        const result = index_js_1.Api.ActRequestSchema.safeParse({
+            input: "type %username% into the email field",
+            options: {
+                variables: {
+                    username: {
+                        value: "john@example.com",
+                        description: "The login email",
+                    },
+                    rememberMe: true,
+                },
+            },
+        });
+        (0, vitest_1.expect)(result.success).toBe(true);
+    });
+    (0, vitest_1.it)("accepts rich variables for observe requests", () => {
+        const result = index_js_1.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,
+                },
+            },
+        });
+        (0, vitest_1.expect)(result.success).toBe(true);
+    });
+});
+//# sourceMappingURL=api-variables-schema.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api-variables-schema.test.js","sourceRoot":"","sources":["../../../../tests/unit/api-variables-schema.test.ts"],"names":[],"mappings":";;AAAA,mCAA8C;AAC9C,iEAAyD;AAEzD,IAAA,iBAAQ,EAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,IAAA,WAAE,EAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,MAAM,GAAG,cAAG,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,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,cAAG,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;aACF;SACF,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,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      },\n    });\n\n    expect(result.success).toBe(true);\n  });\n});\n"]}

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

@@ -62,6 +62,7 @@ vitest_1.vi.mock("../../lib/v3/launch/local", () => ({
             await v3.init();
             (0, vitest_1.expect)(v3.browserbaseSessionURL).toBe(MOCK_SESSION_URL);
             (0, vitest_1.expect)(v3.browserbaseDebugURL).toBe(MOCK_DEBUG_URL);
+            (0, vitest_1.expect)(v3.isCaptchaAutoSolveEnabled).toBe(true);
         }
         finally {
             await v3.close().catch(() => { });
@@ -78,6 +79,25 @@ vitest_1.vi.mock("../../lib/v3/launch/local", () => ({
         (0, vitest_1.expect)(v3.browserbaseSessionURL).toBeUndefined();
         (0, vitest_1.expect)(v3.browserbaseDebugURL).toBeUndefined();
     });
+    (0, vitest_1.it)("disables captcha solving when solveCaptchas is explicitly false", async () => {
+        const v3 = new v3_js_1.V3({
+            env: "BROWSERBASE",
+            disableAPI: true,
+            verbose: 0,
+            browserbaseSessionCreateParams: {
+                browserSettings: {
+                    solveCaptchas: false,
+                },
+            },
+        });
+        try {
+            await v3.init();
+            (0, vitest_1.expect)(v3.isCaptchaAutoSolveEnabled).toBe(false);
+        }
+        finally {
+            await v3.close().catch(() => { });
+        }
+    });
 });
 (0, vitest_1.describe)("local accessors", () => {
     (0, vitest_1.it)("stay empty for LOCAL environments", async () => {

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

@@ -1 +1 @@
-{"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    } finally {\n      await v3.close().catch(() => {});\n    }\n  });\n\n  it(\"clears stored URLs after close\", async () => {\n    const v3 = new V3({\n      env: \"BROWSERBASE\",\n      disableAPI: true,\n      verbose: 0,\n    });\n\n    await v3.init();\n    await v3.close();\n\n    expect(v3.browserbaseSessionURL).toBeUndefined();\n    expect(v3.browserbaseDebugURL).toBeUndefined();\n  });\n});\n\ndescribe(\"local accessors\", () => {\n  it(\"stay empty for LOCAL environments\", async () => {\n    const v3 = new V3({\n      env: \"LOCAL\",\n      disableAPI: true,\n      verbose: 0,\n      localBrowserLaunchOptions: {\n        cdpUrl: \"ws://local-existing-session\",\n      },\n    });\n\n    try {\n      await v3.init();\n      expect(v3.browserbaseSessionURL).toBeUndefined();\n      expect(v3.browserbaseDebugURL).toBeUndefined();\n    } finally {\n      await v3.close().catch(() => {});\n    }\n  });\n});\n"]}
+{"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\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/cjs/tests/unit/captcha-solver.test.d.ts

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

package/dist/cjs/tests/unit/captcha-solver.test.js

@@ -0,0 +1,154 @@
+"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 SOLVING_STARTED = "browserbase-solving-started";
+const SOLVING_FINISHED = "browserbase-solving-finished";
+const SOLVING_ERRORED = "browserbase-solving-errored";
+class MockPage {
+    listeners = new Set();
+    onCalls = 0;
+    offCalls = 0;
+    on(event, listener) {
+        if (event !== "console")
+            return;
+        this.onCalls++;
+        this.listeners.add(listener);
+    }
+    off(event, listener) {
+        if (event !== "console")
+            return;
+        this.offCalls++;
+        this.listeners.delete(listener);
+    }
+    emitConsole(text) {
+        const message = { text: () => text };
+        for (const listener of this.listeners) {
+            listener(message);
+        }
+    }
+    listenerCount() {
+        return this.listeners.size;
+    }
+}
+(0, vitest_1.describe)("CaptchaSolver", () => {
+    (0, vitest_1.it)("resolves all concurrent waiters when a solve finishes", async () => {
+        const page = new MockPage();
+        const solver = new captchaSolver_js_1.CaptchaSolver();
+        solver.init(async () => page);
+        await solver.ensureAttached();
+        page.emitConsole(SOLVING_STARTED);
+        const firstWait = solver.waitIfSolving();
+        const secondWait = solver.waitIfSolving();
+        await new Promise((resolve) => setTimeout(resolve, 0));
+        const sharedWaitPromise = solver.waitPromise;
+        (0, vitest_1.expect)(sharedWaitPromise).not.toBeNull();
+        (0, vitest_1.expect)(solver.waitPromise).toBe(sharedWaitPromise);
+        let firstResolved = false;
+        let secondResolved = false;
+        void firstWait.then(() => {
+            firstResolved = true;
+        });
+        void secondWait.then(() => {
+            secondResolved = true;
+        });
+        await Promise.resolve();
+        (0, vitest_1.expect)(firstResolved).toBe(false);
+        (0, vitest_1.expect)(secondResolved).toBe(false);
+        page.emitConsole(SOLVING_FINISHED);
+        await Promise.all([firstWait, secondWait]);
+        (0, vitest_1.expect)(firstResolved).toBe(true);
+        (0, vitest_1.expect)(secondResolved).toBe(true);
+        (0, vitest_1.expect)(solver.consumeSolveResult()).toEqual({
+            solved: true,
+            errored: false,
+        });
+        (0, vitest_1.expect)(solver.consumeSolveResult()).toEqual({
+            solved: false,
+            errored: false,
+        });
+    });
+    (0, vitest_1.it)("re-attaches to a new page and settles stale waiters when the active page changes", async () => {
+        const firstPage = new MockPage();
+        const secondPage = new MockPage();
+        let activePage = firstPage;
+        const solver = new captchaSolver_js_1.CaptchaSolver();
+        solver.init(async () => activePage);
+        await solver.ensureAttached();
+        firstPage.emitConsole(SOLVING_STARTED);
+        const pendingWait = solver.waitIfSolving();
+        let settled = false;
+        void pendingWait.then(() => {
+            settled = true;
+        });
+        activePage = secondPage;
+        await solver.waitIfSolving();
+        await pendingWait;
+        (0, vitest_1.expect)(settled).toBe(true);
+        (0, vitest_1.expect)(firstPage.offCalls).toBe(1);
+        (0, vitest_1.expect)(firstPage.listenerCount()).toBe(0);
+        (0, vitest_1.expect)(secondPage.onCalls).toBe(1);
+        (0, vitest_1.expect)(secondPage.listenerCount()).toBe(1);
+        (0, vitest_1.expect)(solver.isSolving()).toBe(false);
+    });
+    (0, vitest_1.it)("surfaces solver errors exactly once per consume", async () => {
+        const page = new MockPage();
+        const solver = new captchaSolver_js_1.CaptchaSolver();
+        solver.init(async () => page);
+        await solver.ensureAttached();
+        page.emitConsole(SOLVING_STARTED);
+        const wait = solver.waitIfSolving();
+        page.emitConsole(SOLVING_ERRORED);
+        await wait;
+        (0, vitest_1.expect)(solver.consumeSolveResult()).toEqual({
+            solved: false,
+            errored: true,
+        });
+        (0, vitest_1.expect)(solver.consumeSolveResult()).toEqual({
+            solved: false,
+            errored: false,
+        });
+    });
+    (0, vitest_1.it)("disposes cleanly while a solve is in progress", async () => {
+        const page = new MockPage();
+        const solver = new captchaSolver_js_1.CaptchaSolver();
+        solver.init(async () => page);
+        await solver.ensureAttached();
+        page.emitConsole(SOLVING_STARTED);
+        const wait = solver.waitIfSolving();
+        await new Promise((resolve) => setTimeout(resolve, 0));
+        let settled = false;
+        void wait.then(() => {
+            settled = true;
+        });
+        solver.dispose();
+        await wait;
+        (0, vitest_1.expect)(settled).toBe(true);
+        (0, vitest_1.expect)(solver.isSolving()).toBe(false);
+        (0, vitest_1.expect)(page.listenerCount()).toBe(0);
+        (0, vitest_1.expect)(solver.consumeSolveResult()).toEqual({
+            solved: false,
+            errored: false,
+        });
+    });
+    (0, vitest_1.it)("marks errored when detached mid-solve due to page change", async () => {
+        const firstPage = new MockPage();
+        const secondPage = new MockPage();
+        let activePage = firstPage;
+        const solver = new captchaSolver_js_1.CaptchaSolver();
+        solver.init(async () => activePage);
+        await solver.ensureAttached();
+        firstPage.emitConsole(SOLVING_STARTED);
+        const wait = solver.waitIfSolving();
+        // Switch to a new page while the solve is in progress
+        activePage = secondPage;
+        await solver.waitIfSolving();
+        await wait;
+        // The interrupted solve should be reported as errored
+        (0, vitest_1.expect)(solver.consumeSolveResult()).toEqual({
+            solved: false,
+            errored: true,
+        });
+    });
+});
+//# sourceMappingURL=captcha-solver.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"captcha-solver.test.js","sourceRoot":"","sources":["../../../../tests/unit/captcha-solver.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { CaptchaSolver } from \"../../lib/v3/agent/utils/captchaSolver.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 onCalls = 0;\n  public offCalls = 0;\n\n  on(event: string, listener: ConsoleListener): void {\n    if (event !== \"console\") return;\n    this.onCalls++;\n    this.listeners.add(listener);\n  }\n\n  off(event: string, listener: ConsoleListener): void {\n    if (event !== \"console\") return;\n    this.offCalls++;\n    this.listeners.delete(listener);\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  listenerCount(): number {\n    return this.listeners.size;\n  }\n}\n\ndescribe(\"CaptchaSolver\", () => {\n  it(\"resolves all concurrent waiters when a solve finishes\", async () => {\n    const page = new MockPage();\n    const solver = new CaptchaSolver();\n    solver.init(async () => page as never);\n\n    await solver.ensureAttached();\n    page.emitConsole(SOLVING_STARTED);\n\n    const firstWait = solver.waitIfSolving();\n    const secondWait = solver.waitIfSolving();\n    await new Promise((resolve) => setTimeout(resolve, 0));\n\n    const sharedWaitPromise = (\n      solver as unknown as { waitPromise: Promise<void> | null }\n    ).waitPromise;\n\n    expect(sharedWaitPromise).not.toBeNull();\n    expect(\n      (solver as unknown as { waitPromise: Promise<void> | null }).waitPromise,\n    ).toBe(sharedWaitPromise);\n\n    let firstResolved = false;\n    let secondResolved = false;\n    void firstWait.then(() => {\n      firstResolved = true;\n    });\n    void secondWait.then(() => {\n      secondResolved = true;\n    });\n\n    await Promise.resolve();\n    expect(firstResolved).toBe(false);\n    expect(secondResolved).toBe(false);\n\n    page.emitConsole(SOLVING_FINISHED);\n    await Promise.all([firstWait, secondWait]);\n\n    expect(firstResolved).toBe(true);\n    expect(secondResolved).toBe(true);\n    expect(solver.consumeSolveResult()).toEqual({\n      solved: true,\n      errored: false,\n    });\n    expect(solver.consumeSolveResult()).toEqual({\n      solved: false,\n      errored: false,\n    });\n  });\n\n  it(\"re-attaches to a new page and settles stale waiters when the active page changes\", async () => {\n    const firstPage = new MockPage();\n    const secondPage = new MockPage();\n    let activePage = firstPage;\n\n    const solver = new CaptchaSolver();\n    solver.init(async () => activePage as never);\n\n    await solver.ensureAttached();\n    firstPage.emitConsole(SOLVING_STARTED);\n\n    const pendingWait = solver.waitIfSolving();\n    let settled = false;\n    void pendingWait.then(() => {\n      settled = true;\n    });\n\n    activePage = secondPage;\n    await solver.waitIfSolving();\n    await pendingWait;\n\n    expect(settled).toBe(true);\n    expect(firstPage.offCalls).toBe(1);\n    expect(firstPage.listenerCount()).toBe(0);\n    expect(secondPage.onCalls).toBe(1);\n    expect(secondPage.listenerCount()).toBe(1);\n    expect(solver.isSolving()).toBe(false);\n  });\n\n  it(\"surfaces solver errors exactly once per consume\", async () => {\n    const page = new MockPage();\n    const solver = new CaptchaSolver();\n    solver.init(async () => page as never);\n\n    await solver.ensureAttached();\n    page.emitConsole(SOLVING_STARTED);\n\n    const wait = solver.waitIfSolving();\n    page.emitConsole(SOLVING_ERRORED);\n    await wait;\n\n    expect(solver.consumeSolveResult()).toEqual({\n      solved: false,\n      errored: true,\n    });\n    expect(solver.consumeSolveResult()).toEqual({\n      solved: false,\n      errored: false,\n    });\n  });\n\n  it(\"disposes cleanly while a solve is in progress\", async () => {\n    const page = new MockPage();\n    const solver = new CaptchaSolver();\n    solver.init(async () => page as never);\n\n    await solver.ensureAttached();\n    page.emitConsole(SOLVING_STARTED);\n\n    const wait = solver.waitIfSolving();\n    await new Promise((resolve) => setTimeout(resolve, 0));\n    let settled = false;\n    void wait.then(() => {\n      settled = true;\n    });\n\n    solver.dispose();\n    await wait;\n\n    expect(settled).toBe(true);\n    expect(solver.isSolving()).toBe(false);\n    expect(page.listenerCount()).toBe(0);\n    expect(solver.consumeSolveResult()).toEqual({\n      solved: false,\n      errored: false,\n    });\n  });\n\n  it(\"marks errored when detached mid-solve due to page change\", async () => {\n    const firstPage = new MockPage();\n    const secondPage = new MockPage();\n    let activePage = firstPage;\n\n    const solver = new CaptchaSolver();\n    solver.init(async () => activePage as never);\n\n    await solver.ensureAttached();\n    firstPage.emitConsole(SOLVING_STARTED);\n\n    const wait = solver.waitIfSolving();\n\n    // Switch to a new page while the solve is in progress\n    activePage = secondPage;\n    await solver.waitIfSolving();\n    await wait;\n\n    // The interrupted solve should be reported as errored\n    expect(solver.consumeSolveResult()).toEqual({\n      solved: false,\n      errored: true,\n    });\n  });\n});\n"]}

package/dist/cjs/tests/unit/flowlogger-capturing-cdp.test.d.ts

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