@framers/agentos 0.1.184 → 0.1.185

package/dist/voice-pipeline/providers/ElevenLabsBatchTTS.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @module voice-pipeline/providers/ElevenLabsBatchTTS
+ *
+ * Batch text-to-speech via ElevenLabs' REST API. Implements {@link IBatchTTS}
+ * for one-shot narration synthesis with voice settings control.
+ */
+import type { IBatchTTS, BatchTTSConfig, BatchTTSResult } from '../types.js';
+/** Configuration for the ElevenLabs batch TTS provider. */
+export interface ElevenLabsBatchTTSConfig {
+    /** ElevenLabs API key. */
+    apiKey: string;
+    /** Default voice ID. Falls back to 'EXAVITQu4vr4xnSDxMaL' (Rachel). */
+    voiceId?: string;
+    /** Model identifier. Defaults to 'eleven_multilingual_v2'. */
+    model?: string;
+    /** Base URL for the ElevenLabs API. Defaults to 'https://api.elevenlabs.io/v1'. */
+    baseUrl?: string;
+}
+/**
+ * Batch (one-shot) TTS provider using ElevenLabs' REST text-to-speech endpoint.
+ *
+ * Accepts complete text and returns finished MP3 audio with voice settings
+ * control via `providerOptions` (stability, similarityBoost, style, useSpeakerBoost).
+ */
+export declare class ElevenLabsBatchTTS implements IBatchTTS {
+    readonly providerId = "elevenlabs-batch";
+    /** ElevenLabs API key used for authentication. */
+    private readonly apiKey;
+    /** Default voice ID when none is provided in the synthesis config. */
+    private readonly defaultVoiceId;
+    /** Model identifier sent with each request. */
+    private readonly model;
+    /** Base URL for all API requests. */
+    private readonly baseUrl;
+    constructor(config: ElevenLabsBatchTTSConfig);
+    /**
+     * Synthesize complete text into MP3 audio via ElevenLabs REST API.
+     *
+     * @param text - The text to synthesize.
+     * @param config - Optional synthesis configuration (voice, model, providerOptions).
+     * @returns Resolved {@link BatchTTSResult} containing the MP3 audio buffer.
+     * @throws Error if the API returns a non-OK status.
+     */
+    synthesize(text: string, config?: BatchTTSConfig): Promise<BatchTTSResult>;
+}
+//# sourceMappingURL=ElevenLabsBatchTTS.d.ts.map

package/dist/voice-pipeline/providers/ElevenLabsBatchTTS.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElevenLabsBatchTTS.d.ts","sourceRoot":"","sources":["../../../src/voice-pipeline/providers/ElevenLabsBatchTTS.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7E,2DAA2D;AAC3D,MAAM,WAAW,wBAAwB;IACvC,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAKD;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,SAAS;IAClD,QAAQ,CAAC,UAAU,sBAAsB;IAEzC,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,qCAAqC;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,wBAAwB;IAO5C;;;;;;;OAOG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;CAiCjF"}

package/dist/voice-pipeline/providers/ElevenLabsBatchTTS.js

@@ -0,0 +1,61 @@
+/**
+ * @module voice-pipeline/providers/ElevenLabsBatchTTS
+ *
+ * Batch text-to-speech via ElevenLabs' REST API. Implements {@link IBatchTTS}
+ * for one-shot narration synthesis with voice settings control.
+ */
+/** Approximate bytes per second for 128kbps MP3 audio. */
+const BYTES_PER_SEC_MP3 = 16000;
+/**
+ * Batch (one-shot) TTS provider using ElevenLabs' REST text-to-speech endpoint.
+ *
+ * Accepts complete text and returns finished MP3 audio with voice settings
+ * control via `providerOptions` (stability, similarityBoost, style, useSpeakerBoost).
+ */
+export class ElevenLabsBatchTTS {
+    constructor(config) {
+        this.providerId = 'elevenlabs-batch';
+        this.apiKey = config.apiKey;
+        this.defaultVoiceId = config.voiceId ?? 'EXAVITQu4vr4xnSDxMaL';
+        this.model = config.model ?? 'eleven_multilingual_v2';
+        this.baseUrl = config.baseUrl ?? 'https://api.elevenlabs.io/v1';
+    }
+    /**
+     * Synthesize complete text into MP3 audio via ElevenLabs REST API.
+     *
+     * @param text - The text to synthesize.
+     * @param config - Optional synthesis configuration (voice, model, providerOptions).
+     * @returns Resolved {@link BatchTTSResult} containing the MP3 audio buffer.
+     * @throws Error if the API returns a non-OK status.
+     */
+    async synthesize(text, config) {
+        const voiceId = config?.voice ?? this.defaultVoiceId;
+        const opts = config?.providerOptions ?? {};
+        const res = await fetch(`${this.baseUrl}/text-to-speech/${voiceId}`, {
+            method: 'POST',
+            headers: {
+                'xi-api-key': this.apiKey,
+                'Content-Type': 'application/json',
+                Accept: 'audio/mpeg',
+            },
+            body: JSON.stringify({
+                text,
+                model_id: config?.model ?? this.model,
+                voice_settings: {
+                    stability: opts.stability ?? 0.5,
+                    similarity_boost: opts.similarityBoost ?? 0.75,
+                    style: opts.style ?? 0.0,
+                    use_speaker_boost: opts.useSpeakerBoost ?? true,
+                },
+            }),
+        });
+        if (!res.ok) {
+            const detail = await res.text().catch(() => '');
+            throw new Error(`ElevenLabs TTS failed: ${res.status} ${detail.slice(0, 200)}`);
+        }
+        const audio = Buffer.from(await res.arrayBuffer());
+        const durationMs = Math.round((audio.byteLength / BYTES_PER_SEC_MP3) * 1000);
+        return { audio, format: 'mp3', durationMs, provider: this.providerId };
+    }
+}
+//# sourceMappingURL=ElevenLabsBatchTTS.js.map

package/dist/voice-pipeline/providers/ElevenLabsBatchTTS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElevenLabsBatchTTS.js","sourceRoot":"","sources":["../../../src/voice-pipeline/providers/ElevenLabsBatchTTS.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,0DAA0D;AAC1D,MAAM,iBAAiB,GAAG,KAAM,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IAe7B,YAAY,MAAgC;QAdnC,eAAU,GAAG,kBAAkB,CAAC;QAevC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,OAAO,IAAI,sBAAsB,CAAC;QAC/D,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,wBAAwB,CAAC;QACtD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,8BAA8B,CAAC;IAClE,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,MAAuB;QACpD,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,IAAI,IAAI,CAAC,cAAc,CAAC;QACrD,MAAM,IAAI,GAAG,MAAM,EAAE,eAAe,IAAI,EAAE,CAAC;QAE3C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,mBAAmB,OAAO,EAAE,EAAE;YACnE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,YAAY,EAAE,IAAI,CAAC,MAAM;gBACzB,cAAc,EAAE,kBAAkB;gBAClC,MAAM,EAAE,YAAY;aACrB;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,IAAI;gBACJ,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,IAAI,CAAC,KAAK;gBACrC,cAAc,EAAE;oBACd,SAAS,EAAG,IAAI,CAAC,SAAoB,IAAI,GAAG;oBAC5C,gBAAgB,EAAG,IAAI,CAAC,eAA0B,IAAI,IAAI;oBAC1D,KAAK,EAAG,IAAI,CAAC,KAAgB,IAAI,GAAG;oBACpC,iBAAiB,EAAG,IAAI,CAAC,eAA2B,IAAI,IAAI;iBAC7D;aACF,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,UAAU,GAAG,iBAAiB,CAAC,GAAG,IAAI,CAAC,CAAC;QAE7E,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;IACzE,CAAC;CACF"}

package/dist/voice-pipeline/providers/index.d.ts

@@ -6,10 +6,12 @@
  * - {@link ElevenLabsStreamingTTS} — ElevenLabs WebSocket streaming TTS
  * - {@link AgentSessionVoiceAdapter} — AgentOS session → voice pipeline adapter
  * - {@link OpenAIBatchTTS} — OpenAI batch (one-shot) TTS
+ * - {@link ElevenLabsBatchTTS} — ElevenLabs batch (one-shot) TTS
  */
 export { DeepgramStreamingSTT, type DeepgramStreamingSTTConfig } from './DeepgramStreamingSTT.js';
 export { ElevenLabsStreamingSTT, type ElevenLabsStreamingSTTConfig, } from './ElevenLabsStreamingSTT.js';
 export { ElevenLabsStreamingTTS, type ElevenLabsStreamingTTSConfig, } from './ElevenLabsStreamingTTS.js';
 export { AgentSessionVoiceAdapter } from './AgentSessionVoiceAdapter.js';
 export { OpenAIBatchTTS, type OpenAIBatchTTSConfig } from './OpenAIBatchTTS.js';
+export { ElevenLabsBatchTTS, type ElevenLabsBatchTTSConfig } from './ElevenLabsBatchTTS.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/voice-pipeline/providers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/voice-pipeline/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,oBAAoB,EAAE,KAAK,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAClG,OAAO,EACL,sBAAsB,EACtB,KAAK,4BAA4B,GAClC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,sBAAsB,EACtB,KAAK,4BAA4B,GAClC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/voice-pipeline/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,oBAAoB,EAAE,KAAK,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAClG,OAAO,EACL,sBAAsB,EACtB,KAAK,4BAA4B,GAClC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,sBAAsB,EACtB,KAAK,4BAA4B,GAClC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,KAAK,wBAAwB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/voice-pipeline/providers/index.js

@@ -6,10 +6,12 @@
  * - {@link ElevenLabsStreamingTTS} — ElevenLabs WebSocket streaming TTS
  * - {@link AgentSessionVoiceAdapter} — AgentOS session → voice pipeline adapter
  * - {@link OpenAIBatchTTS} — OpenAI batch (one-shot) TTS
+ * - {@link ElevenLabsBatchTTS} — ElevenLabs batch (one-shot) TTS
  */
 export { DeepgramStreamingSTT } from './DeepgramStreamingSTT.js';
 export { ElevenLabsStreamingSTT, } from './ElevenLabsStreamingSTT.js';
 export { ElevenLabsStreamingTTS, } from './ElevenLabsStreamingTTS.js';
 export { AgentSessionVoiceAdapter } from './AgentSessionVoiceAdapter.js';
 export { OpenAIBatchTTS } from './OpenAIBatchTTS.js';
+export { ElevenLabsBatchTTS } from './ElevenLabsBatchTTS.js';
 //# sourceMappingURL=index.js.map

package/dist/voice-pipeline/providers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/voice-pipeline/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,oBAAoB,EAAmC,MAAM,2BAA2B,CAAC;AAClG,OAAO,EACL,sBAAsB,GAEvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,sBAAsB,GAEvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,cAAc,EAA6B,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/voice-pipeline/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,oBAAoB,EAAmC,MAAM,2BAA2B,CAAC;AAClG,OAAO,EACL,sBAAsB,GAEvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,sBAAsB,GAEvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,cAAc,EAA6B,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAiC,MAAM,yBAAyB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos",
-  "version": "0.1.184",
+  "version": "0.1.185",
   "description": "Modular AgentOS orchestration library",
   "type": "module",
   "main": "dist/index.js",