@genesislcap/ai-assistant 14.439.2 → 14.441.0

package/dist/ai-assistant.api.json

@@ -4427,6 +4427,36 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#composerHiddenByConfig:member",
+              "docComment": "/**\n * Whether the built-in composer (input row + attachment chips) is hidden by the host's `chatConfig.ui.hideComposer` setting. Used by the template to gate those blocks. Marked `@volatile` because the `'while-splash'` branch reads `showingSplash` only conditionally, so FAST cannot rely on cached dependency tracking.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "get composerHiddenByConfig(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": true,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "composerHiddenByConfig",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#connectedCallback:member(1)",
@@ -6322,6 +6352,77 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#submitMessage:member(1)",
+              "docComment": "/**\n * Programmatically submit a message. Equivalent to the user typing into the built-in composer and pressing send, but callable from external code — most commonly a custom input rendered inside `slot=\"splash\"` when paired with `chatConfig.ui.hideComposer`.\n *\n * The input fully describes the turn: `text` and `files` REPLACE any current composer state (they are not appended to it). Files are validated against `chatConfig.ui.acceptedFiles` using the same pipeline as the composer's attach button.\n *\n * Atomic on validation: if any file fails validation, no attachments are committed and no send is dispatched. Failure messages are returned in `errors` AND appended to the `attachmentErrors` observable so the built-in chip UI still surfaces them when visible.\n *\n * Resolves once the underlying send has been kicked off — it does NOT await the assistant's response.\n *\n * @beta\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "submitMessage(input: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "{\n        text?: string;\n        files?: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "File",
+                  "canonicalReference": "!File:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[];\n    }"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "SubmitMessageResult",
+                  "canonicalReference": "@genesislcap/ai-assistant!SubmitMessageResult:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": ">"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 9
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "input",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "submitMessage"
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#suggestionsState:member",
@@ -8510,6 +8611,78 @@
             "endIndex": 2
           }
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/ai-assistant!SubmitMessageResult:interface",
+          "docComment": "/**\n * Result returned by {@link FoundationAiAssistant.submitMessage}.\n *\n * `ok` is `false` when the assistant is busy, the message is empty, or any supplied file failed validation — in which case no send was dispatched and `errors` lists the reasons.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface SubmitMessageResult "
+            }
+          ],
+          "fileUrlPath": "src/main/main.types.ts",
+          "releaseTag": "Beta",
+          "name": "SubmitMessageResult",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SubmitMessageResult#errors:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "errors: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "errors",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@genesislcap/ai-assistant!SubmitMessageResult#ok:member",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "ok: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "ok",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@genesislcap/ai-assistant!SuggestionsState:type",

package/dist/ai-assistant.d.ts

@@ -927,6 +927,14 @@ export declare class FoundationAiAssistant extends GenesisElement {
      * `'disabled'`.
      */
     get agentPicker(): AgentPickerMode;
+    /**
+     * Whether the built-in composer (input row + attachment chips) is hidden by
+     * the host's `chatConfig.ui.hideComposer` setting. Used by the template to
+     * gate those blocks. Marked `@volatile` because the `'while-splash'` branch
+     * reads `showingSplash` only conditionally, so FAST cannot rely on cached
+     * dependency tracking.
+     */
+    get composerHiddenByConfig(): boolean;
     debugStateFactory?: () => unknown;
     /** When set, enables Redux DevTools for this instance's session store. */
     debugRedux: boolean;
@@ -1243,9 +1251,35 @@ export declare class FoundationAiAssistant extends GenesisElement {
     removeAttachmentError(message: string): void;
     private isAcceptedFile;
     private readFileAsText;
+    private processFiles;
     private loadSelectedFiles;
     handleSendClick(): void;
     handleSuggestionClick(suggestion: string): void;
+    /**
+     * Programmatically submit a message. Equivalent to the user typing into the
+     * built-in composer and pressing send, but callable from external code — most
+     * commonly a custom input rendered inside `slot="splash"` when paired with
+     * `chatConfig.ui.hideComposer`.
+     *
+     * The input fully describes the turn: `text` and `files` REPLACE any current
+     * composer state (they are not appended to it). Files are validated against
+     * `chatConfig.ui.acceptedFiles` using the same pipeline as the composer's
+     * attach button.
+     *
+     * Atomic on validation: if any file fails validation, no attachments are
+     * committed and no send is dispatched. Failure messages are returned in
+     * `errors` AND appended to the `attachmentErrors` observable so the built-in
+     * chip UI still surfaces them when visible.
+     *
+     * Resolves once the underlying send has been kicked off — it does NOT await
+     * the assistant's response.
+     *
+     * @beta
+     */
+    submitMessage(input: {
+        text?: string;
+        files?: File[];
+    }): Promise<SubmitMessageResult>;
     private fetchSuggestions;
     private send;
     onChatHeaderMouseDown(e: MouseEvent): void;
@@ -1588,6 +1622,20 @@ export declare interface StatefulAgentInit<S> {
  */
 export declare const strictFallbackAgent: FallbackAgentConfig;
 
+/**
+ * Result returned by {@link FoundationAiAssistant.submitMessage}.
+ *
+ * `ok` is `false` when the assistant is busy, the message is empty, or any
+ * supplied file failed validation — in which case no send was dispatched and
+ * `errors` lists the reasons.
+ *
+ * @beta
+ */
+export declare interface SubmitMessageResult {
+    ok: boolean;
+    errors: string[];
+}
+
 /**
  * State of the chat suggestions feature.
  *

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

@@ -2,7 +2,7 @@ import { AIProvider } from '@genesislcap/foundation-ai';
 import type { ChatAttachment, ChatConfig, ChatInputDuringExecutionMode, ChatMessage } from '@genesislcap/foundation-ai';
 import { GenesisElement } from '@genesislcap/web-core';
 import type { AgentConfig } from '../config/config';
-import type { AgentPickerMode, AiAssistantAnimation, AiAssistantState, PopoutMode, SuggestionsState } from './main.types';
+import type { AgentPickerMode, AiAssistantAnimation, AiAssistantState, PopoutMode, SubmitMessageResult, SuggestionsState } from './main.types';
 /**
  * Foundation AI Assistant component.
  *
@@ -41,6 +41,14 @@ export declare class FoundationAiAssistant extends GenesisElement {
      * `'disabled'`.
      */
     get agentPicker(): AgentPickerMode;
+    /**
+     * Whether the built-in composer (input row + attachment chips) is hidden by
+     * the host's `chatConfig.ui.hideComposer` setting. Used by the template to
+     * gate those blocks. Marked `@volatile` because the `'while-splash'` branch
+     * reads `showingSplash` only conditionally, so FAST cannot rely on cached
+     * dependency tracking.
+     */
+    get composerHiddenByConfig(): boolean;
     debugStateFactory?: () => unknown;
     /** When set, enables Redux DevTools for this instance's session store. */
     debugRedux: boolean;
@@ -357,9 +365,35 @@ export declare class FoundationAiAssistant extends GenesisElement {
     removeAttachmentError(message: string): void;
     private isAcceptedFile;
     private readFileAsText;
+    private processFiles;
     private loadSelectedFiles;
     handleSendClick(): void;
     handleSuggestionClick(suggestion: string): void;
+    /**
+     * Programmatically submit a message. Equivalent to the user typing into the
+     * built-in composer and pressing send, but callable from external code — most
+     * commonly a custom input rendered inside `slot="splash"` when paired with
+     * `chatConfig.ui.hideComposer`.
+     *
+     * The input fully describes the turn: `text` and `files` REPLACE any current
+     * composer state (they are not appended to it). Files are validated against
+     * `chatConfig.ui.acceptedFiles` using the same pipeline as the composer's
+     * attach button.
+     *
+     * Atomic on validation: if any file fails validation, no attachments are
+     * committed and no send is dispatched. Failure messages are returned in
+     * `errors` AND appended to the `attachmentErrors` observable so the built-in
+     * chip UI still surfaces them when visible.
+     *
+     * Resolves once the underlying send has been kicked off — it does NOT await
+     * the assistant's response.
+     *
+     * @beta
+     */
+    submitMessage(input: {
+        text?: string;
+        files?: File[];
+    }): Promise<SubmitMessageResult>;
     private fetchSuggestions;
     private send;
     onChatHeaderMouseDown(e: MouseEvent): void;

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/dts/main/main.template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.template.d.ts","sourceRoot":"","sources":["../../../src/main/main.template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EAA2B,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAC;AAoIpD,gBAAgB;AAChB,eAAO,MAAM,6BAA6B,GACxC,oBAAoB,MAAM,KACzB,YAAY,CAAC,qBAAqB,CA+epC,CAAC"}
+{"version":3,"file":"main.template.d.ts","sourceRoot":"","sources":["../../../src/main/main.template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EAA2B,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAC;AAoIpD,gBAAgB;AAChB,eAAO,MAAM,6BAA6B,GACxC,oBAAoB,MAAM,KACzB,YAAY,CAAC,qBAAqB,CAkfpC,CAAC"}

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

@@ -13,6 +13,19 @@ export type AiAssistantState = 'idle' | 'loading' | 'error';
  */
 export type PopoutMode = 'expand' | 'collapse';
 export type { AgentPickerMode } from '@genesislcap/foundation-ai';
+/**
+ * Result returned by {@link FoundationAiAssistant.submitMessage}.
+ *
+ * `ok` is `false` when the assistant is busy, the message is empty, or any
+ * supplied file failed validation — in which case no send was dispatched and
+ * `errors` lists the reasons.
+ *
+ * @beta
+ */
+export interface SubmitMessageResult {
+    ok: boolean;
+    errors: string[];
+}
 /**
  * State of the chat suggestions feature.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"main.types.d.ts","sourceRoot":"","sources":["../../../src/main/main.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE/C,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,GAC3C;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;;;;CASwB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,cAAc,CAAC;AAE/D;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAkC,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"main.types.d.ts","sourceRoot":"","sources":["../../../src/main/main.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE/C,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,GAC3C;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;;;;CASwB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,cAAc,CAAC;AAE/D;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAkC,oBAAoB,EAAE,CAAC"}

package/dist/esm/main/main.js

@@ -153,6 +153,22 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
         var _a, _b;
         return (_b = (_a = this.chatConfig.picker) === null || _a === void 0 ? void 0 : _a.mode) !== null && _b !== void 0 ? _b : 'disabled';
     }
+    /**
+     * Whether the built-in composer (input row + attachment chips) is hidden by
+     * the host's `chatConfig.ui.hideComposer` setting. Used by the template to
+     * gate those blocks. Marked `@volatile` because the `'while-splash'` branch
+     * reads `showingSplash` only conditionally, so FAST cannot rely on cached
+     * dependency tracking.
+     */
+    get composerHiddenByConfig() {
+        var _a;
+        const hide = (_a = this.chatConfig.ui) === null || _a === void 0 ? void 0 : _a.hideComposer;
+        if (hide === 'always')
+            return true;
+        if (hide === 'while-splash' && this.showingSplash)
+            return true;
+        return false;
+    }
     get messages() {
         var _a, _b;
         return (_b = (_a = this._sessionRef) === null || _a === void 0 ? void 0 : _a.store.aiAssistant.messages) !== null && _b !== void 0 ? _b : [];
@@ -1201,12 +1217,8 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
             reader.readAsText(file);
         });
     }
-    loadSelectedFiles(e) {
+    processFiles(files) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a;
-            const input = e.target;
-            const files = Array.from((_a = input.files) !== null && _a !== void 0 ? _a : []);
-            input.value = '';
             const results = yield Promise.all(files.map((file) => __awaiter(this, void 0, void 0, function* () {
                 if (!this.isAcceptedFile(file)) {
                     return { ok: false, message: `"${file.name}" is not an accepted file type.` };
@@ -1223,16 +1235,27 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
                     return { ok: false, message: `Failed to read "${file.name}".` };
                 }
             })));
-            const newAttachments = results
-                .filter((r) => r.ok)
-                .map((r) => r.attachment);
-            const newErrors = results
-                .filter((r) => !r.ok)
-                .map((r) => r.message);
-            if (newAttachments.length)
-                this.attachments = [...this.attachments, ...newAttachments];
-            if (newErrors.length)
-                this.attachmentErrors = [...this.attachmentErrors, ...newErrors];
+            return {
+                attachments: results
+                    .filter((r) => r.ok)
+                    .map((r) => r.attachment),
+                errors: results
+                    .filter((r) => !r.ok)
+                    .map((r) => r.message),
+            };
+        });
+    }
+    loadSelectedFiles(e) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const input = e.target;
+            const files = Array.from((_a = input.files) !== null && _a !== void 0 ? _a : []);
+            input.value = '';
+            const { attachments, errors } = yield this.processFiles(files);
+            if (attachments.length)
+                this.attachments = [...this.attachments, ...attachments];
+            if (errors.length)
+                this.attachmentErrors = [...this.attachmentErrors, ...errors];
         });
     }
     handleSendClick() {
@@ -1242,6 +1265,69 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
         this.inputValue = suggestion;
         this.send();
     }
+    /**
+     * Programmatically submit a message. Equivalent to the user typing into the
+     * built-in composer and pressing send, but callable from external code — most
+     * commonly a custom input rendered inside `slot="splash"` when paired with
+     * `chatConfig.ui.hideComposer`.
+     *
+     * The input fully describes the turn: `text` and `files` REPLACE any current
+     * composer state (they are not appended to it). Files are validated against
+     * `chatConfig.ui.acceptedFiles` using the same pipeline as the composer's
+     * attach button.
+     *
+     * Atomic on validation: if any file fails validation, no attachments are
+     * committed and no send is dispatched. Failure messages are returned in
+     * `errors` AND appended to the `attachmentErrors` observable so the built-in
+     * chip UI still surfaces them when visible.
+     *
+     * Resolves once the underlying send has been kicked off — it does NOT await
+     * the assistant's response.
+     *
+     * @beta
+     */
+    submitMessage(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            if (this.state === 'loading') {
+                return { ok: false, errors: ['Assistant is busy'] };
+            }
+            let nextAttachments = [];
+            if ((_a = input.files) === null || _a === void 0 ? void 0 : _a.length) {
+                const { attachments, errors } = yield this.processFiles(input.files);
+                // State may have flipped to 'loading' during the async file processing
+                // (e.g. a concurrent send via the composer). Re-check before committing
+                // any composer state. Beyond this point execution is synchronous up to
+                // `await this.send()`, and `send()` sets `state='loading'` before its
+                // own first await — so no further race window exists.
+                // (Cast widens through TS's narrowing of `this.state` from the earlier
+                // early-return; the getter can return a different value across an await.)
+                if (this.state === 'loading') {
+                    return { ok: false, errors: ['Assistant is busy'] };
+                }
+                if (errors.length) {
+                    this.attachmentErrors = errors;
+                    return { ok: false, errors };
+                }
+                nextAttachments = attachments;
+            }
+            const text = ((_b = input.text) !== null && _b !== void 0 ? _b : '').trim();
+            if (!text && !nextAttachments.length) {
+                return { ok: false, errors: ['Empty message'] };
+            }
+            this.inputValue = text;
+            this.attachments = nextAttachments;
+            this.attachmentErrors = [];
+            try {
+                yield this.send();
+                return { ok: true, errors: [] };
+            }
+            catch (e) {
+                logger.error('submitMessage send failed:', e);
+                return { ok: false, errors: [(_c = e === null || e === void 0 ? void 0 : e.message) !== null && _c !== void 0 ? _c : 'Send failed'] };
+            }
+        });
+    }
     fetchSuggestions() {
         return __awaiter(this, void 0, void 0, function* () {
             var _a;
@@ -1392,6 +1478,9 @@ __decorate([
 __decorate([
     observable
 ], FoundationAiAssistant.prototype, "chatConfig", void 0);
+__decorate([
+    volatile
+], FoundationAiAssistant.prototype, "composerHiddenByConfig", null);
 __decorate([
     observable
 ], FoundationAiAssistant.prototype, "debugStateFactory", void 0);

package/dist/esm/main/main.template.js

@@ -420,7 +420,7 @@ ${(tc) => { var _a; return (((_a = tc.foldPath) === null || _a === void 0 ? void
           `)}
       </div>
 
-      ${when((x) => x.attachments.length > 0 || x.attachmentErrors.length > 0, html `
+      ${when((x) => !x.composerHiddenByConfig && (x.attachments.length > 0 || x.attachmentErrors.length > 0), html `
           <div class="attachment-chips" part="attachment-chips">
             ${repeat((x) => x.attachments, html `
                 <span class="attachment-chip" part="attachment-chip">
@@ -455,7 +455,8 @@ ${(tc) => { var _a; return (((_a = tc.foldPath) === null || _a === void 0 ? void
           ></chat-suggestions>
         `)}
       ${when((x) => x.agentPickerEnabled && x.agentPickerOpen, agentPickerPanelTemplate)}
-      ${when((x) => !(x.state === 'loading' && x.effectiveChatInputDuringExecution === 'hidden'), html `
+      ${when((x) => !x.composerHiddenByConfig &&
+        !(x.state === 'loading' && x.effectiveChatInputDuringExecution === 'hidden'), html `
           <div class="input-row" part="input-row">
             ${when((x) => { var _a; return x.agentPickerEnabled || !!((_a = x.chatConfig.ui) === null || _a === void 0 ? void 0 : _a.acceptedFiles); }, inputLeftControlsTemplate)}
             <${textareaTag}

package/package.json

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

package/src/main/main.template.ts

@@ -554,7 +554,8 @@ ${(tc) => (tc.foldPath?.length ? `${tc.foldPath.join(' › ')} › ` : '')}<stro
       </div>
 
       ${when(
-        (x) => x.attachments.length > 0 || x.attachmentErrors.length > 0,
+        (x) =>
+          !x.composerHiddenByConfig && (x.attachments.length > 0 || x.attachmentErrors.length > 0),
         html<FoundationAiAssistant>`
           <div class="attachment-chips" part="attachment-chips">
             ${repeat(
@@ -602,7 +603,9 @@ ${(tc) => (tc.foldPath?.length ? `${tc.foldPath.join(' › ')} › ` : '')}<stro
       )}
       ${when((x) => x.agentPickerEnabled && x.agentPickerOpen, agentPickerPanelTemplate)}
       ${when(
-        (x) => !(x.state === 'loading' && x.effectiveChatInputDuringExecution === 'hidden'),
+        (x) =>
+          !x.composerHiddenByConfig &&
+          !(x.state === 'loading' && x.effectiveChatInputDuringExecution === 'hidden'),
         html<FoundationAiAssistant>`
           <div class="input-row" part="input-row">
             ${when(

package/src/main/main.ts

@@ -68,6 +68,7 @@ import type {
   AiAssistantAnimation,
   AiAssistantState,
   PopoutMode,
+  SubmitMessageResult,
   SuggestionsState,
 } from './main.types';
 
@@ -182,6 +183,22 @@ export class FoundationAiAssistant extends GenesisElement {
   get agentPicker(): AgentPickerMode {
     return this.chatConfig.picker?.mode ?? 'disabled';
   }
+
+  /**
+   * Whether the built-in composer (input row + attachment chips) is hidden by
+   * the host's `chatConfig.ui.hideComposer` setting. Used by the template to
+   * gate those blocks. Marked `@volatile` because the `'while-splash'` branch
+   * reads `showingSplash` only conditionally, so FAST cannot rely on cached
+   * dependency tracking.
+   */
+  @volatile
+  get composerHiddenByConfig(): boolean {
+    const hide = this.chatConfig.ui?.hideComposer;
+    if (hide === 'always') return true;
+    if (hide === 'while-splash' && this.showingSplash) return true;
+    return false;
+  }
+
   @observable debugStateFactory?: () => unknown;
   /** When set, enables Redux DevTools for this instance's session store. */
   @attr({ attribute: 'debug-redux', mode: 'boolean' }) debugRedux = false;
@@ -1337,11 +1354,9 @@ export class FoundationAiAssistant extends GenesisElement {
     });
   }
 
-  private async loadSelectedFiles(e: Event): Promise<void> {
-    const input = e.target as HTMLInputElement;
-    const files = Array.from(input.files ?? []);
-    input.value = '';
-
+  private async processFiles(
+    files: File[],
+  ): Promise<{ attachments: ChatAttachment[]; errors: string[] }> {
     type FileResult = { ok: true; attachment: ChatAttachment } | { ok: false; message: string };
     const results = await Promise.all(
       files.map(async (file): Promise<FileResult> => {
@@ -1361,15 +1376,23 @@ export class FoundationAiAssistant extends GenesisElement {
       }),
     );
 
-    const newAttachments = results
-      .filter((r): r is Extract<FileResult, { ok: true }> => r.ok)
-      .map((r) => r.attachment);
-    const newErrors = results
-      .filter((r): r is Extract<FileResult, { ok: false }> => !r.ok)
-      .map((r) => r.message);
+    return {
+      attachments: results
+        .filter((r): r is Extract<FileResult, { ok: true }> => r.ok)
+        .map((r) => r.attachment),
+      errors: results
+        .filter((r): r is Extract<FileResult, { ok: false }> => !r.ok)
+        .map((r) => r.message),
+    };
+  }
 
-    if (newAttachments.length) this.attachments = [...this.attachments, ...newAttachments];
-    if (newErrors.length) this.attachmentErrors = [...this.attachmentErrors, ...newErrors];
+  private async loadSelectedFiles(e: Event): Promise<void> {
+    const input = e.target as HTMLInputElement;
+    const files = Array.from(input.files ?? []);
+    input.value = '';
+    const { attachments, errors } = await this.processFiles(files);
+    if (attachments.length) this.attachments = [...this.attachments, ...attachments];
+    if (errors.length) this.attachmentErrors = [...this.attachmentErrors, ...errors];
   }
 
   handleSendClick() {
@@ -1381,6 +1404,69 @@ export class FoundationAiAssistant extends GenesisElement {
     this.send();
   }
 
+  /**
+   * Programmatically submit a message. Equivalent to the user typing into the
+   * built-in composer and pressing send, but callable from external code — most
+   * commonly a custom input rendered inside `slot="splash"` when paired with
+   * `chatConfig.ui.hideComposer`.
+   *
+   * The input fully describes the turn: `text` and `files` REPLACE any current
+   * composer state (they are not appended to it). Files are validated against
+   * `chatConfig.ui.acceptedFiles` using the same pipeline as the composer's
+   * attach button.
+   *
+   * Atomic on validation: if any file fails validation, no attachments are
+   * committed and no send is dispatched. Failure messages are returned in
+   * `errors` AND appended to the `attachmentErrors` observable so the built-in
+   * chip UI still surfaces them when visible.
+   *
+   * Resolves once the underlying send has been kicked off — it does NOT await
+   * the assistant's response.
+   *
+   * @beta
+   */
+  async submitMessage(input: { text?: string; files?: File[] }): Promise<SubmitMessageResult> {
+    if (this.state === 'loading') {
+      return { ok: false, errors: ['Assistant is busy'] };
+    }
+
+    let nextAttachments: ChatAttachment[] = [];
+    if (input.files?.length) {
+      const { attachments, errors } = await this.processFiles(input.files);
+      // State may have flipped to 'loading' during the async file processing
+      // (e.g. a concurrent send via the composer). Re-check before committing
+      // any composer state. Beyond this point execution is synchronous up to
+      // `await this.send()`, and `send()` sets `state='loading'` before its
+      // own first await — so no further race window exists.
+      // (Cast widens through TS's narrowing of `this.state` from the earlier
+      // early-return; the getter can return a different value across an await.)
+      if ((this.state as string) === 'loading') {
+        return { ok: false, errors: ['Assistant is busy'] };
+      }
+      if (errors.length) {
+        this.attachmentErrors = errors;
+        return { ok: false, errors };
+      }
+      nextAttachments = attachments;
+    }
+
+    const text = (input.text ?? '').trim();
+    if (!text && !nextAttachments.length) {
+      return { ok: false, errors: ['Empty message'] };
+    }
+
+    this.inputValue = text;
+    this.attachments = nextAttachments;
+    this.attachmentErrors = [];
+    try {
+      await this.send();
+      return { ok: true, errors: [] };
+    } catch (e) {
+      logger.error('submitMessage send failed:', e);
+      return { ok: false, errors: [(e as Error)?.message ?? 'Send failed'] };
+    }
+  }
+
   private async fetchSuggestions() {
     const suggestionsConfig = this.chatConfig.suggestions;
     if (!this.driver || !suggestionsConfig || suggestionsConfig.behavior === 'never') {

package/src/main/main.types.ts

@@ -16,6 +16,20 @@ export type PopoutMode = 'expand' | 'collapse';
 
 export type { AgentPickerMode } from '@genesislcap/foundation-ai';
 
+/**
+ * Result returned by {@link FoundationAiAssistant.submitMessage}.
+ *
+ * `ok` is `false` when the assistant is busy, the message is empty, or any
+ * supplied file failed validation — in which case no send was dispatched and
+ * `errors` lists the reasons.
+ *
+ * @beta
+ */
+export interface SubmitMessageResult {
+  ok: boolean;
+  errors: string[];
+}
+
 /**
  * State of the chat suggestions feature.
  *