@genesislcap/ai-assistant 15.32.1 → 15.33.1-GENC-1601.1

package/dist/ai-assistant.api.json

@@ -11401,6 +11401,51 @@
               "isAbstract": false,
               "name": "getDebugLog"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#getLifetimeDebugLog:member(1)",
+              "docComment": "/**\n * The log to download (GENC-1351 §5.8). When the provider persists diagnostics, stitch the **whole lifetime** stream (every page load) rather than just the current page's in-memory view: flush the current delta first so it's included, then reassemble everything `loadDiagnostics` returns. Independent of \"remember chat\" — diagnostics are a forensic stream keyed on provider capability, not on whether the *chat* is remembered (like preferences). Falls back to the live current-page log when diagnostics isn't available or the fetch fails.\n *\n * The stored `meta-snapshot`s are replaced by a fresh one (`withFreshMetaSnapshot`) before reassembly. The persisted stream only re-appends that block when the near-static config signature changes (see `collectDiagnosticsDelta`), so on a session whose config never changes the newest STORED snapshot is the first one — its `context` half (session cost/usage, context tokens, live agent state) frozen seconds into the session, which is how a lifetime log came out reporting near-zero spend against a transcript full of priced messages.\n *\n * PUBLIC (GENC-1625) so a host can ship this exact document somewhere other than the user's downloads folder — Genesis Create writes it into its project export archive, where it is what a support engineer (increasingly, an agent) opens first. Public rather than copied: a host assembling its own would need `DEBUG_LOG_README`, a flush of the pending delta and a fresh `meta-snapshot`, and the moment there are two derivations one of them starts drifting — which for this log means silently understating spend, the bug `withFreshMetaSnapshot` exists to fix.\n *\n * Safe to call at any time: it never throws (a failed diagnostics load degrades to the current-page log) and it has no side effect on the chat beyond landing the delta the next throttled flush would have landed anyway.\n *\n * @public\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getLifetimeDebugLog(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "DebugLog",
+                  "canonicalReference": "@genesislcap/ai-assistant!DebugLog:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 5
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getLifetimeDebugLog"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#handleFileSelect:member(1)",
@@ -14969,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",
@@ -14983,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",
@@ -15002,8 +15052,8 @@
               ],
               "isStatic": false,
               "returnTypeTokenRange": {
-                "startIndex": 5,
-                "endIndex": 6
+                "startIndex": 6,
+                "endIndex": 7
               },
               "releaseTag": "Beta",
               "isProtected": false,
@@ -15021,7 +15071,7 @@
                   "parameterName": "figures",
                   "parameterTypeTokenRange": {
                     "startIndex": 3,
-                    "endIndex": 4
+                    "endIndex": 5
                   },
                   "isOptional": false
                 }
@@ -15538,7 +15588,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#submitDebugLog:member(1)",
-              "docComment": "/**\n * Hand the agent log to the host's `ui.debugLogSubmit.send` callback — the Send button next to Download. Reuses `buildDownloadLog`, so the submitted log is byte-identical to what Download saves (lifetime-stitched when the provider persists diagnostics). The assistant is vendor-agnostic: the callback owns the transport (Sentry feedback, a support API, an upload endpoint). Outcome lands in `debugLogSubmitResult` so the button can flash 'Sent'/'Failed'; failures also go to the logger with the cause.\n */\n",
+              "docComment": "/**\n * Hand the agent log to the host's `ui.debugLogSubmit.send` callback — the Send button next to Download. Reuses `getLifetimeDebugLog`, so the submitted log is byte-identical to what Download saves (lifetime-stitched when the provider persists diagnostics). The assistant is vendor-agnostic: the callback owns the transport (Sentry feedback, a support API, an upload endpoint). Outcome lands in `debugLogSubmitResult` so the button can flash 'Sent'/'Failed'; failures also go to the logger with the cause.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -19276,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",
@@ -20708,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",
@@ -20740,31 +20899,31 @@
         },
         {
           "kind": "Interface",
-          "canonicalReference": "@genesislcap/ai-assistant!SettingsContextUsage:interface",
-          "docComment": "/**\n * The settings-modal context-window indicator, pre-formatted — the context sibling of {@link SettingsBudgetRow}, and pre-formatted for the same reason: the template stays a pure binding layer, and a test can pin the exact text.\n *\n * `undefined` when there is nothing measurable to show, which is what keeps the template free of non-null assertions. It used to read `x.contextTokens!.toLocaleString()`, and the assertion was not merely untidy: those bindings sit inside a `when(...)` block and re-evaluate in the SAME notify batch as the guard that unmounts them, so a session Clear with the modal open on the Usage tab threw two `TypeError`s per render. A shape that can be absent cannot have that bug.\n *\n * @beta\n */\n",
+          "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 SettingsContextUsage "
+              "text": "export interface SettingsBudgetSegment "
             }
           ],
           "fileUrlPath": "src/main/main.types.ts",
           "releaseTag": "Beta",
-          "name": "SettingsContextUsage",
+          "name": "SettingsBudgetSegment",
           "preserveMemberOrder": false,
           "members": [
             {
               "kind": "PropertySignature",
-              "canonicalReference": "@genesislcap/ai-assistant!SettingsContextUsage#barValue:member",
-              "docComment": "/**\n * The bar's value, clamped to `0..100` — only the bar clamps.\n */\n",
+              "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": "barValue: "
+                  "text": "figures: "
                 },
                 {
                   "kind": "Content",
-                  "text": "number"
+                  "text": "string"
                 },
                 {
                   "kind": "Content",
@@ -20774,7 +20933,7 @@
               "isReadonly": false,
               "isOptional": false,
               "releaseTag": "Beta",
-              "name": "barValue",
+              "name": "figures",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -20782,12 +20941,12 @@
             },
             {
               "kind": "PropertySignature",
-              "canonicalReference": "@genesislcap/ai-assistant!SettingsContextUsage#limit:member",
-              "docComment": "/**\n * The model's context window, e.g. `200,000`.\n */\n",
+              "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": "limit: "
+                  "text": "id: "
                 },
                 {
                   "kind": "Content",
@@ -20801,7 +20960,7 @@
               "isReadonly": false,
               "isOptional": false,
               "releaseTag": "Beta",
-              "name": "limit",
+              "name": "id",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -20809,16 +20968,16 @@
             },
             {
               "kind": "PropertySignature",
-              "canonicalReference": "@genesislcap/ai-assistant!SettingsContextUsage#percent:member",
-              "docComment": "/**\n * Whole-number percent consumed. Unclamped, like the budget row's text.\n */\n",
+              "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": "percent: "
+                  "text": "label: "
                 },
                 {
                   "kind": "Content",
-                  "text": "number"
+                  "text": "string"
                 },
                 {
                   "kind": "Content",
@@ -20828,7 +20987,7 @@
               "isReadonly": false,
               "isOptional": false,
               "releaseTag": "Beta",
-              "name": "percent",
+              "name": "label",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -20836,16 +20995,16 @@
             },
             {
               "kind": "PropertySignature",
-              "canonicalReference": "@genesislcap/ai-assistant!SettingsContextUsage#used:member",
-              "docComment": "/**\n * Prompt tokens on the last call, e.g. `12,480`.\n */\n",
+              "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": "used: "
+                  "text": "legend: "
                 },
                 {
                   "kind": "Content",
-                  "text": "string"
+                  "text": "boolean"
                 },
                 {
                   "kind": "Content",
@@ -20855,78 +21014,24 @@
               "isReadonly": false,
               "isOptional": false,
               "releaseTag": "Beta",
-              "name": "used",
+              "name": "legend",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
               }
-            }
-          ],
-          "extendsTokenRanges": []
-        },
-        {
-          "kind": "Variable",
-          "canonicalReference": "@genesislcap/ai-assistant!sparkleIconSvg:var",
-          "docComment": "/**\n * Three-star AI \"sparkle\" mark — the conventional AI signifier; default assistant avatar.\n */\n",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "sparkleIconSvg = "
-            },
-            {
-              "kind": "Content",
-              "text": "\"<svg viewBox=\\\"0 0 24 24\\\" fill=\\\"none\\\" xmlns=\\\"http://www.w3.org/2000/svg\\\"><path d=\\\"M9.5 5 C9.5 11.4 11.1 13 17.5 13 C11.1 13 9.5 14.6 9.5 21 C9.5 14.6 7.9 13 1.5 13 C7.9 13 9.5 11.4 9.5 5 Z\\\" fill=\\\"currentColor\\\"/><path d=\\\"M17 2.5 C17 5.7 17.8 6.5 21 6.5 C17.8 6.5 17 7.3 17 10.5 C17 7.3 16.2 6.5 13 6.5 C16.2 6.5 17 5.7 17 2.5 Z\\\" fill=\\\"currentColor\\\"/><path d=\\\"M17.5 15 C17.5 17 18 17.5 20 17.5 C18 17.5 17.5 18 17.5 20 C17.5 18 17 17.5 15 17.5 C17 17.5 17.5 17 17.5 15 Z\\\" fill=\\\"currentColor\\\"/></svg>\""
-            }
-          ],
-          "fileUrlPath": "src/main/main.ts",
-          "initializerTokenRange": {
-            "startIndex": 1,
-            "endIndex": 2
-          },
-          "isReadonly": true,
-          "releaseTag": "Public",
-          "name": "sparkleIconSvg",
-          "variableTypeTokenRange": {
-            "startIndex": 0,
-            "endIndex": 0
-          }
-        },
-        {
-          "kind": "Interface",
-          "canonicalReference": "@genesislcap/ai-assistant!SpecialistAgentConfig:interface",
-          "docComment": "/**\n * Configuration for a specialist agent.\n *\n * Specialist agents are offered to the classifier for intent routing. The `description` is used to auto-generate the classifier prompt — no manual routing prompt authoring required.\n *\n * @beta\n */\n",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "export interface SpecialistAgentConfig extends "
-            },
-            {
-              "kind": "Reference",
-              "text": "BaseAgentConfig",
-              "canonicalReference": "@genesislcap/ai-assistant!~BaseAgentConfig:interface"
             },
-            {
-              "kind": "Content",
-              "text": " "
-            }
-          ],
-          "fileUrlPath": "src/config/config.ts",
-          "releaseTag": "Beta",
-          "name": "SpecialistAgentConfig",
-          "preserveMemberOrder": false,
-          "members": [
             {
               "kind": "PropertySignature",
-              "canonicalReference": "@genesislcap/ai-assistant!SpecialistAgentConfig#description:member",
-              "docComment": "/**\n * Plain-language description of what this agent handles. Used by the classifier to auto-generate its routing prompt.\n */\n",
+              "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": "description: "
+                  "text": "tone: "
                 },
                 {
                   "kind": "Content",
-                  "text": "string"
+                  "text": "number"
                 },
                 {
                   "kind": "Content",
@@ -20936,7 +21041,7 @@
               "isReadonly": false,
               "isOptional": false,
               "releaseTag": "Beta",
-              "name": "description",
+              "name": "tone",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -20944,16 +21049,16 @@
             },
             {
               "kind": "PropertySignature",
-              "canonicalReference": "@genesislcap/ai-assistant!SpecialistAgentConfig#excludeFromClassifier:member",
-              "docComment": "/**\n * When `true`, the classifier never auto-routes to this agent. The user can still select it manually via the picker, provided both prerequisites are met: this agent has `manualSelection.enabled` set to `true`, *and* the assistant has the picker enabled via `chatConfig.picker.mode`.\n *\n * Use this for agents that overlap heavily with a sibling (e.g. a guided wizard sitting next to a free-form agent in the same domain) and should only be reached intentionally rather than via classifier routing.\n *\n * @beta\n */\n",
+              "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": "excludeFromClassifier?: "
+                  "text": "widthPercent: "
                 },
                 {
                   "kind": "Content",
-                  "text": "boolean"
+                  "text": "number"
                 },
                 {
                   "kind": "Content",
@@ -20961,23 +21066,257 @@
                 }
               ],
               "isReadonly": false,
-              "isOptional": true,
+              "isOptional": false,
               "releaseTag": "Beta",
-              "name": "excludeFromClassifier",
+              "name": "widthPercent",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
               }
-            },
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/ai-assistant!SettingsContextUsage:interface",
+          "docComment": "/**\n * The settings-modal context-window indicator, pre-formatted — the context sibling of {@link SettingsBudgetRow}, and pre-formatted for the same reason: the template stays a pure binding layer, and a test can pin the exact text.\n *\n * `undefined` when there is nothing measurable to show, which is what keeps the template free of non-null assertions. It used to read `x.contextTokens!.toLocaleString()`, and the assertion was not merely untidy: those bindings sit inside a `when(...)` block and re-evaluate in the SAME notify batch as the guard that unmounts them, so a session Clear with the modal open on the Usage tab threw two `TypeError`s per render. A shape that can be absent cannot have that bug.\n *\n * @beta\n */\n",
+          "excerptTokens": [
             {
-              "kind": "PropertySignature",
-              "canonicalReference": "@genesislcap/ai-assistant!SpecialistAgentConfig#fallback:member",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "fallback?: "
-                },
+              "kind": "Content",
+              "text": "export interface SettingsContextUsage "
+            }
+          ],
+          "fileUrlPath": "src/main/main.types.ts",
+          "releaseTag": "Beta",
+          "name": "SettingsContextUsage",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SettingsContextUsage#barValue:member",
+              "docComment": "/**\n * The bar's value, clamped to `0..100` — only the bar clamps.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "barValue: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "barValue",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SettingsContextUsage#limit:member",
+              "docComment": "/**\n * The model's context window, e.g. `200,000`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "limit: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "limit",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SettingsContextUsage#percent:member",
+              "docComment": "/**\n * Whole-number percent consumed. Unclamped, like the budget row's text.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "percent: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "percent",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SettingsContextUsage#used:member",
+              "docComment": "/**\n * Prompt tokens on the last call, e.g. `12,480`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "used: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "used",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@genesislcap/ai-assistant!sparkleIconSvg:var",
+          "docComment": "/**\n * Three-star AI \"sparkle\" mark — the conventional AI signifier; default assistant avatar.\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "sparkleIconSvg = "
+            },
+            {
+              "kind": "Content",
+              "text": "\"<svg viewBox=\\\"0 0 24 24\\\" fill=\\\"none\\\" xmlns=\\\"http://www.w3.org/2000/svg\\\"><path d=\\\"M9.5 5 C9.5 11.4 11.1 13 17.5 13 C11.1 13 9.5 14.6 9.5 21 C9.5 14.6 7.9 13 1.5 13 C7.9 13 9.5 11.4 9.5 5 Z\\\" fill=\\\"currentColor\\\"/><path d=\\\"M17 2.5 C17 5.7 17.8 6.5 21 6.5 C17.8 6.5 17 7.3 17 10.5 C17 7.3 16.2 6.5 13 6.5 C16.2 6.5 17 5.7 17 2.5 Z\\\" fill=\\\"currentColor\\\"/><path d=\\\"M17.5 15 C17.5 17 18 17.5 20 17.5 C18 17.5 17.5 18 17.5 20 C17.5 18 17 17.5 15 17.5 C17 17.5 17.5 17 17.5 15 Z\\\" fill=\\\"currentColor\\\"/></svg>\""
+            }
+          ],
+          "fileUrlPath": "src/main/main.ts",
+          "initializerTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          },
+          "isReadonly": true,
+          "releaseTag": "Public",
+          "name": "sparkleIconSvg",
+          "variableTypeTokenRange": {
+            "startIndex": 0,
+            "endIndex": 0
+          }
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/ai-assistant!SpecialistAgentConfig:interface",
+          "docComment": "/**\n * Configuration for a specialist agent.\n *\n * Specialist agents are offered to the classifier for intent routing. The `description` is used to auto-generate the classifier prompt — no manual routing prompt authoring required.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface SpecialistAgentConfig extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "BaseAgentConfig",
+              "canonicalReference": "@genesislcap/ai-assistant!~BaseAgentConfig:interface"
+            },
+            {
+              "kind": "Content",
+              "text": " "
+            }
+          ],
+          "fileUrlPath": "src/config/config.ts",
+          "releaseTag": "Beta",
+          "name": "SpecialistAgentConfig",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SpecialistAgentConfig#description:member",
+              "docComment": "/**\n * Plain-language description of what this agent handles. Used by the classifier to auto-generate its routing prompt.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "description: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "description",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SpecialistAgentConfig#excludeFromClassifier:member",
+              "docComment": "/**\n * When `true`, the classifier never auto-routes to this agent. The user can still select it manually via the picker, provided both prerequisites are met: this agent has `manualSelection.enabled` set to `true`, *and* the assistant has the picker enabled via `chatConfig.picker.mode`.\n *\n * Use this for agents that overlap heavily with a sibling (e.g. a guided wizard sitting next to a free-form agent in the same domain) and should only be reached intentionally rather than via classifier routing.\n *\n * @beta\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "excludeFromClassifier?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "excludeFromClassifier",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SpecialistAgentConfig#fallback:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "fallback?: "
+                },
                 {
                   "kind": "Content",
                   "text": "never"
@@ -22636,36 +22975,554 @@
           }
         },
         {
-          "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",
+          "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 type TimelineMessage = "
+              "text": "export declare class TieredAIProviderSwitcher implements "
             },
             {
               "kind": "Reference",
-              "text": "ChatMessage",
-              "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
-            },
-            {
-              "kind": "Content",
-              "text": " & {\n    kind: 'message';\n    subAgentName?: string;\n    subAgentDepth?: number;\n    subAgentOf?: string;\n}"
+              "text": "AIProviderSwitcher",
+              "canonicalReference": "@genesislcap/ai-assistant!AIProviderSwitcher:interface"
             },
             {
               "kind": "Content",
-              "text": ";"
+              "text": " "
             }
           ],
-          "fileUrlPath": "src/utils/flatten-sub-agent-messages.ts",
+          "fileUrlPath": "src/provider/tiered-provider-switcher.ts",
           "releaseTag": "Beta",
-          "name": "TimelineMessage",
-          "typeTokenRange": {
-            "startIndex": 1,
-            "endIndex": 3
-          }
-        },
+          "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 — passed straight to `buildTierProviders`. A function when more than one vendor is in play, since the switcher builds the other vendor too.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "serverEndpoint: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string | ((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": [
+            {
+              "kind": "Content",
+              "text": "export type TimelineMessage = "
+            },
+            {
+              "kind": "Reference",
+              "text": "ChatMessage",
+              "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+            },
+            {
+              "kind": "Content",
+              "text": " & {\n    kind: 'message';\n    subAgentName?: string;\n    subAgentDepth?: number;\n    subAgentOf?: string;\n}"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/utils/flatten-sub-agent-messages.ts",
+          "releaseTag": "Beta",
+          "name": "TimelineMessage",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 3
+          }
+        },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@genesislcap/ai-assistant!ToolChoiceInput:type",
@@ -23628,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",
+              "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 * Stable id, used to key the bar and legend across re-feeds.\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",