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

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

@@ -1,27 +1,326 @@
+import {
+  formatActivityLines,
+  formatRecentToolCallLines
+} from "./roy-agent-core-418zc9ha.js";
+import {
+  createCompatibleDatabase,
+  init_sqlite_task_store
+} from "./roy-agent-core-6k8mb7zx.js";
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   createLogger,
   init_logger
 } from "./roy-agent-core-7f7t9wwp.js";
 import {
-  __legacyDecorateClassTS
+  __legacyDecorateClassTS,
+  __require
 } from "./roy-agent-core-fs0mn2jk.js";
 
+// src/env/task/plugins/lark-card-patch-notifier.ts
+import { spawn } from "node:child_process";
+
+// src/env/task/plugins/lark-card-state-store.ts
+init_logger();
+init_sqlite_task_store();
+import { join } from "path";
+var logger = 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;
+  if (row.session_id)
+    state.sessionId = row.session_id;
+  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,
+        session_id TEXT
+      )
+    `);
+    try {
+      this.db.run("ALTER TABLE lark_card ADD COLUMN timeline TEXT");
+    } catch {}
+    try {
+      this.db.run("ALTER TABLE lark_card ADD COLUMN session_id 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, session_id)
+         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,
+           session_id = COALESCE(excluded.session_id, lark_card.session_id)`).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, state.sessionId ?? 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) {
+    logger.warn(`LarkCardStateStore: sqlite unavailable at ${path} (${err.message}) ` + `→ falling back to in-memory (卡片仍可发，但重启后无法 patch 旧卡)`);
+    return new MemoryLarkCardStateStore;
+  }
+}
+var sharedStateStore;
+function getSharedLarkCardStateStore() {
+  if (!sharedStateStore)
+    sharedStateStore = createLarkCardStateStore();
+  return sharedStateStore;
+}
+class MemoryLarkSessionCardStore {
+  records = new Map;
+  upsert(rec) {
+    this.records.set(rec.sessionId, { ...rec });
+  }
+  get(sessionId) {
+    const r = this.records.get(sessionId);
+    return r ? { ...r } : undefined;
+  }
+  list() {
+    return [...this.records.values()].map((r) => ({ ...r }));
+  }
+  delete(sessionId) {
+    this.records.delete(sessionId);
+  }
+  close() {
+    this.records.clear();
+  }
+}
+
+class SqliteLarkSessionCardStore {
+  db;
+  constructor(dbPath) {
+    this.db = createCompatibleDatabase(dbPath);
+    try {
+      this.db.run("PRAGMA journal_mode = WAL");
+      this.db.run("PRAGMA busy_timeout = 5000");
+    } catch {}
+    this.db.run(`
+      CREATE TABLE IF NOT EXISTS lark_session_card (
+        session_id TEXT PRIMARY KEY,
+        message_id TEXT NOT NULL,
+        chat_id    TEXT NOT NULL,
+        profile    TEXT,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL
+      )
+    `);
+  }
+  upsert(rec) {
+    this.db.prepare(`INSERT INTO lark_session_card
+           (session_id, message_id, chat_id, profile, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?)
+         ON CONFLICT(session_id) DO UPDATE SET
+           message_id = excluded.message_id,
+           chat_id    = excluded.chat_id,
+           profile    = COALESCE(excluded.profile, lark_session_card.profile),
+           updated_at = excluded.updated_at`).run(rec.sessionId, rec.messageId, rec.chatId, rec.profile ?? null, rec.createdAt, rec.updatedAt);
+  }
+  get(sessionId) {
+    const row = this.db.prepare("SELECT * FROM lark_session_card WHERE session_id = ?").get(sessionId);
+    if (!row)
+      return;
+    return {
+      sessionId: row.session_id,
+      messageId: row.message_id,
+      chatId: row.chat_id,
+      ...row.profile ? { profile: row.profile } : {},
+      createdAt: row.created_at,
+      updatedAt: row.updated_at
+    };
+  }
+  list() {
+    const rows = this.db.prepare("SELECT * FROM lark_session_card ORDER BY updated_at DESC").all();
+    return rows.map((row) => ({
+      sessionId: row.session_id,
+      messageId: row.message_id,
+      chatId: row.chat_id,
+      ...row.profile ? { profile: row.profile } : {},
+      createdAt: row.created_at,
+      updatedAt: row.updated_at
+    }));
+  }
+  delete(sessionId) {
+    this.db.prepare("DELETE FROM lark_session_card WHERE session_id = ?").run(sessionId);
+  }
+  close() {
+    try {
+      this.db.close?.();
+    } catch {}
+  }
+}
+function createLarkSessionCardStore(dbPath) {
+  const isTestEnv = "BUN_TEST_WORKER_ID" in process.env;
+  if (!dbPath && isTestEnv)
+    return new MemoryLarkSessionCardStore;
+  const path = dbPath ?? getDefaultLarkCardDbPath();
+  try {
+    return new SqliteLarkSessionCardStore(path);
+  } catch (err) {
+    logger.warn(`LarkSessionCardStore: sqlite unavailable at ${path} (${err.message}) ` + `→ falling back to in-memory (卡片仍可发，但重启后无法认领旧卡)`);
+    return new MemoryLarkSessionCardStore;
+  }
+}
+var sharedSessionCardStore;
+function getSharedLarkSessionCardStore() {
+  if (!sharedSessionCardStore) {
+    sharedSessionCardStore = createLarkSessionCardStore();
+  }
+  return sharedSessionCardStore;
+}
+
 // src/env/task/plugins/lark-card-patch-notifier.ts
 init_logger();
 init_decorator();
-import { spawn } from "node:child_process";
-var logger = createLogger("lark-cli:card-patch-notifier");
+var logger2 = createLogger("lark-cli:card-patch-notifier");
 var HEADER_TEMPLATE = {
   running: "blue",
   completed: "green",
   failed: "red",
   stopped: "grey",
   cancelled: "grey",
-  deleted: "grey"
+  deleted: "grey",
+  to_validate: "turquoise"
 };
 var STATUS_PHRASE = {
   running: "实时同步中",
@@ -29,7 +328,8 @@ var STATUS_PHRASE = {
   failed: "\uD83D\uDEA8 任务失败",
   stopped: "⏹️ 已停止",
   cancelled: "\uD83D\uDEAB 已取消",
-  deleted: "\uD83D\uDDD1️ 已删除"
+  deleted: "\uD83D\uDDD1️ 已删除",
+  to_validate: "\uD83D\uDD0D 待验证"
 };
 var FINAL_MILESTONE_TITLE = {
   running: "Task 进行中",
@@ -37,7 +337,8 @@ var FINAL_MILESTONE_TITLE = {
   failed: "Task 失败",
   stopped: "Task 已暂停",
   cancelled: "Task 已取消",
-  deleted: "Task 已删除"
+  deleted: "Task 已删除",
+  to_validate: "Task 待验证"
 };
 var SPINNER_EMOJIS = ["⏳", "\uD83D\uDD04", "\uD83D\uDD03", "⌛", "⏰", "\uD83D\uDD01"];
 var PROGRESS_BAR_CELLS = 20;
@@ -412,6 +713,7 @@ function buildTaskCard(opts) {
   const elements = [];
   const hasGroup = !!(opts.meta.perTaskChatId && opts.meta.perTaskChatId.length > 0);
   const taskIdForButton = opts.meta.id !== undefined ? String(opts.meta.id) : "";
+  const sessionIdForButton = typeof opts.meta.sessionId === "string" && opts.meta.sessionId.trim() ? opts.meta.sessionId : undefined;
   elements.push({
     tag: "button",
     text: {
@@ -421,9 +723,22 @@ function buildTaskCard(opts) {
     type: hasGroup ? "danger" : "primary",
     value: {
       action: hasGroup ? "disband_group" : "create_group",
-      taskId: taskIdForButton
+      taskId: taskIdForButton,
+      ...sessionIdForButton ? { sessionId: sessionIdForButton } : {}
     }
   });
+  if (taskIdForButton) {
+    elements.push({
+      tag: "button",
+      text: { tag: "plain_text", content: "\uD83D\uDCAC 会话查看" },
+      type: "default",
+      value: {
+        action: "refresh_activity",
+        taskId: taskIdForButton,
+        ...sessionIdForButton ? { sessionId: sessionIdForButton } : {}
+      }
+    });
+  }
   if (hasGroup) {
     const link = buildChatAppLink(opts.meta.perTaskChatId);
     const label = opts.meta.perTaskChatName ? `\uD83D\uDCE8 进入专属群：${sanitizeInlineText(opts.meta.perTaskChatName, 60)}` : "\uD83D\uDCE8 进入专属群";
@@ -443,6 +758,21 @@ function buildTaskCard(opts) {
     }));
     appendHr(elements);
   }
+  if (opts.activity !== undefined) {
+    elements.push(buildCollapsiblePanel({
+      title: "⚡ 子会话活性",
+      elementId: "task_activity",
+      expanded: true,
+      elements: [
+        {
+          tag: "markdown",
+          content: formatActivityLines(opts.activity ?? undefined, opts.activityNow ?? Date.now(), opts.activityTerminal ?? false).join(`
+`)
+        }
+      ]
+    }));
+    appendHr(elements);
+  }
   const timeline = buildTimelineElements(milestones, processSteps);
   if (timeline.elements.length > 0) {
     elements.push(buildCollapsiblePanel({
@@ -476,6 +806,200 @@ function buildTaskCard(opts) {
     body: { elements }
   };
 }
+function buildSessionCard(opts) {
+  const sessionId = opts.sessionId;
+  const updateCount = opts.updateCount ?? 1;
+  const spinner = SPINNER_EMOJIS[updateCount % SPINNER_EMOJIS.length];
+  const elements = [];
+  const taskIdNum = opts.task?.id;
+  const hasTaskId = typeof taskIdNum === "number" && taskIdNum > 0;
+  const hasGroup = !!(opts.perTaskChatId && opts.perTaskChatId.length > 0);
+  elements.push({
+    tag: "button",
+    text: {
+      tag: "plain_text",
+      content: hasGroup ? "解散该群" : hasTaskId ? "为这个任务建群" : "为本会话建群"
+    },
+    type: hasGroup ? "danger" : "primary",
+    value: {
+      action: hasGroup ? "disband_group" : "create_group",
+      sessionId,
+      ...hasTaskId ? { taskId: String(taskIdNum) } : {}
+    }
+  });
+  if (hasGroup) {
+    elements.push({
+      tag: "markdown",
+      content: `[\uD83D\uDCE8 进入专属群](${buildChatAppLink(opts.perTaskChatId)})`
+    });
+  }
+  elements.push({
+    tag: "button",
+    text: { tag: "plain_text", content: "\uD83D\uDCAC 会话查看" },
+    type: "default",
+    value: {
+      action: "refresh_activity",
+      sessionId,
+      ...hasTaskId ? { taskId: String(taskIdNum) } : {}
+    }
+  });
+  const infoLines = [];
+  infoLines.push(`- **\uD83C\uDD94 会话 ID**：${sanitizeInlineText(sessionId, 120)}`);
+  if (opts.title)
+    infoLines.push(`- **\uD83D\uDCDD 标题**：${sanitizeInlineText(opts.title, 120)}`);
+  if (opts.agentType) {
+    infoLines.push(`- **\uD83E\uDD16 执行 Agent**：${sanitizeInlineText(opts.agentType, 60)}`);
+  }
+  if (opts.startedAt) {
+    infoLines.push(`- **\uD83D\uDD50 开始时间**：${formatDateTimeForDisplay(opts.startedAt)}`);
+  }
+  if (opts.elapsedText)
+    infoLines.push(`- **⏳ 已运行**：${opts.elapsedText}`);
+  if (infoLines.length > 0) {
+    elements.push(buildCollapsiblePanel({
+      title: "\uD83D\uDCCB 会话详情",
+      elementId: "session_detail",
+      elements: [{ tag: "markdown", content: infoLines.join(`
+`) }]
+    }));
+    appendHr(elements);
+  }
+  const taskInfo = opts.task;
+  if (taskInfo) {
+    const taskLines = [];
+    taskLines.push(`- **\uD83C\uDD94 任务 ID**：#${taskInfo.id}`);
+    if (taskInfo.title) {
+      taskLines.push(`- **\uD83D\uDCCC 标题**：${sanitizeInlineText(taskInfo.title, 120)}`);
+    }
+    if (taskInfo.status) {
+      taskLines.push(`- **\uD83D\uDEA6 状态**：${sanitizeInlineText(taskInfo.status, 40)}`);
+    }
+    if (typeof taskInfo.progress === "number") {
+      taskLines.push(`- **\uD83D\uDCCA 进度**：${renderProgressBar(taskInfo.progress)}`);
+    }
+    if (taskInfo.currentStatus) {
+      taskLines.push(`- **\uD83D\uDCDD 当前状态**：${sanitizeInlineText(taskInfo.currentStatus, 200)}`);
+    }
+    if (taskInfo.priority) {
+      taskLines.push(`- **\uD83D\uDD25 优先级**：${sanitizeInlineText(taskInfo.priority, 20)}`);
+    }
+    if (taskInfo.parentTaskId !== undefined) {
+      taskLines.push(`- **\uD83E\uDDE9 父任务**：#${taskInfo.parentTaskId}`);
+    }
+    if (taskInfo.goals) {
+      taskLines.push(`- **\uD83C\uDFAF 目标**：${sanitizeInlineText(taskInfo.goals, 200)}`);
+    }
+    if (taskInfo.createdAt) {
+      taskLines.push(`- **\uD83D\uDD50 创建时间**：${formatDateTimeForDisplay(taskInfo.createdAt)}`);
+    }
+    if (taskInfo.updatedAt) {
+      taskLines.push(`- **\uD83D\uDD04 更新时间**：${formatDateTimeForDisplay(taskInfo.updatedAt)}`);
+    }
+    elements.push(buildCollapsiblePanel({
+      title: "\uD83D\uDCCB 任务信息",
+      elementId: "task_detail",
+      elements: [{ tag: "markdown", content: taskLines.join(`
+`) }]
+    }));
+    appendHr(elements);
+    if (taskInfo.milestones && taskInfo.milestones.length > 0) {
+      elements.push(buildCollapsiblePanel({
+        title: `\uD83D\uDCCC 操作记录（${taskInfo.milestones.length}）`,
+        elementId: "task_timeline",
+        expanded: false,
+        elements: [
+          { tag: "markdown", content: renderMilestones(taskInfo.milestones) }
+        ]
+      }));
+      appendHr(elements);
+    }
+  }
+  if (opts.activity !== undefined) {
+    elements.push(buildCollapsiblePanel({
+      title: "⚡ 子会话活性",
+      elementId: "task_activity",
+      expanded: true,
+      elements: [
+        {
+          tag: "markdown",
+          content: formatActivityLines(opts.activity ?? undefined, opts.activityNow ?? Date.now(), isSessionLifecycleTerminal(opts.lifecycle)).join(`
+`)
+        }
+      ]
+    }));
+    appendHr(elements);
+  }
+  if (opts.recentMessages !== undefined) {
+    elements.push(buildCollapsiblePanel({
+      title: "\uD83D\uDD27 最近工具调用",
+      elementId: "session_recent_messages",
+      expanded: true,
+      elements: [
+        {
+          tag: "markdown",
+          content: formatRecentToolCallLines(opts.recentMessages).join(`
+`)
+        }
+      ]
+    }));
+    appendHr(elements);
+  }
+  const milestones = opts.milestones ?? [];
+  if (milestones.length > 0) {
+    elements.push(buildCollapsiblePanel({
+      title: `\uD83D\uDCCC 执行动态（${milestones.length}）`,
+      elementId: "session_timeline",
+      expanded: false,
+      elements: [{ tag: "markdown", content: renderMilestones(milestones) }]
+    }));
+  }
+  const titleRaw = opts.title?.trim();
+  const headLabel = titleRaw ? truncateHeadTitle(titleRaw) : truncateHeadTitle(sessionId);
+  const lifecycle = opts.lifecycle ?? "running";
+  const lifecyclePhrase = opts.statusPhrase ?? SESSION_LIFECYCLE_PHRASE[lifecycle];
+  const headerTemplate = lifecycle === "running" ? HEADER_TEMPLATE.running : lifecycle === "completed" ? HEADER_TEMPLATE.completed : lifecycle === "stopped" ? HEADER_TEMPLATE.stopped : HEADER_TEMPLATE.failed;
+  return {
+    schema: "2.0",
+    header: {
+      title: { tag: "plain_text", content: `\uD83D\uDCCA 子会话实时更新（${headLabel}）` },
+      subtitle: {
+        tag: "plain_text",
+        content: `spinner: '${spinner}' · 第 ${updateCount} 次更新 | ${lifecyclePhrase}`
+      },
+      template: headerTemplate
+    },
+    body: { elements }
+  };
+}
+function isSessionLifecycleTerminal(lifecycle) {
+  return lifecycle !== undefined && lifecycle !== "running";
+}
+function cardStatusToSessionLifecycle(status) {
+  switch (status) {
+    case "completed":
+      return "completed";
+    case "failed":
+      return "failed";
+    case "stopped":
+    case "cancelled":
+    case "deleted":
+    case "paused":
+    case "archived":
+    case "blocked":
+      return "stopped";
+    case "timeout":
+      return "timeout";
+    default:
+      return "running";
+  }
+}
+var SESSION_LIFECYCLE_PHRASE = {
+  running: "运行中",
+  completed: "已完成",
+  timeout: "已超时",
+  failed: "已失败",
+  stopped: "已停止"
+};
 function buildChatAppLink(chatId, base = DEFAULT_APP_LINK_BASE) {
   return `${base}/client/chat/open?openChatId=${chatId}`;
 }
@@ -626,11 +1150,14 @@ class LarkCardPatchNotifier {
   mutexes = new Map;
   states = new Map;
   workflowStates = new Map;
+  sessionStates = new Map;
+  sessionStore;
   constructor(options = {}) {
+    this.sessionStore = options.sessionCardStore === null ? undefined : options.sessionCardStore ?? getSharedLarkSessionCardStore();
     this.options = {
       pinOnStart: true,
-      unpinOnFinish: true,
-      ...options
+      unpinOnFinish: false,
+      ...(({ sessionCardStore: _scs, ...rest }) => rest)(options)
     };
   }
   mutexFor(messageId) {
@@ -676,7 +1203,7 @@ class LarkCardPatchNotifier {
         pinned = true;
       } catch (pinErr) {
         pinError = pinErr.message;
-        logger.warn(`Pin failed (non-fatal) for message ${messageId}: ${pinError}`);
+        logger2.warn(`Pin failed (non-fatal) for message ${messageId}: ${pinError}`);
       }
     }
     return { messageId, pinned, pinError };
@@ -684,7 +1211,23 @@ class LarkCardPatchNotifier {
   async updateTask(opts) {
     await this.mutexFor(opts.messageId).run(async () => {
       if (this.finalisedCards.has(opts.messageId)) {
-        logger.debug(`updateTask: message ${opts.messageId} 已是终态卡片，忽略迟到的更新`);
+        logger2.debug(`updateTask: message ${opts.messageId} 已是终态卡片，忽略迟到的更新`);
+        return;
+      }
+      if (this.sessionStates.has(opts.messageId)) {
+        const card2 = this.applyTaskEventToSessionCard(opts.messageId, {
+          ...opts.milestones ? { milestones: opts.milestones } : {},
+          ...opts.processSteps ? { processSteps: opts.processSteps } : {},
+          ...opts.meta ? { meta: opts.meta } : {},
+          ...opts.status ? { status: opts.status } : {},
+          ...opts.status ? { lifecycle: cardStatusToSessionLifecycle(opts.status) } : {},
+          ...opts.progress !== undefined ? { progress: opts.progress } : {}
+        });
+        await this.runLarkCli(this.buildPatchCardArgs({
+          messageId: opts.messageId,
+          profile: opts.profile,
+          card: card2
+        }), "patch");
         return;
       }
       const state = this.states.get(opts.messageId) ?? {
@@ -769,6 +1312,29 @@ class LarkCardPatchNotifier {
   }
   async pauseTask(opts) {
     await this.mutexFor(opts.messageId).run(async () => {
+      if (this.sessionStates.has(opts.messageId)) {
+        const now2 = new Date().toISOString();
+        const pauseMilestone2 = {
+          title: opts.pausedMilestoneTitle ?? "Task 已暂停",
+          timestamp: now2,
+          description: opts.finalStep
+        };
+        const card2 = this.applyTaskEventToSessionCard(opts.messageId, {
+          milestones: [pauseMilestone2],
+          ...opts.processSteps ? { processSteps: opts.processSteps } : {},
+          ...opts.meta ? { meta: opts.meta } : {},
+          ...opts.status ? { status: opts.status } : {},
+          ...opts.status ? { lifecycle: cardStatusToSessionLifecycle(opts.status) } : {},
+          ...opts.progress !== undefined ? { progress: opts.progress } : {},
+          nowIso: now2
+        });
+        await this.runLarkCli(this.buildPatchCardArgs({
+          messageId: opts.messageId,
+          profile: opts.profile,
+          card: card2
+        }), "patch");
+        return;
+      }
       const state = this.states.get(opts.messageId);
       const now = new Date().toISOString();
       const updateCount = (state?.updateCount ?? 0) + 1;
@@ -813,7 +1379,7 @@ class LarkCardPatchNotifier {
           profile: opts.profile ?? state?.profile
         }), "unpin");
       } catch (unpinErr) {
-        logger.warn(`Unpin failed (non-fatal) for ${opts.messageId}: ${unpinErr.message}`);
+        logger2.warn(`Unpin failed (non-fatal) for ${opts.messageId}: ${unpinErr.message}`);
       }
     }
   }
@@ -825,6 +1391,30 @@ class LarkCardPatchNotifier {
   }
   async finishTask(opts) {
     await this.mutexFor(opts.messageId).run(async () => {
+      if (this.sessionStates.has(opts.messageId)) {
+        const now2 = new Date().toISOString();
+        const finalMilestone2 = {
+          title: FINAL_MILESTONE_TITLE[opts.status] ?? "Task 结束",
+          timestamp: now2,
+          description: opts.finalStep
+        };
+        const card2 = this.applyTaskEventToSessionCard(opts.messageId, {
+          milestones: [finalMilestone2],
+          ...opts.processSteps ? { processSteps: opts.processSteps } : {},
+          ...opts.meta ? { meta: opts.meta } : {},
+          ...opts.status ? { status: opts.status } : {},
+          ...opts.status ? { lifecycle: cardStatusToSessionLifecycle(opts.status) } : {},
+          progress: opts.status === "completed" ? 100 : opts.progress,
+          nowIso: now2
+        });
+        await this.runLarkCli(this.buildPatchCardArgs({
+          messageId: opts.messageId,
+          profile: opts.profile,
+          card: card2
+        }), "patch");
+        this.finalisedCards.add(opts.messageId);
+        return;
+      }
       const state = this.states.get(opts.messageId);
       const now = new Date().toISOString();
       const updateCount = (state?.updateCount ?? 0) + 1;
@@ -859,13 +1449,22 @@ class LarkCardPatchNotifier {
           profile: opts.profile ?? state?.profile
         }), "unpin");
       } catch (unpinErr) {
-        logger.warn(`Unpin failed (non-fatal) for ${opts.messageId}: ${unpinErr.message}`);
+        logger2.warn(`Unpin failed (non-fatal) for ${opts.messageId}: ${unpinErr.message}`);
       }
     }
     this.states.delete(opts.messageId);
     this.mutexes.delete(opts.messageId);
   }
   updateMetaAndBuildCard(messageId, meta, opts = {}) {
+    if (this.sessionStates.has(messageId)) {
+      return this.applyTaskEventToSessionCard(messageId, {
+        meta,
+        bumpUpdateCount: false,
+        ...opts.clearPerTaskChat ? { clearPerTaskChat: true } : {},
+        ...meta.perTaskChatId ? { perTaskChatId: meta.perTaskChatId } : {},
+        ...meta.perTaskChatName ? { perTaskChatName: meta.perTaskChatName } : {}
+      });
+    }
     const state = this.states.get(messageId);
     if (!state)
       return;
@@ -884,7 +1483,416 @@ class LarkCardPatchNotifier {
       spinner: SPINNER_EMOJIS[state.spinnerIndex] ?? SPINNER_EMOJIS[0]
     });
   }
+  buildCardWithActivity(messageId, activity, opts = {}) {
+    const state = this.states.get(messageId);
+    if (!state)
+      return;
+    return buildTaskCard({
+      status: "running",
+      meta: state.meta,
+      milestones: state.milestones,
+      processSteps: state.processSteps,
+      progress: state.progress,
+      updateCount: state.updateCount,
+      spinner: SPINNER_EMOJIS[state.spinnerIndex] ?? SPINNER_EMOJIS[0],
+      activity,
+      ...opts.now !== undefined ? { activityNow: opts.now } : {},
+      ...opts.terminal !== undefined ? { activityTerminal: opts.terminal } : {}
+    });
+  }
+  async updateSessionCard(opts) {
+    const rec = this.findSessionCardBySessionId(opts.sessionId);
+    if (!rec)
+      return false;
+    const { messageId, state } = rec;
+    const mergedMilestones = mergeUnique(state.milestones, opts.milestones ?? [], milestoneKey);
+    const updateCount = state.updateCount + 1;
+    const card = buildSessionCard({
+      sessionId: opts.sessionId,
+      title: state.title,
+      statusPhrase: state.statusPhrase,
+      agentType: state.agentType,
+      startedAt: state.startedAt,
+      elapsedText: state.elapsedText,
+      milestones: mergedMilestones,
+      lifecycle: opts.lifecycle,
+      updateCount,
+      ...opts.activity !== undefined ? { activity: opts.activity } : state.activity !== undefined ? { activity: state.activity } : {},
+      ...opts.task !== undefined ? { task: opts.task } : state.task !== undefined ? { task: state.task } : {},
+      ...opts.recentMessages !== undefined ? { recentMessages: opts.recentMessages } : state.recentMessages !== undefined ? { recentMessages: state.recentMessages } : {},
+      ...opts.perTaskChatId ?? state.perTaskChatId ? { perTaskChatId: opts.perTaskChatId ?? state.perTaskChatId } : {},
+      ...opts.perTaskChatName ?? state.perTaskChatName ? { perTaskChatName: opts.perTaskChatName ?? state.perTaskChatName } : {}
+    });
+    await this.runLarkCli(this.buildPatchCardArgs({
+      messageId,
+      profile: opts.profile ?? state.profile,
+      card
+    }), "patch");
+    this.sessionStates.set(messageId, {
+      ...state,
+      milestones: mergedMilestones,
+      updateCount,
+      lifecycle: opts.lifecycle,
+      ...opts.activity !== undefined ? { activity: opts.activity } : {},
+      ...opts.task !== undefined ? { task: opts.task } : {},
+      ...opts.perTaskChatId ? { perTaskChatId: opts.perTaskChatId } : {},
+      ...opts.perTaskChatName ? { perTaskChatName: opts.perTaskChatName } : {}
+    });
+    this.sessionCardIds.set(opts.sessionId, messageId);
+    if (typeof opts.task?.id === "number") {
+      this.taskToSessionId.set(opts.task.id, opts.sessionId);
+    }
+    return true;
+  }
+  sessionCardIds = new Map;
+  taskToSessionId = new Map;
+  findSessionCardBySessionId(sessionId) {
+    const messageId = this.sessionCardIds.get(sessionId);
+    if (!messageId)
+      return;
+    const state = this.sessionStates.get(messageId);
+    if (!state)
+      return;
+    return { messageId, state };
+  }
+  isSessionCardMessage(messageId) {
+    return this.sessionStates.has(messageId);
+  }
+  applyTaskEventToSessionCard(messageId, delta) {
+    const state = this.sessionStates.get(messageId);
+    if (!state) {
+      throw new Error(`applyTaskEventToSessionCard: ${messageId} 不是 session 卡（调用方应先 isSessionCardMessage）`);
+    }
+    const nowIso = delta.nowIso ?? new Date().toISOString();
+    const stepsAsMilestones = (delta.processSteps ?? []).filter((s) => typeof s.title === "string" && s.title.trim() !== "").map((s) => ({
+      title: s.title,
+      ...s.timestamp ? { timestamp: s.timestamp } : {},
+      ...s.description ? { description: s.description } : {}
+    }));
+    const mergedMilestones = mergeUnique(state.milestones ?? [], [...delta.milestones ?? [], ...stepsAsMilestones], milestoneKey);
+    const prevTask = state.task;
+    const metaId = delta.meta?.id;
+    const metaIdNum = typeof metaId === "number" ? metaId : typeof metaId === "string" && metaId.trim() !== "" ? Number(metaId) : undefined;
+    const hasTaskDelta = delta.meta !== undefined || delta.status !== undefined || delta.progress !== undefined;
+    const hasValidTaskId = typeof metaIdNum === "number" && Number.isFinite(metaIdNum) && metaIdNum > 0;
+    const shouldRenderTaskPanel = hasValidTaskId || prevTask !== undefined;
+    const nextTask = hasTaskDelta && shouldRenderTaskPanel ? {
+      id: typeof metaIdNum === "number" && Number.isFinite(metaIdNum) ? metaIdNum : prevTask?.id ?? 0,
+      ...delta.meta?.title ?? prevTask?.title ? { title: delta.meta?.title ?? prevTask?.title } : {},
+      ...delta.status ?? prevTask?.status ? { status: delta.status ?? prevTask?.status } : {},
+      ...delta.progress !== undefined || prevTask?.progress !== undefined ? { progress: delta.progress ?? prevTask?.progress } : {},
+      ...delta.meta?.currentStatus ?? prevTask?.currentStatus ? { currentStatus: delta.meta?.currentStatus ?? prevTask?.currentStatus } : {},
+      ...delta.meta?.priority ?? prevTask?.priority ? { priority: delta.meta?.priority ?? prevTask?.priority } : {},
+      ...delta.meta?.parentTaskId !== undefined || prevTask?.parentTaskId !== undefined ? { parentTaskId: delta.meta?.parentTaskId ?? prevTask?.parentTaskId } : {},
+      ...delta.meta?.goals ?? prevTask?.goals ? { goals: delta.meta?.goals ?? prevTask?.goals } : {},
+      ...prevTask?.createdAt ? { createdAt: prevTask.createdAt } : {},
+      ...prevTask?.updatedAt ? { updatedAt: prevTask.updatedAt } : {},
+      ...prevTask?.milestones ? { milestones: prevTask.milestones } : {}
+    } : prevTask;
+    const perTaskChatId = delta.clearPerTaskChat ? undefined : delta.perTaskChatId ?? state.perTaskChatId;
+    const perTaskChatName = delta.clearPerTaskChat ? undefined : delta.perTaskChatName ?? state.perTaskChatName;
+    const lifecycle = delta.lifecycle ?? state.lifecycle ?? "running";
+    const bump = delta.bumpUpdateCount !== false;
+    const updateCount = bump ? (state.updateCount ?? 1) + 1 : state.updateCount ?? 1;
+    const card = buildSessionCard({
+      sessionId: state.sessionId ?? "",
+      title: state.title,
+      statusPhrase: state.statusPhrase,
+      agentType: state.agentType,
+      startedAt: state.startedAt,
+      elapsedText: state.elapsedText,
+      milestones: mergedMilestones,
+      lifecycle,
+      updateCount,
+      ...delta.activity !== undefined ? { activity: delta.activity } : state.activity !== undefined ? { activity: state.activity } : {},
+      ...state.recentMessages !== undefined ? { recentMessages: state.recentMessages } : {},
+      ...nextTask !== undefined ? { task: nextTask } : {},
+      ...perTaskChatId ? { perTaskChatId } : {},
+      ...perTaskChatName ? { perTaskChatName } : {}
+    });
+    this.sessionStates.set(messageId, {
+      ...state,
+      milestones: mergedMilestones,
+      updateCount,
+      lifecycle,
+      ...nextTask !== undefined ? { task: nextTask } : {},
+      ...perTaskChatId ? { perTaskChatId } : { perTaskChatId: undefined },
+      ...perTaskChatName ? { perTaskChatName } : { perTaskChatName: undefined },
+      ...delta.activity !== undefined ? { activity: delta.activity } : {}
+    });
+    return card;
+  }
+  bindTaskToSession(taskId, sessionId) {
+    if (!Number.isFinite(taskId) || taskId <= 0)
+      return;
+    if (typeof sessionId !== "string" || !sessionId.trim())
+      return;
+    this.taskToSessionId.set(taskId, sessionId);
+  }
+  adoptSessionCard(sessionId, messageId, state) {
+    if (!sessionId || !messageId)
+      return;
+    this.sessionCardIds.set(sessionId, messageId);
+    this.rememberSessionCard(messageId, {
+      sessionId,
+      ...state ?? {}
+    });
+  }
+  persistSessionCardRecord(sessionId, messageId, chatId, profile) {
+    if (!this.sessionStore)
+      return;
+    try {
+      const now = Date.now();
+      const existing = this.sessionStore.get(sessionId);
+      this.sessionStore.upsert({
+        sessionId,
+        messageId,
+        chatId,
+        ...profile ?? existing?.profile ? { profile: profile ?? existing?.profile } : {},
+        createdAt: existing?.createdAt ?? now,
+        updatedAt: now
+      });
+    } catch (err) {
+      logger2.warn(`persistSessionCardRecord failed for ${sessionId}: ${err.message}`);
+    }
+  }
+  restoreSessionCardsFromStore() {
+    if (!this.sessionStore)
+      return 0;
+    let n = 0;
+    try {
+      for (const rec of this.sessionStore.list()) {
+        if (!rec.sessionId || !rec.messageId)
+          continue;
+        if (this.sessionCardIds.has(rec.sessionId))
+          continue;
+        this.sessionCardIds.set(rec.sessionId, rec.messageId);
+        if (!this.sessionStates.has(rec.messageId)) {
+          this.sessionStates.set(rec.messageId, {
+            ...rec.profile ? { profile: rec.profile } : {},
+            sessionId: rec.sessionId,
+            milestones: [],
+            updateCount: 1
+          });
+        }
+        n += 1;
+      }
+    } catch (err) {
+      logger2.warn(`restoreSessionCardsFromStore failed: ${err.message}`);
+    }
+    if (n > 0) {
+      logger2.info(`restoreSessionCardsFromStore: 回灌 ${n} 张 session 卡`);
+    }
+    return n;
+  }
+  applySessionGroupChange(messageId, opts) {
+    const state = this.sessionStates.get(messageId);
+    if (!state)
+      return;
+    const chatId = opts.perTaskChatId?.trim();
+    if (chatId) {
+      state.perTaskChatId = chatId;
+      if (opts.perTaskChatName)
+        state.perTaskChatName = opts.perTaskChatName;
+    } else {
+      delete state.perTaskChatId;
+      delete state.perTaskChatName;
+    }
+    return buildSessionCard({
+      sessionId: opts.sessionId,
+      title: state.title,
+      statusPhrase: state.statusPhrase,
+      agentType: state.agentType,
+      startedAt: state.startedAt,
+      elapsedText: state.elapsedText,
+      milestones: state.milestones,
+      updateCount: state.updateCount,
+      lifecycle: state.lifecycle,
+      ...state.activity !== undefined ? { activity: state.activity } : {},
+      ...state.recentMessages !== undefined ? { recentMessages: state.recentMessages } : {},
+      ...state.task !== undefined ? { task: state.task } : {},
+      ...state.perTaskChatId ? { perTaskChatId: state.perTaskChatId } : {},
+      ...state.perTaskChatName ? { perTaskChatName: state.perTaskChatName } : {}
+    });
+  }
+  getSessionIdByTask(taskId) {
+    if (!Number.isFinite(taskId))
+      return;
+    return this.taskToSessionId.get(taskId);
+  }
+  getSessionCardMessageId(sessionId) {
+    return this.sessionCardIds.get(sessionId);
+  }
+  getSessionCardState(sessionId) {
+    const messageId = this.sessionCardIds.get(sessionId);
+    if (!messageId)
+      return;
+    return this.sessionStates.get(messageId);
+  }
+  async syncGroupCardFromOrigin(originSessionId, opts, findGroupSession) {
+    if (!findGroupSession)
+      return false;
+    let chatId;
+    try {
+      const group = await findGroupSession(originSessionId);
+      chatId = group?.chatId;
+    } catch (err) {
+      logger2.warn(`syncGroupCardFromOrigin: findGroupChatForSession(${originSessionId}) 失败（跳过双写）: ` + `${err.message}`);
+      return false;
+    }
+    if (!chatId || chatId === originSessionId)
+      return false;
+    try {
+      await this.upsertSessionCard({
+        chatId,
+        sessionId: chatId,
+        lifecycle: opts.lifecycle ?? "running",
+        ...opts.title ? { title: opts.title } : {},
+        ...opts.milestones ? { milestones: opts.milestones } : {}
+      });
+      return true;
+    } catch (err) {
+      logger2.warn(`syncGroupCardFromOrigin: 群卡同步失败（chatId=${chatId}）: ` + `${err.message}`);
+      return false;
+    }
+  }
+  async upsertSessionCard(opts) {
+    const mutex = this.sessionUpsertMutexes.get(opts.sessionId) ?? new MutexImpl;
+    this.sessionUpsertMutexes.set(opts.sessionId, mutex);
+    const result = await mutex.run(async () => {
+      const patched = await this.updateSessionCard(opts);
+      if (patched) {
+        const messageId = this.sessionCardIds.get(opts.sessionId);
+        return { messageId, created: false };
+      }
+      const res = await this.startSessionCard(opts);
+      return { messageId: res.messageId, created: true };
+    });
+    if (opts.lifecycle !== "running") {
+      this.sessionUpsertMutexes.delete(opts.sessionId);
+    }
+    return result;
+  }
+  sessionUpsertMutexes = new Map;
+  async startSessionCard(opts) {
+    const card = buildSessionCard({
+      sessionId: opts.sessionId,
+      title: opts.title,
+      statusPhrase: opts.statusPhrase,
+      agentType: opts.agentType,
+      startedAt: opts.startedAt,
+      elapsedText: opts.elapsedText,
+      milestones: opts.milestones,
+      lifecycle: opts.lifecycle,
+      updateCount: 1,
+      ...opts.activity !== undefined ? { activity: opts.activity } : {},
+      ...opts.task !== undefined ? { task: opts.task } : {},
+      ...opts.perTaskChatId ? { perTaskChatId: opts.perTaskChatId } : {},
+      ...opts.perTaskChatName ? { perTaskChatName: opts.perTaskChatName } : {}
+    });
+    const stdout = await this.runLarkCli(this.buildSendCardArgs({ chatId: opts.chatId, profile: opts.profile, card }), "send");
+    const messageId = this.extractMessageId(stdout);
+    if (!messageId) {
+      throw new Error(`lark-cli +messages-send did not return message_id: ${stdout.slice(0, 500)}`);
+    }
+    this.sessionCardIds.set(opts.sessionId, messageId);
+    if (typeof opts.task?.id === "number" && opts.task.id > 0) {
+      this.taskToSessionId.set(opts.task.id, opts.sessionId);
+    }
+    this.rememberSessionCard(messageId, {
+      profile: opts.profile,
+      sessionId: opts.sessionId,
+      title: opts.title,
+      statusPhrase: opts.statusPhrase,
+      agentType: opts.agentType,
+      startedAt: opts.startedAt,
+      elapsedText: opts.elapsedText,
+      milestones: opts.milestones ?? [],
+      updateCount: 1,
+      lifecycle: opts.lifecycle,
+      ...opts.activity !== undefined ? { activity: opts.activity } : {},
+      ...opts.task !== undefined ? { task: opts.task } : {},
+      ...opts.perTaskChatId ? { perTaskChatId: opts.perTaskChatId } : {},
+      ...opts.perTaskChatName ? { perTaskChatName: opts.perTaskChatName } : {}
+    });
+    let pinned = false;
+    let pinError;
+    if (this.options.pinOnStart) {
+      try {
+        await this.pinMessage(messageId, opts.profile);
+        pinned = true;
+      } catch (err) {
+        pinError = err.message;
+      }
+    }
+    this.persistSessionCardRecord(opts.sessionId, messageId, opts.chatId, opts.profile);
+    return { messageId, pinned, ...pinError ? { pinError } : {} };
+  }
+  buildSessionCardWithActivity(messageId, sessionId, activity, opts = {}) {
+    const state = this.sessionStates.get(messageId);
+    if (!state)
+      return;
+    const card = buildSessionCard({
+      sessionId,
+      title: state.title,
+      statusPhrase: state.statusPhrase,
+      agentType: state.agentType,
+      startedAt: state.startedAt,
+      elapsedText: state.elapsedText,
+      milestones: state.milestones,
+      updateCount: state.updateCount,
+      activity,
+      ...opts.lifecycle !== undefined ? { lifecycle: opts.lifecycle } : state.lifecycle !== undefined ? { lifecycle: state.lifecycle } : {},
+      ...opts.task !== undefined ? { task: opts.task } : state.task !== undefined ? { task: state.task } : {},
+      ...state.perTaskChatId ? { perTaskChatId: state.perTaskChatId } : {},
+      ...state.perTaskChatName ? { perTaskChatName: state.perTaskChatName } : {},
+      ...opts.recentMessages !== undefined ? { recentMessages: opts.recentMessages } : state.recentMessages !== undefined ? { recentMessages: state.recentMessages } : {},
+      ...opts.now !== undefined ? { activityNow: opts.now } : {}
+    });
+    if (opts.task !== undefined) {
+      this.rememberSessionCard(messageId, { task: opts.task });
+      if (typeof opts.task.id === "number" && opts.task.id > 0) {
+        this.taskToSessionId.set(opts.task.id, sessionId);
+      }
+    }
+    if (opts.recentMessages !== undefined) {
+      this.rememberSessionCard(messageId, {
+        recentMessages: opts.recentMessages
+      });
+    }
+    if (opts.lifecycle !== undefined) {
+      this.rememberSessionCard(messageId, { lifecycle: opts.lifecycle });
+    }
+    if (activity !== undefined) {
+      this.rememberSessionCard(messageId, { activity });
+    }
+    return card;
+  }
+  rememberSessionCard(messageId, state) {
+    const prev = this.sessionStates.get(messageId);
+    this.sessionStates.set(messageId, {
+      title: state.title ?? prev?.title,
+      statusPhrase: state.statusPhrase ?? prev?.statusPhrase,
+      agentType: state.agentType ?? prev?.agentType,
+      startedAt: state.startedAt ?? prev?.startedAt,
+      elapsedText: state.elapsedText ?? prev?.elapsedText,
+      milestones: state.milestones ?? prev?.milestones ?? [],
+      updateCount: state.updateCount ?? prev?.updateCount ?? 1,
+      lifecycle: state.lifecycle ?? prev?.lifecycle,
+      profile: state.profile ?? prev?.profile,
+      sessionId: state.sessionId ?? prev?.sessionId,
+      activity: state.activity !== undefined ? state.activity : prev?.activity,
+      recentMessages: state.recentMessages !== undefined ? state.recentMessages : prev?.recentMessages,
+      task: state.task ?? prev?.task,
+      perTaskChatId: state.perTaskChatId ?? prev?.perTaskChatId,
+      perTaskChatName: state.perTaskChatName ?? prev?.perTaskChatName
+    });
+  }
   finalisedCards = new Set;
+  unfinaliseCard(messageId) {
+    this.finalisedCards.delete(messageId);
+  }
+  testRunner;
   trackedCardCount() {
     return this.states.size;
   }
@@ -932,7 +1940,7 @@ class LarkCardPatchNotifier {
         pinned = true;
       } catch (pinErr) {
         pinError = pinErr.message;
-        logger.warn(`Pin failed (non-fatal) for workflow message ${messageId}: ${pinError}`);
+        logger2.warn(`Pin failed (non-fatal) for workflow message ${messageId}: ${pinError}`);
       }
     }
     return { messageId, pinned, pinError };
@@ -940,7 +1948,7 @@ class LarkCardPatchNotifier {
   async updateWorkflow(opts) {
     await this.mutexFor(opts.messageId).run(async () => {
       if (this.finalisedCards.has(opts.messageId)) {
-        logger.debug(`updateWorkflow: message ${opts.messageId} 已是终态卡片，忽略迟到的更新`);
+        logger2.debug(`updateWorkflow: message ${opts.messageId} 已是终态卡片，忽略迟到的更新`);
         return;
       }
       const state = this.workflowStates.get(opts.messageId) ?? {
@@ -1045,7 +2053,7 @@ class LarkCardPatchNotifier {
           profile: opts.profile ?? state?.profile
         }), "unpin");
       } catch (unpinErr) {
-        logger.warn(`Unpin failed (non-fatal) for workflow ${opts.messageId}: ${unpinErr.message}`);
+        logger2.warn(`Unpin failed (non-fatal) for workflow ${opts.messageId}: ${unpinErr.message}`);
       }
     }
     this.workflowStates.delete(opts.messageId);
@@ -1119,6 +2127,9 @@ class LarkCardPatchNotifier {
     return args;
   }
   runLarkCli(argv, op) {
+    if (this.testRunner) {
+      return this.testRunner(argv, op);
+    }
     return new Promise((resolve, reject) => {
       if (process.env.ROY_HOOK_DEBUG === "1") {
         console.error(`[DEBUG LarkCardPatchNotifier.runLarkCli] op=${op} args=${JSON.stringify(argv).slice(0, 300)}`);
@@ -1362,5 +2373,17 @@ function sanitize(text) {
     return trimmed;
   return `${trimmed.slice(0, 500)}…`;
 }
+var sharedNotifier;
+function getSharedLarkCardNotifier() {
+  if (!sharedNotifier)
+    sharedNotifier = new LarkCardPatchNotifier;
+  return sharedNotifier;
+}
+function __resetSharedLarkCardNotifierForTest() {
+  sharedNotifier = undefined;
+}
+function hasSharedLarkCardNotifier() {
+  return sharedNotifier !== undefined;
+}
 
-export { formatTimestampForDisplay, sanitizeInlineText, HEAD_TITLE_MAX_WIDTH, truncateHeadTitle, formatDateTimeForDisplay, renderProgressBar, resolveTaskTitleForDisplay, humanizeValue, isTerminalStatusForTimeline, isTerminalStatusForWorkflowTimeline, buildCollapsiblePanel, renderTaskInfoLines, renderContextAsLines, renderMilestones, renderProcessSteps, partitionProcessSteps, buildTaskCard, buildChatAppLink, DEFAULT_APP_LINK_BASE, formatDurationMs, renderWorkflowInfoLines, buildWorkflowCard, LarkCardPatchNotifier };
+export { MemoryLarkCardStateStore, SqliteLarkCardStateStore, getDefaultLarkCardDbPath, createLarkCardStateStore, getSharedLarkCardStateStore, formatTimestampForDisplay, sanitizeInlineText, HEAD_TITLE_MAX_WIDTH, truncateHeadTitle, formatDateTimeForDisplay, renderProgressBar, resolveTaskTitleForDisplay, humanizeValue, isTerminalStatusForTimeline, isTerminalStatusForWorkflowTimeline, buildCollapsiblePanel, renderTaskInfoLines, renderContextAsLines, renderMilestones, renderProcessSteps, partitionProcessSteps, buildTaskCard, buildSessionCard, buildChatAppLink, DEFAULT_APP_LINK_BASE, formatDurationMs, renderWorkflowInfoLines, buildWorkflowCard, LarkCardPatchNotifier, getSharedLarkCardNotifier, __resetSharedLarkCardNotifierForTest, hasSharedLarkCardNotifier };