@warmdrift/kgauto-compiler 2.0.0-alpha.51 → 2.0.0-alpha.52

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-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-dDcG8Pvu.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 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-dDcG8Pvu.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-dDcG8Pvu.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';
@@ -250,6 +250,100 @@ interface AttachCacheControlResult {
  */
 declare function attachCacheControlToStreamTextInput(result: CompileResult, convertedMessages: AISDKConvertedMessage[]): AttachCacheControlResult;
 
+/**
+ * alpha.52 — official AI-SDK-v6 compile adapter + compile-then-discard guard.
+ *
+ * Until now each AI-SDK consumer (tt-intel, IC) hand-rolled this adapter in
+ * its own `lib/kgauto-v2/index.ts`: `compile()` → reassemble the system param
+ * per provider → extract kept tool names per provider → re-derive the history
+ * cache-mark index (a copy of the compiler's own `historyCacheMarkIndex`
+ * logic — drift-prone). This centralizes that boilerplate and DRYs the two
+ * near-identical wrappers.
+ *
+ * It also closes the compile-then-discard hole. The discard pattern is:
+ *
+ *     const c = compileForAISDKv6(ir);            // compile runs
+ *     const out = await generateText({            // …but a hand-built prompt
+ *       model: getModel(otherId), prompt });      //    + a DIFFERENT model run
+ *     await record({ handle: c.handle, … });      // brain row attributed to `c`
+ *
+ * The recorded row's `mutations_applied` / `estimated_tokens_in` /
+ * `system_prompt_chars` then describe a compile that never reached the wire.
+ * A library-level runtime guard could NOT catch this while the adapter lived
+ * in consumer code (the consumer wrapper always reads `compile()`'s result to
+ * build its own object, so any getter there is "consumed" every time,
+ * regardless of whether the final caller used the wrapper output). With the
+ * adapter IN the library, the object the FINAL caller reads is library-owned,
+ * so consume-tracking getters on `.system` / `.model` / `.raw` detect non-use
+ * and `record()` warns. See `interfaces/kgauto.md` (## Requested:
+ * `compiled-output-discarded-guard`).
+ *
+ * The guard is OPT-IN-BY-USE: only `compileForAISDKv6` arms tracking, so
+ * `call()` paths and raw `compile()` users never see a false warning.
+ */
+
+interface CompileForAISDKv6Result {
+    /**
+     * Pass to `streamText`/`generateText({ model })` — the caller maps this id
+     * to an AI-SDK `LanguageModel`. Reading this marks the compile "consumed"
+     * (silences the compile-then-discard guard).
+     */
+    readonly model: string;
+    /**
+     * System parameter for `streamText`/`generateText({ system })`. Returns the
+     * structured `SystemModelMessage[]` form when the target is Anthropic AND a
+     * cacheable section exists (preserves the cache_control marker across the
+     * wire); a flat concatenated string otherwise. Reading this marks
+     * "consumed". (Same rule as `attachCacheControlToStreamTextInput`.)
+     */
+    readonly system: string | SystemModelMessage[];
+    /**
+     * The raw kgauto `CompileResult` — for `attachCacheControlToStreamTextInput(raw, msgs)`
+     * and `probeShadow(raw.ir-equivalent, …)` paths. Reading this marks
+     * "consumed" (it means you're using the compile output via the raw result).
+     */
+    readonly raw: CompileResult;
+    /** Tool names that survived budget + relevance — filter your SDK tool map to these. */
+    keptToolNames: Set<string>;
+    /** providerOptions for `streamText` — Anthropic cache_control on the cacheable prefix. Undefined otherwise. */
+    providerOptions?: {
+        anthropic?: {
+            cacheControl?: {
+                type: 'ephemeral';
+            };
+        };
+    };
+    /**
+     * Index (into post-strip history) for the Anthropic history cache marker
+     * (alpha.33). Mirror of `result.diagnostics.historyCacheMarkIndex` — no
+     * consumer re-derivation needed. Undefined when no marker fires.
+     */
+    historyCacheMarkIndex?: number;
+    /** Compile handle — pass to `record()` after the call. */
+    handle: string;
+    /** Mutation ids the compiler fired (informational). */
+    mutationsApplied: string[];
+    /** Best-practice advisories (alpha.6). Empty when none fired. */
+    advisories: BestPracticeAdvisory[];
+    /** Compiler diagnostics + the three commonly-logged top-level fields. */
+    diagnostics: CompileResult['diagnostics'] & {
+        targetProvider: string;
+        estimatedCostUsd: number;
+        fallbackChain: string[];
+    };
+    /** The compiled IR — pass to `probeShadow(ir, …)` in `onFinish` (alpha.48). */
+    ir: PromptIR;
+}
+/**
+ * Compile a `PromptIR` and lower it to an AI-SDK-v6 `streamText`/`generateText`
+ * bundle. Replaces the hand-rolled per-consumer adapter.
+ *
+ * Arms the compile-then-discard guard: read `.system` / `.model` / `.raw` to
+ * serve the call. If you `record()` the handle without reading any of them,
+ * `record()` emits a dev-mode warning that the compile was discarded.
+ */
+declare function compileForAISDKv6(ir: PromptIR, opts?: CompileOptions): CompileForAISDKv6Result;
+
 /**
  * alpha.11 — opt-in nested config for brain-query mode (chains / archetype
  * perf / pricing / models registry). Enabled by default when endpoint is
@@ -304,16 +398,21 @@ interface BrainConfig {
     /** alpha.11 — brain-query mode for config tables. Default-on per table
      *  when endpoint is set; opt-out via `false`. See BrainQueryConfig. */
     brainQuery?: BrainQueryConfig;
+    /**
+     * alpha.52 — emit a dev-mode `console.warn` when a `compileForAISDKv6()`
+     * result is passed to record() but its `.system` / `.model` / `.raw` were
+     * never read (the compile-then-discard pattern: the recorded brain row's
+     * `mutations_applied` / `estimated_tokens_in` / `system_prompt_chars`
+     * describe a compile that did NOT shape the served call). Default: warn
+     * when `NODE_ENV !== 'production'`, silent in production. Set `true` to
+     * force-on (e.g. a prod audit window) or `false` to silence. No-op for
+     * `call()` paths and raw `compile()` users — only `compileForAISDKv6`
+     * arms the tracking, so good actors never see a false warning.
+     */
+    warnOnDiscardedCompile?: boolean;
 }
 declare function configureBrain(config: BrainConfig): void;
 declare function clearBrain(): void;
-/**
- * Record the outcome of a compiled call. Fire-and-forget by default.
- *
- * Returns a Promise so callers in `sync` mode can await; in async mode the
- * promise resolves immediately (after the request is queued) and any
- * network error is swallowed/forwarded to onError.
- */
 declare function record(input: RecordInput): Promise<void>;
 /**
  * Wire shape POSTed by `record()` to the brain proxy's `/outcomes` endpoint.
@@ -2272,4 +2371,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 ProbeShadowOptions, type ProbeShadowServed, 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, probeShadow, profileToRow, readBrainReadEnv, record, recordOutcome, recordShadowProbe, 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 CompileForAISDKv6Result, 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 ProbeShadowOptions, type ProbeShadowServed, 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, compileForAISDKv6, 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, probeShadow, profileToRow, readBrainReadEnv, record, recordOutcome, recordShadowProbe, resetTokenizer, resolveConventionsForProfile, resolvePricingAt, resolveProviderKey, runAdvisor, setTokenizer };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-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-rUUojj0s.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 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-rUUojj0s.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-rUUojj0s.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';
@@ -250,6 +250,100 @@ interface AttachCacheControlResult {
  */
 declare function attachCacheControlToStreamTextInput(result: CompileResult, convertedMessages: AISDKConvertedMessage[]): AttachCacheControlResult;
 
+/**
+ * alpha.52 — official AI-SDK-v6 compile adapter + compile-then-discard guard.
+ *
+ * Until now each AI-SDK consumer (tt-intel, IC) hand-rolled this adapter in
+ * its own `lib/kgauto-v2/index.ts`: `compile()` → reassemble the system param
+ * per provider → extract kept tool names per provider → re-derive the history
+ * cache-mark index (a copy of the compiler's own `historyCacheMarkIndex`
+ * logic — drift-prone). This centralizes that boilerplate and DRYs the two
+ * near-identical wrappers.
+ *
+ * It also closes the compile-then-discard hole. The discard pattern is:
+ *
+ *     const c = compileForAISDKv6(ir);            // compile runs
+ *     const out = await generateText({            // …but a hand-built prompt
+ *       model: getModel(otherId), prompt });      //    + a DIFFERENT model run
+ *     await record({ handle: c.handle, … });      // brain row attributed to `c`
+ *
+ * The recorded row's `mutations_applied` / `estimated_tokens_in` /
+ * `system_prompt_chars` then describe a compile that never reached the wire.
+ * A library-level runtime guard could NOT catch this while the adapter lived
+ * in consumer code (the consumer wrapper always reads `compile()`'s result to
+ * build its own object, so any getter there is "consumed" every time,
+ * regardless of whether the final caller used the wrapper output). With the
+ * adapter IN the library, the object the FINAL caller reads is library-owned,
+ * so consume-tracking getters on `.system` / `.model` / `.raw` detect non-use
+ * and `record()` warns. See `interfaces/kgauto.md` (## Requested:
+ * `compiled-output-discarded-guard`).
+ *
+ * The guard is OPT-IN-BY-USE: only `compileForAISDKv6` arms tracking, so
+ * `call()` paths and raw `compile()` users never see a false warning.
+ */
+
+interface CompileForAISDKv6Result {
+    /**
+     * Pass to `streamText`/`generateText({ model })` — the caller maps this id
+     * to an AI-SDK `LanguageModel`. Reading this marks the compile "consumed"
+     * (silences the compile-then-discard guard).
+     */
+    readonly model: string;
+    /**
+     * System parameter for `streamText`/`generateText({ system })`. Returns the
+     * structured `SystemModelMessage[]` form when the target is Anthropic AND a
+     * cacheable section exists (preserves the cache_control marker across the
+     * wire); a flat concatenated string otherwise. Reading this marks
+     * "consumed". (Same rule as `attachCacheControlToStreamTextInput`.)
+     */
+    readonly system: string | SystemModelMessage[];
+    /**
+     * The raw kgauto `CompileResult` — for `attachCacheControlToStreamTextInput(raw, msgs)`
+     * and `probeShadow(raw.ir-equivalent, …)` paths. Reading this marks
+     * "consumed" (it means you're using the compile output via the raw result).
+     */
+    readonly raw: CompileResult;
+    /** Tool names that survived budget + relevance — filter your SDK tool map to these. */
+    keptToolNames: Set<string>;
+    /** providerOptions for `streamText` — Anthropic cache_control on the cacheable prefix. Undefined otherwise. */
+    providerOptions?: {
+        anthropic?: {
+            cacheControl?: {
+                type: 'ephemeral';
+            };
+        };
+    };
+    /**
+     * Index (into post-strip history) for the Anthropic history cache marker
+     * (alpha.33). Mirror of `result.diagnostics.historyCacheMarkIndex` — no
+     * consumer re-derivation needed. Undefined when no marker fires.
+     */
+    historyCacheMarkIndex?: number;
+    /** Compile handle — pass to `record()` after the call. */
+    handle: string;
+    /** Mutation ids the compiler fired (informational). */
+    mutationsApplied: string[];
+    /** Best-practice advisories (alpha.6). Empty when none fired. */
+    advisories: BestPracticeAdvisory[];
+    /** Compiler diagnostics + the three commonly-logged top-level fields. */
+    diagnostics: CompileResult['diagnostics'] & {
+        targetProvider: string;
+        estimatedCostUsd: number;
+        fallbackChain: string[];
+    };
+    /** The compiled IR — pass to `probeShadow(ir, …)` in `onFinish` (alpha.48). */
+    ir: PromptIR;
+}
+/**
+ * Compile a `PromptIR` and lower it to an AI-SDK-v6 `streamText`/`generateText`
+ * bundle. Replaces the hand-rolled per-consumer adapter.
+ *
+ * Arms the compile-then-discard guard: read `.system` / `.model` / `.raw` to
+ * serve the call. If you `record()` the handle without reading any of them,
+ * `record()` emits a dev-mode warning that the compile was discarded.
+ */
+declare function compileForAISDKv6(ir: PromptIR, opts?: CompileOptions): CompileForAISDKv6Result;
+
 /**
  * alpha.11 — opt-in nested config for brain-query mode (chains / archetype
  * perf / pricing / models registry). Enabled by default when endpoint is
@@ -304,16 +398,21 @@ interface BrainConfig {
     /** alpha.11 — brain-query mode for config tables. Default-on per table
      *  when endpoint is set; opt-out via `false`. See BrainQueryConfig. */
     brainQuery?: BrainQueryConfig;
+    /**
+     * alpha.52 — emit a dev-mode `console.warn` when a `compileForAISDKv6()`
+     * result is passed to record() but its `.system` / `.model` / `.raw` were
+     * never read (the compile-then-discard pattern: the recorded brain row's
+     * `mutations_applied` / `estimated_tokens_in` / `system_prompt_chars`
+     * describe a compile that did NOT shape the served call). Default: warn
+     * when `NODE_ENV !== 'production'`, silent in production. Set `true` to
+     * force-on (e.g. a prod audit window) or `false` to silence. No-op for
+     * `call()` paths and raw `compile()` users — only `compileForAISDKv6`
+     * arms the tracking, so good actors never see a false warning.
+     */
+    warnOnDiscardedCompile?: boolean;
 }
 declare function configureBrain(config: BrainConfig): void;
 declare function clearBrain(): void;
-/**
- * Record the outcome of a compiled call. Fire-and-forget by default.
- *
- * Returns a Promise so callers in `sync` mode can await; in async mode the
- * promise resolves immediately (after the request is queued) and any
- * network error is swallowed/forwarded to onError.
- */
 declare function record(input: RecordInput): Promise<void>;
 /**
  * Wire shape POSTed by `record()` to the brain proxy's `/outcomes` endpoint.
@@ -2272,4 +2371,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 ProbeShadowOptions, type ProbeShadowServed, 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, probeShadow, profileToRow, readBrainReadEnv, record, recordOutcome, recordShadowProbe, 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 CompileForAISDKv6Result, 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 ProbeShadowOptions, type ProbeShadowServed, 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, compileForAISDKv6, 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, probeShadow, profileToRow, readBrainReadEnv, record, recordOutcome, recordShadowProbe, resetTokenizer, resolveConventionsForProfile, resolvePricingAt, resolveProviderKey, runAdvisor, setTokenizer };

package/dist/index.js

@@ -48,6 +48,7 @@ __export(index_exports, {
   call: () => call,
   clearBrain: () => clearBrain,
   compile: () => compile2,
+  compileForAISDKv6: () => compileForAISDKv6,
   configureBrain: () => configureBrain,
   countTokens: () => countTokens,
   deriveFamilyFromModelId: () => deriveFamilyFromModelId,
@@ -4464,9 +4465,37 @@ function estimateSystemPromptChars(sections) {
   }
   return total > 0 ? total : void 0;
 }
+function armCompileConsumeTracking(handle) {
+  const reg = compileRegistry.get(handle);
+  if (!reg) return;
+  reg.consumeTracked = true;
+  reg.systemConsumed = false;
+  reg.modelConsumed = false;
+  reg.rawConsumed = false;
+}
+function markCompileConsumed(handle, field) {
+  const reg = compileRegistry.get(handle);
+  if (!reg || !reg.consumeTracked) return;
+  if (field === "system") reg.systemConsumed = true;
+  else if (field === "model") reg.modelConsumed = true;
+  else reg.rawConsumed = true;
+}
+function maybeWarnDiscardedCompile(reg, handle) {
+  if (!reg.consumeTracked) return;
+  if (reg.systemConsumed || reg.modelConsumed || reg.rawConsumed) return;
+  const isProd = typeof process !== "undefined" && process.env?.NODE_ENV === "production";
+  const enabled = activeConfig?.warnOnDiscardedCompile ?? !isProd;
+  if (!enabled) return;
+  console.warn(
+    `[kgauto] compile-then-discard: compileForAISDKv6() output for handle ${handle} (archetype=${reg.archetype}, model=${reg.model}) was recorded but neither .system, .model, nor .raw was read before record(). The brain row's mutations_applied / estimated_tokens_in / system_prompt_chars describe a compile that did NOT shape the served call. Pass compiled.system + compiled.model into your generateText/streamText (or use call()). Silence via configureBrain({ warnOnDiscardedCompile: false }).`
+  );
+}
 async function record(input) {
   const reg = compileRegistry.get(input.handle);
-  if (reg) compileRegistry.delete(input.handle);
+  if (reg) {
+    maybeWarnDiscardedCompile(reg, input.handle);
+    compileRegistry.delete(input.handle);
+  }
   if (!activeConfig) {
     return;
   }
@@ -6579,6 +6608,71 @@ function attachCacheControlToStreamTextInput(result, convertedMessages) {
   return { system, messages };
 }
 
+// src/compile-aisdk.ts
+function compileForAISDKv6(ir, opts) {
+  const result = compile(ir, opts);
+  registerCompile(ir.appId, ir.intent.archetype, ir, result);
+  armCompileConsumeTracking(result.handle);
+  const systemMessages = result.systemMessages;
+  const hasStructuredSystemCacheControl = result.provider === "anthropic" && systemMessages.some(
+    (m) => m.providerOptions?.anthropic?.cacheControl !== void 0
+  );
+  const systemValue = hasStructuredSystemCacheControl ? systemMessages : systemMessages.map((m) => m.content).join("\n\n");
+  const keptToolNames = extractKeptToolNames(result);
+  const providerOptions = result.provider === "anthropic" && result.diagnostics.cacheableTokens > 0 ? { anthropic: { cacheControl: { type: "ephemeral" } } } : void 0;
+  const handle = result.handle;
+  const diagnostics = {
+    ...result.diagnostics,
+    targetProvider: result.provider,
+    estimatedCostUsd: result.estimatedCostUsd,
+    fallbackChain: result.fallbackChain
+  };
+  return {
+    handle,
+    // Consume-tracking getters: reading any of these flags the compile as
+    // "used", silencing the discard guard at record() time.
+    get model() {
+      markCompileConsumed(handle, "model");
+      return result.target;
+    },
+    get system() {
+      markCompileConsumed(handle, "system");
+      return systemValue;
+    },
+    get raw() {
+      markCompileConsumed(handle, "raw");
+      return result;
+    },
+    keptToolNames,
+    ...providerOptions ? { providerOptions } : {},
+    ...result.diagnostics.historyCacheMarkIndex !== void 0 ? { historyCacheMarkIndex: result.diagnostics.historyCacheMarkIndex } : {},
+    mutationsApplied: result.mutationsApplied.map((m) => m.id),
+    advisories: result.advisories ?? [],
+    diagnostics,
+    ir
+  };
+}
+function extractKeptToolNames(result) {
+  const names = /* @__PURE__ */ new Set();
+  const tools = result.request.tools;
+  if (!Array.isArray(tools)) return names;
+  if (result.provider === "google") {
+    for (const td of tools) {
+      for (const fn of td.functionDeclarations ?? []) if (fn.name) names.add(fn.name);
+    }
+  } else if (result.provider === "openai") {
+    for (const t of tools) {
+      const n = t.function?.name;
+      if (n) names.add(n);
+    }
+  } else {
+    for (const t of tools) {
+      if (t.name) names.add(t.name);
+    }
+  }
+  return names;
+}
+
 // src/oracle.ts
 var DEFAULT_DIMENSIONS = ["correctness", "completeness", "conciseness", "format"];
 var judgeCallTimes = [];
@@ -7035,6 +7129,7 @@ function compile2(ir, opts) {
   call,
   clearBrain,
   compile,
+  compileForAISDKv6,
   configureBrain,
   countTokens,
   deriveFamilyFromModelId,

package/dist/index.mjs

@@ -2676,9 +2676,37 @@ function estimateSystemPromptChars(sections) {
   }
   return total > 0 ? total : void 0;
 }
+function armCompileConsumeTracking(handle) {
+  const reg = compileRegistry.get(handle);
+  if (!reg) return;
+  reg.consumeTracked = true;
+  reg.systemConsumed = false;
+  reg.modelConsumed = false;
+  reg.rawConsumed = false;
+}
+function markCompileConsumed(handle, field) {
+  const reg = compileRegistry.get(handle);
+  if (!reg || !reg.consumeTracked) return;
+  if (field === "system") reg.systemConsumed = true;
+  else if (field === "model") reg.modelConsumed = true;
+  else reg.rawConsumed = true;
+}
+function maybeWarnDiscardedCompile(reg, handle) {
+  if (!reg.consumeTracked) return;
+  if (reg.systemConsumed || reg.modelConsumed || reg.rawConsumed) return;
+  const isProd = typeof process !== "undefined" && process.env?.NODE_ENV === "production";
+  const enabled = activeConfig?.warnOnDiscardedCompile ?? !isProd;
+  if (!enabled) return;
+  console.warn(
+    `[kgauto] compile-then-discard: compileForAISDKv6() output for handle ${handle} (archetype=${reg.archetype}, model=${reg.model}) was recorded but neither .system, .model, nor .raw was read before record(). The brain row's mutations_applied / estimated_tokens_in / system_prompt_chars describe a compile that did NOT shape the served call. Pass compiled.system + compiled.model into your generateText/streamText (or use call()). Silence via configureBrain({ warnOnDiscardedCompile: false }).`
+  );
+}
 async function record(input) {
   const reg = compileRegistry.get(input.handle);
-  if (reg) compileRegistry.delete(input.handle);
+  if (reg) {
+    maybeWarnDiscardedCompile(reg, input.handle);
+    compileRegistry.delete(input.handle);
+  }
   if (!activeConfig) {
     return;
   }
@@ -4076,6 +4104,71 @@ function attachCacheControlToStreamTextInput(result, convertedMessages) {
   return { system, messages };
 }
 
+// src/compile-aisdk.ts
+function compileForAISDKv6(ir, opts) {
+  const result = compile(ir, opts);
+  registerCompile(ir.appId, ir.intent.archetype, ir, result);
+  armCompileConsumeTracking(result.handle);
+  const systemMessages = result.systemMessages;
+  const hasStructuredSystemCacheControl = result.provider === "anthropic" && systemMessages.some(
+    (m) => m.providerOptions?.anthropic?.cacheControl !== void 0
+  );
+  const systemValue = hasStructuredSystemCacheControl ? systemMessages : systemMessages.map((m) => m.content).join("\n\n");
+  const keptToolNames = extractKeptToolNames(result);
+  const providerOptions = result.provider === "anthropic" && result.diagnostics.cacheableTokens > 0 ? { anthropic: { cacheControl: { type: "ephemeral" } } } : void 0;
+  const handle = result.handle;
+  const diagnostics = {
+    ...result.diagnostics,
+    targetProvider: result.provider,
+    estimatedCostUsd: result.estimatedCostUsd,
+    fallbackChain: result.fallbackChain
+  };
+  return {
+    handle,
+    // Consume-tracking getters: reading any of these flags the compile as
+    // "used", silencing the discard guard at record() time.
+    get model() {
+      markCompileConsumed(handle, "model");
+      return result.target;
+    },
+    get system() {
+      markCompileConsumed(handle, "system");
+      return systemValue;
+    },
+    get raw() {
+      markCompileConsumed(handle, "raw");
+      return result;
+    },
+    keptToolNames,
+    ...providerOptions ? { providerOptions } : {},
+    ...result.diagnostics.historyCacheMarkIndex !== void 0 ? { historyCacheMarkIndex: result.diagnostics.historyCacheMarkIndex } : {},
+    mutationsApplied: result.mutationsApplied.map((m) => m.id),
+    advisories: result.advisories ?? [],
+    diagnostics,
+    ir
+  };
+}
+function extractKeptToolNames(result) {
+  const names = /* @__PURE__ */ new Set();
+  const tools = result.request.tools;
+  if (!Array.isArray(tools)) return names;
+  if (result.provider === "google") {
+    for (const td of tools) {
+      for (const fn of td.functionDeclarations ?? []) if (fn.name) names.add(fn.name);
+    }
+  } else if (result.provider === "openai") {
+    for (const t of tools) {
+      const n = t.function?.name;
+      if (n) names.add(n);
+    }
+  } else {
+    for (const t of tools) {
+      if (t.name) names.add(t.name);
+    }
+  }
+  return names;
+}
+
 // src/oracle.ts
 var DEFAULT_DIMENSIONS = ["correctness", "completeness", "conciseness", "format"];
 var judgeCallTimes = [];
@@ -4531,6 +4624,7 @@ export {
   call,
   clearBrain,
   compile2 as compile,
+  compileForAISDKv6,
   configureBrain,
   countTokens,
   deriveFamilyFromModelId,

package/package.json

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