@streamoji/aitwin 0.6.0 → 0.6.2

package/dist/index.d.ts

@@ -82,9 +82,12 @@ export declare type AiTwinProps = {
     authToken?: string;
     /** Avatar API base (TTS, session-value, voice). Default: package `DEFAULT_API_BASE`. */
     apiBase?: string;
-    /** TTS engine when using `assets` or `avatarId`/`faceId` (default: Cartesia). */
+    /** TTS engine when using `assets` or `avatarId`/`faceId` (default: Cartesia). Optional if `voiceId` is packed as `engine:voice`. */
     ttsEngineId?: TtsEngineId;
-    /** TTS voice id override (engine-specific). */
+    /**
+     * TTS voice id. May be a bare id (`eve`, Cartesia UUID) or packed
+     * `ttsEngineId:voiceId` (e.g. `visemetts:eve`).
+     */
     voiceId?: string;
     /** API speakingRate (default: 0.85). */
     speakingRate?: number;
@@ -410,6 +413,15 @@ export declare function normalizeStreamEmotion(raw: string | undefined | null, f
 /** Oculus viseme ids for Talking Lady stills and pair transitions (15 standard). */
 export declare const OCULUS_VISEME_IDS: readonly ["aa", "CH", "DD", "E", "FF", "I", "O", "PP", "RR", "SS", "TH", "U", "kk", "nn", "sil"];
 
+/**
+ * `voiceId` may be a bare id (`eve`) or packed `engine:voice` (`visemetts:eve`).
+ * Cartesia UUIDs have no colon, so they stay a plain voice id.
+ */
+export declare function parsePackedVoiceId(raw?: string): {
+    ttsEngineId?: TtsEngineId;
+    voiceId?: string;
+};
+
 export declare const PLAYBACK_SAMPLE_RATE = 16000;
 
 declare type RawVisemeTransition = {
@@ -510,6 +522,12 @@ export declare const SPEAKING_RATE_MAX = 1.5;
 
 export declare const SPEAKING_RATE_MIN = 0.5;
 
+/** Merge explicit `ttsEngineId` with a possibly packed `voiceId`. Packed engine wins only if engine is omitted. */
+export declare function splitVoiceIdSpec(ttsEngineId?: TtsEngineId, voiceId?: string): {
+    ttsEngineId?: TtsEngineId;
+    voiceId?: string;
+};
+
 export declare const TTS_ENGINE_CARTESIA = "eng_c9b1e6d4";
 
 /** Opaque TTS engine ids — must match backend TTS_ENGINE_MAP in main.py. */
@@ -517,7 +535,10 @@ export declare const TTS_ENGINE_GOOGLE = "eng_a7f2b9c1";
 
 export declare const TTS_ENGINE_INWORLD = "eng_d4e8f3a2";
 
-export declare type TtsEngineId = typeof TTS_ENGINE_GOOGLE | typeof TTS_ENGINE_INWORLD | typeof TTS_ENGINE_CARTESIA;
+/** streamoji-ai-avatar viseme TTS (`POST /avatar_ttsWithPoses`). */
+export declare const TTS_ENGINE_VISEMETTS = "visemetts";
+
+export declare type TtsEngineId = typeof TTS_ENGINE_GOOGLE | typeof TTS_ENGINE_INWORLD | typeof TTS_ENGINE_CARTESIA | typeof TTS_ENGINE_VISEMETTS;
 
 /** Runtime face bundle URLs (R2 custom-faces or local /twins/…). */
 export declare type TwinAssetUrls = {
@@ -538,6 +559,9 @@ export declare const VISEME_TEST_CARTESIA_VOICE_ID = "f786b574-daa5-4673-aa0c-cb
 
 export declare const VISEME_TEST_SPEAKING_RATE = 0.85;
 
+/** Default `voice_id` for visemetts (see streamoji-ai-avatar sample curl). */
+export declare const VISEME_TEST_VISEMETTS_VOICE_ID = "eve";
+
 /** Viseme-test page: fixed female voice + speech speed for /avatar_ttsWithPoses. */
 export declare const VISEME_TEST_VOICE_ID = "Olivia";
 
@@ -554,7 +578,9 @@ export declare interface VisemeQueueItem {
 export declare type VoiceConnectOptions = {
     /** Same JWT as SSE `Authorization: Bearer` (same as `authToken` prop on `<AiTwin>`). */
     authToken?: string;
-    /** Cartesia voice UUID override (optional). */
+    /** Pipecat `/ws/voice` TTS engine (`visemetts` or Cartesia id). Default Cartesia. */
+    ttsEngineId?: TtsEngineId;
+    /** Cartesia voice UUID, or visemetts name (e.g. `eve`). */
     voiceId?: string;
     /** Persona / knowledge context id (from getAiTwin `knowledgeContextId`). */
     personaId?: string;

package/package.json

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