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

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/glassbox/index.d.mts

@@ -1,6 +1,6 @@
-import { G as GlassboxEvent } from '../types-C_dkNMA_.mjs';
-export { A as AdvisoryFiredData, C as CompileDoneData, a as CompileStartData, E as ExecuteAttemptData, b as ExecuteSuccessData, F as FallbackWalkedData, c as GLASSBOX_STREAM_TTL_MS, d as GlassboxEventKind, e as GlassboxPubSub } from '../types-C_dkNMA_.mjs';
-import '../ir-CAlLBu5d.mjs';
+import { G as GlassboxEvent } from '../types-CRy90cjp.mjs';
+export { A as AdvisoryFiredData, C as CompileDoneData, a as CompileStartData, E as ExecuteAttemptData, b as ExecuteSuccessData, F as FallbackWalkedData, c as GLASSBOX_STREAM_TTL_MS, d as GlassboxEventKind, e as GlassboxPubSub } from '../types-CRy90cjp.mjs';
+import '../ir-BC4uDL98.mjs';
 import '../dialect.mjs';
 
 /**

package/dist/glassbox/index.d.ts

@@ -1,6 +1,6 @@
-import { G as GlassboxEvent } from '../types-hEDGehpz.js';
-export { A as AdvisoryFiredData, C as CompileDoneData, a as CompileStartData, E as ExecuteAttemptData, b as ExecuteSuccessData, F as FallbackWalkedData, c as GLASSBOX_STREAM_TTL_MS, d as GlassboxEventKind, e as GlassboxPubSub } from '../types-hEDGehpz.js';
-import '../ir-BiXAMyji.js';
+import { G as GlassboxEvent } from '../types-CsB2YASc.js';
+export { A as AdvisoryFiredData, C as CompileDoneData, a as CompileStartData, E as ExecuteAttemptData, b as ExecuteSuccessData, F as FallbackWalkedData, c as GLASSBOX_STREAM_TTL_MS, d as GlassboxEventKind, e as GlassboxPubSub } from '../types-CsB2YASc.js';
+import '../ir-B2h0GAEL.js';
 import '../dialect.js';
 
 /**

package/dist/glassbox-routes/format.d.mts

@@ -1,5 +1,5 @@
-import { T as TraceHealth } from '../types-Dj5FLhBV.mjs';
-import '../ir-CAlLBu5d.mjs';
+import { T as TraceHealth } from '../types-B-pzBJKf.mjs';
+import '../ir-BC4uDL98.mjs';
 import '../dialect.mjs';
 
 /**

package/dist/glassbox-routes/format.d.ts

@@ -1,5 +1,5 @@
-import { T as TraceHealth } from '../types-DsA8JFOp.js';
-import '../ir-BiXAMyji.js';
+import { T as TraceHealth } from '../types-CKuu7Clz.js';
+import '../ir-B2h0GAEL.js';
 import '../dialect.js';
 
 /**

package/dist/glassbox-routes/index.d.mts

@@ -1,7 +1,7 @@
-import { G as GlassboxEvent } from '../types-C_dkNMA_.mjs';
-import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-Dj5FLhBV.mjs';
-export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-Dj5FLhBV.mjs';
-import '../ir-CAlLBu5d.mjs';
+import { G as GlassboxEvent } from '../types-CRy90cjp.mjs';
+import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-B-pzBJKf.mjs';
+export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-B-pzBJKf.mjs';
+import '../ir-BC4uDL98.mjs';
 import '../dialect.mjs';
 
 /**

package/dist/glassbox-routes/index.d.ts

@@ -1,7 +1,7 @@
-import { G as GlassboxEvent } from '../types-hEDGehpz.js';
-import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-DsA8JFOp.js';
-export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-DsA8JFOp.js';
-import '../ir-BiXAMyji.js';
+import { G as GlassboxEvent } from '../types-CsB2YASc.js';
+import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-CKuu7Clz.js';
+export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-CKuu7Clz.js';
+import '../ir-B2h0GAEL.js';
 import '../dialect.js';
 
 /**

package/dist/glassbox-routes/react/index.d.mts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { a as TraceDetail } from '../../types-Dj5FLhBV.mjs';
-import '../../ir-CAlLBu5d.mjs';
+import { a as TraceDetail } from '../../types-B-pzBJKf.mjs';
+import '../../ir-BC4uDL98.mjs';
 import '../../dialect.mjs';
 
 /**

package/dist/glassbox-routes/react/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { a as TraceDetail } from '../../types-DsA8JFOp.js';
-import '../../ir-BiXAMyji.js';
+import { a as TraceDetail } from '../../types-CKuu7Clz.js';
+import '../../ir-B2h0GAEL.js';
 import '../../dialect.js';
 
 /**

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { C as CompilePolicy, N as NormalizedResponse, A as ApiKeys, P as ProviderOverrides, a as CompiledRequest, b as PromptIR, c as CallOptions, d as CallResult, S as SystemModelMessage, e as CompileResult, B as BestPracticeAdvisory, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-CAlLBu5d.mjs';
-export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, F as FallbackReason, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, r as MutationApplied, s as NormalizedTokens, t as OutcomeKind, u as PerAxisMetricsByModel, v as PromptSection, w as SectionKind, x as ShadowProbeConfig, T as ToolCall, y as ToolDefinition } from './ir-CAlLBu5d.mjs';
+import { C as CompilePolicy, N as NormalizedResponse, A as ApiKeys, P as ProviderOverrides, a as CompiledRequest, b as PromptIR, c as CallOptions, d as CallResult, S as SystemModelMessage, e as CompileResult, B as BestPracticeAdvisory, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-BC4uDL98.mjs';
+export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, E as EffortLevel, F as FallbackReason, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, r as MutationApplied, s as NormalizedTokens, t as OutcomeKind, u as PerAxisMetricsByModel, v as PromptSection, w as SectionKind, x as ShadowProbeConfig, T as ToolCall, y as ToolDefinition } from './ir-BC4uDL98.mjs';
 import { ModelProfile, ArchetypeConvention } from './profiles.mjs';
 export { ALIASES, CacheStrategy, CliffRule, LATENCY_TIER_MS, LatencyTier, LoweringSpec, RecoveryRule, StructuredOutputCapability, SystemPromptMode, allProfiles, getProfile, latencyTierOf, profilesByProvider, tryGetProfile } from './profiles.mjs';
 export { BrainForwardConfig, BrainForwardRoutes, createBrainForwardRoutes } from './brain-proxy.mjs';
@@ -463,6 +463,7 @@ interface OutcomePayload {
     cost_usd_actual?: number;
     ttft_ms?: number;
     history_cacheable_tokens?: number;
+    effort?: string;
     history_tokens_at_compile?: number;
     /**
      * Mirrors `ir.constraints.toolOrchestration` from compile time. NULL when

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CompilePolicy, N as NormalizedResponse, A as ApiKeys, P as ProviderOverrides, a as CompiledRequest, b as PromptIR, c as CallOptions, d as CallResult, S as SystemModelMessage, e as CompileResult, B as BestPracticeAdvisory, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-BiXAMyji.js';
-export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, F as FallbackReason, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, r as MutationApplied, s as NormalizedTokens, t as OutcomeKind, u as PerAxisMetricsByModel, v as PromptSection, w as SectionKind, x as ShadowProbeConfig, T as ToolCall, y as ToolDefinition } from './ir-BiXAMyji.js';
+import { C as CompilePolicy, N as NormalizedResponse, A as ApiKeys, P as ProviderOverrides, a as CompiledRequest, b as PromptIR, c as CallOptions, d as CallResult, S as SystemModelMessage, e as CompileResult, B as BestPracticeAdvisory, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-B2h0GAEL.js';
+export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, E as EffortLevel, F as FallbackReason, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, r as MutationApplied, s as NormalizedTokens, t as OutcomeKind, u as PerAxisMetricsByModel, v as PromptSection, w as SectionKind, x as ShadowProbeConfig, T as ToolCall, y as ToolDefinition } from './ir-B2h0GAEL.js';
 import { ModelProfile, ArchetypeConvention } from './profiles.js';
 export { ALIASES, CacheStrategy, CliffRule, LATENCY_TIER_MS, LatencyTier, LoweringSpec, RecoveryRule, StructuredOutputCapability, SystemPromptMode, allProfiles, getProfile, latencyTierOf, profilesByProvider, tryGetProfile } from './profiles.js';
 export { BrainForwardConfig, BrainForwardRoutes, createBrainForwardRoutes } from './brain-proxy.js';
@@ -463,6 +463,7 @@ interface OutcomePayload {
     cost_usd_actual?: number;
     ttft_ms?: number;
     history_cacheable_tokens?: number;
+    effort?: string;
     history_tokens_at_compile?: number;
     /**
      * Mirrors `ir.constraints.toolOrchestration` from compile time. NULL when

package/dist/index.js

@@ -4509,7 +4509,9 @@ function registerCompile(appId, archetype, ir, result) {
     // alpha.29: translator activity — persisted on the brain row so
     // cross-app aggregates can answer "Sonnet narration rule fired N times,
     // outcome quality lifted to M."
-    sectionRewritesApplied: result.sectionRewritesApplied
+    sectionRewritesApplied: result.sectionRewritesApplied,
+    // alpha.57: cache the declared effort tier for record()'s auto-enrich.
+    effortFromCompile: ir.constraints?.effort
   });
 }
 function estimateSystemPromptChars(sections) {
@@ -4664,6 +4666,10 @@ function buildPayload(input, reg) {
     cost_usd_actual: costUsdActual,
     ttft_ms: input.ttftMs,
     history_cacheable_tokens: reg?.historyCacheableTokens,
+    // alpha.57 (data-first): input wins over compile-declared; undefined
+    // end-to-end -> key absent from the JSON body entirely (safe against
+    // brains that haven't applied migration 033 yet).
+    effort: input.effort ?? reg?.effortFromCompile,
     history_tokens_at_compile: reg?.historyTokensTotal,
     // alpha.20 E3: mirror consumer's declared tool-orchestration mode so
     // the brain can measure per-mode model perf separately (DeepSeek in
@@ -6881,6 +6887,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 +6898,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 +6910,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,
@@ -2665,7 +2665,9 @@ function registerCompile(appId, archetype, ir, result) {
     // alpha.29: translator activity — persisted on the brain row so
     // cross-app aggregates can answer "Sonnet narration rule fired N times,
     // outcome quality lifted to M."
-    sectionRewritesApplied: result.sectionRewritesApplied
+    sectionRewritesApplied: result.sectionRewritesApplied,
+    // alpha.57: cache the declared effort tier for record()'s auto-enrich.
+    effortFromCompile: ir.constraints?.effort
   });
 }
 function estimateSystemPromptChars(sections) {
@@ -2820,6 +2822,10 @@ function buildPayload(input, reg) {
     cost_usd_actual: costUsdActual,
     ttft_ms: input.ttftMs,
     history_cacheable_tokens: reg?.historyCacheableTokens,
+    // alpha.57 (data-first): input wins over compile-declared; undefined
+    // end-to-end -> key absent from the JSON body entirely (safe against
+    // brains that haven't applied migration 033 yet).
+    effort: input.effort ?? reg?.effortFromCompile,
     history_tokens_at_compile: reg?.historyTokensTotal,
     // alpha.20 E3: mirror consumer's declared tool-orchestration mode so
     // the brain can measure per-mode model perf separately (DeepSeek in

package/dist/{ir-BiXAMyji.d.ts → ir-B2h0GAEL.d.ts}

@@ -111,11 +111,34 @@ interface IntentDeclaration {
     /** Canonical dialect-v1 archetype. Required for cross-app learning. */
     archetype: IntentArchetypeName;
 }
+/**
+ * alpha.57 — dialect-level reasoning-effort tier (data-first).
+ *
+ * Vocabulary is a portfolio-level tier ladder (low → max), NOT any provider's
+ * wire value — mapping to `reasoning_effort` (OpenAI) / thinking budgets
+ * (Anthropic) / `thinkingConfig` (Gemini) stays consumer-side until
+ * routing-on-effort ships. Declaring it records the tier on the brain row
+ * (`compile_outcomes.effort`, migration 033) so effort×archetype quality
+ * evidence accumulates BEFORE any routing logic exists — same data-first
+ * sequencing as `tool_orchestration` (alpha.20).
+ */
+type EffortLevel = 'low' | 'medium' | 'high' | 'xhigh' | 'max';
 interface Constraints {
     /** Hard latency ceiling — compiler will down-rank slow models. Advisory. */
     maxLatencyMs?: number;
     /** Hard cost ceiling per call (USD). Advisory. */
     maxCostUsd?: number;
+    /**
+     * alpha.57 (data-first): the reasoning-effort tier the consumer ran (or
+     * intends to run) this call at. RECORDED, NOT APPLIED — the compiler does
+     * not emit provider thinking/effort params from this field and does not
+     * route on it yet; it flows to `compile_outcomes.effort` via record()'s
+     * registry auto-enrich (same pattern as `mutationsApplied`/advisories).
+     * Declare it truthfully: this is consumer-reported ground truth, like
+     * `tokensIn`/`latencyMs`. Does NOT enter the shape key (no learning-key
+     * fragmentation).
+     */
+    effort?: EffortLevel;
     /** Caller wants structured (JSON) output. */
     structuredOutput?: boolean;
     /** Hint: caller expects a short response (used to disable thinking on Gemini). */
@@ -1145,6 +1168,15 @@ interface RecordInput {
      * surfaces it. Distinct from `latencyMs` (end-to-end wall clock).
      */
     ttftMs?: number;
+    /**
+     * alpha.57 (data-first) — the reasoning-effort tier this call actually ran
+     * at. Overrides the compile-declared `constraints.effort` when both are
+     * present (input wins — same precedence as `mutationsApplied`/`advisories`).
+     * When omitted, record() auto-enriches from the registry-cached compile
+     * declaration. Undefined end-to-end → the `effort` key is absent from the
+     * outcome payload entirely (safe against pre-migration-033 brains).
+     */
+    effort?: EffortLevel;
     /**
      * alpha.20 — advisories fired at compile() time. Persisted to the brain's
      * `compile_outcome_advisories` sibling table via a second POST that fires
@@ -1343,4 +1375,4 @@ interface PerAxisMetrics {
 /** Per-axis metrics keyed by model — used for chain-comparison views. */
 type PerAxisMetricsByModel = Record<string, PerAxisMetrics>;
 
-export { type ApiKeys as A, type BestPracticeAdvisory as B, type CompilePolicy as C, type FallbackReason as F, type Grounding as G, type HistoryCachePolicy as H, type IntentDeclaration as I, type Message as M, type NormalizedResponse as N, type OutcomeResult as O, type ProviderOverrides as P, type RecordInput as R, type SystemModelMessage as S, type ToolCall as T, type CompiledRequest as a, type PromptIR as b, type CallOptions as c, type CallResult as d, type CompileResult as e, type SectionRewrite as f, type RecordOutcomeInput as g, type OracleScore as h, type Adapter as i, type PerAxisMetrics as j, type Provider as k, type ChainEntry as l, type CallAttempt as m, CallError as n, type ChainModelEntry as o, type ChainWithGrounding as p, type Constraints as q, type MutationApplied as r, type NormalizedTokens as s, type OutcomeKind as t, type PerAxisMetricsByModel as u, type PromptSection as v, type SectionKind as w, type ShadowProbeConfig as x, type ToolDefinition as y };
+export { type ApiKeys as A, type BestPracticeAdvisory as B, type CompilePolicy as C, type EffortLevel as E, type FallbackReason as F, type Grounding as G, type HistoryCachePolicy as H, type IntentDeclaration as I, type Message as M, type NormalizedResponse as N, type OutcomeResult as O, type ProviderOverrides as P, type RecordInput as R, type SystemModelMessage as S, type ToolCall as T, type CompiledRequest as a, type PromptIR as b, type CallOptions as c, type CallResult as d, type CompileResult as e, type SectionRewrite as f, type RecordOutcomeInput as g, type OracleScore as h, type Adapter as i, type PerAxisMetrics as j, type Provider as k, type ChainEntry as l, type CallAttempt as m, CallError as n, type ChainModelEntry as o, type ChainWithGrounding as p, type Constraints as q, type MutationApplied as r, type NormalizedTokens as s, type OutcomeKind as t, type PerAxisMetricsByModel as u, type PromptSection as v, type SectionKind as w, type ShadowProbeConfig as x, type ToolDefinition as y };

package/dist/{ir-CAlLBu5d.d.mts → ir-BC4uDL98.d.mts}

@@ -111,11 +111,34 @@ interface IntentDeclaration {
     /** Canonical dialect-v1 archetype. Required for cross-app learning. */
     archetype: IntentArchetypeName;
 }
+/**
+ * alpha.57 — dialect-level reasoning-effort tier (data-first).
+ *
+ * Vocabulary is a portfolio-level tier ladder (low → max), NOT any provider's
+ * wire value — mapping to `reasoning_effort` (OpenAI) / thinking budgets
+ * (Anthropic) / `thinkingConfig` (Gemini) stays consumer-side until
+ * routing-on-effort ships. Declaring it records the tier on the brain row
+ * (`compile_outcomes.effort`, migration 033) so effort×archetype quality
+ * evidence accumulates BEFORE any routing logic exists — same data-first
+ * sequencing as `tool_orchestration` (alpha.20).
+ */
+type EffortLevel = 'low' | 'medium' | 'high' | 'xhigh' | 'max';
 interface Constraints {
     /** Hard latency ceiling — compiler will down-rank slow models. Advisory. */
     maxLatencyMs?: number;
     /** Hard cost ceiling per call (USD). Advisory. */
     maxCostUsd?: number;
+    /**
+     * alpha.57 (data-first): the reasoning-effort tier the consumer ran (or
+     * intends to run) this call at. RECORDED, NOT APPLIED — the compiler does
+     * not emit provider thinking/effort params from this field and does not
+     * route on it yet; it flows to `compile_outcomes.effort` via record()'s
+     * registry auto-enrich (same pattern as `mutationsApplied`/advisories).
+     * Declare it truthfully: this is consumer-reported ground truth, like
+     * `tokensIn`/`latencyMs`. Does NOT enter the shape key (no learning-key
+     * fragmentation).
+     */
+    effort?: EffortLevel;
     /** Caller wants structured (JSON) output. */
     structuredOutput?: boolean;
     /** Hint: caller expects a short response (used to disable thinking on Gemini). */
@@ -1145,6 +1168,15 @@ interface RecordInput {
      * surfaces it. Distinct from `latencyMs` (end-to-end wall clock).
      */
     ttftMs?: number;
+    /**
+     * alpha.57 (data-first) — the reasoning-effort tier this call actually ran
+     * at. Overrides the compile-declared `constraints.effort` when both are
+     * present (input wins — same precedence as `mutationsApplied`/`advisories`).
+     * When omitted, record() auto-enriches from the registry-cached compile
+     * declaration. Undefined end-to-end → the `effort` key is absent from the
+     * outcome payload entirely (safe against pre-migration-033 brains).
+     */
+    effort?: EffortLevel;
     /**
      * alpha.20 — advisories fired at compile() time. Persisted to the brain's
      * `compile_outcome_advisories` sibling table via a second POST that fires
@@ -1343,4 +1375,4 @@ interface PerAxisMetrics {
 /** Per-axis metrics keyed by model — used for chain-comparison views. */
 type PerAxisMetricsByModel = Record<string, PerAxisMetrics>;
 
-export { type ApiKeys as A, type BestPracticeAdvisory as B, type CompilePolicy as C, type FallbackReason as F, type Grounding as G, type HistoryCachePolicy as H, type IntentDeclaration as I, type Message as M, type NormalizedResponse as N, type OutcomeResult as O, type ProviderOverrides as P, type RecordInput as R, type SystemModelMessage as S, type ToolCall as T, type CompiledRequest as a, type PromptIR as b, type CallOptions as c, type CallResult as d, type CompileResult as e, type SectionRewrite as f, type RecordOutcomeInput as g, type OracleScore as h, type Adapter as i, type PerAxisMetrics as j, type Provider as k, type ChainEntry as l, type CallAttempt as m, CallError as n, type ChainModelEntry as o, type ChainWithGrounding as p, type Constraints as q, type MutationApplied as r, type NormalizedTokens as s, type OutcomeKind as t, type PerAxisMetricsByModel as u, type PromptSection as v, type SectionKind as w, type ShadowProbeConfig as x, type ToolDefinition as y };
+export { type ApiKeys as A, type BestPracticeAdvisory as B, type CompilePolicy as C, type EffortLevel as E, type FallbackReason as F, type Grounding as G, type HistoryCachePolicy as H, type IntentDeclaration as I, type Message as M, type NormalizedResponse as N, type OutcomeResult as O, type ProviderOverrides as P, type RecordInput as R, type SystemModelMessage as S, type ToolCall as T, type CompiledRequest as a, type PromptIR as b, type CallOptions as c, type CallResult as d, type CompileResult as e, type SectionRewrite as f, type RecordOutcomeInput as g, type OracleScore as h, type Adapter as i, type PerAxisMetrics as j, type Provider as k, type ChainEntry as l, type CallAttempt as m, CallError as n, type ChainModelEntry as o, type ChainWithGrounding as p, type Constraints as q, type MutationApplied as r, type NormalizedTokens as s, type OutcomeKind as t, type PerAxisMetricsByModel as u, type PromptSection as v, type SectionKind as w, type ShadowProbeConfig as x, type ToolDefinition as y };

package/dist/profiles.d.mts

@@ -1,4 +1,4 @@
-import { k as Provider } from './ir-CAlLBu5d.mjs';
+import { k as Provider } from './ir-BC4uDL98.mjs';
 import { IntentArchetypeName } from './dialect.mjs';
 
 /**

package/dist/profiles.d.ts

@@ -1,4 +1,4 @@
-import { k as Provider } from './ir-BiXAMyji.js';
+import { k as Provider } from './ir-B2h0GAEL.js';
 import { IntentArchetypeName } from './dialect.js';
 
 /**

package/dist/{types-Dj5FLhBV.d.mts → types-B-pzBJKf.d.mts}

@@ -1,4 +1,4 @@
-import { i as Adapter, w as SectionKind } from './ir-CAlLBu5d.mjs';
+import { i as Adapter, w as SectionKind } from './ir-BC4uDL98.mjs';
 
 /**
  * Internal config + hook types for createGlassboxRoutes().

package/dist/{types-DsA8JFOp.d.ts → types-CKuu7Clz.d.ts}

@@ -1,4 +1,4 @@
-import { i as Adapter, w as SectionKind } from './ir-BiXAMyji.js';
+import { i as Adapter, w as SectionKind } from './ir-B2h0GAEL.js';
 
 /**
  * Internal config + hook types for createGlassboxRoutes().

package/dist/{types-C_dkNMA_.d.mts → types-CRy90cjp.d.mts}

@@ -1,4 +1,4 @@
-import { r as MutationApplied, B as BestPracticeAdvisory, F as FallbackReason, m as CallAttempt } from './ir-CAlLBu5d.mjs';
+import { r as MutationApplied, B as BestPracticeAdvisory, F as FallbackReason, m as CallAttempt } from './ir-BC4uDL98.mjs';
 
 /**
  * Glass-Box observability types (alpha.17).

package/dist/{types-hEDGehpz.d.ts → types-CsB2YASc.d.ts}

@@ -1,4 +1,4 @@
-import { r as MutationApplied, B as BestPracticeAdvisory, F as FallbackReason, m as CallAttempt } from './ir-BiXAMyji.js';
+import { r as MutationApplied, B as BestPracticeAdvisory, F as FallbackReason, m as CallAttempt } from './ir-B2h0GAEL.js';
 
 /**
  * Glass-Box observability types (alpha.17).

package/package.json

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