@livekit/agents-plugin-deepgram 0.0.0-next-20260624041820

package/src/models.ts

@@ -0,0 +1,93 @@
+// SPDX-FileCopyrightText: 2024 LiveKit, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+
+export type TTSModels =
+  | 'aura-asteria-en'
+  | 'aura-luna-en'
+  | 'aura-stella-en'
+  | 'aura-athena-en'
+  | 'aura-hera-en'
+  | 'aura-orion-en'
+  | 'aura-arcas-en'
+  | 'aura-perseus-en'
+  | 'aura-angus-en'
+  | 'aura-orpheus-en'
+  | 'aura-helios-en'
+  | 'aura-zeus-en';
+
+export type TTSEncoding = 'linear16' | 'mulaw' | 'alaw' | 'mp3' | 'opus' | 'flac' | 'aac';
+
+// Ref: python livekit-plugins/livekit-plugins-deepgram/livekit/plugins/deepgram/models.py - 38 line
+export type V2Models = 'flux-general-en' | 'flux-general-multi';
+
+export type STTModels =
+  | 'nova-general'
+  | 'nova-phonecall'
+  | 'nova-meeting'
+  | 'nova-2-general'
+  | 'nova-2-meeting'
+  | 'nova-2-phonecall'
+  | 'nova-2-finance'
+  | 'nova-2-conversationalai'
+  | 'nova-2-voicemail'
+  | 'nova-2-video'
+  | 'nova-2-medical'
+  | 'nova-2-drivethru'
+  | 'nova-2-automotive'
+  | 'nova-3'
+  | 'nova-3-general'
+  | 'nova-3-medical'
+  | 'enhanced-general'
+  | 'enhanced-meeting'
+  | 'enhanced-phonecall'
+  | 'enhanced-finance'
+  | 'base'
+  | 'meeting'
+  | 'phonecall'
+  | 'finance'
+  | 'conversationalai'
+  | 'voicemail'
+  | 'video'
+  | 'whisper-tiny'
+  | 'whisper-base'
+  | 'whisper-small'
+  | 'whisper-medium'
+  | 'whisper-large';
+
+export type STTLanguages =
+  | 'da'
+  | 'de'
+  | 'en'
+  | 'en-AU'
+  | 'en-GB'
+  | 'en-IN'
+  | 'en-NZ'
+  | 'en-US'
+  | 'es'
+  | 'es-419'
+  | 'es-LATAM'
+  | 'fr'
+  | 'fr-CA'
+  | 'hi'
+  | 'hi-Latn'
+  | 'id'
+  | 'it'
+  | 'ja'
+  | 'ko'
+  | 'nl'
+  | 'no'
+  | 'pl'
+  | 'pt'
+  | 'pt-BR'
+  | 'ru'
+  | 'sv'
+  | 'ta'
+  | 'taq'
+  | 'th'
+  | 'tr'
+  | 'uk'
+  | 'zh'
+  | 'zh-CN'
+  | 'zh-TW'
+  | 'multi';

package/src/stt.test.ts

@@ -0,0 +1,36 @@
+// SPDX-FileCopyrightText: 2024 LiveKit, Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+import { VAD } from '@livekit/agents-plugin-silero';
+import { stt } from '@livekit/agents-plugins-test';
+import { describe, expect, it } from 'vitest';
+import { STT } from './stt.js';
+
+const hasDeepgramApiKey = Boolean(process.env.DEEPGRAM_API_KEY);
+
+describe('Deepgram streaming language detection', () => {
+  // Deepgram only supports language detection for prerecorded audio, so a
+  // streaming session must reject it rather than silently default to English.
+  // Mirrors livekit-plugins-deepgram (Python).
+  it('throws when starting a stream with detectLanguage enabled', () => {
+    const stt = new STT({ apiKey: 'test', detectLanguage: true });
+    expect(() => stt.stream()).toThrow('language detection is not supported in streaming mode');
+  });
+
+  it('allows streaming with an explicit language', () => {
+    const stt = new STT({ apiKey: 'test', language: 'en-US' });
+    const stream = stt.stream();
+    // Close immediately so the connection loop never starts (no network in unit tests).
+    stream.close();
+  });
+});
+
+if (hasDeepgramApiKey) {
+  describe('Deepgram', async () => {
+    await stt(new STT(), await VAD.load(), { nonStreaming: false });
+  });
+} else {
+  describe('Deepgram', () => {
+    it.skip('requires DEEPGRAM_API_KEY', () => {});
+  });
+}