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

package/dist/esm/lib/v3/tests/shadow-iframe-oopif.spec.js

@@ -0,0 +1,134 @@
+import { test, expect } from "@playwright/test";
+import { V3 } from "../v3.js";
+import puppeteer from "puppeteer-core";
+import { chromium as playwrightChromium } from "playwright";
+import { chromium as patchrightChromium } from "patchright-core";
+import { v3DynamicTestConfig } from "./v3.dynamic.config.js";
+import { closeV3 } from "./testUtils.js";
+async function runCase(v3, c, framework) {
+  let cleanup = null;
+  let page;
+  if (framework === "v3") {
+    page = v3.context.pages()[0];
+    await page.goto(c.url, { waitUntil: "networkidle" });
+  } else if (framework === "puppeteer") {
+    const browser = await puppeteer.connect({
+      browserWSEndpoint: v3.connectURL(),
+      defaultViewport: null
+    });
+    const pages = await browser.pages();
+    page = pages[0];
+    await page.goto(c.url, { waitUntil: "networkidle0" });
+    cleanup = async () => {
+      try {
+        await browser.close();
+      } catch {
+      }
+    };
+  } else if (framework === "playwright") {
+    const pwBrowser = await playwrightChromium.connectOverCDP(v3.connectURL());
+    const pwContext = pwBrowser.contexts()[0];
+    page = pwContext.pages()[0];
+    await page.goto(c.url, { waitUntil: "networkidle" });
+    cleanup = async () => {
+      try {
+        await pwBrowser.close();
+      } catch {
+      }
+    };
+  } else if (framework === "patchright") {
+    const prBrowser = await patchrightChromium.connectOverCDP(v3.connectURL());
+    const prContext = prBrowser.contexts()[0];
+    page = prContext.pages()[0];
+    await page.goto(c.url, { waitUntil: "networkidle" });
+    cleanup = async () => {
+      try {
+        await prBrowser.close();
+      } catch {
+      }
+    };
+  }
+  try {
+    await v3.act(c.action, { page });
+    const extraction = await v3.extract({ page });
+    const text = extraction.pageText ?? "";
+    for (const s of c.expectedSubstrings) {
+      expect(
+        text.includes(s),
+        `expected pageText to include substring: ${s}`
+      ).toBeTruthy();
+    }
+  } finally {
+    await cleanup?.();
+  }
+}
+const cases = [
+  {
+    title: "Closed shadow root inside OOPIF",
+    url: "https://browserbase.github.io/stagehand-eval-sites/sites/closed-shadow-root-in-oopif/",
+    action: {
+      selector: "xpath=/html/body/main/section/iframe/html/body/shadow-demo//div/button",
+      method: "click",
+      arguments: [""],
+      description: "click button inside closed shadow root in OOPIF"
+    },
+    expectedSubstrings: ["button successfully clicked"]
+  },
+  {
+    title: "Open shadow root inside OOPIF",
+    url: "https://browserbase.github.io/stagehand-eval-sites/sites/open-shadow-root-in-oopif/",
+    action: {
+      selector: "xpath=/html/body/main/section/iframe/html/body/shadow-demo//div/button",
+      method: "click",
+      arguments: [""],
+      description: ""
+    },
+    expectedSubstrings: ["button successfully clicked"]
+  },
+  {
+    title: "OOPIF inside open shadow root",
+    url: "https://browserbase.github.io/stagehand-eval-sites/sites/oopif-in-open-shadow-dom/",
+    action: {
+      selector: "xpath=/html/body/shadow-host//section/iframe/html/body/main/section[1]/form/div/div[1]/input",
+      method: "fill",
+      arguments: ["nunya"],
+      description: ""
+    },
+    expectedSubstrings: ["nunya"]
+  },
+  {
+    title: "OOPIF inside closed shadow root",
+    url: "https://browserbase.github.io/stagehand-eval-sites/sites/oopif-in-closed-shadow-dom/",
+    action: {
+      selector: "xpath=/html/body/shadow-host//section/iframe/html/body/main/section[1]/form/div/div[1]/input",
+      method: "fill",
+      arguments: ["nunya"],
+      description: "fill input inside OOPIF"
+    },
+    expectedSubstrings: ["nunya"]
+  }
+];
+test.describe.parallel("Stagehand v3: shadow <-> iframe OOPIF scenarios", () => {
+  let v3;
+  test.beforeEach(async () => {
+    v3 = new V3(v3DynamicTestConfig);
+    await v3.init();
+  });
+  test.afterEach(async () => {
+    await closeV3(v3);
+  });
+  const frameworks = [
+    "v3",
+    "playwright",
+    "puppeteer",
+    "patchright"
+  ];
+  for (const fw of frameworks) {
+    for (const c of cases) {
+      test(`[${fw}] ${c.title}`, async () => {
+        await runCase(v3, c, fw);
+      });
+    }
+  }
+});
+//# sourceMappingURL=shadow-iframe-oopif.spec.js.map

package/dist/esm/lib/v3/tests/shadow-iframe-oopif.spec.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/shadow-iframe-oopif.spec.ts"],
+  "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport puppeteer from \"puppeteer-core\";\nimport { chromium as playwrightChromium } from \"playwright\";\nimport { chromium as patchrightChromium } from \"patchright-core\";\nimport { Action } from \"../types/public/methods.js\";\nimport { AnyPage } from \"../types/public/page.js\";\nimport { v3DynamicTestConfig } from \"./v3.dynamic.config.js\";\nimport { closeV3 } from \"./testUtils.js\";\n\n/**\n * IMPORTANT:\n * - We create a single V3 instance/test to avoid cross-test state. Increase parallelism later if needed.\n * - We assert an *effect* when feasible (e.g. input value). For pure clicks we assert no thrown error.\n */\n\ntype Case = {\n  title: string;\n  url: string;\n  action: Action;\n  expectedSubstrings?: string[]; // check v3.extract().pageText contains these\n};\n\ntype Framework = \"v3\" | \"puppeteer\" | \"playwright\" | \"patchright\";\n\nasync function runCase(v3: V3, c: Case, framework: Framework): Promise<void> {\n  let cleanup: (() => Promise<void> | void) | null = null;\n\n  // Acquire the correct page for the requested framework\n  let page: AnyPage;\n  if (framework === \"v3\") {\n    page = v3.context.pages()[0];\n    await page.goto(c.url, { waitUntil: \"networkidle\" });\n  } else if (framework === \"puppeteer\") {\n    const browser = await puppeteer.connect({\n      browserWSEndpoint: v3.connectURL(),\n      defaultViewport: null,\n    });\n    const pages = await browser.pages();\n    page = pages[0];\n    await page.goto(c.url, { waitUntil: \"networkidle0\" });\n    cleanup = async () => {\n      try {\n        await browser.close();\n      } catch {\n        //\n      }\n    };\n  } else if (framework === \"playwright\") {\n    const pwBrowser = await playwrightChromium.connectOverCDP(v3.connectURL());\n    const pwContext = pwBrowser.contexts()[0];\n    page = pwContext.pages()[0];\n    await page.goto(c.url, { waitUntil: \"networkidle\" });\n    cleanup = async () => {\n      try {\n        await pwBrowser.close();\n      } catch {\n        // ignore\n      }\n    };\n  } else if (framework === \"patchright\") {\n    const prBrowser = await patchrightChromium.connectOverCDP(v3.connectURL());\n    const prContext = prBrowser.contexts()[0];\n    page = prContext.pages()[0];\n    await page.goto(c.url, { waitUntil: \"networkidle\" });\n    cleanup = async () => {\n      try {\n        await prBrowser.close();\n      } catch {\n        // ignore\n      }\n    };\n  }\n\n  try {\n    await v3.act(c.action, { page });\n    // Post-action extraction; verify expected text appears\n    const extraction = await v3.extract({ page });\n    const text = extraction.pageText ?? \"\";\n    for (const s of c.expectedSubstrings) {\n      expect(\n        text.includes(s),\n        `expected pageText to include substring: ${s}`,\n      ).toBeTruthy();\n    }\n  } finally {\n    await cleanup?.();\n  }\n}\n\nconst cases: Case[] = [\n  {\n    title: \"Closed shadow root inside OOPIF\",\n    url: \"https://browserbase.github.io/stagehand-eval-sites/sites/closed-shadow-root-in-oopif/\",\n    action: {\n      selector:\n        \"xpath=/html/body/main/section/iframe/html/body/shadow-demo//div/button\",\n      method: \"click\",\n      arguments: [\"\"],\n      description: \"click button inside closed shadow root in OOPIF\",\n    },\n    expectedSubstrings: [\"button successfully clicked\"],\n  },\n  {\n    title: \"Open shadow root inside OOPIF\",\n    url: \"https://browserbase.github.io/stagehand-eval-sites/sites/open-shadow-root-in-oopif/\",\n    action: {\n      selector:\n        \"xpath=/html/body/main/section/iframe/html/body/shadow-demo//div/button\",\n      method: \"click\",\n      arguments: [\"\"],\n      description: \"\",\n    },\n    expectedSubstrings: [\"button successfully clicked\"],\n  },\n  {\n    title: \"OOPIF inside open shadow root\",\n    url: \"https://browserbase.github.io/stagehand-eval-sites/sites/oopif-in-open-shadow-dom/\",\n    action: {\n      selector:\n        \"xpath=/html/body/shadow-host//section/iframe/html/body/main/section[1]/form/div/div[1]/input\",\n      method: \"fill\",\n      arguments: [\"nunya\"],\n      description: \"\",\n    },\n    expectedSubstrings: [\"nunya\"],\n  },\n  {\n    title: \"OOPIF inside closed shadow root\",\n    url: \"https://browserbase.github.io/stagehand-eval-sites/sites/oopif-in-closed-shadow-dom/\",\n    action: {\n      selector:\n        \"xpath=/html/body/shadow-host//section/iframe/html/body/main/section[1]/form/div/div[1]/input\",\n      method: \"fill\",\n      arguments: [\"nunya\"],\n      description: \"fill input inside OOPIF\",\n    },\n    expectedSubstrings: [\"nunya\"],\n  },\n];\n\ntest.describe\n  .parallel(\"Stagehand v3: shadow <-> iframe OOPIF scenarios\", () => {\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  const frameworks: Framework[] = [\n    \"v3\",\n    \"playwright\",\n    \"puppeteer\",\n    \"patchright\",\n  ];\n  for (const fw of frameworks) {\n    for (const c of cases) {\n      test(`[${fw}] ${c.title}`, async () => {\n        await runCase(v3, c, fw);\n      });\n    }\n  }\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/lib/v3/tests/shadow-iframe-spif.spec.js

@@ -0,0 +1,134 @@
+import { test, expect } from "@playwright/test";
+import { V3 } from "../v3.js";
+import puppeteer from "puppeteer-core";
+import { chromium as playwrightChromium } from "playwright";
+import { chromium as patchrightChromium } from "patchright-core";
+import { v3DynamicTestConfig } from "./v3.dynamic.config.js";
+import { closeV3 } from "./testUtils.js";
+async function runCase(v3, c, framework) {
+  let cleanup = null;
+  let page;
+  if (framework === "v3") {
+    page = v3.context.pages()[0];
+    await page.goto(c.url, { waitUntil: "networkidle" });
+  } else if (framework === "puppeteer") {
+    const browser = await puppeteer.connect({
+      browserWSEndpoint: v3.connectURL(),
+      defaultViewport: null
+    });
+    const pages = await browser.pages();
+    page = pages[0];
+    await page.goto(c.url, { waitUntil: "networkidle0" });
+    cleanup = async () => {
+      try {
+        await browser.close();
+      } catch {
+      }
+    };
+  } else if (framework === "playwright") {
+    const pwBrowser = await playwrightChromium.connectOverCDP(v3.connectURL());
+    const pwContext = pwBrowser.contexts()[0];
+    page = pwContext.pages()[0];
+    await page.goto(c.url, { waitUntil: "networkidle" });
+    cleanup = async () => {
+      try {
+        await pwBrowser.close();
+      } catch {
+      }
+    };
+  } else if (framework === "patchright") {
+    const prBrowser = await patchrightChromium.connectOverCDP(v3.connectURL());
+    const prContext = prBrowser.contexts()[0];
+    page = prContext.pages()[0];
+    await page.goto(c.url, { waitUntil: "networkidle" });
+    cleanup = async () => {
+      try {
+        await prBrowser.close();
+      } catch {
+      }
+    };
+  }
+  try {
+    await v3.act(c.action, { page });
+    const extraction = await v3.extract({ page });
+    const text = extraction.pageText ?? "";
+    for (const s of c.expectedSubstrings) {
+      expect(
+        text.includes(s),
+        `expected pageText to include substring: ${s}`
+      ).toBeTruthy();
+    }
+  } finally {
+    await cleanup?.();
+  }
+}
+const cases = [
+  {
+    title: "Open shadow root inside SPIF",
+    url: "https://browserbase.github.io/stagehand-eval-sites/sites/open-shadow-root-in-spif/",
+    action: {
+      selector: "xpath=/html/body/main/section/iframe/html/body/shadow-demo//div/button",
+      method: "click",
+      arguments: [""],
+      description: ""
+    },
+    expectedSubstrings: ["button successfully clicked"]
+  },
+  {
+    title: "Closed shadow root inside SPIF",
+    url: "https://browserbase.github.io/stagehand-eval-sites/sites/closed-shadow-dom-in-spif/",
+    action: {
+      selector: "xpath=/html/body/div/iframe/html/body/shadow-demo//div/button",
+      method: "click",
+      arguments: [""],
+      description: ""
+    },
+    expectedSubstrings: ["button successfully clicked"]
+  },
+  {
+    title: "SPIF inside closed shadow root",
+    url: "https://browserbase.github.io/stagehand-eval-sites/sites/spif-in-closed-shadow-dom/",
+    action: {
+      selector: "xpath=/html/body/shadow-host//div/iframe/html/body/button",
+      method: "click",
+      arguments: [""],
+      description: ""
+    },
+    expectedSubstrings: ["button successfully clicked"]
+  },
+  {
+    title: "SPIF inside open shadow root",
+    url: "https://browserbase.github.io/stagehand-eval-sites/sites/spif-in-open-shadow-dom/",
+    action: {
+      selector: "xpath=/html/body/shadow-host//div/iframe/html/body/button",
+      method: "click",
+      arguments: [""],
+      description: "click button inside SPIF under open shadow"
+    },
+    expectedSubstrings: ["button successfully clicked"]
+  }
+];
+test.describe.parallel("Stagehand v3: shadow <-> iframe SPIF scenarios", () => {
+  let v3;
+  test.beforeEach(async () => {
+    v3 = new V3(v3DynamicTestConfig);
+    await v3.init();
+  });
+  test.afterEach(async () => {
+    await closeV3(v3);
+  });
+  const frameworks = [
+    "v3",
+    "playwright",
+    "puppeteer",
+    "patchright"
+  ];
+  for (const fw of frameworks) {
+    for (const c of cases) {
+      test(`[${fw}] ${c.title}`, async () => {
+        await runCase(v3, c, fw);
+      });
+    }
+  }
+});
+//# sourceMappingURL=shadow-iframe-spif.spec.js.map

package/dist/esm/lib/v3/tests/shadow-iframe-spif.spec.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/shadow-iframe-spif.spec.ts"],
+  "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport puppeteer from \"puppeteer-core\";\nimport { chromium as playwrightChromium } from \"playwright\";\nimport { chromium as patchrightChromium } from \"patchright-core\";\nimport { Action } from \"../types/public/methods.js\";\nimport { AnyPage } from \"../types/public/page.js\";\nimport { v3DynamicTestConfig } from \"./v3.dynamic.config.js\";\nimport { closeV3 } from \"./testUtils.js\";\n\n/**\n * IMPORTANT:\n * - We create a single V3 instance/test to avoid cross-test state. Increase parallelism later if needed.\n * - We assert an *effect* when feasible (e.g. input value). For pure clicks we assert no thrown error.\n */\n\ntype Case = {\n  title: string;\n  url: string;\n  action: Action;\n  expectedSubstrings?: string[]; // check v3.extract().pageText contains these\n};\n\ntype Framework = \"v3\" | \"puppeteer\" | \"playwright\" | \"patchright\";\n\nasync function runCase(v3: V3, c: Case, framework: Framework): Promise<void> {\n  let cleanup: (() => Promise<void> | void) | null = null;\n\n  // Acquire the correct page for the requested framework\n  let page: AnyPage;\n  if (framework === \"v3\") {\n    page = v3.context.pages()[0];\n    await page.goto(c.url, { waitUntil: \"networkidle\" });\n  } else if (framework === \"puppeteer\") {\n    const browser = await puppeteer.connect({\n      browserWSEndpoint: v3.connectURL(),\n      defaultViewport: null,\n    });\n    const pages = await browser.pages();\n    page = pages[0];\n    await page.goto(c.url, { waitUntil: \"networkidle0\" });\n    cleanup = async () => {\n      try {\n        await browser.close();\n      } catch {\n        //\n      }\n    };\n  } else if (framework === \"playwright\") {\n    const pwBrowser = await playwrightChromium.connectOverCDP(v3.connectURL());\n    const pwContext = pwBrowser.contexts()[0];\n    page = pwContext.pages()[0];\n    await page.goto(c.url, { waitUntil: \"networkidle\" });\n    cleanup = async () => {\n      try {\n        await pwBrowser.close();\n      } catch {\n        // ignore\n      }\n    };\n  } else if (framework === \"patchright\") {\n    const prBrowser = await patchrightChromium.connectOverCDP(v3.connectURL());\n    const prContext = prBrowser.contexts()[0];\n    page = prContext.pages()[0];\n    await page.goto(c.url, { waitUntil: \"networkidle\" });\n    cleanup = async () => {\n      try {\n        await prBrowser.close();\n      } catch {\n        // ignore\n      }\n    };\n  }\n\n  try {\n    await v3.act(c.action, { page });\n    // Post-action extraction; verify expected text appears\n    const extraction = await v3.extract({ page });\n    const text = extraction.pageText ?? \"\";\n    for (const s of c.expectedSubstrings) {\n      expect(\n        text.includes(s),\n        `expected pageText to include substring: ${s}`,\n      ).toBeTruthy();\n    }\n  } finally {\n    await cleanup?.();\n  }\n}\n\nconst cases: Case[] = [\n  {\n    title: \"Open shadow root inside SPIF\",\n    url: \"https://browserbase.github.io/stagehand-eval-sites/sites/open-shadow-root-in-spif/\",\n    action: {\n      selector:\n        \"xpath=/html/body/main/section/iframe/html/body/shadow-demo//div/button\",\n      method: \"click\",\n      arguments: [\"\"],\n      description: \"\",\n    },\n    expectedSubstrings: [\"button successfully clicked\"],\n  },\n  {\n    title: \"Closed shadow root inside SPIF\",\n    url: \"https://browserbase.github.io/stagehand-eval-sites/sites/closed-shadow-dom-in-spif/\",\n    action: {\n      selector: \"xpath=/html/body/div/iframe/html/body/shadow-demo//div/button\",\n      method: \"click\",\n      arguments: [\"\"],\n      description: \"\",\n    },\n    expectedSubstrings: [\"button successfully clicked\"],\n  },\n  {\n    title: \"SPIF inside closed shadow root\",\n    url: \"https://browserbase.github.io/stagehand-eval-sites/sites/spif-in-closed-shadow-dom/\",\n    action: {\n      selector: \"xpath=/html/body/shadow-host//div/iframe/html/body/button\",\n      method: \"click\",\n      arguments: [\"\"],\n      description: \"\",\n    },\n    expectedSubstrings: [\"button successfully clicked\"],\n  },\n  {\n    title: \"SPIF inside open shadow root\",\n    url: \"https://browserbase.github.io/stagehand-eval-sites/sites/spif-in-open-shadow-dom/\",\n    action: {\n      selector: \"xpath=/html/body/shadow-host//div/iframe/html/body/button\",\n      method: \"click\",\n      arguments: [\"\"],\n      description: \"click button inside SPIF under open shadow\",\n    },\n    expectedSubstrings: [\"button successfully clicked\"],\n  },\n];\n\ntest.describe.parallel(\"Stagehand v3: shadow <-> iframe SPIF scenarios\", () => {\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  const frameworks: Framework[] = [\n    \"v3\",\n    \"playwright\",\n    \"puppeteer\",\n    \"patchright\",\n  ];\n  for (const fw of frameworks) {\n    for (const c of cases) {\n      test(`[${fw}] ${c.title}`, async () => {\n        await runCase(v3, c, fw);\n      });\n    }\n  }\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/lib/v3/tests/testUtils.js

@@ -0,0 +1,31 @@
+const CLOSE_TIMEOUT_MS = 5e3;
+async function settleWithTimeout(promise, timeoutMs) {
+  let timeoutId;
+  const timeout = new Promise((resolve) => {
+    timeoutId = setTimeout(resolve, timeoutMs);
+  });
+  try {
+    await Promise.race([promise.catch(() => {
+    }), timeout]);
+  } finally {
+    if (timeoutId) clearTimeout(timeoutId);
+  }
+}
+async function closeV3(v3) {
+  if (!v3) return;
+  const isBrowserbase = v3.isBrowserbase;
+  if (isBrowserbase) {
+    try {
+      await settleWithTimeout(
+        v3.context.conn.send("Browser.close"),
+        CLOSE_TIMEOUT_MS
+      );
+    } catch {
+    }
+  }
+  await settleWithTimeout(v3.close(), CLOSE_TIMEOUT_MS);
+}
+export {
+  closeV3
+};
+//# sourceMappingURL=testUtils.js.map

package/dist/esm/lib/v3/tests/testUtils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/testUtils.ts"],
+  "sourcesContent": ["import type { V3 } from \"../v3.js\";\n\nconst CLOSE_TIMEOUT_MS = 5_000;\n\nasync function settleWithTimeout(\n  promise: Promise<unknown>,\n  timeoutMs: number,\n): Promise<void> {\n  let timeoutId: NodeJS.Timeout | undefined;\n  const timeout = new Promise<void>((resolve) => {\n    timeoutId = setTimeout(resolve, timeoutMs);\n  });\n  try {\n    await Promise.race([promise.catch(() => {}), timeout]);\n  } finally {\n    if (timeoutId) clearTimeout(timeoutId);\n  }\n}\n\nexport async function closeV3(v3?: V3 | null): Promise<void> {\n  if (!v3) return;\n  const isBrowserbase = v3.isBrowserbase;\n  if (isBrowserbase) {\n    try {\n      await settleWithTimeout(\n        v3.context.conn.send(\"Browser.close\"),\n        CLOSE_TIMEOUT_MS,\n      );\n    } catch {\n      // best-effort cleanup\n    }\n  }\n\n  await settleWithTimeout(v3.close(), CLOSE_TIMEOUT_MS);\n}\n"],
+  "mappings": "AAEA,MAAM,mBAAmB;AAEzB,eAAe,kBACb,SACA,WACe;AACf,MAAI;AACJ,QAAM,UAAU,IAAI,QAAc,CAAC,YAAY;AAC7C,gBAAY,WAAW,SAAS,SAAS;AAAA,EAC3C,CAAC;AACD,MAAI;AACF,UAAM,QAAQ,KAAK,CAAC,QAAQ,MAAM,MAAM;AAAA,IAAC,CAAC,GAAG,OAAO,CAAC;AAAA,EACvD,UAAE;AACA,QAAI,UAAW,cAAa,SAAS;AAAA,EACvC;AACF;AAEA,eAAsB,QAAQ,IAA+B;AAC3D,MAAI,CAAC,GAAI;AACT,QAAM,gBAAgB,GAAG;AACzB,MAAI,eAAe;AACjB,QAAI;AACF,YAAM;AAAA,QACJ,GAAG,QAAQ,KAAK,KAAK,eAAe;AAAA,QACpC;AAAA,MACF;AAAA,IACF,QAAQ;AAAA,IAER;AAAA,EACF;AAEA,QAAM,kBAAkB,GAAG,MAAM,GAAG,gBAAgB;AACtD;",
+  "names": []
+}

package/dist/esm/lib/v3/tests/text-selector-innermost.spec.js

@@ -0,0 +1,100 @@
+import { expect, test } from "@playwright/test";
+import { V3 } from "../v3.js";
+import { v3DynamicTestConfig } from "./v3.dynamic.config.js";
+import { closeV3 } from "./testUtils.js";
+test.describe("Text selector innermost element matching", () => {
+  let v3;
+  test.beforeEach(async () => {
+    v3 = new V3(v3DynamicTestConfig);
+    await v3.init();
+  });
+  test.afterEach(async () => {
+    await closeV3(v3);
+  });
+  test("text selector matches only innermost elements", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "data:text/html," + encodeURIComponent(`
+        <div id="outer">
+          <span id="middle">
+            <button id="inner">Click me</button>
+          </span>
+        </div>
+      `)
+    );
+    const count = await page.mainFrame().locator("text=Click me").count();
+    expect(count).toBe(1);
+    const session = page.mainFrame().session;
+    const { executionContextId } = await session.send("Page.createIsolatedWorld", {
+      frameId: page.mainFrame().frameId,
+      worldName: "test-world"
+    });
+    const evalRes = await session.send(
+      "Runtime.evaluate",
+      {
+        expression: `(() => {
+          const candidates = [];
+          const iter = document.createNodeIterator(document.documentElement, NodeFilter.SHOW_ELEMENT);
+          let n;
+          while ((n = iter.nextNode())) {
+            const el = n;
+            const t = (el.innerText ?? el.textContent ?? '').trim();
+            if (t && t.includes("Click me")) {
+              candidates.push(el);
+            }
+          }
+          
+          // Find innermost
+          for (const candidate of candidates) {
+            let isInnermost = true;
+            for (const other of candidates) {
+              if (candidate !== other && candidate.contains(other)) {
+                isInnermost = false;
+                break;
+              }
+            }
+            if (isInnermost) return candidate.id;
+          }
+          return null;
+        })()`,
+        contextId: executionContextId,
+        returnByValue: true
+      }
+    );
+    expect(evalRes.result.value).toBe("inner");
+  });
+  test("multiple innermost elements with same text", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "data:text/html," + encodeURIComponent(`
+        <div>
+          <button>Submit</button>
+          <span>Some other content</span>
+          <button>Submit</button>
+        </div>
+        <div>
+          <a href="#">Submit</a>
+        </div>
+      `)
+    );
+    const count = await page.mainFrame().locator("text=Submit").count();
+    expect(count).toBe(3);
+  });
+  test("nested text with different innermost elements", async () => {
+    const page = v3.context.pages()[0];
+    await page.goto(
+      "data:text/html," + encodeURIComponent(`
+        <div id="parent">
+          Hello <span id="child">World</span>
+        </div>
+      `)
+    );
+    const helloCount = await page.mainFrame().locator("text=Hello").count();
+    expect(helloCount).toBe(1);
+    const worldCount = await page.mainFrame().locator("text=World").count();
+    expect(worldCount).toBe(1);
+    const bothCount = await page.mainFrame().locator("text=Hello World").count();
+    expect(bothCount).toBe(1);
+  });
+});
+//# sourceMappingURL=text-selector-innermost.spec.js.map

package/dist/esm/lib/v3/tests/text-selector-innermost.spec.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/text-selector-innermost.spec.ts"],
+  "sourcesContent": ["import { expect, test } from \"@playwright/test\";\nimport { Protocol } from \"devtools-protocol\";\nimport { V3 } from \"../v3.js\";\nimport { v3DynamicTestConfig } from \"./v3.dynamic.config.js\";\nimport { closeV3 } from \"./testUtils.js\";\n\ntest.describe(\"Text selector innermost element matching\", () => {\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(\"text selector matches only innermost elements\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\n      \"data:text/html,\" +\n        encodeURIComponent(`\n        <div id=\"outer\">\n          <span id=\"middle\">\n            <button id=\"inner\">Click me</button>\n          </span>\n        </div>\n      `),\n    );\n\n    // Only the button should be counted, not the parent elements\n    const count = await page.mainFrame().locator(\"text=Click me\").count();\n    expect(count).toBe(1);\n\n    // Verify it finds the button element specifically\n    const session = page.mainFrame().session;\n    const { executionContextId } = await session.send<{\n      executionContextId: number;\n    }>(\"Page.createIsolatedWorld\", {\n      frameId: page.mainFrame().frameId,\n      worldName: \"test-world\",\n    });\n\n    const evalRes = await session.send<Protocol.Runtime.EvaluateResponse>(\n      \"Runtime.evaluate\",\n      {\n        expression: `(() => {\n          const candidates = [];\n          const iter = document.createNodeIterator(document.documentElement, NodeFilter.SHOW_ELEMENT);\n          let n;\n          while ((n = iter.nextNode())) {\n            const el = n;\n            const t = (el.innerText ?? el.textContent ?? '').trim();\n            if (t && t.includes(\"Click me\")) {\n              candidates.push(el);\n            }\n          }\n          \n          // Find innermost\n          for (const candidate of candidates) {\n            let isInnermost = true;\n            for (const other of candidates) {\n              if (candidate !== other && candidate.contains(other)) {\n                isInnermost = false;\n                break;\n              }\n            }\n            if (isInnermost) return candidate.id;\n          }\n          return null;\n        })()`,\n        contextId: executionContextId,\n        returnByValue: true,\n      },\n    );\n\n    expect(evalRes.result.value).toBe(\"inner\");\n  });\n\n  test(\"multiple innermost elements with same text\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\n      \"data:text/html,\" +\n        encodeURIComponent(`\n        <div>\n          <button>Submit</button>\n          <span>Some other content</span>\n          <button>Submit</button>\n        </div>\n        <div>\n          <a href=\"#\">Submit</a>\n        </div>\n      `),\n    );\n\n    // Should find all three innermost elements (2 buttons + 1 link)\n    const count = await page.mainFrame().locator(\"text=Submit\").count();\n    expect(count).toBe(3);\n  });\n\n  test(\"nested text with different innermost elements\", async () => {\n    const page = v3.context.pages()[0];\n\n    await page.goto(\n      \"data:text/html,\" +\n        encodeURIComponent(`\n        <div id=\"parent\">\n          Hello <span id=\"child\">World</span>\n        </div>\n      `),\n    );\n\n    // \"Hello\" is only in the parent div\n    const helloCount = await page.mainFrame().locator(\"text=Hello\").count();\n    expect(helloCount).toBe(1); // Only the div\n\n    // \"World\" is only in the span\n    const worldCount = await page.mainFrame().locator(\"text=World\").count();\n    expect(worldCount).toBe(1); // Only the span\n\n    // \"Hello World\" matches only the parent div (as it's the innermost containing both words)\n    const bothCount = await page\n      .mainFrame()\n      .locator(\"text=Hello World\")\n      .count();\n    expect(bothCount).toBe(1); // Only the div\n  });\n});\n"],
+  "mappings": "AAAA,SAAS,QAAQ,YAAY;AAE7B,SAAS,UAAU;AACnB,SAAS,2BAA2B;AACpC,SAAS,eAAe;AAExB,KAAK,SAAS,4CAA4C,MAAM;AAC9D,MAAI;AAEJ,OAAK,WAAW,YAAY;AAC1B,SAAK,IAAI,GAAG,mBAAmB;AAC/B,UAAM,GAAG,KAAK;AAAA,EAChB,CAAC;AAED,OAAK,UAAU,YAAY;AACzB,UAAM,QAAQ,EAAE;AAAA,EAClB,CAAC;AAED,OAAK,iDAAiD,YAAY;AAChE,UAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AAEjC,UAAM,KAAK;AAAA,MACT,oBACE,mBAAmB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,OAMpB;AAAA,IACH;AAGA,UAAM,QAAQ,MAAM,KAAK,UAAU,EAAE,QAAQ,eAAe,EAAE,MAAM;AACpE,WAAO,KAAK,EAAE,KAAK,CAAC;AAGpB,UAAM,UAAU,KAAK,UAAU,EAAE;AACjC,UAAM,EAAE,mBAAmB,IAAI,MAAM,QAAQ,KAE1C,4BAA4B;AAAA,MAC7B,SAAS,KAAK,UAAU,EAAE;AAAA,MAC1B,WAAW;AAAA,IACb,CAAC;AAED,UAAM,UAAU,MAAM,QAAQ;AAAA,MAC5B;AAAA,MACA;AAAA,QACE,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAyBZ,WAAW;AAAA,QACX,eAAe;AAAA,MACjB;AAAA,IACF;AAEA,WAAO,QAAQ,OAAO,KAAK,EAAE,KAAK,OAAO;AAAA,EAC3C,CAAC;AAED,OAAK,8CAA8C,YAAY;AAC7D,UAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AAEjC,UAAM,KAAK;AAAA,MACT,oBACE,mBAAmB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,OASpB;AAAA,IACH;AAGA,UAAM,QAAQ,MAAM,KAAK,UAAU,EAAE,QAAQ,aAAa,EAAE,MAAM;AAClE,WAAO,KAAK,EAAE,KAAK,CAAC;AAAA,EACtB,CAAC;AAED,OAAK,iDAAiD,YAAY;AAChE,UAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AAEjC,UAAM,KAAK;AAAA,MACT,oBACE,mBAAmB;AAAA;AAAA;AAAA;AAAA,OAIpB;AAAA,IACH;AAGA,UAAM,aAAa,MAAM,KAAK,UAAU,EAAE,QAAQ,YAAY,EAAE,MAAM;AACtE,WAAO,UAAU,EAAE,KAAK,CAAC;AAGzB,UAAM,aAAa,MAAM,KAAK,UAAU,EAAE,QAAQ,YAAY,EAAE,MAAM;AACtE,WAAO,UAAU,EAAE,KAAK,CAAC;AAGzB,UAAM,YAAY,MAAM,KACrB,UAAU,EACV,QAAQ,kBAAkB,EAC1B,MAAM;AACT,WAAO,SAAS,EAAE,KAAK,CAAC;AAAA,EAC1B,CAAC;AACH,CAAC;",
+  "names": []
+}

package/dist/esm/lib/v3/tests/timeouts.spec.js

@@ -0,0 +1,32 @@
+import { test, expect } from "@playwright/test";
+import { V3 } from "../v3.js";
+import { v3DynamicTestConfig } from "./v3.dynamic.config.js";
+import { z } from "zod";
+import { closeV3 } from "./testUtils.js";
+test.describe("V3 hard timeouts", () => {
+  let v3;
+  test.beforeEach(async () => {
+    v3 = new V3(v3DynamicTestConfig);
+    await v3.init();
+  });
+  test.afterEach(async () => {
+    await closeV3(v3);
+  });
+  test("observe() enforces timeoutMs", async () => {
+    await expect(v3.observe("find something", { timeout: 5 })).rejects.toThrow(
+      /timed out/i
+    );
+  });
+  test("extract() enforces timeoutMs", async () => {
+    const schema = z.object({ title: z.string().optional() });
+    await expect(
+      v3.extract("Extract title", schema, { timeout: 5 })
+    ).rejects.toThrow(/timed out/i);
+  });
+  test("act() enforces timeoutMs", async () => {
+    await expect(v3.act("do nothing", { timeout: 5 })).rejects.toThrow(
+      /timed out/i
+    );
+  });
+});
+//# sourceMappingURL=timeouts.spec.js.map

package/dist/esm/lib/v3/tests/timeouts.spec.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/timeouts.spec.ts"],
+  "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport { v3DynamicTestConfig } from \"./v3.dynamic.config.js\";\nimport { z } from \"zod\";\nimport { closeV3 } from \"./testUtils.js\";\n\ntest.describe(\"V3 hard timeouts\", () => {\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(\"observe() enforces timeoutMs\", async () => {\n    // Tiny timeout to force the race to hit the timeout branch\n    await expect(v3.observe(\"find something\", { timeout: 5 })).rejects.toThrow(\n      /timed out/i,\n    );\n  });\n\n  test(\"extract() enforces timeoutMs\", async () => {\n    const schema = z.object({ title: z.string().optional() });\n    await expect(\n      v3.extract(\"Extract title\", schema, { timeout: 5 }),\n    ).rejects.toThrow(/timed out/i);\n  });\n\n  test(\"act() enforces timeoutMs\", async () => {\n    await expect(v3.act(\"do nothing\", { timeout: 5 })).rejects.toThrow(\n      /timed out/i,\n    );\n  });\n});\n"],
+  "mappings": "AAAA,SAAS,MAAM,cAAc;AAC7B,SAAS,UAAU;AACnB,SAAS,2BAA2B;AACpC,SAAS,SAAS;AAClB,SAAS,eAAe;AAExB,KAAK,SAAS,oBAAoB,MAAM;AACtC,MAAI;AAEJ,OAAK,WAAW,YAAY;AAC1B,SAAK,IAAI,GAAG,mBAAmB;AAC/B,UAAM,GAAG,KAAK;AAAA,EAChB,CAAC;AAED,OAAK,UAAU,YAAY;AACzB,UAAM,QAAQ,EAAE;AAAA,EAClB,CAAC;AAED,OAAK,gCAAgC,YAAY;AAE/C,UAAM,OAAO,GAAG,QAAQ,kBAAkB,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,QAAQ;AAAA,MACjE;AAAA,IACF;AAAA,EACF,CAAC;AAED,OAAK,gCAAgC,YAAY;AAC/C,UAAM,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACxD,UAAM;AAAA,MACJ,GAAG,QAAQ,iBAAiB,QAAQ,EAAE,SAAS,EAAE,CAAC;AAAA,IACpD,EAAE,QAAQ,QAAQ,YAAY;AAAA,EAChC,CAAC;AAED,OAAK,4BAA4B,YAAY;AAC3C,UAAM,OAAO,GAAG,IAAI,cAAc,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,QAAQ;AAAA,MACzD;AAAA,IACF;AAAA,EACF,CAAC;AACH,CAAC;",
+  "names": []
+}

package/dist/esm/lib/v3/tests/user-data-dir.spec.js

@@ -0,0 +1,43 @@
+import { test, expect } from "@playwright/test";
+import { V3 } from "../v3.js";
+import { v3TestConfig } from "./v3.config.js";
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+test.describe("userDataDir persistence", () => {
+  let v3;
+  let testDir;
+  test.beforeEach(() => {
+    testDir = fs.mkdtempSync(
+      path.join(os.tmpdir(), "stagehand-userdata-test-")
+    );
+  });
+  test.afterEach(async () => {
+    await v3?.close?.().catch(() => {
+    });
+    if (testDir && fs.existsSync(testDir)) {
+      fs.rmSync(testDir, { recursive: true, force: true });
+    }
+  });
+  test("Chrome uses the specified userDataDir", async () => {
+    const browserTarget = (process.env.STAGEHAND_BROWSER_TARGET ?? "local").toLowerCase();
+    const isBrowserbase = browserTarget === "browserbase";
+    test.skip(isBrowserbase, "Requires local Chromium for userDataDir checks");
+    v3 = new V3({
+      ...v3TestConfig,
+      localBrowserLaunchOptions: {
+        ...v3TestConfig.localBrowserLaunchOptions ?? {},
+        userDataDir: testDir,
+        preserveUserDataDir: true
+      }
+    });
+    await v3.init();
+    const page = v3.context.pages()[0];
+    await page.goto("about:blank");
+    await expect.poll(() => fs.existsSync(path.join(testDir, "Default")), {
+      timeout: 1e4
+    }).toBe(true);
+    expect(fs.existsSync(path.join(testDir, "Local State"))).toBe(true);
+  });
+});
+//# sourceMappingURL=user-data-dir.spec.js.map

package/dist/esm/lib/v3/tests/user-data-dir.spec.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/user-data-dir.spec.ts"],
+  "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport { v3TestConfig } from \"./v3.config.js\";\nimport * as fs from \"fs\";\nimport * as path from \"path\";\nimport * as os from \"os\";\n\ntest.describe(\"userDataDir persistence\", () => {\n  let v3: V3;\n  let testDir: string;\n\n  test.beforeEach(() => {\n    testDir = fs.mkdtempSync(\n      path.join(os.tmpdir(), \"stagehand-userdata-test-\"),\n    );\n  });\n\n  test.afterEach(async () => {\n    await v3?.close?.().catch(() => {});\n    if (testDir && fs.existsSync(testDir)) {\n      fs.rmSync(testDir, { recursive: true, force: true });\n    }\n  });\n\n  test(\"Chrome uses the specified userDataDir\", async () => {\n    const browserTarget = (\n      process.env.STAGEHAND_BROWSER_TARGET ?? \"local\"\n    ).toLowerCase();\n    const isBrowserbase = browserTarget === \"browserbase\";\n    test.skip(isBrowserbase, \"Requires local Chromium for userDataDir checks\");\n\n    v3 = new V3({\n      ...v3TestConfig,\n      localBrowserLaunchOptions: {\n        ...(v3TestConfig.localBrowserLaunchOptions ?? {}),\n        userDataDir: testDir,\n        preserveUserDataDir: true,\n      },\n    });\n\n    await v3.init();\n\n    const page = v3.context.pages()[0];\n    await page.goto(\"about:blank\");\n\n    await expect\n      .poll(() => fs.existsSync(path.join(testDir, \"Default\")), {\n        timeout: 10_000,\n      })\n      .toBe(true);\n\n    expect(fs.existsSync(path.join(testDir, \"Local State\"))).toBe(true);\n  });\n});\n"],
+  "mappings": "AAAA,SAAS,MAAM,cAAc;AAC7B,SAAS,UAAU;AACnB,SAAS,oBAAoB;AAC7B,YAAY,QAAQ;AACpB,YAAY,UAAU;AACtB,YAAY,QAAQ;AAEpB,KAAK,SAAS,2BAA2B,MAAM;AAC7C,MAAI;AACJ,MAAI;AAEJ,OAAK,WAAW,MAAM;AACpB,cAAU,GAAG;AAAA,MACX,KAAK,KAAK,GAAG,OAAO,GAAG,0BAA0B;AAAA,IACnD;AAAA,EACF,CAAC;AAED,OAAK,UAAU,YAAY;AACzB,UAAM,IAAI,QAAQ,EAAE,MAAM,MAAM;AAAA,IAAC,CAAC;AAClC,QAAI,WAAW,GAAG,WAAW,OAAO,GAAG;AACrC,SAAG,OAAO,SAAS,EAAE,WAAW,MAAM,OAAO,KAAK,CAAC;AAAA,IACrD;AAAA,EACF,CAAC;AAED,OAAK,yCAAyC,YAAY;AACxD,UAAM,iBACJ,QAAQ,IAAI,4BAA4B,SACxC,YAAY;AACd,UAAM,gBAAgB,kBAAkB;AACxC,SAAK,KAAK,eAAe,gDAAgD;AAEzE,SAAK,IAAI,GAAG;AAAA,MACV,GAAG;AAAA,MACH,2BAA2B;AAAA,QACzB,GAAI,aAAa,6BAA6B,CAAC;AAAA,QAC/C,aAAa;AAAA,QACb,qBAAqB;AAAA,MACvB;AAAA,IACF,CAAC;AAED,UAAM,GAAG,KAAK;AAEd,UAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjC,UAAM,KAAK,KAAK,aAAa;AAE7B,UAAM,OACH,KAAK,MAAM,GAAG,WAAW,KAAK,KAAK,SAAS,SAAS,CAAC,GAAG;AAAA,MACxD,SAAS;AAAA,IACX,CAAC,EACA,KAAK,IAAI;AAEZ,WAAO,GAAG,WAAW,KAAK,KAAK,SAAS,aAAa,CAAC,CAAC,EAAE,KAAK,IAAI;AAAA,EACpE,CAAC;AACH,CAAC;",
+  "names": []
+}

package/dist/esm/lib/v3/tests/v3.config.js

@@ -0,0 +1,15 @@
+import {
+  v3DynamicTestConfig,
+  getV3DynamicTestConfig
+} from "./v3.dynamic.config.js";
+const v3TestConfig = v3DynamicTestConfig;
+function getV3TestConfig(overrides = {}) {
+  return getV3DynamicTestConfig(overrides);
+}
+var v3_config_default = getV3TestConfig;
+export {
+  v3_config_default as default,
+  getV3TestConfig,
+  v3TestConfig
+};
+//# sourceMappingURL=v3.config.js.map

package/dist/esm/lib/v3/tests/v3.config.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/v3.config.ts"],
+  "sourcesContent": ["import type { V3Options } from \"../types/public/options.js\";\nimport {\n  v3DynamicTestConfig,\n  getV3DynamicTestConfig,\n} from \"./v3.dynamic.config.js\";\n\nexport const v3TestConfig: V3Options = v3DynamicTestConfig;\n\nexport function getV3TestConfig(overrides: Partial<V3Options> = {}): V3Options {\n  return getV3DynamicTestConfig(overrides);\n}\n\nexport default getV3TestConfig;\n"],
+  "mappings": "AACA;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAEA,MAAM,eAA0B;AAEhC,SAAS,gBAAgB,YAAgC,CAAC,GAAc;AAC7E,SAAO,uBAAuB,SAAS;AACzC;AAEA,IAAO,oBAAQ;",
+  "names": []
+}

package/dist/esm/lib/v3/tests/v3.dynamic.config.js

@@ -0,0 +1,43 @@
+const browserTarget = (process.env.STAGEHAND_BROWSER_TARGET ?? "local").toLowerCase();
+const isBrowserbase = browserTarget === "browserbase";
+const browserbaseRegionRaw = process.env.BROWSERBASE_REGION;
+const browserbaseRegion = [
+  "us-west-2",
+  "us-east-1",
+  "eu-central-1",
+  "ap-southeast-1"
+].includes(browserbaseRegionRaw) ? browserbaseRegionRaw : void 0;
+const baseConfig = {
+  verbose: 0,
+  disablePino: true,
+  logger: (line) => console.log(line),
+  disableAPI: true
+};
+const v3DynamicTestConfig = isBrowserbase ? {
+  ...baseConfig,
+  env: "BROWSERBASE",
+  apiKey: process.env.BROWSERBASE_API_KEY,
+  projectId: process.env.BROWSERBASE_PROJECT_ID,
+  disableAPI: true,
+  selfHeal: false,
+  ...browserbaseRegion ? { browserbaseSessionCreateParams: { region: browserbaseRegion } } : {}
+} : {
+  ...baseConfig,
+  env: "LOCAL",
+  localBrowserLaunchOptions: {
+    executablePath: process.env.CHROME_PATH,
+    args: process.env.CI ? ["--no-sandbox"] : void 0,
+    headless: true,
+    viewport: { width: 1288, height: 711 }
+  }
+};
+function getV3DynamicTestConfig(overrides = {}) {
+  return { ...v3DynamicTestConfig, ...overrides };
+}
+var v3_dynamic_config_default = getV3DynamicTestConfig;
+export {
+  v3_dynamic_config_default as default,
+  getV3DynamicTestConfig,
+  v3DynamicTestConfig
+};
+//# sourceMappingURL=v3.dynamic.config.js.map