@browserbasehq/orca 3.2.0-preview.5 → 3.2.1-preview.1

package/dist/esm/tests/unit/anthropic-cua-adaptive-thinking.test.js

@@ -0,0 +1,245 @@
+import { describe, expect, it, vi, beforeEach } from "vitest";
+import { AnthropicCUAClient } from "../../lib/v3/agent/AnthropicCUAClient.js";
+import Anthropic from "@anthropic-ai/sdk";
+// Mock the Anthropic SDK's beta.messages.create method
+vi.mock("@anthropic-ai/sdk", () => {
+    const mockCreate = vi.fn().mockResolvedValue({
+        id: "test-id",
+        content: [{ type: "text", text: "test response" }],
+        usage: { input_tokens: 10, output_tokens: 20 },
+    });
+    return {
+        default: class MockAnthropic {
+            beta = {
+                messages: {
+                    create: mockCreate,
+                },
+            };
+        },
+    };
+});
+describe("AnthropicCUAClient adaptive thinking", () => {
+    let mockCreate;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        // Get the mock create function from a new instance
+        const anthropic = new Anthropic({ apiKey: "test" });
+        mockCreate = anthropic.beta.messages.create;
+        mockCreate.mockResolvedValue({
+            id: "test-id",
+            content: [{ type: "text", text: "test response" }],
+            usage: { input_tokens: 10, output_tokens: 20 },
+        });
+    });
+    describe("Claude 4.6 models (adaptive thinking)", () => {
+        it("should use thinking.type: 'adaptive' for claude-opus-4-6 when thinkingEffort is set", async () => {
+            const client = new AnthropicCUAClient("anthropic", "claude-opus-4-6", undefined, {
+                apiKey: "test-key",
+                thinkingEffort: "high",
+            });
+            client.setViewport(1280, 720);
+            await client.getAction([{ role: "user", content: "test" }]);
+            expect(mockCreate).toHaveBeenCalledWith(expect.objectContaining({
+                thinking: { type: "adaptive" },
+                output_config: { effort: "high" },
+                temperature: 1,
+            }));
+            // Should NOT have budget_tokens
+            const callArgs = mockCreate.mock.calls[0][0];
+            expect(callArgs.thinking).not.toHaveProperty("budget_tokens");
+        });
+        it("should use thinking.type: 'adaptive' for claude-sonnet-4-6 when thinkingEffort is set", async () => {
+            const client = new AnthropicCUAClient("anthropic", "claude-sonnet-4-6", undefined, {
+                apiKey: "test-key",
+                thinkingEffort: "medium",
+            });
+            client.setViewport(1280, 720);
+            await client.getAction([{ role: "user", content: "test" }]);
+            expect(mockCreate).toHaveBeenCalledWith(expect.objectContaining({
+                thinking: { type: "adaptive" },
+                output_config: { effort: "medium" },
+                temperature: 1,
+            }));
+        });
+        it("should support 'max' effort level for claude-opus-4-6", async () => {
+            const client = new AnthropicCUAClient("anthropic", "claude-opus-4-6", undefined, {
+                apiKey: "test-key",
+                thinkingEffort: "max",
+            });
+            client.setViewport(1280, 720);
+            await client.getAction([{ role: "user", content: "test" }]);
+            expect(mockCreate).toHaveBeenCalledWith(expect.objectContaining({
+                thinking: { type: "adaptive" },
+                output_config: { effort: "max" },
+                temperature: 1,
+            }));
+        });
+        it("should support 'low' effort level", async () => {
+            const client = new AnthropicCUAClient("anthropic", "claude-sonnet-4-6", undefined, {
+                apiKey: "test-key",
+                thinkingEffort: "low",
+            });
+            client.setViewport(1280, 720);
+            await client.getAction([{ role: "user", content: "test" }]);
+            expect(mockCreate).toHaveBeenCalledWith(expect.objectContaining({
+                thinking: { type: "adaptive" },
+                output_config: { effort: "low" },
+                temperature: 1,
+            }));
+        });
+        it("should default to adaptive thinking with 'medium' effort when thinkingEffort is not set for 4.6 models", async () => {
+            const client = new AnthropicCUAClient("anthropic", "claude-opus-4-6", undefined, {
+                apiKey: "test-key",
+            });
+            client.setViewport(1280, 720);
+            await client.getAction([{ role: "user", content: "test" }]);
+            expect(mockCreate).toHaveBeenCalledWith(expect.objectContaining({
+                thinking: { type: "adaptive" },
+                output_config: { effort: "medium" },
+                temperature: 1,
+            }));
+        });
+        it("should set temperature to 1 when adaptive thinking is enabled", async () => {
+            const client = new AnthropicCUAClient("anthropic", "claude-opus-4-6", undefined, {
+                apiKey: "test-key",
+                thinkingEffort: "high",
+            });
+            client.setViewport(1280, 720);
+            await client.getAction([{ role: "user", content: "test" }]);
+            expect(mockCreate).toHaveBeenCalledWith(expect.objectContaining({
+                temperature: 1,
+            }));
+        });
+        it("should set temperature to 1 for claude-sonnet-4-6 with adaptive thinking", async () => {
+            const client = new AnthropicCUAClient("anthropic", "claude-sonnet-4-6", undefined, {
+                apiKey: "test-key",
+                thinkingEffort: "low",
+            });
+            client.setViewport(1280, 720);
+            await client.getAction([{ role: "user", content: "test" }]);
+            expect(mockCreate).toHaveBeenCalledWith(expect.objectContaining({
+                thinking: { type: "adaptive" },
+                output_config: { effort: "low" },
+                temperature: 1,
+            }));
+        });
+        it("should disable adaptive thinking when thinkingEffort is 'none'", async () => {
+            const client = new AnthropicCUAClient("anthropic", "claude-opus-4-6", undefined, {
+                apiKey: "test-key",
+                thinkingEffort: "none",
+            });
+            client.setViewport(1280, 720);
+            await client.getAction([{ role: "user", content: "test" }]);
+            const callArgs = mockCreate.mock.calls[0][0];
+            expect(callArgs.thinking).toBeUndefined();
+            expect(callArgs.output_config).toBeUndefined();
+            expect(callArgs.temperature).toBeUndefined();
+        });
+        it("should log a debug warning when thinkingBudget is set on a 4.6 model", async () => {
+            const logger = vi.fn();
+            const client = new AnthropicCUAClient("anthropic", "claude-opus-4-6", undefined, {
+                apiKey: "test-key",
+                thinkingBudget: 10000,
+            });
+            client.setViewport(1280, 720);
+            await client.getAction([{ role: "user", content: "test" }], logger);
+            expect(logger).toHaveBeenCalledWith(expect.objectContaining({
+                category: "agent",
+                message: expect.stringContaining("thinkingBudget is ignored"),
+                level: 2,
+            }));
+            // Should still use adaptive thinking, not budget_tokens
+            const callArgs = mockCreate.mock.calls[0][0];
+            expect(callArgs.thinking).toEqual({ type: "adaptive" });
+        });
+        it("should log a debug warning when user-specified temperature is overridden", async () => {
+            const logger = vi.fn();
+            const client = new AnthropicCUAClient("anthropic", "claude-opus-4-6", undefined, {
+                apiKey: "test-key",
+                thinkingEffort: "high",
+                temperature: 0.5,
+            });
+            client.setViewport(1280, 720);
+            await client.getAction([{ role: "user", content: "test" }], logger);
+            expect(logger).toHaveBeenCalledWith(expect.objectContaining({
+                category: "agent",
+                message: expect.stringContaining("overriding user-specified temperature=0.5"),
+                level: 2,
+            }));
+            // Temperature should still be forced to 1
+            const callArgs = mockCreate.mock.calls[0][0];
+            expect(callArgs.temperature).toBe(1);
+        });
+    });
+    describe("older Claude models (budget_tokens - deprecated)", () => {
+        it("should use thinking.type: 'enabled' with budget_tokens for claude-sonnet-4-5 when thinkingBudget is set", async () => {
+            const client = new AnthropicCUAClient("anthropic", "claude-sonnet-4-5-20250929", undefined, {
+                apiKey: "test-key",
+                thinkingBudget: 8000,
+            });
+            client.setViewport(1280, 720);
+            await client.getAction([{ role: "user", content: "test" }]);
+            expect(mockCreate).toHaveBeenCalledWith(expect.objectContaining({
+                thinking: { type: "enabled", budget_tokens: 8000 },
+            }));
+            // Should NOT have output_config for older models
+            const callArgs = mockCreate.mock.calls[0][0];
+            expect(callArgs.output_config).toBeUndefined();
+        });
+        it("should use thinking.type: 'enabled' with budget_tokens for claude-opus-4-5 when thinkingBudget is set", async () => {
+            const client = new AnthropicCUAClient("anthropic", "claude-opus-4-5-20251101", undefined, {
+                apiKey: "test-key",
+                thinkingBudget: 10000,
+            });
+            client.setViewport(1280, 720);
+            await client.getAction([{ role: "user", content: "test" }]);
+            expect(mockCreate).toHaveBeenCalledWith(expect.objectContaining({
+                thinking: { type: "enabled", budget_tokens: 10000 },
+            }));
+        });
+        it("should NOT force temperature to 1 for older models with budget_tokens", async () => {
+            const client = new AnthropicCUAClient("anthropic", "claude-sonnet-4-5-20250929", undefined, {
+                apiKey: "test-key",
+                thinkingBudget: 8000,
+            });
+            client.setViewport(1280, 720);
+            await client.getAction([{ role: "user", content: "test" }]);
+            const callArgs = mockCreate.mock.calls[0][0];
+            // Temperature should not be explicitly set to 1 for older models
+            expect(callArgs.temperature).toBeUndefined();
+        });
+    });
+    describe("model detection", () => {
+        it("should detect claude-opus-4-6 as a 4.6 model", async () => {
+            const client = new AnthropicCUAClient("anthropic", "claude-opus-4-6", undefined, {
+                apiKey: "test-key",
+                thinkingEffort: "high",
+            });
+            client.setViewport(1280, 720);
+            await client.getAction([{ role: "user", content: "test" }]);
+            const callArgs = mockCreate.mock.calls[0][0];
+            expect(callArgs.thinking.type).toBe("adaptive");
+        });
+        it("should detect claude-sonnet-4-6 as a 4.6 model", async () => {
+            const client = new AnthropicCUAClient("anthropic", "claude-sonnet-4-6", undefined, {
+                apiKey: "test-key",
+                thinkingEffort: "high",
+            });
+            client.setViewport(1280, 720);
+            await client.getAction([{ role: "user", content: "test" }]);
+            const callArgs = mockCreate.mock.calls[0][0];
+            expect(callArgs.thinking.type).toBe("adaptive");
+        });
+        it("should handle provider-prefixed model names (anthropic/claude-opus-4-6)", async () => {
+            const client = new AnthropicCUAClient("anthropic", "anthropic/claude-opus-4-6", undefined, {
+                apiKey: "test-key",
+                thinkingEffort: "high",
+            });
+            client.setViewport(1280, 720);
+            await client.getAction([{ role: "user", content: "test" }]);
+            const callArgs = mockCreate.mock.calls[0][0];
+            expect(callArgs.thinking.type).toBe("adaptive");
+        });
+    });
+});
+//# sourceMappingURL=anthropic-cua-adaptive-thinking.test.js.map

package/dist/esm/tests/unit/anthropic-cua-adaptive-thinking.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-cua-adaptive-thinking.test.js","sourceRoot":"","sources":["../../../../tests/unit/anthropic-cua-adaptive-thinking.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it, vi, beforeEach } from \"vitest\";\nimport { AnthropicCUAClient } from \"../../lib/v3/agent/AnthropicCUAClient.js\";\nimport Anthropic from \"@anthropic-ai/sdk\";\n\n// Mock the Anthropic SDK's beta.messages.create method\nvi.mock(\"@anthropic-ai/sdk\", () => {\n  const mockCreate = vi.fn().mockResolvedValue({\n    id: \"test-id\",\n    content: [{ type: \"text\", text: \"test response\" }],\n    usage: { input_tokens: 10, output_tokens: 20 },\n  });\n\n  return {\n    default: class MockAnthropic {\n      beta = {\n        messages: {\n          create: mockCreate,\n        },\n      };\n    },\n  };\n});\n\ndescribe(\"AnthropicCUAClient adaptive thinking\", () => {\n  let mockCreate: ReturnType<typeof vi.fn>;\n\n  beforeEach(() => {\n    vi.clearAllMocks();\n    // Get the mock create function from a new instance\n    const anthropic = new Anthropic({ apiKey: \"test\" });\n    mockCreate = anthropic.beta.messages.create as ReturnType<typeof vi.fn>;\n    mockCreate.mockResolvedValue({\n      id: \"test-id\",\n      content: [{ type: \"text\", text: \"test response\" }],\n      usage: { input_tokens: 10, output_tokens: 20 },\n    });\n  });\n\n  describe(\"Claude 4.6 models (adaptive thinking)\", () => {\n    it(\"should use thinking.type: 'adaptive' for claude-opus-4-6 when thinkingEffort is set\", async () => {\n      const client = new AnthropicCUAClient(\n        \"anthropic\",\n        \"claude-opus-4-6\",\n        undefined,\n        {\n          apiKey: \"test-key\",\n          thinkingEffort: \"high\",\n        },\n      );\n      client.setViewport(1280, 720);\n\n      await client.getAction([{ role: \"user\", content: \"test\" }]);\n\n      expect(mockCreate).toHaveBeenCalledWith(\n        expect.objectContaining({\n          thinking: { type: \"adaptive\" },\n          output_config: { effort: \"high\" },\n          temperature: 1,\n        }),\n      );\n\n      // Should NOT have budget_tokens\n      const callArgs = mockCreate.mock.calls[0][0];\n      expect(callArgs.thinking).not.toHaveProperty(\"budget_tokens\");\n    });\n\n    it(\"should use thinking.type: 'adaptive' for claude-sonnet-4-6 when thinkingEffort is set\", async () => {\n      const client = new AnthropicCUAClient(\n        \"anthropic\",\n        \"claude-sonnet-4-6\",\n        undefined,\n        {\n          apiKey: \"test-key\",\n          thinkingEffort: \"medium\",\n        },\n      );\n      client.setViewport(1280, 720);\n\n      await client.getAction([{ role: \"user\", content: \"test\" }]);\n\n      expect(mockCreate).toHaveBeenCalledWith(\n        expect.objectContaining({\n          thinking: { type: \"adaptive\" },\n          output_config: { effort: \"medium\" },\n          temperature: 1,\n        }),\n      );\n    });\n\n    it(\"should support 'max' effort level for claude-opus-4-6\", async () => {\n      const client = new AnthropicCUAClient(\n        \"anthropic\",\n        \"claude-opus-4-6\",\n        undefined,\n        {\n          apiKey: \"test-key\",\n          thinkingEffort: \"max\",\n        },\n      );\n      client.setViewport(1280, 720);\n\n      await client.getAction([{ role: \"user\", content: \"test\" }]);\n\n      expect(mockCreate).toHaveBeenCalledWith(\n        expect.objectContaining({\n          thinking: { type: \"adaptive\" },\n          output_config: { effort: \"max\" },\n          temperature: 1,\n        }),\n      );\n    });\n\n    it(\"should support 'low' effort level\", async () => {\n      const client = new AnthropicCUAClient(\n        \"anthropic\",\n        \"claude-sonnet-4-6\",\n        undefined,\n        {\n          apiKey: \"test-key\",\n          thinkingEffort: \"low\",\n        },\n      );\n      client.setViewport(1280, 720);\n\n      await client.getAction([{ role: \"user\", content: \"test\" }]);\n\n      expect(mockCreate).toHaveBeenCalledWith(\n        expect.objectContaining({\n          thinking: { type: \"adaptive\" },\n          output_config: { effort: \"low\" },\n          temperature: 1,\n        }),\n      );\n    });\n\n    it(\"should default to adaptive thinking with 'medium' effort when thinkingEffort is not set for 4.6 models\", async () => {\n      const client = new AnthropicCUAClient(\n        \"anthropic\",\n        \"claude-opus-4-6\",\n        undefined,\n        {\n          apiKey: \"test-key\",\n        },\n      );\n      client.setViewport(1280, 720);\n\n      await client.getAction([{ role: \"user\", content: \"test\" }]);\n\n      expect(mockCreate).toHaveBeenCalledWith(\n        expect.objectContaining({\n          thinking: { type: \"adaptive\" },\n          output_config: { effort: \"medium\" },\n          temperature: 1,\n        }),\n      );\n    });\n\n    it(\"should set temperature to 1 when adaptive thinking is enabled\", async () => {\n      const client = new AnthropicCUAClient(\n        \"anthropic\",\n        \"claude-opus-4-6\",\n        undefined,\n        {\n          apiKey: \"test-key\",\n          thinkingEffort: \"high\",\n        },\n      );\n      client.setViewport(1280, 720);\n\n      await client.getAction([{ role: \"user\", content: \"test\" }]);\n\n      expect(mockCreate).toHaveBeenCalledWith(\n        expect.objectContaining({\n          temperature: 1,\n        }),\n      );\n    });\n\n    it(\"should set temperature to 1 for claude-sonnet-4-6 with adaptive thinking\", async () => {\n      const client = new AnthropicCUAClient(\n        \"anthropic\",\n        \"claude-sonnet-4-6\",\n        undefined,\n        {\n          apiKey: \"test-key\",\n          thinkingEffort: \"low\",\n        },\n      );\n      client.setViewport(1280, 720);\n\n      await client.getAction([{ role: \"user\", content: \"test\" }]);\n\n      expect(mockCreate).toHaveBeenCalledWith(\n        expect.objectContaining({\n          thinking: { type: \"adaptive\" },\n          output_config: { effort: \"low\" },\n          temperature: 1,\n        }),\n      );\n    });\n\n    it(\"should disable adaptive thinking when thinkingEffort is 'none'\", async () => {\n      const client = new AnthropicCUAClient(\n        \"anthropic\",\n        \"claude-opus-4-6\",\n        undefined,\n        {\n          apiKey: \"test-key\",\n          thinkingEffort: \"none\",\n        },\n      );\n      client.setViewport(1280, 720);\n\n      await client.getAction([{ role: \"user\", content: \"test\" }]);\n\n      const callArgs = mockCreate.mock.calls[0][0];\n      expect(callArgs.thinking).toBeUndefined();\n      expect(callArgs.output_config).toBeUndefined();\n      expect(callArgs.temperature).toBeUndefined();\n    });\n\n    it(\"should log a debug warning when thinkingBudget is set on a 4.6 model\", async () => {\n      const logger = vi.fn();\n\n      const client = new AnthropicCUAClient(\n        \"anthropic\",\n        \"claude-opus-4-6\",\n        undefined,\n        {\n          apiKey: \"test-key\",\n          thinkingBudget: 10000,\n        },\n      );\n      client.setViewport(1280, 720);\n\n      await client.getAction([{ role: \"user\", content: \"test\" }], logger);\n\n      expect(logger).toHaveBeenCalledWith(\n        expect.objectContaining({\n          category: \"agent\",\n          message: expect.stringContaining(\"thinkingBudget is ignored\"),\n          level: 2,\n        }),\n      );\n\n      // Should still use adaptive thinking, not budget_tokens\n      const callArgs = mockCreate.mock.calls[0][0];\n      expect(callArgs.thinking).toEqual({ type: \"adaptive\" });\n    });\n\n    it(\"should log a debug warning when user-specified temperature is overridden\", async () => {\n      const logger = vi.fn();\n\n      const client = new AnthropicCUAClient(\n        \"anthropic\",\n        \"claude-opus-4-6\",\n        undefined,\n        {\n          apiKey: \"test-key\",\n          thinkingEffort: \"high\",\n          temperature: 0.5,\n        },\n      );\n      client.setViewport(1280, 720);\n\n      await client.getAction([{ role: \"user\", content: \"test\" }], logger);\n\n      expect(logger).toHaveBeenCalledWith(\n        expect.objectContaining({\n          category: \"agent\",\n          message: expect.stringContaining(\n            \"overriding user-specified temperature=0.5\",\n          ),\n          level: 2,\n        }),\n      );\n\n      // Temperature should still be forced to 1\n      const callArgs = mockCreate.mock.calls[0][0];\n      expect(callArgs.temperature).toBe(1);\n    });\n  });\n\n  describe(\"older Claude models (budget_tokens - deprecated)\", () => {\n    it(\"should use thinking.type: 'enabled' with budget_tokens for claude-sonnet-4-5 when thinkingBudget is set\", async () => {\n      const client = new AnthropicCUAClient(\n        \"anthropic\",\n        \"claude-sonnet-4-5-20250929\",\n        undefined,\n        {\n          apiKey: \"test-key\",\n          thinkingBudget: 8000,\n        },\n      );\n      client.setViewport(1280, 720);\n\n      await client.getAction([{ role: \"user\", content: \"test\" }]);\n\n      expect(mockCreate).toHaveBeenCalledWith(\n        expect.objectContaining({\n          thinking: { type: \"enabled\", budget_tokens: 8000 },\n        }),\n      );\n\n      // Should NOT have output_config for older models\n      const callArgs = mockCreate.mock.calls[0][0];\n      expect(callArgs.output_config).toBeUndefined();\n    });\n\n    it(\"should use thinking.type: 'enabled' with budget_tokens for claude-opus-4-5 when thinkingBudget is set\", async () => {\n      const client = new AnthropicCUAClient(\n        \"anthropic\",\n        \"claude-opus-4-5-20251101\",\n        undefined,\n        {\n          apiKey: \"test-key\",\n          thinkingBudget: 10000,\n        },\n      );\n      client.setViewport(1280, 720);\n\n      await client.getAction([{ role: \"user\", content: \"test\" }]);\n\n      expect(mockCreate).toHaveBeenCalledWith(\n        expect.objectContaining({\n          thinking: { type: \"enabled\", budget_tokens: 10000 },\n        }),\n      );\n    });\n\n    it(\"should NOT force temperature to 1 for older models with budget_tokens\", async () => {\n      const client = new AnthropicCUAClient(\n        \"anthropic\",\n        \"claude-sonnet-4-5-20250929\",\n        undefined,\n        {\n          apiKey: \"test-key\",\n          thinkingBudget: 8000,\n        },\n      );\n      client.setViewport(1280, 720);\n\n      await client.getAction([{ role: \"user\", content: \"test\" }]);\n\n      const callArgs = mockCreate.mock.calls[0][0];\n      // Temperature should not be explicitly set to 1 for older models\n      expect(callArgs.temperature).toBeUndefined();\n    });\n  });\n\n  describe(\"model detection\", () => {\n    it(\"should detect claude-opus-4-6 as a 4.6 model\", async () => {\n      const client = new AnthropicCUAClient(\n        \"anthropic\",\n        \"claude-opus-4-6\",\n        undefined,\n        {\n          apiKey: \"test-key\",\n          thinkingEffort: \"high\",\n        },\n      );\n      client.setViewport(1280, 720);\n\n      await client.getAction([{ role: \"user\", content: \"test\" }]);\n\n      const callArgs = mockCreate.mock.calls[0][0];\n      expect(callArgs.thinking.type).toBe(\"adaptive\");\n    });\n\n    it(\"should detect claude-sonnet-4-6 as a 4.6 model\", async () => {\n      const client = new AnthropicCUAClient(\n        \"anthropic\",\n        \"claude-sonnet-4-6\",\n        undefined,\n        {\n          apiKey: \"test-key\",\n          thinkingEffort: \"high\",\n        },\n      );\n      client.setViewport(1280, 720);\n\n      await client.getAction([{ role: \"user\", content: \"test\" }]);\n\n      const callArgs = mockCreate.mock.calls[0][0];\n      expect(callArgs.thinking.type).toBe(\"adaptive\");\n    });\n\n    it(\"should handle provider-prefixed model names (anthropic/claude-opus-4-6)\", async () => {\n      const client = new AnthropicCUAClient(\n        \"anthropic\",\n        \"anthropic/claude-opus-4-6\",\n        undefined,\n        {\n          apiKey: \"test-key\",\n          thinkingEffort: \"high\",\n        },\n      );\n      client.setViewport(1280, 720);\n\n      await client.getAction([{ role: \"user\", content: \"test\" }]);\n\n      const callArgs = mockCreate.mock.calls[0][0];\n      expect(callArgs.thinking.type).toBe(\"adaptive\");\n    });\n  });\n});\n"]}

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

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

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

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

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

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

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

@@ -96,6 +96,26 @@ describe("browserbase accessors", () => {
             await v3.close().catch(() => { });
         }
     });
+    it("treats verified Browserbase sessions as managed fingerprinting mode", async () => {
+        const v3 = new V3({
+            env: "BROWSERBASE",
+            disableAPI: true,
+            verbose: 0,
+            browserbaseSessionCreateParams: {
+                browserSettings: {
+                    verified: true,
+                },
+            },
+        });
+        try {
+            await v3.init();
+            expect(v3.isVerified).toBe(true);
+            expect(v3.isAdvancedStealth).toBe(true);
+        }
+        finally {
+            await v3.close().catch(() => { });
+        }
+    });
 });
 describe("local accessors", () => {
     it("stay empty for LOCAL environments", async () => {

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

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

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