aws-runtime-bridge 1.9.40 → 1.9.41

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

@@ -2,6 +2,31 @@ import { ACodeRuntime } from "./runtime.js";
 import type { ACodeRuntimeConfig } from "./types.js";
 import { SubAgentStore } from "./sub-agent-store.js";
 import type { SubAgentContextSnapshot, SubAgentEvent, SubAgentStatus, SubAgentType } from "./sub-agent-types.js";
+/**
+ * 子 agent 终态通知（供 poll_message race 使用）。
+ * 当子 agent 到达 completed/failed/cancelled 时入队，由 takeCompletedSubAgents 消费。
+ */
+export interface SubAgentCompletionNotification {
+    subId: string;
+    subagentType: SubAgentType;
+    description: string;
+    status: SubAgentStatus;
+    output: string;
+    error?: string;
+    durationMs?: number;
+}
+/**
+ * Sub-agent 完成一轮后由外部执行的重新检查回调。
+ * - 返回 { done: true } 表示目标已达成，sub-agent 可正常结束
+ * - 返回 { done: false, continueMessage } 表示未完成，将 continueMessage 作为下一轮 submit 注入同一 sub-agent
+ *
+ * 回调内可查询服务端真实状态（如 read_memory / get_memory_stats），
+ * 而非依赖 LLM 自报结果，提供系统级硬保证。
+ */
+export type SubAgentRecheckFn = (output: string, turn: number) => Promise<{
+    done: boolean;
+    continueMessage?: string;
+}>;
 /** spawn 选项 */
 export interface SubAgentSpawnOptions {
     parentAgentId: string;
@@ -12,6 +37,8 @@ export interface SubAgentSpawnOptions {
     workingDirectory: string;
     /** 父 agent 的 ACodeRuntimeConfig，子 agent 继承 model/prompt 等 */
     parentConfig: ACodeRuntimeConfig;
+    /** 静默完成：为 true 时子 agent 到达终态后不进入 completionQueue，不通过 poll_message 通知主 agent */
+    silent?: boolean;
 }
 /** 内存中的 sub-agent entry（含运行时实例） */
 export interface SubAgentEntry {
@@ -30,17 +57,23 @@ export interface SubAgentEntry {
     runtime: ACodeRuntime;
     abortController: AbortController;
     contextSnapshot: SubAgentContextSnapshot;
+    /** 该 sub-agent 创建时可用的工具列表（exposedName） */
+    availableTools: string[];
     /** 运行完成后的 Promise resolve/reject（供 awaitCompletion 等待） */
     completionResolve?: (result: {
         output: string;
         error?: string;
     }) => void;
-    completionReject?: (err: Error) => void;
+    completionReject?: (err: any) => void;
     /** 运行完成 Promise（start 时创建，终态时 settle） */
     completionPromise?: Promise<{
         output: string;
         error?: string;
     }>;
+    /** 静默完成：为 true 时不进入 completionQueue，不通过 poll_message 通知主 agent */
+    silent?: boolean;
+    /** 已通过 awaitCompletion 消费：为 true 时不进入 completionQueue，避免 poll_message 重复返回 */
+    awaited?: boolean;
 }
 /** SubAgentManager 构造配置 */
 export interface SubAgentManagerOptions {
@@ -82,6 +115,16 @@ export declare class SubAgentManager {
     private readonly subscribers;
     /** 已完成 entry 的清理定时器 */
     private cleanupTimer;
+    /**
+     * 终态通知队列：子 agent 到达终态时入队，takeCompletedSubAgents 消费。
+     * 供 poll_message 在 ACode 运行时层检测子 agent 完成事件。
+     */
+    private readonly completionQueue;
+    /**
+     * waitForAnyCompletion 的 resolve 回调，终态事件到达时调用。
+     * null 表示当前没有等待者。
+     */
+    private completionWaiterResolve;
     constructor(opts: SubAgentManagerOptions);
     /** 创建 sub-agent（不立即运行；调 start 才执行） */
     spawn(opts: SubAgentSpawnOptions): Promise<string>;
@@ -94,6 +137,17 @@ export declare class SubAgentManager {
      * 同一 sub-agent 只能 start 一次；重复 start 抛错。
      */
     start(subId: string): Promise<void>;
+    /**
+     * 带 recheck 循环的异步启动（不阻塞，立即返回）。
+     *
+     * 与 start 的区别：每轮 submit 完成后调用 recheck 回调查询服务端真实状态。
+     * 若 recheck 返回 { done: false, continueMessage }，将 continueMessage 作为
+     * 下一轮 submit 注入同一 sub-agent（保持上下文连续性），最多重试 maxRetries 次。
+     *
+     * 适用场景：memory 过期整理 / 文件变更更新 / 容量整理等需要系统级硬保证
+     * "确实完成"的场景，不依赖 LLM 自报结果。
+     */
+    startWithRecheck(subId: string, recheck: SubAgentRecheckFn, maxRetries?: number): Promise<void>;
     /**
      * 阻塞等待指定 sub-agent 数组全部完成（completed/failed/cancelled）。
      *
@@ -124,6 +178,19 @@ export declare class SubAgentManager {
      *   - **不删除 entry**（保留在内存供 list/get_status 查询，30min 后由定时器清理）
      */
     private runEntryToCompletion;
+    /**
+     * 带 recheck 循环的 entry 执行（多轮 submit）。
+     *
+     * 与 runEntryToCompletion 的区别：
+     *   1. 第一轮 submit(entry.prompt) 完成后，调用 recheck 回调查询服务端真实状态
+     *   2. 若 recheck 返回 { done: false, continueMessage }，将 continueMessage 注入下一轮 submit
+     *   3. 最多重试 maxRetries 次；超过后视为完成（不再继续）
+     *   4. onEvent 监听器跨所有轮次累积 assistant_delta，最终 output 包含全部轮次的文本
+     *
+     * turnFailed 标志在每轮 submit 前重置，确保上一轮的失败状态不影响下一轮判断。
+     * recheck 自身抛错时视为 done（不阻塞 sub-agent 结束），仅记录日志。
+     */
+    private runEntryToCompletionWithRecheck;
     /**
      * @deprecated 兼容旧接口：spawn + 阻塞等待完成。
      * 新代码应使用 spawn + start + awaitCompletion。
@@ -145,10 +212,38 @@ export declare class SubAgentManager {
      * "进行中" 列表。前端 "进行中" tab 与 SSE snapshot 都应使用此方法。
      */
     listActiveByParent(parentAgentId: string): SubAgentEntry[];
+    /**
+     * 取走并清空终态通知队列。
+     *
+     * 主流程：返回 completionQueue 中的所有通知并清空队列。
+     * 供 ACode 运行时在 poll_message 调用前后检查子 agent 是否已完成。
+     * 每次 poll_message 调用前先调此方法，若有已完成子 agent 则直接返回，无需等待 MCP。
+     */
+    takeCompletedSubAgents(): SubAgentCompletionNotification[];
+    /**
+     * 等待任意子 agent 到达终态（completed/failed/cancelled）。
+     *
+     * 主流程：如果 completionQueue 中已有通知，立即 resolve；
+     * 否则注册一个 resolve 回调，在下次子 agent 终态事件到达时触发。
+     * 供 ACode 运行时在 poll_message 期间 race 子 agent 完成事件。
+     *
+     * 返回 { promise, cancel }：
+     * - promise: 子 agent 终态时 resolve
+     * - cancel: 取消等待（poll_message 先返回时调用，清理 resolve 回调）
+     */
+    waitForAnyCompletion(): {
+        promise: Promise<SubAgentCompletionNotification>;
+        cancel: () => void;
+    };
     /** 订阅 sub-agent 事件（subId 或 "*" 全局） */
     subscribe(subId: string, cb: EventSubscriber): () => void;
     /** 清理所有运行中的 sub-agent（bridge 关闭时调用） */
     dispose(): Promise<void>;
+    /**
+     * 将子 agent 终态事件入队并通知等待者。
+     * 主流程：构建通知对象 -> 入队 completionQueue -> 若有 waitForAnyCompletion 等待者则立即 resolve。
+     */
+    private enqueueCompletion;
     private countByStatus;
     private addToParentMap;
     private removeFromParentMap;

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

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

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

@@ -34,6 +34,16 @@ export class SubAgentManager {
         this.subscribers = new Map(); // subId 或 "*" -> subs
         /** 已完成 entry 的清理定时器 */
         this.cleanupTimer = null;
+        /**
+         * 终态通知队列：子 agent 到达终态时入队，takeCompletedSubAgents 消费。
+         * 供 poll_message 在 ACode 运行时层检测子 agent 完成事件。
+         */
+        this.completionQueue = [];
+        /**
+         * waitForAnyCompletion 的 resolve 回调，终态事件到达时调用。
+         * null 表示当前没有等待者。
+         */
+        this.completionWaiterResolve = null;
         this.store = opts.store;
         this.maxConcurrent = opts.maxConcurrent ?? 5;
         // 启动定期清理已完成 entry 的定时器（每 5 分钟扫一次）
@@ -53,6 +63,7 @@ export class SubAgentManager {
         const startedAt = Date.now();
         const abortController = new AbortController();
         // 构造子 agent 的 config（继承父 agent 的 model/prompt，但独立 sessionId）
+        // 若父 agent 配置了 subAgentModel/subAgentEffort，则覆盖子 agent 的 model/effort
         const childConfig = {
             ...opts.parentConfig,
             sessionId: subId,
@@ -60,6 +71,18 @@ export class SubAgentManager {
             agentId: `${opts.parentAgentId}__sub__${subId}`,
             // sub-agent 不继承 initialPrompt（用 submit 触发）
             initialPrompt: undefined,
+            // sub-agent 不允许再 spawn 自己的子 agent（禁止递归嵌套）
+            subAgentManager: undefined,
+            // Sub Agent 模型/强度覆盖：有值则覆盖继承的 model/effort
+            ...(opts.parentConfig.subAgentModel
+                ? { model: opts.parentConfig.subAgentModel }
+                : {}),
+            ...(opts.parentConfig.subAgentEffort
+                ? { effort: opts.parentConfig.subAgentEffort }
+                : {}),
+            // 子 agent 不再继承 subAgent 专用覆盖字段（防止孙 agent 二次覆盖）
+            subAgentModel: undefined,
+            subAgentEffort: undefined,
         };
         const runtime = new ACodeRuntime(childConfig);
         const entry = {
@@ -73,11 +96,13 @@ export class SubAgentManager {
             startedAt,
             runtime,
             abortController,
+            silent: opts.silent,
             contextSnapshot: {
                 tokenUsage: { input: 0, output: 0 },
                 messageCount: 0,
                 updatedAt: new Date().toISOString(),
             },
+            availableTools: [],
         };
         this.subAgents.set(subId, entry);
         this.addToParentMap(opts.parentAgentId, subId);
@@ -118,6 +143,34 @@ export class SubAgentManager {
             // 这里捕获防止 unhandled rejection
         });
     }
+    /**
+     * 带 recheck 循环的异步启动（不阻塞，立即返回）。
+     *
+     * 与 start 的区别：每轮 submit 完成后调用 recheck 回调查询服务端真实状态。
+     * 若 recheck 返回 { done: false, continueMessage }，将 continueMessage 作为
+     * 下一轮 submit 注入同一 sub-agent（保持上下文连续性），最多重试 maxRetries 次。
+     *
+     * 适用场景：memory 过期整理 / 文件变更更新 / 容量整理等需要系统级硬保证
+     * "确实完成"的场景，不依赖 LLM 自报结果。
+     */
+    async startWithRecheck(subId, recheck, maxRetries = 3) {
+        const entry = this.subAgents.get(subId);
+        if (!entry) {
+            throw new Error(`sub-agent not found: ${subId}`);
+        }
+        if (entry.status !== "pending") {
+            throw new Error(`sub-agent ${subId} cannot start from status: ${entry.status}`);
+        }
+        // 创建 completionPromise（在 finally 中 settle）
+        entry.completionPromise = new Promise((resolve, reject) => {
+            entry.completionResolve = resolve;
+            entry.completionReject = reject;
+        });
+        // 异步启动，不阻塞调用方
+        void this.runEntryToCompletionWithRecheck(entry, recheck, maxRetries).catch(() => {
+            // 内部已处理异常并更新状态；这里捕获防止 unhandled rejection
+        });
+    }
     /**
      * 阻塞等待指定 sub-agent 数组全部完成（completed/failed/cancelled）。
      *
@@ -155,6 +208,9 @@ export class SubAgentManager {
                 }
                 return;
             }
+            // 标记为 awaited：防止 enqueueCompletion 将终态通知推入 completionQueue
+            // （避免后续 poll_message 重复返回已被 await 消费的结果）
+            entry.awaited = true;
             // 如果还在 pending，自动 start
             if (entry.status === "pending") {
                 await this.start(subId);
@@ -179,6 +235,14 @@ export class SubAgentManager {
                 });
             }
         });
+        // 等待全部完成后，清理 completionQueue 中可能已存在的这些 subId 的通知
+        // （处理子 agent 在 awaited 标记设置前已完成入队的情况）
+        const subIdSet = new Set(subIds);
+        for (let i = this.completionQueue.length - 1; i >= 0; i--) {
+            if (subIdSet.has(this.completionQueue[i].subId)) {
+                this.completionQueue.splice(i, 1);
+            }
+        }
         if (timeoutMs > 0) {
             await Promise.race([
                 Promise.allSettled(waitPromises),
@@ -237,6 +301,8 @@ export class SubAgentManager {
         this.emitEvent(entry.subId, "running", {});
         try {
             await entry.runtime.start();
+            // 记录启动后的可用工具列表
+            entry.availableTools = entry.runtime.getAvailableTools();
             await entry.runtime.submit(entry.prompt);
             // 实际 API 中 submit 解析后所有事件已同步触发完毕（EventEmitter.emit 是同步的）
             // 若 turn_complete 标记 failed，抛错走 catch
@@ -257,6 +323,7 @@ export class SubAgentManager {
             });
             this.emitEvent(entry.subId, "completed", { result: output });
             entry.completionResolve?.({ output });
+            this.enqueueCompletion(entry, output, undefined);
         }
         catch (err) {
             const errorMessage = err instanceof Error ? err.message : String(err);
@@ -273,6 +340,139 @@ export class SubAgentManager {
             });
             this.emitEvent(entry.subId, "failed", { error: errorMessage });
             entry.completionResolve?.({ output: "", error: errorMessage });
+            this.enqueueCompletion(entry, "", errorMessage);
+        }
+        finally {
+            // 移除临时监听器
+            try {
+                entry.runtime.removeListener?.("event", onEvent);
+            }
+            catch {
+                /* 忽略移除失败 */
+            }
+            // 完成后清理 runtime 实例（释放内存），但保留 entry 供查询
+            try {
+                await entry.runtime.stop();
+            }
+            catch {
+                /* 忽略 stop 失败 */
+            }
+        }
+    }
+    /**
+     * 带 recheck 循环的 entry 执行（多轮 submit）。
+     *
+     * 与 runEntryToCompletion 的区别：
+     *   1. 第一轮 submit(entry.prompt) 完成后，调用 recheck 回调查询服务端真实状态
+     *   2. 若 recheck 返回 { done: false, continueMessage }，将 continueMessage 注入下一轮 submit
+     *   3. 最多重试 maxRetries 次；超过后视为完成（不再继续）
+     *   4. onEvent 监听器跨所有轮次累积 assistant_delta，最终 output 包含全部轮次的文本
+     *
+     * turnFailed 标志在每轮 submit 前重置，确保上一轮的失败状态不影响下一轮判断。
+     * recheck 自身抛错时视为 done（不阻塞 sub-agent 结束），仅记录日志。
+     */
+    async runEntryToCompletionWithRecheck(entry, recheck, maxRetries) {
+        const chunks = [];
+        let turnFailed = false;
+        let turnErrorMessage;
+        const onEvent = (event) => {
+            if (!event)
+                return;
+            switch (event.type) {
+                case "assistant_delta":
+                    if (typeof event.data?.text === "string") {
+                        chunks.push(event.data.text);
+                    }
+                    break;
+                case "turn_complete":
+                    if (event.data?.failed) {
+                        turnFailed = true;
+                    }
+                    break;
+                case "error":
+                    if (typeof event.data?.message === "string") {
+                        turnErrorMessage = event.data.message;
+                    }
+                    break;
+            }
+        };
+        entry.runtime.on("event", onEvent);
+        // 状态 -> running
+        entry.status = "running";
+        await this.store.updateStatus(entry.parentAgentId, entry.subId, { status: "running" });
+        this.emitEvent(entry.subId, "running", {});
+        try {
+            await entry.runtime.start();
+            entry.availableTools = entry.runtime.getAvailableTools();
+            // 第一轮：使用初始 prompt
+            await entry.runtime.submit(entry.prompt);
+            if (turnFailed) {
+                throw new Error(turnErrorMessage ?? "sub-agent turn failed");
+            }
+            let turn = 1;
+            // recheck 循环：最多 maxRetries 次
+            while (turn <= maxRetries) {
+                let recheckResult;
+                try {
+                    recheckResult = await recheck(chunks.join(""), turn);
+                }
+                catch (recheckErr) {
+                    // recheck 自身出错：不阻塞 sub-agent 结束，视为完成
+                    console.error(`[SubAgentManager] recheck threw error for subId=${entry.subId} turn=${turn}, treating as done:`, recheckErr instanceof Error ? recheckErr.message : String(recheckErr));
+                    break;
+                }
+                if (recheckResult.done) {
+                    break;
+                }
+                // 未完成：注入 continueMessage 进行下一轮
+                const continueMessage = recheckResult.continueMessage ?? "经检查，未完成处理，请继续。";
+                // 重置 turn 失败标记，确保本轮失败状态不影响下一轮判断
+                turnFailed = false;
+                turnErrorMessage = undefined;
+                console.error(`[SubAgentManager] recheck not done for subId=${entry.subId} turn=${turn}/${maxRetries}, ` +
+                    `injecting continue message (${continueMessage.length} chars)`);
+                await entry.runtime.submit(continueMessage);
+                if (turnFailed) {
+                    throw new Error(turnErrorMessage ?? `sub-agent turn ${turn + 1} failed during recheck continuation`);
+                }
+                turn++;
+            }
+            if (turn > maxRetries) {
+                console.error(`[SubAgentManager] recheck reached maxRetries=${maxRetries} for subId=${entry.subId}, ` +
+                    `completing with potentially unfinished work`);
+            }
+            const output = chunks.join("");
+            entry.status = "completed";
+            entry.result = output;
+            entry.endedAt = Date.now();
+            entry.durationMs = entry.endedAt - entry.startedAt;
+            await this.store.updateStatus(entry.parentAgentId, entry.subId, {
+                status: "completed",
+                result: output,
+                endedAt: entry.endedAt,
+                durationMs: entry.durationMs,
+                contextSnapshot: undefined,
+            });
+            this.emitEvent(entry.subId, "completed", { result: output });
+            entry.completionResolve?.({ output });
+            this.enqueueCompletion(entry, output, undefined);
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            entry.status = "failed";
+            entry.errorMessage = errorMessage;
+            entry.endedAt = Date.now();
+            entry.durationMs = entry.endedAt - entry.startedAt;
+            await this.store.updateStatus(entry.parentAgentId, entry.subId, {
+                status: "failed",
+                errorMessage,
+                endedAt: entry.endedAt,
+                durationMs: entry.durationMs,
+                contextSnapshot: undefined,
+            });
+            this.emitEvent(entry.subId, "failed", { error: errorMessage });
+            entry.completionResolve?.({ output: "", error: errorMessage });
+            this.enqueueCompletion(entry, "", errorMessage);
         }
         finally {
             // 移除临时监听器
@@ -337,6 +537,7 @@ export class SubAgentManager {
         this.emitEvent(subId, "cancelled", {});
         // settle completionPromise（cancelled 视为 error）
         entry.completionResolve?.({ output: "", error: "aborted" });
+        this.enqueueCompletion(entry, "", "aborted");
     }
     /** 获取内存中的 entry */
     getSubAgent(subId) {
@@ -360,6 +561,52 @@ export class SubAgentManager {
     listActiveByParent(parentAgentId) {
         return this.listByParent(parentAgentId).filter((e) => e.status === "pending" || e.status === "running");
     }
+    /**
+     * 取走并清空终态通知队列。
+     *
+     * 主流程：返回 completionQueue 中的所有通知并清空队列。
+     * 供 ACode 运行时在 poll_message 调用前后检查子 agent 是否已完成。
+     * 每次 poll_message 调用前先调此方法，若有已完成子 agent 则直接返回，无需等待 MCP。
+     */
+    takeCompletedSubAgents() {
+        if (this.completionQueue.length === 0)
+            return [];
+        const drained = this.completionQueue.splice(0);
+        return drained;
+    }
+    /**
+     * 等待任意子 agent 到达终态（completed/failed/cancelled）。
+     *
+     * 主流程：如果 completionQueue 中已有通知，立即 resolve；
+     * 否则注册一个 resolve 回调，在下次子 agent 终态事件到达时触发。
+     * 供 ACode 运行时在 poll_message 期间 race 子 agent 完成事件。
+     *
+     * 返回 { promise, cancel }：
+     * - promise: 子 agent 终态时 resolve
+     * - cancel: 取消等待（poll_message 先返回时调用，清理 resolve 回调）
+     */
+    waitForAnyCompletion() {
+        // 如果队列中已有通知，立即返回
+        if (this.completionQueue.length > 0) {
+            const notif = this.completionQueue.shift();
+            return {
+                promise: Promise.resolve(notif),
+                cancel: () => { },
+            };
+        }
+        let cancelled = false;
+        const promise = new Promise((resolve) => {
+            this.completionWaiterResolve = (notif) => {
+                if (!cancelled)
+                    resolve(notif);
+            };
+        });
+        const cancel = () => {
+            cancelled = true;
+            this.completionWaiterResolve = null;
+        };
+        return { promise, cancel };
+    }
     /** 订阅 sub-agent 事件（subId 或 "*" 全局） */
     subscribe(subId, cb) {
         let set = this.subscribers.get(subId);
@@ -387,6 +634,34 @@ export class SubAgentManager {
         this.subscribers.clear();
     }
     // ---------- 内部方法 ----------
+    /**
+     * 将子 agent 终态事件入队并通知等待者。
+     * 主流程：构建通知对象 -> 入队 completionQueue -> 若有 waitForAnyCompletion 等待者则立即 resolve。
+     */
+    enqueueCompletion(entry, output, error) {
+        // 静默完成或已被 awaitCompletion 消费的子 agent 不进入 completionQueue
+        if (entry.silent || entry.awaited) {
+            return;
+        }
+        const notif = {
+            subId: entry.subId,
+            subagentType: entry.subagentType,
+            description: entry.description,
+            status: entry.status,
+            output,
+            error,
+            durationMs: entry.durationMs,
+        };
+        this.completionQueue.push(notif);
+        // 如果有 poll_message 正在等待子 agent 完成事件，立即通知
+        if (this.completionWaiterResolve) {
+            const resolve = this.completionWaiterResolve;
+            this.completionWaiterResolve = null;
+            // 从队列中取出刚入队的通知（即此条）
+            const queued = this.completionQueue.pop();
+            resolve(queued ?? notif);
+        }
+    }
     countByStatus(parentAgentId, ...statuses) {
         return this.listByParent(parentAgentId).filter((e) => statuses.includes(e.status)).length;
     }
@@ -459,7 +734,8 @@ export class SubAgentManager {
                 }
                 break;
             case "assistant_delta":
-                snapshot.lastAssistantText = (event.data?.text ?? "").slice(-500);
+                // 累积文本，截断到最近 500 字符
+                snapshot.lastAssistantText = ((snapshot.lastAssistantText ?? "") + (event.data?.text ?? "")).slice(-500);
                 snapshot.messageCount += 1;
                 this.emitEvent(subId, "delta", { text: event.data?.text });
                 break;
@@ -467,10 +743,10 @@ export class SubAgentManager {
                 // runtime 发射的 mcp_status 使用 action 字段（而非 phase）
                 if (event.data?.action === "call_tool") {
                     snapshot.currentTool = event.data?.tool;
-                    this.emitEvent(subId, "tool_start", { tool: snapshot.currentTool });
+                    this.emitEvent(subId, "tool_start", { tool: snapshot.currentTool, snapshot: { ...snapshot } });
                 }
                 else if (event.data?.action === "tool_result") {
-                    this.emitEvent(subId, "tool_end", { tool: snapshot.currentTool });
+                    this.emitEvent(subId, "tool_end", { tool: snapshot.currentTool, snapshot: { ...snapshot } });
                     snapshot.currentTool = undefined;
                 }
                 break;
@@ -510,6 +786,19 @@ export class SubAgentManager {
                 }
             }
         }
+        // tool_start / tool_end 异步落盘（fire-and-forget，不阻塞事件发射）
+        if (type === "tool_start" || type === "tool_end") {
+            const entry = this.subAgents.get(subId);
+            if (entry) {
+                console.error(`[SubAgentManager] appendEvent: subId=${subId} type=${type} tool=${data.tool ?? "?"} parentAgentId=${entry.parentAgentId}`);
+                void this.store.appendEvent(entry.parentAgentId, subId, event).catch((err) => {
+                    console.error(`[SubAgentManager] appendEvent FAILED: subId=${subId} error=${err instanceof Error ? err.message : String(err)}`);
+                });
+            }
+            else {
+                console.error(`[SubAgentManager] appendEvent SKIPPED (entry not found): subId=${subId} type=${type}`);
+            }
+        }
     }
     toRecord(entry) {
         return {
@@ -526,6 +815,7 @@ export class SubAgentManager {
             endedAt: entry.endedAt,
             durationMs: entry.durationMs,
             contextSnapshot: entry.status === "running" ? entry.contextSnapshot : undefined,
+            availableTools: entry.availableTools,
         };
     }
     /** 获取当前上下文快照（供 HTTP 路由调用） */

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

@@ -1,4 +1,4 @@
-import type { SubAgentDocument, SubAgentRecord } from "./sub-agent-types.js";
+import type { SubAgentDocument, SubAgentEvent, SubAgentRecord } from "./sub-agent-types.js";
 /**
  * Sub Agent JSON 文件存储，按 agentId 隔离。
  * 文件路径：{homedir}/.acode/sub-agents/{agentId}.json
@@ -29,5 +29,12 @@ 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 持久化） */
+    appendEvent(agentId: string, subId: string, event: SubAgentEvent): Promise<void>;
+    /**
+     * 扫描所有 agent 文件，把 status="running"/"pending" 的记录修正为 "failed"。
+     * 在 bridge 启动时调用，清理上次进程异常退出留下的僵尸记录。
+     */
+    reconcileZombies(): Promise<number>;
 }
 //# sourceMappingURL=sub-agent-store.d.ts.map

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,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE7E;;;;;;;;;;;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;CAGvD"}
+{"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"}