@warmdrift/kgauto-compiler 2.0.0-alpha.35 → 2.0.0-alpha.37

package/dist/glassbox/index.d.mts

@@ -1,6 +1,6 @@
-import { G as GlassboxEvent } from '../types-BoqPXoUb.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-BoqPXoUb.mjs';
-import '../ir-BAAHLfFL.mjs';
+import { G as GlassboxEvent } from '../types-f7idIVsm.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-f7idIVsm.mjs';
+import '../ir-BiZSAVCJ.mjs';
 import '../dialect.mjs';
 
 /**

package/dist/glassbox/index.d.ts

@@ -1,6 +1,6 @@
-import { G as GlassboxEvent } from '../types-CXyKj6-K.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-CXyKj6-K.js';
-import '../ir-B_ygNURd.js';
+import { G as GlassboxEvent } from '../types-CsFP-H-U.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-CsFP-H-U.js';
+import '../ir-CZ9Ng96k.js';
 import '../dialect.js';
 
 /**

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

@@ -1,5 +1,5 @@
-import { T as TraceHealth } from '../types-DDX6K2-p.mjs';
-import '../ir-BAAHLfFL.mjs';
+import { T as TraceHealth } from '../types-kzYpX7wB.mjs';
+import '../ir-BiZSAVCJ.mjs';
 import '../dialect.mjs';
 
 /**

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

@@ -1,5 +1,5 @@
-import { T as TraceHealth } from '../types-CJz1Ebvb.js';
-import '../ir-B_ygNURd.js';
+import { T as TraceHealth } from '../types-HEl2tS4P.js';
+import '../ir-CZ9Ng96k.js';
 import '../dialect.js';
 
 /**

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

@@ -1,7 +1,7 @@
-import { G as GlassboxEvent } from '../types-BoqPXoUb.mjs';
-import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-DDX6K2-p.mjs';
-export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-DDX6K2-p.mjs';
-import '../ir-BAAHLfFL.mjs';
+import { G as GlassboxEvent } from '../types-f7idIVsm.mjs';
+import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-kzYpX7wB.mjs';
+export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-kzYpX7wB.mjs';
+import '../ir-BiZSAVCJ.mjs';
 import '../dialect.mjs';
 
 /**

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

@@ -1,7 +1,7 @@
-import { G as GlassboxEvent } from '../types-CXyKj6-K.js';
-import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-CJz1Ebvb.js';
-export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-CJz1Ebvb.js';
-import '../ir-B_ygNURd.js';
+import { G as GlassboxEvent } from '../types-CsFP-H-U.js';
+import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-HEl2tS4P.js';
+export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-HEl2tS4P.js';
+import '../ir-CZ9Ng96k.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-DDX6K2-p.mjs';
-import '../../ir-BAAHLfFL.mjs';
+import { a as TraceDetail } from '../../types-kzYpX7wB.mjs';
+import '../../ir-BiZSAVCJ.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-CJz1Ebvb.js';
-import '../../ir-B_ygNURd.js';
+import { a as TraceDetail } from '../../types-HEl2tS4P.js';
+import '../../ir-CZ9Ng96k.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, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, B as BestPracticeAdvisory, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-BAAHLfFL.mjs';
-export { m as CallAttempt, n as CallError, o as ChainWithGrounding, p as Constraints, F as FallbackReason, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, q as MutationApplied, r as NormalizedTokens, s as OutcomeKind, t as PerAxisMetricsByModel, u as PromptSection, v as SectionKind, T as ToolCall, w as ToolDefinition } from './ir-BAAHLfFL.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, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, B as BestPracticeAdvisory, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-BiZSAVCJ.mjs';
+export { m as CallAttempt, n as CallError, o as ChainWithGrounding, p as Constraints, F as FallbackReason, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, q as MutationApplied, r as NormalizedTokens, s as OutcomeKind, t as PerAxisMetricsByModel, u as PromptSection, v as SectionKind, T as ToolCall, w as ToolDefinition } from './ir-BiZSAVCJ.mjs';
 import { ModelProfile } from './profiles.mjs';
 export { ALIASES, CacheStrategy, CliffRule, LoweringSpec, RecoveryRule, StructuredOutputCapability, SystemPromptMode, allProfiles, getProfile, profilesByProvider, tryGetProfile } from './profiles.mjs';
 import { IntentArchetypeName } from './dialect.mjs';

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, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, B as BestPracticeAdvisory, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-B_ygNURd.js';
-export { m as CallAttempt, n as CallError, o as ChainWithGrounding, p as Constraints, F as FallbackReason, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, q as MutationApplied, r as NormalizedTokens, s as OutcomeKind, t as PerAxisMetricsByModel, u as PromptSection, v as SectionKind, T as ToolCall, w as ToolDefinition } from './ir-B_ygNURd.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, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, B as BestPracticeAdvisory, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-CZ9Ng96k.js';
+export { m as CallAttempt, n as CallError, o as ChainWithGrounding, p as Constraints, F as FallbackReason, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, q as MutationApplied, r as NormalizedTokens, s as OutcomeKind, t as PerAxisMetricsByModel, u as PromptSection, v as SectionKind, T as ToolCall, w as ToolDefinition } from './ir-CZ9Ng96k.js';
 import { ModelProfile } from './profiles.js';
 export { ALIASES, CacheStrategy, CliffRule, LoweringSpec, RecoveryRule, StructuredOutputCapability, SystemPromptMode, allProfiles, getProfile, profilesByProvider, tryGetProfile } from './profiles.js';
 import { IntentArchetypeName } from './dialect.js';

package/dist/{ir-BAAHLfFL.d.mts → ir-BiZSAVCJ.d.mts}

@@ -398,6 +398,26 @@ interface BestPracticeAdvisory {
      * - `'architecture-change'` — the issue isn't fixable at the kgauto layer
      */
     recommendationType?: 'model-swap' | 'prompt-fix' | 'caching-fix' | 'no-ai-needed' | 'tier-down' | 'architecture-change';
+    /**
+     * alpha.36 — architectural recommendation when the call shouldn't be an
+     * AI call at all, or should be a cheaper non-AI substitute. Optional and
+     * orthogonal to {@link recommendationType}: when set, narrows the
+     * `no-ai-needed` / `architecture-change` rec-type into an actionable
+     * pattern the consumer can implement.
+     *
+     * - `'lookup-table'`       — deterministic input → output mapping (≥95% agreement at high N). Build a domain table; fall back to AI for novel inputs.
+     * - `'memoization-cache'`  — same canonical input recurs across sessions with equivalent output. Add an edge/KV cache keyed on canonical input.
+     * - `'tier-down'`          — cheaper model tier delivers equal-or-better oracle score on this shape. Move primary to the cheaper tier.
+     * - `'deterministic-parser'` — `constraints.structuredOutput: true` calls where the schema is regex/JSON-extractable from the input.
+     * - `'precompute'`         — input is derivable at build / cron / batch time; eliminate the per-request call entirely.
+     *
+     * Operator-side detection lives in `v2/scripts/no-ai-needed-detector.mjs`
+     * (alpha.36); a compile-time advisor rule that consumes the brain-side
+     * findings cache follows in a later alpha. Today populated only by the
+     * operator-side detector + the brain RPC `get_no_ai_needed_candidates`
+     * (migration 021).
+     */
+    recommendedArchitecture?: 'lookup-table' | 'memoization-cache' | 'tier-down' | 'deterministic-parser' | 'precompute';
     /**
      * alpha.28 — when a rule wants to surface a specific structural adaptation
      * (not just a swap or a prompt fix), it attaches the adapter shape here.

package/dist/{ir-B_ygNURd.d.ts → ir-CZ9Ng96k.d.ts}

@@ -398,6 +398,26 @@ interface BestPracticeAdvisory {
      * - `'architecture-change'` — the issue isn't fixable at the kgauto layer
      */
     recommendationType?: 'model-swap' | 'prompt-fix' | 'caching-fix' | 'no-ai-needed' | 'tier-down' | 'architecture-change';
+    /**
+     * alpha.36 — architectural recommendation when the call shouldn't be an
+     * AI call at all, or should be a cheaper non-AI substitute. Optional and
+     * orthogonal to {@link recommendationType}: when set, narrows the
+     * `no-ai-needed` / `architecture-change` rec-type into an actionable
+     * pattern the consumer can implement.
+     *
+     * - `'lookup-table'`       — deterministic input → output mapping (≥95% agreement at high N). Build a domain table; fall back to AI for novel inputs.
+     * - `'memoization-cache'`  — same canonical input recurs across sessions with equivalent output. Add an edge/KV cache keyed on canonical input.
+     * - `'tier-down'`          — cheaper model tier delivers equal-or-better oracle score on this shape. Move primary to the cheaper tier.
+     * - `'deterministic-parser'` — `constraints.structuredOutput: true` calls where the schema is regex/JSON-extractable from the input.
+     * - `'precompute'`         — input is derivable at build / cron / batch time; eliminate the per-request call entirely.
+     *
+     * Operator-side detection lives in `v2/scripts/no-ai-needed-detector.mjs`
+     * (alpha.36); a compile-time advisor rule that consumes the brain-side
+     * findings cache follows in a later alpha. Today populated only by the
+     * operator-side detector + the brain RPC `get_no_ai_needed_candidates`
+     * (migration 021).
+     */
+    recommendedArchitecture?: 'lookup-table' | 'memoization-cache' | 'tier-down' | 'deterministic-parser' | 'precompute';
     /**
      * alpha.28 — when a rule wants to surface a specific structural adaptation
      * (not just a swap or a prompt fix), it attaches the adapter shape here.

package/dist/profiles.d.mts

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

package/dist/profiles.d.ts

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

package/dist/{types-CXyKj6-K.d.ts → types-CsFP-H-U.d.ts}

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

package/dist/{types-CJz1Ebvb.d.ts → types-HEl2tS4P.d.ts}

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

package/dist/{types-BoqPXoUb.d.mts → types-f7idIVsm.d.mts}

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

package/dist/{types-DDX6K2-p.d.mts → types-kzYpX7wB.d.mts}

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

package/package.json

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