@copilotz/chat-adapter 0.9.22 → 0.9.23

package/dist/index.d.ts

@@ -34,6 +34,7 @@ type RestThread = {
     createdAt?: string;
     updatedAt?: string;
 };
+type ThreadActivityStatus = "idle" | "running" | "failed";
 type RestMessage = {
     id: string;
     threadId: string;
@@ -208,6 +209,15 @@ declare function useCopilotz({ userId, userName, userAvatar, assistantName, agen
     threads: ChatThread[];
     currentThreadId: string | null;
     isStreaming: boolean;
+    threadActivityStatus: ThreadActivityStatus;
+    isRecoveringStream: boolean;
+    activityNotice: {
+        tone: "info";
+        message: string;
+    } | {
+        tone: "error";
+        message: string;
+    } | null;
     specialState: SpecialChatState | null;
     clearSpecialState: () => void;
     userContextSeed: Partial<ChatUserContext>;

package/dist/index.js

@@ -1659,6 +1659,8 @@ function useCopilotz({ userId, userName, userAvatar, assistantName, agentOptions
   const [isLoadingOlderMessages, setIsLoadingOlderMessages] = useState2(false);
   const [messagePageInfo, setMessagePageInfo] = useState2(createEmptyMessagePageInfo);
   const [isStreaming, setIsStreaming] = useState2(false);
+  const [threadActivityStatus, setThreadActivityStatus] = useState2("idle");
+  const [isRecoveringStream, setIsRecoveringStream] = useState2(false);
   const [specialState, setSpecialState] = useState2(null);
   const [userContextSeed, setUserContextSeed] = useState2(initialContext || {});
   const preferredAgentRef = useRef2(preferredAgentName ?? null);
@@ -1918,8 +1920,83 @@ function useCopilotz({ userId, userName, userAvatar, assistantName, agentOptions
       }
     }
   }, [getRequestHeaders, prepareThreadMessages]);
+  const finalizeStreamingPlaceholders = useCallback2((nextActivityStatus = "idle") => {
+    setThreadActivityStatus(nextActivityStatus);
+    setIsRecoveringStream(false);
+    setIsStreaming(false);
+    setMessages((prev) => {
+      const hasStreaming = prev.some((msg) => msg.isStreaming);
+      if (!hasStreaming) return prev;
+      return prev.map((msg) => msg.isStreaming ? closeAssistantMessage(msg) : msg);
+    });
+  }, []);
+  const startThreadActivityRecovery = useCallback2(
+    (threadId) => {
+      const generation = ++recoveryPollGenerationRef.current;
+      setThreadActivityStatus("running");
+      setIsRecoveringStream(true);
+      setIsStreaming(true);
+      void (async () => {
+        let delayMs = 2e3;
+        let attempts = 0;
+        while (recoveryPollGenerationRef.current === generation) {
+          await new Promise((resolve) => setTimeout(resolve, delayMs));
+          if (recoveryPollGenerationRef.current !== generation) return;
+          if (currentThreadIdRef.current !== threadId) return;
+          try {
+            const activity = await fetchThreadActivity(threadId, getRequestHeaders);
+            setThreadActivityStatus(activity.status);
+            if (activity.status === "running") {
+              attempts += 1;
+              if (attempts % 3 === 0) {
+                await loadThreadMessages(threadId);
+              }
+              if (attempts >= 15) {
+                delayMs = 5e3;
+              }
+              continue;
+            }
+            await loadThreadMessages(threadId);
+            finalizeStreamingPlaceholders(activity.status);
+            return;
+          } catch (error) {
+            if (isAbortError(error)) return;
+            attempts += 1;
+            if (attempts >= 15) {
+              delayMs = 5e3;
+            }
+          }
+        }
+      })();
+    },
+    [finalizeStreamingPlaceholders, getRequestHeaders, loadThreadMessages]
+  );
+  const refreshThreadActivity = useCallback2(
+    async (threadId) => {
+      try {
+        const activity = await fetchThreadActivity(threadId, getRequestHeaders);
+        setThreadActivityStatus(activity.status);
+        if (activity.status === "running") {
+          startThreadActivityRecovery(threadId);
+          return;
+        }
+        setIsRecoveringStream(false);
+        if (activity.status === "failed") {
+          await loadThreadMessages(threadId);
+        }
+      } catch (error) {
+        if (isAbortError(error)) return;
+        console.warn("Unable to load Copilotz thread activity", error);
+      }
+    },
+    [getRequestHeaders, loadThreadMessages, startThreadActivityRecovery]
+  );
   const handleSelectThread = useCallback2(
     async (threadId) => {
+      recoveryPollGenerationRef.current += 1;
+      setThreadActivityStatus("idle");
+      setIsRecoveringStream(false);
+      setIsStreaming(false);
       setCurrentThreadId(threadId);
       setMessages([]);
       setMessagePageInfo(createEmptyMessagePageInfo());
@@ -1927,13 +2004,18 @@ function useCopilotz({ userId, userName, userAvatar, assistantName, agentOptions
       const extMap = threadExternalIdMapRef.current;
       setCurrentThreadExternalId(extMap[threadId] ?? null);
       await loadThreadMessages(threadId);
+      await refreshThreadActivity(threadId);
     },
-    [loadThreadMessages]
+    [loadThreadMessages, refreshThreadActivity]
   );
   const handleCreateThread = useCallback2((title) => {
     messagesRequestRef.current += 1;
     setIsMessagesLoading(false);
     setIsLoadingOlderMessages(false);
+    recoveryPollGenerationRef.current += 1;
+    setThreadActivityStatus("idle");
+    setIsRecoveringStream(false);
+    setIsStreaming(false);
     const id = generateId();
     const now = nowTs();
     const newThread = {
@@ -2090,6 +2172,8 @@ function useCopilotz({ userId, userName, userAvatar, assistantName, agentOptions
     recoveryPollGenerationRef.current += 1;
     abortControllerRef.current?.abort();
     abortControllerRef.current = null;
+    setThreadActivityStatus("idle");
+    setIsRecoveringStream(false);
     setIsStreaming(false);
     setMessages((prev) => {
       const hasStreaming = prev.some((msg) => msg.isStreaming);
@@ -2118,52 +2202,6 @@ function useCopilotz({ userId, userName, userAvatar, assistantName, agentOptions
       )
     );
   }, []);
-  const finalizeStreamingPlaceholders = useCallback2(() => {
-    setIsStreaming(false);
-    setMessages((prev) => {
-      const hasStreaming = prev.some((msg) => msg.isStreaming);
-      if (!hasStreaming) return prev;
-      return prev.map((msg) => msg.isStreaming ? closeAssistantMessage(msg) : msg);
-    });
-  }, []);
-  const startThreadActivityRecovery = useCallback2(
-    (threadId) => {
-      const generation = ++recoveryPollGenerationRef.current;
-      setIsStreaming(true);
-      void (async () => {
-        let delayMs = 2e3;
-        let attempts = 0;
-        while (recoveryPollGenerationRef.current === generation) {
-          await new Promise((resolve) => setTimeout(resolve, delayMs));
-          if (recoveryPollGenerationRef.current !== generation) return;
-          if (currentThreadIdRef.current !== threadId) return;
-          try {
-            const activity = await fetchThreadActivity(threadId, getRequestHeaders);
-            if (activity.status === "running") {
-              attempts += 1;
-              if (attempts % 3 === 0) {
-                await loadThreadMessages(threadId);
-              }
-              if (attempts >= 15) {
-                delayMs = 5e3;
-              }
-              continue;
-            }
-            await loadThreadMessages(threadId);
-            finalizeStreamingPlaceholders();
-            return;
-          } catch (error) {
-            if (isAbortError(error)) return;
-            attempts += 1;
-            if (attempts >= 15) {
-              delayMs = 5e3;
-            }
-          }
-        }
-      })();
-    },
-    [finalizeStreamingPlaceholders, getRequestHeaders, loadThreadMessages]
-  );
   const sendCopilotzMessage = useCallback2(
     async (params) => {
       let currentAssistantId = params.assistantMessageId ?? generateId();
@@ -2308,6 +2346,8 @@ function useCopilotz({ userId, userName, userAvatar, assistantName, agentOptions
       abortControllerRef.current = abortController;
       stopRequestedRef.current = false;
       recoveryPollGenerationRef.current += 1;
+      setThreadActivityStatus("running");
+      setIsRecoveringStream(false);
       setIsStreaming(true);
       liveToolUpdatesRef.current = [];
       let streamError = null;
@@ -2493,10 +2533,12 @@ function useCopilotz({ userId, userName, userAvatar, assistantName, agentOptions
           const activityThreadId = await resolveActivityThreadId();
           if (activityThreadId) {
             const activity = await fetchThreadActivity(activityThreadId, getRequestHeaders);
+            setThreadActivityStatus(activity.status);
             if (activity.status === "running") {
               recoveryStarted = true;
               startThreadActivityRecovery(activityThreadId);
             } else if (streamError || activity.status === "failed") {
+              setIsRecoveringStream(false);
               await loadThreadMessages(activityThreadId);
             }
           }
@@ -2677,6 +2719,8 @@ function useCopilotz({ userId, userName, userAvatar, assistantName, agentOptions
       ]);
       setMessagePageInfo(createEmptyMessagePageInfo());
       persistedToolUpdatesRef.current = [];
+      setThreadActivityStatus("running");
+      setIsRecoveringStream(false);
       setSpecialState(null);
       try {
         await sendCopilotzMessage({
@@ -2730,6 +2774,8 @@ function useCopilotz({ userId, userName, userAvatar, assistantName, agentOptions
     setIsMessagesLoading(false);
     setIsLoadingOlderMessages(false);
     setIsStreaming(false);
+    setThreadActivityStatus("idle");
+    setIsRecoveringStream(false);
     setMessagePageInfo(createEmptyMessagePageInfo());
     persistedToolUpdatesRef.current = [];
     setSpecialState(null);
@@ -2746,6 +2792,7 @@ function useCopilotz({ userId, userName, userAvatar, assistantName, agentOptions
         const preferredThreadId = await fetchAndSetThreadsState(userId, urlPreferredThread);
         if (preferredThreadId) {
           await loadThreadMessages(preferredThreadId);
+          await refreshThreadActivity(preferredThreadId);
         } else if (bootstrap) {
           await bootstrapConversation(userId);
         }
@@ -2755,7 +2802,7 @@ function useCopilotz({ userId, userName, userAvatar, assistantName, agentOptions
       initializationRef.current = { userId: null, started: false };
       reset();
     }
-  }, [userId, fetchAndSetThreadsState, loadThreadMessages, bootstrapConversation, reset, bootstrap, isUrlSyncEnabled]);
+  }, [userId, fetchAndSetThreadsState, loadThreadMessages, refreshThreadActivity, bootstrapConversation, reset, bootstrap, isUrlSyncEnabled]);
   useEffect2(() => {
     if (!isUrlSyncEnabled) return;
     if (!initializationRef.current.started) return;
@@ -2772,6 +2819,13 @@ function useCopilotz({ userId, userName, userAvatar, assistantName, agentOptions
       }));
     }
   }, [currentThreadId, threadMetadataMap]);
+  const activityNotice = threadActivityStatus === "running" && isRecoveringStream ? {
+    tone: "info",
+    message: "The agent is still working. Loading updates..."
+  } : threadActivityStatus === "failed" ? {
+    tone: "error",
+    message: "The last run failed. Refreshing the latest messages..."
+  } : null;
   return {
     messages: messages.map(toPublicChatMessage),
     isMessagesLoading,
@@ -2780,6 +2834,9 @@ function useCopilotz({ userId, userName, userAvatar, assistantName, agentOptions
     threads,
     currentThreadId,
     isStreaming,
+    threadActivityStatus,
+    isRecoveringStream,
+    activityNotice,
     specialState,
     clearSpecialState,
     userContextSeed,
@@ -2812,7 +2869,7 @@ var CopilotzChat = ({ userId, userName, userAvatar, userEmail, initialContext, b
     if (!targetAgentId) return null;
     return targetAgentId;
   }, [targetAgentId]);
-  const { messages, isMessagesLoading, isLoadingOlderMessages, messagePageInfo, threads, currentThreadId, isStreaming, specialState, clearSpecialState, userContextSeed, sendMessage, createThread, selectThread, renameThread, archiveThread, updateThreadTags, editMessage, deleteThread: deleteThread2, stopGeneration, loadOlderMessages } = useCopilotz({
+  const { messages, isMessagesLoading, isLoadingOlderMessages, messagePageInfo, threads, currentThreadId, isStreaming, activityNotice, specialState, clearSpecialState, userContextSeed, sendMessage, createThread, selectThread, renameThread, archiveThread, updateThreadTags, editMessage, deleteThread: deleteThread2, stopGeneration, loadOlderMessages } = useCopilotz({
     userId,
     userName,
     userAvatar,
@@ -2913,7 +2970,7 @@ var CopilotzChat = ({ userId, userName, userAvatar, userEmail, initialContext, b
     [userConfig?.branding?.title, userConfig?.branding?.avatar, userConfig?.branding?.subtitle]
   );
   const specialStateContent = specialState ? renderSpecialState?.(specialState, { clear: clearSpecialState }) : null;
-  return /* @__PURE__ */ jsx(ChatUserContextProvider, { initial: userContextSeed, children: specialStateContent ?? /* @__PURE__ */ jsx(ChatUI, { messages, isMessagesLoading, isLoadingOlderMessages, hasMoreMessagesBefore: messagePageInfo.hasMoreBefore, onLoadOlderMessages: loadOlderMessages, threads, currentThreadId, config: mergedConfig, callbacks: chatCallbacks, isGenerating: isStreaming, suggestions, agentOptions, selectedAgentId, onSelectAgent, participantIds, onParticipantsChange, targetAgentId, onTargetAgentChange, user: userProp, assistant: assistantProp, onAddMemory, onUpdateMemory, onDeleteMemory, userMenuSections, userMenuAdditionalItems, className }) });
+  return /* @__PURE__ */ jsx(ChatUserContextProvider, { initial: userContextSeed, children: specialStateContent ?? /* @__PURE__ */ jsx(ChatUI, { messages, isMessagesLoading, isLoadingOlderMessages, hasMoreMessagesBefore: messagePageInfo.hasMoreBefore, activityNotice, onLoadOlderMessages: loadOlderMessages, threads, currentThreadId, config: mergedConfig, callbacks: chatCallbacks, isGenerating: isStreaming, suggestions, agentOptions, selectedAgentId, onSelectAgent, participantIds, onParticipantsChange, targetAgentId, onTargetAgentChange, user: userProp, assistant: assistantProp, onAddMemory, onUpdateMemory, onDeleteMemory, userMenuSections, userMenuAdditionalItems, className }) });
 };
 export {
   CopilotzChat,