@ai-setting/roy-agent-core 1.7.55 → 1.7.57

package/dist/env/memory/index.js

@@ -3,7 +3,7 @@ import {
   MemoryComponent,
   SOURCE_PRIORITY,
   getSourcePriority
-} from "../../shared/@ai-setting/roy-agent-core-ak4dc3kg.js";
+} from "../../shared/@ai-setting/roy-agent-core-baaa4wtp.js";
 import {
   RecallMemorySchema,
   RecordMemorySchema
@@ -23,15 +23,15 @@ import {
   generateProjectSummary,
   parseMemoryAgentOutput,
   recallMemory
-} from "../../shared/@ai-setting/roy-agent-core-j5c3chtn.js";
+} from "../../shared/@ai-setting/roy-agent-core-cyefe8z5.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
-import"../../shared/@ai-setting/roy-agent-core-tdbv7ff4.js";
-import"../../shared/@ai-setting/roy-agent-core-qcspfszy.js";
-import"../../shared/@ai-setting/roy-agent-core-4z3rq5gw.js";
-import"../../shared/@ai-setting/roy-agent-core-k8b440n3.js";
-import"../../shared/@ai-setting/roy-agent-core-5apmk4qw.js";
-import"../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
-import"../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
+import"../../shared/@ai-setting/roy-agent-core-0kn3zt1t.js";
+import"../../shared/@ai-setting/roy-agent-core-ytd5eztz.js";
+import"../../shared/@ai-setting/roy-agent-core-yphwdm9x.js";
+import"../../shared/@ai-setting/roy-agent-core-m97jn2ra.js";
+import"../../shared/@ai-setting/roy-agent-core-syyw58p9.js";
+import"../../shared/@ai-setting/roy-agent-core-8p63s836.js";
+import"../../shared/@ai-setting/roy-agent-core-rt115qfc.js";
 import"../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {

package/dist/env/memory/plugin/index.js

@@ -13,8 +13,8 @@ import {
   generateProjectSummary,
   parseMemoryAgentOutput,
   recallMemory
-} from "../../../shared/@ai-setting/roy-agent-core-j5c3chtn.js";
-import"../../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
+} from "../../../shared/@ai-setting/roy-agent-core-cyefe8z5.js";
+import"../../../shared/@ai-setting/roy-agent-core-rt115qfc.js";
 import"../../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {

package/dist/env/plugin/index.js

@@ -1,23 +1,23 @@
 import {
   EventBusNotificationChannel,
   PluginComponent
-} from "../../shared/@ai-setting/roy-agent-core-t37wbysj.js";
+} from "../../shared/@ai-setting/roy-agent-core-hs41gx9w.js";
 import {
   normalizeLarkAtMentions
 } from "../../shared/@ai-setting/roy-agent-core-64f22h1g.js";
 import {
   BasePlugin
 } from "../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
-import"../../shared/@ai-setting/roy-agent-core-tdbv7ff4.js";
-import"../../shared/@ai-setting/roy-agent-core-qcspfszy.js";
-import"../../shared/@ai-setting/roy-agent-core-4z3rq5gw.js";
-import"../../shared/@ai-setting/roy-agent-core-k8b440n3.js";
-import"../../shared/@ai-setting/roy-agent-core-5apmk4qw.js";
-import"../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
+import"../../shared/@ai-setting/roy-agent-core-0kn3zt1t.js";
+import"../../shared/@ai-setting/roy-agent-core-ytd5eztz.js";
+import"../../shared/@ai-setting/roy-agent-core-yphwdm9x.js";
+import"../../shared/@ai-setting/roy-agent-core-m97jn2ra.js";
+import"../../shared/@ai-setting/roy-agent-core-syyw58p9.js";
+import"../../shared/@ai-setting/roy-agent-core-8p63s836.js";
 import {
   createLogger,
   init_logger
-} from "../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
+} from "../../shared/@ai-setting/roy-agent-core-rt115qfc.js";
 import"../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 // src/env/plugin/lark-cli-notification-channel.ts

package/dist/env/prompt/index.js

@@ -3,17 +3,17 @@ import {
   PromptConfigSchema,
   PromptPathSchema,
   PromptRenderer
-} from "../../shared/@ai-setting/roy-agent-core-12d2xap8.js";
+} from "../../shared/@ai-setting/roy-agent-core-em4hks9t.js";
 import"../../shared/@ai-setting/roy-agent-core-6masakz4.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
-import"../../shared/@ai-setting/roy-agent-core-tdbv7ff4.js";
-import"../../shared/@ai-setting/roy-agent-core-qcspfszy.js";
-import"../../shared/@ai-setting/roy-agent-core-4z3rq5gw.js";
-import"../../shared/@ai-setting/roy-agent-core-k8b440n3.js";
-import"../../shared/@ai-setting/roy-agent-core-5apmk4qw.js";
-import"../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
-import"../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
+import"../../shared/@ai-setting/roy-agent-core-0kn3zt1t.js";
+import"../../shared/@ai-setting/roy-agent-core-ytd5eztz.js";
+import"../../shared/@ai-setting/roy-agent-core-yphwdm9x.js";
+import"../../shared/@ai-setting/roy-agent-core-m97jn2ra.js";
+import"../../shared/@ai-setting/roy-agent-core-syyw58p9.js";
+import"../../shared/@ai-setting/roy-agent-core-8p63s836.js";
+import"../../shared/@ai-setting/roy-agent-core-rt115qfc.js";
 import"../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {

package/dist/env/session/index.js

@@ -3,24 +3,25 @@ import {
   MIN_SESSION_ID_LENGTH,
   SessionComponent,
   isValidSessionId
-} from "../../shared/@ai-setting/roy-agent-core-zvemdfx5.js";
+} from "../../shared/@ai-setting/roy-agent-core-kq9pz2a7.js";
 import {
   MemorySessionStore
-} from "../../shared/@ai-setting/roy-agent-core-7qy3nffr.js";
+} from "../../shared/@ai-setting/roy-agent-core-c7w2h47a.js";
 import"../../shared/@ai-setting/roy-agent-core-ze068vc9.js";
 import"../../shared/@ai-setting/roy-agent-core-rvxg1wps.js";
 import {
   SessionMessageConverter
-} from "../../shared/@ai-setting/roy-agent-core-2b8jtv7m.js";
-import"../../shared/@ai-setting/roy-agent-core-0hq21px2.js";
+} from "../../shared/@ai-setting/roy-agent-core-ge87xbas.js";
+import"../../shared/@ai-setting/roy-agent-core-e1w17tht.js";
+import"../../shared/@ai-setting/roy-agent-core-zjdzk1gg.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
-import"../../shared/@ai-setting/roy-agent-core-tdbv7ff4.js";
-import"../../shared/@ai-setting/roy-agent-core-qcspfszy.js";
-import"../../shared/@ai-setting/roy-agent-core-4z3rq5gw.js";
-import"../../shared/@ai-setting/roy-agent-core-k8b440n3.js";
-import"../../shared/@ai-setting/roy-agent-core-5apmk4qw.js";
-import"../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
-import"../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
+import"../../shared/@ai-setting/roy-agent-core-0kn3zt1t.js";
+import"../../shared/@ai-setting/roy-agent-core-ytd5eztz.js";
+import"../../shared/@ai-setting/roy-agent-core-yphwdm9x.js";
+import"../../shared/@ai-setting/roy-agent-core-m97jn2ra.js";
+import"../../shared/@ai-setting/roy-agent-core-syyw58p9.js";
+import"../../shared/@ai-setting/roy-agent-core-8p63s836.js";
+import"../../shared/@ai-setting/roy-agent-core-rt115qfc.js";
 import"../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {

package/dist/env/session/session-component.d.ts

@@ -397,6 +397,10 @@ export declare class SessionComponent extends BaseComponent {
      *   现在：优先取干净的纯文本轮次（信息密度最高），一轮都没取到时兜底保留最近
      *   若干条原始消息（含 tool 轮次），至少让 CLI 能看到「刚才在干什么」。
      */
+    /**
+     * ★ 2026-10-22：**只存摘要**（Task #4479）。改造前平均 878KB（最大 12.8MB）
+     * —— 入参是完整 messages 数组，返回值是抽出来的消息正文。
+     */
     private extractRecentMessages;
     /**
      * Preview compact operation

package/dist/env/session/storage/index.js

@@ -3,10 +3,12 @@ import {
   SQLiteSessionStore,
   getDefaultDataDir,
   getDefaultSessionDbPath
-} from "../../../shared/@ai-setting/roy-agent-core-7qy3nffr.js";
-import"../../../shared/@ai-setting/roy-agent-core-2b8jtv7m.js";
-import"../../../shared/@ai-setting/roy-agent-core-0hq21px2.js";
-import"../../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
+} from "../../../shared/@ai-setting/roy-agent-core-c7w2h47a.js";
+import"../../../shared/@ai-setting/roy-agent-core-ge87xbas.js";
+import"../../../shared/@ai-setting/roy-agent-core-e1w17tht.js";
+import"../../../shared/@ai-setting/roy-agent-core-zjdzk1gg.js";
+import"../../../shared/@ai-setting/roy-agent-core-8p63s836.js";
+import"../../../shared/@ai-setting/roy-agent-core-rt115qfc.js";
 import"../../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {

package/dist/env/skill/index.js

@@ -6,20 +6,20 @@ import {
   getSourcePriority,
   parseFrontmatter,
   parseSkillFile
-} from "../../shared/@ai-setting/roy-agent-core-2gay3sjt.js";
+} from "../../shared/@ai-setting/roy-agent-core-47s81t6g.js";
 import {
   SkillToolSchema,
   buildSkillDescription,
   createSkillTool
 } from "../../shared/@ai-setting/roy-agent-core-psvxt4c9.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
-import"../../shared/@ai-setting/roy-agent-core-tdbv7ff4.js";
-import"../../shared/@ai-setting/roy-agent-core-qcspfszy.js";
-import"../../shared/@ai-setting/roy-agent-core-4z3rq5gw.js";
-import"../../shared/@ai-setting/roy-agent-core-k8b440n3.js";
-import"../../shared/@ai-setting/roy-agent-core-5apmk4qw.js";
-import"../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
-import"../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
+import"../../shared/@ai-setting/roy-agent-core-0kn3zt1t.js";
+import"../../shared/@ai-setting/roy-agent-core-ytd5eztz.js";
+import"../../shared/@ai-setting/roy-agent-core-yphwdm9x.js";
+import"../../shared/@ai-setting/roy-agent-core-m97jn2ra.js";
+import"../../shared/@ai-setting/roy-agent-core-syyw58p9.js";
+import"../../shared/@ai-setting/roy-agent-core-8p63s836.js";
+import"../../shared/@ai-setting/roy-agent-core-rt115qfc.js";
 import"../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {

package/dist/env/task/delegate/index.js

@@ -3,19 +3,19 @@ import {
   BackgroundTaskManager,
   createDelegateTool,
   createStopTool
-} from "../../../shared/@ai-setting/roy-agent-core-mxdc756a.js";
-import"../../../shared/@ai-setting/roy-agent-core-tbrn9wdm.js";
-import"../../../shared/@ai-setting/roy-agent-core-yhsssn86.js";
+} from "../../../shared/@ai-setting/roy-agent-core-1sfbs57v.js";
+import"../../../shared/@ai-setting/roy-agent-core-14bq77wr.js";
+import"../../../shared/@ai-setting/roy-agent-core-2ctyjy62.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../../shared/@ai-setting/roy-agent-core-6masakz4.js";
-import"../../../shared/@ai-setting/roy-agent-core-rx16h2m1.js";
+import"../../../shared/@ai-setting/roy-agent-core-ygn5tzt1.js";
 import"../../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
-import"../../../shared/@ai-setting/roy-agent-core-4z3rq5gw.js";
-import"../../../shared/@ai-setting/roy-agent-core-k8b440n3.js";
-import"../../../shared/@ai-setting/roy-agent-core-5apmk4qw.js";
-import"../../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
-import"../../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
+import"../../../shared/@ai-setting/roy-agent-core-yphwdm9x.js";
+import"../../../shared/@ai-setting/roy-agent-core-m97jn2ra.js";
+import"../../../shared/@ai-setting/roy-agent-core-syyw58p9.js";
+import"../../../shared/@ai-setting/roy-agent-core-8p63s836.js";
+import"../../../shared/@ai-setting/roy-agent-core-rt115qfc.js";
 import"../../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {

package/dist/env/task/index.js

@@ -5,33 +5,34 @@ import {
   TaskPriorityEnum,
   TaskStatusEnum,
   TaskTypeEnum
-} from "../../shared/@ai-setting/roy-agent-core-e2z1etk4.js";
+} from "../../shared/@ai-setting/roy-agent-core-ewcc5qdt.js";
 import"../../shared/@ai-setting/roy-agent-core-amkqnyzy.js";
-import {
-  SQLiteTaskStore,
-  getDefaultTaskDbPath
-} from "../../shared/@ai-setting/roy-agent-core-qm9jda8p.js";
-import"../../shared/@ai-setting/roy-agent-core-7g03zkkb.js";
+import"../../shared/@ai-setting/roy-agent-core-7q4wdze2.js";
+import"../../shared/@ai-setting/roy-agent-core-vh0qzb24.js";
 import"../../shared/@ai-setting/roy-agent-core-rn57psp0.js";
 import {
   TaskEntityEventTypes
 } from "../../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../../shared/@ai-setting/roy-agent-core-mxdc756a.js";
-import"../../shared/@ai-setting/roy-agent-core-tbrn9wdm.js";
-import"../../shared/@ai-setting/roy-agent-core-yhsssn86.js";
+import"../../shared/@ai-setting/roy-agent-core-1sfbs57v.js";
+import"../../shared/@ai-setting/roy-agent-core-14bq77wr.js";
+import {
+  SQLiteTaskStore,
+  getDefaultTaskDbPath
+} from "../../shared/@ai-setting/roy-agent-core-fbjd7bt6.js";
+import"../../shared/@ai-setting/roy-agent-core-2ctyjy62.js";
 import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../shared/@ai-setting/roy-agent-core-6masakz4.js";
-import"../../shared/@ai-setting/roy-agent-core-rx16h2m1.js";
+import"../../shared/@ai-setting/roy-agent-core-ygn5tzt1.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
-import"../../shared/@ai-setting/roy-agent-core-tdbv7ff4.js";
-import"../../shared/@ai-setting/roy-agent-core-qcspfszy.js";
-import"../../shared/@ai-setting/roy-agent-core-4z3rq5gw.js";
-import"../../shared/@ai-setting/roy-agent-core-k8b440n3.js";
-import"../../shared/@ai-setting/roy-agent-core-5apmk4qw.js";
-import"../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
-import"../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
+import"../../shared/@ai-setting/roy-agent-core-0kn3zt1t.js";
+import"../../shared/@ai-setting/roy-agent-core-ytd5eztz.js";
+import"../../shared/@ai-setting/roy-agent-core-yphwdm9x.js";
+import"../../shared/@ai-setting/roy-agent-core-m97jn2ra.js";
+import"../../shared/@ai-setting/roy-agent-core-syyw58p9.js";
+import"../../shared/@ai-setting/roy-agent-core-8p63s836.js";
+import"../../shared/@ai-setting/roy-agent-core-rt115qfc.js";
 import"../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {

package/dist/env/task/plugins/index.js

@@ -10,21 +10,22 @@ import {
   formatExtractorInput,
   formatExtractorInputFromDescription,
   parseExtractorOutput
-} from "../../../shared/@ai-setting/roy-agent-core-g36jevrk.js";
-import"../../../shared/@ai-setting/roy-agent-core-yhsssn86.js";
+} from "../../../shared/@ai-setting/roy-agent-core-8bngppw0.js";
+import"../../../shared/@ai-setting/roy-agent-core-fbjd7bt6.js";
+import"../../../shared/@ai-setting/roy-agent-core-2ctyjy62.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../../shared/@ai-setting/roy-agent-core-6masakz4.js";
-import"../../../shared/@ai-setting/roy-agent-core-b5ew8t0k.js";
-import"../../../shared/@ai-setting/roy-agent-core-a4vzsn0g.js";
-import"../../../shared/@ai-setting/roy-agent-core-8s9jd2qy.js";
+import"../../../shared/@ai-setting/roy-agent-core-c36335nw.js";
+import"../../../shared/@ai-setting/roy-agent-core-89sxsrc7.js";
+import"../../../shared/@ai-setting/roy-agent-core-08njdcpj.js";
 import"../../../shared/@ai-setting/roy-agent-core-jrj30vq3.js";
-import"../../../shared/@ai-setting/roy-agent-core-dv714bqh.js";
+import"../../../shared/@ai-setting/roy-agent-core-gksw1gjb.js";
 import"../../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import"../../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
-import"../../../shared/@ai-setting/roy-agent-core-k8b440n3.js";
-import"../../../shared/@ai-setting/roy-agent-core-5apmk4qw.js";
-import"../../../shared/@ai-setting/roy-agent-core-dsevjbck.js";
-import"../../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
+import"../../../shared/@ai-setting/roy-agent-core-m97jn2ra.js";
+import"../../../shared/@ai-setting/roy-agent-core-syyw58p9.js";
+import"../../../shared/@ai-setting/roy-agent-core-8p63s836.js";
+import"../../../shared/@ai-setting/roy-agent-core-rt115qfc.js";
 import"../../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {

package/dist/env/task/plugins/lark-card-patch-notifier.d.ts

@@ -61,7 +61,25 @@
  * ★ Part 2（workflow 通知）：新增 `"stopped"`（灰）—— task 只会用前三种，
  *   但同一套卡片骨架要给 workflow run 复用，而 workflow 有 stopped 终态。
  */
-export type CardStatus = "running" | "completed" | "failed" | "stopped";
+export type CardStatus = "running" | "completed" | "failed" | "stopped"
+/**
+ * ★ Task #4536：任务被**取消**（task.status = "cancelled"）
+ *
+ * 旧实现把 cancelled 映射成 "failed" → 卡片显示「🚨 任务失败」，
+ * 语义错误（用户主动取消 ≠ 失败）。新增独立状态，灰色 + 「已取消」。
+ */
+ | "cancelled"
+/**
+ * ★ Task #4540：任务被**删除**（用户口中的「取消」= `deleteTask()` 硬删除）
+ *
+ * 与 `cancelled` 的区别：
+ * - `cancelled` = `updateTask(status="cancelled")`，任务**实体还在**（可查、可恢复）
+ * - `deleted`   = `deleteTask()`，任务实体**已从库消失**（不可恢复）
+ *
+ * 语义上必须分开：用户看到「🚫 已取消」会以为任务还能找回来；
+ * 硬删除后任务真的没了，卡片应显示「🗑️ 已删除」。
+ */
+ | "deleted";
 /** workflow 卡片状态（与 CardStatus 同集合；语义别名，便于阅读） */
 export type WorkflowCardStatus = CardStatus;
 /** 里程碑（关键节点）：时间 + 标题 + 描述 */
@@ -167,11 +185,27 @@ export interface FinishTaskOptions {
     messageId: string;
     chatId?: string;
     profile?: string;
-    status: Extract<CardStatus, "completed" | "failed">;
+    /**
+     * 终态卡片状态
+     *
+     * ★ Task #4536 扩展：
+     * - `completed` task.status = completed
+     * - `failed`    task.status = failed / timeout
+     * - `cancelled` task.status = cancelled（**不再**误标「失败」）
+     * - `stopped`   task.status = paused（用户 stop / 暂停；不是终结，可 resume）
+     */
+    status: Exclude<CardStatus, "running">;
     meta?: TaskMeta;
     /** 终态补充说明（会作为最后一条里程碑 append） */
     finalStep?: string;
     progress?: number;
+    /**
+     * 收尾里程碑的自定义标题（Task #4536 / xval round2 NIT 3）
+     *
+     * `pauseTask` 默认写「Task 已暂停」；archived 场景应传「Task 已归档」，
+     * 否则归档任务的卡片会误显示"已暂停"。
+     */
+    pausedMilestoneTitle?: string;
 }
 export interface StartTaskResult {
     messageId: string;
@@ -449,6 +483,22 @@ export declare function buildWorkflowCard(opts: {
     updateCount?: number;
     spinner?: string;
 }): CardPayload;
+/**
+ * 卡片状态的对外快照（Task #4536）
+ *
+ * 用于持久化 / 重启恢复：`exportState` / `hydrateState` 的载荷类型。
+ */
+export interface CardStateSnapshot {
+    chatId?: string;
+    profile?: string;
+    meta?: TaskMeta;
+    startedAt?: string;
+    updateCount?: number;
+    spinnerIndex?: number;
+    milestones?: Milestone[];
+    processSteps?: ProcessStep[];
+    progress?: number;
+}
 /**
  * LarkCardPatchNotifier - 封装单卡片 patch 逻辑
  */
@@ -480,6 +530,63 @@ export declare class LarkCardPatchNotifier {
      *   （旧实现传 `--content` 是非法 flag → 秒失败 → 卡片永远停在初始态）。
      */
     updateTask(opts: UpdateTaskOptions): Promise<void>;
+    /**
+     * 导出某张卡片的累积内容快照（Task #4536 / xval MAJOR 3）
+     *
+     * 供上层（`LarkCliTaskNotifyHook`）持久化到 store，让 roy-agent 重启后
+     * 第一次 patch 仍能带上原里程碑 / 过程步骤 / 更新计数，而不是退回
+     * "第 1 次更新 + 暂无里程碑"。
+     *
+     * 返回 `undefined` 表示本 notifier 没有该 messageId 的状态
+     * （例如刚重启 —— 此时调用方应先用 {@link hydrateState} 灌入）。
+     */
+    exportState(messageId: string): CardStateSnapshot | undefined;
+    /**
+     * 注入某张卡片的状态快照（Task #4536 / xval MAJOR 3）
+     *
+     * 用于**进程重启后**从持久层恢复卡片内容：之后 `updateTask` /
+     * `pauseTask` 会基于这份快照继续累积，而不是从空白重建。
+     *
+     * ★ 幂等：已有 state 时不覆盖（内存里的比持久化的更新）。
+     */
+    hydrateState(messageId: string, snapshot: CardStateSnapshot): void;
+    /**
+     * 暂停卡片（Task #4536：stop / archived）+ unpin，**保留**卡片状态与时间线
+     *
+     * ★ 为什么不能复用 `finishTask`（xval MAJOR 2 回归）：
+     *   `finishTask` 末尾会 `states.delete(messageId)` —— 那是终态语义（卡片到此为止）。
+     *   `paused` **不是**终态（可 resume），如果也删状态：
+     *   1. resume 后 `updateTask` 从空 state 重建 → 里程碑 / 过程步骤 /
+     *      "第 N 次更新" 全部丢失，卡片退回"第 1 次更新 + 暂无里程碑"；
+     *   2. 卡片 action handler 的 fallback 也会把 paused 卡片重建成蓝色 running。
+     *
+     * 所以 pause 只做三件事：patch 成灰底「已暂停」、unpin、**保留 state**。
+     * 只有 `unpinOnFinish` 为 true 时才 unpin（与 finishTask 一致）。
+     */
+    pauseTask(opts: FinishTaskOptions): Promise<void>;
+    /**
+     * 单独 pin 一条已存在的卡片消息（Task #4536）
+     *
+     * 用途：任务 **resume**（paused → active）后把卡片重新置顶，
+     * 让 pin 状态与任务状态保持一致（stop 时 unpin，resume 时 re-pin）。
+     *
+     * ★ 与 `startTask` 里的 pin 走**同一套** lark-cli 契约：
+     *   `im pins create --data '{"message_id":"om_xxx"}'`（绝不传 --chat-id/--message-id，
+     *   那是非法 flag → unknown flag → pin 永远失败，Task #4230 的老坑）。
+     *
+     * 失败直接抛出，由调用方决定降级（pin 失败不应阻断卡片 patch）。
+     */
+    pinMessage(messageId: string, profile?: string): Promise<void>;
+    /**
+     * 单独 unpin 一条已存在的卡片消息（Task #4540）
+     *
+     * 与 {@link pinMessage} 配对。为什么需要它：`finishTask` / `pauseTask` 的
+     * unpin 是"尽力而为"的副作用，且一旦 patch 抛错，unpin 那段可能整段跳过。
+     * 而用户最在意的是「pin 别再挂着」—— 所以删除任务时额外补一次显式 unpin。
+     *
+     * 幂等：已 unpin 的消息再 delete 只会 warn（由 `buildUnpinArgs` 保证带 `--yes`）。
+     */
+    unpinMessage(messageId: string, profile?: string): Promise<void>;
     /**
      * 完成任务：patch final status（终态里程碑 → 进度 100%）+ unpin
      *

package/dist/env/task/plugins/lark-card-state-store.d.ts

@@ -0,0 +1,137 @@
+/**
+ * @fileoverview LarkCardStateStore — 任务进展卡片消息的**持久化**记录（Task #4536）
+ *
+ * ## 为什么需要
+ *
+ * `LarkCliTaskNotifyHook` 原来只把「taskId → messageId」存在内存 `Map` 里：
+ *
+ * ```typescript
+ * private cardMessageIds: Map<number, string> = new Map();
+ * ```
+ *
+ * ⇒ roy-agent 进程一重启，之前发过的卡片**再也无法被 patch**，
+ *   变成永远停在「进行中」的孤儿卡片，pin 也一直挂着。
+ *
+ * ## 设计选型：独立 SQLite 库文件（不写 task.context）
+ *
+ * | 方案 | 结论 |
+ * |------|------|
+ * | a) 写 `task.context` | ❌ 写 context 会同步触发 `task:after.update` → 本插件重入（现有 `CARD_START_INFLIGHT_SENTINEL` 就是被这个坑逼出来的）；且 context 会被 `renderTaskInfoLines` 渲染进卡片正文，messageId/chatId 会污染用户可见内容 |
+ * | b) 给 `tasks.db` 加表 | ❌ 需要 migration，且插件层拿不到 task store 句柄，耦合更重 |
+ *
+ * ※ 关于 `task:after.complete` 影响面的准确描述见
+ *   `lark-cli-task-notify-plugin.ts` 里 `onAfterUpdate` 的注释（xval round2 NIT-2 更正）。
+ * | c) 独立 JSON 文件 | ❌ 无事务、无跨进程锁，并发 hook 会互相覆盖 |
+ * | **c') 独立 SQLite 库文件** | ✅ 复用既有 `createCompatibleDatabase`（bun:sqlite / better-sqlite3 双运行时），UPSERT 原子、自带跨进程锁、零 migration |
+ *
+ * 库文件：`~/.local/share/roy-agent/lark-cards.db`（与 `tasks.db` / `workflows.db` 同目录）
+ *
+ * ## 记录生命周期
+ *
+ * ```
+ * startTask 成功   → upsert({status: "open",   pinned: true})
+ * patch 成功       → upsert/touch（messageId 不变）
+ * paused（stop）   → markPaused()  → status="paused"（保留 messageId，resume 可复用）
+ * resume           → markReopened()→ status="open"
+ * completed/failed/cancelled → markClosed() → status="closed" + closedAt
+ * ```
+ *
+ * ★ 终态**不删除**记录：保留 messageId/chatId 便于事后追溯（用户手动删卡片后
+ *   再 patch 会失败，但记录本身仍有诊断价值）。
+ */
+/**
+ * 卡片记录状态
+ *
+ * - `open`   进行中（卡片 pin 着，可 patch）
+ * - `paused` 已暂停（stop）。**保留 messageId**：任务 resume 后继续 patch 同一张卡
+ * - `closed` 已终结（completed / failed / cancelled）。记录保留，不再 patch
+ */
+export type LarkCardRecordStatus = "open" | "paused" | "closed";
+/** 一条卡片持久化记录 */
+export interface LarkCardState {
+    /** 任务 ID（主键） */
+    taskId: number;
+    /** 飞书 message_id（om_xxx） */
+    messageId: string;
+    /** 飞书 chat_id（oc_xxx） */
+    chatId: string;
+    /** lark-cli profile（多 appId 场景） */
+    profile?: string;
+    /** 当前 pin 状态（true = 置顶中） */
+    pinned: boolean;
+    /** 记录状态 */
+    status: LarkCardRecordStatus;
+    /** 首次发卡时间（ms epoch） */
+    createdAt: number;
+    /** 最后更新时间（ms epoch） */
+    updatedAt: number;
+    /** 终结时间（ms epoch）；仅 status=closed 有值 */
+    closedAt?: number;
+    /**
+     * 卡片自持的累积内容（Task #4536 / xval MAJOR 3）
+     *
+     * ★ 为什么要持久化：`LarkCardPatchNotifier` 的里程碑 / 过程步骤 / 更新计数
+     *   只存在内存里。只持久化 messageId 的话，重启后第一次 patch 会用空状态
+     *   重建卡片 → 用户看到"暂无里程碑 / 第 1 次更新"，历史进展被静默抹掉。
+     *
+     * 存 JSON 字符串（不建子表）：内容规模小（每次更新只 append 一条），
+     * 读取模式永远是"整张卡一起取出"，不需要按里程碑查询。
+     */
+    timeline?: string;
+}
+/** 持久化端口（hook 只依赖这个接口，便于测试注入内存实现） */
+export interface LarkCardStateStore {
+    /** 写入或覆盖一条记录 */
+    upsert(state: LarkCardState): void;
+    /** 按 taskId 读取 */
+    get(taskId: number): LarkCardState | undefined;
+    /** 列出全部记录（诊断用） */
+    list(): LarkCardState[];
+    /** 更新 pin 状态 */
+    markPinned(taskId: number, pinned: boolean): void;
+    /** 标记为暂停（保留 messageId） */
+    markPaused(taskId: number): void;
+    /** 从暂停/终结翻回进行中（resume） */
+    markReopened(taskId: number): void;
+    /** 标记终结（completed / failed / cancelled） */
+    markClosed(taskId: number): void;
+    /** 真删除（仅测试/手工清理用） */
+    delete(taskId: number): void;
+    /** 释放资源 */
+    close(): void;
+}
+export declare class MemoryLarkCardStateStore implements LarkCardStateStore {
+    private readonly records;
+    upsert(state: LarkCardState): void;
+    get(taskId: number): LarkCardState | undefined;
+    list(): LarkCardState[];
+    markPinned(taskId: number, pinned: boolean): void;
+    markPaused(taskId: number): void;
+    markReopened(taskId: number): void;
+    markClosed(taskId: number): void;
+    delete(taskId: number): void;
+    close(): void;
+}
+export declare class SqliteLarkCardStateStore implements LarkCardStateStore {
+    private readonly db;
+    constructor(dbPath: string);
+    upsert(state: LarkCardState): void;
+    get(taskId: number): LarkCardState | undefined;
+    list(): LarkCardState[];
+    markPinned(taskId: number, pinned: boolean): void;
+    markPaused(taskId: number): void;
+    markReopened(taskId: number): void;
+    markClosed(taskId: number): void;
+    delete(taskId: number): void;
+    close(): void;
+}
+/** 默认库文件路径：`$HOME/.local/share/roy-agent/lark-cards.db` */
+export declare function getDefaultLarkCardDbPath(): string;
+/**
+ * 创建持久化 store
+ *
+ * ★ 失败降级：SQLite 打不开（权限 / 磁盘满 / 运行时缺 sqlite）时
+ *   **不抛错**，回落内存实现并 warn —— 卡片该发还得发，绝不能因为
+ *   持久化层故障让通知路径整体崩掉（诉求 C：健壮性）。
+ */
+export declare function createLarkCardStateStore(dbPath?: string): LarkCardStateStore;