@warmdrift/kgauto-compiler 2.0.0-alpha.58 → 2.0.0-alpha.59

package/dist/index.d.mts

@@ -415,6 +415,28 @@ interface BrainConfig {
      * arms the tracking, so good actors never see a false warning.
      */
     warnOnDiscardedCompile?: boolean;
+    /**
+     * alpha.59 — per-leg timeout (ms) applied to every brain WRITE POST
+     * (record() primary + advisory secondary, recordOutcome(),
+     * recordShadowProbe()) via `AbortSignal.timeout`. Default 10000.
+     *
+     * Why: `sync: true` puts these fetches on the USER path (Edge consumers
+     * await record() before responding), and alpha.56's representation
+     * passthrough added a second sequential POST (advisory secondary) to that
+     * same path — an unbounded hang on either leg holds the user to the Edge
+     * limit (GE's `brainconfig-first-class-timeout` filing; GE bounded it at
+     * 3s via a hand-rolled fetchImpl wrapper every sync consumer had to
+     * rediscover).
+     *
+     * A fired timeout follows each leg's existing degraded-brain path
+     * (fire-and-forget: swallowed via onError; sync: `persistence_failed`
+     * result — never a throw into the user path). Wraps the configured
+     * `fetchImpl` rather than replacing it, so it composes with
+     * consumer-supplied impls. Set `0` to disable (pre-alpha.59 unbounded
+     * behavior). Brain-query reads (config tables) are cached + SWR and are
+     * not affected.
+     */
+    timeoutMs?: number;
 }
 declare function configureBrain(config: BrainConfig): void;
 declare function clearBrain(): void;

package/dist/index.d.ts

@@ -415,6 +415,28 @@ interface BrainConfig {
      * arms the tracking, so good actors never see a false warning.
      */
     warnOnDiscardedCompile?: boolean;
+    /**
+     * alpha.59 — per-leg timeout (ms) applied to every brain WRITE POST
+     * (record() primary + advisory secondary, recordOutcome(),
+     * recordShadowProbe()) via `AbortSignal.timeout`. Default 10000.
+     *
+     * Why: `sync: true` puts these fetches on the USER path (Edge consumers
+     * await record() before responding), and alpha.56's representation
+     * passthrough added a second sequential POST (advisory secondary) to that
+     * same path — an unbounded hang on either leg holds the user to the Edge
+     * limit (GE's `brainconfig-first-class-timeout` filing; GE bounded it at
+     * 3s via a hand-rolled fetchImpl wrapper every sync consumer had to
+     * rediscover).
+     *
+     * A fired timeout follows each leg's existing degraded-brain path
+     * (fire-and-forget: swallowed via onError; sync: `persistence_failed`
+     * result — never a throw into the user path). Wraps the configured
+     * `fetchImpl` rather than replacing it, so it composes with
+     * consumer-supplied impls. Set `0` to disable (pre-alpha.59 unbounded
+     * behavior). Brain-query reads (config tables) are cached + SWR and are
+     * not affected.
+     */
+    timeoutMs?: number;
 }
 declare function configureBrain(config: BrainConfig): void;
 declare function clearBrain(): void;

package/dist/index.js

@@ -4417,6 +4417,15 @@ function resolvePricingAt(modelId, at = /* @__PURE__ */ new Date()) {
 }
 
 // src/brain.ts
+var DEFAULT_BRAIN_WRITE_TIMEOUT_MS = 1e4;
+function brainWriteFetch(config) {
+  const base = config.fetchImpl ?? fetch;
+  const timeoutMs = config.timeoutMs ?? DEFAULT_BRAIN_WRITE_TIMEOUT_MS;
+  if (timeoutMs <= 0 || typeof AbortSignal === "undefined" || typeof AbortSignal.timeout !== "function") {
+    return base;
+  }
+  return (input, init) => base(input, { ...init, signal: AbortSignal.timeout(timeoutMs) });
+}
 var activeConfig;
 function configureBrain(config) {
   const endpoint = config.endpoint.replace(/\/outcomes\/?$/, "");
@@ -4562,7 +4571,7 @@ async function record(input) {
   }
   const payload = buildPayload(input, reg);
   const config = activeConfig;
-  const fetchFn = config.fetchImpl ?? fetch;
+  const fetchFn = brainWriteFetch(config);
   const send = async () => {
     let outcomeId;
     try {
@@ -4731,9 +4740,9 @@ function buildAdvisoryRow(outcomeId, a) {
     code: a.code,
     level: a.level,
     message: a.message,
-    ...a.recommendationType ? { recommendation_type: a.recommendationType } : {},
-    ...a.suggestion ? { suggestion: a.suggestion } : {},
-    ...a.docsUrl ? { docs_url: a.docsUrl } : {}
+    recommendation_type: a.recommendationType ?? null,
+    suggestion: a.suggestion ?? null,
+    docs_url: a.docsUrl ?? null
   };
 }
 async function recordOutcome(input) {
@@ -4741,7 +4750,7 @@ async function recordOutcome(input) {
     return { ok: false, reason: "brain_not_configured" };
   }
   const config = activeConfig;
-  const fetchFn = config.fetchImpl ?? fetch;
+  const fetchFn = brainWriteFetch(config);
   const payload = {
     outcome_id: input.outcomeId,
     outcome: input.outcome,
@@ -4816,7 +4825,7 @@ function buildShadowProbeRow(input) {
 async function recordShadowProbe(input) {
   if (!activeConfig) return;
   const config = activeConfig;
-  const fetchFn = config.fetchImpl ?? fetch;
+  const fetchFn = brainWriteFetch(config);
   const row = buildShadowProbeRow(input);
   const send = async () => {
     try {

package/dist/index.mjs

@@ -2575,6 +2575,15 @@ function resolvePricingAt(modelId, at = /* @__PURE__ */ new Date()) {
 }
 
 // src/brain.ts
+var DEFAULT_BRAIN_WRITE_TIMEOUT_MS = 1e4;
+function brainWriteFetch(config) {
+  const base = config.fetchImpl ?? fetch;
+  const timeoutMs = config.timeoutMs ?? DEFAULT_BRAIN_WRITE_TIMEOUT_MS;
+  if (timeoutMs <= 0 || typeof AbortSignal === "undefined" || typeof AbortSignal.timeout !== "function") {
+    return base;
+  }
+  return (input, init) => base(input, { ...init, signal: AbortSignal.timeout(timeoutMs) });
+}
 var activeConfig;
 function configureBrain(config) {
   const endpoint = config.endpoint.replace(/\/outcomes\/?$/, "");
@@ -2720,7 +2729,7 @@ async function record(input) {
   }
   const payload = buildPayload(input, reg);
   const config = activeConfig;
-  const fetchFn = config.fetchImpl ?? fetch;
+  const fetchFn = brainWriteFetch(config);
   const send = async () => {
     let outcomeId;
     try {
@@ -2889,9 +2898,9 @@ function buildAdvisoryRow(outcomeId, a) {
     code: a.code,
     level: a.level,
     message: a.message,
-    ...a.recommendationType ? { recommendation_type: a.recommendationType } : {},
-    ...a.suggestion ? { suggestion: a.suggestion } : {},
-    ...a.docsUrl ? { docs_url: a.docsUrl } : {}
+    recommendation_type: a.recommendationType ?? null,
+    suggestion: a.suggestion ?? null,
+    docs_url: a.docsUrl ?? null
   };
 }
 async function recordOutcome(input) {
@@ -2899,7 +2908,7 @@ async function recordOutcome(input) {
     return { ok: false, reason: "brain_not_configured" };
   }
   const config = activeConfig;
-  const fetchFn = config.fetchImpl ?? fetch;
+  const fetchFn = brainWriteFetch(config);
   const payload = {
     outcome_id: input.outcomeId,
     outcome: input.outcome,
@@ -2974,7 +2983,7 @@ function buildShadowProbeRow(input) {
 async function recordShadowProbe(input) {
   if (!activeConfig) return;
   const config = activeConfig;
-  const fetchFn = config.fetchImpl ?? fetch;
+  const fetchFn = brainWriteFetch(config);
   const row = buildShadowProbeRow(input);
   const send = async () => {
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warmdrift/kgauto-compiler",
-  "version": "2.0.0-alpha.58",
+  "version": "2.0.0-alpha.59",
   "description": "Prompt compiler + central learning brain for multi-model AI apps. Swap models without rewriting prompts.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",