@luzmo/analytics-components-kit 1.0.8 → 1.0.9-beta.1

package/README.md

@@ -15,7 +15,7 @@ ACK produces and edits chart configuration (type, slots, options, filters). It d
 ## Installation
 
 ```bash
-npm install @luzmo/analytics-components-kit lit@^3.3.2 @luzmo/lucero@^2.2.0 @luzmo/icons@^1.0.1-alpha.46
+npm install @luzmo/analytics-components-kit lit@^3.3.2 @luzmo/lucero@^2.2.1 @luzmo/icons@^1.0.1-alpha.46
 ```
 
 ACK uses Lucero 2 for its design-system primitives. Package managers that do not install peer dependencies automatically must install the compatible peer versions explicitly.
@@ -106,9 +106,11 @@ Individual option control editors are also exported for fully custom option UIs:
 
 ### Filters
 
-| Component | Import                                    | Description                             | Reference                                                                         |
-| --------- | ----------------------------------------- | --------------------------------------- | --------------------------------------------------------------------------------- |
-| Filters   | `@luzmo/analytics-components-kit/filters` | Filter editor with nested AND/OR groups | [Docs](https://developer.luzmo.com/guide/ack--components--filters--luzmo-filters) |
+| Component | Import                                    | Description                                                                           | Reference                                                                         |
+| --------- | ----------------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
+| Filters   | `@luzmo/analytics-components-kit/filters` | Filter editor with nested AND/OR groups, plus read-only `text` and `outline` displays | [Docs](https://developer.luzmo.com/guide/ack--components--filters--luzmo-filters) |
+
+`<luzmo-filters display="rich">` (the default) is the editor. `display="text"` renders the same tree as a read-only sentence: the outer group has no parentheses, and a nested AND/OR group that joins more than one filter is wrapped. `display="outline"` renders one wrapping filter per line inside bracket rails. In either read-only display, set `column-display` to `outline`, `subtle`, or `fill` to show column and formula references as Lucero badges one component size smaller (`text` is the default; xs at s, s at m, m at l, l at xl). Override their color with `--luzmo-filters-column-badge-color` and their label/icon color with `--luzmo-filters-column-badge-font-color`. Each outline row has a quiet delete button that emits `luzmo-filters-changed`; `readonly` hides those buttons. In the rich editor, `quiet` removes control chrome while the filters stay editable, and `readonly` keeps that appearance while blocking filter, group, and delete changes. `display="text"` does not emit that event. Hierarchy members stored as ids are resolved to localized names using `content-language`; a member object that already includes `name` is localized without a fetch. While names load, the value shows “1 item” or “N items” with an inline progress spinner. An id that is not returned stays visible, with a tooltip that some names could not be retrieved. Multiple values list the first few names, then a localized “and N more”; overflow uses a dotted underline and a Lucero tooltip.
 
 `<luzmo-filters>` defaults to the standard Luzmo filter format (`ItemFilterGroup[]` from `@luzmo/dashboard-contents-types`). Narrow `luzmo-filters-changed` on `event.detail.format` before forwarding: canonical groups are compatible with `luzmo-embed-viz-item`'s `filters` property and `luzmo-item-grid` items' `filters`; clean groups are for aligned hosts that accept `ItemFilterOutput` / `DashboardFilterOutput`. Group `condition` values are lowercase `and` / `or`. The published `FilterGroup` editor type uses the same casing, so typed consumers must migrate uppercase literals to `and` / `or`. At runtime uppercase `AND` / `OR` input is still accepted and normalized to lowercase on output.
 

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-events.d.ts

@@ -0,0 +1,139 @@
+import type { ProgressTreeNode } from '@luzmo/lucero/progress-steps';
+import type { AiSampleChart, ChatMessage } from '../../types';
+import type { AiPromptAgent, AiPromptCustomItemInput, DashboardStatePayload } from './ai-prompt-types';
+/**
+ * Common fields present on every streamed step event, recognized or not.
+ */
+export interface AiChatStepBase {
+    /** The aiprompt agent that produced this step (`item`, `dashboard`, `analyst`, `custom-item`). */
+    agent: AiPromptAgent;
+    /** Current conversation id, or `null` before the backend assigns one. */
+    conversationId: string | null;
+    /** Backend message id, when the chunk carries one. */
+    messageId?: string;
+    /** Always present — the original stream chunk that produced this step. */
+    raw: Record<string, unknown>;
+}
+/** Recognized stream-step type discriminants. */
+export type AiChatRecognizedStepType = 'decision' | 'text' | 'progress' | 'dashboard-title' | 'dashboard-layout' | 'dashboard-item' | 'chart' | 'custom-item' | 'elicitation' | 'interrupt';
+/**
+ * Stream steps assembled into a typed `data` payload.
+ * Discriminated by `type` (when `recognized` is `true`).
+ */
+export type RecognizedStepEvent = (AiChatStepBase & {
+    recognized: true;
+    type: 'decision';
+    data: {
+        decision: 'create' | 'edit' | 'question';
+    };
+}) | (AiChatStepBase & {
+    recognized: true;
+    type: 'text';
+    data: {
+        delta: string;
+        text: string;
+    };
+}) | (AiChatStepBase & {
+    recognized: true;
+    type: 'progress';
+    data: ProgressTreeNode;
+}) | (AiChatStepBase & {
+    recognized: true;
+    type: 'dashboard-title';
+    data: {
+        name: Record<string, string>;
+    };
+}) | (AiChatStepBase & {
+    recognized: true;
+    type: 'dashboard-layout';
+    data: DashboardStatePayload;
+}) | (AiChatStepBase & {
+    recognized: true;
+    type: 'dashboard-item';
+    data: {
+        slot: number;
+        chart: Record<string, unknown>;
+    };
+}) | (AiChatStepBase & {
+    recognized: true;
+    type: 'chart';
+    data: Record<string, unknown>;
+}) | (AiChatStepBase & {
+    recognized: true;
+    type: 'custom-item';
+    data: AiPromptCustomItemInput['value'];
+}) | (AiChatStepBase & {
+    recognized: true;
+    type: 'elicitation';
+    data: {
+        question: string;
+        options: string[];
+    };
+}) | (AiChatStepBase & {
+    recognized: true;
+    type: 'interrupt';
+    data: {
+        question: string;
+    };
+});
+/**
+ * Stream steps not (yet) modeled. Still delivered so consumers never
+ * silently lose data; `data` is a best-effort payload (often identical to `raw`).
+ */
+export type UnknownStepEvent = AiChatStepBase & {
+    recognized: false;
+    /** Raw chunk `type` / `asset_type`. */
+    type: string;
+    /** Best-effort payload (often `=== raw`). */
+    data: unknown;
+};
+/**
+ * Open union of streamed step events. Use {@link isRecognizedStep} to narrow to
+ * the typed {@link RecognizedStepEvent} set; otherwise inspect `raw`.
+ */
+export type AiChatStepEvent = RecognizedStepEvent | UnknownStepEvent;
+/**
+ * Authoritative final result of a streamed response, fired exactly once.
+ */
+export interface AiChatCompleteEvent {
+    /** The aiprompt agent that produced this result. */
+    agent: AiPromptAgent;
+    /** Conversation id for this response. */
+    conversationId: string | null;
+    /** Final assistant message (text + flags). */
+    message: ChatMessage;
+    /** Authoritative dashboard payload (dashboard agent). */
+    dashboard?: DashboardStatePayload;
+    /** Authoritative chart payload (item agent). */
+    chart?: AiSampleChart;
+    /**
+     * Updated custom item draft (custom-item agent), present only when the agent changed it.
+     * Carries the chart document under `document` plus validation results such as `ok`.
+     */
+    customItem?: AiPromptCustomItemInput['value'];
+    /** Dashboard name keyed by locale (dashboard agent). */
+    name?: Record<string, string>;
+    /** Forward-compat: any final assets not modeled explicitly. */
+    assets?: Record<string, unknown>;
+    /** Present when the response failed. */
+    error?: unknown;
+    /** Original terminal chunk. */
+    raw?: Record<string, unknown>;
+}
+/**
+ * Type guard separating the typed, recognized step set from the open passthrough.
+ * Lets consumers `switch` exhaustively on `event.type` with fully narrowed `data`.
+ *
+ * @example
+ * ```ts
+ * onStep: (event) => {
+ *   if (!isRecognizedStep(event)) return; // forward-compatible: ignore or use event.raw
+ *   switch (event.type) {
+ *     case 'decision':
+ *       // event.data.decision is typed
+ *       break;
+ *   }
+ * };
+ * ```
+ */
+export declare function isRecognizedStep(event: AiChatStepEvent): event is RecognizedStepEvent;

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

@@ -0,0 +1,25 @@
+import type { LuzmoChart } from '../../types';
+import type { AiPromptAgent, AiPromptCreateBody, AiPromptDeleteBody, AiPromptProperties, AiPromptSavedAgentProperties, BuildAiPromptRequestContext } from './ai-prompt-types';
+export type { AiPromptAgent, AiPromptBuiltInAgentProperties, AiPromptImageInput, AiPromptCreateBody, AiPromptDeleteBody, AiPromptInput, AiPromptItemTask, AiPromptProperties, AiPromptPropertiesBase, AiPromptSavedAgentProperties, 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;
+export declare function buildDashboardAiPromptProperties(ctx: BuildAiPromptRequestContext): AiPromptProperties;
+export declare function buildAnalystAiPromptProperties(ctx: BuildAiPromptRequestContext): AiPromptProperties;
+/**
+ * Properties for the custom-item agent, which authors custom chart code. It reads no datasets
+ * and replies in markdown, which the chat renders.
+ */
+export declare function buildCustomItemAiPromptProperties(ctx: BuildAiPromptRequestContext): AiPromptProperties;
+/**
+ * Properties for a saved Agent run. The agent id resolves datasets, capabilities and theme
+ * server-side, so `agent` and `task` are deliberately absent: sending either alongside
+ * `agent_id` is a 400. Chart and dashboard context still travel: a saved Agent runs as the
+ * universal agent, whose planner reads `item` and `dashboard` entries out of the current
+ * input, so dropping them would blind it to what the host is showing.
+ */
+export declare function buildSavedAgentAiPromptProperties(agentId: string, ctx: BuildAiPromptRequestContext): AiPromptSavedAgentProperties;
+export declare function buildAiPromptProperties(agent: AiPromptAgent, ctx: BuildAiPromptRequestContext): AiPromptProperties;
+export declare function buildAiPromptRequest(agent: AiPromptAgent, ctx: BuildAiPromptRequestContext): AiPromptCreateBody;
+export declare function buildAiPromptDeleteRequest(restoreToMessageId: string, authKey: string, authToken: string, apiVersion?: string, conversationId?: string | null): AiPromptDeleteBody;

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

@@ -0,0 +1,347 @@
+import '@luzmo/lucero/button';
+import '@luzmo/lucero/chat-message';
+import '@luzmo/lucero/icon';
+import '@luzmo/lucero/overlay';
+import '@luzmo/lucero/popover';
+import '@luzmo/lucero/progress-steps';
+import { LuzmoElement } from '../../utils/base';
+import { type PropertyValues, TemplateResult } from 'lit';
+import type { ChatMessage, Dataset, LuzmoChart } from '../../types';
+import '../ai-interaction-textarea';
+import type { AiPromptAgent, AiPromptCustomItemInput, AiPromptItemTask, AiPromptScreenMode, DashboardStatePayload } from './ai-prompt-types';
+import type { AiChatAgentConfig } from './types';
+import './empty-state';
+import type { AiChatEmptyStateSuggestion } from './empty-state';
+import type { AiChatSession } from './session/ai-chat-session';
+/**
+ * @customElement luzmo-ai-chat
+ * @summary AI chat UI backed by AiChatSession for transcript, datasets, and streaming.
+ * @description Chat state lives in an AiChatSession. By default the element creates an internal
+ * session from auth, agent, and chart or dashboard props; optional messages and selected-datasets
+ * seed it once on connect. Pass .chatSession for a host-owned session (e.g. dashboard editor).
+ * See {@link AiChatSession} / createAiChatSession for callbacks and external fetchStreaming.
+ * @fires {CustomEvent<AiChatStepEvent>} luzmo-step - Fired for every incremental, kit-assembled event during a streamed response (decision, text, progress, dashboard-title/layout/item, chart, custom-item, elicitation, interrupt, plus forward-by-default unrecognized chunks). Use `isRecognizedStep` to narrow.
+ * @fires {CustomEvent<AiChatCompleteEvent>} luzmo-complete - Fired exactly once per response with the authoritative final result (dashboard/chart/name/customItem) or an `error`.
+ * @fires {CustomEvent<AiChatMessageSentEventDetail>} luzmo-message-sent - Fired when a user sends a message
+ * @fires {CustomEvent<AiChatDatasetsChangedEventDetail>} luzmo-datasets-changed - Fired when the selected datasets change
+ * @fires {CustomEvent<AiChatConversationIdChangedEventDetail>} luzmo-conversation-id-changed - Fired when the conversation ID is updated from the API
+ * @fires {CustomEvent<AssistantMessageActionEventDetail>} luzmo-assistant-message-action - Fired when a built-in assistant message action is activated (after confirmation when `confirm` is set)
+ * @fires {CustomEvent<void>} luzmo-stop - Fired when an in-flight prompt is stopped
+ *
+ * Custom actions beyond built-in `ChatMessage.actions` buttons can be projected via the
+ * `assistant-message-actions` light-DOM slot on the latest assistant message.
+ * @property {string} --luzmo-ai-chat-background - Background of the chat container
+ * @property {string} --luzmo-ai-chat-border-radius - Border radius of the chat container
+ * @property {string} --luzmo-ai-chat-padding - Padding of the chat container
+ * @property {string} --luzmo-ai-chat-gap - Gap between chat sections and messages
+ * @property {string} --luzmo-ai-chat-border - Border of the chat container
+ * @property {string} --luzmo-ai-chat-box-shadow - Box shadow of the chat container
+ * @property {string} --luzmo-ai-chat-scrollbar-width - Width of the messages scrollbar
+ * @property {string} --luzmo-ai-chat-scrollbar-track-background - Background of the messages scrollbar track
+ * @property {string} --luzmo-ai-chat-scrollbar-track-border-radius - Border radius of the messages scrollbar track
+ * @property {string} --luzmo-ai-chat-scrollbar-thumb-background - Background of the messages scrollbar thumb
+ * @property {string} --luzmo-ai-chat-scrollbar-thumb-border-radius - Border radius of the messages scrollbar thumb
+ * @property {string} --luzmo-ai-chat-scrollbar-thumb-hover-background - Hover background of the messages scrollbar thumb
+ * @property {string} --luzmo-ai-chat-loading-message-color - Color of the loading spinner icon
+ * @property {string} --luzmo-ai-chat-loading-message-icon-font-size - Font size of the loading spinner icon
+ * @property {string} --luzmo-ai-chat-error-message-color - Color of assistant error messages
+ * @property {string} --luzmo-ai-chat-context-menu-trigger-size - Size of the assistant context menu trigger button
+ * @property {string} --luzmo-ai-chat-context-menu-trigger-border-color - Border color of the context menu trigger button
+ * @property {string} --luzmo-ai-chat-context-menu-trigger-border-radius - Border radius of the context menu trigger button
+ * @property {string} --luzmo-ai-chat-context-menu-trigger-background - Background of the context menu trigger button
+ * @property {string} --luzmo-ai-chat-context-menu-trigger-color - Icon color of the context menu trigger button
+ * @property {string} --luzmo-ai-chat-context-menu-trigger-hover-background - Hover background of the context menu trigger button
+ * @property {string} --luzmo-ai-chat-context-menu-trigger-hover-border-color - Hover border color of the context menu trigger button
+ * @property {string} --luzmo-ai-chat-context-menu-trigger-hover-color - Hover icon color of the context menu trigger button
+ * @property {string} --luzmo-ai-chat-context-menu-item-font-family - Font family of context menu items
+ * @property {string} --luzmo-ai-chat-context-menu-item-hover-background - Hover background of context menu items
+ * @property {string} --luzmo-ai-chat-markdown-line-height - Line height of rendered assistant markdown
+ * @property {string} --luzmo-ai-chat-markdown-spacing - Bottom spacing between markdown blocks (paragraphs, lists, tables, etc.)
+ * @property {string} --luzmo-ai-chat-markdown-heading-spacing - Top spacing above markdown headings (and `hr` margins)
+ * @property {string} --luzmo-ai-chat-markdown-heading-font-weight - Font weight of markdown headings
+ * @property {string} --luzmo-ai-chat-markdown-list-indent - Inline start padding (indent) of markdown lists
+ * @property {string} --luzmo-ai-chat-markdown-link-color - Color of links in markdown
+ * @property {string} --luzmo-ai-chat-markdown-code-font-family - Font family of inline and block code
+ * @property {string} --luzmo-ai-chat-markdown-code-font-size - Font size of inline and block code
+ * @property {string} --luzmo-ai-chat-markdown-code-background - Background of inline code and code blocks
+ * @property {string} --luzmo-ai-chat-markdown-code-border-radius - Border radius of inline code and code blocks
+ * @property {string} --luzmo-ai-chat-markdown-border-color - Border color for blockquotes, horizontal rules, and tables
+ * @property {string} --luzmo-ai-chat-markdown-table-header-background - Background of markdown table header cells
+ * @property {string} --luzmo-ai-chat-assistant-message-actions-gap - Gap between controls in the assistant message actions footer
+ * @property {string} --luzmo-ai-chat-assistant-message-actions-margin-top - Top spacing above the assistant message actions footer
+ * @property {string} --luzmo-ai-chat-assistant-message-actions-color - Text color for assistant message actions footer content (default: `--luzmo-font-color-extra-dimmed`)
+ * @property {string} --luzmo-ai-chat-assistant-message-actions-font-style - Font style for plain text in the assistant message actions footer (default: `italic`)
+ * @property {string} --luzmo-ai-chat-assistant-message-font-family - Font family shared by assistant messages and their actions footer
+ * @property {string} --luzmo-ai-chat-assistant-message-font-size - Font size shared by assistant messages and their actions footer
+ * @property {string} --luzmo-ai-chat-assistant-message-line-height - Line height shared by assistant messages and their actions footer
+ */
+export declare class LuzmoAiChat extends LuzmoElement {
+    static styles: import("lit").CSSResult;
+    static tagName: string;
+    /** Light-DOM slot for optional custom actions below the latest assistant message. */
+    static readonly assistantMessageActionsSlot = "assistant-message-actions";
+    /**
+     * Live transcript is {@link AiChatSessionState.messages}. This prop optionally seeds the session on first connect.
+     */
+    messages: ChatMessage[];
+    /**
+     * Live selection is in the session. This prop optionally seeds on first connect.
+     */
+    selectedDatasets: Dataset[];
+    /**
+     * Placeholder text for the textarea
+     */
+    placeholder: string;
+    /**
+     * When true, disables the entire chat interface
+     */
+    disabled: boolean;
+    /**
+     * When true, shows a stop control on the prompt input while a response is generating
+     */
+    stoppable: boolean;
+    /**
+     * When true, shows context menu (3 dots) on assistant messages
+     */
+    showAssistantContextMenu: boolean;
+    /**
+     * Auth key for DataBroker authentication
+     */
+    authKey: string;
+    /**
+     * Auth token for DataBroker authentication
+     */
+    authToken: string;
+    /**
+     * API URL for DataBroker
+     * @default https://api.luzmo.com
+     */
+    apiUrl: string;
+    /**
+     * The URL of the app server for thumbnails and assets
+     * @default https://app.luzmo.com
+     */
+    appServer: string;
+    /** When true, shows public datasets alongside the user's other datasets. */
+    includePublicDatasets: boolean;
+    /**
+     * Alias for includePublicDatasets.
+     * @deprecated Use includePublicDatasets instead.
+     */
+    get flagOpendata(): boolean;
+    set flagOpendata(value: boolean);
+    /**
+     * When true, hides the "+ Add dataset" button in the input
+     */
+    hideDatasetButton: boolean;
+    /**
+     * When true, hides dataset icons in the input dataset selector and @ mention dataset headers
+     */
+    hideDatasetIcons: boolean;
+    /**
+     * When true, hides the add-dataset button and disables removing selected datasets while keeping pills visible
+     */
+    disableDatasetModification: boolean;
+    /**
+     * When true, hides the dataset row and add-dataset button entirely
+     */
+    hideSelectedDatasets: boolean;
+    /**
+     * When true, hides the Agents section in the input and runs prompts without a picked agent
+     */
+    hideAgents: boolean;
+    /**
+     * When true, disables @ trigger mentions for dataset fields in the input
+     */
+    disableColumnMentions: boolean;
+    /**
+     * When true, a picked agent or at least one selected dataset is required 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 (`item`, `dashboard`, `analyst` or `custom-item`). Determines request
+     * payload and stream handling. With `agent-id` set it no longer shapes the request payload, only stream handling.
+     * Custom-item hosts must set `hide-agents` and leave `agent-id` unset to preserve draft context
+     * and internal repair prompts.
+     * @default 'item'
+     */
+    agent: AiPromptAgent;
+    /**
+     * Typed agent selection and context. Takes precedence over legacy agent, task and context properties.
+     * Omit context to preserve the same agent's session context; use null to clear it.
+     * Undefined leaves a host session's typed configuration intact and uses legacy properties for an internal session.
+     */
+    agentConfig?: AiChatAgentConfig;
+    /**
+     * Saved Agent id (UUID) to run the prompt as. An agent picked in the prompt box takes precedence for that prompt.
+     */
+    agentId?: string;
+    /**
+     * Task for the item agent (`generate`, `suggest`, `describe`). Ignored when `agent-id` is set.
+     * @default 'generate'
+     */
+    task: AiPromptItemTask;
+    /**
+     * AI model preference for item agent chart generation
+     * @default 'performance'
+     */
+    modelPreference: 'performance' | 'quality';
+    /**
+     * Host-owned {@link AiChatSession}. The component subscribes and renders; does not abort on disconnect.
+     */
+    chatSession: AiChatSession | null;
+    /**
+     * Conversation ID (synced into the session; updated when the API returns a new id).
+     * @default null
+     */
+    conversationId: string | null;
+    /**
+     * Chart context for `agent="item"`.
+     * @default null
+     */
+    chart: LuzmoChart | null;
+    /**
+     * Dashboard context for `agent="dashboard"`.
+     * @default null
+     */
+    dashboard: DashboardStatePayload | null;
+    /**
+     * Draft context for `agent="custom-item"`, sent as its `custom-item` input. The host owns the
+     * shape: the chart document under `document`, plus fields such as `chartId`.
+     * With a host `chatSession`, the default null preserves its draft. Once this element supplies
+     * a draft, setting this property to null clears the session's custom item context.
+     * @default null
+     */
+    customItem: AiPromptCustomItemInput['value'] | null;
+    /**
+     * Current screen mode when editing a dashboard.
+     */
+    currentScreenMode?: AiPromptScreenMode;
+    /**
+     * Locale ID sent to the aiprompt API.
+     */
+    localeId?: string;
+    /**
+     * Timezone ID for dashboard agent requests.
+     * @default 'UTC'
+     */
+    timezoneId: string;
+    /**
+     * API version
+     * @default '0.1.0'
+     */
+    apiVersion: string;
+    /**
+     * When true, uses NDJSON streaming for AI responses.
+     * When false, uses a single JSON response.
+     * @default true
+     */
+    stream: boolean;
+    /**
+     * Loading message shown while generating and before progress steps are available.
+     * @default null
+     */
+    loadingMessage: string | null;
+    /**
+     * Message shown in place of the assistant reply when the user stops an in-flight response.
+     * Falls back to a localized default when not set.
+     * @default null
+     */
+    cancelledMessage: string | null;
+    /**
+     * When set, auto-submits via the session without adding a duplicate user message
+     * (assumes the prompt is already in the transcript).
+     * @default null
+     */
+    initialPrompt: string | null;
+    /**
+     * Title for the empty state when there are no messages.
+     */
+    emptyStateTitle: string;
+    /**
+     * Optional label above empty-state suggestion chips. Only shown when `emptyStateSuggestions` is non-empty.
+     */
+    emptyStateSubtitle: string;
+    /**
+     * Optional suggestion chips for the empty state. When empty, only the title is shown.
+     * Each entry may include `selectedDatasets` to pre-select datasets when the chip is activated.
+     */
+    emptyStateSuggestions: AiChatEmptyStateSuggestion[];
+    private _textareaValue;
+    private _assistantMessageActionsSlotHasContent;
+    private _pendingAssistantMessageAction;
+    private _shouldFocusAssistantMessageActionConfirm;
+    private _lastProcessedInitialPrompt;
+    private readonly _session;
+    /** Active {@link AiChatSession} (host or auto-created). Null until first bind or action. */
+    get session(): AiChatSession | null;
+    private _getRenderState;
+    private _createDomBridgeCallbacks;
+    private get _pickedAgentId();
+    private get _resolvedAcceptedFileTypes();
+    private _buildSessionConfig;
+    private _getAgentConfig;
+    private _emitConversationIdChanged;
+    private _restoreViaSession;
+    private _handleRestoreState;
+    private _handleDatasetSelected;
+    private _handleDatasetRemoved;
+    private _handleAgentSelected;
+    private _submitViaSession;
+    private _handlePromptSubmitted;
+    private _handlePromptStopped;
+    private _handleEmptyStateSuggestionSelected;
+    private _processInitialPrompt;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private _scrollToBottom;
+    protected willUpdate(changedProperties: PropertyValues): void;
+    protected updated(changedProperties: Map<string, unknown>): void;
+    private _syncSession;
+    private _handleInitialPromptChange;
+    /**
+     * Parses assistant markdown into HTML and sanitizes it to prevent XSS attacks
+     * while preserving safe formatting (headings, lists, tables, code, links).
+     * @param markdownContent - The markdown string returned by the assistant
+     * @returns Sanitized HTML string safe for rendering
+     */
+    private _renderMarkdown;
+    private _renderProgress;
+    private _isLastAiMessageWithProgress;
+    private _syncAssistantMessageActionsVisibility;
+    private _handleAssistantMessageActionsSlotChange;
+    private _setAssistantMessageActionsSlotHasContent;
+    private _isLatestAssistantMessage;
+    private _hasBuiltInAssistantMessageActions;
+    private _assistantMessageActionsFooterHasContent;
+    private _syncPendingAssistantMessageAction;
+    private _getDefaultAssistantMessageActionConfirmMessage;
+    private _isAssistantMessageActionConfirming;
+    private _getPendingAssistantMessageAction;
+    private _handleAssistantMessageAction;
+    private _handleAssistantMessageActionClick;
+    private _cancelAssistantMessageActionConfirm;
+    private _confirmAssistantMessageAction;
+    private _handleAssistantMessageActionConfirmKeydown;
+    private _focusPendingAssistantMessageActionConfirm;
+    private _renderBuiltInAssistantMessageAction;
+    private _renderAssistantMessageActionConfirm;
+    private _renderAssistantMessageActions;
+    private _renderRestoreMenu;
+    private _renderMessages;
+    private _handleElicitationSubmit;
+    private _renderStreamingResponse;
+    private _renderLoadingMessage;
+    private _renderEmptyState;
+    protected render(): TemplateResult;
+}