@warmdrift/kgauto-compiler 2.0.0-alpha.76 → 2.0.0-alpha.77

package/dist/{chunk-WZZCW6NA.mjs → chunk-GB7VJQ6C.mjs}

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

package/dist/glassbox/index.d.mts

@@ -1,6 +1,6 @@
-import { G as GlassboxEvent } from '../types-BgJ5iQB_.mjs';
-export { A as AdvisoryFiredData, C as CompileDoneData, a as CompileStartData, E as ExecuteAttemptData, b as ExecuteSuccessData, F as FallbackWalkedData, c as GLASSBOX_STREAM_TTL_MS, d as GlassboxEventKind, e as GlassboxPubSub } from '../types-BgJ5iQB_.mjs';
-import '../ir-CZukZvDn.mjs';
+import { G as GlassboxEvent } from '../types-Caq-hOIj.mjs';
+export { A as AdvisoryFiredData, C as CompileDoneData, a as CompileStartData, E as ExecuteAttemptData, b as ExecuteSuccessData, F as FallbackWalkedData, c as GLASSBOX_STREAM_TTL_MS, d as GlassboxEventKind, e as GlassboxPubSub } from '../types-Caq-hOIj.mjs';
+import '../ir-CRV1_taF.mjs';
 import '../dialect.mjs';
 
 /**

package/dist/glassbox/index.d.ts

@@ -1,6 +1,6 @@
-import { G as GlassboxEvent } from '../types-D-PuKCWk.js';
-export { A as AdvisoryFiredData, C as CompileDoneData, a as CompileStartData, E as ExecuteAttemptData, b as ExecuteSuccessData, F as FallbackWalkedData, c as GLASSBOX_STREAM_TTL_MS, d as GlassboxEventKind, e as GlassboxPubSub } from '../types-D-PuKCWk.js';
-import '../ir-B0v2f9NY.js';
+import { G as GlassboxEvent } from '../types-C5BX9bzi.js';
+export { A as AdvisoryFiredData, C as CompileDoneData, a as CompileStartData, E as ExecuteAttemptData, b as ExecuteSuccessData, F as FallbackWalkedData, c as GLASSBOX_STREAM_TTL_MS, d as GlassboxEventKind, e as GlassboxPubSub } from '../types-C5BX9bzi.js';
+import '../ir-C02EIElQ.js';
 import '../dialect.js';
 
 /**

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

@@ -1,5 +1,5 @@
-import { T as TraceHealth } from '../types-BOTLfJOp.mjs';
-import '../ir-CZukZvDn.mjs';
+import { T as TraceHealth } from '../types-3WdGMqin.mjs';
+import '../ir-CRV1_taF.mjs';
 import '../dialect.mjs';
 
 /**

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

@@ -1,5 +1,5 @@
-import { T as TraceHealth } from '../types-Ba68lIs1.js';
-import '../ir-B0v2f9NY.js';
+import { T as TraceHealth } from '../types-CkRvjxrI.js';
+import '../ir-C02EIElQ.js';
 import '../dialect.js';
 
 /**

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

@@ -1,7 +1,7 @@
-import { G as GlassboxEvent } from '../types-BgJ5iQB_.mjs';
-import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-BOTLfJOp.mjs';
-export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-BOTLfJOp.mjs';
-import '../ir-CZukZvDn.mjs';
+import { G as GlassboxEvent } from '../types-Caq-hOIj.mjs';
+import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-3WdGMqin.mjs';
+export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-3WdGMqin.mjs';
+import '../ir-CRV1_taF.mjs';
 import '../dialect.mjs';
 
 /**

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

@@ -1,7 +1,7 @@
-import { G as GlassboxEvent } from '../types-D-PuKCWk.js';
-import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-Ba68lIs1.js';
-export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-Ba68lIs1.js';
-import '../ir-B0v2f9NY.js';
+import { G as GlassboxEvent } from '../types-C5BX9bzi.js';
+import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-CkRvjxrI.js';
+export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-CkRvjxrI.js';
+import '../ir-C02EIElQ.js';
 import '../dialect.js';
 
 /**

package/dist/glassbox-routes/index.js

@@ -2249,6 +2249,7 @@ var CACHE_RATIO_YELLOW = 0.1;
 var FALLBACK_REASONS = /* @__PURE__ */ new Set([
   "rate_limit",
   "provider_auth_failed",
+  "provider_billing_exhausted",
   "provider_error",
   "cliff",
   "cost_cap",

package/dist/glassbox-routes/index.mjs

@@ -237,6 +237,7 @@ var CACHE_RATIO_YELLOW = 0.1;
 var FALLBACK_REASONS = /* @__PURE__ */ new Set([
   "rate_limit",
   "provider_auth_failed",
+  "provider_billing_exhausted",
   "provider_error",
   "cliff",
   "cost_cap",

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

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { a as TraceDetail } from '../../types-BOTLfJOp.mjs';
-import '../../ir-CZukZvDn.mjs';
+import { a as TraceDetail } from '../../types-3WdGMqin.mjs';
+import '../../ir-CRV1_taF.mjs';
 import '../../dialect.mjs';
 
 /**

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

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { a as TraceDetail } from '../../types-Ba68lIs1.js';
-import '../../ir-B0v2f9NY.js';
+import { a as TraceDetail } from '../../types-CkRvjxrI.js';
+import '../../ir-C02EIElQ.js';
 import '../../dialect.js';
 
 /**

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { C as CompilePolicy, N as NormalizedResponse, A as ApiKeys, P as ProviderOverrides, a as CompiledRequest, b as PromptIR, c as CallOptions, d as CallResult, S as SystemModelMessage, e as CompileResult, B as BestPracticeAdvisory, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-CZukZvDn.mjs';
-export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, E as EffortLevel, F as FallbackReason, r as GoldenCaptureOptions, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, s as MutationApplied, t as NormalizedTokens, u as OutcomeKind, v as PerAxisMetricsByModel, w as PromptSection, x as SectionKind, y as ShadowProbeConfig, T as ToolCall, z as ToolDefinition, D as captureGoldenIr, J as parseGoldenCaptureRate, K as resolveGoldenCaptureRate, L as shouldCaptureGolden } from './ir-CZukZvDn.mjs';
+import { C as CompilePolicy, N as NormalizedResponse, A as ApiKeys, P as ProviderOverrides, a as CompiledRequest, b as PromptIR, c as CallOptions, d as CallResult, S as SystemModelMessage, e as CompileResult, B as BestPracticeAdvisory, F as FallbackReason, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-CRV1_taF.mjs';
+export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, E as EffortLevel, r as GoldenCaptureOptions, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, s as MutationApplied, t as NormalizedTokens, u as OutcomeKind, v as PerAxisMetricsByModel, w as PromptSection, x as SectionKind, y as ShadowProbeConfig, T as ToolCall, z as ToolDefinition, D as captureGoldenIr, J as parseGoldenCaptureRate, K as resolveGoldenCaptureRate, L as shouldCaptureGolden } from './ir-CRV1_taF.mjs';
 import { ModelProfile, ArchetypeConvention } from './profiles.mjs';
 export { ALIASES, CacheStrategy, CliffRule, LATENCY_TIER_MS, LatencyTier, LoweringSpec, RecoveryRule, StructuredOutputCapability, SystemPromptMode, allProfiles, getProfile, latencyTierOf, profilesByProvider, tryGetProfile } from './profiles.mjs';
 export { BrainForwardConfig, BrainForwardRoutes, createBrainForwardRoutes } from './brain-proxy.mjs';
@@ -656,7 +656,7 @@ interface OutcomePayload {
     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';
+    fallback_reason?: FallbackReason;
     /**
      * alpha.71 (migration 044) — the precise `errorCode` behind
      * `fallback_reason`. Key OMITTED when no fallback fired, so brains that
@@ -1119,7 +1119,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.76";
+declare const LIBRARY_VERSION = "2.0.0-alpha.77";
 
 /**
  * Oracle contract — how an app tells the brain whether a response was good.
@@ -3404,4 +3404,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, 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, DECOMPOSITION_TEMPLATES, DECOMPOSITION_TEMPLATES_VERSION, DEFAULT_FINDINGS_ENDPOINT, DEFAULT_MEASURED_FAILURE_ENDPOINT, DEFAULT_PROMOTIONS_ENDPOINT, DISCIPLINE_GATES_V1_ALT_HEADER, type DecompositionPlan, type DecompositionStep, type DecompositionTemplate, type ExclusionFindingRow, type ExclusionResolutionSource, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type ExecutorCandidate, type FallbackPosture, 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, 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, deriveFamilyFromModelId, deriveOwnership, execute, findBetterFit, flushBrainDeadLetter, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getApplicablePromotion, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getMeasuredFailureVerdict, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isAutoPromoteEnabledFromEnv, isBrainQueryActiveFor, isBrainSync, isExclusionFindingsBrainActive, isMeasuredFailureBrainActive, isMeasuredFailureGateEnabledFromEnv, isModelReachable, isPromotionsBrainActive, isProviderReachable, judgeMeasuredFailure, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, 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, 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, DECOMPOSITION_TEMPLATES, DECOMPOSITION_TEMPLATES_VERSION, DEFAULT_FINDINGS_ENDPOINT, DEFAULT_MEASURED_FAILURE_ENDPOINT, DEFAULT_PROMOTIONS_ENDPOINT, DISCIPLINE_GATES_V1_ALT_HEADER, type DecompositionPlan, type DecompositionStep, type DecompositionTemplate, 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, 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, deriveFamilyFromModelId, deriveOwnership, execute, findBetterFit, flushBrainDeadLetter, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getApplicablePromotion, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getMeasuredFailureVerdict, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isAutoPromoteEnabledFromEnv, isBrainQueryActiveFor, isBrainSync, isExclusionFindingsBrainActive, isMeasuredFailureBrainActive, isMeasuredFailureGateEnabledFromEnv, isModelReachable, isPromotionsBrainActive, isProviderReachable, judgeMeasuredFailure, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, 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

@@ -1,5 +1,5 @@
-import { C as CompilePolicy, N as NormalizedResponse, A as ApiKeys, P as ProviderOverrides, a as CompiledRequest, b as PromptIR, c as CallOptions, d as CallResult, S as SystemModelMessage, e as CompileResult, B as BestPracticeAdvisory, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-B0v2f9NY.js';
-export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, E as EffortLevel, F as FallbackReason, r as GoldenCaptureOptions, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, s as MutationApplied, t as NormalizedTokens, u as OutcomeKind, v as PerAxisMetricsByModel, w as PromptSection, x as SectionKind, y as ShadowProbeConfig, T as ToolCall, z as ToolDefinition, D as captureGoldenIr, J as parseGoldenCaptureRate, K as resolveGoldenCaptureRate, L as shouldCaptureGolden } from './ir-B0v2f9NY.js';
+import { C as CompilePolicy, N as NormalizedResponse, A as ApiKeys, P as ProviderOverrides, a as CompiledRequest, b as PromptIR, c as CallOptions, d as CallResult, S as SystemModelMessage, e as CompileResult, B as BestPracticeAdvisory, F as FallbackReason, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-C02EIElQ.js';
+export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, E as EffortLevel, r as GoldenCaptureOptions, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, s as MutationApplied, t as NormalizedTokens, u as OutcomeKind, v as PerAxisMetricsByModel, w as PromptSection, x as SectionKind, y as ShadowProbeConfig, T as ToolCall, z as ToolDefinition, D as captureGoldenIr, J as parseGoldenCaptureRate, K as resolveGoldenCaptureRate, L as shouldCaptureGolden } from './ir-C02EIElQ.js';
 import { ModelProfile, ArchetypeConvention } from './profiles.js';
 export { ALIASES, CacheStrategy, CliffRule, LATENCY_TIER_MS, LatencyTier, LoweringSpec, RecoveryRule, StructuredOutputCapability, SystemPromptMode, allProfiles, getProfile, latencyTierOf, profilesByProvider, tryGetProfile } from './profiles.js';
 export { BrainForwardConfig, BrainForwardRoutes, createBrainForwardRoutes } from './brain-proxy.js';
@@ -656,7 +656,7 @@ interface OutcomePayload {
     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';
+    fallback_reason?: FallbackReason;
     /**
      * alpha.71 (migration 044) — the precise `errorCode` behind
      * `fallback_reason`. Key OMITTED when no fallback fired, so brains that
@@ -1119,7 +1119,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.76";
+declare const LIBRARY_VERSION = "2.0.0-alpha.77";
 
 /**
  * Oracle contract — how an app tells the brain whether a response was good.
@@ -3404,4 +3404,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, 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, DECOMPOSITION_TEMPLATES, DECOMPOSITION_TEMPLATES_VERSION, DEFAULT_FINDINGS_ENDPOINT, DEFAULT_MEASURED_FAILURE_ENDPOINT, DEFAULT_PROMOTIONS_ENDPOINT, DISCIPLINE_GATES_V1_ALT_HEADER, type DecompositionPlan, type DecompositionStep, type DecompositionTemplate, type ExclusionFindingRow, type ExclusionResolutionSource, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type ExecutorCandidate, type FallbackPosture, 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, 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, deriveFamilyFromModelId, deriveOwnership, execute, findBetterFit, flushBrainDeadLetter, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getApplicablePromotion, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getMeasuredFailureVerdict, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isAutoPromoteEnabledFromEnv, isBrainQueryActiveFor, isBrainSync, isExclusionFindingsBrainActive, isMeasuredFailureBrainActive, isMeasuredFailureGateEnabledFromEnv, isModelReachable, isPromotionsBrainActive, isProviderReachable, judgeMeasuredFailure, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, 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, 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, DECOMPOSITION_TEMPLATES, DECOMPOSITION_TEMPLATES_VERSION, DEFAULT_FINDINGS_ENDPOINT, DEFAULT_MEASURED_FAILURE_ENDPOINT, DEFAULT_PROMOTIONS_ENDPOINT, DISCIPLINE_GATES_V1_ALT_HEADER, type DecompositionPlan, type DecompositionStep, type DecompositionTemplate, 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, 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, deriveFamilyFromModelId, deriveOwnership, execute, findBetterFit, flushBrainDeadLetter, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getApplicablePromotion, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getMeasuredFailureVerdict, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isAutoPromoteEnabledFromEnv, isBrainQueryActiveFor, isBrainSync, isExclusionFindingsBrainActive, isMeasuredFailureBrainActive, isMeasuredFailureGateEnabledFromEnv, isModelReachable, isPromotionsBrainActive, isProviderReachable, judgeMeasuredFailure, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, 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.js

@@ -6426,8 +6426,33 @@ function isAuthSignatureBody(body, message) {
   const m = message.toLowerCase();
   return m.includes("api key not valid") || m.includes("invalid api key") || m.includes("invalid x-api-key") || m.includes("incorrect api key");
 }
+function isBillingExhaustedBody(status, body, message) {
+  if (status === 402) return true;
+  const m = message.toLowerCase();
+  if (m.includes("free_tier") || m.includes("free tier")) return false;
+  if (m.includes("credit balance is too low")) return true;
+  if (m.includes("insufficient balance")) return true;
+  if (m.includes("billingnotenabled") || m.includes("billing not enabled")) return true;
+  if (body && typeof body === "object") {
+    const err = body.error;
+    if (err && typeof err === "object") {
+      const e = err;
+      if (e.code === "insufficient_quota" || e.type === "insufficient_quota") return true;
+      if (Array.isArray(e.details)) {
+        for (const d of e.details) {
+          if (d && typeof d === "object" && d.reason === "BILLING_DISABLED") {
+            return true;
+          }
+        }
+      }
+    }
+  }
+  return false;
+}
 function classifyHttpError(status, body) {
   const message = extractErrorMessage(body) ?? `HTTP ${status}`;
+  if (isBillingExhaustedBody(status, body, message))
+    return { ok: false, status, errorType: "terminal", errorCode: "billing_exhausted", message, raw: body };
   if (status === 429)
     return { ok: false, status, errorType: "retryable", errorCode: "rate_limit", message, raw: body };
   if (status === 408)
@@ -6691,6 +6716,9 @@ function applyOverrides(request, overrides) {
 }
 function classifyHttpError2(status, body) {
   const message = extractErrorMessage2(body) ?? `HTTP ${status}`;
+  if (isBillingExhaustedBody(status, body, message)) {
+    return { ok: false, status, errorType: "terminal", errorCode: "billing_exhausted", message, raw: body };
+  }
   if (status === 429) {
     return { ok: false, status, errorType: "retryable", errorCode: "rate_limit", message, raw: body };
   }
@@ -7533,18 +7561,19 @@ async function call(ir, opts = {}) {
   }
   let activeCompile = initial;
   let lastErr;
-  const failedProviders = /* @__PURE__ */ new Set();
+  const failedProviders = /* @__PURE__ */ new Map();
   const sameModelRetryEnabled = opts.sameModelRetry ?? isSameModelRetryEnabledFromEnv();
   let retriedSameModel = false;
   for (let i = 0; i < targetsToTry.length; i++) {
     const targetModel = targetsToTry[i];
     const targetProfile = tryGetProfile(targetModel);
-    if (targetProfile && failedProviders.has(targetProfile.provider) && !opts.noFallback) {
+    const providerFailReason = targetProfile ? failedProviders.get(targetProfile.provider) : void 0;
+    if (targetProfile && providerFailReason && !opts.noFallback) {
       attempts.push({
         model: targetModel,
         status: "terminal",
-        errorCode: "auth_inferred",
-        message: `Skipped \u2014 provider ${targetProfile.provider} returned 401/403 earlier in this call; same key inferred to fail`
+        errorCode: `${providerFailReason}_inferred`,
+        message: providerFailReason === "billing_exhausted" ? `Skipped \u2014 provider ${targetProfile.provider} is out of credits (seen earlier in this call); a billing failure is account-wide, so this attempt cannot succeed until a human funds the account` : `Skipped \u2014 provider ${targetProfile.provider} returned 401/403 earlier in this call; same key inferred to fail`
       });
       continue;
     }
@@ -7726,15 +7755,18 @@ async function call(ir, opts = {}) {
     });
     lastErr = validated;
     if (validated.errorType === "terminal" || opts.noFallback) {
-      if (validated.errorCode === "auth" && !opts.noFallback && activeCompile.provider) {
-        failedProviders.add(activeCompile.provider);
+      if ((validated.errorCode === "auth" || validated.errorCode === "billing_exhausted") && !opts.noFallback && activeCompile.provider) {
+        failedProviders.set(
+          activeCompile.provider,
+          validated.errorCode === "billing_exhausted" ? "billing_exhausted" : "auth"
+        );
         continue;
       }
       break;
     }
   }
   const lastAttempted = [...attempts].reverse().find(
-    (a) => a.status !== "success" && a.errorCode !== "auth_inferred" && a.errorCode !== "compile_error"
+    (a) => a.status !== "success" && a.errorCode !== "auth_inferred" && a.errorCode !== "billing_exhausted_inferred" && a.errorCode !== "compile_error"
   );
   const latencyMs = Date.now() - start;
   await record({
@@ -8056,6 +8088,9 @@ function normalizeFallbackReason(attempts) {
   }
   if (code === "cost_cap_exceeded") return "cost_cap";
   if (code === "auth" || code === "auth_inferred") return "provider_auth_failed";
+  if (code === "billing_exhausted" || code === "billing_exhausted_inferred") {
+    return "provider_billing_exhausted";
+  }
   return "provider_error";
 }
 function generateTraceId() {
@@ -9043,7 +9078,7 @@ function createBrainForwardRoutes(config) {
 }
 
 // src/version.ts
-var LIBRARY_VERSION = "2.0.0-alpha.76";
+var LIBRARY_VERSION = "2.0.0-alpha.77";
 
 // src/key-health.ts
 var JSON_HEADERS2 = { "Content-Type": "application/json" };

package/dist/index.mjs

@@ -16,7 +16,7 @@ import {
 import {
   LIBRARY_VERSION,
   createKeyHealthRoute
-} from "./chunk-WZZCW6NA.mjs";
+} from "./chunk-GB7VJQ6C.mjs";
 import {
   ABSOLUTE_FLOOR,
   ARCHETYPE_FLOOR_DEFAULT,
@@ -4222,8 +4222,33 @@ function isAuthSignatureBody(body, message) {
   const m = message.toLowerCase();
   return m.includes("api key not valid") || m.includes("invalid api key") || m.includes("invalid x-api-key") || m.includes("incorrect api key");
 }
+function isBillingExhaustedBody(status, body, message) {
+  if (status === 402) return true;
+  const m = message.toLowerCase();
+  if (m.includes("free_tier") || m.includes("free tier")) return false;
+  if (m.includes("credit balance is too low")) return true;
+  if (m.includes("insufficient balance")) return true;
+  if (m.includes("billingnotenabled") || m.includes("billing not enabled")) return true;
+  if (body && typeof body === "object") {
+    const err = body.error;
+    if (err && typeof err === "object") {
+      const e = err;
+      if (e.code === "insufficient_quota" || e.type === "insufficient_quota") return true;
+      if (Array.isArray(e.details)) {
+        for (const d of e.details) {
+          if (d && typeof d === "object" && d.reason === "BILLING_DISABLED") {
+            return true;
+          }
+        }
+      }
+    }
+  }
+  return false;
+}
 function classifyHttpError(status, body) {
   const message = extractErrorMessage(body) ?? `HTTP ${status}`;
+  if (isBillingExhaustedBody(status, body, message))
+    return { ok: false, status, errorType: "terminal", errorCode: "billing_exhausted", message, raw: body };
   if (status === 429)
     return { ok: false, status, errorType: "retryable", errorCode: "rate_limit", message, raw: body };
   if (status === 408)
@@ -4487,6 +4512,9 @@ function applyOverrides(request, overrides) {
 }
 function classifyHttpError2(status, body) {
   const message = extractErrorMessage2(body) ?? `HTTP ${status}`;
+  if (isBillingExhaustedBody(status, body, message)) {
+    return { ok: false, status, errorType: "terminal", errorCode: "billing_exhausted", message, raw: body };
+  }
   if (status === 429) {
     return { ok: false, status, errorType: "retryable", errorCode: "rate_limit", message, raw: body };
   }
@@ -4675,18 +4703,19 @@ async function call(ir, opts = {}) {
   }
   let activeCompile = initial;
   let lastErr;
-  const failedProviders = /* @__PURE__ */ new Set();
+  const failedProviders = /* @__PURE__ */ new Map();
   const sameModelRetryEnabled = opts.sameModelRetry ?? isSameModelRetryEnabledFromEnv();
   let retriedSameModel = false;
   for (let i = 0; i < targetsToTry.length; i++) {
     const targetModel = targetsToTry[i];
     const targetProfile = tryGetProfile(targetModel);
-    if (targetProfile && failedProviders.has(targetProfile.provider) && !opts.noFallback) {
+    const providerFailReason = targetProfile ? failedProviders.get(targetProfile.provider) : void 0;
+    if (targetProfile && providerFailReason && !opts.noFallback) {
       attempts.push({
         model: targetModel,
         status: "terminal",
-        errorCode: "auth_inferred",
-        message: `Skipped \u2014 provider ${targetProfile.provider} returned 401/403 earlier in this call; same key inferred to fail`
+        errorCode: `${providerFailReason}_inferred`,
+        message: providerFailReason === "billing_exhausted" ? `Skipped \u2014 provider ${targetProfile.provider} is out of credits (seen earlier in this call); a billing failure is account-wide, so this attempt cannot succeed until a human funds the account` : `Skipped \u2014 provider ${targetProfile.provider} returned 401/403 earlier in this call; same key inferred to fail`
       });
       continue;
     }
@@ -4868,15 +4897,18 @@ async function call(ir, opts = {}) {
     });
     lastErr = validated;
     if (validated.errorType === "terminal" || opts.noFallback) {
-      if (validated.errorCode === "auth" && !opts.noFallback && activeCompile.provider) {
-        failedProviders.add(activeCompile.provider);
+      if ((validated.errorCode === "auth" || validated.errorCode === "billing_exhausted") && !opts.noFallback && activeCompile.provider) {
+        failedProviders.set(
+          activeCompile.provider,
+          validated.errorCode === "billing_exhausted" ? "billing_exhausted" : "auth"
+        );
         continue;
       }
       break;
     }
   }
   const lastAttempted = [...attempts].reverse().find(
-    (a) => a.status !== "success" && a.errorCode !== "auth_inferred" && a.errorCode !== "compile_error"
+    (a) => a.status !== "success" && a.errorCode !== "auth_inferred" && a.errorCode !== "billing_exhausted_inferred" && a.errorCode !== "compile_error"
   );
   const latencyMs = Date.now() - start;
   await record({
@@ -5198,6 +5230,9 @@ function normalizeFallbackReason(attempts) {
   }
   if (code === "cost_cap_exceeded") return "cost_cap";
   if (code === "auth" || code === "auth_inferred") return "provider_auth_failed";
+  if (code === "billing_exhausted" || code === "billing_exhausted_inferred") {
+    return "provider_billing_exhausted";
+  }
   return "provider_error";
 }
 function generateTraceId() {

package/dist/{ir-B0v2f9NY.d.ts → ir-C02EIElQ.d.ts}

@@ -1209,12 +1209,21 @@ interface CallAttempt {
  *                            for alpha.10+ — e.g. mid-stream policy rejects)
  *   - `provider_auth_failed` alpha.14 — initial provider returned 401/403
  *                            (upstream key revocation, malformed-but-truthy
- *                            key, billing lapse). The chain walks to the
- *                            next non-same-provider target instead of
+ *                            key). The chain walks to the next
+ *                            non-same-provider target instead of
  *                            short-circuiting; same-provider remaining
  *                            entries skip with errorCode='auth_inferred'.
+ *   - `provider_billing_exhausted` alpha.77 — the provider's ACCOUNT is out
+ *                            of credits (Anthropic "credit balance is too
+ *                            low" 400, OpenAI insufficient_quota 429,
+ *                            Google billing-disabled, DeepSeek 402). Walks
+ *                            like auth and skips same-provider siblings
+ *                            (errorCode='billing_exhausted_inferred').
+ *                            Distinct from auth AND from rate_limit because
+ *                            its disposition is distinct: it never clears
+ *                            on its own — a human funds the account.
  */
-type FallbackReason = 'rate_limit' | 'provider_error' | 'cost_cap' | 'cliff' | 'contract_violation' | 'provider_auth_failed';
+type FallbackReason = 'rate_limit' | 'provider_error' | 'cost_cap' | 'cliff' | 'contract_violation' | 'provider_auth_failed' | 'provider_billing_exhausted';
 interface CallResult {
     /** Compile handle (still valid for record() if consumer wants to add oracle scores later). */
     handle: string;
@@ -1470,10 +1479,11 @@ interface RecordInput {
     /** Model originally targeted when a fallback fired. */
     fellOverFrom?: string;
     /**
-     * Why the fallback fired. Closed set mirroring CallResult.fallbackReason —
-     * keep in sync with the wire-contract enum (TraceDetail.fallbackReason).
+     * Why the fallback fired — the SAME closed set as CallResult.fallbackReason
+     * (one derivation; the alpha.77 DTS break caught this field's inline copy
+     * drifting when the canonical union grew a member).
      */
-    fallbackReason?: 'rate_limit' | 'provider_auth_failed' | 'provider_error' | 'cliff' | 'cost_cap' | 'contract_violation';
+    fallbackReason?: FallbackReason;
     /**
      * alpha.66 — true when the one-shot same-model retry fired during this
      * call (migration 039 `retried_same_model`). Powers the offline rollup:

package/dist/{ir-CZukZvDn.d.mts → ir-CRV1_taF.d.mts}

@@ -1209,12 +1209,21 @@ interface CallAttempt {
  *                            for alpha.10+ — e.g. mid-stream policy rejects)
  *   - `provider_auth_failed` alpha.14 — initial provider returned 401/403
  *                            (upstream key revocation, malformed-but-truthy
- *                            key, billing lapse). The chain walks to the
- *                            next non-same-provider target instead of
+ *                            key). The chain walks to the next
+ *                            non-same-provider target instead of
  *                            short-circuiting; same-provider remaining
  *                            entries skip with errorCode='auth_inferred'.
+ *   - `provider_billing_exhausted` alpha.77 — the provider's ACCOUNT is out
+ *                            of credits (Anthropic "credit balance is too
+ *                            low" 400, OpenAI insufficient_quota 429,
+ *                            Google billing-disabled, DeepSeek 402). Walks
+ *                            like auth and skips same-provider siblings
+ *                            (errorCode='billing_exhausted_inferred').
+ *                            Distinct from auth AND from rate_limit because
+ *                            its disposition is distinct: it never clears
+ *                            on its own — a human funds the account.
  */
-type FallbackReason = 'rate_limit' | 'provider_error' | 'cost_cap' | 'cliff' | 'contract_violation' | 'provider_auth_failed';
+type FallbackReason = 'rate_limit' | 'provider_error' | 'cost_cap' | 'cliff' | 'contract_violation' | 'provider_auth_failed' | 'provider_billing_exhausted';
 interface CallResult {
     /** Compile handle (still valid for record() if consumer wants to add oracle scores later). */
     handle: string;
@@ -1470,10 +1479,11 @@ interface RecordInput {
     /** Model originally targeted when a fallback fired. */
     fellOverFrom?: string;
     /**
-     * Why the fallback fired. Closed set mirroring CallResult.fallbackReason —
-     * keep in sync with the wire-contract enum (TraceDetail.fallbackReason).
+     * Why the fallback fired — the SAME closed set as CallResult.fallbackReason
+     * (one derivation; the alpha.77 DTS break caught this field's inline copy
+     * drifting when the canonical union grew a member).
      */
-    fallbackReason?: 'rate_limit' | 'provider_auth_failed' | 'provider_error' | 'cliff' | 'cost_cap' | 'contract_violation';
+    fallbackReason?: FallbackReason;
     /**
      * alpha.66 — true when the one-shot same-model retry fired during this
      * call (migration 039 `retried_same_model`). Powers the offline rollup:

package/dist/key-health.js

@@ -25,7 +25,7 @@ __export(key_health_exports, {
 module.exports = __toCommonJS(key_health_exports);
 
 // src/version.ts
-var LIBRARY_VERSION = "2.0.0-alpha.76";
+var LIBRARY_VERSION = "2.0.0-alpha.77";
 
 // src/key-health.ts
 var JSON_HEADERS = { "Content-Type": "application/json" };

package/dist/key-health.mjs

@@ -1,6 +1,6 @@
 import {
   createKeyHealthRoute
-} from "./chunk-WZZCW6NA.mjs";
+} from "./chunk-GB7VJQ6C.mjs";
 export {
   createKeyHealthRoute
 };

package/dist/profiles.d.mts

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

package/dist/profiles.d.ts

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

package/dist/{types-Ba68lIs1.d.ts → types-3WdGMqin.d.mts}

@@ -1,11 +1,4 @@
-import { i as Adapter, x as SectionKind } from './ir-B0v2f9NY.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.
- */
+import { i as Adapter, F as FallbackReason, x as SectionKind } from './ir-CRV1_taF.mjs';
 
 /**
  * Wire contract for the Glass-Box Chrome extension's brain-poll endpoint.
@@ -131,7 +124,7 @@ interface TraceDetail extends TraceSummary {
     /** Derived: cacheReadInputTokens / max(tokensIn, 1). 0-1. */
     inputCacheHitRatio: number;
     fellOverFrom?: string;
-    fallbackReason?: 'rate_limit' | 'provider_auth_failed' | 'provider_error' | 'cliff' | 'cost_cap' | 'contract_violation';
+    fallbackReason?: FallbackReason;
     /** Up to 2 alternatives. Empty array (not undefined) when none qualify. */
     counterfactuals?: TraceCounterfactual[];
     /** Undefined when 7d volume < 5/day (insufficient data). */

package/dist/{types-D-PuKCWk.d.ts → types-C5BX9bzi.d.ts}

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

package/dist/{types-BgJ5iQB_.d.mts → types-Caq-hOIj.d.mts}

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

package/dist/{types-BOTLfJOp.d.mts → types-CkRvjxrI.d.ts}

@@ -1,11 +1,4 @@
-import { i as Adapter, x as SectionKind } from './ir-CZukZvDn.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.
- */
+import { i as Adapter, F as FallbackReason, x as SectionKind } from './ir-C02EIElQ.js';
 
 /**
  * Wire contract for the Glass-Box Chrome extension's brain-poll endpoint.
@@ -131,7 +124,7 @@ interface TraceDetail extends TraceSummary {
     /** Derived: cacheReadInputTokens / max(tokensIn, 1). 0-1. */
     inputCacheHitRatio: number;
     fellOverFrom?: string;
-    fallbackReason?: 'rate_limit' | 'provider_auth_failed' | 'provider_error' | 'cliff' | 'cost_cap' | 'contract_violation';
+    fallbackReason?: FallbackReason;
     /** Up to 2 alternatives. Empty array (not undefined) when none qualify. */
     counterfactuals?: TraceCounterfactual[];
     /** Undefined when 7d volume < 5/day (insufficient data). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warmdrift/kgauto-compiler",
-  "version": "2.0.0-alpha.76",
+  "version": "2.0.0-alpha.77",
   "description": "Prompt compiler with executable provider knowledge for multi-model AI apps: normalized multi-provider transport with fallback chains, compile-time cliff guards, a curated model registry, and a telemetry flight recorder. Swap models without rewriting prompts.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",