@fabric-harness/sdk 1.11.0 → 1.12.0

package/dist/voice-tts-elevenlabs.js

@@ -0,0 +1,163 @@
+/**
+ * ElevenLabs streaming TTS provider.
+ *
+ * Uses the WebSocket streaming endpoint
+ * (`wss://api.elevenlabs.io/v1/text-to-speech/:voiceId/stream-input`) so
+ * audio frames stream out as text arrives. PCM 16-bit little-endian at
+ * configurable sample rate; μ-law 8kHz available for telephony.
+ *
+ * Pricing: billed per character of input text. Rates registered in
+ * `model-pricing.ts` under provider `elevenlabs`.
+ */
+import { base64ToBytes, openVoiceWs, toError } from './voice-ws-shared.js';
+const DEFAULT_BASE = 'wss://api.elevenlabs.io';
+const DEFAULT_MODEL = 'eleven_turbo_v2_5';
+const DEFAULT_VOICE = '21m00Tcm4TlvDq8ikWAM'; // 'Rachel' — ElevenLabs starter voice.
+export class ElevenLabsTtsProvider {
+    name;
+    apiKey;
+    defaultVoice;
+    model;
+    baseUrl;
+    last;
+    constructor(options) {
+        if (!options.apiKey)
+            throw new Error('ElevenLabsTtsProvider: apiKey is required.');
+        this.apiKey = options.apiKey;
+        this.defaultVoice = options.defaultVoice ?? DEFAULT_VOICE;
+        this.model = options.model ?? DEFAULT_MODEL;
+        this.baseUrl = options.baseUrl ?? DEFAULT_BASE;
+        this.name = options.name ?? 'elevenlabs';
+    }
+    lastUsage() {
+        return this.last;
+    }
+    synthesize(text, opts = {}) {
+        const voice = opts.voice ?? this.defaultVoice;
+        const format = opts.audioFormat ?? 'pcm16';
+        const sampleRate = opts.sampleRate ?? defaultSampleRate(format);
+        const startedAt = Date.now();
+        let totalBytes = 0;
+        const charCount = text.length;
+        const provider = this;
+        return {
+            [Symbol.asyncIterator]: async function* () {
+                const url = buildUrl(provider.baseUrl, voice, provider.model, format, sampleRate);
+                const ws = await openVoiceWs(url, { 'xi-api-key': provider.apiKey });
+                const queue = [];
+                const waiters = [];
+                let closed = false;
+                let errorMsg;
+                const push = (chunk) => {
+                    if (closed)
+                        return;
+                    if (!chunk) {
+                        closed = true;
+                        while (waiters.length > 0)
+                            waiters.shift()({ value: undefined, done: true });
+                        return;
+                    }
+                    totalBytes += chunk.byteLength;
+                    const w = waiters.shift();
+                    if (w)
+                        w({ value: chunk, done: false });
+                    else
+                        queue.push(chunk);
+                };
+                ws.addEventListener('message', (ev) => {
+                    const raw = typeof ev.data === 'string' ? ev.data : ev.data?.toString?.() ?? '';
+                    let payload;
+                    try {
+                        payload = JSON.parse(raw);
+                    }
+                    catch {
+                        return;
+                    }
+                    if (typeof payload.audio === 'string' && payload.audio.length > 0) {
+                        push(base64ToBytes(payload.audio));
+                    }
+                    if (payload.isFinal === true) {
+                        push(undefined);
+                        try {
+                            ws.close();
+                        }
+                        catch { }
+                    }
+                    if (payload.error || payload.message) {
+                        errorMsg = String(payload.error ?? payload.message);
+                        push(undefined);
+                        try {
+                            ws.close();
+                        }
+                        catch { }
+                    }
+                });
+                ws.addEventListener('error', (ev) => {
+                    errorMsg = toError(ev, 'ElevenLabs WS error').message;
+                    push(undefined);
+                });
+                ws.addEventListener('close', () => push(undefined));
+                // Per ElevenLabs streaming protocol: send BOS with voice settings,
+                // then text chunk(s), then EOS (empty text).
+                ws.send(JSON.stringify({
+                    text: ' ',
+                    voice_settings: { stability: 0.5, similarity_boost: 0.8, ...(opts.speed !== undefined ? { speed: opts.speed } : {}) },
+                    xi_api_key: provider.apiKey,
+                }));
+                ws.send(JSON.stringify({ text: text + ' ', try_trigger_generation: true }));
+                ws.send(JSON.stringify({ text: '' }));
+                opts.signal?.addEventListener('abort', () => { try {
+                    ws.close();
+                }
+                catch { } push(undefined); }, { once: true });
+                try {
+                    while (true) {
+                        if (queue.length > 0) {
+                            yield queue.shift();
+                            continue;
+                        }
+                        if (closed)
+                            break;
+                        const next = await new Promise((resolve) => waiters.push(resolve));
+                        if (next.done)
+                            break;
+                        yield next.value;
+                    }
+                    if (errorMsg)
+                        throw new Error(`ElevenLabs TTS: ${errorMsg}`);
+                }
+                finally {
+                    provider.last = {
+                        characters: charCount,
+                        audioBytes: totalBytes,
+                        durationMs: Date.now() - startedAt,
+                    };
+                }
+            },
+        };
+    }
+}
+function buildUrl(base, voiceId, model, format, sampleRate) {
+    const outputFormat = formatToElevenLabs(format, sampleRate);
+    const params = new URLSearchParams({
+        model_id: model,
+        output_format: outputFormat,
+    });
+    return `${base}/v1/text-to-speech/${encodeURIComponent(voiceId)}/stream-input?${params.toString()}`;
+}
+function formatToElevenLabs(format, sampleRate) {
+    if (format === 'g711_ulaw')
+        return 'ulaw_8000';
+    if (format === 'g711_alaw')
+        return 'ulaw_8000'; // ElevenLabs ships ulaw only.
+    // pcm16 family — sample rate selectable: 8000/16000/22050/24000/44100.
+    const allowed = [8000, 16000, 22050, 24000, 44100];
+    const rate = allowed.includes(sampleRate) ? sampleRate : 24000;
+    return `pcm_${rate}`;
+}
+function defaultSampleRate(format) {
+    if (format === 'g711_ulaw' || format === 'g711_alaw')
+        return 8000;
+    return 24000;
+}
+//# sourceMappingURL=voice-tts-elevenlabs.js.map

package/dist/voice-tts-elevenlabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-tts-elevenlabs.js","sourceRoot":"","sources":["../src/voice-tts-elevenlabs.ts"],"names":[],"mappings":"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"}

package/dist/voice-tts.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Text-to-speech provider surface. fabric-harness ships ElevenLabs and
+ * Cartesia implementations; bring-your-own for on-prem TTS or unsupported
+ * vendors. Used by `PipelineVoiceProvider` to drive the audio-out side of
+ * STT→LLM→TTS voice agents.
+ *
+ * For monolithic realtime models that own audio in *and* out (OpenAI
+ * Realtime), use `OpenAIRealtimeVoiceProvider` directly — TTS is internal.
+ */
+import type { VoiceAudioFormat } from './voice.js';
+export interface TtsSynthesisOptions {
+    /** Voice timbre / cloned-voice id. Provider-specific. */
+    voice?: string;
+    /** Audio format on the wire. Default `pcm16`. */
+    audioFormat?: VoiceAudioFormat;
+    /** Sample rate in Hz. Default 24000 for `pcm16`, 8000 for telephony codecs. */
+    sampleRate?: number;
+    /** Optional speaking-rate / speed multiplier (1.0 = default). */
+    speed?: number;
+    /** Abort signal — terminates an in-flight synthesis cleanly. */
+    signal?: AbortSignal;
+}
+export interface TtsSynthesisUsage {
+    /** Characters of input text submitted (used for billing rollup). */
+    characters: number;
+    /** Total bytes of audio emitted. */
+    audioBytes: number;
+    /** Wall-clock duration of the synthesis call in milliseconds. */
+    durationMs: number;
+}
+export interface TtsProvider {
+    /** Stable provider id used in cost telemetry, e.g. `elevenlabs`, `cartesia`. */
+    readonly name: string;
+    /**
+     * Synthesize a complete utterance. Yields raw audio frames in
+     * `opts.audioFormat` (default `pcm16`). The final iteration value is
+     * the usage rollup — read it from `provider.lastUsage()` when the
+     * iterator completes.
+     */
+    synthesize(text: string, opts?: TtsSynthesisOptions): AsyncIterable<Uint8Array>;
+    /**
+     * Optional: streaming text input. The provider should chunk audio out
+     * incrementally as text arrives — useful for low-latency LLM-token-to-
+     * audio paths. Falls back to buffering + `synthesize()` if absent.
+     */
+    synthesizeStream?(text: AsyncIterable<string>, opts?: TtsSynthesisOptions): AsyncIterable<Uint8Array>;
+    /** Last completed synthesis usage. Reset at the start of each call. */
+    lastUsage(): TtsSynthesisUsage | undefined;
+}
+//# sourceMappingURL=voice-tts.d.ts.map

package/dist/voice-tts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-tts.d.ts","sourceRoot":"","sources":["../src/voice-tts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IAChF;;;;OAIG;IACH,gBAAgB,CAAC,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IACtG,uEAAuE;IACvE,SAAS,IAAI,iBAAiB,GAAG,SAAS,CAAC;CAC5C"}

package/dist/voice-tts.js

@@ -0,0 +1,11 @@
+/**
+ * Text-to-speech provider surface. fabric-harness ships ElevenLabs and
+ * Cartesia implementations; bring-your-own for on-prem TTS or unsupported
+ * vendors. Used by `PipelineVoiceProvider` to drive the audio-out side of
+ * STT→LLM→TTS voice agents.
+ *
+ * For monolithic realtime models that own audio in *and* out (OpenAI
+ * Realtime), use `OpenAIRealtimeVoiceProvider` directly — TTS is internal.
+ */
+export {};
+//# sourceMappingURL=voice-tts.js.map

package/dist/voice-tts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-tts.js","sourceRoot":"","sources":["../src/voice-tts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/voice-ws-shared.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shared WebSocket plumbing for voice STT/TTS providers. Uses the global
+ * `WebSocket` (Node 22+ + browsers) — no `ws` dependency.
+ */
+export interface VoiceWebSocket {
+    send(data: string | ArrayBuffer | Uint8Array): void;
+    close(code?: number, reason?: string): void;
+    addEventListener(type: 'message', listener: (ev: {
+        data: unknown;
+    }) => void): void;
+    addEventListener(type: 'error', listener: (ev: unknown) => void): void;
+    addEventListener(type: 'close', listener: (ev: unknown) => void): void;
+    addEventListener(type: 'open', listener: (ev: unknown) => void): void;
+    readyState: number;
+}
+export declare function openVoiceWs(url: string, headers: Record<string, string>): Promise<VoiceWebSocket>;
+export declare function toError(value: unknown, fallback: string): Error;
+export declare function bytesToBase64(bytes: Uint8Array): string;
+export declare function base64ToBytes(value: string): Uint8Array;
+//# sourceMappingURL=voice-ws-shared.d.ts.map

package/dist/voice-ws-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-ws-shared.d.ts","sourceRoot":"","sources":["../src/voice-ws-shared.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IACnF,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IACvE,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IACvE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IACtE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,cAAc,CAAC,CAYzB;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,CAM/D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAKvD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAMvD"}

package/dist/voice-ws-shared.js

@@ -0,0 +1,42 @@
+/**
+ * Shared WebSocket plumbing for voice STT/TTS providers. Uses the global
+ * `WebSocket` (Node 22+ + browsers) — no `ws` dependency.
+ */
+export async function openVoiceWs(url, headers) {
+    const Impl = globalThis.WebSocket;
+    if (!Impl) {
+        throw new Error('Voice WS: global WebSocket not available. Use Node 22+ or polyfill.');
+    }
+    const ws = new Impl(url, { headers });
+    await new Promise((resolve, reject) => {
+        ws.addEventListener('open', () => resolve());
+        ws.addEventListener('error', (ev) => reject(toError(ev, 'WebSocket open failed')));
+    });
+    return ws;
+}
+export function toError(value, fallback) {
+    if (value instanceof Error)
+        return value;
+    if (value && typeof value === 'object' && 'message' in value) {
+        return new Error(String(value.message));
+    }
+    return new Error(fallback);
+}
+export function bytesToBase64(bytes) {
+    if (typeof Buffer !== 'undefined')
+        return Buffer.from(bytes).toString('base64');
+    let binary = '';
+    for (let i = 0; i < bytes.byteLength; i += 1)
+        binary += String.fromCharCode(bytes[i]);
+    return btoa(binary);
+}
+export function base64ToBytes(value) {
+    if (typeof Buffer !== 'undefined')
+        return new Uint8Array(Buffer.from(value, 'base64'));
+    const bin = atob(value);
+    const out = new Uint8Array(bin.length);
+    for (let i = 0; i < bin.length; i += 1)
+        out[i] = bin.charCodeAt(i);
+    return out;
+}
+//# sourceMappingURL=voice-ws-shared.js.map

package/dist/voice-ws-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-ws-shared.js","sourceRoot":"","sources":["../src/voice-ws-shared.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAW,EACX,OAA+B;IAE/B,MAAM,IAAI,GACP,UAAqF,CAAC,SAAS,CAAC;IACnG,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACtC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7C,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAc,EAAE,QAAgB;IACtD,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC;IACzC,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAK,KAAiC,EAAE,CAAC;QAC1F,OAAO,IAAI,KAAK,CAAC,MAAM,CAAE,KAA8B,CAAC,OAAO,CAAC,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAiB;IAC7C,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAChF,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;IACvF,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IACvF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACxB,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACnE,OAAO,GAAG,CAAC;AACb,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fabric-harness/sdk",
-  "version": "1.11.0",
+  "version": "1.12.0",
   "description": "Headless TypeScript framework for building durable, deployable autonomous agents — core SDK.",
   "license": "Apache-2.0",
   "author": "Fabric",
@@ -60,6 +60,12 @@
     "README.md",
     "LICENSE"
   ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -b tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
   "dependencies": {
     "@mariozechner/pi-agent-core": "^0.72.1",
     "@mariozechner/pi-ai": "^0.72.1",
@@ -77,11 +83,5 @@
   "devDependencies": {
     "@opentelemetry/api": "^1.9.1",
     "vitest": "^4.1.5"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "check": "tsc -b tsconfig.json",
-    "test": "vitest run",
-    "test:watch": "vitest"
   }
-}
+}