@costgate/momentum-mcp 0.1.37 → 0.2.1

package/README.md

@@ -9,7 +9,7 @@ MOMENTUM_TOKEN=mom_agent_xxx \
 ```
 
 整条命令不用自己拼 —— 在 Momentum 的「设置 › Agent」里签发令牌时会直接给出，
-默认用 `@latest`，发新版不用改配置；想固定某一版时把 latest 换成版本号（当前是 0.1.37）。
+默认用 `@latest`，发新版不用改配置；想固定某一版时把 latest 换成版本号（当前是 0.2.1）。
 
 | 环境变量 | 必填 | 说明 |
 |---|---|---|
@@ -18,4 +18,4 @@ MOMENTUM_TOKEN=mom_agent_xxx \
 | `MOMENTUM_CF_ACCESS_CLIENT_ID` | 否 | 部署在 Cloudflare Access 后面时才需要 |
 | `MOMENTUM_CF_ACCESS_CLIENT_SECRET` | 否 | 同上 |
 
-版本 0.1.37。客户端和服务端版本不一致时，启动日志（stderr）会明确警告。
+版本 0.2.1。客户端和服务端版本不一致时，启动日志（stderr）会明确警告。

package/momentum-mcp.mjs

@@ -7195,7 +7195,7 @@ var require_dist = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
+// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.32.1_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
 import process2 from "node:process";
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v4/core/core.js
@@ -11699,7 +11699,7 @@ function preprocess(fn, schema) {
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/types.js
+// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.32.1_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/types.js
 var LATEST_PROTOCOL_VERSION = "2025-11-25";
 var SUPPORTED_PROTOCOL_VERSIONS = [LATEST_PROTOCOL_VERSION, "2025-06-18", "2025-03-26", "2024-11-05", "2024-10-07"];
 var RELATED_TASK_META_KEY = "io.modelcontextprotocol/related-task";
@@ -13230,7 +13230,7 @@ var UrlElicitationRequiredError = class extends McpError {
   }
 };
 
-// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/stdio.js
+// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.32.1_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/stdio.js
 var STDIO_DEFAULT_MAX_BUFFER_SIZE = 10 * 1024 * 1024;
 var ReadBuffer = class {
   constructor(options) {
@@ -13267,7 +13267,7 @@ function serializeMessage(message) {
   return JSON.stringify(message) + "\n";
 }
 
-// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
+// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.32.1_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
 var StdioServerTransport = class {
   constructor(_stdin = process2.stdin, _stdout = process2.stdout, options) {
     this._stdin = _stdin;
@@ -15339,7 +15339,7 @@ var allowErrorProps = SuperJSON.allowErrorProps;
 
 // src/version.ts
 var UNKNOWN = "unknown";
-var MCP_VERSION = true ? "0.1.37" : versionFromRepo();
+var MCP_VERSION = true ? "0.2.1" : versionFromRepo();
 var CLIENT_HEADER = `momentum-mcp/${MCP_VERSION}`;
 function compareVersions(a, b) {
   const parse4 = (v) => {
@@ -19477,7 +19477,7 @@ function object2(shape, params) {
   return new ZodMiniObject(def);
 }
 
-// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-compat.js
+// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.32.1_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-compat.js
 function isZ4Schema(s) {
   const schema = s;
   return !!schema._zod;
@@ -19637,7 +19637,7 @@ function getLiteralValue(schema) {
   return void 0;
 }
 
-// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/interfaces.js
+// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.32.1_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/interfaces.js
 function isTerminal(status) {
   return status === "completed" || status === "failed" || status === "cancelled";
 }
@@ -20926,7 +20926,7 @@ var zodToJsonSchema = (schema, options) => {
   return combined;
 };
 
-// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-json-schema-compat.js
+// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.32.1_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-json-schema-compat.js
 function mapMiniTarget(t) {
   if (!t)
     return "draft-7";
@@ -20968,7 +20968,7 @@ function parseWithCompat(schema, data) {
   return result.data;
 }
 
-// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/protocol.js
+// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.32.1_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/protocol.js
 var DEFAULT_REQUEST_TIMEOUT_MSEC = 6e4;
 var Protocol = class {
   constructor(_options) {
@@ -21009,6 +21009,9 @@ var Protocol = class {
       this.setRequestHandler(GetTaskPayloadRequestSchema, async (request, extra) => {
         const handleTaskResult = async () => {
           const taskId = request.params.taskId;
+          if (!await this._taskStore.getTask(taskId, extra.sessionId)) {
+            throw new McpError(ErrorCode.InvalidParams, `Task not found: ${taskId}`);
+          }
           if (this._taskMessageQueue) {
             let queuedMessage;
             while (queuedMessage = await this._taskMessageQueue.dequeue(taskId, extra.sessionId)) {
@@ -21039,12 +21042,12 @@ var Protocol = class {
             throw new McpError(ErrorCode.InvalidParams, `Task not found: ${taskId}`);
           }
           if (!isTerminal(task.status)) {
-            await this._waitForTaskUpdate(taskId, extra.signal);
+            await this._waitForTaskUpdate(taskId, extra.signal, extra.sessionId);
             return await handleTaskResult();
           }
           if (isTerminal(task.status)) {
             const result = await this._taskStore.getTaskResult(taskId, extra.sessionId);
-            this._clearTaskQueue(taskId);
+            this._clearTaskQueue(taskId, extra.sessionId);
             return {
               ...result,
               _meta: {
@@ -21081,7 +21084,7 @@ var Protocol = class {
             throw new McpError(ErrorCode.InvalidParams, `Cannot cancel task in terminal status: ${task.status}`);
           }
           await this._taskStore.updateTaskStatus(request.params.taskId, "cancelled", "Client cancelled task execution.", extra.sessionId);
-          this._clearTaskQueue(request.params.taskId);
+          this._clearTaskQueue(request.params.taskId, extra.sessionId);
           const cancelledTask = await this._taskStore.getTask(request.params.taskId, extra.sessionId);
           if (!cancelledTask) {
             throw new McpError(ErrorCode.InvalidParams, `Task not found after cancellation: ${request.params.taskId}`);
@@ -21209,6 +21212,19 @@ var Protocol = class {
     const handler = this._requestHandlers.get(request.method) ?? this.fallbackRequestHandler;
     const capturedTransport = this._transport;
     const relatedTaskId = request.params?._meta?.[RELATED_TASK_META_KEY]?.taskId;
+    const sessionId = capturedTransport?.sessionId;
+    const store = this._taskStore;
+    let relatedTaskFound = true;
+    let relatedTaskLookup;
+    if (relatedTaskId && store && this._taskMessageQueue && sessionId !== void 0) {
+      relatedTaskFound = false;
+      relatedTaskLookup = (async () => {
+        if (!await store.getTask(relatedTaskId, sessionId)) {
+          throw new McpError(ErrorCode.InvalidParams, `Task not found: ${relatedTaskId}`);
+        }
+        relatedTaskFound = true;
+      })();
+    }
     if (handler === void 0) {
       const errorResponse = {
         jsonrpc: "2.0",
@@ -21218,7 +21234,10 @@ var Protocol = class {
           message: "Method not found"
         }
       };
-      if (relatedTaskId && this._taskMessageQueue) {
+      if (relatedTaskId && relatedTaskLookup) {
+        const queuedError = { type: "error", message: errorResponse, timestamp: Date.now() };
+        relatedTaskLookup.then(() => this._enqueueTaskMessage(relatedTaskId, queuedError, sessionId), () => capturedTransport?.send(errorResponse)).catch((error2) => this._onerror(new Error(`Failed to send an error response: ${error2}`)));
+      } else if (relatedTaskId && this._taskMessageQueue) {
         this._enqueueTaskMessage(relatedTaskId, {
           type: "error",
           message: errorResponse,
@@ -21269,7 +21288,10 @@ var Protocol = class {
       closeSSEStream: extra?.closeSSEStream,
       closeStandaloneSSEStream: extra?.closeStandaloneSSEStream
     };
-    Promise.resolve().then(() => {
+    (relatedTaskLookup ?? Promise.resolve()).then(() => {
+      if (relatedTaskLookup && abortController.signal.aborted) {
+        throw new McpError(ErrorCode.ConnectionClosed, "Request was cancelled");
+      }
       if (taskCreationParams) {
         this.assertTaskHandlerCapability(request.method);
       }
@@ -21304,7 +21326,7 @@ var Protocol = class {
           ...error2["data"] !== void 0 && { data: error2["data"] }
         }
       };
-      if (relatedTaskId && this._taskMessageQueue) {
+      if (relatedTaskId && this._taskMessageQueue && relatedTaskFound) {
         await this._enqueueTaskMessage(relatedTaskId, {
           type: "error",
           message: errorResponse,
@@ -21784,7 +21806,7 @@ var Protocol = class {
       throw new Error("Cannot enqueue task message: taskStore and taskMessageQueue are not configured");
     }
     const maxQueueSize = this._options?.maxTaskQueueSize;
-    await this._taskMessageQueue.enqueue(taskId, message, sessionId, maxQueueSize);
+    await this._taskMessageQueue.enqueue(taskId, message, sessionId ?? this._transport?.sessionId, maxQueueSize);
   }
   /**
    * Clears the message queue for a task and rejects any pending request resolvers.
@@ -21813,12 +21835,13 @@ var Protocol = class {
    * Uses polling to check for updates at the task's configured poll interval.
    * @param taskId The task ID to wait for
    * @param signal Abort signal to cancel the wait
+   * @param sessionId Session of the request that waits, passed to the task store
    * @returns Promise that resolves when an update occurs or rejects if aborted
    */
-  async _waitForTaskUpdate(taskId, signal) {
+  async _waitForTaskUpdate(taskId, signal, sessionId) {
     let interval = this._options?.defaultTaskPollInterval ?? 1e3;
     try {
-      const task = await this._taskStore?.getTask(taskId);
+      const task = await this._taskStore?.getTask(taskId, sessionId);
       if (task?.pollInterval) {
         interval = task.pollInterval;
       }
@@ -21922,7 +21945,7 @@ function mergeCapabilities(base, additional) {
   return result;
 }
 
-// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/validation/ajv-provider.js
+// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.32.1_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/validation/ajv-provider.js
 var import_ajv = __toESM(require_ajv(), 1);
 var import_ajv_formats = __toESM(require_dist(), 1);
 function createDefaultAjvInstance() {
@@ -21990,7 +22013,7 @@ var AjvJsonSchemaValidator = class {
   }
 };
 
-// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/server.js
+// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.32.1_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/server.js
 var ExperimentalServerTasks = class {
   constructor(_server) {
     this._server = _server;
@@ -22203,7 +22226,7 @@ var ExperimentalServerTasks = class {
   }
 };
 
-// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/helpers.js
+// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.32.1_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/helpers.js
 function assertToolsCallTaskCapability(requests, method, entityName) {
   if (!requests) {
     throw new Error(`${entityName} does not support task creation (required for ${method})`);
@@ -22238,7 +22261,7 @@ function assertClientRequestTaskCapability(requests, method, entityName) {
   }
 }
 
-// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/server/index.js
+// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.32.1_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/server/index.js
 var Server = class extends Protocol {
   /**
    * Initializes this server with the given name and version information.
@@ -22609,7 +22632,7 @@ var Server = class extends Protocol {
   }
 };
 
-// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/server/completable.js
+// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.32.1_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/server/completable.js
 var COMPLETABLE_SYMBOL = Symbol.for("mcp.completable");
 function isCompletable(schema) {
   return !!schema && typeof schema === "object" && COMPLETABLE_SYMBOL in schema;
@@ -22623,7 +22646,7 @@ var McpZodTypeKind;
   McpZodTypeKind2["Completable"] = "McpCompletable";
 })(McpZodTypeKind || (McpZodTypeKind = {}));
 
-// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/toolNameValidation.js
+// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.32.1_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/toolNameValidation.js
 var TOOL_NAME_REGEX = /^[A-Za-z0-9._-]{1,128}$/;
 function validateToolName(name) {
   const warnings = [];
@@ -22681,7 +22704,7 @@ function validateAndWarnToolName(name) {
   return result.isValid;
 }
 
-// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/mcp-server.js
+// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.32.1_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/mcp-server.js
 var ExperimentalMcpServerTasks = class {
   constructor(_mcpServer) {
     this._mcpServer = _mcpServer;
@@ -22696,7 +22719,43 @@ var ExperimentalMcpServerTasks = class {
   }
 };
 
-// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.30.0_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/server/mcp.js
+// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.32.1_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/server/mcp.js
+function toolInputElementCount(value, max) {
+  let count = 0;
+  const stack = [value];
+  while (stack.length > 0) {
+    const node = stack.pop();
+    if (node === null || typeof node !== "object")
+      continue;
+    if (Array.isArray(node)) {
+      for (const child of node) {
+        if (++count > max)
+          return count;
+        if (child !== null && typeof child === "object")
+          stack.push(child);
+      }
+    } else {
+      for (const key in node) {
+        if (!Object.prototype.hasOwnProperty.call(node, key))
+          continue;
+        if (++count > max)
+          return count;
+        const child = node[key];
+        if (child !== null && typeof child === "object")
+          stack.push(child);
+      }
+    }
+  }
+  return count;
+}
+function resolveMaxToolInputElements(value) {
+  if (value === void 0 || value === Infinity)
+    return void 0;
+  if (typeof value !== "number" || Number.isNaN(value) || value < 1) {
+    throw new RangeError(`maxToolInputElements must be a number of at least 1, or Infinity, got ${String(value)}`);
+  }
+  return value;
+}
 var McpServer = class {
   constructor(serverInfo, options) {
     this._registeredResources = {};
@@ -22708,6 +22767,7 @@ var McpServer = class {
     this._resourceHandlersInitialized = false;
     this._promptHandlersInitialized = false;
     this.server = new Server(serverInfo, options);
+    this._maxToolInputElements = resolveMaxToolInputElements(options?.maxToolInputElements);
   }
   /**
    * Access experimental features.
@@ -22838,12 +22898,15 @@ var McpServer = class {
    * Validates tool input arguments against the tool's input schema.
    */
   async validateToolInput(tool, args, toolName) {
+    if (this._maxToolInputElements !== void 0 && toolInputElementCount(args, this._maxToolInputElements) > this._maxToolInputElements) {
+      throw new McpError(ErrorCode.InvalidParams, `Invalid arguments for tool ${toolName}: arguments contain more than the maximum of ${this._maxToolInputElements} elements`);
+    }
     if (!tool.inputSchema) {
       return void 0;
     }
     const inputObj = normalizeObjectSchema(tool.inputSchema);
     const schemaToParse = inputObj ?? tool.inputSchema;
-    const parseResult = await safeParseAsync3(schemaToParse, args);
+    const parseResult = await safeParseAsync3(schemaToParse, args ?? {});
     if (!parseResult.success) {
       const error2 = "error" in parseResult ? parseResult.error : "Unknown error";
       const errorMessage = getParseErrorMessage(error2);
@@ -23081,7 +23144,7 @@ var McpServer = class {
       }
       if (prompt.argsSchema) {
         const argsObj = normalizeObjectSchema(prompt.argsSchema);
-        const parseResult = await safeParseAsync3(argsObj, request.params.arguments);
+        const parseResult = await safeParseAsync3(argsObj, request.params.arguments ?? {});
         if (!parseResult.success) {
           const error2 = "error" in parseResult ? parseResult.error : "Unknown error";
           const errorMessage = getParseErrorMessage(error2);
@@ -23935,6 +23998,11 @@ var TOOL_META = {
   get_task: { annotations: READ, outputSchema: CONTEXT_SCHEMA },
   get_task_spec: { annotations: READ },
   list_tasks: { annotations: READ, outputSchema: TASKS_OUTPUT },
+  list_task_templates: { annotations: READ },
+  list_recycled_tasks: { annotations: READ, outputSchema: PAGE_OUTPUT },
+  delete_task: { annotations: write(true, false) },
+  restore_task: { annotations: write(false, false) },
+  purge_task: { annotations: write(true, false) },
   browse_tasks: { annotations: READ, outputSchema: BROWSE_OUTPUT },
   list_ready_tasks: { annotations: READ, outputSchema: TASKS_OUTPUT },
   list_projects: { annotations: READ, outputSchema: PAGE_OUTPUT },
@@ -24025,6 +24093,10 @@ var BROWSE_MAX_PROJECTS = 50;
 var STATUS_CATEGORIES = ["backlog", "unstarted", "started", "blocked", "review", "done", "canceled"];
 var WORK_TOOL_NAMES = /* @__PURE__ */ new Set([
   "begin_task",
+  "list_recycled_tasks",
+  "delete_task",
+  "restore_task",
+  "purge_task",
   "finish_task_work",
   "get_task_context",
   // 不知道任务编号时找活的入口（IMMO-221）：只读、有界、只回摘要。list_projects / list_tasks
@@ -24933,6 +25005,52 @@ ${JSON.stringify(receipt)}`),
         );
       }
     }),
+    defineTool({
+      name: "delete_task",
+      description: "\u5C06\u4EFB\u52A1\u79FB\u5165\u9879\u76EE\u56DE\u6536\u7AD9\uFF0C\u91CA\u653E\u7F16\u53F7\u4F9B\u65B0\u4EFB\u52A1\u590D\u7528\u3002\u5B50\u4EFB\u52A1\u4FDD\u7559\u5E76\u63D0\u5347\u4E3A\u6839\u4EFB\u52A1\uFF0C\u4F9D\u8D56\u5173\u7CFB\u79FB\u9664\uFF1B\u8BC4\u8BBA\u3001\u8BF4\u660E\u7248\u672C\u548C\u4EA4\u4ED8\u4FDD\u7559\u3002\u4ECD\u88AB\u9886\u53D6\u65F6\u987B\u5148\u91CA\u653E\u3002\u6309\u6388\u6743\u76F4\u63A5\u6267\u884C\u6216\u63D0\u4EA4\u5BA1\u6279\u3002",
+      inputSchema: { task: external_exports.string().describe("\u4EFB\u52A1\u7F16\u53F7\u6216 UUID") },
+      async handler(args) {
+        const task = await resolveTaskRef(args.task);
+        return reportWrite("\u4EFB\u52A1\u5DF2\u79FB\u5165\u9879\u76EE\u56DE\u6536\u7AD9", await client.task.delete.mutate({ taskId: task.id }));
+      }
+    }),
+    defineTool({
+      name: "list_recycled_tasks",
+      description: "\u5206\u9875\u67E5\u770B\u9879\u76EE\u56DE\u6536\u7AD9\u3002formerKey \u4EC5\u4E3A\u5386\u53F2\u7F16\u53F7\uFF0C\u53EF\u80FD\u5DF2\u88AB\u590D\u7528\uFF1B\u6062\u590D\u3001\u5F7B\u5E95\u5220\u9664\u5FC5\u987B\u4F7F\u7528\u8FD4\u56DE\u7684\u4EFB\u52A1 UUID\u3002",
+      inputSchema: { project: external_exports.string(), limit: external_exports.number().int().min(1).max(100).optional(), offset: external_exports.number().int().min(0).optional() },
+      async handler(args) {
+        const project = await resolveProject(args.project);
+        const offset = args.offset ?? 0;
+        const limit = args.limit ?? 50;
+        const items = await client.task.recycle.query({ projectId: project.id, offset, limit });
+        return json({ items, nextOffset: items.length === limit ? offset + limit : null });
+      }
+    }),
+    defineTool({
+      name: "restore_task",
+      description: "\u6062\u590D\u56DE\u6536\u7AD9\u4EFB\u52A1\uFF0CUUID \u548C\u5386\u53F2\u5185\u5BB9\u4E0D\u53D8\uFF0C\u4F46\u5206\u914D\u6700\u65B0\u9012\u589E\u7F16\u53F7\u3002\u4E0D\u4F1A\u6062\u590D\u7236\u5B50\u5173\u7CFB\u6216\u4F9D\u8D56\u8FB9\u3002\u6309\u6388\u6743\u76F4\u63A5\u6267\u884C\u6216\u63D0\u4EA4\u5BA1\u6279\u3002",
+      inputSchema: { task_id: external_exports.string().uuid().describe("\u56DE\u6536\u7AD9\u91CC\u7684 UUID\uFF0C\u4E0D\u53EF\u4F7F\u7528\u5DF2\u91CA\u653E\u7684\u65E7\u7F16\u53F7") },
+      async handler(args) {
+        return reportWrite("\u4EFB\u52A1\u5DF2\u6062\u590D\u5E76\u5206\u914D\u65B0\u7F16\u53F7", await client.task.restore.mutate({ taskId: args.task_id }));
+      }
+    }),
+    defineTool({
+      name: "purge_task",
+      description: "\u4E0D\u53EF\u9006\u5730\u5F7B\u5E95\u5220\u9664\u56DE\u6536\u7AD9\u4EFB\u52A1\u53CA\u8BC4\u8BBA\u3001\u8BF4\u660E\u7248\u672C\u548C\u4EA4\u4ED8\u3002\u4EC5\u7BA1\u7406\u5458\u6216\u7ECF\u5176\u660E\u786E\u6388\u6743\u7684 Agent \u53EF\u7528\uFF1B\u4FDD\u7559\u5BA1\u8BA1\u4E8B\u4EF6\u53CA\u8FD0\u884C\u6210\u672C\u8BB0\u5F55\u3002\u5FC5\u987B\u660E\u786E\u786E\u8BA4\u3002",
+      inputSchema: { task_id: external_exports.string().uuid(), confirm: external_exports.literal(true).describe("\u660E\u786E\u786E\u8BA4\u4E0D\u53EF\u6062\u590D") },
+      async handler(args) {
+        return reportWrite("\u56DE\u6536\u7AD9\u4EFB\u52A1\u5DF2\u5F7B\u5E95\u5220\u9664\uFF0C\u4E0D\u53EF\u6062\u590D", await client.task.purge.mutate({ taskId: args.task_id, confirm: args.confirm }));
+      }
+    }),
+    defineTool({
+      name: "list_task_templates",
+      description: "\u5217\u51FA\u9879\u76EE\u53EF\u7528\u7684\u4EFB\u52A1\u6A21\u677F\uFF0C\u8FD4\u56DE\u6A21\u677F ID\u3001\u8BF4\u660E\u3001\u9A8C\u6536\u6807\u51C6\u548C\u9ED8\u8BA4\u5C5E\u6027\uFF1Bcreate_task \u4F7F\u7528 template_id \u5E94\u7528\u6A21\u677F\u3002",
+      inputSchema: { project: external_exports.string().describe("\u9879\u76EE key\u3001uuid \u6216\u540D\u5B57") },
+      async handler(args) {
+        const project = await resolveProject(args.project);
+        return json(await client.taskTemplate.list.query({ projectId: project.id }));
+      }
+    }),
     defineTool({
       name: "get_task",
       description: "\u5B8C\u6574\u8BCA\u65AD\u8BFB\u53D6\uFF08full profile\uFF09\uFF1A\u63CF\u8FF0\u3001\u9A8C\u6536\u6807\u51C6\u3001\u72B6\u6001\u3001\u6307\u6D3E\u4EBA\u3001\u8BC4\u8BBA\u3001\u7236\u5B50\u5C42\u7EA7\u3001\u4F9D\u8D56\u5173\u7CFB\u3001\u6240\u5728\u51B2\u523A\uFF08\u542B\u8FD9\u4E00\u8F6E\u7684\u76EE\u6807\u548C\u622A\u6B62\uFF09\u3001\u5386\u53F2\u4E8B\u4EF6\u3001\u72B6\u6001\u53D8\u66F4\u8BB0\u5F55\uFF08statusHistory\uFF1A\u8C01\u3001\u4EC0\u4E48\u65F6\u5019\u3001\u4ECE\u4EC0\u4E48\u72B6\u6001\u6539\u6210\u4EC0\u4E48\u72B6\u6001\uFF0C\u4EBA\u548C Agent \u90FD\u5728\uFF09\u3001\u4EE5\u53CA\u5DF2\u7ECF\u5728\u5B83\u4E0A\u9762\u8DD1\u8FC7\u7684 Agent \u8FD0\u884C\u3002\u65E5\u5E38\u6267\u884C\u4F18\u5148\u7528 get_task_context\u3002",
@@ -24950,6 +25068,7 @@ ${JSON.stringify(receipt)}`),
       inputSchema: {
         title: external_exports.string().min(1).max(500),
         project: external_exports.string().optional().describe("\u9879\u76EE key\u3001uuid \u6216\u540D\u5B57"),
+        template_id: external_exports.string().uuid().optional().describe("\u9879\u76EE\u4EFB\u52A1\u6A21\u677F ID\uFF0C\u53EF\u901A\u8FC7 list_task_templates \u9009\u62E9"),
         description: markdownSchema.optional(),
         acceptance: acceptanceSchema.optional(),
         plan: external_exports.object({
@@ -24973,6 +25092,7 @@ ${JSON.stringify(receipt)}`),
           title: args.title,
           descriptionMd: args.description,
           acceptance: args.acceptance,
+          templateId: args.template_id,
           agentPlan: args.plan ? { notesMd: args.plan.notes, verification: args.plan.verification, refs: args.plan.refs } : void 0,
           type: args.type ?? "task",
           priority: args.priority ?? 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@costgate/momentum-mcp",
-  "version": "0.1.37",
+  "version": "0.2.1",
   "description": "Momentum MCP Server —— 把 Momentum 的任务、领取与交付接进任意 MCP 客户端",
   "type": "module",
   "bin": {