@genesislcap/ai-assistant 15.10.4 → 15.10.5

package/dist/ai-assistant.api.json

@@ -5256,6 +5256,73 @@
               "isAbstract": false,
               "name": "markAsSubAgent"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#reportBudgetExhausted:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "reportBudgetExhausted(e: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "BudgetExhaustedError",
+                  "canonicalReference": "@genesislcap/foundation-ai!BudgetExhaustedError:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", pendingUserMessage?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatMessage",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatDriverResult",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatDriverResult:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 6
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "e",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "pendingUserMessage",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": true
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "reportBudgetExhausted"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#requestInteraction:member(1)",
@@ -5692,7 +5759,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriverConfig#budgetExhaustedMessage:member",
-              "docComment": "/**\n * Transcript copy appended when the AI-spend budget wall is hit (GENC-1464). Defaults to `DEFAULT_BUDGET_EXHAUSTED_MESSAGE`.\n *\n * The assistant element already lets a host override the blocked **banner** via `setBlocked(true, reason)`; without this the transcript **bubble** stayed on the default, so a white-labelled host got its own copy in the banner and the shipped default directly below it. Passing the same effective copy here keeps the two surfaces saying one thing.\n *\n * Deliberately a driver-config field rather than something read off a chat config: `ChatDriver` has no `chatConfig` and is used standalone (see `chat-driver-node`), so threading one in would be a much larger and less reversible change.\n */\n",
+              "docComment": "/**\n * Transcript copy appended when the AI-spend budget wall is hit (GENC-1464), used VERBATIM — set it only to own the copy entirely (white-labelling). When unset, the driver composes the bubble per wall: the neutral `DEFAULT_BUDGET_EXHAUSTED_MESSAGE`, upgraded with \"switch to another AI provider\" advice only when the 402's `otherVendorAvailable` positively says another metered vendor still has headroom — the same rule the blocked banner applies, so the two surfaces can no longer contradict each other.\n *\n * The assistant element already lets a host override the blocked **banner** via `setBlocked(true, reason)`; without this the transcript **bubble** stayed on the default, so a white-labelled host got its own copy in the banner and the shipped default directly below it. Passing the same effective copy here keeps the two surfaces saying one thing.\n *\n * Deliberately a driver-config field rather than something read off a chat config: `ChatDriver` has no `chatConfig` and is used standalone (see `chat-driver-node`), so threading one in would be a much larger and less reversible change.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",

package/dist/ai-assistant.d.ts

@@ -1492,8 +1492,12 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
     private readonly sessionKey;
     /** Injected activity bus; defaults to a no-op off-browser (Node/tests/headless). */
     private readonly activityBus;
-    /** Transcript copy for a budget wall — see `ChatDriverConfig.budgetExhaustedMessage`. */
-    private readonly budgetExhaustedMessage;
+    /**
+     * Host override for the budget-wall transcript copy, used verbatim — see
+     * `ChatDriverConfig.budgetExhaustedMessage`. `undefined` means no override,
+     * and the bubble is composed per wall by {@link ChatDriver.budgetExhaustedBubble}.
+     */
+    private readonly budgetExhaustedMessageOverride?;
     /**
      * Set the moment a budget wall is observed anywhere in this turn — this
      * driver's own 402, or a sub-agent's (which surfaces here only as a
@@ -1597,6 +1601,7 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
      *
      * @internal
      */
+    private budgetExhaustedBubble;
     reportBudgetExhausted(e: BudgetExhaustedError, pendingUserMessage?: ChatMessage): ChatDriverResult;
     /** The typed failure reason on a loop result, or `undefined` for a clean turn / handoff. */
     private static failureReasonOf;
@@ -1914,8 +1919,13 @@ export declare interface ChatDriverConfig {
      */
     activityBus?: ActivityBus;
     /**
-     * Transcript copy appended when the AI-spend budget wall is hit (GENC-1464).
-     * Defaults to `DEFAULT_BUDGET_EXHAUSTED_MESSAGE`.
+     * Transcript copy appended when the AI-spend budget wall is hit (GENC-1464),
+     * used VERBATIM — set it only to own the copy entirely (white-labelling).
+     * When unset, the driver composes the bubble per wall: the neutral
+     * `DEFAULT_BUDGET_EXHAUSTED_MESSAGE`, upgraded with "switch to another AI
+     * provider" advice only when the 402's `otherVendorAvailable` positively says
+     * another metered vendor still has headroom — the same rule the blocked
+     * banner applies, so the two surfaces can no longer contradict each other.
      *
      * The assistant element already lets a host override the blocked **banner**
      * via `setBlocked(true, reason)`; without this the transcript **bubble** stayed
@@ -2859,24 +2869,26 @@ export declare class FoundationAiAssistant extends GenesisElement {
      */
     get effectiveBlockedReason(): string;
     /**
-     * Copy the driver writes into the TRANSCRIPT when a turn hits the budget wall.
-     *
-     * A host-set `blockedReason` still wins, so a white-labelled host does not read
-     * its own explanation in the banner and the shipped default directly below it —
-     * that is the whole reason the driver takes this at all.
-     *
-     * What it deliberately is NOT is
-     * {@link FoundationAiAssistant.effectiveBlockedReason}. That getter
-     * composes advice — `"…Switch to Gemini to keep going."` — which is true only
-     * while that vendor has headroom, and the transcript is a permanent record. The
-     * driver reads this once at CONSTRUCTION, and `getOrCreateDriver` keys on the
-     * agents list, so an agents swap *after* a wall re-runs `createDriver` and would
-     * freeze that sentence into every later turn's bubble. Reading the latch's own
-     * copy instead is structurally incapable of carrying the advice: the only
-     * writer of `blockedReason` is the vendor-agnostic branch of
-     * `latchBlockedFrom`, whose `formatBlockedReason(budget)` form has no switch
-     * clause. Per-vendor copy lives in `blockedVendorReasons` and reaches the
-     * banner alone.
+     * Copy the driver writes into the TRANSCRIPT when a turn hits the budget wall,
+     * or `undefined` to let the driver compose it per wall.
+     *
+     * A set `blockedReason` still wins — a white-labelled host must not read its
+     * own explanation in the banner and shipped copy directly below it, and the
+     * vendor-agnostic latch's `formatBlockedReason(budget)` form stays advice-free
+     * exactly as before.
+     *
+     * `undefined` (the usual case) is NOT the old `DEFAULT_BUDGET_EXHAUSTED_MESSAGE`
+     * fallback: it hands composition to the driver, which builds the bubble from
+     * EACH wall's own 402 — naming the exhausted vendor and advising a switch only
+     * when that refusal's `otherVendorAvailable` positively vouched for headroom
+     * elsewhere. That is immune to the staleness this getter used to guard against
+     * by freezing the copy: construction-time advice could outlive its truth
+     * (`getOrCreateDriver` re-runs on an agents swap and would have baked the
+     * sentence into every later bubble), but per-wall advice is derived from the
+     * refusal it annotates and dies with the turn. Forcing the default here was
+     * also what made the driver's composed bubble unreachable in every real
+     * mount — the banner advised switching while the bubble under it never did
+     * (the GENC-1464 tester finding, root cause).
      */
     private get transcriptBudgetExhaustedMessage();
     /**

package/dist/chat-driver.cjs

@@ -3573,13 +3573,13 @@ var ChatDriver = class _ChatDriver extends EventTarget {
       maxTurnSnapshots = DEFAULT_MAX_TURN_SNAPSHOTS,
       sessionKey = "",
       activityBus = NOOP_ACTIVITY_BUS,
-      budgetExhaustedMessage = DEFAULT_BUDGET_EXHAUSTED_MESSAGE
+      budgetExhaustedMessage
     } = config;
     this.maxToolIterations = maxToolIterations;
     this.condenseBatchCalls = condenseBatchCalls;
     this.sessionKey = sessionKey;
     this.activityBus = activityBus;
-    this.budgetExhaustedMessage = budgetExhaustedMessage;
+    this.budgetExhaustedMessageOverride = budgetExhaustedMessage;
     if (typeof toolHandlers === "function") {
       this.toolHandlersFactory = toolHandlers;
       this.toolHandlers = {};
@@ -3716,6 +3716,12 @@ var ChatDriver = class _ChatDriver extends EventTarget {
    *
    * @internal
    */
+  budgetExhaustedBubble(wall) {
+    if (this.budgetExhaustedMessageOverride != null) return this.budgetExhaustedMessageOverride;
+    if (wall?.otherVendorAvailable !== true) return DEFAULT_BUDGET_EXHAUSTED_MESSAGE;
+    const subject = wall?.vendorLabel ? `${wall.vendorLabel}'s AI usage limit` : "your AI usage limit";
+    return `You've reached ${subject}. Switch to another AI provider in Settings to keep going, or contact your administrator to raise it.`;
+  }
   reportBudgetExhausted(e, pendingUserMessage) {
     if (pendingUserMessage) this.appendToHistory(pendingUserMessage);
     this.budgetExhaustedThisTurn = true;
@@ -3734,7 +3740,7 @@ var ChatDriver = class _ChatDriver extends EventTarget {
       spentUsd: e.spentUsd,
       isSubAgent: this.isSubAgent
     });
-    this.appendToHistory({ role: "assistant", content: this.budgetExhaustedMessage });
+    this.appendToHistory({ role: "assistant", content: this.budgetExhaustedBubble(e) });
     return this.turnDone("budget-exhausted", budgetDetailOf(e));
   }
   /** The typed failure reason on a loop result, or `undefined` for a clean turn / handoff. */
@@ -4863,7 +4869,10 @@ Output format (strict):
         if (this.isSubAgent) {
           this.failSubAgent("budget_exhausted", this.budgetWallDetail);
         } else {
-          this.appendToHistory({ role: "assistant", content: this.budgetExhaustedMessage });
+          this.appendToHistory({
+            role: "assistant",
+            content: this.budgetExhaustedBubble(this.budgetWallDetail)
+          });
         }
         return this.turnDone("budget-exhausted", this.budgetWallDetail);
       }