@genesislcap/ai-assistant 15.15.2 → 15.16.0

package/dist/esm/main/main.template.js

@@ -518,6 +518,7 @@ ${(tc) => { var _a; return (((_a = tc.foldPath) === null || _a === void 0 ? void
                     :interactionId=${(m) => m.interaction.interactionId}
                     :resolved=${(m) => m.interaction.resolved}
                     @interaction-completed=${(m, c) => c.parent.handleInteractionCompleted(c.event)}
+                    @interaction-cost=${(m, c) => c.parent.handleInteractionCost(c.event)}
                   ></ai-chat-interaction-wrapper>
                 `)}
             </div>

package/dist/esm/state/debug-event-log.js

@@ -63,6 +63,12 @@ export const META_EVENT_IMPORTANCE = {
     'provider.selected': 'normal',
     'interaction.requested': 'normal',
     'interaction.resolved': 'normal',
+    // Bookkeeping about an already-finished turn; interesting when reconciling a session total.
+    'interaction.external-cost': 'normal',
+    // Spend that was billed but could NOT be recorded (the message was trimmed/condensed away, or
+    // the value was not real spend). 'high': it is the one way the session total goes quietly
+    // wrong, so it must stand out when reconciling.
+    'interaction.external-cost-dropped': 'high',
     'external-diagnostics.folded': 'normal',
     'session.cleared': 'normal',
     'session.switched': 'low',

package/dist/react.cjs

@@ -108,12 +108,14 @@ const AiChatBubble = React.forwardRef(function AiChatBubble(props, ref) {
 });
 
 const AiChatInteractionWrapper = React.forwardRef(function AiChatInteractionWrapper(props, ref) {
-  const { onRequestScrollToBottom, onInteractionCompleted, children, ...rest } = props;
+  const { onRequestScrollToBottom, onInteractionCompleted, onInteractionCost, children, ...rest } = props;
   const _innerRef = React.useRef(null);
   const _onRequestScrollToBottomRef = React.useRef(onRequestScrollToBottom);
   _onRequestScrollToBottomRef.current = onRequestScrollToBottom;
   const _onInteractionCompletedRef = React.useRef(onInteractionCompleted);
   _onInteractionCompletedRef.current = onInteractionCompleted;
+  const _onInteractionCostRef = React.useRef(onInteractionCost);
+  _onInteractionCostRef.current = onInteractionCost;
   React.useLayoutEffect(() => {
     const el = _innerRef.current;
     if (!el) return;
@@ -121,9 +123,12 @@ const AiChatInteractionWrapper = React.forwardRef(function AiChatInteractionWrap
     el.addEventListener('request-scroll-to-bottom', _onRequestScrollToBottomFn);
     const _onInteractionCompletedFn = (e) => _onInteractionCompletedRef.current?.(e);
     el.addEventListener('interaction-completed', _onInteractionCompletedFn);
+    const _onInteractionCostFn = (e) => _onInteractionCostRef.current?.(e);
+    el.addEventListener('interaction-cost', _onInteractionCostFn);
     return () => {
       el.removeEventListener('request-scroll-to-bottom', _onRequestScrollToBottomFn);
       el.removeEventListener('interaction-completed', _onInteractionCompletedFn);
+      el.removeEventListener('interaction-cost', _onInteractionCostFn);
     };
   }, []);
   return React.createElement(customElements.getName(AiChatInteractionWrapperWC) ?? 'ai-chat-interaction-wrapper', { ...rest, ref: _mergeRefs(_innerRef, ref) }, children);

package/dist/react.mjs

@@ -106,12 +106,14 @@ export const AiChatBubble = React.forwardRef(function AiChatBubble(props, ref) {
 });
 
 export const AiChatInteractionWrapper = React.forwardRef(function AiChatInteractionWrapper(props, ref) {
-  const { onRequestScrollToBottom, onInteractionCompleted, children, ...rest } = props;
+  const { onRequestScrollToBottom, onInteractionCompleted, onInteractionCost, children, ...rest } = props;
   const _innerRef = React.useRef(null);
   const _onRequestScrollToBottomRef = React.useRef(onRequestScrollToBottom);
   _onRequestScrollToBottomRef.current = onRequestScrollToBottom;
   const _onInteractionCompletedRef = React.useRef(onInteractionCompleted);
   _onInteractionCompletedRef.current = onInteractionCompleted;
+  const _onInteractionCostRef = React.useRef(onInteractionCost);
+  _onInteractionCostRef.current = onInteractionCost;
   React.useLayoutEffect(() => {
     const el = _innerRef.current;
     if (!el) return;
@@ -119,9 +121,12 @@ export const AiChatInteractionWrapper = React.forwardRef(function AiChatInteract
     el.addEventListener('request-scroll-to-bottom', _onRequestScrollToBottomFn);
     const _onInteractionCompletedFn = (e) => _onInteractionCompletedRef.current?.(e);
     el.addEventListener('interaction-completed', _onInteractionCompletedFn);
+    const _onInteractionCostFn = (e) => _onInteractionCostRef.current?.(e);
+    el.addEventListener('interaction-cost', _onInteractionCostFn);
     return () => {
       el.removeEventListener('request-scroll-to-bottom', _onRequestScrollToBottomFn);
       el.removeEventListener('interaction-completed', _onInteractionCompletedFn);
+      el.removeEventListener('interaction-cost', _onInteractionCostFn);
     };
   }, []);
   return React.createElement(customElements.getName(AiChatInteractionWrapperWC) ?? 'ai-chat-interaction-wrapper', { ...rest, ref: _mergeRefs(_innerRef, ref) }, children);

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/chat-driver-node.ts","../src/index.ts","../src/channel/ai-activity-bus.ts","../src/channel/ai-activity-channel.ts","../src/components/flowing-waves-indicator.ts","../src/components/halo-overlay.ts","../src/components/plasma-orb-indicator.ts","../src/components/waves-indicator.ts","../src/components/activity-halo/activity-halo.ts","../src/components/agent-picker/agent-picker.constants.ts","../src/components/agent-picker/agent-picker.styles.ts","../src/components/agent-picker/agent-picker.template.ts","../src/components/agent-picker/agent-picker.ts","../src/components/agent-picker/index.ts","../src/components/ai-driver/ai-driver.ts","../src/components/ai-driver/index.ts","../src/components/chat-bubble/chat-bubble.styles.ts","../src/components/chat-bubble/chat-bubble.template.ts","../src/components/chat-bubble/chat-bubble.ts","../src/components/chat-bubble/index.ts","../src/components/chat-driver/align-event-globals.ts","../src/components/chat-driver/chat-driver.compact.test.ts","../src/components/chat-driver/chat-driver.invocation-scope.test.ts","../src/components/chat-driver/chat-driver.test.ts","../src/components/chat-driver/chat-driver.thinking-policy.test.ts","../src/components/chat-driver/chat-driver.trace-capture.test.ts","../src/components/chat-driver/chat-driver.ts","../src/components/chat-driver/chat-driver.turn-usage.test.ts","../src/components/chat-driver/index.ts","../src/components/chat-interaction-wrapper/chat-interaction-wrapper.styles.ts","../src/components/chat-interaction-wrapper/chat-interaction-wrapper.template.ts","../src/components/chat-interaction-wrapper/chat-interaction-wrapper.test.ts","../src/components/chat-interaction-wrapper/chat-interaction-wrapper.ts","../src/components/chat-interaction-wrapper/index.ts","../src/components/chat-markdown/chat-markdown.ts","../src/components/chat-markdown/index.ts","../src/components/orchestrating-driver/index.ts","../src/components/orchestrating-driver/orchestrating-driver.budget.test.ts","../src/components/orchestrating-driver/orchestrating-driver.pin.test.ts","../src/components/orchestrating-driver/orchestrating-driver.ts","../src/components/popout-manager/index.ts","../src/components/popout-manager/popout-manager.ts","../src/components/settings-modal/index.ts","../src/components/settings-modal/settings-modal.styles.test.ts","../src/components/settings-modal/settings-modal.styles.ts","../src/components/settings-modal/settings-modal.template.test.ts","../src/components/settings-modal/settings-modal.template.ts","../src/config/config.ts","../src/config/define-stateful-agent.test.ts","../src/config/define-stateful-agent.ts","../src/config/fallback-agents.ts","../src/config/index.ts","../src/config/validate-providers.test.ts","../src/config/validate-providers.ts","../src/main/blocked-state.test.ts","../src/main/budget-meter.test.ts","../src/main/cost-session-banking.test.ts","../src/main/index.ts","../src/main/main.styles.test.ts","../src/main/main.styles.ts","../src/main/main.template.ts","../src/main/main.ts","../src/main/main.types.ts","../src/main/persistence-broken-sources.test.ts","../src/main/popout-interaction-gate.test.ts","../src/provider/ai-provider-switcher.ts","../src/provider/assistant-app-settings.ts","../src/state/ai-assistant-slice.test.ts","../src/state/ai-assistant-slice.ts","../src/state/debug-event-log.test.ts","../src/state/debug-event-log.ts","../src/state/driver-registry.test.ts","../src/state/driver-registry.ts","../src/state/interaction-context.test.ts","../src/state/interaction-context.ts","../src/state/session-store.ts","../src/state/persistence/build-timeline-entries.ts","../src/state/persistence/diagnostics-cursors.test.ts","../src/state/persistence/diagnostics-cursors.ts","../src/state/persistence/diagnostics.test.ts","../src/state/persistence/diagnostics.ts","../src/state/persistence/index.ts","../src/state/persistence/persister-registry.ts","../src/state/persistence/session-persistence-provider.test.ts","../src/state/persistence/session-persistence-provider.ts","../src/state/persistence/session-persistence.integration.test.ts","../src/state/persistence/session-persister.test.ts","../src/state/persistence/session-persister.ts","../src/state/persistence/session-snapshot.test.ts","../src/state/persistence/session-snapshot.ts","../src/state/persistence/stateful-restore.e2e.test.ts","../src/styles/ai-colours.ts","../src/styles/settings-section.ts","../src/suggestions/chat-suggestions.ts","../src/tags/index.ts","../src/types/ai-chat-widget.ts","../src/types/interaction-context.ts","../src/utils/animated-panel-toggle.ts","../src/utils/animation-exclusivity.test.ts","../src/utils/animation-exclusivity.ts","../src/utils/banked-usage-baselines.ts","../src/utils/collect-session-models.test.ts","../src/utils/collect-session-models.ts","../src/utils/condense-history.test.ts","../src/utils/condense-history.ts","../src/utils/cost-session-history.test.ts","../src/utils/cost-session-history.ts","../src/utils/derive-cost-session-title.test.ts","../src/utils/derive-cost-session-title.ts","../src/utils/flatten-sub-agent-messages.test.ts","../src/utils/flatten-sub-agent-messages.ts","../src/utils/format-usd.ts","../src/utils/history-transform.test.ts","../src/utils/history-transform.ts","../src/utils/index.ts","../src/utils/logger.ts","../src/utils/message-partition.test.ts","../src/utils/message-partition.ts","../src/utils/resolve-cost-history-config.test.ts","../src/utils/resolve-cost-history-config.ts","../src/utils/resolve-preference-baseline.test.ts","../src/utils/resolve-preference-baseline.ts","../src/utils/strip-agent-handlers.test.ts","../src/utils/strip-agent-handlers.ts","../src/utils/sum-costs.test.ts","../src/utils/sum-costs.ts","../src/utils/sum-tokens.test.ts","../src/utils/sum-tokens.ts","../src/utils/sum-usage.test.ts","../src/utils/sum-usage.ts","../src/utils/tool-fold.ts","../src/utils/usage-rows.test.ts","../src/utils/usage-rows.ts","../src/utils/with-timeout.ts"],"version":"5.9.2"}
+{"root":["../src/chat-driver-node.ts","../src/index.ts","../src/channel/ai-activity-bus.ts","../src/channel/ai-activity-channel.ts","../src/components/flowing-waves-indicator.ts","../src/components/halo-overlay.ts","../src/components/plasma-orb-indicator.ts","../src/components/waves-indicator.ts","../src/components/activity-halo/activity-halo.ts","../src/components/agent-picker/agent-picker.constants.ts","../src/components/agent-picker/agent-picker.styles.ts","../src/components/agent-picker/agent-picker.template.ts","../src/components/agent-picker/agent-picker.ts","../src/components/agent-picker/index.ts","../src/components/ai-driver/ai-driver.ts","../src/components/ai-driver/index.ts","../src/components/chat-bubble/chat-bubble.styles.ts","../src/components/chat-bubble/chat-bubble.template.ts","../src/components/chat-bubble/chat-bubble.ts","../src/components/chat-bubble/index.ts","../src/components/chat-driver/align-event-globals.ts","../src/components/chat-driver/chat-driver.compact.test.ts","../src/components/chat-driver/chat-driver.invocation-scope.test.ts","../src/components/chat-driver/chat-driver.test.ts","../src/components/chat-driver/chat-driver.thinking-policy.test.ts","../src/components/chat-driver/chat-driver.trace-capture.test.ts","../src/components/chat-driver/chat-driver.ts","../src/components/chat-driver/chat-driver.turn-usage.test.ts","../src/components/chat-driver/index.ts","../src/components/chat-interaction-wrapper/chat-interaction-wrapper.styles.ts","../src/components/chat-interaction-wrapper/chat-interaction-wrapper.template.ts","../src/components/chat-interaction-wrapper/chat-interaction-wrapper.test.ts","../src/components/chat-interaction-wrapper/chat-interaction-wrapper.ts","../src/components/chat-interaction-wrapper/index.ts","../src/components/chat-markdown/chat-markdown.ts","../src/components/chat-markdown/index.ts","../src/components/orchestrating-driver/index.ts","../src/components/orchestrating-driver/orchestrating-driver.budget.test.ts","../src/components/orchestrating-driver/orchestrating-driver.cost.test.ts","../src/components/orchestrating-driver/orchestrating-driver.pin.test.ts","../src/components/orchestrating-driver/orchestrating-driver.ts","../src/components/popout-manager/index.ts","../src/components/popout-manager/popout-manager.ts","../src/components/settings-modal/index.ts","../src/components/settings-modal/settings-modal.styles.test.ts","../src/components/settings-modal/settings-modal.styles.ts","../src/components/settings-modal/settings-modal.template.test.ts","../src/components/settings-modal/settings-modal.template.ts","../src/config/config.ts","../src/config/define-stateful-agent.test.ts","../src/config/define-stateful-agent.ts","../src/config/fallback-agents.ts","../src/config/index.ts","../src/config/validate-providers.test.ts","../src/config/validate-providers.ts","../src/main/blocked-state.test.ts","../src/main/budget-meter.test.ts","../src/main/cost-session-banking.test.ts","../src/main/file-attachments.test.ts","../src/main/index.ts","../src/main/interaction-cost.test.ts","../src/main/main.styles.test.ts","../src/main/main.styles.ts","../src/main/main.template.ts","../src/main/main.ts","../src/main/main.types.ts","../src/main/persistence-broken-sources.test.ts","../src/main/popout-interaction-gate.test.ts","../src/provider/ai-provider-switcher.ts","../src/provider/assistant-app-settings.ts","../src/state/ai-assistant-slice.test.ts","../src/state/ai-assistant-slice.ts","../src/state/debug-event-log.test.ts","../src/state/debug-event-log.ts","../src/state/driver-registry.test.ts","../src/state/driver-registry.ts","../src/state/interaction-context.test.ts","../src/state/interaction-context.ts","../src/state/session-store.ts","../src/state/persistence/build-timeline-entries.ts","../src/state/persistence/diagnostics-cursors.test.ts","../src/state/persistence/diagnostics-cursors.ts","../src/state/persistence/diagnostics.test.ts","../src/state/persistence/diagnostics.ts","../src/state/persistence/index.ts","../src/state/persistence/persister-registry.ts","../src/state/persistence/session-persistence-provider.test.ts","../src/state/persistence/session-persistence-provider.ts","../src/state/persistence/session-persistence.integration.test.ts","../src/state/persistence/session-persister.test.ts","../src/state/persistence/session-persister.ts","../src/state/persistence/session-snapshot.test.ts","../src/state/persistence/session-snapshot.ts","../src/state/persistence/stateful-restore.e2e.test.ts","../src/styles/ai-colours.ts","../src/styles/settings-section.ts","../src/suggestions/chat-suggestions.ts","../src/tags/index.ts","../src/types/ai-chat-widget.ts","../src/types/interaction-context.ts","../src/utils/animated-panel-toggle.ts","../src/utils/animation-exclusivity.test.ts","../src/utils/animation-exclusivity.ts","../src/utils/banked-usage-baselines.ts","../src/utils/collect-session-models.test.ts","../src/utils/collect-session-models.ts","../src/utils/condense-history.test.ts","../src/utils/condense-history.ts","../src/utils/cost-session-history.test.ts","../src/utils/cost-session-history.ts","../src/utils/derive-cost-session-title.test.ts","../src/utils/derive-cost-session-title.ts","../src/utils/flatten-sub-agent-messages.test.ts","../src/utils/flatten-sub-agent-messages.ts","../src/utils/format-usd.ts","../src/utils/history-transform.test.ts","../src/utils/history-transform.ts","../src/utils/index.ts","../src/utils/logger.ts","../src/utils/message-partition.test.ts","../src/utils/message-partition.ts","../src/utils/resolve-cost-history-config.test.ts","../src/utils/resolve-cost-history-config.ts","../src/utils/resolve-preference-baseline.test.ts","../src/utils/resolve-preference-baseline.ts","../src/utils/strip-agent-handlers.test.ts","../src/utils/strip-agent-handlers.ts","../src/utils/sum-costs.test.ts","../src/utils/sum-costs.ts","../src/utils/sum-tokens.test.ts","../src/utils/sum-tokens.ts","../src/utils/sum-usage.test.ts","../src/utils/sum-usage.ts","../src/utils/tool-fold.ts","../src/utils/usage-rows.test.ts","../src/utils/usage-rows.ts","../src/utils/with-timeout.ts"],"version":"5.9.2"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/ai-assistant",
   "description": "Genesis AI Assistant micro-frontend",
-  "version": "15.15.2",
+  "version": "15.16.0",
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
   "types": "dist/ai-assistant.d.ts",
@@ -73,26 +73,26 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "15.15.2",
-    "@genesislcap/genx": "15.15.2",
-    "@genesislcap/rollup-builder": "15.15.2",
-    "@genesislcap/ts-builder": "15.15.2",
-    "@genesislcap/uvu-playwright-builder": "15.15.2",
-    "@genesislcap/vite-builder": "15.15.2",
-    "@genesislcap/webpack-builder": "15.15.2",
+    "@genesislcap/foundation-testing": "15.16.0",
+    "@genesislcap/genx": "15.16.0",
+    "@genesislcap/rollup-builder": "15.16.0",
+    "@genesislcap/ts-builder": "15.16.0",
+    "@genesislcap/uvu-playwright-builder": "15.16.0",
+    "@genesislcap/vite-builder": "15.16.0",
+    "@genesislcap/webpack-builder": "15.16.0",
     "@types/dompurify": "^3.0.5",
     "@types/marked": "^5.0.2",
     "esbuild": "0.25.12"
   },
   "dependencies": {
-    "@genesislcap/foundation-ai": "15.15.2",
-    "@genesislcap/foundation-logger": "15.15.2",
-    "@genesislcap/foundation-notifications": "15.15.2",
-    "@genesislcap/foundation-redux": "15.15.2",
-    "@genesislcap/foundation-ui": "15.15.2",
-    "@genesislcap/foundation-utils": "15.15.2",
-    "@genesislcap/rapid-design-system": "15.15.2",
-    "@genesislcap/web-core": "15.15.2",
+    "@genesislcap/foundation-ai": "15.16.0",
+    "@genesislcap/foundation-logger": "15.16.0",
+    "@genesislcap/foundation-notifications": "15.16.0",
+    "@genesislcap/foundation-redux": "15.16.0",
+    "@genesislcap/foundation-ui": "15.16.0",
+    "@genesislcap/foundation-utils": "15.16.0",
+    "@genesislcap/rapid-design-system": "15.16.0",
+    "@genesislcap/web-core": "15.16.0",
     "dompurify": "^3.3.1",
     "marked": "^17.0.3"
   },
@@ -105,5 +105,5 @@
     "access": "public"
   },
   "customElements": "dist/custom-elements.json",
-  "gitHead": "93190f6fb9fbb494a02b6a3fae68bdd1538797ff"
+  "gitHead": "2cacfdef54a332ee571ae784b5b7629cf66f050f"
 }

package/src/components/ai-driver/ai-driver.ts

@@ -45,6 +45,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

package/src/components/chat-driver/chat-driver.test.ts

@@ -3568,3 +3568,112 @@ outcome(
 );
 
 outcome.run();
+
+// ---------------------------------------------------------------------------
+// recordExternalCost — spend a widget incurs AFTER it has resolved.
+//
+// Some widgets resolve EARLY on purpose, so the assistant stops waiting while the
+// user deliberates, and then keep doing paid work for them. `resolveInteraction`
+// cannot serve that: its whole body is inside `if (interaction)` and it deletes the
+// entry, so a second resolution is a silent no-op and the spend never reached the
+// figure shown to the user.
+// ---------------------------------------------------------------------------
+
+const postResolveCost = createLogicSuite('ChatDriver post-resolve external cost');
+
+postResolveCost('adds spend to an interaction that has already resolved', async () => {
+  const driver = makeDriver(agent({ name: 'a' }), scriptedProvider([]));
+  const pending = driver.requestInteraction('planning-question', { question: 'Pick one' });
+  const id = driver.getHistory().at(-1)!.interaction!.interactionId;
+
+  driver.resolveInteraction(id, { status: 'approved', costUsd: 0.5 });
+  await pending;
+
+  // The interaction is gone from `pendingInteractions` — this is exactly the state in
+  // which the old path silently did nothing.
+  assert.is(driver.recordExternalCost(id, 0.25), true);
+  assert.is(driver.recordExternalCost(id, 0.25), true);
+
+  const msg = driver.getHistory().find((m) => m.interaction?.interactionId === id);
+  // ADDITIVE: the resolution's 0.5 plus two 0.25 deltas.
+  assert.is(msg?.externalCostUsd, 1);
+  // …and the recorded resolution is untouched — this is not a second resolution.
+  assert.equal(msg?.interaction?.resolved, { status: 'approved', costUsd: 0.5 });
+});
+
+postResolveCost('works on an interaction that resolved with no cost at all', async () => {
+  const driver = makeDriver(agent({ name: 'a' }), scriptedProvider([]));
+  const pending = driver.requestInteraction('planning-question', { question: 'q' });
+  const id = driver.getHistory().at(-1)!.interaction!.interactionId;
+  driver.resolveInteraction(id, { status: 'approved' });
+  await pending;
+
+  assert.is(driver.recordExternalCost(id, 0.02), true);
+  const msg = driver.getHistory().find((m) => m.interaction?.interactionId === id);
+  assert.is(msg?.externalCostUsd, 0.02);
+});
+
+postResolveCost('refuses values that are not real spend, and an unknown interaction', async () => {
+  const driver = makeDriver(agent({ name: 'a' }), scriptedProvider([]));
+  const pending = driver.requestInteraction('planning-question', { question: 'q' });
+  const id = driver.getHistory().at(-1)!.interaction!.interactionId;
+  driver.resolveInteraction(id, { status: 'approved' });
+  await pending;
+
+  // Includes the shapes only an untyped JS caller can produce — which is exactly who the
+  // `typeof` guard is written for, and what the previous `as number` cast asserted nothing about.
+  for (const bad of [0, -1, Number.NaN, Number.POSITIVE_INFINITY, '0.5', null, undefined]) {
+    assert.is(driver.recordExternalCost(id, bad as number), false);
+  }
+  // …and each refusal leaves a trace: the wrapper no longer pre-validates (it made this
+  // unreachable through the event path, a widget's only way in), so this is the ONE validator
+  // and it has to record what it dropped.
+  const dropped = getMetaEvents('').filter((m) => m.type === 'interaction.external-cost-dropped');
+  assert.ok(dropped.length >= 1, 'a refused amount must record why');
+  // An empty id can never match a message, so it is refused before the search.
+  assert.is(driver.recordExternalCost('', 0.1), false);
+  // A message trimmed or condensed out of history is a real outcome, not a throw.
+  assert.is(driver.recordExternalCost('no-such-interaction', 0.1), false);
+
+  const msg = driver.getHistory().find((m) => m.interaction?.interactionId === id);
+  assert.is(msg?.externalCostUsd, undefined);
+});
+
+postResolveCost(
+  'announces the change NARROWLY — never on history-updated, which rebuilds the widget',
+  async () => {
+    const driver = makeDriver(agent({ name: 'a' }), scriptedProvider([]));
+    const pending = driver.requestInteraction('planning-question', { question: 'q' });
+    const id = driver.getHistory().at(-1)!.interaction!.interactionId;
+    driver.resolveInteraction(id, { status: 'approved' });
+    await pending;
+
+    let narrow = 0;
+    let costUsd: number | undefined;
+    let interactionId: string | undefined;
+    let historyUpdated = 0;
+    driver.addEventListener('external-cost-recorded', (e) => {
+      narrow += 1;
+      ({ costUsd, interactionId } = (
+        e as CustomEvent<{ interactionId: string; costUsd: number }>
+      ).detail);
+    });
+    driver.addEventListener('history-updated', () => {
+      historyUpdated += 1;
+    });
+    driver.recordExternalCost(id, 0.07);
+
+    // Announced, or the total is right in history and stale on screen.
+    assert.is(narrow, 1);
+    assert.is(costUsd, 0.07);
+    assert.is(interactionId, id);
+    // REGRESSION (reviewer catch on #2474): `history-updated` makes the host reassign `messages`,
+    // which rebuilds the trailing interaction row — a `recycle: false` repeat that disposes its
+    // views outright. For a RESOLVED interaction there is no `interactionContext` to remount
+    // from, so announcing this way tore down and blanked the very widget that had just reported
+    // its spend. Bookkeeping about a finished turn must not touch what is rendered.
+    assert.is(historyUpdated, 0);
+  },
+);
+
+postResolveCost.run();

package/src/components/chat-driver/chat-driver.ts

@@ -414,7 +414,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
  */
@@ -1882,6 +1882,83 @@ export class ChatDriver extends EventTarget implements AiDriver {
     });
   }
 
+  /**
+   * 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
+   */
+  public recordExternalCost(interactionId: string, costUsd: number): boolean {
+    const drop = (reason: string): false => {
+      recordMetaEvent(this.sessionKey, 'interaction.external-cost-dropped', {
+        interactionId,
+        costUsd,
+        reason,
+      });
+      return false;
+    };
+    if (!interactionId) return drop('no interactionId');
+    if (typeof costUsd !== 'number' || !Number.isFinite(costUsd) || costUsd <= 0) {
+      return drop('not a positive finite amount');
+    }
+    const idx = this.history.findIndex((m) => m.interaction?.interactionId === interactionId);
+    // The message is gone (trimmed or condensed): the spend is real and already billed, so it is
+    // recorded as dropped rather than silently discarded — an invisible gap in the session total
+    // is exactly what this whole channel exists to close.
+    if (idx === -1) return drop('interaction message no longer in history');
+    this.history[idx] = {
+      ...this.history[idx],
+      externalCostUsd: (this.history[idx].externalCostUsd ?? 0) + costUsd,
+    };
+    recordMetaEvent(this.sessionKey, 'interaction.external-cost', { interactionId, costUsd });
+    // A NARROW event, deliberately not `history-updated`.
+    //
+    // The host answers `history-updated` by reassigning `messages`, which re-evaluates
+    // `activeInteractionRow` — and the trailing interaction slot renders through a
+    // `repeat(..., { recycle: false })`, so every view in it is disposed and rebuilt regardless of
+    // item identity. That is correct for a PENDING interaction (GENC-1429: a recycled wrapper
+    // carries the previous interaction's truthy `resolved` and swallows the next completion), and
+    // survivable because `buildInteraction` hands a remounted pending widget the same driver-owned
+    // `interactionContext`.
+    //
+    // A RESOLVED one has no such context — `resolveInteraction` disposed and deleted it — so
+    // announcing this on `history-updated` would tear down and blank the very widget that just
+    // reported, in exactly the flow this channel exists for (a user tweaking an option after the
+    // interaction resolved). Bookkeeping about a finished turn must stay invisible, so the host
+    // recomputes its totals from this driver's history and saves, without touching what is
+    // rendered. Reviewer catch on #2474 — confirmed against the layout widget, whose tweak result
+    // went off screen because the rebuild raced the session write that would have restored it.
+    this.dispatchEvent(
+      new CustomEvent<{ interactionId: string; costUsd: number }>('external-cost-recorded', {
+        detail: { interactionId, costUsd },
+      }),
+    );
+    return true;
+  }
+
   /**
    * 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.

package/src/components/chat-interaction-wrapper/chat-interaction-wrapper.ts

@@ -15,6 +15,7 @@ type InteractionHost = {
 
 export type ChatInteractionEventsMap = {
   'interaction-completed': InteractionResult<unknown> & { interactionId: string };
+  'interaction-cost': { interactionId: string; costUsd: number };
 };
 
 /**
@@ -23,11 +24,18 @@ export type ChatInteractionEventsMap = {
  */
 export type InteractionCompletedEventDetail = ChatInteractionEventsMap['interaction-completed'];
 
+/**
+ * Detail payload for the `interaction-cost` event — a POSITIVE DELTA in USD, not a running total.
+ * @public
+ */
+export type InteractionCostEventDetail = ChatInteractionEventsMap['interaction-cost'];
+
 /**
  * Hosts an interactive AI chat sub-component by tag name.
  * @public
  *
  * @fires interaction-completed - Fired when the interaction finishes. detail: `InteractionCompletedEventDetail`
+ * @fires interaction-cost - Fired when a widget spends money AFTER resolving. detail: `InteractionCostEventDetail`
  */
 @customElement({
   name: 'ai-chat-interaction-wrapper',
@@ -167,6 +175,27 @@ export class AiChatInteractionWrapper extends GenesisElement {
         });
       });
 
+      /**
+       * Spend the widget incurs AFTER it has resolved.
+       *
+       * Deliberately NOT guarded by `this.resolved`, which is the entire point: a widget that
+       * resolves early so the assistant stops waiting can stay interactive for minutes and do more
+       * paid work for the user. The completion listener above is guarded because a second
+       * RESOLUTION would be wrong; a second charge is simply true, and before this event that spend
+       * had no way to reach the total the user is shown.
+       */
+      element.addEventListener('interaction-cost', (e: CustomEvent) => {
+        e.stopPropagation();
+        // Forwarded UNVALIDATED. `recordExternalCost` already rejects anything that is not a
+        // positive finite amount AND records why it dropped it; validating here as well made that
+        // trace unreachable through the event path — which is a widget's only way in — so a widget
+        // emitting NaN or a negative got silently nothing, anywhere. One validator, one trace.
+        this.$emit('interaction-cost', {
+          interactionId: this.interactionId,
+          costUsd: e.detail?.costUsd,
+        });
+      });
+
       this.container.appendChild(element as unknown as Node);
       this.observeWidgetResize(element as unknown as Element);
     } catch (e) {

package/src/components/orchestrating-driver/orchestrating-driver.cost.test.ts

@@ -0,0 +1,107 @@
+import type {
+  AIProvider,
+  AIProviderRegistry,
+  ChatMessage,
+  ChatRequestOptions,
+} from '@genesislcap/foundation-ai';
+import { assert, createLogicSuite } from '@genesislcap/foundation-testing';
+import type { AgentConfig } from '../../config/config';
+import type { ChatDriver } from '../chat-driver/chat-driver';
+// Side-effect import — MUST precede `./orchestrating-driver` so the driver
+// subclasses jsdom's EventTarget (CustomEvent dispatch then works in node).
+import '../chat-driver/align-event-globals';
+import { OrchestratingDriver } from './orchestrating-driver';
+
+// GENC-1508 — `recordExternalCost` is OPTIONAL on `AiDriver`, so a missing delegation here
+// is not a compile error: the host's `driver?.recordExternalCost?.(…)` simply evaluates to
+// undefined and every post-resolve charge from every widget disappears — silently, and only
+// in orchestrated setups. That is the same invisible-when-broken failure the method exists to
+// fix, so the delegation gets a test rather than trust.
+
+const makeRegistry = (provider: AIProvider): AIProviderRegistry => ({
+  get: () => provider,
+  default: () => provider,
+  defaultName: () => 'test',
+  names: () => ['test'],
+  getStatus: async () => null,
+  listStatuses: async () => [],
+});
+
+const noToolProvider = (): AIProvider =>
+  ({
+    chat: async (
+      _history: ChatMessage[],
+      _userMessage: string,
+      _options?: ChatRequestOptions,
+    ): Promise<ChatMessage> => ({ role: 'assistant', content: 'ok' }),
+  }) as AIProvider;
+
+const agent = (overrides: Partial<AgentConfig> & { name: string }): AgentConfig =>
+  ({ description: 'test agent', ...overrides }) as AgentConfig;
+
+const makeDriver = () =>
+  new OrchestratingDriver(makeRegistry(noToolProvider()), [agent({ name: 'Genesis Assistant' })], {
+    sessionKey: 'k',
+  });
+
+/** The orchestrator does not expose `requestInteraction`, so the interaction is ARRANGED on the
+ *  wrapped driver. Every assertion below goes through the orchestrator's own public surface. */
+const wrapped = (driver: OrchestratingDriver): ChatDriver =>
+  (driver as unknown as { chatDriver: ChatDriver }).chatDriver;
+
+const Suite = createLogicSuite('orchestrating-driver external cost');
+
+Suite('post-resolve spend delegates to the wrapped driver', async () => {
+  const driver = makeDriver();
+  const inner = wrapped(driver);
+  const pending = inner.requestInteraction('planning-question', { question: 'Pick one' });
+  const id = driver.getRawHistory().at(-1)!.interaction!.interactionId;
+  driver.resolveInteraction(id, { status: 'approved', costUsd: 0.5 });
+  await pending;
+
+  assert.is(driver.recordExternalCost(id, 0.25), true);
+
+  const msg = driver.getRawHistory().find((m) => m.interaction?.interactionId === id);
+  assert.is(msg?.externalCostUsd, 0.75);
+});
+
+Suite('an unknown interaction is reported as unrecorded, not thrown', async () => {
+  const driver = makeDriver();
+  assert.is(driver.recordExternalCost('never-existed', 0.25), false);
+});
+
+Suite('the announcement reaches the HOST, which only ever holds this wrapper', async () => {
+  // The delegation test above passes with the forward missing: the money still lands on the
+  // message. What breaks is quieter — `createDriver` hands the host an OrchestratingDriver for any
+  // non-empty `agents`, so an event the inner driver raises and the constructor's forward list
+  // omits is one the host never sees. The totals then never refresh and the save is never
+  // scheduled, and because this flow's interaction is the last thing in the session, "stale until
+  // the next history change" means permanently. Asserted on the WRAPPER for that reason.
+  const driver = makeDriver();
+  const inner = wrapped(driver);
+  const pending = inner.requestInteraction('planning-question', { question: 'Pick one' });
+  const id = driver.getRawHistory().at(-1)!.interaction!.interactionId;
+  driver.resolveInteraction(id, { status: 'approved' });
+  await pending;
+
+  let seen = 0;
+  let detail: { interactionId?: string; costUsd?: number } | undefined;
+  driver.addEventListener('external-cost-recorded', (e) => {
+    seen += 1;
+    detail = (e as CustomEvent).detail;
+  });
+  // …and never on `history-updated`, which would rebuild the reporting widget.
+  let historyUpdated = 0;
+  driver.addEventListener('history-updated', () => {
+    historyUpdated += 1;
+  });
+
+  driver.recordExternalCost(id, 0.25);
+
+  assert.is(seen, 1);
+  assert.is(detail?.costUsd, 0.25);
+  assert.is(detail?.interactionId, id);
+  assert.is(historyUpdated, 0);
+});
+
+Suite.run();

package/src/components/orchestrating-driver/orchestrating-driver.ts

@@ -223,12 +223,29 @@ export class OrchestratingDriver extends EventTarget implements AiDriver {
         new CustomEvent('provider-changed', { detail: (e as CustomEvent).detail }),
       );
     });
+    // Post-resolve external cost. The host only ever holds THIS wrapper (`createDriver` returns
+    // one for any non-empty `agents`), so an event the inner driver raises and this list omits is
+    // an event the host never sees: `recordExternalCost` still delegates and the money still lands
+    // on the message, but the totals never refresh and the save is never scheduled — and in the
+    // flow this exists for the interaction is the last thing in the session, so "stale until the
+    // next history change" means permanently. Reviewer catch on #2474.
+    this.chatDriver.addEventListener('external-cost-recorded', (e: Event) => {
+      this.dispatchEvent(
+        new CustomEvent('external-cost-recorded', { detail: (e as CustomEvent).detail }),
+      );
+    });
   }
 
   resolveInteraction(interactionId: string, result: unknown): void {
     this.chatDriver.resolveInteraction(interactionId, result);
   }
 
+  /** Delegated for the same reason as `resolveInteraction`: the history that owns the
+   *  interaction — and therefore the cost — lives on the wrapped driver, not here. */
+  recordExternalCost(interactionId: string, costUsd: number): boolean {
+    return this.chatDriver.recordExternalCost(interactionId, costUsd);
+  }
+
   getInteractionContext(interactionId: string): InteractionContext | undefined {
     return this.chatDriver.getInteractionContext(interactionId);
   }

package/src/index.ts

@@ -4,7 +4,10 @@ export * from './main/main.template';
 export * from './components/agent-picker';
 export * from './components/ai-driver';
 export * from './components/chat-driver';
-export type { InteractionCompletedEventDetail } from './components/chat-interaction-wrapper/chat-interaction-wrapper';
+export type {
+  InteractionCompletedEventDetail,
+  InteractionCostEventDetail,
+} from './components/chat-interaction-wrapper/chat-interaction-wrapper';
 export * from './components/orchestrating-driver';
 export * from './components/popout-manager';
 export * from './channel/ai-activity-channel';