@warmdrift/kgauto-compiler 2.0.0-alpha.26 → 2.0.0-alpha.28

package/dist/glassbox-routes/index.mjs

@@ -1,3 +1,10 @@
+import {
+  ARCHETYPE_FLOOR_DEFAULT,
+  getDefaultFallbackChain
+} from "../chunk-WXCFWUCN.mjs";
+import {
+  tryGetProfile
+} from "../chunk-JQGRWJZO.mjs";
 import {
   subscribe,
   subscribeApp
@@ -38,6 +45,151 @@ function checkAuth(req, config) {
   return null;
 }
 
+// src/glassbox-routes/counterfactuals.ts
+var COUNTERFACTUAL_MIN_SAVINGS_RATIO = 0.1;
+var COUNTERFACTUAL_MAX_RESULTS = 2;
+function computeCounterfactuals(args) {
+  const {
+    servedModel,
+    servedCostUsd,
+    archetype,
+    tokensIn,
+    tokensOut,
+    cacheReadInputTokens = 0,
+    toolOrchestration
+  } = args;
+  if (tokensIn <= 0) return [];
+  if (servedCostUsd <= 0) return [];
+  let chain;
+  try {
+    chain = getDefaultFallbackChain({
+      archetype,
+      posture: "open",
+      maxDepth: 10,
+      toolOrchestration
+    });
+  } catch {
+    return [];
+  }
+  const candidates = [];
+  const minSavings = servedCostUsd * COUNTERFACTUAL_MIN_SAVINGS_RATIO;
+  for (const modelId of chain) {
+    if (modelId === servedModel) continue;
+    const profile = tryGetProfile(modelId);
+    if (!profile) continue;
+    const perf = profile.archetypePerf?.[archetype] ?? 5;
+    if (perf < ARCHETYPE_FLOOR_DEFAULT) continue;
+    const estimated = estimateCostUsd({
+      profile,
+      tokensIn,
+      tokensOut,
+      cacheReadInputTokens
+    });
+    if (estimated === void 0) continue;
+    const savings = servedCostUsd - estimated;
+    if (savings < minSavings) continue;
+    const savingsPercent = Math.round(savings / servedCostUsd * 100);
+    const reason = buildReason({
+      modelId,
+      archetype,
+      perf,
+      profile
+    });
+    candidates.push({
+      modelId,
+      estimatedCostUsd: round6(estimated),
+      savingsUsd: round6(savings),
+      savingsPercent,
+      reason
+    });
+  }
+  candidates.sort((a, b) => a.estimatedCostUsd - b.estimatedCostUsd);
+  return candidates.slice(0, COUNTERFACTUAL_MAX_RESULTS);
+}
+function estimateCostUsd(args) {
+  const { profile, tokensIn, tokensOut, cacheReadInputTokens } = args;
+  const cacheableIn = Math.min(cacheReadInputTokens, tokensIn);
+  const nonCachedIn = Math.max(tokensIn - cacheableIn, 0);
+  const discount = profile.lowering.cache.discount ?? 1;
+  const inUsd = nonCachedIn / 1e6 * profile.costInputPer1m + cacheableIn / 1e6 * profile.costInputPer1m * discount;
+  const outUsd = tokensOut / 1e6 * profile.costOutputPer1m;
+  const total = inUsd + outUsd;
+  if (!Number.isFinite(total)) return void 0;
+  if (total < 0) return void 0;
+  return total;
+}
+function round6(n) {
+  return Math.round(n * 1e6) / 1e6;
+}
+function buildReason(args) {
+  const { modelId, archetype, perf, profile } = args;
+  const hook = profile.strengths?.[0];
+  const suffix = hook ? `, ${hook.replace(/_/g, " ")}` : "";
+  return `${modelId} on ${archetype}: archetypePerf=${perf}${suffix}`;
+}
+
+// src/glassbox-routes/projected-cost.ts
+var INSUFFICIENT_VOLUME_THRESHOLD = 5;
+var WINDOW_DAYS = 7;
+async function computeProjectedDailyCost(args) {
+  const {
+    appId,
+    archetype,
+    servedCostUsd,
+    brainEndpoint,
+    brainJwt,
+    brainAnonKey,
+    fetch: fetchImpl
+  } = args;
+  if (!appId || !archetype) return void 0;
+  if (!Number.isFinite(servedCostUsd) || servedCostUsd <= 0) return void 0;
+  const doFetch = fetchImpl ?? ((...a) => globalThis.fetch(...a));
+  const base = brainEndpoint.replace(/\/+$/, "");
+  const cutoffIso = new Date(
+    Date.now() - WINDOW_DAYS * 24 * 60 * 60 * 1e3
+  ).toISOString();
+  const qs = new URLSearchParams();
+  qs.set("app_id", `eq.${appId}`);
+  qs.set("intent_archetype", `eq.${archetype}`);
+  qs.set("created_at", `gte.${cutoffIso}`);
+  qs.set("select", "handle");
+  qs.set("limit", "0");
+  const url = `${base}/rest/v1/compile_outcomes?${qs.toString()}`;
+  let res;
+  try {
+    res = await doFetch(url, {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${brainJwt}`,
+        apikey: brainAnonKey,
+        Accept: "application/json",
+        // Triggers PostgREST exact count in Content-Range header.
+        Prefer: "count=exact"
+      }
+    });
+  } catch {
+    return void 0;
+  }
+  if (!res.ok) return void 0;
+  const contentRange = res.headers.get("content-range");
+  const count = parseContentRangeCount(contentRange);
+  if (count === void 0) return void 0;
+  const avgPerDay = count / WINDOW_DAYS;
+  if (avgPerDay < INSUFFICIENT_VOLUME_THRESHOLD) return void 0;
+  const projected = avgPerDay * servedCostUsd;
+  return Math.round(projected * 1e6) / 1e6;
+}
+function parseContentRangeCount(header) {
+  if (!header) return void 0;
+  const slash = header.lastIndexOf("/");
+  if (slash < 0) return void 0;
+  const tail = header.slice(slash + 1).trim();
+  if (tail === "*" || tail === "") return void 0;
+  const n = Number.parseInt(tail, 10);
+  if (!Number.isFinite(n) || n < 0) return void 0;
+  return n;
+}
+
 // src/glassbox-routes/proxy.ts
 var JSON_HEADERS2 = {
   "Content-Type": "application/json",
@@ -77,15 +229,151 @@ function rowToSummary(row) {
     estimatedCostUsd: typeof row.cost_usd_actual === "number" ? row.cost_usd_actual : 0
   };
 }
+var INPUT_RATIO_YELLOW = 0.65;
+var INPUT_RATIO_RED = 0.85;
+var CACHE_HEALTH_MIN_TOKENS = 1e3;
+var CACHE_RATIO_GREEN = 0.5;
+var CACHE_RATIO_YELLOW = 0.1;
+var FALLBACK_REASONS = /* @__PURE__ */ new Set([
+  "rate_limit",
+  "provider_auth_failed",
+  "provider_error",
+  "cliff",
+  "cost_cap",
+  "contract_violation"
+]);
+function asString(v) {
+  return typeof v === "string" && v.length > 0 ? v : void 0;
+}
+function asNumber(v) {
+  return typeof v === "number" && Number.isFinite(v) ? v : void 0;
+}
+function asNumberOrZero(v) {
+  return typeof v === "number" && Number.isFinite(v) ? v : 0;
+}
+function asStringArray(v) {
+  if (!Array.isArray(v)) return [];
+  const out = [];
+  for (const e of v) {
+    if (typeof e === "string") out.push(e);
+  }
+  return out;
+}
+function asFallbackReason(v) {
+  if (typeof v !== "string") return void 0;
+  const candidate = v;
+  if (candidate && FALLBACK_REASONS.has(candidate)) return candidate;
+  return "provider_error";
+}
+function rowToAdvisory(raw) {
+  if (!raw || typeof raw !== "object") return void 0;
+  const r = raw;
+  const level = r.level;
+  const code = r.code;
+  const message = r.message;
+  if (level !== "info" && level !== "warn" && level !== "critical" || typeof code !== "string" || typeof message !== "string") {
+    return void 0;
+  }
+  const out = { level, code, message };
+  const suggestion = asString(r.suggestion);
+  if (suggestion) out.suggestion = suggestion;
+  const docsUrl = asString(r.docs_url ?? r.docsUrl);
+  if (docsUrl) out.docsUrl = docsUrl;
+  const adapter = toAdapter(r.suggested_adaptation ?? r.suggestedAdaptation);
+  if (adapter) out.suggestedAdaptation = adapter;
+  return out;
+}
+function toAdapter(raw) {
+  if (!raw || typeof raw !== "object") return void 0;
+  const a = raw;
+  if (a.parameter === "toolOrchestration" && a.value === "sequential" && typeof a.consequence === "string") {
+    return {
+      parameter: "toolOrchestration",
+      value: "sequential",
+      consequence: a.consequence
+    };
+  }
+  return void 0;
+}
+function computeHealth(args) {
+  const {
+    tokensIn,
+    tokensOut,
+    historyCacheableTokens,
+    inputCacheHitRatio,
+    fellOverFrom,
+    target
+  } = args;
+  const total = tokensIn + tokensOut;
+  const ratio = total > 0 ? tokensIn / total : 0;
+  let inputRatioStatus;
+  if (ratio > INPUT_RATIO_RED) inputRatioStatus = "red";
+  else if (ratio > INPUT_RATIO_YELLOW) inputRatioStatus = "yellow";
+  else inputRatioStatus = "green";
+  let cacheStatus;
+  if (historyCacheableTokens <= CACHE_HEALTH_MIN_TOKENS) {
+    cacheStatus = "na";
+  } else if (inputCacheHitRatio >= CACHE_RATIO_GREEN) {
+    cacheStatus = "green";
+  } else if (inputCacheHitRatio >= CACHE_RATIO_YELLOW) {
+    cacheStatus = "yellow";
+  } else {
+    cacheStatus = "red";
+  }
+  const fallbackStatus = fellOverFrom !== void 0 && fellOverFrom !== target ? "red" : "green";
+  return { inputRatioStatus, cacheStatus, fallbackStatus };
+}
 function rowToDetail(row) {
-  return {
-    ...rowToSummary(row),
-    mutationsApplied: Array.isArray(row.mutations_applied) ? row.mutations_applied : [],
-    advisories: [],
-    // compile_outcomes has no advisories column today
-    rawRequest: row.prompt_preview ?? void 0,
-    rawResponse: row.response_preview ?? void 0
+  const summary = rowToSummary(row);
+  const tokensIn = summary.tokensIn;
+  const tokensOut = summary.tokensOut;
+  const cacheReadInputTokens = asNumberOrZero(row.cache_read_input_tokens);
+  const cacheCreationInputTokens = asNumberOrZero(
+    row.cache_creation_input_tokens
+  );
+  const historyCacheableTokens = asNumberOrZero(row.history_cacheable_tokens);
+  const inputCacheHitRatio = tokensIn > 0 ? cacheReadInputTokens / tokensIn : 0;
+  const fellOverFrom = asString(row.fell_over_from);
+  const fallbackReasonRaw = row.fallback_reason;
+  const fallbackReason = fellOverFrom ? asFallbackReason(fallbackReasonRaw) : void 0;
+  const requestedModel = asString(row.requested_model) ?? fellOverFrom;
+  const advisoriesRaw = Array.isArray(row.advisories) ? row.advisories : [];
+  const advisories = [];
+  for (const a of advisoriesRaw) {
+    const rec = rowToAdvisory(a);
+    if (rec) advisories.push(rec);
+  }
+  const health = computeHealth({
+    tokensIn,
+    tokensOut,
+    cacheReadInputTokens,
+    historyCacheableTokens,
+    inputCacheHitRatio,
+    fellOverFrom,
+    target: summary.target
+  });
+  const detail = {
+    ...summary,
+    mutationsApplied: asStringArray(row.mutations_applied),
+    advisories,
+    rawRequest: asString(row.prompt_preview),
+    rawResponse: asString(row.response_preview),
+    requestedModel,
+    finishReason: asString(row.finish_reason),
+    ttftMs: asNumber(row.ttft_ms),
+    totalMs: asNumber(row.total_ms) ?? asNumber(row.latency_ms),
+    toolsCount: asNumber(row.tools_count),
+    historyDepth: asNumber(row.history_depth),
+    systemPromptChars: asNumber(row.system_prompt_chars),
+    cacheReadInputTokens,
+    cacheCreationInputTokens,
+    historyCacheableTokens,
+    inputCacheHitRatio,
+    fellOverFrom,
+    fallbackReason,
+    health
   };
+  return detail;
 }
 function createProxyHandler(config) {
   const {
@@ -157,7 +445,31 @@ function createProxyHandler(config) {
     if (traceId) {
       const first = scrubbed[0];
       if (!first) return jsonError2(404, "not_found");
-      return jsonResponse(200, rowToDetail(first));
+      const detail = rowToDetail(first);
+      const counterfactuals = computeCounterfactuals({
+        servedModel: detail.target,
+        servedCostUsd: detail.estimatedCostUsd,
+        archetype: detail.archetype,
+        tokensIn: detail.tokensIn,
+        tokensOut: detail.tokensOut,
+        cacheReadInputTokens: detail.cacheReadInputTokens
+      });
+      detail.counterfactuals = counterfactuals;
+      if (detail.estimatedCostUsd > 0) {
+        const projected = await computeProjectedDailyCost({
+          appId: detail.appId,
+          archetype: detail.archetype,
+          servedCostUsd: detail.estimatedCostUsd,
+          brainEndpoint: base,
+          brainJwt,
+          brainAnonKey,
+          fetch: doFetch
+        });
+        if (projected !== void 0) {
+          detail.projectedDailyCostUsd = projected;
+        }
+      }
+      return jsonResponse(200, detail);
     }
     return jsonResponse(200, { traces: scrubbed.map(rowToSummary) });
   };

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, R as RecordInput, e as RecordOutcomeInput, O as OutcomeResult, f as OracleScore, g as CompileResult, B as BestPracticeAdvisory, h as PerAxisMetrics, i as Provider, j as ChainEntry, G as Grounding } from './ir-B9zqlwjH.mjs';
-export { k as CallAttempt, l as CallError, m as ChainWithGrounding, n as Constraints, F as FallbackReason, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, o as MutationApplied, p as NormalizedTokens, q as OutcomeKind, r as PerAxisMetricsByModel, s as PromptSection, T as ToolCall, t as ToolDefinition } from './ir-B9zqlwjH.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, R as RecordInput, e as RecordOutcomeInput, O as OutcomeResult, f as OracleScore, g as CompileResult, B as BestPracticeAdvisory, h as Adapter, i as PerAxisMetrics, j as Provider, k as ChainEntry, G as Grounding } from './ir-MXCJA8L7.mjs';
+export { l as CallAttempt, m as CallError, n as ChainWithGrounding, o as Constraints, F as FallbackReason, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, p as MutationApplied, q as NormalizedTokens, r as OutcomeKind, s as PerAxisMetricsByModel, t as PromptSection, T as ToolCall, u as ToolDefinition } from './ir-MXCJA8L7.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';
@@ -205,6 +205,13 @@ interface OutcomePayload {
      * cliff lumps DeepSeek sequential perf with parallel without this).
      */
     tool_orchestration?: 'parallel' | 'sequential' | 'either' | null;
+    finish_reason?: string;
+    total_ms?: number;
+    tools_count?: number;
+    history_depth?: number;
+    system_prompt_chars?: number;
+    fell_over_from?: string;
+    fallback_reason?: 'rate_limit' | 'provider_auth_failed' | 'provider_error' | 'cliff' | 'cost_cap' | 'contract_violation';
 }
 /**
  * alpha.20 Entry 4: record a quality outcome for a previously-compiled call.
@@ -358,6 +365,180 @@ interface RunAdvisorPhase2Context {
  */
 declare function runAdvisor(ir: PromptIR, result: AdvisorContext, profile: ModelProfile, policy?: CompilePolicy, phase2?: RunAdvisorPhase2Context): BestPracticeAdvisory[];
 
+/**
+ * Archetype-cliff compatibility — alpha.28 (tt-intel-Cairn ratified).
+ *
+ * One question, one answer: *given this model and this intent, can it work
+ * — and if not, what adapter (if any) would make it work?*
+ *
+ * Replaces the silent-archetype-cliff failure mode where a consumer picks a
+ * model that's structurally wrong for the intent and kgauto compiles cleanly
+ * without surfacing the gap. The triggering incident: tt-intel shipped
+ * `deepseek-v4-pro` as the hunt default per a local spec; the kgauto coord
+ * doc said L-040 — V4 is structurally wrong for hunt (sequential tools).
+ * `archetypePerf.hunt = 4` was already in the profile data. The compiler
+ * stayed silent. This API + the matching advisor rule surfaces it.
+ *
+ * Pure function. No network. No brain query. No side effects. ~1ms.
+ *
+ * Consultation doc:
+ *   command-center/advisory/kgauto/2026-05-21_archetype-cliff-advisor.md
+ *
+ * Refinements applied per tt-intel-Cairn ratification (2026-05-21):
+ *   R1: every variant carries `archetypePerf: number` (raw score) — and
+ *       `requires-adapter` adds `archetypePerfWithAdapter: number` so
+ *       consumer policy can be expressed as "accept adapter only when score
+ *       crosses some threshold WITH the adapter on."
+ *   R2: every variant carries a plain-English `reason: string`. No internal
+ *       jargon ("L-040", "archetypePerf=4") — the consumer chooses whether
+ *       to render it as UI hint or operator-tooling tooltip.
+ *   R3: `Adapter` is a CLOSED discriminated union, not `| string`. alpha.28
+ *       ships ONE variant (`toolOrchestration: 'sequential'`). Future
+ *       adapter parameters extend the union explicitly in named releases.
+ *       NO escape hatch — the whole point is catching "I added a new
+ *       adapter and forgot to update consumer policy" at compile time.
+ */
+
+/**
+ * Minimum `archetypePerf[archetype]` score to count as `compatible` under
+ * Option A (default policy). Below this, a documented adapter is needed
+ * to lift the model above the floor; if no adapter exists, the model is
+ * rejected.
+ *
+ * Matches `QUALITY_FLOOR_FOR_RECOMMENDATION` in `advisor.ts` — kgauto's
+ * library-wide convention for "below this score, swap recommendations stop."
+ */
+declare const ARCHETYPE_FLOOR_DEFAULT = 6;
+/**
+ * Absolute floor — below this, the cliff is too steep for ANY adapter to
+ * lift cleanly. Reserved under Option A (unused today; every below-floor
+ * case is gated by adapter availability). Would gate `reject` vs
+ * `requires-adapter` under a future Option B per consultation doc Q1.
+ *
+ * Exported so consumer-side policy can read it (e.g. "accept adapter only
+ * when archetypePerf >= ABSOLUTE_FLOOR + 1"). Not used internally by
+ * `getModelCompatibility` today — the gate is "does an adapter exist for
+ * this cliff?", not score-based.
+ */
+declare const ABSOLUTE_FLOOR = 4;
+/**
+ * The intent the call is expressing — archetype + optional orchestration
+ * mode. Same shape as `ir.intent.archetype` + `ir.constraints.toolOrchestration`
+ * so a consumer can pass `{ archetype: ir.intent.archetype,
+ * toolOrchestration: ir.constraints?.toolOrchestration }` directly.
+ */
+interface CompatibilityIntent {
+    archetype: IntentArchetypeName;
+    toolOrchestration?: 'parallel' | 'sequential' | 'either';
+}
+/**
+ * `Adapter` — re-exported above. Canonical definition lives in `ir.ts` to
+ * avoid an import cycle (compatibility.ts → profiles.ts → ir.ts).
+ *
+ * **CLOSED discriminated union per R3.** Future adapter parameters extend
+ * the union explicitly in named alpha releases. No `| string` escape hatch
+ * — consumer policy code SHOULD write exhaustive `switch (adapter.parameter)`
+ * and rely on the compiler to flag "I added a new adapter parameter and
+ * forgot to update the consumer's policy."
+ *
+ * alpha.28 variants:
+ *   - `{ parameter: 'toolOrchestration'; value: 'sequential'; consequence }`
+ *     Lifts DeepSeek V4-family on `hunt` from sequential-tool cliff (L-040).
+ *     The "consequence" plain-English-ifies the trade-off:
+ *     "Tool calls run one at a time — slower but reliable."
+ *
+ * alpha.29+ likely additions (per tt-intel-Cairn priority list):
+ *   - `{ parameter: 'parallelToolCalls'; value: false; consequence }`
+ *   - `{ parameter: 'maxTools'; value: number; consequence }`
+ *   - `{ parameter: 'thinkingBudget'; value: 0; consequence }`
+ *
+ * Each new variant lands in its own named release with the union extended
+ * in `ir.ts`. Consumers see the change at compile time.
+ */
+/**
+ * The compatibility verdict for a (model, intent) pair. Discriminated union
+ * on `status` — `compatible` | `requires-adapter` | `reject`.
+ *
+ * **Every variant carries `archetypePerf` (R1) + `reason` (R2):**
+ * - `archetypePerf` — the raw 0-10 score for (model, archetype). Lets
+ *   consumers build their own thresholds without re-importing the profile
+ *   registry.
+ * - `reason` — plain-English, consumer-renderable. NOT internal jargon
+ *   like "L-040 cliff" or "archetypePerf=4". Examples in R2 ratification:
+ *   - compatible:        "Suited for hunt-style parallel discovery."
+ *   - requires-adapter:  "Best with sequential tool calls for hunt — slower but works."
+ *   - reject:            "Not suited for hunt — would underperform significantly."
+ *
+ * `requires-adapter` additionally carries:
+ * - `archetypePerfWithAdapter` — estimated post-adapter score. May be an
+ *   estimate (we don't measure post-adapter scores yet); kgauto's prior is
+ *   "adapter lifts to ARCHETYPE_FLOOR_DEFAULT + 1" unless brain-evidenced.
+ * - `adapter` — the closed-union variant describing the structural change.
+ *
+ * Backward-compat: an unknown model returns `reject` with a "model not
+ * registered" reason; callers never throw. Unknown archetype is impossible
+ * at the type level (`IntentArchetypeName` is a closed union).
+ */
+type ModelCompatibility = {
+    status: 'compatible';
+    reason: string;
+    archetypePerf: number;
+} | {
+    status: 'requires-adapter';
+    reason: string;
+    archetypePerf: number;
+    archetypePerfWithAdapter: number;
+    adapter: Adapter;
+} | {
+    status: 'reject';
+    reason: string;
+    archetypePerf: number;
+};
+/**
+ * Compatibility query — *does this model fit this intent, and if not,
+ * what would?*
+ *
+ * **Rules (Option A from consultation doc Q1):**
+ * 1. If model is unregistered → `reject` with "model not registered" reason.
+ * 2. If intent provides `toolOrchestration: 'sequential'` AND that adapter
+ *    silences the cliff (because the cliff IS the sequential-tool one)
+ *    → return `compatible` with raw score (NOT the post-adapter estimate
+ *    — caller already paid the adapter, score reflects reality).
+ * 3. If raw `archetypePerf[archetype] >= ARCHETYPE_FLOOR_DEFAULT`
+ *    → `compatible`.
+ * 4. If below floor BUT a documented adapter exists that lifts to floor
+ *    → `requires-adapter` with adapter + estimated post-adapter score.
+ * 5. If below floor AND no adapter exists → `reject`.
+ *
+ * **Pure function.** Deterministic for `(modelId, intent)`. No I/O.
+ *
+ * @example
+ * ```ts
+ * import { getModelCompatibility } from '@warmdrift/kgauto-compiler';
+ *
+ * const c = getModelCompatibility('deepseek-v4-pro', { archetype: 'hunt' });
+ * // → { status: 'requires-adapter',
+ * //     reason: 'Best with sequential tool calls for hunt — slower but works.',
+ * //     archetypePerf: 4,
+ * //     archetypePerfWithAdapter: 7,
+ * //     adapter: {
+ * //       parameter: 'toolOrchestration',
+ * //       value: 'sequential',
+ * //       consequence: 'Tool calls run one at a time...'
+ * //     } }
+ *
+ * // With the adapter already declared:
+ * const c2 = getModelCompatibility('deepseek-v4-pro', {
+ *   archetype: 'hunt',
+ *   toolOrchestration: 'sequential',
+ * });
+ * // → { status: 'compatible',
+ * //     reason: 'Suited for hunt with sequential tool calls.',
+ * //     archetypePerf: 4 }
+ * ```
+ */
+declare function getModelCompatibility(modelId: string, intent: CompatibilityIntent): ModelCompatibility;
+
 /**
  * alpha.22 — sync introspection: is brain-query mode active for a given
  * table? Used by the advisor (`model-stale-evidence` rule) to decide
@@ -943,4 +1124,4 @@ declare const loadAliasesFromBrain: () => Record<string, string>;
  */
 declare function compile(ir: PromptIR, opts?: CompileOptions): CompileResult;
 
-export { ApiKeys, type AppOracle, type ArchetypePerfMap, type ArchetypePerfNMap, type ArchetypePerfScoreResult, BestPracticeAdvisory, type BrainConfig, type BrainQueryConfig, CallOptions, CallResult, ChainEntry, type CompileOptions, CompilePolicy, CompileResult, CompiledRequest, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type FallbackPosture, type GetDefaultFallbackChainOpts, type GetPerAxisMetricsOpts, Grounding, IntentArchetypeName, type LLMJudgeOptions, MEASURED_GROUNDING_MIN_N, type ModelBrainRow, ModelProfile, NormalizedResponse, type OracleContext, OracleScore, type OutcomePayload, OutcomeResult, PROVIDER_ENV_KEYS, PerAxisMetrics, type PricingRow, type ProfileToRowOptions, PromptIR, Provider, ProviderOverrides, type ProviderReachability, type ReachabilityOpts, RecordInput, RecordOutcomeInput, type RunAdvisorPhase2Context, type SupportedProvider, buildLLMJudge, call, clearBrain, compile, configureBrain, countTokens, execute, getAllStarterChains, getAllStarterChainsWithGrounding, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getPerAxisMetrics, getReachabilityDiagnostic, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStarterChain, getStarterChainWithGrounding, isBrainQueryActiveFor, isModelReachable, isProviderReachable, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, profileToRow, record, recordOutcome, resetTokenizer, resolvePricingAt, resolveProviderKey, runAdvisor, setTokenizer };
+export { ABSOLUTE_FLOOR, ARCHETYPE_FLOOR_DEFAULT, Adapter, ApiKeys, type AppOracle, type ArchetypePerfMap, type ArchetypePerfNMap, type ArchetypePerfScoreResult, BestPracticeAdvisory, type BrainConfig, type BrainQueryConfig, CallOptions, CallResult, ChainEntry, type CompatibilityIntent, type CompileOptions, CompilePolicy, CompileResult, CompiledRequest, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type FallbackPosture, type GetDefaultFallbackChainOpts, type GetPerAxisMetricsOpts, Grounding, IntentArchetypeName, type LLMJudgeOptions, MEASURED_GROUNDING_MIN_N, type ModelBrainRow, type ModelCompatibility, ModelProfile, NormalizedResponse, type OracleContext, OracleScore, type OutcomePayload, OutcomeResult, PROVIDER_ENV_KEYS, PerAxisMetrics, type PricingRow, type ProfileToRowOptions, PromptIR, Provider, ProviderOverrides, type ProviderReachability, type ReachabilityOpts, RecordInput, RecordOutcomeInput, type RunAdvisorPhase2Context, type SupportedProvider, buildLLMJudge, call, clearBrain, compile, configureBrain, countTokens, execute, getAllStarterChains, getAllStarterChainsWithGrounding, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStarterChain, getStarterChainWithGrounding, isBrainQueryActiveFor, isModelReachable, isProviderReachable, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, profileToRow, record, recordOutcome, resetTokenizer, resolvePricingAt, resolveProviderKey, runAdvisor, setTokenizer };