@genesislcap/ai-assistant 15.25.1 → 15.27.0-FUI-2617.1

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",
@@ -15114,6 +15114,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 +16597,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",
@@ -19704,6 +19820,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 +22254,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 +22588,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",

package/dist/ai-assistant.d.ts

@@ -23,6 +23,7 @@ import { InterfaceSymbol } from '@microsoft/fast-foundation';
 import type { Modal } from '@genesislcap/rapid-design-system';
 import { ModelTagAppearance } from '@genesislcap/foundation-ai';
 import type { SubAgentFailureReason } from '@genesislcap/foundation-ai';
+import type { TimestampDisplay } from '@genesislcap/foundation-ai';
 import type { TurnFailureReason } from '@genesislcap/foundation-ai';
 import { ViewTemplate } from '@genesislcap/web-core';
 
@@ -1463,17 +1464,8 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
     private busy;
     /** Epoch ms when the current turn loop began — drives the `turn.end` duration. */
     private turnStartedAt;
-    private pendingInteractions;
-    /**
-     * Live per-interaction contexts (GENC-1390), keyed by interactionId. Created in
-     * `requestInteraction` alongside the pending entry, disposed + removed in
-     * `resolveInteraction`. Non-serialisable (sockets, timers, subscriber sets), so
-     * they live here on the driver — not on the DOM, not in the persisted store — and
-     * therefore survive the element remounts (layout reflow/drag, transcript
-     * re-render) that this feature exists to make harmless. At most one is live at a
-     * time (see the one-interaction-at-a-time guard in `requestInteraction`).
-     */
-    private interactionContexts;
+    /** Custom UI interactions: the pending call, its live context, and any host to delegate to. */
+    private readonly interactions;
     private systemPrompt?;
     /**
      * Preamble cost of the most recent request, set at the request-build site.
@@ -1518,13 +1510,6 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      */
     private activeAgentLabel?;
     private displayName?;
-    /**
-     * When set, `requestInteraction` delegates to this callback instead of using
-     * this driver's own pending map. Wired by `invokeSubAgent` so a sub-agent's
-     * widget renders in — and resolves through — the parent (ultimately the
-     * root) driver, where the main UI is listening.
-     */
-    private hostInteractionRequester?;
     /**
      * When set (e.g. by OrchestratingDriver), applied only to the conversation slice
      * sent to the model — stored `history` stays unchanged for UI and logging.
@@ -1637,33 +1622,10 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      */
     private agentReleaseRequested;
     /**
-     * Ring buffer of per-LLM-call snapshots. Cap is configurable via
-     * `chatConfig.agent.maxTurnSnapshots`; older entries drop off as new ones
-     * arrive. See {@link TurnSnapshot} for the captured shape.
-     */
-    private turnSnapshots;
-    /**
-     * `turn` + `message` diagnostic-log entries harvested from an out-of-band source (a resolved
-     * interaction whose widget returned `InteractionResult.diagnostics` — e.g. a server-side
-     * ChatDriver's debug log). `event` entries are NOT kept here — they're folded into the session's
-     * meta-event registry via `mergeMetaEvents` (see `resolveInteraction`) so they inherit fresh host
-     * indices, and reach the log through `getMetaEvents`. Append-only; the host folds these into its
-     * debug log alongside this driver's own timeline. Not cleared here — it lives with the driver
-     * instance, like `turnSnapshots`, so a new chat (fresh driver) starts empty while a compaction
-     * (same instance) keeps it. (GENC-1461.)
-     */
-    private readonly externalDiagnostics;
-    /**
-     * Monotonic count of external-diagnostics batches harvested this driver-lifetime. Namespaces each
-     * batch's re-keyed `turn` entries so distinct server generations in one chat session can't collide
-     * on `turnIndex` in the forward-capture persister (which dedups turns by that key). (GENC-1461.)
+     * Per-turn snapshots, forwarded sub-agent snapshots, and harvested external diagnostics —
+     * everything the exported debug log draws from this driver.
      */
-    private externalDiagnosticsBatches;
-    /** Monotonic counter that survives agent swaps — useful for cross-referencing with history. */
-    private globalTurnIndex;
-    /** Captured from `applyAgent` so we don't store the whole `AgentConfig`. */
-    private debugSnapshotter?;
-    private readonly maxTurnSnapshots;
+    private readonly turnRecorder;
     /**
      * Aborted by `dispose()` on driver teardown (e.g. an agent-config swap).
      * Threaded into every provider call as `ChatRequestOptions.signal`, so a
@@ -1855,7 +1817,7 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      * on to completion or the transport timeout. Called by the host on driver
      * swap and by `OrchestratingDriver.dispose()`. Idempotent.
      *
-     * Deliberately does NOT settle `pendingInteractions` here: dispose is never
+     * 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
@@ -2096,7 +2058,7 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      * log exporter to show what the LLM saw on each turn — system prompt, tool
      * surface, and agent-supplied state (e.g. a machine snapshot).
      *
-     * Ring-buffered at `MAX_TURN_SNAPSHOTS`; older entries are dropped.
+     * Ring-buffered at `maxTurnSnapshots`; older entries are dropped.
      */
     getTurnSnapshots(): ReadonlyArray<TurnSnapshot>;
     /**
@@ -2104,37 +2066,10 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      * `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.)
+     * session's meta-event registry instead and reach the log via `getMetaEvents`. Opaque,
+     * chronologically sorted by the host at assemble time. (GENC-1461.)
      */
     getExternalDiagnostics(): ReadonlyArray<DiagnosticEntry>;
-    /**
-     * Merge a sub-agent's turn snapshots into this driver's buffer so they surface
-     * as `kind:'turn'` entries in the exported debug log. The child runs as a
-     * separate, discarded driver, so its snapshots would otherwise be lost. Each is
-     * re-labelled under the parent turn that activated the sub-agent: the child's
-     * own (numeric) turns become `"<parentTurn>-1"`, `"-2"`, … (1-based, in order);
-     * any already-forwarded grand-child labels (strings) have their leading segment
-     * remapped the same way, so nesting composes (`"5-2"` → `"5-2-1"`).
-     *
-     * Note: two sub-agents invoked in the *same* parent turn share the prefix, so
-     * their labels can repeat — `agentName` on each snapshot disambiguates them.
-     */
-    private forwardSubAgentSnapshots;
-    /**
-     * Push one snapshot to the ring buffer. Called inside `runToolLoop` just
-     * before each LLM call — that's the latest point where the prompt, tool
-     * surface, and agent state line up with what the model is about to see.
-     *
-     * Returns the pushed object so the caller can back-fill what only the response
-     * knows (`usage`). Mutating it after the fact is safe whether or not the ring
-     * buffer has since evicted it — an evicted snapshot is simply no longer exported.
-     */
-    private recordTurnSnapshot;
-    /**
-     * Optional transform applied to conversation history immediately before each LLM request.
-     * Cleared when `undefined`. Does not alter stored history.
-     */
     /**
      * Mid-loop context guard policy (GENC-1567). `undefined` disables the guard.
      *
@@ -2168,6 +2103,10 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      * far is not lost.
      */
     private contextExhausted;
+    /**
+     * Optional transform applied to conversation history immediately before each LLM request.
+     * Cleared when `undefined`. Does not alter stored history.
+     */
     setProviderHistoryTransform(transform?: (history: ChatMessage[]) => ChatMessage[]): void;
     getHistory(): ReadonlyArray<ChatMessage>;
     getRawHistory(): readonly ChatMessage[];
@@ -2253,21 +2192,12 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      */
     requestInteraction<T>(componentName: string, data: any, options?: InteractionRequestOptions): Promise<T>;
     /**
-     * Add external (non-LLM) spend to an interaction's message AFTER it has resolved.
-     *
-     * **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.
+     * 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.
      *
-     * 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.
+     * Additive by design: the caller reports a DELTA, not a running total, so repeated calls sum.
      *
      * 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.
@@ -2277,8 +2207,8 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      * @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.
+     *   `false` also records an `interaction.external-cost-dropped` meta event, so money can never
+     *   disappear without a trace.
      * @beta
      */
     recordExternalCost(interactionId: string, costUsd: number): boolean;
@@ -2294,14 +2224,10 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      */
     getInteractionContext(interactionId: string): InteractionContext | undefined;
     /**
-     * Resolve every in-flight interaction with a `'timeout'` result, closing its
-     * widget read-only. Used when a sub-agent that owns the open widget times out:
-     * the widget is parked in *this* driver's map (interactions resolve on the
-     * host, not the child), so cancelling it here unblocks the sub-agent handler
-     * awaiting it. The "one interaction at a time" invariant means there is at
-     * most one.
+     * Replace the history message owning `interactionId`. `false` when it is no longer in history.
+     * Does not announce the change — the interaction paths differ on whether they should.
      */
-    private cancelPendingInteractions;
+    private patchInteractionMessage;
     /**
      * Seeds the driver with a prior conversation history so a new component instance
      * can continue an existing conversation. Call this before the first user message.
@@ -2364,6 +2290,8 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      */
     private appendDriverNotice;
     private appendToHistory;
+    /** Announce the current history to the host. */
+    private notifyHistoryUpdated;
 }
 
 /**
@@ -3218,6 +3146,37 @@ export declare class FoundationAiAssistant extends GenesisElement {
     /** Current user-facing toggle state for agent switch indicator visibility. */
     get showAgentSwitchIndicator(): boolean;
     set showAgentSwitchIndicator(value: boolean);
+    /**
+     * When each message shows its timestamp — `'off'`, `'hover'` (default) or `'always'`.
+     *
+     * 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.
+     */
+    get timestampDisplay(): TimestampDisplay;
+    set timestampDisplay(value: TimestampDisplay);
+    /**
+     * Epoch ms the transcript's relative timestamps are measured against.
+     *
+     * 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.
+     */
+    timestampClock: number;
+    /** Handle for the `TIMESTAMP_CLOCK_INTERVAL_MS` ticker; undefined while stopped. */
+    private _timestampClockTimer?;
+    /**
+     * Start or stop the timestamp clock to match the current mode and connection state.
+     *
+     * Idempotent, and safe to call from either lifecycle end — it is driven from
+     * `connectedCallback`, `disconnectedCallback` and the `timestampDisplay` setter, which
+     * can fire in any order. Nothing runs while the mode is `'off'` (no binding reads the
+     * clock) or while disconnected (a timer outliving its element is a leak, and a
+     * popped-out view disconnects without the session ending).
+     */
+    private syncTimestampClock;
     /** Currently enabled animations. */
     get enabledAnimations(): AiAssistantAnimation[];
     set enabledAnimations(value: AiAssistantAnimation[]);
@@ -4794,6 +4753,25 @@ export declare interface ManualSelectionConfig {
     hint?: string;
 }
 
+/**
+ * The timestamp shown beside the sender name (GENC-1257).
+ *
+ * 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.
+ *
+ * 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.
+ *
+ * Reads `timestampClock` rather than `Date.now()` so every row shares one invalidatable
+ * clock and a tick re-evaluates them all; see `FoundationAiAssistant.timestampClock`.
+ */
+export declare const messageTimestampTemplate: ViewTemplate<ChatMessage, FoundationAiAssistant>;
+
 export { ModelTagAppearance }
 
 /**
@@ -5381,6 +5359,11 @@ export declare interface SessionPreferences {
     showThinkingSteps?: boolean;
     showNarration?: boolean;
     showAgentSwitchIndicator?: boolean;
+    /**
+     * When message timestamps are shown (`TimestampDisplay` values, as plain strings).
+     * Absent keeps the `chatConfig.ui.showTimestamps` default, which is `'hover'`.
+     */
+    timestampDisplay?: string;
     /** Enabled loading-animation ids (`AiAssistantAnimation` values, as plain strings). */
     animations?: string[];
 }
@@ -5979,7 +5962,7 @@ export declare interface TurnSnapshot {
      * 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`.
+     * `forwardSubAgent`.
      */
     turnIndex: string;
     /** ISO timestamp captured just before the LLM call. */