@genesislcap/foundation-ai 15.8.2 → 15.8.3

package/dist/dts/transports/post-with-retry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"post-with-retry.d.ts","sourceRoot":"","sources":["../../../src/transports/post-with-retry.ts"],"names":[],"mappings":"AAYA;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC;;;OAGG;IACH,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,kBAAkB,CAAC;IAChC,uFAAuF;IACvF,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,4FAA4F;IAC5F,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,YAAY,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAID;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAiLnF"}
+{"version":3,"file":"post-with-retry.d.ts","sourceRoot":"","sources":["../../../src/transports/post-with-retry.ts"],"names":[],"mappings":"AAYA;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC;;;OAGG;IACH,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,kBAAkB,CAAC;IAChC,uFAAuF;IACvF,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,4FAA4F;IAC5F,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,YAAY,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAID;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAuMnF"}

package/dist/esm/transports/post-with-retry.js

@@ -16,7 +16,7 @@ const MAX_RETRIES = 5;
  */
 export function postWithRetry(options) {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e, _f, _g;
         const { url, headers, body, credentials, vendorLabel, retryableStatuses, timeout, stallTimeout, backoffBaseMs, signal, } = options;
         // Exponential backoff between retries: base, 2×, 4×, 8×, 16×. Abortable on the
         // CALLER signal only — the timeout is cleared before each backoff, so a caller
@@ -26,10 +26,29 @@ export function postWithRetry(options) {
         /* oxlint-disable no-await-in-loop -- intentional sequential retries with backoff */
         for (let attempt = 0; attempt <= MAX_RETRIES; attempt += 1) {
             const timeoutController = new AbortController();
+            // Which phase the request reached before the clock fired. A bare "timed out"
+            // cannot distinguish "the service never answered at all" from "it answered,
+            // then produced no body" — and those have completely different owners
+            // (network/gateway vs the service itself). `fetch` resolves on HEADERS, so
+            // the phase is knowable here and is the single most useful fact when the
+            // only evidence available is a client-side log.
+            // `performance.now()` (monotonic), not `Date.now()`: an NTP step or suspend/resume mid-request
+            // would otherwise land a nonsense duration in the very message someone is reading to diagnose
+            // a hang. Only differences are used, so the arbitrary time origin is irrelevant.
+            const startedAt = performance.now();
+            let headersAt;
+            let responseCtype;
+            const timedOutMessage = () => {
+                const waited = Math.round(performance.now() - startedAt);
+                if (headersAt === undefined) {
+                    return `${vendorLabel} request timed out after ${waited}ms — no response headers (the service never answered; nothing was received to stall on)`;
+                }
+                return `${vendorLabel} request timed out after ${waited}ms — headers arrived in ${Math.round(headersAt - startedAt)}ms (content-type: ${responseCtype !== null && responseCtype !== void 0 ? responseCtype : 'unknown'}) but no body followed`;
+            };
             // Wall clock for connect/headers (and the whole body on the legacy JSON
             // path). The framed path swaps it for the inactivity timer below once the
             // heartbeat body starts streaming.
-            let timeoutId = setTimeout(() => timeoutController.abort(new DOMException(`${vendorLabel} request timed out`, 'TimeoutError')), timeout);
+            let timeoutId = setTimeout(() => timeoutController.abort(new DOMException(timedOutMessage(), 'TimeoutError')), timeout);
             // Re-armed on every received chunk. With proxy pings every 5s it only fires
             // when the proxy/network actually dies — a framed body that keeps streaming
             // has no wall cap (max_tokens bounds generation; the proxy watches upstream).
@@ -57,6 +76,12 @@ export function postWithRetry(options) {
                     signal: combinedSignal,
                     credentials,
                 });
+                // Headers are in — record the phase so a later timeout can say so. Cheap and
+                // unconditional: the value is only read when the clock actually fires.
+                headersAt = performance.now();
+                // Defensive: `headers` is optional on the Response-likes callers and tests supply, and a
+                // diagnostic must never be the thing that breaks the request it is describing.
+                responseCtype = (_c = (_b = (_a = response.headers) === null || _a === void 0 ? void 0 : _a.get) === null || _b === void 0 ? void 0 : _b.call(_a, 'content-type')) !== null && _c !== void 0 ? _c : undefined;
                 if (!response.ok) {
                     // One read of the error body per failing attempt — it feeds BOTH the
                     // budget classification and the thrown message, and the response is
@@ -99,7 +124,7 @@ export function postWithRetry(options) {
                 // The proxy streams NDJSON heartbeat frames when it supports them; an old
                 // proxy ignores our Accept header and returns plain JSON, so branch on
                 // what actually came back.
-                if (((_b = (_a = response.headers) === null || _a === void 0 ? void 0 : _a.get('content-type')) === null || _b === void 0 ? void 0 : _b.toLowerCase().includes('application/x-ndjson')) &&
+                if (((_e = (_d = response.headers) === null || _d === void 0 ? void 0 : _d.get('content-type')) === null || _e === void 0 ? void 0 : _e.toLowerCase().includes('application/x-ndjson')) &&
                     response.body) {
                     rearmStallTimer();
                     const frame = yield readFramedBody(response.body, rearmStallTimer, vendorLabel, stallTimeout);
@@ -111,7 +136,7 @@ export function postWithRetry(options) {
                     if (frame.code === 'UPSTREAM_STALLED') {
                         // The proxy watchdog saw no upstream data — same tagged shape as a
                         // local stall, so the driver's TimeoutError branch handles both.
-                        throw new DOMException(`${vendorLabel} request stalled: ${(_c = frame.error) !== null && _c !== void 0 ? _c : 'no upstream data'}`, 'TimeoutError');
+                        throw new DOMException(`${vendorLabel} request stalled: ${(_f = frame.error) !== null && _f !== void 0 ? _f : 'no upstream data'}`, 'TimeoutError');
                     }
                     // The budget wall, framed (GENC-1464) — the in-band twin of the 402 above,
                     // through the same predicate, keyed on status OR code. Classified before
@@ -130,7 +155,7 @@ export function postWithRetry(options) {
                         yield backoff(attempt);
                         continue;
                     }
-                    throw new Error(`${vendorLabel} request error ${frame.status}: ${(_d = frame.error) !== null && _d !== void 0 ? _d : JSON.stringify(frame.details)}`);
+                    throw new Error(`${vendorLabel} request error ${frame.status}: ${(_g = frame.error) !== null && _g !== void 0 ? _g : JSON.stringify(frame.details)}`);
                 }
                 return (yield response.json());
             }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-ai",
   "description": "Genesis Foundation AI - Provider-agnostic AI configuration and shared utilities",
-  "version": "15.8.2",
+  "version": "15.8.3",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -52,17 +52,17 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "15.8.2",
-    "@genesislcap/genx": "15.8.2",
-    "@genesislcap/rollup-builder": "15.8.2",
-    "@genesislcap/ts-builder": "15.8.2",
-    "@genesislcap/uvu-playwright-builder": "15.8.2",
-    "@genesislcap/vite-builder": "15.8.2",
-    "@genesislcap/webpack-builder": "15.8.2"
+    "@genesislcap/foundation-testing": "15.8.3",
+    "@genesislcap/genx": "15.8.3",
+    "@genesislcap/rollup-builder": "15.8.3",
+    "@genesislcap/ts-builder": "15.8.3",
+    "@genesislcap/uvu-playwright-builder": "15.8.3",
+    "@genesislcap/vite-builder": "15.8.3",
+    "@genesislcap/webpack-builder": "15.8.3"
   },
   "dependencies": {
-    "@genesislcap/foundation-logger": "15.8.2",
-    "@genesislcap/foundation-utils": "15.8.2",
+    "@genesislcap/foundation-logger": "15.8.3",
+    "@genesislcap/foundation-utils": "15.8.3",
     "@microsoft/fast-foundation": "2.50.0"
   },
   "repository": {
@@ -73,5 +73,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "c62567e4acee7219798579d18a023be909bdd0a0"
+  "gitHead": "0001fb4c5a056b22bb1a3d316cc4f2e2aa79cff4"
 }