aws-runtime-bridge 1.9.33 → 1.9.41

package/dist/routes/terminal.js

@@ -27,6 +27,56 @@ import { logger as log } from "../utils/logger.js";
 export const terminalRouter = Router();
 // 导出 SDK 会话存储，供其他模块使用（如 sessions.ts）
 export const sdkSessions = new Map();
+// ── 活跃状态定期刷新，防止长时间 LLM 调用期间 WebSocket 心跳超时导致 LOST ──
+/**
+ * 状态刷新间隔（毫秒）。
+ * 服务端 WebSocket 空闲超时默认 60 秒（maxIdleTimeMs），取 45 秒作为刷新周期，
+ * 留出足够的余量防止因网络抖动或事件循环延迟导致的超时。
+ */
+const STATUS_REFRESH_INTERVAL_MS = 45_000;
+/** 每个 session 的定期刷新定时器，仅在 thinking/tool_using/compacting 时运行 */
+const statusRefreshTimers = new Map();
+/**
+ * 启动 session 定期状态刷新。
+ * 每隔 STATUS_REFRESH_INTERVAL_MS 向服务端发送一次当前运行状态，
+ * 刷新服务端 WebSocket 会话的 lastActiveTime，避免长时间无消息导致连接断开 → LOST。
+ */
+function startStatusRefresh(sessionId) {
+    if (statusRefreshTimers.has(sessionId))
+        return;
+    const timer = setInterval(() => {
+        const entry = sdkSessions.get(sessionId);
+        if (!entry) {
+            stopStatusRefresh(sessionId);
+            return;
+        }
+        const status = entry.currentRuntimeStatus;
+        // 仅活跃状态需要刷新：thinking / tool_using / compacting
+        if (status !== "thinking" && status !== "tool_using" && status !== "compacting") {
+            stopStatusRefresh(sessionId);
+            return;
+        }
+        // 发送轻量级状态刷新（不带 actionInfo），保持 WebSocket 会话活跃
+        void sendStatus(entry.agentId, sessionId, status, undefined, // 不传 actionInfo，避免创建额外时间线条目
+        undefined, {
+            runtimeAccessToken: entry.runtimeAccessToken,
+            schedulerBaseUrl: entry.schedulerBaseUrl,
+        }).catch(() => {
+            // sendStatus 失败静默处理，不影响主流程
+        });
+    }, STATUS_REFRESH_INTERVAL_MS);
+    statusRefreshTimers.set(sessionId, timer);
+}
+/**
+ * 停止 session 定期状态刷新。
+ */
+function stopStatusRefresh(sessionId) {
+    const timer = statusRefreshTimers.get(sessionId);
+    if (timer) {
+        clearInterval(timer);
+        statusRefreshTimers.delete(sessionId);
+    }
+}
 const TOOL_RESULT_PREVIEW_MAX_LENGTH = 4000;
 const AI_REQUEST_BODY_MARKER = "\n\n请求体:\n";
 /**
@@ -58,10 +108,10 @@ const AI_REQUEST_HEADERS_MARKER = "\n\n请求头:\n";
 const startingAgents = new Set();
 // ============ 启动记忆加载 ============
 /**
- * 从工作区的 .agentswork/memory/ 目录加载 task_list 和 recently_memory，
+ * 从工作区的 .agentswork/memory/ 目录加载 recently_memory 和 agent_memory，
  * 格式化为可注入 System 3 的文本。
  *
- * 主流程：遍历目录下所有 domain JSON 文件 -> 提取 task_list/recently_memory 记录 ->
+ * 主流程：遍历目录下所有 domain JSON 文件 -> 提取 recently_memory/agent_memory 记录 ->
  * 按类型分组排序 -> 返回格式化文本；目录不存在或解析失败时返回 undefined。
  */
 async function loadAgentStartupMemories(workspacePath, options) {
@@ -93,10 +143,10 @@ async function loadAgentStartupMemories(workspacePath, options) {
                 const content = (record.content || "").trim();
                 if (!content)
                     continue;
-                if (type === "task_list") {
+                if (type === "recently_memory") {
                     taskList.push({ title: record.title, content, uri: record.uri || "" });
                 }
-                else if (type === "recently_memory") {
+                else if (type === "agent_memory") {
                     recentMemories.push({ title: record.title, content, uri: record.uri || "" });
                 }
             }
@@ -115,8 +165,8 @@ async function loadAgentStartupMemories(workspacePath, options) {
             "X-Runtime-Token": options.runtimeAccessToken,
             Authorization: `Bearer ${options.runtimeAccessToken}`,
         };
-        // 并行请求 task_list 和 recently_memory
-        const typesToFetch = ["task_list", "recently_memory"];
+        // 并行请求 recently_memory 和 agent_memory
+        const typesToFetch = ["recently_memory", "agent_memory"];
         const results = await Promise.allSettled(typesToFetch.map((memoryType) => fetch(mcpUrl, {
             method: "POST",
             headers,
@@ -136,7 +186,7 @@ async function loadAgentStartupMemories(workspacePath, options) {
             const records = settled.value;
             if (!Array.isArray(records))
                 continue;
-            const target = typesToFetch[i] === "task_list" ? taskList : recentMemories;
+            const target = typesToFetch[i] === "recently_memory" ? taskList : recentMemories;
             for (const r of records) {
                 const content = (r.content || "").trim();
                 if (!content)
@@ -156,12 +206,12 @@ async function loadAgentStartupMemories(workspacePath, options) {
     if (taskList.length > 0) {
         const items = taskList.slice(0, MAX_PER_TYPE);
         const lines = items.map((t, i) => {
-            const titleLine = t.title ? `【${t.title}】` : `待办 ${i + 1}`;
+            const titleLine = t.title ? `【${t.title}】` : `条目 ${i + 1}`;
             return `${titleLine}\n${t.content}`;
         });
-        sections.push(`【短期任务清单】\n${lines.join("\n\n")}`);
+        sections.push(`【短期记忆】\n${lines.join("\n\n")}`);
         if (taskList.length > MAX_PER_TYPE) {
-            sections.push(`... 及另外 ${taskList.length - MAX_PER_TYPE} 条任务`);
+            sections.push(`... 及另外 ${taskList.length - MAX_PER_TYPE} 条短期记忆`);
         }
     }
     if (recentMemories.length > 0) {
@@ -170,9 +220,9 @@ async function loadAgentStartupMemories(workspacePath, options) {
             const titleLine = t.title ? `【${t.title}】` : "";
             return titleLine ? `${titleLine}\n${t.content}` : t.content;
         });
-        sections.push(`【近期记忆】\n${lines.join("\n\n")}`);
+        sections.push(`【agent认知】\n${lines.join("\n\n")}`);
         if (recentMemories.length > MAX_PER_TYPE) {
-            sections.push(`... 及另外 ${recentMemories.length - MAX_PER_TYPE} 条近期记忆`);
+            sections.push(`... 及另外 ${recentMemories.length - MAX_PER_TYPE} 条 agent 认知`);
         }
     }
     if (sections.length === 0)
@@ -226,21 +276,34 @@ export function parseRuntimeStopOptions(body) {
 }
 export function resolveStatusChangeUsage(actionInfo) {
     const usage = actionInfo?.usage;
-    if (!usage)
+    if (!usage) {
         return undefined;
+    }
     const inputTokens = Number.isFinite(usage.inputTokens)
         ? usage.inputTokens
         : 0;
     const outputTokens = Number.isFinite(usage.outputTokens)
         ? usage.outputTokens
         : 0;
-    if (inputTokens <= 0 && outputTokens <= 0 && !usage.contextLimit)
+    // ★ 即使 input/output token 都为 0（如 session_started 初始状态），只要有任一压缩配置字段也应传出，
+    //   否则前端拿不到 compactionThreshold，压缩点竖线无法显示。
+    if (inputTokens <= 0 &&
+        outputTokens <= 0 &&
+        !usage.contextLimit &&
+        !usage.maxOutput &&
+        !usage.inputLimit &&
+        !usage.compactionThreshold) {
         return undefined;
-    return {
+    }
+    const result = {
         inputTokens,
         outputTokens,
         ...(usage.contextLimit ? { contextLimit: usage.contextLimit } : {}),
+        ...(usage.maxOutput ? { maxOutput: usage.maxOutput } : {}),
+        ...(usage.inputLimit ? { inputLimit: usage.inputLimit } : {}),
+        ...(usage.compactionThreshold ? { compactionThreshold: usage.compactionThreshold } : {}),
     };
+    return result;
 }
 export function resolveStatusChangeRuntimeState(status, actionInfo) {
     const normalizedStatus = String(status || "")
@@ -937,10 +1000,15 @@ function formatSdkLogMessage(event) {
     }
     return undefined;
 }
+// 匹配 CSI 类 ANSI 转义序列（颜色/光标/清屏等），用于 DevTools 日志预览剥离
+const ANSI_ESCAPE_PATTERN = /\x1b\[[0-9;?]*[a-zA-Z]/g;
+function stripAnsiEscapeCodes(text) {
+    return text.replace(ANSI_ESCAPE_PATTERN, "");
+}
 function formatCommandOutputLogMessage(event) {
     const stream = typeof event.data.stream === "string" ? event.data.stream : "mixed";
     const sequence = typeof event.data.sequence === "number" ? ` #${event.data.sequence}` : "";
-    const normalized = String(event.data.text || "")
+    const normalized = stripAnsiEscapeCodes(String(event.data.text || ""))
         .replace(/\s+/g, " ")
         .trim();
     const preview = normalized.length > 240 ? `${normalized.slice(0, 240)}...` : normalized;
@@ -1083,17 +1151,45 @@ function isWaitingInputProgressEvent(event, currentRuntimeStatus) {
     }
     return event.type === "thinking" || event.type === "text_delta";
 }
+/**
+ * 从事件 data 中提取 estimatedContextTokens（兼容多种字段名）。
+ * 返回 undefined 表示无有效值，使调用方能区分"无数据"和"0"。
+ */
+function extractEstimatedContextTokens(data) {
+    for (const key of [
+        "estimatedContextTokens",
+        "contextTokens",
+        "context_tokens",
+        "contextUsedTokens",
+        "context_used_tokens",
+    ]) {
+        const value = data[key];
+        const count = Number(value);
+        if (Number.isFinite(count) && count > 0) {
+            return count;
+        }
+    }
+    return undefined;
+}
 export function resolveRuntimeStatusFromProviderEvent(event, currentRuntimeStatus) {
     if (isWaitingInputProgressEvent(event, currentRuntimeStatus)) {
         return undefined;
     }
     if (event.type === "ai_request") {
+        // ★ 从 event.data 提取 estimatedContextTokens 构建 usage，
+        //   确保 event handler 路径也能传递 token 用量到前端。
+        //   这对压缩后面板刷新尤为关键：压缩后 ai_request 的 estimatedContextTokens
+        //   反映了压缩后的真实上下文大小，前端据此更新进度条。
+        const estimatedTokens = extractEstimatedContextTokens(event.data);
         return {
             status: "thinking",
             actionInfo: {
                 actionType: "ai_request",
                 actionLabel: "AI请求",
                 actionDetail: formatAiRequestDetail(event.data),
+                ...(estimatedTokens !== undefined
+                    ? { usage: { inputTokens: estimatedTokens, outputTokens: 0 } }
+                    : {}),
             },
         };
     }
@@ -1145,11 +1241,39 @@ export function resolveRuntimeStatusFromProviderEvent(event, currentRuntimeStatu
     if (event.type === "error") {
         return { status: "error" };
     }
+    if (event.type === "context_compaction") {
+        return {
+            status: "compacting",
+            actionInfo: {
+                actionType: "context_compaction",
+                actionLabel: event.data.actionLabel,
+                actionDetail: event.data.actionDetail,
+                ...(event.data.actionId ? { actionId: event.data.actionId } : {}),
+                ...(event.data.parentId ? { parentId: event.data.parentId } : {}),
+            },
+        };
+    }
+    if (event.type === "runtime_capabilities") {
+        // 运行时能力清单（MCP 工具 / Skill 列表）—— 保持当前运行态不变，仅推送 actionInfo 到时间线供调试面板展示
+        return {
+            status: currentRuntimeStatus || "waiting_input",
+            actionInfo: {
+                actionType: "runtime_capabilities",
+                actionLabel: event.data.actionLabel || "运行时能力",
+                actionDetail: event.data.actionDetail,
+            },
+        };
+    }
     return undefined;
 }
 // Per-session 输出队列：确保 sendOutput HTTP POST 按事件顺序串行到达 Server，
 // 避免并发 POST 因网络时序导致流式文本 chunk 乱序。
 const sdkOutputQueueBySession = new Map();
+// Per-session 压缩状态事件队列：确保 context_compaction 事件（start/detect/prune/.../end）
+// 按发射顺序串行发送 HTTP POST，避免并发请求导致部分事件丢失（DB 证据：所有压缩都只保留了 2-4 个事件）。
+// ★ 根因：runtime.ts 同步连续发射 start/detect 等事件，多个 void sendStatus 并发执行 HTTP POST，
+//   部分 HTTP 请求因竞争/超时/Java 后端 FOR UPDATE 锁等待而失败，事件永久丢失（本地 buffer 不重推）。
+const compactionStatusChainBySession = new Map();
 /** 小 chunk 积攒缓存：sessionId:sourceEventType → { buffer, seq, timer, sourceEventType, entry }，不足 20 字符时积攒最多 500ms 再推送 */
 const sdkOutputSmallChunkAccumulators = new Map();
 /** 小 chunk 积攒阈值：字符数少于此值的 output 事件积攒发送 */
@@ -1272,11 +1396,29 @@ function wireSdkAdapterEvents(adapter, definition) {
         const entry = sdkSessions.get(event.sessionId);
         if (entry) {
             console.log(`[${definition.displayName} Adapter] Event: ${event.type} for session ${event.sessionId}`);
-            // Skip sendStatus for thinking/text_delta/tool_use_start events — the status-change
+            // Skip sendStatus for thinking/text_delta/tool_use_start/context_compaction/ai_request events — the status-change
             // listener already emits the authoritative status with restored actionInfo,
             // avoiding duplicate timeline entries in agentEventStore.
-            const isDeferredStatusEvent = event.type === "thinking" || event.type === "text_delta" || event.type === "tool_use_start";
+            // ★ context_compaction 加入此列表：adapter 对每个压缩事件（start/phase/end）都会同时
+            //    调用 emitProviderEvent（触发 event 监听器）和 emit("status-change")（触发 status-change 监听器），
+            //    两条路径都会 sendStatus，导致 Bridge 收到重复事件。虽然前端 seenActionIds 会去重，
+            //    但异步 sendStatus 到达顺序不确定，会造成同时间戳事件顺序错乱（如 prune_end 排在 prune_start 前）。
+            //    只保留 status-change 路径（含完整 actionId/parentId），确保父子事件正确匹配与排序。
+            // ★ ai_request 加入此列表（修复 BUG：Agent 永久卡在 "AI请求" 状态）：
+            //    ai_request 同时触发 provider event 路径和 status-change 路径两条 sendStatus，
+            //    而 tool_use_start（编辑文件等）仅通过 status-change 路径发送。
+            //    异步 HTTP 乱序导致 ai_request 的 provider-event sendStatus 可能晚于 tool_use_start 到达，
+            //    覆盖前端状态为 "AI请求"，而时间线正确显示 "编辑文件"。
+            //    将 ai_request 加入 deferred 列表，使其仅通过 status-change 路径发送，
+            //    与 tool_use_start 保持一致，消除双路径竞态。
+            const isDeferredStatusEvent = event.type === "thinking" || event.type === "text_delta" || event.type === "tool_use_start" || event.type === "context_compaction" || event.type === "ai_request";
             if (!isDeferredStatusEvent) {
+                // ★ 修复时序竞争：runtime_capabilities 事件缓存 actionDetail，
+                //   用于 session 稳定后重发（防止 "starting" 状态尚未更新 runtime_session_id
+                //   导致服务端丢弃事件）
+                if (event.type === "runtime_capabilities" && event.data.actionDetail) {
+                    entry.cachedCapabilitiesActionDetail = event.data.actionDetail;
+                }
                 const runtimeStatus = resolveRuntimeStatusFromProviderEvent(event, entry.currentRuntimeStatus);
                 if (runtimeStatus) {
                     void sendStatus(entry.agentId, event.sessionId, runtimeStatus.status, runtimeStatus.actionInfo, resolveStatusChangeUsage(runtimeStatus.actionInfo), {
@@ -1308,6 +1450,13 @@ function wireSdkAdapterEvents(adapter, definition) {
     adapter.on("status-change", (sessionId, status, actionInfo) => {
         const entry = sdkSessions.get(sessionId);
         if (entry) {
+            // ★ 活跃状态定期刷新：防止长时间 LLM 调用期间服务端 WebSocket 空闲超时导致 LOST
+            if (status === "thinking" || status === "tool_using" || status === "compacting") {
+                startStatusRefresh(sessionId);
+            }
+            else {
+                stopStatusRefresh(sessionId);
+            }
             const runtimeState = resolveStatusChangeRuntimeState(status, actionInfo);
             entry.currentRuntimeStatus = runtimeState.status;
             // 当新状态未携带动作且进入 thinking 时,保留上一个 idle 类动作(如 poll_message),
@@ -1351,10 +1500,69 @@ function wireSdkAdapterEvents(adapter, definition) {
                         actionInput: entry.currentRuntimeActionInput,
                     }
                     : undefined;
-            void sendStatus(entry.agentId, sessionId, runtimeState.status, restoredActionInfo, resolveStatusChangeUsage(runtimeState.actionInfo), {
-                runtimeAccessToken: entry.runtimeAccessToken,
-                schedulerBaseUrl: entry.schedulerBaseUrl,
-            });
+            // ★ 对 compacting 状态（context_compaction 事件）使用 per-session 序列化队列，
+            //   避免 start/detect/prune/.../end 等事件并发 HTTP POST 导致部分事件丢失。
+            //   DB 证据：所有压缩都只保留了 2-4 个事件（应该有 7 个），根因是并发请求竞争。
+            if (runtimeState.status === "compacting") {
+                const prev = compactionStatusChainBySession.get(sessionId) ?? Promise.resolve();
+                const next = prev.then(async () => {
+                    // ★ 重试机制：HTTP 失败（sendStatus 返回 undefined）时重试，
+                    //   避免因网络超时/瞬时故障导致压缩事件（特别是父 start 事件）永久丢失。
+                    //   scheduleEventPush 是 no-op，HTTP 回调是唯一投递路径，无 fallback。
+                    const maxRetries = 2;
+                    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+                        const response = await sendStatus(entry.agentId, sessionId, runtimeState.status, restoredActionInfo, resolveStatusChangeUsage(runtimeState.actionInfo), {
+                            runtimeAccessToken: entry.runtimeAccessToken,
+                            schedulerBaseUrl: entry.schedulerBaseUrl,
+                        });
+                        if (response !== undefined)
+                            return; // HTTP 成功
+                        if (attempt < maxRetries) {
+                            log.warn(`[${definition.displayName}] compaction sendStatus attempt ${attempt + 1} failed (HTTP), retrying in ${1000 * (attempt + 1)}ms...`);
+                            await new Promise((r) => setTimeout(r, 1000 * (attempt + 1)));
+                        }
+                    }
+                    log.warn(`[${definition.displayName}] compaction sendStatus failed after ${maxRetries + 1} attempts, event may be lost`);
+                }).catch((err) => {
+                    // 链中某次失败不影响后续事件发送
+                    log.warn(`[${definition.displayName}] compaction status chain error:`, err);
+                });
+                compactionStatusChainBySession.set(sessionId, next);
+                // 链结束后清理，避免内存泄漏
+                next.finally(() => {
+                    if (compactionStatusChainBySession.get(sessionId) === next) {
+                        compactionStatusChainBySession.delete(sessionId);
+                    }
+                });
+            }
+            else {
+                // ★ 修复重复时间线条目：当 shouldPreservePrevAction 为 true 且新 actionInfo 为 undefined
+                //   （idle 类型 poll_message 的 tool_use_end status-change 传 undefined）时，
+                //   不传 restoredActionInfo，避免 dashboard 创建第二个"调用MCP"时间线条目。
+                //   tool_use_start 的 status-change 已创建了一个条目，这里只需纯状态变更。
+                const skipRestoredActionInfo = shouldPreservePrevAction && !runtimeState.actionInfo?.actionType;
+                void sendStatus(entry.agentId, sessionId, runtimeState.status, skipRestoredActionInfo ? undefined : restoredActionInfo, resolveStatusChangeUsage(runtimeState.actionInfo), {
+                    runtimeAccessToken: entry.runtimeAccessToken,
+                    schedulerBaseUrl: entry.schedulerBaseUrl,
+                });
+            }
+            // ★ 修复时序竞争：session 稳定到 waiting_input 时，若缓存了 runtime_capabilities
+            //   但尚未被清除（说明第一次发送可能因 runtime_session_id 未及时更新而被服务端丢弃），
+            //   在此重发确保前端最终能收到能力清单。
+            if (runtimeState.status === "waiting_input" &&
+                entry.cachedCapabilitiesActionDetail) {
+                const cachedDetail = entry.cachedCapabilitiesActionDetail;
+                entry.cachedCapabilitiesActionDetail = undefined;
+                console.log(`[${definition.displayName} Adapter] Re-sending cached runtime_capabilities for agent ${entry.agentId} (session stabilized to waiting_input)`);
+                void sendStatus(entry.agentId, sessionId, "waiting_input", {
+                    actionType: "runtime_capabilities",
+                    actionLabel: "运行时能力",
+                    actionDetail: cachedDetail,
+                }, undefined, {
+                    runtimeAccessToken: entry.runtimeAccessToken,
+                    schedulerBaseUrl: entry.schedulerBaseUrl,
+                });
+            }
         }
     });
     adapter.on("ask-user-question", (data) => {
@@ -1364,7 +1572,7 @@ function wireSdkAdapterEvents(adapter, definition) {
             void sendQuestionRequest(entry.agentId, data.sessionId, Array.isArray(data.questions) ? data.questions : [], {
                 runtimeAccessToken: entry.runtimeAccessToken,
                 schedulerBaseUrl: entry.schedulerBaseUrl,
-            });
+            }, data.toolCallId);
         }
     });
     adapter.on("permission-request", (data) => {
@@ -1431,7 +1639,9 @@ async function startSdkSession(req, res) {
     // Per-agent model override（优先于全局配置）
     model: perAgentModel, 
     // Per-instance AI provider 覆盖（仅 ACode 消费；优先级：api > env > file > global）
-    instanceAiConfig: perInstanceAiConfig, } = req.body || {};
+    instanceAiConfig: perInstanceAiConfig, 
+    // Sub Agent 模型/强度覆盖（仅 ACode 消费，空值=继承主 Agent）
+    subAgentModel: perAgentSubAgentModel, subAgentEffort: perAgentSubAgentEffort, } = req.body || {};
     const _dbg = getInstanceAiConfigDebugLogger();
     void _dbg.log({
         level: "info",
@@ -1639,6 +1849,13 @@ async function startSdkSession(req, res) {
             ...(resolvedInstanceAiConfig
                 ? { instanceAiConfig: resolvedInstanceAiConfig }
                 : {}),
+            // Sub Agent 模型/强度覆盖（仅 ACode 消费）
+            ...(typeof perAgentSubAgentModel === "string" && perAgentSubAgentModel.trim()
+                ? { subAgentModel: perAgentSubAgentModel.trim() }
+                : {}),
+            ...(typeof perAgentSubAgentEffort === "string" && perAgentSubAgentEffort.trim()
+                ? { subAgentEffort: perAgentSubAgentEffort.trim() }
+                : {}),
             extraMcpServers: extraMcpServers || {},
             envOverrides: buildRuntimeEnv(String(agentId), String(workspacePath), process.env, effectiveEnvOverrides),
         };
@@ -1693,6 +1910,7 @@ async function startSdkSession(req, res) {
     catch (error) {
         // 同步错误处理（校验失败等）
         if (sessionId) {
+            stopStatusRefresh(sessionId);
             sdkSessions.delete(sessionId);
         }
         if (normalizedAgentId) {
@@ -1784,6 +2002,7 @@ async function startSdkSessionBg(params) {
     }
     catch (error) {
         // 后台启动失败：清理本地状态 + 通知 server
+        stopStatusRefresh(sessionId);
         sdkSessions.delete(sessionId);
         await removePersistedSession(sessionId);
         const errorMessage = error instanceof Error ? error.message : String(error);
@@ -1985,6 +2204,7 @@ terminalRouter.post("/sdk/stop", validateToken, async (req, res) => {
         // 如果有活跃 AI 请求，先立即中止（fire-and-forget），再清理资源
         adapter.abortCurrentTurn(sessionId).catch(() => { });
         await adapter.terminateSession(sessionId);
+        stopStatusRefresh(sessionId);
         sdkSessions.delete(sessionId);
         stopTerminalCommandProcess(sessionId);
         await removePersistedSession(sessionId);
@@ -2036,6 +2256,86 @@ terminalRouter.get("/sdk/status/:sessionId", validateToken, (req, res) => {
         res.status(500).json({ error: errorMessage });
     }
 });
+/**
+ * GET /runtime/sdk/capabilities/:sessionId
+ *
+ * 主动查询会话的运行时能力清单（MCP 工具 + skills）。
+ * 只读 adapter 内存缓存（lastCombinedCapabilities），不触发 runtime 重新探测。
+ * 缓存由 mcp_status / skill_status 事件维护；若尚未收到任何事件则返回 capabilities: null。
+ */
+terminalRouter.get("/sdk/capabilities/:sessionId", validateToken, (req, res) => {
+    const sessionId = req.params.sessionId;
+    if (!sessionId) {
+        res.status(400).json({ error: "sessionId is required" });
+        return;
+    }
+    const entry = sdkSessions.get(sessionId);
+    if (!entry) {
+        res.status(404).json({ error: "SDK session not found" });
+        return;
+    }
+    try {
+        const providerId = entry.providerId || "claude-code";
+        const adapter = adapterRegistry.get(providerId);
+        // 仅 AcodeSdkAdapter 实现 getCapabilities；其他 adapter 返回 undefined
+        const capabilities = adapter.getCapabilities?.(sessionId) ?? null;
+        res.json({
+            ok: true,
+            sessionId,
+            agentId: entry.agentId,
+            capabilities,
+            fetchedAt: Date.now(),
+        });
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        res.status(500).json({ error: errorMessage });
+    }
+});
+/**
+ * 查询会话当前挂起的 ask_user_question（agent 提问）。
+ *
+ * 只读 adapter 内存缓存（pendingQuestionToolCallId + pendingQuestions）。
+ * 用于前端刷新后重建提问 UI：bridge 在 session entry 中保留了最近一次提问的
+ * toolCallId 与 questions 数组，前端刷新后通过此端点取回并重建 directMessages
+ * 与 header 通知。toolCallId 封闭在 bridge 内部，前端无需感知。
+ *
+ * GET /runtime/sdk/pending-questions/:sessionId
+ */
+terminalRouter.get("/sdk/pending-questions/:sessionId", validateToken, (req, res) => {
+    const sessionId = req.params.sessionId;
+    if (!sessionId) {
+        res.status(400).json({ error: "sessionId is required" });
+        return;
+    }
+    const entry = sdkSessions.get(sessionId);
+    if (!entry) {
+        res.status(404).json({ error: "SDK session not found" });
+        return;
+    }
+    try {
+        const providerId = entry.providerId || "claude-code";
+        const adapter = adapterRegistry.get(providerId);
+        // 仅 AcodeSdkAdapter 实现 getPendingQuestion；其他 adapter 返回 undefined
+        const pendingQuestion = adapter.getPendingQuestion?.(sessionId) ?? null;
+        res.json({
+            ok: true,
+            sessionId,
+            agentId: entry.agentId,
+            pendingQuestion: pendingQuestion
+                ? {
+                    toolCallId: pendingQuestion.toolCallId,
+                    questions: pendingQuestion.questions,
+                }
+                : null,
+            fetchedAt: Date.now(),
+        });
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        res.status(500).json({ error: errorMessage });
+    }
+});
 /**
  * 执行当前 Agent 工作目录下的终端命令。
  *
@@ -2240,6 +2540,7 @@ terminalRouter.post("/stop", validateToken, async (req, res) => {
         // 如果有活跃 AI 请求，先立即中止（fire-and-forget），再清理资源
         adapter.abortCurrentTurn(sessionId).catch(() => { });
         await adapter.terminateSession(sessionId);
+        stopStatusRefresh(sessionId);
         sdkSessions.delete(sessionId);
         stopTerminalCommandProcess(sessionId);
         await removePersistedSession(sessionId);
@@ -2290,6 +2591,7 @@ terminalRouter.post("/stop-all", validateToken, async (_req, res) => {
             // 如果有活跃 AI 请求，先立即中止（fire-and-forget），再清理资源
             adapter.abortCurrentTurn(sessionId).catch(() => { });
             await adapter.terminateSession(sessionId);
+            stopStatusRefresh(sessionId);
             sdkSessions.delete(sessionId);
             stopTerminalCommandProcess(sessionId);
             stoppedSdk.push(sessionId);

package/dist/services/acode-package.d.ts

@@ -1,7 +1,14 @@
+/**
+ * 获取 ACode 入口文件路径。
+ * 本地开发模式：直接使用项目下 package/acode/dist/index.js（修改即生效，无需复制）。
+ * 部署模式：~/.aws-bridge/acode/dist/index.js。
+ */
 export declare function getReleasedAcodeEntryPath(): string;
 /**
  * 释放随 bridge 打包的内置 ACode runtime。
- * 主流程：检查 bundled dist -> 复制 dist 与 metadata -> 链接 bridge node_modules，
+ *
+ * 本地开发模式：直接使用项目下 package/acode/dist，跳过复制（修改源码后重新 build 即生效）。
+ * 部署模式：复制 dist 与 metadata 到 ~/.aws-bridge/acode，链接 bridge node_modules，
  * 确保 ACode 无需安装即可被 Adapter 动态加载。
  */
 export declare function ensureAcodePackageReleased(): string | null;

package/dist/services/acode-package.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"acode-package.d.ts","sourceRoot":"","sources":["../../src/services/acode-package.ts"],"names":[],"mappings":"AAyDA,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,GAAG,IAAI,CAwB1D"}
+{"version":3,"file":"acode-package.d.ts","sourceRoot":"","sources":["../../src/services/acode-package.ts"],"names":[],"mappings":"AAqEA;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAMlD;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,GAAG,IAAI,CAgC1D"}

package/dist/services/acode-package.js

@@ -10,8 +10,19 @@ function getBridgePackageRoot() {
 function getBundledAcodeRoot(packageRoot = getBridgePackageRoot()) {
     return path.join(packageRoot, 'package', 'acode');
 }
+/**
+ * 判断当前是否为本地开发模式（从项目源码目录运行）。
+ * 本地开发模式下 bridge packageRoot 下存在 src/ 目录，部署产物只有 dist/。
+ */
+function isLocalDevMode(packageRoot = getBridgePackageRoot()) {
+    return existsSync(path.join(packageRoot, 'src'));
+}
+/**
+ * 部署模式下的 released 根目录：~/.aws-bridge/acode
+ * 与 aws-client-agent-mcp 的 ~/.aws-bridge/mcp 路径保持一致。
+ */
 function getReleasedAcodeRoot() {
-    return path.join(getRuntimeHomeDir(), '.agentswork', 'runtime-bridge', 'packages', 'acode');
+    return path.join(getRuntimeHomeDir(), '.aws-bridge', 'acode');
 }
 function shouldReplaceNodeModulesLink(targetPath) {
     if (!existsSync(targetPath)) {
@@ -48,12 +59,23 @@ function ensureReleasedNodeModules(packageRoot, releasedRoot) {
     rmSync(releasedNodeModules, { recursive: true, force: true });
     symlinkSync(sourceNodeModules, releasedNodeModules, process.platform === 'win32' ? 'junction' : 'dir');
 }
+/**
+ * 获取 ACode 入口文件路径。
+ * 本地开发模式：直接使用项目下 package/acode/dist/index.js（修改即生效，无需复制）。
+ * 部署模式：~/.aws-bridge/acode/dist/index.js。
+ */
 export function getReleasedAcodeEntryPath() {
+    const packageRoot = getBridgePackageRoot();
+    if (isLocalDevMode(packageRoot)) {
+        return path.join(getBundledAcodeRoot(packageRoot), 'dist', 'index.js');
+    }
     return path.join(getReleasedAcodeRoot(), 'dist', 'index.js');
 }
 /**
  * 释放随 bridge 打包的内置 ACode runtime。
- * 主流程：检查 bundled dist -> 复制 dist 与 metadata -> 链接 bridge node_modules，
+ *
+ * 本地开发模式：直接使用项目下 package/acode/dist，跳过复制（修改源码后重新 build 即生效）。
+ * 部署模式：复制 dist 与 metadata 到 ~/.aws-bridge/acode，链接 bridge node_modules，
  * 确保 ACode 无需安装即可被 Adapter 动态加载。
  */
 export function ensureAcodePackageReleased() {
@@ -65,6 +87,12 @@ export function ensureAcodePackageReleased() {
         logger.warn(`[runtime-bridge] 未找到 bundled ACode dist，ACode 启动可能失败: ${bundledEntry}`);
         return null;
     }
+    // 本地开发模式：直接使用项目下 dist，无需复制
+    if (isLocalDevMode(packageRoot)) {
+        logger.info(`[runtime-bridge] ACode 本地开发模式，直接使用项目 dist: ${bundledEntry}`);
+        return bundledEntry;
+    }
+    // 部署模式：复制到 ~/.aws-bridge/acode
     const releasedRoot = getReleasedAcodeRoot();
     const releasedDist = path.join(releasedRoot, 'dist');
     mkdirSync(releasedRoot, { recursive: true });
@@ -77,6 +105,7 @@ export function ensureAcodePackageReleased() {
         }
     }
     ensureReleasedNodeModules(packageRoot, releasedRoot);
-    logger.info(`[runtime-bridge] ACode 已准备: ${getReleasedAcodeEntryPath()}`);
-    return getReleasedAcodeEntryPath();
+    const releasedEntry = path.join(releasedDist, 'index.js');
+    logger.info(`[runtime-bridge] ACode 已准备: ${releasedEntry}`);
+    return releasedEntry;
 }

package/dist/services/agent-event-store.d.ts

@@ -19,6 +19,7 @@ export interface BridgeEventPayload {
     readonly actionInput?: string;
     readonly actionResult?: string;
     readonly actionId?: string;
+    readonly parentId?: string;
     readonly inputTokens?: number;
     readonly outputTokens?: number;
     readonly sourceEventType?: string;

package/dist/services/agent-event-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-event-store.d.ts","sourceRoot":"","sources":["../../src/services/agent-event-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,cAAc,CAAC;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAQD;;;;GAIG;AACH,cAAM,eAAe;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAE9D,OAAO,CAAC,YAAY;IASpB;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,eAAe,CAAC,kBAAkB,CAAC;IAIzF;;;;;OAKG;IACH,mBAAmB,CACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,GAC1B,eAAe,CAAC,kBAAkB,CAAC;IA6BtC;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAG9B;AAED,WAAW;AACX,eAAO,MAAM,eAAe,iBAAwB,CAAC"}
+{"version":3,"file":"agent-event-store.d.ts","sourceRoot":"","sources":["../../src/services/agent-event-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,cAAc,CAAC;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAQD;;;;GAIG;AACH,cAAM,eAAe;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAE9D,OAAO,CAAC,YAAY;IASpB;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,eAAe,CAAC,kBAAkB,CAAC;IAIzF;;;;;OAKG;IACH,mBAAmB,CACjB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,GAC1B,eAAe,CAAC,kBAAkB,CAAC;IA6BtC;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAG9B;AAED,WAAW;AACX,eAAO,MAAM,eAAe,iBAAwB,CAAC"}