npm - @browserbasehq/orca - Versions diffs - 3.2.1-preview.2 → 3.4.0-preview-1 - Mend

@browserbasehq/orca 3.2.1-preview.2 → 3.4.0-preview-1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (223) hide show

package/dist/esm/lib/version.d.ts CHANGED Viewed

@@ -2,4 +2,4 @@
  * AUTO-GENERATED — DO NOT EDIT BY HAND
  *  Run `pnpm run gen-version` to refresh.
  */
-export declare const STAGEHAND_VERSION: "3.2.0";
+export declare const STAGEHAND_VERSION: "3.3.0";

package/dist/esm/lib/version.js CHANGED Viewed

@@ -2,5 +2,5 @@
  * AUTO-GENERATED — DO NOT EDIT BY HAND
  *  Run `pnpm run gen-version` to refresh.
  */
-export const STAGEHAND_VERSION = "3.2.0";
+export const STAGEHAND_VERSION = "3.3.0";
 //# sourceMappingURL=version.js.map

package/dist/esm/lib/version.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"version.js","sourceRoot":"","sources":["../../../lib/version.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAgB,CAAC","sourcesContent":["/*\n AUTO-GENERATED — DO NOT EDIT BY HAND\n * Run `pnpm run gen-version` to refresh.\n */\nexport const STAGEHAND_VERSION = \"3.2.0\" as const;\n"]}
1	+ {"version":3,"file":"version.js","sourceRoot":"","sources":["../../../lib/version.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAgB,CAAC","sourcesContent":["/*\n AUTO-GENERATED — DO NOT EDIT BY HAND\n * Run `pnpm run gen-version` to refresh.\n */\nexport const STAGEHAND_VERSION = \"3.3.0\" as const;\n"]}

package/dist/esm/tests/integration/observe-element-id-format.spec.d.ts ADDED Viewed

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

package/dist/esm/tests/integration/observe-element-id-format.spec.js ADDED Viewed

@@ -0,0 +1,128 @@
+import { expect, test } from "@playwright/test";
+import { V3 } from "../../lib/v3/v3.js";
+import { getV3TestConfig } from "./v3.config.js";
+import { closeV3, createScriptedAisdkTestLlmClient, findLastEncodedId, promptToText, } from "./testUtils.js";
+const encodedIdPattern = /^\d+-\d+$/;
+const mainFrameEncodedIdPattern = /^0-\d+$/;
+function encodeHtml(html) {
+    return `data:text/html,${encodeURIComponent(html)}`;
+}
+const filler = Array.from({ length: 80 }, (_, index) => `<span hidden data-filler="${index}">filler ${index}</span>`).join("");
+const cases = [
+    {
+        name: "button after hidden filler nodes",
+        instruction: "Find the Target Checkout button",
+        targetText: "Target Checkout",
+        marker: "checkout",
+        html: `
+      <!doctype html>
+      <html>
+        <body>
+          ${filler}
+          <main>
+            <button onclick="document.body.dataset.clicked = 'checkout'">
+              Target Checkout
+            </button>
+          </main>
+        </body>
+      </html>
+    `,
+    },
+    {
+        name: "navigation link",
+        instruction: "Find the Pricing Plans link",
+        targetText: "Pricing Plans",
+        marker: "pricing",
+        html: `
+      <!doctype html>
+      <html>
+        <body>
+          <nav>
+            <a href="#pricing" onclick="document.body.dataset.clicked = 'pricing'">
+              Pricing Plans
+            </a>
+          </nav>
+        </body>
+      </html>
+    `,
+    },
+    {
+        name: "form input",
+        instruction: "Find the Company Email input",
+        targetText: "Company Email",
+        marker: "email",
+        html: `
+      <!doctype html>
+      <html>
+        <body>
+          <form>
+            <label>
+              Company Email
+              <input
+                type="email"
+                onclick="document.body.dataset.clicked = 'email'"
+              />
+            </label>
+          </form>
+        </body>
+      </html>
+    `,
+    },
+];
+function observeResponseForTarget(testCase, onElementId) {
+    return (options) => {
+        const promptText = promptToText(options.prompt);
+        expect(promptText).toContain("Always copy the complete ID exactly as shown inside the brackets into elementId");
+        expect(promptText).toContain('return elementId "0-18372"');
+        expect(promptText).toContain(testCase.targetText);
+        const elementId = findLastEncodedId(options);
+        expect(elementId).toMatch(encodedIdPattern);
+        expect(elementId).toMatch(mainFrameEncodedIdPattern);
+        onElementId(elementId, options);
+        return {
+            elements: [
+                {
+                    elementId,
+                    description: testCase.targetText,
+                    method: "click",
+                    arguments: [],
+                },
+            ],
+        };
+    };
+}
+test.describe("observe main frame element IDs", () => {
+    for (const testCase of cases) {
+        test(`keeps complete 0-ordinal element IDs for ${testCase.name}`, async () => {
+            let observedElementId;
+            const llmClient = createScriptedAisdkTestLlmClient({
+                modelId: "mock/observe-main-frame-element-id-format",
+                jsonResponses: {
+                    Observation: observeResponseForTarget(testCase, (elementId) => {
+                        observedElementId = elementId;
+                    }),
+                },
+            });
+            const v3 = new V3(getV3TestConfig({
+                llmClient,
+            }));
+            await v3.init();
+            try {
+                const page = v3.context.pages()[0];
+                await page.goto(encodeHtml(testCase.html));
+                const observed = await v3.observe(testCase.instruction);
+                expect(observedElementId).toMatch(mainFrameEncodedIdPattern);
+                expect(observed).toHaveLength(1);
+                expect(observed[0].selector).toMatch(/^xpath=/);
+                const actResult = await v3.act(observed[0]);
+                expect(actResult.success).toBe(true);
+                const clicked = await page.evaluate(() => document.body.dataset.clicked);
+                expect(clicked).toBe(testCase.marker);
+            }
+            finally {
+                await closeV3(v3);
+            }
+        });
+    }
+});
+//# sourceMappingURL=observe-element-id-format.spec.js.map

package/dist/esm/tests/integration/observe-element-id-format.spec.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"observe-element-id-format.spec.js","sourceRoot":"","sources":["../../../../tests/integration/observe-element-id-format.spec.ts"],"names":[],"mappings":"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","sourcesContent":["import { expect, test } from \"@playwright/test\";\nimport type { LanguageModelV2CallOptions } from \"@ai-sdk/provider\";\nimport { V3 } from \"../../lib/v3/v3.js\";\nimport { getV3TestConfig } from \"./v3.config.js\";\nimport {\n closeV3,\n createScriptedAisdkTestLlmClient,\n findLastEncodedId,\n promptToText,\n} from \"./testUtils.js\";\n\nconst encodedIdPattern = /^\\d+-\\d+$/;\nconst mainFrameEncodedIdPattern = /^0-\\d+$/;\n\nfunction encodeHtml(html: string): string {\n return `data:text/html,${encodeURIComponent(html)}`;\n}\n\ntype MainFrameCase = {\n name: string;\n instruction: string;\n targetText: string;\n marker: string;\n html: string;\n};\n\nconst filler = Array.from(\n { length: 80 },\n (_, index) => `<span hidden data-filler=\"${index}\">filler ${index}</span>`,\n).join(\"\");\n\nconst cases: MainFrameCase[] = [\n {\n name: \"button after hidden filler nodes\",\n instruction: \"Find the Target Checkout button\",\n targetText: \"Target Checkout\",\n marker: \"checkout\",\n html: `\n <!doctype html>\n <html>\n <body>\n ${filler}\n <main>\n <button onclick=\"document.body.dataset.clicked = 'checkout'\">\n Target Checkout\n </button>\n </main>\n </body>\n </html>\n `,\n },\n {\n name: \"navigation link\",\n instruction: \"Find the Pricing Plans link\",\n targetText: \"Pricing Plans\",\n marker: \"pricing\",\n html: `\n <!doctype html>\n <html>\n <body>\n <nav>\n <a href=\"#pricing\" onclick=\"document.body.dataset.clicked = 'pricing'\">\n Pricing Plans\n </a>\n </nav>\n </body>\n </html>\n `,\n },\n {\n name: \"form input\",\n instruction: \"Find the Company Email input\",\n targetText: \"Company Email\",\n marker: \"email\",\n html: `\n <!doctype html>\n <html>\n <body>\n <form>\n <label>\n Company Email\n <input\n type=\"email\"\n onclick=\"document.body.dataset.clicked = 'email'\"\n />\n </label>\n </form>\n </body>\n </html>\n `,\n },\n];\n\nfunction observeResponseForTarget(\n testCase: MainFrameCase,\n onElementId: (elementId: string, options: LanguageModelV2CallOptions) => void,\n) {\n return (options: LanguageModelV2CallOptions) => {\n const promptText = promptToText(options.prompt);\n expect(promptText).toContain(\n \"Always copy the complete ID exactly as shown inside the brackets into elementId\",\n );\n expect(promptText).toContain('return elementId \"0-18372\"');\n\n expect(promptText).toContain(testCase.targetText);\n\n const elementId = findLastEncodedId(options);\n expect(elementId).toMatch(encodedIdPattern);\n expect(elementId).toMatch(mainFrameEncodedIdPattern);\n onElementId(elementId, options);\n\n return {\n elements: [\n {\n elementId,\n description: testCase.targetText,\n method: \"click\",\n arguments: [] as string[],\n },\n ],\n };\n };\n}\n\ntest.describe(\"observe main frame element IDs\", () => {\n for (const testCase of cases) {\n test(`keeps complete 0-ordinal element IDs for ${testCase.name}`, async () => {\n let observedElementId: string | undefined;\n const llmClient = createScriptedAisdkTestLlmClient({\n modelId: \"mock/observe-main-frame-element-id-format\",\n jsonResponses: {\n Observation: observeResponseForTarget(testCase, (elementId) => {\n observedElementId = elementId;\n }),\n },\n });\n\n const v3 = new V3(\n getV3TestConfig({\n llmClient,\n }),\n );\n await v3.init();\n\n try {\n const page = v3.context.pages()[0];\n await page.goto(encodeHtml(testCase.html));\n\n const observed = await v3.observe(testCase.instruction);\n\n expect(observedElementId).toMatch(mainFrameEncodedIdPattern);\n expect(observed).toHaveLength(1);\n expect(observed[0].selector).toMatch(/^xpath=/);\n\n const actResult = await v3.act(observed[0]);\n expect(actResult.success).toBe(true);\n\n const clicked = await page.evaluate(\n () => document.body.dataset.clicked,\n );\n expect(clicked).toBe(testCase.marker);\n } finally {\n await closeV3(v3);\n }\n });\n }\n});\n"]}

package/dist/esm/tests/unit/agent-mode-routing.test.d.ts ADDED Viewed

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

package/dist/esm/tests/unit/agent-mode-routing.test.js ADDED Viewed

@@ -0,0 +1,86 @@
+import { describe, expect, it } from "vitest";
+import { extractModelName } from "../../lib/modelUtils.js";
+import { HYBRID_CAPABLE_MODEL_PATTERNS } from "../../lib/v3/types/private/agent.js";
+function resolveDefaultAgentMode(model, fallbackModelName) {
+    const modelName = extractModelName(model) ?? fallbackModelName;
+    const isHybridCapable = HYBRID_CAPABLE_MODEL_PATTERNS.some((pattern) => modelName.includes(pattern));
+    return isHybridCapable ? "hybrid" : "dom";
+}
+function resolveAgentMode(explicitMode, model, fallbackModelName) {
+    return explicitMode ?? resolveDefaultAgentMode(model, fallbackModelName);
+}
+describe("agent mode auto-routing", () => {
+    describe("explicit mode is never overridden", () => {
+        it("respects mode: 'dom' even when model supports hybrid", () => {
+            const result = resolveAgentMode("dom", "anthropic/claude-sonnet-4-20250514", "openai/gpt-4o");
+            expect(result).toBe("dom");
+        });
+        it("respects mode: 'hybrid' even when model does not support hybrid", () => {
+            const result = resolveAgentMode("hybrid", "openai/gpt-4o-mini", "openai/gpt-4o-mini");
+            expect(result).toBe("hybrid");
+        });
+        it("respects mode: 'cua' regardless of model", () => {
+            const result = resolveAgentMode("cua", "anthropic/claude-sonnet-4-20250514", "openai/gpt-4o");
+            expect(result).toBe("cua");
+        });
+    });
+    describe("auto-routes to hybrid for supported models when no mode is set", () => {
+        it.each([
+            ["google/gemini-3-flash-preview", "gemini-3"],
+            ["google/gemini-3-flash", "gemini-3"],
+            ["anthropic/claude-sonnet-4-20250514", "claude"],
+            ["anthropic/claude-haiku-4-5-20251001", "claude"],
+            ["openai/gpt-5.4-turbo", "gpt-5.4"],
+            ["openai/gpt-5.4", "gpt-5.4"],
+        ])("model %s (pattern: %s) → hybrid", (modelName) => {
+            const result = resolveAgentMode(undefined, modelName, "fallback-model");
+            expect(result).toBe("hybrid");
+        });
+    });
+    describe("auto-routes to dom for unsupported models when no mode is set", () => {
+        it.each([
+            "openai/gpt-4o",
+            "openai/gpt-4o-mini",
+            "openai/gpt-4.1-mini",
+            "google/gemini-2.0-flash",
+            "google/gemini-2.5-flash",
+            "mistral/mistral-large",
+        ])("model %s → dom", (modelName) => {
+            const result = resolveAgentMode(undefined, modelName, "fallback-model");
+            expect(result).toBe("dom");
+        });
+    });
+    describe("falls back to stagehand-level model when no agent model is set", () => {
+        it("uses stagehand model for routing when agent model is undefined", () => {
+            const result = resolveAgentMode(undefined, undefined, "anthropic/claude-sonnet-4-20250514");
+            expect(result).toBe("hybrid");
+        });
+        it("routes to dom when stagehand model is not hybrid-capable", () => {
+            const result = resolveAgentMode(undefined, undefined, "openai/gpt-4o-mini");
+            expect(result).toBe("dom");
+        });
+    });
+    describe("handles AgentModelConfig objects", () => {
+        it("extracts modelName from config object for routing", () => {
+            const result = resolveAgentMode(undefined, { modelName: "anthropic/claude-sonnet-4-20250514" }, "openai/gpt-4o");
+            expect(result).toBe("hybrid");
+        });
+        it("routes to dom when config object model is not hybrid-capable", () => {
+            const result = resolveAgentMode(undefined, { modelName: "openai/gpt-4o-mini" }, "openai/gpt-4o");
+            expect(result).toBe("dom");
+        });
+    });
+});
+describe("V3AgentHandler mode fallback", () => {
+    it("handler defaults to dom when mode is undefined (safety net)", () => {
+        const mode = undefined;
+        const resolved = mode ?? "dom";
+        expect(resolved).toBe("dom");
+    });
+    it("handler uses provided mode when set", () => {
+        const mode = "hybrid";
+        const resolved = mode ?? "dom";
+        expect(resolved).toBe("hybrid");
+    });
+});
+//# sourceMappingURL=agent-mode-routing.test.js.map

package/dist/esm/tests/unit/agent-mode-routing.test.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"agent-mode-routing.test.js","sourceRoot":"","sources":["../../../../tests/unit/agent-mode-routing.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { extractModelName } from \"../../lib/modelUtils.js\";\nimport type { AgentToolMode } from \"../../lib/v3/types/public/agent.js\";\nimport { HYBRID_CAPABLE_MODEL_PATTERNS } from \"../../lib/v3/types/private/agent.js\";\n\nfunction resolveDefaultAgentMode(\n model: string | { modelName: string } | undefined,\n fallbackModelName: string,\n): AgentToolMode {\n const modelName = extractModelName(model) ?? fallbackModelName;\n const isHybridCapable = HYBRID_CAPABLE_MODEL_PATTERNS.some((pattern) =>\n modelName.includes(pattern),\n );\n return isHybridCapable ? \"hybrid\" : \"dom\";\n}\n\nfunction resolveAgentMode(\n explicitMode: AgentToolMode | undefined,\n model: string | { modelName: string } | undefined,\n fallbackModelName: string,\n): AgentToolMode {\n return explicitMode ?? resolveDefaultAgentMode(model, fallbackModelName);\n}\n\ndescribe(\"agent mode auto-routing\", () => {\n describe(\"explicit mode is never overridden\", () => {\n it(\"respects mode: 'dom' even when model supports hybrid\", () => {\n const result = resolveAgentMode(\n \"dom\",\n \"anthropic/claude-sonnet-4-20250514\",\n \"openai/gpt-4o\",\n );\n expect(result).toBe(\"dom\");\n });\n\n it(\"respects mode: 'hybrid' even when model does not support hybrid\", () => {\n const result = resolveAgentMode(\n \"hybrid\",\n \"openai/gpt-4o-mini\",\n \"openai/gpt-4o-mini\",\n );\n expect(result).toBe(\"hybrid\");\n });\n\n it(\"respects mode: 'cua' regardless of model\", () => {\n const result = resolveAgentMode(\n \"cua\",\n \"anthropic/claude-sonnet-4-20250514\",\n \"openai/gpt-4o\",\n );\n expect(result).toBe(\"cua\");\n });\n });\n\n describe(\"auto-routes to hybrid for supported models when no mode is set\", () => {\n it.each([\n [\"google/gemini-3-flash-preview\", \"gemini-3\"],\n [\"google/gemini-3-flash\", \"gemini-3\"],\n [\"anthropic/claude-sonnet-4-20250514\", \"claude\"],\n [\"anthropic/claude-haiku-4-5-20251001\", \"claude\"],\n [\"openai/gpt-5.4-turbo\", \"gpt-5.4\"],\n [\"openai/gpt-5.4\", \"gpt-5.4\"],\n ])(\"model %s (pattern: %s) → hybrid\", (modelName: string) => {\n const result = resolveAgentMode(undefined, modelName, \"fallback-model\");\n expect(result).toBe(\"hybrid\");\n });\n });\n\n describe(\"auto-routes to dom for unsupported models when no mode is set\", () => {\n it.each([\n \"openai/gpt-4o\",\n \"openai/gpt-4o-mini\",\n \"openai/gpt-4.1-mini\",\n \"google/gemini-2.0-flash\",\n \"google/gemini-2.5-flash\",\n \"mistral/mistral-large\",\n ])(\"model %s → dom\", (modelName: string) => {\n const result = resolveAgentMode(undefined, modelName, \"fallback-model\");\n expect(result).toBe(\"dom\");\n });\n });\n\n describe(\"falls back to stagehand-level model when no agent model is set\", () => {\n it(\"uses stagehand model for routing when agent model is undefined\", () => {\n const result = resolveAgentMode(\n undefined,\n undefined,\n \"anthropic/claude-sonnet-4-20250514\",\n );\n expect(result).toBe(\"hybrid\");\n });\n\n it(\"routes to dom when stagehand model is not hybrid-capable\", () => {\n const result = resolveAgentMode(\n undefined,\n undefined,\n \"openai/gpt-4o-mini\",\n );\n expect(result).toBe(\"dom\");\n });\n });\n\n describe(\"handles AgentModelConfig objects\", () => {\n it(\"extracts modelName from config object for routing\", () => {\n const result = resolveAgentMode(\n undefined,\n { modelName: \"anthropic/claude-sonnet-4-20250514\" },\n \"openai/gpt-4o\",\n );\n expect(result).toBe(\"hybrid\");\n });\n\n it(\"routes to dom when config object model is not hybrid-capable\", () => {\n const result = resolveAgentMode(\n undefined,\n { modelName: \"openai/gpt-4o-mini\" },\n \"openai/gpt-4o\",\n );\n expect(result).toBe(\"dom\");\n });\n });\n});\n\ndescribe(\"V3AgentHandler mode fallback\", () => {\n it(\"handler defaults to dom when mode is undefined (safety net)\", () => {\n const mode: AgentToolMode | undefined = undefined;\n const resolved = mode ?? \"dom\";\n expect(resolved).toBe(\"dom\");\n });\n\n it(\"handler uses provided mode when set\", () => {\n const mode: AgentToolMode | undefined = \"hybrid\";\n const resolved = mode ?? \"dom\";\n expect(resolved).toBe(\"hybrid\");\n });\n});\n"]}

package/dist/esm/tests/unit/agent-temperature.test.d.ts ADDED Viewed

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

package/dist/esm/tests/unit/agent-temperature.test.js ADDED Viewed

@@ -0,0 +1,189 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+vi.mock("ai", async () => {
+    const actual = await vi.importActual("ai");
+    return {
+        ...actual,
+        wrapLanguageModel: vi.fn(({ model }) => model),
+    };
+});
+import { V3AgentHandler } from "../../lib/v3/handlers/v3AgentHandler.js";
+const usage = {
+    inputTokens: 1,
+    outputTokens: 1,
+    reasoningTokens: 0,
+    cachedInputTokens: 0,
+    totalTokens: 2,
+};
+const emptyList = () => [];
+function createDoneStep() {
+    return {
+        content: emptyList(),
+        text: "",
+        reasoning: emptyList(),
+        reasoningText: undefined,
+        files: emptyList(),
+        sources: emptyList(),
+        toolCalls: [
+            {
+                type: "tool-call",
+                toolCallId: "call_done",
+                toolName: "done",
+                input: {
+                    reasoning: "Task completed",
+                    taskComplete: true,
+                },
+            },
+        ],
+        staticToolCalls: emptyList(),
+        dynamicToolCalls: emptyList(),
+        toolResults: [
+            {
+                type: "tool-result",
+                toolCallId: "call_done",
+                toolName: "done",
+                input: {
+                    reasoning: "Task completed",
+                    taskComplete: true,
+                },
+                output: {
+                    success: true,
+                    reasoning: "Task completed",
+                    taskComplete: true,
+                },
+            },
+        ],
+        staticToolResults: emptyList(),
+        dynamicToolResults: emptyList(),
+        finishReason: "tool-calls",
+        usage,
+        warnings: undefined,
+        request: {},
+        response: {
+            id: "response-id",
+            modelId: "openai/gpt-5-mini",
+            timestamp: new Date(0),
+            messages: emptyList(),
+        },
+        providerMetadata: undefined,
+    };
+}
+function createGenerateResult(doneStep) {
+    return {
+        content: emptyList(),
+        text: "",
+        reasoning: emptyList(),
+        reasoningText: undefined,
+        files: emptyList(),
+        sources: emptyList(),
+        toolCalls: doneStep.toolCalls,
+        staticToolCalls: emptyList(),
+        dynamicToolCalls: emptyList(),
+        toolResults: doneStep.toolResults,
+        staticToolResults: emptyList(),
+        dynamicToolResults: emptyList(),
+        finishReason: "tool-calls",
+        usage,
+        totalUsage: usage,
+        warnings: undefined,
+        request: {},
+        response: {
+            id: "response-id",
+            modelId: "openai/gpt-5-mini",
+            timestamp: new Date(0),
+            messages: emptyList(),
+        },
+        providerMetadata: undefined,
+        steps: [doneStep],
+        experimental_output: undefined,
+    };
+}
+function createV3() {
+    const page = {
+        url: () => "https://example.com",
+        enableCursorOverlay: vi.fn(async () => { }),
+    };
+    return {
+        context: {
+            awaitActivePage: vi.fn(async () => page),
+        },
+        isCaptchaAutoSolveEnabled: false,
+        browserbaseApiKey: undefined,
+        logger: vi.fn(),
+        recordAgentReplayStep: vi.fn(),
+        updateMetrics: vi.fn(),
+        act: vi.fn(),
+        extract: vi.fn(),
+        observe: vi.fn(),
+    };
+}
+function createLlmClient() {
+    const model = {
+        modelId: "openai/gpt-5-mini",
+        provider: "openai",
+        specificationVersion: "v2",
+    };
+    const generateText = vi.fn(async (options) => {
+        const doneStep = createDoneStep();
+        await options.onStepFinish?.(doneStep);
+        return createGenerateResult(doneStep);
+    });
+    const streamText = vi.fn((options) => {
+        void (async () => {
+            const doneStep = createDoneStep();
+            await options.onStepFinish?.(doneStep);
+            options.onFinish?.(createGenerateResult(doneStep));
+        })();
+        return {
+            textStream: (async function* () { })(),
+        };
+    });
+    return {
+        client: {
+            getLanguageModel: vi.fn(() => model),
+            generateText,
+            streamText,
+        },
+        generateText,
+        streamText,
+    };
+}
+describe("v3 agent temperature options", () => {
+    let logger;
+    beforeEach(() => {
+        logger = vi.fn();
+    });
+    it("does not pass a temperature setting to non-streaming agent generation", async () => {
+        const { client, generateText } = createLlmClient();
+        const handler = new V3AgentHandler(createV3(), logger, client);
+        await handler.execute({
+            instruction: "finish",
+            maxSteps: 1,
+            excludeTools: ["search"],
+        });
+        expect(generateText).toHaveBeenCalledTimes(1);
+        const options = generateText.mock.calls[0][0];
+        expect(options).not.toHaveProperty("temperature");
+        expect(options.providerOptions).toEqual({
+            google: { mediaResolution: "MEDIA_RESOLUTION_HIGH" },
+            openai: { store: false },
+        });
+    });
+    it("does not pass a temperature setting to streaming agent generation", async () => {
+        const { client, streamText } = createLlmClient();
+        const handler = new V3AgentHandler(createV3(), logger, client);
+        const streamResult = await handler.stream({
+            instruction: "finish",
+            maxSteps: 1,
+            excludeTools: ["search"],
+        });
+        await streamResult.result;
+        expect(streamText).toHaveBeenCalledTimes(1);
+        const options = streamText.mock.calls[0][0];
+        expect(options).not.toHaveProperty("temperature");
+        expect(options.providerOptions).toEqual({
+            google: { mediaResolution: "MEDIA_RESOLUTION_HIGH" },
+            openai: { store: false },
+        });
+    });
+});
+//# sourceMappingURL=agent-temperature.test.js.map

package/dist/esm/tests/unit/agent-temperature.test.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"agent-temperature.test.js","sourceRoot":"","sources":["../../../../tests/unit/agent-temperature.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { beforeEach, describe, expect, it, vi } from \"vitest\";\nimport type { LanguageModelV2 } from \"@ai-sdk/provider\";\nimport type { LLMClient } from \"../../lib/v3/llm/LLMClient.js\";\nimport type { LogLine } from \"../../lib/v3/types/public/logs.js\";\nimport type { V3 } from \"../../lib/v3/v3.js\";\n\nvi.mock(\"ai\", async () => {\n const actual = await vi.importActual<typeof import(\"ai\")>(\"ai\");\n return {\n ...actual,\n wrapLanguageModel: vi.fn(({ model }) => model),\n };\n});\n\nimport { V3AgentHandler } from \"../../lib/v3/handlers/v3AgentHandler.js\";\n\ntype AgentLlmOptions = {\n onStepFinish?: (step: unknown) => Promise<void> | void;\n onFinish?: (event: unknown) => void;\n providerOptions?: Record<string, unknown>;\n temperature?: number;\n};\n\nconst usage = {\n inputTokens: 1,\n outputTokens: 1,\n reasoningTokens: 0,\n cachedInputTokens: 0,\n totalTokens: 2,\n};\n\nconst emptyList = () => [] as unknown[];\n\nfunction createDoneStep() {\n return {\n content: emptyList(),\n text: \"\",\n reasoning: emptyList(),\n reasoningText: undefined as string | undefined,\n files: emptyList(),\n sources: emptyList(),\n toolCalls: [\n {\n type: \"tool-call\",\n toolCallId: \"call_done\",\n toolName: \"done\",\n input: {\n reasoning: \"Task completed\",\n taskComplete: true,\n },\n },\n ],\n staticToolCalls: emptyList(),\n dynamicToolCalls: emptyList(),\n toolResults: [\n {\n type: \"tool-result\",\n toolCallId: \"call_done\",\n toolName: \"done\",\n input: {\n reasoning: \"Task completed\",\n taskComplete: true,\n },\n output: {\n success: true,\n reasoning: \"Task completed\",\n taskComplete: true,\n },\n },\n ],\n staticToolResults: emptyList(),\n dynamicToolResults: emptyList(),\n finishReason: \"tool-calls\",\n usage,\n warnings: undefined as unknown,\n request: {},\n response: {\n id: \"response-id\",\n modelId: \"openai/gpt-5-mini\",\n timestamp: new Date(0),\n messages: emptyList(),\n },\n providerMetadata: undefined as unknown,\n };\n}\n\nfunction createGenerateResult(doneStep: ReturnType<typeof createDoneStep>) {\n return {\n content: emptyList(),\n text: \"\",\n reasoning: emptyList(),\n reasoningText: undefined as string | undefined,\n files: emptyList(),\n sources: emptyList(),\n toolCalls: doneStep.toolCalls,\n staticToolCalls: emptyList(),\n dynamicToolCalls: emptyList(),\n toolResults: doneStep.toolResults,\n staticToolResults: emptyList(),\n dynamicToolResults: emptyList(),\n finishReason: \"tool-calls\",\n usage,\n totalUsage: usage,\n warnings: undefined as unknown,\n request: {},\n response: {\n id: \"response-id\",\n modelId: \"openai/gpt-5-mini\",\n timestamp: new Date(0),\n messages: emptyList(),\n },\n providerMetadata: undefined as unknown,\n steps: [doneStep],\n experimental_output: undefined as unknown,\n };\n}\n\nfunction createV3() {\n const page = {\n url: () => \"https://example.com\",\n enableCursorOverlay: vi.fn(async () => {}),\n };\n\n return {\n context: {\n awaitActivePage: vi.fn(async () => page),\n },\n isCaptchaAutoSolveEnabled: false,\n browserbaseApiKey: undefined,\n logger: vi.fn(),\n recordAgentReplayStep: vi.fn(),\n updateMetrics: vi.fn(),\n act: vi.fn(),\n extract: vi.fn(),\n observe: vi.fn(),\n } as unknown as V3;\n}\n\nfunction createLlmClient() {\n const model = {\n modelId: \"openai/gpt-5-mini\",\n provider: \"openai\",\n specificationVersion: \"v2\",\n } as unknown as LanguageModelV2;\n\n const generateText = vi.fn(async (options: AgentLlmOptions) => {\n const doneStep = createDoneStep();\n await options.onStepFinish?.(doneStep);\n return createGenerateResult(doneStep);\n });\n\n const streamText = vi.fn((options: AgentLlmOptions) => {\n void (async () => {\n const doneStep = createDoneStep();\n await options.onStepFinish?.(doneStep);\n options.onFinish?.(createGenerateResult(doneStep));\n })();\n\n return {\n textStream: (async function* () {})(),\n };\n });\n\n return {\n client: {\n getLanguageModel: vi.fn(() => model),\n generateText,\n streamText,\n } as unknown as LLMClient,\n generateText,\n streamText,\n };\n}\n\ndescribe(\"v3 agent temperature options\", () => {\n let logger: (line: LogLine) => void;\n\n beforeEach(() => {\n logger = vi.fn();\n });\n\n it(\"does not pass a temperature setting to non-streaming agent generation\", async () => {\n const { client, generateText } = createLlmClient();\n const handler = new V3AgentHandler(createV3(), logger, client);\n\n await handler.execute({\n instruction: \"finish\",\n maxSteps: 1,\n excludeTools: [\"search\"],\n });\n\n expect(generateText).toHaveBeenCalledTimes(1);\n const options = generateText.mock.calls[0][0] as AgentLlmOptions;\n expect(options).not.toHaveProperty(\"temperature\");\n expect(options.providerOptions).toEqual({\n google: { mediaResolution: \"MEDIA_RESOLUTION_HIGH\" },\n openai: { store: false },\n });\n });\n\n it(\"does not pass a temperature setting to streaming agent generation\", async () => {\n const { client, streamText } = createLlmClient();\n const handler = new V3AgentHandler(createV3(), logger, client);\n\n const streamResult = await handler.stream({\n instruction: \"finish\",\n maxSteps: 1,\n excludeTools: [\"search\"],\n });\n await streamResult.result;\n\n expect(streamText).toHaveBeenCalledTimes(1);\n const options = streamText.mock.calls[0][0] as AgentLlmOptions;\n expect(options).not.toHaveProperty(\"temperature\");\n expect(options.providerOptions).toEqual({\n google: { mediaResolution: \"MEDIA_RESOLUTION_HIGH\" },\n openai: { store: false },\n });\n });\n});\n"]}

package/dist/esm/tests/unit/agent-variables-validation.test.d.ts ADDED Viewed

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

package/dist/esm/tests/unit/agent-variables-validation.test.js ADDED Viewed

@@ -0,0 +1,41 @@
+import { describe, expect, it } from "vitest";
+import { validateExperimentalFeatures } from "../../lib/v3/agent/utils/validateExperimentalFeatures.js";
+import { StagehandInvalidArgumentError } from "../../lib/v3/types/public/sdkErrors.js";
+describe("agent variable experimental validation", () => {
+    it("allows variables without experimental mode", () => {
+        expect(() => validateExperimentalFeatures({
+            isExperimental: false,
+            agentConfig: { mode: "dom" },
+            executeOptions: {
+                instruction: "fill %username%",
+                variables: { username: "john@example.com" },
+            },
+        })).not.toThrow();
+    });
+    it("allows rich variables without experimental mode", () => {
+        expect(() => validateExperimentalFeatures({
+            isExperimental: false,
+            agentConfig: { mode: "dom" },
+            executeOptions: {
+                instruction: "fill %username%",
+                variables: {
+                    username: {
+                        value: "john@example.com",
+                        description: "The login email",
+                    },
+                },
+            },
+        })).not.toThrow();
+    });
+    it("continues to reject variables in CUA mode", () => {
+        expect(() => validateExperimentalFeatures({
+            isExperimental: true,
+            agentConfig: { mode: "cua" },
+            executeOptions: {
+                instruction: "fill %username%",
+                variables: { username: "john@example.com" },
+            },
+        })).toThrow(StagehandInvalidArgumentError);
+    });
+});
+//# sourceMappingURL=agent-variables-validation.test.js.map

package/dist/esm/tests/unit/agent-variables-validation.test.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"agent-variables-validation.test.js","sourceRoot":"","sources":["../../../../tests/unit/agent-variables-validation.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,4BAA4B,EAAE,MAAM,0DAA0D,CAAC;AACxG,OAAO,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AAEvF,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACtD,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,GAAG,EAAE,CACV,4BAA4B,CAAC;YAC3B,cAAc,EAAE,KAAK;YACrB,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;YAC5B,cAAc,EAAE;gBACd,WAAW,EAAE,iBAAiB;gBAC9B,SAAS,EAAE,EAAE,QAAQ,EAAE,kBAAkB,EAAE;aAC5C;SACF,CAAC,CACH,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,GAAG,EAAE,CACV,4BAA4B,CAAC;YAC3B,cAAc,EAAE,KAAK;YACrB,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;YAC5B,cAAc,EAAE;gBACd,WAAW,EAAE,iBAAiB;gBAC9B,SAAS,EAAE;oBACT,QAAQ,EAAE;wBACR,KAAK,EAAE,kBAAkB;wBACzB,WAAW,EAAE,iBAAiB;qBAC/B;iBACF;aACF;SACF,CAAC,CACH,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,GAAG,EAAE,CACV,4BAA4B,CAAC;YAC3B,cAAc,EAAE,IAAI;YACpB,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;YAC5B,cAAc,EAAE;gBACd,WAAW,EAAE,iBAAiB;gBAC9B,SAAS,EAAE,EAAE,QAAQ,EAAE,kBAAkB,EAAE;aAC5C;SACF,CAAC,CACH,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { validateExperimentalFeatures } from \"../../lib/v3/agent/utils/validateExperimentalFeatures.js\";\nimport { StagehandInvalidArgumentError } from \"../../lib/v3/types/public/sdkErrors.js\";\n\ndescribe(\"agent variable experimental validation\", () => {\n it(\"allows variables without experimental mode\", () => {\n expect(() =>\n validateExperimentalFeatures({\n isExperimental: false,\n agentConfig: { mode: \"dom\" },\n executeOptions: {\n instruction: \"fill %username%\",\n variables: { username: \"john@example.com\" },\n },\n }),\n ).not.toThrow();\n });\n\n it(\"allows rich variables without experimental mode\", () => {\n expect(() =>\n validateExperimentalFeatures({\n isExperimental: false,\n agentConfig: { mode: \"dom\" },\n executeOptions: {\n instruction: \"fill %username%\",\n variables: {\n username: {\n value: \"john@example.com\",\n description: \"The login email\",\n },\n },\n },\n }),\n ).not.toThrow();\n });\n\n it(\"continues to reject variables in CUA mode\", () => {\n expect(() =>\n validateExperimentalFeatures({\n isExperimental: true,\n agentConfig: { mode: \"cua\" },\n executeOptions: {\n instruction: \"fill %username%\",\n variables: { username: \"john@example.com\" },\n },\n }),\n ).toThrow(StagehandInvalidArgumentError);\n });\n});\n"]}

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

@@ -60,6 +60,7 @@ describe("StagehandAPIClient variable serialization", () => {
                     },
                     password: "secret",
                 },
+                ignoreSelectors: [".cookie-banner"],
             },
         });
         expect(executeMock).toHaveBeenCalledWith({
@@ -74,11 +75,59 @@ describe("StagehandAPIClient variable serialization", () => {
                         },
                         password: "secret",
                     },
+                    ignoreSelectors: [".cookie-banner"],
                 },
                 frameId: undefined,
             },
             serverCache: undefined,
         });
     });
+    it("preserves rich variables when sending the agentExecute request", async () => {
+        const client = new StagehandAPIClient({
+            apiKey: "bb-test",
+            logger: vi.fn(),
+        });
+        const executeMock = vi.fn().mockResolvedValue({
+            success: true,
+            message: "ok",
+            actions: [],
+            completed: true,
+        });
+        client.execute = executeMock;
+        await client.agentExecute({ mode: "dom" }, {
+            instruction: "fill the form with %username% and %password%",
+            variables: {
+                username: "john@example.com",
+                password: {
+                    value: "secret",
+                    description: "The login password",
+                },
+            },
+        });
+        expect(executeMock).toHaveBeenCalledWith({
+            method: "agentExecute",
+            args: {
+                agentConfig: {
+                    systemPrompt: undefined,
+                    mode: "dom",
+                    cua: undefined,
+                    model: undefined,
+                    executionModel: undefined,
+                },
+                executeOptions: {
+                    instruction: "fill the form with %username% and %password%",
+                    variables: {
+                        username: "john@example.com",
+                        password: {
+                            value: "secret",
+                            description: "The login password",
+                        },
+                    },
+                },
+                frameId: undefined,
+                shouldCache: undefined,
+            },
+        });
+    });
 });
 //# sourceMappingURL=api-client-observe-variables.test.js.map