@browserbasehq/stagehand 3.0.7-alpha-4d71162beb119635b69b17637564a2bbd0e373e7 → 3.0.7-alpha-c6328376f19a9778d435980a992855e2b3bc6806

package/dist/index.js

@@ -179,7 +179,7 @@ var __forAwait = (obj, it, method) => (it = obj[__knownSymbol("asyncIterator")])
 var STAGEHAND_VERSION;
 var init_version = __esm({
   "lib/version.ts"() {
-    STAGEHAND_VERSION = "3.0.7-alpha-4d71162beb119635b69b17637564a2bbd0e373e7";
+    STAGEHAND_VERSION = "3.0.7-alpha-c6328376f19a9778d435980a992855e2b3bc6806";
   }
 });
 
@@ -638,39 +638,6 @@ var init_executionContextRegistry = __esm({
   }
 });
 
-// lib/v3/dom/build/a11yScripts.generated.ts
-var a11yScriptBootstrap, a11yScriptSources, a11yScriptGlobalRefs;
-var init_a11yScripts_generated = __esm({
-  "lib/v3/dom/build/a11yScripts.generated.ts"() {
-    a11yScriptBootstrap = 'if (!globalThis.__stagehandA11yScripts) { var __stagehandA11yScriptsFactory=(()=>{var i=Object.defineProperty;var a=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var N=(o,t)=>{for(var n in t)i(o,n,{get:t[n],enumerable:!0})},h=(o,t,n,d)=>{if(t&&typeof t=="object"||typeof t=="function")for(let u of f(t))!p.call(o,u)&&u!==n&&i(o,u,{get:()=>t[u],enumerable:!(d=a(t,u))||d.enumerable});return o};var E=o=>h(i({},"__esModule",{value:!0}),o);var b={};N(b,{documentHasFocusStrict:()=>g,getBoundingRectLite:()=>w,getScrollOffsets:()=>y,nodeToAbsoluteXPath:()=>$,resolveDeepActiveElement:()=>T});function y(){try{let o=window.scrollX??window.pageXOffset??document.documentElement?.scrollLeft??0,t=window.scrollY??window.pageYOffset??document.documentElement?.scrollTop??0;return{sx:Number(o)||0,sy:Number(t)||0}}catch{return{sx:0,sy:0}}}function w(){try{let o=this.getBoundingClientRect();return{left:Number(o?.left??0)||0,top:Number(o?.top??0)||0}}catch{return{left:0,top:0}}}function T(){try{return(t=>{let n=t.activeElement??null;for(;n&&n.shadowRoot&&n.shadowRoot.activeElement;)n=n.shadowRoot.activeElement;return n??null})(document)}catch{return null}}function $(){return(t=>{try{let n=e=>{if(!e||!e.parentNode)return 1;let l=1,m=`${e.nodeType}:${(e.nodeName||"").toLowerCase()}`;for(let c=e.previousSibling;c;c=c.previousSibling)`${c.nodeType}:${(c.nodeName||"").toLowerCase()}`===m&&(l+=1);return l},d=e=>{if(!e||e.nodeType===Node.DOCUMENT_NODE)return"";if(e.nodeType===Node.DOCUMENT_FRAGMENT_NODE)return"//";if(e.nodeType===Node.TEXT_NODE)return`text()[${n(e)}]`;if(e.nodeType===Node.COMMENT_NODE)return`comment()[${n(e)}]`;let l=(e.nodeName||"").toLowerCase();return`${l.includes(":")?`*[name()=\'${l}\']`:l}[${n(e)}]`},u=[],s=t;for(;s;){if(s.nodeType===Node.DOCUMENT_FRAGMENT_NODE){u.push("//"),s=s.host??null;continue}let e=d(s);e&&u.push(e),s=s.parentNode}u.reverse();let r="";for(let e of u)e==="//"?r=r?r.endsWith("/")?`${r}/`:`${r}//`:"//":r=r?r.endsWith("/")?`${r}${e}`:`${r}/${e}`:`/${e}`;return r||"/"}catch{return"/"}})(this)}function g(){try{return document.hasFocus()===!0}catch{return!1}}return E(b);})();\n  globalThis.__stagehandA11yScripts = __stagehandA11yScriptsFactory;\n}';
-    a11yScriptSources = {
-      "documentHasFocusStrict": "function h(){try{return document.hasFocus()===!0}catch{return!1}}",
-      "getBoundingRectLite": "function f(){try{let r=this.getBoundingClientRect();return{left:Number(r?.left??0)||0,top:Number(r?.top??0)||0}}catch{return{left:0,top:0}}}",
-      "getScrollOffsets": "function a(){try{let r=window.scrollX??window.pageXOffset??document.documentElement?.scrollLeft??0,s=window.scrollY??window.pageYOffset??document.documentElement?.scrollTop??0;return{sx:Number(r)||0,sy:Number(s)||0}}catch{return{sx:0,sy:0}}}",
-      "nodeToAbsoluteXPath": 'function N(){return(s=>{try{let n=e=>{if(!e||!e.parentNode)return 1;let u=1,d=`${e.nodeType}:${(e.nodeName||"").toLowerCase()}`;for(let l=e.previousSibling;l;l=l.previousSibling)`${l.nodeType}:${(l.nodeName||"").toLowerCase()}`===d&&(u+=1);return u},i=e=>{if(!e||e.nodeType===Node.DOCUMENT_NODE)return"";if(e.nodeType===Node.DOCUMENT_FRAGMENT_NODE)return"//";if(e.nodeType===Node.TEXT_NODE)return`text()[${n(e)}]`;if(e.nodeType===Node.COMMENT_NODE)return`comment()[${n(e)}]`;let u=(e.nodeName||"").toLowerCase();return`${u.includes(":")?`*[name()=\'${u}\']`:u}[${n(e)}]`},c=[],o=s;for(;o;){if(o.nodeType===Node.DOCUMENT_FRAGMENT_NODE){c.push("//"),o=o.host??null;continue}let e=i(o);e&&c.push(e),o=o.parentNode}c.reverse();let t="";for(let e of c)e==="//"?t=t?t.endsWith("/")?`${t}/`:`${t}//`:"//":t=t?t.endsWith("/")?`${t}${e}`:`${t}/${e}`:`/${e}`;return t||"/"}catch{return"/"}})(this)}',
-      "resolveDeepActiveElement": "function p(){try{return(s=>{let n=s.activeElement??null;for(;n&&n.shadowRoot&&n.shadowRoot.activeElement;)n=n.shadowRoot.activeElement;return n??null})(document)}catch{return null}}"
-    };
-    a11yScriptGlobalRefs = {
-      "documentHasFocusStrict": "globalThis.__stagehandA11yScripts.documentHasFocusStrict",
-      "getBoundingRectLite": "globalThis.__stagehandA11yScripts.getBoundingRectLite",
-      "getScrollOffsets": "globalThis.__stagehandA11yScripts.getScrollOffsets",
-      "nodeToAbsoluteXPath": "globalThis.__stagehandA11yScripts.nodeToAbsoluteXPath",
-      "resolveDeepActiveElement": "globalThis.__stagehandA11yScripts.resolveDeepActiveElement"
-    };
-  }
-});
-
-// lib/v3/understudy/a11yInvocation.ts
-function buildA11yInvocation(name, args) {
-  const invocation = `${a11yScriptGlobalRefs[name]}(${args.join(", ")})`;
-  return `(() => { ${a11yScriptBootstrap}; return ${invocation}; })()`;
-}
-var init_a11yInvocation = __esm({
-  "lib/v3/understudy/a11yInvocation.ts"() {
-    init_a11yScripts_generated();
-  }
-});
-
 // lib/v3/dom/build/locatorScripts.generated.ts
 var locatorScriptBootstrap, locatorScriptSources, locatorScriptGlobalRefs;
 var init_locatorScripts_generated = __esm({
@@ -738,252 +705,60 @@ var init_locatorInvocation = __esm({
   }
 });
 
-// lib/v3/understudy/a11y/snapshot.ts
-function resolveXpathForLocation(page, x2, y) {
+// lib/v3/dom/build/a11yScripts.generated.ts
+var a11yScriptBootstrap, a11yScriptSources, a11yScriptGlobalRefs;
+var init_a11yScripts_generated = __esm({
+  "lib/v3/dom/build/a11yScripts.generated.ts"() {
+    a11yScriptBootstrap = 'if (!globalThis.__stagehandA11yScripts) { var __stagehandA11yScriptsFactory=(()=>{var i=Object.defineProperty;var a=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var N=(o,t)=>{for(var n in t)i(o,n,{get:t[n],enumerable:!0})},h=(o,t,n,d)=>{if(t&&typeof t=="object"||typeof t=="function")for(let u of f(t))!p.call(o,u)&&u!==n&&i(o,u,{get:()=>t[u],enumerable:!(d=a(t,u))||d.enumerable});return o};var E=o=>h(i({},"__esModule",{value:!0}),o);var b={};N(b,{documentHasFocusStrict:()=>g,getBoundingRectLite:()=>w,getScrollOffsets:()=>y,nodeToAbsoluteXPath:()=>$,resolveDeepActiveElement:()=>T});function y(){try{let o=window.scrollX??window.pageXOffset??document.documentElement?.scrollLeft??0,t=window.scrollY??window.pageYOffset??document.documentElement?.scrollTop??0;return{sx:Number(o)||0,sy:Number(t)||0}}catch{return{sx:0,sy:0}}}function w(){try{let o=this.getBoundingClientRect();return{left:Number(o?.left??0)||0,top:Number(o?.top??0)||0}}catch{return{left:0,top:0}}}function T(){try{return(t=>{let n=t.activeElement??null;for(;n&&n.shadowRoot&&n.shadowRoot.activeElement;)n=n.shadowRoot.activeElement;return n??null})(document)}catch{return null}}function $(){return(t=>{try{let n=e=>{if(!e||!e.parentNode)return 1;let l=1,m=`${e.nodeType}:${(e.nodeName||"").toLowerCase()}`;for(let c=e.previousSibling;c;c=c.previousSibling)`${c.nodeType}:${(c.nodeName||"").toLowerCase()}`===m&&(l+=1);return l},d=e=>{if(!e||e.nodeType===Node.DOCUMENT_NODE)return"";if(e.nodeType===Node.DOCUMENT_FRAGMENT_NODE)return"//";if(e.nodeType===Node.TEXT_NODE)return`text()[${n(e)}]`;if(e.nodeType===Node.COMMENT_NODE)return`comment()[${n(e)}]`;let l=(e.nodeName||"").toLowerCase();return`${l.includes(":")?`*[name()=\'${l}\']`:l}[${n(e)}]`},u=[],s=t;for(;s;){if(s.nodeType===Node.DOCUMENT_FRAGMENT_NODE){u.push("//"),s=s.host??null;continue}let e=d(s);e&&u.push(e),s=s.parentNode}u.reverse();let r="";for(let e of u)e==="//"?r=r?r.endsWith("/")?`${r}/`:`${r}//`:"//":r=r?r.endsWith("/")?`${r}${e}`:`${r}/${e}`:`/${e}`;return r||"/"}catch{return"/"}})(this)}function g(){try{return document.hasFocus()===!0}catch{return!1}}return E(b);})();\n  globalThis.__stagehandA11yScripts = __stagehandA11yScriptsFactory;\n}';
+    a11yScriptSources = {
+      "documentHasFocusStrict": "function h(){try{return document.hasFocus()===!0}catch{return!1}}",
+      "getBoundingRectLite": "function f(){try{let r=this.getBoundingClientRect();return{left:Number(r?.left??0)||0,top:Number(r?.top??0)||0}}catch{return{left:0,top:0}}}",
+      "getScrollOffsets": "function a(){try{let r=window.scrollX??window.pageXOffset??document.documentElement?.scrollLeft??0,s=window.scrollY??window.pageYOffset??document.documentElement?.scrollTop??0;return{sx:Number(r)||0,sy:Number(s)||0}}catch{return{sx:0,sy:0}}}",
+      "nodeToAbsoluteXPath": 'function N(){return(s=>{try{let n=e=>{if(!e||!e.parentNode)return 1;let u=1,d=`${e.nodeType}:${(e.nodeName||"").toLowerCase()}`;for(let l=e.previousSibling;l;l=l.previousSibling)`${l.nodeType}:${(l.nodeName||"").toLowerCase()}`===d&&(u+=1);return u},i=e=>{if(!e||e.nodeType===Node.DOCUMENT_NODE)return"";if(e.nodeType===Node.DOCUMENT_FRAGMENT_NODE)return"//";if(e.nodeType===Node.TEXT_NODE)return`text()[${n(e)}]`;if(e.nodeType===Node.COMMENT_NODE)return`comment()[${n(e)}]`;let u=(e.nodeName||"").toLowerCase();return`${u.includes(":")?`*[name()=\'${u}\']`:u}[${n(e)}]`},c=[],o=s;for(;o;){if(o.nodeType===Node.DOCUMENT_FRAGMENT_NODE){c.push("//"),o=o.host??null;continue}let e=i(o);e&&c.push(e),o=o.parentNode}c.reverse();let t="";for(let e of c)e==="//"?t=t?t.endsWith("/")?`${t}/`:`${t}//`:"//":t=t?t.endsWith("/")?`${t}${e}`:`${t}/${e}`:`/${e}`;return t||"/"}catch{return"/"}})(this)}',
+      "resolveDeepActiveElement": "function p(){try{return(s=>{let n=s.activeElement??null;for(;n&&n.shadowRoot&&n.shadowRoot.activeElement;)n=n.shadowRoot.activeElement;return n??null})(document)}catch{return null}}"
+    };
+    a11yScriptGlobalRefs = {
+      "documentHasFocusStrict": "globalThis.__stagehandA11yScripts.documentHasFocusStrict",
+      "getBoundingRectLite": "globalThis.__stagehandA11yScripts.getBoundingRectLite",
+      "getScrollOffsets": "globalThis.__stagehandA11yScripts.getScrollOffsets",
+      "nodeToAbsoluteXPath": "globalThis.__stagehandA11yScripts.nodeToAbsoluteXPath",
+      "resolveDeepActiveElement": "globalThis.__stagehandA11yScripts.resolveDeepActiveElement"
+    };
+  }
+});
+
+// lib/v3/understudy/a11y/snapshot/xpathUtils.ts
+function buildAbsoluteXPathFromChain(chain, leafSession, leafBackendNodeId) {
   return __async(this, null, function* () {
-    var _a4, _b, _c, _d2, _e, _f, _g, _h;
-    const tree = page.getFullFrameTree();
-    const parentByFrame = /* @__PURE__ */ new Map();
-    (function index(n, parent) {
-      var _a5;
-      parentByFrame.set(n.frame.id, parent);
-      for (const c of (_a5 = n.childFrames) != null ? _a5 : []) index(c, n.frame.id);
-    })(tree, null);
-    const iframeChain = [];
-    let curFrameId = page.mainFrameId();
-    let curSession = page.getSessionForFrame(curFrameId);
-    let curX = x2;
-    let curY = y;
-    for (let depth = 0; depth < 8; depth++) {
-      try {
-        yield curSession.send("DOM.enable").catch(() => {
-        });
-        let sx = 0;
-        let sy = 0;
-        try {
-          yield curSession.send("Runtime.enable").catch(() => {
-          });
-          const ctxId = yield executionContexts.waitForMainWorld(curSession, curFrameId).catch(() => {
-          });
-          const scrollExpr = buildA11yInvocation("getScrollOffsets", []);
-          const evalParams = ctxId ? {
-            contextId: ctxId,
-            expression: scrollExpr,
-            returnByValue: true
-          } : { expression: scrollExpr, returnByValue: true };
-          const { result } = yield curSession.send("Runtime.evaluate", evalParams);
-          sx = Number((_b = (_a4 = result == null ? void 0 : result.value) == null ? void 0 : _a4.sx) != null ? _b : 0);
-          sy = Number((_d2 = (_c = result == null ? void 0 : result.value) == null ? void 0 : _c.sy) != null ? _d2 : 0);
-        } catch (e2) {
-        }
-        const xi = Math.max(0, Math.floor(curX + sx));
-        const yi = Math.max(0, Math.floor(curY + sy));
-        let res;
-        try {
-          res = yield curSession.send("DOM.getNodeForLocation", {
-            x: xi,
-            y: yi,
-            includeUserAgentShadowDOM: false,
-            ignorePointerEventsNone: false
-          });
-        } catch (e2) {
-          return null;
-        }
-        const be = res == null ? void 0 : res.backendNodeId;
-        const reportedFrameId = res == null ? void 0 : res.frameId;
-        if (typeof be === "number" && reportedFrameId && reportedFrameId !== curFrameId) {
-          const abs = yield buildAbsoluteXPathFromChain(
-            iframeChain,
-            curSession,
-            be
-          );
-          return abs ? { frameId: reportedFrameId, backendNodeId: be, absoluteXPath: abs } : null;
-        }
-        if (typeof be !== "number") return null;
-        let matchedChild;
-        for (const fid of listChildrenOf(parentByFrame, curFrameId)) {
-          try {
-            const { backendNodeId } = yield curSession.send("DOM.getFrameOwner", { frameId: fid });
-            if (backendNodeId === be) {
-              matchedChild = fid;
-              break;
-            }
-          } catch (e2) {
-          }
-        }
-        if (!matchedChild) {
-          const abs = yield buildAbsoluteXPathFromChain(
-            iframeChain,
-            curSession,
-            be
-          );
-          return abs ? { frameId: curFrameId, backendNodeId: be, absoluteXPath: abs } : null;
-        }
-        iframeChain.push({
-          parentFrameId: curFrameId,
-          parentSession: curSession,
-          iframeBackendNodeId: be
-        });
-        let left = 0;
-        let top = 0;
-        try {
-          const { object } = yield curSession.send("DOM.resolveNode", { backendNodeId: be });
-          const objectId = object == null ? void 0 : object.objectId;
-          if (objectId) {
-            const { result } = yield curSession.send("Runtime.callFunctionOn", {
-              objectId,
-              functionDeclaration: a11yScriptSources.getBoundingRectLite,
-              returnByValue: true
-            });
-            left = Number((_f = (_e = result == null ? void 0 : result.value) == null ? void 0 : _e.left) != null ? _f : 0);
-            top = Number((_h = (_g = result == null ? void 0 : result.value) == null ? void 0 : _g.top) != null ? _h : 0);
-            yield curSession.send("Runtime.releaseObject", { objectId }).catch(() => {
-            });
-          }
-        } catch (e2) {
-        }
-        curX = Math.max(0, curX - left);
-        curY = Math.max(0, curY - top);
-        curFrameId = matchedChild;
-        curSession = page.getSessionForFrame(curFrameId);
-      } catch (e2) {
-        return null;
-      }
+    let prefix = "";
+    for (const step of chain) {
+      const xp = yield absoluteXPathForBackendNode(
+        step.parentSession,
+        step.iframeBackendNodeId
+      );
+      if (!xp) continue;
+      prefix = prefix ? prefixXPath(prefix, xp) : normalizeXPath(xp);
     }
-    return null;
+    const leaf = yield absoluteXPathForBackendNode(
+      leafSession,
+      leafBackendNodeId
+    );
+    if (!leaf) return prefix || "/";
+    return prefix ? prefixXPath(prefix, leaf) : normalizeXPath(leaf);
   });
 }
-function computeActiveElementXpath(page) {
+function absoluteXPathForBackendNode(session, backendNodeId) {
   return __async(this, null, function* () {
-    var _a4;
-    const tree = page.getFullFrameTree();
-    const parentByFrame = /* @__PURE__ */ new Map();
-    (function index(n, parent) {
-      var _a5;
-      parentByFrame.set(n.frame.id, parent);
-      for (const c of (_a5 = n.childFrames) != null ? _a5 : []) index(c, n.frame.id);
-    })(tree, null);
-    const frames = page.listAllFrameIds();
-    let focusedFrameId = null;
-    for (const fid of frames) {
-      const sess = page.getSessionForFrame(fid);
-      try {
-        yield sess.send("Runtime.enable").catch(() => {
-        });
-        const ctxId = yield executionContexts.waitForMainWorld(sess, fid, 1e3).catch(() => {
-        });
-        const hasFocusExpr = buildA11yInvocation("documentHasFocusStrict", []);
-        const evalParams = ctxId ? {
-          contextId: ctxId,
-          expression: hasFocusExpr,
-          returnByValue: true
-        } : { expression: hasFocusExpr, returnByValue: true };
-        const { result } = yield sess.send(
-          "Runtime.evaluate",
-          evalParams
-        );
-        if ((result == null ? void 0 : result.value) === true) {
-          focusedFrameId = fid;
-          break;
-        }
-      } catch (e2) {
-      }
-    }
-    if (!focusedFrameId) focusedFrameId = page.mainFrameId();
-    const focusedSession = page.getSessionForFrame(focusedFrameId);
-    let objectId;
     try {
-      yield focusedSession.send("Runtime.enable").catch(() => {
-      });
-      const ctxId = yield executionContexts.waitForMainWorld(focusedSession, focusedFrameId, 1e3).catch(() => {
-      });
-      const activeExpr = buildA11yInvocation("resolveDeepActiveElement", []);
-      const evalParams = ctxId ? {
-        contextId: ctxId,
-        expression: activeExpr,
-        returnByValue: false
-      } : { expression: activeExpr, returnByValue: false };
-      const { result } = yield focusedSession.send(
-        "Runtime.evaluate",
-        evalParams
+      const { object } = yield session.send(
+        "DOM.resolveNode",
+        { backendNodeId }
       );
-      objectId = result == null ? void 0 : result.objectId;
-    } catch (e2) {
-      objectId = void 0;
-    }
-    if (!objectId) return null;
-    const leafXPath = yield (() => __async(null, null, function* () {
-      try {
-        const { result } = yield focusedSession.send("Runtime.callFunctionOn", {
-          objectId,
-          functionDeclaration: a11yScriptSources.nodeToAbsoluteXPath,
-          returnByValue: true
-        });
-        try {
-          yield focusedSession.send("Runtime.releaseObject", { objectId });
-        } catch (e2) {
-        }
-        const xp = (result == null ? void 0 : result.value) || "";
-        return typeof xp === "string" && xp ? xp : null;
-      } catch (e2) {
-        try {
-          yield focusedSession.send("Runtime.releaseObject", { objectId });
-        } catch (e3) {
-        }
-        return null;
-      }
-    }))();
-    if (!leafXPath) return null;
-    let prefix = "";
-    let cur = focusedFrameId;
-    while (cur) {
-      const parent = (_a4 = parentByFrame.get(cur)) != null ? _a4 : null;
-      if (!parent) break;
-      const parentSess = page.getSessionForFrame(parent);
-      try {
-        const { backendNodeId } = yield parentSess.send("DOM.getFrameOwner", { frameId: cur });
-        if (typeof backendNodeId === "number") {
-          const xp = yield absoluteXPathForBackendNode(parentSess, backendNodeId);
-          if (xp) prefix = prefix ? prefixXPath(prefix, xp) : normalizeXPath(xp);
-        }
-      } catch (e2) {
-      }
-      cur = parent;
-    }
-    return prefix ? prefixXPath(prefix, leafXPath) : normalizeXPath(leafXPath);
-  });
-}
-function buildAbsoluteXPathFromChain(chain, leafSession, leafBackendNodeId) {
-  return __async(this, null, function* () {
-    let prefix = "";
-    for (const step of chain) {
-      const xp = yield absoluteXPathForBackendNode(
-        step.parentSession,
-        step.iframeBackendNodeId
-      );
-      if (!xp) continue;
-      prefix = prefix ? prefixXPath(prefix, xp) : normalizeXPath(xp);
-    }
-    const leaf = yield absoluteXPathForBackendNode(
-      leafSession,
-      leafBackendNodeId
-    );
-    if (!leaf) return prefix || "/";
-    return prefix ? prefixXPath(prefix, leaf) : normalizeXPath(leaf);
-  });
-}
-function absoluteXPathForBackendNode(session, backendNodeId) {
-  return __async(this, null, function* () {
-    try {
-      const { object } = yield session.send(
-        "DOM.resolveNode",
-        { backendNodeId }
-      );
-      const objectId = object == null ? void 0 : object.objectId;
-      if (!objectId) return null;
-      const { result } = yield session.send(
-        "Runtime.callFunctionOn",
-        {
+      const objectId = object == null ? void 0 : object.objectId;
+      if (!objectId) return null;
+      const { result } = yield session.send(
+        "Runtime.callFunctionOn",
+        {
           objectId,
           functionDeclaration: a11yScriptSources.nodeToAbsoluteXPath,
           returnByValue: true
@@ -997,483 +772,168 @@ function absoluteXPathForBackendNode(session, backendNodeId) {
     }
   });
 }
-function isCborStackError(message) {
-  return message.includes("CBOR: stack limit exceeded");
+function prefixXPath(parentAbs, child) {
+  const p = parentAbs === "/" ? "" : parentAbs.replace(/\/$/, "");
+  if (!child || child === "/") return p || "/";
+  if (child.startsWith("//"))
+    return p ? `${p}//${child.slice(2)}` : `//${child.slice(2)}`;
+  const c = child.replace(/^\//, "");
+  return p ? `${p}/${c}` : `/${c}`;
 }
-function shouldExpandNode(node) {
-  var _a4, _b, _c;
-  const declaredChildren = (_a4 = node.childNodeCount) != null ? _a4 : 0;
-  const realizedChildren = (_c = (_b = node.children) == null ? void 0 : _b.length) != null ? _c : 0;
-  return declaredChildren > realizedChildren;
+function normalizeXPath(x2) {
+  if (!x2) return "";
+  let s2 = x2.trim().replace(/^xpath=/i, "");
+  if (!s2.startsWith("/")) s2 = "/" + s2;
+  if (s2.length > 1 && s2.endsWith("/")) s2 = s2.slice(0, -1);
+  return s2;
 }
-function mergeDomNodes(target, source) {
-  var _a4, _b, _c, _d2;
-  target.childNodeCount = (_a4 = source.childNodeCount) != null ? _a4 : target.childNodeCount;
-  target.children = (_b = source.children) != null ? _b : target.children;
-  target.shadowRoots = (_c = source.shadowRoots) != null ? _c : target.shadowRoots;
-  target.contentDocument = (_d2 = source.contentDocument) != null ? _d2 : target.contentDocument;
+function buildChildXPathSegments(kids) {
+  var _a4;
+  const segs = [];
+  const ctr = {};
+  for (const child of kids) {
+    const tag = String(child.nodeName).toLowerCase();
+    const key = `${child.nodeType}:${tag}`;
+    const idx = ctr[key] = ((_a4 = ctr[key]) != null ? _a4 : 0) + 1;
+    if (child.nodeType === 3) {
+      segs.push(`text()[${idx}]`);
+    } else if (child.nodeType === 8) {
+      segs.push(`comment()[${idx}]`);
+    } else {
+      segs.push(
+        tag.includes(":") ? `*[name()='${tag}'][${idx}]` : `${tag}[${idx}]`
+      );
+    }
+  }
+  return segs;
 }
-function collectDomTraversalTargets(node) {
-  const targets = [];
-  if (node.children) targets.push(...node.children);
-  if (node.shadowRoots) targets.push(...node.shadowRoots);
-  if (node.contentDocument) targets.push(node.contentDocument);
-  return targets;
+function joinXPath(base, step) {
+  if (step === "//") {
+    if (!base || base === "/") return "//";
+    return base.endsWith("/") ? `${base}/` : `${base}//`;
+  }
+  if (!base || base === "/") return step ? `/${step}` : "/";
+  if (base.endsWith("//")) return `${base}${step}`;
+  if (!step) return base;
+  return `${base}/${step}`;
 }
-function hydrateDomTree(session, root, pierce) {
+var init_xpathUtils = __esm({
+  "lib/v3/understudy/a11y/snapshot/xpathUtils.ts"() {
+    init_a11yScripts_generated();
+  }
+});
+
+// lib/v3/understudy/a11y/snapshot/focusSelectors.ts
+function parseXPathToSteps(path8) {
+  const s2 = path8.trim();
+  let i2 = 0;
+  const steps = [];
+  while (i2 < s2.length) {
+    let axis = "child";
+    if (s2.startsWith("//", i2)) {
+      axis = "desc";
+      i2 += 2;
+    } else if (s2[i2] === "/") {
+      axis = "child";
+      i2 += 1;
+    }
+    const start = i2;
+    while (i2 < s2.length && s2[i2] !== "/") i2++;
+    const raw = s2.slice(start, i2).trim();
+    if (!raw) continue;
+    const name = raw.replace(/\[\d+\]\s*$/u, "").toLowerCase();
+    steps.push({ axis, raw, name });
+  }
+  return steps;
+}
+function buildXPathFromSteps(steps) {
+  let out = "";
+  for (const st of steps) {
+    out += st.axis === "desc" ? "//" : "/";
+    out += st.raw;
+  }
+  return out || "/";
+}
+function resolveFocusFrameAndTail(page, absoluteXPath, parentByFrame, rootId) {
   return __async(this, null, function* () {
-    var _a4, _b;
-    const stack = [root];
-    const expandedNodeIds = /* @__PURE__ */ new Set();
-    const expandedBackendIds = /* @__PURE__ */ new Set();
-    while (stack.length) {
-      const node = stack.pop();
-      const nodeId = typeof node.nodeId === "number" && node.nodeId > 0 ? node.nodeId : void 0;
-      const backendId = typeof node.backendNodeId === "number" && node.backendNodeId > 0 ? node.backendNodeId : void 0;
-      const seenByNode = nodeId ? expandedNodeIds.has(nodeId) : false;
-      const seenByBackend = !nodeId && backendId ? expandedBackendIds.has(backendId) : false;
-      if (seenByNode || seenByBackend) continue;
-      if (nodeId) expandedNodeIds.add(nodeId);
-      else if (backendId) expandedBackendIds.add(backendId);
-      const needsExpansion = shouldExpandNode(node);
-      if (needsExpansion && (nodeId || backendId)) {
-        const describeParamsBase = nodeId ? { nodeId } : { backendNodeId: backendId };
-        let expanded = false;
-        for (const depth of DESCRIBE_DEPTH_ATTEMPTS) {
+    const steps = parseXPathToSteps(absoluteXPath);
+    let ctxFrameId = rootId;
+    let buf = [];
+    let absPrefix = "";
+    const flushIntoChild = () => __async(null, null, function* () {
+      if (!buf.length) return;
+      const selectorForIframe = buildXPathFromSteps(buf);
+      const parentSess = page.getSessionForFrame(ctxFrameId);
+      const objectId = yield resolveObjectIdForXPath(
+        parentSess,
+        selectorForIframe,
+        ctxFrameId
+      );
+      if (!objectId)
+        throw new StagehandIframeError(
+          selectorForIframe,
+          "Failed to resolve iframe element by XPath"
+        );
+      try {
+        yield parentSess.send("DOM.enable").catch(() => {
+        });
+        const desc = yield parentSess.send(
+          "DOM.describeNode",
+          { objectId }
+        );
+        const iframeBackendNodeId = desc.node.backendNodeId;
+        let childFrameId;
+        for (const fid of listChildrenOf(parentByFrame, ctxFrameId)) {
           try {
-            const described = yield session.send(
-              "DOM.describeNode",
-              __spreadProps(__spreadValues({}, describeParamsBase), {
-                depth,
-                pierce
-              })
-            );
-            mergeDomNodes(node, described.node);
-            if (!nodeId && described.node.nodeId && described.node.nodeId > 0) {
-              node.nodeId = described.node.nodeId;
-              expandedNodeIds.add(described.node.nodeId);
-            }
-            expanded = true;
-            break;
-          } catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            if (isCborStackError(message)) {
-              continue;
+            const { backendNodeId } = yield parentSess.send("DOM.getFrameOwner", { frameId: fid });
+            if (backendNodeId === iframeBackendNodeId) {
+              childFrameId = fid;
+              break;
             }
-            const identifier = (_a4 = nodeId != null ? nodeId : backendId) != null ? _a4 : "unknown";
-            throw new StagehandDomProcessError(
-              `Failed to expand DOM node ${identifier}: ${String(err)}`
-            );
+          } catch (e2) {
+            continue;
           }
         }
-        if (!expanded) {
-          const identifier = (_b = nodeId != null ? nodeId : backendId) != null ? _b : "unknown";
-          throw new StagehandDomProcessError(
-            `Unable to expand DOM node ${identifier} after describeNode depth retries`
+        if (!childFrameId)
+          throw new StagehandIframeError(
+            selectorForIframe,
+            "Could not map iframe to child frameId"
           );
-        }
+        absPrefix = prefixXPath(absPrefix || "/", selectorForIframe);
+        ctxFrameId = childFrameId;
+      } finally {
+        yield parentSess.send("Runtime.releaseObject", { objectId }).catch(() => {
+        });
       }
-      for (const child of collectDomTraversalTargets(node)) {
-        stack.push(child);
+      buf = [];
+    });
+    for (const st of steps) {
+      buf.push(st);
+      if (IFRAME_STEP_RE.test(st.name)) {
+        yield flushIntoChild();
       }
     }
+    const tailXPath = buildXPathFromSteps(buf);
+    return { targetFrameId: ctxFrameId, tailXPath, absPrefix };
   });
 }
-function getDomTreeWithFallback(session, pierce) {
+function resolveCssFocusFrameAndTail(page, rawSelector, parentByFrame, rootId) {
   return __async(this, null, function* () {
-    let lastCborMessage = "";
-    for (const depth of DOM_DEPTH_ATTEMPTS) {
-      try {
-        const { root } = yield session.send(
-          "DOM.getDocument",
-          { depth, pierce }
-        );
-        if (depth !== -1) {
-          yield hydrateDomTree(session, root, pierce);
-        }
-        return root;
-      } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        if (isCborStackError(message)) {
-          lastCborMessage = message;
-          continue;
-        }
-        throw err;
-      }
-    }
-    throw new StagehandDomProcessError(
-      lastCborMessage ? `CDP DOM.getDocument failed after adaptive depth retries: ${lastCborMessage}` : "CDP DOM.getDocument failed after adaptive depth retries."
-    );
-  });
-}
-function captureHybridSnapshot(page, options) {
-  return __async(this, null, function* () {
-    var _a4, _b, _c, _d2, _e, _f, _g, _h, _i, _j, _k, _l;
-    const pierce = (_a4 = options == null ? void 0 : options.pierceShadow) != null ? _a4 : true;
-    const rootId = page.mainFrameId();
-    const frameTree = page.asProtocolFrameTree(rootId);
-    const parentByFrame = /* @__PURE__ */ new Map();
-    (function index(n, parent) {
-      var _a5;
-      parentByFrame.set(n.frame.id, parent);
-      for (const c of (_a5 = n.childFrames) != null ? _a5 : []) index(c, n.frame.id);
-    })(frameTree, null);
-    const frames = page.listAllFrameIds();
-    const combinedXpathMap = {};
-    const combinedUrlMap = {};
-    const perFrameOutlines = [];
-    const perFrameMaps = /* @__PURE__ */ new Map();
-    const requestedFocus = (_b = options == null ? void 0 : options.focusSelector) == null ? void 0 : _b.trim();
-    if (requestedFocus) {
-      const logScopeFallback = () => {
-        var _a5;
-        v3Logger({
-          message: `Unable to narrow scope with selector. Falling back to using full DOM`,
-          level: 1,
-          auxiliary: {
-            arguments: {
-              value: `selector: ${(_a5 = options == null ? void 0 : options.focusSelector) == null ? void 0 : _a5.trim()}`,
-              type: "string"
-            }
-          }
-        });
-      };
-      try {
-        let targetFrameId;
-        let tailSelector;
-        let absPrefix2;
-        const looksLikeXPath = /^xpath=/i.test(requestedFocus) || requestedFocus.startsWith("/");
-        if (looksLikeXPath) {
-          const focus = normalizeXPath(requestedFocus);
-          const hit = yield resolveFocusFrameAndTail(
-            page,
-            focus,
-            parentByFrame,
-            rootId
-          );
-          targetFrameId = hit.targetFrameId;
-          tailSelector = hit.tailXPath || void 0;
-          absPrefix2 = hit.absPrefix;
-        } else {
-          const cssHit = yield resolveCssFocusFrameAndTail(
-            page,
-            requestedFocus,
-            parentByFrame,
-            rootId
-          );
-          targetFrameId = cssHit.targetFrameId;
-          tailSelector = cssHit.tailSelector || void 0;
-          absPrefix2 = cssHit.absPrefix;
-        }
-        const owningSess = ownerSession(page, targetFrameId);
-        const parentId = parentByFrame.get(targetFrameId);
-        const sameSessionAsParent = !!parentId && ownerSession(page, parentId) === ownerSession(page, targetFrameId);
-        const { tagNameMap, xpathMap, scrollableMap } = yield domMapsForSession(
-          owningSess,
-          targetFrameId,
-          pierce,
-          (fid, be) => `${page.getOrdinal(fid)}-${be}`,
-          /*attemptOwnerLookup=*/
-          sameSessionAsParent
-        );
-        const { outline, urlMap, scopeApplied } = yield a11yForFrame(
-          owningSess,
-          targetFrameId,
-          {
-            focusSelector: tailSelector || void 0,
-            tagNameMap,
-            experimental: (_c = options == null ? void 0 : options.experimental) != null ? _c : false,
-            scrollableMap,
-            encode: (backendNodeId) => `${page.getOrdinal(targetFrameId)}-${backendNodeId}`
-          }
-        );
-        const combinedXpathMap2 = {};
-        const abs = absPrefix2 != null ? absPrefix2 : "";
-        const isRoot = !abs || abs === "/";
-        if (isRoot) {
-          Object.assign(combinedXpathMap2, xpathMap);
-        } else {
-          for (const [encId, xp] of Object.entries(xpathMap)) {
-            combinedXpathMap2[encId] = prefixXPath(abs, xp);
-          }
-        }
-        const combinedUrlMap2 = __spreadValues({}, urlMap);
-        const snapshot = {
-          combinedTree: outline,
-          combinedXpathMap: combinedXpathMap2,
-          combinedUrlMap: combinedUrlMap2,
-          perFrame: [
-            {
-              frameId: targetFrameId,
-              outline,
-              xpathMap,
-              urlMap
-            }
-          ]
-        };
-        if (scopeApplied) {
-          return snapshot;
-        }
-        logScopeFallback();
-      } catch (e2) {
-        logScopeFallback();
-      }
-    }
-    function buildSessionDomIndex(session, pierce2) {
-      return __async(this, null, function* () {
-        var _a5, _b2;
-        yield session.send("DOM.enable").catch(() => {
-        });
-        const root = yield getDomTreeWithFallback(session, pierce2);
-        const absByBe = /* @__PURE__ */ new Map();
-        const tagByBe = /* @__PURE__ */ new Map();
-        const scrollByBe = /* @__PURE__ */ new Map();
-        const docRootOf = /* @__PURE__ */ new Map();
-        const contentDocRootByIframe = /* @__PURE__ */ new Map();
-        const rootBe = root.backendNodeId;
-        const stack = [{ node: root, xp: "/", docRootBe: rootBe }];
-        while (stack.length) {
-          const { node, xp, docRootBe } = stack.pop();
-          if (node.backendNodeId) {
-            absByBe.set(node.backendNodeId, xp || "/");
-            tagByBe.set(node.backendNodeId, String(node.nodeName).toLowerCase());
-            if ((node == null ? void 0 : node.isScrollable) === true)
-              scrollByBe.set(node.backendNodeId, true);
-            docRootOf.set(node.backendNodeId, docRootBe);
-          }
-          const kids = (_a5 = node.children) != null ? _a5 : [];
-          if (kids.length) {
-            const segs = buildChildXPathSegments(kids);
-            for (let i2 = kids.length - 1; i2 >= 0; i2--) {
-              const child = kids[i2];
-              const step = segs[i2];
-              stack.push({ node: child, xp: joinXPath(xp, step), docRootBe });
-            }
-          }
-          for (const sr of (_b2 = node.shadowRoots) != null ? _b2 : []) {
-            stack.push({ node: sr, xp: joinXPath(xp, "//"), docRootBe });
-          }
-          const cd = node.contentDocument;
-          if (cd && typeof cd.backendNodeId === "number") {
-            contentDocRootByIframe.set(node.backendNodeId, cd.backendNodeId);
-            stack.push({ node: cd, xp, docRootBe: cd.backendNodeId });
-          }
-        }
-        return {
-          rootBackend: rootBe,
-          absByBe,
-          tagByBe,
-          scrollByBe,
-          docRootOf,
-          contentDocRootByIframe
-        };
-      });
-    }
-    function relativizeXPath(baseAbs, nodeAbs) {
-      const base = normalizeXPath(baseAbs);
-      const abs = normalizeXPath(nodeAbs);
-      if (abs === base) return "/";
-      if (abs.startsWith(base)) {
-        const tail = abs.slice(base.length);
-        if (!tail) return "/";
-        return tail.startsWith("/") || tail.startsWith("//") ? tail : `/${tail}`;
-      }
-      if (base === "/") return abs;
-      return abs;
-    }
-    const sessionToIndex = /* @__PURE__ */ new Map();
-    const sessionById = /* @__PURE__ */ new Map();
-    for (const frameId of frames) {
-      const sess = ownerSession(page, frameId);
-      const sid = (_d2 = sess.id) != null ? _d2 : "root";
-      if (!sessionById.has(sid)) sessionById.set(sid, sess);
-    }
-    for (const [sid, sess] of sessionById.entries()) {
-      const idx = yield buildSessionDomIndex(sess, pierce);
-      sessionToIndex.set(sid, idx);
-    }
-    for (const frameId of frames) {
-      const sess = ownerSession(page, frameId);
-      const sid = (_e = sess.id) != null ? _e : "root";
-      let idx = sessionToIndex.get(sid);
-      if (!idx) {
-        idx = yield buildSessionDomIndex(sess, pierce);
-        sessionToIndex.set(sid, idx);
-      }
-      const parentId = parentByFrame.get(frameId);
-      const sameSessionAsParent = !!parentId && ownerSession(page, parentId) === sess;
-      let docRootBe = idx.rootBackend;
-      if (sameSessionAsParent) {
-        try {
-          const { backendNodeId } = yield sess.send(
-            "DOM.getFrameOwner",
-            { frameId }
-          );
-          if (typeof backendNodeId === "number") {
-            const cdBe = idx.contentDocRootByIframe.get(backendNodeId);
-            if (typeof cdBe === "number") docRootBe = cdBe;
-          }
-        } catch (e2) {
-        }
-      }
-      const tagNameMap = {};
-      const xpathMap = {};
-      const scrollableMap = {};
-      const enc = (be) => `${page.getOrdinal(frameId)}-${be}`;
-      const baseAbs = (_f = idx.absByBe.get(docRootBe)) != null ? _f : "/";
-      for (const [be, nodeAbs] of idx.absByBe.entries()) {
-        const nodeDocRoot = idx.docRootOf.get(be);
-        if (nodeDocRoot !== docRootBe) continue;
-        const rel = relativizeXPath(baseAbs, nodeAbs);
-        const key = enc(be);
-        xpathMap[key] = rel;
-        const tag = idx.tagByBe.get(be);
-        if (tag) tagNameMap[key] = tag;
-        if (idx.scrollByBe.get(be)) scrollableMap[key] = true;
-      }
-      const { outline, urlMap } = yield a11yForFrame(sess, frameId, {
-        experimental: (_g = options == null ? void 0 : options.experimental) != null ? _g : false,
-        tagNameMap,
-        scrollableMap,
-        encode: (backendNodeId) => `${page.getOrdinal(frameId)}-${backendNodeId}`
-      });
-      perFrameOutlines.push({ frameId, outline });
-      perFrameMaps.set(frameId, { tagNameMap, xpathMap, scrollableMap, urlMap });
-    }
-    const absPrefix = /* @__PURE__ */ new Map();
-    const iframeHostEncByChild = /* @__PURE__ */ new Map();
-    absPrefix.set(rootId, "");
-    const queue = [rootId];
-    while (queue.length) {
-      const parent = queue.shift();
-      const parentAbs = absPrefix.get(parent);
-      for (const child of frames) {
-        if (parentByFrame.get(child) !== parent) continue;
-        queue.push(child);
-        const parentSess = parentSession(page, parentByFrame, child);
-        const ownerBackendNodeId = yield (() => __async(null, null, function* () {
-          try {
-            const { backendNodeId } = yield parentSess.send("DOM.getFrameOwner", { frameId: child });
-            return backendNodeId;
-          } catch (e2) {
-            return void 0;
-          }
-        }))();
-        if (!ownerBackendNodeId) {
-          absPrefix.set(child, parentAbs);
-          continue;
-        }
-        const parentDom = perFrameMaps.get(parent);
-        const iframeEnc = `${page.getOrdinal(parent)}-${ownerBackendNodeId}`;
-        const iframeXPath = parentDom == null ? void 0 : parentDom.xpathMap[iframeEnc];
-        const childAbs = iframeXPath ? prefixXPath(parentAbs || "/", iframeXPath) : parentAbs;
-        absPrefix.set(child, childAbs);
-        iframeHostEncByChild.set(child, iframeEnc);
-      }
-    }
-    for (const frameId of frames) {
-      const maps = perFrameMaps.get(frameId);
-      if (!maps) continue;
-      const abs = (_h = absPrefix.get(frameId)) != null ? _h : "";
-      const isRoot = abs === "" || abs === "/";
-      if (isRoot) {
-        Object.assign(combinedXpathMap, maps.xpathMap);
-        Object.assign(combinedUrlMap, maps.urlMap);
-        continue;
-      }
-      for (const [encId, xp] of Object.entries(maps.xpathMap)) {
-        combinedXpathMap[encId] = prefixXPath(abs, xp);
-      }
-      Object.assign(combinedUrlMap, maps.urlMap);
-    }
-    const idToTree = /* @__PURE__ */ new Map();
-    for (const { frameId, outline } of perFrameOutlines) {
-      const parentEnc = iframeHostEncByChild.get(frameId);
-      if (parentEnc) idToTree.set(parentEnc, outline);
-    }
-    const rootOutline = (_l = (_k = (_i = perFrameOutlines.find((o) => o.frameId === rootId)) == null ? void 0 : _i.outline) != null ? _k : (_j = perFrameOutlines[0]) == null ? void 0 : _j.outline) != null ? _l : "";
-    const combinedTree = injectSubtrees(rootOutline, idToTree);
-    return {
-      combinedTree,
-      combinedXpathMap,
-      combinedUrlMap,
-      perFrame: perFrameOutlines.map(({ frameId, outline }) => {
-        var _a5, _b2;
-        const maps = perFrameMaps.get(frameId);
-        return {
-          frameId,
-          outline,
-          xpathMap: (_a5 = maps == null ? void 0 : maps.xpathMap) != null ? _a5 : {},
-          urlMap: (_b2 = maps == null ? void 0 : maps.urlMap) != null ? _b2 : {}
-        };
-      })
-    };
-  });
-}
-function prefixXPath(parentAbs, child) {
-  const p = parentAbs === "/" ? "" : parentAbs.replace(/\/$/, "");
-  if (!child || child === "/") return p || "/";
-  if (child.startsWith("//"))
-    return p ? `${p}//${child.slice(2)}` : `//${child.slice(2)}`;
-  const c = child.replace(/^\//, "");
-  return p ? `${p}/${c}` : `/${c}`;
-}
-function normalizeXPath(x2) {
-  if (!x2) return "";
-  let s2 = x2.trim().replace(/^xpath=/i, "");
-  if (!s2.startsWith("/")) s2 = "/" + s2;
-  if (s2.length > 1 && s2.endsWith("/")) s2 = s2.slice(0, -1);
-  return s2;
-}
-function parseXPathToSteps(path8) {
-  const s2 = path8.trim();
-  let i2 = 0;
-  const steps = [];
-  while (i2 < s2.length) {
-    let axis = "child";
-    if (s2.startsWith("//", i2)) {
-      axis = "desc";
-      i2 += 2;
-    } else if (s2[i2] === "/") {
-      axis = "child";
-      i2 += 1;
-    }
-    const start = i2;
-    while (i2 < s2.length && s2[i2] !== "/") i2++;
-    const raw = s2.slice(start, i2).trim();
-    if (!raw) continue;
-    const name = raw.replace(/\[\d+\]\s*$/u, "").toLowerCase();
-    steps.push({ axis, raw, name });
-  }
-  return steps;
-}
-function buildXPathFromSteps(steps) {
-  let out = "";
-  for (const st of steps) {
-    out += st.axis === "desc" ? "//" : "/";
-    out += st.raw;
-  }
-  return out || "/";
-}
-function resolveFocusFrameAndTail(page, absoluteXPath, parentByFrame, rootId) {
-  return __async(this, null, function* () {
-    const steps = parseXPathToSteps(absoluteXPath);
+    var _a4;
+    const parts = rawSelector.split(">>").map((s2) => s2.trim()).filter(Boolean);
     let ctxFrameId = rootId;
-    let buf = [];
-    let absPrefix = "";
-    const flushIntoChild = () => __async(null, null, function* () {
-      if (!buf.length) return;
-      const selectorForIframe = buildXPathFromSteps(buf);
+    const absPrefix = "";
+    for (let i2 = 0; i2 < Math.max(0, parts.length - 1); i2++) {
       const parentSess = page.getSessionForFrame(ctxFrameId);
-      const objectId = yield resolveObjectIdForXPath(
+      const objectId = yield resolveObjectIdForCss(
         parentSess,
-        selectorForIframe,
+        parts[i2],
         ctxFrameId
       );
       if (!objectId)
         throw new StagehandIframeError(
-          selectorForIframe,
-          "Failed to resolve iframe element by XPath"
+          parts[i2],
+          "Failed to resolve iframe via CSS hop"
         );
       try {
         yield parentSess.send("DOM.enable").catch(() => {
@@ -1492,246 +952,22 @@ function resolveFocusFrameAndTail(page, absoluteXPath, parentByFrame, rootId) {
               break;
             }
           } catch (e2) {
+            continue;
           }
         }
         if (!childFrameId)
           throw new StagehandIframeError(
-            selectorForIframe,
-            "Could not map iframe to child frameId"
+            parts[i2],
+            "Could not map CSS iframe hop to child frameId"
           );
-        absPrefix = prefixXPath(absPrefix || "/", selectorForIframe);
         ctxFrameId = childFrameId;
       } finally {
         yield parentSess.send("Runtime.releaseObject", { objectId }).catch(() => {
         });
       }
-      buf = [];
-    });
-    for (const st of steps) {
-      buf.push(st);
-      if (IFRAME_STEP_RE.test(st.name)) {
-        yield flushIntoChild();
-      }
     }
-    const tailXPath = buildXPathFromSteps(buf);
-    return { targetFrameId: ctxFrameId, tailXPath, absPrefix };
-  });
-}
-function resolveCssFocusFrameAndTail(page, rawSelector, parentByFrame, rootId) {
-  return __async(this, null, function* () {
-    var _a4;
-    const parts = rawSelector.split(">>").map((s2) => s2.trim()).filter(Boolean);
-    let ctxFrameId = rootId;
-    const absPrefix = "";
-    for (let i2 = 0; i2 < Math.max(0, parts.length - 1); i2++) {
-      const parentSess = page.getSessionForFrame(ctxFrameId);
-      const objectId = yield resolveObjectIdForCss(
-        parentSess,
-        parts[i2],
-        ctxFrameId
-      );
-      if (!objectId)
-        throw new StagehandIframeError(
-          parts[i2],
-          "Failed to resolve iframe via CSS hop"
-        );
-      try {
-        yield parentSess.send("DOM.enable").catch(() => {
-        });
-        const desc = yield parentSess.send(
-          "DOM.describeNode",
-          { objectId }
-        );
-        const iframeBackendNodeId = desc.node.backendNodeId;
-        let childFrameId;
-        for (const fid of listChildrenOf(parentByFrame, ctxFrameId)) {
-          try {
-            const { backendNodeId } = yield parentSess.send("DOM.getFrameOwner", { frameId: fid });
-            if (backendNodeId === iframeBackendNodeId) {
-              childFrameId = fid;
-              break;
-            }
-          } catch (e2) {
-          }
-        }
-        if (!childFrameId)
-          throw new StagehandIframeError(
-            parts[i2],
-            "Could not map CSS iframe hop to child frameId"
-          );
-        ctxFrameId = childFrameId;
-      } finally {
-        yield parentSess.send("Runtime.releaseObject", { objectId }).catch(() => {
-        });
-      }
-    }
-    const tailSelector = (_a4 = parts[parts.length - 1]) != null ? _a4 : "*";
-    return { targetFrameId: ctxFrameId, tailSelector, absPrefix };
-  });
-}
-function listChildrenOf(parentByFrame, parentId) {
-  const out = [];
-  for (const [fid, p] of parentByFrame.entries()) {
-    if (p === parentId) out.push(fid);
-  }
-  return out;
-}
-function domMapsForSession(session, frameId, pierce, encode = (fid, be) => `${fid}-${be}`, attemptOwnerLookup = true) {
-  return __async(this, null, function* () {
-    var _a4, _b;
-    yield session.send("DOM.enable").catch(() => {
-    });
-    const root = yield getDomTreeWithFallback(session, pierce);
-    let startNode = root;
-    if (attemptOwnerLookup) {
-      try {
-        const owner = yield session.send(
-          "DOM.getFrameOwner",
-          { frameId }
-        );
-        const ownerBackendId = owner.backendNodeId;
-        if (typeof ownerBackendId === "number") {
-          const ownerEl = findNodeByBackendId(root, ownerBackendId);
-          if (ownerEl == null ? void 0 : ownerEl.contentDocument) {
-            startNode = ownerEl.contentDocument;
-          }
-        }
-      } catch (e2) {
-      }
-    }
-    const tagNameMap = {};
-    const xpathMap = {};
-    const scrollableMap = {};
-    const stack = [{ node: startNode, xpath: "" }];
-    while (stack.length) {
-      const { node, xpath } = stack.pop();
-      if (node.backendNodeId) {
-        const encId = encode(frameId, node.backendNodeId);
-        tagNameMap[encId] = String(node.nodeName).toLowerCase();
-        xpathMap[encId] = xpath || "/";
-        const isScrollable = (node == null ? void 0 : node.isScrollable) === true;
-        if (isScrollable) scrollableMap[encId] = true;
-      }
-      const kids = (_a4 = node.children) != null ? _a4 : [];
-      if (kids.length) {
-        const segs = buildChildXPathSegments(kids);
-        for (let i2 = kids.length - 1; i2 >= 0; i2--) {
-          const child = kids[i2];
-          const step = segs[i2];
-          stack.push({
-            node: child,
-            xpath: joinXPath(xpath, step)
-          });
-        }
-      }
-      for (const sr of (_b = node.shadowRoots) != null ? _b : []) {
-        stack.push({
-          node: sr,
-          xpath: joinXPath(xpath, "//")
-        });
-      }
-    }
-    return { tagNameMap, xpathMap, scrollableMap };
-  });
-}
-function buildChildXPathSegments(kids) {
-  var _a4;
-  const segs = [];
-  const ctr = {};
-  for (const child of kids) {
-    const tag = String(child.nodeName).toLowerCase();
-    const key = `${child.nodeType}:${tag}`;
-    const idx = ctr[key] = ((_a4 = ctr[key]) != null ? _a4 : 0) + 1;
-    if (child.nodeType === 3) {
-      segs.push(`text()[${idx}]`);
-    } else if (child.nodeType === 8) {
-      segs.push(`comment()[${idx}]`);
-    } else {
-      segs.push(
-        tag.includes(":") ? `*[name()='${tag}'][${idx}]` : `${tag}[${idx}]`
-      );
-    }
-  }
-  return segs;
-}
-function joinXPath(base, step) {
-  if (step === "//") {
-    if (!base || base === "/") return "//";
-    return base.endsWith("/") ? `${base}/` : `${base}//`;
-  }
-  if (!base || base === "/") return step ? `/${step}` : "/";
-  if (base.endsWith("//")) return `${base}${step}`;
-  if (!step) return base;
-  return `${base}/${step}`;
-}
-function a11yForFrame(session, frameId, opts) {
-  return __async(this, null, function* () {
-    var _a4, _b;
-    yield session.send("Accessibility.enable").catch(() => {
-    });
-    yield session.send("Runtime.enable").catch(() => {
-    });
-    yield session.send("DOM.enable").catch(() => {
-    });
-    let nodes = [];
-    try {
-      const params = frameId ? { frameId } : {};
-      ({ nodes } = yield session.send("Accessibility.getFullAXTree", params));
-    } catch (e2) {
-      const msg = String((_b = (_a4 = e2 == null ? void 0 : e2.message) != null ? _a4 : e2) != null ? _b : "");
-      const isFrameScopeError = msg.includes("Frame with the given") || msg.includes("does not belong to the target") || msg.includes("is not found");
-      if (!isFrameScopeError || !frameId) throw e2;
-      ({ nodes } = yield session.send("Accessibility.getFullAXTree"));
-    }
-    const urlMap = {};
-    for (const n of nodes) {
-      const be = n.backendDOMNodeId;
-      if (typeof be !== "number") continue;
-      const url = extractUrlFromAXNode(n);
-      if (!url) continue;
-      const enc = opts.encode(be);
-      urlMap[enc] = url;
-    }
-    let scopeApplied = false;
-    const nodesForOutline = yield (() => __async(null, null, function* () {
-      var _a5, _b2, _c;
-      const sel = (_a5 = opts.focusSelector) == null ? void 0 : _a5.trim();
-      if (!sel) return nodes;
-      try {
-        const looksLikeXPath = /^xpath=/i.test(sel) || sel.startsWith("/");
-        const objectId = looksLikeXPath ? yield resolveObjectIdForXPath(session, sel, frameId) : yield resolveObjectIdForCss(session, sel, frameId);
-        if (!objectId) return nodes;
-        const desc = yield session.send(
-          "DOM.describeNode",
-          { objectId }
-        );
-        const be = (_b2 = desc.node) == null ? void 0 : _b2.backendNodeId;
-        if (typeof be !== "number") return nodes;
-        const target = nodes.find((n) => n.backendDOMNodeId === be);
-        if (!target) return nodes;
-        scopeApplied = true;
-        const keep = /* @__PURE__ */ new Set([target.nodeId]);
-        const queue = [target];
-        while (queue.length) {
-          const cur = queue.shift();
-          for (const id of (_c = cur.childIds) != null ? _c : []) {
-            if (keep.has(id)) continue;
-            keep.add(id);
-            const child = nodes.find((n) => n.nodeId === id);
-            if (child) queue.push(child);
-          }
-        }
-        return nodes.filter((n) => keep.has(n.nodeId)).map(
-          (n) => n.nodeId === target.nodeId ? __spreadProps(__spreadValues({}, n), { parentId: void 0 }) : n
-        );
-      } catch (e2) {
-        return nodes;
-      }
-    }))();
-    const decorated = decorateRoles(nodesForOutline, opts);
-    const { tree } = yield buildHierarchicalTree(decorated, opts);
-    const simplified = tree.map((n) => formatTreeLine(n)).join("\n");
-    return { outline: simplified.trimEnd(), urlMap, scopeApplied };
+    const tailSelector = (_a4 = parts[parts.length - 1]) != null ? _a4 : "*";
+    return { targetFrameId: ctxFrameId, tailSelector, absPrefix };
   });
 }
 function resolveObjectIdForXPath(session, xpath, frameId) {
@@ -1803,89 +1039,25 @@ function resolveObjectIdForCss(session, selector, frameId) {
     return evaluate(fallbackExpr);
   });
 }
-function decorateRoles(nodes, opts) {
-  const asRole = (n) => {
-    var _a4, _b;
-    return String((_b = (_a4 = n.role) == null ? void 0 : _a4.value) != null ? _b : "");
-  };
-  return nodes.map((n) => {
-    var _a4, _b, _c;
-    let encodedId;
-    if (typeof n.backendDOMNodeId === "number") {
-      try {
-        encodedId = opts.encode(n.backendDOMNodeId);
-      } catch (e2) {
-      }
-    }
-    let role = asRole(n);
-    const domIsScrollable = encodedId ? opts.scrollableMap[encodedId] === true : false;
-    const tag = encodedId ? opts.tagNameMap[encodedId] : void 0;
-    const isHtmlElement = tag === "html";
-    if ((domIsScrollable || isHtmlElement) && tag !== "#document") {
-      const tagLabel = tag && tag.startsWith("#") ? tag.slice(1) : tag;
-      role = tagLabel ? `scrollable, ${tagLabel}` : `scrollable${role ? `, ${role}` : ""}`;
-    }
-    return {
-      role,
-      name: (_a4 = n.name) == null ? void 0 : _a4.value,
-      description: (_b = n.description) == null ? void 0 : _b.value,
-      value: (_c = n.value) == null ? void 0 : _c.value,
-      nodeId: n.nodeId,
-      backendDOMNodeId: n.backendDOMNodeId,
-      parentId: n.parentId,
-      childIds: n.childIds,
-      encodedId
-    };
-  });
-}
-function buildHierarchicalTree(nodes, opts) {
-  return __async(this, null, function* () {
-    var _a4;
-    const nodeMap = /* @__PURE__ */ new Map();
-    for (const n of nodes) {
-      const keep = !!(n.name && n.name.trim()) || !!(n.childIds && n.childIds.length) || !isStructural(n.role);
-      if (!keep) continue;
-      nodeMap.set(n.nodeId, __spreadValues({}, n));
-    }
-    for (const n of nodes) {
-      if (!n.parentId) continue;
-      const parent = nodeMap.get(n.parentId);
-      const cur = nodeMap.get(n.nodeId);
-      if (parent && cur) ((_a4 = parent.children) != null ? _a4 : parent.children = []).push(cur);
-    }
-    const roots = nodes.filter((n) => !n.parentId && nodeMap.has(n.nodeId)).map((n) => nodeMap.get(n.nodeId));
-    const cleaned = (yield Promise.all(roots.map(pruneStructuralSafe))).filter(
-      Boolean
-    );
-    return { tree: cleaned };
-    function pruneStructuralSafe(node) {
-      return __async(this, null, function* () {
-        var _a5;
-        if (+node.nodeId < 0) return null;
-        const children = (_a5 = node.children) != null ? _a5 : [];
-        if (!children.length) {
-          return isStructural(node.role) ? null : node;
-        }
-        const cleanedKids = (yield Promise.all(children.map(pruneStructuralSafe))).filter(Boolean);
-        const prunedStatic = removeRedundantStaticTextChildren(node, cleanedKids);
-        if (isStructural(node.role)) {
-          if (prunedStatic.length === 1) return prunedStatic[0];
-          if (prunedStatic.length === 0) return null;
-        }
-        let newRole = node.role;
-        if ((newRole === "generic" || newRole === "none") && node.encodedId) {
-          const tagName = opts.tagNameMap[node.encodedId];
-          if (tagName) newRole = tagName;
-        }
-        if (newRole === "combobox" && node.encodedId) {
-          const tagName = opts.tagNameMap[node.encodedId];
-          if (tagName === "select") newRole = "select";
-        }
-        return __spreadProps(__spreadValues({}, node), { role: newRole, children: prunedStatic });
-      });
-    }
-  });
+function listChildrenOf(parentByFrame, parentId) {
+  const out = [];
+  for (const [fid, p] of parentByFrame.entries()) {
+    if (p === parentId) out.push(fid);
+  }
+  return out;
 }
+var IFRAME_STEP_RE;
+var init_focusSelectors = __esm({
+  "lib/v3/understudy/a11y/snapshot/focusSelectors.ts"() {
+    init_executionContextRegistry();
+    init_locatorInvocation();
+    init_sdkErrors();
+    init_xpathUtils();
+    IFRAME_STEP_RE = /^iframe(?:\[\d+])?$/i;
+  }
+});
+
+// lib/v3/understudy/a11y/snapshot/treeFormatUtils.ts
 function formatTreeLine(node, level = 0) {
   var _a4, _b, _c;
   const indent = "  ".repeat(level);
@@ -1895,80 +1067,6 @@ function formatTreeLine(node, level = 0) {
   return kids ? `${indent}${label}
 ${kids}` : `${indent}${label}`;
 }
-function isStructural(role) {
-  const r2 = role == null ? void 0 : role.toLowerCase();
-  return r2 === "generic" || r2 === "none" || r2 === "inlinetextbox";
-}
-function cleanText(input) {
-  const PUA_START = 57344;
-  const PUA_END = 63743;
-  const NBSP = /* @__PURE__ */ new Set([160, 8239, 8199, 65279]);
-  let out = "";
-  let prevSpace = false;
-  for (let i2 = 0; i2 < input.length; i2++) {
-    const code = input.charCodeAt(i2);
-    if (code >= PUA_START && code <= PUA_END) continue;
-    if (NBSP.has(code)) {
-      if (!prevSpace) {
-        out += " ";
-        prevSpace = true;
-      }
-      continue;
-    }
-    out += input[i2];
-    prevSpace = input[i2] === " ";
-  }
-  return out.trim();
-}
-function extractUrlFromAXNode(ax) {
-  var _a4, _b;
-  const props = (_a4 = ax.properties) != null ? _a4 : [];
-  const urlProp = props.find((p) => p.name === "url");
-  const value = (_b = urlProp == null ? void 0 : urlProp.value) == null ? void 0 : _b.value;
-  return typeof value === "string" && value.trim() ? value.trim() : void 0;
-}
-function normaliseSpaces(s2) {
-  let out = "";
-  let inWs = false;
-  for (let i2 = 0; i2 < s2.length; i2++) {
-    const ch = s2[i2];
-    const isWs = /\s/.test(ch);
-    if (isWs) {
-      if (!inWs) {
-        out += " ";
-        inWs = true;
-      }
-    } else {
-      out += ch;
-      inWs = false;
-    }
-  }
-  return out;
-}
-function removeRedundantStaticTextChildren(parent, children) {
-  if (!parent.name) return children;
-  const parentNorm = normaliseSpaces(parent.name).trim();
-  let combined = "";
-  for (const c of children) {
-    if (c.role === "StaticText" && c.name) {
-      combined += normaliseSpaces(c.name).trim();
-    }
-  }
-  if (combined === parentNorm) {
-    return children.filter((c) => c.role !== "StaticText");
-  }
-  return children;
-}
-function findNodeByBackendId(root, backendNodeId) {
-  const stack = [root];
-  while (stack.length) {
-    const n = stack.pop();
-    if (n.backendNodeId === backendNodeId) return n;
-    if (n.children) for (const c of n.children) stack.push(c);
-    if (n.shadowRoots) for (const s2 of n.shadowRoots) stack.push(s2);
-  }
-  return void 0;
-}
 function injectSubtrees(rootOutline, idToTree) {
   var _a4, _b;
   const out = [];
@@ -2024,29 +1122,1069 @@ function diffCombinedTrees(prevTree, nextTree) {
   );
   return out.join("\n");
 }
-function ownerSession(page, frameId) {
-  return page.getSessionForFrame(frameId);
+function cleanText(input) {
+  const PUA_START = 57344;
+  const PUA_END = 63743;
+  const NBSP = /* @__PURE__ */ new Set([160, 8239, 8199, 65279]);
+  let out = "";
+  let prevSpace = false;
+  for (let i2 = 0; i2 < input.length; i2++) {
+    const code = input.charCodeAt(i2);
+    if (code >= PUA_START && code <= PUA_END) continue;
+    if (NBSP.has(code)) {
+      if (!prevSpace) {
+        out += " ";
+        prevSpace = true;
+      }
+      continue;
+    }
+    out += input[i2];
+    prevSpace = input[i2] === " ";
+  }
+  return out.trim();
 }
-function parentSession(page, parentByFrame, frameId) {
-  var _a4;
-  const parentId = (_a4 = parentByFrame.get(frameId)) != null ? _a4 : null;
-  if (!parentId) {
-    return page.getSessionForFrame(frameId);
+function normaliseSpaces(s2) {
+  let out = "";
+  let inWs = false;
+  for (let i2 = 0; i2 < s2.length; i2++) {
+    const ch = s2[i2];
+    const isWs = /\s/.test(ch);
+    if (isWs) {
+      if (!inWs) {
+        out += " ";
+        inWs = true;
+      }
+    } else {
+      out += ch;
+      inWs = false;
+    }
   }
-  return page.getSessionForFrame(parentId);
+  return out;
 }
-var DOM_DEPTH_ATTEMPTS, DESCRIBE_DEPTH_ATTEMPTS, IFRAME_STEP_RE;
-var init_snapshot = __esm({
-  "lib/v3/understudy/a11y/snapshot.ts"() {
-    init_executionContextRegistry();
-    init_logger();
-    init_a11yScripts_generated();
-    init_a11yInvocation();
-    init_locatorInvocation();
-    init_sdkErrors();
-    DOM_DEPTH_ATTEMPTS = [-1, 256, 128, 64, 32, 16, 8, 4, 2, 1];
-    DESCRIBE_DEPTH_ATTEMPTS = [-1, 64, 32, 16, 8, 4, 2, 1];
-    IFRAME_STEP_RE = /^iframe(?:\[\d+])?$/i;
+var init_treeFormatUtils = __esm({
+  "lib/v3/understudy/a11y/snapshot/treeFormatUtils.ts"() {
+  }
+});
+
+// lib/v3/understudy/a11y/snapshot/a11yTree.ts
+function a11yForFrame(session, frameId, opts) {
+  return __async(this, null, function* () {
+    var _a4, _b;
+    yield session.send("Accessibility.enable").catch(() => {
+    });
+    yield session.send("Runtime.enable").catch(() => {
+    });
+    yield session.send("DOM.enable").catch(() => {
+    });
+    let nodes = [];
+    try {
+      const params = frameId ? { frameId } : {};
+      ({ nodes } = yield session.send("Accessibility.getFullAXTree", params));
+    } catch (e2) {
+      const msg = String((_b = (_a4 = e2 == null ? void 0 : e2.message) != null ? _a4 : e2) != null ? _b : "");
+      const isFrameScopeError = msg.includes("Frame with the given") || msg.includes("does not belong to the target") || msg.includes("is not found");
+      if (!isFrameScopeError || !frameId) throw e2;
+      ({ nodes } = yield session.send("Accessibility.getFullAXTree"));
+    }
+    const urlMap = {};
+    for (const n of nodes) {
+      const be = n.backendDOMNodeId;
+      if (typeof be !== "number") continue;
+      const url = extractUrlFromAXNode(n);
+      if (!url) continue;
+      const enc = opts.encode(be);
+      urlMap[enc] = url;
+    }
+    let scopeApplied = false;
+    const nodesForOutline = yield (() => __async(null, null, function* () {
+      var _a5, _b2, _c;
+      const sel = (_a5 = opts.focusSelector) == null ? void 0 : _a5.trim();
+      if (!sel) return nodes;
+      try {
+        const looksLikeXPath = /^xpath=/i.test(sel) || sel.startsWith("/");
+        const objectId = looksLikeXPath ? yield resolveObjectIdForXPath(session, sel, frameId) : yield resolveObjectIdForCss(session, sel, frameId);
+        if (!objectId) return nodes;
+        const desc = yield session.send(
+          "DOM.describeNode",
+          { objectId }
+        );
+        const be = (_b2 = desc.node) == null ? void 0 : _b2.backendNodeId;
+        if (typeof be !== "number") return nodes;
+        const target = nodes.find((n) => n.backendDOMNodeId === be);
+        if (!target) return nodes;
+        scopeApplied = true;
+        const keep = /* @__PURE__ */ new Set([target.nodeId]);
+        const queue = [target];
+        while (queue.length) {
+          const cur = queue.shift();
+          for (const id of (_c = cur.childIds) != null ? _c : []) {
+            if (keep.has(id)) continue;
+            keep.add(id);
+            const child = nodes.find((n) => n.nodeId === id);
+            if (child) queue.push(child);
+          }
+        }
+        return nodes.filter((n) => keep.has(n.nodeId)).map(
+          (n) => n.nodeId === target.nodeId ? __spreadProps(__spreadValues({}, n), { parentId: void 0 }) : n
+        );
+      } catch (e2) {
+        return nodes;
+      }
+    }))();
+    const decorated = decorateRoles(nodesForOutline, opts);
+    const { tree } = yield buildHierarchicalTree(decorated, opts);
+    const simplified = tree.map((n) => formatTreeLine(n)).join("\n");
+    return { outline: simplified.trimEnd(), urlMap, scopeApplied };
+  });
+}
+function decorateRoles(nodes, opts) {
+  const asRole = (n) => {
+    var _a4, _b;
+    return String((_b = (_a4 = n.role) == null ? void 0 : _a4.value) != null ? _b : "");
+  };
+  return nodes.map((n) => {
+    var _a4, _b, _c;
+    let encodedId;
+    if (typeof n.backendDOMNodeId === "number") {
+      try {
+        encodedId = opts.encode(n.backendDOMNodeId);
+      } catch (e2) {
+      }
+    }
+    let role = asRole(n);
+    const domIsScrollable = encodedId ? opts.scrollableMap[encodedId] === true : false;
+    const tag = encodedId ? opts.tagNameMap[encodedId] : void 0;
+    const isHtmlElement = tag === "html";
+    if ((domIsScrollable || isHtmlElement) && tag !== "#document") {
+      const tagLabel = tag && tag.startsWith("#") ? tag.slice(1) : tag;
+      role = tagLabel ? `scrollable, ${tagLabel}` : `scrollable${role ? `, ${role}` : ""}`;
+    }
+    return {
+      role,
+      name: (_a4 = n.name) == null ? void 0 : _a4.value,
+      description: (_b = n.description) == null ? void 0 : _b.value,
+      value: (_c = n.value) == null ? void 0 : _c.value,
+      nodeId: n.nodeId,
+      backendDOMNodeId: n.backendDOMNodeId,
+      parentId: n.parentId,
+      childIds: n.childIds,
+      encodedId
+    };
+  });
+}
+function buildHierarchicalTree(nodes, opts) {
+  return __async(this, null, function* () {
+    var _a4;
+    const nodeMap = /* @__PURE__ */ new Map();
+    for (const n of nodes) {
+      const keep = !!(n.name && n.name.trim()) || !!(n.childIds && n.childIds.length) || !isStructural(n.role);
+      if (!keep) continue;
+      nodeMap.set(n.nodeId, __spreadValues({}, n));
+    }
+    for (const n of nodes) {
+      if (!n.parentId) continue;
+      const parent = nodeMap.get(n.parentId);
+      const cur = nodeMap.get(n.nodeId);
+      if (parent && cur) ((_a4 = parent.children) != null ? _a4 : parent.children = []).push(cur);
+    }
+    const roots = nodes.filter((n) => !n.parentId && nodeMap.has(n.nodeId)).map((n) => nodeMap.get(n.nodeId));
+    const cleaned = (yield Promise.all(roots.map(pruneStructuralSafe))).filter(
+      Boolean
+    );
+    return { tree: cleaned };
+    function pruneStructuralSafe(node) {
+      return __async(this, null, function* () {
+        var _a5;
+        if (+node.nodeId < 0) return null;
+        const children = (_a5 = node.children) != null ? _a5 : [];
+        if (!children.length) {
+          return isStructural(node.role) ? null : node;
+        }
+        const cleanedKids = (yield Promise.all(children.map(pruneStructuralSafe))).filter(Boolean);
+        const prunedStatic = removeRedundantStaticTextChildren(node, cleanedKids);
+        if (isStructural(node.role)) {
+          if (prunedStatic.length === 1) return prunedStatic[0];
+          if (prunedStatic.length === 0) return null;
+        }
+        let newRole = node.role;
+        if ((newRole === "generic" || newRole === "none") && node.encodedId) {
+          const tagName = opts.tagNameMap[node.encodedId];
+          if (tagName) newRole = tagName;
+        }
+        if (newRole === "combobox" && node.encodedId) {
+          const tagName = opts.tagNameMap[node.encodedId];
+          if (tagName === "select") newRole = "select";
+        }
+        return __spreadProps(__spreadValues({}, node), { role: newRole, children: prunedStatic });
+      });
+    }
+  });
+}
+function isStructural(role) {
+  const r2 = role == null ? void 0 : role.toLowerCase();
+  return r2 === "generic" || r2 === "none" || r2 === "inlinetextbox";
+}
+function extractUrlFromAXNode(ax) {
+  var _a4, _b;
+  const props = (_a4 = ax.properties) != null ? _a4 : [];
+  const urlProp = props.find((p) => p.name === "url");
+  const value = (_b = urlProp == null ? void 0 : urlProp.value) == null ? void 0 : _b.value;
+  return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function removeRedundantStaticTextChildren(parent, children) {
+  if (!parent.name) return children;
+  const parentNorm = normaliseSpaces(parent.name).trim();
+  let combined = "";
+  for (const c of children) {
+    if (c.role === "StaticText" && c.name) {
+      combined += normaliseSpaces(c.name).trim();
+    }
+  }
+  if (combined === parentNorm) {
+    return children.filter((c) => c.role !== "StaticText");
+  }
+  return children;
+}
+var init_a11yTree = __esm({
+  "lib/v3/understudy/a11y/snapshot/a11yTree.ts"() {
+    init_focusSelectors();
+    init_treeFormatUtils();
+  }
+});
+
+// lib/v3/understudy/a11y/snapshot/domTree.ts
+function isCborStackError(message) {
+  return message.includes("CBOR: stack limit exceeded");
+}
+function shouldExpandNode(node) {
+  var _a4, _b, _c;
+  const declaredChildren = (_a4 = node.childNodeCount) != null ? _a4 : 0;
+  const realizedChildren = (_c = (_b = node.children) == null ? void 0 : _b.length) != null ? _c : 0;
+  return declaredChildren > realizedChildren;
+}
+function mergeDomNodes(target, source) {
+  var _a4, _b, _c, _d2;
+  target.childNodeCount = (_a4 = source.childNodeCount) != null ? _a4 : target.childNodeCount;
+  target.children = (_b = source.children) != null ? _b : target.children;
+  target.shadowRoots = (_c = source.shadowRoots) != null ? _c : target.shadowRoots;
+  target.contentDocument = (_d2 = source.contentDocument) != null ? _d2 : target.contentDocument;
+}
+function collectDomTraversalTargets(node) {
+  const targets = [];
+  if (node.children) targets.push(...node.children);
+  if (node.shadowRoots) targets.push(...node.shadowRoots);
+  if (node.contentDocument) targets.push(node.contentDocument);
+  return targets;
+}
+function hydrateDomTree(session, root, pierce) {
+  return __async(this, null, function* () {
+    var _a4, _b;
+    const stack = [root];
+    const expandedNodeIds = /* @__PURE__ */ new Set();
+    const expandedBackendIds = /* @__PURE__ */ new Set();
+    while (stack.length) {
+      const node = stack.pop();
+      const nodeId = typeof node.nodeId === "number" && node.nodeId > 0 ? node.nodeId : void 0;
+      const backendId = typeof node.backendNodeId === "number" && node.backendNodeId > 0 ? node.backendNodeId : void 0;
+      const seenByNode = nodeId ? expandedNodeIds.has(nodeId) : false;
+      const seenByBackend = !nodeId && backendId ? expandedBackendIds.has(backendId) : false;
+      if (seenByNode || seenByBackend) continue;
+      if (nodeId) expandedNodeIds.add(nodeId);
+      else if (backendId) expandedBackendIds.add(backendId);
+      const needsExpansion = shouldExpandNode(node);
+      if (needsExpansion && (nodeId || backendId)) {
+        const describeParamsBase = nodeId ? { nodeId } : { backendNodeId: backendId };
+        let expanded = false;
+        for (const depth of DESCRIBE_DEPTH_ATTEMPTS) {
+          try {
+            const described = yield session.send(
+              "DOM.describeNode",
+              __spreadProps(__spreadValues({}, describeParamsBase), {
+                depth,
+                pierce
+              })
+            );
+            mergeDomNodes(node, described.node);
+            if (!nodeId && described.node.nodeId && described.node.nodeId > 0) {
+              node.nodeId = described.node.nodeId;
+              expandedNodeIds.add(described.node.nodeId);
+            }
+            expanded = true;
+            break;
+          } catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (isCborStackError(message)) {
+              continue;
+            }
+            const identifier = (_a4 = nodeId != null ? nodeId : backendId) != null ? _a4 : "unknown";
+            throw new StagehandDomProcessError(
+              `Failed to expand DOM node ${identifier}: ${String(err)}`
+            );
+          }
+        }
+        if (!expanded) {
+          const identifier = (_b = nodeId != null ? nodeId : backendId) != null ? _b : "unknown";
+          throw new StagehandDomProcessError(
+            `Unable to expand DOM node ${identifier} after describeNode depth retries`
+          );
+        }
+      }
+      for (const child of collectDomTraversalTargets(node)) {
+        stack.push(child);
+      }
+    }
+  });
+}
+function getDomTreeWithFallback(session, pierce) {
+  return __async(this, null, function* () {
+    let lastCborMessage = "";
+    for (const depth of DOM_DEPTH_ATTEMPTS) {
+      try {
+        const { root } = yield session.send(
+          "DOM.getDocument",
+          { depth, pierce }
+        );
+        if (depth !== -1) {
+          yield hydrateDomTree(session, root, pierce);
+        }
+        return root;
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (isCborStackError(message)) {
+          lastCborMessage = message;
+          continue;
+        }
+        throw err;
+      }
+    }
+    throw new StagehandDomProcessError(
+      lastCborMessage ? `CDP DOM.getDocument failed after adaptive depth retries: ${lastCborMessage}` : "CDP DOM.getDocument failed after adaptive depth retries."
+    );
+  });
+}
+function domMapsForSession(session, frameId, pierce, encode, attemptOwnerLookup = true) {
+  return __async(this, null, function* () {
+    var _a4, _b;
+    yield session.send("DOM.enable").catch(() => {
+    });
+    const root = yield getDomTreeWithFallback(session, pierce);
+    let startNode = root;
+    if (attemptOwnerLookup) {
+      try {
+        const owner = yield session.send(
+          "DOM.getFrameOwner",
+          { frameId }
+        );
+        const ownerBackendId = owner.backendNodeId;
+        if (typeof ownerBackendId === "number") {
+          const ownerEl = findNodeByBackendId(root, ownerBackendId);
+          if (ownerEl == null ? void 0 : ownerEl.contentDocument) {
+            startNode = ownerEl.contentDocument;
+          }
+        }
+      } catch (e2) {
+      }
+    }
+    const tagNameMap = {};
+    const xpathMap = {};
+    const scrollableMap = {};
+    const stack = [{ node: startNode, xpath: "" }];
+    while (stack.length) {
+      const { node, xpath } = stack.pop();
+      if (node.backendNodeId) {
+        const encId = encode(frameId, node.backendNodeId);
+        tagNameMap[encId] = String(node.nodeName).toLowerCase();
+        xpathMap[encId] = xpath || "/";
+        const isScrollable = (node == null ? void 0 : node.isScrollable) === true;
+        if (isScrollable) scrollableMap[encId] = true;
+      }
+      const kids = (_a4 = node.children) != null ? _a4 : [];
+      if (kids.length) {
+        const segs = buildChildXPathSegments(kids);
+        for (let i2 = kids.length - 1; i2 >= 0; i2--) {
+          const child = kids[i2];
+          const step = segs[i2];
+          stack.push({
+            node: child,
+            xpath: joinXPath(xpath, step)
+          });
+        }
+      }
+      for (const sr of (_b = node.shadowRoots) != null ? _b : []) {
+        stack.push({
+          node: sr,
+          xpath: joinXPath(xpath, "//")
+        });
+      }
+    }
+    return { tagNameMap, xpathMap, scrollableMap };
+  });
+}
+function buildSessionDomIndex(session, pierce) {
+  return __async(this, null, function* () {
+    var _a4, _b;
+    yield session.send("DOM.enable").catch(() => {
+    });
+    const root = yield getDomTreeWithFallback(session, pierce);
+    const absByBe = /* @__PURE__ */ new Map();
+    const tagByBe = /* @__PURE__ */ new Map();
+    const scrollByBe = /* @__PURE__ */ new Map();
+    const docRootOf = /* @__PURE__ */ new Map();
+    const contentDocRootByIframe = /* @__PURE__ */ new Map();
+    const rootBe = root.backendNodeId;
+    const stack = [{ node: root, xp: "/", docRootBe: rootBe }];
+    while (stack.length) {
+      const { node, xp, docRootBe } = stack.pop();
+      if (node.backendNodeId) {
+        absByBe.set(node.backendNodeId, xp || "/");
+        tagByBe.set(node.backendNodeId, String(node.nodeName).toLowerCase());
+        if ((node == null ? void 0 : node.isScrollable) === true) scrollByBe.set(node.backendNodeId, true);
+        docRootOf.set(node.backendNodeId, docRootBe);
+      }
+      const kids = (_a4 = node.children) != null ? _a4 : [];
+      if (kids.length) {
+        const segs = buildChildXPathSegments(kids);
+        for (let i2 = kids.length - 1; i2 >= 0; i2--) {
+          const child = kids[i2];
+          const step = segs[i2];
+          stack.push({ node: child, xp: joinXPath(xp, step), docRootBe });
+        }
+      }
+      for (const sr of (_b = node.shadowRoots) != null ? _b : []) {
+        stack.push({ node: sr, xp: joinXPath(xp, "//"), docRootBe });
+      }
+      const cd = node.contentDocument;
+      if (cd && typeof cd.backendNodeId === "number") {
+        contentDocRootByIframe.set(node.backendNodeId, cd.backendNodeId);
+        stack.push({ node: cd, xp, docRootBe: cd.backendNodeId });
+      }
+    }
+    return {
+      rootBackend: rootBe,
+      absByBe,
+      tagByBe,
+      scrollByBe,
+      docRootOf,
+      contentDocRootByIframe
+    };
+  });
+}
+function relativizeXPath(baseAbs, nodeAbs) {
+  const base = normalizeXPath(baseAbs);
+  const abs = normalizeXPath(nodeAbs);
+  if (abs === base) return "/";
+  if (abs.startsWith(base)) {
+    const tail = abs.slice(base.length);
+    if (!tail) return "/";
+    return tail.startsWith("/") || tail.startsWith("//") ? tail : `/${tail}`;
+  }
+  if (base === "/") return abs;
+  return abs;
+}
+function findNodeByBackendId(root, backendNodeId) {
+  const stack = [root];
+  while (stack.length) {
+    const n = stack.pop();
+    if (n.backendNodeId === backendNodeId) return n;
+    if (n.children) for (const c of n.children) stack.push(c);
+    if (n.shadowRoots) for (const s2 of n.shadowRoots) stack.push(s2);
+  }
+  return void 0;
+}
+var DOM_DEPTH_ATTEMPTS, DESCRIBE_DEPTH_ATTEMPTS;
+var init_domTree = __esm({
+  "lib/v3/understudy/a11y/snapshot/domTree.ts"() {
+    init_sdkErrors();
+    init_xpathUtils();
+    DOM_DEPTH_ATTEMPTS = [-1, 256, 128, 64, 32, 16, 8, 4, 2, 1];
+    DESCRIBE_DEPTH_ATTEMPTS = [-1, 64, 32, 16, 8, 4, 2, 1];
+  }
+});
+
+// lib/v3/understudy/a11y/snapshot/sessions.ts
+function ownerSession(page, frameId) {
+  return page.getSessionForFrame(frameId);
+}
+function parentSession(page, parentByFrame, frameId) {
+  var _a4;
+  const parentId = (_a4 = parentByFrame.get(frameId)) != null ? _a4 : null;
+  if (!parentId) {
+    return page.getSessionForFrame(frameId);
+  }
+  return page.getSessionForFrame(parentId);
+}
+var init_sessions = __esm({
+  "lib/v3/understudy/a11y/snapshot/sessions.ts"() {
+  }
+});
+
+// lib/v3/understudy/a11y/snapshot/capture.ts
+function captureHybridSnapshot(page, options) {
+  return __async(this, null, function* () {
+    var _a4;
+    const pierce = (_a4 = options == null ? void 0 : options.pierceShadow) != null ? _a4 : true;
+    const context = buildFrameContext(page);
+    const scopedSnapshot = yield tryScopedSnapshot(
+      page,
+      options,
+      context,
+      pierce
+    );
+    if (scopedSnapshot) return scopedSnapshot;
+    const sessionToIndex = yield buildSessionIndexes(
+      page,
+      context.frames,
+      pierce
+    );
+    const { perFrameMaps, perFrameOutlines } = yield collectPerFrameMaps(
+      page,
+      context,
+      sessionToIndex,
+      options,
+      pierce
+    );
+    const { absPrefix, iframeHostEncByChild } = yield computeFramePrefixes(
+      page,
+      context,
+      perFrameMaps
+    );
+    return mergeFramesIntoSnapshot(
+      context,
+      perFrameMaps,
+      perFrameOutlines,
+      absPrefix,
+      iframeHostEncByChild
+    );
+  });
+}
+function buildFrameContext(page) {
+  const rootId = page.mainFrameId();
+  const frameTree = page.asProtocolFrameTree(rootId);
+  const parentByFrame = /* @__PURE__ */ new Map();
+  (function index(n, parent) {
+    var _a4;
+    parentByFrame.set(n.frame.id, parent);
+    for (const c of (_a4 = n.childFrames) != null ? _a4 : []) index(c, n.frame.id);
+  })(frameTree, null);
+  const frames = page.listAllFrameIds();
+  return { rootId, parentByFrame, frames };
+}
+function tryScopedSnapshot(page, options, context, pierce) {
+  return __async(this, null, function* () {
+    var _a4, _b;
+    const requestedFocus = (_a4 = options == null ? void 0 : options.focusSelector) == null ? void 0 : _a4.trim();
+    if (!requestedFocus) return null;
+    const logScopeFallback = () => {
+      var _a5;
+      v3Logger({
+        message: `Unable to narrow scope with selector. Falling back to using full DOM`,
+        level: 1,
+        auxiliary: {
+          arguments: {
+            value: `selector: ${(_a5 = options == null ? void 0 : options.focusSelector) == null ? void 0 : _a5.trim()}`,
+            type: "string"
+          }
+        }
+      });
+    };
+    try {
+      let targetFrameId;
+      let tailSelector;
+      let absPrefix;
+      const looksLikeXPath = /^xpath=/i.test(requestedFocus) || requestedFocus.startsWith("/");
+      if (looksLikeXPath) {
+        const focus = normalizeXPath(requestedFocus);
+        const hit = yield resolveFocusFrameAndTail(
+          page,
+          focus,
+          context.parentByFrame,
+          context.rootId
+        );
+        targetFrameId = hit.targetFrameId;
+        tailSelector = hit.tailXPath || void 0;
+        absPrefix = hit.absPrefix;
+      } else {
+        const cssHit = yield resolveCssFocusFrameAndTail(
+          page,
+          requestedFocus,
+          context.parentByFrame,
+          context.rootId
+        );
+        targetFrameId = cssHit.targetFrameId;
+        tailSelector = cssHit.tailSelector || void 0;
+        absPrefix = cssHit.absPrefix;
+      }
+      const owningSess = ownerSession(page, targetFrameId);
+      const parentId = context.parentByFrame.get(targetFrameId);
+      const sameSessionAsParent = !!parentId && ownerSession(page, parentId) === ownerSession(page, targetFrameId);
+      const { tagNameMap, xpathMap, scrollableMap } = yield domMapsForSession(
+        owningSess,
+        targetFrameId,
+        pierce,
+        (fid, be) => `${page.getOrdinal(fid)}-${be}`,
+        sameSessionAsParent
+      );
+      const { outline, urlMap, scopeApplied } = yield a11yForFrame(
+        owningSess,
+        targetFrameId,
+        {
+          focusSelector: tailSelector || void 0,
+          tagNameMap,
+          experimental: (_b = options == null ? void 0 : options.experimental) != null ? _b : false,
+          scrollableMap,
+          encode: (backendNodeId) => `${page.getOrdinal(targetFrameId)}-${backendNodeId}`
+        }
+      );
+      const scopedXpathMap = {};
+      const abs = absPrefix != null ? absPrefix : "";
+      const isRoot = !abs || abs === "/";
+      if (isRoot) {
+        Object.assign(scopedXpathMap, xpathMap);
+      } else {
+        for (const [encId, xp] of Object.entries(xpathMap)) {
+          scopedXpathMap[encId] = prefixXPath(abs, xp);
+        }
+      }
+      const scopedUrlMap = __spreadValues({}, urlMap);
+      const snapshot = {
+        combinedTree: outline,
+        combinedXpathMap: scopedXpathMap,
+        combinedUrlMap: scopedUrlMap,
+        perFrame: [
+          {
+            frameId: targetFrameId,
+            outline,
+            xpathMap,
+            urlMap
+          }
+        ]
+      };
+      if (scopeApplied) {
+        return snapshot;
+      }
+      logScopeFallback();
+    } catch (e2) {
+      logScopeFallback();
+    }
+    return null;
+  });
+}
+function buildSessionIndexes(page, frames, pierce) {
+  return __async(this, null, function* () {
+    var _a4;
+    const sessionToIndex = /* @__PURE__ */ new Map();
+    const sessionById = /* @__PURE__ */ new Map();
+    for (const frameId of frames) {
+      const sess = ownerSession(page, frameId);
+      const sid = (_a4 = sess.id) != null ? _a4 : "root";
+      if (!sessionById.has(sid)) sessionById.set(sid, sess);
+    }
+    for (const [sid, sess] of sessionById.entries()) {
+      const idx = yield buildSessionDomIndex(sess, pierce);
+      sessionToIndex.set(sid, idx);
+    }
+    return sessionToIndex;
+  });
+}
+function collectPerFrameMaps(page, context, sessionToIndex, options, pierce) {
+  return __async(this, null, function* () {
+    var _a4, _b, _c;
+    const perFrameMaps = /* @__PURE__ */ new Map();
+    const perFrameOutlines = [];
+    for (const frameId of context.frames) {
+      const sess = ownerSession(page, frameId);
+      const sid = (_a4 = sess.id) != null ? _a4 : "root";
+      let idx = sessionToIndex.get(sid);
+      if (!idx) {
+        idx = yield buildSessionDomIndex(sess, pierce);
+        sessionToIndex.set(sid, idx);
+      }
+      const parentId = context.parentByFrame.get(frameId);
+      const sameSessionAsParent = !!parentId && ownerSession(page, parentId) === sess;
+      let docRootBe = idx.rootBackend;
+      if (sameSessionAsParent) {
+        try {
+          const { backendNodeId } = yield sess.send(
+            "DOM.getFrameOwner",
+            { frameId }
+          );
+          if (typeof backendNodeId === "number") {
+            const cdBe = idx.contentDocRootByIframe.get(backendNodeId);
+            if (typeof cdBe === "number") docRootBe = cdBe;
+          }
+        } catch (e2) {
+        }
+      }
+      const tagNameMap = {};
+      const xpathMap = {};
+      const scrollableMap = {};
+      const enc = (be) => `${page.getOrdinal(frameId)}-${be}`;
+      const baseAbs = (_b = idx.absByBe.get(docRootBe)) != null ? _b : "/";
+      for (const [be, nodeAbs] of idx.absByBe.entries()) {
+        const nodeDocRoot = idx.docRootOf.get(be);
+        if (nodeDocRoot !== docRootBe) continue;
+        const rel = relativizeXPath(baseAbs, nodeAbs);
+        const key = enc(be);
+        xpathMap[key] = rel;
+        const tag = idx.tagByBe.get(be);
+        if (tag) tagNameMap[key] = tag;
+        if (idx.scrollByBe.get(be)) scrollableMap[key] = true;
+      }
+      const { outline, urlMap } = yield a11yForFrame(sess, frameId, {
+        experimental: (_c = options == null ? void 0 : options.experimental) != null ? _c : false,
+        tagNameMap,
+        scrollableMap,
+        encode: (backendNodeId) => `${page.getOrdinal(frameId)}-${backendNodeId}`
+      });
+      perFrameOutlines.push({ frameId, outline });
+      perFrameMaps.set(frameId, { tagNameMap, xpathMap, scrollableMap, urlMap });
+    }
+    return { perFrameMaps, perFrameOutlines };
+  });
+}
+function computeFramePrefixes(page, context, perFrameMaps) {
+  return __async(this, null, function* () {
+    const absPrefix = /* @__PURE__ */ new Map();
+    const iframeHostEncByChild = /* @__PURE__ */ new Map();
+    absPrefix.set(context.rootId, "");
+    const queue = [context.rootId];
+    while (queue.length) {
+      const parent = queue.shift();
+      const parentAbs = absPrefix.get(parent);
+      for (const child of context.frames) {
+        if (context.parentByFrame.get(child) !== parent) continue;
+        queue.push(child);
+        const parentSess = parentSession(page, context.parentByFrame, child);
+        const ownerBackendNodeId = yield (() => __async(null, null, function* () {
+          try {
+            const { backendNodeId } = yield parentSess.send("DOM.getFrameOwner", { frameId: child });
+            return backendNodeId;
+          } catch (e2) {
+            return void 0;
+          }
+        }))();
+        if (!ownerBackendNodeId) {
+          absPrefix.set(child, parentAbs);
+          continue;
+        }
+        const parentDom = perFrameMaps.get(parent);
+        const iframeEnc = `${page.getOrdinal(parent)}-${ownerBackendNodeId}`;
+        const iframeXPath = parentDom == null ? void 0 : parentDom.xpathMap[iframeEnc];
+        const childAbs = iframeXPath ? prefixXPath(parentAbs || "/", iframeXPath) : parentAbs;
+        absPrefix.set(child, childAbs);
+        iframeHostEncByChild.set(child, iframeEnc);
+      }
+    }
+    return { absPrefix, iframeHostEncByChild };
+  });
+}
+function mergeFramesIntoSnapshot(context, perFrameMaps, perFrameOutlines, absPrefix, iframeHostEncByChild) {
+  var _a4, _b, _c, _d2, _e;
+  const combinedXpathMap = {};
+  const combinedUrlMap = {};
+  for (const frameId of context.frames) {
+    const maps = perFrameMaps.get(frameId);
+    if (!maps) continue;
+    const abs = (_a4 = absPrefix.get(frameId)) != null ? _a4 : "";
+    const isRoot = abs === "" || abs === "/";
+    if (isRoot) {
+      Object.assign(combinedXpathMap, maps.xpathMap);
+      Object.assign(combinedUrlMap, maps.urlMap);
+      continue;
+    }
+    for (const [encId, xp] of Object.entries(maps.xpathMap)) {
+      combinedXpathMap[encId] = prefixXPath(abs, xp);
+    }
+    Object.assign(combinedUrlMap, maps.urlMap);
+  }
+  const idToTree = /* @__PURE__ */ new Map();
+  for (const { frameId, outline } of perFrameOutlines) {
+    const parentEnc = iframeHostEncByChild.get(frameId);
+    if (parentEnc) idToTree.set(parentEnc, outline);
+  }
+  const rootOutline = (_e = (_d2 = (_b = perFrameOutlines.find((o) => o.frameId === context.rootId)) == null ? void 0 : _b.outline) != null ? _d2 : (_c = perFrameOutlines[0]) == null ? void 0 : _c.outline) != null ? _e : "";
+  const combinedTree = injectSubtrees(rootOutline, idToTree);
+  return {
+    combinedTree,
+    combinedXpathMap,
+    combinedUrlMap,
+    perFrame: perFrameOutlines.map(({ frameId, outline }) => {
+      var _a5, _b2;
+      const maps = perFrameMaps.get(frameId);
+      return {
+        frameId,
+        outline,
+        xpathMap: (_a5 = maps == null ? void 0 : maps.xpathMap) != null ? _a5 : {},
+        urlMap: (_b2 = maps == null ? void 0 : maps.urlMap) != null ? _b2 : {}
+      };
+    })
+  };
+}
+var init_capture = __esm({
+  "lib/v3/understudy/a11y/snapshot/capture.ts"() {
+    init_logger();
+    init_a11yTree();
+    init_focusSelectors();
+    init_domTree();
+    init_treeFormatUtils();
+    init_sessions();
+    init_xpathUtils();
+  }
+});
+
+// lib/v3/understudy/a11yInvocation.ts
+function buildA11yInvocation(name, args) {
+  const invocation = `${a11yScriptGlobalRefs[name]}(${args.join(", ")})`;
+  return `(() => { ${a11yScriptBootstrap}; return ${invocation}; })()`;
+}
+var init_a11yInvocation = __esm({
+  "lib/v3/understudy/a11yInvocation.ts"() {
+    init_a11yScripts_generated();
+  }
+});
+
+// lib/v3/understudy/a11y/snapshot/activeElement.ts
+function computeActiveElementXpath(page) {
+  return __async(this, null, function* () {
+    var _a4;
+    const tree = page.getFullFrameTree();
+    const parentByFrame = /* @__PURE__ */ new Map();
+    (function index(n, parent) {
+      var _a5;
+      parentByFrame.set(n.frame.id, parent);
+      for (const c of (_a5 = n.childFrames) != null ? _a5 : []) index(c, n.frame.id);
+    })(tree, null);
+    const frames = page.listAllFrameIds();
+    let focusedFrameId = null;
+    for (const fid of frames) {
+      const sess = page.getSessionForFrame(fid);
+      try {
+        yield sess.send("Runtime.enable").catch(() => {
+        });
+        const ctxId = yield executionContexts.waitForMainWorld(sess, fid, 1e3).catch(() => {
+        });
+        const hasFocusExpr = buildA11yInvocation("documentHasFocusStrict", []);
+        const evalParams = ctxId ? {
+          contextId: ctxId,
+          expression: hasFocusExpr,
+          returnByValue: true
+        } : { expression: hasFocusExpr, returnByValue: true };
+        const { result } = yield sess.send(
+          "Runtime.evaluate",
+          evalParams
+        );
+        if ((result == null ? void 0 : result.value) === true) {
+          focusedFrameId = fid;
+          break;
+        }
+      } catch (e2) {
+      }
+    }
+    if (!focusedFrameId) focusedFrameId = page.mainFrameId();
+    const focusedSession = page.getSessionForFrame(focusedFrameId);
+    let objectId;
+    try {
+      yield focusedSession.send("Runtime.enable").catch(() => {
+      });
+      const ctxId = yield executionContexts.waitForMainWorld(focusedSession, focusedFrameId, 1e3).catch(() => {
+      });
+      const activeExpr = buildA11yInvocation("resolveDeepActiveElement", []);
+      const evalParams = ctxId ? {
+        contextId: ctxId,
+        expression: activeExpr,
+        returnByValue: false
+      } : { expression: activeExpr, returnByValue: false };
+      const { result } = yield focusedSession.send(
+        "Runtime.evaluate",
+        evalParams
+      );
+      objectId = result == null ? void 0 : result.objectId;
+    } catch (e2) {
+      objectId = void 0;
+    }
+    if (!objectId) return null;
+    const leafXPath = yield (() => __async(null, null, function* () {
+      try {
+        const { result } = yield focusedSession.send("Runtime.callFunctionOn", {
+          objectId,
+          functionDeclaration: a11yScriptSources.nodeToAbsoluteXPath,
+          returnByValue: true
+        });
+        try {
+          yield focusedSession.send("Runtime.releaseObject", { objectId });
+        } catch (e2) {
+        }
+        const xp = (result == null ? void 0 : result.value) || "";
+        return typeof xp === "string" && xp ? xp : null;
+      } catch (e2) {
+        try {
+          yield focusedSession.send("Runtime.releaseObject", { objectId });
+        } catch (e3) {
+        }
+        return null;
+      }
+    }))();
+    if (!leafXPath) return null;
+    let prefix = "";
+    let cur = focusedFrameId;
+    while (cur) {
+      const parent = (_a4 = parentByFrame.get(cur)) != null ? _a4 : null;
+      if (!parent) break;
+      const parentSess = page.getSessionForFrame(parent);
+      try {
+        const { backendNodeId } = yield parentSess.send("DOM.getFrameOwner", { frameId: cur });
+        if (typeof backendNodeId === "number") {
+          const xp = yield absoluteXPathForBackendNode(parentSess, backendNodeId);
+          if (xp) prefix = prefix ? prefixXPath(prefix, xp) : normalizeXPath(xp);
+        }
+      } catch (e2) {
+      }
+      cur = parent;
+    }
+    return prefix ? prefixXPath(prefix, leafXPath) : normalizeXPath(leafXPath);
+  });
+}
+var init_activeElement = __esm({
+  "lib/v3/understudy/a11y/snapshot/activeElement.ts"() {
+    init_executionContextRegistry();
+    init_a11yInvocation();
+    init_a11yScripts_generated();
+    init_xpathUtils();
+  }
+});
+
+// lib/v3/understudy/a11y/snapshot/coordinateResolver.ts
+function resolveXpathForLocation(page, x2, y) {
+  return __async(this, null, function* () {
+    var _a4, _b, _c, _d2, _e, _f, _g, _h;
+    const tree = page.getFullFrameTree();
+    const parentByFrame = /* @__PURE__ */ new Map();
+    (function index(n, parent) {
+      var _a5;
+      parentByFrame.set(n.frame.id, parent);
+      for (const c of (_a5 = n.childFrames) != null ? _a5 : []) index(c, n.frame.id);
+    })(tree, null);
+    const iframeChain = [];
+    let curFrameId = page.mainFrameId();
+    let curSession = page.getSessionForFrame(curFrameId);
+    let curX = x2;
+    let curY = y;
+    for (let depth = 0; depth < 8; depth++) {
+      try {
+        yield curSession.send("DOM.enable").catch(() => {
+        });
+        let sx = 0;
+        let sy = 0;
+        try {
+          yield curSession.send("Runtime.enable").catch(() => {
+          });
+          const ctxId = yield executionContexts.waitForMainWorld(curSession, curFrameId).catch(() => {
+          });
+          const scrollExpr = buildA11yInvocation("getScrollOffsets", []);
+          const evalParams = ctxId ? {
+            contextId: ctxId,
+            expression: scrollExpr,
+            returnByValue: true
+          } : { expression: scrollExpr, returnByValue: true };
+          const { result } = yield curSession.send("Runtime.evaluate", evalParams);
+          sx = Number((_b = (_a4 = result == null ? void 0 : result.value) == null ? void 0 : _a4.sx) != null ? _b : 0);
+          sy = Number((_d2 = (_c = result == null ? void 0 : result.value) == null ? void 0 : _c.sy) != null ? _d2 : 0);
+        } catch (e2) {
+        }
+        const xi = Math.max(0, Math.floor(curX + sx));
+        const yi = Math.max(0, Math.floor(curY + sy));
+        let res;
+        try {
+          res = yield curSession.send("DOM.getNodeForLocation", {
+            x: xi,
+            y: yi,
+            includeUserAgentShadowDOM: false,
+            ignorePointerEventsNone: false
+          });
+        } catch (e2) {
+          return null;
+        }
+        const be = res == null ? void 0 : res.backendNodeId;
+        const reportedFrameId = res == null ? void 0 : res.frameId;
+        if (typeof be === "number" && reportedFrameId && reportedFrameId !== curFrameId) {
+          const abs = yield buildAbsoluteXPathFromChain(
+            iframeChain,
+            curSession,
+            be
+          );
+          return abs ? { frameId: reportedFrameId, backendNodeId: be, absoluteXPath: abs } : null;
+        }
+        if (typeof be !== "number") return null;
+        let matchedChild;
+        for (const fid of listChildrenOf(parentByFrame, curFrameId)) {
+          try {
+            const { backendNodeId } = yield curSession.send("DOM.getFrameOwner", { frameId: fid });
+            if (backendNodeId === be) {
+              matchedChild = fid;
+              break;
+            }
+          } catch (e2) {
+            continue;
+          }
+        }
+        if (!matchedChild) {
+          const abs = yield buildAbsoluteXPathFromChain(
+            iframeChain,
+            curSession,
+            be
+          );
+          return abs ? { frameId: curFrameId, backendNodeId: be, absoluteXPath: abs } : null;
+        }
+        iframeChain.push({
+          parentSession: curSession,
+          iframeBackendNodeId: be
+        });
+        let left = 0;
+        let top = 0;
+        try {
+          const { object } = yield curSession.send("DOM.resolveNode", { backendNodeId: be });
+          const objectId = object == null ? void 0 : object.objectId;
+          if (objectId) {
+            const { result } = yield curSession.send("Runtime.callFunctionOn", {
+              objectId,
+              functionDeclaration: a11yScriptSources.getBoundingRectLite,
+              returnByValue: true
+            });
+            left = Number((_f = (_e = result == null ? void 0 : result.value) == null ? void 0 : _e.left) != null ? _f : 0);
+            top = Number((_h = (_g = result == null ? void 0 : result.value) == null ? void 0 : _g.top) != null ? _h : 0);
+            yield curSession.send("Runtime.releaseObject", { objectId }).catch(() => {
+            });
+          }
+        } catch (e2) {
+        }
+        curX = Math.max(0, curX - left);
+        curY = Math.max(0, curY - top);
+        curFrameId = matchedChild;
+        curSession = page.getSessionForFrame(curFrameId);
+      } catch (e2) {
+        return null;
+      }
+    }
+    return null;
+  });
+}
+var init_coordinateResolver = __esm({
+  "lib/v3/understudy/a11y/snapshot/coordinateResolver.ts"() {
+    init_executionContextRegistry();
+    init_a11yScripts_generated();
+    init_a11yInvocation();
+    init_focusSelectors();
+    init_xpathUtils();
+  }
+});
+
+// lib/v3/understudy/a11y/snapshot/index.ts
+var init_snapshot = __esm({
+  "lib/v3/understudy/a11y/snapshot/index.ts"() {
+    init_capture();
+    init_activeElement();
+    init_treeFormatUtils();
+    init_coordinateResolver();
   }
 });