@ai-setting/roy-agent-core 1.7.85 → 1.7.88

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

@@ -4,57 +4,76 @@ import {
 import {
   cliCommandHandler
 } from "./roy-agent-core-v0hf14bj.js";
+import {
+  getSharedWecomSessionCardStore
+} from "./roy-agent-core-7kvpc0w5.js";
 import {
   guardConfigWrite
 } from "./roy-agent-core-2stt4rp5.js";
 import {
   TaskTagPlugin,
+  createGroupChatViaLarkCli,
   createLarkCliTaskNotifyHook,
   createPerTaskGroupChatPlugin,
   createWecomCardStateStore,
   createWecomTaskNotifyHook,
-  extractPerTaskChatId,
-  extractPerTaskChatName
-} from "./roy-agent-core-b31v3qpv.js";
+  deleteGroupChatViaLarkCli,
+  handleCardAction
+} from "./roy-agent-core-ra66sf50.js";
 import {
-  WecomCardActionKey,
-  buildWecomCardUpdateFrame,
   registerWecomRespondTarget,
+  sendWecomCliMarkdown,
   unregisterWecomRespondTarget
-} from "./roy-agent-core-m3vjepzz.js";
+} from "./roy-agent-core-h1e1fm9b.js";
+import {
+  ROY_SESSION_PREFIX,
+  WECOM_SESSION_TASK_SEP,
+  WecomCardActionKey,
+  buildWecomCardUpdateFrame,
+  buildWecomSessionUpdateFrame
+} from "./roy-agent-core-c4ec7k0p.js";
 import {
   getSharedEventStore
-} from "./roy-agent-core-na18zwj0.js";
+} from "./roy-agent-core-4t3yskp8.js";
 import {
   createLarkCliWorkflowNotifyHook
-} from "./roy-agent-core-d1n4jbza.js";
+} from "./roy-agent-core-wr1qexzq.js";
+import {
+  DEFAULT_APP_LINK_BASE,
+  getSharedLarkCardNotifier,
+  getSharedLarkCardStateStore
+} from "./roy-agent-core-shb1qsyg.js";
 import {
-  LarkCardPatchNotifier,
-  buildTaskCard
-} from "./roy-agent-core-7dd0s3xb.js";
+  RECENT_MESSAGE_LIMIT,
+  createActivityProbe,
+  createSessionActivityProbe,
+  extractToolCallsFromMessages,
+  mapBgTaskStatusToSessionLifecycle,
+  toActivityMessage
+} from "./roy-agent-core-418zc9ha.js";
 import {
   notifyReactFailure
-} from "./roy-agent-core-rykf7c04.js";
+} from "./roy-agent-core-9c565frx.js";
 import {
   normalizeLarkAtMentions
 } from "./roy-agent-core-m880qz3y.js";
 import {
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-cpcd24n2.js";
+} from "./roy-agent-core-yet36q5k.js";
 import {
   init_context
-} from "./roy-agent-core-qqaak24r.js";
+} from "./roy-agent-core-tkpp1ba0.js";
 import {
   createEnvContext,
   normalizeParentTaskId,
   runWithEnvContext
-} from "./roy-agent-core-7cbpmk4q.js";
+} from "./roy-agent-core-p31ftgq9.js";
 import {
   TracedAs,
   init_decorator,
   wrapFunction
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   createLogger,
   getTracerProvider,
@@ -67,7 +86,7 @@ import {
 
 // src/env/event-source/event-source-handlers.ts
 import { spawn as spawn3, exec as execSync } from "child_process";
-import { promisify as promisify2 } from "node:util";
+import { promisify } from "node:util";
 init_global_hook_manager();
 init_context();
 
@@ -193,245 +212,12 @@ function unregisterPluginHooksShared(pluginName, hookPoints) {
   }
 }
 
-// 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/timer-handler.ts
 init_decorator();
+init_logger();
 var DEFAULT_TIMER_INTERVAL_MS = 10 * 60 * 1000;
+var SKIPPED_TICK_LOG_EVERY = 20;
+var timerLogger = createLogger("timer:event-source");
 var SELF_REMINDER_MESSAGE = `[Timer Self-Reminder]
 请读取最近 1 周处理的 task 信息，分析用户当前的工作目标和重点任务。
 基于分析结果，自主构建有价值的任务来推进用户目标。
@@ -449,6 +235,19 @@ var TIMER_OPTIONS_KEY_SCHEDULE = "schedule";
 var TIMER_OPTIONS_KEY_SESSION_ID = "sessionId";
 var TIMER_OPTIONS_KEY_SKIP_WHEN_RUNNING = "skipWhenRunning";
 var TIME_PATTERN = /^([01]\d|2[0-3]):([0-5]\d)$/;
+function buildFireSpanAttributes(ctx) {
+  const attrs = {
+    mode: ctx.mode,
+    sourceId: ctx.sourceId,
+    skippedSinceLastFire: ctx.skippedSinceLastFire
+  };
+  if (ctx.entry !== undefined) {
+    attrs.scheduleTime = ctx.entry.time;
+    if (ctx.entry.label !== undefined)
+      attrs.scheduleLabel = ctx.entry.label;
+  }
+  return attrs;
+}
 function isValidScheduleTime(time) {
   return typeof time === "string" && TIME_PATTERN.test(time);
 }
@@ -539,6 +338,9 @@ class TimerInstance {
   scheduleSessionId;
   skipWhenRunning;
   firedKeys = new Set;
+  firedTicks = 0;
+  skippedTicks = 0;
+  skippedSinceLastFire = 0;
   now;
   status = "created";
   timerId;
@@ -594,6 +396,13 @@ class TimerInstance {
   getStatus() {
     return this.status;
   }
+  getTickStats() {
+    return {
+      firedTicks: this.firedTicks,
+      skippedTicks: this.skippedTicks,
+      skippedSinceLastFire: this.skippedSinceLastFire
+    };
+  }
   onEvent(handler) {
     this.eventHandler = handler;
   }
@@ -610,13 +419,31 @@ class TimerInstance {
       allTasks = this.getRunningTasks();
     } catch (error) {
       console.warn(`[TimerInstance] Failed to get running tasks, skipping tick: ${error}`);
+      this.recordSkip();
       return;
     }
     const hasRunning = Array.isArray(allTasks) && allTasks.some((t) => t.status === "running");
     if (hasRunning) {
+      this.recordSkip();
       return;
     }
-    const event = this.buildSelfReminderEvent();
+    this.fireTick({
+      mode: "interval",
+      sourceId: this.config.id,
+      skippedSinceLastFire: this.skippedSinceLastFire
+    });
+  }
+  recordSkip() {
+    this.skippedTicks++;
+    this.skippedSinceLastFire++;
+    if (this.skippedTicks % SKIPPED_TICK_LOG_EVERY === 0) {
+      timerLogger.debug(`[TimerInstance] ${this.config.id}: ${this.skippedTicks} ticks skipped ` + `(${this.skippedSinceLastFire} since last fire, mode=${this.isScheduleMode ? "schedule" : "interval"})`);
+    }
+  }
+  fireTick(ctx) {
+    this.firedTicks++;
+    this.skippedSinceLastFire = 0;
+    const event = this.buildSelfReminderEvent(ctx.entry);
     this.eventHandler?.(event);
   }
   tickSchedule() {
@@ -625,6 +452,7 @@ class TimerInstance {
         this.invalidScheduleWarned = true;
         console.warn(`[TimerInstance] Timer ${this.config.id} has an invalid or empty schedule configuration; ` + `no events will be fired. Check options.schedule (expected [{ time: "HH:MM", prompt: "..." }]).`);
       }
+      this.recordSkip();
       return;
     }
     const now = new Date(this.now());
@@ -646,6 +474,7 @@ class TimerInstance {
           hasRunning = Array.isArray(allTasks) && allTasks.some((t) => t.status === "running");
         } catch (error) {
           console.warn(`[TimerInstance] Failed to get running tasks, skipping tick: ${error}`);
+          this.recordSkip();
           return;
         }
         if (hasRunning) {
@@ -654,10 +483,15 @@ class TimerInstance {
       }
       this.firedKeys.add(firedKey);
       this.pruneFiredKeys(dateKey);
-      const event = this.buildSelfReminderEvent(entry);
-      this.eventHandler?.(event);
+      this.fireTick({
+        mode: "schedule",
+        sourceId: this.config.id,
+        skippedSinceLastFire: this.skippedSinceLastFire,
+        entry
+      });
       return;
     }
+    this.recordSkip();
   }
   pruneFiredKeys(currentDateKey) {
     if (this.firedKeys.size <= 32)
@@ -714,14 +548,14 @@ class TimerInstance {
   }
 }
 __legacyDecorateClassTS([
-  TracedAs("timer.tick", { recordParams: false, log: false })
-], TimerInstance.prototype, "tick", null);
-__legacyDecorateClassTS([
-  TracedAs("timer.tickSchedule", { recordParams: false, log: false })
-], TimerInstance.prototype, "tickSchedule", null);
-__legacyDecorateClassTS([
-  TracedAs("timer.buildSelfReminderEvent", { recordParams: false, log: false })
-], TimerInstance.prototype, "buildSelfReminderEvent", null);
+  TracedAs("timer.tick.fire", {
+    recordParams: true,
+    recordResult: false,
+    log: false,
+    paramFilter: (args) => buildFireSpanAttributes(args[0]),
+    flattenParamFilter: true
+  })
+], TimerInstance.prototype, "fireTick", null);
 var timerHandler = {
   type: "timer",
   validateConfig(config) {
@@ -1711,9 +1545,17 @@ class WecomWsBridge {
 
 // src/env/event-source/wecom-card-action-handler.ts
 init_logger();
-var logger2 = createLogger("wecom:card-action");
-var cardActionInflight2 = new Map;
+var logger = createLogger("wecom:card-action");
+var cardActionInflight = new Map;
 var ROY_TASK_PREFIX = "roy-task-";
+function parseRoySessionId(cardTaskId) {
+  if (!cardTaskId.startsWith(ROY_SESSION_PREFIX))
+    return null;
+  const rest = cardTaskId.slice(ROY_SESSION_PREFIX.length);
+  const sepIdx = rest.indexOf(WECOM_SESSION_TASK_SEP);
+  const id = (sepIdx >= 0 ? rest.slice(0, sepIdx) : rest).trim();
+  return id || null;
+}
 function parseRoyTaskId(cardTaskId) {
   if (!cardTaskId.startsWith(ROY_TASK_PREFIX))
     return null;
@@ -1745,6 +1587,7 @@ function extractWecomCardAction(frame) {
     eventKey: String(tce.event_key ?? ""),
     cardTaskId,
     taskId: parseRoyTaskId(cardTaskId),
+    sessionId: parseRoySessionId(cardTaskId),
     userId: from.userid ?? "",
     reqId: f.headers?.req_id ?? ""
   };
@@ -1761,6 +1604,10 @@ var ACTION_CARD_LABEL = {
   reopen: {
     statusLabel: "\uD83D\uDD04 进行中",
     note: "用户已重新打开任务"
+  },
+  refresh_activity: {
+    statusLabel: "⚡ 活性已刷新",
+    note: "已读取子会话最新活性"
   }
 };
 async function handleWecomCardAction(frame, ports) {
@@ -1769,17 +1616,26 @@ async function handleWecomCardAction(frame, ports) {
     return { ok: false, error: "not a template_card_event frame" };
   }
   const inflightKey = `${action.cardTaskId}:${action.eventKey}`;
-  const inflight = cardActionInflight2.get(inflightKey);
+  const inflight = cardActionInflight.get(inflightKey);
   if (inflight) {
-    logger2.warn(`handleWecomCardAction: ${inflightKey} 已有同操作在处理中` + `（疑似用户重复点击），本次忽略。`);
+    logger.warn(`handleWecomCardAction: ${inflightKey} 已有同操作在处理中` + `（疑似用户重复点击），本次忽略。`);
     return { ok: false, error: "同操作处理中，已忽略重复点击" };
   }
   const job = doHandle(action, ports).finally(() => {
-    cardActionInflight2.delete(inflightKey);
+    cardActionInflight.delete(inflightKey);
   });
-  cardActionInflight2.set(inflightKey, job);
+  cardActionInflight.set(inflightKey, job);
   return job;
 }
+async function probeSessionActivityByAssociatedTask(taskId, ports) {
+  if (!ports.findSessionCardByTaskId || !ports.loadSessionActivity) {
+    return;
+  }
+  const card = await ports.findSessionCardByTaskId(taskId);
+  if (!card?.sessionId)
+    return;
+  return await ports.loadSessionActivity(card.sessionId);
+}
 async function doHandle(action, ports) {
   let actionType;
   if (action.eventKey === WecomCardActionKey.MARK_DONE) {
@@ -1788,9 +1644,25 @@ async function doHandle(action, ports) {
     actionType = "reopen";
   } else if (action.eventKey === WecomCardActionKey.VIEW) {
     actionType = "view";
+  } else if (action.eventKey === WecomCardActionKey.REFRESH_ACTIVITY) {
+    actionType = "refresh_activity";
+  } else if (action.eventKey === WecomCardActionKey.CREATE_LARK_GROUP) {
+    actionType = "create_lark_group";
   } else {
     return { ok: false, error: `unknown event_key: ${action.eventKey}` };
   }
+  if (action.sessionId !== null) {
+    if (actionType === "refresh_activity") {
+      return await doHandleSessionActivity(action, ports);
+    }
+    if (actionType === "create_lark_group") {
+      return await doHandleSessionCreateLarkGroup(action, ports);
+    }
+    return {
+      ok: false,
+      error: `action ${actionType} requires a task card (got session ${action.sessionId})`
+    };
+  }
   if (action.taskId === null && actionType !== "view") {
     return {
       ok: false,
@@ -1806,20 +1678,20 @@ async function doHandle(action, ports) {
     }
   } catch (err) {
     opError = err instanceof Error ? err.message : String(err);
-    logger2.error(`handleWecomCardAction: task op failed for #${action.taskId}: ${opError}`);
+    logger.error(`handleWecomCardAction: task op failed for #${action.taskId}: ${opError}`);
   }
   const label = ACTION_CARD_LABEL[actionType];
-  const note = actionType === "view" ? label.note : opError ? `${label.note}（操作失败：${opError}）` : label.note;
+  const note = actionType === "view" || actionType === "refresh_activity" ? label.note : opError ? `${label.note}（操作失败：${opError}）` : label.note;
   let timeline;
   if ((actionType === "view" || actionType === "reopen") && action.taskId !== null) {
     try {
       timeline = ports.loadTimeline?.(action.taskId) ?? [];
       if (timeline.length === 0) {
-        logger2.warn(`handleWecomCardAction: task #${action.taskId} 无时间线记录，` + `降级为简单按钮态更新`);
+        logger.warn(`handleWecomCardAction: task #${action.taskId} 无时间线记录，` + `降级为简单按钮态更新`);
       }
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
-      logger2.warn(`handleWecomCardAction: loadTimeline failed for ` + `task #${action.taskId}: ${msg}（降级为简单按钮态更新）`);
+      logger.warn(`handleWecomCardAction: loadTimeline failed for ` + `task #${action.taskId}: ${msg}（降级为简单按钮态更新）`);
       timeline = [];
     }
   }
@@ -1831,13 +1703,43 @@ async function doHandle(action, ports) {
     }
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
-    logger2.warn(`handleWecomCardAction: loadTaskTitle failed for ` + `task #${action.taskId}: ${msg}（降级为无标题更新）`);
+    logger.warn(`handleWecomCardAction: loadTaskTitle failed for ` + `task #${action.taskId}: ${msg}（降级为无标题更新）`);
+  }
+  let activity;
+  let activityTerminal;
+  if (actionType === "refresh_activity" && action.taskId !== null) {
+    try {
+      const r = await ports.loadSubSessionActivity?.(action.taskId);
+      activity = r?.activity ?? null;
+      activityTerminal = r?.terminal === true;
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      logger.warn(`handleWecomCardAction: loadSubSessionActivity failed for ` + `task #${action.taskId}: ${msg}（降级为「暂无数据」）`);
+      activity = null;
+    }
+    if (activity === null) {
+      try {
+        const fallback = await probeSessionActivityByAssociatedTask(action.taskId, ports);
+        if (fallback?.activity) {
+          activity = fallback.activity;
+          activityTerminal = fallback.terminal === true;
+          logger.info(`handleWecomCardAction: task #${action.taskId} bgTask 反查失败，` + `已回退 session store probe（messageCount=${fallback.activity.messageCount}）`);
+        }
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        logger.warn(`handleWecomCardAction: session probe fallback failed for ` + `task #${action.taskId}: ${msg}（保持「暂无数据」）`);
+      }
+    }
   }
   try {
-    await ports.updateCard(action.reqId, action.cardTaskId, label.statusLabel, note, timeline, actionType, taskExtra);
+    await ports.updateCard(action.reqId, action.cardTaskId, label.statusLabel, note, timeline, actionType, activity === undefined ? taskExtra : {
+      ...taskExtra ?? {},
+      activity,
+      ...activityTerminal !== undefined ? { activityTerminal } : {}
+    });
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
-    logger2.error(`handleWecomCardAction: updateCard failed: ${msg}`);
+    logger.error(`handleWecomCardAction: updateCard failed: ${msg}`);
     return {
       ok: false,
       action: actionType,
@@ -1847,11 +1749,164 @@ async function doHandle(action, ports) {
   if (opError) {
     return { ok: false, action: actionType, error: opError };
   }
-  logger2.info(`handleWecomCardAction: task #${action.taskId} → ${actionType} ` + `(by ${action.userId})`);
+  logger.info(`handleWecomCardAction: task #${action.taskId} → ${actionType} ` + `(by ${action.userId})`);
   return { ok: true, action: actionType };
 }
+async function doHandleSessionActivity(action, ports) {
+  const sessionId = action.sessionId;
+  let state;
+  try {
+    state = await ports.loadSessionCardState?.(sessionId);
+  } catch (err) {
+    logger.warn(`handleWecomCardAction: loadSessionCardState failed for ${sessionId}: ` + `${err instanceof Error ? err.message : String(err)}（降级为仅活性）`);
+    state = undefined;
+  }
+  if (!state) {
+    logger.warn(`handleWecomCardAction: 无 session 卡持久层记录（${sessionId}）` + ` ⇒ 刷新卡降级为仅活性（生命周期/操作记录不可用）`);
+  }
+  let activity = null;
+  let probeTerminal;
+  try {
+    const r = await ports.loadSessionActivity?.(sessionId);
+    activity = r?.activity ?? null;
+    probeTerminal = r?.terminal;
+  } catch (err) {
+    logger.warn(`handleWecomCardAction: loadSessionActivity failed for ${sessionId}: ` + `${err instanceof Error ? err.message : String(err)}（降级为「暂无数据」）`);
+    activity = null;
+  }
+  let sessionTask;
+  try {
+    const t = await ports.loadSessionTaskInfo?.(sessionId);
+    if (t && typeof t.id === "number") {
+      sessionTask = t;
+    }
+  } catch (err) {
+    logger.warn(`handleWecomCardAction: loadSessionTaskInfo failed for ${sessionId}: ` + `${err instanceof Error ? err.message : String(err)}（降级为无任务行）`);
+  }
+  let linkedChatId;
+  try {
+    const g = await ports.findGroupChatForSession?.(sessionId);
+    if (g && typeof g.chatId === "string" && g.chatId.trim()) {
+      linkedChatId = g.chatId.trim();
+    }
+  } catch (err) {
+    logger.warn(`handleWecomCardAction: findGroupChatForSession failed for ${sessionId}: ` + `${err instanceof Error ? err.message : String(err)}（当作没有群）`);
+  }
+  if (ports.updateSessionCard) {
+    try {
+      await ports.updateSessionCard(action.reqId, {
+        sessionId,
+        cardTaskId: action.cardTaskId,
+        state,
+        activity,
+        ...sessionTask ? { task: sessionTask } : {},
+        ...linkedChatId ? { perTaskChatId: linkedChatId } : {}
+      });
+      logger.info(`handleWecomCardAction: session ${sessionId} → refresh ` + `(lifecycle=${state?.lifecycle ?? "unknown"}, by ${action.userId})`);
+      return { ok: true, action: "refresh_activity" };
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      logger.error(`handleWecomCardAction: session card update failed for ${sessionId}: ${msg}`);
+      return {
+        ok: false,
+        action: "refresh_activity",
+        error: `card update failed: ${msg}`
+      };
+    }
+  }
+  try {
+    await ports.updateCard(action.reqId, action.cardTaskId, ACTION_CARD_LABEL.refresh_activity.statusLabel, ACTION_CARD_LABEL.refresh_activity.note, undefined, "refresh_activity", {
+      activity,
+      activityTerminal: state?.lifecycle !== undefined ? state.lifecycle !== "running" : probeTerminal ?? false
+    });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    logger.error(`handleWecomCardAction: session card update failed for ${sessionId}: ${msg}`);
+    return { ok: false, action: "refresh_activity", error: `card update failed: ${msg}` };
+  }
+  logger.info(`handleWecomCardAction: session ${sessionId} → refresh ` + `(lifecycle=${state?.lifecycle ?? "unknown"}, by ${action.userId})`);
+  return { ok: true, action: "refresh_activity" };
+}
+async function doHandleSessionCreateLarkGroup(action, ports) {
+  const sessionId = action.sessionId;
+  let existingChatId;
+  try {
+    const g = await ports.findGroupChatForSession?.(sessionId);
+    if (g && typeof g.chatId === "string" && g.chatId.trim()) {
+      existingChatId = g.chatId.trim();
+    }
+  } catch (err) {
+    logger.warn(`handleWecomCardAction: findGroupChatForSession(${sessionId}) 失败` + `（当作没有群）: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  if (existingChatId) {
+    logger.info(`handleWecomCardAction: session ${sessionId} 已有飞书群 ` + `${existingChatId}（幂等命中，不重复建群）`);
+    await updateSessionCardWithGroup(ports, action, sessionId, existingChatId);
+    return { ok: true, action: "create_lark_group", newChatId: existingChatId };
+  }
+  if (!ports.createLarkGroupForSession) {
+    return {
+      ok: false,
+      action: "create_lark_group",
+      error: "ports.createLarkGroupForSession not injected " + "(wecom-cli-handler wiring missing)"
+    };
+  }
+  let chatId;
+  try {
+    chatId = await ports.createLarkGroupForSession(sessionId);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    logger.error(`handleWecomCardAction: createLarkGroupForSession(${sessionId}) ` + `failed: ${msg}`);
+    await updateSessionCardWithGroup(ports, action, sessionId, undefined, `⚠️ 建群失败：${msg.slice(0, 80)}`);
+    return { ok: false, action: "create_lark_group", error: msg };
+  }
+  logger.info(`handleWecomCardAction: session ${sessionId} → 飞书群 ${chatId} ` + `创建成功（by ${action.userId}）`);
+  await updateSessionCardWithGroup(ports, action, sessionId, chatId);
+  if (ports.notifyGroupLink) {
+    try {
+      await ports.notifyGroupLink({
+        sessionId,
+        chatId,
+        ...action.userId ? { userId: action.userId } : {}
+      });
+    } catch (err) {
+      logger.warn(`handleWecomCardAction: notifyGroupLink(${sessionId} → ${chatId}) ` + `失败（不阻断建群结果）: ` + `${err instanceof Error ? err.message : String(err)}`);
+    }
+  }
+  return { ok: true, action: "create_lark_group", newChatId: chatId };
+}
+async function updateSessionCardWithGroup(ports, action, sessionId, chatId, errorHint) {
+  if (!ports.updateSessionCard)
+    return;
+  try {
+    let state;
+    try {
+      state = await ports.loadSessionCardState?.(sessionId);
+    } catch {
+      state = undefined;
+    }
+    let activity = null;
+    try {
+      const r = await ports.loadSessionActivity?.(sessionId);
+      activity = r?.activity ?? null;
+    } catch {
+      activity = null;
+    }
+    await ports.updateSessionCard(action.reqId, {
+      sessionId,
+      cardTaskId: action.cardTaskId,
+      ...state ? { state } : {},
+      activity,
+      ...chatId ? { perTaskChatId: chatId } : {},
+      ...errorHint ? { errorHint } : {}
+    });
+    logger.info(`handleWecomCardAction: session card updated after group change ` + `(session=${sessionId}, chatId=${chatId ?? "none"})`);
+  } catch (err) {
+    logger.warn(`handleWecomCardAction: session card update after group change ` + `failed for ${sessionId}（不阻断建群结果）: ` + `${err instanceof Error ? err.message : String(err)}`);
+  }
+}
 function buildWecomCardUpdateBody(input) {
   const refreshable = input.action === "view" || input.action === "reopen";
+  const activityRefreshable = input.action === "refresh_activity";
   const frame = buildWecomCardUpdateFrame({
     reqId: "placeholder",
     taskId: input.cardTaskId,
@@ -1860,7 +1915,44 @@ function buildWecomCardUpdateBody(input) {
     timeline: input.timeline,
     taskTitle: input.taskTitle,
     taskNumber: input.taskNumber,
-    buttonOverrides: refreshable ? [{ text: "刷新详情", key: WecomCardActionKey.VIEW, style: 1 }] : [{ text: "已处理", key: "task_done_ack", style: 4 }]
+    buttonOverrides: refreshable ? [{ text: "刷新详情", key: WecomCardActionKey.VIEW, style: 1 }] : activityRefreshable ? [
+      { text: "刷新详情", key: WecomCardActionKey.VIEW, style: 2 },
+      { text: "刷新活性", key: WecomCardActionKey.REFRESH_ACTIVITY, style: 1 }
+    ] : [{ text: "已处理", key: "task_done_ack", style: 4 }],
+    ...input.activity !== undefined ? { activity: input.activity } : {},
+    ...input.activityTerminal !== undefined ? { activityTerminal: input.activityTerminal } : {}
+  });
+  return { cmd: frame.cmd, body: frame.body };
+}
+function buildWecomSessionCardUpdateBody(input) {
+  const state = input.state;
+  const lifecycle = state?.lifecycle ?? "unknown";
+  let milestones;
+  if (state?.milestones) {
+    try {
+      const arr = JSON.parse(state.milestones);
+      if (Array.isArray(arr) && arr.length > 0) {
+        milestones = arr;
+      }
+    } catch {
+      milestones = undefined;
+    }
+  }
+  const task = input.task ?? (state?.associatedTaskId !== undefined ? { id: state.associatedTaskId } : undefined);
+  const frame = buildWecomSessionUpdateFrame({
+    reqId: input.reqIdForTest ?? "placeholder",
+    cardTaskId: input.cardTaskId,
+    sessionId: input.sessionId,
+    lifecycle,
+    ...state?.title ? { title: state.title } : {},
+    ...state?.agentType ? { agentType: state.agentType } : {},
+    ...state?.startedAt ? { startedAt: state.startedAt } : {},
+    ...task ? { task } : {},
+    ...milestones ? { milestones } : {},
+    ...input.perTaskChatId ? { perTaskChatId: input.perTaskChatId } : {},
+    ...input.errorHint ? { errorHint: input.errorHint } : {},
+    ...input.activity !== undefined ? { activity: input.activity } : {},
+    ...input.now !== undefined ? { now: input.now } : {}
   });
   return { cmd: frame.cmd, body: frame.body };
 }
@@ -2046,7 +2138,8 @@ function buildWecomReplyChannel(input) {
       wecomChatId: rawChatId,
       wecomUserId: userId,
       ...input.sourceId ? { sourceId: input.sourceId } : {},
-      ...input.reqId ? { reqId: input.reqId } : {}
+      ...input.reqId ? { reqId: input.reqId } : {},
+      statusNotifications: input.statusNotifications === true
     }
   };
 }
@@ -2161,6 +2254,22 @@ function parseWecomFrame(raw) {
     reqId: frame.headers?.req_id
   };
 }
+var WECOM_DEFAULT_EXTEND_TOOLS = ["wecom_respond"];
+function resolveWecomExtendTools(config) {
+  const out = [];
+  const push = (name) => {
+    if (typeof name !== "string")
+      return;
+    const trimmed = name.trim();
+    if (trimmed.length === 0)
+      return;
+    if (!out.includes(trimmed))
+      out.push(trimmed);
+  };
+  WECOM_DEFAULT_EXTEND_TOOLS.forEach(push);
+  (config?.extendTools ?? []).forEach(push);
+  return out;
+}
 var WECOM_CHANNEL_PROMPT_SECTION_TITLE = "⭐ 企业微信回复规范（system prompt 注入版）";
 function buildWecomChannelSystemPrompt(opts) {
   const botLine = opts.botId ? `本渠道智能机器人 BotID：${opts.botId}。` : `本渠道未配置 BotID（使用事件回调里的 aibotid）。`;
@@ -2292,15 +2401,82 @@ class WecomCliInstance {
   pluginInstances = new Map;
   loadedPlugins = [];
   cardActionPorts;
+  sessionCardStore;
   constructor(config) {
     this.config = config;
   }
   setCardActionPorts(ports) {
     this.cardActionPorts = ports;
+    this.applySessionCardPorts();
   }
   hasCardActionPorts() {
     return this.cardActionPorts !== undefined;
   }
+  setSessionCardStore(store) {
+    this.sessionCardStore = store;
+    this.applySessionCardPorts();
+  }
+  hasSessionCardStore() {
+    return this.sessionCardStore !== undefined;
+  }
+  applySessionCardPorts() {
+    if (!this.cardActionPorts || !this.sessionCardStore)
+      return;
+    const store = this.sessionCardStore;
+    this.cardActionPorts.loadSessionCardState ??= (sessionId) => store.get(sessionId);
+    this.cardActionPorts.findSessionCardByTaskId ??= (taskId) => {
+      const hits = store.list().filter((s) => s.associatedTaskId === taskId);
+      if (hits.length === 0)
+        return;
+      const open = hits.filter((s) => s.closedAt === undefined);
+      const pool = open.length > 0 ? open : hits;
+      return pool.reduce((a, b) => b.updatedAt > a.updatedAt ? b : a);
+    };
+    this.cardActionPorts.updateSessionCard ??= async (reqId, input) => {
+      const { cmd, body } = buildWecomSessionCardUpdateBody({
+        cardTaskId: input.cardTaskId,
+        sessionId: input.sessionId,
+        ...input.state ? { state: input.state } : {},
+        activity: input.activity,
+        ...input.task ? { task: input.task } : {},
+        ...input.perTaskChatId ? { perTaskChatId: input.perTaskChatId } : {},
+        ...input.errorHint ? { errorHint: input.errorHint } : {},
+        ...input.now !== undefined ? { now: input.now } : {}
+      });
+      const err = this.wsBridge?.sendFrameWithReqId({
+        cmd,
+        headers: { req_id: reqId },
+        body
+      });
+      if (err)
+        throw err;
+    };
+    this.cardActionPorts.loadSessionTaskInfo ??= async (sessionId) => {
+      const taskComponent = this.environment?.getComponent?.("task");
+      const getter = taskComponent?.getTaskIdBySessionId;
+      if (typeof getter !== "function")
+        return;
+      const taskId = await getter.call(taskComponent, sessionId);
+      if (typeof taskId !== "number")
+        return;
+      const withOps = await taskComponent?.getTaskWithOperations?.(taskId);
+      if (!withOps)
+        return { id: taskId };
+      const ops = Array.isArray(withOps.operations) ? withOps.operations : [];
+      return {
+        id: taskId,
+        ...typeof withOps.title === "string" ? { title: withOps.title } : {},
+        ...typeof withOps.status === "string" ? { status: withOps.status } : {},
+        ...typeof withOps.progress === "number" ? { progress: withOps.progress } : {},
+        ...ops.length > 0 ? {
+          milestones: ops.slice(-10).map((o) => ({
+            title: String(o.milestoneTitle ?? o.milestoneType ?? ""),
+            timestamp: String(o.timestamp ?? "")
+          }))
+        } : {}
+      };
+    };
+  }
   environment;
   setEnvironment(env) {
     this.environment = env;
@@ -2322,6 +2498,7 @@ class WecomCliInstance {
     const metadata = {
       ...parsed.metadata,
       systemPrompt: channelPrompt,
+      extendTools: resolveWecomExtendTools(this.config),
       reqId: parsed.reqId,
       plugins: this.config.handleRule?.plugins || [],
       pluginEnabled: Object.fromEntries((this.config.handleRule?.plugins || []).map((p) => [
@@ -2335,7 +2512,8 @@ class WecomCliInstance {
       chatType: metadata.chatType,
       userId: metadata.senderId,
       sourceId: this.config.id,
-      reqId: parsed.reqId
+      reqId: parsed.reqId,
+      statusNotifications: this.config.statusNotifications === true
     });
     const event = {
       id: `es-${this.config.id}-${Date.now()}`,
@@ -2408,18 +2586,29 @@ class WecomCliInstance {
     if (this.cardActionPorts)
       return;
     const taskComponent = this.environment?.getComponent?.("task");
-    if (!taskComponent?.updateTask || !this.wsBridge) {
-      console.warn(`[wecom-cli] cardActionPorts 未注入：taskComponent.updateTask=` + `${typeof taskComponent?.updateTask}, wsBridge=${!!this.wsBridge}。` + `卡片按钮点击会被跳过。`);
+    if (!this.wsBridge) {
+      console.warn(`[wecom-cli] cardActionPorts 未注入：wsBridge 缺失（没有通道发更新帧）。` + `卡片按钮点击会被跳过。`);
       return;
     }
+    const taskOpsAvailable = typeof taskComponent?.updateTask === "function";
+    if (!taskOpsAvailable) {
+      console.warn(`[wecom-cli] taskComponent.updateTask 不可用 ⇒ 「标记完成 / 重新打开」` + `降级为报错；session 卡「刷新」不受影响（Task #5364）。`);
+    }
+    const requireTaskOps = () => {
+      if (!taskOpsAvailable) {
+        throw new Error("task ops unavailable (taskComponent.updateTask missing)");
+      }
+    };
     this.cardActionPorts = {
       markTaskDone: async (taskId) => {
+        requireTaskOps();
         await taskComponent.updateTask(taskId, {
           status: "completed",
           current_status: "用户在企微卡片点「标记完成」确认完成"
         });
       },
       reopenTask: async (taskId) => {
+        requireTaskOps();
         await taskComponent.updateTask(taskId, {
           status: "active",
           current_status: "用户在企微卡片点「重新打开」"
@@ -2433,7 +2622,9 @@ class WecomCliInstance {
           timeline,
           action,
           taskTitle: extra?.taskTitle,
-          taskNumber: extra?.taskNumber
+          taskNumber: extra?.taskNumber,
+          ...extra?.activity !== undefined ? { activity: extra.activity } : {},
+          ...extra?.activityTerminal !== undefined ? { activityTerminal: extra.activityTerminal } : {}
         });
         const frame = {
           cmd,
@@ -2489,7 +2680,114 @@ class WecomCliInstance {
         }
       }
     };
-    console.info(`[wecom-cli] cardActionPorts 已注入（task ops + bridge.respond 更新 + timeline + taskTitle）`);
+    this.cardActionPorts.loadSubSessionActivity = createActivityProbe({
+      listBackgroundTasks: () => {
+        const tc = this.environment?.getComponent?.("task");
+        return tc?.getBackgroundTaskManager?.()?.listTasks?.();
+      },
+      getSubSessionActivity: (bgId) => {
+        const tc = this.environment?.getComponent?.("task");
+        return tc?.getBackgroundTaskManager?.()?.getSubSessionActivity?.(bgId);
+      },
+      getLastMessage: async (subSessionId) => {
+        const sc = this.environment?.getComponent?.("session");
+        if (!sc?.getMessages)
+          return;
+        const tail = await sc.getMessages(subSessionId, { offset: -1, limit: 1 });
+        return toActivityMessage(tail?.[tail.length - 1]);
+      },
+      isTerminalTask: async (taskId) => {
+        const tc = this.environment?.getComponent?.("task");
+        const raw = tc?.getTask?.call(tc, taskId);
+        const t = raw && typeof raw.then === "function" ? await raw : raw;
+        return t?.status === "completed" || t?.status === "cancelled" || t?.status === "failed" || t?.status === "archived";
+      }
+    });
+    this.cardActionPorts.loadSessionActivity = createSessionActivityProbe({
+      getSession: async (sessionId) => {
+        const sc = this.environment?.getComponent?.("session");
+        if (!sc?.get)
+          return;
+        const s = await sc.get(sessionId);
+        if (!s)
+          return;
+        return {
+          ...typeof s.messageCount === "number" ? { messageCount: s.messageCount } : {},
+          ...typeof s.updatedAt === "number" ? { updatedAt: s.updatedAt } : {}
+        };
+      },
+      getLastMessage: async (sessionId) => {
+        const sc = this.environment?.getComponent?.("session");
+        if (!sc?.getMessages)
+          return;
+        const tail = await sc.getMessages(sessionId, { offset: -1, limit: 1 });
+        return toActivityMessage(tail?.[tail.length - 1]);
+      },
+      getLifecycle: (sessionId) => {
+        const tc = this.environment?.getComponent?.("task");
+        const tasks = tc?.getBackgroundTaskManager?.()?.listTasks?.() ?? [];
+        const hit = tasks.find((t) => t?.subSessionId === sessionId);
+        return mapBgTaskStatusToSessionLifecycle(hit?.status);
+      }
+    });
+    this.sessionCardStore ??= getSharedWecomSessionCardStore();
+    this.applySessionCardPorts();
+    if (this.cardActionPorts) {
+      const sessionComponent = () => this.environment?.getComponent?.("session");
+      this.cardActionPorts.findGroupChatForSession ??= async (sessionId) => {
+        const sc = sessionComponent();
+        if (typeof sc?.findGroupChatForSession !== "function") {
+          return;
+        }
+        return sc.findGroupChatForSession(sessionId);
+      };
+      this.cardActionPorts.createLarkGroupForSession ??= async (sessionId) => {
+        const sc = sessionComponent();
+        let title;
+        try {
+          const s = await sc?.get?.(sessionId);
+          if (typeof s?.title === "string" && s.title.trim()) {
+            title = s.title.trim();
+          }
+        } catch {}
+        const name = title ?? sessionId.slice(-20);
+        const chatId = await createGroupChatViaLarkCli({
+          name: `会话 ${name}`.slice(0, 60),
+          description: `roy-agent session ${sessionId}`.slice(0, 100)
+        });
+        try {
+          await sc?.attachGroupSession?.({
+            chatId,
+            originSessionId: sessionId,
+            title: name
+          });
+        } catch (err) {
+          console.warn(`[wecom-cli] attachGroupSession(${chatId} ← ${sessionId}) ` + `失败（不阻断建群）: ${err}`);
+        }
+        return chatId;
+      };
+      this.cardActionPorts.notifyGroupLink ??= async (input) => {
+        const link = `${DEFAULT_APP_LINK_BASE}/client/chat/open?openChatId=${input.chatId}`;
+        const text = `\uD83D\uDCE8 会话 ${input.sessionId} 的关联飞书群已建立：` + `[点击进入群](${link})`;
+        let target = input.userId || "";
+        if (!target) {
+          try {
+            target = this.sessionCardStore?.get(input.sessionId)?.chatId ?? "";
+          } catch {
+            target = "";
+          }
+        }
+        if (!target) {
+          console.warn(`[wecom-cli] notifyGroupLink: 无法定位企微会话 ` + `(userId 缺失且 session store 无 chatId)，跳过通知`);
+          return;
+        }
+        const r = await sendWecomCliMarkdown({ chatId: target, content: text });
+        if (!r.ok) {
+          console.warn(`[wecom-cli] notifyGroupLink cli failed: ${r.ok ? "unknown" : r.error}`);
+        }
+      };
+    }
+    console.info(`[wecom-cli] cardActionPorts 已注入（task ops + bridge.respond 更新 + timeline + taskTitle + activity + session task info + lark group）`);
   }
   getWecomCardStateStore() {
     const plugin = this.pluginInstances.get("WecomTaskNotifyPlugin");
@@ -2567,6 +2865,7 @@ class WecomCliInstance {
       const plugin = importPluginShared(pluginName, getWecomPluginFactories(), {
         sourceId: this.config.id,
         pluginName,
+        statusNotifications: this.config.statusNotifications === true,
         ...pluginConfig
       });
       if (!plugin)
@@ -2625,7 +2924,8 @@ class WecomCliInstance {
             chatType: parsed.metadata.chatType,
             userId: parsed.metadata.senderId,
             sourceId: this.config.id,
-            reqId: parsed.reqId
+            reqId: parsed.reqId,
+            statusNotifications: this.config.statusNotifications === true
           });
           notifyReactFailure({
             error: err,
@@ -2745,7 +3045,8 @@ class WecomCliInstance {
       chatType: parsed.metadata.chatType,
       userId: parsed.metadata.senderId,
       sourceId: this.config.id,
-      reqId: parsed.reqId
+      reqId: parsed.reqId,
+      statusNotifications: this.config.statusNotifications === true
     });
     const event = {
       metadata: parsed.metadata,
@@ -3606,7 +3907,7 @@ ${USAGE2}`
 }
 
 // src/env/event-source/command-registry.ts
-var logger3 = createLogger("command-registry");
+var logger2 = createLogger("command-registry");
 var COMMAND_PREFIX = "##command##:";
 var COMMAND_PREFIX_LOWER = COMMAND_PREFIX.toLowerCase();
 function stripLeadingMentions(text) {
@@ -3679,7 +3980,7 @@ ${this.renderHelp()}`
       });
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
-      logger3.error(`[CommandRegistry] command "${subcommand}" failed: ${msg}`);
+      logger2.error(`[CommandRegistry] command "${subcommand}" failed: ${msg}`);
       return { ok: false, error: `命令执行失败：${msg}` };
     }
   }
@@ -3710,7 +4011,7 @@ async function handleCommandMessage(text, opts = {}) {
   if (!invocation)
     return null;
   const registry = opts.registry ?? getGlobalCommandRegistry();
-  logger3.info(`[handleCommandMessage] dispatching "${invocation.subcommand}" args=${JSON.stringify(invocation.args)}`);
+  logger2.info(`[handleCommandMessage] dispatching "${invocation.subcommand}" args=${JSON.stringify(invocation.args)}`);
   return registry.dispatch(invocation.subcommand, invocation.args, {
     rawText: text,
     configPath: opts.configPath
@@ -3719,7 +4020,7 @@ async function handleCommandMessage(text, opts = {}) {
 
 // src/env/event-source/command-card-action.ts
 init_logger();
-var logger4 = createLogger("command-card-action");
+var logger3 = createLogger("command-card-action");
 function isCommandCardAction(event) {
   const av = event.actionValue;
   if (av && typeof av === "object") {
@@ -3776,7 +4077,7 @@ async function handleCommandCardAction(event, ports) {
     return { ok: false, error: "无法识别的 command 卡片动作" };
   }
   const executed = `${call.subcommand} ${call.args.join(" ")}`;
-  logger4.info(`[handleCommandCardAction] 执行 ${executed}`);
+  logger3.info(`[handleCommandCardAction] 执行 ${executed}`);
   let result;
   try {
     result = await ports.executeCommand(call.subcommand, call.args, {
@@ -3784,7 +4085,7 @@ async function handleCommandCardAction(event, ports) {
     });
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
-    logger4.error(`[handleCommandCardAction] ${executed} 执行异常：${msg}`);
+    logger3.error(`[handleCommandCardAction] ${executed} 执行异常：${msg}`);
     return { ok: false, executed, error: `命令执行异常：${msg}` };
   }
   if (!result.ok) {
@@ -3797,7 +4098,7 @@ async function handleCommandCardAction(event, ports) {
       await ports.patchCard(event.token, card, event.profile);
     } catch (err) {
       patchError = err.message;
-      logger4.error(`[handleCommandCardAction] patch 卡片失败：${patchError}`);
+      logger3.error(`[handleCommandCardAction] patch 卡片失败：${patchError}`);
     }
   }
   return { ok: true, executed, card, patchError };
@@ -3805,8 +4106,8 @@ async function handleCommandCardAction(event, ports) {
 
 // src/env/event-source/event-source-handlers.ts
 init_logger();
-var execAsync2 = promisify2(execSync);
-var logger5 = createLogger("lark-cli:event-source");
+var execAsync = promisify(execSync);
+var logger4 = 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";
@@ -3830,18 +4131,52 @@ function matchEventType(eventType, patterns) {
   }
   return false;
 }
+function buildSlimRawData(rawEvent) {
+  const event = rawEvent ?? {};
+  const innerEvent = event.event;
+  const message = innerEvent?.message ?? event.message;
+  const sender = innerEvent?.sender ?? event.sender;
+  const slim = {};
+  const chatId = message?.chat_id ?? event.chat_id;
+  if (chatId !== undefined)
+    slim.chat_id = chatId;
+  const messageId = message?.message_id ?? event.message_id ?? event.id;
+  if (messageId !== undefined)
+    slim.message_id = messageId;
+  const rawSenderId = sender?.sender_id ?? event.sender_id;
+  let senderId;
+  if (typeof rawSenderId === "string") {
+    senderId = rawSenderId;
+  } else if (rawSenderId && typeof rawSenderId === "object") {
+    const obj = rawSenderId;
+    senderId = obj.open_id ?? obj.user_id ?? obj.union_id;
+  }
+  if (senderId !== undefined)
+    slim.sender_id = senderId;
+  const chatType = message?.chat_type ?? event.chat_type;
+  if (chatType !== undefined)
+    slim.chat_type = chatType;
+  const content = message?.content ?? event.content;
+  if (content !== undefined)
+    slim.content = content;
+  const mentions = message?.mentions ?? event.mentions;
+  if (mentions !== undefined)
+    slim.mentions = mentions;
+  return slim;
+}
 function buildLarkRecommendedAction(opts) {
-  const { profile, chatType, appId, chatId, messageId } = opts;
+  const { profile, chatType, appId, chatId, messageId, senderId } = opts;
   const profileFlag = profile ? `--profile ${profile} ` : "";
   const profileWarn = profile ? `（⚠️ 必须用 profile="${profile}" 调 lark-cli；openId per-app 隔离，换 profile 会失败）` : "";
   const isGroup = chatType === "group";
-  const scopeHint = isGroup ? `群聊消息；回复到 replyTo.chatId。如需 @发件人，用结构化 at 节点 {"tag":"at","user_id":"<senderId>"}（不要写 <at> 文本标签）` : "p2p 私聊消息；回复到 replyTo.chatId";
+  const senderIdForPrompt = senderId || "<senderId>";
+  const scopeHint = isGroup ? `群聊消息；回复到 replyTo.chatId。如需 @发件人，用结构化 at 节点 {"tag":"at","user_id":"${senderIdForPrompt}"}（不要写 <at> 文本标签）` : "p2p 私聊消息；回复到 replyTo.chatId";
   const scopeWord = isGroup ? "群聊" : "p2p 私聊";
   const action = [
     `处理飞书 ${scopeWord}消息并以机器人身份回复${profileWarn}。`,
     `scope: ${scopeHint}。`,
     ``,
-    ...larkStaticRuleLines(profileFlag),
+    ...larkStaticRuleLines(profileFlag, senderIdForPrompt),
     ``,
     `## 必须使用 replyTo 里给定的值`,
     `profile / chatId / messageId / --as bot 必须原样取自 recommendedAction.replyTo；不要凭印象自己拼接。`
@@ -3863,7 +4198,7 @@ function buildLarkRecommendedAction(opts) {
   };
 }
 var LARK_CHANNEL_PROMPT_SECTION_TITLE = "⭐ 飞书回复规范（system prompt 注入版）";
-var LARK_PROMPT_LENGTH_BUDGET = 5300;
+var LARK_PROMPT_LENGTH_BUDGET = 5900;
 function larkReplyContextSection(profileFlag) {
   return [
     ``,
@@ -3873,7 +4208,7 @@ function larkReplyContextSection(profileFlag) {
   ].join(`
 `);
 }
-function larkStaticRuleLines(profileFlag) {
+function larkStaticRuleLines(profileFlag, senderIdForPrompt) {
   return [
     `## ⭐ 关键 0：整次回复只发一条结构化 post（禁分段）`,
     `> 指令优先级：本 prompt 与 lark-* skill 文档冲突时**以本 prompt 为准**`,
@@ -3909,6 +4244,13 @@ function larkStaticRuleLines(profileFlag) {
     `  ]}}`,
     ``,
     `- @mention：用 {"tag":"at","user_id":"ou_xxx"}（user_id 填对方 open_id；@所有人填 "all"）`,
+    `- **群聊必须 @ sender**：若接收的消息是 \`chat_type: group\`，回复时 content **必须**保留结构化 at 节点 @ 发送者（user_id 填 senderId，即消息发送者的 open_id）；**禁止只用引用回复**（quote/reply 不算 @，群聊里对方收不到提醒）；私聊（p2p）不需要。群聊可跑示例（照抄，--arg uid 填消息发送者 open_id）：`,
+    `  body_file="$(mktemp /tmp/lark-ask.XXXXXX.md)"`,
+    `  cat > "$body_file" <<'EOF2'`,
+    `  回复正文……`,
+    `  EOF2`,
+    `  content="$(jq -nc --rawfile md "$body_file" --arg uid "${senderIdForPrompt}" '{zh_cn:{content:[[{tag:"at",user_id:$uid}],[{tag:"md",text:$md}]]}}')"`,
+    `  lark-cli ${profileFlag}im +messages-reply --message-id <replyTo.messageId> --as bot --msg-type post --content "$content"`,
     `- 正文：全部放进 {"tag":"md","text":"..."} 这一个节点里`,
     `- 不需要 @ 时，content 里只放 md 节点：{"zh_cn":{"content":[[{"tag":"md","text":"..."}]]}}`,
     `- md 节点支持 CommonMark 0.31 + GFM：ATX 标题（#~######）/ 表格 / 任务列表 / 加粗 / 围栏代码块 / 超链接`,
@@ -3926,7 +4268,7 @@ function larkStaticRuleLines(profileFlag) {
     `  cat > "$body_file" <<'LARK_REPLY_EOF'`,
     `  ...（回复的 Markdown 正文，可多行 / 含表格 / 含特殊字符；不要写 <at> 标签）`,
     `  LARK_REPLY_EOF`,
-    `  content="$(jq -nc --rawfile md "$body_file" --arg uid "<senderId>" '{zh_cn:{content:[[{tag:"at",user_id:$uid}],[{tag:"md",text:$md}]]}}')"`,
+    `  content="$(jq -nc --rawfile md "$body_file" --arg uid "${senderIdForPrompt}" '{zh_cn:{content:[[{tag:"at",user_id:$uid}],[{tag:"md",text:$md}]]}}')"`,
     `  lark-cli ${profileFlag}im +messages-reply --message-id <取自 replyTo.messageId> --as bot --msg-type post --content "$content"`,
     ``,
     `不需要 @ 某人时，把 jq 表达式换成 '{zh_cn:{content:[[{tag:"md",text:$md}]]}}'。`,
@@ -3999,12 +4341,13 @@ function buildLarkChannelSystemPrompt(opts) {
     larkReplyContextSection(profileFlag)
   ].join(`
 `);
-  return header + larkStaticRuleLines(profileFlag).join(`
+  return header + larkStaticRuleLines(profileFlag, "<senderId>").join(`
 `) + footer;
 }
-function buildLarkLeanAction(chatType) {
+function buildLarkLeanAction(chatType, senderId) {
   const isGroup = chatType === "group";
-  const scopeHint = isGroup ? `群聊消息；回复到 replyTo.chatId。如需 @发件人，用结构化 at 节点 {"tag":"at","user_id":"<senderId>"}（不要写 <at> 文本标签）` : "p2p 私聊消息；回复到 replyTo.chatId";
+  const senderIdForPrompt = senderId || "<senderId>";
+  const scopeHint = isGroup ? `群聊消息；回复到 replyTo.chatId。如需 @发件人，用结构化 at 节点 {"tag":"at","user_id":"${senderIdForPrompt}"}（不要写 <at> 文本标签）` : "p2p 私聊消息；回复到 replyTo.chatId";
   return [
     `处理飞书${isGroup ? "群聊" : "p2p 私聊"}消息并回复。回复规范见 system prompt「${LARK_CHANNEL_PROMPT_SECTION_TITLE}」章节。`,
     `scope: ${scopeHint}。`,
@@ -4087,11 +4430,12 @@ function extractMetadata(rawEvent, eventType) {
         chatType: metadata.chatType,
         appId: metadata.appId,
         chatId: metadata.chatId,
-        messageId: metadata.messageId
+        messageId: metadata.messageId,
+        senderId: metadata.senderId
       });
     } else {
       recommendedAction = {
-        action: buildLarkLeanAction(metadata.chatType),
+        action: buildLarkLeanAction(metadata.chatType, metadata.senderId),
         replyTo: {
           appId: metadata.appId,
           profile: profile2,
@@ -4117,7 +4461,8 @@ function extractMetadata(rawEvent, eventType) {
     chatId: messageData?.chat_id,
     messageId: messageData?.message_id,
     params: {
-      userId: senderOpenId
+      userId: senderOpenId,
+      statusNotifications: event.statusNotifications === true
     }
   };
   return { metadata, replyChannel, recommendedAction };
@@ -4135,8 +4480,8 @@ class LarkCliInstance {
   cardActionPorts;
   setCardActionPorts(ports) {
     this.cardActionPorts = ports;
-    if (typeof logger5 !== "undefined" && logger5?.debug) {
-      logger5.debug(`[LarkCliInstance] CardActionPorts injected: ` + `getTask=${typeof ports.getTask}, updateTaskContext=${typeof ports.updateTaskContext}, ` + `createGroupChat=${typeof ports.createGroupChat}, deleteGroupChat=${typeof ports.deleteGroupChat}, ` + `notifier=${typeof ports.notifier}`);
+    if (typeof logger4 !== "undefined" && logger4?.debug) {
+      logger4.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() {
@@ -4172,7 +4517,7 @@ class LarkCliInstance {
     if (this.status === "running")
       return;
     if (this.starting) {
-      logger5.warn(`[LarkCliInstance] start() 已在执行中，忽略重复调用`);
+      logger4.warn(`[LarkCliInstance] start() 已在执行中，忽略重复调用`);
       return;
     }
     this.starting = true;
@@ -4202,9 +4547,9 @@ class LarkCliInstance {
     if (!consumesCardAction)
       return;
     if (this.config.eventTypes?.length && !matchEventType(CARD_ACTION_EVENT_TYPE, this.config.eventTypes)) {
-      logger5.warn(`[LarkCliInstance] eventKeys 含 ${CARD_ACTION_EVENT_TYPE}，但 eventTypes=` + `${JSON.stringify(this.config.eventTypes)} 不含它 → 卡片点击会被**静默丢弃**。` + `请把 ${CARD_ACTION_EVENT_TYPE} 加进 eventTypes，或清空 eventTypes。`);
+      logger4.warn(`[LarkCliInstance] eventKeys 含 ${CARD_ACTION_EVENT_TYPE}，但 eventTypes=` + `${JSON.stringify(this.config.eventTypes)} 不含它 → 卡片点击会被**静默丢弃**。` + `请把 ${CARD_ACTION_EVENT_TYPE} 加进 eventTypes，或清空 eventTypes。`);
     }
-    logger5.info(`[LarkCliInstance] 已监听 ${CARD_ACTION_EVENT_TYPE}。` + `⚠️ 若点击卡片无反应，先确认飞书开发者后台「事件与回调 → 回调配置」已开启该事件。`);
+    logger4.info(`[LarkCliInstance] 已监听 ${CARD_ACTION_EVENT_TYPE}。` + `⚠️ 若点击卡片无反应，先确认飞书开发者后台「事件与回调 → 回调配置」已开启该事件。`);
   }
   spawnConsumeChild(command) {
     return spawn3("exec " + command, [], {
@@ -4244,14 +4589,14 @@ class LarkCliInstance {
     const conflicts = keys.filter((k) => busy.has(k));
     if (conflicts.length > 0) {
       const profile = this.config.profile;
-      logger5.warn(`[LarkCliInstance] eventKey 已被其它 consumer 占用（lark-cli 一个 key 只允许一个 consumer）：` + `${conflicts.join(", ")}。本 event-source 启动后可能 exit 2。` + `用 \`lark-cli${profile ? ` --profile ${profile}` : ""} event status\` 查看，必要时 \`event stop\`。`);
+      logger4.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`, {
+      const { stdout } = await execAsync(`lark-cli ${profileFlag}event status --json`, {
         timeout: 5000
       });
       const parsed = JSON.parse(stdout);
@@ -4295,16 +4640,16 @@ class LarkCliInstance {
     });
     const handleExit = (code, source) => {
       if (code !== 0 && code !== null) {
-        logger5.warn(`[LarkCliInstance] consume 子进程异常退出 code=${code} (${source}) cmd="${command}"`);
+        logger4.warn(`[LarkCliInstance] consume 子进程异常退出 code=${code} (${source}) cmd="${command}"`);
         this.status = "error";
       } else {
-        logger5.info(`[LarkCliInstance] consume 子进程已退出 code=${code} (${source}) cmd="${command}"`);
+        logger4.info(`[LarkCliInstance] consume 子进程已退出 code=${code} (${source}) cmd="${command}"`);
       }
       settle();
       queueMicrotask(() => {
         if (this.children.length > 0 && this.children.every((c) => !isChildAlive(c))) {
           if (this.status !== "error") {
-            logger5.warn(`[LarkCliInstance] 所有 consume 子进程都已退出，状态从 running 改为 stopped`);
+            logger4.warn(`[LarkCliInstance] 所有 consume 子进程都已退出，状态从 running 改为 stopped`);
             this.status = "stopped";
           }
         }
@@ -4313,12 +4658,12 @@ class LarkCliInstance {
     child.on("exit", (code) => handleExit(code, "exit"));
     child.on("close", (code) => handleExit(code, "close"));
     child.on("error", (error) => {
-      logger5.error(`[LarkCliInstance] consume 子进程 error: ${error.message}`);
+      logger4.error(`[LarkCliInstance] consume 子进程 error: ${error.message}`);
       this.status = "error";
       settle();
     });
     const timer = setTimeout(() => {
-      logger5.warn(`[LarkCliInstance] consume 子进程 ${CHILD_READY_TIMEOUT_MS}ms 内未见 ready marker: cmd="${command}"`);
+      logger4.warn(`[LarkCliInstance] consume 子进程 ${CHILD_READY_TIMEOUT_MS}ms 内未见 ready marker: cmd="${command}"`);
       settle();
     }, CHILD_READY_TIMEOUT_MS);
     ready.then(() => clearTimeout(timer));
@@ -4341,7 +4686,7 @@ class LarkCliInstance {
       try {
         child.kill("SIGTERM");
       } catch (error) {
-        logger5.warn(`[LarkCliInstance] Error sending SIGTERM to ${child.pid}: ${error}`);
+        logger4.warn(`[LarkCliInstance] Error sending SIGTERM to ${child.pid}: ${error}`);
       }
     }
     const allExited = Promise.all(children.map((child) => new Promise((resolve2) => {
@@ -4396,15 +4741,15 @@ class LarkCliInstance {
   }
   wireCardActionPorts() {
     if (this.cardActionPorts) {
-      logger5.debug("[LarkCliInstance] cardActionPorts 已由外部注入，跳过默认 cross-wire");
+      logger4.debug("[LarkCliInstance] cardActionPorts 已由外部注入，跳过默认 cross-wire");
       return;
     }
     const taskComponent = this.environment?.getComponent?.("task");
     if (!taskComponent?.getTask || !taskComponent?.updateTask) {
-      logger5.debug(`[LarkCliInstance] card.action.trigger 端口未注入：taskComponent 不可用` + `（getTask=${typeof taskComponent?.getTask}, updateTask=${typeof taskComponent?.updateTask}）。` + `卡片按钮点击会被跳过。`);
+      logger4.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;
+    const sharedNotifier = this.pluginInstances.get("LarkCliTaskNotifyPlugin")?.cardNotifier ?? this.pluginInstances.get("PerTaskGroupChatPlugin")?.cardNotifier ?? getSharedLarkCardNotifier();
     this.setCardActionPorts({
       getTask: async (id) => {
         const t = await taskComponent.getTask(id);
@@ -4428,9 +4773,119 @@ class LarkCliInstance {
       },
       createGroupChat: (opts) => createGroupChatViaLarkCli(opts),
       deleteGroupChat: (chatId, profile) => deleteGroupChatViaLarkCli(chatId, profile),
-      notifier: sharedNotifier ?? new LarkCardPatchNotifier
+      notifier: sharedNotifier ?? getSharedLarkCardNotifier(),
+      resolveSessionIdByTask: async (taskId) => {
+        const fromNotifier = sharedNotifier?.getSessionIdByTask?.(taskId);
+        if (fromNotifier)
+          return fromNotifier;
+        const tc = taskComponent;
+        try {
+          const rec = getSharedLarkCardStateStore().get(taskId);
+          if (rec?.sessionId)
+            return rec.sessionId;
+        } catch {}
+        return;
+      },
+      loadSessionActivity: createSessionActivityProbe({
+        getSession: async (sessionId) => {
+          const sc = this.environment?.getComponent?.("session");
+          if (!sc?.get)
+            return;
+          const s = await sc.get(sessionId);
+          if (!s)
+            return;
+          return {
+            ...typeof s.messageCount === "number" ? { messageCount: s.messageCount } : {},
+            ...typeof s.updatedAt === "number" ? { updatedAt: s.updatedAt } : {}
+          };
+        },
+        getLastMessage: async (sessionId) => {
+          const sc = this.environment?.getComponent?.("session");
+          if (!sc?.getMessages)
+            return;
+          const tail = await sc.getMessages(sessionId, { offset: -1, limit: 1 });
+          return toActivityMessage(tail?.[tail.length - 1]);
+        },
+        getLifecycle: (sessionId) => {
+          const bgTasks = taskComponent.getBackgroundTaskManager?.()?.listTasks?.() ?? [];
+          const hit = bgTasks.find((t) => t?.subSessionId === sessionId);
+          return mapBgTaskStatusToSessionLifecycle(hit?.status);
+        }
+      }),
+      loadSubSessionActivity: createActivityProbe({
+        listBackgroundTasks: () => taskComponent.getBackgroundTaskManager?.()?.listTasks?.(),
+        getSubSessionActivity: (bgId) => taskComponent.getBackgroundTaskManager?.()?.getSubSessionActivity?.(bgId),
+        getLastMessage: async (subSessionId) => {
+          const sessionComponent = this.environment?.getComponent?.("session");
+          if (!sessionComponent?.getMessages)
+            return;
+          const tail = await sessionComponent.getMessages(subSessionId, {
+            offset: -1,
+            limit: 1
+          });
+          return toActivityMessage(tail?.[tail.length - 1]);
+        },
+        isTerminalTask: async (taskId) => {
+          const t = await taskComponent.getTask?.(taskId);
+          const status = t?.status;
+          return status === "completed" || status === "cancelled" || status === "failed" || status === "archived";
+        }
+      }),
+      loadSessionMessages: async (sessionId, limit) => {
+        const sc = this.environment?.getComponent?.("session");
+        if (!sc?.getMessages)
+          return;
+        const n = typeof limit === "number" && limit > 0 ? limit : RECENT_MESSAGE_LIMIT;
+        const tail = await sc.getMessages(sessionId, {
+          offset: -1,
+          limit: n * 3
+        });
+        const calls = extractToolCallsFromMessages(tail);
+        return calls.slice(-n);
+      },
+      attachGroupSession: async (args) => {
+        const sessionComponent = this.environment?.getComponent?.("session");
+        if (typeof sessionComponent?.attachGroupSession !== "function") {
+          logger4.warn(`[LarkCliInstance] attachGroupSession 跳过：sessionComponent.attachGroupSession 不可用`);
+          return;
+        }
+        await sessionComponent.attachGroupSession(args);
+        logger4.info(`[LarkCliInstance] 群 session 已初始化：${args.chatId} ← ${args.originSessionId}` + `（独立会话 + 1 条 user 事件背景提示）`);
+      },
+      findGroupChatForSession: async (sessionId) => {
+        const sessionComponent = this.environment?.getComponent?.("session");
+        if (typeof sessionComponent?.findGroupChatForSession !== "function") {
+          logger4.warn(`[LarkCliInstance] findGroupChatForSession 跳过：sessionComponent 不支持`);
+          return;
+        }
+        return await sessionComponent.findGroupChatForSession(sessionId);
+      },
+      detachGroupSession: async (chatId) => {
+        const sessionComponent = this.environment?.getComponent?.("session");
+        if (typeof sessionComponent?.detachGroupSession !== "function") {
+          logger4.warn(`[LarkCliInstance] detachGroupSession 跳过：sessionComponent.detachGroupSession 不可用`);
+          return;
+        }
+        const r = await sessionComponent.detachGroupSession(chatId);
+        if (!r.ok) {
+          logger4.warn(`[LarkCliInstance] detachGroupSession 失败: ${chatId}`);
+          return;
+        }
+        logger4.info(`[LarkCliInstance] 群 session 已标记解散：${chatId}`);
+      },
+      getSessionTitle: async (sessionId) => {
+        const sessionComponent = this.environment?.getComponent?.("session");
+        if (typeof sessionComponent?.get !== "function")
+          return;
+        try {
+          const s = await sessionComponent.get(sessionId);
+          return typeof s?.title === "string" && s.title.trim() ? s.title.trim() : undefined;
+        } catch {
+          return;
+        }
+      }
     });
-    logger5.info(`[LarkCliInstance] card.action.trigger 端口已注入` + `（notifier ${sharedNotifier ? "复用插件共享实例" : "新建实例"}）`);
+    logger4.info(`[LarkCliInstance] card.action.trigger 端口已注入` + `（notifier ${sharedNotifier ? "复用插件共享实例" : "新建实例"}）`);
   }
   getPluginHookPoints(plugin) {
     if (Array.isArray(plugin.hooks)) {
@@ -4589,6 +5044,12 @@ class LarkCliInstance {
       getTask: taskComponent?.getTask ? (id) => taskComponent.getTask(id) : undefined
     };
     plugin.setCardRoutingPorts({ ...this.cardRoutingPorts });
+    if (typeof plugin === "object" && "syncGroupCardFromOriginFn" in plugin) {
+      const sessionComponent = this.environment?.getComponent?.("session");
+      if (typeof sessionComponent?.findGroupChatForSession === "function") {
+        plugin.syncGroupCardFromOriginFn = (sid) => sessionComponent.findGroupChatForSession(sid);
+      }
+    }
   }
   injectSessionComponent(plugin) {
     if (typeof plugin.setSessionComponent !== "function") {
@@ -4628,7 +5089,7 @@ class LarkCliInstance {
       }
       return null;
     } catch (err) {
-      logger5.warn(`[LarkCliInstance] resolveChatTaskBinding failed for chatId=${chatId}: ${err}. ` + `群消息将不会注入 parentTaskId。`);
+      logger4.warn(`[LarkCliInstance] resolveChatTaskBinding failed for chatId=${chatId}: ${err}. ` + `群消息将不会注入 parentTaskId。`);
       return null;
     }
   }
@@ -4650,7 +5111,7 @@ class LarkCliInstance {
   processStreamWith(data, buffer, opts = {}) {
     buffer.value += data;
     if (buffer.value.length > 2 * 1024 * 1024) {
-      logger5.warn(`[LarkCliInstance] stream 行缓冲超过 2MB 仍无换行，丢弃（疑似非 NDJSON 输出）`);
+      logger4.warn(`[LarkCliInstance] stream 行缓冲超过 2MB 仍无换行，丢弃（疑似非 NDJSON 输出）`);
       buffer.value = "";
       return;
     }
@@ -4686,12 +5147,12 @@ class LarkCliInstance {
       const now = Date.now();
       const lastShared = LarkCliInstance.SHARED_SEEN.get(dedupKey);
       if (lastShared !== undefined && now - lastShared < LarkCliInstance.SHARED_MSG_TTL_MS) {
-        logger5.warn(`[LarkCliInstance] duplicate lark-cli event suppressed across instances (event_id=${dedupKey}, ` + `lastSeen=${now - lastShared}ms ago). ` + `Task #4137: SHARED_SEEN 跨实例去重。`);
+        logger4.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) {
-        logger5.warn(`[LarkCliInstance] duplicate lark-cli event suppressed (event_id=${dedupKey}, ` + `lastSeen=${now - last}ms ago). ` + `Task #3977/3978: 防止同一飞书事件触发两次任务创建。`);
+        logger4.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);
@@ -4750,13 +5211,17 @@ class LarkCliInstance {
         ...rawEvent,
         profile: this.config.profile,
         eventSourceId: this.config.id,
-        channelPromptMode: this.config.channelPromptMode ?? "lean"
+        channelPromptMode: this.config.channelPromptMode ?? "lean",
+        statusNotifications: this.config.statusNotifications === true
       };
       const { metadata, replyChannel, recommendedAction } = extractMetadata(enrichedEvent, eventType);
       const channelSystemPrompt = this.getChannelSystemPrompt();
       if (channelSystemPrompt !== undefined) {
         metadata.systemPrompt = channelSystemPrompt;
       }
+      if (this.config.extendTools?.length) {
+        metadata.extendTools = [...this.config.extendTools];
+      }
       failureReplyChannel = replyChannel;
       const commandText = isCardAction ? undefined : extractCommandText(enrichedEvent);
       const parentTaskId = isCardAction ? null : await this.resolveChatTaskBinding(metadata?.chatId);
@@ -4785,8 +5250,9 @@ class LarkCliInstance {
           console.error(`[LarkCliInstance] emitTriggerEvent failed: ${err instanceof Error ? err.message : String(err)}`);
         }
       }
+      const slimRawData = buildSlimRawData(rawEvent);
       const message = JSON.stringify({
-        rawData,
+        rawData: slimRawData,
         recommendedAction,
         ...triggerEventId ? { triggerEventId } : {}
       });
@@ -4810,6 +5276,7 @@ class LarkCliInstance {
           replyChannel,
           agent,
           ...channelSystemPrompt !== undefined ? { systemPrompt: channelSystemPrompt } : {},
+          ...this.config.extendTools?.length ? { extendTools: [...this.config.extendTools] } : {},
           parentTaskId: parentTaskId ?? undefined,
           ...triggerEventId ? { triggerEventId } : {},
           traceContext: eventTraceContext
@@ -4886,11 +5353,11 @@ class LarkCliInstance {
       const chatId = event.chat_id || "";
       const operatorId = event.operator_id?.open_id ?? event.operator_id ?? undefined;
       if (!token || !messageId || !chatId) {
-        logger5.warn(`[LarkCliInstance] handleCardActionEvent: missing token/messageId/chatId, skip`);
+        logger4.warn(`[LarkCliInstance] handleCardActionEvent: missing token/messageId/chatId, skip`);
         return;
       }
       if (!this.cardActionPorts) {
-        logger5.warn(`[LarkCliInstance] handleCardActionEvent: cardActionPorts 未注入，` + `card.action.trigger 事件被跳过。` + `调 instance.setCardActionPorts({getTask, updateTaskContext, createGroupChat, deleteGroupChat, notifier}) 注入。`);
+        logger4.warn(`[LarkCliInstance] handleCardActionEvent: cardActionPorts 未注入，` + `card.action.trigger 事件被跳过。` + `调 instance.setCardActionPorts({getTask, updateTaskContext, createGroupChat, deleteGroupChat, notifier}) 注入。`);
         return;
       }
       const result = await handleCardAction({
@@ -4903,12 +5370,17 @@ class LarkCliInstance {
       }, this.cardActionPorts);
       if (result.ok && result.cardUpdate) {
         const patch = this.cardActionPorts.patchByToken ?? patchCardByLarkCli;
-        await patch(token, result.cardUpdate, profile);
+        try {
+          await patch(token, result.cardUpdate, profile);
+          logger4.info(`[LarkCliInstance] 卡片 patch 成功: messageId=${messageId} action=${String(result.action)} chatId=${chatId}`);
+        } catch (patchErr) {
+          logger4.warn(`[LarkCliInstance] 卡片 patch 失败: messageId=${messageId} ` + `action=${String(result.action)} error=${patchErr.message}` + `（token 30min 有效，过期即失败——需用新卡重试）`);
+        }
       } else {
-        logger5.warn(`[LarkCliInstance] handleCardActionEvent failed: ${result.error ?? "unknown"}`);
+        logger4.warn(`[LarkCliInstance] handleCardActionEvent failed: ${result.error ?? "unknown"}`);
       }
     } catch (err) {
-      logger5.error(`[LarkCliInstance] handleCardActionEvent error: ${err.message}`);
+      logger4.error(`[LarkCliInstance] handleCardActionEvent error: ${err.message}`);
     }
   }
   isCommandCardActionEvent(event) {
@@ -5024,7 +5496,7 @@ class LarkCliInstance {
       }
       await this.sendLarkText(output.text, profile, messageId, chatId);
     } catch (err) {
-      logger5.error(`[LarkCliInstance] handleCommandMessage error: ${err.message}`);
+      logger4.error(`[LarkCliInstance] handleCommandMessage error: ${err.message}`);
       try {
         const card = renderTextCard("⚠️ 命令执行异常", `命令处理时发生异常：${err.message}`);
         await this.sendLarkCard(card, profile, messageId, chatId);
@@ -5314,7 +5786,7 @@ var larkCliHandler = {
   },
   async emitTriggerEvent(payload, store) {
     const eventId = await store.insertTriggerEvent(payload, "lark-cli");
-    logger5.info(`[larkCliHandler] emitTriggerEvent: id=${eventId}`, {
+    logger4.info(`[larkCliHandler] emitTriggerEvent: id=${eventId}`, {
       chatId: payload.metadata?.chatId,
       senderId: payload.senderId
     });
@@ -5329,7 +5801,7 @@ var larkCliHandler = {
     try {
       const result = await runner.run(command);
       if (result.code !== 0) {
-        logger5.error(`[larkCliHandler] replyMessage non-zero exit`, {
+        logger4.error(`[larkCliHandler] replyMessage non-zero exit`, {
           code: result.code,
           stderr: result.stderr
         });
@@ -5343,7 +5815,7 @@ var larkCliHandler = {
       return { success: true, messageId: replyMessageId };
     } catch (err) {
       const errMsg = err instanceof Error ? err.message : String(err);
-      logger5.error(`[larkCliHandler] replyMessage spawn error`, { error: errMsg });
+      logger4.error(`[larkCliHandler] replyMessage spawn error`, { error: errMsg });
       return { success: false, error: errMsg };
     }
   },
@@ -5392,7 +5864,7 @@ ${headline}
 - **chatId: ${chatId || "(缺失)"}**  ← 关键！必须发到这里
 - **messageId: ${messageId || "(缺失)"}**  ← ${messageId ? "reply 这条，保持话题线索" : "无触发消息，用 +messages-send"}
 - sender: ${senderId || "(未知)"}
-${input.notifyEvent.subSessionId ? `- 子 session: ${input.notifyEvent.subSessionId}  ← 如需续跑：delegate_task(existingSubSessionId=<此值>, prompt=<新要求>)
+${input.notifyEvent.subSessionId ? `- 子 session: ${input.notifyEvent.subSessionId}  ← 如需续跑：delegate_task(sub_session_id="${input.notifyEvent.subSessionId}", prompt=<新要求>)
 ` : ""}${profile ? `- profile: ${profile}  ← 调用 lark-cli 必须带 --profile
 ` : ""}
 ### 系统回执（rule-based 直发）
@@ -5447,11 +5919,11 @@ 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 });
-    logger5.debug(`patchCardByLarkCli ok: ${stdout?.slice(0, 200)}`);
+    const { stdout } = await execAsync(cmd, { timeout: 30000 });
+    logger4.debug(`patchCardByLarkCli ok: ${stdout?.slice(0, 200)}`);
   } catch (err) {
     const msg = err.message;
-    logger5.error(`patchCardByLarkCli failed: ${msg}`);
+    logger4.error(`patchCardByLarkCli failed: ${msg}`);
     throw new Error(`卡片刷新失败：${msg}`);
   }
 }
@@ -5467,4 +5939,4 @@ function getBuiltInHandler(type) {
   return builtInHandlers.find((h) => h.type === type);
 }
 
-export { TimerInstance, timerHandler, buildDefaultBountyIMSystemPrompt, resolveBountyIMSystemPrompt, BountyIMInstance, bountyIMHandler, bountyCliHandler, sanitizeWecomFrame, WECOM_CLI_ES_TYPE, WECOM_CHAT_ID_PREFIX, WECOM_WS_DEFAULT_URL, readWecomCliConfig, WECOM_CREDENTIALS_DEFAULT_PATH, readWecomCredentialsFile, resolveWecomCredentials, buildWecomReplyChannel, parseWecomFrame, WECOM_CHANNEL_PROMPT_SECTION_TITLE, buildWecomChannelSystemPrompt, buildWecomNotifyPrompt, resolveWecomBinary, probeCommandBinary, wecomCliHandler, FALLBACK_MODEL_ACTION_NS, FALLBACK_MODEL_ACTIONS, isFallbackModelCard, renderTextCard, renderFallbackModelCard, DEFAULT_CONFIG_PATH, readFallbackModelList, readRawFallbackModelArray, writeFallbackModelList, fallbackModelCommand, listCommand, resolveEsFilePath, esCommand, COMMAND_PREFIX, isCommandMessage, extractCommandInvocation, CommandRegistry, getGlobalCommandRegistry, handleCommandMessage, isCommandCardAction, translateCardActionToCommand, handleCommandCardAction, buildLarkRecommendedAction, LARK_CHANNEL_PROMPT_SECTION_TITLE, LARK_PROMPT_LENGTH_BUDGET, buildLarkChannelSystemPrompt, resolveLarkChannelSystemPrompt, extractMetadata, LarkCliInstance, renderRuleNoticeSection, extractCommandText, larkCliHandler, patchCardByLarkCli, builtInHandlers, getBuiltInHandler };
+export { TimerInstance, timerHandler, buildDefaultBountyIMSystemPrompt, resolveBountyIMSystemPrompt, BountyIMInstance, bountyIMHandler, bountyCliHandler, sanitizeWecomFrame, WECOM_CLI_ES_TYPE, WECOM_CHAT_ID_PREFIX, WECOM_WS_DEFAULT_URL, readWecomCliConfig, WECOM_CREDENTIALS_DEFAULT_PATH, readWecomCredentialsFile, resolveWecomCredentials, buildWecomReplyChannel, parseWecomFrame, WECOM_CHANNEL_PROMPT_SECTION_TITLE, buildWecomChannelSystemPrompt, buildWecomNotifyPrompt, resolveWecomBinary, probeCommandBinary, wecomCliHandler, FALLBACK_MODEL_ACTION_NS, FALLBACK_MODEL_ACTIONS, isFallbackModelCard, renderTextCard, renderFallbackModelCard, DEFAULT_CONFIG_PATH, readFallbackModelList, readRawFallbackModelArray, writeFallbackModelList, fallbackModelCommand, listCommand, resolveEsFilePath, esCommand, COMMAND_PREFIX, isCommandMessage, extractCommandInvocation, CommandRegistry, getGlobalCommandRegistry, handleCommandMessage, isCommandCardAction, translateCardActionToCommand, handleCommandCardAction, buildSlimRawData, buildLarkRecommendedAction, LARK_CHANNEL_PROMPT_SECTION_TITLE, LARK_PROMPT_LENGTH_BUDGET, buildLarkChannelSystemPrompt, resolveLarkChannelSystemPrompt, extractMetadata, LarkCliInstance, renderRuleNoticeSection, extractCommandText, larkCliHandler, patchCardByLarkCli, builtInHandlers, getBuiltInHandler };