@warmdrift/kgauto-compiler 2.0.0-alpha.91 → 2.0.0-alpha.93

package/dist/index.d.ts

@@ -1,54 +1,13 @@
-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 OutcomeSource, i as OracleScore, j as Adapter, k as PerAxisMetrics, l as Provider, m as ChainEntry, G as Grounding } from './ir-CTx026t0.js';
-export { n as CallAttempt, o as CallError, p as ChainModelEntry, q as ChainWithGrounding, r as Constraints, E as EffortLevel, s as GoldenCaptureOptions, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, t as MutationApplied, u as NormalizedTokens, v as OutcomeKind, w as PerAxisMetricsByModel, x as PromptSection, y as SectionKind, z as ShadowProbeConfig, T as ToolCall, D as ToolDefinition, J as captureGoldenIr, K as hasMutation, L as mutationId, Q as parseGoldenCaptureRate, U as resolveGoldenCaptureRate, V as shouldCaptureGolden } from './ir-CTx026t0.js';
-import { ModelProfile, ArchetypeConvention } from './profiles.js';
-export { ALIASES, CacheStrategy, CliffRule, LATENCY_TIER_MS, LatencyTier, LoweringSpec, RecoveryRule, StructuredOutputCapability, SystemPromptMode, _testClearConsumerProfiles, allProfiles, bestEffortProfile, getProfile, inferProviderFromId, latencyTierOf, profilesByProvider, registerProfiles, resolveModelAlias, tryGetProfile } from './profiles.js';
+import { C as CompileOptions } from './compile-BlMXv6QT.js';
+import { N as NormalizedResponse, A as ApiKeys, P as ProviderOverrides, C as CompiledRequest, a as CompilePolicy, 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 OutcomeSource, i as OracleScore, j as Adapter, k as PerAxisMetrics, l as Provider, m as ChainEntry, G as Grounding } from './ir-DbvOFKF-.js';
+export { n as CallAttempt, o as CallError, p as ChainModelEntry, q as ChainWithGrounding, r as Constraints, E as EffortLevel, s as GoldenCaptureOptions, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, t as MutationApplied, u as NormalizedTokens, v as OutcomeKind, w as PerAxisMetricsByModel, x as PromptSection, y as SectionKind, z as ShadowProbeConfig, T as ToolCall, D as ToolDefinition, J as captureGoldenIr, K as hasMutation, L as mutationId, Q as parseGoldenCaptureRate, U as resolveGoldenCaptureRate, V as shouldCaptureGolden } from './ir-DbvOFKF-.js';
 export { BrainForwardConfig, BrainForwardRoutes, createBrainForwardRoutes } from './brain-proxy.js';
 export { KEY_FINGERPRINT_DOMAIN, KEY_FINGERPRINT_LENGTH, KeyHealthConfig, KeyHealthProvider, KeyHealthResponseBody, KeyHealthResult, KeyHealthRoute, createKeyHealthRoute, keyFingerprint } from './key-health.js';
+import { ModelProfile, ArchetypeConvention } from './profiles.js';
+export { ALIASES, CacheStrategy, CliffRule, LATENCY_TIER_MS, LatencyTier, LoweringSpec, RecoveryRule, StructuredOutputCapability, SystemPromptMode, _testClearConsumerProfiles, allProfiles, bestEffortProfile, getProfile, inferProviderFromId, latencyTierOf, profilesByProvider, registerProfiles, resolveModelAlias, tryGetProfile } from './profiles.js';
 import { IntentArchetypeName, OutputMode } from './dialect.js';
 export { ALL_ARCHETYPES, ContextBucket, DIALECT_VERSION, HistoryDepth, INTENT_ARCHETYPES, ShapeSignature, ToolCountBucket, bucketContext, bucketHistory, bucketToolCount, hashShape, isArchetype, learningKey } from './dialect.js';
 
-/**
- * compile() — the main orchestrator.
- *
- * Runs all passes in order, picks a target, lowers to wire format, returns
- * a CompileResult the caller uses to make the actual provider call.
- *
- * Pure function in v2.0.0-alpha.1: no network, no I/O, no mutation cache yet.
- * Mutation cache will be added in v2.1 when the brain has data to push.
- */
-
-interface CompileOptions {
-    /** Custom profile resolver — for tests or custom profile sets. */
-    profileResolver?: (id: string) => ModelProfile;
-    /** Tool relevance threshold (default 0.2). */
-    toolRelevanceThreshold?: number;
-    /** History compression — turns count threshold (default 8). */
-    compressHistoryAfter?: number;
-    /**
-     * History compression — token threshold (alpha.7). When total history
-     * tokens exceed this AND there are more recent turns to keep, compress
-     * even when count threshold is below `compressHistoryAfter`. Catches
-     * fat-message bloat (tool-using agents pack many tool-call/result pairs
-     * into single assistant messages — count stays low, tokens explode).
-     * Default undefined (disabled — backward-compatible).
-     */
-    compressHistoryAboveTokens?: number;
-    /**
-     * Consumer-declared policy. Filters blocked models, enforces cost
-     * ceiling, boosts preferred. See CompilePolicy in ir.ts.
-     */
-    policy?: CompilePolicy;
-    /**
-     * alpha.68 / Release A (delegation-fanout-accelerator §5.0, R0 linkage) —
-     * transport for the fan-out parent handle. Threaded from
-     * `CallOptions.parentHandle` on the call() path (and settable directly on the
-     * public compile() path). Release A does NOT route on it — it only labels the
-     * outcome row (fanout_role / trace_id / parent_handle) at record-registration
-     * time. `registerCompile` reads it to derive the linkage. Absent ⇒ root call.
-     */
-    parentHandle?: string;
-}
-
 /**
  * execute() — fire a CompiledRequest at the right provider, normalize the
  * response shape across providers.
@@ -666,6 +625,10 @@ interface OutcomePayload {
     provider?: string;
     shape_key?: string;
     learning_key?: string;
+    /** alpha.92 (migration 067) — route identity: 'direct' | 'openrouter'. */
+    route?: string;
+    /** alpha.92 — gateway-reported serving host (OpenRouter `provider` field). */
+    route_host?: string;
     mutations_applied: string[];
     tokens_in: number;
     tokens_out: number;
@@ -862,6 +825,7 @@ declare function buildShadowProbeRow(input: ShadowProbeRecordInput): {
     latency_candidate_ms: number | null;
     prompt_fidelity: number;
     replay_source: 'inline-full-ir';
+    evidence_basis: 'controlled';
     outcome: 'completed' | 'aborted_latency_budget' | 'skipped_slow_tier_sync' | 'candidate_error';
     error_class: string | null;
 };
@@ -1270,7 +1234,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.91";
+declare const LIBRARY_VERSION = "2.0.0-alpha.93";
 
 /**
  * Oracle contract — how an app tells the brain whether a response was good.
@@ -2668,7 +2632,7 @@ declare function getPerAxisMetrics(opts: GetPerAxisMetricsOpts): Promise<PerAxis
  * no execute() handler, no env-var convention). Narrowing here keeps the
  * reachability check structurally honest.
  */
-type SupportedProvider = 'anthropic' | 'google' | 'openai' | 'deepseek' | 'zai' | 'moonshot';
+type SupportedProvider = 'anthropic' | 'google' | 'openai' | 'deepseek' | 'zai' | 'moonshot' | 'openrouter';
 /**
  * Per-provider env var names kgauto recognizes. Order doesn't matter —
  * first-present wins. Multiple names per provider supported because Google
@@ -4091,4 +4055,4 @@ declare function planDecomposition(args: PlanDecompositionArgs): DecompositionPl
  */
 declare function compile(ir: PromptIR, opts?: CompileOptions): CompileResult;
 
-export { ABSOLUTE_FLOOR, type AISDKConvertedMessage, ALT_BLIND_TOKEN_BUDGET_BREACH, ALT_STRATEGY_IDS, ARCHETYPE_FAMILY_FITS, ARCHETYPE_FLOOR_DEFAULT, type ActionableAdvisory, Adapter, type AdvisoryEvidenceWindow, 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, BLOCKED_MODEL_FAMILY_SIBLING_SERVED_CODE, BLOCKED_MODEL_NOT_IN_ROSTER_CODE, BRAIN_READ_ENV_NAMES, BURST_SPAN_MS, 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_JUDGE_MODEL, DEFAULT_MEASURED_FAILURE_ENDPOINT, DEFAULT_PROMOTIONS_ENDPOINT, DELEGATE_TOOL_DEFINITION, DISCIPLINE_GATES_V1_ALT_BLIND_HEADER, 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_INDEPENDENT, STRATEGY_AUTHORSHIP_LIMITATION, SectionRewrite, type ShadowProbeRecordInput, type StrategyAttribution, type StrategyAttributionResult, type StrategyOutcome, type SupportedProvider, type SurfaceFailureRow, type SurfaceStats, SystemModelMessage, TRANSLATOR_FLOOR, _testResetMeasuredFailure, _testResetOutcomeSourceWarning, _testResetPromotions, _testWaitForMeasuredFailureRefresh, _testWaitForPromotionsRefresh, altBlindGatesBlockFor, altGatesBlockFor, applyArchetypeConvention, applySectionRewrites, attachCacheControlToStreamTextInput, awaitMeasuredFailureReady, awaitPromotionsReady, brainHealth, buildGoldenIrRow, buildLLMJudge, buildPairwiseJudgePrompt, buildShadowProbeRow, burstCaveat, call, chainProviderSpread, classifyEvidenceWindow, classifyStrategyOutcome, clearBrain, combineOrderSwappedVerdicts, compile, compileForAISDKv6, configureBrain, configureMeasuredFailureBrain, configurePromotionsBrain, countTokens, createDelegate, deriveFamilyFromModelId, deriveOwnership, estimateChainCostUsd, estimateModelCostUsd, execute, findBetterFit, flushBrainDeadLetter, formatEvidenceSpan, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getApplicablePromotion, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getMeasuredFailureVerdict, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecentRollback, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isAltStrategy, 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, prefetchPromotions, probeShadow, profileToRow, readBrainReadEnv, record, recordGoldenIr, recordOutcome, recordShadowProbe, renderIrForJudge, resetTokenizer, resolveConventionsForProfile, resolveOutcomeSource, resolvePricingAt, resolveProviderKey, rowToAdvisory, rubricFor, runAdvisor, runGoldenEval, runStrategyEvalWithAttribution, setTokenizer, wilsonLowerBound, withAltBlindDisciplineContract, withAltDisciplineContract, withDisciplineContract };
+export { ABSOLUTE_FLOOR, type AISDKConvertedMessage, ALT_BLIND_TOKEN_BUDGET_BREACH, ALT_STRATEGY_IDS, ARCHETYPE_FAMILY_FITS, ARCHETYPE_FLOOR_DEFAULT, type ActionableAdvisory, Adapter, type AdvisoryEvidenceWindow, 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, BLOCKED_MODEL_FAMILY_SIBLING_SERVED_CODE, BLOCKED_MODEL_NOT_IN_ROSTER_CODE, BRAIN_READ_ENV_NAMES, BURST_SPAN_MS, BestPracticeAdvisory, type BrainConfig, type BrainDeadLetterEntry, type BrainHealthSnapshot, type BrainQueryConfig, type BrainReadEnv, COACH_CFG, COST_RANKING_REFERENCE_SHAPE, CallOptions, CallResult, ChainEntry, type CompatibilityIntent, type CompileForAISDKv6Result, CompileOptions, CompilePolicy, CompileResult, CompiledRequest, type CreateDelegateOpts, DECOMPOSITION_TEMPLATES, DECOMPOSITION_TEMPLATES_VERSION, DEFAULT_FINDINGS_ENDPOINT, DEFAULT_JUDGE_MODEL, DEFAULT_MEASURED_FAILURE_ENDPOINT, DEFAULT_PROMOTIONS_ENDPOINT, DELEGATE_TOOL_DEFINITION, DISCIPLINE_GATES_V1_ALT_BLIND_HEADER, 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_INDEPENDENT, STRATEGY_AUTHORSHIP_LIMITATION, SectionRewrite, type ShadowProbeRecordInput, type StrategyAttribution, type StrategyAttributionResult, type StrategyOutcome, type SupportedProvider, type SurfaceFailureRow, type SurfaceStats, SystemModelMessage, TRANSLATOR_FLOOR, _testResetMeasuredFailure, _testResetOutcomeSourceWarning, _testResetPromotions, _testWaitForMeasuredFailureRefresh, _testWaitForPromotionsRefresh, altBlindGatesBlockFor, altGatesBlockFor, applyArchetypeConvention, applySectionRewrites, attachCacheControlToStreamTextInput, awaitMeasuredFailureReady, awaitPromotionsReady, brainHealth, buildGoldenIrRow, buildLLMJudge, buildPairwiseJudgePrompt, buildShadowProbeRow, burstCaveat, call, chainProviderSpread, classifyEvidenceWindow, classifyStrategyOutcome, clearBrain, combineOrderSwappedVerdicts, compile, compileForAISDKv6, configureBrain, configureMeasuredFailureBrain, configurePromotionsBrain, countTokens, createDelegate, deriveFamilyFromModelId, deriveOwnership, estimateChainCostUsd, estimateModelCostUsd, execute, findBetterFit, flushBrainDeadLetter, formatEvidenceSpan, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getApplicablePromotion, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getMeasuredFailureVerdict, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecentRollback, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isAltStrategy, 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, prefetchPromotions, probeShadow, profileToRow, readBrainReadEnv, record, recordGoldenIr, recordOutcome, recordShadowProbe, renderIrForJudge, resetTokenizer, resolveConventionsForProfile, resolveOutcomeSource, resolvePricingAt, resolveProviderKey, rowToAdvisory, rubricFor, runAdvisor, runGoldenEval, runStrategyEvalWithAttribution, setTokenizer, wilsonLowerBound, withAltBlindDisciplineContract, withAltDisciplineContract, withDisciplineContract };

package/dist/index.js

@@ -2977,6 +2977,9 @@ function hashShape(s) {
 function learningKey(archetype, model, shape) {
   return `${DIALECT_VERSION}::${archetype}::${model}::${hashShape(shape)}`;
 }
+function routeScopedModel(model, route) {
+  return route === "openrouter" ? `${model}@openrouter` : model;
+}
 
 // src/passes.ts
 function passSlice(ir) {
@@ -3634,7 +3637,26 @@ function passApplyConventions(ir, profile) {
 }
 
 // src/lower.ts
+var OPENROUTER_VENDOR_SLUG = {
+  anthropic: "anthropic",
+  google: "google",
+  openai: "openai",
+  deepseek: "deepseek",
+  zai: "z-ai",
+  moonshot: "moonshotai"
+};
+var OPENROUTER_ID_OVERRIDES = Object.freeze({});
+function openRouterModelId(profile) {
+  const override = OPENROUTER_ID_OVERRIDES[profile.id];
+  if (override) return override;
+  const slug = OPENROUTER_VENDOR_SLUG[profile.provider];
+  if (!slug) throw new Error(`No OpenRouter vendor slug for provider ${profile.provider} (model ${profile.id})`);
+  return `${slug}/${profile.id}`;
+}
 function lower(ir, profile, hints = {}) {
+  if (hints.route === "openrouter") {
+    return lowerOpenRouter(ir, profile);
+  }
   switch (profile.provider) {
     case "anthropic":
       return lowerAnthropic(ir, profile, hints);
@@ -3987,6 +4009,23 @@ function lowerZai(ir, profile, hints) {
     }
   };
 }
+function lowerOpenRouter(ir, profile) {
+  const parts = buildOpenAICompatibleParts(ir);
+  return {
+    request: {
+      provider: "openrouter",
+      model: openRouterModelId(profile),
+      messages: parts.messages,
+      tools: parts.tools,
+      response_format: parts.response_format
+    },
+    diagnostics: {
+      cacheableTokens: 0,
+      historyCacheableTokens: parts.historyCacheableTokens,
+      estimatedCacheSavingsUsd: 0
+    }
+  };
+}
 function lowerMoonshot(ir, profile) {
   const parts = buildOpenAICompatibleParts(ir);
   return {
@@ -4088,7 +4127,8 @@ var SUPPORTED_PROVIDERS = Object.freeze([
   "openai",
   "deepseek",
   "zai",
-  "moonshot"
+  "moonshot",
+  "openrouter"
 ]);
 function isSupportedProvider(p) {
   return SUPPORTED_PROVIDERS.includes(p);
@@ -4109,7 +4149,11 @@ var PROVIDER_ENV_KEYS = Object.freeze({
   // alpha.65 — Moonshot AI (Kimi family). MOONSHOT_API_KEY is canonical
   // (api.moonshot.ai); KIMI_API_KEY covers the platform.kimi.ai rebrand
   // surface so consumers keyed under either name resolve.
-  moonshot: Object.freeze(["MOONSHOT_API_KEY", "KIMI_API_KEY"])
+  moonshot: Object.freeze(["MOONSHOT_API_KEY", "KIMI_API_KEY"]),
+  // alpha.92 — the OpenRouter gateway route (execute-leg contract). This is
+  // a ROUTE key, not a vendor key: it never makes a vendor "reachable" for
+  // chain composition — only explicit `route: 'openrouter'` calls use it.
+  openrouter: Object.freeze(["OPENROUTER_API_KEY"])
 });
 function defaultEnv() {
   return typeof process !== "undefined" && process.env ? process.env : {};
@@ -6187,12 +6231,13 @@ function compile(ir, opts = {}) {
   const lowered = lower(workingIR, profile, {
     forceThinkingZero: cliffs.value.loweringHints.forceThinkingZero,
     forceTerseOutput: cliffs.value.loweringHints.forceTerseOutput,
-    wireOverrides
+    wireOverrides,
+    route: opts.route
   });
   validateFinalFit(workingIR, profile, inputTokens);
   const handle = makeHandle();
   const finalShape = computeShape(workingIR, inputTokens);
-  const _learningKey = learningKey(ir.intent.archetype, profile.id, finalShape);
+  const _learningKey = learningKey(ir.intent.archetype, routeScopedModel(profile.id, opts.route), finalShape);
   const historyCacheMarkIndex = computeHistoryCacheMarkIndex(workingIR);
   const systemMessages = buildSystemMessages(workingIR, profile.provider);
   const systemCacheMarkIndex = lastCacheableSystemIndex(systemMessages);
@@ -6419,7 +6464,7 @@ function validateFinalFit(ir, profile, tokens) {
 }
 
 // src/version.ts
-var LIBRARY_VERSION = "2.0.0-alpha.91";
+var LIBRARY_VERSION = "2.0.0-alpha.93";
 
 // src/pricing-brain.ts
 function isPricingRow(x) {
@@ -6694,7 +6739,7 @@ async function flushBrainDeadLetter() {
 }
 var compileRegistry = /* @__PURE__ */ new Map();
 var REGISTRY_MAX_ENTRIES = 1e4;
-function registerCompile(appId, archetype, ir, result, parentHandle) {
+function registerCompile(appId, archetype, ir, result, parentHandle, route) {
   if (compileRegistry.size >= REGISTRY_MAX_ENTRIES) {
     const cutoff = Math.floor(REGISTRY_MAX_ENTRIES * 0.25);
     let evicted = 0;
@@ -6726,7 +6771,10 @@ function registerCompile(appId, archetype, ir, result, parentHandle) {
     model: result.target,
     provider: result.provider,
     shapeKey,
-    learningKey: learningKey(archetype, result.target, shape),
+    route: route ?? "direct",
+    // alpha.92 — route-scoped for non-direct routes: the same model id on a
+    // gateway is a different serving stack (Venice/StreamLake, 2026-08-26).
+    learningKey: learningKey(archetype, routeScopedModel(result.target, route), shape),
     estimatedTokensIn: tokens,
     mutationsApplied: result.mutationsApplied.map((m) => m.id),
     // alpha.30: cache the in-memory advisories so record() can auto-persist
@@ -6920,6 +6968,11 @@ function buildPayload(input, reg) {
     provider: reg?.provider,
     shape_key: reg?.shapeKey,
     learning_key: reg?.learningKey,
+    // alpha.92 (migration 067) — route identity on every row. Input wins
+    // (a manual record() replaying through a gateway states its own route);
+    // registry fills the call() path; column default covers legacy writers.
+    route: input.route ?? reg?.route ?? "direct",
+    route_host: input.routeHost,
     mutations_applied: mutationsApplied,
     tokens_in: input.tokensIn,
     tokens_out: input.tokensOut,
@@ -7110,6 +7163,12 @@ function buildShadowProbeRow(input) {
     // prompt-fidelity guard never fires on these rows.
     prompt_fidelity: 1,
     replay_source: "inline-full-ir",
+    // alpha.93 (migration 068) — shadow probes replay the SAME full IR to
+    // the candidate: controlled by construction. Written at write time, per
+    // the mig-057 lesson (a marker inferred later can disagree with itself).
+    // The column default is 'observational' precisely so only writers that
+    // KNOW they are controlled say so.
+    evidence_basis: "controlled",
     // alpha — migration 029. 'completed' is the default completed-probe shape;
     // diagnostic rows (aborted/skipped/errored) pass the explicit class.
     outcome: input.outcome ?? "completed",
@@ -7714,6 +7773,7 @@ var OPENAI_URL = "https://api.openai.com/v1/chat/completions";
 var DEEPSEEK_URL = "https://api.deepseek.com/chat/completions";
 var ZAI_URL = "https://api.z.ai/api/paas/v4/chat/completions";
 var MOONSHOT_URL = "https://api.moonshot.ai/v1/chat/completions";
+var OPENROUTER_URL = "https://openrouter.ai/api/v1/chat/completions";
 async function execute(request, opts = {}) {
   const merged = applyOverrides(request, opts.providerOverrides);
   switch (merged.provider) {
@@ -7737,6 +7797,12 @@ async function execute(request, opts = {}) {
         opts,
         { provider: "moonshot", url: MOONSHOT_URL, missingKeyMessage: "MOONSHOT_API_KEY missing" }
       );
+    case "openrouter":
+      return executeOpenAICompatible(
+        merged,
+        opts,
+        { provider: "openrouter", url: OPENROUTER_URL, missingKeyMessage: "OPENROUTER_API_KEY missing" }
+      );
     default: {
       const _exhaustive = merged;
       throw new Error(`execute(): no executor for provider: ${JSON.stringify(_exhaustive)}`);
@@ -7936,6 +8002,7 @@ function normalizeOpenAILike(raw) {
   const r = raw;
   const choice = r.choices?.[0];
   const text = choice?.message?.content ?? "";
+  const routeHost = typeof raw?.provider === "string" ? raw.provider : void 0;
   const toolCalls = (choice?.message?.tool_calls ?? []).filter((tc) => tc.function?.name).map((tc, i) => ({
     id: tc.id ?? `tc-${i}`,
     name: tc.function.name,
@@ -7948,7 +8015,7 @@ function normalizeOpenAILike(raw) {
     total: u.total_tokens ?? (u.prompt_tokens ?? 0) + (u.completion_tokens ?? 0),
     cached: u.prompt_tokens_details?.cached_tokens
   };
-  return { text, structuredOutput: null, toolCalls, tokens, finishReason: choice?.finish_reason, raw };
+  return { text, structuredOutput: null, toolCalls, tokens, finishReason: choice?.finish_reason, routeHost, raw };
 }
 function applyOverrides(request, overrides) {
   if (!overrides) return request;
@@ -8387,6 +8454,7 @@ async function call(ir, opts = {}) {
         handle: initial.handle,
         source: opts.source,
         endUserId: opts.endUserId,
+        route: opts.route,
         tokensIn: 0,
         tokensOut: 0,
         latencyMs: latencyMs2,
@@ -8441,6 +8509,7 @@ async function call(ir, opts = {}) {
         handle: initial.handle,
         source: opts.source,
         endUserId: opts.endUserId,
+        route: opts.route,
         tokensIn: 0,
         tokensOut: 0,
         latencyMs: latencyMs2,
@@ -8584,6 +8653,11 @@ async function call(ir, opts = {}) {
         handle: initial.handle,
         source: opts.source,
         endUserId: opts.endUserId,
+        // alpha.92 — route identity on the row (registry also carries it;
+        // input wins in buildPayload, so state it explicitly here with the
+        // host the gateway reported for the WINNING attempt).
+        route: opts.route,
+        routeHost: validated.response.routeHost,
         tokensIn: validated.response.tokens.input,
         tokensOut: validated.response.tokens.output,
         latencyMs: latencyMs2,
@@ -8664,6 +8738,12 @@ async function call(ir, opts = {}) {
         provider: activeCompile.provider,
         response: validated.response,
         latencyMs: latencyMs2,
+        // alpha.92 — route identity + the served profile's cliffs flagged
+        // route-unverified on a non-direct route (guards still fired; their
+        // evidence is vendor-route evidence — see the execute-leg contract).
+        route: opts.route ?? "direct",
+        routeHost: validated.response.routeHost,
+        routeUnverifiedCliffs: opts.route === "openrouter" ? (tryGetProfile(targetModel)?.cliffs ?? []).map((c) => c.metric) : void 0,
         mutationsApplied: activeCompile.mutationsApplied,
         attempts,
         servedBy: targetModel,
@@ -8708,6 +8788,7 @@ async function call(ir, opts = {}) {
     handle: initial.handle,
     source: opts.source,
     endUserId: opts.endUserId,
+    route: opts.route,
     tokensIn: lastErr?.tokens?.input ?? 0,
     tokensOut: lastErr?.tokens?.output ?? 0,
     latencyMs,
@@ -8751,9 +8832,12 @@ function compileAndRegister(ir, opts) {
     toolRelevanceThreshold: opts.toolRelevanceThreshold,
     compressHistoryAfter: opts.compressHistoryAfter,
     // alpha.68 / Release A — carry the fan-out parent handle through to compile.
-    parentHandle: opts.parentHandle
+    parentHandle: opts.parentHandle,
+    // alpha.92 — gateway route (execute-leg contract): changes the wire +
+    // learning-key encoding, never the pass pipeline.
+    route: opts.route
   });
-  registerCompile(ir.appId, ir.intent.archetype, ir, result, opts.parentHandle);
+  registerCompile(ir.appId, ir.intent.archetype, ir, result, opts.parentHandle, opts.route);
   return result;
 }
 function extractPromptPreview(ir) {
@@ -11192,7 +11276,7 @@ function planDecomposition(args) {
 // src/index.ts
 function compile2(ir, opts) {
   const result = compile(ir, opts);
-  registerCompile(ir.appId, ir.intent.archetype, ir, result, opts?.parentHandle);
+  registerCompile(ir.appId, ir.intent.archetype, ir, result, opts?.parentHandle, opts?.route);
   return result;
 }
 // Annotate the CommonJS export names for ESM import in node: