@browserbasehq/orca 3.0.9-alpha-3 → 3.1.0-patch.0

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/agent-hybrid-mode.spec.ts"],
+  "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport { v3TestConfig } from \"./v3.config.js\";\nimport { createAgentTools } from \"../agent/tools/index.js\";\nimport { buildAgentSystemPrompt } from \"../agent/prompts/agentSystemPrompt.js\";\nimport type { StepResult, ToolSet } from \"ai\";\n\ntest.describe(\"Stagehand agent hybrid mode\", () => {\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.describe(\"Tool filtering by mode\", () => {\n    test(\"DOM mode includes DOM-based tools and excludes coordinate-based tools\", () => {\n      const tools = createAgentTools(v3, { mode: \"dom\" });\n\n      // DOM mode should have these tools\n      expect(tools).toHaveProperty(\"act\");\n      expect(tools).toHaveProperty(\"fillForm\");\n      expect(tools).toHaveProperty(\"ariaTree\");\n      expect(tools).toHaveProperty(\"screenshot\");\n      expect(tools).toHaveProperty(\"extract\");\n      expect(tools).toHaveProperty(\"goto\");\n      expect(tools).toHaveProperty(\"scroll\");\n      expect(tools).toHaveProperty(\"wait\");\n      expect(tools).toHaveProperty(\"navback\");\n      expect(tools).toHaveProperty(\"keys\");\n      expect(tools).toHaveProperty(\"think\");\n\n      // DOM mode should NOT have coordinate-based tools\n      expect(tools).not.toHaveProperty(\"click\");\n      expect(tools).not.toHaveProperty(\"type\");\n      expect(tools).not.toHaveProperty(\"dragAndDrop\");\n      expect(tools).not.toHaveProperty(\"clickAndHold\");\n      expect(tools).not.toHaveProperty(\"fillFormVision\");\n    });\n\n    test(\"Hybrid mode includes coordinate-based tools and excludes DOM fillForm\", () => {\n      const tools = createAgentTools(v3, { mode: \"hybrid\" });\n\n      // Hybrid mode should have coordinate-based tools\n      expect(tools).toHaveProperty(\"click\");\n      expect(tools).toHaveProperty(\"type\");\n      expect(tools).toHaveProperty(\"dragAndDrop\");\n      expect(tools).toHaveProperty(\"clickAndHold\");\n      expect(tools).toHaveProperty(\"fillFormVision\");\n\n      // Hybrid mode should also have common tools\n      expect(tools).toHaveProperty(\"act\");\n      expect(tools).toHaveProperty(\"ariaTree\");\n      expect(tools).toHaveProperty(\"screenshot\");\n      expect(tools).toHaveProperty(\"extract\");\n      expect(tools).toHaveProperty(\"goto\");\n      expect(tools).toHaveProperty(\"scroll\");\n      expect(tools).toHaveProperty(\"wait\");\n      expect(tools).toHaveProperty(\"navback\");\n      expect(tools).toHaveProperty(\"keys\");\n      expect(tools).toHaveProperty(\"think\");\n\n      // Hybrid mode should NOT have DOM-based fillForm\n      expect(tools).not.toHaveProperty(\"fillForm\");\n    });\n\n    test(\"Default mode is DOM when not specified\", () => {\n      const tools = createAgentTools(v3, {});\n\n      // Should behave like DOM mode\n      expect(tools).toHaveProperty(\"fillForm\");\n      expect(tools).not.toHaveProperty(\"click\");\n      expect(tools).not.toHaveProperty(\"type\");\n    });\n  });\n\n  test.describe(\"System prompt generation\", () => {\n    test(\"DOM mode system prompt emphasizes ariaTree and act tool\", () => {\n      const prompt = buildAgentSystemPrompt({\n        url: \"https://example.com\",\n        executionInstruction: \"Test instruction\",\n        mode: \"dom\",\n      });\n\n      // DOM mode should prioritize ariaTree\n      expect(prompt).toContain(\"ariaTree\");\n      expect(prompt).toContain(\"act\");\n      expect(prompt).toContain(\"fillForm\");\n\n      // Should have DOM-specific strategy\n      expect(prompt).toContain(\"Use act tool for all clicking and typing\");\n      expect(prompt).toContain(\"Always check ariaTree first\");\n    });\n\n    test(\"Hybrid mode system prompt emphasizes screenshot and coordinate tools\", () => {\n      const prompt = buildAgentSystemPrompt({\n        url: \"https://example.com\",\n        executionInstruction: \"Test instruction\",\n        mode: \"hybrid\",\n      });\n\n      // Hybrid mode should have coordinate-based tools mentioned\n      expect(prompt).toContain(\"click\");\n      expect(prompt).toContain(\"type\");\n      expect(prompt).toContain(\"fillFormVision\");\n      expect(prompt).toContain(\"dragAndDrop\");\n\n      // Should have hybrid-specific strategy\n      expect(prompt).toContain(\n        \"Use specific tools (click, type) when elements are visible\",\n      );\n      expect(prompt).toContain(\"Always use screenshot\");\n    });\n\n    test(\"System prompt includes custom instructions when provided\", () => {\n      const customInstructions = \"Always be polite and thorough\";\n      const prompt = buildAgentSystemPrompt({\n        url: \"https://example.com\",\n        executionInstruction: \"Test instruction\",\n        mode: \"dom\",\n        systemInstructions: customInstructions,\n      });\n\n      expect(prompt).toContain(\"customInstructions\");\n      expect(prompt).toContain(customInstructions);\n    });\n\n    test(\"System prompt includes Browserbase captcha message when isBrowserbase is true\", () => {\n      const prompt = buildAgentSystemPrompt({\n        url: \"https://example.com\",\n        executionInstruction: \"Test instruction\",\n        mode: \"dom\",\n        isBrowserbase: true,\n      });\n\n      expect(prompt).toContain(\"captcha\");\n      expect(prompt).toContain(\"automatically be solved\");\n    });\n\n    test(\"System prompt does not include captcha message when isBrowserbase is false\", () => {\n      const prompt = buildAgentSystemPrompt({\n        url: \"https://example.com\",\n        executionInstruction: \"Test instruction\",\n        mode: \"dom\",\n        isBrowserbase: false,\n      });\n\n      expect(prompt).not.toContain(\"automatically be solved\");\n    });\n  });\n\n  test.describe(\"Agent creation with mode\", () => {\n    test(\"agent({ mode: 'dom' }) creates DOM-mode agent\", () => {\n      const agent = v3.agent({\n        mode: \"dom\",\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      expect(agent).toHaveProperty(\"execute\");\n    });\n\n    test(\"agent({ mode: 'hybrid' }) creates hybrid-mode agent\", () => {\n      const agent = v3.agent({\n        mode: \"hybrid\",\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      expect(agent).toHaveProperty(\"execute\");\n    });\n\n    test(\"agent without mode defaults to DOM mode\", () => {\n      const agent = v3.agent({\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      expect(agent).toHaveProperty(\"execute\");\n    });\n\n    test(\"hybrid mode can be combined with streaming\", () => {\n      const agent = v3.agent({\n        mode: \"hybrid\",\n        stream: true,\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      expect(agent).toHaveProperty(\"execute\");\n    });\n  });\n\n  test.describe(\"Hybrid mode execution\", () => {\n    test(\"hybrid mode agent uses coordinate-based tools when available\", async () => {\n      test.setTimeout(90000);\n\n      const toolCalls: Array<{ toolName: string; input: unknown }> = [];\n\n      const agent = v3.agent({\n        mode: \"hybrid\",\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      const page = v3.context.pages()[0];\n      await page.goto(\"https://example.com\");\n\n      await agent.execute({\n        instruction:\n          \"Take a screenshot to see the page, then describe what you see briefly and mark the task as complete.\",\n        maxSteps: 5,\n        callbacks: {\n          onStepFinish: async (event: StepResult<ToolSet>) => {\n            if (event.toolCalls) {\n              for (const tc of event.toolCalls) {\n                toolCalls.push({\n                  toolName: tc.toolName,\n                  input: tc.input,\n                });\n              }\n            }\n          },\n        },\n      });\n\n      // Should have captured tool calls\n      expect(toolCalls.length).toBeGreaterThan(0);\n\n      const toolNames = toolCalls.map((tc) => tc.toolName);\n      // Should include screenshot (hybrid mode emphasizes visual)\n      expect(toolNames).toContain(\"screenshot\");\n    });\n\n    test(\"DOM mode agent uses DOM-based tools\", async () => {\n      test.setTimeout(90000);\n\n      const toolCalls: Array<{ toolName: string; input: unknown }> = [];\n\n      const agent = v3.agent({\n        mode: \"dom\",\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      const page = v3.context.pages()[0];\n      await page.goto(\"https://example.com\");\n\n      await agent.execute({\n        instruction:\n          \"Use the ariaTree to understand the page, then provide the final requested output or a summary of the page.\",\n        maxSteps: 5,\n        callbacks: {\n          onStepFinish: async (event: StepResult<ToolSet>) => {\n            if (event.toolCalls) {\n              for (const tc of event.toolCalls) {\n                toolCalls.push({\n                  toolName: tc.toolName,\n                  input: tc.input,\n                });\n              }\n            }\n          },\n        },\n      });\n\n      // Should have captured tool calls\n      expect(toolCalls.length).toBeGreaterThan(0);\n\n      // Should include ariaTree (DOM mode emphasizes aria-based interaction)\n      const toolNames = toolCalls.map((tc) => tc.toolName);\n      expect(toolNames).toContain(\"ariaTree\");\n    });\n  });\n\n  test.describe(\"Scroll tool variants by mode\", () => {\n    test(\"DOM mode uses simple scroll tool without coordinates\", () => {\n      const tools = createAgentTools(v3, { mode: \"dom\" });\n\n      expect(tools).toHaveProperty(\"scroll\");\n      // The DOM scroll tool should exist\n      expect(typeof tools.scroll).toBe(\"object\");\n    });\n\n    test(\"Hybrid mode uses vision scroll tool with optional coordinates\", () => {\n      const tools = createAgentTools(v3, { mode: \"hybrid\" });\n\n      expect(tools).toHaveProperty(\"scroll\");\n      // The hybrid scroll tool should exist\n      expect(typeof tools.scroll).toBe(\"object\");\n    });\n  });\n\n  test.describe(\"Keys tool availability in both modes\", () => {\n    test(\"Keys tool is available in DOM mode\", () => {\n      const tools = createAgentTools(v3, { mode: \"dom\" });\n      expect(tools).toHaveProperty(\"keys\");\n    });\n\n    test(\"Keys tool is available in hybrid mode\", () => {\n      const tools = createAgentTools(v3, { mode: \"hybrid\" });\n      expect(tools).toHaveProperty(\"keys\");\n    });\n  });\n\n  test.describe(\"Think tool availability\", () => {\n    test(\"Think tool is available in DOM mode\", () => {\n      const tools = createAgentTools(v3, { mode: \"dom\" });\n      expect(tools).toHaveProperty(\"think\");\n    });\n\n    test(\"Think tool is available in hybrid mode\", () => {\n      const tools = createAgentTools(v3, { mode: \"hybrid\" });\n      expect(tools).toHaveProperty(\"think\");\n    });\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/lib/v3/tests/agent-message-continuation.spec.js

@@ -0,0 +1,105 @@
+import { test, expect } from "@playwright/test";
+import { V3 } from "../v3.js";
+import { v3TestConfig } from "./v3.config.js";
+test.describe("Stagehand agent message continuation", () => {
+  let v3;
+  test.beforeEach(async () => {
+    v3 = new V3({
+      ...v3TestConfig,
+      experimental: true
+    });
+    await v3.init();
+  });
+  test.afterEach(async () => {
+    await v3?.close?.().catch(() => {
+    });
+  });
+  test("execute returns messages in the result", async () => {
+    test.setTimeout(6e4);
+    const agent = v3.agent({
+      model: "anthropic/claude-haiku-4-5-20251001"
+    });
+    const page = v3.context.pages()[0];
+    await page.goto("https://example.com");
+    const result = await agent.execute({
+      instruction: "What is the title of this page? Describe it briefly.",
+      maxSteps: 5
+    });
+    expect(result.messages).toBeDefined();
+    expect(Array.isArray(result.messages)).toBe(true);
+    expect(result.messages.length).toBeGreaterThan(0);
+    const firstMessage = result.messages[0];
+    expect(firstMessage.role).toBe("user");
+  });
+  test("can continue conversation with previous messages", async () => {
+    test.setTimeout(12e4);
+    const agent = v3.agent({
+      model: "anthropic/claude-haiku-4-5-20251001"
+    });
+    const page = v3.context.pages()[0];
+    await page.goto("https://example.com");
+    const result1 = await agent.execute({
+      instruction: "What is the title of this page? Describe it briefly.",
+      maxSteps: 5
+    });
+    expect(result1.messages).toBeDefined();
+    expect(result1.messages.length).toBeGreaterThan(0);
+    const result2 = await agent.execute({
+      instruction: "Based on what you just told me, is this a simple or complex website? Answer briefly.",
+      maxSteps: 5,
+      messages: result1.messages
+    });
+    expect(result2.messages).toBeDefined();
+    expect(result2.messages.length).toBeGreaterThan(result1.messages.length);
+  });
+  test("messages include tool calls and results", async () => {
+    test.setTimeout(6e4);
+    const agent = v3.agent({
+      model: "anthropic/claude-haiku-4-5-20251001"
+    });
+    const page = v3.context.pages()[0];
+    await page.goto("https://example.com");
+    const result = await agent.execute({
+      instruction: "Use the ariaTree tool to see the page, then describe what you found briefly.",
+      maxSteps: 5
+    });
+    expect(result.messages).toBeDefined();
+    const assistantMessages = result.messages.filter(
+      (m) => m.role === "assistant"
+    );
+    expect(assistantMessages.length).toBeGreaterThan(0);
+    const hasToolCalls = assistantMessages.some((m) => {
+      if (Array.isArray(m.content)) {
+        return m.content.some(
+          (part) => typeof part === "object" && part.type === "tool-call"
+        );
+      }
+      return false;
+    });
+    expect(hasToolCalls).toBe(true);
+    const hasToolResults = result.messages.some(
+      (m) => m.role === "tool"
+    );
+    expect(hasToolResults).toBe(true);
+  });
+  test("streaming mode also returns messages", async () => {
+    test.setTimeout(6e4);
+    const agent = v3.agent({
+      stream: true,
+      model: "anthropic/claude-haiku-4-5-20251001"
+    });
+    const page = v3.context.pages()[0];
+    await page.goto("https://example.com");
+    const streamResult = await agent.execute({
+      instruction: "What is this page? Describe it briefly.",
+      maxSteps: 5
+    });
+    for await (const _ of streamResult.textStream) {
+    }
+    const result = await streamResult.result;
+    expect(result.messages).toBeDefined();
+    expect(Array.isArray(result.messages)).toBe(true);
+    expect(result.messages.length).toBeGreaterThan(0);
+  });
+});
+//# sourceMappingURL=agent-message-continuation.spec.js.map

package/dist/esm/lib/v3/tests/agent-message-continuation.spec.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/agent-message-continuation.spec.ts"],
+  "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport { v3TestConfig } from \"./v3.config.js\";\nimport type { ModelMessage } from \"ai\";\n\ntest.describe(\"Stagehand agent message continuation\", () => {\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(\"execute returns messages in the result\", async () => {\n    test.setTimeout(60000);\n\n    const agent = v3.agent({\n      model: \"anthropic/claude-haiku-4-5-20251001\",\n    });\n\n    const page = v3.context.pages()[0];\n    await page.goto(\"https://example.com\");\n\n    const result = await agent.execute({\n      instruction: \"What is the title of this page? Describe it briefly.\",\n      maxSteps: 5,\n    });\n\n    // Result should contain messages\n    expect(result.messages).toBeDefined();\n    expect(Array.isArray(result.messages)).toBe(true);\n    expect(result.messages!.length).toBeGreaterThan(0);\n\n    // First message should be the user instruction\n    const firstMessage = result.messages![0];\n    expect(firstMessage.role).toBe(\"user\");\n  });\n\n  test(\"can continue conversation with previous messages\", async () => {\n    test.setTimeout(120000);\n\n    const agent = v3.agent({\n      model: \"anthropic/claude-haiku-4-5-20251001\",\n    });\n\n    const page = v3.context.pages()[0];\n    await page.goto(\"https://example.com\");\n\n    // First execution\n    const result1 = await agent.execute({\n      instruction: \"What is the title of this page? Describe it briefly.\",\n      maxSteps: 5,\n    });\n\n    expect(result1.messages).toBeDefined();\n    expect(result1.messages!.length).toBeGreaterThan(0);\n\n    // Second execution continuing from first\n    const result2 = await agent.execute({\n      instruction:\n        \"Based on what you just told me, is this a simple or complex website? Answer briefly.\",\n      maxSteps: 5,\n      messages: result1.messages,\n    });\n\n    expect(result2.messages).toBeDefined();\n    // Second result should have more messages (includes first conversation)\n    expect(result2.messages!.length).toBeGreaterThan(result1.messages!.length);\n  });\n\n  test(\"messages include tool calls and results\", async () => {\n    test.setTimeout(60000);\n\n    const agent = v3.agent({\n      model: \"anthropic/claude-haiku-4-5-20251001\",\n    });\n\n    const page = v3.context.pages()[0];\n    await page.goto(\"https://example.com\");\n\n    const result = await agent.execute({\n      instruction:\n        \"Use the ariaTree tool to see the page, then describe what you found briefly.\",\n      maxSteps: 5,\n    });\n\n    expect(result.messages).toBeDefined();\n\n    // Verify there are assistant messages\n    const assistantMessages = result.messages!.filter(\n      (m: ModelMessage) => m.role === \"assistant\",\n    );\n    expect(assistantMessages.length).toBeGreaterThan(0);\n\n    // Verify at least one assistant message contains tool calls\n    const hasToolCalls = assistantMessages.some((m: ModelMessage) => {\n      if (Array.isArray(m.content)) {\n        return m.content.some(\n          (part) => typeof part === \"object\" && part.type === \"tool-call\",\n        );\n      }\n      return false;\n    });\n    expect(hasToolCalls).toBe(true);\n\n    // Verify there are tool result messages\n    const hasToolResults = result.messages!.some(\n      (m: ModelMessage) => m.role === \"tool\",\n    );\n    expect(hasToolResults).toBe(true);\n  });\n\n  test(\"streaming mode also returns messages\", async () => {\n    test.setTimeout(60000);\n\n    const agent = v3.agent({\n      stream: true,\n      model: \"anthropic/claude-haiku-4-5-20251001\",\n    });\n\n    const page = v3.context.pages()[0];\n    await page.goto(\"https://example.com\");\n\n    const streamResult = await agent.execute({\n      instruction: \"What is this page? Describe it briefly.\",\n      maxSteps: 5,\n    });\n\n    // Consume the stream\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    for await (const _ of streamResult.textStream) {\n      // Just consume\n    }\n\n    const result = await streamResult.result;\n\n    // Result should contain messages\n    expect(result.messages).toBeDefined();\n    expect(Array.isArray(result.messages)).toBe(true);\n    expect(result.messages!.length).toBeGreaterThan(0);\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,126 @@
+import { test, expect } from "@playwright/test";
+import { V3 } from "../v3.js";
+import { v3TestConfig } from "./v3.config.js";
+test.describe("Stagehand agent streaming behavior", () => {
+  let v3;
+  test.beforeEach(async () => {
+    v3 = new V3({
+      ...v3TestConfig,
+      experimental: true
+      // Required for streaming
+    });
+    await v3.init();
+  });
+  test.afterEach(async () => {
+    await v3?.close?.().catch(() => {
+    });
+  });
+  test.describe("agent({ stream: true })", () => {
+    test("AgentStreamResult has textStream as async iterable", async () => {
+      test.setTimeout(6e4);
+      const agent = v3.agent({
+        stream: true,
+        model: "anthropic/claude-haiku-4-5-20251001"
+      });
+      const page = v3.context.pages()[0];
+      await page.goto("https://example.com");
+      const streamResult = await agent.execute({
+        instruction: "What is the title of this page? Describe it briefly.",
+        maxSteps: 3
+      });
+      expect(streamResult).toHaveProperty("textStream");
+      expect(streamResult).toHaveProperty("result");
+      expect(typeof streamResult.textStream[Symbol.asyncIterator]).toBe(
+        "function"
+      );
+      expect(streamResult.result).toBeInstanceOf(Promise);
+    });
+    test("textStream yields chunks incrementally", async () => {
+      test.setTimeout(6e4);
+      const agent = v3.agent({
+        stream: true,
+        model: "anthropic/claude-haiku-4-5-20251001"
+      });
+      const page = v3.context.pages()[0];
+      await page.goto("https://example.com");
+      const streamResult = await agent.execute({
+        instruction: "Say hello briefly.",
+        maxSteps: 3
+      });
+      const chunks = [];
+      for await (const chunk of streamResult.textStream) {
+        chunks.push(chunk);
+      }
+      expect(Array.isArray(chunks)).toBe(true);
+      expect(chunks.length).toBeGreaterThan(0);
+    });
+    test("result promise resolves to AgentResult after stream completes", async () => {
+      test.setTimeout(6e4);
+      const agent = v3.agent({
+        stream: true,
+        model: "anthropic/claude-haiku-4-5-20251001"
+      });
+      const page = v3.context.pages()[0];
+      await page.goto("https://example.com");
+      const streamResult = await agent.execute({
+        instruction: "What is this page about? Describe it briefly.",
+        maxSteps: 5
+      });
+      for await (const _ of streamResult.textStream) {
+      }
+      const finalResult = await streamResult.result;
+      expect(finalResult).toHaveProperty("success");
+      expect(finalResult).toHaveProperty("message");
+      expect(finalResult).toHaveProperty("actions");
+      expect(finalResult).toHaveProperty("completed");
+      expect(typeof finalResult.success).toBe("boolean");
+      expect(typeof finalResult.message).toBe("string");
+      expect(Array.isArray(finalResult.actions)).toBe(true);
+    });
+  });
+  test.describe("agent({ stream: false }) or agent()", () => {
+    test("execute returns AgentResult without streaming properties", async () => {
+      test.setTimeout(6e4);
+      const agent = v3.agent({
+        model: "anthropic/claude-haiku-4-5-20251001"
+      });
+      const page = v3.context.pages()[0];
+      await page.goto("https://example.com");
+      const result = await agent.execute({
+        instruction: "What is this page? Describe it briefly.",
+        maxSteps: 3
+      });
+      expect(result).toHaveProperty("success");
+      expect(result).toHaveProperty("message");
+      expect(result).toHaveProperty("actions");
+      expect(result).toHaveProperty("completed");
+      expect(result).not.toHaveProperty("textStream");
+    });
+  });
+  test.describe("CUA disables streaming", () => {
+    test("throws StagehandInvalidArgumentError when cua: true and stream: true", () => {
+      expect(() => {
+        v3.agent({
+          cua: true,
+          stream: true,
+          model: "anthropic/claude-haiku-4-5-20251001"
+        });
+      }).toThrow("streaming is not supported with CUA");
+    });
+    test("allows cua: true without stream", () => {
+      const agent = v3.agent({
+        cua: true,
+        model: "anthropic/claude-haiku-4-5-20251001"
+      });
+      expect(agent).toHaveProperty("execute");
+    });
+    test("allows stream: true without cua", () => {
+      const agent = v3.agent({
+        stream: true,
+        model: "anthropic/claude-haiku-4-5-20251001"
+      });
+      expect(agent).toHaveProperty("execute");
+    });
+  });
+});
+//# sourceMappingURL=agent-streaming.spec.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/agent-streaming.spec.ts"],
+  "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport { v3TestConfig } from \"./v3.config.js\";\nimport type { AgentResult } from \"../types/public/agent.js\";\n\ntest.describe(\"Stagehand agent streaming behavior\", () => {\n  let v3: V3;\n\n  test.beforeEach(async () => {\n    v3 = new V3({\n      ...v3TestConfig,\n      experimental: true, // Required for streaming\n    });\n    await v3.init();\n  });\n\n  test.afterEach(async () => {\n    await v3?.close?.().catch(() => {});\n  });\n\n  test.describe(\"agent({ stream: true })\", () => {\n    test(\"AgentStreamResult has textStream as async iterable\", async () => {\n      test.setTimeout(60000);\n\n      const agent = v3.agent({\n        stream: true,\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      // Navigate to a simple page first\n      const page = v3.context.pages()[0];\n      await page.goto(\"https://example.com\");\n\n      const streamResult = await agent.execute({\n        instruction: \"What is the title of this page? Describe it briefly.\",\n        maxSteps: 3,\n      });\n\n      // Verify it's an AgentStreamResult with streaming capabilities\n      expect(streamResult).toHaveProperty(\"textStream\");\n      expect(streamResult).toHaveProperty(\"result\");\n\n      // textStream should be async iterable\n      expect(typeof streamResult.textStream[Symbol.asyncIterator]).toBe(\n        \"function\",\n      );\n\n      // result should be a promise\n      expect(streamResult.result).toBeInstanceOf(Promise);\n    });\n\n    test(\"textStream yields chunks incrementally\", async () => {\n      test.setTimeout(60000);\n\n      const agent = v3.agent({\n        stream: true,\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      const page = v3.context.pages()[0];\n      await page.goto(\"https://example.com\");\n\n      const streamResult = await agent.execute({\n        instruction: \"Say hello briefly.\",\n        maxSteps: 3,\n      });\n\n      // Collect chunks from the stream\n      const chunks: string[] = [];\n      for await (const chunk of streamResult.textStream) {\n        chunks.push(chunk);\n      }\n\n      // Should have received at least some chunks (streaming behavior)\n      // The exact content depends on the LLM response\n      expect(Array.isArray(chunks)).toBe(true);\n      expect(chunks.length).toBeGreaterThan(0);\n    });\n\n    test(\"result promise resolves to AgentResult after stream completes\", async () => {\n      test.setTimeout(60000);\n\n      const agent = v3.agent({\n        stream: true,\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      const page = v3.context.pages()[0];\n      await page.goto(\"https://example.com\");\n\n      const streamResult = await agent.execute({\n        instruction: \"What is this page about? Describe it briefly.\",\n        maxSteps: 5,\n      });\n\n      // Consume the stream first\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      for await (const _ of streamResult.textStream) {\n        // Just consume\n      }\n\n      // Now get the final result\n      const finalResult: AgentResult = await streamResult.result;\n\n      // Verify it's a proper AgentResult\n      expect(finalResult).toHaveProperty(\"success\");\n      expect(finalResult).toHaveProperty(\"message\");\n      expect(finalResult).toHaveProperty(\"actions\");\n      expect(finalResult).toHaveProperty(\"completed\");\n      expect(typeof finalResult.success).toBe(\"boolean\");\n      expect(typeof finalResult.message).toBe(\"string\");\n      expect(Array.isArray(finalResult.actions)).toBe(true);\n    });\n  });\n\n  test.describe(\"agent({ stream: false }) or agent()\", () => {\n    test(\"execute returns AgentResult without streaming properties\", async () => {\n      test.setTimeout(60000);\n\n      const agent = v3.agent({\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      const page = v3.context.pages()[0];\n      await page.goto(\"https://example.com\");\n\n      const result = await agent.execute({\n        instruction: \"What is this page? Describe it briefly.\",\n        maxSteps: 3,\n      });\n      // Should be AgentResult, not AgentStreamResult\n      expect(result).toHaveProperty(\"success\");\n      expect(result).toHaveProperty(\"message\");\n      expect(result).toHaveProperty(\"actions\");\n      expect(result).toHaveProperty(\"completed\");\n\n      // Should NOT have streaming properties\n      expect(result).not.toHaveProperty(\"textStream\");\n    });\n  });\n\n  test.describe(\"CUA disables streaming\", () => {\n    test(\"throws StagehandInvalidArgumentError when cua: true and stream: true\", () => {\n      expect(() => {\n        v3.agent({\n          cua: true,\n          stream: true,\n          model: \"anthropic/claude-haiku-4-5-20251001\",\n        });\n      }).toThrow(\"streaming is not supported with CUA\");\n    });\n\n    test(\"allows cua: true without stream\", () => {\n      // Should not throw\n      const agent = v3.agent({\n        cua: true,\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      expect(agent).toHaveProperty(\"execute\");\n    });\n\n    test(\"allows stream: true without cua\", () => {\n      // Should not throw\n      const agent = v3.agent({\n        stream: true,\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      expect(agent).toHaveProperty(\"execute\");\n    });\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/lib/v3/tests/cdp-session-detached.spec.js

@@ -0,0 +1,44 @@
+import { test, expect } from "@playwright/test";
+import { chromium as playwrightChromium } from "playwright";
+import { V3 } from "../v3.js";
+import { v3TestConfig } from "./v3.config.js";
+test.describe("CDP session detach handling", () => {
+  let v3;
+  test.beforeEach(async () => {
+    v3 = new V3(v3TestConfig);
+    await v3.init();
+  });
+  test.afterEach(async () => {
+    await v3?.close?.().catch(() => {
+    });
+  });
+  test("rejects inflight CDP calls when a target is closed", async () => {
+    const unhandled = [];
+    const onUnhandled = (reason) => {
+      unhandled.push(reason);
+    };
+    process.on("unhandledRejection", onUnhandled);
+    let pwBrowser = null;
+    try {
+      pwBrowser = await playwrightChromium.connectOverCDP(v3.connectURL());
+      const pwContext = pwBrowser.contexts()[0];
+      const pwPage = pwContext.pages()[0];
+      const v3Page = v3.context.pages()[0];
+      await v3Page.goto("data:text/html,<html><body>cdp</body></html>");
+      const pending = v3Page.sendCDP("Runtime.evaluate", {
+        expression: "new Promise(r => setTimeout(() => r('done'), 5000))",
+        awaitPromise: true,
+        returnByValue: true
+      });
+      await pwPage.close();
+      await expect(pending).rejects.toThrow(/CDP session detached/);
+      await new Promise((r) => setTimeout(r, 50));
+      expect(unhandled).toHaveLength(0);
+    } finally {
+      process.off("unhandledRejection", onUnhandled);
+      await pwBrowser?.close().catch(() => {
+      });
+    }
+  });
+});
+//# sourceMappingURL=cdp-session-detached.spec.js.map

package/dist/esm/lib/v3/tests/cdp-session-detached.spec.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/cdp-session-detached.spec.ts"],
+  "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { chromium as playwrightChromium } from \"playwright\";\nimport { V3 } from \"../v3.js\";\nimport { v3TestConfig } from \"./v3.config.js\";\n\ntest.describe(\"CDP session detach handling\", () => {\n  let v3: V3;\n\n  test.beforeEach(async () => {\n    v3 = new V3(v3TestConfig);\n    await v3.init();\n  });\n\n  test.afterEach(async () => {\n    await v3?.close?.().catch(() => {});\n  });\n\n  test(\"rejects inflight CDP calls when a target is closed\", async () => {\n    const unhandled: unknown[] = [];\n    const onUnhandled = (reason: unknown) => {\n      unhandled.push(reason);\n    };\n\n    process.on(\"unhandledRejection\", onUnhandled);\n\n    let pwBrowser: Awaited<\n      ReturnType<typeof playwrightChromium.connectOverCDP>\n    > | null = null;\n\n    try {\n      pwBrowser = await playwrightChromium.connectOverCDP(v3.connectURL());\n      const pwContext = pwBrowser.contexts()[0];\n      const pwPage = pwContext.pages()[0];\n\n      const v3Page = v3.context.pages()[0];\n      await v3Page.goto(\"data:text/html,<html><body>cdp</body></html>\");\n\n      const pending = v3Page.sendCDP(\"Runtime.evaluate\", {\n        expression: \"new Promise(r => setTimeout(() => r('done'), 5000))\",\n        awaitPromise: true,\n        returnByValue: true,\n      });\n\n      await pwPage.close();\n\n      await expect(pending).rejects.toThrow(/CDP session detached/);\n\n      await new Promise((r) => setTimeout(r, 50));\n      expect(unhandled).toHaveLength(0);\n    } finally {\n      process.off(\"unhandledRejection\", onUnhandled);\n      await pwBrowser?.close().catch(() => {});\n    }\n  });\n});\n"],
+  "mappings": "AAAA,SAAS,MAAM,cAAc;AAC7B,SAAS,YAAY,0BAA0B;AAC/C,SAAS,UAAU;AACnB,SAAS,oBAAoB;AAE7B,KAAK,SAAS,+BAA+B,MAAM;AACjD,MAAI;AAEJ,OAAK,WAAW,YAAY;AAC1B,SAAK,IAAI,GAAG,YAAY;AACxB,UAAM,GAAG,KAAK;AAAA,EAChB,CAAC;AAED,OAAK,UAAU,YAAY;AACzB,UAAM,IAAI,QAAQ,EAAE,MAAM,MAAM;AAAA,IAAC,CAAC;AAAA,EACpC,CAAC;AAED,OAAK,sDAAsD,YAAY;AACrE,UAAM,YAAuB,CAAC;AAC9B,UAAM,cAAc,CAAC,WAAoB;AACvC,gBAAU,KAAK,MAAM;AAAA,IACvB;AAEA,YAAQ,GAAG,sBAAsB,WAAW;AAE5C,QAAI,YAEO;AAEX,QAAI;AACF,kBAAY,MAAM,mBAAmB,eAAe,GAAG,WAAW,CAAC;AACnE,YAAM,YAAY,UAAU,SAAS,EAAE,CAAC;AACxC,YAAM,SAAS,UAAU,MAAM,EAAE,CAAC;AAElC,YAAM,SAAS,GAAG,QAAQ,MAAM,EAAE,CAAC;AACnC,YAAM,OAAO,KAAK,8CAA8C;AAEhE,YAAM,UAAU,OAAO,QAAQ,oBAAoB;AAAA,QACjD,YAAY;AAAA,QACZ,cAAc;AAAA,QACd,eAAe;AAAA,MACjB,CAAC;AAED,YAAM,OAAO,MAAM;AAEnB,YAAM,OAAO,OAAO,EAAE,QAAQ,QAAQ,sBAAsB;AAE5D,YAAM,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAC1C,aAAO,SAAS,EAAE,aAAa,CAAC;AAAA,IAClC,UAAE;AACA,cAAQ,IAAI,sBAAsB,WAAW;AAC7C,YAAM,WAAW,MAAM,EAAE,MAAM,MAAM;AAAA,MAAC,CAAC;AAAA,IACzC;AAAA,EACF,CAAC;AACH,CAAC;",
+  "names": []
+}

package/dist/esm/lib/v3/tests/click-count.spec.js

@@ -0,0 +1,112 @@
+import { test, expect } from "@playwright/test";
+import { V3 } from "../v3.js";
+import { v3TestConfig } from "./v3.config.js";
+test.describe("Locator and Page click methods", () => {
+  let v3;
+  test.beforeEach(async () => {
+    v3 = new V3(v3TestConfig);
+    await v3.init();
+  });
+  test.afterEach(async () => {
+    await v3?.close?.().catch(() => {
+    });
+  });
+  test("locator.click() performs single click by default", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "https://browserbase.github.io/stagehand-eval-sites/sites/click-test/"
+    );
+    await page.waitForLoadState("domcontentloaded");
+    const countDisplay = page.locator("#count");
+    const initialCount = await countDisplay.inputValue();
+    expect(initialCount).toBe("0");
+    const clickArea = page.locator("#textarea");
+    await clickArea.click();
+    const newCount = await countDisplay.inputValue();
+    expect(newCount).toBe("1");
+  });
+  test("locator.click() with clickCount: 2 performs double-click", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "https://browserbase.github.io/stagehand-eval-sites/sites/click-test/"
+    );
+    await page.waitForLoadState("domcontentloaded");
+    const countDisplay = page.locator("#count");
+    const dcCountDisplay = page.locator("#dcCount");
+    const initialCount = await countDisplay.inputValue();
+    const initialDcCount = await dcCountDisplay.inputValue();
+    expect(initialCount).toBe("0");
+    expect(initialDcCount).toBe("0");
+    const clickArea = page.locator("#textarea");
+    await clickArea.click({ clickCount: 2 });
+    const newCount = await countDisplay.inputValue();
+    expect(newCount).toBe("2");
+    const newDcCount = await dcCountDisplay.inputValue();
+    expect(newDcCount).toBe("1");
+  });
+  test("locator.click() with clickCount: 3 performs triple-click", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "https://browserbase.github.io/stagehand-eval-sites/sites/click-test/"
+    );
+    await page.waitForLoadState("domcontentloaded");
+    const countDisplay = page.locator("#count");
+    const initialCount = await countDisplay.inputValue();
+    expect(initialCount).toBe("0");
+    const clickArea = page.locator("#textarea");
+    await clickArea.click({ clickCount: 3 });
+    const newCount = await countDisplay.inputValue();
+    expect(newCount).toBe("3");
+  });
+  test("page.click() performs single click with coordinates", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "https://browserbase.github.io/stagehand-eval-sites/sites/click-test/"
+    );
+    await page.waitForLoadState("domcontentloaded");
+    const countDisplay = page.locator("#count");
+    const initialCount = await countDisplay.inputValue();
+    expect(initialCount).toBe("0");
+    const clickArea = page.locator("#textarea");
+    const { x, y } = await clickArea.centroid();
+    await page.click(x, y);
+    const newCount = await countDisplay.inputValue();
+    expect(newCount).toBe("1");
+  });
+  test("page.click() with clickCount: 2 performs double-click", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "https://browserbase.github.io/stagehand-eval-sites/sites/click-test/"
+    );
+    await page.waitForLoadState("domcontentloaded");
+    const countDisplay = page.locator("#count");
+    const dcCountDisplay = page.locator("#dcCount");
+    const initialCount = await countDisplay.inputValue();
+    const initialDcCount = await dcCountDisplay.inputValue();
+    expect(initialCount).toBe("0");
+    expect(initialDcCount).toBe("0");
+    const clickArea = page.locator("#textarea");
+    const { x, y } = await clickArea.centroid();
+    await page.click(x, y, { clickCount: 2 });
+    const newCount = await countDisplay.inputValue();
+    expect(newCount).toBe("2");
+    const newDcCount = await dcCountDisplay.inputValue();
+    expect(newDcCount).toBe("1");
+  });
+  test("page.click() with clickCount: 3 performs triple-click", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "https://browserbase.github.io/stagehand-eval-sites/sites/click-test/"
+    );
+    await page.waitForLoadState("domcontentloaded");
+    const countDisplay = page.locator("#count");
+    const initialCount = await countDisplay.inputValue();
+    expect(initialCount).toBe("0");
+    const clickArea = page.locator("#textarea");
+    const { x, y } = await clickArea.centroid();
+    await page.click(x, y, { clickCount: 3 });
+    const newCount = await countDisplay.inputValue();
+    expect(newCount).toBe("3");
+  });
+});
+//# sourceMappingURL=click-count.spec.js.map

package/dist/esm/lib/v3/tests/click-count.spec.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/click-count.spec.ts"],
+  "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport { v3TestConfig } from \"./v3.config.js\";\n\ntest.describe(\"Locator and Page click methods\", () => {\n  let v3: V3;\n\n  test.beforeEach(async () => {\n    v3 = new V3(v3TestConfig);\n    await v3.init();\n  });\n\n  test.afterEach(async () => {\n    await v3?.close?.().catch(() => {});\n  });\n\n  test(\"locator.click() performs single click by default\", async () => {\n    const page = v3.context.pages()[0];\n    await page.goto(\n      \"https://browserbase.github.io/stagehand-eval-sites/sites/click-test/\",\n    );\n\n    // Wait for page to be fully loaded\n    await page.waitForLoadState(\"domcontentloaded\");\n\n    // Get initial count\n    const countDisplay = page.locator(\"#count\");\n    const initialCount = await countDisplay.inputValue();\n    expect(initialCount).toBe(\"0\");\n\n    // Perform single click on the textarea (the clickable area)\n    const clickArea = page.locator(\"#textarea\");\n    await clickArea.click();\n\n    // Verify count incremented by 1\n    const newCount = await countDisplay.inputValue();\n    expect(newCount).toBe(\"1\");\n  });\n\n  test(\"locator.click() with clickCount: 2 performs double-click\", async () => {\n    const page = v3.context.pages()[0];\n    await page.goto(\n      \"https://browserbase.github.io/stagehand-eval-sites/sites/click-test/\",\n    );\n\n    // Wait for page to be fully loaded\n    await page.waitForLoadState(\"domcontentloaded\");\n\n    // Get initial counts\n    const countDisplay = page.locator(\"#count\");\n    const dcCountDisplay = page.locator(\"#dcCount\");\n\n    const initialCount = await countDisplay.inputValue();\n    const initialDcCount = await dcCountDisplay.inputValue();\n    expect(initialCount).toBe(\"0\");\n    expect(initialDcCount).toBe(\"0\");\n\n    // Perform double-click on the textarea\n    const clickArea = page.locator(\"#textarea\");\n    await clickArea.click({ clickCount: 2 });\n\n    // Verify both counters incremented\n    // Regular count should be 2 (one for each click in the double-click)\n    const newCount = await countDisplay.inputValue();\n    expect(newCount).toBe(\"2\");\n\n    // Double-click count should be 1 (one double-click event detected)\n    const newDcCount = await dcCountDisplay.inputValue();\n    expect(newDcCount).toBe(\"1\");\n  });\n\n  test(\"locator.click() with clickCount: 3 performs triple-click\", async () => {\n    const page = v3.context.pages()[0];\n    await page.goto(\n      \"https://browserbase.github.io/stagehand-eval-sites/sites/click-test/\",\n    );\n\n    // Wait for page to be fully loaded\n    await page.waitForLoadState(\"domcontentloaded\");\n\n    const countDisplay = page.locator(\"#count\");\n    const initialCount = await countDisplay.inputValue();\n    expect(initialCount).toBe(\"0\");\n\n    // Perform triple-click on the textarea\n    const clickArea = page.locator(\"#textarea\");\n    await clickArea.click({ clickCount: 3 });\n\n    // Verify count incremented by 3\n    const newCount = await countDisplay.inputValue();\n    expect(newCount).toBe(\"3\");\n  });\n\n  test(\"page.click() performs single click with coordinates\", async () => {\n    const page = v3.context.pages()[0];\n    await page.goto(\n      \"https://browserbase.github.io/stagehand-eval-sites/sites/click-test/\",\n    );\n\n    // Wait for page to be fully loaded\n    await page.waitForLoadState(\"domcontentloaded\");\n\n    // Get initial count\n    const countDisplay = page.locator(\"#count\");\n    const initialCount = await countDisplay.inputValue();\n    expect(initialCount).toBe(\"0\");\n\n    // Get the centroid of the textarea to click\n    const clickArea = page.locator(\"#textarea\");\n    const { x, y } = await clickArea.centroid();\n\n    // Perform single click using page.click() with coordinates\n    await page.click(x, y);\n\n    // Verify count incremented by 1\n    const newCount = await countDisplay.inputValue();\n    expect(newCount).toBe(\"1\");\n  });\n\n  test(\"page.click() with clickCount: 2 performs double-click\", async () => {\n    const page = v3.context.pages()[0];\n    await page.goto(\n      \"https://browserbase.github.io/stagehand-eval-sites/sites/click-test/\",\n    );\n\n    // Wait for page to be fully loaded\n    await page.waitForLoadState(\"domcontentloaded\");\n\n    // Get initial counts\n    const countDisplay = page.locator(\"#count\");\n    const dcCountDisplay = page.locator(\"#dcCount\");\n\n    const initialCount = await countDisplay.inputValue();\n    const initialDcCount = await dcCountDisplay.inputValue();\n    expect(initialCount).toBe(\"0\");\n    expect(initialDcCount).toBe(\"0\");\n\n    // Get the centroid of the textarea to click\n    const clickArea = page.locator(\"#textarea\");\n    const { x, y } = await clickArea.centroid();\n\n    // Perform double-click using page.click() with coordinates\n    await page.click(x, y, { clickCount: 2 });\n\n    // Verify both counters incremented\n    const newCount = await countDisplay.inputValue();\n    expect(newCount).toBe(\"2\");\n\n    // Double-click count should be 1\n    const newDcCount = await dcCountDisplay.inputValue();\n    expect(newDcCount).toBe(\"1\");\n  });\n\n  test(\"page.click() with clickCount: 3 performs triple-click\", async () => {\n    const page = v3.context.pages()[0];\n    await page.goto(\n      \"https://browserbase.github.io/stagehand-eval-sites/sites/click-test/\",\n    );\n\n    // Wait for page to be fully loaded\n    await page.waitForLoadState(\"domcontentloaded\");\n\n    const countDisplay = page.locator(\"#count\");\n    const initialCount = await countDisplay.inputValue();\n    expect(initialCount).toBe(\"0\");\n\n    // Get the centroid of the textarea to click\n    const clickArea = page.locator(\"#textarea\");\n    const { x, y } = await clickArea.centroid();\n\n    // Perform triple-click using page.click() with coordinates\n    await page.click(x, y, { clickCount: 3 });\n\n    // Verify count incremented by 3\n    const newCount = await countDisplay.inputValue();\n    expect(newCount).toBe(\"3\");\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/lib/v3/tests/connect-to-existing-browser.spec.js

@@ -0,0 +1,54 @@
+import { test, expect } from "@playwright/test";
+import { V3 } from "../v3.js";
+import { v3DynamicTestConfig } from "./v3.dynamic.config.js";
+import { closeV3 } from "./testUtils.js";
+const PAGE_TARGET_COUNT = 5;
+test.describe("connect to existing Browserbase session", () => {
+  test("new Stagehand instance reuses an existing Browserbase session", async () => {
+    const browserTarget = (process.env.STAGEHAND_BROWSER_TARGET ?? "local").toLowerCase();
+    const isBrowserbase = browserTarget === "browserbase";
+    test.skip(!isBrowserbase, "Requires STAGEHAND_BROWSER_TARGET=browserbase");
+    test.skip(
+      !process.env.BROWSERBASE_API_KEY || !process.env.BROWSERBASE_PROJECT_ID,
+      "BROWSERBASE credentials are required"
+    );
+    const initialStagehand = new V3({
+      ...v3DynamicTestConfig,
+      disableAPI: true
+    });
+    await initialStagehand.init();
+    let resumedStagehand = null;
+    try {
+      const ctx = initialStagehand.context;
+      const initialPage = ctx.pages()[0];
+      expect(initialPage).toBeDefined();
+      for (let i = 0; i < PAGE_TARGET_COUNT; i++) {
+        await ctx.newPage(`https://example.com/?tab=${i}`);
+      }
+      await initialPage?.close();
+      await expect.poll(() => ctx.pages().length, { timeout: 15e3 }).toBe(PAGE_TARGET_COUNT);
+      const sessionUrl = initialStagehand.connectURL();
+      expect(sessionUrl).toBeTruthy();
+      resumedStagehand = new V3({
+        env: "LOCAL",
+        verbose: 0,
+        disablePino: true,
+        disableAPI: true,
+        logger: v3DynamicTestConfig.logger,
+        localBrowserLaunchOptions: {
+          cdpUrl: sessionUrl
+        }
+      });
+      await resumedStagehand.init();
+      await expect.poll(() => resumedStagehand.context.pages().length, {
+        timeout: 15e3
+      }).toBe(PAGE_TARGET_COUNT);
+      const resumedPagesCount = resumedStagehand.context.pages().length;
+      expect(resumedPagesCount).toBe(PAGE_TARGET_COUNT);
+    } finally {
+      await closeV3(resumedStagehand);
+      await closeV3(initialStagehand);
+    }
+  });
+});
+//# sourceMappingURL=connect-to-existing-browser.spec.js.map

package/dist/esm/lib/v3/tests/connect-to-existing-browser.spec.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/connect-to-existing-browser.spec.ts"],
+  "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport { v3DynamicTestConfig } from \"./v3.dynamic.config.js\";\nimport { closeV3 } from \"./testUtils.js\";\n\nconst PAGE_TARGET_COUNT = 5;\n\ntest.describe(\"connect to existing Browserbase session\", () => {\n  test(\"new Stagehand instance reuses an existing Browserbase session\", async () => {\n    const browserTarget = (\n      process.env.STAGEHAND_BROWSER_TARGET ?? \"local\"\n    ).toLowerCase();\n    const isBrowserbase = browserTarget === \"browserbase\";\n    test.skip(!isBrowserbase, \"Requires STAGEHAND_BROWSER_TARGET=browserbase\");\n    test.skip(\n      !process.env.BROWSERBASE_API_KEY || !process.env.BROWSERBASE_PROJECT_ID,\n      \"BROWSERBASE credentials are required\",\n    );\n\n    const initialStagehand = new V3({\n      ...v3DynamicTestConfig,\n      disableAPI: true,\n    });\n    await initialStagehand.init();\n\n    let resumedStagehand: V3 | null = null;\n\n    try {\n      const ctx = initialStagehand.context;\n      const initialPage = ctx.pages()[0];\n      expect(initialPage).toBeDefined();\n\n      for (let i = 0; i < PAGE_TARGET_COUNT; i++) {\n        await ctx.newPage(`https://example.com/?tab=${i}`);\n      }\n\n      await initialPage?.close();\n      await expect\n        .poll(() => ctx.pages().length, { timeout: 15_000 })\n        .toBe(PAGE_TARGET_COUNT);\n\n      const sessionUrl = initialStagehand.connectURL();\n      expect(sessionUrl).toBeTruthy();\n\n      resumedStagehand = new V3({\n        env: \"LOCAL\",\n        verbose: 0,\n        disablePino: true,\n        disableAPI: true,\n        logger: v3DynamicTestConfig.logger,\n        localBrowserLaunchOptions: {\n          cdpUrl: sessionUrl,\n        },\n      });\n      await resumedStagehand.init();\n\n      await expect\n        .poll(() => resumedStagehand!.context.pages().length, {\n          timeout: 15_000,\n        })\n        .toBe(PAGE_TARGET_COUNT);\n\n      const resumedPagesCount = resumedStagehand.context.pages().length;\n      expect(resumedPagesCount).toBe(PAGE_TARGET_COUNT);\n    } finally {\n      await closeV3(resumedStagehand);\n      await closeV3(initialStagehand);\n    }\n  });\n});\n"],
+  "mappings": "AAAA,SAAS,MAAM,cAAc;AAC7B,SAAS,UAAU;AACnB,SAAS,2BAA2B;AACpC,SAAS,eAAe;AAExB,MAAM,oBAAoB;AAE1B,KAAK,SAAS,2CAA2C,MAAM;AAC7D,OAAK,iEAAiE,YAAY;AAChF,UAAM,iBACJ,QAAQ,IAAI,4BAA4B,SACxC,YAAY;AACd,UAAM,gBAAgB,kBAAkB;AACxC,SAAK,KAAK,CAAC,eAAe,+CAA+C;AACzE,SAAK;AAAA,MACH,CAAC,QAAQ,IAAI,uBAAuB,CAAC,QAAQ,IAAI;AAAA,MACjD;AAAA,IACF;AAEA,UAAM,mBAAmB,IAAI,GAAG;AAAA,MAC9B,GAAG;AAAA,MACH,YAAY;AAAA,IACd,CAAC;AACD,UAAM,iBAAiB,KAAK;AAE5B,QAAI,mBAA8B;AAElC,QAAI;AACF,YAAM,MAAM,iBAAiB;AAC7B,YAAM,cAAc,IAAI,MAAM,EAAE,CAAC;AACjC,aAAO,WAAW,EAAE,YAAY;AAEhC,eAAS,IAAI,GAAG,IAAI,mBAAmB,KAAK;AAC1C,cAAM,IAAI,QAAQ,4BAA4B,CAAC,EAAE;AAAA,MACnD;AAEA,YAAM,aAAa,MAAM;AACzB,YAAM,OACH,KAAK,MAAM,IAAI,MAAM,EAAE,QAAQ,EAAE,SAAS,KAAO,CAAC,EAClD,KAAK,iBAAiB;AAEzB,YAAM,aAAa,iBAAiB,WAAW;AAC/C,aAAO,UAAU,EAAE,WAAW;AAE9B,yBAAmB,IAAI,GAAG;AAAA,QACxB,KAAK;AAAA,QACL,SAAS;AAAA,QACT,aAAa;AAAA,QACb,YAAY;AAAA,QACZ,QAAQ,oBAAoB;AAAA,QAC5B,2BAA2B;AAAA,UACzB,QAAQ;AAAA,QACV;AAAA,MACF,CAAC;AACD,YAAM,iBAAiB,KAAK;AAE5B,YAAM,OACH,KAAK,MAAM,iBAAkB,QAAQ,MAAM,EAAE,QAAQ;AAAA,QACpD,SAAS;AAAA,MACX,CAAC,EACA,KAAK,iBAAiB;AAEzB,YAAM,oBAAoB,iBAAiB,QAAQ,MAAM,EAAE;AAC3D,aAAO,iBAAiB,EAAE,KAAK,iBAAiB;AAAA,IAClD,UAAE;AACA,YAAM,QAAQ,gBAAgB;AAC9B,YAAM,QAAQ,gBAAgB;AAAA,IAChC;AAAA,EACF,CAAC;AACH,CAAC;",
+  "names": []
+}