@fabric-harness/sdk 1.10.0 → 1.12.0

package/dist/voice-tts-cartesia.js

@@ -0,0 +1,159 @@
+/**
+ * Cartesia streaming TTS provider.
+ *
+ * Uses the Cartesia WS endpoint (`wss://api.cartesia.ai/tts/websocket`).
+ * `sonic-2` is the v1.12 default — Cartesia's flagship low-latency model.
+ *
+ * Pricing: per character. Rates registered in `model-pricing.ts` under
+ * provider `cartesia`.
+ */
+import { base64ToBytes, openVoiceWs, toError } from './voice-ws-shared.js';
+const DEFAULT_BASE = 'wss://api.cartesia.ai';
+const DEFAULT_MODEL = 'sonic-2';
+const DEFAULT_API_VERSION = '2024-11-13';
+// Cartesia 'Newsman' voice — a public default. Override per-call.
+const DEFAULT_VOICE = 'd46abd1d-2d02-43e8-819f-51fb652c1c61';
+export class CartesiaTtsProvider {
+    name;
+    apiKey;
+    defaultVoice;
+    model;
+    apiVersion;
+    baseUrl;
+    last;
+    constructor(options) {
+        if (!options.apiKey)
+            throw new Error('CartesiaTtsProvider: apiKey is required.');
+        this.apiKey = options.apiKey;
+        this.defaultVoice = options.defaultVoice ?? DEFAULT_VOICE;
+        this.model = options.model ?? DEFAULT_MODEL;
+        this.apiVersion = options.apiVersion ?? DEFAULT_API_VERSION;
+        this.baseUrl = options.baseUrl ?? DEFAULT_BASE;
+        this.name = options.name ?? 'cartesia';
+    }
+    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 = `${provider.baseUrl}/tts/websocket?cartesia_version=${encodeURIComponent(provider.apiVersion)}&api_key=${encodeURIComponent(provider.apiKey)}`;
+                const ws = await openVoiceWs(url, {});
+                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;
+                    }
+                    const type = String(payload.type ?? '');
+                    if (type === 'chunk' && typeof payload.data === 'string') {
+                        push(base64ToBytes(payload.data));
+                    }
+                    else if (type === 'done') {
+                        push(undefined);
+                        try {
+                            ws.close();
+                        }
+                        catch { }
+                    }
+                    else if (type === 'error') {
+                        errorMsg = String(payload.error ?? payload.message ?? 'cartesia error');
+                        push(undefined);
+                        try {
+                            ws.close();
+                        }
+                        catch { }
+                    }
+                });
+                ws.addEventListener('error', (ev) => {
+                    errorMsg = toError(ev, 'Cartesia WS error').message;
+                    push(undefined);
+                });
+                ws.addEventListener('close', () => push(undefined));
+                const outputContainer = format === 'g711_ulaw' ? 'mulaw' : 'raw';
+                const encoding = format === 'g711_ulaw' ? 'pcm_mulaw' : 'pcm_s16le';
+                ws.send(JSON.stringify({
+                    model_id: provider.model,
+                    voice: { mode: 'id', id: voice },
+                    transcript: text,
+                    continue: false,
+                    context_id: cryptoRandomId(),
+                    language: 'en',
+                    output_format: {
+                        container: outputContainer,
+                        encoding,
+                        sample_rate: sampleRate,
+                    },
+                    ...(opts.speed !== undefined ? { speed: opts.speed } : {}),
+                }));
+                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(`Cartesia TTS: ${errorMsg}`);
+                }
+                finally {
+                    provider.last = {
+                        characters: charCount,
+                        audioBytes: totalBytes,
+                        durationMs: Date.now() - startedAt,
+                    };
+                }
+            },
+        };
+    }
+}
+function defaultSampleRate(format) {
+    if (format === 'g711_ulaw' || format === 'g711_alaw')
+        return 8000;
+    return 24000;
+}
+function cryptoRandomId() {
+    // Lightweight per-call id — Cartesia accepts any unique string.
+    return `fh-${Math.random().toString(36).slice(2, 10)}-${Date.now().toString(36)}`;
+}
+//# sourceMappingURL=voice-tts-cartesia.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voice-tts-cartesia.js","sourceRoot":"","sources":["../src/voice-tts-cartesia.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,EAAuB,MAAM,sBAAsB,CAAC;AAkBhG,MAAM,YAAY,GAAG,uBAAuB,CAAC;AAC7C,MAAM,aAAa,GAAG,SAAS,CAAC;AAChC,MAAM,mBAAmB,GAAG,YAAY,CAAC;AACzC,kEAAkE;AAClE,MAAM,aAAa,GAAG,sCAAsC,CAAC;AAE7D,MAAM,OAAO,mBAAmB;IACrB,IAAI,CAAS;IACL,MAAM,CAAS;IACf,YAAY,CAAS;IACrB,KAAK,CAAS;IACd,UAAU,CAAS;IACnB,OAAO,CAAS;IACzB,IAAI,CAAqB;IAEjC,YAAY,OAAmC;QAC7C,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QACjF,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,aAAa,CAAC;QAC1D,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC;QAC5C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC;QAC5D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,YAAY,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC;IACzC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,UAAU,CAAC,IAAY,EAAE,OAA4B,EAAE;QACrD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,IAAI,OAAO,CAAC;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAChE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC;QAEtB,OAAO;YACL,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,KAAK,SAAS,CAAC;gBACrC,MAAM,GAAG,GAAG,GAAG,QAAQ,CAAC,OAAO,mCAAmC,kBAAkB,CAAC,QAAQ,CAAC,UAAU,CAAC,YAAY,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3J,MAAM,EAAE,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACtC,MAAM,KAAK,GAAiB,EAAE,CAAC;gBAC/B,MAAM,OAAO,GAAuD,EAAE,CAAC;gBACvE,IAAI,MAAM,GAAG,KAAK,CAAC;gBACnB,IAAI,QAA4B,CAAC;gBAEjC,MAAM,IAAI,GAAG,CAAC,KAA6B,EAAE,EAAE;oBAC7C,IAAI,MAAM;wBAAE,OAAO;oBACnB,IAAI,CAAC,KAAK,EAAE,CAAC;wBACX,MAAM,GAAG,IAAI,CAAC;wBACd,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC;4BAAE,OAAO,CAAC,KAAK,EAAG,CAAC,EAAE,KAAK,EAAE,SAAkC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;wBACvG,OAAO;oBACT,CAAC;oBACD,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC;oBAC/B,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;oBAC1B,IAAI,CAAC;wBAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;;wBACnC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACzB,CAAC,CAAC;gBAEF,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE;oBACpC,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAE,EAAE,CAAC,IAAoC,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC;oBACjH,IAAI,OAAgC,CAAC;oBACrC,IAAI,CAAC;wBAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;oBAAC,CAAC;oBAAC,MAAM,CAAC;wBAAC,OAAO;oBAAC,CAAC;oBAC/E,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;oBACxC,IAAI,IAAI,KAAK,OAAO,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;wBACzD,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;oBACpC,CAAC;yBAAM,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;wBAC3B,IAAI,CAAC,SAAS,CAAC,CAAC;wBAChB,IAAI,CAAC;4BAAC,EAAE,CAAC,KAAK,EAAE,CAAC;wBAAC,CAAC;wBAAC,MAAM,CAAC,CAAA,CAAC;oBAC9B,CAAC;yBAAM,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;wBAC5B,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC;wBACxE,IAAI,CAAC,SAAS,CAAC,CAAC;wBAChB,IAAI,CAAC;4BAAC,EAAE,CAAC,KAAK,EAAE,CAAC;wBAAC,CAAC;wBAAC,MAAM,CAAC,CAAA,CAAC;oBAC9B,CAAC;gBACH,CAAC,CAAC,CAAC;gBACH,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE;oBAClC,QAAQ,GAAG,OAAO,CAAC,EAAE,EAAE,mBAAmB,CAAC,CAAC,OAAO,CAAC;oBACpD,IAAI,CAAC,SAAS,CAAC,CAAC;gBAClB,CAAC,CAAC,CAAC;gBACH,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;gBAEpD,MAAM,eAAe,GAAG,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;gBACjE,MAAM,QAAQ,GAAG,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC;gBAEpE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;oBACrB,QAAQ,EAAE,QAAQ,CAAC,KAAK;oBACxB,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE;oBAChC,UAAU,EAAE,IAAI;oBAChB,QAAQ,EAAE,KAAK;oBACf,UAAU,EAAE,cAAc,EAAE;oBAC5B,QAAQ,EAAE,IAAI;oBACd,aAAa,EAAE;wBACb,SAAS,EAAE,eAAe;wBAC1B,QAAQ;wBACR,WAAW,EAAE,UAAU;qBACxB;oBACD,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC3D,CAAC,CAAC,CAAC;gBAEJ,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;oBAAC,EAAE,CAAC,KAAK,EAAE,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAA,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBAEhH,IAAI,CAAC;oBACH,OAAO,IAAI,EAAE,CAAC;wBACZ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BACrB,MAAM,KAAK,CAAC,KAAK,EAAG,CAAC;4BACrB,SAAS;wBACX,CAAC;wBACD,IAAI,MAAM;4BAAE,MAAM;wBAClB,MAAM,IAAI,GAAG,MAAM,IAAI,OAAO,CAA6B,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;wBAC/F,IAAI,IAAI,CAAC,IAAI;4BAAE,MAAM;wBACrB,MAAM,IAAI,CAAC,KAAK,CAAC;oBACnB,CAAC;oBACD,IAAI,QAAQ;wBAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;gBAC7D,CAAC;wBAAS,CAAC;oBACT,QAAQ,CAAC,IAAI,GAAG;wBACd,UAAU,EAAE,SAAS;wBACrB,UAAU,EAAE,UAAU;wBACtB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;qBACnC,CAAC;gBACJ,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF;AAED,SAAS,iBAAiB,CAAC,MAAwB;IACjD,IAAI,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAClE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,cAAc;IACrB,gEAAgE;IAChE,OAAO,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AACpF,CAAC"}

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

@@ -0,0 +1,35 @@
+/**
+ * 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 type { TtsProvider, TtsSynthesisOptions, TtsSynthesisUsage } from './voice-tts.js';
+export interface ElevenLabsTtsProviderOptions {
+    apiKey: string;
+    /** Default voice id when `synthesize` doesn't override. */
+    defaultVoice?: string;
+    /** Default model id. `eleven_turbo_v2_5` is the v1.12 default (low latency). */
+    model?: string;
+    /** Override base URL — useful for region-pinned deployments. */
+    baseUrl?: string;
+    /** Provider name override for telemetry. Default `elevenlabs`. */
+    name?: string;
+}
+export declare class ElevenLabsTtsProvider implements TtsProvider {
+    readonly name: string;
+    private readonly apiKey;
+    private readonly defaultVoice;
+    private readonly model;
+    private readonly baseUrl;
+    private last?;
+    constructor(options: ElevenLabsTtsProviderOptions);
+    lastUsage(): TtsSynthesisUsage | undefined;
+    synthesize(text: string, opts?: TtsSynthesisOptions): AsyncIterable<Uint8Array>;
+}
+//# sourceMappingURL=voice-tts-elevenlabs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voice-tts-elevenlabs.d.ts","sourceRoot":"","sources":["../src/voice-tts-elevenlabs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAG1F,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD,qBAAa,qBAAsB,YAAW,WAAW;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,IAAI,CAAC,CAAoB;gBAErB,OAAO,EAAE,4BAA4B;IASjD,SAAS,IAAI,iBAAiB,GAAG,SAAS;IAI1C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,mBAAwB,GAAG,aAAa,CAAC,UAAU,CAAC;CAwFpF"}

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-client.d.ts

@@ -0,0 +1,77 @@
+import type { ModelUsage } from './model.js';
+import type { VoiceAudioFormat } from './voice.js';
+/**
+ * Lightweight WebSocket client for the `fh server` `WS /sessions/:id/voice`
+ * endpoint. Server-side bridge owns the provider connection and API keys;
+ * this client just streams audio + control messages over WS.
+ *
+ * Works in browsers and on Node 22+ (uses the global `WebSocket`).
+ */
+export interface VoiceWsClientOptions {
+    /** WS URL — e.g. `ws://localhost:9111/sessions/abc/voice`. */
+    url: string;
+    /** Bearer token, sent as `?token=` query param. */
+    authToken?: string;
+    /** Tenant id, sent as `?tenant=` query param. */
+    tenantId?: string;
+    /** Realtime voice timbre id (alloy, nova, verse, ...). */
+    voice?: string;
+    /** Initial instructions / persona. */
+    instructions?: string;
+    /** Audio format hint. Default `pcm16` (server-side default). */
+    audioFormat?: VoiceAudioFormat;
+    /** Realtime model id — overrides server default. */
+    model?: string;
+    /** Called for every event from the server. */
+    onEvent?: (event: VoiceWsClientEvent) => void;
+    /** Called once when the bridge confirms the session. */
+    onSessionOpen?: (sessionId: string) => void;
+    /** Called on errors (transport or server-side). */
+    onError?: (error: Error) => void;
+    /** Called when the socket closes. */
+    onClose?: () => void;
+}
+export type VoiceWsClientEvent = {
+    type: 'session_open';
+    sessionId: string;
+} | {
+    type: 'audio';
+    audio: Uint8Array;
+} | {
+    type: 'text_delta';
+    delta: string;
+    role: 'assistant' | 'user';
+} | {
+    type: 'transcript';
+    text: string;
+    role: 'assistant' | 'user';
+} | {
+    type: 'tool_call';
+    id: string;
+    name: string;
+    input: unknown;
+} | {
+    type: 'response_done';
+    usage?: ModelUsage;
+} | {
+    type: 'cost_limit';
+    scope: string;
+    observedUsd: number;
+    limitUsd: number;
+    scopeKey?: string;
+} | {
+    type: 'error';
+    message: string;
+};
+export interface VoiceWsClientHandle {
+    sendAudio(frame: Uint8Array): void;
+    sendText(text: string): void;
+    submitToolResult(input: {
+        id: string;
+        output: unknown;
+    }): void;
+    cancel(): void;
+    close(): void;
+}
+export declare function connectFabricVoice(options: VoiceWsClientOptions): VoiceWsClientHandle;
+//# sourceMappingURL=voice-ws-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voice-ws-client.d.ts","sourceRoot":"","sources":["../src/voice-ws-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;GAMG;AAEH,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,GAAG,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,8CAA8C;IAC9C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC9C,wDAAwD;IACxD,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,mDAAmD;IACnD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/F;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,CAAC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/D,MAAM,IAAI,IAAI,CAAC;IACf,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CAkDrF"}

package/dist/voice-ws-client.js

@@ -0,0 +1,115 @@
+export function connectFabricVoice(options) {
+    const url = appendQueryParams(options.url, {
+        ...(options.authToken ? { token: options.authToken } : {}),
+        ...(options.tenantId ? { tenant: options.tenantId } : {}),
+        ...(options.voice ? { voice: options.voice } : {}),
+        ...(options.instructions ? { instructions: options.instructions } : {}),
+        ...(options.audioFormat ? { audioFormat: options.audioFormat } : {}),
+        ...(options.model ? { model: options.model } : {}),
+    });
+    const WebSocketImpl = typeof globalThis.WebSocket === 'function'
+        ? globalThis.WebSocket
+        : undefined;
+    if (!WebSocketImpl) {
+        throw new Error('connectFabricVoice: global WebSocket not available. On Node use Node 22+ or polyfill.');
+    }
+    const ws = new WebSocketImpl(url);
+    ws.addEventListener('message', (ev) => {
+        const data = typeof ev.data === 'string' ? ev.data : '';
+        if (!data)
+            return;
+        let parsed;
+        try {
+            parsed = JSON.parse(data);
+        }
+        catch {
+            options.onError?.(new Error(`Invalid JSON from voice bridge: ${data.slice(0, 120)}`));
+            return;
+        }
+        const event = decodeServerMessage(parsed);
+        if (!event)
+            return;
+        options.onEvent?.(event);
+        if (event.type === 'session_open')
+            options.onSessionOpen?.(event.sessionId);
+        if (event.type === 'error')
+            options.onError?.(new Error(event.message));
+    });
+    ws.addEventListener('error', () => options.onError?.(new Error('WebSocket error')));
+    ws.addEventListener('close', () => options.onClose?.());
+    const send = (payload) => {
+        try {
+            if (ws.readyState === ws.OPEN)
+                ws.send(JSON.stringify(payload));
+        }
+        catch (error) {
+            options.onError?.(error instanceof Error ? error : new Error(String(error)));
+        }
+    };
+    return {
+        sendAudio(frame) { send({ type: 'audio', audio: bytesToBase64(frame) }); },
+        sendText(text) { send({ type: 'text', text }); },
+        submitToolResult(input) { send({ type: 'tool_result', id: input.id, output: input.output }); },
+        cancel() { send({ type: 'cancel' }); },
+        close() { try {
+            ws.close();
+        }
+        catch { } },
+    };
+}
+function decodeServerMessage(parsed) {
+    const type = String(parsed.type ?? '');
+    switch (type) {
+        case 'session_open':
+            return { type: 'session_open', sessionId: String(parsed.sessionId ?? '') };
+        case 'audio':
+            return typeof parsed.audio === 'string' ? { type: 'audio', audio: base64ToBytes(parsed.audio) } : undefined;
+        case 'text_delta':
+            return { type: 'text_delta', delta: String(parsed.delta ?? ''), role: (parsed.role === 'user' ? 'user' : 'assistant') };
+        case 'transcript':
+            return { type: 'transcript', text: String(parsed.text ?? ''), role: (parsed.role === 'user' ? 'user' : 'assistant') };
+        case 'tool_call':
+            return { type: 'tool_call', id: String(parsed.id ?? ''), name: String(parsed.name ?? ''), input: parsed.input };
+        case 'response_done':
+            return { type: 'response_done', ...(parsed.usage ? { usage: parsed.usage } : {}) };
+        case 'cost_limit':
+            return {
+                type: 'cost_limit',
+                scope: String(parsed.scope ?? ''),
+                observedUsd: Number(parsed.observedUsd ?? 0),
+                limitUsd: Number(parsed.limitUsd ?? 0),
+                ...(typeof parsed.scopeKey === 'string' ? { scopeKey: parsed.scopeKey } : {}),
+            };
+        case 'error':
+            return { type: 'error', message: String(parsed.message ?? 'Voice bridge error') };
+        case 'pong':
+        case 'ack':
+            return undefined;
+        default:
+            return undefined;
+    }
+}
+function appendQueryParams(url, params) {
+    const qs = new URLSearchParams(params).toString();
+    if (!qs)
+        return url;
+    return url.includes('?') ? `${url}&${qs}` : `${url}?${qs}`;
+}
+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);
+}
+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-client.js.map