@genesislcap/ai-assistant 14.494.0 → 14.496.0

package/dist/ai-assistant.api.json

@@ -178,6 +178,116 @@
       "name": "",
       "preserveMemberOrder": false,
       "members": [
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/ai-assistant!ActivityBus:interface",
+          "docComment": "/**\n * Minimal activity-bus surface the drivers depend on. `ChatDriver`/`OrchestratingDriver` only ever *publish* — accepting this narrow interface (rather than importing the module singleton) lets a headless/server or unit-test host omit the bus entirely, so no live `BroadcastChannel` is ever opened on that path. See {@link NOOP_ACTIVITY_BUS}.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface ActivityBus "
+            }
+          ],
+          "fileUrlPath": "src/channel/ai-activity-bus.ts",
+          "releaseTag": "Beta",
+          "name": "ActivityBus",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/ai-assistant!ActivityBus#publish:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "publish<K extends "
+                },
+                {
+                  "kind": "Content",
+                  "text": "keyof "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AgenticActivityEvents",
+                  "canonicalReference": "@genesislcap/ai-assistant!AgenticActivityEvents:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">(type: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "K"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", detail: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "AgenticActivityEvents",
+                  "canonicalReference": "@genesislcap/ai-assistant!AgenticActivityEvents:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[K]"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 9,
+                "endIndex": 10
+              },
+              "releaseTag": "Beta",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "type",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 4,
+                    "endIndex": 5
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "detail",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 6,
+                    "endIndex": 8
+                  },
+                  "isOptional": false
+                }
+              ],
+              "typeParameters": [
+                {
+                  "typeParameterName": "K",
+                  "constraintTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 3
+                  },
+                  "defaultTypeTokenRange": {
+                    "startIndex": 0,
+                    "endIndex": 0
+                  }
+                }
+              ],
+              "name": "publish"
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "Variable",
           "canonicalReference": "@genesislcap/ai-assistant!AGENT_PICKER_AUTO_VALUE:var",
@@ -637,6 +747,33 @@
                 "endIndex": 2
               }
             },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!AgenticActivityBusConfig#channelNameFactory:member",
+              "docComment": "/**\n * Lazy alternative to {@link AgenticActivityBusConfig.channelName}: called the first time a cross-tab channel is actually needed, in a browser only. Deferring the name computation keeps side effects (e.g. `sessionStorage` reads) out of module-eval and off the non-browser path. Ignored if `channelName` is also set.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "channelNameFactory?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "() => string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "channelNameFactory",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
             {
               "kind": "PropertySignature",
               "canonicalReference": "@genesislcap/ai-assistant!AgenticActivityBusConfig#crossTabEvents:member",
@@ -856,7 +993,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@genesislcap/ai-assistant!AgenticActivityEvents#\"tool-loop-end\":member",
-              "docComment": "/**\n * Fired when the tool loop completes for the current turn and control returns to the user on the **main chat prompt** (i.e. the next free-form user message can now be accepted).\n *\n * Boundary: this is the moment the user regains control of the main chat input. It is **not** fired when a tool handler hands a widget to the user mid-loop (e.g. while a planning widget is awaiting a click) — widget pauses are still inside the loop, the assistant still owns the turn, and the main chat input may be hidden during them. Wait for this event when you need to know that the assistant is fully idle and the user can type freely again.\n *\n * Emitted from the finally block of each `ChatDriver`'s `sendMessage` and `continueFromHistory`, so a multi-agent handoff fires this event once per agent.\n *\n * Distinct from {@link AgenticActivityEvents.'halo-stop'} — the halo event tracks the spinner animation lifecycle (which can flap mid-turn as tool calls resolve), whereas this event is a one-shot per turn boundary. Use this for hooks tied to a turn ending (telemetry flushes, post-turn workspace transitions, deferred state recomputation).\n */\n",
+              "docComment": "/**\n * Fired when the tool loop completes for the current turn and control returns to the user on the **main chat prompt** (i.e. the next free-form user message can now be accepted).\n *\n * Boundary: this is the moment the user regains control of the main chat input. It is **not** fired when a tool handler hands a widget to the user mid-loop (e.g. while a planning widget is awaiting a click) — widget pauses are still inside the loop, the assistant still owns the turn, and the main chat input may be hidden during them. Wait for this event when you need to know that the assistant is fully idle and the user can type freely again.\n *\n * Emitted from the finally block of each `ChatDriver`'s `sendMessage` and `continueFromHistory`, so a multi-agent handoff fires this event once per agent.\n *\n * Distinct from {@link AgenticActivityEvents.'halo-stop'} — the halo event tracks the spinner animation lifecycle (which can flap mid-turn as tool calls resolve), whereas this event is a one-shot per turn boundary. Use this for hooks tied to a turn ending (telemetry flushes, post-turn workspace transitions, deferred state recomputation).\n *\n * The detail carries the turn's outcome (PTC-0): on a failure it is `{ failureReason }` with the typed `TurnFailureReason`; on a clean completion, a user cancel, a driver dispose, and an agent handoff the detail is `undefined` — the historical shape, kept byte-identical so subscribers that only care about the boundary can keep ignoring it. Structured-cloneable so it survives the cross-tab BroadcastChannel hop.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -864,7 +1001,16 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "undefined"
+                  "text": "{\n        failureReason?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "TurnFailureReason",
+                  "canonicalReference": "@genesislcap/foundation-ai!TurnFailureReason:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";\n    } | undefined"
                 },
                 {
                   "kind": "Content",
@@ -877,7 +1023,7 @@
               "name": "\"tool-loop-end\"",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
-                "endIndex": 2
+                "endIndex": 4
               }
             },
             {
@@ -4038,75 +4184,12 @@
                 },
                 {
                   "kind": "Content",
-                  "text": ", toolHandlers?: "
+                  "text": ", config?: "
                 },
                 {
                   "kind": "Reference",
-                  "text": "ToolHandlersInput",
-                  "canonicalReference": "@genesislcap/ai-assistant!ToolHandlersInput:type"
-                },
-                {
-                  "kind": "Content",
-                  "text": ", toolDefinitions?: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "ToolDefinitionsInput",
-                  "canonicalReference": "@genesislcap/ai-assistant!ToolDefinitionsInput:type"
-                },
-                {
-                  "kind": "Content",
-                  "text": ", systemPrompt?: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "SystemPromptInput",
-                  "canonicalReference": "@genesislcap/ai-assistant!SystemPromptInput:type"
-                },
-                {
-                  "kind": "Content",
-                  "text": ", primerHistory?: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "ChatMessage",
-                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
-                },
-                {
-                  "kind": "Content",
-                  "text": "[]"
-                },
-                {
-                  "kind": "Content",
-                  "text": ", maxToolIterations?: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "number"
-                },
-                {
-                  "kind": "Content",
-                  "text": ", maxFoldOperations?: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "number"
-                },
-                {
-                  "kind": "Content",
-                  "text": ", maxTurnSnapshots?: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "number"
-                },
-                {
-                  "kind": "Content",
-                  "text": ", \n    sessionKey?: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
+                  "text": "ChatDriverConfig",
+                  "canonicalReference": "@genesislcap/ai-assistant!ChatDriverConfig:interface"
                 },
                 {
                   "kind": "Content",
@@ -4126,68 +4209,12 @@
                   "isOptional": false
                 },
                 {
-                  "parameterName": "toolHandlers",
+                  "parameterName": "config",
                   "parameterTypeTokenRange": {
                     "startIndex": 3,
                     "endIndex": 4
                   },
                   "isOptional": true
-                },
-                {
-                  "parameterName": "toolDefinitions",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 5,
-                    "endIndex": 6
-                  },
-                  "isOptional": true
-                },
-                {
-                  "parameterName": "systemPrompt",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 7,
-                    "endIndex": 8
-                  },
-                  "isOptional": true
-                },
-                {
-                  "parameterName": "primerHistory",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 9,
-                    "endIndex": 11
-                  },
-                  "isOptional": true
-                },
-                {
-                  "parameterName": "maxToolIterations",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 12,
-                    "endIndex": 13
-                  },
-                  "isOptional": true
-                },
-                {
-                  "parameterName": "maxFoldOperations",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 14,
-                    "endIndex": 15
-                  },
-                  "isOptional": true
-                },
-                {
-                  "parameterName": "maxTurnSnapshots",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 16,
-                    "endIndex": 17
-                  },
-                  "isOptional": true
-                },
-                {
-                  "parameterName": "sessionKey",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 18,
-                    "endIndex": 19
-                  },
-                  "isOptional": true
                 }
               ]
             },
@@ -5260,153 +5287,423 @@
                   "isOptional": true
                 }
               ],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "sendMessage"
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "sendMessage"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#setHostInteractionRequester:member(1)",
+              "docComment": "/**\n * Wire a parent driver as the host for this driver's interactions. When set, `requestInteraction` delegates upward so the widget renders in (and resolves through) the parent's history and pending map. Calls chain naturally: a grandchild → child → root.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "setHostInteractionRequester(fn: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "<T>(componentName: string, data: any, options?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "InteractionRequestOptions",
+                  "canonicalReference": "@genesislcap/foundation-ai!InteractionRequestOptions:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ") => "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<T>"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 7,
+                "endIndex": 8
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "fn",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 6
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "setHostInteractionRequester"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#setProviderHistoryTransform:member(1)",
+              "docComment": "/**\n * Optional transform applied to conversation history immediately before each LLM request. Cleared when `undefined`. Does not alter stored history.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "setProviderHistoryTransform(transform?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "(history: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatMessage",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]) => "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ChatMessage",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 7,
+                "endIndex": 8
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "transform",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 6
+                  },
+                  "isOptional": true
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "setProviderHistoryTransform"
+            }
+          ],
+          "extendsTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          },
+          "implementsTokenRanges": [
+            {
+              "startIndex": 3,
+              "endIndex": 4
+            }
+          ]
+        },
+        {
+          "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",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface ChatDriverConfig "
+            }
+          ],
+          "fileUrlPath": "src/components/chat-driver/chat-driver.ts",
+          "releaseTag": "Beta",
+          "name": "ChatDriverConfig",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriverConfig#activityBus:member",
+              "docComment": "/**\n * Activity bus for lifecycle/halo/tool-loop events. Injected by the browser host (the shared cross-tab singleton); omitted off-browser (Node, tests, headless), where it defaults to {@link NOOP_ACTIVITY_BUS} so no `BroadcastChannel` is ever opened.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "activityBus?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ActivityBus",
+                  "canonicalReference": "@genesislcap/ai-assistant!ActivityBus:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "activityBus",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriverConfig#maxFoldOperations:member",
+              "docComment": "/**\n * Hard cap on fold operations. Default `5`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "maxFoldOperations?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "maxFoldOperations",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriverConfig#maxToolIterations:member",
+              "docComment": "/**\n * Hard cap on tool-loop iterations. Default `50`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "maxToolIterations?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "maxToolIterations",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
             },
             {
-              "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#setHostInteractionRequester:member(1)",
-              "docComment": "/**\n * Wire a parent driver as the host for this driver's interactions. When set, `requestInteraction` delegates upward so the widget renders in (and resolves through) the parent's history and pending map. Calls chain naturally: a grandchild → child → root.\n */\n",
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriverConfig#maxTurnSnapshots:member",
+              "docComment": "/**\n * Ring-buffer size for per-turn snapshots. Default `400`.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "setHostInteractionRequester(fn: "
+                  "text": "maxTurnSnapshots?: "
                 },
                 {
                   "kind": "Content",
-                  "text": "<T>(componentName: string, data: any, options?: "
+                  "text": "number"
                 },
                 {
-                  "kind": "Reference",
-                  "text": "InteractionRequestOptions",
-                  "canonicalReference": "@genesislcap/foundation-ai!InteractionRequestOptions:interface"
-                },
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "maxTurnSnapshots",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriverConfig#primerHistory:member",
+              "docComment": "/**\n * Primer history prepended to the conversation.\n */\n",
+              "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": ") => "
+                  "text": "primerHistory?: "
                 },
                 {
                   "kind": "Reference",
-                  "text": "Promise",
-                  "canonicalReference": "!Promise:interface"
+                  "text": "ChatMessage",
+                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": "<T>"
+                  "text": "[]"
                 },
                 {
                   "kind": "Content",
-                  "text": "): "
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "primerHistory",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriverConfig#sessionKey:member",
+              "docComment": "/**\n * Session identity used to file meta events onto the shared debug-log timeline.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "sessionKey?: "
                 },
                 {
                   "kind": "Content",
-                  "text": "void"
+                  "text": "string"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 7,
-                "endIndex": 8
-              },
+              "isReadonly": false,
+              "isOptional": true,
               "releaseTag": "Beta",
-              "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": [
-                {
-                  "parameterName": "fn",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 1,
-                    "endIndex": 6
-                  },
-                  "isOptional": false
-                }
-              ],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "setHostInteractionRequester"
+              "name": "sessionKey",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
             },
             {
-              "kind": "Method",
-              "canonicalReference": "@genesislcap/ai-assistant!ChatDriver#setProviderHistoryTransform:member(1)",
-              "docComment": "/**\n * Optional transform applied to conversation history immediately before each LLM request. Cleared when `undefined`. Does not alter stored history.\n */\n",
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriverConfig#systemPrompt:member",
+              "docComment": "/**\n * Initial system prompt (string or per-turn resolver).\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "setProviderHistoryTransform(transform?: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "(history: "
+                  "text": "systemPrompt?: "
                 },
                 {
                   "kind": "Reference",
-                  "text": "ChatMessage",
-                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+                  "text": "SystemPromptInput",
+                  "canonicalReference": "@genesislcap/ai-assistant!SystemPromptInput:type"
                 },
                 {
                   "kind": "Content",
-                  "text": "[]) => "
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "systemPrompt",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriverConfig#toolDefinitions:member",
+              "docComment": "/**\n * Initial tool definitions (static array or per-turn factory). Default `[]`.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "toolDefinitions?: "
                 },
                 {
                   "kind": "Reference",
-                  "text": "ChatMessage",
-                  "canonicalReference": "@genesislcap/foundation-ai!ChatMessage:interface"
+                  "text": "ToolDefinitionsInput",
+                  "canonicalReference": "@genesislcap/ai-assistant!ToolDefinitionsInput:type"
                 },
                 {
                   "kind": "Content",
-                  "text": "[]"
-                },
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": true,
+              "releaseTag": "Beta",
+              "name": "toolDefinitions",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatDriverConfig#toolHandlers:member",
+              "docComment": "/**\n * Initial tool handlers (static map or per-turn factory). Default `{}`.\n */\n",
+              "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "): "
+                  "text": "toolHandlers?: "
                 },
                 {
-                  "kind": "Content",
-                  "text": "void"
+                  "kind": "Reference",
+                  "text": "ToolHandlersInput",
+                  "canonicalReference": "@genesislcap/ai-assistant!ToolHandlersInput:type"
                 },
                 {
                   "kind": "Content",
                   "text": ";"
                 }
               ],
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 7,
-                "endIndex": 8
-              },
+              "isReadonly": false,
+              "isOptional": true,
               "releaseTag": "Beta",
-              "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": [
-                {
-                  "parameterName": "transform",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 1,
-                    "endIndex": 6
-                  },
-                  "isOptional": true
-                }
-              ],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "setProviderHistoryTransform"
+              "name": "toolHandlers",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
             }
           ],
-          "extendsTokenRange": {
-            "startIndex": 1,
-            "endIndex": 2
-          },
-          "implementsTokenRanges": [
-            {
-              "startIndex": 3,
-              "endIndex": 4
-            }
-          ]
+          "extendsTokenRanges": []
         },
         {
           "kind": "Interface",
@@ -12540,6 +12837,30 @@
           ],
           "extendsTokenRanges": []
         },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@genesislcap/ai-assistant!NOOP_ACTIVITY_BUS:var",
+          "docComment": "/**\n * No-op {@link ActivityBus}. The default when no bus is injected (Node, tests, headless server use) — publishing goes nowhere and nothing is left open to tear down.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "NOOP_ACTIVITY_BUS: "
+            },
+            {
+              "kind": "Reference",
+              "text": "ActivityBus",
+              "canonicalReference": "@genesislcap/ai-assistant!ActivityBus:interface"
+            }
+          ],
+          "fileUrlPath": "src/channel/ai-activity-bus.ts",
+          "isReadonly": true,
+          "releaseTag": "Beta",
+          "name": "NOOP_ACTIVITY_BUS",
+          "variableTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          }
+        },
         {
           "kind": "Class",
           "canonicalReference": "@genesislcap/ai-assistant!OrchestratingDriver:class",
@@ -12607,7 +12928,16 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "{\n        sessionKey?: string;\n        maxHandoffs?: number;\n        classifierHistoryLength?: number;\n        classifierRetries?: number;\n        maxToolIterations?: number;\n        maxFoldOperations?: number;\n        maxTurnSnapshots?: number;\n    }"
+                  "text": "{\n        sessionKey?: string;\n        maxHandoffs?: number;\n        classifierHistoryLength?: number;\n        classifierRetries?: number;\n        maxToolIterations?: number;\n        maxFoldOperations?: number;\n        maxTurnSnapshots?: number;\n        activityBus?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ActivityBus",
+                  "canonicalReference": "@genesislcap/ai-assistant!ActivityBus:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";\n    }"
                 },
                 {
                   "kind": "Content",
@@ -12638,7 +12968,7 @@
                   "parameterName": "options",
                   "parameterTypeTokenRange": {
                     "startIndex": 6,
-                    "endIndex": 7
+                    "endIndex": 9
                   },
                   "isOptional": true
                 }
@@ -14150,6 +14480,50 @@
             "endIndex": 0
           }
         },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@genesislcap/ai-assistant!ResponseSchemaInput:type",
+          "docComment": "/**\n * Structured-output schema for an agent. When set, the model's final (non-tool) answer is constrained to this JSON Schema instead of free text. Either a static schema or a function resolved each tool-loop iteration — return the schema on the turn(s) it should apply and `undefined` otherwise, so \"whole-loop\" vs \"finalize-turn\" enforcement is just what the resolver returns (e.g. `({ state }) => state.machine.matches('finalizing') ? schema : undefined`).\n *\n * Orthogonal to {@link ToolChoiceInput}: an agent can carry both `tools` and a `responseSchema`. Each provider applies it natively where possible (Anthropic `output_config.format`, Gemini JSON mode) and degrades gracefully otherwise. The schema is a plain JSON Schema object; keep to the portable subset providers share (`additionalProperties: false`, explicit `required`, enums, `anyOf` for nullables — no numeric/string constraints or recursion).\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type ResponseSchemaInput = "
+            },
+            {
+              "kind": "Content",
+              "text": "object | ((ctx: "
+            },
+            {
+              "kind": "Reference",
+              "text": "SystemPromptContext",
+              "canonicalReference": "@genesislcap/ai-assistant!SystemPromptContext:interface"
+            },
+            {
+              "kind": "Content",
+              "text": ") => object | undefined | "
+            },
+            {
+              "kind": "Reference",
+              "text": "Promise",
+              "canonicalReference": "!Promise:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "<object | undefined>)"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/config/config.ts",
+          "releaseTag": "Beta",
+          "name": "ResponseSchemaInput",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 6
+          }
+        },
         {
           "kind": "Function",
           "canonicalReference": "@genesislcap/ai-assistant!restoreMachine:function(1)",