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

package/dist/env/agent/agent-component.js

@@ -7,12 +7,12 @@ import {
   filterToolsByAgent,
   parseToolList,
   toLLMMessage
-} from "../../shared/@ai-setting/roy-agent-core-q5r75vev.js";
+} from "../../shared/@ai-setting/roy-agent-core-9vhq7fvv.js";
 import"../../shared/@ai-setting/roy-agent-core-v85n42ve.js";
 import"../../shared/@ai-setting/roy-agent-core-jvv2h3d6.js";
 import"../../shared/@ai-setting/roy-agent-core-ed233k5z.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
-import"../../shared/@ai-setting/roy-agent-core-f77k3gqt.js";
+import"../../shared/@ai-setting/roy-agent-core-h21gngxf.js";
 import"../../shared/@ai-setting/roy-agent-core-0snm5hc5.js";
 import"../../shared/@ai-setting/roy-agent-core-fghc2m8z.js";
 import"../../shared/@ai-setting/roy-agent-core-zjdzk1gg.js";

package/dist/env/agent/index.js

@@ -4,12 +4,12 @@ import {
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../../shared/@ai-setting/roy-agent-core-q5r75vev.js";
+} from "../../shared/@ai-setting/roy-agent-core-9vhq7fvv.js";
 import"../../shared/@ai-setting/roy-agent-core-v85n42ve.js";
 import"../../shared/@ai-setting/roy-agent-core-jvv2h3d6.js";
 import"../../shared/@ai-setting/roy-agent-core-ed233k5z.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
-import"../../shared/@ai-setting/roy-agent-core-f77k3gqt.js";
+import"../../shared/@ai-setting/roy-agent-core-h21gngxf.js";
 import"../../shared/@ai-setting/roy-agent-core-0snm5hc5.js";
 import"../../shared/@ai-setting/roy-agent-core-fghc2m8z.js";
 import"../../shared/@ai-setting/roy-agent-core-zjdzk1gg.js";

package/dist/env/event-source/event-source-handlers.js

@@ -11,28 +11,28 @@ import {
   patchCardByLarkCli,
   renderRuleNoticeSection,
   timerHandler
-} from "../../shared/@ai-setting/roy-agent-core-t3rrb959.js";
+} from "../../shared/@ai-setting/roy-agent-core-3gpygqcx.js";
 import"../../shared/@ai-setting/roy-agent-core-bxkjk7zx.js";
 import {
   cliCommandHandler
 } from "../../shared/@ai-setting/roy-agent-core-v0hf14bj.js";
 import"../../shared/@ai-setting/roy-agent-core-tm1mxttk.js";
-import"../../shared/@ai-setting/roy-agent-core-ghnagzrh.js";
+import"../../shared/@ai-setting/roy-agent-core-rsn44n9y.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";
 import"../../shared/@ai-setting/roy-agent-core-4rtg69cn.js";
-import"../../shared/@ai-setting/roy-agent-core-p3zv1mx5.js";
-import"../../shared/@ai-setting/roy-agent-core-nmx9934r.js";
+import"../../shared/@ai-setting/roy-agent-core-hd3n57zs.js";
+import"../../shared/@ai-setting/roy-agent-core-w0qjeq2v.js";
 import"../../shared/@ai-setting/roy-agent-core-6cy43nss.js";
 import"../../shared/@ai-setting/roy-agent-core-c2gbt68e.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"../../shared/@ai-setting/roy-agent-core-h21gngxf.js";
 import"../../shared/@ai-setting/roy-agent-core-ntn32q7j.js";
 import"../../shared/@ai-setting/roy-agent-core-mkc3zshb.js";
 import"../../shared/@ai-setting/roy-agent-core-az13yzmc.js";

package/dist/env/event-source/index.js

@@ -1,7 +1,7 @@
 import"../../shared/@ai-setting/roy-agent-core-b4x6x4k2.js";
 import {
   EventSourceComponent
-} from "../../shared/@ai-setting/roy-agent-core-cxy143m4.js";
+} from "../../shared/@ai-setting/roy-agent-core-0v27y99n.js";
 import {
   BountyIMInstance,
   COMMAND_PREFIX,
@@ -33,7 +33,7 @@ import {
   timerHandler,
   translateCardActionToCommand,
   writeFallbackModelList
-} from "../../shared/@ai-setting/roy-agent-core-t3rrb959.js";
+} from "../../shared/@ai-setting/roy-agent-core-3gpygqcx.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -51,7 +51,7 @@ import {
   parseCliSessionChatId
 } from "../../shared/@ai-setting/roy-agent-core-v0hf14bj.js";
 import"../../shared/@ai-setting/roy-agent-core-tm1mxttk.js";
-import"../../shared/@ai-setting/roy-agent-core-ghnagzrh.js";
+import"../../shared/@ai-setting/roy-agent-core-rsn44n9y.js";
 import {
   EventStoreImpl,
   getSharedEventStore,
@@ -59,19 +59,19 @@ import {
   setSharedEventStore
 } from "../../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";
 import"../../shared/@ai-setting/roy-agent-core-4rtg69cn.js";
-import"../../shared/@ai-setting/roy-agent-core-p3zv1mx5.js";
-import"../../shared/@ai-setting/roy-agent-core-nmx9934r.js";
+import"../../shared/@ai-setting/roy-agent-core-hd3n57zs.js";
+import"../../shared/@ai-setting/roy-agent-core-w0qjeq2v.js";
 import"../../shared/@ai-setting/roy-agent-core-6cy43nss.js";
 import"../../shared/@ai-setting/roy-agent-core-c2gbt68e.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"../../shared/@ai-setting/roy-agent-core-h21gngxf.js";
 import"../../shared/@ai-setting/roy-agent-core-ntn32q7j.js";
 import"../../shared/@ai-setting/roy-agent-core-mkc3zshb.js";
 import"../../shared/@ai-setting/roy-agent-core-az13yzmc.js";

package/dist/env/index.js

@@ -1,24 +1,24 @@
 import {
   BaseEnvironment
-} from "../shared/@ai-setting/roy-agent-core-zycadbpx.js";
+} from "../shared/@ai-setting/roy-agent-core-ew6qb5yx.js";
 import {
   TaskComponent
-} from "../shared/@ai-setting/roy-agent-core-z43aj03k.js";
+} from "../shared/@ai-setting/roy-agent-core-rhtdspx6.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-fttgm52a.js";
-import"../shared/@ai-setting/roy-agent-core-ntq0gz7q.js";
+import"../shared/@ai-setting/roy-agent-core-q813vafd.js";
 import"../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
 import"../shared/@ai-setting/roy-agent-core-vffccgf6.js";
 import"../shared/@ai-setting/roy-agent-core-p5cz9m8v.js";
 import {
   EventSourceComponent
-} from "../shared/@ai-setting/roy-agent-core-cxy143m4.js";
+} from "../shared/@ai-setting/roy-agent-core-0v27y99n.js";
 import {
   builtInHandlers,
   larkCliHandler
-} from "../shared/@ai-setting/roy-agent-core-t3rrb959.js";
+} from "../shared/@ai-setting/roy-agent-core-3gpygqcx.js";
 import {
   EventSourceInitHooks,
   getDefaultConfigForType,
@@ -28,16 +28,16 @@ import {
 } from "../shared/@ai-setting/roy-agent-core-bxkjk7zx.js";
 import"../shared/@ai-setting/roy-agent-core-v0hf14bj.js";
 import"../shared/@ai-setting/roy-agent-core-tm1mxttk.js";
-import"../shared/@ai-setting/roy-agent-core-ghnagzrh.js";
+import"../shared/@ai-setting/roy-agent-core-rsn44n9y.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";
 import"../shared/@ai-setting/roy-agent-core-4rtg69cn.js";
-import"../shared/@ai-setting/roy-agent-core-p3zv1mx5.js";
-import"../shared/@ai-setting/roy-agent-core-nmx9934r.js";
+import"../shared/@ai-setting/roy-agent-core-hd3n57zs.js";
+import"../shared/@ai-setting/roy-agent-core-w0qjeq2v.js";
 import {
   WorkflowComponent
 } from "../shared/@ai-setting/roy-agent-core-v87njmq7.js";
@@ -68,7 +68,7 @@ import"../shared/@ai-setting/roy-agent-core-jagkferh.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../shared/@ai-setting/roy-agent-core-q5r75vev.js";
+} from "../shared/@ai-setting/roy-agent-core-9vhq7fvv.js";
 import"../shared/@ai-setting/roy-agent-core-v85n42ve.js";
 import"../shared/@ai-setting/roy-agent-core-jvv2h3d6.js";
 import"../shared/@ai-setting/roy-agent-core-ed233k5z.js";
@@ -77,7 +77,7 @@ import {
   getXDGPath,
   getXDGPaths
 } from "../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
-import"../shared/@ai-setting/roy-agent-core-f77k3gqt.js";
+import"../shared/@ai-setting/roy-agent-core-h21gngxf.js";
 import"../shared/@ai-setting/roy-agent-core-0snm5hc5.js";
 import"../shared/@ai-setting/roy-agent-core-fghc2m8z.js";
 import"../shared/@ai-setting/roy-agent-core-zjdzk1gg.js";

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

@@ -1,6 +1,7 @@
 import {
   TASK_COMPLETED_STATUS_WORD,
-  TASK_DELIVERABLE_RECORDED
+  TASK_DELIVERABLE_RECORDED,
+  TASK_TO_VALIDATE_STATUS_WORD
 } from "../../../shared/@ai-setting/roy-agent-core-4rtg69cn.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 // src/env/task/backend/task-store-backend.ts
@@ -166,6 +167,41 @@ class TaskStoreBackend {
     const reread = await this.resolve(record.nativeId);
     return this.toTask(reread ?? updated);
   }
+  async preCompleteTask(id, sessionId, deliverable, progressSummary) {
+    const record = await this.resolve(id);
+    if (!record)
+      return null;
+    if (record.type === "cycle") {
+      throw new Error(`Cannot pre-complete cycle task: #${record.id} - ${record.title}. Cycle tasks are not meant to be completed or submitted for acceptance.`);
+    }
+    const toValidateWording = progressSummary ? `${TASK_TO_VALIDATE_STATUS_WORD}：${progressSummary}` : TASK_TO_VALIDATE_STATUS_WORD;
+    const patch = {
+      status: "to_validate",
+      current_status: toValidateWording
+    };
+    if (deliverable) {
+      patch.context = mergeDeliverableIntoContext(record.context, deliverable);
+    }
+    const updated = await this.port.updateTask(record.nativeId, patch);
+    if (!updated)
+      return null;
+    const descParts = [];
+    const deliverableLine = formatDeliverableForOperation(deliverable);
+    if (deliverableLine)
+      descParts.push(deliverableLine);
+    if (progressSummary)
+      descParts.push(progressSummary);
+    await this.createOperation({
+      taskId: updated.id,
+      sessionId: sessionId ?? this.defaultSessionId,
+      milestoneType: "milestone",
+      milestoneTitle: `${TASK_TO_VALIDATE_STATUS_WORD}（to_validate）：Task #${updated.id} submitted for acceptance`,
+      milestoneDescription: descParts.join(" / ") || TASK_TO_VALIDATE_STATUS_WORD,
+      ...deliverable ? { mdPath: deliverable } : {}
+    });
+    const reread = await this.resolve(record.nativeId);
+    return this.toTask(reread ?? updated);
+  }
   async getTaskTree(id, depth = -1) {
     const root = await this.resolve(id);
     if (!root)

package/dist/env/task/backend/task-store-backend.d.ts

@@ -62,6 +62,18 @@ export declare class TaskStoreBackend implements TaskBackend {
     updateTask(id: TaskId, input: BackendUpdateTaskOptions): Promise<Task | null>;
     deleteTask(id: TaskId): Promise<boolean>;
     completeTask(id: TaskId, sessionId?: string, deliverable?: string): Promise<Task | null>;
+    /**
+     * Task #5078 — 提交待验证（两阶段验收 #5073 的 backend 实现）。
+     *
+     * 语义与 `TaskComponent.preCompleteTask` 同构：
+     * status → to_validate、current_status → 待验证措辞、
+     * deliverable merge 进 context、milestone operation 留痕。
+     *
+     * 与 TaskComponent 的唯一差别：**不 fire AFTER_COMPLETE 钩子** ——
+     * backend 没有 hook 链（#5035 已确认），goal 判定由上层负责
+     * （MCP 侧 = 插件 withGoalCheck；TaskComponent 侧 = 插件链）。
+     */
+    preCompleteTask(id: TaskId, sessionId?: string, deliverable?: string, progressSummary?: string): Promise<Task | null>;
     /**
      * review B1 — roy 的 `task-tree-tool.ts` 在子树模式下调这个方法；
      * 老 facade 缺它导致 `task_tree(parent_task_id=…)` 直接抛

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/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-rhtdspx6.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-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,6 +4,7 @@
 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";

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

@@ -24,10 +24,10 @@ import {
   parseExtractorOutput,
   registerLayaCompletionTaskHook,
   renderCompletionState
-} from "../../../shared/@ai-setting/roy-agent-core-ghnagzrh.js";
+} from "../../../shared/@ai-setting/roy-agent-core-rsn44n9y.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 +55,17 @@ import {
   renderWorkflowInfoLines,
   resolveTaskTitleForDisplay,
   sanitizeInlineText
-} from "../../../shared/@ai-setting/roy-agent-core-nmx9934r.js";
+} from "../../../shared/@ai-setting/roy-agent-core-w0qjeq2v.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";
@@ -87,6 +93,7 @@ export {
   formatExtractorInput,
   formatDurationMs,
   formatDateTimeForDisplay,
+  createTaskOpWatermarkPlugin,
   createPerTaskGroupChatPlugin,
   createLayaDecisionPlugin,
   createLayaCompletionPlugin,
@@ -100,6 +107,10 @@ export {
   buildChatAppLink,
   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,

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-w0qjeq2v.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/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;

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

@@ -1,9 +1,9 @@
-import"../../../shared/@ai-setting/roy-agent-core-ntq0gz7q.js";
+import"../../../shared/@ai-setting/roy-agent-core-q813vafd.js";
 import {
   SQLiteTaskStore,
   getDefaultDataDir,
   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-qq96p0tj.js";
 import"../../../shared/@ai-setting/roy-agent-core-7f7t9wwp.js";
 import"../../../shared/@ai-setting/roy-agent-core-85xyctnb.js";