@paymanai/payman-ask-sdk 1.2.26 → 2.0.0

package/dist/index.d.mts

@@ -1,7 +1,8 @@
-import * as React from 'react';
+import * as React$1 from 'react';
 import React__default from 'react';
-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 { ChatCallbacks as ChatCallbacks$1, BaseChatConfig, MessageDisplay, WorkflowStage, StreamProgress, StreamingStep, UserActionRequest, SessionSummary } from '@paymanai/payman-typescript-ask-sdk';
+export { APIConfig, BaseChatConfig, ChunkDisplay, ConversationEntry, ConversationListResponse, MessageDisplay, MessageRole, PageInfo, SessionListResponse, SessionOwner, SessionSummary, StreamEvent, StreamOptions, StreamProgress, StreamingStep, UseChatV2Return, UseVoiceReturn, UserActionRequest, UserActionResult, UserActionState, UserActionType, V2EventProcessorState, VoiceCallbacks, VoiceConfig, VoicePermissions, VoiceResult, VoiceState, WorkflowStage, buildFormattedThinking, buildScopeKey, cancelUserAction, createInitialV2State, generateId, listConversations, listSessions, processStreamEventV2, resendUserAction, streamWorkflowEvents, submitUserAction, useChatV2, useVoice } from '@paymanai/payman-typescript-ask-sdk';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ClassValue } from 'clsx';
 
 type UserMessageActionsConfig = {
@@ -22,212 +23,142 @@ type MessageActionsConfig = {
     userMessageActions?: UserMessageActionsConfig;
     assistantMessageActions?: AssistantMessageActionsConfig;
 };
-type ChatConfig = ChatConfig$1 & {
-    /** Custom React component to render above the empty state text (e.g. logo, illustration). */
-    emptyStateComponent?: React__default.ReactNode;
-    /** Enable voice input (default: true) */
-    enableVoice?: boolean;
-    /** Voice language (default: "en-US") */
-    voiceLang?: string;
-    /** Voice interim results (default: true) */
-    voiceInterimResults?: boolean;
-    /** Voice continuous mode (default: true) */
-    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;
-    /**
-     * UI version to render.
-     *   1 = original component set
-     *   2 = redesigned chat UI (ChatGPT-style with thinking blocks, inline verification, etc.) — default
-     */
-    uiVersion?: 1 | 2;
+type ChatAvailability = {
+    state: "ready";
+} | {
+    state: "readOnly";
+} | {
+    state: "disabled";
+    reason?: React__default.ReactNode;
+};
+type VoiceOptions = {
+    /** Default: "en-US" */
+    lang?: string;
+    /** Default: true */
+    interimResults?: boolean;
+    /** Default: true */
+    continuous?: boolean;
+};
+type SessionHistoryOptions = {
+    /** Desktop sidebar default width in px. Default: 280 */
+    defaultWidth?: number;
+    /** Default: 240 */
+    minWidth?: number;
+    /** Default: 480 */
+    maxWidth?: number;
+    /** Desktop only. Default: false */
+    defaultCollapsed?: boolean;
+    /** Page size for listSessions. Default: 20 */
+    pageSize?: number;
+    /** localStorage key for width + collapsed. Default: `payman-chat-sidebar:${workflow.id}` */
+    persistKey?: string;
+};
+type ChatUIConfig = {
+    layout?: "centered" | "full-width";
+    agent?: {
+        /** Default: "Assistant" */
+        name?: string;
+        /** Default: true */
+        showName?: boolean;
+    };
+    emptyState?: {
+        /** Default: "What can I help with?" */
+        text?: string;
+        /** Default: true */
+        icon?: boolean;
+        /** Custom React node rendered above the empty-state text */
+        content?: React__default.ReactNode;
+    };
+    input?: {
+        /** Default: "Type your message..." */
+        placeholder?: string;
+        /** Default: false */
+        showResetButton?: boolean;
+        /**
+         * `true` (default) shows all attachment options, `false` hides the menu entirely.
+         * Pass an object to toggle individual options.
+         */
+        attachments?: boolean | {
+            uploadImage?: boolean;
+            attachFile?: boolean;
+        };
+        /** `true` enables voice with defaults. Pass an object to customize lang/interim/continuous. */
+        voice?: boolean | VoiceOptions;
+    };
+    messages?: {
+        /** `true` shows both sides; `false` hides both; pass object for per-role control. */
+        avatars?: boolean | {
+            user?: boolean;
+            assistant?: boolean;
+        };
+        /** Default: false */
+        timestamps?: boolean;
+        /** Default: true */
+        streamingDot?: boolean;
+        actions?: MessageActionsConfig;
+    };
+    execution?: {
+        /** Default: true */
+        showSteps?: boolean;
+        /** Default: "Completed in {time}s ({count} steps)" */
+        completedLabel?: string;
+        /** Default: "View progress ({count} steps)" */
+        streamingLabel?: string;
+    };
+    /** `true` enables the session-history sidebar with defaults; pass an object to customize. */
+    sessionHistory?: boolean | SessionHistoryOptions;
+};
+type ChatConfig = BaseChatConfig & {
+    availability?: ChatAvailability;
+    ui?: ChatUIConfig;
+    observability?: {
+        sentryDsn?: string;
+    };
 };
 type ChatCallbacks = ChatCallbacks$1 & {
-    /** Called when the session is reset (via SDK reset button or ref.resetSession()) */
     onResetSession?: () => 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) */
     resetSession: () => void;
-    /** Clear all messages without resetting session ID */
     clearMessages: () => void;
-    /** Cancel the current streaming operation */
     cancelStream: () => void;
-    /** Get the current session ID */
     getSessionId: () => string | undefined;
-    /** Get all messages */
     getMessages: () => MessageDisplay[];
+    /** Replace the active chat with a prior session's history. */
+    loadSession: (sessionId: string) => Promise<void>;
 };
 type PaymanChatProps = {
-    /** Chat configuration - includes API config */
     config: ChatConfig;
-    /** Callbacks for events */
     callbacks?: ChatCallbacks;
-    /** Custom class name */
     className?: string;
-    /** Custom style */
     style?: React__default.CSSProperties;
-    /** Custom children to render (e.g., header) */
     children?: React__default.ReactNode;
     /** Called when the user scrolls to the top — use to load older messages */
     onLoadMoreMessages?: () => void;
-    /** Show a loading spinner at the top of the list while fetching older messages */
-    isLoadingMoreMessages?: boolean;
-    /** Whether there are more messages to load (hides the spinner/trigger when false) */
-    hasMoreMessages?: boolean;
-};
-type ChatInputProps = {
-    /** Input value */
-    value: string;
-    /** On change handler */
-    onChange: (value: string) => void;
-    /** On send handler */
-    onSend: () => void;
-    /** On pause/cancel handler */
-    onPause?: () => void;
-    /** Disabled state */
-    disabled?: boolean;
-    /** Placeholder text */
-    placeholder?: string;
-    /** Is waiting for response */
-    isWaitingForResponse?: boolean;
-    /** Has selected session */
-    hasSelectedSession?: boolean;
-    /** Is session params configured */
-    isSessionParamsConfigured?: boolean;
-    /** On input click handler */
-    onClick?: () => void;
-    /** Input style variant */
-    inputStyle?: "rounded" | "flat";
-    /** Layout style */
-    layout?: "centered" | "full-width";
-    /** Custom class name */
-    className?: string;
-    /** Enable voice input in the chat input. When false, voice button is hidden. */
-    enableVoice?: boolean;
-    /** Voice button handler */
-    onVoicePress?: () => void;
-    /** Is voice available (e.g. speech recognition ready) */
-    voiceAvailable?: boolean;
-    /** Is currently recording voice */
-    isRecording?: boolean;
-    /** Recording duration in seconds (for voice bar timer) */
-    recordingDurationSeconds?: number;
-    /** Confirm voice recording (stop and apply transcript to input) */
-    onConfirmRecording?: () => void;
-    /** Cancel voice recording (stop without applying transcript) */
-    onCancelRecording?: () => void;
-    /** Live transcript while recording (used to animate waveforms only when user is talking) */
-    transcribedText?: string;
-    /** Show a reset/new session button in the input bar */
-    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;
-};
-type MessageListProps = {
-    /** Messages to display */
-    messages: MessageDisplay[];
-    /** Loading state */
-    isLoading?: boolean;
-    /** Empty state text */
-    emptyStateText?: string;
-    /** Show icon in empty state */
-    showEmptyStateIcon?: boolean;
-    /** Custom React component to render above the empty state text */
-    emptyStateComponent?: React__default.ReactNode;
-    /** Layout style */
-    layout?: "centered" | "full-width";
-    /** Show timestamps on messages */
-    showTimestamps?: boolean;
-    /** Stage */
-    stage?: WorkflowStage;
-    /** Animated */
-    animated?: boolean;
-    /** Show agent name */
-    showAgentName?: boolean;
-    /** Agent name */
-    agentName?: string;
-    /** Show avatars */
-    showAvatars?: boolean;
-    /** Show user avatar only (overrides showAvatars) */
-    showUserAvatar?: boolean;
-    /** Show assistant avatar only (overrides showAvatars) */
-    showAssistantAvatar?: boolean;
-    /** Show execution steps */
-    showExecutionSteps?: boolean;
-    /** Show streaming dot */
-    showStreamingDot?: boolean;
-    /** Custom streaming steps text */
-    streamingStepsText?: string;
-    /** Custom completed steps text */
-    completedStepsText?: string;
-    /** On execution trace click */
-    onExecutionTraceClick?: (data: {
-        message: MessageDisplay;
-        tracingData?: unknown;
-        executionId?: string;
-    }) => void;
-    /** Custom class name */
-    className?: string;
-    /** Called when the user scrolls to the top — use to load older messages */
-    onLoadMoreMessages?: () => void;
-    /** Show a loading spinner at the top while fetching older messages */
     isLoadingMoreMessages?: boolean;
-    /** Whether there are more messages to load */
     hasMoreMessages?: boolean;
-    /** 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. */
-    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 */
+    /**
+     * When true, the messages area shows a centered activity indicator
+     * instead of the (empty) message list. Used while the conversation
+     * history for a session is being fetched.
+     */
+    isLoadingSession?: boolean;
     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: {
@@ -238,210 +169,156 @@ type MessageListV2Props = {
         };
         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;
-    /** Stage */
-    stage?: WorkflowStage;
-    /** Animated */
-    animated?: boolean;
-    /** Show agent name */
-    showAgentName?: boolean;
-    /** Agent name */
-    agentName?: string;
-    /** Show avatars */
-    showAvatars?: boolean;
-    /** Show user avatar only (overrides showAvatars) */
-    showUserAvatar?: boolean;
-    /** Show assistant avatar only (overrides showAvatars) */
-    showAssistantAvatar?: boolean;
-    /** Layout style */
-    layout?: "centered" | "full-width";
-    /** Show timestamps on messages */
-    showTimestamps?: boolean;
-    /** Show execution steps */
-    showExecutionSteps?: boolean;
-    /** Show streaming dot */
-    showStreamingDot?: boolean;
-    /** Custom streaming steps text */
-    streamingStepsText?: string;
-    /** Custom completed steps text */
-    completedStepsText?: string;
-    /** On execution trace click */
-    onExecutionTraceClick?: (data: {
-        message: MessageDisplay;
-        tracingData?: unknown;
-        executionId?: string;
-    }) => void;
-};
-type UserMessageProps = {
-    /** Message to display */
-    message: MessageDisplay;
-    /** Animated */
-    animated?: boolean;
-    /** Show avatar */
-    showAvatar?: boolean;
-};
-type AgentMessageProps = {
-    /** Message to display */
-    message: MessageDisplay;
-    /** Stage */
-    stage?: WorkflowStage;
-    /** Animated */
-    animated?: boolean;
-    /** Show agent name */
-    showAgentName?: boolean;
-    /** Agent name */
-    agentName?: string;
-    /** Show avatar */
-    showAvatar?: boolean;
-    /** Layout style */
-    layout?: "centered" | "full-width";
-    /** Show timestamp */
-    showTimestamp?: boolean;
-    /** Show execution steps */
-    showExecutionSteps?: boolean;
-    /** Show streaming dot */
-    showStreamingDot?: boolean;
-    /** Custom streaming steps text */
-    streamingStepsText?: string;
-    /** Custom completed steps text */
-    completedStepsText?: string;
-    /** On execution trace click */
-    onExecutionTraceClick?: (data: {
-        message: MessageDisplay;
-        tracingData?: unknown;
-        executionId?: string;
-    }) => void;
-};
 type StreamingMessageProps = {
-    /** Streaming content */
     content: string;
-    /** Is currently streaming */
     isStreaming: boolean;
-    /** Current worker */
     currentWorker?: string;
-    /** Current message */
     currentMessage?: string;
-    /** Stream progress */
     streamProgress: StreamProgress;
-    /** "WORKFLOW_FAILED" and "STREAM_NOT_STARTED" show the friendly fallback; HTTP 409 conflicts render the backend message from the error payload. */
     error?: string;
-    /** Streaming steps */
     steps?: StreamingStep[];
 };
 type ChatHeaderProps = {
-    /** Session ID */
     sessionId?: string;
-    /** On copy session ID */
     onCopySessionId?: (sessionId: string) => void;
-    /** On load session click */
-    onLoadSession?: () => void;
-    /** On new session click */
     onNewSession?: () => void;
-    /** On session params click */
-    onSessionParamsClick?: () => void;
-    /** Show load session button */
-    showLoadSession?: boolean;
-    /** Show reset session button */
     showResetSession?: boolean;
-    /** Show session params button */
-    showSessionParams?: boolean;
-    /** Show session params tooltip */
-    showSessionParamsTooltip?: boolean;
-    /** Session params button ref */
-    sessionParamsButtonRef?: React__default.RefObject<HTMLButtonElement | null> | undefined;
-    /** Custom children */
+    /** Render a hamburger button on the left that toggles the session-history sidebar on mobile. */
+    onToggleSidebar?: () => void;
     children?: React__default.ReactNode;
-    /** Custom class name */
     className?: string;
 };
 type OtpInputProps = {
-    /** Current OTP value */
     value: string;
-    /** Called with new OTP value */
     onChange: (value: string) => void;
-    /** Number of digit boxes */
     maxLength: number;
-    /** Disabled state */
     disabled?: boolean;
-    /** Transient error state — triggers red borders + shake */
     error?: boolean;
 };
 type UserActionModalProps = {
-    /** Whether the modal is open */
     isOpen: boolean;
-    /** User action request data from the stream */
     userActionRequest: UserActionRequest | null;
-    /** Submit OTP */
     onApprove: (otp: string) => Promise<void>;
-    /** Reject / cancel */
     onReject: () => Promise<void>;
-    /** Resend OTP */
     onResend: () => Promise<void>;
-    /** Increment to externally clear OTP field */
     clearOtpTrigger: number;
 };
+type Stage = WorkflowStage;
 
-declare const PaymanChat: React.ForwardRefExoticComponent<PaymanChatProps & React.RefAttributes<PaymanChatRef>>;
+declare const PaymanChat: React$1.ForwardRefExoticComponent<PaymanChatProps & React$1.RefAttributes<PaymanChatRef>>;
 
-interface PaymanChatContextValue {
+type OptimisticSessionActivity = {
+    key: string;
+    sessionId: string;
+    previousSessionId?: string;
+    lastMessageAt: string;
+    sessionTitle?: string;
+};
+type SessionHistorySidebarProps = {
+    config: BaseChatConfig;
+    options: SessionHistoryOptions;
+    activeSessionId?: string;
+    /** Session id whose conversation history is currently being fetched.
+     * The matching row renders a small inline spinner next to its title. */
+    loadingSessionId?: string;
     /**
-     * Clear all messages and reset the chat
+     * Session ids that currently have an in-flight workflow stream. Each
+     * matching row renders a subtle running mark on the right of its title.
      */
-    resetSession: () => void;
+    streamingSessionIds?: ReadonlySet<string>;
     /**
-     * Clear all messages without resetting session ID
+     * Session ids whose stream completed recently. Each matching row briefly
+     * renders a check mark on the right of its title — the parent is
+     * expected to drop the id from the set after a few seconds so the mark
+     * goes away on its own.
      */
+    recentlyCompletedSessionIds?: ReadonlySet<string>;
+    optimisticActivity?: OptimisticSessionActivity | null;
+    /** Called when the user clicks a row. */
+    onSelectSession: (session: SessionSummary) => void;
+    /** Controlled mobile drawer open state. */
+    mobileOpen: boolean;
+    onMobileOpenChange: (open: boolean) => void;
+};
+declare function SessionHistorySidebar({ config, options, activeSessionId, loadingSessionId, streamingSessionIds, recentlyCompletedSessionIds, optimisticActivity, onSelectSession, mobileOpen, onMobileOpenChange, }: SessionHistorySidebarProps): react_jsx_runtime.JSX.Element;
+
+declare function ChatHeader({ sessionId, onCopySessionId, onNewSession, showResetSession, onToggleSidebar, children, className, }: ChatHeaderProps): react_jsx_runtime.JSX.Element;
+
+declare function UserActionModal({ isOpen, userActionRequest, onApprove, onReject, onResend, clearOtpTrigger, }: UserActionModalProps): react_jsx_runtime.JSX.Element | null;
+
+interface FloatingChatProps {
+    config: ChatConfig;
+    callbacks?: ChatCallbacks;
+    buttonPosition?: "bottom-right" | "bottom-left" | "top-right" | "top-left";
+    buttonSize?: "sm" | "md" | "lg";
+    buttonColor?: string;
+    buttonIcon?: React.ReactNode;
+    buttonIconUrl?: string;
+    windowWidth?: string | number;
+    windowHeight?: string | number;
+    headerTitle?: string;
+    headerSubtitle?: string;
+    headerAvatar?: string;
+    headerColor?: string;
+    defaultOpen?: boolean;
+    showNotificationBadge?: boolean;
+}
+declare function FloatingChat({ config, callbacks, buttonPosition, buttonSize, buttonColor, buttonIcon, buttonIconUrl, windowWidth, windowHeight, headerTitle, headerSubtitle, headerAvatar, headerColor, defaultOpen, showNotificationBadge, }: FloatingChatProps): react_jsx_runtime.JSX.Element;
+
+interface PaymanChatContextValue {
+    /** Clear all messages and reset the chat. */
+    resetSession: () => void;
+    /** Clear all messages without resetting the session id. */
     clearMessages: () => void;
-    /**
-     * Prepend older messages to the top of the list (e.g. from history pagination)
-     */
+    /** Prepend older messages (history pagination). */
     prependMessages: (messages: MessageDisplay[]) => void;
-    /**
-     * Cancel current streaming operation
-     */
+    /** Cancel the active stream. */
     cancelStream: () => void;
-    /**
-     * Get current session ID
-     */
+    /** Current session id, if any. */
     getSessionId: () => string | undefined;
-    /**
-     * Get all messages
-     */
+    /** All current messages. */
     getMessages: () => MessageDisplay[];
     /**
-     * Check if currently waiting for response
+     * Replace the active chat with a prior session's conversation history.
+     * Same call the built-in sidebar uses; exposed for advanced consumers.
      */
+    loadSession: (sessionId: string) => Promise<void>;
+    /** Whether a stream is currently in flight. */
     isWaitingForResponse: boolean;
 }
-declare const PaymanChatContext: React.Context<PaymanChatContextValue | undefined>;
+declare const PaymanChatContext: React$1.Context<PaymanChatContextValue | undefined>;
 /**
- * Hook to access PaymanChat controls from parent components
+ * Access PaymanChat controls from a child of `<PaymanChat>`.
  *
  * @example
  * ```tsx
- * function MyComponent() {
- *   const chat = usePaymanChat();
- *
- *   return (
- *     <>
- *       <button onClick={chat.resetSession}>Reset</button>
- *       <button onClick={chat.clearMessages}>Clear</button>
- *     </>
- *   );
- * }
+ * const chat = usePaymanChat();
+ * chat.loadSession(sessionId);
  * ```
  */
 declare function usePaymanChat(): PaymanChatContextValue;
 
+type UseSessionHistoryReturn = {
+    sessions: SessionSummary[];
+    isLoading: boolean;
+    error: Error | null;
+    hasNext: boolean;
+    loadMore: () => Promise<void>;
+    refresh: () => Promise<void>;
+    width: number;
+    setWidth: (px: number) => void;
+    collapsed: boolean;
+    setCollapsed: (value: boolean | ((prev: boolean) => boolean)) => void;
+    minWidth: number;
+    maxWidth: number;
+    isReady: boolean;
+};
+declare function useSessionHistory(config: BaseChatConfig, options?: SessionHistoryOptions, optimisticActivity?: OptimisticSessionActivity | null): UseSessionHistoryReturn;
+
 /**
  * Utility function to merge Tailwind CSS classes
  */
@@ -471,4 +348,12 @@ interface ChatSessionContext {
  */
 declare function captureSentryError(error: Error | string, context: ChatSessionContext): void;
 
-export { type AgentMessageProps, type AssistantMessageActionsConfig, type ChatCallbacks, type ChatConfig, type ChatHeaderProps, type ChatInputProps, type ChatSessionContext, 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, captureSentryError, cn, formatDate, usePaymanChat };
+/**
+ * Format an ISO timestamp as a human-friendly relative label:
+ *   "just now" / "Nm ago" / "Nh ago" / "Yesterday" / "<day>" (this week) / "Mon D" / "Mon D, YYYY"
+ *
+ * No dayjs / date-fns — deliberately ~0 bytes extra.
+ */
+declare function formatRelativeTime(iso: string, now?: Date): string;
+
+export { type AssistantMessageActionsConfig, type ChatAvailability, type ChatCallbacks, type ChatConfig, ChatHeader, type ChatHeaderProps, type ChatSessionContext, type ChatUIConfig, FloatingChat, type MessageActionsConfig, type MessageListV2Props, type OtpInputProps, PaymanChat, PaymanChatContext, type PaymanChatContextValue, type PaymanChatProps, type PaymanChatRef, type SessionHistoryOptions, SessionHistorySidebar, type Stage, type StreamingMessageProps, UserActionModal, type UserActionModalProps, type UserMessageActionsConfig, type VoiceOptions, captureSentryError, cn, formatDate, formatRelativeTime, usePaymanChat, useSessionHistory };