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

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

@@ -1,20 +1,18 @@
 import {
-  WecomCardActionKey,
-  buildWecomButtonInteractionCard,
-  buildWecomTextNoticeCard,
   sendWecomReply,
   sendWecomTemplateCard
-} from "./roy-agent-core-m3vjepzz.js";
+} from "./roy-agent-core-h1e1fm9b.js";
+import {
+  WecomCardActionKey,
+  buildWecomButtonInteractionCard,
+  buildWecomTextNoticeCard
+} from "./roy-agent-core-c4ec7k0p.js";
 import {
   getSharedEventStore
-} from "./roy-agent-core-na18zwj0.js";
+} from "./roy-agent-core-4t3yskp8.js";
 import {
   WORKFLOW_EXTRACT_PROMPT
-} from "./roy-agent-core-9vxh6f8h.js";
-import {
-  createCompatibleDatabase,
-  init_sqlite_task_store
-} from "./roy-agent-core-ezvpreqz.js";
+} from "./roy-agent-core-y7fqtzk2.js";
 import {
   TaskHookPoints
 } from "./roy-agent-core-1pg0fepg.js";
@@ -27,32 +25,43 @@ import {
   renderCandidateKey,
   renderCandidateValue,
   writeDecisionHint
-} from "./roy-agent-core-tr3ep81v.js";
+} from "./roy-agent-core-d6zdbgtc.js";
 import {
   LarkCardPatchNotifier,
+  buildSessionCard,
+  buildTaskCard,
+  createLarkCardStateStore,
+  getSharedLarkCardNotifier,
   humanizeValue
-} from "./roy-agent-core-7dd0s3xb.js";
+} from "./roy-agent-core-shb1qsyg.js";
+import {
+  RECENT_MESSAGE_LIMIT
+} from "./roy-agent-core-418zc9ha.js";
+import {
+  createCompatibleDatabase,
+  init_sqlite_task_store
+} from "./roy-agent-core-6k8mb7zx.js";
 import {
   validateWorkflowDefinition
-} from "./roy-agent-core-1v4g0d4x.js";
+} from "./roy-agent-core-rm7seqwb.js";
 import {
   enqueueToAddFakeUserMessage
-} from "./roy-agent-core-h21gngxf.js";
+} from "./roy-agent-core-7yh5wps0.js";
 import {
   BasePlugin
 } from "./roy-agent-core-az13yzmc.js";
 import {
   init_context
-} from "./roy-agent-core-qqaak24r.js";
+} from "./roy-agent-core-tkpp1ba0.js";
 import {
   getEnvContextOrEmpty,
   init_env_context
-} 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,
   init_logger
@@ -321,11 +330,11 @@ ${prompt}`;
     }
     if (!this._workflowRepo) {
       try {
-        const sqlite = await import("./roy-agent-core-dc9zq75z.js");
+        const sqlite = await import("./roy-agent-core-0crmsc12.js");
         this.ensureDataDir();
         const db = sqlite.getDatabase();
         sqlite.initializeTables();
-        const { WorkflowRepository } = await import("./roy-agent-core-xvt7kf7p.js");
+        const { WorkflowRepository } = await import("./roy-agent-core-w9ryeg2p.js");
         this._workflowRepo = new WorkflowRepository(db);
         return this._workflowRepo;
       } catch {
@@ -1684,178 +1693,10 @@ init_decorator();
 init_logger();
 init_context();
 
-// src/env/task/plugins/lark-card-state-store.ts
+// src/env/task/plugins/lark-card-action-handler.ts
 init_logger();
-init_sqlite_task_store();
-import { join } from "path";
-var logger6 = createLogger("lark-cli:card-state");
-
-class MemoryLarkCardStateStore {
-  records = new Map;
-  upsert(state) {
-    this.records.set(state.taskId, { ...state });
-  }
-  get(taskId) {
-    const r = this.records.get(taskId);
-    return r ? { ...r } : undefined;
-  }
-  list() {
-    return [...this.records.values()].map((r) => ({ ...r }));
-  }
-  markPinned(taskId, pinned) {
-    const r = this.records.get(taskId);
-    if (!r)
-      return;
-    r.pinned = pinned;
-    r.updatedAt = Date.now();
-  }
-  markPaused(taskId) {
-    const r = this.records.get(taskId);
-    if (!r)
-      return;
-    r.status = "paused";
-    r.updatedAt = Date.now();
-  }
-  markReopened(taskId) {
-    const r = this.records.get(taskId);
-    if (!r)
-      return;
-    r.status = "open";
-    delete r.closedAt;
-    r.updatedAt = Date.now();
-  }
-  markClosed(taskId) {
-    const r = this.records.get(taskId);
-    if (!r)
-      return;
-    const now = Date.now();
-    r.status = "closed";
-    r.closedAt = now;
-    r.updatedAt = now;
-  }
-  delete(taskId) {
-    this.records.delete(taskId);
-  }
-  close() {
-    this.records.clear();
-  }
-}
-function rowToState(row) {
-  const state = {
-    taskId: row.task_id,
-    messageId: row.message_id,
-    chatId: row.chat_id,
-    pinned: row.pinned === 1,
-    status: row.status ?? "open",
-    createdAt: row.created_at,
-    updatedAt: row.updated_at
-  };
-  if (row.profile)
-    state.profile = row.profile;
-  if (row.closed_at !== null && row.closed_at !== undefined) {
-    state.closedAt = row.closed_at;
-  }
-  if (row.timeline)
-    state.timeline = row.timeline;
-  return state;
-}
-
-class SqliteLarkCardStateStore {
-  db;
-  constructor(dbPath) {
-    if (dbPath !== ":memory:") {
-      const { mkdirSync } = __require("fs");
-      const dir = __require("path").dirname(dbPath);
-      try {
-        mkdirSync(dir, { recursive: true });
-      } catch {}
-    }
-    this.db = createCompatibleDatabase(dbPath);
-    try {
-      this.db.run("PRAGMA journal_mode = WAL");
-      this.db.run("PRAGMA busy_timeout = 5000");
-      this.db.run("PRAGMA synchronous = NORMAL");
-    } catch {}
-    this.db.run(`
-      CREATE TABLE IF NOT EXISTS lark_card (
-        task_id INTEGER PRIMARY KEY,
-        message_id TEXT NOT NULL,
-        chat_id TEXT NOT NULL,
-        profile TEXT,
-        pinned INTEGER NOT NULL DEFAULT 0,
-        status TEXT NOT NULL DEFAULT 'open',
-        created_at INTEGER NOT NULL,
-        updated_at INTEGER NOT NULL,
-        closed_at INTEGER,
-        timeline TEXT
-      )
-    `);
-    try {
-      this.db.run("ALTER TABLE lark_card ADD COLUMN timeline TEXT");
-    } catch {}
-    this.db.run("CREATE INDEX IF NOT EXISTS idx_lark_card_status ON lark_card(status)");
-  }
-  upsert(state) {
-    this.db.prepare(`INSERT INTO lark_card
-          (task_id, message_id, chat_id, profile, pinned, status, created_at, updated_at, closed_at, timeline)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-         ON CONFLICT(task_id) DO UPDATE SET
-           message_id = excluded.message_id,
-           chat_id    = excluded.chat_id,
-           profile    = excluded.profile,
-           pinned     = excluded.pinned,
-           status     = excluded.status,
-           updated_at = excluded.updated_at,
-           closed_at  = excluded.closed_at,
-           timeline   = excluded.timeline`).run(state.taskId, state.messageId, state.chatId, state.profile ?? null, state.pinned ? 1 : 0, state.status, state.createdAt, state.updatedAt, state.closedAt ?? null, state.timeline ?? null);
-  }
-  get(taskId) {
-    const row = this.db.prepare("SELECT * FROM lark_card WHERE task_id = ?").get(taskId);
-    return row ? rowToState(row) : undefined;
-  }
-  list() {
-    const rows = this.db.prepare("SELECT * FROM lark_card ORDER BY task_id ASC").all();
-    return rows.map(rowToState);
-  }
-  markPinned(taskId, pinned) {
-    this.db.prepare("UPDATE lark_card SET pinned = ?, updated_at = ? WHERE task_id = ?").run(pinned ? 1 : 0, Date.now(), taskId);
-  }
-  markPaused(taskId) {
-    this.db.prepare("UPDATE lark_card SET status = 'paused', updated_at = ? WHERE task_id = ?").run(Date.now(), taskId);
-  }
-  markReopened(taskId) {
-    this.db.prepare("UPDATE lark_card SET status = 'open', closed_at = NULL, updated_at = ? WHERE task_id = ?").run(Date.now(), taskId);
-  }
-  markClosed(taskId) {
-    const now = Date.now();
-    this.db.prepare("UPDATE lark_card SET status = 'closed', closed_at = ?, updated_at = ? WHERE task_id = ?").run(now, now, taskId);
-  }
-  delete(taskId) {
-    this.db.prepare("DELETE FROM lark_card WHERE task_id = ?").run(taskId);
-  }
-  close() {
-    try {
-      this.db.close?.();
-    } catch {}
-  }
-}
-function getDefaultLarkCardDbPath() {
-  const home = process.env.HOME || process.env.USERPROFILE || "/tmp";
-  return join(home, ".local", "share", "roy-agent", "lark-cards.db");
-}
-function createLarkCardStateStore(dbPath) {
-  const isTestEnv = "BUN_TEST_WORKER_ID" in process.env;
-  if (!dbPath && !process.env.ROY_AGENT_LARK_CARD_DB && isTestEnv) {
-    return new MemoryLarkCardStateStore;
-  }
-  const path = dbPath ?? process.env.ROY_AGENT_LARK_CARD_DB ?? getDefaultLarkCardDbPath();
-  try {
-    return new SqliteLarkCardStateStore(path);
-  } catch (err) {
-    logger6.warn(`LarkCardStateStore: sqlite unavailable at ${path} (${err.message}) ` + `→ falling back to in-memory (卡片仍可发，但重启后无法 patch 旧卡)`);
-    return new MemoryLarkCardStateStore;
-  }
-}
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
 
 // src/env/task/plugins/card-chat-routing.ts
 var CTX_FIELD_LARK_PER_TASK_CHAT_ID = "larkPerTaskChatId";
@@ -1933,16 +1774,781 @@ function decideCardChatTarget(input) {
   };
 }
 
+// src/env/task/plugins/card-subject.ts
+function pickCardSubject(value) {
+  const rawSession = value?.sessionId;
+  const sessionId = typeof rawSession === "string" && rawSession.trim() ? rawSession : undefined;
+  if (!sessionId)
+    return;
+  const rawTask = value?.taskId;
+  const taskId = typeof rawTask === "number" ? rawTask : typeof rawTask === "string" && rawTask.trim() ? Number(rawTask.trim()) : undefined;
+  return {
+    sessionId,
+    ...taskId !== undefined && Number.isSafeInteger(taskId) && taskId > 0 ? { taskId } : {}
+  };
+}
+
+// src/env/task/plugins/lark-card-action-handler.ts
+var logger6 = createLogger("lark-card-action-handler");
+var execAsync = promisify(exec);
+var KNOWN_CARD_ACTIONS = new Set([
+  "create_group",
+  "disband_group",
+  "refresh_activity"
+]);
+function isCardActionName(v) {
+  return typeof v === "string" && KNOWN_CARD_ACTIONS.has(v);
+}
+var ACTION_SUBJECT_FIELD = {
+  create_group: "taskId or sessionId",
+  disband_group: "taskId or sessionId",
+  refresh_activity: "sessionId"
+};
+function validateCardActionValue(raw) {
+  const action = raw.action;
+  if (!isCardActionName(action)) {
+    return { ok: false, action: String(action), error: `Unknown action: ${String(action)}` };
+  }
+  const requiredField = ACTION_SUBJECT_FIELD[action];
+  if (action === "create_group" || action === "disband_group") {
+    const rawTaskId = raw.taskId;
+    const rawSessionId2 = typeof raw.sessionId === "string" ? raw.sessionId.trim() : "";
+    if (rawTaskId === undefined || rawTaskId === null || rawTaskId === "") {
+      if (rawSessionId2) {
+        return { ok: true, action, sessionId: rawSessionId2 };
+      }
+      return {
+        ok: false,
+        action,
+        error: `Missing required field: ${requiredField} (action=${action})`
+      };
+    }
+    const taskId = typeof rawTaskId === "number" ? rawTaskId : typeof rawTaskId === "string" ? parseInt(rawTaskId, 10) : Number.NaN;
+    if (!Number.isFinite(taskId) || Number.isNaN(taskId) || taskId <= 0) {
+      return { ok: false, action, error: `Invalid taskId: ${String(rawTaskId)}` };
+    }
+    return {
+      ok: true,
+      action,
+      taskId,
+      ...rawSessionId2 ? { sessionId: rawSessionId2 } : {}
+    };
+  }
+  const rawSessionId = raw.sessionId;
+  const sessionId = typeof rawSessionId === "string" ? rawSessionId.trim() : "";
+  if (!sessionId) {
+    return {
+      ok: false,
+      action,
+      error: `Missing required field: ${requiredField} (action=${action})`
+    };
+  }
+  return { ok: true, action, sessionId };
+}
+function extractTargetSessionId(context) {
+  if (!context)
+    return;
+  try {
+    const parsed = JSON.parse(context);
+    for (const key of ["subSessionId", "sessionId"]) {
+      const v = parsed[key];
+      if (typeof v === "string" && v.trim().length > 0)
+        return v.trim();
+    }
+    return;
+  } catch {
+    return;
+  }
+}
+async function resolveGroupLinkTargetSessionId(event, ports, taskId, taskContext) {
+  const fromCard = event.actionValue?.sessionId;
+  if (typeof fromCard === "string" && fromCard.trim().length > 0) {
+    return { sessionId: fromCard.trim(), source: "card" };
+  }
+  const fromContext = extractTargetSessionId(taskContext);
+  if (fromContext) {
+    return { sessionId: fromContext, source: "task.context" };
+  }
+  if (ports.resolveSessionIdByTask) {
+    try {
+      const resolved = await ports.resolveSessionIdByTask(taskId);
+      if (typeof resolved === "string" && resolved.trim().length > 0) {
+        return { sessionId: resolved.trim(), source: "resolveSessionIdByTask" };
+      }
+    } catch (err) {
+      logger6.warn(`resolveGroupLinkTargetSessionId: resolveSessionIdByTask(${taskId}) 失败（继续跳过 link）: ` + `${err.message}`);
+    }
+  }
+  return { sessionId: undefined, source: "none" };
+}
+async function attachGroupSessionForTask(event, ports, taskId, chatId, taskContext) {
+  if (!ports.attachGroupSession)
+    return;
+  const { sessionId: targetSessionId, source } = await resolveGroupLinkTargetSessionId(event, ports, taskId, taskContext);
+  if (!targetSessionId) {
+    logger6.warn(`attachGroupSessionForTask: 取不到目标 session（card/context/resolveSessionIdByTask 全空），` + `跳过关联 —— 群 ${chatId} 将是独立空会话（无背景提示）`);
+    return;
+  }
+  try {
+    await ports.attachGroupSession({
+      chatId,
+      originSessionId: targetSessionId,
+      title: `Lark Chat ${chatId}`
+    });
+    logger6.info(`attachGroupSessionForTask: ${chatId} ← ${targetSessionId}` + `（来源=${source}，已注入 1 条 user 事件作为背景提示）`);
+  } catch (err) {
+    logger6.warn(`attachGroupSessionForTask: attach(${chatId} ← ${targetSessionId}) 失败（不阻断建群）: ` + `${err.message}`);
+  }
+}
+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 rawAction = event.actionValue.action;
+  if (!isCardActionName(rawAction)) {
+    return { ok: false, action: String(rawAction), error: `Unknown action: ${String(rawAction)}` };
+  }
+  if (rawAction === "refresh_activity") {
+    return await handleRefreshSessionCard(event, ports);
+  }
+  const validation = validateCardActionValue(event.actionValue);
+  if (!validation.ok) {
+    const failed = validation;
+    return { ok: false, action: rawAction, error: failed.error };
+  }
+  if (validation.action === "refresh_activity") {
+    return await handleRefreshSessionCard(event, ports);
+  }
+  const groupValidation = validation;
+  const action = groupValidation.action;
+  const taskId = groupValidation.taskId;
+  const subjectSessionId = groupValidation.sessionId;
+  const inflightSubject = event.messageId || (taskId !== undefined ? String(taskId) : subjectSessionId) || "-";
+  const inflightKey = `${event.profile ?? "-"}:${inflightSubject}:${action}`;
+  const inflight = cardActionInflight.get(inflightKey);
+  if (inflight) {
+    logger6.warn(`handleCardAction: ${inflightKey} 已有同操作在处理中（疑似用户重复点击），本次忽略。`);
+    return { ok: false, action, error: `重复点击：${inflightKey} 正在处理中，已忽略` };
+  }
+  const pending = taskId !== undefined ? handleCardActionInner(event, ports, action, taskId) : handleGroupActionSessionOnly(event, ports, action, subjectSessionId);
+  cardActionInflight.set(inflightKey, pending);
+  try {
+    return await pending;
+  } finally {
+    cardActionInflight.delete(inflightKey);
+  }
+}
+async function handleRefreshSessionCard(event, ports) {
+  const action = "refresh_activity";
+  let subject = pickCardSubject(event.actionValue);
+  if (!subject) {
+    const legacyTaskId = parseTaskIdLoose(event.actionValue.taskId);
+    if (legacyTaskId !== undefined) {
+      let resolved;
+      try {
+        resolved = await ports.resolveSessionIdByTask?.(legacyTaskId);
+      } catch {
+        resolved = undefined;
+      }
+      if (resolved) {
+        subject = { sessionId: resolved, taskId: legacyTaskId };
+        logger6.info(`handleCardAction: 旧 task 卡 #${legacyTaskId} 无 sessionId，` + `反查得到 ${resolved}（按 session 主键刷新）`);
+      }
+    }
+  }
+  if (!subject) {
+    return {
+      ok: false,
+      action,
+      error: `Missing required field: sessionId (action=${action}; sessionId is required ` + `as the card primary key, got taskId=${String(event.actionValue.taskId)})`
+    };
+  }
+  const canRenderSessionCard = ports.loadSessionActivity !== undefined || typeof ports.notifier?.buildSessionCardWithActivity === "function";
+  if (!canRenderSessionCard && ports.loadSubSessionActivity && subject.taskId !== undefined) {
+    const legacyTask = await ports.getTask?.(subject.taskId);
+    if (legacyTask) {
+      logger6.info(`handleCardAction: 旧装配点（无 loadSessionActivity）—— task #${subject.taskId} ` + `刷新回落到 task 主键路径（保留 #5360 之前的可达性）`);
+      return await handleRefreshActivity(event, ports, legacyTask, subject.taskId);
+    }
+  }
+  if (!canRenderSessionCard && !ports.refreshSessionCard) {
+    logger6.warn(`handleCardAction: refresh_activity 已通过 sessionId 校验（sessionId=${subject.sessionId}），` + `但既没有 ports.refreshSessionCard，也没有 loadSessionActivity / ` + `buildSessionCardWithActivity —— 无 session 卡渲染实现。`);
+    return {
+      ok: false,
+      action,
+      error: `refresh_activity not available: no session card renderer injected ` + `(sessionId=${subject.sessionId}; ports.refreshSessionCard / loadSessionActivity both missing)`
+    };
+  }
+  if (ports.refreshSessionCard) {
+    const inflightKey = `${event.profile ?? "-"}:${event.messageId || subject.sessionId}:${action}`;
+    const inflight = cardActionInflight.get(inflightKey);
+    if (inflight) {
+      logger6.warn(`handleCardAction: ${inflightKey} 已有同操作在处理中（疑似用户重复点击），本次忽略。`);
+      return { ok: false, action, error: `重复点击：${inflightKey} 正在处理中，已忽略` };
+    }
+    const pending = (async () => {
+      try {
+        const result = await ports.refreshSessionCard({
+          sessionId: subject.sessionId,
+          chatId: event.chatId,
+          messageId: event.messageId,
+          token: event.token,
+          profile: event.profile
+        });
+        if (result.error) {
+          return { ok: false, action, error: result.error };
+        }
+        return { ok: true, action, cardUpdate: result.cardUpdate };
+      } catch (err) {
+        logger6.error(`handleCardAction.refresh_activity failed: ${err.message}`);
+        return { ok: false, action, error: err.message };
+      }
+    })();
+    cardActionInflight.set(inflightKey, pending);
+    try {
+      return await pending;
+    } finally {
+      cardActionInflight.delete(inflightKey);
+    }
+  }
+  return await handleRefreshSessionActivity(event, ports, subject);
+}
+async function handleGroupActionSessionOnly(event, ports, action, sessionId) {
+  const existing = await lookupSessionGroup(ports, sessionId);
+  if (action === "create_group") {
+    if (existing?.chatId) {
+      logger6.info(`handleGroupActionSessionOnly: 会话 ${sessionId} 已有群 ${existing.chatId}` + `（幂等命中，不重复建群）`);
+      return {
+        ok: true,
+        action,
+        newChatId: existing.chatId,
+        cardUpdate: buildCardAfterSessionGroupChange(event, ports, {
+          sessionId,
+          chatId: existing.chatId
+        })
+      };
+    }
+    if (!ports.createGroupChat) {
+      return { ok: false, action, error: "ports.createGroupChat not injected" };
+    }
+    try {
+      let title;
+      try {
+        const t = await ports.getSessionTitle?.(sessionId);
+        if (typeof t === "string" && t.trim())
+          title = t.trim();
+      } catch (err) {
+        logger6.warn(`handleGroupActionSessionOnly: getSessionTitle(${sessionId}) 失败（用 sessionId 兜底）: ` + `${err.message}`);
+      }
+      const renderedName = truncateText(`会话 ${title ?? sessionId}`, 60);
+      const description = truncateText(`roy-agent session ${sessionId}`, 100);
+      const operatorOpenId = extractOperatorOpenId(event.operatorId);
+      const initialUserIds = operatorOpenId ? [operatorOpenId] : undefined;
+      let initialBotIds;
+      try {
+        const botAppId = await resolveBotAppId(event.profile);
+        if (botAppId)
+          initialBotIds = [botAppId];
+      } catch (err) {
+        logger6.warn(`handleGroupActionSessionOnly: resolveBotAppId 失败` + `（bot 可能不在群里，发卡会 230002）: ${err.message}`);
+      }
+      const chatId = await ports.createGroupChat({
+        name: renderedName,
+        description,
+        profile: event.profile,
+        initialUserIds,
+        initialBotIds
+      });
+      if (operatorOpenId && !initialUserIds && ports.inviteUser) {
+        try {
+          await ports.inviteUser(chatId, operatorOpenId, event.profile);
+        } catch (err) {
+          logger6.warn(`handleGroupActionSessionOnly: inviteUser(${chatId}, ${operatorOpenId}) 失败` + `（不阻断主流程）: ${err.message}`);
+        }
+      }
+      await attachGroupSessionForSession(ports, chatId, sessionId, renderedName);
+      if (ports.notifier?.upsertSessionCard) {
+        try {
+          const cardRes = await ports.notifier.upsertSessionCard({
+            chatId,
+            sessionId: chatId,
+            title: renderedName,
+            lifecycle: "running",
+            perTaskChatId: chatId
+          });
+          logger6.info(`handleGroupActionSessionOnly: 新群卡已发 chatId=${chatId} ` + `messageId=${cardRes.messageId}（session_id=群 session，#5417）`);
+        } catch (err) {
+          logger6.warn(`handleGroupActionSessionOnly: 新群卡发送失败（不阻断建群）: ` + `${err.message}`);
+        }
+      }
+      return {
+        ok: true,
+        action,
+        newChatId: chatId,
+        cardUpdate: buildCardAfterSessionGroupChange(event, ports, {
+          sessionId,
+          chatId,
+          chatName: renderedName
+        })
+      };
+    } catch (err) {
+      logger6.error(`handleCardAction.create_group(session-only) failed: ${err.message}`);
+      return { ok: false, action, error: err.message };
+    }
+  }
+  if (!existing?.chatId) {
+    return {
+      ok: false,
+      action,
+      error: `会话 ${sessionId} 没有专属群，无需解散`
+    };
+  }
+  if (!ports.deleteGroupChat) {
+    return { ok: false, action, error: "ports.deleteGroupChat not injected" };
+  }
+  try {
+    await ports.deleteGroupChat(existing.chatId, event.profile);
+    if (!ports.detachGroupSession) {
+      logger6.warn(`handleGroupActionSessionOnly: detachGroupSession 端口未注入 ⇒ 群 ${existing.chatId} ` + `已解散但关联标记残留（反查仍会命中这个群）`);
+    } else {
+      const unlinkTarget = existing.aliasSessionId ?? existing.chatId;
+      try {
+        await ports.detachGroupSession(unlinkTarget);
+      } catch (err) {
+        logger6.warn(`handleGroupActionSessionOnly: detachGroupSession(${unlinkTarget}) 失败` + `（不阻断解散）: ${err.message}`);
+      }
+    }
+    return {
+      ok: true,
+      action,
+      cardUpdate: buildCardAfterSessionGroupChange(event, ports, { sessionId })
+    };
+  } catch (err) {
+    logger6.error(`handleCardAction.disband_group(session-only) failed: ${err.message}`);
+    return { ok: false, action, error: err.message };
+  }
+}
+async function lookupSessionGroup(ports, sessionId) {
+  if (!ports.findGroupChatForSession)
+    return;
+  try {
+    const r = await ports.findGroupChatForSession(sessionId);
+    if (r && typeof r.chatId === "string" && r.chatId.trim()) {
+      return { chatId: r.chatId.trim(), ...r.aliasSessionId ? { aliasSessionId: r.aliasSessionId } : {} };
+    }
+    return;
+  } catch (err) {
+    logger6.warn(`lookupSessionGroup(${sessionId}) 失败（当作没有群）: ${err.message}`);
+    return;
+  }
+}
+async function attachGroupSessionForSession(ports, chatId, sessionId, title) {
+  if (!ports.attachGroupSession) {
+    logger6.warn(`attachGroupSessionForSession: 端口未注入 ⇒ 群 ${chatId} 将没有背景提示事件` + `（连不到 ${sessionId} 的溯源信息）`);
+    return;
+  }
+  try {
+    await ports.attachGroupSession({
+      chatId,
+      originSessionId: sessionId,
+      ...title ? { title } : {}
+    });
+    logger6.info(`attachGroupSessionForSession: ${chatId} ← ${sessionId}` + `（已注入 1 条 user 事件作为背景提示）`);
+  } catch (err) {
+    logger6.warn(`attachGroupSessionForSession: attach(${chatId} ← ${sessionId}) 失败（不阻断建群）: ` + `${err.message}`);
+  }
+}
+function buildCardAfterSessionGroupChange(event, ports, opts) {
+  const preserved = ports.notifier?.applySessionGroupChange?.(event.messageId, {
+    sessionId: opts.sessionId,
+    ...opts.chatId ? { perTaskChatId: opts.chatId } : {},
+    ...opts.chatName ? { perTaskChatName: opts.chatName } : {}
+  });
+  if (preserved)
+    return preserved;
+  logger6.warn(`buildCardAfterSessionGroupChange: notifier 无 messageId=${event.messageId} 的状态，` + `fallback 重建 session 卡（历史里程碑可能丢失）`);
+  return buildSessionCard({
+    sessionId: opts.sessionId,
+    ...opts.chatId ? { perTaskChatId: opts.chatId } : {},
+    ...opts.chatName ? { perTaskChatName: opts.chatName } : {}
+  });
+}
+async function handleCardActionInner(event, ports, action, taskId) {
+  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);
+  switch (action) {
+    case "create_group":
+      return await handleCreateGroup(event, ports, task, existingChatId);
+    case "disband_group":
+      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) {
+    logger6.debug(`buildCardAfterGroupChange: 复用 notifier 累积状态（里程碑历史保留）messageId=${event.messageId}`);
+    return preserved;
+  }
+  logger6.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);
+    logger6.info(`handleCreateGroup: Task #${task.id} 已有专属群 ${existingChatId}（幂等命中，不重复建群）`);
+    await attachGroupSessionForTask(event, ports, task.id, existingChatId, task.context);
+    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];
+        logger6.debug(`handleCreateGroup: ${operatorOpenId} 已在建群时邀请（initialUserIds 路径）`);
+      } else if (ports.inviteUser) {
+        try {
+          await ports.inviteUser(chatId, operatorOpenId, event.profile);
+          invitedOpenIds = [operatorOpenId];
+          logger6.debug(`handleCreateGroup: 走 inviteUser 端口邀请 ${operatorOpenId} 进 ${chatId}`);
+        } catch (err) {
+          logger6.warn(`handleCreateGroup: inviteUser(${chatId}, ${operatorOpenId}) 失败（不阻断主流程）: ${err.message}`);
+        }
+      } else {
+        logger6.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);
+    await attachGroupSessionForTask(event, ports, task.id, chatId, task.context);
+    return { ok: true, action: "create_group", newChatId: chatId, cardUpdate };
+  } catch (err) {
+    logger6.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;
+}
+function parseTaskIdLoose(raw) {
+  if (typeof raw === "number") {
+    return Number.isSafeInteger(raw) && raw > 0 ? raw : undefined;
+  }
+  if (typeof raw === "string" && /^\d+$/.test(raw.trim())) {
+    const n = Number(raw.trim());
+    return Number.isSafeInteger(n) && n > 0 ? n : undefined;
+  }
+  return;
+}
+async function handleRefreshSessionActivity(event, ports, subject) {
+  const action = "refresh_activity";
+  const sessionId = subject.sessionId;
+  let probe;
+  try {
+    probe = await ports.loadSessionActivity?.(sessionId);
+  } catch (err) {
+    logger6.warn(`handleRefreshSessionActivity: loadSessionActivity failed for ${sessionId}: ` + `${err.message}（降级为「暂无数据」）`);
+    probe = undefined;
+  }
+  let taskEnrichment;
+  if (subject.taskId !== undefined) {
+    taskEnrichment = await loadTaskEnrichment(subject.taskId, ports);
+  }
+  let recentMessages;
+  try {
+    recentMessages = await ports.loadSessionMessages?.(sessionId, RECENT_MESSAGE_LIMIT);
+  } catch (err) {
+    logger6.warn(`handleRefreshSessionActivity: loadSessionMessages failed for ${sessionId}: ` + `${err.message}（降级为不渲染最近消息面板）`);
+    recentMessages = undefined;
+  }
+  const snapshot = probe?.activity ?? null;
+  const sessionAlive = probe?.activity !== undefined && !probe?.terminal;
+  const lifecycle = probe?.lifecycle ? probe.lifecycle : probe?.terminal ? "completed" : sessionAlive ? "running" : taskEnrichment?.lifecycle ?? "running";
+  const preserved = ports.notifier?.buildSessionCardWithActivity?.(event.messageId, sessionId, snapshot, {
+    lifecycle,
+    task: taskEnrichment?.info,
+    ...recentMessages !== undefined ? { recentMessages } : {}
+  });
+  if (preserved) {
+    logger6.debug(`handleRefreshSessionActivity: ${sessionId} 活性已刷新 ` + `(messageCount=${snapshot?.messageCount ?? "n/a"}, task=${subject.taskId ?? "none"})`);
+    return { ok: true, action, cardUpdate: preserved };
+  }
+  logger6.warn(`handleRefreshSessionActivity: notifier 无 messageId=${event.messageId} 的状态，` + `fallback 重建 session 卡`);
+  const groupChat = taskEnrichment?.info ? undefined : await lookupSessionGroup(ports, sessionId);
+  return {
+    ok: true,
+    action,
+    cardUpdate: buildSessionCard({
+      sessionId,
+      activity: snapshot,
+      lifecycle,
+      ...taskEnrichment?.info ? { task: taskEnrichment.info } : {},
+      ...groupChat?.chatId ? { perTaskChatId: groupChat.chatId } : {},
+      ...recentMessages !== undefined ? { recentMessages } : {}
+    })
+  };
+}
+async function loadTaskEnrichment(taskId, ports) {
+  try {
+    const task = await ports.getTask?.(taskId);
+    if (!task)
+      return;
+    const raw = task;
+    return {
+      lifecycle: lifecycleOfTaskStatus(raw.status),
+      info: {
+        id: typeof raw.id === "number" ? raw.id : taskId,
+        ...raw.title ? { title: raw.title } : {},
+        ...raw.status ? { status: raw.status } : {},
+        ...typeof raw.progress === "number" ? { progress: raw.progress } : {},
+        ...raw.current_status ? { currentStatus: raw.current_status } : {},
+        ...Array.isArray(raw.milestones) && raw.milestones.length > 0 ? { milestones: raw.milestones } : {},
+        ...raw.priority ? { priority: raw.priority } : {},
+        ...raw.goals_and_expected_deliverables || raw.goals ? { goals: raw.goals_and_expected_deliverables ?? raw.goals } : {},
+        ...typeof raw.parent_task_id === "number" && raw.parent_task_id > 0 ? { parentTaskId: raw.parent_task_id } : {},
+        ...raw.created_at || raw.createdAt ? { createdAt: raw.created_at ?? raw.createdAt } : {},
+        ...raw.updated_at || raw.updatedAt ? { updatedAt: raw.updated_at ?? raw.updatedAt } : {}
+      }
+    };
+  } catch (err) {
+    logger6.warn(`loadTaskEnrichment: task #${taskId} 读取失败（降级为无 task 信息）: ` + `${err.message}`);
+    return;
+  }
+}
+function lifecycleOfTaskStatus(status) {
+  switch (status) {
+    case "completed":
+      return "completed";
+    case "failed":
+      return "failed";
+    case "cancelled":
+    case "archived":
+    case "paused":
+      return "stopped";
+    case "active":
+    case "todo":
+    case "to_validate":
+      return "running";
+    default:
+      return;
+  }
+}
+async function handleRefreshActivity(event, ports, task, taskId) {
+  const action = "refresh_activity";
+  let activity;
+  try {
+    activity = await ports.loadSubSessionActivity?.(taskId);
+  } catch (err) {
+    logger6.warn(`handleRefreshActivity: loadSubSessionActivity failed for task #${taskId}: ` + `${err.message}（降级为「暂无数据」）`);
+    activity = undefined;
+  }
+  const snapshot = activity?.activity ?? null;
+  const terminal = activity?.terminal ?? false;
+  const preserved = ports.notifier?.buildCardWithActivity?.(event.messageId, snapshot, {
+    terminal
+  });
+  if (preserved) {
+    logger6.debug(`handleRefreshActivity: task #${taskId} 活性已刷新 ` + `(messageCount=${snapshot?.messageCount ?? "n/a"}, terminal=${terminal})`);
+    return { ok: true, action, cardUpdate: preserved };
+  }
+  logger6.warn(`handleRefreshActivity: notifier 无 messageId=${event.messageId} 的状态，` + `fallback 重建卡片（历史里程碑可能丢失）`);
+  const meta = buildTaskMetaFromTask(task, extractPerTaskChatId(task.context), undefined);
+  return {
+    ok: true,
+    action,
+    cardUpdate: buildTaskCard({
+      status: cardStatusOfTaskStatus(task.status),
+      meta,
+      activity: snapshot,
+      activityTerminal: terminal
+    })
+  };
+}
+function cardStatusOfTaskStatus(status) {
+  switch (status) {
+    case "completed":
+      return "completed";
+    case "cancelled":
+      return "cancelled";
+    case "failed":
+      return "failed";
+    case "paused":
+      return "stopped";
+    case "archived":
+      return "stopped";
+    default:
+      return "running";
+  }
+}
+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) {
+    logger6.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 });
+    logger6.debug(`deleteGroupChatViaLarkCli(${chatId}) bot 退群 ok: ` + `stdout=${stdout?.slice(0, 300)} stderr=${stderr?.slice(0, 300)}`);
+  } catch (err) {
+    logger6.warn(`deleteGroupChatViaLarkCli(${chatId}) bot 退群失败（task.context 仍会清掉，` + `飞书侧群会保留）：${err.message}`);
+  }
+}
+function shellQuote(s) {
+  return `'${s.replace(/'/g, `'\\''`)}'`;
+}
+async function resolveBotAppId(profile) {
+  const profileFlag = profile ? `--profile ${profile} ` : "";
+  const { stdout } = await execAsync(`lark-cli ${profileFlag}auth status --json`, { timeout: 15000 });
+  const appId = JSON.parse(stdout).appId;
+  if (!appId) {
+    throw new Error(`lark-cli auth status 未返回 appId: ${stdout.slice(0, 200)}`);
+  }
+  return appId;
+}
+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 botsFlag = opts.initialBotIds && opts.initialBotIds.length > 0 ? `--bots ${shellQuote(opts.initialBotIds.join(","))} ` : "";
+  const cmd = `lark-cli ${profileFlag}im +chat-create --name ${shellQuote(truncateText(opts.name, 60))} ` + usersFlag + botsFlag + `--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/task/plugins/lark-cli-task-notify-plugin.ts
 var logger7 = createLogger("lark-cli:task-notify");
-var CTX_FIELD_CHAT_ID = "larkPerTaskChatId";
+var CTX_FIELD_CHAT_ID2 = "larkPerTaskChatId";
 var CTX_FIELD_CHAT_PROFILE = "larkPerTaskChatProfile";
 function parseLarkPerTaskChatId(ctxStr) {
   if (!ctxStr)
     return;
   try {
     const obj = JSON.parse(ctxStr);
-    const id = obj[CTX_FIELD_CHAT_ID];
+    const id = obj[CTX_FIELD_CHAT_ID2];
     return typeof id === "string" ? id : undefined;
   } catch {
     return;
@@ -2019,7 +2625,8 @@ class LarkCliTaskNotifyHook {
       ...config
     };
     if (this.config.cardMode !== false) {
-      this.cardNotifier = config.cardNotifier ?? new LarkCardPatchNotifier;
+      const isTestEnv = "BUN_TEST_WORKER_ID" in process.env;
+      this.cardNotifier = config.cardNotifier ?? (isTestEnv ? new LarkCardPatchNotifier : getSharedLarkCardNotifier());
       this.cardStateStore = config.cardStateStore ?? createLarkCardStateStore();
     }
   }
@@ -2061,11 +2668,29 @@ class LarkCliTaskNotifyHook {
     }
   }
   async onAfterCreate(ctx) {
-    const { task } = ctx.data;
+    const { task, sessionId: ctxSessionId } = ctx.data;
     if (!task || !this.shouldNotify("task_created" /* TASK_CREATED */))
       return;
     if (!this.isCardModeEnabled())
       return;
+    const sessionId = typeof ctxSessionId === "string" && ctxSessionId.trim() ? ctxSessionId.trim() : this.resolveSessionIdForTask(task.id);
+    if (sessionId) {
+      const merged = await this.patchSessionCardForTask(task, {
+        sessionId,
+        lifecycle: "running",
+        milestones: [
+          {
+            title: "Task 创建",
+            timestamp: new Date().toISOString(),
+            description: task.current_status || undefined
+          }
+        ]
+      });
+      if (merged) {
+        logger7.debug(`onAfterCreate: task #${task.id} 已渲染进 session 卡 ${sessionId}（单卡语义）`);
+        return;
+      }
+    }
     await this.sendCardStart(task);
   }
   async onAfterUpdate(ctx) {
@@ -2080,6 +2705,22 @@ class LarkCliTaskNotifyHook {
         return;
       if (!this.isCardModeEnabled())
         return;
+      const sessionIdTerminal = this.resolveSessionIdForTask(task.id);
+      if (sessionIdTerminal) {
+        const mergedTerminal = await this.patchSessionCardForTask(task, {
+          sessionId: sessionIdTerminal,
+          lifecycle: lifecycleOfTaskStatus(String(task.status)) ?? "running",
+          milestones: [
+            {
+              title: terminalCardStatus === "completed" ? "任务已完成" : "任务状态更新",
+              timestamp: new Date().toISOString(),
+              description: task.current_status || undefined
+            }
+          ]
+        });
+        if (mergedTerminal)
+          return;
+      }
       await this.sendCardFinish(task);
       return;
     }
@@ -2095,6 +2736,15 @@ class LarkCliTaskNotifyHook {
       return;
     if (!this.isCardModeEnabled())
       return;
+    const sessionIdUpdate = this.resolveSessionIdForTask(task.id);
+    if (sessionIdUpdate) {
+      const mergedUpdate = await this.patchSessionCardForTask(task, {
+        sessionId: sessionIdUpdate,
+        lifecycle: lifecycleOfTaskStatus(String(task.status)) ?? "running"
+      });
+      if (mergedUpdate)
+        return;
+    }
     await this.sendCardUpdate(task, changes);
   }
   cardStatusOf(task, changes) {
@@ -2262,6 +2912,12 @@ class LarkCliTaskNotifyHook {
       const rec = this.cardStateStore.get(taskId);
       if (!rec)
         return;
+      if (rec.sessionId) {
+        this.cardNotifier?.bindTaskToSession?.(taskId, rec.sessionId);
+        if (rec.messageId) {
+          this.cardNotifier?.adoptSessionCard?.(rec.sessionId, rec.messageId);
+        }
+      }
       if (!this.restoredTaskIds.has(taskId)) {
         this.restoredTaskIds.add(taskId);
         if (rec.status !== "closed" && rec.messageId) {
@@ -2460,6 +3116,7 @@ class LarkCliTaskNotifyHook {
       logger7.warn(`buildCardState: read existing failed for task #${task.id}: ${err.message}`);
     }
     const now = Date.now();
+    const sessionId = this.resolveSessionIdForTask(task.id);
     return {
       taskId: task.id,
       messageId,
@@ -2467,6 +3124,7 @@ class LarkCliTaskNotifyHook {
       profile,
       pinned,
       status: "open",
+      ...sessionId ? { sessionId } : {},
       createdAt: existing?.createdAt ?? now,
       updatedAt: now
     };
@@ -2756,6 +3414,7 @@ class LarkCliTaskNotifyHook {
     return;
   }
   buildTaskMeta(task) {
+    const sessionId = this.resolveSessionIdForTask(task.id);
     const recordedNames = extractRecordedChatNames(task.context);
     const matchedName = recordedNames.find((n) => new RegExp(`(?:Task\\s*#?\\s*|#)(?<![\\d])(?<!\\d)${task.id}(?!\\d)(?![\\d])`, "i").test(n));
     return {
@@ -2770,7 +3429,101 @@ class LarkCliTaskNotifyHook {
       context: task.context,
       currentStatus: task.current_status,
       perTaskChatId: extractPerTaskChatId(task.context),
-      perTaskChatName: matchedName
+      perTaskChatName: matchedName,
+      ...sessionId ? { sessionId } : {}
+    };
+  }
+  resolveSessionIdForTask(taskId) {
+    const fromIndex = this.cardNotifier?.getSessionIdByTask?.(taskId);
+    if (fromIndex)
+      return fromIndex;
+    try {
+      const rec = this.cardStateStore?.get(taskId);
+      if (rec?.sessionId)
+        return rec.sessionId;
+    } catch {}
+    const ctx = getEnvContextOrEmpty();
+    const fromCtx = ctx?.sessionId ?? ctx?.replyChannel?.sessionId;
+    return typeof fromCtx === "string" && fromCtx ? fromCtx : undefined;
+  }
+  async patchSessionCardForTask(task, opts) {
+    if (!this.cardNotifier)
+      return false;
+    const meta = this.buildTaskMeta(task);
+    const sessionId = opts.sessionId;
+    const chatId = meta.perTaskChatId ?? this.resolveChatId(task, getEnvContextOrEmpty());
+    if (!chatId)
+      return false;
+    const profile = this.resolveProfile(task, getEnvContextOrEmpty());
+    const agentType = this.resolveAgentType();
+    const res = await this.cardNotifier.upsertSessionCard({
+      chatId,
+      ...profile ? { profile } : {},
+      sessionId,
+      ...task.title ? { title: task.title } : {},
+      ...opts.statusPhrase ? { statusPhrase: opts.statusPhrase } : {},
+      ...agentType ? { agentType } : {},
+      startedAt: task.createdAt ? String(task.createdAt) : new Date().toISOString(),
+      ...opts.milestones ? { milestones: opts.milestones } : {},
+      lifecycle: opts.lifecycle,
+      task: this.buildSessionCardTask(task, meta),
+      ...meta.perTaskChatId ? { perTaskChatId: meta.perTaskChatId } : {},
+      ...meta.perTaskChatName ? { perTaskChatName: meta.perTaskChatName } : {}
+    });
+    this.recordSessionCardForTask(task, sessionId, chatId, profile, res.messageId);
+    if (this.syncGroupCardFromOriginFn) {
+      await this.cardNotifier.syncGroupCardFromOrigin(sessionId, {
+        lifecycle: opts.lifecycle,
+        ...task.title ? { title: task.title } : {},
+        ...opts.milestones ? { milestones: opts.milestones } : {}
+      }, this.syncGroupCardFromOriginFn);
+    }
+    return true;
+  }
+  syncGroupCardFromOriginFn;
+  recordSessionCardForTask(task, sessionId, chatId, profile, messageIdIn) {
+    this.cardNotifier?.bindTaskToSession?.(task.id, sessionId);
+    if (!this.cardStateStore)
+      return;
+    const messageId = messageIdIn ?? this.cardNotifier?.getSessionCardMessageId?.(sessionId);
+    if (!messageId)
+      return;
+    this.cardMessageIds.set(task.id, messageId);
+    try {
+      const existing = this.cardStateStore.get(task.id);
+      const now = Date.now();
+      this.cardStateStore.upsert({
+        taskId: task.id,
+        messageId,
+        chatId: chatId ?? existing?.chatId ?? "",
+        ...profile ?? existing?.profile ? { profile: profile ?? existing?.profile } : {},
+        pinned: existing?.pinned ?? true,
+        status: existing?.status ?? "open",
+        createdAt: existing?.createdAt ?? now,
+        updatedAt: now,
+        sessionId,
+        ...existing?.timeline ? { timeline: existing.timeline } : {}
+      });
+    } catch (err) {
+      logger7.warn(`recordSessionCardForTask failed for task #${task.id}: ${err.message}`);
+    }
+  }
+  resolveAgentType() {
+    const ctx = getEnvContextOrEmpty();
+    return typeof ctx?.subagentType === "string" && ctx.subagentType ? ctx.subagentType : undefined;
+  }
+  buildSessionCardTask(task, meta) {
+    return {
+      id: task.id,
+      ...task.title ? { title: task.title } : {},
+      ...task.status ? { status: String(task.status) } : {},
+      ...typeof task.progress === "number" ? { progress: task.progress } : {},
+      ...task.current_status ? { currentStatus: task.current_status } : {},
+      ...meta.priority ? { priority: meta.priority } : {},
+      ...typeof meta.parentTaskId === "number" ? { parentTaskId: meta.parentTaskId } : {},
+      ...meta.goals ? { goals: meta.goals } : {},
+      ...task.createdAt ? { createdAt: String(task.createdAt) } : {},
+      ...task.updatedAt ? { updatedAt: String(task.updatedAt) } : {}
     };
   }
   deriveTimelineFromOperation(operation) {
@@ -2850,7 +3603,7 @@ init_env_context();
 // src/env/task/plugins/wecom-card-state-store.ts
 init_logger();
 init_sqlite_task_store();
-import { join as join2 } from "path";
+import { join } from "path";
 var logger8 = createLogger("wecom:card-state");
 
 class MemoryWecomCardStateStore {
@@ -2899,7 +3652,7 @@ class MemoryWecomCardStateStore {
 function createMemoryWecomCardStore() {
   return new MemoryWecomCardStateStore;
 }
-function rowToState2(row) {
+function rowToState(row) {
   const state = {
     taskId: row.task_id,
     chatId: row.chat_id,
@@ -2963,11 +3716,11 @@ class SqliteWecomCardStateStore {
   }
   get(taskId) {
     const row = this.db.prepare("SELECT * FROM wecom_card WHERE task_id = ?").get(taskId);
-    return row ? rowToState2(row) : undefined;
+    return row ? rowToState(row) : undefined;
   }
   list() {
     const rows = this.db.prepare("SELECT * FROM wecom_card ORDER BY task_id ASC").all();
-    return rows.map(rowToState2);
+    return rows.map(rowToState);
   }
   markPaused(taskId) {
     this.db.prepare("UPDATE wecom_card SET status = 'paused', updated_at = ? WHERE task_id = ?").run(Date.now(), taskId);
@@ -2990,7 +3743,7 @@ class SqliteWecomCardStateStore {
 }
 function getDefaultWecomCardDbPath() {
   const home = process.env.HOME || process.env.USERPROFILE || "/tmp";
-  return join2(home, ".local", "share", "roy-agent", "wecom-cards.db");
+  return join(home, ".local", "share", "roy-agent", "wecom-cards.db");
 }
 function createWecomCardStateStore(dbPath) {
   const isTestEnv = "BUN_TEST_WORKER_ID" in process.env;
@@ -3126,6 +3879,7 @@ class WecomTaskNotifyHook {
   config;
   sender;
   cardStateStore;
+  esStatusNotifications;
   lastNotifyTimestamps = new Map;
   constructor(config = {}) {
     this.name = config.pluginName || "WecomTaskNotifyHook";
@@ -3144,6 +3898,7 @@ class WecomTaskNotifyHook {
       ],
       ...config
     };
+    this.esStatusNotifications = config.statusNotifications === true;
     this.sender = config.sender ?? {
       send: (input) => this.defaultSend(input)
     };
@@ -3414,8 +4169,14 @@ class WecomTaskNotifyHook {
       terminal: input.terminal
     });
     const cardResult = await this.deliverTemplateCard(input);
-    if (cardResult)
+    if (cardResult) {
+      if (this.statusNotificationsEnabled()) {
+        await this.sendStatusMarkdown(input, content).catch((err) => {
+          logger9.warn(`sendStatusMarkdown failed for task #${input.task.id}: ` + `${err.message}（不影响卡片送达）`);
+        });
+      }
       return true;
+    }
     try {
       const r = await this.sender.send({
         chatId: input.chatId,
@@ -3431,6 +4192,19 @@ class WecomTaskNotifyHook {
       return false;
     }
   }
+  statusNotificationsEnabled() {
+    try {
+      return this.esStatusNotifications === true;
+    } catch {
+      return false;
+    }
+  }
+  async sendStatusMarkdown(input, content) {
+    const r = await this.sender.send({ chatId: input.chatId, content });
+    if (!r.ok) {
+      logger9.warn(`sendStatusMarkdown failed for task #${input.task.id}: ` + `${r.error ?? "unknown"}（不影响卡片送达）`);
+    }
+  }
   async deliverTemplateCard(input) {
     try {
       const env = getEnvContextOrEmpty();
@@ -3456,7 +4230,12 @@ class WecomTaskNotifyHook {
         changeSummary: input.changeSummary,
         milestones: input.milestones,
         buttons: [
-          { text: "刷新详情", key: WecomCardActionKey.VIEW, style: 1 }
+          { text: "刷新详情", key: WecomCardActionKey.VIEW, style: 1 },
+          {
+            text: "刷新活性",
+            key: WecomCardActionKey.REFRESH_ACTIVITY,
+            style: 2
+          }
         ]
       });
       const r = await sendWecomTemplateCard({
@@ -3584,10 +4363,10 @@ var logger10 = createLogger("lark-cli:per-task-group");
 function isPluginDebugEnabled() {
   return process.env.ROY_TASK_NOTIFY_DEBUG === "1" || process.env.ROY_TRACE_DEBUG === "1";
 }
-var CTX_FIELD_CHAT_ID2 = "larkPerTaskChatId";
+var CTX_FIELD_CHAT_ID3 = "larkPerTaskChatId";
 var CTX_FIELD_CHAT_PROFILE2 = "larkPerTaskChatProfile";
-var CTX_FIELD_CHAT_CREATED_AT = "larkPerTaskChatCreatedAt";
-var CTX_FIELD_CHAT_TASK_ID = "larkPerTaskChatTaskId";
+var CTX_FIELD_CHAT_CREATED_AT2 = "larkPerTaskChatCreatedAt";
+var CTX_FIELD_CHAT_TASK_ID2 = "larkPerTaskChatTaskId";
 
 class PerTaskGroupChatPlugin {
   name;
@@ -3623,7 +4402,7 @@ class PerTaskGroupChatPlugin {
       resolveToTriggerChatFallback: config.resolveToTriggerChatFallback ?? false,
       cardInitialMessage: config.cardInitialMessage !== false,
       autoCreateGroup: config.autoCreateGroup === true,
-      cardNotifier: config.cardNotifier ?? new LarkCardPatchNotifier
+      cardNotifier: config.cardNotifier ?? getSharedLarkCardNotifier()
     };
     this.cardNotifier = this.config.cardNotifier;
     this.name = this.config.pluginName;
@@ -3918,10 +4697,10 @@ class PerTaskGroupChatPlugin {
     } catch {
       parsed = {};
     }
-    parsed[CTX_FIELD_CHAT_ID2] = chatId;
+    parsed[CTX_FIELD_CHAT_ID3] = chatId;
     parsed[CTX_FIELD_CHAT_PROFILE2] = profile;
-    parsed[CTX_FIELD_CHAT_CREATED_AT] = new Date().toISOString();
-    parsed[CTX_FIELD_CHAT_TASK_ID] = task.id;
+    parsed[CTX_FIELD_CHAT_CREATED_AT2] = new Date().toISOString();
+    parsed[CTX_FIELD_CHAT_TASK_ID2] = task.id;
     const newContext = JSON.stringify(parsed);
     if (!this.taskUpdater) {
       logger10.warn(`attachChatIdToTask[${this.pluginName}]: ⚠️  no taskUpdater injected, ` + `chat_id ${chatId} NOT persisted to db for task #${task.id}. ` + `后果：下次 AFTER_UPDATE 从 DB 加载 task 时 getTaskChatId() 返回 undefined，` + `所有 update/complete/operation 通知 silently 丢失。` + `修复：event-source-handlers.ts:registerPluginHooks 应自动注入 setTaskUpdater。`);
@@ -3960,7 +4739,7 @@ class PerTaskGroupChatPlugin {
       return;
     try {
       const obj = JSON.parse(ctxStr);
-      const id = obj[CTX_FIELD_CHAT_ID2];
+      const id = obj[CTX_FIELD_CHAT_ID3];
       return typeof id === "string" ? id : undefined;
     } catch {
       return;
@@ -4222,4 +5001,4 @@ __legacyDecorateClassTS([
 function createPerTaskGroupChatPlugin(config = {}) {
   return new PerTaskGroupChatPlugin(config);
 }
-export { createAutoTaskPlugin, LAYA_REUSE_THRESHOLD, LayaDecisionPlugin, createLayaDecisionPlugin, LAYA_COMPLETION_THRESHOLD, buildCompletionHint, renderCompletionState, buildCompletionQuestion, LayaCompletionPlugin, createLayaCompletionPlugin, registerLayaCompletionTaskHook, WORKFLOW_EXTRACTOR_PROMPT, formatExtractorInput, formatExtractorInputFromDescription, parseExtractorOutput, TaskTagPlugin, MemoryLarkCardStateStore, SqliteLarkCardStateStore, getDefaultLarkCardDbPath, createLarkCardStateStore, extractPerTaskChatId, extractPerTaskChatName, NotifyType, LarkCliTaskNotifyHook, createLarkCliTaskNotifyHook, MemoryWecomCardStateStore, createMemoryWecomCardStore, SqliteWecomCardStateStore, getDefaultWecomCardDbPath, createWecomCardStateStore, WecomNotifyType, extractWecomFields, buildWecomTaskCard, WecomTaskNotifyHook, createWecomTaskNotifyHook, PerTaskGroupChatPlugin, createPerTaskGroupChatPlugin };
+export { createAutoTaskPlugin, LAYA_REUSE_THRESHOLD, LayaDecisionPlugin, createLayaDecisionPlugin, LAYA_COMPLETION_THRESHOLD, buildCompletionHint, renderCompletionState, buildCompletionQuestion, LayaCompletionPlugin, createLayaCompletionPlugin, registerLayaCompletionTaskHook, WORKFLOW_EXTRACTOR_PROMPT, formatExtractorInput, formatExtractorInputFromDescription, parseExtractorOutput, TaskTagPlugin, handleCardAction, deleteGroupChatViaLarkCli, createGroupChatViaLarkCli, NotifyType, LarkCliTaskNotifyHook, createLarkCliTaskNotifyHook, MemoryWecomCardStateStore, createMemoryWecomCardStore, SqliteWecomCardStateStore, getDefaultWecomCardDbPath, createWecomCardStateStore, WecomNotifyType, extractWecomFields, buildWecomTaskCard, WecomTaskNotifyHook, createWecomTaskNotifyHook, PerTaskGroupChatPlugin, createPerTaskGroupChatPlugin };