@genesislcap/ai-assistant 15.15.2 → 15.16.0

package/dist/custom-elements.json

@@ -598,6 +598,14 @@
             "module": "./components/chat-interaction-wrapper/chat-interaction-wrapper"
           }
         },
+        {
+          "kind": "js",
+          "name": "InteractionCostEventDetail",
+          "declaration": {
+            "name": "InteractionCostEventDetail",
+            "module": "./components/chat-interaction-wrapper/chat-interaction-wrapper"
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -3620,6 +3628,25 @@
               "name": "syncShowingSplash",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "syncUsageTotals",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "messages",
+                  "type": {
+                    "text": "readonly ChatMessage[]"
+                  }
+                }
+              ],
+              "description": "Recompute the session's cost and token buckets from a transcript.\n\nTakes the list rather than reading `this.messages`, because it has two callers with\ndifferent sources: the `messages` setter passes the rendered list, and post-resolve external\ncost passes the DRIVER's history — spend recorded there must reach the total WITHOUT\nreassigning `messages`, which would re-render the live interaction row. See\n`onExternalCostRecorded`.\n\nRecomputing (rather than incrementing on append) keeps the totals correct under any mutation\nof the message list — clear-chat, re-render, restore. `sumUsage` recurses into\n`toolCall.subAgentTrace`, so work a sub-agent did (possibly on another provider at other\nrates) counts, and it reads the usage a compaction banked onto its summary, so shrinking\nhistory no longer shrinks the totals."
+            },
             {
               "kind": "method",
               "name": "handleMessagesUpdate",
@@ -4565,6 +4592,25 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "readFileAsBase64",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<string>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "file",
+                  "type": {
+                    "text": "File"
+                  }
+                }
+              ],
+              "description": "The base64 payload of a file, without any `data:` prefix — the raw form\n`ChatImageAttachment.data` specifies (transports add their own framing)."
+            },
             {
               "kind": "method",
               "name": "processFiles",
@@ -4580,6 +4626,10 @@
                   "type": {
                     "text": "File[]"
                   }
+                },
+                {
+                  "name": "existingBytes",
+                  "default": "0"
                 }
               ]
             },
@@ -4683,6 +4733,19 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "handleInteractionCost",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "description": "A widget reporting spend it incurred AFTER resolving.\n\nNote what this deliberately does NOT do: no `startLoadingTimer()`. This is bookkeeping about a\nturn that already finished, so it must be invisible — showing a spinner would tell the user the\nassistant is working when nothing is pending."
+            },
             {
               "kind": "field",
               "name": "isComposerResizable",
@@ -5066,7 +5129,7 @@
           "type": {
             "text": "Record<MetaEventType, MetaEventImportance>"
           },
-          "default": "{\n  'turn.error': 'high',\n  'tool.failed': 'high',\n  'subagent.failed': 'high',\n  'file.read-failed': 'high',\n  'suggestions.failed': 'high',\n  'context.threshold-crossed': 'high',\n  'context.compacted': 'high',\n  'persistence.restore-orphan': 'high',\n  // A save that did not land is silent data loss in progress: the transcript on screen\n  // is no longer backed by the store, and every later turn widens the gap. GENC-1511.\n  'persistence.save-failed': 'high',\n\n  'assistant.connected': 'normal',\n  'assistant.disconnected': 'normal',\n  'assistant.popout': 'normal',\n  'assistant.popin': 'normal',\n  'driver.created': 'normal',\n  'state.changed': 'normal',\n  'turn.start': 'normal',\n  'turn.end': 'normal',\n  'turn.retry': 'normal',\n  'tool.unresolved': 'normal',\n  'subagent.started': 'normal',\n  'subagent.completed': 'normal',\n  'agent.handoff': 'normal',\n  'agent.pinned': 'normal',\n  'agent.unpinned': 'normal',\n  'provider.selected': 'normal',\n  'interaction.requested': 'normal',\n  'interaction.resolved': 'normal',\n  'external-diagnostics.folded': 'normal',\n  'session.cleared': 'normal',\n  'session.switched': 'low',\n  'session.switch-deferred': 'low',\n  'persistence.restored': 'normal',\n  'persistence.suppressed': 'normal',\n  'persistence.not-resumable': 'normal',\n\n  'driver.wired': 'low',\n  'driver.unwired': 'low',\n  'context.updated': 'low',\n  'context.condensed': 'low',\n  'panel.toggled': 'low',\n  'persistence.toggled': 'low',\n  'persistence.saved': 'low',\n  'attachment.added': 'low',\n}",
+          "default": "{\n  'turn.error': 'high',\n  'tool.failed': 'high',\n  'subagent.failed': 'high',\n  'file.read-failed': 'high',\n  'suggestions.failed': 'high',\n  'context.threshold-crossed': 'high',\n  'context.compacted': 'high',\n  'persistence.restore-orphan': 'high',\n  // A save that did not land is silent data loss in progress: the transcript on screen\n  // is no longer backed by the store, and every later turn widens the gap. GENC-1511.\n  'persistence.save-failed': 'high',\n\n  'assistant.connected': 'normal',\n  'assistant.disconnected': 'normal',\n  'assistant.popout': 'normal',\n  'assistant.popin': 'normal',\n  'driver.created': 'normal',\n  'state.changed': 'normal',\n  'turn.start': 'normal',\n  'turn.end': 'normal',\n  'turn.retry': 'normal',\n  'tool.unresolved': 'normal',\n  'subagent.started': 'normal',\n  'subagent.completed': 'normal',\n  'agent.handoff': 'normal',\n  'agent.pinned': 'normal',\n  'agent.unpinned': 'normal',\n  'provider.selected': 'normal',\n  'interaction.requested': 'normal',\n  'interaction.resolved': 'normal',\n  // Bookkeeping about an already-finished turn; interesting when reconciling a session total.\n  'interaction.external-cost': 'normal',\n  // Spend that was billed but could NOT be recorded (the message was trimmed/condensed away, or\n  // the value was not real spend). 'high': it is the one way the session total goes quietly\n  // wrong, so it must stand out when reconciling.\n  'interaction.external-cost-dropped': 'high',\n  'external-diagnostics.folded': 'normal',\n  'session.cleared': 'normal',\n  'session.switched': 'low',\n  'session.switch-deferred': 'low',\n  'persistence.restored': 'normal',\n  'persistence.suppressed': 'normal',\n  'persistence.not-resumable': 'normal',\n\n  'driver.wired': 'low',\n  'driver.unwired': 'low',\n  'context.updated': 'low',\n  'context.condensed': 'low',\n  'panel.toggled': 'low',\n  'persistence.toggled': 'low',\n  'persistence.saved': 'low',\n  'attachment.added': 'low',\n}",
           "description": "Importance is intrinsic to the event *type*, not the instance, so it's\ndefined once here and stamped automatically by recordMetaEvent — call\nsites never pass it. The `Record` is exhaustive: adding a `MetaEventType`\nwithout a level here is a compile error.\n\n- `high`   — failures and hard limits you almost always want to see.\n- `normal` — meaningful session flow you read to follow what happened.\n- `low`    — frequent UI / bookkeeping noise, usually safe to skip."
         },
         {
@@ -9248,6 +9311,33 @@
               ],
               "description": "Request a custom UI interaction. Emits a new message with the interaction.\nTool handlers can call this to pause execution until the user completes the UI interaction.\n\nIf a host requester is wired (sub-agent case), the call delegates upward\nso the interaction lives on the parent — the main UI is only listening to\nthe root driver. Only one interaction may be in flight at any time on a\ngiven root: concurrent calls (e.g. two parallel sub-agents both spawning a\nwidget) throw. Parallel sub-agents are for parallel work, not for user\ninteraction, which is inherently sequential."
             },
+            {
+              "kind": "method",
+              "name": "recordExternalCost",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "parameters": [
+                {
+                  "name": "interactionId",
+                  "type": {
+                    "text": "string"
+                  },
+                  "description": "the interaction whose message owns the spend."
+                },
+                {
+                  "name": "costUsd",
+                  "type": {
+                    "text": "number"
+                  },
+                  "description": "a positive delta in USD. Non-finite, zero and negative values are ignored."
+                }
+              ],
+              "description": "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\ntotal only through `InteractionResult.costUsd`, which is read exactly once — `resolveInteraction`\ndoes its whole job inside `if (interaction)` and then deletes the entry from\n`pendingInteractions`. That is correct for the resolution itself, but it assumes a widget stops\ncosting money when it resolves, and several deliberately do not: a widget that resolves EARLY so\nthe assistant stops waiting (options shown, a preview rendered) may stay interactive for minutes\nafterwards and do more paid work on the user's behalf. Re-emitting `interaction-completed` does\nnot help — with the interaction gone from the map the call is a silent no-op — so that spend had\nnowhere to go and was simply missing from the figure shown to the user.\n\nAdditive by design: the caller reports a DELTA, not a running total, so repeated calls sum. It\ntouches only `externalCostUsd`; the recorded `interaction.resolved` payload is left exactly as\nthe resolution wrote it, because this is not a second resolution and must not read like one.\n\nDeliberately does NOT require the interaction to be pending, does not resurrect it, and has no\nloading/turn side effects — this is bookkeeping about a turn that already happened."
+            },
             {
               "kind": "method",
               "name": "resolveInteraction",
@@ -9654,12 +9744,18 @@
                 "text": "CustomEvent"
               }
             },
+            {
+              "name": "external-cost-recorded",
+              "type": {
+                "text": "CustomEvent"
+              }
+            },
             {
               "name": "history-updated",
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired whenever the in-memory chat history changes (append, tool loop, interaction resolution) with the full history snapshot. detail: `ReadonlyArray<ChatMessage>`"
+              "description": "Fired whenever the in-memory chat history changes (append, tool loop, interaction resolution, post-resolve external cost) with the full history snapshot. detail: `ReadonlyArray<ChatMessage>`"
             },
             {
               "name": "interaction-stop",
@@ -9857,6 +9953,10 @@
             {
               "description": "Fired when the interaction finishes. detail: `InteractionCompletedEventDetail`",
               "name": "interaction-completed"
+            },
+            {
+              "description": "Fired when a widget spends money AFTER resolving. detail: `InteractionCostEventDetail`",
+              "name": "interaction-cost"
             }
           ],
           "superclass": {
@@ -10154,6 +10254,30 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "recordExternalCost",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "interactionId",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "costUsd",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Delegated for the same reason as `resolveInteraction`: the history that owns the\ninteraction — and therefore the cost — lives on the wrapped driver, not here."
+            },
             {
               "kind": "method",
               "name": "getInteractionContext",
@@ -10807,101 +10931,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/settings-modal/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "SettingsModalTemplate",
-          "declaration": {
-            "name": "SettingsModalTemplate",
-            "module": "./settings-modal.template"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "type",
-          "declaration": {
-            "name": "type",
-            "module": "./settings-modal.template"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "SettingsModalTab",
-          "declaration": {
-            "name": "SettingsModalTab",
-            "module": "./settings-modal.template"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "settingsModalStyles",
-          "declaration": {
-            "name": "settingsModalStyles",
-            "module": "./settings-modal.styles"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/settings-modal/settings-modal.styles.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "settingsModalStyles",
-          "default": "css`\n  /*\n   * Section headings come from the shared fragment the package also exports, so a host titling\n   * its own slotted section applies the same rule rather than a copy of it.\n   */\n  ${assistantSettingsSectionTitleStyles}\n\n  *,\n  *::before,\n  *::after {\n    box-sizing: border-box;\n  }\n\n  .settings-modal {\n    --ai-tier-badge-bg-mix: 14%;\n    --ai-tier-badge-text-lighten: 18%;\n  }\n\n  .settings-modal::part(dialog) {\n    max-width: 620px;\n    width: calc(100vw - 48px);\n    max-height: calc(100vh - 48px);\n    padding: 0;\n  }\n\n  .settings-modal::part(content) {\n    display: flex;\n    flex-direction: column;\n    min-height: 0;\n    padding: 0;\n    width: 100%;\n  }\n\n  .settings-modal::part(top) {\n    padding: calc(var(--design-unit) * 4px) calc(var(--design-unit) * 5px);\n    border-bottom: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-modal::part(bottom) {\n    padding: calc(var(--design-unit) * 4px) calc(var(--design-unit) * 5px);\n    border-top: 1px solid var(--neutral-stroke-rest);\n    border-bottom-left-radius: var(--card-border-radius, calc(var(--control-corner-radius) * 1px));\n    border-bottom-right-radius: var(--card-border-radius, calc(var(--control-corner-radius) * 1px));\n    background-color: var(--neutral-layer-2);\n  }\n\n  .settings-modal-header {\n    display: flex;\n    align-items: center;\n    min-width: 0;\n  }\n\n  .settings-modal-title {\n    margin: 0;\n    font-size: 16px;\n    font-weight: 600;\n    display: flex;\n    align-items: center;\n    gap: calc(var(--design-unit) * 2px);\n    color: var(--neutral-foreground-rest);\n  }\n\n  .settings-modal-content {\n    display: flex;\n    flex-direction: column;\n    min-height: 0;\n    flex: 1 1 auto;\n  }\n\n  .settings-modal-tabs::part(tablist) {\n    border-bottom: 0;\n    padding: 0 calc(var(--design-unit) * 5px);\n    column-gap: calc(var(--design-unit) * 5px);\n  }\n\n  .settings-modal-tabs::part(activeIndicator) {\n    height: 2px;\n  }\n\n  .settings-modal-tab {\n    padding: 0;\n    font-weight: 600;\n    gap: 6px;\n  }\n\n  .settings-modal-tab[aria-selected='true'] {\n    color: var(--neutral-foreground-rest);\n  }\n\n  .settings-modal-tabs::part(tabpanel) {\n    border-top: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-modal-tab-panel {\n    display: flex;\n    flex-direction: column;\n    min-height: 0;\n    flex: 1 1 auto;\n    padding: 0;\n    border-radius: 0;\n  }\n\n  .settings-modal-tab-panel[hidden] {\n    display: none !important;\n  }\n\n  .settings-modal-body {\n    overflow-y: auto;\n    padding: 0 calc(var(--design-unit) * 5px) calc(var(--design-unit) * 2px);\n    max-height: min(60vh, 520px);\n  }\n\n  .settings-modal-section {\n    padding: calc(var(--design-unit) * 5px) 0;\n    border-bottom: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-modal-section:last-child {\n    border-bottom: none;\n  }\n\n  /*\n   * Only the spacing. Everything else about this heading comes from the exported fragment\n   * above, which the assistant and its hosts share; margin is deliberately not in there,\n   * since the gap below a heading depends on the layout around it.\n   */\n  .ai-settings-section-title {\n    margin: 0 0 calc(var(--design-unit) * 3px);\n  }\n\n  .settings-modal-section-note {\n    margin: calc(var(--design-unit) * -2px) 0 calc(var(--design-unit) * 3px);\n    font-size: 12px;\n    line-height: 1.5;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-modal-section-body {\n    display: flex;\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 4px);\n  }\n\n  .settings-toggle-row {\n    display: flex;\n    align-items: flex-start;\n    gap: calc(var(--design-unit) * 3px);\n    padding: 0 0 calc(var(--design-unit) * 4px) 0;\n    border-bottom: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-toggle-row:last-child {\n    border-bottom: none;\n    padding-bottom: calc(var(--design-unit) * 1px);\n  }\n\n  .settings-toggle-row.is-stacked {\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 2px);\n  }\n\n  /*\n   * For rows whose control is a button rather than a switch. The base row top-aligns, which suits\n   * a switch (it lands level with the title), but a button is tall enough that top-aligning leaves\n   * it above the title-plus-description block it acts on.\n   */\n  .settings-toggle-row.is-centered {\n    align-items: center;\n  }\n\n  .settings-animation-list {\n    display: flex;\n    flex-direction: column;\n    width: 100%;\n    border: 1px solid var(--neutral-stroke-rest);\n    border-radius: calc(var(--control-corner-radius) * 1.2px);\n    padding: calc(var(--design-unit) * 2px);\n    gap: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-animation-list .settings-toggle-row {\n    border: 0;\n  }\n\n  .settings-animation-category {\n    display: flex;\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 4px);\n  }\n\n  .settings-animation-category-label {\n    font-weight: 600;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-toggle-row + .settings-animation-category-label {\n    border-top: 1px solid var(--neutral-stroke-rest);\n    padding-top: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-animation-option {\n    padding: 0;\n    margin: 0;\n  }\n\n  .settings-animation-option:last-child {\n    border-bottom: none;\n    padding-bottom: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-toggle-text {\n    flex: 1;\n    min-width: 0;\n  }\n\n  .settings-toggle-title {\n    font-size: 14px;\n    font-weight: 500;\n    color: var(--neutral-foreground-rest);\n  }\n\n  .settings-toggle-desc {\n    font-size: 12px;\n    color: var(--neutral-foreground-hint);\n    line-height: 1.5;\n    max-width: 92%;\n  }\n\n  .settings-toggle-control {\n    flex: 0 0 auto;\n    min-width: 0;\n  }\n\n  .settings-toggle-control-wide {\n    width: 100%;\n    max-width: 280px;\n  }\n\n  .settings-toggle-row.is-stacked .settings-toggle-desc {\n    max-width: none;\n  }\n\n  .settings-toggle-row.is-stacked .settings-toggle-control-wide {\n    width: 100%;\n    max-width: none;\n  }\n\n  /*\n   * Sub-heading over the provider toggle group. Unlike the section headings it sits INSIDE\n   * .settings-modal-section-body, so the parent's 4-unit flex gap already separates it from the\n   * first toggle — and flex does not collapse margins, so the shared rule's 3-unit margin-bottom\n   * would add to that gap rather than replace it, leaving the label adrift from the rows it\n   * names. Zero the margin and pull back 2 of the 4 gap units, expressed in the same token so it\n   * tracks if that gap changes.\n   */\n  .settings-app-toggles-title {\n    margin: 0 0 calc(var(--design-unit) * -2px);\n  }\n\n  .settings-app-toggle-block {\n    display: flex;\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 1px);\n  }\n\n  .settings-toggle-hint {\n    font-size: 12px;\n    color: var(--neutral-foreground-hint);\n    line-height: 1.4;\n    padding-left: calc(var(--design-unit) * 1px);\n    font-style: italic;\n  }\n\n  /*\n   * The budget meter (GENC-1464) is the context indicator's money sibling and\n   * shares its row anatomy 1:1, so the budget classes JOIN these rules rather\n   * than restating them — one place to restyle the header/label/figures shape,\n   * and the two indicators cannot drift apart. Design-system tokens only, and\n   * unfallbacked: every token here ships a DS default, so a var(--x, y)\n   * fallback would be dead code that hides a broken token name (#2411/#2436\n   * review rule, pinned by settings-modal.styles.test.ts).\n   */\n  .settings-context-header,\n  .settings-budget-header {\n    display: flex;\n    justify-content: space-between;\n    gap: calc(var(--design-unit) * 2px);\n    margin-bottom: calc(var(--design-unit) * 2px);\n    font-size: 12px;\n  }\n\n  .settings-context-label,\n  .settings-budget-label {\n    color: var(--neutral-foreground-hint);\n    font-size: 11px;\n    font-weight: 600;\n    text-transform: uppercase;\n    letter-spacing: 0.06em;\n  }\n\n  .settings-context-tokens,\n  .settings-budget-figures {\n    color: var(--neutral-foreground-rest);\n  }\n\n  /* Freshness footer (GENC-1464): refresh button + label under the vendor\n     rows, left-aligned — a footnote to the figures above it. The button's\n     inline padding is pinned and cancelled by the container margin so the\n     ICON GLYPH (not the button box) sits flush with the budget labels'\n     left edge, whatever the density tokens say. */\n  .settings-budget-toolbar {\n    display: flex;\n    justify-content: flex-start;\n    align-items: center;\n    gap: 4px;\n    margin-inline-start: -4px;\n  }\n\n  .settings-budget-refresh::part(control) {\n    padding-inline: 4px;\n  }\n\n  .settings-budget-updated {\n    color: var(--neutral-foreground-hint);\n    font-size: 11px;\n  }\n\n  /*\n   * ONE rhythm for every meter row. The outer wrapper holds the context\n   * indicator and the budget meter; the inner one holds the budget meter's\n   * vendor rows — and both gap by the same 2 units (half the section body's 4)\n   * so that visually identical meter rows are evenly spaced whatever mix of\n   * them is on screen. Without the wrapper the context row inherits the body's\n   * 4-unit gap while the vendor rows keep 2, and three identical-looking rows\n   * read as an uneven 4/2/2. The wrapper renders only when at least one meter\n   * does — see settingsUsageMetersTemplate for why an always-on one would cost\n   * a stray gap.\n   */\n  .settings-usage-meters,\n  .settings-budget-usage {\n    display: flex;\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-current-build,\n  .settings-lifetime-usage {\n    background: var(--neutral-layer-2);\n    border: 1px solid var(--neutral-stroke-rest);\n    border-radius: calc(var(--control-corner-radius) * 1.5px);\n    padding: calc(var(--design-unit) * 4px);\n    margin: calc(var(--design-unit) * 3px) 0;\n  }\n\n  /*\n   * Deliberately quieter than the live block: no pulsing badge and no accent, so the eye lands\n   * on what is being built now — which is why that block leads the tab and this one follows,\n   * under the history heading whose rows it totals.\n   */\n  .settings-lifetime-usage-top {\n    display: flex;\n    align-items: center;\n    flex-wrap: wrap;\n    gap: calc(var(--design-unit) * 2px);\n    margin-bottom: calc(var(--design-unit) * 3px);\n  }\n\n  .settings-lifetime-label {\n    font-size: 10px;\n    line-height: 1;\n    font-weight: 700;\n    text-transform: uppercase;\n    letter-spacing: 0.06em;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-current-build-top {\n    display: flex;\n    align-items: center;\n    flex-wrap: wrap;\n    gap: calc(var(--design-unit) * 2px);\n    margin-bottom: calc(var(--design-unit) * 3px);\n  }\n\n  /*\n   * Optically centring these 10px caps against the 14px project name beside them. Flex offers\n   * only two alignments and neither lands it, because a box centre and a text baseline are\n   * different lines:\n   *   - align-items: center   sits the badge baseline about 1.2px high\n   *   - align-items: baseline matches baselines, but the caps then read as bottom-aligned\n   *     against the name's ascenders, so the badge looks low\n   * The eye wants the midpoint, so: centre the boxes, then translate down by the ~1px of\n   * overshoot. This is a nudge, but it corrects a fixed relationship between two font sizes\n   * rather than some neighbouring element's layout, so unlike a margin tuned to a sibling it\n   * cannot rot when that sibling changes. In em, so it tracks the badge text.\n   *\n   * display: block, not inline-flex: a flex container has no text baseline of its own and\n   * synthesizes one from its first child, which here is the dot, an empty span. As a block box\n   * the badge takes the baseline of its first line, i.e. the text.\n   */\n  .settings-live-badge {\n    display: block;\n    font-size: 10px;\n    line-height: 1;\n    font-weight: 700;\n    text-transform: uppercase;\n    letter-spacing: 0.06em;\n    color: var(--accent-fill-rest);\n    white-space: nowrap;\n    transform: translateY(0.1em);\n  }\n\n  .settings-live-dot {\n    display: inline-block;\n    width: 7px;\n    height: 7px;\n\n    /* Replaces the flex gap the badge no longer has. */\n    margin-right: calc(var(--design-unit) * 1px);\n\n    /* Centres the dot on the text beside it without disturbing that text's baseline. */\n    vertical-align: middle;\n    border-radius: 50%;\n    background: var(--accent-fill-rest);\n    animation: settings-live-pulse 1.6s ease-out infinite;\n  }\n\n  @keyframes settings-live-pulse {\n    0% {\n      box-shadow: 0 0 0 0 color-mix(in srgb, var(--accent-fill-rest) 55%, transparent);\n    }\n\n    70% {\n      box-shadow: 0 0 0 7px transparent;\n    }\n\n    100% {\n      box-shadow: 0 0 0 0 transparent;\n    }\n  }\n\n  .settings-current-build-name {\n    font-size: 14px;\n    line-height: 1;\n    font-weight: 600;\n  }\n\n  /*\n   * Cost and the token buckets side by side: one number in its own box, the four buckets\n   * sharing the box next to it. Stretch, so the two are the same height however tall the 22px\n   * cost value makes the left one.\n   */\n  .settings-usage-row {\n    display: flex;\n    flex-wrap: wrap;\n    align-items: stretch;\n    gap: calc(var(--design-unit) * 3px);\n    margin-bottom: calc(var(--design-unit) * 3px);\n  }\n\n  .settings-usage-row-tokens {\n    display: flex;\n    flex: 1 1 auto;\n    min-width: 0;\n  }\n\n  .settings-build-stat {\n    min-width: 0;\n    background: var(--neutral-layer-1);\n    border: 1px solid var(--neutral-stroke-rest);\n    border-radius: calc(var(--control-corner-radius) * 1px);\n    padding: calc(var(--design-unit) * 3px);\n  }\n\n  .settings-build-stat-label {\n    font-size: 10px;\n    font-weight: 600;\n    text-transform: uppercase;\n    letter-spacing: 0.06em;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-build-stat-value {\n    font-size: 22px;\n    font-weight: 700;\n    margin-top: calc(var(--design-unit) * 1px);\n    color: var(--neutral-foreground-rest);\n  }\n\n  .settings-build-stat-value .prefix,\n  .settings-build-stat-value .suffix {\n    color: var(--accent-fill-rest);\n  }\n\n  /*\n   * Per-bucket token split, beneath the headline cost. Small paired label/value cells\n   * rather than four more stat cards: they are the detail behind the cost above, so they\n   * have to read as subordinate to it rather than compete with it. The four buckets ARE\n   * the token figure now — there is no merged total anywhere for them to break down.\n   */\n  .settings-token-breakdown {\n    display: flex;\n    flex-direction: column;\n\n    /*\n     * Tight against the buckets below. One design unit rather than two, because each bucket\n     * separates its own label from its value by only 2px — at two units the title sat four\n     * times further from the bucket labels than they sit from their own numbers, which read\n     * as a gap between unrelated blocks instead of a heading over its content.\n     */\n    gap: calc(var(--design-unit) * 1px);\n    margin-bottom: calc(var(--design-unit) * 3px);\n    padding: calc(var(--design-unit) * 2px) calc(var(--design-unit) * 3px);\n    background: var(--neutral-layer-1);\n    border: 1px solid var(--neutral-stroke-rest);\n    border-radius: calc(var(--control-corner-radius) * 1px);\n  }\n\n  /*\n   * Titles the box, because nothing else in it named the unit. Same styling and position as\n   * the cost box's label, so two boxes sitting side by side are titled the same way; the\n   * hierarchy against the bucket labels comes from position, not a second type size.\n   */\n  .settings-token-breakdown-label {\n    font-size: 10px;\n    line-height: 1;\n    font-weight: 600;\n    text-transform: uppercase;\n    letter-spacing: 0.06em;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-token-buckets {\n    display: flex;\n    flex-wrap: wrap;\n    gap: calc(var(--design-unit) * 4px);\n  }\n\n  .settings-token-bucket {\n    display: flex;\n\n    /*\n     * min-content (not 0) so a bucket cannot be shrunk narrower than its own unbreakable label.\n     * With the label set to nowrap, a zero minimum would overflow it into the next column instead\n     * of wrapping — so the container's flex-wrap takes over and moves a bucket to a second row,\n     * which is the degradation we want when the modal is dragged narrow.\n     */\n    min-width: min-content;\n    flex-direction: column;\n    gap: 2px;\n  }\n\n  .settings-token-bucket-label {\n    font-size: 10px;\n    font-weight: 600;\n    text-transform: uppercase;\n    letter-spacing: 0.06em;\n    color: var(--neutral-foreground-hint);\n\n    /*\n     * One line, always. The rate marker is a separate inline box after collapsible whitespace, so\n     * a wrappable label gives it a break opportunity of its own — in a narrow column it orphaned\n     * onto line 2, which also pushed that bucket's value a line below the other three and broke\n     * the row of figures. nowrap removes every break opportunity in the label, the space before\n     * the marker included, so no glue character is needed.\n     */\n    white-space: nowrap;\n  }\n\n  .settings-token-bucket-value {\n    font-size: 13px;\n    font-weight: 600;\n    color: var(--neutral-foreground-rest);\n  }\n\n  /*\n   * The price-direction marker on a cache bucket's label — down for reads (a fraction of the\n   * uncached input rate), up for writes (a premium over it). Three tiers, so a bucket with no\n   * marker is the reference rate rather than an unlabelled fourth case.\n   *\n   * Carried by the label rather than the value, which is what this used to do: cache reads are\n   * usually the largest bucket by a wide margin in an agentic session, so the value was muted to\n   * stop the biggest number reading as the dominant cost driver. That priced the treatment to the\n   * wrong thing — a dimmed 0 (every Gemini cache write) looked disabled next to a normal 0, and a\n   * rate is a property of the bucket, not of this turn's figure.\n   *\n   * Sized down and nudged up rather than tinted: the label is already the hint colour, so a\n   * dimmer marker would vanish and a brighter one would out-shout the word it qualifies.\n   */\n  .settings-token-bucket-rate {\n    font-size: 8px;\n    line-height: 1;\n    vertical-align: 0.15em;\n    letter-spacing: 0;\n  }\n\n  /*\n   * Usage-row overrides. Placed after the base rules they refine rather than up beside\n   * .settings-usage-row itself, because stylelint's no-descending-specificity rejects a\n   * compound selector appearing before the plain one it overrides.\n   */\n\n  /* Sized by its content; the buckets take the rest, since four cells need the width. */\n  .settings-usage-row > .settings-build-stat {\n    flex: 0 1 auto;\n  }\n\n  .settings-usage-row .settings-token-breakdown {\n    flex: 1 1 auto;\n\n    /* The row owns the spacing now; this centres the column against the taller cost box. */\n    justify-content: center;\n    margin-bottom: 0;\n  }\n\n  /*\n   * Basis auto, not 0: a zero basis splits the row into four equal columns, so CACHE WRITE is\n   * squeezed exactly as hard as INPUT despite being twice the label. Sizing from content gives the\n   * long labels the room their text needs and lets the short ones concede it, which is what makes\n   * white-space: nowrap above safe — every column starts at least as wide as its own content,\n   * then shares the slack. Still grows and shrinks, so the four stay flush edge to edge.\n   */\n  .settings-usage-row .settings-token-bucket {\n    flex: 1 1 auto;\n  }\n\n  .settings-model-tags {\n    display: flex;\n    flex-wrap: wrap;\n    gap: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-model-tag {\n    font-size: 11px;\n    font-weight: 600;\n    padding: 3px 9px;\n    border-radius: 20px;\n    font-family: ui-monospace, monospace;\n    border: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-model-tag,\n  .settings-cost-history-icon {\n    --model-tag-color: var(--neutral-foreground-rest);\n\n    background: color-mix(\n      in srgb,\n      var(--model-tag-color) var(--ai-tier-badge-bg-mix),\n      var(--neutral-layer-1)\n    );\n    border-color: color-mix(in srgb, var(--model-tag-color) 20%, var(--neutral-layer-1));\n    color: color-mix(in srgb, var(--model-tag-color), white var(--ai-tier-badge-text-lighten));\n  }\n\n  .settings-cost-history-title {\n    font-size: 11px;\n    text-transform: uppercase;\n    letter-spacing: 0.08em;\n    color: var(--neutral-foreground-hint);\n    font-weight: 600;\n    margin: calc(var(--design-unit) * 4px) 0 calc(var(--design-unit) * 2px);\n  }\n\n  /*\n   * The heading labels the lifetime card as well as the rows, so the card gives up its own top\n   * margin and the gap becomes the heading's alone. Adjacent siblings collapse to the LARGER of\n   * the two margins, so leaving both would space the caps 3 units off the block they label while\n   * the rows below sit at 2 — reading as though the heading belonged to neither.\n   */\n  .settings-cost-history-title + .settings-lifetime-usage {\n    margin-top: 0;\n  }\n\n  .settings-cost-history {\n    display: flex;\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 2px);\n    padding-bottom: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-cost-history-icon {\n    flex: 0 0 auto;\n    width: 36px;\n    height: 36px;\n    border-radius: calc(var(--control-corner-radius) * 1px);\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    font-size: 16px;\n    font-weight: 700;\n    border: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-cost-history-row {\n    display: flex;\n    flex-direction: column;\n    background: var(--neutral-layer-1);\n    border: 1px solid var(--neutral-stroke-rest);\n    border-radius: calc(var(--control-corner-radius) * 1.5px);\n    padding: calc(var(--design-unit) * 4px);\n  }\n\n  .settings-cost-history-row-content {\n    display: flex;\n    align-items: flex-start;\n    gap: calc(var(--design-unit) * 2px);\n  }\n\n  /*\n   * All of these carry a ?hidden binding, and all declare display: flex — which silently beat the\n   * UA [hidden] { display: none } rule, because author-origin declarations outrank user-agent\n   * origin whatever the specificity. Without this, showTokens: false still rendered the full\n   * breakdown in the lifetime block, the live block and every history row, and an empty row list\n   * still occupied its padding under the lifetime total. Sibling elements that hide correctly do\n   * so only by declaring no display at all. Same treatment as .settings-modal-tab-panel[hidden]\n   * near the top of this file.\n   */\n  .settings-usage-row-tokens[hidden],\n  .settings-cost-history[hidden],\n  .settings-cost-history-row-content[hidden] {\n    display: none !important;\n  }\n\n  /*\n   * The buckets inside a history row drop the panel treatment they carry in the summary\n   * blocks — the row is already a bordered card, and a second box inside it reads as a\n   * nested panel. The adjacent-sibling rule above supplies the separator instead.\n   */\n  .settings-cost-history-row-breakdown .settings-token-breakdown {\n    flex: 1 1 auto;\n    margin-bottom: 0;\n    padding: 0;\n    background: none;\n    border: none;\n  }\n\n  .settings-cost-history-row-content + .settings-cost-history-row-content {\n    border-top: 1px solid var(--neutral-stroke-rest);\n    margin-top: calc(var(--design-unit) * 2px);\n    padding-top: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-cost-history-row-body {\n    flex: 1 1 auto;\n    min-width: 0;\n    display: flex;\n    gap: calc(var(--design-unit) * 2px);\n    justify-content: space-between;\n  }\n\n  /*\n   * Holds the cost and the delete button as one centred pair. The button used to be a sibling\n   * of the whole row body, kept in place by a -2px nudge tuned for when the metrics column had\n   * two lines (cost plus a merged token total). Dropping that second line left the nudge\n   * compensating for nothing. Centring the two against each other needs no magic number and\n   * cannot drift again if the metrics content changes.\n   *\n   * NB this rule previously set align-items with no display:flex, so it had no effect at all.\n   */\n  .settings-cost-history-row-right {\n    display: flex;\n    align-items: center;\n    gap: calc(var(--design-unit) * 1px);\n    flex: 0 0 auto;\n  }\n\n  .settings-cost-history-row-cost,\n  .settings-cost-history-row-title {\n    font-size: 14px;\n    font-weight: 600;\n    color: var(--neutral-foreground-rest);\n    min-width: 0;\n  }\n\n  .settings-cost-history-row-metrics {\n    display: flex;\n    flex-direction: column;\n    flex: 0 0 auto;\n    font-size: 13px;\n    font-family: ui-monospace, monospace;\n    color: var(--neutral-foreground-rest);\n    white-space: nowrap;\n  }\n\n  .settings-cost-history-row-date {\n    font-size: 12px;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-cost-history-delete {\n    flex: 0 0 auto;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-cost-history-delete:hover {\n    color: var(--error-color);\n  }\n\n  .settings-cost-history ::slotted(*) {\n    display: block;\n  }\n\n  .settings-modal-footer {\n    width: 100%;\n  }\n\n  .settings-done-button {\n    margin-left: auto;\n  }\n\n  .settings-modal-footer-actions {\n    display: flex;\n    align-items: center;\n    justify-content: space-between;\n    gap: calc(var(--design-unit) * 2px);\n    width: 100%;\n  }\n\n  .settings-disclaimer {\n    font-size: 12px;\n    color: var(--neutral-foreground-hint);\n    max-width: 60%;\n    line-height: 1.4;\n  }\n\n  /*\n   * Inline spinner shown in the \"Download agent log\" button while the log builds\n   * (GENC-1351 §5.8) — the lifetime-stitch path is an async provider round-trip.\n   * Sized to the button label and tinted with currentColor so it tracks the\n   * button's text colour in every appearance / theme.\n   */\n  [part='download-button'] .download-spinner {\n    display: inline-block;\n    width: 12px;\n    height: 12px;\n    margin-right: calc(var(--design-unit) * 1px);\n    vertical-align: -1px;\n    border: 2px solid currentColor;\n    border-right-color: transparent;\n    border-radius: 50%;\n    animation: download-spin 0.6s linear infinite;\n  }\n\n  @keyframes download-spin {\n    to {\n      transform: rotate(360deg);\n    }\n  }\n`",
-          "description": "Styles for the assistant settings modal (tabs, sections, toggles, cost summary)."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "settingsModalStyles",
-          "declaration": {
-            "name": "settingsModalStyles",
-            "module": "src/components/settings-modal/settings-modal.styles.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/settings-modal/settings-modal.template.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "SettingsModalTemplate",
-          "return": {
-            "type": {
-              "text": "ViewTemplate<FoundationAiAssistant>"
-            }
-          },
-          "parameters": [
-            {
-              "name": "designSystemPrefix",
-              "type": {
-                "text": "string"
-              }
-            }
-          ],
-          "description": "Modal shell for assistant settings — Configuration and Usage tabs, section slots for\napp-specific UI, and built-in chat-bot toggles."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "SettingsModalTemplate",
-          "declaration": {
-            "name": "SettingsModalTemplate",
-            "module": "src/components/settings-modal/settings-modal.template.ts"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/state/persistence/build-timeline-entries.ts",
@@ -11487,6 +11516,101 @@
           }
         }
       ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/settings-modal/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SettingsModalTemplate",
+          "declaration": {
+            "name": "SettingsModalTemplate",
+            "module": "./settings-modal.template"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "type",
+          "declaration": {
+            "name": "type",
+            "module": "./settings-modal.template"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SettingsModalTab",
+          "declaration": {
+            "name": "SettingsModalTab",
+            "module": "./settings-modal.template"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "settingsModalStyles",
+          "declaration": {
+            "name": "settingsModalStyles",
+            "module": "./settings-modal.styles"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/settings-modal/settings-modal.styles.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "settingsModalStyles",
+          "default": "css`\n  /*\n   * Section headings come from the shared fragment the package also exports, so a host titling\n   * its own slotted section applies the same rule rather than a copy of it.\n   */\n  ${assistantSettingsSectionTitleStyles}\n\n  *,\n  *::before,\n  *::after {\n    box-sizing: border-box;\n  }\n\n  .settings-modal {\n    --ai-tier-badge-bg-mix: 14%;\n    --ai-tier-badge-text-lighten: 18%;\n  }\n\n  .settings-modal::part(dialog) {\n    max-width: 620px;\n    width: calc(100vw - 48px);\n    max-height: calc(100vh - 48px);\n    padding: 0;\n  }\n\n  .settings-modal::part(content) {\n    display: flex;\n    flex-direction: column;\n    min-height: 0;\n    padding: 0;\n    width: 100%;\n  }\n\n  .settings-modal::part(top) {\n    padding: calc(var(--design-unit) * 4px) calc(var(--design-unit) * 5px);\n    border-bottom: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-modal::part(bottom) {\n    padding: calc(var(--design-unit) * 4px) calc(var(--design-unit) * 5px);\n    border-top: 1px solid var(--neutral-stroke-rest);\n    border-bottom-left-radius: var(--card-border-radius, calc(var(--control-corner-radius) * 1px));\n    border-bottom-right-radius: var(--card-border-radius, calc(var(--control-corner-radius) * 1px));\n    background-color: var(--neutral-layer-2);\n  }\n\n  .settings-modal-header {\n    display: flex;\n    align-items: center;\n    min-width: 0;\n  }\n\n  .settings-modal-title {\n    margin: 0;\n    font-size: 16px;\n    font-weight: 600;\n    display: flex;\n    align-items: center;\n    gap: calc(var(--design-unit) * 2px);\n    color: var(--neutral-foreground-rest);\n  }\n\n  .settings-modal-content {\n    display: flex;\n    flex-direction: column;\n    min-height: 0;\n    flex: 1 1 auto;\n  }\n\n  .settings-modal-tabs::part(tablist) {\n    border-bottom: 0;\n    padding: 0 calc(var(--design-unit) * 5px);\n    column-gap: calc(var(--design-unit) * 5px);\n  }\n\n  .settings-modal-tabs::part(activeIndicator) {\n    height: 2px;\n  }\n\n  .settings-modal-tab {\n    padding: 0;\n    font-weight: 600;\n    gap: 6px;\n  }\n\n  .settings-modal-tab[aria-selected='true'] {\n    color: var(--neutral-foreground-rest);\n  }\n\n  .settings-modal-tabs::part(tabpanel) {\n    border-top: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-modal-tab-panel {\n    display: flex;\n    flex-direction: column;\n    min-height: 0;\n    flex: 1 1 auto;\n    padding: 0;\n    border-radius: 0;\n  }\n\n  .settings-modal-tab-panel[hidden] {\n    display: none !important;\n  }\n\n  .settings-modal-body {\n    overflow-y: auto;\n    padding: 0 calc(var(--design-unit) * 5px) calc(var(--design-unit) * 2px);\n    max-height: min(60vh, 520px);\n  }\n\n  .settings-modal-section {\n    padding: calc(var(--design-unit) * 5px) 0;\n    border-bottom: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-modal-section:last-child {\n    border-bottom: none;\n  }\n\n  /*\n   * Only the spacing. Everything else about this heading comes from the exported fragment\n   * above, which the assistant and its hosts share; margin is deliberately not in there,\n   * since the gap below a heading depends on the layout around it.\n   */\n  .ai-settings-section-title {\n    margin: 0 0 calc(var(--design-unit) * 3px);\n  }\n\n  .settings-modal-section-note {\n    margin: calc(var(--design-unit) * -2px) 0 calc(var(--design-unit) * 3px);\n    font-size: 12px;\n    line-height: 1.5;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-modal-section-body {\n    display: flex;\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 4px);\n  }\n\n  .settings-toggle-row {\n    display: flex;\n    align-items: flex-start;\n    gap: calc(var(--design-unit) * 3px);\n    padding: 0 0 calc(var(--design-unit) * 4px) 0;\n    border-bottom: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-toggle-row:last-child {\n    border-bottom: none;\n    padding-bottom: calc(var(--design-unit) * 1px);\n  }\n\n  .settings-toggle-row.is-stacked {\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 2px);\n  }\n\n  /*\n   * For rows whose control is a button rather than a switch. The base row top-aligns, which suits\n   * a switch (it lands level with the title), but a button is tall enough that top-aligning leaves\n   * it above the title-plus-description block it acts on.\n   */\n  .settings-toggle-row.is-centered {\n    align-items: center;\n  }\n\n  .settings-animation-list {\n    display: flex;\n    flex-direction: column;\n    width: 100%;\n    border: 1px solid var(--neutral-stroke-rest);\n    border-radius: calc(var(--control-corner-radius) * 1.2px);\n    padding: calc(var(--design-unit) * 2px);\n    gap: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-animation-list .settings-toggle-row {\n    border: 0;\n  }\n\n  .settings-animation-category {\n    display: flex;\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 4px);\n  }\n\n  .settings-animation-category-label {\n    font-weight: 600;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-toggle-row + .settings-animation-category-label {\n    border-top: 1px solid var(--neutral-stroke-rest);\n    padding-top: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-animation-option {\n    padding: 0;\n    margin: 0;\n  }\n\n  .settings-animation-option:last-child {\n    border-bottom: none;\n    padding-bottom: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-toggle-text {\n    flex: 1;\n    min-width: 0;\n  }\n\n  .settings-toggle-title {\n    font-size: 14px;\n    font-weight: 500;\n    color: var(--neutral-foreground-rest);\n  }\n\n  .settings-toggle-desc {\n    font-size: 12px;\n    color: var(--neutral-foreground-hint);\n    line-height: 1.5;\n    max-width: 92%;\n  }\n\n  .settings-toggle-control {\n    flex: 0 0 auto;\n    min-width: 0;\n  }\n\n  .settings-toggle-control-wide {\n    width: 100%;\n    max-width: 280px;\n  }\n\n  .settings-toggle-row.is-stacked .settings-toggle-desc {\n    max-width: none;\n  }\n\n  .settings-toggle-row.is-stacked .settings-toggle-control-wide {\n    width: 100%;\n    max-width: none;\n  }\n\n  /*\n   * Sub-heading over the provider toggle group. Unlike the section headings it sits INSIDE\n   * .settings-modal-section-body, so the parent's 4-unit flex gap already separates it from the\n   * first toggle — and flex does not collapse margins, so the shared rule's 3-unit margin-bottom\n   * would add to that gap rather than replace it, leaving the label adrift from the rows it\n   * names. Zero the margin and pull back 2 of the 4 gap units, expressed in the same token so it\n   * tracks if that gap changes.\n   */\n  .settings-app-toggles-title {\n    margin: 0 0 calc(var(--design-unit) * -2px);\n  }\n\n  .settings-app-toggle-block {\n    display: flex;\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 1px);\n  }\n\n  .settings-toggle-hint {\n    font-size: 12px;\n    color: var(--neutral-foreground-hint);\n    line-height: 1.4;\n    padding-left: calc(var(--design-unit) * 1px);\n    font-style: italic;\n  }\n\n  /*\n   * The budget meter (GENC-1464) is the context indicator's money sibling and\n   * shares its row anatomy 1:1, so the budget classes JOIN these rules rather\n   * than restating them — one place to restyle the header/label/figures shape,\n   * and the two indicators cannot drift apart. Design-system tokens only, and\n   * unfallbacked: every token here ships a DS default, so a var(--x, y)\n   * fallback would be dead code that hides a broken token name (#2411/#2436\n   * review rule, pinned by settings-modal.styles.test.ts).\n   */\n  .settings-context-header,\n  .settings-budget-header {\n    display: flex;\n    justify-content: space-between;\n    gap: calc(var(--design-unit) * 2px);\n    margin-bottom: calc(var(--design-unit) * 2px);\n    font-size: 12px;\n  }\n\n  .settings-context-label,\n  .settings-budget-label {\n    color: var(--neutral-foreground-hint);\n    font-size: 11px;\n    font-weight: 600;\n    text-transform: uppercase;\n    letter-spacing: 0.06em;\n  }\n\n  .settings-context-tokens,\n  .settings-budget-figures {\n    color: var(--neutral-foreground-rest);\n  }\n\n  /* Freshness footer (GENC-1464): refresh button + label under the vendor\n     rows, left-aligned — a footnote to the figures above it. The button's\n     inline padding is pinned and cancelled by the container margin so the\n     ICON GLYPH (not the button box) sits flush with the budget labels'\n     left edge, whatever the density tokens say. */\n  .settings-budget-toolbar {\n    display: flex;\n    justify-content: flex-start;\n    align-items: center;\n    gap: 4px;\n    margin-inline-start: -4px;\n  }\n\n  .settings-budget-refresh::part(control) {\n    padding-inline: 4px;\n  }\n\n  .settings-budget-updated {\n    color: var(--neutral-foreground-hint);\n    font-size: 11px;\n  }\n\n  /*\n   * ONE rhythm for every meter row. The outer wrapper holds the context\n   * indicator and the budget meter; the inner one holds the budget meter's\n   * vendor rows — and both gap by the same 2 units (half the section body's 4)\n   * so that visually identical meter rows are evenly spaced whatever mix of\n   * them is on screen. Without the wrapper the context row inherits the body's\n   * 4-unit gap while the vendor rows keep 2, and three identical-looking rows\n   * read as an uneven 4/2/2. The wrapper renders only when at least one meter\n   * does — see settingsUsageMetersTemplate for why an always-on one would cost\n   * a stray gap.\n   */\n  .settings-usage-meters,\n  .settings-budget-usage {\n    display: flex;\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-current-build,\n  .settings-lifetime-usage {\n    background: var(--neutral-layer-2);\n    border: 1px solid var(--neutral-stroke-rest);\n    border-radius: calc(var(--control-corner-radius) * 1.5px);\n    padding: calc(var(--design-unit) * 4px);\n    margin: calc(var(--design-unit) * 3px) 0;\n  }\n\n  /*\n   * Deliberately quieter than the live block: no pulsing badge and no accent, so the eye lands\n   * on what is being built now — which is why that block leads the tab and this one follows,\n   * under the history heading whose rows it totals.\n   */\n  .settings-lifetime-usage-top {\n    display: flex;\n    align-items: center;\n    flex-wrap: wrap;\n    gap: calc(var(--design-unit) * 2px);\n    margin-bottom: calc(var(--design-unit) * 3px);\n  }\n\n  .settings-lifetime-label {\n    font-size: 10px;\n    line-height: 1;\n    font-weight: 700;\n    text-transform: uppercase;\n    letter-spacing: 0.06em;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-current-build-top {\n    display: flex;\n    align-items: center;\n    flex-wrap: wrap;\n    gap: calc(var(--design-unit) * 2px);\n    margin-bottom: calc(var(--design-unit) * 3px);\n  }\n\n  /*\n   * Optically centring these 10px caps against the 14px project name beside them. Flex offers\n   * only two alignments and neither lands it, because a box centre and a text baseline are\n   * different lines:\n   *   - align-items: center   sits the badge baseline about 1.2px high\n   *   - align-items: baseline matches baselines, but the caps then read as bottom-aligned\n   *     against the name's ascenders, so the badge looks low\n   * The eye wants the midpoint, so: centre the boxes, then translate down by the ~1px of\n   * overshoot. This is a nudge, but it corrects a fixed relationship between two font sizes\n   * rather than some neighbouring element's layout, so unlike a margin tuned to a sibling it\n   * cannot rot when that sibling changes. In em, so it tracks the badge text.\n   *\n   * display: block, not inline-flex: a flex container has no text baseline of its own and\n   * synthesizes one from its first child, which here is the dot, an empty span. As a block box\n   * the badge takes the baseline of its first line, i.e. the text.\n   */\n  .settings-live-badge {\n    display: block;\n    font-size: 10px;\n    line-height: 1;\n    font-weight: 700;\n    text-transform: uppercase;\n    letter-spacing: 0.06em;\n    color: var(--accent-fill-rest);\n    white-space: nowrap;\n    transform: translateY(0.1em);\n  }\n\n  .settings-live-dot {\n    display: inline-block;\n    width: 7px;\n    height: 7px;\n\n    /* Replaces the flex gap the badge no longer has. */\n    margin-right: calc(var(--design-unit) * 1px);\n\n    /* Centres the dot on the text beside it without disturbing that text's baseline. */\n    vertical-align: middle;\n    border-radius: 50%;\n    background: var(--accent-fill-rest);\n    animation: settings-live-pulse 1.6s ease-out infinite;\n  }\n\n  @keyframes settings-live-pulse {\n    0% {\n      box-shadow: 0 0 0 0 color-mix(in srgb, var(--accent-fill-rest) 55%, transparent);\n    }\n\n    70% {\n      box-shadow: 0 0 0 7px transparent;\n    }\n\n    100% {\n      box-shadow: 0 0 0 0 transparent;\n    }\n  }\n\n  .settings-current-build-name {\n    font-size: 14px;\n    line-height: 1;\n    font-weight: 600;\n  }\n\n  /*\n   * Cost and the token buckets side by side: one number in its own box, the four buckets\n   * sharing the box next to it. Stretch, so the two are the same height however tall the 22px\n   * cost value makes the left one.\n   */\n  .settings-usage-row {\n    display: flex;\n    flex-wrap: wrap;\n    align-items: stretch;\n    gap: calc(var(--design-unit) * 3px);\n    margin-bottom: calc(var(--design-unit) * 3px);\n  }\n\n  .settings-usage-row-tokens {\n    display: flex;\n    flex: 1 1 auto;\n    min-width: 0;\n  }\n\n  .settings-build-stat {\n    min-width: 0;\n    background: var(--neutral-layer-1);\n    border: 1px solid var(--neutral-stroke-rest);\n    border-radius: calc(var(--control-corner-radius) * 1px);\n    padding: calc(var(--design-unit) * 3px);\n  }\n\n  .settings-build-stat-label {\n    font-size: 10px;\n    font-weight: 600;\n    text-transform: uppercase;\n    letter-spacing: 0.06em;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-build-stat-value {\n    font-size: 22px;\n    font-weight: 700;\n    margin-top: calc(var(--design-unit) * 1px);\n    color: var(--neutral-foreground-rest);\n  }\n\n  .settings-build-stat-value .prefix,\n  .settings-build-stat-value .suffix {\n    color: var(--accent-fill-rest);\n  }\n\n  /*\n   * Per-bucket token split, beneath the headline cost. Small paired label/value cells\n   * rather than four more stat cards: they are the detail behind the cost above, so they\n   * have to read as subordinate to it rather than compete with it. The four buckets ARE\n   * the token figure now — there is no merged total anywhere for them to break down.\n   */\n  .settings-token-breakdown {\n    display: flex;\n    flex-direction: column;\n\n    /*\n     * Tight against the buckets below. One design unit rather than two, because each bucket\n     * separates its own label from its value by only 2px — at two units the title sat four\n     * times further from the bucket labels than they sit from their own numbers, which read\n     * as a gap between unrelated blocks instead of a heading over its content.\n     */\n    gap: calc(var(--design-unit) * 1px);\n    margin-bottom: calc(var(--design-unit) * 3px);\n    padding: calc(var(--design-unit) * 2px) calc(var(--design-unit) * 3px);\n    background: var(--neutral-layer-1);\n    border: 1px solid var(--neutral-stroke-rest);\n    border-radius: calc(var(--control-corner-radius) * 1px);\n  }\n\n  /*\n   * Titles the box, because nothing else in it named the unit. Same styling and position as\n   * the cost box's label, so two boxes sitting side by side are titled the same way; the\n   * hierarchy against the bucket labels comes from position, not a second type size.\n   */\n  .settings-token-breakdown-label {\n    font-size: 10px;\n    line-height: 1;\n    font-weight: 600;\n    text-transform: uppercase;\n    letter-spacing: 0.06em;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-token-buckets {\n    display: flex;\n    flex-wrap: wrap;\n    gap: calc(var(--design-unit) * 4px);\n  }\n\n  .settings-token-bucket {\n    display: flex;\n\n    /*\n     * min-content (not 0) so a bucket cannot be shrunk narrower than its own unbreakable label.\n     * With the label set to nowrap, a zero minimum would overflow it into the next column instead\n     * of wrapping — so the container's flex-wrap takes over and moves a bucket to a second row,\n     * which is the degradation we want when the modal is dragged narrow.\n     */\n    min-width: min-content;\n    flex-direction: column;\n    gap: 2px;\n  }\n\n  .settings-token-bucket-label {\n    font-size: 10px;\n    font-weight: 600;\n    text-transform: uppercase;\n    letter-spacing: 0.06em;\n    color: var(--neutral-foreground-hint);\n\n    /*\n     * One line, always. The rate marker is a separate inline box after collapsible whitespace, so\n     * a wrappable label gives it a break opportunity of its own — in a narrow column it orphaned\n     * onto line 2, which also pushed that bucket's value a line below the other three and broke\n     * the row of figures. nowrap removes every break opportunity in the label, the space before\n     * the marker included, so no glue character is needed.\n     */\n    white-space: nowrap;\n  }\n\n  .settings-token-bucket-value {\n    font-size: 13px;\n    font-weight: 600;\n    color: var(--neutral-foreground-rest);\n  }\n\n  /*\n   * The price-direction marker on a cache bucket's label — down for reads (a fraction of the\n   * uncached input rate), up for writes (a premium over it). Three tiers, so a bucket with no\n   * marker is the reference rate rather than an unlabelled fourth case.\n   *\n   * Carried by the label rather than the value, which is what this used to do: cache reads are\n   * usually the largest bucket by a wide margin in an agentic session, so the value was muted to\n   * stop the biggest number reading as the dominant cost driver. That priced the treatment to the\n   * wrong thing — a dimmed 0 (every Gemini cache write) looked disabled next to a normal 0, and a\n   * rate is a property of the bucket, not of this turn's figure.\n   *\n   * Sized down and nudged up rather than tinted: the label is already the hint colour, so a\n   * dimmer marker would vanish and a brighter one would out-shout the word it qualifies.\n   */\n  .settings-token-bucket-rate {\n    font-size: 8px;\n    line-height: 1;\n    vertical-align: 0.15em;\n    letter-spacing: 0;\n  }\n\n  /*\n   * Usage-row overrides. Placed after the base rules they refine rather than up beside\n   * .settings-usage-row itself, because stylelint's no-descending-specificity rejects a\n   * compound selector appearing before the plain one it overrides.\n   */\n\n  /* Sized by its content; the buckets take the rest, since four cells need the width. */\n  .settings-usage-row > .settings-build-stat {\n    flex: 0 1 auto;\n  }\n\n  .settings-usage-row .settings-token-breakdown {\n    flex: 1 1 auto;\n\n    /* The row owns the spacing now; this centres the column against the taller cost box. */\n    justify-content: center;\n    margin-bottom: 0;\n  }\n\n  /*\n   * Basis auto, not 0: a zero basis splits the row into four equal columns, so CACHE WRITE is\n   * squeezed exactly as hard as INPUT despite being twice the label. Sizing from content gives the\n   * long labels the room their text needs and lets the short ones concede it, which is what makes\n   * white-space: nowrap above safe — every column starts at least as wide as its own content,\n   * then shares the slack. Still grows and shrinks, so the four stay flush edge to edge.\n   */\n  .settings-usage-row .settings-token-bucket {\n    flex: 1 1 auto;\n  }\n\n  .settings-model-tags {\n    display: flex;\n    flex-wrap: wrap;\n    gap: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-model-tag {\n    font-size: 11px;\n    font-weight: 600;\n    padding: 3px 9px;\n    border-radius: 20px;\n    font-family: ui-monospace, monospace;\n    border: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-model-tag,\n  .settings-cost-history-icon {\n    --model-tag-color: var(--neutral-foreground-rest);\n\n    background: color-mix(\n      in srgb,\n      var(--model-tag-color) var(--ai-tier-badge-bg-mix),\n      var(--neutral-layer-1)\n    );\n    border-color: color-mix(in srgb, var(--model-tag-color) 20%, var(--neutral-layer-1));\n    color: color-mix(in srgb, var(--model-tag-color), white var(--ai-tier-badge-text-lighten));\n  }\n\n  .settings-cost-history-title {\n    font-size: 11px;\n    text-transform: uppercase;\n    letter-spacing: 0.08em;\n    color: var(--neutral-foreground-hint);\n    font-weight: 600;\n    margin: calc(var(--design-unit) * 4px) 0 calc(var(--design-unit) * 2px);\n  }\n\n  /*\n   * The heading labels the lifetime card as well as the rows, so the card gives up its own top\n   * margin and the gap becomes the heading's alone. Adjacent siblings collapse to the LARGER of\n   * the two margins, so leaving both would space the caps 3 units off the block they label while\n   * the rows below sit at 2 — reading as though the heading belonged to neither.\n   */\n  .settings-cost-history-title + .settings-lifetime-usage {\n    margin-top: 0;\n  }\n\n  .settings-cost-history {\n    display: flex;\n    flex-direction: column;\n    gap: calc(var(--design-unit) * 2px);\n    padding-bottom: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-cost-history-icon {\n    flex: 0 0 auto;\n    width: 36px;\n    height: 36px;\n    border-radius: calc(var(--control-corner-radius) * 1px);\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    font-size: 16px;\n    font-weight: 700;\n    border: 1px solid var(--neutral-stroke-rest);\n  }\n\n  .settings-cost-history-row {\n    display: flex;\n    flex-direction: column;\n    background: var(--neutral-layer-1);\n    border: 1px solid var(--neutral-stroke-rest);\n    border-radius: calc(var(--control-corner-radius) * 1.5px);\n    padding: calc(var(--design-unit) * 4px);\n  }\n\n  .settings-cost-history-row-content {\n    display: flex;\n    align-items: flex-start;\n    gap: calc(var(--design-unit) * 2px);\n  }\n\n  /*\n   * All of these carry a ?hidden binding, and all declare display: flex — which silently beat the\n   * UA [hidden] { display: none } rule, because author-origin declarations outrank user-agent\n   * origin whatever the specificity. Without this, showTokens: false still rendered the full\n   * breakdown in the lifetime block, the live block and every history row, and an empty row list\n   * still occupied its padding under the lifetime total. Sibling elements that hide correctly do\n   * so only by declaring no display at all. Same treatment as .settings-modal-tab-panel[hidden]\n   * near the top of this file.\n   */\n  .settings-usage-row-tokens[hidden],\n  .settings-cost-history[hidden],\n  .settings-cost-history-row-content[hidden] {\n    display: none !important;\n  }\n\n  /*\n   * The buckets inside a history row drop the panel treatment they carry in the summary\n   * blocks — the row is already a bordered card, and a second box inside it reads as a\n   * nested panel. The adjacent-sibling rule above supplies the separator instead.\n   */\n  .settings-cost-history-row-breakdown .settings-token-breakdown {\n    flex: 1 1 auto;\n    margin-bottom: 0;\n    padding: 0;\n    background: none;\n    border: none;\n  }\n\n  .settings-cost-history-row-content + .settings-cost-history-row-content {\n    border-top: 1px solid var(--neutral-stroke-rest);\n    margin-top: calc(var(--design-unit) * 2px);\n    padding-top: calc(var(--design-unit) * 2px);\n  }\n\n  .settings-cost-history-row-body {\n    flex: 1 1 auto;\n    min-width: 0;\n    display: flex;\n    gap: calc(var(--design-unit) * 2px);\n    justify-content: space-between;\n  }\n\n  /*\n   * Holds the cost and the delete button as one centred pair. The button used to be a sibling\n   * of the whole row body, kept in place by a -2px nudge tuned for when the metrics column had\n   * two lines (cost plus a merged token total). Dropping that second line left the nudge\n   * compensating for nothing. Centring the two against each other needs no magic number and\n   * cannot drift again if the metrics content changes.\n   *\n   * NB this rule previously set align-items with no display:flex, so it had no effect at all.\n   */\n  .settings-cost-history-row-right {\n    display: flex;\n    align-items: center;\n    gap: calc(var(--design-unit) * 1px);\n    flex: 0 0 auto;\n  }\n\n  .settings-cost-history-row-cost,\n  .settings-cost-history-row-title {\n    font-size: 14px;\n    font-weight: 600;\n    color: var(--neutral-foreground-rest);\n    min-width: 0;\n  }\n\n  .settings-cost-history-row-metrics {\n    display: flex;\n    flex-direction: column;\n    flex: 0 0 auto;\n    font-size: 13px;\n    font-family: ui-monospace, monospace;\n    color: var(--neutral-foreground-rest);\n    white-space: nowrap;\n  }\n\n  .settings-cost-history-row-date {\n    font-size: 12px;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-cost-history-delete {\n    flex: 0 0 auto;\n    color: var(--neutral-foreground-hint);\n  }\n\n  .settings-cost-history-delete:hover {\n    color: var(--error-color);\n  }\n\n  .settings-cost-history ::slotted(*) {\n    display: block;\n  }\n\n  .settings-modal-footer {\n    width: 100%;\n  }\n\n  .settings-done-button {\n    margin-left: auto;\n  }\n\n  .settings-modal-footer-actions {\n    display: flex;\n    align-items: center;\n    justify-content: space-between;\n    gap: calc(var(--design-unit) * 2px);\n    width: 100%;\n  }\n\n  .settings-disclaimer {\n    font-size: 12px;\n    color: var(--neutral-foreground-hint);\n    max-width: 60%;\n    line-height: 1.4;\n  }\n\n  /*\n   * Inline spinner shown in the \"Download agent log\" button while the log builds\n   * (GENC-1351 §5.8) — the lifetime-stitch path is an async provider round-trip.\n   * Sized to the button label and tinted with currentColor so it tracks the\n   * button's text colour in every appearance / theme.\n   */\n  [part='download-button'] .download-spinner {\n    display: inline-block;\n    width: 12px;\n    height: 12px;\n    margin-right: calc(var(--design-unit) * 1px);\n    vertical-align: -1px;\n    border: 2px solid currentColor;\n    border-right-color: transparent;\n    border-radius: 50%;\n    animation: download-spin 0.6s linear infinite;\n  }\n\n  @keyframes download-spin {\n    to {\n      transform: rotate(360deg);\n    }\n  }\n`",
+          "description": "Styles for the assistant settings modal (tabs, sections, toggles, cost summary)."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "settingsModalStyles",
+          "declaration": {
+            "name": "settingsModalStyles",
+            "module": "src/components/settings-modal/settings-modal.styles.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/settings-modal/settings-modal.template.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "SettingsModalTemplate",
+          "return": {
+            "type": {
+              "text": "ViewTemplate<FoundationAiAssistant>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "designSystemPrefix",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Modal shell for assistant settings — Configuration and Usage tabs, section slots for\napp-specific UI, and built-in chat-bot toggles."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SettingsModalTemplate",
+          "declaration": {
+            "name": "SettingsModalTemplate",
+            "module": "src/components/settings-modal/settings-modal.template.ts"
+          }
+        }
+      ]
     }
   ]
 }

package/dist/dts/components/ai-driver/ai-driver.d.ts

@@ -36,6 +36,17 @@ export interface AiDriver extends EventTarget {
      * Resolve a pending blocking interaction with the given result.
      */
     resolveInteraction(interactionId: string, result: unknown): void;
+    /**
+     * Record external spend against an interaction that has ALREADY resolved.
+     *
+     * For widgets that resolve early — so the assistant stops waiting — and then keep doing paid work
+     * on the user's behalf. Reports a positive DELTA; repeated calls sum. Returns false when the
+     * spend was NOT recorded — the value was not a positive finite amount, or the message is no
+     * longer in history.
+     *
+     * @beta
+     */
+    recordExternalCost?(interactionId: string, costUsd: number): boolean;
     /**
      * The live {@link InteractionContext} for a pending interaction (GENC-1390), or
      * `undefined` if the interaction is resolved/evicted or the driver owns no

package/dist/dts/components/ai-driver/ai-driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-driver.d.ts","sourceRoot":"","sources":["../../../../src/components/ai-driver/ai-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,gBAAgB;AAChB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,QAAS,SAAQ,WAAW;IAC3C;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEtF;;;;;OAKG;IACH,mBAAmB,CAAC,eAAe,CAAC,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEhF;;OAEG;IACH,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAEjE;;;;;OAKG;IACH,qBAAqB,CAAC,CAAC,aAAa,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAC;IAE9E;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAE3C;;;;;OAKG;IACH,uBAAuB,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEnE;;OAEG;IACH,aAAa,CAAC,IAAI,SAAS,WAAW,EAAE,CAAC;IAEzC;;;;;;OAMG;IACH,cAAc,CAAC,IAAI,WAAW,GAAG,SAAS,CAAC;IAE3C;;;;;;;OAOG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAExC;;;;;OAKG;IACH,UAAU,CAAC,IAAI,OAAO,CAAC;IAEvB;;OAEG;IACH,MAAM,IAAI,OAAO,CAAC;IAElB;;OAEG;IACH,cAAc,CACZ,OAAO,EAAE,WAAW,EAAE,EACtB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,eAAe,EAAE,GAC/B,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAErB;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,aAAa,CAAC,YAAY,CAAC,CAAC;IAEjD;;;;;OAKG;IACH,sBAAsB,CAAC,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC;IAE1D;;;;;OAKG;IACH,qBAAqB,IAAI,MAAM,CAAC;IAEhC;;;;OAIG;IACH,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,IAAI,CAAC;CACjB"}
+{"version":3,"file":"ai-driver.d.ts","sourceRoot":"","sources":["../../../../src/components/ai-driver/ai-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,gBAAgB;AAChB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,QAAS,SAAQ,WAAW;IAC3C;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEtF;;;;;OAKG;IACH,mBAAmB,CAAC,eAAe,CAAC,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEhF;;OAEG;IACH,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACjE;;;;;;;;;OASG;IACH,kBAAkB,CAAC,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAErE;;;;;OAKG;IACH,qBAAqB,CAAC,CAAC,aAAa,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAC;IAE9E;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAE3C;;;;;OAKG;IACH,uBAAuB,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEnE;;OAEG;IACH,aAAa,CAAC,IAAI,SAAS,WAAW,EAAE,CAAC;IAEzC;;;;;;OAMG;IACH,cAAc,CAAC,IAAI,WAAW,GAAG,SAAS,CAAC;IAE3C;;;;;;;OAOG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAExC;;;;;OAKG;IACH,UAAU,CAAC,IAAI,OAAO,CAAC;IAEvB;;OAEG;IACH,MAAM,IAAI,OAAO,CAAC;IAElB;;OAEG;IACH,cAAc,CACZ,OAAO,EAAE,WAAW,EAAE,EACtB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,eAAe,EAAE,GAC/B,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAErB;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,aAAa,CAAC,YAAY,CAAC,CAAC;IAEjD;;;;;OAKG;IACH,sBAAsB,CAAC,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC;IAE1D;;;;;OAKG;IACH,qBAAqB,IAAI,MAAM,CAAC;IAEhC;;;;OAIG;IACH,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,IAAI,CAAC;CACjB"}

package/dist/dts/components/chat-driver/chat-driver.d.ts

@@ -209,7 +209,7 @@ export interface ChatDriverConfig {
  *
  * Dispatches `'history-updated'` events on itself so the owning element can observe changes.
  *
- * @fires history-updated - Fired whenever the in-memory chat history changes (append, tool loop, interaction resolution) with the full history snapshot. detail: `ReadonlyArray<ChatMessage>`
+ * @fires history-updated - Fired whenever the in-memory chat history changes (append, tool loop, interaction resolution, post-resolve external cost) with the full history snapshot. detail: `ReadonlyArray<ChatMessage>`
  *
  * @beta
  */
@@ -871,6 +871,36 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      *   bubble and/or shows the "Assistant" label.
      */
     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.
+     *
+     * 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.
+     *
+     * 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.
+     *
+     * @param interactionId the interaction whose message owns the spend.
+     * @param costUsd a positive delta in USD. Non-finite, zero and negative values are ignored.
+     * @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.
+     * @beta
+     */
+    recordExternalCost(interactionId: string, costUsd: number): boolean;
     /**
      * Resolve a pending interaction. The wrapper component calls this on completion.
      * Marks the interaction message as resolved so it renders read-only on re-render.