@elizaos/plugin-elevenlabs 1.0.0-beta.5 → 1.0.0-beta.51

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Shaw Walters, aka Moon aka @lalalune
+Copyright (c) 2025 Shaw Walters and elizaOS 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

package/README.md

@@ -0,0 +1,60 @@
+# ElevenLabs Plugin
+
+This plugin provides integration with ElevenLabs text-to-speech services through the ElizaOS platform.
+
+## Usage
+
+Add the plugin to your character configuration:
+
+```json
+"plugins": ["@elizaos-plugins/plugin-elevenlabs"]
+```
+
+## Configuration
+
+The plugin requires these environment variables (can be set in .env file or character settings):
+
+```json
+"settings": {
+  "ELEVENLABS_API_KEY": "your_elevenlabs_api_key",
+  "ELEVENLABS_VOICE_ID": "EXAVITQu4vr4xnSDxMaL",
+  "ELEVENLABS_MODEL_ID": "eleven_monolingual_v1",
+  "ELEVENLABS_VOICE_STABILITY": "0.5",
+  "ELEVENLABS_OPTIMIZE_STREAMING_LATENCY": "0",
+  "ELEVENLABS_OUTPUT_FORMAT": "pcm_16000",
+  "ELEVENLABS_VOICE_SIMILARITY_BOOST": "0.75",
+  "ELEVENLABS_VOICE_STYLE": "0",
+  "ELEVENLABS_VOICE_USE_SPEAKER_BOOST": "true"
+}
+```
+
+Or in `.env` file:
+
+```
+ELEVENLABS_API_KEY=your_elevenlabs_api_key
+# Optional overrides:
+ELEVENLABS_VOICE_ID=EXAVITQu4vr4xnSDxMaL
+ELEVENLABS_MODEL_ID=eleven_monolingual_v1
+ELEVENLABS_VOICE_STABILITY=0.5
+ELEVENLABS_OPTIMIZE_STREAMING_LATENCY=0
+ELEVENLABS_OUTPUT_FORMAT=pcm_16000
+ELEVENLABS_VOICE_SIMILARITY_BOOST=0.75
+ELEVENLABS_VOICE_STYLE=0
+ELEVENLABS_VOICE_USE_SPEAKER_BOOST=true
+```
+
+### Configuration Options
+
+- `ELEVENLABS_API_KEY` (required): Your ElevenLabs API credentials.
+- `ELEVENLABS_VOICE_ID`: Optional. Voice selection ID. Defaults to `EXAVITQu4vr4xnSDxMaL`.
+- `ELEVENLABS_MODEL_ID`: Optional. Speech model ID. Defaults to `eleven_monolingual_v1`.
+- `ELEVENLABS_VOICE_STABILITY`: Optional. Controls voice stability. Defaults to `0.5`.
+- `ELEVENLABS_OPTIMIZE_STREAMING_LATENCY`: Optional. Adjusts streaming latency. Defaults to `0`.
+- `ELEVENLABS_OUTPUT_FORMAT`: Optional. Output format (e.g., pcm_16000). Defaults to `pcm_16000`.
+- `ELEVENLABS_VOICE_SIMILARITY_BOOST`: Optional. Adjusts similarity to the reference voice (0-1). Defaults to `0.75`.
+- `ELEVENLABS_VOICE_STYLE`: Optional. Controls voice style intensity (0-1). Defaults to `0`.
+- `ELEVENLABS_VOICE_USE_SPEAKER_BOOST`: Optional. Enhances speaker presence (true/false). Defaults to `true`.
+
+The plugin provides the following model type:
+
+- `TEXT_TO_SPEECH`: Converts text into spoken audio.

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import { Plugin } from '@elizaos/core';
+
+/**
+ * Represents the ElevenLabs plugin.
+ * This plugin provides functionality related to ElevenLabs API, including text to speech conversion.
+ * @type {Plugin}
+ */
+declare const elevenLabsPlugin: Plugin;
+
+export { elevenLabsPlugin as default, elevenLabsPlugin };

package/dist/index.js

@@ -1,44 +1,11 @@
 // src/index.ts
+import {
+  ModelType,
+  logger,
+  prependWavHeader,
+  parseBooleanFromText
+} from "@elizaos/core";
 import { Readable } from "node:stream";
-import { ModelType, logger } from "@elizaos/core";
-
-// src/utils.ts
-import { PassThrough } from "node:stream";
-function getWavHeader(audioLength, sampleRate, channelCount = 1, bitsPerSample = 16) {
-  const wavHeader = Buffer.alloc(44);
-  wavHeader.write("RIFF", 0);
-  wavHeader.writeUInt32LE(36 + audioLength, 4);
-  wavHeader.write("WAVE", 8);
-  wavHeader.write("fmt ", 12);
-  wavHeader.writeUInt32LE(16, 16);
-  wavHeader.writeUInt16LE(1, 20);
-  wavHeader.writeUInt16LE(channelCount, 22);
-  wavHeader.writeUInt32LE(sampleRate, 24);
-  wavHeader.writeUInt32LE(sampleRate * bitsPerSample * channelCount / 8, 28);
-  wavHeader.writeUInt16LE(bitsPerSample * channelCount / 8, 32);
-  wavHeader.writeUInt16LE(bitsPerSample, 34);
-  wavHeader.write("data", 36);
-  wavHeader.writeUInt32LE(audioLength, 40);
-  return wavHeader;
-}
-function prependWavHeader(readable, audioLength, sampleRate, channelCount = 1, bitsPerSample = 16) {
-  const wavHeader = getWavHeader(audioLength, sampleRate, channelCount, bitsPerSample);
-  let pushedHeader = false;
-  const passThrough = new PassThrough();
-  readable.on("data", (data) => {
-    if (!pushedHeader) {
-      passThrough.push(wavHeader);
-      pushedHeader = true;
-    }
-    passThrough.push(data);
-  });
-  readable.on("end", () => {
-    passThrough.end();
-  });
-  return passThrough;
-}
-
-// src/index.ts
 function getVoiceSettings(runtime) {
   const getSetting = (key, fallback = "") => process.env[key] || runtime.getSetting(key) || fallback;
   return {
@@ -50,7 +17,9 @@ function getVoiceSettings(runtime) {
     outputFormat: getSetting("ELEVENLABS_OUTPUT_FORMAT", "pcm_16000"),
     similarity: getSetting("ELEVENLABS_VOICE_SIMILARITY_BOOST", "0.75"),
     style: getSetting("ELEVENLABS_VOICE_STYLE", "0"),
-    speakerBoost: getSetting("ELEVENLABS_VOICE_USE_SPEAKER_BOOST", "true")
+    speakerBoost: parseBooleanFromText(
+      getSetting("ELEVENLABS_VOICE_USE_SPEAKER_BOOST", "true")
+    )
   };
 }
 async function fetchSpeech(runtime, text) {
@@ -81,15 +50,19 @@ async function fetchSpeech(runtime, text) {
       const errorBody = JSON.parse(errorBodyString);
       if (response.status === 401 && errorBody.detail?.status === "quota_exceeded") {
         logger.log("ElevenLabs quota exceeded");
-        throw new Error("QUOTA_EXCEEDED");
+        throw logger.error("QUOTA_EXCEEDED");
       }
-      throw new Error(
+      throw logger.error(
         `Received status ${response.status} from Eleven Labs API: ${JSON.stringify(errorBody)}`
       );
     }
+    if (!response.body) {
+      throw logger.error("Empty response body from Eleven Labs API");
+    }
     return Readable.fromWeb(response.body);
   } catch (error) {
-    throw new Error(error);
+    const msg = error instanceof Error ? error.message : String(error);
+    throw logger.error(msg);
   }
 }
 var elevenLabsPlugin = {
@@ -97,19 +70,20 @@ var elevenLabsPlugin = {
   description: "ElevenLabs plugin",
   models: {
     [ModelType.TEXT_TO_SPEECH]: async (runtime, text) => {
+      const settings = getVoiceSettings(runtime);
+      logger.log(`[ElevenLabs] Using TEXT_TO_SPEECH model: ${settings.model}`);
       try {
         const stream = await fetchSpeech(runtime, text);
-        return getVoiceSettings(runtime).outputFormat.startsWith("pcm_") ? prependWavHeader(
+        return settings.outputFormat.startsWith("pcm_") ? prependWavHeader(
           stream,
           1024 * 1024 * 100,
-          Number.parseInt(getVoiceSettings(runtime).outputFormat.slice(4)),
+          Number.parseInt(settings.outputFormat.slice(4)),
           1,
           16
         ) : stream;
       } catch (error) {
-        throw new Error(
-          `Failed to fetch speech from Eleven Labs API: ${error.message || "Unknown error occurred"}`
-        );
+        const msg = error instanceof Error ? error.message : String(error);
+        throw logger.error(msg);
       }
     }
   },
@@ -121,7 +95,9 @@ var elevenLabsPlugin = {
           name: "Eleven Labs API key validation",
           fn: async (runtime) => {
             if (!getVoiceSettings(runtime).apiKey) {
-              throw new Error("Missing API key: Please provide a valid Eleven Labs API key.");
+              throw new Error(
+                "Missing API key: Please provide a valid Eleven Labs API key."
+              );
             }
           }
         },
@@ -131,9 +107,8 @@ var elevenLabsPlugin = {
             try {
               await fetchSpeech(runtime, "test");
             } catch (error) {
-              throw new Error(
-                `Failed to fetch speech from Eleven Labs API: ${error.message || "Unknown error occurred"}`
-              );
+              const msg = error instanceof Error ? error.message : String(error);
+              throw logger.error(msg);
             }
           }
         }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/utils.ts"],"sourcesContent":["import { Readable } from 'node:stream';\nimport { type IAgentRuntime, ModelType, type Plugin, logger } from '@elizaos/core';\nimport { prependWavHeader } from './utils';\n\n/**\n * Function to retrieve voice settings based on runtime and environment variables.\n * @param {IAgentRuntime} runtime - The agent runtime object.\n * @returns {Object} - Object containing various voice settings.\n */\nfunction getVoiceSettings(runtime: IAgentRuntime) {\n  const getSetting = (key: string, fallback = '') =>\n    process.env[key] || runtime.getSetting(key) || fallback;\n\n  return {\n    apiKey: getSetting('ELEVENLABS_API_KEY') || getSetting('ELEVENLABS_XI_API_KEY'),\n    voiceId: getSetting('ELEVENLABS_VOICE_ID', 'EXAVITQu4vr4xnSDxMaL'),\n    model: getSetting('ELEVENLABS_MODEL_ID', 'eleven_monolingual_v1'),\n    stability: getSetting('ELEVENLABS_VOICE_STABILITY', '0.5'),\n    latency: getSetting('ELEVENLABS_OPTIMIZE_STREAMING_LATENCY', '0'),\n    outputFormat: getSetting('ELEVENLABS_OUTPUT_FORMAT', 'pcm_16000'),\n    similarity: getSetting('ELEVENLABS_VOICE_SIMILARITY_BOOST', '0.75'),\n    style: getSetting('ELEVENLABS_VOICE_STYLE', '0'),\n    speakerBoost: getSetting('ELEVENLABS_VOICE_USE_SPEAKER_BOOST', 'true'),\n  };\n}\n\n/**\n * Fetch speech from Eleven Labs API using given text and runtime settings.\n * @param {IAgentRuntime} runtime - The runtime interface containing necessary data for the API call.\n * @param {string} text - The text to be converted into speech.\n * @returns {Promise<Readable>} A promise resolving to a readable stream of the fetched speech.\n */\nasync function fetchSpeech(runtime: IAgentRuntime, text: string) {\n  const settings = getVoiceSettings(runtime);\n  try {\n    const response = await fetch(\n      `https://api.elevenlabs.io/v1/text-to-speech/${settings.voiceId}/stream?optimize_streaming_latency=${settings.latency}&output_format=${settings.outputFormat}`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          'xi-api-key': settings.apiKey,\n        },\n        body: JSON.stringify({\n          model_id: settings.model,\n          text,\n          voice_settings: {\n            similarity_boost: settings.similarity,\n            stability: settings.stability,\n            style: settings.style,\n            use_speaker_boost: settings.speakerBoost,\n          },\n        }),\n      }\n    );\n    if (response.status !== 200) {\n      const errorBodyString = await response.text();\n      const errorBody = JSON.parse(errorBodyString);\n\n      if (response.status === 401 && errorBody.detail?.status === 'quota_exceeded') {\n        logger.log('ElevenLabs quota exceeded');\n        throw new Error('QUOTA_EXCEEDED');\n      }\n      throw new Error(\n        `Received status ${response.status} from Eleven Labs API: ${JSON.stringify(errorBody)}`\n      );\n    }\n    return Readable.fromWeb(response.body);\n  } catch (error) {\n    throw new Error(error);\n  }\n}\n\n/**\n * Represents the ElevenLabs plugin.\n * This plugin provides functionality related to ElevenLabs API, including text to speech conversion.\n * @type {Plugin}\n */\nexport const elevenLabsPlugin: Plugin = {\n  name: 'elevenLabs',\n  description: 'ElevenLabs plugin',\n  models: {\n    [ModelType.TEXT_TO_SPEECH]: async (runtime, text) => {\n      try {\n        const stream = await fetchSpeech(runtime, text);\n        return getVoiceSettings(runtime).outputFormat.startsWith('pcm_')\n          ? prependWavHeader(\n              stream,\n              1024 * 1024 * 100,\n              Number.parseInt(getVoiceSettings(runtime).outputFormat.slice(4)),\n              1,\n              16\n            )\n          : stream;\n      } catch (error) {\n        throw new Error(\n          `Failed to fetch speech from Eleven Labs API: ${error.message || 'Unknown error occurred'}`\n        );\n      }\n    },\n  },\n  tests: [\n    {\n      name: 'test eleven labs',\n      tests: [\n        {\n          name: 'Eleven Labs API key validation',\n          fn: async (runtime: IAgentRuntime) => {\n            if (!getVoiceSettings(runtime).apiKey) {\n              throw new Error('Missing API key: Please provide a valid Eleven Labs API key.');\n            }\n          },\n        },\n        {\n          name: 'Eleven Labs API response',\n          fn: async (runtime: IAgentRuntime) => {\n            try {\n              await fetchSpeech(runtime, 'test');\n            } catch (error) {\n              throw new Error(\n                `Failed to fetch speech from Eleven Labs API: ${error.message || 'Unknown error occurred'}`\n              );\n            }\n          },\n        },\n      ],\n    },\n  ],\n};\nexport default elevenLabsPlugin;\n","import { PassThrough } from 'node:stream';\nimport type { Readable } from 'node:stream';\n\n/**\n * Generates a WAV file header based on the provided audio parameters.\n * @param {number} audioLength - The length of the audio data in bytes.\n * @param {number} sampleRate - The sample rate of the audio.\n * @param {number} [channelCount=1] - The number of channels (default is 1).\n * @param {number} [bitsPerSample=16] - The number of bits per sample (default is 16).\n * @returns {Buffer} The WAV file header as a Buffer object.\n */\nexport function getWavHeader(\n  audioLength: number,\n  sampleRate: number,\n  channelCount = 1,\n  bitsPerSample = 16\n): Buffer {\n  const wavHeader = Buffer.alloc(44);\n  wavHeader.write('RIFF', 0);\n  wavHeader.writeUInt32LE(36 + audioLength, 4); // Length of entire file in bytes minus 8\n  wavHeader.write('WAVE', 8);\n  wavHeader.write('fmt ', 12);\n  wavHeader.writeUInt32LE(16, 16); // Length of format data\n  wavHeader.writeUInt16LE(1, 20); // Type of format (1 is PCM)\n  wavHeader.writeUInt16LE(channelCount, 22); // Number of channels\n  wavHeader.writeUInt32LE(sampleRate, 24); // Sample rate\n  wavHeader.writeUInt32LE((sampleRate * bitsPerSample * channelCount) / 8, 28); // Byte rate\n  wavHeader.writeUInt16LE((bitsPerSample * channelCount) / 8, 32); // Block align ((BitsPerSample * Channels) / 8)\n  wavHeader.writeUInt16LE(bitsPerSample, 34); // Bits per sample\n  wavHeader.write('data', 36); // Data chunk header\n  wavHeader.writeUInt32LE(audioLength, 40); // Data chunk size\n  return wavHeader;\n}\n\n/**\n * Prepends a WAV header to a readable stream of audio data.\n *\n * @param {Readable} readable - The readable stream containing the audio data.\n * @param {number} audioLength - The length of the audio data in seconds.\n * @param {number} sampleRate - The sample rate of the audio data.\n * @param {number} [channelCount=1] - The number of channels in the audio data (default is 1).\n * @param {number} [bitsPerSample=16] - The number of bits per sample in the audio data (default is 16).\n * @returns {Readable} A new readable stream with the WAV header prepended to the audio data.\n */\nexport function prependWavHeader(\n  readable: Readable,\n  audioLength: number,\n  sampleRate: number,\n  channelCount = 1,\n  bitsPerSample = 16\n): Readable {\n  const wavHeader = getWavHeader(audioLength, sampleRate, channelCount, bitsPerSample);\n  let pushedHeader = false;\n  const passThrough = new PassThrough();\n  readable.on('data', (data) => {\n    if (!pushedHeader) {\n      passThrough.push(wavHeader);\n      pushedHeader = true;\n    }\n    passThrough.push(data);\n  });\n  readable.on('end', () => {\n    passThrough.end();\n  });\n  return passThrough;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import {\n  type IAgentRuntime,\n  ModelType,\n  type Plugin,\n  logger,\n  prependWavHeader,\n  parseBooleanFromText,\n} from \"@elizaos/core\";\nimport { Readable } from \"node:stream\";\n\n/**\n * Function to retrieve voice settings based on runtime and environment variables.\n * @param {IAgentRuntime} runtime - The agent runtime object.\n * @returns {Object} - Object containing various voice settings.\n */\nfunction getVoiceSettings(runtime: IAgentRuntime) {\n  const getSetting = (key: string, fallback = \"\") =>\n    process.env[key] || runtime.getSetting(key) || fallback;\n\n  return {\n    apiKey:\n      getSetting(\"ELEVENLABS_API_KEY\") || getSetting(\"ELEVENLABS_XI_API_KEY\"),\n    voiceId: getSetting(\"ELEVENLABS_VOICE_ID\", \"EXAVITQu4vr4xnSDxMaL\"),\n    model: getSetting(\"ELEVENLABS_MODEL_ID\", \"eleven_monolingual_v1\"),\n    stability: getSetting(\"ELEVENLABS_VOICE_STABILITY\", \"0.5\"),\n    latency: getSetting(\"ELEVENLABS_OPTIMIZE_STREAMING_LATENCY\", \"0\"),\n    outputFormat: getSetting(\"ELEVENLABS_OUTPUT_FORMAT\", \"pcm_16000\"),\n    similarity: getSetting(\"ELEVENLABS_VOICE_SIMILARITY_BOOST\", \"0.75\"),\n    style: getSetting(\"ELEVENLABS_VOICE_STYLE\", \"0\"),\n    speakerBoost: parseBooleanFromText(\n      getSetting(\"ELEVENLABS_VOICE_USE_SPEAKER_BOOST\", \"true\")\n    ),\n  };\n}\n\n/**\n * Fetch speech from Eleven Labs API using given text and runtime settings.\n * @param {IAgentRuntime} runtime - The runtime interface containing necessary data for the API call.\n * @param {string} text - The text to be converted into speech.\n * @returns {Promise<Readable>} A promise resolving to a readable stream of the fetched speech.\n */\nasync function fetchSpeech(runtime: IAgentRuntime, text: string) {\n  const settings = getVoiceSettings(runtime);\n  try {\n    const response = await fetch(\n      `https://api.elevenlabs.io/v1/text-to-speech/${settings.voiceId}/stream?optimize_streaming_latency=${settings.latency}&output_format=${settings.outputFormat}`,\n      {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          \"xi-api-key\": settings.apiKey,\n        },\n        body: JSON.stringify({\n          model_id: settings.model,\n          text,\n          voice_settings: {\n            similarity_boost: settings.similarity,\n            stability: settings.stability,\n            style: settings.style,\n            use_speaker_boost: settings.speakerBoost,\n          },\n        }),\n      }\n    );\n    if (response.status !== 200) {\n      const errorBodyString = await response.text();\n      const errorBody = JSON.parse(errorBodyString);\n\n      if (\n        response.status === 401 &&\n        errorBody.detail?.status === \"quota_exceeded\"\n      ) {\n        logger.log(\"ElevenLabs quota exceeded\");\n        throw logger.error(\"QUOTA_EXCEEDED\");\n      }\n      throw logger.error(\n        `Received status ${response.status} from Eleven Labs API: ${JSON.stringify(errorBody)}`\n      );\n    }\n\n    if (!response.body) {\n      throw logger.error(\"Empty response body from Eleven Labs API\");\n    }\n\n    return Readable.fromWeb(response.body);\n  } catch (error: unknown) {\n    const msg = error instanceof Error ? error.message : String(error);\n    throw logger.error(msg);\n  }\n}\n\n/**\n * Represents the ElevenLabs plugin.\n * This plugin provides functionality related to ElevenLabs API, including text to speech conversion.\n * @type {Plugin}\n */\nexport const elevenLabsPlugin: Plugin = {\n  name: \"elevenLabs\",\n  description: \"ElevenLabs plugin\",\n  models: {\n    [ModelType.TEXT_TO_SPEECH]: async (runtime, text) => {\n      const settings = getVoiceSettings(runtime);\n      logger.log(`[ElevenLabs] Using TEXT_TO_SPEECH model: ${settings.model}`);\n      try {\n        const stream = await fetchSpeech(runtime, text);\n        return settings.outputFormat.startsWith(\"pcm_\")\n          ? prependWavHeader(\n              stream,\n              1024 * 1024 * 100,\n              Number.parseInt(settings.outputFormat.slice(4)),\n              1,\n              16\n            )\n          : stream;\n      } catch (error: unknown) {\n        const msg = error instanceof Error ? error.message : String(error);\n        throw logger.error(msg);\n      }\n    },\n  },\n  tests: [\n    {\n      name: \"test eleven labs\",\n      tests: [\n        {\n          name: \"Eleven Labs API key validation\",\n          fn: async (runtime: IAgentRuntime) => {\n            if (!getVoiceSettings(runtime).apiKey) {\n              throw new Error(\n                \"Missing API key: Please provide a valid Eleven Labs API key.\"\n              );\n            }\n          },\n        },\n        {\n          name: \"Eleven Labs API response\",\n          fn: async (runtime: IAgentRuntime) => {\n            try {\n              await fetchSpeech(runtime, \"test\");\n            } catch (error: unknown) {\n              const msg =\n                error instanceof Error ? error.message : String(error);\n              throw logger.error(msg);\n            }\n          },\n        },\n      ],\n    },\n  ],\n};\nexport default elevenLabsPlugin;\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/plugin-elevenlabs",
-  "version": "1.0.0-beta.5",
+  "version": "1.0.0-beta.51",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -22,7 +22,7 @@
     "dist"
   ],
   "dependencies": {
-    "@elizaos/core": "^1.0.0-beta.5",
+    "@elizaos/core": "^1.0.0-beta.51",
     "tsup": "8.4.0"
   },
   "scripts": {
@@ -77,8 +77,10 @@
       }
     }
   },
-  "gitHead": "77906e6ce08019d6184c7662f80742ed804555b7",
+  "gitHead": "646c632924826e2b75c2304a75ee56959fe4a460",
   "devDependencies": {
-    "prettier": "3.5.3"
+    "@types/node": "^22.15.18",
+    "prettier": "3.5.3",
+    "typescript": "^5.8.2"
   }
 }