@personaai/react 0.7.3 → 0.7.5

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;
@@ -274,6 +284,13 @@ interface SendMessageOverride {
     threadId?: string | Promise<string | undefined>;
     /** Answers/approves a paused interrupt from a previous turn instead of starting a fresh one. */
     resume?: PersonaResumeValue;
+    /**
+     * Caller-supplied context (e.g. a live end-user profile snapshot) appended to this turn's
+     * system prompt only — never persisted, never visible to later turns. Capped at 4000
+     * characters server-side (rejected with a 400, not truncated). Mirrors
+     * `@personaai/sdk`'s `SendMessageOptions.contextOverride`.
+     */
+    contextOverride?: string;
 }
 /**
  * `useVoice`'s call state, driven by `voice_activity` events from the

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;
@@ -274,6 +284,13 @@ interface SendMessageOverride {
     threadId?: string | Promise<string | undefined>;
     /** Answers/approves a paused interrupt from a previous turn instead of starting a fresh one. */
     resume?: PersonaResumeValue;
+    /**
+     * Caller-supplied context (e.g. a live end-user profile snapshot) appended to this turn's
+     * system prompt only — never persisted, never visible to later turns. Capped at 4000
+     * characters server-side (rejected with a 400, not truncated). Mirrors
+     * `@personaai/sdk`'s `SendMessageOptions.contextOverride`.
+     */
+    contextOverride?: string;
 }
 /**
  * `useVoice`'s call state, driven by `voice_activity` events from the

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();
@@ -523,12 +595,14 @@ function useChat(options = {}) {
         agentId: targetAgentId,
         threadId: threadId ?? overrideOptions?.threadId,
         hasResume: !!overrideOptions?.resume,
+        hasContextOverride: !!overrideOptions?.contextOverride,
         messageCount: messages.length
       });
       chatLogger.trace("sendMessage details", {
         agentId: targetAgentId,
         promptPreview: prompt.slice(0, 200),
-        hasResume: !!overrideOptions?.resume
+        hasResume: !!overrideOptions?.resume,
+        hasContextOverride: !!overrideOptions?.contextOverride
       });
       const userMessage = {
         id: `user-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`,
@@ -583,7 +657,8 @@ function useChat(options = {}) {
             agentId: targetAgentId,
             messages: payloadMessages,
             threadId: resolvedThreadId,
-            resume: overrideOptions?.resume
+            resume: overrideOptions?.resume,
+            contextOverride: overrideOptions?.contextOverride
           }),
           signal: controller.signal
         });