agent-web-interface 4.3.0 → 4.5.0

package/dist/src/observation/eid-linker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eid-linker.d.ts","sourceRoot":"","sources":["../../../src/observation/eid-linker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAClG,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAOpE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,gDAAgD;IAChD,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IAEf,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IAEjB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf;AA2GD;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,iBAAiB,EAC/B,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE,gBAAqB,GAC7B,gBAAgB,CAkDlB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,CAWpF;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,cAAc,EAC3B,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,EACxC,OAAO,GAAE,gBAAqB,GAC7B,YAAY,GAAG,SAAS,CAgC1B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,cAAc,GAAG,QAAQ,EAAE,CAyBzE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,cAAc,EAC3B,IAAI,EAAE,YAAY,EAClB,OAAO,GAAE,gBAAqB,GAC7B,MAAM,CAkDR;AA0CD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,YAAY,GAAG,YAAY,EAAE,CAE/E;AAgDD;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,YAAY,EACzB,gBAAgB,EAAE,YAAY,EAAE,EAChC,QAAQ,EAAE,eAAe,GACxB,gBAAgB,EAAE,CAuBpB"}
+{"version":3,"file":"eid-linker.d.ts","sourceRoot":"","sources":["../../../src/observation/eid-linker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAClG,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAQpE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,gDAAgD;IAChD,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IAEf,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IAEjB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf;AA2GD;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,iBAAiB,EAC/B,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE,gBAAqB,GAC7B,gBAAgB,CAkDlB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,CAWpF;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,cAAc,EAC3B,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,EACxC,OAAO,GAAE,gBAAqB,GAC7B,YAAY,GAAG,SAAS,CAgC1B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,cAAc,GAAG,QAAQ,EAAE,CAyBzE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,cAAc,EAC3B,IAAI,EAAE,YAAY,EAClB,OAAO,GAAE,gBAAqB,GAC7B,MAAM,CAkDR;AAmBD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,YAAY,GAAG,YAAY,EAAE,CAE/E;AAgDD;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,YAAY,EACzB,gBAAgB,EAAE,YAAY,EAAE,EAChC,QAAQ,EAAE,eAAe,GACxB,gBAAgB,EAAE,CAuBpB"}

package/dist/src/observation/eid-linker.js

@@ -8,6 +8,7 @@
  * - Role matching
  * - Label/text fuzzy matching
  */
+import { isInteractiveKind } from '../state/actionables-filter.js';
 import { fuzzyTokensMatch, tokenizeForMatching } from '../lib/text-utils.js';
 // ============================================================================
 // Scoring Constants
@@ -287,27 +288,6 @@ export function computeMatchScore(observation, node, options = {}) {
 // ============================================================================
 /** Maximum number of children to extract per observation */
 const MAX_OBSERVATION_CHILDREN = 5;
-/** Interactive node kinds that qualify as observation children */
-const INTERACTIVE_KINDS = [
-    'button',
-    'link',
-    'input',
-    'textarea',
-    'select',
-    'combobox',
-    'checkbox',
-    'radio',
-    'switch',
-    'slider',
-    'tab',
-    'menuitem',
-];
-/**
- * Check if a node kind is interactive (actionable).
- */
-function isInteractiveKind(kind) {
-    return INTERACTIVE_KINDS.includes(kind);
-}
 /**
  * Check if a node qualifies as an extractable child (interactive or heading with label).
  */

package/dist/src/observation/eid-linker.js.map

@@ -1 +1 @@
-{"version":3,"file":"eid-linker.js","sourceRoot":"","sources":["../../../src/observation/eid-linker.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"eid-linker.js","sourceRoot":"","sources":["../../../src/observation/eid-linker.ts"],"names":[],"mappings":"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"}

package/dist/src/observation/observation-accumulator.d.ts

@@ -34,7 +34,7 @@ export declare class ObservationAccumulator {
     getObservations(page: Page, actionStartTime: number): Promise<ObservationGroups>;
     /**
      * Get accumulated observations without action context.
-     * Used by capture_snapshot to report accumulated changes.
+     * Used by snapshot tool to report accumulated changes.
      */
     getAccumulatedObservations(page: Page): Promise<ObservationGroups>;
     /**

package/dist/src/observation/observation-accumulator.js

@@ -102,7 +102,7 @@ export class ObservationAccumulator {
     }
     /**
      * Get accumulated observations without action context.
-     * Used by capture_snapshot to report accumulated changes.
+     * Used by snapshot tool to report accumulated changes.
      */
     async getAccumulatedObservations(page) {
         try {

package/dist/src/observation/observer-script.d.ts

@@ -15,5 +15,5 @@
  *
  * The script is returned as a string for page.evaluate().
  */
-export declare const OBSERVATION_OBSERVER_SCRIPT = "\n(function() {\n  // Prevent double-injection\n  if (window.__observationAccumulator) return;\n\n  const MAX_ENTRIES = 500;\n  const MAX_TEXT_LENGTH = 200;\n  const MAX_SHADOW_OBSERVERS = 50; // Limit to prevent performance issues\n  // IMPORTANT: Must match SIGNIFICANCE_THRESHOLD in observation.types.ts\n  const SIGNIFICANCE_THRESHOLD = 4;\n  // Node type constant for shadow root parent check\n  const DOCUMENT_FRAGMENT_NODE = 11;\n\n  // Significance weights (must match server-side observation.types.ts)\n  const WEIGHTS = {\n    // Semantic signals (strongest)\n    hasAlertRole: 3,\n    hasAriaLive: 3,\n    isDialog: 3,\n\n    // Visual signals\n    isFixedOrSticky: 2,\n    hasHighZIndex: 1,\n    coversSignificantViewport: 2,\n\n    // Structural signals\n    isBodyDirectChild: 1,\n    containsInteractiveElements: 1,\n\n    // New universal signals - work without ARIA\n    isVisibleInViewport: 2,      // Element is visible in viewport\n    hasNonTrivialText: 1,        // Has meaningful text content\n    // Temporal signals computed later\n  };\n\n  // Shadow DOM tracking\n  // Map: shadowRoot -> { observer, hostPath }\n  const shadowObservers = new Map();\n\n  // Track processed elements to avoid duplicate observations\n  // WeakSet allows garbage collection of removed elements\n  let processedElements = new WeakSet();\n\n  /**\n   * Generate a stable identifier for an element (for shadow path tracking).\n   * Format: TAG#id or TAG.className or TAG[index]\n   */\n  function getElementIdentifier(el) {\n    const tag = el.tagName.toLowerCase();\n    if (el.id) {\n      return tag + '#' + el.id;\n    }\n    // For custom elements, use the tag name (usually descriptive like 'my-toast')\n    if (tag.includes('-')) {\n      return tag;\n    }\n    // Fallback: use first class or just tag\n    const className = el.className && typeof el.className === 'string'\n      ? el.className.split(' ')[0]\n      : '';\n    if (className) {\n      return tag + '.' + className;\n    }\n    return tag;\n  }\n\n  // Tags whose text content should be excluded from extraction\n  const EXCLUDED_TEXT_TAGS = new Set(['STYLE', 'SCRIPT', 'NOSCRIPT', 'TEMPLATE', 'SVG']);\n\n  /**\n   * Get clean text content from an element, excluding CSS/JS content.\n   * Uses TreeWalker to iterate only text nodes, skipping those inside\n   * excluded tags (STYLE, SCRIPT, NOSCRIPT, TEMPLATE, SVG).\n   *\n   * @param {Element} el - The DOM element to extract text from\n   * @param {number} maxLength - Maximum text length (truncates result)\n   * @returns {string} Clean text content, space-joined, truncated to maxLength\n   */\n  function getCleanTextContent(el, maxLength) {\n    // If element itself is an excluded tag, return empty\n    if (EXCLUDED_TEXT_TAGS.has(el.tagName.toUpperCase())) {\n      return '';\n    }\n\n    const walker = document.createTreeWalker(el, 4, { // NodeFilter.SHOW_TEXT = 4\n      acceptNode: function(node) {\n        let parent = node.parentElement;\n        while (parent && parent !== el) {\n          if (EXCLUDED_TEXT_TAGS.has(parent.tagName.toUpperCase())) {\n            return 2; // FILTER_REJECT\n          }\n          parent = parent.parentElement;\n        }\n        return 1; // FILTER_ACCEPT\n      }\n    });\n\n    const textParts = [];\n    let totalLength = 0;\n    let node;\n\n    while ((node = walker.nextNode()) && totalLength < maxLength) {\n      const text = node.nodeValue;\n      if (text) {\n        const trimmed = text.trim();\n        if (trimmed) {\n          textParts.push(trimmed);\n          totalLength += trimmed.length;\n        }\n      }\n    }\n\n    return textParts.join(' ').substring(0, maxLength);\n  }\n\n  /**\n   * Compute significance signals from element.\n   * Uses universal web standards (ARIA, CSS positioning, DOM structure, visibility).\n   */\n  function computeSignals(el, shadowPath) {\n    const role = el.getAttribute('role');\n    const ariaLive = el.getAttribute('aria-live');\n    const ariaModal = el.getAttribute('aria-modal');\n    const tagName = el.tagName.toLowerCase();\n\n    // Get computed style (may fail for detached elements)\n    let style = null;\n    let rect = null;\n    try {\n      style = getComputedStyle(el);\n      rect = el.getBoundingClientRect();\n    } catch (e) {\n      // Element may be detached\n    }\n\n    const vw = window.innerWidth;\n    const vh = window.innerHeight;\n\n    // Check if element is visible in viewport\n    const isVisibleInViewport = rect && style &&\n      rect.width > 0 && rect.height > 0 &&\n      rect.bottom > 0 && rect.top < vh &&\n      rect.right > 0 && rect.left < vw &&\n      style.display !== 'none' &&\n      style.visibility !== 'hidden' &&\n      style.opacity !== '0';\n\n    // Check for non-trivial text (at least 3 chars, not just whitespace)\n    // Use short sample for signal check - excludes style/script content\n    const text = getCleanTextContent(el, 100);\n    const hasNonTrivialText = text.length >= 3;\n\n    // For shadow DOM elements, isBodyDirectChild is false but we still want to capture them\n    // Check if parent is a shadow root (which indicates top-level in shadow DOM)\n    const isTopLevelInShadow = shadowPath && shadowPath.length > 0 &&\n      el.parentNode && el.parentNode.nodeType === DOCUMENT_FRAGMENT_NODE;\n\n    return {\n      // Semantic signals\n      hasAlertRole: ['alert', 'status', 'log', 'alertdialog'].includes(role),\n      hasAriaLive: ariaLive === 'polite' || ariaLive === 'assertive',\n      isDialog: role === 'dialog' || tagName === 'dialog' || ariaModal === 'true',\n\n      // Visual signals\n      isFixedOrSticky: style && (style.position === 'fixed' || style.position === 'sticky'),\n      // Note: parseInt returns NaN for non-numeric values like \"auto\", which correctly fails the > 1000 check\n      hasHighZIndex: style && parseInt(style.zIndex, 10) > 1000,\n      coversSignificantViewport: rect && ((rect.width > vw * 0.5) || (rect.height > vh * 0.3)),\n\n      // Structural signals - consider top-level shadow DOM elements as equivalent to body children\n      isBodyDirectChild: el.parentElement === document.body || isTopLevelInShadow,\n      containsInteractiveElements: el.querySelector('button, a, input, select, textarea') !== null,\n\n      // Universal signals (work without ARIA)\n      isVisibleInViewport: !!isVisibleInViewport,\n      hasNonTrivialText: hasNonTrivialText,\n\n      // Temporal signals (set by accumulator later)\n      appearedAfterDelay: false,\n      wasShortLived: false,\n    };\n  }\n\n  /**\n   * Calculate significance score from signals using weighted sum.\n   * @param signals - The computed significance signals for an element\n   * @returns The total significance score\n   */\n  function computeSignificance(signals) {\n    let score = 0;\n    for (const [key, weight] of Object.entries(WEIGHTS)) {\n      if (signals[key]) score += weight;\n    }\n    return score;\n  }\n\n  /**\n   * Capture a mutation entry from an element.\n   * @param node - The DOM node\n   * @param type - 'added' or 'removed'\n   * @param shadowPath - Optional array of shadow host identifiers\n   */\n  function captureEntry(node, type, shadowPath) {\n    if (node.nodeType !== 1) return null; // Element nodes only\n\n    const el = node;\n    const signals = computeSignals(el, shadowPath);\n    const significance = computeSignificance(signals);\n\n    // Only capture if meets threshold\n    if (significance < SIGNIFICANCE_THRESHOLD) return null;\n\n    // Capture content - excludes style/script content\n    const text = getCleanTextContent(el, MAX_TEXT_LENGTH);\n    const hasInteractives = signals.containsInteractiveElements;\n\n    // Get viewport coverage for later analysis\n    let viewportCoverage = { widthPct: 0, heightPct: 0 };\n    try {\n      const rect = el.getBoundingClientRect();\n      viewportCoverage = {\n        widthPct: Math.round((rect.width / window.innerWidth) * 100),\n        heightPct: Math.round((rect.height / window.innerHeight) * 100),\n      };\n    } catch (e) {\n      // Element may be detached\n    }\n\n    // Get z-index\n    let zIndex = 0;\n    try {\n      zIndex = parseInt(getComputedStyle(el).zIndex, 10) || 0;\n    } catch (e) {\n      // Element may be detached\n    }\n\n    const entry = {\n      type: type,\n      timestamp: Date.now(),\n      tag: el.tagName.toLowerCase(),\n      id: el.id || undefined,\n\n      // Semantic attributes\n      role: el.getAttribute('role') || undefined,\n      ariaLive: el.getAttribute('aria-live') || undefined,\n      ariaLabel: el.getAttribute('aria-label') || undefined,\n      ariaModal: el.getAttribute('aria-modal') || undefined,\n\n      // Content\n      text: text,\n      hasInteractives: hasInteractives,\n\n      // Visual signals\n      isFixedOrSticky: signals.isFixedOrSticky,\n      zIndex: zIndex,\n      viewportCoverage: viewportCoverage,\n\n      // Structural\n      isBodyDirectChild: signals.isBodyDirectChild,\n\n      // Universal signals\n      isVisibleInViewport: signals.isVisibleInViewport,\n      hasNonTrivialText: signals.hasNonTrivialText,\n\n      // Shadow DOM context\n      shadowPath: shadowPath && shadowPath.length > 0 ? shadowPath : undefined,\n\n      // Significance\n      significance: significance,\n    };\n\n    return entry;\n  }\n\n  const log = [];\n  const pageLoadTime = Date.now();\n\n  /**\n   * Process added nodes - capture entries and check for shadow roots.\n   * @param node - The added node\n   * @param shadowPath - Current shadow path context\n   */\n  function processAddedNode(node, shadowPath) {\n    // Skip if already processed (prevents duplicates from nested shadow DOM)\n    if (node.nodeType === 1 && processedElements.has(node)) {\n      return;\n    }\n\n    const entry = captureEntry(node, 'added', shadowPath);\n    if (entry) {\n      entry.appearedAfterDelay = (entry.timestamp - pageLoadTime) > 100;\n      log.push(entry);\n      // Mark as processed\n      if (node.nodeType === 1) {\n        processedElements.add(node);\n      }\n    }\n\n    // Check significant children - both ARIA-attributed and visible text elements\n    if (node.nodeType === 1) {\n      // First: ARIA-attributed elements (high confidence)\n      const ariaChildren = node.querySelectorAll(\n        '[role=\"alert\"], [role=\"status\"], [role=\"dialog\"], [role=\"alertdialog\"], [aria-live], [aria-modal], dialog'\n      );\n      for (const child of ariaChildren) {\n        // Skip if already processed\n        if (processedElements.has(child)) continue;\n\n        const childEntry = captureEntry(child, 'added', shadowPath);\n        if (childEntry) {\n          childEntry.appearedAfterDelay = (childEntry.timestamp - pageLoadTime) > 100;\n          log.push(childEntry);\n          processedElements.add(child);\n        }\n      }\n\n      // Second: Any visible element with text (broader capture for sites without ARIA)\n      const textChildren = node.querySelectorAll('span, div, p, small, strong, em, label, li');\n      for (const child of textChildren) {\n        // Skip if already processed\n        if (processedElements.has(child)) continue;\n\n        // Skip if already captured via ARIA query\n        if (child.hasAttribute('role') || child.hasAttribute('aria-live')) continue;\n\n        // Only capture leaf-ish elements (minimal nested structure)\n        const hasDeepNesting = child.querySelector('div, p, ul, ol, table');\n        if (hasDeepNesting) continue;\n\n        const childEntry = captureEntry(child, 'added', shadowPath);\n        if (childEntry) {\n          childEntry.appearedAfterDelay = (childEntry.timestamp - pageLoadTime) > 100;\n          log.push(childEntry);\n          processedElements.add(child);\n        }\n      }\n\n      // Check for shadow roots in this element and its descendants\n      checkAndObserveShadowRoots(node, shadowPath || []);\n    }\n  }\n\n  /**\n   * Process removed nodes - capture entries and cleanup shadow observers.\n   * @param node - The removed node\n   * @param shadowPath - Current shadow path context\n   */\n  function processRemovedNode(node, shadowPath) {\n    const entry = captureEntry(node, 'removed', shadowPath);\n    if (entry) {\n      log.push(entry);\n    }\n\n    // Cleanup shadow observers for removed elements\n    if (node.nodeType === 1) {\n      cleanupShadowObservers(node);\n    }\n  }\n\n  /**\n   * Create a mutation callback for observing a specific context (main DOM or shadow root).\n   * @param shadowPath - The shadow path context for this observer\n   */\n  function createMutationCallback(shadowPath) {\n    return function(mutations) {\n      for (const m of mutations) {\n        // Capture added nodes\n        for (const node of m.addedNodes) {\n          processAddedNode(node, shadowPath);\n        }\n\n        // Capture removed nodes\n        for (const node of m.removedNodes) {\n          processRemovedNode(node, shadowPath);\n        }\n      }\n\n      // Trim if over limit (FIFO)\n      if (log.length > MAX_ENTRIES) {\n        const excess = log.length - MAX_ENTRIES;\n        log.splice(0, excess);\n      }\n    };\n  }\n\n  /**\n   * Observe a shadow root for mutations.\n   * @param shadowRoot - The shadow root to observe\n   * @param shadowPath - The path of shadow host identifiers leading to this shadow root\n   */\n  function observeShadowRoot(shadowRoot, shadowPath) {\n    // Already observing this shadow root\n    if (shadowObservers.has(shadowRoot)) return;\n\n    // Limit number of shadow observers for performance\n    if (shadowObservers.size >= MAX_SHADOW_OBSERVERS) {\n      console.warn('[ObservationAccumulator] Max shadow observers reached, skipping:', shadowPath);\n      return;\n    }\n\n    const observer = new MutationObserver(createMutationCallback(shadowPath));\n    observer.observe(shadowRoot, {\n      childList: true,\n      subtree: true,\n    });\n\n    shadowObservers.set(shadowRoot, { observer, hostPath: shadowPath });\n  }\n\n  /**\n   * Recursively check element and descendants for open shadow roots.\n   * @param element - The element to check\n   * @param currentShadowPath - The current shadow path context\n   * @param visited - Set of already-visited elements to prevent infinite recursion\n   */\n  function checkAndObserveShadowRoots(element, currentShadowPath, visited) {\n    if (!element || element.nodeType !== 1) return;\n\n    // Initialize visited set on first call\n    if (!visited) {\n      visited = new Set();\n    }\n\n    // Prevent infinite recursion from circular references\n    if (visited.has(element)) return;\n    visited.add(element);\n\n    // Check if this element has an open shadow root\n    if (element.shadowRoot) {\n      const newPath = [...currentShadowPath, getElementIdentifier(element)];\n      observeShadowRoot(element.shadowRoot, newPath);\n\n      // Check shadow root's children for nested shadow roots\n      const shadowChildren = element.shadowRoot.querySelectorAll('*');\n      for (const child of shadowChildren) {\n        if (child.shadowRoot) {\n          checkAndObserveShadowRoots(child, newPath, visited);\n        }\n      }\n    }\n\n    // Check light DOM children for shadow roots\n    const children = element.querySelectorAll('*');\n    for (const child of children) {\n      if (child.shadowRoot) {\n        checkAndObserveShadowRoots(child, currentShadowPath, visited);\n      }\n    }\n  }\n\n  /**\n   * Cleanup shadow observers for a removed element and its descendants.\n   * @param element - The element being removed\n   */\n  function cleanupShadowObservers(element) {\n    if (!element || element.nodeType !== 1) return;\n\n    // If element is a shadow host, cleanup its observer\n    if (element.shadowRoot && shadowObservers.has(element.shadowRoot)) {\n      const { observer } = shadowObservers.get(element.shadowRoot);\n      observer.disconnect();\n      shadowObservers.delete(element.shadowRoot);\n    }\n\n    // Recursively cleanup descendant shadow hosts\n    try {\n      const descendants = element.querySelectorAll('*');\n      for (const child of descendants) {\n        if (child.shadowRoot && shadowObservers.has(child.shadowRoot)) {\n          const { observer } = shadowObservers.get(child.shadowRoot);\n          observer.disconnect();\n          shadowObservers.delete(child.shadowRoot);\n        }\n      }\n    } catch (e) {\n      // Element may be detached, ignore errors\n    }\n  }\n\n  // Create main observer for document.body\n  const observer = new MutationObserver(createMutationCallback(null));\n\n  // Start observing\n  if (document.body) {\n    observer.observe(document.body, {\n      childList: true,\n      subtree: true,\n    });\n\n    // Initial scan for existing shadow roots in the DOM\n    checkAndObserveShadowRoots(document.body, []);\n  }\n\n  window.__observationAccumulator = {\n    log: log,\n    observer: observer,\n    shadowObservers: shadowObservers, // Expose for debugging/testing\n    observedBody: document.body, // Track which body we're observing for staleness detection\n    pageLoadTime: pageLoadTime,\n    lastReportedIndex: 0, // Track what's been reported\n\n    // Get all entries since timestamp\n    getSince: function(timestamp) {\n      return this.log.filter(e => e.timestamp >= timestamp);\n    },\n\n    // Get significant entries since timestamp\n    getSignificant: function(timestamp, threshold) {\n      threshold = threshold || SIGNIFICANCE_THRESHOLD;\n      return this.log.filter(e => e.timestamp >= timestamp && e.significance >= threshold);\n    },\n\n    // Get unreported entries (for accumulation between tool calls)\n    getUnreported: function() {\n      const unreported = this.log.slice(this.lastReportedIndex);\n      return unreported.filter(e => e.significance >= SIGNIFICANCE_THRESHOLD);\n    },\n\n    // Mark entries as reported\n    markReported: function() {\n      this.lastReportedIndex = this.log.length;\n    },\n\n    // Reset on navigation\n    reset: function() {\n      this.log.length = 0;\n      this.lastReportedIndex = 0;\n      this.pageLoadTime = Date.now();\n      // Cleanup all shadow observers\n      for (const [shadowRoot, { observer }] of this.shadowObservers) {\n        observer.disconnect();\n      }\n      this.shadowObservers.clear();\n      // Clear processed elements tracking (create fresh WeakSet)\n      processedElements = new WeakSet();\n    },\n\n    // Re-scan for shadow roots (useful after dynamic content load)\n    rescanShadowRoots: function() {\n      if (document.body) {\n        checkAndObserveShadowRoots(document.body, []);\n      }\n    },\n\n    // Get shadow observer count (for debugging)\n    getShadowObserverCount: function() {\n      return this.shadowObservers.size;\n    },\n  };\n})();\n";
+export declare const OBSERVATION_OBSERVER_SCRIPT = "\n(function() {\n  // Prevent double-injection\n  if (window.__observationAccumulator) return;\n\n  const MAX_ENTRIES = 500;\n  const MAX_TEXT_LENGTH = 200;\n  const MAX_SHADOW_OBSERVERS = 50; // Limit to prevent performance issues\n  // IMPORTANT: Must match SIGNIFICANCE_THRESHOLD in observation.types.ts\n  const SIGNIFICANCE_THRESHOLD = 4;\n  // Node type constant for shadow root parent check\n  const DOCUMENT_FRAGMENT_NODE = 11;\n  // ARIA roles that indicate live regions (text mutations are significant)\n  const LIVE_REGION_ROLES = new Set(['alert', 'status', 'log', 'marquee', 'timer']);\n  // Attributes whose changes can reveal hidden elements (visibility tracking)\n  const VISIBILITY_ATTRS = ['style', 'class', 'hidden', 'aria-hidden'];\n\n  // Known toast library selectors (unsemantic \u2014 no ARIA roles).\n  // Keep in sync with TOAST_DATA_ATTRS / TOAST_CLASS_PATTERNS in snapshot-compiler.ts.\n  const TOAST_LIBRARY_PARTS = [\n    '[data-sonner-toaster]',\n    '[data-sonner-toast]',\n    '[data-hot-toast]',\n    '.Toastify__toast-container',\n    '.Toastify__toast',\n    '.ant-message',\n    '.ant-message-notice',\n  ];\n  const TOAST_LIBRARY_SELECTOR = TOAST_LIBRARY_PARTS.join(', ');\n\n  // Significance weights (must match server-side observation.types.ts)\n  const WEIGHTS = {\n    // Semantic signals (strongest)\n    hasAlertRole: 3,\n    hasAriaLive: 3,\n    isDialog: 3,\n\n    // Visual signals\n    isFixedOrSticky: 2,\n    hasHighZIndex: 1,\n    coversSignificantViewport: 2,\n\n    // Structural signals\n    isBodyDirectChild: 1,\n    containsInteractiveElements: 1,\n\n    // Known toast library patterns (unsemantic but significant)\n    isKnownToastLibrary: 3,      // Equivalent to hasAlertRole\n\n    // New universal signals - work without ARIA\n    isVisibleInViewport: 2,      // Element is visible in viewport\n    hasNonTrivialText: 1,        // Has meaningful text content\n    // Temporal signals computed later\n  };\n\n  // Shadow DOM tracking\n  // Map: shadowRoot -> { observer, hostPath }\n  const shadowObservers = new Map();\n\n  // Track processed elements to avoid duplicate observations\n  // WeakSet allows garbage collection of removed elements\n  let processedElements = new WeakSet();\n\n  /**\n   * Generate a stable identifier for an element (for shadow path tracking).\n   * Format: TAG#id or TAG.className or TAG[index]\n   */\n  function getElementIdentifier(el) {\n    const tag = el.tagName.toLowerCase();\n    if (el.id) {\n      return tag + '#' + el.id;\n    }\n    // For custom elements, use the tag name (usually descriptive like 'my-toast')\n    if (tag.includes('-')) {\n      return tag;\n    }\n    // Fallback: use first class or just tag\n    const className = el.className && typeof el.className === 'string'\n      ? el.className.split(' ')[0]\n      : '';\n    if (className) {\n      return tag + '.' + className;\n    }\n    return tag;\n  }\n\n  // Tags whose text content should be excluded from extraction\n  const EXCLUDED_TEXT_TAGS = new Set(['STYLE', 'SCRIPT', 'NOSCRIPT', 'TEMPLATE', 'SVG']);\n\n  /**\n   * Get clean text content from an element, excluding CSS/JS content.\n   * Uses TreeWalker to iterate only text nodes, skipping those inside\n   * excluded tags (STYLE, SCRIPT, NOSCRIPT, TEMPLATE, SVG).\n   *\n   * @param {Element} el - The DOM element to extract text from\n   * @param {number} maxLength - Maximum text length (truncates result)\n   * @returns {string} Clean text content, space-joined, truncated to maxLength\n   */\n  function getCleanTextContent(el, maxLength) {\n    // If element itself is an excluded tag, return empty\n    if (EXCLUDED_TEXT_TAGS.has(el.tagName.toUpperCase())) {\n      return '';\n    }\n\n    const walker = document.createTreeWalker(el, 4, { // NodeFilter.SHOW_TEXT = 4\n      acceptNode: function(node) {\n        let parent = node.parentElement;\n        while (parent && parent !== el) {\n          if (EXCLUDED_TEXT_TAGS.has(parent.tagName.toUpperCase())) {\n            return 2; // FILTER_REJECT\n          }\n          parent = parent.parentElement;\n        }\n        return 1; // FILTER_ACCEPT\n      }\n    });\n\n    const textParts = [];\n    let totalLength = 0;\n    let node;\n\n    while ((node = walker.nextNode()) && totalLength < maxLength) {\n      const text = node.nodeValue;\n      if (text) {\n        const trimmed = text.trim();\n        if (trimmed) {\n          textParts.push(trimmed);\n          totalLength += trimmed.length;\n        }\n      }\n    }\n\n    return textParts.join(' ').substring(0, maxLength);\n  }\n\n  /**\n   * Compute significance signals from element.\n   * Uses universal web standards (ARIA, CSS positioning, DOM structure, visibility).\n   */\n  function computeSignals(el, shadowPath) {\n    const role = el.getAttribute('role');\n    const ariaLive = el.getAttribute('aria-live');\n    const ariaModal = el.getAttribute('aria-modal');\n    const tagName = el.tagName.toLowerCase();\n\n    // Get computed style (may fail for detached elements)\n    let style = null;\n    let rect = null;\n    try {\n      style = getComputedStyle(el);\n      rect = el.getBoundingClientRect();\n    } catch (e) {\n      // Element may be detached\n    }\n\n    const vw = window.innerWidth;\n    const vh = window.innerHeight;\n\n    // Check if element is visible in viewport\n    const isVisibleInViewport = rect && style &&\n      rect.width > 0 && rect.height > 0 &&\n      rect.bottom > 0 && rect.top < vh &&\n      rect.right > 0 && rect.left < vw &&\n      style.display !== 'none' &&\n      style.visibility !== 'hidden' &&\n      style.opacity !== '0';\n\n    // Check for non-trivial text (at least 3 chars, not just whitespace)\n    // Use short sample for signal check - excludes style/script content\n    const text = getCleanTextContent(el, 100);\n    const hasNonTrivialText = text.length >= 3;\n\n    // For shadow DOM elements, isBodyDirectChild is false but we still want to capture them\n    // Check if parent is a shadow root (which indicates top-level in shadow DOM)\n    const isTopLevelInShadow = shadowPath && shadowPath.length > 0 &&\n      el.parentNode && el.parentNode.nodeType === DOCUMENT_FRAGMENT_NODE;\n\n    return {\n      // Semantic signals\n      hasAlertRole: ['alert', 'status', 'log', 'alertdialog'].includes(role),\n      hasAriaLive: ariaLive === 'polite' || ariaLive === 'assertive',\n      isDialog: role === 'dialog' || tagName === 'dialog' || ariaModal === 'true',\n\n      // Visual signals\n      isFixedOrSticky: style && (style.position === 'fixed' || style.position === 'sticky'),\n      // Note: parseInt returns NaN for non-numeric values like \"auto\", which correctly fails the > 1000 check\n      hasHighZIndex: style && parseInt(style.zIndex, 10) > 1000,\n      coversSignificantViewport: rect && ((rect.width > vw * 0.5) || (rect.height > vh * 0.3)),\n\n      // Structural signals - consider top-level shadow DOM elements as equivalent to body children\n      isBodyDirectChild: el.parentElement === document.body || isTopLevelInShadow,\n      containsInteractiveElements: el.querySelector('button, a, input, select, textarea') !== null,\n\n      // Known toast library detection (unsemantic but significant)\n      isKnownToastLibrary: el.matches(TOAST_LIBRARY_SELECTOR) || (typeof el.className === 'string' && el.className.includes('chakra-toast')),\n\n      // Universal signals (work without ARIA)\n      isVisibleInViewport: !!isVisibleInViewport,\n      hasNonTrivialText: hasNonTrivialText,\n\n      // Temporal signals (set by accumulator later)\n      appearedAfterDelay: false,\n      wasShortLived: false,\n    };\n  }\n\n  /**\n   * Calculate significance score from signals using weighted sum.\n   * @param signals - The computed significance signals for an element\n   * @returns The total significance score\n   */\n  function computeSignificance(signals) {\n    let score = 0;\n    for (const [key, weight] of Object.entries(WEIGHTS)) {\n      if (signals[key]) score += weight;\n    }\n    return score;\n  }\n\n  /**\n   * Capture a mutation entry from an element.\n   * @param node - The DOM node\n   * @param type - 'added' or 'removed'\n   * @param shadowPath - Optional array of shadow host identifiers\n   */\n  function captureEntry(node, type, shadowPath) {\n    if (node.nodeType !== 1) return null; // Element nodes only\n\n    const el = node;\n    const signals = computeSignals(el, shadowPath);\n    const significance = computeSignificance(signals);\n\n    // Only capture if meets threshold\n    if (significance < SIGNIFICANCE_THRESHOLD) return null;\n\n    // Capture content - excludes style/script content\n    const text = getCleanTextContent(el, MAX_TEXT_LENGTH);\n    const hasInteractives = signals.containsInteractiveElements;\n\n    // Get viewport coverage for later analysis\n    let viewportCoverage = { widthPct: 0, heightPct: 0 };\n    try {\n      const rect = el.getBoundingClientRect();\n      viewportCoverage = {\n        widthPct: Math.round((rect.width / window.innerWidth) * 100),\n        heightPct: Math.round((rect.height / window.innerHeight) * 100),\n      };\n    } catch (e) {\n      // Element may be detached\n    }\n\n    // Get z-index\n    let zIndex = 0;\n    try {\n      zIndex = parseInt(getComputedStyle(el).zIndex, 10) || 0;\n    } catch (e) {\n      // Element may be detached\n    }\n\n    const entry = {\n      type: type,\n      timestamp: Date.now(),\n      tag: el.tagName.toLowerCase(),\n      id: el.id || undefined,\n\n      // Semantic attributes\n      role: el.getAttribute('role') || undefined,\n      ariaLive: el.getAttribute('aria-live') || undefined,\n      ariaLabel: el.getAttribute('aria-label') || undefined,\n      ariaModal: el.getAttribute('aria-modal') || undefined,\n\n      // Content\n      text: text,\n      hasInteractives: hasInteractives,\n\n      // Visual signals\n      isFixedOrSticky: signals.isFixedOrSticky,\n      zIndex: zIndex,\n      viewportCoverage: viewportCoverage,\n\n      // Structural\n      isBodyDirectChild: signals.isBodyDirectChild,\n\n      // Universal signals\n      isVisibleInViewport: signals.isVisibleInViewport,\n      hasNonTrivialText: signals.hasNonTrivialText,\n\n      // Shadow DOM context\n      shadowPath: shadowPath && shadowPath.length > 0 ? shadowPath : undefined,\n\n      // Significance\n      significance: significance,\n    };\n\n    return entry;\n  }\n\n  const log = [];\n  const pageLoadTime = Date.now();\n\n  /**\n   * Process added nodes - capture entries and check for shadow roots.\n   * @param node - The added node\n   * @param shadowPath - Current shadow path context\n   */\n  function processAddedNode(node, shadowPath) {\n    // Skip if already processed (prevents duplicates from nested shadow DOM)\n    if (node.nodeType === 1 && processedElements.has(node)) {\n      return;\n    }\n\n    const entry = captureEntry(node, 'added', shadowPath);\n    if (entry) {\n      entry.appearedAfterDelay = (entry.timestamp - pageLoadTime) > 100;\n      log.push(entry);\n      // Mark as processed\n      if (node.nodeType === 1) {\n        processedElements.add(node);\n      }\n    }\n\n    // Check significant children - both ARIA-attributed and visible text elements\n    if (node.nodeType === 1) {\n      // First: ARIA-attributed elements (high confidence)\n      const ariaChildren = node.querySelectorAll(\n        '[role=\"alert\"], [role=\"status\"], [role=\"dialog\"], [role=\"alertdialog\"], [aria-live], [aria-modal], dialog'\n      );\n      for (const child of ariaChildren) {\n        // Skip if already processed\n        if (processedElements.has(child)) continue;\n\n        const childEntry = captureEntry(child, 'added', shadowPath);\n        if (childEntry) {\n          childEntry.appearedAfterDelay = (childEntry.timestamp - pageLoadTime) > 100;\n          log.push(childEntry);\n          processedElements.add(child);\n        }\n      }\n\n      // Second: Any visible element with text (broader capture for sites without ARIA)\n      const textChildren = node.querySelectorAll('span, div, p, small, strong, em, label, li');\n      for (const child of textChildren) {\n        // Skip if already processed\n        if (processedElements.has(child)) continue;\n\n        // Skip if already captured via ARIA query\n        if (child.hasAttribute('role') || child.hasAttribute('aria-live')) continue;\n\n        // Only capture leaf-ish elements (minimal nested structure)\n        const hasDeepNesting = child.querySelector('div, p, ul, ol, table');\n        if (hasDeepNesting) continue;\n\n        const childEntry = captureEntry(child, 'added', shadowPath);\n        if (childEntry) {\n          childEntry.appearedAfterDelay = (childEntry.timestamp - pageLoadTime) > 100;\n          log.push(childEntry);\n          processedElements.add(child);\n        }\n      }\n\n      // Check for shadow roots in this element and its descendants\n      checkAndObserveShadowRoots(node, shadowPath || []);\n    }\n  }\n\n  /**\n   * Process removed nodes - capture entries and cleanup shadow observers.\n   * @param node - The removed node\n   * @param shadowPath - Current shadow path context\n   */\n  function processRemovedNode(node, shadowPath) {\n    const entry = captureEntry(node, 'removed', shadowPath);\n    if (entry) {\n      log.push(entry);\n    }\n\n    // Cleanup shadow observers for removed elements\n    if (node.nodeType === 1) {\n      cleanupShadowObservers(node);\n    }\n  }\n\n  /**\n   * Find the nearest ancestor (or self) with a live region role.\n   * Returns the element if found, null otherwise.\n   */\n  function findLiveRegionAncestor(node) {\n    let el = node.nodeType === 1 ? node : node.parentElement;\n    while (el && el !== document.body) {\n      const role = el.getAttribute && el.getAttribute('role');\n      if (role && LIVE_REGION_ROLES.has(role)) return el;\n      const ariaLive = el.getAttribute && el.getAttribute('aria-live');\n      if (ariaLive === 'polite' || ariaLive === 'assertive') return el;\n      el = el.parentElement;\n    }\n    return null;\n  }\n\n  /**\n   * Handle characterData mutations (text-only changes in existing elements).\n   * Captures the live region container when its text content changes.\n   */\n  function processCharacterDataMutation(mutation, shadowPath) {\n    const textNode = mutation.target;\n    const liveRegion = findLiveRegionAncestor(textNode);\n    if (!liveRegion) return;\n\n    // Avoid re-capturing the same live region for rapid successive text changes\n    // Use a short debounce window (same element within 100ms)\n    const now = Date.now();\n    if (liveRegion.__lastTextCapture && (now - liveRegion.__lastTextCapture) < 100) return;\n    liveRegion.__lastTextCapture = now;\n\n    const entry = captureEntry(liveRegion, 'added', shadowPath);\n    if (entry) {\n      entry.appearedAfterDelay = (entry.timestamp - pageLoadTime) > 100;\n      log.push(entry);\n    }\n  }\n\n  /**\n   * Handle attribute mutations that may reveal hidden elements.\n   * Detects visibility changes (display:none \u2192 block, hidden removal, etc.)\n   */\n  function processAttributeMutation(mutation, shadowPath) {\n    const el = mutation.target;\n    if (el.nodeType !== 1) return;\n\n    // Skip if already processed in this cycle\n    if (processedElements.has(el)) return;\n\n    // Check if this attribute change made the element visible\n    const attrName = mutation.attributeName;\n\n    // For 'hidden' attribute: element becomes visible when hidden is removed\n    if (attrName === 'hidden' && el.hasAttribute('hidden')) return; // Still hidden\n\n    // For 'aria-hidden': element becomes visible when set to false or removed\n    if (attrName === 'aria-hidden') {\n      const val = el.getAttribute('aria-hidden');\n      if (val === 'true') return; // Still hidden\n    }\n\n    // For 'style' or 'class': check computed visibility\n    if (attrName === 'style' || attrName === 'class') {\n      try {\n        const style = getComputedStyle(el);\n        if (style.display === 'none' || style.visibility === 'hidden' || style.opacity === '0') {\n          return; // Still hidden\n        }\n      } catch (e) {\n        return; // Detached element\n      }\n    }\n\n    // Check if this element (or a live region ancestor) is significant\n    // Only capture if the element has meaningful content and meets threshold\n    const entry = captureEntry(el, 'added', shadowPath);\n    if (entry) {\n      entry.appearedAfterDelay = (entry.timestamp - pageLoadTime) > 100;\n      log.push(entry);\n      processedElements.add(el);\n    }\n  }\n\n  /**\n   * Create a mutation callback for observing a specific context (main DOM or shadow root).\n   * @param shadowPath - The shadow path context for this observer\n   */\n  function createMutationCallback(shadowPath) {\n    return function(mutations) {\n      for (const m of mutations) {\n        if (m.type === 'childList') {\n          // Capture added nodes\n          for (const node of m.addedNodes) {\n            processAddedNode(node, shadowPath);\n          }\n\n          // Capture removed nodes\n          for (const node of m.removedNodes) {\n            processRemovedNode(node, shadowPath);\n          }\n        } else if (m.type === 'characterData') {\n          // Text content changed in an existing node (live region updates)\n          processCharacterDataMutation(m, shadowPath);\n        } else if (m.type === 'attributes') {\n          // Attribute changed \u2014 may reveal hidden elements (visibility tracking)\n          processAttributeMutation(m, shadowPath);\n        }\n      }\n\n      // Trim if over limit (FIFO)\n      if (log.length > MAX_ENTRIES) {\n        const excess = log.length - MAX_ENTRIES;\n        log.splice(0, excess);\n      }\n    };\n  }\n\n  /**\n   * Observe a shadow root for mutations.\n   * @param shadowRoot - The shadow root to observe\n   * @param shadowPath - The path of shadow host identifiers leading to this shadow root\n   */\n  function observeShadowRoot(shadowRoot, shadowPath) {\n    // Already observing this shadow root\n    if (shadowObservers.has(shadowRoot)) return;\n\n    // Limit number of shadow observers for performance\n    if (shadowObservers.size >= MAX_SHADOW_OBSERVERS) {\n      console.warn('[ObservationAccumulator] Max shadow observers reached, skipping:', shadowPath);\n      return;\n    }\n\n    const observer = new MutationObserver(createMutationCallback(shadowPath));\n    observer.observe(shadowRoot, {\n      childList: true,\n      subtree: true,\n      characterData: true,\n      characterDataOldValue: true,\n      attributes: true,\n      attributeFilter: VISIBILITY_ATTRS,\n    });\n\n    shadowObservers.set(shadowRoot, { observer, hostPath: shadowPath });\n  }\n\n  /**\n   * Recursively check element and descendants for open shadow roots.\n   * @param element - The element to check\n   * @param currentShadowPath - The current shadow path context\n   * @param visited - Set of already-visited elements to prevent infinite recursion\n   */\n  function checkAndObserveShadowRoots(element, currentShadowPath, visited) {\n    if (!element || element.nodeType !== 1) return;\n\n    // Initialize visited set on first call\n    if (!visited) {\n      visited = new Set();\n    }\n\n    // Prevent infinite recursion from circular references\n    if (visited.has(element)) return;\n    visited.add(element);\n\n    // Check if this element has an open shadow root\n    if (element.shadowRoot) {\n      const newPath = [...currentShadowPath, getElementIdentifier(element)];\n      observeShadowRoot(element.shadowRoot, newPath);\n\n      // Check shadow root's children for nested shadow roots\n      const shadowChildren = element.shadowRoot.querySelectorAll('*');\n      for (const child of shadowChildren) {\n        if (child.shadowRoot) {\n          checkAndObserveShadowRoots(child, newPath, visited);\n        }\n      }\n    }\n\n    // Check light DOM children for shadow roots\n    const children = element.querySelectorAll('*');\n    for (const child of children) {\n      if (child.shadowRoot) {\n        checkAndObserveShadowRoots(child, currentShadowPath, visited);\n      }\n    }\n  }\n\n  /**\n   * Cleanup shadow observers for a removed element and its descendants.\n   * @param element - The element being removed\n   */\n  function cleanupShadowObservers(element) {\n    if (!element || element.nodeType !== 1) return;\n\n    // If element is a shadow host, cleanup its observer\n    if (element.shadowRoot && shadowObservers.has(element.shadowRoot)) {\n      const { observer } = shadowObservers.get(element.shadowRoot);\n      observer.disconnect();\n      shadowObservers.delete(element.shadowRoot);\n    }\n\n    // Recursively cleanup descendant shadow hosts\n    try {\n      const descendants = element.querySelectorAll('*');\n      for (const child of descendants) {\n        if (child.shadowRoot && shadowObservers.has(child.shadowRoot)) {\n          const { observer } = shadowObservers.get(child.shadowRoot);\n          observer.disconnect();\n          shadowObservers.delete(child.shadowRoot);\n        }\n      }\n    } catch (e) {\n      // Element may be detached, ignore errors\n    }\n  }\n\n  // Create main observer for document.body\n  const observer = new MutationObserver(createMutationCallback(null));\n\n  // Start observing\n  if (document.body) {\n    observer.observe(document.body, {\n      childList: true,\n      subtree: true,\n      characterData: true,\n      characterDataOldValue: true,\n      attributes: true,\n      attributeFilter: VISIBILITY_ATTRS,\n    });\n\n    // Initial scan for existing shadow roots in the DOM\n    checkAndObserveShadowRoots(document.body, []);\n  }\n\n  window.__observationAccumulator = {\n    log: log,\n    observer: observer,\n    shadowObservers: shadowObservers, // Expose for debugging/testing\n    observedBody: document.body, // Track which body we're observing for staleness detection\n    pageLoadTime: pageLoadTime,\n    lastReportedIndex: 0, // Track what's been reported\n\n    // Get all entries since timestamp\n    getSince: function(timestamp) {\n      return this.log.filter(e => e.timestamp >= timestamp);\n    },\n\n    // Get significant entries since timestamp\n    getSignificant: function(timestamp, threshold) {\n      threshold = threshold || SIGNIFICANCE_THRESHOLD;\n      return this.log.filter(e => e.timestamp >= timestamp && e.significance >= threshold);\n    },\n\n    // Get unreported entries (for accumulation between tool calls)\n    getUnreported: function() {\n      const unreported = this.log.slice(this.lastReportedIndex);\n      return unreported.filter(e => e.significance >= SIGNIFICANCE_THRESHOLD);\n    },\n\n    // Mark entries as reported\n    markReported: function() {\n      this.lastReportedIndex = this.log.length;\n    },\n\n    // Reset on navigation\n    reset: function() {\n      this.log.length = 0;\n      this.lastReportedIndex = 0;\n      this.pageLoadTime = Date.now();\n      // Cleanup all shadow observers\n      for (const [shadowRoot, { observer }] of this.shadowObservers) {\n        observer.disconnect();\n      }\n      this.shadowObservers.clear();\n      // Clear processed elements tracking (create fresh WeakSet)\n      processedElements = new WeakSet();\n    },\n\n    // Re-scan for shadow roots (useful after dynamic content load)\n    rescanShadowRoots: function() {\n      if (document.body) {\n        checkAndObserveShadowRoots(document.body, []);\n      }\n    },\n\n    // Get shadow observer count (for debugging)\n    getShadowObserverCount: function() {\n      return this.shadowObservers.size;\n    },\n  };\n})();\n";
 //# sourceMappingURL=observer-script.d.ts.map

package/dist/src/observation/observer-script.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observer-script.d.ts","sourceRoot":"","sources":["../../../src/observation/observer-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,eAAO,MAAM,2BAA2B,s4kBAsiBvC,CAAC"}
+{"version":3,"file":"observer-script.d.ts","sourceRoot":"","sources":["../../../src/observation/observer-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,eAAO,MAAM,2BAA2B,wuuBAgqBvC,CAAC"}

package/dist/src/observation/observer-script.js

@@ -27,6 +27,23 @@ export const OBSERVATION_OBSERVER_SCRIPT = `
   const SIGNIFICANCE_THRESHOLD = 4;
   // Node type constant for shadow root parent check
   const DOCUMENT_FRAGMENT_NODE = 11;
+  // ARIA roles that indicate live regions (text mutations are significant)
+  const LIVE_REGION_ROLES = new Set(['alert', 'status', 'log', 'marquee', 'timer']);
+  // Attributes whose changes can reveal hidden elements (visibility tracking)
+  const VISIBILITY_ATTRS = ['style', 'class', 'hidden', 'aria-hidden'];
+
+  // Known toast library selectors (unsemantic — no ARIA roles).
+  // Keep in sync with TOAST_DATA_ATTRS / TOAST_CLASS_PATTERNS in snapshot-compiler.ts.
+  const TOAST_LIBRARY_PARTS = [
+    '[data-sonner-toaster]',
+    '[data-sonner-toast]',
+    '[data-hot-toast]',
+    '.Toastify__toast-container',
+    '.Toastify__toast',
+    '.ant-message',
+    '.ant-message-notice',
+  ];
+  const TOAST_LIBRARY_SELECTOR = TOAST_LIBRARY_PARTS.join(', ');
 
   // Significance weights (must match server-side observation.types.ts)
   const WEIGHTS = {
@@ -44,6 +61,9 @@ export const OBSERVATION_OBSERVER_SCRIPT = `
     isBodyDirectChild: 1,
     containsInteractiveElements: 1,
 
+    // Known toast library patterns (unsemantic but significant)
+    isKnownToastLibrary: 3,      // Equivalent to hasAlertRole
+
     // New universal signals - work without ARIA
     isVisibleInViewport: 2,      // Element is visible in viewport
     hasNonTrivialText: 1,        // Has meaningful text content
@@ -188,6 +208,9 @@ export const OBSERVATION_OBSERVER_SCRIPT = `
       isBodyDirectChild: el.parentElement === document.body || isTopLevelInShadow,
       containsInteractiveElements: el.querySelector('button, a, input, select, textarea') !== null,
 
+      // Known toast library detection (unsemantic but significant)
+      isKnownToastLibrary: el.matches(TOAST_LIBRARY_SELECTOR) || (typeof el.className === 'string' && el.className.includes('chakra-toast')),
+
       // Universal signals (work without ARIA)
       isVisibleInViewport: !!isVisibleInViewport,
       hasNonTrivialText: hasNonTrivialText,
@@ -374,6 +397,89 @@ export const OBSERVATION_OBSERVER_SCRIPT = `
     }
   }
 
+  /**
+   * Find the nearest ancestor (or self) with a live region role.
+   * Returns the element if found, null otherwise.
+   */
+  function findLiveRegionAncestor(node) {
+    let el = node.nodeType === 1 ? node : node.parentElement;
+    while (el && el !== document.body) {
+      const role = el.getAttribute && el.getAttribute('role');
+      if (role && LIVE_REGION_ROLES.has(role)) return el;
+      const ariaLive = el.getAttribute && el.getAttribute('aria-live');
+      if (ariaLive === 'polite' || ariaLive === 'assertive') return el;
+      el = el.parentElement;
+    }
+    return null;
+  }
+
+  /**
+   * Handle characterData mutations (text-only changes in existing elements).
+   * Captures the live region container when its text content changes.
+   */
+  function processCharacterDataMutation(mutation, shadowPath) {
+    const textNode = mutation.target;
+    const liveRegion = findLiveRegionAncestor(textNode);
+    if (!liveRegion) return;
+
+    // Avoid re-capturing the same live region for rapid successive text changes
+    // Use a short debounce window (same element within 100ms)
+    const now = Date.now();
+    if (liveRegion.__lastTextCapture && (now - liveRegion.__lastTextCapture) < 100) return;
+    liveRegion.__lastTextCapture = now;
+
+    const entry = captureEntry(liveRegion, 'added', shadowPath);
+    if (entry) {
+      entry.appearedAfterDelay = (entry.timestamp - pageLoadTime) > 100;
+      log.push(entry);
+    }
+  }
+
+  /**
+   * Handle attribute mutations that may reveal hidden elements.
+   * Detects visibility changes (display:none → block, hidden removal, etc.)
+   */
+  function processAttributeMutation(mutation, shadowPath) {
+    const el = mutation.target;
+    if (el.nodeType !== 1) return;
+
+    // Skip if already processed in this cycle
+    if (processedElements.has(el)) return;
+
+    // Check if this attribute change made the element visible
+    const attrName = mutation.attributeName;
+
+    // For 'hidden' attribute: element becomes visible when hidden is removed
+    if (attrName === 'hidden' && el.hasAttribute('hidden')) return; // Still hidden
+
+    // For 'aria-hidden': element becomes visible when set to false or removed
+    if (attrName === 'aria-hidden') {
+      const val = el.getAttribute('aria-hidden');
+      if (val === 'true') return; // Still hidden
+    }
+
+    // For 'style' or 'class': check computed visibility
+    if (attrName === 'style' || attrName === 'class') {
+      try {
+        const style = getComputedStyle(el);
+        if (style.display === 'none' || style.visibility === 'hidden' || style.opacity === '0') {
+          return; // Still hidden
+        }
+      } catch (e) {
+        return; // Detached element
+      }
+    }
+
+    // Check if this element (or a live region ancestor) is significant
+    // Only capture if the element has meaningful content and meets threshold
+    const entry = captureEntry(el, 'added', shadowPath);
+    if (entry) {
+      entry.appearedAfterDelay = (entry.timestamp - pageLoadTime) > 100;
+      log.push(entry);
+      processedElements.add(el);
+    }
+  }
+
   /**
    * Create a mutation callback for observing a specific context (main DOM or shadow root).
    * @param shadowPath - The shadow path context for this observer
@@ -381,14 +487,22 @@ export const OBSERVATION_OBSERVER_SCRIPT = `
   function createMutationCallback(shadowPath) {
     return function(mutations) {
       for (const m of mutations) {
-        // Capture added nodes
-        for (const node of m.addedNodes) {
-          processAddedNode(node, shadowPath);
-        }
+        if (m.type === 'childList') {
+          // Capture added nodes
+          for (const node of m.addedNodes) {
+            processAddedNode(node, shadowPath);
+          }
 
-        // Capture removed nodes
-        for (const node of m.removedNodes) {
-          processRemovedNode(node, shadowPath);
+          // Capture removed nodes
+          for (const node of m.removedNodes) {
+            processRemovedNode(node, shadowPath);
+          }
+        } else if (m.type === 'characterData') {
+          // Text content changed in an existing node (live region updates)
+          processCharacterDataMutation(m, shadowPath);
+        } else if (m.type === 'attributes') {
+          // Attribute changed — may reveal hidden elements (visibility tracking)
+          processAttributeMutation(m, shadowPath);
         }
       }
 
@@ -419,6 +533,10 @@ export const OBSERVATION_OBSERVER_SCRIPT = `
     observer.observe(shadowRoot, {
       childList: true,
       subtree: true,
+      characterData: true,
+      characterDataOldValue: true,
+      attributes: true,
+      attributeFilter: VISIBILITY_ATTRS,
     });
 
     shadowObservers.set(shadowRoot, { observer, hostPath: shadowPath });
@@ -502,6 +620,10 @@ export const OBSERVATION_OBSERVER_SCRIPT = `
     observer.observe(document.body, {
       childList: true,
       subtree: true,
+      characterData: true,
+      characterDataOldValue: true,
+      attributes: true,
+      attributeFilter: VISIBILITY_ATTRS,
     });
 
     // Initial scan for existing shadow roots in the DOM

package/dist/src/observation/observer-script.js.map

@@ -1 +1 @@
-{"version":3,"file":"observer-script.js","sourceRoot":"","sources":["../../../src/observation/observer-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsiB1C,CAAC"}
+{"version":3,"file":"observer-script.js","sourceRoot":"","sources":["../../../src/observation/observer-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgqB1C,CAAC"}

package/dist/src/query/disambiguation.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Disambiguation
+ *
+ * Generate suggestions to narrow ambiguous query results.
+ * Analyzes matched nodes and suggests refinements.
+ */
+import type { ReadableNode } from '../snapshot/snapshot.types.js';
+import type { FindElementsRequest, MatchedNode, DisambiguationSuggestion } from './types/query.types.js';
+/**
+ * Generate disambiguation suggestions when query matches multiple elements.
+ * Suggests refinements that would narrow down the results.
+ */
+export declare function generateSuggestions(matches: MatchedNode[], request: FindElementsRequest): DisambiguationSuggestion[];
+/**
+ * Count nodes by a given attribute.
+ */
+export declare function countByAttribute<T>(nodes: ReadableNode[], getter: (node: ReadableNode) => T): Map<T, number>;
+//# sourceMappingURL=disambiguation.d.ts.map

package/dist/src/query/disambiguation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disambiguation.d.ts","sourceRoot":"","sources":["../../../src/query/disambiguation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EACX,wBAAwB,EACzB,MAAM,wBAAwB,CAAC;AAIhC;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EAAE,EACtB,OAAO,EAAE,mBAAmB,GAC3B,wBAAwB,EAAE,CA2G5B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,KAAK,EAAE,YAAY,EAAE,EACrB,MAAM,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,CAAC,GAChC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAOhB"}

package/dist/src/query/disambiguation.js

@@ -0,0 +1,123 @@
+/**
+ * Disambiguation
+ *
+ * Generate suggestions to narrow ambiguous query results.
+ * Analyzes matched nodes and suggests refinements.
+ */
+import { normalizeText } from '../lib/text-utils.js';
+import { normalizeLabelFilter } from './scoring.js';
+/**
+ * Generate disambiguation suggestions when query matches multiple elements.
+ * Suggests refinements that would narrow down the results.
+ */
+export function generateSuggestions(matches, request) {
+    const suggestions = [];
+    const nodes = matches.map((m) => m.node);
+    // Only generate suggestions if we have multiple matches
+    if (matches.length < 2)
+        return suggestions;
+    // 1. Suggest refining by kind if matches have different kinds
+    if (request.kind === undefined) {
+        const kindCounts = countByAttribute(nodes, (n) => n.kind);
+        if (kindCounts.size > 1) {
+            for (const [kind, count] of kindCounts) {
+                if (count < matches.length) {
+                    suggestions.push({
+                        type: 'refine_kind',
+                        message: `Add kind: "${kind}" to narrow to ${count} result(s)`,
+                        refinement: { kind },
+                        expected_matches: count,
+                    });
+                }
+            }
+        }
+    }
+    // 2. Suggest refining by region if matches span multiple regions
+    if (request.region === undefined) {
+        const regionCounts = countByAttribute(nodes, (n) => n.where.region);
+        if (regionCounts.size > 1) {
+            for (const [region, count] of regionCounts) {
+                if (count < matches.length && region !== 'unknown') {
+                    suggestions.push({
+                        type: 'refine_region',
+                        message: `Add region: "${region}" to narrow to ${count} result(s)`,
+                        refinement: { region },
+                        expected_matches: count,
+                    });
+                }
+            }
+        }
+    }
+    // 3. Suggest refining by group_id if matches have different groups
+    if (request.group_id === undefined) {
+        const groupCounts = countByAttribute(nodes, (n) => n.where.group_id);
+        groupCounts.delete(undefined); // Remove nodes without groups
+        if (groupCounts.size >= 1) {
+            for (const [groupId, count] of groupCounts) {
+                if (groupId !== undefined) {
+                    suggestions.push({
+                        type: 'refine_group',
+                        message: `Add group_id: "${groupId}" to narrow to ${count} result(s)`,
+                        refinement: { group_id: groupId },
+                        expected_matches: count,
+                    });
+                }
+            }
+        }
+    }
+    // 4. Suggest adding state filters
+    if (request.state === undefined) {
+        const enabledCount = nodes.filter((n) => n.state?.enabled).length;
+        if (enabledCount > 0 && enabledCount < matches.length) {
+            suggestions.push({
+                type: 'add_state',
+                message: `Add state: { enabled: true } to narrow to ${enabledCount} result(s)`,
+                refinement: { state: { enabled: true } },
+                expected_matches: enabledCount,
+            });
+        }
+        const visibleCount = nodes.filter((n) => n.state?.visible).length;
+        if (visibleCount > 0 && visibleCount < matches.length) {
+            suggestions.push({
+                type: 'add_state',
+                message: `Add state: { visible: true } to narrow to ${visibleCount} result(s)`,
+                refinement: { state: { visible: true } },
+                expected_matches: visibleCount,
+            });
+        }
+    }
+    // 5. Suggest refining label to exact match if using contains/fuzzy
+    if (request.label !== undefined) {
+        const { mode, text } = normalizeLabelFilter(request.label);
+        if (mode !== 'exact') {
+            const normalizedText = normalizeText(text.toLowerCase());
+            const exactCount = nodes.filter((n) => normalizeText(n.label.toLowerCase()) === normalizedText).length;
+            if (exactCount > 0 && exactCount < matches.length) {
+                suggestions.push({
+                    type: 'refine_label',
+                    message: `Use exact label match to narrow to ${exactCount} result(s)`,
+                    refinement: { label: { text, mode: 'exact' } },
+                    expected_matches: exactCount,
+                });
+            }
+        }
+    }
+    // Sort by expected_matches (prefer suggestions that narrow most effectively)
+    // and limit to top 5
+    return suggestions
+        .filter((s) => s.expected_matches > 0 && s.expected_matches < matches.length)
+        .sort((a, b) => a.expected_matches - b.expected_matches)
+        .slice(0, 5);
+}
+/**
+ * Count nodes by a given attribute.
+ */
+export function countByAttribute(nodes, getter) {
+    const counts = new Map();
+    for (const node of nodes) {
+        const value = getter(node);
+        counts.set(value, (counts.get(value) ?? 0) + 1);
+    }
+    return counts;
+}
+//# sourceMappingURL=disambiguation.js.map

package/dist/src/query/disambiguation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disambiguation.js","sourceRoot":"","sources":["../../../src/query/disambiguation.ts"],"names":[],"mappings":"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"}

package/dist/src/query/fuzzy-match.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Fuzzy Match
+ *
+ * Fuzzy label matching for query engine.
+ * Uses token-based matching with configurable thresholds.
+ */
+import type { ReadableNode } from '../snapshot/snapshot.types.js';
+import type { FuzzyMatchOptions } from './types/query.types.js';
+/**
+ * Filter nodes by fuzzy label matching.
+ * Returns matched nodes and a map of node_id -> match score for relevance calculation.
+ */
+export declare function filterByLabelFuzzy(nodes: ReadableNode[], text: string, caseSensitive: boolean, options?: FuzzyMatchOptions): {
+    nodes: ReadableNode[];
+    scores: Map<string, number>;
+};
+//# sourceMappingURL=fuzzy-match.d.ts.map

package/dist/src/query/fuzzy-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuzzy-match.d.ts","sourceRoot":"","sources":["../../../src/query/fuzzy-match.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhE;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,EAAE,EACrB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,OAAO,EACtB,OAAO,GAAE,iBAAsB,GAC9B;IAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CA0BxD"}

package/dist/src/query/fuzzy-match.js

@@ -0,0 +1,34 @@
+/**
+ * Fuzzy Match
+ *
+ * Fuzzy label matching for query engine.
+ * Uses token-based matching with configurable thresholds.
+ */
+import { normalizeText, tokenizeForMatching, fuzzyTokensMatch } from '../lib/text-utils.js';
+/**
+ * Filter nodes by fuzzy label matching.
+ * Returns matched nodes and a map of node_id -> match score for relevance calculation.
+ */
+export function filterByLabelFuzzy(nodes, text, caseSensitive, options = {}) {
+    const scores = new Map();
+    const normalizedQuery = normalizeText(caseSensitive ? text : text.toLowerCase());
+    const queryTokens = tokenizeForMatching(normalizedQuery, 10, 2);
+    if (queryTokens.length === 0) {
+        return { nodes: [], scores };
+    }
+    const matched = nodes.filter((n) => {
+        const normalizedLabel = normalizeText(caseSensitive ? n.label : n.label.toLowerCase());
+        const labelTokens = tokenizeForMatching(normalizedLabel, 10, 2);
+        const result = fuzzyTokensMatch(labelTokens, queryTokens, {
+            minTokenOverlap: options.minTokenOverlap ?? 0.5,
+            prefixMatch: options.prefixMatch ?? true,
+            minSimilarity: options.minSimilarity ?? 0.8,
+        });
+        if (result.isMatch) {
+            scores.set(n.node_id, result.score);
+        }
+        return result.isMatch;
+    });
+    return { nodes: matched, scores };
+}
+//# sourceMappingURL=fuzzy-match.js.map