@dudousxd/nestjs-agent-react 0.6.4 → 0.7.1

package/dist/index.d.cts

@@ -338,7 +338,14 @@ interface TranscriptReasoningBlock {
     isOpen: boolean;
     toggle: (open?: boolean) => void;
 }
-/** An action a run is waiting on a human for: approve, reject, answer, skip. */
+/**
+ * A decision a run is waiting on a human for, and which one a parked call is currently sending.
+ *
+ * One call settles one way at a time, and WHICH one is what lets a surface report progress on the
+ * affordance the person pressed instead of on all of them.
+ */
+type SettleAction = 'approve' | 'reject' | 'answer' | 'skip';
+/** One such decision: whether it can be made, whether it is on its way, and how to send it. */
 interface TranscriptSettleState {
     available: boolean;
     /** True from the click until the run resumes and settles the call. */
@@ -475,7 +482,8 @@ interface ElicitationBlockOptions {
     canSkip: boolean;
     answer: (toolCallId: string) => void;
     skip: (toolCallId: string) => void;
-    isSubmitting: (toolCallId: string) => boolean;
+    /** Which decision this call is sending, or `null` for none. */
+    submitting: (toolCallId: string) => SettleAction | null;
     errorOf: (toolCallId: string) => string | null;
 }
 /** Where an approval decision is sent, and what the last one did. */
@@ -484,7 +492,8 @@ interface ApprovalBlockOptions {
     canReject: boolean;
     approve: (toolCallId: string) => void;
     reject: (toolCallId: string) => void;
-    isSubmitting: (toolCallId: string) => boolean;
+    /** Which decision this call is sending, or `null` for none. */
+    submitting: (toolCallId: string) => SettleAction | null;
     errorOf: (toolCallId: string) => string | null;
 }
 interface BuildBlocksOptions {
@@ -1335,4 +1344,4 @@ declare function useAgentChat(options: UseAgentChatOptions): {
     clearError: () => void;
 };
 
-export { AgentChatTransport, type AgentChatTransportOptions, AgentClient, type AgentClientOptions, AgentHttpError, type AgentStreamMeta, type AggregatedTurnUsage, type AnyToolUIPart, type ApprovalBlockOptions, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type BuildBlocksOptions, type CancelResult, type ChatBackground, ChatInput, type ChatInputProps, type ChatStatus, type ChatTranscript, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type ElicitationBlockOptions, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, type MessageUsageInfo, type QuotaToday, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RetrievedPassage, SPEECH_LANGUAGES, type SkillSuggestionData, type SkillsSourceOptions, type SpeechLanguage, type SpeechRecognitionHook, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type ThreadPatch, type TimestampInfo, type TranscriptActionState, type TranscriptBlock, type TranscriptCopyState, type TranscriptEditState, type TranscriptElicitationBlock, type TranscriptElicitationOutcome, type TranscriptFile, type TranscriptFilesBlock, type TranscriptItem, type TranscriptItemOptions, type TranscriptQuestion, type TranscriptQuestionOption, type TranscriptReasoningBlock, type TranscriptSettleState, type TranscriptSource, type TranscriptSourcesBlock, type TranscriptStopState, type TranscriptTextBlock, type TranscriptToolBlock, type TranscriptToolCall, type TranscriptWindow, type TriggerMatch, type TriggerPosition, type UsageSummary, type UseAgentChatOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseSpeechRecognitionOptions, type UseTranscriptItemOptions, applyCompletion, backgroundRunsFromThread, buildTranscriptBlocks, createSkillsSource, describeTimestamp, describeUsage, extractMessageText, filterAutocompleteItems, findActiveTrigger, formatRelativeTime, loadStoredSpeechLang, persistSpeechLang, storedMessageToUiMessage, storedThreadToUiMessages, useAgentChat, useChatTranscript, useComposerAutocomplete, useSpeechRecognition, useStickToBottom, useTranscriptItem };
+export { AgentChatTransport, type AgentChatTransportOptions, AgentClient, type AgentClientOptions, AgentHttpError, type AgentStreamMeta, type AggregatedTurnUsage, type AnyToolUIPart, type ApprovalBlockOptions, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type BuildBlocksOptions, type CancelResult, type ChatBackground, ChatInput, type ChatInputProps, type ChatStatus, type ChatTranscript, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type ElicitationBlockOptions, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, type MessageUsageInfo, type QuotaToday, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RetrievedPassage, SPEECH_LANGUAGES, type SettleAction, type SkillSuggestionData, type SkillsSourceOptions, type SpeechLanguage, type SpeechRecognitionHook, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type ThreadPatch, type TimestampInfo, type TranscriptActionState, type TranscriptBlock, type TranscriptCopyState, type TranscriptEditState, type TranscriptElicitationBlock, type TranscriptElicitationOutcome, type TranscriptFile, type TranscriptFilesBlock, type TranscriptItem, type TranscriptItemOptions, type TranscriptQuestion, type TranscriptQuestionOption, type TranscriptReasoningBlock, type TranscriptSettleState, type TranscriptSource, type TranscriptSourcesBlock, type TranscriptStopState, type TranscriptTextBlock, type TranscriptToolBlock, type TranscriptToolCall, type TranscriptWindow, type TriggerMatch, type TriggerPosition, type UsageSummary, type UseAgentChatOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseSpeechRecognitionOptions, type UseTranscriptItemOptions, applyCompletion, backgroundRunsFromThread, buildTranscriptBlocks, createSkillsSource, describeTimestamp, describeUsage, extractMessageText, filterAutocompleteItems, findActiveTrigger, formatRelativeTime, loadStoredSpeechLang, persistSpeechLang, storedMessageToUiMessage, storedThreadToUiMessages, useAgentChat, useChatTranscript, useComposerAutocomplete, useSpeechRecognition, useStickToBottom, useTranscriptItem };

package/dist/index.d.ts

@@ -338,7 +338,14 @@ interface TranscriptReasoningBlock {
     isOpen: boolean;
     toggle: (open?: boolean) => void;
 }
-/** An action a run is waiting on a human for: approve, reject, answer, skip. */
+/**
+ * A decision a run is waiting on a human for, and which one a parked call is currently sending.
+ *
+ * One call settles one way at a time, and WHICH one is what lets a surface report progress on the
+ * affordance the person pressed instead of on all of them.
+ */
+type SettleAction = 'approve' | 'reject' | 'answer' | 'skip';
+/** One such decision: whether it can be made, whether it is on its way, and how to send it. */
 interface TranscriptSettleState {
     available: boolean;
     /** True from the click until the run resumes and settles the call. */
@@ -475,7 +482,8 @@ interface ElicitationBlockOptions {
     canSkip: boolean;
     answer: (toolCallId: string) => void;
     skip: (toolCallId: string) => void;
-    isSubmitting: (toolCallId: string) => boolean;
+    /** Which decision this call is sending, or `null` for none. */
+    submitting: (toolCallId: string) => SettleAction | null;
     errorOf: (toolCallId: string) => string | null;
 }
 /** Where an approval decision is sent, and what the last one did. */
@@ -484,7 +492,8 @@ interface ApprovalBlockOptions {
     canReject: boolean;
     approve: (toolCallId: string) => void;
     reject: (toolCallId: string) => void;
-    isSubmitting: (toolCallId: string) => boolean;
+    /** Which decision this call is sending, or `null` for none. */
+    submitting: (toolCallId: string) => SettleAction | null;
     errorOf: (toolCallId: string) => string | null;
 }
 interface BuildBlocksOptions {
@@ -1335,4 +1344,4 @@ declare function useAgentChat(options: UseAgentChatOptions): {
     clearError: () => void;
 };
 
-export { AgentChatTransport, type AgentChatTransportOptions, AgentClient, type AgentClientOptions, AgentHttpError, type AgentStreamMeta, type AggregatedTurnUsage, type AnyToolUIPart, type ApprovalBlockOptions, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type BuildBlocksOptions, type CancelResult, type ChatBackground, ChatInput, type ChatInputProps, type ChatStatus, type ChatTranscript, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type ElicitationBlockOptions, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, type MessageUsageInfo, type QuotaToday, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RetrievedPassage, SPEECH_LANGUAGES, type SkillSuggestionData, type SkillsSourceOptions, type SpeechLanguage, type SpeechRecognitionHook, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type ThreadPatch, type TimestampInfo, type TranscriptActionState, type TranscriptBlock, type TranscriptCopyState, type TranscriptEditState, type TranscriptElicitationBlock, type TranscriptElicitationOutcome, type TranscriptFile, type TranscriptFilesBlock, type TranscriptItem, type TranscriptItemOptions, type TranscriptQuestion, type TranscriptQuestionOption, type TranscriptReasoningBlock, type TranscriptSettleState, type TranscriptSource, type TranscriptSourcesBlock, type TranscriptStopState, type TranscriptTextBlock, type TranscriptToolBlock, type TranscriptToolCall, type TranscriptWindow, type TriggerMatch, type TriggerPosition, type UsageSummary, type UseAgentChatOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseSpeechRecognitionOptions, type UseTranscriptItemOptions, applyCompletion, backgroundRunsFromThread, buildTranscriptBlocks, createSkillsSource, describeTimestamp, describeUsage, extractMessageText, filterAutocompleteItems, findActiveTrigger, formatRelativeTime, loadStoredSpeechLang, persistSpeechLang, storedMessageToUiMessage, storedThreadToUiMessages, useAgentChat, useChatTranscript, useComposerAutocomplete, useSpeechRecognition, useStickToBottom, useTranscriptItem };
+export { AgentChatTransport, type AgentChatTransportOptions, AgentClient, type AgentClientOptions, AgentHttpError, type AgentStreamMeta, type AggregatedTurnUsage, type AnyToolUIPart, type ApprovalBlockOptions, type AutocompleteInputProps, type AutocompleteItem, type AutocompleteListboxProps, type AutocompleteOptionProps, type AutocompleteSource, type BackgroundRun, type BuildBlocksOptions, type CancelResult, type ChatBackground, ChatInput, type ChatInputProps, type ChatStatus, type ChatTranscript, type CompletionEdit, type ComposerAutocomplete, DEFAULT_SPEECH_LANG, type ElicitationBlockOptions, MessageItem, type MessageItemClassNames, type MessageItemProps, MessageItemView, type MessageItemViewProps, MessageList, type MessageListClassNames, type MessageListProps, type MessageUsageInfo, type QuotaToday, type RenderFilesFn, type RenderReasoningFn, type RenderTextFn, type RenderToolGroupFn, type RenderToolPartFn, type RetrievedPassage, SPEECH_LANGUAGES, type SettleAction, type SkillSuggestionData, type SkillsSourceOptions, type SpeechLanguage, type SpeechRecognitionHook, type StickToBottom, type StickToBottomOptions, type StoredTurnMetadata, type ThreadPatch, type TimestampInfo, type TranscriptActionState, type TranscriptBlock, type TranscriptCopyState, type TranscriptEditState, type TranscriptElicitationBlock, type TranscriptElicitationOutcome, type TranscriptFile, type TranscriptFilesBlock, type TranscriptItem, type TranscriptItemOptions, type TranscriptQuestion, type TranscriptQuestionOption, type TranscriptReasoningBlock, type TranscriptSettleState, type TranscriptSource, type TranscriptSourcesBlock, type TranscriptStopState, type TranscriptTextBlock, type TranscriptToolBlock, type TranscriptToolCall, type TranscriptWindow, type TriggerMatch, type TriggerPosition, type UsageSummary, type UseAgentChatOptions, type UseChatTranscriptOptions, type UseComposerAutocompleteOptions, type UseSpeechRecognitionOptions, type UseTranscriptItemOptions, applyCompletion, backgroundRunsFromThread, buildTranscriptBlocks, createSkillsSource, describeTimestamp, describeUsage, extractMessageText, filterAutocompleteItems, findActiveTrigger, formatRelativeTime, loadStoredSpeechLang, persistSpeechLang, storedMessageToUiMessage, storedThreadToUiMessages, useAgentChat, useChatTranscript, useComposerAutocomplete, useSpeechRecognition, useStickToBottom, useTranscriptItem };

package/dist/index.js

@@ -995,7 +995,7 @@ __name(isAwaitingApproval, "isAwaitingApproval");
 function buildToolCall(part, options) {
   const toolCallId = part.toolCallId;
   const awaiting = isAwaitingApproval(part);
-  const isSubmitting = awaiting && options?.isSubmitting(toolCallId) === true;
+  const sending = awaiting ? options?.submitting(toolCallId) ?? null : null;
   return {
     part,
     toolCallId,
@@ -1003,12 +1003,12 @@ function buildToolCall(part, options) {
     isAwaitingApproval: awaiting,
     approve: {
       available: awaiting && options?.canApprove === true,
-      isSubmitting,
+      isSubmitting: sending === "approve",
       run: /* @__PURE__ */ __name(() => options?.approve(toolCallId), "run")
     },
     reject: {
       available: awaiting && options?.canReject === true,
-      isSubmitting,
+      isSubmitting: sending === "reject",
       run: /* @__PURE__ */ __name(() => options?.reject(toolCallId), "run")
     },
     error: options?.errorOf(toolCallId) ?? null
@@ -1106,7 +1106,7 @@ function buildElicitationBlock(key, part, request, options) {
       }))
     };
   });
-  const isSubmitting = isPending && options.isSubmitting(toolCallId);
+  const sending = isPending ? options.submitting(toolCallId) : null;
   return {
     kind: "elicitation",
     key,
@@ -1119,12 +1119,12 @@ function buildElicitationBlock(key, part, request, options) {
     error: options.errorOf(toolCallId),
     answer: {
       available: isPending && options.canAnswer,
-      isSubmitting,
+      isSubmitting: sending === "answer",
       run: /* @__PURE__ */ __name(() => options.answer(toolCallId), "run")
     },
     skip: {
       available: isPending && options.canSkip,
-      isSubmitting,
+      isSubmitting: sending === "skip",
       run: /* @__PURE__ */ __name(() => options.skip(toolCallId), "run")
     }
   };
@@ -1413,7 +1413,7 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
   const [copied, setCopied] = useState4(() => /* @__PURE__ */ new Set());
   const [openReasoning, setOpenReasoning] = useState4(() => /* @__PURE__ */ new Map());
   const [picks, setPicks] = useState4(() => /* @__PURE__ */ new Map());
-  const [settling, setSettling] = useState4(() => /* @__PURE__ */ new Set());
+  const [settling, setSettling] = useState4(() => /* @__PURE__ */ new Map());
   const [settleErrors, setSettleErrors] = useState4(() => /* @__PURE__ */ new Map());
   const latest = useRef3({
     options,
@@ -1456,7 +1456,7 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
   const pick = useCallback3((toolCallId, questionId, values) => {
     setPicks((current) => new Map(current).set(pickKey(toolCallId, questionId), values));
   }, []);
-  const settle = useCallback3((toolCallId, send) => {
+  const settle = useCallback3((toolCallId, action, send) => {
     setSettleErrors((current) => {
       if (!current.has(toolCallId)) {
         return current;
@@ -1465,10 +1465,10 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
       next.delete(toolCallId);
       return next;
     });
-    setSettling((current) => new Set(current).add(toolCallId));
+    setSettling((current) => new Map(current).set(toolCallId, action));
     const failed = /* @__PURE__ */ __name((error) => {
       setSettling((current) => {
-        const next = new Set(current);
+        const next = new Map(current);
         next.delete(toolCallId);
         return next;
       });
@@ -1486,14 +1486,14 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
     if (!onAnswer) {
       return;
     }
-    settle(toolCallId, () => onAnswer(toolCallId, answersFor(current.picks, toolCallId)));
+    settle(toolCallId, "answer", () => onAnswer(toolCallId, answersFor(current.picks, toolCallId)));
   }, [
     settle
   ]);
   const skip = useCallback3((toolCallId) => {
     const onSkip = latest.current.options.onSkip;
     if (onSkip) {
-      settle(toolCallId, () => onSkip(toolCallId));
+      settle(toolCallId, "skip", () => onSkip(toolCallId));
     }
   }, [
     settle
@@ -1501,7 +1501,7 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
   const approve = useCallback3((toolCallId) => {
     const onApprove = latest.current.options.onApprove;
     if (onApprove) {
-      settle(toolCallId, () => onApprove(toolCallId));
+      settle(toolCallId, "approve", () => onApprove(toolCallId));
     }
   }, [
     settle
@@ -1509,7 +1509,7 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
   const reject = useCallback3((toolCallId) => {
     const onReject = latest.current.options.onReject;
     if (onReject) {
-      settle(toolCallId, () => onReject(toolCallId));
+      settle(toolCallId, "reject", () => onReject(toolCallId));
     }
   }, [
     settle
@@ -1634,7 +1634,7 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
             canSkip: options.onSkip !== void 0,
             answer,
             skip,
-            isSubmitting: /* @__PURE__ */ __name((toolCallId) => settling.has(toolCallId), "isSubmitting"),
+            submitting: /* @__PURE__ */ __name((toolCallId) => settling.get(toolCallId) ?? null, "submitting"),
             errorOf: /* @__PURE__ */ __name((toolCallId) => settleErrors.get(toolCallId) ?? null, "errorOf")
           }
         } : {},
@@ -1644,7 +1644,7 @@ function useTranscriptItems({ messages, visibleStart, streamingMessageId, option
             canReject: options.onReject !== void 0,
             approve,
             reject,
-            isSubmitting: /* @__PURE__ */ __name((toolCallId) => settling.has(toolCallId), "isSubmitting"),
+            submitting: /* @__PURE__ */ __name((toolCallId) => settling.get(toolCallId) ?? null, "submitting"),
             errorOf: /* @__PURE__ */ __name((toolCallId) => settleErrors.get(toolCallId) ?? null, "errorOf")
           }
         } : {}