aui-agent-builder 0.4.32 → 0.4.34

package/dist/utils/fetch-with-timeout.js

@@ -31,7 +31,10 @@
  *   wrapper, so existing test mocks of `node-fetch` continue to work
  *   unchanged. See `src/__tests__/helpers/mock-fetch.ts`.
  */
-import nodeFetch from "node-fetch";
+import nodeFetch, { Response } from "node-fetch";
+import http from "node:http";
+import https from "node:https";
+import zlib from "node:zlib";
 const DEFAULT_TIMEOUT_MS = 300_000;
 export class FetchTimeoutError extends Error {
     name = "FetchTimeoutError";
@@ -145,4 +148,172 @@ async function fetchWithTimeout(url, init) {
     }
 }
 export default fetchWithTimeout;
+// ─── Node 24.17.0+ premature-close recovery ──────────────────────────────
+//
+// Node v24.17.0 tightened how the core HTTP client treats a connection that
+// closes without a clean end-of-stream: it now raises
+// `ERR_STREAM_PREMATURE_CLOSE` even when every byte of the body actually
+// arrived (curl and Node ≤24.16 / Node 20 accept the same response, returning
+// HTTP 200). This deterministically breaks streamed GETs like
+// `GET /api/network/v1/category` on that runtime while the server is healthy.
+//
+// The recovery below is intentionally narrow and SAFE on every Node version:
+//   • It is only ever entered from a caller's catch AFTER a premature-close
+//     error — older runtimes never raise it, so their code path is unchanged.
+//   • GET/HEAD only — idempotent reads. Writes are never re-sent.
+//   • It re-reads over a fresh `Connection: close` socket (no reuse, no gzip
+//     stream that could itself throw) and accepts the body ONLY when it can
+//     prove completeness (received bytes ≥ advertised Content-Length). A
+//     genuinely truncated body still fails loudly — we never hand back a
+//     partial payload as if it were whole.
+/** Effective default timeout (env override honoured), for recovery callers. */
+export function getDefaultTimeoutMs() {
+    return resolveTimeoutMs();
+}
+const PREMATURE_CLOSE_RE = /premature close|ERR_STREAM_PREMATURE_CLOSE|terminated|UND_ERR_SOCKET|UND_ERR_CONNECT|other side closed|socket hang up|ECONNRESET/i;
+/**
+ * Whether an error is the "connection dropped before a clean end-of-stream"
+ * class — the signature of the Node 24.17.0 regression and of ordinary
+ * mid-flight socket drops. Inspects the message AND `error.cause` (the global
+ * `fetch`/undici path hides the real code as `TypeError: terminated` with the
+ * cause underneath) so it catches both the `node-fetch` and undici shapes.
+ */
+export function isPrematureClose(err) {
+    if (!err)
+        return false;
+    const e = err;
+    const haystack = [e.message, e.code, e.type, e.cause?.code, e.cause?.message]
+        .filter(Boolean)
+        .join(" ");
+    return PREMATURE_CLOSE_RE.test(haystack);
+}
+/**
+ * Normalise any header container (plain object or a Headers-like with
+ * `forEach`) into a plain `Record<string,string>`. Array values (e.g.
+ * `set-cookie`) are joined.
+ */
+export function normalizeHeaders(input) {
+    const out = {};
+    if (!input)
+        return out;
+    if (typeof input.forEach === "function") {
+        input.forEach((value, key) => {
+            out[key] = String(value);
+        });
+        return out;
+    }
+    for (const [key, value] of Object.entries(input)) {
+        if (value === undefined || value === null)
+            continue;
+        out[key] = Array.isArray(value) ? value.join(", ") : String(value);
+    }
+    return out;
+}
+function decodeBody(buf, encoding) {
+    const enc = (Array.isArray(encoding) ? encoding.join(",") : encoding ?? "")
+        .toLowerCase();
+    return new Promise((resolve, reject) => {
+        const cb = (e, r) => e ? reject(e) : resolve(r);
+        if (enc.includes("br"))
+            return zlib.brotliDecompress(buf, cb);
+        if (enc.includes("gzip"))
+            return zlib.gunzip(buf, cb);
+        if (enc.includes("deflate"))
+            return zlib.inflate(buf, cb);
+        resolve(buf);
+    });
+}
+const MAX_TOLERANT_REDIRECTS = 5;
+/**
+ * Re-fetch an idempotent GET in a way that tolerates the Node 24.17.0
+ * premature-close, using a raw `http`/`https` request we fully control.
+ *
+ * Returns a `node-fetch` `Response` (body buffered) so callers can keep using
+ * `.text()` / `.json()` / `.ok` / `.status` exactly as before. Rejects when
+ * the body cannot be proven complete (real truncation), when redirects exceed
+ * the cap, or on timeout — callers then fall back to their normal error path.
+ */
+export function tolerantGet(url, headers, timeoutMs = getDefaultTimeoutMs(), redirectsLeft = MAX_TOLERANT_REDIRECTS) {
+    return new Promise((resolve, reject) => {
+        let parsed;
+        try {
+            parsed = new URL(url);
+        }
+        catch (e) {
+            reject(e);
+            return;
+        }
+        const mod = parsed.protocol === "http:" ? http : https;
+        // Force a fresh, non-reused, EOF-framed connection. Drop any
+        // Accept-Encoding so the server is encouraged to send plain bytes (we
+        // still decode if it compresses anyway).
+        const reqHeaders = {
+            ...headers,
+            connection: "close",
+        };
+        for (const k of Object.keys(reqHeaders)) {
+            if (k.toLowerCase() === "accept-encoding")
+                delete reqHeaders[k];
+        }
+        const req = mod.request(parsed, { method: "GET", headers: reqHeaders }, (res) => {
+            const status = res.statusCode ?? 0;
+            // Follow redirects the way node-fetch would (rare on these APIs).
+            if (status >= 300 &&
+                status < 400 &&
+                res.headers.location &&
+                redirectsLeft > 0) {
+                res.resume();
+                const next = new URL(res.headers.location, parsed).toString();
+                tolerantGet(next, headers, timeoutMs, redirectsLeft - 1).then(resolve, reject);
+                return;
+            }
+            const chunks = [];
+            const expectedRaw = res.headers["content-length"];
+            const expected = expectedRaw != null ? Number(expectedRaw) : NaN;
+            let unclean = false;
+            let settled = false;
+            const finish = () => {
+                if (settled)
+                    return;
+                const raw = Buffer.concat(chunks);
+                // Completeness gate. A clean `end` is always accepted. An unclean
+                // close is accepted ONLY when we received at least the advertised
+                // Content-Length; otherwise it's indistinguishable from truncation
+                // and must fail loudly.
+                if (unclean && !(Number.isFinite(expected) && raw.length >= expected)) {
+                    settled = true;
+                    reject(new Error(`Truncated response (${raw.length}` +
+                        (Number.isFinite(expected) ? `/${expected}` : "") +
+                        ` bytes): GET ${url}`));
+                    return;
+                }
+                settled = true;
+                decodeBody(raw, res.headers["content-encoding"]).then((body) => {
+                    resolve(new Response(body, {
+                        status: status || 200,
+                        statusText: res.statusMessage,
+                        headers: normalizeHeaders(res.headers),
+                    }));
+                }, reject);
+            };
+            res.on("data", (c) => chunks.push(c));
+            res.on("end", finish);
+            res.on("aborted", () => {
+                unclean = true;
+            });
+            res.on("error", () => {
+                unclean = true;
+                finish();
+            });
+            res.on("close", finish);
+        });
+        if (timeoutMs > 0) {
+            req.setTimeout(timeoutMs, () => {
+                req.destroy(new Error(`tolerant GET timed out after ${timeoutMs}ms: ${url}`));
+            });
+        }
+        req.on("error", reject);
+        req.end();
+    });
+}
 //# sourceMappingURL=fetch-with-timeout.js.map

package/dist/utils/fetch-with-timeout.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-with-timeout.js","sourceRoot":"","sources":["../../src/utils/fetch-with-timeout.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fetch-with-timeout.js","sourceRoot":"","sources":["../../src/utils/fetch-with-timeout.ts"],"names":[],"mappings":"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"}

package/dist/utils/json-output.d.ts

@@ -49,6 +49,17 @@ export type JsonEnvelope<T = unknown> = JsonSuccessEnvelope<T> | JsonErrorEnvelo
 export declare function outputJson<T>(data: T): void;
 /**
  * Write an error JSON envelope to stdout and exit with the given code.
+ *
+ * Uses a synchronous fd-1 write (not `process.stdout.write`) on purpose:
+ * `process.stdout.write` to a pipe is async, and the immediately-following
+ * `process.exit` can terminate the process before the buffer flushes —
+ * silently dropping the error envelope for non-interactive callers (the BFF,
+ * Claude Code, the spawned-subprocess test harness). `fs.writeSync` blocks
+ * until the bytes are handed to the OS, so the payload always lands before we
+ * exit while keeping this function's synchronous `never` contract intact.
+ * Error envelopes are small (well under the pipe buffer) so this never blocks
+ * meaningfully or risks EAGAIN. Best-effort: if the fd write throws, fall back
+ * to the async write so we never crash on the error path itself.
  */
 export declare function outputJsonError(detail: JsonErrorDetail, exitCode?: number): never;
 /**

package/dist/utils/json-output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-output.d.ts","sourceRoot":"","sources":["../../src/utils/json-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAElD;AAED,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAG9C;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC9C,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI,mBAAmB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC;AAEnF;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAG3C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,QAAQ,SAAI,GAAG,KAAK,CAI5E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C"}
+{"version":3,"file":"json-output.d.ts","sourceRoot":"","sources":["../../src/utils/json-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAElD;AAED,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAG9C;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC9C,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI,mBAAmB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC;AAEnF;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAG3C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,EAAE,QAAQ,SAAI,GAAG,KAAK,CAS5E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C"}

package/dist/utils/json-output.js

@@ -10,6 +10,7 @@
  *   - Progress messages (spinners, status) go to stderr
  *   - Ink rendering is skipped entirely
  */
+import { writeSync } from "node:fs";
 let _jsonMode = false;
 export function setJsonMode(enabled) {
     _jsonMode = enabled;
@@ -40,10 +41,27 @@ export function outputJson(data) {
 }
 /**
  * Write an error JSON envelope to stdout and exit with the given code.
+ *
+ * Uses a synchronous fd-1 write (not `process.stdout.write`) on purpose:
+ * `process.stdout.write` to a pipe is async, and the immediately-following
+ * `process.exit` can terminate the process before the buffer flushes —
+ * silently dropping the error envelope for non-interactive callers (the BFF,
+ * Claude Code, the spawned-subprocess test harness). `fs.writeSync` blocks
+ * until the bytes are handed to the OS, so the payload always lands before we
+ * exit while keeping this function's synchronous `never` contract intact.
+ * Error envelopes are small (well under the pipe buffer) so this never blocks
+ * meaningfully or risks EAGAIN. Best-effort: if the fd write throws, fall back
+ * to the async write so we never crash on the error path itself.
  */
 export function outputJsonError(detail, exitCode = 1) {
     const envelope = { success: false, error: detail };
-    process.stdout.write(JSON.stringify(envelope, null, 2) + "\n");
+    const payload = JSON.stringify(envelope, null, 2) + "\n";
+    try {
+        writeSync(1, payload);
+    }
+    catch {
+        process.stdout.write(payload);
+    }
     process.exit(exitCode);
 }
 /**

package/dist/utils/json-output.js.map

@@ -1 +1 @@
-{"version":3,"file":"json-output.js","sourceRoot":"","sources":["../../src/utils/json-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,IAAI,SAAS,GAAG,KAAK,CAAC;AAEtB,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,SAAS,GAAG,OAAO,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,SAAS;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC;AA2BD;;GAEG;AACH,MAAM,UAAU,UAAU,CAAI,IAAO;IACnC,MAAM,QAAQ,GAA2B,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAuB,EAAE,QAAQ,GAAG,CAAC;IACnE,MAAM,QAAQ,GAAsB,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACtE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC/D,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"json-output.js","sourceRoot":"","sources":["../../src/utils/json-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,IAAI,SAAS,GAAG,KAAK,CAAC;AAEtB,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,SAAS,GAAG,OAAO,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,SAAS;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC;AA2BD;;GAEG;AACH,MAAM,UAAU,UAAU,CAAI,IAAO;IACnC,MAAM,QAAQ,GAA2B,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACjE,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,MAAuB,EAAE,QAAQ,GAAG,CAAC;IACnE,MAAM,QAAQ,GAAsB,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACtE,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACzD,IAAI,CAAC;QACH,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;AACvC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aui-agent-builder",
-  "version": "0.4.32",
+  "version": "0.4.34",
   "description": "CLI for building, managing, and deploying AUI AI agent configurations",
   "type": "module",
   "main": "dist/index.js",