@warmdrift/kgauto-compiler 2.0.0-alpha.7 → 2.0.0-alpha.71

package/dist/profiles.mjs

@@ -1,14 +1,22 @@
 import {
   ALIASES,
+  LATENCY_TIER_MS,
+  _setProfileBrainHook,
   allProfiles,
+  allProfilesRaw,
   getProfile,
+  latencyTierOf,
   profilesByProvider,
   tryGetProfile
-} from "./chunk-MBEI5UOM.mjs";
+} from "./chunk-4UO4CCSP.mjs";
 export {
   ALIASES,
+  LATENCY_TIER_MS,
+  _setProfileBrainHook,
   allProfiles,
+  allProfilesRaw,
   getProfile,
+  latencyTierOf,
   profilesByProvider,
   tryGetProfile
 };

package/dist/types-B--CYzMo.d.ts

@@ -0,0 +1,131 @@
+import { s as MutationApplied, B as BestPracticeAdvisory, F as FallbackReason, m as CallAttempt } from './ir-BEQ28muo.js';
+
+/**
+ * Glass-Box observability types (alpha.17).
+ *
+ * The substrate for kgauto's in-flight observability surface — a Chrome MV3
+ * side panel that renders compile + execute + advisor outputs in real-time.
+ * See design doc:
+ *   ~/.gstack/projects/stue-kgauto/stgreen-claude-serene-williamson-51a105-design-20260518-175356.md
+ *
+ * Wire shape is intentionally minimal:
+ *   { kind, at, data } — discriminated union by `kind`.
+ *
+ * Critical-path safety (L-086 derived): emit MUST NEVER fail the user's
+ * `call()` invocation. emit.ts wraps every adapter write in try/catch +
+ * silently drops on error. Consumers in Vercel Edge runtimes can lose one
+ * event without losing the response.
+ */
+
+/**
+ * Discriminator. Six event kinds cover the v1 substrate. New kinds added
+ * additively; the side-panel renderer treats unknown kinds as "ignore".
+ */
+type GlassboxEventKind = 'compile.start' | 'compile.done' | 'execute.attempt' | 'execute.success' | 'advisory.fired' | 'fallback.walked';
+/**
+ * Wire envelope. Every emit lands as one of these.
+ *
+ *   - kind:    discriminator
+ *   - at:      unix milliseconds (Date.now())
+ *   - data:    kind-specific payload
+ *
+ * `data` typed loosely as Record<string, unknown> for serialization-friendliness;
+ * the per-kind builders below populate it with the structured shape expected
+ * by the renderer. We deliberately do NOT typescript-narrow `data` by kind on
+ * the wire type — the side panel reads JSON from SSE and only the renderer
+ * needs the narrowed shape. Internal callers (emit.ts) get type assistance via
+ * the typed factory helpers in emit.ts.
+ */
+interface GlassboxEvent {
+    kind: GlassboxEventKind;
+    at: number;
+    data: Record<string, unknown>;
+}
+/**
+ * Per-kind data shapes. Surfaced as type aids; not enforced at the
+ * GlassboxEvent boundary (intentionally — see comment above).
+ */
+interface CompileStartData {
+    appId: string;
+    archetype: string;
+    models: string[];
+}
+interface CompileDoneData {
+    target: string;
+    provider: string;
+    fallbackChain: string[];
+    tokensIn: number;
+    estimatedCostUsd: number;
+    mutationsApplied: MutationApplied[];
+    advisories: BestPracticeAdvisory[];
+}
+interface ExecuteAttemptData {
+    model: string;
+    attemptIndex: number;
+}
+interface ExecuteSuccessData {
+    model: string;
+    tokensIn: number;
+    tokensOut: number;
+    latencyMs: number;
+}
+interface AdvisoryFiredData {
+    code: string;
+    message: string;
+}
+interface FallbackWalkedData {
+    from: string;
+    to: string;
+    reason: FallbackReason | 'unknown';
+    attempt: CallAttempt;
+}
+/**
+ * Pub/sub backend interface. Two adapters implement it: in-memory (dev /
+ * single-process) and Upstash Redis Streams (Vercel Edge multi-instance).
+ *
+ * The choice is made at module load (NOT per-call) based on env-var presence:
+ *   if (UPSTASH_REDIS_URL && UPSTASH_REDIS_TOKEN) → Upstash
+ *   else                                          → in-memory
+ *
+ * Stream TTL: 60s after last event. After that, subscriber stream closes
+ * cleanly. The adapter owns its own TTL clock; subscribe() is agnostic.
+ */
+interface GlassboxPubSub {
+    /**
+     * Publish a single event to a channel key. The channel is an opaque
+     * namespaced string — callers build it via `traceChannel(traceId)` or
+     * `appChannel(appId)` (see pubsub-upstash.ts). Returns a promise that
+     * resolves after the event is durably appended (or rejects on adapter
+     * failure — callers in emit.ts always swallow rejections).
+     *
+     * Pre-alpha.26 the parameter was named `traceId` because there was only
+     * one channel namespace; alpha.26 added per-app channels for the
+     * "tail-all" Live tab subscription. Behavior identical to the adapters —
+     * they treat the value as an opaque key — but the rename surfaces the
+     * generalization at the type level.
+     */
+    publish(channelKey: string, event: GlassboxEvent): Promise<void>;
+    /**
+     * Subscribe to events on a channel key. Returns a ReadableStream that
+     * emits GlassboxEvent objects as they're published. The stream closes
+     * cleanly after the channel-level TTL elapses since the LAST event
+     * (rolling 60s).
+     *
+     * If no publisher writes to the channel within 60s of subscription, the
+     * stream closes empty.
+     */
+    subscribe(channelKey: string): ReadableStream<GlassboxEvent>;
+    /**
+     * Test-only escape hatch. Clears any in-memory state. Upstash adapter
+     * no-ops (server-side state isn't accessible from here). Tests reach for
+     * this between cases to keep adapters hermetic.
+     */
+    _reset?(): void;
+}
+/**
+ * TTL applied to a stream after each event. The design doc names 60s; this
+ * constant centralizes it so both adapters + tests agree.
+ */
+declare const GLASSBOX_STREAM_TTL_MS = 60000;
+
+export { type AdvisoryFiredData as A, type CompileDoneData as C, type ExecuteAttemptData as E, type FallbackWalkedData as F, type GlassboxEvent as G, type CompileStartData as a, type ExecuteSuccessData as b, GLASSBOX_STREAM_TTL_MS as c, type GlassboxEventKind as d, type GlassboxPubSub as e };

package/dist/types-BDFrJkma.d.mts

@@ -0,0 +1,131 @@
+import { s as MutationApplied, B as BestPracticeAdvisory, F as FallbackReason, m as CallAttempt } from './ir-CnnJST_N.mjs';
+
+/**
+ * Glass-Box observability types (alpha.17).
+ *
+ * The substrate for kgauto's in-flight observability surface — a Chrome MV3
+ * side panel that renders compile + execute + advisor outputs in real-time.
+ * See design doc:
+ *   ~/.gstack/projects/stue-kgauto/stgreen-claude-serene-williamson-51a105-design-20260518-175356.md
+ *
+ * Wire shape is intentionally minimal:
+ *   { kind, at, data } — discriminated union by `kind`.
+ *
+ * Critical-path safety (L-086 derived): emit MUST NEVER fail the user's
+ * `call()` invocation. emit.ts wraps every adapter write in try/catch +
+ * silently drops on error. Consumers in Vercel Edge runtimes can lose one
+ * event without losing the response.
+ */
+
+/**
+ * Discriminator. Six event kinds cover the v1 substrate. New kinds added
+ * additively; the side-panel renderer treats unknown kinds as "ignore".
+ */
+type GlassboxEventKind = 'compile.start' | 'compile.done' | 'execute.attempt' | 'execute.success' | 'advisory.fired' | 'fallback.walked';
+/**
+ * Wire envelope. Every emit lands as one of these.
+ *
+ *   - kind:    discriminator
+ *   - at:      unix milliseconds (Date.now())
+ *   - data:    kind-specific payload
+ *
+ * `data` typed loosely as Record<string, unknown> for serialization-friendliness;
+ * the per-kind builders below populate it with the structured shape expected
+ * by the renderer. We deliberately do NOT typescript-narrow `data` by kind on
+ * the wire type — the side panel reads JSON from SSE and only the renderer
+ * needs the narrowed shape. Internal callers (emit.ts) get type assistance via
+ * the typed factory helpers in emit.ts.
+ */
+interface GlassboxEvent {
+    kind: GlassboxEventKind;
+    at: number;
+    data: Record<string, unknown>;
+}
+/**
+ * Per-kind data shapes. Surfaced as type aids; not enforced at the
+ * GlassboxEvent boundary (intentionally — see comment above).
+ */
+interface CompileStartData {
+    appId: string;
+    archetype: string;
+    models: string[];
+}
+interface CompileDoneData {
+    target: string;
+    provider: string;
+    fallbackChain: string[];
+    tokensIn: number;
+    estimatedCostUsd: number;
+    mutationsApplied: MutationApplied[];
+    advisories: BestPracticeAdvisory[];
+}
+interface ExecuteAttemptData {
+    model: string;
+    attemptIndex: number;
+}
+interface ExecuteSuccessData {
+    model: string;
+    tokensIn: number;
+    tokensOut: number;
+    latencyMs: number;
+}
+interface AdvisoryFiredData {
+    code: string;
+    message: string;
+}
+interface FallbackWalkedData {
+    from: string;
+    to: string;
+    reason: FallbackReason | 'unknown';
+    attempt: CallAttempt;
+}
+/**
+ * Pub/sub backend interface. Two adapters implement it: in-memory (dev /
+ * single-process) and Upstash Redis Streams (Vercel Edge multi-instance).
+ *
+ * The choice is made at module load (NOT per-call) based on env-var presence:
+ *   if (UPSTASH_REDIS_URL && UPSTASH_REDIS_TOKEN) → Upstash
+ *   else                                          → in-memory
+ *
+ * Stream TTL: 60s after last event. After that, subscriber stream closes
+ * cleanly. The adapter owns its own TTL clock; subscribe() is agnostic.
+ */
+interface GlassboxPubSub {
+    /**
+     * Publish a single event to a channel key. The channel is an opaque
+     * namespaced string — callers build it via `traceChannel(traceId)` or
+     * `appChannel(appId)` (see pubsub-upstash.ts). Returns a promise that
+     * resolves after the event is durably appended (or rejects on adapter
+     * failure — callers in emit.ts always swallow rejections).
+     *
+     * Pre-alpha.26 the parameter was named `traceId` because there was only
+     * one channel namespace; alpha.26 added per-app channels for the
+     * "tail-all" Live tab subscription. Behavior identical to the adapters —
+     * they treat the value as an opaque key — but the rename surfaces the
+     * generalization at the type level.
+     */
+    publish(channelKey: string, event: GlassboxEvent): Promise<void>;
+    /**
+     * Subscribe to events on a channel key. Returns a ReadableStream that
+     * emits GlassboxEvent objects as they're published. The stream closes
+     * cleanly after the channel-level TTL elapses since the LAST event
+     * (rolling 60s).
+     *
+     * If no publisher writes to the channel within 60s of subscription, the
+     * stream closes empty.
+     */
+    subscribe(channelKey: string): ReadableStream<GlassboxEvent>;
+    /**
+     * Test-only escape hatch. Clears any in-memory state. Upstash adapter
+     * no-ops (server-side state isn't accessible from here). Tests reach for
+     * this between cases to keep adapters hermetic.
+     */
+    _reset?(): void;
+}
+/**
+ * TTL applied to a stream after each event. The design doc names 60s; this
+ * constant centralizes it so both adapters + tests agree.
+ */
+declare const GLASSBOX_STREAM_TTL_MS = 60000;
+
+export { type AdvisoryFiredData as A, type CompileDoneData as C, type ExecuteAttemptData as E, type FallbackWalkedData as F, type GlassboxEvent as G, type CompileStartData as a, type ExecuteSuccessData as b, GLASSBOX_STREAM_TTL_MS as c, type GlassboxEventKind as d, type GlassboxPubSub as e };

package/dist/types-DSeJJ6tt.d.ts

@@ -0,0 +1,149 @@
+import { i as Adapter, x as SectionKind } from './ir-BEQ28muo.js';
+
+/**
+ * Internal config + hook types for createGlassboxRoutes().
+ *
+ * The public contract lives on `GlassboxRoutesConfig` in ./index.ts; these
+ * are the narrower per-handler shapes consumed by proxy.ts and stream.ts.
+ */
+
+/**
+ * Wire contract for the Glass-Box Chrome extension's brain-poll endpoint.
+ *
+ * The list mode of `proxy(req)` returns `{ traces: TraceSummary[] }`. The
+ * detail mode (`?traceId=<id>`) returns a single `TraceDetail`. These are
+ * the camelCase shapes the extension renderer expects — distinct from the
+ * snake_case `compile_outcomes` row shape that PostgREST returns. The
+ * factory's typed `rowToSummary` / `rowToDetail` transformer is the single
+ * canonical boundary between the DB shape and the wire shape (see
+ * `feedback_typed_boundary_transformers.md` in kgauto memory for the rule).
+ */
+interface TraceSummary {
+    traceId: string;
+    appId: string;
+    archetype: string;
+    target: string;
+    createdAt: string;
+    tokensIn: number;
+    tokensOut: number;
+    estimatedCostUsd: number;
+}
+
+interface AdvisoryRecord {
+    level: 'info' | 'warn' | 'critical';
+    /** Stable advisory identifier, e.g. "caching-off-on-claude". */
+    code: string;
+    /** Consumer-renderable message — no internal jargon ("L-040", "R3" etc.). */
+    message: string;
+    /** Optional secondary one-liner. Renders below `message` in italics. */
+    suggestion?: string;
+    /** Deep link to the relevant section of `interfaces/kgauto.md` or docs. */
+    docsUrl?: string;
+    /**
+     * alpha.28+ — closed-union adaptation hint surfaced by the advisor when
+     * the advisory can be auto-mitigated by a config knob. Renderer surfaces
+     * as `→ try toolOrchestration: 'sequential'` on the advisory row.
+     *
+     * MUST stay byte-identical to Builder C's
+     * `BestPracticeAdvisory.suggestedAdaptation` shape (verified at Phase 2
+     * integration; the Adapter type itself is the contract).
+     */
+    suggestedAdaptation?: Adapter;
+}
+/**
+ * Cost-equivalent alternative the chain could have served. Computed at
+ * detail-view time by `computeCounterfactuals()` against the served row's
+ * observed token counts + archetype + cache state. Up to 2 entries, sorted
+ * cheapest first.
+ */
+interface TraceCounterfactual {
+    modelId: string;
+    estimatedCostUsd: number;
+    /** servedCostUsd - estimatedCostUsd (always > 0; only ≥10% savings kept). */
+    savingsUsd: number;
+    /** 0-100. */
+    savingsPercent: number;
+    /** Plain-English rationale tying archetype + perf score. */
+    reason: string;
+}
+/**
+ * Derived axis-health tri-state for the three Glass-Box dots
+ * (input-ratio · cache · fallback). Renderer reads; transformer computes.
+ *
+ * Thresholds (locked in design contract Phase 0):
+ *   - inputRatio: green ≤ 0.65 · yellow 0.65–0.85 · red > 0.85
+ *   - cache (only when historyCacheableTokens > 1000):
+ *       green if inputCacheHitRatio ≥ 0.5
+ *       yellow if 0.1 ≤ inputCacheHitRatio < 0.5
+ *       red if inputCacheHitRatio < 0.1
+ *       na if historyCacheableTokens ≤ 1000
+ *   - fallback: red iff fellOverFrom !== undefined && fellOverFrom !== target
+ */
+interface TraceHealth {
+    inputRatioStatus: 'green' | 'yellow' | 'red';
+    cacheStatus: 'green' | 'yellow' | 'red' | 'na';
+    fallbackStatus: 'green' | 'red';
+}
+/**
+ * alpha.29+ — wire-boundary representation of a translator section-rewrite.
+ *
+ * Distinct from the package-internal `SectionRewrite` type in `ir.ts`: this
+ * shape drops `originalText` + `transformedText` because those may carry
+ * consumer PII. The renderer shows the `rule` + `summary` only. Full text
+ * stays on `compile_outcomes.section_rewrites_applied` (Supabase row), gated
+ * by RLS for brain-side cross-app learning.
+ */
+interface TraceSectionRewrite {
+    /** Stable id of the rewritten section. */
+    sectionId: string;
+    /** Section-kind discriminator that triggered the rewrite. */
+    kind: SectionKind;
+    /** Stable rule identifier (e.g. `'sequential-tool-cliff-below-floor'`). */
+    rule: string;
+    /**
+     * Plain-English one-liner describing what fired and why. Renderer surfaces
+     * this on the Coaching card; no internal jargon ("L-040", "below floor").
+     */
+    summary: string;
+}
+interface TraceDetail extends TraceSummary {
+    mutationsApplied: string[];
+    advisories: AdvisoryRecord[];
+    rawRequest?: string;
+    rawResponse?: string;
+    /** Set when consumer passed a forceModel / fallback fired. */
+    requestedModel?: string;
+    /** Provider finish reason — 'stop' / 'max_tokens' / 'tool_use' / etc. */
+    finishReason?: string;
+    /** Time to first token (ms); populated when provider surfaces it. */
+    ttftMs?: number;
+    /** End-to-end wall-clock (ms); from migration 018. */
+    totalMs?: number;
+    /** Tools kept after relevance pass. */
+    toolsCount?: number;
+    /** Number of history messages at compile time. */
+    historyDepth?: number;
+    /** Rendered system prompt size in characters. */
+    systemPromptChars?: number;
+    cacheReadInputTokens: number;
+    cacheCreationInputTokens: number;
+    historyCacheableTokens: number;
+    /** Derived: cacheReadInputTokens / max(tokensIn, 1). 0-1. */
+    inputCacheHitRatio: number;
+    fellOverFrom?: string;
+    fallbackReason?: 'rate_limit' | 'provider_auth_failed' | 'provider_error' | 'cliff' | 'cost_cap' | 'contract_violation';
+    /** Up to 2 alternatives. Empty array (not undefined) when none qualify. */
+    counterfactuals?: TraceCounterfactual[];
+    /** Undefined when 7d volume < 5/day (insufficient data). */
+    projectedDailyCostUsd?: number;
+    /**
+     * alpha.29+ — translator activity for this trace. Empty array (not
+     * undefined) when no rewrites fired or pre-019 row. Surfaced in the
+     * Glass-Box Coaching card as synthetic info-level rows. PII-safe by
+     * construction: only sectionId + kind + rule + summary cross the wire.
+     */
+    sectionRewritesApplied: TraceSectionRewrite[];
+    health: TraceHealth;
+}
+
+export type { AdvisoryRecord as A, TraceHealth as T, TraceDetail as a, TraceSummary as b, TraceCounterfactual as c, TraceSectionRewrite as d };

package/dist/types-DeGRCTlJ.d.mts

@@ -0,0 +1,149 @@
+import { i as Adapter, x as SectionKind } from './ir-CnnJST_N.mjs';
+
+/**
+ * Internal config + hook types for createGlassboxRoutes().
+ *
+ * The public contract lives on `GlassboxRoutesConfig` in ./index.ts; these
+ * are the narrower per-handler shapes consumed by proxy.ts and stream.ts.
+ */
+
+/**
+ * Wire contract for the Glass-Box Chrome extension's brain-poll endpoint.
+ *
+ * The list mode of `proxy(req)` returns `{ traces: TraceSummary[] }`. The
+ * detail mode (`?traceId=<id>`) returns a single `TraceDetail`. These are
+ * the camelCase shapes the extension renderer expects — distinct from the
+ * snake_case `compile_outcomes` row shape that PostgREST returns. The
+ * factory's typed `rowToSummary` / `rowToDetail` transformer is the single
+ * canonical boundary between the DB shape and the wire shape (see
+ * `feedback_typed_boundary_transformers.md` in kgauto memory for the rule).
+ */
+interface TraceSummary {
+    traceId: string;
+    appId: string;
+    archetype: string;
+    target: string;
+    createdAt: string;
+    tokensIn: number;
+    tokensOut: number;
+    estimatedCostUsd: number;
+}
+
+interface AdvisoryRecord {
+    level: 'info' | 'warn' | 'critical';
+    /** Stable advisory identifier, e.g. "caching-off-on-claude". */
+    code: string;
+    /** Consumer-renderable message — no internal jargon ("L-040", "R3" etc.). */
+    message: string;
+    /** Optional secondary one-liner. Renders below `message` in italics. */
+    suggestion?: string;
+    /** Deep link to the relevant section of `interfaces/kgauto.md` or docs. */
+    docsUrl?: string;
+    /**
+     * alpha.28+ — closed-union adaptation hint surfaced by the advisor when
+     * the advisory can be auto-mitigated by a config knob. Renderer surfaces
+     * as `→ try toolOrchestration: 'sequential'` on the advisory row.
+     *
+     * MUST stay byte-identical to Builder C's
+     * `BestPracticeAdvisory.suggestedAdaptation` shape (verified at Phase 2
+     * integration; the Adapter type itself is the contract).
+     */
+    suggestedAdaptation?: Adapter;
+}
+/**
+ * Cost-equivalent alternative the chain could have served. Computed at
+ * detail-view time by `computeCounterfactuals()` against the served row's
+ * observed token counts + archetype + cache state. Up to 2 entries, sorted
+ * cheapest first.
+ */
+interface TraceCounterfactual {
+    modelId: string;
+    estimatedCostUsd: number;
+    /** servedCostUsd - estimatedCostUsd (always > 0; only ≥10% savings kept). */
+    savingsUsd: number;
+    /** 0-100. */
+    savingsPercent: number;
+    /** Plain-English rationale tying archetype + perf score. */
+    reason: string;
+}
+/**
+ * Derived axis-health tri-state for the three Glass-Box dots
+ * (input-ratio · cache · fallback). Renderer reads; transformer computes.
+ *
+ * Thresholds (locked in design contract Phase 0):
+ *   - inputRatio: green ≤ 0.65 · yellow 0.65–0.85 · red > 0.85
+ *   - cache (only when historyCacheableTokens > 1000):
+ *       green if inputCacheHitRatio ≥ 0.5
+ *       yellow if 0.1 ≤ inputCacheHitRatio < 0.5
+ *       red if inputCacheHitRatio < 0.1
+ *       na if historyCacheableTokens ≤ 1000
+ *   - fallback: red iff fellOverFrom !== undefined && fellOverFrom !== target
+ */
+interface TraceHealth {
+    inputRatioStatus: 'green' | 'yellow' | 'red';
+    cacheStatus: 'green' | 'yellow' | 'red' | 'na';
+    fallbackStatus: 'green' | 'red';
+}
+/**
+ * alpha.29+ — wire-boundary representation of a translator section-rewrite.
+ *
+ * Distinct from the package-internal `SectionRewrite` type in `ir.ts`: this
+ * shape drops `originalText` + `transformedText` because those may carry
+ * consumer PII. The renderer shows the `rule` + `summary` only. Full text
+ * stays on `compile_outcomes.section_rewrites_applied` (Supabase row), gated
+ * by RLS for brain-side cross-app learning.
+ */
+interface TraceSectionRewrite {
+    /** Stable id of the rewritten section. */
+    sectionId: string;
+    /** Section-kind discriminator that triggered the rewrite. */
+    kind: SectionKind;
+    /** Stable rule identifier (e.g. `'sequential-tool-cliff-below-floor'`). */
+    rule: string;
+    /**
+     * Plain-English one-liner describing what fired and why. Renderer surfaces
+     * this on the Coaching card; no internal jargon ("L-040", "below floor").
+     */
+    summary: string;
+}
+interface TraceDetail extends TraceSummary {
+    mutationsApplied: string[];
+    advisories: AdvisoryRecord[];
+    rawRequest?: string;
+    rawResponse?: string;
+    /** Set when consumer passed a forceModel / fallback fired. */
+    requestedModel?: string;
+    /** Provider finish reason — 'stop' / 'max_tokens' / 'tool_use' / etc. */
+    finishReason?: string;
+    /** Time to first token (ms); populated when provider surfaces it. */
+    ttftMs?: number;
+    /** End-to-end wall-clock (ms); from migration 018. */
+    totalMs?: number;
+    /** Tools kept after relevance pass. */
+    toolsCount?: number;
+    /** Number of history messages at compile time. */
+    historyDepth?: number;
+    /** Rendered system prompt size in characters. */
+    systemPromptChars?: number;
+    cacheReadInputTokens: number;
+    cacheCreationInputTokens: number;
+    historyCacheableTokens: number;
+    /** Derived: cacheReadInputTokens / max(tokensIn, 1). 0-1. */
+    inputCacheHitRatio: number;
+    fellOverFrom?: string;
+    fallbackReason?: 'rate_limit' | 'provider_auth_failed' | 'provider_error' | 'cliff' | 'cost_cap' | 'contract_violation';
+    /** Up to 2 alternatives. Empty array (not undefined) when none qualify. */
+    counterfactuals?: TraceCounterfactual[];
+    /** Undefined when 7d volume < 5/day (insufficient data). */
+    projectedDailyCostUsd?: number;
+    /**
+     * alpha.29+ — translator activity for this trace. Empty array (not
+     * undefined) when no rewrites fired or pre-019 row. Surfaced in the
+     * Glass-Box Coaching card as synthetic info-level rows. PII-safe by
+     * construction: only sectionId + kind + rule + summary cross the wire.
+     */
+    sectionRewritesApplied: TraceSectionRewrite[];
+    health: TraceHealth;
+}
+
+export type { AdvisoryRecord as A, TraceHealth as T, TraceDetail as a, TraceSummary as b, TraceCounterfactual as c, TraceSectionRewrite as d };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@warmdrift/kgauto-compiler",
-  "version": "2.0.0-alpha.7",
-  "description": "Prompt compiler + central learning brain for multi-model AI apps. Swap models without rewriting prompts.",
+  "version": "2.0.0-alpha.71",
+  "description": "Prompt compiler with executable provider knowledge for multi-model AI apps: normalized multi-provider transport with fallback chains, compile-time cliff guards, a curated model registry, and a telemetry flight recorder. Swap models without rewriting prompts.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -20,11 +20,44 @@
       "types": "./dist/profiles.d.ts",
       "import": "./dist/profiles.mjs",
       "require": "./dist/profiles.js"
+    },
+    "./brain-proxy": {
+      "types": "./dist/brain-proxy.d.ts",
+      "import": "./dist/brain-proxy.mjs",
+      "require": "./dist/brain-proxy.js"
+    },
+    "./key-health": {
+      "types": "./dist/key-health.d.ts",
+      "import": "./dist/key-health.mjs",
+      "require": "./dist/key-health.js"
+    },
+    "./glassbox": {
+      "types": "./dist/glassbox/index.d.ts",
+      "import": "./dist/glassbox/index.mjs",
+      "require": "./dist/glassbox/index.js"
+    },
+    "./glassbox-routes": {
+      "types": "./dist/glassbox-routes/index.d.ts",
+      "import": "./dist/glassbox-routes/index.mjs",
+      "require": "./dist/glassbox-routes/index.js"
+    },
+    "./glassbox-routes/format": {
+      "types": "./dist/glassbox-routes/format.d.ts",
+      "import": "./dist/glassbox-routes/format.mjs",
+      "require": "./dist/glassbox-routes/format.js"
+    },
+    "./glassbox-routes/react": {
+      "types": "./dist/glassbox-routes/react/index.d.ts",
+      "import": "./dist/glassbox-routes/react/index.mjs",
+      "require": "./dist/glassbox-routes/react/index.js"
     }
   },
-  "files": ["dist", "README.md"],
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
-    "build": "tsup src/index.ts src/dialect.ts src/profiles.ts --format cjs,esm --dts --clean",
+    "build": "tsup src/index.ts src/dialect.ts src/profiles.ts src/brain-proxy.ts src/key-health.ts src/glassbox/index.ts src/glassbox-routes/index.ts src/glassbox-routes/format.ts src/glassbox-routes/react/index.ts --format cjs,esm --dts --clean --external react --external react-dom",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
@@ -40,18 +73,31 @@
     "gemini",
     "deepseek",
     "prompt-cache",
-    "self-improving"
+    "model-fallback"
   ],
   "license": "MIT",
-  "dependencies": {},
   "peerDependencies": {
-    "js-tiktoken": ">=1.0.0"
+    "js-tiktoken": ">=1.0.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
   },
   "peerDependenciesMeta": {
-    "js-tiktoken": { "optional": true }
+    "js-tiktoken": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@types/node": "^22.10.0",
+    "@types/react": "^19.2.15",
+    "@types/react-dom": "^19.2.3",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
     "tsup": "^8.4.0",
     "typescript": "^5.7.0",
     "vitest": "^3.1.0"