@browserbasehq/orca 3.2.0-middleware.1 → 3.2.0-middleware.2

package/dist/cjs/lib/version.js

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

package/dist/cjs/lib/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../lib/version.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,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"]}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../lib/version.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,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.1.0\" as const;\n"]}

package/dist/cjs/tests/integration/chrome-newtab-page-tracking.spec.d.ts

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

package/dist/cjs/tests/integration/chrome-newtab-page-tracking.spec.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const test_1 = require("@playwright/test");
+const v3_js_1 = require("../../lib/v3/v3.js");
+const v3_dynamic_config_js_1 = require("./v3.dynamic.config.js");
+const testUtils_js_1 = require("./testUtils.js");
+test_1.test.describe("V3 chrome:// new-tab page tracking", () => {
+    let v3;
+    test_1.test.beforeEach(async () => {
+        v3 = new v3_js_1.V3(v3_dynamic_config_js_1.v3DynamicTestConfig);
+        await v3.init();
+    });
+    test_1.test.afterEach(async () => {
+        await (0, testUtils_js_1.closeV3)(v3);
+    });
+    (0, test_1.test)("pages() includes a tab opened via chrome://newtab/", async () => {
+        const ctx = v3.context;
+        const initialPages = ctx.pages();
+        (0, test_1.expect)(initialPages.length).toBe(1);
+        // Simulate a manually-opened tab by creating a target at chrome://newtab/.
+        // This is the same CDP path the browser takes when the user presses Ctrl+T.
+        const { targetId } = await ctx.conn.send("Target.createTarget", { url: "chrome://newtab/" });
+        // Wait for the page to be registered (onAttachedToTarget is async).
+        const deadline = Date.now() + 5000;
+        while (Date.now() < deadline) {
+            if (ctx.pages().length >= 2)
+                break;
+            await new Promise((r) => setTimeout(r, 50));
+        }
+        const pages = ctx.pages();
+        (0, test_1.expect)(pages.length).toBe(2);
+        // The new page's target should match the one we created.
+        const newPage = pages.find((p) => p.targetId() === targetId);
+        (0, test_1.expect)(newPage).toBeTruthy();
+    });
+    (0, test_1.test)("chrome://newtab/ tab becomes usable after navigating to a web URL", async () => {
+        const ctx = v3.context;
+        // Create a tab at chrome://newtab/ (same as user pressing Ctrl+T).
+        const { targetId } = await ctx.conn.send("Target.createTarget", { url: "chrome://newtab/" });
+        // Wait for registration.
+        const deadline = Date.now() + 5000;
+        while (Date.now() < deadline) {
+            if (ctx.pages().some((p) => p.targetId() === targetId))
+                break;
+            await new Promise((r) => setTimeout(r, 50));
+        }
+        const newPage = ctx.pages().find((p) => p.targetId() === targetId);
+        (0, test_1.expect)(newPage).toBeTruthy();
+        // Navigate the new tab to a real web page.
+        await newPage.goto("https://example.com/", {
+            waitUntil: "domcontentloaded",
+        });
+        (0, test_1.expect)(newPage.url()).toContain("example.com");
+    });
+});
+//# sourceMappingURL=chrome-newtab-page-tracking.spec.js.map

package/dist/cjs/tests/integration/chrome-newtab-page-tracking.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome-newtab-page-tracking.spec.js","sourceRoot":"","sources":["../../../../tests/integration/chrome-newtab-page-tracking.spec.ts"],"names":[],"mappings":"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","sourcesContent":["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../../lib/v3/v3.js\";\nimport { v3DynamicTestConfig } from \"./v3.dynamic.config.js\";\nimport { closeV3 } from \"./testUtils.js\";\n\ntest.describe(\"V3 chrome:// new-tab page tracking\", () => {\n  let v3: V3;\n\n  test.beforeEach(async () => {\n    v3 = new V3(v3DynamicTestConfig);\n    await v3.init();\n  });\n\n  test.afterEach(async () => {\n    await closeV3(v3);\n  });\n\n  test(\"pages() includes a tab opened via chrome://newtab/\", async () => {\n    const ctx = v3.context;\n    const initialPages = ctx.pages();\n    expect(initialPages.length).toBe(1);\n\n    // Simulate a manually-opened tab by creating a target at chrome://newtab/.\n    // This is the same CDP path the browser takes when the user presses Ctrl+T.\n    const { targetId } = await ctx.conn.send<{ targetId: string }>(\n      \"Target.createTarget\",\n      { url: \"chrome://newtab/\" },\n    );\n\n    // Wait for the page to be registered (onAttachedToTarget is async).\n    const deadline = Date.now() + 5000;\n    while (Date.now() < deadline) {\n      if (ctx.pages().length >= 2) break;\n      await new Promise((r) => setTimeout(r, 50));\n    }\n\n    const pages = ctx.pages();\n    expect(pages.length).toBe(2);\n\n    // The new page's target should match the one we created.\n    const newPage = pages.find((p) => p.targetId() === targetId);\n    expect(newPage).toBeTruthy();\n  });\n\n  test(\"chrome://newtab/ tab becomes usable after navigating to a web URL\", async () => {\n    const ctx = v3.context;\n\n    // Create a tab at chrome://newtab/ (same as user pressing Ctrl+T).\n    const { targetId } = await ctx.conn.send<{ targetId: string }>(\n      \"Target.createTarget\",\n      { url: \"chrome://newtab/\" },\n    );\n\n    // Wait for registration.\n    const deadline = Date.now() + 5000;\n    while (Date.now() < deadline) {\n      if (ctx.pages().some((p) => p.targetId() === targetId)) break;\n      await new Promise((r) => setTimeout(r, 50));\n    }\n\n    const newPage = ctx.pages().find((p) => p.targetId() === targetId);\n    expect(newPage).toBeTruthy();\n\n    // Navigate the new tab to a real web page.\n    await newPage!.goto(\"https://example.com/\", {\n      waitUntil: \"domcontentloaded\",\n    });\n\n    expect(newPage!.url()).toContain(\"example.com\");\n  });\n});\n"]}

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

@@ -6,7 +6,7 @@ const extract_js_1 = require("../../lib/v3/agent/tools/extract.js");
 const fillform_js_1 = require("../../lib/v3/agent/tools/fillform.js");
 /**
  * Minimal mock of V3 that captures how tools pass `model` options
- * into v3.act(), v3.extract(), and v3.observe().
+ * into v3.act(), v3.extract(), and v3.observe(), plus observe variables.
  */
 function createMockV3() {
     const calls = [];
@@ -27,7 +27,11 @@ function createMockV3() {
             return { extraction: "data" };
         }),
         observe: vitest_1.vi.fn(async (_instruction, options) => {
-            calls.push({ method: "observe", model: options?.model });
+            calls.push({
+                method: "observe",
+                model: options?.model,
+                variables: options?.variables,
+            });
             return [];
         }),
         calls,
@@ -76,6 +80,24 @@ function createMockV3() {
         (0, vitest_1.expect)(v3.calls[0].method).toBe("observe");
         (0, vitest_1.expect)(v3.calls[0].model).toBe(modelConfig);
     });
+    (0, vitest_1.it)("fillFormTool passes variables through to v3.observe()", async () => {
+        const v3 = createMockV3();
+        const variables = {
+            username: {
+                value: "john@example.com",
+                description: "The login email",
+            },
+        };
+        const tool = (0, fillform_js_1.fillFormTool)(v3, undefined, variables);
+        await tool.execute({ fields: [{ action: "type %username% into the email field" }] }, {
+            toolCallId: "t3-variables",
+            messages: [],
+            abortSignal: new AbortController().signal,
+        });
+        (0, vitest_1.expect)(v3.calls).toHaveLength(1);
+        (0, vitest_1.expect)(v3.calls[0].method).toBe("observe");
+        (0, vitest_1.expect)(v3.calls[0].variables).toBe(variables);
+    });
     (0, vitest_1.it)("actTool passes undefined when no executionModel is set", async () => {
         const v3 = createMockV3();
         const tool = (0, act_js_1.actTool)(v3, undefined);

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

@@ -1 +1 @@
-{"version":3,"file":"agent-execution-model.test.js","sourceRoot":"","sources":["../../../../tests/unit/agent-execution-model.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it, vi } from \"vitest\";\nimport { actTool } from \"../../lib/v3/agent/tools/act.js\";\nimport { extractTool } from \"../../lib/v3/agent/tools/extract.js\";\nimport { fillFormTool } from \"../../lib/v3/agent/tools/fillform.js\";\nimport type { V3 } from \"../../lib/v3/v3.js\";\n\n/**\n * Minimal mock of V3 that captures how tools pass `model` options\n * into v3.act(), v3.extract(), and v3.observe().\n */\nfunction createMockV3() {\n  const calls: { method: string; model: unknown }[] = [];\n\n  const mock = {\n    logger: vi.fn(),\n    recordAgentReplayStep: vi.fn(),\n    act: vi.fn(async (_instruction: unknown, options?: { model?: unknown }) => {\n      calls.push({ method: \"act\", model: options?.model });\n      return {\n        success: true,\n        message: \"ok\",\n        actionDescription: \"clicked\",\n        actions: [],\n      };\n    }),\n    extract: vi.fn(\n      async (\n        _instruction: unknown,\n        _schema: unknown,\n        options?: { model?: unknown },\n      ) => {\n        calls.push({ method: \"extract\", model: options?.model });\n        return { extraction: \"data\" };\n      },\n    ),\n    observe: vi.fn(\n      async (_instruction: unknown, options?: { model?: unknown }) => {\n        calls.push({ method: \"observe\", model: options?.model });\n        return [];\n      },\n    ),\n    calls,\n  };\n\n  return mock as unknown as V3 & { calls: typeof calls };\n}\n\ndescribe(\"agent tools pass full executionModel config to v3 methods\", () => {\n  const modelConfig = {\n    modelName: \"openai/gpt-4o-mini\",\n    apiKey: \"sk-test-key\",\n    baseURL: \"https://custom.api\",\n  };\n\n  it(\"actTool passes AgentModelConfig object to v3.act()\", async () => {\n    const v3 = createMockV3();\n    const tool = actTool(v3, modelConfig);\n    await tool.execute!(\n      { action: \"click the button\" },\n      {\n        toolCallId: \"t1\",\n        messages: [],\n        abortSignal: new AbortController().signal,\n      },\n    );\n\n    expect(v3.calls).toHaveLength(1);\n    expect(v3.calls[0].method).toBe(\"act\");\n    expect(v3.calls[0].model).toBe(modelConfig);\n  });\n\n  it(\"extractTool passes AgentModelConfig object to v3.extract()\", async () => {\n    const v3 = createMockV3();\n    const tool = extractTool(v3, modelConfig);\n    await tool.execute!(\n      { instruction: \"get the title\", schema: undefined },\n      {\n        toolCallId: \"t2\",\n        messages: [],\n        abortSignal: new AbortController().signal,\n      },\n    );\n\n    expect(v3.calls).toHaveLength(1);\n    expect(v3.calls[0].method).toBe(\"extract\");\n    expect(v3.calls[0].model).toBe(modelConfig);\n  });\n\n  it(\"fillFormTool passes AgentModelConfig object to v3.observe()\", async () => {\n    const v3 = createMockV3();\n    const tool = fillFormTool(v3, modelConfig);\n    await tool.execute!(\n      { fields: [{ action: \"type hello into name\" }] },\n      {\n        toolCallId: \"t3\",\n        messages: [],\n        abortSignal: new AbortController().signal,\n      },\n    );\n\n    expect(v3.calls).toHaveLength(1);\n    expect(v3.calls[0].method).toBe(\"observe\");\n    expect(v3.calls[0].model).toBe(modelConfig);\n  });\n\n  it(\"actTool passes undefined when no executionModel is set\", async () => {\n    const v3 = createMockV3();\n    const tool = actTool(v3, undefined);\n    await tool.execute!(\n      { action: \"click the button\" },\n      {\n        toolCallId: \"t4\",\n        messages: [],\n        abortSignal: new AbortController().signal,\n      },\n    );\n\n    expect(v3.calls).toHaveLength(1);\n    expect(v3.calls[0].model).toBeUndefined();\n  });\n\n  it(\"actTool passes plain string executionModel to v3.act()\", async () => {\n    const v3 = createMockV3();\n    const tool = actTool(v3, \"openai/gpt-4o-mini\");\n    await tool.execute!(\n      { action: \"click the button\" },\n      {\n        toolCallId: \"t5\",\n        messages: [],\n        abortSignal: new AbortController().signal,\n      },\n    );\n\n    expect(v3.calls).toHaveLength(1);\n    expect(v3.calls[0].model).toBe(\"openai/gpt-4o-mini\");\n  });\n});\n\ndescribe(\"executionModel fallback logic\", () => {\n  // This mirrors the resolution in V3.prepareAgentExecution (v3.ts:1682):\n  //   const resolvedExecutionModel = options?.executionModel ?? options?.model;\n  function resolveExecutionModel(options?: {\n    executionModel?: string | { modelName: string };\n    model?: string | { modelName: string };\n  }) {\n    return options?.executionModel ?? options?.model;\n  }\n\n  it(\"prefers explicit executionModel over model\", () => {\n    const result = resolveExecutionModel({\n      executionModel: \"openai/gpt-4o-mini\",\n      model: \"anthropic/claude-sonnet-4-20250514\",\n    });\n    expect(result).toBe(\"openai/gpt-4o-mini\");\n  });\n\n  it(\"falls back to model when executionModel is not set\", () => {\n    const modelConfig = {\n      modelName: \"anthropic/claude-sonnet-4-20250514\",\n      apiKey: \"sk-test\",\n    };\n    const result = resolveExecutionModel({ model: modelConfig });\n    expect(result).toBe(modelConfig);\n  });\n\n  it(\"returns undefined when neither is set\", () => {\n    expect(resolveExecutionModel({})).toBeUndefined();\n    expect(resolveExecutionModel(undefined)).toBeUndefined();\n  });\n});\n"]}
+{"version":3,"file":"agent-execution-model.test.js","sourceRoot":"","sources":["../../../../tests/unit/agent-execution-model.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it, vi } from \"vitest\";\nimport { actTool } from \"../../lib/v3/agent/tools/act.js\";\nimport { extractTool } from \"../../lib/v3/agent/tools/extract.js\";\nimport { fillFormTool } from \"../../lib/v3/agent/tools/fillform.js\";\nimport type { V3 } from \"../../lib/v3/v3.js\";\n\n/**\n * Minimal mock of V3 that captures how tools pass `model` options\n * into v3.act(), v3.extract(), and v3.observe(), plus observe variables.\n */\nfunction createMockV3() {\n  const calls: { method: string; model: unknown; variables?: unknown }[] = [];\n\n  const mock = {\n    logger: vi.fn(),\n    recordAgentReplayStep: vi.fn(),\n    act: vi.fn(async (_instruction: unknown, options?: { model?: unknown }) => {\n      calls.push({ method: \"act\", model: options?.model });\n      return {\n        success: true,\n        message: \"ok\",\n        actionDescription: \"clicked\",\n        actions: [],\n      };\n    }),\n    extract: vi.fn(\n      async (\n        _instruction: unknown,\n        _schema: unknown,\n        options?: { model?: unknown },\n      ) => {\n        calls.push({ method: \"extract\", model: options?.model });\n        return { extraction: \"data\" };\n      },\n    ),\n    observe: vi.fn(\n      async (\n        _instruction: unknown,\n        options?: { model?: unknown; variables?: unknown },\n      ) => {\n        calls.push({\n          method: \"observe\",\n          model: options?.model,\n          variables: options?.variables,\n        });\n        return [];\n      },\n    ),\n    calls,\n  };\n\n  return mock as unknown as V3 & { calls: typeof calls };\n}\n\ndescribe(\"agent tools pass full executionModel config to v3 methods\", () => {\n  const modelConfig = {\n    modelName: \"openai/gpt-4o-mini\",\n    apiKey: \"sk-test-key\",\n    baseURL: \"https://custom.api\",\n  };\n\n  it(\"actTool passes AgentModelConfig object to v3.act()\", async () => {\n    const v3 = createMockV3();\n    const tool = actTool(v3, modelConfig);\n    await tool.execute!(\n      { action: \"click the button\" },\n      {\n        toolCallId: \"t1\",\n        messages: [],\n        abortSignal: new AbortController().signal,\n      },\n    );\n\n    expect(v3.calls).toHaveLength(1);\n    expect(v3.calls[0].method).toBe(\"act\");\n    expect(v3.calls[0].model).toBe(modelConfig);\n  });\n\n  it(\"extractTool passes AgentModelConfig object to v3.extract()\", async () => {\n    const v3 = createMockV3();\n    const tool = extractTool(v3, modelConfig);\n    await tool.execute!(\n      { instruction: \"get the title\", schema: undefined },\n      {\n        toolCallId: \"t2\",\n        messages: [],\n        abortSignal: new AbortController().signal,\n      },\n    );\n\n    expect(v3.calls).toHaveLength(1);\n    expect(v3.calls[0].method).toBe(\"extract\");\n    expect(v3.calls[0].model).toBe(modelConfig);\n  });\n\n  it(\"fillFormTool passes AgentModelConfig object to v3.observe()\", async () => {\n    const v3 = createMockV3();\n    const tool = fillFormTool(v3, modelConfig);\n    await tool.execute!(\n      { fields: [{ action: \"type hello into name\" }] },\n      {\n        toolCallId: \"t3\",\n        messages: [],\n        abortSignal: new AbortController().signal,\n      },\n    );\n\n    expect(v3.calls).toHaveLength(1);\n    expect(v3.calls[0].method).toBe(\"observe\");\n    expect(v3.calls[0].model).toBe(modelConfig);\n  });\n\n  it(\"fillFormTool passes variables through to v3.observe()\", async () => {\n    const v3 = createMockV3();\n    const variables = {\n      username: {\n        value: \"john@example.com\",\n        description: \"The login email\",\n      },\n    };\n    const tool = fillFormTool(v3, undefined, variables);\n    await tool.execute!(\n      { fields: [{ action: \"type %username% into the email field\" }] },\n      {\n        toolCallId: \"t3-variables\",\n        messages: [],\n        abortSignal: new AbortController().signal,\n      },\n    );\n\n    expect(v3.calls).toHaveLength(1);\n    expect(v3.calls[0].method).toBe(\"observe\");\n    expect(v3.calls[0].variables).toBe(variables);\n  });\n\n  it(\"actTool passes undefined when no executionModel is set\", async () => {\n    const v3 = createMockV3();\n    const tool = actTool(v3, undefined);\n    await tool.execute!(\n      { action: \"click the button\" },\n      {\n        toolCallId: \"t4\",\n        messages: [],\n        abortSignal: new AbortController().signal,\n      },\n    );\n\n    expect(v3.calls).toHaveLength(1);\n    expect(v3.calls[0].model).toBeUndefined();\n  });\n\n  it(\"actTool passes plain string executionModel to v3.act()\", async () => {\n    const v3 = createMockV3();\n    const tool = actTool(v3, \"openai/gpt-4o-mini\");\n    await tool.execute!(\n      { action: \"click the button\" },\n      {\n        toolCallId: \"t5\",\n        messages: [],\n        abortSignal: new AbortController().signal,\n      },\n    );\n\n    expect(v3.calls).toHaveLength(1);\n    expect(v3.calls[0].model).toBe(\"openai/gpt-4o-mini\");\n  });\n});\n\ndescribe(\"executionModel fallback logic\", () => {\n  // This mirrors the resolution in V3.prepareAgentExecution (v3.ts:1682):\n  //   const resolvedExecutionModel = options?.executionModel ?? options?.model;\n  function resolveExecutionModel(options?: {\n    executionModel?: string | { modelName: string };\n    model?: string | { modelName: string };\n  }) {\n    return options?.executionModel ?? options?.model;\n  }\n\n  it(\"prefers explicit executionModel over model\", () => {\n    const result = resolveExecutionModel({\n      executionModel: \"openai/gpt-4o-mini\",\n      model: \"anthropic/claude-sonnet-4-20250514\",\n    });\n    expect(result).toBe(\"openai/gpt-4o-mini\");\n  });\n\n  it(\"falls back to model when executionModel is not set\", () => {\n    const modelConfig = {\n      modelName: \"anthropic/claude-sonnet-4-20250514\",\n      apiKey: \"sk-test\",\n    };\n    const result = resolveExecutionModel({ model: modelConfig });\n    expect(result).toBe(modelConfig);\n  });\n\n  it(\"returns undefined when neither is set\", () => {\n    expect(resolveExecutionModel({})).toBeUndefined();\n    expect(resolveExecutionModel(undefined)).toBeUndefined();\n  });\n});\n"]}

package/dist/cjs/tests/unit/agent-system-prompt-variables.test.d.ts

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

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

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

package/dist/cjs/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,mCAA8C;AAC9C,0FAAyF;AAEzF,IAAA,iBAAQ,EAAC,kCAAkC,EAAE,GAAG,EAAE;IAChD,IAAA,WAAE,EAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,IAAA,6CAAsB,EAAC;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,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,SAAS,CACtB,sDAAsD,CACvD,CAAC;QACF,IAAA,eAAM,EAAC,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/cjs/tests/unit/aisdk-reasoning-effort.test.d.ts

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"api-variables-schema.test.js","sourceRoot":"","sources":["../../../../tests/unit/api-variables-schema.test.ts"],"names":[],"mappings":";;AAAA,mCAA8C;AAC9C,iEAAyD;AAEzD,IAAA,iBAAQ,EAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,IAAA,WAAE,EAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,MAAM,GAAG,cAAG,CAAC,gBAAgB,CAAC,SAAS,CAAC;YAC5C,KAAK,EAAE,sCAAsC;YAC7C,OAAO,EAAE;gBACP,SAAS,EAAE;oBACT,QAAQ,EAAE;wBACR,KAAK,EAAE,kBAAkB;wBACzB,WAAW,EAAE,iBAAiB;qBAC/B;oBACD,UAAU,EAAE,IAAI;iBACjB;aACF;SACF,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,cAAG,CAAC,oBAAoB,CAAC,SAAS,CAAC;YAChD,WAAW,EAAE,mDAAmD;YAChE,OAAO,EAAE;gBACP,SAAS,EAAE;oBACT,QAAQ,EAAE;wBACR,KAAK,EAAE,kBAAkB;wBACzB,WAAW,EAAE,iBAAiB;qBAC/B;oBACD,UAAU,EAAE,IAAI;iBACjB;aACF;SACF,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { Api } from \"../../lib/v3/types/public/index.js\";\n\ndescribe(\"API variable schemas\", () => {\n  it(\"accepts rich variables for act requests\", () => {\n    const result = Api.ActRequestSchema.safeParse({\n      input: \"type %username% into the email field\",\n      options: {\n        variables: {\n          username: {\n            value: \"john@example.com\",\n            description: \"The login email\",\n          },\n          rememberMe: true,\n        },\n      },\n    });\n\n    expect(result.success).toBe(true);\n  });\n\n  it(\"accepts rich variables for observe requests\", () => {\n    const result = Api.ObserveRequestSchema.safeParse({\n      instruction: \"find the field where %username% should be entered\",\n      options: {\n        variables: {\n          username: {\n            value: \"john@example.com\",\n            description: \"The login email\",\n          },\n          rememberMe: true,\n        },\n      },\n    });\n\n    expect(result.success).toBe(true);\n  });\n});\n"]}

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

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

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

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const prompt_js_1 = require("../../lib/prompt.js");
+(0, vitest_1.describe)("buildObserveSystemPrompt", () => {
+    (0, vitest_1.it)("includes variable descriptions when present", () => {
+        const prompt = (0, prompt_js_1.buildObserveSystemPrompt)(undefined, ["click", "fill"], {
+            username: {
+                value: "john@example.com",
+                description: "The login email",
+            },
+            password: "secret123",
+        });
+        (0, vitest_1.expect)(prompt.content).toContain("Supported actions: click, fill");
+        (0, vitest_1.expect)(prompt.content).toContain("Available variables: %username% (The login email), %password%");
+        (0, vitest_1.expect)(prompt.content).toContain("return the matching %variableName% placeholder");
+    });
+});
+//# sourceMappingURL=prompt-observe-variables.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-observe-variables.test.js","sourceRoot":"","sources":["../../../../tests/unit/prompt-observe-variables.test.ts"],"names":[],"mappings":";;AAAA,mCAA8C;AAC9C,mDAA+D;AAE/D,IAAA,iBAAQ,EAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,IAAA,WAAE,EAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,IAAA,oCAAwB,EAAC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE;YACpE,QAAQ,EAAE;gBACR,KAAK,EAAE,kBAAkB;gBACzB,WAAW,EAAE,iBAAiB;aAC/B;YACD,QAAQ,EAAE,WAAW;SACtB,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;QACnE,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAC9B,+DAA+D,CAChE,CAAC;QACF,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAC9B,gDAAgD,CACjD,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { buildObserveSystemPrompt } from \"../../lib/prompt.js\";\n\ndescribe(\"buildObserveSystemPrompt\", () => {\n  it(\"includes variable descriptions when present\", () => {\n    const prompt = buildObserveSystemPrompt(undefined, [\"click\", \"fill\"], {\n      username: {\n        value: \"john@example.com\",\n        description: \"The login email\",\n      },\n      password: \"secret123\",\n    });\n\n    expect(prompt.content).toContain(\"Supported actions: click, fill\");\n    expect(prompt.content).toContain(\n      \"Available variables: %username% (The login email), %password%\",\n    );\n    expect(prompt.content).toContain(\n      \"return the matching %variableName% placeholder\",\n    );\n  });\n});\n"]}