@browserbasehq/orca 3.2.0-preview.4 → 3.2.1-preview.0

package/dist/esm/tests/unit/agent-system-prompt-variables.test.js

@@ -0,0 +1,21 @@
+import { describe, expect, it } from "vitest";
+import { buildAgentSystemPrompt } from "../../lib/v3/agent/prompts/agentSystemPrompt.js";
+describe("buildAgentSystemPrompt variables", () => {
+    it("includes variable descriptions when present", () => {
+        const prompt = buildAgentSystemPrompt({
+            url: "https://example.com",
+            executionInstruction: "Fill the form",
+            mode: "dom",
+            variables: {
+                username: {
+                    value: "john@example.com",
+                    description: "The login email",
+                },
+                password: "secret123",
+            },
+        });
+        expect(prompt).toContain('<variable name="username">The login email</variable>');
+        expect(prompt).toContain('<variable name="password" />');
+    });
+});
+//# sourceMappingURL=agent-system-prompt-variables.test.js.map

package/dist/esm/tests/unit/agent-system-prompt-variables.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-system-prompt-variables.test.js","sourceRoot":"","sources":["../../../../tests/unit/agent-system-prompt-variables.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,iDAAiD,CAAC;AAEzF,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAChD,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,sBAAsB,CAAC;YACpC,GAAG,EAAE,qBAAqB;YAC1B,oBAAoB,EAAE,eAAe;YACrC,IAAI,EAAE,KAAK;YACX,SAAS,EAAE;gBACT,QAAQ,EAAE;oBACR,KAAK,EAAE,kBAAkB;oBACzB,WAAW,EAAE,iBAAiB;iBAC/B;gBACD,QAAQ,EAAE,WAAW;aACtB;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CACtB,sDAAsD,CACvD,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { buildAgentSystemPrompt } from \"../../lib/v3/agent/prompts/agentSystemPrompt.js\";\n\ndescribe(\"buildAgentSystemPrompt variables\", () => {\n  it(\"includes variable descriptions when present\", () => {\n    const prompt = buildAgentSystemPrompt({\n      url: \"https://example.com\",\n      executionInstruction: \"Fill the form\",\n      mode: \"dom\",\n      variables: {\n        username: {\n          value: \"john@example.com\",\n          description: \"The login email\",\n        },\n        password: \"secret123\",\n      },\n    });\n\n    expect(prompt).toContain(\n      '<variable name=\"username\">The login email</variable>',\n    );\n    expect(prompt).toContain('<variable name=\"password\" />');\n  });\n});\n"]}

package/dist/esm/tests/unit/aisdk-clients.test.d.ts

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

package/dist/esm/tests/unit/aisdk-clients.test.js

@@ -0,0 +1,88 @@
+import { generateObject } from "ai";
+import { z } from "zod";
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { AISdkClient } from "../../lib/v3/llm/aisdk.js";
+vi.mock("ai", async () => {
+    const actual = await vi.importActual("ai");
+    return {
+        ...actual,
+        generateObject: vi.fn(),
+    };
+});
+const mockGenerateObject = vi.mocked(generateObject);
+function createModel(modelId) {
+    return {
+        modelId,
+        specificationVersion: "v2",
+    };
+}
+describe("AISdkClient structured output provider options", () => {
+    beforeEach(() => {
+        mockGenerateObject.mockReset();
+        mockGenerateObject.mockResolvedValue({
+            object: { ok: true },
+            usage: {
+                inputTokens: 1,
+                outputTokens: 2,
+                reasoningTokens: 0,
+                cachedInputTokens: 0,
+                totalTokens: 3,
+            },
+        });
+    });
+    it.each([
+        ["openai/gpt-4.1", { openai: { strictJsonSchema: true } }],
+        ["azure/gpt-4.1", { azure: { strictJsonSchema: true } }],
+        ["google/gemini-2.5-pro", { google: { structuredOutputs: true } }],
+        ["vertex/gemini-2.5-pro", { vertex: { structuredOutputs: true } }],
+        [
+            "anthropic/claude-sonnet-4-20250514",
+            { anthropic: { structuredOutputMode: "auto" } },
+        ],
+        ["groq/llama-3.3-70b-versatile", { groq: { structuredOutputs: true } }],
+        ["cerebras/llama-4-scout", { cerebras: { strictJsonSchema: true } }],
+        [
+            "mistral/mistral-large-latest",
+            { mistral: { structuredOutputs: true, strictJsonSchema: true } },
+        ],
+    ])("passes provider structured-output options for %s", async (modelId, providerOptions) => {
+        const client = new AISdkClient({
+            model: createModel(modelId),
+            logger: vi.fn(),
+        });
+        await client.createChatCompletion({
+            options: {
+                messages: [{ role: "user", content: "hello" }],
+                response_model: {
+                    name: "test",
+                    schema: z.object({ ok: z.boolean() }),
+                },
+            },
+            logger: vi.fn(),
+        });
+        expect(mockGenerateObject).toHaveBeenCalledWith(expect.objectContaining({
+            providerOptions,
+        }));
+    });
+    it("omits temperature for claude-opus-4-7 structured calls", async () => {
+        const client = new AISdkClient({
+            model: createModel("anthropic/claude-opus-4-7"),
+            logger: vi.fn(),
+        });
+        await client.createChatCompletion({
+            options: {
+                messages: [{ role: "user", content: "hello" }],
+                response_model: {
+                    name: "test",
+                    schema: z.object({ ok: z.boolean() }),
+                },
+                temperature: 0.1,
+            },
+            logger: vi.fn(),
+        });
+        expect(mockGenerateObject).toHaveBeenCalledWith(expect.objectContaining({
+            temperature: undefined,
+        }));
+    });
+});
+//# sourceMappingURL=aisdk-clients.test.js.map

package/dist/esm/tests/unit/aisdk-clients.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aisdk-clients.test.js","sourceRoot":"","sources":["../../../../tests/unit/aisdk-clients.test.ts"],"names":[],"mappings":"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","sourcesContent":["import type { LanguageModelV2 } from \"@ai-sdk/provider\";\nimport { generateObject } from \"ai\";\nimport { z } from \"zod\";\nimport { beforeEach, describe, expect, it, vi } from \"vitest\";\nimport { AISdkClient } from \"../../lib/v3/llm/aisdk.js\";\n\nvi.mock(\"ai\", async () => {\n  const actual = await vi.importActual<typeof import(\"ai\")>(\"ai\");\n  return {\n    ...actual,\n    generateObject: vi.fn(),\n  };\n});\n\nconst mockGenerateObject = vi.mocked(generateObject);\n\nfunction createModel(modelId: string) {\n  return {\n    modelId,\n    specificationVersion: \"v2\",\n  } as unknown as LanguageModelV2;\n}\n\ndescribe(\"AISdkClient structured output provider options\", () => {\n  beforeEach(() => {\n    mockGenerateObject.mockReset();\n    mockGenerateObject.mockResolvedValue({\n      object: { ok: true },\n      usage: {\n        inputTokens: 1,\n        outputTokens: 2,\n        reasoningTokens: 0,\n        cachedInputTokens: 0,\n        totalTokens: 3,\n      },\n    } as never);\n  });\n\n  it.each([\n    [\"openai/gpt-4.1\", { openai: { strictJsonSchema: true } }],\n    [\"azure/gpt-4.1\", { azure: { strictJsonSchema: true } }],\n    [\"google/gemini-2.5-pro\", { google: { structuredOutputs: true } }],\n    [\"vertex/gemini-2.5-pro\", { vertex: { structuredOutputs: true } }],\n    [\n      \"anthropic/claude-sonnet-4-20250514\",\n      { anthropic: { structuredOutputMode: \"auto\" } },\n    ],\n    [\"groq/llama-3.3-70b-versatile\", { groq: { structuredOutputs: true } }],\n    [\"cerebras/llama-4-scout\", { cerebras: { strictJsonSchema: true } }],\n    [\n      \"mistral/mistral-large-latest\",\n      { mistral: { structuredOutputs: true, strictJsonSchema: true } },\n    ],\n  ])(\n    \"passes provider structured-output options for %s\",\n    async (modelId, providerOptions) => {\n      const client = new AISdkClient({\n        model: createModel(modelId),\n        logger: vi.fn(),\n      });\n\n      await client.createChatCompletion({\n        options: {\n          messages: [{ role: \"user\", content: \"hello\" }],\n          response_model: {\n            name: \"test\",\n            schema: z.object({ ok: z.boolean() }),\n          },\n        },\n        logger: vi.fn(),\n      });\n\n      expect(mockGenerateObject).toHaveBeenCalledWith(\n        expect.objectContaining({\n          providerOptions,\n        }),\n      );\n    },\n  );\n\n  it(\"omits temperature for claude-opus-4-7 structured calls\", async () => {\n    const client = new AISdkClient({\n      model: createModel(\"anthropic/claude-opus-4-7\"),\n      logger: vi.fn(),\n    });\n\n    await client.createChatCompletion({\n      options: {\n        messages: [{ role: \"user\", content: \"hello\" }],\n        response_model: {\n          name: \"test\",\n          schema: z.object({ ok: z.boolean() }),\n        },\n        temperature: 0.1,\n      },\n      logger: vi.fn(),\n    });\n\n    expect(mockGenerateObject).toHaveBeenCalledWith(\n      expect.objectContaining({\n        temperature: undefined,\n      }),\n    );\n  });\n});\n"]}

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

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

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-client-observe-variables.test.d.ts

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

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

@@ -0,0 +1,84 @@
+import { describe, expect, it, vi } from "vitest";
+import { StagehandAPIClient } from "../../lib/v3/api.js";
+describe("StagehandAPIClient variable serialization", () => {
+    it("preserves rich variables when sending the act request", async () => {
+        const client = new StagehandAPIClient({
+            apiKey: "bb-test",
+            logger: vi.fn(),
+        });
+        const executeMock = 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",
+                },
+            },
+        });
+        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,
+        });
+    });
+    it("preserves rich variables when sending the observe request", async () => {
+        const client = new StagehandAPIClient({
+            apiKey: "bb-test",
+            logger: vi.fn(),
+        });
+        const executeMock = 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",
+                },
+            },
+        });
+        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/esm/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,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,QAAQ,CAAC,2CAA2C,EAAE,GAAG,EAAE;IACzD,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC;YACpC,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE;SAChB,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,EAAE,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,MAAM,CAAC,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,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC;YACpC,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE;SAChB,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,EAAE,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,MAAM,CAAC,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/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