@genesislcap/ai-assistant 14.488.1 → 14.488.2-GENC-1351.2

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",
@@ -1206,6 +1253,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",
@@ -1370,6 +1426,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 +1751,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",
@@ -2021,6 +2110,26 @@
               "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": "showHalo",
@@ -2333,6 +2442,141 @@
               "kind": "method",
               "name": "toggleAgentPicker"
             },
+            {
+              "kind": "field",
+              "name": "confirmingClear",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Two-step confirm for the destructive Clear action; reset whenever the menu toggles."
+            },
+            {
+              "kind": "field",
+              "name": "confirmingCompact",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "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 lifecycle-menu button shows. It occupies the stop-button slot,\nso it only appears when idle (mutually exclusive with Stop). Needs\nsomething to act on: a chat to clear/compact, or a provider to toggle.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "persistenceToggleable",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "The persistence toggle row renders only when a provider is configured.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "persistenceActive",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether persistence is currently active (on + a provider) for this session.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "compactable",
+              "type": {
+                "text": "boolean"
+              },
+              "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": "toggleSessionMenu"
+            },
+            {
+              "kind": "method",
+              "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": "togglePersistence",
+              "description": "Toggle persistence (convenience / programmatic)."
+            },
+            {
+              "kind": "method",
+              "name": "gatherPreferences",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "SessionPreferences"
+                }
+              },
+              "description": "Snapshot the user-changeable settings into a persistable preferences blob."
+            },
+            {
+              "kind": "method",
+              "name": "persistPreferences",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "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": "applyPreferenceBaseline",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "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": "compactSession",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "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": "clearSession",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "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."
+            },
             {
               "kind": "method",
               "name": "setAgent",
@@ -2701,11 +2945,74 @@
             },
             {
               "kind": "method",
-              "name": "getDebugLog"
+              "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": "DiagnosticEntry[]"
+                }
+              },
+              "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": "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": "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": "downloadDebugLog"
+              "name": "initPersistenceForNewStore",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "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",
@@ -2987,11 +3294,13 @@
           ],
           "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`"
+              }
+            },
+            {
+              "description": "Fired when the user presses the chat header in `popout-mode=\"expand\"` (for drag-to-popout hosts). Bubbles and composed. detail: `ChatHeaderMousedownEventDetail`",
+              "name": "chat-header-mousedown"
             }
           ],
           "attributes": [
@@ -3098,6 +3407,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 +3445,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 +3525,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 +3548,14 @@
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "createDefaultSessionState",
+          "declaration": {
+            "name": "createDefaultSessionState",
+            "module": "src/state/ai-assistant-slice.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "defaultSessionState",
@@ -3241,7 +3584,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  '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,6 +4780,96 @@
             }
           ],
           "description": "Applies a history cap for sub-agent context: the last `cap` messages are passed\nverbatim; older messages have their tool payloads masked."
+        },
+        {
+          "kind": "variable",
+          "name": "COMPACT_KEEP_RECENT_MESSAGES",
+          "type": {
+            "text": "number"
+          },
+          "default": "4",
+          "description": "Recent messages kept verbatim when compacting; everything earlier is summarized."
+        },
+        {
+          "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": "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": "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": [
@@ -4455,6 +4888,54 @@
             "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"
+          }
         }
       ]
     },
@@ -4513,6 +4994,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 +5056,14 @@
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "isSessionNoticeMarker",
+          "declaration": {
+            "name": "isSessionNoticeMarker",
+            "module": "src/utils/message-partition.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "trailingInteractionRow",
@@ -4609,6 +5116,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 +5234,12 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/with-timeout.ts",
+      "declarations": [],
+      "exports": []
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/activity-halo/activity-halo.ts",
@@ -6534,6 +7053,26 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "canCompact",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "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": "compact",
+              "return": {
+                "type": {
+                  "text": "Promise<ChatMessage | null>"
+                }
+              },
+              "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": "isBusy",
@@ -7513,6 +8052,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",
@@ -7698,6 +8247,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 +8355,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",
@@ -8169,7 +8766,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 +8814,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)."
+        }
+      ],
+      "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"
+          }
+        }
+      ]
     }
   ]
 }