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

package/dist/index.js

@@ -48,6 +48,7 @@ __export(index_exports, {
   call: () => call,
   clearBrain: () => clearBrain,
   compile: () => compile2,
+  compileForAISDKv6: () => compileForAISDKv6,
   configureBrain: () => configureBrain,
   countTokens: () => countTokens,
   deriveFamilyFromModelId: () => deriveFamilyFromModelId,
@@ -1634,6 +1635,63 @@ var PROFILES_RAW = [
       critique: 5
       // +1 vs 2.5-flash — but still below Sonnet/Opus reasoning floor
     }
+  },
+  {
+    // Auto-onboarded 2026-07-01 from `claude-sonnet-4-6`; VERIFIED 2026-07-02
+    // against the claude-api reference (cc-portfolio ratification pass). The
+    // clone got context right (1M) and pricing right at sticker ($3/$15 —
+    // NOTE an introductory $2/$10 per MTok runs through 2026-08-31; sticker
+    // encoded here per the time-bounded-pricing convention, intro belongs in
+    // brain kgauto_pricing if worth capturing). The clone got max output WRONG:
+    // Sonnet 5 is 128k, not 4-6's 64k — corrected. New tokenizer (~30% more
+    // tokens for the same text vs 4-6): byte-budget consumers should re-baseline.
+    // API quirks (claude-api ref): (a) NON-DEFAULT temperature/top_p/top_k
+    // return 400 — moot for kgauto's own call() path (ANTHROPIC_LOWERING_BASE
+    // emits no sampling params) but a REAL hazard for compileForAISDKv6
+    // consumers that pass temperature themselves (tt-intel scoring uses temp:0
+    // for determinism — that 400s on this model; noted to consumers via the
+    // contract). (b) Omitting `thinking` runs ADAPTIVE by default (4-6 ran
+    // thinking-off) — output spend shifts. (c) Supports effort xhigh. status:
+    // 'preview' per the Fable precedent — no brain evidence yet; promotion to
+    // 'current' is an explicit call. (L-049/L-081.)
+    id: "claude-sonnet-5",
+    verifiedAgainstDocs: "2026-07-02",
+    provider: "anthropic",
+    status: "preview",
+    maxContextTokens: 1e6,
+    maxOutputTokens: 128e3,
+    maxTools: 64,
+    parallelToolCalls: true,
+    structuredOutput: "grammar",
+    systemPromptMode: "inline",
+    streaming: true,
+    cliffs: [],
+    costInputPer1m: 3,
+    costOutputPer1m: 15,
+    lowering: ANTHROPIC_LOWERING_BASE,
+    recovery: [
+      { signal: "rate_limit", action: "escalate", reason: "429 \u2014 escalate" },
+      { signal: "model_not_found", action: "escalate", reason: "Deprecated \u2014 escalate (L-061)" }
+    ],
+    strengths: ["quality", "tool_use", "long_context", "cache_friendly", "extended_thinking"],
+    weaknesses: [],
+    notes: "Sonnet 5 (2026-06): near-Opus quality on coding/agentic work at Sonnet cost. Verified 2026-07-02 against the claude-api reference: 1M ctx, 128k out (clone's 64k corrected), $3/$15 sticker (intro $2/$10 through 2026-08-31). New tokenizer ~30% more tokens vs sonnet-4-6. Consumer hazards: non-default temperature/top_p/top_k 400 (temp:0 rejected \u2014 deterministic-scoring consumers must omit); thinking defaults to adaptive when omitted. status:preview \u2014 no brain evidence yet; earns placement via the machinery.",
+    // Master plan §6.2 anchor. Tier 0 for plan/generate/ask/extract/transform
+    // in starter chains; tier 1 cross-provider for hunt/summarize/classify.
+    archetypePerf: {
+      ask: 9,
+      generate: 9,
+      plan: 9,
+      critique: 9,
+      extract: 9,
+      transform: 9,
+      hunt: 7,
+      // strong but Flash beats on parallel tool throughput
+      summarize: 8,
+      // overkill for tolerant archetype
+      classify: 8
+      // overkill
+    }
   }
 ];
 var ALIASES = {
@@ -4464,9 +4522,37 @@ function estimateSystemPromptChars(sections) {
   }
   return total > 0 ? total : void 0;
 }
+function armCompileConsumeTracking(handle) {
+  const reg = compileRegistry.get(handle);
+  if (!reg) return;
+  reg.consumeTracked = true;
+  reg.systemConsumed = false;
+  reg.modelConsumed = false;
+  reg.rawConsumed = false;
+}
+function markCompileConsumed(handle, field) {
+  const reg = compileRegistry.get(handle);
+  if (!reg || !reg.consumeTracked) return;
+  if (field === "system") reg.systemConsumed = true;
+  else if (field === "model") reg.modelConsumed = true;
+  else reg.rawConsumed = true;
+}
+function maybeWarnDiscardedCompile(reg, handle) {
+  if (!reg.consumeTracked) return;
+  if (reg.systemConsumed || reg.modelConsumed || reg.rawConsumed) return;
+  const isProd = typeof process !== "undefined" && process.env?.NODE_ENV === "production";
+  const enabled = activeConfig?.warnOnDiscardedCompile ?? !isProd;
+  if (!enabled) return;
+  console.warn(
+    `[kgauto] compile-then-discard: compileForAISDKv6() output for handle ${handle} (archetype=${reg.archetype}, model=${reg.model}) was recorded but neither .system, .model, nor .raw was read before record(). The brain row's mutations_applied / estimated_tokens_in / system_prompt_chars describe a compile that did NOT shape the served call. Pass compiled.system + compiled.model into your generateText/streamText (or use call()). Silence via configureBrain({ warnOnDiscardedCompile: false }).`
+  );
+}
 async function record(input) {
   const reg = compileRegistry.get(input.handle);
-  if (reg) compileRegistry.delete(input.handle);
+  if (reg) {
+    maybeWarnDiscardedCompile(reg, input.handle);
+    compileRegistry.delete(input.handle);
+  }
   if (!activeConfig) {
     return;
   }
@@ -4496,7 +4582,7 @@ async function record(input) {
       });
       if (!res.ok) {
         const text = await res.text().catch(() => "<no body>");
-        throw new Error(`brain ${res.status}: ${text}`);
+        throw new Error(describeBrainWriteFailure(res.status, "outcomes", text));
       }
       outcomeId = await tryExtractOutcomeId(res);
     } catch (err) {
@@ -4534,6 +4620,11 @@ async function record(input) {
 function defaultOnError5(err) {
   console.warn("[kgauto] brain record failed:", err);
 }
+function describeBrainWriteFailure(status, route, body) {
+  const base = `brain ${route} ${status}: ${body}`;
+  if (status !== 404 && status !== 405) return base;
+  return `${base} \u2014 likely cause: the brain proxy at your KGAUTO_V2_BRAIN_URL is missing the /${route} forward route. Self-proxying consumers must implement ALL THREE sibling routes (/outcomes, /probe_outcomes, /compile_outcome_quality) \u2014 see interfaces/kgauto.md "Consumer adoption checklist" route-completeness (L-142).`;
+}
 function buildPayload(input, reg) {
   const compileTarget = reg?.model;
   const actual = input.actualModel ?? compileTarget;
@@ -4662,7 +4753,9 @@ async function recordOutcome(input) {
       });
       if (!res.ok) {
         const text = await res.text().catch(() => "<no body>");
-        const err = new Error(`brain ${res.status}: ${text}`);
+        const err = new Error(
+          describeBrainWriteFailure(res.status, "compile_outcome_quality", text)
+        );
         (config.onError ?? defaultOnError5)(err);
         return { ok: false, reason: "persistence_failed" };
       }
@@ -4704,8 +4797,12 @@ function buildShadowProbeRow(input) {
     prompt_fidelity: 1,
     replay_source: "inline-full-ir",
     // alpha — migration 029. 'completed' is the default completed-probe shape;
-    // diagnostic rows (aborted/skipped) pass the explicit class.
-    outcome: input.outcome ?? "completed"
+    // diagnostic rows (aborted/skipped/errored) pass the explicit class.
+    outcome: input.outcome ?? "completed",
+    // alpha.53 — migration 032. Populated only on candidate_error rows.
+    // Self-proxying consumers must whitelist `error_class` (and `outcome`,
+    // per the alpha.51 PB finding) or diagnostic rows degrade silently.
+    error_class: input.errorClass ?? null
   };
 }
 async function recordShadowProbe(input) {
@@ -4726,7 +4823,7 @@ async function recordShadowProbe(input) {
       });
       if (!res.ok) {
         const text = await res.text().catch(() => "<no body>");
-        throw new Error(`brain probe_outcomes ${res.status}: ${text}`);
+        throw new Error(describeBrainWriteFailure(res.status, "probe_outcomes", text));
       }
     } catch (err) {
       (config.onError ?? defaultOnError5)(err);
@@ -6331,7 +6428,7 @@ async function runProbeCandidates(args) {
     const budgetMs = args.cfg.maxLatencyMs ?? DEFAULT_PROBE_MAX_LATENCY_MS;
     const deadline = args.sync ? Date.now() + budgetMs : Number.POSITIVE_INFINITY;
     const skipSlow = args.sync && (args.cfg.skipSlowTierInSync ?? true);
-    const recordDiagnostic = async (candidate, outcome) => {
+    const recordDiagnostic = async (candidate, outcome, detail) => {
       await recordShadowProbe({
         appId: args.ir.appId,
         archetype: args.ir.intent.archetype,
@@ -6344,7 +6441,9 @@ async function runProbeCandidates(args) {
         tokensCurrentIn: args.servedResponse.tokens.input,
         tokensCurrentOut: args.servedResponse.tokens.output,
         latencyCurrentMs: args.servedLatencyMs,
-        outcome
+        outcome,
+        ...detail?.errorClass ? { errorClass: detail.errorClass } : {},
+        ...detail?.latencyCandidateMs !== void 0 ? { latencyCandidateMs: detail.latencyCandidateMs } : {}
       });
     };
     for (const candidate of candidates) {
@@ -6399,10 +6498,28 @@ async function runProbeCandidates(args) {
           }
           break;
         }
-        if (raced.kind === "failed") continue;
+        if (raced.kind === "failed") {
+          try {
+            await recordDiagnostic(candidate, "candidate_error", {
+              errorClass: "execute_rejected",
+              latencyCandidateMs: Date.now() - candStart
+            });
+          } catch {
+          }
+          continue;
+        }
         const exec = raced.exec;
         const candidateLatencyMs = Date.now() - candStart;
-        if (!exec.ok) continue;
+        if (!exec.ok) {
+          try {
+            await recordDiagnostic(candidate, "candidate_error", {
+              errorClass: exec.errorCode,
+              latencyCandidateMs: candidateLatencyMs
+            });
+          } catch {
+          }
+          continue;
+        }
         await recordShadowProbe({
           appId: args.ir.appId,
           archetype: args.ir.intent.archetype,
@@ -6579,6 +6696,71 @@ function attachCacheControlToStreamTextInput(result, convertedMessages) {
   return { system, messages };
 }
 
+// src/compile-aisdk.ts
+function compileForAISDKv6(ir, opts) {
+  const result = compile(ir, opts);
+  registerCompile(ir.appId, ir.intent.archetype, ir, result);
+  armCompileConsumeTracking(result.handle);
+  const systemMessages = result.systemMessages;
+  const hasStructuredSystemCacheControl = result.provider === "anthropic" && systemMessages.some(
+    (m) => m.providerOptions?.anthropic?.cacheControl !== void 0
+  );
+  const systemValue = hasStructuredSystemCacheControl ? systemMessages : systemMessages.map((m) => m.content).join("\n\n");
+  const keptToolNames = extractKeptToolNames(result);
+  const providerOptions = result.provider === "anthropic" && result.diagnostics.cacheableTokens > 0 ? { anthropic: { cacheControl: { type: "ephemeral" } } } : void 0;
+  const handle = result.handle;
+  const diagnostics = {
+    ...result.diagnostics,
+    targetProvider: result.provider,
+    estimatedCostUsd: result.estimatedCostUsd,
+    fallbackChain: result.fallbackChain
+  };
+  return {
+    handle,
+    // Consume-tracking getters: reading any of these flags the compile as
+    // "used", silencing the discard guard at record() time.
+    get model() {
+      markCompileConsumed(handle, "model");
+      return result.target;
+    },
+    get system() {
+      markCompileConsumed(handle, "system");
+      return systemValue;
+    },
+    get raw() {
+      markCompileConsumed(handle, "raw");
+      return result;
+    },
+    keptToolNames,
+    ...providerOptions ? { providerOptions } : {},
+    ...result.diagnostics.historyCacheMarkIndex !== void 0 ? { historyCacheMarkIndex: result.diagnostics.historyCacheMarkIndex } : {},
+    mutationsApplied: result.mutationsApplied.map((m) => m.id),
+    advisories: result.advisories ?? [],
+    diagnostics,
+    ir
+  };
+}
+function extractKeptToolNames(result) {
+  const names = /* @__PURE__ */ new Set();
+  const tools = result.request.tools;
+  if (!Array.isArray(tools)) return names;
+  if (result.provider === "google") {
+    for (const td of tools) {
+      for (const fn of td.functionDeclarations ?? []) if (fn.name) names.add(fn.name);
+    }
+  } else if (result.provider === "openai") {
+    for (const t of tools) {
+      const n = t.function?.name;
+      if (n) names.add(n);
+    }
+  } else {
+    for (const t of tools) {
+      if (t.name) names.add(t.name);
+    }
+  }
+  return names;
+}
+
 // src/oracle.ts
 var DEFAULT_DIMENSIONS = ["correctness", "completeness", "conciseness", "format"];
 var judgeCallTimes = [];
@@ -7035,6 +7217,7 @@ function compile2(ir, opts) {
   call,
   clearBrain,
   compile,
+  compileForAISDKv6,
   configureBrain,
   countTokens,
   deriveFamilyFromModelId,

package/dist/index.mjs

@@ -33,7 +33,7 @@ import {
   loadChainsFromBrain,
   readBrainReadEnv,
   resolveProviderKey
-} from "./chunk-HHWBB46W.mjs";
+} from "./chunk-IIMPJZNH.mjs";
 import {
   ALIASES,
   LATENCY_TIER_MS,
@@ -44,7 +44,7 @@ import {
   latencyTierOf,
   profilesByProvider,
   tryGetProfile
-} from "./chunk-CXH7KC4D.mjs";
+} from "./chunk-QKXTMVCT.mjs";
 import {
   emitAdvisoryFired,
   emitCompileDone,
@@ -2676,9 +2676,37 @@ function estimateSystemPromptChars(sections) {
   }
   return total > 0 ? total : void 0;
 }
+function armCompileConsumeTracking(handle) {
+  const reg = compileRegistry.get(handle);
+  if (!reg) return;
+  reg.consumeTracked = true;
+  reg.systemConsumed = false;
+  reg.modelConsumed = false;
+  reg.rawConsumed = false;
+}
+function markCompileConsumed(handle, field) {
+  const reg = compileRegistry.get(handle);
+  if (!reg || !reg.consumeTracked) return;
+  if (field === "system") reg.systemConsumed = true;
+  else if (field === "model") reg.modelConsumed = true;
+  else reg.rawConsumed = true;
+}
+function maybeWarnDiscardedCompile(reg, handle) {
+  if (!reg.consumeTracked) return;
+  if (reg.systemConsumed || reg.modelConsumed || reg.rawConsumed) return;
+  const isProd = typeof process !== "undefined" && process.env?.NODE_ENV === "production";
+  const enabled = activeConfig?.warnOnDiscardedCompile ?? !isProd;
+  if (!enabled) return;
+  console.warn(
+    `[kgauto] compile-then-discard: compileForAISDKv6() output for handle ${handle} (archetype=${reg.archetype}, model=${reg.model}) was recorded but neither .system, .model, nor .raw was read before record(). The brain row's mutations_applied / estimated_tokens_in / system_prompt_chars describe a compile that did NOT shape the served call. Pass compiled.system + compiled.model into your generateText/streamText (or use call()). Silence via configureBrain({ warnOnDiscardedCompile: false }).`
+  );
+}
 async function record(input) {
   const reg = compileRegistry.get(input.handle);
-  if (reg) compileRegistry.delete(input.handle);
+  if (reg) {
+    maybeWarnDiscardedCompile(reg, input.handle);
+    compileRegistry.delete(input.handle);
+  }
   if (!activeConfig) {
     return;
   }
@@ -2708,7 +2736,7 @@ async function record(input) {
       });
       if (!res.ok) {
         const text = await res.text().catch(() => "<no body>");
-        throw new Error(`brain ${res.status}: ${text}`);
+        throw new Error(describeBrainWriteFailure(res.status, "outcomes", text));
       }
       outcomeId = await tryExtractOutcomeId(res);
     } catch (err) {
@@ -2746,6 +2774,11 @@ async function record(input) {
 function defaultOnError4(err) {
   console.warn("[kgauto] brain record failed:", err);
 }
+function describeBrainWriteFailure(status, route, body) {
+  const base = `brain ${route} ${status}: ${body}`;
+  if (status !== 404 && status !== 405) return base;
+  return `${base} \u2014 likely cause: the brain proxy at your KGAUTO_V2_BRAIN_URL is missing the /${route} forward route. Self-proxying consumers must implement ALL THREE sibling routes (/outcomes, /probe_outcomes, /compile_outcome_quality) \u2014 see interfaces/kgauto.md "Consumer adoption checklist" route-completeness (L-142).`;
+}
 function buildPayload(input, reg) {
   const compileTarget = reg?.model;
   const actual = input.actualModel ?? compileTarget;
@@ -2874,7 +2907,9 @@ async function recordOutcome(input) {
       });
       if (!res.ok) {
         const text = await res.text().catch(() => "<no body>");
-        const err = new Error(`brain ${res.status}: ${text}`);
+        const err = new Error(
+          describeBrainWriteFailure(res.status, "compile_outcome_quality", text)
+        );
         (config.onError ?? defaultOnError4)(err);
         return { ok: false, reason: "persistence_failed" };
       }
@@ -2916,8 +2951,12 @@ function buildShadowProbeRow(input) {
     prompt_fidelity: 1,
     replay_source: "inline-full-ir",
     // alpha — migration 029. 'completed' is the default completed-probe shape;
-    // diagnostic rows (aborted/skipped) pass the explicit class.
-    outcome: input.outcome ?? "completed"
+    // diagnostic rows (aborted/skipped/errored) pass the explicit class.
+    outcome: input.outcome ?? "completed",
+    // alpha.53 — migration 032. Populated only on candidate_error rows.
+    // Self-proxying consumers must whitelist `error_class` (and `outcome`,
+    // per the alpha.51 PB finding) or diagnostic rows degrade silently.
+    error_class: input.errorClass ?? null
   };
 }
 async function recordShadowProbe(input) {
@@ -2938,7 +2977,7 @@ async function recordShadowProbe(input) {
       });
       if (!res.ok) {
         const text = await res.text().catch(() => "<no body>");
-        throw new Error(`brain probe_outcomes ${res.status}: ${text}`);
+        throw new Error(describeBrainWriteFailure(res.status, "probe_outcomes", text));
       }
     } catch (err) {
       (config.onError ?? defaultOnError4)(err);
@@ -3828,7 +3867,7 @@ async function runProbeCandidates(args) {
     const budgetMs = args.cfg.maxLatencyMs ?? DEFAULT_PROBE_MAX_LATENCY_MS;
     const deadline = args.sync ? Date.now() + budgetMs : Number.POSITIVE_INFINITY;
     const skipSlow = args.sync && (args.cfg.skipSlowTierInSync ?? true);
-    const recordDiagnostic = async (candidate, outcome) => {
+    const recordDiagnostic = async (candidate, outcome, detail) => {
       await recordShadowProbe({
         appId: args.ir.appId,
         archetype: args.ir.intent.archetype,
@@ -3841,7 +3880,9 @@ async function runProbeCandidates(args) {
         tokensCurrentIn: args.servedResponse.tokens.input,
         tokensCurrentOut: args.servedResponse.tokens.output,
         latencyCurrentMs: args.servedLatencyMs,
-        outcome
+        outcome,
+        ...detail?.errorClass ? { errorClass: detail.errorClass } : {},
+        ...detail?.latencyCandidateMs !== void 0 ? { latencyCandidateMs: detail.latencyCandidateMs } : {}
       });
     };
     for (const candidate of candidates) {
@@ -3896,10 +3937,28 @@ async function runProbeCandidates(args) {
           }
           break;
         }
-        if (raced.kind === "failed") continue;
+        if (raced.kind === "failed") {
+          try {
+            await recordDiagnostic(candidate, "candidate_error", {
+              errorClass: "execute_rejected",
+              latencyCandidateMs: Date.now() - candStart
+            });
+          } catch {
+          }
+          continue;
+        }
         const exec = raced.exec;
         const candidateLatencyMs = Date.now() - candStart;
-        if (!exec.ok) continue;
+        if (!exec.ok) {
+          try {
+            await recordDiagnostic(candidate, "candidate_error", {
+              errorClass: exec.errorCode,
+              latencyCandidateMs: candidateLatencyMs
+            });
+          } catch {
+          }
+          continue;
+        }
         await recordShadowProbe({
           appId: args.ir.appId,
           archetype: args.ir.intent.archetype,
@@ -4076,6 +4135,71 @@ function attachCacheControlToStreamTextInput(result, convertedMessages) {
   return { system, messages };
 }
 
+// src/compile-aisdk.ts
+function compileForAISDKv6(ir, opts) {
+  const result = compile(ir, opts);
+  registerCompile(ir.appId, ir.intent.archetype, ir, result);
+  armCompileConsumeTracking(result.handle);
+  const systemMessages = result.systemMessages;
+  const hasStructuredSystemCacheControl = result.provider === "anthropic" && systemMessages.some(
+    (m) => m.providerOptions?.anthropic?.cacheControl !== void 0
+  );
+  const systemValue = hasStructuredSystemCacheControl ? systemMessages : systemMessages.map((m) => m.content).join("\n\n");
+  const keptToolNames = extractKeptToolNames(result);
+  const providerOptions = result.provider === "anthropic" && result.diagnostics.cacheableTokens > 0 ? { anthropic: { cacheControl: { type: "ephemeral" } } } : void 0;
+  const handle = result.handle;
+  const diagnostics = {
+    ...result.diagnostics,
+    targetProvider: result.provider,
+    estimatedCostUsd: result.estimatedCostUsd,
+    fallbackChain: result.fallbackChain
+  };
+  return {
+    handle,
+    // Consume-tracking getters: reading any of these flags the compile as
+    // "used", silencing the discard guard at record() time.
+    get model() {
+      markCompileConsumed(handle, "model");
+      return result.target;
+    },
+    get system() {
+      markCompileConsumed(handle, "system");
+      return systemValue;
+    },
+    get raw() {
+      markCompileConsumed(handle, "raw");
+      return result;
+    },
+    keptToolNames,
+    ...providerOptions ? { providerOptions } : {},
+    ...result.diagnostics.historyCacheMarkIndex !== void 0 ? { historyCacheMarkIndex: result.diagnostics.historyCacheMarkIndex } : {},
+    mutationsApplied: result.mutationsApplied.map((m) => m.id),
+    advisories: result.advisories ?? [],
+    diagnostics,
+    ir
+  };
+}
+function extractKeptToolNames(result) {
+  const names = /* @__PURE__ */ new Set();
+  const tools = result.request.tools;
+  if (!Array.isArray(tools)) return names;
+  if (result.provider === "google") {
+    for (const td of tools) {
+      for (const fn of td.functionDeclarations ?? []) if (fn.name) names.add(fn.name);
+    }
+  } else if (result.provider === "openai") {
+    for (const t of tools) {
+      const n = t.function?.name;
+      if (n) names.add(n);
+    }
+  } else {
+    for (const t of tools) {
+      if (t.name) names.add(t.name);
+    }
+  }
+  return names;
+}
+
 // src/oracle.ts
 var DEFAULT_DIMENSIONS = ["correctness", "completeness", "conciseness", "format"];
 var judgeCallTimes = [];
@@ -4531,6 +4655,7 @@ export {
   call,
   clearBrain,
   compile2 as compile,
+  compileForAISDKv6,
   configureBrain,
   countTokens,
   deriveFamilyFromModelId,

package/dist/{ir-rUUojj0s.d.ts → ir-BiXAMyji.d.ts}

@@ -1216,7 +1216,16 @@ type OutcomeKind = 'approved' | 'rejected' | 'partial' | 'engaged' | 'abandoned'
  * outcomes accumulate.
  */
 interface RecordOutcomeInput {
-    /** Joins to compile_outcomes.id. Returned by compile() via CompileResult.outcomeId. */
+    /**
+     * Joins to compile_outcomes.id. Pass the compile `handle` string
+     * (CompileResult.handle / CallResult.handle) — consumer proxies resolve
+     * handle → compile_outcomes.id via the `compile_outcomes.handle` column
+     * (reference implementations: PB `api/kgauto-v2/compile_outcome_quality.js`,
+     * tt-intel/IC `app/api/kgauto/v2/compile_outcome_quality/route.ts`). A
+     * numeric compile_outcomes.id also works if the caller already has it.
+     * (There is no `CompileResult.outcomeId` field — the brain assigns the row
+     * id at insert; `handle` is the consumer-visible correlator.)
+     */
     outcomeId: number | string;
     /** What did the user / system do with this output? */
     outcome: OutcomeKind;

package/dist/{ir-dDcG8Pvu.d.mts → ir-CAlLBu5d.d.mts}

@@ -1216,7 +1216,16 @@ type OutcomeKind = 'approved' | 'rejected' | 'partial' | 'engaged' | 'abandoned'
  * outcomes accumulate.
  */
 interface RecordOutcomeInput {
-    /** Joins to compile_outcomes.id. Returned by compile() via CompileResult.outcomeId. */
+    /**
+     * Joins to compile_outcomes.id. Pass the compile `handle` string
+     * (CompileResult.handle / CallResult.handle) — consumer proxies resolve
+     * handle → compile_outcomes.id via the `compile_outcomes.handle` column
+     * (reference implementations: PB `api/kgauto-v2/compile_outcome_quality.js`,
+     * tt-intel/IC `app/api/kgauto/v2/compile_outcome_quality/route.ts`). A
+     * numeric compile_outcomes.id also works if the caller already has it.
+     * (There is no `CompileResult.outcomeId` field — the brain assigns the row
+     * id at insert; `handle` is the consumer-visible correlator.)
+     */
     outcomeId: number | string;
     /** What did the user / system do with this output? */
     outcome: OutcomeKind;

package/dist/profiles.d.mts

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

package/dist/profiles.d.ts

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

package/dist/profiles.js

@@ -1388,6 +1388,63 @@ var PROFILES_RAW = [
       critique: 5
       // +1 vs 2.5-flash — but still below Sonnet/Opus reasoning floor
     }
+  },
+  {
+    // Auto-onboarded 2026-07-01 from `claude-sonnet-4-6`; VERIFIED 2026-07-02
+    // against the claude-api reference (cc-portfolio ratification pass). The
+    // clone got context right (1M) and pricing right at sticker ($3/$15 —
+    // NOTE an introductory $2/$10 per MTok runs through 2026-08-31; sticker
+    // encoded here per the time-bounded-pricing convention, intro belongs in
+    // brain kgauto_pricing if worth capturing). The clone got max output WRONG:
+    // Sonnet 5 is 128k, not 4-6's 64k — corrected. New tokenizer (~30% more
+    // tokens for the same text vs 4-6): byte-budget consumers should re-baseline.
+    // API quirks (claude-api ref): (a) NON-DEFAULT temperature/top_p/top_k
+    // return 400 — moot for kgauto's own call() path (ANTHROPIC_LOWERING_BASE
+    // emits no sampling params) but a REAL hazard for compileForAISDKv6
+    // consumers that pass temperature themselves (tt-intel scoring uses temp:0
+    // for determinism — that 400s on this model; noted to consumers via the
+    // contract). (b) Omitting `thinking` runs ADAPTIVE by default (4-6 ran
+    // thinking-off) — output spend shifts. (c) Supports effort xhigh. status:
+    // 'preview' per the Fable precedent — no brain evidence yet; promotion to
+    // 'current' is an explicit call. (L-049/L-081.)
+    id: "claude-sonnet-5",
+    verifiedAgainstDocs: "2026-07-02",
+    provider: "anthropic",
+    status: "preview",
+    maxContextTokens: 1e6,
+    maxOutputTokens: 128e3,
+    maxTools: 64,
+    parallelToolCalls: true,
+    structuredOutput: "grammar",
+    systemPromptMode: "inline",
+    streaming: true,
+    cliffs: [],
+    costInputPer1m: 3,
+    costOutputPer1m: 15,
+    lowering: ANTHROPIC_LOWERING_BASE,
+    recovery: [
+      { signal: "rate_limit", action: "escalate", reason: "429 \u2014 escalate" },
+      { signal: "model_not_found", action: "escalate", reason: "Deprecated \u2014 escalate (L-061)" }
+    ],
+    strengths: ["quality", "tool_use", "long_context", "cache_friendly", "extended_thinking"],
+    weaknesses: [],
+    notes: "Sonnet 5 (2026-06): near-Opus quality on coding/agentic work at Sonnet cost. Verified 2026-07-02 against the claude-api reference: 1M ctx, 128k out (clone's 64k corrected), $3/$15 sticker (intro $2/$10 through 2026-08-31). New tokenizer ~30% more tokens vs sonnet-4-6. Consumer hazards: non-default temperature/top_p/top_k 400 (temp:0 rejected \u2014 deterministic-scoring consumers must omit); thinking defaults to adaptive when omitted. status:preview \u2014 no brain evidence yet; earns placement via the machinery.",
+    // Master plan §6.2 anchor. Tier 0 for plan/generate/ask/extract/transform
+    // in starter chains; tier 1 cross-provider for hunt/summarize/classify.
+    archetypePerf: {
+      ask: 9,
+      generate: 9,
+      plan: 9,
+      critique: 9,
+      extract: 9,
+      transform: 9,
+      hunt: 7,
+      // strong but Flash beats on parallel tool throughput
+      summarize: 8,
+      // overkill for tolerant archetype
+      classify: 8
+      // overkill
+    }
   }
 ];
 var ALIASES = {

package/dist/profiles.mjs

@@ -8,7 +8,7 @@ import {
   latencyTierOf,
   profilesByProvider,
   tryGetProfile
-} from "./chunk-CXH7KC4D.mjs";
+} from "./chunk-QKXTMVCT.mjs";
 export {
   ALIASES,
   LATENCY_TIER_MS,

package/dist/{types-vGo-h0tZ.d.mts → types-C_dkNMA_.d.mts}

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

package/dist/{types-BTeRoSvM.d.mts → types-Dj5FLhBV.d.mts}

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