@warmdrift/kgauto-compiler 2.0.0-alpha.44 → 2.0.0-alpha.45

package/dist/glassbox/index.d.mts

@@ -1,6 +1,6 @@
-import { G as GlassboxEvent } from '../types-B5DzMhYm.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-B5DzMhYm.mjs';
-import '../ir-DARjQnvZ.mjs';
+import { G as GlassboxEvent } from '../types-DMJqRzDF.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-DMJqRzDF.mjs';
+import '../ir-BBKgsUX7.mjs';
 import '../dialect.mjs';
 
 /**

package/dist/glassbox/index.d.ts

@@ -1,6 +1,6 @@
-import { G as GlassboxEvent } from '../types-BDqNQxuX.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-BDqNQxuX.js';
-import '../ir-DAUBaPhd.js';
+import { G as GlassboxEvent } from '../types-Bzw8tH-7.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-Bzw8tH-7.js';
+import '../ir-D3n-pBYI.js';
 import '../dialect.js';
 
 /**

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

@@ -1,5 +1,5 @@
-import { T as TraceHealth } from '../types-Rq_fywDq.mjs';
-import '../ir-DARjQnvZ.mjs';
+import { T as TraceHealth } from '../types-xBWYk9Mm.mjs';
+import '../ir-BBKgsUX7.mjs';
 import '../dialect.mjs';
 
 /**

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

@@ -1,5 +1,5 @@
-import { T as TraceHealth } from '../types-CfVyRbCl.js';
-import '../ir-DAUBaPhd.js';
+import { T as TraceHealth } from '../types-B6z-8phQ.js';
+import '../ir-D3n-pBYI.js';
 import '../dialect.js';
 
 /**

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

@@ -1,7 +1,7 @@
-import { G as GlassboxEvent } from '../types-B5DzMhYm.mjs';
-import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-Rq_fywDq.mjs';
-export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-Rq_fywDq.mjs';
-import '../ir-DARjQnvZ.mjs';
+import { G as GlassboxEvent } from '../types-DMJqRzDF.mjs';
+import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-xBWYk9Mm.mjs';
+export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-xBWYk9Mm.mjs';
+import '../ir-BBKgsUX7.mjs';
 import '../dialect.mjs';
 
 /**

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

@@ -1,7 +1,7 @@
-import { G as GlassboxEvent } from '../types-BDqNQxuX.js';
-import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-CfVyRbCl.js';
-export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-CfVyRbCl.js';
-import '../ir-DAUBaPhd.js';
+import { G as GlassboxEvent } from '../types-Bzw8tH-7.js';
+import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-B6z-8phQ.js';
+export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-B6z-8phQ.js';
+import '../ir-D3n-pBYI.js';
 import '../dialect.js';
 
 /**

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-Rq_fywDq.mjs';
-import '../../ir-DARjQnvZ.mjs';
+import { a as TraceDetail } from '../../types-xBWYk9Mm.mjs';
+import '../../ir-BBKgsUX7.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-CfVyRbCl.js';
-import '../../ir-DAUBaPhd.js';
+import { a as TraceDetail } from '../../types-B6z-8phQ.js';
+import '../../ir-D3n-pBYI.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, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, B as BestPracticeAdvisory, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-DARjQnvZ.mjs';
-export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, F as FallbackReason, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, r as MutationApplied, s as NormalizedTokens, t as OutcomeKind, u as PerAxisMetricsByModel, v as PromptSection, w as SectionKind, T as ToolCall, x as ToolDefinition } from './ir-DARjQnvZ.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, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, B as BestPracticeAdvisory, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-BBKgsUX7.mjs';
+export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, F as FallbackReason, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, r as MutationApplied, s as NormalizedTokens, t as OutcomeKind, u as PerAxisMetricsByModel, v as PromptSection, w as SectionKind, x as ShadowProbeConfig, T as ToolCall, y as ToolDefinition } from './ir-BBKgsUX7.mjs';
 import { ModelProfile, ArchetypeConvention } from './profiles.mjs';
 export { ALIASES, CacheStrategy, CliffRule, LoweringSpec, RecoveryRule, StructuredOutputCapability, SystemPromptMode, allProfiles, getProfile, profilesByProvider, tryGetProfile } from './profiles.mjs';
 import { IntentArchetypeName } from './dialect.mjs';
@@ -335,6 +335,71 @@ interface OutcomePayload {
  * failure. Never throws.
  */
 declare function recordOutcome(input: RecordOutcomeInput): Promise<OutcomeResult>;
+/**
+ * True when the active brain config requests synchronous (awaited) writes.
+ * call()'s shadow-probe path reads this to decide whether to await the probe
+ * (Edge/Worker/Lambda — L-086) or fire-and-forget (Node). False when no brain
+ * is configured.
+ */
+declare function isBrainSync(): boolean;
+/**
+ * Full-IR inline shadow-probe record input (Shape B, Phase 1 — s51). Carries
+ * ONLY response previews + metadata; the prompt (system/context/payload) is
+ * never included — `promptHash` is an irreversible grouping key, not content.
+ */
+interface ShadowProbeRecordInput {
+    appId: string;
+    archetype: string;
+    family: string;
+    candidateModel: string;
+    currentModel: string;
+    /** Irreversible grouping hash (NOT the prompt). */
+    promptHash: string;
+    /** Served model's response, truncated (RESPONSE text only — never the prompt). */
+    currentResponsePreview?: string;
+    /** Candidate model's response, truncated. */
+    candidateResponsePreview?: string;
+    tokensCurrentIn?: number;
+    tokensCurrentOut?: number;
+    tokensCandidateIn?: number;
+    tokensCandidateOut?: number;
+}
+/**
+ * Pure builder for the `probe_outcomes` row written by the inline shadow-probe.
+ * Exported so a test can assert the G3 privacy invariant: the row carries NO
+ * prompt/system/context text — only response previews + metadata + a hash.
+ *
+ * Phase 1 (judge: 'off'): `judge_verdict` / `judge_score` are null — the row
+ * is an unjudged sample for the Phase-2 offline batch judge. `prompt_fidelity`
+ * is 1.0 by construction (the candidate ran the full IR, not a truncated
+ * preview), and `replay_source='inline-full-ir'` marks it as a trustworthy row
+ * (vs the watchers' lossy `replay-preview`).
+ */
+declare function buildShadowProbeRow(input: ShadowProbeRecordInput): {
+    app_id: string;
+    intent_archetype: string;
+    family: string;
+    candidate_model: string;
+    current_model: string;
+    prompt_hash: string;
+    current_response: string | null;
+    candidate_response: string | null;
+    judge_verdict: null;
+    judge_score: null;
+    tokens_current_in: number | null;
+    tokens_current_out: number | null;
+    tokens_candidate_in: number | null;
+    tokens_candidate_out: number | null;
+    prompt_fidelity: number;
+    replay_source: 'inline-full-ir';
+};
+/**
+ * Persist one inline shadow-probe row to `probe_outcomes`. Fire-and-forget by
+ * default; honors `BrainConfig.sync` (L-086). Never throws — failures route to
+ * onError. Mirrors record()'s POST shape; consumer proxies forward
+ * `/probe_outcomes` the same way they forward `/outcomes`.
+ */
+declare function recordShadowProbe(input: ShadowProbeRecordInput): Promise<void>;
 
 /**
  * Oracle contract — how an app tells the brain whether a response was good.
@@ -2119,4 +2184,4 @@ declare function markPromoteReadyHandled(opts: MarkPromoteReadyHandledOptions):
  */
 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 BrainQueryConfig, type BrainReadEnv, CallOptions, CallResult, ChainEntry, type CompatibilityIntent, type CompileOptions, CompilePolicy, CompileResult, CompiledRequest, DEFAULT_FINDINGS_ENDPOINT, type ExclusionFindingRow, type ExclusionResolutionSource, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type FallbackPosture, FamilyResolutionError, type GetActionableAdvisoriesOptions, type GetDefaultFallbackChainOpts, type GetPerAxisMetricsOpts, type GetRecommendedPrimaryOptions, Grounding, IntentArchetypeName, type LLMJudgeOptions, MEASURED_GROUNDING_MIN_N, type MarkAdvisoryResolvedOptions, type MarkExclusionFindingHandledOptions, type MarkPromoteReadyHandledOptions, type ModelBrainRow, type ModelCompatibility, ModelProfile, NormalizedResponse, type OracleContext, OracleScore, type OutcomePayload, OutcomeResult, PRODUCER_OWNED_RULE_CODES, PROVIDER_ENV_KEYS, PerAxisMetrics, type PricingRow, type ProfileToRowOptions, type PromoteReadyFindingRow, type PromoteReadyResolution, PromptIR, Provider, ProviderOverrides, type ProviderReachability, RULE_SEQUENTIAL_TOOL_CLIFF, type ReachabilityOpts, RecordInput, RecordOutcomeInput, type RunAdvisorPhase2Context, SectionRewrite, type SupportedProvider, SystemModelMessage, TRANSLATOR_FLOOR, applyArchetypeConvention, applySectionRewrites, attachCacheControlToStreamTextInput, buildLLMJudge, call, clearBrain, compile, configureBrain, countTokens, deriveFamilyFromModelId, deriveOwnership, execute, findBetterFit, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isBrainQueryActiveFor, isExclusionFindingsBrainActive, isModelReachable, isProviderReachable, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, markAdvisoryResolved, markExclusionFindingHandled, markPromoteReadyHandled, profileToRow, readBrainReadEnv, record, recordOutcome, resetTokenizer, resolveConventionsForProfile, resolvePricingAt, resolveProviderKey, runAdvisor, setTokenizer };
+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 BrainQueryConfig, type BrainReadEnv, CallOptions, CallResult, ChainEntry, type CompatibilityIntent, type CompileOptions, CompilePolicy, CompileResult, CompiledRequest, DEFAULT_FINDINGS_ENDPOINT, type ExclusionFindingRow, type ExclusionResolutionSource, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type FallbackPosture, FamilyResolutionError, type GetActionableAdvisoriesOptions, type GetDefaultFallbackChainOpts, type GetPerAxisMetricsOpts, type GetRecommendedPrimaryOptions, Grounding, IntentArchetypeName, type LLMJudgeOptions, MEASURED_GROUNDING_MIN_N, type MarkAdvisoryResolvedOptions, type MarkExclusionFindingHandledOptions, type MarkPromoteReadyHandledOptions, type ModelBrainRow, type ModelCompatibility, ModelProfile, NormalizedResponse, type OracleContext, OracleScore, type OutcomePayload, OutcomeResult, PRODUCER_OWNED_RULE_CODES, PROVIDER_ENV_KEYS, PerAxisMetrics, type PricingRow, type ProfileToRowOptions, type PromoteReadyFindingRow, type PromoteReadyResolution, PromptIR, Provider, ProviderOverrides, type ProviderReachability, RULE_SEQUENTIAL_TOOL_CLIFF, type ReachabilityOpts, RecordInput, RecordOutcomeInput, type RunAdvisorPhase2Context, SectionRewrite, type ShadowProbeRecordInput, type SupportedProvider, SystemModelMessage, TRANSLATOR_FLOOR, applyArchetypeConvention, applySectionRewrites, attachCacheControlToStreamTextInput, buildLLMJudge, buildShadowProbeRow, call, clearBrain, compile, configureBrain, countTokens, deriveFamilyFromModelId, deriveOwnership, execute, findBetterFit, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isBrainQueryActiveFor, isBrainSync, isExclusionFindingsBrainActive, isModelReachable, isProviderReachable, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, markAdvisoryResolved, markExclusionFindingHandled, markPromoteReadyHandled, profileToRow, readBrainReadEnv, record, recordOutcome, recordShadowProbe, resetTokenizer, resolveConventionsForProfile, resolvePricingAt, resolveProviderKey, runAdvisor, setTokenizer };

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, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, B as BestPracticeAdvisory, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-DAUBaPhd.js';
-export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, F as FallbackReason, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, r as MutationApplied, s as NormalizedTokens, t as OutcomeKind, u as PerAxisMetricsByModel, v as PromptSection, w as SectionKind, T as ToolCall, x as ToolDefinition } from './ir-DAUBaPhd.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, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, B as BestPracticeAdvisory, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-D3n-pBYI.js';
+export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, F as FallbackReason, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, r as MutationApplied, s as NormalizedTokens, t as OutcomeKind, u as PerAxisMetricsByModel, v as PromptSection, w as SectionKind, x as ShadowProbeConfig, T as ToolCall, y as ToolDefinition } from './ir-D3n-pBYI.js';
 import { ModelProfile, ArchetypeConvention } from './profiles.js';
 export { ALIASES, CacheStrategy, CliffRule, LoweringSpec, RecoveryRule, StructuredOutputCapability, SystemPromptMode, allProfiles, getProfile, profilesByProvider, tryGetProfile } from './profiles.js';
 import { IntentArchetypeName } from './dialect.js';
@@ -335,6 +335,71 @@ interface OutcomePayload {
  * failure. Never throws.
  */
 declare function recordOutcome(input: RecordOutcomeInput): Promise<OutcomeResult>;
+/**
+ * True when the active brain config requests synchronous (awaited) writes.
+ * call()'s shadow-probe path reads this to decide whether to await the probe
+ * (Edge/Worker/Lambda — L-086) or fire-and-forget (Node). False when no brain
+ * is configured.
+ */
+declare function isBrainSync(): boolean;
+/**
+ * Full-IR inline shadow-probe record input (Shape B, Phase 1 — s51). Carries
+ * ONLY response previews + metadata; the prompt (system/context/payload) is
+ * never included — `promptHash` is an irreversible grouping key, not content.
+ */
+interface ShadowProbeRecordInput {
+    appId: string;
+    archetype: string;
+    family: string;
+    candidateModel: string;
+    currentModel: string;
+    /** Irreversible grouping hash (NOT the prompt). */
+    promptHash: string;
+    /** Served model's response, truncated (RESPONSE text only — never the prompt). */
+    currentResponsePreview?: string;
+    /** Candidate model's response, truncated. */
+    candidateResponsePreview?: string;
+    tokensCurrentIn?: number;
+    tokensCurrentOut?: number;
+    tokensCandidateIn?: number;
+    tokensCandidateOut?: number;
+}
+/**
+ * Pure builder for the `probe_outcomes` row written by the inline shadow-probe.
+ * Exported so a test can assert the G3 privacy invariant: the row carries NO
+ * prompt/system/context text — only response previews + metadata + a hash.
+ *
+ * Phase 1 (judge: 'off'): `judge_verdict` / `judge_score` are null — the row
+ * is an unjudged sample for the Phase-2 offline batch judge. `prompt_fidelity`
+ * is 1.0 by construction (the candidate ran the full IR, not a truncated
+ * preview), and `replay_source='inline-full-ir'` marks it as a trustworthy row
+ * (vs the watchers' lossy `replay-preview`).
+ */
+declare function buildShadowProbeRow(input: ShadowProbeRecordInput): {
+    app_id: string;
+    intent_archetype: string;
+    family: string;
+    candidate_model: string;
+    current_model: string;
+    prompt_hash: string;
+    current_response: string | null;
+    candidate_response: string | null;
+    judge_verdict: null;
+    judge_score: null;
+    tokens_current_in: number | null;
+    tokens_current_out: number | null;
+    tokens_candidate_in: number | null;
+    tokens_candidate_out: number | null;
+    prompt_fidelity: number;
+    replay_source: 'inline-full-ir';
+};
+/**
+ * Persist one inline shadow-probe row to `probe_outcomes`. Fire-and-forget by
+ * default; honors `BrainConfig.sync` (L-086). Never throws — failures route to
+ * onError. Mirrors record()'s POST shape; consumer proxies forward
+ * `/probe_outcomes` the same way they forward `/outcomes`.
+ */
+declare function recordShadowProbe(input: ShadowProbeRecordInput): Promise<void>;
 
 /**
  * Oracle contract — how an app tells the brain whether a response was good.
@@ -2119,4 +2184,4 @@ declare function markPromoteReadyHandled(opts: MarkPromoteReadyHandledOptions):
  */
 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 BrainQueryConfig, type BrainReadEnv, CallOptions, CallResult, ChainEntry, type CompatibilityIntent, type CompileOptions, CompilePolicy, CompileResult, CompiledRequest, DEFAULT_FINDINGS_ENDPOINT, type ExclusionFindingRow, type ExclusionResolutionSource, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type FallbackPosture, FamilyResolutionError, type GetActionableAdvisoriesOptions, type GetDefaultFallbackChainOpts, type GetPerAxisMetricsOpts, type GetRecommendedPrimaryOptions, Grounding, IntentArchetypeName, type LLMJudgeOptions, MEASURED_GROUNDING_MIN_N, type MarkAdvisoryResolvedOptions, type MarkExclusionFindingHandledOptions, type MarkPromoteReadyHandledOptions, type ModelBrainRow, type ModelCompatibility, ModelProfile, NormalizedResponse, type OracleContext, OracleScore, type OutcomePayload, OutcomeResult, PRODUCER_OWNED_RULE_CODES, PROVIDER_ENV_KEYS, PerAxisMetrics, type PricingRow, type ProfileToRowOptions, type PromoteReadyFindingRow, type PromoteReadyResolution, PromptIR, Provider, ProviderOverrides, type ProviderReachability, RULE_SEQUENTIAL_TOOL_CLIFF, type ReachabilityOpts, RecordInput, RecordOutcomeInput, type RunAdvisorPhase2Context, SectionRewrite, type SupportedProvider, SystemModelMessage, TRANSLATOR_FLOOR, applyArchetypeConvention, applySectionRewrites, attachCacheControlToStreamTextInput, buildLLMJudge, call, clearBrain, compile, configureBrain, countTokens, deriveFamilyFromModelId, deriveOwnership, execute, findBetterFit, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isBrainQueryActiveFor, isExclusionFindingsBrainActive, isModelReachable, isProviderReachable, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, markAdvisoryResolved, markExclusionFindingHandled, markPromoteReadyHandled, profileToRow, readBrainReadEnv, record, recordOutcome, resetTokenizer, resolveConventionsForProfile, resolvePricingAt, resolveProviderKey, runAdvisor, setTokenizer };
+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 BrainQueryConfig, type BrainReadEnv, CallOptions, CallResult, ChainEntry, type CompatibilityIntent, type CompileOptions, CompilePolicy, CompileResult, CompiledRequest, DEFAULT_FINDINGS_ENDPOINT, type ExclusionFindingRow, type ExclusionResolutionSource, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type FallbackPosture, FamilyResolutionError, type GetActionableAdvisoriesOptions, type GetDefaultFallbackChainOpts, type GetPerAxisMetricsOpts, type GetRecommendedPrimaryOptions, Grounding, IntentArchetypeName, type LLMJudgeOptions, MEASURED_GROUNDING_MIN_N, type MarkAdvisoryResolvedOptions, type MarkExclusionFindingHandledOptions, type MarkPromoteReadyHandledOptions, type ModelBrainRow, type ModelCompatibility, ModelProfile, NormalizedResponse, type OracleContext, OracleScore, type OutcomePayload, OutcomeResult, PRODUCER_OWNED_RULE_CODES, PROVIDER_ENV_KEYS, PerAxisMetrics, type PricingRow, type ProfileToRowOptions, type PromoteReadyFindingRow, type PromoteReadyResolution, PromptIR, Provider, ProviderOverrides, type ProviderReachability, RULE_SEQUENTIAL_TOOL_CLIFF, type ReachabilityOpts, RecordInput, RecordOutcomeInput, type RunAdvisorPhase2Context, SectionRewrite, type ShadowProbeRecordInput, type SupportedProvider, SystemModelMessage, TRANSLATOR_FLOOR, applyArchetypeConvention, applySectionRewrites, attachCacheControlToStreamTextInput, buildLLMJudge, buildShadowProbeRow, call, clearBrain, compile, configureBrain, countTokens, deriveFamilyFromModelId, deriveOwnership, execute, findBetterFit, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isBrainQueryActiveFor, isBrainSync, isExclusionFindingsBrainActive, isModelReachable, isProviderReachable, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, markAdvisoryResolved, markExclusionFindingHandled, markPromoteReadyHandled, profileToRow, readBrainReadEnv, record, recordOutcome, recordShadowProbe, resetTokenizer, resolveConventionsForProfile, resolvePricingAt, resolveProviderKey, runAdvisor, setTokenizer };

package/dist/index.js

@@ -43,6 +43,7 @@ __export(index_exports, {
   bucketHistory: () => bucketHistory,
   bucketToolCount: () => bucketToolCount,
   buildLLMJudge: () => buildLLMJudge,
+  buildShadowProbeRow: () => buildShadowProbeRow,
   call: () => call,
   clearBrain: () => clearBrain,
   compile: () => compile2,
@@ -71,6 +72,7 @@ __export(index_exports, {
   hashShape: () => hashShape,
   isArchetype: () => isArchetype,
   isBrainQueryActiveFor: () => isBrainQueryActiveFor,
+  isBrainSync: () => isBrainSync,
   isExclusionFindingsBrainActive: () => isExclusionFindingsBrainActive,
   isModelReachable: () => isModelReachable,
   isProviderReachable: () => isProviderReachable,
@@ -89,6 +91,7 @@ __export(index_exports, {
   readBrainReadEnv: () => readBrainReadEnv,
   record: () => record,
   recordOutcome: () => recordOutcome,
+  recordShadowProbe: () => recordShadowProbe,
   resetTokenizer: () => resetTokenizer,
   resolveConventionsForProfile: () => resolveConventionsForProfile,
   resolvePricingAt: () => resolvePricingAt,
@@ -4472,6 +4475,61 @@ async function recordOutcome(input) {
   void send();
   return { ok: true };
 }
+function isBrainSync() {
+  return activeConfig?.sync === true;
+}
+function buildShadowProbeRow(input) {
+  return {
+    app_id: input.appId,
+    intent_archetype: input.archetype,
+    family: input.family,
+    candidate_model: input.candidateModel,
+    current_model: input.currentModel,
+    prompt_hash: input.promptHash,
+    current_response: input.currentResponsePreview ?? null,
+    candidate_response: input.candidateResponsePreview ?? null,
+    judge_verdict: null,
+    judge_score: null,
+    tokens_current_in: input.tokensCurrentIn ?? null,
+    tokens_current_out: input.tokensCurrentOut ?? null,
+    tokens_candidate_in: input.tokensCandidateIn ?? null,
+    tokens_candidate_out: input.tokensCandidateOut ?? null,
+    // Full IR was replayed (not a truncated preview), so fidelity is 1.0 — the
+    // prompt-fidelity guard never fires on these rows.
+    prompt_fidelity: 1,
+    replay_source: "inline-full-ir"
+  };
+}
+async function recordShadowProbe(input) {
+  if (!activeConfig) return;
+  const config = activeConfig;
+  const fetchFn = config.fetchImpl ?? fetch;
+  const row = buildShadowProbeRow(input);
+  const send = async () => {
+    try {
+      const res = await fetchFn(`${config.endpoint}/probe_outcomes`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Prefer: "return=minimal",
+          ...config.apiKey ? { Authorization: `Bearer ${config.apiKey}` } : {}
+        },
+        body: JSON.stringify(row)
+      });
+      if (!res.ok) {
+        const text = await res.text().catch(() => "<no body>");
+        throw new Error(`brain probe_outcomes ${res.status}: ${text}`);
+      }
+    } catch (err) {
+      (config.onError ?? defaultOnError5)(err);
+    }
+  };
+  if (config.sync) {
+    await send();
+  } else {
+    void send();
+  }
+}
 
 // src/ir.ts
 var CallError = class extends Error {
@@ -5951,6 +6009,19 @@ async function call(ir, opts = {}) {
           );
         }
       }
+      if (opts.shadowProbe) {
+        const probe = runShadowProbe({
+          ir,
+          opts,
+          servedModel: targetModel,
+          servedResponse: validated.response
+        });
+        if (isBrainSync()) {
+          await probe;
+        } else {
+          void probe;
+        }
+      }
       return {
         handle: initial.handle,
         actualModel: targetModel,
@@ -6023,6 +6094,65 @@ function extractPromptPreview(ir) {
   if (lastHist) return lastHist.slice(0, 200);
   return void 0;
 }
+function shouldSampleProbe(sampleRate, rng = Math.random) {
+  if (!(sampleRate > 0)) return false;
+  if (sampleRate >= 1) return true;
+  return rng() < sampleRate;
+}
+function normalizeProbeCandidates(candidates) {
+  const arr = Array.isArray(candidates) ? candidates : [candidates];
+  return [...new Set(arr.filter((c) => typeof c === "string" && c.length > 0))];
+}
+function hashForProbe(s) {
+  let h = 0;
+  for (let i = 0; i < s.length; i++) h = (h << 5) - h + s.charCodeAt(i) | 0;
+  return `h${(h >>> 0).toString(16)}`;
+}
+async function runShadowProbe(args) {
+  try {
+    const cfg = args.opts.shadowProbe;
+    if (!shouldSampleProbe(cfg.sampleRate ?? 0.05)) return;
+    const candidates = normalizeProbeCandidates(cfg.candidates);
+    const promptHash = hashForProbe(args.ir.currentTurn?.content ?? "");
+    for (const candidate of candidates) {
+      if (candidate === args.servedModel) continue;
+      if (deriveFamilyFromModelId(candidate) === "claude-opus") continue;
+      if (!isModelReachable(candidate, { apiKeys: args.opts.apiKeys })) continue;
+      try {
+        const candCompile = compileAndRegister(
+          {
+            ...args.ir,
+            models: args.ir.models.includes(candidate) ? args.ir.models : [candidate, ...args.ir.models],
+            constraints: { ...args.ir.constraints ?? {}, forceModel: candidate }
+          },
+          args.opts
+        );
+        const exec = await execute(candCompile.request, {
+          apiKeys: args.opts.apiKeys,
+          fetchImpl: args.opts.fetchImpl,
+          providerOverrides: args.opts.providerOverrides
+        });
+        if (!exec.ok) continue;
+        await recordShadowProbe({
+          appId: args.ir.appId,
+          archetype: args.ir.intent.archetype,
+          family: deriveFamilyFromModelId(candidate) ?? candCompile.provider,
+          candidateModel: candidate,
+          currentModel: args.servedModel,
+          promptHash,
+          currentResponsePreview: args.servedResponse.text.slice(0, 2e3),
+          candidateResponsePreview: exec.response.text.slice(0, 2e3),
+          tokensCurrentIn: args.servedResponse.tokens.input,
+          tokensCurrentOut: args.servedResponse.tokens.output,
+          tokensCandidateIn: exec.response.tokens.input,
+          tokensCandidateOut: exec.response.tokens.output
+        });
+      } catch {
+      }
+    }
+  } catch {
+  }
+}
 function validateStructuredContract(exec, ir) {
   if (!ir.constraints?.structuredOutput) {
     return { ok: true, response: exec.response };
@@ -6564,6 +6694,7 @@ function compile2(ir, opts) {
   bucketHistory,
   bucketToolCount,
   buildLLMJudge,
+  buildShadowProbeRow,
   call,
   clearBrain,
   compile,
@@ -6592,6 +6723,7 @@ function compile2(ir, opts) {
   hashShape,
   isArchetype,
   isBrainQueryActiveFor,
+  isBrainSync,
   isExclusionFindingsBrainActive,
   isModelReachable,
   isProviderReachable,
@@ -6610,6 +6742,7 @@ function compile2(ir, opts) {
   readBrainReadEnv,
   record,
   recordOutcome,
+  recordShadowProbe,
   resetTokenizer,
   resolveConventionsForProfile,
   resolvePricingAt,

package/dist/index.mjs

@@ -2825,6 +2825,61 @@ async function recordOutcome(input) {
   void send();
   return { ok: true };
 }
+function isBrainSync() {
+  return activeConfig?.sync === true;
+}
+function buildShadowProbeRow(input) {
+  return {
+    app_id: input.appId,
+    intent_archetype: input.archetype,
+    family: input.family,
+    candidate_model: input.candidateModel,
+    current_model: input.currentModel,
+    prompt_hash: input.promptHash,
+    current_response: input.currentResponsePreview ?? null,
+    candidate_response: input.candidateResponsePreview ?? null,
+    judge_verdict: null,
+    judge_score: null,
+    tokens_current_in: input.tokensCurrentIn ?? null,
+    tokens_current_out: input.tokensCurrentOut ?? null,
+    tokens_candidate_in: input.tokensCandidateIn ?? null,
+    tokens_candidate_out: input.tokensCandidateOut ?? null,
+    // Full IR was replayed (not a truncated preview), so fidelity is 1.0 — the
+    // prompt-fidelity guard never fires on these rows.
+    prompt_fidelity: 1,
+    replay_source: "inline-full-ir"
+  };
+}
+async function recordShadowProbe(input) {
+  if (!activeConfig) return;
+  const config = activeConfig;
+  const fetchFn = config.fetchImpl ?? fetch;
+  const row = buildShadowProbeRow(input);
+  const send = async () => {
+    try {
+      const res = await fetchFn(`${config.endpoint}/probe_outcomes`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Prefer: "return=minimal",
+          ...config.apiKey ? { Authorization: `Bearer ${config.apiKey}` } : {}
+        },
+        body: JSON.stringify(row)
+      });
+      if (!res.ok) {
+        const text = await res.text().catch(() => "<no body>");
+        throw new Error(`brain probe_outcomes ${res.status}: ${text}`);
+      }
+    } catch (err) {
+      (config.onError ?? defaultOnError4)(err);
+    }
+  };
+  if (config.sync) {
+    await send();
+  } else {
+    void send();
+  }
+}
 
 // src/ir.ts
 var CallError = class extends Error {
@@ -3589,6 +3644,19 @@ async function call(ir, opts = {}) {
           );
         }
       }
+      if (opts.shadowProbe) {
+        const probe = runShadowProbe({
+          ir,
+          opts,
+          servedModel: targetModel,
+          servedResponse: validated.response
+        });
+        if (isBrainSync()) {
+          await probe;
+        } else {
+          void probe;
+        }
+      }
       return {
         handle: initial.handle,
         actualModel: targetModel,
@@ -3661,6 +3729,65 @@ function extractPromptPreview(ir) {
   if (lastHist) return lastHist.slice(0, 200);
   return void 0;
 }
+function shouldSampleProbe(sampleRate, rng = Math.random) {
+  if (!(sampleRate > 0)) return false;
+  if (sampleRate >= 1) return true;
+  return rng() < sampleRate;
+}
+function normalizeProbeCandidates(candidates) {
+  const arr = Array.isArray(candidates) ? candidates : [candidates];
+  return [...new Set(arr.filter((c) => typeof c === "string" && c.length > 0))];
+}
+function hashForProbe(s) {
+  let h = 0;
+  for (let i = 0; i < s.length; i++) h = (h << 5) - h + s.charCodeAt(i) | 0;
+  return `h${(h >>> 0).toString(16)}`;
+}
+async function runShadowProbe(args) {
+  try {
+    const cfg = args.opts.shadowProbe;
+    if (!shouldSampleProbe(cfg.sampleRate ?? 0.05)) return;
+    const candidates = normalizeProbeCandidates(cfg.candidates);
+    const promptHash = hashForProbe(args.ir.currentTurn?.content ?? "");
+    for (const candidate of candidates) {
+      if (candidate === args.servedModel) continue;
+      if (deriveFamilyFromModelId(candidate) === "claude-opus") continue;
+      if (!isModelReachable(candidate, { apiKeys: args.opts.apiKeys })) continue;
+      try {
+        const candCompile = compileAndRegister(
+          {
+            ...args.ir,
+            models: args.ir.models.includes(candidate) ? args.ir.models : [candidate, ...args.ir.models],
+            constraints: { ...args.ir.constraints ?? {}, forceModel: candidate }
+          },
+          args.opts
+        );
+        const exec = await execute(candCompile.request, {
+          apiKeys: args.opts.apiKeys,
+          fetchImpl: args.opts.fetchImpl,
+          providerOverrides: args.opts.providerOverrides
+        });
+        if (!exec.ok) continue;
+        await recordShadowProbe({
+          appId: args.ir.appId,
+          archetype: args.ir.intent.archetype,
+          family: deriveFamilyFromModelId(candidate) ?? candCompile.provider,
+          candidateModel: candidate,
+          currentModel: args.servedModel,
+          promptHash,
+          currentResponsePreview: args.servedResponse.text.slice(0, 2e3),
+          candidateResponsePreview: exec.response.text.slice(0, 2e3),
+          tokensCurrentIn: args.servedResponse.tokens.input,
+          tokensCurrentOut: args.servedResponse.tokens.output,
+          tokensCandidateIn: exec.response.tokens.input,
+          tokensCandidateOut: exec.response.tokens.output
+        });
+      } catch {
+      }
+    }
+  } catch {
+  }
+}
 function validateStructuredContract(exec, ir) {
   if (!ir.constraints?.structuredOutput) {
     return { ok: true, response: exec.response };
@@ -4201,6 +4328,7 @@ export {
   bucketHistory,
   bucketToolCount,
   buildLLMJudge,
+  buildShadowProbeRow,
   call,
   clearBrain,
   compile2 as compile,
@@ -4229,6 +4357,7 @@ export {
   hashShape,
   isArchetype,
   isBrainQueryActiveFor,
+  isBrainSync,
   isExclusionFindingsBrainActive,
   isModelReachable,
   isProviderReachable,
@@ -4247,6 +4376,7 @@ export {
   readBrainReadEnv,
   record,
   recordOutcome,
+  recordShadowProbe,
   resetTokenizer,
   resolveConventionsForProfile,
   resolvePricingAt,

package/dist/{ir-DARjQnvZ.d.mts → ir-BBKgsUX7.d.mts}

@@ -799,9 +799,47 @@ interface ProviderOverrides {
     openai?: Record<string, unknown>;
     deepseek?: Record<string, unknown>;
 }
+/**
+ * Full-IR inline shadow-probe config (Shape B, Phase 1 — 2026-05-29 s51).
+ *
+ * When set on `call()`, after the primary response is served kgauto re-lowers
+ * the SAME in-memory PromptIR to each candidate and runs it, persisting a
+ * `probe_outcomes` row with `replay_source='inline-full-ir'` and
+ * `prompt_fidelity=1.0` — a fair, full-prompt measurement (vs the watchers'
+ * lossy `prompt_preview` replay). The probe NEVER blocks the user response and
+ * NEVER persists the raw prompt (system/context/payload) — only response
+ * previews + metadata, same policy the brain already holds.
+ *
+ * This is the trustworthy path that earns the right to a quality verdict;
+ * `prompt_preview` replay is retired for verdicts (see CLAUDE.md).
+ *
+ * Phase 1 enforces `sampleRate` and runs the candidate with `judge: 'off'`
+ * (responses stored for an offline batch judge). `judge: 'opus'` (inline
+ * verdict) and `maxPerDay` (per-tuple daily cap, needs a brain-count read)
+ * are accepted by the type but ENFORCED IN PHASE 2.
+ */
+interface ShadowProbeConfig {
+    /** Model id(s) or family alias(es) to shadow-test against the served model, on the same IR. */
+    candidates: string | string[];
+    /** Probability [0,1] that any given call fires a probe. Default 0.05. */
+    sampleRate?: number;
+    /**
+     * 'off' (Phase 1 default): run candidate + store both responses for an
+     * offline batch judge. 'opus': judge candidate-vs-served inline (Phase 2).
+     */
+    judge?: 'opus' | 'off';
+    /** Per-(appId, archetype, candidate) daily cap. Phase 2 (needs brain-count read). Default 20. */
+    maxPerDay?: number;
+}
 interface CallOptions {
     /** Forwarded to compile(). */
     policy?: CompilePolicy;
+    /**
+     * alpha (s51 Phase 1) — full-IR inline shadow-probe. When set, kgauto
+     * measures the candidate(s) on the same IR after serving the primary,
+     * fire-and-forget. See {@link ShadowProbeConfig}.
+     */
+    shadowProbe?: ShadowProbeConfig;
     toolRelevanceThreshold?: number;
     compressHistoryAfter?: number;
     /** Override API keys (defaults: process.env). */
@@ -1253,4 +1291,4 @@ interface PerAxisMetrics {
 /** Per-axis metrics keyed by model — used for chain-comparison views. */
 type PerAxisMetricsByModel = Record<string, PerAxisMetrics>;
 
-export { type ApiKeys as A, type BestPracticeAdvisory as B, type CompilePolicy as C, type FallbackReason as F, type Grounding as G, type HistoryCachePolicy as H, type IntentDeclaration as I, type Message as M, type NormalizedResponse as N, type OutcomeResult as O, type ProviderOverrides as P, type RecordInput as R, type SystemModelMessage as S, type ToolCall as T, type CompiledRequest as a, type PromptIR as b, type CallOptions as c, type CallResult as d, type CompileResult as e, type SectionRewrite as f, type RecordOutcomeInput as g, type OracleScore as h, type Adapter as i, type PerAxisMetrics as j, type Provider as k, type ChainEntry as l, type CallAttempt as m, CallError as n, type ChainModelEntry as o, type ChainWithGrounding as p, type Constraints as q, type MutationApplied as r, type NormalizedTokens as s, type OutcomeKind as t, type PerAxisMetricsByModel as u, type PromptSection as v, type SectionKind as w, type ToolDefinition as x };
+export { type ApiKeys as A, type BestPracticeAdvisory as B, type CompilePolicy as C, type FallbackReason as F, type Grounding as G, type HistoryCachePolicy as H, type IntentDeclaration as I, type Message as M, type NormalizedResponse as N, type OutcomeResult as O, type ProviderOverrides as P, type RecordInput as R, type SystemModelMessage as S, type ToolCall as T, type CompiledRequest as a, type PromptIR as b, type CallOptions as c, type CallResult as d, type CompileResult as e, type SectionRewrite as f, type RecordOutcomeInput as g, type OracleScore as h, type Adapter as i, type PerAxisMetrics as j, type Provider as k, type ChainEntry as l, type CallAttempt as m, CallError as n, type ChainModelEntry as o, type ChainWithGrounding as p, type Constraints as q, type MutationApplied as r, type NormalizedTokens as s, type OutcomeKind as t, type PerAxisMetricsByModel as u, type PromptSection as v, type SectionKind as w, type ShadowProbeConfig as x, type ToolDefinition as y };

package/dist/{ir-DAUBaPhd.d.ts → ir-D3n-pBYI.d.ts}

@@ -799,9 +799,47 @@ interface ProviderOverrides {
     openai?: Record<string, unknown>;
     deepseek?: Record<string, unknown>;
 }
+/**
+ * Full-IR inline shadow-probe config (Shape B, Phase 1 — 2026-05-29 s51).
+ *
+ * When set on `call()`, after the primary response is served kgauto re-lowers
+ * the SAME in-memory PromptIR to each candidate and runs it, persisting a
+ * `probe_outcomes` row with `replay_source='inline-full-ir'` and
+ * `prompt_fidelity=1.0` — a fair, full-prompt measurement (vs the watchers'
+ * lossy `prompt_preview` replay). The probe NEVER blocks the user response and
+ * NEVER persists the raw prompt (system/context/payload) — only response
+ * previews + metadata, same policy the brain already holds.
+ *
+ * This is the trustworthy path that earns the right to a quality verdict;
+ * `prompt_preview` replay is retired for verdicts (see CLAUDE.md).
+ *
+ * Phase 1 enforces `sampleRate` and runs the candidate with `judge: 'off'`
+ * (responses stored for an offline batch judge). `judge: 'opus'` (inline
+ * verdict) and `maxPerDay` (per-tuple daily cap, needs a brain-count read)
+ * are accepted by the type but ENFORCED IN PHASE 2.
+ */
+interface ShadowProbeConfig {
+    /** Model id(s) or family alias(es) to shadow-test against the served model, on the same IR. */
+    candidates: string | string[];
+    /** Probability [0,1] that any given call fires a probe. Default 0.05. */
+    sampleRate?: number;
+    /**
+     * 'off' (Phase 1 default): run candidate + store both responses for an
+     * offline batch judge. 'opus': judge candidate-vs-served inline (Phase 2).
+     */
+    judge?: 'opus' | 'off';
+    /** Per-(appId, archetype, candidate) daily cap. Phase 2 (needs brain-count read). Default 20. */
+    maxPerDay?: number;
+}
 interface CallOptions {
     /** Forwarded to compile(). */
     policy?: CompilePolicy;
+    /**
+     * alpha (s51 Phase 1) — full-IR inline shadow-probe. When set, kgauto
+     * measures the candidate(s) on the same IR after serving the primary,
+     * fire-and-forget. See {@link ShadowProbeConfig}.
+     */
+    shadowProbe?: ShadowProbeConfig;
     toolRelevanceThreshold?: number;
     compressHistoryAfter?: number;
     /** Override API keys (defaults: process.env). */
@@ -1253,4 +1291,4 @@ interface PerAxisMetrics {
 /** Per-axis metrics keyed by model — used for chain-comparison views. */
 type PerAxisMetricsByModel = Record<string, PerAxisMetrics>;
 
-export { type ApiKeys as A, type BestPracticeAdvisory as B, type CompilePolicy as C, type FallbackReason as F, type Grounding as G, type HistoryCachePolicy as H, type IntentDeclaration as I, type Message as M, type NormalizedResponse as N, type OutcomeResult as O, type ProviderOverrides as P, type RecordInput as R, type SystemModelMessage as S, type ToolCall as T, type CompiledRequest as a, type PromptIR as b, type CallOptions as c, type CallResult as d, type CompileResult as e, type SectionRewrite as f, type RecordOutcomeInput as g, type OracleScore as h, type Adapter as i, type PerAxisMetrics as j, type Provider as k, type ChainEntry as l, type CallAttempt as m, CallError as n, type ChainModelEntry as o, type ChainWithGrounding as p, type Constraints as q, type MutationApplied as r, type NormalizedTokens as s, type OutcomeKind as t, type PerAxisMetricsByModel as u, type PromptSection as v, type SectionKind as w, type ToolDefinition as x };
+export { type ApiKeys as A, type BestPracticeAdvisory as B, type CompilePolicy as C, type FallbackReason as F, type Grounding as G, type HistoryCachePolicy as H, type IntentDeclaration as I, type Message as M, type NormalizedResponse as N, type OutcomeResult as O, type ProviderOverrides as P, type RecordInput as R, type SystemModelMessage as S, type ToolCall as T, type CompiledRequest as a, type PromptIR as b, type CallOptions as c, type CallResult as d, type CompileResult as e, type SectionRewrite as f, type RecordOutcomeInput as g, type OracleScore as h, type Adapter as i, type PerAxisMetrics as j, type Provider as k, type ChainEntry as l, type CallAttempt as m, CallError as n, type ChainModelEntry as o, type ChainWithGrounding as p, type Constraints as q, type MutationApplied as r, type NormalizedTokens as s, type OutcomeKind as t, type PerAxisMetricsByModel as u, type PromptSection as v, type SectionKind as w, type ShadowProbeConfig as x, type ToolDefinition as y };

package/dist/profiles.d.mts

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

package/dist/profiles.d.ts

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

package/dist/{types-CfVyRbCl.d.ts → types-B6z-8phQ.d.ts}

@@ -1,4 +1,4 @@
-import { i as Adapter, w as SectionKind } from './ir-DAUBaPhd.js';
+import { i as Adapter, w as SectionKind } from './ir-D3n-pBYI.js';
 
 /**
  * Internal config + hook types for createGlassboxRoutes().

package/dist/{types-BDqNQxuX.d.ts → types-Bzw8tH-7.d.ts}

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

package/dist/{types-B5DzMhYm.d.mts → types-DMJqRzDF.d.mts}

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

package/dist/{types-Rq_fywDq.d.mts → types-xBWYk9Mm.d.mts}

@@ -1,4 +1,4 @@
-import { i as Adapter, w as SectionKind } from './ir-DARjQnvZ.mjs';
+import { i as Adapter, w as SectionKind } from './ir-BBKgsUX7.mjs';
 
 /**
  * Internal config + hook types for createGlassboxRoutes().

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warmdrift/kgauto-compiler",
-  "version": "2.0.0-alpha.44",
+  "version": "2.0.0-alpha.45",
   "description": "Prompt compiler + central learning brain for multi-model AI apps. Swap models without rewriting prompts.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",