aws-runtime-bridge 1.3.7 → 1.3.8

package/dist/routes/instance.d.ts

@@ -10,4 +10,17 @@ export declare function buildConnectionCheckResponse(connectionKeyMd5: string):
         error?: string;
     };
 };
+export interface SchedulerPingFailureResponse {
+    ok: false;
+    error: string;
+    failureStage: "scheduler_ping";
+    runtimeBridge: "healthy";
+    schedulerBaseUrl: string;
+    hint: string;
+}
+/**
+ * 构建调度中心 ping 失败响应。
+ * 主流程：保留底层错误与 scheduler 地址，同时明确 bridge 本身已连通、失败点在 bridge 回连调度中心。
+ */
+export declare function buildSchedulerPingFailureResponse(error: Error, configuredSchedulerBaseUrl: string): SchedulerPingFailureResponse;
 //# sourceMappingURL=instance.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/routes/instance.ts"],"names":[],"mappings":"AA6BA,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;AAyBvC,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"}
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/routes/instance.ts"],"names":[],"mappings":"AA6BA,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;AAyBvC,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;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,KAAK,EACZ,0BAA0B,EAAE,MAAM,GACjC,4BAA4B,CAiB9B"}

package/dist/routes/instance.js

@@ -72,6 +72,25 @@ export function buildConnectionCheckResponse(connectionKeyMd5) {
         },
     };
 }
+/**
+ * 构建调度中心 ping 失败响应。
+ * 主流程：保留底层错误与 scheduler 地址，同时明确 bridge 本身已连通、失败点在 bridge 回连调度中心。
+ */
+export function buildSchedulerPingFailureResponse(error, configuredSchedulerBaseUrl) {
+    const trimmedSchedulerBaseUrl = configuredSchedulerBaseUrl.trim();
+    const schedulerUrl = trimmedSchedulerBaseUrl || "http://localhost:8080";
+    const isLocalhostScheduler = /^https?:\/\/(localhost|127\.0\.0\.1)(:\d+)?(?:\/|$)/i.test(schedulerUrl);
+    return {
+        ok: false,
+        error: error.message || "scheduler ping failed",
+        failureStage: "scheduler_ping",
+        runtimeBridge: "healthy",
+        schedulerBaseUrl: schedulerUrl,
+        hint: isLocalhostScheduler
+            ? "aws-runtime-bridge 已连通，但它回连调度中心失败。请在 bridge 启动环境中将 AWS_RUNTIME_SCHEDULER_BASE_URL 配置为该实例可访问的调度中心地址，例如 http://<server-host>:7380。"
+            : "aws-runtime-bridge 已连通，但它回连调度中心失败。请确认 AWS_RUNTIME_SCHEDULER_BASE_URL 指向的调度中心地址可从 bridge 机器访问，并且运行时访问令牌仍有效。",
+    };
+}
 instanceRouter.get("/healthz", (_req, res) => {
     res.json({
         ok: true,
@@ -100,11 +119,9 @@ instanceRouter.get("/ping", validateToken, async (_req, res) => {
     }
     catch (error) {
         const err = error;
-        res.status(502).json({
-            ok: false,
-            error: err?.message || "scheduler ping failed",
-            schedulerBaseUrl,
-        });
+        res
+            .status(502)
+            .json(buildSchedulerPingFailureResponse(err, schedulerBaseUrl));
     }
 });
 instanceRouter.post("/init-instance", validateToken, async (req, res) => {

package/dist/routes/instance.test.js

@@ -98,4 +98,25 @@ describe('instance route validation', () => {
             },
         });
     });
+    it('explains localhost scheduler ping failures with environment variable guidance', async () => {
+        const { buildSchedulerPingFailureResponse } = await import('./instance.js');
+        const response = buildSchedulerPingFailureResponse(new Error('connect ECONNREFUSED 127.0.0.1:8080'), 'http://localhost:8080');
+        expect(response).toEqual({
+            ok: false,
+            error: 'connect ECONNREFUSED 127.0.0.1:8080',
+            failureStage: 'scheduler_ping',
+            runtimeBridge: 'healthy',
+            schedulerBaseUrl: 'http://localhost:8080',
+            hint: expect.stringContaining('AWS_RUNTIME_SCHEDULER_BASE_URL'),
+        });
+        expect(response.hint).toContain('http://<server-host>:7380');
+    });
+    it('explains non-localhost scheduler ping failures as reachability or token issues', async () => {
+        const { buildSchedulerPingFailureResponse } = await import('./instance.js');
+        const response = buildSchedulerPingFailureResponse(new Error('Request failed with status code 401'), 'http://10.0.0.8:7380');
+        expect(response.schedulerBaseUrl).toBe('http://10.0.0.8:7380');
+        expect(response.failureStage).toBe('scheduler_ping');
+        expect(response.runtimeBridge).toBe('healthy');
+        expect(response.hint).toContain('运行时访问令牌仍有效');
+    });
 });

package/package.json

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