@canaryai/cli 0.2.8 → 0.2.12

package/dist/{chunk-FK3EZADZ.js → chunk-MSMC6UXW.js}

@@ -4383,7 +4383,7 @@ var require_src = __commonJS({
 var require_encoder = __commonJS({
   "../../node_modules/.bun/jpeg-js@0.4.4/node_modules/jpeg-js/lib/encoder.js"(exports2, module2) {
     "use strict";
-    var btoa = btoa || function(buf) {
+    var btoa2 = btoa2 || function(buf) {
       return Buffer.from(buf).toString("base64");
     };
     function JPEGEncoder(quality2) {
@@ -5404,7 +5404,7 @@ var require_encoder = __commonJS({
         writeWord(65497);
         if (typeof module2 === "undefined") return new Uint8Array(byteout);
         return Buffer.from(byteout);
-        var jpegDataUri = "data:image/jpeg;base64," + btoa(byteout.join(""));
+        var jpegDataUri = "data:image/jpeg;base64," + btoa2(byteout.join(""));
         byteout = [];
         var duration = (/* @__PURE__ */ new Date()).getTime() - time_start;
         return jpegDataUri;
@@ -37998,6 +37998,201 @@ var CdpScreencastManager = class {
   }
 };
 
+// ../browser-core/src/indexeddb-helpers.ts
+var MAX_TOTAL_SIZE_BYTES = 10 * 1024 * 1024;
+async function extractIndexedDB(page) {
+  try {
+    const data = await page.evaluate(async () => {
+      if (!indexedDB.databases) return null;
+      const dbInfos = await indexedDB.databases();
+      if (!dbInfos || dbInfos.length === 0) return null;
+      function serializeValue(value) {
+        if (value instanceof ArrayBuffer) {
+          return {
+            __type: "ArrayBuffer",
+            __data: btoa(String.fromCharCode(...new Uint8Array(value)))
+          };
+        }
+        if (ArrayBuffer.isView(value)) {
+          const buf = value.buffer instanceof ArrayBuffer ? value.buffer : value.buffer;
+          return {
+            __type: "TypedArray",
+            __arrayType: value.constructor.name,
+            __data: btoa(String.fromCharCode(...new Uint8Array(buf, value.byteOffset, value.byteLength)))
+          };
+        }
+        if (value instanceof Blob) {
+          return { __type: "Blob", __skipped: true };
+        }
+        if (value instanceof Date) {
+          return { __type: "Date", __data: value.toISOString() };
+        }
+        if (Array.isArray(value)) {
+          return value.map(serializeValue);
+        }
+        if (value !== null && typeof value === "object") {
+          const result = {};
+          for (const [k, v] of Object.entries(value)) {
+            result[k] = serializeValue(v);
+          }
+          return result;
+        }
+        return value;
+      }
+      const databases = [];
+      for (const dbInfo of dbInfos) {
+        if (!dbInfo.name) continue;
+        try {
+          const db = await new Promise((resolve2, reject2) => {
+            const request2 = indexedDB.open(dbInfo.name, dbInfo.version);
+            request2.onsuccess = () => resolve2(request2.result);
+            request2.onerror = () => reject2(request2.error);
+            request2.onupgradeneeded = () => {
+              request2.transaction?.abort();
+              reject2(new Error("version_mismatch"));
+            };
+          });
+          const objectStores = [];
+          for (const storeName of Array.from(db.objectStoreNames)) {
+            try {
+              const tx = db.transaction(storeName, "readonly");
+              const store = tx.objectStore(storeName);
+              const entries = await new Promise(
+                (resolve2, reject2) => {
+                  const items = [];
+                  const cursorReq = store.openCursor();
+                  cursorReq.onsuccess = () => {
+                    const cursor = cursorReq.result;
+                    if (cursor) {
+                      items.push({
+                        key: cursor.key,
+                        value: serializeValue(cursor.value)
+                      });
+                      cursor.continue();
+                    } else {
+                      resolve2(items);
+                    }
+                  };
+                  cursorReq.onerror = () => reject2(cursorReq.error);
+                }
+              );
+              objectStores.push({
+                name: storeName,
+                keyPath: store.keyPath,
+                autoIncrement: store.autoIncrement,
+                entries
+              });
+            } catch {
+            }
+          }
+          db.close();
+          databases.push({
+            name: dbInfo.name,
+            version: dbInfo.version ?? 1,
+            objectStores
+          });
+        } catch {
+        }
+      }
+      return databases.length > 0 ? { databases } : null;
+    });
+    if (!data) return null;
+    const serialized = JSON.stringify(data);
+    if (serialized.length > MAX_TOTAL_SIZE_BYTES) {
+      return null;
+    }
+    return data;
+  } catch {
+    return null;
+  }
+}
+async function restoreIndexedDB(page, data) {
+  if (!data.databases || data.databases.length === 0) return;
+  await page.evaluate(async (databases) => {
+    function deserializeValue(value) {
+      if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+        const obj = value;
+        if (obj.__type === "ArrayBuffer" && typeof obj.__data === "string") {
+          const binary = atob(obj.__data);
+          const bytes = new Uint8Array(binary.length);
+          for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+          return bytes.buffer;
+        }
+        if (obj.__type === "TypedArray" && typeof obj.__data === "string") {
+          const binary = atob(obj.__data);
+          const bytes = new Uint8Array(binary.length);
+          for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+          return bytes.buffer;
+        }
+        if (obj.__type === "Date" && typeof obj.__data === "string") {
+          return new Date(obj.__data);
+        }
+        if (obj.__type === "Blob" && obj.__skipped) {
+          return null;
+        }
+        const result = {};
+        for (const [k, v] of Object.entries(obj)) {
+          result[k] = deserializeValue(v);
+        }
+        return result;
+      }
+      if (Array.isArray(value)) {
+        return value.map(deserializeValue);
+      }
+      return value;
+    }
+    for (const dbData of databases) {
+      try {
+        await new Promise((resolve2, reject2) => {
+          const req = indexedDB.deleteDatabase(dbData.name);
+          req.onsuccess = () => resolve2();
+          req.onerror = () => reject2(req.error);
+          req.onblocked = () => resolve2();
+        });
+        const db = await new Promise((resolve2, reject2) => {
+          const request2 = indexedDB.open(dbData.name, dbData.version);
+          request2.onupgradeneeded = () => {
+            const db2 = request2.result;
+            for (const storeData of dbData.objectStores) {
+              if (!db2.objectStoreNames.contains(storeData.name)) {
+                db2.createObjectStore(storeData.name, {
+                  keyPath: storeData.keyPath ?? void 0,
+                  autoIncrement: storeData.autoIncrement
+                });
+              }
+            }
+          };
+          request2.onsuccess = () => resolve2(request2.result);
+          request2.onerror = () => reject2(request2.error);
+        });
+        for (const storeData of dbData.objectStores) {
+          if (storeData.entries.length === 0) continue;
+          if (!db.objectStoreNames.contains(storeData.name)) continue;
+          try {
+            const tx = db.transaction(storeData.name, "readwrite");
+            const store = tx.objectStore(storeData.name);
+            for (const entry of storeData.entries) {
+              const value = deserializeValue(entry.value);
+              if (storeData.keyPath) {
+                store.put(value);
+              } else {
+                store.put(value, entry.key);
+              }
+            }
+            await new Promise((resolve2, reject2) => {
+              tx.oncomplete = () => resolve2();
+              tx.onerror = () => reject2(tx.error);
+            });
+          } catch {
+          }
+        }
+        db.close();
+      } catch {
+      }
+    }
+  }, data.databases);
+}
+
 // ../browser-core/src/snapshot-analyzer.ts
 var logger = consoleLogger;
 function setSnapshotAnalyzerLogger(l) {
@@ -38342,8 +38537,20 @@ function normalizeIconLabelText(role, text) {
   }
   return ICON_ONLY_ROLES.has(role) ? "(icon)" : "";
 }
+var STYLED_WRAPPER_RE = /^Styled\(\w+\)$/;
+var MUI_CLASS_RE = /^Mui\w+-[\w-]+$/;
+var HAS_ASCII_ALNUM_RE = /[A-Za-z0-9]/;
+function isNoisyLabel(text) {
+  const trimmed = text.trim();
+  if (!trimmed) return false;
+  if (STYLED_WRAPPER_RE.test(trimmed)) return true;
+  if (MUI_CLASS_RE.test(trimmed)) return true;
+  if (HAS_PRIVATE_USE_GLYPH_RE.test(trimmed)) return false;
+  if (!HAS_ASCII_ALNUM_RE.test(trimmed)) return true;
+  return false;
+}
 
-// ../browser-core/src/snapshot-formatter.ts
+// ../browser-core/src/snapshot-formatter-shared.ts
 var MAX_SEARCH_MATCHES = 10;
 var INTERACTIVE_LEAF_ROLES = /* @__PURE__ */ new Set([
   "button",
@@ -38378,134 +38585,6 @@ var STRUCTURAL_ROLES = /* @__PURE__ */ new Set([
   "section",
   "iframe"
 ]);
-var VISUAL_HEADING_MAX_LENGTH = 60;
-function hasInteractiveDescendants(element) {
-  if (element.ref && (INTERACTIVE_ROLES.has(element.role) || isClickableByAttribute(element))) return true;
-  for (const child of element.children) {
-    if (hasInteractiveDescendants(child)) return true;
-  }
-  return false;
-}
-function isVisualHeading(element, siblings, siblingIndex) {
-  if (element.role !== "generic" && element.role !== "paragraph") return false;
-  if (isClickableByAttribute(element)) return false;
-  const text = getVisualHeadingText(element);
-  if (!text || text.length < 3 || text.length > VISUAL_HEADING_MAX_LENGTH) return false;
-  if (hasInteractiveDescendants(element)) return false;
-  let interactiveCount = 0;
-  for (let i = siblingIndex + 1; i < siblings.length; i++) {
-    const sib = siblings[i];
-    if (sib.role === "heading" || STRUCTURAL_ROLES.has(sib.role)) break;
-    if (sib.role === "generic" || sib.role === "paragraph") {
-      if (!isClickableByAttribute(sib) && !hasInteractiveDescendants(sib)) {
-        const sibText = getVisualHeadingText(sib);
-        if (sibText && sibText.length >= 3 && sibText.length <= VISUAL_HEADING_MAX_LENGTH) {
-          break;
-        }
-      }
-    }
-    if (hasInteractiveDescendants(sib) || isClickableByAttribute(sib)) {
-      interactiveCount++;
-    }
-  }
-  return interactiveCount >= 3;
-}
-function getVisualHeadingText(element) {
-  const direct = element.text;
-  if (direct) return direct;
-  for (const child of element.children) {
-    if (TEXT_CARRYING_ROLES.has(child.role) && child.text) return child.text;
-  }
-  return void 0;
-}
-function findNextSectionBoundary(siblings, startIndex) {
-  for (let i = startIndex; i < siblings.length; i++) {
-    const sib = siblings[i];
-    if (sib.role === "heading" || STRUCTURAL_ROLES.has(sib.role)) return i;
-    if (isVisualHeading(sib, siblings, i)) return i;
-  }
-  return siblings.length;
-}
-function isFieldLabelCandidate(element) {
-  if (element.role !== "generic" && element.role !== "paragraph" && element.role !== "text" && element.role !== "label" && element.role !== "strong" && element.role !== "emphasis") {
-    return false;
-  }
-  if (isClickableByAttribute(element)) return false;
-  if (hasInteractiveDescendants(element)) return false;
-  const text = getFieldLabelText(element);
-  if (!text || text.length < 1 || text.length > VISUAL_HEADING_MAX_LENGTH) return false;
-  return true;
-}
-var FIELD_LABEL_TEXT_ROLES = /* @__PURE__ */ new Set([
-  "generic",
-  "paragraph",
-  "text",
-  "strong",
-  "emphasis",
-  "label",
-  "heading"
-]);
-function getFieldLabelText(element) {
-  if (element.text) return element.text.trim();
-  if (element.inputValue && !INTERACTIVE_ROLES.has(element.role)) return element.inputValue.trim();
-  for (const child of element.children) {
-    if (FIELD_LABEL_TEXT_ROLES.has(child.role)) {
-      if (child.text) return child.text.trim();
-      if (child.inputValue && !INTERACTIVE_ROLES.has(child.role)) return child.inputValue.trim();
-    }
-  }
-  return void 0;
-}
-function findFieldLabelFromSiblings(siblings, interactiveIndex) {
-  for (let i = interactiveIndex - 1; i >= 0; i--) {
-    const sib = siblings[i];
-    if (INTERACTIVE_ROLES.has(sib.role) || isClickableByAttribute(sib) || STRUCTURAL_ROLES.has(sib.role) || sib.role === "heading") {
-      break;
-    }
-    if (isFieldLabelCandidate(sib)) {
-      return getFieldLabelText(sib);
-    }
-    if (sib.children.length >= 1 && sib.children.length <= 4) {
-      const containerLabel = resolveContainerFieldLabel(sib);
-      if (containerLabel) return containerLabel;
-    }
-    if (sib.children.length > 4) break;
-  }
-  return void 0;
-}
-function findFieldLabelInContext(_element, siblings, siblingIndex) {
-  return findFieldLabelFromSiblings(siblings, siblingIndex);
-}
-function resolveContainerFieldLabel(container) {
-  const kids = container.children;
-  if (kids.length < 2 || kids.length > 4) return void 0;
-  const firstChild = kids[0];
-  if (isFieldLabelCandidate(firstChild)) {
-    return getFieldLabelText(firstChild);
-  }
-  return void 0;
-}
-function shouldDropInheritedFieldLabel(element, inheritedFieldLabel) {
-  if (!inheritedFieldLabel) return false;
-  if (INTERACTIVE_LEAF_ROLES.has(element.role)) return false;
-  if (!isClickableByAttribute(element)) return false;
-  const directText = getElementText(element);
-  if (directText) {
-    return directText.toLowerCase() !== inheritedFieldLabel.toLowerCase();
-  }
-  const childTexts = [];
-  for (const child of element.children) {
-    if (!INTERACTIVE_LEAF_ROLES.has(child.role)) {
-      const text = getElementText(child);
-      if (text && TEXT_CARRYING_ROLES.has(child.role)) {
-        childTexts.push(text);
-      }
-    }
-  }
-  const composedText = childTexts.join(" ");
-  if (!composedText) return false;
-  return composedText.toLowerCase() !== inheritedFieldLabel.toLowerCase();
-}
 var TEXT_CARRYING_ROLES = /* @__PURE__ */ new Set([
   "generic",
   "paragraph",
@@ -38516,12 +38595,11 @@ var TEXT_CARRYING_ROLES = /* @__PURE__ */ new Set([
   "blockquote",
   "caption"
 ]);
+var VISUAL_HEADING_MAX_LENGTH = 60;
 var STATUS_WORDS = /* @__PURE__ */ new Set(["favorable", "unfavorable", "success", "error", "warning", "pending"]);
 var BLANK_PATTERNS = [
   /\s*\(Blank\)\s*/gi,
-  // "(Blank)" in any case
   /\s*\(blank\)\s*/gi
-  // Redundant but explicit
 ];
 var MENU_TRIGGER_PATTERNS = [
   /^Open menu for /i,
@@ -38536,21 +38614,102 @@ var SECTION_BOUNDARY_ROLES = /* @__PURE__ */ new Set([
   "article",
   "section",
   "complementary"
-  // sidebars
 ]);
+var FRAMEWORK_NOISE_RE = /^(ng-binding|ng-scope|ng-pristine|ng-dirty|ng-valid|ng-invalid|ng-untouched|ng-touched|v-enter|v-leave)$/;
 function normalizeSearchText(text) {
   return text.toLowerCase().replace(/[-_.,;:!?'"()\[\]{}\/\\@#$%^&*+=<>~`|]/g, "").replace(/\s+/g, " ").trim();
 }
-function isMenuTriggerNoise(element) {
-  if (isActiveElement(element)) return false;
-  if (element.role !== "button") return false;
-  const text = element.text || "";
-  if (!text.trim()) return false;
-  for (const pattern of MENU_TRIGGER_PATTERNS) {
-    if (pattern.test(text)) return true;
+function isActiveElement(element) {
+  return element.attributes["active"] !== void 0 || element.rawLine.includes("[active]");
+}
+function isDisabledElement(element) {
+  return element.attributes["disabled"] !== void 0 || element.rawLine.includes("[disabled]");
+}
+function isClickableByAttribute(element) {
+  return element.attributes["cursor"] === "pointer";
+}
+function isActionableClickableGeneric(element) {
+  return isClickableByAttribute(element) && !INTERACTIVE_ROLES.has(element.role);
+}
+function isSearchInteractiveElement(element) {
+  return INTERACTIVE_LEAF_ROLES.has(element.role) || isActionableClickableGeneric(element);
+}
+function getElementText(el) {
+  if (el.text && el.inputValue && FRAMEWORK_NOISE_RE.test(el.text.trim())) {
+    return el.inputValue;
+  }
+  return el.text || el.inputValue;
+}
+function composeLabel(element) {
+  const directText = getElementText(element);
+  if (directText) return directText;
+  const textParts = [];
+  function collectText(el, depth) {
+    if (depth > 3) return;
+    const text = getElementText(el);
+    if (text && TEXT_CARRYING_ROLES.has(el.role)) {
+      textParts.push(text);
+    }
+    for (const child of el.children) {
+      if (!INTERACTIVE_LEAF_ROLES.has(child.role)) {
+        collectText(child, depth + 1);
+      }
+    }
+  }
+  for (const child of element.children) {
+    if (!INTERACTIVE_LEAF_ROLES.has(child.role)) {
+      collectText(child, 0);
+    }
+  }
+  return textParts.join(" | ") || element.role;
+}
+function composeChildLabel(element) {
+  const textParts = [];
+  function collectText(el, depth) {
+    if (depth > 3) return;
+    const text = getElementText(el);
+    if (text && TEXT_CARRYING_ROLES.has(el.role)) {
+      textParts.push(text);
+    }
+    for (const child of el.children) {
+      if (!INTERACTIVE_LEAF_ROLES.has(child.role)) {
+        collectText(child, depth + 1);
+      }
+    }
+  }
+  for (const child of element.children) {
+    if (!INTERACTIVE_LEAF_ROLES.has(child.role)) {
+      collectText(child, 0);
+    }
+  }
+  return textParts.length > 0 ? textParts.join(" | ") : null;
+}
+function getDisplayText(element, options) {
+  const isClickable = isActionableClickableGeneric(element);
+  let rawTextSource = options?.overrideLabel ?? (isClickable ? composeLabel(element) : element.text ?? "");
+  if (rawTextSource && isNoisyLabel(rawTextSource) && INTERACTIVE_LEAF_ROLES.has(element.role)) {
+    const childText = composeChildLabel(element);
+    rawTextSource = childText ?? "";
+  }
+  return normalizeIconLabelText(element.role, rawTextSource);
+}
+function hasInteractiveDescendants(element) {
+  if (element.ref && (INTERACTIVE_ROLES.has(element.role) || isClickableByAttribute(element))) return true;
+  for (const child of element.children) {
+    if (hasInteractiveDescendants(child)) return true;
   }
   return false;
 }
+function subtreeContainsActive(element) {
+  if (isActiveElement(element)) return true;
+  for (const child of element.children) {
+    if (subtreeContainsActive(child)) return true;
+  }
+  return false;
+}
+function cleanLabel(text) {
+  return text.replace(/\s+/g, " ").replace(/…+/g, "...").trim();
+}
 function isBlankValue(value) {
   if (!value) return true;
   const trimmed = value.trim().toLowerCase();
@@ -38590,160 +38749,15 @@ function extractDataValue(text) {
   }
   return { label: cleanLabel(cleaned), status };
 }
-function findRelevanceScope(elements, activeElementRef) {
-  if (!activeElementRef) return null;
-  const path5 = [];
-  function findPath(el) {
-    if (el.ref) {
-      path5.push({ ref: el.ref, role: el.role });
-    }
-    if (el.ref === activeElementRef) {
-      return true;
-    }
-    for (const child of el.children) {
-      if (findPath(child)) return true;
-    }
-    if (el.ref) path5.pop();
-    return false;
-  }
-  for (const el of elements) {
-    if (findPath(el)) break;
-  }
-  for (let i = path5.length - 1; i >= 0; i--) {
-    if (SECTION_BOUNDARY_ROLES.has(path5[i].role)) {
-      return path5[i].ref;
-    }
-  }
-  return null;
-}
-function searchElements(elements, searchTerms, scopeRef = null) {
-  const allMatches = [];
-  const normalizedTerms = searchTerms.map((t) => normalizeSearchText(t)).filter(Boolean);
-  if (normalizedTerms.length === 0) return { matches: [], totalFound: 0 };
-  function searchElement(el, inScope) {
-    const nowInScope = inScope || el.ref === scopeRef || scopeRef === null;
-    if (el.ref && nowInScope) {
-      const searchText = [el.text, el.inputValue].filter(Boolean).join(" ");
-      const normalizedSearchText = normalizeSearchText(searchText);
-      for (const term of normalizedTerms) {
-        if (normalizedSearchText.includes(term)) {
-          const normalizedLabel = normalizeIconLabelText(el.role, el.text || "");
-          allMatches.push({
-            ref: el.ref,
-            role: el.role,
-            label: normalizedLabel || el.role,
-            term,
-            isInteractive: INTERACTIVE_LEAF_ROLES.has(el.role)
-          });
-          break;
-        }
-      }
-    }
-    for (const child of el.children) {
-      searchElement(child, nowInScope);
-    }
-  }
-  for (const el of elements) {
-    searchElement(el, scopeRef === null);
-  }
-  const totalFound = allMatches.length;
-  allMatches.sort((a, b) => {
-    if (a.isInteractive && !b.isInteractive) return -1;
-    if (!a.isInteractive && b.isInteractive) return 1;
-    return 0;
-  });
-  return {
-    matches: allMatches.slice(0, MAX_SEARCH_MATCHES),
-    totalFound
-  };
-}
-function findElementInSections(sections, targetRef, ancestors = []) {
-  for (const section of sections) {
-    const newAncestors = [...ancestors, section];
-    const path5 = newAncestors.map((s) => s.heading);
-    if (section.elements.some((el) => el.ref === targetRef)) {
-      return { section, ancestors: newAncestors, path: path5 };
-    }
-    const found = findElementInSections(section.subsections, targetRef, newAncestors);
-    if (found) return found;
-  }
-  return null;
-}
-function populateSearchContext(matches, sections) {
-  for (const match of matches) {
-    const result = findElementInSections(sections, match.ref);
-    if (result) {
-      const { section, ancestors, path: path5 } = result;
-      const inFocusedDialog = ancestors.some((s) => s.isFocused);
-      const inBackground = section.isBackground || ancestors.some((s) => s.isBackground);
-      if (inFocusedDialog) {
-        match.context = "focused";
-      } else if (inBackground) {
-        match.context = "background";
-      } else {
-        match.context = "foreground";
-      }
-      const SKIP_HEADINGS = ["generic", "main", "iframe"];
-      match.sectionPath = path5.filter((p) => !SKIP_HEADINGS.includes(p.toLowerCase())).slice(-3).join(" > ");
-    }
-  }
-}
-function sortMatchesByContext(matches) {
-  const contextOrder = {
-    focused: 0,
-    foreground: 1,
-    background: 2
-  };
-  return [...matches].sort((a, b) => {
-    const aContext = contextOrder[a.context ?? "foreground"] ?? 1;
-    const bContext = contextOrder[b.context ?? "foreground"] ?? 1;
-    if (aContext !== bContext) return aContext - bContext;
-    if (a.isInteractive && !b.isInteractive) return -1;
-    if (!a.isInteractive && b.isInteractive) return 1;
-    return 0;
-  });
-}
-function cleanLabel(text) {
-  return text.replace(/\s+/g, " ").replace(/…+/g, "...").trim();
-}
-function isActiveElement(element) {
-  return element.attributes["active"] !== void 0 || element.rawLine.includes("[active]");
-}
-function isDisabledElement(element) {
-  return element.attributes["disabled"] !== void 0 || element.rawLine.includes("[disabled]");
-}
-function isClickableByAttribute(element) {
-  return element.attributes["cursor"] === "pointer";
-}
-var FRAMEWORK_NOISE_RE = /^(ng-binding|ng-scope|ng-pristine|ng-dirty|ng-valid|ng-invalid|ng-untouched|ng-touched|v-enter|v-leave)$/;
-function getElementText(el) {
-  if (el.text && el.inputValue && FRAMEWORK_NOISE_RE.test(el.text.trim())) {
-    return el.inputValue;
-  }
-  return el.text || el.inputValue;
-}
-function composeLabel(element) {
-  const directText = getElementText(element);
-  if (directText) return directText;
-  const textParts = [];
-  function collectText(el, depth) {
-    if (depth > 3) return;
-    const text = getElementText(el);
-    if (text && TEXT_CARRYING_ROLES.has(el.role)) {
-      textParts.push(text);
-    }
-    for (const child of el.children) {
-      if (!INTERACTIVE_LEAF_ROLES.has(child.role)) {
-        collectText(child, depth + 1);
-      }
-    }
-  }
-  for (const child of element.children) {
-    if (!INTERACTIVE_LEAF_ROLES.has(child.role)) {
-      collectText(child, 0);
-    }
+function isMenuTriggerNoise(element) {
+  if (isActiveElement(element)) return false;
+  if (element.role !== "button") return false;
+  const text = element.text || "";
+  if (!text.trim()) return false;
+  for (const pattern of MENU_TRIGGER_PATTERNS) {
+    if (pattern.test(text)) return true;
   }
-  return textParts.join(" | ") || element.role;
+  return false;
 }
 function countElementsWithRefs(element) {
   let count = element.ref ? 1 : 0;
@@ -38752,74 +38766,23 @@ function countElementsWithRefs(element) {
   }
   return count;
 }
-function isExpandedElement(element) {
-  return element.attributes["expanded"] === "true" || element.attributes["aria-expanded"] === "true";
-}
-function collectExpandedChildren(element, result) {
-  for (const child of element.children) {
-    if (STRUCTURAL_ROLES.has(child.role)) continue;
-    if (INTERACTIVE_LEAF_ROLES.has(child.role) && child.ref) {
-      result.push(formatElement(child));
-      continue;
-    }
-    if (child.role === "listitem" && child.ref) {
-      const text = child.text || composeLabel(child);
-      if (text && text !== "listitem") {
-        result.push(formatElement(child, { overrideLabel: text }));
-        continue;
-      }
-    }
-    if (isClickableByAttribute(child) && child.ref) {
-      result.push(formatElement(child));
+function collectComboboxOptions(element) {
+  const options = [];
+  function walk(el) {
+    if (el.role === "option" && el.text?.trim()) {
+      options.push(el.text.trim());
     }
-    collectExpandedChildren(child, result);
-  }
-}
-function hasActionableChildren(element) {
-  const children2 = [];
-  collectExpandedChildren(element, children2);
-  return children2.length > 0;
-}
-function isExpandedWithActionableChildren(element) {
-  if (!isExpandedElement(element)) return false;
-  if (element.role === "combobox") return false;
-  return hasActionableChildren(element);
-}
-function composeTriggerLabel(element) {
-  const ariaLabel = element.attributes["aria-label"];
-  if (ariaLabel) return ariaLabel;
-  const fullText = element.text || "";
-  if (fullText) {
-    let collectLeafTexts2 = function(el) {
-      for (const child of el.children) {
-        const text = child.text?.trim();
-        if (text) {
-          leafTexts.push(text);
-        }
-        collectLeafTexts2(child);
-      }
-    };
-    var collectLeafTexts = collectLeafTexts2;
-    const leafTexts = [];
-    collectLeafTexts2(element);
-    if (leafTexts.length > 0) {
-      let stripped = fullText;
-      for (const lt of leafTexts) {
-        stripped = stripped.replace(lt, "");
-      }
-      stripped = stripped.replace(/\s+/g, " ").trim();
-      if (stripped) return stripped;
+    for (const child of el.children) {
+      walk(child);
     }
   }
-  return element.role;
-}
-function subtreeContainsActive(element) {
-  if (isActiveElement(element)) return true;
   for (const child of element.children) {
-    if (subtreeContainsActive(child)) return true;
+    walk(child);
   }
-  return false;
+  return options.length > 0 ? options : void 0;
 }
+
+// ../browser-core/src/snapshot-formatter-grid.ts
 function findDescendantByRole(el, role) {
   if (el.role === role) return el;
   for (const child of el.children) {
@@ -38864,6 +38827,177 @@ function isWidgetTable(element) {
   }
   return totalCells > 0 && interactiveCells >= totalCells * 0.5;
 }
+function gridCellPriority(el) {
+  if (el.isActive) return 5;
+  if (FORM_INPUT_ROLES.has(el.role)) return 4;
+  if (el.isClickableGeneric) return 3;
+  if (el.role !== "button") return 2;
+  return 1;
+}
+function extractCellText(el) {
+  const findFirstParagraph = (node) => {
+    if (node.role === "paragraph" && node.text) {
+      return node.text.trim();
+    }
+    for (const child of node.children) {
+      if (child.role === "generic" || child.role === "paragraph") {
+        const found = findFirstParagraph(child);
+        if (found) return found;
+      }
+    }
+    return null;
+  };
+  const paragraphText = findFirstParagraph(el);
+  if (paragraphText) return paragraphText;
+  const text = el.text?.trim();
+  if (text) return text;
+  return null;
+}
+function extractGridCell(cellEl) {
+  const interactiveElements = [];
+  const findInteractive = (el) => {
+    if (isClickableByAttribute(el) && el.ref && el.role === "generic") {
+      const childTexts = [];
+      for (const child of el.children) {
+        if (child.role === "generic") {
+          const childText = child.text || child.inputValue;
+          if (childText) childTexts.push(childText);
+        }
+      }
+      interactiveElements.push({
+        ref: el.ref,
+        column: el.attributes["label"] || childTexts[0] || "",
+        value: childTexts.join(" - ") || el.text || el.inputValue || "",
+        role: el.role,
+        isClickableGeneric: true,
+        isActive: isActiveElement(el)
+      });
+    }
+    if (INTERACTIVE_LEAF_ROLES.has(el.role) && el.ref) {
+      const value2 = el.role === "checkbox" ? el.attributes["checked"] === "true" ? "checked" : "unchecked" : el.inputValue || el.text || "";
+      interactiveElements.push({
+        ref: el.ref,
+        column: el.attributes["label"] || el.text || "",
+        value: value2,
+        role: el.role,
+        isClickableGeneric: false,
+        isActive: isActiveElement(el)
+      });
+    }
+    for (const child of el.children) findInteractive(child);
+  };
+  findInteractive(cellEl);
+  if (interactiveElements.length === 0) {
+    const textValue = extractCellText(cellEl);
+    if (textValue && !isNoisyLabel(textValue)) {
+      return {
+        ref: cellEl.ref,
+        column: cellEl.text || "",
+        value: textValue,
+        hasValue: true
+      };
+    }
+    return null;
+  }
+  const found = interactiveElements.reduce(
+    (best, current) => gridCellPriority(current) > gridCellPriority(best) ? current : best
+  );
+  const column = stripBlankPatterns(found.column);
+  const rawValue = isBlankValue(found.value) ? "" : stripBlankPatterns(found.value).trim();
+  const value = isNoisyLabel(rawValue) ? "" : rawValue;
+  const gridcellLabel = cellEl.text ? stripBlankPatterns(cellEl.text).trim() : void 0;
+  return {
+    ref: found.ref,
+    column: column.trim(),
+    value,
+    hasValue: value !== "",
+    gridcellLabel: gridcellLabel || void 0,
+    role: found.role
+  };
+}
+function reconcileCellColumn(cell, knownColumns) {
+  if (knownColumns.has(cell.column)) return cell;
+  if (cell.gridcellLabel && knownColumns.has(cell.gridcellLabel)) {
+    const newValue = cell.column || cell.value;
+    const cleanValue = isBlankValue(newValue) ? "" : newValue.trim();
+    return {
+      ...cell,
+      column: cell.gridcellLabel,
+      value: cleanValue,
+      hasValue: cleanValue !== ""
+    };
+  }
+  let bestMatch = "";
+  for (const col of knownColumns) {
+    if (cell.column.startsWith(col) && col.length > bestMatch.length && (cell.column.length === col.length || cell.column[col.length] === " ")) {
+      bestMatch = col;
+    }
+  }
+  if (bestMatch) {
+    const remainder = cell.column.slice(bestMatch.length).trim();
+    const newValue = isBlankValue(remainder) ? "" : remainder;
+    return {
+      ...cell,
+      column: bestMatch,
+      value: newValue || cell.value,
+      hasValue: (newValue || cell.value) !== ""
+    };
+  }
+  return cell;
+}
+function reconcileGridCells(grid) {
+  if (grid.columns.length === 0) return grid;
+  const knownColumns = new Set(grid.columns.map((c2) => c2.name));
+  return {
+    ...grid,
+    rows: grid.rows.map((row) => {
+      const reconciledCells = row.cells.map((cell) => {
+        const reconciled = reconcileCellColumn(cell, knownColumns);
+        if (knownColumns.has(reconciled.column)) return reconciled;
+        if (grid.columnByPosition && cell.positionInRow !== void 0 && grid.headerChildCount !== void 0 && row.totalChildren === grid.headerChildCount) {
+          const positionalColumn = grid.columnByPosition.get(cell.positionInRow);
+          if (positionalColumn) {
+            const newValue = cell.column || cell.value;
+            const cleanValue = isBlankValue(newValue) ? "" : newValue.trim();
+            return {
+              ...cell,
+              column: positionalColumn,
+              value: cleanValue,
+              hasValue: cleanValue !== ""
+            };
+          }
+        }
+        return reconciled;
+      });
+      if (grid.headerCellPositions && row.cellPositions) {
+        const claimedColumns = new Set(
+          reconciledCells.filter((c2) => knownColumns.has(c2.column)).map((c2) => c2.column)
+        );
+        for (let idx = 0; idx < reconciledCells.length; idx++) {
+          const cell = reconciledCells[idx];
+          if (knownColumns.has(cell.column) || cell.positionInRow === void 0) continue;
+          const cellOrdinal = row.cellPositions.indexOf(cell.positionInRow);
+          if (cellOrdinal >= 0 && cellOrdinal < grid.headerCellPositions.length) {
+            const headerPos = grid.headerCellPositions[cellOrdinal];
+            const positionalColumn = grid.columnByPosition?.get(headerPos);
+            if (positionalColumn && !claimedColumns.has(positionalColumn)) {
+              const newValue = cell.column || cell.value;
+              const cleanValue = isBlankValue(newValue) ? "" : newValue.trim();
+              reconciledCells[idx] = {
+                ...cell,
+                column: positionalColumn,
+                value: cleanValue,
+                hasValue: cleanValue !== ""
+              };
+              claimedColumns.add(positionalColumn);
+            }
+          }
+        }
+      }
+      return { ...row, cells: reconciledCells };
+    })
+  };
+}
 function detectGrid(element) {
   if (element.role !== "grid" && element.role !== "treegrid" && element.role !== "table") {
     return null;
@@ -38874,18 +39008,28 @@ function detectGrid(element) {
   let headerRowRef = null;
   const columnByPosition = /* @__PURE__ */ new Map();
   let headerChildCount;
+  let headerCellPositions;
+  const isRowLike = (el) => {
+    if (el.role === "row") return true;
+    const cellCount = el.children.filter(
+      (c2) => c2.role === "cell" || c2.role === "gridcell"
+    ).length;
+    return cellCount >= 2;
+  };
   const processRow = (rowEl, index) => {
-    if (rowEl.role !== "row") return null;
+    if (!isRowLike(rowEl)) return null;
     const hasColumnHeaders = rowEl.children.some((c2) => c2.role === "columnheader");
     if (hasColumnHeaders) {
       headerRowRef = rowEl.ref;
       const columnHeaders = rowEl.children.filter((c2) => c2.role === "columnheader");
-      const hasChildful = columnHeaders.some((c2) => c2.children.length > 0);
+      const childful = columnHeaders.filter((c2) => c2.children.length > 0);
+      const textBearingChildless = columnHeaders.filter((c2) => c2.children.length === 0 && c2.text);
+      const skipChildlessHeaders = childful.length > 0 && textBearingChildless.length <= childful.length;
       const columnsBefore = columns.length;
       for (let i = 0; i < rowEl.children.length; i++) {
         const child = rowEl.children[i];
         if (child.role === "columnheader") {
-          if (hasChildful && child.children.length === 0) continue;
+          if (skipChildlessHeaders && child.children.length === 0) continue;
           const primaryLabel = findPrimaryColumnLabel(child);
           const rawName = (primaryLabel ? getElementText(primaryLabel) : void 0) || child.text || "";
           const cleanName = rawName.replace(/,?\s*sorted in \w+ order/i, "").trim();
@@ -38904,6 +39048,7 @@ function detectGrid(element) {
       }
       if (columns.length > columnsBefore) {
         headerChildCount = rowEl.children.length;
+        headerCellPositions = Array.from(columnByPosition.keys()).sort((a, b) => a - b);
       }
       return null;
     }
@@ -38945,6 +39090,7 @@ function detectGrid(element) {
         }
         if (columns.length > columnsBefore) {
           headerChildCount = rowEl.children.length;
+          headerCellPositions = Array.from(columnByPosition.keys()).sort((a, b) => a - b);
         }
         return null;
       }
@@ -38970,7 +39116,20 @@ function detectGrid(element) {
         findButtons(cellEl);
       }
     }
-    const row = { ref: rowEl.ref, index, isSelected, cells, totalChildren: rowEl.children.length };
+    const cellPositions = [];
+    for (let i = 0; i < rowEl.children.length; i++) {
+      if (rowEl.children[i].role === "gridcell" || rowEl.children[i].role === "cell") {
+        cellPositions.push(i);
+      }
+    }
+    const row = {
+      ref: rowEl.ref,
+      index,
+      isSelected,
+      cells,
+      totalChildren: rowEl.children.length,
+      cellPositions
+    };
     if (cells.length === 0 && rowEl.children.some((c2) => c2.role === "rowheader")) {
       const labels = [];
       const buttons = [];
@@ -38998,7 +39157,7 @@ function detectGrid(element) {
     return row;
   };
   const findRows = (el) => {
-    if (el.role === "row") {
+    if (isRowLike(el)) {
       const row = processRow(el, rows.length);
       if (row) rows.push(row);
     } else {
@@ -39016,177 +39175,414 @@ function detectGrid(element) {
     totalRows: rows.length,
     containsActive: subtreeContainsActive(element),
     columnByPosition: columnByPosition.size > 0 ? columnByPosition : void 0,
-    headerChildCount
+    headerChildCount,
+    headerCellPositions
   };
   return reconcileGridCells(rawGrid);
 }
-function gridCellPriority(el) {
-  if (el.isActive) return 5;
-  if (FORM_INPUT_ROLES.has(el.role)) return 4;
-  if (el.isClickableGeneric) return 3;
-  if (el.role !== "button") return 2;
-  return 1;
+function gridContainsRef(grid, targetRef) {
+  for (const column of grid.columns) {
+    if (column.ref === targetRef) return true;
+  }
+  for (const row of grid.rows) {
+    if (row.ref === targetRef) return true;
+    if (row.cells.some((cell) => cell.ref === targetRef)) return true;
+    if (row.rowActions?.some((action) => action.ref === targetRef)) return true;
+    if (row.expandedContent?.buttons.some((button) => button.ref === targetRef)) return true;
+  }
+  return false;
 }
-function extractCellText(el) {
-  const findFirstParagraph = (node) => {
-    if (node.role === "paragraph" && node.text) {
-      return node.text.trim();
+function countRenderedGridItems(grid) {
+  const knownColumns = grid.columns.length > 0 ? new Set(grid.columns.map((c2) => c2.name)) : void 0;
+  let count = 0;
+  for (const row of grid.rows) {
+    count += row.cells.filter((c2) => c2.hasValue && (!knownColumns || knownColumns.has(c2.column))).length;
+    count += row.rowActions?.length ?? 0;
+    count += row.expandedContent?.buttons.length ?? 0;
+  }
+  return count;
+}
+function formatGridOutput(grid, indent, expanded = false) {
+  const indentStr = "  ".repeat(indent);
+  const lines = [];
+  const colInfo = grid.columns.length > 0 ? `${grid.columns.length} columns` : "unknown columns";
+  lines.push(`${indentStr}GRID [${grid.ref}]: ${grid.totalRows} rows, ${colInfo}`);
+  const MAX_DISPLAY_COLUMNS = 10;
+  if (grid.columns.length > 0) {
+    const displayColumns = grid.columns.slice(0, MAX_DISPLAY_COLUMNS);
+    const colsWithRefs = displayColumns.map((c2) => `${c2.name} [${c2.ref}]`).join(", ");
+    const moreColsNote = grid.columns.length > MAX_DISPLAY_COLUMNS ? ` (+${grid.columns.length - MAX_DISPLAY_COLUMNS} more)` : "";
+    lines.push(`${indentStr}  Columns: ${colsWithRefs}${moreColsNote}`);
+  }
+  lines.push("");
+  const knownColumns = grid.columns.length > 0 ? new Set(grid.columns.map((c2) => c2.name)) : void 0;
+  const MAX_GRID_ROWS = 30;
+  const displayRows = expanded ? grid.rows : grid.rows.slice(0, MAX_GRID_ROWS);
+  for (const row of displayRows) {
+    lines.push(formatGridRow(row, indent + 1, knownColumns));
+  }
+  if (!expanded && grid.rows.length > MAX_GRID_ROWS) {
+    lines.push(`${indentStr}  ... and ${grid.rows.length - MAX_GRID_ROWS} more rows (use expand="${grid.ref}" to see all)`);
+  }
+  return lines.join("\n");
+}
+function formatGridRow(row, indent, knownColumns) {
+  const indentStr = "  ".repeat(indent);
+  if (row.expandedContent) {
+    const parts = [];
+    if (row.expandedContent.labels.length > 0) {
+      parts.push(row.expandedContent.labels.join(", "));
     }
-    for (const child of node.children) {
-      if (child.role === "generic" || child.role === "paragraph") {
-        const found = findFirstParagraph(child);
-        if (found) return found;
+    for (const btn of row.expandedContent.buttons) {
+      parts.push(`${btn.label} [${btn.ref}]`);
+    }
+    return `${indentStr}  \u21B3 Expanded [${row.ref}]: ${parts.join(" | ")}`;
+  }
+  const marker = row.isSelected ? "ACTIVE \u2192 Row" : "Row";
+  const actionsPrefix = row.rowActions?.length ? row.rowActions.map((a) => `[\u25B6 ${a.ref}]`).join(" ") + " " : "";
+  const cellsWithValue = row.cells.filter(
+    (c2) => c2.hasValue && (!knownColumns || knownColumns.has(c2.column))
+  );
+  if (cellsWithValue.length > 0) {
+    const cellStrs = cellsWithValue.map((c2) => {
+      if (c2.role === "checkbox") {
+        const icon = c2.value === "checked" ? "\u2611" : "\u2610";
+        return `${icon} [${c2.ref}]`;
+      }
+      if (c2.column === c2.value) {
+        return `${c2.column} [${c2.ref}]`;
       }
+      return `${c2.column} [${c2.ref}]: ${c2.value}`;
+    });
+    return `${indentStr}${actionsPrefix}${marker} [${row.ref}]: ${cellStrs.join(" | ")}`;
+  }
+  return `${indentStr}${actionsPrefix}${marker} [${row.ref}]: (empty row)`;
+}
+
+// ../browser-core/src/snapshot-formatter-search.ts
+function findRelevanceScope(elements, activeElementRef) {
+  if (!activeElementRef) return null;
+  const path5 = [];
+  function findPath(el) {
+    if (el.ref) {
+      path5.push({ ref: el.ref, role: el.role });
     }
-    return null;
-  };
-  const paragraphText = findFirstParagraph(el);
-  if (paragraphText) return paragraphText;
-  const text = el.text?.trim();
-  if (text) return text;
+    if (el.ref === activeElementRef) {
+      return true;
+    }
+    for (const child of el.children) {
+      if (findPath(child)) return true;
+    }
+    if (el.ref) path5.pop();
+    return false;
+  }
+  for (const el of elements) {
+    if (findPath(el)) break;
+  }
+  for (let i = path5.length - 1; i >= 0; i--) {
+    if (SECTION_BOUNDARY_ROLES.has(path5[i].role)) {
+      return path5[i].ref;
+    }
+  }
   return null;
 }
-function extractGridCell(cellEl) {
-  const interactiveElements = [];
-  const findInteractive = (el) => {
-    if (isClickableByAttribute(el) && el.ref && el.role === "generic") {
-      const childTexts = [];
-      for (const child of el.children) {
-        if (child.role === "generic") {
-          const childText = child.text || child.inputValue;
-          if (childText) childTexts.push(childText);
+function searchElements(elements, searchTerms, scopeRef = null) {
+  const allMatches = [];
+  const normalizedTerms = searchTerms.map((t) => normalizeSearchText(t)).filter(Boolean);
+  if (normalizedTerms.length === 0) return { matches: [], totalFound: 0 };
+  function searchElement(el, inScope) {
+    const nowInScope = inScope || el.ref === scopeRef || scopeRef === null;
+    if (el.ref && nowInScope) {
+      const searchLabel = getDisplayText(el);
+      const searchText = [searchLabel, el.inputValue].filter(Boolean).join(" ");
+      const normalizedSearchText = normalizeSearchText(searchText);
+      for (const term of normalizedTerms) {
+        if (normalizedSearchText.includes(term)) {
+          allMatches.push({
+            ref: el.ref,
+            role: el.role,
+            label: searchLabel || el.role,
+            term,
+            isInteractive: isSearchInteractiveElement(el)
+          });
+          break;
         }
       }
-      interactiveElements.push({
-        ref: el.ref,
-        column: el.attributes["label"] || childTexts[0] || "",
-        value: childTexts.join(" - ") || el.text || el.inputValue || "",
-        role: el.role,
-        isClickableGeneric: true,
-        isActive: isActiveElement(el)
-      });
     }
-    if (INTERACTIVE_LEAF_ROLES.has(el.role) && el.ref) {
-      const value2 = el.role === "checkbox" ? el.attributes["checked"] === "true" ? "checked" : "unchecked" : el.inputValue || el.text || "";
-      interactiveElements.push({
-        ref: el.ref,
-        column: el.attributes["label"] || el.text || "",
-        value: value2,
-        role: el.role,
-        isClickableGeneric: false,
-        isActive: isActiveElement(el)
-      });
+    for (const child of el.children) {
+      searchElement(child, nowInScope);
     }
-    for (const child of el.children) findInteractive(child);
+  }
+  for (const el of elements) {
+    searchElement(el, scopeRef === null);
+  }
+  const totalFound = allMatches.length;
+  allMatches.sort((a, b) => {
+    if (a.isInteractive && !b.isInteractive) return -1;
+    if (!a.isInteractive && b.isInteractive) return 1;
+    return 0;
+  });
+  return {
+    matches: allMatches.slice(0, MAX_SEARCH_MATCHES),
+    totalFound
   };
-  findInteractive(cellEl);
-  if (interactiveElements.length === 0) {
-    const textValue = extractCellText(cellEl);
-    if (textValue) {
-      return {
-        ref: cellEl.ref,
-        column: cellEl.text || "",
-        value: textValue,
-        hasValue: true
-      };
+}
+function findElementInSections(sections, targetRef, ancestors = []) {
+  for (const section of sections) {
+    const newAncestors = [...ancestors, section];
+    const path5 = newAncestors.map((s) => s.heading);
+    if (section.elements.some((el) => el.ref === targetRef)) {
+      return { section, ancestors: newAncestors, path: path5 };
     }
-    return null;
+    if (section.gridInfo && gridContainsRef(section.gridInfo, targetRef)) {
+      return { section, ancestors: newAncestors, path: path5 };
+    }
+    const found = findElementInSections(section.subsections, targetRef, newAncestors);
+    if (found) return found;
   }
-  const found = interactiveElements.reduce(
-    (best, current) => gridCellPriority(current) > gridCellPriority(best) ? current : best
-  );
-  const column = stripBlankPatterns(found.column);
-  const value = isBlankValue(found.value) ? "" : stripBlankPatterns(found.value).trim();
-  const gridcellLabel = cellEl.text ? stripBlankPatterns(cellEl.text).trim() : void 0;
-  return {
-    ref: found.ref,
-    column: column.trim(),
-    value,
-    hasValue: value !== "",
-    gridcellLabel: gridcellLabel || void 0,
-    role: found.role
+  return null;
+}
+function populateSearchContext(matches, sections) {
+  for (const match of matches) {
+    const result = findElementInSections(sections, match.ref);
+    if (result) {
+      const { section, ancestors, path: path5 } = result;
+      const inFocusedDialog = ancestors.some((s) => s.isFocused);
+      const inBackground = section.isBackground || ancestors.some((s) => s.isBackground);
+      if (inFocusedDialog) {
+        match.context = "focused";
+      } else if (inBackground) {
+        match.context = "background";
+      } else {
+        match.context = "foreground";
+      }
+      const SKIP_HEADINGS = ["generic", "main", "iframe"];
+      match.sectionPath = path5.filter((p) => !SKIP_HEADINGS.includes(p.toLowerCase())).slice(-3).join(" > ");
+    }
+  }
+}
+function sortMatchesByContext(matches) {
+  const contextOrder = {
+    focused: 0,
+    foreground: 1,
+    background: 2
   };
+  return [...matches].sort((a, b) => {
+    const aContext = contextOrder[a.context ?? "foreground"] ?? 1;
+    const bContext = contextOrder[b.context ?? "foreground"] ?? 1;
+    if (aContext !== bContext) return aContext - bContext;
+    if (a.isInteractive && !b.isInteractive) return -1;
+    if (!a.isInteractive && b.isInteractive) return 1;
+    return 0;
+  });
 }
-function reconcileCellColumn(cell, knownColumns) {
-  if (knownColumns.has(cell.column)) return cell;
-  if (cell.gridcellLabel && knownColumns.has(cell.gridcellLabel)) {
-    const newValue = cell.column || cell.value;
-    const cleanValue = isBlankValue(newValue) ? "" : newValue.trim();
-    return {
-      ...cell,
-      column: cell.gridcellLabel,
-      value: cleanValue,
-      hasValue: cleanValue !== ""
-    };
+
+// ../browser-core/src/snapshot-formatter-sections.ts
+var FIELD_LABEL_TEXT_ROLES = /* @__PURE__ */ new Set([
+  "generic",
+  "paragraph",
+  "text",
+  "strong",
+  "emphasis",
+  "label",
+  "heading"
+]);
+var MIN_ELEMENTS_TO_COLLAPSE = 20;
+var DIALOG_ROLES = /* @__PURE__ */ new Set(["dialog", "alertdialog"]);
+function isVisualHeading(element, siblings, siblingIndex) {
+  if (element.role !== "generic" && element.role !== "paragraph") return false;
+  if (isClickableByAttribute(element)) return false;
+  const text = getVisualHeadingText(element);
+  if (!text || text.length < 3 || text.length > VISUAL_HEADING_MAX_LENGTH) return false;
+  if (hasInteractiveDescendants(element)) return false;
+  let interactiveCount = 0;
+  for (let i = siblingIndex + 1; i < siblings.length; i++) {
+    const sib = siblings[i];
+    if (sib.role === "heading" || STRUCTURAL_ROLES.has(sib.role)) break;
+    if (sib.role === "generic" || sib.role === "paragraph") {
+      if (!isClickableByAttribute(sib) && !hasInteractiveDescendants(sib)) {
+        const sibText = getVisualHeadingText(sib);
+        if (sibText && sibText.length >= 3 && sibText.length <= VISUAL_HEADING_MAX_LENGTH) {
+          break;
+        }
+      }
+    }
+    if (hasInteractiveDescendants(sib) || isClickableByAttribute(sib)) {
+      interactiveCount++;
+    }
   }
-  let bestMatch = "";
-  for (const col of knownColumns) {
-    if (cell.column.startsWith(col) && col.length > bestMatch.length && // Ensure there's a space separator after the column name (not a partial word match)
-    (cell.column.length === col.length || cell.column[col.length] === " ")) {
-      bestMatch = col;
+  return interactiveCount >= 3;
+}
+function getVisualHeadingText(element) {
+  const direct = element.text;
+  if (direct) return direct;
+  for (const child of element.children) {
+    if (TEXT_CARRYING_ROLES.has(child.role) && child.text) return child.text;
+  }
+  return void 0;
+}
+function findNextSectionBoundary(siblings, startIndex) {
+  for (let i = startIndex; i < siblings.length; i++) {
+    const sib = siblings[i];
+    if (sib.role === "heading" || STRUCTURAL_ROLES.has(sib.role)) return i;
+    if (isVisualHeading(sib, siblings, i)) return i;
+  }
+  return siblings.length;
+}
+function isFieldLabelCandidate(element) {
+  if (element.role !== "generic" && element.role !== "paragraph" && element.role !== "text" && element.role !== "label" && element.role !== "strong" && element.role !== "emphasis") {
+    return false;
+  }
+  if (isClickableByAttribute(element)) return false;
+  if (hasInteractiveDescendants(element)) return false;
+  const text = getFieldLabelText(element);
+  if (!text || text.length < 1 || text.length > VISUAL_HEADING_MAX_LENGTH) return false;
+  return true;
+}
+function getFieldLabelText(element) {
+  if (element.text) return element.text.trim();
+  if (element.inputValue && !INTERACTIVE_ROLES.has(element.role)) return element.inputValue.trim();
+  for (const child of element.children) {
+    if (FIELD_LABEL_TEXT_ROLES.has(child.role)) {
+      if (child.text) return child.text.trim();
+      if (child.inputValue && !INTERACTIVE_ROLES.has(child.role)) return child.inputValue.trim();
     }
   }
-  if (bestMatch) {
-    const remainder = cell.column.slice(bestMatch.length).trim();
-    const newValue = isBlankValue(remainder) ? "" : remainder;
-    return {
-      ...cell,
-      column: bestMatch,
-      value: newValue || cell.value,
-      hasValue: (newValue || cell.value) !== ""
-    };
+  return void 0;
+}
+function resolveContainerFieldLabel(container) {
+  const kids = container.children;
+  if (kids.length < 2 || kids.length > 4) return void 0;
+  const firstChild = kids[0];
+  if (isFieldLabelCandidate(firstChild)) {
+    return getFieldLabelText(firstChild);
   }
-  return cell;
+  return void 0;
 }
-function reconcileGridCells(grid) {
-  if (grid.columns.length === 0) return grid;
-  const knownColumns = new Set(grid.columns.map((c2) => c2.name));
-  return {
-    ...grid,
-    rows: grid.rows.map((row) => ({
-      ...row,
-      cells: row.cells.map((cell) => {
-        const reconciled = reconcileCellColumn(cell, knownColumns);
-        if (knownColumns.has(reconciled.column)) return reconciled;
-        if (grid.columnByPosition && cell.positionInRow !== void 0 && grid.headerChildCount !== void 0 && row.totalChildren === grid.headerChildCount) {
-          const positionalColumn = grid.columnByPosition.get(cell.positionInRow);
-          if (positionalColumn) {
-            const newValue = cell.column || cell.value;
-            const cleanValue = isBlankValue(newValue) ? "" : newValue.trim();
-            return {
-              ...cell,
-              column: positionalColumn,
-              value: cleanValue,
-              hasValue: cleanValue !== ""
-            };
+function findFieldLabelFromSiblings(siblings, interactiveIndex) {
+  for (let i = interactiveIndex - 1; i >= 0; i--) {
+    const sib = siblings[i];
+    if (INTERACTIVE_ROLES.has(sib.role) || STRUCTURAL_ROLES.has(sib.role) || sib.role === "heading") {
+      break;
+    }
+    if (isClickableByAttribute(sib)) {
+      if (sib.role === "generic" || sib.role === "paragraph" || sib.role === "label") {
+        for (let j = i - 1; j >= 0; j--) {
+          const prev = siblings[j];
+          if (INTERACTIVE_ROLES.has(prev.role) || isClickableByAttribute(prev) || STRUCTURAL_ROLES.has(prev.role) || prev.role === "heading") {
+            break;
+          }
+          if (isFieldLabelCandidate(prev)) {
+            return getFieldLabelText(prev);
           }
+          if (prev.children.length >= 1 && prev.children.length <= 4) {
+            const containerLabel = resolveContainerFieldLabel(prev);
+            if (containerLabel) return containerLabel;
+          }
+          if (prev.children.length > 4) break;
         }
-        return reconciled;
-      })
-    }))
-  };
+      }
+      break;
+    }
+    if (isFieldLabelCandidate(sib)) {
+      return getFieldLabelText(sib);
+    }
+    if (sib.children.length >= 1 && sib.children.length <= 4) {
+      const containerLabel = resolveContainerFieldLabel(sib);
+      if (containerLabel) return containerLabel;
+    }
+    if (sib.children.length > 4) break;
+  }
+  return void 0;
 }
-function findActiveElement(elements) {
-  let deepestActive = null;
-  function findDeepest(element) {
-    for (const child of element.children) {
-      findDeepest(child);
+function findFieldLabelInContext(_element, siblings, siblingIndex) {
+  return findFieldLabelFromSiblings(siblings, siblingIndex);
+}
+function shouldDropInheritedFieldLabel(element, inheritedFieldLabel) {
+  if (!inheritedFieldLabel) return false;
+  if (INTERACTIVE_LEAF_ROLES.has(element.role)) return false;
+  if (!isClickableByAttribute(element)) return false;
+  const directText = getElementText(element);
+  if (directText) {
+    return directText.toLowerCase() !== inheritedFieldLabel.toLowerCase();
+  }
+  const childTexts = [];
+  for (const child of element.children) {
+    if (!INTERACTIVE_LEAF_ROLES.has(child.role)) {
+      const text = getElementText(child);
+      if (text && TEXT_CARRYING_ROLES.has(child.role)) {
+        childTexts.push(text);
+      }
     }
-    if (isActiveElement(element)) {
-      if (!deepestActive) {
-        deepestActive = element;
+  }
+  const composedText = childTexts.join(" ");
+  if (!composedText) return false;
+  return composedText.toLowerCase() !== inheritedFieldLabel.toLowerCase();
+}
+function isExpandedElement(element) {
+  return element.attributes["expanded"] === "true" || element.attributes["aria-expanded"] === "true";
+}
+function collectExpandedChildren(element, result) {
+  for (const child of element.children) {
+    if (STRUCTURAL_ROLES.has(child.role)) continue;
+    if (INTERACTIVE_LEAF_ROLES.has(child.role) && child.ref) {
+      result.push(formatElement(child));
+      continue;
+    }
+    if (child.role === "listitem" && child.ref) {
+      const text = child.text || child.children.map((c2) => getElementText(c2)).filter((value) => Boolean(value)).join(" | ") || getDisplayText(child);
+      if (text && text !== "listitem") {
+        result.push(formatElement(child, { overrideLabel: text }));
+        continue;
       }
     }
+    if (isClickableByAttribute(child) && child.ref) {
+      result.push(formatElement(child));
+    }
+    collectExpandedChildren(child, result);
   }
-  for (const element of elements) {
-    findDeepest(element);
+}
+function hasActionableChildren(element) {
+  const children2 = [];
+  collectExpandedChildren(element, children2);
+  return children2.length > 0;
+}
+function isExpandedWithActionableChildren(element) {
+  if (!isExpandedElement(element)) return false;
+  if (element.role === "combobox") return false;
+  return hasActionableChildren(element);
+}
+function composeTriggerLabel(element) {
+  const ariaLabel = element.attributes["aria-label"];
+  if (ariaLabel) return ariaLabel;
+  const fullText = element.text || "";
+  if (fullText) {
+    let collectLeafTexts2 = function(el) {
+      for (const child of el.children) {
+        const text = child.text?.trim();
+        if (text) {
+          leafTexts.push(text);
+        }
+        collectLeafTexts2(child);
+      }
+    };
+    var collectLeafTexts = collectLeafTexts2;
+    const leafTexts = [];
+    collectLeafTexts2(element);
+    if (leafTexts.length > 0) {
+      let stripped = fullText;
+      for (const lt of leafTexts) {
+        stripped = stripped.replace(lt, "");
+      }
+      stripped = stripped.replace(/\s+/g, " ").trim();
+      if (stripped) return stripped;
+    }
   }
-  return deepestActive;
+  return element.role;
 }
 function formatElement(element, options) {
-  const isClickable = isClickableByAttribute(element) && !INTERACTIVE_ROLES.has(element.role);
-  const rawTextSource = options?.overrideLabel ?? (isClickable ? composeLabel(element) : element.text ?? "");
-  const textSource = normalizeIconLabelText(element.role, rawTextSource);
+  const isClickable = isActionableClickableGeneric(element);
+  const textSource = getDisplayText(element, { overrideLabel: options?.overrideLabel });
   const extracted = extractDataValue(textSource);
   const normalizedAttributes = Object.entries(element.attributes).filter(
     ([key]) => key !== "ref" && key !== "cursor" && key !== "aria-controls" && key !== "aria-owns" && key !== "options" && key !== "field"
@@ -39220,105 +39616,141 @@ function formatElement(element, options) {
     attributes: normalizedAttributes
   };
 }
-function collectComboboxOptions(element) {
-  const options = [];
-  function walk(el) {
-    if (el.role === "option" && el.text?.trim()) {
-      options.push(el.text.trim());
-    }
-    for (const child of el.children) {
-      walk(child);
-    }
-  }
-  for (const child of element.children) {
-    walk(child);
-  }
-  return options.length > 0 ? options : void 0;
-}
-var MIN_ELEMENTS_TO_COLLAPSE = 20;
 function shouldCollapse(section) {
   if (section.containsActive) return false;
   if (section.hasSearchMatch) return false;
   if (section.isBackground) return true;
   if (section.role === "dialog" || section.role === "alertdialog") return false;
-  if (section.role === "navigation" || section.role === "menubar" || section.role === "menu") {
-    return false;
-  }
+  if (section.role === "navigation" || section.role === "menubar" || section.role === "menu") return false;
   if (section.role === "banner") return false;
   if (section.role === "form") return false;
   if (section.elementCount >= MIN_ELEMENTS_TO_COLLAPSE) return true;
   return false;
 }
-function buildSectionTree(elements) {
-  const sections = [];
-  for (const element of elements) {
-    const section = buildSection(element, 0);
-    if (section) {
-      sections.push(section);
+function deduplicateFieldLabels(elements) {
+  const byFieldLabel = /* @__PURE__ */ new Map();
+  for (const el of elements) {
+    if (!el.fieldLabel) continue;
+    const existing = byFieldLabel.get(el.fieldLabel);
+    if (existing) {
+      existing.push(el);
+    } else {
+      byFieldLabel.set(el.fieldLabel, [el]);
+    }
+  }
+  for (const [, group] of byFieldLabel) {
+    if (group.length < 2) continue;
+    for (let i = 0; i < group.length; i++) {
+      const el = group[i];
+      if (el.name && el.name !== el.fieldLabel) {
+        el.fieldLabel = `${el.fieldLabel}: ${el.name}`;
+      } else {
+        el.fieldLabel = `${el.fieldLabel} (${i + 1})`;
+      }
+    }
+  }
+}
+function buildGridSection(element) {
+  const gridInfo = detectGrid(element);
+  if (!gridInfo) {
+    throw new Error("buildGridSection requires a grid element");
+  }
+  return {
+    ref: element.ref || "",
+    role: element.role,
+    heading: "Grid",
+    level: 0,
+    elements: [],
+    subsections: [],
+    containsActive: gridInfo.containsActive,
+    collapsed: false,
+    isBackground: false,
+    isFocused: false,
+    elementCount: gridInfo.totalRows * Math.max(gridInfo.columns.length, 1),
+    gridInfo
+  };
+}
+function collectInteractiveElements(element, elements, subsections, depth, inheritedFieldLabel) {
+  if ((INTERACTIVE_LEAF_ROLES.has(element.role) || isClickableByAttribute(element)) && element.ref) {
+    const effectiveFieldLabel = shouldDropInheritedFieldLabel(element, inheritedFieldLabel) ? void 0 : inheritedFieldLabel;
+    if (INTERACTIVE_LEAF_ROLES.has(element.role) && isExpandedWithActionableChildren(element)) {
+      elements.push(formatElement(element, { overrideLabel: composeTriggerLabel(element), fieldLabel: effectiveFieldLabel }));
+      collectExpandedChildren(element, elements);
+      return;
     }
-  }
-  markBackgroundSections(sections);
-  return sections;
-}
-function markBackgroundSections(sections) {
-  const hasActiveSibling = sections.some((s) => s.containsActive);
-  if (hasActiveSibling) {
-    for (const section of sections) {
-      if (!section.containsActive) {
-        section.isBackground = true;
-        section.collapsed = shouldCollapse(section);
+    if (!isMenuTriggerNoise(element)) {
+      elements.push(formatElement(element, { fieldLabel: effectiveFieldLabel }));
+    }
+    if (!INTERACTIVE_LEAF_ROLES.has(element.role) && isClickableByAttribute(element)) {
+      for (const child of element.children) {
+        collectInteractiveElements(child, elements, subsections, depth + 1, effectiveFieldLabel);
       }
     }
+    return;
   }
-  for (const section of sections) {
-    markBackgroundSections(section.subsections);
-  }
-}
-function markMatchingSections(sections, matchedRefs) {
-  for (const section of sections) {
-    const hasDirectMatch = section.elements.some((el) => matchedRefs.has(el.ref));
-    markMatchingSections(section.subsections, matchedRefs);
-    const hasSubsectionMatch = section.subsections.some((s) => s.hasSearchMatch);
-    if (hasDirectMatch || hasSubsectionMatch) {
-      section.hasSearchMatch = true;
-      section.collapsed = false;
+  if (element.role === "heading" || STRUCTURAL_ROLES.has(element.role) || element.role === "grid" || element.role === "treegrid" || element.role === "table" && !isWidgetTable(element)) {
+    const section = buildSection(element, depth);
+    if (section) {
+      subsections.push(section);
     }
+    return;
   }
-}
-var DIALOG_ROLES = /* @__PURE__ */ new Set(["dialog", "alertdialog"]);
-function sortSectionsByFocus(sections) {
-  const dialogStack = [];
-  function processLevel(levelSections) {
-    for (const section of levelSections) {
-      const result = processLevel(section.subsections);
-      section.subsections = result;
-    }
-    const dialogs = levelSections.filter((s) => DIALOG_ROLES.has(s.role));
-    const nonDialogs = levelSections.filter((s) => !DIALOG_ROLES.has(s.role));
-    const focusedDialog = dialogs.find((d) => d.containsActive);
-    if (focusedDialog) {
-      focusedDialog.isFocused = true;
-      dialogStack.unshift(focusedDialog.heading);
-    }
-    for (const dialog of dialogs) {
-      if (!dialog.containsActive) {
-        dialogStack.push(dialog.heading);
+  const kids = element.children;
+  for (let ki = 0; ki < kids.length; ki++) {
+    const child = kids[ki];
+    if (isVisualHeading(child, kids, ki)) {
+      const headingText = getVisualHeadingText(child);
+      const sectionElements = [];
+      const sectionSubsections = [];
+      const nextBoundary = findNextSectionBoundary(kids, ki + 1);
+      for (let si = ki + 1; si < nextBoundary; si++) {
+        collectInteractiveElements(kids[si], sectionElements, sectionSubsections, depth + 2);
+      }
+      if (sectionElements.length > 0 || sectionSubsections.length > 0) {
+        const totalElements = sectionElements.length + sectionSubsections.reduce((sum, s) => sum + s.elementCount, 0);
+        subsections.push({
+          heading: headingText ?? "",
+          ref: child.ref,
+          role: "heading",
+          level: 4,
+          elements: sectionElements,
+          subsections: sectionSubsections,
+          collapsed: false,
+          containsActive: false,
+          isBackground: false,
+          isFocused: false,
+          elementCount: totalElements
+        });
+        ki = nextBoundary - 1;
+      } else {
+        collectInteractiveElements(child, elements, subsections, depth + 1);
+      }
+    } else if ((INTERACTIVE_LEAF_ROLES.has(child.role) || isClickableByAttribute(child)) && child.ref) {
+      const rawFieldLabel = findFieldLabelInContext(child, kids, ki) ?? inheritedFieldLabel;
+      const fieldLabel = shouldDropInheritedFieldLabel(child, rawFieldLabel) ? void 0 : rawFieldLabel;
+      if (!isMenuTriggerNoise(child)) {
+        if (INTERACTIVE_LEAF_ROLES.has(child.role) && isExpandedWithActionableChildren(child)) {
+          elements.push(formatElement(child, { overrideLabel: composeTriggerLabel(child), fieldLabel }));
+          collectExpandedChildren(child, elements);
+        } else {
+          elements.push(formatElement(child, { fieldLabel }));
+        }
+      }
+      if (!INTERACTIVE_LEAF_ROLES.has(child.role) && isClickableByAttribute(child)) {
+        for (const grandchild of child.children) {
+          collectInteractiveElements(grandchild, elements, subsections, depth + 1, fieldLabel);
+        }
       }
+    } else {
+      const containerLabel = resolveContainerFieldLabel(child) ?? (child.role === "table" ? findFieldLabelFromSiblings(kids, ki) : void 0) ?? inheritedFieldLabel;
+      collectInteractiveElements(child, elements, subsections, depth + 1, containerLabel);
     }
-    const sortedDialogs = dialogs.sort((a, b) => {
-      if (a.containsActive && !b.containsActive) return -1;
-      if (!a.containsActive && b.containsActive) return 1;
-      return 0;
-    });
-    return [...sortedDialogs, ...nonDialogs];
   }
-  const sorted = processLevel(sections);
-  return { sorted, dialogStack };
 }
 function buildSection(element, depth) {
   const gridInfo = detectGrid(element);
   if (gridInfo) {
-    return buildGridSection(element, gridInfo);
+    return buildGridSection(element);
   }
   const isHeading = element.role === "heading";
   const isStructural = STRUCTURAL_ROLES.has(element.role);
@@ -39356,7 +39788,6 @@ function buildSection(element, depth) {
           ref: child.ref,
           role: "heading",
           level: 4,
-          // Visual headings rendered at h6 level (4 + 2 = 6)
           elements: sectionElements,
           subsections: sectionSubsections,
           collapsed: false,
@@ -39400,192 +39831,157 @@ function buildSection(element, depth) {
   const section = {
     ref: element.ref || "",
     role: element.role,
-    heading: element.text || (isClickableByAttribute(element) ? composeLabel(element) : element.role),
+    heading: element.text || (isClickableByAttribute(element) ? getDisplayText(element) : element.role),
     level,
     elements: interactiveElements,
     subsections,
     containsActive,
     collapsed: false,
     isBackground: false,
-    // Will be set by markBackgroundSections if needed
     isFocused: false,
-    // Will be set by sortSectionsByFocus if needed
     elementCount
   };
+  deduplicateFieldLabels(interactiveElements);
   section.collapsed = shouldCollapse(section);
   return section;
 }
-function buildGridSection(element, gridInfo) {
-  return {
-    ref: element.ref || "",
-    role: element.role,
-    heading: "Grid",
-    level: 0,
-    elements: [],
-    // Grid cells formatted via gridInfo instead
-    subsections: [],
-    containsActive: gridInfo.containsActive,
-    collapsed: false,
-    // Grids use their own summarization
-    isBackground: false,
-    isFocused: false,
-    elementCount: gridInfo.totalRows * Math.max(gridInfo.columns.length, 1),
-    gridInfo
-  };
-}
-function collectInteractiveElements(element, elements, subsections, depth, inheritedFieldLabel) {
-  if ((INTERACTIVE_LEAF_ROLES.has(element.role) || isClickableByAttribute(element)) && element.ref) {
-    const effectiveFieldLabel = shouldDropInheritedFieldLabel(element, inheritedFieldLabel) ? void 0 : inheritedFieldLabel;
-    if (INTERACTIVE_LEAF_ROLES.has(element.role) && isExpandedWithActionableChildren(element)) {
-      elements.push(formatElement(element, { overrideLabel: composeTriggerLabel(element), fieldLabel: effectiveFieldLabel }));
-      collectExpandedChildren(element, elements);
-      return;
-    }
-    if (!isMenuTriggerNoise(element)) {
-      elements.push(formatElement(element, { fieldLabel: effectiveFieldLabel }));
-    }
-    if (!INTERACTIVE_LEAF_ROLES.has(element.role) && isClickableByAttribute(element)) {
-      for (const child of element.children) {
-        collectInteractiveElements(child, elements, subsections, depth + 1, effectiveFieldLabel);
+function markBackgroundSections(sections) {
+  const hasActiveSibling = sections.some((s) => s.containsActive);
+  if (hasActiveSibling) {
+    for (const section of sections) {
+      if (!section.containsActive) {
+        section.isBackground = true;
+        section.collapsed = shouldCollapse(section);
       }
     }
-    return;
   }
-  if (element.role === "heading" || STRUCTURAL_ROLES.has(element.role) || element.role === "grid" || element.role === "treegrid" || element.role === "table" && !isWidgetTable(element)) {
-    const section = buildSection(element, depth);
-    if (section) {
-      subsections.push(section);
-    }
-    return;
+  for (const section of sections) {
+    markBackgroundSections(section.subsections);
   }
-  const kids = element.children;
-  for (let ki = 0; ki < kids.length; ki++) {
-    const child = kids[ki];
-    if (isVisualHeading(child, kids, ki)) {
-      const headingText = getVisualHeadingText(child);
-      const sectionElements = [];
-      const sectionSubsections = [];
-      const nextBoundary = findNextSectionBoundary(kids, ki + 1);
-      for (let si = ki + 1; si < nextBoundary; si++) {
-        collectInteractiveElements(kids[si], sectionElements, sectionSubsections, depth + 2);
-      }
-      if (sectionElements.length > 0 || sectionSubsections.length > 0) {
-        const totalElements = sectionElements.length + sectionSubsections.reduce((sum, s) => sum + s.elementCount, 0);
-        subsections.push({
-          heading: headingText ?? "",
-          ref: child.ref,
-          role: "heading",
-          level: 4,
-          elements: sectionElements,
-          subsections: sectionSubsections,
-          collapsed: false,
-          containsActive: false,
-          isBackground: false,
-          isFocused: false,
-          elementCount: totalElements
-        });
-        ki = nextBoundary - 1;
-      } else {
-        collectInteractiveElements(child, elements, subsections, depth + 1);
-      }
-    } else if ((INTERACTIVE_LEAF_ROLES.has(child.role) || isClickableByAttribute(child)) && child.ref) {
-      const rawFieldLabel = findFieldLabelInContext(child, kids, ki) ?? inheritedFieldLabel;
-      const fieldLabel = shouldDropInheritedFieldLabel(child, rawFieldLabel) ? void 0 : rawFieldLabel;
-      if (!isMenuTriggerNoise(child)) {
-        if (INTERACTIVE_LEAF_ROLES.has(child.role) && isExpandedWithActionableChildren(child)) {
-          elements.push(formatElement(child, { overrideLabel: composeTriggerLabel(child), fieldLabel }));
-          collectExpandedChildren(child, elements);
-        } else {
-          elements.push(formatElement(child, { fieldLabel }));
-        }
-      }
-      if (!INTERACTIVE_LEAF_ROLES.has(child.role) && isClickableByAttribute(child)) {
-        for (const grandchild of child.children) {
-          collectInteractiveElements(grandchild, elements, subsections, depth + 1, fieldLabel);
-        }
+}
+function mergeFilterDropdownPairs(elements) {
+  for (let i = elements.length - 2; i >= 0; i--) {
+    const current = elements[i];
+    const next = elements[i + 1];
+    if (current.role === "generic" && current.isClickable && next.role === "img" && next.isClickable && (!next.label || next.label === "img")) {
+      if (!current.fieldLabel && next.fieldLabel) {
+        current.fieldLabel = next.fieldLabel;
       }
-    } else {
-      const containerLabel = resolveContainerFieldLabel(child) ?? (child.role === "table" ? findFieldLabelFromSiblings(kids, ki) : void 0) ?? inheritedFieldLabel;
-      collectInteractiveElements(child, elements, subsections, depth + 1, containerLabel);
+      elements.splice(i + 1, 1);
     }
   }
 }
-function formatSectionOutput(section, indent, showCollapsed) {
-  if (section.gridInfo) {
-    return formatGridOutput(section.gridInfo, indent);
+function applyFilterMerge(sections) {
+  for (const section of sections) {
+    mergeFilterDropdownPairs(section.elements);
+    applyFilterMerge(section.subsections);
   }
-  const indentStr = "  ".repeat(indent);
-  const lines = [];
-  const headingPrefix = section.level > 0 ? "#".repeat(Math.min(section.level + 2, 6)) + " " : "";
-  const refPart = section.ref ? ` [${section.ref}]` : "";
-  const focusedPart = section.isFocused ? " [FOCUSED]" : "";
-  const backgroundPart = section.isBackground ? " [BACKGROUND]" : "";
-  const activePart = section.containsActive && !section.isFocused ? " \u2190 ACTIVE" : "";
-  const headerLine = `${indentStr}${headingPrefix}${section.heading}${refPart}${focusedPart}${backgroundPart}${activePart}`;
-  lines.push(headerLine);
-  if (section.collapsed && !showCollapsed) {
-    if (section.isBackground) {
-      if (section.ref) {
-        lines.push(`${indentStr}  (${section.elementCount} elements - use expand="${section.ref}" to see content)`);
-      } else {
-        lines.push(`${indentStr}  (${section.elementCount} elements)`);
-      }
-      return lines.join("\n");
+}
+function buildSectionTree(elements) {
+  const sections = [];
+  for (const element of elements) {
+    const section = buildSection(element, 0);
+    if (section) {
+      sections.push(section);
     }
-    const MAX_DIRECT_ELEMENTS = 4;
-    const previewElements = section.elements.slice(0, MAX_DIRECT_ELEMENTS);
-    const remainingDirectCount = section.elements.length - previewElements.length;
-    for (const el of previewElements) {
-      lines.push(formatElementLine(el, indent + 1));
+  }
+  markBackgroundSections(sections);
+  applyFilterMerge(sections);
+  return sections;
+}
+function markMatchingSections(sections, matchedRefs) {
+  for (const section of sections) {
+    const hasDirectMatch = section.elements.some((el) => matchedRefs.has(el.ref)) || (section.gridInfo ? Array.from(matchedRefs).some((ref) => gridContainsRef(section.gridInfo, ref)) : false);
+    markMatchingSections(section.subsections, matchedRefs);
+    const hasSubsectionMatch = section.subsections.some((s) => s.hasSearchMatch);
+    if (hasDirectMatch || hasSubsectionMatch) {
+      section.hasSearchMatch = true;
+      section.collapsed = false;
     }
-    if (remainingDirectCount > 0) {
-      lines.push(`${indentStr}  ... +${remainingDirectCount} more elements`);
+  }
+}
+function sortSectionsByFocus(sections) {
+  const dialogStack = [];
+  function processLevel(levelSections) {
+    for (const section of levelSections) {
+      section.subsections = processLevel(section.subsections);
     }
-    for (const subsection of section.subsections) {
-      lines.push(`${indentStr}  ${formatSubsectionSummary(subsection)}`);
+    const dialogs = levelSections.filter((s) => DIALOG_ROLES.has(s.role));
+    const nonDialogs = levelSections.filter((s) => !DIALOG_ROLES.has(s.role));
+    const focusedDialog = dialogs.find((d) => d.containsActive);
+    if (focusedDialog) {
+      focusedDialog.isFocused = true;
+      dialogStack.unshift(focusedDialog.heading);
     }
-    if (section.ref && (section.elements.length > MAX_DIRECT_ELEMENTS || section.subsections.length > 0)) {
-      lines.push(`${indentStr}  (use expand="${section.ref}" to see all)`);
+    for (const dialog of dialogs) {
+      if (!dialog.containsActive) {
+        dialogStack.push(dialog.heading);
+      }
     }
-    return lines.join("\n");
-  }
-  for (const el of section.elements) {
-    lines.push(formatElementLine(el, indent + 1));
+    const sortedDialogs = dialogs.sort((a, b) => {
+      if (a.containsActive && !b.containsActive) return -1;
+      if (!a.containsActive && b.containsActive) return 1;
+      return 0;
+    });
+    return [...sortedDialogs, ...nonDialogs];
   }
-  for (const subsection of section.subsections) {
-    const subsectionOutput = formatSectionOutput(subsection, indent + 1, showCollapsed);
-    if (subsectionOutput) {
-      lines.push("");
-      lines.push(subsectionOutput);
+  const sorted = processLevel(sections);
+  return { sorted, dialogStack };
+}
+function expandSectionByRef(sections, targetRef) {
+  for (const section of sections) {
+    if (section.ref === targetRef) {
+      section.collapsed = false;
+      return true;
+    }
+    if (expandSectionByRef(section.subsections, targetRef)) {
+      return true;
     }
   }
-  return lines.join("\n");
+  return false;
 }
-function collectAllElementsFlat(section) {
-  const elements = [...section.elements];
-  for (const subsection of section.subsections) {
-    elements.push(...collectAllElementsFlat(subsection));
+function findSectionByRef(sections, targetRef) {
+  for (const section of sections) {
+    if (section.ref === targetRef) {
+      return section;
+    }
+    const found = findSectionByRef(section.subsections, targetRef);
+    if (found) {
+      return found;
+    }
   }
-  return elements;
+  return null;
 }
-function formatSubsectionSummary(subsection) {
-  const refPart = subsection.ref ? ` [${subsection.ref}]` : "";
-  if (subsection.gridInfo) {
-    const colInfo = subsection.gridInfo.columns.length > 0 ? `${subsection.gridInfo.columns.length} columns` : "unknown columns";
-    return `GRID${refPart}: ${subsection.gridInfo.totalRows} rows, ${colInfo}`;
+
+// ../browser-core/src/snapshot-formatter-render.ts
+var COLOR_NAMES = [
+  "red",
+  "green",
+  "blue",
+  "yellow",
+  "magenta",
+  "cyan",
+  "orange",
+  "purple",
+  "teal",
+  "pink"
+];
+function findActiveElement(elements) {
+  let deepestActive = null;
+  function findDeepest(element) {
+    for (const child of element.children) {
+      findDeepest(child);
+    }
+    if (element.attributes["active"] !== void 0 || element.rawLine.includes("[active]")) {
+      if (!deepestActive) {
+        deepestActive = element;
+      }
+    }
   }
-  const allElements = collectAllElementsFlat(subsection);
-  const elementNames = allElements.map((el) => el.label || el.name || el.role).filter(Boolean);
-  const heading = subsection.heading || subsection.role;
-  if (elementNames.length === 0) {
-    return `${heading}${refPart}`;
+  for (const element of elements) {
+    findDeepest(element);
   }
-  const MAX_PREVIEW_NAMES = 3;
-  const previewNames = elementNames.slice(0, MAX_PREVIEW_NAMES);
-  const remainingCount = elementNames.length - previewNames.length;
-  const namesList = previewNames.join(", ");
-  const moreNote = remainingCount > 0 ? `... +${remainingCount} more` : "";
-  return `${heading}${refPart}: ${namesList}${moreNote}`;
+  return deepestActive;
 }
 function formatElementLine(el, indent) {
   const indentStr = "  ".repeat(indent);
@@ -39637,23 +40033,102 @@ function formatElementLine(el, indent) {
   }
   return indentStr + parts.join(" ");
 }
-var COLOR_NAMES = [
-  "red",
-  "green",
-  "blue",
-  "yellow",
-  "magenta",
-  "cyan",
-  "orange",
-  "purple",
-  "teal",
-  "pink"
-];
+function collectAllElementsFlat(section) {
+  const elements = [...section.elements];
+  for (const subsection of section.subsections) {
+    elements.push(...collectAllElementsFlat(subsection));
+  }
+  return elements;
+}
+function formatSubsectionSummary(subsection) {
+  const refPart = subsection.ref ? ` [${subsection.ref}]` : "";
+  if (subsection.gridInfo) {
+    const colInfo = subsection.gridInfo.columns.length > 0 ? `${subsection.gridInfo.columns.length} columns` : "unknown columns";
+    return `GRID${refPart}: ${subsection.gridInfo.totalRows} rows, ${colInfo}`;
+  }
+  const allElements = collectAllElementsFlat(subsection);
+  const elementNames = allElements.map((el) => el.label || el.name || el.role).filter(Boolean);
+  const heading = subsection.heading || subsection.role;
+  if (elementNames.length === 0) {
+    return `${heading}${refPart}`;
+  }
+  const MAX_PREVIEW_NAMES = 3;
+  const previewNames = elementNames.slice(0, MAX_PREVIEW_NAMES);
+  const remainingCount = elementNames.length - previewNames.length;
+  const namesList = previewNames.join(", ");
+  const moreNote = remainingCount > 0 ? `... +${remainingCount} more` : "";
+  return `${heading}${refPart}: ${namesList}${moreNote}`;
+}
+function formatSectionOutput(section, indent, showCollapsed) {
+  if (section.gridInfo) {
+    return formatGridOutput(section.gridInfo, indent);
+  }
+  const indentStr = "  ".repeat(indent);
+  const lines = [];
+  const headingPrefix = section.level > 0 ? "#".repeat(Math.min(section.level + 2, 6)) + " " : "";
+  const refPart = section.ref ? ` [${section.ref}]` : "";
+  const focusedPart = section.isFocused ? " [FOCUSED]" : "";
+  const backgroundPart = section.isBackground ? " [BACKGROUND]" : "";
+  const activePart = section.containsActive && !section.isFocused ? " \u2190 ACTIVE" : "";
+  lines.push(`${indentStr}${headingPrefix}${section.heading}${refPart}${focusedPart}${backgroundPart}${activePart}`);
+  if (section.collapsed && !showCollapsed) {
+    if (section.isBackground) {
+      if (section.ref) {
+        lines.push(`${indentStr}  (${section.elementCount} elements - use expand="${section.ref}" to see content)`);
+      } else {
+        lines.push(`${indentStr}  (${section.elementCount} elements)`);
+      }
+      return lines.join("\n");
+    }
+    const MAX_DIRECT_ELEMENTS = 4;
+    const previewElements = section.elements.slice(0, MAX_DIRECT_ELEMENTS);
+    const remainingDirectCount = section.elements.length - previewElements.length;
+    for (const el of previewElements) {
+      lines.push(formatElementLine(el, indent + 1));
+    }
+    if (remainingDirectCount > 0) {
+      lines.push(`${indentStr}  ... +${remainingDirectCount} more elements`);
+    }
+    for (const subsection of section.subsections) {
+      lines.push(`${indentStr}  ${formatSubsectionSummary(subsection)}`);
+    }
+    if (section.ref && (section.elements.length > MAX_DIRECT_ELEMENTS || section.subsections.length > 0)) {
+      lines.push(`${indentStr}  (use expand="${section.ref}" to see all)`);
+    }
+    return lines.join("\n");
+  }
+  for (const el of section.elements) {
+    lines.push(formatElementLine(el, indent + 1));
+  }
+  for (const subsection of section.subsections) {
+    const subsectionOutput = formatSectionOutput(subsection, indent + 1, showCollapsed);
+    if (subsectionOutput) {
+      lines.push("");
+      lines.push(subsectionOutput);
+    }
+  }
+  return lines.join("\n");
+}
+function countRenderedElements(sections) {
+  let count = 0;
+  for (const section of sections) {
+    count += section.elements.length;
+    if (section.gridInfo) {
+      count += countRenderedGridItems(section.gridInfo);
+    }
+    count += countRenderedElements(section.subsections);
+  }
+  return count;
+}
+function countTotalSections(sections) {
+  let count = sections.length;
+  for (const section of sections) {
+    count += countTotalSections(section.subsections);
+  }
+  return count;
+}
 function generateFrontmatter(elementCount, sectionCount, activeElement, dialogStack, searchMatches, totalMatchCount, snapshotFilePath, probeResult, currentTime, capturedToasts) {
-  const activeLabel = activeElement ? normalizeIconLabelText(
-    activeElement.role,
-    INTERACTIVE_LEAF_ROLES.has(activeElement.role) && isExpandedWithActionableChildren(activeElement) ? composeTriggerLabel(activeElement) : activeElement.text || ""
-  ) : "";
+  const activeLabel = activeElement ? (FORM_INPUT_ROLES.has(activeElement.role) || activeElement.role === "button" || activeElement.role === "link") && (activeElement.attributes["expanded"] === "true" || activeElement.attributes["aria-expanded"] === "true") ? getDisplayText(activeElement, { overrideLabel: composeTriggerLabel(activeElement) }) : getDisplayText(activeElement) : "";
   const activeDesc = activeElement ? `${activeElement.ref} ${activeElement.role} "${activeLabel}"` : "None";
   const dialogStackLine = dialogStack.length > 0 ? `
 DIALOG STACK: ${dialogStack.join(" \u2192 ")}` : "";
@@ -39692,9 +40167,8 @@ ${toastLines.join("\n")}`;
 SEARCH RESULTS (${matchCountText}${sortNote}):
 ${matchLines.join("\n")}`;
   }
-  const INPUT_ROLES = /* @__PURE__ */ new Set(["textbox", "combobox", "searchbox", "spinbutton"]);
   let typeActionHint = "";
-  if (activeElement && INPUT_ROLES.has(activeElement.role)) {
+  if (activeElement && FORM_INPUT_ROLES.has(activeElement.role)) {
     typeActionHint = `
   - Type in active field: browser_type ref=${activeElement.ref} text="..."`;
   }
@@ -39729,20 +40203,59 @@ ACTIONS:
   - Use bash or python_execute on the FULL TREE FILE for detailed element analysis
 ---`;
 }
-function countTotalElements(sections) {
-  let count = 0;
-  for (const section of sections) {
-    count += section.elements.length;
-    count += countTotalElements(section.subsections);
+function disambiguateDuplicateLabels(sections) {
+  const elementEntries = [];
+  function collectElements(section) {
+    for (const el of section.elements) {
+      elementEntries.push({ el, sectionHeading: section.heading });
+    }
+    for (const sub of section.subsections) {
+      collectElements(sub);
+    }
   }
-  return count;
-}
-function countTotalSections(sections) {
-  let count = sections.length;
   for (const section of sections) {
-    count += countTotalSections(section.subsections);
+    collectElements(section);
+  }
+  const SKIP_LABELS = /* @__PURE__ */ new Set(["(icon)", "button", "link", "generic"]);
+  const byLabel = /* @__PURE__ */ new Map();
+  for (const entry of elementEntries) {
+    const label = entry.el.label || entry.el.name;
+    if (!label || label.length === 0) continue;
+    if (SKIP_LABELS.has(label)) continue;
+    if (!entry.el.ref) continue;
+    const existing = byLabel.get(label);
+    if (existing) {
+      existing.push(entry);
+    } else {
+      byLabel.set(label, [entry]);
+    }
+  }
+  for (const [, entries] of byLabel) {
+    if (entries.length < 2) continue;
+    const distinctSections = new Set(entries.map((e) => e.sectionHeading));
+    if (distinctSections.size > 1) {
+      for (const entry of entries) {
+        const currentLabel = entry.el.label || entry.el.name || "";
+        if (entry.el.label) {
+          entry.el.label = `${currentLabel} (in ${entry.sectionHeading})`;
+        } else if (entry.el.name) {
+          entry.el.name = `${currentLabel} (in ${entry.sectionHeading})`;
+        }
+      }
+    } else {
+      const ordinals = ["1st", "2nd", "3rd", "4th", "5th", "6th", "7th", "8th"];
+      for (let i = 0; i < entries.length; i++) {
+        const entry = entries[i];
+        const ordinal = i < ordinals.length ? ordinals[i] : `${i + 1}th`;
+        const currentLabel = entry.el.label || entry.el.name || "";
+        if (entry.el.label) {
+          entry.el.label = `${currentLabel} (${ordinal})`;
+        } else if (entry.el.name) {
+          entry.el.name = `${currentLabel} (${ordinal})`;
+        }
+      }
+    }
   }
-  return count;
 }
 function formatSemanticSnapshot(yaml, options) {
   if (!yaml || yaml.trim() === "") {
@@ -39775,10 +40288,10 @@ function formatSemanticSnapshot(yaml, options) {
     }
   }
   if (options?.probeResult?.ref) {
-    const probeRefs = /* @__PURE__ */ new Set([options.probeResult.ref]);
-    markMatchingSections(sortedSections, probeRefs);
+    markMatchingSections(sortedSections, /* @__PURE__ */ new Set([options.probeResult.ref]));
   }
-  const elementCount = countTotalElements(sortedSections);
+  disambiguateDuplicateLabels(sortedSections);
+  const elementCount = countRenderedElements(sortedSections);
   const sectionCount = countTotalSections(sortedSections);
   const lines = [];
   lines.push(
@@ -39788,7 +40301,6 @@ function formatSemanticSnapshot(yaml, options) {
       activeElement,
       dialogStack,
       sortedMatches,
-      // Use re-sorted matches with context
       options?.totalMatchCount,
       options?.snapshotFilePath,
       options?.probeResult,
@@ -39804,7 +40316,11 @@ function formatSemanticSnapshot(yaml, options) {
       lines.push("");
     }
   }
-  return lines.join("\n").trim();
+  let result = lines.join("\n").trim();
+  if (options?.offScreenRefs && options.offScreenRefs.size > 0) {
+    result = markOffScreenElements(result, options.offScreenRefs);
+  }
+  return result;
 }
 function expandSection(yaml, sectionRef) {
   if (!yaml || yaml.trim() === "") {
@@ -39818,7 +40334,7 @@ function expandSection(yaml, sectionRef) {
   const sections = buildSectionTree(elements);
   const { sorted: sortedSections, dialogStack } = sortSectionsByFocus(sections);
   expandSectionByRef(sortedSections, sectionRef);
-  const elementCount = countTotalElements(sortedSections);
+  const elementCount = countRenderedElements(sortedSections);
   const sectionCount = countTotalSections(sortedSections);
   const lines = [];
   lines.push(generateFrontmatter(elementCount, sectionCount, activeElement, dialogStack));
@@ -39832,29 +40348,26 @@ function expandSection(yaml, sectionRef) {
   }
   return lines.join("\n").trim();
 }
-function expandSectionByRef(sections, targetRef) {
-  for (const section of sections) {
-    if (section.ref === targetRef) {
-      section.collapsed = false;
-      return true;
-    }
-    if (expandSectionByRef(section.subsections, targetRef)) {
-      return true;
-    }
+function formatExpandedSectionOutput(section) {
+  const lines = [];
+  const subsectionInfo = section.subsections.length > 0 ? `, ${section.subsections.length} subsections` : "";
+  lines.push(`---`);
+  lines.push(`EXPANDED SECTION: ${section.heading} [${section.ref}]`);
+  lines.push(`Contains ${section.elementCount} elements${subsectionInfo}`);
+  lines.push(`---`);
+  lines.push("");
+  if (section.gridInfo) {
+    lines.push(formatGridOutput(section.gridInfo, 0, true));
+    return lines.join("\n").trim();
   }
-  return false;
-}
-function findSectionByRef(sections, targetRef) {
-  for (const section of sections) {
-    if (section.ref === targetRef) {
-      return section;
-    }
-    const found = findSectionByRef(section.subsections, targetRef);
-    if (found) {
-      return found;
-    }
+  for (const el of section.elements) {
+    lines.push(formatElementLine(el, 0));
   }
-  return null;
+  for (const subsection of section.subsections) {
+    lines.push("");
+    lines.push(formatSectionOutput(subsection, 0, false));
+  }
+  return lines.join("\n").trim();
 }
 function expandSectionOnly(yaml, sectionRef) {
   if (!yaml || yaml.trim() === "") {
@@ -39881,79 +40394,142 @@ Section with ref="${sectionRef}" not found in snapshot.
   targetSection.collapsed = false;
   return formatExpandedSectionOutput(targetSection);
 }
-function formatExpandedSectionOutput(section) {
-  const lines = [];
-  const subsectionInfo = section.subsections.length > 0 ? `, ${section.subsections.length} subsections` : "";
-  lines.push(`---`);
-  lines.push(`EXPANDED SECTION: ${section.heading} [${section.ref}]`);
-  lines.push(`Contains ${section.elementCount} elements${subsectionInfo}`);
-  lines.push(`---`);
-  lines.push("");
-  for (const el of section.elements) {
-    lines.push(formatElementLine(el, 0));
-  }
-  for (const subsection of section.subsections) {
-    lines.push("");
-    lines.push(formatSectionOutput(subsection, 0, false));
+function markOffScreenElements(text, offScreenRefs) {
+  if (offScreenRefs.size === 0) return text;
+  return text.replace(/\[(e\d+)\](?! \[off-screen\])/g, (match, ref) => {
+    if (offScreenRefs.has(ref)) {
+      return `[${ref}] [off-screen]`;
+    }
+    return match;
+  });
+}
+
+// ../browser-core/src/table-extractor.ts
+function extractTablesFromSnapshot(yamlOrResponse, options) {
+  const yaml = yamlOrResponse.includes("Page Snapshot:") ? extractSnapshotYaml(yamlOrResponse) : yamlOrResponse;
+  if (!yaml) return null;
+  const elements = parseSnapshot(yaml);
+  if (elements.length === 0) return null;
+  const grids = [];
+  const findGrids = (els) => {
+    for (const el of els) {
+      const grid = detectGrid(el);
+      if (grid && grid.rows.length > 0) {
+        grids.push({ grid, element: el });
+      }
+      if (!grid) {
+        findGrids(el.children);
+      }
+    }
+  };
+  findGrids(elements);
+  if (grids.length === 0) return null;
+  let target;
+  if (options?.ref) {
+    const match = grids.find((g) => g.grid.ref === options.ref);
+    if (!match) return null;
+    target = match;
+  } else {
+    target = grids.reduce(
+      (best, current) => current.grid.rows.length > best.grid.rows.length ? current : best
+    );
   }
-  return lines.join("\n").trim();
+  const { columns, rows } = gridInfoToRows(target.grid);
+  if (columns.length === 0) return null;
+  const pagination = detectPaginationInfo(elements, target.grid.ref);
+  return {
+    columns,
+    rows,
+    gridRef: target.grid.ref,
+    pagination: pagination ?? void 0
+  };
 }
-function formatGridOutput(grid, indent) {
-  const indentStr = "  ".repeat(indent);
-  const lines = [];
-  const colInfo = grid.columns.length > 0 ? `${grid.columns.length} columns` : "unknown columns";
-  lines.push(`${indentStr}GRID [${grid.ref}]: ${grid.totalRows} rows, ${colInfo}`);
-  const MAX_DISPLAY_COLUMNS = 10;
-  if (grid.columns.length > 0) {
-    const displayColumns = grid.columns.slice(0, MAX_DISPLAY_COLUMNS);
-    const colsWithRefs = displayColumns.map((c2) => `${c2.name} [${c2.ref}]`).join(", ");
-    const moreColsNote = grid.columns.length > MAX_DISPLAY_COLUMNS ? ` (+${grid.columns.length - MAX_DISPLAY_COLUMNS} more)` : "";
-    lines.push(`${indentStr}  Columns: ${colsWithRefs}${moreColsNote}`);
+function gridInfoToRows(grid) {
+  const columns = grid.columns.map((c2) => c2.name);
+  if (columns.length === 0) return { columns: [], rows: [] };
+  const columnIndex = /* @__PURE__ */ new Map();
+  for (let i = 0; i < columns.length; i++) {
+    columnIndex.set(columns[i], i);
   }
-  lines.push("");
-  const knownColumns = grid.columns.length > 0 ? new Set(grid.columns.map((c2) => c2.name)) : void 0;
-  const MAX_GRID_ROWS = 30;
-  const displayRows = grid.rows.slice(0, MAX_GRID_ROWS);
-  for (const row of displayRows) {
-    lines.push(formatGridRow(row, indent + 1, knownColumns));
+  const rows = [];
+  for (const row of grid.rows) {
+    const values = new Array(columns.length).fill("");
+    for (const cell of row.cells) {
+      const idx = columnIndex.get(cell.column);
+      if (idx !== void 0) {
+        values[idx] = cleanCellValue(cell.value, cell.gridcellLabel);
+      }
+    }
+    rows.push(values);
   }
-  if (grid.rows.length > MAX_GRID_ROWS) {
-    lines.push(`${indentStr}  ... and ${grid.rows.length - MAX_GRID_ROWS} more rows (use expand="${grid.ref}" to see all)`);
+  return { columns, rows };
+}
+var SVG_ARTIFACT_PATTERN = /^Styled\(svg\)$/i;
+function cleanCellValue(value, gridcellLabel) {
+  if (!value || SVG_ARTIFACT_PATTERN.test(value)) {
+    if (gridcellLabel) {
+      return gridcellLabel.replace(/\s*Styled\(svg\)\s*/gi, "").trim();
+    }
+    return "";
   }
-  return lines.join("\n");
+  return value;
 }
-function formatGridRow(row, indent, knownColumns) {
-  const indentStr = "  ".repeat(indent);
-  if (row.expandedContent) {
-    const parts = [];
-    if (row.expandedContent.labels.length > 0) {
-      parts.push(row.expandedContent.labels.join(", "));
+function formatCSVWithFrontmatter(columns, rows, _options) {
+  const lines = [];
+  lines.push(columns.map(escapeCSVField).join(","));
+  for (const row of rows) {
+    lines.push(row.map(escapeCSVField).join(","));
+  }
+  return lines.join("\n") + "\n";
+}
+function appendRowsToCSV(existingCSV, newRows, columns, _options) {
+  const existingLines = existingCSV.split("\n").filter((l) => l.trim() !== "");
+  const dataLines = [];
+  let headerLine = "";
+  for (const line of existingLines) {
+    if (line.startsWith("#")) continue;
+    if (!headerLine) {
+      headerLine = line;
+      continue;
     }
-    for (const btn of row.expandedContent.buttons) {
-      parts.push(`${btn.label} [${btn.ref}]`);
+    dataLines.push(line);
+  }
+  const existingRowSet = new Set(dataLines);
+  const newRowStrings = newRows.map((row) => row.map(escapeCSVField).join(","));
+  const addedRows = [];
+  for (const rowStr of newRowStrings) {
+    if (!existingRowSet.has(rowStr)) {
+      addedRows.push(rowStr);
+      existingRowSet.add(rowStr);
     }
-    return `${indentStr}  \u21B3 Expanded [${row.ref}]: ${parts.join(" | ")}`;
   }
-  const marker = row.isSelected ? "ACTIVE \u2192 Row" : "Row";
-  const actionsPrefix = row.rowActions?.length ? row.rowActions.map((a) => `[\u25B6 ${a.ref}]`).join(" ") + " " : "";
-  const cellsWithValue = row.cells.filter(
-    (c2) => c2.hasValue && (!knownColumns || knownColumns.has(c2.column))
-  );
-  if (cellsWithValue.length > 0) {
-    const cellStrs = cellsWithValue.map((c2) => {
-      if (c2.role === "checkbox") {
-        const icon = c2.value === "checked" ? "\u2611" : "\u2610";
-        return `${icon} [${c2.ref}]`;
-      }
-      if (c2.column === c2.value) {
-        return `${c2.column} [${c2.ref}]`;
+  const allDataLines = [...dataLines, ...addedRows];
+  const result = [headerLine || columns.map(escapeCSVField).join(","), ...allDataLines];
+  return result.join("\n") + "\n";
+}
+function detectPaginationInfo(elements, _gridRef) {
+  const paginationPattern = /(\d+)\s*[-–]\s*(\d+)\s+of\s+([\d,]+)/i;
+  const searchText = (els) => {
+    for (const el of els) {
+      const text = el.text || "";
+      const match = text.match(paginationPattern);
+      if (match) {
+        const total = parseInt(match[3].replace(/,/g, ""), 10);
+        return { showing: `${match[1]}-${match[2]}`, total };
       }
-      return `${c2.column} [${c2.ref}]: ${c2.value}`;
-    });
-    return `${indentStr}${actionsPrefix}${marker} [${row.ref}]: ${cellStrs.join(" | ")}`;
-  } else {
-    return `${indentStr}${actionsPrefix}${marker} [${row.ref}]: (empty row)`;
+      const childResult = searchText(el.children);
+      if (childResult) return childResult;
+    }
+    return null;
+  };
+  return searchText(elements);
+}
+function escapeCSVField(field) {
+  if (!field) return "";
+  if (field.includes(",") || field.includes('"') || field.includes("\n")) {
+    return `"${field.replace(/"/g, '""')}"`;
   }
+  return field;
 }
 
 // ../browser-core/src/snapshot-diff.ts
@@ -41007,6 +41583,42 @@ ${effectiveShowCoordinateGrid ? "Coordinate grid enabled - read coordinates from
       await fs2.writeFile(snapshotFilePath, yaml, "utf-8");
     } catch {
     }
+    let offScreenRefs;
+    try {
+      const viewportSize = this.client.getViewportSize();
+      const offScreen = await this.client.evaluate(
+        `() => {
+          const vw = ${viewportSize.width};
+          const vh = ${viewportSize.height};
+          const offscreen = [];
+          const els = document.querySelectorAll('[aria-ref]');
+          for (const el of els) {
+            const ref = el.getAttribute('aria-ref');
+            if (!ref) continue;
+            const r = el.getBoundingClientRect();
+            if (r.width === 0 && r.height === 0) continue;
+            if (r.right < 0 || r.left > vw || r.bottom < 0 || r.top > vh) {
+              offscreen.push(ref);
+            }
+          }
+          return offscreen;
+        }`,
+        { signal: this.signal }
+      );
+      if (typeof offScreen === "string") {
+        try {
+          const parsed = JSON.parse(offScreen);
+          if (Array.isArray(parsed) && parsed.length > 0) {
+            offScreenRefs = new Set(parsed);
+          }
+        } catch {
+        }
+      }
+    } catch (e) {
+      this.logger?.debug?.("[browser_snapshot] Off-screen detection failed", {
+        error: e instanceof Error ? e.message : String(e)
+      });
+    }
     const now = (/* @__PURE__ */ new Date()).toISOString();
     const semanticText = formatSemanticSnapshot(yaml, {
       searchMatches: searchMatches.length > 0 ? searchMatches : void 0,
@@ -41014,7 +41626,8 @@ ${effectiveShowCoordinateGrid ? "Coordinate grid enabled - read coordinates from
       snapshotFilePath,
       probeResult,
       currentTime: now,
-      capturedToasts: this.client.getCapturedToasts?.() ?? []
+      capturedToasts: this.client.getCapturedToasts?.() ?? [],
+      offScreenRefs
     });
     if (hasImages) {
       const resolutionNote = buildResolutionNote(
@@ -41728,7 +42341,7 @@ function getBrowserToolDefinitions() {
           },
           toRef: {
             type: "string",
-            description: "Scroll the page so this element is centered vertically in the viewport."
+            description: "Scroll the page so this element is centered in the viewport. Handles both vertical and horizontal scrolling automatically \u2014 works for grid columns that are horizontally off-screen."
           },
           x: {
             type: "number",
@@ -41898,6 +42511,136 @@ function getBrowserToolDefinitionsWithLifecycle() {
   ];
 }
 
+// ../browser-core/src/tools/dispatcher.ts
+async function dispatchBrowserTool(executor, toolName, args) {
+  switch (toolName) {
+    case "browser_navigate":
+      return executor.navigate(args.url);
+    case "browser_navigate_back":
+      return executor.navigateBack();
+    case "browser_snapshot":
+      return executor.snapshot({
+        mode: args.mode,
+        expand: args.expand,
+        search: args.search,
+        showCoordinateGrid: args.showCoordinateGrid,
+        probeAt: args.probeAt
+      });
+    case "browser_screenshot":
+      return executor.screenshot({
+        fullPage: args.fullPage,
+        element: args.element,
+        ref: args.ref,
+        label: args.label,
+        returnImage: args.returnImage
+      });
+    case "browser_evaluate":
+      return executor.evaluate({
+        expression: args.function,
+        element: args.element,
+        ref: args.ref
+      });
+    case "browser_console_messages":
+      return executor.consoleMessages({
+        onlyErrors: args.onlyErrors
+      });
+    case "browser_network_requests":
+      return executor.networkRequests();
+    case "browser_click":
+      return executor.click({
+        ref: args.ref,
+        x: args.x,
+        y: args.y,
+        element: args.element,
+        doubleClick: args.doubleClick,
+        button: args.button,
+        modifiers: args.modifiers
+      });
+    case "browser_hover":
+      return executor.hover({
+        ref: args.ref,
+        element: args.element
+      });
+    case "browser_drag":
+      return executor.drag({
+        startRef: args.startRef,
+        endRef: args.endRef,
+        startElement: args.startElement,
+        endElement: args.endElement,
+        startX: args.startX,
+        startY: args.startY,
+        endX: args.endX,
+        endY: args.endY
+      });
+    case "browser_type":
+      return executor.type({
+        ref: args.ref,
+        text: args.text,
+        element: args.element,
+        submit: args.submit,
+        delay: args.delay
+      });
+    case "browser_press_key":
+      return executor.pressKey(args.key);
+    case "browser_fill_form":
+      return executor.fillForm(
+        args.fields
+      );
+    case "browser_select_option":
+      return executor.selectOption({
+        ref: args.ref,
+        value: args.value,
+        element: args.element
+      });
+    case "browser_file_upload":
+      return executor.fileUpload(args.paths);
+    case "browser_scroll":
+      return executor.scroll({
+        direction: args.direction,
+        amount: args.amount,
+        withinRef: args.withinRef,
+        toRef: args.toRef,
+        x: args.x,
+        y: args.y
+      });
+    case "browser_handle_dialog":
+      return executor.handleDialog({
+        action: args.action,
+        promptText: args.promptText
+      });
+    case "browser_dismiss_overlay":
+      return executor.dismissOverlay({
+        preferredStrategy: args.preferredStrategy
+      });
+    case "browser_wait_for":
+      return executor.waitFor({
+        timeSec: args.time,
+        text: args.text,
+        textGone: args.textGone,
+        selector: args.selector,
+        state: args.state,
+        timeout: args.timeout
+      });
+    case "browser_close":
+      return executor.close();
+    case "browser_resize":
+      return executor.resize(args.width, args.height);
+    case "browser_tabs":
+      return executor.tabs({
+        action: args.action,
+        index: args.index
+      });
+    case "browser_list_downloads":
+      return executor.listDownloads();
+    case "browser_read_download":
+      return executor.readDownload(args.downloadId);
+    case "browser_pdf_read":
+      return executor.fetchPdfText(args.url);
+    default:
+      throw new Error(`Unknown browser tool: ${toolName}`);
+  }
+}
+
 // ../browser-core/src/playwright-client.ts
 import {
   chromium as playwrightChromium
@@ -43018,6 +43761,29 @@ function appendAttributeIfMissing(line, key, value) {
   const baseLine = hasTrailingColon ? line.replace(/:\s*$/, "") : line;
   return `${baseLine} [${key}=${value}]${hasTrailingColon ? ":" : ""}`;
 }
+function findLabelFromYamlSiblings(elements, targetRef) {
+  const findParent = (els, parent2) => {
+    for (const el of els) {
+      if (el.ref === targetRef) return parent2;
+      const found = findParent(el.children, el);
+      if (found) return found;
+    }
+    return null;
+  };
+  const parent = findParent(elements, null);
+  if (!parent) return void 0;
+  const targetIdx = parent.children.findIndex((c2) => c2.ref === targetRef);
+  if (targetIdx < 0) return void 0;
+  for (let i = targetIdx - 1; i >= 0; i--) {
+    const sib = parent.children[i];
+    const sibText = sib.text?.trim();
+    if (sibText && sibText.length > 0 && sibText.length < 80 && /[a-zA-Z0-9]/.test(sibText)) {
+      if (FORM_FIELD_ROLES.has(sib.role)) continue;
+      return sibText;
+    }
+  }
+  return void 0;
+}
 async function augmentUnlabeledElements(page, yaml, logger2) {
   try {
     const elements = parseSnapshot(yaml);
@@ -43323,6 +44089,9 @@ async function augmentGridCellValues(page, yaml, logger2) {
   }
 }
 var FORM_FIELD_ROLES = /* @__PURE__ */ new Set(["textbox", "combobox", "searchbox"]);
+function splitCamelCase(name) {
+  return name.replace(/([a-z])([A-Z])/g, "$1 $2").replace(/[_-]/g, " ").replace(/\s+/g, " ").trim();
+}
 async function augmentFormFieldLabels(page, yaml, logger2) {
   try {
     const elements = parseSnapshot(yaml);
@@ -43340,16 +44109,30 @@ async function augmentFormFieldLabels(page, yaml, logger2) {
       walkForFields(el);
     }
     if (formFieldRefs.length === 0) return yaml;
-    logger2.debug("[DirectPlaywright] Augmenting form field labels", {
+    const glyphFields = formFieldRefs.filter((f) => f.text && !/[a-zA-Z0-9]/.test(f.text));
+    const displayNameIdx = yaml.indexOf("Display Name");
+    const yamlAroundDisplayName = displayNameIdx >= 0 ? yaml.slice(Math.max(0, displayNameIdx - 50), displayNameIdx + 200) : "NOT FOUND";
+    logger2.warn("[DirectPlaywright] augmentFormFieldLabels called", {
       count: formFieldRefs.length,
-      refs: formFieldRefs.slice(0, 10).map((f) => f.ref)
+      glyphCount: glyphFields.length,
+      allTexts: formFieldRefs.map((f) => `${f.ref}:${JSON.stringify(f.text)}`),
+      hasDisplayName: yaml.includes("Display Name"),
+      yamlHasGlyph: yaml.includes("\u268A"),
+      yamlAroundDisplayName
     });
     let augmented = yaml;
     for (const { ref, role, text } of formFieldRefs) {
       try {
+        const isGlyphField = text && !/[a-zA-Z0-9]/.test(text);
+        if (isGlyphField) {
+          logger2.info("[DirectPlaywright] Glyph-labeled field entering augmentation", { ref, role, text });
+        }
         const locator = page.locator(`aria-ref=${ref}`);
         const count = await locator.count();
-        if (count === 0) continue;
+        if (count === 0) {
+          if (isGlyphField) logger2.info("[DirectPlaywright] Glyph field: locator count=0, skipping", { ref });
+          continue;
+        }
         const label = await locator.first().evaluate((el) => {
           if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement || el instanceof HTMLSelectElement) {
             const labels = el.labels;
@@ -43358,6 +44141,30 @@ async function augmentFormFieldLabels(page, yaml, logger2) {
               if (labelText) return labelText;
             }
           }
+          {
+            const precedingLabels = [];
+            let prevEl = el.previousElementSibling;
+            while (prevEl) {
+              if (prevEl.tagName === "LABEL") {
+                precedingLabels.unshift(prevEl);
+              } else {
+                break;
+              }
+              prevEl = prevEl.previousElementSibling;
+            }
+            if (precedingLabels.length > 1) {
+              const selected = precedingLabels.find((l) => {
+                const cls = l.className.toLowerCase();
+                return cls.includes("selected") || cls.includes("active") || cls.includes("current") || cls.includes("checked");
+              });
+              if (selected?.textContent?.trim()) return selected.textContent.trim();
+              const first = precedingLabels[0];
+              if (first?.textContent?.trim()) return first.textContent.trim();
+            } else if (precedingLabels.length === 1) {
+              const labelText = precedingLabels[0].textContent?.trim();
+              if (labelText) return labelText;
+            }
+          }
           const labelledBy = el.getAttribute("aria-labelledby");
           if (labelledBy) {
             const labelEl = document.getElementById(labelledBy);
@@ -43365,31 +44172,101 @@ async function augmentFormFieldLabels(page, yaml, logger2) {
           }
           const ariaLabel = el.getAttribute("aria-label");
           const placeholder = el.getAttribute("placeholder");
-          if (ariaLabel && ariaLabel !== placeholder) return ariaLabel;
-          let sibling = el.previousElementSibling;
+          if (ariaLabel && ariaLabel !== placeholder && /[a-zA-Z0-9]/.test(ariaLabel)) return ariaLabel;
           let target = el;
-          for (let i = 0; i < 3 && target; i++) {
-            sibling = target.previousElementSibling;
-            if (sibling) {
+          for (let depth = 0; depth < 3 && target; depth++) {
+            let sibling = target.previousElementSibling;
+            for (let sibCount = 0; sibling && sibCount < 3; sibCount++) {
               const sibText = sibling.textContent?.trim();
               if (sibText && sibText.length > 0 && sibText.length < 80 && !sibling.querySelector("input, textarea, select, button")) {
                 return sibText;
               }
+              if (sibling.querySelector("input, textarea, select, button")) break;
+              sibling = sibling.previousElementSibling;
             }
             target = target.parentElement;
           }
           return void 0;
         });
+        if (isGlyphField) {
+          logger2.info("[DirectPlaywright] Glyph field: DOM evaluate result", { ref, label, text });
+        }
         if (label && label !== text) {
           augmented = updateElementLineByRef(
             augmented,
             ref,
             (line) => injectElementLabel(line, role, label)
           );
+          if (isGlyphField) {
+            logger2.info("[DirectPlaywright] Glyph field: injected DOM label", { ref, label });
+          }
+        }
+        const hasGlyphOnlyLabel = text && !/[a-zA-Z0-9]/.test(text);
+        if (hasGlyphOnlyLabel && (!label || label === text || !/[a-zA-Z0-9]/.test(label))) {
+          const yamlLabel = findLabelFromYamlSiblings(elements, ref);
+          logger2.info("[DirectPlaywright] YAML sibling fallback for glyph field", {
+            ref,
+            text,
+            label,
+            yamlLabel
+          });
+          if (yamlLabel) {
+            augmented = updateElementLineByRef(
+              augmented,
+              ref,
+              (line) => injectElementLabel(line, role, yamlLabel)
+            );
+          }
         }
       } catch {
       }
     }
+    try {
+      const postElements = parseSnapshot(augmented);
+      const labeledFields = [];
+      const walkForLabeled = (el) => {
+        if (FORM_FIELD_ROLES.has(el.role) && el.ref && el.text) {
+          labeledFields.push({ ref: el.ref, role: el.role, label: el.text });
+        }
+        for (const child of el.children) walkForLabeled(child);
+      };
+      for (const el of postElements) walkForLabeled(el);
+      const byLabel = /* @__PURE__ */ new Map();
+      for (const f of labeledFields) {
+        const existing = byLabel.get(f.label);
+        if (existing) {
+          existing.push({ ref: f.ref, role: f.role });
+        } else {
+          byLabel.set(f.label, [{ ref: f.ref, role: f.role }]);
+        }
+      }
+      for (const [label, fields] of byLabel) {
+        if (fields.length < 2) continue;
+        for (const field of fields) {
+          try {
+            const locator = page.locator(`aria-ref=${field.ref}`);
+            const count = await locator.count();
+            if (count === 0) continue;
+            const disambiguation = await locator.first().evaluate((el) => {
+              const placeholder = el.getAttribute("placeholder") || void 0;
+              const ariaLabel = el.getAttribute("aria-label") || void 0;
+              const name = el.getAttribute("name") || void 0;
+              return { placeholder, ariaLabel, name };
+            });
+            const disambig = disambiguation.placeholder || disambiguation.ariaLabel || (disambiguation.name ? splitCamelCase(disambiguation.name) : void 0);
+            if (disambig && disambig !== label) {
+              augmented = updateElementLineByRef(
+                augmented,
+                field.ref,
+                (line) => injectElementLabel(line, field.role, disambig)
+              );
+            }
+          } catch {
+          }
+        }
+      }
+    } catch {
+    }
     return augmented;
   } catch (err) {
     logger2.debug("[DirectPlaywright] Form field label augmentation failed", {
@@ -43594,6 +44471,148 @@ async function augmentHiddenSelectOptions(page, yaml, logger2) {
     return yaml;
   }
 }
+async function enrichModalDialogElements(page, logger2) {
+  try {
+    const enrichedCount = await page.evaluate(() => {
+      let count = 0;
+      const MAX_ENRICHMENTS = 3;
+      function shouldSkip(el) {
+        if (el.getAttribute("role") === "dialog" || el.getAttribute("role") === "alertdialog") return true;
+        if (el.getAttribute("data-enriched-dialog") === "true") return true;
+        return false;
+      }
+      function isVisible(el) {
+        const style = window.getComputedStyle(el);
+        if (style.display === "none" || style.visibility === "hidden") return false;
+        if (el instanceof HTMLElement && el.offsetWidth === 0 && el.offsetHeight === 0) return false;
+        return true;
+      }
+      function enrichAsDialog(el) {
+        if (count >= MAX_ENRICHMENTS) return;
+        if (shouldSkip(el)) return;
+        if (!isVisible(el)) return;
+        el.setAttribute("role", "dialog");
+        const heading = el.querySelector("h1, h2, h3, h4, h5, h6");
+        if (heading?.textContent?.trim()) {
+          el.setAttribute("aria-label", heading.textContent.trim());
+        }
+        el.setAttribute("data-enriched-dialog", "true");
+        count++;
+      }
+      function hasInteractiveContent(el) {
+        return el.querySelector('input, textarea, select, button, a[href], [role="button"], [role="link"], [role="textbox"], [role="combobox"]') !== null;
+      }
+      const CLASS_PATTERNS = [
+        /\bmodal(?![-_]?(backdrop|mask|overlay|fade|bg|background))\b/i,
+        /\bdialog\b/i,
+        /\bpopup\b/i,
+        /\blightbox\b/i,
+        /\bdrawer\b/i
+      ];
+      const FRAMEWORK_SELECTORS = [
+        ".cdk-overlay-pane",
+        ".mat-dialog-container",
+        ".mat-mdc-dialog-container",
+        ".ui-dialog",
+        ".modal-dialog",
+        ".ant-modal-content",
+        ".el-dialog",
+        ".v-dialog",
+        ".p-dialog"
+      ];
+      for (const selector of FRAMEWORK_SELECTORS) {
+        if (count >= MAX_ENRICHMENTS) break;
+        const els = document.querySelectorAll(selector);
+        for (const el of els) {
+          if (count >= MAX_ENRICHMENTS) break;
+          if (hasInteractiveContent(el)) {
+            enrichAsDialog(el);
+          }
+        }
+      }
+      if (count < MAX_ENRICHMENTS) {
+        const allElements = document.querySelectorAll("*");
+        for (const el of allElements) {
+          if (count >= MAX_ENRICHMENTS) break;
+          const className = el.className;
+          if (typeof className !== "string") continue;
+          if (CLASS_PATTERNS.some((pattern) => pattern.test(className))) {
+            if (hasInteractiveContent(el)) {
+              enrichAsDialog(el);
+            }
+          }
+        }
+      }
+      if (count < MAX_ENRICHMENTS) {
+        const allFixed = document.querySelectorAll("*");
+        for (const el of allFixed) {
+          if (count >= MAX_ENRICHMENTS) break;
+          if (!(el instanceof HTMLElement)) continue;
+          const style = window.getComputedStyle(el);
+          if (style.position !== "fixed" && style.position !== "absolute") continue;
+          const rect = el.getBoundingClientRect();
+          const viewportW = window.innerWidth;
+          const viewportH = window.innerHeight;
+          const coversViewport = rect.width >= viewportW * 0.8 && rect.height >= viewportH * 0.8;
+          if (!coversViewport) continue;
+          const bg = style.backgroundColor;
+          const opacity = parseFloat(style.opacity);
+          const isSemiTransparent = bg.includes("rgba") && !bg.includes("rgba(0, 0, 0, 0)") && bg.match(/,\s*([\d.]+)\)/) && parseFloat(bg.match(/,\s*([\d.]+)\)/)?.[1] || "1") < 1 || opacity < 1 && opacity > 0;
+          if (!isSemiTransparent) continue;
+          const nextSib = el.nextElementSibling;
+          if (nextSib && nextSib instanceof HTMLElement && isVisible(nextSib) && hasInteractiveContent(nextSib)) {
+            enrichAsDialog(nextSib);
+            continue;
+          }
+          if (el.parentElement) {
+            const backdropZ = parseInt(style.zIndex) || 0;
+            for (const sibling of el.parentElement.children) {
+              if (sibling === el || !(sibling instanceof HTMLElement)) continue;
+              const sibStyle = window.getComputedStyle(sibling);
+              const sibZ = parseInt(sibStyle.zIndex) || 0;
+              if (sibZ > backdropZ && isVisible(sibling) && hasInteractiveContent(sibling)) {
+                enrichAsDialog(sibling);
+                break;
+              }
+            }
+          }
+        }
+      }
+      if (count < MAX_ENRICHMENTS) {
+        const allElements = document.querySelectorAll("*");
+        for (const el of allElements) {
+          if (count >= MAX_ENRICHMENTS) break;
+          if (!(el instanceof HTMLElement)) continue;
+          if (el.getAttribute("data-enriched-dialog") === "true") continue;
+          if (el.getAttribute("role") === "dialog" || el.getAttribute("role") === "alertdialog") continue;
+          const style = window.getComputedStyle(el);
+          if (style.position !== "fixed" && style.position !== "absolute") continue;
+          const zIndex = parseInt(style.zIndex) || 0;
+          if (zIndex <= 100) continue;
+          if (!isVisible(el)) continue;
+          const rect = el.getBoundingClientRect();
+          if (rect.width < 200 || rect.height < 200) continue;
+          const viewportW = window.innerWidth;
+          const viewportH = window.innerHeight;
+          if (rect.width >= viewportW * 0.95 && rect.height >= viewportH * 0.95) continue;
+          if (hasInteractiveContent(el)) {
+            enrichAsDialog(el);
+          }
+        }
+      }
+      return count;
+    });
+    if (enrichedCount > 0) {
+      logger2.debug("[DirectPlaywright] Enriched modal dialog elements", {
+        count: enrichedCount
+      });
+    }
+  } catch (err) {
+    logger2.debug("[DirectPlaywright] Modal dialog enrichment failed", {
+      error: errorMessage2(err)
+    });
+  }
+}
 async function enrichInteractiveSVGElements(page, logger2) {
   try {
     const enrichedCount = await page.evaluate(() => {
@@ -43989,7 +45008,8 @@ var PlaywrightClient = class _PlaywrightClient {
       extensions,
       highlightInteractions,
       cursorOverlay,
-      extraHTTPHeaders
+      extraHTTPHeaders,
+      httpCredentials
     } = options;
     const resolvedBrowserMode = browserMode ?? "headless";
     const resolvedViewport = viewport ?? DEFAULT_VIEWPORT;
@@ -44002,7 +45022,8 @@ var PlaywrightClient = class _PlaywrightClient {
       extensions,
       highlightInteractions,
       cursorOverlay,
-      extraHTTPHeaders
+      extraHTTPHeaders,
+      httpCredentials
     };
     this.storageStatePath = storageStatePath;
     this.pageClosedIntentionally = false;
@@ -44075,6 +45096,9 @@ var PlaywrightClient = class _PlaywrightClient {
         if (extraHTTPHeaders && Object.keys(extraHTTPHeaders).length > 0) {
           contextOptions.extraHTTPHeaders = extraHTTPHeaders;
         }
+        if (httpCredentials) {
+          contextOptions.httpCredentials = httpCredentials;
+        }
         this.logger.info("[DirectPlaywright] Using pooled browser via lease", {
           leaseId: this.browserLease.leaseId,
           browserId: this.browserLease.browserId
@@ -44102,7 +45126,8 @@ var PlaywrightClient = class _PlaywrightClient {
             recordVideo,
             stealth,
             extensions,
-            extraHTTPHeaders
+            extraHTTPHeaders,
+            httpCredentials
           }),
           {
             logger: this.logger,
@@ -44121,6 +45146,9 @@ var PlaywrightClient = class _PlaywrightClient {
       const initialPageId = this._assignPageId(this.page);
       this._pageCreationTimes.set(initialPageId, now);
       this._tabFocusLog.push({ pageIndex: initialPageId, timestamp: now });
+      if (storageStatePath) {
+        await this.restoreIndexedDBFromStorageState(storageStatePath);
+      }
       this.logger.info("[DirectPlaywright] Browser connected successfully", {
         browserMode: resolvedBrowserMode,
         stealthEnabled: this.stealthEnabled,
@@ -44200,6 +45228,13 @@ var PlaywrightClient = class _PlaywrightClient {
         headerNames: Object.keys(mergedHeaders)
       });
     }
+    const resolvedHttpCredentials = options.httpCredentials ?? this.lastConnectOptions?.httpCredentials;
+    if (resolvedHttpCredentials) {
+      contextOptions.httpCredentials = resolvedHttpCredentials;
+      if (this.lastConnectOptions) {
+        this.lastConnectOptions.httpCredentials = resolvedHttpCredentials;
+      }
+    }
     if (nextStorageStatePath) {
       try {
         await fs4.access(nextStorageStatePath);
@@ -44251,6 +45286,9 @@ var PlaywrightClient = class _PlaywrightClient {
     const swapPageId = this._assignPageId(this.page);
     this._pageCreationTimes.set(swapPageId, swapNow);
     this._tabFocusLog.push({ pageIndex: swapPageId, timestamp: swapNow });
+    if (nextStorageStatePath) {
+      await this.restoreIndexedDBFromStorageState(nextStorageStatePath);
+    }
     if (wasScreencasting && this.page && this.screencastHandler) {
       await this.startScreencast(this.screencastHandler);
     }
@@ -44269,7 +45307,8 @@ var PlaywrightClient = class _PlaywrightClient {
       recordVideo,
       stealth,
       extensions,
-      extraHTTPHeaders
+      extraHTTPHeaders,
+      httpCredentials
     } = options;
     const resolvedViewport = viewport ?? DEFAULT_VIEWPORT;
     const useStealthMode = stealth === true || typeof stealth === "object" && stealth.enabled;
@@ -44300,6 +45339,10 @@ var PlaywrightClient = class _PlaywrightClient {
         headerNames: Object.keys(extraHTTPHeaders)
       });
     }
+    if (httpCredentials) {
+      contextOptions.httpCredentials = httpCredentials;
+      this.logger.info("[DirectPlaywright] HTTP Basic Authentication configured");
+    }
     if (storageStatePath) {
       try {
         await fs4.access(storageStatePath);
@@ -44365,6 +45408,52 @@ var PlaywrightClient = class _PlaywrightClient {
     );
     return { browser, context };
   }
+  /**
+   * Read the storage state file, check for IndexedDB data, and restore it.
+   * IndexedDB is origin-scoped, so we navigate to the appropriate origin
+   * before writing data, then navigate back.
+   */
+  async restoreIndexedDBFromStorageState(storageStatePath) {
+    try {
+      const raw = await fs4.readFile(storageStatePath, "utf-8");
+      const parsed = JSON.parse(raw);
+      if (!parsed.indexedDB || !parsed.indexedDB.databases || parsed.indexedDB.databases.length === 0) {
+        return;
+      }
+      const page = this.page;
+      if (!page || page.isClosed()) return;
+      let targetOrigin = null;
+      if (parsed.origins && parsed.origins.length > 0) {
+        targetOrigin = parsed.origins[0].origin;
+      }
+      if (!targetOrigin) {
+        const cookies = parsed.cookies;
+        if (cookies && cookies.length > 0) {
+          const domain = cookies[0].domain.replace(/^\./, "");
+          targetOrigin = `https://${domain}`;
+        }
+      }
+      if (!targetOrigin) {
+        this.logger.debug("[DirectPlaywright] No origin found for IndexedDB restoration, skipping");
+        return;
+      }
+      this.logger.debug("[DirectPlaywright] Restoring IndexedDB data", {
+        targetOrigin,
+        databaseCount: parsed.indexedDB.databases.length,
+        databaseNames: parsed.indexedDB.databases.map((db) => db.name)
+      });
+      await page.goto(targetOrigin, { waitUntil: "commit", timeout: 15e3 });
+      await restoreIndexedDB(page, parsed.indexedDB);
+      this.logger.info("[DirectPlaywright] IndexedDB data restored successfully", {
+        databaseCount: parsed.indexedDB.databases.length
+      });
+    } catch (err) {
+      this.logger.warn("[DirectPlaywright] Failed to restore IndexedDB from storage state", {
+        error: err instanceof Error ? err.message : String(err),
+        storageStatePath
+      });
+    }
+  }
   /**
    * Resolve a working Chromium executable path, handling version mismatches
    * between the Playwright version bundled in this package and the browser
@@ -45222,17 +46311,42 @@ Use coordinate-based clicking (x, y) to interact with elements visible in the sc
         const locator = await this.resolveRef(toRef);
         const box = await locator.boundingBox();
         if (box) {
+          const viewportSize = this.getViewportSize();
           const elementCenterY = box.y + box.height / 2;
-          const viewportHeight = 1080;
-          const viewportCenterY = viewportHeight / 2;
+          const viewportCenterY = viewportSize.height / 2;
           const scrollY = elementCenterY - viewportCenterY;
+          const elementCenterX = box.x + box.width / 2;
+          const viewportCenterX = viewportSize.width / 2;
+          const boxRight = box.x + box.width;
+          const needsHorizontalScroll = boxRight < 0 || box.x > viewportSize.width || elementCenterX < 0 || elementCenterX > viewportSize.width;
+          const scrollX = needsHorizontalScroll ? elementCenterX - viewportCenterX : 0;
           this.logger.debug("[DirectPlaywright] Scrolling to center element", {
             toRef,
             elementCenterY,
             viewportCenterY,
-            scrollY
+            scrollY,
+            elementCenterX,
+            scrollX,
+            needsHorizontalScroll
           });
-          await page.evaluate(`window.scrollBy(0, ${scrollY})`);
+          await page.evaluate(`window.scrollBy(${scrollX}, ${scrollY})`);
+          if (needsHorizontalScroll) {
+            await page.evaluate((ref) => {
+              const el = document.querySelector(`[aria-ref="${ref}"]`);
+              if (!el) return;
+              let parent = el.parentElement;
+              for (let i = 0; i < 10 && parent; i++) {
+                if (parent.scrollWidth > parent.clientWidth) {
+                  const elRect = el.getBoundingClientRect();
+                  const parentRect = parent.getBoundingClientRect();
+                  const targetScrollLeft = parent.scrollLeft + (elRect.left - parentRect.left) - parentRect.width / 2 + elRect.width / 2;
+                  parent.scrollLeft = Math.max(0, targetScrollLeft);
+                  break;
+                }
+                parent = parent.parentElement;
+              }
+            }, toRef);
+          }
         } else {
           this.logger.warn("[DirectPlaywright] No bounding box, using scrollIntoViewIfNeeded", {
             toRef
@@ -45586,7 +46700,25 @@ Use coordinate-based clicking (x, y) to interact with elements visible in the sc
     this.logger.debug("[DirectPlaywright] Getting storage state", {
       method: opts?.method ?? "playwright"
     });
-    return await context.storageState();
+    const playwrightState = await context.storageState();
+    try {
+      const page = await this.getPage();
+      const indexedDB2 = await extractIndexedDB(page);
+      if (indexedDB2) {
+        this.logger.info("[DirectPlaywright] Extracted IndexedDB data", {
+          databaseCount: indexedDB2.databases.length,
+          databaseNames: indexedDB2.databases.map((db) => db.name)
+        });
+        return { ...playwrightState, indexedDB: indexedDB2 };
+      } else {
+        this.logger.debug("[DirectPlaywright] No IndexedDB databases found on current page");
+      }
+    } catch (err) {
+      this.logger.warn("[DirectPlaywright] Failed to extract IndexedDB, saving without it", {
+        error: err instanceof Error ? err.message : String(err)
+      });
+    }
+    return playwrightState;
   }
   async getCurrentUrl(_opts) {
     return (await this.getPage()).url();
@@ -45833,6 +46965,7 @@ Use coordinate-based clicking (x, y) to interact with elements visible in the sc
     }
     await this.enrichInteractiveSVGElements(page);
     await this.enrichHiddenClickableElements(page);
+    await this.enrichModalDialogElements(page);
     let snapshot;
     const maxRetries = 3;
     for (let attempt = 1; attempt <= maxRetries; attempt++) {
@@ -45961,6 +47094,13 @@ Use coordinate-based clicking (x, y) to interact with elements visible in the sc
   async enrichHiddenClickableElements(page) {
     await enrichHiddenClickableElements(page, this.logger);
   }
+  /**
+   * Enrich positioned overlays that look like modals but lack `role="dialog"`.
+   * Injects `role="dialog"` and `aria-label` so the agent recognizes them.
+   */
+  async enrichModalDialogElements(page) {
+    await enrichModalDialogElements(page, this.logger);
+  }
   /**
    * Resolve a ref to a Playwright locator using the internal aria-ref selector.
    * This is the same mechanism MCP uses to resolve refs.
@@ -46993,6 +48133,8 @@ export {
   CursorOverlay,
   setCdpScreencastLogger,
   CdpScreencastManager,
+  extractIndexedDB,
+  restoreIndexedDB,
   setSnapshotAnalyzerLogger,
   extractSnapshotYaml,
   parseSnapshot,
@@ -47007,22 +48149,27 @@ export {
   normalizeIconLabelText,
   normalizeSearchText,
   extractDataValue,
+  extractCellText,
+  extractGridCell,
+  reconcileCellColumn,
+  detectGrid,
+  formatGridOutput,
+  formatGridRow,
   findRelevanceScope,
   searchElements,
   populateSearchContext,
   sortMatchesByContext,
-  detectGrid,
-  extractCellText,
-  extractGridCell,
-  reconcileCellColumn,
-  findActiveElement,
   buildSectionTree,
   markMatchingSections,
+  findActiveElement,
   formatSemanticSnapshot,
   expandSection,
   expandSectionOnly,
-  formatGridOutput,
-  formatGridRow,
+  extractTablesFromSnapshot,
+  gridInfoToRows,
+  formatCSVWithFrontmatter,
+  appendRowsToCSV,
+  detectPaginationInfo,
   captureSnapshotState,
   compareSnapshots,
   hasDiffChanges,
@@ -47042,6 +48189,7 @@ export {
   getBrowserToolDefinitions,
   BROWSER_LIFECYCLE_TOOLS,
   getBrowserToolDefinitionsWithLifecycle,
+  dispatchBrowserTool,
   extractSemanticHint,
   PlaywrightClient
 };
@@ -47324,4 +48472,4 @@ playwright-extra/dist/index.esm.js:
    * @license MIT
    *)
 */
-//# sourceMappingURL=chunk-FK3EZADZ.js.map
+//# sourceMappingURL=chunk-MSMC6UXW.js.map