ai-project-manage-cli 7.0.3 → 7.0.5

package/dist/index.js

@@ -453,10 +453,18 @@ var requestConfig = {
       method: "PUT",
       path: "/cli/mailbox-messages/claim"
     }),
+    appendMailboxDraft: defineEndpoint({
+      method: "PUT",
+      path: "/cli/mailbox-messages/append-draft"
+    }),
     completeMailboxMessage: defineEndpoint({
       method: "PUT",
       path: "/cli/mailbox-messages/complete"
     }),
+    createCursorAgentQuestions: defineEndpoint({
+      method: "PUT",
+      path: "/cli/cursor-agent/questions"
+    }),
     upsertCursorLog: defineEndpoint({
       method: "PUT",
       path: "/cli/cursor-logs"
@@ -1372,13 +1380,65 @@ function validateReceivedMailPush(o) {
     }
   };
 }
+function validateCursorAgentResumePush(o) {
+  if (o.type !== "cursor_agent_resume") {
+    return { ok: false, reason: "\u671F\u671B cursor_agent_resume" };
+  }
+  if (o.anchorType !== "mailbox") {
+    return { ok: false, reason: "cursor_agent_resume.anchorType \u65E0\u6548" };
+  }
+  if (!nonEmptyString(o.anchorId)) {
+    return { ok: false, reason: "cursor_agent_resume \u7F3A\u5C11 anchorId" };
+  }
+  if (!nonEmptyString(o.taskId)) {
+    return { ok: false, reason: "cursor_agent_resume \u7F3A\u5C11 taskId" };
+  }
+  if (!nonEmptyString(o.cursorAgentId)) {
+    return { ok: false, reason: "cursor_agent_resume \u7F3A\u5C11 cursorAgentId" };
+  }
+  if (!nonEmptyString(o.draftReplyId)) {
+    return { ok: false, reason: "cursor_agent_resume \u7F3A\u5C11 draftReplyId" };
+  }
+  if (!nonEmptyString(o.workdir)) {
+    return { ok: false, reason: "cursor_agent_resume \u7F3A\u5C11 workdir" };
+  }
+  if (!nonEmptyString(o.model)) {
+    return { ok: false, reason: "cursor_agent_resume \u7F3A\u5C11 model" };
+  }
+  if (!nonEmptyString(o.memberDisplayName)) {
+    return { ok: false, reason: "cursor_agent_resume \u7F3A\u5C11 memberDisplayName" };
+  }
+  const mode = o.mode;
+  if (mode !== "plan" && mode !== "agent") {
+    return { ok: false, reason: "cursor_agent_resume.mode \u65E0\u6548" };
+  }
+  if (!nonEmptyString(o.prompt)) {
+    return { ok: false, reason: "cursor_agent_resume \u7F3A\u5C11 prompt" };
+  }
+  return {
+    ok: true,
+    data: {
+      type: "cursor_agent_resume",
+      anchorType: "mailbox",
+      anchorId: o.anchorId.trim(),
+      taskId: o.taskId.trim(),
+      cursorAgentId: o.cursorAgentId.trim(),
+      draftReplyId: o.draftReplyId.trim(),
+      workdir: o.workdir.trim(),
+      model: o.model.trim(),
+      memberDisplayName: o.memberDisplayName.trim(),
+      mode,
+      prompt: o.prompt.trim()
+    }
+  };
+}
 function validateAgentWsMessage(value, kind) {
   if (typeof value !== "object" || value === null) {
     return { ok: false, reason: "\u6D88\u606F\u4F53\u4E0D\u662F JSON \u5BF9\u8C61" };
   }
   const o = value;
   const type = o.type;
-  if (type !== "heartbeat" && type !== "deploy" && type !== "received_mail") {
+  if (type !== "heartbeat" && type !== "deploy" && type !== "received_mail" && type !== "cursor_agent_resume") {
     return { ok: false, reason: `\u672A\u77E5 type: ${String(type)}` };
   }
   if (kind === "heartbeat" || type === "heartbeat") {
@@ -1387,6 +1447,9 @@ function validateAgentWsMessage(value, kind) {
   if (type === "deploy") {
     return validateDeployPush(o);
   }
+  if (type === "cursor_agent_resume") {
+    return validateCursorAgentResumePush(o);
+  }
   return validateReceivedMailPush(o);
 }
 
@@ -2006,6 +2069,176 @@ function clearTaskAgentId(workdir, taskId, user) {
   writeRegistry(path13, registry);
 }
 
+// src/commands/connect/ask-question-tool.ts
+import { randomUUID } from "node:crypto";
+
+// src/ask-question.ts
+function nonEmptyString2(value) {
+  return typeof value === "string" && value.trim().length > 0;
+}
+function parseOption(value, index) {
+  if (typeof value !== "object" || value === null) {
+    return `questions[].options[${index}] \u5FC5\u987B\u662F\u5BF9\u8C61`;
+  }
+  const option = value;
+  if (!nonEmptyString2(option.id)) {
+    return `questions[].options[${index}].id \u4E0D\u80FD\u4E3A\u7A7A`;
+  }
+  if (!nonEmptyString2(option.label)) {
+    return `questions[].options[${index}].label \u4E0D\u80FD\u4E3A\u7A7A`;
+  }
+  return {
+    id: option.id.trim(),
+    label: option.label.trim()
+  };
+}
+function parseQuestion(value, index) {
+  if (typeof value !== "object" || value === null) {
+    return `questions[${index}] \u5FC5\u987B\u662F\u5BF9\u8C61`;
+  }
+  const question = value;
+  if (!nonEmptyString2(question.id)) {
+    return `questions[${index}].id \u4E0D\u80FD\u4E3A\u7A7A`;
+  }
+  if (!nonEmptyString2(question.prompt)) {
+    return `questions[${index}].prompt \u4E0D\u80FD\u4E3A\u7A7A`;
+  }
+  if (!Array.isArray(question.options)) {
+    return `questions[${index}].options \u5FC5\u987B\u662F\u6570\u7EC4`;
+  }
+  if (question.options.length < 2) {
+    return `questions[${index}].options \u81F3\u5C11\u9700\u8981 2 \u4E2A\u9009\u9879`;
+  }
+  const options = [];
+  for (let i = 0; i < question.options.length; i++) {
+    const parsed = parseOption(question.options[i], i);
+    if (typeof parsed === "string") {
+      return parsed;
+    }
+    options.push(parsed);
+  }
+  const ids = new Set(options.map((option) => option.id));
+  if (ids.size !== options.length) {
+    return `questions[${index}].options \u7684 id \u4E0D\u80FD\u91CD\u590D`;
+  }
+  return {
+    id: question.id.trim(),
+    prompt: question.prompt.trim(),
+    ...question.allow_multiple === true ? { allow_multiple: true } : {},
+    options
+  };
+}
+function validateAskQuestionInput(value) {
+  if (typeof value !== "object" || value === null) {
+    return { ok: false, error: "AskQuestion \u5165\u53C2\u5FC5\u987B\u662F\u5BF9\u8C61" };
+  }
+  const input = value;
+  if (!Array.isArray(input.questions)) {
+    return { ok: false, error: "questions \u5FC5\u987B\u662F\u6570\u7EC4" };
+  }
+  if (input.questions.length < 1) {
+    return { ok: false, error: "questions \u81F3\u5C11\u9700\u8981 1 \u9053\u9898" };
+  }
+  const questions = [];
+  for (let i = 0; i < input.questions.length; i++) {
+    const parsed = parseQuestion(input.questions[i], i);
+    if (typeof parsed === "string") {
+      return { ok: false, error: parsed };
+    }
+    questions.push(parsed);
+  }
+  const questionIds = new Set(questions.map((question) => question.id));
+  if (questionIds.size !== questions.length) {
+    return { ok: false, error: "questions[].id \u4E0D\u80FD\u91CD\u590D" };
+  }
+  const title = nonEmptyString2(input.title) ? input.title.trim() : void 0;
+  return {
+    ok: true,
+    input: {
+      ...title ? { title } : {},
+      questions
+    }
+  };
+}
+
+// src/commands/connect/ask-question-tool.ts
+var ASK_QUESTION_DESCRIPTION = "Collect structured multiple-choice answers from the user. Use when you need to clarify requirements or preferences before proceeding. When options are provided, do not re-ask the same question in prose.";
+var ASK_QUESTION_WAIT_MESSAGE = "\u95EE\u9898\u5DF2\u63D0\u4EA4\uFF0C\u7B49\u5F85\u7528\u6237\u56DE\u7B54\u3002\u8BF7\u52FF\u7EE7\u7EED\u89C4\u5212\u6216\u4EA7\u51FA\u6700\u7EC8\u7ED3\u8BBA\uFF0C\u76F4\u5230\u540E\u7EED\u6D88\u606F\u6CE8\u5165\u7528\u6237\u7B54\u6848\u3002";
+function createAskQuestionTool(handlers) {
+  const batches = [];
+  const tool = {
+    description: ASK_QUESTION_DESCRIPTION,
+    inputSchema: {
+      type: "object",
+      properties: {
+        title: {
+          type: "string",
+          description: "Optional title for the question form"
+        },
+        questions: {
+          type: "array",
+          description: "Questions to ask the user",
+          items: {
+            type: "object",
+            properties: {
+              id: {
+                type: "string",
+                description: "Unique identifier for this question"
+              },
+              prompt: {
+                type: "string",
+                description: "The question text to display"
+              },
+              allow_multiple: {
+                type: "boolean",
+                description: "Whether the user may select multiple options"
+              },
+              options: {
+                type: "array",
+                description: "At least 2 answer options",
+                items: {
+                  type: "object",
+                  properties: {
+                    id: { type: "string" },
+                    label: { type: "string" }
+                  },
+                  required: ["id", "label"]
+                }
+              }
+            },
+            required: ["id", "prompt", "options"]
+          }
+        }
+      },
+      required: ["questions"]
+    },
+    execute: async (args) => {
+      const validated = validateAskQuestionInput(args);
+      if (!validated.ok) {
+        return {
+          content: [{ type: "text", text: validated.error }],
+          isError: true
+        };
+      }
+      const batch = {
+        batchId: randomUUID(),
+        ...validated.input
+      };
+      batches.push(batch);
+      await handlers.onAskQuestion(batch);
+      console.log(
+        `[apm] AskQuestion \u5DF2\u63D0\u4EA4 batchId=${batch.batchId} questions=${batch.questions.length}`
+      );
+      return ASK_QUESTION_WAIT_MESSAGE;
+    }
+  };
+  return {
+    tool,
+    getAskedBatches: () => [...batches],
+    hasPendingQuestions: () => batches.length > 0
+  };
+}
+
 // src/commands/connect/cursor-log.ts
 var CURSOR_LOG_SYNC_INTERVAL_MS = 2e3;
 function createThrottledCursorLogSync(cfg, ctx, onError) {
@@ -2132,6 +2365,34 @@ async function obtainAgent(ctx) {
   }
   return { agent, resumed: false };
 }
+var DEFAULT_MAIL_PROMPT_FOOTER = (taskId) => `\u8BF7\u5B8C\u6210\u4E0A\u8FF0\u4EFB\u52A1\u3002\u6267\u884C\u8FC7\u7A0B\u4E2D\u8BF7\u7528 append_mail_reply \u589E\u91CF\u66F4\u65B0\u7ED9\u53D1\u4FE1\u4EBA\u7684\u56DE\u590D\uFF08\u53EF\u5148\u7B80\u77ED\u786E\u8BA4\uFF0C\u6709\u8FDB\u5C55\u7EE7\u7EED\u8FFD\u52A0\uFF09\uFF1BAgent \u6B63\u5E38\u7ED3\u675F\u540E\u4F1A\u81EA\u52A8\u63D0\u4EA4\u5B8C\u6574\u56DE\u4FE1\u3002\u5982\u9700\u7F16\u5199\u6587\u6863\uFF0C\u4FDD\u5B58\u5230 \`.apm/tasks/${taskId}/docs/\` \u76EE\u5F55\u3002`;
+function buildPrompt(basePrompt, taskId, mode, promptFooter, hasAskQuestion) {
+  const trimmed = basePrompt.trim();
+  let footer;
+  if (promptFooter === null || promptFooter === "") {
+    footer = "";
+  } else if (promptFooter === void 0) {
+    footer = DEFAULT_MAIL_PROMPT_FOOTER(taskId);
+  } else {
+    footer = promptFooter;
+  }
+  const askQuestionHint = hasAskQuestion && mode === "plan" ? "\u9700\u8981\u7528\u6237\u786E\u8BA4\u65F6\u8BF7\u4F7F\u7528 AskQuestion \u5DE5\u5177\uFF0C\u52FF\u5728\u6B63\u6587\u4E2D\u7F57\u5217\u9009\u9879\u8BA9\u7528\u6237\u6587\u5B57\u56DE\u590D\u3002" : "";
+  const parts = [trimmed];
+  const hints = [footer, askQuestionHint].filter(Boolean);
+  if (hints.length > 0) {
+    parts.push("---", ...hints);
+  }
+  return parts.join("\n\n");
+}
+function mergeCustomTools(customTools, askQuestionTool) {
+  if (!askQuestionTool) {
+    return customTools;
+  }
+  return {
+    ...customTools,
+    AskQuestion: askQuestionTool
+  };
+}
 async function runCursorAgent(cfg, ctx, options) {
   const signal = options?.signal;
   logAbortSignalStats(signal, "runCursorAgent:start");
@@ -2143,12 +2404,24 @@ async function runCursorAgent(cfg, ctx, options) {
     throw new Error("\u7F3A\u5C11 Cursor API Key");
   }
   const workdir = requireExistingWorkdir(ctx.workdir);
-  const customTools = options?.customTools ?? {};
-  const prompt = `${ctx.prompt.trim()}
-
----
-\u8BF7\u5B8C\u6210\u4E0A\u8FF0\u4EFB\u52A1\u3002\u6267\u884C\u8FC7\u7A0B\u4E2D\u8BF7\u7528 append_mail_reply \u589E\u91CF\u66F4\u65B0\u7ED9\u53D1\u4FE1\u4EBA\u7684\u56DE\u590D\uFF08\u53EF\u5148\u7B80\u77ED\u786E\u8BA4\uFF0C\u6709\u8FDB\u5C55\u7EE7\u7EED\u8FFD\u52A0\uFF09\uFF1BAgent \u6B63\u5E38\u7ED3\u675F\u540E\u4F1A\u81EA\u52A8\u63D0\u4EA4\u5B8C\u6574\u56DE\u4FE1\u3002\u5982\u9700\u7F16\u5199\u6587\u6863\uFF0C\u4FDD\u5B58\u5230 \`.apm/tasks/${ctx.taskId}/docs/\` \u76EE\u5F55\u3002`;
+  const baseCustomTools = options?.customTools ?? {};
+  const agentContext = { agentId: "" };
+  const askQuestion = options?.onAskQuestion ? createAskQuestionTool({
+    onAskQuestion: async (batch) => {
+      await options.onAskQuestion(batch, {
+        agentId: agentContext.agentId
+      });
+    }
+  }) : void 0;
+  const customTools = mergeCustomTools(baseCustomTools, askQuestion?.tool);
   const mode = ctx.mode ?? "agent";
+  const prompt = buildPrompt(
+    ctx.prompt,
+    ctx.taskId,
+    mode,
+    options?.promptFooter,
+    Boolean(askQuestion)
+  );
   console.log(
     `[apm] Cursor Agent \u5F00\u59CB mailId=${ctx.mailId} taskId=${ctx.taskId} mode=${mode} cwd=${workdir}`
   );
@@ -2161,6 +2434,7 @@ async function runCursorAgent(cfg, ctx, options) {
     mode,
     customTools
   });
+  agentContext.agentId = agent.agentId;
   const eventSession = new EventSession(prompt);
   const syncRemoteLog = options?.skipRemoteLogSync ? noopRemoteLogSync : createThrottledCursorLogSync(
     cfg,
@@ -2219,11 +2493,14 @@ async function runCursorAgent(cfg, ctx, options) {
       throw new Error(`Cursor run \u5DF2\u53D6\u6D88: ${result.id}`);
     }
     console.log(`[apm] Cursor Agent \u5B8C\u6210 mailId=${ctx.mailId}`);
+    const askQuestionBatches = askQuestion?.getAskedBatches() ?? [];
     return {
       runId: result.id,
       agentId: agent.agentId,
       status: result.status,
       assistantText: assistantText || result.result || "",
+      askQuestionBatches,
+      hasPendingQuestions: askQuestionBatches.length > 0,
       ...createPlanContent ? { createPlanContent } : {}
     };
   } catch (err) {
@@ -2281,7 +2558,7 @@ function removeMailById(mailId) {
 }
 
 // src/commands/connect/reply-mail-tool.ts
-function createMailReplyDraft() {
+function createMailReplyDraft(input) {
   const parts = [];
   const tool = {
     description: "\u5411\u53D1\u4FE1\u4EBA\u589E\u91CF\u66F4\u65B0\u56DE\u590D\u5185\u5BB9\u3002\u53EF\u591A\u6B21\u8C03\u7528\u8FFD\u52A0\u8FDB\u5C55\uFF08\u5982\u5148\u786E\u8BA4\u6536\u5230\u3001\u518D\u6C47\u62A5\u7ED3\u679C\uFF09\uFF1BAgent \u6B63\u5E38\u7ED3\u675F\u540E\u4F1A\u81EA\u52A8\u63D0\u4EA4\u5B8C\u6574\u56DE\u4FE1\uFF0C\u65E0\u9700\u53E6\u884C\u6536\u5C3E\u3002",
@@ -2304,6 +2581,7 @@ function createMailReplyDraft() {
         };
       }
       parts.push(content);
+      await input.appendDraft(content);
       console.log(`[apm] \u589E\u91CF\u66F4\u65B0\u56DE\u4FE1\uFF08\u7B2C ${parts.length} \u6BB5\uFF09`);
       return "\u5DF2\u8FFD\u52A0\u5230\u56DE\u4FE1\u8349\u7A3F\uFF0CAgent \u7ED3\u675F\u540E\u5C06\u4E00\u5E76\u63D0\u4EA4\u3002";
     }
@@ -2508,15 +2786,17 @@ async function processMail(mail, options) {
     );
     return;
   }
-  if (detail.status !== "PENDING") {
+  if (detail.status !== "UNREAD") {
     console.log(`[apm] \u4FE1\u4EF6 id=${mail.id} \u72B6\u6001\u4E3A ${detail.status}\uFF0C\u8DF3\u8FC7\u5904\u7406`);
-    if (detail.status === "SUCCEEDED" || detail.status === "FAILED") {
+    if (detail.status === "READ") {
       markMailReplied(mail.id);
     }
     return;
   }
+  let draftReplyId;
   try {
-    await api.cli.claimMailboxMessage({ id: mail.id });
+    const claimed = await api.cli.claimMailboxMessage({ id: mail.id });
+    draftReplyId = claimed.draftReplyId;
   } catch (err) {
     console.error(
       `[apm] \u8BA4\u9886\u4FE1\u4EF6\u5931\u8D25 id=${mail.id}:`,
@@ -2529,16 +2809,43 @@ async function processMail(mail, options) {
     tool: replyTool,
     getReplyContent,
     hasReplyContent
-  } = createMailReplyDraft();
+  } = createMailReplyDraft({
+    appendDraft: async (content) => {
+      await api.cli.appendMailboxDraft({ id: draftReplyId, content });
+    }
+  });
   try {
     const cursorMode = resolveCursorAgentMode(detail.studio?.phase);
+    const mailContext = {
+      mailId: detail.id,
+      taskId: detail.taskId,
+      draftReplyId,
+      workdir: detail.workdir,
+      model: detail.recipient.model?.trim() || "default",
+      memberDisplayName: detail.recipient.displayName,
+      cursorMode
+    };
+    const submitQuestions = async (batch, ctx) => {
+      await api.cli.createCursorAgentQuestions({
+        anchorType: "mailbox",
+        anchorId: mailContext.mailId,
+        taskId: mailContext.taskId,
+        cursorAgentId: ctx.agentId,
+        draftReplyId: mailContext.draftReplyId,
+        workdir: mailContext.workdir,
+        model: mailContext.model,
+        memberDisplayName: mailContext.memberDisplayName,
+        mode: mailContext.cursorMode,
+        batch
+      });
+    };
     const result = await runCursorAgent(
       options.cfg,
       {
         mailId: detail.id,
         taskId: detail.taskId,
         prompt: detail.content,
-        model: detail.recipient.model?.trim() || "default",
+        model: mailContext.model,
         apiKey: cursorApiKey,
         workdir: detail.workdir,
         user: detail.recipient.displayName,
@@ -2546,9 +2853,16 @@ async function processMail(mail, options) {
       },
       {
         signal: options.signal,
-        customTools: { append_mail_reply: replyTool }
+        customTools: { append_mail_reply: replyTool },
+        onAskQuestion: submitQuestions
       }
     );
+    if (result.hasPendingQuestions) {
+      console.log(
+        `[apm] \u4FE1\u4EF6 id=${mail.id} \u6709\u5F85\u7B54 AskQuestion\uFF0C\u7B49\u5F85\u7528\u6237\u5728\u5DE5\u4F5C\u5BA4\u7B54\u9898\u540E\u7EED\u804A`
+      );
+      return;
+    }
     const replyContent = (hasReplyContent() ? getReplyContent() : result.assistantText).trim();
     if (!replyContent) {
       throw new Error("Agent \u672A\u4EA7\u51FA\u53EF\u63D0\u4EA4\u7684\u56DE\u4FE1\u5185\u5BB9");
@@ -2562,7 +2876,7 @@ async function processMail(mail, options) {
       });
     }
     await api.cli.completeMailboxMessage({
-      id: detail.id,
+      id: draftReplyId,
       status: "SUCCEEDED",
       replyContent
     });
@@ -2577,7 +2891,7 @@ async function processMail(mail, options) {
     console.error(`[apm] \u4FE1\u4EF6\u5904\u7406\u5931\u8D25 id=${mail.id}: ${message}`);
     try {
       await api.cli.completeMailboxMessage({
-        id: detail.id,
+        id: draftReplyId,
         status: "FAILED",
         error: message
       });
@@ -2648,6 +2962,148 @@ function createMailProcessor(options) {
   };
 }
 
+// src/commands/connect/cursor-agent-resume-handler.ts
+async function runMailboxCursorAgentResume(push, options) {
+  const cursorApiKey = options.getCursorApiKey().trim();
+  if (!cursorApiKey) {
+    options.onFatalError(
+      "[apm] \u5BA2\u6237\u673A\u672A\u914D\u7F6E Cursor API Key\uFF0C\u65E0\u6CD5\u7EED\u804A Cursor Agent"
+    );
+    return;
+  }
+  const api = createApmApiClient(options.cfg);
+  let detail;
+  try {
+    detail = await api.cli.getMailboxMessageDetail({ id: push.anchorId });
+  } catch (err) {
+    console.error(
+      `[apm] \u7EED\u804A\u83B7\u53D6\u4FE1\u4EF6\u8BE6\u60C5\u5931\u8D25 id=${push.anchorId}:`,
+      err instanceof Error ? err.message : err
+    );
+    return;
+  }
+  const {
+    tool: replyTool,
+    getReplyContent,
+    hasReplyContent
+  } = createMailReplyDraft({
+    appendDraft: async (content) => {
+      await api.cli.appendMailboxDraft({
+        id: push.draftReplyId,
+        content
+      });
+    }
+  });
+  const cursorMode = push.mode;
+  const submitQuestions = async (batch, ctx) => {
+    await api.cli.createCursorAgentQuestions({
+      anchorType: "mailbox",
+      anchorId: push.anchorId,
+      taskId: push.taskId,
+      cursorAgentId: ctx.agentId,
+      draftReplyId: push.draftReplyId,
+      workdir: push.workdir,
+      model: push.model,
+      memberDisplayName: push.memberDisplayName,
+      mode: cursorMode,
+      batch
+    });
+  };
+  try {
+    const result = await runCursorAgent(
+      options.cfg,
+      {
+        mailId: push.anchorId,
+        taskId: push.taskId,
+        prompt: push.prompt,
+        model: push.model,
+        apiKey: cursorApiKey,
+        workdir: push.workdir,
+        user: push.memberDisplayName,
+        mode: cursorMode
+      },
+      {
+        signal: options.signal,
+        customTools: { append_mail_reply: replyTool },
+        onAskQuestion: submitQuestions,
+        forceSend: true
+      }
+    );
+    if (result.hasPendingQuestions) {
+      console.log(
+        `[apm] \u7EED\u804A\u540E\u4ECD\u6709\u5F85\u7B54 AskQuestion mailId=${push.anchorId}\uFF0C\u7B49\u5F85\u7528\u6237\u7B54\u9898`
+      );
+      return;
+    }
+    const replyContent = (hasReplyContent() ? getReplyContent() : result.assistantText).trim();
+    if (!replyContent) {
+      throw new Error("Agent \u672A\u4EA7\u51FA\u53EF\u63D0\u4EA4\u7684\u56DE\u4FE1\u5185\u5BB9");
+    }
+    if (cursorMode === "plan" && result.createPlanContent) {
+      saveMemberPlanDocument({
+        workdir: push.workdir,
+        taskId: push.taskId,
+        memberDisplayName: push.memberDisplayName,
+        content: result.createPlanContent
+      });
+    }
+    await api.cli.completeMailboxMessage({
+      id: push.draftReplyId,
+      status: "SUCCEEDED",
+      replyContent
+    });
+    markMailReplied(push.anchorId);
+    await syncTaskDocuments(options.cfg, push.taskId, push.workdir, {
+      api,
+      remoteDocuments: detail.documents
+    });
+    console.log(`[apm] Cursor Agent \u7EED\u804A\u5B8C\u6210 mailId=${push.anchorId}`);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(
+      `[apm] Cursor Agent \u7EED\u804A\u5931\u8D25 mailId=${push.anchorId}: ${message}`
+    );
+    try {
+      await api.cli.completeMailboxMessage({
+        id: push.draftReplyId,
+        status: "FAILED",
+        error: message
+      });
+    } catch (completeErr) {
+      console.error(
+        `[apm] \u6807\u8BB0\u7EED\u804A\u5931\u8D25\u72B6\u6001\u65F6\u51FA\u9519 mailId=${push.anchorId}:`,
+        completeErr instanceof Error ? completeErr.message : completeErr
+      );
+    }
+    markMailReplied(push.anchorId);
+  }
+}
+function createCursorAgentResumeHandler(options) {
+  let running = false;
+  return {
+    receive(push) {
+      if (options.signal.aborted) {
+        return;
+      }
+      if (running) {
+        console.warn(
+          `[apm] \u5DF2\u6709 Cursor Agent \u7EED\u804A\u4EFB\u52A1\u8FDB\u884C\u4E2D\uFF0C\u5FFD\u7565 mailId=${push.anchorId}`
+        );
+        return;
+      }
+      running = true;
+      void runMailboxCursorAgentResume(push, options).catch((err) => {
+        console.error(
+          `[apm] Cursor Agent \u7EED\u804A\u5F02\u5E38 mailId=${push.anchorId}:`,
+          err instanceof Error ? err.message : err
+        );
+      }).finally(() => {
+        running = false;
+      });
+    }
+  };
+}
+
 // src/commands/connect/mail-sync.ts
 function parsePendingMail(value) {
   if (typeof value !== "object" || value === null) {
@@ -2740,6 +3196,15 @@ async function runConnect(options) {
         shutdown(1);
       }
     });
+    const cursorAgentResumeHandler = createCursorAgentResumeHandler({
+      cfg,
+      signal: shutdownAbort.signal,
+      getCursorApiKey: () => cursorApiKey,
+      onFatalError: (message) => {
+        console.error(message);
+        shutdown(1);
+      }
+    });
     const shutdown = (code = 0) => {
       if (shuttingDown) return;
       shuttingDown = true;
@@ -2804,6 +3269,10 @@ async function runConnect(options) {
       }
       if (validated.data.type === "received_mail") {
         mailProcessor.receive(validated.data);
+        return;
+      }
+      if (validated.data.type === "cursor_agent_resume") {
+        cursorAgentResumeHandler.receive(validated.data);
       }
     });
     ws.on("close", (code, reason) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-project-manage-cli",
-  "version": "7.0.3",
+  "version": "7.0.5",
   "description": "命令行工具：后续用于调用平台后端 API 完成运维与自动化操作",
   "type": "module",
   "private": false,