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

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

@@ -5,14 +5,20 @@ import {
   TaskTagPlugin,
   createLarkCliTaskNotifyHook,
   createPerTaskGroupChatPlugin,
+  extractPerTaskChatId,
+  extractPerTaskChatName,
   mergeChatOwnership
-} from "./roy-agent-core-s7jpkfm1.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);
     }
   }
 }