@browserbasehq/orca 3.0.9-alpha-4 → 3.1.0-patch.1

package/dist/esm/lib/v3/tests/agent-experimental-validation.spec.js

@@ -0,0 +1,357 @@
+import { test, expect } from "@playwright/test";
+import { z } from "zod";
+import { tool } from "ai";
+import { V3 } from "../v3.js";
+import { v3TestConfig } from "./v3.config.js";
+import {
+  ExperimentalNotConfiguredError,
+  StagehandInvalidArgumentError
+} from "../types/public/sdkErrors.js";
+const mockCustomTool = tool({
+  description: "A mock tool for testing",
+  inputSchema: z.object({
+    input: z.string().describe("The input string")
+  }),
+  execute: async ({ input }) => {
+    return `Processed: ${input}`;
+  }
+});
+test.describe("Stagehand agent experimental feature validation", () => {
+  test.describe("Invalid argument errors", () => {
+    let v3;
+    test.beforeEach(async () => {
+      v3 = new V3({
+        ...v3TestConfig,
+        experimental: false
+      });
+      await v3.init();
+    });
+    test.afterEach(async () => {
+      await v3?.close?.().catch(() => {
+      });
+    });
+    test("throws StagehandInvalidArgumentError when CUA and streaming are both enabled", async () => {
+      try {
+        v3.agent({
+          cua: true,
+          stream: true,
+          model: "anthropic/claude-sonnet-4-20250514"
+        });
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        expect(error).toBeInstanceOf(StagehandInvalidArgumentError);
+        expect(error.message).toContain("streaming");
+        expect(error.message).toContain("not supported with CUA");
+      }
+    });
+    test("throws StagehandInvalidArgumentError for CUA + streaming even with experimental: true", async () => {
+      await v3.close();
+      const v3Experimental = new V3({
+        ...v3TestConfig,
+        experimental: true
+      });
+      await v3Experimental.init();
+      try {
+        v3Experimental.agent({
+          cua: true,
+          stream: true,
+          model: "anthropic/claude-sonnet-4-20250514"
+        });
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        expect(error).toBeInstanceOf(StagehandInvalidArgumentError);
+        expect(error.message).toContain("streaming");
+        expect(error.message).toContain("not supported with CUA");
+      } finally {
+        await v3Experimental.close();
+      }
+    });
+  });
+  test.describe("Experimental feature errors without experimental: true", () => {
+    let v3;
+    test.beforeEach(async () => {
+      v3 = new V3({
+        ...v3TestConfig,
+        experimental: false
+      });
+      await v3.init();
+    });
+    test.afterEach(async () => {
+      await v3?.close?.().catch(() => {
+      });
+    });
+    test("throws ExperimentalNotConfiguredError for MCP integrations", async () => {
+      const agent = v3.agent({
+        model: "anthropic/claude-sonnet-4-20250514",
+        integrations: ["https://mcp.example.com"]
+      });
+      try {
+        await agent.execute("test");
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);
+        expect(error.message).toContain(
+          "MCP integrations and custom tools"
+        );
+      }
+    });
+    test("throws ExperimentalNotConfiguredError for custom tools", async () => {
+      const agent = v3.agent({
+        model: "anthropic/claude-sonnet-4-20250514",
+        tools: {
+          mockCustomTool
+        }
+      });
+      try {
+        await agent.execute("test");
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);
+        expect(error.message).toContain(
+          "MCP integrations and custom tools"
+        );
+      }
+    });
+    test("throws ExperimentalNotConfiguredError for streaming mode", async () => {
+      try {
+        const agent = v3.agent({
+          stream: true,
+          model: "anthropic/claude-sonnet-4-20250514"
+        });
+        await agent.execute("test instruction");
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);
+        expect(error.message).toContain("streaming");
+      }
+    });
+    test("throws ExperimentalNotConfiguredError for callbacks", async () => {
+      const agent = v3.agent({
+        model: "anthropic/claude-sonnet-4-20250514"
+      });
+      try {
+        await agent.execute({
+          instruction: "test",
+          callbacks: {
+            onStepFinish: async () => {
+            }
+          }
+        });
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);
+        expect(error.message).toContain("callbacks");
+      }
+    });
+    test("throws ExperimentalNotConfiguredError for abort signal", async () => {
+      const agent = v3.agent({
+        model: "anthropic/claude-sonnet-4-20250514"
+      });
+      const controller = new AbortController();
+      try {
+        await agent.execute({
+          instruction: "test",
+          signal: controller.signal
+        });
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);
+        expect(error.message).toContain("abort signal");
+      }
+    });
+    test("throws ExperimentalNotConfiguredError for message continuation", async () => {
+      const agent = v3.agent({
+        model: "anthropic/claude-sonnet-4-20250514"
+      });
+      try {
+        await agent.execute({
+          instruction: "test",
+          messages: [{ role: "user", content: "previous message" }]
+        });
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);
+        expect(error.message).toContain("message continuation");
+      }
+    });
+    test("throws ExperimentalNotConfiguredError listing multiple features", async () => {
+      const agent = v3.agent({
+        model: "anthropic/claude-sonnet-4-20250514"
+      });
+      const controller = new AbortController();
+      try {
+        await agent.execute({
+          instruction: "test",
+          callbacks: { onStepFinish: async () => {
+          } },
+          signal: controller.signal,
+          messages: [{ role: "user", content: "previous" }]
+        });
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);
+        const message = error.message;
+        expect(message).toContain("callbacks");
+        expect(message).toContain("abort signal");
+        expect(message).toContain("message continuation");
+      }
+    });
+  });
+  test.describe("CUA agent unsupported features", () => {
+    let v3;
+    test.beforeEach(async () => {
+      v3 = new V3({
+        ...v3TestConfig,
+        experimental: false
+      });
+      await v3.init();
+    });
+    test.afterEach(async () => {
+      await v3?.close?.().catch(() => {
+      });
+    });
+    test("throws ExperimentalNotConfiguredError for CUA with integrations", async () => {
+      try {
+        v3.agent({
+          cua: true,
+          model: "anthropic/claude-sonnet-4-20250514",
+          integrations: ["https://mcp.example.com"]
+        });
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);
+        expect(error.message).toContain(
+          "MCP integrations and custom tools"
+        );
+      }
+    });
+    test("throws StagehandInvalidArgumentError for CUA with abort signal (not supported)", async () => {
+      const agent = v3.agent({
+        cua: true,
+        model: "anthropic/claude-sonnet-4-20250514"
+      });
+      const controller = new AbortController();
+      try {
+        await agent.execute({
+          instruction: "test",
+          signal: controller.signal
+        });
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        expect(error).toBeInstanceOf(StagehandInvalidArgumentError);
+        expect(error.message).toContain("abort signal");
+        expect(error.message).toContain("not supported with CUA");
+      }
+    });
+    test("throws StagehandInvalidArgumentError for CUA with message continuation (not supported)", async () => {
+      const agent = v3.agent({
+        cua: true,
+        model: "anthropic/claude-sonnet-4-20250514"
+      });
+      try {
+        await agent.execute({
+          instruction: "test",
+          messages: [{ role: "user", content: "previous message" }]
+        });
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        expect(error).toBeInstanceOf(StagehandInvalidArgumentError);
+        expect(error.message).toContain("message continuation");
+        expect(error.message).toContain("not supported with CUA");
+      }
+    });
+    test("throws StagehandInvalidArgumentError for CUA with multiple unsupported features", async () => {
+      const agent = v3.agent({
+        cua: true,
+        model: "anthropic/claude-sonnet-4-20250514"
+      });
+      const controller = new AbortController();
+      try {
+        await agent.execute({
+          instruction: "test",
+          signal: controller.signal,
+          messages: [{ role: "user", content: "previous message" }]
+        });
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        expect(error).toBeInstanceOf(StagehandInvalidArgumentError);
+        const message = error.message;
+        expect(message).toContain("abort signal");
+        expect(message).toContain("message continuation");
+        expect(message).toContain("are not supported with CUA");
+      }
+    });
+    test("throws StagehandInvalidArgumentError for CUA unsupported features even with experimental: true", async () => {
+      await v3.close();
+      const v3Experimental = new V3({
+        ...v3TestConfig,
+        experimental: true
+      });
+      await v3Experimental.init();
+      const agent = v3Experimental.agent({
+        cua: true,
+        model: "anthropic/claude-sonnet-4-20250514"
+      });
+      const controller = new AbortController();
+      try {
+        await agent.execute({
+          instruction: "test",
+          signal: controller.signal
+        });
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        expect(error).toBeInstanceOf(StagehandInvalidArgumentError);
+        expect(error.message).toContain("not supported with CUA");
+      } finally {
+        await v3Experimental.close();
+      }
+    });
+  });
+  test.describe("Valid configurations with experimental: true", () => {
+    let v3;
+    test.beforeEach(async () => {
+      v3 = new V3({
+        ...v3TestConfig,
+        experimental: true
+      });
+      await v3.init();
+    });
+    test.afterEach(async () => {
+      await v3?.close?.().catch(() => {
+      });
+    });
+    test("allows CUA without streaming", () => {
+      expect(
+        () => v3.agent({
+          cua: true,
+          model: "anthropic/claude-sonnet-4-20250514"
+        })
+      ).not.toThrow();
+    });
+    test("allows streaming mode", () => {
+      expect(
+        () => v3.agent({
+          stream: true,
+          model: "anthropic/claude-sonnet-4-20250514"
+        })
+      ).not.toThrow();
+    });
+    test("allows basic agent without experimental features", async () => {
+      const v3NonExperimental = new V3({
+        ...v3TestConfig,
+        experimental: false
+      });
+      await v3NonExperimental.init();
+      try {
+        expect(
+          () => v3NonExperimental.agent({
+            model: "anthropic/claude-sonnet-4-20250514"
+          })
+        ).not.toThrow();
+      } finally {
+        await v3NonExperimental.close();
+      }
+    });
+  });
+});
+//# sourceMappingURL=agent-experimental-validation.spec.js.map

package/dist/esm/lib/v3/tests/agent-experimental-validation.spec.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/agent-experimental-validation.spec.ts"],
+  "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { z } from \"zod\";\nimport { tool } from \"ai\";\nimport { V3 } from \"../v3.js\";\nimport { v3TestConfig } from \"./v3.config.js\";\nimport {\n  ExperimentalNotConfiguredError,\n  StagehandInvalidArgumentError,\n} from \"../types/public/sdkErrors.js\";\n\n// Define a mock custom tool for testing\nconst mockCustomTool = tool({\n  description: \"A mock tool for testing\",\n  inputSchema: z.object({\n    input: z.string().describe(\"The input string\"),\n  }),\n  execute: async ({ input }) => {\n    return `Processed: ${input}`;\n  },\n});\n\ntest.describe(\"Stagehand agent experimental feature validation\", () => {\n  test.describe(\"Invalid argument errors\", () => {\n    let v3: V3;\n\n    test.beforeEach(async () => {\n      v3 = new V3({\n        ...v3TestConfig,\n        experimental: false,\n      });\n      await v3.init();\n    });\n\n    test.afterEach(async () => {\n      await v3?.close?.().catch(() => {});\n    });\n\n    test(\"throws StagehandInvalidArgumentError when CUA and streaming are both enabled\", async () => {\n      try {\n        v3.agent({\n          cua: true,\n          stream: true,\n          model: \"anthropic/claude-sonnet-4-20250514\",\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(StagehandInvalidArgumentError);\n        expect((error as Error).message).toContain(\"streaming\");\n        expect((error as Error).message).toContain(\"not supported with CUA\");\n      }\n    });\n\n    test(\"throws StagehandInvalidArgumentError for CUA + streaming even with experimental: true\", async () => {\n      // Close the non-experimental instance\n      await v3.close();\n\n      // Create an experimental instance\n      const v3Experimental = new V3({\n        ...v3TestConfig,\n        experimental: true,\n      });\n      await v3Experimental.init();\n\n      try {\n        v3Experimental.agent({\n          cua: true,\n          stream: true,\n          model: \"anthropic/claude-sonnet-4-20250514\",\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(StagehandInvalidArgumentError);\n        expect((error as Error).message).toContain(\"streaming\");\n        expect((error as Error).message).toContain(\"not supported with CUA\");\n      } finally {\n        await v3Experimental.close();\n      }\n    });\n  });\n\n  test.describe(\"Experimental feature errors without experimental: true\", () => {\n    let v3: V3;\n\n    test.beforeEach(async () => {\n      v3 = new V3({\n        ...v3TestConfig,\n        experimental: false,\n      });\n      await v3.init();\n    });\n\n    test.afterEach(async () => {\n      await v3?.close?.().catch(() => {});\n    });\n\n    test(\"throws ExperimentalNotConfiguredError for MCP integrations\", async () => {\n      const agent = v3.agent({\n        model: \"anthropic/claude-sonnet-4-20250514\",\n        integrations: [\"https://mcp.example.com\"],\n      });\n\n      try {\n        await agent.execute(\"test\");\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);\n        expect((error as Error).message).toContain(\n          \"MCP integrations and custom tools\",\n        );\n      }\n    });\n\n    test(\"throws ExperimentalNotConfiguredError for custom tools\", async () => {\n      const agent = v3.agent({\n        model: \"anthropic/claude-sonnet-4-20250514\",\n        tools: {\n          mockCustomTool,\n        },\n      });\n\n      try {\n        await agent.execute(\"test\");\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);\n        expect((error as Error).message).toContain(\n          \"MCP integrations and custom tools\",\n        );\n      }\n    });\n\n    test(\"throws ExperimentalNotConfiguredError for streaming mode\", async () => {\n      try {\n        const agent = v3.agent({\n          stream: true,\n          model: \"anthropic/claude-sonnet-4-20250514\",\n        });\n        await agent.execute(\"test instruction\");\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);\n        expect((error as Error).message).toContain(\"streaming\");\n      }\n    });\n\n    test(\"throws ExperimentalNotConfiguredError for callbacks\", async () => {\n      const agent = v3.agent({\n        model: \"anthropic/claude-sonnet-4-20250514\",\n      });\n\n      try {\n        await agent.execute({\n          instruction: \"test\",\n          callbacks: {\n            onStepFinish: async () => {},\n          },\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);\n        expect((error as Error).message).toContain(\"callbacks\");\n      }\n    });\n\n    test(\"throws ExperimentalNotConfiguredError for abort signal\", async () => {\n      const agent = v3.agent({\n        model: \"anthropic/claude-sonnet-4-20250514\",\n      });\n\n      const controller = new AbortController();\n      try {\n        await agent.execute({\n          instruction: \"test\",\n          signal: controller.signal,\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);\n        expect((error as Error).message).toContain(\"abort signal\");\n      }\n    });\n\n    test(\"throws ExperimentalNotConfiguredError for message continuation\", async () => {\n      const agent = v3.agent({\n        model: \"anthropic/claude-sonnet-4-20250514\",\n      });\n\n      try {\n        await agent.execute({\n          instruction: \"test\",\n          messages: [{ role: \"user\", content: \"previous message\" }],\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);\n        expect((error as Error).message).toContain(\"message continuation\");\n      }\n    });\n\n    test(\"throws ExperimentalNotConfiguredError listing multiple features\", async () => {\n      const agent = v3.agent({\n        model: \"anthropic/claude-sonnet-4-20250514\",\n      });\n\n      const controller = new AbortController();\n      try {\n        await agent.execute({\n          instruction: \"test\",\n          callbacks: { onStepFinish: async () => {} },\n          signal: controller.signal,\n          messages: [{ role: \"user\", content: \"previous\" }],\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);\n        const message = (error as Error).message;\n        expect(message).toContain(\"callbacks\");\n        expect(message).toContain(\"abort signal\");\n        expect(message).toContain(\"message continuation\");\n      }\n    });\n  });\n\n  test.describe(\"CUA agent unsupported features\", () => {\n    let v3: V3;\n\n    test.beforeEach(async () => {\n      v3 = new V3({\n        ...v3TestConfig,\n        experimental: false,\n      });\n      await v3.init();\n    });\n\n    test.afterEach(async () => {\n      await v3?.close?.().catch(() => {});\n    });\n\n    test(\"throws ExperimentalNotConfiguredError for CUA with integrations\", async () => {\n      // MCP integrations are still an experimental feature check (not unsupported)\n      try {\n        v3.agent({\n          cua: true,\n          model: \"anthropic/claude-sonnet-4-20250514\",\n          integrations: [\"https://mcp.example.com\"],\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);\n        expect((error as Error).message).toContain(\n          \"MCP integrations and custom tools\",\n        );\n      }\n    });\n\n    test(\"throws StagehandInvalidArgumentError for CUA with abort signal (not supported)\", async () => {\n      const agent = v3.agent({\n        cua: true,\n        model: \"anthropic/claude-sonnet-4-20250514\",\n      });\n\n      const controller = new AbortController();\n      try {\n        await agent.execute({\n          instruction: \"test\",\n          signal: controller.signal,\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(StagehandInvalidArgumentError);\n        expect((error as Error).message).toContain(\"abort signal\");\n        expect((error as Error).message).toContain(\"not supported with CUA\");\n      }\n    });\n\n    test(\"throws StagehandInvalidArgumentError for CUA with message continuation (not supported)\", async () => {\n      const agent = v3.agent({\n        cua: true,\n        model: \"anthropic/claude-sonnet-4-20250514\",\n      });\n\n      try {\n        await agent.execute({\n          instruction: \"test\",\n          messages: [{ role: \"user\", content: \"previous message\" }],\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(StagehandInvalidArgumentError);\n        expect((error as Error).message).toContain(\"message continuation\");\n        expect((error as Error).message).toContain(\"not supported with CUA\");\n      }\n    });\n\n    test(\"throws StagehandInvalidArgumentError for CUA with multiple unsupported features\", async () => {\n      const agent = v3.agent({\n        cua: true,\n        model: \"anthropic/claude-sonnet-4-20250514\",\n      });\n\n      const controller = new AbortController();\n      try {\n        await agent.execute({\n          instruction: \"test\",\n          signal: controller.signal,\n          messages: [{ role: \"user\", content: \"previous message\" }],\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(StagehandInvalidArgumentError);\n        const message = (error as Error).message;\n        expect(message).toContain(\"abort signal\");\n        expect(message).toContain(\"message continuation\");\n        expect(message).toContain(\"are not supported with CUA\");\n      }\n    });\n\n    test(\"throws StagehandInvalidArgumentError for CUA unsupported features even with experimental: true\", async () => {\n      // Close the non-experimental instance\n      await v3.close();\n\n      // Create an experimental instance\n      const v3Experimental = new V3({\n        ...v3TestConfig,\n        experimental: true,\n      });\n      await v3Experimental.init();\n\n      const agent = v3Experimental.agent({\n        cua: true,\n        model: \"anthropic/claude-sonnet-4-20250514\",\n      });\n\n      const controller = new AbortController();\n      try {\n        await agent.execute({\n          instruction: \"test\",\n          signal: controller.signal,\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(StagehandInvalidArgumentError);\n        expect((error as Error).message).toContain(\"not supported with CUA\");\n      } finally {\n        await v3Experimental.close();\n      }\n    });\n  });\n\n  test.describe(\"Valid configurations with experimental: true\", () => {\n    let v3: V3;\n\n    test.beforeEach(async () => {\n      v3 = new V3({\n        ...v3TestConfig,\n        experimental: true,\n      });\n      await v3.init();\n    });\n\n    test.afterEach(async () => {\n      await v3?.close?.().catch(() => {});\n    });\n\n    test(\"allows CUA without streaming\", () => {\n      expect(() =>\n        v3.agent({\n          cua: true,\n          model: \"anthropic/claude-sonnet-4-20250514\",\n        }),\n      ).not.toThrow();\n    });\n\n    test(\"allows streaming mode\", () => {\n      expect(() =>\n        v3.agent({\n          stream: true,\n          model: \"anthropic/claude-sonnet-4-20250514\",\n        }),\n      ).not.toThrow();\n    });\n\n    test(\"allows basic agent without experimental features\", async () => {\n      const v3NonExperimental = new V3({\n        ...v3TestConfig,\n        experimental: false,\n      });\n      await v3NonExperimental.init();\n\n      try {\n        // This should work - just creating a basic agent with no experimental features\n        expect(() =>\n          v3NonExperimental.agent({\n            model: \"anthropic/claude-sonnet-4-20250514\",\n          }),\n        ).not.toThrow();\n      } finally {\n        await v3NonExperimental.close();\n      }\n    });\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/lib/v3/tests/agent-hybrid-mode.spec.js

@@ -0,0 +1,247 @@
+import { test, expect } from "@playwright/test";
+import { V3 } from "../v3.js";
+import { v3TestConfig } from "./v3.config.js";
+import { createAgentTools } from "../agent/tools/index.js";
+import { buildAgentSystemPrompt } from "../agent/prompts/agentSystemPrompt.js";
+test.describe("Stagehand agent hybrid mode", () => {
+  let v3;
+  test.beforeEach(async () => {
+    v3 = new V3({
+      ...v3TestConfig,
+      experimental: true
+    });
+    await v3.init();
+  });
+  test.afterEach(async () => {
+    await v3?.close?.().catch(() => {
+    });
+  });
+  test.describe("Tool filtering by mode", () => {
+    test("DOM mode includes DOM-based tools and excludes coordinate-based tools", () => {
+      const tools = createAgentTools(v3, { mode: "dom" });
+      expect(tools).toHaveProperty("act");
+      expect(tools).toHaveProperty("fillForm");
+      expect(tools).toHaveProperty("ariaTree");
+      expect(tools).toHaveProperty("screenshot");
+      expect(tools).toHaveProperty("extract");
+      expect(tools).toHaveProperty("goto");
+      expect(tools).toHaveProperty("scroll");
+      expect(tools).toHaveProperty("wait");
+      expect(tools).toHaveProperty("navback");
+      expect(tools).toHaveProperty("keys");
+      expect(tools).toHaveProperty("think");
+      expect(tools).not.toHaveProperty("click");
+      expect(tools).not.toHaveProperty("type");
+      expect(tools).not.toHaveProperty("dragAndDrop");
+      expect(tools).not.toHaveProperty("clickAndHold");
+      expect(tools).not.toHaveProperty("fillFormVision");
+    });
+    test("Hybrid mode includes coordinate-based tools and excludes DOM fillForm", () => {
+      const tools = createAgentTools(v3, { mode: "hybrid" });
+      expect(tools).toHaveProperty("click");
+      expect(tools).toHaveProperty("type");
+      expect(tools).toHaveProperty("dragAndDrop");
+      expect(tools).toHaveProperty("clickAndHold");
+      expect(tools).toHaveProperty("fillFormVision");
+      expect(tools).toHaveProperty("act");
+      expect(tools).toHaveProperty("ariaTree");
+      expect(tools).toHaveProperty("screenshot");
+      expect(tools).toHaveProperty("extract");
+      expect(tools).toHaveProperty("goto");
+      expect(tools).toHaveProperty("scroll");
+      expect(tools).toHaveProperty("wait");
+      expect(tools).toHaveProperty("navback");
+      expect(tools).toHaveProperty("keys");
+      expect(tools).toHaveProperty("think");
+      expect(tools).not.toHaveProperty("fillForm");
+    });
+    test("Default mode is DOM when not specified", () => {
+      const tools = createAgentTools(v3, {});
+      expect(tools).toHaveProperty("fillForm");
+      expect(tools).not.toHaveProperty("click");
+      expect(tools).not.toHaveProperty("type");
+    });
+  });
+  test.describe("System prompt generation", () => {
+    test("DOM mode system prompt emphasizes ariaTree and act tool", () => {
+      const prompt = buildAgentSystemPrompt({
+        url: "https://example.com",
+        executionInstruction: "Test instruction",
+        mode: "dom"
+      });
+      expect(prompt).toContain("ariaTree");
+      expect(prompt).toContain("act");
+      expect(prompt).toContain("fillForm");
+      expect(prompt).toContain("Use act tool for all clicking and typing");
+      expect(prompt).toContain("Always check ariaTree first");
+    });
+    test("Hybrid mode system prompt emphasizes screenshot and coordinate tools", () => {
+      const prompt = buildAgentSystemPrompt({
+        url: "https://example.com",
+        executionInstruction: "Test instruction",
+        mode: "hybrid"
+      });
+      expect(prompt).toContain("click");
+      expect(prompt).toContain("type");
+      expect(prompt).toContain("fillFormVision");
+      expect(prompt).toContain("dragAndDrop");
+      expect(prompt).toContain(
+        "Use specific tools (click, type) when elements are visible"
+      );
+      expect(prompt).toContain("Always use screenshot");
+    });
+    test("System prompt includes custom instructions when provided", () => {
+      const customInstructions = "Always be polite and thorough";
+      const prompt = buildAgentSystemPrompt({
+        url: "https://example.com",
+        executionInstruction: "Test instruction",
+        mode: "dom",
+        systemInstructions: customInstructions
+      });
+      expect(prompt).toContain("customInstructions");
+      expect(prompt).toContain(customInstructions);
+    });
+    test("System prompt includes Browserbase captcha message when isBrowserbase is true", () => {
+      const prompt = buildAgentSystemPrompt({
+        url: "https://example.com",
+        executionInstruction: "Test instruction",
+        mode: "dom",
+        isBrowserbase: true
+      });
+      expect(prompt).toContain("captcha");
+      expect(prompt).toContain("automatically be solved");
+    });
+    test("System prompt does not include captcha message when isBrowserbase is false", () => {
+      const prompt = buildAgentSystemPrompt({
+        url: "https://example.com",
+        executionInstruction: "Test instruction",
+        mode: "dom",
+        isBrowserbase: false
+      });
+      expect(prompt).not.toContain("automatically be solved");
+    });
+  });
+  test.describe("Agent creation with mode", () => {
+    test("agent({ mode: 'dom' }) creates DOM-mode agent", () => {
+      const agent = v3.agent({
+        mode: "dom",
+        model: "anthropic/claude-haiku-4-5-20251001"
+      });
+      expect(agent).toHaveProperty("execute");
+    });
+    test("agent({ mode: 'hybrid' }) creates hybrid-mode agent", () => {
+      const agent = v3.agent({
+        mode: "hybrid",
+        model: "anthropic/claude-haiku-4-5-20251001"
+      });
+      expect(agent).toHaveProperty("execute");
+    });
+    test("agent without mode defaults to DOM mode", () => {
+      const agent = v3.agent({
+        model: "anthropic/claude-haiku-4-5-20251001"
+      });
+      expect(agent).toHaveProperty("execute");
+    });
+    test("hybrid mode can be combined with streaming", () => {
+      const agent = v3.agent({
+        mode: "hybrid",
+        stream: true,
+        model: "anthropic/claude-haiku-4-5-20251001"
+      });
+      expect(agent).toHaveProperty("execute");
+    });
+  });
+  test.describe("Hybrid mode execution", () => {
+    test("hybrid mode agent uses coordinate-based tools when available", async () => {
+      test.setTimeout(9e4);
+      const toolCalls = [];
+      const agent = v3.agent({
+        mode: "hybrid",
+        model: "anthropic/claude-haiku-4-5-20251001"
+      });
+      const page = v3.context.pages()[0];
+      await page.goto("https://example.com");
+      await agent.execute({
+        instruction: "Take a screenshot to see the page, then describe what you see briefly and mark the task as complete.",
+        maxSteps: 5,
+        callbacks: {
+          onStepFinish: async (event) => {
+            if (event.toolCalls) {
+              for (const tc of event.toolCalls) {
+                toolCalls.push({
+                  toolName: tc.toolName,
+                  input: tc.input
+                });
+              }
+            }
+          }
+        }
+      });
+      expect(toolCalls.length).toBeGreaterThan(0);
+      const toolNames = toolCalls.map((tc) => tc.toolName);
+      expect(toolNames).toContain("screenshot");
+    });
+    test("DOM mode agent uses DOM-based tools", async () => {
+      test.setTimeout(9e4);
+      const toolCalls = [];
+      const agent = v3.agent({
+        mode: "dom",
+        model: "anthropic/claude-haiku-4-5-20251001"
+      });
+      const page = v3.context.pages()[0];
+      await page.goto("https://example.com");
+      await agent.execute({
+        instruction: "Use the ariaTree to understand the page, then provide the final requested output or a summary of the page.",
+        maxSteps: 5,
+        callbacks: {
+          onStepFinish: async (event) => {
+            if (event.toolCalls) {
+              for (const tc of event.toolCalls) {
+                toolCalls.push({
+                  toolName: tc.toolName,
+                  input: tc.input
+                });
+              }
+            }
+          }
+        }
+      });
+      expect(toolCalls.length).toBeGreaterThan(0);
+      const toolNames = toolCalls.map((tc) => tc.toolName);
+      expect(toolNames).toContain("ariaTree");
+    });
+  });
+  test.describe("Scroll tool variants by mode", () => {
+    test("DOM mode uses simple scroll tool without coordinates", () => {
+      const tools = createAgentTools(v3, { mode: "dom" });
+      expect(tools).toHaveProperty("scroll");
+      expect(typeof tools.scroll).toBe("object");
+    });
+    test("Hybrid mode uses vision scroll tool with optional coordinates", () => {
+      const tools = createAgentTools(v3, { mode: "hybrid" });
+      expect(tools).toHaveProperty("scroll");
+      expect(typeof tools.scroll).toBe("object");
+    });
+  });
+  test.describe("Keys tool availability in both modes", () => {
+    test("Keys tool is available in DOM mode", () => {
+      const tools = createAgentTools(v3, { mode: "dom" });
+      expect(tools).toHaveProperty("keys");
+    });
+    test("Keys tool is available in hybrid mode", () => {
+      const tools = createAgentTools(v3, { mode: "hybrid" });
+      expect(tools).toHaveProperty("keys");
+    });
+  });
+  test.describe("Think tool availability", () => {
+    test("Think tool is available in DOM mode", () => {
+      const tools = createAgentTools(v3, { mode: "dom" });
+      expect(tools).toHaveProperty("think");
+    });
+    test("Think tool is available in hybrid mode", () => {
+      const tools = createAgentTools(v3, { mode: "hybrid" });
+      expect(tools).toHaveProperty("think");
+    });
+  });
+});
+//# sourceMappingURL=agent-hybrid-mode.spec.js.map