@genesislcap/ai-assistant 14.418.2 → 14.419.1

package/dist/ai-assistant.api.json

@@ -1305,7 +1305,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@genesislcap/ai-assistant!ChatDriver:class",
-          "docComment": "/**\n * Plain TS class that drives a multi-turn chat conversation, including the tool-call loop. Owned by `FoundationAiAssistant` — created in `connectedCallback`, torn down in `disconnectedCallback`.\n *\n * Dispatches `'history-updated'` events on itself so the owning element can observe changes.\n *\n * @beta\n */\n",
+          "docComment": "/**\n * Plain TS class that drives a multi-turn chat conversation, including the tool-call loop. Owned by `FoundationAiAssistant` — created in `connectedCallback`, torn down in `disconnectedCallback`.\n *\n * Dispatches `'history-updated'` events on itself so the owning element can observe changes.\n *\n * @fires history-updated - Fired whenever the in-memory chat history changes (append, tool loop, interaction resolution). `detail` is `ReadonlyArray<ChatMessage>` (the full history snapshot).\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -1859,7 +1859,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant:class",
-          "docComment": "/**\n * Foundation AI Assistant component.\n *\n * @remarks\n *\n * Inject an `AIProvider` through the DI container. Pass agent configuration via the `agents` property. The component creates a `ChatDriver` to manage the conversation loop.\n *\n * @beta\n */\n",
+          "docComment": "/**\n * Foundation AI Assistant component.\n *\n * @remarks\n *\n * Inject an `AIProvider` through the DI container. Pass agent configuration via the `agents` property. The component creates a `ChatDriver` to manage the conversation loop.\n *\n * Popout/collapse coordination uses `agenticActivityBus` topics `chat-popout` and `chat-popin` — not DOM `CustomEvent`s on this element.\n *\n * @fires chat-header-mousedown - Fired when the user presses the chat header in `popout-mode=\"expand\"` (for drag-to-popout hosts). Bubbles and composed; `detail`: `{ clientX, clientY }`.\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",

package/dist/ai-assistant.d.ts

@@ -235,6 +235,8 @@ export declare const ANIMATION_DEFS: {
  *
  * Dispatches `'history-updated'` events on itself so the owning element can observe changes.
  *
+ * @fires history-updated - Fired whenever the in-memory chat history changes (append, tool loop, interaction resolution). `detail` is `ReadonlyArray<ChatMessage>` (the full history snapshot).
+ *
  * @beta
  */
 export declare class ChatDriver extends EventTarget {
@@ -287,6 +289,10 @@ export declare type ChatHistoryUpdatedEvent = CustomEvent<ReadonlyArray<ChatMess
  * Inject an `AIProvider` through the DI container. Pass agent configuration via the `agents`
  * property. The component creates a `ChatDriver` to manage the conversation loop.
  *
+ * Popout/collapse coordination uses `agenticActivityBus` topics `chat-popout` and `chat-popin` — not DOM `CustomEvent`s on this element.
+ *
+ * @fires chat-header-mousedown - Fired when the user presses the chat header in `popout-mode="expand"` (for drag-to-popout hosts). Bubbles and composed; `detail`: `{ clientX, clientY }`.
+ *
  * @beta
  */
 export declare class FoundationAiAssistant extends GenesisElement {

package/dist/dts/components/chat-driver/chat-driver.d.ts

@@ -11,6 +11,8 @@ export type ChatHistoryUpdatedEvent = CustomEvent<ReadonlyArray<ChatMessage>>;
  *
  * Dispatches `'history-updated'` events on itself so the owning element can observe changes.
  *
+ * @fires history-updated - Fired whenever the in-memory chat history changes (append, tool loop, interaction resolution). `detail` is `ReadonlyArray<ChatMessage>` (the full history snapshot).
+ *
  * @beta
  */
 export declare class ChatDriver extends EventTarget {

package/dist/dts/components/chat-driver/chat-driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-driver.d.ts","sourceRoot":"","sources":["../../../../src/components/chat-driver/chat-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,WAAW,EAEX,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AAOpC;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,WAAW,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;AAE9E;;;;;;;GAOG;AACH,qBAAa,UAAW,SAAQ,WAAW;IASvC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAbpC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,mBAAmB,CAGvB;gBAGe,UAAU,EAAE,UAAU,EACtB,YAAY,GAAE,gBAAqB,EACnC,eAAe,GAAE,kBAAkB,EAAO,EAC1C,YAAY,CAAC,EAAE,MAAM,EACrB,aAAa,CAAC,EAAE,WAAW,EAAE,EAC7B,iBAAiB,GAAE,MAAoC;IAU1E,UAAU,IAAI,aAAa,CAAC,WAAW,CAAC;IAIxC,MAAM,IAAI,OAAO;IAIjB;;;;;;OAMG;IACU,kBAAkB,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAYhF;;;OAGG;IACI,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI;IAqBnE;;;OAGG;IACI,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IAI3C,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAoBrE,WAAW;IA2HzB,OAAO,CAAC,eAAe;CAQxB"}
+{"version":3,"file":"chat-driver.d.ts","sourceRoot":"","sources":["../../../../src/components/chat-driver/chat-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,WAAW,EAEX,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AAOpC;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,WAAW,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;AAE9E;;;;;;;;;GASG;AACH,qBAAa,UAAW,SAAQ,WAAW;IASvC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAbpC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,mBAAmB,CAGvB;gBAGe,UAAU,EAAE,UAAU,EACtB,YAAY,GAAE,gBAAqB,EACnC,eAAe,GAAE,kBAAkB,EAAO,EAC1C,YAAY,CAAC,EAAE,MAAM,EACrB,aAAa,CAAC,EAAE,WAAW,EAAE,EAC7B,iBAAiB,GAAE,MAAoC;IAU1E,UAAU,IAAI,aAAa,CAAC,WAAW,CAAC;IAIxC,MAAM,IAAI,OAAO;IAIjB;;;;;;OAMG;IACU,kBAAkB,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAYhF;;;OAGG;IACI,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI;IAqBnE;;;OAGG;IACI,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IAI3C,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAoBrE,WAAW;IA2HzB,OAAO,CAAC,eAAe;CAQxB"}

package/dist/dts/components/chat-interaction-wrapper/chat-interaction-wrapper.d.ts

@@ -5,6 +5,12 @@ export type ChatInteractionEventsMap = {
         interactionId: string;
     };
 };
+/**
+ * Hosts an interactive AI chat sub-component by tag name.
+ * @public
+ *
+ * @fires interaction-completed - Fired when the interaction finishes
+ */
 export declare class AiChatInteractionWrapper extends GenesisElement {
     /** @internal */
     componentName: string;

package/dist/dts/components/chat-interaction-wrapper/chat-interaction-wrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-interaction-wrapper.d.ts","sourceRoot":"","sources":["../../../../src/components/chat-interaction-wrapper/chat-interaction-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAiB,cAAc,EAAc,MAAM,uBAAuB,CAAC;AAKlF,MAAM,MAAM,wBAAwB,GAAG;IACrC,uBAAuB,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CACjF,CAAC;AAEF,qBAKa,wBAAyB,SAAQ,cAAc;IAC1D,gBAAgB;IACJ,aAAa,EAAE,MAAM,CAAM;IACvC,gBAAgB;IACJ,IAAI,EAAE,GAAG,CAAC;IACtB,gBAAgB;IACJ,aAAa,EAAE,MAAM,CAAM;IACvC,2GAA2G;IAC/F,QAAQ,EAAE,OAAO,CAAS;IAEtC,gBAAgB;IAChB,SAAS,EAAG,WAAW,CAAC;IAExB,iBAAiB;IAKjB,oBAAoB;IAIpB,eAAe;IAOf,OAAO,CAAC,eAAe;CA8CxB"}
+{"version":3,"file":"chat-interaction-wrapper.d.ts","sourceRoot":"","sources":["../../../../src/components/chat-interaction-wrapper/chat-interaction-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAiB,cAAc,EAAc,MAAM,uBAAuB,CAAC;AAKlF,MAAM,MAAM,wBAAwB,GAAG;IACrC,uBAAuB,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CACjF,CAAC;AAEF;;;;;GAKG;AACH,qBAKa,wBAAyB,SAAQ,cAAc;IAC1D,gBAAgB;IACJ,aAAa,EAAE,MAAM,CAAM;IACvC,gBAAgB;IACJ,IAAI,EAAE,GAAG,CAAC;IACtB,gBAAgB;IACJ,aAAa,EAAE,MAAM,CAAM;IACvC,2GAA2G;IAC/F,QAAQ,EAAE,OAAO,CAAS;IAEtC,gBAAgB;IAChB,SAAS,EAAG,WAAW,CAAC;IAExB,iBAAiB;IAKjB,oBAAoB;IAIpB,eAAe;IAOf,OAAO,CAAC,eAAe;CA8CxB"}

package/dist/dts/main/main.d.ts

@@ -11,6 +11,10 @@ import type { AiAssistantAnimation, AiAssistantState, PopoutMode } from './main.
  * Inject an `AIProvider` through the DI container. Pass agent configuration via the `agents`
  * property. The component creates a `ChatDriver` to manage the conversation loop.
  *
+ * Popout/collapse coordination uses `agenticActivityBus` topics `chat-popout` and `chat-popin` — not DOM `CustomEvent`s on this element.
+ *
+ * @fires chat-header-mousedown - Fired when the user presses the chat header in `popout-mode="expand"` (for drag-to-popout hosts). Bubbles and composed; `detail`: `{ clientX, clientY }`.
+ *
  * @beta
  */
 export declare class FoundationAiAssistant extends GenesisElement {

package/dist/dts/main/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/main/main.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/main/main.ts"],"names":[],"mappings":"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"}

package/dist/esm/components/chat-driver/chat-driver.js

@@ -9,6 +9,8 @@ const MAX_MALFORMED_RETRIES = 2;
  *
  * Dispatches `'history-updated'` events on itself so the owning element can observe changes.
  *
+ * @fires history-updated - Fired whenever the in-memory chat history changes (append, tool loop, interaction resolution). `detail` is `ReadonlyArray<ChatMessage>` (the full history snapshot).
+ *
  * @beta
  */
 export class ChatDriver extends EventTarget {

package/dist/esm/components/chat-interaction-wrapper/chat-interaction-wrapper.js

@@ -3,6 +3,12 @@ import { customElement, GenesisElement, observable } from '@genesislcap/web-core
 import { logger } from '../../utils/logger';
 import { AiChatInteractionWrapperStyles } from './chat-interaction-wrapper.styles';
 import { AiChatInteractionWrapperTemplate } from './chat-interaction-wrapper.template';
+/**
+ * Hosts an interactive AI chat sub-component by tag name.
+ * @public
+ *
+ * @fires interaction-completed - Fired when the interaction finishes
+ */
 let AiChatInteractionWrapper = class AiChatInteractionWrapper extends GenesisElement {
     constructor() {
         super(...arguments);

package/dist/esm/main/main.js

@@ -23,6 +23,10 @@ avoidTreeShaking(AiChatMarkdown, AiChatInteractionWrapper, AiHaloOverlay, AiChat
  * Inject an `AIProvider` through the DI container. Pass agent configuration via the `agents`
  * property. The component creates a `ChatDriver` to manage the conversation loop.
  *
+ * Popout/collapse coordination uses `agenticActivityBus` topics `chat-popout` and `chat-popin` — not DOM `CustomEvent`s on this element.
+ *
+ * @fires chat-header-mousedown - Fired when the user presses the chat header in `popout-mode="expand"` (for drag-to-popout hosts). Bubbles and composed; `detail`: `{ clientX, clientY }`.
+ *
  * @beta
  */
 let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistant extends GenesisElement {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/ai-assistant",
   "description": "Genesis AI Assistant micro-frontend",
-  "version": "14.418.2",
+  "version": "14.419.1",
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
   "types": "dist/ai-assistant.d.ts",
@@ -27,7 +27,12 @@
       "types": "./dist/dts/config/index.d.ts",
       "default": "./dist/esm/config/index.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./react": {
+      "types": "./dist/dts/react.d.ts",
+      "import": "./dist/react.mjs",
+      "require": "./dist/react.cjs"
+    }
   },
   "typesVersions": {
     "*": {
@@ -59,23 +64,23 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.418.2",
-    "@genesislcap/genx": "14.418.2",
-    "@genesislcap/rollup-builder": "14.418.2",
-    "@genesislcap/ts-builder": "14.418.2",
-    "@genesislcap/uvu-playwright-builder": "14.418.2",
-    "@genesislcap/vite-builder": "14.418.2",
-    "@genesislcap/webpack-builder": "14.418.2",
+    "@genesislcap/foundation-testing": "14.419.1",
+    "@genesislcap/genx": "14.419.1",
+    "@genesislcap/rollup-builder": "14.419.1",
+    "@genesislcap/ts-builder": "14.419.1",
+    "@genesislcap/uvu-playwright-builder": "14.419.1",
+    "@genesislcap/vite-builder": "14.419.1",
+    "@genesislcap/webpack-builder": "14.419.1",
     "@types/dompurify": "^3.0.5",
     "@types/marked": "^5.0.2"
   },
   "dependencies": {
-    "@genesislcap/foundation-ai": "14.418.2",
-    "@genesislcap/foundation-logger": "14.418.2",
-    "@genesislcap/foundation-ui": "14.418.2",
-    "@genesislcap/foundation-utils": "14.418.2",
-    "@genesislcap/rapid-design-system": "14.418.2",
-    "@genesislcap/web-core": "14.418.2",
+    "@genesislcap/foundation-ai": "14.419.1",
+    "@genesislcap/foundation-logger": "14.419.1",
+    "@genesislcap/foundation-ui": "14.419.1",
+    "@genesislcap/foundation-utils": "14.419.1",
+    "@genesislcap/rapid-design-system": "14.419.1",
+    "@genesislcap/web-core": "14.419.1",
     "dompurify": "^3.3.1",
     "marked": "^17.0.3"
   },
@@ -87,5 +92,8 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "ae9a9252a0ca0d35759886db9b502921e3a3e831"
+  "peerDependencies": {
+    "@microsoft/fast-react-wrapper": ">=0.3.0"
+  },
+  "gitHead": "e4880f9a62bd7ebb0a0e4798c8dfdd98de5c6e14"
 }

package/src/components/chat-driver/chat-driver.ts

@@ -25,6 +25,8 @@ export type ChatHistoryUpdatedEvent = CustomEvent<ReadonlyArray<ChatMessage>>;
  *
  * Dispatches `'history-updated'` events on itself so the owning element can observe changes.
  *
+ * @fires history-updated - Fired whenever the in-memory chat history changes (append, tool loop, interaction resolution). `detail` is `ReadonlyArray<ChatMessage>` (the full history snapshot).
+ *
  * @beta
  */
 export class ChatDriver extends EventTarget {

package/src/components/chat-interaction-wrapper/chat-interaction-wrapper.ts

@@ -8,6 +8,12 @@ export type ChatInteractionEventsMap = {
   'interaction-completed': InteractionResult<unknown> & { interactionId: string };
 };
 
+/**
+ * Hosts an interactive AI chat sub-component by tag name.
+ * @public
+ *
+ * @fires interaction-completed - Fired when the interaction finishes
+ */
 @customElement({
   name: 'ai-chat-interaction-wrapper',
   template: AiChatInteractionWrapperTemplate,

package/src/main/main.ts

@@ -40,6 +40,10 @@ avoidTreeShaking(
  * Inject an `AIProvider` through the DI container. Pass agent configuration via the `agents`
  * property. The component creates a `ChatDriver` to manage the conversation loop.
  *
+ * Popout/collapse coordination uses `agenticActivityBus` topics `chat-popout` and `chat-popin` — not DOM `CustomEvent`s on this element.
+ *
+ * @fires chat-header-mousedown - Fired when the user presses the chat header in `popout-mode="expand"` (for drag-to-popout hosts). Bubbles and composed; `detail`: `{ clientX, clientY }`.
+ *
  * @beta
  */
 @customElement({