firefox-devtools-mcp 0.3.0 → 0.4.0

package/dist/index.js

@@ -12211,6 +12211,30 @@ var init_core = __esm({
         }
         return this.driver;
       }
+      /**
+       * Check if Firefox is still connected and responsive
+       * Returns false if Firefox was closed or connection is broken
+       */
+      async isConnected() {
+        if (!this.driver) {
+          return false;
+        }
+        try {
+          await this.driver.getWindowHandle();
+          return true;
+        } catch (error) {
+          logDebug("Connection check failed: Firefox is not responsive");
+          return false;
+        }
+      }
+      /**
+       * Reset driver state (used when Firefox is detected as closed)
+       */
+      reset() {
+        this.driver = null;
+        this.currentContextId = null;
+        logDebug("Driver state reset");
+      }
       /**
        * Get current browsing context ID
        */
@@ -12986,6 +13010,7 @@ var init_pages = __esm({
         if (index >= 0 && index < handles.length) {
           await this.driver.switchTo().window(handles[index]);
           this.setCurrentContextId(handles[index]);
+          this.cachedSelectedIdx = index;
         }
       }
       /**
@@ -12996,6 +13021,7 @@ var init_pages = __esm({
         const handles = await this.driver.getAllWindowHandles();
         const newIdx = handles.length - 1;
         this.setCurrentContextId(handles[newIdx]);
+        this.cachedSelectedIdx = newIdx;
         await this.driver.get(url);
         return newIdx;
       }
@@ -13300,10 +13326,12 @@ var init_manager = __esm({
           const currentFilePath = fileURLToPath(currentFileUrl);
           const currentDir = dirname(currentFilePath);
           const possiblePaths = [
-            // Production: relative to compiled dist/index.js location
-            resolve(currentDir, "../../snapshot.injected.global.js"),
-            // Alternative: relative to current working directory
-            resolve(process.cwd(), "dist/snapshot.injected.global.js")
+            // Production: relative to bundled dist/index.js (same directory)
+            resolve(currentDir, "snapshot.injected.global.js"),
+            // Development: relative to current working directory
+            resolve(process.cwd(), "dist/snapshot.injected.global.js"),
+            // npx: package is in node_modules, try to find it relative to the binary
+            resolve(currentDir, "../snapshot.injected.global.js")
           ];
           const attemptedPaths = [];
           for (const path of possiblePaths) {
@@ -13358,7 +13386,8 @@ ${attemptedPaths.map((p) => `  - ${p}`).join("\n")}`
           root: result.tree,
           snapshotId,
           timestamp: Date.now(),
-          truncated: result.truncated || false
+          truncated: result.truncated || false,
+          uidMap: result.uidMap
         };
         const snapshot = {
           text: formatSnapshotTree(result.tree),
@@ -13726,6 +13755,24 @@ var init_firefox = __esm({
       getDriver() {
         return this.core.getDriver();
       }
+      /**
+       * Check if Firefox is still connected and responsive
+       * Returns false if Firefox was closed or connection is broken
+       */
+      async isConnected() {
+        return await this.core.isConnected();
+      }
+      /**
+       * Reset all internal state (used when Firefox is detected as closed)
+       */
+      reset() {
+        this.core.reset();
+        this.consoleEvents = null;
+        this.networkEvents = null;
+        this.dom = null;
+        this.pages = null;
+        this.snapshot = null;
+      }
       // ============================================================================
       // Cleanup
       // ============================================================================
@@ -13737,6 +13784,33 @@ var init_firefox = __esm({
 });
 
 // src/utils/response-helpers.ts
+function estimateTokens(text) {
+  return Math.ceil(text.length / 4);
+}
+function truncateText(text, maxChars, suffix = "\n\n[... truncated - exceeded size limit]") {
+  if (text.length <= maxChars) {
+    return text;
+  }
+  return text.slice(0, maxChars - suffix.length) + suffix;
+}
+function truncateHeaders(headers) {
+  if (!headers) {
+    return null;
+  }
+  const result = {};
+  let totalChars = 0;
+  for (const [key, value] of Object.entries(headers)) {
+    const truncatedValue = value.length > TOKEN_LIMITS.MAX_HEADER_VALUE_CHARS ? value.slice(0, TOKEN_LIMITS.MAX_HEADER_VALUE_CHARS) + "...[truncated]" : value;
+    const entrySize = key.length + truncatedValue.length;
+    if (totalChars + entrySize > TOKEN_LIMITS.MAX_HEADERS_TOTAL_CHARS) {
+      result["__truncated__"] = "Headers truncated due to size limit";
+      break;
+    }
+    result[key] = truncatedValue;
+    totalChars += entrySize;
+  }
+  return result;
+}
 function successResponse(message) {
   return {
     content: [
@@ -13769,9 +13843,26 @@ function jsonResponse(data) {
     ]
   };
 }
+var TOKEN_LIMITS;
 var init_response_helpers = __esm({
   "src/utils/response-helpers.ts"() {
     "use strict";
+    TOKEN_LIMITS = {
+      /** Maximum characters for a single response (~12.5k tokens at ~4 chars/token) */
+      MAX_RESPONSE_CHARS: 5e4,
+      /** Maximum characters for screenshot base64 data (~10k tokens) */
+      MAX_SCREENSHOT_CHARS: 4e4,
+      /** Maximum characters per console message text */
+      MAX_CONSOLE_MESSAGE_CHARS: 2e3,
+      /** Maximum characters for network header values (per header) */
+      MAX_HEADER_VALUE_CHARS: 500,
+      /** Maximum total characters for all headers combined */
+      MAX_HEADERS_TOTAL_CHARS: 5e3,
+      /** Hard cap on snapshot lines (even if user requests more) */
+      MAX_SNAPSHOT_LINES_CAP: 500,
+      /** Warning threshold - show warning when response exceeds this */
+      WARNING_THRESHOLD_CHARS: 3e4
+    };
   }
 });
 
@@ -14034,6 +14125,10 @@ async function handleListConsoleMessages(args2) {
     if (source) {
       messages = messages.filter((msg) => msg.source?.toLowerCase() === source.toLowerCase());
     }
+    messages = messages.map((msg) => ({
+      ...msg,
+      text: truncateText(msg.text, TOKEN_LIMITS.MAX_CONSOLE_MESSAGE_CHARS, "...[truncated]")
+    }));
     const maxLimit = limit ?? DEFAULT_LIMIT;
     const filteredCount = messages.length;
     const truncated = messages.length > maxLimit;
@@ -14292,8 +14387,8 @@ async function handleListNetworkRequests(args2) {
           resourceType: req.resourceType,
           isXHR: req.isXHR,
           timings: req.timings || null,
-          requestHeaders: req.requestHeaders || null,
-          responseHeaders: req.responseHeaders || null
+          requestHeaders: truncateHeaders(req.requestHeaders),
+          responseHeaders: truncateHeaders(req.responseHeaders)
         }));
       }
       return jsonResponse(responseData);
@@ -14338,8 +14433,8 @@ async function handleListNetworkRequests(args2) {
         resourceType: req.resourceType,
         isXHR: req.isXHR,
         timings: req.timings || null,
-        requestHeaders: req.requestHeaders || null,
-        responseHeaders: req.responseHeaders || null
+        requestHeaders: truncateHeaders(req.requestHeaders),
+        responseHeaders: truncateHeaders(req.responseHeaders)
       }));
       return successResponse(
         `Found ${requests.length} requests${hasMore ? ` (showing first ${limit})` : ""}
@@ -14411,8 +14506,8 @@ Please use one of these IDs with the "id" parameter:
       isXHR: request.isXHR ?? false,
       timestamp: request.timestamp ?? null,
       timings: request.timings ?? null,
-      requestHeaders: request.requestHeaders ?? null,
-      responseHeaders: request.responseHeaders ?? null
+      requestHeaders: truncateHeaders(request.requestHeaders),
+      responseHeaders: truncateHeaders(request.responseHeaders)
     };
     if (format === "json") {
       return jsonResponse(details);
@@ -14518,11 +14613,13 @@ var init_network2 = __esm({
 async function handleTakeSnapshot(args2) {
   try {
     const {
-      maxLines = MAX_SNAPSHOT_LINES,
+      maxLines: requestedMaxLines = DEFAULT_SNAPSHOT_LINES,
       includeAttributes = false,
       includeText = true,
       maxDepth
     } = args2 || {};
+    const maxLines = Math.min(Math.max(1, requestedMaxLines), TOKEN_LIMITS.MAX_SNAPSHOT_LINES_CAP);
+    const wasCapped = requestedMaxLines > TOKEN_LIMITS.MAX_SNAPSHOT_LINES_CAP;
     const { getFirefox: getFirefox2 } = await init_index().then(() => index_exports);
     const firefox3 = await getFirefox2();
     const snapshot = await firefox3.takeSnapshot();
@@ -14539,6 +14636,11 @@ async function handleTakeSnapshot(args2) {
     const truncated = lines.length > maxLines;
     const displayLines = truncated ? lines.slice(0, maxLines) : lines;
     let output = "\u{1F4F8} Snapshot taken\n\n";
+    if (wasCapped) {
+      output += `\u26A0\uFE0F maxLines capped at ${TOKEN_LIMITS.MAX_SNAPSHOT_LINES_CAP} (requested: ${requestedMaxLines}) to prevent token overflow
+
+`;
+    }
     output += "\u2550\u2550\u2550 HOW TO USE THIS SNAPSHOT \u2550\u2550\u2550\n";
     output += "\u2022 To interact with elements: use click_by_uid, hover_by_uid, or fill_by_uid with the UID\n";
     output += "\u2022 After navigation: always call take_snapshot again (UIDs become stale)\n";
@@ -14608,12 +14710,12 @@ async function handleClearSnapshot(_args) {
     return errorResponse(error);
   }
 }
-var MAX_SNAPSHOT_LINES, takeSnapshotTool, resolveUidToSelectorTool, clearSnapshotTool;
+var DEFAULT_SNAPSHOT_LINES, takeSnapshotTool, resolveUidToSelectorTool, clearSnapshotTool;
 var init_snapshot2 = __esm({
   "src/tools/snapshot.ts"() {
     "use strict";
     init_response_helpers();
-    MAX_SNAPSHOT_LINES = 100;
+    DEFAULT_SNAPSHOT_LINES = 100;
     takeSnapshotTool = {
       name: "take_snapshot",
       description: "Capture a textual page snapshot with stable UIDs for elements. Always take a fresh snapshot after navigation or major DOM changes. TIP: Use the UIDs with click_by_uid / fill_by_uid / hover_by_uid. The output may be truncated for readability.",
@@ -14972,6 +15074,37 @@ var init_input = __esm({
 });
 
 // src/tools/screenshot.ts
+function buildScreenshotResponse(base64Png, context) {
+  const sizeKB = Math.round(base64Png.length / 1024);
+  const estimatedTokens = estimateTokens(base64Png);
+  if (base64Png.length > TOKEN_LIMITS.MAX_SCREENSHOT_CHARS) {
+    const truncatedData = base64Png.slice(0, TOKEN_LIMITS.MAX_SCREENSHOT_CHARS);
+    return successResponse(
+      `\u{1F4F8} ${context} (${sizeKB}KB)
+
+\u26A0\uFE0F Screenshot truncated (~${Math.round(estimatedTokens / 1e3)}k tokens exceeds limit)
+Only first ${Math.round(TOKEN_LIMITS.MAX_SCREENSHOT_CHARS / 1024)}KB shown.
+TIP: For full screenshots, use a dedicated screenshot tool or save to file.
+
+Base64 PNG data (truncated):
+${truncatedData}
+
+[...truncated]`
+    );
+  }
+  let warning = "";
+  if (base64Png.length > TOKEN_LIMITS.WARNING_THRESHOLD_CHARS) {
+    warning = `\u26A0\uFE0F Large screenshot (~${Math.round(estimatedTokens / 1e3)}k tokens) - may fill context quickly
+
+`;
+  }
+  return successResponse(
+    `\u{1F4F8} ${context} (${sizeKB}KB)
+
+` + warning + `Base64 PNG data:
+${base64Png}`
+  );
+}
 async function handleScreenshotPage(_args) {
   try {
     const { getFirefox: getFirefox2 } = await init_index().then(() => index_exports);
@@ -14980,12 +15113,7 @@ async function handleScreenshotPage(_args) {
     if (!base64Png || typeof base64Png !== "string") {
       throw new Error("Failed to capture screenshot: invalid data returned");
     }
-    return successResponse(
-      `\u{1F4F8} Page screenshot captured (${Math.round(base64Png.length / 1024)}KB)
-
-Base64 PNG data:
-${base64Png}`
-    );
+    return buildScreenshotResponse(base64Png, "Page screenshot captured");
   } catch (error) {
     return errorResponse(
       new Error(
@@ -15009,12 +15137,7 @@ async function handleScreenshotByUid(args2) {
       if (!base64Png || typeof base64Png !== "string") {
         throw new Error("Failed to capture screenshot: invalid data returned");
       }
-      return successResponse(
-        `\u{1F4F8} Element screenshot captured for UID "${uid}" (${Math.round(base64Png.length / 1024)}KB)
-
-Base64 PNG data:
-${base64Png}`
-      );
+      return buildScreenshotResponse(base64Png, `Element screenshot captured for UID "${uid}"`);
     } catch (error) {
       const errorMsg = error.message;
       if (errorMsg.includes("stale") || errorMsg.includes("Snapshot") || errorMsg.includes("UID") || errorMsg.includes("not found")) {
@@ -15238,6 +15361,33 @@ var init_tools = __esm({
   }
 });
 
+// src/utils/errors.ts
+function isDisconnectionError(error) {
+  if (error instanceof FirefoxDisconnectedError) {
+    return true;
+  }
+  if (error instanceof Error) {
+    const message = error.message.toLowerCase();
+    return message.includes("session deleted") || message.includes("session not created") || message.includes("no such window") || message.includes("no such session") || message.includes("target window already closed") || message.includes("unable to connect") || message.includes("connection refused") || message.includes("not connected") || message.includes("driver not connected") || message.includes("invalid session id") || message.includes("browsing context has been discarded");
+  }
+  return false;
+}
+var FirefoxDisconnectedError;
+var init_errors2 = __esm({
+  "src/utils/errors.ts"() {
+    "use strict";
+    FirefoxDisconnectedError = class extends Error {
+      constructor(reason) {
+        const baseMessage = "Firefox browser is not connected";
+        const instruction = "The Firefox browser window was closed by the user. To continue browser automation, ask the user to restart the firefox-devtools-mcp server (they need to restart Claude Code or the MCP connection). This will launch a new Firefox instance.";
+        const fullMessage = reason ? `${baseMessage}: ${reason}. ${instruction}` : `${baseMessage}. ${instruction}`;
+        super(fullMessage);
+        this.name = "FirefoxDisconnectedError";
+      }
+    };
+  }
+});
+
 // node_modules/dotenv/package.json
 var require_package = __commonJS({
   "node_modules/dotenv/package.json"(exports, module) {
@@ -15640,28 +15790,45 @@ var require_main = __commonJS({
 var index_exports = {};
 __export(index_exports, {
   FirefoxDevTools: () => FirefoxClient,
+  FirefoxDisconnectedError: () => FirefoxDisconnectedError,
   args: () => args,
-  getFirefox: () => getFirefox
+  getFirefox: () => getFirefox,
+  isDisconnectionError: () => isDisconnectionError,
+  resetFirefox: () => resetFirefox
 });
 import { version } from "process";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { resolve as resolve2 } from "path";
 import { realpathSync } from "fs";
-async function getFirefox() {
-  if (!firefox2) {
-    log("Initializing Firefox DevTools connection...");
-    const options = {
-      firefoxPath: args.firefoxPath ?? void 0,
-      headless: args.headless,
-      profilePath: args.profilePath ?? void 0,
-      viewport: args.viewport ?? void 0,
-      args: args.firefoxArg ?? void 0,
-      startUrl: args.startUrl ?? void 0
-    };
-    firefox2 = new FirefoxClient(options);
-    await firefox2.connect();
-    log("Firefox DevTools connection established");
+function resetFirefox() {
+  if (firefox2) {
+    firefox2.reset();
+    firefox2 = null;
   }
+  log("Firefox instance reset - will reconnect on next tool call");
+}
+async function getFirefox() {
+  if (firefox2) {
+    const isConnected = await firefox2.isConnected();
+    if (!isConnected) {
+      log("Firefox connection lost - browser was closed or disconnected");
+      resetFirefox();
+      throw new FirefoxDisconnectedError("Browser was closed");
+    }
+    return firefox2;
+  }
+  log("Initializing Firefox DevTools connection...");
+  const options = {
+    firefoxPath: args.firefoxPath ?? void 0,
+    headless: args.headless,
+    profilePath: args.profilePath ?? void 0,
+    viewport: args.viewport ?? void 0,
+    args: args.firefoxArg ?? void 0,
+    startUrl: args.startUrl ?? void 0
+  };
+  firefox2 = new FirefoxClient(options);
+  await firefox2.connect();
+  log("Firefox DevTools connection established");
   return firefox2;
 }
 async function main() {
@@ -15729,7 +15896,9 @@ var init_index = __esm({
     init_cli();
     init_firefox();
     init_tools();
+    init_errors2();
     init_firefox();
+    init_errors2();
     if (process.env.NODE_ENV !== "production") {
       try {
         const { config } = await Promise.resolve().then(() => __toESM(require_main(), 1));
@@ -15829,8 +15998,11 @@ var init_index = __esm({
 await init_index();
 export {
   FirefoxClient as FirefoxDevTools,
+  FirefoxDisconnectedError,
   args,
-  getFirefox
+  getFirefox,
+  isDisconnectionError,
+  resetFirefox
 };
 /*! Bundled license information:
 

package/dist/snapshot.injected.global.js

@@ -1 +1 @@
-"use strict";var __SnapshotInjected=(()=>{var h=Object.defineProperty;var W=Object.getOwnPropertyDescriptor;var V=Object.getOwnPropertyNames;var U=Object.prototype.hasOwnProperty;var q=(t,r)=>{for(var e in r)h(t,e,{get:r[e],enumerable:!0})},z=(t,r,e,i)=>{if(r&&typeof r=="object"||typeof r=="function")for(let o of V(r))!U.call(t,o)&&o!==e&&h(t,o,{get:()=>r[o],enumerable:!(i=W(r,o))||i.enumerable});return t};var B=t=>z(h({},"__esModule",{value:!0}),t);var rt={};q(rt,{createSnapshot:()=>P});var v=["a","button","input","select","textarea","img","video","audio","iframe"],J=["nav","main","section","article","header","footer"],K=["div","span","p","li","ul","ol"];function L(t){if(!t||t.nodeType!==Node.ELEMENT_NODE)return!1;try{let e=window.getComputedStyle(t);if(e.display==="none"||e.visibility==="hidden"||e.opacity==="0")return!1}catch{return!1}let r=t.tagName.toLowerCase();if(v.indexOf(r)!==-1||t.hasAttribute("role")||t.hasAttribute("aria-label")||/^h[1-6]$/.test(r)||J.indexOf(r)!==-1)return!0;if(K.indexOf(r)!==-1){let e=(t.textContent||"").trim();if(e.length>0&&e.length<500||t.id||t.className)return!0}return!1}function M(t){if(t.tabIndex>=0)return!0;let e=t.tagName.toLowerCase();return["a","button","input","select","textarea"].indexOf(e)!==-1}function O(t){let r=t.tagName.toLowerCase();if(v.indexOf(r)!==-1)return!0;let e=t.getAttribute("role");return!!(e&&["button","link","menuitem","tab"].indexOf(e)!==-1||t.hasAttribute("onclick"))}var Q=100;function k(t){if(t.hasAttribute("aria-label"))return t.getAttribute("aria-label")||void 0;let e=t.id;if(e){let o=document.querySelector(`label[for="${e}"]`);if(o?.textContent)return o.textContent.trim()}if(t.hasAttribute("placeholder"))return t.getAttribute("placeholder")||void 0;if(t.hasAttribute("title"))return t.getAttribute("title")||void 0;if(t.hasAttribute("alt"))return t.getAttribute("alt")||void 0;let i=t.tagName.toLowerCase();if(["button","a","h1","h2","h3","h4","h5","h6"].indexOf(i)!==-1)return g(t)}function g(t){let r="";for(let i=0;i<t.childNodes.length;i++){let o=t.childNodes[i];o&&o.nodeType===Node.TEXT_NODE&&(r+=o.textContent||"")}let e=r.trim();if(e)return e.substring(0,Q)}function $(t){let r={},e=!1,i=["disabled","hidden","selected","expanded"];for(let a of i){let n=t.getAttribute(`aria-${a}`);n!==null&&(r[a]=n==="true",e=!0)}let o=["checked","pressed"];for(let a of o){let n=t.getAttribute(`aria-${a}`);n!==null&&(n==="mixed"?r[a]="mixed":r[a]=n==="true",e=!0)}let l=["autocomplete","haspopup","invalid","label","labelledby","describedby","controls"];for(let a of l){let n=t.getAttribute(`aria-${a}`);n&&(r[a]=n,e=!0)}let s=t.getAttribute("aria-level");if(s){let a=parseInt(s,10);isNaN(a)||(r.level=a,e=!0)}return e?r:void 0}function I(t){let r={};try{let e=window.getComputedStyle(t);r.visible=e.display!=="none"&&e.visibility!=="hidden"&&e.opacity!=="0"}catch{r.visible=!1}return r.accessible=r.visible&&!t.getAttribute("aria-hidden"),r.focusable=M(t),r.interactive=O(t),r}var Y=["id","data-testid","data-test-id"];function R(t){let r=[],e=t;for(;e&&e.nodeType===Node.ELEMENT_NODE;){let i=e.nodeName.toLowerCase(),o=!1;for(let n of Y){let u=e.getAttribute(n);if(u){n==="id"?i+="#"+CSS.escape(u):i+=`[${n}="${X(u)}"]`,r.unshift(i),o=!0;break}}if(o)break;let l=e.getAttribute("aria-label"),s=e.getAttribute("role");if(l&&s){i+=`[role="${s}"][aria-label="${X(l)}"]`,r.unshift(i),e=e.parentElement;continue}let a=e.parentElement?.children;if(a&&a.length>1){let n=1;for(let u=0;u<a.length;u++){let d=a[u];if(d){if(d===e)break;d.nodeName===e.nodeName&&n++}}(n>1||a.length>1&&a[0]!==e)&&(i+=`:nth-of-type(${n})`)}if(r.unshift(tt(i)),e=e.parentElement,e&&e.nodeName.toLowerCase()==="body"){r.unshift("body");break}}return r.join(" > ")}function G(t){let r=t.id;if(r)return`//*[@id="${Z(r)}"]`;let e=[],i=t;for(;i&&i.nodeType===Node.ELEMENT_NODE;){let o=i.nodeName.toLowerCase(),l=1,s=i.previousElementSibling;for(;s;)s.nodeName.toLowerCase()===o&&l++,s=s.previousElementSibling;let a=i.parentElement,n=!1;a&&(n=Array.from(a.children).filter(E=>E.nodeName.toLowerCase()===o).length>1);let u=n?`${o}[${l}]`:o;if(e.unshift(u),i=i.parentElement,i&&i.nodeName.toLowerCase()==="html"){e.unshift("html");break}}return"/"+e.join("/")}function X(t){return t.replace(/"/g,'\\"').substring(0,64)}function Z(t){return t.indexOf('"')===-1||t.indexOf("'")===-1?t:`concat(${t.split('"').map((e,i,o)=>i===o.length-1?e?`"${e}"`:"":e?`"${e}",'"'`:`"'"`).filter(e=>e).join(",")})`}function tt(t){return t.length<=64?t:t.substring(0,64)}var et=10,H=1e3;function D(t,r,e=!0){let i=0,o=[],l=!1;function s(n,u){if(u>et||i>=H)return l=!0,null;let d=n.tagName.toLowerCase();if(!(d==="body"||d==="html")&&!L(n))return null;let A=`${r}_${i++}`,j=R(n),F=G(n);o.push({uid:A,css:j,xpath:F});let b=n,N=n.getAttribute("role"),T=k(n),y=g(n),x=b.value,C=b.href,S=b.src,w=$(n),_=I(n),c={uid:A,tag:d,...N&&{role:N},...T&&{name:T},...x&&{value:x},...C&&{href:C},...S&&{src:S},...y&&{text:y},...w&&{aria:w},..._&&{computed:_},children:[]};if(d==="iframe"&&e){try{let f=n,p=f.contentDocument||f.contentWindow?.document;if(p?.body){let m=s(p.body,u+1);m&&(m.isIframe=!0,m.frameSrc=f.src,c.children.push(m))}else c.isIframe=!0,c.frameSrc=f.src,c.crossOrigin=!0}catch{c.isIframe=!0,c.frameSrc=n.src,c.crossOrigin=!0}return c}for(let f=0;f<n.children.length;f++){if(i>=H){l=!0;break}let p=n.children[f];if(!p)continue;let m=s(p,u+1);m&&c.children.push(m)}return c}return{tree:s(t,0),uidMap:o,truncated:l}}function P(t){try{let r=D(document.body,t,!0);if(!r.tree)throw new Error("Failed to generate tree");return r}catch{return{tree:null,uidMap:[],truncated:!1}}}typeof window<"u"&&(window.__createSnapshot=P);return B(rt);})();
+"use strict";var __SnapshotInjected=(()=>{var h=Object.defineProperty;var W=Object.getOwnPropertyDescriptor;var V=Object.getOwnPropertyNames;var U=Object.prototype.hasOwnProperty;var q=(t,r)=>{for(var e in r)h(t,e,{get:r[e],enumerable:!0})},z=(t,r,e,i)=>{if(r&&typeof r=="object"||typeof r=="function")for(let o of V(r))!U.call(t,o)&&o!==e&&h(t,o,{get:()=>r[o],enumerable:!(i=W(r,o))||i.enumerable});return t};var B=t=>z(h({},"__esModule",{value:!0}),t);var rt={};q(rt,{createSnapshot:()=>P});var v=["a","button","input","select","textarea","img","video","audio","iframe"],J=["nav","main","section","article","header","footer","form"],K=["div","span","p","li","ul","ol"];function L(t){if(!t||t.nodeType!==Node.ELEMENT_NODE)return!1;try{let e=window.getComputedStyle(t);if(e.display==="none"||e.visibility==="hidden"||e.opacity==="0")return!1}catch{return!1}let r=t.tagName.toLowerCase();if(v.indexOf(r)!==-1||t.hasAttribute("role")||t.hasAttribute("aria-label")||/^h[1-6]$/.test(r)||J.indexOf(r)!==-1)return!0;if(K.indexOf(r)!==-1){let e=(t.textContent||"").trim();if(e.length>0&&e.length<500||t.id||t.className)return!0}return!1}function M(t){if(t.tabIndex>=0)return!0;let e=t.tagName.toLowerCase();return["a","button","input","select","textarea"].indexOf(e)!==-1}function O(t){let r=t.tagName.toLowerCase();if(v.indexOf(r)!==-1)return!0;let e=t.getAttribute("role");return!!(e&&["button","link","menuitem","tab"].indexOf(e)!==-1||t.hasAttribute("onclick"))}var Q=100;function k(t){if(t.hasAttribute("aria-label"))return t.getAttribute("aria-label")||void 0;let e=t.id;if(e){let o=document.querySelector(`label[for="${e}"]`);if(o?.textContent)return o.textContent.trim()}if(t.hasAttribute("placeholder"))return t.getAttribute("placeholder")||void 0;if(t.hasAttribute("title"))return t.getAttribute("title")||void 0;if(t.hasAttribute("alt"))return t.getAttribute("alt")||void 0;let i=t.tagName.toLowerCase();if(["button","a","h1","h2","h3","h4","h5","h6"].indexOf(i)!==-1)return g(t)}function g(t){let r="";for(let i=0;i<t.childNodes.length;i++){let o=t.childNodes[i];o&&o.nodeType===Node.TEXT_NODE&&(r+=o.textContent||"")}let e=r.trim();if(e)return e.substring(0,Q)}function $(t){let r={},e=!1,i=["disabled","hidden","selected","expanded"];for(let a of i){let n=t.getAttribute(`aria-${a}`);n!==null&&(r[a]=n==="true",e=!0)}let o=["checked","pressed"];for(let a of o){let n=t.getAttribute(`aria-${a}`);n!==null&&(n==="mixed"?r[a]="mixed":r[a]=n==="true",e=!0)}let l=["autocomplete","haspopup","invalid","label","labelledby","describedby","controls"];for(let a of l){let n=t.getAttribute(`aria-${a}`);n&&(r[a]=n,e=!0)}let s=t.getAttribute("aria-level");if(s){let a=parseInt(s,10);isNaN(a)||(r.level=a,e=!0)}return e?r:void 0}function I(t){let r={};try{let e=window.getComputedStyle(t);r.visible=e.display!=="none"&&e.visibility!=="hidden"&&e.opacity!=="0"}catch{r.visible=!1}return r.accessible=r.visible&&!t.getAttribute("aria-hidden"),r.focusable=M(t),r.interactive=O(t),r}var Y=["id","data-testid","data-test-id"];function R(t){let r=[],e=t;for(;e&&e.nodeType===Node.ELEMENT_NODE;){let i=e.nodeName.toLowerCase(),o=!1;for(let n of Y){let u=e.getAttribute(n);if(u){n==="id"?i+="#"+CSS.escape(u):i+=`[${n}="${X(u)}"]`,r.unshift(i),o=!0;break}}if(o)break;let l=e.getAttribute("aria-label"),s=e.getAttribute("role");if(l&&s){i+=`[role="${s}"][aria-label="${X(l)}"]`,r.unshift(i),e=e.parentElement;continue}let a=e.parentElement?.children;if(a&&a.length>1){let n=1;for(let u=0;u<a.length;u++){let d=a[u];if(d){if(d===e)break;d.nodeName===e.nodeName&&n++}}(n>1||a.length>1&&a[0]!==e)&&(i+=`:nth-of-type(${n})`)}if(r.unshift(tt(i)),e=e.parentElement,e&&e.nodeName.toLowerCase()==="body"){r.unshift("body");break}}return r.join(" > ")}function G(t){let r=t.id;if(r)return`//*[@id="${Z(r)}"]`;let e=[],i=t;for(;i&&i.nodeType===Node.ELEMENT_NODE;){let o=i.nodeName.toLowerCase(),l=1,s=i.previousElementSibling;for(;s;)s.nodeName.toLowerCase()===o&&l++,s=s.previousElementSibling;let a=i.parentElement,n=!1;a&&(n=Array.from(a.children).filter(E=>E.nodeName.toLowerCase()===o).length>1);let u=n?`${o}[${l}]`:o;if(e.unshift(u),i=i.parentElement,i&&i.nodeName.toLowerCase()==="html"){e.unshift("html");break}}return"/"+e.join("/")}function X(t){return t.replace(/"/g,'\\"').substring(0,64)}function Z(t){return t.indexOf('"')===-1||t.indexOf("'")===-1?t:`concat(${t.split('"').map((e,i,o)=>i===o.length-1?e?`"${e}"`:"":e?`"${e}",'"'`:`"'"`).filter(e=>e).join(",")})`}function tt(t){return t.length<=64?t:t.substring(0,64)}var et=10,H=1e3;function D(t,r,e=!0){let i=0,o=[],l=!1;function s(n,u){if(u>et||i>=H)return l=!0,null;let d=n.tagName.toLowerCase();if(!(d==="body"||d==="html")&&!L(n))return null;let A=`${r}_${i++}`,j=R(n),F=G(n);o.push({uid:A,css:j,xpath:F});let b=n,N=n.getAttribute("role"),T=k(n),y=g(n),x=b.value,C=b.href,S=b.src,w=$(n),_=I(n),c={uid:A,tag:d,...N&&{role:N},...T&&{name:T},...x&&{value:x},...C&&{href:C},...S&&{src:S},...y&&{text:y},...w&&{aria:w},..._&&{computed:_},children:[]};if(d==="iframe"&&e){try{let f=n,p=f.contentDocument||f.contentWindow?.document;if(p?.body){let m=s(p.body,u+1);m&&(m.isIframe=!0,m.frameSrc=f.src,c.children.push(m))}else c.isIframe=!0,c.frameSrc=f.src,c.crossOrigin=!0}catch{c.isIframe=!0,c.frameSrc=n.src,c.crossOrigin=!0}return c}for(let f=0;f<n.children.length;f++){if(i>=H){l=!0;break}let p=n.children[f];if(!p)continue;let m=s(p,u+1);m&&c.children.push(m)}return c}return{tree:s(t,0),uidMap:o,truncated:l}}function P(t){try{let r=D(document.body,t,!0);if(!r.tree)throw new Error("Failed to generate tree");return r}catch{return{tree:null,uidMap:[],truncated:!1}}}typeof window<"u"&&(window.__createSnapshot=P);return B(rt);})();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firefox-devtools-mcp",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Model Context Protocol (MCP) server for Firefox DevTools automation",
   "author": "freema",
   "license": "MIT",