@wallavi/widget 1.5.3 → 1.6.1

package/dist/index.d.mts

@@ -32,6 +32,8 @@ type Message = {
     id: string;
     role: "user" | "assistant";
     parts: MessagePart[];
+    /** Files the user attached to this message — stored for display in the chat thread. */
+    attachments?: AttachmentPayload[];
 };
 interface PageContext {
     /** Current URL or path (e.g. "/dashboard/agent/abc/agent-studio") */
@@ -88,6 +90,24 @@ interface ChatWidgetConfig {
         mcpIds?: string[];
         actionIds?: string[];
     };
+    /**
+     * Show the microphone button in the input area.
+     * The widget records audio, sends it to /api/chat/transcribe (Whisper),
+     * and fills the input with the transcript. The Wallavi engine only sees text.
+     * Silently hidden when the browser does not support MediaRecorder.
+     */
+    enableVoice?: boolean;
+    /**
+     * When true, the transcript is sent immediately without user review.
+     * Default false — transcript fills the input for the user to correct if needed.
+     */
+    voiceAutoSend?: boolean;
+    /**
+     * Show the paperclip button and enable drag-and-drop / clipboard-paste for file attachments.
+     * Supported types: CSV, TXT, PDF (text extracted as context), JPG, PNG, WebP, GIF (stored in Vercel Blob).
+     * Default: false.
+     */
+    enableAttachments?: boolean;
 }
 interface ChatWidgetProps extends ChatWidgetConfig {
     className?: string;
@@ -98,6 +118,32 @@ interface ChatWidgetProps extends ChatWidgetConfig {
     /** Controls which icon the expand button shows (expand vs minimize). */
     expanded?: boolean;
 }
+type AttachmentContentType = "text" | "image" | "unsupported";
+/** Wire-format DTO included in /api/chat/stream request when files are attached. */
+interface AttachmentPayload {
+    id: string;
+    name: string;
+    mimeType: string;
+    contentType: AttachmentContentType;
+    textContent?: string;
+    base64?: string;
+    /** Persistent public URL — set by upload.ts when Vercel Blob is configured. */
+    url?: string;
+    rowCount?: number;
+    truncated?: boolean;
+    sizeBytes: number;
+}
+type AttachmentStatus = "uploading" | "ready" | "error";
+/** Widget-local state for a pending/uploaded attachment. */
+interface Attachment {
+    id: string;
+    name: string;
+    mimeType: string;
+    sizeBytes: number;
+    status: AttachmentStatus;
+    payload?: AttachmentPayload;
+    errorMessage?: string;
+}
 declare function getContrastColor(hex: string): string;
 declare function formatToolName(name: string): string;
 
@@ -158,7 +204,7 @@ interface BubbleWidgetProps extends ChatWidgetConfig {
 }
 declare function BubbleWidget({ position: positionProp, width: widthProp, height: heightProp, expandedWidth, expandedHeight, keyboardShortcut: keyboardShortcutProp, shortcutKey, autoOpen: autoOpenProp, bubbleIconUrl: bubbleIconUrlProp, bubbleSize: bubbleSizeProp, panelClassName, autoConfig, hideBubble, isOpen: isOpenProp, onOpenChange, ...chatProps }: BubbleWidgetProps): react_jsx_runtime.JSX.Element;
 
-declare function ChatWidget({ agentId, workspaceId, agentName, displayName, profilePicture, userMessageColor, initialMessages, suggestedMessages, messagePlaceholder, watermark, watermarkLogoUrl, footer, theme, showThinking, regenerateMessage, persist, onNavigate, hideCloseButton, source, userContext, playgroundOverrides, className, onClose, onReset, onExpand, expanded, }: ChatWidgetProps): react_jsx_runtime.JSX.Element;
+declare function ChatWidget({ agentId, workspaceId, agentName, displayName, profilePicture, userMessageColor, initialMessages, suggestedMessages, messagePlaceholder, watermark, watermarkLogoUrl, footer, theme, showThinking, regenerateMessage, persist, onNavigate, hideCloseButton, source, userContext, playgroundOverrides, enableVoice, voiceAutoSend, enableAttachments, className, onClose, onReset, onExpand, expanded, }: ChatWidgetProps): react_jsx_runtime.JSX.Element;
 
 interface UseChatOptions {
     agentId: string;
@@ -180,10 +226,50 @@ interface UseChatReturn {
     streaming: boolean;
     threadId: string;
     send: (text?: string) => Promise<void>;
+    /** Queue attachments to be included in the next send() call. Cleared automatically after send. */
+    queueAttachments: (payloads: AttachmentPayload[]) => void;
     regenerate: () => Promise<void>;
     reset: () => void;
     selectPickerOption: (pickerId: string, paramName: string, value: string, label: string) => Promise<void>;
 }
 declare function useChat({ agentId, workspaceId, source, userContext, persist, onNavigate, playgroundOverrides, }: UseChatOptions): UseChatReturn;
 
-export { BubbleWidget, type BubbleWidgetProps, ChatWidget, type ChatWidgetConfig, type ChatWidgetProps, type Message, type MessagePart, type PageContext, type ToolPart, type UserContext, formatToolName, getContrastColor, useChat };
+type VoiceState = "idle" | "recording" | "transcribing" | "error";
+interface UseVoiceOptions {
+    agentId: string;
+    /** Defaults to NEXT_PUBLIC_API_URL or Wallavi production. */
+    apiUrl?: string;
+    /** Called with the final transcript text — wire to useChat.send() or setInput(). */
+    onTranscript: (text: string) => void;
+    onError?: (message: string) => void;
+}
+interface UseVoiceReturn {
+    voiceState: VoiceState;
+    /** false when browser doesn't support MediaRecorder or mic access is denied */
+    isSupported: boolean;
+    start: () => Promise<void>;
+    stop: () => void;
+}
+declare function useVoice({ agentId, apiUrl, onTranscript, onError }: UseVoiceOptions): UseVoiceReturn;
+
+interface UseAttachmentsOptions {
+    agentId: string;
+    /** Defaults to NEXT_PUBLIC_API_URL or Wallavi production. */
+    apiUrl?: string;
+    /** Maximum number of concurrent attachments. Default 5. */
+    maxFiles?: number;
+}
+interface UseAttachmentsReturn {
+    attachments: Attachment[];
+    /** Kick off upload for one or more files. Silently skips if maxFiles reached. */
+    attach: (files: FileList | File[]) => void;
+    remove: (id: string) => void;
+    clear: () => void;
+    /** true while any attachment is still uploading */
+    isUploading: boolean;
+    /** Ready attachments with text content (safe to include in chat request) */
+    readyPayloads: AttachmentPayload[];
+}
+declare function useAttachments({ agentId, apiUrl, maxFiles, }: UseAttachmentsOptions): UseAttachmentsReturn;
+
+export { type Attachment, type AttachmentContentType, type AttachmentPayload, type AttachmentStatus, BubbleWidget, type BubbleWidgetProps, ChatWidget, type ChatWidgetConfig, type ChatWidgetProps, type Message, type MessagePart, type PageContext, type ToolPart, type UseAttachmentsOptions, type UseAttachmentsReturn, type UseVoiceOptions, type UseVoiceReturn, type UserContext, type VoiceState, formatToolName, getContrastColor, useAttachments, useChat, useVoice };

package/dist/index.d.ts

@@ -32,6 +32,8 @@ type Message = {
     id: string;
     role: "user" | "assistant";
     parts: MessagePart[];
+    /** Files the user attached to this message — stored for display in the chat thread. */
+    attachments?: AttachmentPayload[];
 };
 interface PageContext {
     /** Current URL or path (e.g. "/dashboard/agent/abc/agent-studio") */
@@ -88,6 +90,24 @@ interface ChatWidgetConfig {
         mcpIds?: string[];
         actionIds?: string[];
     };
+    /**
+     * Show the microphone button in the input area.
+     * The widget records audio, sends it to /api/chat/transcribe (Whisper),
+     * and fills the input with the transcript. The Wallavi engine only sees text.
+     * Silently hidden when the browser does not support MediaRecorder.
+     */
+    enableVoice?: boolean;
+    /**
+     * When true, the transcript is sent immediately without user review.
+     * Default false — transcript fills the input for the user to correct if needed.
+     */
+    voiceAutoSend?: boolean;
+    /**
+     * Show the paperclip button and enable drag-and-drop / clipboard-paste for file attachments.
+     * Supported types: CSV, TXT, PDF (text extracted as context), JPG, PNG, WebP, GIF (stored in Vercel Blob).
+     * Default: false.
+     */
+    enableAttachments?: boolean;
 }
 interface ChatWidgetProps extends ChatWidgetConfig {
     className?: string;
@@ -98,6 +118,32 @@ interface ChatWidgetProps extends ChatWidgetConfig {
     /** Controls which icon the expand button shows (expand vs minimize). */
     expanded?: boolean;
 }
+type AttachmentContentType = "text" | "image" | "unsupported";
+/** Wire-format DTO included in /api/chat/stream request when files are attached. */
+interface AttachmentPayload {
+    id: string;
+    name: string;
+    mimeType: string;
+    contentType: AttachmentContentType;
+    textContent?: string;
+    base64?: string;
+    /** Persistent public URL — set by upload.ts when Vercel Blob is configured. */
+    url?: string;
+    rowCount?: number;
+    truncated?: boolean;
+    sizeBytes: number;
+}
+type AttachmentStatus = "uploading" | "ready" | "error";
+/** Widget-local state for a pending/uploaded attachment. */
+interface Attachment {
+    id: string;
+    name: string;
+    mimeType: string;
+    sizeBytes: number;
+    status: AttachmentStatus;
+    payload?: AttachmentPayload;
+    errorMessage?: string;
+}
 declare function getContrastColor(hex: string): string;
 declare function formatToolName(name: string): string;
 
@@ -158,7 +204,7 @@ interface BubbleWidgetProps extends ChatWidgetConfig {
 }
 declare function BubbleWidget({ position: positionProp, width: widthProp, height: heightProp, expandedWidth, expandedHeight, keyboardShortcut: keyboardShortcutProp, shortcutKey, autoOpen: autoOpenProp, bubbleIconUrl: bubbleIconUrlProp, bubbleSize: bubbleSizeProp, panelClassName, autoConfig, hideBubble, isOpen: isOpenProp, onOpenChange, ...chatProps }: BubbleWidgetProps): react_jsx_runtime.JSX.Element;
 
-declare function ChatWidget({ agentId, workspaceId, agentName, displayName, profilePicture, userMessageColor, initialMessages, suggestedMessages, messagePlaceholder, watermark, watermarkLogoUrl, footer, theme, showThinking, regenerateMessage, persist, onNavigate, hideCloseButton, source, userContext, playgroundOverrides, className, onClose, onReset, onExpand, expanded, }: ChatWidgetProps): react_jsx_runtime.JSX.Element;
+declare function ChatWidget({ agentId, workspaceId, agentName, displayName, profilePicture, userMessageColor, initialMessages, suggestedMessages, messagePlaceholder, watermark, watermarkLogoUrl, footer, theme, showThinking, regenerateMessage, persist, onNavigate, hideCloseButton, source, userContext, playgroundOverrides, enableVoice, voiceAutoSend, enableAttachments, className, onClose, onReset, onExpand, expanded, }: ChatWidgetProps): react_jsx_runtime.JSX.Element;
 
 interface UseChatOptions {
     agentId: string;
@@ -180,10 +226,50 @@ interface UseChatReturn {
     streaming: boolean;
     threadId: string;
     send: (text?: string) => Promise<void>;
+    /** Queue attachments to be included in the next send() call. Cleared automatically after send. */
+    queueAttachments: (payloads: AttachmentPayload[]) => void;
     regenerate: () => Promise<void>;
     reset: () => void;
     selectPickerOption: (pickerId: string, paramName: string, value: string, label: string) => Promise<void>;
 }
 declare function useChat({ agentId, workspaceId, source, userContext, persist, onNavigate, playgroundOverrides, }: UseChatOptions): UseChatReturn;
 
-export { BubbleWidget, type BubbleWidgetProps, ChatWidget, type ChatWidgetConfig, type ChatWidgetProps, type Message, type MessagePart, type PageContext, type ToolPart, type UserContext, formatToolName, getContrastColor, useChat };
+type VoiceState = "idle" | "recording" | "transcribing" | "error";
+interface UseVoiceOptions {
+    agentId: string;
+    /** Defaults to NEXT_PUBLIC_API_URL or Wallavi production. */
+    apiUrl?: string;
+    /** Called with the final transcript text — wire to useChat.send() or setInput(). */
+    onTranscript: (text: string) => void;
+    onError?: (message: string) => void;
+}
+interface UseVoiceReturn {
+    voiceState: VoiceState;
+    /** false when browser doesn't support MediaRecorder or mic access is denied */
+    isSupported: boolean;
+    start: () => Promise<void>;
+    stop: () => void;
+}
+declare function useVoice({ agentId, apiUrl, onTranscript, onError }: UseVoiceOptions): UseVoiceReturn;
+
+interface UseAttachmentsOptions {
+    agentId: string;
+    /** Defaults to NEXT_PUBLIC_API_URL or Wallavi production. */
+    apiUrl?: string;
+    /** Maximum number of concurrent attachments. Default 5. */
+    maxFiles?: number;
+}
+interface UseAttachmentsReturn {
+    attachments: Attachment[];
+    /** Kick off upload for one or more files. Silently skips if maxFiles reached. */
+    attach: (files: FileList | File[]) => void;
+    remove: (id: string) => void;
+    clear: () => void;
+    /** true while any attachment is still uploading */
+    isUploading: boolean;
+    /** Ready attachments with text content (safe to include in chat request) */
+    readyPayloads: AttachmentPayload[];
+}
+declare function useAttachments({ agentId, apiUrl, maxFiles, }: UseAttachmentsOptions): UseAttachmentsReturn;
+
+export { type Attachment, type AttachmentContentType, type AttachmentPayload, type AttachmentStatus, BubbleWidget, type BubbleWidgetProps, ChatWidget, type ChatWidgetConfig, type ChatWidgetProps, type Message, type MessagePart, type PageContext, type ToolPart, type UseAttachmentsOptions, type UseAttachmentsReturn, type UseVoiceOptions, type UseVoiceReturn, type UserContext, type VoiceState, formatToolName, getContrastColor, useAttachments, useChat, useVoice };