@personaai/react 0.7.4 → 0.7.6

package/dist/index.d.cts

@@ -284,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
@@ -318,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

@@ -284,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
@@ -318,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

@@ -595,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)}`,
@@ -655,7 +657,8 @@ function useChat(options = {}) {
             agentId: targetAgentId,
             messages: payloadMessages,
             threadId: resolvedThreadId,
-            resume: overrideOptions?.resume
+            resume: overrideOptions?.resume,
+            contextOverride: overrideOptions?.contextOverride
           }),
           signal: controller.signal
         });
@@ -1389,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(
@@ -1658,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) {
@@ -1701,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) => {