@livekit/agents 1.1.0 → 1.2.1

package/dist/inference/tts.test.cjs

@@ -0,0 +1,305 @@
+"use strict";
+var import_vitest = require("vitest");
+var import_language = require("../language.cjs");
+var import_log = require("../log.cjs");
+var import_types = require("../types.cjs");
+var import_tts = require("./tts.cjs");
+(0, import_vitest.beforeAll)(() => {
+  (0, import_log.initializeLogger)({ level: "silent", pretty: false });
+});
+function makeTts(overrides = {}) {
+  const defaults = {
+    model: "cartesia/sonic",
+    apiKey: "test-key",
+    apiSecret: "test-secret",
+    baseURL: "https://example.livekit.cloud"
+  };
+  return new import_tts.TTS({ ...defaults, ...overrides });
+}
+(0, import_vitest.describe)("parseTTSModelString", () => {
+  (0, import_vitest.it)("simple model without voice", () => {
+    const [model, voice] = (0, import_tts.parseTTSModelString)("cartesia");
+    (0, import_vitest.expect)(model).toBe("cartesia");
+    (0, import_vitest.expect)(voice).toBeUndefined();
+  });
+  (0, import_vitest.it)("model with voice suffix", () => {
+    const [model, voice] = (0, import_tts.parseTTSModelString)("cartesia:my-voice-id");
+    (0, import_vitest.expect)(model).toBe("cartesia");
+    (0, import_vitest.expect)(voice).toBe("my-voice-id");
+  });
+  (0, import_vitest.it)("provider/model format without voice", () => {
+    const [model, voice] = (0, import_tts.parseTTSModelString)("cartesia/sonic");
+    (0, import_vitest.expect)(model).toBe("cartesia/sonic");
+    (0, import_vitest.expect)(voice).toBeUndefined();
+  });
+  (0, import_vitest.it)("provider/model format with voice", () => {
+    const [model, voice] = (0, import_tts.parseTTSModelString)("cartesia/sonic:my-voice-id");
+    (0, import_vitest.expect)(model).toBe("cartesia/sonic");
+    (0, import_vitest.expect)(voice).toBe("my-voice-id");
+  });
+  import_vitest.it.each([
+    ["elevenlabs/eleven_flash_v2:voice123", "elevenlabs/eleven_flash_v2", "voice123"],
+    ["rime:speaker-a", "rime", "speaker-a"],
+    ["rime/mist:narrator", "rime/mist", "narrator"],
+    ["inworld/inworld-tts-1:character", "inworld/inworld-tts-1", "character"],
+    ["cartesia/sonic-turbo:deep-voice", "cartesia/sonic-turbo", "deep-voice"]
+  ])("various providers and voices: %s", (modelStr, expectedModel, expectedVoice) => {
+    const [model, voice] = (0, import_tts.parseTTSModelString)(modelStr);
+    (0, import_vitest.expect)(model).toBe(expectedModel);
+    (0, import_vitest.expect)(voice).toBe(expectedVoice);
+  });
+  (0, import_vitest.it)("empty voice after colon", () => {
+    const [model, voice] = (0, import_tts.parseTTSModelString)("cartesia/sonic:");
+    (0, import_vitest.expect)(model).toBe("cartesia/sonic");
+    (0, import_vitest.expect)(voice).toBe("");
+  });
+});
+(0, import_vitest.describe)("normalizeTTSFallback", () => {
+  (0, import_vitest.it)("single string model", () => {
+    const result = (0, import_tts.normalizeTTSFallback)("cartesia/sonic");
+    (0, import_vitest.expect)(result).toEqual([{ model: "cartesia/sonic", voice: "" }]);
+  });
+  (0, import_vitest.it)("single string model with voice", () => {
+    const result = (0, import_tts.normalizeTTSFallback)("cartesia/sonic:my-voice");
+    (0, import_vitest.expect)(result).toEqual([{ model: "cartesia/sonic", voice: "my-voice" }]);
+  });
+  (0, import_vitest.it)("single FallbackModel dict", () => {
+    const fallback = { model: "cartesia/sonic", voice: "narrator" };
+    const result = (0, import_tts.normalizeTTSFallback)(fallback);
+    (0, import_vitest.expect)(result).toEqual([{ model: "cartesia/sonic", voice: "narrator" }]);
+  });
+  (0, import_vitest.it)("list of string models", () => {
+    const result = (0, import_tts.normalizeTTSFallback)(["cartesia/sonic", "elevenlabs/eleven_flash_v2"]);
+    (0, import_vitest.expect)(result).toEqual([
+      { model: "cartesia/sonic", voice: "" },
+      { model: "elevenlabs/eleven_flash_v2", voice: "" }
+    ]);
+  });
+  (0, import_vitest.it)("list of string models with voices", () => {
+    const result = (0, import_tts.normalizeTTSFallback)(["cartesia/sonic:voice1", "elevenlabs:voice2"]);
+    (0, import_vitest.expect)(result).toEqual([
+      { model: "cartesia/sonic", voice: "voice1" },
+      { model: "elevenlabs", voice: "voice2" }
+    ]);
+  });
+  (0, import_vitest.it)("list of FallbackModel dicts", () => {
+    const fallbacks = [
+      { model: "cartesia/sonic", voice: "narrator" },
+      { model: "elevenlabs", voice: "" }
+    ];
+    const result = (0, import_tts.normalizeTTSFallback)(fallbacks);
+    (0, import_vitest.expect)(result).toEqual([
+      { model: "cartesia/sonic", voice: "narrator" },
+      { model: "elevenlabs", voice: "" }
+    ]);
+  });
+  (0, import_vitest.it)("mixed list of strings and dicts", () => {
+    const result = (0, import_tts.normalizeTTSFallback)([
+      "cartesia/sonic:voice1",
+      { model: "elevenlabs/eleven_flash_v2", voice: "custom" },
+      "rime/mist"
+    ]);
+    (0, import_vitest.expect)(result).toEqual([
+      { model: "cartesia/sonic", voice: "voice1" },
+      { model: "elevenlabs/eleven_flash_v2", voice: "custom" },
+      { model: "rime/mist", voice: "" }
+    ]);
+  });
+  (0, import_vitest.it)("FallbackModel with extraKwargs is preserved", () => {
+    const fallback = {
+      model: "cartesia/sonic",
+      voice: "narrator",
+      extraKwargs: { duration: 30, speed: "fast" }
+    };
+    const result = (0, import_tts.normalizeTTSFallback)(fallback);
+    (0, import_vitest.expect)(result).toEqual([
+      {
+        model: "cartesia/sonic",
+        voice: "narrator",
+        extraKwargs: { duration: 30, speed: "fast" }
+      }
+    ]);
+  });
+  (0, import_vitest.it)("list with extraKwargs preserved", () => {
+    const result = (0, import_tts.normalizeTTSFallback)([
+      { model: "cartesia/sonic", voice: "v1", extraKwargs: { speed: "slow" } },
+      "elevenlabs:voice2",
+      { model: "rime/mist", voice: "", extraKwargs: { custom: true } }
+    ]);
+    (0, import_vitest.expect)(result).toEqual([
+      { model: "cartesia/sonic", voice: "v1", extraKwargs: { speed: "slow" } },
+      { model: "elevenlabs", voice: "voice2" },
+      { model: "rime/mist", voice: "", extraKwargs: { custom: true } }
+    ]);
+  });
+  (0, import_vitest.it)("empty list returns empty list", () => {
+    const result = (0, import_tts.normalizeTTSFallback)([]);
+    (0, import_vitest.expect)(result).toEqual([]);
+  });
+  (0, import_vitest.it)("FallbackModel with empty voice", () => {
+    const fallback = { model: "cartesia/sonic", voice: "" };
+    const result = (0, import_tts.normalizeTTSFallback)(fallback);
+    (0, import_vitest.expect)(result).toEqual([{ model: "cartesia/sonic", voice: "" }]);
+  });
+});
+(0, import_vitest.describe)("TTS constructor fallback and connOptions", () => {
+  (0, import_vitest.it)("normalizes language in constructor", () => {
+    const tts = makeTts({ language: "english" });
+    (0, import_vitest.expect)(tts["opts"].language).toBe("en");
+  });
+  (0, import_vitest.it)("normalizes updated language values", () => {
+    const tts = makeTts();
+    tts.updateOptions({ language: "en_US" });
+    (0, import_vitest.expect)(tts["opts"].language).toBe((0, import_language.normalizeLanguage)("en_US"));
+  });
+  (0, import_vitest.it)("fallback not given defaults to undefined", () => {
+    const tts = makeTts();
+    (0, import_vitest.expect)(tts["opts"].fallback).toBeUndefined();
+  });
+  (0, import_vitest.it)("fallback single string is normalized", () => {
+    const tts = makeTts({ fallback: "elevenlabs/eleven_flash_v2" });
+    (0, import_vitest.expect)(tts["opts"].fallback).toEqual([{ model: "elevenlabs/eleven_flash_v2", voice: "" }]);
+  });
+  (0, import_vitest.it)("fallback single string with voice is normalized", () => {
+    const tts = makeTts({ fallback: "cartesia/sonic:my-voice" });
+    (0, import_vitest.expect)(tts["opts"].fallback).toEqual([{ model: "cartesia/sonic", voice: "my-voice" }]);
+  });
+  (0, import_vitest.it)("fallback list of strings is normalized", () => {
+    const tts = makeTts({ fallback: ["cartesia/sonic", "elevenlabs"] });
+    (0, import_vitest.expect)(tts["opts"].fallback).toEqual([
+      { model: "cartesia/sonic", voice: "" },
+      { model: "elevenlabs", voice: "" }
+    ]);
+  });
+  (0, import_vitest.it)("fallback single FallbackModel is normalized to list", () => {
+    const tts = makeTts({ fallback: { model: "cartesia/sonic", voice: "narrator" } });
+    (0, import_vitest.expect)(tts["opts"].fallback).toEqual([{ model: "cartesia/sonic", voice: "narrator" }]);
+  });
+  (0, import_vitest.it)("fallback with extraKwargs is preserved", () => {
+    const tts = makeTts({
+      fallback: {
+        model: "cartesia/sonic",
+        voice: "narrator",
+        extraKwargs: { duration: 30, speed: "fast" }
+      }
+    });
+    (0, import_vitest.expect)(tts["opts"].fallback).toEqual([
+      {
+        model: "cartesia/sonic",
+        voice: "narrator",
+        extraKwargs: { duration: 30, speed: "fast" }
+      }
+    ]);
+  });
+  (0, import_vitest.it)("fallback mixed list is normalized", () => {
+    const tts = makeTts({
+      fallback: [
+        "cartesia/sonic:voice1",
+        { model: "elevenlabs", voice: "custom", extraKwargs: { speed: "slow" } },
+        "rime/mist"
+      ]
+    });
+    (0, import_vitest.expect)(tts["opts"].fallback).toEqual([
+      { model: "cartesia/sonic", voice: "voice1" },
+      { model: "elevenlabs", voice: "custom", extraKwargs: { speed: "slow" } },
+      { model: "rime/mist", voice: "" }
+    ]);
+  });
+  (0, import_vitest.it)("connOptions not given uses default", () => {
+    const tts = makeTts();
+    (0, import_vitest.expect)(tts["opts"].connOptions).toEqual(import_types.DEFAULT_API_CONNECT_OPTIONS);
+  });
+  (0, import_vitest.it)("connOptions custom timeout", () => {
+    const custom = { timeoutMs: 3e4, maxRetry: 3, retryIntervalMs: 2e3 };
+    const tts = makeTts({ connOptions: custom });
+    (0, import_vitest.expect)(tts["opts"].connOptions).toEqual(custom);
+    (0, import_vitest.expect)(tts["opts"].connOptions.timeoutMs).toBe(3e4);
+  });
+  (0, import_vitest.it)("connOptions custom maxRetry", () => {
+    const custom = { timeoutMs: 1e4, maxRetry: 5, retryIntervalMs: 2e3 };
+    const tts = makeTts({ connOptions: custom });
+    (0, import_vitest.expect)(tts["opts"].connOptions).toEqual(custom);
+    (0, import_vitest.expect)(tts["opts"].connOptions.maxRetry).toBe(5);
+  });
+  (0, import_vitest.it)("connOptions full custom", () => {
+    const custom = { timeoutMs: 6e4, maxRetry: 10, retryIntervalMs: 2e3 };
+    const tts = makeTts({ connOptions: custom });
+    (0, import_vitest.expect)(tts["opts"].connOptions).toEqual(custom);
+    (0, import_vitest.expect)(tts["opts"].connOptions.timeoutMs).toBe(6e4);
+    (0, import_vitest.expect)(tts["opts"].connOptions.maxRetry).toBe(10);
+    (0, import_vitest.expect)(tts["opts"].connOptions.retryIntervalMs).toBe(2e3);
+  });
+});
+(0, import_vitest.describe)("TTS provider modelOptions parity", () => {
+  (0, import_vitest.it)("preserves ElevenLabs inference model options", () => {
+    const modelOptions = {
+      speed: 1.2,
+      stability: 0.5,
+      similarity_boost: 0.8,
+      enable_logging: false
+    };
+    const tts = new import_tts.TTS({
+      model: "elevenlabs/eleven_flash_v2_5",
+      apiKey: "test-key",
+      apiSecret: "test-secret",
+      baseURL: "https://example.livekit.cloud",
+      modelOptions
+    });
+    (0, import_vitest.expect)(tts["opts"].modelOptions).toEqual(modelOptions);
+  });
+  (0, import_vitest.it)("accepts expanded Cartesia inference model options", () => {
+    const modelOptions = {
+      speed: 1.15,
+      emotion: "curious",
+      add_timestamps: true
+    };
+    const tts = new import_tts.TTS({
+      model: "cartesia/sonic",
+      apiKey: "test-key",
+      apiSecret: "test-secret",
+      baseURL: "https://example.livekit.cloud",
+      modelOptions
+    });
+    (0, import_vitest.expect)(tts["opts"].modelOptions).toEqual(modelOptions);
+  });
+  (0, import_vitest.it)("accepts Deepgram inference model options", () => {
+    const modelOptions = { mip_opt_out: true };
+    const tts = new import_tts.TTS({
+      model: "deepgram/aura-2",
+      apiKey: "test-key",
+      apiSecret: "test-secret",
+      baseURL: "https://example.livekit.cloud",
+      modelOptions
+    });
+    (0, import_vitest.expect)(tts["opts"].modelOptions).toEqual(modelOptions);
+  });
+  (0, import_vitest.it)("accepts Rime inference model options", () => {
+    const modelOptions = {
+      speed_alpha: 0.9,
+      pause_between_brackets: true
+    };
+    const tts = new import_tts.TTS({
+      model: "rime/mistv2",
+      apiKey: "test-key",
+      apiSecret: "test-secret",
+      baseURL: "https://example.livekit.cloud",
+      modelOptions
+    });
+    (0, import_vitest.expect)(tts["opts"].modelOptions).toEqual(modelOptions);
+  });
+  (0, import_vitest.it)("accepts Inworld inference model options", () => {
+    const modelOptions = {
+      timestamp_type: "WORD",
+      apply_text_normalization: "ON"
+    };
+    const tts = new import_tts.TTS({
+      model: "inworld/inworld-tts-1",
+      apiKey: "test-key",
+      apiSecret: "test-secret",
+      baseURL: "https://example.livekit.cloud",
+      modelOptions
+    });
+    (0, import_vitest.expect)(tts["opts"].modelOptions).toEqual(modelOptions);
+  });
+});
+//# sourceMappingURL=tts.test.cjs.map

package/dist/inference/tts.test.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/inference/tts.test.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { beforeAll, describe, expect, it } from 'vitest';\nimport { normalizeLanguage } from '../language.js';\nimport { initializeLogger } from '../log.js';\nimport { type APIConnectOptions, DEFAULT_API_CONNECT_OPTIONS } from '../types.js';\nimport { TTS, type TTSFallbackModel, normalizeTTSFallback, parseTTSModelString } from './tts.js';\n\nbeforeAll(() => {\n  initializeLogger({ level: 'silent', pretty: false });\n});\n\n/** Helper to create TTS with required credentials. */\nfunction makeTts(overrides: Record<string, unknown> = {}) {\n  const defaults = {\n    model: 'cartesia/sonic' as const,\n    apiKey: 'test-key',\n    apiSecret: 'test-secret',\n    baseURL: 'https://example.livekit.cloud',\n  };\n  return new TTS({ ...defaults, ...overrides });\n}\n\ndescribe('parseTTSModelString', () => {\n  it('simple model without voice', () => {\n    const [model, voice] = parseTTSModelString('cartesia');\n    expect(model).toBe('cartesia');\n    expect(voice).toBeUndefined();\n  });\n\n  it('model with voice suffix', () => {\n    const [model, voice] = parseTTSModelString('cartesia:my-voice-id');\n    expect(model).toBe('cartesia');\n    expect(voice).toBe('my-voice-id');\n  });\n\n  it('provider/model format without voice', () => {\n    const [model, voice] = parseTTSModelString('cartesia/sonic');\n    expect(model).toBe('cartesia/sonic');\n    expect(voice).toBeUndefined();\n  });\n\n  it('provider/model format with voice', () => {\n    const [model, voice] = parseTTSModelString('cartesia/sonic:my-voice-id');\n    expect(model).toBe('cartesia/sonic');\n    expect(voice).toBe('my-voice-id');\n  });\n\n  it.each([\n    ['elevenlabs/eleven_flash_v2:voice123', 'elevenlabs/eleven_flash_v2', 'voice123'],\n    ['rime:speaker-a', 'rime', 'speaker-a'],\n    ['rime/mist:narrator', 'rime/mist', 'narrator'],\n    ['inworld/inworld-tts-1:character', 'inworld/inworld-tts-1', 'character'],\n    ['cartesia/sonic-turbo:deep-voice', 'cartesia/sonic-turbo', 'deep-voice'],\n  ])('various providers and voices: %s', (modelStr, expectedModel, expectedVoice) => {\n    const [model, voice] = parseTTSModelString(modelStr);\n    expect(model).toBe(expectedModel);\n    expect(voice).toBe(expectedVoice);\n  });\n\n  it('empty voice after colon', () => {\n    const [model, voice] = parseTTSModelString('cartesia/sonic:');\n    expect(model).toBe('cartesia/sonic');\n    expect(voice).toBe('');\n  });\n});\n\ndescribe('normalizeTTSFallback', () => {\n  it('single string model', () => {\n    const result = normalizeTTSFallback('cartesia/sonic');\n    expect(result).toEqual([{ model: 'cartesia/sonic', voice: '' }]);\n  });\n\n  it('single string model with voice', () => {\n    const result = normalizeTTSFallback('cartesia/sonic:my-voice');\n    expect(result).toEqual([{ model: 'cartesia/sonic', voice: 'my-voice' }]);\n  });\n\n  it('single FallbackModel dict', () => {\n    const fallback: TTSFallbackModel = { model: 'cartesia/sonic', voice: 'narrator' };\n    const result = normalizeTTSFallback(fallback);\n    expect(result).toEqual([{ model: 'cartesia/sonic', voice: 'narrator' }]);\n  });\n\n  it('list of string models', () => {\n    const result = normalizeTTSFallback(['cartesia/sonic', 'elevenlabs/eleven_flash_v2']);\n    expect(result).toEqual([\n      { model: 'cartesia/sonic', voice: '' },\n      { model: 'elevenlabs/eleven_flash_v2', voice: '' },\n    ]);\n  });\n\n  it('list of string models with voices', () => {\n    const result = normalizeTTSFallback(['cartesia/sonic:voice1', 'elevenlabs:voice2']);\n    expect(result).toEqual([\n      { model: 'cartesia/sonic', voice: 'voice1' },\n      { model: 'elevenlabs', voice: 'voice2' },\n    ]);\n  });\n\n  it('list of FallbackModel dicts', () => {\n    const fallbacks: TTSFallbackModel[] = [\n      { model: 'cartesia/sonic', voice: 'narrator' },\n      { model: 'elevenlabs', voice: '' },\n    ];\n    const result = normalizeTTSFallback(fallbacks);\n    expect(result).toEqual([\n      { model: 'cartesia/sonic', voice: 'narrator' },\n      { model: 'elevenlabs', voice: '' },\n    ]);\n  });\n\n  it('mixed list of strings and dicts', () => {\n    const result = normalizeTTSFallback([\n      'cartesia/sonic:voice1',\n      { model: 'elevenlabs/eleven_flash_v2', voice: 'custom' } as TTSFallbackModel,\n      'rime/mist',\n    ]);\n    expect(result).toEqual([\n      { model: 'cartesia/sonic', voice: 'voice1' },\n      { model: 'elevenlabs/eleven_flash_v2', voice: 'custom' },\n      { model: 'rime/mist', voice: '' },\n    ]);\n  });\n\n  it('FallbackModel with extraKwargs is preserved', () => {\n    const fallback: TTSFallbackModel = {\n      model: 'cartesia/sonic',\n      voice: 'narrator',\n      extraKwargs: { duration: 30.0, speed: 'fast' },\n    };\n    const result = normalizeTTSFallback(fallback);\n    expect(result).toEqual([\n      {\n        model: 'cartesia/sonic',\n        voice: 'narrator',\n        extraKwargs: { duration: 30.0, speed: 'fast' },\n      },\n    ]);\n  });\n\n  it('list with extraKwargs preserved', () => {\n    const result = normalizeTTSFallback([\n      { model: 'cartesia/sonic', voice: 'v1', extraKwargs: { speed: 'slow' } } as TTSFallbackModel,\n      'elevenlabs:voice2',\n      { model: 'rime/mist', voice: '', extraKwargs: { custom: true } } as TTSFallbackModel,\n    ]);\n    expect(result).toEqual([\n      { model: 'cartesia/sonic', voice: 'v1', extraKwargs: { speed: 'slow' } },\n      { model: 'elevenlabs', voice: 'voice2' },\n      { model: 'rime/mist', voice: '', extraKwargs: { custom: true } },\n    ]);\n  });\n\n  it('empty list returns empty list', () => {\n    const result = normalizeTTSFallback([]);\n    expect(result).toEqual([]);\n  });\n\n  it('FallbackModel with empty voice', () => {\n    const fallback: TTSFallbackModel = { model: 'cartesia/sonic', voice: '' };\n    const result = normalizeTTSFallback(fallback);\n    expect(result).toEqual([{ model: 'cartesia/sonic', voice: '' }]);\n  });\n});\n\ndescribe('TTS constructor fallback and connOptions', () => {\n  it('normalizes language in constructor', () => {\n    const tts = makeTts({ language: 'english' });\n    expect(tts['opts'].language).toBe('en');\n  });\n\n  it('normalizes updated language values', () => {\n    const tts = makeTts();\n    tts.updateOptions({ language: 'en_US' });\n    expect(tts['opts'].language).toBe(normalizeLanguage('en_US'));\n  });\n\n  it('fallback not given defaults to undefined', () => {\n    const tts = makeTts();\n    expect(tts['opts'].fallback).toBeUndefined();\n  });\n\n  it('fallback single string is normalized', () => {\n    const tts = makeTts({ fallback: 'elevenlabs/eleven_flash_v2' });\n    expect(tts['opts'].fallback).toEqual([{ model: 'elevenlabs/eleven_flash_v2', voice: '' }]);\n  });\n\n  it('fallback single string with voice is normalized', () => {\n    const tts = makeTts({ fallback: 'cartesia/sonic:my-voice' });\n    expect(tts['opts'].fallback).toEqual([{ model: 'cartesia/sonic', voice: 'my-voice' }]);\n  });\n\n  it('fallback list of strings is normalized', () => {\n    const tts = makeTts({ fallback: ['cartesia/sonic', 'elevenlabs'] });\n    expect(tts['opts'].fallback).toEqual([\n      { model: 'cartesia/sonic', voice: '' },\n      { model: 'elevenlabs', voice: '' },\n    ]);\n  });\n\n  it('fallback single FallbackModel is normalized to list', () => {\n    const tts = makeTts({ fallback: { model: 'cartesia/sonic', voice: 'narrator' } });\n    expect(tts['opts'].fallback).toEqual([{ model: 'cartesia/sonic', voice: 'narrator' }]);\n  });\n\n  it('fallback with extraKwargs is preserved', () => {\n    const tts = makeTts({\n      fallback: {\n        model: 'cartesia/sonic',\n        voice: 'narrator',\n        extraKwargs: { duration: 30.0, speed: 'fast' },\n      },\n    });\n    expect(tts['opts'].fallback).toEqual([\n      {\n        model: 'cartesia/sonic',\n        voice: 'narrator',\n        extraKwargs: { duration: 30.0, speed: 'fast' },\n      },\n    ]);\n  });\n\n  it('fallback mixed list is normalized', () => {\n    const tts = makeTts({\n      fallback: [\n        'cartesia/sonic:voice1',\n        { model: 'elevenlabs', voice: 'custom', extraKwargs: { speed: 'slow' } },\n        'rime/mist',\n      ],\n    });\n    expect(tts['opts'].fallback).toEqual([\n      { model: 'cartesia/sonic', voice: 'voice1' },\n      { model: 'elevenlabs', voice: 'custom', extraKwargs: { speed: 'slow' } },\n      { model: 'rime/mist', voice: '' },\n    ]);\n  });\n\n  it('connOptions not given uses default', () => {\n    const tts = makeTts();\n    expect(tts['opts'].connOptions).toEqual(DEFAULT_API_CONNECT_OPTIONS);\n  });\n\n  it('connOptions custom timeout', () => {\n    const custom: APIConnectOptions = { timeoutMs: 30000, maxRetry: 3, retryIntervalMs: 2000 };\n    const tts = makeTts({ connOptions: custom });\n    expect(tts['opts'].connOptions).toEqual(custom);\n    expect(tts['opts'].connOptions!.timeoutMs).toBe(30000);\n  });\n\n  it('connOptions custom maxRetry', () => {\n    const custom: APIConnectOptions = { timeoutMs: 10000, maxRetry: 5, retryIntervalMs: 2000 };\n    const tts = makeTts({ connOptions: custom });\n    expect(tts['opts'].connOptions).toEqual(custom);\n    expect(tts['opts'].connOptions!.maxRetry).toBe(5);\n  });\n\n  it('connOptions full custom', () => {\n    const custom: APIConnectOptions = { timeoutMs: 60000, maxRetry: 10, retryIntervalMs: 2000 };\n    const tts = makeTts({ connOptions: custom });\n    expect(tts['opts'].connOptions).toEqual(custom);\n    expect(tts['opts'].connOptions!.timeoutMs).toBe(60000);\n    expect(tts['opts'].connOptions!.maxRetry).toBe(10);\n    expect(tts['opts'].connOptions!.retryIntervalMs).toBe(2000);\n  });\n});\n\ndescribe('TTS provider modelOptions parity', () => {\n  it('preserves ElevenLabs inference model options', () => {\n    const modelOptions = {\n      speed: 1.2,\n      stability: 0.5,\n      similarity_boost: 0.8,\n      enable_logging: false,\n    };\n\n    const tts = new TTS({\n      model: 'elevenlabs/eleven_flash_v2_5' as const,\n      apiKey: 'test-key',\n      apiSecret: 'test-secret',\n      baseURL: 'https://example.livekit.cloud',\n      modelOptions,\n    });\n\n    expect(tts['opts'].modelOptions).toEqual(modelOptions);\n  });\n\n  it('accepts expanded Cartesia inference model options', () => {\n    const modelOptions = {\n      speed: 1.15,\n      emotion: 'curious',\n      add_timestamps: true,\n    };\n\n    const tts = new TTS({\n      model: 'cartesia/sonic' as const,\n      apiKey: 'test-key',\n      apiSecret: 'test-secret',\n      baseURL: 'https://example.livekit.cloud',\n      modelOptions,\n    });\n\n    expect(tts['opts'].modelOptions).toEqual(modelOptions);\n  });\n\n  it('accepts Deepgram inference model options', () => {\n    const modelOptions = { mip_opt_out: true };\n\n    const tts = new TTS({\n      model: 'deepgram/aura-2' as const,\n      apiKey: 'test-key',\n      apiSecret: 'test-secret',\n      baseURL: 'https://example.livekit.cloud',\n      modelOptions,\n    });\n\n    expect(tts['opts'].modelOptions).toEqual(modelOptions);\n  });\n\n  it('accepts Rime inference model options', () => {\n    const modelOptions = {\n      speed_alpha: 0.9,\n      pause_between_brackets: true,\n    };\n\n    const tts = new TTS({\n      model: 'rime/mistv2' as const,\n      apiKey: 'test-key',\n      apiSecret: 'test-secret',\n      baseURL: 'https://example.livekit.cloud',\n      modelOptions,\n    });\n\n    expect(tts['opts'].modelOptions).toEqual(modelOptions);\n  });\n\n  it('accepts Inworld inference model options', () => {\n    const modelOptions = {\n      timestamp_type: 'WORD' as const,\n      apply_text_normalization: 'ON' as const,\n    };\n\n    const tts = new TTS({\n      model: 'inworld/inworld-tts-1' as const,\n      apiKey: 'test-key',\n      apiSecret: 'test-secret',\n      baseURL: 'https://example.livekit.cloud',\n      modelOptions,\n    });\n\n    expect(tts['opts'].modelOptions).toEqual(modelOptions);\n  });\n});\n"],"mappings":"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","names":[]}

package/dist/inference/tts.test.js

@@ -0,0 +1,304 @@
+import { beforeAll, describe, expect, it } from "vitest";
+import { normalizeLanguage } from "../language.js";
+import { initializeLogger } from "../log.js";
+import { DEFAULT_API_CONNECT_OPTIONS } from "../types.js";
+import { TTS, normalizeTTSFallback, parseTTSModelString } from "./tts.js";
+beforeAll(() => {
+  initializeLogger({ level: "silent", pretty: false });
+});
+function makeTts(overrides = {}) {
+  const defaults = {
+    model: "cartesia/sonic",
+    apiKey: "test-key",
+    apiSecret: "test-secret",
+    baseURL: "https://example.livekit.cloud"
+  };
+  return new TTS({ ...defaults, ...overrides });
+}
+describe("parseTTSModelString", () => {
+  it("simple model without voice", () => {
+    const [model, voice] = parseTTSModelString("cartesia");
+    expect(model).toBe("cartesia");
+    expect(voice).toBeUndefined();
+  });
+  it("model with voice suffix", () => {
+    const [model, voice] = parseTTSModelString("cartesia:my-voice-id");
+    expect(model).toBe("cartesia");
+    expect(voice).toBe("my-voice-id");
+  });
+  it("provider/model format without voice", () => {
+    const [model, voice] = parseTTSModelString("cartesia/sonic");
+    expect(model).toBe("cartesia/sonic");
+    expect(voice).toBeUndefined();
+  });
+  it("provider/model format with voice", () => {
+    const [model, voice] = parseTTSModelString("cartesia/sonic:my-voice-id");
+    expect(model).toBe("cartesia/sonic");
+    expect(voice).toBe("my-voice-id");
+  });
+  it.each([
+    ["elevenlabs/eleven_flash_v2:voice123", "elevenlabs/eleven_flash_v2", "voice123"],
+    ["rime:speaker-a", "rime", "speaker-a"],
+    ["rime/mist:narrator", "rime/mist", "narrator"],
+    ["inworld/inworld-tts-1:character", "inworld/inworld-tts-1", "character"],
+    ["cartesia/sonic-turbo:deep-voice", "cartesia/sonic-turbo", "deep-voice"]
+  ])("various providers and voices: %s", (modelStr, expectedModel, expectedVoice) => {
+    const [model, voice] = parseTTSModelString(modelStr);
+    expect(model).toBe(expectedModel);
+    expect(voice).toBe(expectedVoice);
+  });
+  it("empty voice after colon", () => {
+    const [model, voice] = parseTTSModelString("cartesia/sonic:");
+    expect(model).toBe("cartesia/sonic");
+    expect(voice).toBe("");
+  });
+});
+describe("normalizeTTSFallback", () => {
+  it("single string model", () => {
+    const result = normalizeTTSFallback("cartesia/sonic");
+    expect(result).toEqual([{ model: "cartesia/sonic", voice: "" }]);
+  });
+  it("single string model with voice", () => {
+    const result = normalizeTTSFallback("cartesia/sonic:my-voice");
+    expect(result).toEqual([{ model: "cartesia/sonic", voice: "my-voice" }]);
+  });
+  it("single FallbackModel dict", () => {
+    const fallback = { model: "cartesia/sonic", voice: "narrator" };
+    const result = normalizeTTSFallback(fallback);
+    expect(result).toEqual([{ model: "cartesia/sonic", voice: "narrator" }]);
+  });
+  it("list of string models", () => {
+    const result = normalizeTTSFallback(["cartesia/sonic", "elevenlabs/eleven_flash_v2"]);
+    expect(result).toEqual([
+      { model: "cartesia/sonic", voice: "" },
+      { model: "elevenlabs/eleven_flash_v2", voice: "" }
+    ]);
+  });
+  it("list of string models with voices", () => {
+    const result = normalizeTTSFallback(["cartesia/sonic:voice1", "elevenlabs:voice2"]);
+    expect(result).toEqual([
+      { model: "cartesia/sonic", voice: "voice1" },
+      { model: "elevenlabs", voice: "voice2" }
+    ]);
+  });
+  it("list of FallbackModel dicts", () => {
+    const fallbacks = [
+      { model: "cartesia/sonic", voice: "narrator" },
+      { model: "elevenlabs", voice: "" }
+    ];
+    const result = normalizeTTSFallback(fallbacks);
+    expect(result).toEqual([
+      { model: "cartesia/sonic", voice: "narrator" },
+      { model: "elevenlabs", voice: "" }
+    ]);
+  });
+  it("mixed list of strings and dicts", () => {
+    const result = normalizeTTSFallback([
+      "cartesia/sonic:voice1",
+      { model: "elevenlabs/eleven_flash_v2", voice: "custom" },
+      "rime/mist"
+    ]);
+    expect(result).toEqual([
+      { model: "cartesia/sonic", voice: "voice1" },
+      { model: "elevenlabs/eleven_flash_v2", voice: "custom" },
+      { model: "rime/mist", voice: "" }
+    ]);
+  });
+  it("FallbackModel with extraKwargs is preserved", () => {
+    const fallback = {
+      model: "cartesia/sonic",
+      voice: "narrator",
+      extraKwargs: { duration: 30, speed: "fast" }
+    };
+    const result = normalizeTTSFallback(fallback);
+    expect(result).toEqual([
+      {
+        model: "cartesia/sonic",
+        voice: "narrator",
+        extraKwargs: { duration: 30, speed: "fast" }
+      }
+    ]);
+  });
+  it("list with extraKwargs preserved", () => {
+    const result = normalizeTTSFallback([
+      { model: "cartesia/sonic", voice: "v1", extraKwargs: { speed: "slow" } },
+      "elevenlabs:voice2",
+      { model: "rime/mist", voice: "", extraKwargs: { custom: true } }
+    ]);
+    expect(result).toEqual([
+      { model: "cartesia/sonic", voice: "v1", extraKwargs: { speed: "slow" } },
+      { model: "elevenlabs", voice: "voice2" },
+      { model: "rime/mist", voice: "", extraKwargs: { custom: true } }
+    ]);
+  });
+  it("empty list returns empty list", () => {
+    const result = normalizeTTSFallback([]);
+    expect(result).toEqual([]);
+  });
+  it("FallbackModel with empty voice", () => {
+    const fallback = { model: "cartesia/sonic", voice: "" };
+    const result = normalizeTTSFallback(fallback);
+    expect(result).toEqual([{ model: "cartesia/sonic", voice: "" }]);
+  });
+});
+describe("TTS constructor fallback and connOptions", () => {
+  it("normalizes language in constructor", () => {
+    const tts = makeTts({ language: "english" });
+    expect(tts["opts"].language).toBe("en");
+  });
+  it("normalizes updated language values", () => {
+    const tts = makeTts();
+    tts.updateOptions({ language: "en_US" });
+    expect(tts["opts"].language).toBe(normalizeLanguage("en_US"));
+  });
+  it("fallback not given defaults to undefined", () => {
+    const tts = makeTts();
+    expect(tts["opts"].fallback).toBeUndefined();
+  });
+  it("fallback single string is normalized", () => {
+    const tts = makeTts({ fallback: "elevenlabs/eleven_flash_v2" });
+    expect(tts["opts"].fallback).toEqual([{ model: "elevenlabs/eleven_flash_v2", voice: "" }]);
+  });
+  it("fallback single string with voice is normalized", () => {
+    const tts = makeTts({ fallback: "cartesia/sonic:my-voice" });
+    expect(tts["opts"].fallback).toEqual([{ model: "cartesia/sonic", voice: "my-voice" }]);
+  });
+  it("fallback list of strings is normalized", () => {
+    const tts = makeTts({ fallback: ["cartesia/sonic", "elevenlabs"] });
+    expect(tts["opts"].fallback).toEqual([
+      { model: "cartesia/sonic", voice: "" },
+      { model: "elevenlabs", voice: "" }
+    ]);
+  });
+  it("fallback single FallbackModel is normalized to list", () => {
+    const tts = makeTts({ fallback: { model: "cartesia/sonic", voice: "narrator" } });
+    expect(tts["opts"].fallback).toEqual([{ model: "cartesia/sonic", voice: "narrator" }]);
+  });
+  it("fallback with extraKwargs is preserved", () => {
+    const tts = makeTts({
+      fallback: {
+        model: "cartesia/sonic",
+        voice: "narrator",
+        extraKwargs: { duration: 30, speed: "fast" }
+      }
+    });
+    expect(tts["opts"].fallback).toEqual([
+      {
+        model: "cartesia/sonic",
+        voice: "narrator",
+        extraKwargs: { duration: 30, speed: "fast" }
+      }
+    ]);
+  });
+  it("fallback mixed list is normalized", () => {
+    const tts = makeTts({
+      fallback: [
+        "cartesia/sonic:voice1",
+        { model: "elevenlabs", voice: "custom", extraKwargs: { speed: "slow" } },
+        "rime/mist"
+      ]
+    });
+    expect(tts["opts"].fallback).toEqual([
+      { model: "cartesia/sonic", voice: "voice1" },
+      { model: "elevenlabs", voice: "custom", extraKwargs: { speed: "slow" } },
+      { model: "rime/mist", voice: "" }
+    ]);
+  });
+  it("connOptions not given uses default", () => {
+    const tts = makeTts();
+    expect(tts["opts"].connOptions).toEqual(DEFAULT_API_CONNECT_OPTIONS);
+  });
+  it("connOptions custom timeout", () => {
+    const custom = { timeoutMs: 3e4, maxRetry: 3, retryIntervalMs: 2e3 };
+    const tts = makeTts({ connOptions: custom });
+    expect(tts["opts"].connOptions).toEqual(custom);
+    expect(tts["opts"].connOptions.timeoutMs).toBe(3e4);
+  });
+  it("connOptions custom maxRetry", () => {
+    const custom = { timeoutMs: 1e4, maxRetry: 5, retryIntervalMs: 2e3 };
+    const tts = makeTts({ connOptions: custom });
+    expect(tts["opts"].connOptions).toEqual(custom);
+    expect(tts["opts"].connOptions.maxRetry).toBe(5);
+  });
+  it("connOptions full custom", () => {
+    const custom = { timeoutMs: 6e4, maxRetry: 10, retryIntervalMs: 2e3 };
+    const tts = makeTts({ connOptions: custom });
+    expect(tts["opts"].connOptions).toEqual(custom);
+    expect(tts["opts"].connOptions.timeoutMs).toBe(6e4);
+    expect(tts["opts"].connOptions.maxRetry).toBe(10);
+    expect(tts["opts"].connOptions.retryIntervalMs).toBe(2e3);
+  });
+});
+describe("TTS provider modelOptions parity", () => {
+  it("preserves ElevenLabs inference model options", () => {
+    const modelOptions = {
+      speed: 1.2,
+      stability: 0.5,
+      similarity_boost: 0.8,
+      enable_logging: false
+    };
+    const tts = new TTS({
+      model: "elevenlabs/eleven_flash_v2_5",
+      apiKey: "test-key",
+      apiSecret: "test-secret",
+      baseURL: "https://example.livekit.cloud",
+      modelOptions
+    });
+    expect(tts["opts"].modelOptions).toEqual(modelOptions);
+  });
+  it("accepts expanded Cartesia inference model options", () => {
+    const modelOptions = {
+      speed: 1.15,
+      emotion: "curious",
+      add_timestamps: true
+    };
+    const tts = new TTS({
+      model: "cartesia/sonic",
+      apiKey: "test-key",
+      apiSecret: "test-secret",
+      baseURL: "https://example.livekit.cloud",
+      modelOptions
+    });
+    expect(tts["opts"].modelOptions).toEqual(modelOptions);
+  });
+  it("accepts Deepgram inference model options", () => {
+    const modelOptions = { mip_opt_out: true };
+    const tts = new TTS({
+      model: "deepgram/aura-2",
+      apiKey: "test-key",
+      apiSecret: "test-secret",
+      baseURL: "https://example.livekit.cloud",
+      modelOptions
+    });
+    expect(tts["opts"].modelOptions).toEqual(modelOptions);
+  });
+  it("accepts Rime inference model options", () => {
+    const modelOptions = {
+      speed_alpha: 0.9,
+      pause_between_brackets: true
+    };
+    const tts = new TTS({
+      model: "rime/mistv2",
+      apiKey: "test-key",
+      apiSecret: "test-secret",
+      baseURL: "https://example.livekit.cloud",
+      modelOptions
+    });
+    expect(tts["opts"].modelOptions).toEqual(modelOptions);
+  });
+  it("accepts Inworld inference model options", () => {
+    const modelOptions = {
+      timestamp_type: "WORD",
+      apply_text_normalization: "ON"
+    };
+    const tts = new TTS({
+      model: "inworld/inworld-tts-1",
+      apiKey: "test-key",
+      apiSecret: "test-secret",
+      baseURL: "https://example.livekit.cloud",
+      modelOptions
+    });
+    expect(tts["opts"].modelOptions).toEqual(modelOptions);
+  });
+});
+//# sourceMappingURL=tts.test.js.map