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

package/dist/env/task/backend/types.d.ts

@@ -81,6 +81,25 @@ export interface TaskBackend {
      * - `cycle` 类型任务拒绝完成（roy 语义）
      */
     completeTask(id: TaskId, sessionId?: string, deliverable?: string): Promise<Task | null>;
+    /**
+     * 提交待验证（Task #5073 两阶段验收的第一阶段，Task #5078）。
+     *
+     * 契约（与 `TaskComponent.preCompleteTask` 语义同构，MCP/
+     * 插件侧共用）：
+     * - `status` → `to_validate`（**非终态**：只进验收队列）
+     * - `current_status` → 「待验证」措辞（progressSummary 拼接：
+     *   「待验证：<summary>」）
+     * - 若给了 `deliverable`，merge 进 `context.deliverable_storage_path`
+     *   并写入 submission operation 的 `milestoneDescription`
+     * - 写一条 `milestoneType: "milestone"` 的提交留痕 operation
+     *   （与 TaskComponent.preCompleteTask 的细微增强：deliverable
+     *   同时落在 operation 的 `mdPath` 字段，便于寻址）
+     * - `cycle` 类型任务拒绝提交（roy 语义，同 completeTask）
+     * - **不 fire 任何钩子**：`TaskStoreBackend` 没有 hook 链，
+     *   goal 判定由上层（MCP withGoalCheck / TaskComponent 钩子）
+     *   负责 —— 本方法只是状态落库。
+     */
+    preCompleteTask(id: TaskId, sessionId?: string, deliverable?: string, progressSummary?: string): Promise<Task | null>;
     /** 子树（所有后代，**不含** root），BFS 按层展开，`depth` 限制层数。 */
     getTaskTree(id: TaskId, depth?: number): Promise<Task[]>;
     /** 关键词检索 + 全部 roy 过滤项（review finding Y2）。 */

package/dist/env/task/delegate/delegate-tool.d.ts

@@ -236,6 +236,16 @@ export interface BackgroundTask {
      * 顺序 = 优先级（主模型失败后逐个尝试）。
      */
     fallbackModels?: string[];
+    /**
+     * ★ Task #5217 fix 2 — 父 agent 本次 run 的 channel systemPrompt
+     * （context.metadata.systemPrompt，如 lean lark 渠道 prompt）。
+     * 透传给 sub-agent 的 AgentContext.metadata.systemPrompt，
+     * 使 AgentComponent._run 把它追加到 sub-agent 的 LLM system message。
+     *
+     * 注意：与 model 一样**不写进 sub-agent 的注册配置** —— per-run
+     * 透传天然每次都是最新值（channel prompt 是 per-event 的）。
+     */
+    systemPrompt?: string;
     /**
      * ★ Task #4552 (A1)：本任务被允许的运行时长（毫秒，createTask 时确定）。
      *
@@ -280,6 +290,16 @@ export interface BackgroundTask {
         profile?: string;
         params?: Record<string, unknown>;
     };
+    /**
+     * ★ Task #5265 — delegate 时刻的 pluginEnabled 快照。
+     *
+     * 后台任务通知轮（task.background.* 合成 envEvent）此前
+     * pluginEnabled={}（空）→ WecomTaskNotifyPlugin 等 ES 插件的
+     * pluginEnabled 守卫拦截 → 不发卡（用户只见纯文本）。
+     * createTask 时快照 parent EnvContext.pluginEnabled，
+     * publishBackgroundEvent 时写进 event.metadata.pluginEnabled。
+     */
+    pluginEnabledSnapshot?: Record<string, boolean>;
 }
 /**
  * Task #4794 — BackgroundTaskManager.dispose() 的行为选项。
@@ -347,6 +367,12 @@ export interface CreateBackgroundTaskOptions {
      * Task #4724 — 父 agent 的兜底模型**有序列表**，透传给 sub-agent。
      */
     fallbackModels?: string[];
+    /**
+     * ★ Task #5217 fix 2 — 父 agent 本次 run 的 channel systemPrompt
+     * （context.metadata.systemPrompt，如 lean lark 渠道 prompt）。
+     * 透传给 sub-agent 的 AgentContext.metadata.systemPrompt。
+     */
+    systemPrompt?: string;
 }
 /**
  * 构建 entry-agent 调度的 prompt 包装 (Task #2164 beta-compare divergence #2)
@@ -578,7 +604,7 @@ export declare class BackgroundTaskManager {
      *
      * @internal 测试 / 集成用，普通调用方走 publishBackgroundEvent 私有方法
      */
-    publishBackgroundEventWithTrigger<T>(type: string, payload: T, parentSessionId: string | undefined, triggerEventId: string, replyChannel?: BackgroundTask["replyChannel"]): void;
+    publishBackgroundEventWithTrigger<T>(type: string, payload: T, parentSessionId: string | undefined, triggerEventId: string, replyChannel?: BackgroundTask["replyChannel"], pluginEnabledSnapshot?: Record<string, boolean>): void;
     /**
      * Task #3xxx — 解析 AskUserError 信息
      *
@@ -782,6 +808,34 @@ declare function _captureReplyChannelSnapshot(): BackgroundTask["replyChannel"]
  * traced 版 captureReplyChannelSnapshot（供 debug trace 观测 task 的回复目标快照）。
  */
 export declare const captureReplyChannelSnapshot: typeof _captureReplyChannelSnapshot;
+/**
+ * ★ Task #5265 — 把当前 EnvContext.pluginEnabled 拍成不可变快照。
+ *
+ * ## 为什么需要（生产故障 2026-11-10 12:45）
+ *
+ * 后台任务完成通知链路（task.background.completed → 通知会话）的
+ * 合成 envEvent **pluginEnabled={}（空）** →
+ * WecomTaskNotifyPlugin.execute 的 pluginEnabled 守卫
+ * （key=wecom-bot-2:WecomTaskNotifyPlugin）不通过 → 插件直接 return
+ * 不发卡（用户只看到纯文本）。
+ *
+ * 主会话（事件轮直发）pluginEnabled 由 event-source-handlers 构建
+ * （有 key）→ 有卡。合成事件（publishBackgroundEvent）此前不携带
+ * pluginEnabled，dispatcher 的重建逻辑依赖 metadata.plugins（也为空）
+ * → 守卫拦截。
+ *
+ * 修复：delegate 时刻快照 pluginEnabled，随 task 存
+ * `BackgroundTask.pluginEnabledSnapshot`，publishBackgroundEvent 时
+ * 写进 event.metadata.pluginEnabled —— 通知轮合成 envEvent 自带，
+ * dispatcher / buildRunEnvContext 透传 → 守卫放行。
+ *
+ * 返回 undefined 当没有 EnvContext / 没有 pluginEnabled（向后兼容）。
+ */
+declare function _capturePluginEnabledSnapshot(): Record<string, boolean> | undefined;
+/**
+ * traced 版 capturePluginEnabledSnapshot（供 debug trace 观测快照结果）。
+ */
+export declare const capturePluginEnabledSnapshot: typeof _capturePluginEnabledSnapshot;
 declare function handleBackgroundTask(backgroundTaskManager: BackgroundTaskManager, parentSessionId: string, description: string, prompt: string, subagentType: string, timeout?: number, similarTaskIds?: number[], 
 /**
  * ★ 2026-07-10 新增（Task #1752 subSessionId 复用机制）
@@ -804,5 +858,11 @@ model?: string, fallbackModel?: string,
  * Task #4724 — 父 agent 本次 run 的兜底模型**有序列表**。
  * 透传给 createTask → sub-agent 的 AgentContext（顺序 = 优先级）。
  */
-fallbackModels?: string[]): Promise<ToolResult>;
+fallbackModels?: string[], 
+/**
+ * ★ Task #5217 fix 2 — 父 agent 本次 run 的 channel systemPrompt
+ * （ToolContext.metadata.systemPrompt，per-event）。
+ * 透传给 createTask → sub-agent 的 AgentContext.metadata.systemPrompt。
+ */
+systemPrompt?: string): Promise<ToolResult>;
 export { handleBackgroundTask };

package/dist/env/task/delegate/delegate-tool.js

@@ -7,12 +7,13 @@ import {
   WORKFLOW_COMPAT_ALIASES,
   buildEntryAgentPrompt,
   builtInSubAgents,
+  capturePluginEnabledSnapshot,
   captureReplyChannelSnapshot,
   createDelegateTool,
   deriveTriggerEventIdFromEnvContext,
   getSubAgentSpec,
   handleBackgroundTask
-} from "../../../shared/@ai-setting/roy-agent-core-aa2j7bk9.js";
+} from "../../../shared/@ai-setting/roy-agent-core-cha0jc7n.js";
 import"../../../shared/@ai-setting/roy-agent-core-fttgm52a.js";
 import"../../../shared/@ai-setting/roy-agent-core-na18zwj0.js";
 import"../../../shared/@ai-setting/roy-agent-core-9vxh6f8h.js";
@@ -35,6 +36,7 @@ export {
   deriveTriggerEventIdFromEnvContext,
   createDelegateTool,
   captureReplyChannelSnapshot,
+  capturePluginEnabledSnapshot,
   builtInSubAgents,
   buildEntryAgentPrompt,
   WORKFLOW_COMPAT_ALIASES,

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

@@ -5,7 +5,7 @@ import {
   BackgroundTaskEventTypes,
   BackgroundTaskManager,
   createDelegateTool
-} from "../../../shared/@ai-setting/roy-agent-core-aa2j7bk9.js";
+} from "../../../shared/@ai-setting/roy-agent-core-cha0jc7n.js";
 import"../../../shared/@ai-setting/roy-agent-core-fttgm52a.js";
 import"../../../shared/@ai-setting/roy-agent-core-na18zwj0.js";
 import"../../../shared/@ai-setting/roy-agent-core-9vxh6f8h.js";

package/dist/env/task/index.js

@@ -5,12 +5,12 @@ import {
   TaskPriorityEnum,
   TaskStatusEnum,
   TaskTypeEnum
-} from "../../shared/@ai-setting/roy-agent-core-z43aj03k.js";
+} from "../../shared/@ai-setting/roy-agent-core-qk9hd89p.js";
 import"../../shared/@ai-setting/roy-agent-core-2akfd64z.js";
 import"../../shared/@ai-setting/roy-agent-core-jm136jzh.js";
-import"../../shared/@ai-setting/roy-agent-core-aa2j7bk9.js";
+import"../../shared/@ai-setting/roy-agent-core-cha0jc7n.js";
 import"../../shared/@ai-setting/roy-agent-core-fttgm52a.js";
-import"../../shared/@ai-setting/roy-agent-core-ntq0gz7q.js";
+import"../../shared/@ai-setting/roy-agent-core-q813vafd.js";
 import {
   TaskEntityEventTypes
 } from "../../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
@@ -21,7 +21,7 @@ import"../../shared/@ai-setting/roy-agent-core-9vxh6f8h.js";
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
-} from "../../shared/@ai-setting/roy-agent-core-abqhkbn3.js";
+} from "../../shared/@ai-setting/roy-agent-core-ezvpreqz.js";
 import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../shared/@ai-setting/roy-agent-core-tr3ep81v.js";
 import"../../shared/@ai-setting/roy-agent-core-m46fe3x4.js";

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

@@ -3,6 +3,7 @@ import {
   createTaskTool,
   getTaskTool,
   listTasksTool,
+  preCompleteTaskTool,
   searchTasksTool,
   treeTasksTool,
   updateTaskTool
@@ -30,6 +31,7 @@ var TASK_MCP_TOOL_NAMES = [
   "task_search",
   "task_update",
   "task_complete",
+  "task_pre_complete",
   "task_operation_create",
   "task_operation_list"
 ];
@@ -56,6 +58,7 @@ var TASK_TOOL_FACTORIES = [
   searchTasksTool,
   updateTaskTool,
   completeTaskTool,
+  preCompleteTaskTool,
   createOperationTool,
   listOperationsTool
 ];

package/dist/env/task/mcp/task-mcp-server.d.ts

@@ -35,7 +35,7 @@
  */
 import type { TaskBackend } from "../backend/types";
 /** The task tools exposed over MCP. */
-export declare const TASK_MCP_TOOL_NAMES: readonly ["task_create", "task_tree", "task_get", "task_list", "task_search", "task_update", "task_complete", "task_operation_create", "task_operation_list"];
+export declare const TASK_MCP_TOOL_NAMES: readonly ["task_create", "task_tree", "task_get", "task_list", "task_search", "task_update", "task_complete", "task_pre_complete", "task_operation_create", "task_operation_list"];
 export type TaskMcpToolName = (typeof TASK_MCP_TOOL_NAMES)[number];
 /** An MCP tool definition (JSON Schema document — MCP requires JSON Schema). */
 export interface TaskMcpToolDefinition {

package/dist/env/task/plugins/fake-user-message-helper.d.ts

@@ -45,13 +45,21 @@ import type { ModelMessage } from "ai";
 /**
  * Kinds of fake user messages. Used for deterministic merge ordering.
  *
- * Priority: "max-iter" > "delegate"
+ * Priority (KIND_PRIORITY below): "max-iter" > "task-ops" > "delegate"
  * - "max-iter" reminders contain "不要再调用任何工具，直接总结" (final instruction)
+ * - "task-ops" reminders contain "task_operation_list" (Task #5081:
+ *   sub-agent awareness of others' task operations)
  * - "delegate" reminders contain "use delegate_task" (earlier hint)
  *
  * The final merged message always ends with the max-iter reminder.
  */
-export type FakeUserMessageKind = "delegate" | "max-iter";
+export type FakeUserMessageKind = "delegate" | "task-ops" | "max-iter";
+/**
+ * Merge priority per kind — higher value = appears later in the
+ * merged message / wins the finalKind. Task #5081: "task-ops" sits
+ * between "delegate" (business hint) and "max-iter" (final word).
+ */
+export declare const KIND_PRIORITY: Record<FakeUserMessageKind, number>;
 /**
  * Internal implementation of the enqueue helper. Not exported directly;
  * instead `enqueueToAddFakeUserMessage` (the wrapped version) is exported

package/dist/env/task/plugins/index.d.ts

@@ -4,11 +4,14 @@
 export { TaskTagPlugin } from "./task-tag-plugin";
 export { LayaDecisionPlugin, createLayaDecisionPlugin, LAYA_REUSE_THRESHOLD, type LayaDecisionPluginOptions, } from "./laya-decision-plugin";
 export { createAutoTaskPlugin, type AutoTaskPluginConfig, } from "./auto-task-plugin";
+export { createTaskOpWatermarkPlugin, TaskOpWatermarkPlugin, TASK_OP_WATERMARK_MAX_REMINDERS, TASK_OP_WATERMARK_MESSAGE_LIMIT, TASK_OP_WATERMARK_AUDIT_INTERVAL, type TaskOpWatermarkPluginConfig, } from "./task-op-watermark-plugin";
 export { LayaCompletionPlugin, createLayaCompletionPlugin, registerLayaCompletionTaskHook, buildCompletionHint, renderCompletionState, buildCompletionQuestion, LAYA_COMPLETION_THRESHOLD, type LayaCompletionPluginOptions, } from "./laya-completion-plugin";
 export { TASK_COMPLETION_HINT_ANCHOR, TASK_COMPLETE_ITEM_BY_ITEM, TASK_COMPLETE_VERIFY_DUTY, TASK_COMPLETE_ACCEPTANCE, } from "../tools/completion-copy";
 export type { DecisionPort, DecisionRequest, DecisionAnswer, DecisionResponse, } from "./decision-port";
 export { WORKFLOW_EXTRACTOR_PROMPT, formatExtractorInput, formatExtractorInputFromDescription, parseExtractorOutput, } from "./workflow-extractor-agent";
 export { LarkCliTaskNotifyHook, createLarkCliTaskNotifyHook, type TaskNotifyConfig, NotifyType, } from "./lark-cli-task-notify-plugin";
+export { WecomTaskNotifyHook, createWecomTaskNotifyHook, extractWecomFields, buildWecomTaskCard, WecomNotifyType, type WecomTaskNotifyConfig, type WecomMilestone, } from "./wecom-task-notify-plugin";
+export { createWecomCardStateStore, createMemoryWecomCardStore, MemoryWecomCardStateStore, SqliteWecomCardStateStore, getDefaultWecomCardDbPath, type WecomCardState, type WecomCardStateStore, } from "./wecom-card-state-store";
 export { PerTaskGroupChatPlugin, createPerTaskGroupChatPlugin, type PerTaskGroupConfig, } from "./per-task-group-chat-plugin";
 export { LarkCardPatchNotifier, type LarkCardPatchNotifierOptions, buildTaskCard, buildWorkflowCard, renderProgressBar, renderMilestones, renderProcessSteps, renderTaskInfoLines, renderContextAsLines, renderWorkflowInfoLines, formatTimestampForDisplay, formatDateTimeForDisplay, formatDurationMs, sanitizeInlineText, humanizeValue, resolveTaskTitleForDisplay, buildChatAppLink, DEFAULT_APP_LINK_BASE, type CardStatus, type WorkflowCardStatus, type Milestone, type ProcessStep, type TaskMeta, type WorkflowMeta, type CardPayload, type StartTaskOptions, type UpdateTaskOptions, type FinishTaskOptions, type StartTaskResult, type StartWorkflowOptions, type UpdateWorkflowOptions, type FinishWorkflowOptions, } from "./lark-card-patch-notifier";
 export { createLarkCardStateStore, getDefaultLarkCardDbPath, MemoryLarkCardStateStore, SqliteLarkCardStateStore, type LarkCardState, type LarkCardRecordStatus, type LarkCardStateStore, } from "./lark-card-state-store";

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

@@ -5,29 +5,40 @@ import {
   LayaCompletionPlugin,
   LayaDecisionPlugin,
   MemoryLarkCardStateStore,
+  MemoryWecomCardStateStore,
   NotifyType,
   PerTaskGroupChatPlugin,
   SqliteLarkCardStateStore,
+  SqliteWecomCardStateStore,
   TaskTagPlugin,
   WORKFLOW_EXTRACTOR_PROMPT,
+  WecomNotifyType,
+  WecomTaskNotifyHook,
   buildCompletionHint,
   buildCompletionQuestion,
+  buildWecomTaskCard,
   createAutoTaskPlugin,
   createLarkCardStateStore,
   createLarkCliTaskNotifyHook,
   createLayaCompletionPlugin,
   createLayaDecisionPlugin,
+  createMemoryWecomCardStore,
   createPerTaskGroupChatPlugin,
+  createWecomCardStateStore,
+  createWecomTaskNotifyHook,
+  extractWecomFields,
   formatExtractorInput,
   formatExtractorInputFromDescription,
   getDefaultLarkCardDbPath,
+  getDefaultWecomCardDbPath,
   parseExtractorOutput,
   registerLayaCompletionTaskHook,
   renderCompletionState
-} from "../../../shared/@ai-setting/roy-agent-core-ghnagzrh.js";
+} from "../../../shared/@ai-setting/roy-agent-core-b31v3qpv.js";
+import"../../../shared/@ai-setting/roy-agent-core-m3vjepzz.js";
 import"../../../shared/@ai-setting/roy-agent-core-na18zwj0.js";
 import"../../../shared/@ai-setting/roy-agent-core-9vxh6f8h.js";
-import"../../../shared/@ai-setting/roy-agent-core-abqhkbn3.js";
+import"../../../shared/@ai-setting/roy-agent-core-ezvpreqz.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../../shared/@ai-setting/roy-agent-core-tr3ep81v.js";
 import"../../../shared/@ai-setting/roy-agent-core-m46fe3x4.js";
@@ -55,11 +66,17 @@ import {
   renderWorkflowInfoLines,
   resolveTaskTitleForDisplay,
   sanitizeInlineText
-} from "../../../shared/@ai-setting/roy-agent-core-nmx9934r.js";
+} from "../../../shared/@ai-setting/roy-agent-core-7dd0s3xb.js";
 import"../../../shared/@ai-setting/roy-agent-core-1v4g0d4x.js";
 import"../../../shared/@ai-setting/roy-agent-core-cgtq6427.js";
 import"../../../shared/@ai-setting/roy-agent-core-er070zjq.js";
-import"../../../shared/@ai-setting/roy-agent-core-f77k3gqt.js";
+import {
+  TASK_OP_WATERMARK_AUDIT_INTERVAL,
+  TASK_OP_WATERMARK_MAX_REMINDERS,
+  TASK_OP_WATERMARK_MESSAGE_LIMIT,
+  TaskOpWatermarkPlugin,
+  createTaskOpWatermarkPlugin
+} from "../../../shared/@ai-setting/roy-agent-core-h21gngxf.js";
 import"../../../shared/@ai-setting/roy-agent-core-mkc3zshb.js";
 import"../../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import"../../../shared/@ai-setting/roy-agent-core-qqaak24r.js";
@@ -81,32 +98,47 @@ export {
   registerLayaCompletionTaskHook,
   parseExtractorOutput,
   humanizeValue,
+  getDefaultWecomCardDbPath,
   getDefaultLarkCardDbPath,
   formatTimestampForDisplay,
   formatExtractorInputFromDescription,
   formatExtractorInput,
   formatDurationMs,
   formatDateTimeForDisplay,
+  extractWecomFields,
+  createWecomTaskNotifyHook,
+  createWecomCardStateStore,
+  createTaskOpWatermarkPlugin,
   createPerTaskGroupChatPlugin,
+  createMemoryWecomCardStore,
   createLayaDecisionPlugin,
   createLayaCompletionPlugin,
   createLarkCliTaskNotifyHook,
   createLarkCardStateStore,
   createAutoTaskPlugin,
   buildWorkflowCard,
+  buildWecomTaskCard,
   buildTaskCard,
   buildCompletionQuestion,
   buildCompletionHint,
   buildChatAppLink,
+  WecomTaskNotifyHook,
+  WecomNotifyType,
   WORKFLOW_EXTRACTOR_PROMPT,
   TaskTagPlugin,
+  TaskOpWatermarkPlugin,
+  TASK_OP_WATERMARK_MESSAGE_LIMIT,
+  TASK_OP_WATERMARK_MAX_REMINDERS,
+  TASK_OP_WATERMARK_AUDIT_INTERVAL,
   TASK_COMPLETION_HINT_ANCHOR,
   TASK_COMPLETE_VERIFY_DUTY,
   TASK_COMPLETE_ITEM_BY_ITEM,
   TASK_COMPLETE_ACCEPTANCE,
+  SqliteWecomCardStateStore,
   SqliteLarkCardStateStore,
   PerTaskGroupChatPlugin,
   NotifyType,
+  MemoryWecomCardStateStore,
   MemoryLarkCardStateStore,
   LayaDecisionPlugin,
   LayaCompletionPlugin,

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

@@ -79,7 +79,14 @@ export type CardStatus = "running" | "completed" | "failed" | "stopped"
  * 语义上必须分开：用户看到「🚫 已取消」会以为任务还能找回来；
  * 硬删除后任务真的没了，卡片应显示「🗑️ 已删除」。
  */
- | "deleted";
+ | "deleted"
+/**
+ * ★ Task #5164 需求 2b：任务进入「待验证」（两阶段验收，
+ *   task_pre_complete 置 to_validate）。**非终态**活跃等待态：
+ *   卡片保持可更新，但 header 第二行显示专属短语「🔍 待验证」，
+ *   让用户一眼看出任务在等验收而不是在跑。
+ */
+ | "to_validate";
 /** workflow 卡片状态（与 CardStatus 同集合；语义别名，便于阅读） */
 export type WorkflowCardStatus = CardStatus;
 /** 里程碑（关键节点）：时间 + 标题 + 描述 */
@@ -262,7 +269,12 @@ export interface StartTaskResult {
 export interface LarkCardPatchNotifierOptions {
     /** 启动时是否 pin（默认 true） */
     pinOnStart?: boolean;
-    /** 结束时是否 unpin（默认 true） */
+    /**
+     * 结束时是否 unpin（Task #5164 需求 2a：**默认 false**）
+     *
+     * 任务完成/暂停时不再自动取消置顶 —— pin 去留由用户手动决定。
+     * 需要旧行为（自动 unpin）的调用方显式传 true。
+     */
     unpinOnFinish?: boolean;
 }
 export interface CardPayload {
@@ -805,6 +817,33 @@ export declare class LarkCardPatchNotifier {
      * 不会被旧 messageId 的终态记录误伤。
      */
     private finalisedCards;
+    /**
+     * ★ Task #5182 follow-up：解除某张卡片的终态标记（reopen 用）。
+     *
+     * ## 为什么需要
+     *
+     * `finalisedCards` 守卫（Task #5020）会吞掉 finishTask 之后的
+     * 一切 updateTask —— 这对「迟到的并发更新」是正确语义，但对
+     * **reopen**（closed 卡片 + 任务重新激活 → 复用原卡）是错的：
+     * reopen 本来就是要"复活"这张卡。真网取证（2026-11-08 18:00）：
+     * reopenReuseCard 打了「已复用原卡」日志 + pin 成功，但 patch
+     * 被守卫静默吞掉，卡片内容停在「已完成」。
+     *
+     * ## 行为
+     *
+     * - 从 finalisedCards 删除 messageId（守卫解除）
+     * - 内存态不存在时从 exportState 快照恢复？—— 不，states 已被
+     *   finishTask delete，快照无从取。调用方（reopenReuseCard）
+     *   会经 mergeTimelineState/updateTask 的默认 state 重建时间线，
+     *   并由 hook 层 hydrate（restoreCardState → hydrateState）补齐。
+     * - 对未终结的卡是 no-op（finalisedCards 本就没有该 id）
+     */
+    unfinaliseCard(messageId: string): void;
+    /**
+     * ★ Task #5182 follow-up：测试注入点 —— 替换 runLarkCli 的执行器。
+     * 仅测试使用（生产路径不设置），避免真 spawn lark-cli。
+     */
+    testRunner?: (argv: string[], op: string) => Promise<string>;
     /** 诊断：当前跟踪中的卡片数（测试/自检用） */
     trackedCardCount(): number;
     /** 诊断：当前跟踪中的 workflow 卡片数（测试/自检用） */

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

@@ -22,7 +22,7 @@ import {
   resolveTaskTitleForDisplay,
   sanitizeInlineText,
   truncateHeadTitle
-} from "../../../shared/@ai-setting/roy-agent-core-nmx9934r.js";
+} from "../../../shared/@ai-setting/roy-agent-core-7dd0s3xb.js";
 import"../../../shared/@ai-setting/roy-agent-core-qq96p0tj.js";
 import"../../../shared/@ai-setting/roy-agent-core-7f7t9wwp.js";
 import"../../../shared/@ai-setting/roy-agent-core-85xyctnb.js";

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

@@ -339,6 +339,22 @@ export declare class LarkCliTaskNotifyHook implements Hook {
      *   持久层 `pinned=false`（如实反映真实状态，不谎报）。
      */
     private repinAfterResume;
+    /**
+     * ★ Task #5182 — reopen 复用原卡（用户明令 2026-11-08 15:56）
+     *
+     * 场景：lark-cards.db 里该 task 的记录是 `closed`，但任务被重新激活
+     * （status → active 等活跃态）。旧实现发一张新卡（同 task 两张卡、
+     * 历史时间线留在旧卡上）；新实现：
+     *
+     *   1. patch 原 messageId：内容 = 当前任务态 + 「🔄 任务重新打开」里程碑
+     *   2. 新增一条 reopen 操作记录进卡片时间线（用户可见的 reopen 痕迹）
+     *   3. 重新 pin（终态时被 unpin 过；pin 状态必须跟任务状态一致）
+     *   4. 持久层 markReopened（closed → open，messageId 不变）
+     *
+     * @returns true = 原卡复用成功（caller 直接返回，不再走建卡路径）；
+     *          false = 原卡 patch 失败（caller 降级走发新卡路径）
+     */
+    private reopenReuseCard;
     /** 合并「写记录」所需的公共字段（读旧记录失败也不抛，降级为 now） */
     private buildCardState;
     /** 对外只读：某 task 的持久化卡片记录（debug / 排查用） */

package/dist/env/task/plugins/task-op-watermark-plugin.d.ts

@@ -0,0 +1,112 @@
+/**
+ * @fileoverview TaskOpWatermarkPlugin — sub-agent 感知任务操作记录（Task #5081，M1）
+ *
+ * 设计文档：/tmp/task-op-awareness-design.md（Task #5079，已验收）
+ *
+ * ## 场景
+ *
+ * sub-agent（roy 等）被委托推进某个 task 期间，default agent（或其它
+ * sub-agent / CLI 探针进程）往同一 task 写了新的 operation 记录。
+ * sub-agent 的 ReAct 循环对「别人给我加了记录」**毫无感知** —— 本插件
+ * 在 `agent:after.tool` 时点做水位比对，命中则通过共享 meta-protocol
+ * （`toolResult.result.metadata.toAddFakeUserMessage`）注入一条
+ * user role 提醒，sub-agent 下轮读到后自行调 `task_operation_list` 读取。
+ *
+ * ## 水位语义（关键设计决策）
+ *
+ * - 水位用 **operation id**（SQLite AUTOINCREMENT，严格单调）而非
+ *   timestamp（Date.now() 毫秒，同毫秒多条会漏）。
+ * - 水位存 plugin 实例的 `Map<sessionId, Watermark>` —— 生命周期与
+ *   plugin 实例一致；进程重启后首轮全量扫（N 聚 1 + 限流兜底噪声）。
+ * - **查询必须绕过 operationsCache**：`sqlite-task-store.ts` 的缓存只在
+ *   本进程写入时失效，跨进程（CLI 探针 / 另一 daemon）写入的记录不会
+ *   失效本进程缓存 → 必须走 `listOperationsFresh`（直打 DB）。
+ * - 能力探测：store 未实现 `listOperationsFresh`（外部宿主的后端）时
+ *   降级 `listOperations` + `invalidateOperationsCache`，功能等价。
+ *
+ * ## 自提醒过滤（防 doom loop，核心）
+ *
+ * `op.sessionId === 我的 sessionId` → 不算新记录。三个来源：
+ * 1. sub-agent 自己 `task_operation_create` 记进度（create-tool.ts:87）
+ * 2. sub-agent 自己 `task_pre_complete` 写的留痕（pre-complete-tool.ts:89，
+ *    Task #5073 两阶段验收的提交口 —— 回归保护）
+ * 3. `sessionId = "unknown"` 的 fallback 写入（create-tool.ts:87 的兜底）
+ *
+ * ## 防退化与边界（设计文档 §4）
+ *
+ * - 无 task 绑定 → 跳过；DB 读异常 → catch + warn，不影响工具执行
+ * - N 条新记录聚合 **1 条**提醒（详情 ≤3 条，最新优先，其余折叠）
+ * - 单 session 限流 `TASK_OP_WATERMARK_MAX_REMINDERS`（5）次，超限只推水位
+ * - 消息总长 ≤ `TASK_OP_WATERMARK_MESSAGE_LIMIT`（1500 字符）
+ * - 每 `TASK_OP_WATERMARK_AUDIT_INTERVAL`（15）次工具调用兜底全量对账
+ * - kind 合并顺序：`delegate` → `task-ops` → `max-iter`（max-iter 最终
+ *   指令永远在末尾，见 fake-user-message-helper KIND_PRIORITY）
+ */
+import type { Plugin, HookContext, HookResult } from "../../agent/types";
+import type { TaskOperation } from "../types";
+/** 单 session（plugin 实例生命周期内）最大提醒次数 */
+export declare const TASK_OP_WATERMARK_MAX_REMINDERS = 5;
+/** 注入消息的总长度上限（字符） */
+export declare const TASK_OP_WATERMARK_MESSAGE_LIMIT = 1500;
+/** 兜底全量对账的工具调用间隔 */
+export declare const TASK_OP_WATERMARK_AUDIT_INTERVAL = 15;
+/**
+ * TaskComponent 只读能力面 —— 与 decision-hint-plugin 的
+ * `TaskComponentReadonly` 同款隔离模式（避免类型循环依赖）。
+ */
+export interface TaskOpWatermarkTaskComponentLike {
+    /** 按 session 反查绑定的**全部** task（多 task 并集水位，不漏报） */
+    getTaskIdsBySessionId?(sessionId: string): Promise<number[] | undefined>;
+    /** 老接口：只返回第一个 task（getTaskIdsBySessionId 未实现时的 fallback） */
+    getTaskIdBySessionId?(sessionId: string): Promise<number | undefined>;
+    getTask(id: number): Promise<{
+        id: number;
+        title: string;
+    } | undefined>;
+    /** 绕过 operationsCache 的 fresh 查询（可选 —— 能力探测） */
+    listOperationsFresh?(options: {
+        taskId: number;
+        limit?: number;
+    }): Promise<TaskOperation[]>;
+    /** 常规查询（fallback 路径用） */
+    listOperations(options: {
+        taskId: number;
+        limit?: number;
+    }): Promise<TaskOperation[]>;
+    /** 缓存失效（fallback 路径用；可选 —— 能力探测） */
+    invalidateOperationsCache?(taskId: number): void;
+}
+export interface TaskOpWatermarkPluginConfig {
+    /**
+     * 惰性解析 TaskComponent（推荐注入方式）。
+     *
+     * 为什么惰性：`registerAgent` 可能早于 TaskComponent 注册（时序风险），
+     * 惰性闭包把解析推迟到首次 `execute()`（env 组件已就绪）——
+     * 设计文档 §2.1 方案 (c)。
+     */
+    resolveTaskComponent?: () => TaskOpWatermarkTaskComponentLike | undefined;
+}
+export declare class TaskOpWatermarkPlugin {
+    readonly name = "TaskOpWatermarkPlugin";
+    readonly version = "1.0.0";
+    readonly description = "Task #5081 \u2014 agent:after.tool \u6C34\u4F4D\u6BD4\u5BF9\uFF1A\u540C\u4E00 task \u51FA\u73B0\u4ED6\u4EBA\uFF08sessionId \u8FC7\u6EE4 + unknown \u8FC7\u6EE4\uFF09\u65B0\u589E\u7684 operation \u65F6\uFF0C\u7ECF\u5171\u4EAB meta-protocol \u6CE8\u5165 user role \u63D0\u9192\uFF08N \u805A 1 / \u9650\u6D41 5 / \u957F\u5EA6 1500 / 15 \u6B21\u515C\u5E95\u5BF9\u8D26 / fresh \u65C1\u8DEF\u7ED5 operationsCache\uFF09\u3002";
+    readonly priority = 40;
+    /** session 级水位（plugin 实例生命周期） */
+    private readonly watermarks;
+    private readonly resolveTaskComponent;
+    constructor(config?: TaskOpWatermarkPluginConfig);
+    execute(ctx: HookContext): Promise<HookResult>;
+    private check;
+    /** 自提醒过滤：自己写的 + unknown fallback 写入的都不算「别人的」 */
+    private isSelf;
+    private resolveTaskIds;
+    /**
+     * 拉取记录 —— fresh 优先（绕 operationsCache；跨进程写入可见），
+     * 能力探测失败降级 listOperations + invalidateOperationsCache。
+     */
+    private listOps;
+}
+/**
+ * 创建 TaskOpWatermarkPlugin 实例（与 createMaxIterationReminderPlugin 同款形态）
+ */
+export declare function createTaskOpWatermarkPlugin(config?: TaskOpWatermarkPluginConfig): Plugin;