@warmdrift/kgauto-compiler 2.0.0-alpha.68 → 2.0.0-alpha.69

package/dist/{chunk-3KQAID63.mjs → chunk-BVEXV5KC.mjs}

@@ -56,6 +56,11 @@ var ALL_ARCHETYPES = Object.keys(INTENT_ARCHETYPES);
 function isArchetype(name) {
   return name in INTENT_ARCHETYPES;
 }
+function resolveOutputMode(args) {
+  if (args.declared) return args.declared;
+  if (args.structuredOutput === true) return "json";
+  return args.toolCount > 0 ? "tool_call" : "text";
+}
 function bucketContext(tokens) {
   if (tokens < 1e3) return "tiny";
   if (tokens < 4e3) return "small";
@@ -92,6 +97,7 @@ export {
   INTENT_ARCHETYPES,
   ALL_ARCHETYPES,
   isArchetype,
+  resolveOutputMode,
   bucketContext,
   bucketToolCount,
   bucketHistory,

package/dist/{chunk-2ZHYFV7G.mjs → chunk-EZXVJUK7.mjs}

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

package/dist/dialect.d.mts

@@ -94,6 +94,32 @@ interface ShapeSignature {
     /** Whether the prompt includes few-shot examples. */
     hasExamples: boolean;
 }
+/**
+ * SINGLE source of truth for a call's output shape.
+ *
+ * Two independent expressions of this concept used to exist — `computeShape`
+ * (three-valued, feeding `compile_outcomes.shape_key`) and compile()'s Factor C
+ * screen (two-valued). They disagreed on exactly one case: tools present with
+ * no `structuredOutput`, which the shape signature calls `tool_call` and the
+ * screen called `text`. That gap let alpha.68's shape-altering discipline gates
+ * fire on tool-call surfaces — the surface class the design contract names as
+ * forbidden, because labelling claims inside a tool-call envelope manufactures
+ * the structured-output violations alpha.66 ships a retry for.
+ *
+ * A consumer `declared` value WINS over inference. The inference cannot see
+ * that an agentic surface carrying tools ultimately emits prose, so it is
+ * deliberately conservative — wrongly firing a shape-altering rule breaks a
+ * parser, wrongly withholding one only forgoes a lift. `constraints.outputMode`
+ * is the escape hatch for surfaces that know better.
+ *
+ * Takes the facts rather than a `PromptIR` so `dialect.ts` stays
+ * dependency-free (`ir.ts` imports THIS module, not the reverse).
+ */
+declare function resolveOutputMode(args: {
+    declared?: OutputMode;
+    structuredOutput?: boolean;
+    toolCount: number;
+}): OutputMode;
 declare function bucketContext(tokens: number): ContextBucket;
 declare function bucketToolCount(count: number): ToolCountBucket;
 declare function bucketHistory(turnCount: number): HistoryDepth;
@@ -108,4 +134,4 @@ declare function hashShape(s: ShapeSignature): string;
  */
 declare function learningKey(archetype: IntentArchetypeName, model: string, shape: ShapeSignature): string;
 
-export { ALL_ARCHETYPES, type ContextBucket, DIALECT_VERSION, type HistoryDepth, INTENT_ARCHETYPES, type IntentArchetypeName, type OutputMode, type ShapeSignature, type ToolCountBucket, bucketContext, bucketHistory, bucketToolCount, hashShape, isArchetype, learningKey };
+export { ALL_ARCHETYPES, type ContextBucket, DIALECT_VERSION, type HistoryDepth, INTENT_ARCHETYPES, type IntentArchetypeName, type OutputMode, type ShapeSignature, type ToolCountBucket, bucketContext, bucketHistory, bucketToolCount, hashShape, isArchetype, learningKey, resolveOutputMode };

package/dist/dialect.d.ts

@@ -94,6 +94,32 @@ interface ShapeSignature {
     /** Whether the prompt includes few-shot examples. */
     hasExamples: boolean;
 }
+/**
+ * SINGLE source of truth for a call's output shape.
+ *
+ * Two independent expressions of this concept used to exist — `computeShape`
+ * (three-valued, feeding `compile_outcomes.shape_key`) and compile()'s Factor C
+ * screen (two-valued). They disagreed on exactly one case: tools present with
+ * no `structuredOutput`, which the shape signature calls `tool_call` and the
+ * screen called `text`. That gap let alpha.68's shape-altering discipline gates
+ * fire on tool-call surfaces — the surface class the design contract names as
+ * forbidden, because labelling claims inside a tool-call envelope manufactures
+ * the structured-output violations alpha.66 ships a retry for.
+ *
+ * A consumer `declared` value WINS over inference. The inference cannot see
+ * that an agentic surface carrying tools ultimately emits prose, so it is
+ * deliberately conservative — wrongly firing a shape-altering rule breaks a
+ * parser, wrongly withholding one only forgoes a lift. `constraints.outputMode`
+ * is the escape hatch for surfaces that know better.
+ *
+ * Takes the facts rather than a `PromptIR` so `dialect.ts` stays
+ * dependency-free (`ir.ts` imports THIS module, not the reverse).
+ */
+declare function resolveOutputMode(args: {
+    declared?: OutputMode;
+    structuredOutput?: boolean;
+    toolCount: number;
+}): OutputMode;
 declare function bucketContext(tokens: number): ContextBucket;
 declare function bucketToolCount(count: number): ToolCountBucket;
 declare function bucketHistory(turnCount: number): HistoryDepth;
@@ -108,4 +134,4 @@ declare function hashShape(s: ShapeSignature): string;
  */
 declare function learningKey(archetype: IntentArchetypeName, model: string, shape: ShapeSignature): string;
 
-export { ALL_ARCHETYPES, type ContextBucket, DIALECT_VERSION, type HistoryDepth, INTENT_ARCHETYPES, type IntentArchetypeName, type OutputMode, type ShapeSignature, type ToolCountBucket, bucketContext, bucketHistory, bucketToolCount, hashShape, isArchetype, learningKey };
+export { ALL_ARCHETYPES, type ContextBucket, DIALECT_VERSION, type HistoryDepth, INTENT_ARCHETYPES, type IntentArchetypeName, type OutputMode, type ShapeSignature, type ToolCountBucket, bucketContext, bucketHistory, bucketToolCount, hashShape, isArchetype, learningKey, resolveOutputMode };

package/dist/dialect.js

@@ -28,7 +28,8 @@ __export(dialect_exports, {
   bucketToolCount: () => bucketToolCount,
   hashShape: () => hashShape,
   isArchetype: () => isArchetype,
-  learningKey: () => learningKey
+  learningKey: () => learningKey,
+  resolveOutputMode: () => resolveOutputMode
 });
 module.exports = __toCommonJS(dialect_exports);
 var DIALECT_VERSION = "v1";
@@ -88,6 +89,11 @@ var ALL_ARCHETYPES = Object.keys(INTENT_ARCHETYPES);
 function isArchetype(name) {
   return name in INTENT_ARCHETYPES;
 }
+function resolveOutputMode(args) {
+  if (args.declared) return args.declared;
+  if (args.structuredOutput === true) return "json";
+  return args.toolCount > 0 ? "tool_call" : "text";
+}
 function bucketContext(tokens) {
   if (tokens < 1e3) return "tiny";
   if (tokens < 4e3) return "small";
@@ -128,5 +134,6 @@ function learningKey(archetype, model, shape) {
   bucketToolCount,
   hashShape,
   isArchetype,
-  learningKey
+  learningKey,
+  resolveOutputMode
 });

package/dist/dialect.mjs

@@ -7,8 +7,9 @@ import {
   bucketToolCount,
   hashShape,
   isArchetype,
-  learningKey
-} from "./chunk-3KQAID63.mjs";
+  learningKey,
+  resolveOutputMode
+} from "./chunk-BVEXV5KC.mjs";
 export {
   ALL_ARCHETYPES,
   DIALECT_VERSION,
@@ -18,5 +19,6 @@ export {
   bucketToolCount,
   hashShape,
   isArchetype,
-  learningKey
+  learningKey,
+  resolveOutputMode
 };

package/dist/glassbox/index.d.mts

@@ -1,6 +1,6 @@
-import { G as GlassboxEvent } from '../types-DWEB5jet.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-DWEB5jet.mjs';
-import '../ir-Ct_YDN7y.mjs';
+import { G as GlassboxEvent } from '../types-DsEq35WY.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-DsEq35WY.mjs';
+import '../ir-Bqn1RVdV.mjs';
 import '../dialect.mjs';
 
 /**

package/dist/glassbox/index.d.ts

@@ -1,6 +1,6 @@
-import { G as GlassboxEvent } from '../types-Bdc3zbrq.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-Bdc3zbrq.js';
-import '../ir-Pv19aEBR.js';
+import { G as GlassboxEvent } from '../types-Bon96eyc.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-Bon96eyc.js';
+import '../ir-Bvlkw5ja.js';
 import '../dialect.js';
 
 /**

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

@@ -1,5 +1,5 @@
-import { T as TraceHealth } from '../types-B3IKyBcW.mjs';
-import '../ir-Ct_YDN7y.mjs';
+import { T as TraceHealth } from '../types-CwGhacGT.mjs';
+import '../ir-Bqn1RVdV.mjs';
 import '../dialect.mjs';
 
 /**

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

@@ -1,5 +1,5 @@
-import { T as TraceHealth } from '../types-DN4kZwXN.js';
-import '../ir-Pv19aEBR.js';
+import { T as TraceHealth } from '../types-DIxRZ3Dj.js';
+import '../ir-Bvlkw5ja.js';
 import '../dialect.js';
 
 /**

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

@@ -1,7 +1,7 @@
-import { G as GlassboxEvent } from '../types-DWEB5jet.mjs';
-import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-B3IKyBcW.mjs';
-export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-B3IKyBcW.mjs';
-import '../ir-Ct_YDN7y.mjs';
+import { G as GlassboxEvent } from '../types-DsEq35WY.mjs';
+import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-CwGhacGT.mjs';
+export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-CwGhacGT.mjs';
+import '../ir-Bqn1RVdV.mjs';
 import '../dialect.mjs';
 
 /**

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

@@ -1,7 +1,7 @@
-import { G as GlassboxEvent } from '../types-Bdc3zbrq.js';
-import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-DN4kZwXN.js';
-export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-DN4kZwXN.js';
-import '../ir-Pv19aEBR.js';
+import { G as GlassboxEvent } from '../types-Bon96eyc.js';
+import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-DIxRZ3Dj.js';
+export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-DIxRZ3Dj.js';
+import '../ir-Bvlkw5ja.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-B3IKyBcW.mjs';
-import '../../ir-Ct_YDN7y.mjs';
+import { a as TraceDetail } from '../../types-CwGhacGT.mjs';
+import '../../ir-Bqn1RVdV.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-DN4kZwXN.js';
-import '../../ir-Pv19aEBR.js';
+import { a as TraceDetail } from '../../types-DIxRZ3Dj.js';
+import '../../ir-Bvlkw5ja.js';
 import '../../dialect.js';
 
 /**

package/dist/index.d.mts

@@ -1,11 +1,11 @@
-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-Ct_YDN7y.mjs';
-export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, E as EffortLevel, F as FallbackReason, r as GoldenCaptureOptions, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, s as MutationApplied, t as NormalizedTokens, u as OutcomeKind, v as PerAxisMetricsByModel, w as PromptSection, x as SectionKind, y as ShadowProbeConfig, T as ToolCall, z as ToolDefinition, D as captureGoldenIr, J as parseGoldenCaptureRate, K as resolveGoldenCaptureRate, L as shouldCaptureGolden } from './ir-Ct_YDN7y.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-Bqn1RVdV.mjs';
+export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, E as EffortLevel, F as FallbackReason, r as GoldenCaptureOptions, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, s as MutationApplied, t as NormalizedTokens, u as OutcomeKind, v as PerAxisMetricsByModel, w as PromptSection, x as SectionKind, y as ShadowProbeConfig, T as ToolCall, z as ToolDefinition, D as captureGoldenIr, J as parseGoldenCaptureRate, K as resolveGoldenCaptureRate, L as shouldCaptureGolden } from './ir-Bqn1RVdV.mjs';
 import { ModelProfile, ArchetypeConvention } from './profiles.mjs';
 export { ALIASES, CacheStrategy, CliffRule, LATENCY_TIER_MS, LatencyTier, LoweringSpec, RecoveryRule, StructuredOutputCapability, SystemPromptMode, allProfiles, getProfile, latencyTierOf, profilesByProvider, tryGetProfile } from './profiles.mjs';
 export { BrainForwardConfig, BrainForwardRoutes, createBrainForwardRoutes } from './brain-proxy.mjs';
 export { KeyHealthConfig, KeyHealthProvider, KeyHealthResponseBody, KeyHealthResult, KeyHealthRoute, createKeyHealthRoute } from './key-health.mjs';
-import { IntentArchetypeName } from './dialect.mjs';
-export { ALL_ARCHETYPES, ContextBucket, DIALECT_VERSION, HistoryDepth, INTENT_ARCHETYPES, OutputMode, ShapeSignature, ToolCountBucket, bucketContext, bucketHistory, bucketToolCount, hashShape, isArchetype, learningKey } from './dialect.mjs';
+import { IntentArchetypeName, OutputMode } from './dialect.mjs';
+export { ALL_ARCHETYPES, ContextBucket, DIALECT_VERSION, HistoryDepth, INTENT_ARCHETYPES, ShapeSignature, ToolCountBucket, bucketContext, bucketHistory, bucketToolCount, hashShape, isArchetype, learningKey } from './dialect.mjs';
 
 /**
  * compile() — the main orchestrator.
@@ -973,7 +973,7 @@ declare function runGoldenEval(opts: GoldenEvalOptions): Promise<GoldenEvalRunRe
  * 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.68";
+declare const LIBRARY_VERSION = "2.0.0-alpha.69";
 
 /**
  * Oracle contract — how an app tells the brain whether a response was good.
@@ -1319,7 +1319,7 @@ interface ApplySectionRewritesArgs {
      * `ir.constraints?.structuredOutput` (true ⇒ 'json', else 'text') so callers
      * / tests need not pass it. compile() passes it explicitly.
      */
-    outputMode?: 'text' | 'json';
+    outputMode?: OutputMode;
 }
 interface ApplySectionRewritesResult {
     /**
@@ -2879,4 +2879,4 @@ declare function _testWaitForPromotionsRefresh(): Promise<void>;
  */
 declare function compile(ir: PromptIR, opts?: CompileOptions): CompileResult;
 
-export { ABSOLUTE_FLOOR, type AISDKConvertedMessage, ARCHETYPE_FAMILY_FITS, ARCHETYPE_FLOOR_DEFAULT, type ActionableAdvisory, Adapter, type AdvisoryResolutionSource, type AdvisorySeverity, type AdvisoryStatus, type AdvisorySuggestedFix, ApiKeys, type AppOracle, type ApplySectionRewritesArgs, type ApplySectionRewritesResult, ArchetypeConvention, type ArchetypeFamilyFit, type ArchetypePerfMap, type ArchetypePerfNMap, type ArchetypePerfScoreResult, type AttachCacheControlResult, BestPracticeAdvisory, type BrainConfig, type BrainDeadLetterEntry, type BrainHealthSnapshot, type BrainQueryConfig, type BrainReadEnv, CallOptions, CallResult, ChainEntry, type CompatibilityIntent, type CompileForAISDKv6Result, type CompileOptions, CompilePolicy, CompileResult, CompiledRequest, DEFAULT_FINDINGS_ENDPOINT, DEFAULT_PROMOTIONS_ENDPOINT, type ExclusionFindingRow, type ExclusionResolutionSource, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type FallbackPosture, FamilyResolutionError, type GetActionableAdvisoriesOptions, type GetApplicablePromotionOpts, type GetDefaultFallbackChainOpts, type GetPerAxisMetricsOpts, type GetRecommendedPrimaryOptions, type GoldenEvalCase, type GoldenEvalOptions, type GoldenEvalRunResult, type GoldenIrRecordInput, Grounding, IntentArchetypeName, JUDGE_RUBRICS, LIBRARY_VERSION, 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, type PromotionRow, type PromotionsRuntime, PromptIR, Provider, ProviderOverrides, type ProviderReachability, RULE_SEQUENTIAL_TOOL_CLIFF, type ReachabilityOpts, RecordInput, RecordOutcomeInput, type RunAdvisorPhase2Context, SectionRewrite, type ShadowProbeRecordInput, type SupportedProvider, SystemModelMessage, TRANSLATOR_FLOOR, _testResetPromotions, _testWaitForPromotionsRefresh, applyArchetypeConvention, applySectionRewrites, attachCacheControlToStreamTextInput, brainHealth, buildGoldenIrRow, buildLLMJudge, buildPairwiseJudgePrompt, buildShadowProbeRow, call, clearBrain, combineOrderSwappedVerdicts, compile, compileForAISDKv6, configureBrain, configurePromotionsBrain, countTokens, deriveFamilyFromModelId, deriveOwnership, execute, findBetterFit, flushBrainDeadLetter, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getApplicablePromotion, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isAutoPromoteEnabledFromEnv, isBrainQueryActiveFor, isBrainSync, isExclusionFindingsBrainActive, isModelReachable, isPromotionsBrainActive, isProviderReachable, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, markAdvisoryResolved, markExclusionFindingHandled, markPromoteReadyHandled, parseJudgeVerdict, peekBrainDeadLetter, probeShadow, profileToRow, readBrainReadEnv, record, recordGoldenIr, recordOutcome, recordShadowProbe, renderIrForJudge, resetTokenizer, resolveConventionsForProfile, resolvePricingAt, resolveProviderKey, rubricFor, runAdvisor, runGoldenEval, 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 BrainDeadLetterEntry, type BrainHealthSnapshot, type BrainQueryConfig, type BrainReadEnv, CallOptions, CallResult, ChainEntry, type CompatibilityIntent, type CompileForAISDKv6Result, type CompileOptions, CompilePolicy, CompileResult, CompiledRequest, DEFAULT_FINDINGS_ENDPOINT, DEFAULT_PROMOTIONS_ENDPOINT, type ExclusionFindingRow, type ExclusionResolutionSource, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type FallbackPosture, FamilyResolutionError, type GetActionableAdvisoriesOptions, type GetApplicablePromotionOpts, type GetDefaultFallbackChainOpts, type GetPerAxisMetricsOpts, type GetRecommendedPrimaryOptions, type GoldenEvalCase, type GoldenEvalOptions, type GoldenEvalRunResult, type GoldenIrRecordInput, Grounding, IntentArchetypeName, JUDGE_RUBRICS, LIBRARY_VERSION, type LLMJudgeOptions, MEASURED_GROUNDING_MIN_N, type MarkAdvisoryResolvedOptions, type MarkExclusionFindingHandledOptions, type MarkPromoteReadyHandledOptions, type ModelBrainRow, type ModelCompatibility, ModelProfile, NormalizedResponse, type OracleContext, OracleScore, type OutcomePayload, OutcomeResult, OutputMode, PRODUCER_OWNED_RULE_CODES, PROVIDER_ENV_KEYS, PerAxisMetrics, type PricingRow, type ProbeShadowOptions, type ProbeShadowServed, type ProfileToRowOptions, type PromoteReadyFindingRow, type PromoteReadyResolution, type PromotionRow, type PromotionsRuntime, PromptIR, Provider, ProviderOverrides, type ProviderReachability, RULE_SEQUENTIAL_TOOL_CLIFF, type ReachabilityOpts, RecordInput, RecordOutcomeInput, type RunAdvisorPhase2Context, SectionRewrite, type ShadowProbeRecordInput, type SupportedProvider, SystemModelMessage, TRANSLATOR_FLOOR, _testResetPromotions, _testWaitForPromotionsRefresh, applyArchetypeConvention, applySectionRewrites, attachCacheControlToStreamTextInput, brainHealth, buildGoldenIrRow, buildLLMJudge, buildPairwiseJudgePrompt, buildShadowProbeRow, call, clearBrain, combineOrderSwappedVerdicts, compile, compileForAISDKv6, configureBrain, configurePromotionsBrain, countTokens, deriveFamilyFromModelId, deriveOwnership, execute, findBetterFit, flushBrainDeadLetter, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getApplicablePromotion, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isAutoPromoteEnabledFromEnv, isBrainQueryActiveFor, isBrainSync, isExclusionFindingsBrainActive, isModelReachable, isPromotionsBrainActive, isProviderReachable, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, markAdvisoryResolved, markExclusionFindingHandled, markPromoteReadyHandled, parseJudgeVerdict, peekBrainDeadLetter, probeShadow, profileToRow, readBrainReadEnv, record, recordGoldenIr, recordOutcome, recordShadowProbe, renderIrForJudge, resetTokenizer, resolveConventionsForProfile, resolvePricingAt, resolveProviderKey, rubricFor, runAdvisor, runGoldenEval, setTokenizer };

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-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-Pv19aEBR.js';
-export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, E as EffortLevel, F as FallbackReason, r as GoldenCaptureOptions, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, s as MutationApplied, t as NormalizedTokens, u as OutcomeKind, v as PerAxisMetricsByModel, w as PromptSection, x as SectionKind, y as ShadowProbeConfig, T as ToolCall, z as ToolDefinition, D as captureGoldenIr, J as parseGoldenCaptureRate, K as resolveGoldenCaptureRate, L as shouldCaptureGolden } from './ir-Pv19aEBR.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-Bvlkw5ja.js';
+export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, E as EffortLevel, F as FallbackReason, r as GoldenCaptureOptions, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, s as MutationApplied, t as NormalizedTokens, u as OutcomeKind, v as PerAxisMetricsByModel, w as PromptSection, x as SectionKind, y as ShadowProbeConfig, T as ToolCall, z as ToolDefinition, D as captureGoldenIr, J as parseGoldenCaptureRate, K as resolveGoldenCaptureRate, L as shouldCaptureGolden } from './ir-Bvlkw5ja.js';
 import { ModelProfile, ArchetypeConvention } from './profiles.js';
 export { ALIASES, CacheStrategy, CliffRule, LATENCY_TIER_MS, LatencyTier, LoweringSpec, RecoveryRule, StructuredOutputCapability, SystemPromptMode, allProfiles, getProfile, latencyTierOf, profilesByProvider, tryGetProfile } from './profiles.js';
 export { BrainForwardConfig, BrainForwardRoutes, createBrainForwardRoutes } from './brain-proxy.js';
 export { KeyHealthConfig, KeyHealthProvider, KeyHealthResponseBody, KeyHealthResult, KeyHealthRoute, createKeyHealthRoute } from './key-health.js';
-import { IntentArchetypeName } from './dialect.js';
-export { ALL_ARCHETYPES, ContextBucket, DIALECT_VERSION, HistoryDepth, INTENT_ARCHETYPES, OutputMode, ShapeSignature, ToolCountBucket, bucketContext, bucketHistory, bucketToolCount, hashShape, isArchetype, learningKey } from './dialect.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.
@@ -973,7 +973,7 @@ declare function runGoldenEval(opts: GoldenEvalOptions): Promise<GoldenEvalRunRe
  * 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.68";
+declare const LIBRARY_VERSION = "2.0.0-alpha.69";
 
 /**
  * Oracle contract — how an app tells the brain whether a response was good.
@@ -1319,7 +1319,7 @@ interface ApplySectionRewritesArgs {
      * `ir.constraints?.structuredOutput` (true ⇒ 'json', else 'text') so callers
      * / tests need not pass it. compile() passes it explicitly.
      */
-    outputMode?: 'text' | 'json';
+    outputMode?: OutputMode;
 }
 interface ApplySectionRewritesResult {
     /**
@@ -2879,4 +2879,4 @@ declare function _testWaitForPromotionsRefresh(): Promise<void>;
  */
 declare function compile(ir: PromptIR, opts?: CompileOptions): CompileResult;
 
-export { ABSOLUTE_FLOOR, type AISDKConvertedMessage, ARCHETYPE_FAMILY_FITS, ARCHETYPE_FLOOR_DEFAULT, type ActionableAdvisory, Adapter, type AdvisoryResolutionSource, type AdvisorySeverity, type AdvisoryStatus, type AdvisorySuggestedFix, ApiKeys, type AppOracle, type ApplySectionRewritesArgs, type ApplySectionRewritesResult, ArchetypeConvention, type ArchetypeFamilyFit, type ArchetypePerfMap, type ArchetypePerfNMap, type ArchetypePerfScoreResult, type AttachCacheControlResult, BestPracticeAdvisory, type BrainConfig, type BrainDeadLetterEntry, type BrainHealthSnapshot, type BrainQueryConfig, type BrainReadEnv, CallOptions, CallResult, ChainEntry, type CompatibilityIntent, type CompileForAISDKv6Result, type CompileOptions, CompilePolicy, CompileResult, CompiledRequest, DEFAULT_FINDINGS_ENDPOINT, DEFAULT_PROMOTIONS_ENDPOINT, type ExclusionFindingRow, type ExclusionResolutionSource, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type FallbackPosture, FamilyResolutionError, type GetActionableAdvisoriesOptions, type GetApplicablePromotionOpts, type GetDefaultFallbackChainOpts, type GetPerAxisMetricsOpts, type GetRecommendedPrimaryOptions, type GoldenEvalCase, type GoldenEvalOptions, type GoldenEvalRunResult, type GoldenIrRecordInput, Grounding, IntentArchetypeName, JUDGE_RUBRICS, LIBRARY_VERSION, 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, type PromotionRow, type PromotionsRuntime, PromptIR, Provider, ProviderOverrides, type ProviderReachability, RULE_SEQUENTIAL_TOOL_CLIFF, type ReachabilityOpts, RecordInput, RecordOutcomeInput, type RunAdvisorPhase2Context, SectionRewrite, type ShadowProbeRecordInput, type SupportedProvider, SystemModelMessage, TRANSLATOR_FLOOR, _testResetPromotions, _testWaitForPromotionsRefresh, applyArchetypeConvention, applySectionRewrites, attachCacheControlToStreamTextInput, brainHealth, buildGoldenIrRow, buildLLMJudge, buildPairwiseJudgePrompt, buildShadowProbeRow, call, clearBrain, combineOrderSwappedVerdicts, compile, compileForAISDKv6, configureBrain, configurePromotionsBrain, countTokens, deriveFamilyFromModelId, deriveOwnership, execute, findBetterFit, flushBrainDeadLetter, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getApplicablePromotion, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isAutoPromoteEnabledFromEnv, isBrainQueryActiveFor, isBrainSync, isExclusionFindingsBrainActive, isModelReachable, isPromotionsBrainActive, isProviderReachable, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, markAdvisoryResolved, markExclusionFindingHandled, markPromoteReadyHandled, parseJudgeVerdict, peekBrainDeadLetter, probeShadow, profileToRow, readBrainReadEnv, record, recordGoldenIr, recordOutcome, recordShadowProbe, renderIrForJudge, resetTokenizer, resolveConventionsForProfile, resolvePricingAt, resolveProviderKey, rubricFor, runAdvisor, runGoldenEval, 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 BrainDeadLetterEntry, type BrainHealthSnapshot, type BrainQueryConfig, type BrainReadEnv, CallOptions, CallResult, ChainEntry, type CompatibilityIntent, type CompileForAISDKv6Result, type CompileOptions, CompilePolicy, CompileResult, CompiledRequest, DEFAULT_FINDINGS_ENDPOINT, DEFAULT_PROMOTIONS_ENDPOINT, type ExclusionFindingRow, type ExclusionResolutionSource, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type FallbackPosture, FamilyResolutionError, type GetActionableAdvisoriesOptions, type GetApplicablePromotionOpts, type GetDefaultFallbackChainOpts, type GetPerAxisMetricsOpts, type GetRecommendedPrimaryOptions, type GoldenEvalCase, type GoldenEvalOptions, type GoldenEvalRunResult, type GoldenIrRecordInput, Grounding, IntentArchetypeName, JUDGE_RUBRICS, LIBRARY_VERSION, type LLMJudgeOptions, MEASURED_GROUNDING_MIN_N, type MarkAdvisoryResolvedOptions, type MarkExclusionFindingHandledOptions, type MarkPromoteReadyHandledOptions, type ModelBrainRow, type ModelCompatibility, ModelProfile, NormalizedResponse, type OracleContext, OracleScore, type OutcomePayload, OutcomeResult, OutputMode, PRODUCER_OWNED_RULE_CODES, PROVIDER_ENV_KEYS, PerAxisMetrics, type PricingRow, type ProbeShadowOptions, type ProbeShadowServed, type ProfileToRowOptions, type PromoteReadyFindingRow, type PromoteReadyResolution, type PromotionRow, type PromotionsRuntime, PromptIR, Provider, ProviderOverrides, type ProviderReachability, RULE_SEQUENTIAL_TOOL_CLIFF, type ReachabilityOpts, RecordInput, RecordOutcomeInput, type RunAdvisorPhase2Context, SectionRewrite, type ShadowProbeRecordInput, type SupportedProvider, SystemModelMessage, TRANSLATOR_FLOOR, _testResetPromotions, _testWaitForPromotionsRefresh, applyArchetypeConvention, applySectionRewrites, attachCacheControlToStreamTextInput, brainHealth, buildGoldenIrRow, buildLLMJudge, buildPairwiseJudgePrompt, buildShadowProbeRow, call, clearBrain, combineOrderSwappedVerdicts, compile, compileForAISDKv6, configureBrain, configurePromotionsBrain, countTokens, deriveFamilyFromModelId, deriveOwnership, execute, findBetterFit, flushBrainDeadLetter, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getApplicablePromotion, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isAutoPromoteEnabledFromEnv, isBrainQueryActiveFor, isBrainSync, isExclusionFindingsBrainActive, isModelReachable, isPromotionsBrainActive, isProviderReachable, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, markAdvisoryResolved, markExclusionFindingHandled, markPromoteReadyHandled, parseJudgeVerdict, peekBrainDeadLetter, probeShadow, profileToRow, readBrainReadEnv, record, recordGoldenIr, recordOutcome, recordShadowProbe, renderIrForJudge, resetTokenizer, resolveConventionsForProfile, resolvePricingAt, resolveProviderKey, rubricFor, runAdvisor, runGoldenEval, setTokenizer };

package/dist/index.js

@@ -2476,6 +2476,11 @@ var ALL_ARCHETYPES = Object.keys(INTENT_ARCHETYPES);
 function isArchetype(name) {
   return name in INTENT_ARCHETYPES;
 }
+function resolveOutputMode(args) {
+  if (args.declared) return args.declared;
+  if (args.structuredOutput === true) return "json";
+  return args.toolCount > 0 ? "tool_call" : "text";
+}
 function bucketContext(tokens) {
   if (tokens < 1e3) return "tiny";
   if (tokens < 4e3) return "small";
@@ -2923,7 +2928,11 @@ function computeShape(ir, estimatedInputTokens) {
     contextBucket: bucketContext(estimatedInputTokens),
     toolCountBucket: bucketToolCount(ir.tools?.length ?? 0),
     historyDepth: bucketHistory(ir.history?.length ?? 0),
-    outputMode: ir.constraints?.structuredOutput ? "json" : ir.tools?.length ? "tool_call" : "text",
+    outputMode: resolveOutputMode({
+      declared: ir.constraints?.outputMode,
+      structuredOutput: ir.constraints?.structuredOutput,
+      toolCount: ir.tools?.length ?? 0
+    }),
     hasExamples: ir.sections.some((s) => /\bexample\b/i.test(s.id))
   };
 }
@@ -4372,7 +4381,11 @@ function applySectionRewrites(args) {
   if (!Array.isArray(ir.sections) || ir.sections.length === 0) {
     return { rewrittenIR: ir, rewrites: [] };
   }
-  const outputMode = args.outputMode ?? (ir.constraints?.structuredOutput === true ? "json" : "text");
+  const outputMode = args.outputMode ?? resolveOutputMode({
+    declared: ir.constraints?.outputMode,
+    structuredOutput: ir.constraints?.structuredOutput,
+    toolCount: ir.tools?.length ?? 0
+  });
   const hasTools = (ir.tools?.length ?? 0) > 0;
   const ctx = { outputMode, hasTools };
   const rewrites = [];
@@ -4583,7 +4596,11 @@ function compile(ir, opts = {}) {
   const conventions = passApplyConventions(workingIR, profile);
   workingIR = conventions.value.ir;
   accumulatedMutations.push(...conventions.mutations);
-  const outputMode = ir.constraints?.structuredOutput === true ? "json" : "text";
+  const outputMode = resolveOutputMode({
+    declared: ir.constraints?.outputMode,
+    structuredOutput: ir.constraints?.structuredOutput,
+    toolCount: ir.tools?.length ?? 0
+  });
   const translated = applySectionRewrites({
     ir: workingIR,
     profile,
@@ -8359,7 +8376,7 @@ function createBrainForwardRoutes(config) {
 }
 
 // src/version.ts
-var LIBRARY_VERSION = "2.0.0-alpha.68";
+var LIBRARY_VERSION = "2.0.0-alpha.69";
 
 // src/key-health.ts
 var JSON_HEADERS2 = { "Content-Type": "application/json" };

package/dist/index.mjs

@@ -10,12 +10,13 @@ import {
   bucketToolCount,
   hashShape,
   isArchetype,
-  learningKey
-} from "./chunk-3KQAID63.mjs";
+  learningKey,
+  resolveOutputMode
+} from "./chunk-BVEXV5KC.mjs";
 import {
   LIBRARY_VERSION,
   createKeyHealthRoute
-} from "./chunk-2ZHYFV7G.mjs";
+} from "./chunk-EZXVJUK7.mjs";
 import {
   ABSOLUTE_FLOOR,
   ARCHETYPE_FLOOR_DEFAULT,
@@ -904,7 +905,11 @@ function computeShape(ir, estimatedInputTokens) {
     contextBucket: bucketContext(estimatedInputTokens),
     toolCountBucket: bucketToolCount(ir.tools?.length ?? 0),
     historyDepth: bucketHistory(ir.history?.length ?? 0),
-    outputMode: ir.constraints?.structuredOutput ? "json" : ir.tools?.length ? "tool_call" : "text",
+    outputMode: resolveOutputMode({
+      declared: ir.constraints?.outputMode,
+      structuredOutput: ir.constraints?.structuredOutput,
+      toolCount: ir.tools?.length ?? 0
+    }),
     hasExamples: ir.sections.some((s) => /\bexample\b/i.test(s.id))
   };
 }
@@ -2353,7 +2358,11 @@ function applySectionRewrites(args) {
   if (!Array.isArray(ir.sections) || ir.sections.length === 0) {
     return { rewrittenIR: ir, rewrites: [] };
   }
-  const outputMode = args.outputMode ?? (ir.constraints?.structuredOutput === true ? "json" : "text");
+  const outputMode = args.outputMode ?? resolveOutputMode({
+    declared: ir.constraints?.outputMode,
+    structuredOutput: ir.constraints?.structuredOutput,
+    toolCount: ir.tools?.length ?? 0
+  });
   const hasTools = (ir.tools?.length ?? 0) > 0;
   const ctx = { outputMode, hasTools };
   const rewrites = [];
@@ -2564,7 +2573,11 @@ function compile(ir, opts = {}) {
   const conventions = passApplyConventions(workingIR, profile);
   workingIR = conventions.value.ir;
   accumulatedMutations.push(...conventions.mutations);
-  const outputMode = ir.constraints?.structuredOutput === true ? "json" : "text";
+  const outputMode = resolveOutputMode({
+    declared: ir.constraints?.outputMode,
+    structuredOutput: ir.constraints?.structuredOutput,
+    toolCount: ir.tools?.length ?? 0
+  });
   const translated = applySectionRewrites({
     ir: workingIR,
     profile,

package/dist/{ir-Pv19aEBR.d.ts → ir-Bqn1RVdV.d.mts}

@@ -1,4 +1,4 @@
-import { IntentArchetypeName } from './dialect.js';
+import { IntentArchetypeName, OutputMode } from './dialect.mjs';
 
 /**
  * Golden-set capture (alpha.62, eval spine — design brief 2026-07-17).
@@ -206,6 +206,21 @@ interface Constraints {
     effort?: EffortLevel;
     /** Caller wants structured (JSON) output. */
     structuredOutput?: boolean;
+    /**
+     * alpha.69 — consumer-declared output shape. Overrides the inference in
+     * `resolveOutputMode` (structuredOutput ⇒ json · tools ⇒ tool_call · else
+     * text), which is deliberately conservative: it cannot see that an agentic
+     * surface carrying tools ultimately emits prose to the user.
+     *
+     * Declaring `'text'` on a tool-carrying surface is what re-opens the
+     * alpha.68 discipline gates for it (Factor C is a hard screen on inferred
+     * `tool_call`, because wrongly firing breaks a parser while wrongly
+     * withholding only forgoes a lift). Declare it truthfully — it is
+     * consumer-reported ground truth about what the model emits, and it feeds
+     * `shape_key`, so a false declaration fragments the learning key AND lets
+     * shape-altering rules fire on a structured surface.
+     */
+    outputMode?: OutputMode;
     /** Hint: caller expects a short response (used to disable thinking on Gemini). */
     expectedShortOutput?: boolean;
     /** Hint: max response words. */

package/dist/{ir-Ct_YDN7y.d.mts → ir-Bvlkw5ja.d.ts}

@@ -1,4 +1,4 @@
-import { IntentArchetypeName } from './dialect.mjs';
+import { IntentArchetypeName, OutputMode } from './dialect.js';
 
 /**
  * Golden-set capture (alpha.62, eval spine — design brief 2026-07-17).
@@ -206,6 +206,21 @@ interface Constraints {
     effort?: EffortLevel;
     /** Caller wants structured (JSON) output. */
     structuredOutput?: boolean;
+    /**
+     * alpha.69 — consumer-declared output shape. Overrides the inference in
+     * `resolveOutputMode` (structuredOutput ⇒ json · tools ⇒ tool_call · else
+     * text), which is deliberately conservative: it cannot see that an agentic
+     * surface carrying tools ultimately emits prose to the user.
+     *
+     * Declaring `'text'` on a tool-carrying surface is what re-opens the
+     * alpha.68 discipline gates for it (Factor C is a hard screen on inferred
+     * `tool_call`, because wrongly firing breaks a parser while wrongly
+     * withholding only forgoes a lift). Declare it truthfully — it is
+     * consumer-reported ground truth about what the model emits, and it feeds
+     * `shape_key`, so a false declaration fragments the learning key AND lets
+     * shape-altering rules fire on a structured surface.
+     */
+    outputMode?: OutputMode;
     /** Hint: caller expects a short response (used to disable thinking on Gemini). */
     expectedShortOutput?: boolean;
     /** Hint: max response words. */

package/dist/key-health.js

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

package/dist/key-health.mjs

@@ -1,6 +1,6 @@
 import {
   createKeyHealthRoute
-} from "./chunk-2ZHYFV7G.mjs";
+} from "./chunk-EZXVJUK7.mjs";
 export {
   createKeyHealthRoute
 };

package/dist/profiles.d.mts

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

package/dist/profiles.d.ts

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

package/dist/{types-Bdc3zbrq.d.ts → types-Bon96eyc.d.ts}

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

package/dist/{types-B3IKyBcW.d.mts → types-CwGhacGT.d.mts}

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

package/dist/{types-DN4kZwXN.d.ts → types-DIxRZ3Dj.d.ts}

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

package/dist/{types-DWEB5jet.d.mts → types-DsEq35WY.d.mts}

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

package/package.json

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