@poolse/react 3.1.0 → 3.2.0-dev.1

package/dist/index.d.cts

@@ -324,6 +324,30 @@ interface UseTypingState {
  */
 declare function useTyping(conversationId: string): UseTypingState;
 
+/** An AI agent's reply that's still being written. */
+interface MessageStream {
+    /** Becomes the finished message's id. */
+    id: Uuid;
+    conversation_id: Uuid;
+    sender_id: Uuid;
+    sender_external_id: string | null;
+    /** The text so far; empty until the first delta. */
+    text: string;
+    status: 'streaming' | 'failed';
+    /** The tool the agent is running right now, if any (cleared by the next text). */
+    tool?: string;
+    error?: string;
+}
+/**
+ * AI agent replies being written in `conversationId`, oldest first.
+ *
+ * Built from `message:stream` events: `started` adds a stream, each
+ * `delta` appends text, `failed` marks it failed (removed after a few
+ * seconds). When the finished reply arrives as `message:new` with the
+ * same id, the stream is removed — `useMessages` shows the message.
+ */
+declare function useMessageStreams(conversationId: string): MessageStream[];
+
 interface UsePresenceState {
     /**
      * Set of `external_id`s currently online in this conversation —
@@ -692,4 +716,4 @@ declare function canEditOwnMessage(args: {
     now?: number;
 }): boolean;
 
-export { EDIT_WINDOW_MS, type GroupPosition, PoolseProvider, type PoolseProviderProps, type ReactionMap, type UploadItem, type UploadItemStatus, type UseCallRoom, type UseCallRoomOptions, type UseLiveCall, type UseReadReceipts, type UseRoom, type UseRoomOptions, type UseUserState, canEditOwnMessage, computeGroupPosition, formatDayLabel, receiptsOf, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useConversation, useConversations, useLiveCall, useMe, useMembers, useMessages, usePoolse, usePresence, useReactions, useReadReceipts, useRealtimeStatus, useRoom, useThread, useTyping, useUser };
+export { EDIT_WINDOW_MS, type GroupPosition, type MessageStream, PoolseProvider, type PoolseProviderProps, type ReactionMap, type UploadItem, type UploadItemStatus, type UseCallRoom, type UseCallRoomOptions, type UseLiveCall, type UseReadReceipts, type UseRoom, type UseRoomOptions, type UseUserState, canEditOwnMessage, computeGroupPosition, formatDayLabel, receiptsOf, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useConversation, useConversations, useLiveCall, useMe, useMembers, useMessageStreams, useMessages, usePoolse, usePresence, useReactions, useReadReceipts, useRealtimeStatus, useRoom, useThread, useTyping, useUser };

package/dist/index.d.ts

@@ -324,6 +324,30 @@ interface UseTypingState {
  */
 declare function useTyping(conversationId: string): UseTypingState;
 
+/** An AI agent's reply that's still being written. */
+interface MessageStream {
+    /** Becomes the finished message's id. */
+    id: Uuid;
+    conversation_id: Uuid;
+    sender_id: Uuid;
+    sender_external_id: string | null;
+    /** The text so far; empty until the first delta. */
+    text: string;
+    status: 'streaming' | 'failed';
+    /** The tool the agent is running right now, if any (cleared by the next text). */
+    tool?: string;
+    error?: string;
+}
+/**
+ * AI agent replies being written in `conversationId`, oldest first.
+ *
+ * Built from `message:stream` events: `started` adds a stream, each
+ * `delta` appends text, `failed` marks it failed (removed after a few
+ * seconds). When the finished reply arrives as `message:new` with the
+ * same id, the stream is removed — `useMessages` shows the message.
+ */
+declare function useMessageStreams(conversationId: string): MessageStream[];
+
 interface UsePresenceState {
     /**
      * Set of `external_id`s currently online in this conversation —
@@ -692,4 +716,4 @@ declare function canEditOwnMessage(args: {
     now?: number;
 }): boolean;
 
-export { EDIT_WINDOW_MS, type GroupPosition, PoolseProvider, type PoolseProviderProps, type ReactionMap, type UploadItem, type UploadItemStatus, type UseCallRoom, type UseCallRoomOptions, type UseLiveCall, type UseReadReceipts, type UseRoom, type UseRoomOptions, type UseUserState, canEditOwnMessage, computeGroupPosition, formatDayLabel, receiptsOf, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useConversation, useConversations, useLiveCall, useMe, useMembers, useMessages, usePoolse, usePresence, useReactions, useReadReceipts, useRealtimeStatus, useRoom, useThread, useTyping, useUser };
+export { EDIT_WINDOW_MS, type GroupPosition, type MessageStream, PoolseProvider, type PoolseProviderProps, type ReactionMap, type UploadItem, type UploadItemStatus, type UseCallRoom, type UseCallRoomOptions, type UseLiveCall, type UseReadReceipts, type UseRoom, type UseRoomOptions, type UseUserState, canEditOwnMessage, computeGroupPosition, formatDayLabel, receiptsOf, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useConversation, useConversations, useLiveCall, useMe, useMembers, useMessageStreams, useMessages, usePoolse, usePresence, useReactions, useReadReceipts, useRealtimeStatus, useRoom, useThread, useTyping, useUser };

package/dist/index.js

@@ -853,6 +853,66 @@ function useTyping(conversationId) {
   }, [chat, conversationId]);
   return { typing, signalTyping };
 }
+var FAILED_TTL_MS = 8e3;
+var STALE_MS = 9e4;
+function useMessageStreams(conversationId) {
+  const chat = usePoolse();
+  const [streams, setStreams] = useState([]);
+  useEffect(() => {
+    setStreams([]);
+    const timers = /* @__PURE__ */ new Map();
+    const remove = (id) => {
+      const t = timers.get(id);
+      if (t) clearTimeout(t);
+      timers.delete(id);
+      setStreams(
+        (prev) => prev.some((s) => s.id === id) ? prev.filter((s) => s.id !== id) : prev
+      );
+    };
+    const arm = (id, ms) => {
+      const t = timers.get(id);
+      if (t) clearTimeout(t);
+      timers.set(
+        id,
+        setTimeout(() => remove(id), ms)
+      );
+    };
+    const conv = chat.realtime.conversation(conversationId);
+    const offStream = conv.onMessageStream((evt) => {
+      setStreams((prev) => {
+        const existing = prev.find((s) => s.id === evt.id);
+        const base = existing ?? {
+          id: evt.id,
+          conversation_id: evt.conversation_id,
+          sender_id: evt.sender_id,
+          sender_external_id: evt.sender_external_id ?? null,
+          text: "",
+          status: "streaming"
+        };
+        let next;
+        if (evt.status === "delta") {
+          const { tool: _done, ...rest } = base;
+          next = { ...rest, text: base.text + (evt.delta ?? "") };
+        } else if (evt.status === "tool")
+          next = { ...base, ...evt.tool ? { tool: evt.tool } : {} };
+        else if (evt.status === "failed")
+          next = { ...base, status: "failed", ...evt.error ? { error: evt.error } : {} };
+        else
+          next = { ...base, sender_external_id: evt.sender_external_id ?? base.sender_external_id };
+        return existing ? prev.map((s) => s.id === evt.id ? next : s) : [...prev, next];
+      });
+      arm(evt.id, evt.status === "failed" ? FAILED_TTL_MS : STALE_MS);
+    });
+    const offMessage = conv.onMessage((msg) => remove(msg.id));
+    return () => {
+      offStream();
+      offMessage();
+      timers.forEach((t) => clearTimeout(t));
+      timers.clear();
+    };
+  }, [chat, conversationId]);
+  return streams;
+}
 function externalIdsFrom(state) {
   const out = [];
   for (const presence of Object.values(state)) {
@@ -1398,6 +1458,6 @@ function canEditOwnMessage(args) {
   return Number.isFinite(sent) && (args.now ?? Date.now()) - sent < EDIT_WINDOW_MS;
 }
 
-export { EDIT_WINDOW_MS, PoolseProvider, canEditOwnMessage, computeGroupPosition, formatDayLabel, receiptsOf, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useConversation, useConversations, useLiveCall, useMe, useMembers, useMessages, usePoolse, usePresence, useReactions, useReadReceipts, useRealtimeStatus, useRoom, useThread, useTyping, useUser };
+export { EDIT_WINDOW_MS, PoolseProvider, canEditOwnMessage, computeGroupPosition, formatDayLabel, receiptsOf, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useConversation, useConversations, useLiveCall, useMe, useMembers, useMessageStreams, useMessages, usePoolse, usePresence, useReactions, useReadReceipts, useRealtimeStatus, useRoom, useThread, useTyping, useUser };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map