@aidapt/caity-chat 3.0.0

package/dist/lib/index.d.ts

@@ -0,0 +1,665 @@
+import { JSXElementConstructor } from 'react';
+import { ReactElement } from 'react';
+import { ReactNode } from 'react';
+import { TemplateSlotDataMap } from '../types/template-slots';
+
+export declare type AssetType = {
+    [key: string]: FileMetadata;
+};
+
+/** Opzioni per la gestione degli allegati. */
+declare type AttachmentsOptions = {
+    /** Errore mostrato quando il file allegato supera la dimensione massima consentita. */
+    fileTooLarge?: string;
+    /** Errore mostrato quando si tenta di allegare più file del limite consentito. */
+    tooManyFiles?: string;
+    /** Tooltip del pulsante per allegare file. */
+    tooltip?: string;
+    /** Tooltip del pulsante per rimuovere un allegato. */
+    removeTooltip?: string;
+};
+
+declare type AwsConfig = {
+    /** ID voce AWS Polly (es. "Bianca"). */
+    voiceId?: string;
+    /** Codice lingua AWS (es. "it-IT"). */
+    languageCode?: string;
+    /** Se true, utilizza il motore TTS neurale di AWS Polly. */
+    neural?: boolean;
+};
+
+declare const CaityChatErrorCode: {
+    readonly NETWORK_ERROR: 0;
+    readonly UNAUTHORIZED: 401;
+    readonly FORBIDDEN: 403;
+    readonly NOT_FOUND: 404;
+    readonly EXPIRED_SESSION: 409;
+    readonly RATE_LIMIT: 429;
+    readonly GUARDRAILS: 600;
+    readonly SERIALIZABLE_ERROR: 400;
+    readonly UPLOAD_ERROR: 4001;
+};
+
+declare type CaityChatErrorCodeType = (typeof CaityChatErrorCode)[keyof typeof CaityChatErrorCode];
+
+export declare const CaityChatModuleEvents: {
+    readonly ON_MESSAGE_DEBUG?: string | undefined;
+    readonly ON_MESSAGE: "caity-on-message";
+    readonly ON_CONNECT: "caity-on-connect";
+    readonly ON_SESSION_CHANGE: "caity-on-session-change";
+    readonly ON_FEEDBACK: "caity-on-feedback";
+    readonly ON_RECEIVE_SETUP: "caity-on-receive-setup";
+    readonly ON_RECEIVE_HISTORY: "caity-on-receive-history";
+    readonly ON_CAITY_ERROR: "caity-on-error";
+};
+
+export declare type CaityChatModuleEventsType = (typeof CaityChatModuleEvents)[keyof typeof CaityChatModuleEvents];
+
+export declare const CaityChatModuleReceiveEvents: {
+    readonly CHANGE_SETUP?: string | undefined;
+    /** Payload: { sessionId: string, setup?: ChatSetup } */
+    readonly CHANGE_SESSION: "caity-change-session";
+    readonly ADD_METADATA: "caity-add-metadata";
+    readonly CHANGE_INPUT: "caity-change-input";
+    readonly SEND_INPUT: "caity-send-input";
+    readonly LOCK_CHAT: "caity-lock-chat";
+    readonly UNLOCK_CHAT: "caity-unlock-chat";
+};
+
+export declare type CaityChatModuleReceiveEventsType = (typeof CaityChatModuleReceiveEvents)[keyof typeof CaityChatModuleReceiveEvents];
+
+declare type CaityErrorHandler = (status: CaityChatErrorCodeType, content?: string) => void | Promise<void>;
+
+export declare type CaityMimeType = "text/plain" | "text/html" | "text/css" | "text/javascript" | "text/xml" | "text/markdown" | "image/jpeg" | "image/png" | "image/gif" | "image/svg+xml" | "image/webp" | "image/bmp" | "audio/mpeg" | "audio/ogg" | "audio/wav" | "audio/webm" | "audio/aac" | "video/mp4" | "video/webm" | "video/ogg" | "video/mpeg" | "application/json" | "application/xml" | "application/pdf" | "application/zip" | "application/vnd.ms-excel" | "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" | "application/vnd.ms-powerpoint" | "application/vnd.openxmlformats-officedocument.presentationml.presentation" | "application/msword" | "application/vnd.openxmlformats-officedocument.wordprocessingml.document" | "font/ttf" | "font/woff" | "font/woff2" | "multipart/form-data" | "multipart/byteranges";
+
+declare type ConnectionBasePayload = {
+    app: string;
+    session: string | null;
+    metadata?: object;
+};
+
+export declare type ConnectionError = {
+    status: number;
+    message: string;
+    content?: string;
+};
+
+/**
+ * Abstract connection interface.
+ * Implementations can use HTTP, WebSocket, or any other protocol.
+ * `sendMessage` returns a ReadableStream because the server streams the response.
+ * `sendFeedback` has no response body.
+ */
+export declare interface ConnectionService {
+    setup(request: SetupRequest, signal?: AbortSignal): Promise<SetupResponse>;
+    upload(files: File[], app: string): Promise<FileReference[]>;
+    /**
+     * Fetches a protected asset by URL, attaching the bearer token when the chat
+     * is authenticated. Returns the raw Blob so callers can expose it as an object
+     * URL (since <img>/<audio>/<video> elements cannot send Authorization headers).
+     */
+    fetchAsset(url: string, signal?: AbortSignal): Promise<Blob>;
+    sendMessage(request: SendMessageRequest): Promise<ReadableStream<SessionResponse | MessageResponse>>;
+    retry(request: RetryRequest): Promise<ReadableStream<SessionResponse | MessageResponse>>;
+    sendFeedback(request: SendFeedbackRequest): Promise<void>;
+    history(request: HistoryRequest): Promise<HistoryResponse>;
+    tts(request: TTSRequest, signal?: AbortSignal, langConfig?: {
+        voiceId: string;
+        languageCode: string;
+        neural: boolean;
+    }): Promise<TTSResponse>;
+    stt(request: STTRequest, signal?: AbortSignal): Promise<STTResponse>;
+    registerErrorHandler(status: CaityChatErrorCodeType, handler: CaityErrorHandler): void;
+    registerGlobalErrorHandler(handler: CaityErrorHandler): void;
+}
+
+/** Opzioni specifiche per la variante cover. */
+declare type CoverVariantOptions = {
+    /** Se true, la chat occupa l'intero contenitore senza margini. */
+    coverAll?: boolean;
+    /** Se true, rimuove il border-radius dal bordo inferiore della chat. */
+    bottomNotRounded?: boolean;
+};
+
+/**
+ * React bridge for caity-chat template slots.
+ *
+ * Place it as a direct child of `<caity-chat>` to override a slot with
+ * React JSX. The component renders a Light DOM marker element that
+ * `collectTemplates` picks up, and registers a global render function that
+ * `PortalSlot` (inside the Shadow DOM) calls whenever the slot data changes.
+ *
+ * A React root is created lazily on first call and reused on subsequent data
+ * updates so no React tree is ever unmounted between renders.
+ *
+ * ```tsx
+ * <caity-chat>
+ *   <CustomTemplate name="caity-user-message">
+ *     {(message) => message ? (
+ *       <div className="my-bubble">{message.content}</div>
+ *     ) : null}
+ *   </CustomTemplate>
+ * </caity-chat>
+ * ```
+ */
+export declare function CustomTemplate<K extends keyof TemplateSlotDataMap>({ name, className, children, }: CustomTemplateProps<K>): ReactElement<    {
+class?: string | undefined;
+'data-caity-portal': string;
+render: string;
+}, string | JSXElementConstructor<any>>;
+
+declare interface CustomTemplateProps<K extends keyof TemplateSlotDataMap> {
+    /** Slot name to override (e.g. `'caity-user-message'`). */
+    name: K;
+    /**
+     * Render prop receiving the slot's typed data.
+     *
+     * ```tsx
+     * <CustomTemplate name="caity-user-message">
+     *   {(message) => message ? <div>{message.content}</div> : null}
+     * </CustomTemplate>
+     * ```
+     */
+    className?: string;
+    children: RenderFn<TemplateSlotDataMap[K]>;
+}
+
+export declare type Feedback = {
+    points?: number;
+    comment?: string;
+};
+
+declare type FeedbackOptions = {
+    /** Se true, il feedback usa una valutazione numerica al posto dei pollici su/giù. */
+    numericalFeedback?: boolean;
+    /** Titolo del dialog di feedback. */
+    dialogTitle?: string;
+    /** Etichetta del pulsante di invio nel dialog di feedback. */
+    dialogSendButton?: string;
+    /** Etichetta del pulsante di cancellazione nel dialog di feedback. */
+    dialogCancelButton?: string;
+    /** Descrizione del messaggio feedback. */
+    dialogDescription?: string;
+    /** Placeholder del messaggio feedback. */
+    dialogPlaceholder?: string;
+    /** Tooltip del pulsante pollice su. */
+    feedbackUpTooltip?: string;
+    /** Tooltip del pulsante pollice giù. */
+    feedbackDownTooltip?: string;
+    /** Tooltip del campo testo libero nel dialog di feedback. */
+    feedbackMessageTooltip?: string;
+};
+
+export declare type FeedbackRequest = {
+    id: string;
+    feedback: Feedback | undefined;
+};
+
+export declare type FileMetadata = {
+    key: string;
+    label?: string;
+    type: CaityMimeType;
+    url: string;
+    /** Tree-agent asset coordinates, used to build the asset download URL. */
+    node_id?: number | null;
+    chunk_id?: number | null;
+    tree_agent_id?: string | null;
+    /**
+     * Conversation-file id. Present (instead of the tree-agent coordinates) for
+     * files generated or uploaded during a conversation. Resolved to the
+     * `conversation-files/{file_id}` download route.
+     */
+    file_id?: string | null;
+};
+
+declare type FileReference = {
+    createdAt?: string;
+    deletedAt?: string | null;
+    fileName: string;
+    id: string;
+    message?: string | null;
+    messageId?: string | null;
+    sessionId?: string | null;
+    setupId?: string;
+    subscription?: string | null;
+    updatedAt?: string;
+    uploadedFileName?: string;
+};
+
+/** Opzioni specifiche per la variante floating. */
+declare type FloatingVariantOptions = {
+    /** Se true, la chat si apre automaticamente al caricamento della pagina. */
+    open?: boolean;
+    /** Distanza del floatinButton dal bordo destro della finestra. */
+    'floating-right'?: string;
+    /** Distanza del floatinButton dal bordo inferiore della finestra. */
+    'floating-bottom'?: string;
+};
+
+declare type FormFieldSchema = {
+    type: 'string' | 'number' | 'integer' | 'boolean';
+    title?: string;
+    description?: string;
+    /** Renders a <select> when present. */
+    enum?: string[];
+    /** 'date' → single date picker. 'date-range' → from/to date pair. */
+    format?: 'date' | 'date-range';
+    /** String constraints */
+    minLength?: number;
+    maxLength?: number;
+    /** Regex the value must satisfy (string fields). */
+    pattern?: string;
+    /** Number/integer constraints */
+    minimum?: number;
+    maximum?: number;
+    /** Maps to HTML step attribute (non-standard JSON Schema extension). */
+    step?: number;
+    /** Per-keyword error messages shown on validation failure. */
+    errorMessage?: {
+        required?: string;
+        pattern?: string;
+        minLength?: string;
+        maxLength?: string;
+        minimum?: string;
+        maximum?: string;
+    };
+};
+
+declare type FormSchema = {
+    type: 'object';
+    title?: string;
+    description?: string;
+    properties: Record<string, FormFieldSchema>;
+    required?: string[];
+};
+
+export declare type HistoryRequest = ConnectionBasePayload;
+
+export declare type HistoryResponse = {
+    messages: Message[];
+};
+
+export declare type Message = {
+    id?: string;
+    streamId: string;
+    sender: MessageSenderTypes;
+    content: string;
+    createdAt?: number;
+    lastUpdate?: number;
+    error?: string;
+    metadata?: MetaData;
+    event?: string;
+    reasoning?: Reasoning[];
+    files?: {
+        fileName: string;
+        id: string;
+    }[];
+};
+
+export declare type MessageResponse = {
+    id: string;
+    sender: MessageSenderTypes;
+    streamEnded?: boolean;
+    chunk?: string;
+    message?: string;
+    event?: ReceivedEventData;
+    metadata?: MetaData;
+    referTo: string;
+};
+
+/** Testi localizzabili visualizzati nell'interfaccia della chat. */
+export declare type Messages = {
+    /** Messaggio iniziale mostrato all'apertura della chat. */
+    greeting?: string;
+    /** Avviso (markdown, max 240 caratteri) mostrato centrato come sfondo della chat finché non viene inviato il primo messaggio. Se vuoto, non viene mostrato. */
+    backgroundNotice?: string;
+    /** Testo disclaimer mostrato in fondo alla lista messaggi. */
+    disclaimer?: string;
+    /** Placeholder del campo di input quando è vuoto. */
+    placeholder?: string;
+    /** Titolo visualizzato nell'header della chat. */
+    chatTitle?: string;
+    /** Etichetta della voce "riavvia" nel menu dropdown dell'header. */
+    dropDownHistory?: string;
+    /** Etichetta della voce "informazioni" nel menu dropdown dell'header. */
+    dropDownAbout?: string;
+    /** Testo mostrato nel campo di input mentre il server sta elaborando la risposta. */
+    sendingPlaceholder?: string;
+    /** Etichetta del separatore che indica il limite della context window tra i messaggi. */
+    contextWindowTitle?: string;
+    /** Domande predefinite mostrate come chip di risposta rapida sopra il campo di input. */
+    staticQuestions?: string[];
+    /** Prefisso del contatore dei caratteri rimanenti (es. "Caratteri rimasti: 200/1000"). */
+    availableChars?: string;
+    /** Errore mostrato quando il testo incollato supera il limite di caratteri. */
+    unableToPasteCharLimit?: string;
+    /** Messaggio di errore generico per errori imprevisti del server. */
+    defaultError?: string;
+    /** Messaggio di errore mostrato quando il server non è raggiungibile. */
+    connectionError?: string;
+    /** Messaggio di errore mostrato quando l'autenticazione fallisce (401/403). */
+    authorizationError?: string;
+    /** Messaggio di errore mostrato quando il server risponde con 404 session_not_found (la sessione non esiste più). */
+    sessionNotFoundError?: string;
+    /** Messaggio di errore mostrato quando la sessione ha oltrepassato l'expiration time. */
+    expiredSessionError?: string;
+    /** Messaggio di errore mostrato quando il setup risponde con 403 app_not_usable (privacy policy non configurata o in pending). */
+    appNotUsableError?: string;
+    /** Messaggio di errore mostrato quando il server risponde con 400 app_not_found (codice app non trovato). */
+    appNotFoundError?: string;
+    /** Messaggio di avviso mostrato quando il server risponde con 429 (limite di interazioni per minuto raggiunto). */
+    rateLimitError?: string;
+    /** Messaggio di errore mostrato quando il caricamento di un allegato fallisce (es. formato non supportato, file troppo grande). */
+    uploadError?: string;
+    /** Messaggio di errore mostrato quando il flow esegue il nodo guardrail e viene inviato il codice di errore 409. */
+    guardrailError?: string;
+    /** Messaggio sostitutivo del messaggio inviato dall'utente quando il flow esegue il nodo guardrail e viene inviato il codice di errore 600. */
+    guardrailPlaceholder?: string;
+    /** Tooltip del pulsante di invio messaggio. */
+    sendTooltip?: string;
+    /** Tooltip del pulsante di copia messaggio. */
+    copyTooltip?: string;
+    /** Tooltip del pulsante per modificare un messaggio. */
+    retryTooltip?: string;
+    /** Tooltip del pulsante per annullare la modifica del messaggio e ripristinare il precedente. */
+    retryCancelTooltip?: string;
+    /** Tooltip del separatore della context window, spiega all'utente il significato del marcatore. */
+    contextWindowTooltip?: string;
+    /** Tooltip del pulsante flottante quando la chat è chiusa. */
+    collapsedTooltip?: string;
+    /** Tooltip del pulsante per chiudere/minimizzare la chat. */
+    uncollapsedTooltip?: string;
+    /** Etichetta del pulsante per mostrare il ragionamento del modello. */
+    showReasoning?: string;
+    /** Etichetta del pulsante per nascondere il ragionamento del modello. */
+    hideReasoning?: string;
+    /** Tooltip del pulsante per scorrere fino all'ultimo messaggio. */
+    scrollToBottomTooltip?: string;
+    /** Avviso mostrato all'utente quando la risposta in streaming è più lenta del solito. */
+    streamSlowWarning?: string;
+    /** Messaggio di errore mostrato quando lo streaming viene interrotto per timeout. */
+    streamAbortError?: string;
+    /** Messaggio mostrato mentre si attende la conferma di interruzione dello streaming. */
+    streamAbortWait?: string;
+    /** Etichetta del pulsante per interrompere manualmente lo streaming. */
+    streamAbortStop?: string;
+    /** Avviso mostrato all'utente quando il server impiega troppo a rispondere al setup iniziale. */
+    setupTimeoutWarning?: string;
+    /** Suffisso del chip delle fonti */
+    sourcesTooltip?: string;
+    /** Etichetta del pulsante di invio nei form inline della chat. */
+    formSubmitButton?: string;
+    /** Messaggio di errore mostrato quando un campo obbligatorio del form inline non è compilato. */
+    formRequiredError?: string;
+    /** Messaggio di errore mostrato quando il valore di un campo del form inline non rispetta il pattern richiesto. */
+    formPatternError?: string;
+    /** Titolo del dialog di modifica degli allegati testuali. */
+    textAttachmentDialogTitle?: string;
+    /** Etichetta del campo nome file nel dialog di modifica allegato. */
+    textAttachmentFileName?: string;
+    /** Etichetta del campo contenuto nel dialog di modifica allegato. */
+    textAttachmentFileContent?: string;
+    /** Etichetta del pulsante Annulla nel dialog di modifica allegato. */
+    textAttachmentCancel?: string;
+    /** Etichetta del pulsante Rimuovi nel dialog di modifica allegato. */
+    textAttachmentRemove?: string;
+    /** Etichetta del pulsante che riporta il contenuto dell'allegato nella textarea. */
+    textAttachmentToTextarea?: string;
+    /** Etichetta del pulsante Salva nel dialog di modifica allegato. */
+    textAttachmentSave?: string;
+    /** Testo mostrato durante il rendering di un diagramma Mermaid. */
+    mermaidRenderingDiagram?: string;
+    /** Tooltip del pulsante per passare alla vista codice nel blocco preview. */
+    previewShowCode?: string;
+    /** Tooltip del pulsante per tornare alla vista preview nel blocco preview. */
+    previewShowPreview?: string;
+    /** Tooltip del pulsante copia codice nel blocco preview. */
+    previewCopyCode?: string;
+    /** Tooltip del pulsante per passare alla vista testo grezzo nel messaggio. */
+    markdownToggleRaw?: string;
+    /** Tooltip del pulsante per passare alla vista anteprima markdown nel messaggio. */
+    markdownTogglePreview?: string;
+    /** Mappa nome-evento → testo descrittivo mostrato nella chat per gli eventi di risposta. */
+    events?: {
+        [key: string]: string;
+    };
+};
+
+export declare type MessageSenderTypes = "user" | "machine" | "error" | "system";
+
+export declare type MetaData = {
+    systemScope?: number;
+    total_price?: number;
+    elapsed_time?: number;
+    feedback?: Feedback;
+    select_options?: string[];
+    server_metadata?: ServerMetadata;
+    assets?: {
+        [key: string]: FileMetadata;
+    };
+    files?: {
+        [key: string]: FileMetadata;
+    };
+    sources?: Source[];
+    error_code?: number;
+    error_content?: string;
+    is_deleted?: boolean;
+    __tempMetadata?: unknown;
+    [key: string]: any;
+};
+
+/** Opzioni di configurazione del widget. */
+export declare type Options = {
+    /** Variante visiva del widget: floating (pulsante flottante) o cover (integrato nella pagina). */
+    themeVariant?: 'floating' | 'cover';
+    /** Opzioni specifiche per la variante cover. */
+    coverVariantOptions?: CoverVariantOptions;
+    /** Opzioni specifiche per la variante floating. */
+    floatingVariantOptions?: FloatingVariantOptions;
+    feedbackOptions?: FeedbackOptions;
+    responseEventOptions?: ResponseEventOptions;
+    /** Numero massimo di caratteri consentiti nel campo di input. */
+    maxCharsNumber?: number;
+    /** Numero di caratteri oltre il quale un testo incollato viene convertito automaticamente in allegato. Default: 5000. */
+    pasteToAttachmentThreshold?: number;
+    /** Opzioni per il servizio vocale (STT e TTS). */
+    voiceServiceOptions?: VoiceServiceOptions;
+    /** Opzioni per la gestione degli allegati. */
+    attachmentsOptions?: AttachmentsOptions;
+};
+
+declare type Reasoning = {
+    title: string;
+    content: string;
+};
+
+declare type ReceivedEventData = {
+    name: string;
+    kind: 'spinner' | 'reasoning';
+    content?: string;
+};
+
+declare type RenderFn<TData> = (data: TData) => ReactNode;
+
+declare type ResponseEventOptions = {
+    /** Prefisso testuale mostrato prima del tempo di risposta (es. "Risposto in:"). */
+    responseTime?: string;
+};
+
+declare type RetryRequest = ConnectionBasePayload & {
+    message: Message;
+};
+
+export declare type SendFeedbackRequest = ConnectionBasePayload & {
+    messageId: string;
+    points: number;
+    comment?: string;
+};
+
+export declare type SendMessageRequest = ConnectionBasePayload & {
+    message: Message;
+};
+
+declare type ServerMetadata = {
+    form_schema?: FormSchema;
+    form_response?: Record<string, unknown>;
+};
+
+declare type SessionResponse = {
+    session: string;
+};
+
+export declare type SetupEventMessages = {
+    [eventType: string]: string;
+};
+
+export declare type SetupRequest = {
+    app: string;
+};
+
+export declare type SetupResponse = {
+    config: SkillConfig;
+    aspect: SkillAspect;
+};
+
+export declare type SkillAspect = {
+    /** Versione dello schema dell'aspect e della chat (es. v1.0.0). */
+    version: string;
+    /** Lingue disponibili per la traduzione (es. ["it", "en"]). Se vuoto, la lingua è unica. */
+    availableLanguages?: string[];
+    /** Opzioni di configurazione del widget. */
+    options: Options;
+    /** Testi localizzabili visualizzati nell'interfaccia della chat. */
+    messages: Messages;
+    /** CSS personalizzato iniettato nello Shadow DOM del widget. */
+    customStyles?: string;
+};
+
+declare type SkillConfig = {
+    contextHistory?: number;
+    maxUploadFileSize?: number;
+    maxFilesNumber?: number;
+    acceptedFileFormats?: string;
+    enabledPrice?: boolean;
+    enabledFileUpload?: boolean;
+    enableFeedback?: boolean;
+    enableMessageTime?: boolean;
+    enableResponseEvent?: boolean;
+    enableVoiceService?: boolean;
+    streamWarningTimeout?: number;
+    pasteToAttachmentThreshold?: number;
+};
+
+declare type Source = {
+    title: string;
+    content: string;
+};
+
+declare type STTRequest = {
+    voiceServiceUrl: string;
+    audio: Blob;
+};
+
+declare type STTResponse = {
+    text: string;
+};
+
+export declare type ThemeConfig = {
+    variant: ThemeVariant;
+};
+
+declare type ThemeVariant = "floating" | "cover";
+
+declare type TTSRequest = {
+    voiceServiceUrl: string;
+    text: string;
+    langConfig?: AwsConfig;
+};
+
+declare type TTSResponse = {
+    url: string;
+};
+
+/** Opzioni per il servizio vocale (STT e TTS). */
+declare type VoiceServiceOptions = {
+    /** URL dell'endpoint del servizio vocale esterno. */
+    url?: string;
+    /** Configurazione AWS Polly per lingua. Chiave = codice lingua (es. "it"). */
+    awsConfig?: {
+        [key: string]: AwsConfig;
+    };
+    /** Tooltip del pulsante per avviare la registrazione vocale (STT). */
+    sttPlayTooltip?: string;
+    /** Tooltip del pulsante per fermare la registrazione vocale (STT). */
+    sttStopTooltip?: string;
+    /** Tooltip mostrato mentre il riconoscimento vocale è in elaborazione. */
+    sttLoadingTooltip?: string;
+    /** Messaggio di errore mostrato quando il riconoscimento vocale fallisce. */
+    sttError?: string;
+    /** Tooltip del pulsante per riprodurre il messaggio con sintesi vocale (TTS). */
+    ttsPlayTooltip?: string;
+    /** Tooltip del pulsante per fermare la riproduzione TTS. */
+    ttsStopTooltip?: string;
+    /** Tooltip mostrato mentre il TTS sta caricando l'audio. */
+    ttsLoadingTooltip?: string;
+};
+
+export { }
+
+
+declare module 'react' {
+    namespace JSX {
+        interface IntrinsicElements {
+            'caity-chat': CaityHostProps;
+            'caity-attachment-chip': CaitySlotProps;
+            'caity-attachment-list': CaitySlotProps;
+            'caity-background-notice': CaitySlotProps;
+            'caity-bot-avatar-icon': CaitySlotProps;
+            'caity-chat-container': CaitySlotProps;
+            'caity-chat-floating-button': CaitySlotProps;
+            'caity-chat-window': CaitySlotProps;
+            'caity-context-message': CaitySlotProps;
+            'caity-error-message': CaitySlotProps;
+            'caity-footer': CaitySlotProps;
+            'caity-greeting-message': CaitySlotProps;
+            'caity-header': CaitySlotProps;
+            'caity-header-dropdown': CaitySlotProps;
+            'caity-header-dropdown-item': CaitySlotProps;
+            'caity-header-item': CaitySlotProps;
+            'caity-header-logo': CaitySlotProps;
+            'caity-input': CaitySlotProps;
+            'caity-input-chars-alert': CaitySlotProps;
+            'caity-input-textarea': CaitySlotProps;
+            'caity-machine-message': CaitySlotProps;
+            'caity-machine-message-attachment-chip': CaitySlotProps;
+            'caity-messages': CaitySlotProps;
+            'caity-msg-action-item': CaitySlotProps;
+            'caity-msg-actions': CaitySlotProps;
+            'caity-msg-collapse': CaitySlotProps;
+            'caity-msg-copy': CaitySlotProps;
+            'caity-msg-debug': CaitySlotProps;
+            'caity-msg-feedback': CaitySlotProps;
+            'caity-msg-retry': CaitySlotProps;
+            'caity-msg-select-option': CaitySlotProps;
+            'caity-msg-select-options': CaitySlotProps;
+            'caity-msg-sources': CaitySlotProps;
+            'caity-msg-time': CaitySlotProps;
+            'caity-msg-toolbox': CaitySlotProps;
+            'caity-msg-tts': CaitySlotProps;
+            'caity-scroll-to-bottom-button': CaitySlotProps;
+            'caity-slow-response-abort-message': CaitySlotProps;
+            'caity-slow-response-warning-message': CaitySlotProps;
+            'caity-static-question-item': CaitySlotProps;
+            'caity-static-questions': CaitySlotProps;
+            'caity-time-divider-message': CaitySlotProps;
+            'caity-toolbox': CaitySlotProps;
+            'caity-toolbox-item': CaitySlotProps;
+            'caity-toolbox-item-attachment': CaitySlotProps;
+            'caity-toolbox-item-send': CaitySlotProps;
+            'caity-toolbox-item-stt': CaitySlotProps;
+            'caity-user-message': CaitySlotProps;
+            'caity-user-message-attachment-container': CaitySlotProps;
+            'caity-user-message-content': CaitySlotProps;
+        }
+    }
+}