@genesislcap/foundation-ai 15.33.1-GENC-1601.2 → 15.34.0

package/dist/dts/tiers/ai-tiers.d.ts

@@ -101,8 +101,10 @@ export interface AITiers {
  * a fresh object for callers that override, and hands this back untouched for callers that
  * do not.
  *
- * The models are the ones Genesis Create has been running these tiers on in production, and
- * they are a **benchmark result, not a preference** — re-bench before moving one. Two dates
+ * The models are the ones Genesis Create has been running these tiers on in production — except
+ * Anthropic's `reasoning`, moved to `claude-opus-4-8` (see its entry) — and they are a
+ * **benchmark result, not a preference**: re-bench before moving one. Two of the Gemini
+ * defaults carry a caveat recorded beside them, a preview model and an introductory rate. Two dates
  * are already on the calendar for that: `gemini-3.8-flash` sits on an introductory rate that
  * doubles on 2027-01-01 (at which point it is dearer on input than the model it replaced),
  * and `token-cost.test.ts` fails the build that day; `ai-tiers.test.ts` fails alongside it
@@ -129,14 +131,21 @@ export interface AITierOverrides {
  * clocks and ceilings.
  *
  * @remarks
- * Returns the frozen default itself when there is nothing to override, and a fresh
- * (unfrozen) object otherwise. Either way the default is never mutated, which matters
- * because it is shared across every app in the process.
+ * An override field set to `undefined` is skipped, exactly as if it had been left out. The
+ * common caller passes an optional config value straight through
+ * (`{ high: { model: appConfig.model } }`), and copying `undefined` over the default would
+ * hand the transport no model at all — it then quietly falls back to its own default, with
+ * nothing logged.
+ *
+ * The result is frozen whether or not anything was overridden, so whether mutating it throws
+ * does not depend on what the caller passed. The default itself is returned untouched when
+ * there is nothing to override, and is never mutated, which matters because it is shared
+ * across every app in the process.
  *
  * @example
  * ```ts
- * // Keep everything, but run the reasoning tier on the newest Opus.
- * const tiers = resolveAITiers({ anthropic: { reasoning: { model: 'claude-opus-4-8' } } });
+ * // Keep everything, but run the reasoning tier on Fable.
+ * const tiers = resolveAITiers({ anthropic: { reasoning: { model: 'claude-fable-5' } } });
  * ```
  *
  * @beta

package/dist/dts/tiers/ai-tiers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-tiers.d.ts","sourceRoot":"","sources":["../../../src/tiers/ai-tiers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEhE;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,uCAAwC,CAAC;AAEjE;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,kCAAmC,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,gBAAgB,CAAC;IACxB;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;CAC5C;AAsBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,gBAAgB,EAAE,OA2ClB,CAAC;AAEd;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACpE,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAC/D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,eAAe,GAAG,OAAO,CAMnE"}
+{"version":3,"file":"ai-tiers.d.ts","sourceRoot":"","sources":["../../../src/tiers/ai-tiers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEhE;;;;;;;;;;;;GAYG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,uCAAwC,CAAC;AAEjE;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,kCAAmC,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,gBAAgB,CAAC;IACxB;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;CAC5C;AAsBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAsD7B,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACpE,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAC/D;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,eAAe,GAAG,OAAO,CAMnE"}

package/dist/esm/tiers/ai-tiers.js

@@ -55,8 +55,10 @@ const AI_NO_RESPONSE_TIMEOUT_MS = 300000;
  * a fresh object for callers that override, and hands this back untouched for callers that
  * do not.
  *
- * The models are the ones Genesis Create has been running these tiers on in production, and
- * they are a **benchmark result, not a preference** — re-bench before moving one. Two dates
+ * The models are the ones Genesis Create has been running these tiers on in production — except
+ * Anthropic's `reasoning`, moved to `claude-opus-4-8` (see its entry) — and they are a
+ * **benchmark result, not a preference**: re-bench before moving one. Two of the Gemini
+ * defaults carry a caveat recorded beside them, a preview model and an introductory rate. Two dates
  * are already on the calendar for that: `gemini-3.8-flash` sits on an introductory rate that
  * doubles on 2027-01-01 (at which point it is dearer on input than the model it replaced),
  * and `token-cost.test.ts` fails the build that day; `ai-tiers.test.ts` fails alongside it
@@ -86,8 +88,12 @@ export const DEFAULT_AI_TIERS = Object.freeze({
         }),
         // One-shot judgement calls rather than tool loops, so a smaller ceiling is ample:
         // `max_tokens` is only a cap, and this tier never emits a whole file.
+        //
+        // Opus 4.8 rather than the 4.7 Create benched: the same price ($5 / $25) and the same 1M
+        // window, but 4.8 supports native structured output where 4.7 takes the forced-tool
+        // fallback — and structured judgement is what this tier is asked for most (review of #2540).
         reasoning: Object.freeze({
-            model: 'claude-opus-4-7',
+            model: 'claude-opus-4-8',
             maxTokens: 32000,
             stallTimeoutMs: AI_STALL_TIMEOUT_MS,
             timeoutMs: AI_NO_RESPONSE_TIMEOUT_MS,
@@ -99,11 +105,18 @@ export const DEFAULT_AI_TIERS = Object.freeze({
             stallTimeoutMs: AI_STALL_TIMEOUT_MS,
             timeoutMs: AI_NO_RESPONSE_TIMEOUT_MS,
         }),
+        // On an INTRODUCTORY rate that doubles to $1.50 / $7.50 on 2027-01-01, from which point it
+        // is dearer on input than the gemini-3.5-flash it replaced. Chosen at the introductory rate
+        // knowingly; `ai-tiers.test.ts` fails that day to force the re-bench.
         high: Object.freeze({
             model: 'gemini-3.8-flash',
             stallTimeoutMs: AI_STALL_TIMEOUT_MS,
             timeoutMs: AI_NO_RESPONSE_TIMEOUT_MS,
         }),
+        // A PREVIEW model: no stability guarantee, and it may be withdrawn at short notice (its
+        // transport warns on every construction). Accepted knowingly as the platform default because
+        // no stable Gemini Pro was on offer when the tiers were benched; revisit as soon as Google
+        // promotes, deprecates or withdraws it, since every app on this default inherits the risk.
         reasoning: Object.freeze({
             model: 'gemini-3.1-pro-preview',
             stallTimeoutMs: AI_STALL_TIMEOUT_MS,
@@ -117,14 +130,21 @@ export const DEFAULT_AI_TIERS = Object.freeze({
  * clocks and ceilings.
  *
  * @remarks
- * Returns the frozen default itself when there is nothing to override, and a fresh
- * (unfrozen) object otherwise. Either way the default is never mutated, which matters
- * because it is shared across every app in the process.
+ * An override field set to `undefined` is skipped, exactly as if it had been left out. The
+ * common caller passes an optional config value straight through
+ * (`{ high: { model: appConfig.model } }`), and copying `undefined` over the default would
+ * hand the transport no model at all — it then quietly falls back to its own default, with
+ * nothing logged.
+ *
+ * The result is frozen whether or not anything was overridden, so whether mutating it throws
+ * does not depend on what the caller passed. The default itself is returned untouched when
+ * there is nothing to override, and is never mutated, which matters because it is shared
+ * across every app in the process.
  *
  * @example
  * ```ts
- * // Keep everything, but run the reasoning tier on the newest Opus.
- * const tiers = resolveAITiers({ anthropic: { reasoning: { model: 'claude-opus-4-8' } } });
+ * // Keep everything, but run the reasoning tier on Fable.
+ * const tiers = resolveAITiers({ anthropic: { reasoning: { model: 'claude-fable-5' } } });
  * ```
  *
  * @beta
@@ -132,15 +152,22 @@ export const DEFAULT_AI_TIERS = Object.freeze({
 export function resolveAITiers(overrides) {
     if (!(overrides === null || overrides === void 0 ? void 0 : overrides.anthropic) && !(overrides === null || overrides === void 0 ? void 0 : overrides.gemini))
         return DEFAULT_AI_TIERS;
-    return {
+    return Object.freeze({
         anthropic: mergeVendor(DEFAULT_AI_TIERS.anthropic, overrides.anthropic),
         gemini: mergeVendor(DEFAULT_AI_TIERS.gemini, overrides.gemini),
-    };
+    });
 }
 function mergeVendor(defaults, overrides) {
+    var _a;
     const merged = {};
     for (const tier of AI_TIER_IDS) {
-        merged[tier] = Object.assign(Object.assign({}, defaults[tier]), overrides === null || overrides === void 0 ? void 0 : overrides[tier]);
+        const defined = Object.fromEntries(Object.entries((_a = overrides === null || overrides === void 0 ? void 0 : overrides[tier]) !== null && _a !== void 0 ? _a : {}).filter(([, value]) => value !== undefined));
+        // Frozen in place rather than through `Object.freeze`'s return value, whose overloads
+        // widen a generic `T` to an index signature; the typed reference is the one we keep.
+        const entry = Object.assign(Object.assign({}, defaults[tier]), defined);
+        Object.freeze(entry);
+        merged[tier] = entry;
     }
+    Object.freeze(merged);
     return merged;
 }

package/dist/foundation-ai.api.json

@@ -9484,7 +9484,7 @@
         {
           "kind": "Variable",
           "canonicalReference": "@genesislcap/foundation-ai!DEFAULT_AI_TIERS:var",
-          "docComment": "/**\n * The platform's default tier table.\n *\n * @remarks\n *\n * Frozen, because it is shared by every app in the process: {@link resolveAITiers} returns a fresh object for callers that override, and hands this back untouched for callers that do not.\n *\n * The models are the ones Genesis Create has been running these tiers on in production, and they are a **benchmark result, not a preference** — re-bench before moving one. Two dates are already on the calendar for that: `gemini-3.8-flash` sits on an introductory rate that doubles on 2027-01-01 (at which point it is dearer on input than the model it replaced), and `token-cost.test.ts` fails the build that day; `ai-tiers.test.ts` fails alongside it saying the High tier is the thing to re-bench.\n *\n * Every model here must be in `SUPPORTED_*_MODEL_IDS` with a context limit and a price — pinned by tests, because an unpriced model silently bills at nothing.\n *\n * @beta\n */\n",
+          "docComment": "/**\n * The platform's default tier table.\n *\n * @remarks\n *\n * Frozen, because it is shared by every app in the process: {@link resolveAITiers} returns a fresh object for callers that override, and hands this back untouched for callers that do not.\n *\n * The models are the ones Genesis Create has been running these tiers on in production — except Anthropic's `reasoning`, moved to `claude-opus-4-8` (see its entry) — and they are a **benchmark result, not a preference**: re-bench before moving one. Two of the Gemini defaults carry a caveat recorded beside them, a preview model and an introductory rate. Two dates are already on the calendar for that: `gemini-3.8-flash` sits on an introductory rate that doubles on 2027-01-01 (at which point it is dearer on input than the model it replaced), and `token-cost.test.ts` fails the build that day; `ai-tiers.test.ts` fails alongside it saying the High tier is the thing to re-bench.\n *\n * Every model here must be in `SUPPORTED_*_MODEL_IDS` with a context limit and a price — pinned by tests, because an unpriced model silently bills at nothing.\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -13099,7 +13099,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@genesislcap/foundation-ai!resolveAITiers:function(1)",
-          "docComment": "/**\n * The table an app should actually use: {@link DEFAULT_AI_TIERS} with `overrides` applied per field, so an app that wants one model moved says only that and keeps the platform's clocks and ceilings.\n *\n * @remarks\n *\n * Returns the frozen default itself when there is nothing to override, and a fresh (unfrozen) object otherwise. Either way the default is never mutated, which matters because it is shared across every app in the process.\n *\n * @example\n * ```ts\n * // Keep everything, but run the reasoning tier on the newest Opus.\n * const tiers = resolveAITiers({ anthropic: { reasoning: { model: 'claude-opus-4-8' } } });\n * ```\n *\n * @beta\n */\n",
+          "docComment": "/**\n * The table an app should actually use: {@link DEFAULT_AI_TIERS} with `overrides` applied per field, so an app that wants one model moved says only that and keeps the platform's clocks and ceilings.\n *\n * @remarks\n *\n * An override field set to `undefined` is skipped, exactly as if it had been left out. The common caller passes an optional config value straight through (`{ high: { model: appConfig.model } }`), and copying `undefined` over the default would hand the transport no model at all — it then quietly falls back to its own default, with nothing logged.\n *\n * The result is frozen whether or not anything was overridden, so whether mutating it throws does not depend on what the caller passed. The default itself is returned untouched when there is nothing to override, and is never mutated, which matters because it is shared across every app in the process.\n *\n * @example\n * ```ts\n * // Keep everything, but run the reasoning tier on Fable.\n * const tiers = resolveAITiers({ anthropic: { reasoning: { model: 'claude-fable-5' } } });\n * ```\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",

package/dist/foundation-ai.d.ts

@@ -2551,8 +2551,10 @@ export declare interface CriteriaInterpretContext {
  * a fresh object for callers that override, and hands this back untouched for callers that
  * do not.
  *
- * The models are the ones Genesis Create has been running these tiers on in production, and
- * they are a **benchmark result, not a preference** — re-bench before moving one. Two dates
+ * The models are the ones Genesis Create has been running these tiers on in production — except
+ * Anthropic's `reasoning`, moved to `claude-opus-4-8` (see its entry) — and they are a
+ * **benchmark result, not a preference**: re-bench before moving one. Two of the Gemini
+ * defaults carry a caveat recorded beside them, a preview model and an introductory rate. Two dates
  * are already on the calendar for that: `gemini-3.8-flash` sits on an introductory rate that
  * doubles on 2027-01-01 (at which point it is dearer on input than the model it replaced),
  * and `token-cost.test.ts` fails the build that day; `ai-tiers.test.ts` fails alongside it
@@ -3402,14 +3404,21 @@ export declare interface ResolveAIConfigOptions {
  * clocks and ceilings.
  *
  * @remarks
- * Returns the frozen default itself when there is nothing to override, and a fresh
- * (unfrozen) object otherwise. Either way the default is never mutated, which matters
- * because it is shared across every app in the process.
+ * An override field set to `undefined` is skipped, exactly as if it had been left out. The
+ * common caller passes an optional config value straight through
+ * (`{ high: { model: appConfig.model } }`), and copying `undefined` over the default would
+ * hand the transport no model at all — it then quietly falls back to its own default, with
+ * nothing logged.
+ *
+ * The result is frozen whether or not anything was overridden, so whether mutating it throws
+ * does not depend on what the caller passed. The default itself is returned untouched when
+ * there is nothing to override, and is never mutated, which matters because it is shared
+ * across every app in the process.
  *
  * @example
  * ```ts
- * // Keep everything, but run the reasoning tier on the newest Opus.
- * const tiers = resolveAITiers({ anthropic: { reasoning: { model: 'claude-opus-4-8' } } });
+ * // Keep everything, but run the reasoning tier on Fable.
+ * const tiers = resolveAITiers({ anthropic: { reasoning: { model: 'claude-fable-5' } } });
  * ```
  *
  * @beta

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-ai",
   "description": "Genesis Foundation AI - Provider-agnostic AI configuration and shared utilities",
-  "version": "15.33.1-GENC-1601.2",
+  "version": "15.34.0",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -52,17 +52,17 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "15.33.1-GENC-1601.2",
-    "@genesislcap/genx": "15.33.1-GENC-1601.2",
-    "@genesislcap/rollup-builder": "15.33.1-GENC-1601.2",
-    "@genesislcap/ts-builder": "15.33.1-GENC-1601.2",
-    "@genesislcap/uvu-playwright-builder": "15.33.1-GENC-1601.2",
-    "@genesislcap/vite-builder": "15.33.1-GENC-1601.2",
-    "@genesislcap/webpack-builder": "15.33.1-GENC-1601.2"
+    "@genesislcap/foundation-testing": "15.34.0",
+    "@genesislcap/genx": "15.34.0",
+    "@genesislcap/rollup-builder": "15.34.0",
+    "@genesislcap/ts-builder": "15.34.0",
+    "@genesislcap/uvu-playwright-builder": "15.34.0",
+    "@genesislcap/vite-builder": "15.34.0",
+    "@genesislcap/webpack-builder": "15.34.0"
   },
   "dependencies": {
-    "@genesislcap/foundation-logger": "15.33.1-GENC-1601.2",
-    "@genesislcap/foundation-utils": "15.33.1-GENC-1601.2",
+    "@genesislcap/foundation-logger": "15.34.0",
+    "@genesislcap/foundation-utils": "15.34.0",
     "@microsoft/fast-foundation": "2.50.0"
   },
   "repository": {