@mastra/voice-deepgram 0.0.0-remove-unused-model-providers-api-20251030210744 → 0.0.0-remove-ai-peer-dep-from-evals-20260105220639

package/dist/docs/voice/02-reference.md

@@ -0,0 +1,62 @@
+# Voice API Reference
+
+> API reference for voice - 1 entries
+
+
+---
+
+## Reference: Deepgram
+
+> Documentation for the Deepgram voice implementation, providing text-to-speech and speech-to-text capabilities with multiple voice models and languages.
+
+The Deepgram voice implementation in Mastra provides text-to-speech (TTS) and speech-to-text (STT) capabilities using Deepgram's API. It supports multiple voice models and languages, with configurable options for both speech synthesis and transcription.
+
+## Usage Example
+
+```typescript
+import { DeepgramVoice } from "@mastra/voice-deepgram";
+
+// Initialize with default configuration (uses DEEPGRAM_API_KEY environment variable)
+const voice = new DeepgramVoice();
+
+// Initialize with custom configuration
+const voice = new DeepgramVoice({
+  speechModel: {
+    name: "aura",
+    apiKey: "your-api-key",
+  },
+  listeningModel: {
+    name: "nova-2",
+    apiKey: "your-api-key",
+  },
+  speaker: "asteria-en",
+});
+
+// Text-to-Speech
+const audioStream = await voice.speak("Hello, world!");
+
+// Speech-to-Text
+const transcript = await voice.listen(audioStream);
+```
+
+## Constructor Parameters
+
+### DeepgramVoiceConfig
+
+## Methods
+
+### speak()
+
+Converts text to speech using the configured speech model and voice.
+
+Returns: `Promise<NodeJS.ReadableStream>`
+
+### listen()
+
+Converts speech to text using the configured listening model.
+
+Returns: `Promise<string>`
+
+### getSpeakers()
+
+Returns a list of available voice options.

package/dist/index.cjs

@@ -26,6 +26,9 @@ var DEEPGRAM_VOICES = [
 var DeepgramVoice = class extends voice.MastraVoice {
   speechClient;
   listeningClient;
+  storedSpeechModel;
+  storedListeningModel;
+  storedSpeaker;
   constructor({
     speechModel,
     listeningModel,
@@ -51,6 +54,14 @@ var DeepgramVoice = class extends voice.MastraVoice {
       },
       speaker
     });
+    this.storedSpeechModel = {
+      name: speechModel?.name ?? defaultSpeechModel.name,
+      apiKey: speechModel?.apiKey ?? defaultSpeechModel.apiKey
+    };
+    this.storedListeningModel = {
+      name: listeningModel?.name ?? defaultListeningModel.name,
+      apiKey: listeningModel?.apiKey ?? defaultListeningModel.apiKey
+    };
     const speechApiKey = speechModel?.apiKey || defaultApiKey;
     const listeningApiKey = listeningModel?.apiKey || defaultApiKey;
     if (!speechApiKey && !listeningApiKey) {
@@ -62,7 +73,7 @@ var DeepgramVoice = class extends voice.MastraVoice {
     if (listeningApiKey) {
       this.listeningClient = sdk.createClient(listeningApiKey);
     }
-    this.speaker = speaker || "asteria-en";
+    this.storedSpeaker = speaker || "asteria-en";
   }
   async getSpeakers() {
     return DEEPGRAM_VOICES.map((voice) => ({
@@ -90,21 +101,15 @@ var DeepgramVoice = class extends voice.MastraVoice {
     if (text.trim().length === 0) {
       throw new Error("Input text is empty");
     }
-    if (!this.speechClient) {
-      throw new Error("No speech client configured");
-    }
-    let model;
-    if (options?.speaker) {
-      model = this.speechModel?.name + "-" + options.speaker;
-    } else if (this.speaker) {
-      model = this.speechModel?.name + "-" + this.speaker;
-    }
+    const baseModel = this.storedSpeechModel?.name;
+    const speakerId = options?.speaker || this.storedSpeaker;
+    const modelName = baseModel && speakerId ? speakerId.startsWith(`${baseModel}-`) ? speakerId : `${baseModel}-${speakerId}` : baseModel || speakerId;
     const speakClient = this.speechClient.speak;
     const response = await speakClient.request(
       { text },
       {
-        model,
-        ...options
+        model: modelName,
+        ...Object.fromEntries(Object.entries(options ?? {}).filter(([k]) => k !== "speaker"))
       }
     );
     const webStream = await response.getStream();
@@ -139,6 +144,17 @@ var DeepgramVoice = class extends voice.MastraVoice {
   async getListener() {
     return { enabled: true };
   }
+  /**
+   * Transcribes audio with optional speaker diarization.
+   *
+   * @param audioStream - Audio input stream
+   * @param options - Transcription options (diarize, language, etc.)
+   * @returns Promise resolving to:
+   *   - transcript: Full transcript string
+   *   - words: Array of word objects with timing and confidence
+   *   - raw: Complete Deepgram API response
+   *   - speakerSegments: (when diarize=true) Array of {word, speaker, start, end}
+   */
   async listen(audioStream, options) {
     if (!this.listeningClient) {
       throw new Error("Deepgram listening client not configured");
@@ -152,21 +168,38 @@ var DeepgramVoice = class extends voice.MastraVoice {
       }
     }
     const buffer = Buffer.concat(chunks);
-    if (!this.listeningClient) {
-      throw new Error("No listening client configured");
-    }
+    const { diarize, diarize_speaker_count: _, ...restOptions } = options ?? {};
     const { result, error } = await this.listeningClient.listen.prerecorded.transcribeFile(buffer, {
-      model: this.listeningModel?.name,
-      ...options
+      ...restOptions,
+      model: this.storedListeningModel?.name,
+      diarize
     });
     if (error) {
       throw error;
     }
-    const transcript = result.results?.channels?.[0]?.alternatives?.[0]?.transcript;
-    if (!transcript) {
-      throw new Error("No transcript found in Deepgram response");
+    const channel = result.results?.channels?.[0];
+    const alt = channel?.alternatives?.[0];
+    if (!alt) {
+      return {
+        transcript: "",
+        words: [],
+        raw: result
+      };
+    }
+    const response = {
+      transcript: alt.transcript,
+      words: alt.words,
+      raw: result
+    };
+    if (diarize && alt.words) {
+      response.speakerSegments = alt.words.map((w) => ({
+        word: w.word,
+        speaker: w.speaker,
+        start: w.start,
+        end: w.end
+      }));
     }
-    return transcript;
+    return response;
   }
 };
 

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/voices.ts","../src/index.ts"],"names":["MastraVoice","createClient","PassThrough"],"mappings":";;;;;;;;;AAKO,IAAM,eAAA,GAAkB;AAAA,EAC7B,YAAA;AAAA,EACA,SAAA;AAAA,EACA,WAAA;AAAA,EACA,WAAA;AAAA,EACA,SAAA;AAAA,EACA,UAAA;AAAA,EACA,UAAA;AAAA,EACA,YAAA;AAAA,EACA,UAAA;AAAA,EACA,YAAA;AAAA,EACA,WAAA;AAAA,EACA;AACF,CAAA;;;ACHO,IAAM,aAAA,GAAN,cAA4BA,iBAAA,CAAY;AAAA,EACrC,YAAA;AAAA,EACA,eAAA;AAAA,EAER,WAAA,CAAY;AAAA,IACV,WAAA;AAAA,IACA,cAAA;AAAA,IACA;AAAA,GACF,GAA4G,EAAC,EAAG;AAC9G,IAAA,MAAM,aAAA,GAAgB,QAAQ,GAAA,CAAI,gBAAA;AAElC,IAAA,MAAM,kBAAA,GAAqB;AAAA,MACzB,IAAA,EAAM,MAAA;AAAA,MACN,MAAA,EAAQ;AAAA,KACV;AAEA,IAAA,MAAM,qBAAA,GAAwB;AAAA,MAC5B,IAAA,EAAM,MAAA;AAAA,MACN,MAAA,EAAQ;AAAA,KACV;AAEA,IAAA,KAAA,CAAM;AAAA,MACJ,WAAA,EAAa;AAAA,QACX,IAAA,EAAM,WAAA,EAAa,IAAA,IAAQ,kBAAA,CAAmB,IAAA;AAAA,QAC9C,MAAA,EAAQ,WAAA,EAAa,MAAA,IAAU,kBAAA,CAAmB;AAAA,OACpD;AAAA,MACA,cAAA,EAAgB;AAAA,QACd,IAAA,EAAM,cAAA,EAAgB,IAAA,IAAQ,qBAAA,CAAsB,IAAA;AAAA,QACpD,MAAA,EAAQ,cAAA,EAAgB,MAAA,IAAU,qBAAA,CAAsB;AAAA,OAC1D;AAAA,MACA;AAAA,KACD,CAAA;AAED,IAAA,MAAM,YAAA,GAAe,aAAa,MAAA,IAAU,aAAA;AAC5C,IAAA,MAAM,eAAA,GAAkB,gBAAgB,MAAA,IAAU,aAAA;AAElD,IAAA,IAAI,CAAC,YAAA,IAAgB,CAAC,eAAA,EAAiB;AACrC,MAAA,MAAM,IAAI,MAAM,4FAA4F,CAAA;AAAA,IAC9G;AAEA,IAAA,IAAI,YAAA,EAAc;AAChB,MAAA,IAAA,CAAK,YAAA,GAAeC,iBAAa,YAAY,CAAA;AAAA,IAC/C;AACA,IAAA,IAAI,eAAA,EAAiB;AACnB,MAAA,IAAA,CAAK,eAAA,GAAkBA,iBAAa,eAAe,CAAA;AAAA,IACrD;AAEA,IAAA,IAAA,CAAK,UAAU,OAAA,IAAW,YAAA;AAAA,EAC5B;AAAA,EAEA,MAAM,WAAA,GAAc;AAClB,IAAA,OAAO,eAAA,CAAgB,IAAI,CAAA,KAAA,MAAU;AAAA,MACnC,OAAA,EAAS;AAAA,KACX,CAAE,CAAA;AAAA,EACJ;AAAA,EAEA,MAAM,KAAA,CACJ,KAAA,EACA,OAAA,EAIgC;AAChC,IAAA,IAAI,CAAC,KAAK,YAAA,EAAc;AACtB,MAAA,MAAM,IAAI,MAAM,uCAAuC,CAAA;AAAA,IACzD;AAEA,IAAA,IAAI,IAAA;AACJ,IAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,MAAA,MAAM,SAAmB,EAAC;AAC1B,MAAA,WAAA,MAAiB,SAAS,KAAA,EAAO;AAC/B,QAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,UAAA,MAAA,CAAO,IAAA,CAAK,MAAA,CAAO,IAAA,CAAK,KAAK,CAAC,CAAA;AAAA,QAChC,CAAA,MAAO;AACL,UAAA,MAAA,CAAO,KAAK,KAAK,CAAA;AAAA,QACnB;AAAA,MACF;AACA,MAAA,IAAA,GAAO,MAAA,CAAO,MAAA,CAAO,MAAM,CAAA,CAAE,SAAS,OAAO,CAAA;AAAA,IAC/C,CAAA,MAAO;AACL,MAAA,IAAA,GAAO,KAAA;AAAA,IACT;AAEA,IAAA,IAAI,IAAA,CAAK,IAAA,EAAK,CAAE,MAAA,KAAW,CAAA,EAAG;AAC5B,MAAA,MAAM,IAAI,MAAM,qBAAqB,CAAA;AAAA,IACvC;AAEA,IAAA,IAAI,CAAC,KAAK,YAAA,EAAc;AACtB,MAAA,MAAM,IAAI,MAAM,6BAA6B,CAAA;AAAA,IAC/C;AAEA,IAAA,IAAI,KAAA;AACJ,IAAA,IAAI,SAAS,OAAA,EAAS;AACpB,MAAA,KAAA,GAAQ,IAAA,CAAK,WAAA,EAAa,IAAA,GAAO,GAAA,GAAM,OAAA,CAAQ,OAAA;AAAA,IACjD,CAAA,MAAA,IAAW,KAAK,OAAA,EAAS;AACvB,MAAA,KAAA,GAAQ,IAAA,CAAK,WAAA,EAAa,IAAA,GAAO,GAAA,GAAM,IAAA,CAAK,OAAA;AAAA,IAC9C;AAEA,IAAA,MAAM,WAAA,GAAc,KAAK,YAAA,CAAa,KAAA;AACtC,IAAA,MAAM,QAAA,GAAW,MAAM,WAAA,CAAY,OAAA;AAAA,MACjC,EAAE,IAAA,EAAK;AAAA,MACP;AAAA,QACE,KAAA;AAAA,QACA,GAAG;AAAA;AACL,KACF;AAEA,IAAA,MAAM,SAAA,GAAY,MAAM,QAAA,CAAS,SAAA,EAAU;AAC3C,IAAA,IAAI,CAAC,SAAA,EAAW;AACd,MAAA,MAAM,IAAI,MAAM,kCAAkC,CAAA;AAAA,IACpD;AAEA,IAAA,MAAM,MAAA,GAAS,UAAU,SAAA,EAAU;AACnC,IAAA,MAAM,UAAA,GAAa,IAAIC,kBAAA,EAAY;AAGnC,IAAA,CAAC,YAAY;AACX,MAAA,IAAI;AACF,QAAA,OAAO,IAAA,EAAM;AACX,UAAA,MAAM,EAAE,IAAA,EAAM,KAAA,EAAM,GAAI,MAAM,OAAO,IAAA,EAAK;AAC1C,UAAA,IAAI,IAAA,EAAM;AACR,YAAA,UAAA,CAAW,GAAA,EAAI;AACf,YAAA;AAAA,UACF;AACA,UAAA,UAAA,CAAW,MAAM,KAAK,CAAA;AAAA,QACxB;AAAA,MACF,SAAS,KAAA,EAAO;AACd,QAAA,UAAA,CAAW,QAAQ,KAAc,CAAA;AAAA,MACnC;AAAA,IACF,CAAA,GAAG,CAAE,KAAA,CAAM,CAAA,KAAA,KAAS;AAClB,MAAA,UAAA,CAAW,QAAQ,KAAc,CAAA;AAAA,IACnC,CAAC,CAAA;AAED,IAAA,OAAO,UAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,WAAA,GAAc;AAClB,IAAA,OAAO,EAAE,SAAS,IAAA,EAAK;AAAA,EACzB;AAAA,EAEA,MAAM,MAAA,CACJ,WAAA,EACA,OAAA,EAGiB;AACjB,IAAA,IAAI,CAAC,KAAK,eAAA,EAAiB;AACzB,MAAA,MAAM,IAAI,MAAM,0CAA0C,CAAA;AAAA,IAC5D;AAEA,IAAA,MAAM,SAAmB,EAAC;AAC1B,IAAA,WAAA,MAAiB,SAAS,WAAA,EAAa;AACrC,MAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,QAAA,MAAA,CAAO,IAAA,CAAK,MAAA,CAAO,IAAA,CAAK,KAAK,CAAC,CAAA;AAAA,MAChC,CAAA,MAAO;AACL,QAAA,MAAA,CAAO,KAAK,KAAK,CAAA;AAAA,MACnB;AAAA,IACF;AACA,IAAA,MAAM,MAAA,GAAS,MAAA,CAAO,MAAA,CAAO,MAAM,CAAA;AAEnC,IAAA,IAAI,CAAC,KAAK,eAAA,EAAiB;AACzB,MAAA,MAAM,IAAI,MAAM,gCAAgC,CAAA;AAAA,IAClD;AACA,IAAA,MAAM,EAAE,MAAA,EAAQ,KAAA,EAAM,GAAI,MAAM,KAAK,eAAA,CAAgB,MAAA,CAAO,WAAA,CAAY,cAAA,CAAe,MAAA,EAAQ;AAAA,MAC7F,KAAA,EAAO,KAAK,cAAA,EAAgB,IAAA;AAAA,MAC5B,GAAG;AAAA,KACJ,CAAA;AAED,IAAA,IAAI,KAAA,EAAO;AACT,MAAA,MAAM,KAAA;AAAA,IACR;AAEA,IAAA,MAAM,UAAA,GAAa,OAAO,OAAA,EAAS,QAAA,GAAW,CAAC,CAAA,EAAG,YAAA,GAAe,CAAC,CAAA,EAAG,UAAA;AACrE,IAAA,IAAI,CAAC,UAAA,EAAY;AACf,MAAA,MAAM,IAAI,MAAM,0CAA0C,CAAA;AAAA,IAC5D;AAEA,IAAA,OAAO,UAAA;AAAA,EACT;AACF","file":"index.cjs","sourcesContent":["/**\n * List of available Deepgram voice models for text-to-speech\n * Each voice is designed for specific use cases and languages\n * Format: {name}-{language} (e.g. asteria-en)\n */\nexport const DEEPGRAM_VOICES = [\n  'asteria-en',\n  'luna-en',\n  'stella-en',\n  'athena-en',\n  'hera-en',\n  'orion-en',\n  'arcas-en',\n  'perseus-en',\n  'angus-en',\n  'orpheus-en',\n  'helios-en',\n  'zeus-en',\n] as const;\n\nexport type DeepgramVoiceId = (typeof DEEPGRAM_VOICES)[number];\n\n/**\n * List of available Deepgram models for text-to-speech and speech-to-text\n */\nexport const DEEPGRAM_MODELS = ['aura', 'whisper', 'base', 'enhanced', 'nova', 'nova-2', 'nova-3'] as const;\n\nexport type DeepgramModel = (typeof DEEPGRAM_MODELS)[number];\n","import { PassThrough } from 'stream';\n\nimport { createClient } from '@deepgram/sdk';\nimport { MastraVoice } from '@mastra/core/voice';\n\nimport { DEEPGRAM_VOICES } from './voices';\nimport type { DeepgramVoiceId, DeepgramModel } from './voices';\n\ninterface DeepgramVoiceConfig {\n  name?: DeepgramModel;\n  apiKey?: string;\n  properties?: Record<string, any>;\n  language?: string;\n}\n\nexport class DeepgramVoice extends MastraVoice {\n  private speechClient?: ReturnType<typeof createClient>;\n  private listeningClient?: ReturnType<typeof createClient>;\n\n  constructor({\n    speechModel,\n    listeningModel,\n    speaker,\n  }: { speechModel?: DeepgramVoiceConfig; listeningModel?: DeepgramVoiceConfig; speaker?: DeepgramVoiceId } = {}) {\n    const defaultApiKey = process.env.DEEPGRAM_API_KEY;\n\n    const defaultSpeechModel = {\n      name: 'aura',\n      apiKey: defaultApiKey,\n    };\n\n    const defaultListeningModel = {\n      name: 'nova',\n      apiKey: defaultApiKey,\n    };\n\n    super({\n      speechModel: {\n        name: speechModel?.name ?? defaultSpeechModel.name,\n        apiKey: speechModel?.apiKey ?? defaultSpeechModel.apiKey,\n      },\n      listeningModel: {\n        name: listeningModel?.name ?? defaultListeningModel.name,\n        apiKey: listeningModel?.apiKey ?? defaultListeningModel.apiKey,\n      },\n      speaker,\n    });\n\n    const speechApiKey = speechModel?.apiKey || defaultApiKey;\n    const listeningApiKey = listeningModel?.apiKey || defaultApiKey;\n\n    if (!speechApiKey && !listeningApiKey) {\n      throw new Error('At least one of DEEPGRAM_API_KEY, speechModel.apiKey, or listeningModel.apiKey must be set');\n    }\n\n    if (speechApiKey) {\n      this.speechClient = createClient(speechApiKey);\n    }\n    if (listeningApiKey) {\n      this.listeningClient = createClient(listeningApiKey);\n    }\n\n    this.speaker = speaker || 'asteria-en';\n  }\n\n  async getSpeakers() {\n    return DEEPGRAM_VOICES.map(voice => ({\n      voiceId: voice,\n    }));\n  }\n\n  async speak(\n    input: string | NodeJS.ReadableStream,\n    options?: {\n      speaker?: string;\n      [key: string]: any;\n    },\n  ): Promise<NodeJS.ReadableStream> {\n    if (!this.speechClient) {\n      throw new Error('Deepgram speech client not configured');\n    }\n\n    let text: string;\n    if (typeof input !== 'string') {\n      const chunks: Buffer[] = [];\n      for await (const chunk of input) {\n        if (typeof chunk === 'string') {\n          chunks.push(Buffer.from(chunk));\n        } else {\n          chunks.push(chunk);\n        }\n      }\n      text = Buffer.concat(chunks).toString('utf-8');\n    } else {\n      text = input;\n    }\n\n    if (text.trim().length === 0) {\n      throw new Error('Input text is empty');\n    }\n\n    if (!this.speechClient) {\n      throw new Error('No speech client configured');\n    }\n\n    let model;\n    if (options?.speaker) {\n      model = this.speechModel?.name + '-' + options.speaker;\n    } else if (this.speaker) {\n      model = this.speechModel?.name + '-' + this.speaker;\n    }\n\n    const speakClient = this.speechClient.speak;\n    const response = await speakClient.request(\n      { text },\n      {\n        model,\n        ...options,\n      },\n    );\n\n    const webStream = await response.getStream();\n    if (!webStream) {\n      throw new Error('No stream returned from Deepgram');\n    }\n\n    const reader = webStream.getReader();\n    const nodeStream = new PassThrough();\n\n    // Add error handling for the stream processing\n    (async () => {\n      try {\n        while (true) {\n          const { done, value } = await reader.read();\n          if (done) {\n            nodeStream.end();\n            break;\n          }\n          nodeStream.write(value);\n        }\n      } catch (error) {\n        nodeStream.destroy(error as Error);\n      }\n    })().catch(error => {\n      nodeStream.destroy(error as Error);\n    });\n\n    return nodeStream;\n  }\n\n  /**\n   * Checks if listening capabilities are enabled.\n   *\n   * @returns {Promise<{ enabled: boolean }>}\n   */\n  async getListener() {\n    return { enabled: true };\n  }\n\n  async listen(\n    audioStream: NodeJS.ReadableStream,\n    options?: {\n      [key: string]: any;\n    },\n  ): Promise<string> {\n    if (!this.listeningClient) {\n      throw new Error('Deepgram listening client not configured');\n    }\n\n    const chunks: Buffer[] = [];\n    for await (const chunk of audioStream) {\n      if (typeof chunk === 'string') {\n        chunks.push(Buffer.from(chunk));\n      } else {\n        chunks.push(chunk);\n      }\n    }\n    const buffer = Buffer.concat(chunks);\n\n    if (!this.listeningClient) {\n      throw new Error('No listening client configured');\n    }\n    const { result, error } = await this.listeningClient.listen.prerecorded.transcribeFile(buffer, {\n      model: this.listeningModel?.name,\n      ...options,\n    });\n\n    if (error) {\n      throw error;\n    }\n\n    const transcript = result.results?.channels?.[0]?.alternatives?.[0]?.transcript;\n    if (!transcript) {\n      throw new Error('No transcript found in Deepgram response');\n    }\n\n    return transcript;\n  }\n}\n\nexport type { DeepgramVoiceConfig, DeepgramVoiceId, DeepgramModel };\n"]}
+{"version":3,"sources":["../src/voices.ts","../src/index.ts"],"names":["MastraVoice","createClient","PassThrough"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * List of available Deepgram voice models for text-to-speech\n * Each voice is designed for specific use cases and languages\n * Format: {name}-{language} (e.g. asteria-en)\n */\nexport const DEEPGRAM_VOICES = [\n  'asteria-en',\n  'luna-en',\n  'stella-en',\n  'athena-en',\n  'hera-en',\n  'orion-en',\n  'arcas-en',\n  'perseus-en',\n  'angus-en',\n  'orpheus-en',\n  'helios-en',\n  'zeus-en',\n] as const;\n\nexport type DeepgramVoiceId = (typeof DEEPGRAM_VOICES)[number];\n\n/**\n * List of available Deepgram models for text-to-speech and speech-to-text\n */\nexport const DEEPGRAM_MODELS = ['aura', 'whisper', 'base', 'enhanced', 'nova', 'nova-2', 'nova-3'] as const;\n\nexport type DeepgramModel = (typeof DEEPGRAM_MODELS)[number];\n","import { PassThrough } from 'node:stream';\n\nimport { createClient } from '@deepgram/sdk';\nimport { MastraVoice } from '@mastra/core/voice';\n\nimport { DEEPGRAM_VOICES } from './voices';\nimport type { DeepgramVoiceId, DeepgramModel } from './voices';\n\ninterface DeepgramVoiceConfig {\n  name?: DeepgramModel;\n  apiKey?: string;\n  properties?: Record<string, any>;\n  language?: string;\n}\n\ninterface DeepgramWord {\n  word: string;\n  start?: number;\n  end?: number;\n  confidence?: number;\n  speaker?: number;\n}\n\nexport class DeepgramVoice extends MastraVoice {\n  private speechClient?: ReturnType<typeof createClient>;\n  private listeningClient?: ReturnType<typeof createClient>;\n  private storedSpeechModel?: { name: DeepgramModel; apiKey?: string };\n  private storedListeningModel?: { name: DeepgramModel; apiKey?: string };\n  private storedSpeaker?: DeepgramVoiceId;\n\n  constructor({\n    speechModel,\n    listeningModel,\n    speaker,\n  }: { speechModel?: DeepgramVoiceConfig; listeningModel?: DeepgramVoiceConfig; speaker?: DeepgramVoiceId } = {}) {\n    const defaultApiKey = process.env.DEEPGRAM_API_KEY;\n\n    const defaultSpeechModel: { name: DeepgramModel; apiKey?: string } = {\n      name: 'aura',\n      apiKey: defaultApiKey,\n    };\n\n    const defaultListeningModel: { name: DeepgramModel; apiKey?: string } = {\n      name: 'nova',\n      apiKey: defaultApiKey,\n    };\n\n    super({\n      speechModel: {\n        name: speechModel?.name ?? defaultSpeechModel.name,\n        apiKey: speechModel?.apiKey ?? defaultSpeechModel.apiKey,\n      },\n      listeningModel: {\n        name: listeningModel?.name ?? defaultListeningModel.name,\n        apiKey: listeningModel?.apiKey ?? defaultListeningModel.apiKey,\n      },\n      speaker,\n    });\n\n    this.storedSpeechModel = {\n      name: speechModel?.name ?? defaultSpeechModel.name,\n      apiKey: speechModel?.apiKey ?? defaultSpeechModel.apiKey,\n    };\n    this.storedListeningModel = {\n      name: listeningModel?.name ?? defaultListeningModel.name,\n      apiKey: listeningModel?.apiKey ?? defaultListeningModel.apiKey,\n    };\n\n    const speechApiKey = speechModel?.apiKey || defaultApiKey;\n    const listeningApiKey = listeningModel?.apiKey || defaultApiKey;\n\n    if (!speechApiKey && !listeningApiKey) {\n      throw new Error('At least one of DEEPGRAM_API_KEY, speechModel.apiKey, or listeningModel.apiKey must be set');\n    }\n\n    if (speechApiKey) {\n      this.speechClient = createClient(speechApiKey);\n    }\n    if (listeningApiKey) {\n      this.listeningClient = createClient(listeningApiKey);\n    }\n\n    this.storedSpeaker = speaker || 'asteria-en';\n  }\n\n  async getSpeakers() {\n    return DEEPGRAM_VOICES.map(voice => ({\n      voiceId: voice,\n    }));\n  }\n\n  async speak(\n    input: string | NodeJS.ReadableStream,\n    options?: {\n      speaker?: string;\n      [key: string]: any;\n    },\n  ): Promise<NodeJS.ReadableStream> {\n    if (!this.speechClient) {\n      throw new Error('Deepgram speech client not configured');\n    }\n\n    let text: string;\n    if (typeof input !== 'string') {\n      const chunks: Buffer[] = [];\n      for await (const chunk of input) {\n        if (typeof chunk === 'string') {\n          chunks.push(Buffer.from(chunk));\n        } else {\n          chunks.push(chunk);\n        }\n      }\n      text = Buffer.concat(chunks).toString('utf-8');\n    } else {\n      text = input;\n    }\n\n    if (text.trim().length === 0) {\n      throw new Error('Input text is empty');\n    }\n\n    const baseModel = this.storedSpeechModel?.name;\n    const speakerId = options?.speaker || this.storedSpeaker;\n\n    const modelName =\n      baseModel && speakerId\n        ? speakerId.startsWith(`${baseModel}-`)\n          ? speakerId\n          : `${baseModel}-${speakerId}`\n        : baseModel || speakerId;\n\n    const speakClient = this.speechClient.speak;\n    const response = await speakClient.request(\n      { text },\n      {\n        model: modelName,\n        ...Object.fromEntries(Object.entries(options ?? {}).filter(([k]) => k !== 'speaker')),\n      },\n    );\n\n    const webStream = await response.getStream();\n    if (!webStream) {\n      throw new Error('No stream returned from Deepgram');\n    }\n\n    const reader = webStream.getReader();\n    const nodeStream = new PassThrough();\n\n    // Add error handling for the stream processing\n    (async () => {\n      try {\n        while (true) {\n          const { done, value } = await reader.read();\n          if (done) {\n            nodeStream.end();\n            break;\n          }\n          nodeStream.write(value);\n        }\n      } catch (error) {\n        nodeStream.destroy(error as Error);\n      }\n    })().catch(error => {\n      nodeStream.destroy(error as Error);\n    });\n\n    return nodeStream;\n  }\n\n  /**\n   * Checks if listening capabilities are enabled.\n   *\n   * @returns {Promise<{ enabled: boolean }>}\n   */\n  async getListener() {\n    return { enabled: true };\n  }\n\n  /**\n   * Transcribes audio with optional speaker diarization.\n   *\n   * @param audioStream - Audio input stream\n   * @param options - Transcription options (diarize, language, etc.)\n   * @returns Promise resolving to:\n   *   - transcript: Full transcript string\n   *   - words: Array of word objects with timing and confidence\n   *   - raw: Complete Deepgram API response\n   *   - speakerSegments: (when diarize=true) Array of {word, speaker, start, end}\n   */\n  async listen(\n    audioStream: NodeJS.ReadableStream,\n    options?: {\n      diarize?: boolean;\n      [key: string]: any;\n    },\n  ): Promise<any> {\n    if (!this.listeningClient) {\n      throw new Error('Deepgram listening client not configured');\n    }\n\n    const chunks: Buffer[] = [];\n    for await (const chunk of audioStream) {\n      if (typeof chunk === 'string') {\n        chunks.push(Buffer.from(chunk));\n      } else {\n        chunks.push(chunk);\n      }\n    }\n    const buffer = Buffer.concat(chunks);\n    const { diarize, diarize_speaker_count: _, ...restOptions } = options ?? {};\n    const { result, error } = await this.listeningClient.listen.prerecorded.transcribeFile(buffer, {\n      ...restOptions,\n      model: this.storedListeningModel?.name,\n      diarize,\n    });\n    if (error) {\n      throw error;\n    }\n\n    const channel = result.results?.channels?.[0];\n    const alt:\n      | {\n          transcript?: string;\n          words?: DeepgramWord[];\n        }\n      | undefined = channel?.alternatives?.[0];\n\n    if (!alt) {\n      return {\n        transcript: '',\n        words: [],\n        raw: result,\n      };\n    }\n\n    const response: any = {\n      transcript: alt.transcript,\n      words: alt.words,\n      raw: result,\n    };\n\n    if (diarize && alt.words) {\n      response.speakerSegments = alt.words.map((w: DeepgramWord) => ({\n        word: w.word,\n        speaker: w.speaker,\n        start: w.start,\n        end: w.end,\n      }));\n    }\n\n    return response;\n  }\n}\n\nexport type { DeepgramVoiceConfig, DeepgramVoiceId, DeepgramModel };\n"]}

package/dist/index.d.ts

@@ -9,6 +9,9 @@ interface DeepgramVoiceConfig {
 export declare class DeepgramVoice extends MastraVoice {
     private speechClient?;
     private listeningClient?;
+    private storedSpeechModel?;
+    private storedListeningModel?;
+    private storedSpeaker?;
     constructor({ speechModel, listeningModel, speaker, }?: {
         speechModel?: DeepgramVoiceConfig;
         listeningModel?: DeepgramVoiceConfig;
@@ -29,9 +32,21 @@ export declare class DeepgramVoice extends MastraVoice {
     getListener(): Promise<{
         enabled: boolean;
     }>;
+    /**
+     * Transcribes audio with optional speaker diarization.
+     *
+     * @param audioStream - Audio input stream
+     * @param options - Transcription options (diarize, language, etc.)
+     * @returns Promise resolving to:
+     *   - transcript: Full transcript string
+     *   - words: Array of word objects with timing and confidence
+     *   - raw: Complete Deepgram API response
+     *   - speakerSegments: (when diarize=true) Array of {word, speaker, start, end}
+     */
     listen(audioStream: NodeJS.ReadableStream, options?: {
+        diarize?: boolean;
         [key: string]: any;
-    }): Promise<string>;
+    }): Promise<any>;
 }
 export type { DeepgramVoiceConfig, DeepgramVoiceId, DeepgramModel };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE/D,UAAU,mBAAmB;IAC3B,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,aAAc,SAAQ,WAAW;IAC5C,OAAO,CAAC,YAAY,CAAC,CAAkC;IACvD,OAAO,CAAC,eAAe,CAAC,CAAkC;gBAE9C,EACV,WAAW,EACX,cAAc,EACd,OAAO,GACR,GAAE;QAAE,WAAW,CAAC,EAAE,mBAAmB,CAAC;QAAC,cAAc,CAAC,EAAE,mBAAmB,CAAC;QAAC,OAAO,CAAC,EAAE,eAAe,CAAA;KAAO;IA0CxG,WAAW;;;IAMX,KAAK,CACT,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,cAAc,EACrC,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,GACA,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;IAyEjC;;;;OAIG;IACG,WAAW;;;IAIX,MAAM,CACV,WAAW,EAAE,MAAM,CAAC,cAAc,EAClC,OAAO,CAAC,EAAE;QACR,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,GACA,OAAO,CAAC,MAAM,CAAC;CAkCnB;AAED,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE/D,UAAU,mBAAmB;IAC3B,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAUD,qBAAa,aAAc,SAAQ,WAAW;IAC5C,OAAO,CAAC,YAAY,CAAC,CAAkC;IACvD,OAAO,CAAC,eAAe,CAAC,CAAkC;IAC1D,OAAO,CAAC,iBAAiB,CAAC,CAA2C;IACrE,OAAO,CAAC,oBAAoB,CAAC,CAA2C;IACxE,OAAO,CAAC,aAAa,CAAC,CAAkB;gBAE5B,EACV,WAAW,EACX,cAAc,EACd,OAAO,GACR,GAAE;QAAE,WAAW,CAAC,EAAE,mBAAmB,CAAC;QAAC,cAAc,CAAC,EAAE,mBAAmB,CAAC;QAAC,OAAO,CAAC,EAAE,eAAe,CAAA;KAAO;IAmDxG,WAAW;;;IAMX,KAAK,CACT,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,cAAc,EACrC,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,GACA,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;IAwEjC;;;;OAIG;IACG,WAAW;;;IAIjB;;;;;;;;;;OAUG;IACG,MAAM,CACV,WAAW,EAAE,MAAM,CAAC,cAAc,EAClC,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,GACA,OAAO,CAAC,GAAG,CAAC;CAyDhB;AAED,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC"}

package/dist/index.js

@@ -24,6 +24,9 @@ var DEEPGRAM_VOICES = [
 var DeepgramVoice = class extends MastraVoice {
   speechClient;
   listeningClient;
+  storedSpeechModel;
+  storedListeningModel;
+  storedSpeaker;
   constructor({
     speechModel,
     listeningModel,
@@ -49,6 +52,14 @@ var DeepgramVoice = class extends MastraVoice {
       },
       speaker
     });
+    this.storedSpeechModel = {
+      name: speechModel?.name ?? defaultSpeechModel.name,
+      apiKey: speechModel?.apiKey ?? defaultSpeechModel.apiKey
+    };
+    this.storedListeningModel = {
+      name: listeningModel?.name ?? defaultListeningModel.name,
+      apiKey: listeningModel?.apiKey ?? defaultListeningModel.apiKey
+    };
     const speechApiKey = speechModel?.apiKey || defaultApiKey;
     const listeningApiKey = listeningModel?.apiKey || defaultApiKey;
     if (!speechApiKey && !listeningApiKey) {
@@ -60,7 +71,7 @@ var DeepgramVoice = class extends MastraVoice {
     if (listeningApiKey) {
       this.listeningClient = createClient(listeningApiKey);
     }
-    this.speaker = speaker || "asteria-en";
+    this.storedSpeaker = speaker || "asteria-en";
   }
   async getSpeakers() {
     return DEEPGRAM_VOICES.map((voice) => ({
@@ -88,21 +99,15 @@ var DeepgramVoice = class extends MastraVoice {
     if (text.trim().length === 0) {
       throw new Error("Input text is empty");
     }
-    if (!this.speechClient) {
-      throw new Error("No speech client configured");
-    }
-    let model;
-    if (options?.speaker) {
-      model = this.speechModel?.name + "-" + options.speaker;
-    } else if (this.speaker) {
-      model = this.speechModel?.name + "-" + this.speaker;
-    }
+    const baseModel = this.storedSpeechModel?.name;
+    const speakerId = options?.speaker || this.storedSpeaker;
+    const modelName = baseModel && speakerId ? speakerId.startsWith(`${baseModel}-`) ? speakerId : `${baseModel}-${speakerId}` : baseModel || speakerId;
     const speakClient = this.speechClient.speak;
     const response = await speakClient.request(
       { text },
       {
-        model,
-        ...options
+        model: modelName,
+        ...Object.fromEntries(Object.entries(options ?? {}).filter(([k]) => k !== "speaker"))
       }
     );
     const webStream = await response.getStream();
@@ -137,6 +142,17 @@ var DeepgramVoice = class extends MastraVoice {
   async getListener() {
     return { enabled: true };
   }
+  /**
+   * Transcribes audio with optional speaker diarization.
+   *
+   * @param audioStream - Audio input stream
+   * @param options - Transcription options (diarize, language, etc.)
+   * @returns Promise resolving to:
+   *   - transcript: Full transcript string
+   *   - words: Array of word objects with timing and confidence
+   *   - raw: Complete Deepgram API response
+   *   - speakerSegments: (when diarize=true) Array of {word, speaker, start, end}
+   */
   async listen(audioStream, options) {
     if (!this.listeningClient) {
       throw new Error("Deepgram listening client not configured");
@@ -150,21 +166,38 @@ var DeepgramVoice = class extends MastraVoice {
       }
     }
     const buffer = Buffer.concat(chunks);
-    if (!this.listeningClient) {
-      throw new Error("No listening client configured");
-    }
+    const { diarize, diarize_speaker_count: _, ...restOptions } = options ?? {};
     const { result, error } = await this.listeningClient.listen.prerecorded.transcribeFile(buffer, {
-      model: this.listeningModel?.name,
-      ...options
+      ...restOptions,
+      model: this.storedListeningModel?.name,
+      diarize
     });
     if (error) {
       throw error;
     }
-    const transcript = result.results?.channels?.[0]?.alternatives?.[0]?.transcript;
-    if (!transcript) {
-      throw new Error("No transcript found in Deepgram response");
+    const channel = result.results?.channels?.[0];
+    const alt = channel?.alternatives?.[0];
+    if (!alt) {
+      return {
+        transcript: "",
+        words: [],
+        raw: result
+      };
+    }
+    const response = {
+      transcript: alt.transcript,
+      words: alt.words,
+      raw: result
+    };
+    if (diarize && alt.words) {
+      response.speakerSegments = alt.words.map((w) => ({
+        word: w.word,
+        speaker: w.speaker,
+        start: w.start,
+        end: w.end
+      }));
     }
-    return transcript;
+    return response;
   }
 };
 

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/voices.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * List of available Deepgram voice models for text-to-speech\n * Each voice is designed for specific use cases and languages\n * Format: {name}-{language} (e.g. asteria-en)\n */\nexport const DEEPGRAM_VOICES = [\n  'asteria-en',\n  'luna-en',\n  'stella-en',\n  'athena-en',\n  'hera-en',\n  'orion-en',\n  'arcas-en',\n  'perseus-en',\n  'angus-en',\n  'orpheus-en',\n  'helios-en',\n  'zeus-en',\n] as const;\n\nexport type DeepgramVoiceId = (typeof DEEPGRAM_VOICES)[number];\n\n/**\n * List of available Deepgram models for text-to-speech and speech-to-text\n */\nexport const DEEPGRAM_MODELS = ['aura', 'whisper', 'base', 'enhanced', 'nova', 'nova-2', 'nova-3'] as const;\n\nexport type DeepgramModel = (typeof DEEPGRAM_MODELS)[number];\n","import { PassThrough } from 'stream';\n\nimport { createClient } from '@deepgram/sdk';\nimport { MastraVoice } from '@mastra/core/voice';\n\nimport { DEEPGRAM_VOICES } from './voices';\nimport type { DeepgramVoiceId, DeepgramModel } from './voices';\n\ninterface DeepgramVoiceConfig {\n  name?: DeepgramModel;\n  apiKey?: string;\n  properties?: Record<string, any>;\n  language?: string;\n}\n\nexport class DeepgramVoice extends MastraVoice {\n  private speechClient?: ReturnType<typeof createClient>;\n  private listeningClient?: ReturnType<typeof createClient>;\n\n  constructor({\n    speechModel,\n    listeningModel,\n    speaker,\n  }: { speechModel?: DeepgramVoiceConfig; listeningModel?: DeepgramVoiceConfig; speaker?: DeepgramVoiceId } = {}) {\n    const defaultApiKey = process.env.DEEPGRAM_API_KEY;\n\n    const defaultSpeechModel = {\n      name: 'aura',\n      apiKey: defaultApiKey,\n    };\n\n    const defaultListeningModel = {\n      name: 'nova',\n      apiKey: defaultApiKey,\n    };\n\n    super({\n      speechModel: {\n        name: speechModel?.name ?? defaultSpeechModel.name,\n        apiKey: speechModel?.apiKey ?? defaultSpeechModel.apiKey,\n      },\n      listeningModel: {\n        name: listeningModel?.name ?? defaultListeningModel.name,\n        apiKey: listeningModel?.apiKey ?? defaultListeningModel.apiKey,\n      },\n      speaker,\n    });\n\n    const speechApiKey = speechModel?.apiKey || defaultApiKey;\n    const listeningApiKey = listeningModel?.apiKey || defaultApiKey;\n\n    if (!speechApiKey && !listeningApiKey) {\n      throw new Error('At least one of DEEPGRAM_API_KEY, speechModel.apiKey, or listeningModel.apiKey must be set');\n    }\n\n    if (speechApiKey) {\n      this.speechClient = createClient(speechApiKey);\n    }\n    if (listeningApiKey) {\n      this.listeningClient = createClient(listeningApiKey);\n    }\n\n    this.speaker = speaker || 'asteria-en';\n  }\n\n  async getSpeakers() {\n    return DEEPGRAM_VOICES.map(voice => ({\n      voiceId: voice,\n    }));\n  }\n\n  async speak(\n    input: string | NodeJS.ReadableStream,\n    options?: {\n      speaker?: string;\n      [key: string]: any;\n    },\n  ): Promise<NodeJS.ReadableStream> {\n    if (!this.speechClient) {\n      throw new Error('Deepgram speech client not configured');\n    }\n\n    let text: string;\n    if (typeof input !== 'string') {\n      const chunks: Buffer[] = [];\n      for await (const chunk of input) {\n        if (typeof chunk === 'string') {\n          chunks.push(Buffer.from(chunk));\n        } else {\n          chunks.push(chunk);\n        }\n      }\n      text = Buffer.concat(chunks).toString('utf-8');\n    } else {\n      text = input;\n    }\n\n    if (text.trim().length === 0) {\n      throw new Error('Input text is empty');\n    }\n\n    if (!this.speechClient) {\n      throw new Error('No speech client configured');\n    }\n\n    let model;\n    if (options?.speaker) {\n      model = this.speechModel?.name + '-' + options.speaker;\n    } else if (this.speaker) {\n      model = this.speechModel?.name + '-' + this.speaker;\n    }\n\n    const speakClient = this.speechClient.speak;\n    const response = await speakClient.request(\n      { text },\n      {\n        model,\n        ...options,\n      },\n    );\n\n    const webStream = await response.getStream();\n    if (!webStream) {\n      throw new Error('No stream returned from Deepgram');\n    }\n\n    const reader = webStream.getReader();\n    const nodeStream = new PassThrough();\n\n    // Add error handling for the stream processing\n    (async () => {\n      try {\n        while (true) {\n          const { done, value } = await reader.read();\n          if (done) {\n            nodeStream.end();\n            break;\n          }\n          nodeStream.write(value);\n        }\n      } catch (error) {\n        nodeStream.destroy(error as Error);\n      }\n    })().catch(error => {\n      nodeStream.destroy(error as Error);\n    });\n\n    return nodeStream;\n  }\n\n  /**\n   * Checks if listening capabilities are enabled.\n   *\n   * @returns {Promise<{ enabled: boolean }>}\n   */\n  async getListener() {\n    return { enabled: true };\n  }\n\n  async listen(\n    audioStream: NodeJS.ReadableStream,\n    options?: {\n      [key: string]: any;\n    },\n  ): Promise<string> {\n    if (!this.listeningClient) {\n      throw new Error('Deepgram listening client not configured');\n    }\n\n    const chunks: Buffer[] = [];\n    for await (const chunk of audioStream) {\n      if (typeof chunk === 'string') {\n        chunks.push(Buffer.from(chunk));\n      } else {\n        chunks.push(chunk);\n      }\n    }\n    const buffer = Buffer.concat(chunks);\n\n    if (!this.listeningClient) {\n      throw new Error('No listening client configured');\n    }\n    const { result, error } = await this.listeningClient.listen.prerecorded.transcribeFile(buffer, {\n      model: this.listeningModel?.name,\n      ...options,\n    });\n\n    if (error) {\n      throw error;\n    }\n\n    const transcript = result.results?.channels?.[0]?.alternatives?.[0]?.transcript;\n    if (!transcript) {\n      throw new Error('No transcript found in Deepgram response');\n    }\n\n    return transcript;\n  }\n}\n\nexport type { DeepgramVoiceConfig, DeepgramVoiceId, DeepgramModel };\n"]}
+{"version":3,"sources":["../src/voices.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * List of available Deepgram voice models for text-to-speech\n * Each voice is designed for specific use cases and languages\n * Format: {name}-{language} (e.g. asteria-en)\n */\nexport const DEEPGRAM_VOICES = [\n  'asteria-en',\n  'luna-en',\n  'stella-en',\n  'athena-en',\n  'hera-en',\n  'orion-en',\n  'arcas-en',\n  'perseus-en',\n  'angus-en',\n  'orpheus-en',\n  'helios-en',\n  'zeus-en',\n] as const;\n\nexport type DeepgramVoiceId = (typeof DEEPGRAM_VOICES)[number];\n\n/**\n * List of available Deepgram models for text-to-speech and speech-to-text\n */\nexport const DEEPGRAM_MODELS = ['aura', 'whisper', 'base', 'enhanced', 'nova', 'nova-2', 'nova-3'] as const;\n\nexport type DeepgramModel = (typeof DEEPGRAM_MODELS)[number];\n","import { PassThrough } from 'node:stream';\n\nimport { createClient } from '@deepgram/sdk';\nimport { MastraVoice } from '@mastra/core/voice';\n\nimport { DEEPGRAM_VOICES } from './voices';\nimport type { DeepgramVoiceId, DeepgramModel } from './voices';\n\ninterface DeepgramVoiceConfig {\n  name?: DeepgramModel;\n  apiKey?: string;\n  properties?: Record<string, any>;\n  language?: string;\n}\n\ninterface DeepgramWord {\n  word: string;\n  start?: number;\n  end?: number;\n  confidence?: number;\n  speaker?: number;\n}\n\nexport class DeepgramVoice extends MastraVoice {\n  private speechClient?: ReturnType<typeof createClient>;\n  private listeningClient?: ReturnType<typeof createClient>;\n  private storedSpeechModel?: { name: DeepgramModel; apiKey?: string };\n  private storedListeningModel?: { name: DeepgramModel; apiKey?: string };\n  private storedSpeaker?: DeepgramVoiceId;\n\n  constructor({\n    speechModel,\n    listeningModel,\n    speaker,\n  }: { speechModel?: DeepgramVoiceConfig; listeningModel?: DeepgramVoiceConfig; speaker?: DeepgramVoiceId } = {}) {\n    const defaultApiKey = process.env.DEEPGRAM_API_KEY;\n\n    const defaultSpeechModel: { name: DeepgramModel; apiKey?: string } = {\n      name: 'aura',\n      apiKey: defaultApiKey,\n    };\n\n    const defaultListeningModel: { name: DeepgramModel; apiKey?: string } = {\n      name: 'nova',\n      apiKey: defaultApiKey,\n    };\n\n    super({\n      speechModel: {\n        name: speechModel?.name ?? defaultSpeechModel.name,\n        apiKey: speechModel?.apiKey ?? defaultSpeechModel.apiKey,\n      },\n      listeningModel: {\n        name: listeningModel?.name ?? defaultListeningModel.name,\n        apiKey: listeningModel?.apiKey ?? defaultListeningModel.apiKey,\n      },\n      speaker,\n    });\n\n    this.storedSpeechModel = {\n      name: speechModel?.name ?? defaultSpeechModel.name,\n      apiKey: speechModel?.apiKey ?? defaultSpeechModel.apiKey,\n    };\n    this.storedListeningModel = {\n      name: listeningModel?.name ?? defaultListeningModel.name,\n      apiKey: listeningModel?.apiKey ?? defaultListeningModel.apiKey,\n    };\n\n    const speechApiKey = speechModel?.apiKey || defaultApiKey;\n    const listeningApiKey = listeningModel?.apiKey || defaultApiKey;\n\n    if (!speechApiKey && !listeningApiKey) {\n      throw new Error('At least one of DEEPGRAM_API_KEY, speechModel.apiKey, or listeningModel.apiKey must be set');\n    }\n\n    if (speechApiKey) {\n      this.speechClient = createClient(speechApiKey);\n    }\n    if (listeningApiKey) {\n      this.listeningClient = createClient(listeningApiKey);\n    }\n\n    this.storedSpeaker = speaker || 'asteria-en';\n  }\n\n  async getSpeakers() {\n    return DEEPGRAM_VOICES.map(voice => ({\n      voiceId: voice,\n    }));\n  }\n\n  async speak(\n    input: string | NodeJS.ReadableStream,\n    options?: {\n      speaker?: string;\n      [key: string]: any;\n    },\n  ): Promise<NodeJS.ReadableStream> {\n    if (!this.speechClient) {\n      throw new Error('Deepgram speech client not configured');\n    }\n\n    let text: string;\n    if (typeof input !== 'string') {\n      const chunks: Buffer[] = [];\n      for await (const chunk of input) {\n        if (typeof chunk === 'string') {\n          chunks.push(Buffer.from(chunk));\n        } else {\n          chunks.push(chunk);\n        }\n      }\n      text = Buffer.concat(chunks).toString('utf-8');\n    } else {\n      text = input;\n    }\n\n    if (text.trim().length === 0) {\n      throw new Error('Input text is empty');\n    }\n\n    const baseModel = this.storedSpeechModel?.name;\n    const speakerId = options?.speaker || this.storedSpeaker;\n\n    const modelName =\n      baseModel && speakerId\n        ? speakerId.startsWith(`${baseModel}-`)\n          ? speakerId\n          : `${baseModel}-${speakerId}`\n        : baseModel || speakerId;\n\n    const speakClient = this.speechClient.speak;\n    const response = await speakClient.request(\n      { text },\n      {\n        model: modelName,\n        ...Object.fromEntries(Object.entries(options ?? {}).filter(([k]) => k !== 'speaker')),\n      },\n    );\n\n    const webStream = await response.getStream();\n    if (!webStream) {\n      throw new Error('No stream returned from Deepgram');\n    }\n\n    const reader = webStream.getReader();\n    const nodeStream = new PassThrough();\n\n    // Add error handling for the stream processing\n    (async () => {\n      try {\n        while (true) {\n          const { done, value } = await reader.read();\n          if (done) {\n            nodeStream.end();\n            break;\n          }\n          nodeStream.write(value);\n        }\n      } catch (error) {\n        nodeStream.destroy(error as Error);\n      }\n    })().catch(error => {\n      nodeStream.destroy(error as Error);\n    });\n\n    return nodeStream;\n  }\n\n  /**\n   * Checks if listening capabilities are enabled.\n   *\n   * @returns {Promise<{ enabled: boolean }>}\n   */\n  async getListener() {\n    return { enabled: true };\n  }\n\n  /**\n   * Transcribes audio with optional speaker diarization.\n   *\n   * @param audioStream - Audio input stream\n   * @param options - Transcription options (diarize, language, etc.)\n   * @returns Promise resolving to:\n   *   - transcript: Full transcript string\n   *   - words: Array of word objects with timing and confidence\n   *   - raw: Complete Deepgram API response\n   *   - speakerSegments: (when diarize=true) Array of {word, speaker, start, end}\n   */\n  async listen(\n    audioStream: NodeJS.ReadableStream,\n    options?: {\n      diarize?: boolean;\n      [key: string]: any;\n    },\n  ): Promise<any> {\n    if (!this.listeningClient) {\n      throw new Error('Deepgram listening client not configured');\n    }\n\n    const chunks: Buffer[] = [];\n    for await (const chunk of audioStream) {\n      if (typeof chunk === 'string') {\n        chunks.push(Buffer.from(chunk));\n      } else {\n        chunks.push(chunk);\n      }\n    }\n    const buffer = Buffer.concat(chunks);\n    const { diarize, diarize_speaker_count: _, ...restOptions } = options ?? {};\n    const { result, error } = await this.listeningClient.listen.prerecorded.transcribeFile(buffer, {\n      ...restOptions,\n      model: this.storedListeningModel?.name,\n      diarize,\n    });\n    if (error) {\n      throw error;\n    }\n\n    const channel = result.results?.channels?.[0];\n    const alt:\n      | {\n          transcript?: string;\n          words?: DeepgramWord[];\n        }\n      | undefined = channel?.alternatives?.[0];\n\n    if (!alt) {\n      return {\n        transcript: '',\n        words: [],\n        raw: result,\n      };\n    }\n\n    const response: any = {\n      transcript: alt.transcript,\n      words: alt.words,\n      raw: result,\n    };\n\n    if (diarize && alt.words) {\n      response.speakerSegments = alt.words.map((w: DeepgramWord) => ({\n        word: w.word,\n        speaker: w.speaker,\n        start: w.start,\n        end: w.end,\n      }));\n    }\n\n    return response;\n  }\n}\n\nexport type { DeepgramVoiceConfig, DeepgramVoiceId, DeepgramModel };\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/voice-deepgram",
-  "version": "0.0.0-remove-unused-model-providers-api-20251030210744",
+  "version": "0.0.0-remove-ai-peer-dep-from-evals-20260105220639",
   "description": "Mastra Deepgram voice integration",
   "type": "module",
   "files": [
@@ -27,19 +27,20 @@
     "@deepgram/sdk": "^3.13.0"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.52.8",
-    "@types/node": "^20.19.0",
+    "@types/node": "22.13.17",
+    "@vitest/coverage-v8": "4.0.12",
+    "@vitest/ui": "4.0.12",
     "eslint": "^9.37.0",
     "tsup": "^8.5.0",
-    "typescript": "^5.8.3",
-    "vitest": "^3.2.4",
-    "@internal/lint": "0.0.0-remove-unused-model-providers-api-20251030210744",
-    "@internal/types-builder": "0.0.0-remove-unused-model-providers-api-20251030210744",
-    "@mastra/core": "0.0.0-remove-unused-model-providers-api-20251030210744"
+    "typescript": "^5.9.3",
+    "vitest": "4.0.16",
+    "@internal/lint": "0.0.0-remove-ai-peer-dep-from-evals-20260105220639",
+    "@mastra/core": "0.0.0-remove-ai-peer-dep-from-evals-20260105220639",
+    "@internal/types-builder": "0.0.0-remove-ai-peer-dep-from-evals-20260105220639"
   },
   "peerDependencies": {
     "zod": "^3.25.0 || ^4.0.0",
-    "@mastra/core": "0.0.0-remove-unused-model-providers-api-20251030210744"
+    "@mastra/core": "0.0.0-remove-ai-peer-dep-from-evals-20260105220639"
   },
   "homepage": "https://mastra.ai",
   "repository": {
@@ -50,8 +51,12 @@
   "bugs": {
     "url": "https://github.com/mastra-ai/mastra/issues"
   },
+  "engines": {
+    "node": ">=22.13.0"
+  },
   "scripts": {
     "build": "tsup --silent --config tsup.config.ts",
+    "postbuild": "pnpx tsx ../../scripts/generate-package-docs.ts voice/deepgram",
     "build:watch": "tsup --watch --silent --config tsup.config.ts",
     "test": "vitest run",
     "lint": "eslint ."