@personaai/react 0.7.0 → 0.7.2

package/dist/index.d.cts

@@ -300,6 +300,14 @@ type PersonaVoiceEndReason = "client_closed" | "agent_ended" | "max_duration" |
 interface UseVoiceOptions {
     /** Falls back to `PersonaProvider`'s `defaultAgentId` if omitted. */
     agentId?: string;
+    /**
+     * Resume an existing conversation over voice instead of starting fresh.
+     * `start()` mints the session with this thread id (same value `useChat`'s
+     * `threadId` uses), so voice turns are persisted back into that thread's
+     * history — a later text message on the same thread sees them. Omit (or
+     * leave undefined) to start a fresh conversation.
+     */
+    threadId?: string;
 }
 interface UseVoiceResult {
     state: PersonaVoiceState;
@@ -566,6 +574,6 @@ declare function supportsStreamingFetch(): boolean;
  */
 declare function openSSEStream(opts: OpenSSEOptions): Promise<SSEStream>;
 
-declare const VERSION = "0.7.0";
+declare const VERSION = "0.7.2";
 
 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

@@ -300,6 +300,14 @@ type PersonaVoiceEndReason = "client_closed" | "agent_ended" | "max_duration" |
 interface UseVoiceOptions {
     /** Falls back to `PersonaProvider`'s `defaultAgentId` if omitted. */
     agentId?: string;
+    /**
+     * Resume an existing conversation over voice instead of starting fresh.
+     * `start()` mints the session with this thread id (same value `useChat`'s
+     * `threadId` uses), so voice turns are persisted back into that thread's
+     * history — a later text message on the same thread sees them. Omit (or
+     * leave undefined) to start a fresh conversation.
+     */
+    threadId?: string;
 }
 interface UseVoiceResult {
     state: PersonaVoiceState;
@@ -566,6 +574,6 @@ declare function supportsStreamingFetch(): boolean;
  */
 declare function openSSEStream(opts: OpenSSEOptions): Promise<SSEStream>;
 
-declare const VERSION = "0.7.0";
+declare const VERSION = "0.7.2";
 
 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

@@ -1304,10 +1304,19 @@ function playerWorkletUrl() {
 }
 
 // src/hooks/useVoice.ts
+function mergeTranscriptText(prev, next) {
+  if (!prev) return next;
+  if (!next) return prev;
+  if (next === prev || prev.endsWith(next)) return prev;
+  if (next.startsWith(prev)) return next;
+  const needSpace = !/\s$/.test(prev) && !/^\s/.test(next);
+  return prev + (needSpace ? " " : "") + next;
+}
 function useVoice(options = {}) {
   const { defaultAgentId, fetchWithAuth, logger } = usePersonaContext();
   const voiceLogger = useMemo3(() => logger.child("voice"), [logger]);
   const agentId = options.agentId || defaultAgentId;
+  const threadId = options.threadId;
   const [state, setState] = useState4("idle");
   const [isMuted, setIsMuted] = useState4(false);
   const [transcript, setTranscript] = useState4(
@@ -1329,6 +1338,9 @@ function useVoice(options = {}) {
   const playerNodeRef = useRef2(null);
   const acceptedTurnSeqRef = useRef2(0);
   const mountedRef = useRef2(true);
+  const lastFinalTurnRef = useRef2(
+    null
+  );
   useEffect4(() => {
     mountedRef.current = true;
     return () => {
@@ -1411,8 +1423,7 @@ function useVoice(options = {}) {
     (id, patch) => {
       setToolCalls((prev) => {
         const idx = prev.findIndex((t) => t.id === id);
-        if (idx === -1)
-          return [...prev, { id, status: "running", ...patch }];
+        if (idx === -1) return [...prev, { id, status: "running", ...patch }];
         const next = [...prev];
         next[idx] = { ...next[idx], ...patch };
         return next;
@@ -1420,21 +1431,28 @@ function useVoice(options = {}) {
     },
     []
   );
-  const handleTranscript = useCallback4(
-    (value) => {
-      const { speaker, text, isFinal } = value;
-      if (isFinal) {
-        setPartial((prev) => prev?.speaker === speaker ? null : prev);
-        setTranscript((prev) => [
-          ...prev,
-          { id: `${speaker}-${prev.length}`, speaker, text }
-        ]);
-      } else {
-        setPartial({ id: "partial", speaker, text });
+  const handleTranscript = useCallback4((value) => {
+    const { speaker, text, isFinal, turnSeq } = value;
+    if (!isFinal) {
+      setPartial({ id: "partial", speaker, text });
+      return;
+    }
+    setPartial((prev) => prev?.speaker === speaker ? null : prev);
+    const last = lastFinalTurnRef.current;
+    const sameUtterance = last && last.speaker === speaker && last.turnSeq === turnSeq;
+    setTranscript((prev) => {
+      const tail = prev[prev.length - 1];
+      if (sameUtterance && tail?.speaker === speaker) {
+        const merged = mergeTranscriptText(tail.text, text);
+        if (merged === tail.text) return prev;
+        return prev.map(
+          (l, i) => i === prev.length - 1 ? { ...l, text: merged } : l
+        );
       }
-    },
-    []
-  );
+      return [...prev, { id: `${speaker}-${prev.length}`, speaker, text }];
+    });
+    lastFinalTurnRef.current = { speaker, turnSeq };
+  }, []);
   const handleCustomEvent = useCallback4(
     (name, value) => {
       switch (name) {
@@ -1467,9 +1485,7 @@ function useVoice(options = {}) {
           }
           break;
         case "voice_transcript":
-          handleTranscript(
-            value
-          );
+          handleTranscript(value);
           break;
         case "voice_interrupted":
           acceptedTurnSeqRef.current = value.turnSeq;
@@ -1542,7 +1558,9 @@ function useVoice(options = {}) {
         }
         case "RUN_ERROR":
           voiceLogger.warn("RUN_ERROR", { message: msg.message });
-          setError(new Error(msg.message || "The agent run failed."));
+          setError(
+            new Error(msg.message || "The agent run failed.")
+          );
           setState("error");
           break;
         default:
@@ -1567,12 +1585,15 @@ function useVoice(options = {}) {
     setToolCalls([]);
     acceptedTurnSeqRef.current = 0;
     setState("connecting");
-    voiceLogger.debug("start() called", { agentId });
+    voiceLogger.debug("start() called", { agentId, threadId });
     try {
       const res = await fetchWithAuth("/voice/sessions", {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ agentId })
+        body: JSON.stringify({
+          agentId,
+          ...threadId ? { threadId } : {}
+        })
       });
       if (!res.ok) {
         throw new Error(`Failed to start voice session: ${res.statusText}`);
@@ -1607,7 +1628,7 @@ function useVoice(options = {}) {
       }
       teardownAudio();
     }
-  }, [agentId, fetchWithAuth, handleMessage, teardownAudio, voiceLogger]);
+  }, [agentId, threadId, fetchWithAuth, handleMessage, teardownAudio, voiceLogger]);
   const mute = useCallback4((muted) => {
     setIsMuted(muted);
     streamRef.current?.getAudioTracks().forEach((track) => {
@@ -1867,7 +1888,7 @@ import {
   getLogLevel,
   isLevelEnabled
 } from "@personaai/logger";
-var VERSION = "0.7.0";
+var VERSION = "0.7.2";
 export {
   PersonaProvider,
   VERSION,