aws-runtime-bridge 1.9.2 → 1.9.6

package/dist/routes/instance.d.ts

@@ -6,6 +6,7 @@ export declare function buildConnectionCheckResponse(connectionKeyMd5: string):
     body: {
         ok: boolean;
         runtimeBridge?: "healthy";
+        version: string;
         connectionKeyMatched: boolean;
         connectionKeyRequired: boolean;
         error?: string;

package/dist/routes/instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/routes/instance.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAqBrD,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAC/D,IAAI,CAEN;AAED,eAAO,MAAM,cAAc,4CAAW,CAAC;AAsJvC,wBAAgB,4BAA4B,CAAC,gBAAgB,EAAE,MAAM,GAAG;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE;QACJ,EAAE,EAAE,OAAO,CAAC;QACZ,aAAa,CAAC,EAAE,SAAS,CAAC;QAC1B,oBAAoB,EAAE,OAAO,CAAC;QAC9B,qBAAqB,EAAE,OAAO,CAAC;QAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAqCA;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,gBAAgB,CAAC;IAC/B,aAAa,EAAE,SAAS,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,iCAAiC;IACzC,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,8BAA8B,CAAC;IACtC,YAAY,EAAE,gBAAgB,CAAC;IAC/B,aAAa,EAAE,SAAS,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,KAAK,EACZ,0BAA0B,EAAE,MAAM,GACjC,4BAA4B,CAiB9B;AAoDD;;;GAGG;AACH,wBAAgB,sCAAsC,CACpD,UAAU,EAAE,MAAM,EAAE,GACnB,iCAAiC,CAUnC;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAQhF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,cAAc,EAAE,MAAM,EAAE,EACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAC5C,MAAM,CAaR;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAC5C,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,OAAO,CAAC,CAAC,CAY3F"}
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/routes/instance.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAqBrD,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAC/D,IAAI,CAEN;AAED,eAAO,MAAM,cAAc,4CAAW,CAAC;AAsJvC,wBAAgB,4BAA4B,CAAC,gBAAgB,EAAE,MAAM,GAAG;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE;QACJ,EAAE,EAAE,OAAO,CAAC;QACZ,aAAa,CAAC,EAAE,SAAS,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAC;QAChB,oBAAoB,EAAE,OAAO,CAAC;QAC9B,qBAAqB,EAAE,OAAO,CAAC;QAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAyCA;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,gBAAgB,CAAC;IAC/B,aAAa,EAAE,SAAS,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,iCAAiC;IACzC,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,8BAA8B,CAAC;IACtC,YAAY,EAAE,gBAAgB,CAAC;IAC/B,aAAa,EAAE,SAAS,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,KAAK,EACZ,0BAA0B,EAAE,MAAM,GACjC,4BAA4B,CAiB9B;AAoDD;;;GAGG;AACH,wBAAgB,sCAAsC,CACpD,UAAU,EAAE,MAAM,EAAE,GACnB,iCAAiC,CAUnC;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAQhF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,cAAc,EAAE,MAAM,EAAE,EACxB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAC5C,MAAM,CAaR;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAC5C,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,OAAO,CAAC,CAAC,CAY3F"}

package/dist/routes/instance.js

@@ -2,8 +2,8 @@ import { Router } from "express";
 import axios from "axios";
 import { spawn } from "node:child_process";
 import { createHash, timingSafeEqual } from "node:crypto";
-import { resolveSchedulerBaseUrlFrom } from "../config.js";
-import { validateToken } from "../middleware/auth.js";
+import { getBridgeVersion, resolveSchedulerBaseUrlFrom } from "../config.js";
+import { validateToken, validateTokenOrPanelSession } from "../middleware/auth.js";
 import { getConfiguredConnectionKeys, requestRuntimeAccessTokenRefreshForServer } from "../services/auto-register.js";
 import { discoverCcSwitchConfiguredItems, loadCcSwitchSdk } from "../services/cc-switch-sdk.js";
 import { initInstance, syncLegacyStateFromSdk } from "../services/instance-init-service.js";
@@ -143,12 +143,14 @@ function hasMatchingConnectionKeyDigest(connectionKeyMd5) {
 export function buildConnectionCheckResponse(connectionKeyMd5) {
     const configuredConnectionKeys = getConfiguredConnectionKeys();
     const connectionKeyRequired = configuredConnectionKeys.length > 0;
+    const version = getBridgeVersion();
     if (!connectionKeyRequired) {
         return {
             status: 200,
             body: {
                 ok: true,
                 runtimeBridge: "healthy",
+                version,
                 connectionKeyMatched: true,
                 connectionKeyRequired: false,
             },
@@ -160,6 +162,7 @@ export function buildConnectionCheckResponse(connectionKeyMd5) {
             body: {
                 ok: true,
                 runtimeBridge: "healthy",
+                version,
                 connectionKeyMatched: true,
                 connectionKeyRequired: true,
             },
@@ -170,6 +173,7 @@ export function buildConnectionCheckResponse(connectionKeyMd5) {
         body: {
             ok: false,
             error: "connection_key_mismatch",
+            version,
             connectionKeyMatched: false,
             connectionKeyRequired: true,
         },
@@ -279,6 +283,50 @@ export function summarizeToolStatus(toolStatus) {
         },
     ]));
 }
+/**
+ * GET /runtime/check-update
+ *
+ * 查询 npm registry 获取 aws-runtime-bridge 的最新版本并和当前版本比较。
+ * 使用 5 分钟内存缓存减少对 npm registry 的请求。
+ */
+let updateCheckCache = null;
+const UPDATE_CHECK_CACHE_TTL = 300_000; // 5 分钟
+async function fetchLatestNpmVersion() {
+    const response = await axios.get("https://registry.npmjs.org/aws-runtime-bridge/latest", { timeout: 10_000, responseType: "json" });
+    const data = response.data;
+    return data?.version || "unknown";
+}
+instanceRouter.get("/check-update", async (_req, res) => {
+    try {
+        let latestVersion;
+        if (updateCheckCache && Date.now() - updateCheckCache.ts < UPDATE_CHECK_CACHE_TTL) {
+            latestVersion = updateCheckCache.latestVersion;
+        }
+        else {
+            latestVersion = await fetchLatestNpmVersion();
+            updateCheckCache = { latestVersion, ts: Date.now() };
+        }
+        const currentVersion = getBridgeVersion();
+        const hasUpdate = latestVersion !== "unknown" && currentVersion !== "unknown" && latestVersion !== currentVersion;
+        res.json({
+            ok: true,
+            hasUpdate,
+            currentVersion,
+            latestVersion,
+        });
+    }
+    catch (error) {
+        const err = error;
+        log.warn("[check-update] Failed to query npm registry:", err.message);
+        res.json({
+            ok: false,
+            hasUpdate: false,
+            currentVersion: getBridgeVersion(),
+            latestVersion: null,
+            error: err.message || "failed to check for updates",
+        });
+    }
+});
 instanceRouter.get("/healthz", (_req, res) => {
     res.json({
         ok: true,
@@ -309,6 +357,7 @@ instanceRouter.get("/ping", validateToken, async (req, res) => {
         res.json({
             ok: true,
             runtimeBridge: "healthy",
+            version: getBridgeVersion(),
             schedulerReachable: schedulerPing.schedulerReachable,
             tokenRefreshed: schedulerPing.tokenRefreshed,
             schedulerBaseUrl,
@@ -612,7 +661,7 @@ instanceRouter.post("/prepare-restart", validateToken, async (req, res) => {
  * 通过当前 Bridge 进程执行全局 npm 包更新，等价于 CLI 的
  * `awsb update`，用于面板上的“更新实例 Bridge”。
  */
-instanceRouter.post("/update-bridge", validateToken, async (req, res) => {
+instanceRouter.post("/update-bridge", validateTokenOrPanelSession, async (req, res) => {
     const command = resolveNpmExecutable();
     const args = ["install", "-g", "aws-runtime-bridge@latest"];
     const requestedByUserId = normalizeOptionalText(req.body?.requestedByUserId);
@@ -649,7 +698,7 @@ instanceRouter.post("/update-bridge", validateToken, async (req, res) => {
  * 写入保留会话标记后优雅关闭当前 Bridge 进程。真正的重新拉起由
  * systemd、PM2、Docker 外部守护或用户手动启动完成。
  */
-instanceRouter.post("/restart-bridge", validateToken, async (req, res) => {
+instanceRouter.post("/restart-bridge", validateTokenOrPanelSession, async (req, res) => {
     const { preserveSessions = true } = req.body || {};
     const requestedByUserId = normalizeOptionalText(req.body?.requestedByUserId);
     try {

package/dist/routes/instance.test.js

@@ -216,6 +216,7 @@ describe('instance route validation', () => {
             body: {
                 ok: true,
                 runtimeBridge: 'healthy',
+                version: expect.any(String),
                 connectionKeyMatched: true,
                 connectionKeyRequired: false,
             },
@@ -233,6 +234,7 @@ describe('instance route validation', () => {
             body: {
                 ok: false,
                 error: 'connection_key_mismatch',
+                version: expect.any(String),
                 connectionKeyMatched: false,
                 connectionKeyRequired: true,
             },
@@ -287,6 +289,7 @@ describe('instance route validation', () => {
         expect(json).toHaveBeenCalledWith({
             ok: true,
             runtimeBridge: 'healthy',
+            version: expect.any(String),
             schedulerReachable: true,
             tokenRefreshed: true,
             schedulerBaseUrl: 'http://localhost:8080',
@@ -314,6 +317,7 @@ describe('instance route validation', () => {
         expect(json).toHaveBeenCalledWith({
             ok: true,
             runtimeBridge: 'healthy',
+            version: expect.any(String),
             schedulerReachable: true,
             tokenRefreshed: false,
             schedulerBaseUrl: 'http://server.local:7380',

package/dist/routes/processes.js

@@ -28,7 +28,7 @@ processesRouter.get('/processes', validateToken, async (_req, res) => {
             .filter(r => r.pid > 0)
             .map(r => ({ agentId: r.agentId, pid: r.pid }));
         // 全局发现：扫描全机进程 + 对比注册表
-        const discovered = discoverAllProcessesFull(registryExport);
+        const discovered = await discoverAllProcessesFull(registryExport);
         // 补充 sessionId 信息
         const enriched = discovered.map(d => {
             const record = registryRecords.find(r => r.pid === d.pid || r.agentId === d.agentId);

package/dist/routes/runtime-binding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-binding.d.ts","sourceRoot":"","sources":["../../src/routes/runtime-binding.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,oBAAoB,4CAAW,CAAC;AAE7C,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,wBAAwB,GAC9B,yBAAyB,CAM3B;AAgPD,wBAAgB,6BAA6B,IAAI,IAAI,CAapD"}
+{"version":3,"file":"runtime-binding.d.ts","sourceRoot":"","sources":["../../src/routes/runtime-binding.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,oBAAoB,4CAAW,CAAC;AAE7C,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,wBAAwB,GAC9B,yBAAyB,CAM3B;AAqPD,wBAAgB,6BAA6B,IAAI,IAAI,CAapD"}

package/dist/routes/runtime-binding.js

@@ -1,4 +1,6 @@
+import axios from "axios";
 import { Router } from "express";
+import { getConfiguredConnectionKeys } from "../services/auto-register.js";
 import { validateToken } from "../middleware/auth.js";
 import { claimMcpLaunchBinding, getLatestAgentToken, getMcpLaunchQueueSize } from "../services/mcp-launch-binding-queue.js";
 import { clearRuntimeBinding, getRuntimeAccessToken, getRuntimeBindingPublicState, getRuntimePairingCode, hasRuntimeBinding, saveRuntimeBinding, validateRuntimeBindingToken, validateRuntimePairingCode, } from "../services/runtime-binding.js";
@@ -120,6 +122,10 @@ runtimeBindingRouter.post("/binding/claim-agent", (req, res) => {
         });
         return;
     }
+    // ★ 通知调度中心：McpNode 已领取启动绑定（fire-and-forget，不阻塞响应）
+    notifySchedulerBindingClaimed(claimed.agentId, claimed.schedulerBaseUrl).catch(() => {
+        // 通知失败不影响 MCP node 的 claim 响应
+    });
     res.json({
         ok: true,
         agentId: claimed.agentId,
@@ -221,3 +227,34 @@ export function logRuntimeBindingStartupState() {
     log.info("[runtime-bridge] bridge is unpaired; sensitive APIs will reject requests until paired");
     log.info(`[runtime-bridge] pairing code: ${getRuntimePairingCode()}`);
 }
+/**
+ * Fire-and-forget: 通知调度中心 McpNode 已领取启动绑定。
+ * 主流程：claimMcpLaunchBinding 成功后异步调用此函数，不阻塞 MCP node 的 claim 响应。
+ */
+async function notifySchedulerBindingClaimed(agentId, schedulerBaseUrl) {
+    if (!schedulerBaseUrl) {
+        log.debug(`[runtime-binding] notifySchedulerBindingClaimed skipped: no schedulerBaseUrl for agentId=${agentId}`);
+        return;
+    }
+    const connectionKeys = getConfiguredConnectionKeys();
+    const runtimeToken = connectionKeys[0];
+    if (!runtimeToken) {
+        log.warn(`[runtime-binding] notifySchedulerBindingClaimed skipped: no connection key for agentId=${agentId}`);
+        return;
+    }
+    const url = `${schedulerBaseUrl.replace(/\/+$/, "")}/api/runtime/bridge/binding-claimed`;
+    try {
+        await axios.post(url, { agentId }, {
+            headers: {
+                "X-Runtime-Token": runtimeToken,
+                "Content-Type": "application/json",
+            },
+            timeout: 5000,
+        });
+        log.debug(`[runtime-binding] Notified scheduler: agentId=${agentId}, url=${url}`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        log.warn(`[runtime-binding] Failed to notify scheduler binding claimed: agentId=${agentId}, error=${message}`);
+    }
+}

package/dist/routes/sessions.js

@@ -120,7 +120,7 @@ sessionsRouter.post('/sessions/recover', validateToken, async (req, res) => {
         }
         else if (persistedSession?.mode === 'sdk' || !persistedSession?.pid) {
             // SDK 模式或无 PID，尝试通过 agentId 查找孤儿进程
-            const orphanProcess = findOrphanProcessByAgentId(agentId);
+            const orphanProcess = await findOrphanProcessByAgentId(agentId);
             if (orphanProcess) {
                 orphanDetected = true;
                 orphanPid = orphanProcess.pid;
@@ -200,8 +200,8 @@ sessionsRouter.post('/search-orphan', validateToken, async (req, res) => {
         // 1. 首先检查 runtime-bridge 是否已经有活跃 SDK 会话
         const activeSdkSession = Array.from(sdkSessions.entries()).find(([, s]) => s.agentId === agentId);
         const hasActiveSession = activeSdkSession;
-        // 2. 搜索标记了该 agentId 的进程（命令�?+ 环境变量 + 进程树匹配）
-        const orphanProcess = findOrphanProcessByAgentId(agentId);
+        // 2. 搜索标记了该 agentId 的进程（命令 + 环境变量 + 进程树匹配）
+        const orphanProcess = await findOrphanProcessByAgentId(agentId);
         // 3. 如果找到残留进程，返回进程信�?
         if (orphanProcess) {
             log.info(`[search-orphan] Found orphan process for agentId=${agentId}, pid=${orphanProcess.pid}`);
@@ -242,7 +242,7 @@ sessionsRouter.post('/search-orphan', validateToken, async (req, res) => {
         // 前端传递的 workspacePath，或者从持久化会话中获取
         const searchWorkspace = workspacePath || persistedSession?.workspacePath;
         if (searchWorkspace) {
-            const workspaceOrphan = findOrphanProcessByWorkspace(searchWorkspace);
+            const workspaceOrphan = await findOrphanProcessByWorkspace(searchWorkspace);
             if (workspaceOrphan) {
                 log.info(`[search-orphan] Found orphan by workspace: agentId=${agentId}, pid=${workspaceOrphan.pid}, workspace=${searchWorkspace}`);
                 res.json({
@@ -467,7 +467,7 @@ sessionsRouter.post('/takeover-session', validateToken, async (req, res) => {
         let isProcessAlive = false;
         if (persistedSession.mode === 'sdk') {
             // 对于SDK模式，尝试通过agentId查找进程
-            const orphanProcess = findOrphanProcessByAgentId(agentId);
+            const orphanProcess = await findOrphanProcessByAgentId(agentId);
             isProcessAlive = !!orphanProcess;
             if (!isProcessAlive && persistedSession.pid) {
                 // 如果通过agentId没找到，尝试通过PID检�?
@@ -490,7 +490,7 @@ sessionsRouter.post('/takeover-session', validateToken, async (req, res) => {
         // 如果是SDK模式，检查是否已经有活跃的SDK会话（bridge重启后可能丢失）
         if (persistedSession.mode === 'sdk') {
             // 尝试通过进程检测找到实际的SDK进程
-            const orphanProcess = findOrphanProcessByAgentId(agentId);
+            const orphanProcess = await findOrphanProcessByAgentId(agentId);
             if (orphanProcess) {
                 log.info(`[takeover-session] Found SDK process for agentId=${agentId}, pid=${orphanProcess.pid}`);
                 // �?重要：SDK模式下，进程仍在运行，但bridge的内存中可能没有sdkSessions记录
@@ -582,7 +582,7 @@ sessionsRouter.post('/terminate-tree', validateToken, async (req, res) => {
             res.status(404).json({ error: 'PID not found' });
             return;
         }
-        const result = terminateProcessTree(pid);
+        const result = await terminateProcessTree(pid);
         // 4. 等待进程完全终止（最多 5 秒）
         const exited = await waitForProcessExit(pid, 5000);
         // 5. 清理持久化状�?

package/dist/routes/terminal.d.ts.map

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

package/dist/routes/terminal.js

@@ -11,6 +11,7 @@ import path from "node:path";
 import { TextDecoder } from "node:util";
 import { Router } from "express";
 import { v4 as uuidv4 } from "uuid";
+import axios from "axios";
 import { adapterRegistry, getToolActionInfo, isTransientClipboardPasteFilePath, redactTransientClipboardPastePaths, registerSdkProviders, resolveSdkProviderIdByCommand, } from "../adapter/index.js";
 import { validateToken } from "../middleware/auth.js";
 import { getAgentProcessManager } from "../services/agent-process-manager.js";
@@ -19,6 +20,7 @@ import { enqueueMcpLaunchBinding } from "../services/mcp-launch-binding-queue.js
 import { findClaudeCodeProcesses, isProcessRunning, } from "../services/process-detector.js";
 import { sendOutput, sendQuestionRequest, sendStatus, } from "../services/session-output.js";
 import { findPersistedSessionByAgentId, removePersistedSession, savePersistedSessions, updatePersistedSessionAutoCommands, updatePersistedSessionRuntimeState, upsertPersistedSession, } from "../services/terminal-persistence.js";
+import { logger as log } from "../utils/logger.js";
 export const terminalRouter = Router();
 // 导出 SDK 会话存储，供其他模块使用（如 sessions.ts）
 export const sdkSessions = new Map();
@@ -1033,8 +1035,14 @@ terminalRouter.post("/start", validateToken, async (req, res) => {
     await startSdkSession(req, res);
 });
 /**
- * 启动 SDK 会话
- * 支持 MCP 配置和空闲命令
+ * 启动 SDK 会话（两阶段架构）
+ *
+ * 主流程：
+ * 1. Phase 1（同步，快）：校验 → 创建会话记录 → 立即响应（status=starting）
+ * 2. Phase 2（后台异步，慢）：SDK 进程启动 → PID 探测 → 持久化 → 通知 server 会话就绪
+ *
+ * 此架构确保 bridge HTTP 响应不等待 SDK 子进程初始化，
+ * 前端可在数百毫秒内收到响应，实时展示启动进度。
  */
 async function startSdkSession(req, res) {
     const { agentId, workspacePath, command, autoAccept = true, initialPrompt, 
@@ -1090,7 +1098,6 @@ async function startSdkSession(req, res) {
         // 根据命令选择对应的 adapter
         const normalizedCommand = (command || "acode").toLowerCase();
         const providerId = resolveSdkProviderId(command);
-        // ★ 特征日志：明确输出选择的 provider
         console.log(`[Runtime] ★★★ SDK启动 ★★★ command="${command}", normalizedCommand="${normalizedCommand}", providerId="${providerId}"`);
         const adapter = adapterRegistry.get(providerId);
         sessionId = uuidv4();
@@ -1123,9 +1130,58 @@ async function startSdkSession(req, res) {
             runtimeAccessToken,
             schedulerBaseUrl: requestedSchedulerBaseUrl,
         });
-        // 启动 SDK 会话
+        // ★ Phase 1：立即响应（不等待 SDK 进程启动）
+        res.json({
+            sessionId,
+            status: "starting",
+            runtimeStatus: "starting",
+            agentId: normalizedAgentId,
+            workspacePath,
+            command: config.command,
+            mode: "sdk",
+        });
+        // ★ Phase 2：后台异步启动 SDK 进程 + 后处理
+        startSdkSessionBg({
+            sessionId,
+            agentId: normalizedAgentId,
+            config,
+            adapter,
+            providerId,
+            idleInputAutoCommand,
+            nonInputAutoCommand,
+            runtimeAccessToken,
+            requestedSchedulerBaseUrl,
+        });
+    }
+    catch (error) {
+        // 同步错误处理（校验失败等）
+        if (sessionId) {
+            sdkSessions.delete(sessionId);
+        }
+        if (normalizedAgentId) {
+            startingAgents.delete(normalizedAgentId);
+        }
+        if (!res.headersSent) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            res
+                .status(500)
+                .json({ error: `Failed to start SDK session: ${errorMessage}` });
+        }
+    }
+}
+/**
+ * Phase 2：后台异步启动 SDK 进程，完成后通知 server。
+ *
+ * 主流程：adapter.startSession（SDK 进程启动）→ 空闲命令注入 → PID 探测
+ * → 持久化会话 → 注册进程管理 → 通知 server 状态为 running
+ * → finally 清理 startingAgents 锁
+ */
+async function startSdkSessionBg(params) {
+    const { sessionId, agentId, config, adapter, providerId, idleInputAutoCommand, nonInputAutoCommand, runtimeAccessToken, requestedSchedulerBaseUrl, } = params;
+    try {
+        // 启动 SDK 会话（真正的耗时操作）
         await adapter.startSession(sessionId, config);
-        // 尽早注入空闲命令，避免后续 PID 探测/进程注册延迟 poll_message 空闲轮询。
+        // 尽早注入空闲命令
         if (idleInputAutoCommand || nonInputAutoCommand) {
             adapter.setIdleCommands?.(sessionId, {
                 idleInputCommand: idleInputAutoCommand || "",
@@ -1133,21 +1189,16 @@ async function startSdkSession(req, res) {
             });
         }
         // ★ 尝试获取 SDK 进程的 PID（用于孤儿进程检测）
-        // SDK 不直接暴露 PID，通过进程检测服务查找匹配的进程
         let sdkPid;
         if (shouldProbeSdkProcessPid(providerId)) {
             try {
-                // 等待一小段时间让进程启动
                 await new Promise((resolve) => setTimeout(resolve, 500));
-                // 尝试通过 adapter 获取 PID（如果支持）
                 sdkPid = adapter.getSessionPid?.(sessionId);
-                // 如果 adapter 不支持，尝试通过进程检测服务查找
                 if (!sdkPid) {
-                    const processes = findClaudeCodeProcesses();
-                    // 查找匹配 agentId 或工作目录的进程
+                    const processes = await findClaudeCodeProcesses();
                     const matched = processes.find((p) => p.agentId === agentId ||
-                        p.cwd === workspacePath ||
-                        p.command.includes(workspacePath));
+                        p.cwd === config.workingDirectory ||
+                        p.command.includes(config.workingDirectory));
                     if (matched) {
                         sdkPid = matched.pid;
                         console.log(`[Runtime] Found SDK process PID: ${sdkPid} for agentId=${agentId}`);
@@ -1163,7 +1214,7 @@ async function startSdkSession(req, res) {
         await upsertPersistedSession({
             sessionId,
             agentId,
-            workspacePath,
+            workspacePath: config.workingDirectory,
             command: config.command,
             startedAt: new Date().toISOString(),
             status: "running",
@@ -1176,39 +1227,92 @@ async function startSdkSession(req, res) {
         if (sdkPid) {
             const processManager = getAgentProcessManager();
             await processManager.startProcess({
-                agentId: normalizedAgentId,
+                agentId,
                 sessionId,
                 pid: sdkPid,
                 mode: "sdk",
-                workspacePath,
+                workspacePath: config.workingDirectory,
                 command: config.command,
             });
         }
-        res.json({
+        // ★ 通知 server 会话已就绪
+        await notifyServerSessionReady({
+            agentId,
             sessionId,
+            sdkPid,
             status: startedStatus,
-            runtimeStatus: startedStatus,
-            agentId,
-            workspacePath,
-            command: config.command,
-            mode: "sdk",
-            pid: sdkPid, // ★ 返回 PID 信息
+            schedulerBaseUrl: requestedSchedulerBaseUrl,
+            runtimeAccessToken,
         });
     }
     catch (error) {
-        if (sessionId) {
-            sdkSessions.delete(sessionId);
-            await removePersistedSession(sessionId);
-        }
+        // 后台启动失败：清理本地状态 + 通知 server
+        sdkSessions.delete(sessionId);
+        await removePersistedSession(sessionId);
         const errorMessage = error instanceof Error ? error.message : String(error);
-        res
-            .status(500)
-            .json({ error: `Failed to start SDK session: ${errorMessage}` });
+        console.error(`[Runtime] Background SDK session startup failed for agentId=${agentId}: ${errorMessage}`);
+        await notifyServerSessionFailed({
+            agentId,
+            sessionId,
+            schedulerBaseUrl: requestedSchedulerBaseUrl,
+            runtimeAccessToken,
+            errorMessage,
+        });
     }
     finally {
-        if (normalizedAgentId) {
-            startingAgents.delete(normalizedAgentId);
-        }
+        startingAgents.delete(agentId);
+    }
+}
+/**
+ * 通知调度中心 SDK 会话已完全就绪。
+ * 主流程：Phase 2 完成后调用，复用 /callback/status 端点更新状态为 running。
+ * Fire-and-forget 风格，失败不影响 bridge 自身状态。
+ */
+async function notifyServerSessionReady(params) {
+    const { agentId, sessionId, sdkPid, status, schedulerBaseUrl, runtimeAccessToken } = params;
+    if (!schedulerBaseUrl || !runtimeAccessToken) {
+        log.debug(`[Runtime] notifyServerSessionReady skipped: missing schedulerBaseUrl or runtimeAccessToken for agentId=${agentId}`);
+        return;
+    }
+    const url = `${schedulerBaseUrl.replace(/\/+$/, "")}/api/runtime/callback/status`;
+    try {
+        await axios.post(url, { agentId, sessionId, status, pid: sdkPid }, {
+            headers: {
+                "X-Runtime-Token": runtimeAccessToken,
+                "Content-Type": "application/json",
+            },
+            timeout: 5000,
+        });
+        log.debug(`[Runtime] Notified server session ready: agentId=${agentId}, sessionId=${sessionId}, status=${status}`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        log.warn(`[Runtime] Failed to notify server session ready: agentId=${agentId}, error=${message}`);
+    }
+}
+/**
+ * 通知调度中心 SDK 会话启动失败。
+ * 主流程：Phase 2 catch 块调用，复用 /callback/status 端点更新状态为 stopped。
+ */
+async function notifyServerSessionFailed(params) {
+    const { agentId, sessionId, schedulerBaseUrl, runtimeAccessToken } = params;
+    if (!schedulerBaseUrl || !runtimeAccessToken) {
+        return;
+    }
+    const url = `${schedulerBaseUrl.replace(/\/+$/, "")}/api/runtime/callback/status`;
+    try {
+        await axios.post(url, { agentId, sessionId, status: "stopped" }, {
+            headers: {
+                "X-Runtime-Token": runtimeAccessToken,
+                "Content-Type": "application/json",
+            },
+            timeout: 5000,
+        });
+        log.debug(`[Runtime] Notified server session failed: agentId=${agentId}, sessionId=${sessionId}`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        log.warn(`[Runtime] Failed to notify server session failed: agentId=${agentId}, error=${message}`);
     }
 }
 // ============ SDK 专用路由 ============

package/dist/services/agent-process-manager.d.ts

@@ -209,6 +209,18 @@ export declare class AgentProcessManager {
      * @returns Statistics for all managed processes
      */
     getStats(): Record<ProcessState | 'total', number>;
+    /**
+     * Clean up stale registry entries
+     *
+     * Removes records where:
+     * - state is 'terminated' or 'unknown'
+     * - the process is no longer running
+     *
+     * This prevents dead entries from accumulating and inflating counts.
+     *
+     * @returns Number of entries removed
+     */
+    cleanupStaleRegistry(): Promise<number>;
     /**
      * Remove a process from registry
      *

package/dist/services/agent-process-manager.d.ts.map

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