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

package/dist/chunk-P3TOAEG4.mjs

@@ -0,0 +1,56 @@
+// src/glassbox-routes/format.ts
+function formatAgo(iso, now = Date.now()) {
+  const t = Date.parse(iso);
+  if (Number.isNaN(t)) return iso;
+  const sec = Math.max(0, Math.floor((now - t) / 1e3));
+  if (sec < 60) return `${sec}s ago`;
+  if (sec < 3600) return `${Math.floor(sec / 60)}m ago`;
+  if (sec < 86400) return `${Math.floor(sec / 3600)}h ago`;
+  return `${Math.floor(sec / 86400)}d ago`;
+}
+function shortTraceId(traceId) {
+  return traceId.slice(-6);
+}
+function formatCost(usd) {
+  if (usd === void 0 || usd === null || Number.isNaN(usd)) return "\u2014";
+  if (usd === 0) return "$0.0000";
+  if (usd < 0.01) return `$${usd.toFixed(4)}`;
+  return `$${usd.toFixed(3)}`;
+}
+function formatMs(ms) {
+  if (ms === void 0 || ms === null) return "\u2014";
+  if (ms < 1e3) return `${ms}ms`;
+  return `${(ms / 1e3).toFixed(1)}s`;
+}
+function formatOrDash(v) {
+  if (v === void 0 || v === null) return "\u2014";
+  if (typeof v === "number") return v.toLocaleString();
+  return v;
+}
+function inputRatioLabel(status) {
+  switch (status) {
+    case "green":
+      return "healthy";
+    case "yellow":
+      return "borderline";
+    case "red":
+      return "input-heavy";
+  }
+}
+function formatMutation(mutation) {
+  const m = /^(.*)-(\d+)-to-(\d+)$/.exec(mutation);
+  if (m) {
+    return `${m[1]} (${m[2]} \u2192 ${m[3]})`;
+  }
+  return mutation;
+}
+
+export {
+  formatAgo,
+  shortTraceId,
+  formatCost,
+  formatMs,
+  formatOrDash,
+  inputRatioLabel,
+  formatMutation
+};

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

@@ -0,0 +1,24 @@
+import { T as TraceHealth } from '../types-DDX6K2-p.mjs';
+import '../ir-BAAHLfFL.mjs';
+import '../dialect.mjs';
+
+/**
+ * Pure formatting helpers for Glass-Box trace display.
+ *
+ * Zero deps, no React, no design tokens. Safe to import from any consumer
+ * (React component, server route, CLI, Edge worker).
+ *
+ * Extracted from the alpha.32 tt-intelligence reference component port in
+ * alpha.35 so multiple consumer dashboards can render trace data with
+ * matching formatting without re-implementing each helper.
+ */
+
+declare function formatAgo(iso: string, now?: number): string;
+declare function shortTraceId(traceId: string): string;
+declare function formatCost(usd: number | undefined | null): string;
+declare function formatMs(ms: number | undefined | null): string;
+declare function formatOrDash(v: number | string | undefined | null): string;
+declare function inputRatioLabel(status: TraceHealth['inputRatioStatus']): string;
+declare function formatMutation(mutation: string): string;
+
+export { formatAgo, formatCost, formatMs, formatMutation, formatOrDash, inputRatioLabel, shortTraceId };

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

@@ -0,0 +1,24 @@
+import { T as TraceHealth } from '../types-CJz1Ebvb.js';
+import '../ir-B_ygNURd.js';
+import '../dialect.js';
+
+/**
+ * Pure formatting helpers for Glass-Box trace display.
+ *
+ * Zero deps, no React, no design tokens. Safe to import from any consumer
+ * (React component, server route, CLI, Edge worker).
+ *
+ * Extracted from the alpha.32 tt-intelligence reference component port in
+ * alpha.35 so multiple consumer dashboards can render trace data with
+ * matching formatting without re-implementing each helper.
+ */
+
+declare function formatAgo(iso: string, now?: number): string;
+declare function shortTraceId(traceId: string): string;
+declare function formatCost(usd: number | undefined | null): string;
+declare function formatMs(ms: number | undefined | null): string;
+declare function formatOrDash(v: number | string | undefined | null): string;
+declare function inputRatioLabel(status: TraceHealth['inputRatioStatus']): string;
+declare function formatMutation(mutation: string): string;
+
+export { formatAgo, formatCost, formatMs, formatMutation, formatOrDash, inputRatioLabel, shortTraceId };

package/dist/glassbox-routes/format.js

@@ -0,0 +1,86 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/glassbox-routes/format.ts
+var format_exports = {};
+__export(format_exports, {
+  formatAgo: () => formatAgo,
+  formatCost: () => formatCost,
+  formatMs: () => formatMs,
+  formatMutation: () => formatMutation,
+  formatOrDash: () => formatOrDash,
+  inputRatioLabel: () => inputRatioLabel,
+  shortTraceId: () => shortTraceId
+});
+module.exports = __toCommonJS(format_exports);
+function formatAgo(iso, now = Date.now()) {
+  const t = Date.parse(iso);
+  if (Number.isNaN(t)) return iso;
+  const sec = Math.max(0, Math.floor((now - t) / 1e3));
+  if (sec < 60) return `${sec}s ago`;
+  if (sec < 3600) return `${Math.floor(sec / 60)}m ago`;
+  if (sec < 86400) return `${Math.floor(sec / 3600)}h ago`;
+  return `${Math.floor(sec / 86400)}d ago`;
+}
+function shortTraceId(traceId) {
+  return traceId.slice(-6);
+}
+function formatCost(usd) {
+  if (usd === void 0 || usd === null || Number.isNaN(usd)) return "\u2014";
+  if (usd === 0) return "$0.0000";
+  if (usd < 0.01) return `$${usd.toFixed(4)}`;
+  return `$${usd.toFixed(3)}`;
+}
+function formatMs(ms) {
+  if (ms === void 0 || ms === null) return "\u2014";
+  if (ms < 1e3) return `${ms}ms`;
+  return `${(ms / 1e3).toFixed(1)}s`;
+}
+function formatOrDash(v) {
+  if (v === void 0 || v === null) return "\u2014";
+  if (typeof v === "number") return v.toLocaleString();
+  return v;
+}
+function inputRatioLabel(status) {
+  switch (status) {
+    case "green":
+      return "healthy";
+    case "yellow":
+      return "borderline";
+    case "red":
+      return "input-heavy";
+  }
+}
+function formatMutation(mutation) {
+  const m = /^(.*)-(\d+)-to-(\d+)$/.exec(mutation);
+  if (m) {
+    return `${m[1]} (${m[2]} \u2192 ${m[3]})`;
+  }
+  return mutation;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  formatAgo,
+  formatCost,
+  formatMs,
+  formatMutation,
+  formatOrDash,
+  inputRatioLabel,
+  shortTraceId
+});

package/dist/glassbox-routes/format.mjs

@@ -0,0 +1,18 @@
+import {
+  formatAgo,
+  formatCost,
+  formatMs,
+  formatMutation,
+  formatOrDash,
+  inputRatioLabel,
+  shortTraceId
+} from "../chunk-P3TOAEG4.mjs";
+export {
+  formatAgo,
+  formatCost,
+  formatMs,
+  formatMutation,
+  formatOrDash,
+  inputRatioLabel,
+  shortTraceId
+};

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

@@ -1,153 +1,9 @@
 import { G as GlassboxEvent } from '../types-BoqPXoUb.mjs';
-import { i as Adapter, v as SectionKind } from '../ir-BAAHLfFL.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 '../dialect.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;
-}
-
 /**
  * proxy(req) — Glass-Box replay query handler.
  *
@@ -332,4 +188,4 @@ interface GlassboxRoutes {
 }
 declare function createGlassboxRoutes(config: GlassboxRoutesConfig): GlassboxRoutes;
 
-export { type AdvisoryRecord, COUNTERFACTUAL_MAX_RESULTS, COUNTERFACTUAL_MIN_SAVINGS_RATIO, type ComputeCounterfactualsArgs, type GlassboxRoutes, type GlassboxRoutesConfig, type TraceCounterfactual, type TraceDetail, type TraceHealth, type TraceSectionRewrite, type TraceSummary, computeCounterfactuals, createGlassboxRoutes, rowToDetail, rowToSummary };
+export { COUNTERFACTUAL_MAX_RESULTS, COUNTERFACTUAL_MIN_SAVINGS_RATIO, type ComputeCounterfactualsArgs, type GlassboxRoutes, type GlassboxRoutesConfig, TraceCounterfactual, TraceDetail, TraceSummary, computeCounterfactuals, createGlassboxRoutes, rowToDetail, rowToSummary };

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

@@ -1,153 +1,9 @@
 import { G as GlassboxEvent } from '../types-CXyKj6-K.js';
-import { i as Adapter, v as SectionKind } from '../ir-B_ygNURd.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 '../dialect.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;
-}
-
 /**
  * proxy(req) — Glass-Box replay query handler.
  *
@@ -332,4 +188,4 @@ interface GlassboxRoutes {
 }
 declare function createGlassboxRoutes(config: GlassboxRoutesConfig): GlassboxRoutes;
 
-export { type AdvisoryRecord, COUNTERFACTUAL_MAX_RESULTS, COUNTERFACTUAL_MIN_SAVINGS_RATIO, type ComputeCounterfactualsArgs, type GlassboxRoutes, type GlassboxRoutesConfig, type TraceCounterfactual, type TraceDetail, type TraceHealth, type TraceSectionRewrite, type TraceSummary, computeCounterfactuals, createGlassboxRoutes, rowToDetail, rowToSummary };
+export { COUNTERFACTUAL_MAX_RESULTS, COUNTERFACTUAL_MIN_SAVINGS_RATIO, type ComputeCounterfactualsArgs, type GlassboxRoutes, type GlassboxRoutesConfig, TraceCounterfactual, TraceDetail, TraceSummary, computeCounterfactuals, createGlassboxRoutes, rowToDetail, rowToSummary };

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

@@ -0,0 +1,74 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { a as TraceDetail } from '../../types-DDX6K2-p.mjs';
+import '../../ir-BAAHLfFL.mjs';
+import '../../dialect.mjs';
+
+/**
+ * GlassboxTheme — visual tokens consumed by <GlassboxTraceCard>.
+ *
+ * Pass via `theme` prop to override the neutral default with your dashboard's
+ * design system. All 14 tokens are required; spread the default and override
+ * what you need:
+ *
+ *   import { DEFAULT_GLASSBOX_THEME } from '@warmdrift/kgauto-compiler/glassbox-routes/react';
+ *   const myTheme = { ...DEFAULT_GLASSBOX_THEME, colors: { ...DEFAULT_GLASSBOX_THEME.colors, warn: '#C75B7A' } };
+ *
+ * The default is a deliberately neutral cool slate palette + system fonts —
+ * NOT tt-intelligence's warm brand. Consumers should override with their own
+ * brand tokens; the substrate stays brand-agnostic.
+ */
+interface GlassboxThemeColors {
+    /** Page/section background (behind cards). */
+    surface: string;
+    /** Card / row border. */
+    border: string;
+    /** Softer border for inner dividers. */
+    borderSoft: string;
+    /** Card background. */
+    cardBg: string;
+    /** Primary text. */
+    text: string;
+    /** Secondary text (labels, metadata). */
+    textMuted: string;
+    /** Tertiary text (annotations). */
+    textFaint: string;
+    /** Healthy / success state marker. */
+    ok: string;
+    /** Warning / borderline / coaching state marker. Reserved for state, not decoration. */
+    warn: string;
+    /** Failure / error state marker. */
+    fail: string;
+    /** Informational state marker (advisory link, counterfactual). */
+    info: string;
+}
+interface GlassboxThemeFonts {
+    /** UI sans-serif stack. */
+    sans: string;
+    /** Display / heading stack. */
+    serif: string;
+    /** Monospace stack for IDs, traceIds, raw payloads. */
+    mono: string;
+}
+interface GlassboxTheme {
+    colors: GlassboxThemeColors;
+    fonts: GlassboxThemeFonts;
+}
+declare const DEFAULT_GLASSBOX_THEME: GlassboxTheme;
+
+interface GlassboxTraceCardProps {
+    detail: TraceDetail;
+    /**
+     * Optional theme override. Defaults to a neutral cool slate palette + system
+     * fonts (NOT tt-intelligence's warm brand). Consumer dashboards should pass
+     * their own design tokens.
+     */
+    theme?: GlassboxTheme;
+}
+/**
+ * Render one TraceDetail as a stacked-card view. Server component (no
+ * client JS). Cards with empty data hide automatically per the alpha.28
+ * design contract.
+ */
+declare function GlassboxTraceCard({ detail, theme, }: GlassboxTraceCardProps): react_jsx_runtime.JSX.Element;
+
+export { DEFAULT_GLASSBOX_THEME, type GlassboxTheme, type GlassboxThemeColors, type GlassboxThemeFonts, GlassboxTraceCard, type GlassboxTraceCardProps };

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

@@ -0,0 +1,74 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { a as TraceDetail } from '../../types-CJz1Ebvb.js';
+import '../../ir-B_ygNURd.js';
+import '../../dialect.js';
+
+/**
+ * GlassboxTheme — visual tokens consumed by <GlassboxTraceCard>.
+ *
+ * Pass via `theme` prop to override the neutral default with your dashboard's
+ * design system. All 14 tokens are required; spread the default and override
+ * what you need:
+ *
+ *   import { DEFAULT_GLASSBOX_THEME } from '@warmdrift/kgauto-compiler/glassbox-routes/react';
+ *   const myTheme = { ...DEFAULT_GLASSBOX_THEME, colors: { ...DEFAULT_GLASSBOX_THEME.colors, warn: '#C75B7A' } };
+ *
+ * The default is a deliberately neutral cool slate palette + system fonts —
+ * NOT tt-intelligence's warm brand. Consumers should override with their own
+ * brand tokens; the substrate stays brand-agnostic.
+ */
+interface GlassboxThemeColors {
+    /** Page/section background (behind cards). */
+    surface: string;
+    /** Card / row border. */
+    border: string;
+    /** Softer border for inner dividers. */
+    borderSoft: string;
+    /** Card background. */
+    cardBg: string;
+    /** Primary text. */
+    text: string;
+    /** Secondary text (labels, metadata). */
+    textMuted: string;
+    /** Tertiary text (annotations). */
+    textFaint: string;
+    /** Healthy / success state marker. */
+    ok: string;
+    /** Warning / borderline / coaching state marker. Reserved for state, not decoration. */
+    warn: string;
+    /** Failure / error state marker. */
+    fail: string;
+    /** Informational state marker (advisory link, counterfactual). */
+    info: string;
+}
+interface GlassboxThemeFonts {
+    /** UI sans-serif stack. */
+    sans: string;
+    /** Display / heading stack. */
+    serif: string;
+    /** Monospace stack for IDs, traceIds, raw payloads. */
+    mono: string;
+}
+interface GlassboxTheme {
+    colors: GlassboxThemeColors;
+    fonts: GlassboxThemeFonts;
+}
+declare const DEFAULT_GLASSBOX_THEME: GlassboxTheme;
+
+interface GlassboxTraceCardProps {
+    detail: TraceDetail;
+    /**
+     * Optional theme override. Defaults to a neutral cool slate palette + system
+     * fonts (NOT tt-intelligence's warm brand). Consumer dashboards should pass
+     * their own design tokens.
+     */
+    theme?: GlassboxTheme;
+}
+/**
+ * Render one TraceDetail as a stacked-card view. Server component (no
+ * client JS). Cards with empty data hide automatically per the alpha.28
+ * design contract.
+ */
+declare function GlassboxTraceCard({ detail, theme, }: GlassboxTraceCardProps): react_jsx_runtime.JSX.Element;
+
+export { DEFAULT_GLASSBOX_THEME, type GlassboxTheme, type GlassboxThemeColors, type GlassboxThemeFonts, GlassboxTraceCard, type GlassboxTraceCardProps };