@genesislcap/ai-assistant 15.60.0 → 15.61.0

package/dist/custom-elements.json

@@ -1120,220 +1120,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/channel/ai-activity-bus.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "NOOP_ACTIVITY_BUS",
-          "type": {
-            "text": "ActivityBus"
-          },
-          "default": "{ publish: () => {} }",
-          "description": "No-op ActivityBus. The default when no bus is injected (Node, tests, headless\nserver use) — publishing goes nowhere and nothing is left open to tear down."
-        },
-        {
-          "kind": "class",
-          "description": "Typed in-process event bus for AI assistant activity events.\n\nDispatches events synchronously to all local subscribers in the same JS module instance\n(i.e. the same browser tab). Events listed in `crossTabEvents` are additionally forwarded\nvia a shared `BroadcastChannel` so that other tabs on the same origin receive them.",
-          "name": "AgenticActivityBus",
-          "members": [
-            {
-              "kind": "field",
-              "name": "subscribers",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new Map<string, Set<AnyHandler>>()"
-            },
-            {
-              "kind": "field",
-              "name": "crossTabEvents",
-              "type": {
-                "text": "Set<string>"
-              },
-              "privacy": "private",
-              "readonly": true,
-              "default": "new Set(config?.crossTabEvents ?? [])"
-            },
-            {
-              "kind": "field",
-              "name": "channelNameFactory",
-              "type": {
-                "text": "() => string | undefined"
-              },
-              "privacy": "private",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "channel",
-              "type": {
-                "text": "BroadcastChannel | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "channelInitialised",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "default": "false"
-            },
-            {
-              "kind": "method",
-              "name": "ensureChannel",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "description": "Lazily open the cross-tab `BroadcastChannel` on first use. Deferred (rather than\ncreated in the constructor) so that importing this module, or constructing the bus\noff-browser (Node, tests, headless server), never opens a live channel or reads\n`sessionStorage` — both would keep a Node event loop alive and hang the process.\nCross-tab forwarding is inherently browser-only, so channel creation is gated on a\nbrowser environment; elsewhere the bus stays purely in-process."
-            },
-            {
-              "kind": "method",
-              "name": "subscribe",
-              "return": {
-                "type": {
-                  "text": "() => void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "type",
-                  "type": {
-                    "text": "K"
-                  }
-                },
-                {
-                  "name": "handler",
-                  "type": {
-                    "text": "(detail: AgenticActivityEvents[K]) => void"
-                  }
-                }
-              ],
-              "description": "Subscribe to an event. Returns an unsubscribe function — call it in\n`disconnectedCallback` to avoid memory leaks."
-            },
-            {
-              "kind": "method",
-              "name": "publish",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "type",
-                  "type": {
-                    "text": "K"
-                  }
-                },
-                {
-                  "name": "detail",
-                  "type": {
-                    "text": "AgenticActivityEvents[K]"
-                  }
-                }
-              ],
-              "description": "Publish an event to all local subscribers and, if configured, to other tabs\nvia BroadcastChannel."
-            },
-            {
-              "kind": "method",
-              "name": "addCrossTabEvent",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "type",
-                  "type": {
-                    "text": "keyof AgenticActivityEvents"
-                  }
-                }
-              ],
-              "description": "Add an event type to the cross-tab forwarding set at runtime.\nMust be called before the first AgenticActivityBus.publish of that event type."
-            },
-            {
-              "kind": "method",
-              "name": "close",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "description": "Close the underlying BroadcastChannel. Call once on application teardown if needed."
-            },
-            {
-              "kind": "method",
-              "name": "notifyLocal",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "type",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "detail",
-                  "type": {
-                    "text": "unknown"
-                  }
-                }
-              ]
-            }
-          ]
-        },
-        {
-          "kind": "variable",
-          "name": "agenticActivityBus",
-          "default": "new AgenticActivityBus({\n  crossTabEvents: ['halo-start', 'halo-stop', 'tool-loop-start', 'tool-loop-end'],\n  // Lazy: the tab-scoped name (and its `sessionStorage` read) is computed on first\n  // cross-tab use in a browser, not at module-eval — so importing this module is\n  // side-effect-free and Node/test-safe.\n  channelNameFactory: () => getTabScopedChannelName('foundation-ai-activity'),\n})",
-          "description": "Pre-instantiated singleton event bus for AI assistant activity.\n\n- `halo-start` / `halo-stop` are forwarded via a tab-scoped `BroadcastChannel` so that\n  popout windows opened from this tab show halo animations, while remaining isolated from\n  unrelated tabs on the same origin (tab-scoped channel name).\n- `tool-loop-start` / `tool-loop-end` are cross-tab for the same reason: they describe the\n  assistant's lifecycle (a turn beginning / ending), and the most common subscribers\n  (workspace transitions, post-turn deferred recomputation, UI gates tied to the assistant\n  being idle) need the event regardless of whether the user is interacting with the chat\n  in the main tab or a popout window. Tab-local-only telemetry can subscribe and filter.\n- `chat-popout` / `chat-popin` are in-memory only — they must only affect the tab where the\n  user clicked."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "NOOP_ACTIVITY_BUS",
-          "declaration": {
-            "name": "NOOP_ACTIVITY_BUS",
-            "module": "src/channel/ai-activity-bus.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "AgenticActivityBus",
-          "declaration": {
-            "name": "AgenticActivityBus",
-            "module": "src/channel/ai-activity-bus.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "agenticActivityBus",
-          "declaration": {
-            "name": "agenticActivityBus",
-            "module": "src/channel/ai-activity-bus.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/channel/ai-activity-channel.ts",
-      "declarations": [],
-      "exports": []
-    },
     {
       "kind": "javascript-module",
       "path": "src/components/flowing-waves-indicator.ts",
@@ -1860,491 +1646,910 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/genesis/calendar.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/genesis/config.ts",
+      "path": "src/channel/ai-activity-bus.ts",
       "declarations": [
         {
           "kind": "variable",
-          "name": "DEFAULT_MAX_ROWS",
-          "type": {
-            "text": "number"
-          },
-          "default": "50",
-          "description": "The default read cap, and the ceiling the config may raise it to."
-        },
-        {
-          "kind": "variable",
-          "name": "MAX_ROWS_CEILING",
+          "name": "NOOP_ACTIVITY_BUS",
           "type": {
-            "text": "number"
+            "text": "ActivityBus"
           },
-          "default": "1000"
+          "default": "{ publish: () => {} }",
+          "description": "No-op ActivityBus. The default when no bus is injected (Node, tests, headless\nserver use) — publishing goes nowhere and nothing is left open to tear down."
         },
         {
-          "kind": "function",
-          "name": "toolNameOf",
-          "return": {
-            "type": {
-              "text": "string"
-            }
-          },
-          "parameters": [
+          "kind": "class",
+          "description": "Typed in-process event bus for AI assistant activity events.\n\nDispatches events synchronously to all local subscribers in the same JS module instance\n(i.e. the same browser tab). Events listed in `crossTabEvents` are additionally forwarded\nvia a shared `BroadcastChannel` so that other tabs on the same origin receive them.",
+          "name": "AgenticActivityBus",
+          "members": [
             {
-              "name": "resourceName",
-              "type": {
-                "text": "string"
-              }
-            }
-          ],
-          "description": "The model-facing tool name for a resource. Deterministic and collision-free (resource names\nare unique), and trivially mapped back to the resource in a debug log. What the tool is FOR\nreaches the model through its description, not its name."
-        },
-        {
-          "kind": "function",
-          "name": "rowActionProblem",
-          "return": {
-            "type": {
-              "text": "string | undefined"
-            }
-          },
-          "parameters": [
+              "kind": "field",
+              "name": "subscribers",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new Map<string, Set<AnyHandler>>()"
+            },
             {
-              "name": "resource",
+              "kind": "field",
+              "name": "crossTabEvents",
               "type": {
-                "text": "Partial<GenesisAiResource> | null"
-              }
+                "text": "Set<string>"
+              },
+              "privacy": "private",
+              "readonly": true,
+              "default": "new Set(config?.crossTabEvents ?? [])"
             },
             {
-              "name": "requestNames",
+              "kind": "field",
+              "name": "channelNameFactory",
               "type": {
-                "text": "ReadonlySet<string>"
+                "text": "() => string | undefined"
               },
-              "description": "The request resources whose rows can be read. A row action reads its rows\nthrough `REQ_<entity>`, and without one there is no row to review."
+              "privacy": "private",
+              "readonly": true
             },
             {
-              "name": "whyNotReadable",
-              "default": "notReadableReason({})",
+              "kind": "field",
+              "name": "channel",
               "type": {
-                "text": "(name: string) => string"
+                "text": "BroadcastChannel | undefined"
               },
-              "description": "Why a request is not among `requestNames`, when the caller knows: it was\nleft out, has no read tool, or is a query. Without it, the request is said to be missing."
-            }
-          ],
-          "description": "What is wrong with a resource's row-action fields (contracts C-18.7.2), if anything."
-        },
-        {
-          "kind": "function",
-          "name": "validateGenesisAiConfig",
-          "return": {
-            "type": {
-              "text": "GenesisAiConfigCheck"
-            }
-          },
-          "parameters": [
+              "privacy": "private"
+            },
             {
-              "name": "config",
+              "kind": "field",
+              "name": "channelInitialised",
               "type": {
-                "text": "unknown"
-              }
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "method",
+              "name": "ensureChannel",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Lazily open the cross-tab `BroadcastChannel` on first use. Deferred (rather than\ncreated in the constructor) so that importing this module, or constructing the bus\noff-browser (Node, tests, headless server), never opens a live channel or reads\n`sessionStorage` — both would keep a Node event loop alive and hang the process.\nCross-tab forwarding is inherently browser-only, so channel creation is gated on a\nbrowser environment; elsewhere the bus stays purely in-process."
+            },
+            {
+              "kind": "method",
+              "name": "subscribe",
+              "return": {
+                "type": {
+                  "text": "() => void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "K"
+                  }
+                },
+                {
+                  "name": "handler",
+                  "type": {
+                    "text": "(detail: AgenticActivityEvents[K]) => void"
+                  }
+                }
+              ],
+              "description": "Subscribe to an event. Returns an unsubscribe function — call it in\n`disconnectedCallback` to avoid memory leaks."
+            },
+            {
+              "kind": "method",
+              "name": "publish",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "K"
+                  }
+                },
+                {
+                  "name": "detail",
+                  "type": {
+                    "text": "AgenticActivityEvents[K]"
+                  }
+                }
+              ],
+              "description": "Publish an event to all local subscribers and, if configured, to other tabs\nvia BroadcastChannel."
+            },
+            {
+              "kind": "method",
+              "name": "addCrossTabEvent",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "keyof AgenticActivityEvents"
+                  }
+                }
+              ],
+              "description": "Add an event type to the cross-tab forwarding set at runtime.\nMust be called before the first AgenticActivityBus.publish of that event type."
+            },
+            {
+              "kind": "method",
+              "name": "close",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Close the underlying BroadcastChannel. Call once on application teardown if needed."
+            },
+            {
+              "kind": "method",
+              "name": "notifyLocal",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "detail",
+                  "type": {
+                    "text": "unknown"
+                  }
+                }
+              ]
             }
-          ],
-          "description": "Checks a generated AI config before anything is registered, and says what can be kept."
+          ]
         },
         {
-          "kind": "function",
-          "name": "customCodeOf",
-          "return": {
-            "type": {
-              "text": "GenesisCustomCodeCheck"
-            }
-          },
-          "parameters": [
-            {
-              "name": "resource",
-              "type": {
-                "text": "GenesisAiResource"
-              }
-            }
-          ],
-          "description": "A resource's `customCode` as it is used: the one reader of the field."
+          "kind": "variable",
+          "name": "agenticActivityBus",
+          "default": "new AgenticActivityBus({\n  crossTabEvents: ['halo-start', 'halo-stop', 'tool-loop-start', 'tool-loop-end'],\n  // Lazy: the tab-scoped name (and its `sessionStorage` read) is computed on first\n  // cross-tab use in a browser, not at module-eval — so importing this module is\n  // side-effect-free and Node/test-safe.\n  channelNameFactory: () => getTabScopedChannelName('foundation-ai-activity'),\n})",
+          "description": "Pre-instantiated singleton event bus for AI assistant activity.\n\n- `halo-start` / `halo-stop` are forwarded via a tab-scoped `BroadcastChannel` so that\n  popout windows opened from this tab show halo animations, while remaining isolated from\n  unrelated tabs on the same origin (tab-scoped channel name).\n- `tool-loop-start` / `tool-loop-end` are cross-tab for the same reason: they describe the\n  assistant's lifecycle (a turn beginning / ending), and the most common subscribers\n  (workspace transitions, post-turn deferred recomputation, UI gates tied to the assistant\n  being idle) need the event regardless of whether the user is interacting with the chat\n  in the main tab or a popout window. Tab-local-only telemetry can subscribe and filter.\n- `chat-popout` / `chat-popin` are in-memory only — they must only affect the tab where the\n  user clicked."
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "DEFAULT_MAX_ROWS",
+          "name": "NOOP_ACTIVITY_BUS",
           "declaration": {
-            "name": "DEFAULT_MAX_ROWS",
-            "module": "src/genesis/config.ts"
+            "name": "NOOP_ACTIVITY_BUS",
+            "module": "src/channel/ai-activity-bus.ts"
           }
         },
         {
           "kind": "js",
-          "name": "MAX_ROWS_CEILING",
+          "name": "AgenticActivityBus",
           "declaration": {
-            "name": "MAX_ROWS_CEILING",
-            "module": "src/genesis/config.ts"
+            "name": "AgenticActivityBus",
+            "module": "src/channel/ai-activity-bus.ts"
           }
         },
         {
           "kind": "js",
-          "name": "toolNameOf",
+          "name": "agenticActivityBus",
           "declaration": {
-            "name": "toolNameOf",
-            "module": "src/genesis/config.ts"
+            "name": "agenticActivityBus",
+            "module": "src/channel/ai-activity-bus.ts"
           }
-        },
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/channel/ai-activity-channel.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "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": "rowActionProblem",
+          "name": "CachePolicy",
           "declaration": {
-            "name": "rowActionProblem",
-            "module": "src/genesis/config.ts"
+            "name": "CachePolicy",
+            "module": "src/config/config.ts"
           }
         },
         {
           "kind": "js",
-          "name": "validateGenesisAiConfig",
+          "name": "ChatFallback",
           "declaration": {
-            "name": "validateGenesisAiConfig",
-            "module": "src/genesis/config.ts"
+            "name": "ChatFallback",
+            "module": "src/config/config.ts"
           }
         },
         {
           "kind": "js",
-          "name": "customCodeOf",
+          "name": "ChatInputDuringExecutionMode",
           "declaration": {
-            "name": "customCodeOf",
-            "module": "src/genesis/config.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/genesis/consumes.ts",
-      "declarations": [
+            "name": "ChatInputDuringExecutionMode",
+            "module": "src/config/config.ts"
+          }
+        },
         {
-          "kind": "variable",
-          "name": "GENESIS_AI_CONSUMES",
-          "type": {
-            "text": "GenesisAiConsumes"
-          },
-          "description": "What this version of the assistant reads from a generated AI config: the resource kinds it\naccepts, the resource fields its validator or a tool reads, the `vendor` and `tier` values it\naccepts, and the row-action shapes it runs."
-        }
-      ],
-      "exports": [
+          "kind": "js",
+          "name": "ChatThinkingPolicy",
+          "declaration": {
+            "name": "ChatThinkingPolicy",
+            "module": "src/config/config.ts"
+          }
+        },
         {
           "kind": "js",
-          "name": "GenesisAiConsumes",
+          "name": "ChatToolChoice",
           "declaration": {
-            "name": "GenesisAiConsumes",
-            "module": "./types"
+            "name": "ChatToolChoice",
+            "module": "src/config/config.ts"
           }
         },
         {
           "kind": "js",
-          "name": "GENESIS_AI_CONSUMES",
+          "name": "defineAgent",
           "declaration": {
-            "name": "GENESIS_AI_CONSUMES",
-            "module": "src/genesis/consumes.ts"
+            "name": "defineAgent",
+            "module": "src/config/config.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/genesis/criteria.ts",
+      "path": "src/config/define-stateful-agent.ts",
       "declarations": [
         {
           "kind": "function",
-          "name": "dateFragment",
+          "name": "restoreMachine",
           "return": {
             "type": {
-              "text": "string | undefined"
+              "text": "void"
             }
           },
           "parameters": [
             {
-              "name": "field",
+              "name": "machine",
               "type": {
-                "text": "string"
-              }
+                "text": "{ stop: () => void; start: (options?: { state?: unknown }) => void }"
+              },
+              "description": "the machine to restore (already constructed/started)."
             },
             {
-              "name": "op",
+              "name": "restored",
               "type": {
-                "text": "GenesisFilterOp"
-              }
+                "text": "unknown"
+              },
+              "description": "the agent's serialized image (`ctx.restored` in `init`)."
             },
             {
-              "name": "date",
-              "type": {
-                "text": "string"
-              }
+              "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": "dateTimeFragment",
+          "name": "defineStatefulAgent",
           "return": {
             "type": {
-              "text": "string | undefined"
+              "text": "AgentConfig"
             }
           },
           "parameters": [
             {
-              "name": "field",
-              "type": {
-                "text": "string"
-              }
-            },
-            {
-              "name": "op",
-              "type": {
-                "text": "GenesisFilterOp"
-              }
-            },
-            {
-              "name": "bound",
+              "name": "opts",
               "type": {
-                "text": "string"
+                "text": "StatefulAgentInit<S>"
               }
             }
           ],
-          "description": "Timestamp columns get the dateTime helpers, which take a `yyyyMMdd-HH:mm:ss` bound."
+          "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": "dateFragment",
+          "name": "restoreMachine",
           "declaration": {
-            "name": "dateFragment",
-            "module": "src/genesis/criteria.ts"
+            "name": "restoreMachine",
+            "module": "src/config/define-stateful-agent.ts"
           }
         },
         {
           "kind": "js",
-          "name": "dateTimeFragment",
+          "name": "defineStatefulAgent",
           "declaration": {
-            "name": "dateTimeFragment",
-            "module": "src/genesis/criteria.ts"
+            "name": "defineStatefulAgent",
+            "module": "src/config/define-stateful-agent.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/genesis/event-fields.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/genesis/filter-fields.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/genesis/index.ts",
-      "declarations": [],
-      "exports": [
+      "path": "src/config/fallback-agents.ts",
+      "declarations": [
         {
-          "kind": "js",
-          "name": "GENESIS_AGENT_NAME",
-          "declaration": {
-            "name": "GENESIS_AGENT_NAME",
-            "module": "./register-genesis-assistant"
-          }
+          "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": "js",
-          "name": "registerGenesisAssistant",
-          "declaration": {
-            "name": "registerGenesisAssistant",
-            "module": "./register-genesis-assistant"
-          }
-        },
+          "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": "customCodeOf",
+          "name": "friendlyFallbackAgent",
           "declaration": {
-            "name": "customCodeOf",
-            "module": "./config"
+            "name": "friendlyFallbackAgent",
+            "module": "src/config/fallback-agents.ts"
           }
         },
         {
           "kind": "js",
-          "name": "rowActionProblem",
+          "name": "strictFallbackAgent",
           "declaration": {
-            "name": "rowActionProblem",
-            "module": "./config"
+            "name": "strictFallbackAgent",
+            "module": "src/config/fallback-agents.ts"
           }
-        },
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/config/index.ts",
+      "declarations": [],
+      "exports": [
         {
           "kind": "js",
-          "name": "GENESIS_AI_CONSUMES",
+          "name": "*",
           "declaration": {
-            "name": "GENESIS_AI_CONSUMES",
-            "module": "./consumes"
+            "name": "*",
+            "package": "./config"
           }
         },
         {
           "kind": "js",
-          "name": "validateGenesisAiConfig",
+          "name": "*",
           "declaration": {
-            "name": "validateGenesisAiConfig",
-            "module": "./config"
+            "name": "*",
+            "package": "./fallback-agents"
           }
-        },
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/config/validate-providers.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/genesis/calendar.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/genesis/config.ts",
+      "declarations": [
         {
-          "kind": "js",
-          "name": "DroppedResource",
-          "declaration": {
-            "name": "DroppedResource",
-            "module": "./config"
-          }
+          "kind": "variable",
+          "name": "DEFAULT_MAX_ROWS",
+          "type": {
+            "text": "number"
+          },
+          "default": "50",
+          "description": "The default read cap, and the ceiling the config may raise it to."
         },
         {
-          "kind": "js",
-          "name": "GenesisAiConfigCheck",
-          "declaration": {
-            "name": "GenesisAiConfigCheck",
-            "module": "./config"
-          }
+          "kind": "variable",
+          "name": "MAX_ROWS_CEILING",
+          "type": {
+            "text": "number"
+          },
+          "default": "1000"
         },
         {
-          "kind": "js",
-          "name": "GenesisFilter",
-          "declaration": {
-            "name": "GenesisFilter",
-            "module": "./criteria"
-          }
+          "kind": "function",
+          "name": "toolNameOf",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "resourceName",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "The model-facing tool name for a resource. Deterministic and collision-free (resource names\nare unique), and trivially mapped back to the resource in a debug log. What the tool is FOR\nreaches the model through its description, not its name."
         },
         {
-          "kind": "js",
-          "name": "GenesisFilterField",
-          "declaration": {
-            "name": "GenesisFilterField",
-            "module": "./criteria"
-          }
+          "kind": "function",
+          "name": "rowActionProblem",
+          "return": {
+            "type": {
+              "text": "string | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "resource",
+              "type": {
+                "text": "Partial<GenesisAiResource> | null"
+              }
+            },
+            {
+              "name": "requestNames",
+              "type": {
+                "text": "ReadonlySet<string>"
+              },
+              "description": "The request resources whose rows can be read. A row action reads its rows\nthrough `REQ_<entity>`, and without one there is no row to review."
+            },
+            {
+              "name": "whyNotReadable",
+              "default": "notReadableReason({})",
+              "type": {
+                "text": "(name: string) => string"
+              },
+              "description": "Why a request is not among `requestNames`, when the caller knows: it was\nleft out, has no read tool, or is a query. Without it, the request is said to be missing."
+            }
+          ],
+          "description": "What is wrong with a resource's row-action fields (contracts C-18.7.2), if anything."
+        },
+        {
+          "kind": "function",
+          "name": "validateGenesisAiConfig",
+          "return": {
+            "type": {
+              "text": "GenesisAiConfigCheck"
+            }
+          },
+          "parameters": [
+            {
+              "name": "config",
+              "type": {
+                "text": "unknown"
+              }
+            }
+          ],
+          "description": "Checks a generated AI config before anything is registered, and says what can be kept."
         },
+        {
+          "kind": "function",
+          "name": "customCodeOf",
+          "return": {
+            "type": {
+              "text": "GenesisCustomCodeCheck"
+            }
+          },
+          "parameters": [
+            {
+              "name": "resource",
+              "type": {
+                "text": "GenesisAiResource"
+              }
+            }
+          ],
+          "description": "A resource's `customCode` as it is used: the one reader of the field."
+        }
+      ],
+      "exports": [
         {
           "kind": "js",
-          "name": "GenesisFilterOp",
+          "name": "DEFAULT_MAX_ROWS",
           "declaration": {
-            "name": "GenesisFilterOp",
-            "module": "./criteria"
+            "name": "DEFAULT_MAX_ROWS",
+            "module": "src/genesis/config.ts"
           }
         },
         {
           "kind": "js",
-          "name": "createGenesisResourceTools",
+          "name": "MAX_ROWS_CEILING",
           "declaration": {
-            "name": "createGenesisResourceTools",
-            "module": "./resource-tools"
+            "name": "MAX_ROWS_CEILING",
+            "module": "src/genesis/config.ts"
           }
         },
         {
           "kind": "js",
-          "name": "GENESIS_DATA_SOURCE",
+          "name": "toolNameOf",
           "declaration": {
-            "name": "GENESIS_DATA_SOURCE",
-            "module": "./resource-tools"
+            "name": "toolNameOf",
+            "module": "src/genesis/config.ts"
           }
         },
         {
           "kind": "js",
-          "name": "createGenesisWriteTools",
+          "name": "rowActionProblem",
           "declaration": {
-            "name": "createGenesisWriteTools",
-            "module": "./write-tools"
+            "name": "rowActionProblem",
+            "module": "src/genesis/config.ts"
           }
         },
         {
           "kind": "js",
-          "name": "GenesisWriteDecision",
+          "name": "validateGenesisAiConfig",
           "declaration": {
-            "name": "GenesisWriteDecision",
-            "module": "./write-tools"
+            "name": "validateGenesisAiConfig",
+            "module": "src/genesis/config.ts"
           }
         },
         {
           "kind": "js",
-          "name": "GenesisWriteResult",
+          "name": "customCodeOf",
           "declaration": {
-            "name": "GenesisWriteResult",
-            "module": "./write-tools"
+            "name": "customCodeOf",
+            "module": "src/genesis/config.ts"
           }
-        },
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/genesis/consumes.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "GENESIS_AI_CONSUMES",
+          "type": {
+            "text": "GenesisAiConsumes"
+          },
+          "description": "What this version of the assistant reads from a generated AI config: the resource kinds it\naccepts, the resource fields its validator or a tool reads, the `vendor` and `tier` values it\naccepts, and the row-action shapes it runs."
+        }
+      ],
+      "exports": [
         {
           "kind": "js",
-          "name": "GenesisWriteRowStatus",
+          "name": "GenesisAiConsumes",
           "declaration": {
-            "name": "GenesisWriteRowStatus",
-            "module": "./write-tools"
+            "name": "GenesisAiConsumes",
+            "module": "./types"
           }
         },
         {
           "kind": "js",
-          "name": "GenesisWriteToolsOptions",
+          "name": "GENESIS_AI_CONSUMES",
           "declaration": {
-            "name": "GenesisWriteToolsOptions",
-            "module": "./write-tools"
+            "name": "GENESIS_AI_CONSUMES",
+            "module": "src/genesis/consumes.ts"
           }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/genesis/criteria.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "dateFragment",
+          "return": {
+            "type": {
+              "text": "string | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "field",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "op",
+              "type": {
+                "text": "GenesisFilterOp"
+              }
+            },
+            {
+              "name": "date",
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
         },
+        {
+          "kind": "function",
+          "name": "dateTimeFragment",
+          "return": {
+            "type": {
+              "text": "string | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "field",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "op",
+              "type": {
+                "text": "GenesisFilterOp"
+              }
+            },
+            {
+              "name": "bound",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Timestamp columns get the dateTime helpers, which take a `yyyyMMdd-HH:mm:ss` bound."
+        }
+      ],
+      "exports": [
         {
           "kind": "js",
-          "name": "GENESIS_WRITE_REVIEW",
+          "name": "dateFragment",
           "declaration": {
-            "name": "GENESIS_WRITE_REVIEW",
-            "module": "./write-review/write-review"
+            "name": "dateFragment",
+            "module": "src/genesis/criteria.ts"
           }
         },
         {
           "kind": "js",
-          "name": "GenesisWriteReview",
+          "name": "dateTimeFragment",
           "declaration": {
-            "name": "GenesisWriteReview",
-            "module": "./write-review/write-review"
+            "name": "dateTimeFragment",
+            "module": "src/genesis/criteria.ts"
           }
-        },
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/genesis/event-fields.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/genesis/filter-fields.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/genesis/index.ts",
+      "declarations": [],
+      "exports": [
         {
           "kind": "js",
-          "name": "GenesisChangeRequest",
+          "name": "GENESIS_AGENT_NAME",
           "declaration": {
-            "name": "GenesisChangeRequest",
-            "module": "./review-payload"
+            "name": "GENESIS_AGENT_NAME",
+            "module": "./register-genesis-assistant"
           }
         },
         {
           "kind": "js",
-          "name": "GenesisReviewPayload",
+          "name": "registerGenesisAssistant",
           "declaration": {
-            "name": "GenesisReviewPayload",
-            "module": "./review-payload"
+            "name": "registerGenesisAssistant",
+            "module": "./register-genesis-assistant"
           }
         },
         {
           "kind": "js",
-          "name": "GenesisWriteReviewCompletedEventDetail",
+          "name": "customCodeOf",
           "declaration": {
-            "name": "GenesisWriteReviewCompletedEventDetail",
-            "module": "./review-payload"
+            "name": "customCodeOf",
+            "module": "./config"
           }
         },
         {
           "kind": "js",
-          "name": "GenesisReadResult",
+          "name": "rowActionProblem",
           "declaration": {
-            "name": "GenesisReadResult",
+            "name": "rowActionProblem",
+            "module": "./config"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GENESIS_AI_CONSUMES",
+          "declaration": {
+            "name": "GENESIS_AI_CONSUMES",
+            "module": "./consumes"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "validateGenesisAiConfig",
+          "declaration": {
+            "name": "validateGenesisAiConfig",
+            "module": "./config"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "DroppedResource",
+          "declaration": {
+            "name": "DroppedResource",
+            "module": "./config"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GenesisAiConfigCheck",
+          "declaration": {
+            "name": "GenesisAiConfigCheck",
+            "module": "./config"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GenesisFilter",
+          "declaration": {
+            "name": "GenesisFilter",
+            "module": "./criteria"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GenesisFilterField",
+          "declaration": {
+            "name": "GenesisFilterField",
+            "module": "./criteria"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GenesisFilterOp",
+          "declaration": {
+            "name": "GenesisFilterOp",
+            "module": "./criteria"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "createGenesisResourceTools",
+          "declaration": {
+            "name": "createGenesisResourceTools",
+            "module": "./resource-tools"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GENESIS_DATA_SOURCE",
+          "declaration": {
+            "name": "GENESIS_DATA_SOURCE",
+            "module": "./resource-tools"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "createGenesisWriteTools",
+          "declaration": {
+            "name": "createGenesisWriteTools",
+            "module": "./write-tools"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GenesisWriteDecision",
+          "declaration": {
+            "name": "GenesisWriteDecision",
+            "module": "./write-tools"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GenesisWriteResult",
+          "declaration": {
+            "name": "GenesisWriteResult",
+            "module": "./write-tools"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GenesisWriteRowStatus",
+          "declaration": {
+            "name": "GenesisWriteRowStatus",
+            "module": "./write-tools"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GenesisWriteToolsOptions",
+          "declaration": {
+            "name": "GenesisWriteToolsOptions",
+            "module": "./write-tools"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GENESIS_WRITE_REVIEW",
+          "declaration": {
+            "name": "GENESIS_WRITE_REVIEW",
+            "module": "./write-review/write-review"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GenesisWriteReview",
+          "declaration": {
+            "name": "GenesisWriteReview",
+            "module": "./write-review/write-review"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GenesisChangeRequest",
+          "declaration": {
+            "name": "GenesisChangeRequest",
+            "module": "./review-payload"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GenesisReviewPayload",
+          "declaration": {
+            "name": "GenesisReviewPayload",
+            "module": "./review-payload"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GenesisWriteReviewCompletedEventDetail",
+          "declaration": {
+            "name": "GenesisWriteReviewCompletedEventDetail",
+            "module": "./review-payload"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "GenesisReadResult",
+          "declaration": {
+            "name": "GenesisReadResult",
             "module": "./resource-tools"
           }
         },
@@ -3043,913 +3248,680 @@
     },
     {
       "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```"
-        }
-      ],
+      "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": "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",
+          "name": "*",
           "declaration": {
-            "name": "ChatThinkingPolicy",
-            "module": "src/config/config.ts"
+            "name": "*",
+            "package": "./main.template"
           }
         },
         {
           "kind": "js",
-          "name": "ChatToolChoice",
+          "name": "*",
           "declaration": {
-            "name": "ChatToolChoice",
-            "module": "src/config/config.ts"
+            "name": "*",
+            "package": "./main"
           }
         },
         {
           "kind": "js",
-          "name": "defineAgent",
+          "name": "*",
           "declaration": {
-            "name": "defineAgent",
-            "module": "src/config/config.ts"
+            "name": "*",
+            "package": "./main.types"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/config/define-stateful-agent.ts",
+      "path": "src/main/main.styles.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."
+          "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": "restoreMachine",
-          "declaration": {
-            "name": "restoreMachine",
-            "module": "src/config/define-stateful-agent.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "defineStatefulAgent",
+          "name": "styles",
           "declaration": {
-            "name": "defineStatefulAgent",
-            "module": "src/config/define-stateful-agent.ts"
+            "name": "styles",
+            "module": "src/main/main.styles.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/config/fallback-agents.ts",
+      "path": "src/main/main.template.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."
+          "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": "variable",
-          "name": "strictFallbackAgent",
-          "type": {
-            "text": "FallbackAgentConfig"
+          "kind": "function",
+          "name": "FoundationAiAssistantTemplate",
+          "return": {
+            "type": {
+              "text": "ViewTemplate<FoundationAiAssistant>"
+            }
           },
-          "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."
+          "parameters": [
+            {
+              "name": "designSystemPrefix",
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
         }
       ],
       "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": "*",
+          "name": "messageTimestampTemplate",
           "declaration": {
-            "name": "*",
-            "package": "./config"
+            "name": "messageTimestampTemplate",
+            "module": "src/main/main.template.ts"
           }
         },
         {
           "kind": "js",
-          "name": "*",
+          "name": "FoundationAiAssistantTemplate",
           "declaration": {
-            "name": "*",
-            "package": "./fallback-agents"
+            "name": "FoundationAiAssistantTemplate",
+            "module": "src/main/main.template.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/config/validate-providers.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/provider/ai-provider-switcher.ts",
+      "path": "src/main/main.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": [
+          "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": "AssistantAppSettingsProvider",
-          "description": "The DI token for the (AssistantAppSettingsProvider:interface). Resolves a noop\nuntil the host registers one."
-        }
-      ],
-      "exports": [
+          "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": "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": "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": "Which cloud vendor backs the tier-shaped provider registry, plus the means to move it at\nruntime (GENC-1610).",
-          "name": "TieredAIProviderSwitcher",
+          "description": "Foundation AI Assistant component.",
+          "name": "FoundationAiAssistant",
           "members": [
             {
               "kind": "field",
-              "name": "vendors",
-              "type": {
-                "text": "readonly AITierVendor[]"
-              },
-              "readonly": true
+              "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": "options",
-              "type": {
-                "text": "TieredAIProviderSwitcherOptions"
-              },
+              "name": "composerMenus",
               "privacy": "private",
               "readonly": true,
-              "default": "options"
+              "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": "defaultTier",
-              "type": {
-                "text": "AITierId"
-              },
+              "name": "attachmentCtrl",
               "privacy": "private",
-              "readonly": true
+              "readonly": true,
+              "default": "new AttachmentController(this, {\n    acceptedFiles: () => this.chatConfig.ui?.acceptedFiles,\n    logMeta: (type, detail) => this.logMeta(type, detail),\n  })"
             },
             {
               "kind": "field",
-              "name": "registry",
-              "type": {
-                "text": "MutableAIProviderRegistry"
-              },
+              "name": "contextGateCtrl",
               "privacy": "private",
-              "readonly": true
+              "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": "listeners",
+              "name": "costLedger",
               "privacy": "private",
               "readonly": true,
-              "default": "new Set<(vendor: AITierVendor) => void>()"
+              "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": "_vendor",
+              "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": "AITierVendor"
-              },
-              "privacy": "private"
+                "text": "AIProviderRegistry"
+              }
             },
             {
               "kind": "field",
-              "name": "vendor",
+              "name": "appSettingsProvider",
               "type": {
-                "text": "AITierVendor"
-              },
-              "readonly": true
+                "text": "AssistantAppSettingsProvider"
+              }
             },
             {
-              "kind": "method",
-              "name": "switchTo",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "kind": "field",
+              "name": "designSystemPrefix",
+              "type": {
+                "text": "string"
               },
-              "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."
+              "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": "adoptPersistedVendor",
+              "name": "assistantIconChanged",
+              "privacy": "protected",
               "return": {
                 "type": {
                   "text": "void"
                 }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "userIcon",
+              "type": {
+                "text": "string | undefined"
               },
-              "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."
+              "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": "method",
-              "name": "subscribe",
-              "return": {
-                "type": {
-                  "text": "() => void"
-                }
+              "kind": "field",
+              "name": "userIconSafe",
+              "type": {
+                "text": "string"
               },
-              "parameters": [
-                {
-                  "name": "listener",
-                  "type": {
-                    "text": "(vendor: string) => void"
-                  }
-                }
-              ]
+              "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": "apply",
-              "privacy": "private",
+              "name": "userIconChanged",
+              "privacy": "protected",
               "return": {
                 "type": {
                   "text": "void"
                 }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "placeholder",
+              "type": {
+                "text": "string"
               },
-              "parameters": [
-                {
-                  "name": "vendor",
-                  "type": {
-                    "text": "AITierVendor"
-                  }
-                }
-              ],
-              "description": "The registry move both entry points share, and nothing else."
+              "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": "build",
+              "name": "isBusyState",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "Record<string, AIProvider>"
+                  "text": "boolean"
                 }
               },
               "parameters": [
                 {
-                  "name": "vendor",
+                  "name": "s",
+                  "optional": true,
                   "type": {
-                    "text": "AITierVendor"
+                    "text": "AiAssistantState"
                   }
                 }
-              ]
+              ],
+              "description": "Whether a state value counts as \"busy\" — a turn is active."
             },
             {
               "kind": "method",
-              "name": "isKnownVendor",
+              "name": "rearmContextGate",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "vendor is AITierVendor"
+                  "text": "void"
                 }
               },
-              "parameters": [
-                {
-                  "name": "vendor",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
-            }
-          ]
-        },
-        {
-          "kind": "function",
-          "name": "registerTieredAIProviders",
-          "return": {
-            "type": {
-              "text": "TieredAIProviderSwitcher"
-            }
-          },
-          "parameters": [
-            {
-              "name": "container",
-              "type": {
-                "text": "Container"
-              }
+              "description": "Re-arm FoundationAiAssistant.contextGate against the size the turn\njust left behind (GENC-1582).\n\nThe final call of a turn is made AFTER `agentEnd` condensation fires, so by\nthe time a turn settles `contextTokens` is the resting figure rather than the\nmid-turn peak — which is the number the reserve's thresholds are drawn\nagainst.\n\n**Called from BOTH settle paths, and it has to be.** A turn does not end\nthrough the `state` setter: `send()`'s `finally` writes `setState('idle')`\nstraight to the captured session ref, because the element may have\ndisconnected mid-turn, and that block then replicates the parts of the\nsetter's settle that matter. Arming the gate inline in the setter therefore\narmed it on the one path a real turn never takes — the gate silently kept\nfalling back to the live figure and the hold did nothing at all. Found by\ndriving a real UI Builder turn and reading `_gateContextTokens`, which was\n`undefined` from start to finish; no unit test noticed, because the test\nharness sets `state` through the property.\n\nOne method rather than two assignments so the two paths cannot drift again."
             },
-            {
-              "name": "options",
-              "type": {
-                "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": [
-            {
-              "name": "designSystemPrefix",
-              "type": {
-                "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  })"
+              "name": "busy",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "True while a turn is active — `loading` or `cancelling` (a stop was\nrequested but the turn is still winding down). The single \"is a turn\nrunning\" predicate; UI gates use this so `cancelling` behaves like\n`loading` everywhere. `@volatile` so the template re-evaluates it when the\nstore-backed `state` changes.",
+              "readonly": true
             },
             {
               "kind": "field",
-              "name": "composerMenus",
+              "name": "sendBlocked",
+              "type": {
+                "text": "boolean"
+              },
               "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  })"
+              "description": "True when a new send must be refused: a turn is running (`busy`), a page-reload\nrestore is loading history that would clobber it (`restoring`), a manual\ncompaction is rewriting history (`compacting`), or a backend condition has\nlocked the assistant outright (`blocked` — e.g. an exhausted AI budget).\nMirrors the composer's `?disabled` gate so a **programmatic**\n`send`/`submitMessage` (e.g. a host's custom input while the built-in composer\nis hidden) can't slip past it and have its message wiped when the\nrestored/compacted history lands (GENC-1351 §6).",
+              "readonly": true
             },
             {
-              "kind": "field",
-              "name": "attachmentCtrl",
+              "kind": "method",
+              "name": "sendRefusalReason",
               "privacy": "private",
-              "readonly": true,
-              "default": "new AttachmentController(this, {\n    acceptedFiles: () => this.chatConfig.ui?.acceptedFiles,\n    logMeta: (type, detail) => this.logMeta(type, detail),\n  })"
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "description": "Why a programmatic send was refused, for `submitMessage`'s `errors`. A\nbackend block is called out distinctly because — unlike the transient\n\"busy\" cases — waiting and retrying will never clear it, and a caller\nlooping on \"Assistant is busy\" would spin forever."
             },
             {
-              "kind": "field",
-              "name": "contextGateCtrl",
+              "kind": "method",
+              "name": "applyDeferredAgentsSwap",
               "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."
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Re-runs `agentsChanged` if the live `agents` array no longer matches the\nfingerprint of the currently installed driver. Used to apply swaps that\nlanded during a turn (and were skipped by the `isBusy()` guard) once the\ndriver returns to idle."
             },
             {
-              "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",
+              "kind": "method",
+              "name": "applyDeferredSessionSwitch",
               "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."
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Apply a `session-key` re-key that arrived mid-turn and was deferred by\n`switchSession`'s busy guard (GENC-1351 §5.12). Run at each point the driver\nreturns to idle, BEFORE `applyDeferredAgentsSwap` — a switch rebuilds the\ndriver against the current agents, so a pending agents-swap then no-ops."
             },
             {
-              "kind": "field",
-              "name": "settings",
+              "kind": "method",
+              "name": "maybeAutoFocusChatInput",
               "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`."
+              "description": "Focus the main chat input if the user is still engaged with the assistant.\nDeferred to the next frame so any conditional re-render (e.g. unhiding the\ninput row when an agent's `chatInputDuringExecution: 'hidden'` execution\nends) has committed before we call `.focus()`.\n\n`rapid-text-area` does not delegate focus to its inner native `<textarea>`,\nso we drill into its shadow root and focus the textarea directly."
             },
             {
               "kind": "field",
-              "name": "providerRegistry",
+              "name": "activeAgent",
               "type": {
-                "text": "AIProviderRegistry"
+                "text": "Omit<AgentConfig, 'toolHandlers'> | undefined"
               }
             },
             {
               "kind": "field",
-              "name": "appSettingsProvider",
+              "name": "suggestionsState",
               "type": {
-                "text": "AssistantAppSettingsProvider"
+                "text": "SuggestionsState"
               }
             },
             {
               "kind": "field",
-              "name": "designSystemPrefix",
+              "name": "showToolCalls",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "'rapid'"
+              "description": "Current user-facing toggle state for tool call visibility."
             },
             {
               "kind": "field",
-              "name": "headerTitle",
+              "name": "showThinkingSteps",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "'Genesis Assistant'"
+              "description": "Current user-facing toggle state for thinking step visibility."
             },
             {
               "kind": "field",
-              "name": "sessionKey",
+              "name": "showNarration",
               "type": {
-                "text": "string | undefined"
+                "text": "boolean"
               },
-              "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"
-              }
+              "description": "Current user-facing toggle state for narration (interstitial prose) visibility."
             },
             {
               "kind": "field",
-              "name": "assistantIcon",
+              "name": "showAgentSwitchIndicator",
               "type": {
-                "text": "string | undefined"
+                "text": "boolean"
               },
-              "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."
+              "description": "Current user-facing toggle state for agent switch indicator visibility."
             },
             {
               "kind": "field",
-              "name": "assistantIconSafe",
+              "name": "timestampDisplay",
               "type": {
-                "text": "string"
+                "text": "TimestampDisplay"
               },
-              "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"
-                }
-              }
+              "description": "When each message shows its timestamp — `'off'`, `'hover'` or `'always'` (default).\n\nFalls back to `DEFAULT_TIMESTAMP_DISPLAY` rather than `'off'` when there is no\nstore yet: this preference defaults ON, so the pre-store render must match the state\nthe baseline is about to resolve to, or timestamps would visibly pop in on connect."
             },
             {
               "kind": "field",
-              "name": "userIcon",
+              "name": "timestampClock",
               "type": {
-                "text": "string | undefined"
+                "text": "number"
               },
-              "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."
+              "description": "Epoch ms the transcript's relative timestamps are measured against.\n\nA relative label is only correct at the instant it renders: FAST evaluates the\nbinding once, and an idle conversation never re-renders, so \"2 minutes ago\" would\nstill read \"2 minutes ago\" an hour later. Making the formatter read this observable\ninstead of `Date.now()` gives every row one shared, invalidatable clock — a tick\nre-evaluates them all."
             },
             {
               "kind": "field",
-              "name": "userIconSafe",
+              "name": "_timestampClockTimer",
               "type": {
-                "text": "string"
+                "text": "ReturnType<typeof setInterval> | undefined"
               },
-              "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"
+              "privacy": "private",
+              "description": "Handle for the `TIMESTAMP_CLOCK_INTERVAL_MS` ticker; undefined while stopped."
             },
             {
               "kind": "method",
-              "name": "userIconChanged",
-              "privacy": "protected",
+              "name": "syncTimestampClock",
+              "privacy": "private",
               "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."
+              "description": "Start or stop the timestamp clock to match the current mode and connection state.\n\nIdempotent, and safe to call from either lifecycle end — it is driven from\n`connectedCallback`, `disconnectedCallback` and the `timestampDisplay` setter, which\ncan fire in any order. Nothing runs while the mode is `'off'` (no binding reads the\nclock) or while disconnected (a timer outliving its element is a leak, and a\npopped-out view disconnects without the session ending)."
             },
             {
               "kind": "field",
-              "name": "chatConfig",
+              "name": "enabledAnimations",
               "type": {
-                "text": "ChatConfig"
+                "text": "AiAssistantAnimation[]"
               },
-              "default": "{}"
+              "description": "Currently enabled animations."
             },
             {
               "kind": "field",
-              "name": "persistence",
+              "name": "agentPickerOpen",
               "type": {
-                "text": "SessionPersistenceConfig"
+                "text": "boolean"
               },
-              "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`."
+              "description": "Whether the agent picker slide-out panel is open. Lives on the session\nstore so the bubble-dialog and popout-panel instances stay in sync."
             },
             {
               "kind": "field",
-              "name": "aiServiceErrorMessages",
+              "name": "sessionMenuOpen",
               "type": {
-                "text": "Partial<Record<AIServiceRefusal, string>> | undefined"
+                "text": "boolean"
               },
-              "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."
+              "description": "Whether the lifecycle (session) menu slide-out panel is open. Like the\nagent picker, lives on the session store so bubble/popout stay in sync."
             },
             {
               "kind": "field",
-              "name": "agentPicker",
+              "name": "compacting",
               "type": {
-                "text": "AgentPickerMode"
+                "text": "boolean"
               },
-              "description": "Resolved agent picker mode from `chatConfig.picker.mode`. Defaults to\n`'disabled'`.",
-              "readonly": true
+              "description": "Whether a manual compaction is in flight (GENC-1351 §5.7). On the session\nstore (not element-local) so the \"Compacting…\" view + input-disable stay in\nsync across pop-in/out, like the panel flags."
             },
             {
               "kind": "field",
-              "name": "composerHiddenByConfig",
+              "name": "restoring",
               "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"
-              }
+              "description": "Whether a page-reload restore is in flight (GENC-1351 §6). On the session\nstore (like `compacting`) so the \"Restoring…\" view + input-disable stay in\nsync across pop-in/out. Gating input while true prevents a mid-load send from\nbeing clobbered when the restored history loads."
             },
             {
               "kind": "field",
-              "name": "debugRedux",
+              "name": "blocked",
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
-              "description": "When set, enables Redux DevTools for this instance's session store."
+              "description": "Whether the assistant is blocked by a backend condition and cannot send —\ntoday, an exhausted AI-spend budget (GENC-1464). While true the composer is\ndisabled, `send`/`submitMessage` refuse, suggestions stop being fetched, and\na persistent banner (`part=\"blocked-banner\"`) sits above the composer\nexplaining why. The transcript stays visible and scrollable throughout —\nunlike `compacting` and `restoring`, this does not replace the conversation.\n\n**Latched.** Nothing in the element clears it: not a new turn, not \"Clear\"\n/ \"New chat\", not a pop-in/out. It stays set until the host writes\n`false` — because nothing the user can do inside the assistant refills a\nbudget. Hosts typically set it from their own pre-flight budget check on\nmount, and clear it once a later check shows headroom again. Such a host\nshould use `setBlocked(true, reason, { cause: 'budget' })`: a plain\n`blocked = true` is taken for a budget wall only while per-vendor budget\nwalls cover every vendor the assistant can reach (GENC-1611).\n\nThe driver also latches it automatically when a turn ends with the\n`'budget-exhausted'` failure reason — off the `tool-loop-end` activity bus\n(which also covers a sub-agent wall, a turn this element did not start, and\nan element swapped in mid-turn) and off the driver's return value (which\ncovers a wall hit during multi-agent classification, where no tool loop ran\nand so no bus event fires). So a host that does no pre-flight at all still\ngets a correct locked UI the moment the first 402 lands. The bus topic is\ntab-scoped, so a wall hit in a popped-out window latches the main window\ntoo — correct for a shared spend cap.\n\n**Lifetime — read this before relying on it as your source of truth.** The\nlatch is in-memory and per-`stateKey`:\n\n- It does **not** survive `switchSession`. Switching away tears the outgoing\n  session's store down entirely, so switching back yields a fresh, unblocked\n  store.\n- It does **not** survive a page reload. It is deliberately absent from the\n  persisted session snapshot: the snapshot is long-lived, so a persisted\n  latch would outlive an out-of-band budget raise with no in-element way to\n  clear it — a stale lock is worse than re-deriving the state.\n\nThe durable source of truth is therefore the **host's pre-flight**, which\nshould run on mount and on every session switch. See\n`docs/migration-GENC-1464.md` §\"How to adopt\", Option B."
             },
             {
               "kind": "field",
-              "name": "_sessionRef",
+              "name": "reachableVendors",
               "type": {
-                "text": "SessionStoreReturn | undefined"
+                "text": "readonly AIProviderType[]"
               },
-              "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.)"
+              "description": "The distinct vendors the registry can currently reach, from the provider\nstatuses this element already loads on connect and refreshes on every\nobservable-registry change — this element's answer to \"which vendor would the\nnext turn use\", a question that has no correct answer and deliberately gets\nno API. See `BudgetController.reachableVendors` for why reachability is\nthe answerable question and what deriving from it buys.",
+              "readonly": true
             },
             {
               "kind": "field",
-              "name": "_gateContextTokens",
+              "name": "blockedVendors",
               "type": {
-                "text": "number | undefined"
+                "text": "readonly AIProviderType[]"
               },
-              "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"
-              }
+              "description": "Vendors currently walled by the AI-spend budget, in the order they were\nwalled. Empty for a host that never adopts the per-vendor API.\n\nMay include a vendor this registry cannot reach — either because the registry\nmoved on after the wall was latched, or because a 402's\n`otherVendorAvailable: false` walls every vendor the proxy meters. Neither\ncosts anything internally — FoundationAiAssistant.blocked asks only\nabout the reachable set, and the banner reads the reachability-filtered\n`BudgetController.relevantBlockedVendors` — but a host rendering this\nlist itself should filter it against its own registry.\n\nRead-only on purpose: a settable array would let a host write a partial list\nand silently orphan the per-vendor banner copy.\nFoundationAiAssistant.setVendorBlocked is the write path.",
+              "readonly": true
             },
             {
               "kind": "method",
-              "name": "isBusyState",
-              "privacy": "private",
+              "name": "isVendorBlocked",
               "return": {
                 "type": {
                   "text": "boolean"
@@ -3957,288 +3929,52 @@
               },
               "parameters": [
                 {
-                  "name": "s",
-                  "optional": true,
+                  "name": "vendor",
                   "type": {
-                    "text": "AiAssistantState"
+                    "text": "AIProviderType"
                   }
                 }
               ],
-              "description": "Whether a state value counts as \"busy\" — a turn is active."
+              "description": "Whether this specific vendor's budget is walled — regardless of whether any\nother vendor still has headroom."
             },
             {
               "kind": "method",
-              "name": "rearmContextGate",
-              "privacy": "private",
+              "name": "setVendorBlocked",
               "return": {
                 "type": {
                   "text": "void"
                 }
               },
-              "description": "Re-arm FoundationAiAssistant.contextGate against the size the turn\njust left behind (GENC-1582).\n\nThe final call of a turn is made AFTER `agentEnd` condensation fires, so by\nthe time a turn settles `contextTokens` is the resting figure rather than the\nmid-turn peak — which is the number the reserve's thresholds are drawn\nagainst.\n\n**Called from BOTH settle paths, and it has to be.** A turn does not end\nthrough the `state` setter: `send()`'s `finally` writes `setState('idle')`\nstraight to the captured session ref, because the element may have\ndisconnected mid-turn, and that block then replicates the parts of the\nsetter's settle that matter. Arming the gate inline in the setter therefore\narmed it on the one path a real turn never takes — the gate silently kept\nfalling back to the live figure and the hold did nothing at all. Found by\ndriving a real UI Builder turn and reading `_gateContextTokens`, which was\n`undefined` from start to finish; no unit test noticed, because the test\nharness sets `state` through the property.\n\nOne method rather than two assignments so the two paths cannot drift again."
+              "parameters": [
+                {
+                  "name": "vendor",
+                  "type": {
+                    "text": "AIProviderType"
+                  }
+                },
+                {
+                  "name": "blocked",
+                  "type": {
+                    "text": "boolean"
+                  }
+                },
+                {
+                  "name": "reason",
+                  "optional": true,
+                  "type": {
+                    "text": "string | null"
+                  }
+                }
+              ],
+              "description": "Wall (or release) one vendor's budget, optionally with banner copy for it.\nThe per-vendor mirror of FoundationAiAssistant.setBlocked.\n\nWalling a vendor does **not** on its own disable the composer: while another\nreachable vendor has headroom the assistant stays usable and the banner tells\nthe user to switch. Only when every reachable vendor is walled does `blocked`\nbecome true.\n\n`reason` is composed into the banner sentence for that vendor, **however many\nvendors are walled** — see `BudgetController.effectiveBlockedReason`.\nIt is per-vendor copy, not a whole-banner override;\nFoundationAiAssistant.blockedReason is the override. Omitting it keeps\nwhatever explanation that vendor already carried, so a driver latch landing\nafter a host one cannot blank it.\n\n`'none'` is rejected with a warning rather than accepted — it is the \"no\nprovider configured\" sentinel, not a vendor, and a wall on it could never be\nundone by derivation. Use FoundationAiAssistant.setBlocked for a\nvendor-agnostic block."
             },
             {
-              "kind": "field",
-              "name": "busy",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "True while a turn is active — `loading` or `cancelling` (a stop was\nrequested but the turn is still winding down). The single \"is a turn\nrunning\" predicate; UI gates use this so `cancelling` behaves like\n`loading` everywhere. `@volatile` so the template re-evaluates it when the\nstore-backed `state` changes.",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "sendBlocked",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "description": "True when a new send must be refused: a turn is running (`busy`), a page-reload\nrestore is loading history that would clobber it (`restoring`), a manual\ncompaction is rewriting history (`compacting`), or a backend condition has\nlocked the assistant outright (`blocked` — e.g. an exhausted AI budget).\nMirrors the composer's `?disabled` gate so a **programmatic**\n`send`/`submitMessage` (e.g. a host's custom input while the built-in composer\nis hidden) can't slip past it and have its message wiped when the\nrestored/compacted history lands (GENC-1351 §6).",
-              "readonly": true
-            },
-            {
-              "kind": "method",
-              "name": "sendRefusalReason",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "string"
-                }
-              },
-              "description": "Why a programmatic send was refused, for `submitMessage`'s `errors`. A\nbackend block is called out distinctly because — unlike the transient\n\"busy\" cases — waiting and retrying will never clear it, and a caller\nlooping on \"Assistant is busy\" would spin forever."
-            },
-            {
-              "kind": "method",
-              "name": "applyDeferredAgentsSwap",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "description": "Re-runs `agentsChanged` if the live `agents` array no longer matches the\nfingerprint of the currently installed driver. Used to apply swaps that\nlanded during a turn (and were skipped by the `isBusy()` guard) once the\ndriver returns to idle."
-            },
-            {
-              "kind": "method",
-              "name": "applyDeferredSessionSwitch",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "description": "Apply a `session-key` re-key that arrived mid-turn and was deferred by\n`switchSession`'s busy guard (GENC-1351 §5.12). Run at each point the driver\nreturns to idle, BEFORE `applyDeferredAgentsSwap` — a switch rebuilds the\ndriver against the current agents, so a pending agents-swap then no-ops."
-            },
-            {
-              "kind": "method",
-              "name": "maybeAutoFocusChatInput",
-              "privacy": "private",
-              "description": "Focus the main chat input if the user is still engaged with the assistant.\nDeferred to the next frame so any conditional re-render (e.g. unhiding the\ninput row when an agent's `chatInputDuringExecution: 'hidden'` execution\nends) has committed before we call `.focus()`.\n\n`rapid-text-area` does not delegate focus to its inner native `<textarea>`,\nso we drill into its shadow root and focus the textarea directly."
-            },
-            {
-              "kind": "field",
-              "name": "activeAgent",
-              "type": {
-                "text": "Omit<AgentConfig, 'toolHandlers'> | undefined"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "suggestionsState",
-              "type": {
-                "text": "SuggestionsState"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "showToolCalls",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Current user-facing toggle state for tool call visibility."
-            },
-            {
-              "kind": "field",
-              "name": "showThinkingSteps",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Current user-facing toggle state for thinking step visibility."
-            },
-            {
-              "kind": "field",
-              "name": "showNarration",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Current user-facing toggle state for narration (interstitial prose) visibility."
-            },
-            {
-              "kind": "field",
-              "name": "showAgentSwitchIndicator",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Current user-facing toggle state for agent switch indicator visibility."
-            },
-            {
-              "kind": "field",
-              "name": "timestampDisplay",
-              "type": {
-                "text": "TimestampDisplay"
-              },
-              "description": "When each message shows its timestamp — `'off'`, `'hover'` or `'always'` (default).\n\nFalls back to `DEFAULT_TIMESTAMP_DISPLAY` rather than `'off'` when there is no\nstore yet: this preference defaults ON, so the pre-store render must match the state\nthe baseline is about to resolve to, or timestamps would visibly pop in on connect."
-            },
-            {
-              "kind": "field",
-              "name": "timestampClock",
-              "type": {
-                "text": "number"
-              },
-              "description": "Epoch ms the transcript's relative timestamps are measured against.\n\nA relative label is only correct at the instant it renders: FAST evaluates the\nbinding once, and an idle conversation never re-renders, so \"2 minutes ago\" would\nstill read \"2 minutes ago\" an hour later. Making the formatter read this observable\ninstead of `Date.now()` gives every row one shared, invalidatable clock — a tick\nre-evaluates them all."
-            },
-            {
-              "kind": "field",
-              "name": "_timestampClockTimer",
-              "type": {
-                "text": "ReturnType<typeof setInterval> | undefined"
-              },
-              "privacy": "private",
-              "description": "Handle for the `TIMESTAMP_CLOCK_INTERVAL_MS` ticker; undefined while stopped."
-            },
-            {
-              "kind": "method",
-              "name": "syncTimestampClock",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "description": "Start or stop the timestamp clock to match the current mode and connection state.\n\nIdempotent, and safe to call from either lifecycle end — it is driven from\n`connectedCallback`, `disconnectedCallback` and the `timestampDisplay` setter, which\ncan fire in any order. Nothing runs while the mode is `'off'` (no binding reads the\nclock) or while disconnected (a timer outliving its element is a leak, and a\npopped-out view disconnects without the session ending)."
-            },
-            {
-              "kind": "field",
-              "name": "enabledAnimations",
-              "type": {
-                "text": "AiAssistantAnimation[]"
-              },
-              "description": "Currently enabled animations."
-            },
-            {
-              "kind": "field",
-              "name": "agentPickerOpen",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Whether the agent picker slide-out panel is open. Lives on the session\nstore so the bubble-dialog and popout-panel instances stay in sync."
-            },
-            {
-              "kind": "field",
-              "name": "sessionMenuOpen",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Whether the lifecycle (session) menu slide-out panel is open. Like the\nagent picker, lives on the session store so bubble/popout stay in sync."
-            },
-            {
-              "kind": "field",
-              "name": "compacting",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Whether a manual compaction is in flight (GENC-1351 §5.7). On the session\nstore (not element-local) so the \"Compacting…\" view + input-disable stay in\nsync across pop-in/out, like the panel flags."
-            },
-            {
-              "kind": "field",
-              "name": "restoring",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Whether a page-reload restore is in flight (GENC-1351 §6). On the session\nstore (like `compacting`) so the \"Restoring…\" view + input-disable stay in\nsync across pop-in/out. Gating input while true prevents a mid-load send from\nbeing clobbered when the restored history loads."
-            },
-            {
-              "kind": "field",
-              "name": "blocked",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Whether the assistant is blocked by a backend condition and cannot send —\ntoday, an exhausted AI-spend budget (GENC-1464). While true the composer is\ndisabled, `send`/`submitMessage` refuse, suggestions stop being fetched, and\na persistent banner (`part=\"blocked-banner\"`) sits above the composer\nexplaining why. The transcript stays visible and scrollable throughout —\nunlike `compacting` and `restoring`, this does not replace the conversation.\n\n**Latched.** Nothing in the element clears it: not a new turn, not \"Clear\"\n/ \"New chat\", not a pop-in/out. It stays set until the host writes\n`false` — because nothing the user can do inside the assistant refills a\nbudget. Hosts typically set it from their own pre-flight budget check on\nmount, and clear it once a later check shows headroom again. Such a host\nshould use `setBlocked(true, reason, { cause: 'budget' })`: a plain\n`blocked = true` is taken for a budget wall only while per-vendor budget\nwalls cover every vendor the assistant can reach (GENC-1611).\n\nThe driver also latches it automatically when a turn ends with the\n`'budget-exhausted'` failure reason — off the `tool-loop-end` activity bus\n(which also covers a sub-agent wall, a turn this element did not start, and\nan element swapped in mid-turn) and off the driver's return value (which\ncovers a wall hit during multi-agent classification, where no tool loop ran\nand so no bus event fires). So a host that does no pre-flight at all still\ngets a correct locked UI the moment the first 402 lands. The bus topic is\ntab-scoped, so a wall hit in a popped-out window latches the main window\ntoo — correct for a shared spend cap.\n\n**Lifetime — read this before relying on it as your source of truth.** The\nlatch is in-memory and per-`stateKey`:\n\n- It does **not** survive `switchSession`. Switching away tears the outgoing\n  session's store down entirely, so switching back yields a fresh, unblocked\n  store.\n- It does **not** survive a page reload. It is deliberately absent from the\n  persisted session snapshot: the snapshot is long-lived, so a persisted\n  latch would outlive an out-of-band budget raise with no in-element way to\n  clear it — a stale lock is worse than re-deriving the state.\n\nThe durable source of truth is therefore the **host's pre-flight**, which\nshould run on mount and on every session switch. See\n`docs/migration-GENC-1464.md` §\"How to adopt\", Option B."
-            },
-            {
-              "kind": "field",
-              "name": "reachableVendors",
-              "type": {
-                "text": "readonly AIProviderType[]"
-              },
-              "description": "The distinct vendors the registry can currently reach, from the provider\nstatuses this element already loads on connect and refreshes on every\nobservable-registry change — this element's answer to \"which vendor would the\nnext turn use\", a question that has no correct answer and deliberately gets\nno API. See `BudgetController.reachableVendors` for why reachability is\nthe answerable question and what deriving from it buys.",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "blockedVendors",
-              "type": {
-                "text": "readonly AIProviderType[]"
-              },
-              "description": "Vendors currently walled by the AI-spend budget, in the order they were\nwalled. Empty for a host that never adopts the per-vendor API.\n\nMay include a vendor this registry cannot reach — either because the registry\nmoved on after the wall was latched, or because a 402's\n`otherVendorAvailable: false` walls every vendor the proxy meters. Neither\ncosts anything internally — FoundationAiAssistant.blocked asks only\nabout the reachable set, and the banner reads the reachability-filtered\n`BudgetController.relevantBlockedVendors` — but a host rendering this\nlist itself should filter it against its own registry.\n\nRead-only on purpose: a settable array would let a host write a partial list\nand silently orphan the per-vendor banner copy.\nFoundationAiAssistant.setVendorBlocked is the write path.",
-              "readonly": true
-            },
-            {
-              "kind": "method",
-              "name": "isVendorBlocked",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "vendor",
-                  "type": {
-                    "text": "AIProviderType"
-                  }
-                }
-              ],
-              "description": "Whether this specific vendor's budget is walled — regardless of whether any\nother vendor still has headroom."
-            },
-            {
-              "kind": "method",
-              "name": "setVendorBlocked",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "vendor",
-                  "type": {
-                    "text": "AIProviderType"
-                  }
-                },
-                {
-                  "name": "blocked",
-                  "type": {
-                    "text": "boolean"
-                  }
-                },
-                {
-                  "name": "reason",
-                  "optional": true,
-                  "type": {
-                    "text": "string | null"
-                  }
-                }
-              ],
-              "description": "Wall (or release) one vendor's budget, optionally with banner copy for it.\nThe per-vendor mirror of FoundationAiAssistant.setBlocked.\n\nWalling a vendor does **not** on its own disable the composer: while another\nreachable vendor has headroom the assistant stays usable and the banner tells\nthe user to switch. Only when every reachable vendor is walled does `blocked`\nbecome true.\n\n`reason` is composed into the banner sentence for that vendor, **however many\nvendors are walled** — see `BudgetController.effectiveBlockedReason`.\nIt is per-vendor copy, not a whole-banner override;\nFoundationAiAssistant.blockedReason is the override. Omitting it keeps\nwhatever explanation that vendor already carried, so a driver latch landing\nafter a host one cannot blank it.\n\n`'none'` is rejected with a warning rather than accepted — it is the \"no\nprovider configured\" sentinel, not a vendor, and a wall on it could never be\nundone by derivation. Use FoundationAiAssistant.setBlocked for a\nvendor-agnostic block."
-            },
-            {
-              "kind": "method",
-              "name": "setVendorBudget",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
+              "kind": "method",
+              "name": "setVendorBudget",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
               },
               "parameters": [
                 {
@@ -6652,164 +6388,644 @@
               "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>"
-                }
+              "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[]"
               },
-              "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"
-                }
-              }
+              "readonly": true
             },
             {
-              "kind": "method",
-              "name": "handleFileSelect",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "kind": "field",
+              "name": "options",
+              "type": {
+                "text": "TieredAIProviderSwitcherOptions"
               },
-              "parameters": [
-                {
-                  "name": "e",
-                  "type": {
-                    "text": "Event"
-                  }
-                }
-              ]
+              "privacy": "private",
+              "readonly": true,
+              "default": "options"
             },
             {
-              "kind": "method",
-              "name": "removeAttachment",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "kind": "field",
+              "name": "defaultTier",
+              "type": {
+                "text": "AITierId"
               },
-              "parameters": [
-                {
-                  "name": "attachment",
-                  "type": {
-                    "text": "ChatAttachment"
-                  }
-                }
-              ]
+              "privacy": "private",
+              "readonly": true
             },
             {
-              "kind": "method",
-              "name": "removeAttachmentError",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "kind": "field",
+              "name": "registry",
+              "type": {
+                "text": "MutableAIProviderRegistry"
               },
-              "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."
+              "privacy": "private",
+              "readonly": true
             },
             {
-              "kind": "method",
-              "name": "handleSuggestionClick",
-              "parameters": [
-                {
-                  "name": "suggestion",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
+              "kind": "field",
+              "name": "listeners",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new Set<(vendor: AITierVendor) => void>()"
             },
             {
-              "kind": "method",
-              "name": "submitMessage",
-              "return": {
-                "type": {
-                  "text": "Promise<SubmitMessageResult>"
-                }
+              "kind": "field",
+              "name": "_vendor",
+              "type": {
+                "text": "AITierVendor"
               },
-              "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",
+              "name": "vendor",
               "type": {
-                "text": "string | undefined"
+                "text": "AITierVendor"
               },
-              "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"
+              "readonly": true
             },
             {
               "kind": "method",
-              "name": "settleAfterTurn",
-              "privacy": "private",
+              "name": "switchTo",
               "return": {
                 "type": {
                   "text": "void"
@@ -6817,90 +7033,53 @@
               },
               "parameters": [
                 {
-                  "name": "capturedSessionRef",
+                  "name": "vendor",
                   "type": {
-                    "text": "SessionStoreReturn | null | undefined"
+                    "text": "string"
                   }
                 }
               ],
-              "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."
+              "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": "onChatHeaderMouseDown",
-              "parameters": [
-                {
-                  "name": "e",
-                  "type": {
-                    "text": "MouseEvent"
-                  }
+              "name": "adoptPersistedVendor",
+              "return": {
+                "type": {
+                  "text": "void"
                 }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "handleInteractionCompleted",
+              },
               "parameters": [
                 {
-                  "name": "e",
+                  "name": "vendor",
                   "type": {
-                    "text": "Event"
+                    "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": "method",
-              "name": "handleInteractionCost",
+              "name": "subscribe",
+              "return": {
+                "type": {
+                  "text": "() => void"
+                }
+              },
               "parameters": [
                 {
-                  "name": "e",
+                  "name": "listener",
                   "type": {
-                    "text": "Event"
+                    "text": "(vendor: string) => void"
                   }
-                }
-              ],
-              "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",
+              "name": "apply",
+              "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
@@ -6908,275 +7087,96 @@
               },
               "parameters": [
                 {
-                  "name": "e",
+                  "name": "vendor",
                   "type": {
-                    "text": "PointerEvent"
+                    "text": "AITierVendor"
                   }
                 }
-              ]
+              ],
+              "description": "The registry move both entry points share, and nothing else."
             },
             {
               "kind": "method",
-              "name": "onComposerResizeMove",
+              "name": "build",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "Record<string, AIProvider>"
                 }
               },
               "parameters": [
                 {
-                  "name": "e",
+                  "name": "vendor",
                   "type": {
-                    "text": "PointerEvent"
+                    "text": "AITierVendor"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "onComposerResizeEnd",
+              "name": "isKnownVendor",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "vendor is AITierVendor"
                 }
               },
               "parameters": [
                 {
-                  "name": "e",
+                  "name": "vendor",
                   "type": {
-                    "text": "PointerEvent"
+                    "text": "string"
                   }
                 }
               ]
             }
-          ],
-          "events": [
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "registerTieredAIProviders",
+          "return": {
+            "type": {
+              "text": "TieredAIProviderSwitcher"
+            }
+          },
+          "parameters": [
             {
-              "name": "budget-refresh-requested",
+              "name": "container",
               "type": {
-                "text": "CustomEvent"
+                "text": "Container"
               }
             },
             {
+              "name": "options",
               "type": {
-                "text": "CustomEvent"
+                "text": "Omit<TieredAIProviderSwitcherOptions, 'container'>"
               }
-            },
-            {
-              "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."
+          "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": "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",
+          "name": "TieredAIProviderSwitcher",
           "declaration": {
-            "name": "satisfies",
-            "module": "src/main/main.types.ts"
+            "name": "TieredAIProviderSwitcher",
+            "module": "src/provider/tiered-provider-switcher.ts"
           }
         },
         {
           "kind": "js",
-          "name": "Record",
+          "name": "registerTieredAIProviders",
           "declaration": {
-            "name": "Record",
-            "module": "src/main/main.types.ts"
+            "name": "registerTieredAIProviders",
+            "module": "src/provider/tiered-provider-switcher.ts"
           }
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/main/meta-snapshot.ts",
-      "declarations": [],
-      "exports": []
-    },
     {
       "kind": "javascript-module",
       "path": "src/state/ai-assistant-slice.ts",