@sema-agent/server 5.12.0 → 5.13.0

package/dist/fleet-client.js

@@ -103,6 +103,18 @@ export class FleetUsageAccumulator {
         return this.cells.size;
     }
 }
+/** #123 F1 披露半场(§M):center 的拒绝响应体是操作员唯一的自诊线索(E2E #121:web 端明说了
+ *  「address must be a parseable http(s) base URL」而 server 日志只有 `announce 400`)——摘要进错误
+ *  信息(cap 200 字符);读体失败不改变结果面(照旧只有状态码)。 */
+async function rejectionSnippet(res) {
+    try {
+        const text = (await res.text()).slice(0, 200).trim();
+        return text ? ` — center said: ${text}` : "";
+    }
+    catch {
+        return "";
+    }
+}
 /**
  * Start the worker-side fleet loops. Caller has already gated on "center configured ∧ advertise address set"
  * (startFleetClientFromEnv below) — this function assumes a complete opts.
@@ -131,7 +143,7 @@ export function startFleetClient(opts) {
             // 半开连接钉住;心跳侧每 tick 叠一个在飞请求。
             const res = await f(`${base}/api/fleet/instances`, { method: "POST", headers, body: JSON.stringify(body), signal: AbortSignal.timeout(FLEET_CLIENT_FETCH_TIMEOUT_MS) });
             if (!res.ok)
-                throw new Error(`announce ${res.status}`);
+                throw new Error(`announce ${res.status}${await rejectionSnippet(res)}`);
             if (failStreak > 0)
                 opts.logger?.info("fleet_announce_recovered", { after: failStreak });
             failStreak = 0;
@@ -156,7 +168,7 @@ export function startFleetClient(opts) {
         try {
             const res = await f(`${base}/api/fleet/usage`, { method: "POST", headers, body: JSON.stringify({ reports: [report] }), signal: AbortSignal.timeout(FLEET_CLIENT_FETCH_TIMEOUT_MS) });
             if (!res.ok)
-                throw new Error(`usage ${res.status}`);
+                throw new Error(`usage ${res.status}${await rejectionSnippet(res)}`);
         }
         catch (err) {
             // Delivery failed → the window was never recorded center-side; carry the amounts forward (no loss, no double).
@@ -196,6 +208,19 @@ export function startFleetClientFromEnv(cfg, opts) {
     const address = opts.advertiseAddress ?? process.env.FLEET_ADVERTISE_ADDRESS;
     if (!cc?.baseUrl || !cc.token || !address)
         return undefined;
+    // #123 F1(E2E #121 立案):旋钮**设了但坏形** ≠ 没设——center 端要求可解析的 http(s) base URL,
+    // 坏形(如缺 scheme 的 host:port)此前静默通过,启动后 fleet 腿每拍 announce 400、worker 永不注册。
+    // env fail-loud 族判据([2443] A1 同族):这里前置响亮拒,部署在起点就失败可见,而不是带病运行。
+    let parsed;
+    try {
+        parsed = new URL(address);
+    }
+    catch {
+        parsed = undefined;
+    }
+    if (parsed === undefined || (parsed.protocol !== "http:" && parsed.protocol !== "https:")) {
+        throw new Error(`FLEET_ADVERTISE_ADDRESS must be a parseable http(s) base URL (e.g. "http://10.0.0.5:8090"); got "${address}" — the fleet center rejects any other shape on every announce`);
+    }
     if (!cc.worker) {
         opts.logger?.warn("fleet_client_no_worker_scope", { note: "FLEET_ADVERTISE_ADDRESS set but SEMA_REGISTRY_WORKER missing — announce needs the worker (dispatch key); fleet client not started" });
         return undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/server",
-  "version": "5.12.0",
+  "version": "5.13.0",
   "description": "Sema Server — the server/API implementation layer for Sema, wiring core, registry, model providers, and cloud agent execution. Built on @sema-agent/core.",
   "type": "module",
   "license": "BUSL-1.1",
@@ -68,7 +68,7 @@
     "sharp": "^0.35.3"
   },
   "devDependencies": {
-    "@sema-agent/sdk": "^5.1.0",
+    "@sema-agent/sdk": "^5.2.0",
     "@types/libsodium-wrappers": "^0.7.14",
     "@types/node": "22.10.2",
     "@types/pg": "^8.20.0",