@genesislcap/ai-assistant 15.59.0 → 15.60.0

package/dist/custom-elements.json

@@ -1858,211 +1858,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/config/config.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "defineAgent",
-          "description": "Identity helper that infers the narrowest possible type for an agent config,\npreserving string literal types (including `name`) without requiring `as const`.\n\nUse this when you need `typeof myAgent` to carry the literal `name` type —\nfor example, when wiring `ChatToolHandlers<typeof myAgent>`.\n\n```ts\nconst myAgent = defineAgent({ name: 'my_agent', ... });\ntype Handlers = ChatToolHandlers<typeof myAgent>;\n// requestSubAgent name param is now typed as 'my_agent'\n```"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "CachePolicy",
-          "declaration": {
-            "name": "CachePolicy",
-            "module": "src/config/config.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "ChatFallback",
-          "declaration": {
-            "name": "ChatFallback",
-            "module": "src/config/config.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "ChatInputDuringExecutionMode",
-          "declaration": {
-            "name": "ChatInputDuringExecutionMode",
-            "module": "src/config/config.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "ChatThinkingPolicy",
-          "declaration": {
-            "name": "ChatThinkingPolicy",
-            "module": "src/config/config.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "ChatToolChoice",
-          "declaration": {
-            "name": "ChatToolChoice",
-            "module": "src/config/config.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "defineAgent",
-          "declaration": {
-            "name": "defineAgent",
-            "module": "src/config/config.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/config/define-stateful-agent.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "restoreMachine",
-          "return": {
-            "type": {
-              "text": "void"
-            }
-          },
-          "parameters": [
-            {
-              "name": "machine",
-              "type": {
-                "text": "{ stop: () => void; start: (options?: { state?: unknown }) => void }"
-              },
-              "description": "the machine to restore (already constructed/started)."
-            },
-            {
-              "name": "restored",
-              "type": {
-                "text": "unknown"
-              },
-              "description": "the agent's serialized image (`ctx.restored` in `init`)."
-            },
-            {
-              "name": "key",
-              "default": "'machine'",
-              "description": "the property the machine occupies in the snapshot; defaults to\n`'machine'` to match the conventional `{ machine }` state bag."
-            }
-          ],
-          "description": "Restore a foundation-state-machine instance from a snapshot produced by the\ndefault serializer (or `machine.getPersistedSnapshot()`). Call inside a\nstateful agent's `init` to resume the machine in its exact prior place:\n\n```ts\ninit: ({ restored }) => {\n  const machine = new MyMachine();\n  restoreMachine(machine, restored); // resume, or no-op on a fresh start\n  return { machine };\n}\n```\n\nNo-ops when there is nothing to restore (a fresh session), leaving the\nfreshly-constructed machine in its initial state."
-        },
-        {
-          "kind": "function",
-          "name": "defineStatefulAgent",
-          "return": {
-            "type": {
-              "text": "AgentConfig"
-            }
-          },
-          "parameters": [
-            {
-              "name": "opts",
-              "type": {
-                "text": "StatefulAgentInit<S>"
-              }
-            }
-          ],
-          "description": "Build an `AgentConfig` whose `systemPrompt`, `toolDefinitions`, and tool\nhandlers all close over a long-lived state object created on activation.\n\nThe framework wires the lifecycle: `init` on `onActivate`, `dispose` on\n`onDeactivate`. State is held inside the helper's closure — never exposed on\nthe resulting `AgentConfig` — so the redux serializer doesn't see it."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "restoreMachine",
-          "declaration": {
-            "name": "restoreMachine",
-            "module": "src/config/define-stateful-agent.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "defineStatefulAgent",
-          "declaration": {
-            "name": "defineStatefulAgent",
-            "module": "src/config/define-stateful-agent.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/config/fallback-agents.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "friendlyFallbackAgent",
-          "type": {
-            "text": "FallbackAgentConfig"
-          },
-          "default": "{\n  name: 'Assistant',\n  fallback: true,\n  systemPrompt: `You are a warm, friendly assistant. For general conversation like \"Hi\" or \"How are you\", you can have a friendly chat. For anything more complex, you cannot directly help, but you can explain what specialists are available. The available specialists are:\\n\\n{{agents}}\\n\\nPolitely let the user know what you can help with and invite them to rephrase their request if it is outside your scope.`,\n}",
-          "description": "A warm, conversational fallback agent. Acknowledges it can't help directly,\nexplains what the available specialists can do, and invites the user to retry.\n\nThe system prompt is generated at runtime by `OrchestratingDriver` from the\nspecialist list — no manual authoring required."
-        },
-        {
-          "kind": "variable",
-          "name": "strictFallbackAgent",
-          "type": {
-            "text": "FallbackAgentConfig"
-          },
-          "default": "{\n  name: 'Assistant',\n  fallback: true,\n  systemPrompt: `You are a concise assistant. The user's request is outside your scope. The available specialists are: {{agents}}.\n\n{{unroutable}}\n\nAnswer in a single short sentence. Do not elaborate.`,\n}",
-          "description": "A brief, professional fallback agent. States what is available without\nelaboration. The `{{agents}}` placeholder is replaced at runtime by\n`OrchestratingDriver` with the generated specialist list.\n\nThe `{{unroutable}}` placeholder positions `UNROUTABLE_INSTRUCTION` — the framework's\ninstruction for a substantive request no specialist covers, which is otherwise APPENDED to a\nstring-form prompt. Positioned rather than appended for one reason: this preset's whole point is\nbrevity, and appended text would be the last thing the model reads. Putting the block above the\nbrevity rule leaves \"a single short sentence\" with the recency, so the two compose instead of\ncompeting. A prompt whose tone rules matter should do the same."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "friendlyFallbackAgent",
-          "declaration": {
-            "name": "friendlyFallbackAgent",
-            "module": "src/config/fallback-agents.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "strictFallbackAgent",
-          "declaration": {
-            "name": "strictFallbackAgent",
-            "module": "src/config/fallback-agents.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/config/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./config"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./fallback-agents"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/config/validate-providers.ts",
-      "declarations": [],
-      "exports": []
-    },
     {
       "kind": "javascript-module",
       "path": "src/genesis/calendar.ts",
@@ -3248,443 +3043,912 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/main/attachment-controller.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/main/budget-controller.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/main/composer-menu-controller.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/main/composer-resize-controller.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/main/context-gate-controller.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/main/cost-ledger-controller.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/main/index.ts",
-      "declarations": [],
+      "path": "src/config/config.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "defineAgent",
+          "description": "Identity helper that infers the narrowest possible type for an agent config,\npreserving string literal types (including `name`) without requiring `as const`.\n\nUse this when you need `typeof myAgent` to carry the literal `name` type —\nfor example, when wiring `ChatToolHandlers<typeof myAgent>`.\n\n```ts\nconst myAgent = defineAgent({ name: 'my_agent', ... });\ntype Handlers = ChatToolHandlers<typeof myAgent>;\n// requestSubAgent name param is now typed as 'my_agent'\n```"
+        }
+      ],
       "exports": [
         {
           "kind": "js",
-          "name": "*",
+          "name": "CachePolicy",
           "declaration": {
-            "name": "*",
-            "package": "./main.template"
-          }
+            "name": "CachePolicy",
+            "module": "src/config/config.ts"
+          }
         },
         {
           "kind": "js",
-          "name": "*",
+          "name": "ChatFallback",
           "declaration": {
-            "name": "*",
-            "package": "./main"
+            "name": "ChatFallback",
+            "module": "src/config/config.ts"
           }
         },
         {
           "kind": "js",
-          "name": "*",
+          "name": "ChatInputDuringExecutionMode",
           "declaration": {
-            "name": "*",
-            "package": "./main.types"
+            "name": "ChatInputDuringExecutionMode",
+            "module": "src/config/config.ts"
           }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/main/main.styles.ts",
-      "declarations": [
+        },
         {
-          "kind": "variable",
-          "name": "styles",
-          "default": "css`\n  ${baseStyles}\n  ${\n    /* The session menu's rows. Same partial the agent picker imports into its own\n       shadow root — the one thing that keeps the two menus looking alike. */ ''\n  }\n  ${menuItemStyles}\n  ${settingsModalStyles}\n`"
-        }
-      ],
-      "exports": [
+          "kind": "js",
+          "name": "ChatThinkingPolicy",
+          "declaration": {
+            "name": "ChatThinkingPolicy",
+            "module": "src/config/config.ts"
+          }
+        },
         {
           "kind": "js",
-          "name": "styles",
+          "name": "ChatToolChoice",
           "declaration": {
-            "name": "styles",
-            "module": "src/main/main.styles.ts"
+            "name": "ChatToolChoice",
+            "module": "src/config/config.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "defineAgent",
+          "declaration": {
+            "name": "defineAgent",
+            "module": "src/config/config.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/main/main.template.ts",
+      "path": "src/config/define-stateful-agent.ts",
       "declarations": [
         {
-          "kind": "variable",
-          "name": "messageTimestampTemplate",
-          "default": "html<ChatMessage, FoundationAiAssistant>`\n  <time\n    class=\"message-timestamp\"\n    part=\"message-timestamp\"\n    datetime=\"${(m) => messageTimestampDateTime(m.timestamp)}\"\n  >\n    <span aria-hidden=\"true\">\n      ${(m, c) => formatMessageTimestamp(m.timestamp, c.parent.timestampClock)}\n    </span>\n    <span class=\"visually-hidden\">${(m) => formatAbsoluteTimestamp(m.timestamp)}</span>\n  </time>\n`",
-          "description": "The timestamp shown beside the sender name (GENC-1257).\n\nTwo strings, not one. A screen reader announces a `<time>` element's TEXT — it has no\nimplicit ARIA role, and the `datetime` attribute is never surfaced to the user — so the\nrelative text is hidden from assistive tech and paired with a visually-hidden absolute\nstring. Otherwise AT would hear \"5 minutes ago\" with nothing to anchor it, and in\n`'hover'` mode would hear it for a timestamp sighted users never asked to see.\n`datetime` stays because it is correct HTML and useful to tooling, not for a11y.\n\nOnly the VISUAL reveal is hover-gated, in CSS — see `.message-timestamp`. `opacity: 0`\nleaves the element in the accessibility tree, so AT gets a time in both visible modes;\n`'off'` is the only mode that removes it.\n\nReads `timestampClock` rather than `Date.now()` so every row shares one invalidatable\nclock and a tick re-evaluates them all; see `FoundationAiAssistant.timestampClock`."
+          "kind": "function",
+          "name": "restoreMachine",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "machine",
+              "type": {
+                "text": "{ stop: () => void; start: (options?: { state?: unknown }) => void }"
+              },
+              "description": "the machine to restore (already constructed/started)."
+            },
+            {
+              "name": "restored",
+              "type": {
+                "text": "unknown"
+              },
+              "description": "the agent's serialized image (`ctx.restored` in `init`)."
+            },
+            {
+              "name": "key",
+              "default": "'machine'",
+              "description": "the property the machine occupies in the snapshot; defaults to\n`'machine'` to match the conventional `{ machine }` state bag."
+            }
+          ],
+          "description": "Restore a foundation-state-machine instance from a snapshot produced by the\ndefault serializer (or `machine.getPersistedSnapshot()`). Call inside a\nstateful agent's `init` to resume the machine in its exact prior place:\n\n```ts\ninit: ({ restored }) => {\n  const machine = new MyMachine();\n  restoreMachine(machine, restored); // resume, or no-op on a fresh start\n  return { machine };\n}\n```\n\nNo-ops when there is nothing to restore (a fresh session), leaving the\nfreshly-constructed machine in its initial state."
         },
         {
           "kind": "function",
-          "name": "FoundationAiAssistantTemplate",
+          "name": "defineStatefulAgent",
           "return": {
             "type": {
-              "text": "ViewTemplate<FoundationAiAssistant>"
+              "text": "AgentConfig"
             }
           },
           "parameters": [
             {
-              "name": "designSystemPrefix",
+              "name": "opts",
               "type": {
-                "text": "string"
+                "text": "StatefulAgentInit<S>"
               }
             }
-          ]
+          ],
+          "description": "Build an `AgentConfig` whose `systemPrompt`, `toolDefinitions`, and tool\nhandlers all close over a long-lived state object created on activation.\n\nThe framework wires the lifecycle: `init` on `onActivate`, `dispose` on\n`onDeactivate`. State is held inside the helper's closure — never exposed on\nthe resulting `AgentConfig` — so the redux serializer doesn't see it."
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "messageTimestampTemplate",
+          "name": "restoreMachine",
           "declaration": {
-            "name": "messageTimestampTemplate",
-            "module": "src/main/main.template.ts"
+            "name": "restoreMachine",
+            "module": "src/config/define-stateful-agent.ts"
           }
         },
         {
           "kind": "js",
-          "name": "FoundationAiAssistantTemplate",
+          "name": "defineStatefulAgent",
           "declaration": {
-            "name": "FoundationAiAssistantTemplate",
-            "module": "src/main/main.template.ts"
+            "name": "defineStatefulAgent",
+            "module": "src/config/define-stateful-agent.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/main/main.ts",
+      "path": "src/config/fallback-agents.ts",
       "declarations": [
         {
           "kind": "variable",
-          "name": "sparkleIconSvg",
-          "default": "`<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>`",
-          "description": "Three-star AI \"sparkle\" mark — the conventional AI signifier; default assistant avatar."
+          "name": "friendlyFallbackAgent",
+          "type": {
+            "text": "FallbackAgentConfig"
+          },
+          "default": "{\n  name: 'Assistant',\n  fallback: true,\n  systemPrompt: `You are a warm, friendly assistant. For general conversation like \"Hi\" or \"How are you\", you can have a friendly chat. For anything more complex, you cannot directly help, but you can explain what specialists are available. The available specialists are:\\n\\n{{agents}}\\n\\nPolitely let the user know what you can help with and invite them to rephrase their request if it is outside your scope.`,\n}",
+          "description": "A warm, conversational fallback agent. Acknowledges it can't help directly,\nexplains what the available specialists can do, and invites the user to retry.\n\nThe system prompt is generated at runtime by `OrchestratingDriver` from the\nspecialist list — no manual authoring required."
         },
         {
           "kind": "variable",
-          "name": "userIconSvg",
-          "default": "`<svg viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"><path d=\"M12 12c2.21 0 4-1.79 4-4s-1.79-4-4-4-4 1.79-4 4 1.79 4 4 4zm0 2c-2.67 0-8 1.34-8 4v2h16v-2c0-2.66-5.33-4-8-4z\" fill=\"currentColor\"/></svg>`",
-          "description": "Person silhouette — default user avatar."
+          "name": "strictFallbackAgent",
+          "type": {
+            "text": "FallbackAgentConfig"
+          },
+          "default": "{\n  name: 'Assistant',\n  fallback: true,\n  systemPrompt: `You are a concise assistant. The user's request is outside your scope. The available specialists are: {{agents}}.\n\n{{unroutable}}\n\nAnswer in a single short sentence. Do not elaborate.`,\n}",
+          "description": "A brief, professional fallback agent. States what is available without\nelaboration. The `{{agents}}` placeholder is replaced at runtime by\n`OrchestratingDriver` with the generated specialist list.\n\nThe `{{unroutable}}` placeholder positions `UNROUTABLE_INSTRUCTION` — the framework's\ninstruction for a substantive request no specialist covers, which is otherwise APPENDED to a\nstring-form prompt. Positioned rather than appended for one reason: this preset's whole point is\nbrevity, and appended text would be the last thing the model reads. Putting the block above the\nbrevity rule leaves \"a single short sentence\" with the recency, so the two compose instead of\ncompeting. A prompt whose tone rules matter should do the same."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "friendlyFallbackAgent",
+          "declaration": {
+            "name": "friendlyFallbackAgent",
+            "module": "src/config/fallback-agents.ts"
+          }
         },
         {
-          "kind": "variable",
-          "name": "genesisIconSvg",
-          "default": "`<svg viewBox=\"-4 0 30 26\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"><path d=\"M18.7702 23.0437C18.7702 22.4675 18.8526 21.8089 19.0995 21.3149C19.3465 20.7386 19.6758 20.2447 20.0874 19.833C20.4991 19.4214 20.993 19.0921 21.5693 18.8451C22.1456 18.5982 22.7219 18.5158 23.2981 18.5158H25.9326V11.6828H19.1819V14.3172C19.1819 15.5521 18.6879 16.7047 17.8647 17.5279C17.0414 18.3512 15.8888 18.8451 14.7363 18.9275H6.7507V6.99025H16.4651V0.157227H3.54C2.63442 0.157227 1.72884 0.568855 1.07023 1.22746C0.411628 1.88606 0 2.79165 0 3.77955V22.2205C0 23.1261 0.411628 24.0316 1.07023 24.7726C1.72884 25.4312 2.63442 25.8428 3.54 25.8428H18.7702V23.0437Z\" fill=\"currentColor\"/></svg>`",
-          "description": "Genesis G-mark — opt-in assistant avatar (the default before the sparkle mark)."
+          "kind": "js",
+          "name": "strictFallbackAgent",
+          "declaration": {
+            "name": "strictFallbackAgent",
+            "module": "src/config/fallback-agents.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/config/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./config"
+          }
         },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./fallback-agents"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/config/validate-providers.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/provider/ai-provider-switcher.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "AIProviderSwitcher",
+          "description": "The DI token for the (AIProviderSwitcher:interface). Resolves a noop until the app\nregisters one."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AIProviderSwitcher",
+          "declaration": {
+            "name": "AIProviderSwitcher",
+            "module": "src/provider/ai-provider-switcher.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/provider/assistant-app-settings.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "AssistantAppSettingsProvider",
+          "description": "The DI token for the (AssistantAppSettingsProvider:interface). Resolves a noop\nuntil the host registers one."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AssistantAppSettingsProvider",
+          "declaration": {
+            "name": "AssistantAppSettingsProvider",
+            "module": "src/provider/assistant-app-settings.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/provider/tiered-provider-switcher.ts",
+      "declarations": [
         {
           "kind": "class",
-          "description": "Foundation AI Assistant component.",
-          "name": "FoundationAiAssistant",
+          "description": "Which cloud vendor backs the tier-shaped provider registry, plus the means to move it at\nruntime (GENC-1610).",
+          "name": "TieredAIProviderSwitcher",
           "members": [
             {
               "kind": "field",
-              "name": "composerResize",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new ComposerResizeController({\n    enabled: () => this.chatConfig.ui?.resizableInput !== false,\n    inputEl: () => this.chatInputEl,\n    messagesEl: () => this.messagesEl,\n  })"
+              "name": "vendors",
+              "type": {
+                "text": "readonly AITierVendor[]"
+              },
+              "readonly": true
             },
             {
               "kind": "field",
-              "name": "composerMenus",
+              "name": "options",
+              "type": {
+                "text": "TieredAIProviderSwitcherOptions"
+              },
               "privacy": "private",
               "readonly": true,
-              "default": "new ComposerMenuController(this, {\n    agentPickerOpen: this.accessor('agentPickerOpen'),\n    sessionMenuOpen: this.accessor('sessionMenuOpen'),\n    focusInput: () => this.chatInputEl?.focus(),\n    resetSessionConfirmations: () => {\n      this.confirmingClear = false;\n      this.confirmingCompact = false;\n    },\n    logMeta: (type, detail) => this.logMeta(type, detail),\n  })"
+              "default": "options"
             },
             {
               "kind": "field",
-              "name": "attachmentCtrl",
+              "name": "defaultTier",
+              "type": {
+                "text": "AITierId"
+              },
               "privacy": "private",
-              "readonly": true,
-              "default": "new AttachmentController(this, {\n    acceptedFiles: () => this.chatConfig.ui?.acceptedFiles,\n    logMeta: (type, detail) => this.logMeta(type, detail),\n  })"
+              "readonly": true
             },
             {
               "kind": "field",
-              "name": "contextGateCtrl",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new ContextGateController({\n    chatConfig: () => this.chatConfig,\n    messages: () => this.messages,\n    contextTokens: () => this.contextTokens,\n    contextLimit: () => this.contextLimit,\n    gateContextTokens: () => this._gateContextTokens,\n    contextReserve: () => this.contextReserve,\n    preambleTokens: () => this.driver?.getPreambleTokens?.(),\n    compactionPlanFor: (options) => this.driver?.getCompactionPlan?.(options) ?? null,\n    bannerVisible: () => this.bannerVisible,\n    effectiveBlockedReason: () => this.effectiveBlockedReason,\n    flowOwnerAgentName: () => this.flowOwnerAgentName,\n  })",
-              "description": "Pure derivation — owns no state. Reaches the driver only through the two\ncallbacks below, so it stays clear of the stateful-agent surface (§11.2\nconstraint 2) and of redux entirely."
-            },
-            {
-              "kind": "field",
-              "name": "costLedger",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new CostLedgerController({\n    chatConfig: () => this.chatConfig,\n    messages: () => this.messages,\n    sessionUsage: () => this.sessionUsage,\n    providerStatuses: () => this.providerStatuses,\n    persistenceActive: () => this.persistenceActive,\n    stateKey: () => this.getStateKey(),\n    headerTitle: () => this.headerTitle,\n    provider: () => this.persistence.provider,\n    elementId: () => this.id,\n  })",
-              "description": "Cost accounting and the persisted build-history ledger (GENC-1475). Reads the live\nsession through callbacks and owns the rows, the load/write latches and the debounce\ntimer — the element keeps only the names the settings modal binds."
-            },
-            {
-              "kind": "field",
-              "name": "budget",
+              "name": "registry",
+              "type": {
+                "text": "MutableAIProviderRegistry"
+              },
               "privacy": "private",
-              "readonly": true,
-              "default": "new BudgetController({\n    sessionRef: () => this._sessionRef,\n    providerStatuses: () => this.providerStatuses,\n    providerRegistry: () => this.providerRegistry,\n    chatConfig: () => this.chatConfig,\n  })",
-              "description": "The AI-spend budget: vendor walls, the derived composer lock, the banner copy\nand the settings meter (GENC-1464).\n\nTakes the session store itself rather than a callback per field — see\n`BudgetDeps` for why this one differs from its siblings."
+              "readonly": true
             },
             {
               "kind": "field",
-              "name": "settings",
+              "name": "listeners",
               "privacy": "private",
               "readonly": true,
-              "default": "new SettingsModalController({\n    chatConfig: () => this.chatConfig,\n    contextTokens: () => this.contextTokens,\n    contextLimit: () => this.contextLimit,\n    budgetUsageVisible: () => this.budget.settingsUsageVisible,\n    costConfig: () => this.costLedger.config,\n    costHistoryLength: () => this.costLedger.history.length,\n    liveCostSessionTitle: () => this.costLedger.liveTitle,\n    providerStatusCount: () => this.providerStatuses.length,\n    sessionRef: () => this._sessionRef,\n    stateKey: () => this.getStateKey(),\n    popoutMode: () => this.popoutMode,\n    headerTitle: () => this.headerTitle,\n    appSettingsProvider: () => this.appSettingsProvider,\n    modal: () => this.settingsModal,\n    tabsEl: () => this.settingsTabsEl,\n    requestBudgetRefresh: () => this.requestBudgetRefresh(),\n    logMeta: (type, detail) => this.logMeta(type, detail),\n  })",
-              "description": "The settings modal (`docs/code-health.md` §3). Reaches the two design-system\nrefs through callbacks, because the template writes them by name — see\n`SettingsModalDeps`."
-            },
-            {
-              "kind": "field",
-              "name": "providerRegistry",
-              "type": {
-                "text": "AIProviderRegistry"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "appSettingsProvider",
-              "type": {
-                "text": "AssistantAppSettingsProvider"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "designSystemPrefix",
-              "type": {
-                "text": "string"
-              },
-              "default": "'rapid'"
-            },
-            {
-              "kind": "field",
-              "name": "headerTitle",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Genesis Assistant'"
-            },
-            {
-              "kind": "field",
-              "name": "sessionKey",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "Explicit session/persistence key (GENC-1351 §5.12). When set, this is the\nsession identity — the key for the driver/store/persister/diagnostics\nregistries and the `sessionKey` passed to the persistence provider — taking\nprecedence over the DOM `id`. A host that scopes persistence per-entity\n(e.g. one chat session per project) binds this to a stable per-entity id;\nchanging it on a **connected** element re-keys the session in place — tears\ndown the current conversation and restores the new key's — via\n`switchSession`. Falls back to `id` when unset,\nso existing consumers are unaffected."
-            },
-            {
-              "kind": "field",
-              "name": "imageSrc",
-              "type": {
-                "text": "string | undefined"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "userImageSrc",
-              "type": {
-                "text": "string | undefined"
-              }
+              "default": "new Set<(vendor: AITierVendor) => void>()"
             },
             {
               "kind": "field",
-              "name": "assistantIcon",
+              "name": "_vendor",
               "type": {
-                "text": "string | undefined"
+                "text": "AITierVendor"
               },
-              "description": "Inline SVG markup overriding the default assistant \"sparkle\" avatar. The\nmarkup is sanitized (SVG profile) before rendering and uses the avatar's\ntheme colour via `currentColor`. For a raster/photo avatar set `imageSrc`\ninstead, which takes precedence. Set to `genesisIconSvg` to restore the\nGenesis G-mark."
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "assistantIconSafe",
+              "name": "vendor",
               "type": {
-                "text": "string"
+                "text": "AITierVendor"
               },
-              "default": "`<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>`",
-              "description": "Sanitized `assistantIcon`, or the default sparkle mark; bound into the template. @internal"
+              "readonly": true
             },
             {
               "kind": "method",
-              "name": "assistantIconChanged",
-              "privacy": "protected",
+              "name": "switchTo",
               "return": {
                 "type": {
                   "text": "void"
                 }
-              }
-            },
-            {
-              "kind": "field",
-              "name": "userIcon",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "Inline SVG markup overriding the default user \"person\" avatar. The markup is\nsanitized (SVG profile) before rendering and uses the avatar's theme colour\nvia `currentColor`. For a raster/photo avatar set `userImageSrc` instead,\nwhich takes precedence."
-            },
-            {
-              "kind": "field",
-              "name": "userIconSafe",
-              "type": {
-                "text": "string"
               },
-              "default": "`<svg viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"><path d=\"M12 12c2.21 0 4-1.79 4-4s-1.79-4-4-4-4 1.79-4 4 1.79 4 4 4zm0 2c-2.67 0-8 1.34-8 4v2h16v-2c0-2.66-5.33-4-8-4z\" fill=\"currentColor\"/></svg>`",
-              "description": "Sanitized `userIcon`, or the default person mark; bound into the template. @internal"
+              "parameters": [
+                {
+                  "name": "vendor",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "A user-driven switch: move the registry, then tell the app so it can persist the choice.\nAn unknown vendor is ignored."
             },
             {
               "kind": "method",
-              "name": "userIconChanged",
-              "privacy": "protected",
+              "name": "adoptPersistedVendor",
               "return": {
                 "type": {
                   "text": "void"
                 }
-              }
-            },
-            {
-              "kind": "field",
-              "name": "placeholder",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Message assistant...'"
-            },
-            {
-              "kind": "field",
-              "name": "popoutMode",
-              "type": {
-                "text": "PopoutMode | undefined"
               },
-              "description": "Controls the pop-out button shown next to the settings cog.\n\"expand\" — in bubble, expands to layout panel (fires chat-popout).\n\"collapse\" — in layout panel, collapses back to bubble (fires chat-popin).\nAbsent — no button (default standalone behaviour, no breaking change)."
+              "parameters": [
+                {
+                  "name": "vendor",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Adopt a vendor the app read back from its own store — the same registry move as\nTieredAIProviderSwitcher.switchTo, without the `onSwitch` callback, because this\nvalue came FROM the store and writing it back would be a pointless round-trip on load.\n\nExists because registration has to stay synchronous: an element that connects before the\ntoken is registered caches the platform's no-op fallback, so an app cannot await its\nstored preference before constructing this. It boots on `initialVendor` and adopts the\nstored one a moment later, through a registry that is mutable and held by reference."
             },
             {
-              "kind": "field",
-              "name": "agents",
-              "type": {
-                "text": "AgentConfig[] | undefined"
+              "kind": "method",
+              "name": "subscribe",
+              "return": {
+                "type": {
+                  "text": "() => void"
+                }
               },
-              "description": "Agent configuration. Each user message is routed to the appropriate specialist\nbased on intent. With a single entry, orchestration is skipped."
+              "parameters": [
+                {
+                  "name": "listener",
+                  "type": {
+                    "text": "(vendor: string) => void"
+                  }
+                }
+              ]
             },
             {
-              "kind": "field",
-              "name": "chatConfig",
-              "type": {
-                "text": "ChatConfig"
+              "kind": "method",
+              "name": "apply",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "default": "{}"
+              "parameters": [
+                {
+                  "name": "vendor",
+                  "type": {
+                    "text": "AITierVendor"
+                  }
+                }
+              ],
+              "description": "The registry move both entry points share, and nothing else."
             },
             {
-              "kind": "field",
-              "name": "persistence",
-              "type": {
-                "text": "SessionPersistenceConfig"
+              "kind": "method",
+              "name": "build",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Record<string, AIProvider>"
+                }
               },
-              "default": "{}",
-              "description": "Optional session persistence (GENC-1351). Off by default — set `enabled`\nand a `provider` (e.g. a `WebStorageSessionProvider`) to have the assistant\nautosave on idle and auto-restore the conversation on page reload. Exposed\nas a top-level property (like `agents`/`providerRegistry`) rather than via\n`chatConfig`, since the provider type lives in this package while\n`ChatConfig` lives in `foundation-ai`."
+              "parameters": [
+                {
+                  "name": "vendor",
+                  "type": {
+                    "text": "AITierVendor"
+                  }
+                }
+              ]
             },
             {
-              "kind": "field",
-              "name": "aiServiceErrorMessages",
-              "type": {
-                "text": "Partial<Record<AIServiceRefusal, string>> | undefined"
+              "kind": "method",
+              "name": "isKnownVendor",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "vendor is AITierVendor"
+                }
               },
-              "description": "Replaces the transcript sentence shown when the app's AI service refuses a request with one of\n`AI_SERVICE_ERROR_CODES`, or its router with one of `AI_SERVICE_ACCESS_REFUSALS` (GENC-1611), per\ncode; a code with no entry keeps\n`DEFAULT_AI_SERVICE_ERROR_MESSAGES`. Read when the driver is created, so set it before the\nelement connects."
-            },
+              "parameters": [
+                {
+                  "name": "vendor",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "registerTieredAIProviders",
+          "return": {
+            "type": {
+              "text": "TieredAIProviderSwitcher"
+            }
+          },
+          "parameters": [
             {
-              "kind": "field",
-              "name": "agentPicker",
+              "name": "container",
               "type": {
-                "text": "AgentPickerMode"
-              },
-              "description": "Resolved agent picker mode from `chatConfig.picker.mode`. Defaults to\n`'disabled'`.",
-              "readonly": true
+                "text": "Container"
+              }
             },
             {
-              "kind": "field",
-              "name": "composerHiddenByConfig",
+              "name": "options",
               "type": {
-                "text": "boolean"
-              },
-              "description": "Whether the built-in composer (input row + attachment chips) is hidden by\nthe host's `chatConfig.ui.hideComposer` setting. Used by the template to\ngate those blocks. Marked `@volatile` because the `'while-splash'` branch\nreads `showingSplash` only conditionally, so FAST cannot rely on cached\ndependency tracking.",
-              "readonly": true
-            },
+                "text": "Omit<TieredAIProviderSwitcherOptions, 'container'>"
+              }
+            }
+          ],
+          "description": "Build a TieredAIProviderSwitcher — which registers the tier-shaped provider\nregistry — and put it on the (AIProviderSwitcher:variable) token. Call once at app\nbootstrap."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "TieredAIProviderSwitcher",
+          "declaration": {
+            "name": "TieredAIProviderSwitcher",
+            "module": "src/provider/tiered-provider-switcher.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "registerTieredAIProviders",
+          "declaration": {
+            "name": "registerTieredAIProviders",
+            "module": "src/provider/tiered-provider-switcher.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/main/attachment-controller.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/main/budget-controller.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/main/composer-menu-controller.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/main/composer-resize-controller.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/main/context-gate-controller.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/main/cost-ledger-controller.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/main/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./main.template"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./main"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./main.types"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/main/main.styles.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "styles",
+          "default": "css`\n  ${baseStyles}\n  ${\n    /* The session menu's rows. Same partial the agent picker imports into its own\n       shadow root — the one thing that keeps the two menus looking alike. */ ''\n  }\n  ${menuItemStyles}\n  ${settingsModalStyles}\n`"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "styles",
+          "declaration": {
+            "name": "styles",
+            "module": "src/main/main.styles.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/main/main.template.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "messageTimestampTemplate",
+          "default": "html<ChatMessage, FoundationAiAssistant>`\n  <time\n    class=\"message-timestamp\"\n    part=\"message-timestamp\"\n    datetime=\"${(m) => messageTimestampDateTime(m.timestamp)}\"\n  >\n    <span aria-hidden=\"true\">\n      ${(m, c) => formatMessageTimestamp(m.timestamp, c.parent.timestampClock)}\n    </span>\n    <span class=\"visually-hidden\">${(m) => formatAbsoluteTimestamp(m.timestamp)}</span>\n  </time>\n`",
+          "description": "The timestamp shown beside the sender name (GENC-1257).\n\nTwo strings, not one. A screen reader announces a `<time>` element's TEXT — it has no\nimplicit ARIA role, and the `datetime` attribute is never surfaced to the user — so the\nrelative text is hidden from assistive tech and paired with a visually-hidden absolute\nstring. Otherwise AT would hear \"5 minutes ago\" with nothing to anchor it, and in\n`'hover'` mode would hear it for a timestamp sighted users never asked to see.\n`datetime` stays because it is correct HTML and useful to tooling, not for a11y.\n\nOnly the VISUAL reveal is hover-gated, in CSS — see `.message-timestamp`. `opacity: 0`\nleaves the element in the accessibility tree, so AT gets a time in both visible modes;\n`'off'` is the only mode that removes it.\n\nReads `timestampClock` rather than `Date.now()` so every row shares one invalidatable\nclock and a tick re-evaluates them all; see `FoundationAiAssistant.timestampClock`."
+        },
+        {
+          "kind": "function",
+          "name": "FoundationAiAssistantTemplate",
+          "return": {
+            "type": {
+              "text": "ViewTemplate<FoundationAiAssistant>"
+            }
+          },
+          "parameters": [
             {
-              "kind": "field",
-              "name": "debugStateFactory",
+              "name": "designSystemPrefix",
               "type": {
-                "text": "() => unknown | undefined"
+                "text": "string"
               }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "messageTimestampTemplate",
+          "declaration": {
+            "name": "messageTimestampTemplate",
+            "module": "src/main/main.template.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "FoundationAiAssistantTemplate",
+          "declaration": {
+            "name": "FoundationAiAssistantTemplate",
+            "module": "src/main/main.template.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/main/main.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "sparkleIconSvg",
+          "default": "`<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>`",
+          "description": "Three-star AI \"sparkle\" mark — the conventional AI signifier; default assistant avatar."
+        },
+        {
+          "kind": "variable",
+          "name": "userIconSvg",
+          "default": "`<svg viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"><path d=\"M12 12c2.21 0 4-1.79 4-4s-1.79-4-4-4-4 1.79-4 4 1.79 4 4 4zm0 2c-2.67 0-8 1.34-8 4v2h16v-2c0-2.66-5.33-4-8-4z\" fill=\"currentColor\"/></svg>`",
+          "description": "Person silhouette — default user avatar."
+        },
+        {
+          "kind": "variable",
+          "name": "genesisIconSvg",
+          "default": "`<svg viewBox=\"-4 0 30 26\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"><path d=\"M18.7702 23.0437C18.7702 22.4675 18.8526 21.8089 19.0995 21.3149C19.3465 20.7386 19.6758 20.2447 20.0874 19.833C20.4991 19.4214 20.993 19.0921 21.5693 18.8451C22.1456 18.5982 22.7219 18.5158 23.2981 18.5158H25.9326V11.6828H19.1819V14.3172C19.1819 15.5521 18.6879 16.7047 17.8647 17.5279C17.0414 18.3512 15.8888 18.8451 14.7363 18.9275H6.7507V6.99025H16.4651V0.157227H3.54C2.63442 0.157227 1.72884 0.568855 1.07023 1.22746C0.411628 1.88606 0 2.79165 0 3.77955V22.2205C0 23.1261 0.411628 24.0316 1.07023 24.7726C1.72884 25.4312 2.63442 25.8428 3.54 25.8428H18.7702V23.0437Z\" fill=\"currentColor\"/></svg>`",
+          "description": "Genesis G-mark — opt-in assistant avatar (the default before the sparkle mark)."
+        },
+        {
+          "kind": "class",
+          "description": "Foundation AI Assistant component.",
+          "name": "FoundationAiAssistant",
+          "members": [
+            {
+              "kind": "field",
+              "name": "composerResize",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new ComposerResizeController({\n    enabled: () => this.chatConfig.ui?.resizableInput !== false,\n    inputEl: () => this.chatInputEl,\n    messagesEl: () => this.messagesEl,\n  })"
             },
             {
               "kind": "field",
-              "name": "debugRedux",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "When set, enables Redux DevTools for this instance's session store."
+              "name": "composerMenus",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new ComposerMenuController(this, {\n    agentPickerOpen: this.accessor('agentPickerOpen'),\n    sessionMenuOpen: this.accessor('sessionMenuOpen'),\n    focusInput: () => this.chatInputEl?.focus(),\n    resetSessionConfirmations: () => {\n      this.confirmingClear = false;\n      this.confirmingCompact = false;\n    },\n    logMeta: (type, detail) => this.logMeta(type, detail),\n  })"
             },
             {
               "kind": "field",
-              "name": "_sessionRef",
-              "type": {
-                "text": "SessionStoreReturn | undefined"
-              },
+              "name": "attachmentCtrl",
               "privacy": "private",
-              "description": "Pointer to this session's redux store. `@observable` (GENC-1351 §5.12) so that\n**swapping** it — the in-place session switch/re-key (`switchSession`) —\nforces every store-backed getter binding to re-evaluate against the NEW store.\nWithout this, FAST's per-store slice tracking would leave the view subscribed\nto the old store after a swap and it wouldn't re-render. (A same-store reset via\nredux actions re-renders without this; a store *swap* needs it.)"
+              "readonly": true,
+              "default": "new AttachmentController(this, {\n    acceptedFiles: () => this.chatConfig.ui?.acceptedFiles,\n    logMeta: (type, detail) => this.logMeta(type, detail),\n  })"
             },
             {
               "kind": "field",
-              "name": "_gateContextTokens",
-              "type": {
-                "text": "number | undefined"
-              },
+              "name": "contextGateCtrl",
               "privacy": "private",
-              "description": "FoundationAiAssistant.contextTokens as of the last moment no turn was\nrunning — the figure FoundationAiAssistant.contextGate is judged\nagainst (GENC-1582).\n\n**Why the gate reads a held figure and the gauge does not.** They answer\ndifferent questions. The gauge is a meter: \"how much context is in play right\nnow\", and a build that momentarily fills 900k of a 1M window should say so.\nThe gate answers \"may the next turn START\", which is only meaningful when no\nturn is running — the composer is disabled by `busy` throughout one anyway, so\na warning raised mid-turn is unactionable by construction.\n\nReading the live figure meant the pill went amber part-way through every large\nbuild and cleared itself at the end, because a `condenseWhen` agent's context\npeaks mid-turn and is shed before the turn finishes. A signal that fires and\nwithdraws on its own each time teaches people to ignore it.\n\n**Held, not latched.** The distinction matters, because `contextGate` is\ndocumented as derived-never-latched and the reason is a real dead end: a figure\npinned to a conversation that has since shrunk blocks the user out of the very\nactions that would fix it. This holds only for the duration of a turn and is\nrefreshed the moment one settles, so no shrink can outlive it — a compaction\nruns under `compacting` rather than `busy` and therefore updates it as it goes,\nand Clear drops it outright. What it costs is one turn of lag: a turn that\nballoons the resting size does not warn until it ends, which is the same trade\nthe flow-owner soften already makes deliberately.\n\nUnset falls back to the live figure, which is correct wherever there is no held\nvalue yet — first paint, and a remount, both of which happen at rest."
+              "readonly": true,
+              "default": "new ContextGateController({\n    chatConfig: () => this.chatConfig,\n    messages: () => this.messages,\n    contextTokens: () => this.contextTokens,\n    contextLimit: () => this.contextLimit,\n    gateContextTokens: () => this._gateContextTokens,\n    contextReserve: () => this.contextReserve,\n    preambleTokens: () => this.driver?.getPreambleTokens?.(),\n    compactionPlanFor: (options) => this.driver?.getCompactionPlan?.(options) ?? null,\n    bannerVisible: () => this.bannerVisible,\n    effectiveBlockedReason: () => this.effectiveBlockedReason,\n    flowOwnerAgentName: () => this.flowOwnerAgentName,\n  })",
+              "description": "Pure derivation — owns no state. Reaches the driver only through the two\ncallbacks below, so it stays clear of the stateful-agent surface (§11.2\nconstraint 2) and of redux entirely."
             },
             {
               "kind": "field",
-              "name": "messages",
-              "type": {
-                "text": "ChatMessage[]"
-              }
+              "name": "costLedger",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new CostLedgerController({\n    chatConfig: () => this.chatConfig,\n    messages: () => this.messages,\n    sessionUsage: () => this.sessionUsage,\n    providerStatuses: () => this.providerStatuses,\n    persistenceActive: () => this.persistenceActive,\n    stateKey: () => this.getStateKey(),\n    headerTitle: () => this.headerTitle,\n    provider: () => this.persistence.provider,\n    elementId: () => this.id,\n  })",
+              "description": "Cost accounting and the persisted build-history ledger (GENC-1475). Reads the live\nsession through callbacks and owns the rows, the load/write latches and the debounce\ntimer — the element keeps only the names the settings modal binds."
             },
             {
               "kind": "field",
-              "name": "state",
+              "name": "budget",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new BudgetController({\n    sessionRef: () => this._sessionRef,\n    providerStatuses: () => this.providerStatuses,\n    providerRegistry: () => this.providerRegistry,\n    chatConfig: () => this.chatConfig,\n  })",
+              "description": "The AI-spend budget: vendor walls, the derived composer lock, the banner copy\nand the settings meter (GENC-1464).\n\nTakes the session store itself rather than a callback per field — see\n`BudgetDeps` for why this one differs from its siblings."
+            },
+            {
+              "kind": "field",
+              "name": "settings",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new SettingsModalController({\n    chatConfig: () => this.chatConfig,\n    contextTokens: () => this.contextTokens,\n    contextLimit: () => this.contextLimit,\n    budgetUsageVisible: () => this.budget.settingsUsageVisible,\n    costConfig: () => this.costLedger.config,\n    costHistoryLength: () => this.costLedger.history.length,\n    liveCostSessionTitle: () => this.costLedger.liveTitle,\n    providerStatusCount: () => this.providerStatuses.length,\n    sessionRef: () => this._sessionRef,\n    stateKey: () => this.getStateKey(),\n    popoutMode: () => this.popoutMode,\n    headerTitle: () => this.headerTitle,\n    appSettingsProvider: () => this.appSettingsProvider,\n    modal: () => this.settingsModal,\n    tabsEl: () => this.settingsTabsEl,\n    requestBudgetRefresh: () => this.requestBudgetRefresh(),\n    logMeta: (type, detail) => this.logMeta(type, detail),\n  })",
+              "description": "The settings modal (`docs/code-health.md` §3). Reaches the two design-system\nrefs through callbacks, because the template writes them by name — see\n`SettingsModalDeps`."
+            },
+            {
+              "kind": "field",
+              "name": "providerRegistry",
               "type": {
-                "text": "AiAssistantState"
+                "text": "AIProviderRegistry"
               }
             },
             {
-              "kind": "method",
-              "name": "isBusyState",
+              "kind": "field",
+              "name": "appSettingsProvider",
+              "type": {
+                "text": "AssistantAppSettingsProvider"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "designSystemPrefix",
+              "type": {
+                "text": "string"
+              },
+              "default": "'rapid'"
+            },
+            {
+              "kind": "field",
+              "name": "headerTitle",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Genesis Assistant'"
+            },
+            {
+              "kind": "field",
+              "name": "sessionKey",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Explicit session/persistence key (GENC-1351 §5.12). When set, this is the\nsession identity — the key for the driver/store/persister/diagnostics\nregistries and the `sessionKey` passed to the persistence provider — taking\nprecedence over the DOM `id`. A host that scopes persistence per-entity\n(e.g. one chat session per project) binds this to a stable per-entity id;\nchanging it on a **connected** element re-keys the session in place — tears\ndown the current conversation and restores the new key's — via\n`switchSession`. Falls back to `id` when unset,\nso existing consumers are unaffected."
+            },
+            {
+              "kind": "field",
+              "name": "imageSrc",
+              "type": {
+                "text": "string | undefined"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "userImageSrc",
+              "type": {
+                "text": "string | undefined"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "assistantIcon",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Inline SVG markup overriding the default assistant \"sparkle\" avatar. The\nmarkup is sanitized (SVG profile) before rendering and uses the avatar's\ntheme colour via `currentColor`. For a raster/photo avatar set `imageSrc`\ninstead, which takes precedence. Set to `genesisIconSvg` to restore the\nGenesis G-mark."
+            },
+            {
+              "kind": "field",
+              "name": "assistantIconSafe",
+              "type": {
+                "text": "string"
+              },
+              "default": "`<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>`",
+              "description": "Sanitized `assistantIcon`, or the default sparkle mark; bound into the template. @internal"
+            },
+            {
+              "kind": "method",
+              "name": "assistantIconChanged",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "userIcon",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Inline SVG markup overriding the default user \"person\" avatar. The markup is\nsanitized (SVG profile) before rendering and uses the avatar's theme colour\nvia `currentColor`. For a raster/photo avatar set `userImageSrc` instead,\nwhich takes precedence."
+            },
+            {
+              "kind": "field",
+              "name": "userIconSafe",
+              "type": {
+                "text": "string"
+              },
+              "default": "`<svg viewBox=\"0 0 24 24\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"><path d=\"M12 12c2.21 0 4-1.79 4-4s-1.79-4-4-4-4 1.79-4 4 1.79 4 4 4zm0 2c-2.67 0-8 1.34-8 4v2h16v-2c0-2.66-5.33-4-8-4z\" fill=\"currentColor\"/></svg>`",
+              "description": "Sanitized `userIcon`, or the default person mark; bound into the template. @internal"
+            },
+            {
+              "kind": "method",
+              "name": "userIconChanged",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "placeholder",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Message assistant...'"
+            },
+            {
+              "kind": "field",
+              "name": "popoutMode",
+              "type": {
+                "text": "PopoutMode | undefined"
+              },
+              "description": "Controls the pop-out button shown next to the settings cog.\n\"expand\" — in bubble, expands to layout panel (fires chat-popout).\n\"collapse\" — in layout panel, collapses back to bubble (fires chat-popin).\nAbsent — no button (default standalone behaviour, no breaking change)."
+            },
+            {
+              "kind": "field",
+              "name": "agents",
+              "type": {
+                "text": "AgentConfig[] | undefined"
+              },
+              "description": "Agent configuration. Each user message is routed to the appropriate specialist\nbased on intent. With a single entry, orchestration is skipped."
+            },
+            {
+              "kind": "field",
+              "name": "chatConfig",
+              "type": {
+                "text": "ChatConfig"
+              },
+              "default": "{}"
+            },
+            {
+              "kind": "field",
+              "name": "persistence",
+              "type": {
+                "text": "SessionPersistenceConfig"
+              },
+              "default": "{}",
+              "description": "Optional session persistence (GENC-1351). Off by default — set `enabled`\nand a `provider` (e.g. a `WebStorageSessionProvider`) to have the assistant\nautosave on idle and auto-restore the conversation on page reload. Exposed\nas a top-level property (like `agents`/`providerRegistry`) rather than via\n`chatConfig`, since the provider type lives in this package while\n`ChatConfig` lives in `foundation-ai`."
+            },
+            {
+              "kind": "field",
+              "name": "aiServiceErrorMessages",
+              "type": {
+                "text": "Partial<Record<AIServiceRefusal, string>> | undefined"
+              },
+              "description": "Replaces the transcript sentence shown when the app's AI service refuses a request with one of\n`AI_SERVICE_ERROR_CODES`, or its router with one of `AI_SERVICE_ACCESS_REFUSALS` (GENC-1611), per\ncode; a code with no entry keeps\n`DEFAULT_AI_SERVICE_ERROR_MESSAGES`. Read when the driver is created, so set it before the\nelement connects."
+            },
+            {
+              "kind": "field",
+              "name": "agentPicker",
+              "type": {
+                "text": "AgentPickerMode"
+              },
+              "description": "Resolved agent picker mode from `chatConfig.picker.mode`. Defaults to\n`'disabled'`.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "composerHiddenByConfig",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the built-in composer (input row + attachment chips) is hidden by\nthe host's `chatConfig.ui.hideComposer` setting. Used by the template to\ngate those blocks. Marked `@volatile` because the `'while-splash'` branch\nreads `showingSplash` only conditionally, so FAST cannot rely on cached\ndependency tracking.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "debugStateFactory",
+              "type": {
+                "text": "() => unknown | undefined"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "debugRedux",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When set, enables Redux DevTools for this instance's session store."
+            },
+            {
+              "kind": "field",
+              "name": "_sessionRef",
+              "type": {
+                "text": "SessionStoreReturn | undefined"
+              },
+              "privacy": "private",
+              "description": "Pointer to this session's redux store. `@observable` (GENC-1351 §5.12) so that\n**swapping** it — the in-place session switch/re-key (`switchSession`) —\nforces every store-backed getter binding to re-evaluate against the NEW store.\nWithout this, FAST's per-store slice tracking would leave the view subscribed\nto the old store after a swap and it wouldn't re-render. (A same-store reset via\nredux actions re-renders without this; a store *swap* needs it.)"
+            },
+            {
+              "kind": "field",
+              "name": "_gateContextTokens",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private",
+              "description": "FoundationAiAssistant.contextTokens as of the last moment no turn was\nrunning — the figure FoundationAiAssistant.contextGate is judged\nagainst (GENC-1582).\n\n**Why the gate reads a held figure and the gauge does not.** They answer\ndifferent questions. The gauge is a meter: \"how much context is in play right\nnow\", and a build that momentarily fills 900k of a 1M window should say so.\nThe gate answers \"may the next turn START\", which is only meaningful when no\nturn is running — the composer is disabled by `busy` throughout one anyway, so\na warning raised mid-turn is unactionable by construction.\n\nReading the live figure meant the pill went amber part-way through every large\nbuild and cleared itself at the end, because a `condenseWhen` agent's context\npeaks mid-turn and is shed before the turn finishes. A signal that fires and\nwithdraws on its own each time teaches people to ignore it.\n\n**Held, not latched.** The distinction matters, because `contextGate` is\ndocumented as derived-never-latched and the reason is a real dead end: a figure\npinned to a conversation that has since shrunk blocks the user out of the very\nactions that would fix it. This holds only for the duration of a turn and is\nrefreshed the moment one settles, so no shrink can outlive it — a compaction\nruns under `compacting` rather than `busy` and therefore updates it as it goes,\nand Clear drops it outright. What it costs is one turn of lag: a turn that\nballoons the resting size does not warn until it ends, which is the same trade\nthe flow-owner soften already makes deliberately.\n\nUnset falls back to the live figure, which is correct wherever there is no held\nvalue yet — first paint, and a remount, both of which happen at rest."
+            },
+            {
+              "kind": "field",
+              "name": "messages",
+              "type": {
+                "text": "ChatMessage[]"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "state",
+              "type": {
+                "text": "AiAssistantState"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "isBusyState",
               "privacy": "private",
               "return": {
                 "type": {
@@ -6360,672 +6624,116 @@
                   }
                 },
                 {
-                  "name": "driver",
-                  "type": {
-                    "text": "AiDriver | undefined"
-                  }
-                }
-              ],
-              "description": "Whether the session restored for `key` is no longer the one on screen (GENC-1662): switched in\nplace, or the element disconnected, while the load was in flight."
-            },
-            {
-              "kind": "method",
-              "name": "reactivateRestoredFlow",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "Promise<void>"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "driver",
-                  "type": {
-                    "text": "AiDriver | undefined"
-                  }
-                }
-              ],
-              "description": "Re-activate a restored flow owner (GENC-1662), so a stateful agent's `init({ restored })` — and\nanything the host hangs off it, like a progress stepper — runs straight after the reload\ninstead of on the next message."
-            },
-            {
-              "kind": "method",
-              "name": "resumeInterruptedTurn",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "Promise<void>"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "key",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "driver",
-                  "type": {
-                    "text": "AiDriver | undefined"
-                  }
-                },
-                {
-                  "name": "ref",
-                  "type": {
-                    "text": "SessionStoreReturn | undefined"
-                  }
-                },
-                {
-                  "name": "outcome",
-                  "type": {
-                    "text": "RestoreOutcome"
-                  }
-                }
-              ],
-              "description": "Run the turn a reload interrupted (GENC-1662), shown as busy exactly as a send is — or, when it\ncannot run, withdraw the resume the restore divider promised."
-            },
-            {
-              "kind": "method",
-              "name": "triggerFileInput",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "handleFileSelect",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "e",
-                  "type": {
-                    "text": "Event"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "removeAttachment",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "attachment",
-                  "type": {
-                    "text": "ChatAttachment"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "removeAttachmentError",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "message",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "handleSendClick"
-            },
-            {
-              "kind": "method",
-              "name": "handleStopClick",
-              "description": "User clicked Stop. Cancels the current turn via the driver and flips the\nbutton to \"Stopping…\" until the turn winds down (a tool mid-execution\nfinishes first). Guarded so a second click is a no-op."
-            },
-            {
-              "kind": "method",
-              "name": "handleSuggestionClick",
-              "parameters": [
-                {
-                  "name": "suggestion",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "submitMessage",
-              "return": {
-                "type": {
-                  "text": "Promise<SubmitMessageResult>"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "input",
-                  "type": {
-                    "text": "{ text?: string; files?: File[] }"
-                  }
-                }
-              ],
-              "description": "Programmatically submit a message. Equivalent to the user typing into the\nbuilt-in composer and pressing send, but callable from external code — most\ncommonly a custom input rendered inside `slot=\"splash\"` when paired with\n`chatConfig.ui.hideComposer`.\n\nThe input fully describes the turn: `text` and `files` REPLACE any current\ncomposer state (they are not appended to it). Files are validated against\n`chatConfig.ui.acceptedFiles` using the same pipeline as the composer's\nattach button.\n\nAtomic on validation: if any file fails validation, no attachments are\ncommitted and no send is dispatched. Failure messages are returned in\n`errors` AND appended to the `attachmentErrors` observable so the built-in\nchip UI still surfaces them when visible.\n\nResolves once the underlying send has been kicked off — it does NOT await\nthe assistant's response."
-            },
-            {
-              "kind": "method",
-              "name": "fetchSuggestions",
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "_pendingSendPrompt",
-              "type": {
-                "text": "string | undefined"
-              },
-              "privacy": "private",
-              "description": "User text of the message currently being sent, stashed for the lifetime of `send()`.\n`flow-owner-changed` fires while the driver routes this turn — before the message is\nappended to raw history — so the flow-activation-prompt capture reads this rather than\na stale raw-history lookup. Cleared once the send settles. (GENC-1351 §5.9)"
-            },
-            {
-              "kind": "method",
-              "name": "send",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "settleAfterTurn",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "capturedSessionRef",
-                  "type": {
-                    "text": "SessionStoreReturn | null | undefined"
-                  }
-                }
-              ],
-              "description": "The post-turn settle shared by `send()` and a resumed restore turn: back to idle through\nthe session ref captured at turn start, then the cleanup the state setter would have done."
-            },
-            {
-              "kind": "method",
-              "name": "onChatHeaderMouseDown",
-              "parameters": [
-                {
-                  "name": "e",
-                  "type": {
-                    "text": "MouseEvent"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "handleInteractionCompleted",
-              "parameters": [
-                {
-                  "name": "e",
-                  "type": {
-                    "text": "Event"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "handleInteractionCost",
-              "parameters": [
-                {
-                  "name": "e",
-                  "type": {
-                    "text": "Event"
-                  }
-                }
-              ],
-              "description": "A widget reporting spend it incurred AFTER resolving.\n\nNote what this deliberately does NOT do: no `startLoadingTimer()`. This is bookkeeping about a\nturn that already finished, so it must be invisible — showing a spinner would tell the user the\nassistant is working when nothing is pending."
-            },
-            {
-              "kind": "field",
-              "name": "stopButtonVisible",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Whether the Stop control is showing.\n\nWhile a turn runs Stop REPLACES Send rather than sitting beside it: the two\nare mutually exclusive actions, and a disabled Send next to a live Stop just\ngives the eye a dead control to skip past. Reads `busy`, so `cancelling`\nkeeps it up (in its \"Stopping…\" state) until the turn actually winds down.",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "sendButtonVisible",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Whether Send is rendered at all. Hidden exactly when Stop has taken its\nplace — so a host that suppressed Stop via `hideStopButton` keeps Send\nthroughout, disabled for the duration, and the slot is never left empty\nmid-turn.",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "isComposerResizable",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Whether the message input shows a drag handle to resize its height.",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "composerHeightStyle",
-              "type": {
-                "text": "string"
-              },
-              "description": "Inline style carrying the dragged height into `--composer-height`.",
-              "readonly": true
-            },
-            {
-              "kind": "method",
-              "name": "onComposerResizeStart",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "e",
-                  "type": {
-                    "text": "PointerEvent"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "onComposerResizeMove",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "e",
-                  "type": {
-                    "text": "PointerEvent"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "onComposerResizeEnd",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "e",
-                  "type": {
-                    "text": "PointerEvent"
-                  }
-                }
-              ]
-            }
-          ],
-          "events": [
-            {
-              "name": "budget-refresh-requested",
-              "type": {
-                "text": "CustomEvent"
-              }
-            },
-            {
-              "type": {
-                "text": "CustomEvent"
-              }
-            },
-            {
-              "description": "Fired when the user presses the chat header in `popout-mode=\"expand\"` (for drag-to-popout hosts). Bubbles and composed. detail: `ChatHeaderMouseDownDetail`",
-              "name": "chat-header-mousedown"
-            },
-            {
-              "description": "Fired after the session is wiped (the lifecycle menu's Clear). The payload is captured before teardown so the host can clean up any external state the active agent was working on. Bubbles and composed. detail: `SessionClearedDetail`",
-              "name": "session-cleared"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "header-title",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Genesis Assistant'",
-              "fieldName": "headerTitle"
-            },
-            {
-              "name": "session-key",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "Explicit session/persistence key (GENC-1351 §5.12). When set, this is the\nsession identity — the key for the driver/store/persister/diagnostics\nregistries and the `sessionKey` passed to the persistence provider — taking\nprecedence over the DOM `id`. A host that scopes persistence per-entity\n(e.g. one chat session per project) binds this to a stable per-entity id;\nchanging it on a **connected** element re-keys the session in place — tears\ndown the current conversation and restores the new key's — via\n`switchSession`. Falls back to `id` when unset,\nso existing consumers are unaffected.",
-              "fieldName": "sessionKey"
-            },
-            {
-              "name": "image-src",
-              "type": {
-                "text": "string | undefined"
-              },
-              "fieldName": "imageSrc"
-            },
-            {
-              "name": "user-image-src",
-              "type": {
-                "text": "string | undefined"
-              },
-              "fieldName": "userImageSrc"
-            },
-            {
-              "name": "placeholder",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Message assistant...'",
-              "fieldName": "placeholder"
-            },
-            {
-              "name": "popout-mode",
-              "type": {
-                "text": "PopoutMode | undefined"
-              },
-              "description": "Controls the pop-out button shown next to the settings cog.\n\"expand\" — in bubble, expands to layout panel (fires chat-popout).\n\"collapse\" — in layout panel, collapses back to bubble (fires chat-popin).\nAbsent — no button (default standalone behaviour, no breaking change).",
-              "fieldName": "popoutMode"
-            },
-            {
-              "name": "debug-redux",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "When set, enables Redux DevTools for this instance's session store.",
-              "fieldName": "debugRedux"
-            }
-          ],
-          "superclass": {
-            "name": "GenesisElement",
-            "package": "@genesislcap/web-core"
-          },
-          "tagName": "foundation-ai-assistant",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "sparkleIconSvg",
-          "declaration": {
-            "name": "sparkleIconSvg",
-            "module": "src/main/main.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "userIconSvg",
-          "declaration": {
-            "name": "userIconSvg",
-            "module": "src/main/main.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "genesisIconSvg",
-          "declaration": {
-            "name": "genesisIconSvg",
-            "module": "src/main/main.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "budgetPercentOf",
-          "declaration": {
-            "name": "budgetPercentOf",
-            "module": "./budget-controller"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "formatBlockedReason",
-          "declaration": {
-            "name": "formatBlockedReason",
-            "module": "./budget-controller"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "FoundationAiAssistant",
-          "declaration": {
-            "name": "FoundationAiAssistant",
-            "module": "src/main/main.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "foundation-ai-assistant",
-          "declaration": {
-            "name": "FoundationAiAssistant",
-            "module": "src/main/main.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/main/main.types.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "AiAssistantEvent",
-          "type": {
-            "text": "{\n  /** Session wiped via the lifecycle menu's Clear. `detail`: `SessionClearedDetail`. */\n  SessionCleared: 'session-cleared',\n  /** Header pressed in `popout-mode=\"expand\"` (drag-to-popout hosts). `detail`: `ChatHeaderMouseDownDetail`. */\n  ChatHeaderMouseDown: 'chat-header-mousedown',\n}"
-          },
-          "default": "{\n  /** Session wiped via the lifecycle menu's Clear. `detail`: `SessionClearedDetail`. */\n  SessionCleared: 'session-cleared',\n  /** Header pressed in `popout-mode=\"expand\"` (drag-to-popout hosts). `detail`: `ChatHeaderMouseDownDetail`. */\n  ChatHeaderMouseDown: 'chat-header-mousedown',\n}",
-          "description": "DOM events the `<foundation-ai-assistant>` element dispatches to its host.\nAll bubble and are `composed` (they cross the shadow boundary), so a host can\nlisten on the element — or any ancestor — to react. Use these constants to\nwire listeners instead of hand-typing event-name strings.\n\nAn `as const` map (not a TS `enum` — this package ships none), so it serves as\nboth the listener-name value and, via the same-named type below, a union."
-        },
-        {
-          "kind": "variable",
-          "name": "ANIMATION_DEFS",
-          "type": {
-            "text": "object"
-          },
-          "default": "{\n  loading: {\n    label: 'Dots',\n    description: 'Shows pulsing dots while the assistant is generating a response.',\n    category: 'Loading style',\n  },\n  waves: {\n    label: 'Waves',\n    description:\n      'Shows glowing sine waves inside a circle while the assistant is generating a response.',\n    category: 'Loading style',\n  },\n  flowingWaves: {\n    label: 'Flowing waves',\n    description:\n      'Shows coloured waves rising and settling from a line while the assistant is generating a response.',\n    category: 'Loading style',\n  },\n  plasma: {\n    label: 'Plasma orb',\n    description:\n      'Shows a glowing plasma sphere with drifting energy while the assistant is generating a response.',\n    category: 'Loading style',\n  },\n  halo: {\n    label: 'Halo',\n    description:\n      'Displays a glowing halo around the assistant avatar while a response is streaming.',\n    category: 'Effects',\n  },\n}",
-          "description": "Registry of all available animations with their display metadata.\nAdding an entry here automatically extends the AiAssistantAnimation type."
-        },
-        {
-          "kind": "variable",
-          "name": "satisfies",
-          "description": "Registry of all available animations with their display metadata.\nAdding an entry here automatically extends the AiAssistantAnimation type."
-        },
-        {
-          "kind": "variable",
-          "name": "Record",
-          "description": "Registry of all available animations with their display metadata.\nAdding an entry here automatically extends the AiAssistantAnimation type."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AgentPickerMode",
-          "declaration": {
-            "name": "AgentPickerMode",
-            "package": "@genesislcap/foundation-ai"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "AiAssistantEvent",
-          "declaration": {
-            "name": "AiAssistantEvent",
-            "module": "src/main/main.types.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "ANIMATION_DEFS",
-          "declaration": {
-            "name": "ANIMATION_DEFS",
-            "module": "src/main/main.types.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "satisfies",
-          "declaration": {
-            "name": "satisfies",
-            "module": "src/main/main.types.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "Record",
-          "declaration": {
-            "name": "Record",
-            "module": "src/main/main.types.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/main/meta-snapshot.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/provider/ai-provider-switcher.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "AIProviderSwitcher",
-          "description": "The DI token for the (AIProviderSwitcher:interface). Resolves a noop until the app\nregisters one."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AIProviderSwitcher",
-          "declaration": {
-            "name": "AIProviderSwitcher",
-            "module": "src/provider/ai-provider-switcher.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/provider/assistant-app-settings.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "AssistantAppSettingsProvider",
-          "description": "The DI token for the (AssistantAppSettingsProvider:interface). Resolves a noop\nuntil the host registers one."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AssistantAppSettingsProvider",
-          "declaration": {
-            "name": "AssistantAppSettingsProvider",
-            "module": "src/provider/assistant-app-settings.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/provider/tiered-provider-switcher.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "Which cloud vendor backs the tier-shaped provider registry, plus the means to move it at\nruntime (GENC-1610).",
-          "name": "TieredAIProviderSwitcher",
-          "members": [
-            {
-              "kind": "field",
-              "name": "vendors",
-              "type": {
-                "text": "readonly AITierVendor[]"
-              },
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "options",
-              "type": {
-                "text": "TieredAIProviderSwitcherOptions"
-              },
-              "privacy": "private",
-              "readonly": true,
-              "default": "options"
+                  "name": "driver",
+                  "type": {
+                    "text": "AiDriver | undefined"
+                  }
+                }
+              ],
+              "description": "Whether the session restored for `key` is no longer the one on screen (GENC-1662): switched in\nplace, or the element disconnected, while the load was in flight."
             },
             {
-              "kind": "field",
-              "name": "defaultTier",
-              "type": {
-                "text": "AITierId"
-              },
+              "kind": "method",
+              "name": "reactivateRestoredFlow",
               "privacy": "private",
-              "readonly": true
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "driver",
+                  "type": {
+                    "text": "AiDriver | undefined"
+                  }
+                }
+              ],
+              "description": "Re-activate a restored flow owner (GENC-1662), so a stateful agent's `init({ restored })` — and\nanything the host hangs off it, like a progress stepper — runs straight after the reload\ninstead of on the next message."
             },
             {
-              "kind": "field",
-              "name": "registry",
-              "type": {
-                "text": "MutableAIProviderRegistry"
-              },
+              "kind": "method",
+              "name": "resumeInterruptedTurn",
               "privacy": "private",
-              "readonly": true
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "driver",
+                  "type": {
+                    "text": "AiDriver | undefined"
+                  }
+                },
+                {
+                  "name": "ref",
+                  "type": {
+                    "text": "SessionStoreReturn | undefined"
+                  }
+                },
+                {
+                  "name": "outcome",
+                  "type": {
+                    "text": "RestoreOutcome"
+                  }
+                }
+              ],
+              "description": "Run the turn a reload interrupted (GENC-1662), shown as busy exactly as a send is — or, when it\ncannot run, withdraw the resume the restore divider promised."
             },
             {
-              "kind": "field",
-              "name": "listeners",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new Set<(vendor: AITierVendor) => void>()"
+              "kind": "method",
+              "name": "triggerFileInput",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
             },
             {
-              "kind": "field",
-              "name": "_vendor",
-              "type": {
-                "text": "AITierVendor"
+              "kind": "method",
+              "name": "handleFileSelect",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "privacy": "private"
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
             },
             {
-              "kind": "field",
-              "name": "vendor",
-              "type": {
-                "text": "AITierVendor"
+              "kind": "method",
+              "name": "removeAttachment",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "readonly": true
+              "parameters": [
+                {
+                  "name": "attachment",
+                  "type": {
+                    "text": "ChatAttachment"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
-              "name": "switchTo",
+              "name": "removeAttachmentError",
               "return": {
                 "type": {
                   "text": "void"
@@ -7033,53 +6741,166 @@
               },
               "parameters": [
                 {
-                  "name": "vendor",
+                  "name": "message",
                   "type": {
                     "text": "string"
                   }
                 }
-              ],
-              "description": "A user-driven switch: move the registry, then tell the app so it can persist the choice.\nAn unknown vendor is ignored."
+              ]
             },
             {
               "kind": "method",
-              "name": "adoptPersistedVendor",
+              "name": "handleSendClick"
+            },
+            {
+              "kind": "method",
+              "name": "handleStopClick",
+              "description": "User clicked Stop. Cancels the current turn via the driver and flips the\nbutton to \"Stopping…\" until the turn winds down (a tool mid-execution\nfinishes first). Guarded so a second click is a no-op."
+            },
+            {
+              "kind": "method",
+              "name": "handleSuggestionClick",
+              "parameters": [
+                {
+                  "name": "suggestion",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "submitMessage",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "Promise<SubmitMessageResult>"
                 }
               },
               "parameters": [
                 {
-                  "name": "vendor",
+                  "name": "input",
                   "type": {
-                    "text": "string"
+                    "text": "{ text?: string; files?: File[] }"
                   }
                 }
               ],
-              "description": "Adopt a vendor the app read back from its own store — the same registry move as\nTieredAIProviderSwitcher.switchTo, without the `onSwitch` callback, because this\nvalue came FROM the store and writing it back would be a pointless round-trip on load.\n\nExists because registration has to stay synchronous: an element that connects before the\ntoken is registered caches the platform's no-op fallback, so an app cannot await its\nstored preference before constructing this. It boots on `initialVendor` and adopts the\nstored one a moment later, through a registry that is mutable and held by reference."
+              "description": "Programmatically submit a message. Equivalent to the user typing into the\nbuilt-in composer and pressing send, but callable from external code — most\ncommonly a custom input rendered inside `slot=\"splash\"` when paired with\n`chatConfig.ui.hideComposer`.\n\nThe input fully describes the turn: `text` and `files` REPLACE any current\ncomposer state (they are not appended to it). Files are validated against\n`chatConfig.ui.acceptedFiles` using the same pipeline as the composer's\nattach button.\n\nAtomic on validation: if any file fails validation, no attachments are\ncommitted and no send is dispatched. Failure messages are returned in\n`errors` AND appended to the `attachmentErrors` observable so the built-in\nchip UI still surfaces them when visible.\n\nResolves once the underlying send has been kicked off — it does NOT await\nthe assistant's response."
             },
             {
               "kind": "method",
-              "name": "subscribe",
+              "name": "fetchSuggestions",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_pendingSendPrompt",
+              "type": {
+                "text": "string | undefined"
+              },
+              "privacy": "private",
+              "description": "User text of the message currently being sent, stashed for the lifetime of `send()`.\n`flow-owner-changed` fires while the driver routes this turn — before the message is\nappended to raw history — so the flow-activation-prompt capture reads this rather than\na stale raw-history lookup. Cleared once the send settles. (GENC-1351 §5.9)"
+            },
+            {
+              "kind": "method",
+              "name": "send",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "settleAfterTurn",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "() => void"
+                  "text": "void"
                 }
               },
               "parameters": [
                 {
-                  "name": "listener",
+                  "name": "capturedSessionRef",
                   "type": {
-                    "text": "(vendor: string) => void"
+                    "text": "SessionStoreReturn | null | undefined"
+                  }
+                }
+              ],
+              "description": "The post-turn settle shared by `send()` and a resumed restore turn: back to idle through\nthe session ref captured at turn start, then the cleanup the state setter would have done."
+            },
+            {
+              "kind": "method",
+              "name": "onChatHeaderMouseDown",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "MouseEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "handleInteractionCompleted",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "apply",
-              "privacy": "private",
+              "name": "handleInteractionCost",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "description": "A widget reporting spend it incurred AFTER resolving.\n\nNote what this deliberately does NOT do: no `startLoadingTimer()`. This is bookkeeping about a\nturn that already finished, so it must be invisible — showing a spinner would tell the user the\nassistant is working when nothing is pending."
+            },
+            {
+              "kind": "field",
+              "name": "stopButtonVisible",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the Stop control is showing.\n\nWhile a turn runs Stop REPLACES Send rather than sitting beside it: the two\nare mutually exclusive actions, and a disabled Send next to a live Stop just\ngives the eye a dead control to skip past. Reads `busy`, so `cancelling`\nkeeps it up (in its \"Stopping…\" state) until the turn actually winds down.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "sendButtonVisible",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether Send is rendered at all. Hidden exactly when Stop has taken its\nplace — so a host that suppressed Stop via `hideStopButton` keeps Send\nthroughout, disabled for the duration, and the slot is never left empty\nmid-turn.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "isComposerResizable",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the message input shows a drag handle to resize its height.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "composerHeightStyle",
+              "type": {
+                "text": "string"
+              },
+              "description": "Inline style carrying the dragged height into `--composer-height`.",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "onComposerResizeStart",
               "return": {
                 "type": {
                   "text": "void"
@@ -7087,96 +6908,275 @@
               },
               "parameters": [
                 {
-                  "name": "vendor",
+                  "name": "e",
                   "type": {
-                    "text": "AITierVendor"
+                    "text": "PointerEvent"
                   }
                 }
-              ],
-              "description": "The registry move both entry points share, and nothing else."
+              ]
             },
             {
               "kind": "method",
-              "name": "build",
-              "privacy": "private",
+              "name": "onComposerResizeMove",
               "return": {
                 "type": {
-                  "text": "Record<string, AIProvider>"
+                  "text": "void"
                 }
               },
               "parameters": [
                 {
-                  "name": "vendor",
+                  "name": "e",
                   "type": {
-                    "text": "AITierVendor"
+                    "text": "PointerEvent"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "isKnownVendor",
-              "privacy": "private",
+              "name": "onComposerResizeEnd",
               "return": {
                 "type": {
-                  "text": "vendor is AITierVendor"
+                  "text": "void"
                 }
               },
               "parameters": [
                 {
-                  "name": "vendor",
+                  "name": "e",
                   "type": {
-                    "text": "string"
+                    "text": "PointerEvent"
                   }
                 }
               ]
             }
-          ]
-        },
-        {
-          "kind": "function",
-          "name": "registerTieredAIProviders",
-          "return": {
-            "type": {
-              "text": "TieredAIProviderSwitcher"
-            }
-          },
-          "parameters": [
+          ],
+          "events": [
             {
-              "name": "container",
+              "name": "budget-refresh-requested",
               "type": {
-                "text": "Container"
+                "text": "CustomEvent"
               }
             },
             {
-              "name": "options",
               "type": {
-                "text": "Omit<TieredAIProviderSwitcherOptions, 'container'>"
+                "text": "CustomEvent"
               }
+            },
+            {
+              "description": "Fired when the user presses the chat header in `popout-mode=\"expand\"` (for drag-to-popout hosts). Bubbles and composed. detail: `ChatHeaderMouseDownDetail`",
+              "name": "chat-header-mousedown"
+            },
+            {
+              "description": "Fired after the session is wiped (the lifecycle menu's Clear). The payload is captured before teardown so the host can clean up any external state the active agent was working on. Bubbles and composed. detail: `SessionClearedDetail`",
+              "name": "session-cleared"
             }
           ],
-          "description": "Build a TieredAIProviderSwitcher — which registers the tier-shaped provider\nregistry — and put it on the (AIProviderSwitcher:variable) token. Call once at app\nbootstrap."
+          "attributes": [
+            {
+              "name": "header-title",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Genesis Assistant'",
+              "fieldName": "headerTitle"
+            },
+            {
+              "name": "session-key",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Explicit session/persistence key (GENC-1351 §5.12). When set, this is the\nsession identity — the key for the driver/store/persister/diagnostics\nregistries and the `sessionKey` passed to the persistence provider — taking\nprecedence over the DOM `id`. A host that scopes persistence per-entity\n(e.g. one chat session per project) binds this to a stable per-entity id;\nchanging it on a **connected** element re-keys the session in place — tears\ndown the current conversation and restores the new key's — via\n`switchSession`. Falls back to `id` when unset,\nso existing consumers are unaffected.",
+              "fieldName": "sessionKey"
+            },
+            {
+              "name": "image-src",
+              "type": {
+                "text": "string | undefined"
+              },
+              "fieldName": "imageSrc"
+            },
+            {
+              "name": "user-image-src",
+              "type": {
+                "text": "string | undefined"
+              },
+              "fieldName": "userImageSrc"
+            },
+            {
+              "name": "placeholder",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Message assistant...'",
+              "fieldName": "placeholder"
+            },
+            {
+              "name": "popout-mode",
+              "type": {
+                "text": "PopoutMode | undefined"
+              },
+              "description": "Controls the pop-out button shown next to the settings cog.\n\"expand\" — in bubble, expands to layout panel (fires chat-popout).\n\"collapse\" — in layout panel, collapses back to bubble (fires chat-popin).\nAbsent — no button (default standalone behaviour, no breaking change).",
+              "fieldName": "popoutMode"
+            },
+            {
+              "name": "debug-redux",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When set, enables Redux DevTools for this instance's session store.",
+              "fieldName": "debugRedux"
+            }
+          ],
+          "superclass": {
+            "name": "GenesisElement",
+            "package": "@genesislcap/web-core"
+          },
+          "tagName": "foundation-ai-assistant",
+          "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "TieredAIProviderSwitcher",
+          "name": "sparkleIconSvg",
           "declaration": {
-            "name": "TieredAIProviderSwitcher",
-            "module": "src/provider/tiered-provider-switcher.ts"
+            "name": "sparkleIconSvg",
+            "module": "src/main/main.ts"
           }
         },
         {
           "kind": "js",
-          "name": "registerTieredAIProviders",
+          "name": "userIconSvg",
           "declaration": {
-            "name": "registerTieredAIProviders",
-            "module": "src/provider/tiered-provider-switcher.ts"
+            "name": "userIconSvg",
+            "module": "src/main/main.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "genesisIconSvg",
+          "declaration": {
+            "name": "genesisIconSvg",
+            "module": "src/main/main.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "budgetPercentOf",
+          "declaration": {
+            "name": "budgetPercentOf",
+            "module": "./budget-controller"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "formatBlockedReason",
+          "declaration": {
+            "name": "formatBlockedReason",
+            "module": "./budget-controller"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "FoundationAiAssistant",
+          "declaration": {
+            "name": "FoundationAiAssistant",
+            "module": "src/main/main.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "foundation-ai-assistant",
+          "declaration": {
+            "name": "FoundationAiAssistant",
+            "module": "src/main/main.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/main/main.types.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "AiAssistantEvent",
+          "type": {
+            "text": "{\n  /** Session wiped via the lifecycle menu's Clear. `detail`: `SessionClearedDetail`. */\n  SessionCleared: 'session-cleared',\n  /** Header pressed in `popout-mode=\"expand\"` (drag-to-popout hosts). `detail`: `ChatHeaderMouseDownDetail`. */\n  ChatHeaderMouseDown: 'chat-header-mousedown',\n}"
+          },
+          "default": "{\n  /** Session wiped via the lifecycle menu's Clear. `detail`: `SessionClearedDetail`. */\n  SessionCleared: 'session-cleared',\n  /** Header pressed in `popout-mode=\"expand\"` (drag-to-popout hosts). `detail`: `ChatHeaderMouseDownDetail`. */\n  ChatHeaderMouseDown: 'chat-header-mousedown',\n}",
+          "description": "DOM events the `<foundation-ai-assistant>` element dispatches to its host.\nAll bubble and are `composed` (they cross the shadow boundary), so a host can\nlisten on the element — or any ancestor — to react. Use these constants to\nwire listeners instead of hand-typing event-name strings.\n\nAn `as const` map (not a TS `enum` — this package ships none), so it serves as\nboth the listener-name value and, via the same-named type below, a union."
+        },
+        {
+          "kind": "variable",
+          "name": "ANIMATION_DEFS",
+          "type": {
+            "text": "object"
+          },
+          "default": "{\n  loading: {\n    label: 'Dots',\n    description: 'Shows pulsing dots while the assistant is generating a response.',\n    category: 'Loading style',\n  },\n  waves: {\n    label: 'Waves',\n    description:\n      'Shows glowing sine waves inside a circle while the assistant is generating a response.',\n    category: 'Loading style',\n  },\n  flowingWaves: {\n    label: 'Flowing waves',\n    description:\n      'Shows coloured waves rising and settling from a line while the assistant is generating a response.',\n    category: 'Loading style',\n  },\n  plasma: {\n    label: 'Plasma orb',\n    description:\n      'Shows a glowing plasma sphere with drifting energy while the assistant is generating a response.',\n    category: 'Loading style',\n  },\n  halo: {\n    label: 'Halo',\n    description:\n      'Displays a glowing halo around the assistant avatar while a response is streaming.',\n    category: 'Effects',\n  },\n}",
+          "description": "Registry of all available animations with their display metadata.\nAdding an entry here automatically extends the AiAssistantAnimation type."
+        },
+        {
+          "kind": "variable",
+          "name": "satisfies",
+          "description": "Registry of all available animations with their display metadata.\nAdding an entry here automatically extends the AiAssistantAnimation type."
+        },
+        {
+          "kind": "variable",
+          "name": "Record",
+          "description": "Registry of all available animations with their display metadata.\nAdding an entry here automatically extends the AiAssistantAnimation type."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AgentPickerMode",
+          "declaration": {
+            "name": "AgentPickerMode",
+            "package": "@genesislcap/foundation-ai"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AiAssistantEvent",
+          "declaration": {
+            "name": "AiAssistantEvent",
+            "module": "src/main/main.types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ANIMATION_DEFS",
+          "declaration": {
+            "name": "ANIMATION_DEFS",
+            "module": "src/main/main.types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "satisfies",
+          "declaration": {
+            "name": "satisfies",
+            "module": "src/main/main.types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "Record",
+          "declaration": {
+            "name": "Record",
+            "module": "src/main/main.types.ts"
           }
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/main/meta-snapshot.ts",
+      "declarations": [],
+      "exports": []
+    },
     {
       "kind": "javascript-module",
       "path": "src/state/ai-assistant-slice.ts",
@@ -15678,384 +15678,782 @@
               "description": "Push one snapshot to the ring buffer. Called inside `runToolLoop` just\nbefore each LLM call — that's the latest point where the prompt, tool\nsurface, and agent state line up with what the model is about to see.\n\nReturns the pushed object so the caller can back-fill what only the response\nknows (`usage`). Mutating it after the fact is safe whether or not the ring\nbuffer has since evicted it — an evicted snapshot is simply no longer exported."
             },
             {
-              "kind": "method",
-              "name": "forwardSubAgent",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "kind": "method",
+              "name": "forwardSubAgent",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "childSnapshots",
+                  "type": {
+                    "text": "ReadonlyArray<TurnSnapshot>"
+                  }
+                }
+              ],
+              "description": "Merge a sub-agent's turn snapshots into this driver's buffer so they surface\nas `kind:'turn'` entries in the exported debug log. The child runs as a\nseparate, discarded driver, so its snapshots would otherwise be lost. Each is\nre-labelled under the parent turn that activated the sub-agent: the child's\nown (numeric) turns become `\"<parentTurn>-1\"`, `\"-2\"`, … (1-based, in order);\nany already-forwarded grand-child labels (strings) have their leading segment\nremapped the same way, so nesting composes (`\"5-2\"` → `\"5-2-1\"`).\n\nNote: two sub-agents invoked in the *same* parent turn share the prefix, so\ntheir labels can repeat — `agentName` on each snapshot disambiguates them."
+            },
+            {
+              "kind": "method",
+              "name": "foldDiagnostics",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "interactionId",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "harvested",
+                  "type": {
+                    "text": "unknown"
+                  }
+                }
+              ],
+              "description": "Fold a widget's out-of-band diagnostics into this session — typically a server-side\nChatDriver's collated log, arriving on `InteractionResult.diagnostics` — so the host's debug\nlog and persisted diagnostics stream include them. Independent of the interaction's own\nmessage: these describe the widget's work, not that message. A non-array or empty harvest is\na no-op."
+            },
+            {
+              "kind": "method",
+              "name": "trim",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Hold the ring buffer at its cap, dropping oldest-first."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "TurnRecorder",
+          "declaration": {
+            "name": "TurnRecorder",
+            "module": "src/components/chat-driver/turn-recorder.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/chat-interaction-wrapper/chat-interaction-wrapper.styles.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "AiChatInteractionWrapperStyles",
+          "default": "css`\n  :host {\n    display: block;\n  }\n`"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AiChatInteractionWrapperStyles",
+          "declaration": {
+            "name": "AiChatInteractionWrapperStyles",
+            "module": "src/components/chat-interaction-wrapper/chat-interaction-wrapper.styles.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/chat-interaction-wrapper/chat-interaction-wrapper.template.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "AiChatInteractionWrapperTemplate",
+          "default": "html<AiChatInteractionWrapper>`\n  <div ${ref('container')} class=\"container\" part=\"container\"></div>\n`"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AiChatInteractionWrapperTemplate",
+          "declaration": {
+            "name": "AiChatInteractionWrapperTemplate",
+            "module": "src/components/chat-interaction-wrapper/chat-interaction-wrapper.template.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/chat-interaction-wrapper/chat-interaction-wrapper.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Hosts an interactive AI chat sub-component by tag name.",
+          "name": "AiChatInteractionWrapper",
+          "members": [
+            {
+              "kind": "field",
+              "name": "resolved",
+              "type": {
+                "text": "InteractionResult<unknown> | undefined"
+              },
+              "default": "undefined",
+              "description": "The resolved result once the interaction has completed. Forwarded to the rendered component. @internal"
+            },
+            {
+              "kind": "field",
+              "name": "outcome",
+              "type": {
+                "text": "unknown"
+              },
+              "default": "undefined",
+              "description": "See `AiChatInteraction`'s resolved `outcome`: recorded after the answer, by the tool."
+            },
+            {
+              "kind": "field",
+              "name": "_resizeObserver",
+              "type": {
+                "text": "ResizeObserver | undefined"
+              },
+              "privacy": "private",
+              "description": "Observes the rendered widget for mid-lifecycle size changes — see observeWidgetResize."
+            },
+            {
+              "kind": "method",
+              "name": "componentNameChanged"
+            },
+            {
+              "kind": "method",
+              "name": "interactionIdChanged",
+              "description": "Re-render the hosted widget when the interaction identity changes. This\nensures widgets don't go stale with them being rendered with `recycle: true`\nwhen messages are dynamically filtered, showing/hiding thinking/tool calls\n\n`interactionId` is a per-interaction UUID, so it changes exactly when the\nhosted interaction does. Property bindings apply in template order\n(componentName, data, interactionId), so `data` is already rebound by the\ntime this fires and the fresh widget is built with the correct data."
+            },
+            {
+              "kind": "method",
+              "name": "resolvedChanged"
+            },
+            {
+              "kind": "method",
+              "name": "outcomeChanged",
+              "description": "An outcome recorded after the answer reaches a widget already showing that answer."
+            },
+            {
+              "kind": "method",
+              "name": "resolvedInteraction",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "AiChatInteraction"
+                }
+              },
+              "description": "The resolved descriptor, with the outcome when one has been recorded."
+            },
+            {
+              "kind": "method",
+              "name": "observeWidgetResize",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "element",
+                  "type": {
+                    "text": "Element"
+                  }
+                }
+              ],
+              "description": "Watch the rendered widget element for box-size changes. When the widget\ngrows or shrinks mid-lifecycle (e.g. expanding a \"More info\" panel,\nappending an SSE status row, revealing generated code), bubble a\n`request-scroll-to-bottom` event so `FoundationAiAssistant` re-snaps to\nthe bottom. `scrollToBottom` respects `_userScrolledAway`, so a user\nreading old messages is not yanked back.\n\nThe first ResizeObserver callback fires synchronously with the initial\nsize when `observe()` is called; we skip it so freshly-rendered widgets\ndon't double up with the existing `handleMessagesUpdate` auto-scroll for\nnew messages."
+            },
+            {
+              "kind": "method",
+              "name": "renderComponent",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "buildInteraction",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "AiChatInteraction"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "host",
+                  "type": {
+                    "text": "InteractionHost | null"
+                  }
+                }
+              ],
+              "description": "Project the wrapper's current `data`/`resolved`/`interactionId` into the\ndiscriminated AiChatInteraction the widget consumes (GENC-1390)."
+            }
+          ],
+          "events": [
+            {
+              "name": "request-scroll-to-bottom",
+              "type": {
+                "text": "CustomEvent"
+              }
+            },
+            {
+              "description": "Fired when the interaction finishes. detail: `InteractionCompletedEventDetail`",
+              "name": "interaction-completed"
+            },
+            {
+              "description": "Fired when a widget spends money AFTER resolving. detail: `InteractionCostEventDetail`",
+              "name": "interaction-cost"
+            }
+          ],
+          "superclass": {
+            "name": "GenesisElement",
+            "package": "@genesislcap/web-core"
+          },
+          "tagName": "ai-chat-interaction-wrapper",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AiChatInteractionWrapper",
+          "declaration": {
+            "name": "AiChatInteractionWrapper",
+            "module": "src/components/chat-interaction-wrapper/chat-interaction-wrapper.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "ai-chat-interaction-wrapper",
+          "declaration": {
+            "name": "AiChatInteractionWrapper",
+            "module": "src/components/chat-interaction-wrapper/chat-interaction-wrapper.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/chat-interaction-wrapper/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./chat-interaction-wrapper"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./chat-interaction-wrapper.styles"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./chat-interaction-wrapper.template"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/chat-markdown/chat-markdown.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "MARKDOWN_EXPORTPARTS",
+          "type": {
+            "text": "string"
+          },
+          "description": "Every part this component exposes, as an `exportparts` value.\n\n`::part()` crosses exactly one shadow boundary, so a host that renders `<ai-chat-markdown>` in\nits own shadow root has to forward these for an app to reach them at all. Built from the map\nabove rather than written out, so the forwarded list cannot drift from what is emitted."
+        },
+        {
+          "kind": "class",
+          "description": "",
+          "name": "AiChatMarkdown",
+          "members": [
+            {
+              "kind": "field",
+              "name": "content",
+              "type": {
+                "text": "string"
               },
-              "parameters": [
-                {
-                  "name": "childSnapshots",
-                  "type": {
-                    "text": "ReadonlyArray<TurnSnapshot>"
-                  }
-                }
-              ],
-              "description": "Merge a sub-agent's turn snapshots into this driver's buffer so they surface\nas `kind:'turn'` entries in the exported debug log. The child runs as a\nseparate, discarded driver, so its snapshots would otherwise be lost. Each is\nre-labelled under the parent turn that activated the sub-agent: the child's\nown (numeric) turns become `\"<parentTurn>-1\"`, `\"-2\"`, … (1-based, in order);\nany already-forwarded grand-child labels (strings) have their leading segment\nremapped the same way, so nesting composes (`\"5-2\"` → `\"5-2-1\"`).\n\nNote: two sub-agents invoked in the *same* parent turn share the prefix, so\ntheir labels can repeat — `agentName` on each snapshot disambiguates them."
+              "default": "''",
+              "description": "The markdown string to render."
             },
             {
               "kind": "method",
-              "name": "foldDiagnostics",
+              "name": "annotateParts",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "string"
                 }
               },
               "parameters": [
                 {
-                  "name": "interactionId",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "harvested",
+                  "name": "fragment",
                   "type": {
-                    "text": "unknown"
+                    "text": "DocumentFragment"
                   }
                 }
               ],
-              "description": "Fold a widget's out-of-band diagnostics into this session — typically a server-side\nChatDriver's collated log, arriving on `InteractionResult.diagnostics` — so the host's debug\nlog and persisted diagnostics stream include them. Independent of the interaction's own\nmessage: these describe the widget's work, not that message. A non-array or empty harvest is\na no-op."
-            },
-            {
-              "kind": "method",
-              "name": "trim",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "description": "Hold the ring buffer at its cap, dropping oldest-first."
+              "description": "Tag the generated elements with shadow parts so an embedding app can style them.\n\nTakes the tree DOMPurify built rather than re-parsing its serialised output: `content` changes\non every streamed chunk, so a second parse/serialise round trip would run per chunk over the\nwhole message, and the string the browser finally parses is then serialised straight from the\ntree DOMPurify checked. Parse/serialise mismatches are where mXSS bypasses have historically\nlived, and this walk has no need to introduce one.\n\nOnly ever *adds* attributes, to DOM that has already been cleared - so it is not itself\nsanitiser surface.\n\nLists additionally carry a level: a top-level list is `md-ul md-ul-level-1`, a list nested\ninside it is `md-ul-level-2`, and an `li` takes the level of the list holding it. Levels are\nclamped at `MAX_LIST_LEVEL`, so a list deeper than that answers to the deepest level\nrather than to a name no host forwards. Chat markdown rarely nests, so this is a safety valve\nrather than a feature - without it, every list at every depth would answer to one selector and\nthere would be no way to tell them apart afterwards. Depth comes from walking the tree rather\nthan from marked's renderers, which are invoked innermost-first and so cannot count downwards."
             }
-          ]
+          ],
+          "superclass": {
+            "name": "GenesisElement",
+            "package": "@genesislcap/web-core"
+          },
+          "tagName": "ai-chat-markdown",
+          "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "TurnRecorder",
+          "name": "MARKDOWN_EXPORTPARTS",
           "declaration": {
-            "name": "TurnRecorder",
-            "module": "src/components/chat-driver/turn-recorder.ts"
+            "name": "MARKDOWN_EXPORTPARTS",
+            "module": "src/components/chat-markdown/chat-markdown.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AiChatMarkdown",
+          "declaration": {
+            "name": "AiChatMarkdown",
+            "module": "src/components/chat-markdown/chat-markdown.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "ai-chat-markdown",
+          "declaration": {
+            "name": "AiChatMarkdown",
+            "module": "src/components/chat-markdown/chat-markdown.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/chat-interaction-wrapper/chat-interaction-wrapper.styles.ts",
+      "path": "src/components/chat-markdown/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./chat-markdown"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/message-feedback/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./message-feedback"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/message-feedback/message-feedback.styles.ts",
       "declarations": [
         {
           "kind": "variable",
-          "name": "AiChatInteractionWrapperStyles",
-          "default": "css`\n  :host {\n    display: block;\n  }\n`"
+          "name": "styles",
+          "default": "css`\n  :host {\n    display: block;\n    margin-top: calc(var(--design-unit) * 1.5px);\n    font-size: 13px;\n  }\n\n  .thumbs {\n    display: flex;\n    gap: 2px;\n  }\n\n  .thumb {\n    appearance: none;\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    width: 24px;\n    height: 24px;\n    padding: 0;\n    border: none;\n    border-radius: calc(var(--control-corner-radius) * 1px);\n    background: transparent;\n    color: inherit;\n    font-size: 12px;\n    opacity: 65%;\n    cursor: pointer;\n  }\n\n  .thumb:hover,\n  .thumb:focus-visible,\n  .thumb[aria-pressed='true'] {\n    opacity: 100%;\n  }\n\n  .thumb:hover {\n    background: var(--neutral-fill-stealth-hover);\n  }\n\n  .thumb:focus-visible {\n    outline: calc(var(--focus-stroke-width) * 1px) solid var(--focus-stroke-outer);\n    outline-offset: 1px;\n  }\n\n  .thumb:disabled {\n    cursor: default;\n  }\n\n  .panel {\n    display: flex;\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 2px);\n    margin-top: calc(var(--design-unit) * 1px);\n  }\n\n  .panel-title {\n    margin: 0;\n    font-weight: 600;\n  }\n\n  .note {\n    width: 100%;\n  }\n\n  .hint {\n    margin: 0;\n    font-size: 11px;\n    line-height: 1.4;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .hint.is-error {\n    color: var(--error-color);\n  }\n\n  .actions {\n    display: flex;\n    justify-content: flex-end;\n    gap: calc(var(--design-unit) * 2px);\n  }\n\n  .visually-hidden {\n    position: absolute;\n    width: 1px;\n    height: 1px;\n    margin: -1px;\n    padding: 0;\n    overflow: hidden;\n    clip-path: inset(50%);\n    white-space: nowrap;\n    border: 0;\n  }\n`"
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "AiChatInteractionWrapperStyles",
+          "name": "styles",
           "declaration": {
-            "name": "AiChatInteractionWrapperStyles",
-            "module": "src/components/chat-interaction-wrapper/chat-interaction-wrapper.styles.ts"
+            "name": "styles",
+            "module": "src/components/message-feedback/message-feedback.styles.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/chat-interaction-wrapper/chat-interaction-wrapper.template.ts",
+      "path": "src/components/message-feedback/message-feedback.template.ts",
       "declarations": [
         {
-          "kind": "variable",
-          "name": "AiChatInteractionWrapperTemplate",
-          "default": "html<AiChatInteractionWrapper>`\n  <div ${ref('container')} class=\"container\" part=\"container\"></div>\n`"
+          "kind": "function",
+          "name": "MessageFeedbackTemplate",
+          "return": {
+            "type": {
+              "text": "ViewTemplate<MessageFeedback>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "designSystemPrefix",
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "AiChatInteractionWrapperTemplate",
+          "name": "MessageFeedbackTemplate",
           "declaration": {
-            "name": "AiChatInteractionWrapperTemplate",
-            "module": "src/components/chat-interaction-wrapper/chat-interaction-wrapper.template.ts"
+            "name": "MessageFeedbackTemplate",
+            "module": "src/components/message-feedback/message-feedback.template.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/chat-interaction-wrapper/chat-interaction-wrapper.ts",
+      "path": "src/components/message-feedback/message-feedback.ts",
       "declarations": [
+        {
+          "kind": "function",
+          "name": "isRateableReply",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "m",
+              "type": {
+                "text": "ChatMessage"
+              }
+            }
+          ],
+          "description": "A final assistant reply, including the assistant's own notices: not reasoning, narration, a\ntool call, a tool result or a widget. Agrees with `filterVisibleMessages` on what is shown."
+        },
+        {
+          "kind": "function",
+          "name": "replyKey",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "m",
+              "type": {
+                "text": "ChatMessage"
+              }
+            }
+          ],
+          "description": "Survives the message object being replaced and the session being reloaded, which object\nidentity does not. Replies saved before timestamps existed fall back to their content."
+        },
+        {
+          "kind": "variable",
+          "name": "MESSAGE_FEEDBACK_EXPORTPARTS",
+          "description": "Forwarded by the assistant so `::part()` reaches inside from the host app."
+        },
         {
           "kind": "class",
-          "description": "Hosts an interactive AI chat sub-component by tag name.",
-          "name": "AiChatInteractionWrapper",
+          "description": "Thumbs up / thumbs down under one assistant reply, with a note panel for the pressed thumb.\nRendered by the assistant only when `chatConfig.ui.messageFeedback` is set.",
+          "name": "MessageFeedback",
           "members": [
             {
               "kind": "field",
-              "name": "resolved",
+              "name": "designSystemPrefix",
+              "type": {
+                "text": "string"
+              },
+              "default": "'rapid'"
+            },
+            {
+              "kind": "field",
+              "name": "message",
+              "type": {
+                "text": "ChatMessage | undefined"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "description",
+              "type": {
+                "text": "string"
+              },
+              "default": "''"
+            },
+            {
+              "kind": "field",
+              "name": "submit",
+              "type": {
+                "text": "MessageFeedbackSubmit | undefined"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Reflected so the assistant's reveal CSS can keep an open panel visible."
+            },
+            {
+              "kind": "field",
+              "name": "draftRating",
               "type": {
-                "text": "InteractionResult<unknown> | undefined"
+                "text": "ChatMessageFeedbackRating | null"
               },
-              "default": "undefined",
-              "description": "The resolved result once the interaction has completed. Forwarded to the rendered component. @internal"
+              "default": "null",
+              "description": "The thumb the open panel belongs to."
             },
             {
               "kind": "field",
-              "name": "outcome",
+              "name": "sentRating",
               "type": {
-                "text": "unknown"
+                "text": "ChatMessageFeedbackRating | null"
               },
-              "default": "undefined",
-              "description": "See `AiChatInteraction`'s resolved `outcome`: recorded after the answer, by the tool."
+              "default": "null",
+              "description": "The rating last sent for this reply; reflected so a rated reply keeps its thumbs visible."
             },
             {
               "kind": "field",
-              "name": "_resizeObserver",
+              "name": "note",
               "type": {
-                "text": "ResizeObserver | undefined"
+                "text": "string"
               },
-              "privacy": "private",
-              "description": "Observes the rendered widget for mid-lifecycle size changes — see observeWidgetResize."
+              "default": "''"
             },
             {
-              "kind": "method",
-              "name": "componentNameChanged"
+              "kind": "field",
+              "name": "status",
+              "type": {
+                "text": "MessageFeedbackStatus"
+              },
+              "default": "'idle'"
             },
             {
-              "kind": "method",
-              "name": "interactionIdChanged",
-              "description": "Re-render the hosted widget when the interaction identity changes. This\nensures widgets don't go stale with them being rendered with `recycle: true`\nwhen messages are dynamically filtered, showing/hiding thinking/tool calls\n\n`interactionId` is a per-interaction UUID, so it changes exactly when the\nhosted interaction does. Property bindings apply in template order\n(componentName, data, interactionId), so `data` is already rebound by the\ntime this fires and the fresh widget is built with the correct data."
+              "kind": "field",
+              "name": "announcement",
+              "type": {
+                "text": "string"
+              },
+              "default": "''"
+            },
+            {
+              "kind": "field",
+              "name": "sendGeneration",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "Bumped to disown an in-flight send: on Cancel, and when the row is rebound."
             },
             {
               "kind": "method",
-              "name": "resolvedChanged"
+              "name": "messageChanged",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "prev",
+                  "optional": true,
+                  "type": {
+                    "text": "ChatMessage"
+                  }
+                },
+                {
+                  "name": "next",
+                  "optional": true,
+                  "type": {
+                    "text": "ChatMessage"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "activeRating",
+              "type": {
+                "text": "ChatMessageFeedbackRating | null"
+              },
+              "description": "The thumb that reads as pressed: the open panel's, else the one already sent.",
+              "readonly": true
             },
             {
               "kind": "method",
-              "name": "outcomeChanged",
-              "description": "An outcome recorded after the answer reaches a widget already showing that answer."
+              "name": "toggle",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "rating",
+                  "type": {
+                    "text": "ChatMessageFeedbackRating"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
-              "name": "resolvedInteraction",
-              "privacy": "private",
+              "name": "cancel",
               "return": {
                 "type": {
-                  "text": "AiChatInteraction"
+                  "text": "void"
                 }
               },
-              "description": "The resolved descriptor, with the outcome when one has been recorded."
+              "description": "Also abandons an in-flight send, so a hung transport cannot trap the user in the panel."
             },
             {
               "kind": "method",
-              "name": "observeWidgetResize",
-              "privacy": "private",
+              "name": "noteInput",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
               "parameters": [
                 {
-                  "name": "element",
+                  "name": "value",
                   "type": {
-                    "text": "Element"
+                    "text": "string"
                   }
                 }
-              ],
-              "description": "Watch the rendered widget element for box-size changes. When the widget\ngrows or shrinks mid-lifecycle (e.g. expanding a \"More info\" panel,\nappending an SSE status row, revealing generated code), bubble a\n`request-scroll-to-bottom` event so `FoundationAiAssistant` re-snaps to\nthe bottom. `scrollToBottom` respects `_userScrolledAway`, so a user\nreading old messages is not yanked back.\n\nThe first ResizeObserver callback fires synchronously with the initial\nsize when `observe()` is called; we skip it so freshly-rendered widgets\ndon't double up with the existing `handleMessagesUpdate` auto-scroll for\nnew messages."
+              ]
             },
             {
               "kind": "method",
-              "name": "renderComponent",
-              "privacy": "private"
+              "name": "send",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              }
             },
             {
               "kind": "method",
-              "name": "buildInteraction",
+              "name": "restoreThumbFocus",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "AiChatInteraction"
+                  "text": "void"
                 }
               },
               "parameters": [
                 {
-                  "name": "host",
+                  "name": "rating",
                   "type": {
-                    "text": "InteractionHost | null"
+                    "text": "ChatMessageFeedbackRating | null"
                   }
                 }
               ],
-              "description": "Project the wrapper's current `data`/`resolved`/`interactionId` into the\ndiscriminated AiChatInteraction the widget consumes (GENC-1390)."
+              "description": "Closing the panel unmounts the focused note; hand focus back to the thumb that opened it."
+            },
+            {
+              "kind": "method",
+              "name": "ownsFocus",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "Focus is ours to move only while it is nowhere in particular or still inside this element —\nnot once the user has gone on to type in the composer during a slow send. Walks the shadow\nroots, since `document.activeElement` is the assistant host for both."
             }
           ],
-          "events": [
+          "attributes": [
             {
-              "name": "request-scroll-to-bottom",
               "type": {
-                "text": "CustomEvent"
-              }
-            },
-            {
-              "description": "Fired when the interaction finishes. detail: `InteractionCompletedEventDetail`",
-              "name": "interaction-completed"
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Reflected so the assistant's reveal CSS can keep an open panel visible.",
+              "fieldName": "open"
             },
             {
-              "description": "Fired when a widget spends money AFTER resolving. detail: `InteractionCostEventDetail`",
-              "name": "interaction-cost"
+              "name": "rated",
+              "type": {
+                "text": "ChatMessageFeedbackRating | null"
+              },
+              "default": "null",
+              "description": "The rating last sent for this reply; reflected so a rated reply keeps its thumbs visible.",
+              "fieldName": "sentRating"
             }
           ],
           "superclass": {
             "name": "GenesisElement",
             "package": "@genesislcap/web-core"
           },
-          "tagName": "ai-chat-interaction-wrapper",
+          "tagName": "foundation-ai-message-feedback",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "AiChatInteractionWrapper",
-          "declaration": {
-            "name": "AiChatInteractionWrapper",
-            "module": "src/components/chat-interaction-wrapper/chat-interaction-wrapper.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "ai-chat-interaction-wrapper",
-          "declaration": {
-            "name": "AiChatInteractionWrapper",
-            "module": "src/components/chat-interaction-wrapper/chat-interaction-wrapper.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/chat-interaction-wrapper/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./chat-interaction-wrapper"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "*",
+          "name": "isRateableReply",
           "declaration": {
-            "name": "*",
-            "package": "./chat-interaction-wrapper.styles"
+            "name": "isRateableReply",
+            "module": "src/components/message-feedback/message-feedback.ts"
           }
         },
         {
           "kind": "js",
-          "name": "*",
+          "name": "replyKey",
           "declaration": {
-            "name": "*",
-            "package": "./chat-interaction-wrapper.template"
+            "name": "replyKey",
+            "module": "src/components/message-feedback/message-feedback.ts"
           }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/chat-markdown/chat-markdown.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "MARKDOWN_EXPORTPARTS",
-          "type": {
-            "text": "string"
-          },
-          "description": "Every part this component exposes, as an `exportparts` value.\n\n`::part()` crosses exactly one shadow boundary, so a host that renders `<ai-chat-markdown>` in\nits own shadow root has to forward these for an app to reach them at all. Built from the map\nabove rather than written out, so the forwarded list cannot drift from what is emitted."
         },
-        {
-          "kind": "class",
-          "description": "",
-          "name": "AiChatMarkdown",
-          "members": [
-            {
-              "kind": "field",
-              "name": "content",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "The markdown string to render."
-            },
-            {
-              "kind": "method",
-              "name": "annotateParts",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "string"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "fragment",
-                  "type": {
-                    "text": "DocumentFragment"
-                  }
-                }
-              ],
-              "description": "Tag the generated elements with shadow parts so an embedding app can style them.\n\nTakes the tree DOMPurify built rather than re-parsing its serialised output: `content` changes\non every streamed chunk, so a second parse/serialise round trip would run per chunk over the\nwhole message, and the string the browser finally parses is then serialised straight from the\ntree DOMPurify checked. Parse/serialise mismatches are where mXSS bypasses have historically\nlived, and this walk has no need to introduce one.\n\nOnly ever *adds* attributes, to DOM that has already been cleared - so it is not itself\nsanitiser surface.\n\nLists additionally carry a level: a top-level list is `md-ul md-ul-level-1`, a list nested\ninside it is `md-ul-level-2`, and an `li` takes the level of the list holding it. Levels are\nclamped at `MAX_LIST_LEVEL`, so a list deeper than that answers to the deepest level\nrather than to a name no host forwards. Chat markdown rarely nests, so this is a safety valve\nrather than a feature - without it, every list at every depth would answer to one selector and\nthere would be no way to tell them apart afterwards. Depth comes from walking the tree rather\nthan from marked's renderers, which are invoked innermost-first and so cannot count downwards."
-            }
-          ],
-          "superclass": {
-            "name": "GenesisElement",
-            "package": "@genesislcap/web-core"
-          },
-          "tagName": "ai-chat-markdown",
-          "customElement": true
-        }
-      ],
-      "exports": [
         {
           "kind": "js",
-          "name": "MARKDOWN_EXPORTPARTS",
+          "name": "MESSAGE_FEEDBACK_EXPORTPARTS",
           "declaration": {
-            "name": "MARKDOWN_EXPORTPARTS",
-            "module": "src/components/chat-markdown/chat-markdown.ts"
+            "name": "MESSAGE_FEEDBACK_EXPORTPARTS",
+            "module": "src/components/message-feedback/message-feedback.ts"
           }
         },
         {
           "kind": "js",
-          "name": "AiChatMarkdown",
+          "name": "MessageFeedback",
           "declaration": {
-            "name": "AiChatMarkdown",
-            "module": "src/components/chat-markdown/chat-markdown.ts"
+            "name": "MessageFeedback",
+            "module": "src/components/message-feedback/message-feedback.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "ai-chat-markdown",
-          "declaration": {
-            "name": "AiChatMarkdown",
-            "module": "src/components/chat-markdown/chat-markdown.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/chat-markdown/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
+          "name": "foundation-ai-message-feedback",
           "declaration": {
-            "name": "*",
-            "package": "./chat-markdown"
+            "name": "MessageFeedback",
+            "module": "src/components/message-feedback/message-feedback.ts"
           }
         }
       ]