auto-chrome-mcp-shared 1.11.2 → 1.13.0

package/dist/index.d.mts

@@ -1,6 +1,5 @@
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
 
-declare const DEFAULT_SERVER_PORT = 12320;
 declare const HOST_NAME = "com.autochromemcp.nativehost";
 
 declare enum NativeMessageType {
@@ -826,4 +825,4 @@ type OpenProjectResponse = {
     error: string;
 };
 
-export { type AgentActRequest, type AgentActResponse, type AgentAttachment, type AgentCliPreference, type AgentConnectedEvent, type AgentEngineInfo, type AgentHeartbeatEvent, type AgentManagementInfo, type AgentMessage, type AgentProject, type AgentRole, type AgentSession, type AgentSessionOptionsConfig, type AgentStatusEvent, type AgentStoredMessage, type AgentSystemPromptConfig, type AgentToolsConfig, type AgentUsageStats, type AttachmentCleanupRequest, type AttachmentCleanupResponse, type AttachmentMetadata, type AttachmentProjectStats, type AttachmentStatsResponse, CODEX_AUTO_INSTRUCTIONS, type CleanupProjectResult, type CodexEngineConfig, type CodexReasoningEffort, type CodexSandboxMode, type CreateAgentSessionInput, DEFAULT_CODEX_CONFIG, DEFAULT_SERVER_PORT, EDGE_LABELS, type EdgeLabel, type ElementPickerRequest, type ElementPickerResult, type ElementPickerResultItem, type FieldArray, type FieldBoolean, type FieldJson, type FieldNumber, type FieldObject, type FieldSelect, type FieldSpec, type FieldSpecBase, type FieldString, type FieldType, HOST_NAME, type NativeMessage, NativeMessageType, type NodeCategory, type NodeSpec, type NodeSpecDisplay, type OpenProjectRequest, type OpenProjectResponse, type OpenProjectTarget, type PickedElement, type PickedElementPoint, type PickedElementRect, type RREdge, type RRNode, type RRStepType, RR_STEP_TYPES, type RealtimeEvent, STEP_TYPES, type ServerStartedPayload, type StepTypeConst, type StreamTransport, TOOL_NAMES, TOOL_SCHEMAS, type UpdateAgentSessionInput, getNodeSpec, listNodeSpecs, mapNodeToStep, mapStepToNodeConfig, nodesToSteps, registerBuiltinSpecs, registerNodeSpec, stepsToDAG, stepsToNodes, topoOrder };
+export { type AgentActRequest, type AgentActResponse, type AgentAttachment, type AgentCliPreference, type AgentConnectedEvent, type AgentEngineInfo, type AgentHeartbeatEvent, type AgentManagementInfo, type AgentMessage, type AgentProject, type AgentRole, type AgentSession, type AgentSessionOptionsConfig, type AgentStatusEvent, type AgentStoredMessage, type AgentSystemPromptConfig, type AgentToolsConfig, type AgentUsageStats, type AttachmentCleanupRequest, type AttachmentCleanupResponse, type AttachmentMetadata, type AttachmentProjectStats, type AttachmentStatsResponse, CODEX_AUTO_INSTRUCTIONS, type CleanupProjectResult, type CodexEngineConfig, type CodexReasoningEffort, type CodexSandboxMode, type CreateAgentSessionInput, DEFAULT_CODEX_CONFIG, EDGE_LABELS, type EdgeLabel, type ElementPickerRequest, type ElementPickerResult, type ElementPickerResultItem, type FieldArray, type FieldBoolean, type FieldJson, type FieldNumber, type FieldObject, type FieldSelect, type FieldSpec, type FieldSpecBase, type FieldString, type FieldType, HOST_NAME, type NativeMessage, NativeMessageType, type NodeCategory, type NodeSpec, type NodeSpecDisplay, type OpenProjectRequest, type OpenProjectResponse, type OpenProjectTarget, type PickedElement, type PickedElementPoint, type PickedElementRect, type RREdge, type RRNode, type RRStepType, RR_STEP_TYPES, type RealtimeEvent, STEP_TYPES, type ServerStartedPayload, type StepTypeConst, type StreamTransport, TOOL_NAMES, TOOL_SCHEMAS, type UpdateAgentSessionInput, getNodeSpec, listNodeSpecs, mapNodeToStep, mapStepToNodeConfig, nodesToSteps, registerBuiltinSpecs, registerNodeSpec, stepsToDAG, stepsToNodes, topoOrder };

package/dist/index.d.ts

@@ -1,6 +1,5 @@
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
 
-declare const DEFAULT_SERVER_PORT = 12320;
 declare const HOST_NAME = "com.autochromemcp.nativehost";
 
 declare enum NativeMessageType {
@@ -826,4 +825,4 @@ type OpenProjectResponse = {
     error: string;
 };
 
-export { type AgentActRequest, type AgentActResponse, type AgentAttachment, type AgentCliPreference, type AgentConnectedEvent, type AgentEngineInfo, type AgentHeartbeatEvent, type AgentManagementInfo, type AgentMessage, type AgentProject, type AgentRole, type AgentSession, type AgentSessionOptionsConfig, type AgentStatusEvent, type AgentStoredMessage, type AgentSystemPromptConfig, type AgentToolsConfig, type AgentUsageStats, type AttachmentCleanupRequest, type AttachmentCleanupResponse, type AttachmentMetadata, type AttachmentProjectStats, type AttachmentStatsResponse, CODEX_AUTO_INSTRUCTIONS, type CleanupProjectResult, type CodexEngineConfig, type CodexReasoningEffort, type CodexSandboxMode, type CreateAgentSessionInput, DEFAULT_CODEX_CONFIG, DEFAULT_SERVER_PORT, EDGE_LABELS, type EdgeLabel, type ElementPickerRequest, type ElementPickerResult, type ElementPickerResultItem, type FieldArray, type FieldBoolean, type FieldJson, type FieldNumber, type FieldObject, type FieldSelect, type FieldSpec, type FieldSpecBase, type FieldString, type FieldType, HOST_NAME, type NativeMessage, NativeMessageType, type NodeCategory, type NodeSpec, type NodeSpecDisplay, type OpenProjectRequest, type OpenProjectResponse, type OpenProjectTarget, type PickedElement, type PickedElementPoint, type PickedElementRect, type RREdge, type RRNode, type RRStepType, RR_STEP_TYPES, type RealtimeEvent, STEP_TYPES, type ServerStartedPayload, type StepTypeConst, type StreamTransport, TOOL_NAMES, TOOL_SCHEMAS, type UpdateAgentSessionInput, getNodeSpec, listNodeSpecs, mapNodeToStep, mapStepToNodeConfig, nodesToSteps, registerBuiltinSpecs, registerNodeSpec, stepsToDAG, stepsToNodes, topoOrder };
+export { type AgentActRequest, type AgentActResponse, type AgentAttachment, type AgentCliPreference, type AgentConnectedEvent, type AgentEngineInfo, type AgentHeartbeatEvent, type AgentManagementInfo, type AgentMessage, type AgentProject, type AgentRole, type AgentSession, type AgentSessionOptionsConfig, type AgentStatusEvent, type AgentStoredMessage, type AgentSystemPromptConfig, type AgentToolsConfig, type AgentUsageStats, type AttachmentCleanupRequest, type AttachmentCleanupResponse, type AttachmentMetadata, type AttachmentProjectStats, type AttachmentStatsResponse, CODEX_AUTO_INSTRUCTIONS, type CleanupProjectResult, type CodexEngineConfig, type CodexReasoningEffort, type CodexSandboxMode, type CreateAgentSessionInput, DEFAULT_CODEX_CONFIG, EDGE_LABELS, type EdgeLabel, type ElementPickerRequest, type ElementPickerResult, type ElementPickerResultItem, type FieldArray, type FieldBoolean, type FieldJson, type FieldNumber, type FieldObject, type FieldSelect, type FieldSpec, type FieldSpecBase, type FieldString, type FieldType, HOST_NAME, type NativeMessage, NativeMessageType, type NodeCategory, type NodeSpec, type NodeSpecDisplay, type OpenProjectRequest, type OpenProjectResponse, type OpenProjectTarget, type PickedElement, type PickedElementPoint, type PickedElementRect, type RREdge, type RRNode, type RRStepType, RR_STEP_TYPES, type RealtimeEvent, STEP_TYPES, type ServerStartedPayload, type StepTypeConst, type StreamTransport, TOOL_NAMES, TOOL_SCHEMAS, type UpdateAgentSessionInput, getNodeSpec, listNodeSpecs, mapNodeToStep, mapStepToNodeConfig, nodesToSteps, registerBuiltinSpecs, registerNodeSpec, stepsToDAG, stepsToNodes, topoOrder };

package/dist/index.js

@@ -22,7 +22,6 @@ var index_exports = {};
 __export(index_exports, {
   CODEX_AUTO_INSTRUCTIONS: () => CODEX_AUTO_INSTRUCTIONS,
   DEFAULT_CODEX_CONFIG: () => DEFAULT_CODEX_CONFIG,
-  DEFAULT_SERVER_PORT: () => DEFAULT_SERVER_PORT,
   EDGE_LABELS: () => EDGE_LABELS,
   HOST_NAME: () => HOST_NAME,
   NativeMessageType: () => NativeMessageType,
@@ -44,7 +43,6 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/constants.ts
-var DEFAULT_SERVER_PORT = 12320;
 var HOST_NAME = "com.autochromemcp.nativehost";
 
 // src/types.ts
@@ -156,7 +154,17 @@ 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).';
+var P_HISTORY_SINCE = 'action="history": only runs started at or after this time (ISO string or epoch ms).';
+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. 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 };
 var frameIdProp = { type: "number", description: P_FRAME_ID };
@@ -199,7 +207,8 @@ var TOOL_SCHEMAS = [
           type: "array",
           items: { type: "string" },
           description: P_RETURN
-        }
+        },
+        task: { type: "string", description: P_TASK }
       },
       required: ["steps"]
     }
@@ -226,31 +235,24 @@ var TOOL_SCHEMAS = [
   },
   {
     name: TOOL_NAMES.BROWSER.SHORTCUT,
-    description: "Save and run named macros (a chrome_batch step list stored under a name). action: save {name, steps, description} | run (through the normal pipeline) | list | delete. Use for flows you repeat across sessions (logins, routine collection).",
+    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: {
         action: {
           type: "string",
-          enum: ["save", "run", "list", "delete"],
+          enum: ["save", "run", "list", "delete", "history", "schedule", "unschedule", "schedules"],
           description: "What to do"
         },
-        name: { type: "string", description: "Shortcut name (save/run/delete)" },
+        name: {
+          type: "string",
+          description: "Shortcut name (save/run/delete/schedule/unschedule)"
+        },
+        flowId: { type: "string", description: P_FLOW_ID },
         steps: {
           type: "array",
-          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" },
-              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: 'action="save": same shape as chrome_batch.steps (max 20, tool/args, or a repeat group).',
+          items: { type: "object" }
         },
         description: { type: "string", description: 'action="save": what this shortcut does' },
         continueOnError: {
@@ -263,7 +265,20 @@ var TOOL_SCHEMAS = [
           items: { type: "string" },
           description: P_RETURN
         },
-        params: { type: "object", description: P_PARAMS }
+        params: { type: "object", description: P_PARAMS },
+        task: { type: "string", description: P_TASK },
+        runId: { type: "string", description: P_HISTORY_RUN_ID },
+        limit: { type: "number", description: P_HISTORY_LIMIT },
+        since: { type: "string", description: P_HISTORY_SINCE },
+        status: {
+          type: "array",
+          items: { type: "string" },
+          description: P_HISTORY_STATUS
+        },
+        schedule: { type: "object", description: P_SCHEDULE },
+        notify: { type: "boolean", description: P_NOTIFY },
+        report: { type: "boolean", description: P_REPORT },
+        loginCheck: { type: "string", description: P_LOGIN_CHECK }
       },
       required: ["action"]
     }
@@ -371,24 +386,59 @@ var TOOL_SCHEMAS = [
       required: []
     }
   },
-  // record_replay 두 도구는 **의도적으로 MCP 에 노출하지 않는다** (2026-09-04 Codex 3차 검토, 항목 3).
-  //
-  // replay 엔진은 대상 탭을 스스로 고른다 — rr-utils 의 ensureTab() 이 tabTarget 미지정·'current'
-  // 에서 사용자의 활성 탭을 잡고, legacy step executor 와 대부분의 노드(click·fill·extract·
-  // assert·script·wait·drag 등)가 ctx.tabId 를 무시하고 같은 조회를 다시 한다(엔진·노드 전체
-  // 28곳/16파일). 그래서 백그라운드 작업 게이트가 작업 탭 id 를 주입해도 소비하는 지점이 없고,
-  // flow_run 호출이 사용자가 보고 있는 탭을 조작한다. 엔진이 ctx.tabId 를 존중하도록 고치기 전에는
-  // 노출하지 않으며, 확장의 게이트도 백그라운드 모드에서 flow_run 을 거절한다
-  // (utils/work-tab-gate.ts 의 BACKGROUND_MODE_UNSUPPORTED_TOOLS).
-  //
-  // {
-  //   name: TOOL_NAMES.RECORD_REPLAY.FLOW_RUN,
-  //   ...
-  // },
-  // {
-  //   name: TOOL_NAMES.RECORD_REPLAY.LIST_PUBLISHED,
-  //   ...
-  // },
+  {
+    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. 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: {
+        flowId: {
+          type: "string",
+          description: "Flow id, from record_replay_list_published."
+        },
+        args: {
+          type: "object",
+          description: "Values for the flow variables, keyed by variable name."
+        },
+        tabTarget: {
+          type: "string",
+          enum: ["current", "new"],
+          description: "'current' (default) runs in the work tab. 'new' opens a background tab in the work tab window, runs there and leaves it open. Pass a specific tab as tabId, not here."
+        },
+        startUrl: {
+          type: "string",
+          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",
+          description: "Reload the run tab before the first step (default false)."
+        },
+        captureNetwork: {
+          type: "boolean",
+          description: "Record network requests during the run (default false)."
+        },
+        returnLogs: {
+          type: "boolean",
+          description: "Include the step log, capped at 4000 chars (default false)."
+        },
+        timeoutMs: {
+          type: "number",
+          description: "Abort the whole run after this many ms."
+        },
+        tabId: tabIdProp
+      },
+      required: ["flowId"]
+    }
+  },
+  {
+    name: TOOL_NAMES.RECORD_REPLAY.LIST_PUBLISHED,
+    description: "List the published record-replay flows (id, slug, name, version, description) that record_replay_flow_run can run.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: []
+    }
+  },
   {
     name: TOOL_NAMES.BROWSER.PERFORMANCE_START_TRACE,
     description: "Start a performance trace on the selected page. Optionally reload and/or auto-stop after a short duration.",
@@ -658,14 +708,15 @@ var TOOL_SCHEMAS = [
         refresh: {
           type: "boolean",
           description: "Refresh the active tab instead of navigating (url ignored). Default false."
-        }
+        },
+        task: { type: "string", description: P_TASK }
       },
       required: []
     }
   },
   {
     name: TOOL_NAMES.BROWSER.SCREENSHOT,
-    description: '[Prefer chrome_read_page, or chrome_computer action="screenshot"] Take a screenshot of the page or an element. Use this tool only when you need its advanced options.',
+    description: '[Prefer chrome_read_page, or chrome_computer action="screenshot"] Take a screenshot of the page or an element. Use this tool only when you need its advanced options. With storeBase64, the image arrives as a separate MCP image content block in image pixels (chrome_computer converts coordinates via imageScale automatically), not base64 in this text; a saved file path (savePng/saveToDownloads) is included in the response.',
     inputSchema: {
       type: "object",
       properties: {
@@ -1010,7 +1061,7 @@ var TOOL_SCHEMAS = [
   },
   {
     name: TOOL_NAMES.BROWSER.JAVASCRIPT,
-    description: "Execute JavaScript in a tab and return the result. Uses CDP Runtime.evaluate (awaitPromise, returnByValue) and falls back to chrome.scripting.executeScript if the debugger is busy. Output is sanitized (sensitive data redacted) and truncated by default.",
+    description: "Execute JavaScript in a tab and return the result, falling back automatically to a different execution path if the debugger is busy. Output is sanitized (sensitive data redacted) and truncated by default.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1270,7 +1321,7 @@ var TOOL_SCHEMAS = [
   },
   {
     name: TOOL_NAMES.BROWSER.FILE_UPLOAD,
-    description: "Upload files to file-input form elements using Chrome DevTools Protocol",
+    description: "Upload files to file-input form elements.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1309,7 +1360,7 @@ var TOOL_SCHEMAS = [
   },
   {
     name: TOOL_NAMES.BROWSER.HANDLE_DIALOG,
-    description: "Handle JavaScript dialogs (alert/confirm/prompt) via CDP",
+    description: "Handle JavaScript dialogs (alert/confirm/prompt).",
     inputSchema: {
       type: "object",
       properties: {
@@ -1489,7 +1540,7 @@ var TOOL_SCHEMAS = [
   // ===== auto-chrome-mcp fork (B1~B4) =====
   {
     name: TOOL_NAMES.BROWSER.STORAGE,
-    description: "Read or modify cookies, localStorage, or sessionStorage. Use it to save/restore a login session, test the logged-out state, pre-seed a consent cookie, or inspect front-end state. VALUES are masked by default (names/domains/expiry still returned); pass includeValues:true only when you need the secrets.",
+    description: "Read or modify cookies, localStorage, or sessionStorage. VALUES are masked by default (names/domains/expiry still returned); pass includeValues:true only when you need the secrets.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1649,13 +1700,10 @@ var LANE_EXEMPT_TOOLS = /* @__PURE__ */ new Set([
   TOOL_NAMES.BROWSER.BOOKMARK_SEARCH,
   TOOL_NAMES.BROWSER.BOOKMARK_ADD,
   TOOL_NAMES.BROWSER.BOOKMARK_DELETE,
-  TOOL_NAMES.BROWSER.REQUEST_USER_CONSENT,
-  // record_replay 두 도구는 레인 대상이 아니다: flow_run 은 대상 탭을 엔진이 스스로 잡아
-  // 레인→작업탭 주입 경로를 타지 않고, list_published 는 순수 조회다. 지금은 두 스키마가
-  // 위에서 주석 처리돼 TOOL_SCHEMAS 에 없으므로 이 항목은 실질적으로 무효지만, 다시 노출할 때
-  // 판단을 되풀이하지 않도록 남겨 둔다.
-  TOOL_NAMES.RECORD_REPLAY.FLOW_RUN,
-  TOOL_NAMES.RECORD_REPLAY.LIST_PUBLISHED
+  TOOL_NAMES.BROWSER.REQUEST_USER_CONSENT
+  // record_replay 두 도구는 여기 넣지 않는다. flow_run 은 레인별 작업 탭을 그대로 받아야
+  // 하고(게이트의 TAB_ID_INJECT_TOOLS), list_published 도 같은 레인 인자를 달고 다니는 편이
+  // 호출 형태가 일관된다.
 ]);
 var LANE_DESCRIPTION_SHORT = "Parallel-agent lane id (same value every call). Omit if solo.";
 var LANE_DESCRIPTION_LONG = "Parallel lane id. Sub-agents of one Claude Code session share one MCP session, so without a lane they overwrite each other's work tab. Give each concurrent agent a distinct lane (same value every call): a lane keeps its own work tab that no other lane closes or retargets.";
@@ -2673,7 +2721,6 @@ var DEFAULT_CODEX_CONFIG = {
 0 && (module.exports = {
   CODEX_AUTO_INSTRUCTIONS,
   DEFAULT_CODEX_CONFIG,
-  DEFAULT_SERVER_PORT,
   EDGE_LABELS,
   HOST_NAME,
   NativeMessageType,

package/dist/index.mjs

@@ -1,5 +1,4 @@
 // src/constants.ts
-var DEFAULT_SERVER_PORT = 12320;
 var HOST_NAME = "com.autochromemcp.nativehost";
 
 // src/types.ts
@@ -111,7 +110,17 @@ 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).';
+var P_HISTORY_SINCE = 'action="history": only runs started at or after this time (ISO string or epoch ms).';
+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. 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 };
 var frameIdProp = { type: "number", description: P_FRAME_ID };
@@ -154,7 +163,8 @@ var TOOL_SCHEMAS = [
           type: "array",
           items: { type: "string" },
           description: P_RETURN
-        }
+        },
+        task: { type: "string", description: P_TASK }
       },
       required: ["steps"]
     }
@@ -181,31 +191,24 @@ var TOOL_SCHEMAS = [
   },
   {
     name: TOOL_NAMES.BROWSER.SHORTCUT,
-    description: "Save and run named macros (a chrome_batch step list stored under a name). action: save {name, steps, description} | run (through the normal pipeline) | list | delete. Use for flows you repeat across sessions (logins, routine collection).",
+    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: {
         action: {
           type: "string",
-          enum: ["save", "run", "list", "delete"],
+          enum: ["save", "run", "list", "delete", "history", "schedule", "unschedule", "schedules"],
           description: "What to do"
         },
-        name: { type: "string", description: "Shortcut name (save/run/delete)" },
+        name: {
+          type: "string",
+          description: "Shortcut name (save/run/delete/schedule/unschedule)"
+        },
+        flowId: { type: "string", description: P_FLOW_ID },
         steps: {
           type: "array",
-          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" },
-              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: 'action="save": same shape as chrome_batch.steps (max 20, tool/args, or a repeat group).',
+          items: { type: "object" }
         },
         description: { type: "string", description: 'action="save": what this shortcut does' },
         continueOnError: {
@@ -218,7 +221,20 @@ var TOOL_SCHEMAS = [
           items: { type: "string" },
           description: P_RETURN
         },
-        params: { type: "object", description: P_PARAMS }
+        params: { type: "object", description: P_PARAMS },
+        task: { type: "string", description: P_TASK },
+        runId: { type: "string", description: P_HISTORY_RUN_ID },
+        limit: { type: "number", description: P_HISTORY_LIMIT },
+        since: { type: "string", description: P_HISTORY_SINCE },
+        status: {
+          type: "array",
+          items: { type: "string" },
+          description: P_HISTORY_STATUS
+        },
+        schedule: { type: "object", description: P_SCHEDULE },
+        notify: { type: "boolean", description: P_NOTIFY },
+        report: { type: "boolean", description: P_REPORT },
+        loginCheck: { type: "string", description: P_LOGIN_CHECK }
       },
       required: ["action"]
     }
@@ -326,24 +342,59 @@ var TOOL_SCHEMAS = [
       required: []
     }
   },
-  // record_replay 두 도구는 **의도적으로 MCP 에 노출하지 않는다** (2026-09-04 Codex 3차 검토, 항목 3).
-  //
-  // replay 엔진은 대상 탭을 스스로 고른다 — rr-utils 의 ensureTab() 이 tabTarget 미지정·'current'
-  // 에서 사용자의 활성 탭을 잡고, legacy step executor 와 대부분의 노드(click·fill·extract·
-  // assert·script·wait·drag 등)가 ctx.tabId 를 무시하고 같은 조회를 다시 한다(엔진·노드 전체
-  // 28곳/16파일). 그래서 백그라운드 작업 게이트가 작업 탭 id 를 주입해도 소비하는 지점이 없고,
-  // flow_run 호출이 사용자가 보고 있는 탭을 조작한다. 엔진이 ctx.tabId 를 존중하도록 고치기 전에는
-  // 노출하지 않으며, 확장의 게이트도 백그라운드 모드에서 flow_run 을 거절한다
-  // (utils/work-tab-gate.ts 의 BACKGROUND_MODE_UNSUPPORTED_TOOLS).
-  //
-  // {
-  //   name: TOOL_NAMES.RECORD_REPLAY.FLOW_RUN,
-  //   ...
-  // },
-  // {
-  //   name: TOOL_NAMES.RECORD_REPLAY.LIST_PUBLISHED,
-  //   ...
-  // },
+  {
+    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. 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: {
+        flowId: {
+          type: "string",
+          description: "Flow id, from record_replay_list_published."
+        },
+        args: {
+          type: "object",
+          description: "Values for the flow variables, keyed by variable name."
+        },
+        tabTarget: {
+          type: "string",
+          enum: ["current", "new"],
+          description: "'current' (default) runs in the work tab. 'new' opens a background tab in the work tab window, runs there and leaves it open. Pass a specific tab as tabId, not here."
+        },
+        startUrl: {
+          type: "string",
+          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",
+          description: "Reload the run tab before the first step (default false)."
+        },
+        captureNetwork: {
+          type: "boolean",
+          description: "Record network requests during the run (default false)."
+        },
+        returnLogs: {
+          type: "boolean",
+          description: "Include the step log, capped at 4000 chars (default false)."
+        },
+        timeoutMs: {
+          type: "number",
+          description: "Abort the whole run after this many ms."
+        },
+        tabId: tabIdProp
+      },
+      required: ["flowId"]
+    }
+  },
+  {
+    name: TOOL_NAMES.RECORD_REPLAY.LIST_PUBLISHED,
+    description: "List the published record-replay flows (id, slug, name, version, description) that record_replay_flow_run can run.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: []
+    }
+  },
   {
     name: TOOL_NAMES.BROWSER.PERFORMANCE_START_TRACE,
     description: "Start a performance trace on the selected page. Optionally reload and/or auto-stop after a short duration.",
@@ -613,14 +664,15 @@ var TOOL_SCHEMAS = [
         refresh: {
           type: "boolean",
           description: "Refresh the active tab instead of navigating (url ignored). Default false."
-        }
+        },
+        task: { type: "string", description: P_TASK }
       },
       required: []
     }
   },
   {
     name: TOOL_NAMES.BROWSER.SCREENSHOT,
-    description: '[Prefer chrome_read_page, or chrome_computer action="screenshot"] Take a screenshot of the page or an element. Use this tool only when you need its advanced options.',
+    description: '[Prefer chrome_read_page, or chrome_computer action="screenshot"] Take a screenshot of the page or an element. Use this tool only when you need its advanced options. With storeBase64, the image arrives as a separate MCP image content block in image pixels (chrome_computer converts coordinates via imageScale automatically), not base64 in this text; a saved file path (savePng/saveToDownloads) is included in the response.',
     inputSchema: {
       type: "object",
       properties: {
@@ -965,7 +1017,7 @@ var TOOL_SCHEMAS = [
   },
   {
     name: TOOL_NAMES.BROWSER.JAVASCRIPT,
-    description: "Execute JavaScript in a tab and return the result. Uses CDP Runtime.evaluate (awaitPromise, returnByValue) and falls back to chrome.scripting.executeScript if the debugger is busy. Output is sanitized (sensitive data redacted) and truncated by default.",
+    description: "Execute JavaScript in a tab and return the result, falling back automatically to a different execution path if the debugger is busy. Output is sanitized (sensitive data redacted) and truncated by default.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1225,7 +1277,7 @@ var TOOL_SCHEMAS = [
   },
   {
     name: TOOL_NAMES.BROWSER.FILE_UPLOAD,
-    description: "Upload files to file-input form elements using Chrome DevTools Protocol",
+    description: "Upload files to file-input form elements.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1264,7 +1316,7 @@ var TOOL_SCHEMAS = [
   },
   {
     name: TOOL_NAMES.BROWSER.HANDLE_DIALOG,
-    description: "Handle JavaScript dialogs (alert/confirm/prompt) via CDP",
+    description: "Handle JavaScript dialogs (alert/confirm/prompt).",
     inputSchema: {
       type: "object",
       properties: {
@@ -1444,7 +1496,7 @@ var TOOL_SCHEMAS = [
   // ===== auto-chrome-mcp fork (B1~B4) =====
   {
     name: TOOL_NAMES.BROWSER.STORAGE,
-    description: "Read or modify cookies, localStorage, or sessionStorage. Use it to save/restore a login session, test the logged-out state, pre-seed a consent cookie, or inspect front-end state. VALUES are masked by default (names/domains/expiry still returned); pass includeValues:true only when you need the secrets.",
+    description: "Read or modify cookies, localStorage, or sessionStorage. VALUES are masked by default (names/domains/expiry still returned); pass includeValues:true only when you need the secrets.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1604,13 +1656,10 @@ var LANE_EXEMPT_TOOLS = /* @__PURE__ */ new Set([
   TOOL_NAMES.BROWSER.BOOKMARK_SEARCH,
   TOOL_NAMES.BROWSER.BOOKMARK_ADD,
   TOOL_NAMES.BROWSER.BOOKMARK_DELETE,
-  TOOL_NAMES.BROWSER.REQUEST_USER_CONSENT,
-  // record_replay 두 도구는 레인 대상이 아니다: flow_run 은 대상 탭을 엔진이 스스로 잡아
-  // 레인→작업탭 주입 경로를 타지 않고, list_published 는 순수 조회다. 지금은 두 스키마가
-  // 위에서 주석 처리돼 TOOL_SCHEMAS 에 없으므로 이 항목은 실질적으로 무효지만, 다시 노출할 때
-  // 판단을 되풀이하지 않도록 남겨 둔다.
-  TOOL_NAMES.RECORD_REPLAY.FLOW_RUN,
-  TOOL_NAMES.RECORD_REPLAY.LIST_PUBLISHED
+  TOOL_NAMES.BROWSER.REQUEST_USER_CONSENT
+  // record_replay 두 도구는 여기 넣지 않는다. flow_run 은 레인별 작업 탭을 그대로 받아야
+  // 하고(게이트의 TAB_ID_INJECT_TOOLS), list_published 도 같은 레인 인자를 달고 다니는 편이
+  // 호출 형태가 일관된다.
 ]);
 var LANE_DESCRIPTION_SHORT = "Parallel-agent lane id (same value every call). Omit if solo.";
 var LANE_DESCRIPTION_LONG = "Parallel lane id. Sub-agents of one Claude Code session share one MCP session, so without a lane they overwrite each other's work tab. Give each concurrent agent a distinct lane (same value every call): a lane keeps its own work tab that no other lane closes or retargets.";
@@ -2627,7 +2676,6 @@ var DEFAULT_CODEX_CONFIG = {
 export {
   CODEX_AUTO_INSTRUCTIONS,
   DEFAULT_CODEX_CONFIG,
-  DEFAULT_SERVER_PORT,
   EDGE_LABELS,
   HOST_NAME,
   NativeMessageType,

package/package.json

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