@reaatech/media-pipeline-mcp-elevenlabs 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Media Pipeline MCP Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,178 @@
+# @reaatech/media-pipeline-mcp-elevenlabs
+
+[![npm version](https://img.shields.io/npm/v/@reaatech/media-pipeline-mcp-elevenlabs.svg)](https://www.npmjs.com/package/@reaatech/media-pipeline-mcp-elevenlabs)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/reaatech/media-pipeline-mcp/blob/main/LICENSE)
+[![CI](https://img.shields.io/github/actions/workflow/status/reaatech/media-pipeline-mcp/ci.yml?branch=main&label=CI)](https://github.com/reaatech/media-pipeline-mcp/actions/workflows/ci.yml)
+
+> **Status:** Pre-1.0 — APIs may change in minor versions. Pin to a specific version in production.
+
+ElevenLabs provider for the media pipeline framework. Delivers high-quality text-to-speech synthesis with configurable voice selection, speaking speed, voice stability tuning, similarity boost, and style exaggeration. Supports multiple output formats and native audio-byte streaming.
+
+## Installation
+
+```bash
+npm install @reaatech/media-pipeline-mcp-elevenlabs
+# or
+pnpm add @reaatech/media-pipeline-mcp-elevenlabs
+```
+
+## Feature Overview
+
+- High-quality TTS with `eleven_monolingual_v1`, `eleven_multilingual_v2`, and `eleven_turbo_v2` models
+- Named voice selection (Rachel, Josh, Daniel, Charlotte) plus custom voice IDs
+- Fine-grained voice tuning: stability (0-1), similarity boost (0-1), style exaggeration (0-1)
+- Speaking speed control via SSML prosody tags
+- Multiple output formats: MP3, WAV, OGG, FLAC, AAC
+- Streaming support for TTS audio bytes (`supportsStreaming`)
+- Character-count-based cost estimation
+
+## Quick Start
+
+```typescript
+import { ElevenLabsProvider } from "@reaatech/media-pipeline-mcp-elevenlabs";
+
+const provider = new ElevenLabsProvider({ apiKey: process.env.ELEVENLABS_API_KEY! });
+
+const audio = await provider.execute({
+  operation: "audio.tts",
+  params: {
+    text: "Welcome to our media pipeline. This audio was generated with ElevenLabs.",
+    voice: "Rachel",
+    speed: 1.0,
+    model: "eleven_turbo_v2",
+  },
+  config: {},
+});
+
+// Save or pipe the audio
+import { writeFileSync } from "node:fs";
+writeFileSync("output.mp3", audio.data);
+console.log(`Generated ${audio.metadata.characterCount} chars in ${audio.metadata.duration}s`);
+```
+
+## Supported Operations
+
+| Operation | Default Model | Description | Output Format |
+|-----------|---------------|-------------|---------------|
+| `audio.tts` | `eleven_monolingual_v1` | Text-to-speech with voice and parameter control | Audio bytes in `mp3`, `wav`, `ogg`, `flac`, or `aac` |
+
+## Configuration Parameters
+
+### `audio.tts`
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `text` | `string` | *required* | Text to convert to speech |
+| `voice` | `string` | `"Rachel"` | Voice name (`Rachel`, `Josh`, `Daniel`, `Charlotte`) or custom voice ID |
+| `speed` | `number` | `1.0` | Speaking rate multiplier (uses SSML prosody) |
+| `model` | `string` | `"eleven_monolingual_v1"` | TTS model ID |
+| `response_format` | `string` | `"mp3"` | Output audio format: `mp3`, `wav`, `ogg`, `flac`, `aac` |
+
+### Voice Tuning (internal defaults)
+
+The provider applies these voice settings automatically on every request:
+
+| Parameter | Default | Description |
+|-----------|---------|-------------|
+| `stability` | `0.5` | Voice stability (0 = more variable, 1 = more consistent) |
+| `similarity_boost` | `0.75` | Speaker similarity to target voice (0-1) |
+| `style` | `0.0` | Style exaggeration (0-1) |
+| `use_speaker_boost` | `true` | Enhance speaker clarity |
+
+## API Reference
+
+### `ElevenLabsProvider`
+
+```typescript
+class ElevenLabsProvider extends MediaProvider {
+  constructor(config: ElevenLabsProviderConfig)
+
+  healthCheck(): Promise<ProviderHealth>
+  estimateCost(input: ProviderInput): Promise<CostEstimate>
+  execute(input: ProviderInput): Promise<ProviderOutput>
+}
+```
+
+### `ElevenLabsProviderConfig`
+
+```typescript
+interface ElevenLabsProviderConfig {
+  apiKey: string;
+  voices?: {
+    default?: string;
+    [voiceName: string]: string | undefined;
+  };
+  model?: string;    // Default model ID
+  timeout?: number;  // Request timeout in ms
+}
+```
+
+### Factory Function
+
+```typescript
+import { defineElevenLabsProvider } from "@reaatech/media-pipeline-mcp-elevenlabs";
+
+const provider = defineElevenLabsProvider({ apiKey: process.env.ELEVENLABS_API_KEY! });
+```
+
+### Voice Resolution Logic
+
+Voice parameters are resolved in this order:
+1. If a custom `voices` map is configured, the name is looked up there first
+2. If the value starts with `voice_` or is exactly 20 characters, it's treated as a raw voice ID
+3. If the name matches a built-in preset, that voice ID is used
+4. Falls back to `"Rachel"`
+
+### Key Methods
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `healthCheck()` | `ProviderHealth` | Validates API key by fetching `/v1/voices` from the ElevenLabs API |
+| `estimateCost(input)` | `CostEstimate` | Estimates cost based on text character count × per-character rate |
+| `execute(input)` | `ProviderOutput` | Synthesizes audio and returns raw audio bytes with metadata |
+
+### Non-Retryable Errors
+
+The provider classifies these errors as non-retryable: authentication failed, invalid API key, permission denied, insufficient credits, voice not found, invalid voice ID.
+
+## Cost Estimation
+
+### Per-Character Pricing
+
+| Model | Cost / Character |
+|-------|-----------------|
+| `eleven_turbo_v2` | $0.0002 |
+| `eleven_monolingual_v1` | $0.0003 |
+| `eleven_multilingual_v2` | $0.0005 |
+
+### Example Estimates
+
+| Text Length | Model | Est. Cost |
+|------------|-------|-----------|
+| 100 chars | `eleven_turbo_v2` | $0.02 |
+| 100 chars | `eleven_monolingual_v1` | $0.03 |
+| 500 chars | `eleven_multilingual_v2` | $0.25 |
+
+## Cache Configuration
+
+The provider exposes `static cacheConfig` with deterministic and non-deterministic parameters.
+
+**Deterministic parameters:** `text`, `voice_id`, `voice`, `model`, `voice_settings`
+
+**Non-deterministic parameters:** (none)
+
+The `normalize()` function trims and collapses whitespace in `text`, and preserves voice settings as-is. All parameters are deterministic, so identical text + voice + model combinations will produce matching cache keys.
+
+## Health Check
+
+The health check sends a GET request to `https://api.elevenlabs.io/v1/voices` using the `xi-api-key` header. Returns `{ healthy: true, latency: <ms> }` on 2xx response, or `{ healthy: false, error: "<message>" }` on failure.
+
+## Related Packages
+
+- [`@reaatech/media-pipeline-mcp-provider-core`](https://www.npmjs.com/package/@reaatech/media-pipeline-mcp-provider-core) — Base provider class
+- [`@reaatech/media-pipeline-mcp-server`](https://www.npmjs.com/package/@reaatech/media-pipeline-mcp-server) — MCP server
+- [`@reaatech/media-pipeline-mcp-openai`](https://www.npmjs.com/package/@reaatech/media-pipeline-mcp-openai) — Alternative TTS provider (TTS-1)
+
+## License
+
+[MIT](https://github.com/reaatech/media-pipeline-mcp/blob/main/LICENSE)

package/dist/index.cjs

@@ -0,0 +1,233 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ElevenLabsProvider: () => ElevenLabsProvider,
+  defineElevenLabsProvider: () => defineElevenLabsProvider
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/elevenlabs-provider.ts
+var import_media_pipeline_mcp_provider_core = require("@reaatech/media-pipeline-mcp-provider-core");
+
+// src/pricing.json
+var pricing_default = {
+  "audio.tts": {
+    eleven_monolingual_v1: {
+      input: { perUnit: 3e-4, unit: "per character" },
+      expectedDurationMs: 2e3
+    },
+    eleven_multilingual_v2: {
+      input: { perUnit: 5e-4, unit: "per character" },
+      expectedDurationMs: 3e3
+    },
+    eleven_turbo_v2: {
+      input: { perUnit: 2e-4, unit: "per character" },
+      expectedDurationMs: 1e3
+    }
+  }
+};
+
+// src/elevenlabs-provider.ts
+var ElevenLabsProvider = class extends import_media_pipeline_mcp_provider_core.MediaProvider {
+  static cacheConfig = {
+    deterministicParams: ["text", "voice_id", "voice", "model", "voice_settings"],
+    nonDeterministicParams: [],
+    normalize: (inputs) => {
+      const normalized = {};
+      if (inputs.text !== void 0)
+        normalized.text = String(inputs.text).trim().replace(/\s+/g, " ");
+      if (inputs.voice !== void 0) normalized.voice = inputs.voice;
+      if (inputs.voice_id !== void 0) normalized.voice_id = inputs.voice_id;
+      if (inputs.model !== void 0) normalized.model = inputs.model;
+      if (inputs.voice_settings !== void 0) {
+        normalized.voice_settings = inputs.voice_settings;
+      }
+      return normalized;
+    }
+  };
+  // §0.6 — elevenlabs streams TTS bytes natively. No native webhook surface.
+  supportsStreaming = /* @__PURE__ */ new Set(["audio.tts"]);
+  supportsWebhooks = false;
+  name = "elevenlabs";
+  supportedOperations = ["audio.tts"];
+  config;
+  baseUrl = "https://api.elevenlabs.io/v1";
+  defaultVoices = {
+    default: "Rachel",
+    // Professional female voice
+    "male-narrator": "Josh",
+    "female-narrator": "Rachel",
+    "british-male": "Daniel",
+    "british-female": "Charlotte"
+  };
+  constructor(config) {
+    super();
+    this.config = config;
+  }
+  async healthCheck() {
+    const startTime = Date.now();
+    try {
+      const response = await fetch(`${this.baseUrl}/voices`, {
+        headers: {
+          "xi-api-key": this.config.apiKey
+        }
+      });
+      if (!response.ok) {
+        throw new Error(`Health check failed: ${response.statusText}`);
+      }
+      return {
+        healthy: true,
+        latency: Date.now() - startTime
+      };
+    } catch (error) {
+      return {
+        healthy: false,
+        latency: Date.now() - startTime,
+        error: error.message
+      };
+    }
+  }
+  async estimateCost(input) {
+    const opPricing = pricing_default[input.operation];
+    if (!opPricing) {
+      return { costUsd: 0, currency: "USD" };
+    }
+    const model = input.params.model || "eleven_monolingual_v1";
+    const entry = opPricing[model] || opPricing.eleven_monolingual_v1;
+    const text = input.params.text || "";
+    const costUsd = text.length * (entry?.input.perUnit ?? 3e-4);
+    return { costUsd, currency: "USD", estimatedDurationMs: entry?.expectedDurationMs };
+  }
+  async execute(input) {
+    const startTime = Date.now();
+    try {
+      if (input.operation !== "audio.tts") {
+        throw new Error(`Unsupported operation: ${input.operation}`);
+      }
+      const text = input.params.text;
+      const voice = this.resolveVoice(input.params.voice);
+      const speed = input.params.speed || 1;
+      const format = input.params.response_format || "mp3";
+      const model = input.params.model || "eleven_monolingual_v1";
+      if (!text) {
+        throw new Error("Text is required for TTS");
+      }
+      const requestBody = {
+        text,
+        model_id: model,
+        voice_settings: {
+          stability: 0.5,
+          similarity_boost: 0.75,
+          style: 0,
+          use_speaker_boost: true
+        }
+      };
+      let processedText = text;
+      if (speed !== 1) {
+        processedText = `<speak rate="${speed * 100}%">${text}</speak>`;
+      }
+      requestBody.text = processedText;
+      const response = await fetch(`${this.baseUrl}/text-to-speech/${voice}`, {
+        method: "POST",
+        headers: {
+          "xi-api-key": this.config.apiKey,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify(requestBody)
+      });
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`ElevenLabs API error: ${response.status} - ${errorText}`);
+      }
+      const arrayBuffer = await response.arrayBuffer();
+      const data = Buffer.from(arrayBuffer);
+      const mimeType = this.getMimeType(format);
+      const duration = this.estimateDuration(text);
+      const cost = (await this.estimateCost(input)).costUsd;
+      return {
+        data,
+        mimeType,
+        costUsd: cost,
+        durationMs: Date.now() - startTime,
+        metadata: {
+          model,
+          operation: input.operation,
+          voice,
+          duration,
+          speed,
+          format,
+          characterCount: text.length
+        }
+      };
+    } catch (error) {
+      throw new Error(`ElevenLabs provider error: ${error.message}`, { cause: error });
+    }
+  }
+  resolveVoice(voiceName) {
+    if (!voiceName) {
+      return this.defaultVoices.default;
+    }
+    if (this.config.voices?.[voiceName]) {
+      return this.config.voices[voiceName];
+    }
+    if (voiceName.startsWith("voice_") || voiceName.length === 20) {
+      return voiceName;
+    }
+    if (this.defaultVoices[voiceName]) {
+      return this.defaultVoices[voiceName];
+    }
+    return this.defaultVoices.default;
+  }
+  getMimeType(format) {
+    const mimeTypes = {
+      mp3: "audio/mpeg",
+      wav: "audio/wav",
+      ogg: "audio/ogg",
+      flac: "audio/flac",
+      aac: "audio/aac"
+    };
+    return mimeTypes[format] || "audio/mpeg";
+  }
+  estimateDuration(text) {
+    const charsPerSecond = 12.5;
+    return Math.ceil(text.length / charsPerSecond);
+  }
+  isNonRetryableError(error) {
+    const nonRetryableMessages = [
+      "authentication failed",
+      "invalid api key",
+      "permission denied",
+      "insufficient credits",
+      "voice not found",
+      "invalid voice id"
+    ];
+    return nonRetryableMessages.some((msg) => error.message.toLowerCase().includes(msg));
+  }
+};
+function defineElevenLabsProvider(config) {
+  return new ElevenLabsProvider(config);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ElevenLabsProvider,
+  defineElevenLabsProvider
+});

package/dist/index.d.cts

@@ -0,0 +1,32 @@
+import { MediaProvider, ProviderCacheConfig, ProviderHealth, ProviderInput, CostEstimate, ProviderOutput } from '@reaatech/media-pipeline-mcp-provider-core';
+
+interface ElevenLabsProviderConfig {
+    apiKey: string;
+    voices?: {
+        default?: string;
+        [key: string]: string | undefined;
+    };
+    model?: string;
+    timeout?: number;
+}
+declare class ElevenLabsProvider extends MediaProvider {
+    static cacheConfig: ProviderCacheConfig;
+    readonly supportsStreaming: Set<string>;
+    readonly supportsWebhooks = false;
+    readonly name = "elevenlabs";
+    readonly supportedOperations: string[];
+    private config;
+    private baseUrl;
+    private defaultVoices;
+    constructor(config: ElevenLabsProviderConfig);
+    healthCheck(): Promise<ProviderHealth>;
+    estimateCost(input: ProviderInput): Promise<CostEstimate>;
+    execute(input: ProviderInput): Promise<ProviderOutput>;
+    private resolveVoice;
+    private getMimeType;
+    private estimateDuration;
+    protected isNonRetryableError(error: Error): boolean;
+}
+declare function defineElevenLabsProvider(config: ElevenLabsProviderConfig): ElevenLabsProvider;
+
+export { ElevenLabsProvider, type ElevenLabsProviderConfig, defineElevenLabsProvider };

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+import { MediaProvider, ProviderCacheConfig, ProviderHealth, ProviderInput, CostEstimate, ProviderOutput } from '@reaatech/media-pipeline-mcp-provider-core';
+
+interface ElevenLabsProviderConfig {
+    apiKey: string;
+    voices?: {
+        default?: string;
+        [key: string]: string | undefined;
+    };
+    model?: string;
+    timeout?: number;
+}
+declare class ElevenLabsProvider extends MediaProvider {
+    static cacheConfig: ProviderCacheConfig;
+    readonly supportsStreaming: Set<string>;
+    readonly supportsWebhooks = false;
+    readonly name = "elevenlabs";
+    readonly supportedOperations: string[];
+    private config;
+    private baseUrl;
+    private defaultVoices;
+    constructor(config: ElevenLabsProviderConfig);
+    healthCheck(): Promise<ProviderHealth>;
+    estimateCost(input: ProviderInput): Promise<CostEstimate>;
+    execute(input: ProviderInput): Promise<ProviderOutput>;
+    private resolveVoice;
+    private getMimeType;
+    private estimateDuration;
+    protected isNonRetryableError(error: Error): boolean;
+}
+declare function defineElevenLabsProvider(config: ElevenLabsProviderConfig): ElevenLabsProvider;
+
+export { ElevenLabsProvider, type ElevenLabsProviderConfig, defineElevenLabsProvider };

package/dist/index.js

@@ -0,0 +1,205 @@
+// src/elevenlabs-provider.ts
+import { MediaProvider } from "@reaatech/media-pipeline-mcp-provider-core";
+
+// src/pricing.json
+var pricing_default = {
+  "audio.tts": {
+    eleven_monolingual_v1: {
+      input: { perUnit: 3e-4, unit: "per character" },
+      expectedDurationMs: 2e3
+    },
+    eleven_multilingual_v2: {
+      input: { perUnit: 5e-4, unit: "per character" },
+      expectedDurationMs: 3e3
+    },
+    eleven_turbo_v2: {
+      input: { perUnit: 2e-4, unit: "per character" },
+      expectedDurationMs: 1e3
+    }
+  }
+};
+
+// src/elevenlabs-provider.ts
+var ElevenLabsProvider = class extends MediaProvider {
+  static cacheConfig = {
+    deterministicParams: ["text", "voice_id", "voice", "model", "voice_settings"],
+    nonDeterministicParams: [],
+    normalize: (inputs) => {
+      const normalized = {};
+      if (inputs.text !== void 0)
+        normalized.text = String(inputs.text).trim().replace(/\s+/g, " ");
+      if (inputs.voice !== void 0) normalized.voice = inputs.voice;
+      if (inputs.voice_id !== void 0) normalized.voice_id = inputs.voice_id;
+      if (inputs.model !== void 0) normalized.model = inputs.model;
+      if (inputs.voice_settings !== void 0) {
+        normalized.voice_settings = inputs.voice_settings;
+      }
+      return normalized;
+    }
+  };
+  // §0.6 — elevenlabs streams TTS bytes natively. No native webhook surface.
+  supportsStreaming = /* @__PURE__ */ new Set(["audio.tts"]);
+  supportsWebhooks = false;
+  name = "elevenlabs";
+  supportedOperations = ["audio.tts"];
+  config;
+  baseUrl = "https://api.elevenlabs.io/v1";
+  defaultVoices = {
+    default: "Rachel",
+    // Professional female voice
+    "male-narrator": "Josh",
+    "female-narrator": "Rachel",
+    "british-male": "Daniel",
+    "british-female": "Charlotte"
+  };
+  constructor(config) {
+    super();
+    this.config = config;
+  }
+  async healthCheck() {
+    const startTime = Date.now();
+    try {
+      const response = await fetch(`${this.baseUrl}/voices`, {
+        headers: {
+          "xi-api-key": this.config.apiKey
+        }
+      });
+      if (!response.ok) {
+        throw new Error(`Health check failed: ${response.statusText}`);
+      }
+      return {
+        healthy: true,
+        latency: Date.now() - startTime
+      };
+    } catch (error) {
+      return {
+        healthy: false,
+        latency: Date.now() - startTime,
+        error: error.message
+      };
+    }
+  }
+  async estimateCost(input) {
+    const opPricing = pricing_default[input.operation];
+    if (!opPricing) {
+      return { costUsd: 0, currency: "USD" };
+    }
+    const model = input.params.model || "eleven_monolingual_v1";
+    const entry = opPricing[model] || opPricing.eleven_monolingual_v1;
+    const text = input.params.text || "";
+    const costUsd = text.length * (entry?.input.perUnit ?? 3e-4);
+    return { costUsd, currency: "USD", estimatedDurationMs: entry?.expectedDurationMs };
+  }
+  async execute(input) {
+    const startTime = Date.now();
+    try {
+      if (input.operation !== "audio.tts") {
+        throw new Error(`Unsupported operation: ${input.operation}`);
+      }
+      const text = input.params.text;
+      const voice = this.resolveVoice(input.params.voice);
+      const speed = input.params.speed || 1;
+      const format = input.params.response_format || "mp3";
+      const model = input.params.model || "eleven_monolingual_v1";
+      if (!text) {
+        throw new Error("Text is required for TTS");
+      }
+      const requestBody = {
+        text,
+        model_id: model,
+        voice_settings: {
+          stability: 0.5,
+          similarity_boost: 0.75,
+          style: 0,
+          use_speaker_boost: true
+        }
+      };
+      let processedText = text;
+      if (speed !== 1) {
+        processedText = `<speak rate="${speed * 100}%">${text}</speak>`;
+      }
+      requestBody.text = processedText;
+      const response = await fetch(`${this.baseUrl}/text-to-speech/${voice}`, {
+        method: "POST",
+        headers: {
+          "xi-api-key": this.config.apiKey,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify(requestBody)
+      });
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`ElevenLabs API error: ${response.status} - ${errorText}`);
+      }
+      const arrayBuffer = await response.arrayBuffer();
+      const data = Buffer.from(arrayBuffer);
+      const mimeType = this.getMimeType(format);
+      const duration = this.estimateDuration(text);
+      const cost = (await this.estimateCost(input)).costUsd;
+      return {
+        data,
+        mimeType,
+        costUsd: cost,
+        durationMs: Date.now() - startTime,
+        metadata: {
+          model,
+          operation: input.operation,
+          voice,
+          duration,
+          speed,
+          format,
+          characterCount: text.length
+        }
+      };
+    } catch (error) {
+      throw new Error(`ElevenLabs provider error: ${error.message}`, { cause: error });
+    }
+  }
+  resolveVoice(voiceName) {
+    if (!voiceName) {
+      return this.defaultVoices.default;
+    }
+    if (this.config.voices?.[voiceName]) {
+      return this.config.voices[voiceName];
+    }
+    if (voiceName.startsWith("voice_") || voiceName.length === 20) {
+      return voiceName;
+    }
+    if (this.defaultVoices[voiceName]) {
+      return this.defaultVoices[voiceName];
+    }
+    return this.defaultVoices.default;
+  }
+  getMimeType(format) {
+    const mimeTypes = {
+      mp3: "audio/mpeg",
+      wav: "audio/wav",
+      ogg: "audio/ogg",
+      flac: "audio/flac",
+      aac: "audio/aac"
+    };
+    return mimeTypes[format] || "audio/mpeg";
+  }
+  estimateDuration(text) {
+    const charsPerSecond = 12.5;
+    return Math.ceil(text.length / charsPerSecond);
+  }
+  isNonRetryableError(error) {
+    const nonRetryableMessages = [
+      "authentication failed",
+      "invalid api key",
+      "permission denied",
+      "insufficient credits",
+      "voice not found",
+      "invalid voice id"
+    ];
+    return nonRetryableMessages.some((msg) => error.message.toLowerCase().includes(msg));
+  }
+};
+function defineElevenLabsProvider(config) {
+  return new ElevenLabsProvider(config);
+}
+export {
+  ElevenLabsProvider,
+  defineElevenLabsProvider
+};

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@reaatech/media-pipeline-mcp-elevenlabs",
+  "version": "0.3.0",
+  "description": "ElevenLabs provider — high-quality text-to-speech with voice selection, speed control, and voice tuning",
+  "license": "MIT",
+  "author": "Rick Somers <rick@reaatech.com> (https://reaatech.com)",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/reaatech/media-pipeline-mcp.git",
+    "directory": "packages/elevenlabs"
+  },
+  "homepage": "https://github.com/reaatech/media-pipeline-mcp/tree/main/packages/elevenlabs#readme",
+  "bugs": {
+    "url": "https://github.com/reaatech/media-pipeline-mcp/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@11labs/client": "^0.1.0",
+    "@reaatech/media-pipeline-mcp-provider-core": "0.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.1"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "clean": "rm -rf dist"
+  }
+}