@paymanai/payman-ask-sdk 1.2.22 → 1.2.24

package/README.md

@@ -117,6 +117,32 @@ function MyApp() {
 | `sessionParams` | `SessionParams` | | User session info |
 | `autoGenerateSessionId` | `boolean` | | Auto-generate session ID |
 | `hasAskPermission` | `boolean` | | Show/hide input (default: true) |
+| `uiVersion` | `1 \| 2` | | Render original UI or v2 UI |
+| `showResetSession` | `boolean` | | Show a New Session button in the input bar with a confirmation modal before reset (default: false) |
+| `showAttachmentButton` | `boolean` | | Show/hide the v2 attachment (+) menu button (default: true) |
+| `showUploadImageButton` | `boolean` | | Show/hide the v2 Upload image option (default: true) |
+| `showAttachFileButton` | `boolean` | | Show/hide the v2 Attach file option (default: true) |
+| `enableVoice` | `boolean` | | Show/hide the voice input button in the composer (default: false) |
+| `voiceLang` | `string` | | Speech recognition language (default: `en-US`) |
+| `voiceInterimResults` | `boolean` | | Enable interim voice transcription updates (default: true) |
+| `voiceContinuous` | `boolean` | | Keep listening continuously while recording (default: true) |
+| `messageActions` | `MessageActionsConfig` | | Configure visible actions for `userMessageActions` and `assistantMessageActions` in the v2 UI |
+
+`messageActions` shape:
+
+```ts
+messageActions: {
+  userMessageActions?: {
+    copy?: boolean;
+    edit?: boolean;
+    retry?: boolean;
+  };
+  assistantMessageActions?: {
+    copy?: boolean;
+    trace?: boolean;
+  };
+}
+```
 
 ### `APIConfig`
 
@@ -137,6 +163,9 @@ function MyApp() {
 | `onStreamStart` | `() => void` | Stream started |
 | `onStreamComplete` | `(message: MessageDisplay) => void` | Stream completed |
 | `onExecutionTraceClick` | `(data: unknown) => void` | Trace button clicked |
+| `onResetSession` | `() => void` | New Session/reset button clicked |
+| `onUploadImageClick` | `() => void` | v2 Upload image option clicked |
+| `onAttachFileClick` | `() => void` | v2 Attach file option clicked |
 
 ### Context API: `usePaymanChat()`
 
@@ -155,6 +184,7 @@ function MyApp() {
 - **[CONTEXT_API.md](./CONTEXT_API.md)** - Context API reference
 - **[ENDPOINTS.md](./ENDPOINTS.md)** - API endpoints guide
 - **[CHANGELOG.md](./CHANGELOG.md)** - Version history
+- **[docs/](./docs/README.md)** - V2 streaming events, styling, and CSS class reference (`uiVersion: 2`)
 
 ## Theming: Shimmer (active step text)
 

package/dist/index.d.mts

@@ -1,133 +1,30 @@
 import * as React from 'react';
 import React__default from 'react';
-import { UserActionResult, UserActionRequest } from '@paymanai/payman-typescript-ask-sdk';
-export { StreamEvent, StreamOptions, UseVoiceReturn, UserActionRequest, UserActionResult, UserActionState, VoiceCallbacks, VoiceConfig, VoicePermissions, VoiceState, cancelUserAction, generateId, resendUserAction, streamWorkflowEvents, submitUserAction, useChat, useVoice } from '@paymanai/payman-typescript-ask-sdk';
+import { MessageDisplay, WorkflowStage, ChatCallbacks as ChatCallbacks$1, ChatConfig as ChatConfig$1, StreamProgress, StreamingStep, UserActionRequest } from '@paymanai/payman-typescript-ask-sdk';
+export { APIConfig, ChunkDisplay, MessageDisplay, MessageRole, SessionParams, StreamEvent, StreamOptions, StreamProgress, StreamingStep, UseChatReturn, UseChatV2Return, UseVoiceReturn, UserActionRequest, UserActionResult, UserActionState, UserActionType, V2EventProcessorState, VoiceCallbacks, VoiceConfig, VoicePermissions, VoiceResult, VoiceState, WorkflowStage, buildFormattedThinking, cancelUserAction, createInitialV2State, generateId, processStreamEventV2, resendUserAction, streamWorkflowEvents, submitUserAction, useChat, useChatV2, useVoice } from '@paymanai/payman-typescript-ask-sdk';
 import { ClassValue } from 'clsx';
 
-type MessageRole = "user" | "assistant" | "system";
-type StreamProgress = "started" | "processing" | "completed" | "error";
-type WorkflowStage = "DEV" | "SANDBOX" | "PROD" | "ARCHIVED";
-type StreamingStep = {
-    id: string;
-    eventType: string;
-    message: string;
-    status: "in_progress" | "completed" | "error" | "pending";
-    timestamp: number;
-    elapsedMs?: number;
-    thinkingText?: string;
-    isThinking?: boolean;
+type UserMessageActionsConfig = {
+    /** Show copy action on user messages (default: true) */
+    copy?: boolean;
+    /** Show edit action on user messages (default: false) */
+    edit?: boolean;
+    /** Show retry/resend action on user messages (default: false) */
+    retry?: boolean;
 };
-type ChunkDisplay = {
-    id?: string;
-    text?: string;
-    similarityScore?: number;
-    rrfScore?: number;
+type AssistantMessageActionsConfig = {
+    /** Show copy action on assistant messages (default: true) */
+    copy?: boolean;
+    /** Show trace action on assistant messages (default: true, still requires callback) */
+    trace?: boolean;
 };
-type MessageDisplay = {
-    id: string;
-    sessionId?: string;
-    role: MessageRole;
-    content: string;
-    timestamp: string;
-    isError?: boolean;
-    /** "WORKFLOW_FAILED" and "STREAM_NOT_STARTED" show the friendly fallback; HTTP 409 conflicts render the backend message from the error payload. */
-    errorDetails?: string;
-    chunks?: ChunkDisplay[];
-    tracingData?: unknown;
-    executionId?: string;
-    isStreaming?: boolean;
-    streamingContent?: string;
-    currentWorker?: string;
-    currentMessage?: string;
-    streamProgress?: StreamProgress;
-    steps?: StreamingStep[];
-    isCancelled?: boolean;
-    currentExecutingStepId?: string;
-    /** Result of user action (OTP approval/rejection) */
-    userActionResult?: UserActionResult;
-    /** Current thinking block text (live, resets per block) */
-    activeThinkingText?: string;
-    /** All thinking accumulated across blocks (for post-stream display) */
-    allThinkingText?: string;
-    /** True while RAG image URLs are being resolved after the final response is shown */
-    isResolvingImages?: boolean;
+type MessageActionsConfig = {
+    userMessageActions?: UserMessageActionsConfig;
+    assistantMessageActions?: AssistantMessageActionsConfig;
 };
-type SessionParams = {
-    id?: string;
-    name?: string;
-    attributes?: Record<string, string>;
-};
-type APIConfig = {
-    /** Base API URL */
-    baseUrl: string;
-    /** Auth token */
-    authToken?: string;
-    /** Custom headers */
-    headers?: Record<string, string>;
-    /** API endpoint for streaming (default: /api/workflows/ask/stream) */
-    streamEndpoint?: string;
-    /** API endpoint for resolving RAG image URLs (default: /api/playground/ask/resolve-image-urls) */
-    resolveImagesEndpoint?: string;
-};
-type ChatConfig = {
-    /** API configuration - required for the library to make calls */
-    api: APIConfig;
-    /** Workflow name */
-    workflowName: string;
-    /** User ID for chatStore and activeStreamStore — required for context store messages management */
-    userId?: string;
-    /** Workflow version */
-    workflowVersion?: number;
-    /** Stage/Environment */
-    stage?: WorkflowStage;
-    /** Query param name for stage (default: 'stage'). Use e.g. 'workflowStage' if the API expects that name. */
-    stageQueryParam?: string;
-    /** Session params */
-    sessionParams?: SessionParams;
-    /** Custom placeholder text */
-    placeholder?: string;
-    /** Empty state text */
-    emptyStateText?: string;
-    /** Show icon in empty state */
-    showEmptyStateIcon?: boolean;
+type ChatConfig = ChatConfig$1 & {
     /** Custom React component to render above the empty state text (e.g. logo, illustration). */
     emptyStateComponent?: React__default.ReactNode;
-    /** Show agent name */
-    showAgentName?: boolean;
-    /** Agent name */
-    agentName?: string;
-    /** Show avatars for user and assistant messages */
-    showAvatars?: boolean;
-    /** Show user avatar only (overrides showAvatars for user messages) */
-    showUserAvatar?: boolean;
-    /** Show assistant avatar only (overrides showAvatars for assistant messages) */
-    showAssistantAvatar?: boolean;
-    /** Show execution steps section with "Completed in X.Xs" */
-    showExecutionSteps?: boolean;
-    /** Show animated dot indicator during streaming */
-    showStreamingDot?: boolean;
-    /** Custom text format for streaming steps button. Use {count} for step count. Default: "View progress ({count} steps)" */
-    streamingStepsText?: string;
-    /** Custom text format for completed steps button. Use {count} for step count, {time} for elapsed time. Default: "Completed in {time}s ({count} steps)" */
-    completedStepsText?: string;
-    /** Input style variant: "rounded" (yaak style) or "flat" (paygent-central style). Default: "rounded" */
-    inputStyle?: "rounded" | "flat";
-    /** Layout style: "centered" (durango style) or "full-width" (default). Default: "full-width" */
-    layout?: "centered" | "full-width";
-    /** Show timestamps on messages */
-    showTimestamps?: boolean;
-    /** Enable animations */
-    animated?: boolean;
-    /** Disable input */
-    disableInput?: boolean;
-    /** Has permission to ask */
-    hasAskPermission?: boolean;
-    /** Auto-generate session ID */
-    autoGenerateSessionId?: boolean;
-    /** Disable the entire chat and show disabled state */
-    isChatDisabled?: boolean;
-    /** Custom component to render when chat is disabled. If not provided, default disabled UI will be shown */
-    disabledComponent?: React__default.ReactNode;
     /** Enable voice input (default: true) */
     enableVoice?: boolean;
     /** Voice language (default: "en-US") */
@@ -138,36 +35,30 @@ type ChatConfig = {
     voiceContinuous?: boolean;
     /** Show a "New Session" reset button inside the input bar (default: false) */
     showResetSession?: boolean;
+    /** Show the v2 attachment (+) menu button in the input bar (default: true) */
+    showAttachmentButton?: boolean;
+    /** Show the v2 "Upload image" attachment option (default: true) */
+    showUploadImageButton?: boolean;
+    /** Show the v2 "Attach file" attachment option (default: true) */
+    showAttachFileButton?: boolean;
+    /** Configure which per-message actions are visible in the v2 UI */
+    messageActions?: MessageActionsConfig;
+    /** Sentry DSN for error monitoring. */
+    sentryDsn?: string;
     /**
-     * Sentry DSN for error monitoring.
-     * The library will initialise Sentry with this DSN if Sentry has not already
-     * been initialised by the host application.
+     * UI version to render.
+     *   1 = original component set
+     *   2 = redesigned chat UI (ChatGPT-style with thinking blocks, inline verification, etc.) — default
      */
-    sentryDsn?: string;
+    uiVersion?: 1 | 2;
 };
-type ChatCallbacks = {
-    /** Called when a message is sent (before API call) */
-    onMessageSent?: (message: string) => void;
-    /** Called when streaming starts */
-    onStreamStart?: () => void;
-    /** Called when streaming completes */
-    onStreamComplete?: (message: MessageDisplay) => void;
-    /** Called when an error occurs */
-    onError?: (error: Error) => void;
-    /** Called when execution trace is clicked - provides data instead of UI */
-    onExecutionTraceClick?: (data: {
-        message: MessageDisplay;
-        tracingData?: unknown;
-        executionId?: string;
-    }) => void;
-    /** Called when session ID changes */
-    onSessionIdChange?: (sessionId: string) => void;
+type ChatCallbacks = ChatCallbacks$1 & {
     /** Called when the session is reset (via SDK reset button or ref.resetSession()) */
     onResetSession?: () => void;
-    /** Called when a user action (e.g. OTP) is required */
-    onUserActionRequired?: (request: UserActionRequest) => void;
-    /** Called on user action events (SUCCESS, INVALID, EXPIRED, REJECTED, RESENT, FAILED) */
-    onUserActionEvent?: (eventType: string, message: string) => void;
+    /** Called when the v2 "Upload image" attachment option is clicked */
+    onUploadImageClick?: () => void;
+    /** Called when the v2 "Attach file" attachment option is clicked */
+    onAttachFileClick?: () => void;
 };
 type PaymanChatRef = {
     /** Clear all messages and reset the session (clears both stores + generates new session ID) */
@@ -246,6 +137,16 @@ type ChatInputProps = {
     showResetSession?: boolean;
     /** Handler called when the reset session button is clicked */
     onResetSession?: () => void;
+    /** Show the attachment (+) menu button */
+    showAttachmentButton?: boolean;
+    /** Show the "Upload image" attachment option */
+    showUploadImageButton?: boolean;
+    /** Show the "Attach file" attachment option */
+    showAttachFileButton?: boolean;
+    /** Handler called when the "Upload image" option is clicked */
+    onUploadImageClick?: () => void;
+    /** Handler called when the "Attach file" option is clicked */
+    onAttachFileClick?: () => void;
     /** React Native: called when the text input is focused (e.g. to scroll messages above the keyboard). */
     onInputFocus?: () => void;
 };
@@ -300,16 +201,50 @@ type MessageListProps = {
     isLoadingMoreMessages?: boolean;
     /** Whether there are more messages to load */
     hasMoreMessages?: boolean;
-    /**
-     * React Native: while true, keep scrolling to the end as layout updates (waiting for assistant reply).
-     */
+    /** React Native: while true, keep scrolling to the end as layout updates. */
     isWaitingForResponse?: boolean;
-    /**
-     * React Native: ref to register a no-arg function that scrolls the message list to the end.
-     * Used so the parent can scroll when the input is focused and the keyboard opens.
-     */
+    /** React Native: ref to register a no-arg function that scrolls the message list to the end. */
     scrollToEndHandleRef?: React__default.MutableRefObject<(() => void) | null>;
 };
+type MessageListV2Props = {
+    /** Messages to display */
+    messages: MessageDisplay[];
+    /** Whether an assistant response is currently streaming */
+    isStreaming?: boolean;
+    /** Edit a user message */
+    onEditUserMessage?: (messageId: string) => void;
+    /** Retry a user message */
+    onRetryUserMessage?: (messageId: string) => void;
+    /** Open a markdown image */
+    onImageClick?: (src: string, alt: string) => void;
+    /** Execution trace click handler */
+    onExecutionTraceClick?: (data: {
+        message: MessageDisplay;
+        tracingData?: unknown;
+        executionId?: string;
+    }) => void;
+    /** Which message actions are visible */
+    messageActions?: MessageActionsConfig;
+    /** Disable retry/resend actions while the chat is busy */
+    retryDisabled?: boolean;
+    /** Current user action card */
+    userAction?: {
+        messageId: string;
+        action: {
+            type: string;
+            message: string;
+            amount?: string;
+            payeeName?: string;
+        };
+        status: "pending" | "verifying" | "approved" | "rejected" | "error";
+    } | null;
+    /** Approve a user action */
+    onApproveAction?: (messageId: string, otp: string) => Promise<void>;
+    /** Reject a user action */
+    onRejectAction?: (messageId: string) => Promise<void>;
+    /** Resend a user action */
+    onResendAction?: (messageId: string) => Promise<void>;
+};
 type MessageRowProps = {
     /** Message to display */
     message: MessageDisplay;
@@ -517,4 +452,4 @@ declare function cn(...inputs: ClassValue[]): string;
  */
 declare function formatDate(timestamp: string | Date): string;
 
-export { type APIConfig, type AgentMessageProps, type ChatCallbacks, type ChatConfig, type ChatHeaderProps, type ChatInputProps, type ChunkDisplay, type MessageDisplay, type MessageListProps, type MessageRole, type MessageRowProps, type OtpInputProps, PaymanChat, PaymanChatContext, type PaymanChatContextValue, type PaymanChatProps, type PaymanChatRef, type SessionParams, type StreamProgress, type StreamingMessageProps, type StreamingStep, type UserActionModalProps, type UserMessageProps, type WorkflowStage, cn, formatDate, usePaymanChat };
+export { type AgentMessageProps, type AssistantMessageActionsConfig, type ChatCallbacks, type ChatConfig, type ChatHeaderProps, type ChatInputProps, type MessageActionsConfig, type MessageListProps, type MessageListV2Props, type MessageRowProps, type OtpInputProps, PaymanChat, PaymanChatContext, type PaymanChatContextValue, type PaymanChatProps, type PaymanChatRef, type StreamingMessageProps, type UserActionModalProps, type UserMessageActionsConfig, type UserMessageProps, cn, formatDate, usePaymanChat };

package/dist/index.d.ts

@@ -1,133 +1,30 @@
 import * as React from 'react';
 import React__default from 'react';
-import { UserActionResult, UserActionRequest } from '@paymanai/payman-typescript-ask-sdk';
-export { StreamEvent, StreamOptions, UseVoiceReturn, UserActionRequest, UserActionResult, UserActionState, VoiceCallbacks, VoiceConfig, VoicePermissions, VoiceState, cancelUserAction, generateId, resendUserAction, streamWorkflowEvents, submitUserAction, useChat, useVoice } from '@paymanai/payman-typescript-ask-sdk';
+import { MessageDisplay, WorkflowStage, ChatCallbacks as ChatCallbacks$1, ChatConfig as ChatConfig$1, StreamProgress, StreamingStep, UserActionRequest } from '@paymanai/payman-typescript-ask-sdk';
+export { APIConfig, ChunkDisplay, MessageDisplay, MessageRole, SessionParams, StreamEvent, StreamOptions, StreamProgress, StreamingStep, UseChatReturn, UseChatV2Return, UseVoiceReturn, UserActionRequest, UserActionResult, UserActionState, UserActionType, V2EventProcessorState, VoiceCallbacks, VoiceConfig, VoicePermissions, VoiceResult, VoiceState, WorkflowStage, buildFormattedThinking, cancelUserAction, createInitialV2State, generateId, processStreamEventV2, resendUserAction, streamWorkflowEvents, submitUserAction, useChat, useChatV2, useVoice } from '@paymanai/payman-typescript-ask-sdk';
 import { ClassValue } from 'clsx';
 
-type MessageRole = "user" | "assistant" | "system";
-type StreamProgress = "started" | "processing" | "completed" | "error";
-type WorkflowStage = "DEV" | "SANDBOX" | "PROD" | "ARCHIVED";
-type StreamingStep = {
-    id: string;
-    eventType: string;
-    message: string;
-    status: "in_progress" | "completed" | "error" | "pending";
-    timestamp: number;
-    elapsedMs?: number;
-    thinkingText?: string;
-    isThinking?: boolean;
+type UserMessageActionsConfig = {
+    /** Show copy action on user messages (default: true) */
+    copy?: boolean;
+    /** Show edit action on user messages (default: false) */
+    edit?: boolean;
+    /** Show retry/resend action on user messages (default: false) */
+    retry?: boolean;
 };
-type ChunkDisplay = {
-    id?: string;
-    text?: string;
-    similarityScore?: number;
-    rrfScore?: number;
+type AssistantMessageActionsConfig = {
+    /** Show copy action on assistant messages (default: true) */
+    copy?: boolean;
+    /** Show trace action on assistant messages (default: true, still requires callback) */
+    trace?: boolean;
 };
-type MessageDisplay = {
-    id: string;
-    sessionId?: string;
-    role: MessageRole;
-    content: string;
-    timestamp: string;
-    isError?: boolean;
-    /** "WORKFLOW_FAILED" and "STREAM_NOT_STARTED" show the friendly fallback; HTTP 409 conflicts render the backend message from the error payload. */
-    errorDetails?: string;
-    chunks?: ChunkDisplay[];
-    tracingData?: unknown;
-    executionId?: string;
-    isStreaming?: boolean;
-    streamingContent?: string;
-    currentWorker?: string;
-    currentMessage?: string;
-    streamProgress?: StreamProgress;
-    steps?: StreamingStep[];
-    isCancelled?: boolean;
-    currentExecutingStepId?: string;
-    /** Result of user action (OTP approval/rejection) */
-    userActionResult?: UserActionResult;
-    /** Current thinking block text (live, resets per block) */
-    activeThinkingText?: string;
-    /** All thinking accumulated across blocks (for post-stream display) */
-    allThinkingText?: string;
-    /** True while RAG image URLs are being resolved after the final response is shown */
-    isResolvingImages?: boolean;
+type MessageActionsConfig = {
+    userMessageActions?: UserMessageActionsConfig;
+    assistantMessageActions?: AssistantMessageActionsConfig;
 };
-type SessionParams = {
-    id?: string;
-    name?: string;
-    attributes?: Record<string, string>;
-};
-type APIConfig = {
-    /** Base API URL */
-    baseUrl: string;
-    /** Auth token */
-    authToken?: string;
-    /** Custom headers */
-    headers?: Record<string, string>;
-    /** API endpoint for streaming (default: /api/workflows/ask/stream) */
-    streamEndpoint?: string;
-    /** API endpoint for resolving RAG image URLs (default: /api/playground/ask/resolve-image-urls) */
-    resolveImagesEndpoint?: string;
-};
-type ChatConfig = {
-    /** API configuration - required for the library to make calls */
-    api: APIConfig;
-    /** Workflow name */
-    workflowName: string;
-    /** User ID for chatStore and activeStreamStore — required for context store messages management */
-    userId?: string;
-    /** Workflow version */
-    workflowVersion?: number;
-    /** Stage/Environment */
-    stage?: WorkflowStage;
-    /** Query param name for stage (default: 'stage'). Use e.g. 'workflowStage' if the API expects that name. */
-    stageQueryParam?: string;
-    /** Session params */
-    sessionParams?: SessionParams;
-    /** Custom placeholder text */
-    placeholder?: string;
-    /** Empty state text */
-    emptyStateText?: string;
-    /** Show icon in empty state */
-    showEmptyStateIcon?: boolean;
+type ChatConfig = ChatConfig$1 & {
     /** Custom React component to render above the empty state text (e.g. logo, illustration). */
     emptyStateComponent?: React__default.ReactNode;
-    /** Show agent name */
-    showAgentName?: boolean;
-    /** Agent name */
-    agentName?: string;
-    /** Show avatars for user and assistant messages */
-    showAvatars?: boolean;
-    /** Show user avatar only (overrides showAvatars for user messages) */
-    showUserAvatar?: boolean;
-    /** Show assistant avatar only (overrides showAvatars for assistant messages) */
-    showAssistantAvatar?: boolean;
-    /** Show execution steps section with "Completed in X.Xs" */
-    showExecutionSteps?: boolean;
-    /** Show animated dot indicator during streaming */
-    showStreamingDot?: boolean;
-    /** Custom text format for streaming steps button. Use {count} for step count. Default: "View progress ({count} steps)" */
-    streamingStepsText?: string;
-    /** Custom text format for completed steps button. Use {count} for step count, {time} for elapsed time. Default: "Completed in {time}s ({count} steps)" */
-    completedStepsText?: string;
-    /** Input style variant: "rounded" (yaak style) or "flat" (paygent-central style). Default: "rounded" */
-    inputStyle?: "rounded" | "flat";
-    /** Layout style: "centered" (durango style) or "full-width" (default). Default: "full-width" */
-    layout?: "centered" | "full-width";
-    /** Show timestamps on messages */
-    showTimestamps?: boolean;
-    /** Enable animations */
-    animated?: boolean;
-    /** Disable input */
-    disableInput?: boolean;
-    /** Has permission to ask */
-    hasAskPermission?: boolean;
-    /** Auto-generate session ID */
-    autoGenerateSessionId?: boolean;
-    /** Disable the entire chat and show disabled state */
-    isChatDisabled?: boolean;
-    /** Custom component to render when chat is disabled. If not provided, default disabled UI will be shown */
-    disabledComponent?: React__default.ReactNode;
     /** Enable voice input (default: true) */
     enableVoice?: boolean;
     /** Voice language (default: "en-US") */
@@ -138,36 +35,30 @@ type ChatConfig = {
     voiceContinuous?: boolean;
     /** Show a "New Session" reset button inside the input bar (default: false) */
     showResetSession?: boolean;
+    /** Show the v2 attachment (+) menu button in the input bar (default: true) */
+    showAttachmentButton?: boolean;
+    /** Show the v2 "Upload image" attachment option (default: true) */
+    showUploadImageButton?: boolean;
+    /** Show the v2 "Attach file" attachment option (default: true) */
+    showAttachFileButton?: boolean;
+    /** Configure which per-message actions are visible in the v2 UI */
+    messageActions?: MessageActionsConfig;
+    /** Sentry DSN for error monitoring. */
+    sentryDsn?: string;
     /**
-     * Sentry DSN for error monitoring.
-     * The library will initialise Sentry with this DSN if Sentry has not already
-     * been initialised by the host application.
+     * UI version to render.
+     *   1 = original component set
+     *   2 = redesigned chat UI (ChatGPT-style with thinking blocks, inline verification, etc.) — default
      */
-    sentryDsn?: string;
+    uiVersion?: 1 | 2;
 };
-type ChatCallbacks = {
-    /** Called when a message is sent (before API call) */
-    onMessageSent?: (message: string) => void;
-    /** Called when streaming starts */
-    onStreamStart?: () => void;
-    /** Called when streaming completes */
-    onStreamComplete?: (message: MessageDisplay) => void;
-    /** Called when an error occurs */
-    onError?: (error: Error) => void;
-    /** Called when execution trace is clicked - provides data instead of UI */
-    onExecutionTraceClick?: (data: {
-        message: MessageDisplay;
-        tracingData?: unknown;
-        executionId?: string;
-    }) => void;
-    /** Called when session ID changes */
-    onSessionIdChange?: (sessionId: string) => void;
+type ChatCallbacks = ChatCallbacks$1 & {
     /** Called when the session is reset (via SDK reset button or ref.resetSession()) */
     onResetSession?: () => void;
-    /** Called when a user action (e.g. OTP) is required */
-    onUserActionRequired?: (request: UserActionRequest) => void;
-    /** Called on user action events (SUCCESS, INVALID, EXPIRED, REJECTED, RESENT, FAILED) */
-    onUserActionEvent?: (eventType: string, message: string) => void;
+    /** Called when the v2 "Upload image" attachment option is clicked */
+    onUploadImageClick?: () => void;
+    /** Called when the v2 "Attach file" attachment option is clicked */
+    onAttachFileClick?: () => void;
 };
 type PaymanChatRef = {
     /** Clear all messages and reset the session (clears both stores + generates new session ID) */
@@ -246,6 +137,16 @@ type ChatInputProps = {
     showResetSession?: boolean;
     /** Handler called when the reset session button is clicked */
     onResetSession?: () => void;
+    /** Show the attachment (+) menu button */
+    showAttachmentButton?: boolean;
+    /** Show the "Upload image" attachment option */
+    showUploadImageButton?: boolean;
+    /** Show the "Attach file" attachment option */
+    showAttachFileButton?: boolean;
+    /** Handler called when the "Upload image" option is clicked */
+    onUploadImageClick?: () => void;
+    /** Handler called when the "Attach file" option is clicked */
+    onAttachFileClick?: () => void;
     /** React Native: called when the text input is focused (e.g. to scroll messages above the keyboard). */
     onInputFocus?: () => void;
 };
@@ -300,16 +201,50 @@ type MessageListProps = {
     isLoadingMoreMessages?: boolean;
     /** Whether there are more messages to load */
     hasMoreMessages?: boolean;
-    /**
-     * React Native: while true, keep scrolling to the end as layout updates (waiting for assistant reply).
-     */
+    /** React Native: while true, keep scrolling to the end as layout updates. */
     isWaitingForResponse?: boolean;
-    /**
-     * React Native: ref to register a no-arg function that scrolls the message list to the end.
-     * Used so the parent can scroll when the input is focused and the keyboard opens.
-     */
+    /** React Native: ref to register a no-arg function that scrolls the message list to the end. */
     scrollToEndHandleRef?: React__default.MutableRefObject<(() => void) | null>;
 };
+type MessageListV2Props = {
+    /** Messages to display */
+    messages: MessageDisplay[];
+    /** Whether an assistant response is currently streaming */
+    isStreaming?: boolean;
+    /** Edit a user message */
+    onEditUserMessage?: (messageId: string) => void;
+    /** Retry a user message */
+    onRetryUserMessage?: (messageId: string) => void;
+    /** Open a markdown image */
+    onImageClick?: (src: string, alt: string) => void;
+    /** Execution trace click handler */
+    onExecutionTraceClick?: (data: {
+        message: MessageDisplay;
+        tracingData?: unknown;
+        executionId?: string;
+    }) => void;
+    /** Which message actions are visible */
+    messageActions?: MessageActionsConfig;
+    /** Disable retry/resend actions while the chat is busy */
+    retryDisabled?: boolean;
+    /** Current user action card */
+    userAction?: {
+        messageId: string;
+        action: {
+            type: string;
+            message: string;
+            amount?: string;
+            payeeName?: string;
+        };
+        status: "pending" | "verifying" | "approved" | "rejected" | "error";
+    } | null;
+    /** Approve a user action */
+    onApproveAction?: (messageId: string, otp: string) => Promise<void>;
+    /** Reject a user action */
+    onRejectAction?: (messageId: string) => Promise<void>;
+    /** Resend a user action */
+    onResendAction?: (messageId: string) => Promise<void>;
+};
 type MessageRowProps = {
     /** Message to display */
     message: MessageDisplay;
@@ -517,4 +452,4 @@ declare function cn(...inputs: ClassValue[]): string;
  */
 declare function formatDate(timestamp: string | Date): string;
 
-export { type APIConfig, type AgentMessageProps, type ChatCallbacks, type ChatConfig, type ChatHeaderProps, type ChatInputProps, type ChunkDisplay, type MessageDisplay, type MessageListProps, type MessageRole, type MessageRowProps, type OtpInputProps, PaymanChat, PaymanChatContext, type PaymanChatContextValue, type PaymanChatProps, type PaymanChatRef, type SessionParams, type StreamProgress, type StreamingMessageProps, type StreamingStep, type UserActionModalProps, type UserMessageProps, type WorkflowStage, cn, formatDate, usePaymanChat };
+export { type AgentMessageProps, type AssistantMessageActionsConfig, type ChatCallbacks, type ChatConfig, type ChatHeaderProps, type ChatInputProps, type MessageActionsConfig, type MessageListProps, type MessageListV2Props, type MessageRowProps, type OtpInputProps, PaymanChat, PaymanChatContext, type PaymanChatContextValue, type PaymanChatProps, type PaymanChatRef, type StreamingMessageProps, type UserActionModalProps, type UserMessageActionsConfig, type UserMessageProps, cn, formatDate, usePaymanChat };