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

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

@@ -0,0 +1,156 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var import_test = require("@playwright/test");
+var import_v3 = require("../v3.js");
+var import_puppeteer_core = __toESM(require("puppeteer-core"), 1);
+var import_playwright = require("playwright");
+var import_patchright_core = require("patchright-core");
+var import_v3_dynamic_config = require("./v3.dynamic.config.js");
+var import_testUtils = require("./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 import_puppeteer_core.default.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 import_playwright.chromium.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 import_patchright_core.chromium.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) {
+      (0, import_test.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"]
+  }
+];
+import_test.test.describe.parallel("Stagehand v3: shadow <-> iframe OOPIF scenarios", () => {
+  let v3;
+  import_test.test.beforeEach(async () => {
+    v3 = new import_v3.V3(import_v3_dynamic_config.v3DynamicTestConfig);
+    await v3.init();
+  });
+  import_test.test.afterEach(async () => {
+    await (0, import_testUtils.closeV3)(v3);
+  });
+  const frameworks = [
+    "v3",
+    "playwright",
+    "puppeteer",
+    "patchright"
+  ];
+  for (const fw of frameworks) {
+    for (const c of cases) {
+      (0, import_test.test)(`[${fw}] ${c.title}`, async () => {
+        await runCase(v3, c, fw);
+      });
+    }
+  }
+});
+//# sourceMappingURL=shadow-iframe-oopif.spec.js.map

package/dist/cjs/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": ["puppeteer", "playwrightChromium", "patchrightChromium"]
+}

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

@@ -0,0 +1,156 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var import_test = require("@playwright/test");
+var import_v3 = require("../v3.js");
+var import_puppeteer_core = __toESM(require("puppeteer-core"), 1);
+var import_playwright = require("playwright");
+var import_patchright_core = require("patchright-core");
+var import_v3_dynamic_config = require("./v3.dynamic.config.js");
+var import_testUtils = require("./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 import_puppeteer_core.default.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 import_playwright.chromium.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 import_patchright_core.chromium.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) {
+      (0, import_test.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"]
+  }
+];
+import_test.test.describe.parallel("Stagehand v3: shadow <-> iframe SPIF scenarios", () => {
+  let v3;
+  import_test.test.beforeEach(async () => {
+    v3 = new import_v3.V3(import_v3_dynamic_config.v3DynamicTestConfig);
+    await v3.init();
+  });
+  import_test.test.afterEach(async () => {
+    await (0, import_testUtils.closeV3)(v3);
+  });
+  const frameworks = [
+    "v3",
+    "playwright",
+    "puppeteer",
+    "patchright"
+  ];
+  for (const fw of frameworks) {
+    for (const c of cases) {
+      (0, import_test.test)(`[${fw}] ${c.title}`, async () => {
+        await runCase(v3, c, fw);
+      });
+    }
+  }
+});
+//# sourceMappingURL=shadow-iframe-spif.spec.js.map

package/dist/cjs/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": ["puppeteer", "playwrightChromium", "patchrightChromium"]
+}

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

@@ -0,0 +1,54 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var testUtils_exports = {};
+__export(testUtils_exports, {
+  closeV3: () => closeV3
+});
+module.exports = __toCommonJS(testUtils_exports);
+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);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  closeV3
+});
+//# sourceMappingURL=testUtils.js.map

package/dist/cjs/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": ";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;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/cjs/lib/v3/tests/text-selector-innermost.spec.js

@@ -0,0 +1,100 @@
+var import_test = require("@playwright/test");
+var import_v3 = require("../v3.js");
+var import_v3_dynamic_config = require("./v3.dynamic.config.js");
+var import_testUtils = require("./testUtils.js");
+import_test.test.describe("Text selector innermost element matching", () => {
+  let v3;
+  import_test.test.beforeEach(async () => {
+    v3 = new import_v3.V3(import_v3_dynamic_config.v3DynamicTestConfig);
+    await v3.init();
+  });
+  import_test.test.afterEach(async () => {
+    await (0, import_testUtils.closeV3)(v3);
+  });
+  (0, import_test.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();
+    (0, import_test.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
+      }
+    );
+    (0, import_test.expect)(evalRes.result.value).toBe("inner");
+  });
+  (0, import_test.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();
+    (0, import_test.expect)(count).toBe(3);
+  });
+  (0, import_test.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();
+    (0, import_test.expect)(helloCount).toBe(1);
+    const worldCount = await page.mainFrame().locator("text=World").count();
+    (0, import_test.expect)(worldCount).toBe(1);
+    const bothCount = await page.mainFrame().locator("text=Hello World").count();
+    (0, import_test.expect)(bothCount).toBe(1);
+  });
+});
+//# sourceMappingURL=text-selector-innermost.spec.js.map

package/dist/cjs/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,kBAA6B;AAE7B,gBAAmB;AACnB,+BAAoC;AACpC,uBAAwB;AAExB,iBAAK,SAAS,4CAA4C,MAAM;AAC9D,MAAI;AAEJ,mBAAK,WAAW,YAAY;AAC1B,SAAK,IAAI,aAAG,4CAAmB;AAC/B,UAAM,GAAG,KAAK;AAAA,EAChB,CAAC;AAED,mBAAK,UAAU,YAAY;AACzB,cAAM,0BAAQ,EAAE;AAAA,EAClB,CAAC;AAED,wBAAK,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,4BAAO,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,4BAAO,QAAQ,OAAO,KAAK,EAAE,KAAK,OAAO;AAAA,EAC3C,CAAC;AAED,wBAAK,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,4BAAO,KAAK,EAAE,KAAK,CAAC;AAAA,EACtB,CAAC;AAED,wBAAK,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,4BAAO,UAAU,EAAE,KAAK,CAAC;AAGzB,UAAM,aAAa,MAAM,KAAK,UAAU,EAAE,QAAQ,YAAY,EAAE,MAAM;AACtE,4BAAO,UAAU,EAAE,KAAK,CAAC;AAGzB,UAAM,YAAY,MAAM,KACrB,UAAU,EACV,QAAQ,kBAAkB,EAC1B,MAAM;AACT,4BAAO,SAAS,EAAE,KAAK,CAAC;AAAA,EAC1B,CAAC;AACH,CAAC;",
+  "names": []
+}

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

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

package/dist/cjs/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,kBAA6B;AAC7B,gBAAmB;AACnB,+BAAoC;AACpC,iBAAkB;AAClB,uBAAwB;AAExB,iBAAK,SAAS,oBAAoB,MAAM;AACtC,MAAI;AAEJ,mBAAK,WAAW,YAAY;AAC1B,SAAK,IAAI,aAAG,4CAAmB;AAC/B,UAAM,GAAG,KAAK;AAAA,EAChB,CAAC;AAED,mBAAK,UAAU,YAAY;AACzB,cAAM,0BAAQ,EAAE;AAAA,EAClB,CAAC;AAED,wBAAK,gCAAgC,YAAY;AAE/C,cAAM,oBAAO,GAAG,QAAQ,kBAAkB,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,QAAQ;AAAA,MACjE;AAAA,IACF;AAAA,EACF,CAAC;AAED,wBAAK,gCAAgC,YAAY;AAC/C,UAAM,SAAS,aAAE,OAAO,EAAE,OAAO,aAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACxD,cAAM;AAAA,MACJ,GAAG,QAAQ,iBAAiB,QAAQ,EAAE,SAAS,EAAE,CAAC;AAAA,IACpD,EAAE,QAAQ,QAAQ,YAAY;AAAA,EAChC,CAAC;AAED,wBAAK,4BAA4B,YAAY;AAC3C,cAAM,oBAAO,GAAG,IAAI,cAAc,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,QAAQ;AAAA,MACzD;AAAA,IACF;AAAA,EACF,CAAC;AACH,CAAC;",
+  "names": []
+}

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

@@ -0,0 +1,65 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var import_test = require("@playwright/test");
+var import_v3 = require("../v3.js");
+var import_v3_config = require("./v3.config.js");
+var fs = __toESM(require("fs"), 1);
+var path = __toESM(require("path"), 1);
+var os = __toESM(require("os"), 1);
+import_test.test.describe("userDataDir persistence", () => {
+  let v3;
+  let testDir;
+  import_test.test.beforeEach(() => {
+    testDir = fs.mkdtempSync(
+      path.join(os.tmpdir(), "stagehand-userdata-test-")
+    );
+  });
+  import_test.test.afterEach(async () => {
+    await v3?.close?.().catch(() => {
+    });
+    if (testDir && fs.existsSync(testDir)) {
+      fs.rmSync(testDir, { recursive: true, force: true });
+    }
+  });
+  (0, import_test.test)("Chrome uses the specified userDataDir", async () => {
+    const browserTarget = (process.env.STAGEHAND_BROWSER_TARGET ?? "local").toLowerCase();
+    const isBrowserbase = browserTarget === "browserbase";
+    import_test.test.skip(isBrowserbase, "Requires local Chromium for userDataDir checks");
+    v3 = new import_v3.V3({
+      ...import_v3_config.v3TestConfig,
+      localBrowserLaunchOptions: {
+        ...import_v3_config.v3TestConfig.localBrowserLaunchOptions ?? {},
+        userDataDir: testDir,
+        preserveUserDataDir: true
+      }
+    });
+    await v3.init();
+    const page = v3.context.pages()[0];
+    await page.goto("about:blank");
+    await import_test.expect.poll(() => fs.existsSync(path.join(testDir, "Default")), {
+      timeout: 1e4
+    }).toBe(true);
+    (0, import_test.expect)(fs.existsSync(path.join(testDir, "Local State"))).toBe(true);
+  });
+});
+//# sourceMappingURL=user-data-dir.spec.js.map