@streamoji/aitwin 0.6.3 → 0.6.5

package/dist/index.d.ts

@@ -49,7 +49,9 @@ export declare type AiTwinHandle = {
     /** Mute/unmute bot audio output (TTS + voice). */
     setMuted: (muted: boolean) => void;
     isMuted: () => boolean;
-    /** Persona / knowledge context id from getAiTwin (for /avatarReply). */
+    /** Brain id from getAiTwin (for /avatarReply and /ws/voice). */
+    getBrainId: () => string | null;
+    /** @deprecated Use `getBrainId`. */
     getPersonaId: () => string | null;
 };
 
@@ -153,7 +155,9 @@ export declare type AiTwinRecord = {
     voiceId?: string;
     /** Bearer JWT for TTS / voice WebSocket (same as `getAuthToken`). */
     authToken?: string;
-    /** When set, passed as `personaId` on voice WebSocket connect. */
+    /** Redis brain id. Passed as `brainId` on `/ws/voice` and `/avatarReply`. */
+    brainId?: string;
+    /** @deprecated Use `brainId`. */
     knowledgeContextId?: string;
     gender?: string;
     createdAt?: string;
@@ -228,9 +232,11 @@ export declare type AiTwinWidgetProps = {
      */
     float?: boolean;
     /**
-     * Persona / knowledge context id for /avatarReply (Text mode).
-     * When omitted, uses getAiTwin `knowledgeContextId` if available.
+     * Brain id for /avatarReply (Text mode).
+     * When omitted, uses getAiTwin `brainId` if available.
      */
+    brainId?: string;
+    /** @deprecated Use `brainId`. */
     personaId?: string;
     /**
      * Optional poster shown (blurred) on `<AiTwin>` while sil/atlas/idle assets load.
@@ -346,6 +352,8 @@ export declare type FetchAvatarReplyOptions = {
     message: string;
     authToken: string;
     apiBase?: string;
+    brainId?: string;
+    /** @deprecated Use `brainId`. */
     personaId?: string;
     history?: AvatarReplyMessage[];
     /** Called as soon as spokenText arrives on the SSE stream. */
@@ -506,6 +514,9 @@ export declare type RealtimeVoiceOptions = VoiceConnectOptions & {
 /** Resolve optional `avatarId` / `faceId` props (same R2 custom-faces hex id). */
 export declare function resolveDirectFaceId(avatarId?: string, faceId?: string): string | undefined;
 
+/** Canonical `brainId`, then legacy `knowledgeContextId`, then extra fallbacks. */
+export declare function resolveTwinBrainId(source?: TwinBrainFields | string | null, ...fallbacks: Array<string | null | undefined>): string | undefined;
+
 /** Pick the active viseme at playback offset (latest vtime wins on overlap). */
 export declare function resolveVisemeAtTime(queue: VisemeQueueItem[], elapsedMs: number): string;
 
@@ -830,6 +841,12 @@ export declare type TwinAssetUrls = {
     encrypted: boolean;
 };
 
+declare type TwinBrainFields = {
+    brainId?: string | null;
+    /** @deprecated Use `brainId`. Older getAiTwin responses still send this. */
+    knowledgeContextId?: string | null;
+};
+
 export declare const VISEME_IDS: readonly ["aa", "E", "I", "O", "U", "PP", "FF", "DD", "SS", "TH", "CH", "RR", "kk", "nn"];
 
 /** Minimum gap (ms) between consecutive vtimes to keep a skippable viseme. */
@@ -868,7 +885,9 @@ export declare type VoiceConnectOptions = {
      * Sent as `language` on `/ws/voice` and redirected `/avatar_ttsWithPoses` calls.
      */
     language?: TtsLanguage;
-    /** Persona / knowledge context id (from getAiTwin `knowledgeContextId`). */
+    /** Redis brain id (from getAiTwin `brainId`). Sent as `brainId` on `/ws/voice`. */
+    brainId?: string;
+    /** @deprecated Use `brainId`. */
     personaId?: string;
     speakingRate?: number;
     /** Default true — server streams TTS + avatar messages. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@streamoji/aitwin",
-  "version": "0.6.3",
+  "version": "0.6.5",
   "description": "Embeddable React AI twin face with TTS lipsync",
   "type": "module",
   "main": "./dist/aitwin.cjs",