aws-runtime-bridge 1.9.92 → 1.9.93

package/package/acode/dist/runtime.d.ts

@@ -23,341 +23,119 @@ export declare class ACodeRuntime extends EventEmitter {
     private initialConversation;
     private state;
     private abortController;
-    /**
-     * 正在处理中的 memory 子 agent 跟踪表。
-     * key = memory URI，value = subId（用于防止同一 memory 被重复委托）。
-     * 子 agent 完成后通过 SubAgentManager 事件回调移除对应 URI。
-     */
+    
     private readonly pendingMemorySubAgents;
-    /**
-     * memory 委托冷却表（「已解决/已处理」守卫，区别于 pendingMemorySubAgents 的「进行中」守卫）。
-     * key = memory URI，value = 冷却到期时间戳（ms）。
-     * 子 agent 进入终态时写入；冷却期内即使 memory 仍待处理也不再 spawn 新子任务。
-     * 这是切断「委托完成→复发」循环的关键：原实现只有进行中守卫，子 agent 一结束 URI 立即释放，
-     * 导致下一轮 poll 对 sticky 的 updating memory 再次委托。
-     */
+    
     private readonly memoryDelegateCooldownUntil;
     private submitQueue;
     private activeTurn;
     private abortRequested;
-    /**
-     * 当前正在 await_sub_agents 工具中阻塞等待的子 agent subId 集合。
-     *
-     * 用于让 abort()/stop() 能中断 awaitSubAgents 的阻塞：
-     *   - awaitSubAgents 调用前把 subIds 加入此 set，finally 中移除
-     *   - abort()/stop() 时对此 set 中每个 subId 调用 manager.abort(subId)
-     *   - manager.abort 会 settle completionPromise（resolve with error）
-     *   - 从而让 await completionPromise 解除阻塞，execute() 正常返回，
-     *     executeSubmit 不再永久 pending，submitQueue 链恢复，后续 submit 可执行。
-     *
-     * 没有此机制时：abort() 只能中断 fetch 流，对 await completionPromise 无效，
-     * 导致 executeSubmit 永久阻塞 → submitQueue 死锁 → 后续 sendMessage 全部排队 → agent 无反应。
-     */
+    
     private pendingAwaitedSubIds;
     private sessionCompleteEmitted;
     private contextVersion;
     private readonly stopWaiters;
-    /** 上下文压缩调试定时器（每 5 秒输出一次） */
+    
     private compactionDebugTimer;
-    /** 可动态刷新的 SkillTool 引用（含 refresh 方法），运行中变更时调用其 refresh */
+    
     private skillTool;
-    /** 监听 skills 目录变更的 FSWatcher 列表 */
+    
     private skillWatchers;
-    /** skill 目录变更后的防抖定时器，避免短时间多次触发重扫 */
+    
     private skillRefreshTimer;
-    /** skill 重扫防抖间隔（毫秒） */
+    
     private static readonly SKILL_REFRESH_DEBOUNCE_MS;
-    /**
-     * ask_user_question 工具的挂起等待队列。
-     * key: toolCallId；value: resolve/reject 回调 + 创建时的 contextVersion。
-     * submitQuestionAnswer() 调用时 resolve；abort/stop/supersede 时 reject。
-     */
+    
     private readonly questionWaiters;
     constructor(config: ACodeRuntimeConfig);
-    /** 获取当前已暴露的工具名称列表（供 SubAgentManager 记录） */
+    
     getAvailableTools(): string[];
     private emitAcodeEvent;
-    /**
-     * 发射压缩子事件（phase 事件）到面板时间线。
-     * 子事件通过 parentId 关联到父压缩事件，在前端以嵌套子元素形式展示。
-     *
-     * @param compactionId 父压缩事件 ID
-     * @param phase 阶段标识（detect/prune/prune_done/summarize/summarize_done）
-     * @param phaseLabel 阶段显示标签（如"阶段1: 裁剪工具输出"）
-     * @param phaseDetail 阶段详情（如"裁剪了 5 条工具输出"）
-     */
+    
     private emitCompactionPhase;
-    /**
-     * performCompaction 的 onPhase 回调处理：将 CompactionPhaseEvent 转换为面板子事件。
-     */
+    
     private handleCompactionPhase;
-    /**
-     * 启动 ACode headless 会话。
-     * 主流程：加载 `.acode/config.json` 与 skills 目录 -> 发出 MCP/Skill 状态 ->
-     * 如有初始 prompt 则执行一轮响应。
-     */
+    
     start(): Promise<void>;
-    /**
-     * 加载所有 skills 来源目录并合并。
-     *
-     * 三个来源（按优先级，后加载的覆盖先加载的同名 skill）：
-     *   1. 全局目录（~/.acode/skills，由 config.skillsDir 指定）
-     *   2. 项目目录（<workingDirectory>/.acode/skills）
-     *   3. 项目目录（<workingDirectory>/.agentswork/skills）
-     *
-     * 返回合并后的 skills 列表、按目录分组的 skillGroups，以及需要监听的目录列表
-     * （已去重、规范化）。watchedDirs 用于启动 fs.watch 监听运行时变更。
-     */
+    
     private loadAllSkills;
-    /**
-     * 启动 fs.watch 监听 skills 目录变更。
-     *
-     * 使用 recursive: true（Windows/macOS 原生支持，Linux 在 Node 19+ 支持）。
-     * Linux 旧版本不支持时会抛 ERR_FEATURE_UNAVAILABLE，fallback 到非 recursive
-     * 监听顶层目录（只能感知 skill 子目录的新增/删除，无法感知 SKILL.md 内容修改）。
-     *
-     * 变更事件经防抖后触发 refreshSkills()，重新扫描目录、刷新 SkillTool、重发 skill_status。
-     */
+    
     private startSkillWatchers;
-    /**
-     * 防抖调度 skill 重扫。短时间内多次变更事件只触发一次重扫。
-     */
+    
     private scheduleSkillRefresh;
-    /**
-     * 重新扫描 skills 目录并刷新 SkillTool 与 state。
-     *
-     * 调用时机：fs.watch 监听到目录变更后（经防抖）。
-     * 副作用：
-     *   - 更新 this.skillTool 的内部 Map 与工具描述（让下一轮 turn 的 LLM 感知新 skill）
-     *   - 更新 this.state.skills（影响 fallback 响应等）
-     *   - 重发 skill_status 事件（让 DevTools 面板刷新"能力"标签页）
-     */
+    
     private refreshSkills;
-    /**
-     * 关闭所有 skills 目录监听器与防抖定时器。在 stop() 中调用。
-     */
+    
     private stopSkillWatchers;
-    /**
-     * 启动上下文压缩调试日志，每 5 秒写入系统临时目录下的 acode-compaction-debug.log。
-     * 仅当环境变量 ACODE_COMPACTION_DEBUG=1 时启用，使用异步写入避免阻塞事件循环。
-     */
+    
     private startCompactionDebugLog;
-    /**
-     * 停止上下文压缩调试日志。
-     */
+    
     private stopCompactionDebugLog;
-    /**
-     * 处理一轮用户输入。
-     * 主流程：将用户输入追加到会话 -> 调用 OpenAI-compatible 模型 -> 如模型请求
-     * MCP tool call 则执行工具并继续同一轮，最后输出 assistant 文本与 usage。
-     */
+    
     submit(message: string): Promise<void>;
-    /**
-     * Reset only the conversation context while keeping the live ACode session,
-     * MCP connections, exposed tools, commands, and hooks available.
-     */
+    
     resetContext(): Promise<void>;
     private isTurnSuperseded;
     private executeSubmit;
-    /** 中止当前轮次；由执行轮次统一发出一个终态事件，避免 aborted/failed 双终态。 */
+    
     abort(): Promise<void>;
-    /**
-     * 构造 ask_user_question 工具的依赖注入。
-     * onQuestion: 发出 question_request 事件，让 adapter 转发到前端。
-     * waitForAnswer: 阻塞等待 submitQuestionAnswer() 调用 resolve，或 abort/stop/supersede 时 reject。
-     */
+    
     private buildAskUserQuestionDeps;
-    /**
-     * 构造 sub-agent 工具集依赖（注入 SubAgentManager 句柄）。
-     *
-     * 5 个工具的依赖：
-     *   - spawnSubAgent: 创建子 agent（不阻塞，不自动 start）
-     *   - listSubAgents: 列出当前 agent 的所有子 agent
-     *   - getSubAgentStatus: 查询某子 agent 实时状态
-     *   - awaitSubAgents: 阻塞等待指定子 agent 数组完成
-     *   - abortSubAgent: 终止某子 agent
-     */
+    
     private buildSubAgentToolDeps;
-    /**
-     * 接收用户对 ask_user_question 的回答（由 AcodeSdkAdapter.sendQuestionAnswer 调用）。
-     * 若当前 turn 已被 supersede（contextVersion 变更），返回 false 让 adapter 知晓。
-     */
+    
     submitQuestionAnswer(toolCallId: string, answers: Record<string, string>): boolean;
-    /**
-     * 中止所有 ask_user_question 等待，让工具 execute() 抛错走 appendToolFailureResult。
-     * 在 abort()/stop() 中调用，确保用户点停止或会话终止时 execute 不会永久阻塞。
-     */
+    
     private rejectAllQuestionWaiters;
-    /**
-     * 取消当前正在 await_sub_agents 工具中阻塞等待的子 agent。
-     *
-     * 核心作用：让 abort()/stop() 能解除 awaitSubAgents 的阻塞，避免 submitQueue 死锁。
-     *
-     * 工作原理：
-     *   1. 遍历 pendingAwaitedSubIds（awaitSubAgents 工具执行期间记录的 subIds）
-     *   2. 对每个 subId 调用 manager.abort(subId)
-     *   3. manager.abort 会 settle completionPromise（resolve with error="aborted"）
-     *   4. awaitSubAgents 中 await completionPromise 解除阻塞，execute() 正常返回
-     *   5. executeSubmit 完成，submit() Promise resolve，submitQueue 链恢复
-     *   6. 后续 sendMessage / auto-poll 的 submit 能正常排队执行
-     *
-     * 场景：看门狗触发 abort() 或用户点击停止时，agent 正卡在 await_sub_agents
-     *   等待子 agent 完成。若不取消子 agent，completionPromise 永不 settle，
-     *   executeSubmit 永久 pending，submitQueue 死锁，agent 彻底无反应。
-     *
-     * 注意：此方法 fire-and-forget，不 await manager.abort 完成。
-     *   manager.abort 内部会同步 settle completionPromise（通过 completionResolve），
-     *   解除 awaitSubAgents 阻塞无需等待 abort I/O 完成。
-     */
+    
     private cancelPendingAwaitedSubAgents;
-    /** 终止 ACode 会话并发出 session_complete。 */
+    
     stop(): Promise<void>;
     private resolveCommandDirs;
     private runModelTurn;
-    /**
-     * LLM 摘要器：调用当前 provider 生成结构化对话摘要。
-     *
-     * 这是把 OpenCode 的 LLM 摘要能力赋能到 ACode 的核心方法：
-     * - OpenCode 在 compaction.process 中调用独立的 compaction agent
-     * - ACode 复用当前 provider 配置，发起一次非流式 chat completion 请求
-     * - 使用 COMPACTION_LLM_PROMPT_TEMPLATE 作为 prompt 模板
-     *
-     * 设计要点：
-     * 1. 非流式调用（不需要流式，简化处理）
-     * 2. 不带 tools（纯文本生成）
-     * 3. 失败时抛出异常，由 summarizeConversation 降级到规则摘要
-     * 4. 独立的 AbortController，避免主请求取消影响摘要
-     * 5. 复用 provider 的 timeout 配置
-     *
-     * @param input 摘要输入（conversationText + messageCount + contextLimit）
-     * @returns LLM 生成的结构化摘要文本
-     */
+    
     private summarizeConversationWithLLM;
     private requestChatCompletion;
     private readChatCompletionStream;
     private handleToolCalls;
     private callMcpToolWithTimeout;
-    /**
-     * 将子 agent 终态通知转为 poll_message 格式的合成 DirectMessage。
-     * 主流程：构建符合 MCP poll_message 返回格式的 JSON 字符串。
-     */
+    
     private static formatSubAgentCompletionAsPollResult;
-    /**
-     * 将子 agent 终态通知合并到已有的 MCP poll_message 返回结果中。
-     * 主流程：解析 MCP 返回的 JSON -> 将通知转为 DirectMessage 插入到 directMessages 前面 -> 重新序列化。
-     */
+    
     private static mergeSubAgentCompletionsIntoMcpResult;
-    /**
-     * Memory 自动委托 sub-agent 完成一轮后的外部重新检查。
-     *
-     * 查询服务端 memory 真实状态（通过 MCP 工具直接调用，非 LLM 自报），
-     * 判断 sub-agent 是否真正完成了处理：
-     * - memory_file_change：检查每条 memory 的 memory_status 是否已回到 normal
-     * - memory_expiration：检查每条 memory 是否已续期（expiresAt 在未来）或已清理（read 返回 null）
-     * - memory_cleanup：检查 get_memory_stats 中对应类型/域是否仍 exceeded
-     *
-     * 若仍有未完成项，返回 { done: false, continueMessage } 包含 "经检查，未完成对xxx的处理，请继续"
-     * 及具体未完成列表，由 SubAgentManager 注入同一 sub-agent 的下一轮 submit。
-     *
-     * recheck 自身出错（MCP 连接不可用、工具调用超时等）时返回 { done: true }，不阻塞 sub-agent 结束。
-     */
+    
     private recheckMemoryDelegate;
-    /**
-     * 通过 MCP read_memory 工具读取单条 memory 记录。
-     * 注入 _aws_sub_agent=true 避免状态上报污染父 agent 时间线。
-     * 返回 null 表示 memory 明确不存在（服务端返回 null/undefined 或非对象）。
-     * 读取/解析异常（网络抖动、超时、服务端错误）会向上抛出，交由 recheckMemoryDelegate
-     * 统一判定为「未完成」，避免被误当作「已处理」。
-     */
+    
     private readMemoryViaMcp;
-    /** recheck memory_file_change：检查 memory_status 是否仍为 updating */
+    
     private recheckMemoryFileChange;
-    /** recheck memory_expiration：检查 expiresAt 是否仍过期 或 memory_status 是否仍为 recalling */
+    
     private recheckMemoryExpiration;
-    /** recheck memory_cleanup：检查 get_memory_stats 中对应类型/域是否仍 exceeded */
+    
     private recheckMemoryCleanup;
-    /**
-     * 构造 memory 自动委托子 agent 的 prompt。
-     * 主流程：根据 delegate 类型（过期整理/文件变更更新）生成自包含指令。
-     */
+    
     private buildMemoryDelegatePrompt;
-    /**
-     * 处理 poll_message 结果中的 memory 自动委托标记 (_acodeAutoDelegate)。
-     * 主流程：解析 MCP 返回 -> 识别标记 -> spawn 子 agent -> 返回简化结果。
-     * 非 ACode 运行时（无 subAgentManager）直接透传原结果，不受影响。
-     * 返回 null 表示全部消息已被委托，调用方应重新 poll_message 继续等待真正的消息。
-     */
+    
     private processMemoryAutoDelegates;
-    /**
-     * poll_message MCP 工具调用的子 agent 完成事件 race 包装器。
-     *
-     * 主流程：
-     * 1. 先检查 completionQueue 中是否有已完成的子 agent -> 有则直接返回合成结果（不调 MCP）
-     * 2. 启动 MCP poll_message 调用与 waitForAnyCompletion 的 race
-     * 3. 子 agent 先完成 -> 返回合成结果（MCP 调用被放弃但仍在运行，下次 poll_message 会复用 pendingPollMessage）
-     * 4. MCP 先返回 -> 合并新完成的子 agent 事件后返回
-     *
-     * 设计说明：
-     * - MCP server 的 poll_message 内部有 while(true) 永久阻塞，只在有消息时返回
-     * - 子 agent 完成事件由 SubAgentManager 在同进程内产生，通过 completionQueue 传递
-      * - 当子 agent 先完成时，MCP 调用被放弃（Promise 不再被 await），MCP server 侧的
-      *   pendingPollMessage 仍在运行，下次 poll_message 调用会通过 pendingPollMessage 复用
-      */
+    
     private callPollMessageWithSubAgentRace;
-    /**
-     * 检查 poll_message 结果是否包含实际消息（directMessages 或 groupMessages 非空）。
-     * 用于循环中过滤空结果，确保 poll_message 只在有消息时返回。
-     */
+    
     private pollResultHasMessages;
-    /**
-     * 在 memory 委托消息被全部处理后，等待一段时间再重新 poll_message。
-     *
-     * 背景：MCP doPollMessage 对 updating memory 每次都返回通知（无去重），
-     * 而 processMemoryAutoDelegates 因 URI 已在 pendingMemorySubAgents 中而返回 null，
-     * 导致 while(true) 无延迟重 poll，每轮触发 handleToolCall 的 reportToolUse/reportThinking
-     * 状态上报，引发"思考→MCP→跳过"快速循环，最终连接丢失。
-     *
-     * 等待策略：
-     * 1. 固定延迟 DELEGATE_REPOLL_DELAY_MS（5s），给子 agent 时间完成 memory 更新
-     * 2. 可被 runtime stop 中断（通过 createRuntimeStopWaiter）
-     * 3. 不消费 completionQueue（下一轮 takeCompletedSubAgents 会取到）
-     */
+    
     private waitForDelegateRepoll;
-    /**
-     * Build a one-shot waiter that rejects long-running MCP calls when the runtime stops.
-     * Main flow: register a stop callback -> race it with the SDK call -> remove it after either side settles.
-     */
+    
     private createRuntimeStopWaiter;
-    /**
-     * Notify and clear every pending runtime-stop waiter.
-     * Main flow: snapshot callbacks -> clear the set -> reject each pending MCP race exactly once.
-     */
+    
     private notifyRuntimeStop;
     private appendSyntheticMultimodalUserMessage;
     private appendToolFailureResult;
-    /**
-     * 为子 agent 过滤共享 MCP 连接：只保留 memory 工具。
-     *
-     * 原 MCP server 进程通过 AWS_SUB_AGENT=true 限制子 agent 只能调用 memory 工具，
-     * 共享连接后绕过了该机制。此方法在 ACode runtime 层重新施加限制：
-     *   - 复用同一 client/transport（不创建新连接）
-     *   - 仅暴露 MEMORY_TOOL_NAMES 中的工具
-     *   - 防止子 agent 调用 poll_message（与父 agent 冲突）、send_group 等
-     */
+    
     private filterSharedMcpConnectionsForSubAgent;
     private connectMcpServers;
     private createMcpTransport;
-    /**
-     * 通过 MCP 连接调用 get_profile 工具获取用户 profile 信息，
-     * 格式化为文本后返回，用于拼接到 rolePrompt 下方。
-     * 主流程：遍历已连接的 MCP -> 找到 get_profile 工具 -> 调用 -> 格式化结果。
-     * 容错：任何步骤失败都返回空字符串，不阻塞启动。
-     */
+    
     private fetchProfilePrompt;
-    /**
-     * 从 MCP callTool 返回值中提取 profile 对象。
-     * 主流程：优先取 content[0].text JSON -> 回退到 result 本身为对象。
-     */
+    
     private extractProfileFromToolResult;
     private disconnectMcpServers;
 }

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

@@ -1,29 +1,9 @@
 import type { ACodeBuiltInTool } from "./built-in-file-tools.js";
 import type { ACodeSkillMetadata } from "./types.js";
-/**
- * 可动态刷新的 SkillTool：在 ACodeBuiltInTool 基础上增加 refresh 方法，
- * 让 runtime 在监听到 skill 目录变更时能即时更新工具描述与 name→metadata 映射。
- */
+
 export interface ACodeSkillTool extends ACodeBuiltInTool {
-    /**
-     * 用新的 skill 列表重建内部映射，并更新工具描述（`<available_skills>` XML 块）。
-     * 已在运行中的会话下一轮 turn 会通过更新后的 description 让 LLM 感知到新 skill。
-     */
+    
     refresh(skills: ACodeSkillMetadata[]): void;
 }
-/**
- * 创建 SkillTool 实例。
- *
- * SkillTool 是一个内置工具，允许 LLM 按名称加载已安装的 skill。
- * 工具描述中内嵌 `<available_skills>` XML，列出当前所有可用 skill；
- * 执行时返回 `<skill_content>` 块，包含 SKILL.md body 内容与目录下的文件列表。
- *
- * 工具名固定为 `skill`，与 compaction.ts 的 PRUNE_PROTECTED_TOOLS 白名单对应，
- * 确保 skill 加载内容不会被上下文压缩裁剪。
- *
- * 返回的工具对象额外提供 `refresh(skills)` 方法，支持运行时动态更新：
- * runtime 监听到 skills 目录变更后会调用它，重建 name→metadata 映射并刷新工具描述。
- *
- * @param skills 启动时加载的 skill 元数据列表
- */
+
 export declare function createSkillTool(skills: ACodeSkillMetadata[]): ACodeSkillTool;