auto-chrome-mcp-shared 1.7.0 → 1.9.0

package/dist/index.js

@@ -804,7 +804,7 @@ Tip: If the returned elements do not include the specific element you need, use
   },
   {
     name: TOOL_NAMES.BROWSER.SWITCH_TAB,
-    description: "Switch to a specific browser tab",
+    description: "Bring a tab to the front (activates it and can take OS focus). Use ONLY when the user explicitly asked to switch/show a tab. To retarget automation at another tab without disturbing the user, use chrome_set_work_tab instead - this tool is exempt from the no-interference gate, so it will actually change what the user is looking at.",
     inputSchema: {
       type: "object",
       properties: {
@@ -822,7 +822,7 @@ Tip: If the returned elements do not include the specific element you need, use
   },
   {
     name: TOOL_NAMES.BROWSER.WEB_FETCHER,
-    description: "Fetch content from a web page",
+    description: "Read a page as text (reader view by default: nav/footer/cookie-banner noise stripped) or as cleaned HTML. Repeat reads of an unchanged tab return {unchanged:true} instead of the body. Both modes are length-capped and report fullTextChars/fullHtmlChars vs returnedChars so you can tell what was cut. For a handful of known fields prefer chrome_extract, and for clicking/typing prefer chrome_read_page (it returns element refs); use this when you want the page content itself.",
     inputSchema: {
       type: "object",
       properties: {
@@ -840,7 +840,7 @@ Tip: If the returned elements do not include the specific element you need, use
         },
         htmlContent: {
           type: "boolean",
-          description: "Get the visible HTML content of the page. If true, textContent will be ignored (default: false)"
+          description: "Return cleaned HTML (scripts/styles/SVG stripped) instead of text. Much more expensive than text \u2014 use it only when you need markup/attributes, and pair it with selector. If true, textContent is ignored (default: false)"
         },
         textContent: {
           type: "boolean",
@@ -850,13 +850,17 @@ Tip: If the returned elements do not include the specific element you need, use
           type: "string",
           description: "CSS selector to get content from a specific element. If provided, only content from this element will be returned"
         },
+        maxChars: {
+          type: "number",
+          description: "Cap on returned HTML length (default 100000). Only applies to htmlContent mode; the result reports fullHtmlChars/returnedChars and truncated:true when it was cut."
+        },
         raw: {
           type: "boolean",
           description: "Text mode returns reader-view content by default (navigation/footer/cookie-banner noise stripped, main content kept \u2014 fullTextChars vs returnedChars reported). Pass true for the unfiltered full text. Default: false"
         },
         diff: {
           type: "boolean",
-          description: "When true (default), returns {unchanged:true} instead of the body if identical to your previous read of this tab \u2014 reuse the earlier content. Pass false to force full re-send."
+          description: "When true (default), returns {unchanged:true} instead of the body if identical to your previous read of this tab (text and HTML modes are tracked separately) \u2014 reuse the earlier content. Pass false to force full re-send."
         }
       },
       required: []

package/dist/index.mjs

@@ -759,7 +759,7 @@ Tip: If the returned elements do not include the specific element you need, use
   },
   {
     name: TOOL_NAMES.BROWSER.SWITCH_TAB,
-    description: "Switch to a specific browser tab",
+    description: "Bring a tab to the front (activates it and can take OS focus). Use ONLY when the user explicitly asked to switch/show a tab. To retarget automation at another tab without disturbing the user, use chrome_set_work_tab instead - this tool is exempt from the no-interference gate, so it will actually change what the user is looking at.",
     inputSchema: {
       type: "object",
       properties: {
@@ -777,7 +777,7 @@ Tip: If the returned elements do not include the specific element you need, use
   },
   {
     name: TOOL_NAMES.BROWSER.WEB_FETCHER,
-    description: "Fetch content from a web page",
+    description: "Read a page as text (reader view by default: nav/footer/cookie-banner noise stripped) or as cleaned HTML. Repeat reads of an unchanged tab return {unchanged:true} instead of the body. Both modes are length-capped and report fullTextChars/fullHtmlChars vs returnedChars so you can tell what was cut. For a handful of known fields prefer chrome_extract, and for clicking/typing prefer chrome_read_page (it returns element refs); use this when you want the page content itself.",
     inputSchema: {
       type: "object",
       properties: {
@@ -795,7 +795,7 @@ Tip: If the returned elements do not include the specific element you need, use
         },
         htmlContent: {
           type: "boolean",
-          description: "Get the visible HTML content of the page. If true, textContent will be ignored (default: false)"
+          description: "Return cleaned HTML (scripts/styles/SVG stripped) instead of text. Much more expensive than text \u2014 use it only when you need markup/attributes, and pair it with selector. If true, textContent is ignored (default: false)"
         },
         textContent: {
           type: "boolean",
@@ -805,13 +805,17 @@ Tip: If the returned elements do not include the specific element you need, use
           type: "string",
           description: "CSS selector to get content from a specific element. If provided, only content from this element will be returned"
         },
+        maxChars: {
+          type: "number",
+          description: "Cap on returned HTML length (default 100000). Only applies to htmlContent mode; the result reports fullHtmlChars/returnedChars and truncated:true when it was cut."
+        },
         raw: {
           type: "boolean",
           description: "Text mode returns reader-view content by default (navigation/footer/cookie-banner noise stripped, main content kept \u2014 fullTextChars vs returnedChars reported). Pass true for the unfiltered full text. Default: false"
         },
         diff: {
           type: "boolean",
-          description: "When true (default), returns {unchanged:true} instead of the body if identical to your previous read of this tab \u2014 reuse the earlier content. Pass false to force full re-send."
+          description: "When true (default), returns {unchanged:true} instead of the body if identical to your previous read of this tab (text and HTML modes are tracked separately) \u2014 reuse the earlier content. Pass false to force full re-send."
         }
       },
       required: []

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auto-chrome-mcp-shared",
-  "version": "1.7.0",
+  "version": "1.9.0",
   "author": "hangye (upstream), scalemaker-ship-it (auto-chrome-mcp fork)",
   "repository": {
     "type": "git",