@genesislcap/ai-assistant 15.23.3 → 15.24.0-FUI-2603.10

package/dist/ai-assistant.api.json

@@ -6221,7 +6221,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), 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",
+              "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 `TURN_FAILURE_EXITS.budgetExhausted.copy`, 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",
@@ -6388,7 +6388,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriverConfig#providerRefusedMessage:member",
-              "docComment": "/**\n * Overrides the transcript sentence shown when the upstream PROVIDER refuses the account (GENC-1506) — see `DEFAULT_PROVIDER_REFUSED_MESSAGE`.\n *\n * Separate from `budgetExhaustedMessage` because the two conditions are separate: ours is a spend cap a host administrator can raise, this is the vendor declining to serve us at all. A host that white-labels one will usually want to white-label both, but conflating them into one field would force identical copy on two situations with different remedies.\n *\n * Rarely needed: unlike the budget default, the shipped sentence names no vendor and no Genesis, so it is already safe for a white-labelled deployment.\n */\n",
+              "docComment": "/**\n * Overrides the transcript sentence shown when the upstream PROVIDER refuses the account (GENC-1506) — see `TURN_FAILURE_EXITS.providerRefused.copy`.\n *\n * Separate from `budgetExhaustedMessage` because the two conditions are separate: ours is a spend cap a host administrator can raise, this is the vendor declining to serve us at all. A host that white-labels one will usually want to white-label both, but conflating them into one field would force identical copy on two situations with different remedies.\n *\n * Rarely needed: unlike the budget default, the shipped sentence names no vendor and no Genesis, so it is already safe for a white-labelled deployment.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -8175,7 +8175,7 @@
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "appSettingsRevision: "
+                  "text": "get appSettingsRevision(): "
                 },
                 {
                   "kind": "Content",
@@ -8183,7 +8183,7 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ";"
+                  "text": ";\n\nset appSettingsRevision(value: number);"
                 }
               ],
               "isReadonly": false,
@@ -8297,11 +8297,11 @@
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#attachmentErrors:member",
-              "docComment": "",
+              "docComment": "/**\n * Rejection messages for files the last pick refused.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "attachmentErrors: "
+                  "text": "get attachmentErrors(): "
                 },
                 {
                   "kind": "Content",
@@ -8309,7 +8309,7 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ";"
+                  "text": ";\n\nset attachmentErrors(value: string[]);"
                 }
               ],
               "isReadonly": false,
@@ -8327,11 +8327,11 @@
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#attachments:member",
-              "docComment": "",
+              "docComment": "/**\n * Attachments pending on the next message.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "attachments: "
+                  "text": "get attachments(): "
                 },
                 {
                   "kind": "Reference",
@@ -8344,7 +8344,16 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ";"
+                  "text": ";\n\nset attachments(value: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatAttachment",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatAttachment:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]);"
                 }
               ],
               "isReadonly": false,
@@ -8422,7 +8431,7 @@
             {
               "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",
+              "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. Neither costs anything internally — {@link FoundationAiAssistant.blocked} asks only about the reachable set, and the banner reads the reachability-filtered `BudgetController.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",
@@ -8465,7 +8474,7 @@
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "budgetMeterLastFedAt: "
+                  "text": "get budgetMeterLastFedAt(): "
                 },
                 {
                   "kind": "Content",
@@ -8473,7 +8482,7 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ";"
+                  "text": ";\n\nset budgetMeterLastFedAt(value: number | null);"
                 }
               ],
               "isReadonly": false,
@@ -8712,7 +8721,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#compactable:member",
-              "docComment": "/**\n * Whether the menu's \"Compact\" action would do anything (GENC-1351 §5.7, GENC-1567). Delegates to the driver's plan so the gate uses the exact same history `compact()` acts on, judged against the same budget — one source of truth for both whether a cut is legal and whether it reclaims enough.\n */\n",
+              "docComment": "",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -8739,6 +8748,36 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#compactHint:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get compactHint(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "compactHint",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#compacting:member",
@@ -8772,7 +8811,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#compactionPlan:member",
-              "docComment": "/**\n * What compacting right now would reclaim, or `null` when it would not be worth it (GENC-1567). Sized against {@link FoundationAiAssistant.contextBudget}, so the plan aims at this model's window rather than a fixed default.\n *\n * Reads `messages` to stay reactive as the conversation grows: the driver's history is not a tracked observable, so every consumer of this keys its re-evaluation off the Redux mirror.\n */\n",
+              "docComment": "",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -8843,11 +8882,11 @@
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#composerHeightPx:member",
-              "docComment": "/**\n * Explicit composer height (px) once the user has dragged the resize handle; `null` keeps the default auto-grow behaviour. Written into the `--composer-height` custom property via the `composerHeightStyle` getter.\n */\n",
+              "docComment": "/**\n * Explicit composer height once dragged; `null` keeps the default auto-grow.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "composerHeightPx: "
+                  "text": "get composerHeightPx(): "
                 },
                 {
                   "kind": "Content",
@@ -8855,7 +8894,7 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ";"
+                  "text": ";\n\nset composerHeightPx(value: number | null);"
                 }
               ],
               "isReadonly": false,
@@ -8873,7 +8912,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#composerHeightStyle:member",
-              "docComment": "/**\n * Inline style for the chat input: writes the chosen height into the `--composer-height` custom property (read by `.chat-input` + its control in `main.styles.ts`). Empty until the user drags (or when resizing is disabled), so the default applies.\n */\n",
+              "docComment": "/**\n * Inline style carrying the dragged height into `--composer-height`.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -8930,6 +8969,96 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#composerNoticeSrOnly:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get composerNoticeSrOnly(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "composerNoticeSrOnly",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#composerNoticeText:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get composerNoticeText(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "composerNoticeText",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#composerNoticeVisible:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get composerNoticeVisible(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "composerNoticeVisible",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#confirmingClear:member",
@@ -9024,7 +9153,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#contextBudget:member",
-              "docComment": "/**\n * Context-headroom thresholds for the active model (GENC-1567) — the warning and block lines, plus the tail budget compaction aims at.\n *\n * The per-agent `contextReserve` IS folded in, via the driver (GENC-1582). It used to be described here as a separate, later check made when an agent took ownership of a flow — but there is no such check, and by flow entry the send has already been allowed. Resolving it here, before the send, is what makes it a gate rather than a label.\n *\n * Overhead is read off `messages` (the Redux mirror) rather than the driver's own history, which the compaction plan uses. That is safe rather than sloppy: `estimateSystemOverhead` only looks at messages BEFORE the first usage-bearing one, and the two lists agree completely that early — the drift between mirror and driver history is only ever at the tail.\n */\n",
+              "docComment": "/**\n * The context gate's derived surface (GENC-1567). Every member below delegates to `ContextGateController` — the names are this element's public API and the template's bindings, so they stay put while the derivation moves.\n *\n * The per-agent `contextReserve` IS folded in, via the driver (GENC-1582). It used to be described here as a separate, later check made when an agent took ownership of a flow — but there is no such check, and by flow entry the send has already been allowed. Resolving it before the send is what makes it a gate rather than a label.\n *\n * None carries `@volatile`: the decorators live on the controller's getters, and they reach the binding observer from there — see `docs/code-health.md` §11.4.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -9082,6 +9211,66 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#contextGateLabel:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get contextGateLabel(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "contextGateLabel",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#contextGateReason:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get contextGateReason(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "contextGateReason",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#contextLimit:member",
@@ -9145,11 +9334,11 @@
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#costSessionHistory:member",
-              "docComment": "/**\n * Persisted finalized cost sessions shown on the Usage tab build history list.\n */\n",
+              "docComment": "/**\n * Persisted finalized cost sessions shown on the Usage tab build history list.\n *\n * A get/set pair rather than a read-only projection: the banking tests seed rows to model a page load that found some, and a host provider's rows arrive the same way.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "costSessionHistory: "
+                  "text": "get costSessionHistory(): "
                 },
                 {
                   "kind": "Reference",
@@ -9162,7 +9351,16 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ";"
+                  "text": ";\n\nset costSessionHistory(value: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "CostSessionRecord",
+                  "canonicalReference": "@genesislcap/ai-assistant!CostSessionRecord:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]);"
                 }
               ],
               "isReadonly": false,
@@ -9210,7 +9408,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#cumulativeUsage:member",
-              "docComment": "/**\n * Lifetime usage across every project in the history scope — cost and all four token buckets. What the Usage tab's lifetime section renders.\n *\n * Rows ONLY — deliberately not rows + live session. Each row holds a project's lifetime usage and the active project's row is kept current on every transcript change, so adding the live total would count this project's spend twice. That double-count is what made the figure grow on every refresh: a page-hide banked a row while the restored session still carried the same spend.\n */\n",
+              "docComment": "/**\n * Lifetime usage across every project in the history scope — rows only, never plus live.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -9533,7 +9731,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#finalizeCostSession:member(1)",
-              "docComment": "/**\n * Write this session's usage into persisted build history (`localStorage`) as a single row keyed by the session key, replacing any existing row for that key.\n *\n * **Idempotent** — safe to call per turn, on tab close, and on a title change alike. The name is historical: it does NOT end the session or reset the running totals. Resetting them is what used to double-count spend, since the row was banked while the persisted transcript still carried the same usage, so a reload restored it and the Usage tab counted both.\n *\n * No-op unless `chatConfig.costHistory.enabled` is `true`, when the live session has no usage yet, or when the session has no key to upsert against. Gating on the *live* figures (not the banked total) means a reload that restores nothing rewrites nothing.\n */\n",
+              "docComment": "/**\n * Write this session's usage into persisted build history as a single row keyed by the session key, replacing any existing row for that key.\n *\n * **Idempotent** — safe to call per turn, on tab close, and on a title change alike. The name is historical: it does NOT end the session or reset the running totals. See `CostLedgerController.finalize` for the full contract and the no-op cases.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -10138,7 +10336,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#isComposerResizable:member",
-              "docComment": "/**\n * Whether the message input shows a drag handle to resize its height. On by default; hosts opt out via `chatConfig.ui.resizableInput: false`.\n */\n",
+              "docComment": "/**\n * Whether the message input shows a drag handle to resize its height.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -10351,7 +10549,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#liveUsageIsProjectLifetime:member",
-              "docComment": "/**\n * Whether the live session figures amount to this project's whole history, which is true exactly when the transcript is restored on load. Drives the Usage tab's live labels (\"Project cost\" vs \"Session cost\") so they state the scope rather than imply one.\n *\n * Note this is NOT what makes the *rows* lifetime — those bank their pre-transcript spend (see `CostSessionRecord.banked`) and are lifetime either way.\n */\n",
+              "docComment": "/**\n * Whether the live session figures amount to this project's whole history.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -10505,7 +10703,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#onComposerResizeEnd:member(1)",
-              "docComment": "/**\n * End a resize drag and release the pointer capture.\n */\n",
+              "docComment": "",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -10554,7 +10752,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#onComposerResizeMove:member(1)",
-              "docComment": "/**\n * Resize while dragging. Dragging up (clientY decreases) grows the composer; the result is clamped between the natural height (lower) and the available headroom/max (upper). No-op unless a drag is active (the handle holds pointer capture), so plain hover-moves are ignored.\n */\n",
+              "docComment": "",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -10603,7 +10801,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#onComposerResizeStart:member(1)",
-              "docComment": "/**\n * Begin a composer resize drag. Captures the pointer so move/up keep firing on the handle even when the cursor leaves its 7px band.\n */\n",
+              "docComment": "",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -11369,7 +11567,7 @@
             {
               "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",
+              "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 — this element's answer to \"which vendor would the next turn use\", a question that has no correct answer and deliberately gets no API. See `BudgetController.reachableVendors` for why reachability is the answerable question and what deriving from it buys.\n *\n * @beta\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -12432,7 +12630,7 @@
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "settingsAppSlotted: "
+                  "text": "get settingsAppSlotted(): "
                 },
                 {
                   "kind": "Reference",
@@ -12445,7 +12643,16 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ";"
+                  "text": ";\n\nset settingsAppSlotted(value: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "HTMLElement",
+                  "canonicalReference": "!HTMLElement:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]);"
                 }
               ],
               "isReadonly": false,
@@ -12587,7 +12794,7 @@
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "settingsCostCurrentSlotted: "
+                  "text": "get settingsCostCurrentSlotted(): "
                 },
                 {
                   "kind": "Reference",
@@ -12600,7 +12807,16 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ";"
+                  "text": ";\n\nset settingsCostCurrentSlotted(value: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "HTMLElement",
+                  "canonicalReference": "!HTMLElement:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]);"
                 }
               ],
               "isReadonly": false,
@@ -12618,7 +12834,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#settingsCostHistoryHeadingVisible:member",
-              "docComment": "/**\n * Whether the \"Build history\" heading has anything under it.\n *\n * Broader than {@link FoundationAiAssistant.settingsCostHistorySectionVisible} because the heading also covers the lifetime total, which renders before the first row exists (rows are written as spend accrues, the lifetime section only needs history switched on). Gating the heading on the rows alone left that total sitting under nothing.\n */\n",
+              "docComment": "/**\n * Whether the \"Build history\" heading has anything under it — broader than {@link FoundationAiAssistant.settingsCostHistorySectionVisible}, because the heading also covers the lifetime total, which renders before the first row exists.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -12648,7 +12864,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#settingsCostHistorySectionVisible:member",
-              "docComment": "/**\n * Whether the build-history section has anything in it — the built-in row list, or a host's own markup in the `settings-cost-history` slot.\n *\n * Slotted content is checked FIRST, ahead of `enabled`. That flag governs the *built-in* ledger: it gates the row writes, the reload, and the lifetime sum — and it defaults to `false` (`cost?.enabled === true`), while the Usage tab itself shows for `showCost`/`showTokens`, which default true. So a host can legitimately render its own build history into the slot and never opt into our `localStorage` ledger. Short-circuiting on `enabled` above the slot check hid that host's markup outright, since the slot is the only thing in the container.\n */\n",
+              "docComment": "/**\n * Whether the build-history section has anything in it — the built-in row list, or a host's own markup in the `settings-cost-history` slot. See `SettingsModalController.costHistorySectionVisible` for why slotted content is checked ahead of `enabled`.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -12682,7 +12898,7 @@
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "settingsCostHistorySlotted: "
+                  "text": "get settingsCostHistorySlotted(): "
                 },
                 {
                   "kind": "Reference",
@@ -12695,7 +12911,16 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ";"
+                  "text": ";\n\nset settingsCostHistorySlotted(value: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "HTMLElement",
+                  "canonicalReference": "!HTMLElement:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]);"
                 }
               ],
               "isReadonly": false,
@@ -12713,7 +12938,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#settingsCostLifetimeVisible:member",
-              "docComment": "/**\n * Whether the lifetime-usage section has anything to say.\n *\n * Requires build history: with it off there are no rows, so `cumulativeUsage` falls back to the live session and the section would restate the block directly below it under a \"lifetime\" heading it hasn't earned.\n */\n",
+              "docComment": "/**\n * Whether the lifetime-usage section has anything to say. Requires build history AND a resolvable state key — see `SettingsModalController.costLifetimeVisible`.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -12838,7 +13063,7 @@
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "settingsModalTab: "
+                  "text": "get settingsModalTab(): "
                 },
                 {
                   "kind": "Reference",
@@ -12847,7 +13072,16 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ";"
+                  "text": ";\n\nset settingsModalTab(value: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "SettingsModalTab",
+                  "canonicalReference": "@genesislcap/ai-assistant!~SettingsModalTab:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ");"
                 }
               ],
               "isReadonly": false,
@@ -12865,7 +13099,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#settingsModelSectionVisible:member",
-              "docComment": "/**\n * Whether the settings modal AI Model section has slotted app content, context usage or budget figures.\n */\n",
+              "docComment": "/**\n * The settings modal's derived surface. Every member below delegates to `SettingsModalController` — the names are this element's public API and the 943-line template's bindings, so they stay put while the logic moves into the `settings-modal.ts` that folder never had (`docs/code-health.md` §3).\n *\n * None carries `@volatile`: the decorators live on the controller's getters, and they reach the binding observer from there — see `docs/code-health.md` §11.4.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -12895,11 +13129,11 @@
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#settingsModelSlotted:member",
-              "docComment": "/**\n * Light-DOM nodes assigned to settings modal slots (via `slotted()` bindings).\n */\n",
+              "docComment": "/**\n * Light-DOM nodes assigned to settings modal slots. The template's `slotted()` bindings write these by property NAME, so each needs a real setter here even though the controller owns the arrays.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "settingsModelSlotted: "
+                  "text": "get settingsModelSlotted(): "
                 },
                 {
                   "kind": "Reference",
@@ -12912,7 +13146,16 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ";"
+                  "text": ";\n\nset settingsModelSlotted(value: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "HTMLElement",
+                  "canonicalReference": "!HTMLElement:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]);"
                 }
               ],
               "isReadonly": false,
@@ -12934,7 +13177,7 @@
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "settingsOpen: "
+                  "text": "get settingsOpen(): "
                 },
                 {
                   "kind": "Content",
@@ -12942,7 +13185,7 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ";"
+                  "text": ";\n\nset settingsOpen(value: boolean);"
                 }
               ],
               "isReadonly": false,
@@ -13021,7 +13264,7 @@
             {
               "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",
+              "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 `BudgetController.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, and a wall on it could never be undone by derivation. Use {@link FoundationAiAssistant.setBlocked} for a vendor-agnostic block.\n *\n * @beta\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -13566,7 +13809,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#sortedCostSessionHistory:member",
-              "docComment": "/**\n * Build history for display: most recently worked on first.\n *\n * The stored order is insertion order (see `upsertRecord`), which leaves a project returned to sitting wherever it was first seen — so ordering is applied here, on read, where it also covers rows a host provider supplied.\n */\n",
+              "docComment": "/**\n * Build history for display: most recently worked on first.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -13846,7 +14089,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#toggleAgentPicker:member(1)",
-              "docComment": "",
+              "docComment": "/**\n * Document-level dismissal for whichever composer menu is open. Bound only while one IS open — a permanently-attached listener on a component that can be mounted twice (bubble + popout panel) is a cost every click on the page pays for a menu that is usually closed.\n *\n * Uses `composedPath()` rather than `event.target`: the click lands on a node inside this element's shadow root, which retargets to the host, so a plain `contains()` check cannot tell \"clicked the menu\" from \"clicked the transcript\". The path crosses the boundary and carries both.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -14094,7 +14337,7 @@
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#uniqueProviderModels:member",
-              "docComment": "/**\n * Distinct models the registry currently resolves to — the live session's model chips.\n *\n * `providerStatuses` carries one entry per registry SLOT, so a vendor configured across several tiers that happen to resolve to the same model reports it once per tier, and the chips rendered it once per tier too. Which tier a model came from is not what these chips are for.\n *\n * Deduped on the label actually displayed, not on `status.model`: a slot whose provider reports no model falls back to the slot's own name, and those are distinct per slot, so keying on the label keeps them from collapsing into one another.\n */\n",
+              "docComment": "/**\n * The cost ledger's derived surface (GENC-1475). Every member below delegates to `CostLedgerController` — the names are this element's public API and the settings modal's bindings, so they stay put while the accounting moves.\n *\n * None carries `@volatile`: the decorators live on the controller's getters, and they reach the binding observer from there — see `docs/code-health.md` §11.4.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -18559,6 +18802,132 @@
           ],
           "extendsTokenRanges": []
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/ai-assistant!SettingsContextUsage:interface",
+          "docComment": "/**\n * The settings-modal context-window indicator, pre-formatted — the context sibling of {@link SettingsBudgetRow}, and pre-formatted for the same reason: the template stays a pure binding layer, and a test can pin the exact text.\n *\n * `undefined` when there is nothing measurable to show, which is what keeps the template free of non-null assertions. It used to read `x.contextTokens!.toLocaleString()`, and the assertion was not merely untidy: those bindings sit inside a `when(...)` block and re-evaluate in the SAME notify batch as the guard that unmounts them, so a session Clear with the modal open on the Usage tab threw two `TypeError`s per render. A shape that can be absent cannot have that bug.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface SettingsContextUsage "
+            }
+          ],
+          "fileUrlPath": "src/main/main.types.ts",
+          "releaseTag": "Beta",
+          "name": "SettingsContextUsage",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SettingsContextUsage#barValue:member",
+              "docComment": "/**\n * The bar's value, clamped to `0..100` — only the bar clamps.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "barValue: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "barValue",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SettingsContextUsage#limit:member",
+              "docComment": "/**\n * The model's context window, e.g. `200,000`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "limit: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "limit",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SettingsContextUsage#percent:member",
+              "docComment": "/**\n * Whole-number percent consumed. Unclamped, like the budget row's text.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "percent: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "percent",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SettingsContextUsage#used:member",
+              "docComment": "/**\n * Prompt tokens on the last call, e.g. `12,480`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "used: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "used",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "Variable",
           "canonicalReference": "@genesislcap/ai-assistant!sparkleIconSvg:var",