@paymanai/payman-ask-sdk 2.0.3 → 2.0.5

package/README.md

@@ -123,12 +123,13 @@ type ChatConfig = {
      * object — override width/collapse/page-size/persistKey.
      */
     sessionHistory?: boolean | {
-      defaultWidth?: number;       // default: 280 px
-      minWidth?: number;           // default: 240
-      maxWidth?: number;           // default: 480
+      defaultWidth?: number;       // default: 260 px
+      minWidth?: number;           // default: 220
+      maxWidth?: number;           // default: 440
       defaultCollapsed?: boolean;  // desktop only; default: false
       pageSize?: number;           // default: 20
       persistKey?: string;         // default: `payman-chat-sidebar:${workflow.id}`
+      showNewSessionButton?: boolean; // default: false
     };
   };
 
@@ -157,6 +158,8 @@ Turn features on with booleans, and only reach for the full object form when you
 
 Pass `ui.sessionHistory: true` and provide `workflow.id` + `session.owner.id`. `<PaymanChat/>` mounts a resizable, collapsible sidebar on desktop and a hamburger-triggered drawer on mobile. Clicking a row calls `loadSession(sessionId)` — which cancels any in-flight stream, clears the current chat, fetches the conversation history, and renders it with `isHistorical: true` (renderers skip the thinking/step UI for those rows).
 
+To show a sidebar reset button, opt in with `ui.sessionHistory: { showNewSessionButton: true }`. It runs the same confirmable New Session flow as the chat input button.
+
 Need custom chrome? Mount the sidebar yourself:
 
 ```tsx

package/dist/index.d.mts

@@ -40,11 +40,11 @@ type VoiceOptions = {
     continuous?: boolean;
 };
 type SessionHistoryOptions = {
-    /** Desktop sidebar default width in px. Default: 280 */
+    /** Desktop sidebar default width in px. Default: 260 */
     defaultWidth?: number;
-    /** Default: 240 */
+    /** Default: 220 */
     minWidth?: number;
-    /** Default: 480 */
+    /** Default: 440 */
     maxWidth?: number;
     /** Desktop only. Default: false */
     defaultCollapsed?: boolean;
@@ -52,9 +52,21 @@ type SessionHistoryOptions = {
     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 ChatUIConfig = {
     layout?: "centered" | "full-width";
+    /**
+     * Color scheme for the React Native chat surface.
+     * Web styling continues to follow Tailwind. Default: "light".
+     */
+    theme?: "light" | "dark";
+    /**
+     * Accent / brand color used by the native chat UI (send button, hero,
+     * focused border, etc). Defaults to Payman teal `#00858d`.
+     */
+    accent?: string;
     agent?: {
         /** Default: "Assistant" */
         name?: string;
@@ -64,10 +76,17 @@ type ChatUIConfig = {
     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;
     };
     input?: {
         /** Default: "Type your message..." */
@@ -226,11 +245,6 @@ type SessionHistorySidebarProps = {
     /** Session id whose conversation history is currently being fetched.
      * The matching row renders a small inline spinner next to its title. */
     loadingSessionId?: string;
-    /**
-     * Session ids that currently have an in-flight workflow stream. Each
-     * matching row renders a subtle running mark on the right of its title.
-     */
-    streamingSessionIds?: ReadonlySet<string>;
     /**
      * Session ids whose stream completed recently. Each matching row briefly
      * renders a check mark on the right of its title — the parent is
@@ -241,11 +255,15 @@ type SessionHistorySidebarProps = {
     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, streamingSessionIds, recentlyCompletedSessionIds, optimisticActivity, onSelectSession, mobileOpen, onMobileOpenChange, }: SessionHistorySidebarProps): react_jsx_runtime.JSX.Element;
+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;
 

package/dist/index.d.ts

@@ -40,11 +40,11 @@ type VoiceOptions = {
     continuous?: boolean;
 };
 type SessionHistoryOptions = {
-    /** Desktop sidebar default width in px. Default: 280 */
+    /** Desktop sidebar default width in px. Default: 260 */
     defaultWidth?: number;
-    /** Default: 240 */
+    /** Default: 220 */
     minWidth?: number;
-    /** Default: 480 */
+    /** Default: 440 */
     maxWidth?: number;
     /** Desktop only. Default: false */
     defaultCollapsed?: boolean;
@@ -52,9 +52,21 @@ type SessionHistoryOptions = {
     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 ChatUIConfig = {
     layout?: "centered" | "full-width";
+    /**
+     * Color scheme for the React Native chat surface.
+     * Web styling continues to follow Tailwind. Default: "light".
+     */
+    theme?: "light" | "dark";
+    /**
+     * Accent / brand color used by the native chat UI (send button, hero,
+     * focused border, etc). Defaults to Payman teal `#00858d`.
+     */
+    accent?: string;
     agent?: {
         /** Default: "Assistant" */
         name?: string;
@@ -64,10 +76,17 @@ type ChatUIConfig = {
     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;
     };
     input?: {
         /** Default: "Type your message..." */
@@ -226,11 +245,6 @@ type SessionHistorySidebarProps = {
     /** Session id whose conversation history is currently being fetched.
      * The matching row renders a small inline spinner next to its title. */
     loadingSessionId?: string;
-    /**
-     * Session ids that currently have an in-flight workflow stream. Each
-     * matching row renders a subtle running mark on the right of its title.
-     */
-    streamingSessionIds?: ReadonlySet<string>;
     /**
      * Session ids whose stream completed recently. Each matching row briefly
      * renders a check mark on the right of its title — the parent is
@@ -241,11 +255,15 @@ type SessionHistorySidebarProps = {
     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, streamingSessionIds, recentlyCompletedSessionIds, optimisticActivity, onSelectSession, mobileOpen, onMobileOpenChange, }: SessionHistorySidebarProps): react_jsx_runtime.JSX.Element;
+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;