@paymanai/payman-ask-sdk 2.0.6 → 4.0.1

package/dist/index.d.mts

@@ -1,8 +1,7 @@
-import * as React$1 from 'react';
+import * as React from 'react';
 import React__default from 'react';
-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 { MessageDisplay, AgentStage, ChatCallbacks as ChatCallbacks$1, ChatConfig as ChatConfig$1, StreamProgress, StreamingStep, UserActionRequest } from '@paymanai/payman-typescript-ask-sdk';
+export { APIConfig, AgentStage, ChunkDisplay, MessageDisplay, MessageRole, SessionParams, StreamEvent, StreamOptions, StreamProgress, StreamingStep, UseChatV2Return, UseVoiceReturn, UserActionRequest, UserActionResult, UserActionState, UserActionType, V2EventProcessorState, VoiceCallbacks, VoiceConfig, VoicePermissions, VoiceResult, VoiceState, buildFormattedThinking, cancelUserAction, createInitialV2State, generateId, processStreamEventV2, resendUserAction, streamWorkflowEvents, submitUserAction, useChatV2, useVoice } from '@paymanai/payman-typescript-ask-sdk';
 import { ClassValue } from 'clsx';
 
 type UserMessageActionsConfig = {
@@ -18,189 +17,266 @@ type AssistantMessageActionsConfig = {
     copy?: boolean;
     /** Show trace action on assistant messages (default: true, still requires callback) */
     trace?: boolean;
+    /** Show thumbs-up feedback button (default: true) */
+    thumbsUp?: boolean;
+    /** Show thumbs-down feedback button (default: true) */
+    thumbsDown?: boolean;
 };
 type MessageActionsConfig = {
     userMessageActions?: UserMessageActionsConfig;
     assistantMessageActions?: AssistantMessageActionsConfig;
 };
-type ChatAvailability = {
-    state: "ready";
-} | {
-    state: "readOnly";
-} | {
-    state: "disabled";
-    reason?: React__default.ReactNode;
+type SlashCommandConfig = {
+    /** Slash command token, including the leading slash. Example: /draft-knowledge */
+    name: string;
+    /** One-line description shown in autocomplete. */
+    description: string;
+    /** Text inserted into the input. Defaults to `${name} `. */
+    insertText?: string;
+    /** Show only when at least one permission is present. */
+    requiredAnyPermissions?: string[];
 };
-type VoiceOptions = {
-    /** Default: "en-US" */
-    lang?: string;
-    /** Default: true */
-    interimResults?: boolean;
-    /** Default: true */
-    continuous?: boolean;
-};
-type SessionHistoryOptions = {
-    /** Desktop sidebar default width in px. Default: 260 */
-    defaultWidth?: number;
-    /** Default: 220 */
-    minWidth?: number;
-    /** Default: 440 */
-    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;
-    /** Show a sidebar "New Session" button wired to the chat reset flow. Default: false */
-    showNewSessionButton?: boolean;
-};
-type EmptyStatePromptCategory = {
-    /** Label shown in the category bubble, e.g. "Account". Also used as the accessible name for the prompt group. */
-    label: string;
-    /** Optional icon rendered before the label in the category bubble. */
-    icon?: React__default.ReactNode;
-    /** Prompt strings; clicking sends the string verbatim. Array order is preserved as render order. */
-    prompts: string[];
-};
-type EmptyStateSuggestionsConfig = {
-    /** Default: true. Pass false to hide bubbles without removing data. */
-    enabled?: boolean;
-    /** Optional heading above categories. Falls back to ui.emptyState.text. */
-    title?: string;
+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;
+    /** Enable slash command autocomplete in the chat input. Default: true. */
+    enableSlashCommands?: boolean;
+    /** Optional command list. Defaults to Knowledge Vault's /draft-knowledge command. */
+    slashCommands?: SlashCommandConfig[];
+    /** Current caller permissions used to hide commands they cannot run. */
+    commandPermissions?: string[];
+    /** Sentry DSN for error monitoring. */
+    sentryDsn?: string;
     /**
-     * Categories rendered in array order. Apps that need environment-specific
-     * categories (e.g. internal-only "SIMULATION TOOLS") should filter this
-     * array on the consumer side — the SDK has no notion of dev/prod and will
-     * render exactly what is passed.
+     * UI version to render.
+     *   1 = original component set
+     *   2 = redesigned chat UI (ChatGPT-style with thinking blocks, inline verification, etc.) — default
      */
-    categories: EmptyStatePromptCategory[];
-};
-type ChatUIConfig = {
-    layout?: "centered" | "full-width";
+    uiVersion?: 1 | 2;
     /**
-     * Color scheme for the React Native chat surface.
-     * Web styling continues to follow Tailwind. Default: "light".
+     * Speed multiplier for the assistant typing-reveal animation in the v2 UI.
+     *   1   = leisurely "human reading" pace
+     *   2   = default (snappy but still animated)
+     *   4   = near-instant trickle
+     *   0.5 = half speed
+     *   0   = disable the animation entirely (reveal text instantly as it arrives)
+     *
+     * Clamped to a minimum of 0.1 when non-zero to avoid division blow-ups.
+     * Default: 2.
      */
-    theme?: "light" | "dark";
+    typingSpeed?: number;
     /**
-     * Accent / brand color used by the native chat UI (send button, hero,
-     * focused border, etc). Defaults to Payman teal `#00858d`.
+     * Custom loading animation shown next to the streaming stage label.
+     * Accepts any URL that @lottiefiles/dotlottie-react can load — both
+     * `.lottie` and `.json` (Lottie format) work. Point this at a
+     * LottieFiles free animation, a self-hosted `.lottie` file, or any
+     * CDN-hosted URL.
+     *
+     * When unset the v2 UI falls back to a small 12-point SVG asterisk
+     * that spins and pulses — zero-dependency, always works, looks fine.
+     * Consumers who want a branded animation (e.g. the Payman logo
+     * pulse, a specific LottieFiles loader) set this.
      */
-    accent?: string;
-    agent?: {
-        /** Default: "Assistant" */
-        name?: string;
-        /** Default: true */
-        showName?: boolean;
-    };
-    emptyState?: {
-        /** Default: "What can I help with?" */
-        text?: string;
-        /**
-         * Small line above the main empty-state text (e.g. "Hi, Mike").
-         * Native only — web ignores this for now.
-         */
-        eyebrow?: string;
-        /** Default: true */
-        icon?: boolean;
-        /** Custom React node rendered above the empty-state text */
-        content?: React__default.ReactNode;
-        /** Custom logo element rendered in the empty state (native only). Replaces the default HeroMark. */
-        logo?: React__default.ReactNode;
-        /** Optional app-provided prompt bubbles rendered by the SDK. */
-        suggestions?: EmptyStateSuggestionsConfig;
-    };
-    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;
+    loadingAnimation?: {
+        /** Fully-qualified URL to a `.lottie` or Lottie `.json` file. */
+        src: string;
+        /** Rendered size in pixels. Defaults to 18 to match the default SVG spinner. */
+        size?: number;
     };
 };
 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;
+    /** Called when the user gives thumbs-up/down feedback on a message */
+    onMessageFeedback?: (data: {
+        messageId: string;
+        feedback: "up" | "down";
+    }) => 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;
+};
+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?: AgentStage;
+    /** 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;
 };
 type MessageListV2Props = {
+    /** Messages to display */
     messages: MessageDisplay[];
+    /** Whether an assistant response is currently streaming */
     isStreaming?: boolean;
-    /**
-     * 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;
+    /** 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: {
@@ -210,157 +286,229 @@ type MessageListV2Props = {
             payeeName?: string;
         };
         status: "pending" | "verifying" | "approved" | "rejected" | "error";
-        clearOtpTrigger?: number;
     } | 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>;
+    /** Called when the user gives thumbs-up/down feedback */
+    onMessageFeedback?: (data: {
+        messageId: string;
+        feedback: "up" | "down";
+    }) => void;
+    /**
+     * Speed multiplier for the typing-reveal animation.
+     *   1 = default, 2 = 2x faster, 0.5 = half speed, 0 = instant reveal.
+     */
+    typingSpeed?: number;
+};
+type MessageRowProps = {
+    /** Message to display */
+    message: MessageDisplay;
+    /** Stage */
+    stage?: AgentStage;
+    /** 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?: AgentStage;
+    /** 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;
-    /** Render a hamburger button on the left that toggles the session-history sidebar on mobile. */
-    onToggleSidebar?: () => void;
+    /** 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 */
     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$1.ForwardRefExoticComponent<PaymanChatProps & React$1.RefAttributes<PaymanChatRef>>;
+/**
+ * PaymanChat — the public component. Delegates to `PaymanChatInner`
+ * with a chat hook instance from `useChatV2`. The `config.uiVersion`
+ * prop used to gate an older V1 render path; the V1 code has been
+ * removed since nothing in the SDK's current consumers (paygent-studio
+ * etc.) opted into it. The `uiVersion` prop is still accepted on
+ * `ChatConfig` for type compatibility but is now ignored at runtime.
+ */
+declare const PaymanChat: React.ForwardRefExoticComponent<PaymanChatProps & React.RefAttributes<PaymanChatRef>>;
 
-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;
+interface PaymanChatContextValue {
     /**
-     * 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.
+     * Clear all messages and reset the chat
      */
-    recentlyCompletedSessionIds?: ReadonlySet<string>;
-    optimisticActivity?: OptimisticSessionActivity | null;
-    /** Called when the user clicks a row. */
-    onSelectSession: (session: SessionSummary) => void;
-    /** Called by the optional sidebar "New Session" button. */
-    onNewSession?: () => void;
-    /** Disabled state for the optional sidebar "New Session" button. */
-    newSessionDisabled?: boolean;
-    /** Controlled mobile drawer open state. */
-    mobileOpen: boolean;
-    onMobileOpenChange: (open: boolean) => void;
-};
-declare function SessionHistorySidebar({ config, options, activeSessionId, loadingSessionId, recentlyCompletedSessionIds, optimisticActivity, onSelectSession, onNewSession, newSessionDisabled, 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. */
+    /**
+     * Clear all messages without resetting session ID
+     */
     clearMessages: () => void;
-    /** Prepend older messages (history pagination). */
+    /**
+     * Prepend older messages to the top of the list (e.g. from history pagination)
+     */
     prependMessages: (messages: MessageDisplay[]) => void;
-    /** Cancel the active stream. */
+    /**
+     * Cancel current streaming operation
+     */
     cancelStream: () => void;
-    /** Current session id, if any. */
+    /**
+     * Get current session ID
+     */
     getSessionId: () => string | undefined;
-    /** All current messages. */
+    /**
+     * Get all messages
+     */
     getMessages: () => MessageDisplay[];
     /**
-     * Replace the active chat with a prior session's conversation history.
-     * Same call the built-in sidebar uses; exposed for advanced consumers.
+     * Check if currently waiting for response
      */
-    loadSession: (sessionId: string) => Promise<void>;
-    /** Whether a stream is currently in flight. */
     isWaitingForResponse: boolean;
 }
-declare const PaymanChatContext: React$1.Context<PaymanChatContextValue | undefined>;
+declare const PaymanChatContext: React.Context<PaymanChatContextValue | undefined>;
 /**
- * Access PaymanChat controls from a child of `<PaymanChat>`.
+ * Hook to access PaymanChat controls from parent components
  *
  * @example
  * ```tsx
- * const chat = usePaymanChat();
- * chat.loadSession(sessionId);
+ * function MyComponent() {
+ *   const chat = usePaymanChat();
+ *
+ *   return (
+ *     <>
+ *       <button onClick={chat.resetSession}>Reset</button>
+ *       <button onClick={chat.clearMessages}>Clear</button>
+ *     </>
+ *   );
+ * }
  * ```
  */
 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
  */
@@ -374,7 +522,7 @@ declare function formatDate(timestamp: string | Date): string;
 interface ChatSessionContext {
     sessionId?: string;
     sessionOwnerId?: string;
-    workflowName?: string;
+    agentId?: string;
     executionId?: string;
     cfRay?: string;
     route?: string;
@@ -390,12 +538,4 @@ interface ChatSessionContext {
  */
 declare function captureSentryError(error: Error | string, context: ChatSessionContext): void;
 
-/**
- * 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, type EmptyStatePromptCategory, type EmptyStateSuggestionsConfig, 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 };
+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 SlashCommandConfig, type StreamingMessageProps, type UserActionModalProps, type UserMessageActionsConfig, type UserMessageProps, captureSentryError, cn, formatDate, usePaymanChat };