@genesislcap/ai-assistant 14.408.0 → 14.409.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/ai-assistant",
   "description": "Genesis AI Assistant micro-frontend",
-  "version": "14.408.0",
+  "version": "14.409.0",
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
   "types": "dist/ai-assistant.d.ts",
@@ -59,23 +59,23 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.408.0",
-    "@genesislcap/genx": "14.408.0",
-    "@genesislcap/rollup-builder": "14.408.0",
-    "@genesislcap/ts-builder": "14.408.0",
-    "@genesislcap/uvu-playwright-builder": "14.408.0",
-    "@genesislcap/vite-builder": "14.408.0",
-    "@genesislcap/webpack-builder": "14.408.0",
+    "@genesislcap/foundation-testing": "14.409.0",
+    "@genesislcap/genx": "14.409.0",
+    "@genesislcap/rollup-builder": "14.409.0",
+    "@genesislcap/ts-builder": "14.409.0",
+    "@genesislcap/uvu-playwright-builder": "14.409.0",
+    "@genesislcap/vite-builder": "14.409.0",
+    "@genesislcap/webpack-builder": "14.409.0",
     "@types/dompurify": "^3.0.5",
     "@types/marked": "^5.0.2"
   },
   "dependencies": {
-    "@genesislcap/foundation-ai": "14.408.0",
-    "@genesislcap/foundation-logger": "14.408.0",
-    "@genesislcap/foundation-ui": "14.408.0",
-    "@genesislcap/foundation-utils": "14.408.0",
-    "@genesislcap/rapid-design-system": "14.408.0",
-    "@genesislcap/web-core": "14.408.0",
+    "@genesislcap/foundation-ai": "14.409.0",
+    "@genesislcap/foundation-logger": "14.409.0",
+    "@genesislcap/foundation-ui": "14.409.0",
+    "@genesislcap/foundation-utils": "14.409.0",
+    "@genesislcap/rapid-design-system": "14.409.0",
+    "@genesislcap/web-core": "14.409.0",
     "dompurify": "^3.3.1",
     "marked": "^17.0.3"
   },
@@ -87,5 +87,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "26b08831fd001b4ee95c8a0d3364a18c0ec4005b"
+  "gitHead": "cbe0459d170f27c35a7de18cec415947aedf4da5"
 }

package/docs/api/ai-assistant.agentconfig.description.md

@@ -1,16 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/ai-assistant](./ai-assistant.md) &gt; [AgentConfig](./ai-assistant.agentconfig.md) &gt; [description](./ai-assistant.agentconfig.description.md)
-
-## AgentConfig.description property
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-Plain-language description of what this agent handles. Used by the classifier to auto-generate its routing prompt.
-
-**Signature:**
-
-```typescript
-description: string;
-```

package/docs/api/ai-assistant.agentconfig.md

@@ -1,158 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/ai-assistant](./ai-assistant.md) &gt; [AgentConfig](./ai-assistant.agentconfig.md)
-
-## AgentConfig interface
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-Configuration for a single specialist agent.
-
-When multiple agents are provided to `FoundationAiAssistant`<!-- -->, an orchestrating layer will route each user message to the appropriate specialist based on intent. When only one agent is configured, routing is skipped.
-
-**Signature:**
-
-```typescript
-export interface AgentConfig 
-```
-
-## Properties
-
-<table><thead><tr><th>
-
-Property
-
-
-</th><th>
-
-Modifiers
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-[description](./ai-assistant.agentconfig.description.md)
-
-
-</td><td>
-
-
-</td><td>
-
-string
-
-
-</td><td>
-
-**_(BETA)_** Plain-language description of what this agent handles. Used by the classifier to auto-generate its routing prompt.
-
-
-</td></tr>
-<tr><td>
-
-[name](./ai-assistant.agentconfig.name.md)
-
-
-</td><td>
-
-
-</td><td>
-
-string
-
-
-</td><td>
-
-**_(BETA)_** Display name shown in the chat header when this agent is active.
-
-
-</td></tr>
-<tr><td>
-
-[primerHistory?](./ai-assistant.agentconfig.primerhistory.md)
-
-
-</td><td>
-
-
-</td><td>
-
-ChatMessage\[\]
-
-
-</td><td>
-
-**_(BETA)_** _(Optional)_ Optional primer history prepended to every call (not visible to the user). Used to establish agent identity and behavioural rules.
-
-
-</td></tr>
-<tr><td>
-
-[systemPrompt?](./ai-assistant.agentconfig.systemprompt.md)
-
-
-</td><td>
-
-
-</td><td>
-
-string
-
-
-</td><td>
-
-**_(BETA)_** _(Optional)_ System prompt injected into every conversation turn for this agent.
-
-
-</td></tr>
-<tr><td>
-
-[toolDefinitions?](./ai-assistant.agentconfig.tooldefinitions.md)
-
-
-</td><td>
-
-
-</td><td>
-
-ChatToolDefinition\[\]
-
-
-</td><td>
-
-**_(BETA)_** _(Optional)_ Tool definitions (JSON Schema) passed to the AI provider for this agent.
-
-
-</td></tr>
-<tr><td>
-
-[toolHandlers?](./ai-assistant.agentconfig.toolhandlers.md)
-
-
-</td><td>
-
-
-</td><td>
-
-ChatToolHandlers
-
-
-</td><td>
-
-**_(BETA)_** _(Optional)_ Tool handler implementations for this agent.
-
-
-</td></tr>
-</tbody></table>
-

package/docs/api/ai-assistant.agentconfig.name.md

@@ -1,16 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/ai-assistant](./ai-assistant.md) &gt; [AgentConfig](./ai-assistant.agentconfig.md) &gt; [name](./ai-assistant.agentconfig.name.md)
-
-## AgentConfig.name property
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-Display name shown in the chat header when this agent is active.
-
-**Signature:**
-
-```typescript
-name: string;
-```

package/docs/api/ai-assistant.agentconfig.primerhistory.md

@@ -1,16 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/ai-assistant](./ai-assistant.md) &gt; [AgentConfig](./ai-assistant.agentconfig.md) &gt; [primerHistory](./ai-assistant.agentconfig.primerhistory.md)
-
-## AgentConfig.primerHistory property
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-Optional primer history prepended to every call (not visible to the user). Used to establish agent identity and behavioural rules.
-
-**Signature:**
-
-```typescript
-primerHistory?: ChatMessage[];
-```

package/docs/api/ai-assistant.agentconfig.systemprompt.md

@@ -1,16 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/ai-assistant](./ai-assistant.md) &gt; [AgentConfig](./ai-assistant.agentconfig.md) &gt; [systemPrompt](./ai-assistant.agentconfig.systemprompt.md)
-
-## AgentConfig.systemPrompt property
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-System prompt injected into every conversation turn for this agent.
-
-**Signature:**
-
-```typescript
-systemPrompt?: string;
-```

package/docs/api/ai-assistant.agentconfig.tooldefinitions.md

@@ -1,16 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/ai-assistant](./ai-assistant.md) &gt; [AgentConfig](./ai-assistant.agentconfig.md) &gt; [toolDefinitions](./ai-assistant.agentconfig.tooldefinitions.md)
-
-## AgentConfig.toolDefinitions property
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-Tool definitions (JSON Schema) passed to the AI provider for this agent.
-
-**Signature:**
-
-```typescript
-toolDefinitions?: ChatToolDefinition[];
-```

package/docs/api/ai-assistant.agentconfig.toolhandlers.md

@@ -1,16 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/ai-assistant](./ai-assistant.md) &gt; [AgentConfig](./ai-assistant.agentconfig.md) &gt; [toolHandlers](./ai-assistant.agentconfig.toolhandlers.md)
-
-## AgentConfig.toolHandlers property
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-Tool handler implementations for this agent.
-
-**Signature:**
-
-```typescript
-toolHandlers?: ChatToolHandlers;
-```

package/docs/api/ai-assistant.agenticactivitybus._constructor_.md

@@ -1,53 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/ai-assistant](./ai-assistant.md) &gt; [AgenticActivityBus](./ai-assistant.agenticactivitybus.md) &gt; [(constructor)](./ai-assistant.agenticactivitybus._constructor_.md)
-
-## AgenticActivityBus.(constructor)
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-Constructs a new instance of the `AgenticActivityBus` class
-
-**Signature:**
-
-```typescript
-constructor(config?: AgenticActivityBusConfig);
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-config
-
-
-</td><td>
-
-[AgenticActivityBusConfig](./ai-assistant.agenticactivitybusconfig.md)
-
-
-</td><td>
-
-_(Optional)_ Optional configuration. Omit to create an in-memory-only bus.
-
-
-</td></tr>
-</tbody></table>
-

package/docs/api/ai-assistant.agenticactivitybus.addcrosstabevent.md

@@ -1,55 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/ai-assistant](./ai-assistant.md) &gt; [AgenticActivityBus](./ai-assistant.agenticactivitybus.md) &gt; [addCrossTabEvent](./ai-assistant.agenticactivitybus.addcrosstabevent.md)
-
-## AgenticActivityBus.addCrossTabEvent() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-Add an event type to the cross-tab forwarding set at runtime. Must be called before the first [AgenticActivityBus.publish()](./ai-assistant.agenticactivitybus.publish.md) of that event type.
-
-**Signature:**
-
-```typescript
-addCrossTabEvent(type: keyof AgenticActivityEvents): void;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-type
-
-
-</td><td>
-
-keyof [AgenticActivityEvents](./ai-assistant.agenticactivityevents.md)
-
-
-</td><td>
-
-
-</td></tr>
-</tbody></table>
-
-**Returns:**
-
-void
-

package/docs/api/ai-assistant.agenticactivitybus.close.md

@@ -1,20 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/ai-assistant](./ai-assistant.md) &gt; [AgenticActivityBus](./ai-assistant.agenticactivitybus.md) &gt; [close](./ai-assistant.agenticactivitybus.close.md)
-
-## AgenticActivityBus.close() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-Close the underlying BroadcastChannel. Call once on application teardown if needed.
-
-**Signature:**
-
-```typescript
-close(): void;
-```
-**Returns:**
-
-void
-

package/docs/api/ai-assistant.agenticactivitybus.md

@@ -1,18 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/ai-assistant](./ai-assistant.md) &gt; [agenticActivityBus](./ai-assistant.agenticactivitybus.md)
-
-## agenticActivityBus variable
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-Pre-instantiated singleton event bus for AI assistant activity.
-
-- `halo-start` / `halo-stop` are forwarded via a tab-scoped `BroadcastChannel` so that popout windows opened from this tab show halo animations, while remaining isolated from unrelated tabs on the same origin (tab-scoped channel name). - `chat-popout` / `chat-popin` are in-memory only — they must only affect the tab where the user clicked.
-
-**Signature:**
-
-```typescript
-agenticActivityBus: AgenticActivityBus
-```

package/docs/api/ai-assistant.agenticactivitybus.publish.md

@@ -1,69 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/ai-assistant](./ai-assistant.md) &gt; [AgenticActivityBus](./ai-assistant.agenticactivitybus.md) &gt; [publish](./ai-assistant.agenticactivitybus.publish.md)
-
-## AgenticActivityBus.publish() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-Publish an event to all local subscribers and, if configured, to other tabs via BroadcastChannel.
-
-**Signature:**
-
-```typescript
-publish<K extends keyof AgenticActivityEvents>(type: K, detail: AgenticActivityEvents[K]): void;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-type
-
-
-</td><td>
-
-K
-
-
-</td><td>
-
-
-</td></tr>
-<tr><td>
-
-detail
-
-
-</td><td>
-
-[AgenticActivityEvents](./ai-assistant.agenticactivityevents.md)<!-- -->\[K\]
-
-
-</td><td>
-
-
-</td></tr>
-</tbody></table>
-
-**Returns:**
-
-void
-

package/docs/api/ai-assistant.agenticactivitybus.subscribe.md

@@ -1,69 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/ai-assistant](./ai-assistant.md) &gt; [AgenticActivityBus](./ai-assistant.agenticactivitybus.md) &gt; [subscribe](./ai-assistant.agenticactivitybus.subscribe.md)
-
-## AgenticActivityBus.subscribe() method
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-Subscribe to an event. Returns an unsubscribe function — call it in `disconnectedCallback` to avoid memory leaks.
-
-**Signature:**
-
-```typescript
-subscribe<K extends keyof AgenticActivityEvents>(type: K, handler: (detail: AgenticActivityEvents[K]) => void): () => void;
-```
-
-## Parameters
-
-<table><thead><tr><th>
-
-Parameter
-
-
-</th><th>
-
-Type
-
-
-</th><th>
-
-Description
-
-
-</th></tr></thead>
-<tbody><tr><td>
-
-type
-
-
-</td><td>
-
-K
-
-
-</td><td>
-
-
-</td></tr>
-<tr><td>
-
-handler
-
-
-</td><td>
-
-(detail: [AgenticActivityEvents](./ai-assistant.agenticactivityevents.md)<!-- -->\[K\]) =&gt; void
-
-
-</td><td>
-
-
-</td></tr>
-</tbody></table>
-
-**Returns:**
-
-() =&gt; void
-

package/docs/api/ai-assistant.agenticactivitybusconfig.channelname.md

@@ -1,16 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/ai-assistant](./ai-assistant.md) &gt; [AgenticActivityBusConfig](./ai-assistant.agenticactivitybusconfig.md) &gt; [channelName](./ai-assistant.agenticactivitybusconfig.channelname.md)
-
-## AgenticActivityBusConfig.channelName property
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-BroadcastChannel name. Only used when crossTabEvents is non-empty.
-
-**Signature:**
-
-```typescript
-channelName?: string;
-```

package/docs/api/ai-assistant.agenticactivitybusconfig.crosstabevents.md

@@ -1,16 +0,0 @@
-<!-- Do not edit this file. It is automatically generated by API Documenter. -->
-
-[Home](./index.md) &gt; [@genesislcap/ai-assistant](./ai-assistant.md) &gt; [AgenticActivityBusConfig](./ai-assistant.agenticactivitybusconfig.md) &gt; [crossTabEvents](./ai-assistant.agenticactivitybusconfig.crosstabevents.md)
-
-## AgenticActivityBusConfig.crossTabEvents property
-
-> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
-> 
-
-Events that should also be forwarded via BroadcastChannel to other tabs.
-
-**Signature:**
-
-```typescript
-crossTabEvents?: (keyof AgenticActivityEvents)[];
-```