@genesislcap/ai-assistant 15.26.0 → 15.27.0-agent-log-submit.3

package/dist/ai-assistant.api.json

@@ -5631,7 +5631,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#dispose:member(1)",
-              "docComment": "/**\n * Tear down the driver: aborts the lifecycle signal so any in-flight provider request (and prompt/tool factories awaiting it) cancels instead of running on to completion or the transport timeout. Called by the host on driver swap and by `OrchestratingDriver.dispose()`. Idempotent.\n *\n * Deliberately does NOT settle `pendingInteractions` here: dispose is never reached while one is pending. The only host-level dispose is the agent-swap rebuild, which is guarded by `isBusy()` — a pending interaction keeps the tool loop suspended (`busy === true`), so the swap is deferred until the widget resolves. Sub-agent child disposes always have an empty pending map (widgets park on the parent via `setHostInteractionRequester`). A pending interaction is instead settled by `resolveInteraction` (user response or timeout), which also stamps history and reverts the chat-input override.\n */\n",
+              "docComment": "/**\n * Tear down the driver: aborts the lifecycle signal so any in-flight provider request (and prompt/tool factories awaiting it) cancels instead of running on to completion or the transport timeout. Called by the host on driver swap and by `OrchestratingDriver.dispose()`. Idempotent.\n *\n * Deliberately does NOT settle pending interactions here: dispose is never reached while one is pending. The only host-level dispose is the agent-swap rebuild, which is guarded by `isBusy()` — a pending interaction keeps the tool loop suspended (`busy === true`), so the swap is deferred until the widget resolves. Sub-agent child disposes always have an empty pending map (widgets park on the parent via `setHostInteractionRequester`). A pending interaction is instead settled by `resolveInteraction` (user response or timeout), which also stamps history and reverts the chat-input override.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -5850,7 +5850,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getExternalDiagnostics:member(1)",
-              "docComment": "/**\n * The `turn` + `message` diagnostic-log entries harvested from resolved interactions' `InteractionResult.diagnostics` (e.g. a server-side ChatDriver's collated debug log). The host concatenates these into its own debug log so `downloadDebugLog`/the persisted diagnostics stream include external-engine logs; `event` entries are excluded here because they're merged into the session's meta-event registry instead (see `resolveInteraction`) and reach the log via `getMetaEvents`. Opaque, chronologically sorted by the host at assemble time. (GENC-1461.)\n */\n",
+              "docComment": "/**\n * The `turn` + `message` diagnostic-log entries harvested from resolved interactions' `InteractionResult.diagnostics` (e.g. a server-side ChatDriver's collated debug log). The host concatenates these into its own debug log so `downloadDebugLog`/the persisted diagnostics stream include external-engine logs; `event` entries are excluded here because they're merged into the session's meta-event registry instead and reach the log via `getMetaEvents`. Opaque, chronologically sorted by the host at assemble time. (GENC-1461.)\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -6300,7 +6300,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getTurnSnapshots:member(1)",
-              "docComment": "/**\n * Return the per-turn snapshots captured so far. Used by the host's debug log exporter to show what the LLM saw on each turn — system prompt, tool surface, and agent-supplied state (e.g. a machine snapshot).\n *\n * Ring-buffered at `MAX_TURN_SNAPSHOTS`; older entries are dropped.\n */\n",
+              "docComment": "/**\n * Return the per-turn snapshots captured so far. Used by the host's debug log exporter to show what the LLM saw on each turn — system prompt, tool surface, and agent-supplied state (e.g. a machine snapshot).\n *\n * Ring-buffered at `maxTurnSnapshots`; older entries are dropped.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -6513,7 +6513,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#recordExternalCost:member(1)",
-              "docComment": "/**\n * Add external (non-LLM) spend to an interaction's message AFTER it has resolved.\n *\n * **Why this exists separately from `resolveInteraction`.** A widget's spend reaches the session total only through `InteractionResult.costUsd`, which is read exactly once — `resolveInteraction` does its whole job inside `if (interaction)` and then deletes the entry from `pendingInteractions`. That is correct for the resolution itself, but it assumes a widget stops costing money when it resolves, and several deliberately do not: a widget that resolves EARLY so the assistant stops waiting (options shown, a preview rendered) may stay interactive for minutes afterwards and do more paid work on the user's behalf. Re-emitting `interaction-completed` does not help — with the interaction gone from the map the call is a silent no-op — so that spend had nowhere to go and was simply missing from the figure shown to the user.\n *\n * Additive by design: the caller reports a DELTA, not a running total, so repeated calls sum. It touches only `externalCostUsd`; the recorded `interaction.resolved` payload is left exactly as the resolution wrote it, because this is not a second resolution and must not read like one.\n *\n * Deliberately does NOT require the interaction to be pending, does not resurrect it, and has no loading/turn side effects — this is bookkeeping about a turn that already happened.\n *\n * @param interactionId - the interaction whose message owns the spend.\n *\n * @param costUsd - a positive delta in USD. Non-finite, zero and negative values are ignored.\n *\n * @returns `true` when the spend was recorded; `false` when it was not — either the value was not a positive finite amount, or the message is no longer in history (trimmed or condensed away). A real outcome a caller may want to log rather than a failure to throw on; every `false` also records an `interaction.external-cost-dropped` meta event here, so money can never disappear without a trace.\n *\n * @beta\n */\n",
+              "docComment": "/**\n * Add external (non-LLM) spend to an interaction's message AFTER it has resolved — for a widget that resolves early so the assistant stops waiting, then keeps doing paid work on the user's behalf. `InteractionController.recordExternalCost` explains why the resolution path cannot carry this.\n *\n * Additive by design: the caller reports a DELTA, not a running total, so repeated calls sum.\n *\n * Deliberately does NOT require the interaction to be pending, does not resurrect it, and has no loading/turn side effects — this is bookkeeping about a turn that already happened.\n *\n * @param interactionId - the interaction whose message owns the spend.\n *\n * @param costUsd - a positive delta in USD. Non-finite, zero and negative values are ignored.\n *\n * @returns `true` when the spend was recorded; `false` when it was not — either the value was not a positive finite amount, or the message is no longer in history (trimmed or condensed away). A real outcome a caller may want to log rather than a failure to throw on; every `false` also records an `interaction.external-cost-dropped` meta event, so money can never disappear without a trace.\n *\n * @beta\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -7101,7 +7101,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#setProviderHistoryTransform:member(1)",
-              "docComment": "",
+              "docComment": "/**\n * Optional transform applied to conversation history immediately before each LLM request. Cleared when `undefined`. Does not alter stored history.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -9555,6 +9555,37 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#cancelDebugLogCompose:member(1)",
+              "docComment": "/**\n * Close the compose box and discard the typed note.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "cancelDebugLogCompose(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "cancelDebugLogCompose"
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#chatConfig:member",
@@ -10105,10 +10136,477 @@
                   "text": ";"
                 }
               ],
-              "isReadonly": false,
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "confirmingClear",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#confirmingCompact:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "confirmingCompact: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "confirmingCompact",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#connectedCallback:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "connectedCallback(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "connectedCallback"
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#contextBudget:member",
+              "docComment": "/**\n * The context gate's derived surface (GENC-1567). Every member below delegates to `ContextGateController` — the names are this element's public API and the template's bindings, so they stay put while the derivation moves.\n *\n * The per-agent `contextReserve` IS folded in, via the driver (GENC-1582). It used to be described here as a separate, later check made when an agent took ownership of a flow — but there is no such check, and by flow entry the send has already been allowed. Resolving it before the send is what makes it a gate rather than a label.\n *\n * None carries `@volatile`: the decorators live on the controller's getters, and they reach the binding observer from there — see `docs/code-health.md` §11.4.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get contextBudget(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ResolvedContextBudget",
+                  "canonicalReference": "@genesislcap/ai-assistant!~ResolvedContextBudget:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "contextBudget",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#contextGate:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get contextGate(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "'ok' | 'warn' | 'blocked'"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "contextGate",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#contextGateLabel:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get contextGateLabel(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "contextGateLabel",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#contextGateReason:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get contextGateReason(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "contextGateReason",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#contextLimit:member",
+              "docComment": "/**\n * Context window size for the active model, if known.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get contextLimit(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";\n\nset contextLimit(value: number | undefined);"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "contextLimit",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#contextTokens:member",
+              "docComment": "/**\n * Most recent prompt token count from the AI provider, if available.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get contextTokens(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number | undefined"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";\n\nset contextTokens(value: number | undefined);"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "contextTokens",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#costSessionHistory:member",
+              "docComment": "/**\n * Persisted finalized cost sessions shown on the Usage tab build history list.\n *\n * A get/set pair rather than a read-only projection: the banking tests seed rows to model a page load that found some, and a host provider's rows arrive the same way.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get costSessionHistory(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CostSessionRecord",
+                  "canonicalReference": "@genesislcap/ai-assistant!CostSessionRecord:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";\n\nset costSessionHistory(value: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CostSessionRecord",
+                  "canonicalReference": "@genesislcap/ai-assistant!CostSessionRecord:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]);"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "costSessionHistory",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#cumulativeCostUsd:member",
+              "docComment": "/**\n * Lifetime USD across every project in the history scope.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get cumulativeCostUsd(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "cumulativeCostUsd",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#cumulativeUsage:member",
+              "docComment": "/**\n * Lifetime usage across every project in the history scope — rows only, never plus live.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get cumulativeUsage(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AggregateUsage",
+                  "canonicalReference": "@genesislcap/foundation-ai!AggregateUsage:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "cumulativeUsage",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogComposeHint:member",
+              "docComment": "/**\n * The compose box's footer hint: a failure first, then the \"required\" nudge, else the live counter. Visual only — the same information reaches assistive technology via `debugLogNoteAriaLabel` (counter, required) and `debugLogSubmitAnnouncement` (outcome), because IDREF attributes such as `aria-describedby` cannot point across the design-system text-area's shadow boundary.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get debugLogComposeHint(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "debugLogComposeHint",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogComposeOpen:member",
+              "docComment": "/**\n * Whether the agent-log compose box (note + Send/Cancel) is open. Opened by the row's Send button when `debugLogSubmit.note` is not `false`; closed by Cancel or a successful send. Stays open after a failure so the typed note is not lost.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "debugLogComposeOpen: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "debugLogComposeOpen",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogNote:member",
+              "docComment": "/**\n * The note typed in the compose box, raw (trimmed only at submit time).\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "debugLogNote: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "debugLogNote",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogNoteAriaLabel:member",
+              "docComment": "/**\n * Accessible name for the note. Deliberately STATIC apart from \"(required)\": a name that changed per keystroke would be re-read in full by NVDA on every key and never updated by JAWS. The running count reaches AT through `debugLogSubmitAnnouncement` at the thresholds where it matters.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get debugLogNoteAriaLabel(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
               "isOptional": false,
               "releaseTag": "Beta",
-              "name": "confirmingClear",
+              "name": "debugLogNoteAriaLabel",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -10119,88 +10617,92 @@
             },
             {
               "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#confirmingCompact:member",
-              "docComment": "",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogNoteConfig:member",
+              "docComment": "/**\n * The resolved compose-box settings for the agent-log Send button, or `null` when the host opted out (`debugLogSubmit.note: false`) and the button sends on first click.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "confirmingCompact: "
+                  "text": "get debugLogNoteConfig(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ResolvedDebugLogNoteConfig",
+                  "canonicalReference": "@genesislcap/ai-assistant!ResolvedDebugLogNoteConfig:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": "boolean"
+                  "text": " | null"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isReadonly": false,
+              "isReadonly": true,
               "isOptional": false,
               "releaseTag": "Beta",
-              "name": "confirmingCompact",
+              "name": "debugLogNoteConfig",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 2
+                "endIndex": 3
               },
               "isStatic": false,
               "isProtected": false,
               "isAbstract": false
             },
             {
-              "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#connectedCallback:member(1)",
-              "docComment": "",
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogNoteCounter:member",
+              "docComment": "/**\n * Live \"typed / max\" counter for the compose box.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "connectedCallback(): "
+                  "text": "get debugLogNoteCounter(): "
                 },
                 {
                   "kind": "Content",
-                  "text": "void"
+                  "text": "string"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isStatic": false,
-              "returnTypeTokenRange": {
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "debugLogNoteCounter",
+              "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "isStatic": false,
               "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": [],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "connectedCallback"
+              "isAbstract": false
             },
             {
               "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#contextBudget:member",
-              "docComment": "/**\n * The context gate's derived surface (GENC-1567). Every member below delegates to `ContextGateController` — the names are this element's public API and the template's bindings, so they stay put while the derivation moves.\n *\n * The per-agent `contextReserve` IS folded in, via the driver (GENC-1582). It used to be described here as a separate, later check made when an agent took ownership of a flow — but there is no such check, and by flow entry the send has already been allowed. Resolving it before the send is what makes it a gate rather than a label.\n *\n * None carries `@volatile`: the decorators live on the controller's getters, and they reach the binding observer from there — see `docs/code-health.md` §11.4.\n */\n",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogNoteEl:member",
+              "docComment": "/**\n * Bound to the compose box's text-area via the template ref, for focus on open.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "get contextBudget(): "
+                  "text": "debugLogNoteEl?: "
                 },
                 {
                   "kind": "Reference",
-                  "text": "ResolvedContextBudget",
-                  "canonicalReference": "@genesislcap/ai-assistant!~ResolvedContextBudget:interface"
+                  "text": "HTMLElement",
+                  "canonicalReference": "!HTMLElement:interface"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isReadonly": true,
-              "isOptional": false,
+              "isReadonly": false,
+              "isOptional": true,
               "releaseTag": "Beta",
-              "name": "contextBudget",
+              "name": "debugLogNoteEl",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -10211,16 +10713,16 @@
             },
             {
               "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#contextGate:member",
-              "docComment": "",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogNoteMissing:member",
+              "docComment": "/**\n * Whether the typed note counts as empty — the ONE emptiness rule, shared by the compose box's disabled state and its \"required\" hint so the two cannot drift apart.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "get contextGate(): "
+                  "text": "get debugLogNoteMissing(): "
                 },
                 {
                   "kind": "Content",
-                  "text": "'ok' | 'warn' | 'blocked'"
+                  "text": "boolean"
                 },
                 {
                   "kind": "Content",
@@ -10230,7 +10732,7 @@
               "isReadonly": true,
               "isOptional": false,
               "releaseTag": "Beta",
-              "name": "contextGate",
+              "name": "debugLogNoteMissing",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -10241,12 +10743,12 @@
             },
             {
               "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#contextGateLabel:member",
-              "docComment": "",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogRowDescription:member",
+              "docComment": "/**\n * The agent-log row's description, phrased for whichever actions the host enabled. Send is called out as transmitting: Download keeps the log on the user's machine, Send hands the full conversation to wherever the host's transport delivers it.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "get contextGateLabel(): "
+                  "text": "get debugLogRowDescription(): "
                 },
                 {
                   "kind": "Content",
@@ -10260,7 +10762,7 @@
               "isReadonly": true,
               "isOptional": false,
               "releaseTag": "Beta",
-              "name": "contextGateLabel",
+              "name": "debugLogRowDescription",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -10271,16 +10773,16 @@
             },
             {
               "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#contextGateReason:member",
-              "docComment": "",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogSendDisabled:member",
+              "docComment": "/**\n * Whether the compose box's Send button is inert: a send is already in flight, or the host made the note required and it is still blank.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "get contextGateReason(): "
+                  "text": "get debugLogSendDisabled(): "
                 },
                 {
                   "kind": "Content",
-                  "text": "string"
+                  "text": "boolean"
                 },
                 {
                   "kind": "Content",
@@ -10290,7 +10792,7 @@
               "isReadonly": true,
               "isOptional": false,
               "releaseTag": "Beta",
-              "name": "contextGateReason",
+              "name": "debugLogSendDisabled",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -10301,26 +10803,26 @@
             },
             {
               "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#contextLimit:member",
-              "docComment": "/**\n * Context window size for the active model, if known.\n */\n",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogSubmitAnnouncement:member",
+              "docComment": "/**\n * Text for the always-present live region beside the agent-log row, so the outcome of a submission is announced even when the compose box is closed or opted out (`note: false`), where the only visible change is the button label.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "get contextLimit(): "
+                  "text": "get debugLogSubmitAnnouncement(): "
                 },
                 {
                   "kind": "Content",
-                  "text": "number | undefined"
+                  "text": "string"
                 },
                 {
                   "kind": "Content",
-                  "text": ";\n\nset contextLimit(value: number | undefined);"
+                  "text": ";"
                 }
               ],
-              "isReadonly": false,
+              "isReadonly": true,
               "isOptional": false,
               "releaseTag": "Beta",
-              "name": "contextLimit",
+              "name": "debugLogSubmitAnnouncement",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -10331,26 +10833,26 @@
             },
             {
               "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#contextTokens:member",
-              "docComment": "/**\n * Most recent prompt token count from the AI provider, if available.\n */\n",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogSubmitButtonLabel:member",
+              "docComment": "/**\n * Label on the agent-log row's Send button. While the compose box is open the row button is just the (disabled) trigger, so it keeps its idle label; otherwise it reflects the in-flight / flashed outcome of the last submission.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "get contextTokens(): "
+                  "text": "get debugLogSubmitButtonLabel(): "
                 },
                 {
                   "kind": "Content",
-                  "text": "number | undefined"
+                  "text": "string"
                 },
                 {
                   "kind": "Content",
-                  "text": ";\n\nset contextTokens(value: number | undefined);"
+                  "text": ";"
                 }
               ],
-              "isReadonly": false,
+              "isReadonly": true,
               "isOptional": false,
               "releaseTag": "Beta",
-              "name": "contextTokens",
+              "name": "debugLogSubmitButtonLabel",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -10361,43 +10863,29 @@
             },
             {
               "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#costSessionHistory:member",
-              "docComment": "/**\n * Persisted finalized cost sessions shown on the Usage tab build history list.\n *\n * A get/set pair rather than a read-only projection: the banking tests seed rows to model a page load that found some, and a host provider's rows arrive the same way.\n */\n",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogSubmitLabel:member",
+              "docComment": "/**\n * The Send button's idle label, as the host configured it.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "get costSessionHistory(): "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "CostSessionRecord",
-                  "canonicalReference": "@genesislcap/ai-assistant!CostSessionRecord:interface"
-                },
-                {
-                  "kind": "Content",
-                  "text": "[]"
+                  "text": "get debugLogSubmitLabel(): "
                 },
                 {
                   "kind": "Content",
-                  "text": ";\n\nset costSessionHistory(value: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "CostSessionRecord",
-                  "canonicalReference": "@genesislcap/ai-assistant!CostSessionRecord:interface"
+                  "text": "string"
                 },
                 {
                   "kind": "Content",
-                  "text": "[]);"
+                  "text": ";"
                 }
               ],
-              "isReadonly": false,
+              "isReadonly": true,
               "isOptional": false,
               "releaseTag": "Beta",
-              "name": "costSessionHistory",
+              "name": "debugLogSubmitLabel",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 3
+                "endIndex": 2
               },
               "isStatic": false,
               "isProtected": false,
@@ -10405,26 +10893,26 @@
             },
             {
               "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#cumulativeCostUsd:member",
-              "docComment": "/**\n * Lifetime USD across every project in the history scope.\n */\n",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogSubmitResult:member",
+              "docComment": "/**\n * Outcome of the last log submission, shown briefly on the button ('Sent' / 'Failed — retry') then cleared by `setDebugLogSubmitResult`'s timer. `null` when idle.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "get cumulativeCostUsd(): "
+                  "text": "debugLogSubmitResult: "
                 },
                 {
                   "kind": "Content",
-                  "text": "number"
+                  "text": "'sent' | 'error' | null"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isReadonly": true,
+              "isReadonly": false,
               "isOptional": false,
               "releaseTag": "Beta",
-              "name": "cumulativeCostUsd",
+              "name": "debugLogSubmitResult",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -10435,27 +10923,26 @@
             },
             {
               "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#cumulativeUsage:member",
-              "docComment": "/**\n * Lifetime usage across every project in the history scope — rows only, never plus live.\n */\n",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogSubmitResultFlashMs:member",
+              "docComment": "/**\n * How long 'Sent' shows before idle. Overridable so tests need not wait 4 seconds.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "get cumulativeUsage(): "
+                  "text": "debugLogSubmitResultFlashMs: "
                 },
                 {
-                  "kind": "Reference",
-                  "text": "AggregateUsage",
-                  "canonicalReference": "@genesislcap/foundation-ai!AggregateUsage:interface"
+                  "kind": "Content",
+                  "text": "number"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isReadonly": true,
+              "isReadonly": false,
               "isOptional": false,
               "releaseTag": "Beta",
-              "name": "cumulativeUsage",
+              "name": "debugLogSubmitResultFlashMs",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -11679,6 +12166,54 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#noteDebugLogInput:member(1)",
+              "docComment": "/**\n * The note's `@input`: track the text, and let typing dismiss a standing failure.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "noteDebugLogInput(value: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "value",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "noteDebugLogInput"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#onChatHeaderMouseDown:member(1)",
@@ -11955,6 +12490,37 @@
               "isAbstract": false,
               "name": "onSettingsModalTabsChange"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#openDebugLogCompose:member(1)",
+              "docComment": "/**\n * The row's Send button. With a compose box configured (the default) it opens the box and focuses the note so the user can caption the log; with `note: false` it sends straight away, as before.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "openDebugLogCompose(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "openDebugLogCompose"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#openSettingsModal:member(1)",
@@ -13621,6 +14187,36 @@
               "isAbstract": false,
               "name": "setSettingsModalTab"
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#settingsAgentLogSectionVisible:member",
+              "docComment": "/**\n * Whether the settings \"Agent log\" section renders — shown when either action is enabled: the download button (`allowDebugDownload`) or the host-transport Send button (`debugLogSubmit`). Each button is additionally gated on its own flag inside the section, so a host can enable one without the other.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get settingsAgentLogSectionVisible(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "settingsAgentLogSectionVisible",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#settingsAppSectionVisible:member",
@@ -14920,24 +15516,60 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "boolean"
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "stopButtonVisible",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#submitDebugLog:member(1)",
+              "docComment": "/**\n * Hand the agent log to the host's `ui.debugLogSubmit.send` callback — the Send button next to Download. Reuses `buildDownloadLog`, so the submitted log is byte-identical to what Download saves (lifetime-stitched when the provider persists diagnostics). The assistant is vendor-agnostic: the callback owns the transport (Sentry feedback, a support API, an upload endpoint). Outcome lands in `debugLogSubmitResult` so the button can flash 'Sent'/'Failed'; failures also go to the logger with the cause.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "submitDebugLog(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<void>"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isReadonly": true,
-              "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "stopButtonVisible",
-              "propertyTypeTokenRange": {
+              "isStatic": false,
+              "returnTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 2
+                "endIndex": 3
               },
-              "isStatic": false,
+              "releaseTag": "Beta",
               "isProtected": false,
-              "isAbstract": false
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "submitDebugLog"
             },
             {
               "kind": "Method",
@@ -15010,6 +15642,36 @@
               "isAbstract": false,
               "name": "submitMessage"
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#submittingDebugLog:member",
+              "docComment": "/**\n * True while `submitDebugLog` is building and handing off the log. Same role as `downloadingDebugLog` for the Send button: the lifetime-stitch and the host's `send` callback are async, so the button needs a visible in-flight state.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "submittingDebugLog: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "submittingDebugLog",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#suggestionsState:member",
@@ -15114,6 +15776,76 @@
               "isAbstract": false,
               "name": "switchSession"
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#timestampClock:member",
+              "docComment": "/**\n * Epoch ms the transcript's relative timestamps are measured against.\n *\n * A relative label is only correct at the instant it renders: FAST evaluates the binding once, and an idle conversation never re-renders, so \"2 minutes ago\" would still read \"2 minutes ago\" an hour later. Making the formatter read this observable instead of `Date.now()` gives every row one shared, invalidatable clock — a tick re-evaluates them all.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "timestampClock: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "timestampClock",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#timestampDisplay:member",
+              "docComment": "/**\n * When each message shows its timestamp — `'off'`, `'hover'` (default) or `'always'`.\n *\n * Falls back to `DEFAULT_TIMESTAMP_DISPLAY` rather than `'off'` when there is no store yet: this preference defaults ON, so the pre-store render must match the state the baseline is about to resolve to, or timestamps would visibly pop in on connect.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get timestampDisplay(): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "TimestampDisplay",
+                  "canonicalReference": "@genesislcap/foundation-ai!TimestampDisplay:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";\n\nset timestampDisplay(value: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "TimestampDisplay",
+                  "canonicalReference": "@genesislcap/foundation-ai!TimestampDisplay:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ");"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "timestampDisplay",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#toggleAgentPicker:member(1)",
@@ -16527,6 +17259,52 @@
           ],
           "extendsTokenRanges": []
         },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@genesislcap/ai-assistant!messageTimestampTemplate:var",
+          "docComment": "/**\n * The timestamp shown beside the sender name (GENC-1257).\n *\n * Two strings, not one. A screen reader announces a `<time>` element's TEXT — it has no implicit ARIA role, and the `datetime` attribute is never surfaced to the user — so the relative text is hidden from assistive tech and paired with a visually-hidden absolute string. Otherwise AT would hear \"5 minutes ago\" with nothing to anchor it, and in `'hover'` mode would hear it for a timestamp sighted users never asked to see. `datetime` stays because it is correct HTML and useful to tooling, not for a11y.\n *\n * Only the VISUAL reveal is hover-gated, in CSS — see `.message-timestamp`. `opacity: 0` leaves the element in the accessibility tree, so AT gets a time in both visible modes; `'off'` is the only mode that removes it.\n *\n * Reads `timestampClock` rather than `Date.now()` so every row shares one invalidatable clock and a tick re-evaluates them all; see `FoundationAiAssistant.timestampClock`.\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "messageTimestampTemplate: "
+            },
+            {
+              "kind": "Reference",
+              "text": "ViewTemplate",
+              "canonicalReference": "@microsoft/fast-element!ViewTemplate:class"
+            },
+            {
+              "kind": "Content",
+              "text": "<"
+            },
+            {
+              "kind": "Reference",
+              "text": "ChatMessage",
+              "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ", "
+            },
+            {
+              "kind": "Reference",
+              "text": "FoundationAiAssistant",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant:class"
+            },
+            {
+              "kind": "Content",
+              "text": ">"
+            }
+          ],
+          "fileUrlPath": "src/main/main.template.ts",
+          "isReadonly": true,
+          "releaseTag": "Public",
+          "name": "messageTimestampTemplate",
+          "variableTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 7
+          }
+        },
         {
           "kind": "Variable",
           "canonicalReference": "@genesislcap/ai-assistant!NOOP_ACTIVITY_BUS:var",
@@ -18525,6 +19303,105 @@
             "endIndex": 0
           }
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/ai-assistant!ResolvedDebugLogNoteConfig:interface",
+          "docComment": "/**\n * `ChatDebugLogNoteConfig` with every option resolved.\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface ResolvedDebugLogNoteConfig "
+            }
+          ],
+          "fileUrlPath": "src/utils/resolve-debug-log-note.ts",
+          "releaseTag": "Public",
+          "name": "ResolvedDebugLogNoteConfig",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!ResolvedDebugLogNoteConfig#maxLength:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "maxLength: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "maxLength",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!ResolvedDebugLogNoteConfig#placeholder:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "placeholder: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "placeholder",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!ResolvedDebugLogNoteConfig#required:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "required: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Public",
+              "name": "required",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@genesislcap/ai-assistant!ResponseSchemaInput:type",
@@ -19704,6 +20581,33 @@
                 "startIndex": 1,
                 "endIndex": 2
               }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SessionPreferences#timestampDisplay:member",
+              "docComment": "/**\n * When message timestamps are shown (`TimestampDisplay` values, as plain strings). Absent keeps the `chatConfig.ui.showTimestamps` default, which is `'hover'`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "timestampDisplay?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Public",
+              "name": "timestampDisplay",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
             }
           ],
           "extendsTokenRanges": []
@@ -22111,7 +23015,7 @@
               "text": "export interface TurnSnapshot "
             }
           ],
-          "fileUrlPath": "src/components/chat-driver/chat-driver.ts",
+          "fileUrlPath": "src/components/chat-driver/turn-recorder.ts",
           "releaseTag": "Beta",
           "name": "TurnSnapshot",
           "preserveMemberOrder": false,
@@ -22445,7 +23349,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@genesislcap/ai-assistant!TurnSnapshot#turnIndex:member",
-              "docComment": "/**\n * Turn identifier, always a string. A driver's own turns are the bare counter (`\"0\"`, `\"1\"`, … — monotonic, does not reset on agent swap). Turns forwarded up from a sub-agent are re-labelled under the parent turn that activated them — a sub-agent invoked on parent turn 5 contributes `\"5-1\"`, `\"5-2\"`, …, and a nested sub-agent on `\"5-2\"` contributes `\"5-2-1\"`, …. See `forwardSubAgentSnapshots`.\n */\n",
+              "docComment": "/**\n * Turn identifier, always a string. A driver's own turns are the bare counter (`\"0\"`, `\"1\"`, … — monotonic, does not reset on agent swap). Turns forwarded up from a sub-agent are re-labelled under the parent turn that activated them — a sub-agent invoked on parent turn 5 contributes `\"5-1\"`, `\"5-2\"`, …, and a nested sub-agent on `\"5-2\"` contributes `\"5-2-1\"`, …. See `forwardSubAgent`.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",