@genesislcap/ai-assistant 15.3.3-alpha-4899ddd.0 → 15.3.4

package/dist/ai-assistant.api.json

@@ -993,7 +993,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@genesislcap/ai-assistant!AgenticActivityEvents#\"tool-loop-end\":member",
-              "docComment": "/**\n * Fired when the tool loop completes for the current turn and control returns to the user on the **main chat prompt** (i.e. the next free-form user message can now be accepted).\n *\n * Boundary: this is the moment the user regains control of the main chat input. It is **not** fired when a tool handler hands a widget to the user mid-loop (e.g. while a planning widget is awaiting a click) — widget pauses are still inside the loop, the assistant still owns the turn, and the main chat input may be hidden during them. Wait for this event when you need to know that the assistant is fully idle and the user can type freely again.\n *\n * Emitted from the finally block of each `ChatDriver`'s `sendMessage` and `continueFromHistory`, so a multi-agent handoff fires this event once per agent.\n *\n * Distinct from {@link AgenticActivityEvents.'halo-stop'} — the halo event tracks the spinner animation lifecycle (which can flap mid-turn as tool calls resolve), whereas this event is a one-shot per turn boundary. Use this for hooks tied to a turn ending (telemetry flushes, post-turn workspace transitions, deferred state recomputation).\n *\n * The detail carries the turn's outcome (PTC-0): on a failure it is `{ failureReason }` with the typed `TurnFailureReason`; on a clean completion, a user cancel, a driver dispose, and an agent handoff the detail is `undefined` — the historical shape, kept byte-identical so subscribers that only care about the boundary can keep ignoring it. Structured-cloneable so it survives the cross-tab BroadcastChannel hop.\n *\n * A `'budget-exhausted'` failure additionally carries `vendor` — the concrete vendor the walled turn resolved to (GENC-1464), which is NOT the same thing as the registry alias recorded on the debug-log entry. Optional and additive: a subscriber reading only `failureReason` is unaffected, and every other failure still emits the historical `{ failureReason }` with no `vendor` key. It exists so a later per-vendor budget model is an additive change rather than a retrofit — the vendor is known at the transport and at the driver, and was previously discarded between them.\n *\n * Note this topic is forwarded on the tab-scoped channel, so a wall hit in a popped-out window reaches the main window's subscribers too — which is why the assistant's blocked latch fires there as well. Correct for a shared spend cap; see `docs/migration-GENC-1464.md` §Scope.\n */\n",
+              "docComment": "/**\n * Fired when the tool loop completes for the current turn and control returns to the user on the **main chat prompt** (i.e. the next free-form user message can now be accepted).\n *\n * Boundary: this is the moment the user regains control of the main chat input. It is **not** fired when a tool handler hands a widget to the user mid-loop (e.g. while a planning widget is awaiting a click) — widget pauses are still inside the loop, the assistant still owns the turn, and the main chat input may be hidden during them. Wait for this event when you need to know that the assistant is fully idle and the user can type freely again.\n *\n * Emitted from the finally block of each `ChatDriver`'s `sendMessage` and `continueFromHistory`, so a multi-agent handoff fires this event once per agent.\n *\n * Distinct from {@link AgenticActivityEvents.'halo-stop'} — the halo event tracks the spinner animation lifecycle (which can flap mid-turn as tool calls resolve), whereas this event is a one-shot per turn boundary. Use this for hooks tied to a turn ending (telemetry flushes, post-turn workspace transitions, deferred state recomputation).\n *\n * The detail carries the turn's outcome (PTC-0): on a failure it is `{ failureReason }` with the typed `TurnFailureReason`; on a clean completion, a user cancel, a driver dispose, and an agent handoff the detail is `undefined` — the historical shape, kept byte-identical so subscribers that only care about the boundary can keep ignoring it. Structured-cloneable so it survives the cross-tab BroadcastChannel hop.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -1010,25 +1010,7 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ";\n        vendor?: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "AIProviderType",
-                  "canonicalReference": "@genesislcap/foundation-ai!AIProviderType:type"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";\n        budget?: {\n            budgetUsd?: number;\n            spentUsd?: number;\n            vendorLabel: string;\n            vendor?: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "AIProviderType",
-                  "canonicalReference": "@genesislcap/foundation-ai!AIProviderType:type"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";\n            otherVendorAvailable?: boolean;\n        };\n    } | undefined"
+                  "text": ";\n    } | undefined"
                 },
                 {
                   "kind": "Content",
@@ -1041,7 +1023,7 @@
               "name": "\"tool-loop-end\"",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 8
+                "endIndex": 4
               }
             },
             {
@@ -4857,15 +4839,6 @@
                   "text": "SubAgentFailureReason",
                   "canonicalReference": "@genesislcap/foundation-ai!SubAgentFailureReason:type"
                 },
-                {
-                  "kind": "Content",
-                  "text": ";\n        budget?: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "BudgetDetail",
-                  "canonicalReference": "@genesislcap/ai-assistant!~BudgetDetail:type"
-                },
                 {
                   "kind": "Content",
                   "text": ";\n    } | undefined"
@@ -4878,7 +4851,7 @@
               "isStatic": false,
               "returnTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 6
+                "endIndex": 4
               },
               "releaseTag": "Beta",
               "isProtected": false,
@@ -5592,33 +5565,6 @@
                 "endIndex": 2
               }
             },
-            {
-              "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",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "budgetExhaustedMessage?: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": true,
-              "releaseTag": "Beta",
-              "name": "budgetExhaustedMessage",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              }
-            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriverConfig#maxFoldOperations:member",
@@ -7429,105 +7375,6 @@
               "isProtected": false,
               "isAbstract": false
             },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#blocked:member",
-              "docComment": "/**\n * Whether the assistant is blocked by a backend condition and cannot send — today, an exhausted AI-spend budget (GENC-1464). While true the composer is disabled, `send`/`submitMessage` refuse, suggestions stop being fetched, and a persistent banner (`part=\"blocked-banner\"`) sits above the composer explaining why. The transcript stays visible and scrollable throughout — unlike `compacting` and `restoring`, this does not replace the conversation.\n *\n * **Latched.** Nothing in the element clears it: not a new turn, not \"Clear\" / \"New chat\", not a pop-in/out. It stays set until the host writes `false` — because nothing the user can do inside the assistant refills a budget. Hosts typically set it from their own pre-flight budget check on mount, and clear it once a later check shows headroom again.\n *\n * The driver also latches it automatically when a turn ends with the `'budget-exhausted'` failure reason — off the `tool-loop-end` activity bus (which also covers a sub-agent wall, a turn this element did not start, and an element swapped in mid-turn) and off the driver's return value (which covers a wall hit during multi-agent classification, where no tool loop ran and so no bus event fires). So a host that does no pre-flight at all still gets a correct locked UI the moment the first 402 lands. The bus topic is tab-scoped, so a wall hit in a popped-out window latches the main window too — correct for a shared spend cap.\n *\n * **Lifetime — read this before relying on it as your source of truth.** The latch is in-memory and per-`stateKey`:\n *\n * - It does **not** survive `switchSession`. Switching away tears the outgoing session's store down entirely, so switching back yields a fresh, unblocked store. - It does **not** survive a page reload. It is deliberately absent from the persisted session snapshot: the snapshot is long-lived, so a persisted latch would outlive an out-of-band budget raise with no in-element way to clear it — a stale lock is worse than re-deriving the state.\n *\n * The durable source of truth is therefore the **host's pre-flight**, which should run on mount and on every session switch. See `docs/migration-GENC-1464.md` §\"How to adopt\", Option B.\n *\n * @beta\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "get blocked(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "boolean"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";\n\nset blocked(value: boolean);"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "blocked",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#blockedReason:member",
-              "docComment": "/**\n * Explanation shown in the blocked banner, or `null` for the element's default copy. Only meaningful while {@link FoundationAiAssistant.blocked} is true; setting `blocked = false` clears it.\n *\n * Writable, and symmetric with every other store-backed accessor on this class: writing it re-latches with the CURRENT `blocked` value, so it changes the copy without disturbing the flag. Assigning `null` clears the explanation while staying blocked (the banner falls back to the default copy). {@link FoundationAiAssistant.setBlocked} remains the way to write both in one atomic action.\n *\n * @beta\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "get blockedReason(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string | null"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";\n\nset blockedReason(value: string | null);"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "blockedReason",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#blockedVendors:member",
-              "docComment": "/**\n * Vendors currently walled by the AI-spend budget, in the order they were walled. Empty for a host that never adopts the per-vendor API.\n *\n * May include a vendor this registry cannot reach — either because the registry moved on after the wall was latched, or because a 402's `otherVendorAvailable: false` walls every vendor the proxy meters (which is what that verdict is a statement about; see {@link FoundationAiAssistant.latchBlockedFrom}). Neither costs anything internally — {@link FoundationAiAssistant.blocked} asks only about the reachable set, and the banner reads the reachability-filtered {@link FoundationAiAssistant.relevantBlockedVendors} — but a host rendering this list itself should filter it against its own registry.\n *\n * Read-only on purpose: a settable array would let a host write a partial list and silently orphan the per-vendor banner copy. {@link FoundationAiAssistant.setVendorBlocked} is the write path.\n *\n * @beta\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "get blockedVendors(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "readonly "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "AIProviderType",
-                  "canonicalReference": "@genesislcap/foundation-ai!AIProviderType:type"
-                },
-                {
-                  "kind": "Content",
-                  "text": "[]"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": true,
-              "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "blockedVendors",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 4
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#busy:member",
@@ -9059,55 +8906,6 @@
               "isProtected": false,
               "isAbstract": false
             },
-            {
-              "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#isVendorBlocked:member(1)",
-              "docComment": "/**\n * Whether this specific vendor's budget is walled — regardless of whether any other vendor still has headroom.\n *\n * @beta\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "isVendorBlocked(vendor: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "AIProviderType",
-                  "canonicalReference": "@genesislcap/foundation-ai!AIProviderType:type"
-                },
-                {
-                  "kind": "Content",
-                  "text": "): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "boolean"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 3,
-                "endIndex": 4
-              },
-              "releaseTag": "Beta",
-              "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": [
-                {
-                  "parameterName": "vendor",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 1,
-                    "endIndex": 2
-                  },
-                  "isOptional": false
-                }
-              ],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "isVendorBlocked"
-            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#liveCostSessionTitle:member",
@@ -10015,45 +9813,6 @@
               "isProtected": false,
               "isAbstract": false
             },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#reachableVendors:member",
-              "docComment": "/**\n * The distinct vendors the registry can currently reach, from the provider statuses this element already loads on connect and refreshes on every observable-registry change.\n *\n * This is the element's answer to \"which vendor would the next turn use\" — a question that has **no** correct answer and deliberately gets no API. The provider is resolved per turn AND per agent: `activeProviderInput` may be an async function of the turn's context, an orchestrated turn picks its agent with an LLM `classify()` call, and sub-agents resolve their own providers. Any pre-turn \"peek\" would therefore be a guess that is wrong precisely on the multi-agent hosts per-vendor budgets exist for.\n *\n * Asking instead which vendors are REACHABLE is answerable, synchronous, and free — and it is enough: the composer must stay live while any reachable vendor has headroom, and must lock when none does. It also makes vendor-switch recovery a derivation rather than a mutation: a host that swaps its registry to another vendor fires the observable, the statuses reload, the walled vendor drops out of this set, and `blocked` goes false with every latch left intact.\n *\n * @beta\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "get reachableVendors(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "readonly "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "AIProviderType",
-                  "canonicalReference": "@genesislcap/foundation-ai!AIProviderType:type"
-                },
-                {
-                  "kind": "Content",
-                  "text": "[]"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": true,
-              "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "reachableVendors",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 4
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#removeAttachment:member(1)",
@@ -10602,70 +10361,6 @@
               "isAbstract": false,
               "name": "setAppSettingValue"
             },
-            {
-              "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#setBlocked:member(1)",
-              "docComment": "/**\n * Block or unblock the assistant, optionally with custom banner copy. Equivalent to the {@link FoundationAiAssistant.blocked} setter, plus the reason in one atomic write.\n *\n * Blocking writes the **vendor-agnostic** block — what a host with one budget pot means — and does not populate {@link FoundationAiAssistant.blockedVendors}. Unblocking clears the per-vendor walls as well, so a host asserting \"the wall is gone\" after its own pre-flight cannot be silently overruled by a driver latch it never saw.\n *\n * @beta\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "setBlocked(blocked: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "boolean"
-                },
-                {
-                  "kind": "Content",
-                  "text": ", reason?: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string | null"
-                },
-                {
-                  "kind": "Content",
-                  "text": "): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "void"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 5,
-                "endIndex": 6
-              },
-              "releaseTag": "Beta",
-              "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": [
-                {
-                  "parameterName": "blocked",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 1,
-                    "endIndex": 2
-                  },
-                  "isOptional": false
-                },
-                {
-                  "parameterName": "reason",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 3,
-                    "endIndex": 4
-                  },
-                  "isOptional": true
-                }
-              ],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "setBlocked"
-            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#setEnabledAnimations:member(1)",
@@ -11349,87 +11044,6 @@
               "isProtected": false,
               "isAbstract": false
             },
-            {
-              "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#setVendorBlocked:member(1)",
-              "docComment": "/**\n * Wall (or release) one vendor's budget, optionally with banner copy for it. The per-vendor mirror of {@link FoundationAiAssistant.setBlocked}.\n *\n * Walling a vendor does **not** on its own disable the composer: while another reachable vendor has headroom the assistant stays usable and the banner tells the user to switch. Only when every reachable vendor is walled does `blocked` become true.\n *\n * `reason` is composed into the banner sentence for that vendor, **however many vendors are walled** — see {@link FoundationAiAssistant.effectiveBlockedReason}. It is per-vendor copy, not a whole-banner override; {@link FoundationAiAssistant.blockedReason} is the override. Omitting it keeps whatever explanation that vendor already carried, so a driver latch landing after a host one cannot blank it.\n *\n * `'none'` is rejected with a warning rather than accepted: it is the \"no provider configured\" sentinel, not a vendor. Latching it would put the raw sentinel in the banner (\"none's AI usage limit is reached\") and could never be undone by derivation, because `'none'` never appears in {@link FoundationAiAssistant.reachableVendors} — so `blocked` could never become derivable from it either. Use {@link FoundationAiAssistant.setBlocked} for a vendor-agnostic block.\n *\n * @beta\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "setVendorBlocked(vendor: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "AIProviderType",
-                  "canonicalReference": "@genesislcap/foundation-ai!AIProviderType:type"
-                },
-                {
-                  "kind": "Content",
-                  "text": ", blocked: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "boolean"
-                },
-                {
-                  "kind": "Content",
-                  "text": ", reason?: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string | null"
-                },
-                {
-                  "kind": "Content",
-                  "text": "): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "void"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 7,
-                "endIndex": 8
-              },
-              "releaseTag": "Beta",
-              "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": [
-                {
-                  "parameterName": "vendor",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 1,
-                    "endIndex": 2
-                  },
-                  "isOptional": false
-                },
-                {
-                  "parameterName": "blocked",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 3,
-                    "endIndex": 4
-                  },
-                  "isOptional": false
-                },
-                {
-                  "parameterName": "reason",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 5,
-                    "endIndex": 6
-                  },
-                  "isOptional": true
-                }
-              ],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "setVendorBlocked"
-            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#showAgentSwitchIndicator:member",
@@ -13410,7 +13024,7 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ";\n        budgetExhaustedMessage?: string;\n    }"
+                  "text": ";\n    }"
                 },
                 {
                   "kind": "Content",