auto-chrome-mcp-shared 1.10.1 → 1.11.1

package/dist/index.js

@@ -75,6 +75,8 @@ var NativeMessageType = /* @__PURE__ */ ((NativeMessageType2) => {
 var TOOL_NAMES = {
   BROWSER: {
     GET_WINDOWS_AND_TABS: "get_windows_and_tabs",
+    // Hidden from TOOL_SCHEMAS (schema-size reduction, v1.10.1) — still dispatch-registered
+    // and fully implemented (vector-search.ts). See docs/TOOLS.md "Hidden Tools".
     SEARCH_TABS_CONTENT: "search_tabs_content",
     NAVIGATE: "chrome_navigate",
     SCREENSHOT: "chrome_screenshot",
@@ -84,6 +86,9 @@ var TOOL_NAMES = {
     CLICK: "chrome_click_element",
     FILL: "chrome_fill_or_select",
     REQUEST_ELEMENT_SELECTION: "chrome_request_element_selection",
+    // Deprecated, hidden from TOOL_SCHEMAS — chrome_read_page replaces it as the primary
+    // discovery tool (and falls back to this logic internally when needed). Kept only for
+    // backward compatibility. See docs/TOOLS.md "Hidden Tools".
     GET_INTERACTIVE_ELEMENTS: "chrome_get_interactive_elements",
     NETWORK_CAPTURE: "chrome_network_capture",
     // Legacy tool names (kept for internal use, not exposed in TOOL_SCHEMAS)
@@ -97,6 +102,9 @@ var TOOL_NAMES = {
     BOOKMARK_SEARCH: "chrome_bookmark_search",
     BOOKMARK_ADD: "chrome_bookmark_add",
     BOOKMARK_DELETE: "chrome_bookmark_delete",
+    // Hidden from TOOL_SCHEMAS (schema-size reduction, v1.10.1) — still dispatch-registered
+    // and fully implemented (inject-script.ts); also used internally by the record-replay
+    // engine. See docs/TOOLS.md "Hidden Tools".
     INJECT_SCRIPT: "chrome_inject_script",
     SEND_COMMAND_TO_INJECT_SCRIPT: "chrome_send_command_to_inject_script",
     JAVASCRIPT: "chrome_javascript",
@@ -107,6 +115,8 @@ var TOOL_NAMES = {
     HANDLE_DIALOG: "chrome_handle_dialog",
     HANDLE_DOWNLOAD: "chrome_handle_download",
     REQUEST_USER_CONSENT: "chrome_request_user_consent",
+    // Hidden from TOOL_SCHEMAS (schema-size reduction, v1.10.1) — still dispatch-registered
+    // and fully implemented (userscript.ts). See docs/TOOLS.md "Hidden Tools".
     USERSCRIPT: "chrome_userscript",
     PERFORMANCE_START_TRACE: "performance_start_trace",
     PERFORMANCE_STOP_TRACE: "performance_stop_trace",
@@ -139,6 +149,14 @@ var P_FRAME_ID = "Target frame id (iframe).";
 var P_SELECTOR_TYPE = 'Selector type (default "css").';
 var P_WAIT_FOR_ELEMENT_MS = "Ms to wait for the element to appear/become visible before failing (default 2000; 0 = fail now).";
 var P_BACKGROUND = "Do not activate the tab or focus the window (default false).";
+var P_STEP_AS = "Name this step result so later steps can read it.";
+var P_TEMPLATES = 'Enable {{name.path}} substitution in step args, e.g. ref: "{{hit.matches[0].ref}}". Auto on when any step has "as".';
+var P_RETURN = 'Names to include in the response "results" object.';
+var P_WHEN = 'Run only if this condition holds, e.g. { path: "hit.matches", op: "notEmpty" }. Otherwise the step is skipped.';
+var P_STOP_IF = "Stop the whole run after this step when the condition holds.";
+var P_REPEAT = 'Repeat group: { max: 1-20, until?: condition, delayMs?: 0-5000 } together with a "steps" array.';
+var P_GROUP_STEPS = "Steps of a repeat group (no repeat inside a repeat).";
+var P_PARAMS = "save: declare { user: { required: true }, pw: { secret: true } }. run: values for {{params.user}}.";
 var tabIdProp = { type: "number", description: P_TAB_ID };
 var windowIdProp = { type: "number", description: P_WINDOW_ID };
 var frameIdProp = { type: "number", description: P_FRAME_ID };
@@ -158,19 +176,29 @@ var TOOL_SCHEMAS = [
       properties: {
         steps: {
           type: "array",
-          description: "Steps in order (max 20). Each: { tool: string, args?: object }",
+          description: "Steps in order (max 20). Each: { tool: string, args?: object }, or a repeat group { repeat: {...}, steps: [...] }",
           items: {
             type: "object",
             properties: {
               tool: { type: "string", description: "Tool name, e.g. chrome_click_element" },
-              args: { type: "object", description: "Arguments for the tool" }
-            },
-            required: ["tool"]
+              args: { type: "object", description: "Arguments for the tool" },
+              as: { type: "string", description: P_STEP_AS },
+              when: { type: "object", description: P_WHEN },
+              stopIf: { type: "object", description: P_STOP_IF },
+              repeat: { type: "object", description: P_REPEAT },
+              steps: { type: "array", description: P_GROUP_STEPS }
+            }
           }
         },
         continueOnError: {
           type: "boolean",
           description: "Keep running after a step fails (default false)"
+        },
+        templates: { type: "boolean", description: P_TEMPLATES },
+        return: {
+          type: "array",
+          items: { type: "string" },
+          description: P_RETURN
         }
       },
       required: ["steps"]
@@ -210,21 +238,32 @@ var TOOL_SCHEMAS = [
         name: { type: "string", description: "Shortcut name (save/run/delete)" },
         steps: {
           type: "array",
-          description: 'action="save": chrome_batch steps, max 20. Each: { tool: string, args?: object }',
+          description: 'action="save": chrome_batch steps, max 20. Each: { tool: string, args?: object }, or a repeat group',
           items: {
             type: "object",
             properties: {
               tool: { type: "string" },
-              args: { type: "object" }
-            },
-            required: ["tool"]
+              args: { type: "object" },
+              as: { type: "string", description: P_STEP_AS },
+              when: { type: "object", description: P_WHEN },
+              stopIf: { type: "object", description: P_STOP_IF },
+              repeat: { type: "object", description: P_REPEAT },
+              steps: { type: "array", description: P_GROUP_STEPS }
+            }
           }
         },
         description: { type: "string", description: 'action="save": what this shortcut does' },
         continueOnError: {
           type: "boolean",
           description: 'action="run": keep running after a failure (default false)'
-        }
+        },
+        templates: { type: "boolean", description: P_TEMPLATES },
+        return: {
+          type: "array",
+          items: { type: "string" },
+          description: P_RETURN
+        },
+        params: { type: "object", description: P_PARAMS }
       },
       required: ["action"]
     }
@@ -381,11 +420,11 @@ var TOOL_SCHEMAS = [
       properties: {
         saveToDownloads: {
           type: "boolean",
-          description: "Save the trace as a JSON file in Downloads (default true)."
+          description: "Save the trace as a JSON file under Downloads/mcp-screenshots/<date>/ (default true)."
         },
         filenamePrefix: {
           type: "string",
-          description: "Optional filename prefix for the downloaded trace JSON."
+          description: "Optional name to put in the saved trace filename."
         },
         tabId: tabIdProp
       },
@@ -664,11 +703,11 @@ var TOOL_SCHEMAS = [
         },
         saveToDownloads: {
           type: "boolean",
-          description: "Also auto-save to Downloads/mcp-screenshots/ (default: false)"
+          description: "Also auto-save to Downloads/mcp-screenshots/<date>/ (default: false)"
         },
         filename: {
           type: "string",
-          description: "Filename for saveToDownloads (sanitized, under mcp-screenshots/)."
+          description: "Name for saveToDownloads (sanitized; always kept under mcp-screenshots/<date>/)."
         }
       },
       required: []
@@ -1344,7 +1383,7 @@ var TOOL_SCHEMAS = [
         },
         filename: {
           type: "string",
-          description: "Output filename (no extension). Defaults to a timestamped name."
+          description: "Output name (no extension). Saved under Downloads/mcp-screenshots/<date>/."
         },
         captureDelayMs: {
           type: "number",
@@ -1506,7 +1545,7 @@ var TOOL_SCHEMAS = [
         windowId: windowIdProp,
         filename: {
           type: "string",
-          description: 'File name (".pdf" added). Saved under Downloads/mcp-pdf/.'
+          description: 'File name (".pdf" added). Saved under Downloads/mcp-screenshots/<date>/.'
         },
         paperFormat: {
           type: "string",

package/dist/index.mjs

@@ -30,6 +30,8 @@ var NativeMessageType = /* @__PURE__ */ ((NativeMessageType2) => {
 var TOOL_NAMES = {
   BROWSER: {
     GET_WINDOWS_AND_TABS: "get_windows_and_tabs",
+    // Hidden from TOOL_SCHEMAS (schema-size reduction, v1.10.1) — still dispatch-registered
+    // and fully implemented (vector-search.ts). See docs/TOOLS.md "Hidden Tools".
     SEARCH_TABS_CONTENT: "search_tabs_content",
     NAVIGATE: "chrome_navigate",
     SCREENSHOT: "chrome_screenshot",
@@ -39,6 +41,9 @@ var TOOL_NAMES = {
     CLICK: "chrome_click_element",
     FILL: "chrome_fill_or_select",
     REQUEST_ELEMENT_SELECTION: "chrome_request_element_selection",
+    // Deprecated, hidden from TOOL_SCHEMAS — chrome_read_page replaces it as the primary
+    // discovery tool (and falls back to this logic internally when needed). Kept only for
+    // backward compatibility. See docs/TOOLS.md "Hidden Tools".
     GET_INTERACTIVE_ELEMENTS: "chrome_get_interactive_elements",
     NETWORK_CAPTURE: "chrome_network_capture",
     // Legacy tool names (kept for internal use, not exposed in TOOL_SCHEMAS)
@@ -52,6 +57,9 @@ var TOOL_NAMES = {
     BOOKMARK_SEARCH: "chrome_bookmark_search",
     BOOKMARK_ADD: "chrome_bookmark_add",
     BOOKMARK_DELETE: "chrome_bookmark_delete",
+    // Hidden from TOOL_SCHEMAS (schema-size reduction, v1.10.1) — still dispatch-registered
+    // and fully implemented (inject-script.ts); also used internally by the record-replay
+    // engine. See docs/TOOLS.md "Hidden Tools".
     INJECT_SCRIPT: "chrome_inject_script",
     SEND_COMMAND_TO_INJECT_SCRIPT: "chrome_send_command_to_inject_script",
     JAVASCRIPT: "chrome_javascript",
@@ -62,6 +70,8 @@ var TOOL_NAMES = {
     HANDLE_DIALOG: "chrome_handle_dialog",
     HANDLE_DOWNLOAD: "chrome_handle_download",
     REQUEST_USER_CONSENT: "chrome_request_user_consent",
+    // Hidden from TOOL_SCHEMAS (schema-size reduction, v1.10.1) — still dispatch-registered
+    // and fully implemented (userscript.ts). See docs/TOOLS.md "Hidden Tools".
     USERSCRIPT: "chrome_userscript",
     PERFORMANCE_START_TRACE: "performance_start_trace",
     PERFORMANCE_STOP_TRACE: "performance_stop_trace",
@@ -94,6 +104,14 @@ var P_FRAME_ID = "Target frame id (iframe).";
 var P_SELECTOR_TYPE = 'Selector type (default "css").';
 var P_WAIT_FOR_ELEMENT_MS = "Ms to wait for the element to appear/become visible before failing (default 2000; 0 = fail now).";
 var P_BACKGROUND = "Do not activate the tab or focus the window (default false).";
+var P_STEP_AS = "Name this step result so later steps can read it.";
+var P_TEMPLATES = 'Enable {{name.path}} substitution in step args, e.g. ref: "{{hit.matches[0].ref}}". Auto on when any step has "as".';
+var P_RETURN = 'Names to include in the response "results" object.';
+var P_WHEN = 'Run only if this condition holds, e.g. { path: "hit.matches", op: "notEmpty" }. Otherwise the step is skipped.';
+var P_STOP_IF = "Stop the whole run after this step when the condition holds.";
+var P_REPEAT = 'Repeat group: { max: 1-20, until?: condition, delayMs?: 0-5000 } together with a "steps" array.';
+var P_GROUP_STEPS = "Steps of a repeat group (no repeat inside a repeat).";
+var P_PARAMS = "save: declare { user: { required: true }, pw: { secret: true } }. run: values for {{params.user}}.";
 var tabIdProp = { type: "number", description: P_TAB_ID };
 var windowIdProp = { type: "number", description: P_WINDOW_ID };
 var frameIdProp = { type: "number", description: P_FRAME_ID };
@@ -113,19 +131,29 @@ var TOOL_SCHEMAS = [
       properties: {
         steps: {
           type: "array",
-          description: "Steps in order (max 20). Each: { tool: string, args?: object }",
+          description: "Steps in order (max 20). Each: { tool: string, args?: object }, or a repeat group { repeat: {...}, steps: [...] }",
           items: {
             type: "object",
             properties: {
               tool: { type: "string", description: "Tool name, e.g. chrome_click_element" },
-              args: { type: "object", description: "Arguments for the tool" }
-            },
-            required: ["tool"]
+              args: { type: "object", description: "Arguments for the tool" },
+              as: { type: "string", description: P_STEP_AS },
+              when: { type: "object", description: P_WHEN },
+              stopIf: { type: "object", description: P_STOP_IF },
+              repeat: { type: "object", description: P_REPEAT },
+              steps: { type: "array", description: P_GROUP_STEPS }
+            }
           }
         },
         continueOnError: {
           type: "boolean",
           description: "Keep running after a step fails (default false)"
+        },
+        templates: { type: "boolean", description: P_TEMPLATES },
+        return: {
+          type: "array",
+          items: { type: "string" },
+          description: P_RETURN
         }
       },
       required: ["steps"]
@@ -165,21 +193,32 @@ var TOOL_SCHEMAS = [
         name: { type: "string", description: "Shortcut name (save/run/delete)" },
         steps: {
           type: "array",
-          description: 'action="save": chrome_batch steps, max 20. Each: { tool: string, args?: object }',
+          description: 'action="save": chrome_batch steps, max 20. Each: { tool: string, args?: object }, or a repeat group',
           items: {
             type: "object",
             properties: {
               tool: { type: "string" },
-              args: { type: "object" }
-            },
-            required: ["tool"]
+              args: { type: "object" },
+              as: { type: "string", description: P_STEP_AS },
+              when: { type: "object", description: P_WHEN },
+              stopIf: { type: "object", description: P_STOP_IF },
+              repeat: { type: "object", description: P_REPEAT },
+              steps: { type: "array", description: P_GROUP_STEPS }
+            }
           }
         },
         description: { type: "string", description: 'action="save": what this shortcut does' },
         continueOnError: {
           type: "boolean",
           description: 'action="run": keep running after a failure (default false)'
-        }
+        },
+        templates: { type: "boolean", description: P_TEMPLATES },
+        return: {
+          type: "array",
+          items: { type: "string" },
+          description: P_RETURN
+        },
+        params: { type: "object", description: P_PARAMS }
       },
       required: ["action"]
     }
@@ -336,11 +375,11 @@ var TOOL_SCHEMAS = [
       properties: {
         saveToDownloads: {
           type: "boolean",
-          description: "Save the trace as a JSON file in Downloads (default true)."
+          description: "Save the trace as a JSON file under Downloads/mcp-screenshots/<date>/ (default true)."
         },
         filenamePrefix: {
           type: "string",
-          description: "Optional filename prefix for the downloaded trace JSON."
+          description: "Optional name to put in the saved trace filename."
         },
         tabId: tabIdProp
       },
@@ -619,11 +658,11 @@ var TOOL_SCHEMAS = [
         },
         saveToDownloads: {
           type: "boolean",
-          description: "Also auto-save to Downloads/mcp-screenshots/ (default: false)"
+          description: "Also auto-save to Downloads/mcp-screenshots/<date>/ (default: false)"
         },
         filename: {
           type: "string",
-          description: "Filename for saveToDownloads (sanitized, under mcp-screenshots/)."
+          description: "Name for saveToDownloads (sanitized; always kept under mcp-screenshots/<date>/)."
         }
       },
       required: []
@@ -1299,7 +1338,7 @@ var TOOL_SCHEMAS = [
         },
         filename: {
           type: "string",
-          description: "Output filename (no extension). Defaults to a timestamped name."
+          description: "Output name (no extension). Saved under Downloads/mcp-screenshots/<date>/."
         },
         captureDelayMs: {
           type: "number",
@@ -1461,7 +1500,7 @@ var TOOL_SCHEMAS = [
         windowId: windowIdProp,
         filename: {
           type: "string",
-          description: 'File name (".pdf" added). Saved under Downloads/mcp-pdf/.'
+          description: 'File name (".pdf" added). Saved under Downloads/mcp-screenshots/<date>/.'
         },
         paperFormat: {
           type: "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auto-chrome-mcp-shared",
-  "version": "1.10.1",
+  "version": "1.11.1",
   "author": "hangye (upstream), cw02326 (auto-chrome-mcp fork)",
   "repository": {
     "type": "git",