agent-web-interface 4.2.0 → 4.4.0

package/dist/src/index.js

@@ -29,11 +29,11 @@ export function getSessionStore() {
 export function getSessionBinding() {
     return sessionBinding;
 }
-import { initializeTools, initializeFormTools, 
+import { initializeToolContext, 
 // Tool handlers
-listPages, closePage, closeSession, navigate, goBack, goForward, reload, captureSnapshot, findElements, getNodeDetails, scrollElementIntoView, scrollPage, click, type, press, select, hover, getFormUnderstanding, getFieldContext, takeScreenshot, 
+listPages, closePage, closeSession, navigate, goBack, goForward, reload, captureSnapshot, findElements, getNodeDetails, scrollElementIntoView, scrollPage, click, type, press, select, hover, drag, wheel, getFormUnderstanding, getFieldContext, takeScreenshot, inspectCanvas, 
 // Input schemas only (all outputs are XML strings now)
-ListPagesInputSchema, ClosePageInputSchema, CloseSessionInputSchema, NavigateInputSchema, GoBackInputSchema, GoForwardInputSchema, ReloadInputSchema, CaptureSnapshotInputSchema, FindElementsInputSchema, GetNodeDetailsInputSchema, ScrollElementIntoViewInputSchemaBase, ScrollPageInputSchema, ClickInputSchemaBase, TypeInputSchemaBase, PressInputSchema, SelectInputSchemaBase, HoverInputSchemaBase, GetFormUnderstandingInputSchema, GetFieldContextInputSchema, TakeScreenshotInputSchemaBase, } from './tools/index.js';
+ListPagesInputSchema, ClosePageInputSchema, CloseSessionInputSchema, NavigateInputSchema, GoBackInputSchema, GoForwardInputSchema, ReloadInputSchema, CaptureSnapshotInputSchema, FindElementsInputSchema, GetNodeDetailsInputSchema, ScrollElementIntoViewInputSchemaBase, ScrollPageInputSchema, ClickInputSchemaBase, TypeInputSchemaBase, PressInputSchema, SelectInputSchemaBase, HoverInputSchemaBase, DragInputSchemaBase, WheelInputSchemaBase, GetFormUnderstandingInputSchema, GetFieldContextInputSchema, TakeScreenshotInputSchemaBase, InspectCanvasInputSchemaBase, } from './tools/index.js';
 /**
  * Wrap a tool handler with lazy browser initialization.
  * Works with both sync and async handlers - sync return values are automatically
@@ -107,14 +107,13 @@ function initializeServer() {
     });
     // Initialize session manager and tools
     const session = getSessionManager();
-    initializeTools(session);
-    initializeFormTools(session);
+    initializeToolContext(session);
     // ============================================================================
     // SESSION TOOLS
     // ============================================================================
     server.registerTool('list_pages', {
         title: 'List Pages',
-        description: 'List all open browser pages with their page_id, URL, and title. Use when working with multiple pages or to get the page_id for targeting a specific page.',
+        description: 'List all open browser pages with their page_id, URL, and title.',
         inputSchema: ListPagesInputSchema.shape,
     }, withLazyInit(listPages, 'list_pages'));
     server.registerTool('close_page', {
@@ -124,7 +123,7 @@ function initializeServer() {
     }, withLazyInit(closePage, 'close_page'));
     server.registerTool('close_session', {
         title: 'Close Session',
-        description: 'Close the entire browser and clear all state. Use when done with browser tasks or to reset after errors. Browser auto-restarts on next tool call.',
+        description: 'Close the entire browser and clear all state.',
         inputSchema: CloseSessionInputSchema.shape,
     }, withLazyInit(closeSession, 'close_session'));
     // ============================================================================
@@ -132,98 +131,116 @@ function initializeServer() {
     // ============================================================================
     server.registerTool('navigate', {
         title: 'Navigate',
-        description: 'Go to a URL. Returns page snapshot with interactive elements. This is typically your first action when starting browser automation.',
+        description: 'Go to a URL. Returns page snapshot with interactive elements.',
         inputSchema: NavigateInputSchema.shape,
     }, withLazyInit(navigate, 'navigate'));
     server.registerTool('go_back', {
         title: 'Go Back',
-        description: 'Go back one page in browser history (like clicking the back button). Returns updated page snapshot.',
+        description: 'Go back one page in browser history.',
         inputSchema: GoBackInputSchema.shape,
     }, withLazyInit(goBack, 'go_back'));
     server.registerTool('go_forward', {
         title: 'Go Forward',
-        description: 'Go forward one page in browser history. Returns updated page snapshot.',
+        description: 'Go forward one page in browser history.',
         inputSchema: GoForwardInputSchema.shape,
     }, withLazyInit(goForward, 'go_forward'));
     server.registerTool('reload', {
         title: 'Reload',
-        description: 'Refresh the current page. Use when content may be stale or after waiting for server-side changes. Returns updated snapshot.',
+        description: 'Refresh the current page.',
         inputSchema: ReloadInputSchema.shape,
     }, withLazyInit(reload, 'reload'));
-    server.registerTool('capture_snapshot', {
-        title: 'Capture Snapshot',
-        description: 'Re-capture the page state without performing any action. Use when the page may have changed on its own (timers, live updates, animations completing). NOT needed after click/type/etc - those already return fresh snapshots.',
+    server.registerTool('snapshot', {
+        title: 'Snapshot',
+        description: 'Re-capture the page state without performing any action. Use when the page may have changed on its own (timers, live updates, animations).',
         inputSchema: CaptureSnapshotInputSchema.shape,
-    }, withLazyInit(captureSnapshot, 'capture_snapshot'));
+    }, withLazyInit(captureSnapshot, 'snapshot'));
     // ============================================================================
     // OBSERVATION TOOLS
     // ============================================================================
-    server.registerTool('find_elements', {
-        title: 'Find Elements',
-        description: 'Search for interactive elements OR read page text content. Filter by `kind` (button, link, textbox), `label` (case-insensitive substring match), or `region` (header, main, footer). To READ page content, ensure `include_readable: true` (default) which includes paragraphs and headings.',
+    server.registerTool('find', {
+        title: 'Find',
+        description: 'Search for interactive elements OR read page text content. Filter by `kind` (button, link, textbox, canvas), `label` (case-insensitive substring match), or `region` (header, main, footer).',
         inputSchema: FindElementsInputSchema.shape,
-    }, withLazyInit(findElements, 'find_elements'));
-    server.registerTool('get_element_details', {
-        title: 'Get Element Details',
-        description: 'Get complete details for one element: exact position, size, state, attributes. Use when you need more info than find_elements provides, like precise coordinates or full attribute list.',
+    }, withLazyInit(findElements, 'find'));
+    server.registerTool('get_element', {
+        title: 'Get Element',
+        description: 'Get complete details for one element: exact position, size, state, attributes.',
         inputSchema: GetNodeDetailsInputSchema.shape,
-    }, withLazyInit(getNodeDetails, 'get_element_details'));
-    server.registerTool('take_screenshot', {
-        title: 'Take Screenshot',
-        description: 'Capture a screenshot of the current page or a specific element. Returns the image directly for small screenshots (<2MB) or saves to a temp file for large ones. Use `eid` for element screenshots (requires a prior snapshot) or `fullPage: true` for full-page capture. Supports PNG (lossless, default) and JPEG (lossy with quality 0-100). Cannot combine eid and fullPage.',
+    }, withLazyInit(getNodeDetails, 'get_element'));
+    server.registerTool('screenshot', {
+        title: 'Screenshot',
+        description: 'Capture a screenshot of the current page or a specific element.',
         inputSchema: TakeScreenshotInputSchemaBase.shape,
-    }, withLazyInit(takeScreenshot, 'take_screenshot'));
+    }, withLazyInit(takeScreenshot, 'screenshot'));
     // ============================================================================
     // INTERACTION TOOLS
     // ============================================================================
-    server.registerTool('scroll_element_into_view', {
-        title: 'Scroll Element Into View',
-        description: 'Scroll until a specific element is visible in the viewport. Use BEFORE clicking or interacting with elements that are off-screen.',
+    server.registerTool('scroll_to', {
+        title: 'Scroll To',
+        description: 'Scroll until a specific element is visible in the viewport.',
         inputSchema: ScrollElementIntoViewInputSchemaBase.shape,
-    }, withLazyInit(scrollElementIntoView, 'scroll_element_into_view'));
-    server.registerTool('scroll_page', {
-        title: 'Scroll Page',
-        description: 'Scroll the viewport up or down by pixels. Use to explore page content, load lazy content, or reach elements below the fold. Returns updated snapshot.',
+    }, withLazyInit(scrollElementIntoView, 'scroll_to'));
+    server.registerTool('scroll', {
+        title: 'Scroll',
+        description: 'Scroll the viewport up or down by pixels.',
         inputSchema: ScrollPageInputSchema.shape,
-    }, withLazyInit(scrollPage, 'scroll_page'));
+    }, withLazyInit(scrollPage, 'scroll'));
     server.registerTool('click', {
         title: 'Click Element',
-        description: 'Click an element. Use for buttons, links, checkboxes, or any clickable element. Returns updated page snapshot reflecting any changes from the click.',
+        description: 'Click an element or at viewport coordinates.',
         inputSchema: ClickInputSchemaBase.shape,
     }, withLazyInit(click, 'click'));
     server.registerTool('type', {
         title: 'Type Text',
-        description: 'Type text into an input field, search box, or text area. Set `clear: true` to replace existing text instead of appending. Returns updated snapshot.',
+        description: 'Type text into an input field or text area.',
         inputSchema: TypeInputSchemaBase.shape,
     }, withLazyInit(type, 'type'));
     server.registerTool('press', {
         title: 'Press Key',
-        description: 'Press a keyboard key (Enter, Tab, Escape, arrows, etc.) with optional Ctrl/Shift/Alt modifiers. Use for: submitting forms (Enter), moving between fields (Tab), closing dialogs (Escape), or keyboard shortcuts.',
+        description: 'Press a keyboard key with optional modifiers.',
         inputSchema: PressInputSchema.shape,
     }, withLazyInit(press, 'press'));
     server.registerTool('select', {
         title: 'Select Option',
-        description: 'Choose an option from a dropdown menu. Specify the option by its value attribute or visible text. Returns updated snapshot.',
+        description: 'Choose an option from a dropdown menu by value or visible text.',
         inputSchema: SelectInputSchemaBase.shape,
     }, withLazyInit(select, 'select'));
     server.registerTool('hover', {
         title: 'Hover Element',
-        description: 'Move mouse over an element without clicking. Use to trigger hover menus, tooltips, or reveal hidden content that appears on mouseover.',
+        description: 'Move mouse over an element without clicking. Triggers hover menus and tooltips.',
         inputSchema: HoverInputSchemaBase.shape,
     }, withLazyInit(hover, 'hover'));
+    server.registerTool('drag', {
+        title: 'Drag',
+        description: 'Drag from one point to another.',
+        inputSchema: DragInputSchemaBase.shape,
+    }, withLazyInit(drag, 'drag'));
+    server.registerTool('wheel', {
+        title: 'Wheel',
+        description: 'Dispatch a mouse wheel event at specific coordinates. Use for scroll-to-zoom (with Control modifier) or horizontal scrolling.',
+        inputSchema: WheelInputSchemaBase.shape,
+    }, withLazyInit(wheel, 'wheel'));
+    // ============================================================================
+    // CANVAS INSPECTION TOOLS
+    // ============================================================================
+    server.registerTool('inspect_canvas', {
+        title: 'Inspect Canvas',
+        description: 'Analyze a canvas element: auto-detect the rendering library, query its scene graph, and return an annotated screenshot with coordinate grid overlay.',
+        inputSchema: InspectCanvasInputSchemaBase.shape,
+    }, withLazyInit(inspectCanvas, 'inspect_canvas'));
     // ============================================================================
     // FORM UNDERSTANDING TOOLS
     // ============================================================================
-    server.registerTool('get_form_understanding', {
-        title: 'Get Form Understanding',
-        description: 'Analyze all forms on the page: fields, required inputs, validation rules, and field dependencies. Use BEFORE filling complex forms (multi-step, conditional fields) to understand what is required and in what order.',
+    server.registerTool('get_form', {
+        title: 'Get Form',
+        description: 'Analyze all forms on the page: fields, required inputs, validation rules, and field dependencies.',
         inputSchema: GetFormUnderstandingInputSchema.shape,
-    }, withLazyInit(getFormUnderstanding, 'get_form_understanding'));
-    server.registerTool('get_field_context', {
-        title: 'Get Field Context',
-        description: 'Get detailed info about one form field: what it is for, valid input formats, dependencies on other fields, and suggested values. Use when unsure how to fill a specific field.',
+    }, withLazyInit(getFormUnderstanding, 'get_form'));
+    server.registerTool('get_field', {
+        title: 'Get Field',
+        description: 'Get detailed info about one form field: purpose, valid input formats, dependencies, and suggested values.',
         inputSchema: GetFieldContextInputSchema.shape,
-    }, withLazyInit(getFieldContext, 'get_field_context'));
+    }, withLazyInit(getFieldContext, 'get_field'));
     return server;
 }
 /**

package/dist/src/index.js.map

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