@flrande/bak-extension 0.2.3 → 0.2.4

package/dist/.bak-e2e-build-stamp

@@ -0,0 +1 @@
+2026-03-08T17:10:39.579Z

package/dist/content.global.js

@@ -1,5 +1,35 @@
 "use strict";
 (() => {
+  // src/context-metadata.ts
+  var DOCUMENT_NODE = 9;
+  var DOCUMENT_FRAGMENT_NODE = 11;
+  function isDocumentNode(value) {
+    return Boolean(
+      value && typeof value === "object" && "nodeType" in value && typeof value.nodeType === "number" && value.nodeType === DOCUMENT_NODE
+    );
+  }
+  function isShadowRootNode(value) {
+    return Boolean(
+      value && typeof value === "object" && "nodeType" in value && typeof value.nodeType === "number" && value.nodeType === DOCUMENT_FRAGMENT_NODE && "host" in value
+    );
+  }
+  function ownerDocumentForRoot(root, fallbackDocument) {
+    if (isDocumentNode(root)) {
+      return root;
+    }
+    if (isShadowRootNode(root)) {
+      return root.host.ownerDocument ?? fallbackDocument;
+    }
+    return root.ownerDocument ?? fallbackDocument;
+  }
+  function documentMetadata(root, fallbackDocument) {
+    const ownerDocument = ownerDocumentForRoot(root, fallbackDocument);
+    return {
+      url: ownerDocument.location?.href ?? fallbackDocument.location?.href ?? "",
+      title: ownerDocument.title ?? fallbackDocument.title ?? ""
+    };
+  }
+
   // src/privacy.ts
   var MAX_SAFE_TEXT_LENGTH = 120;
   var MAX_DEBUG_TEXT_LENGTH = 320;
@@ -170,6 +200,18 @@
     }
   }
   function patchConsoleCapture() {
+    const handleConsoleBridgeEvent = (event) => {
+      const detail = event.detail;
+      if (!detail || typeof detail !== "object") {
+        return;
+      }
+      const level = detail.level === "debug" || detail.level === "info" || detail.level === "warn" || detail.level === "error" ? detail.level : "log";
+      const message = typeof detail.message === "string" ? detail.message : "";
+      if (!message) {
+        return;
+      }
+      pushConsole(level, message, detail.source ?? "page");
+    };
     const methods = [
       { method: "log", level: "log" },
       { method: "debug", level: "debug" },
@@ -197,18 +239,8 @@
         original.apply(console, args);
       };
     }
-    window.addEventListener("bak:console", (event) => {
-      const detail = event.detail;
-      if (!detail || typeof detail !== "object") {
-        return;
-      }
-      const level = detail.level === "debug" || detail.level === "info" || detail.level === "warn" || detail.level === "error" ? detail.level : "log";
-      const message = typeof detail.message === "string" ? detail.message : "";
-      if (!message) {
-        return;
-      }
-      pushConsole(level, message, detail.source ?? "page");
-    });
+    document.addEventListener("bak:console", handleConsoleBridgeEvent);
+    window.addEventListener("bak:console", handleConsoleBridgeEvent);
     try {
       const injector = document.createElement("script");
       injector.textContent = `
@@ -217,7 +249,11 @@
   if (g.__bakPageConsolePatched) return;
   g.__bakPageConsolePatched = true;
   const emit = (level, message, source) =>
-    window.dispatchEvent(new CustomEvent('bak:console', { detail: { level, message, source, ts: Date.now() } }));
+    document.dispatchEvent(new CustomEvent('bak:console', {
+      bubbles: true,
+      composed: true,
+      detail: { level, message, source, ts: Date.now() }
+    }));
   const serialize = (value) => {
     if (value instanceof Error) return value.message;
     if (typeof value === 'string') return value;
@@ -262,7 +298,7 @@
     }
   }
   function patchNetworkCapture() {
-    window.addEventListener("bak:network", (event) => {
+    const handleNetworkBridgeEvent = (event) => {
       const detail = event.detail;
       if (!detail || typeof detail !== "object") {
         return;
@@ -279,7 +315,9 @@
         requestBytes: typeof detail.requestBytes === "number" ? detail.requestBytes : void 0,
         responseBytes: typeof detail.responseBytes === "number" ? detail.responseBytes : void 0
       });
-    });
+    };
+    document.addEventListener("bak:network", handleNetworkBridgeEvent);
+    window.addEventListener("bak:network", handleNetworkBridgeEvent);
     try {
       const injector = document.createElement("script");
       injector.textContent = `
@@ -288,7 +326,11 @@
   if (g.__bakPageNetworkPatched) return;
   g.__bakPageNetworkPatched = true;
   let seq = 0;
-  const emit = (entry) => window.dispatchEvent(new CustomEvent('bak:network', { detail: entry }));
+  const emit = (entry) => document.dispatchEvent(new CustomEvent('bak:network', {
+    bubbles: true,
+    composed: true,
+    detail: entry
+  }));
   const nativeFetch = window.fetch.bind(window);
   window.fetch = async (input, init) => {
     const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;
@@ -1081,9 +1123,13 @@
       return failAssessment("E_NOT_FOUND", `${action} target is outside viewport`);
     }
     let shadowHostBridge = false;
-    const rootNode = target.getRootNode();
-    if (rootNode instanceof ShadowRoot) {
-      shadowHostBridge = hit === rootNode.host;
+    let rootNode = target.getRootNode();
+    while (isShadowRootNode(rootNode)) {
+      if (hit === rootNode.host) {
+        shadowHostBridge = true;
+        break;
+      }
+      rootNode = rootNode.host.getRootNode();
     }
     if (hit !== target && !target.contains(hit) && !shadowHostBridge) {
       return failAssessment("E_PERMISSION", `${action} target is obstructed by ${describeNode(hit)}`, {
@@ -1201,31 +1247,32 @@
       metaKey: lowered.includes("meta") || lowered.includes("cmd")
     };
   }
-  function domSummary() {
-    const allElements = Array.from(document.querySelectorAll("*"));
-    const interactiveElements = Array.from(document.querySelectorAll("*")).filter((element) => isInteractive(element));
+  function domSummary(root) {
+    const metadata = documentMetadata(root, document);
+    const allElements = Array.from(root.querySelectorAll("*"));
+    const interactiveElements = Array.from(root.querySelectorAll("*")).filter((element) => isInteractive(element));
     const tags = /* @__PURE__ */ new Map();
     for (const element of allElements) {
       const tag = element.tagName.toLowerCase();
       tags.set(tag, (tags.get(tag) ?? 0) + 1);
     }
     const tagHistogram = [...tags.entries()].sort((a, b) => b[1] - a[1]).slice(0, 20).map(([tag, count]) => ({ tag, count }));
-    const shadowHosts = Array.from(document.querySelectorAll("*")).filter((element) => element.shadowRoot).length;
+    const shadowHosts = Array.from(root.querySelectorAll("*")).filter((element) => element.shadowRoot).length;
     return {
-      url: window.location.href,
-      title: document.title,
+      url: metadata.url,
+      title: metadata.title,
       totalElements: allElements.length,
       interactiveElements: interactiveElements.length,
-      headings: document.querySelectorAll("h1,h2,h3,h4,h5,h6").length,
-      links: document.querySelectorAll("a[href]").length,
-      forms: document.querySelectorAll("form").length,
-      iframes: document.querySelectorAll("iframe,frame").length,
+      headings: root.querySelectorAll("h1,h2,h3,h4,h5,h6").length,
+      links: root.querySelectorAll("a[href]").length,
+      forms: root.querySelectorAll("form").length,
+      iframes: root.querySelectorAll("iframe,frame").length,
       shadowHosts,
       tagHistogram
     };
   }
-  function pageTextChunks(maxChunks = 24, chunkSize = 320) {
-    const nodes = Array.from(document.querySelectorAll("h1,h2,h3,h4,h5,h6,p,li,td,th,label,button,a,span,div"));
+  function pageTextChunks(root, maxChunks = 24, chunkSize = 320) {
+    const nodes = Array.from(root.querySelectorAll("h1,h2,h3,h4,h5,h6,p,li,td,th,label,button,a,span,div"));
     const chunks = [];
     for (const node of nodes) {
       if (!isElementVisible(node)) {
@@ -1246,9 +1293,9 @@
     }
     return chunks;
   }
-  function pageAccessibility(limit = 200) {
+  function pageAccessibility(root, limit = 200) {
     const nodes = [];
-    for (const element of getInteractiveElements(document, true).slice(0, limit)) {
+    for (const element of getInteractiveElements(root, true).slice(0, limit)) {
       nodes.push({
         role: inferRole(element),
         name: inferName(element),
@@ -1531,7 +1578,7 @@
       return Boolean(querySelectorAcrossOpenShadow(root, message.value));
     }
     if (message.mode === "text") {
-      if (root instanceof Document) {
+      if (isDocumentNode(root)) {
         const bodyText = root.body?.innerText ?? root.documentElement?.textContent ?? "";
         return bodyText.includes(message.value);
       }
@@ -1574,7 +1621,7 @@
       const observer = new MutationObserver(() => {
         check();
       });
-      const observationRoot = root instanceof Document ? root.documentElement : root;
+      const observationRoot = isDocumentNode(root) ? root.documentElement : root;
       if (observationRoot) {
         observer.observe(observationRoot, {
           childList: true,
@@ -1593,23 +1640,49 @@
   }
   async function dispatchRpc(method, params = {}) {
     switch (method) {
-      case "page.title":
-        return { title: document.title };
-      case "page.url":
-        return { url: window.location.href };
-      case "page.text":
+      case "page.title": {
+        const rootResult = resolveRootForLocator();
+        if (!rootResult.ok) {
+          throw rootResult.error;
+        }
+        return { title: documentMetadata(rootResult.root, document).title };
+      }
+      case "page.url": {
+        const rootResult = resolveRootForLocator();
+        if (!rootResult.ok) {
+          throw rootResult.error;
+        }
+        return { url: documentMetadata(rootResult.root, document).url };
+      }
+      case "page.text": {
+        const rootResult = resolveRootForLocator();
+        if (!rootResult.ok) {
+          throw rootResult.error;
+        }
         return {
           chunks: pageTextChunks(
+            rootResult.root,
             typeof params.maxChunks === "number" ? params.maxChunks : 24,
             typeof params.chunkSize === "number" ? params.chunkSize : 320
           )
         };
-      case "page.dom":
-        return { summary: domSummary() };
-      case "page.accessibilityTree":
+      }
+      case "page.dom": {
+        const rootResult = resolveRootForLocator();
+        if (!rootResult.ok) {
+          throw rootResult.error;
+        }
+        return { summary: domSummary(rootResult.root) };
+      }
+      case "page.accessibilityTree": {
+        const rootResult = resolveRootForLocator();
+        if (!rootResult.ok) {
+          throw rootResult.error;
+        }
         return {
-          nodes: pageAccessibility(typeof params.limit === "number" ? params.limit : 200)
+          nodes: pageAccessibility(rootResult.root, typeof params.limit === "number" ? params.limit : 200)
         };
+      }
       case "page.scrollTo": {
         const x = typeof params.x === "number" ? params.x : window.scrollX;
         const y = typeof params.y === "number" ? params.y : window.scrollY;
@@ -1928,12 +2001,12 @@
         if (hostSelectors.length === 0) {
           throw { code: "E_INVALID_PARAMS", message: "hostSelectors or locator.css is required" };
         }
-        const rootResult = resolveRootForLocator();
-        if (!rootResult.ok) {
-          throw rootResult.error;
+        const frameResult = resolveFrameDocument(contextState.framePath);
+        if (!frameResult.ok) {
+          throw frameResult.error;
         }
         const candidate = [...contextState.shadowPath, ...hostSelectors];
-        const check = resolveShadowRoot(rootResult.root, candidate);
+        const check = resolveShadowRoot(frameResult.document, candidate);
         if (!check.ok) {
           throw check.error;
         }
@@ -1973,18 +2046,30 @@
         const consoleLimit = typeof params.consoleLimit === "number" ? Math.max(1, Math.floor(params.consoleLimit)) : 80;
         const networkLimit = typeof params.networkLimit === "number" ? Math.max(1, Math.floor(params.networkLimit)) : 80;
         const includeAccessibility = params.includeAccessibility === true;
+        const rootResult = resolveRootForLocator();
+        if (!rootResult.ok) {
+          throw rootResult.error;
+        }
+        const metadata = documentMetadata(rootResult.root, document);
         return {
-          url: window.location.href,
-          title: document.title,
+          url: metadata.url,
+          title: metadata.title,
           context: {
             framePath: [...contextState.framePath],
             shadowPath: [...contextState.shadowPath]
           },
-          dom: domSummary(),
-          text: pageTextChunks(12, 260),
+          dom: domSummary(rootResult.root),
+          text: pageTextChunks(rootResult.root, 12, 260),
+          elements: collectElements(),
+          metrics: pageMetrics(),
+          viewport: {
+            width: window.innerWidth,
+            height: window.innerHeight,
+            devicePixelRatio: window.devicePixelRatio
+          },
           console: consoleEntries.slice(-consoleLimit),
           network: filterNetworkEntries({ limit: networkLimit }),
-          accessibility: includeAccessibility ? pageAccessibility(200) : void 0
+          accessibility: includeAccessibility ? pageAccessibility(rootResult.root, 200) : void 0
         };
       }
       default:

package/package.json

@@ -1,18 +1,20 @@
 {
   "name": "@flrande/bak-extension",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "type": "module",
-  "dependencies": {
-    "@flrande/bak-protocol": "0.2.3"
-  },
-  "devDependencies": {
-    "@types/chrome": "^0.1.14",
-    "tsup": "^8.5.0"
-  },
   "scripts": {
     "build": "tsup src/background.ts src/content.ts src/popup.ts --format iife --out-dir dist --clean && node scripts/copy-assets.mjs",
     "dev": "node scripts/copy-assets.mjs && tsup src/background.ts src/content.ts src/popup.ts --format iife --out-dir dist --watch",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "lint": "eslint src --ext .ts"
+  },
+  "dependencies": {
+    "@flrande/bak-protocol": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/chrome": "^0.1.14",
+    "tsup": "^8.5.0"
   }
-}
+}
+
+

package/src/content.ts

@@ -8,6 +8,7 @@ import type {
   PageMetrics,
   PageTextChunk
 } from '@flrande/bak-protocol';
+import { documentMetadata, isDocumentNode, isShadowRootNode } from './context-metadata.js';
 import { inferSafeName, redactElementText, type RedactTextOptions } from './privacy.js';
 import { unsupportedLocatorHint } from './limitations.js';
 
@@ -130,6 +131,20 @@ function pushConsole(level: ConsoleEntry['level'], message: string, source?: str
 }
 
 function patchConsoleCapture(): void {
+  const handleConsoleBridgeEvent = (event: Event): void => {
+    const detail = (event as CustomEvent<{ level?: ConsoleEntry['level']; message?: string; source?: string; ts?: number }>).detail;
+    if (!detail || typeof detail !== 'object') {
+      return;
+    }
+    const level: ConsoleEntry['level'] =
+      detail.level === 'debug' || detail.level === 'info' || detail.level === 'warn' || detail.level === 'error' ? detail.level : 'log';
+    const message = typeof detail.message === 'string' ? detail.message : '';
+    if (!message) {
+      return;
+    }
+    pushConsole(level, message, detail.source ?? 'page');
+  };
+
   const methods: Array<{ method: 'log' | 'debug' | 'info' | 'warn' | 'error'; level: ConsoleEntry['level'] }> = [
     { method: 'log', level: 'log' },
     { method: 'debug', level: 'debug' },
@@ -161,19 +176,8 @@ function patchConsoleCapture(): void {
     };
   }
 
-  window.addEventListener('bak:console', (event: Event) => {
-    const detail = (event as CustomEvent<{ level?: ConsoleEntry['level']; message?: string; source?: string; ts?: number }>).detail;
-    if (!detail || typeof detail !== 'object') {
-      return;
-    }
-    const level: ConsoleEntry['level'] =
-      detail.level === 'debug' || detail.level === 'info' || detail.level === 'warn' || detail.level === 'error' ? detail.level : 'log';
-    const message = typeof detail.message === 'string' ? detail.message : '';
-    if (!message) {
-      return;
-    }
-    pushConsole(level, message, detail.source ?? 'page');
-  });
+  document.addEventListener('bak:console', handleConsoleBridgeEvent as EventListener);
+  window.addEventListener('bak:console', handleConsoleBridgeEvent as EventListener);
 
   try {
     const injector = document.createElement('script');
@@ -183,7 +187,11 @@ function patchConsoleCapture(): void {
   if (g.__bakPageConsolePatched) return;
   g.__bakPageConsolePatched = true;
   const emit = (level, message, source) =>
-    window.dispatchEvent(new CustomEvent('bak:console', { detail: { level, message, source, ts: Date.now() } }));
+    document.dispatchEvent(new CustomEvent('bak:console', {
+      bubbles: true,
+      composed: true,
+      detail: { level, message, source, ts: Date.now() }
+    }));
   const serialize = (value) => {
     if (value instanceof Error) return value.message;
     if (typeof value === 'string') return value;
@@ -233,7 +241,7 @@ function pushNetwork(entry: NetworkEntry): void {
 }
 
 function patchNetworkCapture(): void {
-  window.addEventListener('bak:network', (event: Event) => {
+  const handleNetworkBridgeEvent = (event: Event): void => {
     const detail = (event as CustomEvent<NetworkEntry>).detail;
     if (!detail || typeof detail !== 'object') {
       return;
@@ -247,10 +255,13 @@ function patchNetworkCapture(): void {
       ok: detail.ok === true,
       ts: typeof detail.ts === 'number' ? detail.ts : Date.now(),
       durationMs: typeof detail.durationMs === 'number' ? detail.durationMs : 0,
-      requestBytes: typeof detail.requestBytes === 'number' ? detail.requestBytes : undefined,
-      responseBytes: typeof detail.responseBytes === 'number' ? detail.responseBytes : undefined
-    });
-  });
+        requestBytes: typeof detail.requestBytes === 'number' ? detail.requestBytes : undefined,
+        responseBytes: typeof detail.responseBytes === 'number' ? detail.responseBytes : undefined
+      });
+  };
+
+  document.addEventListener('bak:network', handleNetworkBridgeEvent as EventListener);
+  window.addEventListener('bak:network', handleNetworkBridgeEvent as EventListener);
 
   try {
     const injector = document.createElement('script');
@@ -260,7 +271,11 @@ function patchNetworkCapture(): void {
   if (g.__bakPageNetworkPatched) return;
   g.__bakPageNetworkPatched = true;
   let seq = 0;
-  const emit = (entry) => window.dispatchEvent(new CustomEvent('bak:network', { detail: entry }));
+  const emit = (entry) => document.dispatchEvent(new CustomEvent('bak:network', {
+    bubbles: true,
+    composed: true,
+    detail: entry
+  }));
   const nativeFetch = window.fetch.bind(window);
   window.fetch = async (input, init) => {
     const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;
@@ -1186,9 +1201,13 @@ function assessActionTarget(target: HTMLElement, action: ActionName): ActionAsse
   }
 
   let shadowHostBridge = false;
-  const rootNode = target.getRootNode();
-  if (rootNode instanceof ShadowRoot) {
-    shadowHostBridge = hit === rootNode.host;
+  let rootNode = target.getRootNode();
+  while (isShadowRootNode(rootNode)) {
+    if (hit === rootNode.host) {
+      shadowHostBridge = true;
+      break;
+    }
+    rootNode = rootNode.host.getRootNode();
   }
 
   if (hit !== target && !target.contains(hit) && !shadowHostBridge) {
@@ -1332,9 +1351,10 @@ function parseHotkey(keys: string[]): {
   };
 }
 
-function domSummary(): PageDomSummary {
-  const allElements = Array.from(document.querySelectorAll('*'));
-  const interactiveElements = Array.from(document.querySelectorAll<HTMLElement>('*')).filter((element) => isInteractive(element));
+function domSummary(root: ParentNode): PageDomSummary {
+  const metadata = documentMetadata(root, document);
+  const allElements = Array.from(root.querySelectorAll('*'));
+  const interactiveElements = Array.from(root.querySelectorAll<HTMLElement>('*')).filter((element) => isInteractive(element));
   const tags = new Map<string, number>();
 
   for (const element of allElements) {
@@ -1347,24 +1367,24 @@ function domSummary(): PageDomSummary {
     .slice(0, 20)
     .map(([tag, count]) => ({ tag, count }));
 
-  const shadowHosts = Array.from(document.querySelectorAll<HTMLElement>('*')).filter((element) => element.shadowRoot).length;
+  const shadowHosts = Array.from(root.querySelectorAll<HTMLElement>('*')).filter((element) => element.shadowRoot).length;
 
   return {
-    url: window.location.href,
-    title: document.title,
+    url: metadata.url,
+    title: metadata.title,
     totalElements: allElements.length,
     interactiveElements: interactiveElements.length,
-    headings: document.querySelectorAll('h1,h2,h3,h4,h5,h6').length,
-    links: document.querySelectorAll('a[href]').length,
-    forms: document.querySelectorAll('form').length,
-    iframes: document.querySelectorAll('iframe,frame').length,
+    headings: root.querySelectorAll('h1,h2,h3,h4,h5,h6').length,
+    links: root.querySelectorAll('a[href]').length,
+    forms: root.querySelectorAll('form').length,
+    iframes: root.querySelectorAll('iframe,frame').length,
     shadowHosts,
     tagHistogram
   };
 }
 
-function pageTextChunks(maxChunks = 24, chunkSize = 320): PageTextChunk[] {
-  const nodes = Array.from(document.querySelectorAll<HTMLElement>('h1,h2,h3,h4,h5,h6,p,li,td,th,label,button,a,span,div'));
+function pageTextChunks(root: ParentNode, maxChunks = 24, chunkSize = 320): PageTextChunk[] {
+  const nodes = Array.from(root.querySelectorAll<HTMLElement>('h1,h2,h3,h4,h5,h6,p,li,td,th,label,button,a,span,div'));
   const chunks: PageTextChunk[] = [];
 
   for (const node of nodes) {
@@ -1391,9 +1411,9 @@ function pageTextChunks(maxChunks = 24, chunkSize = 320): PageTextChunk[] {
   return chunks;
 }
 
-function pageAccessibility(limit = 200): AccessibilityNode[] {
+function pageAccessibility(root: ParentNode, limit = 200): AccessibilityNode[] {
   const nodes: AccessibilityNode[] = [];
-  for (const element of getInteractiveElements(document, true).slice(0, limit)) {
+  for (const element of getInteractiveElements(root, true).slice(0, limit)) {
     nodes.push({
       role: inferRole(element),
       name: inferName(element),
@@ -1716,7 +1736,7 @@ function waitConditionMet(message: WaitMessage, root: ParentNode): boolean {
   }
 
   if (message.mode === 'text') {
-    if (root instanceof Document) {
+    if (isDocumentNode(root)) {
       const bodyText = root.body?.innerText ?? root.documentElement?.textContent ?? '';
       return bodyText.includes(message.value);
     }
@@ -1765,7 +1785,7 @@ async function waitFor(message: WaitMessage): Promise<ActionResult> {
     const observer = new MutationObserver(() => {
       check();
     });
-    const observationRoot = root instanceof Document ? root.documentElement : (root as Node);
+    const observationRoot = isDocumentNode(root) ? root.documentElement : (root as Node);
     if (observationRoot) {
       observer.observe(observationRoot, {
         childList: true,
@@ -1787,23 +1807,52 @@ async function waitFor(message: WaitMessage): Promise<ActionResult> {
 
 async function dispatchRpc(method: string, params: Record<string, unknown> = {}): Promise<unknown> {
   switch (method) {
-    case 'page.title':
-      return { title: document.title };
-    case 'page.url':
-      return { url: window.location.href };
+    case 'page.title': {
+      const rootResult = resolveRootForLocator();
+      if (!rootResult.ok) {
+        throw rootResult.error;
+      }
+      return { title: documentMetadata(rootResult.root, document).title };
+    }
+    case 'page.url': {
+      const rootResult = resolveRootForLocator();
+      if (!rootResult.ok) {
+        throw rootResult.error;
+      }
+      return { url: documentMetadata(rootResult.root, document).url };
+    }
     case 'page.text':
+      {
+        const rootResult = resolveRootForLocator();
+        if (!rootResult.ok) {
+          throw rootResult.error;
+        }
       return {
         chunks: pageTextChunks(
+          rootResult.root,
           typeof params.maxChunks === 'number' ? params.maxChunks : 24,
           typeof params.chunkSize === 'number' ? params.chunkSize : 320
         )
       };
+      }
     case 'page.dom':
-      return { summary: domSummary() };
+      {
+        const rootResult = resolveRootForLocator();
+        if (!rootResult.ok) {
+          throw rootResult.error;
+        }
+        return { summary: domSummary(rootResult.root) };
+      }
     case 'page.accessibilityTree':
+      {
+        const rootResult = resolveRootForLocator();
+        if (!rootResult.ok) {
+          throw rootResult.error;
+        }
       return {
-        nodes: pageAccessibility(typeof params.limit === 'number' ? params.limit : 200)
+        nodes: pageAccessibility(rootResult.root, typeof params.limit === 'number' ? params.limit : 200)
       };
+      }
     case 'page.scrollTo': {
       const x = typeof params.x === 'number' ? params.x : window.scrollX;
       const y = typeof params.y === 'number' ? params.y : window.scrollY;
@@ -2135,12 +2184,12 @@ async function dispatchRpc(method: string, params: Record<string, unknown> = {})
       if (hostSelectors.length === 0) {
         throw { code: 'E_INVALID_PARAMS', message: 'hostSelectors or locator.css is required' } satisfies ActionError;
       }
-      const rootResult = resolveRootForLocator();
-      if (!rootResult.ok) {
-        throw rootResult.error;
+      const frameResult = resolveFrameDocument(contextState.framePath);
+      if (!frameResult.ok) {
+        throw frameResult.error;
       }
       const candidate = [...contextState.shadowPath, ...hostSelectors];
-      const check = resolveShadowRoot(rootResult.root, candidate);
+      const check = resolveShadowRoot(frameResult.document, candidate);
       if (!check.ok) {
         throw check.error;
       }
@@ -2182,18 +2231,30 @@ async function dispatchRpc(method: string, params: Record<string, unknown> = {})
       const consoleLimit = typeof params.consoleLimit === 'number' ? Math.max(1, Math.floor(params.consoleLimit)) : 80;
       const networkLimit = typeof params.networkLimit === 'number' ? Math.max(1, Math.floor(params.networkLimit)) : 80;
       const includeAccessibility = params.includeAccessibility === true;
+      const rootResult = resolveRootForLocator();
+      if (!rootResult.ok) {
+        throw rootResult.error;
+      }
+      const metadata = documentMetadata(rootResult.root, document);
       return {
-        url: window.location.href,
-        title: document.title,
+        url: metadata.url,
+        title: metadata.title,
         context: {
           framePath: [...contextState.framePath],
           shadowPath: [...contextState.shadowPath]
         },
-        dom: domSummary(),
-        text: pageTextChunks(12, 260),
+        dom: domSummary(rootResult.root),
+        text: pageTextChunks(rootResult.root, 12, 260),
+        elements: collectElements(),
+        metrics: pageMetrics(),
+        viewport: {
+          width: window.innerWidth,
+          height: window.innerHeight,
+          devicePixelRatio: window.devicePixelRatio
+        },
         console: consoleEntries.slice(-consoleLimit),
         network: filterNetworkEntries({ limit: networkLimit }),
-        accessibility: includeAccessibility ? pageAccessibility(200) : undefined
+        accessibility: includeAccessibility ? pageAccessibility(rootResult.root, 200) : undefined
       };
     }
     default:

package/src/context-metadata.ts

@@ -0,0 +1,56 @@
+export interface DocumentLike {
+  nodeType?: number;
+  title?: string;
+  location?: {
+    href?: string;
+  };
+}
+
+export interface ShadowRootLike {
+  nodeType?: number;
+  host?: {
+    ownerDocument?: DocumentLike | null;
+  };
+}
+
+const DOCUMENT_NODE = 9;
+const DOCUMENT_FRAGMENT_NODE = 11;
+
+export function isDocumentNode(value: unknown): value is Document {
+  return Boolean(
+    value &&
+      typeof value === 'object' &&
+      'nodeType' in value &&
+      typeof (value as { nodeType?: unknown }).nodeType === 'number' &&
+      (value as { nodeType: number }).nodeType === DOCUMENT_NODE
+  );
+}
+
+export function isShadowRootNode(value: unknown): value is ShadowRoot {
+  return Boolean(
+    value &&
+      typeof value === 'object' &&
+      'nodeType' in value &&
+      typeof (value as { nodeType?: unknown }).nodeType === 'number' &&
+      (value as { nodeType: number }).nodeType === DOCUMENT_FRAGMENT_NODE &&
+      'host' in value
+  );
+}
+
+export function ownerDocumentForRoot(root: ParentNode, fallbackDocument: Document): Document {
+  if (isDocumentNode(root)) {
+    return root;
+  }
+  if (isShadowRootNode(root)) {
+    return root.host.ownerDocument ?? fallbackDocument;
+  }
+  return (root as Node).ownerDocument ?? fallbackDocument;
+}
+
+export function documentMetadata(root: ParentNode, fallbackDocument: Document): { url: string; title: string } {
+  const ownerDocument = ownerDocumentForRoot(root, fallbackDocument);
+  return {
+    url: ownerDocument.location?.href ?? fallbackDocument.location?.href ?? '',
+    title: ownerDocument.title ?? fallbackDocument.title ?? ''
+  };
+}