@aikaara/chat-sdk 0.2.0 → 0.3.3

package/dist/ui.d.ts

@@ -8,14 +8,45 @@ export declare class AikaaraChatBubble extends HTMLElement {
 
 declare class AikaaraChatClient extends EventEmitter<ChatEvents> {
     private connection;
+    private tiledesk;
     private api;
     private messageStore;
     private conversationManager;
     private subscription;
     private config;
-    constructor(config: ChatClientConfig_2);
+    private mode;
+    private uploadAdapter;
+    private historyAdapter;
+    private tiledeskUnsubs;
+    constructor(config: ChatClientConfig_2, opts?: {
+        uploadAdapter?: UploadAdapter_2;
+        historyAdapter?: ConversationHistoryAdapter_2;
+    });
+    private usesAikaara;
+    private usesTiledesk;
+    private initTiledeskTransport;
     connect(): Promise<void>;
-    sendMessage(content: string): Promise<void>;
+    private hydrateTiledeskHistory;
+    sendMessage(content: string, opts?: {
+        attributes?: Record<string, unknown>;
+        metadata?: Record<string, unknown>;
+    }): Promise<void>;
+    /**
+     * Upload a file via the configured UploadAdapter (client-side: file goes
+     * to the tenant's own backend, never through Aikaara). Then publish the
+     * Tiledesk file-message envelope so hooks_controller picks it up.
+     */
+    sendFile(file: File | Blob, opts?: {
+        caption?: string;
+    }): Promise<void>;
+    /**
+     * Trigger Tiledesk's CHAT_INITIATED event — required to kick off a bot flow
+     * for newly-created Tiledesk request groups.
+     */
+    initiateTiledeskChat(extraAttributes?: Record<string, unknown>): void;
+    /** Mark a Tiledesk message as read (publishes status=300 update). */
+    markTiledeskRead(messageId: string): void;
+    setUploadAdapter(adapter: UploadAdapter_2): void;
     sendUserEvent(eventKey: string, value?: object, source?: string): Promise<void>;
     loadHistory(): Promise<Message_2[]>;
     get messages(): Message_2[];
@@ -40,6 +71,8 @@ declare class AikaaraChatClient extends EventEmitter<ChatEvents> {
      */
     setContext(context: AppContext): Promise<void>;
     disconnect(): Promise<void>;
+    private handleTiledeskMessage;
+    private handleTiledeskStatusUpdate;
     /**
      * Parse structured action results from tool execution output.
      * When the agent calls tools like `edit_current_entity`, `save_current_entity`,
@@ -61,17 +94,38 @@ export declare class AikaaraChatHeader extends HTMLElement {
     setStatus(status: string): void;
 }
 
+/**
+ * Chat input box. Composes a textarea + send button + optional attach button.
+ *
+ * Events fired (composed:true so they cross shadow boundaries):
+ *   - `send`      `{ content: string }`           — user pressed enter / clicked send
+ *   - `file-pick` `{ file: File }`                — user selected a file to upload
+ *
+ * Attributes:
+ *   - `placeholder`     placeholder text
+ *   - `disable-attach`  hides the attach button (set when host has no uploadAdapter)
+ *   - `accept`          forwarded to the hidden <input type="file">
+ *   - `multiple`        allow selecting multiple files
+ */
 export declare class AikaaraChatInput extends HTMLElement {
     private shadow;
     private textarea;
     private sendBtn;
+    private attachBtn;
+    private fileInput;
     private _disabled;
+    private _uploading;
     constructor();
+    static get observedAttributes(): string[];
     connectedCallback(): void;
     set disabled(val: boolean);
     get disabled(): boolean;
+    /** Toggle the attach button into a "uploading…" spinner state. */
+    set uploading(val: boolean);
+    get uploading(): boolean;
     focus(): void;
     clear(): void;
+    private refreshSendDisabled;
     private handleSend;
     private autoGrow;
 }
@@ -87,6 +141,8 @@ export declare class AikaaraChatWidget extends HTMLElement {
     attributeChangedCallback(_name: string, oldVal: string, newVal: string): void;
     configure(config: Partial<WidgetConfig>): void;
     private getConfig;
+    setUploadAdapter(adapter: UploadAdapter): void;
+    setHistoryAdapter(adapter: ConversationHistoryAdapter): void;
     private render;
     private initController;
     sendUserEvent(eventKey: string, value?: Record<string, unknown>, source?: string): void;
@@ -106,11 +162,19 @@ export declare class AikaaraErrorBanner extends HTMLElement {
 
 export declare class AikaaraMessageBubble extends HTMLElement {
     private shadow;
+    private templatePayload;
+    private attachments;
     static get observedAttributes(): string[];
     constructor();
     connectedCallback(): void;
     attributeChangedCallback(): void;
+    setTemplatePayload(payload: unknown): void;
+    setAttachments(attachments: Array<{
+        fileName: string;
+        fileUrl: string;
+    }>): void;
     private render;
+    private renderAttachments;
 }
 
 export declare class AikaaraMessageList extends HTMLElement {
@@ -129,10 +193,46 @@ export declare class AikaaraMessageList extends HTMLElement {
     showTypingIndicator(): void;
     removeTypingIndicator(): void;
     private appendMessageElement;
+    /**
+     * Replace an existing rendered message (matched by id or externalId) in place.
+     * Used when a Tiledesk self-echo reconciles with an optimistic bubble or when
+     * a status update flips delivered → read.
+     */
+    upsertMessage(message: Message): void;
+    private findRenderedMessage;
     private scrollToBottom;
     private formatTime;
 }
 
+export declare class AikaaraModalAction extends HTMLElement {
+    private shadow;
+    private data;
+    private dismissed;
+    constructor();
+    connectedCallback(): void;
+    setPayload(payload: ModalActionPayload): void;
+    dismiss(): void;
+    private handleOk;
+    private render;
+}
+
+export declare class AikaaraOptionList extends HTMLElement {
+    private shadow;
+    private data;
+    private selected;
+    constructor();
+    connectedCallback(): void;
+    setPayload(payload: OptionListPayload): void;
+    /** Read selected values — used by parent submit action to collect form state. */
+    getValues(): {
+        name: string;
+        values: string[];
+        type: string;
+    };
+    private toggle;
+    private render;
+}
+
 export declare class AikaaraStreamingMessage extends HTMLElement {
     private shadow;
     private bubble;
@@ -142,6 +242,64 @@ export declare class AikaaraStreamingMessage extends HTMLElement {
     finalize(): void;
 }
 
+export declare class AikaaraSubmitAction extends HTMLElement {
+    private shadow;
+    private data;
+    constructor();
+    connectedCallback(): void;
+    setPayload(payload: SubmitActionPayload): void;
+    private collectFormValues;
+    private handleClick;
+    private render;
+}
+
+/**
+ * Centered grey pill used for system / metadata messages
+ * (e.g. "Group created", "Assigned to Taxbuddy AI").
+ *
+ * Theming knobs (CSS custom properties on :host or any ancestor):
+ *   --aikaara-system-pill-bg
+ *   --aikaara-system-pill-color
+ *   --aikaara-system-pill-radius
+ *   --aikaara-system-pill-padding
+ *   --aikaara-system-pill-font-size
+ *   --aikaara-system-pill-font-weight
+ *   --aikaara-system-pill-border
+ */
+export declare class AikaaraSystemPill extends HTMLElement {
+    private shadow;
+    static get observedAttributes(): string[];
+    constructor();
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    private render;
+}
+
+/**
+ * Renders the payload of a contentType=300 Tiledesk template. Walks the
+ * payload structure and mounts the right child component(s):
+ *   - { type: 'checkbox' | 'radio' | 'button' }     → <aikaara-option-list>
+ *   - { type: 'submit' }                            → <aikaara-submit-action>
+ *   - { type: 'modal' } / single object with `message + ok`  → <aikaara-modal-action>
+ *
+ * Tenants can override per-template UI by registering a custom element named
+ * `aikaara-template-{templateId}` (or by templateId-based slot). The renderer
+ * checks for that first; if present, it delegates the whole payload there.
+ */
+export declare class AikaaraTemplateRenderer extends HTMLElement {
+    private shadow;
+    private payloadData;
+    private innerMessage;
+    static get observedAttributes(): string[];
+    constructor();
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    setPayload(payload: unknown, innerMessage?: string): void;
+    private render;
+    private mountField;
+    private mountModal;
+}
+
 export declare class AikaaraTypingIndicator extends HTMLElement {
     private shadow;
     constructor();
@@ -172,11 +330,37 @@ declare interface ChatClientConfig extends ConnectionConfig {
     conversationId?: string;
     systemPromptId?: number;
     channel?: 'widget' | 'api' | 'sidekick';
+    /**
+     * Transport selection.
+     * - `aikaara` (default): ActionCable to Aikaara Rails (AI streaming).
+     * - `tiledesk`: MQTT direct to a self-hosted Tiledesk + chat21 stack.
+     * - `dual`: both — Aikaara cable for AI, Tiledesk MQTT for live-agent + file events.
+     */
+    transport?: TransportMode;
+    /**
+     * Tiledesk-side identity. Required when `transport` is `tiledesk` or `dual`.
+     * `userId` here is the Tiledesk user `_id` and is also used as the SDK conversation
+     * subject — Aikaara conversations bound to this user via ext_uid mapping.
+     */
+    tiledeskIdentity?: {
+        userId: string;
+        userName?: string;
+        departmentId?: string;
+        senderFullname?: string;
+    };
+    /**
+     * Tenant-level defaults merged into the `action` object of every template
+     * postback (e.g. submit-action click). Useful for app-specific keys like
+     * `serviceType: 'ITR'` that the bot expects on every form submission.
+     * Per-submit values from the form take precedence over these defaults.
+     */
+    templateActionAttributes?: Record<string, unknown>;
     onMessage?: (message: Message) => void;
     onStatusChange?: (status: string) => void;
     onError?: (error: Error) => void;
     onStreamUpdate?: (delta: string, fullContent: string) => void;
     onConnectionStateChange?: (state: ConnectionState) => void;
+    onTemplateMessage?: (template: TemplateMessageEvent) => void;
 }
 
 declare interface ChatClientConfig_2 extends ConnectionConfig_2 {
@@ -186,11 +370,37 @@ declare interface ChatClientConfig_2 extends ConnectionConfig_2 {
     conversationId?: string;
     systemPromptId?: number;
     channel?: 'widget' | 'api' | 'sidekick';
+    /**
+     * Transport selection.
+     * - `aikaara` (default): ActionCable to Aikaara Rails (AI streaming).
+     * - `tiledesk`: MQTT direct to a self-hosted Tiledesk + chat21 stack.
+     * - `dual`: both — Aikaara cable for AI, Tiledesk MQTT for live-agent + file events.
+     */
+    transport?: TransportMode_2;
+    /**
+     * Tiledesk-side identity. Required when `transport` is `tiledesk` or `dual`.
+     * `userId` here is the Tiledesk user `_id` and is also used as the SDK conversation
+     * subject — Aikaara conversations bound to this user via ext_uid mapping.
+     */
+    tiledeskIdentity?: {
+        userId: string;
+        userName?: string;
+        departmentId?: string;
+        senderFullname?: string;
+    };
+    /**
+     * Tenant-level defaults merged into the `action` object of every template
+     * postback (e.g. submit-action click). Useful for app-specific keys like
+     * `serviceType: 'ITR'` that the bot expects on every form submission.
+     * Per-submit values from the form take precedence over these defaults.
+     */
+    templateActionAttributes?: Record<string, unknown>;
     onMessage?: (message: Message_2) => void;
     onStatusChange?: (status: string) => void;
     onError?: (error: Error) => void;
     onStreamUpdate?: (delta: string, fullContent: string) => void;
     onConnectionStateChange?: (state: ConnectionState_2) => void;
+    onTemplateMessage?: (template: TemplateMessageEvent_2) => void;
 }
 
 declare interface ChatEvents {
@@ -255,6 +465,32 @@ declare type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 're
 
 declare type ConnectionState_2 = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
 
+/**
+ * Pluggable adapter that hydrates prior conversation messages on connect.
+ * The SDK calls this once after MQTT subscribes so the user sees existing
+ * history before any new live messages arrive.
+ */
+declare interface ConversationHistoryAdapter {
+    fetchMessages(conversationId: string, ctx: {
+        userId: string;
+        appId?: string;
+        projectId?: string;
+    }): Promise<TiledeskMessage[]>;
+}
+
+/**
+ * Pluggable adapter that hydrates prior conversation messages on connect.
+ * The SDK calls this once after MQTT subscribes so the user sees existing
+ * history before any new live messages arrive.
+ */
+declare interface ConversationHistoryAdapter_2 {
+    fetchMessages(conversationId: string, ctx: {
+        userId: string;
+        appId?: string;
+        projectId?: string;
+    }): Promise<TiledeskMessage_2[]>;
+}
+
 declare interface EditEntityAction {
     action: 'edit_entity';
     entity_type: string;
@@ -279,7 +515,7 @@ declare interface FieldUpdate {
 declare interface Message {
     id: string;
     conversationId: string;
-    role: 'user' | 'assistant' | 'system' | 'tool';
+    role: 'user' | 'assistant' | 'system' | 'tool' | 'agent';
     content: string;
     toolCalls?: ToolCall[];
     toolCallResults?: ToolCallResult;
@@ -287,13 +523,25 @@ declare interface Message {
     tokensOutput?: number;
     metadata?: Record<string, unknown>;
     createdAt: string;
-    status?: 'sending' | 'sent' | 'streaming' | 'complete' | 'error';
+    status?: 'sending' | 'sent' | 'delivered' | 'read' | 'streaming' | 'complete' | 'error';
+    externalId?: string;
+    template?: {
+        contentType?: string;
+        templateId?: string;
+        payload?: unknown;
+    };
+    attachments?: Array<{
+        fileName: string;
+        fileUrl: string;
+        cloudFileId?: string;
+        contentType?: string;
+    }>;
 }
 
 declare interface Message_2 {
     id: string;
     conversationId: string;
-    role: 'user' | 'assistant' | 'system' | 'tool';
+    role: 'user' | 'assistant' | 'system' | 'tool' | 'agent';
     content: string;
     toolCalls?: ToolCall_2[];
     toolCallResults?: ToolCallResult_2;
@@ -301,31 +549,274 @@ declare interface Message_2 {
     tokensOutput?: number;
     metadata?: Record<string, unknown>;
     createdAt: string;
-    status?: 'sending' | 'sent' | 'streaming' | 'complete' | 'error';
+    status?: 'sending' | 'sent' | 'delivered' | 'read' | 'streaming' | 'complete' | 'error';
+    externalId?: string;
+    template?: {
+        contentType?: string;
+        templateId?: string;
+        payload?: unknown;
+    };
+    attachments?: Array<{
+        fileName: string;
+        fileUrl: string;
+        cloudFileId?: string;
+        contentType?: string;
+    }>;
+}
+
+/**
+ * Modal-style action dialog. Bandhan uses these for blocking confirms
+ * (e.g. "Please tick the checkbox to proceed" with an Ok button).
+ *
+ * Payload shape (flexible — matches several bandhan modal templates):
+ *   { message: 'Please tick…', okLabel?: 'Ok', cancelLabel?: 'Cancel',
+ *     action?: { message, requestType } }
+ *
+ * On Ok the component fires `template-action` with the configured message
+ * (or the modal text itself) and dismisses. Cancel just dismisses.
+ *
+ * Theming:
+ *   --aikaara-modal-overlay-bg, --aikaara-modal-bg, --aikaara-modal-color,
+ *   --aikaara-modal-radius, --aikaara-modal-padding, --aikaara-modal-shadow,
+ *   --aikaara-modal-button-bg, --aikaara-modal-button-color,
+ *   --aikaara-modal-button-radius, --aikaara-modal-cancel-color
+ */
+declare interface ModalActionPayload {
+    message: string;
+    okLabel?: string;
+    cancelLabel?: string;
+    action?: {
+        message?: string;
+        requestType?: string;
+    };
 }
 
 declare interface NavigateAction {
     navigate_to: string;
 }
 
+/**
+ * Rendering for contentType=300 form fields with `type: 'checkbox' | 'radio' | 'button'`.
+ *
+ * Bandhan envelope:
+ *   { data: { name: 'IncomeSources', title: 'Income Sources',
+ *             options: [{ label, value }, ...] },
+ *     type: 'checkbox' | 'radio' | 'button' }
+ *
+ * Emits a `template-action` CustomEvent on selection. For `button` type the
+ * action fires immediately on click. For `checkbox`/`radio` the parent submit
+ * action collects values via `getValues()`.
+ *
+ * Theming:
+ *   --aikaara-option-bg, --aikaara-option-color, --aikaara-option-border,
+ *   --aikaara-option-radius, --aikaara-option-padding, --aikaara-option-gap,
+ *   --aikaara-option-selected-bg, --aikaara-option-selected-color,
+ *   --aikaara-option-selected-border, --aikaara-option-title-color,
+ *   --aikaara-option-title-font-size, --aikaara-option-title-font-weight
+ */
+declare interface OptionItem {
+    label: string;
+    value: string;
+}
+
+declare interface OptionListPayload {
+    name: string;
+    title?: string;
+    options: OptionItem[];
+    type: 'checkbox' | 'radio' | 'button';
+}
+
 export declare function registerComponents(): void;
 
 declare interface SaveEntityAction {
     action: 'save_entity';
 }
 
+/**
+ * Primary CTA submit button for contentType=300 forms.
+ *
+ * Bandhan envelope:
+ *   { data: { name: 'Confirm Income Sources', type: 'submit',
+ *             action: { message, formAction, requestType } },
+ *     type: 'submit' }
+ *
+ * On click, collects values from sibling AikaaraOptionList components
+ * (queried by walking up to the parent template renderer's children) and
+ * fires `template-action` with the action message + collected attributes.
+ *
+ * Theming:
+ *   --aikaara-submit-bg, --aikaara-submit-color, --aikaara-submit-border,
+ *   --aikaara-submit-radius, --aikaara-submit-padding,
+ *   --aikaara-submit-hover-bg, --aikaara-submit-disabled-opacity,
+ *   --aikaara-submit-font-size, --aikaara-submit-font-weight
+ */
+declare interface SubmitActionPayload {
+    name: string;
+    action: {
+        message: string;
+        formAction?: string;
+        requestType?: string;
+    };
+    /** id of the bot prompt that triggered this form, stamped on the postback */
+    messageId?: string;
+}
+
+declare interface TemplateMessageEvent {
+    messageId: string;
+    conversationId: string;
+    role: 'user' | 'assistant' | 'system' | 'agent';
+    contentType?: string;
+    templateId?: string;
+    payload?: unknown;
+    innerMessage?: string;
+    raw: unknown;
+}
+
+declare interface TemplateMessageEvent_2 {
+    messageId: string;
+    conversationId: string;
+    role: 'user' | 'assistant' | 'system' | 'agent';
+    contentType?: string;
+    templateId?: string;
+    payload?: unknown;
+    innerMessage?: string;
+    raw: unknown;
+}
+
 declare interface TestToolAction {
     action: 'test_tool';
     tool_id: number;
     parameters: Record<string, unknown>;
 }
 
+declare interface TiledeskFileTemplateConfig {
+    templateId: string;
+    headerImgSrc?: string;
+    type?: 'link' | 'image';
+    isDeepLink?: boolean;
+}
+
+declare interface TiledeskFileTemplateConfig_2 {
+    templateId: string;
+    headerImgSrc?: string;
+    type?: 'link' | 'image';
+    isDeepLink?: boolean;
+}
+
+declare interface TiledeskMessage {
+    text?: string;
+    type?: string;
+    sender?: string;
+    senderFullname?: string;
+    sender_fullname?: string;
+    recipient?: string;
+    recipient_fullname?: string;
+    channel_type?: string;
+    timestamp?: number;
+    app_id?: string;
+    message_id?: string;
+    status?: number;
+    attributes?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+
+declare interface TiledeskMessage_2 {
+    text?: string;
+    type?: string;
+    sender?: string;
+    senderFullname?: string;
+    sender_fullname?: string;
+    recipient?: string;
+    recipient_fullname?: string;
+    channel_type?: string;
+    timestamp?: number;
+    app_id?: string;
+    message_id?: string;
+    status?: number;
+    attributes?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+
+declare interface TiledeskMessageDefaults {
+    channelType?: string;
+    channel?: string;
+    requestChannel?: string;
+    platform?: string;
+    medium?: string;
+    departmentId?: string;
+    attributes?: Record<string, unknown>;
+}
+
+declare interface TiledeskMessageDefaults_2 {
+    channelType?: string;
+    channel?: string;
+    requestChannel?: string;
+    platform?: string;
+    medium?: string;
+    departmentId?: string;
+    attributes?: Record<string, unknown>;
+}
+
+declare interface TiledeskTopicTemplates {
+    inbound?: string;
+    inboundUpdate?: string;
+    outbound?: string;
+    presence?: string;
+    wildcardSubscribe?: string;
+}
+
+declare interface TiledeskTopicTemplates_2 {
+    inbound?: string;
+    inboundUpdate?: string;
+    outbound?: string;
+    presence?: string;
+    wildcardSubscribe?: string;
+}
+
 declare interface TiledeskTransportConfig {
     mqttEndpoint: string;
     jwtToken: string;
     userId: string;
     userName?: string;
     projectId: string;
+    appId?: string;
+    clientId?: string;
+    protocolVersion?: 3 | 4 | 5;
+    protocolId?: 'MQIsdp' | 'MQTT';
+    mqttUsername?: string;
+    connectTimeoutMs?: number;
+    keepAliveSec?: number;
+    maxReconnectAttempts?: number;
+    reconnectMaxDelayMs?: number;
+    tokenProvider?: () => Promise<string>;
+    wildcardSubscribe?: boolean;
+    subscribeQos?: 0 | 1 | 2;
+    publishQos?: 0 | 1 | 2;
+    publishRetain?: boolean;
+    enablePresence?: boolean;
+    presencePayloadConnected?: Record<string, unknown>;
+    presencePayloadDisconnected?: Record<string, unknown>;
+    topicTemplates?: TiledeskTopicTemplates;
+    messageDefaults?: TiledeskMessageDefaults;
+    fileTemplate?: TiledeskFileTemplateConfig;
+    recipientFullnameResolver?: (conversationId: string) => string | undefined;
+    senderFullname?: string;
+    /**
+     * If true (default), AikaaraChatClient publishes a `CHAT_INITIATED` event
+     * to the conversation's outbound topic on first connect — but only when
+     * the conversation history is empty (so reload of an in-flight chat
+     * doesn't replay the kickoff).
+     */
+    autoInitiateOnEmpty?: boolean;
+    /** Extra attributes merged into the auto-fired CHAT_INITIATED envelope. */
+    chatInitiatedAttributes?: Record<string, unknown>;
+    /**
+     * Log decoded MQTT frames to console as they're sent/received.
+     * Off by default — set true for debugging Tiledesk wire traffic.
+     */
+    debug?: boolean;
 }
 
 declare interface TiledeskTransportConfig_2 {
@@ -334,6 +825,42 @@ declare interface TiledeskTransportConfig_2 {
     userId: string;
     userName?: string;
     projectId: string;
+    appId?: string;
+    clientId?: string;
+    protocolVersion?: 3 | 4 | 5;
+    protocolId?: 'MQIsdp' | 'MQTT';
+    mqttUsername?: string;
+    connectTimeoutMs?: number;
+    keepAliveSec?: number;
+    maxReconnectAttempts?: number;
+    reconnectMaxDelayMs?: number;
+    tokenProvider?: () => Promise<string>;
+    wildcardSubscribe?: boolean;
+    subscribeQos?: 0 | 1 | 2;
+    publishQos?: 0 | 1 | 2;
+    publishRetain?: boolean;
+    enablePresence?: boolean;
+    presencePayloadConnected?: Record<string, unknown>;
+    presencePayloadDisconnected?: Record<string, unknown>;
+    topicTemplates?: TiledeskTopicTemplates_2;
+    messageDefaults?: TiledeskMessageDefaults_2;
+    fileTemplate?: TiledeskFileTemplateConfig_2;
+    recipientFullnameResolver?: (conversationId: string) => string | undefined;
+    senderFullname?: string;
+    /**
+     * If true (default), AikaaraChatClient publishes a `CHAT_INITIATED` event
+     * to the conversation's outbound topic on first connect — but only when
+     * the conversation history is empty (so reload of an in-flight chat
+     * doesn't replay the kickoff).
+     */
+    autoInitiateOnEmpty?: boolean;
+    /** Extra attributes merged into the auto-fired CHAT_INITIATED envelope. */
+    chatInitiatedAttributes?: Record<string, unknown>;
+    /**
+     * Log decoded MQTT frames to console as they're sent/received.
+     * Off by default — set true for debugging Tiledesk wire traffic.
+     */
+    debug?: boolean;
 }
 
 declare interface ToolCall {
@@ -364,6 +891,52 @@ declare interface ToolCallResult_2 {
     content: string;
 }
 
+declare type TransportMode = 'aikaara' | 'tiledesk' | 'dual';
+
+declare type TransportMode_2 = 'aikaara' | 'tiledesk' | 'dual';
+
+declare interface UploadAdapter {
+    upload(file: File | Blob, ctx: UploadAdapterContext): Promise<UploadAdapterResult>;
+}
+
+declare interface UploadAdapter_2 {
+    upload(file: File | Blob, ctx: UploadAdapterContext_2): Promise<UploadAdapterResult_2>;
+}
+
+declare interface UploadAdapterContext {
+    conversationId: string;
+    userId: string;
+    projectId?: string;
+    appId?: string;
+}
+
+declare interface UploadAdapterContext_2 {
+    conversationId: string;
+    userId: string;
+    projectId?: string;
+    appId?: string;
+}
+
+declare interface UploadAdapterResult {
+    url: string;
+    fileName: string;
+    cloudFileId?: string;
+    relativePath?: string;
+    contentType?: string;
+    byteSize?: number;
+    meta?: Record<string, unknown>;
+}
+
+declare interface UploadAdapterResult_2 {
+    url: string;
+    fileName: string;
+    cloudFileId?: string;
+    relativePath?: string;
+    contentType?: string;
+    byteSize?: number;
+    meta?: Record<string, unknown>;
+}
+
 declare interface WidgetConfig extends ChatClientConfig {
     position?: 'bottom-right' | 'bottom-left';
     offset?: {
@@ -386,6 +959,15 @@ declare interface WidgetConfig extends ChatClientConfig {
     showBubble?: boolean;
     bubbleText?: string;
     bubbleIcon?: string;
+    uploadAdapter?: UploadAdapter;
+    historyAdapter?: ConversationHistoryAdapter;
+    /**
+     * Display mode:
+     *   - `popup` (default): floating bubble in the corner, click to open panel.
+     *   - `embed`: render the chat panel inline at the host element's location,
+     *     filling its container. Bubble + open/close animation are skipped.
+     */
+    display?: 'popup' | 'embed';
 }
 
 export { }