@genesislcap/ai-assistant 15.27.0-agent-log-submit.3 → 15.27.1

package/dist/ai-assistant.api.json

@@ -3338,11 +3338,11 @@
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/ai-assistant!AiDriver#getActiveAgent:member(1)",
-              "docComment": "/**\n * The live `AgentConfig` currently active in the driver — the instance whose `onActivate` ran, so its `serialize`/`getDebugSnapshot` closures hold live state. Prefer this over looking the agent up in the host's `agents` array, which may mint fresh, never-activated configs.\n *\n * `undefined` means no agent is active (before the first activation, after a release), which is a different statement from the driver not being able to answer. Both drivers implement it since GENC-1580; see {@link AiDriver.primeRestoredAgentState} for why the `?` stays for now.\n */\n",
+              "docComment": "/**\n * The live `AgentConfig` currently active in the driver — the instance whose `onActivate` ran, so its `serialize`/`getDebugSnapshot` closures hold live state. Prefer this over looking the agent up in the host's `agents` array, which may mint fresh, never-activated configs.\n *\n * `undefined` means no agent is active (before the first activation, after a release), which is a different statement from the driver not being able to answer — and since GENC-1580's breaking release the second case cannot arise, because the method is required.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "getActiveAgent?(): "
+                  "text": "getActiveAgent(): "
                 },
                 {
                   "kind": "Reference",
@@ -3358,7 +3358,7 @@
                   "text": ";"
                 }
               ],
-              "isOptional": true,
+              "isOptional": false,
               "returnTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 3
@@ -3901,11 +3901,11 @@
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/ai-assistant!AiDriver#primeRestoredAgentState:member(1)",
-              "docComment": "/**\n * Prime per-agent restored state for a session being rehydrated. Each entry (keyed by agent name) is handed to that agent's `onActivate`/`init` as `ctx.restored` on its next activation, then consumed.\n *\n * Implemented by every driver since GENC-1580 — each owns an `AgentSession` — so \"only multi-agent drivers implement it\" is no longer true. Still declared optional: this interface is exported and `@beta`, so requiring it would break any third party implementing it. The `?` comes off with the `installAgent` rename, which is the ticket's one breaking release.\n */\n",
+              "docComment": "/**\n * Prime per-agent restored state for a session being rehydrated. Each entry (keyed by agent name) is handed to that agent's `onActivate`/`init` as `ctx.restored` on its next activation, then consumed.\n *\n * Required since GENC-1580's breaking release: every driver owns an `AgentSession`, so both shipped drivers implement it and a host no longer has to feature-detect before restoring.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "primeRestoredAgentState?(snapshots: "
+                  "text": "primeRestoredAgentState(snapshots: "
                 },
                 {
                   "kind": "Reference",
@@ -3929,7 +3929,7 @@
                   "text": ";"
                 }
               ],
-              "isOptional": true,
+              "isOptional": false,
               "returnTypeTokenRange": {
                 "startIndex": 4,
                 "endIndex": 5
@@ -4199,11 +4199,11 @@
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/ai-assistant!AiDriver#setFlowOwner:member(1)",
-              "docComment": "/**\n * Set the transient flow lock — used to restore state on driver reconstruction (agents-array changes, pop-in/pop-out), **not** to steer routing; that is {@link AiDriver.setPinnedAgent}'s job. Writes without firing lifecycle hooks, because the flow it names is already running.\n *\n * Added to the interface in GENC-1580, as for {@link AiDriver.setPinnedAgent}.\n */\n",
+              "docComment": "/**\n * Set the transient flow lock — used to restore state on driver reconstruction (agents-array changes, pop-in/pop-out), **not** to steer routing; that is {@link AiDriver.setPinnedAgent}'s job. Writes without firing lifecycle hooks, because the flow it names is already running.\n *\n * Added to the interface in GENC-1580, as for {@link AiDriver.setPinnedAgent}, and required since that ticket's breaking release.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "setFlowOwner?(name: "
+                  "text": "setFlowOwner(name: "
                 },
                 {
                   "kind": "Content",
@@ -4222,7 +4222,7 @@
                   "text": ";"
                 }
               ],
-              "isOptional": true,
+              "isOptional": false,
               "returnTypeTokenRange": {
                 "startIndex": 3,
                 "endIndex": 4
@@ -4244,11 +4244,11 @@
             {
               "kind": "MethodSignature",
               "canonicalReference": "@genesislcap/ai-assistant!AiDriver#setPinnedAgent:member(1)",
-              "docComment": "/**\n * Pin routing to an agent by name, or `null` for automatic routing. A pin is sticky: it survives a stateful flow completing, so the next turn starts fresh on the same agent.\n *\n * On a driver with nothing to route between this is recorded rather than acted on — the pick belongs to the session, which outlives the question of which driver holds it.\n *\n * Added to the interface in GENC-1580 — it was previously reached by narrowing to `OrchestratingDriver` with `instanceof`. Optional, so adding it breaks no implementor.\n */\n",
+              "docComment": "/**\n * Pin routing to an agent by name, or `null` for automatic routing. A pin is sticky: it survives a stateful flow completing, so the next turn starts fresh on the same agent.\n *\n * On a driver with nothing to route between this is recorded rather than acted on — the pick belongs to the session, which outlives the question of which driver holds it.\n *\n * Added to the interface in GENC-1580 — it was previously reached by narrowing to `OrchestratingDriver` with `instanceof`. Required since that ticket's breaking release.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "setPinnedAgent?(name: "
+                  "text": "setPinnedAgent(name: "
                 },
                 {
                   "kind": "Content",
@@ -4267,7 +4267,7 @@
                   "text": ";"
                 }
               ],
-              "isOptional": true,
+              "isOptional": false,
               "returnTypeTokenRange": {
                 "startIndex": 3,
                 "endIndex": 4
@@ -5318,7 +5318,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#activateAgent:member(1)",
-              "docComment": "/**\n * Make `config` the active agent, firing its lifecycle hooks — `onDeactivate` on the outgoing agent, then `onActivate` on this one — before installing it.\n *\n * This is the entry point a host should use. {@link ChatDriver.applyAgent} installs a config *without* firing hooks, which is right for the two callers that need it (the orchestrator, which fires them through the shared session, and `invokeSubAgent`, where a child's config is not an activation) and wrong for everyone else.\n *\n * @beta\n */\n",
+              "docComment": "/**\n * Make `config` the active agent, firing its lifecycle hooks — `onDeactivate` on the outgoing agent, then `onActivate` on this one — before installing it.\n *\n * This is the entry point a host should use. {@link ChatDriver.installAgent} installs a config *without* firing hooks, which is right for the two callers that need it (the orchestrator, which fires them through the shared session, and `invokeSubAgent`, where a child's config is not an activation) and wrong for everyone else.\n *\n * @beta\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -5369,55 +5369,6 @@
               "isAbstract": false,
               "name": "activateAgent"
             },
-            {
-              "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#applyAgent:member(1)",
-              "docComment": "/**\n * Install `config` as the active agent **without firing lifecycle hooks**.\n *\n * Prefer {@link ChatDriver.activateAgent} unless you are deliberately skipping the hooks. Two callers are: `OrchestratingDriver`, which fires them through the shared {@link ChatDriver.agentSession} and then installs a decorated config, and `invokeSubAgent`, where the child driver's config is a tool surface rather than an activation.\n *\n * Renamed to `installAgent` in a follow-up (GENC-1580) — see `docs/migration-GENC-1580.md`. Until then the name says less than it should, so do not add a third caller to this path without checking which of the two above it resembles.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "applyAgent(config: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "AgentConfig",
-                  "canonicalReference": "@genesislcap/ai-assistant!AgentConfig:type"
-                },
-                {
-                  "kind": "Content",
-                  "text": "): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "void"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 3,
-                "endIndex": 4
-              },
-              "releaseTag": "Public",
-              "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": [
-                {
-                  "parameterName": "config",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 1,
-                    "endIndex": 2
-                  },
-                  "isOptional": false
-                }
-              ],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "applyAgent"
-            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#cancel:member(1)",
@@ -5667,7 +5618,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#getActiveAgent:member(1)",
-              "docComment": "/**\n * The live `AgentConfig` currently active in the driver — the instance whose `onActivate` ran, so its `serialize`/`getDebugSnapshot` closures hold live state. Prefer this over looking the agent up in the host's `agents` array, which may mint fresh, never-activated configs.\n *\n * `undefined` means no agent is active (before the first activation, after a release), which is a different statement from the driver not being able to answer. Both drivers implement it since GENC-1580; see {@link AiDriver.primeRestoredAgentState} for why the `?` stays for now.\n *\n * @beta\n */\n",
+              "docComment": "/**\n * The live `AgentConfig` currently active in the driver — the instance whose `onActivate` ran, so its `serialize`/`getDebugSnapshot` closures hold live state. Prefer this over looking the agent up in the host's `agents` array, which may mint fresh, never-activated configs.\n *\n * `undefined` means no agent is active (before the first activation, after a release), which is a different statement from the driver not being able to answer — and since GENC-1580's breaking release the second case cannot arise, because the method is required.\n *\n * @beta\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -6342,6 +6293,55 @@
               "isAbstract": false,
               "name": "getTurnSnapshots"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#installAgent:member(1)",
+              "docComment": "/**\n * Install `config` as the active agent **without firing lifecycle hooks**.\n *\n * Prefer {@link ChatDriver.activateAgent} unless you are deliberately skipping the hooks. Two callers are: `OrchestratingDriver`, which fires them through the shared {@link ChatDriver.agentSession} and then installs a decorated config, and `invokeSubAgent`, where the child driver's config is a tool surface rather than an activation.\n *\n * Do not add a third caller to this path without checking which of the two above it resembles — whether the hooks should fire is the whole difference between this and `activateAgent`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "installAgent(config: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AgentConfig",
+                  "canonicalReference": "@genesislcap/ai-assistant!AgentConfig:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "config",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "installAgent"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#isBusy:member(1)",
@@ -6460,7 +6460,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#primeRestoredAgentState:member(1)",
-              "docComment": "/**\n * Prime per-agent restored state for a session being rehydrated. Each entry (keyed by agent name) is handed to that agent's `onActivate`/`init` as `ctx.restored` on its next activation, then consumed.\n *\n * Implemented by every driver since GENC-1580 — each owns an `AgentSession` — so \"only multi-agent drivers implement it\" is no longer true. Still declared optional: this interface is exported and `@beta`, so requiring it would break any third party implementing it. The `?` comes off with the `installAgent` rename, which is the ticket's one breaking release.\n */\n",
+              "docComment": "/**\n * Prime per-agent restored state for a session being rehydrated. Each entry (keyed by agent name) is handed to that agent's `onActivate`/`init` as `ctx.restored` on its next activation, then consumed.\n *\n * Required since GENC-1580's breaking release: every driver owns an `AgentSession`, so both shipped drivers implement it and a host no longer has to feature-detect before restoring.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -7179,7 +7179,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@genesislcap/ai-assistant!ChatDriverConfig:interface",
-          "docComment": "/**\n * Construction-time configuration for {@link ChatDriver}. Everything except the provider registry is optional — most fields are also settable per-agent via `applyAgent`, so a bare `new ChatDriver(registry)` is valid. Mirrors the `(registry, options)` shape of `OrchestratingDriver`.\n *\n * @beta\n */\n",
+          "docComment": "/**\n * Construction-time configuration for {@link ChatDriver}. Everything except the provider registry is optional — most fields are also settable per-agent via `installAgent`, so a bare `new ChatDriver(registry)` is valid. Mirrors the `(registry, options)` shape of `OrchestratingDriver`.\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -9555,37 +9555,6 @@
               "isProtected": false,
               "isAbstract": false
             },
-            {
-              "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#cancelDebugLogCompose:member(1)",
-              "docComment": "/**\n * Close the compose box and discard the typed note.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "cancelDebugLogCompose(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "void"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "releaseTag": "Beta",
-              "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": [],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "cancelDebugLogCompose"
-            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#chatConfig:member",
@@ -10452,467 +10421,10 @@
                   "text": ";"
                 }
               ],
-              "isReadonly": true,
-              "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "cumulativeCostUsd",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#cumulativeUsage:member",
-              "docComment": "/**\n * Lifetime usage across every project in the history scope — rows only, never plus live.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "get cumulativeUsage(): "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "AggregateUsage",
-                  "canonicalReference": "@genesislcap/foundation-ai!AggregateUsage:interface"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": true,
-              "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "cumulativeUsage",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogComposeHint:member",
-              "docComment": "/**\n * The compose box's footer hint: a failure first, then the \"required\" nudge, else the live counter. Visual only — the same information reaches assistive technology via `debugLogNoteAriaLabel` (counter, required) and `debugLogSubmitAnnouncement` (outcome), because IDREF attributes such as `aria-describedby` cannot point across the design-system text-area's shadow boundary.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "get debugLogComposeHint(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": true,
-              "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "debugLogComposeHint",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogComposeOpen:member",
-              "docComment": "/**\n * Whether the agent-log compose box (note + Send/Cancel) is open. Opened by the row's Send button when `debugLogSubmit.note` is not `false`; closed by Cancel or a successful send. Stays open after a failure so the typed note is not lost.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "debugLogComposeOpen: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "boolean"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "debugLogComposeOpen",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogNote:member",
-              "docComment": "/**\n * The note typed in the compose box, raw (trimmed only at submit time).\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "debugLogNote: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "debugLogNote",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogNoteAriaLabel:member",
-              "docComment": "/**\n * Accessible name for the note. Deliberately STATIC apart from \"(required)\": a name that changed per keystroke would be re-read in full by NVDA on every key and never updated by JAWS. The running count reaches AT through `debugLogSubmitAnnouncement` at the thresholds where it matters.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "get debugLogNoteAriaLabel(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": true,
-              "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "debugLogNoteAriaLabel",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogNoteConfig:member",
-              "docComment": "/**\n * The resolved compose-box settings for the agent-log Send button, or `null` when the host opted out (`debugLogSubmit.note: false`) and the button sends on first click.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "get debugLogNoteConfig(): "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "ResolvedDebugLogNoteConfig",
-                  "canonicalReference": "@genesislcap/ai-assistant!ResolvedDebugLogNoteConfig:interface"
-                },
-                {
-                  "kind": "Content",
-                  "text": " | null"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": true,
-              "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "debugLogNoteConfig",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 3
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogNoteCounter:member",
-              "docComment": "/**\n * Live \"typed / max\" counter for the compose box.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "get debugLogNoteCounter(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": true,
-              "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "debugLogNoteCounter",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogNoteEl:member",
-              "docComment": "/**\n * Bound to the compose box's text-area via the template ref, for focus on open.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "debugLogNoteEl?: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "HTMLElement",
-                  "canonicalReference": "!HTMLElement:interface"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": true,
-              "releaseTag": "Beta",
-              "name": "debugLogNoteEl",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogNoteMissing:member",
-              "docComment": "/**\n * Whether the typed note counts as empty — the ONE emptiness rule, shared by the compose box's disabled state and its \"required\" hint so the two cannot drift apart.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "get debugLogNoteMissing(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "boolean"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": true,
-              "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "debugLogNoteMissing",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogRowDescription:member",
-              "docComment": "/**\n * The agent-log row's description, phrased for whichever actions the host enabled. Send is called out as transmitting: Download keeps the log on the user's machine, Send hands the full conversation to wherever the host's transport delivers it.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "get debugLogRowDescription(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": true,
-              "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "debugLogRowDescription",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogSendDisabled:member",
-              "docComment": "/**\n * Whether the compose box's Send button is inert: a send is already in flight, or the host made the note required and it is still blank.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "get debugLogSendDisabled(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "boolean"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": true,
-              "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "debugLogSendDisabled",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogSubmitAnnouncement:member",
-              "docComment": "/**\n * Text for the always-present live region beside the agent-log row, so the outcome of a submission is announced even when the compose box is closed or opted out (`note: false`), where the only visible change is the button label.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "get debugLogSubmitAnnouncement(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": true,
-              "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "debugLogSubmitAnnouncement",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogSubmitButtonLabel:member",
-              "docComment": "/**\n * Label on the agent-log row's Send button. While the compose box is open the row button is just the (disabled) trigger, so it keeps its idle label; otherwise it reflects the in-flight / flashed outcome of the last submission.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "get debugLogSubmitButtonLabel(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": true,
-              "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "debugLogSubmitButtonLabel",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogSubmitLabel:member",
-              "docComment": "/**\n * The Send button's idle label, as the host configured it.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "get debugLogSubmitLabel(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": true,
-              "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "debugLogSubmitLabel",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogSubmitResult:member",
-              "docComment": "/**\n * Outcome of the last log submission, shown briefly on the button ('Sent' / 'Failed — retry') then cleared by `setDebugLogSubmitResult`'s timer. `null` when idle.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "debugLogSubmitResult: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "'sent' | 'error' | null"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
+              "isReadonly": true,
               "isOptional": false,
               "releaseTag": "Beta",
-              "name": "debugLogSubmitResult",
+              "name": "cumulativeCostUsd",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -10923,26 +10435,27 @@
             },
             {
               "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#debugLogSubmitResultFlashMs:member",
-              "docComment": "/**\n * How long 'Sent' shows before idle. Overridable so tests need not wait 4 seconds.\n */\n",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#cumulativeUsage:member",
+              "docComment": "/**\n * Lifetime usage across every project in the history scope — rows only, never plus live.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "debugLogSubmitResultFlashMs: "
+                  "text": "get cumulativeUsage(): "
                 },
                 {
-                  "kind": "Content",
-                  "text": "number"
+                  "kind": "Reference",
+                  "text": "AggregateUsage",
+                  "canonicalReference": "@genesislcap/foundation-ai!AggregateUsage:interface"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isReadonly": false,
+              "isReadonly": true,
               "isOptional": false,
               "releaseTag": "Beta",
-              "name": "debugLogSubmitResultFlashMs",
+              "name": "cumulativeUsage",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -12166,54 +11679,6 @@
               "isProtected": false,
               "isAbstract": false
             },
-            {
-              "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#noteDebugLogInput:member(1)",
-              "docComment": "/**\n * The note's `@input`: track the text, and let typing dismiss a standing failure.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "noteDebugLogInput(value: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
-                },
-                {
-                  "kind": "Content",
-                  "text": "): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "void"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 3,
-                "endIndex": 4
-              },
-              "releaseTag": "Beta",
-              "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": [
-                {
-                  "parameterName": "value",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 1,
-                    "endIndex": 2
-                  },
-                  "isOptional": false
-                }
-              ],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "noteDebugLogInput"
-            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#onChatHeaderMouseDown:member(1)",
@@ -12490,37 +11955,6 @@
               "isAbstract": false,
               "name": "onSettingsModalTabsChange"
             },
-            {
-              "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#openDebugLogCompose:member(1)",
-              "docComment": "/**\n * The row's Send button. With a compose box configured (the default) it opens the box and focuses the note so the user can caption the log; with `note: false` it sends straight away, as before.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "openDebugLogCompose(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "void"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "releaseTag": "Beta",
-              "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": [],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "openDebugLogCompose"
-            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#openSettingsModal:member(1)",
@@ -14187,36 +13621,6 @@
               "isAbstract": false,
               "name": "setSettingsModalTab"
             },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#settingsAgentLogSectionVisible:member",
-              "docComment": "/**\n * Whether the settings \"Agent log\" section renders — shown when either action is enabled: the download button (`allowDebugDownload`) or the host-transport Send button (`debugLogSubmit`). Each button is additionally gated on its own flag inside the section, so a host can enable one without the other.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "get settingsAgentLogSectionVisible(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "boolean"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": true,
-              "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "settingsAgentLogSectionVisible",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#settingsAppSectionVisible:member",
@@ -15535,42 +14939,6 @@
               "isProtected": false,
               "isAbstract": false
             },
-            {
-              "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#submitDebugLog:member(1)",
-              "docComment": "/**\n * Hand the agent log to the host's `ui.debugLogSubmit.send` callback — the Send button next to Download. Reuses `buildDownloadLog`, so the submitted log is byte-identical to what Download saves (lifetime-stitched when the provider persists diagnostics). The assistant is vendor-agnostic: the callback owns the transport (Sentry feedback, a support API, an upload endpoint). Outcome lands in `debugLogSubmitResult` so the button can flash 'Sent'/'Failed'; failures also go to the logger with the cause.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "submitDebugLog(): "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "Promise",
-                  "canonicalReference": "!Promise:interface"
-                },
-                {
-                  "kind": "Content",
-                  "text": "<void>"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 3
-              },
-              "releaseTag": "Beta",
-              "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": [],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "submitDebugLog"
-            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#submitMessage:member(1)",
@@ -15642,36 +15010,6 @@
               "isAbstract": false,
               "name": "submitMessage"
             },
-            {
-              "kind": "Property",
-              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#submittingDebugLog:member",
-              "docComment": "/**\n * True while `submitDebugLog` is building and handing off the log. Same role as `downloadingDebugLog` for the Send button: the lifetime-stitch and the host's `send` callback are async, so the button needs a visible in-flight state.\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "submittingDebugLog: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "boolean"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": false,
-              "releaseTag": "Beta",
-              "name": "submittingDebugLog",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "isStatic": false,
-              "isProtected": false,
-              "isAbstract": false
-            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#suggestionsState:member",
@@ -17726,7 +17064,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#getActiveAgent:member(1)",
-              "docComment": "/**\n * The live `AgentConfig` currently active in the driver — the instance whose `onActivate` ran, so its `serialize`/`getDebugSnapshot` closures hold live state. Prefer this over looking the agent up in the host's `agents` array, which may mint fresh, never-activated configs.\n *\n * `undefined` means no agent is active (before the first activation, after a release), which is a different statement from the driver not being able to answer. Both drivers implement it since GENC-1580; see {@link AiDriver.primeRestoredAgentState} for why the `?` stays for now.\n */\n",
+              "docComment": "/**\n * The live `AgentConfig` currently active in the driver — the instance whose `onActivate` ran, so its `serialize`/`getDebugSnapshot` closures hold live state. Prefer this over looking the agent up in the host's `agents` array, which may mint fresh, never-activated configs.\n *\n * `undefined` means no agent is active (before the first activation, after a release), which is a different statement from the driver not being able to answer — and since GENC-1580's breaking release the second case cannot arise, because the method is required.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -18328,7 +17666,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver#primeRestoredAgentState:member(1)",
-              "docComment": "/**\n * Prime per-agent restored state for a session being rehydrated. Each entry (keyed by agent name) is handed to that agent's `onActivate`/`init` as `ctx.restored` on its next activation, then consumed.\n *\n * Implemented by every driver since GENC-1580 — each owns an `AgentSession` — so \"only multi-agent drivers implement it\" is no longer true. Still declared optional: this interface is exported and `@beta`, so requiring it would break any third party implementing it. The `?` comes off with the `installAgent` rename, which is the ticket's one breaking release.\n */\n",
+              "docComment": "/**\n * Prime per-agent restored state for a session being rehydrated. Each entry (keyed by agent name) is handed to that agent's `onActivate`/`init` as `ctx.restored` on its next activation, then consumed.\n *\n * Required since GENC-1580's breaking release: every driver owns an `AgentSession`, so both shipped drivers implement it and a host no longer has to feature-detect before restoring.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -19303,105 +18641,6 @@
             "endIndex": 0
           }
         },
-        {
-          "kind": "Interface",
-          "canonicalReference": "@genesislcap/ai-assistant!ResolvedDebugLogNoteConfig:interface",
-          "docComment": "/**\n * `ChatDebugLogNoteConfig` with every option resolved.\n */\n",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "export interface ResolvedDebugLogNoteConfig "
-            }
-          ],
-          "fileUrlPath": "src/utils/resolve-debug-log-note.ts",
-          "releaseTag": "Public",
-          "name": "ResolvedDebugLogNoteConfig",
-          "preserveMemberOrder": false,
-          "members": [
-            {
-              "kind": "PropertySignature",
-              "canonicalReference": "@genesislcap/ai-assistant!ResolvedDebugLogNoteConfig#maxLength:member",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "maxLength: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "number"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": false,
-              "releaseTag": "Public",
-              "name": "maxLength",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              }
-            },
-            {
-              "kind": "PropertySignature",
-              "canonicalReference": "@genesislcap/ai-assistant!ResolvedDebugLogNoteConfig#placeholder:member",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "placeholder: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": false,
-              "releaseTag": "Public",
-              "name": "placeholder",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              }
-            },
-            {
-              "kind": "PropertySignature",
-              "canonicalReference": "@genesislcap/ai-assistant!ResolvedDebugLogNoteConfig#required:member",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "required: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "boolean"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": false,
-              "releaseTag": "Public",
-              "name": "required",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              }
-            }
-          ],
-          "extendsTokenRanges": []
-        },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@genesislcap/ai-assistant!ResponseSchemaInput:type",