@ai-setting/roy-agent-core 1.7.51 → 1.7.52

package/dist/env/event-source/index.js

@@ -11,7 +11,7 @@ import {
   larkCliHandler,
   resolveBountyIMSystemPrompt,
   timerHandler
-} from "../../shared/@ai-setting/roy-agent-core-wwytg8rv.js";
+} from "../../shared/@ai-setting/roy-agent-core-ezgsem94.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -22,7 +22,7 @@ import {
   validateEventSourceConfig
 } from "../../shared/@ai-setting/roy-agent-core-ck60j1q9.js";
 import"../../shared/@ai-setting/roy-agent-core-rnwr39b0.js";
-import"../../shared/@ai-setting/roy-agent-core-kyasfzeh.js";
+import"../../shared/@ai-setting/roy-agent-core-pkpkctvf.js";
 import {
   EventStoreImpl,
   getSharedEventStore,
@@ -31,8 +31,8 @@ import {
 } from "../../shared/@ai-setting/roy-agent-core-yhsssn86.js";
 import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../shared/@ai-setting/roy-agent-core-gdsqp6j8.js";
-import"../../shared/@ai-setting/roy-agent-core-wxsgay02.js";
-import"../../shared/@ai-setting/roy-agent-core-zd077w51.js";
+import"../../shared/@ai-setting/roy-agent-core-brwzs8wf.js";
+import"../../shared/@ai-setting/roy-agent-core-j8e92gj8.js";
 import"../../shared/@ai-setting/roy-agent-core-9csa89jx.js";
 import"../../shared/@ai-setting/roy-agent-core-na73mym1.js";
 import"../../shared/@ai-setting/roy-agent-core-8s9jd2qy.js";

package/dist/env/index.js

@@ -1,6 +1,6 @@
 import {
   BaseEnvironment
-} from "../shared/@ai-setting/roy-agent-core-9faekt5n.js";
+} from "../shared/@ai-setting/roy-agent-core-rcfewbzr.js";
 import {
   TaskComponent
 } from "../shared/@ai-setting/roy-agent-core-39xejr39.js";
@@ -15,7 +15,7 @@ import {
   EventSourceComponent,
   builtInHandlers,
   larkCliHandler
-} from "../shared/@ai-setting/roy-agent-core-wwytg8rv.js";
+} from "../shared/@ai-setting/roy-agent-core-ezgsem94.js";
 import {
   EventSourceInitHooks,
   getDefaultConfigForType,
@@ -24,12 +24,12 @@ import {
   validateEventSourceConfig
 } from "../shared/@ai-setting/roy-agent-core-ck60j1q9.js";
 import"../shared/@ai-setting/roy-agent-core-rnwr39b0.js";
-import"../shared/@ai-setting/roy-agent-core-kyasfzeh.js";
+import"../shared/@ai-setting/roy-agent-core-pkpkctvf.js";
 import"../shared/@ai-setting/roy-agent-core-yhsssn86.js";
 import"../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../shared/@ai-setting/roy-agent-core-gdsqp6j8.js";
-import"../shared/@ai-setting/roy-agent-core-wxsgay02.js";
-import"../shared/@ai-setting/roy-agent-core-zd077w51.js";
+import"../shared/@ai-setting/roy-agent-core-brwzs8wf.js";
+import"../shared/@ai-setting/roy-agent-core-j8e92gj8.js";
 import {
   WorkflowComponent
 } from "../shared/@ai-setting/roy-agent-core-s214vmmd.js";

package/dist/env/task/plugins/index.js

@@ -10,11 +10,11 @@ import {
   formatExtractorInput,
   formatExtractorInputFromDescription,
   parseExtractorOutput
-} from "../../../shared/@ai-setting/roy-agent-core-kyasfzeh.js";
+} from "../../../shared/@ai-setting/roy-agent-core-pkpkctvf.js";
 import"../../../shared/@ai-setting/roy-agent-core-yhsssn86.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../../shared/@ai-setting/roy-agent-core-gdsqp6j8.js";
-import"../../../shared/@ai-setting/roy-agent-core-zd077w51.js";
+import"../../../shared/@ai-setting/roy-agent-core-j8e92gj8.js";
 import"../../../shared/@ai-setting/roy-agent-core-na73mym1.js";
 import"../../../shared/@ai-setting/roy-agent-core-8s9jd2qy.js";
 import"../../../shared/@ai-setting/roy-agent-core-jrj30vq3.js";

package/dist/env/workflow/plugins/index.js

@@ -1,8 +1,8 @@
 import {
   LarkCliWorkflowNotifyHook,
   createLarkCliWorkflowNotifyHook
-} from "../../../shared/@ai-setting/roy-agent-core-wxsgay02.js";
-import"../../../shared/@ai-setting/roy-agent-core-zd077w51.js";
+} from "../../../shared/@ai-setting/roy-agent-core-brwzs8wf.js";
+import"../../../shared/@ai-setting/roy-agent-core-j8e92gj8.js";
 import"../../../shared/@ai-setting/roy-agent-core-9csa89jx.js";
 import"../../../shared/@ai-setting/roy-agent-core-qcspfszy.js";
 import"../../../shared/@ai-setting/roy-agent-core-4z3rq5gw.js";

package/dist/index.js

@@ -66,7 +66,7 @@ import {
   BaseEnvironment,
   generateDescendingId,
   generateId
-} from "./shared/@ai-setting/roy-agent-core-9faekt5n.js";
+} from "./shared/@ai-setting/roy-agent-core-rcfewbzr.js";
 import {
   TaskComponent
 } from "./shared/@ai-setting/roy-agent-core-39xejr39.js";
@@ -92,7 +92,7 @@ import {
   larkCliHandler,
   resolveBountyIMSystemPrompt,
   timerHandler
-} from "./shared/@ai-setting/roy-agent-core-wwytg8rv.js";
+} from "./shared/@ai-setting/roy-agent-core-ezgsem94.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -109,7 +109,7 @@ import {
 import {
   TaskTagPlugin,
   createAutoTaskPlugin
-} from "./shared/@ai-setting/roy-agent-core-kyasfzeh.js";
+} from "./shared/@ai-setting/roy-agent-core-pkpkctvf.js";
 import {
   EventStoreImpl,
   getSharedEventStore,
@@ -123,8 +123,8 @@ import {
   getBuiltInPrompt,
   getBuiltInPromptNames
 } from "./shared/@ai-setting/roy-agent-core-gdsqp6j8.js";
-import"./shared/@ai-setting/roy-agent-core-wxsgay02.js";
-import"./shared/@ai-setting/roy-agent-core-zd077w51.js";
+import"./shared/@ai-setting/roy-agent-core-brwzs8wf.js";
+import"./shared/@ai-setting/roy-agent-core-j8e92gj8.js";
 import {
   WorkflowComponent
 } from "./shared/@ai-setting/roy-agent-core-s214vmmd.js";

package/dist/shared/@ai-setting/{roy-agent-core-wxsgay02.js → roy-agent-core-brwzs8wf.js}

@@ -1,7 +1,7 @@
 import {
   LarkCardPatchNotifier,
   formatDurationMs
-} from "./roy-agent-core-zd077w51.js";
+} from "./roy-agent-core-j8e92gj8.js";
 import {
   WorkflowHookPoints,
   init_workflow_hook_points

package/dist/shared/@ai-setting/{roy-agent-core-wwytg8rv.js → roy-agent-core-ezgsem94.js}

@@ -5,14 +5,20 @@ import {
   TaskTagPlugin,
   createLarkCliTaskNotifyHook,
   createPerTaskGroupChatPlugin,
+  extractPerTaskChatId,
+  extractPerTaskChatName,
   mergeChatOwnership
-} from "./roy-agent-core-kyasfzeh.js";
+} from "./roy-agent-core-pkpkctvf.js";
 import {
   getSharedEventStore
 } from "./roy-agent-core-yhsssn86.js";
 import {
   createLarkCliWorkflowNotifyHook
-} from "./roy-agent-core-wxsgay02.js";
+} from "./roy-agent-core-brwzs8wf.js";
+import {
+  LarkCardPatchNotifier,
+  buildTaskCard
+} from "./roy-agent-core-j8e92gj8.js";
 import {
   normalizeLarkAtMentions
 } from "./roy-agent-core-64f22h1g.js";
@@ -605,10 +611,247 @@ var bountyIMHandler = {
 };
 
 // src/env/event-source/event-source-handlers.ts
-import { spawn as spawn2 } from "child_process";
+import { spawn as spawn2, exec as execSync } from "child_process";
+import { promisify as promisify2 } from "node:util";
 init_global_hook_manager();
 init_context();
 
+// src/env/task/plugins/lark-card-action-handler.ts
+init_logger();
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+var logger = createLogger("lark-card-action-handler");
+var execAsync = promisify(exec);
+var CTX_FIELD_CHAT_ID = "larkPerTaskChatId";
+var CTX_FIELD_CHAT_NAME = "larkPerTaskChatName";
+var CTX_FIELD_CHAT_CREATED_AT = "larkPerTaskChatCreatedAt";
+var CTX_FIELD_CHAT_TASK_ID = "larkPerTaskChatTaskId";
+var CTX_FIELD_CHAT_INVITEES = "larkPerTaskChatInvitees";
+var cardActionInflight = new Map;
+async function handleCardAction(event, ports) {
+  const { action, taskId: taskIdRaw } = event.actionValue;
+  const taskId = typeof taskIdRaw === "string" ? parseInt(taskIdRaw, 10) : taskIdRaw;
+  if (!taskId || Number.isNaN(taskId)) {
+    return { ok: false, action, error: `Invalid taskId: ${taskIdRaw}` };
+  }
+  if (action !== "create_group" && action !== "disband_group") {
+    return { ok: false, action, error: `Unknown action: ${action}` };
+  }
+  const inflightKey = `${event.profile ?? "-"}:${event.messageId || String(taskId)}:${action}`;
+  const inflight = cardActionInflight.get(inflightKey);
+  if (inflight) {
+    logger.warn(`handleCardAction: ${inflightKey} 已有同操作在处理中（疑似用户重复点击），本次忽略。`);
+    return { ok: false, action, error: `重复点击：${inflightKey} 正在处理中，已忽略` };
+  }
+  const pending = handleCardActionInner(event, ports, taskId);
+  cardActionInflight.set(inflightKey, pending);
+  try {
+    return await pending;
+  } finally {
+    cardActionInflight.delete(inflightKey);
+  }
+}
+async function handleCardActionInner(event, ports, taskId) {
+  const { action } = event.actionValue;
+  if (!ports.getTask) {
+    return { ok: false, action, error: "ports.getTask not injected" };
+  }
+  const task = await ports.getTask(taskId);
+  if (!task) {
+    return { ok: false, action, error: `Task #${taskId} not found` };
+  }
+  const existingChatId = extractPerTaskChatId(task.context);
+  if (action === "create_group") {
+    return await handleCreateGroup(event, ports, task, existingChatId);
+  } else {
+    return await handleDisbandGroup(event, ports, task, existingChatId);
+  }
+}
+function buildCardAfterGroupChange(event, ports, task, perTaskChatId, perTaskChatName) {
+  const meta = buildTaskMetaFromTask(task, perTaskChatId, perTaskChatName);
+  const preserved = ports.notifier?.updateMetaAndBuildCard?.(event.messageId, meta, { clearPerTaskChat: !perTaskChatId });
+  if (preserved) {
+    logger.debug(`buildCardAfterGroupChange: 复用 notifier 累积状态（里程碑历史保留）messageId=${event.messageId}`);
+    return preserved;
+  }
+  logger.warn(`buildCardAfterGroupChange: notifier 无 messageId=${event.messageId} 的状态，` + `fallback 重建卡片（该卡片的历史里程碑可能丢失）`);
+  return buildTaskCard({
+    status: "running",
+    meta,
+    milestones: [
+      { title: "Task 创建", timestamp: new Date().toISOString(), description: task.current_status }
+    ]
+  });
+}
+async function handleCreateGroup(event, ports, task, existingChatId) {
+  if (existingChatId) {
+    const existingName = extractPerTaskChatName(task.context);
+    logger.info(`handleCreateGroup: Task #${task.id} 已有专属群 ${existingChatId}（幂等命中，不重复建群）`);
+    return {
+      ok: true,
+      action: "create_group",
+      newChatId: existingChatId,
+      cardUpdate: buildCardAfterGroupChange(event, ports, task, existingChatId, existingName)
+    };
+  }
+  if (!ports.createGroupChat) {
+    return { ok: false, action: "create_group", error: "ports.createGroupChat not injected" };
+  }
+  try {
+    const renderedName = truncateText(`Task #${task.id} - ${task.title ?? "(无标题)"}`, 60);
+    const description = truncateText(`roy-agent task #${task.id} - ${task.project_path ?? ""}`, 100);
+    const operatorOpenId = extractOperatorOpenId(event.operatorId);
+    const initialUserIds = operatorOpenId ? [operatorOpenId] : undefined;
+    const chatId = await ports.createGroupChat({
+      name: renderedName,
+      description,
+      profile: event.profile,
+      initialUserIds
+    });
+    let invitedOpenIds = [];
+    if (operatorOpenId) {
+      if (initialUserIds) {
+        invitedOpenIds = [operatorOpenId];
+        logger.debug(`handleCreateGroup: ${operatorOpenId} 已在建群时邀请（initialUserIds 路径）`);
+      } else if (ports.inviteUser) {
+        try {
+          await ports.inviteUser(chatId, operatorOpenId, event.profile);
+          invitedOpenIds = [operatorOpenId];
+          logger.debug(`handleCreateGroup: 走 inviteUser 端口邀请 ${operatorOpenId} 进 ${chatId}`);
+        } catch (err) {
+          logger.warn(`handleCreateGroup: inviteUser(${chatId}, ${operatorOpenId}) 失败（不阻断主流程）: ${err.message}`);
+        }
+      } else {
+        logger.warn(`handleCreateGroup: createGroupChat 不支持 initialUserIds 且 inviteUser 未注入，` + `${operatorOpenId} 未被拉进群 ${chatId}。` + `需升级 caller（bridge/real impl）使用 ports.inviteUser 或实现 createGroupChat.initialUserIds 参数。`);
+      }
+    }
+    const newContext = patchContext(task.context ?? "{}", {
+      [CTX_FIELD_CHAT_ID]: chatId,
+      [CTX_FIELD_CHAT_NAME]: renderedName,
+      [CTX_FIELD_CHAT_CREATED_AT]: new Date().toISOString(),
+      [CTX_FIELD_CHAT_TASK_ID]: task.id,
+      [CTX_FIELD_CHAT_INVITEES]: invitedOpenIds.length > 0 ? invitedOpenIds : undefined
+    });
+    if (ports.updateTaskContext) {
+      await ports.updateTaskContext(task.id, newContext);
+    }
+    const cardUpdate = buildCardAfterGroupChange(event, ports, task, chatId, renderedName);
+    return { ok: true, action: "create_group", newChatId: chatId, cardUpdate };
+  } catch (err) {
+    logger.error(`handleCardAction.create_group failed: ${err.message}`);
+    return { ok: false, action: "create_group", error: err.message };
+  }
+}
+function extractOperatorOpenId(raw) {
+  if (!raw)
+    return;
+  if (typeof raw === "string")
+    return raw;
+  if (typeof raw === "object" && typeof raw.open_id === "string")
+    return raw.open_id;
+  return;
+}
+async function handleDisbandGroup(event, ports, task, existingChatId) {
+  if (!existingChatId) {
+    return {
+      ok: false,
+      action: "disband_group",
+      error: `Task #${task.id} 无专属群（context.larkPerTaskChatId 空），无需解散`
+    };
+  }
+  if (!ports.deleteGroupChat) {
+    return { ok: false, action: "disband_group", error: "ports.deleteGroupChat not injected" };
+  }
+  try {
+    await ports.deleteGroupChat(existingChatId, event.profile);
+    const newContext = patchContext(task.context ?? "{}", {
+      [CTX_FIELD_CHAT_ID]: undefined,
+      [CTX_FIELD_CHAT_NAME]: undefined,
+      [CTX_FIELD_CHAT_CREATED_AT]: undefined,
+      [CTX_FIELD_CHAT_TASK_ID]: undefined
+    });
+    if (ports.updateTaskContext) {
+      await ports.updateTaskContext(task.id, newContext);
+    }
+    const cardUpdate = buildCardAfterGroupChange(event, ports, task, undefined, undefined);
+    return { ok: true, action: "disband_group", cardUpdate };
+  } catch (err) {
+    logger.error(`handleCardAction.disband_group failed: ${err.message}`);
+    return { ok: false, action: "disband_group", error: err.message };
+  }
+}
+function patchContext(contextStr, changes) {
+  let obj = {};
+  try {
+    const parsed = JSON.parse(contextStr);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      obj = parsed;
+    }
+  } catch {
+    obj = {};
+  }
+  for (const [k, v] of Object.entries(changes)) {
+    if (v === undefined) {
+      delete obj[k];
+    } else {
+      obj[k] = v;
+    }
+  }
+  return JSON.stringify(obj);
+}
+function buildTaskMetaFromTask(task, perTaskChatId, perTaskChatName) {
+  return {
+    id: task.id,
+    title: task.title,
+    description: task.description,
+    goals: task.goals,
+    parentTaskId: typeof task.parent_task_id === "number" && task.parent_task_id > 0 ? task.parent_task_id : undefined,
+    priority: task.priority,
+    type: task.type,
+    projectPath: task.project_path,
+    context: task.context,
+    currentStatus: task.current_status,
+    perTaskChatId,
+    perTaskChatName
+  };
+}
+async function deleteGroupChatViaLarkCli(chatId, profile) {
+  const profileFlag = profile ? `--profile ${profile} ` : "";
+  try {
+    const { stdout: authStdout } = await execAsync(`lark-cli ${profileFlag}auth status --json`, { timeout: 15000 });
+    const appId = JSON.parse(authStdout).appId;
+    if (!appId) {
+      throw new Error(`lark-cli auth status 未返回 appId: ${authStdout.slice(0, 200)}`);
+    }
+    const cmd = `lark-cli ${profileFlag}api DELETE /open-apis/im/v1/chats/${chatId}/members ` + `--params '{"member_id_type":"app_id"}' ` + `--data ${shellQuote(JSON.stringify({ id_list: [appId] }))} ` + `--as bot`;
+    const { stdout, stderr } = await execAsync(cmd, { timeout: 30000 });
+    logger.debug(`deleteGroupChatViaLarkCli(${chatId}) bot 退群 ok: ` + `stdout=${stdout?.slice(0, 300)} stderr=${stderr?.slice(0, 300)}`);
+  } catch (err) {
+    logger.warn(`deleteGroupChatViaLarkCli(${chatId}) bot 退群失败（task.context 仍会清掉，` + `飞书侧群会保留）：${err.message}`);
+  }
+}
+function shellQuote(s) {
+  return `'${s.replace(/'/g, `'\\''`)}'`;
+}
+function truncateText(text, maxLen) {
+  if (!text)
+    return "";
+  if (text.length <= maxLen)
+    return text;
+  return text.substring(0, Math.max(0, maxLen - 3)) + "...";
+}
+async function createGroupChatViaLarkCli(opts) {
+  const profileFlag = opts.profile ? `--profile ${opts.profile} ` : "";
+  const usersFlag = opts.initialUserIds && opts.initialUserIds.length > 0 ? `--users ${shellQuote(opts.initialUserIds.join(","))} ` : "";
+  const cmd = `lark-cli ${profileFlag}im +chat-create --name ${shellQuote(truncateText(opts.name, 60))} ` + usersFlag + `--description ${shellQuote(truncateText(opts.description, 100))} --as bot`;
+  const { stdout } = await execAsync(cmd, { timeout: 60000 });
+  const m = stdout.match(/"chat_id"\s*:\s*"(oc_[a-f0-9]+)"/);
+  if (!m) {
+    throw new Error(`lark-cli +chat-create 返回无法解析: ${stdout.slice(0, 300)}`);
+  }
+  return m[1];
+}
+
 // src/env/event-source/bounty-cli-handler.ts
 import { spawn } from "child_process";
 function readBountyCliConfig(config) {
@@ -843,7 +1086,14 @@ var bountyCliHandler = {
 
 // src/env/event-source/event-source-handlers.ts
 init_logger();
-var logger = createLogger("lark-cli:event-source");
+var execAsync2 = promisify2(execSync);
+var logger2 = createLogger("lark-cli:event-source");
+var CHILD_READY_TIMEOUT_MS = 5000;
+var GRACEFUL_STOP_TIMEOUT_MS = 5000;
+var CARD_ACTION_EVENT_TYPE = "card.action.trigger";
+function isChildAlive(child) {
+  return child.exitCode === null && child.signalCode === null;
+}
 function isPluginDebugEnabled() {
   return process.env.ROY_TASK_NOTIFY_DEBUG === "1" || process.env.ROY_TRACE_DEBUG === "1";
 }
@@ -1065,12 +1315,23 @@ function extractMetadata(rawEvent, eventType) {
 class LarkCliInstance {
   config;
   status = "created";
-  child;
+  children = [];
   buffer = "";
+  starting = false;
   eventHandler;
   cardRoutingPorts;
   chatNameCache = new Map;
   pluginInstances = new Map;
+  cardActionPorts;
+  setCardActionPorts(ports) {
+    this.cardActionPorts = ports;
+    if (typeof logger2 !== "undefined" && logger2?.debug) {
+      logger2.debug(`[LarkCliInstance] CardActionPorts injected: ` + `getTask=${typeof ports.getTask}, updateTaskContext=${typeof ports.updateTaskContext}, ` + `createGroupChat=${typeof ports.createGroupChat}, deleteGroupChat=${typeof ports.deleteGroupChat}, ` + `notifier=${typeof ports.notifier}`);
+    }
+  }
+  hasCardActionPorts() {
+    return this.cardActionPorts !== undefined;
+  }
   static SHARED_SEEN = new Map;
   static SHARED_MSG_TTL_MS = 10 * 60 * 1000;
   static SHARED_MSG_MAX = 1000;
@@ -1091,74 +1352,195 @@ class LarkCliInstance {
   async start() {
     if (this.status === "running")
       return;
-    await this.loadPlugins();
-    const profile = this.config.profile;
-    const profileFlag = profile ? `--profile ${profile} ` : "";
-    let command;
-    if (this.config.command) {
-      command = this.config.command.replace(/^(lark-cli)(\s+|$)/, (_, head, tail) => `${head} ${profileFlag.trim()}${tail}`);
-    } else {
-      command = `lark-cli ${profileFlag}event consume im.message.receive_v1 --as bot`;
+    if (this.starting) {
+      logger2.warn(`[LarkCliInstance] start() 已在执行中，忽略重复调用`);
+      return;
+    }
+    this.starting = true;
+    try {
+      await this.loadPlugins();
+      this.wireCardRoutingGroupProvider();
+      this.wireCardActionPorts();
+      const commands = this.buildConsumeCommands();
+      this.warnOnCardActionConfigTraps(commands);
+      this.warnOnConsumeConflict(commands);
+      this.status = "starting";
+      const readyTrackers = [];
+      for (const command of commands) {
+        const child = this.spawnConsumeChild(command);
+        this.children.push(child);
+        readyTrackers.push(this.wireChildStreams(child, command));
+      }
+      await Promise.all(readyTrackers);
+      if (this.status !== "error") {
+        this.status = "running";
+      }
+    } finally {
+      this.starting = false;
+    }
+  }
+  warnOnCardActionConfigTraps(commands) {
+    const consumesCardAction = commands.some((c) => c.includes(CARD_ACTION_EVENT_TYPE));
+    if (!consumesCardAction)
+      return;
+    if (this.config.eventTypes?.length && !matchEventType(CARD_ACTION_EVENT_TYPE, this.config.eventTypes)) {
+      logger2.warn(`[LarkCliInstance] eventKeys 含 ${CARD_ACTION_EVENT_TYPE}，但 eventTypes=` + `${JSON.stringify(this.config.eventTypes)} 不含它 → 卡片点击会被**静默丢弃**。` + `请把 ${CARD_ACTION_EVENT_TYPE} 加进 eventTypes，或清空 eventTypes。`);
     }
-    this.child = spawn2("exec " + command, [], {
+    logger2.info(`[LarkCliInstance] 已监听 ${CARD_ACTION_EVENT_TYPE}。` + `⚠️ 若点击卡片无反应，先确认飞书开发者后台「事件与回调 → 回调配置」已开启该事件。`);
+  }
+  spawnConsumeChild(command) {
+    return spawn2("exec " + command, [], {
       shell: true,
       stdio: ["pipe", "pipe", "pipe"],
       windowsHide: true
     });
-    let stdoutBuffer = "";
-    let stderrBuffer = "";
-    this.child.stdout?.on("data", (data) => {
-      const str = data.toString();
-      stdoutBuffer += str;
-      this.processStream(stdoutBuffer);
-      stdoutBuffer = "";
+  }
+  resolveConsumeEventKeys() {
+    const explicit = this.config.eventKeys;
+    if (Array.isArray(explicit) && explicit.length > 0) {
+      return explicit.filter((k) => typeof k === "string").map((k) => k.trim()).filter((k) => k.length > 0);
+    }
+    return [];
+  }
+  buildConsumeCommands() {
+    const profile = this.config.profile;
+    const profileFlag = profile ? `--profile ${profile} ` : "";
+    const keys = this.resolveConsumeEventKeys();
+    if (keys.length > 0) {
+      return keys.map((k) => `lark-cli ${profileFlag}event consume ${k} --as bot`);
+    }
+    if (this.config.command) {
+      return [
+        this.config.command.replace(/^(lark-cli)(\s+|$)/, (_, head, tail) => `${head} ${profileFlag.trim()}${tail}`)
+      ];
+    }
+    return [`lark-cli ${profileFlag}event consume im.message.receive_v1 --as bot`];
+  }
+  async warnOnConsumeConflict(commands) {
+    const keys = commands.map((c) => c.match(/event consume\s+(\S+)/)?.[1]).filter((k) => !!k);
+    if (keys.length === 0)
+      return;
+    const busy = await this.probeBusyEventKeys();
+    if (busy.size === 0)
+      return;
+    const conflicts = keys.filter((k) => busy.has(k));
+    if (conflicts.length > 0) {
+      const profile = this.config.profile;
+      logger2.warn(`[LarkCliInstance] eventKey 已被其它 consumer 占用（lark-cli 一个 key 只允许一个 consumer）：` + `${conflicts.join(", ")}。本 event-source 启动后可能 exit 2。` + `用 \`lark-cli${profile ? ` --profile ${profile}` : ""} event status\` 查看，必要时 \`event stop\`。`);
+    }
+  }
+  async probeBusyEventKeys() {
+    const profile = this.config.profile;
+    const profileFlag = profile ? `--profile ${profile} ` : "";
+    try {
+      const { stdout } = await execAsync2(`lark-cli ${profileFlag}event status --json`, {
+        timeout: 5000
+      });
+      const parsed = JSON.parse(stdout);
+      const busy = new Set;
+      for (const app of parsed.apps ?? []) {
+        for (const c of app.consumers ?? []) {
+          if (c.event_key)
+            busy.add(c.event_key);
+        }
+      }
+      return busy;
+    } catch {
+      return new Set;
+    }
+  }
+  wireChildStreams(child, command) {
+    const stdoutBuffer = { value: "" };
+    const stderrBuffer = { value: "" };
+    let settled = false;
+    let resolveReady;
+    const ready = new Promise((res) => {
+      resolveReady = res;
     });
-    this.child.stderr?.on("data", (data) => {
+    const settle = () => {
+      if (settled)
+        return;
+      settled = true;
+      resolveReady();
+    };
+    child.stdout?.on("data", (data) => {
+      this.processStreamWith(data.toString(), stdoutBuffer);
+    });
+    child.stderr?.on("data", (data) => {
       const output = data.toString();
-      if (!output.startsWith("[event]") && output.startsWith("{")) {
-        stderrBuffer += output;
-        this.processStream(stderrBuffer);
-        stderrBuffer = "";
-      }
+      if (output.includes("[event] ready"))
+        settle();
       if (output.includes('"ok": false')) {
         this.status = "error";
       }
+      this.processStreamWith(output, stderrBuffer, { jsonLinesOnly: true });
     });
-    this.child.on("exit", (code) => {
+    const handleExit = (code, source) => {
       if (code !== 0 && code !== null) {
+        logger2.warn(`[LarkCliInstance] consume 子进程异常退出 code=${code} (${source}) cmd="${command}"`);
         this.status = "error";
       } else {
-        this.status = "stopped";
+        logger2.info(`[LarkCliInstance] consume 子进程已退出 code=${code} (${source}) cmd="${command}"`);
       }
-    });
-    this.child.on("error", (error) => {
-      console.error(`[LarkCliInstance] Process error: ${error.message}`);
+      settle();
+      queueMicrotask(() => {
+        if (this.children.length > 0 && this.children.every((c) => !isChildAlive(c))) {
+          if (this.status !== "error") {
+            logger2.warn(`[LarkCliInstance] 所有 consume 子进程都已退出，状态从 running 改为 stopped`);
+            this.status = "stopped";
+          }
+        }
+      });
+    };
+    child.on("exit", (code) => handleExit(code, "exit"));
+    child.on("close", (code) => handleExit(code, "close"));
+    child.on("error", (error) => {
+      logger2.error(`[LarkCliInstance] consume 子进程 error: ${error.message}`);
       this.status = "error";
+      settle();
     });
-    await new Promise((resolve) => setTimeout(resolve, 1000));
-    this.status = "running";
+    const timer = setTimeout(() => {
+      logger2.warn(`[LarkCliInstance] consume 子进程 ${CHILD_READY_TIMEOUT_MS}ms 内未见 ready marker: cmd="${command}"`);
+      settle();
+    }, CHILD_READY_TIMEOUT_MS);
+    ready.then(() => clearTimeout(timer));
+    return ready;
   }
   async stop() {
     if (this.status === "stopped" || this.status === "created")
       return;
     this.unloadPlugins();
-    if (this.child && this.child.pid) {
+    const children = this.children;
+    this.children = [];
+    if (children.length === 0) {
+      this.buffer = "";
+      this.status = "stopped";
+      return;
+    }
+    for (const child of children) {
+      if (!child || !child.pid)
+        continue;
       try {
-        this.child.kill("SIGTERM");
-        await new Promise((resolve) => {
-          setTimeout(resolve, 5000);
-        });
-        if (!this.child?.killed) {
-          this.child.kill("SIGKILL");
-        }
+        child.kill("SIGTERM");
       } catch (error) {
-        console.error(`[LarkCliInstance] Error stopping process: ${error}`);
+        logger2.warn(`[LarkCliInstance] Error sending SIGTERM to ${child.pid}: ${error}`);
+      }
+    }
+    const allExited = Promise.all(children.map((child) => new Promise((resolve) => {
+      if (isChildAlive(child) === false)
+        return resolve();
+      child.once("exit", () => resolve());
+      child.once("error", () => resolve());
+    })));
+    const timeout = new Promise((resolve) => setTimeout(resolve, GRACEFUL_STOP_TIMEOUT_MS));
+    await Promise.race([allExited, timeout]);
+    for (const child of children) {
+      if (isChildAlive(child)) {
         try {
-          this.child?.kill("SIGKILL");
+          child.kill("SIGKILL");
         } catch {}
       }
     }
-    this.child = undefined;
     this.buffer = "";
     this.status = "stopped";
   }
@@ -1193,7 +1575,44 @@ class LarkCliInstance {
         console.error(`[LarkCliInstance] Failed to import plugin "${pluginName}". ` + `plugin name=${pluginName} 不在 BUILT_IN_PLUGIN_FACTORIES 注册表里`);
       }
     }
-    this.wireCardRoutingGroupProvider();
+  }
+  wireCardActionPorts() {
+    if (this.cardActionPorts) {
+      logger2.debug("[LarkCliInstance] cardActionPorts 已由外部注入，跳过默认 cross-wire");
+      return;
+    }
+    const taskComponent = this.environment?.getComponent?.("task");
+    if (!taskComponent?.getTask || !taskComponent?.updateTask) {
+      logger2.debug(`[LarkCliInstance] card.action.trigger 端口未注入：taskComponent 不可用` + `（getTask=${typeof taskComponent?.getTask}, updateTask=${typeof taskComponent?.updateTask}）。` + `卡片按钮点击会被跳过。`);
+      return;
+    }
+    const sharedNotifier = this.pluginInstances.get("LarkCliTaskNotifyPlugin")?.cardNotifier ?? this.pluginInstances.get("PerTaskGroupChatPlugin")?.cardNotifier;
+    this.setCardActionPorts({
+      getTask: async (id) => {
+        const t = await taskComponent.getTask(id);
+        if (!t)
+          return;
+        return {
+          id: t.id,
+          title: t.title,
+          description: t.description,
+          goals: t.goals_and_expected_deliverables ?? t.goals,
+          priority: t.priority,
+          type: t.type,
+          project_path: t.project_path,
+          parent_task_id: t.parent_task_id ?? null,
+          current_status: t.current_status,
+          context: t.context
+        };
+      },
+      updateTaskContext: async (taskId, context) => {
+        await taskComponent.updateTask(taskId, { context });
+      },
+      createGroupChat: (opts) => createGroupChatViaLarkCli(opts),
+      deleteGroupChat: (chatId, profile) => deleteGroupChatViaLarkCli(chatId, profile),
+      notifier: sharedNotifier ?? new LarkCardPatchNotifier
+    });
+    logger2.info(`[LarkCliInstance] card.action.trigger 端口已注入` + `（notifier ${sharedNotifier ? "复用插件共享实例" : "新建实例"}）`);
   }
   wireCardRoutingGroupProvider() {
     const notifyHook = this.pluginInstances.get("LarkCliTaskNotifyPlugin");
@@ -1455,7 +1874,7 @@ class LarkCliInstance {
       }
       return null;
     } catch (err) {
-      logger.warn(`[LarkCliInstance] resolveChatTaskBinding failed for chatId=${chatId}: ${err}. ` + `群消息将不会注入 parentTaskId。`);
+      logger2.warn(`[LarkCliInstance] resolveChatTaskBinding failed for chatId=${chatId}: ${err}. ` + `群消息将不会注入 parentTaskId。`);
       return null;
     }
   }
@@ -1472,6 +1891,22 @@ class LarkCliInstance {
     const lines = this.buffer.split(`
 `);
     this.buffer = lines.pop() || "";
+    this.dispatchLines(lines);
+  }
+  processStreamWith(data, buffer, opts = {}) {
+    buffer.value += data;
+    if (buffer.value.length > 2 * 1024 * 1024) {
+      logger2.warn(`[LarkCliInstance] stream 行缓冲超过 2MB 仍无换行，丢弃（疑似非 NDJSON 输出）`);
+      buffer.value = "";
+      return;
+    }
+    const lines = buffer.value.split(`
+`);
+    buffer.value = lines.pop() || "";
+    const selected = opts.jsonLinesOnly ? lines.filter((l) => l.trimStart().startsWith("{")) : lines;
+    this.dispatchLines(selected);
+  }
+  dispatchLines(lines) {
     for (const line of lines) {
       if (line.trim()) {
         this.handleEvent(line);
@@ -1491,12 +1926,12 @@ class LarkCliInstance {
       const now = Date.now();
       const lastShared = LarkCliInstance.SHARED_SEEN.get(dedupKey);
       if (lastShared !== undefined && now - lastShared < LarkCliInstance.SHARED_MSG_TTL_MS) {
-        logger.warn(`[LarkCliInstance] duplicate lark-cli event suppressed across instances (event_id=${dedupKey}, ` + `lastSeen=${now - lastShared}ms ago). ` + `Task #4137: SHARED_SEEN 跨实例去重。`);
+        logger2.warn(`[LarkCliInstance] duplicate lark-cli event suppressed across instances (event_id=${dedupKey}, ` + `lastSeen=${now - lastShared}ms ago). ` + `Task #4137: SHARED_SEEN 跨实例去重。`);
         return;
       }
       const last = this.recentEventIds.get(dedupKey);
       if (last !== undefined && now - last < this.DEDUP_WINDOW_MS) {
-        logger.warn(`[LarkCliInstance] duplicate lark-cli event suppressed (event_id=${dedupKey}, ` + `lastSeen=${now - last}ms ago). ` + `Task #3977/3978: 防止同一飞书事件触发两次任务创建。`);
+        logger2.warn(`[LarkCliInstance] duplicate lark-cli event suppressed (event_id=${dedupKey}, ` + `lastSeen=${now - last}ms ago). ` + `Task #3977/3978: 防止同一飞书事件触发两次任务创建。`);
         return;
       }
       LarkCliInstance.SHARED_SEEN.set(dedupKey, now);
@@ -1549,6 +1984,7 @@ class LarkCliInstance {
       } else {
         eventType = "unknown";
       }
+      const isCardAction = eventType === CARD_ACTION_EVENT_TYPE;
       if (this.config.eventTypes?.length && !matchEventType(eventType, this.config.eventTypes)) {
         return;
       }
@@ -1558,10 +1994,10 @@ class LarkCliInstance {
         eventSourceId: this.config.id
       };
       const { metadata, replyChannel, recommendedAction } = extractMetadata(enrichedEvent, eventType);
-      const parentTaskId = await this.resolveChatTaskBinding(metadata?.chatId);
+      const parentTaskId = isCardAction ? null : await this.resolveChatTaskBinding(metadata?.chatId);
       const userId = this.extractUserId(rawEvent);
       let triggerEventId;
-      const sharedStore = getSharedEventStore();
+      const sharedStore = isCardAction ? undefined : getSharedEventStore();
       if (sharedStore && larkCliHandler.emitTriggerEvent) {
         try {
           triggerEventId = await larkCliHandler.emitTriggerEvent({
@@ -1650,6 +2086,10 @@ class LarkCliInstance {
         parentTaskId: normalizeParentTaskId(parentTaskId)
       });
       runWithEnvContext(envContext, () => {
+        if (eventType === CARD_ACTION_EVENT_TYPE) {
+          this.handleCardActionEvent(rawEvent, envReplyChannel?.profile);
+          return;
+        }
         this.eventHandler?.(evt);
       });
     } catch (error) {
@@ -1659,6 +2099,44 @@ class LarkCliInstance {
       rootSpan.end();
     }
   }
+  async handleCardActionEvent(rawEvent, profile) {
+    try {
+      const event = rawEvent;
+      const actionValueStr = event.action_value || "{}";
+      const actionValue = JSON.parse(actionValueStr);
+      const token = event.token || "";
+      const messageId = event.message_id || "";
+      const chatId = event.chat_id || "";
+      const operatorId = event.operator_id?.open_id ?? event.operator_id ?? undefined;
+      if (!token || !messageId || !chatId) {
+        logger2.warn(`[LarkCliInstance] handleCardActionEvent: missing token/messageId/chatId, skip`);
+        return;
+      }
+      if (!this.cardActionPorts) {
+        logger2.warn(`[LarkCliInstance] handleCardActionEvent: cardActionPorts 未注入，` + `card.action.trigger 事件被跳过。` + `调 instance.setCardActionPorts({getTask, updateTaskContext, createGroupChat, deleteGroupChat, notifier}) 注入。`);
+        return;
+      }
+      const result = await handleCardAction({
+        actionValue,
+        chatId,
+        messageId,
+        token,
+        operatorId,
+        profile
+      }, this.cardActionPorts);
+      if (result.ok && result.cardUpdate) {
+        const patch = this.cardActionPorts.patchByToken ?? patchCardByLarkCli;
+        await patch(token, result.cardUpdate, profile);
+      } else {
+        logger2.warn(`[LarkCliInstance] handleCardActionEvent failed: ${result.error ?? "unknown"}`);
+      }
+    } catch (err) {
+      logger2.error(`[LarkCliInstance] handleCardActionEvent error: ${err.message}`);
+    }
+  }
+  async patchCardByToken(token, card, profile) {
+    return patchCardByLarkCli(token, card, profile);
+  }
   extractUserId(rawEvent) {
     const event = rawEvent;
     const innerEvent = event.event;
@@ -1824,7 +2302,7 @@ var larkCliHandler = {
   },
   async emitTriggerEvent(payload, store) {
     const eventId = await store.insertTriggerEvent(payload, "lark-cli");
-    logger.info(`[larkCliHandler] emitTriggerEvent: id=${eventId}`, {
+    logger2.info(`[larkCliHandler] emitTriggerEvent: id=${eventId}`, {
       chatId: payload.metadata?.chatId,
       senderId: payload.senderId
     });
@@ -1839,7 +2317,7 @@ var larkCliHandler = {
     try {
       const result = await runner.run(command);
       if (result.code !== 0) {
-        logger.error(`[larkCliHandler] replyMessage non-zero exit`, {
+        logger2.error(`[larkCliHandler] replyMessage non-zero exit`, {
           code: result.code,
           stderr: result.stderr
         });
@@ -1853,7 +2331,7 @@ var larkCliHandler = {
       return { success: true, messageId: replyMessageId };
     } catch (err) {
       const errMsg = err instanceof Error ? err.message : String(err);
-      logger.error(`[larkCliHandler] replyMessage spawn error`, { error: errMsg });
+      logger2.error(`[larkCliHandler] replyMessage spawn error`, { error: errMsg });
       return { success: false, error: errMsg };
     }
   },
@@ -1935,6 +2413,16 @@ function getLarkCliRunner() {
 function setLarkCliRunner(runner) {
   _larkCliRunner = runner;
 }
+async function patchCardByLarkCli(token, card, profile) {
+  const profileFlag = profile ? `--profile ${profile} ` : "";
+  const cmd = `lark-cli ${profileFlag}api POST /open-apis/interactive/v1/card/update ` + `--data '${JSON.stringify({ token, card }).replace(/'/g, "'\\''")}' --as bot`;
+  try {
+    const { stdout } = await execAsync2(cmd, { timeout: 30000 });
+    logger2.debug(`patchCardByLarkCli ok: ${stdout?.slice(0, 200)}`);
+  } catch (err) {
+    logger2.error(`patchCardByLarkCli failed: ${err.message}`);
+  }
+}
 var builtInHandlers = [
   larkCliHandler,
   timerHandler,
@@ -1969,7 +2457,7 @@ var EVENT_SOURCE_CONFIG_REGISTRATION = {
 };
 
 // src/env/event-source/event-source-component.ts
-var logger2 = createLogger("event-source");
+var logger3 = createLogger("event-source");
 
 class EventSourceComponent extends BaseComponent {
   name = "event-source";
@@ -2036,7 +2524,7 @@ class EventSourceComponent extends BaseComponent {
     for (const handler of builtInHandlers) {
       if (!this.handlers.has(handler.type)) {
         this.handlers.set(handler.type, handler);
-        logger2.debug(`Registered built-in handler: ${handler.type}`);
+        logger3.debug(`Registered built-in handler: ${handler.type}`);
       }
     }
   }
@@ -2046,15 +2534,15 @@ class EventSourceComponent extends BaseComponent {
   }
   registerHandler(handler) {
     if (this.handlers.has(handler.type)) {
-      logger2.warn(`Handler already registered for type: ${handler.type}, overwriting`);
+      logger3.warn(`Handler already registered for type: ${handler.type}, overwriting`);
     }
     this.handlers.set(handler.type, handler);
-    logger2.debug(`Handler registered: ${handler.type}`);
+    logger3.debug(`Handler registered: ${handler.type}`);
   }
   unregisterHandler(type) {
     const deleted = this.handlers.delete(type);
     if (deleted) {
-      logger2.debug(`Handler unregistered: ${type}`);
+      logger3.debug(`Handler unregistered: ${type}`);
     }
     return deleted;
   }
@@ -2144,7 +2632,7 @@ class EventSourceComponent extends BaseComponent {
     });
   }
   onConfigChange(event) {
-    logger2.info(`EventSource config changed: ${event.key}`, {
+    logger3.info(`EventSource config changed: ${event.key}`, {
       oldValue: event.oldValue,
       newValue: event.newValue
     });
@@ -2163,9 +2651,9 @@ class EventSourceComponent extends BaseComponent {
     }
     this.sources.set(config.id, config);
     this.statuses.set(config.id, "created");
-    logger2.debug(`EventSource registered: ${config.id} (${config.type})`);
+    logger3.debug(`EventSource registered: ${config.id} (${config.type})`);
     this.saveConfig().catch((err) => {
-      logger2.error(`Failed to save config after registering ${config.id}:`, err);
+      logger3.error(`Failed to save config after registering ${config.id}:`, err);
     });
   }
   unregister(id) {
@@ -2180,9 +2668,9 @@ class EventSourceComponent extends BaseComponent {
     this.eventHandlers.delete(id);
     this.buffers.delete(id);
     if (existed) {
-      logger2.debug(`EventSource unregistered: ${id}`);
+      logger3.debug(`EventSource unregistered: ${id}`);
       this.saveConfig().catch((err) => {
-        logger2.error(`Failed to save config after unregistering ${id}:`, err);
+        logger3.error(`Failed to save config after unregistering ${id}:`, err);
       });
     }
     return existed;
@@ -2220,13 +2708,13 @@ class EventSourceComponent extends BaseComponent {
       }
     }
     this.sources.set(id, updated);
-    logger2.info(`EventSource updated: ${id}`, {
+    logger3.info(`EventSource updated: ${id}`, {
       fields: Object.keys(partial)
     });
     try {
       await this.saveConfig();
     } catch (err) {
-      logger2.error(`Failed to save config after updating ${id}:`, err);
+      logger3.error(`Failed to save config after updating ${id}:`, err);
       throw err;
     }
     return {
@@ -2295,18 +2783,18 @@ class EventSourceComponent extends BaseComponent {
         type: "event-source.started",
         payload: { sourceId: id, sourceType: config.type }
       });
-      logger2.info(`EventSource started: ${id} (${config.type})`);
+      logger3.info(`EventSource started: ${id} (${config.type})`);
     } catch (error) {
       this.statuses.set(id, "error");
-      logger2.error(`EventSource failed to start: ${id}`, error);
+      logger3.error(`EventSource failed to start: ${id}`, error);
       throw error;
     }
   }
   async stopSource(id) {
     const status = this.statuses.get(id);
-    logger2.info(`[EventSource ${id}] stopSource called, current status: ${status}`);
+    logger3.info(`[EventSource ${id}] stopSource called, current status: ${status}`);
     if (status === "stopped" || status === "created") {
-      logger2.info(`[EventSource ${id}] already stopped/created, skipping`);
+      logger3.info(`[EventSource ${id}] already stopped/created, skipping`);
       return;
     }
     this.statuses.set(id, "stopping");
@@ -2322,10 +2810,10 @@ class EventSourceComponent extends BaseComponent {
         type: "event-source.stopped",
         payload: { sourceId: id, sourceType: config?.type }
       });
-      logger2.info(`EventSource stopped: ${id}`);
+      logger3.info(`EventSource stopped: ${id}`);
     } catch (error) {
       this.statuses.set(id, "error");
-      logger2.error(`EventSource failed to stop: ${id}`, error);
+      logger3.error(`EventSource failed to stop: ${id}`, error);
       throw error;
     }
   }
@@ -2350,9 +2838,9 @@ class EventSourceComponent extends BaseComponent {
         sources: Array.from(this.sources.values())
       };
       writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
-      logger2.debug(`Saved ${this.sources.size} event source configurations`);
+      logger3.debug(`Saved ${this.sources.size} event source configurations`);
     } catch (error) {
-      logger2.error("Failed to save event source configurations:", error);
+      logger3.error("Failed to save event source configurations:", error);
       throw error;
     }
   }
@@ -2362,13 +2850,13 @@ class EventSourceComponent extends BaseComponent {
     try {
       const configPath = this.getConfigFilePath();
       if (!existsSync(configPath)) {
-        logger2.debug(`No event source config file found at ${configPath}`);
+        logger3.debug(`No event source config file found at ${configPath}`);
         return;
       }
       const content = readFileSync(configPath, "utf-8");
       const config = JSON.parse(content);
       if (!config.sources || !Array.isArray(config.sources)) {
-        logger2.warn("Invalid event source config format, skipping load");
+        logger3.warn("Invalid event source config format, skipping load");
         return;
       }
       let loadedCount = 0;
@@ -2379,9 +2867,9 @@ class EventSourceComponent extends BaseComponent {
           loadedCount++;
         }
       }
-      logger2.info(`Loaded ${loadedCount} event source configurations`);
+      logger3.info(`Loaded ${loadedCount} event source configurations`);
     } catch (error) {
-      logger2.error("Failed to load event source configurations:", error);
+      logger3.error("Failed to load event source configurations:", error);
     }
   }
 }

package/dist/shared/@ai-setting/{roy-agent-core-zd077w51.js → roy-agent-core-j8e92gj8.js}

@@ -229,6 +229,29 @@ function buildTaskCard(opts) {
   const updateCount = opts.updateCount ?? 0;
   const spinner = opts.spinner ?? "";
   const elements = [];
+  const hasGroup = !!(opts.meta.perTaskChatId && opts.meta.perTaskChatId.length > 0);
+  const taskIdForButton = opts.meta.id !== undefined ? String(opts.meta.id) : "";
+  elements.push({
+    tag: "button",
+    text: {
+      tag: "plain_text",
+      content: hasGroup ? "解散该群" : "为这个任务建群"
+    },
+    type: hasGroup ? "danger" : "primary",
+    value: {
+      action: hasGroup ? "disband_group" : "create_group",
+      taskId: taskIdForButton
+    }
+  });
+  if (hasGroup) {
+    const link = buildChatAppLink(opts.meta.perTaskChatId);
+    const label = opts.meta.perTaskChatName ? `\uD83D\uDCE8 进入专属群：${sanitizeInlineText(opts.meta.perTaskChatName, 60)}` : "\uD83D\uDCE8 进入专属群";
+    elements.push({
+      tag: "markdown",
+      content: `[${label}](${link})`
+    });
+    elements.push({ tag: "hr" });
+  }
   const infoLines = renderTaskInfoLines(opts.meta);
   if (infoLines.length > 0) {
     elements.push({ tag: "markdown", content: infoLines.join(`
@@ -595,6 +618,25 @@ class LarkCardPatchNotifier {
     this.states.delete(opts.messageId);
     this.mutexes.delete(opts.messageId);
   }
+  updateMetaAndBuildCard(messageId, meta, opts = {}) {
+    const state = this.states.get(messageId);
+    if (!state)
+      return;
+    state.meta = mergeTaskMeta(state.meta, meta);
+    if (opts.clearPerTaskChat) {
+      delete state.meta.perTaskChatId;
+      delete state.meta.perTaskChatName;
+    }
+    return buildTaskCard({
+      status: "running",
+      meta: state.meta,
+      milestones: state.milestones,
+      processSteps: state.processSteps,
+      progress: state.progress,
+      updateCount: state.updateCount,
+      spinner: SPINNER_EMOJIS[state.spinnerIndex] ?? SPINNER_EMOJIS[0]
+    });
+  }
   trackedCardCount() {
     return this.states.size;
   }
@@ -1034,4 +1076,4 @@ function sanitize(text) {
   return `${trimmed.slice(0, 500)}…`;
 }
 
-export { humanizeValue, formatDurationMs, LarkCardPatchNotifier };
+export { humanizeValue, buildTaskCard, formatDurationMs, LarkCardPatchNotifier };

package/dist/shared/@ai-setting/{roy-agent-core-kyasfzeh.js → roy-agent-core-pkpkctvf.js}

@@ -10,7 +10,7 @@ import {
 import {
   LarkCardPatchNotifier,
   humanizeValue
-} from "./roy-agent-core-zd077w51.js";
+} from "./roy-agent-core-j8e92gj8.js";
 import {
   validateWorkflowDefinition
 } from "./roy-agent-core-na73mym1.js";
@@ -393,6 +393,17 @@ function extractPerTaskChatId(contextStr) {
     return;
   }
 }
+function extractPerTaskChatName(contextStr) {
+  if (!contextStr)
+    return;
+  try {
+    const obj = JSON.parse(contextStr);
+    const v = obj?.["larkPerTaskChatName"];
+    return typeof v === "string" && v.length > 0 ? v : undefined;
+  } catch {
+    return;
+  }
+}
 function extractPerTaskChatProfile(contextStr) {
   if (!contextStr)
     return;
@@ -507,7 +518,8 @@ function decideCardChatTarget(input) {
     lineageChat,
     triggerChatId,
     triggerProfile,
-    triggerOwnership
+    triggerOwnership,
+    allowNewGroup
   } = input;
   const foreign = !!triggerChatId && !!triggerOwnership?.dedicated && triggerOwnership.ownerTaskIds.length > 0 && !triggerOwnership.ownerTaskIds.some((id) => lineageIds.includes(id));
   if (triggerChatId && !foreign) {
@@ -538,16 +550,25 @@ function decideCardChatTarget(input) {
       reason: "既没有触发群也没有 lineage 群（无法决定投递目标）"
     };
   }
+  if (allowNewGroup === true) {
+    return {
+      chatId: undefined,
+      source: "new-group",
+      profile: triggerProfile,
+      reroutedFrom: foreign ? {
+        chatId: triggerChatId,
+        ownerTaskIds: triggerOwnership.ownerTaskIds,
+        sources: triggerOwnership.sources
+      } : undefined,
+      reason: foreign ? `触发群 ${triggerChatId} 是 task ${triggerOwnership.ownerTaskIds.join(",")} 的专属群，且本 task 无群 → 需要新建（allowNewGroup=true）` : "无触发群且本 task 无群 → 需要新建（allowNewGroup=true）"
+    };
+  }
   return {
-    chatId: undefined,
-    source: "new-group",
+    chatId: triggerChatId,
     profile: triggerProfile,
-    reroutedFrom: foreign ? {
-      chatId: triggerChatId,
-      ownerTaskIds: triggerOwnership.ownerTaskIds,
-      sources: triggerOwnership.sources
-    } : undefined,
-    reason: foreign ? `触发群 ${triggerChatId} 是 task ${triggerOwnership.ownerTaskIds.join(",")} 的专属群，且本 task 无群 → 需要新建` : "无触发群且本 task 无群 → 需要新建"
+    source: "fallback-to-trigger",
+    reroutedFrom: undefined,
+    reason: foreign ? `触发群 ${triggerChatId} 是 task ${triggerOwnership.ownerTaskIds.join(",")} 的专属群，但默认不建群 → 退回触发群 ${triggerChatId}` : `默认不建群 → 退回触发群 ${triggerChatId}`
   };
 }
 
@@ -777,7 +798,8 @@ class LarkCliTaskNotifyHook {
       lineageChat,
       triggerChatId,
       triggerProfile,
-      triggerOwnership
+      triggerOwnership,
+      allowNewGroup: this.config.allowNewGroup === true
     });
     if (decision.source === "new-group") {
       if (this.cardRoutingPorts?.ensureTaskGroupChat) {
@@ -987,6 +1009,8 @@ class LarkCliTaskNotifyHook {
     return;
   }
   buildTaskMeta(task) {
+    const recordedNames = extractRecordedChatNames(task.context);
+    const matchedName = recordedNames.find((n) => new RegExp(`(?:Task\\s*#?\\s*|#)(?<![\\d])(?<!\\d)${task.id}(?!\\d)(?![\\d])`, "i").test(n));
     return {
       id: task.id,
       title: task.title,
@@ -997,7 +1021,9 @@ class LarkCliTaskNotifyHook {
       type: task.type,
       projectPath: task.project_path,
       context: task.context,
-      currentStatus: task.current_status
+      currentStatus: task.current_status,
+      perTaskChatId: extractPerTaskChatId(task.context),
+      perTaskChatName: matchedName
     };
   }
   deriveTimelineFromOperation(operation) {
@@ -1119,6 +1145,7 @@ class PerTaskGroupChatPlugin {
       sendWelcomeMessage: config.sendWelcomeMessage ?? true,
       resolveToTriggerChatFallback: config.resolveToTriggerChatFallback ?? false,
       cardInitialMessage: config.cardInitialMessage !== false,
+      autoCreateGroup: config.autoCreateGroup === true,
       cardNotifier: config.cardNotifier ?? new LarkCardPatchNotifier
     };
     this.cardNotifier = this.config.cardNotifier;
@@ -1263,7 +1290,11 @@ class PerTaskGroupChatPlugin {
       console.error(`[DEBUG per-task-group-chat.onAfterCreate] env.messageId=${env.messageId}`);
       console.error(`[DEBUG per-task-group-chat.onAfterCreate] env.sourceId=${env.sourceId}`);
     }
-    logger4.debug(`onAfterCreate[${this.pluginName}]: enter task=${task.id} "${task.title}" ` + `parent_task_id=${task.parent_task_id ?? "none"} ` + `requireReplyChannel=${this.config.requireReplyChannel} ` + `disableSubTaskSkip=${this.config.disableSubTaskSkip} ` + `sendWelcomeMessage=${this.config.sendWelcomeMessage}`);
+    logger4.debug(`onAfterCreate[${this.pluginName}]: enter task=${task.id} "${task.title}" ` + `parent_task_id=${task.parent_task_id ?? "none"} ` + `requireReplyChannel=${this.config.requireReplyChannel} ` + `disableSubTaskSkip=${this.config.disableSubTaskSkip} ` + `sendWelcomeMessage=${this.config.sendWelcomeMessage} ` + `autoCreateGroup=${this.config.autoCreateGroup}`);
+    if (!this.config.autoCreateGroup) {
+      logger4.debug(`onAfterCreate[${this.pluginName}]: task #${task.id} autoCreateGroup=false ` + `→ skip group chat creation（按需建群：用户在卡片顶部按钮触发）`);
+      return;
+    }
     const replyChannel = this.getReplyChannelFromCtx(ctx);
     if (!replyChannel?.chatId && this.config.requireReplyChannel) {
       logger4.debug(`onAfterCreate[${this.pluginName}]: no replyChannel.chatId for task #${task.id}, skip. ` + `修复：eventsource 收到 im.message.receive_v1 事件时 replyChannel 应有值；` + `或在 plugin config 设 requireReplyChannel=false 强制创建群聊（profile 降级到 fallbackProfile/无）`);
@@ -1714,4 +1745,4 @@ __legacyDecorateClassTS([
 function createPerTaskGroupChatPlugin(config = {}) {
   return new PerTaskGroupChatPlugin(config);
 }
-export { createAutoTaskPlugin, WORKFLOW_EXTRACTOR_PROMPT, formatExtractorInput, formatExtractorInputFromDescription, parseExtractorOutput, TaskTagPlugin, mergeChatOwnership, NotifyType, LarkCliTaskNotifyHook, createLarkCliTaskNotifyHook, PerTaskGroupChatPlugin, createPerTaskGroupChatPlugin };
+export { createAutoTaskPlugin, WORKFLOW_EXTRACTOR_PROMPT, formatExtractorInput, formatExtractorInputFromDescription, parseExtractorOutput, TaskTagPlugin, extractPerTaskChatId, extractPerTaskChatName, mergeChatOwnership, NotifyType, LarkCliTaskNotifyHook, createLarkCliTaskNotifyHook, PerTaskGroupChatPlugin, createPerTaskGroupChatPlugin };

package/dist/shared/@ai-setting/{roy-agent-core-9faekt5n.js → roy-agent-core-rcfewbzr.js}

@@ -1,6 +1,6 @@
 import {
   createAutoTaskPlugin
-} from "./roy-agent-core-kyasfzeh.js";
+} from "./roy-agent-core-pkpkctvf.js";
 import {
   ContextError,
   ErrorCodes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-setting/roy-agent-core",
-  "version": "1.7.51",
+  "version": "1.7.52",
   "type": "module",
   "description": "Core SDK for roy-agent - Environment, Components, Tools, Sessions, Tasks",
   "main": "./dist/index.js",