auto-chrome-mcp-shared 1.12.0 → 1.13.0

package/dist/index.js

@@ -154,7 +154,7 @@ var P_WHEN = 'Run only if this condition holds, e.g. { path: "hit.matches", op:
 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 P_PARAMS = "save: declare { user: { required: true }, pw: { secret: true } }. run: values for {{params.user}}. schedule with flowId: values for the flow variables.";
 var P_TASK = 'Short label for what this run is doing (max 24 chars). Shows on the MCP tab group while it runs, then goes back to "MCP".';
 var P_HISTORY_RUN_ID = 'action="history": return this one run in full, including its "results".';
 var P_HISTORY_LIMIT = 'action="history": how many runs to list (default 20, max 100).';
@@ -162,7 +162,8 @@ var P_HISTORY_SINCE = 'action="history": only runs started at or after this time
 var P_SCHEDULE = 'action="schedule": { every: "15m"|"1h"|"6h"|"24h" } or { daily: ["08:00"], days?: ["mon"] }.';
 var P_NOTIFY = 'action="schedule": show a Chrome notification when a run fails (default true).';
 var P_REPORT = 'action="schedule": also write the run record to Downloads/mcp-screenshots (default false).';
-var P_LOGIN_CHECK = 'action="schedule": "as" name of the top level step whose stopIf means the login expired.';
+var P_LOGIN_CHECK = 'action="schedule": "as" name of the top level step whose stopIf means the login expired. With flowId: the flow step id that fails when the login expired.';
+var P_FLOW_ID = "action=schedule/unschedule/history: target a published flow id instead of a shortcut name (the id from record_replay_list_published). Error if given together with name.";
 var P_HISTORY_STATUS = 'action="history": keep only these statuses: running, success, failed, stopped, timeout, interrupted, skipped_queue, login_required, user_took_over_tab.';
 var tabIdProp = { type: "number", description: P_TAB_ID };
 var windowIdProp = { type: "number", description: P_WINDOW_ID };
@@ -234,7 +235,7 @@ var TOOL_SCHEMAS = [
   },
   {
     name: TOOL_NAMES.BROWSER.SHORTCUT,
-    description: "Save, run and schedule named macros (a chrome_batch step list stored under a name). action: save {name, steps, description} | run (through the normal pipeline) | list | delete | history (past runs) | schedule (run it on a timer with no MCP session) | unschedule | schedules. Use for flows you repeat across sessions (logins, routine collection, overnight checks).",
+    description: "Save, run and schedule named macros (a chrome_batch step list stored under a name). action: save {name, steps, description} | run (through the normal pipeline) | list | delete | history (past runs) | schedule (run it on a timer with no MCP session) | unschedule | schedules. schedule/unschedule/history also take a published flow through flowId. Use for flows you repeat across sessions (logins, routine collection, overnight checks).",
     inputSchema: {
       type: "object",
       properties: {
@@ -247,6 +248,7 @@ var TOOL_SCHEMAS = [
           type: "string",
           description: "Shortcut name (save/run/delete/schedule/unschedule)"
         },
+        flowId: { type: "string", description: P_FLOW_ID },
         steps: {
           type: "array",
           description: 'action="save": same shape as chrome_batch.steps (max 20, tool/args, or a repeat group).',
@@ -386,7 +388,7 @@ var TOOL_SCHEMAS = [
   },
   {
     name: TOOL_NAMES.RECORD_REPLAY.FLOW_RUN,
-    description: "Run a published record-replay flow (recorded in the extension side panel) on this session work tab. Requires a work tab: call chrome_navigate first, otherwise the call is refused with no_work_tab. Cannot be nested inside chrome_batch. Returns a summary: success, step counts, first failed step, flow outputs.",
+    description: "Run a published record-replay flow (recorded in the extension side panel) on this session work tab. With no work tab it opens one in the background at the flow start URL (the page the flow was recorded on, or the startUrl argument); only when neither exists is the call refused with no_work_tab, and then chrome_navigate makes the work tab. Cannot be nested inside chrome_batch. Returns a summary: success, step counts, first failed step, flow outputs, and tabSource (work_tab | created_from_start_url | explicit).",
     inputSchema: {
       type: "object",
       properties: {
@@ -405,7 +407,7 @@ var TOOL_SCHEMAS = [
         },
         startUrl: {
           type: "string",
-          description: "Open this URL in the run tab before the first step."
+          description: "Open this URL in the run tab before the first step. Overrides the flow's own start URL, and is also what a work tab is created from when there is none."
         },
         refresh: {
           type: "boolean",

package/dist/index.mjs

@@ -110,7 +110,7 @@ var P_WHEN = 'Run only if this condition holds, e.g. { path: "hit.matches", op:
 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 P_PARAMS = "save: declare { user: { required: true }, pw: { secret: true } }. run: values for {{params.user}}. schedule with flowId: values for the flow variables.";
 var P_TASK = 'Short label for what this run is doing (max 24 chars). Shows on the MCP tab group while it runs, then goes back to "MCP".';
 var P_HISTORY_RUN_ID = 'action="history": return this one run in full, including its "results".';
 var P_HISTORY_LIMIT = 'action="history": how many runs to list (default 20, max 100).';
@@ -118,7 +118,8 @@ var P_HISTORY_SINCE = 'action="history": only runs started at or after this time
 var P_SCHEDULE = 'action="schedule": { every: "15m"|"1h"|"6h"|"24h" } or { daily: ["08:00"], days?: ["mon"] }.';
 var P_NOTIFY = 'action="schedule": show a Chrome notification when a run fails (default true).';
 var P_REPORT = 'action="schedule": also write the run record to Downloads/mcp-screenshots (default false).';
-var P_LOGIN_CHECK = 'action="schedule": "as" name of the top level step whose stopIf means the login expired.';
+var P_LOGIN_CHECK = 'action="schedule": "as" name of the top level step whose stopIf means the login expired. With flowId: the flow step id that fails when the login expired.';
+var P_FLOW_ID = "action=schedule/unschedule/history: target a published flow id instead of a shortcut name (the id from record_replay_list_published). Error if given together with name.";
 var P_HISTORY_STATUS = 'action="history": keep only these statuses: running, success, failed, stopped, timeout, interrupted, skipped_queue, login_required, user_took_over_tab.';
 var tabIdProp = { type: "number", description: P_TAB_ID };
 var windowIdProp = { type: "number", description: P_WINDOW_ID };
@@ -190,7 +191,7 @@ var TOOL_SCHEMAS = [
   },
   {
     name: TOOL_NAMES.BROWSER.SHORTCUT,
-    description: "Save, run and schedule named macros (a chrome_batch step list stored under a name). action: save {name, steps, description} | run (through the normal pipeline) | list | delete | history (past runs) | schedule (run it on a timer with no MCP session) | unschedule | schedules. Use for flows you repeat across sessions (logins, routine collection, overnight checks).",
+    description: "Save, run and schedule named macros (a chrome_batch step list stored under a name). action: save {name, steps, description} | run (through the normal pipeline) | list | delete | history (past runs) | schedule (run it on a timer with no MCP session) | unschedule | schedules. schedule/unschedule/history also take a published flow through flowId. Use for flows you repeat across sessions (logins, routine collection, overnight checks).",
     inputSchema: {
       type: "object",
       properties: {
@@ -203,6 +204,7 @@ var TOOL_SCHEMAS = [
           type: "string",
           description: "Shortcut name (save/run/delete/schedule/unschedule)"
         },
+        flowId: { type: "string", description: P_FLOW_ID },
         steps: {
           type: "array",
           description: 'action="save": same shape as chrome_batch.steps (max 20, tool/args, or a repeat group).',
@@ -342,7 +344,7 @@ var TOOL_SCHEMAS = [
   },
   {
     name: TOOL_NAMES.RECORD_REPLAY.FLOW_RUN,
-    description: "Run a published record-replay flow (recorded in the extension side panel) on this session work tab. Requires a work tab: call chrome_navigate first, otherwise the call is refused with no_work_tab. Cannot be nested inside chrome_batch. Returns a summary: success, step counts, first failed step, flow outputs.",
+    description: "Run a published record-replay flow (recorded in the extension side panel) on this session work tab. With no work tab it opens one in the background at the flow start URL (the page the flow was recorded on, or the startUrl argument); only when neither exists is the call refused with no_work_tab, and then chrome_navigate makes the work tab. Cannot be nested inside chrome_batch. Returns a summary: success, step counts, first failed step, flow outputs, and tabSource (work_tab | created_from_start_url | explicit).",
     inputSchema: {
       type: "object",
       properties: {
@@ -361,7 +363,7 @@ var TOOL_SCHEMAS = [
         },
         startUrl: {
           type: "string",
-          description: "Open this URL in the run tab before the first step."
+          description: "Open this URL in the run tab before the first step. Overrides the flow's own start URL, and is also what a work tab is created from when there is none."
         },
         refresh: {
           type: "boolean",

package/package.json

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