@warmdrift/kgauto-compiler 2.0.0-alpha.39 → 2.0.0-alpha.41

package/dist/{ir-CZ9Ng96k.d.ts → ir-DYpvUSEw.d.ts}

@@ -238,6 +238,24 @@ interface CompilePolicy {
      */
     posture?: 'locked' | 'preferred' | 'open';
 }
+/**
+ * alpha.41 — entry in `PromptIR.models[]`. Either a literal model id (the
+ * pre-alpha.41 shape, fully preserved) or a `{ family: string }` alias that
+ * resolves at compile() time to the latest-current model in that family.
+ *
+ * Family entries resolve via `resolveFamilyEntry` (internal twin of the
+ * public `getRecommendedPrimary`). Resolution fails CLOSED — a family that
+ * matches no current+active candidate throws `FamilyResolutionError` at
+ * compile time. Consumers who want a literal fallback should call
+ * `getRecommendedPrimary({ family, fallback, ... })` at IR-construction time
+ * and inline the resolved id, rather than passing `{ family }` into the IR.
+ *
+ * Family taxonomy is defined in `family-resolution.ts`; see also migration
+ * 024 (`kgauto_models.family` column + index).
+ */
+type ChainModelEntry = string | {
+    family: string;
+};
 /**
  * The IR — the input to compile().
  */
@@ -254,8 +272,19 @@ interface PromptIR {
     history?: Message[];
     /** The user's current turn — never dropped. */
     currentTurn?: Message;
-    /** Allowed model IDs, in caller-preference order. Compiler picks among these. */
-    models: string[];
+    /**
+     * Allowed model IDs (or family aliases — alpha.41+), in caller-preference
+     * order. Compiler resolves family entries to literal ids before scoring
+     * and picks among them. See {@link ChainModelEntry}.
+     *
+     * Internal passes downstream of compile()'s family-resolution step
+     * receive a narrowed `string[]` shape — `string` is a subtype of
+     * `ChainModelEntry`, so a `string[]` IS a `ChainModelEntry[]` at the
+     * type level. Code that needs to access string ids (passes.ts) reads
+     * via `getModelIds(ir)` from `models-runtime.ts` rather than narrowing
+     * inline.
+     */
+    models: ChainModelEntry[];
     /** Compile constraints. */
     constraints?: Constraints;
     /**
@@ -1165,4 +1194,4 @@ interface PerAxisMetrics {
 /** Per-axis metrics keyed by model — used for chain-comparison views. */
 type PerAxisMetricsByModel = Record<string, PerAxisMetrics>;
 
-export { type ApiKeys as A, type BestPracticeAdvisory as B, type CompilePolicy as C, type FallbackReason as F, type Grounding as G, type HistoryCachePolicy as H, type IntentDeclaration as I, type Message as M, type NormalizedResponse as N, type OutcomeResult as O, type ProviderOverrides as P, type RecordInput as R, type SystemModelMessage as S, type ToolCall as T, type CompiledRequest as a, type PromptIR as b, type CallOptions as c, type CallResult as d, type CompileResult as e, type SectionRewrite as f, type RecordOutcomeInput as g, type OracleScore as h, type Adapter as i, type PerAxisMetrics as j, type Provider as k, type ChainEntry as l, type CallAttempt as m, CallError as n, type ChainWithGrounding as o, type Constraints as p, type MutationApplied as q, type NormalizedTokens as r, type OutcomeKind as s, type PerAxisMetricsByModel as t, type PromptSection as u, type SectionKind as v, type ToolDefinition as w };
+export { type ApiKeys as A, type BestPracticeAdvisory as B, type CompilePolicy as C, type FallbackReason as F, type Grounding as G, type HistoryCachePolicy as H, type IntentDeclaration as I, type Message as M, type NormalizedResponse as N, type OutcomeResult as O, type ProviderOverrides as P, type RecordInput as R, type SystemModelMessage as S, type ToolCall as T, type CompiledRequest as a, type PromptIR as b, type CallOptions as c, type CallResult as d, type CompileResult as e, type SectionRewrite as f, type RecordOutcomeInput as g, type OracleScore as h, type Adapter as i, type PerAxisMetrics as j, type Provider as k, type ChainEntry as l, type CallAttempt as m, CallError as n, type ChainModelEntry as o, type ChainWithGrounding as p, type Constraints as q, type MutationApplied as r, type NormalizedTokens as s, type OutcomeKind as t, type PerAxisMetricsByModel as u, type PromptSection as v, type SectionKind as w, type ToolDefinition as x };

package/dist/{ir-BiZSAVCJ.d.mts → ir-D_kgJcaV.d.mts}

@@ -238,6 +238,24 @@ interface CompilePolicy {
      */
     posture?: 'locked' | 'preferred' | 'open';
 }
+/**
+ * alpha.41 — entry in `PromptIR.models[]`. Either a literal model id (the
+ * pre-alpha.41 shape, fully preserved) or a `{ family: string }` alias that
+ * resolves at compile() time to the latest-current model in that family.
+ *
+ * Family entries resolve via `resolveFamilyEntry` (internal twin of the
+ * public `getRecommendedPrimary`). Resolution fails CLOSED — a family that
+ * matches no current+active candidate throws `FamilyResolutionError` at
+ * compile time. Consumers who want a literal fallback should call
+ * `getRecommendedPrimary({ family, fallback, ... })` at IR-construction time
+ * and inline the resolved id, rather than passing `{ family }` into the IR.
+ *
+ * Family taxonomy is defined in `family-resolution.ts`; see also migration
+ * 024 (`kgauto_models.family` column + index).
+ */
+type ChainModelEntry = string | {
+    family: string;
+};
 /**
  * The IR — the input to compile().
  */
@@ -254,8 +272,19 @@ interface PromptIR {
     history?: Message[];
     /** The user's current turn — never dropped. */
     currentTurn?: Message;
-    /** Allowed model IDs, in caller-preference order. Compiler picks among these. */
-    models: string[];
+    /**
+     * Allowed model IDs (or family aliases — alpha.41+), in caller-preference
+     * order. Compiler resolves family entries to literal ids before scoring
+     * and picks among them. See {@link ChainModelEntry}.
+     *
+     * Internal passes downstream of compile()'s family-resolution step
+     * receive a narrowed `string[]` shape — `string` is a subtype of
+     * `ChainModelEntry`, so a `string[]` IS a `ChainModelEntry[]` at the
+     * type level. Code that needs to access string ids (passes.ts) reads
+     * via `getModelIds(ir)` from `models-runtime.ts` rather than narrowing
+     * inline.
+     */
+    models: ChainModelEntry[];
     /** Compile constraints. */
     constraints?: Constraints;
     /**
@@ -1165,4 +1194,4 @@ interface PerAxisMetrics {
 /** Per-axis metrics keyed by model — used for chain-comparison views. */
 type PerAxisMetricsByModel = Record<string, PerAxisMetrics>;
 
-export { type ApiKeys as A, type BestPracticeAdvisory as B, type CompilePolicy as C, type FallbackReason as F, type Grounding as G, type HistoryCachePolicy as H, type IntentDeclaration as I, type Message as M, type NormalizedResponse as N, type OutcomeResult as O, type ProviderOverrides as P, type RecordInput as R, type SystemModelMessage as S, type ToolCall as T, type CompiledRequest as a, type PromptIR as b, type CallOptions as c, type CallResult as d, type CompileResult as e, type SectionRewrite as f, type RecordOutcomeInput as g, type OracleScore as h, type Adapter as i, type PerAxisMetrics as j, type Provider as k, type ChainEntry as l, type CallAttempt as m, CallError as n, type ChainWithGrounding as o, type Constraints as p, type MutationApplied as q, type NormalizedTokens as r, type OutcomeKind as s, type PerAxisMetricsByModel as t, type PromptSection as u, type SectionKind as v, type ToolDefinition as w };
+export { type ApiKeys as A, type BestPracticeAdvisory as B, type CompilePolicy as C, type FallbackReason as F, type Grounding as G, type HistoryCachePolicy as H, type IntentDeclaration as I, type Message as M, type NormalizedResponse as N, type OutcomeResult as O, type ProviderOverrides as P, type RecordInput as R, type SystemModelMessage as S, type ToolCall as T, type CompiledRequest as a, type PromptIR as b, type CallOptions as c, type CallResult as d, type CompileResult as e, type SectionRewrite as f, type RecordOutcomeInput as g, type OracleScore as h, type Adapter as i, type PerAxisMetrics as j, type Provider as k, type ChainEntry as l, type CallAttempt as m, CallError as n, type ChainModelEntry as o, type ChainWithGrounding as p, type Constraints as q, type MutationApplied as r, type NormalizedTokens as s, type OutcomeKind as t, type PerAxisMetricsByModel as u, type PromptSection as v, type SectionKind as w, type ToolDefinition as x };

package/dist/profiles.d.mts

@@ -1,4 +1,4 @@
-import { k as Provider } from './ir-BiZSAVCJ.mjs';
+import { k as Provider } from './ir-D_kgJcaV.mjs';
 import { IntentArchetypeName } from './dialect.mjs';
 
 /**
@@ -118,6 +118,33 @@ interface ModelProfile {
      * alpha.9.
      */
     archetypePerf?: Partial<Record<IntentArchetypeName, number>>;
+    /**
+     * alpha.41 — model-family identifier (e.g. `'claude-opus'`,
+     * `'gemini-flash'`). Reads through from `kgauto_models.family` (migration
+     * 024). When unset on a brain row, runtime falls back to
+     * `deriveFamilyFromModelId(model.id)` (see `family-resolution.ts`).
+     *
+     * Used by `getRecommendedPrimary({ family, ... })` and the IR-level
+     * `{ family: string }` chain entry resolution at compile time.
+     */
+    family?: string;
+    /**
+     * alpha.41 — version string of the kgauto release that first introduced
+     * this profile (e.g. `'2.0.0-alpha.36'`). Threaded through from the brain
+     * row's `version_added` column. Family-resolution sorts candidates by
+     * `version_added DESC` (lexicographic) as the secondary tiebreaker after
+     * `archetypePerf[archetype]`. Undefined on bundled profiles (no brain
+     * row).
+     */
+    versionAdded?: string;
+    /**
+     * alpha.41 — whether the brain row is `active = TRUE`. False or undefined
+     * means the model is retired / not actively served (kgauto_models row
+     * exists but won't be selected by family resolution). Bundled profiles
+     * default to `true` when not threaded through (every PROFILES_RAW entry
+     * is by definition the active source of truth at bundle time).
+     */
+    active?: boolean;
 }
 declare const ALIASES: Record<string, string>;
 interface ProfileBrainHook {

package/dist/profiles.d.ts

@@ -1,4 +1,4 @@
-import { k as Provider } from './ir-CZ9Ng96k.js';
+import { k as Provider } from './ir-DYpvUSEw.js';
 import { IntentArchetypeName } from './dialect.js';
 
 /**
@@ -118,6 +118,33 @@ interface ModelProfile {
      * alpha.9.
      */
     archetypePerf?: Partial<Record<IntentArchetypeName, number>>;
+    /**
+     * alpha.41 — model-family identifier (e.g. `'claude-opus'`,
+     * `'gemini-flash'`). Reads through from `kgauto_models.family` (migration
+     * 024). When unset on a brain row, runtime falls back to
+     * `deriveFamilyFromModelId(model.id)` (see `family-resolution.ts`).
+     *
+     * Used by `getRecommendedPrimary({ family, ... })` and the IR-level
+     * `{ family: string }` chain entry resolution at compile time.
+     */
+    family?: string;
+    /**
+     * alpha.41 — version string of the kgauto release that first introduced
+     * this profile (e.g. `'2.0.0-alpha.36'`). Threaded through from the brain
+     * row's `version_added` column. Family-resolution sorts candidates by
+     * `version_added DESC` (lexicographic) as the secondary tiebreaker after
+     * `archetypePerf[archetype]`. Undefined on bundled profiles (no brain
+     * row).
+     */
+    versionAdded?: string;
+    /**
+     * alpha.41 — whether the brain row is `active = TRUE`. False or undefined
+     * means the model is retired / not actively served (kgauto_models row
+     * exists but won't be selected by family resolution). Bundled profiles
+     * default to `true` when not threaded through (every PROFILES_RAW entry
+     * is by definition the active source of truth at bundle time).
+     */
+    active?: boolean;
 }
 declare const ALIASES: Record<string, string>;
 interface ProfileBrainHook {

package/dist/{types-HEl2tS4P.d.ts → types-C8gOJ7hV.d.ts}

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

package/dist/{types-kzYpX7wB.d.mts → types-CYY769Ls.d.mts}

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

package/dist/{types-CsFP-H-U.d.ts → types-DigtHnEt.d.ts}

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

package/dist/{types-f7idIVsm.d.mts → types-MkiWUPM8.d.mts}

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

package/package.json

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