@personaai/react 0.7.5 → 0.7.6

package/dist/index.d.cts

@@ -325,6 +325,16 @@ interface UseVoiceOptions {
      * leave undefined) to start a fresh conversation.
      */
     threadId?: string;
+    /**
+     * Caller-supplied context appended to the Agent's system instruction for
+     * this call — same field/cap/contract as `useChat`'s `sendMessage(text, {
+     * contextOverride })`. Unlike text chat, this is a **one-time append at
+     * connect**, not re-applied per turn: Gemini Live's system instruction is
+     * fixed for the whole call, so changing it means ending this call and
+     * starting a new `start()`. Capped at 4000 characters server-side
+     * (rejected with a 400, not truncated).
+     */
+    contextOverride?: string;
 }
 interface UseVoiceResult {
     state: PersonaVoiceState;

package/dist/index.d.ts

@@ -325,6 +325,16 @@ interface UseVoiceOptions {
      * leave undefined) to start a fresh conversation.
      */
     threadId?: string;
+    /**
+     * Caller-supplied context appended to the Agent's system instruction for
+     * this call — same field/cap/contract as `useChat`'s `sendMessage(text, {
+     * contextOverride })`. Unlike text chat, this is a **one-time append at
+     * connect**, not re-applied per turn: Gemini Live's system instruction is
+     * fixed for the whole call, so changing it means ending this call and
+     * starting a new `start()`. Capped at 4000 characters server-side
+     * (rejected with a 400, not truncated).
+     */
+    contextOverride?: string;
 }
 interface UseVoiceResult {
     state: PersonaVoiceState;

package/dist/index.js

@@ -1392,6 +1392,7 @@ function useVoice(options = {}) {
   const voiceLogger = useMemo3(() => logger.child("voice"), [logger]);
   const agentId = options.agentId || defaultAgentId;
   const threadId = options.threadId;
+  const contextOverride = options.contextOverride;
   const [state, setState] = useState4("idle");
   const [isMuted, setIsMuted] = useState4(false);
   const [transcript, setTranscript] = useState4(
@@ -1661,14 +1662,19 @@ function useVoice(options = {}) {
     setToolCalls([]);
     acceptedTurnSeqRef.current = 0;
     setState("connecting");
-    voiceLogger.debug("start() called", { agentId, threadId });
+    voiceLogger.debug("start() called", {
+      agentId,
+      threadId,
+      hasContextOverride: !!contextOverride
+    });
     try {
       const res = await fetchWithAuth("/voice/sessions", {
         method: "POST",
         headers: { "Content-Type": "application/json" },
         body: JSON.stringify({
           agentId,
-          ...threadId ? { threadId } : {}
+          ...threadId ? { threadId } : {},
+          ...contextOverride ? { contextOverride } : {}
         })
       });
       if (!res.ok) {
@@ -1704,7 +1710,7 @@ function useVoice(options = {}) {
       }
       teardownAudio();
     }
-  }, [agentId, threadId, fetchWithAuth, handleMessage, teardownAudio, voiceLogger]);
+  }, [agentId, threadId, contextOverride, fetchWithAuth, handleMessage, teardownAudio, voiceLogger]);
   const mute = useCallback4((muted) => {
     setIsMuted(muted);
     streamRef.current?.getAudioTracks().forEach((track) => {