@costgate/momentum-mcp 0.2.1 → 0.2.3

package/README.md

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

package/momentum-mcp.mjs

@@ -15339,7 +15339,7 @@ var allowErrorProps = SuperJSON.allowErrorProps;
 
 // src/version.ts
 var UNKNOWN = "unknown";
-var MCP_VERSION = true ? "0.2.1" : versionFromRepo();
+var MCP_VERSION = true ? "0.2.3" : versionFromRepo();
 var CLIENT_HEADER = `momentum-mcp/${MCP_VERSION}`;
 function compareVersions(a, b) {
   const parse4 = (v) => {
@@ -22646,6 +22646,228 @@ var McpZodTypeKind;
   McpZodTypeKind2["Completable"] = "McpCompletable";
 })(McpZodTypeKind || (McpZodTypeKind = {}));
 
+// ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.32.1_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/uriTemplate.js
+var MAX_TEMPLATE_LENGTH = 1e6;
+var MAX_VARIABLE_LENGTH = 1e6;
+var MAX_TEMPLATE_EXPRESSIONS = 1e4;
+var MAX_REGEX_LENGTH = 1e6;
+var UriTemplate = class _UriTemplate {
+  /**
+   * Returns true if the given string contains any URI template expressions.
+   * A template expression is a sequence of characters enclosed in curly braces,
+   * like {foo} or {?bar}.
+   */
+  static isTemplate(str) {
+    return /\{[^}\s]+\}/.test(str);
+  }
+  static validateLength(str, max, context) {
+    if (str.length > max) {
+      throw new Error(`${context} exceeds maximum length of ${max} characters (got ${str.length})`);
+    }
+  }
+  get variableNames() {
+    return this.parts.flatMap((part) => typeof part === "string" ? [] : part.names);
+  }
+  constructor(template) {
+    _UriTemplate.validateLength(template, MAX_TEMPLATE_LENGTH, "Template");
+    this.template = template;
+    this.parts = this.parse(template);
+  }
+  toString() {
+    return this.template;
+  }
+  parse(template) {
+    const parts = [];
+    let currentText = "";
+    let i = 0;
+    let expressionCount = 0;
+    while (i < template.length) {
+      if (template[i] === "{") {
+        if (currentText) {
+          parts.push(currentText);
+          currentText = "";
+        }
+        const end = template.indexOf("}", i);
+        if (end === -1)
+          throw new Error("Unclosed template expression");
+        expressionCount++;
+        if (expressionCount > MAX_TEMPLATE_EXPRESSIONS) {
+          throw new Error(`Template contains too many expressions (max ${MAX_TEMPLATE_EXPRESSIONS})`);
+        }
+        const expr = template.slice(i + 1, end);
+        const operator = this.getOperator(expr);
+        const exploded = expr.includes("*");
+        const names = this.getNames(expr);
+        const name = names[0];
+        for (const name2 of names) {
+          _UriTemplate.validateLength(name2, MAX_VARIABLE_LENGTH, "Variable name");
+        }
+        parts.push({ name, operator, names, exploded });
+        i = end + 1;
+      } else {
+        currentText += template[i];
+        i++;
+      }
+    }
+    if (currentText) {
+      parts.push(currentText);
+    }
+    return parts;
+  }
+  getOperator(expr) {
+    const operators = ["+", "#", ".", "/", "?", "&"];
+    return operators.find((op) => expr.startsWith(op)) || "";
+  }
+  getNames(expr) {
+    const operator = this.getOperator(expr);
+    return expr.slice(operator.length).split(",").map((name) => name.replace("*", "").trim()).filter((name) => name.length > 0);
+  }
+  encodeValue(value, operator) {
+    _UriTemplate.validateLength(value, MAX_VARIABLE_LENGTH, "Variable value");
+    if (operator === "+" || operator === "#") {
+      return encodeURI(value);
+    }
+    return encodeURIComponent(value);
+  }
+  expandPart(part, variables) {
+    if (part.operator === "?" || part.operator === "&") {
+      const pairs = part.names.map((name) => {
+        const value2 = variables[name];
+        if (value2 === void 0)
+          return "";
+        const encoded2 = Array.isArray(value2) ? value2.map((v) => this.encodeValue(v, part.operator)).join(",") : this.encodeValue(value2.toString(), part.operator);
+        return `${name}=${encoded2}`;
+      }).filter((pair) => pair.length > 0);
+      if (pairs.length === 0)
+        return "";
+      const separator = part.operator === "?" ? "?" : "&";
+      return separator + pairs.join("&");
+    }
+    if (part.names.length > 1) {
+      const values2 = part.names.map((name) => variables[name]).filter((v) => v !== void 0);
+      if (values2.length === 0)
+        return "";
+      return values2.map((v) => Array.isArray(v) ? v[0] : v).join(",");
+    }
+    const value = variables[part.name];
+    if (value === void 0)
+      return "";
+    const values = Array.isArray(value) ? value : [value];
+    const encoded = values.map((v) => this.encodeValue(v, part.operator));
+    switch (part.operator) {
+      case "":
+        return encoded.join(",");
+      case "+":
+        return encoded.join(",");
+      case "#":
+        return "#" + encoded.join(",");
+      case ".":
+        return "." + encoded.join(".");
+      case "/":
+        return "/" + encoded.join("/");
+      default:
+        return encoded.join(",");
+    }
+  }
+  expand(variables) {
+    let result = "";
+    let hasQueryParam = false;
+    for (const part of this.parts) {
+      if (typeof part === "string") {
+        result += part;
+        continue;
+      }
+      const expanded = this.expandPart(part, variables);
+      if (!expanded)
+        continue;
+      if ((part.operator === "?" || part.operator === "&") && hasQueryParam) {
+        result += expanded.replace("?", "&");
+      } else {
+        result += expanded;
+      }
+      if (part.operator === "?" || part.operator === "&") {
+        hasQueryParam = true;
+      }
+    }
+    return result;
+  }
+  escapeRegExp(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  }
+  partToRegExp(part) {
+    const patterns = [];
+    for (const name2 of part.names) {
+      _UriTemplate.validateLength(name2, MAX_VARIABLE_LENGTH, "Variable name");
+    }
+    if (part.operator === "?" || part.operator === "&") {
+      for (let i = 0; i < part.names.length; i++) {
+        const name2 = part.names[i];
+        const prefix = i === 0 ? "\\" + part.operator : "&";
+        patterns.push({
+          pattern: prefix + this.escapeRegExp(name2) + "=([^&]+)",
+          name: name2
+        });
+      }
+      return patterns;
+    }
+    let pattern;
+    const name = part.name;
+    switch (part.operator) {
+      case "":
+        pattern = part.exploded ? "([^/,]+(?:,[^/,]+)*)" : "([^/,]+)";
+        break;
+      case "+":
+      case "#":
+        pattern = "(.+)";
+        break;
+      case ".":
+        pattern = "\\.([^/,]+)";
+        break;
+      case "/":
+        pattern = "/" + (part.exploded ? "([^/,]+(?:,[^/,]+)*)" : "([^/,]+)");
+        break;
+      default:
+        pattern = "([^/]+)";
+    }
+    patterns.push({ pattern, name });
+    return patterns;
+  }
+  match(uri) {
+    _UriTemplate.validateLength(uri, MAX_TEMPLATE_LENGTH, "URI");
+    let pattern = "^";
+    const names = [];
+    for (const part of this.parts) {
+      if (typeof part === "string") {
+        pattern += this.escapeRegExp(part);
+      } else {
+        const patterns = this.partToRegExp(part);
+        for (const { pattern: partPattern, name } of patterns) {
+          pattern += partPattern;
+          names.push({ name, exploded: part.exploded });
+        }
+      }
+    }
+    pattern += "$";
+    _UriTemplate.validateLength(pattern, MAX_REGEX_LENGTH, "Generated regex pattern");
+    const regex = new RegExp(pattern);
+    const match = uri.match(regex);
+    if (!match)
+      return null;
+    const result = {};
+    for (let i = 0; i < names.length; i++) {
+      const { name, exploded } = names[i];
+      const value = match[i + 1];
+      const cleanName = name.replace("*", "");
+      if (exploded && value.includes(",")) {
+        result[cleanName] = value.split(",");
+      } else {
+        result[cleanName] = value;
+      }
+    }
+    return result;
+  }
+};
+
 // ../../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) {
@@ -23475,6 +23697,30 @@ var McpServer = class {
     }
   }
 };
+var ResourceTemplate = class {
+  constructor(uriTemplate, _callbacks) {
+    this._callbacks = _callbacks;
+    this._uriTemplate = typeof uriTemplate === "string" ? new UriTemplate(uriTemplate) : uriTemplate;
+  }
+  /**
+   * Gets the URI template pattern.
+   */
+  get uriTemplate() {
+    return this._uriTemplate;
+  }
+  /**
+   * Gets the list callback, if one was provided.
+   */
+  get listCallback() {
+    return this._callbacks.list;
+  }
+  /**
+   * Gets the callback for completing a specific URI template variable, if one was provided.
+   */
+  completeCallback(variable) {
+    return this._callbacks.complete?.[variable];
+  }
+};
 var EMPTY_OBJECT_JSON_SCHEMA = {
   type: "object",
   properties: {}
@@ -23551,6 +23797,68 @@ var EMPTY_COMPLETION_RESULT = {
   }
 };
 
+// src/prompts.ts
+var TASK_ARG = external_exports.string().min(1).describe("\u4EFB\u52A1\u7F16\u53F7\uFF0C\u5982 MOM-12");
+var user = (lines) => [
+  { role: "user", content: { type: "text", text: lines.filter((l) => typeof l === "string").join("\n") } }
+];
+function createPrompts(profile = "work") {
+  const canDigest = profile === "full";
+  return [
+    {
+      name: "start_task",
+      title: "\u5F00\u59CB\u505A\u4EFB\u52A1",
+      description: "\u9886\u53D6\u4E00\u4E2A Momentum \u4EFB\u52A1\u5E76\u6309\u56E2\u961F\u6D41\u7A0B\u5F00\u5DE5\uFF1A\u8BFB\u4E0A\u4E0B\u6587\u3001\u8BB2\u6E05\u65B9\u6848\u3001\u52A8\u624B\u3001\u5173\u952E\u8282\u70B9\u7559\u8BC4\u8BBA\u3002",
+      argsSchema: { task: TASK_ARG, note: external_exports.string().optional().describe("\u8FD9\u6B21\u8981\u505A\u4EC0\u4E48\u3001\u6709\u4EC0\u4E48\u989D\u5916\u8981\u6C42") },
+      render: ({ task, note }) => user([
+        `\u8BF7\u5F00\u59CB\u505A Momentum \u4EFB\u52A1 ${task}\u3002`,
+        "",
+        `1. \u76F4\u63A5\u8C03 begin_task("${task}")\uFF1A\u5B83\u4E00\u6B21\u5B8C\u6210\u89E3\u6790\u7F16\u53F7\u3001\u5F00\u8FD0\u884C\u3001\u9886\u53D6\u5E76\u8FD4\u56DE\u7D27\u51D1\u4E0A\u4E0B\u6587\uFF0C\u4E0D\u5FC5\u5148 whoami / get_task\u3002\u5FC3\u8DF3\u81EA\u52A8\u7EED\u7EA6\u3002`,
+        "2. \u8BFB\u4E0A\u4E0B\u6587\uFF1A\u63CF\u8FF0\u3001\u9A8C\u6536\u6807\u51C6\uFF08\u8BB0\u4E0B specVersion\uFF0C\u4EA4\u4ED8\u65F6\u8981\u7528\uFF09\u3001\u4F9D\u8D56\u3001\u5DF2\u6709\u51B3\u5B9A\u3001\u5F85\u7B54\u95EE\u9898\u548C\u6700\u65B0\u4EA4\u4ED8\u3002\u88AB\u4F9D\u8D56\u5361\u4F4F\u3001\u6216\u6709\u963B\u585E\u95EE\u9898\u6CA1\u7B54\u65F6\uFF0C\u5148\u505C\u4E0B\u6765\u544A\u8BC9\u6211\u3002",
+        "3. \u52A8\u624B\u524D\u5148\u7528\u5927\u767D\u8BDD\u8BB2\u6E05\u6253\u7B97\u600E\u4E48\u505A\u3001\u6BCF\u6761\u9A8C\u6536\u6807\u51C6\u6253\u7B97\u600E\u4E48\u9A8C\u8BC1\uFF1B\u65B9\u6848\u503C\u5F97\u7559\u6863\u5C31\u7528 update_task_plan \u5199\u8FDB\u6267\u884C\u7EC6\u5316\u3002",
+        "4. \u5F00\u59CB\u5E72\u6D3B\u3002\u7F3A\u4FE1\u606F\u5148\u95EE\u6211\uFF1B\u6211\u7B54\u4E0D\u4E86\u3001\u8981\u56E2\u961F\u62CD\u677F\u7684\u624D\u7528 ask_question\u3002\u5173\u952E\u8282\u70B9\u7528 comment_on_task \u5199\u4E00\u6761\u77ED\u8FDB\u5C55\uFF08\u5148\u7ED3\u8BBA\u3001\u518D\u8981\u70B9\uFF09\u3002",
+        "5. \u505A\u5B8C\u6309\u300C\u5199\u4EA4\u4ED8\u8BF4\u660E\u300D\uFF08write_delivery\uFF09\u7684\u8981\u6C42\u8C03 finish_task_work \u63D0\u4EA4\u4EA4\u4ED8\u5E76\u79FB\u5230\u8BC4\u5BA1\u3002",
+        note && "",
+        note && `\u8865\u5145\u8981\u6C42\uFF1A${note}`
+      ])
+    },
+    {
+      name: "digest_discussion",
+      title: "\u6574\u7406\u8BA8\u8BBA\u6210\u63D0\u6848",
+      description: "\u628A\u5F53\u524D\u4F1A\u8BDD\u91CC\u7684\u8BA8\u8BBA\u6574\u7406\u6210\u4EFB\u52A1\u7684\u4FEE\u6539\u63D0\u6848\uFF1A\u62CD\u677F\u7684\u51B3\u5B9A\u3001\u5F85\u7B54\u95EE\u9898\u3001\u8BF4\u660E\u4E0E\u9A8C\u6536\u6807\u51C6\u7684\u6539\u52A8\u3002",
+      argsSchema: { task: TASK_ARG, focus: external_exports.string().optional().describe("\u53EA\u6574\u7406\u8BA8\u8BBA\u91CC\u7684\u54EA\u4E00\u90E8\u5206") },
+      render: ({ task, focus }) => user([
+        `\u628A\u6211\u4EEC\u8FD9\u6BB5\u8BA8\u8BBA\u6574\u7406\u6210\u4EFB\u52A1 ${task} \u7684\u4FEE\u6539\u63D0\u6848\u3002`,
+        focus && `\u53EA\u6574\u7406\u8FD9\u90E8\u5206\uFF1A${focus}`,
+        "",
+        `1. \u5148\u8C03 get_task_context("${task}") \u770B\u5F53\u524D\u8BF4\u660E\u3001\u7248\u672C\u53F7 specVersion\u3001\u5DF2\u6709\u51B3\u5B9A\u548C\u5F85\u7B54\u95EE\u9898\uFF0C\u5DF2\u6709\u7684\u4E0D\u8981\u91CD\u590D\u3002`,
+        "2. \u4ECE\u8BA8\u8BBA\u91CC\u63D0\u53D6\u4E09\u7C7B\u4E1C\u897F\uFF1A",
+        "   - \u5DF2\u7ECF\u62CD\u677F\u7684\u51B3\u5B9A\uFF1A\u4E00\u6761\u53EA\u8BF4\u4E00\u4EF6\u4E8B\uFF0C\u5199\u6E05\u7406\u7531\uFF1B",
+        "   - \u8FD8\u6CA1\u6709\u7B54\u6848\u7684\u95EE\u9898\uFF1A\u6807\u51FA\u54EA\u4E9B\u4F1A\u5361\u4F4F\u8FDB\u5EA6\uFF1B",
+        "   - \u63CF\u8FF0\u6216\u9A8C\u6536\u6807\u51C6\u8981\u600E\u4E48\u6539\uFF1A\u9A8C\u6536\u6807\u51C6\u6BCF\u6761\u53EF\u6838\u5BF9\uFF0C\u4FDD\u7559\u539F\u6709\u7684 id\u3002",
+        "   \u8BA8\u8BBA\u4E2D\u7684\u8BBE\u60F3\u3001\u53EA\u6709\u6211\u4E00\u65B9\u63D0\u8FC7\u7684\u60F3\u6CD5\u4E0D\u7B97\u51B3\u5B9A\uFF0C\u4E0D\u80FD\u81EA\u884C\u8BA4\u5B9A\u3002",
+        "3. \u5148\u628A\u8349\u7A3F\u7528\u5927\u767D\u8BDD\u5217\u7ED9\u6211\u8FC7\u76EE\uFF0C\u6211\u786E\u8BA4\u540E\u518D\u63D0\u4EA4\u3002",
+        canDigest ? "4. \u786E\u8BA4\u540E\u8C03 propose_digest\uFF0Cspec_change.expected_version \u586B\u7B2C 1 \u6B65\u8BFB\u5230\u7684 specVersion\u3002\u5B83\u662F\u4E00\u6761\u5F85\u4EBA\u786E\u8BA4\u7684\u63D0\u6848\uFF1A\u63A5\u53D7\u540E\u4E00\u6B21\u751F\u6548\u3001\u8BF4\u660E\u5F62\u6210\u65B0\u7248\u672C\uFF0C\u5728\u90A3\u4E4B\u524D\u4EFB\u52A1\u6CA1\u6709\u4EFB\u4F55\u6539\u52A8\u3002" : "4. \u5F53\u524D\u5DE5\u5177\u6863\uFF08work\uFF09\u6CA1\u6709 propose_digest\uFF1A\u786E\u8BA4\u540E\u628A\u51B3\u5B9A\u548C\u8BF4\u660E\u6539\u52A8\u7528 comment_on_task \u8BB0\u5230\u4EFB\u52A1\u4E0B\uFF0C\u963B\u585E\u95EE\u9898\u7528 ask_question \u63D0\u51FA\u6765\uFF1B\u5E76\u63D0\u9192\u6211\u8BF4\u660E\u672C\u8EAB\u8981\u5728 Momentum \u754C\u9762\u91CC\u6539\uFF0C\u6216\u628A MOMENTUM_TOOL_PROFILE \u8BBE\u6210 full \u540E\u518D\u63D0\u4EA4\u63D0\u6848\u3002"
+      ])
+    },
+    {
+      name: "write_delivery",
+      title: "\u5199\u4EA4\u4ED8\u8BF4\u660E",
+      description: "\u6309\u4EFB\u52A1\u8BF4\u660E\u9010\u6761\u8986\u76D6\u9A8C\u6536\u6807\u51C6\uFF0C\u5199\u597D\u4EA4\u4ED8\u8BF4\u660E\u5E76\u8C03 finish_task_work \u63D0\u4EA4\u3001\u79FB\u5230\u8BC4\u5BA1\u3002",
+      argsSchema: { task: TASK_ARG },
+      render: ({ task }) => user([
+        `\u4E3A\u4EFB\u52A1 ${task} \u5199\u4EA4\u4ED8\u8BF4\u660E\u5E76\u63D0\u4EA4\u3002`,
+        "",
+        `1. \u624B\u4E0A\u6CA1\u6709\u9A8C\u6536\u6807\u51C6\u548C specVersion \u65F6\u5148\u8C03 get_task_context("${task}")\u3002based_on_spec_version \u586B\u4F60\u5B9E\u9645\u5BF9\u7167\u7684\u90A3\u4E2A\u7248\u672C\uFF1B\u5F00\u5DE5\u540E\u8BF4\u660E\u5347\u8FC7\u7248\uFF0C\u5148\u5BF9\u7167\u65B0\u7248\u672C\u770B\u8FD8\u5DEE\u4EC0\u4E48\u3002`,
+        "2. summary \u5199\u7ED9\u4EFB\u52A1\u6307\u6D3E\u7684\u4EBA\u770B\uFF1A\u5927\u767D\u8BDD\u8BB2\u505A\u4E86\u4EC0\u4E48\u3001\u5173\u952E\u53D6\u820D\u3001\u5BF9\u4F7F\u7528\u8005\u7684\u5F71\u54CD\uFF1B\u6D41\u7A0B\u6216\u6A21\u5757\u5173\u7CFB\u7528 mermaid \u753B\u51FA\u6765\u3002\u5DE5\u7A0B\u5E08\u591A\u8BB2\u5B9E\u73B0\u53D6\u820D\uFF0C\u5176\u4ED6\u4EBA\u53EA\u8BB2\u7ED3\u679C\u3002",
+        "3. results \u9010\u6761\u8986\u76D6\u6BCF\u4E2A\u9A8C\u6536\u6807\u51C6\uFF08criterionId \u7528\u8BF4\u660E\u91CC\u7684 id\uFF09\uFF1Aoutcome \u53EA\u7528 passed / failed / unverified\uFF0Cevidence \u5199\u522B\u4EBA\u80FD\u6838\u5BF9\u7684\u8BC1\u636E\uFF08\u6D4B\u8BD5\u540D\u3001\u547D\u4EE4\u8F93\u51FA\u3001\u94FE\u63A5\uFF09\u3002\u6CA1\u6709\u771F\u6B63\u9A8C\u8BC1\u8FC7\u7684\u6807 unverified\uFF0C\u4E0D\u8981\u731C\u3002",
+        "4. artifacts \u653E PR\u3001\u6587\u6863\u7B49\u94FE\u63A5\uFF1B\u6CA1\u505A\u5B8C\u7684\u5199\u8FDB remaining_work\uFF1B\u63A5\u624B\u7684\u4EBA\u9700\u8981\u77E5\u9053\u7684\u5199\u8FDB handoff\u3002",
+        "5. \u8C03 finish_task_work \u63D0\u4EA4\uFF1Aidempotency_key \u53D6\u4E00\u4E2A\u7A33\u5B9A\u7684\u503C\uFF0C\u67D0\u4E00\u6B65\u5931\u8D25\u65F6\u7528\u76F8\u540C\u53C2\u6570\u91CD\u8BD5\u3002\u4EFB\u52A1\u4F1A\u8FDB\u8BC4\u5BA1\uFF0C\u8BC4\u5BA1\u901A\u8FC7\u524D\u4E0D\u7B97\u5B8C\u6210\u3002"
+      ])
+    }
+  ];
+}
+
 // ../../packages/core/src/task-schemas.ts
 var markdownSchema = external_exports.string().max(2e5);
 var httpUrl = external_exports.string().url().max(2e3).refine((url) => /^https?:\/\//i.test(url), "\u53EA\u652F\u6301 HTTP(S) \u94FE\u63A5");
@@ -23601,11 +23909,13 @@ var RunHeartbeats = class {
   lastRunOfTask = /* @__PURE__ */ new Map();
   pending = [];
   timer = null;
+  closed = false;
   intervalMs;
   leaseSeconds;
   log;
   /** 开始替这次运行续约。expectClaim = 它手上应当有领取，续不上要告诉模型 */
   track(runId, taskId, expectClaim = false) {
+    if (this.closed) return;
     this.runs.set(runId, { taskId, expectClaim });
     if (taskId) this.lastRunOfTask.set(taskId, runId);
     if (!this.timer) {
@@ -23628,6 +23938,10 @@ var RunHeartbeats = class {
   has(runId) {
     return this.runs.has(runId);
   }
+  /** 正在续约的运行数 */
+  get size() {
+    return this.runs.size;
+  }
   /** 取走攒下的提醒。每条只给模型看一次 */
   drainNotices() {
     return this.pending.splice(0);
@@ -23636,6 +23950,15 @@ var RunHeartbeats = class {
     if (this.timer) clearInterval(this.timer);
     this.timer = null;
   }
+  /**
+   * 永久停掉：之后再 track 也不会续约。远程会话（http.ts）结束时用 —— 会话关掉的那一刻
+   * 可能还有一个 begin_task 在路上，它回来时的 track 不能把一个已经没人的会话重新续活
+   */
+  close() {
+    this.closed = true;
+    this.runs.clear();
+    this.stop();
+  }
   /** 给所有在跟的运行各发一次心跳。定时器调它，测试也直接调它 */
   async tick() {
     await Promise.all([...this.runs].map(([runId, run2]) => this.beatOne(runId, run2)));
@@ -23977,6 +24300,14 @@ var BEGIN_OUTPUT = external_exports.object({
   context: CONTEXT_SCHEMA.optional(),
   proposalId: external_exports.string().optional()
 }).passthrough();
+var NAMED = external_exports.object({ id: external_exports.string(), name: external_exports.string() }).passthrough();
+var WHOAMI_OUTPUT = external_exports.object({
+  kind: external_exports.enum(["agent", "human"]),
+  actorId: external_exports.string().nullable(),
+  orgId: external_exports.string().nullable(),
+  agent: NAMED.optional(),
+  instance: NAMED.optional()
+}).passthrough();
 var PAGE_OUTPUT = external_exports.object({ items: external_exports.array(external_exports.unknown()) }).passthrough();
 var TASKS_OUTPUT = external_exports.object({ items: external_exports.array(external_exports.object(TASK_FIELDS).passthrough()) }).passthrough();
 var BROWSE_OUTCOME = external_exports.enum(["ok", "no_projects", "no_match", "project_unavailable", "failed"]);
@@ -23986,7 +24317,7 @@ var BROWSE_OUTPUT = external_exports.object({
   items: external_exports.array(external_exports.unknown()),
   nextOffset: external_exports.number().nullable()
 }).passthrough();
-var READ = { readOnlyHint: true, openWorldHint: false };
+var READ = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
 var write = (destructiveHint, idempotentHint) => ({
   readOnlyHint: false,
   destructiveHint,
@@ -24010,7 +24341,7 @@ var TOOL_META = {
   list_task_deliveries: { annotations: READ, outputSchema: PAGE_OUTPUT },
   poll_events: { annotations: READ, outputSchema: PAGE_OUTPUT },
   current_cycle: { annotations: READ },
-  whoami: { annotations: READ },
+  whoami: { annotations: READ, outputSchema: WHOAMI_OUTPUT },
   // 开工 / 收尾：重复调用沿用同一次运行、交付按 idempotency_key 去重
   begin_task: { annotations: write(false, true), outputSchema: BEGIN_OUTPUT },
   finish_task_work: { annotations: write(false, true), outputSchema: FINISH_OUTPUT },
@@ -25381,6 +25712,52 @@ function explain(err) {
   return `\u5931\u8D25\uFF1A${message}`;
 }
 
+// src/resources.ts
+var SPEC_URI = (key, version2) => `momentum://task/${encodeURIComponent(key)}/spec${version2 === void 0 ? "" : `/${version2}`}`;
+var UUID2 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function renderSpec(key, spec, current) {
+  const at = spec.createdAt instanceof Date ? spec.createdAt.toISOString() : spec.createdAt;
+  const criteria = spec.acceptance?.criteria ?? [];
+  return [
+    `# ${key} \xB7 ${spec.title}`,
+    "",
+    `\u8BF4\u660E\u7248\u672C v${spec.version}\uFF08\u4E0D\u53EF\u53D8\uFF0C${current ? "\u5F53\u524D\u7248\uFF0C" : ""}\u5730\u5740 ${SPEC_URI(key, spec.version)}\uFF09\xB7 ${at}`,
+    ...spec.changeSummary ? [`\u672C\u7248\u53D8\u66F4\uFF1A${spec.changeSummary}`] : [],
+    "",
+    "## \u63CF\u8FF0",
+    "",
+    spec.descriptionMd?.trim() || "\uFF08\u65E0\u63CF\u8FF0\uFF09",
+    "",
+    "## \u9A8C\u6536\u6807\u51C6",
+    "",
+    ...criteria.length ? criteria.map((c) => `- [${c.id}] ${c.text}`) : ["\uFF08\u672A\u5B9A\u4E49\u9A8C\u6536\u6807\u51C6\uFF09"]
+  ].join("\n");
+}
+function createSpecReader(client) {
+  async function resolve(ref) {
+    const [found] = UUID2.test(ref) ? [await client.task.ref.query({ taskId: ref })] : await client.task.list.query({ key: ref, limit: 1 });
+    if (!found) throw new Error(`\u627E\u4E0D\u5230\u4EFB\u52A1 '${ref}'`);
+    return { id: found.id, key: found.key };
+  }
+  return async function readSpec(ref, version2) {
+    if (version2 !== void 0 && !/^\d+$/.test(version2)) {
+      throw new Error(`\u8BF4\u660E\u7248\u672C\u53F7\u5FC5\u987B\u662F\u975E\u8D1F\u6574\u6570\uFF0C\u6536\u5230 '${version2}'`);
+    }
+    try {
+      const task = await resolve(ref);
+      const current = (await client.task.context.query({ taskId: task.id })).specVersion;
+      const wanted = version2 === void 0 ? current : Number(version2);
+      const spec = await client.task.spec.query({ taskId: task.id, version: wanted });
+      return {
+        mimeType: "text/markdown",
+        text: renderSpec(task.key, spec, wanted === current)
+      };
+    } catch (err) {
+      throw new Error(explain(err));
+    }
+  };
+}
+
 // src/server.ts
 var SERVER_INFO = {
   name: "momentum",
@@ -25426,6 +25803,29 @@ function createMcpServer(client, profile = "work", options = {}) {
       (args, extra) => tool.handler(args, extra._meta)
     );
   }
+  for (const prompt of createPrompts(profile)) {
+    server.registerPrompt(
+      prompt.name,
+      { title: prompt.title, description: prompt.description, argsSchema: prompt.argsSchema },
+      (args) => ({ description: prompt.description, messages: prompt.render(args) })
+    );
+  }
+  const readSpec = createSpecReader(client);
+  const one = (value) => Array.isArray(value) ? value[0] ?? "" : value ?? "";
+  server.registerResource(
+    "task_spec",
+    new ResourceTemplate("momentum://task/{key}/spec", { list: void 0 }),
+    { title: "\u4EFB\u52A1\u8BF4\u660E\uFF08\u5F53\u524D\u7248\uFF09", description: "\u4EFB\u52A1\u5F53\u524D\u7248\u672C\u7684\u6807\u9898\u3001\u63CF\u8FF0\u548C\u9A8C\u6536\u6807\u51C6\uFF0C\u6B63\u6587\u91CC\u5199\u660E\u7248\u672C\u53F7\u548C\u90A3\u4E00\u7248\u7684\u4E0D\u53EF\u53D8\u5730\u5740\u3002", mimeType: "text/markdown" },
+    async (uri, vars) => ({ contents: [{ uri: uri.href, ...await readSpec(decodeURIComponent(one(vars.key))) }] })
+  );
+  server.registerResource(
+    "task_spec_version",
+    new ResourceTemplate("momentum://task/{key}/spec/{version}", { list: void 0 }),
+    { title: "\u4EFB\u52A1\u8BF4\u660E\uFF08\u6307\u5B9A\u7248\u672C\uFF09", description: "\u4EFB\u52A1\u8BF4\u660E\u7684\u67D0\u4E00\u7248\uFF0C\u5185\u5BB9\u4E0D\u53EF\u53D8\u3002\u4EA4\u4ED8\u65F6 based_on_spec_version \u5BF9\u7167\u7684\u5C31\u662F\u5B83\u3002", mimeType: "text/markdown" },
+    async (uri, vars) => ({
+      contents: [{ uri: uri.href, ...await readSpec(decodeURIComponent(one(vars.key)), decodeURIComponent(one(vars.version))) }]
+    })
+  );
   return server;
 }
 

package/package.json

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