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

package/dist/env/task/storage/sqlite-task-store.d.ts

@@ -71,6 +71,13 @@ export interface TaskStore {
      * 确定性映射：sub-agent 的 task_create 用 sessionId=sub-session id）。
      */
     getTaskIdBySessionId(sessionId: string): Promise<number | undefined>;
+    /**
+     * Task #5081（optional）— 按 session_id 反查该 session 关联的**全部**
+     * task id（不限定 create 记录）。TaskOpWatermarkPlugin 对全部 task
+     * 求并集水位。optional：外部宿主实现可不提供（调用方降级到
+     * getTaskIdBySessionId 单值）。
+     */
+    getTaskIdsBySessionId?(sessionId: string): Promise<number[]>;
     createOperation(options: CreateOperationOptions): Promise<TaskOperation>;
     getOperation(id: number): Promise<TaskOperation | undefined>;
     updateOperation(id: number, updates: {
@@ -82,6 +89,22 @@ export interface TaskStore {
     }): Promise<TaskOperation | undefined>;
     deleteOperation(id: number): Promise<boolean>;
     listOperations(options: ListOperationsOptions): Promise<TaskOperation[]>;
+    /**
+     * Task #5081（optional）— 绕过 operationsCache 的直读查询。
+     *
+     * 跨进程写入的 operation 不会失效本进程缓存 → `listOperations`
+     * 可能读陈旧快照。本方法**直打 DB**（`ORDER BY id DESC`，不读写
+     * 缓存），供 TaskOpWatermarkPlugin 的水位检查使用。
+     *
+     * optional：不破坏外部宿主实现的 TaskStore 契约（能力探测 +
+     * 降级路径见 plugin 侧）。
+     */
+    listOperationsFresh?(options: ListOperationsOptions): Promise<TaskOperation[]>;
+    /**
+     * Task #5081（optional）— 主动失效 operationsCache。
+     * 降级路径配套：`listOperations` 前调用，保证读到最新。
+     */
+    invalidateOperationsCache?(taskId: number): void;
     createTag(name: string): Promise<TaskTag>;
     getTag(id: number): Promise<TaskTag | undefined>;
     getTagByName(name: string): Promise<TaskTag | undefined>;
@@ -186,6 +209,28 @@ export declare class SQLiteTaskStore implements TaskStore {
     }): Promise<TaskOperation | undefined>;
     deleteOperation(id: number): Promise<boolean>;
     listOperations(options: ListOperationsOptions): Promise<TaskOperation[]>;
+    /**
+     * Task #5081 — 绕过 operationsCache 的直读查询（optional 能力）。
+     *
+     * 为什么必须有：operationsCache 只在本进程 create/update/delete 时
+     * 失效（:744/:785/:800），**跨进程写入的 operation 不会失效本进程
+     * 缓存** —— CLI 探针 / 另一 daemon 进程写的记录，本进程的
+     * `listOperations` 永远看不到（读陈旧快照）→ TaskOpWatermarkPlugin
+     * 的水位检查会漏报。
+     *
+     * 要点：
+     * - `ORDER BY id DESC`：水位语义要求**单调自增 id**（timestamp 同
+     *   毫秒多条会漏），id 是 AUTOINCREMENT 严格单调。
+     * - **只读，不写 operationsCache**：不污染其它调用方的缓存语义。
+     */
+    listOperationsFresh(options: ListOperationsOptions): Promise<TaskOperation[]>;
+    /**
+     * Task #5081 — 主动失效 operationsCache（optional 能力）。
+     *
+     * 供不支持 `listOperationsFresh` 的外部宿主 backend 走降级路径：
+     * `listOperations` 之前先失效缓存，保证下次读到最新。
+     */
+    invalidateOperationsCache(taskId: number): void;
     /**
      * 按 session_id 反查该 session 创建的第一个 task。
      *
@@ -195,6 +240,15 @@ export declare class SQLiteTaskStore implements TaskStore {
      * 不依赖易失的 EnvContext.currentTaskId（会被 task_complete 清空）或结果文本正则。
      */
     getTaskIdBySessionId(sessionId: string): Promise<number | undefined>;
+    /**
+     * Task #5081 — 按 session_id 反查该 session 关联的**全部** task id
+     * （optional 能力，TaskStore 接口同款 optional）。
+     *
+     * 与 getTaskIdBySessionId 的区别：不限定 milestone_type='create'、
+     * 不 LIMIT 1 —— sub-session 往同一 task 写过任何 operation 记录
+     * （记进度 / milestone / pre_complete 留痕）都算关联。
+     */
+    getTaskIdsBySessionId(sessionId: string): Promise<number[]>;
     private rowToTask;
     /**
      * 安全解析 tags 字段。

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

@@ -161,6 +161,14 @@ export declare class TaskComponent extends BaseComponent {
      * 按 session_id 反查该 session 创建的第一个 task（sub-session → task 确定性映射）。
      */
     getTaskIdBySessionId(sessionId: string): Promise<number | undefined>;
+    /**
+     * Task #5081 — 按 session_id 反查该 session 绑定的**全部** task。
+     *
+     * 为什么需要：一个 sub-session 可能创建/关联多个 task
+     * （getTaskIdBySessionId 只返回第一个，ORDER BY timestamp ASC）。
+     * TaskOpWatermarkPlugin 对全部 task 求并集水位（保守不漏报）。
+     */
+    getTaskIdsBySessionId(sessionId: string): Promise<number[]>;
     /**
      * Get task with operations
      *
@@ -383,6 +391,14 @@ export declare class TaskComponent extends BaseComponent {
      * List operations for a task
      */
     listOperations(options: ListOperationsOptions): Promise<TaskOperation[]>;
+    /**
+     * Task #5081 — 绕过 operationsCache 的直读（optional 能力探测）。
+     *
+     * store 实现 `listOperationsFresh` 时直打 DB；否则降级
+     * `listOperations` + `invalidateOperationsCache`（若支持）。
+     * 语义等价，保证跨进程写入的记录可见。
+     */
+    listOperationsFresh(options: ListOperationsOptions): Promise<TaskOperation[]>;
     /**
      * 获取 TagService
      */

package/dist/env/task/tools/operation/operation-types.d.ts

@@ -82,31 +82,31 @@ export declare const CreateOperationToolSchema: z.ZodEffects<z.ZodObject<{
     md_path: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     task_id: number;
-    milestone_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    milestone_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
     milestone_title?: string | undefined;
     milestone_description?: string | undefined;
     process_description?: string | undefined;
-    action_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    action_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
     action_title?: string | undefined;
     action_description?: string | undefined;
     md_path?: string | undefined;
 }, {
     task_id: number;
-    milestone_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    milestone_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
     milestone_title?: string | undefined;
     milestone_description?: string | undefined;
     process_description?: string | undefined;
-    action_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    action_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
     action_title?: string | undefined;
     action_description?: string | undefined;
     md_path?: string | undefined;
 }>, CreateOperationToolParams, {
     task_id: number;
-    milestone_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    milestone_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
     milestone_title?: string | undefined;
     milestone_description?: string | undefined;
     process_description?: string | undefined;
-    action_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    action_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
     action_title?: string | undefined;
     action_description?: string | undefined;
     md_path?: string | undefined;
@@ -144,17 +144,17 @@ export declare const ListOperationsToolSchema: z.ZodEffects<z.ZodObject<{
     task_id: number;
     limit: number;
     offset: number;
-    milestone_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
-    action_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    milestone_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    action_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
 }, {
     task_id: number;
     limit?: number | undefined;
     offset?: number | undefined;
-    milestone_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
-    action_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    milestone_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    action_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
 }>, {
     task_id: number;
-    milestone_type: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    milestone_type: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
     limit: number;
     offset: number;
     _deprecated_fields_used: string[];
@@ -162,8 +162,8 @@ export declare const ListOperationsToolSchema: z.ZodEffects<z.ZodObject<{
     task_id: number;
     limit?: number | undefined;
     offset?: number | undefined;
-    milestone_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
-    action_type?: "progress" | "completed" | "create" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    milestone_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
+    action_type?: "completed" | "create" | "progress" | "milestone" | "problem" | "solution" | "decision" | "review" | "workflow_extracted" | undefined;
 }>;
 export interface ListOperationsToolParams {
     task_id: number;

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

@@ -1,8 +1,8 @@
 import {
   LarkCliWorkflowNotifyHook,
   createLarkCliWorkflowNotifyHook
-} from "../../../shared/@ai-setting/roy-agent-core-p3zv1mx5.js";
-import"../../../shared/@ai-setting/roy-agent-core-nmx9934r.js";
+} from "../../../shared/@ai-setting/roy-agent-core-hd3n57zs.js";
+import"../../../shared/@ai-setting/roy-agent-core-w0qjeq2v.js";
 import"../../../shared/@ai-setting/roy-agent-core-c2gbt68e.js";
 import"../../../shared/@ai-setting/roy-agent-core-ax9e9szb.js";
 import"../../../shared/@ai-setting/roy-agent-core-cpcd24n2.js";

package/dist/env/workflow/types/event.d.ts

@@ -206,17 +206,17 @@ export declare const NodeProgressEventSchema: z.ZodObject<{
     message: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     type: "node.progress";
+    progress: number;
     run_id: string;
     timestamp: number;
     node_id: string;
-    progress: number;
     message?: string | undefined;
 }, {
     type: "node.progress";
+    progress: number;
     run_id: string;
     timestamp: number;
     node_id: string;
-    progress: number;
     message?: string | undefined;
 }>;
 export declare const NodeCompletedEventSchema: z.ZodObject<{
@@ -632,17 +632,17 @@ export declare const WorkflowEventSchema: z.ZodUnion<[z.ZodObject<{
     message: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     type: "node.progress";
+    progress: number;
     run_id: string;
     timestamp: number;
     node_id: string;
-    progress: number;
     message?: string | undefined;
 }, {
     type: "node.progress";
+    progress: number;
     run_id: string;
     timestamp: number;
     node_id: string;
-    progress: number;
     message?: string | undefined;
 }>, z.ZodObject<{
     run_id: z.ZodString;

package/dist/index.js

@@ -62,21 +62,21 @@ import {
   BaseEnvironment,
   generateDescendingId,
   generateId
-} 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 {
   BountyIMInstance,
   COMMAND_PREFIX,
@@ -108,7 +108,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,
@@ -132,7 +132,7 @@ import {
 import {
   TaskTagPlugin,
   createAutoTaskPlugin
-} from "./shared/@ai-setting/roy-agent-core-ghnagzrh.js";
+} from "./shared/@ai-setting/roy-agent-core-rsn44n9y.js";
 import {
   EventStoreImpl,
   getSharedEventStore,
@@ -146,7 +146,7 @@ import {
 import {
   SQLiteTaskStore,
   getDefaultTaskDbPath
-} from "./shared/@ai-setting/roy-agent-core-abqhkbn3.js";
+} from "./shared/@ai-setting/roy-agent-core-ezvpreqz.js";
 import {
   TaskHookPoints
 } from "./shared/@ai-setting/roy-agent-core-1pg0fepg.js";
@@ -164,8 +164,8 @@ import {
   TASK_COMPLETED_STATUS_WORD,
   TASK_DELIVERABLE_RECORDED
 } from "./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";
@@ -212,7 +212,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 {
   ToolComponent,
   ToolRegistry,
@@ -227,7 +227,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 {
   buildOpencodeHeaders,

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

@@ -1,6 +1,6 @@
 import {
   builtInHandlers
-} from "./roy-agent-core-t3rrb959.js";
+} from "./roy-agent-core-3gpygqcx.js";
 import {
   envKeyToConfigKey
 } from "./roy-agent-core-7hh0brvs.js";

package/dist/shared/@ai-setting/{roy-agent-core-t3rrb959.js → roy-agent-core-3gpygqcx.js}

@@ -10,17 +10,17 @@ import {
   createPerTaskGroupChatPlugin,
   extractPerTaskChatId,
   extractPerTaskChatName
-} from "./roy-agent-core-ghnagzrh.js";
+} from "./roy-agent-core-rsn44n9y.js";
 import {
   getSharedEventStore
 } from "./roy-agent-core-na18zwj0.js";
 import {
   createLarkCliWorkflowNotifyHook
-} from "./roy-agent-core-p3zv1mx5.js";
+} from "./roy-agent-core-hd3n57zs.js";
 import {
   LarkCardPatchNotifier,
   buildTaskCard
-} from "./roy-agent-core-nmx9934r.js";
+} from "./roy-agent-core-w0qjeq2v.js";
 import {
   notifyReactFailure
 } from "./roy-agent-core-6cy43nss.js";

package/dist/shared/@ai-setting/{roy-agent-core-q5r75vev.js → roy-agent-core-9vhq7fvv.js}

@@ -6,8 +6,9 @@ import {
   AgentRegistry
 } from "./roy-agent-core-ed233k5z.js";
 import {
+  createTaskOpWatermarkPlugin,
   enqueueToAddFakeUserMessage
-} from "./roy-agent-core-f77k3gqt.js";
+} from "./roy-agent-core-h21gngxf.js";
 import {
   SessionMessageConverter
 } from "./roy-agent-core-0snm5hc5.js";
@@ -919,6 +920,9 @@ class AgentComponent extends BaseComponent {
     };
     this.agents.set(name, instance);
     this.registerPlugin(name, createMaxIterationReminderPlugin());
+    this.registerPlugin(name, createTaskOpWatermarkPlugin({
+      resolveTaskComponent: () => this.env?.getComponent?.("task")
+    }));
     logger2.info(`Agent registered: ${name}`, { type: instance.config.type });
     return instance;
   }

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

@@ -2,7 +2,7 @@ import {
   createAutoTaskPlugin,
   createLayaDecisionPlugin,
   registerLayaCompletionTaskHook
-} from "./roy-agent-core-ghnagzrh.js";
+} from "./roy-agent-core-rsn44n9y.js";
 import {
   TaskHookPoints
 } from "./roy-agent-core-1pg0fepg.js";

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

@@ -709,6 +709,22 @@ var init_sqlite_task_store = __esm(() => {
       const limit = options.limit || 20;
       return ops.slice(offset, offset + limit);
     }
+    async listOperationsFresh(options) {
+      await this.initialize();
+      const stmt = this.db.prepare("SELECT * FROM task_operation WHERE task_id = ? ORDER BY id DESC");
+      const rows = stmt.all(options.taskId);
+      let ops = rows.map((row) => this.rowToOperation(row));
+      const filterType = options.milestoneType ?? options.actionType;
+      if (filterType) {
+        ops = ops.filter((op) => op.milestoneType === filterType);
+      }
+      const offset = options.offset || 0;
+      const limit = options.limit || 20;
+      return ops.slice(offset, offset + limit);
+    }
+    invalidateOperationsCache(taskId) {
+      this.operationsCache.delete(taskId);
+    }
     async getTaskIdBySessionId(sessionId) {
       await this.initialize();
       if (!sessionId)
@@ -716,6 +732,13 @@ var init_sqlite_task_store = __esm(() => {
       const row = this.db.prepare("SELECT task_id FROM task_operation WHERE session_id = ? AND milestone_type = 'create' ORDER BY timestamp ASC LIMIT 1").get(sessionId);
       return typeof row?.task_id === "number" ? row.task_id : undefined;
     }
+    async getTaskIdsBySessionId(sessionId) {
+      await this.initialize();
+      if (!sessionId)
+        return [];
+      const rows = this.db.prepare("SELECT DISTINCT task_id FROM task_operation WHERE session_id = ? ORDER BY task_id ASC").all(sessionId);
+      return rows.map((r) => r.task_id).filter((id) => typeof id === "number");
+    }
     rowToTask(row) {
       return {
         id: row.id,

package/dist/shared/@ai-setting/roy-agent-core-h21gngxf.js

@@ -0,0 +1,247 @@
+import {
+  init_decorator,
+  wrapFunction
+} from "./roy-agent-core-qq96p0tj.js";
+import {
+  createLogger,
+  init_logger
+} from "./roy-agent-core-7f7t9wwp.js";
+
+// src/env/task/plugins/task-op-watermark-plugin.ts
+init_logger();
+
+// src/env/task/plugins/fake-user-message-helper.ts
+init_decorator();
+var KIND_PRIORITY = {
+  delegate: 10,
+  "task-ops": 20,
+  "max-iter": 30
+};
+var KIND_FIELD = "__fakeUserMessageKind";
+function ensureMetadata(toolResult) {
+  if (!toolResult)
+    return;
+  if (!toolResult.result)
+    toolResult.result = {};
+  if (!toolResult.result.metadata)
+    toolResult.result.metadata = {};
+  return toolResult.result.metadata;
+}
+function stringContent(msg) {
+  const c = msg?.content;
+  return typeof c === "string" ? c : JSON.stringify(c);
+}
+function enqueueToAddFakeUserMessageImpl(toolResult, newMsg, newKind) {
+  const meta = ensureMetadata(toolResult);
+  if (!meta)
+    return { willMerge: false, finalKind: newKind };
+  const existing = meta.toAddFakeUserMessage;
+  const existingKind = meta[KIND_FIELD];
+  if (!existing) {
+    meta.toAddFakeUserMessage = newMsg;
+    meta[KIND_FIELD] = newKind;
+    return { willMerge: false, finalKind: newKind };
+  }
+  let merged;
+  if (KIND_PRIORITY[newKind] >= KIND_PRIORITY[existingKind ?? newKind]) {
+    merged = {
+      role: "user",
+      content: `${stringContent(existing)}
+
+${stringContent(newMsg)}`
+    };
+  } else {
+    merged = {
+      role: "user",
+      content: `${stringContent(newMsg)}
+
+${stringContent(existing)}`
+    };
+  }
+  meta.toAddFakeUserMessage = merged;
+  const finalKind = KIND_PRIORITY[newKind] >= KIND_PRIORITY[existingKind ?? newKind] ? newKind : existingKind ?? newKind;
+  meta[KIND_FIELD] = finalKind;
+  return { willMerge: true, finalKind };
+}
+var enqueueToAddFakeUserMessage = wrapFunction(enqueueToAddFakeUserMessageImpl, "plugin.fake-user-message.enqueue", {
+  recordParams: false,
+  recordResult: false,
+  log: true,
+  resultFilter: (result) => ({
+    "fake-user-message.will_merge": result.willMerge,
+    "fake-user-message.final_kind": result.finalKind
+  })
+});
+
+// src/env/task/plugins/task-op-watermark-plugin.ts
+var logger = createLogger("TaskOpWatermarkPlugin");
+var TASK_OP_WATERMARK_MAX_REMINDERS = 5;
+var TASK_OP_WATERMARK_MESSAGE_LIMIT = 1500;
+var TASK_OP_WATERMARK_AUDIT_INTERVAL = 15;
+var MAX_DETAIL_ITEMS = 3;
+var MAX_DESC_LENGTH = 200;
+var UNKNOWN_SESSION = "unknown";
+var TRUNCATION_SUFFIX = "…（已截断）";
+function truncate(s, max) {
+  if (s.length <= max)
+    return s;
+  return `${s.slice(0, max)}…（已截断）`;
+}
+function buildReminderMessage(taskId, taskTitle, ops) {
+  const count = ops.length;
+  const lines = [];
+  lines.push(`[task-ops] Task #${taskId}${taskTitle ? `「${taskTitle}」` : ""} 有 ${count} 条由**其他 agent** 新增的操作记录，请读取并按需调整你的行为。`);
+  lines.push("");
+  lines.push("最新记录：");
+  const details = ops.slice(0, MAX_DETAIL_ITEMS);
+  for (const op of details) {
+    const desc = op.milestoneDescription ? truncate(op.milestoneDescription.split(`
+`)[0], MAX_DESC_LENGTH) : "";
+    lines.push(`- [${op.milestoneType}] ${op.milestoneTitle}${desc ? `
+  ${desc}` : ""}`);
+  }
+  if (count > MAX_DETAIL_ITEMS) {
+    lines.push(`（其余 ${count - MAX_DETAIL_ITEMS} 条较旧记录省略，可用 task_operation_list 查看全部）`);
+  }
+  lines.push("");
+  lines.push(`请调用 task_operation_list(task_id=${taskId}) 读取全部新记录，判断是否需要修改你的计划、产出或下一步动作。`);
+  lines.push("若这些记录与你的当前工作无关，忽略即可，无需回复。");
+  return lines.join(`
+`);
+}
+
+class TaskOpWatermarkPlugin {
+  name = "TaskOpWatermarkPlugin";
+  version = "1.0.0";
+  description = "Task #5081 — agent:after.tool 水位比对：同一 task 出现他人（sessionId 过滤 + unknown 过滤）新增的 operation 时，经共享 meta-protocol 注入 user role 提醒（N 聚 1 / 限流 5 / 长度 1500 / 15 次兜底对账 / fresh 旁路绕 operationsCache）。";
+  priority = 40;
+  watermarks = new Map;
+  resolveTaskComponent;
+  constructor(config) {
+    this.resolveTaskComponent = config?.resolveTaskComponent;
+  }
+  async execute(ctx) {
+    try {
+      await this.check(ctx);
+    } catch (err) {
+      logger.warn(`[TaskOpWatermark] check failed (fail-open): ${err?.message}`);
+    }
+    return { continue: true };
+  }
+  async check(ctx) {
+    const sessionId = ctx.context?.sessionId;
+    if (!sessionId)
+      return;
+    const taskComponent = this.resolveTaskComponent?.();
+    if (!taskComponent)
+      return;
+    const taskIds = await this.resolveTaskIds(taskComponent, sessionId);
+    if (taskIds.length === 0)
+      return;
+    const taskKey = taskIds.join(",");
+    let wm = this.watermarks.get(sessionId);
+    if (!wm || wm.taskIds.join(",") !== taskKey) {
+      wm = {
+        lastSeenOpId: 0,
+        lastNotifiedOpId: 0,
+        taskIds,
+        reminderCount: 0,
+        toolsSinceAudit: 0
+      };
+      this.watermarks.set(sessionId, wm);
+    }
+    wm.toolsSinceAudit++;
+    const isAuditTurn = wm.toolsSinceAudit >= TASK_OP_WATERMARK_AUDIT_INTERVAL;
+    if (isAuditTurn)
+      wm.toolsSinceAudit = 0;
+    const lowerBound = isAuditTurn || wm.lastSeenOpId === 0 ? wm.lastNotifiedOpId : wm.lastSeenOpId;
+    let newOps = [];
+    let maxIdSeen = wm.lastSeenOpId;
+    for (const taskId of taskIds) {
+      const ops = await this.listOps(taskComponent, taskId);
+      const othersNew = ops.filter((op) => op.id > lowerBound && !this.isSelf(op, sessionId));
+      for (const op of othersNew) {
+        newOps.push(op);
+        if (op.id > maxIdSeen)
+          maxIdSeen = op.id;
+      }
+      const selfMax = ops.filter((op) => this.isSelf(op, sessionId)).reduce((m, op) => Math.max(m, op.id), 0);
+      maxIdSeen = Math.max(maxIdSeen, selfMax);
+    }
+    const seen = new Set;
+    newOps = newOps.filter((op) => seen.has(op.id) ? false : (seen.add(op.id), true)).sort((a, b) => b.id - a.id);
+    wm.lastSeenOpId = Math.max(wm.lastSeenOpId, maxIdSeen);
+    if (newOps.length === 0)
+      return;
+    if (wm.reminderCount >= TASK_OP_WATERMARK_MAX_REMINDERS) {
+      logger.info(`[TaskOpWatermark] session=${sessionId.slice(0, 12)}... reminder limit reached (${wm.reminderCount}) — watermark advanced silently`);
+      return;
+    }
+    if (!ctx.toolResult)
+      return;
+    const byTask = new Map;
+    for (const op of newOps) {
+      const arr = byTask.get(op.taskId) ?? [];
+      arr.push(op);
+      byTask.set(op.taskId, arr);
+    }
+    const sections = [];
+    for (const [taskId, ops] of byTask) {
+      const title = (await safeGetTask(taskComponent, taskId))?.title;
+      sections.push(buildReminderMessage(taskId, title, ops));
+    }
+    const content = sections.join(`
+
+`);
+    const finalContent = content.length > TASK_OP_WATERMARK_MESSAGE_LIMIT ? `${content.slice(0, TASK_OP_WATERMARK_MESSAGE_LIMIT - TRUNCATION_SUFFIX.length)}${TRUNCATION_SUFFIX}` : content;
+    enqueueToAddFakeUserMessage(ctx.toolResult, { role: "user", content: finalContent }, "task-ops");
+    wm.reminderCount++;
+    const maxNotified = newOps.reduce((m, op) => Math.max(m, op.id), 0);
+    wm.lastNotifiedOpId = Math.max(wm.lastNotifiedOpId, maxNotified);
+    logger.info(`[TaskOpWatermark] reminder injected: session=${sessionId.slice(0, 12)}..., tasks=${[...byTask.keys()].join(",")}, newOps=${newOps.length}, reminderCount=${wm.reminderCount}`);
+  }
+  isSelf(op, sessionId) {
+    return op.sessionId === sessionId || op.sessionId === UNKNOWN_SESSION;
+  }
+  async resolveTaskIds(tc, sessionId) {
+    if (typeof tc.getTaskIdsBySessionId === "function") {
+      const ids = await tc.getTaskIdsBySessionId(sessionId);
+      return Array.isArray(ids) ? ids : [];
+    }
+    if (typeof tc.getTaskIdBySessionId === "function") {
+      const id = await tc.getTaskIdBySessionId(sessionId);
+      return typeof id === "number" ? [id] : [];
+    }
+    return [];
+  }
+  async listOps(tc, taskId) {
+    if (typeof tc.listOperationsFresh === "function") {
+      return await tc.listOperationsFresh({ taskId, limit: 50 });
+    }
+    if (typeof tc.invalidateOperationsCache === "function") {
+      tc.invalidateOperationsCache(taskId);
+    }
+    return await tc.listOperations({ taskId, limit: 50 });
+  }
+}
+async function safeGetTask(tc, taskId) {
+  try {
+    return await tc.getTask(taskId);
+  } catch {
+    return;
+  }
+}
+function createTaskOpWatermarkPlugin(config) {
+  const inst = new TaskOpWatermarkPlugin(config);
+  return {
+    name: inst.name,
+    version: inst.version,
+    description: inst.description,
+    hooks: [{ point: "agent:after.tool", priority: inst.priority }],
+    execute: async (ctx) => {
+      return inst.execute(ctx);
+    }
+  };
+}
+
+export { enqueueToAddFakeUserMessage, TASK_OP_WATERMARK_MAX_REMINDERS, TASK_OP_WATERMARK_MESSAGE_LIMIT, TASK_OP_WATERMARK_AUDIT_INTERVAL, TaskOpWatermarkPlugin, createTaskOpWatermarkPlugin };