@wallavi/widget 1.7.0 → 1.7.1

package/dist/index.d.mts

@@ -86,6 +86,15 @@ interface CustomBackend {
         onClick: () => Promise<void>;
         loading?: boolean;
     };
+    voiceCall?: {
+        active: boolean;
+        token: string | null;
+        serverUrl: string | null;
+        start: () => Promise<void>;
+        stop: () => void;
+        loading: boolean;
+        error: string | null;
+    };
 }
 interface ChatWidgetConfig {
     agentId: string;
@@ -116,6 +125,7 @@ interface ChatWidgetConfig {
      */
     hideCloseButton?: boolean;
     source?: string;
+    envId?: string;
     userContext?: UserContext;
     /** Per-session tool overrides used by Playground (not persisted) */
     playgroundOverrides?: {
@@ -143,6 +153,8 @@ interface ChatWidgetConfig {
     enableAttachments?: boolean;
     /** When set, bypasses Wallavi AI and routes messages through this backend instead. */
     customBackend?: CustomBackend;
+    /** Callback fired when a debug-trace event arrives from the pipeline. Only emitted for source="playground". */
+    onDebugTrace?: (trace: Record<string, unknown>) => void;
 }
 interface ChatWidgetProps extends ChatWidgetConfig {
     className?: string;
@@ -263,11 +275,12 @@ interface BubbleWidgetProps extends Partial<ChatWidgetConfig> {
 }
 declare function BubbleWidget({ inboxToken, supportApiBase, requestHumanLabel, returnToAiLabel, 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, enableVoice, voiceAutoSend, enableAttachments, customBackend, className, onClose, onReset, onExpand, expanded, embedded, }: 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, customBackend, className, onClose, onReset, onExpand, expanded, embedded, envId, onDebugTrace, }: ChatWidgetProps): react_jsx_runtime.JSX.Element;
 
 interface UseChatOptions {
     agentId: string;
     workspaceId?: string;
+    envId?: string;
     source?: string;
     userContext?: UserContext;
     persist?: boolean;
@@ -291,8 +304,71 @@ interface UseChatReturn {
     regenerate: () => Promise<void>;
     reset: () => void;
     selectPickerOption: (pickerId: string, paramName: string, value: string, label: string) => Promise<void>;
+    /** Pipeline debug traces — only populated when source="playground" */
+    debugTraces: DebugTrace[];
+    voiceCall?: {
+        active: boolean;
+        token: string | null;
+        serverUrl: string | null;
+        start: () => Promise<void>;
+        stop: () => void;
+        loading: boolean;
+        error: string | null;
+    };
 }
-declare function useChat({ agentId, workspaceId, source, userContext, persist, onNavigate, playgroundOverrides, customBackend, }: UseChatOptions): UseChatReturn;
+/** Structured pipeline execution data emitted per-turn from the backend */
+interface DebugTrace {
+    threadId: string;
+    agentId: string;
+    sessionId: string;
+    turn: number;
+    timestamp: number;
+    durationMs: number;
+    userMessage: string;
+    assistantResponse: string;
+    router: {
+        intent: string;
+        capability: string;
+        complexity?: string;
+    };
+    tools: {
+        available: number;
+        selected: number;
+        executed: string[];
+        targetTool?: string;
+        selectedNames?: string[];
+    };
+    params: {
+        available: Record<string, string>;
+        missing: string[];
+    };
+    provider: {
+        name: string;
+        model: string;
+        fallbackCount: number;
+    };
+    tokens: {
+        input: number;
+        output: number;
+        total: number;
+    };
+    executionStatus: string;
+    flags: string[];
+}
+declare function useChat({ agentId, workspaceId, envId, source, userContext, persist, onNavigate, playgroundOverrides, customBackend, }: UseChatOptions): UseChatReturn;
+
+declare function PlanCard({ part, onSend, disabled, }: {
+    part: PlanPart;
+    onSend?: (text: string) => void;
+    disabled?: boolean;
+}): react_jsx_runtime.JSX.Element;
+
+declare function ToolCallBadge({ part }: {
+    part: ToolPart;
+}): react_jsx_runtime.JSX.Element;
+declare function ReasoningBlock({ text }: {
+    text: string;
+}): react_jsx_runtime.JSX.Element;
 
 interface UseSupportChatOptions {
     /** Inbox token from Wallavi Support dashboard. */
@@ -332,7 +408,7 @@ interface UseVoiceReturn {
     start: () => Promise<void>;
     stop: () => void;
 }
-declare function useVoice({ agentId, apiUrl, onTranscript, onError }: UseVoiceOptions): UseVoiceReturn;
+declare function useVoice({ agentId, apiUrl, onTranscript, onError, }: UseVoiceOptions): UseVoiceReturn;
 
 interface UseAttachmentsOptions {
     agentId: string;
@@ -354,4 +430,4 @@ interface UseAttachmentsReturn {
 }
 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 CustomBackend, type Message, type MessagePart, type PageContext, type ToolPart, type UseAttachmentsOptions, type UseAttachmentsReturn, type UseSupportChatOptions, type UseVoiceOptions, type UseVoiceReturn, type UserContext, type VoiceState, formatToolName, getContrastColor, useAttachments, useChat, useSupportChat, useVoice };
+export { type Attachment, type AttachmentContentType, type AttachmentPayload, type AttachmentStatus, BubbleWidget, type BubbleWidgetProps, ChatWidget, type ChatWidgetConfig, type ChatWidgetProps, type CustomBackend, type DebugTrace, type Message, type MessagePart, type PageContext, PlanCard, type PlanPart, ReasoningBlock, ToolCallBadge, type ToolPart, type UseAttachmentsOptions, type UseAttachmentsReturn, type UseChatOptions, type UseChatReturn, type UseSupportChatOptions, type UseVoiceOptions, type UseVoiceReturn, type UserContext, type VoiceState, formatToolName, getContrastColor, useAttachments, useChat, useSupportChat, useVoice };

package/dist/index.d.ts

@@ -86,6 +86,15 @@ interface CustomBackend {
         onClick: () => Promise<void>;
         loading?: boolean;
     };
+    voiceCall?: {
+        active: boolean;
+        token: string | null;
+        serverUrl: string | null;
+        start: () => Promise<void>;
+        stop: () => void;
+        loading: boolean;
+        error: string | null;
+    };
 }
 interface ChatWidgetConfig {
     agentId: string;
@@ -116,6 +125,7 @@ interface ChatWidgetConfig {
      */
     hideCloseButton?: boolean;
     source?: string;
+    envId?: string;
     userContext?: UserContext;
     /** Per-session tool overrides used by Playground (not persisted) */
     playgroundOverrides?: {
@@ -143,6 +153,8 @@ interface ChatWidgetConfig {
     enableAttachments?: boolean;
     /** When set, bypasses Wallavi AI and routes messages through this backend instead. */
     customBackend?: CustomBackend;
+    /** Callback fired when a debug-trace event arrives from the pipeline. Only emitted for source="playground". */
+    onDebugTrace?: (trace: Record<string, unknown>) => void;
 }
 interface ChatWidgetProps extends ChatWidgetConfig {
     className?: string;
@@ -263,11 +275,12 @@ interface BubbleWidgetProps extends Partial<ChatWidgetConfig> {
 }
 declare function BubbleWidget({ inboxToken, supportApiBase, requestHumanLabel, returnToAiLabel, 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, enableVoice, voiceAutoSend, enableAttachments, customBackend, className, onClose, onReset, onExpand, expanded, embedded, }: 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, customBackend, className, onClose, onReset, onExpand, expanded, embedded, envId, onDebugTrace, }: ChatWidgetProps): react_jsx_runtime.JSX.Element;
 
 interface UseChatOptions {
     agentId: string;
     workspaceId?: string;
+    envId?: string;
     source?: string;
     userContext?: UserContext;
     persist?: boolean;
@@ -291,8 +304,71 @@ interface UseChatReturn {
     regenerate: () => Promise<void>;
     reset: () => void;
     selectPickerOption: (pickerId: string, paramName: string, value: string, label: string) => Promise<void>;
+    /** Pipeline debug traces — only populated when source="playground" */
+    debugTraces: DebugTrace[];
+    voiceCall?: {
+        active: boolean;
+        token: string | null;
+        serverUrl: string | null;
+        start: () => Promise<void>;
+        stop: () => void;
+        loading: boolean;
+        error: string | null;
+    };
 }
-declare function useChat({ agentId, workspaceId, source, userContext, persist, onNavigate, playgroundOverrides, customBackend, }: UseChatOptions): UseChatReturn;
+/** Structured pipeline execution data emitted per-turn from the backend */
+interface DebugTrace {
+    threadId: string;
+    agentId: string;
+    sessionId: string;
+    turn: number;
+    timestamp: number;
+    durationMs: number;
+    userMessage: string;
+    assistantResponse: string;
+    router: {
+        intent: string;
+        capability: string;
+        complexity?: string;
+    };
+    tools: {
+        available: number;
+        selected: number;
+        executed: string[];
+        targetTool?: string;
+        selectedNames?: string[];
+    };
+    params: {
+        available: Record<string, string>;
+        missing: string[];
+    };
+    provider: {
+        name: string;
+        model: string;
+        fallbackCount: number;
+    };
+    tokens: {
+        input: number;
+        output: number;
+        total: number;
+    };
+    executionStatus: string;
+    flags: string[];
+}
+declare function useChat({ agentId, workspaceId, envId, source, userContext, persist, onNavigate, playgroundOverrides, customBackend, }: UseChatOptions): UseChatReturn;
+
+declare function PlanCard({ part, onSend, disabled, }: {
+    part: PlanPart;
+    onSend?: (text: string) => void;
+    disabled?: boolean;
+}): react_jsx_runtime.JSX.Element;
+
+declare function ToolCallBadge({ part }: {
+    part: ToolPart;
+}): react_jsx_runtime.JSX.Element;
+declare function ReasoningBlock({ text }: {
+    text: string;
+}): react_jsx_runtime.JSX.Element;
 
 interface UseSupportChatOptions {
     /** Inbox token from Wallavi Support dashboard. */
@@ -332,7 +408,7 @@ interface UseVoiceReturn {
     start: () => Promise<void>;
     stop: () => void;
 }
-declare function useVoice({ agentId, apiUrl, onTranscript, onError }: UseVoiceOptions): UseVoiceReturn;
+declare function useVoice({ agentId, apiUrl, onTranscript, onError, }: UseVoiceOptions): UseVoiceReturn;
 
 interface UseAttachmentsOptions {
     agentId: string;
@@ -354,4 +430,4 @@ interface UseAttachmentsReturn {
 }
 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 CustomBackend, type Message, type MessagePart, type PageContext, type ToolPart, type UseAttachmentsOptions, type UseAttachmentsReturn, type UseSupportChatOptions, type UseVoiceOptions, type UseVoiceReturn, type UserContext, type VoiceState, formatToolName, getContrastColor, useAttachments, useChat, useSupportChat, useVoice };
+export { type Attachment, type AttachmentContentType, type AttachmentPayload, type AttachmentStatus, BubbleWidget, type BubbleWidgetProps, ChatWidget, type ChatWidgetConfig, type ChatWidgetProps, type CustomBackend, type DebugTrace, type Message, type MessagePart, type PageContext, PlanCard, type PlanPart, ReasoningBlock, ToolCallBadge, type ToolPart, type UseAttachmentsOptions, type UseAttachmentsReturn, type UseChatOptions, type UseChatReturn, type UseSupportChatOptions, type UseVoiceOptions, type UseVoiceReturn, type UserContext, type VoiceState, formatToolName, getContrastColor, useAttachments, useChat, useSupportChat, useVoice };