@ai-setting/roy-agent-core 1.7.56 → 1.7.58

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;

package/dist/env/task/plugins/lark-cli-task-notify-plugin.d.ts

@@ -25,6 +25,7 @@
 import type { Hook, HookContext } from "../../hook/types";
 import { getEnvContextOrEmpty } from "../../context";
 import { LarkCardPatchNotifier } from "./lark-card-patch-notifier";
+import { type LarkCardState, type LarkCardStateStore } from "./lark-card-state-store";
 /**
  * 从 EnvContext 提取 lark 专属字段
  *
@@ -80,6 +81,16 @@ export interface TaskNotifyConfig {
      * 不传 → plugin 自己 new 一个（messageId 由 plugin 的 Map 跟踪）。
      */
     cardNotifier?: LarkCardPatchNotifier;
+    /**
+     * 卡片消息持久化 store（Task #4536）
+     *
+     * 不传 → 自动创建 SQLite 实现（`~/.local/share/roy-agent/lark-cards.db`）；
+     * 测试可注入 `MemoryLarkCardStateStore` 或任何符合接口的实现。
+     *
+     * ★ 为什么需要：原来 messageId 只存内存 Map，进程重启即丢 →
+     *   老卡片再也无法 patch（永远停在"进行中"）+ pin 一直挂着。
+     */
+    cardStateStore?: LarkCardStateStore;
 }
 /**
  * 卡片路由端口（Task #4230 follow-up）
@@ -114,8 +125,25 @@ export declare class LarkCliTaskNotifyHook implements Hook {
      *
      * 同一 task 的 create → update → complete 必须复用同一 messageId
      * （单卡片语义：不刷屏）。不同 task 的卡片互不干扰。
+     *
+     * ★ Task #4536：这是**进程内缓存**（读穿透 L2 持久化 store 后回填），
+     *   权威数据在 `cardStateStore`（SQLite）。重启后从 store 恢复。
      */
     private cardMessageIds;
+    /**
+     * 卡片记录持久化 store（Task #4536，L2 权威层）
+     *
+     * 记录 `{taskId → messageId, chatId, profile, pinned, status}`，
+     * 让 roy-agent 重启后仍能 patch 同一张卡片、并正确 unpin。
+     */
+    private cardStateStore?;
+    /**
+     * 已经做过「内存 ← 持久层」回填的 taskId 集合
+     *
+     * `restoreCardState()` 是异步的，而 hook 每来一次事件都会调用它；
+     * 用这个集合做一次性短路，避免每次事件都打一次 SQL 查询。
+     */
+    private restoredTaskIds;
     /**
      * 操作记录节流状态
      * key: `op:${taskId}`，value: 上次 patch 时间戳
@@ -155,8 +183,52 @@ export declare class LarkCliTaskNotifyHook implements Hook {
     private onAfterCreate;
     /** 任务更新：patch 卡片（进度/当前步骤/状态） */
     private onAfterUpdate;
+    /**
+     * 判定本次 update 是否属于「收尾」事件（Task #4536）
+     *
+     * 返回卡片终态；`undefined` 表示这是普通进展更新（继续 patch，不动 pin）。
+     *
+     * 依据 `changes.status`（本次变更）**优先**，其次看 `task.status`（当前值）——
+     * 因为 AFTER_UPDATE 里 `changes` 只包含本次更新的字段，resume 时 status 变回
+     * active（`changes.status === "active"`）必须能正确翻回 open。
+     */
+    private cardStatusOf;
     /** 任务终态：patch 终态 + unpin */
     private onAfterComplete;
+    /**
+     * 任务被**删除**（用户口中的「取消」）→ 卡片收尾 + unpin（Task #4540）
+     *
+     * ## 为什么需要这个 handler
+     *
+     * 用户真机反馈：「我测试创建了一个任务，然后又取消了他。但是这个卡片消息没有
+     * 变化，然后这个 pin 也没有取消。」
+     *
+     * 实测发现「取消」有两种完全不同的语义，走两条完全不同的代码路径：
+     *
+     * | 用户/工具意图            | 实际调用                       | 触发 hook            |
+     * |--------------------------|--------------------------------|----------------------|
+     * | `tasks update --status cancelled` | `updateTask(status="cancelled")` | `task:after.update` → `cardStatusOf` → `sendCardFinish` ✅ 早已支持 |
+     * | 直接「取消/删除」任务     | **`deleteTask()`（硬删除）**    | `task:after.delete` → **本 handler** |
+     *
+     * 旧代码只处理了前者 → 后者卡片永远停在"进行中"、pin 永远挂着。
+     *
+     * ## 为什么必须依赖持久层（#4536 的价值）
+     *
+     * `TaskDeleteResultContext` 只有 `{ id, deleted }` —— **拿不到 Task 对象**
+     * （数据已经从 store 删了）。能用的只有：
+     * 1. `cardStateStore`（#4536 持久化的 `lark-cards.db`）→ messageId / chatId / profile
+     * 2. `cardNotifier` 内存态（同进程内刚发过卡时）→ 里程碑 / 过程步骤 / 进度
+     *
+     * 两者都没有 → 说明这个任务从来没发过卡（或库被清）→ 静默 skip，**绝不发新卡**。
+     *
+     * ## 幂等 / 降级
+     *
+     * - `deleted === false` → 删除失败，任务还在 → 什么都不做
+     * - 记录缺失 / messageId 为空 → skip（debug log）
+     * - patch 失败 → warn，**仍继续 unpin**（卡片文案改不了但 pin 必须取消）
+     * - unpin 失败 → warn，不抛
+     */
+    private onAfterDelete;
     /**
      * 操作记录创建：把 operation 追加进卡片时间线
      *
@@ -164,6 +236,77 @@ export declare class LarkCliTaskNotifyHook implements Hook {
      *   旧实现会 fallback `startTask`（凭空多发一张卡）——已删除。
      */
     private onAfterOperationCreate;
+    /**
+     * 从持久层回填内存 messageId（一次性/幂等）
+     *
+     * 进程重启后内存 Map 是空的；第一次收到该 task 的事件时从这里恢复
+     * 原卡片的 messageId / chatId / profile / pin 状态，从而 patch 到**同一张卡**
+     * 而不是重新发一张新的（用户诉求 A 的核心验收点）。
+     *
+     * ★ 已 `closed` 的记录不再回填 messageId：终态卡片已经 unpin 且不应再被 patch；
+     *   如果该 task 后来被重新打开（新 create），会走全新建卡流程。
+     * ★ 已 `paused` 的记录**要**回填：pause → resume 后必须复用同一张卡。
+     */
+    private restoreCardState;
+    /**
+     * 从持久层恢复卡片内容到 notifier（Task #4536 / xval MAJOR 3）
+     *
+     * `timeline` 是 `CardStateSnapshot` 的 JSON；解析失败只 warn（不阻断）。
+     */
+    private hydrateNotifierState;
+    /**
+     * 把 notifier 的卡片内容快照序列化进记录（Task #4536 / xval MAJOR 3）
+     *
+     * 每次 patch / pause 之后调用，让"重启后恢复内容"始终有最新数据。
+     */
+    private snapshotTimeline;
+    /** 落库：发卡成功 / patch 成功后同步记录（失败仅 warn） */
+    private persistCardState;
+    /** 落库：pin 状态变化（失败仅 warn） */
+    private persistPinned;
+    /**
+     * 落库：暂停（stop）
+     *
+     * ★ paused **不是**终结 —— 保留 `open` 语义的 messageId，只翻 status。
+     *   任务 resume 后要能继续 patch 同一张卡（诉求 B 的 pause→resume→pause）。
+     */
+    private persistPaused;
+    /**
+     * 丢弃持久层里的旧 messageId（Task #4536 / xval MAJOR 4）
+     *
+     * 用于 reopen 场景：旧卡片已 closed + unpin，不能再被 patch。
+     * 只把 `messageId` 清空、状态保持原样（closed），这样：
+     * - 若新卡创建成功 → `persistCardState` 会写一条完整新记录（覆盖）；
+     * - 若新卡创建失败 → 记录仍是 closed 且**无可用 messageId**，
+     *   重启后 `restoreCardState` 不会把它当活卡片复活。
+     */
+    private dropStaleMessageId;
+    /** 落库：resume / 重新打开（paused|closed → open） */
+    private persistReopened;
+    /** 落库：终结（completed / failed / cancelled）—— 保留记录供追溯 */
+    private persistClosed;
+    /**
+     * 重新快照当前卡片的累积内容并落库（Task #4536 / xval MAJOR 3）
+     *
+     * 幂等 + 失败降级：拿不到记录 / notifier 无状态时静默跳过。
+     */
+    private refreshTimeline;
+    /**
+     * resume 后重新 pin 卡片（Task #4536）
+     *
+     * ★ 为什么需要：`stop`（paused）时我们已经 unpin 了；任务被 resume 后如果
+     *   不 re-pin，用户就再也看不到置顶的进展卡片 —— pin 状态必须跟任务状态一致。
+     *
+     * ★ 失败降级（诉求 C）：pin 失败**不阻断**后续 patch，只 warn 并保持
+     *   持久层 `pinned=false`（如实反映真实状态，不谎报）。
+     */
+    private repinAfterResume;
+    /** 合并「写记录」所需的公共字段（读旧记录失败也不抛，降级为 now） */
+    private buildCardState;
+    /** 对外只读：某 task 的持久化卡片记录（debug / 排查用） */
+    getCardState(taskId: number): LarkCardState | undefined;
+    /** 对外只读：全部持久化卡片记录（debug / 排查用） */
+    listCardStates(): LarkCardState[];
     private isCardModeEnabled;
     /**
      * 解析「卡片该发到哪个群」（Task #4230 follow-up）
@@ -184,7 +327,7 @@ export declare class LarkCliTaskNotifyHook implements Hook {
      * 用于：无触发群时找最近的专属群兜底（Task #4394：不再用于"是否别人的群"判定）。
      */
     private collectLineage;
-    /** 发初始卡片（+ pin）并缓存 messageId */
+    /** 发初始卡片（+ pin）并缓存 + 持久化 messageId */
     private sendCardStart;
     /**
      * patch 卡片（进度 / 当前步骤 / 状态）
@@ -193,7 +336,16 @@ export declare class LarkCliTaskNotifyHook implements Hook {
      * 降级补发一次 startTask —— 只发生一次，失败则打 sentinel 不再重试。
      */
     private sendCardUpdate;
-    /** 终态：patch final status + unpin，并清理 messageId 缓存 */
+    /**
+     * 终态：patch final status + unpin，并同步持久化
+     *
+     * 覆盖三种「收尾」语义（Task #4536）：
+     * - `completed`                     → 卡片「🎉 全部完成！」+ unpin + 记录 closed
+     * - `cancelled`                     → 卡片「🚫 已取消」  + unpin + 记录 closed
+     * - `failed` / `timeout`            → 卡片「🚨 任务失败」+ unpin + 记录 closed
+     * - `paused`（用户 stop **或** 循环任务已暂停）→ 卡片「⏹️ 已暂停」+ unpin，
+     *   但记录只标 `paused`（**不是** closed）—— 任务 resume 后要复用同一张卡
+     */
     private sendCardFinish;
     /**
      * 解析 chatId（优先级：replyChannel > task.context）

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

@@ -1,10 +1,11 @@
+import"../../../shared/@ai-setting/roy-agent-core-7q4wdze2.js";
 import {
   SQLiteTaskStore,
   getDefaultDataDir,
   getDefaultTaskDbPath
-} from "../../../shared/@ai-setting/roy-agent-core-3kz6934b.js";
-import"../../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
-import"../../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
+} from "../../../shared/@ai-setting/roy-agent-core-fbjd7bt6.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/tools/index.js

@@ -9,10 +9,10 @@ import {
   searchTasksTool,
   treeTasksTool,
   updateTaskTool
-} from "../../../shared/@ai-setting/roy-agent-core-pemxr5n4.js";
-import"../../../shared/@ai-setting/roy-agent-core-jszgaevt.js";
-import"../../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
-import"../../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
+} from "../../../shared/@ai-setting/roy-agent-core-vh0qzb24.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/tool/built-in/index.js

@@ -8,7 +8,7 @@ import {
   grepTool,
   readFileTool,
   writeFileTool
-} from "../../../shared/@ai-setting/roy-agent-core-4zy2v3br.js";
+} from "../../../shared/@ai-setting/roy-agent-core-q4gdfypk.js";
 import {
   getUnderstandImageLLMProvider,
   resetUnderstandImageLLMProvider,
@@ -19,10 +19,10 @@ import {
   createQueryBackgroundProcessTool,
   queryBackgroundProcessTool
 } from "../../../shared/@ai-setting/roy-agent-core-amkqnyzy.js";
-import"../../../shared/@ai-setting/roy-agent-core-tbrn9wdm.js";
+import"../../../shared/@ai-setting/roy-agent-core-14bq77wr.js";
 import"../../../shared/@ai-setting/roy-agent-core-zjdzk1gg.js";
-import"../../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
-import"../../../shared/@ai-setting/roy-agent-core-8seq65bp.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/tool/index.js

@@ -9,7 +9,7 @@ import {
   grepTool,
   readFileTool,
   writeFileTool
-} from "../../shared/@ai-setting/roy-agent-core-4zy2v3br.js";
+} from "../../shared/@ai-setting/roy-agent-core-q4gdfypk.js";
 import {
   getUnderstandImageLLMProvider,
   resetUnderstandImageLLMProvider,
@@ -17,25 +17,25 @@ import {
   understandImageTool
 } from "../../shared/@ai-setting/roy-agent-core-xwm8zavb.js";
 import"../../shared/@ai-setting/roy-agent-core-amkqnyzy.js";
-import"../../shared/@ai-setting/roy-agent-core-tbrn9wdm.js";
+import"../../shared/@ai-setting/roy-agent-core-14bq77wr.js";
 import {
   ToolComponent,
   ToolRegistry,
   ToolValidator,
   getMaxOutputSize,
   setToolConfigComponent
-} from "../../shared/@ai-setting/roy-agent-core-98aa9r0x.js";
-import"../../shared/@ai-setting/roy-agent-core-kzg1jwt8.js";
+} from "../../shared/@ai-setting/roy-agent-core-fw6k4w1h.js";
+import"../../shared/@ai-setting/roy-agent-core-n0p0hwgd.js";
 import"../../shared/@ai-setting/roy-agent-core-zjdzk1gg.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
-import"../../shared/@ai-setting/roy-agent-core-40xzbjtm.js";
-import"../../shared/@ai-setting/roy-agent-core-gngjkw3b.js";
-import"../../shared/@ai-setting/roy-agent-core-1pnfkspm.js";
-import"../../shared/@ai-setting/roy-agent-core-16t0zfbk.js";
-import"../../shared/@ai-setting/roy-agent-core-jszgaevt.js";
-import"../../shared/@ai-setting/roy-agent-core-b599jgyd.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/workflow/engine/index.js

@@ -5,27 +5,27 @@ import {
   Scheduler,
   WorkflowEngine,
   init_engine
-} from "../../../shared/@ai-setting/roy-agent-core-v2188rnk.js";
+} from "../../../shared/@ai-setting/roy-agent-core-w93z6a42.js";
 import"../../../shared/@ai-setting/roy-agent-core-6atd905e.js";
-import"../../../shared/@ai-setting/roy-agent-core-833t16n1.js";
-import"../../../shared/@ai-setting/roy-agent-core-n3b7ztms.js";
+import"../../../shared/@ai-setting/roy-agent-core-txwptxk1.js";
+import"../../../shared/@ai-setting/roy-agent-core-d75t8gea.js";
 import"../../../shared/@ai-setting/roy-agent-core-1db4vpc6.js";
 import"../../../shared/@ai-setting/roy-agent-core-ze068vc9.js";
-import"../../../shared/@ai-setting/roy-agent-core-3dkzqqsd.js";
-import"../../../shared/@ai-setting/roy-agent-core-r9qe0ghe.js";
-import"../../../shared/@ai-setting/roy-agent-core-3mc6vmvj.js";
+import"../../../shared/@ai-setting/roy-agent-core-hefarcp0.js";
+import"../../../shared/@ai-setting/roy-agent-core-geh6j7bw.js";
+import"../../../shared/@ai-setting/roy-agent-core-t4x089js.js";
 import"../../../shared/@ai-setting/roy-agent-core-ddwa0n6h.js";
 import {
   DAGManager
-} from "../../../shared/@ai-setting/roy-agent-core-nra8vfrs.js";
+} from "../../../shared/@ai-setting/roy-agent-core-08njdcpj.js";
 import"../../../shared/@ai-setting/roy-agent-core-jrj30vq3.js";
 import"../../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
-import"../../../shared/@ai-setting/roy-agent-core-gngjkw3b.js";
-import"../../../shared/@ai-setting/roy-agent-core-1pnfkspm.js";
-import"../../../shared/@ai-setting/roy-agent-core-16t0zfbk.js";
-import"../../../shared/@ai-setting/roy-agent-core-jszgaevt.js";
-import"../../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
-import"../../../shared/@ai-setting/roy-agent-core-8seq65bp.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";
 init_engine();

package/dist/env/workflow/hooks/index.js

@@ -1,18 +1,18 @@
 import {
   init_hooks
-} from "../../../shared/@ai-setting/roy-agent-core-3dkzqqsd.js";
+} from "../../../shared/@ai-setting/roy-agent-core-hefarcp0.js";
 import {
   WorkflowHookPoints,
   emitWorkflowNodeHook,
   emitWorkflowRunHook,
   getRegisteredWorkflowHookPoints
-} from "../../../shared/@ai-setting/roy-agent-core-r9qe0ghe.js";
-import"../../../shared/@ai-setting/roy-agent-core-gngjkw3b.js";
-import"../../../shared/@ai-setting/roy-agent-core-1pnfkspm.js";
-import"../../../shared/@ai-setting/roy-agent-core-16t0zfbk.js";
-import"../../../shared/@ai-setting/roy-agent-core-jszgaevt.js";
-import"../../../shared/@ai-setting/roy-agent-core-b599jgyd.js";
-import"../../../shared/@ai-setting/roy-agent-core-8seq65bp.js";
+} from "../../../shared/@ai-setting/roy-agent-core-geh6j7bw.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";
 init_hooks();