@copilotz/chat-adapter 0.9.22 → 0.9.24

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

@@ -629,6 +629,9 @@ async function fetchThreadMessagesPage(threadId, options, getRequestHeaders) {
   if (options?.before) {
     params.set("before", options.before);
   }
+  if (options?.after) {
+    params.set("after", options.after);
+  }
   const res = await fetch(
     apiUrl(`/v1/threads/${threadId}/messages?${params.toString()}`),
     {
@@ -1636,6 +1639,61 @@ var createEmptyMessagePageInfo = () => ({
   oldestMessageId: null,
   newestMessageId: null
 });
+var stringifyForCompare = (value) => {
+  if (value === void 0) return "";
+  try {
+    return JSON.stringify(value) ?? "";
+  } catch {
+    return String(value);
+  }
+};
+var getMessageSignature = (message) => JSON.stringify({
+  id: message.id,
+  role: message.role,
+  content: message.content ?? "",
+  isStreaming: message.isStreaming === true,
+  isComplete: message.isComplete === true,
+  attachments: stringifyForCompare(message.attachments),
+  activity: stringifyForCompare(message.activity),
+  metadata: stringifyForCompare(message.metadata),
+  sender: message.sender ? {
+    id: message.sender.id,
+    type: message.sender.type,
+    name: message.sender.name,
+    agentId: message.sender.agentId
+  } : null
+});
+var reconcileThreadMessages = (currentMessages, freshMessages) => {
+  if (freshMessages.length === 0) {
+    return { messages: currentMessages, changed: false };
+  }
+  if (currentMessages.length === 0) {
+    return { messages: freshMessages, changed: true };
+  }
+  const freshById = new Map(freshMessages.map((message) => [message.id, message]));
+  const seen = /* @__PURE__ */ new Set();
+  let changed = false;
+  const nextMessages = currentMessages.map((message) => {
+    const fresh = freshById.get(message.id);
+    if (!fresh) return message;
+    seen.add(message.id);
+    if (getMessageSignature(message) === getMessageSignature(fresh)) {
+      return message;
+    }
+    changed = true;
+    return fresh;
+  });
+  const appended = freshMessages.filter((message) => !seen.has(message.id));
+  if (appended.length > 0) {
+    changed = true;
+    nextMessages.push(...appended);
+    nextMessages.sort((a, b) => {
+      const timestampDelta = (a.timestamp ?? 0) - (b.timestamp ?? 0);
+      return timestampDelta !== 0 ? timestampDelta : a.id.localeCompare(b.id);
+    });
+  }
+  return changed ? { messages: nextMessages, changed } : { messages: currentMessages, changed: false };
+};
 var createPendingAssistantActivity = () => ({
   items: [
     {
@@ -1659,6 +1717,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);
@@ -1893,6 +1953,34 @@ function useCopilotz({ userId, userName, userAvatar, assistantName, agentOptions
     },
     [getRequestHeaders, prepareThreadMessages]
   );
+  const refreshThreadMessages = useCallback2(
+    async (threadId) => {
+      const requestId = messagesRequestRef.current;
+      try {
+        const page = await fetchThreadMessagesPage(threadId, { limit: THREAD_MESSAGES_PAGE_SIZE }, getRequestHeaders);
+        const { viewMessages, toolResultUpdates } = await prepareThreadMessages(page.data);
+        if (messagesRequestRef.current !== requestId) return;
+        persistedToolUpdatesRef.current = [
+          ...persistedToolUpdatesRef.current,
+          ...toolResultUpdates.filter((update) => !persistedToolUpdatesRef.current.some((current) => matchesToolResultUpdate(current, update)))
+        ];
+        const hydratedMessages = mergePersistedToolResults(viewMessages, persistedToolUpdatesRef.current);
+        setMessages((prev) => {
+          const reconciled = reconcileThreadMessages(prev, hydratedMessages);
+          return reconciled.changed ? reconciled.messages : prev;
+        });
+        setMessagePageInfo((prev) => ({
+          hasMoreBefore: prev.hasMoreBefore || page.pageInfo.hasMoreBefore,
+          oldestMessageId: prev.oldestMessageId ?? page.pageInfo.oldestMessageId,
+          newestMessageId: page.pageInfo.newestMessageId ?? prev.newestMessageId
+        }));
+      } catch (error) {
+        if (isAbortError(error)) return;
+        console.error(`Error refreshing messages for thread ${threadId}`, error);
+      }
+    },
+    [getRequestHeaders, prepareThreadMessages]
+  );
   const loadOlderMessages = useCallback2(async () => {
     const threadId = currentThreadIdRef.current;
     const pageInfo = messagePageInfoRef.current;
@@ -1918,8 +2006,84 @@ 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;
+        await refreshThreadMessages(threadId);
+        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 refreshThreadMessages(threadId);
+              }
+              if (attempts >= 15) {
+                delayMs = 5e3;
+              }
+              continue;
+            }
+            await refreshThreadMessages(threadId);
+            finalizeStreamingPlaceholders(activity.status);
+            return;
+          } catch (error) {
+            if (isAbortError(error)) return;
+            attempts += 1;
+            if (attempts >= 15) {
+              delayMs = 5e3;
+            }
+          }
+        }
+      })();
+    },
+    [finalizeStreamingPlaceholders, getRequestHeaders, refreshThreadMessages]
+  );
+  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 refreshThreadMessages(threadId);
+        }
+      } catch (error) {
+        if (isAbortError(error)) return;
+        console.warn("Unable to load Copilotz thread activity", error);
+      }
+    },
+    [getRequestHeaders, refreshThreadMessages, startThreadActivityRecovery]
+  );
   const handleSelectThread = useCallback2(
     async (threadId) => {
+      recoveryPollGenerationRef.current += 1;
+      setThreadActivityStatus("idle");
+      setIsRecoveringStream(false);
+      setIsStreaming(false);
       setCurrentThreadId(threadId);
       setMessages([]);
       setMessagePageInfo(createEmptyMessagePageInfo());
@@ -1927,13 +2091,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 +2259,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 +2289,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 +2433,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,11 +2620,13 @@ 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") {
-              await loadThreadMessages(activityThreadId);
+              setIsRecoveringStream(false);
+              await refreshThreadMessages(activityThreadId);
             }
           }
         } catch (activityError) {
@@ -2516,7 +2645,7 @@ function useCopilotz({ userId, userName, userAvatar, assistantName, agentOptions
       }
       return currentAssistantId;
     },
-    [applyEventInterceptor, handleStreamMessageEvent, handleStreamAssetEvent, fetchAndSetThreadsState, finalizeStreamingPlaceholders, getRequestHeaders, loadThreadMessages, startThreadActivityRecovery]
+    [applyEventInterceptor, handleStreamMessageEvent, handleStreamAssetEvent, fetchAndSetThreadsState, finalizeStreamingPlaceholders, getRequestHeaders, refreshThreadMessages, startThreadActivityRecovery]
   );
   const handleSendMessage = useCallback2(
     async (content, attachments = []) => {
@@ -2677,6 +2806,8 @@ function useCopilotz({ userId, userName, userAvatar, assistantName, agentOptions
       ]);
       setMessagePageInfo(createEmptyMessagePageInfo());
       persistedToolUpdatesRef.current = [];
+      setThreadActivityStatus("running");
+      setIsRecoveringStream(false);
       setSpecialState(null);
       try {
         await sendCopilotzMessage({
@@ -2730,6 +2861,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 +2879,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 +2889,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 +2906,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 +2921,9 @@ function useCopilotz({ userId, userName, userAvatar, assistantName, agentOptions
     threads,
     currentThreadId,
     isStreaming,
+    threadActivityStatus,
+    isRecoveringStream,
+    activityNotice,
     specialState,
     clearSpecialState,
     userContextSeed,
@@ -2812,7 +2956,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, isRecoveringStream, activityNotice, specialState, clearSpecialState, userContextSeed, sendMessage, createThread, selectThread, renameThread, archiveThread, updateThreadTags, editMessage, deleteThread: deleteThread2, stopGeneration, loadOlderMessages } = useCopilotz({
     userId,
     userName,
     userAvatar,
@@ -2913,7 +3057,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, isBackgroundRefreshingMessages: isRecoveringStream, 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,