aws-runtime-bridge 1.9.92 → 1.9.94

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

@@ -2,10 +2,7 @@ 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;
@@ -15,19 +12,12 @@ export interface SubAgentCompletionNotification {
     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;
     parentSessionId: string;
@@ -35,12 +25,12 @@ export interface SubAgentSpawnOptions {
     description: string;
     prompt: string;
     workingDirectory: string;
-    /** 父 agent 的 ACodeRuntimeConfig，子 agent 继承 model/prompt 等 */
+    
     parentConfig: ACodeRuntimeConfig;
-    /** 静默完成：为 true 时子 agent 到达终态后不进入 completionQueue，不通过 poll_message 通知主 agent */
+    
     silent?: boolean;
 }
-/** 内存中的 sub-agent entry（含运行时实例） */
+
 export interface SubAgentEntry {
     subId: string;
     parentAgentId: string;
@@ -57,264 +47,109 @@ 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: 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 {
     store: SubAgentStore;
-    /** 并发上限，默认 5 */
+    
     maxConcurrent?: number;
 }
 type EventSubscriber = (event: SubAgentEvent) => void;
-/**
- * SubAgentManager：管理独立 ACodeRuntime 实例池。
- *
- * 核心职责：
- *   1. spawn 创建独立 ACodeRuntime 实例（避免父 agent 的 submitQueue 死锁）
- *   2. start 异步启动子 agent（不阻塞），awaitCompletion 显式等待完成
- *   3. abort 取消运行中的 sub-agent
- *   4. 维护父子关系映射（parentAgentId -> subIds）
- *   5. SSE 事件订阅（subscribe/unsubscribe）
- *   6. 状态持久化到 SubAgentStore
- *
- * 线程模型：单进程 Node.js，所有 ACodeRuntime 实例共享事件循环。
- *   非阻塞模式：spawn 后调 start 立即返回，主 agent 可继续工作；
- *   主 agent 通过 awaitCompletion 显式阻塞等待指定 sub-agent 数组完成。
- *
- * 重要：ACodeRuntime.submit() 返回 Promise<void>，assistant 文本通过
- *   "event" 上的 "assistant_delta" 事件传递，turn 结束时发出 "turn_complete"。
- *   因此 start 内部注册事件监听器累积输出文本，awaitCompletion 通过 Promise 等待。
- *
- * Entry 生命周期：
- *   - pending: spawn 后未 start
- *   - running: start 后运行中
- *   - completed/failed/cancelled: 终态，entry 保留在内存中 TTL=30min，
- *     供 list/get_status 查询；超时后从内存清理（store 仍持久化）
- */
+
 export declare class SubAgentManager {
     private readonly store;
     private readonly maxConcurrent;
     private readonly subAgents;
     private readonly parentToSubs;
     private readonly subscribers;
-    /** 已完成 entry 的清理定时器 */
+    
     private cleanupTimer;
-    /**
-     * 终态通知队列：子 agent 到达终态时入队，takeCompletedSubAgents 消费。
-     * 供 poll_message 在 ACode 运行时层检测子 agent 完成事件。
-     */
+    
     private readonly completionQueue;
-    /**
-     * waitForAnyCompletion 的 resolve 回调，终态事件到达时调用。
-     * null 表示当前没有等待者。
-     */
+    
     private completionWaiterResolve;
-    /**
-     * 正在执行的异步终态落盘 Promise 集合。
-     *
-     * 用于：
-     *   - 测试等待异步落盘完成后再读取 store 验证状态
-     *   - dispose 时确保所有落盘完成后再清理（避免文件句柄占用导致目录非空）
-     *
-     * persistFinalStatus 启动时入集，resolve/reject 后出集。
-     */
+    
     private readonly pendingPersists;
     constructor(opts: SubAgentManagerOptions);
-    /** 创建 sub-agent（不立即运行；调 start 才执行） */
+    
     spawn(opts: SubAgentSpawnOptions): Promise<string>;
-    /**
-     * 异步启动 sub-agent（不阻塞，立即返回）。
-     *
-     * 内部创建 completionPromise 供后续 awaitCompletion 等待。
-     * 启动后立即返回，主 agent 可继续做其他事。
-     *
-     * 同一 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）。
-     *
-     * - 已完成的立即 resolve
-     * - 未 start 的会先 start（自动启动）
-     * - 返回每个 sub-agent 的最终结果
-     *
-     * 注意：本方法不取消 sub-agent，仅等待。如需取消用 abort。
-     */
+    
     awaitCompletion(subIds: string[], timeoutMs?: number): Promise<Array<{
         subId: string;
         output: string;
         error?: string;
         status: SubAgentStatus;
     }>>;
-    /**
-     * 内部方法：执行 entry 直到完成。
-     *
-     * 实际 ACodeRuntime.submit() 返回 Promise<void>，assistant 文本通过
-     * assistant_delta 事件传递。本方法注册临时监听器累积输出文本，
-     * 同时检测 turn_complete 事件中的 failed 标志以处理运行时内部错误。
-     *
-     * 完成后：
-     *   - 更新 entry 状态（completed/failed）
-     *   - 持久化到 store
-     *   - settle completionPromise
-     *   - 清理 runtime 实例（释放内存）
-     *   - **不删除 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。
-     */
+    
     runToCompletion(subId: string): Promise<{
         output: string;
         error?: string;
     }>;
-    /** 取消运行中的 sub-agent */
+    
     abort(subId: string): Promise<void>;
-    /** 获取内存中的 entry */
+    
     getSubAgent(subId: string): SubAgentEntry | undefined;
-    /** 列出某 agent 的全部内存中 sub-agent（含运行中和已完成未清理） */
+    
     listByParent(parentAgentId: string): SubAgentEntry[];
-    /**
-     * 列出某父 agent 下处于活跃状态（pending / running）且对用户可见的 sub-agent。
-     *
-     * 已完成/失败/取消的 entry 在内存中仍保留 TTL=30min 供查询，但不应计入
-     * "进行中" 列表。前端 "进行中" tab 与 SSE snapshot 都应使用此方法。
-     *
-     * silent 子 agent（如 memory 自动整理的后台 explore 子代理）属于系统级后台任务，
-     * 不应展示给用户，否则会导致 tag 数量多于用户实际可见的子 agent，故此处一并过滤，
-     * 与 enqueueCompletion 对 silent 的语义保持一致。并发计数 countByParent 不受影响，
-     * 仍会统计 silent 子 agent 占用的并发槽位。
-     */
+    
     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>;
-    /**
-     * 异步落盘终态记录（指数退避重试），不阻塞主流程。
-     *
-     * 设计要点：
-     *   - 内存态已是终态（completed/failed/cancelled），落盘只做历史归档
-     *   - 落盘失败不回滚内存态，前端看到的是真实终态
-     *   - 重试覆盖瞬时错误：Windows fs.rename EPERM、writeChain 拥堵、磁盘瞬时不可用
-     *   - 全部重试失败后仅打日志，下次 bridge 启动时 reconcileZombies 会清理残留
-     *
-     * 调用方约定：必须用 `void this.persistFinalStatus(...)` 触发，不 await。
-     * entry.completionResolve 与 enqueueCompletion 应在此调用之前完成，
-     * 保证主流程不被落盘 IO 阻塞。
-     *
-     * Promise 加入 pendingPersists 集合，供 flushPendingPersists / dispose 等待。
-     */
+    
     private persistFinalStatus;
-    /**
-     * 等待所有正在执行的异步终态落盘完成。
-     *
-     * 主要用途：
-     *   - 测试在终态后读取 store 前调用，确保落盘已完成
-     *   - dispose 前调用，避免文件句柄占用导致目录清理失败
-     *
-     * 生产环境一般不需要调用——落盘失败不影响内存态正确性。
-     */
+    
     flushPendingPersists(): Promise<void>;
-    /**
-     * 将子 agent 终态事件入队并通知等待者。
-     * 主流程：构建通知对象 -> 入队 completionQueue -> 若有 waitForAnyCompletion 等待者则立即 resolve。
-     */
+    
     private enqueueCompletion;
     private countByStatus;
     private addToParentMap;
     private removeFromParentMap;
-    /**
-     * 清理已超过 TTL 的终态 entry（completed/failed/cancelled）。
-     * 释放内存，store 仍保留历史记录供查询。
-     */
+    
     private cleanupCompletedEntries;
-    /**
-     * 存活期僵尸回收：扫描卡在 pending / running 过久的子 agent 并标记为 failed。
-     *
-     * 背景：runEntryToCompletion* 会在启动后数秒内把状态翻成 running；若长时间保持
-     * pending，说明 startWithRecheck 抛错被调用方静默吞掉、或启动函数从未真正执行，
-     * 子 agent 成了孤儿却仍占着 runtime.pendingMemorySubAgents 的 URI 锁，导致该
-     * memory 的文件变更通知被永久抑制、永不重试（reconcileZombies 仅在 bridge 启动时跑）。
-     * running 卡死则多因 runtime.start()/submit() 挂起。
-     *
-     * 回收时复用与正常终态一致的处理（store 落盘 failed + emit failed 事件 +
-     * 释放 completion + 停 runtime）。runtime 订阅了 failed 事件，会据此清除
-     * pendingMemorySubAgents 中的 URI 并进入冷却，从而解除死锁、允许下次重新委托。
-     */
+    
     private recoverZombieEntries;
-    /** 将孤儿/卡死子 agent 标记为 failed 并走正常终态流程（不依赖 LLM 自报） */
+    
     private recoverZombie;
-    /** 从 store 中查找记录（entry 已从内存清理时使用） */
+    
     private findRecordInStore;
     private handleRuntimeEvent;
     private emitEvent;
     private toRecord;
-    /** 获取当前上下文快照（供 HTTP 路由调用） */
+    
     getContextSnapshot(subId: string): SubAgentContextSnapshot | undefined;
 }
 export {};

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

@@ -1,78 +1,29 @@
 import type { SubAgentDocument, SubAgentEvent, SubAgentRecord } from "./sub-agent-types.js";
-/**
- * Sub Agent JSON 文件存储，按 agentId 隔离。
- *
- * 文件布局：
- *   - 主记录文件：{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 原子替换
- *     （rename 在 Windows 上目标被打开时会 EPERM，使用 renameWithRetry 退避重试，
- *      重试仍失败时 fallback 到 copyFile + unlink，彻底规避 EPERM 持续场景）
- *   - events 走独立文件，避免 tool_start/tool_end 高频落盘阻塞终态 updateStatus
- *     （历史教训：events 与 updateStatus 共用 writeChain 时，memory delegate
- *      一次跑数十个工具调用，appendEvent 排队导致 updateStatus 超 5s 超时，
- *      内存已翻终态但 store 仍 running，触发 "status mismatch" 兜底误报）
- *
- * ★ 终态一致性架构（治本方案）：
- *   - 内存态（SubAgentManager）是运行态的唯一真相源
- *   - 终态写入通过 persistFinalStatus 异步重试落盘，不阻塞 completionResolve
- *   - 落盘失败不回滚内存态，前端看到的是真实终态
- *   - 列表接口不再做"磁盘 running/pending + 内存无 → 改写 failed"的兜底
- *     （该兜底是 "status mismatch" 误报的直接来源，已移除）
- *   - bridge 启动时 reconcileZombies 一次性清理上次进程残留的僵尸记录
- *
- * 历史保留策略：全部 sub-agent 记录都持久化（含 completed/failed/cancelled），
- *   按 startedAt 倒序排列。dashboard 按需分页读取。
- */
+
 export declare class SubAgentStore {
     private readonly dir;
     private writeChain;
     constructor();
-    /** 主记录文件路径（按 agentId 隔离，防路径穿越） */
+    
     private filePath;
-    /** 事件日志文件路径（按 agentId + subId 隔离，防路径穿越） */
+    
     private eventsFilePath;
-    /** 读取该 agentId 的完整文档。文件不存在或损坏时返回空文档。 */
+    
     read(agentId: string): Promise<SubAgentDocument>;
-    /** 读取单个 sub-agent 记录 */
+    
     get(agentId: string, subId: string): Promise<SubAgentRecord | null>;
-    /** 全量替换该 agentId 的文档。串行化以避免并发覆盖。 */
+    
     write(agentId: string, subAgents: SubAgentRecord[]): Promise<void>;
-    /** 插入或更新单条记录（保留其他记录） */
+    
     upsert(agentId: string, record: SubAgentRecord): Promise<void>;
-    /** 部分更新单条记录 */
+    
     updateStatus(agentId: string, subId: string, patch: Partial<SubAgentRecord>): Promise<void>;
-    /** 列出该 agent 的全部 sub-agent（已按 startedAt 倒序） */
+    
     list(agentId: string): Promise<SubAgentRecord[]>;
-    /**
-     * 追加一条事件到指定 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 启动时调用，清理上次进程异常退出留下的僵尸记录。
-     */
+    
     reconcileZombies(): Promise<number>;
 }

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

@@ -1,17 +1,8 @@
 import type { ACodeBuiltInTool } from "./built-in-file-tools.js";
 import type { SubAgentType, SubAgentStatus } from "./sub-agent-types.js";
-/**
- * Sub-agent 工具集依赖（由 runtime.ts 注入 SubAgentManager 句柄）。
- *
- * 工具集包含 5 个工具：
- *   1. sub_agent: 非阻塞 spawn 子 agent，立即返回 subId
- *   2. list_sub_agents: 列出当前 agent 的所有子 agent（运行中 + 历史）
- *   3. get_sub_agent_status: 查询某子 agent 的实时状态
- *   4. await_sub_agents: 阻塞等待指定 sub-agent 数组完成
- *   5. abort_sub_agent: 终止某子 agent
- */
+
 export interface ACodeSubAgentToolDeps {
-    /** spawn 子 agent（不阻塞，不自动 start） */
+    
     spawnSubAgent: (opts: {
         subagentType: SubAgentType;
         description: string;
@@ -19,24 +10,24 @@ export interface ACodeSubAgentToolDeps {
     }) => Promise<{
         subId: string;
     }>;
-    /** 列出当前 agent 的所有子 agent */
+    
     listSubAgents: () => Promise<{
         running: Array<SubAgentInfo>;
         history: Array<SubAgentInfo>;
     }>;
-    /** 查询某子 agent 的实时状态 */
+    
     getSubAgentStatus: (subId: string) => Promise<SubAgentDetail | null>;
-    /** 阻塞等待指定 sub-agent 数组完成 */
+    
     awaitSubAgents: (subIds: string[], timeoutMs?: number) => Promise<Array<{
         subId: string;
         output: string;
         error?: string;
         status: SubAgentStatus;
     }>>;
-    /** 终止某子 agent */
+    
     abortSubAgent: (subId: string) => Promise<void>;
 }
-/** 子 agent 摘要信息（列表用） */
+
 export interface SubAgentInfo {
     subId: string;
     subagentType: SubAgentType;
@@ -46,7 +37,7 @@ export interface SubAgentInfo {
     endedAt?: number;
     durationMs?: number;
 }
-/** 子 agent 详情（含实时上下文） */
+
 export interface SubAgentDetail extends SubAgentInfo {
     prompt: string;
     result?: string;
@@ -67,5 +58,5 @@ export declare function createListSubAgentsTool(deps: ACodeSubAgentToolDeps): AC
 export declare function createGetSubAgentStatusTool(deps: ACodeSubAgentToolDeps): ACodeBuiltInTool;
 export declare function createAwaitSubAgentsTool(deps: ACodeSubAgentToolDeps): ACodeBuiltInTool;
 export declare function createAbortSubAgentTool(deps: ACodeSubAgentToolDeps): ACodeBuiltInTool;
-/** 创建全部 5 个 sub-agent 工具（仅当注入了 SubAgentManager 时调用） */
+
 export declare function createSubAgentTools(deps: ACodeSubAgentToolDeps): ACodeBuiltInTool[];

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

@@ -1,79 +1,73 @@
-/**
- * Sub Agent 类型定义。
- *
- * Sub agent 是由主 agent 通过 task 工具 spawn 的轻量级子代理，
- * 拥有独立的 ACodeRuntime 实例（独立 context window）。
- * 状态持久化到 ~/.acode/sub-agents/{agentId}.json（与 todo 同构）。
- */
-/** Sub agent 类型（决定工具权限） */
+
+
 export type SubAgentType = "general" | "explore";
-/** Sub agent 状态机 */
+
 export type SubAgentStatus = "pending" | "running" | "completed" | "failed" | "cancelled";
-/** 实时上下文快照（供 dashboard popup 展示） */
+
 export interface SubAgentContextSnapshot {
-    /** 当前正在执行的工具名（如 "read_file"），无则 undefined */
+    
     currentTool?: string;
-    /** 最近一条 assistant 文本（截断 500 字符） */
+    
     lastAssistantText?: string;
-    /** 累计 token 用量 */
+    
     tokenUsage: {
         input: number;
         output: number;
     };
-    /** 已产生的消息数（含 user/assistant/tool） */
+    
     messageCount: number;
-    /** 最后更新时间（ISO） */
+    
     updatedAt: string;
 }
-/** 持久化的单条 sub-agent 记录 */
+
 export interface SubAgentRecord {
-    /** sub-agent 唯一 ID（= sub-session-id） */
+    
     subId: string;
-    /** 父 agent.id */
+    
     parentAgentId: string;
-    /** 父 agent 的 runtime_session_id（用于校验归属） */
+    
     parentSessionId: string;
-    /** sub-agent 类型 */
+    
     subagentType: SubAgentType;
-    /** LLM 给的 3-5 词任务描述 */
+    
     description: string;
-    /** LLM 给的完整任务 prompt */
+    
     prompt: string;
-    /** 当前状态 */
+    
     status: SubAgentStatus;
-    /** 完成时的最终输出文本（tool output） */
+    
     result?: string;
-    /** 失败时的错误信息 */
+    
     errorMessage?: string;
-    /** 开始时间（毫秒时间戳） */
+    
     startedAt: number;
-    /** 结束时间（毫秒时间戳） */
+    
     endedAt?: number;
-    /** 运行时长（毫秒） */
+    
     durationMs?: number;
-    /** 最后一次上下文快照（仅 running 状态有意义，持久化时清空） */
+    
     contextSnapshot?: SubAgentContextSnapshot;
-    /** 工具调用事件历史（仅 tool_start/tool_end，按时间升序）。undefined 表示运行中尚未产生或旧版本记录 */
+    
     events?: SubAgentEvent[];
-    /** 该 sub-agent 创建时可用的工具列表（exposedName） */
+    
     availableTools?: string[];
 }
-/** 持久化的 sub-agent 文档结构 */
+
 export interface SubAgentDocument {
     agentId: string;
     updatedAt: string;
-    /** 全部 sub-agent 记录，按 startedAt 倒序 */
+    
     subAgents: SubAgentRecord[];
 }
-/** Sub agent 运行时事件（SSE 推送） */
+
 export interface SubAgentEvent {
-    /** 事件类型 */
+    
     type: "spawned" | "running" | "tool_start" | "tool_end" | "delta" | "progress" | "completed" | "failed" | "cancelled";
-    /** sub-agent ID */
+    
     subId: string;
-    /** 事件时间戳（ISO） */
+    
     timestamp: string;
-    /** 事件数据（按 type 不同结构不同） */
+    
     data: {
         tool?: string;
         text?: string;

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

@@ -1,42 +1,27 @@
-/** 单条 todo 项 */
+
 export interface TodoItem {
-    /** 任务简短描述（必填） */
+    
     content: string;
     status: "pending" | "in_progress" | "completed" | "cancelled";
     priority: "high" | "medium" | "low";
 }
-/** 持久化的 todo 文档结构 */
+
 export interface TodoDocument {
     agentId: string;
     updatedAt: string;
-    /**
-     * 整个 todo 列表的任务背景（必填）—— 描述该批任务的整体来源、目标、约束。
-     * 写入时由 todo_write 顶层传入，读取时一并返回，便于恢复任务上下文。
-     */
+    
     background: string;
     todos: TodoItem[];
 }
-/**
- * Todo JSON 文件存储，按 agentId 隔离。
- * 文件路径：{homedir}/.acode/todos/{agentId}.json
- *
- * 路径与 bridge 现有 ~/.acode/cmd-dist/ 惯例一致，固定使用家目录：
- *   - 不依赖 agent 工作目录，避免 workspacePath 错误时读取失败
- *   - todo 跟随 agent（agentId），不跟随项目工作区
- *
- * 并发安全：同一 TodoStore 实例的写操作通过 Promise 链串行化，
- * 避免同一 agentId 的并发 todo_write 互相覆盖。
- * 写入采用 tmp + rename 原子替换，防止半写损坏。
- * （rename 在 Windows 上目标被打开时会 EPERM，使用 renameWithRetry 短退避重试）
- */
+
 export declare class TodoStore {
     private readonly todosDir;
     private writeChain;
     constructor();
-    /** 文件路径（按 agentId 隔离） */
+    
     private filePath;
-    /** 读取该 agentId 的 todo 文档。文件不存在或损坏时返回空文档。 */
+    
     read(agentId: string): Promise<TodoDocument>;
-    /** 全量替换该 agentId 的 todo 文档（background + todos）。串行化以避免并发覆盖。 */
+    
     write(agentId: string, background: string, todos: TodoItem[]): Promise<void>;
 }

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

@@ -1,5 +1,5 @@
 import type { ACodeBuiltInTool } from "./built-in-file-tools.js";
-/** 创建 todo_write 工具（全量替换该 agent 的 todo 列表） */
+
 export declare function createTodoWriteTool(agentId: string): ACodeBuiltInTool;
-/** 创建 todo_read 工具（读取该 agent 的 todo 列表，含整体 background） */
+
 export declare function createTodoReadTool(agentId: string): ACodeBuiltInTool;