@warmdrift/kgauto-compiler 2.0.0-alpha.79 → 2.0.0-alpha.80

package/dist/{chunk-DRYCOR6G.mjs → chunk-CIBHU67M.mjs}

@@ -1,5 +1,5 @@
 // src/version.ts
-var LIBRARY_VERSION = "2.0.0-alpha.79";
+var LIBRARY_VERSION = "2.0.0-alpha.80";
 
 // src/key-health.ts
 var JSON_HEADERS = { "Content-Type": "application/json" };

package/dist/{chunk-FT2FN6ZP.mjs → chunk-PMTT4H5W.mjs}

@@ -1,4 +1,5 @@
 import {
+  allProfiles,
   tryGetProfile
 } from "./chunk-VVRDFE6T.mjs";
 
@@ -253,6 +254,63 @@ function getModelCompatibility(modelId, intent) {
   };
 }
 
+// src/archetype-perf-brain.ts
+function isPerfRow(x) {
+  if (!x || typeof x !== "object") return false;
+  const r = x;
+  return typeof r.model_id === "string" && typeof r.archetype === "string" && typeof r.perf_score === "number";
+}
+function mapRowsToPerfMap(rows) {
+  const out = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    if (!isPerfRow(row)) continue;
+    const existing = out.get(row.model_id) ?? {};
+    existing[row.archetype] = row.perf_score;
+    out.set(row.model_id, existing);
+  }
+  return out;
+}
+function mapRowsToNMap(rows) {
+  const out = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    if (!isPerfRow(row)) continue;
+    if (typeof row.n !== "number") continue;
+    const existing = out.get(row.model_id) ?? {};
+    existing[row.archetype] = row.n;
+    out.set(row.model_id, existing);
+  }
+  return out;
+}
+function bundledArchetypePerf() {
+  const out = /* @__PURE__ */ new Map();
+  for (const profile of allProfiles()) {
+    if (profile.archetypePerf) out.set(profile.id, profile.archetypePerf);
+  }
+  return out;
+}
+function bundledArchetypePerfN() {
+  return /* @__PURE__ */ new Map();
+}
+var loadArchetypePerfFromBrain = createBrainQueryCache({
+  table: "kgauto_archetype_perf",
+  mapRows: mapRowsToPerfMap,
+  bundledFallback: bundledArchetypePerf
+});
+var loadArchetypePerfNFromBrain = createBrainQueryCache(
+  {
+    table: "kgauto_archetype_perf",
+    mapRows: mapRowsToNMap,
+    bundledFallback: bundledArchetypePerfN
+  }
+);
+var MEASURED_GROUNDING_MIN_N = 10;
+function getArchetypePerfScore(modelId, archetype) {
+  const score = loadArchetypePerfFromBrain().get(modelId)?.[archetype] ?? 5;
+  const n = loadArchetypePerfNFromBrain().get(modelId)?.[archetype] ?? 0;
+  const grounding = n >= MEASURED_GROUNDING_MIN_N ? "measured" : "judgment";
+  return { score, n, grounding };
+}
+
 // src/env.ts
 var SUPPORTED_PROVIDERS = Object.freeze([
   "anthropic",
@@ -350,6 +408,26 @@ function isSameModelRetryEnabledFromEnv(envSource = defaultEnv()) {
 }
 
 // src/fallback.ts
+var COST_RANKING_REFERENCE_SHAPE = {
+  inputTokens: 4e3,
+  outputTokens: 250
+};
+function estimateChainCostUsd(profile, shape = COST_RANKING_REFERENCE_SHAPE) {
+  return shape.inputTokens / 1e6 * profile.costInputPer1m + shape.outputTokens / 1e6 * profile.costOutputPer1m;
+}
+function buildCostOrderedChain(archetype) {
+  return allProfiles().filter((p) => p.status === "current").filter(
+    (p) => getArchetypePerfScore(p.id, archetype).score >= ARCHETYPE_FLOOR_DEFAULT
+  ).map((p) => ({ p, cost: estimateChainCostUsd(p) })).sort((a, b) => a.cost - b.cost || a.p.id.localeCompare(b.p.id)).map((e) => e.p.id);
+}
+function chainProviderSpread(chain) {
+  const providers = /* @__PURE__ */ new Set();
+  for (const id of chain) {
+    const p = tryGetProfile(id);
+    if (p) providers.add(p.provider);
+  }
+  return providers.size;
+}
 var STARTER_CHAINS_GROUNDED = {
   // Reasoning floor — never degrade. Walk UP on 429 to Opus → cross-provider.
   critique: [
@@ -486,19 +564,28 @@ function resolveStarterForMode(archetype, toolOrchestration, allChains) {
   return allChains[archetype];
 }
 function getDefaultFallbackChain(opts) {
-  const { archetype, primary, maxDepth = 4, policy, reachability, toolOrchestration } = opts;
+  const {
+    archetype,
+    primary,
+    maxDepth = 4,
+    policy,
+    reachability,
+    toolOrchestration,
+    optimizeFor = "quality"
+  } = opts;
   if (maxDepth < 1) {
     throw new Error(
       `getDefaultFallbackChain: maxDepth must be >= 1, got ${maxDepth}`
     );
   }
   const allChains = loadChainsFromBrain();
-  const starter = resolveStarterForMode(archetype, toolOrchestration, allChains);
-  if (!starter) {
+  const qualityStarter = resolveStarterForMode(archetype, toolOrchestration, allChains);
+  if (!qualityStarter) {
     throw new Error(
       `getDefaultFallbackChain: unknown archetype "${archetype}". Known: ${Object.keys(allChains).join(", ")}`
     );
   }
+  const starter = optimizeFor === "cost" ? buildCostOrderedChain(archetype) : qualityStarter;
   let chain;
   if (primary) {
     chain = [primary, ...starter.filter((id) => id !== primary)];
@@ -710,6 +797,10 @@ export {
   ARCHETYPE_FLOOR_DEFAULT,
   ABSOLUTE_FLOOR,
   getModelCompatibility,
+  loadArchetypePerfFromBrain,
+  loadArchetypePerfNFromBrain,
+  MEASURED_GROUNDING_MIN_N,
+  getArchetypePerfScore,
   PROVIDER_ENV_KEYS,
   resolveProviderKey,
   isProviderReachable,
@@ -719,6 +810,9 @@ export {
   readBrainReadEnv,
   isSameModelRetryEnabledFromEnv,
   loadChainsFromBrain,
+  COST_RANKING_REFERENCE_SHAPE,
+  estimateChainCostUsd,
+  chainProviderSpread,
   getDefaultFallbackChain,
   getStarterChain,
   getAllStarterChains,

package/dist/glassbox-routes/index.js

@@ -1724,6 +1724,9 @@ function tryGetProfile(id) {
   const canonical = canonicalId(id);
   return brainHook.getProfile?.(canonical) ?? PROFILE_INDEX.get(canonical);
 }
+function allProfiles() {
+  return PROFILES_RAW;
+}
 
 // src/env.ts
 var SUPPORTED_PROVIDERS = Object.freeze([
@@ -1888,7 +1891,79 @@ var loadChainsFromBrain = createBrainQueryCache({
   bundledFallback: getAllStarterChains
 });
 
+// src/archetype-perf-brain.ts
+function isPerfRow(x) {
+  if (!x || typeof x !== "object") return false;
+  const r = x;
+  return typeof r.model_id === "string" && typeof r.archetype === "string" && typeof r.perf_score === "number";
+}
+function mapRowsToPerfMap(rows) {
+  const out = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    if (!isPerfRow(row)) continue;
+    const existing = out.get(row.model_id) ?? {};
+    existing[row.archetype] = row.perf_score;
+    out.set(row.model_id, existing);
+  }
+  return out;
+}
+function mapRowsToNMap(rows) {
+  const out = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    if (!isPerfRow(row)) continue;
+    if (typeof row.n !== "number") continue;
+    const existing = out.get(row.model_id) ?? {};
+    existing[row.archetype] = row.n;
+    out.set(row.model_id, existing);
+  }
+  return out;
+}
+function bundledArchetypePerf() {
+  const out = /* @__PURE__ */ new Map();
+  for (const profile of allProfiles()) {
+    if (profile.archetypePerf) out.set(profile.id, profile.archetypePerf);
+  }
+  return out;
+}
+function bundledArchetypePerfN() {
+  return /* @__PURE__ */ new Map();
+}
+var loadArchetypePerfFromBrain = createBrainQueryCache({
+  table: "kgauto_archetype_perf",
+  mapRows: mapRowsToPerfMap,
+  bundledFallback: bundledArchetypePerf
+});
+var loadArchetypePerfNFromBrain = createBrainQueryCache(
+  {
+    table: "kgauto_archetype_perf",
+    mapRows: mapRowsToNMap,
+    bundledFallback: bundledArchetypePerfN
+  }
+);
+var MEASURED_GROUNDING_MIN_N = 10;
+function getArchetypePerfScore(modelId, archetype) {
+  const score = loadArchetypePerfFromBrain().get(modelId)?.[archetype] ?? 5;
+  const n = loadArchetypePerfNFromBrain().get(modelId)?.[archetype] ?? 0;
+  const grounding = n >= MEASURED_GROUNDING_MIN_N ? "measured" : "judgment";
+  return { score, n, grounding };
+}
+
+// src/compatibility.ts
+var ARCHETYPE_FLOOR_DEFAULT = 6;
+
 // src/fallback.ts
+var COST_RANKING_REFERENCE_SHAPE = {
+  inputTokens: 4e3,
+  outputTokens: 250
+};
+function estimateChainCostUsd(profile, shape = COST_RANKING_REFERENCE_SHAPE) {
+  return shape.inputTokens / 1e6 * profile.costInputPer1m + shape.outputTokens / 1e6 * profile.costOutputPer1m;
+}
+function buildCostOrderedChain(archetype) {
+  return allProfiles().filter((p) => p.status === "current").filter(
+    (p) => getArchetypePerfScore(p.id, archetype).score >= ARCHETYPE_FLOOR_DEFAULT
+  ).map((p) => ({ p, cost: estimateChainCostUsd(p) })).sort((a, b) => a.cost - b.cost || a.p.id.localeCompare(b.p.id)).map((e) => e.p.id);
+}
 var STARTER_CHAINS_GROUNDED = {
   // Reasoning floor — never degrade. Walk UP on 429 to Opus → cross-provider.
   critique: [
@@ -2025,19 +2100,28 @@ function resolveStarterForMode(archetype, toolOrchestration, allChains) {
   return allChains[archetype];
 }
 function getDefaultFallbackChain(opts) {
-  const { archetype, primary, maxDepth = 4, policy, reachability, toolOrchestration } = opts;
+  const {
+    archetype,
+    primary,
+    maxDepth = 4,
+    policy,
+    reachability,
+    toolOrchestration,
+    optimizeFor = "quality"
+  } = opts;
   if (maxDepth < 1) {
     throw new Error(
       `getDefaultFallbackChain: maxDepth must be >= 1, got ${maxDepth}`
     );
   }
   const allChains = loadChainsFromBrain();
-  const starter = resolveStarterForMode(archetype, toolOrchestration, allChains);
-  if (!starter) {
+  const qualityStarter = resolveStarterForMode(archetype, toolOrchestration, allChains);
+  if (!qualityStarter) {
     throw new Error(
       `getDefaultFallbackChain: unknown archetype "${archetype}". Known: ${Object.keys(allChains).join(", ")}`
     );
   }
+  const starter = optimizeFor === "cost" ? buildCostOrderedChain(archetype) : qualityStarter;
   let chain;
   if (primary) {
     chain = [primary, ...starter.filter((id) => id !== primary)];
@@ -2070,9 +2154,6 @@ function getAllStarterChains() {
   return out;
 }
 
-// src/compatibility.ts
-var ARCHETYPE_FLOOR_DEFAULT = 6;
-
 // src/glassbox-routes/counterfactuals.ts
 var COUNTERFACTUAL_MIN_SAVINGS_RATIO = 0.1;
 var COUNTERFACTUAL_MAX_RESULTS = 2;

package/dist/glassbox-routes/index.mjs

@@ -1,7 +1,7 @@
 import {
   ARCHETYPE_FLOOR_DEFAULT,
   getDefaultFallbackChain
-} from "../chunk-FT2FN6ZP.mjs";
+} from "../chunk-PMTT4H5W.mjs";
 import {
   tryGetProfile
 } from "../chunk-VVRDFE6T.mjs";

package/dist/index.d.mts

@@ -1146,7 +1146,7 @@ declare function runStrategyEvalWithAttribution(opts: Omit<GoldenEvalOptions, 'a
  * guard in `tests/version.test.ts` fails the suite (and therefore
  * `prepublishOnly`) when they diverge — a stale constant cannot reach npm.
  */
-declare const LIBRARY_VERSION = "2.0.0-alpha.79";
+declare const LIBRARY_VERSION = "2.0.0-alpha.80";
 
 /**
  * Oracle contract — how an app tells the brain whether a response was good.
@@ -2391,12 +2391,35 @@ declare function readBrainReadEnv(envSource?: Record<string, string | undefined>
  *   preferred — caller passes `primary`; chain returned is [primary, ...fallbacks]
  *   open      — caller passes no `primary`; chain returned is [best, ...fallbacks]
  *
- * The chain at each step:
- *   1. Costs strictly less than the previous (no expensive sideways moves)
- *   2. Comes from a different provider than the previous step where possible
+ * ## What the default chain optimizes for — READ THIS BEFORE CITING IT
+ *
+ * The default (`optimizeFor: 'quality'`) chain is ordered by **archetype
+ * performance with provider diversity**, NOT by cost. It is a reliability
+ * ladder: "if tier 0 fails, who else can do this job well."
+ *
+ * This docstring previously claimed each step "costs strictly less than the
+ * previous." **That claim was false for all ten archetypes** (verified
+ * 2026-07-29, alpha.80) and it was load-bearing — kgauto's own cost
+ * advisories cited `posture: 'open'` as a cost remedy on the strength of it.
+ * For `ask`, open posture leads with `claude-sonnet-4-6` at ~8.6x the cost
+ * of the model the cost advisories recommend. tt-intel came within one
+ * un-run function call of tripling their hottest path's spend by following
+ * kgauto's own documented advice. See
+ * `advisory/kgauto/from-tt-intelligence/2026-07-28_chain-builder-and-cost-advisories-give-opposite-answers.md`.
+ *
+ * Some non-monotone steps are deliberate and correct: `plan` walks UP to
+ * Opus on 429, `critique`/`judge` never degrade below a reasoning floor,
+ * and cross-provider anchors are chosen for outage-independence rather
+ * than price. The defect was the unconditional claim, not the chains.
+ *
+ * The default chain at each step:
+ *   1. Comes from a different provider than the previous step where possible
  *      (correlated outages don't kill consecutive attempts)
- *   3. Stays above the archetype's perf floor (skip models scored <baseline
+ *   2. Stays above the archetype's perf floor (skip models scored <baseline
  *      for archetypes where degradation would be unacceptable)
+ *   3. Makes NO cost guarantee. Pass `optimizeFor: 'cost'` when cost order
+ *      is what you want — that mode DOES guarantee monotone-cheaper, and
+ *      `assertChainCostMonotonicity` pins it.
  *
  * In alpha.9 the chain is **hand-curated** per archetype (§3.3 starter
  * table). Brain-query mode lands in alpha.10. Policy.blockedModels filters
@@ -2475,7 +2498,58 @@ interface GetDefaultFallbackChainOpts {
      * pre-alpha.20 callers.
      */
     toolOrchestration?: 'parallel' | 'sequential' | 'either';
+    /**
+     * alpha.80 — what the chain ORDER optimizes for.
+     *
+     *   'quality' (default) — status quo, byte-for-byte. Hand-curated /
+     *      brain-loaded archetype ladder: best perf first, provider diversity
+     *      down the chain. Makes NO cost guarantee (see module docstring).
+     *
+     *   'cost' — cheapest-first among every `status: 'current'` model whose
+     *      `archetypePerf[archetype]` clears {@link ARCHETYPE_FLOOR_DEFAULT}.
+     *      Guarantees monotone-cheaper. Considers the WHOLE roster, not just
+     *      the curated chain — which is the point: `gemini-2.5-flash` ties
+     *      `claude-haiku-4-5` on `ask` perf at a third of the price and is
+     *      absent from the curated `ask` ladder entirely.
+     *
+     * The quality floor is what keeps 'cost' honest: a model with no evidence
+     * scores the neutral 5 and is therefore excluded, so cost mode can never
+     * bottom-feed into unmeasured models. Quality stays a binary floor; cost
+     * optimizes only above it.
+     *
+     * Default 'quality' — existing consumers see zero change on bump.
+     */
+    optimizeFor?: 'quality' | 'cost';
 }
+/**
+ * Reference call shape used to RANK models by cost. Deliberately a blend
+ * rather than input-only: ranking by `costInputPer1m` alone (which the
+ * advisor's `cost-mismatched-archetype` rule does) mis-orders any pair
+ * whose output multiple differs, and real traffic runs input-heavy
+ * (L-050: >85% input is the universal efficiency signal).
+ *
+ * This ranks; it does not bill. `estimateChainCostUsd` is exported so
+ * callers who know their real shape can compute against it instead.
+ */
+declare const COST_RANKING_REFERENCE_SHAPE: {
+    readonly inputTokens: 4000;
+    readonly outputTokens: 250;
+};
+/**
+ * Estimated USD for one call at a given shape. Exported so the advisor and
+ * consumer-side code share ONE derivation of "what does this model cost
+ * here" — two independent derivations of one concept will drift (s75).
+ */
+declare function estimateChainCostUsd(profile: ModelProfile, shape?: {
+    inputTokens: number;
+    outputTokens: number;
+}): number;
+/**
+ * How many distinct providers a chain spans. `1` means every fallback shares
+ * one provider's fate — the chain buys you retries, not outage independence.
+ * Exported so a cost-mode consumer can check what they traded away.
+ */
+declare function chainProviderSpread(chain: readonly string[]): number;
 /**
  * Returns the fallback chain for an archetype as a plain `string[]` of
  * model ids.
@@ -3680,4 +3754,4 @@ declare function planDecomposition(args: PlanDecompositionArgs): DecompositionPl
  */
 declare function compile(ir: PromptIR, opts?: CompileOptions): CompileResult;
 
-export { ABSOLUTE_FLOOR, type AISDKConvertedMessage, ARCHETYPE_FAMILY_FITS, ARCHETYPE_FLOOR_DEFAULT, type ActionableAdvisory, Adapter, type AdvisoryResolutionSource, type AdvisorySeverity, type AdvisoryStatus, type AdvisorySuggestedFix, ApiKeys, type AppOracle, type ApplySectionRewritesArgs, type ApplySectionRewritesResult, ArchetypeConvention, type ArchetypeFamilyFit, type ArchetypePerfMap, type ArchetypePerfNMap, type ArchetypePerfScoreResult, type AttachCacheControlResult, BRAIN_READ_ENV_NAMES, BestPracticeAdvisory, type BrainConfig, type BrainDeadLetterEntry, type BrainHealthSnapshot, type BrainQueryConfig, type BrainReadEnv, COACH_CFG, CallOptions, CallResult, ChainEntry, type CompatibilityIntent, type CompileForAISDKv6Result, type CompileOptions, CompilePolicy, CompileResult, CompiledRequest, type CreateDelegateOpts, DECOMPOSITION_TEMPLATES, DECOMPOSITION_TEMPLATES_VERSION, DEFAULT_FINDINGS_ENDPOINT, DEFAULT_MEASURED_FAILURE_ENDPOINT, DEFAULT_PROMOTIONS_ENDPOINT, DELEGATE_TOOL_DEFINITION, DISCIPLINE_GATES_V1_ALT_HEADER, type DecompositionPlan, type DecompositionStep, type DecompositionTemplate, type DelegateHandle, type DelegateRefusalReason, type DelegateResult, type DelegateToolArgs, type ExclusionFindingRow, type ExclusionResolutionSource, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type ExecutorCandidate, type FallbackPosture, FallbackReason, FamilyResolutionError, type GetActionableAdvisoriesOptions, type GetApplicablePromotionOpts, type GetDefaultFallbackChainOpts, type GetMeasuredFailureOpts, type GetPerAxisMetricsOpts, type GetRecommendedPrimaryOptions, type GoldenEvalAxis, type GoldenEvalCase, type GoldenEvalOptions, type GoldenEvalRunResult, type GoldenEvalStrategyId, type GoldenIrRecordInput, Grounding, IntentArchetypeName, JUDGE_RUBRICS, LIBRARY_VERSION, type LLMJudgeOptions, MEASURED_FAILURE_CFG, MEASURED_GROUNDING_MIN_N, type MarkAdvisoryResolvedOptions, type MarkExclusionFindingHandledOptions, type MarkPromoteReadyHandledOptions, type MeasuredFailureRuntime, type MeasuredFailureVerdict, type ModelBrainRow, type ModelCompatibility, ModelProfile, NormalizedResponse, type OracleContext, OracleScore, type OutcomePayload, OutcomeResult, OutputMode, PRODUCER_OWNED_RULE_CODES, PROVIDER_ENV_KEYS, PerAxisMetrics, type PlannedStep, type PricingRow, type ProbeShadowOptions, type ProbeShadowServed, type ProfileToRowOptions, type PromoteReadyFindingRow, type PromoteReadyResolution, type PromotionRow, type PromotionsRuntime, PromptIR, Provider, ProviderOverrides, type ProviderReachability, ROLLBACK_SUPPRESSION_WINDOW_DAYS, RULE_DISCIPLINE_GATES_V1, RULE_DISCIPLINE_GATES_V1_STRUCTURED, RULE_SEQUENTIAL_TOOL_CLIFF, type ReachabilityOpts, RecordInput, RecordOutcomeInput, type RunAdvisorPhase2Context, STRATEGY_AUTHORSHIP_LIMITATION, SectionRewrite, type ShadowProbeRecordInput, type StrategyAttribution, type StrategyAttributionResult, type StrategyOutcome, type SupportedProvider, type SurfaceFailureRow, type SurfaceStats, SystemModelMessage, TRANSLATOR_FLOOR, _testResetMeasuredFailure, _testResetPromotions, _testWaitForMeasuredFailureRefresh, _testWaitForPromotionsRefresh, altGatesBlockFor, applyArchetypeConvention, applySectionRewrites, attachCacheControlToStreamTextInput, awaitMeasuredFailureReady, brainHealth, buildGoldenIrRow, buildLLMJudge, buildPairwiseJudgePrompt, buildShadowProbeRow, call, classifyStrategyOutcome, clearBrain, combineOrderSwappedVerdicts, compile, compileForAISDKv6, configureBrain, configureMeasuredFailureBrain, configurePromotionsBrain, countTokens, createDelegate, deriveFamilyFromModelId, deriveOwnership, execute, findBetterFit, flushBrainDeadLetter, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getApplicablePromotion, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getMeasuredFailureVerdict, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecentRollback, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isAutoPromoteEnabledFromEnv, isBrainQueryActiveFor, isBrainSync, isDelegateEnabledFromEnv, isExclusionFindingsBrainActive, isMeasuredFailureBrainActive, isMeasuredFailureGateEnabledFromEnv, isModelReachable, isPromotionsBrainActive, isProviderReachable, judgeMeasuredFailure, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, mapMeasuredFailureRows, markAdvisoryResolved, markExclusionFindingHandled, markPromoteReadyHandled, parseJudgeVerdict, peekBrainDeadLetter, planDecomposition, prefetchMeasuredFailure, probeShadow, profileToRow, readBrainReadEnv, record, recordGoldenIr, recordOutcome, recordShadowProbe, renderIrForJudge, resetTokenizer, resolveConventionsForProfile, resolvePricingAt, resolveProviderKey, rubricFor, runAdvisor, runGoldenEval, runStrategyEvalWithAttribution, setTokenizer, wilsonLowerBound, withAltDisciplineContract, withDisciplineContract };
+export { ABSOLUTE_FLOOR, type AISDKConvertedMessage, ARCHETYPE_FAMILY_FITS, ARCHETYPE_FLOOR_DEFAULT, type ActionableAdvisory, Adapter, type AdvisoryResolutionSource, type AdvisorySeverity, type AdvisoryStatus, type AdvisorySuggestedFix, ApiKeys, type AppOracle, type ApplySectionRewritesArgs, type ApplySectionRewritesResult, ArchetypeConvention, type ArchetypeFamilyFit, type ArchetypePerfMap, type ArchetypePerfNMap, type ArchetypePerfScoreResult, type AttachCacheControlResult, BRAIN_READ_ENV_NAMES, BestPracticeAdvisory, type BrainConfig, type BrainDeadLetterEntry, type BrainHealthSnapshot, type BrainQueryConfig, type BrainReadEnv, COACH_CFG, COST_RANKING_REFERENCE_SHAPE, CallOptions, CallResult, ChainEntry, type CompatibilityIntent, type CompileForAISDKv6Result, type CompileOptions, CompilePolicy, CompileResult, CompiledRequest, type CreateDelegateOpts, DECOMPOSITION_TEMPLATES, DECOMPOSITION_TEMPLATES_VERSION, DEFAULT_FINDINGS_ENDPOINT, DEFAULT_MEASURED_FAILURE_ENDPOINT, DEFAULT_PROMOTIONS_ENDPOINT, DELEGATE_TOOL_DEFINITION, DISCIPLINE_GATES_V1_ALT_HEADER, type DecompositionPlan, type DecompositionStep, type DecompositionTemplate, type DelegateHandle, type DelegateRefusalReason, type DelegateResult, type DelegateToolArgs, type ExclusionFindingRow, type ExclusionResolutionSource, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type ExecutorCandidate, type FallbackPosture, FallbackReason, FamilyResolutionError, type GetActionableAdvisoriesOptions, type GetApplicablePromotionOpts, type GetDefaultFallbackChainOpts, type GetMeasuredFailureOpts, type GetPerAxisMetricsOpts, type GetRecommendedPrimaryOptions, type GoldenEvalAxis, type GoldenEvalCase, type GoldenEvalOptions, type GoldenEvalRunResult, type GoldenEvalStrategyId, type GoldenIrRecordInput, Grounding, IntentArchetypeName, JUDGE_RUBRICS, LIBRARY_VERSION, type LLMJudgeOptions, MEASURED_FAILURE_CFG, MEASURED_GROUNDING_MIN_N, type MarkAdvisoryResolvedOptions, type MarkExclusionFindingHandledOptions, type MarkPromoteReadyHandledOptions, type MeasuredFailureRuntime, type MeasuredFailureVerdict, type ModelBrainRow, type ModelCompatibility, ModelProfile, NormalizedResponse, type OracleContext, OracleScore, type OutcomePayload, OutcomeResult, OutputMode, PRODUCER_OWNED_RULE_CODES, PROVIDER_ENV_KEYS, PerAxisMetrics, type PlannedStep, type PricingRow, type ProbeShadowOptions, type ProbeShadowServed, type ProfileToRowOptions, type PromoteReadyFindingRow, type PromoteReadyResolution, type PromotionRow, type PromotionsRuntime, PromptIR, Provider, ProviderOverrides, type ProviderReachability, ROLLBACK_SUPPRESSION_WINDOW_DAYS, RULE_DISCIPLINE_GATES_V1, RULE_DISCIPLINE_GATES_V1_STRUCTURED, RULE_SEQUENTIAL_TOOL_CLIFF, type ReachabilityOpts, RecordInput, RecordOutcomeInput, type RunAdvisorPhase2Context, STRATEGY_AUTHORSHIP_LIMITATION, SectionRewrite, type ShadowProbeRecordInput, type StrategyAttribution, type StrategyAttributionResult, type StrategyOutcome, type SupportedProvider, type SurfaceFailureRow, type SurfaceStats, SystemModelMessage, TRANSLATOR_FLOOR, _testResetMeasuredFailure, _testResetPromotions, _testWaitForMeasuredFailureRefresh, _testWaitForPromotionsRefresh, altGatesBlockFor, applyArchetypeConvention, applySectionRewrites, attachCacheControlToStreamTextInput, awaitMeasuredFailureReady, brainHealth, buildGoldenIrRow, buildLLMJudge, buildPairwiseJudgePrompt, buildShadowProbeRow, call, chainProviderSpread, classifyStrategyOutcome, clearBrain, combineOrderSwappedVerdicts, compile, compileForAISDKv6, configureBrain, configureMeasuredFailureBrain, configurePromotionsBrain, countTokens, createDelegate, deriveFamilyFromModelId, deriveOwnership, estimateChainCostUsd, execute, findBetterFit, flushBrainDeadLetter, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getApplicablePromotion, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getMeasuredFailureVerdict, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecentRollback, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isAutoPromoteEnabledFromEnv, isBrainQueryActiveFor, isBrainSync, isDelegateEnabledFromEnv, isExclusionFindingsBrainActive, isMeasuredFailureBrainActive, isMeasuredFailureGateEnabledFromEnv, isModelReachable, isPromotionsBrainActive, isProviderReachable, judgeMeasuredFailure, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, mapMeasuredFailureRows, markAdvisoryResolved, markExclusionFindingHandled, markPromoteReadyHandled, parseJudgeVerdict, peekBrainDeadLetter, planDecomposition, prefetchMeasuredFailure, probeShadow, profileToRow, readBrainReadEnv, record, recordGoldenIr, recordOutcome, recordShadowProbe, renderIrForJudge, resetTokenizer, resolveConventionsForProfile, resolvePricingAt, resolveProviderKey, rubricFor, runAdvisor, runGoldenEval, runStrategyEvalWithAttribution, setTokenizer, wilsonLowerBound, withAltDisciplineContract, withDisciplineContract };

package/dist/index.d.ts

@@ -1146,7 +1146,7 @@ declare function runStrategyEvalWithAttribution(opts: Omit<GoldenEvalOptions, 'a
  * guard in `tests/version.test.ts` fails the suite (and therefore
  * `prepublishOnly`) when they diverge — a stale constant cannot reach npm.
  */
-declare const LIBRARY_VERSION = "2.0.0-alpha.79";
+declare const LIBRARY_VERSION = "2.0.0-alpha.80";
 
 /**
  * Oracle contract — how an app tells the brain whether a response was good.
@@ -2391,12 +2391,35 @@ declare function readBrainReadEnv(envSource?: Record<string, string | undefined>
  *   preferred — caller passes `primary`; chain returned is [primary, ...fallbacks]
  *   open      — caller passes no `primary`; chain returned is [best, ...fallbacks]
  *
- * The chain at each step:
- *   1. Costs strictly less than the previous (no expensive sideways moves)
- *   2. Comes from a different provider than the previous step where possible
+ * ## What the default chain optimizes for — READ THIS BEFORE CITING IT
+ *
+ * The default (`optimizeFor: 'quality'`) chain is ordered by **archetype
+ * performance with provider diversity**, NOT by cost. It is a reliability
+ * ladder: "if tier 0 fails, who else can do this job well."
+ *
+ * This docstring previously claimed each step "costs strictly less than the
+ * previous." **That claim was false for all ten archetypes** (verified
+ * 2026-07-29, alpha.80) and it was load-bearing — kgauto's own cost
+ * advisories cited `posture: 'open'` as a cost remedy on the strength of it.
+ * For `ask`, open posture leads with `claude-sonnet-4-6` at ~8.6x the cost
+ * of the model the cost advisories recommend. tt-intel came within one
+ * un-run function call of tripling their hottest path's spend by following
+ * kgauto's own documented advice. See
+ * `advisory/kgauto/from-tt-intelligence/2026-07-28_chain-builder-and-cost-advisories-give-opposite-answers.md`.
+ *
+ * Some non-monotone steps are deliberate and correct: `plan` walks UP to
+ * Opus on 429, `critique`/`judge` never degrade below a reasoning floor,
+ * and cross-provider anchors are chosen for outage-independence rather
+ * than price. The defect was the unconditional claim, not the chains.
+ *
+ * The default chain at each step:
+ *   1. Comes from a different provider than the previous step where possible
  *      (correlated outages don't kill consecutive attempts)
- *   3. Stays above the archetype's perf floor (skip models scored <baseline
+ *   2. Stays above the archetype's perf floor (skip models scored <baseline
  *      for archetypes where degradation would be unacceptable)
+ *   3. Makes NO cost guarantee. Pass `optimizeFor: 'cost'` when cost order
+ *      is what you want — that mode DOES guarantee monotone-cheaper, and
+ *      `assertChainCostMonotonicity` pins it.
  *
  * In alpha.9 the chain is **hand-curated** per archetype (§3.3 starter
  * table). Brain-query mode lands in alpha.10. Policy.blockedModels filters
@@ -2475,7 +2498,58 @@ interface GetDefaultFallbackChainOpts {
      * pre-alpha.20 callers.
      */
     toolOrchestration?: 'parallel' | 'sequential' | 'either';
+    /**
+     * alpha.80 — what the chain ORDER optimizes for.
+     *
+     *   'quality' (default) — status quo, byte-for-byte. Hand-curated /
+     *      brain-loaded archetype ladder: best perf first, provider diversity
+     *      down the chain. Makes NO cost guarantee (see module docstring).
+     *
+     *   'cost' — cheapest-first among every `status: 'current'` model whose
+     *      `archetypePerf[archetype]` clears {@link ARCHETYPE_FLOOR_DEFAULT}.
+     *      Guarantees monotone-cheaper. Considers the WHOLE roster, not just
+     *      the curated chain — which is the point: `gemini-2.5-flash` ties
+     *      `claude-haiku-4-5` on `ask` perf at a third of the price and is
+     *      absent from the curated `ask` ladder entirely.
+     *
+     * The quality floor is what keeps 'cost' honest: a model with no evidence
+     * scores the neutral 5 and is therefore excluded, so cost mode can never
+     * bottom-feed into unmeasured models. Quality stays a binary floor; cost
+     * optimizes only above it.
+     *
+     * Default 'quality' — existing consumers see zero change on bump.
+     */
+    optimizeFor?: 'quality' | 'cost';
 }
+/**
+ * Reference call shape used to RANK models by cost. Deliberately a blend
+ * rather than input-only: ranking by `costInputPer1m` alone (which the
+ * advisor's `cost-mismatched-archetype` rule does) mis-orders any pair
+ * whose output multiple differs, and real traffic runs input-heavy
+ * (L-050: >85% input is the universal efficiency signal).
+ *
+ * This ranks; it does not bill. `estimateChainCostUsd` is exported so
+ * callers who know their real shape can compute against it instead.
+ */
+declare const COST_RANKING_REFERENCE_SHAPE: {
+    readonly inputTokens: 4000;
+    readonly outputTokens: 250;
+};
+/**
+ * Estimated USD for one call at a given shape. Exported so the advisor and
+ * consumer-side code share ONE derivation of "what does this model cost
+ * here" — two independent derivations of one concept will drift (s75).
+ */
+declare function estimateChainCostUsd(profile: ModelProfile, shape?: {
+    inputTokens: number;
+    outputTokens: number;
+}): number;
+/**
+ * How many distinct providers a chain spans. `1` means every fallback shares
+ * one provider's fate — the chain buys you retries, not outage independence.
+ * Exported so a cost-mode consumer can check what they traded away.
+ */
+declare function chainProviderSpread(chain: readonly string[]): number;
 /**
  * Returns the fallback chain for an archetype as a plain `string[]` of
  * model ids.
@@ -3680,4 +3754,4 @@ declare function planDecomposition(args: PlanDecompositionArgs): DecompositionPl
  */
 declare function compile(ir: PromptIR, opts?: CompileOptions): CompileResult;
 
-export { ABSOLUTE_FLOOR, type AISDKConvertedMessage, ARCHETYPE_FAMILY_FITS, ARCHETYPE_FLOOR_DEFAULT, type ActionableAdvisory, Adapter, type AdvisoryResolutionSource, type AdvisorySeverity, type AdvisoryStatus, type AdvisorySuggestedFix, ApiKeys, type AppOracle, type ApplySectionRewritesArgs, type ApplySectionRewritesResult, ArchetypeConvention, type ArchetypeFamilyFit, type ArchetypePerfMap, type ArchetypePerfNMap, type ArchetypePerfScoreResult, type AttachCacheControlResult, BRAIN_READ_ENV_NAMES, BestPracticeAdvisory, type BrainConfig, type BrainDeadLetterEntry, type BrainHealthSnapshot, type BrainQueryConfig, type BrainReadEnv, COACH_CFG, CallOptions, CallResult, ChainEntry, type CompatibilityIntent, type CompileForAISDKv6Result, type CompileOptions, CompilePolicy, CompileResult, CompiledRequest, type CreateDelegateOpts, DECOMPOSITION_TEMPLATES, DECOMPOSITION_TEMPLATES_VERSION, DEFAULT_FINDINGS_ENDPOINT, DEFAULT_MEASURED_FAILURE_ENDPOINT, DEFAULT_PROMOTIONS_ENDPOINT, DELEGATE_TOOL_DEFINITION, DISCIPLINE_GATES_V1_ALT_HEADER, type DecompositionPlan, type DecompositionStep, type DecompositionTemplate, type DelegateHandle, type DelegateRefusalReason, type DelegateResult, type DelegateToolArgs, type ExclusionFindingRow, type ExclusionResolutionSource, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type ExecutorCandidate, type FallbackPosture, FallbackReason, FamilyResolutionError, type GetActionableAdvisoriesOptions, type GetApplicablePromotionOpts, type GetDefaultFallbackChainOpts, type GetMeasuredFailureOpts, type GetPerAxisMetricsOpts, type GetRecommendedPrimaryOptions, type GoldenEvalAxis, type GoldenEvalCase, type GoldenEvalOptions, type GoldenEvalRunResult, type GoldenEvalStrategyId, type GoldenIrRecordInput, Grounding, IntentArchetypeName, JUDGE_RUBRICS, LIBRARY_VERSION, type LLMJudgeOptions, MEASURED_FAILURE_CFG, MEASURED_GROUNDING_MIN_N, type MarkAdvisoryResolvedOptions, type MarkExclusionFindingHandledOptions, type MarkPromoteReadyHandledOptions, type MeasuredFailureRuntime, type MeasuredFailureVerdict, type ModelBrainRow, type ModelCompatibility, ModelProfile, NormalizedResponse, type OracleContext, OracleScore, type OutcomePayload, OutcomeResult, OutputMode, PRODUCER_OWNED_RULE_CODES, PROVIDER_ENV_KEYS, PerAxisMetrics, type PlannedStep, type PricingRow, type ProbeShadowOptions, type ProbeShadowServed, type ProfileToRowOptions, type PromoteReadyFindingRow, type PromoteReadyResolution, type PromotionRow, type PromotionsRuntime, PromptIR, Provider, ProviderOverrides, type ProviderReachability, ROLLBACK_SUPPRESSION_WINDOW_DAYS, RULE_DISCIPLINE_GATES_V1, RULE_DISCIPLINE_GATES_V1_STRUCTURED, RULE_SEQUENTIAL_TOOL_CLIFF, type ReachabilityOpts, RecordInput, RecordOutcomeInput, type RunAdvisorPhase2Context, STRATEGY_AUTHORSHIP_LIMITATION, SectionRewrite, type ShadowProbeRecordInput, type StrategyAttribution, type StrategyAttributionResult, type StrategyOutcome, type SupportedProvider, type SurfaceFailureRow, type SurfaceStats, SystemModelMessage, TRANSLATOR_FLOOR, _testResetMeasuredFailure, _testResetPromotions, _testWaitForMeasuredFailureRefresh, _testWaitForPromotionsRefresh, altGatesBlockFor, applyArchetypeConvention, applySectionRewrites, attachCacheControlToStreamTextInput, awaitMeasuredFailureReady, brainHealth, buildGoldenIrRow, buildLLMJudge, buildPairwiseJudgePrompt, buildShadowProbeRow, call, classifyStrategyOutcome, clearBrain, combineOrderSwappedVerdicts, compile, compileForAISDKv6, configureBrain, configureMeasuredFailureBrain, configurePromotionsBrain, countTokens, createDelegate, deriveFamilyFromModelId, deriveOwnership, execute, findBetterFit, flushBrainDeadLetter, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getApplicablePromotion, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getMeasuredFailureVerdict, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecentRollback, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isAutoPromoteEnabledFromEnv, isBrainQueryActiveFor, isBrainSync, isDelegateEnabledFromEnv, isExclusionFindingsBrainActive, isMeasuredFailureBrainActive, isMeasuredFailureGateEnabledFromEnv, isModelReachable, isPromotionsBrainActive, isProviderReachable, judgeMeasuredFailure, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, mapMeasuredFailureRows, markAdvisoryResolved, markExclusionFindingHandled, markPromoteReadyHandled, parseJudgeVerdict, peekBrainDeadLetter, planDecomposition, prefetchMeasuredFailure, probeShadow, profileToRow, readBrainReadEnv, record, recordGoldenIr, recordOutcome, recordShadowProbe, renderIrForJudge, resetTokenizer, resolveConventionsForProfile, resolvePricingAt, resolveProviderKey, rubricFor, runAdvisor, runGoldenEval, runStrategyEvalWithAttribution, setTokenizer, wilsonLowerBound, withAltDisciplineContract, withDisciplineContract };
+export { ABSOLUTE_FLOOR, type AISDKConvertedMessage, ARCHETYPE_FAMILY_FITS, ARCHETYPE_FLOOR_DEFAULT, type ActionableAdvisory, Adapter, type AdvisoryResolutionSource, type AdvisorySeverity, type AdvisoryStatus, type AdvisorySuggestedFix, ApiKeys, type AppOracle, type ApplySectionRewritesArgs, type ApplySectionRewritesResult, ArchetypeConvention, type ArchetypeFamilyFit, type ArchetypePerfMap, type ArchetypePerfNMap, type ArchetypePerfScoreResult, type AttachCacheControlResult, BRAIN_READ_ENV_NAMES, BestPracticeAdvisory, type BrainConfig, type BrainDeadLetterEntry, type BrainHealthSnapshot, type BrainQueryConfig, type BrainReadEnv, COACH_CFG, COST_RANKING_REFERENCE_SHAPE, CallOptions, CallResult, ChainEntry, type CompatibilityIntent, type CompileForAISDKv6Result, type CompileOptions, CompilePolicy, CompileResult, CompiledRequest, type CreateDelegateOpts, DECOMPOSITION_TEMPLATES, DECOMPOSITION_TEMPLATES_VERSION, DEFAULT_FINDINGS_ENDPOINT, DEFAULT_MEASURED_FAILURE_ENDPOINT, DEFAULT_PROMOTIONS_ENDPOINT, DELEGATE_TOOL_DEFINITION, DISCIPLINE_GATES_V1_ALT_HEADER, type DecompositionPlan, type DecompositionStep, type DecompositionTemplate, type DelegateHandle, type DelegateRefusalReason, type DelegateResult, type DelegateToolArgs, type ExclusionFindingRow, type ExclusionResolutionSource, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type ExecutorCandidate, type FallbackPosture, FallbackReason, FamilyResolutionError, type GetActionableAdvisoriesOptions, type GetApplicablePromotionOpts, type GetDefaultFallbackChainOpts, type GetMeasuredFailureOpts, type GetPerAxisMetricsOpts, type GetRecommendedPrimaryOptions, type GoldenEvalAxis, type GoldenEvalCase, type GoldenEvalOptions, type GoldenEvalRunResult, type GoldenEvalStrategyId, type GoldenIrRecordInput, Grounding, IntentArchetypeName, JUDGE_RUBRICS, LIBRARY_VERSION, type LLMJudgeOptions, MEASURED_FAILURE_CFG, MEASURED_GROUNDING_MIN_N, type MarkAdvisoryResolvedOptions, type MarkExclusionFindingHandledOptions, type MarkPromoteReadyHandledOptions, type MeasuredFailureRuntime, type MeasuredFailureVerdict, type ModelBrainRow, type ModelCompatibility, ModelProfile, NormalizedResponse, type OracleContext, OracleScore, type OutcomePayload, OutcomeResult, OutputMode, PRODUCER_OWNED_RULE_CODES, PROVIDER_ENV_KEYS, PerAxisMetrics, type PlannedStep, type PricingRow, type ProbeShadowOptions, type ProbeShadowServed, type ProfileToRowOptions, type PromoteReadyFindingRow, type PromoteReadyResolution, type PromotionRow, type PromotionsRuntime, PromptIR, Provider, ProviderOverrides, type ProviderReachability, ROLLBACK_SUPPRESSION_WINDOW_DAYS, RULE_DISCIPLINE_GATES_V1, RULE_DISCIPLINE_GATES_V1_STRUCTURED, RULE_SEQUENTIAL_TOOL_CLIFF, type ReachabilityOpts, RecordInput, RecordOutcomeInput, type RunAdvisorPhase2Context, STRATEGY_AUTHORSHIP_LIMITATION, SectionRewrite, type ShadowProbeRecordInput, type StrategyAttribution, type StrategyAttributionResult, type StrategyOutcome, type SupportedProvider, type SurfaceFailureRow, type SurfaceStats, SystemModelMessage, TRANSLATOR_FLOOR, _testResetMeasuredFailure, _testResetPromotions, _testWaitForMeasuredFailureRefresh, _testWaitForPromotionsRefresh, altGatesBlockFor, applyArchetypeConvention, applySectionRewrites, attachCacheControlToStreamTextInput, awaitMeasuredFailureReady, brainHealth, buildGoldenIrRow, buildLLMJudge, buildPairwiseJudgePrompt, buildShadowProbeRow, call, chainProviderSpread, classifyStrategyOutcome, clearBrain, combineOrderSwappedVerdicts, compile, compileForAISDKv6, configureBrain, configureMeasuredFailureBrain, configurePromotionsBrain, countTokens, createDelegate, deriveFamilyFromModelId, deriveOwnership, estimateChainCostUsd, execute, findBetterFit, flushBrainDeadLetter, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getApplicablePromotion, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getMeasuredFailureVerdict, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecentRollback, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isAutoPromoteEnabledFromEnv, isBrainQueryActiveFor, isBrainSync, isDelegateEnabledFromEnv, isExclusionFindingsBrainActive, isMeasuredFailureBrainActive, isMeasuredFailureGateEnabledFromEnv, isModelReachable, isPromotionsBrainActive, isProviderReachable, judgeMeasuredFailure, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, mapMeasuredFailureRows, markAdvisoryResolved, markExclusionFindingHandled, markPromoteReadyHandled, parseJudgeVerdict, peekBrainDeadLetter, planDecomposition, prefetchMeasuredFailure, probeShadow, profileToRow, readBrainReadEnv, record, recordGoldenIr, recordOutcome, recordShadowProbe, renderIrForJudge, resetTokenizer, resolveConventionsForProfile, resolvePricingAt, resolveProviderKey, rubricFor, runAdvisor, runGoldenEval, runStrategyEvalWithAttribution, setTokenizer, wilsonLowerBound, withAltDisciplineContract, withDisciplineContract };