@genesislcap/ai-assistant 14.483.3-alpha-7a2e689.0 → 14.484.0

package/custom-elements-manifest.config.js

@@ -0,0 +1,14 @@
+module.exports = {
+  /** Globs to analyze */
+  globs: ['src/**/*.ts'],
+  /** Directory to output CEM to */
+  outdir: './dist',
+  /** Run in dev mode, provides extra logging */
+  dev: false,
+  /** Enable special handling for FastElement */
+  fast: true,
+  /** Include third party custom elements manifests */
+  dependencies: true,
+  /** Output CEM path to `package.json`, defaults to true */
+  packagejson: true,
+};

package/dist/ai-assistant.api.json

@@ -125,6 +125,11 @@
         {
           "tagName": "@preapproved",
           "syntaxKind": "modifier"
+        },
+        {
+          "tagName": "@fires",
+          "syntaxKind": "block",
+          "allowMultiple": true
         }
       ],
       "supportForTags": {
@@ -155,7 +160,8 @@
         "@virtual": true,
         "@betaDocumentation": true,
         "@internalRemarks": true,
-        "@preapproved": true
+        "@preapproved": true,
+        "@fires": true
       },
       "reportUnsupportedHtmlElements": false
     }
@@ -1034,7 +1040,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@genesislcap/ai-assistant!AgentPicker:class",
-          "docComment": "/**\n * User-facing agent picker rendered above the chat input.\n *\n * Renders `Auto` plus each top-level agent that has `manualSelection.enabled`. Sub-agents and non-selectable specialists are excluded. Hidden when fewer than two agents are configured or none are manually selectable.\n *\n * @fires agent-pinned - Fired when the user changes selection. `detail` is the agent name (string) or `null` for Auto.\n *\n * @beta\n */\n",
+          "docComment": "/**\n * User-facing agent picker rendered above the chat input.\n *\n * Renders `Auto` plus each top-level agent that has `manualSelection.enabled`. Sub-agents and non-selectable specialists are excluded. Hidden when fewer than two agents are configured or none are manually selectable.\n *\n * @fires\n *\n * agent-pinned - Fired when the user changes selection with the agent name or `null` for Auto. detail: `string | null`\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -3553,7 +3559,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 * @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",
+          "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\n *\n * history-updated - Fired whenever the in-memory chat history changes (append, tool loop, interaction resolution) with the full history snapshot. detail: `ReadonlyArray<ChatMessage>`\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -4841,6 +4847,78 @@
             }
           ]
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/ai-assistant!ChatHeaderMousedownEventDetail:interface",
+          "docComment": "/**\n * Detail payload for the `chat-header-mousedown` event fired by the assistant in `popout-mode=\"expand\"`.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface ChatHeaderMousedownEventDetail "
+            }
+          ],
+          "fileUrlPath": "src/main/main.types.ts",
+          "releaseTag": "Beta",
+          "name": "ChatHeaderMousedownEventDetail",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatHeaderMousedownEventDetail#clientX:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "clientX: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "clientX",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!ChatHeaderMousedownEventDetail#clientY:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "clientY: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "clientY",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@genesislcap/ai-assistant!ChatHistoryUpdatedEvent:type",
@@ -5504,7 +5582,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant:class",
-          "docComment": "/**\n * Foundation AI Assistant component.\n *\n * @remarks\n *\n * Register one or more AI providers via `registerAIProviders` from `@genesislcap/foundation-ai`; this element resolves the `AIProviderRegistry` through the DI container. Pass agent configuration via the `agents` property — each agent can override which registered provider it uses via `provider:`. The component creates a `ChatDriver` (single agent) or `OrchestratingDriver` (multiple agents) 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 * **Cost build history:** opt-in via `chatConfig.costHistory.enabled`. When enabled, finalized sessions persist in `localStorage` (scoped by `costHistory.scope`, the element `id`, or `'default'`). Snapshots run on tab close and when the session title changes; hosts may call {@link FoundationAiAssistant.finalizeCostSession}.\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",
+          "docComment": "/**\n * Foundation AI Assistant component.\n *\n * @remarks\n *\n * Register one or more AI providers via `registerAIProviders` from `@genesislcap/foundation-ai`; this element resolves the `AIProviderRegistry` through the DI container. Pass agent configuration via the `agents` property — each agent can override which registered provider it uses via `provider:`. The component creates a `ChatDriver` (single agent) or `OrchestratingDriver` (multiple agents) 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 * **Cost build history:** opt-in via `chatConfig.costHistory.enabled`. When enabled, finalized sessions persist in `localStorage` (scoped by `costHistory.scope`, the element `id`, or `'default'`). Snapshots run on tab close and when the session title changes; hosts may call {@link FoundationAiAssistant.finalizeCostSession}.\n *\n * @fires\n *\n * chat-header-mousedown - Fired when the user presses the chat header in `popout-mode=\"expand\"` (for drag-to-popout hosts). Bubbles and composed. detail: `ChatHeaderMousedownEventDetail`\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -10668,6 +10746,37 @@
           "parameters": [],
           "name": "getAiPopoutManager"
         },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@genesislcap/ai-assistant!InteractionCompletedEventDetail:type",
+          "docComment": "/**\n * Detail payload for the `interaction-completed` event.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type InteractionCompletedEventDetail = "
+            },
+            {
+              "kind": "Reference",
+              "text": "ChatInteractionEventsMap",
+              "canonicalReference": "@genesislcap/ai-assistant!~ChatInteractionEventsMap:type"
+            },
+            {
+              "kind": "Content",
+              "text": "['interaction-completed']"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/components/chat-interaction-wrapper/chat-interaction-wrapper.ts",
+          "releaseTag": "Public",
+          "name": "InteractionCompletedEventDetail",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 3
+          }
+        },
         {
           "kind": "Function",
           "canonicalReference": "@genesislcap/ai-assistant!isAiAssistantDocked:function(1)",

package/dist/ai-assistant.d.ts

@@ -226,8 +226,8 @@ export declare interface AgentLifecycleContext {
  * Sub-agents and non-selectable specialists are excluded. Hidden when fewer
  * than two agents are configured or none are manually selectable.
  *
- * @fires agent-pinned - Fired when the user changes selection. `detail` is the
- *   agent name (string) or `null` for Auto.
+ * @fires agent-pinned - Fired when the user changes selection with the
+ *   agent name or `null` for Auto. detail: `string | null`
  *
  * @beta
  */
@@ -762,7 +762,7 @@ export declare type CachePolicyInput = CachePolicy | ((ctx: SystemPromptContext)
  *
  * 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).
+ * @fires history-updated - Fired whenever the in-memory chat history changes (append, tool loop, interaction resolution) with the full history snapshot. detail: `ReadonlyArray<ChatMessage>`
  *
  * @beta
  */
@@ -1329,6 +1329,16 @@ export declare class ChatDriver extends EventTarget implements AiDriver {
     private appendToHistory;
 }
 
+/**
+ * Detail payload for the `chat-header-mousedown` event fired by the assistant
+ * in `popout-mode="expand"`.
+ * @beta
+ */
+export declare interface ChatHeaderMousedownEventDetail {
+    clientX: number;
+    clientY: number;
+}
+
 /**
  * Event emitted when the chat history is updated (new message appended).
  *
@@ -1338,6 +1348,12 @@ export declare type ChatHistoryUpdatedEvent = CustomEvent<ReadonlyArray<ChatMess
 
 export { ChatInputDuringExecutionMode }
 
+declare type ChatInteractionEventsMap = {
+    'interaction-completed': InteractionResult<unknown> & {
+        interactionId: string;
+    };
+};
+
 export { ChatToolChoice }
 
 /** A model used during a finalized cost session. */
@@ -1519,7 +1535,7 @@ export declare interface FallbackAgentConfig extends BaseAgentConfig {
  * element `id`, or `'default'`). Snapshots run on tab close and when the session
  * title changes; hosts may call {@link FoundationAiAssistant.finalizeCostSession}.
  *
- * @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 }`.
+ * @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: `ChatHeaderMousedownEventDetail`
  *
  * @beta
  */
@@ -2232,6 +2248,12 @@ declare interface InputOverride {
     mode: ChatInputDuringExecutionMode;
 }
 
+/**
+ * Detail payload for the `interaction-completed` event.
+ * @public
+ */
+export declare type InteractionCompletedEventDetail = ChatInteractionEventsMap['interaction-completed'];
+
 /** True when the collapse-mode assistant is active in the layout panel. */
 export declare function isAiAssistantDocked(): boolean;