@luzmo/analytics-components-kit 1.0.5-beta.1 → 1.0.5-beta.2

package/components/ad-hoc-slot-content-BwcFfXCV.cjs

@@ -0,0 +1,20 @@
+/*! * A kit of modern Luzmo Web Components for analytics in your web application.
+ * 
+ * Copyright © 2026 Luzmo
+ * All rights reserved.
+ * Luzmo web components (“Luzmo Web Components”)
+ * must be used according to the Luzmo Terms of Service.
+ * This license allows users with a current active Luzmo account
+ * to use the Luzmo Web Components. This license terminates
+ * automatically if a user no longer has an active Luzmo account.
+ * Please view the Luzmo Terms of Service at: https://www.luzmo.com/information-pages/terms-of-use.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ * */
+const e=require("./type-check-BehV9ZL1.cjs"),t=require("./slot-role-classification-2wChhpcq.cjs");var n=e=>typeof e==`string`&&e.trim().length>0,r=t=>!!(t&&n(t.formula)&&!t.formulaId&&!e.s(t.formula)),i=e=>!!(e&&n(e.expression)&&!e.columnId&&!e.column&&!e.formulaId&&!e.formula),a=e=>i(e)?e?.expression:r(e)?e?.formula:void 0,o=e=>e?.columnId??e?.formulaId??e?.column??e?.formula??e?.expression,s=(e,n)=>i(e)?!0:!e||!r(e)?!1:t.i({slotName:String(n.name??``),slotType:n.type,contentKind:t.r(e)})===`measure`;Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return a}});

package/components/ad-hoc-slot-content-hSlT62VS.js

@@ -0,0 +1,29 @@
+/*! * A kit of modern Luzmo Web Components for analytics in your web application.
+ * 
+ * Copyright © 2026 Luzmo
+ * All rights reserved.
+ * Luzmo web components (“Luzmo Web Components”)
+ * must be used according to the Luzmo Terms of Service.
+ * This license allows users with a current active Luzmo account
+ * to use the Luzmo Web Components. This license terminates
+ * automatically if a user no longer has an active Luzmo account.
+ * Please view the Luzmo Terms of Service at: https://www.luzmo.com/information-pages/terms-of-use.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ * */
+import { s as e } from "./type-check-CGREdneG.js";
+import { i as t, r as n } from "./slot-role-classification-B8bkGhQ_.js";
+//#region src/utils/slot-content/ad-hoc-slot-content.ts
+var r = (e) => typeof e == "string" && e.trim().length > 0, i = (t) => !!(t && r(t.formula) && !t.formulaId && !e(t.formula)), a = (e) => !!(e && r(e.expression) && !e.columnId && !e.column && !e.formulaId && !e.formula), o = (e) => a(e) ? e?.expression : i(e) ? e?.formula : void 0, s = (e) => e?.columnId ?? e?.formulaId ?? e?.column ?? e?.formula ?? e?.expression, c = (e, r) => a(e) ? !0 : !e || !i(e) ? !1 : t({
+	slotName: String(r.name ?? ""),
+	slotType: r.type,
+	contentKind: n(e)
+}) === "measure";
+//#endregion
+export { c as i, s as n, i as r, o as t };

package/components/ai-chat/ai-chat-request.d.ts

@@ -1,6 +1,7 @@
 import type { LuzmoChart } from '../../types';
 import type { AiPromptAgent, AiPromptCreateBody, AiPromptDeleteBody, AiPromptProperties, BuildAiPromptRequestContext } from './ai-prompt-types';
-export type { AiPromptAgent, AiPromptCreateBody, AiPromptDeleteBody, AiPromptInput, AiPromptItemTask, AiPromptProperties, AiPromptScreenMode, BuildAiPromptRequestContext, DashboardStatePayload, LuzmoDashboardGeneratedEventDetail, LuzmoPromptSubmittedEventDetail, LuzmoRestoreRequestedEventDetail } from './ai-prompt-types';
+export type { AiPromptAgent, AiPromptImageInput, AiPromptCreateBody, AiPromptDeleteBody, AiPromptInput, AiPromptItemTask, AiPromptProperties, AiPromptScreenMode, BuildAiPromptRequestContext, DashboardStatePayload, LuzmoDashboardGeneratedEventDetail, LuzmoPromptSubmittedEventDetail, LuzmoRestoreRequestedEventDetail } from './ai-prompt-types';
+export { AI_PROMPT_ACCEPTED_IMAGE_MIME_TYPES, AI_PROMPT_MAX_ATTACHMENTS, assertValidAiPromptAttachmentFiles, assertValidAiPromptAttachmentUrls, isAiPromptAcceptedImageFile, isAiPromptAcceptedImageMimeType, isAiPromptAcceptedImageUrl } from '../../utils/ai-prompt';
 export declare function getAiPromptUrl(apiUrl: string, apiVersion: string): string;
 export declare function chartToItemAsset(chart: LuzmoChart): Record<string, unknown> | null;
 export declare function buildItemAiPromptProperties(ctx: BuildAiPromptRequestContext): AiPromptProperties;

package/components/ai-chat/ai-chat.d.ts

@@ -149,6 +149,16 @@ export declare class LuzmoAiChat extends LuzmoElement {
      * When true, at least one dataset must be selected before the prompt can be submitted
      */
     requireDataset: boolean;
+    /** Enables image attachments (PNG/JPEG/WebP/GIF). */
+    allowImages: boolean;
+    /** Enables mic dictation; audio is transcribed via `POST /aidictation` and inserted as editable text. */
+    allowVoiceInput: boolean;
+    /** Attachment MIME types/extensions. Defaults to PNG/JPEG/WebP/GIF when `allow-images` is set. */
+    acceptedFileTypes: string[];
+    /** Optional upload override; otherwise uploads via `POST /upload` on attach. */
+    uploadAttachments?: (files: File[], options?: {
+        signal?: AbortSignal;
+    }) => Promise<string[]>;
     /**
      * Which aiprompt agent to use. Determines request payload and stream handling.
      * @default 'item'
@@ -247,6 +257,7 @@ export declare class LuzmoAiChat extends LuzmoElement {
     get session(): AiChatSession | null;
     private _getRenderState;
     private _createDomBridgeCallbacks;
+    private get _resolvedAcceptedFileTypes();
     private _buildSessionConfig;
     private _emitConversationIdChanged;
     private _restoreViaSession;

package/components/ai-chat/ai-prompt-types.d.ts

@@ -1,3 +1,4 @@
+import type { PromptBoxAttachment } from '@luzmo/lucero';
 import type { Dataset, LuzmoChart } from '../../types';
 export type AiPromptAgent = 'item' | 'dashboard' | 'analyst';
 export type AiPromptItemTask = 'generate' | 'suggest' | 'describe';
@@ -26,7 +27,11 @@ export interface AiPromptDashboardInput {
     value: DashboardStatePayload;
     current_screen_mode?: AiPromptScreenMode;
 }
-export type AiPromptInput = AiPromptTextInput | AiPromptDatasetInput | AiPromptItemInput | AiPromptDashboardInput;
+export interface AiPromptImageInput {
+    type: 'image';
+    url: string;
+}
+export type AiPromptInput = AiPromptTextInput | AiPromptDatasetInput | AiPromptItemInput | AiPromptDashboardInput | AiPromptImageInput;
 export interface AiPromptProperties {
     agent: AiPromptAgent;
     task: AiPromptItemTask | 'generate';
@@ -71,6 +76,7 @@ export interface BuildAiPromptRequestContext {
     dashboard?: DashboardStatePayload | null;
     currentScreenMode?: AiPromptScreenMode;
     task?: AiPromptItemTask;
+    attachmentUrls?: string[];
 }
 export interface LuzmoPromptSubmittedEventDetail {
     prompt: string;
@@ -80,6 +86,8 @@ export interface LuzmoPromptSubmittedEventDetail {
     request: AiPromptCreateBody;
     url: string;
     signal?: AbortSignal;
+    attachments?: PromptBoxAttachment[];
+    attachmentUrls?: string[];
 }
 export interface LuzmoRestoreRequestedEventDetail {
     apiMessageId: string;

package/components/ai-chat/index.cjs

@@ -17,4 +17,4 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  * */
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../ai-chat-DLDSaC7W.cjs");exports.AiChatSession=e.i,exports.AiChatSessionController=e.r,exports.LuzmoAiChat=e.n,exports.LuzmoAiChatEmptyState=e.T,exports.buildAiPromptDeleteRequest=e._,exports.buildAiPromptProperties=e.v,exports.buildAiPromptRequest=e.y,exports.buildAnalystAiPromptProperties=e.b,exports.buildDashboardAiPromptProperties=e.x,exports.buildItemAiPromptProperties=e.S,exports.chartToItemAsset=e.C,exports.createAiChatSession=e.a,exports.createInitialProgress=e.f,exports.createInitialStreamState=e.o,exports.createStreamHandler=e.s,exports.extractChartFromChunk=e.u,exports.extractDashboardFromChunk=e.d,exports.fetchStreamingResponse=e.m,exports.getAgentStreamDefinition=e.c,exports.getAiPromptUrl=e.w,exports.hasProgressChunk=e.p,exports.isRecognizedStep=e.t,exports.parseStreamLine=e.h,exports.processStreamChunk=e.l,exports.readNdjsonStream=e.g;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../ai-interaction-textarea-BR72djHD.cjs"),t=require("../ai-chat-D9tYu1q6.cjs");exports.AI_PROMPT_ACCEPTED_IMAGE_MIME_TYPES=e.c,exports.AI_PROMPT_MAX_ATTACHMENTS=e.l,exports.AiChatSession=t.i,exports.AiChatSessionController=t.r,exports.LuzmoAiChat=t.n,exports.LuzmoAiChatEmptyState=t.T,exports.assertValidAiPromptAttachmentFiles=e.u,exports.assertValidAiPromptAttachmentUrls=e.d,exports.blobToBase64=e.n,exports.buildAiDictationRequest=e.r,exports.buildAiPromptDeleteRequest=t._,exports.buildAiPromptProperties=t.v,exports.buildAiPromptRequest=t.y,exports.buildAnalystAiPromptProperties=t.b,exports.buildDashboardAiPromptProperties=t.x,exports.buildItemAiPromptProperties=t.S,exports.chartToItemAsset=t.C,exports.createAiChatSession=t.a,exports.createInitialProgress=t.f,exports.createInitialStreamState=t.o,exports.createStreamHandler=t.s,exports.extractChartFromChunk=t.u,exports.extractDashboardFromChunk=t.d,exports.fetchStreamingResponse=t.m,exports.getAgentStreamDefinition=t.c,exports.getAiDictationUrl=e.i,exports.getAiPromptUrl=t.w,exports.getUploadUrl=e.o,exports.hasProgressChunk=t.p,exports.isAiPromptAcceptedImageFile=e.f,exports.isAiPromptAcceptedImageMimeType=e.p,exports.isAiPromptAcceptedImageUrl=e.m,exports.isRecognizedStep=t.t,exports.parseStreamLine=t.h,exports.processStreamChunk=t.l,exports.readNdjsonStream=t.g,exports.streamAiDictation=e.a,exports.uploadAiPromptImages=e.s;

package/components/ai-chat/index.d.ts

@@ -5,6 +5,7 @@ declare global {
     }
 }
 export type { ProgressTreeNode, AssistantMessageAction, AssistantMessageActionConfirmVariant, AssistantMessageActionEventDetail, AiChatMessageSentEventDetail, AiChatDatasetsChangedEventDetail, AiChatConversationIdChangedEventDetail } from '../../types/ai-chat.types';
+export type { PromptBoxAttachment, PromptBoxFileIcons } from '../ai-interaction-textarea';
 export { isRecognizedStep } from './ai-chat-events';
 export type { AiChatCompleteEvent, AiChatRecognizedStepType, AiChatStepBase, AiChatStepEvent, RecognizedStepEvent, UnknownStepEvent } from './ai-chat-events';
 export { AiChatSession, AiChatSessionController, createAiChatSession } from './session';
@@ -15,6 +16,8 @@ export { LuzmoAiChatEmptyState } from './empty-state';
 export type { AiChatEmptyStateSuggestion, AiChatEmptyStateSuggestionSelectedDetail } from './empty-state';
 export * from './ai-prompt-types';
 export * from './ai-chat-request';
+export { getUploadUrl, uploadAiPromptImages, getAiDictationUrl, streamAiDictation, buildAiDictationRequest, blobToBase64 } from '../../utils/ai-prompt';
+export type { UploadAiPromptImagesOptions, AiDictationCreateBody, AiDictationProperties, BuildAiDictationRequestOptions, StreamAiDictationOptions } from '../../utils/ai-prompt';
 export { createInitialProgress, createInitialStreamState, createStreamHandler, extractChartFromChunk, extractDashboardFromChunk, fetchStreamingResponse, getAgentStreamDefinition, hasProgressChunk, parseStreamLine, processStreamChunk, readNdjsonStream } from './stream';
 export type { StreamingRequestOptions, StreamingResponse } from './stream/transport';
 export type { AgentStreamDefinition, StreamHandlerCallbacks, StreamHandlerContext, StreamHandlerState } from './stream';

package/components/ai-chat/index.js

@@ -24,5 +24,6 @@
 		e.setAttribute("data-luzmo-vars", ""), e.textContent = "html{--luzmo-animation-duration: 0.15s;--luzmo-border-color: rgba(var(--luzmo-border-color-rgb), 0.1);--luzmo-border-color-hover: rgba(var(--luzmo-border-color-rgb), 0.15);--luzmo-border-color-down: rgba(var(--luzmo-border-color-rgb), 0.3);--luzmo-border-color-focus: rgba(var(--luzmo-border-color-rgb), 0.15);--luzmo-border-color-rgb: 0, 0, 0;--luzmo-border-color-full: rgb(180, 180, 180);--luzmo-border-color-full-hover: color-mix(in oklch, var(--luzmo-border-color-full), black 25%);--luzmo-border-color-full-down: color-mix(in oklch, var(--luzmo-border-color-full), black 45%);--luzmo-border-color-full-focus: color-mix(in oklch, var(--luzmo-border-color-full), black 25%);--luzmo-border-color-disabled: #dddddd;--luzmo-border-radius: 6px;--luzmo-border-radius-s: 4px;--luzmo-border-radius-l: 8px;--luzmo-border-radius-xl: 12px;--luzmo-border-radius-full: 999rem;--luzmo-background-color: #ffffff;--luzmo-background-color-rgb: 255, 255, 255;--luzmo-background-color-disabled: #eeeeee;--luzmo-background-color-hover: color-mix( in oklch, color-mix(in oklch, var(--luzmo-background-color), var(--luzmo-primary) 5%), black 1.5% );--luzmo-background-color-down: color-mix(in oklch, color-mix(in oklch, var(--luzmo-background-color), var(--luzmo-primary) 7%), black 1%);--luzmo-background-color-focus: color-mix( in oklch, color-mix(in oklch, var(--luzmo-background-color), var(--luzmo-primary) 5%), black 1.5% );--luzmo-background-color-highlight: rgb(240, 240, 240);--luzmo-background-color-highlight-disabled: rgb(245, 245, 245);--luzmo-background-color-highlight-hover: color-mix(in oklch, var(--luzmo-background-color-highlight), black 10%);--luzmo-background-color-highlight-down: color-mix(in oklch, var(--luzmo-background-color-highlight), black 20%);--luzmo-background-color-highlight-focus: color-mix(in oklch, var(--luzmo-background-color-highlight), black 10%);--luzmo-background-color-alt-1: rgb(250, 250, 250);--luzmo-background-color-alt-2: rgb(239, 239, 239);--luzmo-border-width: 1px;--luzmo-font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen-Sans, Ubuntu, Cantarell, 'Helvetica Neue', Helvetica, Arial, sans-serif;--luzmo-font-size-xs: 10px;--luzmo-font-size-s: 12px;--luzmo-font-size-m: 14px;--luzmo-font-size: 14px;--luzmo-font-size-l: 16px;--luzmo-font-size-xl: 18px;--luzmo-font-size-xxl: 20px;--luzmo-font-style: normal;--luzmo-line-height: normal;--luzmo-font-weight: 400;--luzmo-font-weight-semibold: 500;--luzmo-font-weight-bold: 600;--luzmo-font-color: #333;--luzmo-font-color-hard: #000;--luzmo-font-color-disabled: var(--luzmo-color-disabled);--luzmo-font-color-extra-dimmed: #888;--luzmo-font-color-hover: color-mix(in oklch, var(--luzmo-font-color), black 8%);--luzmo-font-color-down: color-mix(in oklch, var(--luzmo-font-color), black 20%);--luzmo-font-color-focus: color-mix(in oklch, var(--luzmo-font-color), black 8%);--luzmo-scrollbar-size: 6px;--luzmo-scrollbar-width: thin;--luzmo-scrollbar-track-background: transparent;--luzmo-scrollbar-track-border-radius: var(--luzmo-border-radius-s);--luzmo-scrollbar-thumb-background: rgba(var(--luzmo-border-color-rgb), 0.3);--luzmo-scrollbar-thumb-border-radius: var(--luzmo-border-radius-s);--luzmo-scrollbar-thumb-hover-background: rgba(var(--luzmo-border-color-rgb), 0.4);--luzmo-primary: #4434ff;--luzmo-primary-hover: color-mix(in oklch, var(--luzmo-primary), black 8%);--luzmo-primary-down: color-mix(in oklch, var(--luzmo-primary), black 20%);--luzmo-primary-focus: color-mix(in oklch, var(--luzmo-primary), black 8%);--luzmo-primary-inverse-color: #ffffff;--luzmo-primary-rgb: 68, 52, 255;--luzmo-secondary: #ff00ff;--luzmo-secondary-hover: color-mix(in oklch, var(--luzmo-secondary), black 8%);--luzmo-secondary-down: color-mix(in oklch, var(--luzmo-secondary), black 20%);--luzmo-secondary-focus: color-mix(in oklch, var(--luzmo-secondary), black 8%);--luzmo-secondary-inverse-color: #ffffff;--luzmo-secondary-rgb: 255, 0, 255;--luzmo-secondary-outline: rgba(255, 0, 255, 0.2);--luzmo-negative-color: #ca221c;--luzmo-negative-color-hover: color-mix(in oklch, var(--luzmo-negative-color), black 8%);--luzmo-negative-color-down: color-mix(in oklch, var(--luzmo-negative-color), black 20%);--luzmo-negative-color-focus: color-mix(in oklch, var(--luzmo-negative-color), black 8%);--luzmo-negative-color-rgb: 202, 34, 28;--luzmo-positive-color: rgb(20, 150, 101);--luzmo-positive-color-hover: color-mix(in oklch, var(--luzmo-positive-color), black 8%);--luzmo-positive-color-down: color-mix(in oklch, var(--luzmo-positive-color), black 20%);--luzmo-positive-color-focus: color-mix(in oklch, var(--luzmo-positive-color), black 8%);--luzmo-positive-color-rgb: 20, 150, 101;--luzmo-selected-color: rgb(110, 110, 110);--luzmo-selected-color-hover: color-mix(in oklch, var(--luzmo-selected-color), black 25%);--luzmo-selected-color-down: color-mix(in oklch, var(--luzmo-selected-color), black 45%);--luzmo-selected-color-focus: color-mix(in oklch, var(--luzmo-selected-color), black 25%);--luzmo-selected-color-hard: #1e1e1e;--luzmo-selected-color-hard-hover: color-mix(in oklch, var(--luzmo-selected-color-hard), black 25%);--luzmo-selected-color-hard-down: color-mix(in oklch, var(--luzmo-selected-color-hard), black 45%);--luzmo-selected-color-hard-focus: color-mix(in oklch, var(--luzmo-selected-color-hard), black 25%);--luzmo-color-informative: #1a77e9;--luzmo-color-informative-rgb: 26, 119, 233;--luzmo-color-disabled: #aaaaaa;--luzmo-spacing-1: 2px;--luzmo-spacing-2: 4px;--luzmo-spacing-3: 8px;--luzmo-spacing-4: 12px;--luzmo-spacing-5: 16px;--luzmo-indicator-gap: 2px;--luzmo-indicator-width: 1px;--luzmo-indicator-color: var(--luzmo-primary);--luzmo-component-height-xxs: 20px;--luzmo-component-height-xs: 24px;--luzmo-component-height-s: 28px;--luzmo-component-height: 32px;--luzmo-component-height-l: 40px;--luzmo-component-height-xl: 48px;--luzmo-component-height-xxl: 64px;--luzmo-icon-size-xxs: 12px;--luzmo-icon-size-xs: 14px;--luzmo-icon-size-s: 16px;--luzmo-icon-size-m: 18px;--luzmo-icon-size-l: 20px;--luzmo-icon-size-xl: 22px;--luzmo-icon-size-xxl: 32px}", document.head.appendChild(e);
 	}
 })();
-import { C as e, S as t, T as n, _ as r, a as i, b as a, c as o, d as s, f as c, g as l, h as u, i as d, l as f, m as p, n as m, o as h, p as g, r as _, s as v, t as y, u as b, v as x, w as S, x as C, y as w } from "../ai-chat-BBc330Jm.js";
-export { d as AiChatSession, _ as AiChatSessionController, m as LuzmoAiChat, n as LuzmoAiChatEmptyState, r as buildAiPromptDeleteRequest, x as buildAiPromptProperties, w as buildAiPromptRequest, a as buildAnalystAiPromptProperties, C as buildDashboardAiPromptProperties, t as buildItemAiPromptProperties, e as chartToItemAsset, i as createAiChatSession, c as createInitialProgress, h as createInitialStreamState, v as createStreamHandler, b as extractChartFromChunk, s as extractDashboardFromChunk, p as fetchStreamingResponse, o as getAgentStreamDefinition, S as getAiPromptUrl, g as hasProgressChunk, y as isRecognizedStep, u as parseStreamLine, f as processStreamChunk, l as readNdjsonStream };
+import { a as e, c as t, d as n, f as r, i, l as a, m as o, n as s, o as c, p as l, r as u, s as d, u as f } from "../ai-interaction-textarea-C-feG2HA.js";
+import { C as p, S as m, T as h, _ as g, a as _, b as v, c as y, d as b, f as x, g as S, h as C, i as w, l as T, m as E, n as D, o as O, p as k, r as A, s as j, t as M, u as N, v as P, w as F, x as I, y as L } from "../ai-chat-DstJ__Jz.js";
+export { t as AI_PROMPT_ACCEPTED_IMAGE_MIME_TYPES, a as AI_PROMPT_MAX_ATTACHMENTS, w as AiChatSession, A as AiChatSessionController, D as LuzmoAiChat, h as LuzmoAiChatEmptyState, f as assertValidAiPromptAttachmentFiles, n as assertValidAiPromptAttachmentUrls, s as blobToBase64, u as buildAiDictationRequest, g as buildAiPromptDeleteRequest, P as buildAiPromptProperties, L as buildAiPromptRequest, v as buildAnalystAiPromptProperties, I as buildDashboardAiPromptProperties, m as buildItemAiPromptProperties, p as chartToItemAsset, _ as createAiChatSession, x as createInitialProgress, O as createInitialStreamState, j as createStreamHandler, N as extractChartFromChunk, b as extractDashboardFromChunk, E as fetchStreamingResponse, y as getAgentStreamDefinition, i as getAiDictationUrl, F as getAiPromptUrl, c as getUploadUrl, k as hasProgressChunk, r as isAiPromptAcceptedImageFile, l as isAiPromptAcceptedImageMimeType, o as isAiPromptAcceptedImageUrl, M as isRecognizedStep, C as parseStreamLine, T as processStreamChunk, S as readNdjsonStream, e as streamAiDictation, d as uploadAiPromptImages };

package/components/ai-chat/session/ai-chat-session-controller.d.ts

@@ -40,6 +40,12 @@ export declare class AiChatSessionController {
      */
     syncProperties(changedProperties: Map<string, unknown>): void;
     requireSession(): AiChatSession;
+    /**
+     * Auth/API props from the element for host-owned sessions.
+     * Skips nullish chart/dashboard/screen mode so host-owned values are not wiped.
+     * Never touches host `fetchStreaming`.
+     */
+    private _mergeHostElementConfig;
     /** Re-attach UI bridge and state subscription after {@link teardown} on reconnect. */
     connect(): void;
     teardown(): void;

package/components/ai-chat/session/ai-chat-session-types.d.ts

@@ -1,4 +1,5 @@
 import type { ProgressTreeNode } from '@luzmo/lucero/progress-steps';
+import type { PromptBoxAttachment } from '@luzmo/lucero';
 import type { AiSampleChart, ChatMessage, Dataset, LuzmoChart } from '../../../types';
 import type { AiChatCompleteEvent, AiChatStepEvent } from '../ai-chat-events';
 import type { AiPromptAgent, AiPromptCreateBody, AiPromptDeleteBody, AiPromptItemTask, AiPromptScreenMode, BuildAiPromptRequestContext, DashboardStatePayload, LuzmoPromptSubmittedEventDetail, LuzmoRestoreRequestedEventDetail } from '../ai-prompt-types';
@@ -60,6 +61,13 @@ export interface AiChatSessionCallbacks {
      * with the same payload shape as the former `luzmo-prompt-submitted` event plus an abort signal. No built-in fetch.
      */
     onPromptSubmitted?: (detail: LuzmoPromptSubmittedEventDetail) => void | Promise<void>;
+    /**
+     * Optional image upload override. When omitted, images upload via `POST /upload`.
+     * Return one signed URL per file (same order).
+     */
+    uploadAttachments?: (files: File[], options?: {
+        signal?: AbortSignal;
+    }) => Promise<string[]>;
     /** Host-owned cleanup hook invoked for user-initiated prompt stops. */
     onPromptStopped?: () => void | Promise<void>;
     /**
@@ -75,6 +83,10 @@ export interface AiChatSessionSubmitParams {
     aiMessageId?: string;
     /** When true, does not append a user message (e.g. `initial-prompt` already in the transcript). */
     skipUserMessage?: boolean;
+    /** Local prompt-box files; uploaded unless `attachmentUrls` is set. */
+    attachments?: PromptBoxAttachment[];
+    /** Signed image URLs already uploaded (`{ type: 'image', url }` inputs). Skips upload. */
+    attachmentUrls?: string[];
 }
 export interface AiChatSessionRestoreParams {
     restoreToMessageId: string;

package/components/ai-chat/session/ai-chat-session.d.ts

@@ -1,3 +1,4 @@
+import type { PromptBoxAttachment } from '@luzmo/lucero';
 import type { Dataset } from '../../../types';
 import type { AiPromptCreateBody, AiPromptDeleteBody, LuzmoPromptSubmittedEventDetail } from '../ai-prompt-types';
 import type { AiChatSessionCallbacks, AiChatSessionConfig, AiChatSessionRestoreParams, AiChatSessionRestoreResult, AiChatSessionState, AiChatSessionSubmitParams } from './ai-chat-session-types';
@@ -53,9 +54,19 @@ export declare class AiChatSession {
     removeDataset(datasetId: string): void;
     isDatasetRequirementMet(): boolean;
     getAiPromptUrl(): string;
-    buildRequestBody(prompt: string, datasetIds: string[]): AiPromptCreateBody;
+    buildRequestBody(prompt: string, datasetIds: string[], attachmentUrls?: string[]): AiPromptCreateBody;
     /** Same payload passed to {@link AiChatSessionCallbacks.onPromptSubmitted}. */
-    buildPromptSubmittedDetail(prompt: string, selectedDatasets: Dataset[], datasetIds: string[], signal?: AbortSignal): LuzmoPromptSubmittedEventDetail;
+    buildPromptSubmittedDetail(params: {
+        prompt: string;
+        selectedDatasets: Dataset[];
+        datasetIds: string[];
+        signal?: AbortSignal;
+        attachments?: PromptBoxAttachment[];
+        attachmentUrls?: string[];
+    }): LuzmoPromptSubmittedEventDetail;
+    /** Prefer provided URLs; otherwise upload via host callback or built-in `/upload`. */
+    private _resolveAttachmentUrls;
+    private _normalizeUploadedUrls;
     /**
      * Append the user prompt (unless `skipUserMessage`), start streaming, and update {@link state}.
      */