@personaai/react 0.7.2 → 0.7.4

package/dist/index.d.cts

@@ -258,6 +258,16 @@ interface UseChatOptions {
     onError?: (error: Error) => void;
     /** Hook for receiving every low-level AG-UI streaming event (tool calls, steps, subagents) */
     onEvent?: (event: PersonaStreamingEvent) => void;
+    /**
+     * Pass the object returned by `useVoice()` (sharing the same `threadId`) to have `useChat`
+     * merge live voice turns into `messages` automatically — one bubble per utterance, deduped
+     * against thread history and against a voice turn that already persisted back into this
+     * thread, with the in-progress agent line updated in place while it's still being spoken.
+     * No manual sync effects needed in the host app; injected messages get a `voice-` prefixed id.
+     * Only applied while the passed hook's `state` is active (not `idle`/`ended`/`error`); the
+     * host app still owns starting/stopping the call itself (e.g. `voice.start()`/`voice.stop()`).
+     */
+    voice?: UseVoiceResult;
 }
 interface SendMessageOverride {
     agentId?: string;
@@ -574,6 +584,6 @@ declare function supportsStreamingFetch(): boolean;
  */
 declare function openSSEStream(opts: OpenSSEOptions): Promise<SSEStream>;
 
-declare const VERSION = "0.7.2";
+declare const VERSION = "0.7.3";
 
 export { type OpenSSEOptions, type PersonaAgentSummary, type PersonaClarificationQuestion, type PersonaFileItem, type PersonaHealthInfo, type PersonaHitlActionRequest, type PersonaInterrupt, type PersonaMcpConnection, type PersonaMemoryAgentGroup, type PersonaMemoryFile, type PersonaMemoryList, type PersonaMessage, type PersonaPresentedFile, PersonaProvider, type PersonaProviderProps, type PersonaResumeValue, type PersonaRole, type PersonaStreamingEvent, type PersonaSubagentActivityEntry, type PersonaThread, type PersonaTodo, type PersonaToolCall, type PersonaVoiceEndReason, type PersonaVoiceState, type PersonaVoiceToolCall, type PersonaVoiceTranscriptLine, type PersonaWorkspaceFile, type SSEReader, type SSEStream, type SendMessageOverride, type UseChatOptions, type UseMcpConnectionsOptions, type UseVoiceOptions, type UseVoiceResult, VERSION, openSSEStream, supportsStreamingFetch, useAgents, useChat, useConnection, useFiles, useMcpConnections, useMemory, usePersonaContext, useThreads, useVoice };

package/dist/index.d.ts

@@ -258,6 +258,16 @@ interface UseChatOptions {
     onError?: (error: Error) => void;
     /** Hook for receiving every low-level AG-UI streaming event (tool calls, steps, subagents) */
     onEvent?: (event: PersonaStreamingEvent) => void;
+    /**
+     * Pass the object returned by `useVoice()` (sharing the same `threadId`) to have `useChat`
+     * merge live voice turns into `messages` automatically — one bubble per utterance, deduped
+     * against thread history and against a voice turn that already persisted back into this
+     * thread, with the in-progress agent line updated in place while it's still being spoken.
+     * No manual sync effects needed in the host app; injected messages get a `voice-` prefixed id.
+     * Only applied while the passed hook's `state` is active (not `idle`/`ended`/`error`); the
+     * host app still owns starting/stopping the call itself (e.g. `voice.start()`/`voice.stop()`).
+     */
+    voice?: UseVoiceResult;
 }
 interface SendMessageOverride {
     agentId?: string;
@@ -574,6 +584,6 @@ declare function supportsStreamingFetch(): boolean;
  */
 declare function openSSEStream(opts: OpenSSEOptions): Promise<SSEStream>;
 
-declare const VERSION = "0.7.2";
+declare const VERSION = "0.7.3";
 
 export { type OpenSSEOptions, type PersonaAgentSummary, type PersonaClarificationQuestion, type PersonaFileItem, type PersonaHealthInfo, type PersonaHitlActionRequest, type PersonaInterrupt, type PersonaMcpConnection, type PersonaMemoryAgentGroup, type PersonaMemoryFile, type PersonaMemoryList, type PersonaMessage, type PersonaPresentedFile, PersonaProvider, type PersonaProviderProps, type PersonaResumeValue, type PersonaRole, type PersonaStreamingEvent, type PersonaSubagentActivityEntry, type PersonaThread, type PersonaTodo, type PersonaToolCall, type PersonaVoiceEndReason, type PersonaVoiceState, type PersonaVoiceToolCall, type PersonaVoiceTranscriptLine, type PersonaWorkspaceFile, type SSEReader, type SSEStream, type SendMessageOverride, type UseChatOptions, type UseMcpConnectionsOptions, type UseVoiceOptions, type UseVoiceResult, VERSION, openSSEStream, supportsStreamingFetch, useAgents, useChat, useConnection, useFiles, useMcpConnections, useMemory, usePersonaContext, useThreads, useVoice };

package/dist/index.js

@@ -392,6 +392,9 @@ function useChat(options = {}) {
   const [presentedFile, setPresentedFile] = useState(null);
   const abortControllerRef = useRef(null);
   const loadedThreadIdRef = useRef(void 0);
+  const voiceThreadRef = useRef(threadId);
+  const voicePrevLenRef = useRef(0);
+  const voiceStreamingIdRef = useRef(null);
   const stop = useCallback(() => {
     if (abortControllerRef.current) {
       chatLogger.info("stop streaming", {});
@@ -497,6 +500,75 @@ function useChat(options = {}) {
     chatLogger.debug("loadThreadMessages trigger", { threadId });
     void loadThreadMessages(threadId);
   }, [threadId, isStreaming, messages.length, loadThreadMessages, chatLogger]);
+  const voice = options.voice;
+  useEffect(() => {
+    if (!voice) return;
+    if (voiceThreadRef.current !== threadId) {
+      voiceThreadRef.current = threadId;
+      voicePrevLenRef.current = voice.transcript.length;
+      voiceStreamingIdRef.current = null;
+      return;
+    }
+    const isVoiceActive = voice.state !== "idle" && voice.state !== "ended" && voice.state !== "error";
+    const curLen = voice.transcript.length;
+    if (curLen < voicePrevLenRef.current) {
+      voicePrevLenRef.current = 0;
+      voiceStreamingIdRef.current = null;
+    }
+    if (!isVoiceActive) {
+      voicePrevLenRef.current = voice.transcript.length;
+      if (voiceStreamingIdRef.current) {
+        const doneId = voiceStreamingIdRef.current;
+        voiceStreamingIdRef.current = null;
+        setMessages(
+          (prev) => prev.map((m) => m.id === doneId ? { ...m, isStreaming: false } : m)
+        );
+      }
+      return;
+    }
+    if (curLen > voicePrevLenRef.current) {
+      const newLines = voice.transcript.slice(voicePrevLenRef.current);
+      voicePrevLenRef.current = curLen;
+      for (const line of newLines) {
+        const text = (line.text || "").trim();
+        if (!text) continue;
+        const role = line.speaker === "user" ? "user" : "assistant";
+        const voiceId = `voice-${line.id}`;
+        setMessages((prev) => {
+          if (prev.some((m) => m.id === voiceId)) return prev;
+          if (prev.some(
+            (m) => !m.id.startsWith("voice-") && m.role === role && m.content.trim() === text
+          ))
+            return prev;
+          const last = prev[prev.length - 1];
+          if (last?.id.startsWith("voice-") && last.role === "assistant" && role === "assistant") {
+            const merged = text.startsWith(last.content) ? text : `${last.content} ${text}`.trim();
+            return [...prev.slice(0, -1), { ...last, content: merged, isStreaming: false }];
+          }
+          return [...prev, { id: voiceId, role, content: text, createdAt: /* @__PURE__ */ new Date() }];
+        });
+      }
+    }
+    const partialText = voice.partial?.speaker === "agent" ? voice.partial.text.trim() : "";
+    if (partialText) {
+      setMessages((prev) => {
+        const last = prev[prev.length - 1];
+        if (last?.id.startsWith("voice-") && last.role === "assistant") {
+          voiceStreamingIdRef.current = last.id;
+          return [...prev.slice(0, -1), { ...last, content: partialText, isStreaming: true }];
+        }
+        const id = voiceStreamingIdRef.current || `voice-partial-${Date.now()}`;
+        voiceStreamingIdRef.current = id;
+        return [...prev, { id, role: "assistant", content: partialText, isStreaming: true, createdAt: /* @__PURE__ */ new Date() }];
+      });
+    } else if (voice.state !== "speaking" && voiceStreamingIdRef.current) {
+      const doneId = voiceStreamingIdRef.current;
+      voiceStreamingIdRef.current = null;
+      setMessages(
+        (prev) => prev.map((m) => m.id === doneId ? { ...m, isStreaming: false } : m)
+      );
+    }
+  }, [voice?.transcript, voice?.partial, voice?.state, threadId]);
   const sendMessage = useCallback(
     async (contentToSend, overrideOptions) => {
       const prompt = (contentToSend ?? input).trim();
@@ -1439,10 +1511,11 @@ function useVoice(options = {}) {
     }
     setPartial((prev) => prev?.speaker === speaker ? null : prev);
     const last = lastFinalTurnRef.current;
-    const sameUtterance = last && last.speaker === speaker && last.turnSeq === turnSeq;
+    const sameUserBurst = speaker === "user" && last && last.speaker === speaker && last.turnSeq === turnSeq;
     setTranscript((prev) => {
       const tail = prev[prev.length - 1];
-      if (sameUtterance && tail?.speaker === speaker) {
+      const agentContinues = speaker === "agent" && tail?.speaker === "agent";
+      if (agentContinues || sameUserBurst && tail?.speaker === "user") {
         const merged = mergeTranscriptText(tail.text, text);
         if (merged === tail.text) return prev;
         return prev.map(
@@ -1888,7 +1961,7 @@ import {
   getLogLevel,
   isLevelEnabled
 } from "@personaai/logger";
-var VERSION = "0.7.2";
+var VERSION = "0.7.3";
 export {
   PersonaProvider,
   VERSION,