@luzmo/analytics-components-kit 1.0.5 → 1.0.6

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

@@ -1,123 +0,0 @@
-import type { ProgressTreeNode } from '@luzmo/lucero/progress-steps';
-import type { AiSampleChart, ChatMessage } from '../../types';
-import type { AiPromptAgent, 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`). */
-    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' | '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: '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;
-    /** 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

@@ -1,20 +0,0 @@
-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 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

@@ -1,318 +0,0 @@
-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, AiPromptItemTask, AiPromptScreenMode, DashboardStatePayload } from './ai-prompt-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, 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) 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, restricts results to public datasets (opendata parity)
-     */
-    flagOpendata: 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, disables @ trigger mentions for dataset fields in the input
-     */
-    disableColumnMentions: boolean;
-    /**
-     * 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.
-     * With `agent-id` set it no longer shapes the request payload, only stream handling.
-     * @default 'item'
-     */
-    agent: AiPromptAgent;
-    /**
-     * Saved Agent id (UUID) to run the prompt as.
-     */
-    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;
-    /**
-     * 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 _resolvedAcceptedFileTypes();
-    private _buildSessionConfig;
-    private _emitConversationIdChanged;
-    private _restoreViaSession;
-    private _handleRestoreState;
-    private _handleDatasetSelected;
-    private _handleDatasetRemoved;
-    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 _renderStreamingResponse;
-    private _renderLoadingMessage;
-    private _renderEmptyState;
-    protected render(): TemplateResult;
-}

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

@@ -1,118 +0,0 @@
-import type { PromptBoxAttachment } from '@luzmo/lucero';
-import type { Dataset, LuzmoChart } from '../../types';
-export type AiPromptAgent = 'item' | 'dashboard' | 'analyst';
-export type AiPromptItemTask = 'generate' | 'suggest' | 'describe';
-export type AiPromptScreenMode = 'desktop' | 'tablet' | 'mobile';
-/** Dashboard payload for `agent: 'dashboard'` input (views, syncScreenModes, optional theme). */
-export interface DashboardStatePayload {
-    views: unknown[];
-    syncScreenModes?: boolean;
-    theme?: Record<string, unknown>;
-    [key: string]: unknown;
-}
-export interface AiPromptTextInput {
-    type: 'text';
-    text: string;
-}
-export interface AiPromptDatasetInput {
-    type: 'dataset';
-    id: string;
-}
-export interface AiPromptItemInput {
-    type: 'item';
-    value: Record<string, unknown>;
-}
-export interface AiPromptDashboardInput {
-    type: 'dashboard';
-    value: DashboardStatePayload;
-    current_screen_mode?: AiPromptScreenMode;
-}
-export interface AiPromptImageInput {
-    type: 'image';
-    url: string;
-}
-export type AiPromptInput = AiPromptTextInput | AiPromptDatasetInput | AiPromptItemInput | AiPromptDashboardInput | AiPromptImageInput;
-/** Fields both aiprompt create shapes share, whichever agent selector is used. */
-export interface AiPromptPropertiesBase {
-    conversation_id?: string;
-    locale_id?: string;
-    timezone_id?: string;
-    stream: boolean;
-    response_mode: 'mixed';
-    input: AiPromptInput[];
-}
-/** Built-in agent request: `agent` (plus `task`) selects the server-side behaviour. */
-export interface AiPromptBuiltInAgentProperties extends AiPromptPropertiesBase {
-    agent: AiPromptAgent;
-    task: AiPromptItemTask | 'generate';
-    agent_id?: never;
-}
-/**
- * Saved Agent request: the agent id resolves datasets, capabilities and theme server-side.
- * `agent_id` combined with `agent`, `task` or `capabilities` is a 400 — it is strictly one or the other.
- */
-export interface AiPromptSavedAgentProperties extends AiPromptPropertiesBase {
-    agent_id: string;
-    agent?: never;
-    task?: never;
-}
-export type AiPromptProperties = AiPromptBuiltInAgentProperties | AiPromptSavedAgentProperties;
-export interface AiPromptCreateBody {
-    key: string;
-    token: string;
-    action: 'create';
-    version: string;
-    properties: AiPromptProperties;
-}
-export interface AiPromptDeleteBody {
-    key: string;
-    token: string;
-    action: 'delete';
-    version: string;
-    properties: {
-        agent: 'item';
-        restore_to_message_id: string;
-        conversation_id?: string;
-    };
-}
-export interface BuildAiPromptRequestContext {
-    prompt: string;
-    datasetIds: string[];
-    authKey: string;
-    authToken: string;
-    conversationId: string | null;
-    agentId?: string;
-    apiVersion?: string;
-    stream?: boolean;
-    localeId?: string;
-    timezoneId?: string;
-    /** Session/UI preference only; not serialized on aiprompt create until the backend supports it. */
-    modelPreference?: 'performance' | 'quality';
-    chart?: LuzmoChart | null;
-    dashboard?: DashboardStatePayload | null;
-    currentScreenMode?: AiPromptScreenMode;
-    task?: AiPromptItemTask;
-    attachmentUrls?: string[];
-}
-export interface LuzmoPromptSubmittedEventDetail {
-    prompt: string;
-    selectedDatasets: Dataset[];
-    datasetIds: string[];
-    agent: AiPromptAgent;
-    request: AiPromptCreateBody;
-    url: string;
-    signal?: AbortSignal;
-    attachments?: PromptBoxAttachment[];
-    attachmentUrls?: string[];
-}
-export interface LuzmoRestoreRequestedEventDetail {
-    apiMessageId: string;
-    messageIndex: number;
-    request: AiPromptDeleteBody;
-    url: string;
-}
-export interface LuzmoDashboardGeneratedEventDetail {
-    dashboard: DashboardStatePayload;
-    conversationId: string | null;
-    name?: Record<string, string>;
-}

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

@@ -1,46 +0,0 @@
-import '@luzmo/lucero/action-button';
-import { LuzmoElement } from '../../../utils/base';
-import { type TemplateResult } from 'lit';
-import type { AiChatEmptyStateSuggestion } from './types';
-/**
- * @customElement luzmo-ai-chat-empty-state
- * @summary Empty state for AI chat with title, subtitle, and prompt suggestions.
- * @fires {CustomEvent<AiChatEmptyStateSuggestionSelectedDetail>} luzmo-suggestion-selected - Fired when the user selects a suggestion chip
- *
- * @property {string} --luzmo-ai-chat-empty-state-header-actions-gap - Gap between the title and the actions block
- * @property {string} --luzmo-ai-chat-empty-state-actions-gap - Gap between the actions label and suggestion chips
- * @property {string} --luzmo-ai-chat-empty-state-suggestions-gap - Gap between suggestion chips
- * @property {string} --luzmo-ai-chat-empty-state-max-width - Maximum content width
- * @property {string} --luzmo-ai-chat-empty-state-padding-block - Vertical padding
- * @property {string} --luzmo-ai-chat-empty-state-padding-inline - Horizontal padding
- * @property {string} --luzmo-ai-chat-empty-state-title-font-size - Title font size
- * @property {string} --luzmo-ai-chat-empty-state-title-font-weight - Title font weight
- * @property {string} --luzmo-ai-chat-empty-state-title-line-height - Title line height
- * @property {string} --luzmo-ai-chat-empty-state-title-color - Title text color
- * @property {string} --luzmo-ai-chat-empty-state-subtitle-font-size - Subtitle font size
- * @property {string} --luzmo-ai-chat-empty-state-subtitle-font-weight - Subtitle font weight
- * @property {string} --luzmo-ai-chat-empty-state-subtitle-line-height - Subtitle line height
- * @property {string} --luzmo-ai-chat-empty-state-subtitle-color - Subtitle text color (`--luzmo-font-color-dimmed`)
- */
-export declare class LuzmoAiChatEmptyState extends LuzmoElement {
-    static styles: import("lit").CSSResult;
-    static tagName: string;
-    /**
-     * Heading shown above the suggestions.
-     */
-    title: string;
-    /**
-     * Supporting text shown above suggestion chips when `suggestions` is non-empty.
-     */
-    subtitle: string;
-    /**
-     * Suggestion chips rendered with {@link https://lucero.luzmo.com/ | Lucero} `luzmo-action-button` (`variant="accent"`).
-     */
-    suggestions: AiChatEmptyStateSuggestion[];
-    /**
-     * When true, suggestion chips cannot be activated.
-     */
-    disabled: boolean;
-    private _handleSuggestionActivate;
-    protected render(): TemplateResult;
-}

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

@@ -1,8 +0,0 @@
-import { LuzmoAiChatEmptyState } from './ai-chat-empty-state';
-declare global {
-    interface HTMLElementTagNameMap {
-        'luzmo-ai-chat-empty-state': LuzmoAiChatEmptyState;
-    }
-}
-export { LuzmoAiChatEmptyState } from './ai-chat-empty-state';
-export type { AiChatEmptyStateSuggestion, AiChatEmptyStateSuggestionSelectedDetail } from './types';

package/components/ai-chat/empty-state/types.d.ts

@@ -1,14 +0,0 @@
-import type { Dataset } from '../../../types';
-export type AiChatEmptyStateSuggestion = {
-    /** Visible label on the suggestion chip. */
-    label: string;
-    /** Prompt text inserted or submitted when selected; defaults to `label`. */
-    prompt?: string;
-    /** Datasets applied to the chat input when this suggestion is selected. */
-    selectedDatasets?: Dataset[];
-};
-export type AiChatEmptyStateSuggestionSelectedDetail = {
-    label: string;
-    prompt: string;
-    selectedDatasets?: Dataset[];
-};

package/components/ai-chat/index.cjs

@@ -1,20 +0,0 @@
-/*! * 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.
- * */
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../ai-interaction-textarea-CQBP9-DW.cjs"),t=require("../ai-chat-CBLWbv9C.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.E,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.buildSavedAgentAiPromptProperties=t.C,exports.chartToItemAsset=t.w,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.T,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;