@genesislcap/ai-assistant 14.490.0 → 14.491.0-FUI-2567.1

package/dist/custom-elements.json

@@ -119,6 +119,14 @@
             "package": "./config/fallback-agents"
           }
         },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./state/persistence"
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -890,6 +898,37 @@
       "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",
@@ -910,6 +949,14 @@
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "restoreMachine",
+          "declaration": {
+            "name": "restoreMachine",
+            "module": "src/config/define-stateful-agent.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "defineStatefulAgent",
@@ -1106,6 +1153,14 @@
               },
               "default": "'Genesis Assistant'"
             },
+            {
+              "kind": "field",
+              "name": "sessionKey",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Explicit session/persistence key (GENC-1351 §5.12). When set, this is the\nsession identity — the key for the driver/store/persister/diagnostics\nregistries and the `sessionKey` passed to the persistence provider — taking\nprecedence over the DOM `id`. A host that scopes persistence per-entity\n(e.g. one chat session per project) binds this to a stable per-entity id;\nchanging it on a **connected** element re-keys the session in place — tears\ndown the current conversation and restores the new key's — via\n`switchSession`. Falls back to `id` when unset,\nso existing consumers are unaffected."
+            },
             {
               "kind": "field",
               "name": "imageSrc",
@@ -1206,6 +1261,15 @@
               },
               "default": "{}"
             },
+            {
+              "kind": "field",
+              "name": "persistence",
+              "type": {
+                "text": "SessionPersistenceConfig"
+              },
+              "default": "{}",
+              "description": "Optional session persistence (GENC-1351). Off by default — set `enabled`\nand a `provider` (e.g. a `WebStorageSessionProvider`) to have the assistant\nautosave on idle and auto-restore the conversation on page reload. Exposed\nas a top-level property (like `agents`/`providerRegistry`) rather than via\n`chatConfig`, since the provider type lives in this package while\n`ChatConfig` lives in `foundation-ai`."
+            },
             {
               "kind": "field",
               "name": "agentPicker",
@@ -1246,7 +1310,8 @@
               "type": {
                 "text": "SessionStoreReturn | undefined"
               },
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Pointer to this session's redux store. `@observable` (GENC-1351 §5.12) so that\n**swapping** it — the in-place session switch/re-key (`switchSession`) —\nforces every store-backed getter binding to re-evaluate against the NEW store.\nWithout this, FAST's per-store slice tracking would leave the view subscribed\nto the old store after a swap and it wouldn't re-render. (A same-store reset via\nredux actions re-renders without this; a store *swap* needs it.)"
             },
             {
               "kind": "field",
@@ -1291,6 +1356,16 @@
               "description": "True while a turn is active — `loading` or `cancelling` (a stop was\nrequested but the turn is still winding down). The single \"is a turn\nrunning\" predicate; UI gates use this so `cancelling` behaves like\n`loading` everywhere. `@volatile` so the template re-evaluates it when the\nstore-backed `state` changes.",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "sendBlocked",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "description": "True when a new send must be refused: a turn is running (`busy`), a page-reload\nrestore is loading history that would clobber it (`restoring`), or a manual\ncompaction is rewriting history (`compacting`). Mirrors the composer's\n`?disabled` gate so a **programmatic** `send`/`submitMessage` (e.g. a host's\ncustom input while the built-in composer is hidden) can't slip past it and have\nits message wiped when the restored/compacted history lands (GENC-1351 §6).",
+              "readonly": true
+            },
             {
               "kind": "method",
               "name": "applyDeferredAgentsSwap",
@@ -1302,6 +1377,17 @@
               },
               "description": "Re-runs `agentsChanged` if the live `agents` array no longer matches the\nfingerprint of the currently installed driver. Used to apply swaps that\nlanded during a turn (and were skipped by the `isBusy()` guard) once the\ndriver returns to idle."
             },
+            {
+              "kind": "method",
+              "name": "applyDeferredSessionSwitch",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Apply a `session-key` re-key that arrived mid-turn and was deferred by\n`switchSession`'s busy guard (GENC-1351 §5.12). Run at each point the driver\nreturns to idle, BEFORE `applyDeferredAgentsSwap` — a switch rebuilds the\ndriver against the current agents, so a pending agents-swap then no-ops."
+            },
             {
               "kind": "method",
               "name": "maybeAutoFocusChatInput",
@@ -1370,6 +1456,30 @@
               },
               "description": "Whether the agent picker slide-out panel is open. Lives on the session\nstore so the bubble-dialog and popout-panel instances stay in sync."
             },
+            {
+              "kind": "field",
+              "name": "sessionMenuOpen",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the lifecycle (session) menu slide-out panel is open. Like the\nagent picker, lives on the session store so bubble/popout stay in sync."
+            },
+            {
+              "kind": "field",
+              "name": "compacting",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether a manual compaction is in flight (GENC-1351 §5.7). On the session\nstore (not element-local) so the \"Compacting…\" view + input-disable stay in\nsync across pop-in/out, like the panel flags."
+            },
+            {
+              "kind": "field",
+              "name": "restoring",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether a page-reload restore is in flight (GENC-1351 §6). On the session\nstore (like `compacting`) so the \"Restoring…\" view + input-disable stay in\nsync across pop-in/out. Gating input while true prevents a mid-load send from\nbeing clobbered when the restored history loads."
+            },
             {
               "kind": "field",
               "name": "pinnedAgentName",
@@ -1671,6 +1781,15 @@
               "default": "false",
               "description": "Whether the settings modal is open."
             },
+            {
+              "kind": "field",
+              "name": "downloadingDebugLog",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "True while `downloadDebugLog` is building the log (GENC-1351 §5.8). Drives the\ndownload button's disabled + spinner state — the lifetime-stitch path is async\n(a provider `loadDiagnostics` round-trip), so without feedback a click looks\nlike nothing happened. Per-instance and transient (not shared/persisted): each\nelement has its own settings modal."
+            },
             {
               "kind": "field",
               "name": "settingsModalTab",
@@ -1817,31 +1936,11 @@
               "default": "false",
               "description": "Prevents double-finalize for the same session instance (pagehide + title change)."
             },
-            {
-              "kind": "field",
-              "name": "_finalizeCostSessionOnPageHide",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "default": "true",
-              "description": "Only the visible assistant instance should snapshot on tab close (bubble vs docked panel)."
-            },
             {
               "kind": "field",
               "name": "_handlePageHide",
               "privacy": "private"
             },
-            {
-              "kind": "method",
-              "name": "_syncFinalizeCostSessionOnPageHide",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
             {
               "kind": "field",
               "name": "haloStartPublished",
@@ -1933,13 +2032,6 @@
               "default": "true",
               "description": "True when the user's last interaction (pointer or keyboard focus) was inside\nthe assistant. Defaults to true so the assistant claims focus on first mount.\nAuto-focus features (chat input on idle, widget inputs on mount) gate on this\nto avoid stealing focus from elsewhere on the page."
             },
-            {
-              "kind": "field",
-              "name": "hostId",
-              "privacy": "private",
-              "readonly": true,
-              "description": "GENC-1410 (Error 3): stable id for this assistant view. Reported to the shared driver so it\ncan elect a single owner to render (and run) each interaction's widget when more than one view\n(e.g. a bubble and a docked panel) is wired to the same driver — so it fires once, not per view."
-            },
             {
               "kind": "field",
               "name": "_handleGlobalInteraction",
@@ -2021,6 +2113,54 @@
               "privacy": "private",
               "description": "Unsubscribes a one-shot state subscription created when this element connects\nmid-execution. The subscription watches for `state` becoming 'idle' so that\nthis element can stop its loading timer and sync the halo even when the\noriginating `send()` ran on a different element instance."
             },
+            {
+              "kind": "field",
+              "name": "_applyingPreferences",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "True while UI preferences are being applied programmatically (config defaults\non connect, or a loaded-preferences restore) — suppresses the save hook so we\ndon't persist config defaults or re-persist what we just loaded. Cleared once\nthe apply completes; a genuine *user* toggle (menu switch) runs with it false\nand saves (GENC-1351)."
+            },
+            {
+              "kind": "field",
+              "name": "_freshStore",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Fresh-store flag (`= isNewStore`) captured in `connectedCallback`. Only a\nfreshly created store takes the config/stored-prefs baseline; an existing\nstore — a reload with a live in-realm store, or the popped-out second instance\n— already holds the correct state, so `applyPreferenceBaseline` no-ops for it."
+            },
+            {
+              "kind": "field",
+              "name": "_sessionActive",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "True once `connectedCallback` has fully wired the initial session (GENC-1351\n§5.12). Guards `sessionKeyChanged` so the initial, pre-connect `session-key`\nset doesn't trigger a re-key — only a genuine change to a connected element\nswitches the session. Reset on disconnect."
+            },
+            {
+              "kind": "field",
+              "name": "_activeStateKey",
+              "type": {
+                "text": "string | undefined"
+              },
+              "privacy": "private",
+              "description": "The key of the session currently WIRED to this element (its driver/store/\n`_sessionRef`). Authoritative for `getStateKey()` once a session is active,\nbecause the `session-key` attr can run ahead of an actual switch: a mid-turn\nrebind is deferred to idle (§5.12), and reading the attr in that window would\nretarget autosave/diagnostics at a not-yet-activated key and silently drop the\nrest of the live turn. Set by `activateSession`. Undefined before first connect."
+            },
+            {
+              "kind": "field",
+              "name": "_deferredSwitchToKey",
+              "type": {
+                "text": "string | undefined"
+              },
+              "privacy": "private",
+              "description": "Target key of a `session-key` rebind that arrived mid-turn and was deferred\n(§5.12). Applied by `applyDeferredSessionSwitch` once the driver goes idle. The\nlatest rebind wins if several land while busy. Undefined = no switch pending."
+            },
             {
               "kind": "field",
               "name": "showHalo",
@@ -2149,290 +2289,274 @@
             },
             {
               "kind": "method",
-              "name": "resolveContextLimit",
+              "name": "teardownDriver",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "Promise<void>"
+                  "text": "void"
                 }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "loadProviderStatuses",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "Promise<void>"
+              },
+              "parameters": [
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "string | undefined"
+                  }
                 }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "chatConfigChanged"
-            },
-            {
-              "kind": "method",
-              "name": "showingSplashChanged"
-            },
-            {
-              "kind": "method",
-              "name": "syncShowingSplash",
-              "privacy": "private"
+              ],
+              "description": "Tear down the session's currently-wired driver (GENC-1351): unwire this view, drop\nthe driver from the registry, and dispose it — which fires the active agent's\n`onDeactivate` → `machine.stop()`. Shared by `agentsChanged`, `clearSession`, and\n`switchSession` so the teardown stays identical. `unwireDriver` does not clear\n`this.driver`, so the instance is still readable here for disposal."
             },
             {
               "kind": "method",
-              "name": "handleMessagesUpdate",
+              "name": "rebuildDriver",
               "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
                 }
               },
-              "description": "Runs side effects that were previously in `messagesChanged()`.\nCalled from the `messages` setter after dispatching to the store."
-            },
-            {
-              "kind": "method",
-              "name": "showLoadingIndicatorChanged"
+              "parameters": [
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Build (or adopt from the registry) a fresh driver for `key` against the current\nagents and wire it to this view (GENC-1351). Records the agents fingerprint so a\nlater `agentsChanged` skips a spurious rebuild. Shared by `agentsChanged` and\n`clearSession`."
             },
             {
               "kind": "method",
-              "name": "scrollToBottom",
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "DEFAULT_LOADING_DELAY_S",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private",
-              "static": true,
-              "readonly": true,
-              "default": "0"
-            },
-            {
-              "kind": "field",
-              "name": "DEFAULT_SUGGESTION_COUNT",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private",
-              "static": true,
-              "readonly": true,
-              "default": "3"
-            },
-            {
-              "kind": "field",
-              "name": "MS_PER_SECOND",
-              "type": {
-                "text": "number"
-              },
+              "name": "activateSession",
               "privacy": "private",
-              "static": true,
-              "readonly": true,
-              "default": "1000"
-            },
-            {
-              "kind": "method",
-              "name": "startLoadingTimer",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "clearLoadingTimer",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "stopLoadingTimer",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "claimSideEffect",
               "return": {
                 "type": {
-                  "text": "boolean"
+                  "text": "void"
                 }
               },
               "parameters": [
                 {
-                  "name": "interactionId",
+                  "name": "key",
                   "type": {
                     "text": "string"
                   }
+                },
+                {
+                  "name": "isNewStore",
+                  "type": {
+                    "text": "boolean"
+                  }
                 }
               ],
-              "description": "GENC-1410 (Error 3): claim the right to run a side-effecting interaction's server work for\nTHIS view, via the shared driver's first-writer-wins latch. Returns `true` when this view may\nrun it (first/owning claimant, or a re-render of the same view), `false` when another view\nalready holds it. Fail-open when the driver has no latch. Called by `ai-chat-interaction-wrapper`."
+              "description": "Wire up the session identified by `key` on this element: preference baseline,\ndriver (build/reuse) + wiring, restore (fresh store only), and the per-session\nview state (splash, loading-resume, suggestions, context/provider status, cost\nhistory). Extracted from `connectedCallback` (GENC-1351 §5.12) so an in-place\nsession switch (`switchSession`) can re-run exactly this against a new\nkey without re-adding element-lifetime listeners. Session-scoped only — the\nelement-lifetime wiring (DOM/document/window listeners, provider-registry\nsubscription, app-settings, pagehide) stays in `connectedCallback`."
             },
             {
               "kind": "method",
-              "name": "claimInteractionOwnership",
+              "name": "switchSession",
               "return": {
                 "type": {
                   "text": "void"
                 }
               },
-              "description": "GENC-1410 (Error 3): mark THIS view as the interaction owner on the shared driver, so it (not a\nsibling view sharing the same driver) is elected to render side-effecting widgets. The bubble\nand docked panel normally claim this automatically on the pop-in / dock lifecycle, but that\nlifecycle only runs once `popout-mode` is active. A host that establishes a view outside that\nlifecycle — e.g. a page that restores a docked assistant from a persisted layout before the\npop-out affordance is enabled — calls this to seize ownership deterministically rather than\nleaving it to the last-interaction / first-registered fallback. Idempotent; safe to call on\nevery layout (re)establish. No-op if the driver was never wired."
+              "parameters": [
+                {
+                  "name": "oldKey",
+                  "type": {
+                    "text": "string"
+                  },
+                  "description": "the state key being switched away from."
+                },
+                {
+                  "name": "newKey",
+                  "type": {
+                    "text": "string"
+                  },
+                  "description": "the state key to activate."
+                }
+              ],
+              "description": "Switch this element to a different session **in place**, without a page reload\n(GENC-1351 §5.12) — the load-a-different-project flow. Tears down the current\nsession's driver + per-key registries and restores the target key's session\n(its transcript and any mid-flow stateful agent). Fired automatically by\n`sessionKeyChanged` when a host rebinds\n`session-key` on a connected element; may also be called directly.\n\nClobber-safe: the outgoing session's pending autosave is cancelled BEFORE the\nstore swaps, so its transcript can never be written to the incoming session's\nfile. Idle-only — a switch while a turn is running is refused.",
+              "privacy": "public"
             },
             {
               "kind": "method",
-              "name": "handlePopout",
+              "name": "sessionKeyChanged",
               "return": {
                 "type": {
                   "text": "void"
                 }
-              }
+              },
+              "parameters": [
+                {
+                  "name": "_oldValue",
+                  "type": {
+                    "text": "string | undefined"
+                  }
+                },
+                {
+                  "name": "_newValue",
+                  "type": {
+                    "text": "string | undefined"
+                  }
+                }
+              ],
+              "description": "FAST reflection hook for the `session-key` attr: a change on a **connected**\nelement re-keys the session in place (GENC-1351 §5.12). Guarded by\n`_sessionActive` so the initial, pre-connect set does not switch — the first\nkey is wired by `connectedCallback`."
             },
             {
               "kind": "method",
-              "name": "getStateKey",
+              "name": "resolveContextLimit",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "string | undefined"
+                  "text": "Promise<void>"
                 }
-              },
-              "description": "Returns a cache key for this instance, or undefined if the component has no identity."
+              }
             },
             {
               "kind": "method",
-              "name": "logMeta",
+              "name": "loadProviderStatuses",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "Promise<void>"
                 }
-              },
+              }
+            },
+            {
+              "kind": "method",
+              "name": "chatConfigChanged"
+            },
+            {
+              "kind": "method",
+              "name": "persistenceChanged",
               "parameters": [
                 {
-                  "name": "type",
+                  "name": "oldValue",
                   "type": {
-                    "text": "MetaEventType"
+                    "text": "SessionPersistenceConfig | undefined"
                   }
                 },
                 {
-                  "name": "detail",
-                  "optional": true,
+                  "name": "newValue",
                   "type": {
-                    "text": "Record<string, unknown>"
+                    "text": "SessionPersistenceConfig | undefined"
                   }
                 }
               ],
-              "description": "Record a meta/lifecycle event onto this session's debug-log timeline\n(exported via FoundationAiAssistant.getDebugLog). Every event\nauto-carries `placement` so a session emitted from both the bubble and the\nlayout panel stays disambiguated. Keyed by `stateKey` so the timeline is\nshared across pop-in/pop-out and survives driver rebuilds."
+              "description": "`persistence` (like `chatConfig`) can bind after `connectedCallback` — a host may\nresolve the `provider` asynchronously (an auth token, a feature flag). The connect\npath gates the whole persistence init on a provider being present *at connect*, and\nnothing else re-triggers it — so a late provider would silently never restore the\nsession or load stored preferences (GENC-1351 #13). Mirror `chatConfigChanged`: when\na provider first appears on a connected element whose store is still fresh, run the\nfresh-store init now. Guards keep it a one-shot:\n - pre-connect sets are handled by `connectedCallback` (`_sessionActive` is false);\n - a provider that was already present (incl. the internal `enabled`-only\n   reassignments) is a no-op (`oldValue?.provider`);\n - a non-fresh (restored) store already holds its session (`_freshStore`)."
             },
             {
-              "kind": "field",
-              "name": "_agentPickerToggle",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new AnimatedPanelToggle(\n    this,\n    '.agent-picker-panel',\n    AGENT_PICKER_CLOSE_MS,\n    () => this.agentPickerOpen,\n    (v) => {\n      this.agentPickerOpen = v;\n    },\n  )"
+              "kind": "method",
+              "name": "showingSplashChanged"
             },
             {
               "kind": "method",
-              "name": "toggleAgentPicker"
+              "name": "syncShowingSplash",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "setAgent",
+              "name": "handleMessagesUpdate",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "boolean"
+                  "text": "void"
                 }
               },
-              "parameters": [
-                {
-                  "name": "agentName",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "options",
-                  "optional": true,
-                  "type": {
-                    "text": "{ force?: boolean }"
-                  }
-                }
-              ],
-              "description": "Programmatically pin an agent by name. Returns `true` if the pin was\napplied, `false` if the agent isn't in the configured agents array or\nthe call was suppressed by `force: false`.\n\nWith `force: false`, the call is a no-op when a `picker.defaultAgent` is\nconfigured and the user has already moved away from it (either by picking\nanother agent or by switching to Auto). This lets hosts seed an opinion\nwithout overriding an explicit user choice.",
-              "privacy": "public"
+              "description": "Runs side effects that were previously in `messagesChanged()`.\nCalled from the `messages` setter after dispatching to the store."
             },
             {
-              "kind": "field",
-              "name": "agentPickerEnabled",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Whether the picker toggle button should appear. Mirrors the picker's own visibility rule.",
-              "readonly": true
+              "kind": "method",
+              "name": "showLoadingIndicatorChanged"
             },
             {
-              "kind": "field",
-              "name": "settingsModelSectionVisible",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Whether the settings modal AI Model section has slotted app content or context usage.",
-              "readonly": true
+              "kind": "method",
+              "name": "scrollToBottom",
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "settingsContextUsageVisible",
+              "name": "DEFAULT_LOADING_DELAY_S",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
-              "description": "Built-in context window indicator (generic platform concern).",
-              "readonly": true
+              "privacy": "private",
+              "static": true,
+              "readonly": true,
+              "default": "0"
             },
             {
               "kind": "field",
-              "name": "settingsAppSectionVisible",
+              "name": "DEFAULT_SUGGESTION_COUNT",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
-              "description": "Whether the settings modal UI Builder section should render.",
-              "readonly": true
+              "privacy": "private",
+              "static": true,
+              "readonly": true,
+              "default": "3"
             },
             {
               "kind": "field",
-              "name": "appSettingsSectionTitle",
+              "name": "MS_PER_SECOND",
               "type": {
-                "text": "string"
+                "text": "number"
               },
-              "description": "Section title for the app settings block.",
-              "readonly": true
+              "privacy": "private",
+              "static": true,
+              "readonly": true,
+              "default": "1000"
             },
             {
-              "kind": "field",
-              "name": "visibleAppSettingsToggles",
-              "type": {
-                "text": "AssistantAppSettingsToggle[]"
+              "kind": "method",
+              "name": "startLoadingTimer",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "clearLoadingTimer",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "stopLoadingTimer",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "handlePopout",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "description": "App toggles currently visible per each entry's `visible()` predicate.",
-              "readonly": true
+              "description": "Called when the user clicks the popout button."
             },
             {
               "kind": "method",
-              "name": "getAppSettingValue",
+              "name": "getStateKey",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "boolean"
+                  "text": "string | undefined"
                 }
               },
-              "parameters": [
-                {
-                  "name": "id",
-                  "type": {
-                    "text": "string"
-                  }
+              "description": "Returns a cache key for this instance, or undefined if the component has no identity."
+            },
+            {
+              "kind": "method",
+              "name": "computeStateKeyFromAttrs",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string | undefined"
                 }
-              ]
+              },
+              "description": "The session key implied by the element's current attributes (GENC-1351 §5.12).\nAn explicit `session-key` IS the complete session identity — the host fully\nqualifies it (e.g. a per-project id), so `headerTitle` is NOT appended\n(appending it was multi-window disambiguation, obsolete under the single-window\norchestration/pinning model for keyed hosts). Without a `session-key`, fall back\nto `id` + `headerTitle` (the original scheme, kept so existing consumers — e.g. a\ntitle-only key with no `id` — aren't re-keyed). This is the *desired* key;\n`getStateKey` returns the *wired* key, which can lag during a deferred switch."
             },
             {
               "kind": "method",
-              "name": "setAppSettingValue",
+              "name": "logMeta",
+              "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
@@ -2440,276 +2564,362 @@
               },
               "parameters": [
                 {
-                  "name": "id",
+                  "name": "type",
                   "type": {
-                    "text": "string"
+                    "text": "MetaEventType"
                   }
                 },
                 {
-                  "name": "value",
+                  "name": "detail",
+                  "optional": true,
                   "type": {
-                    "text": "boolean"
+                    "text": "Record<string, unknown>"
                   }
                 }
-              ]
+              ],
+              "description": "Record a meta/lifecycle event onto this session's debug-log timeline\n(exported via FoundationAiAssistant.getDebugLog). Every event\nauto-carries `placement` so a session emitted from both the bubble and the\nlayout panel stays disambiguated. Keyed by `stateKey` so the timeline is\nshared across pop-in/pop-out and survives driver rebuilds."
             },
             {
-              "kind": "method",
-              "name": "wireAppSettingsProvider",
+              "kind": "field",
+              "name": "_agentPickerToggle",
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
+              "readonly": true,
+              "default": "new AnimatedPanelToggle(\n    this,\n    '.agent-picker-panel',\n    AGENT_PICKER_CLOSE_MS,\n    () => this.agentPickerOpen,\n    (v) => {\n      this.agentPickerOpen = v;\n    },\n  )"
             },
             {
               "kind": "method",
-              "name": "unwireAppSettingsProvider",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
+              "name": "toggleAgentPicker"
             },
             {
               "kind": "field",
-              "name": "settingsCostCurrentSectionVisible",
+              "name": "confirmingClear",
               "type": {
                 "text": "boolean"
               },
-              "readonly": true
+              "default": "false",
+              "description": "Two-step confirm for the destructive Clear action; reset whenever the menu toggles."
             },
             {
               "kind": "field",
-              "name": "settingsCostHistorySectionVisible",
+              "name": "confirmingCompact",
               "type": {
                 "text": "boolean"
               },
-              "readonly": true
+              "default": "false"
             },
             {
               "kind": "field",
-              "name": "settingsCostSummaryVisible",
+              "name": "_sessionMenuToggle",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new AnimatedPanelToggle(\n    this,\n    '.session-menu-panel',\n    SESSION_MENU_CLOSE_MS,\n    () => this.sessionMenuOpen,\n    (v) => {\n      this.sessionMenuOpen = v;\n    },\n  )"
+            },
+            {
+              "kind": "field",
+              "name": "sessionMenuEnabled",
               "type": {
                 "text": "boolean"
               },
-              "description": "Whether the built-in Cost tab summary block has anything to show.",
+              "description": "Whether the lifecycle-menu button shows. It occupies the stop-button slot,\nso it only appears when idle (mutually exclusive with Stop). Gated on\npersistence — the menu's actions (Compact, Clear, the \"remember chat\" toggle)\nonly make sense with a provider configured, so it's hidden entirely without\none. A host can additionally force it off via `chatConfig.ui.showSessionMenu:\nfalse` even when a provider is present (e.g. a guided onboarding flow where\nclearing/compacting mid-journey would be disruptive).",
               "readonly": true
             },
             {
               "kind": "field",
-              "name": "settingsCostTabVisible",
+              "name": "persistenceToggleable",
               "type": {
                 "text": "boolean"
               },
-              "description": "Whether the Cost tab should appear in the settings modal.",
+              "description": "The persistence toggle row renders only when a provider is configured.",
               "readonly": true
             },
             {
               "kind": "field",
-              "name": "settingsSessionTokensVisible",
+              "name": "persistenceActive",
               "type": {
                 "text": "boolean"
               },
-              "description": "Whether session token usage should render on the Cost tab.",
+              "description": "Whether persistence is currently active (on + a provider) for this session.",
               "readonly": true
             },
             {
               "kind": "field",
-              "name": "settingsCogVisible",
+              "name": "compactable",
               "type": {
                 "text": "boolean"
               },
-              "description": "Whether the chat header (and settings cog) should render.",
+              "description": "Whether the menu's \"Compact\" action would do anything (GENC-1351 §5.7).\nDelegates to `driver.canCompact()` so the gate uses the exact same history\n`compact()` acts on — one source of truth. Also reads `messages`, purely to\nstay reactive as the conversation grows: the driver's history isn't a tracked\nobservable, so the button keys its re-evaluation off the Redux mirror.",
               "readonly": true
             },
             {
               "kind": "method",
-              "name": "openSettingsModal",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
+              "name": "toggleSessionMenu"
             },
             {
               "kind": "method",
-              "name": "closeSettingsModal",
-              "return": {
-                "type": {
-                  "text": "void"
+              "name": "setPersistenceEnabled",
+              "parameters": [
+                {
+                  "name": "enabled",
+                  "type": {
+                    "text": "boolean"
+                  }
                 }
-              }
+              ],
+              "description": "Set persistence on/off for this session (the menu switch). Reassigns the\n`persistence` object so the `@observable` fires. Turning it **off** drops the\nstored snapshot; **on** captures the current chat immediately. Either way the\n*choice* is remembered in the preferences blob (`persistPreferences`) — stored\nindependently of the snapshot, so it survives the clear and re-applies on the\nnext load (GENC-1351)."
             },
             {
               "kind": "method",
-              "name": "onSettingsModalClosed",
-              "return": {
+              "name": "togglePersistence",
+              "description": "Toggle persistence (convenience / programmatic)."
+            },
+            {
+              "kind": "method",
+              "name": "gatherPreferences",
+              "privacy": "private",
+              "return": {
                 "type": {
-                  "text": "void"
+                  "text": "SessionPreferences"
                 }
-              }
+              },
+              "description": "Snapshot the user-changeable settings into a persistable preferences blob."
             },
             {
               "kind": "method",
-              "name": "setSettingsModalTab",
+              "name": "persistPreferences",
+              "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
                 }
               },
-              "parameters": [
-                {
-                  "name": "tab",
-                  "type": {
-                    "text": "SettingsModalTab"
-                  }
-                }
-              ]
+              "description": "Persist the current UI preferences whenever the user changes a setting\n(GENC-1351). Fires **regardless of \"remember chat\"** — display choices are the\nuser's, not tied to whether the chat is remembered — needing only a provider\nthat implements `savePreferences`. No-op while preferences are being applied\nprogrammatically (`_applyingPreferences`), so config defaults and loaded prefs\naren't re-saved."
             },
             {
               "kind": "method",
-              "name": "onSettingsModalTabsChange",
+              "name": "applyPreferenceBaseline",
+              "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
                 }
               },
-              "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "Event"
-                  }
-                }
-              ],
-              "description": "Sync the active settings modal tab when the design-system tab bar changes."
+              "description": "Apply the effective UI-preference baseline onto the live toggles for a fresh\nstore (GENC-1351 #2). Precedence, lowest → highest:\n\n  slice defaults  <  `chatConfig.ui` defaults  <  stored user preferences\n\nRecomputed from scratch (not layered) on every call, because its two inputs\narrive at unpredictable times: `chatConfig` is a parent-supplied `@observable`\nthat may bind *after* `connectedCallback`, and stored prefs load asynchronously.\nSo it re-runs from `connectedCallback`, `chatConfigChanged`, and once\n`loadPreferences` resolves — whichever order they happen in, the final state is\nthe same. No-op once the store isn't fresh (an existing/popped-out store owns\nits state) or the user has toggled something (their choice then wins, and\n`chatConfig` doesn't change post-startup in practice). Save hook suppressed so\napplying the baseline never persists as if it were a user choice.\n\nThis is the fix for \"nuking server prefs drops to all-disabled instead of the\n`chatConfig` defaults\": stored prefs are simply absent, so the baseline falls\nthrough to the config layer — which the old apply-once-on-connect path missed\nwhenever `chatConfig` hadn't bound yet."
             },
             {
               "kind": "method",
-              "name": "resetSettingsModalTabsOnOpen",
-              "privacy": "private",
+              "name": "compactSession",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "Promise<void>"
                 }
               },
-              "description": "Ensure the settings tab is selected when the modal opens."
+              "description": "Compact the conversation (GENC-1351 §5.7) — the menu's \"Compact\" action.\nDelegates to the driver, which summarizes older turns into a single\n`compacted-summary` message (destructive, atomic). On success records a\nhigh-importance `context.compacted` meta-event capturing the summary; the\nnormal `history-updated` → autosave path then persists the smaller\ntranscript. No-op when there is nothing to compact or the provider cannot\nsummarize (the driver returns `null`)."
             },
             {
               "kind": "method",
-              "name": "resetSettingsModalTabsOnClose",
-              "privacy": "private",
+              "name": "clearSession",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "Promise<void>"
                 }
               },
-              "description": "Return to the settings tab when the modal closes on Cost."
+              "description": "Clear the session — the \"New chat\" action (GENC-1351 §5.6). Tears down the\nactive driver (firing the stateful agent's `onDeactivate` → `machine.stop()`),\nresets the store, rebuilds a fresh driver with no history, and wipes durable\nstorage. Mirrors `agentsChanged`'s teardown, minus the history reseed.\n\nEmits `session-cleared` (`SessionClearedDetail`, declared on the class `@fires`)\nwith `sessionKey`, `agentName`, and `agentSnapshot` captured *before* teardown, so\nthe host can clean up any external state the active agent was working on (generated\nfiles, server-side scratch, etc.). Bubbles and composed."
             },
             {
               "kind": "method",
-              "name": "snapSettingsModalTabIndicator",
-              "privacy": "private",
+              "name": "setAgent",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "boolean"
                 }
               },
               "parameters": [
                 {
-                  "name": "retry",
-                  "default": "true"
+                  "name": "agentName",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "{ force?: boolean }"
+                  }
                 }
               ],
-              "description": "Snap the tab underline to the settings tab without animating from Cost.\nUsed after hide/show when aria state is correct but the indicator drifted."
+              "description": "Programmatically pin an agent by name. Returns `true` if the pin was\napplied, `false` if the agent isn't in the configured agents array or\nthe call was suppressed by `force: false`.\n\nWith `force: false`, the call is a no-op when a `picker.defaultAgent` is\nconfigured and the user has already moved away from it (either by picking\nanother agent or by switching to Auto). This lets hosts seed an opinion\nwithout overriding an explicit user choice.",
+              "privacy": "public"
             },
             {
               "kind": "field",
-              "name": "pinnedAgentHint",
+              "name": "agentPickerEnabled",
               "type": {
-                "text": "string | undefined"
+                "text": "boolean"
               },
-              "description": "Hint text for the currently pinned agent, if any. Used in the toggle button tooltip.",
+              "description": "Whether the picker toggle button should appear. Mirrors the picker's own visibility rule.",
               "readonly": true
             },
             {
               "kind": "field",
-              "name": "pinLocked",
+              "name": "settingsModelSectionVisible",
               "type": {
                 "text": "boolean"
               },
-              "description": "The pin is locked when a stateful flow is mid-stream — i.e. some agent's\n`onActivate` has fired and it owns live state, and it hasn't yet called\n`releaseAgent`. Derives directly from `flowOwnerAgentName`, the\nsingle source of truth the orchestrator writes on activation and clears\non release. Until the user sends their first message, a freshly pinned\nstateful agent is not yet active and the picker should remain free; the\nuser might change their mind and unpin without anything to clean up.",
+              "description": "Whether the settings modal AI Model section has slotted app content or context usage.",
               "readonly": true
             },
             {
               "kind": "field",
-              "name": "agentToggleTitle",
+              "name": "settingsContextUsageVisible",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "Tooltip shown on the picker toggle button.",
+              "description": "Built-in context window indicator (generic platform concern).",
               "readonly": true
             },
             {
               "kind": "field",
-              "name": "pinnedAgentColour",
+              "name": "settingsAppSectionVisible",
               "type": {
-                "text": "string | undefined"
+                "text": "boolean"
               },
-              "description": "Tint applied to the pin icon when an agent is pinned. Picked from the\nbrand palette by agent position (modulo the palette length), so each agent\ngets a consistent colour across renders. `undefined` when nothing is\npinned, the agent isn't in the current array, or the host has opted out\nvia `chatConfig.picker.disablePinColours`.",
+              "description": "Whether the settings modal UI Builder section should render.",
               "readonly": true
             },
             {
               "kind": "field",
-              "name": "effectivePlaceholder",
+              "name": "appSettingsSectionTitle",
               "type": {
                 "text": "string"
               },
-              "description": "Placeholder shown in the chat input. Substitutes the pinned agent's name\nwhen one is selected so the user has a clearer signal of where their\nmessage will go; otherwise falls back to the host-provided placeholder.",
+              "description": "Section title for the app settings block.",
               "readonly": true
             },
             {
-              "kind": "method",
-              "name": "toggleShowToolCalls"
-            },
-            {
-              "kind": "method",
-              "name": "toggleShowThinkingSteps"
-            },
-            {
-              "kind": "method",
-              "name": "toggleShowNarration"
+              "kind": "field",
+              "name": "visibleAppSettingsToggles",
+              "type": {
+                "text": "AssistantAppSettingsToggle[]"
+              },
+              "description": "App toggles currently visible per each entry's `visible()` predicate.",
+              "readonly": true
             },
             {
               "kind": "method",
-              "name": "toggleShowAgentSwitchIndicator"
+              "name": "getAppSettingValue",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
-              "name": "setEnabledAnimations",
+              "name": "setAppSettingValue",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
               "parameters": [
                 {
-                  "name": "animations",
+                  "name": "id",
                   "type": {
-                    "text": "AiAssistantAnimation[]"
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "boolean"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "getDebugLog"
+              "name": "wireAppSettingsProvider",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
             },
             {
               "kind": "method",
-              "name": "downloadDebugLog"
+              "name": "unwireAppSettingsProvider",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "settingsCostCurrentSectionVisible",
+              "type": {
+                "text": "boolean"
+              },
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "settingsCostHistorySectionVisible",
+              "type": {
+                "text": "boolean"
+              },
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "settingsCostSummaryVisible",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the built-in Cost tab summary block has anything to show.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "settingsCostTabVisible",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the Cost tab should appear in the settings modal.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "settingsSessionTokensVisible",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether session token usage should render on the Cost tab.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "settingsCogVisible",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the chat header (and settings cog) should render.",
+              "readonly": true
             },
             {
               "kind": "method",
-              "name": "triggerFileInput",
+              "name": "openSettingsModal",
               "return": {
                 "type": {
                   "text": "void"
@@ -2718,24 +2928,25 @@
             },
             {
               "kind": "method",
-              "name": "handleFileSelect",
+              "name": "closeSettingsModal",
               "return": {
                 "type": {
                   "text": "void"
                 }
-              },
-              "parameters": [
-                {
-                  "name": "e",
-                  "type": {
-                    "text": "Event"
-                  }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "onSettingsModalClosed",
+              "return": {
+                "type": {
+                  "text": "void"
                 }
-              ]
+              }
             },
             {
               "kind": "method",
-              "name": "removeAttachment",
+              "name": "setSettingsModalTab",
               "return": {
                 "type": {
                   "text": "void"
@@ -2743,16 +2954,16 @@
               },
               "parameters": [
                 {
-                  "name": "attachment",
+                  "name": "tab",
                   "type": {
-                    "text": "ChatAttachment"
+                    "text": "SettingsModalTab"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "removeAttachmentError",
+              "name": "onSettingsModalTabsChange",
               "return": {
                 "type": {
                   "text": "void"
@@ -2760,239 +2971,517 @@
               },
               "parameters": [
                 {
-                  "name": "message",
+                  "name": "event",
                   "type": {
-                    "text": "string"
+                    "text": "Event"
                   }
                 }
-              ]
+              ],
+              "description": "Sync the active settings modal tab when the design-system tab bar changes."
             },
             {
               "kind": "method",
-              "name": "isAcceptedFile",
+              "name": "resetSettingsModalTabsOnOpen",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "boolean"
+                  "text": "void"
                 }
               },
-              "parameters": [
-                {
-                  "name": "file",
-                  "type": {
-                    "text": "File"
-                  }
-                }
-              ]
+              "description": "Ensure the settings tab is selected when the modal opens."
             },
             {
               "kind": "method",
-              "name": "readFileAsText",
+              "name": "resetSettingsModalTabsOnClose",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "Promise<string>"
+                  "text": "void"
                 }
               },
-              "parameters": [
-                {
-                  "name": "file",
-                  "type": {
-                    "text": "File"
-                  }
-                }
-              ]
+              "description": "Return to the settings tab when the modal closes on Cost."
             },
             {
               "kind": "method",
-              "name": "processFiles",
+              "name": "snapSettingsModalTabIndicator",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "Promise<{ attachments: ChatAttachment[]; errors: string[] }>"
+                  "text": "void"
                 }
               },
               "parameters": [
                 {
-                  "name": "files",
+                  "name": "retry",
+                  "default": "true"
+                }
+              ],
+              "description": "Snap the tab underline to the settings tab without animating from Cost.\nUsed after hide/show when aria state is correct but the indicator drifted."
+            },
+            {
+              "kind": "field",
+              "name": "pinnedAgentHint",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Hint text for the currently pinned agent, if any. Used in the toggle button tooltip.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "pinLocked",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "The pin is locked when a stateful flow is mid-stream — i.e. some agent's\n`onActivate` has fired and it owns live state, and it hasn't yet called\n`releaseAgent`. Derives directly from `flowOwnerAgentName`, the\nsingle source of truth the orchestrator writes on activation and clears\non release. Until the user sends their first message, a freshly pinned\nstateful agent is not yet active and the picker should remain free; the\nuser might change their mind and unpin without anything to clean up.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "agentToggleTitle",
+              "type": {
+                "text": "string"
+              },
+              "description": "Tooltip shown on the picker toggle button.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "pinnedAgentColour",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Tint applied to the pin icon when an agent is pinned. Picked from the\nbrand palette by agent position (modulo the palette length), so each agent\ngets a consistent colour across renders. `undefined` when nothing is\npinned, the agent isn't in the current array, or the host has opted out\nvia `chatConfig.picker.disablePinColours`.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "effectivePlaceholder",
+              "type": {
+                "text": "string"
+              },
+              "description": "Placeholder shown in the chat input. Substitutes the pinned agent's name\nwhen one is selected so the user has a clearer signal of where their\nmessage will go; otherwise falls back to the host-provided placeholder.",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "toggleShowToolCalls"
+            },
+            {
+              "kind": "method",
+              "name": "toggleShowThinkingSteps"
+            },
+            {
+              "kind": "method",
+              "name": "toggleShowNarration"
+            },
+            {
+              "kind": "method",
+              "name": "toggleShowAgentSwitchIndicator"
+            },
+            {
+              "kind": "method",
+              "name": "setEnabledAnimations",
+              "parameters": [
+                {
+                  "name": "animations",
                   "type": {
-                    "text": "File[]"
+                    "text": "AiAssistantAnimation[]"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "loadSelectedFiles",
+              "name": "getDebugLog",
+              "return": {
+                "type": {
+                  "text": "DebugLog"
+                }
+              },
+              "description": "The live current-page debug log (`{ readme, timeline, meta }`). @public"
+            },
+            {
+              "kind": "method",
+              "name": "buildDiagnosticEntries",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "Promise<void>"
+                  "text": "DiagnosticEntry[]"
                 }
               },
-              "parameters": [
-                {
-                  "name": "e",
-                  "type": {
-                    "text": "Event"
-                  }
+              "description": "Build the current page's diagnostic entries (GENC-1351 §5.8) — the debug-log\ntimeline entries (`message`/`turn`/`event`) plus one `meta-snapshot` carrying\nthe export-time `meta` block. `getDebugLog()` reassembles these into the live\nlog; the persister's forward-capture path (`SessionPersister.flushDiagnostics`,\nfed these via the `getDiagnosticEntries` dep) diffs them against what's already\nbeen appended to the persisted stream."
+            },
+            {
+              "kind": "method",
+              "name": "downloadDebugLog",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
                 }
-              ]
+              }
             },
             {
               "kind": "method",
-              "name": "handleSendClick"
+              "name": "buildDownloadLog",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<DebugLog>"
+                }
+              },
+              "description": "The log to download (GENC-1351 §5.8). When the provider persists diagnostics,\nstitch the **whole lifetime** stream (every page load) rather than just the\ncurrent page's in-memory view: flush the current delta first so it's included,\nthen reassemble everything `loadDiagnostics` returns. Independent of \"remember\nchat\" — diagnostics are a forensic stream keyed on provider capability, not on\nwhether the *chat* is remembered (like preferences). Falls back to the live\ncurrent-page log when diagnostics isn't available or the fetch fails."
             },
             {
               "kind": "method",
-              "name": "handleStopClick",
-              "description": "User clicked Stop. Cancels the current turn via the driver and flips the\nbutton to \"Stopping…\" until the turn winds down (a tool mid-execution\nfinishes first). Guarded so a second click is a no-op."
+              "name": "persister",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "SessionPersister | undefined"
+                }
+              },
+              "description": "The shared per-session `SessionPersister` that owns restore-core\nsave/restore/freeze (GENC-1351 §5.10). Created once per `stateKey` and shared by\nevery element view (bubble + panel) via the registry, so there is a single save\ntimer + carry-forward cache — no per-view double-writes. The deps are getters so\nthe persister always reads the current driver/store/config and never holds a\nstale reference. `undefined` before the session key is available."
             },
             {
               "kind": "method",
-              "name": "handleSuggestionClick",
+              "name": "buildPersisterDeps",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "SessionPersisterDeps"
+                }
+              },
               "parameters": [
                 {
-                  "name": "suggestion",
+                  "name": "key",
                   "type": {
                     "text": "string"
                   }
                 }
-              ]
+              ],
+              "description": "The `SessionPersister` dependency getters bound to THIS element + `key`.\nThe host-owned getters (`getPersistence`/`getAgentNames`/`getDiagnosticEntries`)\nread the live element; `getDriver`/`getStore` resolve by key from the registries.\nRebound onto the shared persister on every activation (see `activateSession`) so\na remounted element becomes the live source, not the torn-down creator (GENC-1351 §5.10 / #7)."
             },
             {
               "kind": "method",
-              "name": "submitMessage",
+              "name": "initPersistenceForNewStore",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "Promise<SubmitMessageResult>"
+                  "text": "Promise<void>"
                 }
               },
               "parameters": [
                 {
-                  "name": "input",
+                  "name": "key",
                   "type": {
-                    "text": "{ text?: string; files?: File[] }"
+                    "text": "string"
                   }
                 }
               ],
-              "description": "Programmatically submit a message. Equivalent to the user typing into the\nbuilt-in composer and pressing send, but callable from external code — most\ncommonly a custom input rendered inside `slot=\"splash\"` when paired with\n`chatConfig.ui.hideComposer`.\n\nThe input fully describes the turn: `text` and `files` REPLACE any current\ncomposer state (they are not appended to it). Files are validated against\n`chatConfig.ui.acceptedFiles` using the same pipeline as the composer's\nattach button.\n\nAtomic on validation: if any file fails validation, no attachments are\ncommitted and no send is dispatched. Failure messages are returned in\n`errors` AND appended to the `attachmentErrors` observable so the built-in\nchip UI still surfaces them when visible.\n\nResolves once the underlying send has been kicked off — it does NOT await\nthe assistant's response."
-            },
-            {
-              "kind": "method",
-              "name": "fetchSuggestions",
-              "privacy": "private"
+              "description": "First-load persistence init for a freshly created store (GENC-1351). Restores\nthe user's remembered persistence-toggle choice — kept independently of the\nsession snapshot so it survives a clear; the host-configured `enabled` is only\nthe default for a first-ever load — then auto-restores the session when\npersistence is (now) on."
             },
             {
               "kind": "method",
-              "name": "send",
-              "privacy": "private"
+              "name": "triggerFileInput",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
             },
             {
               "kind": "method",
-              "name": "onChatHeaderMouseDown",
+              "name": "handleFileSelect",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
               "parameters": [
                 {
                   "name": "e",
                   "type": {
-                    "text": "MouseEvent"
+                    "text": "Event"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "handleInteractionCompleted",
+              "name": "removeAttachment",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
               "parameters": [
                 {
-                  "name": "e",
+                  "name": "attachment",
                   "type": {
-                    "text": "Event"
+                    "text": "ChatAttachment"
                   }
                 }
               ]
             },
             {
-              "kind": "field",
-              "name": "isComposerResizable",
-              "type": {
-                "text": "boolean"
+              "kind": "method",
+              "name": "removeAttachmentError",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "description": "Whether the message input shows a drag handle to resize its height.\nOn by default; hosts opt out via `chatConfig.ui.resizableInput: false`.",
-              "readonly": true
+              "parameters": [
+                {
+                  "name": "message",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
             },
             {
-              "kind": "field",
-              "name": "composerHeightStyle",
-              "type": {
-                "text": "string"
+              "kind": "method",
+              "name": "isAcceptedFile",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
               },
-              "description": "Inline style for the chat input: writes the chosen height into the\n`--composer-height` custom property (read by `.chat-input` + its control in\n`main.styles.ts`). Empty until the user drags (or when resizing is disabled),\nso the default applies.",
-              "readonly": true
+              "parameters": [
+                {
+                  "name": "file",
+                  "type": {
+                    "text": "File"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
-              "name": "onComposerResizeStart",
+              "name": "readFileAsText",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "Promise<string>"
                 }
               },
               "parameters": [
                 {
-                  "name": "e",
+                  "name": "file",
                   "type": {
-                    "text": "PointerEvent"
+                    "text": "File"
                   }
                 }
-              ],
-              "description": "Begin a composer resize drag. Captures the pointer so move/up keep firing\non the handle even when the cursor leaves its 7px band."
+              ]
             },
             {
               "kind": "method",
-              "name": "onComposerResizeMove",
+              "name": "processFiles",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "Promise<{ attachments: ChatAttachment[]; errors: string[] }>"
                 }
               },
               "parameters": [
                 {
-                  "name": "e",
+                  "name": "files",
                   "type": {
-                    "text": "PointerEvent"
+                    "text": "File[]"
                   }
                 }
-              ],
-              "description": "Resize while dragging. Dragging up (clientY decreases) grows the composer;\nthe result is clamped between the natural height (lower) and the available\nheadroom/max (upper). No-op unless a drag is active (the handle holds pointer\ncapture), so plain hover-moves are ignored."
+              ]
             },
             {
               "kind": "method",
-              "name": "onComposerResizeEnd",
+              "name": "loadSelectedFiles",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "Promise<void>"
                 }
               },
               "parameters": [
                 {
                   "name": "e",
                   "type": {
-                    "text": "PointerEvent"
+                    "text": "Event"
                   }
                 }
-              ],
-              "description": "End a resize drag and release the pointer capture."
-            }
-          ],
-          "events": [
+              ]
+            },
             {
-              "name": "chat-header-mousedown",
-              "type": {
-                "text": "CustomEvent"
-              },
-              "description": "Fired when the user presses the chat header in `popout-mode=\"expand\"` (for drag-to-popout hosts). Bubbles and composed. detail: `ChatHeaderMousedownEventDetail`"
-            }
+              "kind": "method",
+              "name": "handleSendClick"
+            },
+            {
+              "kind": "method",
+              "name": "handleStopClick",
+              "description": "User clicked Stop. Cancels the current turn via the driver and flips the\nbutton to \"Stopping…\" until the turn winds down (a tool mid-execution\nfinishes first). Guarded so a second click is a no-op."
+            },
+            {
+              "kind": "method",
+              "name": "handleSuggestionClick",
+              "parameters": [
+                {
+                  "name": "suggestion",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "submitMessage",
+              "return": {
+                "type": {
+                  "text": "Promise<SubmitMessageResult>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "input",
+                  "type": {
+                    "text": "{ text?: string; files?: File[] }"
+                  }
+                }
+              ],
+              "description": "Programmatically submit a message. Equivalent to the user typing into the\nbuilt-in composer and pressing send, but callable from external code — most\ncommonly a custom input rendered inside `slot=\"splash\"` when paired with\n`chatConfig.ui.hideComposer`.\n\nThe input fully describes the turn: `text` and `files` REPLACE any current\ncomposer state (they are not appended to it). Files are validated against\n`chatConfig.ui.acceptedFiles` using the same pipeline as the composer's\nattach button.\n\nAtomic on validation: if any file fails validation, no attachments are\ncommitted and no send is dispatched. Failure messages are returned in\n`errors` AND appended to the `attachmentErrors` observable so the built-in\nchip UI still surfaces them when visible.\n\nResolves once the underlying send has been kicked off — it does NOT await\nthe assistant's response."
+            },
+            {
+              "kind": "method",
+              "name": "fetchSuggestions",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_pendingSendPrompt",
+              "type": {
+                "text": "string | undefined"
+              },
+              "privacy": "private",
+              "description": "User text of the message currently being sent, stashed for the lifetime of `send()`.\n`flow-owner-changed` fires while the driver routes this turn — before the message is\nappended to raw history — so the flow-activation-prompt capture reads this rather than\na stale raw-history lookup. Cleared once the send settles. (GENC-1351 §5.9)"
+            },
+            {
+              "kind": "method",
+              "name": "send",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "onChatHeaderMouseDown",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "MouseEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "handleInteractionCompleted",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "isComposerResizable",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the message input shows a drag handle to resize its height.\nOn by default; hosts opt out via `chatConfig.ui.resizableInput: false`.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "composerHeightStyle",
+              "type": {
+                "text": "string"
+              },
+              "description": "Inline style for the chat input: writes the chosen height into the\n`--composer-height` custom property (read by `.chat-input` + its control in\n`main.styles.ts`). Empty until the user drags (or when resizing is disabled),\nso the default applies.",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "onComposerResizeStart",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "PointerEvent"
+                  }
+                }
+              ],
+              "description": "Begin a composer resize drag. Captures the pointer so move/up keep firing\non the handle even when the cursor leaves its 7px band."
+            },
+            {
+              "kind": "method",
+              "name": "onComposerResizeMove",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "PointerEvent"
+                  }
+                }
+              ],
+              "description": "Resize while dragging. Dragging up (clientY decreases) grows the composer;\nthe result is clamped between the natural height (lower) and the available\nheadroom/max (upper). No-op unless a drag is active (the handle holds pointer\ncapture), so plain hover-moves are ignored."
+            },
+            {
+              "kind": "method",
+              "name": "onComposerResizeEnd",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "PointerEvent"
+                  }
+                }
+              ],
+              "description": "End a resize drag and release the pointer capture."
+            }
+          ],
+          "events": [
+            {
+              "type": {
+                "text": "CustomEvent"
+              }
+            },
+            {
+              "description": "Fired when the user presses the chat header in `popout-mode=\"expand\"` (for drag-to-popout hosts). Bubbles and composed. detail: `ChatHeaderMouseDownDetail`",
+              "name": "chat-header-mousedown"
+            },
+            {
+              "description": "Fired after the session is wiped (the lifecycle menu's Clear). The payload is captured before teardown so the host can clean up any external state the active agent was working on. Bubbles and composed. detail: `SessionClearedDetail`",
+              "name": "session-cleared"
+            }
           ],
           "attributes": [
             {
@@ -3003,6 +3492,14 @@
               "default": "'Genesis Assistant'",
               "fieldName": "headerTitle"
             },
+            {
+              "name": "session-key",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Explicit session/persistence key (GENC-1351 §5.12). When set, this is the\nsession identity — the key for the driver/store/persister/diagnostics\nregistries and the `sessionKey` passed to the persistence provider — taking\nprecedence over the DOM `id`. A host that scopes persistence per-entity\n(e.g. one chat session per project) binds this to a stable per-entity id;\nchanging it on a **connected** element re-keys the session in place — tears\ndown the current conversation and restores the new key's — via\n`switchSession`. Falls back to `id` when unset,\nso existing consumers are unaffected.",
+              "fieldName": "sessionKey"
+            },
             {
               "name": "image-src",
               "type": {
@@ -3098,6 +3595,15 @@
       "kind": "javascript-module",
       "path": "src/main/main.types.ts",
       "declarations": [
+        {
+          "kind": "variable",
+          "name": "AiAssistantEvent",
+          "type": {
+            "text": "{\n  /** Session wiped via the lifecycle menu's Clear. `detail`: `SessionClearedDetail`. */\n  SessionCleared: 'session-cleared',\n  /** Header pressed in `popout-mode=\"expand\"` (drag-to-popout hosts). `detail`: `ChatHeaderMouseDownDetail`. */\n  ChatHeaderMouseDown: 'chat-header-mousedown',\n}"
+          },
+          "default": "{\n  /** Session wiped via the lifecycle menu's Clear. `detail`: `SessionClearedDetail`. */\n  SessionCleared: 'session-cleared',\n  /** Header pressed in `popout-mode=\"expand\"` (drag-to-popout hosts). `detail`: `ChatHeaderMouseDownDetail`. */\n  ChatHeaderMouseDown: 'chat-header-mousedown',\n}",
+          "description": "DOM events the `<foundation-ai-assistant>` element dispatches to its host.\nAll bubble and are `composed` (they cross the shadow boundary), so a host can\nlisten on the element — or any ancestor — to react. Use these constants to\nwire listeners instead of hand-typing event-name strings.\n\nAn `as const` map (not a TS `enum` — this package ships none), so it serves as\nboth the listener-name value and, via the same-named type below, a union."
+        },
         {
           "kind": "variable",
           "name": "ANIMATION_DEFS",
@@ -3127,6 +3633,14 @@
             "package": "@genesislcap/foundation-ai"
           }
         },
+        {
+          "kind": "js",
+          "name": "AiAssistantEvent",
+          "declaration": {
+            "name": "AiAssistantEvent",
+            "module": "src/main/main.types.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "ANIMATION_DEFS",
@@ -3199,13 +3713,22 @@
       "kind": "javascript-module",
       "path": "src/state/ai-assistant-slice.ts",
       "declarations": [
+        {
+          "kind": "function",
+          "name": "createDefaultSessionState",
+          "return": {
+            "type": {
+              "text": "AiAssistantSessionState"
+            }
+          },
+          "description": "Build a fresh default session state. A factory (not just a shared const) so\neach call returns independent collections — `resetSession` can hand back a\nclean slate without aliasing the initial state's arrays."
+        },
         {
           "kind": "variable",
           "name": "defaultSessionState",
           "type": {
             "text": "AiAssistantSessionState"
-          },
-          "default": "{\n  messages: [],\n  state: 'idle',\n  showToolCalls: false,\n  showThinkingSteps: false,\n  showNarration: false,\n  showAgentSwitchIndicator: false,\n  enabledAnimations: [],\n  suggestionsState: { status: 'idle' },\n  contextTokens: undefined,\n  contextLimit: undefined,\n  sessionCostUsd: 0,\n  sessionTokensConsumed: 0,\n  activeModel: undefined,\n  activeProviderName: undefined,\n  providerStatuses: [],\n  activeAgent: undefined,\n  pinnedAgentName: null,\n  flowOwnerAgentName: null,\n  agentPickerOpen: false,\n  inputValue: '',\n  liveSubAgentTrace: [],\n  liveSubAgentName: null,\n  inputOverrides: [],\n}"
+          }
         },
         {
           "kind": "variable",
@@ -3213,6 +3736,14 @@
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "createDefaultSessionState",
+          "declaration": {
+            "name": "createDefaultSessionState",
+            "module": "src/state/ai-assistant-slice.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "defaultSessionState",
@@ -3241,7 +3772,7 @@
           "type": {
             "text": "Record<MetaEventType, MetaEventImportance>"
           },
-          "default": "{\n  'turn.error': 'high',\n  'tool.failed': 'high',\n  'subagent.failed': 'high',\n  'file.read-failed': 'high',\n  'suggestions.failed': 'high',\n  'context.threshold-crossed': 'high',\n\n  'assistant.connected': 'normal',\n  'assistant.disconnected': 'normal',\n  'assistant.popout': 'normal',\n  'assistant.popin': 'normal',\n  'driver.created': 'normal',\n  'state.changed': 'normal',\n  'turn.start': 'normal',\n  'turn.end': 'normal',\n  'turn.retry': 'normal',\n  'tool.unresolved': 'normal',\n  'subagent.started': 'normal',\n  'subagent.completed': 'normal',\n  'agent.handoff': 'normal',\n  'agent.pinned': 'normal',\n  'agent.unpinned': 'normal',\n  'provider.selected': 'normal',\n  'interaction.requested': 'normal',\n  'interaction.resolved': 'normal',\n\n  'driver.wired': 'low',\n  'driver.unwired': 'low',\n  'context.updated': 'low',\n  'context.condensed': 'low',\n  'panel.toggled': 'low',\n  'attachment.added': 'low',\n}",
+          "default": "{\n  'turn.error': 'high',\n  'tool.failed': 'high',\n  'subagent.failed': 'high',\n  'file.read-failed': 'high',\n  'suggestions.failed': 'high',\n  'context.threshold-crossed': 'high',\n  'context.compacted': 'high',\n  'persistence.restore-orphan': 'high',\n\n  'assistant.connected': 'normal',\n  'assistant.disconnected': 'normal',\n  'assistant.popout': 'normal',\n  'assistant.popin': 'normal',\n  'driver.created': 'normal',\n  'state.changed': 'normal',\n  'turn.start': 'normal',\n  'turn.end': 'normal',\n  'turn.retry': 'normal',\n  'tool.unresolved': 'normal',\n  'subagent.started': 'normal',\n  'subagent.completed': 'normal',\n  'agent.handoff': 'normal',\n  'agent.pinned': 'normal',\n  'agent.unpinned': 'normal',\n  'provider.selected': 'normal',\n  'interaction.requested': 'normal',\n  'interaction.resolved': 'normal',\n  'session.cleared': 'normal',\n  'session.switched': 'low',\n  'session.switch-deferred': 'low',\n  'persistence.restored': 'normal',\n  'persistence.suppressed': 'normal',\n  'persistence.not-resumable': 'normal',\n\n  'driver.wired': 'low',\n  'driver.unwired': 'low',\n  'context.updated': 'low',\n  'context.condensed': 'low',\n  'panel.toggled': 'low',\n  'persistence.toggled': 'low',\n  'persistence.saved': 'low',\n  'attachment.added': 'low',\n}",
           "description": "Importance is intrinsic to the event *type*, not the instance, so it's\ndefined once here and stamped automatically by recordMetaEvent — call\nsites never pass it. The `Record` is exhaustive: adding a `MetaEventType`\nwithout a level here is a compile error.\n\n- `high`   — failures and hard limits you almost always want to see.\n- `normal` — meaningful session flow you read to follow what happened.\n- `low`    — frequent UI / bookkeeping noise, usually safe to skip."
         },
         {
@@ -4437,54 +4968,192 @@
             }
           ],
           "description": "Applies a history cap for sub-agent context: the last `cap` messages are passed\nverbatim; older messages have their tool payloads masked."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "transformHistoryForAgent",
-          "declaration": {
-            "name": "transformHistoryForAgent",
-            "module": "src/utils/history-transform.ts"
-          }
         },
         {
-          "kind": "js",
-          "name": "applyHistoryCap",
-          "declaration": {
-            "name": "applyHistoryCap",
-            "module": "src/utils/history-transform.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/utils/index.ts",
-      "declarations": [],
-      "exports": [
+          "kind": "variable",
+          "name": "COMPACT_KEEP_RECENT_MESSAGES",
+          "type": {
+            "text": "number"
+          },
+          "default": "4",
+          "description": "Recent messages kept verbatim when compacting; everything earlier is summarized."
+        },
         {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./animated-panel-toggle"
-          }
+          "kind": "variable",
+          "name": "COMPACT_MIN_MESSAGES_TO_COMPACT",
+          "type": {
+            "text": "number"
+          },
+          "default": "4",
+          "description": "Don't bother compacting unless at least this many messages would be summarized."
         },
         {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./logger"
-          }
+          "kind": "function",
+          "name": "findCompactionCut",
+          "return": {
+            "type": {
+              "text": "number | null"
+            }
+          },
+          "parameters": [
+            {
+              "name": "history",
+              "type": {
+                "text": "readonly ChatMessage[]"
+              }
+            }
+          ],
+          "description": "Index at which the verbatim tail begins — everything before it gets summarized.\nThe tail starts on a clean turn boundary (a `user` message): a user message\nnever appears between a `tool_use` and its `tool_result`, so cutting there\nguarantees the summarized region is tool-pair-balanced (compaction only runs\nwhen idle, so history is turn-complete). Returns `null` when there is nothing\nworth compacting (too short, or no earlier user boundary) — e.g. a freshly\nrestored session whose only user turn is the current one."
         },
         {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./tool-fold"
+          "kind": "function",
+          "name": "buildCompactionSummaryPrompt",
+          "return": {
+            "type": {
+              "text": "{\n  systemPrompt: string;\n  userMessage: string;\n}"
+            }
+          },
+          "parameters": [
+            {
+              "name": "toCompact",
+              "type": {
+                "text": "readonly ChatMessage[]"
+              }
+            }
+          ],
+          "description": "Build the one-shot summarizer prompt for a run of older messages (used with\n`AIProvider.prompt`). Mirrors the `<conversation_history>` block convention\nthat suggestions use. Any existing `compacted-summary` at the head is folded\nin (rendered as prior-summary context), so rolling re-compaction produces one\ncombined summary."
+        },
+        {
+          "kind": "function",
+          "name": "normalizeForProvider",
+          "return": {
+            "type": {
+              "text": "ChatMessage[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "history",
+              "type": {
+                "text": "readonly ChatMessage[]"
+              }
+            }
+          ],
+          "description": "Normalize history for a provider request (GENC-1351 §5.7): translate each\n`compacted-summary` message into a `user` message that wraps its summary in a\n`<conversation_summary>` block, so the raw display-only role never reaches a\ntransport. Other roles pass through untouched. Pure — returns a new array.\n\nApplied at the request-build chokepoint *before* per-agent masking, so the\nguarantee holds for every provider/transport regardless of any optional\nper-agent history transform."
+        },
+        {
+          "kind": "function",
+          "name": "compactionDividerLabel",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "m",
+              "type": {
+                "text": "ChatMessage"
+              }
+            }
+          ],
+          "description": "Human-facing divider label for a `compacted-summary` message."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "transformHistoryForAgent",
+          "declaration": {
+            "name": "transformHistoryForAgent",
+            "module": "src/utils/history-transform.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "applyHistoryCap",
+          "declaration": {
+            "name": "applyHistoryCap",
+            "module": "src/utils/history-transform.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "COMPACT_KEEP_RECENT_MESSAGES",
+          "declaration": {
+            "name": "COMPACT_KEEP_RECENT_MESSAGES",
+            "module": "src/utils/history-transform.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "COMPACT_MIN_MESSAGES_TO_COMPACT",
+          "declaration": {
+            "name": "COMPACT_MIN_MESSAGES_TO_COMPACT",
+            "module": "src/utils/history-transform.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "findCompactionCut",
+          "declaration": {
+            "name": "findCompactionCut",
+            "module": "src/utils/history-transform.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "buildCompactionSummaryPrompt",
+          "declaration": {
+            "name": "buildCompactionSummaryPrompt",
+            "module": "src/utils/history-transform.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "normalizeForProvider",
+          "declaration": {
+            "name": "normalizeForProvider",
+            "module": "src/utils/history-transform.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "compactionDividerLabel",
+          "declaration": {
+            "name": "compactionDividerLabel",
+            "module": "src/utils/history-transform.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./animated-panel-toggle"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./logger"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./tool-fold"
           }
         }
       ]
@@ -4513,6 +5182,24 @@
       "kind": "javascript-module",
       "path": "src/utils/message-partition.ts",
       "declarations": [
+        {
+          "kind": "function",
+          "name": "isSessionNoticeMarker",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "m",
+              "type": {
+                "text": "ChatMessage"
+              }
+            }
+          ],
+          "description": "Either restore notice — both display-only, stripped before persist. @internal"
+        },
         {
           "kind": "function",
           "name": "trailingInteractionRow",
@@ -4557,6 +5244,14 @@
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "isSessionNoticeMarker",
+          "declaration": {
+            "name": "isSessionNoticeMarker",
+            "module": "src/utils/message-partition.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "trailingInteractionRow",
@@ -4609,6 +5304,12 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/resolve-preference-baseline.ts",
+      "declarations": [],
+      "exports": []
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/strip-agent-handlers.ts",
@@ -4721,6 +5422,12 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/with-timeout.ts",
+      "declarations": [],
+      "exports": []
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/activity-halo/activity-halo.ts",
@@ -5654,29 +6361,6 @@
               "privacy": "private",
               "default": "new Map<\n    string,\n    {\n      resolve: (value: any) => void;\n      reject: (reason?: any) => void;\n      /** Present when the call requested a chat-input override. */\n      overrideId?: string;\n      /** Present when the call set `timeoutMs`; cleared on resolution. */\n      timeoutHandle?: ReturnType<typeof setTimeout>;\n    }\n  >()"
             },
-            {
-              "kind": "field",
-              "name": "hosts",
-              "privacy": "private",
-              "default": "new Set<string>()",
-              "description": "Assistant host ids currently wired to this driver, in registration (insertion) order."
-            },
-            {
-              "kind": "field",
-              "name": "lastActiveHostId",
-              "type": {
-                "text": "string | undefined"
-              },
-              "privacy": "private",
-              "description": "The host whose subtree the user most recently interacted in — the primary owner signal."
-            },
-            {
-              "kind": "field",
-              "name": "startedSideEffects",
-              "privacy": "private",
-              "default": "new Map<string, string>()",
-              "description": "Interaction id → host id that claimed its side effect (first-writer-wins latch)."
-            },
             {
               "kind": "field",
               "name": "systemPrompt",
@@ -6536,101 +7220,32 @@
             },
             {
               "kind": "method",
-              "name": "isBusy",
+              "name": "canCompact",
               "return": {
                 "type": {
                   "text": "boolean"
                 }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "registerHost",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "hostId",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "Register an assistant view (host) wired to this shared driver. @internal"
-            },
-            {
-              "kind": "method",
-              "name": "unregisterHost",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
               },
-              "parameters": [
-                {
-                  "name": "hostId",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "Deregister a host on unwire/disconnect. @internal"
+              "description": "Whether `compact()` would do anything right now — a summarizable run of older\nturns exists behind a clean boundary. Uses the same `history` `compact()`\nacts on, so the UI's gate can't disagree with the action (GENC-1351 follow-up)."
             },
             {
               "kind": "method",
-              "name": "setActiveHost",
+              "name": "compact",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "Promise<ChatMessage | null>"
                 }
               },
-              "parameters": [
-                {
-                  "name": "hostId",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "Record the host whose subtree the user most recently interacted in — the primary signal for\nelecting which single view renders an interaction's widget. Sticky (unlike focus): it only\nmoves when the user actually uses a different assistant view, not when they click elsewhere\nin the layout. @internal"
+              "description": "Destructively compact older turns into a single `compacted-summary` message\n(GENC-1351 §5.7). Summarizes everything before a clean recent-tail boundary\nvia the registry-default provider's one-shot `prompt()`, then **atomically**\nreplaces the covered turns with one summary message at the head — history is\nmutated only on success. Rolling: any existing head summary is folded into\nthe new one. Returns the created summary message, or `null` when there is\nnothing worth compacting or the default provider cannot summarize."
             },
             {
               "kind": "method",
-              "name": "claimSideEffect",
+              "name": "isBusy",
               "return": {
                 "type": {
                   "text": "boolean"
                 }
-              },
-              "parameters": [
-                {
-                  "name": "interactionId",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "hostId",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "First-writer-wins latch guarding a side effect. A host claims before rendering the live\nwidget: the first host to claim an interaction id gets `true` (run it); a *different* host\ngets `false` (render passive, do NOT re-fire). Re-claim by the SAME host returns `true`, so a\nbenign re-render of the owner keeps its widget. Single-threaded, so check-and-set is race-free\n— the backstop that makes duplicate execution impossible even if owner election ever slips. @internal"
-            },
-            {
-              "kind": "method",
-              "name": "electInteractionOwner",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "string | undefined"
-                }
-              },
-              "description": "Elect the single host that owns (renders + runs) an interaction's widget: the most-recently-\nactive host if still connected, else a deterministic default (first registered host — `Set`\npreserves insertion order) so exactly one owner is always chosen. Returns `undefined` only when\nno host is registered, in which case the interaction renders everywhere (fail-open) not nowhere."
+              }
             },
             {
               "kind": "method",
@@ -7205,15 +7820,6 @@
               "default": "undefined",
               "description": "The resolved result once the interaction has completed. Forwarded to the rendered component. @internal"
             },
-            {
-              "kind": "field",
-              "name": "ownerHostId",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "GENC-1410 (Error 3): id of the host the driver elected to render (and thus run) this\ninteraction. When several views share one driver, only the matching host renders the live\nwidget; others show a passive placeholder so the widget fires once. Empty = no owner elected\n(single view, or none registered) → render everywhere (fail-open). @internal"
-            },
             {
               "kind": "field",
               "name": "_resizeObserver",
@@ -7513,6 +8119,16 @@
               "default": "null",
               "description": "Transient flow lock — set when a stateful agent's `onActivate` fires,\ncleared by `releaseActiveAgent`. While non-null, routing precedence goes\nto this agent and the picker is locked. Independent of\n`pinnedAgentName` so completing a flow doesn't wipe the user's sticky\nchoice."
             },
+            {
+              "kind": "field",
+              "name": "restoredAgentStates",
+              "type": {
+                "text": "Record<string, unknown>"
+              },
+              "privacy": "private",
+              "default": "{}",
+              "description": "Per-agent restored state for a rehydrated session, keyed by agent name.\nPrimed by the host on restore; each entry is passed to that agent's\n`onActivate` as `ctx.restored` on its next activation, then deleted so a\nlater re-activation starts fresh."
+            },
             {
               "kind": "field",
               "name": "activeAgent",
@@ -7554,84 +8170,10 @@
             },
             {
               "kind": "method",
-              "name": "registerHost",
+              "name": "getActiveProviderName",
               "return": {
                 "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "hostId",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "unregisterHost",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "hostId",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "setActiveHost",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "hostId",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "claimSideEffect",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "interactionId",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "hostId",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "getActiveProviderName",
-              "return": {
-                "type": {
-                  "text": "string"
+                  "text": "string"
                 }
               },
               "description": "Currently active provider name from the underlying ChatDriver."
@@ -7698,6 +8240,26 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "compact",
+              "return": {
+                "type": {
+                  "text": "Promise<ChatMessage | null>"
+                }
+              },
+              "description": "{@inheritDoc AiDriver.compact}"
+            },
+            {
+              "kind": "method",
+              "name": "canCompact",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "{@inheritDoc AiDriver.canCompact}"
+            },
             {
               "kind": "method",
               "name": "getTurnSnapshots",
@@ -7786,6 +8348,34 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "primeRestoredAgentState",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "snapshots",
+                  "type": {
+                    "text": "Record<string, unknown>"
+                  }
+                }
+              ],
+              "description": "{@inheritDoc AiDriver.primeRestoredAgentState}"
+            },
+            {
+              "kind": "method",
+              "name": "getActiveAgent",
+              "return": {
+                "type": {
+                  "text": "AgentConfig | undefined"
+                }
+              },
+              "description": "{@inheritDoc AiDriver.getActiveAgent}"
+            },
             {
               "kind": "method",
               "name": "applyAgent",
@@ -7986,12 +8576,13 @@
             },
             {
               "kind": "field",
-              "name": "collapseEl",
+              "name": "assistantEl",
               "type": {
                 "text": "HTMLElement | null"
               },
               "privacy": "private",
-              "default": "null"
+              "default": "null",
+              "description": "The single assistant element. Captured while it's in the bubble slot and held\nacross the move (it's the same instance whether docked or in the bubble), so\npop-in can re-home it even though it's no longer a child of this manager."
             },
             {
               "kind": "field",
@@ -8019,6 +8610,52 @@
               },
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "findAssistant",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | null"
+                }
+              },
+              "description": "Locate the assistant element currently slotted into the bubble."
+            },
+            {
+              "kind": "method",
+              "name": "adoptAssistant",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "el",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                },
+                {
+                  "name": "docked",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Register an externally-created assistant element and its docked state. For\nsingle-element hosts that create the assistant directly in a layout pane (rather\nthan statically in the bubble), so the manager tracks the one element, whether it's\ncurrently docked (for pop-in re-homing), reflects the right `popout-mode` on it\n(drives the header button), and hides the empty bubble."
+            },
+            {
+              "kind": "method",
+              "name": "syncBubbleVisibility",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Hide the floating bubble unless it currently contains the assistant."
+            },
             {
               "kind": "method",
               "name": "canDockChanged"
@@ -8075,7 +8712,7 @@
               "text": "boolean"
             }
           },
-          "description": "True when the collapse-mode assistant is active in the layout panel."
+          "description": "True when the assistant is active in the layout panel (docked) rather than the bubble."
         },
         {
           "kind": "function",
@@ -8169,7 +8806,7 @@
         {
           "kind": "variable",
           "name": "settingsModalStyles",
-          "default": "css`\n  *,\n  *::before,\n  *::after {\n    box-sizing: border-box;\n  }\n\n  .settings-modal {\n    --ai-tier-badge-bg-mix: 14%;\n    --ai-tier-badge-text-lighten: 18%;\n  }\n\n  .settings-modal::part(dialog) {\n    max-width: 620px;\n    width: calc(100vw - 48px);\n    max-height: calc(100vh - 48px);\n    padding: 0;\n  }\n\n  .settings-modal::part(content) {\n    display: flex;\n    flex-direction: column;\n    min-height: 0;\n    padding: 0;\n    width: 100%;\n  }\n\n  .settings-modal::part(top) {\n    padding: calc(var(--design-unit) * 4px) calc(var(--design-unit) * 5px);\n    border-bottom: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-modal::part(bottom) {\n    padding: calc(var(--design-unit) * 4px) calc(var(--design-unit) * 5px);\n    border-top: 1px solid var(--neutral-stroke-rest);\n    border-bottom-left-radius: var(--card-border-radius, calc(var(--control-corner-radius) * 1px));\n    border-bottom-right-radius: var(--card-border-radius, calc(var(--control-corner-radius) * 1px));\n    background-color: var(--neutral-layer-2);\n  }\n\n  .settings-modal-header {\n    display: flex;\n    align-items: center;\n    min-width: 0;\n  }\n\n  .settings-modal-title {\n    margin: 0;\n    font-size: 16px;\n    font-weight: 600;\n    display: flex;\n    align-items: center;\n    gap: calc(var(--design-unit) * 2px);\n    color: var(--neutral-foreground-rest);\n  }\n\n  .settings-modal-content {\n    display: flex;\n    flex-direction: column;\n    min-height: 0;\n    flex: 1 1 auto;\n  }\n\n  .settings-modal-tabs::part(tablist) {\n    border-bottom: 0;\n    padding: 0 calc(var(--design-unit) * 5px);\n    column-gap: calc(var(--design-unit) * 5px);\n  }\n\n  .settings-modal-tabs::part(activeIndicator) {\n    height: 2px;\n  }\n\n  .settings-modal-tab {\n    padding: 0;\n    font-weight: 600;\n    gap: 6px;\n  }\n\n  .settings-modal-tab[aria-selected='true'] {\n    color: var(--neutral-foreground-rest);\n  }\n\n  .settings-modal-tabs::part(tabpanel) {\n    border-top: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-modal-tab-panel {\n    display: flex;\n    flex-direction: column;\n    min-height: 0;\n    flex: 1 1 auto;\n    padding: 0;\n    border-radius: 0;\n  }\n\n  .settings-modal-tab-panel[hidden] {\n    display: none !important;\n  }\n\n  .settings-modal-body {\n    overflow-y: auto;\n    padding: 0 calc(var(--design-unit) * 5px) calc(var(--design-unit) * 2px);\n    max-height: min(60vh, 520px);\n  }\n\n  .settings-modal-section {\n    padding: calc(var(--design-unit) * 5px) 0;\n    border-bottom: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-modal-section:last-child {\n    border-bottom: none;\n  }\n\n  .settings-modal-section-title {\n    margin: 0 0 calc(var(--design-unit) * 3px);\n    font-size: 11px;\n    font-weight: 600;\n    letter-spacing: 0.08em;\n    text-transform: uppercase;\n    color: var(--neutral-foreground-hint);\n    display: flex;\n    align-items: center;\n    gap: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-modal-section-note {\n    margin: calc(var(--design-unit) * -2px) 0 calc(var(--design-unit) * 3px);\n    font-size: 12px;\n    line-height: 1.5;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-modal-section-body {\n    display: flex;\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 4px);\n  }\n\n  .settings-toggle-row {\n    display: flex;\n    align-items: flex-start;\n    gap: calc(var(--design-unit) * 3px);\n    padding: 0 0 calc(var(--design-unit) * 4px) 0;\n    border-bottom: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-toggle-row:last-child {\n    border-bottom: none;\n    padding-bottom: calc(var(--design-unit) * 1px);\n  }\n\n  .settings-toggle-row.is-stacked {\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-animation-list {\n    display: flex;\n    flex-direction: column;\n    width: 100%;\n    border: 1px solid var(--neutral-stroke-rest);\n    border-radius: calc(var(--control-corner-radius) * 1.2px);\n    padding: calc(var(--design-unit) * 2px);\n    gap: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-animation-list .settings-toggle-row {\n    border: 0;\n  }\n\n  .settings-animation-category {\n    display: flex;\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 4px);\n  }\n\n  .settings-animation-category-label {\n    font-weight: 600;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-toggle-row + .settings-animation-category-label {\n    border-top: 1px solid var(--neutral-stroke-rest);\n    padding-top: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-animation-option {\n    padding: 0;\n    margin: 0;\n  }\n\n  .settings-animation-option:last-child {\n    border-bottom: none;\n    padding-bottom: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-toggle-text {\n    flex: 1;\n    min-width: 0;\n  }\n\n  .settings-toggle-title {\n    font-size: 14px;\n    font-weight: 500;\n    color: var(--neutral-foreground-rest);\n  }\n\n  .settings-toggle-desc {\n    font-size: 12px;\n    color: var(--neutral-foreground-hint);\n    line-height: 1.5;\n    max-width: 92%;\n  }\n\n  .settings-toggle-control {\n    flex: 0 0 auto;\n    min-width: 0;\n  }\n\n  .settings-toggle-control-wide {\n    width: 100%;\n    max-width: 280px;\n  }\n\n  .settings-toggle-row.is-stacked .settings-toggle-desc {\n    max-width: none;\n  }\n\n  .settings-toggle-row.is-stacked .settings-toggle-control-wide {\n    width: 100%;\n    max-width: none;\n  }\n\n  .settings-app-toggle-block {\n    display: flex;\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 1px);\n  }\n\n  .settings-toggle-hint {\n    font-size: 12px;\n    color: var(--neutral-foreground-hint);\n    line-height: 1.4;\n    padding-left: calc(var(--design-unit) * 1px);\n    font-style: italic;\n  }\n\n  .settings-context-header {\n    display: flex;\n    justify-content: space-between;\n    gap: calc(var(--design-unit) * 2px);\n    margin-bottom: calc(var(--design-unit) * 2px);\n    font-size: 12px;\n  }\n\n  .settings-context-label {\n    color: var(--neutral-foreground-hint);\n    font-size: 11px;\n    font-weight: 600;\n    text-transform: uppercase;\n    letter-spacing: 0.06em;\n  }\n\n  .settings-context-tokens {\n    color: var(--neutral-foreground-rest);\n  }\n\n  .settings-current-build {\n    background: var(--neutral-layer-2);\n    border: 1px solid var(--neutral-stroke-rest);\n    border-radius: calc(var(--control-corner-radius) * 1.5px);\n    padding: calc(var(--design-unit) * 4px);\n    margin: calc(var(--design-unit) * 3px) 0;\n  }\n\n  .settings-current-build-top {\n    display: flex;\n    align-items: center;\n    flex-wrap: wrap;\n    gap: calc(var(--design-unit) * 2px);\n    margin-bottom: calc(var(--design-unit) * 3px);\n  }\n\n  .settings-live-badge {\n    display: inline-flex;\n    align-items: center;\n    gap: calc(var(--design-unit) * 1px);\n    font-size: 10px;\n    font-weight: 700;\n    text-transform: uppercase;\n    letter-spacing: 0.06em;\n    color: var(--accent-fill-rest);\n  }\n\n  .settings-live-dot {\n    width: 7px;\n    height: 7px;\n    border-radius: 50%;\n    background: var(--accent-fill-rest);\n    animation: settings-live-pulse 1.6s ease-out infinite;\n  }\n\n  @keyframes settings-live-pulse {\n    0% {\n      box-shadow: 0 0 0 0 color-mix(in srgb, var(--accent-fill-rest) 55%, transparent);\n    }\n\n    70% {\n      box-shadow: 0 0 0 7px transparent;\n    }\n\n    100% {\n      box-shadow: 0 0 0 0 transparent;\n    }\n  }\n\n  .settings-current-build-name {\n    font-size: 14px;\n    font-weight: 600;\n  }\n\n  .settings-current-build-stats {\n    display: flex;\n    flex-wrap: wrap;\n    gap: calc(var(--design-unit) * 3px);\n    margin-bottom: calc(var(--design-unit) * 3px);\n  }\n\n  .settings-build-stat {\n    flex: 1;\n    min-width: 0;\n    background: var(--neutral-layer-1);\n    border: 1px solid var(--neutral-stroke-rest);\n    border-radius: calc(var(--control-corner-radius) * 1px);\n    padding: calc(var(--design-unit) * 3px);\n  }\n\n  .settings-build-stat-label {\n    font-size: 10px;\n    font-weight: 600;\n    text-transform: uppercase;\n    letter-spacing: 0.06em;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-build-stat-value {\n    font-size: 22px;\n    font-weight: 700;\n    margin-top: calc(var(--design-unit) * 1px);\n    color: var(--neutral-foreground-rest);\n  }\n\n  .settings-build-stat-value .prefix,\n  .settings-build-stat-value .suffix {\n    color: var(--accent-fill-rest);\n  }\n\n  .settings-model-tags {\n    display: flex;\n    flex-wrap: wrap;\n    gap: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-model-tag {\n    font-size: 11px;\n    font-weight: 600;\n    padding: 3px 9px;\n    border-radius: 20px;\n    font-family: ui-monospace, monospace;\n    border: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-model-tag,\n  .settings-cost-history-icon {\n    --model-tag-color: var(--neutral-foreground-rest);\n\n    background: color-mix(\n      in srgb,\n      var(--model-tag-color) var(--ai-tier-badge-bg-mix),\n      var(--neutral-layer-1)\n    );\n    border-color: color-mix(in srgb, var(--model-tag-color) 20%, var(--neutral-layer-1));\n    color: color-mix(in srgb, var(--model-tag-color), white var(--ai-tier-badge-text-lighten));\n  }\n\n  .settings-cost-history-title {\n    font-size: 11px;\n    text-transform: uppercase;\n    letter-spacing: 0.08em;\n    color: var(--neutral-foreground-hint);\n    font-weight: 600;\n    margin: calc(var(--design-unit) * 4px) 0 calc(var(--design-unit) * 2px);\n  }\n\n  .settings-cost-history {\n    display: flex;\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 2px);\n    padding-bottom: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-cost-history-icon {\n    flex: 0 0 auto;\n    width: 36px;\n    height: 36px;\n    border-radius: calc(var(--control-corner-radius) * 1px);\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    font-size: 16px;\n    font-weight: 700;\n    border: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-cost-history-row {\n    display: flex;\n    flex-direction: column;\n    background: var(--neutral-layer-1);\n    border: 1px solid var(--neutral-stroke-rest);\n    border-radius: calc(var(--control-corner-radius) * 1.5px);\n    padding: calc(var(--design-unit) * 4px);\n  }\n\n  .settings-cost-history-row-content {\n    display: flex;\n    align-items: flex-start;\n    gap: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-cost-history-row-content + .settings-cost-history-row-content {\n    border-top: 1px solid var(--neutral-stroke-rest);\n    margin-top: calc(var(--design-unit) * 2px);\n    padding-top: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-cost-history-row-body {\n    flex: 1 1 auto;\n    min-width: 0;\n    display: flex;\n    gap: calc(var(--design-unit) * 2px);\n    justify-content: space-between;\n  }\n\n  .settings-cost-history-row-right {\n    align-items: flex-end;\n  }\n\n  .settings-cost-history-row-cost,\n  .settings-cost-history-row-title {\n    font-size: 14px;\n    font-weight: 600;\n    color: var(--neutral-foreground-rest);\n    min-width: 0;\n  }\n\n  .settings-cost-history-row-metrics {\n    display: flex;\n    flex-direction: column;\n    flex: 0 0 auto;\n    font-size: 13px;\n    font-family: ui-monospace, monospace;\n    color: var(--neutral-foreground-rest);\n    white-space: nowrap;\n  }\n\n  .settings-cost-history-row-tokens,\n  .settings-cost-history-row-date {\n    font-size: 12px;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-cost-history-delete {\n    flex: 0 0 auto;\n    margin-top: -2px;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-cost-history-delete:hover {\n    color: var(--error-color);\n  }\n\n  .settings-cost-history ::slotted(*) {\n    display: block;\n  }\n\n  .settings-modal-footer {\n    width: 100%;\n  }\n\n  .settings-done-button {\n    margin-left: auto;\n  }\n\n  .settings-modal-footer-actions {\n    display: flex;\n    align-items: center;\n    justify-content: space-between;\n    gap: calc(var(--design-unit) * 2px);\n    width: 100%;\n  }\n\n  .settings-disclaimer {\n    font-size: 12px;\n    color: var(--neutral-foreground-hint);\n    max-width: 60%;\n    line-height: 1.4;\n  }\n`",
+          "default": "css`\n  *,\n  *::before,\n  *::after {\n    box-sizing: border-box;\n  }\n\n  .settings-modal {\n    --ai-tier-badge-bg-mix: 14%;\n    --ai-tier-badge-text-lighten: 18%;\n  }\n\n  .settings-modal::part(dialog) {\n    max-width: 620px;\n    width: calc(100vw - 48px);\n    max-height: calc(100vh - 48px);\n    padding: 0;\n  }\n\n  .settings-modal::part(content) {\n    display: flex;\n    flex-direction: column;\n    min-height: 0;\n    padding: 0;\n    width: 100%;\n  }\n\n  .settings-modal::part(top) {\n    padding: calc(var(--design-unit) * 4px) calc(var(--design-unit) * 5px);\n    border-bottom: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-modal::part(bottom) {\n    padding: calc(var(--design-unit) * 4px) calc(var(--design-unit) * 5px);\n    border-top: 1px solid var(--neutral-stroke-rest);\n    border-bottom-left-radius: var(--card-border-radius, calc(var(--control-corner-radius) * 1px));\n    border-bottom-right-radius: var(--card-border-radius, calc(var(--control-corner-radius) * 1px));\n    background-color: var(--neutral-layer-2);\n  }\n\n  .settings-modal-header {\n    display: flex;\n    align-items: center;\n    min-width: 0;\n  }\n\n  .settings-modal-title {\n    margin: 0;\n    font-size: 16px;\n    font-weight: 600;\n    display: flex;\n    align-items: center;\n    gap: calc(var(--design-unit) * 2px);\n    color: var(--neutral-foreground-rest);\n  }\n\n  .settings-modal-content {\n    display: flex;\n    flex-direction: column;\n    min-height: 0;\n    flex: 1 1 auto;\n  }\n\n  .settings-modal-tabs::part(tablist) {\n    border-bottom: 0;\n    padding: 0 calc(var(--design-unit) * 5px);\n    column-gap: calc(var(--design-unit) * 5px);\n  }\n\n  .settings-modal-tabs::part(activeIndicator) {\n    height: 2px;\n  }\n\n  .settings-modal-tab {\n    padding: 0;\n    font-weight: 600;\n    gap: 6px;\n  }\n\n  .settings-modal-tab[aria-selected='true'] {\n    color: var(--neutral-foreground-rest);\n  }\n\n  .settings-modal-tabs::part(tabpanel) {\n    border-top: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-modal-tab-panel {\n    display: flex;\n    flex-direction: column;\n    min-height: 0;\n    flex: 1 1 auto;\n    padding: 0;\n    border-radius: 0;\n  }\n\n  .settings-modal-tab-panel[hidden] {\n    display: none !important;\n  }\n\n  .settings-modal-body {\n    overflow-y: auto;\n    padding: 0 calc(var(--design-unit) * 5px) calc(var(--design-unit) * 2px);\n    max-height: min(60vh, 520px);\n  }\n\n  .settings-modal-section {\n    padding: calc(var(--design-unit) * 5px) 0;\n    border-bottom: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-modal-section:last-child {\n    border-bottom: none;\n  }\n\n  .settings-modal-section-title {\n    margin: 0 0 calc(var(--design-unit) * 3px);\n    font-size: 11px;\n    font-weight: 600;\n    letter-spacing: 0.08em;\n    text-transform: uppercase;\n    color: var(--neutral-foreground-hint);\n    display: flex;\n    align-items: center;\n    gap: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-modal-section-note {\n    margin: calc(var(--design-unit) * -2px) 0 calc(var(--design-unit) * 3px);\n    font-size: 12px;\n    line-height: 1.5;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-modal-section-body {\n    display: flex;\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 4px);\n  }\n\n  .settings-toggle-row {\n    display: flex;\n    align-items: flex-start;\n    gap: calc(var(--design-unit) * 3px);\n    padding: 0 0 calc(var(--design-unit) * 4px) 0;\n    border-bottom: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-toggle-row:last-child {\n    border-bottom: none;\n    padding-bottom: calc(var(--design-unit) * 1px);\n  }\n\n  .settings-toggle-row.is-stacked {\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-animation-list {\n    display: flex;\n    flex-direction: column;\n    width: 100%;\n    border: 1px solid var(--neutral-stroke-rest);\n    border-radius: calc(var(--control-corner-radius) * 1.2px);\n    padding: calc(var(--design-unit) * 2px);\n    gap: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-animation-list .settings-toggle-row {\n    border: 0;\n  }\n\n  .settings-animation-category {\n    display: flex;\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 4px);\n  }\n\n  .settings-animation-category-label {\n    font-weight: 600;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-toggle-row + .settings-animation-category-label {\n    border-top: 1px solid var(--neutral-stroke-rest);\n    padding-top: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-animation-option {\n    padding: 0;\n    margin: 0;\n  }\n\n  .settings-animation-option:last-child {\n    border-bottom: none;\n    padding-bottom: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-toggle-text {\n    flex: 1;\n    min-width: 0;\n  }\n\n  .settings-toggle-title {\n    font-size: 14px;\n    font-weight: 500;\n    color: var(--neutral-foreground-rest);\n  }\n\n  .settings-toggle-desc {\n    font-size: 12px;\n    color: var(--neutral-foreground-hint);\n    line-height: 1.5;\n    max-width: 92%;\n  }\n\n  .settings-toggle-control {\n    flex: 0 0 auto;\n    min-width: 0;\n  }\n\n  .settings-toggle-control-wide {\n    width: 100%;\n    max-width: 280px;\n  }\n\n  .settings-toggle-row.is-stacked .settings-toggle-desc {\n    max-width: none;\n  }\n\n  .settings-toggle-row.is-stacked .settings-toggle-control-wide {\n    width: 100%;\n    max-width: none;\n  }\n\n  .settings-app-toggle-block {\n    display: flex;\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 1px);\n  }\n\n  .settings-toggle-hint {\n    font-size: 12px;\n    color: var(--neutral-foreground-hint);\n    line-height: 1.4;\n    padding-left: calc(var(--design-unit) * 1px);\n    font-style: italic;\n  }\n\n  .settings-context-header {\n    display: flex;\n    justify-content: space-between;\n    gap: calc(var(--design-unit) * 2px);\n    margin-bottom: calc(var(--design-unit) * 2px);\n    font-size: 12px;\n  }\n\n  .settings-context-label {\n    color: var(--neutral-foreground-hint);\n    font-size: 11px;\n    font-weight: 600;\n    text-transform: uppercase;\n    letter-spacing: 0.06em;\n  }\n\n  .settings-context-tokens {\n    color: var(--neutral-foreground-rest);\n  }\n\n  .settings-current-build {\n    background: var(--neutral-layer-2);\n    border: 1px solid var(--neutral-stroke-rest);\n    border-radius: calc(var(--control-corner-radius) * 1.5px);\n    padding: calc(var(--design-unit) * 4px);\n    margin: calc(var(--design-unit) * 3px) 0;\n  }\n\n  .settings-current-build-top {\n    display: flex;\n    align-items: center;\n    flex-wrap: wrap;\n    gap: calc(var(--design-unit) * 2px);\n    margin-bottom: calc(var(--design-unit) * 3px);\n  }\n\n  .settings-live-badge {\n    display: inline-flex;\n    align-items: center;\n    gap: calc(var(--design-unit) * 1px);\n    font-size: 10px;\n    font-weight: 700;\n    text-transform: uppercase;\n    letter-spacing: 0.06em;\n    color: var(--accent-fill-rest);\n  }\n\n  .settings-live-dot {\n    width: 7px;\n    height: 7px;\n    border-radius: 50%;\n    background: var(--accent-fill-rest);\n    animation: settings-live-pulse 1.6s ease-out infinite;\n  }\n\n  @keyframes settings-live-pulse {\n    0% {\n      box-shadow: 0 0 0 0 color-mix(in srgb, var(--accent-fill-rest) 55%, transparent);\n    }\n\n    70% {\n      box-shadow: 0 0 0 7px transparent;\n    }\n\n    100% {\n      box-shadow: 0 0 0 0 transparent;\n    }\n  }\n\n  .settings-current-build-name {\n    font-size: 14px;\n    font-weight: 600;\n  }\n\n  .settings-current-build-stats {\n    display: flex;\n    flex-wrap: wrap;\n    gap: calc(var(--design-unit) * 3px);\n    margin-bottom: calc(var(--design-unit) * 3px);\n  }\n\n  .settings-build-stat {\n    flex: 1;\n    min-width: 0;\n    background: var(--neutral-layer-1);\n    border: 1px solid var(--neutral-stroke-rest);\n    border-radius: calc(var(--control-corner-radius) * 1px);\n    padding: calc(var(--design-unit) * 3px);\n  }\n\n  .settings-build-stat-label {\n    font-size: 10px;\n    font-weight: 600;\n    text-transform: uppercase;\n    letter-spacing: 0.06em;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-build-stat-value {\n    font-size: 22px;\n    font-weight: 700;\n    margin-top: calc(var(--design-unit) * 1px);\n    color: var(--neutral-foreground-rest);\n  }\n\n  .settings-build-stat-value .prefix,\n  .settings-build-stat-value .suffix {\n    color: var(--accent-fill-rest);\n  }\n\n  .settings-model-tags {\n    display: flex;\n    flex-wrap: wrap;\n    gap: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-model-tag {\n    font-size: 11px;\n    font-weight: 600;\n    padding: 3px 9px;\n    border-radius: 20px;\n    font-family: ui-monospace, monospace;\n    border: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-model-tag,\n  .settings-cost-history-icon {\n    --model-tag-color: var(--neutral-foreground-rest);\n\n    background: color-mix(\n      in srgb,\n      var(--model-tag-color) var(--ai-tier-badge-bg-mix),\n      var(--neutral-layer-1)\n    );\n    border-color: color-mix(in srgb, var(--model-tag-color) 20%, var(--neutral-layer-1));\n    color: color-mix(in srgb, var(--model-tag-color), white var(--ai-tier-badge-text-lighten));\n  }\n\n  .settings-cost-history-title {\n    font-size: 11px;\n    text-transform: uppercase;\n    letter-spacing: 0.08em;\n    color: var(--neutral-foreground-hint);\n    font-weight: 600;\n    margin: calc(var(--design-unit) * 4px) 0 calc(var(--design-unit) * 2px);\n  }\n\n  .settings-cost-history {\n    display: flex;\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 2px);\n    padding-bottom: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-cost-history-icon {\n    flex: 0 0 auto;\n    width: 36px;\n    height: 36px;\n    border-radius: calc(var(--control-corner-radius) * 1px);\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    font-size: 16px;\n    font-weight: 700;\n    border: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-cost-history-row {\n    display: flex;\n    flex-direction: column;\n    background: var(--neutral-layer-1);\n    border: 1px solid var(--neutral-stroke-rest);\n    border-radius: calc(var(--control-corner-radius) * 1.5px);\n    padding: calc(var(--design-unit) * 4px);\n  }\n\n  .settings-cost-history-row-content {\n    display: flex;\n    align-items: flex-start;\n    gap: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-cost-history-row-content + .settings-cost-history-row-content {\n    border-top: 1px solid var(--neutral-stroke-rest);\n    margin-top: calc(var(--design-unit) * 2px);\n    padding-top: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-cost-history-row-body {\n    flex: 1 1 auto;\n    min-width: 0;\n    display: flex;\n    gap: calc(var(--design-unit) * 2px);\n    justify-content: space-between;\n  }\n\n  .settings-cost-history-row-right {\n    align-items: flex-end;\n  }\n\n  .settings-cost-history-row-cost,\n  .settings-cost-history-row-title {\n    font-size: 14px;\n    font-weight: 600;\n    color: var(--neutral-foreground-rest);\n    min-width: 0;\n  }\n\n  .settings-cost-history-row-metrics {\n    display: flex;\n    flex-direction: column;\n    flex: 0 0 auto;\n    font-size: 13px;\n    font-family: ui-monospace, monospace;\n    color: var(--neutral-foreground-rest);\n    white-space: nowrap;\n  }\n\n  .settings-cost-history-row-tokens,\n  .settings-cost-history-row-date {\n    font-size: 12px;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-cost-history-delete {\n    flex: 0 0 auto;\n    margin-top: -2px;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-cost-history-delete:hover {\n    color: var(--error-color);\n  }\n\n  .settings-cost-history ::slotted(*) {\n    display: block;\n  }\n\n  .settings-modal-footer {\n    width: 100%;\n  }\n\n  .settings-done-button {\n    margin-left: auto;\n  }\n\n  .settings-modal-footer-actions {\n    display: flex;\n    align-items: center;\n    justify-content: space-between;\n    gap: calc(var(--design-unit) * 2px);\n    width: 100%;\n  }\n\n  .settings-disclaimer {\n    font-size: 12px;\n    color: var(--neutral-foreground-hint);\n    max-width: 60%;\n    line-height: 1.4;\n  }\n\n  /*\n   * Inline spinner shown in the \"Download agent log\" button while the log builds\n   * (GENC-1351 §5.8) — the lifetime-stitch path is an async provider round-trip.\n   * Sized to the button label and tinted with currentColor so it tracks the\n   * button's text colour in every appearance / theme.\n   */\n  [part='download-button'] .download-spinner {\n    display: inline-block;\n    width: 12px;\n    height: 12px;\n    margin-right: calc(var(--design-unit) * 1px);\n    vertical-align: -1px;\n    border: 2px solid currentColor;\n    border-right-color: transparent;\n    border-radius: 50%;\n    animation: download-spin 0.6s linear infinite;\n  }\n\n  @keyframes download-spin {\n    to {\n      transform: rotate(360deg);\n    }\n  }\n`",
           "description": "Styles for the assistant settings modal (tabs, sections, toggles, cost summary)."
         }
       ],
@@ -8217,6 +8854,518 @@
           }
         }
       ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/state/persistence/diagnostics-cursors.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "getDiagnosticsCursors",
+          "return": {
+            "type": {
+              "text": "DiagnosticsCursors"
+            }
+          },
+          "parameters": [
+            {
+              "name": "key",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "The shared cursors for `key`, created (empty) on first access. @internal"
+        },
+        {
+          "kind": "function",
+          "name": "clearDiagnosticsCursorRegistry",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "description": "Drop all cursors — test isolation only. @internal"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "getDiagnosticsCursors",
+          "declaration": {
+            "name": "getDiagnosticsCursors",
+            "module": "src/state/persistence/diagnostics-cursors.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "clearDiagnosticsCursorRegistry",
+          "declaration": {
+            "name": "clearDiagnosticsCursorRegistry",
+            "module": "src/state/persistence/diagnostics-cursors.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/state/persistence/diagnostics.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "assembleDebugLog",
+          "return": {
+            "type": {
+              "text": "DebugLog"
+            }
+          },
+          "parameters": [
+            {
+              "name": "entries",
+              "type": {
+                "text": "DiagnosticEntry[]"
+              }
+            },
+            {
+              "name": "readme",
+              "type": {
+                "text": "readonly string[]"
+              }
+            }
+          ],
+          "description": "Reassemble diagnostic entries into the `{ readme, timeline, meta }` debug-log\nshape (GENC-1351 §5.8). `timeline` = the `message`/`turn`/`event` entries sorted\nby ISO `timestamp` (kind-rank tie-break). `meta` = the **newest** `meta-snapshot`'s\nblock only — a \"state at export\" photo, matching the single-page log. The older\nsnapshots are intentionally dropped: the per-turn evolution they would show is\nalready in the timeline (`turn.agentSnapshot` + `context.updated` events), so\nkeeping them would just repeat the bulky, near-static `agentSummary`. `readme` =\nthe passed (current) constant. Pure — reused for both the live current-page log\nand the reassembled lifetime log stitched from the persisted stream, so both\ncome out shape-identical."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "assembleDebugLog",
+          "declaration": {
+            "name": "assembleDebugLog",
+            "module": "src/state/persistence/diagnostics.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/state/persistence/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "PERSISTED_SESSION_VERSION",
+          "declaration": {
+            "name": "PERSISTED_SESSION_VERSION",
+            "module": "./session-snapshot"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "PersistedSession",
+          "declaration": {
+            "name": "PersistedSession",
+            "module": "./session-snapshot"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "WebStorageSessionProvider",
+          "declaration": {
+            "name": "WebStorageSessionProvider",
+            "module": "./session-persistence-provider"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SessionPersistenceProvider",
+          "declaration": {
+            "name": "SessionPersistenceProvider",
+            "module": "./session-persistence-provider"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SessionPersistenceConfig",
+          "declaration": {
+            "name": "SessionPersistenceConfig",
+            "module": "./session-persistence-provider"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SessionPreferences",
+          "declaration": {
+            "name": "SessionPreferences",
+            "module": "./session-persistence-provider"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "assembleDebugLog",
+          "declaration": {
+            "name": "assembleDebugLog",
+            "module": "./diagnostics"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "DiagnosticEntry",
+          "declaration": {
+            "name": "DiagnosticEntry",
+            "module": "./diagnostics"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "DebugLog",
+          "declaration": {
+            "name": "DebugLog",
+            "module": "./diagnostics"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/state/persistence/persister-registry.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "getOrCreatePersister",
+          "return": {
+            "type": {
+              "text": "SessionPersister"
+            }
+          },
+          "parameters": [
+            {
+              "name": "key",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "factory",
+              "type": {
+                "text": "() => SessionPersister"
+              }
+            }
+          ],
+          "description": "Returns the existing persister for `key`, or calls `factory` to create and\nregister a new one. First view to connect creates it; later views share it."
+        },
+        {
+          "kind": "function",
+          "name": "getPersister",
+          "return": {
+            "type": {
+              "text": "SessionPersister | undefined"
+            }
+          },
+          "parameters": [
+            {
+              "name": "key",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Returns the existing persister for `key`, or `undefined`."
+        },
+        {
+          "kind": "function",
+          "name": "deletePersister",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "key",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Removes the persister for `key` (explicit session teardown). Disposes it first\nso its debounced save AND diagnostics timers are cancelled — otherwise a timer\nscheduled by the outgoing session fires after the in-place switch and flushes the\nNEW session's entries under the OLD key, corrupting its stream (GENC-1351 §5.12)."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "getOrCreatePersister",
+          "declaration": {
+            "name": "getOrCreatePersister",
+            "module": "src/state/persistence/persister-registry.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getPersister",
+          "declaration": {
+            "name": "getPersister",
+            "module": "src/state/persistence/persister-registry.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "deletePersister",
+          "declaration": {
+            "name": "deletePersister",
+            "module": "src/state/persistence/persister-registry.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/state/persistence/session-persistence-provider.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A SessionPersistenceProvider backed by a Web Storage area. Both\n`window.sessionStorage` and `window.localStorage` implement the `Storage`\nAPI, so one class serves both: point it at `sessionStorage` for\nrefresh-survival that clears on tab close (the showcase default, O6), or at\n`localStorage` for durable local persistence.\n\nOpt-in: a host constructs it and passes it through `chatConfig`; the library\nnever instantiates it on its own.",
+          "name": "WebStorageSessionProvider",
+          "members": [
+            {
+              "kind": "field",
+              "name": "storage",
+              "type": {
+                "text": "Storage"
+              },
+              "privacy": "private",
+              "readonly": true,
+              "default": "storage"
+            },
+            {
+              "kind": "field",
+              "name": "keyPrefix",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "saveDebounceMs",
+              "type": {
+                "text": "number"
+              },
+              "readonly": true,
+              "description": "Web storage is synchronous and cheap, so the default is `0` — save as\nsoon as the tick settles, no throttle. Override via `options.saveDebounceMs`\n(e.g. if pointing at `localStorage` and you'd rather coalesce large writes)."
+            },
+            {
+              "kind": "method",
+              "name": "storageKey",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "sessionKey",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "preferencesKey",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "sessionKey",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Preferences key, namespaced apart from the session key so `clear` leaves it."
+            },
+            {
+              "kind": "method",
+              "name": "load",
+              "return": {
+                "type": {
+                  "text": "Promise<PersistedSession | null>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "sessionKey",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "save",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "sessionKey",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "snapshot",
+                  "type": {
+                    "text": "PersistedSession"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "clear",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "sessionKey",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "loadPreferences",
+              "return": {
+                "type": {
+                  "text": "Promise<SessionPreferences | undefined>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "sessionKey",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "savePreferences",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "sessionKey",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "preferences",
+                  "type": {
+                    "text": "SessionPreferences"
+                  }
+                }
+              ]
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "WebStorageSessionProvider",
+          "declaration": {
+            "name": "WebStorageSessionProvider",
+            "module": "src/state/persistence/session-persistence-provider.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/state/persistence/session-persister.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/state/persistence/session-snapshot.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "PERSISTED_SESSION_VERSION",
+          "type": {
+            "text": "number"
+          },
+          "default": "1",
+          "description": "Schema version of the persisted session shape. Bump on an incompatible\nchange; a snapshot whose `version` doesn't match is discarded on load rather\nthan risk feeding a stale shape into restore.",
+          "privacy": "public"
+        },
+        {
+          "kind": "function",
+          "name": "unknownAgentSnapshots",
+          "return": {
+            "type": {
+              "text": "string[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "snapshot",
+              "type": {
+                "text": "PersistedSession"
+              }
+            },
+            {
+              "name": "knownAgentNames",
+              "type": {
+                "text": "Iterable<string>"
+              }
+            }
+          ],
+          "description": "Names of agents the restored session holds machine/state snapshots for but\nwhich are **not** in the currently-configured agent set — their flow cannot\nresume. Common when the host's agent array is dynamic (agents gated by feature\nflags, project state, or permissions; e.g. genesis-create). Callers should\nsurface these; the restore is otherwise non-fatal (the transcript and any\nknown agents still restore). Returns `[]` when `knownAgentNames` is empty —\nthe agent set isn't known yet, so we can't classify without false positives."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "PERSISTED_SESSION_VERSION",
+          "declaration": {
+            "name": "PERSISTED_SESSION_VERSION",
+            "module": "src/state/persistence/session-snapshot.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "unknownAgentSnapshots",
+          "declaration": {
+            "name": "unknownAgentSnapshots",
+            "module": "src/state/persistence/session-snapshot.ts"
+          }
+        }
+      ]
     }
   ]
 }