@luzmo/analytics-components-kit 1.0.8-beta.6 → 1.0.8

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

@@ -1,133 +0,0 @@
-import type { PromptBoxAttachment } from '@luzmo/lucero';
-import type { Dataset, LuzmoChart } from '../../types';
-export type AiPromptAgent = 'item' | 'dashboard' | 'analyst' | 'custom-item';
-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;
-}
-/**
- * Draft context for `agent: 'custom-item'`. The host owns its shape: the chart document under
- * `document`, plus optional fields such as `chartId`, `isExample`, `hostTheme` and `previewFrame`.
- */
-export interface AiPromptCustomItemInput {
-    type: 'custom-item';
-    value: Record<string, unknown>;
-}
-export interface AiPromptImageInput {
-    type: 'image';
-    url: string;
-}
-export type AiPromptInput = AiPromptTextInput | AiPromptDatasetInput | AiPromptItemInput | AiPromptDashboardInput | AiPromptCustomItemInput | AiPromptImageInput;
-/** Fields both aiprompt create shapes share, whichever agent selector is used. */
-export interface AiPromptPropertiesBase {
-    conversation_id?: string;
-    locale_id?: string;
-    timezone_id?: string;
-    text_format?: 'plain' | 'markdown';
-    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';
-    /** Hides the prompt from the restored transcript. Custom-item agent only. */
-    internal?: boolean;
-    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;
-    /** Draft context for `agent: 'custom-item'`. */
-    customItem?: AiPromptCustomItemInput['value'] | null;
-    currentScreenMode?: AiPromptScreenMode;
-    task?: AiPromptItemTask;
-    attachmentUrls?: string[];
-    /** Sends `internal: true` so the prompt stays out of the restored transcript (custom-item agent only). */
-    internal?: boolean;
-}
-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/helpers/agent-config.d.ts

@@ -1,12 +0,0 @@
-import type { AiPromptAgent, BuildAiPromptRequestContext } from '../ai-prompt-types';
-import type { AiChatAgentConfig } from '../types';
-type LegacyAgentContext = Pick<BuildAiPromptRequestContext, 'chart' | 'dashboard' | 'customItem' | 'currentScreenMode' | 'task'>;
-type AgentConfigSource = LegacyAgentContext & {
-    agent?: AiPromptAgent;
-    agentConfig?: AiChatAgentConfig;
-};
-/** Adapt existing flat inputs, or inherit omitted typed context only when the agent type matches. */
-export declare function resolveAiChatAgentConfig(source: AgentConfigSource, previous?: AiChatAgentConfig): AiChatAgentConfig;
-/** Clear inactive legacy fields so a typed configuration cannot leak another agent's context. */
-export declare function agentRequestContext(config: AiChatAgentConfig): LegacyAgentContext;
-export {};

package/components/ai-chat/helpers/elicitation-template.d.ts

@@ -1,18 +0,0 @@
-import '@luzmo/lucero/question-box';
-import type { QuestionBoxResultDetail } from '@luzmo/lucero/question-box';
-import type { ChatMessage } from '../../../types';
-/**
- * - `open`: the latest question, waiting for an answer.
- * - `answered`: an answer was sent; shown read-only.
- * - `closed`: not answerable, because the conversation moved on, a response is generating or the chat is disabled.
- */
-export type ElicitationState = 'open' | 'answered' | 'closed';
-export interface ElicitationMarkupArgs {
-    message: ChatMessage;
-    state: ElicitationState;
-    onSubmit: (event: CustomEvent<QuestionBoxResultDetail>) => void;
-}
-/** Reads the chosen option from a question box `luzmo-submit` event. */
-export declare function readElicitationAnswer(detail: QuestionBoxResultDetail): string | undefined;
-/** Renders the agent question on an assistant message as a single-choice question box. */
-export declare function elicitationMarkup({ message, state, onSubmit }: ElicitationMarkupArgs): unknown;

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-B6tZgh5k.cjs"),t=require("../ai-chat-CG-eIiBr.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.D,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.buildCustomItemAiPromptProperties=t.x,exports.buildDashboardAiPromptProperties=t.S,exports.buildItemAiPromptProperties=t.C,exports.buildSavedAgentAiPromptProperties=t.w,exports.chartToItemAsset=t.T,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.E,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

@@ -1,24 +0,0 @@
-import { LuzmoAiChat } from './ai-chat';
-declare global {
-    interface HTMLElementTagNameMap {
-        'luzmo-ai-chat': LuzmoAiChat;
-    }
-}
-export type { ProgressTreeNode, AssistantMessageAction, AssistantMessageActionConfirmVariant, AssistantMessageActionEventDetail, ChatMessageElicitation, 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';
-export type { AiChatSessionControllerOptions, AiChatSessionSeed } from './session/ai-chat-session-controller';
-export type { AiChatSessionBuildContext, AiChatSessionCallbacks, AiChatSessionConfig, AiChatSessionRestoreParams, AiChatSessionRestoreResult, AiChatSessionState, AiChatSessionSubmitParams, AiPromptCreateBody, AiPromptDeleteBody, LuzmoPromptSubmittedEventDetail, LuzmoRestoreRequestedEventDetail } from './session/ai-chat-session-types';
-export { LuzmoAiChat } from './ai-chat';
-export type { AiChatAgentConfig } from './types';
-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

@@ -1,29 +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.
- * */
-// Auto-generated initialization code
-(function() {
-	if (typeof document < "u" && !document.querySelector("style[data-luzmo-vars]")) {
-		let e = document.createElement("style");
-		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-shadow-color-rgb: 0, 0, 0;--luzmo-shadow-opacity: 0.1;--luzmo-shadow-color: rgba(var(--luzmo-shadow-color-rgb), var(--luzmo-shadow-opacity));--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 { 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-D9g9G0T1.js";
-import { C as p, D as m, E as h, S as g, T as _, _ as v, a as y, b, c as x, d as S, f as C, g as w, h as T, i as E, l as D, m as O, n as k, o as A, p as j, r as M, s as N, t as P, u as F, v as I, w as L, x as R, y as z } from "../ai-chat-CMc_9Oo2.js";
-export { t as AI_PROMPT_ACCEPTED_IMAGE_MIME_TYPES, a as AI_PROMPT_MAX_ATTACHMENTS, E as AiChatSession, M as AiChatSessionController, k as LuzmoAiChat, m as LuzmoAiChatEmptyState, f as assertValidAiPromptAttachmentFiles, n as assertValidAiPromptAttachmentUrls, s as blobToBase64, u as buildAiDictationRequest, v as buildAiPromptDeleteRequest, I as buildAiPromptProperties, z as buildAiPromptRequest, b as buildAnalystAiPromptProperties, R as buildCustomItemAiPromptProperties, g as buildDashboardAiPromptProperties, p as buildItemAiPromptProperties, L as buildSavedAgentAiPromptProperties, _ as chartToItemAsset, y as createAiChatSession, C as createInitialProgress, A as createInitialStreamState, N as createStreamHandler, F as extractChartFromChunk, S as extractDashboardFromChunk, O as fetchStreamingResponse, x as getAgentStreamDefinition, i as getAiDictationUrl, h as getAiPromptUrl, c as getUploadUrl, j as hasProgressChunk, r as isAiPromptAcceptedImageFile, l as isAiPromptAcceptedImageMimeType, o as isAiPromptAcceptedImageUrl, P as isRecognizedStep, T as parseStreamLine, D as processStreamChunk, w as readNdjsonStream, e as streamAiDictation, d as uploadAiPromptImages };

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

@@ -1,60 +0,0 @@
-import type { ChatMessage, Dataset } from '../../../types';
-import { type AiChatSession } from './ai-chat-session';
-import type { AiChatSessionCallbacks, AiChatSessionConfig, AiChatSessionState } from './ai-chat-session-types';
-export type AiChatSessionSeed = {
-    messages: ChatMessage[];
-    selectedDatasets: Dataset[];
-    conversationId: string | null;
-};
-export type AiChatSessionControllerOptions = {
-    getConfig: () => AiChatSessionConfig;
-    getSeed: () => AiChatSessionSeed;
-    createDomBridge: () => AiChatSessionCallbacks;
-    onRenderNeeded: () => void;
-};
-/**
- * Single {@link AiChatSession} slot for `luzmo-ai-chat`.
- * The chat component uses {@link current}, {@link state}, and {@link requireSession} only.
- */
-export declare class AiChatSessionController {
-    private readonly options;
-    /** The active {@link AiChatSession}. Null until first bind or action. */
-    private _session;
-    /** When true, {@link teardown} aborts and clears the session. */
-    private _ownsSession;
-    /** Once the element supplies a custom item, its null value also overrides a host session. */
-    private _customItemFromProps;
-    /** Whether the session has been seeded from props. Used to avoid unnecessary updates. */
-    private _seededFromProps;
-    private _unsubscribe;
-    constructor(options: AiChatSessionControllerOptions);
-    get current(): AiChatSession | null;
-    get state(): Readonly<AiChatSessionState>;
-    get ownsCurrentSession(): boolean;
-    /**
-     * Use an app-provided session (e.g. from `.chatSession`).
-     * Pass `null` to clear it; an owned session may be created later via {@link requireSession}.
-     */
-    setSession(session: AiChatSession | null): void;
-    /**
-     * Sync config / seed props after Lit `updated`.
-     * Call after handling `chatSession` via {@link setSession}.
-     */
-    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.
-     * Preserves a host custom item until the element supplies one; later null clears it.
-     * Never touches host `fetchStreaming`.
-     */
-    private _mergeHostElementConfig;
-    /** Re-attach UI bridge and state subscription after {@link teardown} on reconnect. */
-    connect(): void;
-    teardown(): void;
-    private _createSessionIfMissing;
-    private _clearSession;
-    private _seedFromPropsOnce;
-    private _wire;
-    private _unwire;
-}

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

@@ -1,119 +0,0 @@
-import type { PromptBoxAttachment } from '@luzmo/lucero';
-import type { ProgressTreeNode } from '@luzmo/lucero/progress-steps';
-import type { AiSampleChart, ChatMessage, Dataset, LuzmoChart } from '../../../types';
-import type { AiChatCompleteEvent, AiChatStepEvent } from '../ai-chat-events';
-import type { AiPromptAgent, AiPromptCustomItemInput, AiPromptCreateBody, AiPromptDeleteBody, AiPromptItemTask, AiPromptScreenMode, BuildAiPromptRequestContext, DashboardStatePayload, LuzmoPromptSubmittedEventDetail, LuzmoRestoreRequestedEventDetail } from '../ai-prompt-types';
-import type { StreamingRequestOptions, StreamingResponse } from '../stream/transport';
-import type { AiChatAgentConfig } from '../types';
-export interface AiChatSessionConfig {
-    /** Legacy agent selector. Defaults to item; agentConfig takes precedence. */
-    agent?: AiPromptAgent;
-    /** Typed agent selection and context. Omitted context preserves the same agent's context; null clears it. */
-    agentConfig?: AiChatAgentConfig;
-    /** Saved Agent override. Leave unset for custom-item sessions to preserve draft context and internal prompts. */
-    agentId?: string;
-    authKey: string;
-    authToken: string;
-    apiUrl?: string;
-    apiVersion?: string;
-    stream?: boolean;
-    conversationId?: string | null;
-    chart?: LuzmoChart | null;
-    dashboard?: DashboardStatePayload | null;
-    /** Draft context for `agent: 'custom-item'`, sent as its `custom-item` input. */
-    customItem?: AiPromptCustomItemInput['value'] | null;
-    currentScreenMode?: AiPromptScreenMode;
-    localeId?: string;
-    timezoneId?: string;
-    task?: AiPromptItemTask;
-    modelPreference?: 'performance' | 'quality';
-    /** Initial transcript when hydrating a saved conversation. */
-    messages?: ChatMessage[];
-    /** Datasets attached to the prompt input. */
-    selectedDatasets?: Dataset[];
-    /** When true, {@link AiChatSession.submit} requires at least one selected dataset or an `agentId` passed to it. */
-    requireDataset?: boolean;
-    /** Initial loading flag (e.g. Storybook or restored UI state). */
-    isGenerating?: boolean;
-    /** Initial progress tree. */
-    progress?: ProgressTreeNode | null;
-    /** Initial progress collapsed flag. */
-    progressCollapsed?: boolean;
-    /**
-     * Custom streaming HTTP client. Defaults to the built-in {@link fetchStreamingResponse}.
-     * Use for proxies, mocks, or alternate auth transport while keeping session state handling.
-     */
-    fetchStreaming?: (options: StreamingRequestOptions) => Promise<StreamingResponse>;
-}
-export interface AiChatSessionState {
-    messages: ChatMessage[];
-    selectedDatasets: Dataset[];
-    isGenerating: boolean;
-    progress: ProgressTreeNode | null;
-    progressCollapsed: boolean;
-    conversationId: string | null;
-    /** In-flight assistant message (streaming). Also present in `messages` while streaming. */
-    inflightMessage: ChatMessage | null;
-}
-export interface AiChatSessionCallbacks {
-    onStateChange?: (state: AiChatSessionState) => void;
-    onConversationIdChange?: (conversationId: string) => void;
-    /** Fired for every incremental, kit-assembled event during a streamed response. */
-    onStep?: (event: AiChatStepEvent) => void;
-    /** Fired exactly once per response with the authoritative final result (or error). */
-    onComplete?: (event: AiChatCompleteEvent) => void;
-    onMessageSent?: (message: ChatMessage, selectedDatasets: Dataset[]) => void;
-    onDatasetsChanged?: (selectedDatasets: Dataset[]) => void;
-    /**
-     * Host-owned submit: session updates transcript and loading state, then invokes this
-     * 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>;
-    /**
-     * Host-owned restore (item agent): session invokes this with delete request + URL; no built-in fetch.
-     */
-    onRestoreRequested?: (detail: LuzmoRestoreRequestedEventDetail) => void | Promise<void>;
-}
-export interface AiChatSessionSubmitParams {
-    prompt: string;
-    /** Defaults to ids from {@link AiChatSessionState.selectedDatasets}. */
-    datasetIds?: string[];
-    /** Optional stable id for the in-flight AI message. */
-    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[];
-    /**
-     * Saved Agent id for this prompt. Defaults to {@link AiChatSessionConfig.agentId}.
-     * Leave unset for custom-item sessions to preserve draft context and internal prompts.
-     */
-    agentId?: string;
-    /**
-     * Sends the prompt as `internal: true`, which keeps it out of the restored transcript.
-     * Only the custom-item agent supports it. Combine with `skipUserMessage` for a turn the
-     * host starts itself, such as an automatic fix.
-     */
-    internal?: boolean;
-}
-export interface AiChatSessionRestoreParams {
-    restoreToMessageId: string;
-    messageIndex: number;
-}
-export type AiChatSessionBuildContext = Omit<BuildAiPromptRequestContext, 'prompt' | 'datasetIds'>;
-export interface AiChatSessionRestoreResult {
-    chart?: AiSampleChart;
-    message?: string;
-}
-export type { AiPromptCreateBody, AiPromptDeleteBody, LuzmoPromptSubmittedEventDetail, LuzmoRestoreRequestedEventDetail };

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

@@ -1,119 +0,0 @@
-import type { PromptBoxAttachment } from '@luzmo/lucero';
-import type { Dataset } from '../../../types';
-import type { AiPromptCreateBody, AiPromptDeleteBody, LuzmoPromptSubmittedEventDetail } from '../ai-prompt-types';
-import type { AiChatAgentConfig } from '../types';
-import type { AiChatSessionCallbacks, AiChatSessionConfig, AiChatSessionRestoreParams, AiChatSessionRestoreResult, AiChatSessionState, AiChatSessionSubmitParams } from './ai-chat-session-types';
-/**
- * Headless chat controller: transcript, datasets, streaming, and API calls without a DOM host.
- * Use with `luzmo-ai-chat` via `.chatSession` for the same simplicity as internal mode,
- * while keeping the session alive when the panel unmounts.
- *
- * @example
- * ```ts
- * const session = createAiChatSession(
- *   { agent: 'dashboard', authKey, authToken, dashboard, currentScreenMode },
- *   {
- *     onComplete: (e) => {
- *       if (e.dashboard) applyToEditor(e.dashboard, e.name);
- *     },
- *     onStateChange: (s) => persistConversation(s.messages),
- *   }
- * );
- *
- * html`<luzmo-ai-chat .chatSession=${session}></luzmo-ai-chat>`;
- * ```
- */
-export declare class AiChatSession {
-    private _config;
-    /** Callbacks passed to {@link createAiChatSession} (host application). */
-    private _hostCallbacks;
-    /** Optional bridge from `luzmo-ai-chat` (DOM events). Replaced on each bind, not chained. */
-    private _uiBridgeCallbacks;
-    private readonly _subscribers;
-    private _state;
-    private _abortController;
-    private _inflightMessage;
-    private _receivedProgress;
-    constructor(config: AiChatSessionConfig, callbacks?: AiChatSessionCallbacks);
-    get state(): Readonly<AiChatSessionState>;
-    get isGenerating(): boolean;
-    /** Effective built-in agent and context after applying typed configuration or legacy compatibility inputs. */
-    get agentConfig(): AiChatAgentConfig;
-    /**
-     * Subscribe to full session state (for `luzmo-ai-chat` rendering). Returns an unsubscribe function.
-     * The listener is invoked immediately with the current state.
-     */
-    subscribe(listener: (state: AiChatSessionState) => void): () => void;
-    /**
-     * Wire `luzmo-ai-chat` DOM event bridging. Safe to call again when hot-swapping the same
-     * session back onto the component — replaces the previous bridge instead of stacking it.
-     */
-    setUiBridge(bridge: AiChatSessionCallbacks): void;
-    /** Merge config (chart, conversationId, agent, …) without aborting an in-flight request. */
-    updateConfig(partial: Partial<AiChatSessionConfig>): void;
-    /** Replace the full dataset selection (e.g. when the dashboard context changes). */
-    setSelectedDatasets(datasets: Dataset[]): void;
-    addDataset(dataset: Dataset): void;
-    removeDataset(datasetId: string): void;
-    isDatasetRequirementMet(agentId?: string): boolean;
-    getAiPromptUrl(): string;
-    buildRequestBody(prompt: string, datasetIds: string[], attachmentUrls?: string[], agentId?: string | undefined, options?: {
-        internal?: boolean;
-    }): AiPromptCreateBody;
-    /** Same payload passed to {@link AiChatSessionCallbacks.onPromptSubmitted}. */
-    buildPromptSubmittedDetail(params: {
-        prompt: string;
-        selectedDatasets: Dataset[];
-        datasetIds: string[];
-        signal?: AbortSignal;
-        attachments?: PromptBoxAttachment[];
-        attachmentUrls?: string[];
-        agentId?: string;
-        internal?: boolean;
-    }): 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}.
-     */
-    submit(params: AiChatSessionSubmitParams): Promise<void>;
-    /** {@link submit}, resolving to whether the request was sent (`false` when declined, aborted or superseded first). */
-    private _submit;
-    /**
-     * Answer the clarifying question on the last message and send the answer as the next prompt.
-     * Resolves to `false` without sending while a response is generating, when that message has no open
-     * question or another message follows it, when `answer` is not one of its options, when the dataset requirement is not met, or when
-     * the send is aborted or superseded before the request goes out; the answer is cleared again then.
-     */
-    answerElicitation(messageId: string, answer: string, params?: Omit<AiChatSessionSubmitParams, 'prompt'>): Promise<boolean>;
-    /** Item agent only — restore conversation to a prior API message. */
-    restore(params: AiChatSessionRestoreParams): Promise<AiChatSessionRestoreResult>;
-    buildRestoreRequest(restoreToMessageId: string): AiPromptDeleteBody;
-    /**
-     * Cancel the in-flight prompt.
-     * User-initiated stops (`notify`) leave a "response cancelled" placeholder where the assistant
-     * reply would have been; internal aborts discard any partial assistant output.
-     */
-    abort(options?: {
-        notify?: boolean;
-        cancelledMessage?: string;
-    }): void;
-    private _abortInflight;
-    private _createStreamCallbacks;
-    private _setConversationId;
-    private _upsertMessage;
-    private _finalizeInflightMessage;
-    private _removeInflightFromMessages;
-    private _markInflightCancelled;
-    private _discardInflightMessage;
-    private _handleSubmitError;
-    private _hasCallback;
-    private _emit;
-    private _invokeCallback;
-    private _patchState;
-    private _notifySubscribers;
-    private _areSelectedDatasetsEqual;
-    private _areChatMessagesEqual;
-}
-export declare function createAiChatSession(config: AiChatSessionConfig, callbacks?: AiChatSessionCallbacks): AiChatSession;

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

@@ -1,2 +0,0 @@
-export { AiChatSession, createAiChatSession } from './ai-chat-session';
-export { AiChatSessionController } from './ai-chat-session-controller';