@paymanai/payman-ask-sdk 1.2.3 → 1.2.5

package/README.md

@@ -153,6 +153,38 @@ function MyApp() {
 - **[ENDPOINTS.md](./ENDPOINTS.md)** - API endpoints guide
 - **[CHANGELOG.md](./CHANGELOG.md)** - Version history
 
+## Theming: Shimmer (active step text)
+
+The active-step shimmer uses **full color values** only. Define these CSS variables in your app (e.g. in `:root` or your theme file) so the shimmer matches your theme:
+
+| Variable | Description |
+|----------|-------------|
+| `--payman-shimmer-muted` | Muted color (gradient ends) |
+| `--payman-shimmer-foreground` | Main text color (gradient sides) |
+| `--payman-shimmer-primary` | Accent color (gradient center) |
+
+**Example (hex theme):**
+
+```css
+:root {
+  --payman-shimmer-muted: var(--muted-foreground);
+  --payman-shimmer-foreground: var(--foreground);
+  --payman-shimmer-primary: var(--primary);
+}
+```
+
+**Example (HSL-component theme):**
+
+```css
+:root {
+  --payman-shimmer-muted: hsl(var(--muted-foreground));
+  --payman-shimmer-foreground: hsl(var(--foreground));
+  --payman-shimmer-primary: hsl(var(--primary));
+}
+```
+
+If these are not set, the widget falls back to neutral gray/blue.
+
 ## Common Issues
 
 ### 401 Error: "Workflow stage is not set"

package/dist/index.d.mts

@@ -1,8 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-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 * as React from 'react';
+import React__default from 'react';
 import { ClassValue } from 'clsx';
 
 type MessageRole = "user" | "assistant" | "system";
@@ -15,6 +15,8 @@ type StreamingStep = {
     status: "in_progress" | "completed" | "error" | "pending";
     timestamp: number;
     elapsedMs?: number;
+    thinkingText?: string;
+    isThinking?: boolean;
 };
 type ChunkDisplay = {
     id?: string;
@@ -43,6 +45,10 @@ type MessageDisplay = {
     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;
 };
 type SessionParams = {
     id?: string;
@@ -192,6 +198,14 @@ type ChatInputProps = {
     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;
 };
 type MessageListProps = {
     /** Messages to display */

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-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 * as React from 'react';
+import React__default from 'react';
 import { ClassValue } from 'clsx';
 
 type MessageRole = "user" | "assistant" | "system";
@@ -15,6 +15,8 @@ type StreamingStep = {
     status: "in_progress" | "completed" | "error" | "pending";
     timestamp: number;
     elapsedMs?: number;
+    thinkingText?: string;
+    isThinking?: boolean;
 };
 type ChunkDisplay = {
     id?: string;
@@ -43,6 +45,10 @@ type MessageDisplay = {
     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;
 };
 type SessionParams = {
     id?: string;
@@ -192,6 +198,14 @@ type ChatInputProps = {
     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;
 };
 type MessageListProps = {
     /** Messages to display */