@genesislcap/ai-assistant 15.86.0 → 15.86.1

package/dist/custom-elements.json

@@ -1408,6 +1408,287 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/channel/ai-activity-bus.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "NOOP_ACTIVITY_BUS",
+          "type": {
+            "text": "ActivityBus"
+          },
+          "default": "{ publish: () => {} }",
+          "description": "No-op ActivityBus. The default when no bus is injected (Node, tests, headless\nserver use) — publishing goes nowhere and nothing is left open to tear down."
+        },
+        {
+          "kind": "class",
+          "description": "Typed in-process event bus for AI assistant activity events.\n\nDispatches events synchronously to all local subscribers in the same JS module instance\n(i.e. the same browser tab). Events listed in `crossTabEvents` are additionally forwarded\nvia a shared `BroadcastChannel` so that other tabs on the same origin receive them.",
+          "name": "AgenticActivityBus",
+          "members": [
+            {
+              "kind": "field",
+              "name": "subscribers",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new Map<string, Set<AnyHandler>>()"
+            },
+            {
+              "kind": "field",
+              "name": "crossTabEvents",
+              "type": {
+                "text": "Set<string>"
+              },
+              "privacy": "private",
+              "readonly": true,
+              "default": "new Set(config?.crossTabEvents ?? [])"
+            },
+            {
+              "kind": "field",
+              "name": "channelNameFactory",
+              "type": {
+                "text": "() => string | undefined"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "channel",
+              "type": {
+                "text": "BroadcastChannel | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "channelInitialised",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "method",
+              "name": "ensureChannel",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Lazily open the cross-tab `BroadcastChannel` on first use. Deferred (rather than\ncreated in the constructor) so that importing this module, or constructing the bus\noff-browser (Node, tests, headless server), never opens a live channel or reads\n`sessionStorage` — both would keep a Node event loop alive and hang the process.\nCross-tab forwarding is inherently browser-only, so channel creation is gated on a\nbrowser environment; elsewhere the bus stays purely in-process."
+            },
+            {
+              "kind": "method",
+              "name": "subscribe",
+              "return": {
+                "type": {
+                  "text": "() => void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "K"
+                  }
+                },
+                {
+                  "name": "handler",
+                  "type": {
+                    "text": "(detail: AgenticActivityEvents[K]) => void"
+                  }
+                }
+              ],
+              "description": "Subscribe to an event. Returns an unsubscribe function — call it in\n`disconnectedCallback` to avoid memory leaks."
+            },
+            {
+              "kind": "method",
+              "name": "publish",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "K"
+                  }
+                },
+                {
+                  "name": "detail",
+                  "type": {
+                    "text": "AgenticActivityEvents[K]"
+                  }
+                }
+              ],
+              "description": "Publish an event to all local subscribers and, if configured, to other tabs\nvia BroadcastChannel."
+            },
+            {
+              "kind": "method",
+              "name": "addCrossTabEvent",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "keyof AgenticActivityEvents"
+                  }
+                }
+              ],
+              "description": "Add an event type to the cross-tab forwarding set at runtime.\nMust be called before the first AgenticActivityBus.publish of that event type."
+            },
+            {
+              "kind": "method",
+              "name": "close",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Close the underlying BroadcastChannel. Call once on application teardown if needed."
+            },
+            {
+              "kind": "method",
+              "name": "notifyLocal",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "detail",
+                  "type": {
+                    "text": "unknown"
+                  }
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "kind": "variable",
+          "name": "agenticActivityBus",
+          "default": "new AgenticActivityBus({\n  crossTabEvents: ['halo-start', 'halo-stop', 'tool-loop-start', 'tool-loop-end'],\n  // Lazy: the tab-scoped name (and its `sessionStorage` read) is computed on first\n  // cross-tab use in a browser, not at module-eval — so importing this module is\n  // side-effect-free and Node/test-safe.\n  channelNameFactory: () => getTabScopedChannelName('foundation-ai-activity'),\n})",
+          "description": "Pre-instantiated singleton event bus for AI assistant activity.\n\n- `halo-start` / `halo-stop` are forwarded via a tab-scoped `BroadcastChannel` so that\n  popout windows opened from this tab show halo animations, while remaining isolated from\n  unrelated tabs on the same origin (tab-scoped channel name).\n- `tool-loop-start` / `tool-loop-end` are cross-tab for the same reason: they describe the\n  assistant's lifecycle (a turn beginning / ending), and the most common subscribers\n  (workspace transitions, post-turn deferred recomputation, UI gates tied to the assistant\n  being idle) need the event regardless of whether the user is interacting with the chat\n  in the main tab or a popout window. Tab-local-only telemetry can subscribe and filter.\n- `chat-popout` / `chat-popin` are in-memory only — they must only affect the tab where the\n  user clicked."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "NOOP_ACTIVITY_BUS",
+          "declaration": {
+            "name": "NOOP_ACTIVITY_BUS",
+            "module": "src/channel/ai-activity-bus.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AgenticActivityBus",
+          "declaration": {
+            "name": "AgenticActivityBus",
+            "module": "src/channel/ai-activity-bus.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "agenticActivityBus",
+          "declaration": {
+            "name": "agenticActivityBus",
+            "module": "src/channel/ai-activity-bus.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/channel/ai-activity-channel.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/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",
@@ -4730,275 +5011,122 @@
         },
         {
           "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": "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"
@@ -5006,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": "setAutopilotNeedsUser",
+          "name": "friendlyFallbackAgent",
+          "declaration": {
+            "name": "friendlyFallbackAgent",
+            "module": "src/config/fallback-agents.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "strictFallbackAgent",
+          "declaration": {
+            "name": "strictFallbackAgent",
+            "module": "src/config/fallback-agents.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/config/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
           "declaration": {
-            "name": "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",
@@ -5527,293 +5758,62 @@
                 }
               },
               "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": "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": [
-            {
-              "name": "machine",
-              "type": {
-                "text": "{ stop: () => void; start: (options?: { state?: unknown }) => void }"
-              },
-              "description": "the machine to restore (already constructed/started)."
-            },
-            {
-              "name": "restored",
-              "type": {
-                "text": "unknown"
-              },
-              "description": "the agent's serialized image (`ctx.restored` in `init`)."
-            },
-            {
-              "name": "key",
-              "default": "'machine'",
-              "description": "the property the machine occupies in the snapshot; defaults to\n`'machine'` to match the conventional `{ machine }` state bag."
-            }
-          ],
-          "description": "Restore a foundation-state-machine instance from a snapshot produced by the\ndefault serializer (or `machine.getPersistedSnapshot()`). Call inside a\nstateful agent's `init` to resume the machine in its exact prior place:\n\n```ts\ninit: ({ restored }) => {\n  const machine = new MyMachine();\n  restoreMachine(machine, restored); // resume, or no-op on a fresh start\n  return { machine };\n}\n```\n\nNo-ops when there is nothing to restore (a fresh session), leaving the\nfreshly-constructed machine in its initial state."
-        },
-        {
-          "kind": "function",
-          "name": "defineStatefulAgent",
-          "return": {
-            "type": {
-              "text": "AgentConfig"
-            }
-          },
-          "parameters": [
-            {
-              "name": "opts",
-              "type": {
-                "text": "StatefulAgentInit<S>"
-              }
-            }
-          ],
-          "description": "Build an `AgentConfig` whose `systemPrompt`, `toolDefinitions`, and tool\nhandlers all close over a long-lived state object created on activation.\n\nThe framework wires the lifecycle: `init` on `onActivate`, `dispose` on\n`onDeactivate`. State is held inside the helper's closure — never exposed on\nthe resulting `AgentConfig` — so the redux serializer doesn't see it."
-        },
-        {
-          "kind": "function",
-          "name": "defineAutopilot",
-          "return": {
-            "type": {
-              "text": "AutopilotConfig<S>"
-            }
-          },
-          "parameters": [
-            {
-              "name": "config",
-              "type": {
-                "text": "AutopilotConfig<S>"
-              }
-            }
-          ],
-          "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"
+                {
+                  "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"
           },
-          "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-waves-indicator",
+          "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "friendlyFallbackAgent",
-          "declaration": {
-            "name": "friendlyFallbackAgent",
-            "module": "src/config/fallback-agents.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "strictFallbackAgent",
-          "declaration": {
-            "name": "strictFallbackAgent",
-            "module": "src/config/fallback-agents.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/config/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
+          "name": "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",
@@ -6972,202 +6972,28 @@
             {
               "name": "options",
               "default": "{}",
-              "type": {
-                "text": "GenesisWriteToolsOptions"
-              }
-            }
-          ],
-          "description": "Builds the assistant's write tools from an app's event resources."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "createGenesisWriteTools",
-          "declaration": {
-            "name": "createGenesisWriteTools",
-            "module": "src/genesis/write-tools.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/genesis/write-turn.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/notifications/agent-notifications.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "DEFAULT_AGENT_NOTIFICATION_MESSAGE",
-          "type": {
-            "text": "string"
-          },
-          "default": "'The assistant is ready for your next input'",
-          "description": "The notification's text when neither the app nor the widget gives one."
-        },
-        {
-          "kind": "function",
-          "name": "agentNotificationPermission",
-          "return": {
-            "type": {
-              "text": "AgentNotificationPermission"
-            }
-          },
-          "description": "Whether this page may show notifications. Safe to call anywhere, including Node."
-        },
-        {
-          "kind": "function",
-          "name": "requestAgentNotificationPermission",
-          "return": {
-            "type": {
-              "text": "Promise<AgentNotificationPermission>"
-            }
-          },
-          "description": "Ask the person for permission to show notifications, and resolve to the result. Call it from a\nclick or key handler: browsers ignore or refuse a request that does not come from the person.\nResolves straight away when permission is already decided or unsupported, since a browser only\never asks once."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "DEFAULT_AGENT_NOTIFICATION_MESSAGE",
-          "declaration": {
-            "name": "DEFAULT_AGENT_NOTIFICATION_MESSAGE",
-            "module": "src/notifications/agent-notifications.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "agentNotificationPermission",
-          "declaration": {
-            "name": "agentNotificationPermission",
-            "module": "src/notifications/agent-notifications.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "requestAgentNotificationPermission",
-          "declaration": {
-            "name": "requestAgentNotificationPermission",
-            "module": "src/notifications/agent-notifications.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/notifications/agent-notifier.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/notifications/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "agentNotificationPermission",
-          "declaration": {
-            "name": "agentNotificationPermission",
-            "module": "./agent-notifications"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "DEFAULT_AGENT_NOTIFICATION_MESSAGE",
-          "declaration": {
-            "name": "DEFAULT_AGENT_NOTIFICATION_MESSAGE",
-            "module": "./agent-notifications"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "requestAgentNotificationPermission",
-          "declaration": {
-            "name": "requestAgentNotificationPermission",
-            "module": "./agent-notifications"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "type",
-          "declaration": {
-            "name": "type",
-            "module": "./agent-notifications"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "AgentAttentionDetail",
-          "declaration": {
-            "name": "AgentAttentionDetail",
-            "module": "./agent-notifications"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "type",
-          "declaration": {
-            "name": "type",
-            "module": "./agent-notifications"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "AgentAttentionKind",
-          "declaration": {
-            "name": "AgentAttentionKind",
-            "module": "./agent-notifications"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "type",
-          "declaration": {
-            "name": "type",
-            "module": "./agent-notifications"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "AgentNotificationLevel",
-          "declaration": {
-            "name": "AgentNotificationLevel",
-            "module": "./agent-notifications"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "type",
-          "declaration": {
-            "name": "type",
-            "module": "./agent-notifications"
-          }
-        },
+              "type": {
+                "text": "GenesisWriteToolsOptions"
+              }
+            }
+          ],
+          "description": "Builds the assistant's write tools from an app's event resources."
+        }
+      ],
+      "exports": [
         {
           "kind": "js",
-          "name": "AgentNotificationPermission",
+          "name": "createGenesisWriteTools",
           "declaration": {
-            "name": "AgentNotificationPermission",
-            "module": "./agent-notifications"
+            "name": "createGenesisWriteTools",
+            "module": "src/genesis/write-tools.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/notifications/notification-level-picker.template.ts",
-      "declarations": [],
-      "exports": []
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/notifications/notification-settings.ts",
+      "path": "src/genesis/write-turn.ts",
       "declarations": [],
       "exports": []
     },
@@ -7508,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",
@@ -11064,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",
@@ -11205,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"
@@ -11269,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": {
@@ -11354,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."
         },
         {
@@ -11428,6 +11285,180 @@
       "declarations": [],
       "exports": []
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/notifications/agent-notifications.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "DEFAULT_AGENT_NOTIFICATION_MESSAGE",
+          "type": {
+            "text": "string"
+          },
+          "default": "'The assistant is ready for your next input'",
+          "description": "The notification's text when neither the app nor the widget gives one."
+        },
+        {
+          "kind": "function",
+          "name": "agentNotificationPermission",
+          "return": {
+            "type": {
+              "text": "AgentNotificationPermission"
+            }
+          },
+          "description": "Whether this page may show notifications. Safe to call anywhere, including Node."
+        },
+        {
+          "kind": "function",
+          "name": "requestAgentNotificationPermission",
+          "return": {
+            "type": {
+              "text": "Promise<AgentNotificationPermission>"
+            }
+          },
+          "description": "Ask the person for permission to show notifications, and resolve to the result. Call it from a\nclick or key handler: browsers ignore or refuse a request that does not come from the person.\nResolves straight away when permission is already decided or unsupported, since a browser only\never asks once."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "DEFAULT_AGENT_NOTIFICATION_MESSAGE",
+          "declaration": {
+            "name": "DEFAULT_AGENT_NOTIFICATION_MESSAGE",
+            "module": "src/notifications/agent-notifications.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "agentNotificationPermission",
+          "declaration": {
+            "name": "agentNotificationPermission",
+            "module": "src/notifications/agent-notifications.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "requestAgentNotificationPermission",
+          "declaration": {
+            "name": "requestAgentNotificationPermission",
+            "module": "src/notifications/agent-notifications.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/notifications/agent-notifier.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/notifications/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "agentNotificationPermission",
+          "declaration": {
+            "name": "agentNotificationPermission",
+            "module": "./agent-notifications"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "DEFAULT_AGENT_NOTIFICATION_MESSAGE",
+          "declaration": {
+            "name": "DEFAULT_AGENT_NOTIFICATION_MESSAGE",
+            "module": "./agent-notifications"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "requestAgentNotificationPermission",
+          "declaration": {
+            "name": "requestAgentNotificationPermission",
+            "module": "./agent-notifications"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "type",
+          "declaration": {
+            "name": "type",
+            "module": "./agent-notifications"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AgentAttentionDetail",
+          "declaration": {
+            "name": "AgentAttentionDetail",
+            "module": "./agent-notifications"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "type",
+          "declaration": {
+            "name": "type",
+            "module": "./agent-notifications"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AgentAttentionKind",
+          "declaration": {
+            "name": "AgentAttentionKind",
+            "module": "./agent-notifications"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "type",
+          "declaration": {
+            "name": "type",
+            "module": "./agent-notifications"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AgentNotificationLevel",
+          "declaration": {
+            "name": "AgentNotificationLevel",
+            "module": "./agent-notifications"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "type",
+          "declaration": {
+            "name": "type",
+            "module": "./agent-notifications"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AgentNotificationPermission",
+          "declaration": {
+            "name": "AgentNotificationPermission",
+            "module": "./agent-notifications"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/notifications/notification-level-picker.template.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/notifications/notification-settings.ts",
+      "declarations": [],
+      "exports": []
+    },
     {
       "kind": "javascript-module",
       "path": "src/provider/ai-provider-switcher.ts",
@@ -17683,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",
@@ -17903,7 +17935,7 @@
             },
             {
               "kind": "method",
-              "name": "injectCloseButton",
+              "name": "showCloseButton",
               "privacy": "private",
               "parameters": [
                 {
@@ -17912,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",
@@ -25138,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": [
@@ -25162,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": [
@@ -25246,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",
@@ -25264,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",