@genesislcap/foundation-ai 15.33.1 → 15.34.1

package/dist/foundation-ai.api.json

@@ -378,6 +378,52 @@
             "endIndex": 0
           }
         },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@genesislcap/foundation-ai!AI_TIER_IDS:var",
+          "docComment": "/**\n * Every tier id, in ascending capability order.\n *\n * This array is the source of truth and {@link AITierId} is derived from it, so the two cannot drift: a tier exists exactly when it is listed here. That matters because the provider builders and the table's tests all loop over this array — a tier missing from it would get no provider and no test, with nothing to say so.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "AI_TIER_IDS: "
+            },
+            {
+              "kind": "Content",
+              "text": "readonly [\"low\", \"high\", \"reasoning\"]"
+            }
+          ],
+          "fileUrlPath": "src/tiers/ai-tiers.ts",
+          "isReadonly": true,
+          "releaseTag": "Beta",
+          "name": "AI_TIER_IDS",
+          "variableTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          }
+        },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@genesislcap/foundation-ai!AI_TIER_VENDORS:var",
+          "docComment": "/**\n * Every vendor in the table — the two the platform's proxy meters. The source of truth for {@link AITierVendor}, for the same reason as {@link AI_TIER_IDS}.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "AI_TIER_VENDORS: "
+            },
+            {
+              "kind": "Content",
+              "text": "readonly [\"anthropic\", \"gemini\"]"
+            }
+          ],
+          "fileUrlPath": "src/tiers/ai-tiers.ts",
+          "isReadonly": true,
+          "releaseTag": "Beta",
+          "name": "AI_TIER_VENDORS",
+          "variableTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          }
+        },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@genesislcap/foundation-ai!AIConfig:type",
@@ -1416,149 +1462,108 @@
           "extendsTokenRanges": []
         },
         {
-          "kind": "Variable",
-          "canonicalReference": "@genesislcap/foundation-ai!ANTHROPIC_CACHE_READ_MULTIPLIER:var",
-          "docComment": "/**\n * Prompt-cache pricing multipliers, applied to the model's base input rate (`promptPerMillion`) — https://docs.claude.com/en/docs/build-with-claude/prompt-caching Reads bill at ~0.1× base input; writes bill by TTL — 5-minute at ~1.25× and 1-hour at 2×. Both write TTLs are reachable (`CachePolicy.ttl` is `'5m' | '1h'`), so each TTL bucket is costed from the response's per-TTL `cache_creation` breakdown rather than assuming one rate.\n *\n * @beta\n */\n",
+          "kind": "TypeAlias",
+          "canonicalReference": "@genesislcap/foundation-ai!AITierId:type",
+          "docComment": "/**\n * The tier a caller asks for, rather than a model id.\n *\n * Tier-shaped names are what let an app swap vendor (or re-bench a tier onto a newer model) without touching a single agent config — agents resolve `'high'`, not `claude-sonnet-5`. Derived from {@link AI_TIER_IDS}.\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "ANTHROPIC_CACHE_READ_MULTIPLIER = "
+              "text": "export type AITierId = "
             },
             {
               "kind": "Content",
-              "text": "0.1"
-            }
-          ],
-          "fileUrlPath": "src/utils/token-cost.ts",
-          "initializerTokenRange": {
-            "startIndex": 1,
-            "endIndex": 2
-          },
-          "isReadonly": true,
-          "releaseTag": "Beta",
-          "name": "ANTHROPIC_CACHE_READ_MULTIPLIER",
-          "variableTypeTokenRange": {
-            "startIndex": 0,
-            "endIndex": 0
-          }
-        },
-        {
-          "kind": "Variable",
-          "canonicalReference": "@genesislcap/foundation-ai!ANTHROPIC_CACHE_WRITE_1H_MULTIPLIER:var",
-          "docComment": "/**\n * @beta\n */\n",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "ANTHROPIC_CACHE_WRITE_1H_MULTIPLIER = "
+              "text": "(typeof "
             },
             {
-              "kind": "Content",
-              "text": "2"
-            }
-          ],
-          "fileUrlPath": "src/utils/token-cost.ts",
-          "initializerTokenRange": {
-            "startIndex": 1,
-            "endIndex": 2
-          },
-          "isReadonly": true,
-          "releaseTag": "Beta",
-          "name": "ANTHROPIC_CACHE_WRITE_1H_MULTIPLIER",
-          "variableTypeTokenRange": {
-            "startIndex": 0,
-            "endIndex": 0
-          }
-        },
-        {
-          "kind": "Variable",
-          "canonicalReference": "@genesislcap/foundation-ai!ANTHROPIC_CACHE_WRITE_5M_MULTIPLIER:var",
-          "docComment": "/**\n * @beta\n */\n",
-          "excerptTokens": [
+              "kind": "Reference",
+              "text": "AI_TIER_IDS",
+              "canonicalReference": "@genesislcap/foundation-ai!AI_TIER_IDS:var"
+            },
             {
               "kind": "Content",
-              "text": "ANTHROPIC_CACHE_WRITE_5M_MULTIPLIER = "
+              "text": ")[number]"
             },
             {
               "kind": "Content",
-              "text": "1.25"
+              "text": ";"
             }
           ],
-          "fileUrlPath": "src/utils/token-cost.ts",
-          "initializerTokenRange": {
-            "startIndex": 1,
-            "endIndex": 2
-          },
-          "isReadonly": true,
+          "fileUrlPath": "src/tiers/ai-tiers.ts",
           "releaseTag": "Beta",
-          "name": "ANTHROPIC_CACHE_WRITE_5M_MULTIPLIER",
-          "variableTypeTokenRange": {
-            "startIndex": 0,
-            "endIndex": 0
+          "name": "AITierId",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 4
           }
         },
         {
           "kind": "Interface",
-          "canonicalReference": "@genesislcap/foundation-ai!AnthropicAIConfig:interface",
-          "docComment": "/**\n * Anthropic server-proxy AI configuration (client calls your server; server calls Anthropic).\n *\n * @remarks\n *\n * API key stays on the server. URL defaults to `/gwf/ai-service/anthropic/chat`. When `apiKey` is provided, the transport calls `api.anthropic.com/v1/messages` directly (browser direct calls require `anthropic-dangerous-direct-browser-access: true`, which the transport sends automatically — only use this in trusted contexts).\n *\n * @beta\n */\n",
+          "canonicalReference": "@genesislcap/foundation-ai!AITierOverrides:interface",
+          "docComment": "/**\n * Per-tier overrides, shallow-merged field by field over the defaults.\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export interface AnthropicAIConfig extends "
-            },
-            {
-              "kind": "Reference",
-              "text": "AIProviderConfig",
-              "canonicalReference": "@genesislcap/foundation-ai!~AIProviderConfig:interface"
-            },
-            {
-              "kind": "Content",
-              "text": " "
+              "text": "export interface AITierOverrides "
             }
           ],
-          "fileUrlPath": "src/types/config.types.ts",
+          "fileUrlPath": "src/tiers/ai-tiers.ts",
           "releaseTag": "Beta",
-          "name": "AnthropicAIConfig",
+          "name": "AITierOverrides",
           "preserveMemberOrder": false,
           "members": [
             {
               "kind": "PropertySignature",
-              "canonicalReference": "@genesislcap/foundation-ai!AnthropicAIConfig#apiKey:member",
+              "canonicalReference": "@genesislcap/foundation-ai!AITierOverrides#anthropic:member",
               "docComment": "",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "apiKey?: "
+                  "text": "anthropic?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Partial",
+                  "canonicalReference": "!Partial:type"
                 },
                 {
                   "kind": "Content",
-                  "text": "string"
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
                 },
                 {
                   "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": true,
-              "releaseTag": "Beta",
-              "name": "apiKey",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              }
-            },
-            {
-              "kind": "PropertySignature",
-              "canonicalReference": "@genesislcap/foundation-ai!AnthropicAIConfig#maxTokens:member",
-              "docComment": "/**\n * Hard cap on tokens generated per response. Anthropic's `max_tokens` is a required field on every request. Defaults to 4096.\n */\n",
-              "excerptTokens": [
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AITierId",
+                  "canonicalReference": "@genesislcap/foundation-ai!AITierId:type"
+                },
                 {
                   "kind": "Content",
-                  "text": "maxTokens?: "
+                  "text": ", "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Partial",
+                  "canonicalReference": "!Partial:type"
                 },
                 {
                   "kind": "Content",
-                  "text": "number"
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AnthropicTierConfig",
+                  "canonicalReference": "@genesislcap/foundation-ai!AnthropicTierConfig:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">>>"
                 },
                 {
                   "kind": "Content",
@@ -1568,25 +1573,65 @@
               "isReadonly": false,
               "isOptional": true,
               "releaseTag": "Beta",
-              "name": "maxTokens",
+              "name": "anthropic",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 2
+                "endIndex": 11
               }
             },
             {
               "kind": "PropertySignature",
-              "canonicalReference": "@genesislcap/foundation-ai!AnthropicAIConfig#model:member",
-              "docComment": "/**\n * Defaults to `claude-haiku-4-5-20251001`. Only {@link SUPPORTED_ANTHROPIC_MODEL_IDS} are accepted at runtime.\n */\n",
+              "canonicalReference": "@genesislcap/foundation-ai!AITierOverrides#gemini:member",
+              "docComment": "",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "model?: "
+                  "text": "gemini?: "
                 },
                 {
                   "kind": "Reference",
-                  "text": "AnthropicModelId",
-                  "canonicalReference": "@genesislcap/foundation-ai!AnthropicModelId:type"
+                  "text": "Partial",
+                  "canonicalReference": "!Partial:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AITierId",
+                  "canonicalReference": "@genesislcap/foundation-ai!AITierId:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Partial",
+                  "canonicalReference": "!Partial:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "GeminiTierConfig",
+                  "canonicalReference": "@genesislcap/foundation-ai!GeminiTierConfig:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">>>"
                 },
                 {
                   "kind": "Content",
@@ -1596,24 +1641,65 @@
               "isReadonly": false,
               "isOptional": true,
               "releaseTag": "Beta",
-              "name": "model",
+              "name": "gemini",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 2
+                "endIndex": 11
               }
-            },
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/foundation-ai!AITiers:interface",
+          "docComment": "/**\n * The whole table: every tier, for every vendor.\n *\n * Total records, not partials — a tier a vendor cannot serve is not a tier, it is a gap that only shows up when an agent resolves it at runtime.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface AITiers "
+            }
+          ],
+          "fileUrlPath": "src/tiers/ai-tiers.ts",
+          "releaseTag": "Beta",
+          "name": "AITiers",
+          "preserveMemberOrder": false,
+          "members": [
             {
               "kind": "PropertySignature",
-              "canonicalReference": "@genesislcap/foundation-ai!AnthropicAIConfig#providerType:member",
+              "canonicalReference": "@genesislcap/foundation-ai!AITiers#anthropic:member",
               "docComment": "",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "providerType: "
+                  "text": "anthropic: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
                 },
                 {
                   "kind": "Content",
-                  "text": "'anthropic'"
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AITierId",
+                  "canonicalReference": "@genesislcap/foundation-ai!AITierId:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AnthropicTierConfig",
+                  "canonicalReference": "@genesislcap/foundation-ai!AnthropicTierConfig:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
                 },
                 {
                   "kind": "Content",
@@ -1623,31 +1709,333 @@
               "isReadonly": false,
               "isOptional": false,
               "releaseTag": "Beta",
-              "name": "providerType",
+              "name": "anthropic",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 2
+                "endIndex": 7
               }
             },
             {
               "kind": "PropertySignature",
-              "canonicalReference": "@genesislcap/foundation-ai!AnthropicAIConfig#serverEndpoint:member",
+              "canonicalReference": "@genesislcap/foundation-ai!AITiers#gemini:member",
               "docComment": "",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "serverEndpoint?: "
+                  "text": "gemini: "
                 },
                 {
-                  "kind": "Content",
-                  "text": "string"
+                  "kind": "Reference",
+                  "text": "Record",
+                  "canonicalReference": "!Record:type"
                 },
                 {
                   "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AITierId",
+                  "canonicalReference": "@genesislcap/foundation-ai!AITierId:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "GeminiTierConfig",
+                  "canonicalReference": "@genesislcap/foundation-ai!GeminiTierConfig:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "gemini",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 7
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@genesislcap/foundation-ai!AITierVendor:type",
+          "docComment": "/**\n * The cloud vendors the tier table covers. Derived from {@link AI_TIER_VENDORS}.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type AITierVendor = "
+            },
+            {
+              "kind": "Content",
+              "text": "(typeof "
+            },
+            {
+              "kind": "Reference",
+              "text": "AI_TIER_VENDORS",
+              "canonicalReference": "@genesislcap/foundation-ai!AI_TIER_VENDORS:var"
+            },
+            {
+              "kind": "Content",
+              "text": ")[number]"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/tiers/ai-tiers.ts",
+          "releaseTag": "Beta",
+          "name": "AITierVendor",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 4
+          }
+        },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@genesislcap/foundation-ai!ANTHROPIC_CACHE_READ_MULTIPLIER:var",
+          "docComment": "/**\n * Prompt-cache pricing multipliers, applied to the model's base input rate (`promptPerMillion`) — https://docs.claude.com/en/docs/build-with-claude/prompt-caching Reads bill at ~0.1× base input; writes bill by TTL — 5-minute at ~1.25× and 1-hour at 2×. Both write TTLs are reachable (`CachePolicy.ttl` is `'5m' | '1h'`), so each TTL bucket is costed from the response's per-TTL `cache_creation` breakdown rather than assuming one rate.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "ANTHROPIC_CACHE_READ_MULTIPLIER = "
+            },
+            {
+              "kind": "Content",
+              "text": "0.1"
+            }
+          ],
+          "fileUrlPath": "src/utils/token-cost.ts",
+          "initializerTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          },
+          "isReadonly": true,
+          "releaseTag": "Beta",
+          "name": "ANTHROPIC_CACHE_READ_MULTIPLIER",
+          "variableTypeTokenRange": {
+            "startIndex": 0,
+            "endIndex": 0
+          }
+        },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@genesislcap/foundation-ai!ANTHROPIC_CACHE_WRITE_1H_MULTIPLIER:var",
+          "docComment": "/**\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "ANTHROPIC_CACHE_WRITE_1H_MULTIPLIER = "
+            },
+            {
+              "kind": "Content",
+              "text": "2"
+            }
+          ],
+          "fileUrlPath": "src/utils/token-cost.ts",
+          "initializerTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          },
+          "isReadonly": true,
+          "releaseTag": "Beta",
+          "name": "ANTHROPIC_CACHE_WRITE_1H_MULTIPLIER",
+          "variableTypeTokenRange": {
+            "startIndex": 0,
+            "endIndex": 0
+          }
+        },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@genesislcap/foundation-ai!ANTHROPIC_CACHE_WRITE_5M_MULTIPLIER:var",
+          "docComment": "/**\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "ANTHROPIC_CACHE_WRITE_5M_MULTIPLIER = "
+            },
+            {
+              "kind": "Content",
+              "text": "1.25"
+            }
+          ],
+          "fileUrlPath": "src/utils/token-cost.ts",
+          "initializerTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          },
+          "isReadonly": true,
+          "releaseTag": "Beta",
+          "name": "ANTHROPIC_CACHE_WRITE_5M_MULTIPLIER",
+          "variableTypeTokenRange": {
+            "startIndex": 0,
+            "endIndex": 0
+          }
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/foundation-ai!AnthropicAIConfig:interface",
+          "docComment": "/**\n * Anthropic server-proxy AI configuration (client calls your server; server calls Anthropic).\n *\n * @remarks\n *\n * API key stays on the server. URL defaults to `/gwf/ai-service/anthropic/chat`. When `apiKey` is provided, the transport calls `api.anthropic.com/v1/messages` directly (browser direct calls require `anthropic-dangerous-direct-browser-access: true`, which the transport sends automatically — only use this in trusted contexts).\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface AnthropicAIConfig extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "AIProviderConfig",
+              "canonicalReference": "@genesislcap/foundation-ai!~AIProviderConfig:interface"
+            },
+            {
+              "kind": "Content",
+              "text": " "
+            }
+          ],
+          "fileUrlPath": "src/types/config.types.ts",
+          "releaseTag": "Beta",
+          "name": "AnthropicAIConfig",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-ai!AnthropicAIConfig#apiKey:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "apiKey?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "apiKey",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-ai!AnthropicAIConfig#maxTokens:member",
+              "docComment": "/**\n * Hard cap on tokens generated per response. Anthropic's `max_tokens` is a required field on every request. Defaults to 4096.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "maxTokens?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "maxTokens",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-ai!AnthropicAIConfig#model:member",
+              "docComment": "/**\n * Defaults to `claude-haiku-4-5-20251001`. Only {@link SUPPORTED_ANTHROPIC_MODEL_IDS} are accepted at runtime.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "model?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AnthropicModelId",
+                  "canonicalReference": "@genesislcap/foundation-ai!AnthropicModelId:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "model",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-ai!AnthropicAIConfig#providerType:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "providerType: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "'anthropic'"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "providerType",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-ai!AnthropicAIConfig#serverEndpoint:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "serverEndpoint?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
               "isOptional": true,
               "releaseTag": "Beta",
               "name": "serverEndpoint",
@@ -2131,88 +2519,215 @@
               "overloadIndex": 1,
               "parameters": [
                 {
-                  "parameterName": "history",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 1,
-                    "endIndex": 3
-                  },
-                  "isOptional": false
+                  "parameterName": "history",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 3
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "userMessage",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 4,
+                    "endIndex": 5
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 6,
+                    "endIndex": 7
+                  },
+                  "isOptional": true
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "streamChat"
+            }
+          ],
+          "implementsTokenRanges": [
+            {
+              "startIndex": 1,
+              "endIndex": 2
+            }
+          ]
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/foundation-ai!anthropicRatesFor:function(1)",
+          "docComment": "/**\n * Standard tier pricing per million tokens — https://docs.claude.com/en/docs/about-claude/pricing\n *\n * @remarks\n *\n * Backed by a total {@link https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type | Record} over `AnthropicModelId` rather than a chain of checks with a default. That is the whole point: adding a model to `SUPPORTED_ANTHROPIC_MODEL_IDS` without pricing it becomes a COMPILE error instead of a silent charge at whatever the fall-through happened to be — the exact failure this module's header warns about, and one a consumer has already been bitten by. The Gemini half of this file has always had the guarantee; this half now matches.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function anthropicRatesFor(model: "
+            },
+            {
+              "kind": "Reference",
+              "text": "AnthropicModelId",
+              "canonicalReference": "@genesislcap/foundation-ai!AnthropicModelId:type"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "TokenRates",
+              "canonicalReference": "@genesislcap/foundation-ai!TokenRates:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/utils/token-cost.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 4
+          },
+          "releaseTag": "Beta",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "model",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "anthropicRatesFor"
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/foundation-ai!AnthropicTierConfig:interface",
+          "docComment": "/**\n * What one tier is worth on Anthropic: the model, its output ceiling, and the two clocks.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface AnthropicTierConfig "
+            }
+          ],
+          "fileUrlPath": "src/tiers/ai-tiers.ts",
+          "releaseTag": "Beta",
+          "name": "AnthropicTierConfig",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-ai!AnthropicTierConfig#maxTokens:member",
+              "docComment": "/**\n * `max_tokens` for every request on this tier. Part of the tier, not an optional extra: Anthropic requires the field and the transport defaults it to 4096, which truncates a large single-call file write mid-stream (`stop_reason: max_tokens`) and leaves the tool input unparseable. Values sit inside each model's documented output ceiling.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "maxTokens: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "maxTokens",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-ai!AnthropicTierConfig#model:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "model: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AnthropicModelId",
+                  "canonicalReference": "@genesislcap/foundation-ai!AnthropicModelId:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "model",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-ai!AnthropicTierConfig#stallTimeoutMs:member",
+              "docComment": "/**\n * Inactivity window on a stream that has started.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "stallTimeoutMs: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "stallTimeoutMs",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-ai!AnthropicTierConfig#timeoutMs:member",
+              "docComment": "/**\n * Ceiling on the wait for the FIRST byte — a different clock from the stall one.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "timeoutMs: "
                 },
                 {
-                  "parameterName": "userMessage",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 4,
-                    "endIndex": 5
-                  },
-                  "isOptional": false
+                  "kind": "Content",
+                  "text": "number"
                 },
                 {
-                  "parameterName": "options",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 6,
-                    "endIndex": 7
-                  },
-                  "isOptional": true
+                  "kind": "Content",
+                  "text": ";"
                 }
               ],
+              "isReadonly": false,
               "isOptional": false,
-              "isAbstract": false,
-              "name": "streamChat"
-            }
-          ],
-          "implementsTokenRanges": [
-            {
-              "startIndex": 1,
-              "endIndex": 2
-            }
-          ]
-        },
-        {
-          "kind": "Function",
-          "canonicalReference": "@genesislcap/foundation-ai!anthropicRatesFor:function(1)",
-          "docComment": "/**\n * Standard tier pricing per million tokens — https://docs.claude.com/en/docs/about-claude/pricing\n *\n * @remarks\n *\n * Backed by a total {@link https://www.typescriptlang.org/docs/handbook/utility-types.html#recordkeys-type | Record} over `AnthropicModelId` rather than a chain of checks with a default. That is the whole point: adding a model to `SUPPORTED_ANTHROPIC_MODEL_IDS` without pricing it becomes a COMPILE error instead of a silent charge at whatever the fall-through happened to be — the exact failure this module's header warns about, and one a consumer has already been bitten by. The Gemini half of this file has always had the guarantee; this half now matches.\n *\n * @beta\n */\n",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "export declare function anthropicRatesFor(model: "
-            },
-            {
-              "kind": "Reference",
-              "text": "AnthropicModelId",
-              "canonicalReference": "@genesislcap/foundation-ai!AnthropicModelId:type"
-            },
-            {
-              "kind": "Content",
-              "text": "): "
-            },
-            {
-              "kind": "Reference",
-              "text": "TokenRates",
-              "canonicalReference": "@genesislcap/foundation-ai!TokenRates:interface"
-            },
-            {
-              "kind": "Content",
-              "text": ";"
-            }
-          ],
-          "fileUrlPath": "src/utils/token-cost.ts",
-          "returnTypeTokenRange": {
-            "startIndex": 3,
-            "endIndex": 4
-          },
-          "releaseTag": "Beta",
-          "overloadIndex": 1,
-          "parameters": [
-            {
-              "parameterName": "model",
-              "parameterTypeTokenRange": {
+              "releaseTag": "Beta",
+              "name": "timeoutMs",
+              "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
-              },
-              "isOptional": false
+              }
             }
           ],
-          "name": "anthropicRatesFor"
+          "extendsTokenRanges": []
         },
         {
           "kind": "Function",
@@ -3019,136 +3534,315 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/foundation-ai!BudgetExhaustedError#otherVendorAvailable:member",
+              "docComment": "/**\n * The proxy's own verdict on whether **any other** vendor it meters still has headroom, from the 402's `otherVendorAvailable`.\n *\n * The one field on this error a client cannot re-derive. A client can only infer \"another vendor is free\" from registry membership — which knows nothing about that vendor's remaining spend — so a `false` here is the only thing standing between the user and \"Switch to Gemini to keep going\" for a Gemini pot that is already empty. `undefined` means the proxy did not say (an older build), and the client is back to inferring.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly otherVendorAvailable?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "otherVendorAvailable",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/foundation-ai!BudgetExhaustedError#serverVendor:member",
+              "docComment": "/**\n * The vendor the **proxy** says it refused, verbatim from the 402's `vendor`.\n *\n * A second opinion, not the first: {@link BudgetExhaustedError.vendorLabel} comes from the transport that was actually called and wins wherever it resolves. This one rescues attribution when the transport's label does not — a white-labelled or multiplexing gateway whose single transport fronts more than one upstream stamps one static label for all of them, and only the proxy knows which pot the request was actually booked against.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly serverVendor?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "serverVendor",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/foundation-ai!BudgetExhaustedError#spentUsd:member",
+              "docComment": "/**\n * Spend already booked against that cap in USD, when the proxy reported it.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly spentUsd?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "spentUsd",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/foundation-ai!BudgetExhaustedError#vendorLabel:member",
+              "docComment": "/**\n * Vendor label of the transport that was refused (e.g. `'Anthropic'`).\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly vendorLabel: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "vendorLabel",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            }
+          ],
+          "extendsTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          },
+          "implementsTokenRanges": []
+        },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/foundation-ai!buildTierProviders:function(1)",
+          "docComment": "/**\n * Builds one {@link AIProvider} per tier for a vendor, ready to register under the tier names agents resolve (`low` / `high` / `reasoning`).\n *\n * @remarks\n *\n * Each provider carries its tier's model, output ceiling (Anthropic) and both clocks, so no tier can silently fall back to the transport defaults — which is how a large tool write ends up truncated at 4096 tokens.\n *\n * @example\n * ```ts\n * registerAIProviders(\n *   container,\n *   buildTierProviders({ vendor: 'gemini', serverEndpoint: (v) => `/gwf/ai-service/${v}/chat` }),\n *   { default: 'high' },\n * );\n * ```\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function buildTierProviders(options: "
+            },
+            {
+              "kind": "Reference",
+              "text": "BuildTierProvidersOptions",
+              "canonicalReference": "@genesislcap/foundation-ai!BuildTierProvidersOptions:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "Record",
+              "canonicalReference": "!Record:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "AITierId",
+              "canonicalReference": "@genesislcap/foundation-ai!AITierId:type"
+            },
+            {
+              "kind": "Content",
+              "text": ", "
+            },
+            {
+              "kind": "Reference",
+              "text": "AIProvider",
+              "canonicalReference": "@genesislcap/foundation-ai!AIProvider:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ">"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/tiers/build-tier-providers.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 9
+          },
+          "releaseTag": "Beta",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "options",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "buildTierProviders"
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/foundation-ai!BuildTierProvidersOptions:interface",
+          "docComment": "/**\n * Options for {@link buildTierProviders}.\n *\n * @beta\n */\n",
+          "excerptTokens": [
             {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/foundation-ai!BudgetExhaustedError#otherVendorAvailable:member",
-              "docComment": "/**\n * The proxy's own verdict on whether **any other** vendor it meters still has headroom, from the 402's `otherVendorAvailable`.\n *\n * The one field on this error a client cannot re-derive. A client can only infer \"another vendor is free\" from registry membership — which knows nothing about that vendor's remaining spend — so a `false` here is the only thing standing between the user and \"Switch to Gemini to keep going\" for a Gemini pot that is already empty. `undefined` means the proxy did not say (an older build), and the client is back to inferring.\n */\n",
+              "kind": "Content",
+              "text": "export interface BuildTierProvidersOptions "
+            }
+          ],
+          "fileUrlPath": "src/tiers/build-tier-providers.ts",
+          "releaseTag": "Beta",
+          "name": "BuildTierProvidersOptions",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-ai!BuildTierProvidersOptions#serverEndpoint:member",
+              "docComment": "/**\n * The proxy endpoint every tier posts to — a string, or a function of the vendor for a caller that builds more than one vendor from one rule (see the example below).\n *\n * Always a server endpoint, never an API key: these providers are meant for an app whose keys stay on its server. An empty endpoint throws here rather than at the first turn.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "readonly otherVendorAvailable?: "
+                  "text": "serverEndpoint: "
                 },
                 {
                   "kind": "Content",
-                  "text": "boolean"
+                  "text": "string | ((vendor: "
                 },
                 {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": true,
-              "isOptional": true,
-              "releaseTag": "Beta",
-              "name": "otherVendorAvailable",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/foundation-ai!BudgetExhaustedError#serverVendor:member",
-              "docComment": "/**\n * The vendor the **proxy** says it refused, verbatim from the 402's `vendor`.\n *\n * A second opinion, not the first: {@link BudgetExhaustedError.vendorLabel} comes from the transport that was actually called and wins wherever it resolves. This one rescues attribution when the transport's label does not — a white-labelled or multiplexing gateway whose single transport fronts more than one upstream stamps one static label for all of them, and only the proxy knows which pot the request was actually booked against.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "readonly serverVendor?: "
+                  "kind": "Reference",
+                  "text": "AITierVendor",
+                  "canonicalReference": "@genesislcap/foundation-ai!AITierVendor:type"
                 },
                 {
                   "kind": "Content",
-                  "text": "string"
+                  "text": ") => string)"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isReadonly": true,
-              "isOptional": true,
+              "isReadonly": false,
+              "isOptional": false,
               "releaseTag": "Beta",
-              "name": "serverVendor",
+              "name": "serverEndpoint",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
+                "endIndex": 4
+              }
             },
             {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/foundation-ai!BudgetExhaustedError#spentUsd:member",
-              "docComment": "/**\n * Spend already booked against that cap in USD, when the proxy reported it.\n */\n",
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-ai!BuildTierProvidersOptions#tiers:member",
+              "docComment": "/**\n * The table to build from. Defaults to {@link DEFAULT_AI_TIERS}.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "readonly spentUsd?: "
+                  "text": "tiers?: "
                 },
                 {
-                  "kind": "Content",
-                  "text": "number"
+                  "kind": "Reference",
+                  "text": "AITiers",
+                  "canonicalReference": "@genesislcap/foundation-ai!AITiers:interface"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isReadonly": true,
+              "isReadonly": false,
               "isOptional": true,
               "releaseTag": "Beta",
-              "name": "spentUsd",
+              "name": "tiers",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
+              }
             },
             {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/foundation-ai!BudgetExhaustedError#vendorLabel:member",
-              "docComment": "/**\n * Vendor label of the transport that was refused (e.g. `'Anthropic'`).\n */\n",
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-ai!BuildTierProvidersOptions#vendor:member",
+              "docComment": "/**\n * Which vendor's models to build.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "readonly vendorLabel: "
+                  "text": "vendor: "
                 },
                 {
-                  "kind": "Content",
-                  "text": "string"
+                  "kind": "Reference",
+                  "text": "AITierVendor",
+                  "canonicalReference": "@genesislcap/foundation-ai!AITierVendor:type"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isReadonly": true,
+              "isReadonly": false,
               "isOptional": false,
               "releaseTag": "Beta",
-              "name": "vendorLabel",
+              "name": "vendor",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
+              }
             }
           ],
-          "extendsTokenRange": {
-            "startIndex": 1,
-            "endIndex": 2
-          },
-          "implementsTokenRanges": []
+          "extendsTokenRanges": []
         },
         {
           "kind": "TypeAlias",
@@ -8787,6 +9481,30 @@
           ],
           "extendsTokenRanges": []
         },
+        {
+          "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 — 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",
+              "text": "DEFAULT_AI_TIERS: "
+            },
+            {
+              "kind": "Reference",
+              "text": "AITiers",
+              "canonicalReference": "@genesislcap/foundation-ai!AITiers:interface"
+            }
+          ],
+          "fileUrlPath": "src/tiers/ai-tiers.ts",
+          "isReadonly": true,
+          "releaseTag": "Beta",
+          "name": "DEFAULT_AI_TIERS",
+          "variableTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          }
+        },
         {
           "kind": "Variable",
           "canonicalReference": "@genesislcap/foundation-ai!DEFAULT_BUDGET_EXHAUSTED_MESSAGE:var",
@@ -9647,6 +10365,106 @@
           ],
           "name": "geminiRatesFor"
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/foundation-ai!GeminiTierConfig:interface",
+          "docComment": "/**\n * What one tier is worth on Gemini.\n *\n * No `maxTokens`: `GeminiAIConfig` has no such field and the provider's own (much larger) default applies, so Gemini writes never hit the Anthropic wall above.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface GeminiTierConfig "
+            }
+          ],
+          "fileUrlPath": "src/tiers/ai-tiers.ts",
+          "releaseTag": "Beta",
+          "name": "GeminiTierConfig",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-ai!GeminiTierConfig#model:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "model: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "GeminiModelId",
+                  "canonicalReference": "@genesislcap/foundation-ai!GeminiModelId:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "model",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-ai!GeminiTierConfig#stallTimeoutMs:member",
+              "docComment": "/**\n * Inactivity window on a stream that has started.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "stallTimeoutMs: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "stallTimeoutMs",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/foundation-ai!GeminiTierConfig#timeoutMs:member",
+              "docComment": "/**\n * Ceiling on the wait for the FIRST byte — a different clock from the stall one.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "timeoutMs: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "timeoutMs",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "Function",
           "canonicalReference": "@genesislcap/foundation-ai!geminiTokenCost:function(1)",
@@ -12278,6 +13096,53 @@
           ],
           "extendsTokenRanges": []
         },
+        {
+          "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 * 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",
+              "text": "export declare function resolveAITiers(overrides?: "
+            },
+            {
+              "kind": "Reference",
+              "text": "AITierOverrides",
+              "canonicalReference": "@genesislcap/foundation-ai!AITierOverrides:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "AITiers",
+              "canonicalReference": "@genesislcap/foundation-ai!AITiers:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/tiers/ai-tiers.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 4
+          },
+          "releaseTag": "Beta",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "overrides",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": true
+            }
+          ],
+          "name": "resolveAITiers"
+        },
         {
           "kind": "Class",
           "canonicalReference": "@genesislcap/foundation-ai!ResponseTruncatedError:class",