@browserbasehq/stagehand 3.7.2 → 3.7.3-alpha-94a0ee4e195a7563ae53a04793a092f37aabd388

package/dist/cjs/lib/v3/launch/local.js

@@ -12,8 +12,8 @@ const STAGEHAND_DEFAULT_FLAGS = [
     "--no-first-run",
     "--no-default-browser-check",
     "--disable-dev-shm-usage",
-    "--site-per-process",
     "--enable-features=WebMCPTesting,DevToolsWebMCPSupport",
+    "--disable-features=SitePerProcess",
 ];
 async function launchLocalChrome(opts) {
     const connectTimeoutMs = opts.connectTimeoutMs ?? 15_000;

package/dist/cjs/lib/v3/launch/local.js.map

@@ -1 +1 @@
-{"version":3,"file":"local.js","sourceRoot":"","sources":["../../../../../lib/v3/launch/local.ts"],"names":[],"mappings":"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","sourcesContent":["import { launch, Launcher, LaunchedChrome } from \"chrome-launcher\";\nimport WebSocket from \"ws\";\nimport { ConnectionTimeoutError } from \"../types/public/sdkErrors.js\";\nimport type { LocalBrowserLaunchOptions } from \"../types/public/index.js\";\n\ninterface LaunchLocalOptions extends LocalBrowserLaunchOptions {\n  handleSIGINT?: boolean;\n}\n\nconst STAGEHAND_DEFAULT_FLAGS = [\n  \"--remote-allow-origins=*\",\n  \"--no-first-run\",\n  \"--no-default-browser-check\",\n  \"--disable-dev-shm-usage\",\n  \"--site-per-process\",\n  \"--enable-features=WebMCPTesting,DevToolsWebMCPSupport\",\n];\n\nexport async function launchLocalChrome(\n  opts: LaunchLocalOptions,\n): Promise<{ ws: string; chrome: LaunchedChrome }> {\n  const connectTimeoutMs = opts.connectTimeoutMs ?? 15_000;\n  const deadlineMs = Date.now() + connectTimeoutMs;\n  const connectionPollInterval = 250;\n  const maxConnectionRetries = Math.max(\n    1,\n    Math.ceil(connectTimeoutMs / connectionPollInterval),\n  );\n  const headless = opts.headless ?? false;\n  const ignoredDefaults = Array.isArray(opts.ignoreDefaultArgs)\n    ? opts.ignoreDefaultArgs\n    : null;\n  const stagehandDefaultFlags =\n    opts.ignoreDefaultArgs === true\n      ? []\n      : ignoredDefaults\n        ? STAGEHAND_DEFAULT_FLAGS.filter((f) => !ignoredDefaults.includes(f))\n        : [...STAGEHAND_DEFAULT_FLAGS];\n  const chromeFlags = [\n    ...stagehandDefaultFlags,\n    headless ? \"--headless=new\" : undefined,\n    opts.devtools ? \"--auto-open-devtools-for-tabs\" : undefined,\n    opts.locale ? `--lang=${opts.locale}` : undefined,\n    opts.viewport?.width && opts.viewport?.height\n      ? `--window-size=${opts.viewport.width},${opts.viewport.height + 87}`\n      : undefined,\n    typeof opts.deviceScaleFactor === \"number\"\n      ? `--force-device-scale-factor=${Math.max(0.1, opts.deviceScaleFactor)}`\n      : undefined,\n    opts.hasTouch ? \"--touch-events=enabled\" : undefined,\n    opts.ignoreHTTPSErrors ? \"--ignore-certificate-errors\" : undefined,\n    opts.proxy?.server ? `--proxy-server=${opts.proxy.server}` : undefined,\n    opts.proxy?.bypass ? `--proxy-bypass-list=${opts.proxy.bypass}` : undefined,\n    ...(opts.args ?? []),\n  ].filter((f): f is string => typeof f === \"string\");\n\n  // Handle ignoreDefaultArgs: selectively remove chrome-launcher's built-in\n  // defaults while keeping Stagehand's own flags (already in chromeFlags).\n  let ignoreDefaultFlags = false;\n  if (opts.ignoreDefaultArgs === true) {\n    ignoreDefaultFlags = true;\n  } else if (\n    Array.isArray(opts.ignoreDefaultArgs) &&\n    opts.ignoreDefaultArgs.length > 0\n  ) {\n    // Tell chrome-launcher to skip ALL its defaults, then re-add the ones\n    // the user did NOT ask to exclude.\n    ignoreDefaultFlags = true;\n    const excludeArgs = opts.ignoreDefaultArgs;\n    const clDefaults = Launcher.defaultFlags?.() ?? [];\n    const kept = clDefaults.filter((f) => !excludeArgs.includes(f));\n    chromeFlags.unshift(...kept);\n  }\n\n  const chrome = await launch({\n    chromePath: opts.executablePath,\n    chromeFlags,\n    port: opts.port,\n    userDataDir: opts.userDataDir,\n    handleSIGINT: opts.handleSIGINT,\n    ignoreDefaultFlags,\n    connectionPollInterval,\n    maxConnectionRetries,\n  });\n\n  const ws = await waitForWebSocketDebuggerUrl(chrome.port, deadlineMs);\n  await waitForWebSocketReady(ws, deadlineMs);\n\n  return { ws, chrome };\n}\n\nasync function waitForWebSocketDebuggerUrl(\n  port: number,\n  deadlineMs: number,\n): Promise<string> {\n  let lastErrMsg = \"\";\n\n  while (Date.now() < deadlineMs) {\n    try {\n      const resp = await fetch(`http://127.0.0.1:${port}/json/version`);\n      if (resp.ok) {\n        const json = (await resp.json()) as unknown;\n        const url = (json as { webSocketDebuggerUrl?: string })\n          .webSocketDebuggerUrl;\n        if (typeof url === \"string\") return url;\n      } else {\n        lastErrMsg = `${resp.status} ${resp.statusText}`;\n      }\n    } catch (err) {\n      lastErrMsg = err instanceof Error ? err.message : String(err);\n    }\n    await new Promise((r) => setTimeout(r, 250));\n  }\n\n  throw new ConnectionTimeoutError(\n    `Timed out waiting for /json/version on port ${port} ${\n      lastErrMsg ? ` (last error: ${lastErrMsg})` : \"\"\n    }`,\n  );\n}\n\nasync function waitForWebSocketReady(\n  wsUrl: string,\n  deadlineMs: number,\n): Promise<void> {\n  let lastErrMsg = \"\";\n  while (Date.now() < deadlineMs) {\n    const remainingMs = Math.max(200, deadlineMs - Date.now());\n    try {\n      await probeWebSocket(wsUrl, Math.min(2_000, remainingMs));\n      return;\n    } catch (error) {\n      lastErrMsg = error instanceof Error ? error.message : String(error);\n      await new Promise((r) => setTimeout(r, 100));\n    }\n  }\n  throw new ConnectionTimeoutError(\n    `Timed out waiting for CDP websocket to accept connections at ${wsUrl}${\n      lastErrMsg ? ` (last error: ${lastErrMsg})` : \"\"\n    }`,\n  );\n}\n\nfunction probeWebSocket(wsUrl: string, timeoutMs: number): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const ws = new WebSocket(wsUrl);\n    let settled = false;\n    const finish = (error?: unknown) => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timer);\n      try {\n        ws.terminate();\n      } catch {\n        // best-effort cleanup\n      }\n      if (error) {\n        reject(error);\n        return;\n      }\n      resolve();\n    };\n    const timer = setTimeout(() => {\n      finish(new Error(`websocket probe timeout after ${timeoutMs}ms`));\n    }, timeoutMs);\n\n    ws.once(\"open\", () => finish());\n    ws.once(\"error\", (error) => finish(error));\n  });\n}\n"]}
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../../../../lib/v3/launch/local.ts"],"names":[],"mappings":";;;;;AAkBA,8CAuEC;AAzFD,qDAAmE;AACnE,4CAA2B;AAC3B,+DAAsE;AAOtE,MAAM,uBAAuB,GAAG;IAC9B,0BAA0B;IAC1B,gBAAgB;IAChB,4BAA4B;IAC5B,yBAAyB;IACzB,uDAAuD;IACvD,mCAAmC;CACpC,CAAC;AAEK,KAAK,UAAU,iBAAiB,CACrC,IAAwB;IAExB,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,IAAI,MAAM,CAAC;IACzD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,gBAAgB,CAAC;IACjD,MAAM,sBAAsB,GAAG,GAAG,CAAC;IACnC,MAAM,oBAAoB,GAAG,IAAI,CAAC,GAAG,CACnC,CAAC,EACD,IAAI,CAAC,IAAI,CAAC,gBAAgB,GAAG,sBAAsB,CAAC,CACrD,CAAC;IACF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC;IACxC,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC;QAC3D,CAAC,CAAC,IAAI,CAAC,iBAAiB;QACxB,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,qBAAqB,GACzB,IAAI,CAAC,iBAAiB,KAAK,IAAI;QAC7B,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,eAAe;YACf,CAAC,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACrE,CAAC,CAAC,CAAC,GAAG,uBAAuB,CAAC,CAAC;IACrC,MAAM,WAAW,GAAG;QAClB,GAAG,qBAAqB;QACxB,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;QACvC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,SAAS;QAC3D,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;QACjD,IAAI,CAAC,QAAQ,EAAE,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,MAAM;YAC3C,CAAC,CAAC,iBAAiB,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,EAAE,EAAE;YACrE,CAAC,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,iBAAiB,KAAK,QAAQ;YACxC,CAAC,CAAC,+BAA+B,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,iBAAiB,CAAC,EAAE;YACxE,CAAC,CAAC,SAAS;QACb,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,SAAS;QACpD,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,SAAS;QAClE,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,kBAAkB,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;QACtE,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,uBAAuB,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;QAC3E,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;KACrB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IAEpD,0EAA0E;IAC1E,yEAAyE;IACzE,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAC/B,IAAI,IAAI,CAAC,iBAAiB,KAAK,IAAI,EAAE,CAAC;QACpC,kBAAkB,GAAG,IAAI,CAAC;IAC5B,CAAC;SAAM,IACL,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC;QACrC,IAAI,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EACjC,CAAC;QACD,sEAAsE;QACtE,mCAAmC;QACnC,kBAAkB,GAAG,IAAI,CAAC;QAC1B,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAAC;QAC3C,MAAM,UAAU,GAAG,0BAAQ,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,IAAA,wBAAM,EAAC;QAC1B,UAAU,EAAE,IAAI,CAAC,cAAc;QAC/B,WAAW;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,kBAAkB;QAClB,sBAAsB;QACtB,oBAAoB;KACrB,CAAC,CAAC;IAEH,MAAM,EAAE,GAAG,MAAM,2BAA2B,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACtE,MAAM,qBAAqB,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAE5C,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;AACxB,CAAC;AAED,KAAK,UAAU,2BAA2B,CACxC,IAAY,EACZ,UAAkB;IAElB,IAAI,UAAU,GAAG,EAAE,CAAC;IAEpB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,oBAAoB,IAAI,eAAe,CAAC,CAAC;YAClE,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAY,CAAC;gBAC5C,MAAM,GAAG,GAAI,IAA0C;qBACpD,oBAAoB,CAAC;gBACxB,IAAI,OAAO,GAAG,KAAK,QAAQ;oBAAE,OAAO,GAAG,CAAC;YAC1C,CAAC;iBAAM,CAAC;gBACN,UAAU,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACnD,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,UAAU,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,IAAI,qCAAsB,CAC9B,+CAA+C,IAAI,IACjD,UAAU,CAAC,CAAC,CAAC,iBAAiB,UAAU,GAAG,CAAC,CAAC,CAAC,EAChD,EAAE,CACH,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,KAAa,EACb,UAAkB;IAElB,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC;YACH,MAAM,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;YAC1D,OAAO;QACT,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,UAAU,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACpE,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,MAAM,IAAI,qCAAsB,CAC9B,gEAAgE,KAAK,GACnE,UAAU,CAAC,CAAC,CAAC,iBAAiB,UAAU,GAAG,CAAC,CAAC,CAAC,EAChD,EAAE,CACH,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAa,EAAE,SAAiB;IACtD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,EAAE,GAAG,IAAI,YAAS,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,KAAe,EAAE,EAAE;YACjC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,CAAC;gBACH,EAAE,CAAC,SAAS,EAAE,CAAC;YACjB,CAAC;YAAC,MAAM,CAAC;gBACP,sBAAsB;YACxB,CAAC;YACD,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,KAAK,CAAC,CAAC;gBACd,OAAO;YACT,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,SAAS,IAAI,CAAC,CAAC,CAAC;QACpE,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;QAChC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { launch, Launcher, LaunchedChrome } from \"chrome-launcher\";\nimport WebSocket from \"ws\";\nimport { ConnectionTimeoutError } from \"../types/public/sdkErrors.js\";\nimport type { LocalBrowserLaunchOptions } from \"../types/public/index.js\";\n\ninterface LaunchLocalOptions extends LocalBrowserLaunchOptions {\n  handleSIGINT?: boolean;\n}\n\nconst STAGEHAND_DEFAULT_FLAGS = [\n  \"--remote-allow-origins=*\",\n  \"--no-first-run\",\n  \"--no-default-browser-check\",\n  \"--disable-dev-shm-usage\",\n  \"--enable-features=WebMCPTesting,DevToolsWebMCPSupport\",\n  \"--disable-features=SitePerProcess\",\n];\n\nexport async function launchLocalChrome(\n  opts: LaunchLocalOptions,\n): Promise<{ ws: string; chrome: LaunchedChrome }> {\n  const connectTimeoutMs = opts.connectTimeoutMs ?? 15_000;\n  const deadlineMs = Date.now() + connectTimeoutMs;\n  const connectionPollInterval = 250;\n  const maxConnectionRetries = Math.max(\n    1,\n    Math.ceil(connectTimeoutMs / connectionPollInterval),\n  );\n  const headless = opts.headless ?? false;\n  const ignoredDefaults = Array.isArray(opts.ignoreDefaultArgs)\n    ? opts.ignoreDefaultArgs\n    : null;\n  const stagehandDefaultFlags =\n    opts.ignoreDefaultArgs === true\n      ? []\n      : ignoredDefaults\n        ? STAGEHAND_DEFAULT_FLAGS.filter((f) => !ignoredDefaults.includes(f))\n        : [...STAGEHAND_DEFAULT_FLAGS];\n  const chromeFlags = [\n    ...stagehandDefaultFlags,\n    headless ? \"--headless=new\" : undefined,\n    opts.devtools ? \"--auto-open-devtools-for-tabs\" : undefined,\n    opts.locale ? `--lang=${opts.locale}` : undefined,\n    opts.viewport?.width && opts.viewport?.height\n      ? `--window-size=${opts.viewport.width},${opts.viewport.height + 87}`\n      : undefined,\n    typeof opts.deviceScaleFactor === \"number\"\n      ? `--force-device-scale-factor=${Math.max(0.1, opts.deviceScaleFactor)}`\n      : undefined,\n    opts.hasTouch ? \"--touch-events=enabled\" : undefined,\n    opts.ignoreHTTPSErrors ? \"--ignore-certificate-errors\" : undefined,\n    opts.proxy?.server ? `--proxy-server=${opts.proxy.server}` : undefined,\n    opts.proxy?.bypass ? `--proxy-bypass-list=${opts.proxy.bypass}` : undefined,\n    ...(opts.args ?? []),\n  ].filter((f): f is string => typeof f === \"string\");\n\n  // Handle ignoreDefaultArgs: selectively remove chrome-launcher's built-in\n  // defaults while keeping Stagehand's own flags (already in chromeFlags).\n  let ignoreDefaultFlags = false;\n  if (opts.ignoreDefaultArgs === true) {\n    ignoreDefaultFlags = true;\n  } else if (\n    Array.isArray(opts.ignoreDefaultArgs) &&\n    opts.ignoreDefaultArgs.length > 0\n  ) {\n    // Tell chrome-launcher to skip ALL its defaults, then re-add the ones\n    // the user did NOT ask to exclude.\n    ignoreDefaultFlags = true;\n    const excludeArgs = opts.ignoreDefaultArgs;\n    const clDefaults = Launcher.defaultFlags?.() ?? [];\n    const kept = clDefaults.filter((f) => !excludeArgs.includes(f));\n    chromeFlags.unshift(...kept);\n  }\n\n  const chrome = await launch({\n    chromePath: opts.executablePath,\n    chromeFlags,\n    port: opts.port,\n    userDataDir: opts.userDataDir,\n    handleSIGINT: opts.handleSIGINT,\n    ignoreDefaultFlags,\n    connectionPollInterval,\n    maxConnectionRetries,\n  });\n\n  const ws = await waitForWebSocketDebuggerUrl(chrome.port, deadlineMs);\n  await waitForWebSocketReady(ws, deadlineMs);\n\n  return { ws, chrome };\n}\n\nasync function waitForWebSocketDebuggerUrl(\n  port: number,\n  deadlineMs: number,\n): Promise<string> {\n  let lastErrMsg = \"\";\n\n  while (Date.now() < deadlineMs) {\n    try {\n      const resp = await fetch(`http://127.0.0.1:${port}/json/version`);\n      if (resp.ok) {\n        const json = (await resp.json()) as unknown;\n        const url = (json as { webSocketDebuggerUrl?: string })\n          .webSocketDebuggerUrl;\n        if (typeof url === \"string\") return url;\n      } else {\n        lastErrMsg = `${resp.status} ${resp.statusText}`;\n      }\n    } catch (err) {\n      lastErrMsg = err instanceof Error ? err.message : String(err);\n    }\n    await new Promise((r) => setTimeout(r, 250));\n  }\n\n  throw new ConnectionTimeoutError(\n    `Timed out waiting for /json/version on port ${port} ${\n      lastErrMsg ? ` (last error: ${lastErrMsg})` : \"\"\n    }`,\n  );\n}\n\nasync function waitForWebSocketReady(\n  wsUrl: string,\n  deadlineMs: number,\n): Promise<void> {\n  let lastErrMsg = \"\";\n  while (Date.now() < deadlineMs) {\n    const remainingMs = Math.max(200, deadlineMs - Date.now());\n    try {\n      await probeWebSocket(wsUrl, Math.min(2_000, remainingMs));\n      return;\n    } catch (error) {\n      lastErrMsg = error instanceof Error ? error.message : String(error);\n      await new Promise((r) => setTimeout(r, 100));\n    }\n  }\n  throw new ConnectionTimeoutError(\n    `Timed out waiting for CDP websocket to accept connections at ${wsUrl}${\n      lastErrMsg ? ` (last error: ${lastErrMsg})` : \"\"\n    }`,\n  );\n}\n\nfunction probeWebSocket(wsUrl: string, timeoutMs: number): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const ws = new WebSocket(wsUrl);\n    let settled = false;\n    const finish = (error?: unknown) => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timer);\n      try {\n        ws.terminate();\n      } catch {\n        // best-effort cleanup\n      }\n      if (error) {\n        reject(error);\n        return;\n      }\n      resolve();\n    };\n    const timer = setTimeout(() => {\n      finish(new Error(`websocket probe timeout after ${timeoutMs}ms`));\n    }, timeoutMs);\n\n    ws.once(\"open\", () => finish());\n    ws.once(\"error\", (error) => finish(error));\n  });\n}\n"]}

package/dist/cjs/lib/v3/runtimePaths.js

@@ -10,7 +10,6 @@ exports.isMainModule = exports.createRequireFromCaller = exports.getPackageRootD
  * - /packages/server-v3/scripts/runtimePaths.ts
  * - /packages/server-v4/scripts/runtimePaths.ts
  * - /packages/evals/runtimePaths.ts
- * - /packages/docs/scripts/runtimePaths.js
  */
 const node_path_1 = __importDefault(require("node:path"));
 const node_url_1 = require("node:url");

package/dist/cjs/lib/v3/runtimePaths.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtimePaths.js","sourceRoot":"","sources":["../../../../lib/v3/runtimePaths.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Keep this file in sync with:\n * - /packages/core/lib/v3/runtimePaths.ts\n * - /packages/server-v3/scripts/runtimePaths.ts\n * - /packages/server-v4/scripts/runtimePaths.ts\n * - /packages/evals/runtimePaths.ts\n * - /packages/docs/scripts/runtimePaths.js\n */\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { createRequire } from \"node:module\";\n\nconst PACKAGE_SEGMENT = \"/packages/core/\";\nconst EVAL_FRAMES = new Set([\"[eval]\", \"[eval]-wrapper\"]);\nconst INTERNAL_FRAME_NAMES = new Set([\n  \"readCallsites\",\n  \"readCallsitePath\",\n  \"resolveCallerFilePath\",\n  \"getCurrentFilePath\",\n  \"getCurrentDirPath\",\n  \"getRepoRootDir\",\n  \"getPackageRootDir\",\n  \"createRequireFromCaller\",\n  \"isMainModule\",\n]);\n\nconst normalizePath = (value: string): string => {\n  const input = value.startsWith(\"file://\") ? fileURLToPath(value) : value;\n  return path.resolve(input).replaceAll(\"\\\\\", \"/\");\n};\n\nconst readCallsites = (): NodeJS.CallSite[] => {\n  const previousPrepare = Error.prepareStackTrace;\n  try {\n    Error.prepareStackTrace = (_, stack) => stack;\n    return (\n      (new Error().stack as unknown as NodeJS.CallSite[] | undefined) ?? []\n    );\n  } finally {\n    Error.prepareStackTrace = previousPrepare;\n  }\n};\n\ntype CallSiteWithScriptName = NodeJS.CallSite & {\n  getScriptNameOrSourceURL?: () => string | null;\n};\n\nconst readCallsitePath = (callsite: NodeJS.CallSite): string | null => {\n  const callsiteWithScript = callsite as CallSiteWithScriptName;\n  const rawPath =\n    callsite.getFileName() ?? callsiteWithScript.getScriptNameOrSourceURL?.();\n  if (!rawPath) return null;\n  if (rawPath.startsWith(\"node:\")) return null;\n  if (EVAL_FRAMES.has(rawPath)) return null;\n  return normalizePath(rawPath);\n};\n\nconst isInternalCallsite = (callsite: NodeJS.CallSite): boolean => {\n  const functionName = callsite.getFunctionName();\n  if (functionName && INTERNAL_FRAME_NAMES.has(functionName)) return true;\n\n  const methodName = callsite.getMethodName();\n  if (methodName && INTERNAL_FRAME_NAMES.has(methodName)) return true;\n\n  const callsiteString = callsite.toString();\n  for (const frameName of INTERNAL_FRAME_NAMES) {\n    if (callsiteString.includes(`${frameName} (`)) return true;\n    if (callsiteString.includes(`.${frameName} (`)) return true;\n  }\n  return false;\n};\n\nconst resolveCallerFilePath = (): string => {\n  const packageCandidates: string[] = [];\n  const fallbackCandidates: string[] = [];\n\n  for (const callsite of readCallsites()) {\n    const filePath = readCallsitePath(callsite);\n    if (!filePath) continue;\n    if (isInternalCallsite(callsite)) continue;\n    if (filePath.includes(PACKAGE_SEGMENT)) {\n      packageCandidates.push(filePath);\n      continue;\n    }\n    fallbackCandidates.push(filePath);\n  }\n\n  const packageCandidate = packageCandidates[0];\n  if (packageCandidate) return packageCandidate;\n\n  const fallbackCandidate = fallbackCandidates[0];\n  if (fallbackCandidate) return fallbackCandidate;\n\n  throw new Error(\"Unable to resolve caller file path.\");\n};\n\nexport const getCurrentFilePath = (): string => resolveCallerFilePath();\n\nexport const getCurrentDirPath = (): string =>\n  path.dirname(getCurrentFilePath());\n\nexport const getRepoRootDir = (): string => {\n  const currentFilePath = getCurrentFilePath();\n  const index = currentFilePath.lastIndexOf(PACKAGE_SEGMENT);\n  if (index === -1) {\n    throw new Error(\n      `Unable to determine repo root from ${currentFilePath} (missing ${PACKAGE_SEGMENT}).`,\n    );\n  }\n  return currentFilePath.slice(0, index);\n};\n\nexport const getPackageRootDir = (): string =>\n  `${getRepoRootDir()}${PACKAGE_SEGMENT.slice(0, -1)}`;\n\nexport const createRequireFromCaller = () =>\n  createRequire(getCurrentFilePath());\n\nexport const isMainModule = (): boolean => {\n  const entryScript = process.argv.at(1);\n  if (!entryScript) return false;\n  return normalizePath(entryScript) === getCurrentFilePath();\n};\n"]}
+{"version":3,"file":"runtimePaths.js","sourceRoot":"","sources":["../../../../lib/v3/runtimePaths.ts"],"names":[],"mappings":";;;;;;AAAA;;;;;;GAMG;AACH,0DAA6B;AAC7B,uCAAyC;AACzC,6CAA4C;AAE5C,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAC1C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAC1D,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,eAAe;IACf,kBAAkB;IAClB,uBAAuB;IACvB,oBAAoB;IACpB,mBAAmB;IACnB,gBAAgB;IAChB,mBAAmB;IACnB,yBAAyB;IACzB,cAAc;CACf,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,CAAC,KAAa,EAAU,EAAE;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAA,wBAAa,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACzE,OAAO,mBAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACnD,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,GAAsB,EAAE;IAC5C,MAAM,eAAe,GAAG,KAAK,CAAC,iBAAiB,CAAC;IAChD,IAAI,CAAC;QACH,KAAK,CAAC,iBAAiB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC;QAC9C,OAAO,CACJ,IAAI,KAAK,EAAE,CAAC,KAAkD,IAAI,EAAE,CACtE,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,iBAAiB,GAAG,eAAe,CAAC;IAC5C,CAAC;AACH,CAAC,CAAC;AAMF,MAAM,gBAAgB,GAAG,CAAC,QAAyB,EAAiB,EAAE;IACpE,MAAM,kBAAkB,GAAG,QAAkC,CAAC;IAC9D,MAAM,OAAO,GACX,QAAQ,CAAC,WAAW,EAAE,IAAI,kBAAkB,CAAC,wBAAwB,EAAE,EAAE,CAAC;IAC5E,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,IAAI,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,QAAyB,EAAW,EAAE;IAChE,MAAM,YAAY,GAAG,QAAQ,CAAC,eAAe,EAAE,CAAC;IAChD,IAAI,YAAY,IAAI,oBAAoB,CAAC,GAAG,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAExE,MAAM,UAAU,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;IAC5C,IAAI,UAAU,IAAI,oBAAoB,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpE,MAAM,cAAc,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAC3C,KAAK,MAAM,SAAS,IAAI,oBAAoB,EAAE,CAAC;QAC7C,IAAI,cAAc,CAAC,QAAQ,CAAC,GAAG,SAAS,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3D,IAAI,cAAc,CAAC,QAAQ,CAAC,IAAI,SAAS,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IAC9D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,qBAAqB,GAAG,GAAW,EAAE;IACzC,MAAM,iBAAiB,GAAa,EAAE,CAAC;IACvC,MAAM,kBAAkB,GAAa,EAAE,CAAC;IAExC,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ;YAAE,SAAS;QACxB,IAAI,kBAAkB,CAAC,QAAQ,CAAC;YAAE,SAAS;QAC3C,IAAI,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YACvC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACjC,SAAS;QACX,CAAC;QACD,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAC9C,IAAI,gBAAgB;QAAE,OAAO,gBAAgB,CAAC;IAE9C,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAChD,IAAI,iBAAiB;QAAE,OAAO,iBAAiB,CAAC;IAEhD,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACzD,CAAC,CAAC;AAEK,MAAM,kBAAkB,GAAG,GAAW,EAAE,CAAC,qBAAqB,EAAE,CAAC;AAA3D,QAAA,kBAAkB,sBAAyC;AAEjE,MAAM,iBAAiB,GAAG,GAAW,EAAE,CAC5C,mBAAI,CAAC,OAAO,CAAC,IAAA,0BAAkB,GAAE,CAAC,CAAC;AADxB,QAAA,iBAAiB,qBACO;AAE9B,MAAM,cAAc,GAAG,GAAW,EAAE;IACzC,MAAM,eAAe,GAAG,IAAA,0BAAkB,GAAE,CAAC;IAC7C,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IAC3D,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,sCAAsC,eAAe,aAAa,eAAe,IAAI,CACtF,CAAC;IACJ,CAAC;IACD,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACzC,CAAC,CAAC;AATW,QAAA,cAAc,kBASzB;AAEK,MAAM,iBAAiB,GAAG,GAAW,EAAE,CAC5C,GAAG,IAAA,sBAAc,GAAE,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAD1C,QAAA,iBAAiB,qBACyB;AAEhD,MAAM,uBAAuB,GAAG,GAAG,EAAE,CAC1C,IAAA,2BAAa,EAAC,IAAA,0BAAkB,GAAE,CAAC,CAAC;AADzB,QAAA,uBAAuB,2BACE;AAE/B,MAAM,YAAY,GAAG,GAAY,EAAE;IACxC,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,IAAI,CAAC,WAAW;QAAE,OAAO,KAAK,CAAC;IAC/B,OAAO,aAAa,CAAC,WAAW,CAAC,KAAK,IAAA,0BAAkB,GAAE,CAAC;AAC7D,CAAC,CAAC;AAJW,QAAA,YAAY,gBAIvB","sourcesContent":["/**\n * Keep this file in sync with:\n * - /packages/core/lib/v3/runtimePaths.ts\n * - /packages/server-v3/scripts/runtimePaths.ts\n * - /packages/server-v4/scripts/runtimePaths.ts\n * - /packages/evals/runtimePaths.ts\n */\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { createRequire } from \"node:module\";\n\nconst PACKAGE_SEGMENT = \"/packages/core/\";\nconst EVAL_FRAMES = new Set([\"[eval]\", \"[eval]-wrapper\"]);\nconst INTERNAL_FRAME_NAMES = new Set([\n  \"readCallsites\",\n  \"readCallsitePath\",\n  \"resolveCallerFilePath\",\n  \"getCurrentFilePath\",\n  \"getCurrentDirPath\",\n  \"getRepoRootDir\",\n  \"getPackageRootDir\",\n  \"createRequireFromCaller\",\n  \"isMainModule\",\n]);\n\nconst normalizePath = (value: string): string => {\n  const input = value.startsWith(\"file://\") ? fileURLToPath(value) : value;\n  return path.resolve(input).replaceAll(\"\\\\\", \"/\");\n};\n\nconst readCallsites = (): NodeJS.CallSite[] => {\n  const previousPrepare = Error.prepareStackTrace;\n  try {\n    Error.prepareStackTrace = (_, stack) => stack;\n    return (\n      (new Error().stack as unknown as NodeJS.CallSite[] | undefined) ?? []\n    );\n  } finally {\n    Error.prepareStackTrace = previousPrepare;\n  }\n};\n\ntype CallSiteWithScriptName = NodeJS.CallSite & {\n  getScriptNameOrSourceURL?: () => string | null;\n};\n\nconst readCallsitePath = (callsite: NodeJS.CallSite): string | null => {\n  const callsiteWithScript = callsite as CallSiteWithScriptName;\n  const rawPath =\n    callsite.getFileName() ?? callsiteWithScript.getScriptNameOrSourceURL?.();\n  if (!rawPath) return null;\n  if (rawPath.startsWith(\"node:\")) return null;\n  if (EVAL_FRAMES.has(rawPath)) return null;\n  return normalizePath(rawPath);\n};\n\nconst isInternalCallsite = (callsite: NodeJS.CallSite): boolean => {\n  const functionName = callsite.getFunctionName();\n  if (functionName && INTERNAL_FRAME_NAMES.has(functionName)) return true;\n\n  const methodName = callsite.getMethodName();\n  if (methodName && INTERNAL_FRAME_NAMES.has(methodName)) return true;\n\n  const callsiteString = callsite.toString();\n  for (const frameName of INTERNAL_FRAME_NAMES) {\n    if (callsiteString.includes(`${frameName} (`)) return true;\n    if (callsiteString.includes(`.${frameName} (`)) return true;\n  }\n  return false;\n};\n\nconst resolveCallerFilePath = (): string => {\n  const packageCandidates: string[] = [];\n  const fallbackCandidates: string[] = [];\n\n  for (const callsite of readCallsites()) {\n    const filePath = readCallsitePath(callsite);\n    if (!filePath) continue;\n    if (isInternalCallsite(callsite)) continue;\n    if (filePath.includes(PACKAGE_SEGMENT)) {\n      packageCandidates.push(filePath);\n      continue;\n    }\n    fallbackCandidates.push(filePath);\n  }\n\n  const packageCandidate = packageCandidates[0];\n  if (packageCandidate) return packageCandidate;\n\n  const fallbackCandidate = fallbackCandidates[0];\n  if (fallbackCandidate) return fallbackCandidate;\n\n  throw new Error(\"Unable to resolve caller file path.\");\n};\n\nexport const getCurrentFilePath = (): string => resolveCallerFilePath();\n\nexport const getCurrentDirPath = (): string =>\n  path.dirname(getCurrentFilePath());\n\nexport const getRepoRootDir = (): string => {\n  const currentFilePath = getCurrentFilePath();\n  const index = currentFilePath.lastIndexOf(PACKAGE_SEGMENT);\n  if (index === -1) {\n    throw new Error(\n      `Unable to determine repo root from ${currentFilePath} (missing ${PACKAGE_SEGMENT}).`,\n    );\n  }\n  return currentFilePath.slice(0, index);\n};\n\nexport const getPackageRootDir = (): string =>\n  `${getRepoRootDir()}${PACKAGE_SEGMENT.slice(0, -1)}`;\n\nexport const createRequireFromCaller = () =>\n  createRequire(getCurrentFilePath());\n\nexport const isMainModule = (): boolean => {\n  const entryScript = process.argv.at(1);\n  if (!entryScript) return false;\n  return normalizePath(entryScript) === getCurrentFilePath();\n};\n"]}

package/dist/cjs/lib/v3/understudy/a11y/snapshot/coordinateResolver.js

@@ -67,7 +67,45 @@ async function resolveXpathForLocation(page, x, y) {
             if (typeof be === "number" &&
                 reportedFrameId &&
                 reportedFrameId !== curFrameId) {
-                const abs = await (0, xpathUtils_js_1.buildAbsoluteXPathFromChain)(iframeChain, curSession, be);
+                const chain = [...iframeChain];
+                const framePath = [];
+                let frameId = reportedFrameId;
+                while (frameId && frameId !== curFrameId) {
+                    framePath.unshift(frameId);
+                    frameId = parentByFrame.get(frameId);
+                }
+                let resolvedFramePath = false;
+                if (frameId === curFrameId) {
+                    resolvedFramePath = true;
+                    for (const childFrameId of framePath) {
+                        const parentFrameId = parentByFrame.get(childFrameId);
+                        if (!parentFrameId) {
+                            resolvedFramePath = false;
+                            break;
+                        }
+                        try {
+                            const parentSession = page.getSessionForFrame(parentFrameId);
+                            const { backendNodeId } = await parentSession.send("DOM.getFrameOwner", { frameId: childFrameId });
+                            if (typeof backendNodeId !== "number") {
+                                resolvedFramePath = false;
+                                break;
+                            }
+                            chain.push({
+                                parentSession,
+                                iframeBackendNodeId: backendNodeId,
+                            });
+                        }
+                        catch {
+                            resolvedFramePath = false;
+                            break;
+                        }
+                    }
+                }
+                if (!resolvedFramePath) {
+                    return null;
+                }
+                const leafSession = page.getSessionForFrame(reportedFrameId);
+                const abs = await (0, xpathUtils_js_1.buildAbsoluteXPathFromChain)(chain, leafSession, be);
                 return abs
                     ? { frameId: reportedFrameId, backendNodeId: be, absoluteXPath: abs }
                     : null;

package/dist/cjs/lib/v3/understudy/a11y/snapshot/coordinateResolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"coordinateResolver.js","sourceRoot":"","sources":["../../../../../../../lib/v3/understudy/a11y/snapshot/coordinateResolver.ts"],"names":[],"mappings":";;AAcA,0DAsJC;AAjKD,mFAAsE;AACtE,0FAAgF;AAChF,+DAA8D;AAE9D,2DAAqD;AACrD,mDAA8D;AAE9D;;;GAGG;AACI,KAAK,UAAU,uBAAuB,CAC3C,IAAU,EACV,CAAS,EACT,CAAS;IAET,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACrC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAyB,CAAC;IACvD,CAAC,SAAS,KAAK,CAAC,CAA0B,EAAE,MAAqB;QAC/D,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACtC,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,IAAI,EAAE;YAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAEf,MAAM,WAAW,GAGZ,EAAE,CAAC;IAER,IAAI,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACrD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAEpD,IAAI,EAAE,GAAG,CAAC,CAAC;YACX,IAAI,EAAE,GAAG,CAAC,CAAC;YACX,IAAI,CAAC;gBACH,MAAM,UAAU,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACxD,MAAM,KAAK,GAAG,MAAM,+CAAiB;qBAClC,gBAAgB,CAAC,UAAU,EAAE,UAAU,CAAC;qBACxC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACnB,MAAM,UAAU,GAAG,IAAA,uCAAmB,EAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;gBAC/D,MAAM,UAAU,GAAG,KAAK;oBACtB,CAAC,CAAC;wBACE,SAAS,EAAE,KAAK;wBAChB,UAAU,EAAE,UAAU;wBACtB,aAAa,EAAE,IAAI;qBACpB;oBACH,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;gBACpD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,UAAU,CAAC,IAAI,CAErC,kBAAkB,EAAE,UAAU,CAAC,CAAC;gBACnC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;gBACpC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;YACtC,CAAC;YAAC,MAAM,CAAC;gBACP,EAAE;YACJ,CAAC;YACD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;YAC9C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;YAE9C,IAAI,GAA6D,CAAC;YAClE,IAAI,CAAC;gBACH,GAAG,GAAG,MAAM,UAAU,CAAC,IAAI,CAGxB,wBAAwB,EAAE;oBAC3B,CAAC,EAAE,EAAE;oBACL,CAAC,EAAE,EAAE;oBACL,yBAAyB,EAAE,KAAK;oBAChC,uBAAuB,EAAE,KAAK;iBAC/B,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,EAAE,GAAG,GAAG,EAAE,aAAa,CAAC;YAC9B,MAAM,eAAe,GAAG,GAAG,EAAE,OAAO,CAAC;YACrC,IACE,OAAO,EAAE,KAAK,QAAQ;gBACtB,eAAe;gBACf,eAAe,KAAK,UAAU,EAC9B,CAAC;gBACD,MAAM,GAAG,GAAG,MAAM,IAAA,2CAA2B,EAC3C,WAAW,EACX,UAAU,EACV,EAAE,CACH,CAAC;gBACF,OAAO,GAAG;oBACR,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE;oBACrE,CAAC,CAAC,IAAI,CAAC;YACX,CAAC;YAED,IAAI,OAAO,EAAE,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YAExC,IAAI,YAAgC,CAAC;YACrC,KAAK,MAAM,GAAG,IAAI,IAAA,kCAAc,EAAC,aAAa,EAAE,UAAU,CAAC,EAAE,CAAC;gBAC5D,IAAI,CAAC;oBACH,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,UAAU,CAAC,IAAI,CAE5C,mBAAmB,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;oBAC1C,IAAI,aAAa,KAAK,EAAE,EAAE,CAAC;wBACzB,YAAY,GAAG,GAAG,CAAC;wBACnB,MAAM;oBACR,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;YACH,CAAC;YAED,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,MAAM,GAAG,GAAG,MAAM,IAAA,2CAA2B,EAC3C,WAAW,EACX,UAAU,EACV,EAAE,CACH,CAAC;gBACF,OAAO,GAAG;oBACR,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE;oBAChE,CAAC,CAAC,IAAI,CAAC;YACX,CAAC;YAED,WAAW,CAAC,IAAI,CAAC;gBACf,aAAa,EAAE,UAAU;gBACzB,mBAAmB,EAAE,EAAE;aACxB,CAAC,CAAC;YAEH,IAAI,IAAI,GAAG,CAAC,CAAC;YACb,IAAI,GAAG,GAAG,CAAC,CAAC;YACZ,IAAI,CAAC;gBACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,UAAU,CAAC,IAAI,CAErC,iBAAiB,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC7C,MAAM,QAAQ,GAAG,MAAM,EAAE,QAAQ,CAAC;gBAClC,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,UAAU,CAAC,IAAI,CAErC,wBAAwB,EAAE;wBAC3B,QAAQ;wBACR,mBAAmB,EAAE,4CAAiB,CAAC,mBAAmB;wBAC1D,aAAa,EAAE,IAAI;qBACpB,CAAC,CAAC;oBACH,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC;oBACxC,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;oBACtC,MAAM,UAAU;yBACb,IAAI,CAAC,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC;yBAC3C,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,EAAE;YACJ,CAAC;YACD,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;YAChC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC;YAC/B,UAAU,GAAG,YAAY,CAAC;YAC1B,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["import type { Protocol } from \"devtools-protocol\";\nimport type { CDPSessionLike } from \"../../cdp.js\";\nimport { Page } from \"../../page.js\";\nimport { executionContexts } from \"../../executionContextRegistry.js\";\nimport { a11yScriptSources } from \"../../../dom/build/a11yScripts.generated.js\";\nimport { buildA11yInvocation } from \"../../a11yInvocation.js\";\nimport type { ResolvedLocation } from \"../../../types/private/snapshot.js\";\nimport { listChildrenOf } from \"./focusSelectors.js\";\nimport { buildAbsoluteXPathFromChain } from \"./xpathUtils.js\";\n\n/**\n * Resolve deepest node for a page coordinate and compute its absolute XPath across frames.\n * More efficient than building a full hybrid snapshot when only a single node’s XPath is needed.\n */\nexport async function resolveXpathForLocation(\n  page: Page,\n  x: number,\n  y: number,\n): Promise<ResolvedLocation | null> {\n  const tree = page.getFullFrameTree();\n  const parentByFrame = new Map<string, string | null>();\n  (function index(n: Protocol.Page.FrameTree, parent: string | null) {\n    parentByFrame.set(n.frame.id, parent);\n    for (const c of n.childFrames ?? []) index(c, n.frame.id);\n  })(tree, null);\n\n  const iframeChain: Array<{\n    parentSession: CDPSessionLike;\n    iframeBackendNodeId: number;\n  }> = [];\n\n  let curFrameId = page.mainFrameId();\n  let curSession = page.getSessionForFrame(curFrameId);\n  let curX = x;\n  let curY = y;\n\n  for (let depth = 0; depth < 8; depth++) {\n    try {\n      await curSession.send(\"DOM.enable\").catch(() => {});\n\n      let sx = 0;\n      let sy = 0;\n      try {\n        await curSession.send(\"Runtime.enable\").catch(() => {});\n        const ctxId = await executionContexts\n          .waitForMainWorld(curSession, curFrameId)\n          .catch(() => {});\n        const scrollExpr = buildA11yInvocation(\"getScrollOffsets\", []);\n        const evalParams = ctxId\n          ? {\n              contextId: ctxId,\n              expression: scrollExpr,\n              returnByValue: true,\n            }\n          : { expression: scrollExpr, returnByValue: true };\n        const { result } = await curSession.send<{\n          result: { value?: { sx?: number; sy?: number } };\n        }>(\"Runtime.evaluate\", evalParams);\n        sx = Number(result?.value?.sx ?? 0);\n        sy = Number(result?.value?.sy ?? 0);\n      } catch {\n        //\n      }\n      const xi = Math.max(0, Math.floor(curX + sx));\n      const yi = Math.max(0, Math.floor(curY + sy));\n\n      let res: { backendNodeId?: number; frameId?: string } | undefined;\n      try {\n        res = await curSession.send<{\n          backendNodeId?: number;\n          frameId?: string;\n        }>(\"DOM.getNodeForLocation\", {\n          x: xi,\n          y: yi,\n          includeUserAgentShadowDOM: false,\n          ignorePointerEventsNone: false,\n        });\n      } catch {\n        return null;\n      }\n\n      const be = res?.backendNodeId;\n      const reportedFrameId = res?.frameId;\n      if (\n        typeof be === \"number\" &&\n        reportedFrameId &&\n        reportedFrameId !== curFrameId\n      ) {\n        const abs = await buildAbsoluteXPathFromChain(\n          iframeChain,\n          curSession,\n          be,\n        );\n        return abs\n          ? { frameId: reportedFrameId, backendNodeId: be, absoluteXPath: abs }\n          : null;\n      }\n\n      if (typeof be !== \"number\") return null;\n\n      let matchedChild: string | undefined;\n      for (const fid of listChildrenOf(parentByFrame, curFrameId)) {\n        try {\n          const { backendNodeId } = await curSession.send<{\n            backendNodeId?: number;\n          }>(\"DOM.getFrameOwner\", { frameId: fid });\n          if (backendNodeId === be) {\n            matchedChild = fid;\n            break;\n          }\n        } catch {\n          continue;\n        }\n      }\n\n      if (!matchedChild) {\n        const abs = await buildAbsoluteXPathFromChain(\n          iframeChain,\n          curSession,\n          be,\n        );\n        return abs\n          ? { frameId: curFrameId, backendNodeId: be, absoluteXPath: abs }\n          : null;\n      }\n\n      iframeChain.push({\n        parentSession: curSession,\n        iframeBackendNodeId: be,\n      });\n\n      let left = 0;\n      let top = 0;\n      try {\n        const { object } = await curSession.send<{\n          object: { objectId?: string };\n        }>(\"DOM.resolveNode\", { backendNodeId: be });\n        const objectId = object?.objectId;\n        if (objectId) {\n          const { result } = await curSession.send<{\n            result: { value?: { left: number; top: number } };\n          }>(\"Runtime.callFunctionOn\", {\n            objectId,\n            functionDeclaration: a11yScriptSources.getBoundingRectLite,\n            returnByValue: true,\n          });\n          left = Number(result?.value?.left ?? 0);\n          top = Number(result?.value?.top ?? 0);\n          await curSession\n            .send(\"Runtime.releaseObject\", { objectId })\n            .catch(() => {});\n        }\n      } catch {\n        //\n      }\n      curX = Math.max(0, curX - left);\n      curY = Math.max(0, curY - top);\n      curFrameId = matchedChild;\n      curSession = page.getSessionForFrame(curFrameId);\n    } catch {\n      return null;\n    }\n  }\n  return null;\n}\n"]}
+{"version":3,"file":"coordinateResolver.js","sourceRoot":"","sources":["../../../../../../../lib/v3/understudy/a11y/snapshot/coordinateResolver.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Protocol } from \"devtools-protocol\";\nimport type { CDPSessionLike } from \"../../cdp.js\";\nimport { Page } from \"../../page.js\";\nimport { executionContexts } from \"../../executionContextRegistry.js\";\nimport { a11yScriptSources } from \"../../../dom/build/a11yScripts.generated.js\";\nimport { buildA11yInvocation } from \"../../a11yInvocation.js\";\nimport type { ResolvedLocation } from \"../../../types/private/snapshot.js\";\nimport { listChildrenOf } from \"./focusSelectors.js\";\nimport { buildAbsoluteXPathFromChain } from \"./xpathUtils.js\";\n\n/**\n * Resolve deepest node for a page coordinate and compute its absolute XPath across frames.\n * More efficient than building a full hybrid snapshot when only a single node’s XPath is needed.\n */\nexport async function resolveXpathForLocation(\n  page: Page,\n  x: number,\n  y: number,\n): Promise<ResolvedLocation | null> {\n  const tree = page.getFullFrameTree();\n  const parentByFrame = new Map<string, string | null>();\n  (function index(n: Protocol.Page.FrameTree, parent: string | null) {\n    parentByFrame.set(n.frame.id, parent);\n    for (const c of n.childFrames ?? []) index(c, n.frame.id);\n  })(tree, null);\n\n  const iframeChain: Array<{\n    parentSession: CDPSessionLike;\n    iframeBackendNodeId: number;\n  }> = [];\n\n  let curFrameId = page.mainFrameId();\n  let curSession = page.getSessionForFrame(curFrameId);\n  let curX = x;\n  let curY = y;\n\n  for (let depth = 0; depth < 8; depth++) {\n    try {\n      await curSession.send(\"DOM.enable\").catch(() => {});\n\n      let sx = 0;\n      let sy = 0;\n      try {\n        await curSession.send(\"Runtime.enable\").catch(() => {});\n        const ctxId = await executionContexts\n          .waitForMainWorld(curSession, curFrameId)\n          .catch(() => {});\n        const scrollExpr = buildA11yInvocation(\"getScrollOffsets\", []);\n        const evalParams = ctxId\n          ? {\n              contextId: ctxId,\n              expression: scrollExpr,\n              returnByValue: true,\n            }\n          : { expression: scrollExpr, returnByValue: true };\n        const { result } = await curSession.send<{\n          result: { value?: { sx?: number; sy?: number } };\n        }>(\"Runtime.evaluate\", evalParams);\n        sx = Number(result?.value?.sx ?? 0);\n        sy = Number(result?.value?.sy ?? 0);\n      } catch {\n        //\n      }\n      const xi = Math.max(0, Math.floor(curX + sx));\n      const yi = Math.max(0, Math.floor(curY + sy));\n\n      let res: { backendNodeId?: number; frameId?: string } | undefined;\n      try {\n        res = await curSession.send<{\n          backendNodeId?: number;\n          frameId?: string;\n        }>(\"DOM.getNodeForLocation\", {\n          x: xi,\n          y: yi,\n          includeUserAgentShadowDOM: false,\n          ignorePointerEventsNone: false,\n        });\n      } catch {\n        return null;\n      }\n\n      const be = res?.backendNodeId;\n      const reportedFrameId = res?.frameId;\n      if (\n        typeof be === \"number\" &&\n        reportedFrameId &&\n        reportedFrameId !== curFrameId\n      ) {\n        const chain = [...iframeChain];\n        const framePath: string[] = [];\n        let frameId: string | null | undefined = reportedFrameId;\n        while (frameId && frameId !== curFrameId) {\n          framePath.unshift(frameId);\n          frameId = parentByFrame.get(frameId);\n        }\n\n        let resolvedFramePath = false;\n        if (frameId === curFrameId) {\n          resolvedFramePath = true;\n          for (const childFrameId of framePath) {\n            const parentFrameId = parentByFrame.get(childFrameId);\n            if (!parentFrameId) {\n              resolvedFramePath = false;\n              break;\n            }\n            try {\n              const parentSession = page.getSessionForFrame(parentFrameId);\n              const { backendNodeId } = await parentSession.send<{\n                backendNodeId?: number;\n              }>(\"DOM.getFrameOwner\", { frameId: childFrameId });\n              if (typeof backendNodeId !== \"number\") {\n                resolvedFramePath = false;\n                break;\n              }\n\n              chain.push({\n                parentSession,\n                iframeBackendNodeId: backendNodeId,\n              });\n            } catch {\n              resolvedFramePath = false;\n              break;\n            }\n          }\n        }\n\n        if (!resolvedFramePath) {\n          return null;\n        }\n\n        const leafSession = page.getSessionForFrame(reportedFrameId);\n        const abs = await buildAbsoluteXPathFromChain(chain, leafSession, be);\n        return abs\n          ? { frameId: reportedFrameId, backendNodeId: be, absoluteXPath: abs }\n          : null;\n      }\n\n      if (typeof be !== \"number\") return null;\n\n      let matchedChild: string | undefined;\n      for (const fid of listChildrenOf(parentByFrame, curFrameId)) {\n        try {\n          const { backendNodeId } = await curSession.send<{\n            backendNodeId?: number;\n          }>(\"DOM.getFrameOwner\", { frameId: fid });\n          if (backendNodeId === be) {\n            matchedChild = fid;\n            break;\n          }\n        } catch {\n          continue;\n        }\n      }\n\n      if (!matchedChild) {\n        const abs = await buildAbsoluteXPathFromChain(\n          iframeChain,\n          curSession,\n          be,\n        );\n        return abs\n          ? { frameId: curFrameId, backendNodeId: be, absoluteXPath: abs }\n          : null;\n      }\n\n      iframeChain.push({\n        parentSession: curSession,\n        iframeBackendNodeId: be,\n      });\n\n      let left = 0;\n      let top = 0;\n      try {\n        const { object } = await curSession.send<{\n          object: { objectId?: string };\n        }>(\"DOM.resolveNode\", { backendNodeId: be });\n        const objectId = object?.objectId;\n        if (objectId) {\n          const { result } = await curSession.send<{\n            result: { value?: { left: number; top: number } };\n          }>(\"Runtime.callFunctionOn\", {\n            objectId,\n            functionDeclaration: a11yScriptSources.getBoundingRectLite,\n            returnByValue: true,\n          });\n          left = Number(result?.value?.left ?? 0);\n          top = Number(result?.value?.top ?? 0);\n          await curSession\n            .send(\"Runtime.releaseObject\", { objectId })\n            .catch(() => {});\n        }\n      } catch {\n        //\n      }\n      curX = Math.max(0, curX - left);\n      curY = Math.max(0, curY - top);\n      curFrameId = matchedChild;\n      curSession = page.getSessionForFrame(curFrameId);\n    } catch {\n      return null;\n    }\n  }\n  return null;\n}\n"]}

package/dist/cjs/lib/version.d.ts

@@ -2,4 +2,4 @@
  * AUTO-GENERATED — DO NOT EDIT BY HAND
  *  Run `pnpm run gen-version` to refresh.
  */
-export declare const STAGEHAND_VERSION: "3.7.2";
+export declare const STAGEHAND_VERSION: "3.7.3-alpha-94a0ee4e195a7563ae53a04793a092f37aabd388";

package/dist/cjs/lib/version.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../lib/version.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,iBAAiB,GAAG,OAAgB,CAAC","sourcesContent":["/**\n * AUTO-GENERATED — DO NOT EDIT BY HAND\n *  Run `pnpm run gen-version` to refresh.\n */\nexport const STAGEHAND_VERSION = \"3.7.2\" as const;\n"]}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../lib/version.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,iBAAiB,GAAG,sDAA+D,CAAC","sourcesContent":["/**\n * AUTO-GENERATED — DO NOT EDIT BY HAND\n *  Run `pnpm run gen-version` to refresh.\n */\nexport const STAGEHAND_VERSION = \"3.7.3-alpha-94a0ee4e195a7563ae53a04793a092f37aabd388\" as const;\n"]}

package/dist/esm/lib/v3/launch/local.js

@@ -6,8 +6,8 @@ const STAGEHAND_DEFAULT_FLAGS = [
     "--no-first-run",
     "--no-default-browser-check",
     "--disable-dev-shm-usage",
-    "--site-per-process",
     "--enable-features=WebMCPTesting,DevToolsWebMCPSupport",
+    "--disable-features=SitePerProcess",
 ];
 export async function launchLocalChrome(opts) {
     const connectTimeoutMs = opts.connectTimeoutMs ?? 15_000;

package/dist/esm/lib/v3/launch/local.js.map

@@ -1 +1 @@
-{"version":3,"file":"local.js","sourceRoot":"","sources":["../../../../../lib/v3/launch/local.ts"],"names":[],"mappings":"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","sourcesContent":["import { launch, Launcher, LaunchedChrome } from \"chrome-launcher\";\nimport WebSocket from \"ws\";\nimport { ConnectionTimeoutError } from \"../types/public/sdkErrors.js\";\nimport type { LocalBrowserLaunchOptions } from \"../types/public/index.js\";\n\ninterface LaunchLocalOptions extends LocalBrowserLaunchOptions {\n  handleSIGINT?: boolean;\n}\n\nconst STAGEHAND_DEFAULT_FLAGS = [\n  \"--remote-allow-origins=*\",\n  \"--no-first-run\",\n  \"--no-default-browser-check\",\n  \"--disable-dev-shm-usage\",\n  \"--site-per-process\",\n  \"--enable-features=WebMCPTesting,DevToolsWebMCPSupport\",\n];\n\nexport async function launchLocalChrome(\n  opts: LaunchLocalOptions,\n): Promise<{ ws: string; chrome: LaunchedChrome }> {\n  const connectTimeoutMs = opts.connectTimeoutMs ?? 15_000;\n  const deadlineMs = Date.now() + connectTimeoutMs;\n  const connectionPollInterval = 250;\n  const maxConnectionRetries = Math.max(\n    1,\n    Math.ceil(connectTimeoutMs / connectionPollInterval),\n  );\n  const headless = opts.headless ?? false;\n  const ignoredDefaults = Array.isArray(opts.ignoreDefaultArgs)\n    ? opts.ignoreDefaultArgs\n    : null;\n  const stagehandDefaultFlags =\n    opts.ignoreDefaultArgs === true\n      ? []\n      : ignoredDefaults\n        ? STAGEHAND_DEFAULT_FLAGS.filter((f) => !ignoredDefaults.includes(f))\n        : [...STAGEHAND_DEFAULT_FLAGS];\n  const chromeFlags = [\n    ...stagehandDefaultFlags,\n    headless ? \"--headless=new\" : undefined,\n    opts.devtools ? \"--auto-open-devtools-for-tabs\" : undefined,\n    opts.locale ? `--lang=${opts.locale}` : undefined,\n    opts.viewport?.width && opts.viewport?.height\n      ? `--window-size=${opts.viewport.width},${opts.viewport.height + 87}`\n      : undefined,\n    typeof opts.deviceScaleFactor === \"number\"\n      ? `--force-device-scale-factor=${Math.max(0.1, opts.deviceScaleFactor)}`\n      : undefined,\n    opts.hasTouch ? \"--touch-events=enabled\" : undefined,\n    opts.ignoreHTTPSErrors ? \"--ignore-certificate-errors\" : undefined,\n    opts.proxy?.server ? `--proxy-server=${opts.proxy.server}` : undefined,\n    opts.proxy?.bypass ? `--proxy-bypass-list=${opts.proxy.bypass}` : undefined,\n    ...(opts.args ?? []),\n  ].filter((f): f is string => typeof f === \"string\");\n\n  // Handle ignoreDefaultArgs: selectively remove chrome-launcher's built-in\n  // defaults while keeping Stagehand's own flags (already in chromeFlags).\n  let ignoreDefaultFlags = false;\n  if (opts.ignoreDefaultArgs === true) {\n    ignoreDefaultFlags = true;\n  } else if (\n    Array.isArray(opts.ignoreDefaultArgs) &&\n    opts.ignoreDefaultArgs.length > 0\n  ) {\n    // Tell chrome-launcher to skip ALL its defaults, then re-add the ones\n    // the user did NOT ask to exclude.\n    ignoreDefaultFlags = true;\n    const excludeArgs = opts.ignoreDefaultArgs;\n    const clDefaults = Launcher.defaultFlags?.() ?? [];\n    const kept = clDefaults.filter((f) => !excludeArgs.includes(f));\n    chromeFlags.unshift(...kept);\n  }\n\n  const chrome = await launch({\n    chromePath: opts.executablePath,\n    chromeFlags,\n    port: opts.port,\n    userDataDir: opts.userDataDir,\n    handleSIGINT: opts.handleSIGINT,\n    ignoreDefaultFlags,\n    connectionPollInterval,\n    maxConnectionRetries,\n  });\n\n  const ws = await waitForWebSocketDebuggerUrl(chrome.port, deadlineMs);\n  await waitForWebSocketReady(ws, deadlineMs);\n\n  return { ws, chrome };\n}\n\nasync function waitForWebSocketDebuggerUrl(\n  port: number,\n  deadlineMs: number,\n): Promise<string> {\n  let lastErrMsg = \"\";\n\n  while (Date.now() < deadlineMs) {\n    try {\n      const resp = await fetch(`http://127.0.0.1:${port}/json/version`);\n      if (resp.ok) {\n        const json = (await resp.json()) as unknown;\n        const url = (json as { webSocketDebuggerUrl?: string })\n          .webSocketDebuggerUrl;\n        if (typeof url === \"string\") return url;\n      } else {\n        lastErrMsg = `${resp.status} ${resp.statusText}`;\n      }\n    } catch (err) {\n      lastErrMsg = err instanceof Error ? err.message : String(err);\n    }\n    await new Promise((r) => setTimeout(r, 250));\n  }\n\n  throw new ConnectionTimeoutError(\n    `Timed out waiting for /json/version on port ${port} ${\n      lastErrMsg ? ` (last error: ${lastErrMsg})` : \"\"\n    }`,\n  );\n}\n\nasync function waitForWebSocketReady(\n  wsUrl: string,\n  deadlineMs: number,\n): Promise<void> {\n  let lastErrMsg = \"\";\n  while (Date.now() < deadlineMs) {\n    const remainingMs = Math.max(200, deadlineMs - Date.now());\n    try {\n      await probeWebSocket(wsUrl, Math.min(2_000, remainingMs));\n      return;\n    } catch (error) {\n      lastErrMsg = error instanceof Error ? error.message : String(error);\n      await new Promise((r) => setTimeout(r, 100));\n    }\n  }\n  throw new ConnectionTimeoutError(\n    `Timed out waiting for CDP websocket to accept connections at ${wsUrl}${\n      lastErrMsg ? ` (last error: ${lastErrMsg})` : \"\"\n    }`,\n  );\n}\n\nfunction probeWebSocket(wsUrl: string, timeoutMs: number): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const ws = new WebSocket(wsUrl);\n    let settled = false;\n    const finish = (error?: unknown) => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timer);\n      try {\n        ws.terminate();\n      } catch {\n        // best-effort cleanup\n      }\n      if (error) {\n        reject(error);\n        return;\n      }\n      resolve();\n    };\n    const timer = setTimeout(() => {\n      finish(new Error(`websocket probe timeout after ${timeoutMs}ms`));\n    }, timeoutMs);\n\n    ws.once(\"open\", () => finish());\n    ws.once(\"error\", (error) => finish(error));\n  });\n}\n"]}
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../../../../lib/v3/launch/local.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAkB,MAAM,iBAAiB,CAAC;AACnE,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAOtE,MAAM,uBAAuB,GAAG;IAC9B,0BAA0B;IAC1B,gBAAgB;IAChB,4BAA4B;IAC5B,yBAAyB;IACzB,uDAAuD;IACvD,mCAAmC;CACpC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAwB;IAExB,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,IAAI,MAAM,CAAC;IACzD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,gBAAgB,CAAC;IACjD,MAAM,sBAAsB,GAAG,GAAG,CAAC;IACnC,MAAM,oBAAoB,GAAG,IAAI,CAAC,GAAG,CACnC,CAAC,EACD,IAAI,CAAC,IAAI,CAAC,gBAAgB,GAAG,sBAAsB,CAAC,CACrD,CAAC;IACF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC;IACxC,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC;QAC3D,CAAC,CAAC,IAAI,CAAC,iBAAiB;QACxB,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,qBAAqB,GACzB,IAAI,CAAC,iBAAiB,KAAK,IAAI;QAC7B,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,eAAe;YACf,CAAC,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACrE,CAAC,CAAC,CAAC,GAAG,uBAAuB,CAAC,CAAC;IACrC,MAAM,WAAW,GAAG;QAClB,GAAG,qBAAqB;QACxB,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;QACvC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,SAAS;QAC3D,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;QACjD,IAAI,CAAC,QAAQ,EAAE,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,MAAM;YAC3C,CAAC,CAAC,iBAAiB,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,EAAE,EAAE;YACrE,CAAC,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,iBAAiB,KAAK,QAAQ;YACxC,CAAC,CAAC,+BAA+B,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,iBAAiB,CAAC,EAAE;YACxE,CAAC,CAAC,SAAS;QACb,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,SAAS;QACpD,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,SAAS;QAClE,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,kBAAkB,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;QACtE,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,uBAAuB,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;QAC3E,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;KACrB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IAEpD,0EAA0E;IAC1E,yEAAyE;IACzE,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAC/B,IAAI,IAAI,CAAC,iBAAiB,KAAK,IAAI,EAAE,CAAC;QACpC,kBAAkB,GAAG,IAAI,CAAC;IAC5B,CAAC;SAAM,IACL,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC;QACrC,IAAI,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EACjC,CAAC;QACD,sEAAsE;QACtE,mCAAmC;QACnC,kBAAkB,GAAG,IAAI,CAAC;QAC1B,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAAC;QAC3C,MAAM,UAAU,GAAG,QAAQ,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC;QAC1B,UAAU,EAAE,IAAI,CAAC,cAAc;QAC/B,WAAW;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,kBAAkB;QAClB,sBAAsB;QACtB,oBAAoB;KACrB,CAAC,CAAC;IAEH,MAAM,EAAE,GAAG,MAAM,2BAA2B,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACtE,MAAM,qBAAqB,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAE5C,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;AACxB,CAAC;AAED,KAAK,UAAU,2BAA2B,CACxC,IAAY,EACZ,UAAkB;IAElB,IAAI,UAAU,GAAG,EAAE,CAAC;IAEpB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,oBAAoB,IAAI,eAAe,CAAC,CAAC;YAClE,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAY,CAAC;gBAC5C,MAAM,GAAG,GAAI,IAA0C;qBACpD,oBAAoB,CAAC;gBACxB,IAAI,OAAO,GAAG,KAAK,QAAQ;oBAAE,OAAO,GAAG,CAAC;YAC1C,CAAC;iBAAM,CAAC;gBACN,UAAU,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACnD,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,UAAU,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,IAAI,sBAAsB,CAC9B,+CAA+C,IAAI,IACjD,UAAU,CAAC,CAAC,CAAC,iBAAiB,UAAU,GAAG,CAAC,CAAC,CAAC,EAChD,EAAE,CACH,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,KAAa,EACb,UAAkB;IAElB,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC;YACH,MAAM,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;YAC1D,OAAO;QACT,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,UAAU,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACpE,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,MAAM,IAAI,sBAAsB,CAC9B,gEAAgE,KAAK,GACnE,UAAU,CAAC,CAAC,CAAC,iBAAiB,UAAU,GAAG,CAAC,CAAC,CAAC,EAChD,EAAE,CACH,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAa,EAAE,SAAiB;IACtD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,KAAe,EAAE,EAAE;YACjC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,CAAC;gBACH,EAAE,CAAC,SAAS,EAAE,CAAC;YACjB,CAAC;YAAC,MAAM,CAAC;gBACP,sBAAsB;YACxB,CAAC;YACD,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,KAAK,CAAC,CAAC;gBACd,OAAO;YACT,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,SAAS,IAAI,CAAC,CAAC,CAAC;QACpE,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;QAChC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { launch, Launcher, LaunchedChrome } from \"chrome-launcher\";\nimport WebSocket from \"ws\";\nimport { ConnectionTimeoutError } from \"../types/public/sdkErrors.js\";\nimport type { LocalBrowserLaunchOptions } from \"../types/public/index.js\";\n\ninterface LaunchLocalOptions extends LocalBrowserLaunchOptions {\n  handleSIGINT?: boolean;\n}\n\nconst STAGEHAND_DEFAULT_FLAGS = [\n  \"--remote-allow-origins=*\",\n  \"--no-first-run\",\n  \"--no-default-browser-check\",\n  \"--disable-dev-shm-usage\",\n  \"--enable-features=WebMCPTesting,DevToolsWebMCPSupport\",\n  \"--disable-features=SitePerProcess\",\n];\n\nexport async function launchLocalChrome(\n  opts: LaunchLocalOptions,\n): Promise<{ ws: string; chrome: LaunchedChrome }> {\n  const connectTimeoutMs = opts.connectTimeoutMs ?? 15_000;\n  const deadlineMs = Date.now() + connectTimeoutMs;\n  const connectionPollInterval = 250;\n  const maxConnectionRetries = Math.max(\n    1,\n    Math.ceil(connectTimeoutMs / connectionPollInterval),\n  );\n  const headless = opts.headless ?? false;\n  const ignoredDefaults = Array.isArray(opts.ignoreDefaultArgs)\n    ? opts.ignoreDefaultArgs\n    : null;\n  const stagehandDefaultFlags =\n    opts.ignoreDefaultArgs === true\n      ? []\n      : ignoredDefaults\n        ? STAGEHAND_DEFAULT_FLAGS.filter((f) => !ignoredDefaults.includes(f))\n        : [...STAGEHAND_DEFAULT_FLAGS];\n  const chromeFlags = [\n    ...stagehandDefaultFlags,\n    headless ? \"--headless=new\" : undefined,\n    opts.devtools ? \"--auto-open-devtools-for-tabs\" : undefined,\n    opts.locale ? `--lang=${opts.locale}` : undefined,\n    opts.viewport?.width && opts.viewport?.height\n      ? `--window-size=${opts.viewport.width},${opts.viewport.height + 87}`\n      : undefined,\n    typeof opts.deviceScaleFactor === \"number\"\n      ? `--force-device-scale-factor=${Math.max(0.1, opts.deviceScaleFactor)}`\n      : undefined,\n    opts.hasTouch ? \"--touch-events=enabled\" : undefined,\n    opts.ignoreHTTPSErrors ? \"--ignore-certificate-errors\" : undefined,\n    opts.proxy?.server ? `--proxy-server=${opts.proxy.server}` : undefined,\n    opts.proxy?.bypass ? `--proxy-bypass-list=${opts.proxy.bypass}` : undefined,\n    ...(opts.args ?? []),\n  ].filter((f): f is string => typeof f === \"string\");\n\n  // Handle ignoreDefaultArgs: selectively remove chrome-launcher's built-in\n  // defaults while keeping Stagehand's own flags (already in chromeFlags).\n  let ignoreDefaultFlags = false;\n  if (opts.ignoreDefaultArgs === true) {\n    ignoreDefaultFlags = true;\n  } else if (\n    Array.isArray(opts.ignoreDefaultArgs) &&\n    opts.ignoreDefaultArgs.length > 0\n  ) {\n    // Tell chrome-launcher to skip ALL its defaults, then re-add the ones\n    // the user did NOT ask to exclude.\n    ignoreDefaultFlags = true;\n    const excludeArgs = opts.ignoreDefaultArgs;\n    const clDefaults = Launcher.defaultFlags?.() ?? [];\n    const kept = clDefaults.filter((f) => !excludeArgs.includes(f));\n    chromeFlags.unshift(...kept);\n  }\n\n  const chrome = await launch({\n    chromePath: opts.executablePath,\n    chromeFlags,\n    port: opts.port,\n    userDataDir: opts.userDataDir,\n    handleSIGINT: opts.handleSIGINT,\n    ignoreDefaultFlags,\n    connectionPollInterval,\n    maxConnectionRetries,\n  });\n\n  const ws = await waitForWebSocketDebuggerUrl(chrome.port, deadlineMs);\n  await waitForWebSocketReady(ws, deadlineMs);\n\n  return { ws, chrome };\n}\n\nasync function waitForWebSocketDebuggerUrl(\n  port: number,\n  deadlineMs: number,\n): Promise<string> {\n  let lastErrMsg = \"\";\n\n  while (Date.now() < deadlineMs) {\n    try {\n      const resp = await fetch(`http://127.0.0.1:${port}/json/version`);\n      if (resp.ok) {\n        const json = (await resp.json()) as unknown;\n        const url = (json as { webSocketDebuggerUrl?: string })\n          .webSocketDebuggerUrl;\n        if (typeof url === \"string\") return url;\n      } else {\n        lastErrMsg = `${resp.status} ${resp.statusText}`;\n      }\n    } catch (err) {\n      lastErrMsg = err instanceof Error ? err.message : String(err);\n    }\n    await new Promise((r) => setTimeout(r, 250));\n  }\n\n  throw new ConnectionTimeoutError(\n    `Timed out waiting for /json/version on port ${port} ${\n      lastErrMsg ? ` (last error: ${lastErrMsg})` : \"\"\n    }`,\n  );\n}\n\nasync function waitForWebSocketReady(\n  wsUrl: string,\n  deadlineMs: number,\n): Promise<void> {\n  let lastErrMsg = \"\";\n  while (Date.now() < deadlineMs) {\n    const remainingMs = Math.max(200, deadlineMs - Date.now());\n    try {\n      await probeWebSocket(wsUrl, Math.min(2_000, remainingMs));\n      return;\n    } catch (error) {\n      lastErrMsg = error instanceof Error ? error.message : String(error);\n      await new Promise((r) => setTimeout(r, 100));\n    }\n  }\n  throw new ConnectionTimeoutError(\n    `Timed out waiting for CDP websocket to accept connections at ${wsUrl}${\n      lastErrMsg ? ` (last error: ${lastErrMsg})` : \"\"\n    }`,\n  );\n}\n\nfunction probeWebSocket(wsUrl: string, timeoutMs: number): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const ws = new WebSocket(wsUrl);\n    let settled = false;\n    const finish = (error?: unknown) => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timer);\n      try {\n        ws.terminate();\n      } catch {\n        // best-effort cleanup\n      }\n      if (error) {\n        reject(error);\n        return;\n      }\n      resolve();\n    };\n    const timer = setTimeout(() => {\n      finish(new Error(`websocket probe timeout after ${timeoutMs}ms`));\n    }, timeoutMs);\n\n    ws.once(\"open\", () => finish());\n    ws.once(\"error\", (error) => finish(error));\n  });\n}\n"]}

package/dist/esm/lib/v3/runtimePaths.js

@@ -4,7 +4,6 @@
  * - /packages/server-v3/scripts/runtimePaths.ts
  * - /packages/server-v4/scripts/runtimePaths.ts
  * - /packages/evals/runtimePaths.ts
- * - /packages/docs/scripts/runtimePaths.js
  */
 import path from "node:path";
 import { fileURLToPath } from "node:url";

package/dist/esm/lib/v3/runtimePaths.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtimePaths.js","sourceRoot":"","sources":["../../../../lib/v3/runtimePaths.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Keep this file in sync with:\n * - /packages/core/lib/v3/runtimePaths.ts\n * - /packages/server-v3/scripts/runtimePaths.ts\n * - /packages/server-v4/scripts/runtimePaths.ts\n * - /packages/evals/runtimePaths.ts\n * - /packages/docs/scripts/runtimePaths.js\n */\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { createRequire } from \"node:module\";\n\nconst PACKAGE_SEGMENT = \"/packages/core/\";\nconst EVAL_FRAMES = new Set([\"[eval]\", \"[eval]-wrapper\"]);\nconst INTERNAL_FRAME_NAMES = new Set([\n  \"readCallsites\",\n  \"readCallsitePath\",\n  \"resolveCallerFilePath\",\n  \"getCurrentFilePath\",\n  \"getCurrentDirPath\",\n  \"getRepoRootDir\",\n  \"getPackageRootDir\",\n  \"createRequireFromCaller\",\n  \"isMainModule\",\n]);\n\nconst normalizePath = (value: string): string => {\n  const input = value.startsWith(\"file://\") ? fileURLToPath(value) : value;\n  return path.resolve(input).replaceAll(\"\\\\\", \"/\");\n};\n\nconst readCallsites = (): NodeJS.CallSite[] => {\n  const previousPrepare = Error.prepareStackTrace;\n  try {\n    Error.prepareStackTrace = (_, stack) => stack;\n    return (\n      (new Error().stack as unknown as NodeJS.CallSite[] | undefined) ?? []\n    );\n  } finally {\n    Error.prepareStackTrace = previousPrepare;\n  }\n};\n\ntype CallSiteWithScriptName = NodeJS.CallSite & {\n  getScriptNameOrSourceURL?: () => string | null;\n};\n\nconst readCallsitePath = (callsite: NodeJS.CallSite): string | null => {\n  const callsiteWithScript = callsite as CallSiteWithScriptName;\n  const rawPath =\n    callsite.getFileName() ?? callsiteWithScript.getScriptNameOrSourceURL?.();\n  if (!rawPath) return null;\n  if (rawPath.startsWith(\"node:\")) return null;\n  if (EVAL_FRAMES.has(rawPath)) return null;\n  return normalizePath(rawPath);\n};\n\nconst isInternalCallsite = (callsite: NodeJS.CallSite): boolean => {\n  const functionName = callsite.getFunctionName();\n  if (functionName && INTERNAL_FRAME_NAMES.has(functionName)) return true;\n\n  const methodName = callsite.getMethodName();\n  if (methodName && INTERNAL_FRAME_NAMES.has(methodName)) return true;\n\n  const callsiteString = callsite.toString();\n  for (const frameName of INTERNAL_FRAME_NAMES) {\n    if (callsiteString.includes(`${frameName} (`)) return true;\n    if (callsiteString.includes(`.${frameName} (`)) return true;\n  }\n  return false;\n};\n\nconst resolveCallerFilePath = (): string => {\n  const packageCandidates: string[] = [];\n  const fallbackCandidates: string[] = [];\n\n  for (const callsite of readCallsites()) {\n    const filePath = readCallsitePath(callsite);\n    if (!filePath) continue;\n    if (isInternalCallsite(callsite)) continue;\n    if (filePath.includes(PACKAGE_SEGMENT)) {\n      packageCandidates.push(filePath);\n      continue;\n    }\n    fallbackCandidates.push(filePath);\n  }\n\n  const packageCandidate = packageCandidates[0];\n  if (packageCandidate) return packageCandidate;\n\n  const fallbackCandidate = fallbackCandidates[0];\n  if (fallbackCandidate) return fallbackCandidate;\n\n  throw new Error(\"Unable to resolve caller file path.\");\n};\n\nexport const getCurrentFilePath = (): string => resolveCallerFilePath();\n\nexport const getCurrentDirPath = (): string =>\n  path.dirname(getCurrentFilePath());\n\nexport const getRepoRootDir = (): string => {\n  const currentFilePath = getCurrentFilePath();\n  const index = currentFilePath.lastIndexOf(PACKAGE_SEGMENT);\n  if (index === -1) {\n    throw new Error(\n      `Unable to determine repo root from ${currentFilePath} (missing ${PACKAGE_SEGMENT}).`,\n    );\n  }\n  return currentFilePath.slice(0, index);\n};\n\nexport const getPackageRootDir = (): string =>\n  `${getRepoRootDir()}${PACKAGE_SEGMENT.slice(0, -1)}`;\n\nexport const createRequireFromCaller = () =>\n  createRequire(getCurrentFilePath());\n\nexport const isMainModule = (): boolean => {\n  const entryScript = process.argv.at(1);\n  if (!entryScript) return false;\n  return normalizePath(entryScript) === getCurrentFilePath();\n};\n"]}
+{"version":3,"file":"runtimePaths.js","sourceRoot":"","sources":["../../../../lib/v3/runtimePaths.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Keep this file in sync with:\n * - /packages/core/lib/v3/runtimePaths.ts\n * - /packages/server-v3/scripts/runtimePaths.ts\n * - /packages/server-v4/scripts/runtimePaths.ts\n * - /packages/evals/runtimePaths.ts\n */\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { createRequire } from \"node:module\";\n\nconst PACKAGE_SEGMENT = \"/packages/core/\";\nconst EVAL_FRAMES = new Set([\"[eval]\", \"[eval]-wrapper\"]);\nconst INTERNAL_FRAME_NAMES = new Set([\n  \"readCallsites\",\n  \"readCallsitePath\",\n  \"resolveCallerFilePath\",\n  \"getCurrentFilePath\",\n  \"getCurrentDirPath\",\n  \"getRepoRootDir\",\n  \"getPackageRootDir\",\n  \"createRequireFromCaller\",\n  \"isMainModule\",\n]);\n\nconst normalizePath = (value: string): string => {\n  const input = value.startsWith(\"file://\") ? fileURLToPath(value) : value;\n  return path.resolve(input).replaceAll(\"\\\\\", \"/\");\n};\n\nconst readCallsites = (): NodeJS.CallSite[] => {\n  const previousPrepare = Error.prepareStackTrace;\n  try {\n    Error.prepareStackTrace = (_, stack) => stack;\n    return (\n      (new Error().stack as unknown as NodeJS.CallSite[] | undefined) ?? []\n    );\n  } finally {\n    Error.prepareStackTrace = previousPrepare;\n  }\n};\n\ntype CallSiteWithScriptName = NodeJS.CallSite & {\n  getScriptNameOrSourceURL?: () => string | null;\n};\n\nconst readCallsitePath = (callsite: NodeJS.CallSite): string | null => {\n  const callsiteWithScript = callsite as CallSiteWithScriptName;\n  const rawPath =\n    callsite.getFileName() ?? callsiteWithScript.getScriptNameOrSourceURL?.();\n  if (!rawPath) return null;\n  if (rawPath.startsWith(\"node:\")) return null;\n  if (EVAL_FRAMES.has(rawPath)) return null;\n  return normalizePath(rawPath);\n};\n\nconst isInternalCallsite = (callsite: NodeJS.CallSite): boolean => {\n  const functionName = callsite.getFunctionName();\n  if (functionName && INTERNAL_FRAME_NAMES.has(functionName)) return true;\n\n  const methodName = callsite.getMethodName();\n  if (methodName && INTERNAL_FRAME_NAMES.has(methodName)) return true;\n\n  const callsiteString = callsite.toString();\n  for (const frameName of INTERNAL_FRAME_NAMES) {\n    if (callsiteString.includes(`${frameName} (`)) return true;\n    if (callsiteString.includes(`.${frameName} (`)) return true;\n  }\n  return false;\n};\n\nconst resolveCallerFilePath = (): string => {\n  const packageCandidates: string[] = [];\n  const fallbackCandidates: string[] = [];\n\n  for (const callsite of readCallsites()) {\n    const filePath = readCallsitePath(callsite);\n    if (!filePath) continue;\n    if (isInternalCallsite(callsite)) continue;\n    if (filePath.includes(PACKAGE_SEGMENT)) {\n      packageCandidates.push(filePath);\n      continue;\n    }\n    fallbackCandidates.push(filePath);\n  }\n\n  const packageCandidate = packageCandidates[0];\n  if (packageCandidate) return packageCandidate;\n\n  const fallbackCandidate = fallbackCandidates[0];\n  if (fallbackCandidate) return fallbackCandidate;\n\n  throw new Error(\"Unable to resolve caller file path.\");\n};\n\nexport const getCurrentFilePath = (): string => resolveCallerFilePath();\n\nexport const getCurrentDirPath = (): string =>\n  path.dirname(getCurrentFilePath());\n\nexport const getRepoRootDir = (): string => {\n  const currentFilePath = getCurrentFilePath();\n  const index = currentFilePath.lastIndexOf(PACKAGE_SEGMENT);\n  if (index === -1) {\n    throw new Error(\n      `Unable to determine repo root from ${currentFilePath} (missing ${PACKAGE_SEGMENT}).`,\n    );\n  }\n  return currentFilePath.slice(0, index);\n};\n\nexport const getPackageRootDir = (): string =>\n  `${getRepoRootDir()}${PACKAGE_SEGMENT.slice(0, -1)}`;\n\nexport const createRequireFromCaller = () =>\n  createRequire(getCurrentFilePath());\n\nexport const isMainModule = (): boolean => {\n  const entryScript = process.argv.at(1);\n  if (!entryScript) return false;\n  return normalizePath(entryScript) === getCurrentFilePath();\n};\n"]}

package/dist/esm/lib/v3/understudy/a11y/snapshot/coordinateResolver.js

@@ -64,7 +64,45 @@ export async function resolveXpathForLocation(page, x, y) {
             if (typeof be === "number" &&
                 reportedFrameId &&
                 reportedFrameId !== curFrameId) {
-                const abs = await buildAbsoluteXPathFromChain(iframeChain, curSession, be);
+                const chain = [...iframeChain];
+                const framePath = [];
+                let frameId = reportedFrameId;
+                while (frameId && frameId !== curFrameId) {
+                    framePath.unshift(frameId);
+                    frameId = parentByFrame.get(frameId);
+                }
+                let resolvedFramePath = false;
+                if (frameId === curFrameId) {
+                    resolvedFramePath = true;
+                    for (const childFrameId of framePath) {
+                        const parentFrameId = parentByFrame.get(childFrameId);
+                        if (!parentFrameId) {
+                            resolvedFramePath = false;
+                            break;
+                        }
+                        try {
+                            const parentSession = page.getSessionForFrame(parentFrameId);
+                            const { backendNodeId } = await parentSession.send("DOM.getFrameOwner", { frameId: childFrameId });
+                            if (typeof backendNodeId !== "number") {
+                                resolvedFramePath = false;
+                                break;
+                            }
+                            chain.push({
+                                parentSession,
+                                iframeBackendNodeId: backendNodeId,
+                            });
+                        }
+                        catch {
+                            resolvedFramePath = false;
+                            break;
+                        }
+                    }
+                }
+                if (!resolvedFramePath) {
+                    return null;
+                }
+                const leafSession = page.getSessionForFrame(reportedFrameId);
+                const abs = await buildAbsoluteXPathFromChain(chain, leafSession, be);
                 return abs
                     ? { frameId: reportedFrameId, backendNodeId: be, absoluteXPath: abs }
                     : null;

package/dist/esm/lib/v3/understudy/a11y/snapshot/coordinateResolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"coordinateResolver.js","sourceRoot":"","sources":["../../../../../../../lib/v3/understudy/a11y/snapshot/coordinateResolver.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Protocol } from \"devtools-protocol\";\nimport type { CDPSessionLike } from \"../../cdp.js\";\nimport { Page } from \"../../page.js\";\nimport { executionContexts } from \"../../executionContextRegistry.js\";\nimport { a11yScriptSources } from \"../../../dom/build/a11yScripts.generated.js\";\nimport { buildA11yInvocation } from \"../../a11yInvocation.js\";\nimport type { ResolvedLocation } from \"../../../types/private/snapshot.js\";\nimport { listChildrenOf } from \"./focusSelectors.js\";\nimport { buildAbsoluteXPathFromChain } from \"./xpathUtils.js\";\n\n/**\n * Resolve deepest node for a page coordinate and compute its absolute XPath across frames.\n * More efficient than building a full hybrid snapshot when only a single node’s XPath is needed.\n */\nexport async function resolveXpathForLocation(\n  page: Page,\n  x: number,\n  y: number,\n): Promise<ResolvedLocation | null> {\n  const tree = page.getFullFrameTree();\n  const parentByFrame = new Map<string, string | null>();\n  (function index(n: Protocol.Page.FrameTree, parent: string | null) {\n    parentByFrame.set(n.frame.id, parent);\n    for (const c of n.childFrames ?? []) index(c, n.frame.id);\n  })(tree, null);\n\n  const iframeChain: Array<{\n    parentSession: CDPSessionLike;\n    iframeBackendNodeId: number;\n  }> = [];\n\n  let curFrameId = page.mainFrameId();\n  let curSession = page.getSessionForFrame(curFrameId);\n  let curX = x;\n  let curY = y;\n\n  for (let depth = 0; depth < 8; depth++) {\n    try {\n      await curSession.send(\"DOM.enable\").catch(() => {});\n\n      let sx = 0;\n      let sy = 0;\n      try {\n        await curSession.send(\"Runtime.enable\").catch(() => {});\n        const ctxId = await executionContexts\n          .waitForMainWorld(curSession, curFrameId)\n          .catch(() => {});\n        const scrollExpr = buildA11yInvocation(\"getScrollOffsets\", []);\n        const evalParams = ctxId\n          ? {\n              contextId: ctxId,\n              expression: scrollExpr,\n              returnByValue: true,\n            }\n          : { expression: scrollExpr, returnByValue: true };\n        const { result } = await curSession.send<{\n          result: { value?: { sx?: number; sy?: number } };\n        }>(\"Runtime.evaluate\", evalParams);\n        sx = Number(result?.value?.sx ?? 0);\n        sy = Number(result?.value?.sy ?? 0);\n      } catch {\n        //\n      }\n      const xi = Math.max(0, Math.floor(curX + sx));\n      const yi = Math.max(0, Math.floor(curY + sy));\n\n      let res: { backendNodeId?: number; frameId?: string } | undefined;\n      try {\n        res = await curSession.send<{\n          backendNodeId?: number;\n          frameId?: string;\n        }>(\"DOM.getNodeForLocation\", {\n          x: xi,\n          y: yi,\n          includeUserAgentShadowDOM: false,\n          ignorePointerEventsNone: false,\n        });\n      } catch {\n        return null;\n      }\n\n      const be = res?.backendNodeId;\n      const reportedFrameId = res?.frameId;\n      if (\n        typeof be === \"number\" &&\n        reportedFrameId &&\n        reportedFrameId !== curFrameId\n      ) {\n        const abs = await buildAbsoluteXPathFromChain(\n          iframeChain,\n          curSession,\n          be,\n        );\n        return abs\n          ? { frameId: reportedFrameId, backendNodeId: be, absoluteXPath: abs }\n          : null;\n      }\n\n      if (typeof be !== \"number\") return null;\n\n      let matchedChild: string | undefined;\n      for (const fid of listChildrenOf(parentByFrame, curFrameId)) {\n        try {\n          const { backendNodeId } = await curSession.send<{\n            backendNodeId?: number;\n          }>(\"DOM.getFrameOwner\", { frameId: fid });\n          if (backendNodeId === be) {\n            matchedChild = fid;\n            break;\n          }\n        } catch {\n          continue;\n        }\n      }\n\n      if (!matchedChild) {\n        const abs = await buildAbsoluteXPathFromChain(\n          iframeChain,\n          curSession,\n          be,\n        );\n        return abs\n          ? { frameId: curFrameId, backendNodeId: be, absoluteXPath: abs }\n          : null;\n      }\n\n      iframeChain.push({\n        parentSession: curSession,\n        iframeBackendNodeId: be,\n      });\n\n      let left = 0;\n      let top = 0;\n      try {\n        const { object } = await curSession.send<{\n          object: { objectId?: string };\n        }>(\"DOM.resolveNode\", { backendNodeId: be });\n        const objectId = object?.objectId;\n        if (objectId) {\n          const { result } = await curSession.send<{\n            result: { value?: { left: number; top: number } };\n          }>(\"Runtime.callFunctionOn\", {\n            objectId,\n            functionDeclaration: a11yScriptSources.getBoundingRectLite,\n            returnByValue: true,\n          });\n          left = Number(result?.value?.left ?? 0);\n          top = Number(result?.value?.top ?? 0);\n          await curSession\n            .send(\"Runtime.releaseObject\", { objectId })\n            .catch(() => {});\n        }\n      } catch {\n        //\n      }\n      curX = Math.max(0, curX - left);\n      curY = Math.max(0, curY - top);\n      curFrameId = matchedChild;\n      curSession = page.getSessionForFrame(curFrameId);\n    } catch {\n      return null;\n    }\n  }\n  return null;\n}\n"]}
+{"version":3,"file":"coordinateResolver.js","sourceRoot":"","sources":["../../../../../../../lib/v3/understudy/a11y/snapshot/coordinateResolver.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Protocol } from \"devtools-protocol\";\nimport type { CDPSessionLike } from \"../../cdp.js\";\nimport { Page } from \"../../page.js\";\nimport { executionContexts } from \"../../executionContextRegistry.js\";\nimport { a11yScriptSources } from \"../../../dom/build/a11yScripts.generated.js\";\nimport { buildA11yInvocation } from \"../../a11yInvocation.js\";\nimport type { ResolvedLocation } from \"../../../types/private/snapshot.js\";\nimport { listChildrenOf } from \"./focusSelectors.js\";\nimport { buildAbsoluteXPathFromChain } from \"./xpathUtils.js\";\n\n/**\n * Resolve deepest node for a page coordinate and compute its absolute XPath across frames.\n * More efficient than building a full hybrid snapshot when only a single node’s XPath is needed.\n */\nexport async function resolveXpathForLocation(\n  page: Page,\n  x: number,\n  y: number,\n): Promise<ResolvedLocation | null> {\n  const tree = page.getFullFrameTree();\n  const parentByFrame = new Map<string, string | null>();\n  (function index(n: Protocol.Page.FrameTree, parent: string | null) {\n    parentByFrame.set(n.frame.id, parent);\n    for (const c of n.childFrames ?? []) index(c, n.frame.id);\n  })(tree, null);\n\n  const iframeChain: Array<{\n    parentSession: CDPSessionLike;\n    iframeBackendNodeId: number;\n  }> = [];\n\n  let curFrameId = page.mainFrameId();\n  let curSession = page.getSessionForFrame(curFrameId);\n  let curX = x;\n  let curY = y;\n\n  for (let depth = 0; depth < 8; depth++) {\n    try {\n      await curSession.send(\"DOM.enable\").catch(() => {});\n\n      let sx = 0;\n      let sy = 0;\n      try {\n        await curSession.send(\"Runtime.enable\").catch(() => {});\n        const ctxId = await executionContexts\n          .waitForMainWorld(curSession, curFrameId)\n          .catch(() => {});\n        const scrollExpr = buildA11yInvocation(\"getScrollOffsets\", []);\n        const evalParams = ctxId\n          ? {\n              contextId: ctxId,\n              expression: scrollExpr,\n              returnByValue: true,\n            }\n          : { expression: scrollExpr, returnByValue: true };\n        const { result } = await curSession.send<{\n          result: { value?: { sx?: number; sy?: number } };\n        }>(\"Runtime.evaluate\", evalParams);\n        sx = Number(result?.value?.sx ?? 0);\n        sy = Number(result?.value?.sy ?? 0);\n      } catch {\n        //\n      }\n      const xi = Math.max(0, Math.floor(curX + sx));\n      const yi = Math.max(0, Math.floor(curY + sy));\n\n      let res: { backendNodeId?: number; frameId?: string } | undefined;\n      try {\n        res = await curSession.send<{\n          backendNodeId?: number;\n          frameId?: string;\n        }>(\"DOM.getNodeForLocation\", {\n          x: xi,\n          y: yi,\n          includeUserAgentShadowDOM: false,\n          ignorePointerEventsNone: false,\n        });\n      } catch {\n        return null;\n      }\n\n      const be = res?.backendNodeId;\n      const reportedFrameId = res?.frameId;\n      if (\n        typeof be === \"number\" &&\n        reportedFrameId &&\n        reportedFrameId !== curFrameId\n      ) {\n        const chain = [...iframeChain];\n        const framePath: string[] = [];\n        let frameId: string | null | undefined = reportedFrameId;\n        while (frameId && frameId !== curFrameId) {\n          framePath.unshift(frameId);\n          frameId = parentByFrame.get(frameId);\n        }\n\n        let resolvedFramePath = false;\n        if (frameId === curFrameId) {\n          resolvedFramePath = true;\n          for (const childFrameId of framePath) {\n            const parentFrameId = parentByFrame.get(childFrameId);\n            if (!parentFrameId) {\n              resolvedFramePath = false;\n              break;\n            }\n            try {\n              const parentSession = page.getSessionForFrame(parentFrameId);\n              const { backendNodeId } = await parentSession.send<{\n                backendNodeId?: number;\n              }>(\"DOM.getFrameOwner\", { frameId: childFrameId });\n              if (typeof backendNodeId !== \"number\") {\n                resolvedFramePath = false;\n                break;\n              }\n\n              chain.push({\n                parentSession,\n                iframeBackendNodeId: backendNodeId,\n              });\n            } catch {\n              resolvedFramePath = false;\n              break;\n            }\n          }\n        }\n\n        if (!resolvedFramePath) {\n          return null;\n        }\n\n        const leafSession = page.getSessionForFrame(reportedFrameId);\n        const abs = await buildAbsoluteXPathFromChain(chain, leafSession, be);\n        return abs\n          ? { frameId: reportedFrameId, backendNodeId: be, absoluteXPath: abs }\n          : null;\n      }\n\n      if (typeof be !== \"number\") return null;\n\n      let matchedChild: string | undefined;\n      for (const fid of listChildrenOf(parentByFrame, curFrameId)) {\n        try {\n          const { backendNodeId } = await curSession.send<{\n            backendNodeId?: number;\n          }>(\"DOM.getFrameOwner\", { frameId: fid });\n          if (backendNodeId === be) {\n            matchedChild = fid;\n            break;\n          }\n        } catch {\n          continue;\n        }\n      }\n\n      if (!matchedChild) {\n        const abs = await buildAbsoluteXPathFromChain(\n          iframeChain,\n          curSession,\n          be,\n        );\n        return abs\n          ? { frameId: curFrameId, backendNodeId: be, absoluteXPath: abs }\n          : null;\n      }\n\n      iframeChain.push({\n        parentSession: curSession,\n        iframeBackendNodeId: be,\n      });\n\n      let left = 0;\n      let top = 0;\n      try {\n        const { object } = await curSession.send<{\n          object: { objectId?: string };\n        }>(\"DOM.resolveNode\", { backendNodeId: be });\n        const objectId = object?.objectId;\n        if (objectId) {\n          const { result } = await curSession.send<{\n            result: { value?: { left: number; top: number } };\n          }>(\"Runtime.callFunctionOn\", {\n            objectId,\n            functionDeclaration: a11yScriptSources.getBoundingRectLite,\n            returnByValue: true,\n          });\n          left = Number(result?.value?.left ?? 0);\n          top = Number(result?.value?.top ?? 0);\n          await curSession\n            .send(\"Runtime.releaseObject\", { objectId })\n            .catch(() => {});\n        }\n      } catch {\n        //\n      }\n      curX = Math.max(0, curX - left);\n      curY = Math.max(0, curY - top);\n      curFrameId = matchedChild;\n      curSession = page.getSessionForFrame(curFrameId);\n    } catch {\n      return null;\n    }\n  }\n  return null;\n}\n"]}

package/dist/esm/lib/version.d.ts

@@ -2,4 +2,4 @@
  * AUTO-GENERATED — DO NOT EDIT BY HAND
  *  Run `pnpm run gen-version` to refresh.
  */
-export declare const STAGEHAND_VERSION: "3.7.2";
+export declare const STAGEHAND_VERSION: "3.7.3-alpha-94a0ee4e195a7563ae53a04793a092f37aabd388";

package/dist/esm/lib/version.js

@@ -2,5 +2,5 @@
  * AUTO-GENERATED — DO NOT EDIT BY HAND
  *  Run `pnpm run gen-version` to refresh.
  */
-export const STAGEHAND_VERSION = "3.7.2";
+export const STAGEHAND_VERSION = "3.7.3-alpha-94a0ee4e195a7563ae53a04793a092f37aabd388";
 //# sourceMappingURL=version.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../lib/version.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAgB,CAAC","sourcesContent":["/**\n * AUTO-GENERATED — DO NOT EDIT BY HAND\n *  Run `pnpm run gen-version` to refresh.\n */\nexport const STAGEHAND_VERSION = \"3.7.2\" as const;\n"]}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../lib/version.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,sDAA+D,CAAC","sourcesContent":["/**\n * AUTO-GENERATED — DO NOT EDIT BY HAND\n *  Run `pnpm run gen-version` to refresh.\n */\nexport const STAGEHAND_VERSION = \"3.7.3-alpha-94a0ee4e195a7563ae53a04793a092f37aabd388\" as const;\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand",
-  "version": "3.7.2",
+  "version": "3.7.3-alpha-94a0ee4e195a7563ae53a04793a092f37aabd388",
   "description": "An AI web browsing framework focused on simplicity and extensibility.",
   "type": "module",
   "main": "./dist/cjs/index.js",