@paymanai/payman-typescript-ask-sdk 4.0.24 → 4.0.25

package/dist/index.d.mts

@@ -124,6 +124,8 @@ type UserActionRequest = {
     subAction?: UserActionSubAction | (string & {});
     verificationType?: VerificationType;
     expirySeconds?: number;
+    /** Wall-clock expiry (epoch ms). Set when the prompt is first received. */
+    expiresAt?: number;
     message?: string;
     requestedSchema?: RequestedSchema;
     metadata?: Record<string, string>;
@@ -639,6 +641,12 @@ declare function cancelUserAction(config: ChatConfig, userActionId: string): Pro
 declare function resendUserAction(config: ChatConfig, userActionId: string): Promise<UserActionResponse>;
 declare function expireUserAction(config: ChatConfig, userActionId: string): Promise<UserActionResponse>;
 
+/** Wall-clock deadline (epoch ms) for a prompt with a positive TTL. */
+declare function resolveUserActionExpiresAt(req: UserActionRequest, existing?: ActiveUserAction): number | undefined;
+/** Seconds remaining before expiry, or undefined when the prompt has no TTL. */
+declare function getUserActionSecondsLeft(prompt: ActiveUserAction): number | undefined;
+declare function isUserActionExpired(prompt: ActiveUserAction): boolean;
+
 declare function migrateActiveStream(oldUserId: string, newUserId: string): void;
 
-export { type APIConfig, type ActiveUserAction, type AgentStage, type AnalysisMode, type ChatCallbacks, type ChatConfig, type ChunkDisplay, type FieldWidget, type JsonSchemaField, type JsonSchemaOption, type MessageDisplay, type MessageFeedbackState, type MessageRole, type RequestedSchema, type SendMessageOptions, type SessionParams, type StreamEvent, type StreamOptions, type StreamProgress, type StreamingStep, type UseChatV2Return, type UseVoiceReturn, type UserActionKind, type UserActionRequest, UserActionStaleError, type UserActionState, type UserActionStatus, type UserActionSubAction, type UserNotification, type V2EventProcessorState, type VerificationType, type VoiceCallbacks, type VoiceConfig, type VoicePermissions, type VoiceResult, type VoiceState, buildContent, cancelUserAction, classifyField, classifyUserActionKind, coerceValue, createInitialV2State, defaultValueFor, expireUserAction, generateId, getOptions, isNestedOrUnsupported, isRequired, migrateActiveStream, processStreamEventV2, renderableFields, resendUserAction, streamWorkflowEvents, submitUserAction, useChatV2, useVoice, validateField, validateForm };
+export { type APIConfig, type ActiveUserAction, type AgentStage, type AnalysisMode, type ChatCallbacks, type ChatConfig, type ChunkDisplay, type FieldWidget, type JsonSchemaField, type JsonSchemaOption, type MessageDisplay, type MessageFeedbackState, type MessageRole, type RequestedSchema, type SendMessageOptions, type SessionParams, type StreamEvent, type StreamOptions, type StreamProgress, type StreamingStep, type UseChatV2Return, type UseVoiceReturn, type UserActionKind, type UserActionRequest, UserActionStaleError, type UserActionState, type UserActionStatus, type UserActionSubAction, type UserNotification, type V2EventProcessorState, type VerificationType, type VoiceCallbacks, type VoiceConfig, type VoicePermissions, type VoiceResult, type VoiceState, buildContent, cancelUserAction, classifyField, classifyUserActionKind, coerceValue, createInitialV2State, defaultValueFor, expireUserAction, generateId, getOptions, getUserActionSecondsLeft, isNestedOrUnsupported, isRequired, isUserActionExpired, migrateActiveStream, processStreamEventV2, renderableFields, resendUserAction, resolveUserActionExpiresAt, streamWorkflowEvents, submitUserAction, useChatV2, useVoice, validateField, validateForm };

package/dist/index.d.ts

@@ -124,6 +124,8 @@ type UserActionRequest = {
     subAction?: UserActionSubAction | (string & {});
     verificationType?: VerificationType;
     expirySeconds?: number;
+    /** Wall-clock expiry (epoch ms). Set when the prompt is first received. */
+    expiresAt?: number;
     message?: string;
     requestedSchema?: RequestedSchema;
     metadata?: Record<string, string>;
@@ -639,6 +641,12 @@ declare function cancelUserAction(config: ChatConfig, userActionId: string): Pro
 declare function resendUserAction(config: ChatConfig, userActionId: string): Promise<UserActionResponse>;
 declare function expireUserAction(config: ChatConfig, userActionId: string): Promise<UserActionResponse>;
 
+/** Wall-clock deadline (epoch ms) for a prompt with a positive TTL. */
+declare function resolveUserActionExpiresAt(req: UserActionRequest, existing?: ActiveUserAction): number | undefined;
+/** Seconds remaining before expiry, or undefined when the prompt has no TTL. */
+declare function getUserActionSecondsLeft(prompt: ActiveUserAction): number | undefined;
+declare function isUserActionExpired(prompt: ActiveUserAction): boolean;
+
 declare function migrateActiveStream(oldUserId: string, newUserId: string): void;
 
-export { type APIConfig, type ActiveUserAction, type AgentStage, type AnalysisMode, type ChatCallbacks, type ChatConfig, type ChunkDisplay, type FieldWidget, type JsonSchemaField, type JsonSchemaOption, type MessageDisplay, type MessageFeedbackState, type MessageRole, type RequestedSchema, type SendMessageOptions, type SessionParams, type StreamEvent, type StreamOptions, type StreamProgress, type StreamingStep, type UseChatV2Return, type UseVoiceReturn, type UserActionKind, type UserActionRequest, UserActionStaleError, type UserActionState, type UserActionStatus, type UserActionSubAction, type UserNotification, type V2EventProcessorState, type VerificationType, type VoiceCallbacks, type VoiceConfig, type VoicePermissions, type VoiceResult, type VoiceState, buildContent, cancelUserAction, classifyField, classifyUserActionKind, coerceValue, createInitialV2State, defaultValueFor, expireUserAction, generateId, getOptions, isNestedOrUnsupported, isRequired, migrateActiveStream, processStreamEventV2, renderableFields, resendUserAction, streamWorkflowEvents, submitUserAction, useChatV2, useVoice, validateField, validateForm };
+export { type APIConfig, type ActiveUserAction, type AgentStage, type AnalysisMode, type ChatCallbacks, type ChatConfig, type ChunkDisplay, type FieldWidget, type JsonSchemaField, type JsonSchemaOption, type MessageDisplay, type MessageFeedbackState, type MessageRole, type RequestedSchema, type SendMessageOptions, type SessionParams, type StreamEvent, type StreamOptions, type StreamProgress, type StreamingStep, type UseChatV2Return, type UseVoiceReturn, type UserActionKind, type UserActionRequest, UserActionStaleError, type UserActionState, type UserActionStatus, type UserActionSubAction, type UserNotification, type V2EventProcessorState, type VerificationType, type VoiceCallbacks, type VoiceConfig, type VoicePermissions, type VoiceResult, type VoiceState, buildContent, cancelUserAction, classifyField, classifyUserActionKind, coerceValue, createInitialV2State, defaultValueFor, expireUserAction, generateId, getOptions, getUserActionSecondsLeft, isNestedOrUnsupported, isRequired, isUserActionExpired, migrateActiveStream, processStreamEventV2, renderableFields, resendUserAction, resolveUserActionExpiresAt, streamWorkflowEvents, submitUserAction, useChatV2, useVoice, validateField, validateForm };

package/dist/index.js

@@ -30,6 +30,7 @@ var chatStore = {
 };
 
 // src/utils/activeStreamStore.ts
+var EMPTY_USER_ACTION_STATE = { prompts: [], notifications: [] };
 var streams = /* @__PURE__ */ new Map();
 var activeStreamStore = {
   has(key) {
@@ -38,7 +39,11 @@ var activeStreamStore = {
   get(key) {
     const entry = streams.get(key);
     if (!entry) return null;
-    return { messages: entry.messages, isWaiting: entry.isWaiting };
+    return {
+      messages: entry.messages,
+      isWaiting: entry.isWaiting,
+      userActionState: entry.userActionState
+    };
   },
   // Called before startStream — registers the controller and initial messages
   start(key, abortController, initialMessages) {
@@ -46,6 +51,7 @@ var activeStreamStore = {
     streams.set(key, {
       messages: initialMessages,
       isWaiting: true,
+      userActionState: EMPTY_USER_ACTION_STATE,
       abortController,
       listeners: existing?.listeners ?? /* @__PURE__ */ new Set()
     });
@@ -56,20 +62,27 @@ var activeStreamStore = {
     if (!entry) return;
     const next = typeof updater === "function" ? updater(entry.messages) : updater;
     entry.messages = next;
-    entry.listeners.forEach((l) => l(next, entry.isWaiting));
+    entry.listeners.forEach((l) => l(next, entry.isWaiting, entry.userActionState));
   },
   setWaiting(key, waiting) {
     const entry = streams.get(key);
     if (!entry) return;
     entry.isWaiting = waiting;
-    entry.listeners.forEach((l) => l(entry.messages, waiting));
+    entry.listeners.forEach((l) => l(entry.messages, waiting, entry.userActionState));
+  },
+  applyUserActionState(key, updater) {
+    const entry = streams.get(key);
+    if (!entry) return;
+    const next = typeof updater === "function" ? updater(entry.userActionState) : updater;
+    entry.userActionState = next;
+    entry.listeners.forEach((l) => l(entry.messages, entry.isWaiting, next));
   },
   // Called when stream completes — persists to chatStore and cleans up
   complete(key) {
     const entry = streams.get(key);
     if (!entry) return;
     entry.isWaiting = false;
-    entry.listeners.forEach((l) => l(entry.messages, false));
+    entry.listeners.forEach((l) => l(entry.messages, false, entry.userActionState));
     const toSave = entry.messages.filter((m) => !m.isStreaming);
     if (toSave.length > 0) chatStore.set(key, toSave);
     streams.delete(key);
@@ -1094,13 +1107,38 @@ async function expireUserAction(config, userActionId) {
   return sendUserActionRequest(config, userActionId, "expired");
 }
 
+// src/utils/userActionExpiry.ts
+function resolveUserActionExpiresAt(req, existing) {
+  if (typeof req.expirySeconds !== "number" || req.expirySeconds <= 0) {
+    return void 0;
+  }
+  if (existing?.expiresAt && existing.userActionId === req.userActionId) {
+    return existing.expiresAt;
+  }
+  return Date.now() + Math.floor(req.expirySeconds) * 1e3;
+}
+function getUserActionSecondsLeft(prompt) {
+  if (typeof prompt.expiresAt === "number" && prompt.expiresAt > 0) {
+    return Math.max(0, Math.ceil((prompt.expiresAt - Date.now()) / 1e3));
+  }
+  if (typeof prompt.expirySeconds === "number" && prompt.expirySeconds > 0) {
+    return Math.floor(prompt.expirySeconds);
+  }
+  return void 0;
+}
+function isUserActionExpired(prompt) {
+  const left = getUserActionSecondsLeft(prompt);
+  return left !== void 0 && left <= 0;
+}
+
 // src/hooks/useChatV2.ts
-var EMPTY_USER_ACTION_STATE = { prompts: [], notifications: [] };
+var EMPTY_USER_ACTION_STATE2 = { prompts: [], notifications: [] };
 function upsertPrompt(prompts, req) {
-  const active = { ...req, status: "pending" };
   const idx = prompts.findIndex(
     (p) => req.toolCallId ? p.toolCallId === req.toolCallId : p.userActionId === req.userActionId
   );
+  const expiresAt = resolveUserActionExpiresAt(req, idx >= 0 ? prompts[idx] : void 0);
+  const active = { ...req, status: "pending", expiresAt };
   if (idx >= 0) {
     const next = prompts.slice();
     next[idx] = active;
@@ -1171,7 +1209,28 @@ function useChatV2(config, callbacks = {}) {
     // eslint-disable-next-line react-hooks/exhaustive-deps
     []
   );
-  const [userActionState, setUserActionState] = react.useState(EMPTY_USER_ACTION_STATE);
+  const [userActionState, setUserActionState] = react.useState(() => {
+    if (!config.userId) return EMPTY_USER_ACTION_STATE2;
+    return activeStreamStore.get(config.userId)?.userActionState ?? EMPTY_USER_ACTION_STATE2;
+  });
+  const storeAwareSetUserActionState = react.useCallback(
+    (updater) => {
+      const streamUserId = streamUserIdRef.current;
+      const currentUserId = configRef.current.userId;
+      const storeKey = streamUserId ?? currentUserId;
+      if (storeKey && activeStreamStore.has(storeKey)) {
+        activeStreamStore.applyUserActionState(
+          storeKey,
+          updater
+        );
+      }
+      if (!streamUserId || streamUserId === currentUserId) {
+        setUserActionState(updater);
+      }
+    },
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    []
+  );
   const wrappedCallbacks = react.useMemo(() => ({
     ...callbacksRef.current,
     onMessageSent: (message) => callbacksRef.current.onMessageSent?.(message),
@@ -1181,14 +1240,14 @@ function useChatV2(config, callbacks = {}) {
     onExecutionTraceClick: (data) => callbacksRef.current.onExecutionTraceClick?.(data),
     onSessionIdChange: (sessionId) => callbacksRef.current.onSessionIdChange?.(sessionId),
     onUserActionRequired: (request) => {
-      setUserActionState((prev) => ({
+      storeAwareSetUserActionState((prev) => ({
         ...prev,
         prompts: upsertPrompt(prev.prompts, request)
       }));
       callbacksRef.current.onUserActionRequired?.(request);
     },
     onUserNotification: (notification) => {
-      setUserActionState(
+      storeAwareSetUserActionState(
         (prev) => prev.notifications.some((n) => n.id === notification.id) ? prev : { ...prev, notifications: [...prev.notifications, notification] }
       );
       callbacksRef.current.onUserNotification?.(notification);
@@ -1278,7 +1337,7 @@ function useChatV2(config, callbacks = {}) {
     streamUserIdRef.current = void 0;
     cancelStreamManager();
     setIsWaitingForResponse(false);
-    setUserActionState((prev) => ({ ...prev, prompts: [] }));
+    storeAwareSetUserActionState((prev) => ({ ...prev, prompts: [] }));
     setMessages(
       (prev) => prev.map((msg) => {
         if (msg.isStreaming) {
@@ -1293,7 +1352,7 @@ function useChatV2(config, callbacks = {}) {
         return msg;
       })
     );
-  }, [cancelStreamManager]);
+  }, [cancelStreamManager, storeAwareSetUserActionState]);
   const resetSession = react.useCallback(() => {
     const streamUserId = streamUserIdRef.current ?? configRef.current.userId;
     if (streamUserId) {
@@ -1307,7 +1366,7 @@ function useChatV2(config, callbacks = {}) {
     sessionIdRef.current = void 0;
     abortControllerRef.current?.abort();
     setIsWaitingForResponse(false);
-    setUserActionState(EMPTY_USER_ACTION_STATE);
+    storeAwareSetUserActionState(EMPTY_USER_ACTION_STATE2);
   }, []);
   const getSessionId = react.useCallback(() => {
     return sessionIdRef.current;
@@ -1317,21 +1376,21 @@ function useChatV2(config, callbacks = {}) {
   }, [messages]);
   const setPromptStatus = react.useCallback(
     (userActionId, status) => {
-      setUserActionState((prev) => ({
+      storeAwareSetUserActionState((prev) => ({
         ...prev,
         prompts: prev.prompts.map(
           (p) => p.userActionId === userActionId ? { ...p, status } : p
         )
       }));
     },
-    []
+    [storeAwareSetUserActionState]
   );
   const removePrompt = react.useCallback((userActionId) => {
-    setUserActionState((prev) => ({
+    storeAwareSetUserActionState((prev) => ({
       ...prev,
       prompts: prev.prompts.filter((p) => p.userActionId !== userActionId)
     }));
-  }, []);
+  }, [storeAwareSetUserActionState]);
   const submitUserAction2 = react.useCallback(
     async (userActionId, content) => {
       setPromptStatus(userActionId, "submitting");
@@ -1400,11 +1459,11 @@ function useChatV2(config, callbacks = {}) {
     [setPromptStatus]
   );
   const dismissNotification = react.useCallback((id) => {
-    setUserActionState((prev) => ({
+    storeAwareSetUserActionState((prev) => ({
       ...prev,
       notifications: prev.notifications.filter((n) => n.id !== id)
     }));
-  }, []);
+  }, [storeAwareSetUserActionState]);
   react.useEffect(() => {
     const prevSubscriptionUserId = subscriptionPrevUserIdRef.current;
     subscriptionPrevUserIdRef.current = config.userId;
@@ -1413,14 +1472,17 @@ function useChatV2(config, callbacks = {}) {
     if (prevSubscriptionUserId && prevSubscriptionUserId !== userId && streamUserIdRef.current === prevSubscriptionUserId && !activeStreamStore.has(prevSubscriptionUserId) && activeStreamStore.has(userId)) {
       streamUserIdRef.current = userId;
     }
-    const unsubscribe = activeStreamStore.subscribe(userId, (msgs, isWaiting) => {
+    const unsubscribe = activeStreamStore.subscribe(userId, (msgs, isWaiting, actions) => {
       setMessages(msgs);
       setIsWaitingForResponse(isWaiting);
+      setUserActionState(actions);
     });
     const active = activeStreamStore.get(userId);
     if (active) {
+      streamUserIdRef.current = userId;
       setMessages(active.messages);
       setIsWaitingForResponse(active.isWaiting);
+      setUserActionState(active.userActionState);
     }
     return unsubscribe;
   }, [config.userId]);
@@ -1448,12 +1510,14 @@ function useChatV2(config, callbacks = {}) {
       setMessages([]);
       sessionIdRef.current = void 0;
       setIsWaitingForResponse(false);
-      setUserActionState(EMPTY_USER_ACTION_STATE);
+      setUserActionState(EMPTY_USER_ACTION_STATE2);
     } else if (config.userId) {
       const active = activeStreamStore.get(config.userId);
       if (active) {
+        streamUserIdRef.current = config.userId;
         setMessages(active.messages);
         setIsWaitingForResponse(active.isWaiting);
+        setUserActionState(active.userActionState);
         sessionIdRef.current = getSessionIdFromMessages(active.messages) ?? config.initialSessionId;
         return;
       }
@@ -1832,12 +1896,15 @@ exports.defaultValueFor = defaultValueFor;
 exports.expireUserAction = expireUserAction;
 exports.generateId = generateId;
 exports.getOptions = getOptions;
+exports.getUserActionSecondsLeft = getUserActionSecondsLeft;
 exports.isNestedOrUnsupported = isNestedOrUnsupported;
 exports.isRequired = isRequired;
+exports.isUserActionExpired = isUserActionExpired;
 exports.migrateActiveStream = migrateActiveStream;
 exports.processStreamEventV2 = processStreamEventV2;
 exports.renderableFields = renderableFields;
 exports.resendUserAction = resendUserAction;
+exports.resolveUserActionExpiresAt = resolveUserActionExpiresAt;
 exports.streamWorkflowEvents = streamWorkflowEvents;
 exports.submitUserAction = submitUserAction;
 exports.useChatV2 = useChatV2;