@browserbasehq/orca 3.2.1-preview.2 → 3.4.0-preview-1

package/dist/cjs/lib/v3/types/public/methods.js.map

@@ -1 +1 @@
-{"version":3,"file":"methods.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/public/methods.ts"],"names":[],"mappings":";;;AAGA,6BAAwB;AA8DX,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAEU,QAAA,cAAc,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC;AAwBH,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,6BAAW,CAAA;IACX,qCAAmB,CAAA;IACnB,qCAAmB,CAAA;IACnB,iCAAe,CAAA;AACjB,CAAC,EALW,cAAc,8BAAd,cAAc,QAKzB","sourcesContent":["import { Page as PatchrightPage } from \"patchright-core\";\nimport { Page as PlaywrightPage } from \"playwright-core\";\nimport { Page as PuppeteerPage } from \"puppeteer-core\";\nimport { z } from \"zod\";\nimport type {\n  InferStagehandSchema,\n  StagehandZodSchema,\n} from \"../../zodCompat.js\";\nimport { Page } from \"../../understudy/page.js\";\nimport { ModelConfiguration } from \"../public/model.js\";\nimport type { Variables } from \"./agent.js\";\n\nexport interface ActOptions {\n  model?: ModelConfiguration;\n  variables?: Variables;\n  timeout?: number;\n  page?: PlaywrightPage | PuppeteerPage | PatchrightPage | Page;\n  /**\n   * Override the instance-level serverCache setting for this request.\n   * When true, enables server-side caching.\n   * When false, disables server-side caching.\n   */\n  serverCache?: boolean;\n}\n\nexport interface ActResult {\n  success: boolean;\n  message: string;\n  actionDescription: string;\n  actions: Action[];\n  cacheStatus?: \"HIT\" | \"MISS\";\n}\n\nexport type ExtractResult<T extends StagehandZodSchema> =\n  InferStagehandSchema<T> & {\n    cacheStatus?: \"HIT\" | \"MISS\";\n  };\n\nexport interface Action {\n  selector: string;\n  description: string;\n  method?: string;\n  arguments?: string[];\n}\n\nexport interface HistoryEntry {\n  method: \"act\" | \"extract\" | \"observe\" | \"navigate\" | \"agent\";\n  parameters: unknown;\n  result: unknown;\n  timestamp: string;\n}\n\nexport interface ExtractOptions {\n  model?: ModelConfiguration;\n  timeout?: number;\n  selector?: string;\n  page?: PlaywrightPage | PuppeteerPage | PatchrightPage | Page;\n  /**\n   * Override the instance-level serverCache setting for this request.\n   * When true, enables server-side caching.\n   * When false, disables server-side caching.\n   */\n  serverCache?: boolean;\n}\n\nexport const defaultExtractSchema = z.object({\n  extraction: z.string(),\n});\n\nexport const pageTextSchema = z.object({\n  pageText: z.string(),\n});\n\nexport interface ObserveOptions {\n  model?: ModelConfiguration;\n  variables?: Variables;\n  timeout?: number;\n  selector?: string;\n  page?: PlaywrightPage | PuppeteerPage | PatchrightPage | Page;\n  /**\n   * Override the instance-level serverCache setting for this request.\n   * When true, enables server-side caching.\n   * When false, disables server-side caching.\n   */\n  serverCache?: boolean;\n}\n\n/**\n * Observe returns an array of candidate actions. The optional `cacheStatus`\n * property is attached when the server responds with a\n * `browserbase-cache-status` header so callers can tell whether the result\n * was served from the server-side cache.\n */\nexport type ObserveResult = Action[] & { cacheStatus?: \"HIT\" | \"MISS\" };\n\nexport enum V3FunctionName {\n  ACT = \"ACT\",\n  EXTRACT = \"EXTRACT\",\n  OBSERVE = \"OBSERVE\",\n  AGENT = \"AGENT\",\n}\n"]}
+{"version":3,"file":"methods.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/public/methods.ts"],"names":[],"mappings":";;;AAGA,6BAAwB;AA+DX,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAEU,QAAA,cAAc,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC;AAyBH,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,6BAAW,CAAA;IACX,qCAAmB,CAAA;IACnB,qCAAmB,CAAA;IACnB,iCAAe,CAAA;AACjB,CAAC,EALW,cAAc,8BAAd,cAAc,QAKzB","sourcesContent":["import { Page as PatchrightPage } from \"patchright-core\";\nimport { Page as PlaywrightPage } from \"playwright-core\";\nimport { Page as PuppeteerPage } from \"puppeteer-core\";\nimport { z } from \"zod\";\nimport type {\n  InferStagehandSchema,\n  StagehandZodSchema,\n} from \"../../zodCompat.js\";\nimport { Page } from \"../../understudy/page.js\";\nimport { ModelConfiguration } from \"../public/model.js\";\nimport type { Variables } from \"./agent.js\";\n\nexport interface ActOptions {\n  model?: ModelConfiguration;\n  variables?: Variables;\n  timeout?: number;\n  page?: PlaywrightPage | PuppeteerPage | PatchrightPage | Page;\n  /**\n   * Override the instance-level serverCache setting for this request.\n   * When true, enables server-side caching.\n   * When false, disables server-side caching.\n   */\n  serverCache?: boolean;\n}\n\nexport interface ActResult {\n  success: boolean;\n  message: string;\n  actionDescription: string;\n  actions: Action[];\n  cacheStatus?: \"HIT\" | \"MISS\";\n}\n\nexport type ExtractResult<T extends StagehandZodSchema> =\n  InferStagehandSchema<T> & {\n    cacheStatus?: \"HIT\" | \"MISS\";\n  };\n\nexport interface Action {\n  selector: string;\n  description: string;\n  method?: string;\n  arguments?: string[];\n}\n\nexport interface HistoryEntry {\n  method: \"act\" | \"extract\" | \"observe\" | \"navigate\" | \"agent\";\n  parameters: unknown;\n  result: unknown;\n  timestamp: string;\n}\n\nexport interface ExtractOptions {\n  model?: ModelConfiguration;\n  timeout?: number;\n  selector?: string;\n  ignoreSelectors?: string[];\n  page?: PlaywrightPage | PuppeteerPage | PatchrightPage | Page;\n  /**\n   * Override the instance-level serverCache setting for this request.\n   * When true, enables server-side caching.\n   * When false, disables server-side caching.\n   */\n  serverCache?: boolean;\n}\n\nexport const defaultExtractSchema = z.object({\n  extraction: z.string(),\n});\n\nexport const pageTextSchema = z.object({\n  pageText: z.string(),\n});\n\nexport interface ObserveOptions {\n  model?: ModelConfiguration;\n  variables?: Variables;\n  timeout?: number;\n  selector?: string;\n  ignoreSelectors?: string[];\n  page?: PlaywrightPage | PuppeteerPage | PatchrightPage | Page;\n  /**\n   * Override the instance-level serverCache setting for this request.\n   * When true, enables server-side caching.\n   * When false, disables server-side caching.\n   */\n  serverCache?: boolean;\n}\n\n/**\n * Observe returns an array of candidate actions. The optional `cacheStatus`\n * property is attached when the server responds with a\n * `browserbase-cache-status` header so callers can tell whether the result\n * was served from the server-side cache.\n */\nexport type ObserveResult = Action[] & { cacheStatus?: \"HIT\" | \"MISS\" };\n\nexport enum V3FunctionName {\n  ACT = \"ACT\",\n  EXTRACT = \"EXTRACT\",\n  OBSERVE = \"OBSERVE\",\n  AGENT = \"AGENT\",\n}\n"]}

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

@@ -30,17 +30,6 @@ async function a11yForFrame(session, frameId, opts) {
             throw e;
         ({ nodes } = await 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 = await (async () => {
         const sel = opts.focusSelector?.trim();
@@ -82,7 +71,22 @@ async function a11yForFrame(session, frameId, opts) {
             return nodes;
         }
     })();
-    const decorated = decorateRoles(nodesForOutline, opts);
+    const filteredNodes = nodesForOutline.filter((node) => {
+        const be = node.backendDOMNodeId;
+        return typeof be !== "number" || !opts.isIgnoredBackendNode?.(be);
+    });
+    const urlMap = {};
+    for (const n of filteredNodes) {
+        const be = n.backendDOMNodeId;
+        if (typeof be !== "number")
+            continue;
+        const url = extractUrlFromAXNode(n);
+        if (!url)
+            continue;
+        const enc = opts.encode(be);
+        urlMap[enc] = url;
+    }
+    const decorated = decorateRoles(filteredNodes, opts);
     const { tree } = await buildHierarchicalTree(decorated, opts);
     const simplified = tree.map((n) => (0, treeFormatUtils_js_1.formatTreeLine)(n)).join("\n");
     return { outline: simplified.trimEnd(), urlMap, scopeApplied };
@@ -111,6 +115,11 @@ function decorateRoles(nodes, opts) {
                 ? `scrollable, ${tagLabel}`
                 : `scrollable${role ? `, ${role}` : ""}`;
         }
+        // File inputs typically get role "button" from Chrome's AX tree;
+        // override so they appear as "input, file" in the outline.
+        if (tag === "input, file") {
+            role = tag;
+        }
         return {
             role,
             name: n.name?.value,

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

@@ -1 +1 @@
-{"version":3,"file":"a11yTree.js","sourceRoot":"","sources":["../../../../../../../lib/v3/understudy/a11y/snapshot/a11yTree.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Protocol } from \"devtools-protocol\";\nimport type { CDPSessionLike } from \"../../cdp.js\";\nimport type {\n  A11yNode,\n  A11yOptions,\n  AccessibilityTreeResult,\n} from \"../../../types/private/snapshot.js\";\nimport {\n  resolveObjectIdForCss,\n  resolveObjectIdForXPath,\n} from \"./focusSelectors.js\";\nimport { formatTreeLine, normaliseSpaces } from \"./treeFormatUtils.js\";\n\n/**\n * Fetch and prune the accessibility tree for a frame, optionally scoping the\n * output to a selector root for faster targeted snapshots.\n */\nexport async function a11yForFrame(\n  session: CDPSessionLike,\n  frameId: string | undefined,\n  opts: A11yOptions,\n): Promise<AccessibilityTreeResult> {\n  await session.send(\"Accessibility.enable\").catch(() => {});\n  await session.send(\"Runtime.enable\").catch(() => {});\n  await session.send(\"DOM.enable\").catch(() => {});\n\n  let nodes: Protocol.Accessibility.AXNode[] = [];\n  try {\n    const params = frameId ? ({ frameId } as Record<string, unknown>) : {};\n    ({ nodes } = await session.send<{\n      nodes: Protocol.Accessibility.AXNode[];\n    }>(\"Accessibility.getFullAXTree\", params));\n  } catch (e) {\n    const msg = String((e as Error)?.message ?? e ?? \"\");\n    const isFrameScopeError =\n      msg.includes(\"Frame with the given\") ||\n      msg.includes(\"does not belong to the target\") ||\n      msg.includes(\"is not found\");\n    if (!isFrameScopeError || !frameId) throw e;\n    ({ nodes } = await session.send<{\n      nodes: Protocol.Accessibility.AXNode[];\n    }>(\"Accessibility.getFullAXTree\"));\n  }\n\n  const urlMap: Record<string, string> = {};\n  for (const n of nodes) {\n    const be = n.backendDOMNodeId;\n    if (typeof be !== \"number\") continue;\n    const url = extractUrlFromAXNode(n);\n    if (!url) continue;\n    const enc = opts.encode(be);\n    urlMap[enc] = url;\n  }\n\n  let scopeApplied = false;\n  const nodesForOutline = await (async () => {\n    const sel = opts.focusSelector?.trim();\n    if (!sel) return nodes;\n    try {\n      const looksLikeXPath = /^xpath=/i.test(sel) || sel.startsWith(\"/\");\n      const objectId = looksLikeXPath\n        ? await resolveObjectIdForXPath(session, sel, frameId)\n        : await resolveObjectIdForCss(session, sel, frameId);\n      if (!objectId) return nodes;\n      const desc = await session.send<{ node?: { backendNodeId?: number } }>(\n        \"DOM.describeNode\",\n        { objectId },\n      );\n      const be = desc.node?.backendNodeId;\n      if (typeof be !== \"number\") return nodes;\n      const target = nodes.find((n) => n.backendDOMNodeId === be);\n      if (!target) return nodes;\n      scopeApplied = true;\n      const keep = new Set<string>([target.nodeId]);\n      const queue: Protocol.Accessibility.AXNode[] = [target];\n      while (queue.length) {\n        const cur = queue.shift()!;\n        for (const id of cur.childIds ?? []) {\n          if (keep.has(id)) continue;\n          keep.add(id);\n          const child = nodes.find((n) => n.nodeId === id);\n          if (child) queue.push(child);\n        }\n      }\n      return nodes\n        .filter((n) => keep.has(n.nodeId))\n        .map((n) =>\n          n.nodeId === target.nodeId ? { ...n, parentId: undefined } : n,\n        );\n    } catch {\n      return nodes;\n    }\n  })();\n\n  const decorated = decorateRoles(nodesForOutline, opts);\n  const { tree } = await buildHierarchicalTree(decorated, opts);\n\n  const simplified = tree.map((n) => formatTreeLine(n)).join(\"\\n\");\n  return { outline: simplified.trimEnd(), urlMap, scopeApplied };\n}\n\nexport function decorateRoles(\n  nodes: Protocol.Accessibility.AXNode[],\n  opts: A11yOptions,\n): A11yNode[] {\n  const asRole = (n: Protocol.Accessibility.AXNode) =>\n    String(n.role?.value ?? \"\");\n\n  return nodes.map((n) => {\n    let encodedId: string | undefined;\n    if (typeof n.backendDOMNodeId === \"number\") {\n      try {\n        encodedId = opts.encode(n.backendDOMNodeId);\n      } catch {\n        //\n      }\n    }\n\n    let role = asRole(n);\n\n    const domIsScrollable = encodedId\n      ? opts.scrollableMap[encodedId] === true\n      : false;\n    const tag = encodedId ? opts.tagNameMap[encodedId] : undefined;\n    const isHtmlElement = tag === \"html\";\n    if ((domIsScrollable || isHtmlElement) && tag !== \"#document\") {\n      const tagLabel = tag && tag.startsWith(\"#\") ? tag.slice(1) : tag;\n      role = tagLabel\n        ? `scrollable, ${tagLabel}`\n        : `scrollable${role ? `, ${role}` : \"\"}`;\n    }\n\n    return {\n      role,\n      name: n.name?.value,\n      description: n.description?.value,\n      value: n.value?.value,\n      nodeId: n.nodeId,\n      backendDOMNodeId: n.backendDOMNodeId,\n      parentId: n.parentId,\n      childIds: n.childIds,\n      encodedId,\n    };\n  });\n}\n\nexport async function buildHierarchicalTree(\n  nodes: A11yNode[],\n  opts: A11yOptions,\n): Promise<{ tree: A11yNode[] }> {\n  const nodeMap = new Map<string, A11yNode>();\n\n  for (const n of nodes) {\n    const keep =\n      !!(n.name && n.name.trim()) ||\n      !!(n.childIds && n.childIds.length) ||\n      !isStructural(n.role);\n    if (!keep) continue;\n    nodeMap.set(n.nodeId, { ...n });\n  }\n\n  for (const n of nodes) {\n    if (!n.parentId) continue;\n    const parent = nodeMap.get(n.parentId);\n    const cur = nodeMap.get(n.nodeId);\n    if (parent && cur) (parent.children ??= []).push(cur);\n  }\n\n  const roots = nodes\n    .filter((n) => !n.parentId && nodeMap.has(n.nodeId))\n    .map((n) => nodeMap.get(n.nodeId)!) as A11yNode[];\n\n  const cleaned = (await Promise.all(roots.map(pruneStructuralSafe))).filter(\n    Boolean,\n  ) as A11yNode[];\n\n  return { tree: cleaned };\n\n  async function pruneStructuralSafe(node: A11yNode): Promise<A11yNode | null> {\n    if (+node.nodeId < 0) return null;\n\n    const children = node.children ?? [];\n    if (!children.length) {\n      return isStructural(node.role) ? null : node;\n    }\n\n    const cleanedKids = (\n      await Promise.all(children.map(pruneStructuralSafe))\n    ).filter(Boolean) as A11yNode[];\n\n    const prunedStatic = removeRedundantStaticTextChildren(node, cleanedKids);\n\n    if (isStructural(node.role)) {\n      if (prunedStatic.length === 1) return prunedStatic[0]!;\n      if (prunedStatic.length === 0) return null;\n    }\n\n    let newRole = node.role;\n    if ((newRole === \"generic\" || newRole === \"none\") && node.encodedId) {\n      const tagName = opts.tagNameMap[node.encodedId];\n      if (tagName) newRole = tagName;\n    }\n\n    if (newRole === \"combobox\" && node.encodedId) {\n      const tagName = opts.tagNameMap[node.encodedId];\n      if (tagName === \"select\") newRole = \"select\";\n    }\n\n    return { ...node, role: newRole, children: prunedStatic };\n  }\n}\n\nexport function isStructural(role: string): boolean {\n  const r = role?.toLowerCase();\n  return r === \"generic\" || r === \"none\" || r === \"inlinetextbox\";\n}\n\nexport function extractUrlFromAXNode(\n  ax: Protocol.Accessibility.AXNode,\n): string | undefined {\n  const props = ax.properties ?? [];\n  const urlProp = props.find((p) => p.name === \"url\");\n  const value = urlProp?.value?.value;\n  return typeof value === \"string\" && value.trim() ? value.trim() : undefined;\n}\n\nexport function removeRedundantStaticTextChildren(\n  parent: A11yNode,\n  children: A11yNode[],\n): A11yNode[] {\n  if (!parent.name) return children;\n  const parentNorm = normaliseSpaces(parent.name).trim();\n  let combined = \"\";\n  for (const c of children) {\n    if (c.role === \"StaticText\" && c.name) {\n      combined += normaliseSpaces(c.name).trim();\n    }\n  }\n  if (combined === parentNorm) {\n    return children.filter((c) => c.role !== \"StaticText\");\n  }\n  return children;\n}\n"]}
+{"version":3,"file":"a11yTree.js","sourceRoot":"","sources":["../../../../../../../lib/v3/understudy/a11y/snapshot/a11yTree.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Protocol } from \"devtools-protocol\";\nimport type { CDPSessionLike } from \"../../cdp.js\";\nimport type {\n  A11yNode,\n  A11yOptions,\n  AccessibilityTreeResult,\n} from \"../../../types/private/snapshot.js\";\nimport {\n  resolveObjectIdForCss,\n  resolveObjectIdForXPath,\n} from \"./focusSelectors.js\";\nimport { formatTreeLine, normaliseSpaces } from \"./treeFormatUtils.js\";\n\n/**\n * Fetch and prune the accessibility tree for a frame, optionally scoping the\n * output to a selector root for faster targeted snapshots.\n */\nexport async function a11yForFrame(\n  session: CDPSessionLike,\n  frameId: string | undefined,\n  opts: A11yOptions,\n): Promise<AccessibilityTreeResult> {\n  await session.send(\"Accessibility.enable\").catch(() => {});\n  await session.send(\"Runtime.enable\").catch(() => {});\n  await session.send(\"DOM.enable\").catch(() => {});\n\n  let nodes: Protocol.Accessibility.AXNode[] = [];\n  try {\n    const params = frameId ? ({ frameId } as Record<string, unknown>) : {};\n    ({ nodes } = await session.send<{\n      nodes: Protocol.Accessibility.AXNode[];\n    }>(\"Accessibility.getFullAXTree\", params));\n  } catch (e) {\n    const msg = String((e as Error)?.message ?? e ?? \"\");\n    const isFrameScopeError =\n      msg.includes(\"Frame with the given\") ||\n      msg.includes(\"does not belong to the target\") ||\n      msg.includes(\"is not found\");\n    if (!isFrameScopeError || !frameId) throw e;\n    ({ nodes } = await session.send<{\n      nodes: Protocol.Accessibility.AXNode[];\n    }>(\"Accessibility.getFullAXTree\"));\n  }\n\n  let scopeApplied = false;\n  const nodesForOutline = await (async () => {\n    const sel = opts.focusSelector?.trim();\n    if (!sel) return nodes;\n    try {\n      const looksLikeXPath = /^xpath=/i.test(sel) || sel.startsWith(\"/\");\n      const objectId = looksLikeXPath\n        ? await resolveObjectIdForXPath(session, sel, frameId)\n        : await resolveObjectIdForCss(session, sel, frameId);\n      if (!objectId) return nodes;\n      const desc = await session.send<{ node?: { backendNodeId?: number } }>(\n        \"DOM.describeNode\",\n        { objectId },\n      );\n      const be = desc.node?.backendNodeId;\n      if (typeof be !== \"number\") return nodes;\n      const target = nodes.find((n) => n.backendDOMNodeId === be);\n      if (!target) return nodes;\n      scopeApplied = true;\n      const keep = new Set<string>([target.nodeId]);\n      const queue: Protocol.Accessibility.AXNode[] = [target];\n      while (queue.length) {\n        const cur = queue.shift()!;\n        for (const id of cur.childIds ?? []) {\n          if (keep.has(id)) continue;\n          keep.add(id);\n          const child = nodes.find((n) => n.nodeId === id);\n          if (child) queue.push(child);\n        }\n      }\n      return nodes\n        .filter((n) => keep.has(n.nodeId))\n        .map((n) =>\n          n.nodeId === target.nodeId ? { ...n, parentId: undefined } : n,\n        );\n    } catch {\n      return nodes;\n    }\n  })();\n\n  const filteredNodes = nodesForOutline.filter((node) => {\n    const be = node.backendDOMNodeId;\n    return typeof be !== \"number\" || !opts.isIgnoredBackendNode?.(be);\n  });\n\n  const urlMap: Record<string, string> = {};\n  for (const n of filteredNodes) {\n    const be = n.backendDOMNodeId;\n    if (typeof be !== \"number\") continue;\n    const url = extractUrlFromAXNode(n);\n    if (!url) continue;\n    const enc = opts.encode(be);\n    urlMap[enc] = url;\n  }\n\n  const decorated = decorateRoles(filteredNodes, opts);\n  const { tree } = await buildHierarchicalTree(decorated, opts);\n\n  const simplified = tree.map((n) => formatTreeLine(n)).join(\"\\n\");\n  return { outline: simplified.trimEnd(), urlMap, scopeApplied };\n}\n\nexport function decorateRoles(\n  nodes: Protocol.Accessibility.AXNode[],\n  opts: A11yOptions,\n): A11yNode[] {\n  const asRole = (n: Protocol.Accessibility.AXNode) =>\n    String(n.role?.value ?? \"\");\n\n  return nodes.map((n) => {\n    let encodedId: string | undefined;\n    if (typeof n.backendDOMNodeId === \"number\") {\n      try {\n        encodedId = opts.encode(n.backendDOMNodeId);\n      } catch {\n        //\n      }\n    }\n\n    let role = asRole(n);\n\n    const domIsScrollable = encodedId\n      ? opts.scrollableMap[encodedId] === true\n      : false;\n    const tag = encodedId ? opts.tagNameMap[encodedId] : undefined;\n    const isHtmlElement = tag === \"html\";\n    if ((domIsScrollable || isHtmlElement) && tag !== \"#document\") {\n      const tagLabel = tag && tag.startsWith(\"#\") ? tag.slice(1) : tag;\n      role = tagLabel\n        ? `scrollable, ${tagLabel}`\n        : `scrollable${role ? `, ${role}` : \"\"}`;\n    }\n\n    // File inputs typically get role \"button\" from Chrome's AX tree;\n    // override so they appear as \"input, file\" in the outline.\n    if (tag === \"input, file\") {\n      role = tag;\n    }\n\n    return {\n      role,\n      name: n.name?.value,\n      description: n.description?.value,\n      value: n.value?.value,\n      nodeId: n.nodeId,\n      backendDOMNodeId: n.backendDOMNodeId,\n      parentId: n.parentId,\n      childIds: n.childIds,\n      encodedId,\n    };\n  });\n}\n\nexport async function buildHierarchicalTree(\n  nodes: A11yNode[],\n  opts: A11yOptions,\n): Promise<{ tree: A11yNode[] }> {\n  const nodeMap = new Map<string, A11yNode>();\n\n  for (const n of nodes) {\n    const keep =\n      !!(n.name && n.name.trim()) ||\n      !!(n.childIds && n.childIds.length) ||\n      !isStructural(n.role);\n    if (!keep) continue;\n    nodeMap.set(n.nodeId, { ...n });\n  }\n\n  for (const n of nodes) {\n    if (!n.parentId) continue;\n    const parent = nodeMap.get(n.parentId);\n    const cur = nodeMap.get(n.nodeId);\n    if (parent && cur) (parent.children ??= []).push(cur);\n  }\n\n  const roots = nodes\n    .filter((n) => !n.parentId && nodeMap.has(n.nodeId))\n    .map((n) => nodeMap.get(n.nodeId)!) as A11yNode[];\n\n  const cleaned = (await Promise.all(roots.map(pruneStructuralSafe))).filter(\n    Boolean,\n  ) as A11yNode[];\n\n  return { tree: cleaned };\n\n  async function pruneStructuralSafe(node: A11yNode): Promise<A11yNode | null> {\n    if (+node.nodeId < 0) return null;\n\n    const children = node.children ?? [];\n    if (!children.length) {\n      return isStructural(node.role) ? null : node;\n    }\n\n    const cleanedKids = (\n      await Promise.all(children.map(pruneStructuralSafe))\n    ).filter(Boolean) as A11yNode[];\n\n    const prunedStatic = removeRedundantStaticTextChildren(node, cleanedKids);\n\n    if (isStructural(node.role)) {\n      if (prunedStatic.length === 1) return prunedStatic[0]!;\n      if (prunedStatic.length === 0) return null;\n    }\n\n    let newRole = node.role;\n    if ((newRole === \"generic\" || newRole === \"none\") && node.encodedId) {\n      const tagName = opts.tagNameMap[node.encodedId];\n      if (tagName) newRole = tagName;\n    }\n\n    if (newRole === \"combobox\" && node.encodedId) {\n      const tagName = opts.tagNameMap[node.encodedId];\n      if (tagName === \"select\") newRole = \"select\";\n    }\n\n    return { ...node, role: newRole, children: prunedStatic };\n  }\n}\n\nexport function isStructural(role: string): boolean {\n  const r = role?.toLowerCase();\n  return r === \"generic\" || r === \"none\" || r === \"inlinetextbox\";\n}\n\nexport function extractUrlFromAXNode(\n  ax: Protocol.Accessibility.AXNode,\n): string | undefined {\n  const props = ax.properties ?? [];\n  const urlProp = props.find((p) => p.name === \"url\");\n  const value = urlProp?.value?.value;\n  return typeof value === \"string\" && value.trim() ? value.trim() : undefined;\n}\n\nexport function removeRedundantStaticTextChildren(\n  parent: A11yNode,\n  children: A11yNode[],\n): A11yNode[] {\n  if (!parent.name) return children;\n  const parentNorm = normaliseSpaces(parent.name).trim();\n  let combined = \"\";\n  for (const c of children) {\n    if (c.role === \"StaticText\" && c.name) {\n      combined += normaliseSpaces(c.name).trim();\n    }\n  }\n  if (combined === parentNorm) {\n    return children.filter((c) => c.role !== \"StaticText\");\n  }\n  return children;\n}\n"]}

package/dist/cjs/lib/v3/understudy/a11y/snapshot/capture.d.ts

@@ -1,5 +1,11 @@
 import { Page } from "../../page.js";
 import type { FrameContext, FrameDomMaps, HybridSnapshot, SnapshotOptions, SessionDomIndex } from "../../../types/private/index.js";
+type IgnoredNodeMap = Map<string, Set<number>>;
+type Interval = {
+    start: number;
+    end: number;
+};
+type ExclusionIntervalsByFrame = Map<string, Interval[]>;
 /**
  * Capture a hybrid DOM + Accessibility snapshot for the provided page.
  *
@@ -34,7 +40,7 @@ export declare function buildFrameContext(page: Page): FrameContext;
  * Returns `null` when scoping fails (e.g., selector miss) so the caller can
  * fall back to the full multi-frame snapshot.
  */
-export declare function tryScopedSnapshot(page: Page, options: SnapshotOptions | undefined, context: FrameContext, pierce: boolean): Promise<HybridSnapshot | null>;
+export declare function tryScopedSnapshot(page: Page, options: SnapshotOptions | undefined, context: FrameContext, pierce: boolean, sessionToIndex: Map<string, SessionDomIndex>, exclusionIntervalsByFrame: ExclusionIntervalsByFrame): Promise<HybridSnapshot | null>;
 /**
  * Step 2 – call DOM.getDocument once per unique CDP session and hydrate the
  * result so per-frame slices can share the structure. We key by session id
@@ -49,13 +55,15 @@ export declare function buildSessionIndexes(page: Page, frames: string[], pierce
  *  - collects tag/xpath/scrollability maps for DOM-based lookups
  *  - fetches its AX tree to produce outlines and URL maps
  */
-export declare function collectPerFrameMaps(page: Page, context: FrameContext, sessionToIndex: Map<string, SessionDomIndex>, options: SnapshotOptions | undefined, pierce: boolean, frameIds: string[]): Promise<{
+export declare function collectPerFrameMaps(page: Page, context: FrameContext, sessionToIndex: Map<string, SessionDomIndex>, options: SnapshotOptions | undefined, pierce: boolean, frameIds: string[], exclusionIntervalsByFrame: ExclusionIntervalsByFrame): Promise<{
     perFrameMaps: Map<string, FrameDomMaps>;
     perFrameOutlines: Array<{
         frameId: string;
         outline: string;
     }>;
 }>;
+export declare function resolveIgnoredNodes(page: Page, ignoreSelectors: string[] | undefined, context: FrameContext, sessionToIndex: Map<string, SessionDomIndex>): Promise<IgnoredNodeMap>;
+export declare function buildFrameExclusionIntervals(page: Page, context: FrameContext, sessionToIndex: Map<string, SessionDomIndex>, ignoredNodesByFrame: IgnoredNodeMap): Promise<ExclusionIntervalsByFrame>;
 /**
  * Step 4 – walk the frame tree (parent-first) to compute absolute prefixes for
  * every frame. The prefix is the absolute XPath of the iframe element hosting
@@ -75,3 +83,4 @@ export declare function mergeFramesIntoSnapshot(context: FrameContext, perFrameM
     frameId: string;
     outline: string;
 }>, absPrefix: Map<string, string>, iframeHostEncByChild: Map<string, string>, frameIds: string[]): HybridSnapshot;
+export {};

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

@@ -5,8 +5,12 @@ exports.buildFrameContext = buildFrameContext;
 exports.tryScopedSnapshot = tryScopedSnapshot;
 exports.buildSessionIndexes = buildSessionIndexes;
 exports.collectPerFrameMaps = collectPerFrameMaps;
+exports.resolveIgnoredNodes = resolveIgnoredNodes;
+exports.buildFrameExclusionIntervals = buildFrameExclusionIntervals;
 exports.computeFramePrefixes = computeFramePrefixes;
 exports.mergeFramesIntoSnapshot = mergeFramesIntoSnapshot;
+const frame_js_1 = require("../../frame.js");
+const selectorResolver_js_1 = require("../../selectorResolver.js");
 const logger_js_1 = require("../../../logger.js");
 const a11yTree_js_1 = require("./a11yTree.js");
 const focusSelectors_js_1 = require("./focusSelectors.js");
@@ -35,16 +39,26 @@ const xpathUtils_js_1 = require("./xpathUtils.js");
 async function captureHybridSnapshot(page, options) {
     const pierce = options?.pierceShadow ?? true;
     const includeIframes = options?.includeIframes !== false;
+    const hasIgnoreSelectors = (options?.ignoreSelectors?.length ?? 0) > 0;
     const context = buildFrameContext(page);
-    const scopedSnapshot = await tryScopedSnapshot(page, options, context, pierce);
-    if (scopedSnapshot)
-        return scopedSnapshot;
     const framesInScope = includeIframes ? [...context.frames] : [context.rootId];
     if (!framesInScope.includes(context.rootId)) {
         framesInScope.unshift(context.rootId);
     }
+    if (!hasIgnoreSelectors) {
+        const scopedSnapshot = await tryScopedSnapshot(page, options, context, pierce, new Map(), new Map());
+        if (scopedSnapshot)
+            return scopedSnapshot;
+    }
     const sessionToIndex = await buildSessionIndexes(page, framesInScope, pierce);
-    const { perFrameMaps, perFrameOutlines } = await collectPerFrameMaps(page, context, sessionToIndex, options, pierce, framesInScope);
+    const ignoredNodesByFrame = await resolveIgnoredNodes(page, options?.ignoreSelectors, context, sessionToIndex);
+    const exclusionIntervalsByFrame = await buildFrameExclusionIntervals(page, context, sessionToIndex, ignoredNodesByFrame);
+    if (hasIgnoreSelectors) {
+        const scopedSnapshot = await tryScopedSnapshot(page, options, context, pierce, sessionToIndex, exclusionIntervalsByFrame);
+        if (scopedSnapshot)
+            return scopedSnapshot;
+    }
+    const { perFrameMaps, perFrameOutlines } = await collectPerFrameMaps(page, context, sessionToIndex, options, pierce, framesInScope, exclusionIntervalsByFrame);
     const { absPrefix, iframeHostEncByChild } = await computeFramePrefixes(page, context, perFrameMaps, framesInScope);
     return mergeFramesIntoSnapshot(context, perFrameMaps, perFrameOutlines, absPrefix, iframeHostEncByChild, framesInScope);
 }
@@ -74,7 +88,7 @@ function buildFrameContext(page) {
  * Returns `null` when scoping fails (e.g., selector miss) so the caller can
  * fall back to the full multi-frame snapshot.
  */
-async function tryScopedSnapshot(page, options, context, pierce) {
+async function tryScopedSnapshot(page, options, context, pierce, sessionToIndex, exclusionIntervalsByFrame) {
     const requestedFocus = options?.focusSelector?.trim();
     if (!requestedFocus)
         return null;
@@ -115,20 +129,34 @@ async function tryScopedSnapshot(page, options, context, pierce) {
         const { tagNameMap, xpathMap, scrollableMap } = await (0, domTree_js_1.domMapsForSession)(owningSess, targetFrameId, pierce, (fid, be) => `${page.getOrdinal(fid)}-${be}`, sameSessionAsParent);
         const { outline, urlMap, scopeApplied } = await (0, a11yTree_js_1.a11yForFrame)(owningSess, targetFrameId, {
             focusSelector: tailSelector || undefined,
+            isIgnoredBackendNode: makeIsIgnoredBackendNode(targetFrameId, ownerSessionIndexForFrame(page, targetFrameId, sessionToIndex), exclusionIntervalsByFrame),
             tagNameMap,
             experimental: options?.experimental ?? false,
             scrollableMap,
             encode: (backendNodeId) => `${page.getOrdinal(targetFrameId)}-${backendNodeId}`,
         });
         const scopedXpathMap = {};
+        const isIgnoredBackendNode = makeIsIgnoredBackendNode(targetFrameId, ownerSessionIndexForFrame(page, targetFrameId, sessionToIndex), exclusionIntervalsByFrame);
         const abs = absPrefix ?? "";
         const isRoot = !abs || abs === "/";
         if (isRoot) {
-            Object.assign(scopedXpathMap, xpathMap);
+            for (const [encId, xp] of Object.entries(xpathMap)) {
+                const backendNodeId = parseEncodedBackendNodeId(encId);
+                if (typeof backendNodeId === "number" &&
+                    isIgnoredBackendNode?.(backendNodeId)) {
+                    continue;
+                }
+                scopedXpathMap[encId] = xp;
+            }
         }
         else {
             // Prefix relative XPaths so the scoped result matches the global encoding.
             for (const [encId, xp] of Object.entries(xpathMap)) {
+                const backendNodeId = parseEncodedBackendNodeId(encId);
+                if (typeof backendNodeId === "number" &&
+                    isIgnoredBackendNode?.(backendNodeId)) {
+                    continue;
+                }
                 scopedXpathMap[encId] = (0, xpathUtils_js_1.prefixXPath)(abs, xp);
             }
         }
@@ -184,7 +212,7 @@ async function buildSessionIndexes(page, frames, pierce) {
  *  - collects tag/xpath/scrollability maps for DOM-based lookups
  *  - fetches its AX tree to produce outlines and URL maps
  */
-async function collectPerFrameMaps(page, context, sessionToIndex, options, pierce, frameIds) {
+async function collectPerFrameMaps(page, context, sessionToIndex, options, pierce, frameIds, exclusionIntervalsByFrame) {
     const perFrameMaps = new Map();
     const perFrameOutlines = [];
     for (const frameId of frameIds) {
@@ -197,29 +225,19 @@ async function collectPerFrameMaps(page, context, sessionToIndex, options, pierc
         }
         const parentId = context.parentByFrame.get(frameId);
         const sameSessionAsParent = !!parentId && (0, sessions_js_1.ownerSession)(page, parentId) === sess;
-        let docRootBe = idx.rootBackend;
-        if (sameSessionAsParent) {
-            try {
-                const { backendNodeId } = await sess.send("DOM.getFrameOwner", { frameId });
-                if (typeof backendNodeId === "number") {
-                    const cdBe = idx.contentDocRootByIframe.get(backendNodeId);
-                    if (typeof cdBe === "number")
-                        docRootBe = cdBe;
-                }
-            }
-            catch {
-                //
-            }
-        }
+        const docRootBe = await resolveFrameDocRootBackendId(page, frameId, idx, sameSessionAsParent);
         const tagNameMap = {};
         const xpathMap = {};
         const scrollableMap = {};
+        const isIgnoredBackendNode = makeIsIgnoredBackendNode(frameId, idx, exclusionIntervalsByFrame);
         const enc = (be) => `${page.getOrdinal(frameId)}-${be}`;
         const baseAbs = idx.absByBe.get(docRootBe) ?? "/";
         for (const [be, nodeAbs] of idx.absByBe.entries()) {
             const nodeDocRoot = idx.docRootOf.get(be);
             if (nodeDocRoot !== docRootBe)
                 continue;
+            if (isIgnoredBackendNode?.(be))
+                continue;
             // Translate absolute XPaths into document-relative ones for this frame.
             const rel = (0, domTree_js_1.relativizeXPath)(baseAbs, nodeAbs);
             const key = enc(be);
@@ -231,6 +249,7 @@ async function collectPerFrameMaps(page, context, sessionToIndex, options, pierc
                 scrollableMap[key] = true;
         }
         const { outline, urlMap } = await (0, a11yTree_js_1.a11yForFrame)(sess, frameId, {
+            isIgnoredBackendNode,
             experimental: options?.experimental ?? false,
             tagNameMap,
             scrollableMap,
@@ -241,6 +260,234 @@ async function collectPerFrameMaps(page, context, sessionToIndex, options, pierc
     }
     return { perFrameMaps, perFrameOutlines };
 }
+async function resolveIgnoredNodes(page, ignoreSelectors, context, sessionToIndex) {
+    const ignoredNodesByFrame = new Map();
+    for (const rawSelector of ignoreSelectors ?? []) {
+        const selector = rawSelector.trim();
+        if (!selector)
+            continue;
+        try {
+            const resolved = await resolveIgnoredNodesForSelector(page, selector, context, sessionToIndex);
+            for (const match of resolved) {
+                const nodes = ignoredNodesByFrame.get(match.frameId) ?? new Set();
+                nodes.add(match.backendNodeId);
+                ignoredNodesByFrame.set(match.frameId, nodes);
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return ignoredNodesByFrame;
+}
+async function resolveIgnoredNodesForSelector(page, selector, context, sessionToIndex) {
+    const looksLikeXPath = /^xpath=/i.test(selector) || selector.startsWith("/");
+    if (looksLikeXPath) {
+        const hit = await (0, focusSelectors_js_1.resolveFocusFrameAndTail)(page, (0, xpathUtils_js_1.normalizeXPath)(selector), context.parentByFrame, context.rootId);
+        const targetFrameId = hit.targetFrameId;
+        const tailXPath = hit.tailXPath || "/";
+        if (tailXPath === "/") {
+            const idx = ownerSessionIndexForFrame(page, targetFrameId, sessionToIndex);
+            if (!idx)
+                return [];
+            const parentId = context.parentByFrame.get(targetFrameId);
+            const sameSessionAsParent = !!parentId &&
+                (0, sessions_js_1.ownerSession)(page, parentId) === (0, sessions_js_1.ownerSession)(page, targetFrameId);
+            const backendNodeId = await resolveFrameDocRootBackendId(page, targetFrameId, idx, sameSessionAsParent);
+            return [{ frameId: targetFrameId, backendNodeId }];
+        }
+        return resolveIgnoredNodesInFrame(page, targetFrameId, {
+            kind: "xpath",
+            value: tailXPath,
+        });
+    }
+    const hit = await (0, focusSelectors_js_1.resolveCssFocusFrameAndTail)(page, selector, context.parentByFrame, context.rootId);
+    const targetFrameId = hit.targetFrameId;
+    return resolveIgnoredNodesInFrame(page, targetFrameId, {
+        kind: "css",
+        value: hit.tailSelector || selector,
+    });
+}
+async function resolveIgnoredNodesInFrame(page, frameId, query) {
+    const session = (0, sessions_js_1.ownerSession)(page, frameId);
+    const frame = new frame_js_1.Frame(session, frameId, "", false);
+    const resolver = new selectorResolver_js_1.FrameSelectorResolver(frame);
+    const resolvedNodes = await resolver.resolveAll(query);
+    if (!resolvedNodes.length)
+        return [];
+    const backendNodeIds = await describeResolvedNodes(session, resolvedNodes);
+    return backendNodeIds.map((backendNodeId) => ({ frameId, backendNodeId }));
+}
+async function describeResolvedNodes(session, resolvedNodes) {
+    const backendNodeIds = new Set();
+    try {
+        for (const resolvedNode of resolvedNodes) {
+            const desc = await session.send("DOM.describeNode", { objectId: resolvedNode.objectId });
+            const backendNodeId = desc.node.backendNodeId;
+            if (typeof backendNodeId === "number") {
+                backendNodeIds.add(backendNodeId);
+            }
+        }
+    }
+    finally {
+        await Promise.all(resolvedNodes.map((resolvedNode) => session
+            .send("Runtime.releaseObject", { objectId: resolvedNode.objectId })
+            .catch(() => { })));
+    }
+    return [...backendNodeIds];
+}
+async function buildFrameExclusionIntervals(page, context, sessionToIndex, ignoredNodesByFrame) {
+    const intervalsByFrame = new Map();
+    if (!ignoredNodesByFrame.size)
+        return intervalsByFrame;
+    const childFramesByParent = await resolveChildFramesByParent(page, context);
+    const excludedFrames = new Set();
+    const pushInterval = (frameId, start, end) => {
+        const intervals = intervalsByFrame.get(frameId) ?? [];
+        intervals.push({ start, end });
+        intervalsByFrame.set(frameId, intervals);
+    };
+    const excludeFrameSubtree = async (frameId) => {
+        if (excludedFrames.has(frameId))
+            return;
+        excludedFrames.add(frameId);
+        const idx = ownerSessionIndexForFrame(page, frameId, sessionToIndex);
+        if (!idx)
+            return;
+        const parentId = context.parentByFrame.get(frameId);
+        const sameSessionAsParent = !!parentId &&
+            (0, sessions_js_1.ownerSession)(page, parentId) === (0, sessions_js_1.ownerSession)(page, frameId);
+        const docRootBe = await resolveFrameDocRootBackendId(page, frameId, idx, sameSessionAsParent);
+        const start = idx.enterByBe.get(docRootBe);
+        const end = idx.exitByBe.get(docRootBe);
+        if (typeof start === "number" && typeof end === "number") {
+            pushInterval(frameId, start, end);
+        }
+        for (const childFrameId of (0, focusSelectors_js_1.listChildrenOf)(context.parentByFrame, frameId)) {
+            await excludeFrameSubtree(childFrameId);
+        }
+    };
+    const excludeIgnoredNode = async (frameId, backendNodeId) => {
+        const idx = ownerSessionIndexForFrame(page, frameId, sessionToIndex);
+        if (!idx)
+            return;
+        const start = idx.enterByBe.get(backendNodeId);
+        const end = idx.exitByBe.get(backendNodeId);
+        if (typeof start !== "number" || typeof end !== "number")
+            return;
+        pushInterval(frameId, start, end);
+        for (const childFrame of childFramesByParent.get(frameId) ?? []) {
+            const hostEnter = idx.enterByBe.get(childFrame.hostBackendNodeId);
+            if (typeof hostEnter !== "number")
+                continue;
+            if (hostEnter < start || hostEnter > end)
+                continue;
+            await excludeFrameSubtree(childFrame.childFrameId);
+        }
+    };
+    for (const [frameId, backendNodeIds] of ignoredNodesByFrame.entries()) {
+        for (const backendNodeId of backendNodeIds) {
+            await excludeIgnoredNode(frameId, backendNodeId);
+        }
+    }
+    for (const [frameId, intervals] of intervalsByFrame.entries()) {
+        intervals.sort((a, b) => a.start - b.start || a.end - b.end);
+        const merged = [];
+        for (const interval of intervals) {
+            const prev = merged[merged.length - 1];
+            if (!prev || interval.start > prev.end) {
+                merged.push({ ...interval });
+                continue;
+            }
+            if (interval.end > prev.end)
+                prev.end = interval.end;
+        }
+        intervalsByFrame.set(frameId, merged);
+    }
+    return intervalsByFrame;
+}
+async function resolveChildFramesByParent(page, context) {
+    const childFramesByParent = new Map();
+    for (const frameId of context.frames) {
+        const parentId = context.parentByFrame.get(frameId);
+        if (!parentId)
+            continue;
+        const session = (0, sessions_js_1.parentSession)(page, context.parentByFrame, frameId);
+        if (!session)
+            continue;
+        try {
+            const { backendNodeId } = await session.send("DOM.getFrameOwner", { frameId });
+            if (typeof backendNodeId !== "number")
+                continue;
+            const childFrames = childFramesByParent.get(parentId) ?? [];
+            childFrames.push({
+                childFrameId: frameId,
+                hostBackendNodeId: backendNodeId,
+            });
+            childFramesByParent.set(parentId, childFrames);
+        }
+        catch {
+            continue;
+        }
+    }
+    return childFramesByParent;
+}
+function makeIsIgnoredBackendNode(frameId, idx, exclusionIntervalsByFrame) {
+    if (!idx)
+        return undefined;
+    const intervals = exclusionIntervalsByFrame.get(frameId);
+    if (!intervals?.length)
+        return undefined;
+    return (backendNodeId) => {
+        const enter = idx.enterByBe.get(backendNodeId);
+        if (typeof enter !== "number")
+            return false;
+        let lo = 0;
+        let hi = intervals.length - 1;
+        while (lo <= hi) {
+            const mid = (lo + hi) >> 1;
+            const interval = intervals[mid];
+            if (enter < interval.start) {
+                hi = mid - 1;
+            }
+            else if (enter > interval.end) {
+                lo = mid + 1;
+            }
+            else {
+                return true;
+            }
+        }
+        return false;
+    };
+}
+function parseEncodedBackendNodeId(encodedId) {
+    const parts = encodedId.split("-");
+    if (parts.length !== 2)
+        return undefined;
+    const backendNodeId = Number(parts[1]);
+    return Number.isFinite(backendNodeId) ? backendNodeId : undefined;
+}
+function ownerSessionIndexForFrame(page, frameId, sessionToIndex) {
+    const session = (0, sessions_js_1.ownerSession)(page, frameId);
+    return sessionToIndex.get(session.id ?? "root");
+}
+async function resolveFrameDocRootBackendId(page, frameId, idx, sameSessionAsParent) {
+    if (!sameSessionAsParent)
+        return idx.rootBackend;
+    const session = (0, sessions_js_1.ownerSession)(page, frameId);
+    try {
+        const { backendNodeId } = await session.send("DOM.getFrameOwner", { frameId });
+        if (typeof backendNodeId === "number") {
+            const docRootBe = idx.contentDocRootByIframe.get(backendNodeId);
+            if (typeof docRootBe === "number")
+                return docRootBe;
+        }
+    }
+    catch {
+        //
+    }
+    return idx.rootBackend;
+}
 /**
  * Step 4 – walk the frame tree (parent-first) to compute absolute prefixes for
  * every frame. The prefix is the absolute XPath of the iframe element hosting