safari-devtools-mcp 0.1.0

package/build/src/injected/network.js

@@ -0,0 +1,273 @@
+/**
+ * Injectable script for capturing network requests.
+ *
+ * Hybrid approach:
+ * 1. Performance API backfill — captures historical requests made before injection
+ *    (timing, size, URL available; no headers/status)
+ * 2. Fetch interception — captures ongoing fetch() requests with full details
+ * 3. XMLHttpRequest interception — captures ongoing XHR requests with full details
+ * 4. PerformanceObserver — catches resource loads the interceptors miss
+ *
+ * Historical entries are flagged so the AI knows they have limited detail.
+ */
+export const NETWORK_CAPTURE_SCRIPT = `
+(function() {
+  if (window.__safariDevToolsNetworkInitialized) return;
+  window.__safariDevToolsNetworkInitialized = true;
+  window.__safariDevToolsNetworkLogs = [];
+  window.__safariDevToolsNetworkReqId = 0;
+
+  // Helper to guess resource type from initiatorType or URL
+  function guessResourceType(initiatorType, url) {
+    if (initiatorType === 'xmlhttprequest') return 'xhr';
+    if (initiatorType === 'fetch') return 'fetch';
+    if (initiatorType === 'script') return 'script';
+    if (initiatorType === 'link' || initiatorType === 'css') return 'stylesheet';
+    if (initiatorType === 'img') return 'image';
+    if (initiatorType === 'video' || initiatorType === 'audio') return 'media';
+
+    // Guess from URL extension
+    if (url) {
+      var ext = url.split('?')[0].split('#')[0].split('.').pop().toLowerCase();
+      var typeMap = {
+        js: 'script', mjs: 'script',
+        css: 'stylesheet',
+        png: 'image', jpg: 'image', jpeg: 'image', gif: 'image', svg: 'image', webp: 'image', ico: 'image',
+        woff: 'font', woff2: 'font', ttf: 'font', otf: 'font', eot: 'font',
+        mp4: 'media', webm: 'media', mp3: 'media', ogg: 'media',
+        html: 'document', htm: 'document'
+      };
+      if (typeMap[ext]) return typeMap[ext];
+    }
+    return 'other';
+  }
+
+  // Step 1: Backfill historical requests from Performance API
+  try {
+    var entries = performance.getEntriesByType('resource');
+    entries.forEach(function(entry) {
+      window.__safariDevToolsNetworkLogs.push({
+        reqid: window.__safariDevToolsNetworkReqId++,
+        url: entry.name,
+        method: 'GET',
+        status: 0,
+        statusText: '',
+        resourceType: guessResourceType(entry.initiatorType, entry.name),
+        startTime: entry.startTime,
+        duration: entry.duration,
+        transferSize: entry.transferSize || 0,
+        encodedBodySize: entry.encodedBodySize || 0,
+        decodedBodySize: entry.decodedBodySize || 0,
+        requestHeaders: {},
+        responseHeaders: {},
+        historical: true,
+        mimeType: ''
+      });
+    });
+  } catch(e) {}
+
+  // Step 2: PerformanceObserver for new resource loads
+  try {
+    var observer = new PerformanceObserver(function(list) {
+      list.getEntries().forEach(function(entry) {
+        // Skip if we already have this URL from fetch/XHR interception
+        var isDuplicate = window.__safariDevToolsNetworkLogs.some(function(log) {
+          return !log.historical && log.url === entry.name && Math.abs(log.startTime - entry.startTime) < 100;
+        });
+        if (isDuplicate) return;
+
+        // Only add if not already captured by interceptors
+        var hasIntercepted = window.__safariDevToolsNetworkLogs.some(function(log) {
+          return !log.historical && log.url === entry.name;
+        });
+        if (!hasIntercepted) {
+          window.__safariDevToolsNetworkLogs.push({
+            reqid: window.__safariDevToolsNetworkReqId++,
+            url: entry.name,
+            method: 'GET',
+            status: 0,
+            statusText: '',
+            resourceType: guessResourceType(entry.initiatorType, entry.name),
+            startTime: entry.startTime,
+            duration: entry.duration,
+            transferSize: entry.transferSize || 0,
+            encodedBodySize: entry.encodedBodySize || 0,
+            decodedBodySize: entry.decodedBodySize || 0,
+            requestHeaders: {},
+            responseHeaders: {},
+            historical: false,
+            mimeType: ''
+          });
+        }
+      });
+    });
+    observer.observe({ entryTypes: ['resource'] });
+  } catch(e) {}
+
+  // Step 3: Intercept fetch()
+  var originalFetch = window.fetch;
+  window.fetch = function() {
+    var args = arguments;
+    var request;
+    try {
+      request = new Request(args[0], args[1]);
+    } catch(e) {
+      return originalFetch.apply(this, args);
+    }
+
+    var entry = {
+      reqid: window.__safariDevToolsNetworkReqId++,
+      url: request.url,
+      method: request.method,
+      status: 0,
+      statusText: '',
+      resourceType: 'fetch',
+      startTime: performance.now(),
+      duration: 0,
+      transferSize: 0,
+      encodedBodySize: 0,
+      decodedBodySize: 0,
+      requestHeaders: {},
+      responseHeaders: {},
+      historical: false,
+      mimeType: ''
+    };
+
+    // Capture request headers
+    try {
+      request.headers.forEach(function(value, key) {
+        entry.requestHeaders[key] = value;
+      });
+    } catch(e) {}
+
+    // Capture request body
+    try {
+      if (args[1] && args[1].body) {
+        if (typeof args[1].body === 'string') {
+          entry.requestBody = args[1].body;
+        } else {
+          entry.requestBody = '[Binary or FormData body]';
+        }
+      }
+    } catch(e) {}
+
+    window.__safariDevToolsNetworkLogs.push(entry);
+
+    return originalFetch.apply(this, args).then(function(response) {
+      entry.status = response.status;
+      entry.statusText = response.statusText;
+      entry.duration = performance.now() - entry.startTime;
+      entry.mimeType = response.headers.get('content-type') || '';
+
+      // Capture response headers
+      try {
+        response.headers.forEach(function(value, key) {
+          entry.responseHeaders[key] = value;
+        });
+      } catch(e) {}
+
+      return response;
+    }).catch(function(error) {
+      entry.error = error.message || String(error);
+      entry.duration = performance.now() - entry.startTime;
+      throw error;
+    });
+  };
+
+  // Step 4: Intercept XMLHttpRequest
+  var originalXHROpen = XMLHttpRequest.prototype.open;
+  var originalXHRSend = XMLHttpRequest.prototype.send;
+  var originalXHRSetHeader = XMLHttpRequest.prototype.setRequestHeader;
+
+  XMLHttpRequest.prototype.open = function(method, url) {
+    this.__safariDevToolsMeta = {
+      method: method,
+      url: String(url),
+      requestHeaders: {}
+    };
+    return originalXHROpen.apply(this, arguments);
+  };
+
+  XMLHttpRequest.prototype.setRequestHeader = function(name, value) {
+    if (this.__safariDevToolsMeta) {
+      this.__safariDevToolsMeta.requestHeaders[name] = value;
+    }
+    return originalXHRSetHeader.apply(this, arguments);
+  };
+
+  XMLHttpRequest.prototype.send = function(body) {
+    var xhr = this;
+    var meta = xhr.__safariDevToolsMeta;
+
+    if (meta) {
+      var entry = {
+        reqid: window.__safariDevToolsNetworkReqId++,
+        url: meta.url,
+        method: meta.method,
+        status: 0,
+        statusText: '',
+        resourceType: 'xhr',
+        startTime: performance.now(),
+        duration: 0,
+        transferSize: 0,
+        encodedBodySize: 0,
+        decodedBodySize: 0,
+        requestHeaders: meta.requestHeaders,
+        responseHeaders: {},
+        historical: false,
+        mimeType: ''
+      };
+
+      if (body) {
+        try {
+          entry.requestBody = typeof body === 'string' ? body : '[Binary body]';
+        } catch(e) {}
+      }
+
+      window.__safariDevToolsNetworkLogs.push(entry);
+
+      xhr.addEventListener('load', function() {
+        entry.status = xhr.status;
+        entry.statusText = xhr.statusText;
+        entry.duration = performance.now() - entry.startTime;
+        entry.mimeType = xhr.getResponseHeader('content-type') || '';
+
+        // Parse response headers
+        try {
+          var headerStr = xhr.getAllResponseHeaders();
+          if (headerStr) {
+            headerStr.split('\\r\\n').forEach(function(line) {
+              var parts = line.split(': ');
+              if (parts.length >= 2) {
+                entry.responseHeaders[parts[0]] = parts.slice(1).join(': ');
+              }
+            });
+          }
+        } catch(e) {}
+
+        // Estimate body size
+        try {
+          var responseText = xhr.responseText;
+          if (responseText) {
+            entry.decodedBodySize = responseText.length;
+            entry.encodedBodySize = responseText.length;
+          }
+        } catch(e) {}
+      });
+
+      xhr.addEventListener('error', function() {
+        entry.error = 'Network error';
+        entry.duration = performance.now() - entry.startTime;
+      });
+
+      xhr.addEventListener('timeout', function() {
+        entry.error = 'Request timeout';
+        entry.duration = performance.now() - entry.startTime;
+      });
+    }
+
+    return originalXHRSend.apply(this, arguments);
+  };
+})();
+`;
+//# sourceMappingURL=network.js.map

package/build/src/injected/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../../src/injected/network.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmQrC,CAAC"}

package/build/src/injected/snapshot.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Injectable script for taking DOM snapshots with UIDs.
+ *
+ * Walks the DOM tree and builds an accessibility-like representation.
+ * Each element gets a stable data-safari-uid attribute for targeting
+ * by other tools (click, fill, screenshot, etc).
+ */
+export declare const SNAPSHOT_SCRIPT = "\nfunction __safariDevToolsTakeSnapshot(verbose) {\n  var uidCounter = 0;\n\n  function getRole(el) {\n    // Explicit ARIA role\n    var role = el.getAttribute && el.getAttribute('role');\n    if (role) return role;\n\n    // Implicit role mapping\n    var tag = el.tagName.toLowerCase();\n    var roleMap = {\n      'a': 'link',\n      'button': 'button',\n      'input': getInputRole(el),\n      'select': 'combobox',\n      'textarea': 'textbox',\n      'img': 'img',\n      'h1': 'heading',\n      'h2': 'heading',\n      'h3': 'heading',\n      'h4': 'heading',\n      'h5': 'heading',\n      'h6': 'heading',\n      'nav': 'navigation',\n      'main': 'main',\n      'header': 'banner',\n      'footer': 'contentinfo',\n      'aside': 'complementary',\n      'form': 'form',\n      'table': 'table',\n      'thead': 'rowgroup',\n      'tbody': 'rowgroup',\n      'tr': 'row',\n      'th': 'columnheader',\n      'td': 'cell',\n      'ul': 'list',\n      'ol': 'list',\n      'li': 'listitem',\n      'dialog': 'dialog',\n      'details': 'group',\n      'summary': 'button',\n      'progress': 'progressbar',\n      'meter': 'meter',\n      'option': 'option',\n      'section': 'region',\n      'article': 'article',\n      'video': 'video',\n      'audio': 'audio',\n      'iframe': 'document',\n      'label': 'label',\n      'fieldset': 'group',\n      'legend': 'legend'\n    };\n    return roleMap[tag] || 'generic';\n  }\n\n  function getInputRole(el) {\n    var type = (el.getAttribute('type') || 'text').toLowerCase();\n    var map = {\n      'text': 'textbox',\n      'email': 'textbox',\n      'password': 'textbox',\n      'search': 'searchbox',\n      'tel': 'textbox',\n      'url': 'textbox',\n      'number': 'spinbutton',\n      'range': 'slider',\n      'checkbox': 'checkbox',\n      'radio': 'radio',\n      'submit': 'button',\n      'button': 'button',\n      'reset': 'button',\n      'file': 'button',\n      'image': 'button',\n      'hidden': 'none'\n    };\n    return map[type] || 'textbox';\n  }\n\n  function getName(el) {\n    // aria-label\n    var label = el.getAttribute && el.getAttribute('aria-label');\n    if (label) return label;\n\n    // aria-labelledby\n    var labelledBy = el.getAttribute && el.getAttribute('aria-labelledby');\n    if (labelledBy) {\n      var labelEl = document.getElementById(labelledBy);\n      if (labelEl) return labelEl.textContent.trim();\n    }\n\n    // <label> for inputs\n    if (el.id) {\n      var labelFor = document.querySelector('label[for=\"' + el.id + '\"]');\n      if (labelFor) return labelFor.textContent.trim();\n    }\n\n    // alt text for images\n    if (el.tagName === 'IMG') return el.getAttribute('alt') || '';\n\n    // placeholder for inputs\n    if (el.tagName === 'INPUT' || el.tagName === 'TEXTAREA') {\n      return el.getAttribute('placeholder') || '';\n    }\n\n    // title attribute\n    var title = el.getAttribute && el.getAttribute('title');\n    if (title) return title;\n\n    // Direct text content (only for leaf-ish elements)\n    var childElements = el.children ? el.children.length : 0;\n    if (childElements === 0 && el.textContent) {\n      var text = el.textContent.trim();\n      if (text.length <= 100) return text;\n      return text.substring(0, 97) + '...';\n    }\n\n    return '';\n  }\n\n  function getValue(el) {\n    if (el.tagName === 'INPUT' || el.tagName === 'TEXTAREA' || el.tagName === 'SELECT') {\n      return el.value || '';\n    }\n    if (el.getAttribute && el.getAttribute('aria-valuenow')) {\n      return el.getAttribute('aria-valuenow');\n    }\n    return undefined;\n  }\n\n  function isVisible(el) {\n    if (!el.getBoundingClientRect) return true;\n    var rect = el.getBoundingClientRect();\n    if (rect.width === 0 && rect.height === 0) return false;\n    var style = window.getComputedStyle(el);\n    if (style.display === 'none' || style.visibility === 'hidden') return false;\n    if (parseFloat(style.opacity) === 0) return false;\n    return true;\n  }\n\n  function shouldSkip(el) {\n    var tag = el.tagName.toLowerCase();\n    if (tag === 'script' || tag === 'style' || tag === 'noscript' || tag === 'br' || tag === 'wbr') return true;\n    if (el.getAttribute && el.getAttribute('aria-hidden') === 'true') return true;\n    return false;\n  }\n\n  function walkNode(el, depth) {\n    if (!el || !el.tagName) return null;\n    if (shouldSkip(el)) return null;\n    if (!isVisible(el)) return null;\n\n    var uid = 'e' + (uidCounter++);\n    el.setAttribute('data-safari-uid', uid);\n\n    var role = getRole(el);\n    var name = getName(el);\n    var value = getValue(el);\n\n    var node = {\n      uid: uid,\n      role: role,\n      name: name\n    };\n\n    if (value !== undefined && value !== '') node.value = value;\n\n    if (verbose) {\n      node.tagName = el.tagName.toLowerCase();\n      var attrs = {};\n      if (el.id) attrs.id = el.id;\n      if (el.className && typeof el.className === 'string') attrs.class = el.className;\n      if (el.getAttribute('href')) attrs.href = el.getAttribute('href');\n      if (el.getAttribute('src')) attrs.src = el.getAttribute('src');\n      if (el.getAttribute('type')) attrs.type = el.getAttribute('type');\n      if (el.getAttribute('name')) attrs.name = el.getAttribute('name');\n      if (el.getAttribute('disabled') !== null) attrs.disabled = 'true';\n      if (el.getAttribute('checked') !== null) attrs.checked = 'true';\n      if (el.getAttribute('aria-expanded')) attrs['aria-expanded'] = el.getAttribute('aria-expanded');\n      if (el.getAttribute('aria-selected')) attrs['aria-selected'] = el.getAttribute('aria-selected');\n      if (el.getAttribute('aria-pressed')) attrs['aria-pressed'] = el.getAttribute('aria-pressed');\n      if (Object.keys(attrs).length > 0) node.attributes = attrs;\n    }\n\n    // Walk children\n    var children = [];\n    for (var i = 0; i < el.children.length; i++) {\n      var childNode = walkNode(el.children[i], depth + 1);\n      if (childNode) children.push(childNode);\n    }\n    node.children = children;\n\n    // Skip generic nodes with no name, no value, and exactly one child (flatten)\n    if (role === 'generic' && !name && !value && children.length === 1 && !verbose) {\n      return children[0];\n    }\n\n    return node;\n  }\n\n  return walkNode(document.body || document.documentElement, 0) || {\n    uid: 'root',\n    role: 'document',\n    name: document.title || '',\n    children: []\n  };\n}\n";
+//# sourceMappingURL=snapshot.d.ts.map

package/build/src/injected/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/injected/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,eAAe,i1MAgN3B,CAAC"}

package/build/src/injected/snapshot.js

@@ -0,0 +1,217 @@
+/**
+ * Injectable script for taking DOM snapshots with UIDs.
+ *
+ * Walks the DOM tree and builds an accessibility-like representation.
+ * Each element gets a stable data-safari-uid attribute for targeting
+ * by other tools (click, fill, screenshot, etc).
+ */
+export const SNAPSHOT_SCRIPT = `
+function __safariDevToolsTakeSnapshot(verbose) {
+  var uidCounter = 0;
+
+  function getRole(el) {
+    // Explicit ARIA role
+    var role = el.getAttribute && el.getAttribute('role');
+    if (role) return role;
+
+    // Implicit role mapping
+    var tag = el.tagName.toLowerCase();
+    var roleMap = {
+      'a': 'link',
+      'button': 'button',
+      'input': getInputRole(el),
+      'select': 'combobox',
+      'textarea': 'textbox',
+      'img': 'img',
+      'h1': 'heading',
+      'h2': 'heading',
+      'h3': 'heading',
+      'h4': 'heading',
+      'h5': 'heading',
+      'h6': 'heading',
+      'nav': 'navigation',
+      'main': 'main',
+      'header': 'banner',
+      'footer': 'contentinfo',
+      'aside': 'complementary',
+      'form': 'form',
+      'table': 'table',
+      'thead': 'rowgroup',
+      'tbody': 'rowgroup',
+      'tr': 'row',
+      'th': 'columnheader',
+      'td': 'cell',
+      'ul': 'list',
+      'ol': 'list',
+      'li': 'listitem',
+      'dialog': 'dialog',
+      'details': 'group',
+      'summary': 'button',
+      'progress': 'progressbar',
+      'meter': 'meter',
+      'option': 'option',
+      'section': 'region',
+      'article': 'article',
+      'video': 'video',
+      'audio': 'audio',
+      'iframe': 'document',
+      'label': 'label',
+      'fieldset': 'group',
+      'legend': 'legend'
+    };
+    return roleMap[tag] || 'generic';
+  }
+
+  function getInputRole(el) {
+    var type = (el.getAttribute('type') || 'text').toLowerCase();
+    var map = {
+      'text': 'textbox',
+      'email': 'textbox',
+      'password': 'textbox',
+      'search': 'searchbox',
+      'tel': 'textbox',
+      'url': 'textbox',
+      'number': 'spinbutton',
+      'range': 'slider',
+      'checkbox': 'checkbox',
+      'radio': 'radio',
+      'submit': 'button',
+      'button': 'button',
+      'reset': 'button',
+      'file': 'button',
+      'image': 'button',
+      'hidden': 'none'
+    };
+    return map[type] || 'textbox';
+  }
+
+  function getName(el) {
+    // aria-label
+    var label = el.getAttribute && el.getAttribute('aria-label');
+    if (label) return label;
+
+    // aria-labelledby
+    var labelledBy = el.getAttribute && el.getAttribute('aria-labelledby');
+    if (labelledBy) {
+      var labelEl = document.getElementById(labelledBy);
+      if (labelEl) return labelEl.textContent.trim();
+    }
+
+    // <label> for inputs
+    if (el.id) {
+      var labelFor = document.querySelector('label[for="' + el.id + '"]');
+      if (labelFor) return labelFor.textContent.trim();
+    }
+
+    // alt text for images
+    if (el.tagName === 'IMG') return el.getAttribute('alt') || '';
+
+    // placeholder for inputs
+    if (el.tagName === 'INPUT' || el.tagName === 'TEXTAREA') {
+      return el.getAttribute('placeholder') || '';
+    }
+
+    // title attribute
+    var title = el.getAttribute && el.getAttribute('title');
+    if (title) return title;
+
+    // Direct text content (only for leaf-ish elements)
+    var childElements = el.children ? el.children.length : 0;
+    if (childElements === 0 && el.textContent) {
+      var text = el.textContent.trim();
+      if (text.length <= 100) return text;
+      return text.substring(0, 97) + '...';
+    }
+
+    return '';
+  }
+
+  function getValue(el) {
+    if (el.tagName === 'INPUT' || el.tagName === 'TEXTAREA' || el.tagName === 'SELECT') {
+      return el.value || '';
+    }
+    if (el.getAttribute && el.getAttribute('aria-valuenow')) {
+      return el.getAttribute('aria-valuenow');
+    }
+    return undefined;
+  }
+
+  function isVisible(el) {
+    if (!el.getBoundingClientRect) return true;
+    var rect = el.getBoundingClientRect();
+    if (rect.width === 0 && rect.height === 0) return false;
+    var style = window.getComputedStyle(el);
+    if (style.display === 'none' || style.visibility === 'hidden') return false;
+    if (parseFloat(style.opacity) === 0) return false;
+    return true;
+  }
+
+  function shouldSkip(el) {
+    var tag = el.tagName.toLowerCase();
+    if (tag === 'script' || tag === 'style' || tag === 'noscript' || tag === 'br' || tag === 'wbr') return true;
+    if (el.getAttribute && el.getAttribute('aria-hidden') === 'true') return true;
+    return false;
+  }
+
+  function walkNode(el, depth) {
+    if (!el || !el.tagName) return null;
+    if (shouldSkip(el)) return null;
+    if (!isVisible(el)) return null;
+
+    var uid = 'e' + (uidCounter++);
+    el.setAttribute('data-safari-uid', uid);
+
+    var role = getRole(el);
+    var name = getName(el);
+    var value = getValue(el);
+
+    var node = {
+      uid: uid,
+      role: role,
+      name: name
+    };
+
+    if (value !== undefined && value !== '') node.value = value;
+
+    if (verbose) {
+      node.tagName = el.tagName.toLowerCase();
+      var attrs = {};
+      if (el.id) attrs.id = el.id;
+      if (el.className && typeof el.className === 'string') attrs.class = el.className;
+      if (el.getAttribute('href')) attrs.href = el.getAttribute('href');
+      if (el.getAttribute('src')) attrs.src = el.getAttribute('src');
+      if (el.getAttribute('type')) attrs.type = el.getAttribute('type');
+      if (el.getAttribute('name')) attrs.name = el.getAttribute('name');
+      if (el.getAttribute('disabled') !== null) attrs.disabled = 'true';
+      if (el.getAttribute('checked') !== null) attrs.checked = 'true';
+      if (el.getAttribute('aria-expanded')) attrs['aria-expanded'] = el.getAttribute('aria-expanded');
+      if (el.getAttribute('aria-selected')) attrs['aria-selected'] = el.getAttribute('aria-selected');
+      if (el.getAttribute('aria-pressed')) attrs['aria-pressed'] = el.getAttribute('aria-pressed');
+      if (Object.keys(attrs).length > 0) node.attributes = attrs;
+    }
+
+    // Walk children
+    var children = [];
+    for (var i = 0; i < el.children.length; i++) {
+      var childNode = walkNode(el.children[i], depth + 1);
+      if (childNode) children.push(childNode);
+    }
+    node.children = children;
+
+    // Skip generic nodes with no name, no value, and exactly one child (flatten)
+    if (role === 'generic' && !name && !value && children.length === 1 && !verbose) {
+      return children[0];
+    }
+
+    return node;
+  }
+
+  return walkNode(document.body || document.documentElement, 0) || {
+    uid: 'root',
+    role: 'document',
+    name: document.title || '',
+    children: []
+  };
+}
+`;
+//# sourceMappingURL=snapshot.js.map

package/build/src/injected/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../../src/injected/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgN9B,CAAC"}

package/build/src/tools/console.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Console debugging tools.
+ * Mirrors chrome-devtools-mcp tool names: list_console_messages, get_console_message
+ */
+import { z } from 'zod';
+import type { ToolHandler } from './types.js';
+export declare const listConsoleMessagesSchema: {
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    pageIdx: z.ZodOptional<z.ZodNumber>;
+    types: z.ZodOptional<z.ZodArray<z.ZodEnum<["log", "debug", "info", "error", "warn", "trace", "assert", "dir", "table", "clear", "count", "timeEnd"]>, "many">>;
+};
+export declare const listConsoleMessages: ToolHandler;
+export declare const getConsoleMessageSchema: {
+    msgid: z.ZodNumber;
+};
+export declare const getConsoleMessage: ToolHandler;
+//# sourceMappingURL=console.d.ts.map

package/build/src/tools/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../src/tools/console.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAKtB,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,YAAY,CAAC;AAiB5C,eAAO,MAAM,yBAAyB;;;;CAuBrC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,WAgBjC,CAAC;AAEF,eAAO,MAAM,uBAAuB;;CAMnC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,WAgB/B,CAAC"}

package/build/src/tools/console.js

@@ -0,0 +1,76 @@
+/**
+ * Console debugging tools.
+ * Mirrors chrome-devtools-mcp tool names: list_console_messages, get_console_message
+ */
+import { z } from 'zod';
+import { formatConsoleMessage, formatConsoleMessages, } from '../formatters/ConsoleFormatter.js';
+const FILTERABLE_LEVELS = [
+    'log',
+    'debug',
+    'info',
+    'error',
+    'warn',
+    'trace',
+    'assert',
+    'dir',
+    'table',
+    'clear',
+    'count',
+    'timeEnd',
+];
+export const listConsoleMessagesSchema = {
+    pageSize: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe('Maximum number of messages to return. When omitted, returns all messages.'),
+    pageIdx: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe('Page number to return (0-based). When omitted, returns the first page.'),
+    types: z
+        .array(z.enum(FILTERABLE_LEVELS))
+        .optional()
+        .describe('Filter messages to only return messages of the specified types. When omitted or empty, returns all messages.'),
+};
+export const listConsoleMessages = async (params, driver) => {
+    const allLogs = await driver.getConsoleLogs();
+    const filtered = await driver.getConsoleLogs({
+        types: params.types,
+        pageSize: params.pageSize,
+        pageIdx: params.pageIdx,
+    });
+    return {
+        content: [
+            {
+                type: 'text',
+                text: formatConsoleMessages(filtered, allLogs.length),
+            },
+        ],
+    };
+};
+export const getConsoleMessageSchema = {
+    msgid: z
+        .number()
+        .describe('The msgid of a console message on the page from the listed console messages'),
+};
+export const getConsoleMessage = async (params, driver) => {
+    const log = await driver.getConsoleMessage(params.msgid);
+    if (!log) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Console message with msgid=${params.msgid} not found.`,
+                },
+            ],
+        };
+    }
+    return {
+        content: [{ type: 'text', text: formatConsoleMessage(log) }],
+    };
+};
+//# sourceMappingURL=console.js.map

package/build/src/tools/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../../src/tools/console.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAG3C,MAAM,iBAAiB,GAAG;IACxB,KAAK;IACL,OAAO;IACP,MAAM;IACN,OAAO;IACP,MAAM;IACN,OAAO;IACP,QAAQ;IACR,KAAK;IACL,OAAO;IACP,OAAO;IACP,OAAO;IACP,SAAS;CACD,CAAC;AAEX,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CACP,2EAA2E,CAC5E;IACH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CACP,wEAAwE,CACzE;IACH,KAAK,EAAE,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;SAChC,QAAQ,EAAE;SACV,QAAQ,CACP,8GAA8G,CAC/G;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAgB,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;IACvE,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC;QAC3C,KAAK,EAAE,MAAM,CAAC,KAA6B;QAC3C,QAAQ,EAAE,MAAM,CAAC,QAA8B;QAC/C,OAAO,EAAE,MAAM,CAAC,OAA6B;KAC9C,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,qBAAqB,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC;aACtD;SACF;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,CACP,6EAA6E,CAC9E;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAgB,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;IACrE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAe,CAAC,CAAC;IACnE,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,8BAA8B,MAAM,CAAC,KAAK,aAAa;iBAC9D;aACF;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC,EAAC,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,oBAAoB,CAAC,GAAG,CAAC,EAAC,CAAC;KACpE,CAAC;AACJ,CAAC,CAAC"}