@space3-npm/cybersoul-client 1.4.18 → 1.4.19

package/dist/client.js

@@ -774,6 +774,12 @@ Note: Always include "isEndTurn". If "imageParams", "voiceArgs", "triggerEvent",
                 parsedIntent.textResponse.trim().length > 0
                 ? parsedIntent.textResponse
                 : params.userMessage;
+            // Pre-compute the voice-dispatch decision so we can tell
+            // `onTextReady` consumers up front whether a voice bubble is on
+            // the way. Mirrors the `shouldGenerateVoice` gate used below
+            // when scheduling the TTS task — keep the two in sync.
+            const willGenerateVoice = types.includes(InteractRequestType.VOICE) &&
+                (!isAuto || !!parsedIntent.voiceArgs);
             // Fire text ready callback if provided
             if (params.onTextReady && (resolvedTextResponse || parsedIntent.actionText)) {
                 params.onTextReady(resolvedTextResponse, parsedIntent.actionText, {
@@ -782,6 +788,7 @@ Note: Always include "isEndTurn". If "imageParams", "voiceArgs", "triggerEvent",
                     isEndTurn: parsedIntent.isEndTurn,
                     triggerEvent: parsedIntent.triggerEvent,
                     likePreviousPicture: parsedIntent.likePreviousPicture,
+                    willGenerateVoice,
                 });
             }
             // 5. Build Final Media Calls parallel
@@ -868,8 +875,7 @@ Note: Always include "isEndTurn". If "imageParams", "voiceArgs", "triggerEvent",
                     captureMediaError("image", e);
                 }));
             }
-            const shouldGenerateVoice = types.includes(InteractRequestType.VOICE) &&
-                (!isAuto || !!parsedIntent.voiceArgs);
+            const shouldGenerateVoice = willGenerateVoice;
             if (shouldGenerateVoice) {
                 const normalizedVoiceArgs = parsedIntent.voiceArgs && typeof parsedIntent.voiceArgs === "object"
                     ? parsedIntent.voiceArgs

package/dist/types.d.ts

@@ -40,6 +40,17 @@ export interface InteractMetadata {
     isEndTurn?: boolean;
     triggerEvent?: DispatcherIntent["triggerEvent"];
     likePreviousPicture?: boolean;
+    /**
+     * True when the client has already decided to dispatch a voice
+     * generation task for this turn (i.e. `onMediaReady({modality:"voice"})`
+     * will fire later, barring TTS failure). UIs that render an early
+     * text bubble from `onTextReady` should suppress it when this is set —
+     * the text content is going to be replaced by the voice bubble anyway,
+     * so showing both (with a brief text-then-voice flicker, and a text
+     * push notification that gets superseded by a voice bubble) is
+     * confusing to the end user.
+     */
+    willGenerateVoice?: boolean;
 }
 /**
  * Server-authoritative snapshot returned by PATCH /characters/dynamic-context

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@space3-npm/cybersoul-client",
-  "version": "1.4.18",
+  "version": "1.4.19",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",