@mastra/voice-elevenlabs 0.1.1-alpha.1 → 0.1.1-alpha.3

package/.turbo/turbo-build.log

@@ -1,18 +1,23 @@
 
-> @mastra/voice-elevenlabs@0.1.1-alpha.1 build /home/runner/work/mastra/mastra/voice/elevenlabs
-> tsup src/index.ts --format esm --experimental-dts --clean --treeshake
+> @mastra/voice-elevenlabs@0.1.1-alpha.3 build /home/runner/work/mastra/mastra/voice/elevenlabs
+> tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake
 
 CLI Building entry: src/index.ts
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.3.6
 TSC Build start
-TSC ⚡️ Build success in 8591ms
+TSC ⚡️ Build success in 7812ms
 DTS Build start
 CLI Target: es2022
 Analysis will use the bundled TypeScript version 5.7.3
 Writing package typings: /home/runner/work/mastra/mastra/voice/elevenlabs/dist/_tsup-dts-rollup.d.ts
-DTS ⚡️ Build success in 5735ms
+Analysis will use the bundled TypeScript version 5.7.3
+Writing package typings: /home/runner/work/mastra/mastra/voice/elevenlabs/dist/_tsup-dts-rollup.d.cts
+DTS ⚡️ Build success in 8313ms
 CLI Cleaning output folder
 ESM Build start
+CJS Build start
 ESM dist/index.js 5.00 KB
-ESM ⚡️ Build success in 286ms
+ESM ⚡️ Build success in 582ms
+CJS dist/index.cjs 5.04 KB
+CJS ⚡️ Build success in 582ms

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @mastra/voice-elevenlabs
 
+## 0.1.1-alpha.3
+
+### Patch Changes
+
+- bb4f447: Add support for commonjs
+- Updated dependencies [0fd78ac]
+- Updated dependencies [0d25b75]
+- Updated dependencies [fd14a3f]
+- Updated dependencies [3f369a2]
+- Updated dependencies [4d4e1e1]
+- Updated dependencies [bb4f447]
+  - @mastra/core@0.4.3-alpha.3
+
+## 0.1.1-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [2512a93]
+- Updated dependencies [e62de74]
+  - @mastra/core@0.4.3-alpha.2
+
 ## 0.1.1-alpha.1
 
 ### Patch Changes

package/dist/_tsup-dts-rollup.d.cts

@@ -0,0 +1,90 @@
+import { MastraVoice } from '@mastra/core/voice';
+
+declare type ElevenLabsListenOptions = SpeechToTextOptions & RequestOptions;
+
+declare type ElevenLabsModel = 'eleven_multilingual_v2' | 'eleven_flash_v2_5' | 'eleven_flash_v2' | 'eleven_multilingual_sts_v2' | 'eleven_english_sts_v2' | 'scribe_v1';
+
+export declare class ElevenLabsVoice extends MastraVoice {
+    private client;
+    /**
+     * Creates an instance of the ElevenLabsVoice class.
+     *
+     * @param {Object} options - The options for the voice configuration.
+     * @param {ElevenLabsVoiceConfig} [options.speechModel] - The configuration for the speech model, including the model name and API key.
+     * @param {string} [options.speaker] - The ID of the speaker to use. If not provided, a default speaker will be used.
+     *
+     * @throws {Error} If the ELEVENLABS_API_KEY is not set in the environment variables.
+     */
+    constructor({ speechModel, listeningModel, speaker, }?: {
+        speechModel?: ElevenLabsVoiceConfig;
+        listeningModel?: ElevenLabsVoiceConfig;
+        speaker?: string;
+    });
+    /**
+     * Retrieves a list of available speakers from the Eleven Labs API.
+     * Each speaker includes their ID, name, language, and gender.
+     *
+     * @returns {Promise<Array<{ voiceId: string, name: string, language: string, gender: string }>>}
+     * A promise that resolves to an array of speaker objects.
+     */
+    getSpeakers(): Promise<{
+        voiceId: string;
+        name: string | undefined;
+        language: string;
+        gender: string;
+    }[]>;
+    private streamToString;
+    /**
+     * Converts text or audio input into speech using the Eleven Labs API.
+     *
+     * @param {string | NodeJS.ReadableStream} input - The text to be converted to speech or a stream containing audio data.
+     * @param {Object} [options] - Optional parameters for the speech generation.
+     * @param {string} [options.speaker] - The ID of the speaker to use for the speech. If not provided, the default speaker will be used.
+     *
+     * @returns {Promise<NodeJS.ReadableStream>} A promise that resolves to a readable stream of the generated speech.
+     *
+     * @throws {Error} If no speaker is specified or if no speech model is set.
+     */
+    speak(input: string | NodeJS.ReadableStream, options?: {
+        speaker?: string;
+    }): Promise<NodeJS.ReadableStream>;
+    /**
+     * Converts audio input to text using ElevenLabs Speech-to-Text API.
+     *
+     * @param input - A readable stream containing the audio data to transcribe
+     * @param options - Configuration options for the transcription
+     * @param options.language_code - ISO language code (e.g., 'en', 'fr', 'es')
+     * @param options.tag_audio_events - Whether to tag audio events like [MUSIC], [LAUGHTER], etc.
+     * @param options.num_speakers - Number of speakers to detect in the audio
+     * @param options.filetype - Audio file format (e.g., 'mp3', 'wav', 'ogg')
+     * @param options.timeoutInSeconds - Request timeout in seconds
+     * @param options.maxRetries - Maximum number of retry attempts
+     * @param options.abortSignal - Signal to abort the request
+     *
+     * @returns A Promise that resolves to the transcribed text
+     *
+     */
+    listen(input: NodeJS.ReadableStream, options?: ElevenLabsListenOptions): Promise<string>;
+}
+
+declare interface ElevenLabsVoiceConfig {
+    name?: ElevenLabsModel;
+    apiKey?: string;
+}
+
+declare interface RequestOptions {
+    timeoutInSeconds?: number;
+    maxRetries?: number;
+    abortSignal?: AbortSignal;
+    apiKey?: string | undefined;
+    headers?: Record<string, string>;
+}
+
+declare interface SpeechToTextOptions {
+    language_code?: string;
+    tag_audio_events?: boolean;
+    num_speakers?: number;
+    filetype?: string;
+}
+
+export { }

package/dist/index.cjs

@@ -0,0 +1,141 @@
+'use strict';
+
+var buffer = require('buffer');
+var voice = require('@mastra/core/voice');
+var elevenlabs = require('elevenlabs');
+
+// src/index.ts
+var ElevenLabsVoice = class extends voice.MastraVoice {
+  client;
+  /**
+   * Creates an instance of the ElevenLabsVoice class.
+   *
+   * @param {Object} options - The options for the voice configuration.
+   * @param {ElevenLabsVoiceConfig} [options.speechModel] - The configuration for the speech model, including the model name and API key.
+   * @param {string} [options.speaker] - The ID of the speaker to use. If not provided, a default speaker will be used.
+   *
+   * @throws {Error} If the ELEVENLABS_API_KEY is not set in the environment variables.
+   */
+  constructor({
+    speechModel,
+    listeningModel,
+    speaker
+  } = {}) {
+    const apiKey = speechModel?.apiKey ?? process.env.ELEVENLABS_API_KEY;
+    super({
+      speechModel: {
+        name: speechModel?.name ?? "eleven_multilingual_v2",
+        apiKey: speechModel?.apiKey
+      },
+      listeningModel: {
+        name: listeningModel?.name ?? "scribe_v1",
+        apiKey: listeningModel?.apiKey
+      },
+      speaker
+    });
+    if (!apiKey) {
+      throw new Error("ELEVENLABS_API_KEY is not set");
+    }
+    this.client = new elevenlabs.ElevenLabsClient({
+      apiKey
+    });
+    this.speaker = speaker || "9BWtsMINqrJLrRacOk9x";
+  }
+  /**
+   * Retrieves a list of available speakers from the Eleven Labs API.
+   * Each speaker includes their ID, name, language, and gender.
+   *
+   * @returns {Promise<Array<{ voiceId: string, name: string, language: string, gender: string }>>}
+   * A promise that resolves to an array of speaker objects.
+   */
+  async getSpeakers() {
+    const res = await this.traced(async () => {
+      const voices = await this.client.voices.getAll();
+      return voices?.voices?.map((voice) => ({
+        voiceId: voice.voice_id,
+        name: voice.name,
+        language: voice.labels?.language || "en",
+        gender: voice.labels?.gender || "neutral"
+      })) ?? [];
+    }, "voice.elevenlabs.voices")();
+    return res;
+  }
+  async streamToString(stream) {
+    const chunks = [];
+    for await (const chunk of stream) {
+      chunks.push(Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks).toString("utf-8");
+  }
+  /**
+   * Converts text or audio input into speech using the Eleven Labs API.
+   *
+   * @param {string | NodeJS.ReadableStream} input - The text to be converted to speech or a stream containing audio data.
+   * @param {Object} [options] - Optional parameters for the speech generation.
+   * @param {string} [options.speaker] - The ID of the speaker to use for the speech. If not provided, the default speaker will be used.
+   *
+   * @returns {Promise<NodeJS.ReadableStream>} A promise that resolves to a readable stream of the generated speech.
+   *
+   * @throws {Error} If no speaker is specified or if no speech model is set.
+   */
+  async speak(input, options) {
+    const speaker = options?.speaker || this.speaker;
+    if (!speaker) {
+      throw new Error("No speaker specified");
+    }
+    if (!this.speechModel?.name) {
+      throw new Error("No speech model specified");
+    }
+    const text = typeof input === "string" ? input : await this.streamToString(input);
+    const res = await this.traced(async () => {
+      return await this.client.generate({
+        text,
+        voice: speaker,
+        model_id: this.speechModel?.name,
+        stream: true
+      });
+    }, "voice.elevenlabs.speak")();
+    return res;
+  }
+  /**
+   * Converts audio input to text using ElevenLabs Speech-to-Text API.
+   *
+   * @param input - A readable stream containing the audio data to transcribe
+   * @param options - Configuration options for the transcription
+   * @param options.language_code - ISO language code (e.g., 'en', 'fr', 'es')
+   * @param options.tag_audio_events - Whether to tag audio events like [MUSIC], [LAUGHTER], etc.
+   * @param options.num_speakers - Number of speakers to detect in the audio
+   * @param options.filetype - Audio file format (e.g., 'mp3', 'wav', 'ogg')
+   * @param options.timeoutInSeconds - Request timeout in seconds
+   * @param options.maxRetries - Maximum number of retry attempts
+   * @param options.abortSignal - Signal to abort the request
+   *
+   * @returns A Promise that resolves to the transcribed text
+   *
+   */
+  async listen(input, options) {
+    const res = await this.traced(async () => {
+      const chunks = [];
+      for await (const chunk of input) {
+        chunks.push(Buffer.from(chunk));
+      }
+      const buffer$1 = Buffer.concat(chunks);
+      const { language_code, tag_audio_events, num_speakers, filetype, ...requestOptions } = options || {};
+      const file = new buffer.File([buffer$1], `audio.${filetype || "mp3"}`);
+      const transcription = await this.client.speechToText.convert(
+        {
+          file,
+          model_id: this.listeningModel?.name,
+          language_code,
+          tag_audio_events,
+          num_speakers
+        },
+        requestOptions
+      );
+      return transcription.text;
+    }, "voice.elevenlabs.listen")();
+    return res;
+  }
+};
+
+exports.ElevenLabsVoice = ElevenLabsVoice;

package/dist/index.d.cts

@@ -0,0 +1 @@
+export { ElevenLabsVoice } from './_tsup-dts-rollup.cjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/voice-elevenlabs",
-  "version": "0.1.1-alpha.1",
+  "version": "0.1.1-alpha.3",
   "description": "Mastra ElevenLabs voice integration",
   "type": "module",
   "main": "dist/index.js",
@@ -10,6 +10,10 @@
       "import": {
         "types": "./dist/index.d.ts",
         "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
       }
     },
     "./package.json": "./package.json"
@@ -17,7 +21,7 @@
   "dependencies": {
     "elevenlabs": "^1.50.2",
     "zod": "^3.24.1",
-    "@mastra/core": "^0.4.3-alpha.1"
+    "@mastra/core": "^0.4.3-alpha.3"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.49.2",
@@ -29,7 +33,7 @@
     "@internal/lint": "0.0.0"
   },
   "scripts": {
-    "build": "tsup src/index.ts --format esm --experimental-dts --clean --treeshake",
+    "build": "tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake",
     "build:watch": "tsup build --watch",
     "test": "vitest run",
     "lint": "eslint ."