@genesislcap/ai-assistant 15.15.2 → 15.16.0

package/src/state/debug-event-log.ts

@@ -59,6 +59,8 @@ export type MetaEventType =
   // Blocking interactions
   | 'interaction.requested'
   | 'interaction.resolved'
+  | 'interaction.external-cost'
+  | 'interaction.external-cost-dropped'
   // External / unified diagnostics (GENC-1461) — an out-of-band engine's log folded into this session
   | 'external-diagnostics.folded'
   // Context / cost
@@ -131,6 +133,12 @@ export const META_EVENT_IMPORTANCE: Record<MetaEventType, MetaEventImportance> =
   '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/src/types/ai-chat-widget.ts

@@ -48,6 +48,14 @@ export type AiChatInteraction<TData = unknown, TResult = unknown> =
  * change on this `@beta` interface — widgets read `this.interaction` (narrowing on
  * `status`) instead of the removed flat fields.
  *
+ * @remarks
+ * A widget talks back by dispatching two events, both caught by the wrapper:
+ * `interaction-completed` resolves the interaction (once — a second is ignored), and
+ * `interaction-cost` reports a positive USD delta for paid work done AFTER resolving,
+ * which repeated calls sum. The second exists for widgets that resolve early so the
+ * assistant stops waiting, then keep working for the user; without it that spend is
+ * billed but missing from the total the user sees.
+ *
  * @beta
  */
 export interface AiChatWidget<TData = unknown, TResult = unknown> {