@warmdrift/kgauto-compiler 2.0.0-alpha.67 → 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-DTFQIURE.mjs → chunk-EZXVJUK7.mjs}

@@ -1,5 +1,5 @@
 // src/version.ts
-var LIBRARY_VERSION = "2.0.0-alpha.67";
+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-8pWRDbUg.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-8pWRDbUg.mjs';
-import '../ir-BTvyl8-w.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-BdYlJz0Z.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-BdYlJz0Z.js';
-import '../ir-Qnw6L265.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-Cya0jPAF.mjs';
-import '../ir-BTvyl8-w.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-DxYXuFxj.js';
-import '../ir-Qnw6L265.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-8pWRDbUg.mjs';
-import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-Cya0jPAF.mjs';
-export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-Cya0jPAF.mjs';
-import '../ir-BTvyl8-w.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-BdYlJz0Z.js';
-import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-DxYXuFxj.js';
-export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-DxYXuFxj.js';
-import '../ir-Qnw6L265.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/index.js

@@ -2228,6 +2228,7 @@ var SECTION_KINDS = /* @__PURE__ */ new Set([
   "role_intro",
   "tool_call_contract",
   "narration_contract",
+  "discipline_contract",
   "user_turn",
   "reference",
   "arbitrary"
@@ -2242,6 +2243,9 @@ function summarizeSectionRewrite(kind, rule) {
   if (kind === "narration_contract" && rule === "narration-thinking-leak-deepseek") {
     return "Thinking-block suppression applied (DeepSeek V4 internal reasoning kept off-wire).";
   }
+  if (kind === "discipline_contract" && rule === "discipline-gates-v1") {
+    return "Discipline gates applied (surface-scaffolding: evidence-before-reasoning, one-extra-signal, source-labeling).";
+  }
   return `Translator applied rule "${rule}" to ${kind} section.`;
 }
 function rowToSectionRewrite(raw) {

package/dist/glassbox-routes/index.mjs

@@ -287,6 +287,7 @@ var SECTION_KINDS = /* @__PURE__ */ new Set([
   "role_intro",
   "tool_call_contract",
   "narration_contract",
+  "discipline_contract",
   "user_turn",
   "reference",
   "arbitrary"
@@ -301,6 +302,9 @@ function summarizeSectionRewrite(kind, rule) {
   if (kind === "narration_contract" && rule === "narration-thinking-leak-deepseek") {
     return "Thinking-block suppression applied (DeepSeek V4 internal reasoning kept off-wire).";
   }
+  if (kind === "discipline_contract" && rule === "discipline-gates-v1") {
+    return "Discipline gates applied (surface-scaffolding: evidence-before-reasoning, one-extra-signal, source-labeling).";
+  }
   return `Translator applied rule "${rule}" to ${kind} section.`;
 }
 function rowToSectionRewrite(raw) {

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-Cya0jPAF.mjs';
-import '../../ir-BTvyl8-w.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-DxYXuFxj.js';
-import '../../ir-Qnw6L265.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-BTvyl8-w.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-BTvyl8-w.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.
@@ -38,6 +38,15 @@ interface CompileOptions {
      * ceiling, boosts preferred. See CompilePolicy in ir.ts.
      */
     policy?: CompilePolicy;
+    /**
+     * alpha.68 / Release A (delegation-fanout-accelerator §5.0, R0 linkage) —
+     * transport for the fan-out parent handle. Threaded from
+     * `CallOptions.parentHandle` on the call() path (and settable directly on the
+     * public compile() path). Release A does NOT route on it — it only labels the
+     * outcome row (fanout_role / trace_id / parent_handle) at record-registration
+     * time. `registerCompile` reads it to derive the linkage. Absent ⇒ root call.
+     */
+    parentHandle?: string;
 }
 
 /**
@@ -623,6 +632,28 @@ interface OutcomePayload {
      * downstream outcome quality lifted by M points").
      */
     section_rewrites_applied?: SectionRewrite[] | null;
+    /**
+     * R0 linkage (§5.0). Parent call's handle when this row is a fan-out branch;
+     * key OMITTED (undefined → dropped by JSON.stringify → stored NULL) for a
+     * root, safe against pre-042 brains.
+     */
+    parent_handle?: string;
+    /**
+     * R0 linkage (§5.0). Root handle of the fan-out trace (= parent_handle when a
+     * branch, else this row's own handle). Emitted for every registered compile.
+     */
+    trace_id?: string;
+    /**
+     * R0 linkage (§5.0). root | branch | composer. Emitted for every registered
+     * compile; surface baselines filter to root/NULL so branch traffic never
+     * contaminates a promotion/eval baseline. Release A emits only root/branch.
+     */
+    fanout_role?: 'root' | 'branch' | 'composer';
+    /**
+     * RD discipline gate-token accounting (§5.D). Measured token tax of the
+     * discipline_contract gate block; 0 when the gate didn't fire.
+     */
+    discipline_gate_tokens?: number;
 }
 /**
  * alpha.20 Entry 4: record a quality outcome for a previously-compiled call.
@@ -942,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.67";
+declare const LIBRARY_VERSION = "2.0.0-alpha.69";
 
 /**
  * Oracle contract — how an app tells the brain whether a response was good.
@@ -1280,6 +1311,15 @@ interface ApplySectionRewritesArgs {
     ir: PromptIR;
     profile: ModelProfile;
     archetype: IntentArchetypeName;
+    /**
+     * alpha.68 / Release A — resolved output shape for Factor C (§5.D). `'json'`
+     * ⇒ structured surface (the discipline gate MUST NOT fire — gates 5+6 are
+     * shape-altering and would break the consumer's parser). `'text'` ⇒ free-form
+     * surface (the gate may fire). Optional: when omitted, derived from
+     * `ir.constraints?.structuredOutput` (true ⇒ 'json', else 'text') so callers
+     * / tests need not pass it. compile() passes it explicitly.
+     */
+    outputMode?: OutputMode;
 }
 interface ApplySectionRewritesResult {
     /**
@@ -2839,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-Qnw6L265.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-Qnw6L265.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.
@@ -38,6 +38,15 @@ interface CompileOptions {
      * ceiling, boosts preferred. See CompilePolicy in ir.ts.
      */
     policy?: CompilePolicy;
+    /**
+     * alpha.68 / Release A (delegation-fanout-accelerator §5.0, R0 linkage) —
+     * transport for the fan-out parent handle. Threaded from
+     * `CallOptions.parentHandle` on the call() path (and settable directly on the
+     * public compile() path). Release A does NOT route on it — it only labels the
+     * outcome row (fanout_role / trace_id / parent_handle) at record-registration
+     * time. `registerCompile` reads it to derive the linkage. Absent ⇒ root call.
+     */
+    parentHandle?: string;
 }
 
 /**
@@ -623,6 +632,28 @@ interface OutcomePayload {
      * downstream outcome quality lifted by M points").
      */
     section_rewrites_applied?: SectionRewrite[] | null;
+    /**
+     * R0 linkage (§5.0). Parent call's handle when this row is a fan-out branch;
+     * key OMITTED (undefined → dropped by JSON.stringify → stored NULL) for a
+     * root, safe against pre-042 brains.
+     */
+    parent_handle?: string;
+    /**
+     * R0 linkage (§5.0). Root handle of the fan-out trace (= parent_handle when a
+     * branch, else this row's own handle). Emitted for every registered compile.
+     */
+    trace_id?: string;
+    /**
+     * R0 linkage (§5.0). root | branch | composer. Emitted for every registered
+     * compile; surface baselines filter to root/NULL so branch traffic never
+     * contaminates a promotion/eval baseline. Release A emits only root/branch.
+     */
+    fanout_role?: 'root' | 'branch' | 'composer';
+    /**
+     * RD discipline gate-token accounting (§5.D). Measured token tax of the
+     * discipline_contract gate block; 0 when the gate didn't fire.
+     */
+    discipline_gate_tokens?: number;
 }
 /**
  * alpha.20 Entry 4: record a quality outcome for a previously-compiled call.
@@ -942,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.67";
+declare const LIBRARY_VERSION = "2.0.0-alpha.69";
 
 /**
  * Oracle contract — how an app tells the brain whether a response was good.
@@ -1280,6 +1311,15 @@ interface ApplySectionRewritesArgs {
     ir: PromptIR;
     profile: ModelProfile;
     archetype: IntentArchetypeName;
+    /**
+     * alpha.68 / Release A — resolved output shape for Factor C (§5.D). `'json'`
+     * ⇒ structured surface (the discipline gate MUST NOT fire — gates 5+6 are
+     * shape-altering and would break the consumer's parser). `'text'` ⇒ free-form
+     * surface (the gate may fire). Optional: when omitted, derived from
+     * `ir.constraints?.structuredOutput` (true ⇒ 'json', else 'text') so callers
+     * / tests need not pass it. compile() passes it explicitly.
+     */
+    outputMode?: OutputMode;
 }
 interface ApplySectionRewritesResult {
     /**
@@ -2839,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))
   };
 }
@@ -4308,7 +4317,36 @@ var RULE_NARRATION_THINKING_LEAK_DEEPSEEK = "narration-thinking-leak-deepseek";
 var SEQUENTIAL_TOOL_PREAMBLE = "IMPORTANT: Use one tool call per response. Wait for the tool result before deciding the next tool. Do NOT batch tool calls in parallel.";
 var NARRATION_DRIFT_ANTHROPIC_PREAMBLE = "Output ONLY the requested content. Do not narrate your thought process. Each line \u2264 12 words.";
 var NARRATION_THINKING_LEAK_DEEPSEEK_PREAMBLE = "Reasoning is internal. Output ONLY the requested content; do not emit <thinking> blocks or internal monologue as user-facing text.";
-function matchRule(kind, profile, archetype) {
+var RULE_DISCIPLINE_GATES_V1 = "discipline-gates-v1";
+var DISCIPLINE_GATES_V1_WITH_TOOLS = `Work through these gates at every judgment point, explicitly:
+1. Evidence before reasoning: cite what you observed before concluding from it.
+2. One extra signal: when a finding feels conclusive, check one more adjacent signal before stating it.
+3. Expand, don't guess: resolve a compressed or referenced item by looking it up rather than inferring its contents.
+4. Innocent explanation first: state the most plausible benign reading before alleging the alarming one.
+5. Label each claim: mark it observed, inferred, or assumed.
+6. A surfaced gap beats a guessed answer: flag what you cannot determine rather than fabricating past it.`;
+var DISCIPLINE_GATES_V1_NO_TOOLS = `Work through these gates at every judgment point, explicitly:
+1. Evidence before reasoning: cite what you observed before concluding from it.
+2. One extra signal: when a finding feels conclusive, check one more adjacent signal before stating it.
+3. Innocent explanation first: state the most plausible benign reading before alleging the alarming one.
+4. Label each claim: mark it observed, inferred, or assumed.
+5. A surfaced gap beats a guessed answer: flag what you cannot determine rather than fabricating past it.`;
+var DISCIPLINE_ELIGIBLE_ARCHETYPES = /* @__PURE__ */ new Set([
+  "hunt",
+  "summarize",
+  "plan",
+  "critique",
+  "judge"
+]);
+function matchRule(kind, profile, archetype, ctx) {
+  if (kind === "discipline_contract") {
+    if (!DISCIPLINE_ELIGIBLE_ARCHETYPES.has(archetype)) return null;
+    if (ctx.outputMode !== "text") return null;
+    return {
+      id: RULE_DISCIPLINE_GATES_V1,
+      preamble: ctx.hasTools ? DISCIPLINE_GATES_V1_WITH_TOOLS : DISCIPLINE_GATES_V1_NO_TOOLS
+    };
+  }
   if (kind === "tool_call_contract") {
     if (!profile.archetypePerf) return null;
     const archetypeScore = profile.archetypePerf[archetype];
@@ -4343,10 +4381,17 @@ function applySectionRewrites(args) {
   if (!Array.isArray(ir.sections) || ir.sections.length === 0) {
     return { rewrittenIR: ir, rewrites: [] };
   }
+  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 = [];
   const newSections = ir.sections.map((section) => {
     if (!section.kind || section.kind === "arbitrary") return section;
-    const rule = matchRule(section.kind, profile, archetype);
+    const rule = matchRule(section.kind, profile, archetype, ctx);
     if (!rule) return section;
     const originalText = section.text;
     const transformedText = `${rule.preamble}
@@ -4551,13 +4596,28 @@ function compile(ir, opts = {}) {
   const conventions = passApplyConventions(workingIR, profile);
   workingIR = conventions.value.ir;
   accumulatedMutations.push(...conventions.mutations);
+  const outputMode = resolveOutputMode({
+    declared: ir.constraints?.outputMode,
+    structuredOutput: ir.constraints?.structuredOutput,
+    toolCount: ir.tools?.length ?? 0
+  });
   const translated = applySectionRewrites({
     ir: workingIR,
     profile,
-    archetype: ir.intent.archetype
+    archetype: ir.intent.archetype,
+    outputMode
   });
   workingIR = translated.rewrittenIR;
   const sectionRewritesApplied = translated.rewrites;
+  const disciplineRewrite = sectionRewritesApplied.find(
+    (rw) => rw.kind === "discipline_contract"
+  );
+  const disciplineGateTokens = disciplineRewrite ? countTokens(
+    disciplineRewrite.transformedText.slice(
+      0,
+      disciplineRewrite.transformedText.length - disciplineRewrite.originalText.length
+    )
+  ) : 0;
   let wireOverrides;
   for (const rw of sectionRewritesApplied) {
     if (!rw.wireOverrides) continue;
@@ -4610,7 +4670,10 @@ function compile(ir, opts = {}) {
     cliffWarnings: [
       ...cliffs.value.loweringHints.qualityWarning ?? [],
       ...conventions.value.cliffWarnings
-    ]
+    ],
+    // alpha.68 / Release A — measured discipline gate-token tax (§5.D). 0 when
+    // the gate didn't fire.
+    disciplineGateTokens
   };
   if (ir.intent.archetype === "hunt" && ir.constraints?.toolOrchestration === "sequential") {
     accumulatedMutations.push({
@@ -5014,7 +5077,7 @@ async function flushBrainDeadLetter() {
 }
 var compileRegistry = /* @__PURE__ */ new Map();
 var REGISTRY_MAX_ENTRIES = 1e4;
-function registerCompile(appId, archetype, ir, result) {
+function registerCompile(appId, archetype, ir, result, parentHandle) {
   if (compileRegistry.size >= REGISTRY_MAX_ENTRIES) {
     const cutoff = Math.floor(REGISTRY_MAX_ENTRIES * 0.25);
     let evicted = 0;
@@ -5066,7 +5129,15 @@ function registerCompile(appId, archetype, ir, result) {
     // outcome quality lifted to M."
     sectionRewritesApplied: result.sectionRewritesApplied,
     // alpha.57: cache the declared effort tier for record()'s auto-enrich.
-    effortFromCompile: ir.constraints?.effort
+    effortFromCompile: ir.constraints?.effort,
+    // alpha.68 / Release A (§5.0, R0 linkage) — derive + cache the fan-out
+    // linkage. Release A is 1-level: a branch's trace_id is its parent handle
+    // (the root); deeper trees await the delegate primitive (Release D).
+    parentHandle,
+    traceId: parentHandle ?? result.handle,
+    fanoutRole: parentHandle ? "branch" : "root",
+    // alpha.68 / Release A (§5.D) — measured gate-token tax from diagnostics.
+    disciplineGateTokens: result.diagnostics.disciplineGateTokens
   });
 }
 function estimateSystemPromptChars(sections) {
@@ -5257,7 +5328,17 @@ function buildPayload(input, reg) {
     // alpha.29 — translator activity (migration 019). Send NULL when no
     // rewrites fired so the brain's "did the translator do anything?"
     // queries can use `IS NOT NULL` cleanly.
-    section_rewrites_applied: reg?.sectionRewritesApplied && reg.sectionRewritesApplied.length > 0 ? reg.sectionRewritesApplied : null
+    section_rewrites_applied: reg?.sectionRewritesApplied && reg.sectionRewritesApplied.length > 0 ? reg.sectionRewritesApplied : null,
+    // alpha.68 / Release A (§5.0 + §5.D, migration 042) — auto-enrich the
+    // fan-out linkage + discipline gate tax from the registered compile.
+    // Omit-when-undefined (JSON.stringify drops undefined keys), same posture as
+    // `effort` / `retried_same_model` → safe against pre-042 brains. A registered
+    // compile always carries trace_id + fanout_role + discipline_gate_tokens
+    // (root/0 for ordinary traffic); parent_handle is present only for branches.
+    parent_handle: reg?.parentHandle,
+    trace_id: reg?.traceId,
+    fanout_role: reg?.fanoutRole,
+    discipline_gate_tokens: reg?.disciplineGateTokens
   };
 }
 function computeCostUsd(modelId, tokensIn, tokensOut) {
@@ -7187,9 +7268,11 @@ function compileAndRegister(ir, opts) {
   const result = compile(ir, {
     policy: opts.policy,
     toolRelevanceThreshold: opts.toolRelevanceThreshold,
-    compressHistoryAfter: opts.compressHistoryAfter
+    compressHistoryAfter: opts.compressHistoryAfter,
+    // alpha.68 / Release A — carry the fan-out parent handle through to compile.
+    parentHandle: opts.parentHandle
   });
-  registerCompile(ir.appId, ir.intent.archetype, ir, result);
+  registerCompile(ir.appId, ir.intent.archetype, ir, result, opts.parentHandle);
   return result;
 }
 function extractPromptPreview(ir) {
@@ -7540,7 +7623,7 @@ function attachCacheControlToStreamTextInput(result, convertedMessages) {
 // src/compile-aisdk.ts
 function compileForAISDKv6(ir, opts) {
   const result = compile(ir, opts);
-  registerCompile(ir.appId, ir.intent.archetype, ir, result);
+  registerCompile(ir.appId, ir.intent.archetype, ir, result, opts?.parentHandle);
   armCompileConsumeTracking(result.handle);
   const systemMessages = result.systemMessages;
   const hasStructuredSystemCacheControl = result.provider === "anthropic" && systemMessages.some(
@@ -8293,7 +8376,7 @@ function createBrainForwardRoutes(config) {
 }
 
 // src/version.ts
-var LIBRARY_VERSION = "2.0.0-alpha.67";
+var LIBRARY_VERSION = "2.0.0-alpha.69";
 
 // src/key-health.ts
 var JSON_HEADERS2 = { "Content-Type": "application/json" };
@@ -8914,7 +8997,7 @@ async function markExclusionFindingHandled(opts) {
 // src/index.ts
 function compile2(ir, opts) {
   const result = compile(ir, opts);
-  registerCompile(ir.appId, ir.intent.archetype, ir, result);
+  registerCompile(ir.appId, ir.intent.archetype, ir, result, opts?.parentHandle);
   return result;
 }
 // Annotate the CommonJS export names for ESM import in node:

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-DTFQIURE.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))
   };
 }
@@ -2289,7 +2294,36 @@ var RULE_NARRATION_THINKING_LEAK_DEEPSEEK = "narration-thinking-leak-deepseek";
 var SEQUENTIAL_TOOL_PREAMBLE = "IMPORTANT: Use one tool call per response. Wait for the tool result before deciding the next tool. Do NOT batch tool calls in parallel.";
 var NARRATION_DRIFT_ANTHROPIC_PREAMBLE = "Output ONLY the requested content. Do not narrate your thought process. Each line \u2264 12 words.";
 var NARRATION_THINKING_LEAK_DEEPSEEK_PREAMBLE = "Reasoning is internal. Output ONLY the requested content; do not emit <thinking> blocks or internal monologue as user-facing text.";
-function matchRule(kind, profile, archetype) {
+var RULE_DISCIPLINE_GATES_V1 = "discipline-gates-v1";
+var DISCIPLINE_GATES_V1_WITH_TOOLS = `Work through these gates at every judgment point, explicitly:
+1. Evidence before reasoning: cite what you observed before concluding from it.
+2. One extra signal: when a finding feels conclusive, check one more adjacent signal before stating it.
+3. Expand, don't guess: resolve a compressed or referenced item by looking it up rather than inferring its contents.
+4. Innocent explanation first: state the most plausible benign reading before alleging the alarming one.
+5. Label each claim: mark it observed, inferred, or assumed.
+6. A surfaced gap beats a guessed answer: flag what you cannot determine rather than fabricating past it.`;
+var DISCIPLINE_GATES_V1_NO_TOOLS = `Work through these gates at every judgment point, explicitly:
+1. Evidence before reasoning: cite what you observed before concluding from it.
+2. One extra signal: when a finding feels conclusive, check one more adjacent signal before stating it.
+3. Innocent explanation first: state the most plausible benign reading before alleging the alarming one.
+4. Label each claim: mark it observed, inferred, or assumed.
+5. A surfaced gap beats a guessed answer: flag what you cannot determine rather than fabricating past it.`;
+var DISCIPLINE_ELIGIBLE_ARCHETYPES = /* @__PURE__ */ new Set([
+  "hunt",
+  "summarize",
+  "plan",
+  "critique",
+  "judge"
+]);
+function matchRule(kind, profile, archetype, ctx) {
+  if (kind === "discipline_contract") {
+    if (!DISCIPLINE_ELIGIBLE_ARCHETYPES.has(archetype)) return null;
+    if (ctx.outputMode !== "text") return null;
+    return {
+      id: RULE_DISCIPLINE_GATES_V1,
+      preamble: ctx.hasTools ? DISCIPLINE_GATES_V1_WITH_TOOLS : DISCIPLINE_GATES_V1_NO_TOOLS
+    };
+  }
   if (kind === "tool_call_contract") {
     if (!profile.archetypePerf) return null;
     const archetypeScore = profile.archetypePerf[archetype];
@@ -2324,10 +2358,17 @@ function applySectionRewrites(args) {
   if (!Array.isArray(ir.sections) || ir.sections.length === 0) {
     return { rewrittenIR: ir, rewrites: [] };
   }
+  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 = [];
   const newSections = ir.sections.map((section) => {
     if (!section.kind || section.kind === "arbitrary") return section;
-    const rule = matchRule(section.kind, profile, archetype);
+    const rule = matchRule(section.kind, profile, archetype, ctx);
     if (!rule) return section;
     const originalText = section.text;
     const transformedText = `${rule.preamble}
@@ -2532,13 +2573,28 @@ function compile(ir, opts = {}) {
   const conventions = passApplyConventions(workingIR, profile);
   workingIR = conventions.value.ir;
   accumulatedMutations.push(...conventions.mutations);
+  const outputMode = resolveOutputMode({
+    declared: ir.constraints?.outputMode,
+    structuredOutput: ir.constraints?.structuredOutput,
+    toolCount: ir.tools?.length ?? 0
+  });
   const translated = applySectionRewrites({
     ir: workingIR,
     profile,
-    archetype: ir.intent.archetype
+    archetype: ir.intent.archetype,
+    outputMode
   });
   workingIR = translated.rewrittenIR;
   const sectionRewritesApplied = translated.rewrites;
+  const disciplineRewrite = sectionRewritesApplied.find(
+    (rw) => rw.kind === "discipline_contract"
+  );
+  const disciplineGateTokens = disciplineRewrite ? countTokens(
+    disciplineRewrite.transformedText.slice(
+      0,
+      disciplineRewrite.transformedText.length - disciplineRewrite.originalText.length
+    )
+  ) : 0;
   let wireOverrides;
   for (const rw of sectionRewritesApplied) {
     if (!rw.wireOverrides) continue;
@@ -2591,7 +2647,10 @@ function compile(ir, opts = {}) {
     cliffWarnings: [
       ...cliffs.value.loweringHints.qualityWarning ?? [],
       ...conventions.value.cliffWarnings
-    ]
+    ],
+    // alpha.68 / Release A — measured discipline gate-token tax (§5.D). 0 when
+    // the gate didn't fire.
+    disciplineGateTokens
   };
   if (ir.intent.archetype === "hunt" && ir.constraints?.toolOrchestration === "sequential") {
     accumulatedMutations.push({
@@ -2995,7 +3054,7 @@ async function flushBrainDeadLetter() {
 }
 var compileRegistry = /* @__PURE__ */ new Map();
 var REGISTRY_MAX_ENTRIES = 1e4;
-function registerCompile(appId, archetype, ir, result) {
+function registerCompile(appId, archetype, ir, result, parentHandle) {
   if (compileRegistry.size >= REGISTRY_MAX_ENTRIES) {
     const cutoff = Math.floor(REGISTRY_MAX_ENTRIES * 0.25);
     let evicted = 0;
@@ -3047,7 +3106,15 @@ function registerCompile(appId, archetype, ir, result) {
     // outcome quality lifted to M."
     sectionRewritesApplied: result.sectionRewritesApplied,
     // alpha.57: cache the declared effort tier for record()'s auto-enrich.
-    effortFromCompile: ir.constraints?.effort
+    effortFromCompile: ir.constraints?.effort,
+    // alpha.68 / Release A (§5.0, R0 linkage) — derive + cache the fan-out
+    // linkage. Release A is 1-level: a branch's trace_id is its parent handle
+    // (the root); deeper trees await the delegate primitive (Release D).
+    parentHandle,
+    traceId: parentHandle ?? result.handle,
+    fanoutRole: parentHandle ? "branch" : "root",
+    // alpha.68 / Release A (§5.D) — measured gate-token tax from diagnostics.
+    disciplineGateTokens: result.diagnostics.disciplineGateTokens
   });
 }
 function estimateSystemPromptChars(sections) {
@@ -3238,7 +3305,17 @@ function buildPayload(input, reg) {
     // alpha.29 — translator activity (migration 019). Send NULL when no
     // rewrites fired so the brain's "did the translator do anything?"
     // queries can use `IS NOT NULL` cleanly.
-    section_rewrites_applied: reg?.sectionRewritesApplied && reg.sectionRewritesApplied.length > 0 ? reg.sectionRewritesApplied : null
+    section_rewrites_applied: reg?.sectionRewritesApplied && reg.sectionRewritesApplied.length > 0 ? reg.sectionRewritesApplied : null,
+    // alpha.68 / Release A (§5.0 + §5.D, migration 042) — auto-enrich the
+    // fan-out linkage + discipline gate tax from the registered compile.
+    // Omit-when-undefined (JSON.stringify drops undefined keys), same posture as
+    // `effort` / `retried_same_model` → safe against pre-042 brains. A registered
+    // compile always carries trace_id + fanout_role + discipline_gate_tokens
+    // (root/0 for ordinary traffic); parent_handle is present only for branches.
+    parent_handle: reg?.parentHandle,
+    trace_id: reg?.traceId,
+    fanout_role: reg?.fanoutRole,
+    discipline_gate_tokens: reg?.disciplineGateTokens
   };
 }
 function computeCostUsd(modelId, tokensIn, tokensOut) {
@@ -4429,9 +4506,11 @@ function compileAndRegister(ir, opts) {
   const result = compile(ir, {
     policy: opts.policy,
     toolRelevanceThreshold: opts.toolRelevanceThreshold,
-    compressHistoryAfter: opts.compressHistoryAfter
+    compressHistoryAfter: opts.compressHistoryAfter,
+    // alpha.68 / Release A — carry the fan-out parent handle through to compile.
+    parentHandle: opts.parentHandle
   });
-  registerCompile(ir.appId, ir.intent.archetype, ir, result);
+  registerCompile(ir.appId, ir.intent.archetype, ir, result, opts.parentHandle);
   return result;
 }
 function extractPromptPreview(ir) {
@@ -4782,7 +4861,7 @@ function attachCacheControlToStreamTextInput(result, convertedMessages) {
 // src/compile-aisdk.ts
 function compileForAISDKv6(ir, opts) {
   const result = compile(ir, opts);
-  registerCompile(ir.appId, ir.intent.archetype, ir, result);
+  registerCompile(ir.appId, ir.intent.archetype, ir, result, opts?.parentHandle);
   armCompileConsumeTracking(result.handle);
   const systemMessages = result.systemMessages;
   const hasStructuredSystemCacheControl = result.provider === "anthropic" && systemMessages.some(
@@ -5791,7 +5870,7 @@ async function markExclusionFindingHandled(opts) {
 // src/index.ts
 function compile2(ir, opts) {
   const result = compile(ir, opts);
-  registerCompile(ir.appId, ir.intent.archetype, ir, result);
+  registerCompile(ir.appId, ir.intent.archetype, ir, result, opts?.parentHandle);
   return result;
 }
 export {

package/dist/{ir-Qnw6L265.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).
@@ -125,12 +125,21 @@ interface PromptSection {
  *                          sequential-tool cliff on the active archetype
  * - `narration_contract` — output-format rules ("don't narrate your steps");
  *                          alpha.30+ candidate
+ * - `discipline_contract`— alpha.68 / Release A (delegation-fanout-accelerator
+ *                          §5.D): surface-scaffolding gate block. When declared
+ *                          on a role/system section, the translator prepends the
+ *                          frozen `discipline-gates-v1` preamble subject to a
+ *                          two-factor eligibility screen — Factor A (archetype:
+ *                          hunt/summarize/plan/critique/judge) AND Factor C
+ *                          (output-shape: text only, never json/tool_call).
+ *                          Clears no cliff, emits no wireOverrides ⇒ no advisor
+ *                          suppression. See `translator.ts`.
  * - `user_turn`          — when sections carry user content rather than
  *                          system context (rare)
  * - `reference`          — supporting reference data the model may consult
  * - `arbitrary`          — explicit pass-through (default when unset)
  */
-type SectionKind = 'role_intro' | 'tool_call_contract' | 'narration_contract' | 'user_turn' | 'reference' | 'arbitrary';
+type SectionKind = 'role_intro' | 'tool_call_contract' | 'narration_contract' | 'discipline_contract' | 'user_turn' | 'reference' | 'arbitrary';
 interface ToolDefinition {
     name: string;
     description?: string;
@@ -197,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. */
@@ -289,6 +313,18 @@ interface CompilePolicy {
      * on high-volume routes.
      */
     maxCostPerCallUsd?: number;
+    /**
+     * alpha.68 / Release A (delegation-fanout-accelerator §5.1) — trace-level
+     * cost ceiling (USD) across a fan-out `trace_id`'s cumulative spend.
+     *
+     * RECORDED / INERT in Release A: nothing fans out yet, so this field is
+     * accepted and carried but the compiler enforces NOTHING from it. It is
+     * enforced by the `delegate` primitive against the running trace spend in
+     * Release D. Kept distinct from `maxCostPerCallUsd` because that per-call
+     * ceiling is trivially evadable N times under fan-out — a fan-out budget
+     * has to be trace-scoped, not per-call.
+     */
+    maxCostPerTraceUsd?: number;
     /**
      * Model IDs the consumer prefers. When multiple models fit, preferred
      * models get a rank boost (large enough to overcome small quality
@@ -800,6 +836,16 @@ interface CompileResult {
          * advisory text. Both can fire on the same call.
          */
         cliffWarnings: string[];
+        /**
+         * alpha.68 / Release A (delegation-fanout-accelerator §5.D) — tokens added
+         * by the `discipline_contract` gate block on this call; 0 when the gate
+         * didn't fire (no eligible `discipline_contract` section, or Factor A /
+         * Factor C screened it out). Measured, never assumed: counted from the
+         * exact frozen preamble the translator prepended. Persisted to
+         * `compile_outcomes.discipline_gate_tokens` (migration 042) so the tax is a
+         * number the cost-watcher can weigh against the lift.
+         */
+        disciplineGateTokens: number;
     };
     /**
      * alpha.33. Structured `system` for AI-SDK `streamText({ system })`
@@ -987,6 +1033,18 @@ interface ShadowProbeConfig {
 interface CallOptions {
     /** Forwarded to compile(). */
     policy?: CompilePolicy;
+    /**
+     * alpha.68 / Release A (delegation-fanout-accelerator §5.0, R0 linkage).
+     * When set, this call is a fan-out BRANCH of the parent trace: the outcome
+     * row records `fanout_role='branch'`, `parent_handle=<this value>`, and
+     * `trace_id` inherits the parent handle (the trace root). Absent ⇒ this is a
+     * root (user-facing) call: `fanout_role='root'`, `trace_id=<own handle>`.
+     * Pass the parent's `CallResult.handle` / `CompileResult.handle`.
+     *
+     * Release A supports 1-level linkage (root → branch); deeper trees await the
+     * `delegate` primitive in Release D. Labelling only — NOT a routing change.
+     */
+    parentHandle?: string;
     /**
      * alpha (s51 Phase 1) — full-IR inline shadow-probe. When set, kgauto
      * measures the candidate(s) on the same IR after serving the primary,

package/dist/{ir-BTvyl8-w.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).
@@ -125,12 +125,21 @@ interface PromptSection {
  *                          sequential-tool cliff on the active archetype
  * - `narration_contract` — output-format rules ("don't narrate your steps");
  *                          alpha.30+ candidate
+ * - `discipline_contract`— alpha.68 / Release A (delegation-fanout-accelerator
+ *                          §5.D): surface-scaffolding gate block. When declared
+ *                          on a role/system section, the translator prepends the
+ *                          frozen `discipline-gates-v1` preamble subject to a
+ *                          two-factor eligibility screen — Factor A (archetype:
+ *                          hunt/summarize/plan/critique/judge) AND Factor C
+ *                          (output-shape: text only, never json/tool_call).
+ *                          Clears no cliff, emits no wireOverrides ⇒ no advisor
+ *                          suppression. See `translator.ts`.
  * - `user_turn`          — when sections carry user content rather than
  *                          system context (rare)
  * - `reference`          — supporting reference data the model may consult
  * - `arbitrary`          — explicit pass-through (default when unset)
  */
-type SectionKind = 'role_intro' | 'tool_call_contract' | 'narration_contract' | 'user_turn' | 'reference' | 'arbitrary';
+type SectionKind = 'role_intro' | 'tool_call_contract' | 'narration_contract' | 'discipline_contract' | 'user_turn' | 'reference' | 'arbitrary';
 interface ToolDefinition {
     name: string;
     description?: string;
@@ -197,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. */
@@ -289,6 +313,18 @@ interface CompilePolicy {
      * on high-volume routes.
      */
     maxCostPerCallUsd?: number;
+    /**
+     * alpha.68 / Release A (delegation-fanout-accelerator §5.1) — trace-level
+     * cost ceiling (USD) across a fan-out `trace_id`'s cumulative spend.
+     *
+     * RECORDED / INERT in Release A: nothing fans out yet, so this field is
+     * accepted and carried but the compiler enforces NOTHING from it. It is
+     * enforced by the `delegate` primitive against the running trace spend in
+     * Release D. Kept distinct from `maxCostPerCallUsd` because that per-call
+     * ceiling is trivially evadable N times under fan-out — a fan-out budget
+     * has to be trace-scoped, not per-call.
+     */
+    maxCostPerTraceUsd?: number;
     /**
      * Model IDs the consumer prefers. When multiple models fit, preferred
      * models get a rank boost (large enough to overcome small quality
@@ -800,6 +836,16 @@ interface CompileResult {
          * advisory text. Both can fire on the same call.
          */
         cliffWarnings: string[];
+        /**
+         * alpha.68 / Release A (delegation-fanout-accelerator §5.D) — tokens added
+         * by the `discipline_contract` gate block on this call; 0 when the gate
+         * didn't fire (no eligible `discipline_contract` section, or Factor A /
+         * Factor C screened it out). Measured, never assumed: counted from the
+         * exact frozen preamble the translator prepended. Persisted to
+         * `compile_outcomes.discipline_gate_tokens` (migration 042) so the tax is a
+         * number the cost-watcher can weigh against the lift.
+         */
+        disciplineGateTokens: number;
     };
     /**
      * alpha.33. Structured `system` for AI-SDK `streamText({ system })`
@@ -987,6 +1033,18 @@ interface ShadowProbeConfig {
 interface CallOptions {
     /** Forwarded to compile(). */
     policy?: CompilePolicy;
+    /**
+     * alpha.68 / Release A (delegation-fanout-accelerator §5.0, R0 linkage).
+     * When set, this call is a fan-out BRANCH of the parent trace: the outcome
+     * row records `fanout_role='branch'`, `parent_handle=<this value>`, and
+     * `trace_id` inherits the parent handle (the trace root). Absent ⇒ this is a
+     * root (user-facing) call: `fanout_role='root'`, `trace_id=<own handle>`.
+     * Pass the parent's `CallResult.handle` / `CompileResult.handle`.
+     *
+     * Release A supports 1-level linkage (root → branch); deeper trees await the
+     * `delegate` primitive in Release D. Labelling only — NOT a routing change.
+     */
+    parentHandle?: string;
     /**
      * alpha (s51 Phase 1) — full-IR inline shadow-probe. When set, kgauto
      * measures the candidate(s) on the same IR after serving the primary,

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.67";
+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-DTFQIURE.mjs";
+} from "./chunk-EZXVJUK7.mjs";
 export {
   createKeyHealthRoute
 };

package/dist/profiles.d.mts

@@ -1,4 +1,4 @@
-import { k as Provider } from './ir-BTvyl8-w.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-Qnw6L265.js';
+import { k as Provider } from './ir-Bvlkw5ja.js';
 import { IntentArchetypeName } from './dialect.js';
 
 /**

package/dist/{types-BdYlJz0Z.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-Qnw6L265.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-Cya0jPAF.d.mts → types-CwGhacGT.d.mts}

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

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

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

package/dist/{types-8pWRDbUg.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-BTvyl8-w.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.67",
+  "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",