@elizaos/plugin-edge-tts 2.0.0-beta.1 → 2.0.3-beta.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 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
+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

@@ -1,6 +1,6 @@
 # @elizaos/plugin-edge-tts
 
-Free text-to-speech plugin for ElizaOS using Microsoft Edge TTS. No API key required.
+Free text-to-speech plugin for elizaOS using Microsoft Edge TTS. No API key required.
 
 ## Features
 
@@ -18,7 +18,7 @@ npm install @elizaos/plugin-edge-tts
 
 ## Usage
 
-### As ElizaOS Plugin
+### As elizaOS Plugin
 
 ```typescript
 import { edgeTTSPlugin } from "@elizaos/plugin-edge-tts";
@@ -90,6 +90,3 @@ Edge TTS is **not available in browser environments** because it requires:
 
 For browser TTS, use `@elizaos/plugin-elevenlabs` or `@elizaos/plugin-openai` instead.
 
-## License
-
-MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/plugin-edge-tts",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.3-beta.2",
   "type": "module",
   "main": "dist/node/index.node.js",
   "module": "dist/node/index.node.js",
@@ -16,6 +16,11 @@
     "./package.json": "./package.json",
     ".": {
       "types": "./dist/index.d.ts",
+      "eliza-source": {
+        "types": "./src/index.node.ts",
+        "import": "./src/index.node.ts",
+        "default": "./src/index.node.ts"
+      },
       "browser": {
         "types": "./dist/browser/index.d.ts",
         "import": "./dist/browser/index.browser.js",
@@ -37,6 +42,12 @@
       "types": "./dist/browser/index.d.ts",
       "import": "./dist/browser/index.browser.js",
       "default": "./dist/browser/index.browser.js"
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
     }
   },
   "files": [
@@ -52,14 +63,16 @@
     }
   },
   "dependencies": {
-    "@elizaos/core": "2.0.0-beta.1",
+    "@elizaos/core": "2.0.3-beta.2",
     "node-edge-tts": "^1.0.7"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.14",
     "@types/bun": "^1.2.22",
     "@types/node": "^24.5.2",
-    "typescript": "^6.0.3"
+    "bun-types": "1.3.14",
+    "typescript": "^6.0.3",
+    "vitest": "^4.0.17"
   },
   "scripts": {
     "build": "bun run build.ts",
@@ -70,7 +83,7 @@
     "format:check": "bunx @biomejs/biome format .",
     "lint": "bunx @biomejs/biome check --write --unsafe .",
     "lint:check": "bunx @biomejs/biome check .",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsgo --noEmit",
     "test:e2e": "node ../../packages/app-core/scripts/run-local-plugin-live-smoke.mjs",
     "test:live": "bun run test:e2e"
   },
@@ -144,5 +157,6 @@
       "browser": "Browser-compatible build available via exports.browser",
       "node": "Node.js build available via exports.node"
     }
-  }
+  },
+  "gitHead": "82fe0f44215954c2417328203f5bd6510985c1fc"
 }

package/dist/browser/index.browser.js

@@ -1,3 +0,0 @@
-import{logger as f}from"@elizaos/core";var j={name:"edge-tts",description:"Edge TTS plugin (browser stub - not available in browser environments)",models:{},tests:[]};if(typeof window<"u")f.warn("[EdgeTTS] Edge TTS is not available in browser environments. Use @elizaos/plugin-elevenlabs or @elizaos/plugin-openai for browser TTS.");var v=j;export{j as edgeTTSPlugin,v as default};
-
-//# debugId=A1DF4939E5621A8064756E2164756E21

package/dist/browser/index.browser.js.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/index.browser.ts"],
-  "sourcesContent": [
-    "/**\n * Browser entry point for @elizaos/plugin-edge-tts\n *\n * Edge TTS is not available in browser environments because it requires\n * Node.js file system access and WebSocket connections that browsers don't support.\n *\n * For browser TTS, use @elizaos/plugin-elevenlabs or @elizaos/plugin-openai instead.\n */\nimport { logger, type Plugin } from \"@elizaos/core\";\n\nexport const edgeTTSPlugin: Plugin = {\n  name: \"edge-tts\",\n  description: \"Edge TTS plugin (browser stub - not available in browser environments)\",\n  models: {},\n  tests: [],\n};\n\n// Log warning when imported in browser\nif (typeof window !== \"undefined\") {\n  logger.warn(\n    \"[EdgeTTS] Edge TTS is not available in browser environments. \" +\n      \"Use @elizaos/plugin-elevenlabs or @elizaos/plugin-openai for browser TTS.\"\n  );\n}\n\nexport default edgeTTSPlugin;\n"
-  ],
-  "mappings": "AAQA,iBAAS,sBAEF,IAAM,EAAwB,CACnC,KAAM,WACN,YAAa,yEACb,OAAQ,CAAC,EACT,MAAO,CAAC,CACV,EAGA,GAAI,OAAO,OAAW,IACpB,EAAO,KACL,wIAEF,EAGF,IAAe",
-  "debugId": "A1DF4939E5621A8064756E2164756E21",
-  "names": []
-}

package/dist/browser/index.d.ts

@@ -1,2 +0,0 @@
-export * from '../index';
-export { default } from '../index';

package/dist/cjs/index.d.ts

@@ -1,2 +0,0 @@
-export * from '../index';
-export { default } from '../index';

package/dist/cjs/index.js

@@ -1,316 +0,0 @@
-var __create = Object.create;
-var __getProtoOf = Object.getPrototypeOf;
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-function __accessProp(key) {
-	return this[key];
-}
-var __toESMCache_node;
-var __toESMCache_esm;
-var __toESM = (mod, isNodeMode, target) => {
-	var canCache = mod != null && typeof mod === "object";
-	if (canCache) {
-		var cache = isNodeMode
-			? (__toESMCache_node ??= new WeakMap())
-			: (__toESMCache_esm ??= new WeakMap());
-		var cached = cache.get(mod);
-		if (cached) return cached;
-	}
-	target = mod != null ? __create(__getProtoOf(mod)) : {};
-	const to =
-		isNodeMode || !mod || !mod.__esModule
-			? __defProp(target, "default", { value: mod, enumerable: true })
-			: target;
-	for (const key of __getOwnPropNames(mod))
-		if (!__hasOwnProp.call(to, key))
-			__defProp(to, key, {
-				get: __accessProp.bind(mod, key),
-				enumerable: true,
-			});
-	if (canCache) cache.set(mod, to);
-	return to;
-};
-var __toCommonJS = (from) => {
-	var entry = (__moduleCache ??= new WeakMap()).get(from),
-		desc;
-	if (entry) return entry;
-	entry = __defProp({}, "__esModule", { value: true });
-	if ((from && typeof from === "object") || typeof from === "function") {
-		for (var key of __getOwnPropNames(from))
-			if (!__hasOwnProp.call(entry, key))
-				__defProp(entry, key, {
-					get: __accessProp.bind(from, key),
-					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable,
-				});
-	}
-	__moduleCache.set(from, entry);
-	return entry;
-};
-var __moduleCache;
-var __returnValue = (v) => v;
-function __exportSetter(name, newValue) {
-	this[name] = __returnValue.bind(null, newValue);
-}
-var __export = (target, all) => {
-	for (var name in all)
-		__defProp(target, name, {
-			get: all[name],
-			enumerable: true,
-			configurable: true,
-			set: __exportSetter.bind(all, name),
-		});
-};
-
-// src/index.ts
-var exports_src = {};
-__export(exports_src, {
-	edgeTTSPlugin: () => edgeTTSPlugin,
-	default: () => src_default,
-	_test: () => _test,
-});
-module.exports = __toCommonJS(exports_src);
-var import_node_fs = require("node:fs");
-var import_node_os = require("node:os");
-var import_node_path = __toESM(require("node:path"));
-var import_core = require("@elizaos/core");
-var import_node_edge_tts = require("node-edge-tts");
-var DEFAULT_VOICE = "en-US-MichelleNeural";
-var DEFAULT_LANG = "en-US";
-var DEFAULT_OUTPUT_FORMAT = "audio-24khz-48kbitrate-mono-mp3";
-var DEFAULT_TIMEOUT_MS = 30000;
-var VOICE_PRESETS = {
-	alloy: "en-US-GuyNeural",
-	echo: "en-US-ChristopherNeural",
-	fable: "en-GB-RyanNeural",
-	onyx: "en-US-DavisNeural",
-	nova: "en-US-JennyNeural",
-	shimmer: "en-US-AriaNeural",
-};
-function getSetting(runtime, key, fallback) {
-	const envValue =
-		typeof process !== "undefined" && process.env
-			? process.env[key]
-			: undefined;
-	return runtime.getSetting(key) ?? envValue ?? fallback;
-}
-function getEdgeTTSSettings(runtime) {
-	const timeoutStr = getSetting(runtime, "EDGE_TTS_TIMEOUT_MS");
-	return {
-		voice:
-			getSetting(runtime, "EDGE_TTS_VOICE", DEFAULT_VOICE) ?? DEFAULT_VOICE,
-		lang: getSetting(runtime, "EDGE_TTS_LANG", DEFAULT_LANG) ?? DEFAULT_LANG,
-		outputFormat:
-			getSetting(runtime, "EDGE_TTS_OUTPUT_FORMAT", DEFAULT_OUTPUT_FORMAT) ??
-			DEFAULT_OUTPUT_FORMAT,
-		rate: getSetting(runtime, "EDGE_TTS_RATE"),
-		pitch: getSetting(runtime, "EDGE_TTS_PITCH"),
-		volume: getSetting(runtime, "EDGE_TTS_VOLUME"),
-		proxy: getSetting(runtime, "EDGE_TTS_PROXY"),
-		timeoutMs: timeoutStr
-			? Number.parseInt(timeoutStr, 10)
-			: DEFAULT_TIMEOUT_MS,
-	};
-}
-function resolveVoice(voice, defaultVoice) {
-	if (!voice) return defaultVoice;
-	const preset = VOICE_PRESETS[voice.toLowerCase()];
-	if (preset) return preset;
-	return voice;
-}
-function speedToRate(speed) {
-	if (speed === undefined || speed === 1) return;
-	const percentage = Math.round((speed - 1) * 100);
-	return percentage >= 0 ? `+${percentage}%` : `${percentage}%`;
-}
-function inferExtension(outputFormat) {
-	const normalized = outputFormat.toLowerCase();
-	if (normalized.includes("webm")) return ".webm";
-	if (normalized.includes("ogg")) return ".ogg";
-	if (normalized.includes("opus")) return ".opus";
-	if (
-		normalized.includes("wav") ||
-		normalized.includes("riff") ||
-		normalized.includes("pcm")
-	) {
-		return ".wav";
-	}
-	return ".mp3";
-}
-async function generateSpeech(settings, params) {
-	const voice = resolveVoice(params.voice, settings.voice);
-	const lang = params.lang ?? settings.lang;
-	const outputFormat = params.outputFormat ?? settings.outputFormat;
-	const rate = params.rate ?? speedToRate(params.speed) ?? settings.rate;
-	const pitch = params.pitch ?? settings.pitch;
-	const volume = params.volume ?? settings.volume;
-	import_core.logger.debug(
-		`[EdgeTTS] Generating speech with voice: ${voice}, lang: ${lang}`,
-	);
-	const tts = new import_node_edge_tts.EdgeTTS({
-		voice,
-		lang,
-		outputFormat,
-		saveSubtitles: false,
-		proxy: settings.proxy,
-		rate,
-		pitch,
-		volume,
-		timeout: settings.timeoutMs,
-	});
-	const tempDir = import_node_fs.mkdtempSync(
-		import_node_path.default.join(import_node_os.tmpdir(), "edge-tts-"),
-	);
-	const extension = inferExtension(outputFormat);
-	const outputPath = import_node_path.default.join(
-		tempDir,
-		`speech${extension}`,
-	);
-	try {
-		await tts.ttsPromise(params.text, outputPath);
-		const audioBuffer = import_node_fs.readFileSync(outputPath);
-		return audioBuffer;
-	} finally {
-		try {
-			import_node_fs.rmSync(tempDir, { recursive: true, force: true });
-		} catch {}
-	}
-}
-var edgeTTSPlugin = {
-	name: "edge-tts",
-	description:
-		"Free text-to-speech synthesis using Microsoft Edge TTS - no API key required, high-quality neural voices",
-	models: {
-		[import_core.ModelType.TEXT_TO_SPEECH]: async (runtime, input) => {
-			const params = typeof input === "string" ? { text: input } : input;
-			const settings = getEdgeTTSSettings(runtime);
-			import_core.logger.log(
-				`[EdgeTTS] Using TEXT_TO_SPEECH with voice: ${settings.voice}`,
-			);
-			if (!params.text || params.text.trim().length === 0) {
-				throw new Error("TEXT_TO_SPEECH requires non-empty text");
-			}
-			if (params.text.length > 5000) {
-				throw new Error("TEXT_TO_SPEECH text exceeds 5000 character limit");
-			}
-			try {
-				const audioBuffer = await generateSpeech(settings, params);
-				return audioBuffer;
-			} catch (error) {
-				const msg = error instanceof Error ? error.message : String(error);
-				import_core.logger.error(`EdgeTTS model error: ${msg}`);
-				throw error instanceof Error ? error : new Error(msg);
-			}
-		},
-	},
-	tests: [
-		{
-			name: "test edge tts",
-			tests: [
-				{
-					name: "Edge TTS settings validation",
-					fn: async (runtime) => {
-						const settings = getEdgeTTSSettings(runtime);
-						if (!settings.voice) {
-							throw new Error("Missing voice configuration");
-						}
-						if (!settings.lang) {
-							throw new Error("Missing language configuration");
-						}
-						if (!settings.outputFormat) {
-							throw new Error("Missing output format configuration");
-						}
-						import_core.logger.success(
-							"Edge TTS settings validated successfully",
-						);
-					},
-				},
-				{
-					name: "Edge TTS voice preset mapping",
-					fn: async (_runtime) => {
-						const testCases = [
-							{ input: "alloy", expected: "en-US-GuyNeural" },
-							{ input: "nova", expected: "en-US-JennyNeural" },
-							{ input: "shimmer", expected: "en-US-AriaNeural" },
-							{
-								input: "en-US-MichelleNeural",
-								expected: "en-US-MichelleNeural",
-							},
-						];
-						for (const tc of testCases) {
-							const result = resolveVoice(tc.input, DEFAULT_VOICE);
-							if (result !== tc.expected) {
-								throw new Error(
-									`Voice preset mapping failed: ${tc.input} -> ${result}, expected ${tc.expected}`,
-								);
-							}
-						}
-						import_core.logger.success(
-							"Voice preset mapping validated successfully",
-						);
-					},
-				},
-				{
-					name: "Edge TTS speed to rate conversion",
-					fn: async (_runtime) => {
-						const testCases = [
-							{ speed: 1, expected: undefined },
-							{ speed: 1.5, expected: "+50%" },
-							{ speed: 0.75, expected: "-25%" },
-							{ speed: 2, expected: "+100%" },
-						];
-						for (const tc of testCases) {
-							const result = speedToRate(tc.speed);
-							if (result !== tc.expected) {
-								throw new Error(
-									`Speed conversion failed: ${tc.speed} -> ${result}, expected ${tc.expected}`,
-								);
-							}
-						}
-						import_core.logger.success(
-							"Speed to rate conversion validated successfully",
-						);
-					},
-				},
-				{
-					name: "Edge TTS generation (live test)",
-					fn: async (runtime) => {
-						const testText = "Hello, this is a test of Edge TTS.";
-						try {
-							const audioBuffer = await runtime.useModel(
-								import_core.ModelType.TEXT_TO_SPEECH,
-								testText,
-							);
-							if (!audioBuffer || audioBuffer.length === 0) {
-								throw new Error("Received empty audio buffer");
-							}
-							import_core.logger.success(
-								`Edge TTS generation successful: ${audioBuffer.length} bytes`,
-							);
-						} catch (error) {
-							const msg =
-								error instanceof Error ? error.message : String(error);
-							if (msg.includes("ENOTFOUND") || msg.includes("network")) {
-								import_core.logger.warn(
-									`Edge TTS live test skipped (network unavailable): ${msg}`,
-								);
-								return;
-							}
-							throw error;
-						}
-					},
-				},
-			],
-		},
-	],
-};
-var src_default = edgeTTSPlugin;
-var _test = {
-	resolveVoice,
-	speedToRate,
-	inferExtension,
-	getEdgeTTSSettings,
-};
-
-//# debugId=302D9C6A4A9C013564756E2164756E21

package/dist/cjs/index.js.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/index.ts"],
-  "sourcesContent": [
-    "import { mkdtempSync, readFileSync, rmSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport path from \"node:path\";\nimport { type IAgentRuntime, logger, ModelType, type Plugin } from \"@elizaos/core\";\nimport { EdgeTTS } from \"node-edge-tts\";\n\n/**\n * Edge TTS voice settings configuration\n */\ninterface EdgeTTSSettings {\n  voice: string;\n  lang: string;\n  outputFormat: string;\n  rate?: string;\n  pitch?: string;\n  volume?: string;\n  proxy?: string;\n  timeoutMs: number;\n}\n\n/**\n * Extended TTS params with Edge-specific options\n */\ninterface EdgeTTSParams {\n  text: string;\n  voice?: string;\n  speed?: number;\n  /** Edge TTS specific: language code */\n  lang?: string;\n  /** Edge TTS specific: output format */\n  outputFormat?: string;\n  /** Edge TTS specific: rate adjustment (e.g., +10%, -5%) */\n  rate?: string;\n  /** Edge TTS specific: pitch adjustment (e.g., +5Hz, -10Hz) */\n  pitch?: string;\n  /** Edge TTS specific: volume adjustment (e.g., +20%, -10%) */\n  volume?: string;\n}\n\n// Default voice configurations\nconst DEFAULT_VOICE = \"en-US-MichelleNeural\";\nconst DEFAULT_LANG = \"en-US\";\nconst DEFAULT_OUTPUT_FORMAT = \"audio-24khz-48kbitrate-mono-mp3\";\nconst DEFAULT_TIMEOUT_MS = 30000;\n\n// Voice presets mapping common voice names to Edge TTS voices\nconst VOICE_PRESETS: Record<string, string> = {\n  // Generic voices (map to good defaults)\n  alloy: \"en-US-GuyNeural\",\n  echo: \"en-US-ChristopherNeural\",\n  fable: \"en-GB-RyanNeural\",\n  onyx: \"en-US-DavisNeural\",\n  nova: \"en-US-JennyNeural\",\n  shimmer: \"en-US-AriaNeural\",\n  // Direct Edge TTS voice names pass through\n};\n\nfunction getSetting(runtime: IAgentRuntime, key: string, fallback?: string): string | undefined {\n  const envValue =\n    typeof process !== \"undefined\" && (process as { env?: Record<string, string> }).env\n      ? (process as { env: Record<string, string> }).env[key]\n      : undefined;\n  return (runtime.getSetting(key) as string | undefined) ?? envValue ?? fallback;\n}\n\nfunction getEdgeTTSSettings(runtime: IAgentRuntime): EdgeTTSSettings {\n  const timeoutStr = getSetting(runtime, \"EDGE_TTS_TIMEOUT_MS\");\n  return {\n    voice: getSetting(runtime, \"EDGE_TTS_VOICE\", DEFAULT_VOICE) ?? DEFAULT_VOICE,\n    lang: getSetting(runtime, \"EDGE_TTS_LANG\", DEFAULT_LANG) ?? DEFAULT_LANG,\n    outputFormat:\n      getSetting(runtime, \"EDGE_TTS_OUTPUT_FORMAT\", DEFAULT_OUTPUT_FORMAT) ?? DEFAULT_OUTPUT_FORMAT,\n    rate: getSetting(runtime, \"EDGE_TTS_RATE\"),\n    pitch: getSetting(runtime, \"EDGE_TTS_PITCH\"),\n    volume: getSetting(runtime, \"EDGE_TTS_VOLUME\"),\n    proxy: getSetting(runtime, \"EDGE_TTS_PROXY\"),\n    timeoutMs: timeoutStr ? Number.parseInt(timeoutStr, 10) : DEFAULT_TIMEOUT_MS,\n  };\n}\n\n/**\n * Resolve voice name - handles OpenAI-style voice names and Edge TTS voice IDs\n */\nfunction resolveVoice(voice: string | undefined, defaultVoice: string): string {\n  if (!voice) return defaultVoice;\n\n  // Check if it's a preset name\n  const preset = VOICE_PRESETS[voice.toLowerCase()];\n  if (preset) return preset;\n\n  // Assume it's a direct Edge TTS voice ID\n  return voice;\n}\n\n/**\n * Convert speed multiplier to Edge TTS rate string\n * speed: 1.0 = normal, 0.5 = half speed, 2.0 = double speed\n */\nfunction speedToRate(speed: number | undefined): string | undefined {\n  if (speed === undefined || speed === 1.0) return undefined;\n  const percentage = Math.round((speed - 1) * 100);\n  return percentage >= 0 ? `+${percentage}%` : `${percentage}%`;\n}\n\n/**\n * Infer file extension from Edge TTS output format\n */\nfunction inferExtension(outputFormat: string): string {\n  const normalized = outputFormat.toLowerCase();\n  if (normalized.includes(\"webm\")) return \".webm\";\n  if (normalized.includes(\"ogg\")) return \".ogg\";\n  if (normalized.includes(\"opus\")) return \".opus\";\n  if (normalized.includes(\"wav\") || normalized.includes(\"riff\") || normalized.includes(\"pcm\")) {\n    return \".wav\";\n  }\n  return \".mp3\";\n}\n\n/**\n * Generate speech using Microsoft Edge TTS\n */\nasync function generateSpeech(settings: EdgeTTSSettings, params: EdgeTTSParams): Promise<Buffer> {\n  const voice = resolveVoice(params.voice, settings.voice);\n  const lang = params.lang ?? settings.lang;\n  const outputFormat = params.outputFormat ?? settings.outputFormat;\n  const rate = params.rate ?? speedToRate(params.speed) ?? settings.rate;\n  const pitch = params.pitch ?? settings.pitch;\n  const volume = params.volume ?? settings.volume;\n\n  logger.debug(`[EdgeTTS] Generating speech with voice: ${voice}, lang: ${lang}`);\n\n  const tts = new EdgeTTS({\n    voice,\n    lang,\n    outputFormat,\n    saveSubtitles: false,\n    proxy: settings.proxy,\n    rate,\n    pitch,\n    volume,\n    timeout: settings.timeoutMs,\n  });\n\n  // Create temp directory for output\n  const tempDir = mkdtempSync(path.join(tmpdir(), \"edge-tts-\"));\n  const extension = inferExtension(outputFormat);\n  const outputPath = path.join(tempDir, `speech${extension}`);\n\n  try {\n    await tts.ttsPromise(params.text, outputPath);\n    const audioBuffer = readFileSync(outputPath);\n    return audioBuffer;\n  } finally {\n    // Cleanup temp directory\n    try {\n      rmSync(tempDir, { recursive: true, force: true });\n    } catch {\n      // Ignore cleanup errors\n    }\n  }\n}\n\n/**\n * Edge TTS Plugin for ElizaOS\n *\n * Provides free text-to-speech synthesis using Microsoft Edge's TTS service.\n * No API key required - uses the same TTS engine as Microsoft Edge browser.\n *\n * Features:\n * - High-quality neural voices\n * - Multiple languages and locales\n * - Adjustable rate, pitch, and volume\n * - No API key or payment required\n *\n * Optional environment variables:\n * - EDGE_TTS_VOICE: Voice ID (default: en-US-MichelleNeural)\n * - EDGE_TTS_LANG: Language code (default: en-US)\n * - EDGE_TTS_OUTPUT_FORMAT: Output format (default: audio-24khz-48kbitrate-mono-mp3)\n * - EDGE_TTS_RATE: Speech rate adjustment (e.g., +10%, -5%)\n * - EDGE_TTS_PITCH: Pitch adjustment (e.g., +5Hz, -10Hz)\n * - EDGE_TTS_VOLUME: Volume adjustment (e.g., +20%, -10%)\n * - EDGE_TTS_PROXY: HTTP proxy URL\n * - EDGE_TTS_TIMEOUT_MS: Request timeout (default: 30000)\n *\n * Popular voices:\n * - en-US-MichelleNeural (female, US English)\n * - en-US-GuyNeural (male, US English)\n * - en-US-JennyNeural (female, US English)\n * - en-US-AriaNeural (female, US English)\n * - en-GB-SoniaNeural (female, UK English)\n * - en-GB-RyanNeural (male, UK English)\n * - de-DE-KatjaNeural (female, German)\n * - fr-FR-DeniseNeural (female, French)\n * - es-ES-ElviraNeural (female, Spanish)\n * - ja-JP-NanamiNeural (female, Japanese)\n * - zh-CN-XiaoxiaoNeural (female, Chinese)\n */\nexport const edgeTTSPlugin: Plugin = {\n  name: \"edge-tts\",\n  description:\n    \"Free text-to-speech synthesis using Microsoft Edge TTS - no API key required, high-quality neural voices\",\n  models: {\n    [ModelType.TEXT_TO_SPEECH]: async (\n      runtime: IAgentRuntime,\n      input: string | EdgeTTSParams\n    ): Promise<Buffer | ArrayBuffer | Uint8Array> => {\n      const params: EdgeTTSParams = typeof input === \"string\" ? { text: input } : input;\n      const settings = getEdgeTTSSettings(runtime);\n\n      logger.log(`[EdgeTTS] Using TEXT_TO_SPEECH with voice: ${settings.voice}`);\n\n      if (!params.text || params.text.trim().length === 0) {\n        throw new Error(\"TEXT_TO_SPEECH requires non-empty text\");\n      }\n\n      // Edge TTS has a practical limit around 5000 characters\n      if (params.text.length > 5000) {\n        throw new Error(\"TEXT_TO_SPEECH text exceeds 5000 character limit\");\n      }\n\n      try {\n        const audioBuffer = await generateSpeech(settings, params);\n        return audioBuffer;\n      } catch (error: unknown) {\n        const msg = error instanceof Error ? error.message : String(error);\n        logger.error(`EdgeTTS model error: ${msg}`);\n        throw error instanceof Error ? error : new Error(msg);\n      }\n    },\n  },\n  tests: [\n    {\n      name: \"test edge tts\",\n      tests: [\n        {\n          name: \"Edge TTS settings validation\",\n          fn: async (runtime: IAgentRuntime) => {\n            const settings = getEdgeTTSSettings(runtime);\n\n            if (!settings.voice) {\n              throw new Error(\"Missing voice configuration\");\n            }\n\n            if (!settings.lang) {\n              throw new Error(\"Missing language configuration\");\n            }\n\n            if (!settings.outputFormat) {\n              throw new Error(\"Missing output format configuration\");\n            }\n\n            logger.success(\"Edge TTS settings validated successfully\");\n          },\n        },\n        {\n          name: \"Edge TTS voice preset mapping\",\n          fn: async (_runtime: IAgentRuntime) => {\n            // Test that OpenAI-style voice names map correctly\n            const testCases = [\n              { input: \"alloy\", expected: \"en-US-GuyNeural\" },\n              { input: \"nova\", expected: \"en-US-JennyNeural\" },\n              { input: \"shimmer\", expected: \"en-US-AriaNeural\" },\n              {\n                input: \"en-US-MichelleNeural\",\n                expected: \"en-US-MichelleNeural\",\n              },\n            ];\n\n            for (const tc of testCases) {\n              const result = resolveVoice(tc.input, DEFAULT_VOICE);\n              if (result !== tc.expected) {\n                throw new Error(\n                  `Voice preset mapping failed: ${tc.input} -> ${result}, expected ${tc.expected}`\n                );\n              }\n            }\n\n            logger.success(\"Voice preset mapping validated successfully\");\n          },\n        },\n        {\n          name: \"Edge TTS speed to rate conversion\",\n          fn: async (_runtime: IAgentRuntime) => {\n            const testCases = [\n              { speed: 1.0, expected: undefined },\n              { speed: 1.5, expected: \"+50%\" },\n              { speed: 0.75, expected: \"-25%\" },\n              { speed: 2.0, expected: \"+100%\" },\n            ];\n\n            for (const tc of testCases) {\n              const result = speedToRate(tc.speed);\n              if (result !== tc.expected) {\n                throw new Error(\n                  `Speed conversion failed: ${tc.speed} -> ${result}, expected ${tc.expected}`\n                );\n              }\n            }\n\n            logger.success(\"Speed to rate conversion validated successfully\");\n          },\n        },\n        {\n          name: \"Edge TTS generation (live test)\",\n          fn: async (runtime: IAgentRuntime) => {\n            const testText = \"Hello, this is a test of Edge TTS.\";\n\n            try {\n              const audioBuffer = (await runtime.useModel(ModelType.TEXT_TO_SPEECH, testText)) as\n                | Buffer\n                | Uint8Array;\n\n              if (!audioBuffer || audioBuffer.length === 0) {\n                throw new Error(\"Received empty audio buffer\");\n              }\n\n              logger.success(`Edge TTS generation successful: ${audioBuffer.length} bytes`);\n            } catch (error: unknown) {\n              const msg = error instanceof Error ? error.message : String(error);\n              // Edge TTS might fail in CI environments without network\n              if (msg.includes(\"ENOTFOUND\") || msg.includes(\"network\")) {\n                logger.warn(`Edge TTS live test skipped (network unavailable): ${msg}`);\n                return;\n              }\n              throw error;\n            }\n          },\n        },\n      ],\n    },\n  ],\n};\n\nexport default edgeTTSPlugin;\n\n// Re-export types\nexport type { EdgeTTSParams, EdgeTTSSettings };\n\n// Export helper functions for testing\nexport const _test = {\n  resolveVoice,\n  speedToRate,\n  inferExtension,\n  getEdgeTTSSettings,\n};\n"
-  ],
-  "mappings": "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",
-  "debugId": "302D9C6A4A9C013564756E2164756E21",
-  "names": []
-}