@genesislcap/ai-assistant 15.33.1 → 15.34.1

package/dist/ai-assistant.api.json

@@ -15014,7 +15014,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#setVendorBudget:member(1)",
-              "docComment": "/**\n * Feed (or clear) one vendor's AI-spend figures for the settings-modal budget meter — the numeric companion to {@link FoundationAiAssistant.setVendorBlocked}, and like it a host-driven write: the element meters nothing itself.\n *\n * The meter renders a row for exactly the vendors that currently HAVE figures. An **unlimited** vendor (the budget endpoint reports `unlimited: true` / `limitUsd: null`) is expressed by never feeding it — there is deliberately no \"unlimited\" figure shape, because a bar with no cap has nothing truthful to fill to. `spentUsd` MAY exceed `budgetUsd` (the last allowed call can overshoot the cap): the row's text shows the real figures and only the bar clamps.\n *\n * Returns `false` — and warns once, not per call — instead of throwing when `vendor` is not a budgeted vendor (`BUDGETED_VENDORS`, the proxy's own metered list) or either figure is not a finite number `>= 0`. Invalid input changes no state. Idempotent: re-feeding a vendor's current figures is a no-op, so hosts can re-feed unconditionally after every turn.\n *\n * `false` ALSO means \"not stored, because the element is not ready yet\": a feed that lands before the element has its session store (a host calling ahead of the first append, or during a pop-out remount) stores nothing and says so, rather than reporting a write that never happened. That case is transient and needs no host handling — the documented per-turn re-feed is what recovers it — so it is deliberately NOT warned about; the warn-once channel is for garbage input only.\n *\n * `figures` is nullish-checked at run time, so `undefined` behaves exactly like `null` and CLEARS that vendor's row. Untyped JS hosts feed this straight from `GET /api/budget`, where a per-vendor lookup that misses yields `undefined`, not `null` — and \"no figures\" coherently means \"no row\". The `| null` parameter type is unchanged for typed callers; the runtime is deliberately the more forgiving of the two.\n *\n * The intended feed is the platform budget endpoint:\n * ```ts\n * // `vendors` is an OBJECT keyed by vendor id, not an array.\n * const { vendors } = await (await fetch('/api/budget')).json();\n * for (const v of Object.values(vendors)) {\n *   if (v.unlimited || v.limitUsd == null) {\n *     assistantEl.setVendorBudget(v.vendor, null); // clear stale figures after a cap is lifted\n *     continue;\n *   }\n *   assistantEl.setVendorBudget(v.vendor, { budgetUsd: v.limitUsd, spentUsd: v.spentUsd });\n * }\n * ```\n *\n * Re-run it on mount and after each turn. Scope and lifetime follow the rest of the session slice (per `stateKey`, survives pop-in/out and \"Clear\" / \"New chat\") — except that the figures are NOT persisted to the session snapshot: the server is authoritative and the host re-feeds at boot, so a persisted copy could only show stale dollars after a reload.\n *\n * @beta\n */\n",
+              "docComment": "/**\n * Feed (or clear) one vendor's AI-spend figures for the settings-modal budget meter — the numeric companion to {@link FoundationAiAssistant.setVendorBlocked}, and like it a host-driven write: the element meters nothing itself.\n *\n * The meter renders a row for exactly the vendors that currently HAVE figures. An **unlimited** vendor (the budget endpoint reports `unlimited: true` / `limitUsd: null`) is expressed by never feeding it — there is deliberately no \"unlimited\" figure shape, because a bar with no cap has nothing truthful to fill to. `spentUsd` MAY exceed `budgetUsd` (the last allowed call can overshoot the cap): the row's text shows the real figures and only the bar clamps.\n *\n * Returns `false` — and warns once, not per call — instead of throwing when `vendor` is not a budgeted vendor (`BUDGETED_VENDORS`, the proxy's own metered list) or either figure is not a finite number `>= 0`. Invalid input changes no state. Idempotent: re-feeding a vendor's current figures is a no-op, so hosts can re-feed unconditionally after every turn.\n *\n * `false` ALSO means \"not stored, because the element is not ready yet\": a feed that lands before the element has its session store (a host calling ahead of the first append, or during a pop-out remount) stores nothing and says so, rather than reporting a write that never happened. That case is transient and needs no host handling — the documented per-turn re-feed is what recovers it — so it is deliberately NOT warned about; the warn-once channel is for garbage input only.\n *\n * `figures` is nullish-checked at run time, so `undefined` behaves exactly like `null` and CLEARS that vendor's row. Untyped JS hosts feed this straight from `GET /api/budget`, where a per-vendor lookup that misses yields `undefined`, not `null` — and \"no figures\" coherently means \"no row\". The `| null` parameter type is unchanged for typed callers; the runtime is deliberately the more forgiving of the two.\n *\n * The intended feed is the platform budget endpoint:\n * ```ts\n * // `vendors` is an OBJECT keyed by vendor id, not an array.\n * const { vendors } = await (await fetch('/api/budget')).json();\n * for (const v of Object.values(vendors)) {\n *   if (v.unlimited || v.limitUsd == null) {\n *     assistantEl.setVendorBudget(v.vendor, null); // clear stale figures after a cap is lifted\n *     continue;\n *   }\n *   assistantEl.setVendorBudget(v.vendor, { budgetUsd: v.limitUsd, spentUsd: v.spentUsd });\n * }\n * ```\n *\n * A host that meters its spend by source can pass an optional `segments` breakdown, and the vendor's bar is drawn stacked with a legend naming each one (NEW-15):\n * ```ts\n * assistantEl.setVendorBudget('anthropic', {\n *   budgetUsd: 50,\n *   spentUsd: 12.5,\n *   segments: [\n *     { id: 'app', label: 'App', spentUsd: 9 },\n *     { id: 'batch', label: 'Batch jobs', spentUsd: 3.5 },\n *   ],\n * });\n * ```\n *\n * The labels are yours — the assistant has no vocabulary for what a host spends money on. Segments may add up to less than `spentUsd` (the remainder draws unlabelled) but never to more; a breakdown that does, or that is otherwise malformed, is dropped with a debug log and the single bar renders. Omit `segments` entirely and nothing about the meter changes.\n *\n * Re-run it on mount and after each turn. Scope and lifetime follow the rest of the session slice (per `stateKey`, survives pop-in/out and \"Clear\" / \"New chat\") — except that the figures are NOT persisted to the session snapshot: the server is authoritative and the host re-feeds at boot, so a persisted copy could only show stale dollars after a reload.\n *\n * @beta\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -15028,9 +15028,14 @@
                   "kind": "Content",
                   "text": ", figures: "
                 },
+                {
+                  "kind": "Reference",
+                  "text": "VendorBudgetFigures",
+                  "canonicalReference": "@genesislcap/ai-assistant!VendorBudgetFigures:interface"
+                },
                 {
                   "kind": "Content",
-                  "text": "{\n        budgetUsd: number;\n        spentUsd: number;\n    } | null"
+                  "text": " | null"
                 },
                 {
                   "kind": "Content",
@@ -15047,8 +15052,8 @@
               ],
               "isStatic": false,
               "returnTypeTokenRange": {
-                "startIndex": 5,
-                "endIndex": 6
+                "startIndex": 6,
+                "endIndex": 7
               },
               "releaseTag": "Beta",
               "isProtected": false,
@@ -15066,7 +15071,7 @@
                   "parameterName": "figures",
                   "parameterTypeTokenRange": {
                     "startIndex": 3,
-                    "endIndex": 4
+                    "endIndex": 5
                   },
                   "isOptional": false
                 }
@@ -19321,6 +19326,83 @@
             "endIndex": 6
           }
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/ai-assistant!registerTieredAIProviders:function(1)",
+          "docComment": "/**\n * Build a {@link TieredAIProviderSwitcher} — which registers the tier-shaped provider registry — and put it on the {@link (AIProviderSwitcher:variable)} token. Call once at app bootstrap.\n *\n * @remarks\n *\n * Everything here is synchronous and has to stay that way. `foundation-ai-assistant` resolves the switcher and registry tokens as it connects, and an element that connects first caches the no-op fallback — so an `await` above this call costs the whole page load its providers. Load a stored vendor preference AFTER it, through {@link TieredAIProviderSwitcher.adoptPersistedVendor}.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function registerTieredAIProviders(container: "
+            },
+            {
+              "kind": "Reference",
+              "text": "Container",
+              "canonicalReference": "@microsoft/fast-foundation!Container:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ", options: "
+            },
+            {
+              "kind": "Reference",
+              "text": "Omit",
+              "canonicalReference": "!Omit:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "TieredAIProviderSwitcherOptions",
+              "canonicalReference": "@genesislcap/ai-assistant!TieredAIProviderSwitcherOptions:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ", 'container'>"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Reference",
+              "text": "TieredAIProviderSwitcher",
+              "canonicalReference": "@genesislcap/ai-assistant!TieredAIProviderSwitcher:class"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/provider/tiered-provider-switcher.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 8,
+            "endIndex": 9
+          },
+          "releaseTag": "Beta",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "container",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "options",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 7
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "registerTieredAIProviders"
+        },
         {
           "kind": "Variable",
           "canonicalReference": "@genesislcap/ai-assistant!REQUEST_CONTINUATION_TOOL:var",
@@ -20753,6 +20835,38 @@
                 "endIndex": 2
               }
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SettingsBudgetRow#segments:member",
+              "docComment": "/**\n * The stacked bar's pieces when the host broke this vendor's spend down, and `undefined` when it did not — in which case the row renders the design system's single progress bar, exactly as before (NEW-15).\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "segments?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "SettingsBudgetSegment",
+                  "canonicalReference": "@genesislcap/ai-assistant!SettingsBudgetSegment:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "segments",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@genesislcap/ai-assistant!SettingsBudgetRow#vendor:member",
@@ -20783,6 +20897,186 @@
           ],
           "extendsTokenRanges": []
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/ai-assistant!SettingsBudgetSegment:interface",
+          "docComment": "/**\n * One piece of a stacked budget bar, pre-computed — see {@link SettingsBudgetRow.segments}.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface SettingsBudgetSegment "
+            }
+          ],
+          "fileUrlPath": "src/main/main.types.ts",
+          "releaseTag": "Beta",
+          "name": "SettingsBudgetSegment",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SettingsBudgetSegment#figures:member",
+              "docComment": "/**\n * This piece's spend, e.g. `$12.34`. Empty for the remainder.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "figures: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "figures",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SettingsBudgetSegment#id:member",
+              "docComment": "/**\n * The host's segment id, or the platform's own id for the unattributed remainder.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "id: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "id",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SettingsBudgetSegment#label:member",
+              "docComment": "/**\n * The host's label. Empty for the remainder, which the legend does not list.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "label: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "label",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SettingsBudgetSegment#legend:member",
+              "docComment": "/**\n * Whether this piece appears in the legend — false for the unattributed remainder.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "legend: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "legend",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SettingsBudgetSegment#tone:member",
+              "docComment": "/**\n * Alpha applied to the design system's accent, so the pieces read as one measure.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "tone: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "tone",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SettingsBudgetSegment#widthPercent:member",
+              "docComment": "/**\n * Width as a percentage of the row's full track, already scaled to the clamped bar.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "widthPercent: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "widthPercent",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "Interface",
           "canonicalReference": "@genesislcap/ai-assistant!SettingsContextUsage:interface",
@@ -22681,7 +22975,525 @@
           }
         },
         {
-          "kind": "TypeAlias",
+          "kind": "Class",
+          "canonicalReference": "@genesislcap/ai-assistant!TieredAIProviderSwitcher:class",
+          "docComment": "/**\n * Which cloud vendor backs the tier-shaped provider registry, plus the means to move it at runtime (GENC-1610).\n *\n * @remarks\n *\n * Upstreamed from Genesis Create, which has run this shape in production: a registry keyed by tier (`low` / `high` / `reasoning`), a vendor switch that rebuilds it in place, and the other vendor kept alive as a standby entry. Agents keep resolving tier names, so a switch never touches agent config.\n *\n * Register it on the {@link (AIProviderSwitcher:interface)} DI token — via {@link registerTieredAIProviders} — and the settings modal's vendor UI (or an app's own control) drives it.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare class TieredAIProviderSwitcher implements "
+            },
+            {
+              "kind": "Reference",
+              "text": "AIProviderSwitcher",
+              "canonicalReference": "@genesislcap/ai-assistant!AIProviderSwitcher:interface"
+            },
+            {
+              "kind": "Content",
+              "text": " "
+            }
+          ],
+          "fileUrlPath": "src/provider/tiered-provider-switcher.ts",
+          "releaseTag": "Beta",
+          "isAbstract": false,
+          "name": "TieredAIProviderSwitcher",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "Constructor",
+              "canonicalReference": "@genesislcap/ai-assistant!TieredAIProviderSwitcher:constructor(1)",
+              "docComment": "/**\n * Constructs a new instance of the `TieredAIProviderSwitcher` class\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "constructor(options: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "TieredAIProviderSwitcherOptions",
+                  "canonicalReference": "@genesislcap/ai-assistant!TieredAIProviderSwitcherOptions:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ");"
+                }
+              ],
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "options",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ]
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!TieredAIProviderSwitcher#adoptPersistedVendor:member(1)",
+              "docComment": "/**\n * Adopt a vendor the app read back from its own store — the same registry move as {@link TieredAIProviderSwitcher.switchTo}, without the `onSwitch` callback, because this value came FROM the store and writing it back would be a pointless round-trip on load.\n *\n * Exists because registration has to stay synchronous: an element that connects before the token is registered caches the platform's no-op fallback, so an app cannot await its stored preference before constructing this. It boots on `initialVendor` and adopts the stored one a moment later, through a registry that is mutable and held by reference.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "adoptPersistedVendor(vendor: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "vendor",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "adoptPersistedVendor"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!TieredAIProviderSwitcher#subscribe:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "subscribe(listener: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "(vendor: string) => void"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "() => void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "listener",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "subscribe"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!TieredAIProviderSwitcher#switchTo:member(1)",
+              "docComment": "/**\n * A user-driven switch: move the registry, then tell the app so it can persist the choice. An unknown vendor is ignored.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "switchTo(vendor: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "vendor",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "switchTo"
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!TieredAIProviderSwitcher#vendor:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get vendor(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AITierVendor",
+                  "canonicalReference": "@genesislcap/foundation-ai!AITierVendor:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "vendor",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!TieredAIProviderSwitcher#vendors:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "readonly vendors: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "readonly "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AITierVendor",
+                  "canonicalReference": "@genesislcap/foundation-ai!AITierVendor:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "vendors",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 4
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            }
+          ],
+          "implementsTokenRanges": [
+            {
+              "startIndex": 1,
+              "endIndex": 2
+            }
+          ]
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/ai-assistant!TieredAIProviderSwitcherOptions:interface",
+          "docComment": "/**\n * Options for {@link TieredAIProviderSwitcher}.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface TieredAIProviderSwitcherOptions "
+            }
+          ],
+          "fileUrlPath": "src/provider/tiered-provider-switcher.ts",
+          "releaseTag": "Beta",
+          "name": "TieredAIProviderSwitcherOptions",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!TieredAIProviderSwitcherOptions#container:member",
+              "docComment": "/**\n * DI container the provider registry is registered on.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "container: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Container",
+                  "canonicalReference": "@microsoft/fast-foundation!Container:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "container",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!TieredAIProviderSwitcherOptions#defaultTier:member",
+              "docComment": "/**\n * Which tier the registry resolves for a caller that names no provider. Defaults to `'high'`.\n *\n * High rather than the cheapest, because of what resolves through it: an orchestrated turn classifies against the REGISTRY DEFAULT, so the classifier sees the session's accumulated history on whatever model this names. On the smallest-window tier, a session grown to size on a bigger model can hand the classifier a history that no longer fits — and the routing turn fails at the moment it was supposed to hand off to a model that could have taken it.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "defaultTier?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AITierId",
+                  "canonicalReference": "@genesislcap/foundation-ai!AITierId:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "defaultTier",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!TieredAIProviderSwitcherOptions#initialVendor:member",
+              "docComment": "/**\n * The vendor to boot on. Required, and deliberately so: the platform has no opinion about which cloud vendor an app should use, and a silent default would make one app's choice look like a platform decision.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "initialVendor: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AITierVendor",
+                  "canonicalReference": "@genesislcap/foundation-ai!AITierVendor:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "initialVendor",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!TieredAIProviderSwitcherOptions#onSwitch:member",
+              "docComment": "/**\n * Called when {@link TieredAIProviderSwitcher.switchTo} accepts a vendor — the hook for an app that persists the user's choice.\n *\n * Fires even when the chosen vendor is the one already active. That is not a redundant call: during boot the registry shows this app's initial vendor while a stored preference may still be loading, so \"confirm what I can see\" and \"leave it alone\" are different acts.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "onSwitch?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "(vendor: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AITierVendor",
+                  "canonicalReference": "@genesislcap/foundation-ai!AITierVendor:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ") => void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "onSwitch",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 4
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!TieredAIProviderSwitcherOptions#serverEndpoint:member",
+              "docComment": "/**\n * Where each vendor's tiers post, as a function of the vendor — for example one that returns `/gwf/ai-service/<vendor>/chat`.\n *\n * A function and never a plain string, because the switcher builds MORE than one vendor: the active one, a standby for each other vendor, and every tier again after a switch. A single string would send all of them to the one vendor's proxy, so picking the other vendor in settings would post Anthropic-shaped requests to a Gemini route — failing on every turn rather than at bootstrap. An app that only ever reaches one vendor narrows `vendors` and still passes a function; it just ignores its argument.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "serverEndpoint: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "(vendor: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AITierVendor",
+                  "canonicalReference": "@genesislcap/foundation-ai!AITierVendor:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ") => string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "serverEndpoint",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 4
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!TieredAIProviderSwitcherOptions#tiers:member",
+              "docComment": "/**\n * The tier table to build from. Defaults to the platform's.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "tiers?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AITiers",
+                  "canonicalReference": "@genesislcap/foundation-ai!AITiers:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "tiers",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!TieredAIProviderSwitcherOptions#vendors:member",
+              "docComment": "/**\n * The vendors this app can switch between. Defaults to every vendor in the table.\n *\n * Narrow it when the app's proxy can only reach one: the others would otherwise report a status, and the assistant's partial-wall UX reads statuses — so a walled vendor would offer \"switch to the other one\" about a vendor that has no key behind it.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "vendors?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "readonly "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AITierVendor",
+                  "canonicalReference": "@genesislcap/foundation-ai!AITierVendor:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "vendors",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 4
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "TypeAlias",
           "canonicalReference": "@genesislcap/ai-assistant!TimelineMessage:type",
           "docComment": "/**\n * A chat message lifted into the debug-log timeline as a `kind: 'message'` entry.\n *\n * @beta\n */\n",
           "excerptTokens": [
@@ -23673,6 +24485,209 @@
             "endIndex": 0
           }
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/ai-assistant!VendorBudgetFigures:interface",
+          "docComment": "/**\n * One vendor's AI-spend figures, as fed by the host from the budget endpoint (GENC-1464 — the settings-modal budget meter).\n *\n * Dollars, not a percentage: the meter's text shows the real figures (spend CAN exceed the cap — the last allowed call may overshoot it), and only the bar clamps. Storing a pre-computed percentage would destroy the overshoot.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface VendorBudgetFigures "
+            }
+          ],
+          "fileUrlPath": "src/state/ai-assistant-slice.ts",
+          "releaseTag": "Beta",
+          "name": "VendorBudgetFigures",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!VendorBudgetFigures#budgetUsd:member",
+              "docComment": "/**\n * The vendor's budget cap in USD. Finite and `>= 0`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "budgetUsd: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "budgetUsd",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!VendorBudgetFigures#segments:member",
+              "docComment": "/**\n * Optional breakdown of {@link VendorBudgetFigures.spentUsd} by whatever the host meters spend by — a surface, a team, an environment. Given, the vendor's bar is drawn stacked with a legend; omitted, it is the single bar it has always been.\n *\n * Host-named, with no platform vocabulary: the assistant has no idea what a host's spend sources are, and inventing labels for them is how a product word ends up in the platform. Segments may cover less than the total (the remainder simply draws unlabelled); they may not cover more, which would be a breakdown of a figure other than the one on screen.\n *\n * ORDER IS SIGNIFICANT: the bar and legend are drawn in array order, and the first segment gets the strongest tone (full strength whenever the whole spend is attributed). Feed the sources in a fixed, meaningful order — the one you want drawn first, first — and keep it across re-feeds; a host that re-sorts its sources per response moves the strongest tone between them with no change in the money.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "segments?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "VendorBudgetSegment",
+                  "canonicalReference": "@genesislcap/ai-assistant!VendorBudgetSegment:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "segments",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!VendorBudgetFigures#spentUsd:member",
+              "docComment": "/**\n * Metered spend against that cap in USD. Finite and `>= 0`; may exceed the cap.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "spentUsd: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "spentUsd",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/ai-assistant!VendorBudgetSegment:interface",
+          "docComment": "/**\n * One slice of a vendor's spend — see {@link VendorBudgetFigures.segments}.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface VendorBudgetSegment "
+            }
+          ],
+          "fileUrlPath": "src/state/ai-assistant-slice.ts",
+          "releaseTag": "Beta",
+          "name": "VendorBudgetSegment",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!VendorBudgetSegment#id:member",
+              "docComment": "/**\n * Identifies the source. Must be unique within a breakdown, and must not be `__remainder__`, which the meter reserves for unattributed spend; a breakdown that breaks either rule is dropped. It does not decide drawing order or tone — array order does.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "id: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "id",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!VendorBudgetSegment#label:member",
+              "docComment": "/**\n * What the host calls this slice of the spend; rendered verbatim in the legend.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "label: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "label",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!VendorBudgetSegment#spentUsd:member",
+              "docComment": "/**\n * This slice's share of the spend in USD. Finite and `>= 0`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "spentUsd: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "spentUsd",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "Class",
           "canonicalReference": "@genesislcap/ai-assistant!WebStorageSessionProvider:class",