@streamoji/aitwin 0.6.4 → 0.6.7

package/dist/index.d.ts

@@ -53,6 +53,8 @@ export declare type AiTwinHandle = {
     getBrainId: () => string | null;
     /** @deprecated Use `getBrainId`. */
     getPersonaId: () => string | null;
+    /** Client SSE brain URL from getAiTwin (for /ws/voice). */
+    getBrainUrl: () => string | null;
 };
 
 export declare class AiTwinNotFoundError extends Error {
@@ -159,6 +161,8 @@ export declare type AiTwinRecord = {
     brainId?: string;
     /** @deprecated Use `brainId`. */
     knowledgeContextId?: string;
+    /** Client SSE brain URL. Passed as `brainUrl` on `/ws/voice`. */
+    brainUrl?: string;
     gender?: string;
     createdAt?: string;
     updatedAt?: string;
@@ -232,12 +236,17 @@ export declare type AiTwinWidgetProps = {
      */
     float?: boolean;
     /**
-     * Brain id for /avatarReply (Text mode).
+     * Brain id for /avatarReply (Text mode) and `/ws/voice`.
      * When omitted, uses getAiTwin `brainId` if available.
      */
     brainId?: string;
     /** @deprecated Use `brainId`. */
     personaId?: string;
+    /**
+     * Client SSE brain URL for `/ws/voice`.
+     * When omitted, uses getAiTwin `brainUrl` if available.
+     */
+    brainUrl?: string;
     /**
      * Optional poster shown (blurred) on `<AiTwin>` while sil/atlas/idle assets load.
      * When omitted, AiTwin derives it from `faceId`/`avatarId`.
@@ -454,6 +463,12 @@ export declare function parsePackedVoiceId(raw?: string): {
     voiceId?: string;
 };
 
+/**
+ * Validate a client SSE brain URL. Empty/whitespace is unset.
+ * Must be http(s) with a host and no fragment — same rules as `/ws/voice`.
+ */
+export declare function parseTwinBrainUrl(value?: string | null): string | undefined;
+
 export declare const PLAYBACK_SAMPLE_RATE = 16000;
 
 declare type RawVisemeTransition = {
@@ -517,6 +532,8 @@ export declare function resolveDirectFaceId(avatarId?: string, faceId?: string):
 /** Canonical `brainId`, then legacy `knowledgeContextId`, then extra fallbacks. */
 export declare function resolveTwinBrainId(source?: TwinBrainFields | string | null, ...fallbacks: Array<string | null | undefined>): string | undefined;
 
+export declare function resolveTwinBrainUrl(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;
 
@@ -845,6 +862,8 @@ declare type TwinBrainFields = {
     brainId?: string | null;
     /** @deprecated Use `brainId`. Older getAiTwin responses still send this. */
     knowledgeContextId?: string | null;
+    /** Client SSE brain URL. When set, `/ws/voice` skips hosted brainId / Grok / OpenAI. */
+    brainUrl?: string | null;
 };
 
 export declare const VISEME_IDS: readonly ["aa", "E", "I", "O", "U", "PP", "FF", "DD", "SS", "TH", "CH", "RR", "kk", "nn"];
@@ -889,6 +908,11 @@ export declare type VoiceConnectOptions = {
     brainId?: string;
     /** @deprecated Use `brainId`. */
     personaId?: string;
+    /**
+     * Client SSE brain URL. When set, `/ws/voice` skips hosted brainId / Grok / OpenAI
+     * and GETs this URL with socket query params plus `text=<user turn>`.
+     */
+    brainUrl?: string;
     speakingRate?: number;
     /** Default true — server streams TTS + avatar messages. */
     ttsStream?: boolean;

package/package.json

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