@ai-setting/roy-agent-core 1.7.93 → 1.7.94

package/dist/shared/@ai-setting/{roy-agent-core-mp7sqfb5.js → roy-agent-core-18xsrema.js}

@@ -1,6 +1,6 @@
 import {
   builtInHandlers
-} from "./roy-agent-core-33n84tf9.js";
+} from "./roy-agent-core-w9qpbpa1.js";
 import {
   appendAuditLog,
   checkSourceCountDrop,

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

@@ -33,7 +33,7 @@ import {
   createLarkCardStateStore,
   getSharedLarkCardNotifier,
   humanizeValue
-} from "./roy-agent-core-0yzxapfa.js";
+} from "./roy-agent-core-stcr4w4f.js";
 import {
   RECENT_MESSAGE_LIMIT
 } from "./roy-agent-core-418zc9ha.js";
@@ -1795,7 +1795,8 @@ var execAsync = promisify(exec);
 var KNOWN_CARD_ACTIONS = new Set([
   "create_group",
   "disband_group",
-  "refresh_activity"
+  "refresh_activity",
+  "select_task"
 ]);
 function isCardActionName(v) {
   return typeof v === "string" && KNOWN_CARD_ACTIONS.has(v);
@@ -1803,7 +1804,8 @@ function isCardActionName(v) {
 var ACTION_SUBJECT_FIELD = {
   create_group: "taskId or sessionId",
   disband_group: "taskId or sessionId",
-  refresh_activity: "sessionId"
+  refresh_activity: "sessionId",
+  select_task: "taskId or sessionId"
 };
 function validateCardActionValue(raw) {
   const action = raw.action;
@@ -1844,6 +1846,25 @@ function validateCardActionValue(raw) {
       error: `Missing required field: ${requiredField} (action=${action})`
     };
   }
+  if (action === "select_task") {
+    const rawTaskId = raw.taskId;
+    const taskId = typeof rawTaskId === "number" ? rawTaskId : typeof rawTaskId === "string" ? parseInt(rawTaskId, 10) : Number.NaN;
+    if (rawTaskId === undefined || rawTaskId === null || rawTaskId === "") {
+      return {
+        ok: false,
+        action,
+        error: `Missing required field: taskId (action=${action}; sessionId=${sessionId})`
+      };
+    }
+    if (!Number.isFinite(taskId) || Number.isNaN(taskId) || taskId <= 0) {
+      return {
+        ok: false,
+        action,
+        error: `Invalid taskId: ${String(rawTaskId)} (action=${action})`
+      };
+    }
+    return { ok: true, action, sessionId, taskId };
+  }
   return { ok: true, action, sessionId };
 }
 function extractTargetSessionId(context) {
@@ -1923,6 +1944,13 @@ async function handleCardAction(event, ports) {
   if (validation.action === "refresh_activity") {
     return await handleRefreshSessionCard(event, ports);
   }
+  if (validation.action === "select_task") {
+    const sel = validation;
+    return await handleSelectTask(event, ports, {
+      sessionId: sel.sessionId,
+      taskId: sel.taskId
+    });
+  }
   const groupValidation = validation;
   const action = groupValidation.action;
   const taskId = groupValidation.taskId;
@@ -2292,6 +2320,14 @@ function parseTaskIdLoose(raw) {
 async function handleRefreshSessionActivity(event, ports, subject) {
   const action = "refresh_activity";
   const sessionId = subject.sessionId;
+  if (subject.taskId !== undefined && ports.notifier?.isTaskCardMessage?.(event.messageId) && !ports.notifier?.isSessionCardMessage?.(event.messageId)) {
+    logger6.info(`handleRefreshSessionActivity: messageId=${event.messageId} 是 task 卡 ` + `(task #${subject.taskId})，refresh_activity 委托 task 路径（保持卡身份）`);
+    const taskCard = await ports.getTask?.(subject.taskId);
+    if (taskCard) {
+      return await handleRefreshActivity(event, ports, taskCard, subject.taskId);
+    }
+    logger6.warn(`handleRefreshSessionActivity: task #${subject.taskId} 读取失败，` + `refresh_activity 回落 session 路径`);
+  }
   let probe;
   try {
     probe = await ports.loadSessionActivity?.(sessionId);
@@ -2310,13 +2346,16 @@ async function handleRefreshSessionActivity(event, ports, subject) {
     logger6.warn(`handleRefreshSessionActivity: loadSessionMessages failed for ${sessionId}: ` + `${err.message}（降级为不渲染最近消息面板）`);
     recentMessages = undefined;
   }
+  const sessionTaskList = await loadSessionTasksSafe(sessionId, ports);
+  const sessionTasks = sessionTaskList.tasks;
   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 } : {}
+    ...recentMessages !== undefined ? { recentMessages } : {},
+    sessionTasks
   });
   if (preserved) {
     logger6.debug(`handleRefreshSessionActivity: ${sessionId} 活性已刷新 ` + `(messageCount=${snapshot?.messageCount ?? "n/a"}, task=${subject.taskId ?? "none"})`);
@@ -2331,9 +2370,118 @@ async function handleRefreshSessionActivity(event, ports, subject) {
       sessionId,
       activity: snapshot,
       lifecycle,
+      ...sessionTasks.length > 0 ? { tasks: sessionTasks } : {},
+      ...sessionTaskList.total !== undefined ? { taskTotal: sessionTaskList.total } : {},
       ...taskEnrichment?.info ? { task: taskEnrichment.info } : {},
       ...groupChat?.chatId ? { perTaskChatId: groupChat.chatId } : {},
-      ...recentMessages !== undefined ? { recentMessages } : {}
+      ...recentMessages !== undefined ? { recentMessages } : {},
+      ...sessionTasks.length > 0 ? { tasks: sessionTasks } : {}
+    })
+  };
+}
+function toTaskSummary(raw) {
+  if (!raw || typeof raw !== "object")
+    return;
+  const r = raw;
+  const id = typeof r.id === "number" ? r.id : typeof r.id === "string" ? parseInt(r.id, 10) : Number.NaN;
+  if (!Number.isFinite(id) || id <= 0)
+    return;
+  const currentStatus = typeof r.currentStatus === "string" ? r.currentStatus : typeof r.current_status === "string" ? r.current_status : undefined;
+  const goals = typeof r.goals === "string" ? r.goals : typeof r.goals_and_expected_deliverables === "string" ? r.goals_and_expected_deliverables : undefined;
+  const parentTaskId = typeof r.parentTaskId === "number" ? r.parentTaskId : typeof r.parent_task_id === "number" && r.parent_task_id > 0 ? r.parent_task_id : undefined;
+  const createdAt = typeof r.createdAt === "string" ? r.createdAt : typeof r.created_at === "string" ? r.created_at : undefined;
+  const updatedAt = typeof r.updatedAt === "string" ? r.updatedAt : typeof r.updated_at === "string" ? r.updated_at : undefined;
+  return {
+    id,
+    ...typeof r.title === "string" && r.title ? { title: r.title } : {},
+    ...typeof r.status === "string" && r.status ? { status: r.status } : {},
+    ...typeof r.progress === "number" ? { progress: r.progress } : {},
+    ...currentStatus ? { currentStatus } : {},
+    ...typeof r.priority === "string" && r.priority ? { priority: r.priority } : {},
+    ...parentTaskId !== undefined ? { parentTaskId } : {},
+    ...goals ? { goals } : {},
+    ...createdAt ? { createdAt } : {},
+    ...updatedAt ? { updatedAt } : {}
+  };
+}
+async function loadSessionTasksSafe(sessionId, ports) {
+  try {
+    const raw = await ports.loadSessionTasks?.(sessionId);
+    const list = Array.isArray(raw) ? raw : raw?.tasks;
+    if (!Array.isArray(list))
+      return { tasks: [] };
+    const tasks = list.map((t) => toTaskSummary(t)).filter((t) => t !== undefined);
+    const total = !Array.isArray(raw) && typeof raw?.total === "number" ? raw.total : undefined;
+    return { tasks, ...total !== undefined ? { total } : {} };
+  } catch (err) {
+    logger6.warn(`loadSessionTasksSafe: ${sessionId} 读取失败（任务列表面板降级为空）: ` + `${err.message}`);
+    return { tasks: [] };
+  }
+}
+async function handleSelectTask(event, ports, subject) {
+  const action = "select_task";
+  const { sessionId, taskId } = subject;
+  const taskListResult = await loadSessionTasksSafe(sessionId, ports);
+  const tasks = taskListResult.tasks;
+  if (tasks.length > 0 && !tasks.some((t) => t.id === taskId)) {
+    logger6.warn(`handleSelectTask: task #${taskId} 不属于 ${sessionId}（列表 ${tasks.length} 个）→ 忽略本次切换`);
+    return {
+      ok: false,
+      action,
+      error: `task #${taskId} is not a member of session ${sessionId}`
+    };
+  }
+  let selectedTask;
+  try {
+    const raw = await ports.getTask?.(taskId);
+    selectedTask = toTaskSummary(raw);
+  } catch (err) {
+    logger6.warn(`handleSelectTask: getTask(${taskId}) 失败（降级为不渲染任务详情）: ` + `${err.message}`);
+    selectedTask = undefined;
+  }
+  if (!selectedTask) {
+    selectedTask = tasks.find((t) => t.id === taskId);
+  }
+  let milestones;
+  try {
+    const raw = await ports.loadTaskMilestones?.(taskId);
+    milestones = Array.isArray(raw) ? raw : undefined;
+  } catch (err) {
+    logger6.warn(`handleSelectTask: loadTaskMilestones(${taskId}) 失败（里程碑区降级为空）: ` + `${err.message}`);
+    milestones = undefined;
+  }
+  let probe;
+  try {
+    probe = await ports.loadSessionActivity?.(sessionId);
+  } catch (err) {
+    logger6.warn(`handleSelectTask: loadSessionActivity(${sessionId}) 失败（沿用上次快照）: ` + `${err.message}`);
+    probe = undefined;
+  }
+  const stateActivity = ports.notifier?.getSessionCardState?.(sessionId)?.activity;
+  const activitySnapshot = probe ? probe.activity ?? null : stateActivity ?? null;
+  const patched = ports.notifier?.buildSessionCardWithActivity?.(event.messageId, sessionId, activitySnapshot, {
+    ...probe?.lifecycle ? { lifecycle: probe.lifecycle } : {},
+    sessionTasks: tasks,
+    ...taskListResult.total !== undefined ? { taskTotal: taskListResult.total } : {},
+    ...selectedTask ? { selectedTask } : {},
+    ...milestones !== undefined ? { selectedTaskMilestones: milestones } : {}
+  });
+  if (patched) {
+    logger6.debug(`handleSelectTask: ${sessionId} 切到 task #${taskId}（列表 ${tasks.length} 个任务）`);
+    return { ok: true, action, cardUpdate: patched };
+  }
+  logger6.warn(`handleSelectTask: notifier 无 messageId=${event.messageId} 的状态，fallback 重建 session 卡`);
+  return {
+    ok: true,
+    action,
+    cardUpdate: buildSessionCard({
+      sessionId,
+      tasks,
+      ...taskListResult.total !== undefined ? { taskTotal: taskListResult.total } : {},
+      ...selectedTask ? { selectedTask } : {},
+      ...milestones !== undefined ? { selectedTaskMilestones: milestones } : {},
+      ...probe?.activity !== undefined ? { activity: probe.activity } : {},
+      ...probe?.lifecycle ? { lifecycle: probe.lifecycle } : {}
     })
   };
 }
@@ -2600,6 +2748,7 @@ class LarkCliTaskNotifyHook {
   pluginName;
   sourceId;
   config;
+  cardNotifyConfigReader;
   cardNotifier;
   cardMessageIds = new Map;
   cardStateStore;
@@ -2615,6 +2764,9 @@ class LarkCliTaskNotifyHook {
     this.description = "LarkCli 任务通知 Hook（卡片模式）";
     this.pluginName = config.pluginName;
     this.sourceId = config.sourceId;
+    if (config.cardNotifyConfigReader) {
+      this.cardNotifyConfigReader = config.cardNotifyConfigReader;
+    }
     this.config = {
       enabled: true,
       priority: 5,
@@ -2639,6 +2791,17 @@ class LarkCliTaskNotifyHook {
   hasCardRoutingPorts() {
     return this.cardRoutingPorts !== undefined;
   }
+  currentEmitTaskCard() {
+    if (this.config.emitTaskCard !== undefined) {
+      return this.config.emitTaskCard !== false;
+    }
+    try {
+      const flags = this.cardNotifyConfigReader?.();
+      if (flags)
+        return flags.emitTaskCard !== false;
+    } catch {}
+    return true;
+  }
   async execute(ctx) {
     if (!this.config.enabled) {
       return;
@@ -2676,6 +2839,7 @@ class LarkCliTaskNotifyHook {
     if (!this.isCardModeEnabled())
       return;
     const sessionId = typeof ctxSessionId === "string" && ctxSessionId.trim() ? ctxSessionId.trim() : this.resolveSessionIdForTask(task.id);
+    const emitTaskCard = this.currentEmitTaskCard();
     if (sessionId) {
       const merged = await this.patchSessionCardForTask(task, {
         sessionId,
@@ -2689,8 +2853,9 @@ class LarkCliTaskNotifyHook {
         ]
       });
       if (merged) {
-        logger7.debug(`onAfterCreate: task #${task.id} 已渲染进 session 卡 ${sessionId}（单卡语义）`);
-        return;
+        logger7.debug(`onAfterCreate: task #${task.id} 已渲染进 session 卡 ${sessionId}` + `（${emitTaskCard ? "并存：继续发任务卡片" : "单卡语义：不再发任务卡片"}）`);
+        if (!emitTaskCard)
+          return;
       }
     }
     await this.sendCardStart(task);
@@ -2707,6 +2872,7 @@ class LarkCliTaskNotifyHook {
         return;
       if (!this.isCardModeEnabled())
         return;
+      const emitTaskCardTerminal = this.currentEmitTaskCard();
       const sessionIdTerminal = this.resolveSessionIdForTask(task.id);
       if (sessionIdTerminal) {
         const mergedTerminal = await this.patchSessionCardForTask(task, {
@@ -2720,7 +2886,7 @@ class LarkCliTaskNotifyHook {
             }
           ]
         });
-        if (mergedTerminal)
+        if (mergedTerminal && !emitTaskCardTerminal)
           return;
       }
       await this.sendCardFinish(task);
@@ -2738,13 +2904,14 @@ class LarkCliTaskNotifyHook {
       return;
     if (!this.isCardModeEnabled())
       return;
+    const emitTaskCardUpdate = this.currentEmitTaskCard();
     const sessionIdUpdate = this.resolveSessionIdForTask(task.id);
     if (sessionIdUpdate) {
       const mergedUpdate = await this.patchSessionCardForTask(task, {
         sessionId: sessionIdUpdate,
         lifecycle: lifecycleOfTaskStatus(String(task.status)) ?? "running"
       });
-      if (mergedUpdate)
+      if (mergedUpdate && !emitTaskCardUpdate)
         return;
     }
     await this.sendCardUpdate(task, changes);
@@ -2917,7 +3084,9 @@ class LarkCliTaskNotifyHook {
       if (rec.sessionId) {
         this.cardNotifier?.bindTaskToSession?.(taskId, rec.sessionId);
         if (rec.messageId) {
-          this.cardNotifier?.adoptSessionCard?.(rec.sessionId, rec.messageId);
+          if (!this.currentEmitTaskCard()) {
+            this.cardNotifier?.adoptSessionCard?.(rec.sessionId, rec.messageId);
+          }
         }
       }
       if (!this.restoredTaskIds.has(taskId)) {
@@ -3485,6 +3654,8 @@ class LarkCliTaskNotifyHook {
   syncGroupCardFromOriginFn;
   recordSessionCardForTask(task, sessionId, chatId, profile, messageIdIn) {
     this.cardNotifier?.bindTaskToSession?.(task.id, sessionId);
+    if (this.currentEmitTaskCard())
+      return;
     if (!this.cardStateStore)
       return;
     const messageId = messageIdIn ?? this.cardNotifier?.getSessionCardMessageId?.(sessionId);
@@ -3578,6 +3749,12 @@ class LarkCliTaskNotifyHook {
 __legacyDecorateClassTS([
   TracedAs("lark-cli-task-notify.execute")
 ], LarkCliTaskNotifyHook.prototype, "execute", null);
+__legacyDecorateClassTS([
+  TracedAs("lark-card.restoreState", {
+    recordParams: true,
+    paramFilter: (args) => ({ taskId: args[0] })
+  })
+], LarkCliTaskNotifyHook.prototype, "restoreCardState", null);
 __legacyDecorateClassTS([
   TracedAs("lark-cli-task-notify.resolveCardTarget", {
     recordParams: true,
@@ -3595,6 +3772,24 @@ __legacyDecorateClassTS([
     })
   })
 ], LarkCliTaskNotifyHook.prototype, "resolveCardTarget", null);
+__legacyDecorateClassTS([
+  TracedAs("lark-card.sendStart", {
+    recordParams: false,
+    paramFilter: (args) => ({ taskId: args[0]?.id, sessionId: args[0]?.sessionId })
+  })
+], LarkCliTaskNotifyHook.prototype, "sendCardStart", null);
+__legacyDecorateClassTS([
+  TracedAs("lark-card.patchForTask", {
+    recordParams: true,
+    flattenParamFilter: true,
+    paramFilter: (args) => ({
+      taskId: args[0]?.id,
+      sessionId: args[0]?.sessionId,
+      lifecycle: args[1]?.lifecycle,
+      statusPhrase: args[1]?.statusPhrase
+    })
+  })
+], LarkCliTaskNotifyHook.prototype, "patchSessionCardForTask", null);
 function createLarkCliTaskNotifyHook(config = {}) {
   return new LarkCliTaskNotifyHook(config);
 }

package/dist/shared/@ai-setting/{roy-agent-core-0yzxapfa.js → roy-agent-core-stcr4w4f.js}

@@ -637,6 +637,47 @@ function renderProcessSteps(steps) {
   }).join(`
 `);
 }
+var SESSION_TASK_LIST_MAX = 5;
+function renderSessionTaskList(sessionId, tasks, taskTotal) {
+  const known = tasks.length;
+  const total = typeof taskTotal === "number" && taskTotal > known ? taskTotal : known;
+  const truncated = total > SESSION_TASK_LIST_MAX;
+  const recentFirst = [...tasks].sort((a, b) => b.id - a.id);
+  const ordered = recentFirst.slice(0, SESSION_TASK_LIST_MAX);
+  const title = truncated ? `\uD83D\uDCCB 任务列表（共 ${total} 个任务，最近 ${SESSION_TASK_LIST_MAX} 个）` : `\uD83D\uDCCB 任务列表（${total}）`;
+  const elements = [];
+  if (truncated) {
+    elements.push({
+      tag: "markdown",
+      content: `**共 ${total} 个任务，最近 ${SESSION_TASK_LIST_MAX} 个：**`
+    });
+  }
+  for (const t of ordered) {
+    const label = t.title ? `#${t.id} ${t.title}` : `#${t.id}`;
+    elements.push({
+      tag: "button",
+      text: {
+        tag: "plain_text",
+        content: `▶ ${sanitizeInlineText(label, 40)}`
+      },
+      type: "default",
+      value: {
+        action: "select_task",
+        sessionId,
+        taskId: String(t.id)
+      }
+    });
+    const meta = [];
+    if (t.status)
+      meta.push(`\uD83D\uDEA6 ${sanitizeInlineText(t.status, 20)}`);
+    if (typeof t.progress === "number")
+      meta.push(`\uD83D\uDCCA ${Math.round(t.progress)}%`);
+    if (meta.length > 0) {
+      elements.push({ tag: "markdown", content: `　　${meta.join(" · ")}` });
+    }
+  }
+  return { title, elements };
+}
 function milestoneKey(m) {
   return `${m.title}|${m.timestamp ?? ""}|${m.description ?? ""}`;
 }
@@ -796,7 +837,7 @@ function buildTaskCard(opts) {
   return {
     schema: "2.0",
     header: {
-      title: { tag: "plain_text", content: `\uD83D\uDCCA Task 实时更新（${taskLabel}）` },
+      title: { tag: "plain_text", content: `\uD83D\uDCCB 任务卡实时更新（${taskLabel}）` },
       subtitle: {
         tag: "plain_text",
         content: `spinner: '${spinner}' · 第 ${updateCount} 次更新 | ` + STATUS_PHRASE[status]
@@ -865,7 +906,8 @@ function buildSessionCard(opts) {
     appendHr(elements);
   }
   const taskInfo = opts.task;
-  if (taskInfo) {
+  const selectedDuplicatesBoundTask = taskInfo !== undefined && opts.selectedTask !== undefined && Number(opts.selectedTask.id) === Number(taskInfo.id);
+  if (taskInfo && !selectedDuplicatesBoundTask) {
     const taskLines = [];
     taskLines.push(`- **\uD83C\uDD94 任务 ID**：#${taskInfo.id}`);
     if (taskInfo.title) {
@@ -914,6 +956,39 @@ function buildSessionCard(opts) {
       appendHr(elements);
     }
   }
+  const taskList = opts.tasks ?? [];
+  if (taskList.length > 0) {
+    const listResult = renderSessionTaskList(opts.sessionId, taskList, opts.taskTotal);
+    elements.push(buildCollapsiblePanel({
+      title: listResult.title,
+      elementId: "session_task_list",
+      expanded: true,
+      elements: listResult.elements
+    }));
+    appendHr(elements);
+  }
+  if (opts.selectedTask) {
+    const sel = opts.selectedTask;
+    const selLines = [];
+    selLines.push(`- **\uD83C\uDD94 任务 ID**：#${sel.id}`);
+    if (sel.title)
+      selLines.push(`- **\uD83D\uDCCC 标题**：${sanitizeInlineText(sel.title, 120)}`);
+    if (sel.status)
+      selLines.push(`- **\uD83D\uDEA6 状态**：${sanitizeInlineText(sel.status, 40)}`);
+    if (typeof sel.progress === "number") {
+      selLines.push(`- **\uD83D\uDCCA 进度**：${renderProgressBar(sel.progress)}`);
+    }
+    if (sel.currentStatus) {
+      selLines.push(`- **\uD83D\uDCDD 当前状态**：${sanitizeInlineText(sel.currentStatus, 200)}`);
+    }
+    elements.push(buildCollapsiblePanel({
+      title: "\uD83D\uDCCB 任务信息",
+      elementId: "session_selected_task_detail",
+      elements: [{ tag: "markdown", content: selLines.join(`
+`) }]
+    }));
+    appendHr(elements);
+  }
   if (opts.activity !== undefined) {
     elements.push(buildCollapsiblePanel({
       title: "⚡ 子会话活性",
@@ -953,6 +1028,21 @@ function buildSessionCard(opts) {
       elements: [{ tag: "markdown", content: renderMilestones(milestones) }]
     }));
   }
+  if (opts.selectedTask) {
+    const selMilestones = opts.selectedTaskMilestones ?? [];
+    elements.push(buildCollapsiblePanel({
+      title: `\uD83D\uDCCC 任务里程碑（#${opts.selectedTask.id}，${selMilestones.length}）`,
+      elementId: "session_task_milestones",
+      expanded: selMilestones.length > 0,
+      elements: [
+        {
+          tag: "markdown",
+          content: selMilestones.length > 0 ? renderMilestones(selMilestones) : "（该任务暂无里程碑）"
+        }
+      ]
+    }));
+    appendHr(elements);
+  }
   const titleRaw = opts.title?.trim();
   const headLabel = titleRaw ? truncateHeadTitle(titleRaw) : truncateHeadTitle(sessionId);
   const lifecycle = opts.lifecycle ?? "running";
@@ -961,7 +1051,7 @@ function buildSessionCard(opts) {
   return {
     schema: "2.0",
     header: {
-      title: { tag: "plain_text", content: `\uD83D\uDCCA 子会话实时更新（${headLabel}）` },
+      title: { tag: "plain_text", content: `\uD83D\uDCAC 会话卡实时更新（${headLabel}）` },
       subtitle: {
         tag: "plain_text",
         content: `spinner: '${spinner}' · 第 ${updateCount} 次更新 | ${lifecyclePhrase}`
@@ -1159,6 +1249,7 @@ class LarkCardPatchNotifier {
       unpinOnFinish: false,
       ...(({ sessionCardStore: _scs, ...rest }) => rest)(options)
     };
+    this.restoreSessionCardsFromStore();
   }
   mutexFor(messageId) {
     let m = this.mutexes.get(messageId);
@@ -1520,6 +1611,7 @@ class LarkCardPatchNotifier {
       ...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.tasks !== undefined ? { tasks: opts.tasks, taskTotal: opts.tasks.length } : state.sessionTasks !== undefined ? { tasks: state.sessionTasks } : {},
       ...opts.perTaskChatId ?? state.perTaskChatId ? { perTaskChatId: opts.perTaskChatId ?? state.perTaskChatId } : {},
       ...opts.perTaskChatName ?? state.perTaskChatName ? { perTaskChatName: opts.perTaskChatName ?? state.perTaskChatName } : {}
     });
@@ -1535,6 +1627,7 @@ class LarkCardPatchNotifier {
       lifecycle: opts.lifecycle,
       ...opts.activity !== undefined ? { activity: opts.activity } : {},
       ...opts.task !== undefined ? { task: opts.task } : {},
+      ...opts.tasks !== undefined ? { sessionTasks: opts.tasks, taskTotal: opts.tasks.length } : {},
       ...opts.perTaskChatId ? { perTaskChatId: opts.perTaskChatId } : {},
       ...opts.perTaskChatName ? { perTaskChatName: opts.perTaskChatName } : {}
     });
@@ -1558,6 +1651,9 @@ class LarkCardPatchNotifier {
   isSessionCardMessage(messageId) {
     return this.sessionStates.has(messageId);
   }
+  isTaskCardMessage(messageId) {
+    return this.states.has(messageId) || this.finalisedCards.has(messageId);
+  }
   applyTaskEventToSessionCard(messageId, delta) {
     const state = this.sessionStates.get(messageId);
     if (!state) {
@@ -1787,6 +1883,7 @@ class LarkCardPatchNotifier {
       updateCount: 1,
       ...opts.activity !== undefined ? { activity: opts.activity } : {},
       ...opts.task !== undefined ? { task: opts.task } : {},
+      ...opts.tasks !== undefined ? { tasks: opts.tasks, taskTotal: opts.tasks.length } : {},
       ...opts.perTaskChatId ? { perTaskChatId: opts.perTaskChatId } : {},
       ...opts.perTaskChatName ? { perTaskChatName: opts.perTaskChatName } : {}
     });
@@ -1812,6 +1909,7 @@ class LarkCardPatchNotifier {
       lifecycle: opts.lifecycle,
       ...opts.activity !== undefined ? { activity: opts.activity } : {},
       ...opts.task !== undefined ? { task: opts.task } : {},
+      ...opts.tasks !== undefined ? { sessionTasks: opts.tasks, taskTotal: opts.tasks.length } : {},
       ...opts.perTaskChatId ? { perTaskChatId: opts.perTaskChatId } : {},
       ...opts.perTaskChatName ? { perTaskChatName: opts.perTaskChatName } : {}
     });
@@ -1847,6 +1945,10 @@ class LarkCardPatchNotifier {
       ...state.perTaskChatId ? { perTaskChatId: state.perTaskChatId } : {},
       ...state.perTaskChatName ? { perTaskChatName: state.perTaskChatName } : {},
       ...opts.recentMessages !== undefined ? { recentMessages: opts.recentMessages } : state.recentMessages !== undefined ? { recentMessages: state.recentMessages } : {},
+      ...opts.sessionTasks !== undefined ? { tasks: opts.sessionTasks } : state.sessionTasks !== undefined ? { tasks: state.sessionTasks } : {},
+      ...state.taskTotal !== undefined ? { taskTotal: state.taskTotal } : {},
+      ...opts.selectedTask !== undefined ? { selectedTask: opts.selectedTask } : state.selectedTask !== undefined ? { selectedTask: state.selectedTask } : {},
+      ...opts.selectedTaskMilestones !== undefined ? { selectedTaskMilestones: opts.selectedTaskMilestones } : state.selectedTaskMilestones !== undefined ? { selectedTaskMilestones: state.selectedTaskMilestones } : {},
       ...opts.now !== undefined ? { activityNow: opts.now } : {}
     });
     if (opts.task !== undefined) {
@@ -1863,6 +1965,20 @@ class LarkCardPatchNotifier {
     if (opts.lifecycle !== undefined) {
       this.rememberSessionCard(messageId, { lifecycle: opts.lifecycle });
     }
+    if (opts.sessionTasks !== undefined) {
+      this.rememberSessionCard(messageId, {
+        sessionTasks: opts.sessionTasks,
+        taskTotal: opts.sessionTasks.length
+      });
+    }
+    if (opts.selectedTask !== undefined) {
+      this.rememberSessionCard(messageId, { selectedTask: opts.selectedTask });
+    }
+    if (opts.selectedTaskMilestones !== undefined) {
+      this.rememberSessionCard(messageId, {
+        selectedTaskMilestones: opts.selectedTaskMilestones
+      });
+    }
     if (activity !== undefined) {
       this.rememberSessionCard(messageId, { activity });
     }
@@ -1885,7 +2001,11 @@ class LarkCardPatchNotifier {
       recentMessages: state.recentMessages !== undefined ? state.recentMessages : prev?.recentMessages,
       task: state.task ?? prev?.task,
       perTaskChatId: state.perTaskChatId ?? prev?.perTaskChatId,
-      perTaskChatName: state.perTaskChatName ?? prev?.perTaskChatName
+      perTaskChatName: state.perTaskChatName ?? prev?.perTaskChatName,
+      sessionTasks: state.sessionTasks !== undefined ? state.sessionTasks : prev?.sessionTasks,
+      taskTotal: state.taskTotal ?? prev?.taskTotal,
+      selectedTask: state.selectedTask ?? prev?.selectedTask,
+      selectedTaskMilestones: state.selectedTaskMilestones !== undefined ? state.selectedTaskMilestones : prev?.selectedTaskMilestones
     });
   }
   finalisedCards = new Set;
@@ -2251,6 +2371,31 @@ __legacyDecorateClassTS([
     })
   })
 ], LarkCardPatchNotifier.prototype, "finishTask", null);
+__legacyDecorateClassTS([
+  TracedAs("lark-card.adopt", {
+    recordParams: true,
+    paramFilter: (args) => ({ sessionId: args[0], messageId: args[1] })
+  })
+], LarkCardPatchNotifier.prototype, "adoptSessionCard", null);
+__legacyDecorateClassTS([
+  TracedAs("lark-card.restore", { recordParams: false, recordResult: true })
+], LarkCardPatchNotifier.prototype, "restoreSessionCardsFromStore", null);
+__legacyDecorateClassTS([
+  TracedAs("lark-card.upsert", {
+    recordParams: true,
+    flattenParamFilter: true,
+    paramFilter: (args) => {
+      const o = args[0] ?? {};
+      return {
+        chatId: o.chatId,
+        sessionId: o.sessionId,
+        title: o.title,
+        statusPhrase: o.statusPhrase,
+        lifecycle: o.lifecycle
+      };
+    }
+  })
+], LarkCardPatchNotifier.prototype, "upsertSessionCard", null);
 __legacyDecorateClassTS([
   TracedAs("lark-card.startWorkflow", {
     recordParams: true,
@@ -2386,4 +2531,4 @@ function hasSharedLarkCardNotifier() {
   return sharedNotifier !== undefined;
 }
 
-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 };
+export { MemoryLarkCardStateStore, SqliteLarkCardStateStore, getDefaultLarkCardDbPath, createLarkCardStateStore, getSharedLarkCardStateStore, formatTimestampForDisplay, sanitizeInlineText, HEAD_TITLE_MAX_WIDTH, truncateHeadTitle, formatDateTimeForDisplay, renderProgressBar, resolveTaskTitleForDisplay, humanizeValue, isTerminalStatusForTimeline, isTerminalStatusForWorkflowTimeline, buildCollapsiblePanel, renderTaskInfoLines, renderContextAsLines, renderMilestones, renderProcessSteps, SESSION_TASK_LIST_MAX, renderSessionTaskList, partitionProcessSteps, buildTaskCard, buildSessionCard, buildChatAppLink, DEFAULT_APP_LINK_BASE, formatDurationMs, renderWorkflowInfoLines, buildWorkflowCard, LarkCardPatchNotifier, getSharedLarkCardNotifier, __resetSharedLarkCardNotifierForTest, hasSharedLarkCardNotifier };