aws-runtime-bridge 1.9.33 → 1.9.40

package/package/acode/dist/config.js

@@ -40,6 +40,7 @@ async function readSkillMetadata(directory) {
     }
     const raw = (await fs.readFile(skillFile, 'utf-8')).replace(/^\uFEFF/, '');
     const metadata = {};
+    let bodyStart = 0;
     if (raw.startsWith('---')) {
         const end = raw.indexOf('\n---', 3);
         if (end >= 0) {
@@ -53,18 +54,42 @@ async function readSkillMetadata(directory) {
                     metadata[match[1]] = value;
                 }
             }
+            // body 起始位置：跳过关闭的 `---` 及其后的换行符
+            bodyStart = end + 4;
+            const newlineAfterFrontmatter = raw.charAt(end + 4);
+            if (newlineAfterFrontmatter === '\r') {
+                bodyStart += 1;
+                if (raw.charAt(end + 5) === '\n') {
+                    bodyStart += 1;
+                }
+            }
+            else if (newlineAfterFrontmatter === '\n') {
+                bodyStart += 1;
+            }
         }
     }
+    const content = raw.slice(bodyStart).trim();
     return {
         name: metadata.name || fallbackNameFromDirectory(directory),
         description: metadata.description,
         directory,
+        content,
     };
 }
 export async function loadAcodeSkills(skillsDir) {
-    if (!skillsDir || !(await pathExists(skillsDir))) {
+    if (!skillsDir) {
         return [];
     }
+    return (await loadAcodeSkillGroup(skillsDir)).skills;
+}
+/**
+ * 加载单个 skills 目录：返回目录路径、是否存在、以及该目录下的 skills 列表。
+ * 目录不存在时返回 exists=false + 空 skills，供前端展示空节点。
+ */
+export async function loadAcodeSkillGroup(skillsDir) {
+    if (!(await pathExists(skillsDir))) {
+        return { dir: skillsDir, exists: false, skills: [] };
+    }
     const entries = await fs.readdir(skillsDir, { withFileTypes: true });
     const skills = [];
     for (const entry of entries) {
@@ -76,5 +101,5 @@ export async function loadAcodeSkills(skillsDir) {
             skills.push(metadata);
         }
     }
-    return skills;
+    return { dir: skillsDir, exists: true, skills };
 }

package/package/acode/dist/index.d.ts

@@ -5,4 +5,8 @@ export * from './config.js';
 export * from './hooks/hookBus.js';
 export * from './runtime.js';
 export * from './types.js';
+export * from './sub-agent-types.js';
+export * from './sub-agent-store.js';
+export * from './sub-agent-manager.js';
+export * from './sub-agent-tools.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC"}

package/package/acode/dist/index.js

@@ -5,3 +5,7 @@ export * from './config.js';
 export * from './hooks/hookBus.js';
 export * from './runtime.js';
 export * from './types.js';
+export * from './sub-agent-types.js';
+export * from './sub-agent-store.js';
+export * from './sub-agent-manager.js';
+export * from './sub-agent-tools.js';

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

@@ -12,14 +12,93 @@ export declare class ACodeRuntime extends EventEmitter {
     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);
     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 模型 -> 如模型请求
@@ -35,10 +114,56 @@ export declare class ACodeRuntime extends EventEmitter {
     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;
     /** 终止 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;
@@ -57,6 +182,18 @@ export declare class ACodeRuntime extends EventEmitter {
     private appendToolFailureResult;
     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;
 }
 //# sourceMappingURL=runtime.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAmB3C,OAAO,KAAK,EAOV,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AAksCpB,qBAAa,YAAa,SAAQ,YAAY;IAsChC,OAAO,CAAC,QAAQ,CAAC,MAAM;IArCnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,mBAAmB,CAAqB;IAEhD,OAAO,CAAC,KAAK,CAoBX;IAEF,OAAO,CAAC,eAAe,CAAgC;IAEvD,OAAO,CAAC,WAAW,CAAoC;IAEvD,OAAO,CAAC,UAAU,CAAS;IAE3B,OAAO,CAAC,cAAc,CAAS;IAE/B,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;gBAExB,MAAM,EAAE,kBAAkB;IAevD,OAAO,CAAC,cAAc;IAatB;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqH5B;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5C;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAWnC,OAAO,CAAC,gBAAgB;YAIV,aAAa;IAoO3B,oDAAoD;IAC9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,uCAAuC;IACjC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA+B3B,OAAO,CAAC,kBAAkB;YAaZ,YAAY;YAyJZ,qBAAqB;YAmLrB,wBAAwB;YA8ExB,eAAe;YAqSf,sBAAsB;IA6CpC;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAiC/B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;YAQX,oCAAoC;IAsBlD,OAAO,CAAC,uBAAuB;YAuBjB,iBAAiB;IA2C/B,OAAO,CAAC,kBAAkB;YA2BZ,oBAAoB;CAiBnC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA+C3C,OAAO,KAAK,EAOV,kBAAkB,EAGnB,MAAM,YAAY,CAAC;AA4oCpB,qBAAa,YAAa,SAAQ,YAAY;IAgEhC,OAAO,CAAC,QAAQ,CAAC,MAAM;IA/DnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,mBAAmB,CAAqB;IAEhD,OAAO,CAAC,KAAK,CAsBX;IAEF,OAAO,CAAC,eAAe,CAAgC;IAEvD,OAAO,CAAC,WAAW,CAAoC;IAEvD,OAAO,CAAC,UAAU,CAAS;IAE3B,OAAO,CAAC,cAAc,CAAS;IAE/B,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IACrD,4BAA4B;IAC5B,OAAO,CAAC,oBAAoB,CAA+C;IAC3E,0DAA0D;IAC1D,OAAO,CAAC,SAAS,CAA+B;IAChD,mCAAmC;IACnC,OAAO,CAAC,aAAa,CAAsB;IAC3C,oCAAoC;IACpC,OAAO,CAAC,iBAAiB,CAA8C;IACvE,uBAAuB;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAO;IAExD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAOlB;gBAEe,MAAM,EAAE,kBAAkB;IAevD,OAAO,CAAC,cAAc;IAatB;;;;;;;;OAQG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAqB7B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsK5B;;;;;;;;;;OAUG;YACW,aAAa;IA+C3B;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IA2B1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;;;;;;;OAQG;YACW,aAAa;IAuC3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAezB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAqD/B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5C;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAanC,OAAO,CAAC,gBAAgB;YAIV,aAAa;IAgP3B,oDAAoD;IAC9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IAuBhC;;;;;;;;;OASG;IACH,OAAO,CAAC,qBAAqB;IA4E7B;;;OAGG;IACH,oBAAoB,CAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO;IAeV;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAQhC,uCAAuC;IACjC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA4C3B,OAAO,CAAC,kBAAkB;YAaZ,YAAY;IA4K1B;;;;;;;;;;;;;;;;;OAiBG;YACW,4BAA4B;YAwE5B,qBAAqB;YA2TrB,wBAAwB;YAsFxB,eAAe;YAwSf,sBAAsB;IA6CpC;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAiC/B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;YAQX,oCAAoC;IA0DlD,OAAO,CAAC,uBAAuB;YA0BjB,iBAAiB;IA2C/B,OAAO,CAAC,kBAAkB;IA2B1B;;;;;OAKG;YACW,kBAAkB;IAgChC;;;OAGG;IACH,OAAO,CAAC,4BAA4B;YA4BtB,oBAAoB;CAiBnC"}