@poolse/react 3.1.0 → 3.2.0-dev.0

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to `@poolse/react` are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versions follow
 [semver](https://semver.org).
 
+## [3.2.0-dev.0] — 2026-11-04 (prerelease, npm tag `dev`)
+
+### Added
+
+- `useMessageStreams(conversationId)`: AI agent replies being written,
+  built from `message:stream`; each is dropped when its finished message
+  arrives.
+
 ## [3.1.0] — 2026-10-27
 
 ### Fixed

package/dist/index.cjs

@@ -854,6 +854,62 @@ 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] = react.useState([]);
+  react.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") next = { ...base, text: base.text + (evt.delta ?? "") };
+        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)) {
@@ -1467,6 +1523,7 @@ exports.useConversations = useConversations;
 exports.useLiveCall = useLiveCall;
 exports.useMe = useMe;
 exports.useMembers = useMembers;
+exports.useMessageStreams = useMessageStreams;
 exports.useMessages = useMessages;
 exports.usePoolse = usePoolse;
 exports.usePresence = usePresence;