@mastra/voice-modelslab 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @mastra/voice-modelslab
+
+## 0.1.0
+
+### Minor Changes
+
+- Initial release: ModelsLab TTS voice provider for Mastra

package/LICENSE.md

@@ -0,0 +1,30 @@
+Portions of this software are licensed as follows:
+
+- All content that resides under any directory named "ee/" within this
+  repository, including but not limited to:
+  - `packages/core/src/auth/ee/`
+  - `packages/server/src/server/auth/ee/`
+    is licensed under the license defined in `ee/LICENSE`.
+
+- All third-party components incorporated into the Mastra Software are
+  licensed under the original license provided by the owner of the
+  applicable component.
+
+- Content outside of the above-mentioned directories or restrictions is
+  available under the "Apache License 2.0" as defined below.
+
+# Apache License 2.0
+
+Copyright (c) 2025 Kepler Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,58 @@
+# @mastra/voice-modelslab
+
+[ModelsLab](https://modelslab.com) voice integration for Mastra. Provides text-to-speech using ModelsLab's TTS API.
+
+## Installation
+
+```bash
+npm install @mastra/voice-modelslab
+```
+
+## Usage
+
+```typescript
+import { ModelsLabVoice } from '@mastra/voice-modelslab';
+
+const voice = new ModelsLabVoice({
+  speechModel: {
+    apiKey: process.env.MODELSLAB_API_KEY,
+  },
+  speaker: '5', // Female voice
+});
+
+// Text to speech
+const audioStream = await voice.speak('Hello, world!', {
+  speaker: 'nova', // OpenAI-style voices also work: alloy, echo, fable, onyx, nova, shimmer
+  language: 'english',
+  speed: 1.0,
+});
+
+// List available voices
+const speakers = await voice.getSpeakers();
+```
+
+## Configuration
+
+| Option               | Type     | Default                 | Description                                 |
+| -------------------- | -------- | ----------------------- | ------------------------------------------- |
+| `speechModel.apiKey` | `string` | `MODELSLAB_API_KEY` env | ModelsLab API key                           |
+| `speaker`            | `string` | `'1'`                   | Default voice ID (1–6) or OpenAI voice name |
+
+## Voice IDs
+
+| ID  | Name         | Gender  |
+| --- | ------------ | ------- |
+| 1   | Neutral      | neutral |
+| 2   | Male         | male    |
+| 3   | Warm         | male    |
+| 4   | Deep Male    | male    |
+| 5   | Female       | female  |
+| 6   | Clear Female | female  |
+
+OpenAI voice names are also accepted: `alloy`, `echo`, `fable`, `onyx`, `nova`, `shimmer`.
+
+## API Reference
+
+See [ModelsLab TTS docs](https://docs.modelslab.com) for full API details.
+
+ModelsLab uses key-in-body authentication (`MODELSLAB_API_KEY`) and asynchronous audio generation with polling.

package/dist/index.cjs

@@ -0,0 +1,161 @@
+'use strict';
+
+var stream = require('stream');
+var voice = require('@mastra/core/voice');
+
+// src/index.ts
+var MODELSLAB_TTS_URL = "https://modelslab.com/api/v6/voice/text_to_speech";
+var MODELSLAB_TTS_FETCH_URL = "https://modelslab.com/api/v6/voice/fetch/";
+var POLL_INTERVAL_MS = 5e3;
+var POLL_TIMEOUT_MS = 3e5;
+var MODELSLAB_VOICES = [
+  { voiceId: "1", name: "Neutral", language: "en", gender: "neutral" },
+  { voiceId: "2", name: "Male", language: "en", gender: "male" },
+  { voiceId: "3", name: "Warm", language: "en", gender: "male" },
+  { voiceId: "4", name: "Deep Male", language: "en", gender: "male" },
+  { voiceId: "5", name: "Female", language: "en", gender: "female" },
+  { voiceId: "6", name: "Clear Female", language: "en", gender: "female" }
+];
+var OPENAI_VOICE_MAP = {
+  alloy: "1",
+  echo: "2",
+  fable: "3",
+  onyx: "4",
+  nova: "5",
+  shimmer: "6"
+};
+async function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+var ModelsLabVoice = class extends voice.MastraVoice {
+  apiKey;
+  constructor({
+    speechModel,
+    speaker
+  } = {}) {
+    const apiKey = speechModel?.apiKey ?? process.env.MODELSLAB_API_KEY;
+    super({
+      speechModel: {
+        name: speechModel?.name ?? "default",
+        apiKey
+      },
+      speaker: speaker ?? "1"
+    });
+    if (!apiKey) {
+      throw new Error("MODELSLAB_API_KEY is not set");
+    }
+    this.apiKey = apiKey;
+  }
+  /**
+   * Returns available ModelsLab voices.
+   */
+  async getSpeakers() {
+    return MODELSLAB_VOICES;
+  }
+  /**
+   * Converts text to speech using the ModelsLab TTS API.
+   *
+   * ModelsLab returns an audio URL (not a stream). This method:
+   * 1. POSTs to the TTS endpoint
+   * 2. If processing, polls until the audio URL is ready
+   * 3. Downloads the audio and returns a Readable stream
+   *
+   * @param input - Text to convert to speech
+   * @param options - Optional parameters
+   * @param options.speaker - ModelsLab voice ID (1–10) or OpenAI voice name (alloy, echo, etc.)
+   * @param options.language - Language code (default: 'english')
+   * @param options.speed - Speech speed (0.5–2.0, default: 1.0)
+   * @returns A Promise resolving to a Readable audio stream
+   */
+  async speak(input, options) {
+    const text = typeof input === "string" ? input : await this.streamToString(input);
+    const rawSpeaker = options?.speaker ?? this.speaker ?? "1";
+    const voiceId = OPENAI_VOICE_MAP[rawSpeaker] ?? rawSpeaker;
+    const body = {
+      key: this.apiKey,
+      prompt: text,
+      language: options?.language ?? "english",
+      voice_id: parseInt(voiceId, 10) || 1,
+      speed: options?.speed ?? 1
+    };
+    const initResp = await fetch(MODELSLAB_TTS_URL, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    if (!initResp.ok) {
+      throw new Error(`ModelsLab TTS failed: ${initResp.status} ${initResp.statusText}`);
+    }
+    let data = await initResp.json();
+    if (data.status === "error") {
+      throw new Error(`ModelsLab TTS error: ${data.message ?? "Unknown error"}`);
+    }
+    if (data.status === "processing") {
+      const requestId = String(data.request_id ?? "");
+      if (!requestId) {
+        throw new Error("ModelsLab TTS returned processing status without request_id");
+      }
+      data = await this.pollUntilReady(requestId);
+    }
+    const audioUrl = data.output;
+    if (!audioUrl) {
+      throw new Error("ModelsLab TTS returned no audio URL");
+    }
+    const audioResp = await fetch(audioUrl);
+    if (!audioResp.ok) {
+      throw new Error(`Failed to download ModelsLab audio: ${audioResp.status}`);
+    }
+    const audioBuffer = await audioResp.arrayBuffer();
+    const readable = new stream.Readable();
+    readable.push(Buffer.from(audioBuffer));
+    readable.push(null);
+    return readable;
+  }
+  /**
+   * ModelsLab does not provide speech-to-text. Throws NotImplemented.
+   */
+  async listen(_input, _options) {
+    throw new Error(
+      "ModelsLab does not support speech-to-text. Use a different provider for listening (e.g., @mastra/voice-deepgram)."
+    );
+  }
+  async pollUntilReady(requestId) {
+    const fetchUrl = `${MODELSLAB_TTS_FETCH_URL}${requestId}`;
+    const deadline = Date.now() + POLL_TIMEOUT_MS;
+    while (Date.now() < deadline) {
+      await sleep(POLL_INTERVAL_MS);
+      const resp = await fetch(fetchUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ key: this.apiKey })
+      });
+      if (!resp.ok) {
+        throw new Error(`ModelsLab TTS poll failed: ${resp.status}`);
+      }
+      const data = await resp.json();
+      if (data.status === "error") {
+        throw new Error(`ModelsLab TTS failed: ${data.message ?? "Unknown error"}`);
+      }
+      if (data.status === "success") {
+        return data;
+      }
+    }
+    throw new Error(`ModelsLab TTS timed out after ${POLL_TIMEOUT_MS / 1e3}s (request_id=${requestId})`);
+  }
+  async streamToString(stream) {
+    const chunks = [];
+    for await (const chunk of stream) {
+      if (typeof chunk === "string") {
+        chunks.push(Buffer.from(chunk));
+      } else {
+        chunks.push(chunk);
+      }
+    }
+    return Buffer.concat(chunks).toString("utf-8");
+  }
+};
+
+exports.MODELSLAB_VOICES = MODELSLAB_VOICES;
+exports.ModelsLabVoice = ModelsLabVoice;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["MastraVoice","Readable"],"mappings":";;;;;;AAIA,IAAM,iBAAA,GAAoB,mDAAA;AAC1B,IAAM,uBAAA,GAA0B,2CAAA;AAChC,IAAM,gBAAA,GAAmB,GAAA;AACzB,IAAM,eAAA,GAAkB,GAAA;AAYjB,IAAM,gBAAA,GAAoG;AAAA,EAC/G,EAAE,SAAS,GAAA,EAAK,IAAA,EAAM,WAAW,QAAA,EAAU,IAAA,EAAM,QAAQ,SAAA,EAAU;AAAA,EACnE,EAAE,SAAS,GAAA,EAAK,IAAA,EAAM,QAAQ,QAAA,EAAU,IAAA,EAAM,QAAQ,MAAA,EAAO;AAAA,EAC7D,EAAE,SAAS,GAAA,EAAK,IAAA,EAAM,QAAQ,QAAA,EAAU,IAAA,EAAM,QAAQ,MAAA,EAAO;AAAA,EAC7D,EAAE,SAAS,GAAA,EAAK,IAAA,EAAM,aAAa,QAAA,EAAU,IAAA,EAAM,QAAQ,MAAA,EAAO;AAAA,EAClE,EAAE,SAAS,GAAA,EAAK,IAAA,EAAM,UAAU,QAAA,EAAU,IAAA,EAAM,QAAQ,QAAA,EAAS;AAAA,EACjE,EAAE,SAAS,GAAA,EAAK,IAAA,EAAM,gBAAgB,QAAA,EAAU,IAAA,EAAM,QAAQ,QAAA;AAChE;AAGA,IAAM,gBAAA,GAAqD;AAAA,EACzD,KAAA,EAAO,GAAA;AAAA,EACP,IAAA,EAAM,GAAA;AAAA,EACN,KAAA,EAAO,GAAA;AAAA,EACP,IAAA,EAAM,GAAA;AAAA,EACN,IAAA,EAAM,GAAA;AAAA,EACN,OAAA,EAAS;AACX,CAAA;AAeA,eAAe,MAAM,EAAA,EAA2B;AAC9C,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAA,OAAA,KAAW,UAAA,CAAW,OAAA,EAAS,EAAE,CAAC,CAAA;AACvD;AAkBO,IAAM,cAAA,GAAN,cAA6BA,iBAAA,CAAY;AAAA,EACtC,MAAA;AAAA,EAER,WAAA,CAAY;AAAA,IACV,WAAA;AAAA,IACA;AAAA,GACF,GAGI,EAAC,EAAG;AACN,IAAA,MAAM,MAAA,GAAS,WAAA,EAAa,MAAA,IAAU,OAAA,CAAQ,GAAA,CAAI,iBAAA;AAElD,IAAA,KAAA,CAAM;AAAA,MACJ,WAAA,EAAa;AAAA,QACX,IAAA,EAAM,aAAa,IAAA,IAAQ,SAAA;AAAA,QAC3B;AAAA,OACF;AAAA,MACA,SAAS,OAAA,IAAW;AAAA,KACrB,CAAA;AAED,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,MAAM,IAAI,MAAM,8BAA8B,CAAA;AAAA,IAChD;AAEA,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,WAAA,GAA8F;AAClG,IAAA,OAAO,gBAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,MAAM,KAAA,CACJ,KAAA,EACA,OAAA,EAMgC;AAChC,IAAA,MAAM,IAAA,GAAO,OAAO,KAAA,KAAU,QAAA,GAAW,QAAQ,MAAM,IAAA,CAAK,eAAe,KAAK,CAAA;AAGhF,IAAA,MAAM,UAAA,GAAa,OAAA,EAAS,OAAA,IAAW,IAAA,CAAK,OAAA,IAAW,GAAA;AACvD,IAAA,MAAM,OAAA,GAAU,gBAAA,CAAiB,UAAU,CAAA,IAAK,UAAA;AAEhD,IAAA,MAAM,IAAA,GAAO;AAAA,MACX,KAAK,IAAA,CAAK,MAAA;AAAA,MACV,MAAA,EAAQ,IAAA;AAAA,MACR,QAAA,EAAU,SAAS,QAAA,IAAY,SAAA;AAAA,MAC/B,QAAA,EAAU,QAAA,CAAS,OAAA,EAAS,EAAE,CAAA,IAAK,CAAA;AAAA,MACnC,KAAA,EAAO,SAAS,KAAA,IAAS;AAAA,KAC3B;AAEA,IAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,iBAAA,EAAmB;AAAA,MAC9C,MAAA,EAAQ,MAAA;AAAA,MACR,OAAA,EAAS,EAAE,cAAA,EAAgB,kBAAA,EAAmB;AAAA,MAC9C,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,IAAI;AAAA,KAC1B,CAAA;AAED,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,MAAM,IAAI,MAAM,CAAA,sBAAA,EAAyB,QAAA,CAAS,MAAM,CAAA,CAAA,EAAI,QAAA,CAAS,UAAU,CAAA,CAAE,CAAA;AAAA,IACnF;AAEA,IAAA,IAAI,IAAA,GAAQ,MAAM,QAAA,CAAS,IAAA,EAAK;AAEhC,IAAA,IAAI,IAAA,CAAK,WAAW,OAAA,EAAS;AAC3B,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,qBAAA,EAAwB,IAAA,CAAK,OAAA,IAAW,eAAe,CAAA,CAAE,CAAA;AAAA,IAC3E;AAEA,IAAA,IAAI,IAAA,CAAK,WAAW,YAAA,EAAc;AAChC,MAAA,MAAM,SAAA,GAAY,MAAA,CAAO,IAAA,CAAK,UAAA,IAAc,EAAE,CAAA;AAC9C,MAAA,IAAI,CAAC,SAAA,EAAW;AACd,QAAA,MAAM,IAAI,MAAM,6DAA6D,CAAA;AAAA,MAC/E;AACA,MAAA,IAAA,GAAO,MAAM,IAAA,CAAK,cAAA,CAAe,SAAS,CAAA;AAAA,IAC5C;AAEA,IAAA,MAAM,WAAW,IAAA,CAAK,MAAA;AACtB,IAAA,IAAI,CAAC,QAAA,EAAU;AACb,MAAA,MAAM,IAAI,MAAM,qCAAqC,CAAA;AAAA,IACvD;AAGA,IAAA,MAAM,SAAA,GAAY,MAAM,KAAA,CAAM,QAAQ,CAAA;AACtC,IAAA,IAAI,CAAC,UAAU,EAAA,EAAI;AACjB,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,oCAAA,EAAuC,SAAA,CAAU,MAAM,CAAA,CAAE,CAAA;AAAA,IAC3E;AAEA,IAAA,MAAM,WAAA,GAAc,MAAM,SAAA,CAAU,WAAA,EAAY;AAChD,IAAA,MAAM,QAAA,GAAW,IAAIC,eAAA,EAAS;AAC9B,IAAA,QAAA,CAAS,IAAA,CAAK,MAAA,CAAO,IAAA,CAAK,WAAW,CAAC,CAAA;AACtC,IAAA,QAAA,CAAS,KAAK,IAAI,CAAA;AAElB,IAAA,OAAO,QAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,MAAA,CAAO,MAAA,EAA+B,QAAA,EAAqD;AAC/F,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AAAA,EAEA,MAAc,eAAe,SAAA,EAA4C;AACvE,IAAA,MAAM,QAAA,GAAW,CAAA,EAAG,uBAAuB,CAAA,EAAG,SAAS,CAAA,CAAA;AACvD,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,GAAA,EAAI,GAAI,eAAA;AAE9B,IAAA,OAAO,IAAA,CAAK,GAAA,EAAI,GAAI,QAAA,EAAU;AAC5B,MAAA,MAAM,MAAM,gBAAgB,CAAA;AAE5B,MAAA,MAAM,IAAA,GAAO,MAAM,KAAA,CAAM,QAAA,EAAU;AAAA,QACjC,MAAA,EAAQ,MAAA;AAAA,QACR,OAAA,EAAS,EAAE,cAAA,EAAgB,kBAAA,EAAmB;AAAA,QAC9C,MAAM,IAAA,CAAK,SAAA,CAAU,EAAE,GAAA,EAAK,IAAA,CAAK,QAAQ;AAAA,OAC1C,CAAA;AAED,MAAA,IAAI,CAAC,KAAK,EAAA,EAAI;AACZ,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,2BAAA,EAA8B,IAAA,CAAK,MAAM,CAAA,CAAE,CAAA;AAAA,MAC7D;AAEA,MAAA,MAAM,IAAA,GAAQ,MAAM,IAAA,CAAK,IAAA,EAAK;AAE9B,MAAA,IAAI,IAAA,CAAK,WAAW,OAAA,EAAS;AAC3B,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,sBAAA,EAAyB,IAAA,CAAK,OAAA,IAAW,eAAe,CAAA,CAAE,CAAA;AAAA,MAC5E;AAEA,MAAA,IAAI,IAAA,CAAK,WAAW,SAAA,EAAW;AAC7B,QAAA,OAAO,IAAA;AAAA,MACT;AAAA,IAEF;AAEA,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,8BAAA,EAAiC,kBAAkB,GAAI,CAAA,cAAA,EAAiB,SAAS,CAAA,CAAA,CAAG,CAAA;AAAA,EACtG;AAAA,EAEA,MAAc,eAAe,MAAA,EAAgD;AAC3E,IAAA,MAAM,SAAmB,EAAC;AAC1B,IAAA,WAAA,MAAiB,SAAS,MAAA,EAAQ;AAChC,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,KAAe,CAAA;AAAA,MAC7B;AAAA,IACF;AACA,IAAA,OAAO,MAAA,CAAO,MAAA,CAAO,MAAM,CAAA,CAAE,SAAS,OAAO,CAAA;AAAA,EAC/C;AACF","file":"index.cjs","sourcesContent":["import { Readable } from 'node:stream';\n\nimport { MastraVoice } from '@mastra/core/voice';\n\nconst MODELSLAB_TTS_URL = 'https://modelslab.com/api/v6/voice/text_to_speech';\nconst MODELSLAB_TTS_FETCH_URL = 'https://modelslab.com/api/v6/voice/fetch/';\nconst POLL_INTERVAL_MS = 5000;\nconst POLL_TIMEOUT_MS = 300_000;\n\ntype ModelsLabModel = 'default';\n\nexport type ModelsLabVoiceId =\n  | '1' // Neutral\n  | '2' // Male\n  | '3' // Warm\n  | '4' // Deep Male\n  | '5' // Female\n  | '6'; // Clear Female\n\nexport const MODELSLAB_VOICES: { voiceId: ModelsLabVoiceId; name: string; language: string; gender: string }[] = [\n  { voiceId: '1', name: 'Neutral', language: 'en', gender: 'neutral' },\n  { voiceId: '2', name: 'Male', language: 'en', gender: 'male' },\n  { voiceId: '3', name: 'Warm', language: 'en', gender: 'male' },\n  { voiceId: '4', name: 'Deep Male', language: 'en', gender: 'male' },\n  { voiceId: '5', name: 'Female', language: 'en', gender: 'female' },\n  { voiceId: '6', name: 'Clear Female', language: 'en', gender: 'female' },\n];\n\n// OpenAI voice → ModelsLab voice_id mapping\nconst OPENAI_VOICE_MAP: Record<string, ModelsLabVoiceId> = {\n  alloy: '1',\n  echo: '2',\n  fable: '3',\n  onyx: '4',\n  nova: '5',\n  shimmer: '6',\n};\n\ninterface ModelsLabVoiceConfig {\n  name?: ModelsLabModel;\n  apiKey?: string;\n}\n\ninterface TtsApiResponse {\n  status: 'success' | 'processing' | 'error';\n  output?: string;\n  request_id?: string | number;\n  eta?: number;\n  message?: string;\n}\n\nasync function sleep(ms: number): Promise<void> {\n  return new Promise(resolve => setTimeout(resolve, ms));\n}\n\n/**\n * ModelsLab voice provider for Mastra.\n *\n * Uses ModelsLab's TTS API with key-in-body authentication and async polling.\n * API docs: https://docs.modelslab.com\n *\n * @example\n * ```ts\n * const voice = new ModelsLabVoice({\n *   speechModel: { apiKey: process.env.MODELSLAB_API_KEY },\n *   speaker: '5', // Female voice\n * });\n *\n * const stream = await voice.speak('Hello, world!');\n * ```\n */\nexport class ModelsLabVoice extends MastraVoice {\n  private apiKey: string;\n\n  constructor({\n    speechModel,\n    speaker,\n  }: {\n    speechModel?: ModelsLabVoiceConfig;\n    speaker?: ModelsLabVoiceId | string;\n  } = {}) {\n    const apiKey = speechModel?.apiKey ?? process.env.MODELSLAB_API_KEY;\n\n    super({\n      speechModel: {\n        name: speechModel?.name ?? 'default',\n        apiKey,\n      },\n      speaker: speaker ?? '1',\n    });\n\n    if (!apiKey) {\n      throw new Error('MODELSLAB_API_KEY is not set');\n    }\n\n    this.apiKey = apiKey;\n  }\n\n  /**\n   * Returns available ModelsLab voices.\n   */\n  async getSpeakers(): Promise<{ voiceId: string; name: string; language: string; gender: string }[]> {\n    return MODELSLAB_VOICES;\n  }\n\n  /**\n   * Converts text to speech using the ModelsLab TTS API.\n   *\n   * ModelsLab returns an audio URL (not a stream). This method:\n   * 1. POSTs to the TTS endpoint\n   * 2. If processing, polls until the audio URL is ready\n   * 3. Downloads the audio and returns a Readable stream\n   *\n   * @param input - Text to convert to speech\n   * @param options - Optional parameters\n   * @param options.speaker - ModelsLab voice ID (1–10) or OpenAI voice name (alloy, echo, etc.)\n   * @param options.language - Language code (default: 'english')\n   * @param options.speed - Speech speed (0.5–2.0, default: 1.0)\n   * @returns A Promise resolving to a Readable audio stream\n   */\n  async speak(\n    input: string | NodeJS.ReadableStream,\n    options?: {\n      speaker?: ModelsLabVoiceId | string;\n      language?: string;\n      speed?: number;\n      [key: string]: unknown;\n    },\n  ): Promise<NodeJS.ReadableStream> {\n    const text = typeof input === 'string' ? input : await this.streamToString(input);\n\n    // Resolve voice_id: accept numeric ID or OpenAI-style voice name\n    const rawSpeaker = options?.speaker ?? this.speaker ?? '1';\n    const voiceId = OPENAI_VOICE_MAP[rawSpeaker] ?? rawSpeaker;\n\n    const body = {\n      key: this.apiKey,\n      prompt: text,\n      language: options?.language ?? 'english',\n      voice_id: parseInt(voiceId, 10) || 1,\n      speed: options?.speed ?? 1.0,\n    };\n\n    const initResp = await fetch(MODELSLAB_TTS_URL, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify(body),\n    });\n\n    if (!initResp.ok) {\n      throw new Error(`ModelsLab TTS failed: ${initResp.status} ${initResp.statusText}`);\n    }\n\n    let data = (await initResp.json()) as TtsApiResponse;\n\n    if (data.status === 'error') {\n      throw new Error(`ModelsLab TTS error: ${data.message ?? 'Unknown error'}`);\n    }\n\n    if (data.status === 'processing') {\n      const requestId = String(data.request_id ?? '');\n      if (!requestId) {\n        throw new Error('ModelsLab TTS returned processing status without request_id');\n      }\n      data = await this.pollUntilReady(requestId);\n    }\n\n    const audioUrl = data.output;\n    if (!audioUrl) {\n      throw new Error('ModelsLab TTS returned no audio URL');\n    }\n\n    // Download audio and return as Readable stream\n    const audioResp = await fetch(audioUrl);\n    if (!audioResp.ok) {\n      throw new Error(`Failed to download ModelsLab audio: ${audioResp.status}`);\n    }\n\n    const audioBuffer = await audioResp.arrayBuffer();\n    const readable = new Readable();\n    readable.push(Buffer.from(audioBuffer));\n    readable.push(null);\n\n    return readable;\n  }\n\n  /**\n   * ModelsLab does not provide speech-to-text. Throws NotImplemented.\n   */\n  async listen(_input: NodeJS.ReadableStream, _options?: Record<string, unknown>): Promise<string> {\n    throw new Error(\n      'ModelsLab does not support speech-to-text. Use a different provider for listening (e.g., @mastra/voice-deepgram).',\n    );\n  }\n\n  private async pollUntilReady(requestId: string): Promise<TtsApiResponse> {\n    const fetchUrl = `${MODELSLAB_TTS_FETCH_URL}${requestId}`;\n    const deadline = Date.now() + POLL_TIMEOUT_MS;\n\n    while (Date.now() < deadline) {\n      await sleep(POLL_INTERVAL_MS);\n\n      const resp = await fetch(fetchUrl, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({ key: this.apiKey }),\n      });\n\n      if (!resp.ok) {\n        throw new Error(`ModelsLab TTS poll failed: ${resp.status}`);\n      }\n\n      const data = (await resp.json()) as TtsApiResponse;\n\n      if (data.status === 'error') {\n        throw new Error(`ModelsLab TTS failed: ${data.message ?? 'Unknown error'}`);\n      }\n\n      if (data.status === 'success') {\n        return data;\n      }\n      // status === 'processing' → keep polling\n    }\n\n    throw new Error(`ModelsLab TTS timed out after ${POLL_TIMEOUT_MS / 1000}s (request_id=${requestId})`);\n  }\n\n  private async streamToString(stream: NodeJS.ReadableStream): Promise<string> {\n    const chunks: Buffer[] = [];\n    for await (const chunk of stream) {\n      if (typeof chunk === 'string') {\n        chunks.push(Buffer.from(chunk));\n      } else {\n        chunks.push(chunk as Buffer);\n      }\n    }\n    return Buffer.concat(chunks).toString('utf-8');\n  }\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,74 @@
+import { MastraVoice } from '@mastra/core/voice';
+type ModelsLabModel = 'default';
+export type ModelsLabVoiceId = '1' | '2' | '3' | '4' | '5' | '6';
+export declare const MODELSLAB_VOICES: {
+    voiceId: ModelsLabVoiceId;
+    name: string;
+    language: string;
+    gender: string;
+}[];
+interface ModelsLabVoiceConfig {
+    name?: ModelsLabModel;
+    apiKey?: string;
+}
+/**
+ * ModelsLab voice provider for Mastra.
+ *
+ * Uses ModelsLab's TTS API with key-in-body authentication and async polling.
+ * API docs: https://docs.modelslab.com
+ *
+ * @example
+ * ```ts
+ * const voice = new ModelsLabVoice({
+ *   speechModel: { apiKey: process.env.MODELSLAB_API_KEY },
+ *   speaker: '5', // Female voice
+ * });
+ *
+ * const stream = await voice.speak('Hello, world!');
+ * ```
+ */
+export declare class ModelsLabVoice extends MastraVoice {
+    private apiKey;
+    constructor({ speechModel, speaker, }?: {
+        speechModel?: ModelsLabVoiceConfig;
+        speaker?: ModelsLabVoiceId | string;
+    });
+    /**
+     * Returns available ModelsLab voices.
+     */
+    getSpeakers(): Promise<{
+        voiceId: string;
+        name: string;
+        language: string;
+        gender: string;
+    }[]>;
+    /**
+     * Converts text to speech using the ModelsLab TTS API.
+     *
+     * ModelsLab returns an audio URL (not a stream). This method:
+     * 1. POSTs to the TTS endpoint
+     * 2. If processing, polls until the audio URL is ready
+     * 3. Downloads the audio and returns a Readable stream
+     *
+     * @param input - Text to convert to speech
+     * @param options - Optional parameters
+     * @param options.speaker - ModelsLab voice ID (1–10) or OpenAI voice name (alloy, echo, etc.)
+     * @param options.language - Language code (default: 'english')
+     * @param options.speed - Speech speed (0.5–2.0, default: 1.0)
+     * @returns A Promise resolving to a Readable audio stream
+     */
+    speak(input: string | NodeJS.ReadableStream, options?: {
+        speaker?: ModelsLabVoiceId | string;
+        language?: string;
+        speed?: number;
+        [key: string]: unknown;
+    }): Promise<NodeJS.ReadableStream>;
+    /**
+     * ModelsLab does not provide speech-to-text. Throws NotImplemented.
+     */
+    listen(_input: NodeJS.ReadableStream, _options?: Record<string, unknown>): Promise<string>;
+    private pollUntilReady;
+    private streamToString;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAOjD,KAAK,cAAc,GAAG,SAAS,CAAC;AAEhC,MAAM,MAAM,gBAAgB,GACxB,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,CAAC;AAER,eAAO,MAAM,gBAAgB,EAAE;IAAE,OAAO,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAO3G,CAAC;AAYF,UAAU,oBAAoB;IAC5B,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAcD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C,OAAO,CAAC,MAAM,CAAS;gBAEX,EACV,WAAW,EACX,OAAO,GACR,GAAE;QACD,WAAW,CAAC,EAAE,oBAAoB,CAAC;QACnC,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;KAChC;IAkBN;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAInG;;;;;;;;;;;;;;OAcG;IACG,KAAK,CACT,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,cAAc,EACrC,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,GACA,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;IA0DjC;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;YAMlF,cAAc;YAgCd,cAAc;CAW7B"}

package/dist/index.js

@@ -0,0 +1,158 @@
+import { Readable } from 'stream';
+import { MastraVoice } from '@mastra/core/voice';
+
+// src/index.ts
+var MODELSLAB_TTS_URL = "https://modelslab.com/api/v6/voice/text_to_speech";
+var MODELSLAB_TTS_FETCH_URL = "https://modelslab.com/api/v6/voice/fetch/";
+var POLL_INTERVAL_MS = 5e3;
+var POLL_TIMEOUT_MS = 3e5;
+var MODELSLAB_VOICES = [
+  { voiceId: "1", name: "Neutral", language: "en", gender: "neutral" },
+  { voiceId: "2", name: "Male", language: "en", gender: "male" },
+  { voiceId: "3", name: "Warm", language: "en", gender: "male" },
+  { voiceId: "4", name: "Deep Male", language: "en", gender: "male" },
+  { voiceId: "5", name: "Female", language: "en", gender: "female" },
+  { voiceId: "6", name: "Clear Female", language: "en", gender: "female" }
+];
+var OPENAI_VOICE_MAP = {
+  alloy: "1",
+  echo: "2",
+  fable: "3",
+  onyx: "4",
+  nova: "5",
+  shimmer: "6"
+};
+async function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+var ModelsLabVoice = class extends MastraVoice {
+  apiKey;
+  constructor({
+    speechModel,
+    speaker
+  } = {}) {
+    const apiKey = speechModel?.apiKey ?? process.env.MODELSLAB_API_KEY;
+    super({
+      speechModel: {
+        name: speechModel?.name ?? "default",
+        apiKey
+      },
+      speaker: speaker ?? "1"
+    });
+    if (!apiKey) {
+      throw new Error("MODELSLAB_API_KEY is not set");
+    }
+    this.apiKey = apiKey;
+  }
+  /**
+   * Returns available ModelsLab voices.
+   */
+  async getSpeakers() {
+    return MODELSLAB_VOICES;
+  }
+  /**
+   * Converts text to speech using the ModelsLab TTS API.
+   *
+   * ModelsLab returns an audio URL (not a stream). This method:
+   * 1. POSTs to the TTS endpoint
+   * 2. If processing, polls until the audio URL is ready
+   * 3. Downloads the audio and returns a Readable stream
+   *
+   * @param input - Text to convert to speech
+   * @param options - Optional parameters
+   * @param options.speaker - ModelsLab voice ID (1–10) or OpenAI voice name (alloy, echo, etc.)
+   * @param options.language - Language code (default: 'english')
+   * @param options.speed - Speech speed (0.5–2.0, default: 1.0)
+   * @returns A Promise resolving to a Readable audio stream
+   */
+  async speak(input, options) {
+    const text = typeof input === "string" ? input : await this.streamToString(input);
+    const rawSpeaker = options?.speaker ?? this.speaker ?? "1";
+    const voiceId = OPENAI_VOICE_MAP[rawSpeaker] ?? rawSpeaker;
+    const body = {
+      key: this.apiKey,
+      prompt: text,
+      language: options?.language ?? "english",
+      voice_id: parseInt(voiceId, 10) || 1,
+      speed: options?.speed ?? 1
+    };
+    const initResp = await fetch(MODELSLAB_TTS_URL, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    if (!initResp.ok) {
+      throw new Error(`ModelsLab TTS failed: ${initResp.status} ${initResp.statusText}`);
+    }
+    let data = await initResp.json();
+    if (data.status === "error") {
+      throw new Error(`ModelsLab TTS error: ${data.message ?? "Unknown error"}`);
+    }
+    if (data.status === "processing") {
+      const requestId = String(data.request_id ?? "");
+      if (!requestId) {
+        throw new Error("ModelsLab TTS returned processing status without request_id");
+      }
+      data = await this.pollUntilReady(requestId);
+    }
+    const audioUrl = data.output;
+    if (!audioUrl) {
+      throw new Error("ModelsLab TTS returned no audio URL");
+    }
+    const audioResp = await fetch(audioUrl);
+    if (!audioResp.ok) {
+      throw new Error(`Failed to download ModelsLab audio: ${audioResp.status}`);
+    }
+    const audioBuffer = await audioResp.arrayBuffer();
+    const readable = new Readable();
+    readable.push(Buffer.from(audioBuffer));
+    readable.push(null);
+    return readable;
+  }
+  /**
+   * ModelsLab does not provide speech-to-text. Throws NotImplemented.
+   */
+  async listen(_input, _options) {
+    throw new Error(
+      "ModelsLab does not support speech-to-text. Use a different provider for listening (e.g., @mastra/voice-deepgram)."
+    );
+  }
+  async pollUntilReady(requestId) {
+    const fetchUrl = `${MODELSLAB_TTS_FETCH_URL}${requestId}`;
+    const deadline = Date.now() + POLL_TIMEOUT_MS;
+    while (Date.now() < deadline) {
+      await sleep(POLL_INTERVAL_MS);
+      const resp = await fetch(fetchUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ key: this.apiKey })
+      });
+      if (!resp.ok) {
+        throw new Error(`ModelsLab TTS poll failed: ${resp.status}`);
+      }
+      const data = await resp.json();
+      if (data.status === "error") {
+        throw new Error(`ModelsLab TTS failed: ${data.message ?? "Unknown error"}`);
+      }
+      if (data.status === "success") {
+        return data;
+      }
+    }
+    throw new Error(`ModelsLab TTS timed out after ${POLL_TIMEOUT_MS / 1e3}s (request_id=${requestId})`);
+  }
+  async streamToString(stream) {
+    const chunks = [];
+    for await (const chunk of stream) {
+      if (typeof chunk === "string") {
+        chunks.push(Buffer.from(chunk));
+      } else {
+        chunks.push(chunk);
+      }
+    }
+    return Buffer.concat(chunks).toString("utf-8");
+  }
+};
+
+export { MODELSLAB_VOICES, ModelsLabVoice };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { Readable } from 'node:stream';\n\nimport { MastraVoice } from '@mastra/core/voice';\n\nconst MODELSLAB_TTS_URL = 'https://modelslab.com/api/v6/voice/text_to_speech';\nconst MODELSLAB_TTS_FETCH_URL = 'https://modelslab.com/api/v6/voice/fetch/';\nconst POLL_INTERVAL_MS = 5000;\nconst POLL_TIMEOUT_MS = 300_000;\n\ntype ModelsLabModel = 'default';\n\nexport type ModelsLabVoiceId =\n  | '1' // Neutral\n  | '2' // Male\n  | '3' // Warm\n  | '4' // Deep Male\n  | '5' // Female\n  | '6'; // Clear Female\n\nexport const MODELSLAB_VOICES: { voiceId: ModelsLabVoiceId; name: string; language: string; gender: string }[] = [\n  { voiceId: '1', name: 'Neutral', language: 'en', gender: 'neutral' },\n  { voiceId: '2', name: 'Male', language: 'en', gender: 'male' },\n  { voiceId: '3', name: 'Warm', language: 'en', gender: 'male' },\n  { voiceId: '4', name: 'Deep Male', language: 'en', gender: 'male' },\n  { voiceId: '5', name: 'Female', language: 'en', gender: 'female' },\n  { voiceId: '6', name: 'Clear Female', language: 'en', gender: 'female' },\n];\n\n// OpenAI voice → ModelsLab voice_id mapping\nconst OPENAI_VOICE_MAP: Record<string, ModelsLabVoiceId> = {\n  alloy: '1',\n  echo: '2',\n  fable: '3',\n  onyx: '4',\n  nova: '5',\n  shimmer: '6',\n};\n\ninterface ModelsLabVoiceConfig {\n  name?: ModelsLabModel;\n  apiKey?: string;\n}\n\ninterface TtsApiResponse {\n  status: 'success' | 'processing' | 'error';\n  output?: string;\n  request_id?: string | number;\n  eta?: number;\n  message?: string;\n}\n\nasync function sleep(ms: number): Promise<void> {\n  return new Promise(resolve => setTimeout(resolve, ms));\n}\n\n/**\n * ModelsLab voice provider for Mastra.\n *\n * Uses ModelsLab's TTS API with key-in-body authentication and async polling.\n * API docs: https://docs.modelslab.com\n *\n * @example\n * ```ts\n * const voice = new ModelsLabVoice({\n *   speechModel: { apiKey: process.env.MODELSLAB_API_KEY },\n *   speaker: '5', // Female voice\n * });\n *\n * const stream = await voice.speak('Hello, world!');\n * ```\n */\nexport class ModelsLabVoice extends MastraVoice {\n  private apiKey: string;\n\n  constructor({\n    speechModel,\n    speaker,\n  }: {\n    speechModel?: ModelsLabVoiceConfig;\n    speaker?: ModelsLabVoiceId | string;\n  } = {}) {\n    const apiKey = speechModel?.apiKey ?? process.env.MODELSLAB_API_KEY;\n\n    super({\n      speechModel: {\n        name: speechModel?.name ?? 'default',\n        apiKey,\n      },\n      speaker: speaker ?? '1',\n    });\n\n    if (!apiKey) {\n      throw new Error('MODELSLAB_API_KEY is not set');\n    }\n\n    this.apiKey = apiKey;\n  }\n\n  /**\n   * Returns available ModelsLab voices.\n   */\n  async getSpeakers(): Promise<{ voiceId: string; name: string; language: string; gender: string }[]> {\n    return MODELSLAB_VOICES;\n  }\n\n  /**\n   * Converts text to speech using the ModelsLab TTS API.\n   *\n   * ModelsLab returns an audio URL (not a stream). This method:\n   * 1. POSTs to the TTS endpoint\n   * 2. If processing, polls until the audio URL is ready\n   * 3. Downloads the audio and returns a Readable stream\n   *\n   * @param input - Text to convert to speech\n   * @param options - Optional parameters\n   * @param options.speaker - ModelsLab voice ID (1–10) or OpenAI voice name (alloy, echo, etc.)\n   * @param options.language - Language code (default: 'english')\n   * @param options.speed - Speech speed (0.5–2.0, default: 1.0)\n   * @returns A Promise resolving to a Readable audio stream\n   */\n  async speak(\n    input: string | NodeJS.ReadableStream,\n    options?: {\n      speaker?: ModelsLabVoiceId | string;\n      language?: string;\n      speed?: number;\n      [key: string]: unknown;\n    },\n  ): Promise<NodeJS.ReadableStream> {\n    const text = typeof input === 'string' ? input : await this.streamToString(input);\n\n    // Resolve voice_id: accept numeric ID or OpenAI-style voice name\n    const rawSpeaker = options?.speaker ?? this.speaker ?? '1';\n    const voiceId = OPENAI_VOICE_MAP[rawSpeaker] ?? rawSpeaker;\n\n    const body = {\n      key: this.apiKey,\n      prompt: text,\n      language: options?.language ?? 'english',\n      voice_id: parseInt(voiceId, 10) || 1,\n      speed: options?.speed ?? 1.0,\n    };\n\n    const initResp = await fetch(MODELSLAB_TTS_URL, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify(body),\n    });\n\n    if (!initResp.ok) {\n      throw new Error(`ModelsLab TTS failed: ${initResp.status} ${initResp.statusText}`);\n    }\n\n    let data = (await initResp.json()) as TtsApiResponse;\n\n    if (data.status === 'error') {\n      throw new Error(`ModelsLab TTS error: ${data.message ?? 'Unknown error'}`);\n    }\n\n    if (data.status === 'processing') {\n      const requestId = String(data.request_id ?? '');\n      if (!requestId) {\n        throw new Error('ModelsLab TTS returned processing status without request_id');\n      }\n      data = await this.pollUntilReady(requestId);\n    }\n\n    const audioUrl = data.output;\n    if (!audioUrl) {\n      throw new Error('ModelsLab TTS returned no audio URL');\n    }\n\n    // Download audio and return as Readable stream\n    const audioResp = await fetch(audioUrl);\n    if (!audioResp.ok) {\n      throw new Error(`Failed to download ModelsLab audio: ${audioResp.status}`);\n    }\n\n    const audioBuffer = await audioResp.arrayBuffer();\n    const readable = new Readable();\n    readable.push(Buffer.from(audioBuffer));\n    readable.push(null);\n\n    return readable;\n  }\n\n  /**\n   * ModelsLab does not provide speech-to-text. Throws NotImplemented.\n   */\n  async listen(_input: NodeJS.ReadableStream, _options?: Record<string, unknown>): Promise<string> {\n    throw new Error(\n      'ModelsLab does not support speech-to-text. Use a different provider for listening (e.g., @mastra/voice-deepgram).',\n    );\n  }\n\n  private async pollUntilReady(requestId: string): Promise<TtsApiResponse> {\n    const fetchUrl = `${MODELSLAB_TTS_FETCH_URL}${requestId}`;\n    const deadline = Date.now() + POLL_TIMEOUT_MS;\n\n    while (Date.now() < deadline) {\n      await sleep(POLL_INTERVAL_MS);\n\n      const resp = await fetch(fetchUrl, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({ key: this.apiKey }),\n      });\n\n      if (!resp.ok) {\n        throw new Error(`ModelsLab TTS poll failed: ${resp.status}`);\n      }\n\n      const data = (await resp.json()) as TtsApiResponse;\n\n      if (data.status === 'error') {\n        throw new Error(`ModelsLab TTS failed: ${data.message ?? 'Unknown error'}`);\n      }\n\n      if (data.status === 'success') {\n        return data;\n      }\n      // status === 'processing' → keep polling\n    }\n\n    throw new Error(`ModelsLab TTS timed out after ${POLL_TIMEOUT_MS / 1000}s (request_id=${requestId})`);\n  }\n\n  private async streamToString(stream: NodeJS.ReadableStream): Promise<string> {\n    const chunks: Buffer[] = [];\n    for await (const chunk of stream) {\n      if (typeof chunk === 'string') {\n        chunks.push(Buffer.from(chunk));\n      } else {\n        chunks.push(chunk as Buffer);\n      }\n    }\n    return Buffer.concat(chunks).toString('utf-8');\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@mastra/voice-modelslab",
+  "version": "0.1.0",
+  "description": "Mastra ModelsLab voice integration",
+  "type": "module",
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "license": "Apache-2.0",
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "22.19.7",
+    "@vitest/coverage-v8": "4.0.18",
+    "@vitest/ui": "4.0.18",
+    "eslint": "^9.37.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "4.0.18",
+    "@internal/types-builder": "0.0.41",
+    "@internal/lint": "0.0.66",
+    "@mastra/core": "1.10.0"
+  },
+  "peerDependencies": {
+    "@mastra/core": ">=1.0.0-0 <2.0.0-0"
+  },
+  "homepage": "https://mastra.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mastra-ai/mastra.git",
+    "directory": "voice/modelslab"
+  },
+  "bugs": {
+    "url": "https://github.com/mastra-ai/mastra/issues"
+  },
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "scripts": {
+    "build": "tsup --silent --config tsup.config.ts",
+    "build:watch": "tsup build --watch && tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "lint": "eslint ."
+  }
+}