@warmdrift/kgauto-compiler 2.0.0-alpha.55 → 2.0.0-alpha.56

package/dist/brain-proxy.d.mts

@@ -59,6 +59,19 @@
  * segment of each library POST (`outcomes`, `probe_outcomes`, …) is what
  * `handle()` receives as `segment`.
  *
+ * ## Prefer-header relay (alpha.56)
+ *
+ * `record()` sends `Prefer: return=representation` on its `/outcomes` POST and
+ * parses the inserted row id from the PROXY's response to fire the secondary
+ * `compile_outcome_advisories` POST. alpha.54/.55 hardcoded
+ * `Prefer: return=minimal` toward the brain and returned `{ok:true}` — so the
+ * id-parse found nothing and the advisory secondary silently never fired for
+ * factory-mounted consumers (PB + GE convergent finding, 2026-07-06). The
+ * factory now honors a caller `Prefer: return=representation` header: it is
+ * forwarded to the brain and the brain's response body (the inserted row(s))
+ * is relayed verbatim on success. Callers that don't send the header keep the
+ * `return=minimal` + `{ok:true}` behavior.
+ *
  * ## Quality-segment handle resolution (alpha.55)
  *
  * `recordOutcome()` sends `outcome_id` as `CompileResult.handle` (a string),

package/dist/brain-proxy.d.ts

@@ -59,6 +59,19 @@
  * segment of each library POST (`outcomes`, `probe_outcomes`, …) is what
  * `handle()` receives as `segment`.
  *
+ * ## Prefer-header relay (alpha.56)
+ *
+ * `record()` sends `Prefer: return=representation` on its `/outcomes` POST and
+ * parses the inserted row id from the PROXY's response to fire the secondary
+ * `compile_outcome_advisories` POST. alpha.54/.55 hardcoded
+ * `Prefer: return=minimal` toward the brain and returned `{ok:true}` — so the
+ * id-parse found nothing and the advisory secondary silently never fired for
+ * factory-mounted consumers (PB + GE convergent finding, 2026-07-06). The
+ * factory now honors a caller `Prefer: return=representation` header: it is
+ * forwarded to the brain and the brain's response body (the inserted row(s))
+ * is relayed verbatim on success. Callers that don't send the header keep the
+ * `return=minimal` + `{ok:true}` behavior.
+ *
  * ## Quality-segment handle resolution (alpha.55)
  *
  * `recordOutcome()` sends `outcome_id` as `CompileResult.handle` (a string),

package/dist/brain-proxy.js

@@ -136,6 +136,9 @@ function createBrainForwardRoutes(config) {
         if (outcome instanceof Response) return outcome;
         row = outcome;
       }
+      const wantsRepresentation = /return=representation/i.test(
+        req.headers.get("Prefer") ?? ""
+      );
       let brainRes;
       try {
         brainRes = await fetchFn(`${brainUrl}/rest/v1/${table}`, {
@@ -144,7 +147,7 @@ function createBrainForwardRoutes(config) {
             apikey: serviceKey,
             Authorization: `Bearer ${serviceKey}`,
             "Content-Type": "application/json",
-            Prefer: "return=minimal"
+            Prefer: wantsRepresentation ? "return=representation" : "return=minimal"
           },
           body: JSON.stringify(row)
         });
@@ -156,6 +159,12 @@ function createBrainForwardRoutes(config) {
         });
       }
       if (brainRes.ok) {
+        if (wantsRepresentation) {
+          const text2 = await brainRes.text().catch(() => "");
+          if (text2.length > 0) {
+            return new Response(text2, { status: 201, headers: JSON_HEADERS });
+          }
+        }
         return jsonResponse(201, { ok: true });
       }
       const text = await brainRes.text().catch(() => "<no body>");

package/dist/brain-proxy.mjs

@@ -1,6 +1,6 @@
 import {
   createBrainForwardRoutes
-} from "./chunk-WVICNOLA.mjs";
+} from "./chunk-IUWFML6Z.mjs";
 export {
   createBrainForwardRoutes
 };

package/dist/{chunk-WVICNOLA.mjs → chunk-IUWFML6Z.mjs}

@@ -112,6 +112,9 @@ function createBrainForwardRoutes(config) {
         if (outcome instanceof Response) return outcome;
         row = outcome;
       }
+      const wantsRepresentation = /return=representation/i.test(
+        req.headers.get("Prefer") ?? ""
+      );
       let brainRes;
       try {
         brainRes = await fetchFn(`${brainUrl}/rest/v1/${table}`, {
@@ -120,7 +123,7 @@ function createBrainForwardRoutes(config) {
             apikey: serviceKey,
             Authorization: `Bearer ${serviceKey}`,
             "Content-Type": "application/json",
-            Prefer: "return=minimal"
+            Prefer: wantsRepresentation ? "return=representation" : "return=minimal"
           },
           body: JSON.stringify(row)
         });
@@ -132,6 +135,12 @@ function createBrainForwardRoutes(config) {
         });
       }
       if (brainRes.ok) {
+        if (wantsRepresentation) {
+          const text2 = await brainRes.text().catch(() => "");
+          if (text2.length > 0) {
+            return new Response(text2, { status: 201, headers: JSON_HEADERS });
+          }
+        }
         return jsonResponse(201, { ok: true });
       }
       const text = await brainRes.text().catch(() => "<no body>");

package/dist/index.js

@@ -6881,6 +6881,9 @@ function createBrainForwardRoutes(config) {
         if (outcome instanceof Response) return outcome;
         row = outcome;
       }
+      const wantsRepresentation = /return=representation/i.test(
+        req.headers.get("Prefer") ?? ""
+      );
       let brainRes;
       try {
         brainRes = await fetchFn(`${brainUrl}/rest/v1/${table}`, {
@@ -6889,7 +6892,7 @@ function createBrainForwardRoutes(config) {
             apikey: serviceKey,
             Authorization: `Bearer ${serviceKey}`,
             "Content-Type": "application/json",
-            Prefer: "return=minimal"
+            Prefer: wantsRepresentation ? "return=representation" : "return=minimal"
           },
           body: JSON.stringify(row)
         });
@@ -6901,6 +6904,12 @@ function createBrainForwardRoutes(config) {
         });
       }
       if (brainRes.ok) {
+        if (wantsRepresentation) {
+          const text2 = await brainRes.text().catch(() => "");
+          if (text2.length > 0) {
+            return new Response(text2, { status: 201, headers: JSON_HEADERS });
+          }
+        }
         return jsonResponse(201, { ok: true });
       }
       const text = await brainRes.text().catch(() => "<no body>");

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import {
   createBrainForwardRoutes
-} from "./chunk-WVICNOLA.mjs";
+} from "./chunk-IUWFML6Z.mjs";
 import {
   ALL_ARCHETYPES,
   DIALECT_VERSION,

package/package.json

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