aws-runtime-bridge 1.9.58 → 1.9.60

package/package/acode/dist/sub-agent-store.d.ts

@@ -1,12 +1,22 @@
 import type { SubAgentDocument, SubAgentEvent, SubAgentRecord } from "./sub-agent-types.js";
 /**
  * Sub Agent JSON 文件存储，按 agentId 隔离。
- * 文件路径：{homedir}/.acode/sub-agents/{agentId}.json
  *
- * 设计与 TodoStore 完全同构：
+ * 文件布局：
+ *   - 主记录文件：{homedir}/.acode/sub-agents/{agentId}.json
+ *       存放 SubAgentRecord[]（不含 events 字段，避免全量读写阻塞终态写入）
+ *   - 事件日志文件：{homedir}/.acode/sub-agents/{agentId}.{subId}.events.jsonl
+ *       每行一个 SubAgentEvent，append-only，O(1) 追加，不进主 writeChain
+ *
+ * 设计要点：
  *   - 不依赖 agent 工作目录，避免 workspacePath 错误时读取失败
  *   - sub-agent 跟随 agent（agentId），不跟随项目工作区
- *   - 写操作通过 Promise 链串行化，tmp + rename 原子替换
+ *   - 主记录写操作通过 Promise 链串行化，tmp + rename 原子替换
+ *     （rename 在 Windows 上目标被打开时会 EPERM，使用 renameWithRetry 短退避重试）
+ *   - events 走独立文件，避免 tool_start/tool_end 高频落盘阻塞终态 updateStatus
+ *     （历史教训：events 与 updateStatus 共用 writeChain 时，memory delegate
+ *      一次跑数十个工具调用，appendEvent 排队导致 updateStatus 超 5s 超时，
+ *      内存已翻终态但 store 仍 running，触发 "status mismatch" 兜底误报）
  *
  * 历史保留策略：全部 sub-agent 记录都持久化（含 completed/failed/cancelled），
  *   按 startedAt 倒序排列。dashboard 按需分页读取。
@@ -15,8 +25,10 @@ export declare class SubAgentStore {
     private readonly dir;
     private writeChain;
     constructor();
-    /** 文件路径（按 agentId 隔离，防路径穿越） */
+    /** 主记录文件路径（按 agentId 隔离，防路径穿越） */
     private filePath;
+    /** 事件日志文件路径（按 agentId + subId 隔离，防路径穿越） */
+    private eventsFilePath;
     /** 读取该 agentId 的完整文档。文件不存在或损坏时返回空文档。 */
     read(agentId: string): Promise<SubAgentDocument>;
     /** 读取单个 sub-agent 记录 */
@@ -29,8 +41,26 @@ export declare class SubAgentStore {
     updateStatus(agentId: string, subId: string, patch: Partial<SubAgentRecord>): Promise<void>;
     /** 列出该 agent 的全部 sub-agent（已按 startedAt 倒序） */
     list(agentId: string): Promise<SubAgentRecord[]>;
-    /** 追加一条事件到指定 sub-agent 的 events 数组（用于 tool_start/tool_end 持久化） */
+    /**
+     * 追加一条事件到指定 sub-agent 的事件日志文件。
+     *
+     * 走独立 jsonl 文件（每行一个事件，append-only），不进主 writeChain：
+     *   - O(1) 追加，无需 read-modify-write 全量主文件
+     *   - 不阻塞终态 updateStatus（避免 status mismatch 兜底误报）
+     *   - 高频 tool_start/tool_end 落盘成本恒定，与历史记录数无关
+     *
+     * 失败时仅打日志（fire-and-forget 语义），不阻断 sub-agent 运行。
+     * 调用方（sub-agent-manager.emitEvent）已用 void + catch 包装。
+     */
     appendEvent(agentId: string, subId: string, event: SubAgentEvent): Promise<void>;
+    /**
+     * 读取指定 sub-agent 的全部历史事件（按时间顺序）。
+     *
+     * 优先读独立 jsonl 文件；不存在时回退到主记录文件中的 events 字段
+     * （向后兼容旧版本数据：旧版把 events 内嵌在 SubAgentRecord 中）。
+     * 供 SSE 路由在客户端重连时补发历史 tool 事件。
+     */
+    readEvents(agentId: string, subId: string): Promise<SubAgentEvent[]>;
     /**
      * 扫描所有 agent 文件，把 status="running"/"pending" 的记录修正为 "failed"。
      * 在 bridge 启动时调用，清理上次进程异常退出留下的僵尸记录。

package/package/acode/dist/sub-agent-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sub-agent-store.d.ts","sourceRoot":"","sources":["../src/sub-agent-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE5F;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAoC;;IAMtD,+BAA+B;IAC/B,OAAO,CAAC,QAAQ;IAKhB,wCAAwC;IAClC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoBtD,wBAAwB;IAClB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAKzE,oCAAoC;IAC9B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxE,wBAAwB;IAClB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpE,eAAe;IACT,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC;IAQhB,+CAA+C;IACzC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAItD,kEAAkE;IAC5D,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtF;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;CAmC1C"}
+{"version":3,"file":"sub-agent-store.d.ts","sourceRoot":"","sources":["../src/sub-agent-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG5F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAoC;;IAMtD,kCAAkC;IAClC,OAAO,CAAC,QAAQ;IAKhB,2CAA2C;IAC3C,OAAO,CAAC,cAAc;IAMtB,wCAAwC;IAClC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoBtD,wBAAwB;IAClB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAKzE,oCAAoC;IAC9B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBxE,wBAAwB;IAClB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpE,eAAe;IACT,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC;IAQhB,+CAA+C;IACzC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAItD;;;;;;;;;;OAUG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtF;;;;;;OAMG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAyB1E;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;CAmC1C"}

package/package/acode/dist/sub-agent-store.js

@@ -1,14 +1,25 @@
 import { promises as fs } from "node:fs";
 import os from "node:os";
 import path from "node:path";
+import { renameWithRetry } from "./fs-utils.js";
 /**
  * Sub Agent JSON 文件存储，按 agentId 隔离。
- * 文件路径：{homedir}/.acode/sub-agents/{agentId}.json
  *
- * 设计与 TodoStore 完全同构：
+ * 文件布局：
+ *   - 主记录文件：{homedir}/.acode/sub-agents/{agentId}.json
+ *       存放 SubAgentRecord[]（不含 events 字段，避免全量读写阻塞终态写入）
+ *   - 事件日志文件：{homedir}/.acode/sub-agents/{agentId}.{subId}.events.jsonl
+ *       每行一个 SubAgentEvent，append-only，O(1) 追加，不进主 writeChain
+ *
+ * 设计要点：
  *   - 不依赖 agent 工作目录，避免 workspacePath 错误时读取失败
  *   - sub-agent 跟随 agent（agentId），不跟随项目工作区
- *   - 写操作通过 Promise 链串行化，tmp + rename 原子替换
+ *   - 主记录写操作通过 Promise 链串行化，tmp + rename 原子替换
+ *     （rename 在 Windows 上目标被打开时会 EPERM，使用 renameWithRetry 短退避重试）
+ *   - events 走独立文件，避免 tool_start/tool_end 高频落盘阻塞终态 updateStatus
+ *     （历史教训：events 与 updateStatus 共用 writeChain 时，memory delegate
+ *      一次跑数十个工具调用，appendEvent 排队导致 updateStatus 超 5s 超时，
+ *      内存已翻终态但 store 仍 running，触发 "status mismatch" 兜底误报）
  *
  * 历史保留策略：全部 sub-agent 记录都持久化（含 completed/failed/cancelled），
  *   按 startedAt 倒序排列。dashboard 按需分页读取。
@@ -18,11 +29,17 @@ export class SubAgentStore {
         this.writeChain = Promise.resolve();
         this.dir = path.join(os.homedir(), ".acode", "sub-agents");
     }
-    /** 文件路径（按 agentId 隔离，防路径穿越） */
+    /** 主记录文件路径（按 agentId 隔离，防路径穿越） */
     filePath(agentId) {
         const safe = String(agentId).replace(/[^a-zA-Z0-9_-]/g, "_");
         return path.join(this.dir, `${safe}.json`);
     }
+    /** 事件日志文件路径（按 agentId + subId 隔离，防路径穿越） */
+    eventsFilePath(agentId, subId) {
+        const safeAgent = String(agentId).replace(/[^a-zA-Z0-9_-]/g, "_");
+        const safeSub = String(subId).replace(/[^a-zA-Z0-9_-]/g, "_");
+        return path.join(this.dir, `${safeAgent}.${safeSub}.events.jsonl`);
+    }
     /** 读取该 agentId 的完整文档。文件不存在或损坏时返回空文档。 */
     async read(agentId) {
         const empty = { agentId, updatedAt: "", subAgents: [] };
@@ -59,11 +76,19 @@ export class SubAgentStore {
             const doc = {
                 agentId,
                 updatedAt: new Date().toISOString(),
-                subAgents: subAgents.sort((a, b) => b.startedAt - a.startedAt),
+                // ★ 主记录文件不再存 events 字段（events 走独立 jsonl 文件）。
+                //   剥离 events 避免每次 appendEvent 都全量重写主文件，
+                //   也能显著减小主文件体积（events 是高频大字段）。
+                subAgents: subAgents
+                    .map(({ events: _events, ...rest }) => rest)
+                    .sort((a, b) => b.startedAt - a.startedAt),
             };
             const tmp = `${target}.tmp`;
             await fs.writeFile(tmp, JSON.stringify(doc, null, 2), "utf-8");
-            await fs.rename(tmp, target);
+            // ★ Windows 上 fs.rename 目标被 reader 打开时会 EPERM/EBUSY/EACCES，
+            //   瞬时错误，短退避后重试通常即可成功（reader 已释放 fd）。
+            //   POSIX 上 rename 原子，不会触发此类错误。
+            await renameWithRetry(tmp, target);
         });
         this.writeChain = run.catch(() => { });
         await run;
@@ -93,18 +118,56 @@ export class SubAgentStore {
     async list(agentId) {
         return (await this.read(agentId)).subAgents;
     }
-    /** 追加一条事件到指定 sub-agent 的 events 数组（用于 tool_start/tool_end 持久化） */
+    /**
+     * 追加一条事件到指定 sub-agent 的事件日志文件。
+     *
+     * 走独立 jsonl 文件（每行一个事件，append-only），不进主 writeChain：
+     *   - O(1) 追加，无需 read-modify-write 全量主文件
+     *   - 不阻塞终态 updateStatus（避免 status mismatch 兜底误报）
+     *   - 高频 tool_start/tool_end 落盘成本恒定，与历史记录数无关
+     *
+     * 失败时仅打日志（fire-and-forget 语义），不阻断 sub-agent 运行。
+     * 调用方（sub-agent-manager.emitEvent）已用 void + catch 包装。
+     */
     async appendEvent(agentId, subId, event) {
-        const doc = await this.read(agentId);
-        const idx = doc.subAgents.findIndex((r) => r.subId === subId);
-        if (idx < 0)
-            return;
-        const record = doc.subAgents[idx];
-        if (!Array.isArray(record.events)) {
-            record.events = [];
+        const target = this.eventsFilePath(agentId, subId);
+        await fs.mkdir(this.dir, { recursive: true });
+        // 每行一个 JSON 事件，以 \n 结尾，便于流式读取和解析
+        await fs.appendFile(target, JSON.stringify(event) + "\n", "utf-8");
+    }
+    /**
+     * 读取指定 sub-agent 的全部历史事件（按时间顺序）。
+     *
+     * 优先读独立 jsonl 文件；不存在时回退到主记录文件中的 events 字段
+     * （向后兼容旧版本数据：旧版把 events 内嵌在 SubAgentRecord 中）。
+     * 供 SSE 路由在客户端重连时补发历史 tool 事件。
+     */
+    async readEvents(agentId, subId) {
+        const jsonlPath = this.eventsFilePath(agentId, subId);
+        try {
+            const raw = await fs.readFile(jsonlPath, "utf-8");
+            const events = [];
+            for (const line of raw.split("\n")) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                try {
+                    events.push(JSON.parse(trimmed));
+                }
+                catch {
+                    /* 跳过损坏行 */
+                }
+            }
+            return events;
+        }
+        catch (err) {
+            if (err && err.code === "ENOENT") {
+                // jsonl 不存在：回退到主记录文件中的 events 字段（旧版本兼容）
+                const record = await this.get(agentId, subId);
+                return Array.isArray(record?.events) ? record.events : [];
+            }
+            throw err;
         }
-        record.events.push(event);
-        await this.write(agentId, doc.subAgents);
     }
     /**
      * 扫描所有 agent 文件，把 status="running"/"pending" 的记录修正为 "failed"。

package/package/acode/dist/todo-store.d.ts

@@ -27,6 +27,7 @@ export interface TodoDocument {
  * 并发安全：同一 TodoStore 实例的写操作通过 Promise 链串行化，
  * 避免同一 agentId 的并发 todo_write 互相覆盖。
  * 写入采用 tmp + rename 原子替换，防止半写损坏。
+ * （rename 在 Windows 上目标被打开时会 EPERM，使用 renameWithRetry 短退避重试）
  */
 export declare class TodoStore {
     private readonly todosDir;

package/package/acode/dist/todo-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"todo-store.d.ts","sourceRoot":"","sources":["../src/todo-store.ts"],"names":[],"mappings":"AAIA,gBAAgB;AAChB,MAAM,WAAW,QAAQ;IACvB,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,CAAC;IAC9D,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACrC;AAED,qBAAqB;AACrB,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,UAAU,CAAoC;;IAMtD,yBAAyB;IACzB,OAAO,CAAC,QAAQ;IAMhB,4CAA4C;IACtC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAmBlD,8DAA8D;IACxD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAkBnF"}
+{"version":3,"file":"todo-store.d.ts","sourceRoot":"","sources":["../src/todo-store.ts"],"names":[],"mappings":"AAKA,gBAAgB;AAChB,MAAM,WAAW,QAAQ;IACvB,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,CAAC;IAC9D,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACrC;AAED,qBAAqB;AACrB,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,UAAU,CAAoC;;IAMtD,yBAAyB;IACzB,OAAO,CAAC,QAAQ;IAMhB,4CAA4C;IACtC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAmBlD,8DAA8D;IACxD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAqBnF"}

package/package/acode/dist/todo-store.js

@@ -1,6 +1,7 @@
 import { promises as fs } from "node:fs";
 import os from "node:os";
 import path from "node:path";
+import { renameWithRetry } from "./fs-utils.js";
 /**
  * Todo JSON 文件存储，按 agentId 隔离。
  * 文件路径：{homedir}/.acode/todos/{agentId}.json
@@ -12,6 +13,7 @@ import path from "node:path";
  * 并发安全：同一 TodoStore 实例的写操作通过 Promise 链串行化，
  * 避免同一 agentId 的并发 todo_write 互相覆盖。
  * 写入采用 tmp + rename 原子替换，防止半写损坏。
+ * （rename 在 Windows 上目标被打开时会 EPERM，使用 renameWithRetry 短退避重试）
  */
 export class TodoStore {
     constructor() {
@@ -59,7 +61,10 @@ export class TodoStore {
             };
             const tmp = `${target}.tmp`;
             await fs.writeFile(tmp, JSON.stringify(doc, null, 2), "utf-8");
-            await fs.rename(tmp, target);
+            // ★ Windows 上 fs.rename 目标被 reader 打开时会 EPERM/EBUSY/EACCES，
+            //   瞬时错误，短退避后重试通常即可成功（reader 已释放 fd）。
+            //   POSIX 上 rename 原子，不会触发此类错误。
+            await renameWithRetry(tmp, target);
         });
         // 维持链式串行，但不让单次失败阻断后续写
         this.writeChain = run.catch(() => { });

package/package/acode/dist/types.d.ts

@@ -1,4 +1,5 @@
 import type { SubAgentManager } from "./sub-agent-manager.js";
+import type { SubAgentType } from "./sub-agent-types.js";
 import type { ACodeMcpConnection } from "./runtime.js";
 export interface ACodeMcpServerSpec {
     type?: "stdio" | "sse" | "http";
@@ -132,6 +133,16 @@ export interface ACodeRuntimeConfig {
     subAgentModel?: string;
     /** Sub Agent 思考强度覆盖（空值=继承主 Agent 强度） */
     subAgentEffort?: string;
+    /**
+     * Sub Agent 类型（general | explore）。
+     * - general：完整工具权限（可读写工作区文件）
+     * - explore：只读模式，过滤掉会修改工作区文件的内建工具
+     *   （write_file/edit_file/delete_file/Bash），仅保留 read_file/grep/symbols
+     *   等只读工具 + memory MCP 工具。MCP 工具白名单由
+     *   SUB_AGENT_ALLOWED_MCP_TOOLS 独立施加，此处不重复。
+     *   未设置时视为 general（向后兼容）。
+     */
+    subagentType?: SubAgentType;
     /**
      * 可选：Agent 文件操作变更回调。
      * 当 Agent 调用 write_file/edit_file/delete_file 工具时，

package/package/acode/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package/aws-client-agent-mcp/dist/mcp-server.d.ts

@@ -2,6 +2,19 @@
  * MCP Server 实现
  * 提供 MCP Tools 供 AI Agent 调用
  */
+/**
+ * 绑定文件的逐文件状态。
+ * - no_change: MD5 与基线一致
+ * - content_changed: 文件存在但 MD5 与基线不一致
+ * - not_found: 文件读取不到（被删除/移动）
+ * - no_baseline: 该文件无可用基线（新增绑定尚未建基线，或基线键不匹配），无法判定变更
+ */
+export type BoundFileStatus = 'no_change' | 'content_changed' | 'not_found' | 'no_baseline';
+/** 单条绑定文件的路径与状态。 */
+export interface BoundFileStatusEntry {
+    path: string;
+    status: BoundFileStatus;
+}
 export declare class McpServer {
     private server;
     private agentClient;
@@ -411,6 +424,14 @@ export declare class McpServer {
      * 在 lease 有效期内不再重复 claim。
      */
     private isClaimCached;
+    /**
+     * 计算某条记忆全部绑定文件的逐文件状态（纯计算，不修改任何状态）。
+     * - no_change: 文件存在且 MD5 与基线一致（或无基线时保守视为未变）
+     * - content_changed: 文件存在但 MD5 与基线不一致
+     * - not_found: 文件读取不到（被删除/移动）
+     * 注意：无基线（新增绑定文件尚未建基线）的文件保守返回 no_change，避免误报为变更。
+     */
+    private computeBoundFileStatuses;
     /**
      * 检查一组 Memory 的文件变更
      * Memory 增强功能 (v1.6.0)

package/package/aws-client-agent-mcp/dist/mcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4EH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,yBAAyB,CAAc;IAC/C,OAAO,CAAC,qBAAqB,CAAU;IACvC,OAAO,CAAC,eAAe,CAAc;IACrC,kDAAkD;IAClD,OAAO,CAAC,WAAW,CAAkB;IACrC,sBAAsB;IACtB,OAAO,CAAC,cAAc,CAAiB;IACvC,+CAA+C;IAC/C,OAAO,CAAC,UAAU,CAAU;IAC5B;;;;;OAKG;IACH,OAAO,CAAC,2BAA2B,CAAkC;IAErE;;;;;;OAMG;IACH,OAAO,CAAC,yBAAyB,CAAkC;IAEnE,mEAAmE;IACnE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iCAAiC,CAAiB;IAE1E;;;;OAIG;IACH,OAAO,CAAC,gBAAgB,CAAkD;IAE1E;;;OAGG;IACH,OAAO,CAAC,iBAAiB,CAA+C;IAExE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAM;IACpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAU;IAEzD;;;;;OAKG;IACH,OAAO,CAAC,YAAY,CAA6B;IAEjD,kEAAkE;IAClE,OAAO,CAAC,aAAa,CAAS;IAE9B;;;;OAIG;IACH,OAAO,CAAC,2BAA2B,CAA6B;IAChE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,+BAA+B,CAAU;IAEjE;;;OAGG;IACH,OAAO,CAAC,kBAAkB,CAAiC;IAQ3D;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAyB3B;;;;;;;OAOG;IACH,OAAO,CAAC,gCAAgC;YAU1B,kCAAkC;IAgHhD;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;IAU9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAK3B;;;OAGG;YACW,uBAAuB;IAuBrC;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;;OAGG;IACH,OAAO,CAAC,0BAA0B;;IAoDlC,OAAO,CAAC,aAAa;IAwDrB;;OAEG;YACW,cAAc;IAmD5B;;OAEG;YACW,eAAe;IAmH7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAKlC;IAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CActC;IAEH;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAapC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAgBxC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,8BAA8B;IAM7C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAWvC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IA4BtC,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,YAAY;IAIpB;;;OAGG;IACH;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;;OAGG;YACW,0BAA0B;IAkDxC;;;OAGG;YACW,0BAA0B;IA8CxC;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAkC1B;;;OAGG;YACW,yBAAyB;IAevC;;;;;;;OAOG;IAEH;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IA+B3B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,6BAA6B;IAmCrC;;;OAGG;YACW,kBAAkB;IA4DhC;;;OAGG;YACW,gBAAgB;IAU9B;;;;;OAKG;YACW,kBAAkB;IA2HhC;;;OAGG;YACW,kBAAkB;IAkEhC;;;;OAIG;YACW,kBAAkB;IAoChC;;;;OAIG;YACW,kBAAkB;IAwChC;;;OAGG;YACW,iBAAiB;IAuC/B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;;;OAIG;YACW,kBAAkB;IAUhC;;;OAGG;YACW,oBAAoB;IAoBlC;;;OAGG;IACH;;;;;;;;OAQG;YACW,wBAAwB;IA8DtC;;;OAGG;IACH,OAAO,CAAC,aAAa;IAgBrB;;;;;;;;;;;;OAYG;YACW,8BAA8B;IA2G5C;;;OAGG;YACW,wBAAwB;IAyBtC;;;OAGG;YACW,yBAAyB;IAkDvC;;;;;OAKG;YACW,sBAAsB;IAmEpC;;;OAGG;YACW,8BAA8B;IAwB5C;;;OAGG;YACW,mBAAmB;YAenB,eAAe;IAe7B;;;OAGG;YACW,uBAAuB;YAcvB,mBAAmB;YAOnB,yBAAyB;YA4BzB,iBAAiB;YAoBjB,+BAA+B;IAW7C;;;OAGG;YACW,yBAAyB;IAYvC;;;;;OAKG;YACW,2BAA2B;YAiB3B,iBAAiB;IAkB/B;;;;;;;;;;;;;;;;OAgBG;YACW,aAAa;IAqE3B;;;OAGG;YACW,mCAAmC;IAwBjD,OAAO,CAAC,eAAe;IASvB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAa/B,OAAO,CAAC,KAAK;IAOb;;;OAGG;YACW,8BAA8B;IA8D5C;;;;;;;;;;OAUG;YACW,iCAAiC;IA8D/C;;;;;;;;OAQG;YACW,iCAAiC;IAiX/C;;;OAGG;IACH,OAAO,CAAC,aAAa;IAUrB;;;OAGG;YACW,wBAAwB;IAoGtC;;;OAGG;YACW,gBAAgB;IA6B9B;;;;OAIG;IACH,OAAO,CAAC,gCAAgC;YAQ1B,gBAAgB;IAuB9B;;;OAGG;YACW,+BAA+B;YA4C/B,kBAAkB;YAQlB,qBAAqB;YAUrB,sBAAsB;YAmBtB,uBAAuB;YASvB,wBAAwB;YAUxB,gBAAgB;YAYhB,mBAAmB;IAejC;;OAEG;YACW,qBAAqB;IAsBnC;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IA6BnC;;;OAGG;IACH,OAAO,CAAC,cAAc;IAMtB;;;OAGG;IACH,OAAO,CAAC,kCAAkC;IAS1C;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAazB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAIlC;;;;;;;;;;;;;;OAcG;YACW,6BAA6B;IAkErC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B5B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IA+BzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;;OAGG;IACH,IAAI,IAAI,IAAI;YAsBE,YAAY;IAqF1B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAUhC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAmC9B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAmB3B,OAAO,CAAC,KAAK;CAGd"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"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"}

package/package/aws-client-agent-mcp/dist/mcp-server.js

@@ -407,10 +407,11 @@ export class McpServer {
                 if (reportableResult !== null) {
                     // 正常结果：上报 toolResult + thinking（工具调用完成，回到思考状态）
                     statusReporter.reportToolResult(reportableResult);
+                    statusReporter.reportThinking();
                 }
-                // 委托消息（reportableResult === null）：跳过 reportToolResult（避免委托通知泄露到时间线），
-                // 但仍调用 reportThinking（工具调用已完成，Agent 回到思考状态等待 ACode runtime 重新 poll）
-                statusReporter.reportThinking();
+                // 委托消息（reportableResult === null）：跳过 reportToolResult 和 reportThinking，
+                // 保持 tool_using 状态。主 agent 仍在 poll_message 循环中等待真正的消息，
+                // 委托给子 agent 处理不应影响主 agent 的状态显示。
             }
             return result;
         }
@@ -2015,6 +2016,15 @@ export class McpServer {
                         _acodeAutoDelegate: {
                             type: 'memory_file_change',
                             uris: updatingChanges.slice(0, 5).map(c => c.memoryUri),
+                            fileChanges: updatingChanges.slice(0, 5).map(c => {
+                                const memory = updatingMemories.find(m => m.id === c.memoryId);
+                                return {
+                                    uri: c.memoryUri,
+                                    boundFiles: memory?.bound_files ?? [],
+                                    fileStatuses: c.fileStatuses,
+                                    changedFiles: c.changedFiles,
+                                };
+                            }),
                         },
                     };
                 }
@@ -2038,6 +2048,12 @@ export class McpServer {
                 for (const m of pendingToNotify) {
                     this.lastUpdatePendingNotifyAt.set(m.uri, now);
                 }
+                // 计算 pending（仍 updating）记忆的逐文件状态，供子 agent 在提示词中标注
+                // （无变更/内容变更/文件找不到），避免「本次变更文件: 未知」歧义。
+                const pendingStatuses = new Map();
+                for (const m of pendingToNotify.slice(0, 5)) {
+                    pendingStatuses.set(m.uri, await this.computeBoundFileStatuses(m));
+                }
                 const memoryList = pendingToNotify
                     .slice(0, 5)
                     .map(m => `- ${m.uri} (文件: ${m.bound_files?.join(', ') || '未知'})`)
@@ -2055,6 +2071,13 @@ export class McpServer {
                     _acodeAutoDelegate: {
                         type: 'memory_file_change',
                         uris: pendingToNotify.slice(0, 5).map(m => m.uri),
+                        // 此分支为「仍 updating」状态提醒，本轮未检测到新的文件变更，
+                        // 仅传递绑定文件清单与逐文件状态供子 agent 直接定位文件，changedFiles 留空。
+                        fileChanges: pendingToNotify.slice(0, 5).map(m => ({
+                            uri: m.uri,
+                            boundFiles: m.bound_files ?? [],
+                            fileStatuses: pendingStatuses.get(m.uri) ?? [],
+                        })),
                     },
                 };
             }
@@ -2152,6 +2175,15 @@ export class McpServer {
                     _acodeAutoDelegate: {
                         type: 'memory_file_change',
                         uris: newListableChanges.map(c => c.memoryUri),
+                        fileChanges: newListableChanges.map(c => {
+                            const memory = listableMemories.find(m => m.id === c.memoryId);
+                            return {
+                                uri: c.memoryUri,
+                                boundFiles: memory?.bound_files ?? [],
+                                fileStatuses: c.fileStatuses,
+                                changedFiles: c.changedFiles,
+                            };
+                        }),
                     },
                 };
             }
@@ -2255,6 +2287,15 @@ export class McpServer {
                         _acodeAutoDelegate: {
                             type: 'memory_file_change',
                             uris: claimedChanges.map(c => c.memoryUri),
+                            fileChanges: claimedChanges.map(c => {
+                                const memory = permanentList.find(m => m.id === c.memoryId);
+                                return {
+                                    uri: c.memoryUri,
+                                    boundFiles: memory?.bound_files ?? [],
+                                    fileStatuses: c.fileStatuses,
+                                    changedFiles: c.changedFiles,
+                                };
+                            }),
                         },
                     };
                 }
@@ -2281,6 +2322,43 @@ export class McpServer {
         }
         return true;
     }
+    /**
+     * 计算某条记忆全部绑定文件的逐文件状态（纯计算，不修改任何状态）。
+     * - no_change: 文件存在且 MD5 与基线一致（或无基线时保守视为未变）
+     * - content_changed: 文件存在但 MD5 与基线不一致
+     * - not_found: 文件读取不到（被删除/移动）
+     * 注意：无基线（新增绑定文件尚未建基线）的文件保守返回 no_change，避免误报为变更。
+     */
+    async computeBoundFileStatuses(memory) {
+        const result = [];
+        if (!memory.bound_files || memory.bound_files.length === 0)
+            return result;
+        const oldMd5Map = memory.file_md5_map || {};
+        for (const filePath of memory.bound_files) {
+            try {
+                const currentMd5 = await this.calculateFileMd5(filePath);
+                if (currentMd5 === null) {
+                    result.push({ path: filePath, status: 'not_found' });
+                    continue;
+                }
+                const oldMd5 = oldMd5Map[filePath];
+                if (!oldMd5) {
+                    result.push({ path: filePath, status: 'no_change' });
+                }
+                else if (oldMd5 !== currentMd5) {
+                    result.push({ path: filePath, status: 'content_changed' });
+                }
+                else {
+                    result.push({ path: filePath, status: 'no_change' });
+                }
+            }
+            catch {
+                // MD5 计算失败：保守视为未变更，不误报
+                result.push({ path: filePath, status: 'no_change' });
+            }
+        }
+        return result;
+    }
     /**
      * 检查一组 Memory 的文件变更
      * Memory 增强功能 (v1.6.0)
@@ -2293,6 +2371,7 @@ export class McpServer {
             }
             try {
                 const changedFiles = [];
+                const statuses = [];
                 const newMd5Map = {};
                 const oldMd5Map = memory.file_md5_map || {};
                 const workspacePath = process.env.AWS_WORKSPACE_PATH || process.cwd();
@@ -2309,7 +2388,8 @@ export class McpServer {
                             const oldMd5ForMissing = oldMd5Map[filePath];
                             if (oldMd5ForMissing) {
                                 // 该文件曾有基线，现在读不到 -> 视为变更（文件被删除/移动）
-                                changedFiles.push(`${filePath} (文件不存在或无法访问)`);
+                                statuses.push({ path: filePath, status: 'not_found' });
+                                changedFiles.push(`${filePath} (文件找不到)`);
                                 // 收口：文件已消失，从 bound_files 移除该路径，消除悬空引用。
                                 // 否则 listByFile/findByBoundFile 会持续命中无效记录，且文件恢复后因基线已清而变更检测失效。
                                 // bound_files 修剪结果由调用方在变更回写分支同步持久化（见 buildMemoryFileChangeNotification）。
@@ -2317,6 +2397,10 @@ export class McpServer {
                                     memory.bound_files = memory.bound_files.filter(f => f !== filePath);
                                 }
                             }
+                            else {
+                                // 无该文件基线且文件不存在：标注找不到但不计入变更，避免对未知状态误报
+                                statuses.push({ path: filePath, status: 'not_found' });
+                            }
                             // 无该文件基线时静默跳过，避免对未知状态误报
                             continue;
                         }
@@ -2327,20 +2411,29 @@ export class McpServer {
                             //   1) 新增到 bound_files 的文件尚未建基线；
                             //   2) 历史 TS/Java 路径规范化不一致（如 Windows 反斜杠）导致键不匹配。
                             // 静默建立基线，不视为变更，避免 md5 实际未变却误报需要更新。
+                            statuses.push({ path: filePath, status: 'no_change' });
                             baselineRepaired = true;
                             logger.info(`[McpServer] 建立单文件基线: ${filePath} new=${currentMd5} (workspace=${workspacePath}, memory=${memory.uri})`);
                         }
                         else if (oldMd5 !== currentMd5) {
                             logger.info(`[McpServer] 文件变更: ${filePath} old=${oldMd5} new=${currentMd5} (workspace=${workspacePath})`);
-                            changedFiles.push(filePath);
+                            statuses.push({ path: filePath, status: 'content_changed' });
+                            changedFiles.push(`${filePath} (内容变更)`);
+                        }
+                        else {
+                            statuses.push({ path: filePath, status: 'no_change' });
                         }
                     }
                     catch (error) {
                         logger.info(`[McpServer] 计算文件 MD5 失败: ${filePath}`, error);
                         const oldMd5ForError = oldMd5Map[filePath];
                         if (oldMd5ForError) {
+                            statuses.push({ path: filePath, status: 'content_changed' });
                             changedFiles.push(`${filePath} (MD5计算失败)`);
                         }
+                        else {
+                            statuses.push({ path: filePath, status: 'no_change' });
+                        }
                     }
                 }
                 // 无基线时：更新 MD5 map 到 memory 对象（供调用方回写），但不计入变更
@@ -2359,10 +2452,15 @@ export class McpServer {
                     changes.push({
                         memoryId: memory.id,
                         memoryUri: memory.uri,
+                        fileStatuses: statuses,
                         changedFiles,
                     });
-                    // 更新 MD5 映射
-                    memory.file_md5_map = newMd5Map;
+                    // ⚠️ 不要用 newMd5Map 覆盖 memory.file_md5_map！
+                    // 检测阶段只负责"发现变更并通知 agent"，MD5 基线必须保留为旧值，
+                    // 让调用方把旧基线回写到 DB。否则 agent 收到变更通知后，
+                    // 重算文件 MD5 与 DB 中已被覆盖的新基线一致，会误判"文件实际未变"。
+                    // 新基线只能由 agent 主动调用 update_memory 处理完变更后重建。
+                    // 仅更新检测时间戳，记录本次检查发生过。
                     memory.last_check_time = new Date().toISOString();
                 }
             }