aws-runtime-bridge 1.7.32 → 1.7.33

package/dist/index.js

@@ -35,6 +35,7 @@ import { ensureAwsClientAgentMcpReleased } from "./services/aws-client-agent-mcp
 import { ensureStartupConfig } from "./services/startup-config-wizard.js";
 import { handleCliCommand } from "./services/cli-commands.js";
 import { buildGracefulShutdownPlan, shouldCleanupPersistedSessionsOnStartup, } from "./services/runtime-lifecycle-policy.js";
+import { deliverPendingBridgeLifecycleNotifications } from "./services/lifecycle-state.js";
 const cliCommandResult = await handleCliCommand();
 if (cliCommandResult.handled) {
     process.exit(cliCommandResult.exitCode);
@@ -81,6 +82,10 @@ performAutoRegister()
     // 不再默认把该 bridge 下的 Agent 标记为 offline/stopped，避免 server/bridge
     // 短暂重启导致正在运行的 Agent 被误停。
     return performBridgeRestartCleanup();
+})
+    .then(() => deliverPendingBridgeLifecycleNotifications())
+    .then(() => {
+    logger.info("[runtime-bridge] Bridge 生命周期通知同步完成");
 })
     .catch((err) => {
     logger.warn("[runtime-bridge] 自动注册或清理出错:", err);

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

@@ -1 +1 @@
-{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/routes/instance.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAoBrD,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;AAmGvC,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":"AA4BA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAoBrD,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"}

package/dist/routes/instance.js

@@ -11,6 +11,7 @@ import { discoverCcSwitchConfiguredItems, loadCcSwitchSdk } from "../services/cc
 import { syncLegacyStateFromSdk } from "../services/instance-init-service.js";
 import { detectToolStatuses, ensureToolsInstalled, SUPPORTED_INSTALLABLE_TOOLS, SUPPORTED_UNINSTALLABLE_TOOLS, uninstallTools, } from "../services/tool-installer.js";
 import { getConfiguredConnectionKeys, requestRuntimeAccessTokenRefreshForServer } from "../services/auto-register.js";
+import { createBridgeLifecycleOperation, deliverPendingBridgeLifecycleNotifications, upsertBridgeLifecycleOperation, } from "../services/lifecycle-state.js";
 import { createLogger } from "../utils/logger.js";
 const log = createLogger("instance");
 const PANEL_TOOL_STATUS_KEYS = ["claude", "opencode", "codex"];
@@ -56,6 +57,50 @@ function runCommand(command, args) {
         });
     });
 }
+function normalizeOptionalText(value) {
+    const normalized = String(value || "").trim();
+    return normalized || undefined;
+}
+function resolveRequestRuntimeBridgeBaseUrl(req) {
+    const host = req.get("host");
+    if (!host) {
+        return undefined;
+    }
+    return `${req.protocol}://${host}`;
+}
+async function runBridgeUpdateInBackground(input) {
+    const runningOperation = {
+        ...input.operation,
+        status: "running",
+        message: "Bridge 更新正在后台执行。",
+    };
+    await upsertBridgeLifecycleOperation(runningOperation);
+    try {
+        log.info("[update-bridge] 正在后台更新 aws-runtime-bridge 到最新版本");
+        const result = await runCommand(input.command, input.args);
+        const succeeded = result.exitCode === 0;
+        await upsertBridgeLifecycleOperation({
+            ...runningOperation,
+            status: succeeded ? "succeeded" : "failed",
+            message: succeeded
+                ? "Bridge 更新完成，请重启实例 Bridge 以加载新版本。"
+                : `Bridge 更新失败，npm 退出码: ${result.exitCode ?? "unknown"}`,
+            error: succeeded ? undefined : result.stderr || result.stdout,
+        });
+        await deliverPendingBridgeLifecycleNotifications();
+    }
+    catch (error) {
+        const err = error;
+        log.error("[update-bridge] background update failed:", err);
+        await upsertBridgeLifecycleOperation({
+            ...runningOperation,
+            status: "failed",
+            message: "Bridge 更新失败。",
+            error: err.message || "update bridge failed",
+        });
+        await deliverPendingBridgeLifecycleNotifications();
+    }
+}
 async function writeRestartSessionFlag(preserveSessions) {
     const fs = await import("node:fs/promises");
     const path = await import("node:path");
@@ -568,24 +613,29 @@ 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", validateToken, async (req, res) => {
     const command = resolveNpmExecutable();
     const args = ["install", "-g", "aws-runtime-bridge@latest"];
+    const requestedByUserId = normalizeOptionalText(req.body?.requestedByUserId);
     try {
-        log.info("[update-bridge] 正在更新 aws-runtime-bridge 到最新版本");
-        const result = await runCommand(command, args);
-        if (result.exitCode !== 0) {
-            res.status(500).json({
-                ok: false,
-                error: `更新失败，npm 退出码: ${result.exitCode ?? "unknown"}`,
-                result,
-            });
+        if (!requestedByUserId) {
+            res.status(400).json({ error: "requestedByUserId is required" });
             return;
         }
+        const operation = createBridgeLifecycleOperation({
+            operationType: "update",
+            requestedByUserId,
+            schedulerBaseUrl: req.body?.schedulerBaseUrl,
+            runtimeBridgeBaseUrl: resolveRequestRuntimeBridgeBaseUrl(req),
+            status: "accepted",
+            message: "Bridge 更新请求已收到，将在后台执行。",
+        });
+        await upsertBridgeLifecycleOperation(operation);
+        void runBridgeUpdateInBackground({ command, args, operation });
         res.json({
             ok: true,
-            message: "Bridge 更新完成，请重启实例 Bridge 以加载新版本。",
-            result,
+            operationId: operation.operationId,
+            message: "Bridge 更新已在后台开始，完成后会通过消息中心通知结果。",
         });
     }
     catch (error) {
@@ -602,13 +652,28 @@ instanceRouter.post("/update-bridge", validateToken, async (_req, res) => {
  */
 instanceRouter.post("/restart-bridge", validateToken, async (req, res) => {
     const { preserveSessions = true } = req.body || {};
+    const requestedByUserId = normalizeOptionalText(req.body?.requestedByUserId);
     try {
+        if (!requestedByUserId) {
+            res.status(400).json({ error: "requestedByUserId is required" });
+            return;
+        }
         log.info(`[restart-bridge] 收到实例 Bridge 重启请求，preserveSessions=${preserveSessions}`);
+        const operation = createBridgeLifecycleOperation({
+            operationType: "restart",
+            requestedByUserId,
+            schedulerBaseUrl: req.body?.schedulerBaseUrl,
+            runtimeBridgeBaseUrl: resolveRequestRuntimeBridgeBaseUrl(req),
+            status: "accepted",
+            message: "Bridge 已收到重启请求；下次启动后会发送确认通知。",
+        });
+        await upsertBridgeLifecycleOperation(operation);
         await writeRestartSessionFlag(Boolean(preserveSessions));
         res.json({
             ok: true,
+            operationId: operation.operationId,
             preserveSessions: Boolean(preserveSessions),
-            message: "Bridge 正在优雅退出；若实例由 systemd/PM2 等守护管理，将自动重启，否则需要手动重新启动。",
+            message: "Bridge 正在优雅退出；下次启动后会通过消息中心通知结果。若未由守护进程管理，请手动重新启动。",
         });
         setTimeout(() => {
             if (gracefulShutdownFn) {

package/dist/routes/instance.test.js

@@ -7,6 +7,7 @@ const spawnMock = vi.hoisted(() => vi.fn());
 vi.mock('axios', () => ({
     default: {
         get: vi.fn(),
+        post: vi.fn(),
     },
 }));
 vi.mock('../services/auto-register.js', () => ({
@@ -15,6 +16,22 @@ vi.mock('../services/auto-register.js', () => ({
 }));
 vi.mock('../services/runtime-binding.js', () => ({
     getRuntimeAccessToken: vi.fn(() => 'stale-runtime-token-123456'),
+    loadRuntimeBinding: vi.fn(() => ({ status: 'paired', userId: 'user-1', schedulerBaseUrl: 'http://server.local:7380' })),
+    normalizeSchedulerBaseUrl: vi.fn((value) => (value ? String(value).replace(/\/+$/, '') : undefined)),
+}));
+vi.mock('../services/lifecycle-state.js', () => ({
+    createBridgeLifecycleOperation: vi.fn((input) => ({
+        operationId: 'operation-1',
+        requestedAt: '2026-01-01T00:00:00.000Z',
+        updatedAt: '2026-01-01T00:00:00.000Z',
+        ...input,
+    })),
+    deliverPendingBridgeLifecycleNotifications: vi.fn(),
+    upsertBridgeLifecycleOperation: vi.fn(),
+}));
+vi.mock('../config.js', async (importOriginal) => ({
+    ...(await importOriginal()),
+    getRuntimeHomeDir: vi.fn(() => process.cwd()),
 }));
 vi.mock('node:child_process', async (importOriginal) => ({
     ...(await importOriginal()),
@@ -321,34 +338,29 @@ describe('instance route validation', () => {
             hint: expect.stringContaining('AWS_RUNTIME_SCHEDULER_BASE_URL'),
         });
     });
-    it('updates bridge package through npm global install route', async () => {
+    it('starts bridge package update in background and returns operation id', async () => {
         const { instanceRouter } = await import('./instance.js');
         mockSpawnResult(0, 'updated');
         const handler = instanceRouter.stack.find((layer) => layer.route?.path === '/update-bridge')?.route?.stack[1]?.handle;
         expect(handler).toBeTypeOf('function');
         const { json, status } = createMockResponse();
-        await handler?.({}, { json, status }, vi.fn());
-        expect(spawnMock).toHaveBeenCalledWith(process.platform === 'win32' ? 'npm.cmd' : 'npm', ['install', '-g', 'aws-runtime-bridge@latest'], { shell: false, windowsHide: true });
+        await handler?.({ body: { requestedByUserId: 'user-1' }, get: () => 'bridge.local:18081', protocol: 'http' }, { json, status }, vi.fn());
         expect(status).not.toHaveBeenCalled();
-        expect(json).toHaveBeenCalledWith({
+        expect(json).toHaveBeenCalledWith(expect.objectContaining({
             ok: true,
-            message: 'Bridge 更新完成，请重启实例 Bridge 以加载新版本。',
-            result: expect.objectContaining({ exitCode: 0, stdout: 'updated' }),
-        });
+            message: 'Bridge 更新已在后台开始，完成后会通过消息中心通知结果。',
+        }));
+        await new Promise((resolve) => setImmediate(resolve));
+        expect(spawnMock).toHaveBeenCalledWith(process.platform === 'win32' ? 'npm.cmd' : 'npm', ['install', '-g', 'aws-runtime-bridge@latest'], { shell: false, windowsHide: true });
     });
-    it('returns update failure details when npm exits non-zero', async () => {
+    it('rejects background bridge update without requester user id', async () => {
         const { instanceRouter } = await import('./instance.js');
-        mockSpawnResult(1, '', 'permission denied');
         const handler = instanceRouter.stack.find((layer) => layer.route?.path === '/update-bridge')?.route?.stack[1]?.handle;
         expect(handler).toBeTypeOf('function');
         const { json, status } = createMockResponse();
         await handler?.({}, { json, status }, vi.fn());
-        expect(status).toHaveBeenCalledWith(500);
-        expect(json).toHaveBeenCalledWith({
-            ok: false,
-            error: '更新失败，npm 退出码: 1',
-            result: expect.objectContaining({ exitCode: 1, stderr: 'permission denied' }),
-        });
+        expect(status).toHaveBeenCalledWith(400);
+        expect(json).toHaveBeenCalledWith({ error: 'requestedByUserId is required' });
     });
     it('responds before triggering graceful bridge restart', async () => {
         vi.useFakeTimers();
@@ -358,13 +370,13 @@ describe('instance route validation', () => {
         const handler = instanceRouter.stack.find((layer) => layer.route?.path === '/restart-bridge')?.route?.stack[1]?.handle;
         expect(handler).toBeTypeOf('function');
         const { json, status } = createMockResponse();
-        await handler?.({ body: { preserveSessions: true } }, { json, status }, vi.fn());
+        await handler?.({ body: { preserveSessions: true, requestedByUserId: 'user-1' }, get: () => 'bridge.local:18081', protocol: 'http' }, { json, status }, vi.fn());
         expect(status).not.toHaveBeenCalled();
-        expect(json).toHaveBeenCalledWith({
+        expect(json).toHaveBeenCalledWith(expect.objectContaining({
             ok: true,
             preserveSessions: true,
-            message: 'Bridge 正在优雅退出；若实例由 systemd/PM2 等守护管理，将自动重启，否则需要手动重新启动。',
-        });
+            message: 'Bridge 正在优雅退出；下次启动后会通过消息中心通知结果。若未由守护进程管理，请手动重新启动。',
+        }));
         expect(gracefulShutdown).not.toHaveBeenCalled();
         await vi.advanceTimersByTimeAsync(250);
         expect(gracefulShutdown).toHaveBeenCalledWith('PANEL_RESTART', true);

package/dist/services/lifecycle-state.d.ts

@@ -0,0 +1,30 @@
+export type BridgeLifecycleOperationType = "update" | "restart";
+export type BridgeLifecycleOperationStatus = "accepted" | "running" | "succeeded" | "failed" | "startup-confirmed";
+export interface BridgeLifecycleOperation {
+    operationId: string;
+    operationType: BridgeLifecycleOperationType;
+    status: BridgeLifecycleOperationStatus;
+    requestedByUserId: string;
+    requestedAt: string;
+    updatedAt: string;
+    schedulerBaseUrl?: string;
+    runtimeBridgeBaseUrl?: string;
+    message?: string;
+    error?: string;
+}
+export declare function createBridgeLifecycleOperation(input: {
+    operationType: BridgeLifecycleOperationType;
+    requestedByUserId: string;
+    schedulerBaseUrl?: unknown;
+    runtimeBridgeBaseUrl?: unknown;
+    status?: BridgeLifecycleOperationStatus;
+    message?: string;
+}): BridgeLifecycleOperation;
+export declare function upsertBridgeLifecycleOperation(operation: BridgeLifecycleOperation): Promise<void>;
+export declare function removeBridgeLifecycleOperation(operationId: string): Promise<void>;
+/**
+ * 投递 Bridge 生命周期通知。
+ * 主流程：把已完成操作回调调度中心；已接收的操作从本地状态移除，失败则保留待下次启动重试。
+ */
+export declare function deliverPendingBridgeLifecycleNotifications(): Promise<void>;
+//# sourceMappingURL=lifecycle-state.d.ts.map

package/dist/services/lifecycle-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-state.d.ts","sourceRoot":"","sources":["../../src/services/lifecycle-state.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,4BAA4B,GAAG,QAAQ,GAAG,SAAS,CAAC;AAChE,MAAM,MAAM,8BAA8B,GACtC,UAAU,GACV,SAAS,GACT,WAAW,GACX,QAAQ,GACR,mBAAmB,CAAC;AAExB,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,4BAA4B,CAAC;IAC5C,MAAM,EAAE,8BAA8B,CAAC;IACvC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAuCD,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,aAAa,EAAE,4BAA4B,CAAC;IAC5C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,MAAM,CAAC,EAAE,8BAA8B,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,wBAAwB,CAgB3B;AAED,wBAAsB,8BAA8B,CAClD,SAAS,EAAE,wBAAwB,GAClC,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,8BAA8B,CAClD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAKf;AAiCD;;;GAGG;AACH,wBAAsB,0CAA0C,IAAI,OAAO,CAAC,IAAI,CAAC,CA2BhF"}

package/dist/services/lifecycle-state.js

@@ -0,0 +1,110 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import axios from "axios";
+import { getRuntimeHomeDir, resolveSchedulerBaseUrlFrom } from "../config.js";
+import { getRuntimeAccessToken, loadRuntimeBinding, normalizeSchedulerBaseUrl, } from "./runtime-binding.js";
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("bridge-lifecycle");
+function lifecycleStateFile() {
+    return path.join(getRuntimeHomeDir(), ".agentswork", "runtime-bridge", "lifecycle-state.json");
+}
+function normalizeText(value) {
+    const normalized = String(value || "").trim();
+    return normalized || undefined;
+}
+async function loadLifecycleState() {
+    try {
+        const raw = await fs.readFile(lifecycleStateFile(), "utf8");
+        const parsed = JSON.parse(raw);
+        return { operations: Array.isArray(parsed.operations) ? parsed.operations : [] };
+    }
+    catch {
+        return { operations: [] };
+    }
+}
+async function saveLifecycleState(state) {
+    const file = lifecycleStateFile();
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    await fs.writeFile(file, `${JSON.stringify(state, null, 2)}\n`, {
+        encoding: "utf8",
+        mode: 0o600,
+    });
+}
+export function createBridgeLifecycleOperation(input) {
+    const now = new Date().toISOString();
+    const schedulerBaseUrl = normalizeSchedulerBaseUrl(input.schedulerBaseUrl) ||
+        resolveSchedulerBaseUrlFrom(undefined).url;
+    return {
+        operationId: randomUUID(),
+        operationType: input.operationType,
+        status: input.status || "accepted",
+        requestedByUserId: input.requestedByUserId,
+        requestedAt: now,
+        updatedAt: now,
+        schedulerBaseUrl,
+        runtimeBridgeBaseUrl: normalizeText(input.runtimeBridgeBaseUrl),
+        message: input.message,
+    };
+}
+export async function upsertBridgeLifecycleOperation(operation) {
+    const state = await loadLifecycleState();
+    const nextOperations = state.operations.filter((item) => item.operationId !== operation.operationId);
+    nextOperations.push({ ...operation, updatedAt: new Date().toISOString() });
+    await saveLifecycleState({ operations: nextOperations });
+}
+export async function removeBridgeLifecycleOperation(operationId) {
+    const state = await loadLifecycleState();
+    await saveLifecycleState({
+        operations: state.operations.filter((item) => item.operationId !== operationId),
+    });
+}
+function shouldDeliver(operation) {
+    return ["succeeded", "failed", "startup-confirmed"].includes(operation.status);
+}
+async function sendLifecycleNotification(operation) {
+    const schedulerBaseUrl = normalizeSchedulerBaseUrl(operation.schedulerBaseUrl) ||
+        normalizeSchedulerBaseUrl(loadRuntimeBinding().schedulerBaseUrl) ||
+        resolveSchedulerBaseUrlFrom(undefined).url;
+    const token = getRuntimeAccessToken(operation.requestedByUserId, schedulerBaseUrl);
+    if (!token) {
+        throw new Error("runtime access token is missing");
+    }
+    await axios.post(`${schedulerBaseUrl}/api/runtime/callback/bridge-lifecycle`, {
+        operationId: operation.operationId,
+        operationType: operation.operationType,
+        status: operation.status,
+        requestedByUserId: operation.requestedByUserId,
+        message: operation.message,
+        error: operation.error,
+        runtimeBridgeBaseUrl: operation.runtimeBridgeBaseUrl,
+    }, { headers: { "X-Runtime-Token": token } });
+}
+/**
+ * 投递 Bridge 生命周期通知。
+ * 主流程：把已完成操作回调调度中心；已接收的操作从本地状态移除，失败则保留待下次启动重试。
+ */
+export async function deliverPendingBridgeLifecycleNotifications() {
+    const state = await loadLifecycleState();
+    for (const operation of state.operations) {
+        const operationToDeliver = operation.operationType === "restart" && operation.status === "accepted"
+            ? {
+                ...operation,
+                status: "startup-confirmed",
+                message: operation.message || "Bridge 已在收到重启请求后完成本次启动。",
+            }
+            : operation;
+        if (!shouldDeliver(operationToDeliver)) {
+            continue;
+        }
+        try {
+            await sendLifecycleNotification(operationToDeliver);
+            await removeBridgeLifecycleOperation(operation.operationId);
+            log.info(`[bridge-lifecycle] notification delivered: ${operation.operationId}`);
+        }
+        catch (error) {
+            const err = error;
+            log.warn(`[bridge-lifecycle] notification delivery failed: ${operation.operationId}, ${err.message}`);
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aws-runtime-bridge",
-  "version": "1.7.32",
+  "version": "1.7.33",
   "description": "AgentsWorkStudio runtime bridge service for machine-level agent runtime integration",
   "type": "module",
   "main": "dist/index.js",