@genesislcap/ai-assistant 15.85.1 → 15.86.1

package/dist/custom-elements.json

@@ -1410,265 +1410,75 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/autopilot/autopilot-driver.ts",
+      "path": "src/channel/ai-activity-bus.ts",
       "declarations": [
         {
           "kind": "variable",
-          "name": "AUTOPILOT_CLAIMANT",
+          "name": "NOOP_ACTIVITY_BUS",
           "type": {
-            "text": "string"
+            "text": "ActivityBus"
           },
-          "default": "'autopilot'",
-          "description": "The holder id the autopilot claims interactions as."
+          "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": "Autopilot (GENC-1660): a driver decorator that answers the questions a working agent asks the\nuser, on their behalf, grounded in the agent's autopilot config (for bootstrap, the brief).\n\nNeither side calls the other. The working agent asks as it always does; this driver claims the\ninteractions its policy allows, while it is running for that flow, and answers each in one short\nturn on the flow's `AutopilotSession`. It plugs in only through the generic extension points\n— an interaction interceptor, a handler capability and the flow lifecycle — so the core knows\nnothing about it, and it wraps any `AiDriver`.",
-          "name": "AutopilotDriver",
+          "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": "agents",
-              "type": {
-                "text": "readonly AgentConfig[]"
-              },
-              "privacy": "private",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "providerRegistry",
-              "type": {
-                "text": "AIProviderRegistry"
-              },
-              "privacy": "private",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "sessionKey",
-              "type": {
-                "text": "string"
-              },
-              "privacy": "private",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "activityBus",
-              "type": {
-                "text": "ActivityBus"
-              },
-              "privacy": "private",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "listeners",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new Set<() => void>()"
-            },
-            {
-              "kind": "field",
-              "name": "sessions",
+              "name": "subscribers",
               "privacy": "private",
               "readonly": true,
-              "default": "new Map<string, AutopilotSession>()"
-            },
-            {
-              "kind": "field",
-              "name": "onFor",
-              "type": {
-                "text": "string | null"
-              },
-              "privacy": "private",
-              "default": "null",
-              "description": "The flow the mode applies to: set when it is first switched, cleared when that flow ends."
-            },
-            {
-              "kind": "field",
-              "name": "mode",
-              "type": {
-                "text": "'paused' | 'running'"
-              },
-              "privacy": "private",
-              "default": "'paused'"
-            },
-            {
-              "kind": "field",
-              "name": "pauseState",
-              "type": {
-                "text": "AutopilotHostState['pause'] | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "held",
-              "type": {
-                "text": "Held | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "open",
-              "type": {
-                "text": "InteractionOpened | undefined"
-              },
-              "privacy": "private",
-              "description": "The interaction open right now, whoever holds it: claimed or not, it was offered here first.\n`held` covers only what the autopilot claimed, so this is how the status knows that the working\nagent is parked on a question left with the person (see `waitingOnUser`)."
-            },
-            {
-              "kind": "field",
-              "name": "declinedWhilePaused",
-              "type": {
-                "text": "InteractionOpened | undefined"
-              },
-              "privacy": "private",
-              "description": "The open interaction, when the autopilot declined it only for being paused as it opened: a live\nResume may still take it (see `takeOpenOnResume`). Cleared when it is taken or settles."
-            },
-            {
-              "kind": "field",
-              "name": "refinements",
-              "type": {
-                "text": "{ key: string; count: number } | undefined"
-              },
-              "privacy": "private",
-              "description": "Refining actions taken on the current step (written answers among them), for the limit."
-            },
-            {
-              "kind": "field",
-              "name": "watchdog",
-              "type": {
-                "text": "ReturnType<typeof setTimeout> | undefined"
-              },
-              "privacy": "private",
-              "description": "The watchdog's next check, while a claimed interaction is pending."
+              "default": "new Map<string, Set<AnyHandler>>()"
             },
             {
               "kind": "field",
-              "name": "endedDiagnostics",
+              "name": "crossTabEvents",
               "type": {
-                "text": "DiagnosticEntry[]"
+                "text": "Set<string>"
               },
               "privacy": "private",
               "readonly": true,
-              "default": "[]",
-              "description": "What sessions that have ended did, kept for the debug log."
-            },
-            {
-              "kind": "field",
-              "name": "consecutiveReplies",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private",
-              "default": "0",
-              "description": "Written answers sent in a row; see `MAX_CONSECUTIVE_REPLIES`."
-            },
-            {
-              "kind": "field",
-              "name": "turnHandBack",
-              "type": {
-                "text": "{ why: string } | undefined"
-              },
-              "privacy": "private",
-              "description": "Set while the turn-level hand-back waits on the person."
-            },
-            {
-              "kind": "field",
-              "name": "restored",
-              "type": {
-                "text": "PersistedAutopilotMode | undefined"
-              },
-              "privacy": "private",
-              "description": "A mode restored with the session, waiting for its flow to become the owner again."
-            },
-            {
-              "kind": "field",
-              "name": "generation",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private",
-              "default": "0",
-              "description": "Bumped on every pause and resume, and when its sessions end. A written answer is sent only if\nnone came between asking for it and its landing: one started before a pause is stale after it,\neven once resumed."
+              "default": "new Set(config?.crossTabEvents ?? [])"
             },
             {
               "kind": "field",
-              "name": "turnsInFlight",
+              "name": "channelNameFactory",
               "type": {
-                "text": "number"
+                "text": "() => string | undefined"
               },
               "privacy": "private",
-              "default": "0",
-              "description": "Working turns this driver has started that have not ended yet; see `working`."
+              "readonly": true
             },
             {
               "kind": "field",
-              "name": "answersInFlight",
+              "name": "channel",
               "type": {
-                "text": "number"
+                "text": "BroadcastChannel | undefined"
               },
-              "privacy": "private",
-              "default": "0",
-              "description": "Written questions being answered right now; see `working`."
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "ranSinceStop",
+              "name": "channelInitialised",
               "type": {
                 "text": "boolean"
               },
               "privacy": "private",
-              "default": "false",
-              "description": "Whether the autopilot has been running, and working, since it last stopped or was paused: so\ngoing idle now is a stop to report. Outlives its flow ending, so a turn still running then is\nwaited out. See `watchForStop`."
-            },
-            {
-              "kind": "field",
-              "name": "stopCheck",
-              "type": {
-                "text": "ReturnType<typeof setTimeout> | undefined"
-              },
-              "privacy": "private",
-              "description": "The check that confirms the autopilot stopped, once it looked like it had."
-            },
-            {
-              "kind": "field",
-              "name": "handBackWaits",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new Set<() => void>()",
-              "description": "Stops each wait for a widget left with the person to ask them; see `reportHandBackWhenAsking`."
-            },
-            {
-              "kind": "field",
-              "name": "state",
-              "type": {
-                "text": "AutopilotHostState"
-              },
-              "readonly": true
+              "default": "false"
             },
             {
               "kind": "method",
-              "name": "waitingOnUser",
+              "name": "ensureChannel",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "boolean"
+                  "text": "void"
                 }
               },
-              "description": "Whether the working agent is parked on a question the person holds, with the autopilot deciding\nnothing: one it never took — its policy keeps it for the person, it is `userOnly` (the turn-level\nhand-back among them), it has no controller, or it opened while paused and no Resume has taken\nit since (a restored mode takes nothing) — or one another interceptor took and then gave to the\nperson. One the autopilot handed back reads `selfPaused`, and one a pause handed over reads\n`paused`; `state` settles both before asking this.\n\nNever one that asks them nothing (see `asksThePerson`): the person holds it, but it is work\nrunning, which settles by itself, so \"waiting for your answer\" would be untrue. A hand-back is\nreported by the same rule (see `reportHandBackWhenAsking`)."
-            },
-            {
-              "kind": "field",
-              "name": "copy",
-              "type": {
-                "text": "AutopilotCopy"
-              },
-              "readonly": true
+              "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",
@@ -1680,25 +1490,514 @@
               },
               "parameters": [
                 {
-                  "name": "listener",
+                  "name": "type",
                   "type": {
-                    "text": "() => void"
+                    "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": "pause",
+              "name": "publish",
               "return": {
                 "type": {
                   "text": "void"
                 }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "resume",
+              },
+              "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/channel/autopilot-needs-user.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "setAutopilotNeedsUser",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "sessionKey",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "needsUser",
+              "type": {
+                "text": "boolean"
+              }
+            }
+          ],
+          "description": "Set it for one session, announcing `autopilot-needs-user` when it changes."
+        },
+        {
+          "kind": "function",
+          "name": "autopilotNeedsUser",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "sessionKey",
+              "optional": true,
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Whether a session has something waiting on the person — or, without a key (a bubble that cannot\ntell which assistant it holds), whether any session has."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "setAutopilotNeedsUser",
+          "declaration": {
+            "name": "setAutopilotNeedsUser",
+            "module": "src/channel/autopilot-needs-user.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "autopilotNeedsUser",
+          "declaration": {
+            "name": "autopilotNeedsUser",
+            "module": "src/channel/autopilot-needs-user.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/autopilot/autopilot-driver.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "AUTOPILOT_CLAIMANT",
+          "type": {
+            "text": "string"
+          },
+          "default": "'autopilot'",
+          "description": "The holder id the autopilot claims interactions as."
+        },
+        {
+          "kind": "class",
+          "description": "Autopilot (GENC-1660): a driver decorator that answers the questions a working agent asks the\nuser, on their behalf, grounded in the agent's autopilot config (for bootstrap, the brief).\n\nNeither side calls the other. The working agent asks as it always does; this driver claims the\ninteractions its policy allows, while it is running for that flow, and answers each in one short\nturn on the flow's `AutopilotSession`. It plugs in only through the generic extension points\n— an interaction interceptor, a handler capability and the flow lifecycle — so the core knows\nnothing about it, and it wraps any `AiDriver`.",
+          "name": "AutopilotDriver",
+          "members": [
+            {
+              "kind": "field",
+              "name": "agents",
+              "type": {
+                "text": "readonly AgentConfig[]"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "providerRegistry",
+              "type": {
+                "text": "AIProviderRegistry"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "sessionKey",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "activityBus",
+              "type": {
+                "text": "ActivityBus"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "listeners",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new Set<() => void>()"
+            },
+            {
+              "kind": "field",
+              "name": "sessions",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new Map<string, AutopilotSession>()"
+            },
+            {
+              "kind": "field",
+              "name": "onFor",
+              "type": {
+                "text": "string | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "The flow the mode applies to: set when it is first switched, cleared when that flow ends."
+            },
+            {
+              "kind": "field",
+              "name": "mode",
+              "type": {
+                "text": "'paused' | 'running'"
+              },
+              "privacy": "private",
+              "default": "'paused'"
+            },
+            {
+              "kind": "field",
+              "name": "pauseState",
+              "type": {
+                "text": "AutopilotHostState['pause'] | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "held",
+              "type": {
+                "text": "Held | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "open",
+              "type": {
+                "text": "InteractionOpened | undefined"
+              },
+              "privacy": "private",
+              "description": "The interaction open right now, whoever holds it: claimed or not, it was offered here first.\n`held` covers only what the autopilot claimed, so this is how the status knows that the working\nagent is parked on a question left with the person (see `waitingOnUser`)."
+            },
+            {
+              "kind": "field",
+              "name": "declinedWhilePaused",
+              "type": {
+                "text": "InteractionOpened | undefined"
+              },
+              "privacy": "private",
+              "description": "The open interaction, when the autopilot declined it only for being paused as it opened: a live\nResume may still take it (see `takeOpenOnResume`). Cleared when it is taken or settles."
+            },
+            {
+              "kind": "field",
+              "name": "refinements",
+              "type": {
+                "text": "{ key: string; count: number } | undefined"
+              },
+              "privacy": "private",
+              "description": "Refining actions taken on the current step (written answers among them), for the limit."
+            },
+            {
+              "kind": "field",
+              "name": "watchdog",
+              "type": {
+                "text": "ReturnType<typeof setTimeout> | undefined"
+              },
+              "privacy": "private",
+              "description": "The watchdog's next check, while a claimed interaction is pending."
+            },
+            {
+              "kind": "field",
+              "name": "endedDiagnostics",
+              "type": {
+                "text": "DiagnosticEntry[]"
+              },
+              "privacy": "private",
+              "readonly": true,
+              "default": "[]",
+              "description": "What sessions that have ended did, kept for the debug log."
+            },
+            {
+              "kind": "field",
+              "name": "consecutiveReplies",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "Written answers sent in a row; see `MAX_CONSECUTIVE_REPLIES`."
+            },
+            {
+              "kind": "field",
+              "name": "turnHandBack",
+              "type": {
+                "text": "{ why: string } | undefined"
+              },
+              "privacy": "private",
+              "description": "Set while the turn-level hand-back waits on the person."
+            },
+            {
+              "kind": "field",
+              "name": "restored",
+              "type": {
+                "text": "PersistedAutopilotMode | undefined"
+              },
+              "privacy": "private",
+              "description": "A mode restored with the session, waiting for its flow to become the owner again."
+            },
+            {
+              "kind": "field",
+              "name": "handingBack",
+              "type": {
+                "text": "Carried | undefined"
+              },
+              "privacy": "private",
+              "description": "The mode of a hand-off's target that has released, kept for its caller, which has not taken the\nlock back yet (GENC-1751): the flow has no owner in between. See `carriedTo`."
+            },
+            {
+              "kind": "field",
+              "name": "switchedFrom",
+              "type": {
+                "text": "Carried | undefined"
+              },
+              "privacy": "private",
+              "description": "The mode of the flow that just ended, should a one-way hand-off with nobody waiting turn out to\nhave ended it: that switch announces itself only after the owner has changed (GENC-1751)."
+            },
+            {
+              "kind": "field",
+              "name": "generation",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "Bumped on every pause and resume, and when its sessions end. A written answer is sent only if\nnone came between asking for it and its landing: one started before a pause is stale after it,\neven once resumed."
+            },
+            {
+              "kind": "field",
+              "name": "turnsInFlight",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "Working turns this driver has started that have not ended yet; see `working`."
+            },
+            {
+              "kind": "field",
+              "name": "answersInFlight",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "Written questions being answered right now; see `working`."
+            },
+            {
+              "kind": "field",
+              "name": "ranSinceStop",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the autopilot has been running, and working, since it last stopped or was paused: so\ngoing idle now is a stop to report. Outlives its flow ending, so a turn still running then is\nwaited out. See `watchForStop`."
+            },
+            {
+              "kind": "field",
+              "name": "stopCheck",
+              "type": {
+                "text": "ReturnType<typeof setTimeout> | undefined"
+              },
+              "privacy": "private",
+              "description": "The check that confirms the autopilot stopped, once it looked like it had."
+            },
+            {
+              "kind": "field",
+              "name": "handBackWaits",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new Set<() => void>()",
+              "description": "Stops each wait for a widget left with the person to ask them; see `reportHandBackWhenAsking`."
+            },
+            {
+              "kind": "field",
+              "name": "state",
+              "type": {
+                "text": "AutopilotHostState"
+              },
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "waitingOnUser",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "Whether the working agent is parked on a question the person holds, with the autopilot deciding\nnothing: one it never took — its policy keeps it for the person, it is `userOnly` (the turn-level\nhand-back among them), it has no controller, or it opened while paused and no Resume has taken\nit since (a restored mode takes nothing) — or one another interceptor took and then gave to the\nperson. One the autopilot handed back reads `selfPaused`, and one a pause handed over reads\n`paused`; `state` settles both before asking this.\n\nNever one that asks them nothing (see `asksThePerson`): the person holds it, but it is work\nrunning, which settles by itself, so \"waiting for your answer\" would be untrue. A hand-back is\nreported by the same rule (see `reportHandBackWhenAsking`)."
+            },
+            {
+              "kind": "field",
+              "name": "copy",
+              "type": {
+                "text": "AutopilotCopy"
+              },
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "subscribe",
+              "return": {
+                "type": {
+                  "text": "() => void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "listener",
+                  "type": {
+                    "text": "() => void"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "pause",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "resume",
               "return": {
                 "type": {
                   "text": "void"
@@ -1722,7 +2021,7 @@
                   "text": "PersistedAutopilotMode | undefined"
                 }
               },
-              "description": "The mode to save with the session, while it is set for the current flow."
+              "description": "The mode to save with the session, while it is set for the current flow — or kept for a\nhand-off's caller while its target releases, saved for that target, as the stack saves it."
             },
             {
               "kind": "method",
@@ -2432,72 +2731,164 @@
                     "text": "DecisionOutcome"
                   }
                 }
-              ]
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "handBack",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "held",
+                  "type": {
+                    "text": "Held"
+                  }
+                },
+                {
+                  "name": "reason",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "trigger",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "The autopilot's self-pause, for one interaction (§4.10): the person gets it, with the reason as\nthe banner, and the autopilot carries on by itself once they answer. Only while it is still\nthe autopilot's to hand back — not settled, not already with the person — and its decision\nstops with it, so a decision still running spends nothing more on an interaction it no longer\nholds. Every caller (a decision's own hand-back, a failed decision, the watchdog) gets both."
+            },
+            {
+              "kind": "method",
+              "name": "releaseHeld",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "On detach: hand a claimed interaction the autopilot still holds to the person, stopping its\ndecision, so the driver it wrapped lives on with nothing held by an autopilot that is gone."
+            },
+            {
+              "kind": "method",
+              "name": "onSettled",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "held",
+                  "type": {
+                    "text": "Held"
+                  }
+                }
+              ],
+              "description": "A claimed interaction settled, whoever settled it."
+            },
+            {
+              "kind": "method",
+              "name": "onFlowOwnerChanged",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "owner",
+                  "type": {
+                    "text": "string | null"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "onHandOffStarted",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "frame",
+                  "type": {
+                    "text": "HandOffFrame"
+                  }
+                }
+              ],
+              "description": "A one-way hand-off with nobody waiting is a plain switch, the caller deactivated, so nothing on\nthe stack says the owner it changed to took over the same task: its event, raised once the\ntarget is active, does (GENC-1751)."
+            },
+            {
+              "kind": "method",
+              "name": "current",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Carried | undefined"
+                }
+              },
+              "description": "The mode set for the current flow, or kept for the caller of a hand-back under way."
             },
             {
               "kind": "method",
-              "name": "handBack",
+              "name": "carriedTo",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "Carried | undefined"
                 }
               },
               "parameters": [
                 {
-                  "name": "held",
-                  "type": {
-                    "text": "Held"
-                  }
-                },
-                {
-                  "name": "reason",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "trigger",
+                  "name": "owner",
                   "type": {
-                    "text": "string"
+                    "text": "string | null"
                   }
                 }
               ],
-              "description": "The autopilot's self-pause, for one interaction (§4.10): the person gets it, with the reason as\nthe banner, and the autopilot carries on by itself once they answer. Only while it is still\nthe autopilot's to hand back — not settled, not already with the person — and its decision\nstops with it, so a decision still running spends nothing more on an interaction it no longer\nholds. Every caller (a decision's own hand-back, a failed decision, the watchdog) gets both."
-            },
-            {
-              "kind": "method",
-              "name": "releaseHeld",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "description": "On detach: hand a claimed interaction the autopilot still holds to the person, stopping its\ndecision, so the driver it wrapped lives on with nothing held by an autopilot that is gone."
+              "description": "The mode that carries to `owner` because the owner changed for a hand-off or its hand-back, as\nthe hand-off stack shows it at that moment (GENC-1751):\n- a hand-off: `owner` is the top frame's target, which has not finished. Its frame is on the\n  stack before the target is activated, and so is a waiting caller's passed on by a one-way\n  hand-off from a target;\n- a hand-back: the top frame's target, which the mode is set for, has finished, and `owner` is\n  its caller, or no one while the target releases. Its frame leaves the stack only after the\n  caller is active again.\n\nClear and an agents change empty the stack before the flow ends, so the mode ends with it, as\nit ends with any flow. A turn routed away from the target ends the hand-offs the same way."
             },
             {
               "kind": "method",
-              "name": "onSettled",
+              "name": "handsBack",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "boolean"
                 }
               },
               "parameters": [
                 {
-                  "name": "held",
+                  "name": "target",
                   "type": {
-                    "text": "Held"
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "owner",
+                  "type": {
+                    "text": "string"
                   }
                 }
               ],
-              "description": "A claimed interaction settled, whoever settled it."
+              "description": "Whether `owner` is the caller the top hand-off hands back to from `target`."
             },
             {
               "kind": "method",
-              "name": "onFlowOwnerChanged",
+              "name": "carry",
               "privacy": "private",
               "return": {
                 "type": {
@@ -2505,13 +2896,20 @@
                 }
               },
               "parameters": [
+                {
+                  "name": "carried",
+                  "type": {
+                    "text": "Carried"
+                  }
+                },
                 {
                   "name": "owner",
                   "type": {
-                    "text": "string | null"
+                    "text": "string"
                   }
                 }
-              ]
+              ],
+              "description": "Set `carried`'s mode for `owner`, which took the task over in a hand-off or its hand-back. A\npause the person chose carries with it; the autopilot's own hand-back of an interaction does\nnot, since that interaction settled before the hand-off could start."
             },
             {
               "kind": "method",
@@ -4599,289 +4997,136 @@
           "kind": "js",
           "name": "type",
           "declaration": {
-            "name": "type",
-            "module": "./widget-tools"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "WidgetToolSpec",
-          "declaration": {
-            "name": "WidgetToolSpec",
-            "module": "./widget-tools"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "AutopilotHandBack",
-          "declaration": {
-            "name": "AutopilotHandBack",
-            "module": "./hand-back/hand-back"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/autopilot/widget-tools.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "widgetTools",
-          "return": {
-            "type": {
-              "text": "WidgetTools"
-            }
-          },
-          "parameters": [
-            {
-              "name": "componentName",
-              "type": {
-                "text": "string"
-              }
-            },
-            {
-              "name": "tools",
-              "type": {
-                "text": "{ [K in keyof TArgs]: WidgetToolSpec<TController, TArgs[K]> }"
-              }
-            }
-          ],
-          "description": "Declare tools that read from one widget type (GENC-1660): parameterised reads that a view cannot\nexpress, such as one table's rows, or a page of them.\n\nPut them on the autopilot (`defineAutopilot({ widgetTools: [...] })`), never discovered from the\nregistration. Its tool list is fixed when its session starts, sorted by name, and identical for\nevery decision, so the cache never breaks. Each call is routed to the interaction of\n`componentName` the autopilot is deciding, and `run` gets its controller; with none open, it is\nrefused with a reason. While one is open, the autopilot's tail says which tools are usable now.\n\nReads only. Their results leave the autopilot's history at the end of the decision, as\n`widget_read`'s do."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "widgetTools",
-          "declaration": {
-            "name": "widgetTools",
-            "module": "src/autopilot/widget-tools.ts"
-          }
-        }
-      ]
-    },
-    {
-      "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."
-            },
+            "name": "type",
+            "module": "./widget-tools"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "WidgetToolSpec",
+          "declaration": {
+            "name": "WidgetToolSpec",
+            "module": "./widget-tools"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AutopilotHandBack",
+          "declaration": {
+            "name": "AutopilotHandBack",
+            "module": "./hand-back/hand-back"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/autopilot/widget-tools.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "widgetTools",
+          "return": {
+            "type": {
+              "text": "WidgetTools"
+            }
+          },
+          "parameters": [
             {
-              "kind": "method",
-              "name": "close",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "description": "Close the underlying BroadcastChannel. Call once on application teardown if needed."
+              "name": "componentName",
+              "type": {
+                "text": "string"
+              }
             },
             {
-              "kind": "method",
-              "name": "notifyLocal",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "type",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "detail",
-                  "type": {
-                    "text": "unknown"
-                  }
-                }
-              ]
+              "name": "tools",
+              "type": {
+                "text": "{ [K in keyof TArgs]: WidgetToolSpec<TController, TArgs[K]> }"
+              }
             }
-          ]
-        },
+          ],
+          "description": "Declare tools that read from one widget type (GENC-1660): parameterised reads that a view cannot\nexpress, such as one table's rows, or a page of them.\n\nPut them on the autopilot (`defineAutopilot({ widgetTools: [...] })`), never discovered from the\nregistration. Its tool list is fixed when its session starts, sorted by name, and identical for\nevery decision, so the cache never breaks. Each call is routed to the interaction of\n`componentName` the autopilot is deciding, and `run` gets its controller; with none open, it is\nrefused with a reason. While one is open, the autopilot's tail says which tools are usable now.\n\nReads only. Their results leave the autopilot's history at the end of the decision, as\n`widget_read`'s do."
+        }
+      ],
+      "exports": [
         {
-          "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."
+          "kind": "js",
+          "name": "widgetTools",
+          "declaration": {
+            "name": "widgetTools",
+            "module": "src/autopilot/widget-tools.ts"
+          }
+        }
+      ]
+    },
+    {
+      "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": "NOOP_ACTIVITY_BUS",
+          "name": "CachePolicy",
           "declaration": {
-            "name": "NOOP_ACTIVITY_BUS",
-            "module": "src/channel/ai-activity-bus.ts"
+            "name": "CachePolicy",
+            "module": "src/config/config.ts"
           }
         },
         {
           "kind": "js",
-          "name": "AgenticActivityBus",
+          "name": "ChatFallback",
           "declaration": {
-            "name": "AgenticActivityBus",
-            "module": "src/channel/ai-activity-bus.ts"
+            "name": "ChatFallback",
+            "module": "src/config/config.ts"
           }
         },
         {
           "kind": "js",
-          "name": "agenticActivityBus",
+          "name": "ChatInputDuringExecutionMode",
           "declaration": {
-            "name": "agenticActivityBus",
-            "module": "src/channel/ai-activity-bus.ts"
+            "name": "ChatInputDuringExecutionMode",
+            "module": "src/config/config.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ChatThinkingPolicy",
+          "declaration": {
+            "name": "ChatThinkingPolicy",
+            "module": "src/config/config.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ChatToolChoice",
+          "declaration": {
+            "name": "ChatToolChoice",
+            "module": "src/config/config.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "defineAgent",
+          "declaration": {
+            "name": "defineAgent",
+            "module": "src/config/config.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/channel/ai-activity-channel.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/channel/autopilot-needs-user.ts",
+      "path": "src/config/define-stateful-agent.ts",
       "declarations": [
         {
           "kind": "function",
-          "name": "setAutopilotNeedsUser",
+          "name": "restoreMachine",
           "return": {
             "type": {
               "text": "void"
@@ -4889,59 +5134,162 @@
           },
           "parameters": [
             {
-              "name": "sessionKey",
+              "name": "machine",
               "type": {
-                "text": "string"
-              }
+                "text": "{ stop: () => void; start: (options?: { state?: unknown }) => void }"
+              },
+              "description": "the machine to restore (already constructed/started)."
             },
             {
-              "name": "needsUser",
+              "name": "restored",
               "type": {
-                "text": "boolean"
+                "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": "Set it for one session, announcing `autopilot-needs-user` when it changes."
+          "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": "function",
-          "name": "autopilotNeedsUser",
+          "name": "defineAutopilot",
           "return": {
             "type": {
-              "text": "boolean"
+              "text": "AutopilotConfig<S>"
             }
           },
           "parameters": [
             {
-              "name": "sessionKey",
-              "optional": true,
+              "name": "config",
               "type": {
-                "text": "string"
+                "text": "AutopilotConfig<S>"
               }
             }
           ],
-          "description": "Whether a session has something waiting on the person — or, without a key (a bubble that cannot\ntell which assistant it holds), whether any session has."
+          "description": "Define an autopilot for a stateful agent whose state is `S` (GENC-1660). An identity function\nthat exists for its type: the resolvers get `S`, and the result goes on `defineStatefulAgent`'s\n`autopilot` option."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "restoreMachine",
+          "declaration": {
+            "name": "restoreMachine",
+            "module": "src/config/define-stateful-agent.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "defineStatefulAgent",
+          "declaration": {
+            "name": "defineStatefulAgent",
+            "module": "src/config/define-stateful-agent.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "defineAutopilot",
+          "declaration": {
+            "name": "defineAutopilot",
+            "module": "src/config/define-stateful-agent.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/config/fallback-agents.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "friendlyFallbackAgent",
+          "type": {
+            "text": "FallbackAgentConfig"
+          },
+          "default": "{\n  name: 'Assistant',\n  fallback: true,\n  systemPrompt: `You are a warm, friendly assistant. For general conversation like \"Hi\" or \"How are you\", you can have a friendly chat. For anything more complex, you cannot directly help, but you can explain what specialists are available. The available specialists are:\\n\\n{{agents}}\\n\\nPolitely let the user know what you can help with and invite them to rephrase their request if it is outside your scope.`,\n}",
+          "description": "A warm, conversational fallback agent. Acknowledges it can't help directly,\nexplains what the available specialists can do, and invites the user to retry.\n\nThe system prompt is generated at runtime by `OrchestratingDriver` from the\nspecialist list — no manual authoring required."
+        },
+        {
+          "kind": "variable",
+          "name": "strictFallbackAgent",
+          "type": {
+            "text": "FallbackAgentConfig"
+          },
+          "default": "{\n  name: 'Assistant',\n  fallback: true,\n  systemPrompt: `You are a concise assistant. The user's request is outside your scope. The available specialists are: {{agents}}.\n\n{{unroutable}}\n\nAnswer in a single short sentence. Do not elaborate.`,\n}",
+          "description": "A brief, professional fallback agent. States what is available without\nelaboration. The `{{agents}}` placeholder is replaced at runtime by\n`OrchestratingDriver` with the generated specialist list.\n\nThe `{{unroutable}}` placeholder positions `UNROUTABLE_INSTRUCTION` — the framework's\ninstruction for a substantive request no specialist covers, which is otherwise APPENDED to a\nstring-form prompt. Positioned rather than appended for one reason: this preset's whole point is\nbrevity, and appended text would be the last thing the model reads. Putting the block above the\nbrevity rule leaves \"a single short sentence\" with the recency, so the two compose instead of\ncompeting. A prompt whose tone rules matter should do the same."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "friendlyFallbackAgent",
+          "declaration": {
+            "name": "friendlyFallbackAgent",
+            "module": "src/config/fallback-agents.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "strictFallbackAgent",
+          "declaration": {
+            "name": "strictFallbackAgent",
+            "module": "src/config/fallback-agents.ts"
+          }
         }
-      ],
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/config/index.ts",
+      "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "setAutopilotNeedsUser",
+          "name": "*",
           "declaration": {
-            "name": "setAutopilotNeedsUser",
-            "module": "src/channel/autopilot-needs-user.ts"
+            "name": "*",
+            "package": "./config"
           }
         },
         {
           "kind": "js",
-          "name": "autopilotNeedsUser",
+          "name": "*",
           "declaration": {
-            "name": "autopilotNeedsUser",
-            "module": "src/channel/autopilot-needs-user.ts"
+            "name": "*",
+            "package": "./fallback-agents"
           }
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/config/validate-providers.ts",
+      "declarations": [],
+      "exports": []
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/flowing-waves-indicator.ts",
@@ -5142,228 +5490,12 @@
               "name": "lastTime",
               "type": {
                 "text": "number | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "animFrame",
-              "type": {
-                "text": "number | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "stopTimer",
-              "type": {
-                "text": "number | undefined"
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "running",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "default": "false",
-              "description": "Whether the loop should keep rescheduling itself — see AiHaloOverlay.tick."
-            },
-            {
-              "kind": "method",
-              "name": "activeChanged",
-              "description": "Start/stop with `active`, so an idle overlay costs nothing.\n\nGuarded on `isConnected` because FAST invokes attribute-changed callbacks during\ninitialisation, before the element is in the document — `connectedCallback` is what decides\nfor an element that mounts already-active."
-            },
-            {
-              "kind": "method",
-              "name": "startAnimation",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "scheduleStop",
-              "privacy": "private",
-              "description": "Keep spinning until the host has finished fading out.\n\nDeactivating only drops the host's opacity — the overlay is still on screen for the length of\nthe transition, so stopping the instant `active` flips would freeze the rotation mid-fade.\n\nTimed rather than driven by `transitionend`, which never fires if the host is hidden or an app\noverrides the transition away, and a stop that never arrives is exactly the idle-tick bug this\ngating exists to prevent.\n\nThe timer re-reads `active` rather than trusting that it was cancelled. FAST reflects the\nproperty to the attribute on a queued update, so `activeChanged` can run again, out of order,\nafter a rapid toggle — and a stale stop landing on a re-activated overlay would leave it\nfrozen for good, which is worse than the idle ticking this gate removes."
-            },
-            {
-              "kind": "method",
-              "name": "cancelPendingStop",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "stopAnimation",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "tick",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "now",
-                  "optional": true,
-                  "type": {
-                    "text": "number"
-                  }
-                }
-              ]
-            }
-          ],
-          "attributes": [
-            {
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "active"
-            },
-            {
-              "type": {
-                "text": "number"
-              },
-              "default": "HALO_DEFAULT_SPEED",
-              "description": "Rotation speed in degrees per frame. Default: 1.5 (≈ 4 s per full revolution at 60 fps).",
-              "resolveInitializer": {
-                "module": "src/components/halo-overlay.ts"
-              },
-              "fieldName": "speed"
-            },
-            {
-              "name": "direction",
-              "type": {
-                "text": "'cw' | 'ccw'"
-              },
-              "default": "'cw'",
-              "description": "Rotation direction. Default: 'cw' (clockwise).",
-              "fieldName": "direction"
-            },
-            {
-              "name": "border-size",
-              "type": {
-                "text": "number"
-              },
-              "default": "HALO_DEFAULT_BORDER_SIZE",
-              "description": "Border thickness in px. Default: 3.",
-              "resolveInitializer": {
-                "module": "src/components/halo-overlay.ts"
-              },
-              "fieldName": "borderSize"
-            },
-            {
-              "name": "glow-opacity",
-              "type": {
-                "text": "number"
-              },
-              "default": "HALO_DEFAULT_GLOW_OPACITY",
-              "description": "Glow layer opacity (0–1). Default: 0.35.",
-              "resolveInitializer": {
-                "module": "src/components/halo-overlay.ts"
-              },
-              "fieldName": "glowOpacity"
-            },
-            {
-              "name": "glow-spread",
-              "type": {
-                "text": "number"
-              },
-              "default": "HALO_DEFAULT_GLOW_SPREAD",
-              "description": "Transparent stop of the radial glow mask as a percentage (0–100). Higher = less spread. Default: 70.",
-              "resolveInitializer": {
-                "module": "src/components/halo-overlay.ts"
-              },
-              "fieldName": "glowSpread"
-            }
-          ],
-          "superclass": {
-            "name": "GenesisElement",
-            "package": "@genesislcap/web-core"
-          },
-          "tagName": "ai-halo-overlay",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AiHaloOverlay",
-          "declaration": {
-            "name": "AiHaloOverlay",
-            "module": "src/components/halo-overlay.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "ai-halo-overlay",
-          "declaration": {
-            "name": "AiHaloOverlay",
-            "module": "src/components/halo-overlay.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/plasma-orb-indicator.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "Animated \"plasma orb\" loading indicator — a fixed glowing energy sphere whose\nluminous filaments and swirls drift and rotate inside it, like a plasma ball.\nThe globe never resizes; only the energy moves.\n\nBrand-coloured: a violet energy core, a slow cyan/pink tint wash, and a warm\namber hot-spot — covering all four brand colours.\n\nVisual sibling of the dots loading indicator; interchangeable with the other\nloading styles for the \"assistant is working\" state.",
-          "name": "AiPlasmaOrbIndicator",
-          "superclass": {
-            "name": "GenesisElement",
-            "package": "@genesislcap/web-core"
-          },
-          "tagName": "ai-plasma-orb-indicator",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AiPlasmaOrbIndicator",
-          "declaration": {
-            "name": "AiPlasmaOrbIndicator",
-            "module": "src/components/plasma-orb-indicator.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "ai-plasma-orb-indicator",
-          "declaration": {
-            "name": "AiPlasmaOrbIndicator",
-            "module": "src/components/plasma-orb-indicator.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/waves-indicator.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "Animated \"waves inside a circle\" loading indicator — coloured sine waves that\nslosh like glowing liquid inside a circular window, ringed by a rotating\ngradient halo (the same effect as `<ai-halo-overlay>`).\n\nVisual sibling of the dots loading indicator; the two are interchangeable\nstyles of the same \"assistant is working\" state.",
-          "name": "AiWavesIndicator",
-          "members": [
-            {
-              "kind": "field",
-              "name": "size",
-              "type": {
-                "text": "number"
-              },
-              "default": "56",
-              "description": "Diameter of the circular window in px. Default: 56."
-            },
-            {
-              "kind": "method",
-              "name": "sizeChanged"
+              },
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "startTime",
+              "name": "animFrame",
               "type": {
                 "text": "number | undefined"
               },
@@ -5371,7 +5503,7 @@
             },
             {
               "kind": "field",
-              "name": "animFrame",
+              "name": "stopTimer",
               "type": {
                 "text": "number | undefined"
               },
@@ -5379,324 +5511,309 @@
             },
             {
               "kind": "field",
-              "name": "wavePaths",
+              "name": "running",
               "type": {
-                "text": "SVGPathElement[] | undefined"
+                "text": "boolean"
               },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the loop should keep rescheduling itself — see AiHaloOverlay.tick."
+            },
+            {
+              "kind": "method",
+              "name": "activeChanged",
+              "description": "Start/stop with `active`, so an idle overlay costs nothing.\n\nGuarded on `isConnected` because FAST invokes attribute-changed callbacks during\ninitialisation, before the element is in the document — `connectedCallback` is what decides\nfor an element that mounts already-active."
+            },
+            {
+              "kind": "method",
+              "name": "startAnimation",
               "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "tick",
+              "name": "scheduleStop",
               "privacy": "private",
-              "parameters": [
-                {
-                  "name": "now",
-                  "optional": true,
-                  "type": {
-                    "text": "number"
-                  }
-                }
-              ]
+              "description": "Keep spinning until the host has finished fading out.\n\nDeactivating only drops the host's opacity — the overlay is still on screen for the length of\nthe transition, so stopping the instant `active` flips would freeze the rotation mid-fade.\n\nTimed rather than driven by `transitionend`, which never fires if the host is hidden or an app\noverrides the transition away, and a stop that never arrives is exactly the idle-tick bug this\ngating exists to prevent.\n\nThe timer re-reads `active` rather than trusting that it was cancelled. FAST reflects the\nproperty to the attribute on a queued update, so `activeChanged` can run again, out of order,\nafter a rapid toggle — and a stale stop landing on a re-activated overlay would leave it\nfrozen for good, which is worse than the idle ticking this gate removes."
             },
             {
               "kind": "method",
-              "name": "buildWavePath",
+              "name": "cancelPendingStop",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "stopAnimation",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "tick",
               "privacy": "private",
-              "static": true,
-              "return": {
-                "type": {
-                  "text": "string"
-                }
-              },
               "parameters": [
                 {
-                  "name": "cfg",
-                  "type": {
-                    "text": "WaveConfig"
-                  }
-                },
-                {
-                  "name": "frame",
+                  "name": "now",
+                  "optional": true,
                   "type": {
                     "text": "number"
                   }
                 }
-              ],
-              "description": "Trace one wave's polyline `d` attribute for the given frame."
+              ]
             }
           ],
           "attributes": [
+            {
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "active"
+            },
             {
               "type": {
                 "text": "number"
               },
-              "default": "WAVES_DEFAULT_SIZE",
-              "description": "Diameter of the circular window in px. Default: 56.",
+              "default": "HALO_DEFAULT_SPEED",
+              "description": "Rotation speed in degrees per frame. Default: 1.5 (≈ 4 s per full revolution at 60 fps).",
               "resolveInitializer": {
-                "module": "src/components/waves-indicator.ts"
+                "module": "src/components/halo-overlay.ts"
               },
-              "fieldName": "size"
-            }
-          ],
-          "superclass": {
-            "name": "GenesisElement",
-            "package": "@genesislcap/web-core"
-          },
-          "tagName": "ai-waves-indicator",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "AiWavesIndicator",
-          "declaration": {
-            "name": "AiWavesIndicator",
-            "module": "src/components/waves-indicator.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "ai-waves-indicator",
-          "declaration": {
-            "name": "AiWavesIndicator",
-            "module": "src/components/waves-indicator.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/config/config.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "defineAgent",
-          "description": "Identity helper that infers the narrowest possible type for an agent config,\npreserving string literal types (including `name`) without requiring `as const`.\n\nUse this when you need `typeof myAgent` to carry the literal `name` type —\nfor example, when wiring `ChatToolHandlers<typeof myAgent>`.\n\n```ts\nconst myAgent = defineAgent({ name: 'my_agent', ... });\ntype Handlers = ChatToolHandlers<typeof myAgent>;\n// requestSubAgent name param is now typed as 'my_agent'\n```"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "CachePolicy",
-          "declaration": {
-            "name": "CachePolicy",
-            "module": "src/config/config.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "ChatFallback",
-          "declaration": {
-            "name": "ChatFallback",
-            "module": "src/config/config.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "ChatInputDuringExecutionMode",
-          "declaration": {
-            "name": "ChatInputDuringExecutionMode",
-            "module": "src/config/config.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "ChatThinkingPolicy",
-          "declaration": {
-            "name": "ChatThinkingPolicy",
-            "module": "src/config/config.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "ChatToolChoice",
-          "declaration": {
-            "name": "ChatToolChoice",
-            "module": "src/config/config.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "defineAgent",
-          "declaration": {
-            "name": "defineAgent",
-            "module": "src/config/config.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/config/define-stateful-agent.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "restoreMachine",
-          "return": {
-            "type": {
-              "text": "void"
-            }
-          },
-          "parameters": [
+              "fieldName": "speed"
+            },
             {
-              "name": "machine",
+              "name": "direction",
               "type": {
-                "text": "{ stop: () => void; start: (options?: { state?: unknown }) => void }"
+                "text": "'cw' | 'ccw'"
               },
-              "description": "the machine to restore (already constructed/started)."
+              "default": "'cw'",
+              "description": "Rotation direction. Default: 'cw' (clockwise).",
+              "fieldName": "direction"
             },
             {
-              "name": "restored",
+              "name": "border-size",
               "type": {
-                "text": "unknown"
+                "text": "number"
               },
-              "description": "the agent's serialized image (`ctx.restored` in `init`)."
+              "default": "HALO_DEFAULT_BORDER_SIZE",
+              "description": "Border thickness in px. Default: 3.",
+              "resolveInitializer": {
+                "module": "src/components/halo-overlay.ts"
+              },
+              "fieldName": "borderSize"
             },
             {
-              "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",
+              "name": "glow-opacity",
               "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": "function",
-          "name": "defineAutopilot",
-          "return": {
-            "type": {
-              "text": "AutopilotConfig<S>"
-            }
-          },
-          "parameters": [
+                "text": "number"
+              },
+              "default": "HALO_DEFAULT_GLOW_OPACITY",
+              "description": "Glow layer opacity (0–1). Default: 0.35.",
+              "resolveInitializer": {
+                "module": "src/components/halo-overlay.ts"
+              },
+              "fieldName": "glowOpacity"
+            },
             {
-              "name": "config",
+              "name": "glow-spread",
               "type": {
-                "text": "AutopilotConfig<S>"
-              }
+                "text": "number"
+              },
+              "default": "HALO_DEFAULT_GLOW_SPREAD",
+              "description": "Transparent stop of the radial glow mask as a percentage (0–100). Higher = less spread. Default: 70.",
+              "resolveInitializer": {
+                "module": "src/components/halo-overlay.ts"
+              },
+              "fieldName": "glowSpread"
             }
           ],
-          "description": "Define an autopilot for a stateful agent whose state is `S` (GENC-1660). An identity function\nthat exists for its type: the resolvers get `S`, and the result goes on `defineStatefulAgent`'s\n`autopilot` option."
+          "superclass": {
+            "name": "GenesisElement",
+            "package": "@genesislcap/web-core"
+          },
+          "tagName": "ai-halo-overlay",
+          "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "restoreMachine",
-          "declaration": {
-            "name": "restoreMachine",
-            "module": "src/config/define-stateful-agent.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "defineStatefulAgent",
+          "name": "AiHaloOverlay",
           "declaration": {
-            "name": "defineStatefulAgent",
-            "module": "src/config/define-stateful-agent.ts"
+            "name": "AiHaloOverlay",
+            "module": "src/components/halo-overlay.ts"
           }
         },
         {
-          "kind": "js",
-          "name": "defineAutopilot",
+          "kind": "custom-element-definition",
+          "name": "ai-halo-overlay",
           "declaration": {
-            "name": "defineAutopilot",
-            "module": "src/config/define-stateful-agent.ts"
+            "name": "AiHaloOverlay",
+            "module": "src/components/halo-overlay.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/config/fallback-agents.ts",
+      "path": "src/components/plasma-orb-indicator.ts",
       "declarations": [
         {
-          "kind": "variable",
-          "name": "friendlyFallbackAgent",
-          "type": {
-            "text": "FallbackAgentConfig"
-          },
-          "default": "{\n  name: 'Assistant',\n  fallback: true,\n  systemPrompt: `You are a warm, friendly assistant. For general conversation like \"Hi\" or \"How are you\", you can have a friendly chat. For anything more complex, you cannot directly help, but you can explain what specialists are available. The available specialists are:\\n\\n{{agents}}\\n\\nPolitely let the user know what you can help with and invite them to rephrase their request if it is outside your scope.`,\n}",
-          "description": "A warm, conversational fallback agent. Acknowledges it can't help directly,\nexplains what the available specialists can do, and invites the user to retry.\n\nThe system prompt is generated at runtime by `OrchestratingDriver` from the\nspecialist list — no manual authoring required."
-        },
-        {
-          "kind": "variable",
-          "name": "strictFallbackAgent",
-          "type": {
-            "text": "FallbackAgentConfig"
+          "kind": "class",
+          "description": "Animated \"plasma orb\" loading indicator — a fixed glowing energy sphere whose\nluminous filaments and swirls drift and rotate inside it, like a plasma ball.\nThe globe never resizes; only the energy moves.\n\nBrand-coloured: a violet energy core, a slow cyan/pink tint wash, and a warm\namber hot-spot — covering all four brand colours.\n\nVisual sibling of the dots loading indicator; interchangeable with the other\nloading styles for the \"assistant is working\" state.",
+          "name": "AiPlasmaOrbIndicator",
+          "superclass": {
+            "name": "GenesisElement",
+            "package": "@genesislcap/web-core"
           },
-          "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."
+          "tagName": "ai-plasma-orb-indicator",
+          "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "friendlyFallbackAgent",
+          "name": "AiPlasmaOrbIndicator",
           "declaration": {
-            "name": "friendlyFallbackAgent",
-            "module": "src/config/fallback-agents.ts"
+            "name": "AiPlasmaOrbIndicator",
+            "module": "src/components/plasma-orb-indicator.ts"
           }
         },
         {
-          "kind": "js",
-          "name": "strictFallbackAgent",
+          "kind": "custom-element-definition",
+          "name": "ai-plasma-orb-indicator",
           "declaration": {
-            "name": "strictFallbackAgent",
-            "module": "src/config/fallback-agents.ts"
+            "name": "AiPlasmaOrbIndicator",
+            "module": "src/components/plasma-orb-indicator.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/config/index.ts",
-      "declarations": [],
+      "path": "src/components/waves-indicator.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Animated \"waves inside a circle\" loading indicator — coloured sine waves that\nslosh like glowing liquid inside a circular window, ringed by a rotating\ngradient halo (the same effect as `<ai-halo-overlay>`).\n\nVisual sibling of the dots loading indicator; the two are interchangeable\nstyles of the same \"assistant is working\" state.",
+          "name": "AiWavesIndicator",
+          "members": [
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "number"
+              },
+              "default": "56",
+              "description": "Diameter of the circular window in px. Default: 56."
+            },
+            {
+              "kind": "method",
+              "name": "sizeChanged"
+            },
+            {
+              "kind": "field",
+              "name": "startTime",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "animFrame",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "wavePaths",
+              "type": {
+                "text": "SVGPathElement[] | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "tick",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "now",
+                  "optional": true,
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "buildWavePath",
+              "privacy": "private",
+              "static": true,
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "cfg",
+                  "type": {
+                    "text": "WaveConfig"
+                  }
+                },
+                {
+                  "name": "frame",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Trace one wave's polyline `d` attribute for the given frame."
+            }
+          ],
+          "attributes": [
+            {
+              "type": {
+                "text": "number"
+              },
+              "default": "WAVES_DEFAULT_SIZE",
+              "description": "Diameter of the circular window in px. Default: 56.",
+              "resolveInitializer": {
+                "module": "src/components/waves-indicator.ts"
+              },
+              "fieldName": "size"
+            }
+          ],
+          "superclass": {
+            "name": "GenesisElement",
+            "package": "@genesislcap/web-core"
+          },
+          "tagName": "ai-waves-indicator",
+          "customElement": true
+        }
+      ],
       "exports": [
         {
           "kind": "js",
-          "name": "*",
+          "name": "AiWavesIndicator",
           "declaration": {
-            "name": "*",
-            "package": "./config"
+            "name": "AiWavesIndicator",
+            "module": "src/components/waves-indicator.ts"
           }
         },
         {
-          "kind": "js",
-          "name": "*",
+          "kind": "custom-element-definition",
+          "name": "ai-waves-indicator",
           "declaration": {
-            "name": "*",
-            "package": "./fallback-agents"
+            "name": "AiWavesIndicator",
+            "module": "src/components/waves-indicator.ts"
           }
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/config/validate-providers.ts",
-      "declarations": [],
-      "exports": []
-    },
     {
       "kind": "javascript-module",
       "path": "src/genesis/calendar.ts",
@@ -7217,6 +7334,15 @@
               },
               "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": "closable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Shows a Close button in the header, which fires `close-requested` and leaves the closing to\nwhatever holds the assistant. The chat bubble sets it while the assistant is in its dialog."
+            },
             {
               "kind": "field",
               "name": "agents",
@@ -10773,6 +10899,16 @@
               ],
               "description": "Report a turn that ended with the assistant waiting for the person to type (GENC-1660), for the\nAlways level: `turn-ended` on the activity bus, like every other notification report.\n\nOnly for a turn that ran to its end, failed ones included: not one the person stopped\n(`cancelling`), since they are there. Not while an interaction waits on them, which reports\nitself, so the person is never told twice about one moment. And not while an autopilot runs for\nthe flow: it answers, hands back or reports its own stop. Sub-agents' turns never get here; they\nrun inside one of the parent's."
             },
+            {
+              "kind": "method",
+              "name": "handleClose",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Called when the user clicks the header's Close button."
+            },
             {
               "kind": "method",
               "name": "onChatHeaderMouseDown",
@@ -10914,6 +11050,10 @@
               "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 when the user presses the header's Close button, which shows while `closable` is set (the chat bubble sets it while the assistant is in its dialog). Bubbles and composed.",
+              "name": "close-requested"
+            },
             {
               "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"
@@ -10978,6 +11118,14 @@
               "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"
             },
+            {
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Shows a Close button in the header, which fires `close-requested` and leaves the closing to\nwhatever holds the assistant. The chat bubble sets it while the assistant is in its dialog.",
+              "fieldName": "closable"
+            },
             {
               "name": "debug-redux",
               "type": {
@@ -11063,9 +11211,9 @@
           "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  /** An agent's hand-off started (GENC-1737). `detail`: `HandOffFrame`. */\n  HandOffStarted: 'handoff-started',\n  /** A hand-off ended and its caller is active again. `detail`: `HandOffFrame`, with `outcome`. */\n  HandOffReturned: 'handoff-returned',\n  /** A hand-off ended with no hand-back. `detail`: `HandOffFrame`, with `outcome`. */\n  HandOffUnwound: 'handoff-unwound',\n}"
+            "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  /** An agent's hand-off started (GENC-1737). `detail`: `HandOffFrame`. */\n  HandOffStarted: 'handoff-started',\n  /** A hand-off ended and its caller is active again. `detail`: `HandOffFrame`, with `outcome`. */\n  HandOffReturned: 'handoff-returned',\n  /** A hand-off ended with no hand-back. `detail`: `HandOffFrame`, with `outcome`. */\n  HandOffUnwound: 'handoff-unwound',\n  /** The header's Close button pressed, shown while `closable` is set. No `detail`. */\n  CloseRequested: 'close-requested',\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  /** An agent's hand-off started (GENC-1737). `detail`: `HandOffFrame`. */\n  HandOffStarted: 'handoff-started',\n  /** A hand-off ended and its caller is active again. `detail`: `HandOffFrame`, with `outcome`. */\n  HandOffReturned: 'handoff-returned',\n  /** A hand-off ended with no hand-back. `detail`: `HandOffFrame`, with `outcome`. */\n  HandOffUnwound: 'handoff-unwound',\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  /** An agent's hand-off started (GENC-1737). `detail`: `HandOffFrame`. */\n  HandOffStarted: 'handoff-started',\n  /** A hand-off ended and its caller is active again. `detail`: `HandOffFrame`, with `outcome`. */\n  HandOffReturned: 'handoff-returned',\n  /** A hand-off ended with no hand-back. `detail`: `HandOffFrame`, with `outcome`. */\n  HandOffUnwound: 'handoff-unwound',\n  /** The header's Close button pressed, shown while `closable` is set. No `detail`. */\n  CloseRequested: 'close-requested',\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."
         },
         {
@@ -11638,7 +11786,7 @@
           "type": {
             "text": "Record<MetaEventType, MetaEventImportance>"
           },
-          "default": "{\n  'turn.error': 'high',\n  'tool.failed': 'high',\n  'subagent.failed': 'high',\n  'file.read-failed': 'high',\n  'suggestions.failed': 'high',\n  'context.threshold-crossed': 'high',\n  'context.compacted': 'high',\n  'persistence.restore-orphan': 'high',\n  // A save that did not land is silent data loss in progress: the transcript on screen\n  // is no longer backed by the store, and every later turn widens the gap. GENC-1511.\n  'persistence.save-failed': 'high',\n\n  'assistant.connected': 'normal',\n  'assistant.disconnected': 'normal',\n  'assistant.popout': 'normal',\n  'assistant.popin': 'normal',\n  'driver.created': 'normal',\n  'state.changed': 'normal',\n  'turn.start': 'normal',\n  'turn.end': 'normal',\n  'turn.retry': 'normal',\n  'tool.unresolved': 'normal',\n  'subagent.started': 'normal',\n  'subagent.completed': 'normal',\n  // One per routing decision, with what the classifier answered and what the call cost. Same\n  // level as the handoff it produces: you read them together to follow how a turn was routed.\n  'routing.decided': 'normal',\n  'agent.handoff': 'normal',\n  'agent.pinned': 'normal',\n  'agent.unpinned': 'normal',\n  'provider.selected': 'normal',\n  'interaction.requested': 'normal',\n  'interaction.resolved': 'normal',\n  // Bookkeeping about an already-finished turn; interesting when reconciling a session total.\n  'interaction.external-cost': 'normal',\n  // Spend that was billed but could NOT be recorded (the message was trimmed/condensed away, or\n  // the value was not real spend). 'high': it is the one way the session total goes quietly\n  // wrong, so it must stand out when reconciling.\n  'interaction.external-cost-dropped': 'high',\n  // What came of an answer, recorded by the tool that asked (see recordInteractionOutcome).\n  'interaction.outcome': 'normal',\n  // An outcome that could not be recorded: the widget goes on showing only the answer.\n  'interaction.outcome-dropped': 'high',\n  // A long action's step starting, finishing, or skipped on resume because it was already done.\n  'interaction.step': 'low',\n  // A cut checkpoint taken over after a reload, refused (by sameWork, and kept for a later request;\n  // or as malformed), or dropped at flow end, as is the live one.\n  'interaction.checkpoint': 'normal',\n  // A claimant handing a pending interaction to the person, or taking it back.\n  'interaction.held': 'normal',\n  // A claim on a `userOnly` interaction, refused. Expected when an interceptor claims broadly.\n  'interaction.claim-refused': 'low',\n  // A claimant ran one of the surface's actions: what it did, and whether that settled it.\n  'interaction.invoked': 'normal',\n  'autopilot.claimed': 'normal',\n  // One per interaction the autopilot does not take, so frequent and mostly expected.\n  'autopilot.declined': 'low',\n  'autopilot.decision-sent': 'low',\n  'autopilot.acted': 'normal',\n  'autopilot.handed-back': 'normal',\n  'autopilot.paused': 'normal',\n  'autopilot.resumed': 'normal',\n  // The wrapper itself failed: the journey stops being automatic without anyone choosing that.\n  'autopilot.error': 'high',\n  // A written answer counted against the step's limit; reaching it withdraws `reply`.\n  'autopilot.refinement': 'normal',\n  // The autopilot showed its own widget because a working turn ended needing the person.\n  'autopilot.handback-presented': 'normal',\n  // The autopilot was given the whole visible transcript: its first decision, a rebuild, or after\n  // a compaction removed the last message it saw.\n  'autopilot.catch-up': 'normal',\n  // Autopilot spend that reached no message, so it is missing from the session total.\n  'autopilot.cost-dropped': 'high',\n  'external-diagnostics.folded': 'normal',\n  'session.cleared': 'normal',\n  'session.switched': 'low',\n  'session.switch-deferred': 'low',\n  'persistence.restored': 'normal',\n  // Whether a restored flow will be re-activated and resumed (GENC-1662), and how much the trim cut.\n  'persistence.resume-planned': 'normal',\n  // A planned resume that did not run, and why (GENC-1662) — the divider was put back to plain.\n  'persistence.resume-withdrawn': 'normal',\n  'persistence.suppressed': 'normal',\n  'persistence.not-resumable': 'normal',\n\n  'driver.wired': 'low',\n  'driver.unwired': 'low',\n  'context.updated': 'low',\n  'context.condensed': 'low',\n  'panel.toggled': 'low',\n  'persistence.toggled': 'low',\n  'persistence.saved': 'low',\n  'attachment.added': 'low',\n}",
+          "default": "{\n  'turn.error': 'high',\n  'tool.failed': 'high',\n  'subagent.failed': 'high',\n  'file.read-failed': 'high',\n  'suggestions.failed': 'high',\n  'context.threshold-crossed': 'high',\n  'context.compacted': 'high',\n  'persistence.restore-orphan': 'high',\n  // A save that did not land is silent data loss in progress: the transcript on screen\n  // is no longer backed by the store, and every later turn widens the gap. GENC-1511.\n  'persistence.save-failed': 'high',\n\n  'assistant.connected': 'normal',\n  'assistant.disconnected': 'normal',\n  'assistant.popout': 'normal',\n  'assistant.popin': 'normal',\n  'driver.created': 'normal',\n  'state.changed': 'normal',\n  'turn.start': 'normal',\n  'turn.end': 'normal',\n  'turn.retry': 'normal',\n  'tool.unresolved': 'normal',\n  'subagent.started': 'normal',\n  'subagent.completed': 'normal',\n  // One per routing decision, with what the classifier answered and what the call cost. Same\n  // level as the handoff it produces: you read them together to follow how a turn was routed.\n  'routing.decided': 'normal',\n  'agent.handoff': 'normal',\n  'agent.pinned': 'normal',\n  'agent.unpinned': 'normal',\n  'provider.selected': 'normal',\n  'interaction.requested': 'normal',\n  'interaction.resolved': 'normal',\n  // Bookkeeping about an already-finished turn; interesting when reconciling a session total.\n  'interaction.external-cost': 'normal',\n  // Spend that was billed but could NOT be recorded (the message was trimmed/condensed away, or\n  // the value was not real spend). 'high': it is the one way the session total goes quietly\n  // wrong, so it must stand out when reconciling.\n  'interaction.external-cost-dropped': 'high',\n  // What came of an answer, recorded by the tool that asked (see recordInteractionOutcome).\n  'interaction.outcome': 'normal',\n  // An outcome that could not be recorded: the widget goes on showing only the answer.\n  'interaction.outcome-dropped': 'high',\n  // A long action's step starting, finishing, or skipped on resume because it was already done.\n  'interaction.step': 'low',\n  // A cut checkpoint taken over after a reload, refused (by sameWork, and kept for a later request;\n  // or as malformed), or dropped at flow end, as is the live one.\n  'interaction.checkpoint': 'normal',\n  // A claimant handing a pending interaction to the person, or taking it back.\n  'interaction.held': 'normal',\n  // A claim on a `userOnly` interaction, refused. Expected when an interceptor claims broadly.\n  'interaction.claim-refused': 'low',\n  // A claimant ran one of the surface's actions: what it did, and whether that settled it.\n  'interaction.invoked': 'normal',\n  'autopilot.claimed': 'normal',\n  // One per interaction the autopilot does not take, so frequent and mostly expected.\n  'autopilot.declined': 'low',\n  'autopilot.decision-sent': 'low',\n  'autopilot.acted': 'normal',\n  'autopilot.handed-back': 'normal',\n  'autopilot.paused': 'normal',\n  'autopilot.resumed': 'normal',\n  // The mode went with the task across a hand-off or its hand-back, rather than ending with the flow.\n  'autopilot.carried': 'normal',\n  // The wrapper itself failed: the journey stops being automatic without anyone choosing that.\n  'autopilot.error': 'high',\n  // A written answer counted against the step's limit; reaching it withdraws `reply`.\n  'autopilot.refinement': 'normal',\n  // The autopilot showed its own widget because a working turn ended needing the person.\n  'autopilot.handback-presented': 'normal',\n  // The autopilot was given the whole visible transcript: its first decision, a rebuild, or after\n  // a compaction removed the last message it saw.\n  'autopilot.catch-up': 'normal',\n  // Autopilot spend that reached no message, so it is missing from the session total.\n  'autopilot.cost-dropped': 'high',\n  'external-diagnostics.folded': 'normal',\n  'session.cleared': 'normal',\n  'session.switched': 'low',\n  'session.switch-deferred': 'low',\n  'persistence.restored': 'normal',\n  // Whether a restored flow will be re-activated and resumed (GENC-1662), and how much the trim cut.\n  'persistence.resume-planned': 'normal',\n  // A planned resume that did not run, and why (GENC-1662) — the divider was put back to plain.\n  'persistence.resume-withdrawn': 'normal',\n  'persistence.suppressed': 'normal',\n  'persistence.not-resumable': 'normal',\n\n  'driver.wired': 'low',\n  'driver.unwired': 'low',\n  'context.updated': 'low',\n  'context.condensed': 'low',\n  'panel.toggled': 'low',\n  'persistence.toggled': 'low',\n  'persistence.saved': 'low',\n  'attachment.added': 'low',\n}",
           "description": "Importance is intrinsic to the event *type*, not the instance, so it's\ndefined once here and stamped automatically by recordMetaEvent — call\nsites never pass it. The `Record` is exhaustive: adding a `MetaEventType`\nwithout a level here is a compile error.\n\n- `high`   — failures and hard limits you almost always want to see.\n- `normal` — meaningful session flow you read to follow what happened.\n- `low`    — frequent UI / bookkeeping noise, usually safe to skip."
         },
         {
@@ -11800,7 +11948,7 @@
           "type": {
             "text": "readonly string[]"
           },
-          "default": "[\n  'This is an exported debug log for the Genesis AI assistant. Read it top-to-bottom.',\n  \"`sessionUsage` is what this session spent: `costUsd` (USD, provider-reported per request and summed, cache discounts already applied) plus the four TOKEN BUCKETS — `uncachedInputTokens`, `cacheReadTokens`, `cacheWriteTokens`, `outputTokens`. Those four are disjoint and safe to add up for a total-tokens figure; the per-message fields further down are NOT (see kind:'message'). Each bucket bills at a different rate — cache reads a fraction of uncached input, cache writes a premium, output highest — so a big token count against a small cost means the prompt was mostly cache hits, not a missing charge. It covers sub-agent turns and spend a compaction banked, so for the CONVERSATION it is the authoritative total: prefer it over re-summing the timeline, which can be short by whatever the ring buffers evicted. The same figures appear under `meta.context`. It is as current as the snapshot it came from: the assistant's own download stamps a fresh one, but a log stitched by another tool can carry an older one — compare `meta.timestamp` with the last timeline entry, and if it is well behind, read these totals as historical and fall back to summing the timeline. One scope caveat: it is derived from the transcript, so it excludes billed calls that produced no message (a blank or refused attempt that was retried — see kind:'turn'.`usage`). Summing the turns can therefore come out HIGHER than this, and the difference is exactly that discarded spend, not a double-count.\",\n  \"What 'session' means for those figures: the CURRENT conversation under this session key (a host-supplied per-project id, or the element id + header title when the host supplies none) — which is not necessarily everything in `timeline`. It is re-derived from the live transcript, so it spans page loads only when the chat is being remembered, and a Clear resets it to zero. `timeline` is append-only regardless: it keeps every page load and the pre-Clear conversation, with the session.cleared event as the boundary. So on a long-lived log, read these totals as the latest conversation's and the earlier sections as history — not as a total of the whole file.\",\n  '`timeline` is the entire session as one array, already sorted chronologically by `timestamp` (ISO 8601). Every entry has a `kind`.',\n  'Timestamps are millisecond-resolution; entries that share the same millisecond are ordered by a fixed kind rank (event, then turn, then message), which is a heuristic and may not reflect exact causal order within that millisecond — e.g. a user message and the turn it triggered, or a final assistant message and its turn.end event, can appear in either order depending on whether they landed in the same millisecond. Read the logical structure of a turn rather than over-interpreting the micro-ordering of co-timestamped entries of different kinds.',\n  \"kind:'message' — the conversation. `role` is user/assistant/tool/system-event/synthetic-user; `agentName` says which agent produced it; `toolCalls`/`toolResult`/`interaction` carry tool and widget activity; `inputTokens`/`outputTokens`/`cost` are per-message LLM usage, where `inputTokens` is the WHOLE prompt for that request and `cacheReadTokens`/`cacheWriteTokens` BREAK IT DOWN rather than add to it — uncached input is `inputTokens` minus those two, and adding the cache fields to `inputTokens` counts the prompt twice. The cache fields are absent on providers that report no cache split (Gemini reports reads only, since implicit caching bills no write) and on messages persisted before they existed, so read them as 0 when missing. Each bucket bills at a different rate — cache reads a fraction of uncached input, cache writes a premium, output highest — so a large token count at a small cost means the prompt was mostly cache hits. `externalCostUsd` is any non-LLM cost a widget reported for its own external service calls (folded into the session cost total alongside `cost`). On model-produced assistant messages, `model` is the concrete model id that generated it (e.g. 'gemini-2.5-flash-lite') and `providerName` is the registry slot it resolved under (e.g. a tier name like 'high'/'low', or the default); together they attribute the message — and any tool calls it carries — to an exact model even across a mid-session vendor/tier switch, where one slot name can map to different models before and after the switch. Both are undefined on any entry that is NOT an LLM response: non-assistant roles (user/tool/system-event) and 'synthetic-user' echoes; assistant interaction/widget entries (empty content carrying an `interaction` — a rendered widget, not a model turn); driver-authored assistant fallbacks (the timeout, repeated-malformed-call, and empty-response apology messages); and messages restored from a session persisted before these fields existed. One partial case: on a genuine model turn whose provider exposes no `getStatus` (or reports no model), `providerName` is still set but `model` alone is undefined. A 'synthetic-user' message is a display-only echo of an interaction outcome (e.g. the answer a widget reported): it renders on the user's side of the chat and `agentName` is the agent that created it, but it is never sent to the LLM — so it has no matching 'turn' and the model learns the outcome only from the corresponding tool result. An echo of an answer an interceptor (such as an autopilot) gave is NOT synthetic-user: see the delegated-messages paragraph.\",\n  'The autopilot (GENC-1660) runs on a driver of its own, and everything it did is harvested into this log: entries with delegate: autopilot and an agentName ending in › Autopilot are its turns (the decision message it was sent is the user message of its turn, so what it was shown is there verbatim; its systemPrompt is its grounding, such as the brief), its tool calls (widget_read, widget_act, hand_back, any read-only tools of its own, and its widget tools — reads with parameters that a widget type declares, routed to the interaction of that type being decided and refused with a reason when none is, offered on every decision so its tool list never changes; while one is open its tail starts with a line naming them) and their results (a read, view or widget tool, is capped at about 20,000 characters, cut with a note asking for less, and leaves its history at the end of the decision as a one-line note), and its own events. Its cost is already in the session total: it is booked as externalCostUsd on the interaction each decision answered, or, for a written question it answered, on the user message it sent on the user behalf (delegate: autopilot), so do not add its turns to that total. Spend that reached no message is recorded as autopilot.cost-dropped instead.',\n  \"Delegated messages (GENC-1660): a message with a `delegate` field was written or sent ON THE USER'S BEHALF by a driver decorator, and `delegate` names it (e.g. autopilot). The platform stamps it; nothing else can. It renders as the assistant whatever its role. A delegated `user` message was NOT typed by the user: it is an answer given on their behalf, and the model read it with `delegateFraming` in brackets in front of the content (the stored `content` is the bare text). A delegated `assistant` message is display-only (`excludeFromProvider`): the decorator's narration note, or, when its answer carried no note, the widget's own echo of the answer (its `userMessage`), shown as the assistant and never as the person. A widget answer a decorator gave with a note is not echoed at all: the note already says what was chosen. To tell what the person decided from what was decided for them, read `interaction.answeredBy` and these fields, never the role alone.\",\n  \"Sub-agent messages appear inline. When a tool delegates to a sub-agent (via `requestSubAgent`), the sub-agent's whole conversation — its own assistant/tool messages, each with their own `content`/`thinking`/`toolCalls`/`toolResult` and per-message `model`/`providerName`/`inputTokens`/`outputTokens`/`cacheReadTokens`/`cacheWriteTokens`/`cost` — is hoisted into the timeline as ordinary kind:'message' entries, interleaved by timestamp right after the tool call that spawned them (so you read the delegation top-to-bottom). A hoisted entry is marked: `subAgentDepth` is its delegation depth (1 for a sub-agent, 2 for a sub-agent's sub-agent, …), `subAgentOf` is the id of the parent tool call that spawned it (correlates it back even when two sub-agents run in one parent turn), `subAgentName` is the sub-agent's own name, and `agentName` is rewritten to a `\\\"<parent> › <sub-agent>\\\"` breadcrumb (composing when nested, e.g. `\\\"UI Builder › Planner › Grounding\\\"`). The sub-agent's per-LLM-call snapshots also surface as kind:'turn' entries with an N-M `turnIndex`, and subagent.started/completed (or subagent.failed) events bracket the run. Per-message `cost` on hoisted entries is already part of the session total (it is summed from the un-flattened history), so summing the top-level timeline does NOT double-count.\",\n  \"kind:'turn' — one LLM call. `turnIndex` is a string: a top-level turn is the bare counter ('0', '1', …); a sub-agent's turns are numbered under the parent turn that activated them ('3-1', '3-2', …, and a nested sub-agent contributes '3-2-1', …), and `agentName` names the agent that ran the turn. `systemPrompt` and `toolNames` are what the model saw. A systemPrompt of '<repeated — identical to turn N>' was byte-identical to turn N and de-duplicated; the full prompt is shown whenever it changes (often because a stateful agent advanced), so prompt evolution is visible.\",\n  \"kind:'turn'.`model`/`providerName`/`provider` — which model ran that call: the concrete model id, the registry slot it resolved under (a tier name like 'high'/'low', or the default), and the vendor. Recorded per CALL, so an agent whose `provider` selector varies by state — a flow that plans on a high tier and executes on a low one — has every step attributed, including calls that produced no message. `model` is the SERVING model where the provider reports one, so a turn answered by a server-side fallback names the model that answered rather than the one requested; it always matches the `model` on the message that call produced. Absent when the provider exposes no `getStatus` and the transport stamped nothing.\",\n  \"kind:'turn'.`usage` — what that ONE call cost, in the same four-bucket + `costUsd` shape as `sessionUsage`. Absent while a call is in flight and on providers that report no usage. This is the SAME money as the message the call produced, not extra money: never add turn usage to message usage, and read a turn plus its message as one charge. Its distinct value is the calls that produced NO message — a blank or refused response is billed and then discarded before the retry, so the turn entry is the only record of that spend, and a turn with `usage` but no message after it is exactly that. `costUsd: 0` alongside a nonzero token count means the provider reported no price, not that the call was free.\",\n  \"kind:'turn'.`agentSnapshot` — the active agent's own view of its internal state, captured at that turn. An agent opts into this by exposing a `getDebugSnapshot()` that returns JSON-serializable per-state info; stateful/flow agents wire it automatically, so you can watch a flow advance turn-by-turn (e.g. current step, cursor, collected fields, pending changes). Absent for agents that don't expose one.\",\n  \"kind:'event' — a meta/lifecycle event. `type` names it (see below); `detail` carries structured data. `detail.placement` is the emitting UI instance: 'bubble' (collapsed), 'panel' (popped-out), or 'standalone'.\",\n  \"Each 'event' also has an `importance`: 'high' (failures/limits — turn.error, tool.failed, subagent.failed, file.read-failed, suggestions.failed, context.threshold-crossed), 'normal' (session flow — connects, turns, retries, handoffs, agent/provider changes, interactions, sub-agent start/complete), or 'low' (skippable UI/bookkeeping noise — panel.toggled, attachment.added, driver.wired/unwired, context.updated, context.condensed). To skim, ignore importance:'low'; to triage a failure, filter to importance:'high' then read the nearby messages and turns. A 'high' turn.error is often preceded by one or more 'normal' turn.retry events for the same reason — read them together to see how many attempts were made before bailing. 'message' and 'turn' entries carry no importance — they are the substance, always read them.\",\n  'Event types: assistant.connected/disconnected (mount + placement + whether the session was created or restored), assistant.popout/popin (window placement), driver.created/wired/unwired (which driver is live and why it stops/starts responding across a popout), state.changed (idle↔loading), turn.start/turn.end (turn boundary; turn.end carries durationMs), turn.retry (a recoverable in-turn retry — detail.reason plus attempt/maxAttempts; for malformed calls also finishMessage; for empty responses also the provider finishReason + thoughtsTokens + parts breakdown), turn.error (a turn failed or hit a guardrail — detail.reason is one of exception/malformed-function-call/empty-response/unknown-tool-limit/max-iterations/response-truncated/refusal/budget-exhausted/provider-refused/context-exhausted/ai-service-error, plus reason-specific diagnostics: attempts (for empty-response also finishReason + thoughtsTokens + a parts breakdown, distinguishing a thinking-only STOP from a truly empty turn), finishMessage, for response-truncated the model + maxTokens + outputTokens + tools, unknownTools (split into staleTools — real earlier this activation but retired by the current state or hidden behind an open exclusive fold — and hallucinatedTools — never advertised) + availableTools, iterations + limit, for budget-exhausted the budgetUsd + spentUsd figures reported by the proxy plus the resolved vendor, for provider-refused the kind (spend|auth) plus the upstream status and error type — the vendor refusing the ACCOUNT rather than us refusing to spend, so the remedy is a top-up or a key rotation rather than a raised cap, and the kind is the only place that distinction survives because the user-facing copy is deliberately cause-free, for context-exhausted the estimated contextTokens against the guard that stopped the turn plus the iterations reached — the driver ending a runaway tool loop at the edge of the context window rather than issuing a request the provider would reject, so the transcript survives intact and can still be compacted, for ai-service-error the code (one of AI_SERVICE_ERROR_CODES, e.g. NO_API_KEY) and the status the AI service answered with — its own text goes to the browser console only, or name + message for exceptions), tool.failed (a tool threw), tool.unresolved (the model called a tool that could not be dispatched — detail.kind is folded/fold-hidden/stale/unknown, plus tool + agent and, for the counted kinds, the consecutive streak; the recurring lead-up to an unknown-tool-limit turn.error), subagent.started/completed/failed (the lifecycle of a `requestSubAgent` delegation — detail.agent names the sub-agent; these bracket the sub-agent turns that appear as kind:turn entries with an N-M `turnIndex`; subagent.failed also carries detail.reason, one of max_iterations/malformed_tool_call/empty_response/unknown_tool_limit/timeout/response_truncated/refusal/budget_exhausted/provider_refused/context_exhausted/ai_service_error; budget_exhausted and provider_refused are terminal for the PARENT turn too, and so is ai_service_error when the refusal is about the service rather than the request and came from the vendor the parent calls — the parent stops rather than calling the model again into the same wall; after context_exhausted the parent goes on, but its own next call is likely to stop on the same guard), agent.handoff (routing; from=null is the initial activation), agent.pinned/unpinned (forced routing), routing.decided (ONE PER ROUTING DECISION — see its own paragraph below), provider.selected (the resolved provider for the upcoming turns — detail.provider is the registry SLOT/tier name, detail.model the concrete model behind it and detail.vendor its vendor; emitted only when the slot CHANGES, so read the per-turn `model` for the model of any given call rather than assuming the nearest event still applies), interaction.requested/resolved (blocking user widgets — explain quiet gaps; note that when a sub-agent opens a widget, detail.agent — and the agentName on the interaction message — is the HOST agent that owns the widget, NOT the sub-agent that asked, because widgets render and resolve on the host driver; detail.ownerPath names the agents that actually asked, outermost first, the last being the one whose tool requested it, and detail.heldBy says who held it when it opened: user, or the id of the interceptor that claimed it, such as autopilot; on interaction.resolved, detail.answeredBy is who answered — the claimant id when it settled through its own hold, user for any other answer (a click counts as the person even on a widget a claimant held) — absent when it closed unanswered (a timeout or a stop), and absent too when it settled by itself other than through the hold of a claimant — a widget registered resolvesItself (one that does its work and settles on its own, asking the person nothing, such as a generation run), or one outcome its controller said settled itself (ctx.resolve with resolvedItself, such as a generation phase that failed outright before its review gate ever asked anything) — which then carries detail.resolvedItself: true instead, as the interaction message does — nobody answered it, and the platform cannot tell it finishing from the person interrupting it (a Skip), so only the result of the widget itself can say which; the same value is stamped on the interaction message as answeredBy and on the result the asking tool handler receives (absent there in the same cases), and when it is not user the tool result that interaction returned carries a decidedOnUsersBehalf record, so the model was told the choice was not made by the person; detail.edits, present only when non-zero, counts the editing actions a claimant ran on the widget before it was settled, whoever settled it, and those edits are stamped on the interaction message as edits, each with by, action, choice and args when it had some, in the order they ran, while a decidedOnUsersBehalf record carries their choice texts as edits, and when the person settled it after such edits the tool result carries an editedOnUsersBehalf record instead — the framing and those choice texts — so the model knows the widget was changed on the user behalf before the user answered, and that the user then confirmed it by finishing it), interaction.held (a claimant moved a pending interaction to the person or back to itself — detail.heldBy is the new holder, detail.claimant the interceptor; detail.late: true is an interceptor that declined it when it opened claiming it afterwards, such as the autopilot resumed while it was open; a widget held by anything but user was not answered by the person), interaction.claim-refused (a claim on a userOnly interaction, which stays with the person — detail.claimant + reason), autopilot.* (the autopilot, a decorator that answers interactions on behalf of the user — autopilot.claimed / autopilot.declined say whether it took each interaction and, for a decline, detail.reason: paused, other-flow, no-autopilot, unavailable, userOnly, policy or no-controller; one declined as paused that is still open when the person resumes the autopilot is looked at again, and the autopilot.claimed or autopilot.declined recorded for it then carries detail.onResume: true (a decline then can also be claimed-elsewhere, another interceptor having claimed it first); a restored mode looks at nothing; autopilot.decision-sent is what it was sent (detail.chars; detail.nothingEnabled: true when every action on the widget was unavailable — a gate whose controller said it was asking, such as a failed build the autopilot may not cancel — so it could only hand it back, which it may then do even after the person asked it to decide it itself; a widget whose controller says it is working (ctx.setWorking) is never sent a decision until it says it is asking, even when an action is enabled or the person resumes the autopilot); autopilot.acted is what it did (detail.action, detail.note, detail.finished); autopilot.handed-back is a decision it gave to the person (detail.reason and detail.trigger: model, no-decision or error); autopilot.paused / autopilot.resumed are mode changes (detail.scope, detail.trigger, detail.decideYourself when the person resumed during a hand-back; detail.trigger is restored when the mode came back with the session after a reload, applied once its flow re-activated, which starts nothing by itself); autopilot.error is the wrapper itself failing; autopilot.refinement counts a refining action against its step — a written answer (reply) or a widget action declared refines, such as a regenerate with instructions, counted together (detail.action, detail.stepKey, detail.count, detail.limitReached, after which every refining action is withdrawn for that step: not listed, and refused; the decision and every relisting of its actions say how many are left at the step, as a line Refinements left at this step: N, wherever the widget has a refining action); autopilot.handback-presented is the turn-level hand-back, shown when a working turn ended needing the person with no widget to hand over (detail.why: max-iterations, context-exhausted, failure or question; detail.options; detail.choice once answered); autopilot.catch-up is the autopilot being given the whole visible transcript at once (detail.why: first, for its first decision in a flow or after a reload; size, when its own history passed its budget and was rebuilt short — detail.ownChars; or compacted, when a compaction removed the last message it had seen, so it reads the summary and everything since, short; in each, what it had sent on the user behalf is included and labelled as its own, since its own history does not hold it); autopilot.cost-dropped is autopilot spend that no message carries, so it is NOT in the session total (detail.costUsd and detail.why: handed-back, aborted or stale for a written question it answered that no reply was sent for — stale when a pause, a resume, a new turn or the end of its flow came before the answer landed, which then went nowhere — or no-recorder when the driver had no way to book a decision to its interaction); a hand-back trigger can also be budget (the decision passed its spend cap), watchdog (its work went quiet: no ready surface and no heartbeat, or its own decision stalled with no model call landing, which stops that decision) or detached (the autopilot was removed while it held the interaction, which went to the person with no reason shown). To debug one autopilot decision, follow its interactionId: interaction.requested (heldBy), autopilot.claimed, autopilot.decision-sent, autopilot.acted or autopilot.handed-back, interaction.invoked, interaction.resolved (answeredBy), then the next turn of the working agent), interaction.invoked (a claimant ran one of the actions the widget itself exposes, through its hold, the same code the button runs — detail.claimant, detail.action (an option id, select or reply) and detail.finished, whether that settled the interaction, and when it did not, the run is recorded as an edit; the choice and narration it recorded reach the result of the tool that asked as decidedOnUsersBehalf), interaction.step (a long action run as named steps through runSteps, which survive a reload — detail.step and detail.outcome: started, done, skipped when the step was already done before a reload, or resumed when it started before a reload and runs again with what it saved part-way, such as a job id it re-attaches to), interaction.checkpoint (the checkpoints a conversation keeps for its long actions: the one in flight, and each one a reload cut, held apart until a request of its own widget type takes it over, so a resumed flow that opens other long widgets first, which save their own, loses nothing — detail.action: resumed when a reload cut the work and a request of the same widget type that the registration sameWork agrees is the same work took it over, refused when sameWork said a new request is different work (detail.saved is the identity it kept; detail.kept: true, since it stays for a later request of that type, and is offered to every one until one agrees) or when runSteps found the handed-over checkpoint malformed and started fresh (detail.reason, detail.saved), or cleared when its flow ended, once per checkpoint, with detail.cut: true for one a reload cut that nothing took over), context.updated/threshold-crossed (token + cost), context.condensed (a stale tool payload was collapsed out of the model-bound history by a `condenseWhen` declaration on the tool — detail.tool + toolCallId, target args|response, trigger (superseded:<key> or age:<n>), stubLen, and an estimated tokensSaved; stored history and this log keep the FULL payload, so the model-visible slice at any point is the full history minus the condensations recorded up to then), panel.toggled, attachment.added, file.read-failed, suggestions.failed.',\n  'Sub-agent meta events: a sub-agent\\'s own turn.retry/turn.error/tool.failed/tool.unresolved events are merged into this same timeline, tagged with `detail.subAgent` — a `\"<parent> › <sub-agent>\"` breadcrumb that composes when nested (e.g. `\"UI Builder › Planner › Grounding\"`) — and interleaved by their original timestamps within the subagent.started→completed/failed bracket. These are the per-attempt/per-failure signals that do NOT appear among the sub-agent\\'s (hoisted) messages: a malformed/empty attempt that gets retried produces no message, and the stale-vs-hallucinated split and streak counts live only on the event. A sub-agent\\'s high-volume, message-derivable events (turn.start/turn.end, provider.selected, context.updated) are intentionally NOT merged — read its hoisted messages for model/tokens/cost and turn-by-turn activity, and the bracketing subagent.* events for the run\\'s span.',\n  \"`meta` holds context captured at export time: agentSummary (full agent configs), context (active model, contextTokens/contextLimit/contextUsagePercent for the last call, and the session totals — sessionCostUsd, sessionTokensConsumed, and the four-bucket sessionUsage lifted to the top of this log), activeDebugSnapshot (the active agent's `getDebugSnapshot()` taken fresh at export — reflects state NOW, which may have advanced beyond the last turn's agentSnapshot), debug (optional host-supplied debug state), host, and the export timestamp.\",\n  'Note the two different scopes in `meta.context`: `contextTokens` is the prompt size of the LAST call (against `contextLimit`, the model context window), while `sessionUsage`/`sessionTokensConsumed` are cumulative BILLED throughput. Every turn resends the conversation, so the cumulative figure counts each turn’s prompt again in the next turn’s and is expected to dwarf the context size — that is not double-counting.',\n  \"kind:'event' type 'routing.decided' — how ONE user turn was routed, emitted by the orchestrating driver before the agent runs. Only a user turn is routed: a hand-off names its target, so the agents a hand-off runs show up as agent.handoff events, not as more routing.decided. `decision` is why that agent was chosen: 'classified' (the classifier ran and picked one), 'no-match' (it ran and answered -1 — nothing listed covers the request), 'pinned' (a user pin, an agent named for that one message by the send's `agent` option, or an active stateful flow owned the turn, so no call was made), 'single-candidate'/'no-specialists' (configuration left nothing to decide), 'provider-unavailable' (the registry default exposes no chat()), 'classifier-failed' (every attempt threw — `error` carries the last one). `to` names the agent and `fallback` says whether that agent is the fallback. `candidates` is what was ON THE BALLOT — every classifier-eligible specialist — in ballot order, so `index` — the classifier's own answer — indexes it directly. `candidates` is absent on the three decisions that put nothing to a vote — 'pinned', 'single-candidate', 'no-specialists'. It IS present on 'provider-unavailable', which is not an exception worth removing: the ballot was built there, it simply never got sent. `attempts` covers the retry ladder. `durationMs` is on EVERY routing.decided, and is the field to read when a decision looks wrong: the decisions that can reach the fallback ('no-match', 'no-specialists', 'provider-unavailable', 'classifier-failed') are told apart by the clock as much as by their name, because a fallback routing that resolved in tens of milliseconds made no network call at all whatever its `decision` says.\",\n  \"kind:'event' type 'routing.decided'.`usage` — what that classifier call cost, in the same four-bucket + costUsd shape as `sessionUsage`, plus `model`. Absent on the decisions that make no call (see 'pinned' and the configuration ones). THIS SPEND IS NOT IN `sessionUsage`: a classifier call never enters the transcript and `sessionUsage` is derived from the transcript, so classifier cost is missing from the session total by construction, not by accident. Sum these events to close that gap — it is the one component of a session's real spend that the totals cannot see.\",\n  'To debug a failure: find the last turn.error or tool.failed, then read upward for the user message, the turn(s), and the agent/provider/state events that led into it. For a turn that went to the wrong agent, read its routing.decided first — `decision` says whether anything was actually asked.',\n]",
+          "default": "[\n  'This is an exported debug log for the Genesis AI assistant. Read it top-to-bottom.',\n  \"`sessionUsage` is what this session spent: `costUsd` (USD, provider-reported per request and summed, cache discounts already applied) plus the four TOKEN BUCKETS — `uncachedInputTokens`, `cacheReadTokens`, `cacheWriteTokens`, `outputTokens`. Those four are disjoint and safe to add up for a total-tokens figure; the per-message fields further down are NOT (see kind:'message'). Each bucket bills at a different rate — cache reads a fraction of uncached input, cache writes a premium, output highest — so a big token count against a small cost means the prompt was mostly cache hits, not a missing charge. It covers sub-agent turns and spend a compaction banked, so for the CONVERSATION it is the authoritative total: prefer it over re-summing the timeline, which can be short by whatever the ring buffers evicted. The same figures appear under `meta.context`. It is as current as the snapshot it came from: the assistant's own download stamps a fresh one, but a log stitched by another tool can carry an older one — compare `meta.timestamp` with the last timeline entry, and if it is well behind, read these totals as historical and fall back to summing the timeline. One scope caveat: it is derived from the transcript, so it excludes billed calls that produced no message (a blank or refused attempt that was retried — see kind:'turn'.`usage`). Summing the turns can therefore come out HIGHER than this, and the difference is exactly that discarded spend, not a double-count.\",\n  \"What 'session' means for those figures: the CURRENT conversation under this session key (a host-supplied per-project id, or the element id + header title when the host supplies none) — which is not necessarily everything in `timeline`. It is re-derived from the live transcript, so it spans page loads only when the chat is being remembered, and a Clear resets it to zero. `timeline` is append-only regardless: it keeps every page load and the pre-Clear conversation, with the session.cleared event as the boundary. So on a long-lived log, read these totals as the latest conversation's and the earlier sections as history — not as a total of the whole file.\",\n  '`timeline` is the entire session as one array, already sorted chronologically by `timestamp` (ISO 8601). Every entry has a `kind`.',\n  'Timestamps are millisecond-resolution; entries that share the same millisecond are ordered by a fixed kind rank (event, then turn, then message), which is a heuristic and may not reflect exact causal order within that millisecond — e.g. a user message and the turn it triggered, or a final assistant message and its turn.end event, can appear in either order depending on whether they landed in the same millisecond. Read the logical structure of a turn rather than over-interpreting the micro-ordering of co-timestamped entries of different kinds.',\n  \"kind:'message' — the conversation. `role` is user/assistant/tool/system-event/synthetic-user; `agentName` says which agent produced it; `toolCalls`/`toolResult`/`interaction` carry tool and widget activity; `inputTokens`/`outputTokens`/`cost` are per-message LLM usage, where `inputTokens` is the WHOLE prompt for that request and `cacheReadTokens`/`cacheWriteTokens` BREAK IT DOWN rather than add to it — uncached input is `inputTokens` minus those two, and adding the cache fields to `inputTokens` counts the prompt twice. The cache fields are absent on providers that report no cache split (Gemini reports reads only, since implicit caching bills no write) and on messages persisted before they existed, so read them as 0 when missing. Each bucket bills at a different rate — cache reads a fraction of uncached input, cache writes a premium, output highest — so a large token count at a small cost means the prompt was mostly cache hits. `externalCostUsd` is any non-LLM cost a widget reported for its own external service calls (folded into the session cost total alongside `cost`). On model-produced assistant messages, `model` is the concrete model id that generated it (e.g. 'gemini-2.5-flash-lite') and `providerName` is the registry slot it resolved under (e.g. a tier name like 'high'/'low', or the default); together they attribute the message — and any tool calls it carries — to an exact model even across a mid-session vendor/tier switch, where one slot name can map to different models before and after the switch. Both are undefined on any entry that is NOT an LLM response: non-assistant roles (user/tool/system-event) and 'synthetic-user' echoes; assistant interaction/widget entries (empty content carrying an `interaction` — a rendered widget, not a model turn); driver-authored assistant fallbacks (the timeout, repeated-malformed-call, and empty-response apology messages); and messages restored from a session persisted before these fields existed. One partial case: on a genuine model turn whose provider exposes no `getStatus` (or reports no model), `providerName` is still set but `model` alone is undefined. A 'synthetic-user' message is a display-only echo of an interaction outcome (e.g. the answer a widget reported): it renders on the user's side of the chat and `agentName` is the agent that created it, but it is never sent to the LLM — so it has no matching 'turn' and the model learns the outcome only from the corresponding tool result. An echo of an answer an interceptor (such as an autopilot) gave is NOT synthetic-user: see the delegated-messages paragraph.\",\n  'The autopilot (GENC-1660) runs on a driver of its own, and everything it did is harvested into this log: entries with delegate: autopilot and an agentName ending in › Autopilot are its turns (the decision message it was sent is the user message of its turn, so what it was shown is there verbatim; its systemPrompt is its grounding, such as the brief), its tool calls (widget_read, widget_act, hand_back, any read-only tools of its own, and its widget tools — reads with parameters that a widget type declares, routed to the interaction of that type being decided and refused with a reason when none is, offered on every decision so its tool list never changes; while one is open its tail starts with a line naming them) and their results (a read, view or widget tool, is capped at about 20,000 characters, cut with a note asking for less, and leaves its history at the end of the decision as a one-line note), and its own events. Its cost is already in the session total: it is booked as externalCostUsd on the interaction each decision answered, or, for a written question it answered, on the user message it sent on the user behalf (delegate: autopilot), so do not add its turns to that total. Spend that reached no message is recorded as autopilot.cost-dropped instead.',\n  \"Delegated messages (GENC-1660): a message with a `delegate` field was written or sent ON THE USER'S BEHALF by a driver decorator, and `delegate` names it (e.g. autopilot). The platform stamps it; nothing else can. It renders as the assistant whatever its role. A delegated `user` message was NOT typed by the user: it is an answer given on their behalf, and the model read it with `delegateFraming` in brackets in front of the content (the stored `content` is the bare text). A delegated `assistant` message is display-only (`excludeFromProvider`): the decorator's narration note, or, when its answer carried no note, the widget's own echo of the answer (its `userMessage`), shown as the assistant and never as the person. A widget answer a decorator gave with a note is not echoed at all: the note already says what was chosen. To tell what the person decided from what was decided for them, read `interaction.answeredBy` and these fields, never the role alone.\",\n  \"Sub-agent messages appear inline. When a tool delegates to a sub-agent (via `requestSubAgent`), the sub-agent's whole conversation — its own assistant/tool messages, each with their own `content`/`thinking`/`toolCalls`/`toolResult` and per-message `model`/`providerName`/`inputTokens`/`outputTokens`/`cacheReadTokens`/`cacheWriteTokens`/`cost` — is hoisted into the timeline as ordinary kind:'message' entries, interleaved by timestamp right after the tool call that spawned them (so you read the delegation top-to-bottom). A hoisted entry is marked: `subAgentDepth` is its delegation depth (1 for a sub-agent, 2 for a sub-agent's sub-agent, …), `subAgentOf` is the id of the parent tool call that spawned it (correlates it back even when two sub-agents run in one parent turn), `subAgentName` is the sub-agent's own name, and `agentName` is rewritten to a `\\\"<parent> › <sub-agent>\\\"` breadcrumb (composing when nested, e.g. `\\\"UI Builder › Planner › Grounding\\\"`). The sub-agent's per-LLM-call snapshots also surface as kind:'turn' entries with an N-M `turnIndex`, and subagent.started/completed (or subagent.failed) events bracket the run. Per-message `cost` on hoisted entries is already part of the session total (it is summed from the un-flattened history), so summing the top-level timeline does NOT double-count.\",\n  \"kind:'turn' — one LLM call. `turnIndex` is a string: a top-level turn is the bare counter ('0', '1', …); a sub-agent's turns are numbered under the parent turn that activated them ('3-1', '3-2', …, and a nested sub-agent contributes '3-2-1', …), and `agentName` names the agent that ran the turn. `systemPrompt` and `toolNames` are what the model saw. A systemPrompt of '<repeated — identical to turn N>' was byte-identical to turn N and de-duplicated; the full prompt is shown whenever it changes (often because a stateful agent advanced), so prompt evolution is visible.\",\n  \"kind:'turn'.`model`/`providerName`/`provider` — which model ran that call: the concrete model id, the registry slot it resolved under (a tier name like 'high'/'low', or the default), and the vendor. Recorded per CALL, so an agent whose `provider` selector varies by state — a flow that plans on a high tier and executes on a low one — has every step attributed, including calls that produced no message. `model` is the SERVING model where the provider reports one, so a turn answered by a server-side fallback names the model that answered rather than the one requested; it always matches the `model` on the message that call produced. Absent when the provider exposes no `getStatus` and the transport stamped nothing.\",\n  \"kind:'turn'.`usage` — what that ONE call cost, in the same four-bucket + `costUsd` shape as `sessionUsage`. Absent while a call is in flight and on providers that report no usage. This is the SAME money as the message the call produced, not extra money: never add turn usage to message usage, and read a turn plus its message as one charge. Its distinct value is the calls that produced NO message — a blank or refused response is billed and then discarded before the retry, so the turn entry is the only record of that spend, and a turn with `usage` but no message after it is exactly that. `costUsd: 0` alongside a nonzero token count means the provider reported no price, not that the call was free.\",\n  \"kind:'turn'.`agentSnapshot` — the active agent's own view of its internal state, captured at that turn. An agent opts into this by exposing a `getDebugSnapshot()` that returns JSON-serializable per-state info; stateful/flow agents wire it automatically, so you can watch a flow advance turn-by-turn (e.g. current step, cursor, collected fields, pending changes). Absent for agents that don't expose one.\",\n  \"kind:'event' — a meta/lifecycle event. `type` names it (see below); `detail` carries structured data. `detail.placement` is the emitting UI instance: 'bubble' (collapsed), 'panel' (popped-out), or 'standalone'.\",\n  \"Each 'event' also has an `importance`: 'high' (failures/limits — turn.error, tool.failed, subagent.failed, file.read-failed, suggestions.failed, context.threshold-crossed), 'normal' (session flow — connects, turns, retries, handoffs, agent/provider changes, interactions, sub-agent start/complete), or 'low' (skippable UI/bookkeeping noise — panel.toggled, attachment.added, driver.wired/unwired, context.updated, context.condensed). To skim, ignore importance:'low'; to triage a failure, filter to importance:'high' then read the nearby messages and turns. A 'high' turn.error is often preceded by one or more 'normal' turn.retry events for the same reason — read them together to see how many attempts were made before bailing. 'message' and 'turn' entries carry no importance — they are the substance, always read them.\",\n  'Event types: assistant.connected/disconnected (mount + placement + whether the session was created or restored), assistant.popout/popin (window placement), driver.created/wired/unwired (which driver is live and why it stops/starts responding across a popout), state.changed (idle↔loading), turn.start/turn.end (turn boundary; turn.end carries durationMs), turn.retry (a recoverable in-turn retry — detail.reason plus attempt/maxAttempts; for malformed calls also finishMessage; for empty responses also the provider finishReason + thoughtsTokens + parts breakdown), turn.error (a turn failed or hit a guardrail — detail.reason is one of exception/malformed-function-call/empty-response/unknown-tool-limit/max-iterations/response-truncated/refusal/budget-exhausted/provider-refused/context-exhausted/ai-service-error, plus reason-specific diagnostics: attempts (for empty-response also finishReason + thoughtsTokens + a parts breakdown, distinguishing a thinking-only STOP from a truly empty turn), finishMessage, for response-truncated the model + maxTokens + outputTokens + tools, unknownTools (split into staleTools — real earlier this activation but retired by the current state or hidden behind an open exclusive fold — and hallucinatedTools — never advertised) + availableTools, iterations + limit, for budget-exhausted the budgetUsd + spentUsd figures reported by the proxy plus the resolved vendor, for provider-refused the kind (spend|auth) plus the upstream status and error type — the vendor refusing the ACCOUNT rather than us refusing to spend, so the remedy is a top-up or a key rotation rather than a raised cap, and the kind is the only place that distinction survives because the user-facing copy is deliberately cause-free, for context-exhausted the estimated contextTokens against the guard that stopped the turn plus the iterations reached — the driver ending a runaway tool loop at the edge of the context window rather than issuing a request the provider would reject, so the transcript survives intact and can still be compacted, for ai-service-error the code (one of AI_SERVICE_ERROR_CODES, e.g. NO_API_KEY) and the status the AI service answered with — its own text goes to the browser console only, or name + message for exceptions), tool.failed (a tool threw), tool.unresolved (the model called a tool that could not be dispatched — detail.kind is folded/fold-hidden/stale/unknown, plus tool + agent and, for the counted kinds, the consecutive streak; the recurring lead-up to an unknown-tool-limit turn.error), subagent.started/completed/failed (the lifecycle of a `requestSubAgent` delegation — detail.agent names the sub-agent; these bracket the sub-agent turns that appear as kind:turn entries with an N-M `turnIndex`; subagent.failed also carries detail.reason, one of max_iterations/malformed_tool_call/empty_response/unknown_tool_limit/timeout/response_truncated/refusal/budget_exhausted/provider_refused/context_exhausted/ai_service_error; budget_exhausted and provider_refused are terminal for the PARENT turn too, and so is ai_service_error when the refusal is about the service rather than the request and came from the vendor the parent calls — the parent stops rather than calling the model again into the same wall; after context_exhausted the parent goes on, but its own next call is likely to stop on the same guard), agent.handoff (routing; from=null is the initial activation), agent.pinned/unpinned (forced routing), routing.decided (ONE PER ROUTING DECISION — see its own paragraph below), provider.selected (the resolved provider for the upcoming turns — detail.provider is the registry SLOT/tier name, detail.model the concrete model behind it and detail.vendor its vendor; emitted only when the slot CHANGES, so read the per-turn `model` for the model of any given call rather than assuming the nearest event still applies), interaction.requested/resolved (blocking user widgets — explain quiet gaps; note that when a sub-agent opens a widget, detail.agent — and the agentName on the interaction message — is the HOST agent that owns the widget, NOT the sub-agent that asked, because widgets render and resolve on the host driver; detail.ownerPath names the agents that actually asked, outermost first, the last being the one whose tool requested it, and detail.heldBy says who held it when it opened: user, or the id of the interceptor that claimed it, such as autopilot; on interaction.resolved, detail.answeredBy is who answered — the claimant id when it settled through its own hold, user for any other answer (a click counts as the person even on a widget a claimant held) — absent when it closed unanswered (a timeout or a stop), and absent too when it settled by itself other than through the hold of a claimant — a widget registered resolvesItself (one that does its work and settles on its own, asking the person nothing, such as a generation run), or one outcome its controller said settled itself (ctx.resolve with resolvedItself, such as a generation phase that failed outright before its review gate ever asked anything) — which then carries detail.resolvedItself: true instead, as the interaction message does — nobody answered it, and the platform cannot tell it finishing from the person interrupting it (a Skip), so only the result of the widget itself can say which; the same value is stamped on the interaction message as answeredBy and on the result the asking tool handler receives (absent there in the same cases), and when it is not user the tool result that interaction returned carries a decidedOnUsersBehalf record, so the model was told the choice was not made by the person; detail.edits, present only when non-zero, counts the editing actions a claimant ran on the widget before it was settled, whoever settled it, and those edits are stamped on the interaction message as edits, each with by, action, choice and args when it had some, in the order they ran, while a decidedOnUsersBehalf record carries their choice texts as edits, and when the person settled it after such edits the tool result carries an editedOnUsersBehalf record instead — the framing and those choice texts — so the model knows the widget was changed on the user behalf before the user answered, and that the user then confirmed it by finishing it), interaction.held (a claimant moved a pending interaction to the person or back to itself — detail.heldBy is the new holder, detail.claimant the interceptor; detail.late: true is an interceptor that declined it when it opened claiming it afterwards, such as the autopilot resumed while it was open; a widget held by anything but user was not answered by the person), interaction.claim-refused (a claim on a userOnly interaction, which stays with the person — detail.claimant + reason), autopilot.* (the autopilot, a decorator that answers interactions on behalf of the user — autopilot.claimed / autopilot.declined say whether it took each interaction and, for a decline, detail.reason: paused, other-flow, no-autopilot, unavailable, userOnly, policy or no-controller; one declined as paused that is still open when the person resumes the autopilot is looked at again, and the autopilot.claimed or autopilot.declined recorded for it then carries detail.onResume: true (a decline then can also be claimed-elsewhere, another interceptor having claimed it first); a restored mode looks at nothing; autopilot.decision-sent is what it was sent (detail.chars; detail.nothingEnabled: true when every action on the widget was unavailable — a gate whose controller said it was asking, such as a failed build the autopilot may not cancel — so it could only hand it back, which it may then do even after the person asked it to decide it itself; a widget whose controller says it is working (ctx.setWorking) is never sent a decision until it says it is asking, even when an action is enabled or the person resumes the autopilot); autopilot.acted is what it did (detail.action, detail.note, detail.finished); autopilot.handed-back is a decision it gave to the person (detail.reason and detail.trigger: model, no-decision or error); autopilot.paused / autopilot.resumed are mode changes (detail.scope, detail.trigger, detail.decideYourself when the person resumed during a hand-back; detail.trigger is restored when the mode came back with the session after a reload, applied once its flow re-activated, which starts nothing by itself); autopilot.carried is the mode, running or paused, going with the task to the agent that took it over, rather than ending with the flow as on any other change of flow owner: to the target of a hand-off, or back to its caller on the hand-back (detail.from, detail.to, detail.mode); a pause the person chose goes with it, and Stop and Clear still end it; a mode restored for the target of a hand-off applies to its caller when the reload hands back; autopilot.error is the wrapper itself failing; autopilot.refinement counts a refining action against its step — a written answer (reply) or a widget action declared refines, such as a regenerate with instructions, counted together (detail.action, detail.stepKey, detail.count, detail.limitReached, after which every refining action is withdrawn for that step: not listed, and refused; the decision and every relisting of its actions say how many are left at the step, as a line Refinements left at this step: N, wherever the widget has a refining action); autopilot.handback-presented is the turn-level hand-back, shown when a working turn ended needing the person with no widget to hand over (detail.why: max-iterations, context-exhausted, failure or question; detail.options; detail.choice once answered); autopilot.catch-up is the autopilot being given the whole visible transcript at once (detail.why: first, for its first decision in a flow or after a reload; size, when its own history passed its budget and was rebuilt short — detail.ownChars; or compacted, when a compaction removed the last message it had seen, so it reads the summary and everything since, short; in each, what it had sent on the user behalf is included and labelled as its own, since its own history does not hold it); autopilot.cost-dropped is autopilot spend that no message carries, so it is NOT in the session total (detail.costUsd and detail.why: handed-back, aborted or stale for a written question it answered that no reply was sent for — stale when a pause, a resume, a new turn or the end of its flow came before the answer landed, which then went nowhere — or no-recorder when the driver had no way to book a decision to its interaction); a hand-back trigger can also be budget (the decision passed its spend cap), watchdog (its work went quiet: no ready surface and no heartbeat, or its own decision stalled with no model call landing, which stops that decision) or detached (the autopilot was removed while it held the interaction, which went to the person with no reason shown). To debug one autopilot decision, follow its interactionId: interaction.requested (heldBy), autopilot.claimed, autopilot.decision-sent, autopilot.acted or autopilot.handed-back, interaction.invoked, interaction.resolved (answeredBy), then the next turn of the working agent), interaction.invoked (a claimant ran one of the actions the widget itself exposes, through its hold, the same code the button runs — detail.claimant, detail.action (an option id, select or reply) and detail.finished, whether that settled the interaction, and when it did not, the run is recorded as an edit; the choice and narration it recorded reach the result of the tool that asked as decidedOnUsersBehalf), interaction.step (a long action run as named steps through runSteps, which survive a reload — detail.step and detail.outcome: started, done, skipped when the step was already done before a reload, or resumed when it started before a reload and runs again with what it saved part-way, such as a job id it re-attaches to), interaction.checkpoint (the checkpoints a conversation keeps for its long actions: the one in flight, and each one a reload cut, held apart until a request of its own widget type takes it over, so a resumed flow that opens other long widgets first, which save their own, loses nothing — detail.action: resumed when a reload cut the work and a request of the same widget type that the registration sameWork agrees is the same work took it over, refused when sameWork said a new request is different work (detail.saved is the identity it kept; detail.kept: true, since it stays for a later request of that type, and is offered to every one until one agrees) or when runSteps found the handed-over checkpoint malformed and started fresh (detail.reason, detail.saved), or cleared when its flow ended, once per checkpoint, with detail.cut: true for one a reload cut that nothing took over), context.updated/threshold-crossed (token + cost), context.condensed (a stale tool payload was collapsed out of the model-bound history by a `condenseWhen` declaration on the tool — detail.tool + toolCallId, target args|response, trigger (superseded:<key> or age:<n>), stubLen, and an estimated tokensSaved; stored history and this log keep the FULL payload, so the model-visible slice at any point is the full history minus the condensations recorded up to then), panel.toggled, attachment.added, file.read-failed, suggestions.failed.',\n  'Sub-agent meta events: a sub-agent\\'s own turn.retry/turn.error/tool.failed/tool.unresolved events are merged into this same timeline, tagged with `detail.subAgent` — a `\"<parent> › <sub-agent>\"` breadcrumb that composes when nested (e.g. `\"UI Builder › Planner › Grounding\"`) — and interleaved by their original timestamps within the subagent.started→completed/failed bracket. These are the per-attempt/per-failure signals that do NOT appear among the sub-agent\\'s (hoisted) messages: a malformed/empty attempt that gets retried produces no message, and the stale-vs-hallucinated split and streak counts live only on the event. A sub-agent\\'s high-volume, message-derivable events (turn.start/turn.end, provider.selected, context.updated) are intentionally NOT merged — read its hoisted messages for model/tokens/cost and turn-by-turn activity, and the bracketing subagent.* events for the run\\'s span.',\n  \"`meta` holds context captured at export time: agentSummary (full agent configs), context (active model, contextTokens/contextLimit/contextUsagePercent for the last call, and the session totals — sessionCostUsd, sessionTokensConsumed, and the four-bucket sessionUsage lifted to the top of this log), activeDebugSnapshot (the active agent's `getDebugSnapshot()` taken fresh at export — reflects state NOW, which may have advanced beyond the last turn's agentSnapshot), debug (optional host-supplied debug state), host, and the export timestamp.\",\n  'Note the two different scopes in `meta.context`: `contextTokens` is the prompt size of the LAST call (against `contextLimit`, the model context window), while `sessionUsage`/`sessionTokensConsumed` are cumulative BILLED throughput. Every turn resends the conversation, so the cumulative figure counts each turn’s prompt again in the next turn’s and is expected to dwarf the context size — that is not double-counting.',\n  \"kind:'event' type 'routing.decided' — how ONE user turn was routed, emitted by the orchestrating driver before the agent runs. Only a user turn is routed: a hand-off names its target, so the agents a hand-off runs show up as agent.handoff events, not as more routing.decided. `decision` is why that agent was chosen: 'classified' (the classifier ran and picked one), 'no-match' (it ran and answered -1 — nothing listed covers the request), 'pinned' (a user pin, an agent named for that one message by the send's `agent` option, or an active stateful flow owned the turn, so no call was made), 'single-candidate'/'no-specialists' (configuration left nothing to decide), 'provider-unavailable' (the registry default exposes no chat()), 'classifier-failed' (every attempt threw — `error` carries the last one). `to` names the agent and `fallback` says whether that agent is the fallback. `candidates` is what was ON THE BALLOT — every classifier-eligible specialist — in ballot order, so `index` — the classifier's own answer — indexes it directly. `candidates` is absent on the three decisions that put nothing to a vote — 'pinned', 'single-candidate', 'no-specialists'. It IS present on 'provider-unavailable', which is not an exception worth removing: the ballot was built there, it simply never got sent. `attempts` covers the retry ladder. `durationMs` is on EVERY routing.decided, and is the field to read when a decision looks wrong: the decisions that can reach the fallback ('no-match', 'no-specialists', 'provider-unavailable', 'classifier-failed') are told apart by the clock as much as by their name, because a fallback routing that resolved in tens of milliseconds made no network call at all whatever its `decision` says.\",\n  \"kind:'event' type 'routing.decided'.`usage` — what that classifier call cost, in the same four-bucket + costUsd shape as `sessionUsage`, plus `model`. Absent on the decisions that make no call (see 'pinned' and the configuration ones). THIS SPEND IS NOT IN `sessionUsage`: a classifier call never enters the transcript and `sessionUsage` is derived from the transcript, so classifier cost is missing from the session total by construction, not by accident. Sum these events to close that gap — it is the one component of a session's real spend that the totals cannot see.\",\n  'To debug a failure: find the last turn.error or tool.failed, then read upward for the user message, the turn(s), and the agent/provider/state events that led into it. For a turn that went to the wrong agent, read its routing.decided first — `decision` says whether anything was actually asked.',\n]",
           "description": "Human/agent-facing guide emitted as the first key of the exported debug log,\nso whoever opens the JSON (often an AI agent) knows how to read it without\nreverse-engineering the shape. Kept here next to the event catalogue it\ndescribes — but proximity alone demonstrably did NOT keep the two in sync\n(`refusal` was missing from both reason lists for a whole release), so\n`debug-event-log.test.ts` now asserts that every `TurnFailureReason` and every\n`SubAgentFailureReason` is named here, and fails the build when one is added\nwithout a matching sentence. Enumerations below read as exhaustive and WILL be\ntrusted by an agent reading the JSON — keep them so."
         }
       ],
@@ -17566,11 +17714,12 @@
             },
             {
               "kind": "field",
-              "name": "injectedCloseBtn",
+              "name": "closableAssistant",
               "type": {
                 "text": "Element | undefined"
               },
-              "privacy": "private"
+              "privacy": "private",
+              "description": "The assistant whose header Close button this bubble turned on, and listens to."
             },
             {
               "kind": "field",
@@ -17786,7 +17935,7 @@
             },
             {
               "kind": "method",
-              "name": "injectCloseButton",
+              "name": "showCloseButton",
               "privacy": "private",
               "parameters": [
                 {
@@ -17795,7 +17944,8 @@
                     "text": "Element"
                   }
                 }
-              ]
+              ],
+              "description": "The Close button is the assistant's own, rendered in its header beside the cog. It used to be\na design-system button injected into the assistant's light DOM, where the assistant's styles\ncould reach its host but not the padded control inside it, so it sat narrower than the cog\nand off its centre line, and every host carried a shim to square it up."
             },
             {
               "kind": "method",
@@ -25021,7 +25171,7 @@
         {
           "kind": "variable",
           "name": "WriteReviewStyles",
-          "default": "css`\n  :host {\n    display: block;\n    font: inherit;\n\n    /* The diff tints — see the diff rules below for why they are backgrounds only. */\n    --write-review-added: color-mix(in srgb, var(--success-fill-rest, #2da44e) 18%, transparent);\n    --write-review-removed: color-mix(in srgb, var(--error-fill-rest, #cf222e) 18%, transparent);\n  }\n\n  /*\n   * The review mounts inside the chat bubble's dialog content, which is overflow: hidden — so a\n   * wide event's columns were CLIPPED rather than pushed off screen, with no scrollbar to say\n   * anything was missing. A user approving values they cannot see is the failure this whole\n   * component exists to prevent, so the table scrolls within itself.\n   */\n  .scroller {\n    overflow-x: auto;\n    max-width: 100%;\n  }\n\n  table {\n    border-collapse: collapse;\n    width: 100%;\n  }\n\n  th,\n  td {\n    border-bottom: calc(var(--stroke-width, 1) * 1px) solid var(--neutral-stroke-rest);\n    padding: calc(var(--design-unit, 4) * 1px) calc(var(--design-unit, 4) * 2px);\n    text-align: left;\n  }\n\n  /* A heading is a column name: kept on one line. */\n  th {\n    white-space: nowrap;\n  }\n\n  /*\n   * A value is never clipped. Every character stays on screen.\n   *\n   * Clipping was the first bound, and the wrong one: 24ch with an ellipsis cut the END of every\n   * cell, which in a changed cell is the NEW value, so the user approved a value they never saw.\n   * No cell is safe to clip either. An insert has no pre-image, so none of its cells is\n   * \"changed\", and every one of them is a value being written; a delete's cells are the record\n   * being removed; and a title attribute holding the full text reaches nobody on a keyboard or a\n   * touch screen.\n   *\n   * A SHORT value stays whole on one line, and the table scrolls. Wrapping every cell broke a\n   * short value mid-token in a squeezed table — \"101.\" over \"2345\" — and the first line could\n   * pass for the whole value.\n   *\n   * A LONG value (review-model marks it) wraps within a bound. With no bound at all, one long\n   * value (a NOTE another user wrote) widened its column until the changed one sat out of view,\n   * behind a scrollbar an overlay-scrollbar platform does not draw until you scroll.\n   */\n  td {\n    white-space: nowrap;\n  }\n\n  td.long {\n    white-space: normal;\n    overflow-wrap: anywhere;\n\n    /*\n     * A floor as well as a ceiling. With only the ceiling, a squeezed table shrank a long value's\n     * column to a sliver (a 100-character note became 22 lines of a few characters each) while\n     * the one-line cells kept their width. The table scrolls instead.\n     */\n    min-width: 20ch;\n    max-width: 40ch;\n  }\n\n  /*\n   * The two marks this table carries — \"this field is changing\" and \"this field decides which\n   * record disappears\" — were weight, colour and a strike-through only. None of that reaches\n   * somebody using a screen reader, who is the one approver with no other way to tell, so each\n   * mark has words as well.\n   */\n  .sr-only {\n    position: absolute;\n    width: 1px;\n    height: 1px;\n    overflow: hidden;\n    clip-path: inset(50%);\n    white-space: nowrap;\n  }\n\n  /*\n   * A delete shows the whole record and sends its key alone, so the fields that actually decide\n   * which record disappears are marked. Not colour alone — an underline carries to a user who\n   * cannot distinguish it.\n   */\n  td.identifying {\n    font-weight: 600;\n    text-decoration: underline;\n  }\n\n  /*\n   * The diff, the way a code review shows one: what goes is tinted as removed and struck through,\n   * what comes in is tinted as added and bold. Only the BACKGROUND is tinted, at low alpha, from\n   * the theme's own success and error tokens (with fallbacks, as foundation-forms does), and the\n   * text keeps the normal foreground colour: coloured text on a coloured ground is where contrast\n   * fails, dark mode first. The tint is never the only signal. Strike-through, weight, the visible\n   * + and − marks and the spoken \"was\" and \"now\" all carry the same thing without colour.\n   */\n\n  /* The mark a user's eye needs: this field is being changed. */\n  td.changed {\n    font-weight: 600;\n  }\n\n  /* On its own line above the new value, so neither can push the other out of view. */\n  td.changed .was {\n    display: block;\n    font-weight: 400;\n    text-decoration: line-through;\n    background: var(--write-review-removed);\n  }\n\n  td.changed .now {\n    display: block;\n    background: var(--write-review-added);\n  }\n\n  /* Room inside the tint, so the − and + do not sit on its edge. */\n  td.changed .was,\n  td.changed .now {\n    padding-inline: calc(var(--design-unit, 4) * 1px);\n  }\n\n  /*\n   * A row that will not be written is never tinted, not even inside a cell. For a refused row\n   * review-model already gives it no changed cells, and this is the second guard. For a row the\n   * resolved review did not approve, the − and + stay as the record of what was proposed, but\n   * without the tint that says it will happen.\n   */\n  tr.refused td.changed .was,\n  tr.refused td.changed .now,\n  tr.unwritten td.changed .was,\n  tr.unwritten td.changed .now {\n    background: none;\n  }\n\n  /* A whole row coming in, or going. A refused row is neither, and keeps its muted look. */\n  tr.added td {\n    background: var(--write-review-added);\n  }\n\n  tr.removed td {\n    background: var(--write-review-removed);\n  }\n\n  /*\n   * A closed review's row that was not approved says so in words — without them, a denied modify\n   * read in greyscale or by a screen reader exactly like an approved one. An approved row says what\n   * came of it the same way, once the write tool has recorded that (written, not written\n   * because the user stopped, or its own reason).\n   */\n  .not-written,\n  .fate {\n    margin-inline-start: calc(var(--design-unit, 4) * 1.5px);\n    font-size: var(--type-ramp-minus-1-font-size, 0.875em);\n    color: var(--neutral-foreground-hint);\n  }\n\n  /*\n   * A row action's input is what its handler is given, not a change to the row, so it is labelled\n   * rather than marked as a diff. The label is text, so it reaches a screen reader as well.\n   */\n  .input-mark {\n    font-style: italic;\n    color: var(--neutral-foreground-hint);\n    padding-inline-end: calc(var(--design-unit, 4) * 1px);\n  }\n\n  .row-action p {\n    margin-block: calc(var(--design-unit, 4) * 1px);\n  }\n\n  /* The empty placeholder: a style no row text can take, so a literal \"(blank)\" cannot pass for it. */\n  .blank {\n    font-style: italic;\n    font-weight: 400;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .mark {\n    font-weight: 600;\n    padding-inline-end: calc(var(--design-unit, 4) * 1px);\n    user-select: none;\n  }\n\n  /* The row's + or − sits beside its checkbox, not on the baseline under it (where − reads as _). */\n  td.select {\n    white-space: nowrap;\n  }\n\n  td.select rapid-checkbox,\n  td.select .mark {\n    vertical-align: middle;\n  }\n\n  /* A gap from the checkbox, so the mark reads as the row's sign rather than part of the box. */\n  td.select .mark {\n    margin-inline-start: calc(var(--design-unit, 4) * 1.5px);\n  }\n\n  /* The strike-through belongs to the value, not to its − mark. */\n  td.changed .was .mark {\n    display: inline-block;\n    text-decoration: none;\n  }\n\n  tr.refused {\n    color: var(--neutral-foreground-hint);\n  }\n\n  /* A refusal is a sentence, and it spans the table: it wraps rather than running off it. */\n  .problems {\n    color: var(--error-fill-rest, #c00);\n    white-space: normal;\n  }\n\n  .actions {\n    display: flex;\n    gap: calc(var(--design-unit, 4) * 2px);\n    margin-top: calc(var(--design-unit, 4) * 2px);\n  }\n\n  /* The change request takes the width the buttons leave it. */\n  .change-request {\n    flex: 1 1 24ch;\n  }\n\n  /* The outcome's live region is always there; while the review is open it takes no room. */\n  .closed:empty {\n    margin: 0;\n  }\n\n  /* The count sits at the foot of the field, beside it rather than in its way. */\n  .remaining {\n    align-self: flex-end;\n    white-space: nowrap;\n    font-size: var(--type-ramp-minus-1-font-size, 0.875em);\n    color: var(--neutral-foreground-hint);\n  }\n`"
+          "default": "css`\n  :host {\n    display: block;\n    font: inherit;\n\n    /* The diff tints — see the diff rules below for why they are backgrounds only. */\n    --write-review-added: color-mix(in srgb, var(--success-fill-rest, #2da44e) 18%, transparent);\n    --write-review-removed: color-mix(in srgb, var(--error-fill-rest, #cf222e) 18%, transparent);\n  }\n\n  /*\n   * The review mounts inside the chat bubble's dialog content, which is overflow: hidden — so a\n   * wide event's columns were CLIPPED rather than pushed off screen, with no scrollbar to say\n   * anything was missing. A user approving values they cannot see is the failure this whole\n   * component exists to prevent, so the table scrolls within itself.\n   */\n  .scroller {\n    overflow-x: auto;\n    max-width: 100%;\n  }\n\n  table {\n    border-collapse: collapse;\n    width: 100%;\n  }\n\n  th,\n  td {\n    border-bottom: calc(var(--stroke-width, 1) * 1px) solid var(--neutral-stroke-rest);\n    padding: calc(var(--design-unit, 4) * 1px) calc(var(--design-unit, 4) * 2px);\n    text-align: left;\n  }\n\n  /* A heading is a column name: kept on one line. */\n  th {\n    white-space: nowrap;\n  }\n\n  /*\n   * A value is never clipped. Every character stays on screen.\n   *\n   * Clipping was the first bound, and the wrong one: 24ch with an ellipsis cut the END of every\n   * cell, which in a changed cell is the NEW value, so the user approved a value they never saw.\n   * No cell is safe to clip either. An insert has no pre-image, so none of its cells is\n   * \"changed\", and every one of them is a value being written; a delete's cells are the record\n   * being removed; and a title attribute holding the full text reaches nobody on a keyboard or a\n   * touch screen.\n   *\n   * A SHORT value stays whole on one line, and the table scrolls. Wrapping every cell broke a\n   * short value mid-token in a squeezed table — \"101.\" over \"2345\" — and the first line could\n   * pass for the whole value.\n   *\n   * A LONG value (review-model marks it) wraps within a bound. With no bound at all, one long\n   * value (a NOTE another user wrote) widened its column until the changed one sat out of view,\n   * behind a scrollbar an overlay-scrollbar platform does not draw until you scroll.\n   */\n  td {\n    white-space: nowrap;\n  }\n\n  td.long {\n    white-space: normal;\n    overflow-wrap: anywhere;\n\n    /*\n     * A floor as well as a ceiling. With only the ceiling, a squeezed table shrank a long value's\n     * column to a sliver (a 100-character note became 22 lines of a few characters each) while\n     * the one-line cells kept their width. The table scrolls instead.\n     */\n    min-width: 20ch;\n    max-width: 40ch;\n  }\n\n  /*\n   * Stacked: the table did not fit (see GenesisWriteReview.stacked), so each row becomes a block\n   * and each field a line of its own, its label beside its value, and nothing is off to the side.\n   * The headings go, as every value now carries its own; the select-all box stays, labelled.\n   */\n  .stacked table,\n  .stacked tbody,\n  .stacked tr,\n  .stacked td {\n    display: block;\n  }\n\n  .stacked thead tr {\n    display: flex;\n  }\n\n  .stacked thead th:not(.select) {\n    display: none;\n  }\n\n  .stacked thead th.select {\n    border-bottom: none;\n    font-weight: 400;\n  }\n\n  /* Without its column of row boxes beneath it, a lone box at the top says nothing on sight. Its\n     spoken name is its aria-label, so the words here are for the eye only (the empty alt). */\n  .stacked thead th.select::after {\n    content: 'Select all' / '';\n    margin-inline-start: calc(var(--design-unit, 4) * 1.5px);\n    vertical-align: middle;\n  }\n\n  .stacked tbody tr {\n    padding-block: calc(var(--design-unit, 4) * 1px);\n    border-top: calc(var(--stroke-width, 1) * 1px) solid var(--neutral-stroke-rest);\n  }\n\n  .stacked td {\n    border-bottom: none;\n  }\n\n  .stacked td[data-label] {\n    display: grid;\n    grid-template-columns: minmax(0, 2fr) minmax(0, 3fr);\n    gap: calc(var(--design-unit, 4) * 2px);\n    white-space: normal;\n    overflow-wrap: anywhere;\n  }\n\n  .stacked td[data-label]::before {\n    content: attr(data-label);\n    font-weight: 600;\n  }\n\n  /* No column to bound any more: a long value takes the line's width like any other, and wraps\n     within it like any other. */\n  .stacked td.long {\n    min-width: 0;\n    max-width: none;\n    white-space: normal;\n    overflow-wrap: anywhere;\n  }\n\n  /*\n   * The two marks this table carries — \"this field is changing\" and \"this field decides which\n   * record disappears\" — were weight, colour and a strike-through only. None of that reaches\n   * somebody using a screen reader, who is the one approver with no other way to tell, so each\n   * mark has words as well.\n   */\n  .sr-only {\n    position: absolute;\n    width: 1px;\n    height: 1px;\n    overflow: hidden;\n    clip-path: inset(50%);\n    white-space: nowrap;\n  }\n\n  /*\n   * A delete shows the whole record and sends its key alone, so the fields that actually decide\n   * which record disappears are marked. Not colour alone — an underline carries to a user who\n   * cannot distinguish it.\n   */\n  td.identifying {\n    font-weight: 600;\n    text-decoration: underline;\n  }\n\n  /*\n   * The diff, the way a code review shows one: what goes is tinted as removed and struck through,\n   * what comes in is tinted as added and bold. Only the BACKGROUND is tinted, at low alpha, from\n   * the theme's own success and error tokens (with fallbacks, as foundation-forms does), and the\n   * text keeps the normal foreground colour: coloured text on a coloured ground is where contrast\n   * fails, dark mode first. The tint is never the only signal. Strike-through, weight, the visible\n   * + and − marks and the spoken \"was\" and \"now\" all carry the same thing without colour.\n   */\n\n  /* The mark a user's eye needs: this field is being changed. */\n  td.changed {\n    font-weight: 600;\n  }\n\n  /* On its own line above the new value, so neither can push the other out of view. */\n  td.changed .was {\n    display: block;\n    font-weight: 400;\n    text-decoration: line-through;\n    background: var(--write-review-removed);\n  }\n\n  td.changed .now {\n    display: block;\n    background: var(--write-review-added);\n  }\n\n  /* Room inside the tint, so the − and + do not sit on its edge. */\n  td.changed .was,\n  td.changed .now {\n    padding-inline: calc(var(--design-unit, 4) * 1px);\n  }\n\n  /*\n   * A row that will not be written is never tinted, not even inside a cell. For a refused row\n   * review-model already gives it no changed cells, and this is the second guard. For a row the\n   * resolved review did not approve, the − and + stay as the record of what was proposed, but\n   * without the tint that says it will happen.\n   */\n  tr.refused td.changed .was,\n  tr.refused td.changed .now,\n  tr.unwritten td.changed .was,\n  tr.unwritten td.changed .now {\n    background: none;\n  }\n\n  /* A whole row coming in, or going. A refused row is neither, and keeps its muted look. */\n  tr.added td {\n    background: var(--write-review-added);\n  }\n\n  tr.removed td {\n    background: var(--write-review-removed);\n  }\n\n  /*\n   * A closed review's row that was not approved says so in words — without them, a denied modify\n   * read in greyscale or by a screen reader exactly like an approved one. An approved row says what\n   * came of it the same way, once the write tool has recorded that (written, not written\n   * because the user stopped, or its own reason).\n   */\n  .not-written,\n  .fate {\n    margin-inline-start: calc(var(--design-unit, 4) * 1.5px);\n    font-size: var(--type-ramp-minus-1-font-size, 0.875em);\n    color: var(--neutral-foreground-hint);\n  }\n\n  /*\n   * A row action's input is what its handler is given, not a change to the row, so it is labelled\n   * rather than marked as a diff. The label is text, so it reaches a screen reader as well.\n   */\n  .input-mark {\n    font-style: italic;\n    color: var(--neutral-foreground-hint);\n    padding-inline-end: calc(var(--design-unit, 4) * 1px);\n  }\n\n  .row-action p {\n    margin-block: calc(var(--design-unit, 4) * 1px);\n  }\n\n  /* The empty placeholder: a style no row text can take, so a literal \"(blank)\" cannot pass for it. */\n  .blank {\n    font-style: italic;\n    font-weight: 400;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .mark {\n    font-weight: 600;\n    padding-inline-end: calc(var(--design-unit, 4) * 1px);\n    user-select: none;\n  }\n\n  /* The row's + or − sits beside its checkbox, not on the baseline under it (where − reads as _). */\n  td.select {\n    white-space: nowrap;\n  }\n\n  .select rapid-checkbox,\n  td.select .mark {\n    vertical-align: middle;\n  }\n\n  /* A gap from the checkbox, so the mark reads as the row's sign rather than part of the box. */\n  td.select .mark {\n    margin-inline-start: calc(var(--design-unit, 4) * 1.5px);\n  }\n\n  /* The strike-through belongs to the value, not to its − mark. */\n  td.changed .was .mark {\n    display: inline-block;\n    text-decoration: none;\n  }\n\n  tr.refused {\n    color: var(--neutral-foreground-hint);\n  }\n\n  /* A refusal is a sentence, and it spans the table: it wraps rather than running off it. */\n  .problems {\n    color: var(--error-fill-rest, #c00);\n    white-space: normal;\n  }\n\n  /* Wraps, so in a narrow bubble the last button drops to a new line rather than off the edge. */\n  .actions {\n    display: flex;\n    flex-wrap: wrap;\n    gap: calc(var(--design-unit, 4) * 2px);\n    margin-top: calc(var(--design-unit, 4) * 2px);\n  }\n\n  /* The change request takes the width the buttons leave it. */\n  .change-request {\n    flex: 1 1 24ch;\n  }\n\n  /* The outcome's live region is always there; while the review is open it takes no room. */\n  .closed:empty {\n    margin: 0;\n  }\n\n  /* The count sits at the foot of the field, beside it rather than in its way. */\n  .remaining {\n    align-self: flex-end;\n    white-space: nowrap;\n    font-size: var(--type-ramp-minus-1-font-size, 0.875em);\n    color: var(--neutral-foreground-hint);\n  }\n`"
         }
       ],
       "exports": [
@@ -25045,7 +25195,7 @@
           "type": {
             "text": "ViewTemplate<GenesisWriteReview>"
           },
-          "default": "html<GenesisWriteReview>`\n  ${when(\n    (x) => !!x.model,\n    html<GenesisWriteReview>`\n      ${when(\n        (x) => !x.rowActionHeading,\n        html<GenesisWriteReview>`\n          <p>\n            ${(x) => x.model?.op} ${(x) => x.model?.rows.length} row(s) in\n            ${(x) => x.model?.resource}. Nothing is written until you choose rows and select Write.\n          </p>\n        `,\n      )}\n      ${when(\n        (x) => !!x.rowActionHeading,\n        html<GenesisWriteReview>`\n          <p class=\"row-action-heading\">${(x) => x.rowActionHeading}</p>\n          <div class=\"row-action\" id=\"${ROW_ACTION_LINES_ID}\">\n            ${repeat(\n              (x) => x.rowActionLines,\n              html<string>`\n                <p>${(x) => x}</p>\n              `,\n            )}\n          </div>\n        `,\n      )}\n      ${when(\n        (x) => !!x.customCodeLine,\n        html<GenesisWriteReview>`\n          <p class=\"custom-code\" id=\"${CUSTOM_CODE_LINE_ID}\">${(x) => x.customCodeLine}</p>\n        `,\n      )}\n      <div class=\"scroller\">\n        <table\n          aria-label=\"${(x) => x.tableLabel}\"\n          aria-describedby=\"${(x) =>\n            x.customCodeLine\n              ? CUSTOM_CODE_LINE_ID\n              : x.rowActionHeading\n                ? ROW_ACTION_LINES_ID\n                : undefined}\"\n        >\n          <thead>\n            <tr>\n              <th>\n                <rapid-checkbox\n                  aria-label=\"Select all rows\"\n                  :checked=\"${(x) => x.allSelected}\"\n                  ?disabled=\"${(x) => x.settled || !x.model?.selectable.length}\"\n                  @change=\"${(x, c) => x.setAll(checkedOf(c.event))}\"\n                ></rapid-checkbox>\n              </th>\n              ${repeat(\n                (x) => x.model?.columns ?? [],\n                html<ReviewColumn>`\n                  <th>${(c) => c.label}</th>\n                `,\n              )}\n            </tr>\n          </thead>\n          <tbody>${repeat((x) => x.model?.rows ?? [], row)}</tbody>\n        </table>\n      </div>\n      <div class=\"actions\">\n        ${when(\n          (x) => !x.asking,\n          html<GenesisWriteReview>`\n            <rapid-button\n              appearance=\"accent\"\n              ?disabled=\"${(x) => !x.writable}\"\n              @click=\"${(x) => x.write()}\"\n            >\n              Write ${(x) => (x.rowsSelected ? `${x.rowsSelected} row(s)` : '')}\n            </rapid-button>\n            <rapid-button\n              class=\"ask\"\n              ?disabled=\"${(x) => x.settled}\"\n              @click=\"${(x) => x.startAsking()}\"\n            >\n              Ask for changes\n            </rapid-button>\n            <rapid-button ?disabled=\"${(x) => x.settled}\" @click=\"${(x) => x.deny()}\">\n              Deny\n            </rapid-button>\n          `,\n        )}\n        ${when(\n          (x) => x.asking,\n          html<GenesisWriteReview>`\n            <rapid-text-area\n              class=\"change-request\"\n              :value=\"${(x) => x.changeText}\"\n              ?readonly=\"${(x) => x.settled}\"\n              maxlength=\"${() => MAX_FEEDBACK_CHARS}\"\n              @input=\"${(x, c) => {\n                x.setChangeText((c.event.target as HTMLTextAreaElement).value);\n                return true;\n              }}\"\n            >\n              What should change?\n            </rapid-text-area>\n            <span class=\"remaining\">${(x) => x.charactersLeft} characters left</span>\n            <rapid-button\n              class=\"send\"\n              appearance=\"accent\"\n              ?disabled=\"${(x) => !x.canSendChanges}\"\n              @click=\"${(x) => x.sendChanges()}\"\n            >\n              Send\n            </rapid-button>\n            <rapid-button class=\"back\" ?disabled=\"${(x) => x.settled}\" @click=\"${(x) => x.back()}\">\n              Back\n            </rapid-button>\n          `,\n        )}\n      </div>\n    `,\n  )}\n  ${\n    /* A live region, and there from the start: a screen reader announces a change to one it\n       already knows, and a region added with its text already in it was not announced at all.\n       Empty while the review is open; filled by sayOutcome, which also decides when. Focusable\n       from script only, so focus can land on the outcome after an answer. */ ''\n  }\n  <p class=\"closed\" role=\"status\" tabindex=\"-1\">${(x) => x.announcement}</p>\n`"
+          "default": "html<GenesisWriteReview>`\n  ${when(\n    (x) => !!x.model,\n    html<GenesisWriteReview>`\n      ${when(\n        (x) => !x.rowActionHeading,\n        html<GenesisWriteReview>`\n          <p>\n            ${(x) => x.model?.op} ${(x) => x.model?.rows.length} row(s) in\n            ${(x) => x.model?.resource}. Nothing is written until you choose rows and select Write.\n          </p>\n        `,\n      )}\n      ${when(\n        (x) => !!x.rowActionHeading,\n        html<GenesisWriteReview>`\n          <p class=\"row-action-heading\">${(x) => x.rowActionHeading}</p>\n          <div class=\"row-action\" id=\"${ROW_ACTION_LINES_ID}\">\n            ${repeat(\n              (x) => x.rowActionLines,\n              html<string>`\n                <p>${(x) => x}</p>\n              `,\n            )}\n          </div>\n        `,\n      )}\n      ${when(\n        (x) => !!x.customCodeLine,\n        html<GenesisWriteReview>`\n          <p class=\"custom-code\" id=\"${CUSTOM_CODE_LINE_ID}\">${(x) => x.customCodeLine}</p>\n        `,\n      )}\n      ${\n        /* The table's roles are stated, not left to the tags: the stacked layout sets display: block\n           on its parts, and a browser then drops their table semantics, so a screen reader would\n           hear a run of values with no row or column to put them in. */ ''\n      }\n      <div class=\"scroller ${(x) => (x.stacked ? 'stacked' : '')}\">\n        <table\n          role=\"table\"\n          aria-label=\"${(x) => x.tableLabel}\"\n          aria-describedby=\"${(x) =>\n            x.customCodeLine\n              ? CUSTOM_CODE_LINE_ID\n              : x.rowActionHeading\n                ? ROW_ACTION_LINES_ID\n                : undefined}\"\n        >\n          <thead role=\"rowgroup\">\n            <tr role=\"row\">\n              <th role=\"columnheader\" class=\"select\">\n                <rapid-checkbox\n                  aria-label=\"Select all rows\"\n                  :checked=\"${(x) => x.allSelected}\"\n                  ?disabled=\"${(x) => x.settled || !x.model?.selectable.length}\"\n                  @change=\"${(x, c) => x.setAll(checkedOf(c.event))}\"\n                ></rapid-checkbox>\n              </th>\n              ${repeat(\n                (x) => x.model?.columns ?? [],\n                html<ReviewColumn>`\n                  <th role=\"columnheader\">${(c) => c.label}</th>\n                `,\n              )}\n            </tr>\n          </thead>\n          <tbody role=\"rowgroup\">${repeat((x) => x.model?.rows ?? [], row)}</tbody>\n        </table>\n      </div>\n      <div class=\"actions\">\n        ${when(\n          (x) => !x.asking,\n          html<GenesisWriteReview>`\n            <rapid-button\n              appearance=\"accent\"\n              ?disabled=\"${(x) => !x.writable}\"\n              @click=\"${(x) => x.write()}\"\n            >\n              Write ${(x) => (x.rowsSelected ? `${x.rowsSelected} row(s)` : '')}\n            </rapid-button>\n            <rapid-button\n              class=\"ask\"\n              ?disabled=\"${(x) => x.settled}\"\n              @click=\"${(x) => x.startAsking()}\"\n            >\n              Ask for changes\n            </rapid-button>\n            <rapid-button ?disabled=\"${(x) => x.settled}\" @click=\"${(x) => x.deny()}\">\n              Deny\n            </rapid-button>\n          `,\n        )}\n        ${when(\n          (x) => x.asking,\n          html<GenesisWriteReview>`\n            <rapid-text-area\n              class=\"change-request\"\n              :value=\"${(x) => x.changeText}\"\n              ?readonly=\"${(x) => x.settled}\"\n              maxlength=\"${() => MAX_FEEDBACK_CHARS}\"\n              @input=\"${(x, c) => {\n                x.setChangeText((c.event.target as HTMLTextAreaElement).value);\n                return true;\n              }}\"\n            >\n              What should change?\n            </rapid-text-area>\n            <span class=\"remaining\">${(x) => x.charactersLeft} characters left</span>\n            <rapid-button\n              class=\"send\"\n              appearance=\"accent\"\n              ?disabled=\"${(x) => !x.canSendChanges}\"\n              @click=\"${(x) => x.sendChanges()}\"\n            >\n              Send\n            </rapid-button>\n            <rapid-button class=\"back\" ?disabled=\"${(x) => x.settled}\" @click=\"${(x) => x.back()}\">\n              Back\n            </rapid-button>\n          `,\n        )}\n      </div>\n    `,\n  )}\n  ${\n    /* A live region, and there from the start: a screen reader announces a change to one it\n       already knows, and a region added with its text already in it was not announced at all.\n       Empty while the review is open; filled by sayOutcome, which also decides when. Focusable\n       from script only, so focus can land on the outcome after an answer. */ ''\n  }\n  <p class=\"closed\" role=\"status\" tabindex=\"-1\">${(x) => x.announcement}</p>\n`"
         }
       ],
       "exports": [
@@ -25129,6 +25279,33 @@
               "default": "''",
               "description": "What the live region says: the outcome once the review has resolved. See `sayOutcome`."
             },
+            {
+              "kind": "field",
+              "name": "stacked",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "True when the table would not fit the width it has, and each row is laid out as its fields\nstacked label beside value instead."
+            },
+            {
+              "kind": "field",
+              "name": "resizeObserver",
+              "type": {
+                "text": "ResizeObserver | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "tableWidth",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "The table's width when last laid out as a table: what the review needs to stop stacking."
+            },
             {
               "kind": "field",
               "name": "answeredNow",
@@ -25147,6 +25324,17 @@
               "privacy": "private",
               "description": "The answer this element shows while its outcome is still to come, whose `focused` it keeps\ncurrent. The rebuild that brings the outcome gives focus back only if this one held it when\nit was removed: a user who has since moved to the chat input keeps their place."
             },
+            {
+              "kind": "method",
+              "name": "fitLayout",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Stacks the rows when the table is wider than the review, and goes back to the table once the\nreview is as wide as the table was. While stacked there is no table to measure, so the width it\nhad is kept from the last time it was one."
+            },
             {
               "kind": "field",
               "name": "model",