@framers/agentos 0.9.123 → 0.9.124

package/dist/io/voice-pipeline/providers/CartesiaStreamingTTS.js.map

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

package/dist/io/voice-pipeline/providers/HumeBatchTTS.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @module voice-pipeline/providers/HumeBatchTTS
+ *
+ * Batch text-to-speech via Hume's Octave API (`POST /v0/tts`). Implements
+ * {@link IBatchTTS} for one-shot expressive narration synthesis.
+ *
+ * Contract notes (verified 2026-07-08):
+ * - Auth is the `X-Hume-Api-Key` header.
+ * - `version` is OMITTED by default so requests auto-route: `version: 2`
+ *   REQUIRES an explicit voice, and a hard-coded default would break
+ *   voice-less calls. Callers opt in via `providerOptions.version` and own
+ *   that constraint.
+ * - `expressiveness.instructions` renders as the utterance `description`
+ *   (acting directions) — Hume is the one core provider with a
+ *   natural-language instruction surface — and is reported in
+ *   `appliedExpressiveness` when consumed.
+ * - Response audio arrives base64-encoded in `generations[].audio` with a
+ *   vendor-reported `duration` in seconds.
+ * - `opus` output is unsupported by the vendor and falls back to mp3, with
+ *   the produced format reported on the result.
+ */
+import type { IBatchTTS, BatchTTSConfig, BatchTTSResult } from '../types.js';
+import { type HealthyProvider, type HealthCheckResult, type ProviderCapabilities } from '../HealthyProvider.js';
+/** A Hume voice reference: by id or by name, from the Hume or custom library. */
+export interface HumeVoiceRef {
+    id?: string;
+    name?: string;
+    /** @default 'HUME_AI' */
+    provider?: 'HUME_AI' | 'CUSTOM_VOICE';
+}
+/** Configuration for the Hume batch TTS provider. */
+export interface HumeBatchTTSConfig {
+    /** Hume API key. */
+    apiKey: string;
+    /** Default voice. Optional — voice-less requests auto-generate a voice
+     *  from the description, which is a first-class Octave behavior. */
+    voice?: HumeVoiceRef;
+    /** Base URL for the Hume API. @default 'https://api.hume.ai' */
+    baseUrl?: string;
+    /** Chain priority. Lower values are tried first. @default 86 */
+    priority?: number;
+    /** Optional capability overrides. */
+    capabilities?: Partial<ProviderCapabilities>;
+    /** Injectable health probe for tests. */
+    healthProbe?: (apiKey: string) => Promise<{
+        ok: boolean;
+        status: number;
+        latencyMs: number;
+    }>;
+}
+/**
+ * Batch (one-shot) TTS provider using Hume's Octave `/v0/tts` endpoint.
+ */
+export declare class HumeBatchTTS implements IBatchTTS, HealthyProvider {
+    readonly providerId = "hume-octave";
+    readonly priority: number;
+    readonly capabilities: ProviderCapabilities;
+    /** API key pool for round-robin rotation and quota failover. */
+    private readonly keyPool;
+    /** Default voice when none is provided in the synthesis config. */
+    private readonly voice;
+    /** Base URL for all API requests. */
+    private readonly baseUrl;
+    /** Injectable health probe for tests. */
+    private readonly healthProbe;
+    constructor(config: HumeBatchTTSConfig);
+    healthCheck(): Promise<HealthCheckResult>;
+    /** Normalize a voice reference into Hume's `{id|name, provider}` shape. */
+    private static toHumeVoice;
+    /**
+     * Synthesize complete text into audio via Hume's Octave REST API.
+     *
+     * @param text - The text to synthesize.
+     * @param config - Optional synthesis configuration (voice, format, speed,
+     *   expressiveness.instructions → description).
+     * @returns Resolved {@link BatchTTSResult} with the decoded audio buffer.
+     * @throws Error if the API returns a non-OK status or an empty generation.
+     */
+    synthesize(text: string, config?: BatchTTSConfig): Promise<BatchTTSResult>;
+}
+//# sourceMappingURL=HumeBatchTTS.d.ts.map

package/dist/io/voice-pipeline/providers/HumeBatchTTS.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HumeBatchTTS.d.ts","sourceRoot":"","sources":["../../../../src/io/voice-pipeline/providers/HumeBatchTTS.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7E,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAS/B,iFAAiF;AACjF,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,QAAQ,CAAC,EAAE,SAAS,GAAG,cAAc,CAAC;CACvC;AAWD,qDAAqD;AACrD,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf;wEACoE;IACpE,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC7C,yCAAyC;IACzC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/F;AAED;;GAEG;AACH,qBAAa,YAAa,YAAW,SAAS,EAAE,eAAe;IAC7D,QAAQ,CAAC,UAAU,iBAAiB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAE5C,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IAErC,mEAAmE;IACnE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IAEjD,qCAAqC;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiD;gBAEjE,MAAM,EAAE,kBAAkB;IAehC,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;IA6B/C,2EAA2E;IAC3E,OAAO,CAAC,MAAM,CAAC,WAAW;IAY1B;;;;;;;;OAQG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;CAiFjF"}

package/dist/io/voice-pipeline/providers/HumeBatchTTS.js

@@ -0,0 +1,177 @@
+/**
+ * @module voice-pipeline/providers/HumeBatchTTS
+ *
+ * Batch text-to-speech via Hume's Octave API (`POST /v0/tts`). Implements
+ * {@link IBatchTTS} for one-shot expressive narration synthesis.
+ *
+ * Contract notes (verified 2026-07-08):
+ * - Auth is the `X-Hume-Api-Key` header.
+ * - `version` is OMITTED by default so requests auto-route: `version: 2`
+ *   REQUIRES an explicit voice, and a hard-coded default would break
+ *   voice-less calls. Callers opt in via `providerOptions.version` and own
+ *   that constraint.
+ * - `expressiveness.instructions` renders as the utterance `description`
+ *   (acting directions) — Hume is the one core provider with a
+ *   natural-language instruction surface — and is reported in
+ *   `appliedExpressiveness` when consumed.
+ * - Response audio arrives base64-encoded in `generations[].audio` with a
+ *   vendor-reported `duration` in seconds.
+ * - `opus` output is unsupported by the vendor and falls back to mp3, with
+ *   the produced format reported on the result.
+ */
+import { ApiKeyPool } from '../../../core/providers/ApiKeyPool.js';
+import { isQuotaError } from '../../../core/providers/quotaErrors.js';
+import { defaultCapabilities, } from '../HealthyProvider.js';
+import { VoicePipelineError } from '../VoicePipelineError.js';
+/** Approximate bytes per second for 128kbps MP3 audio (duration fallback). */
+const BYTES_PER_SEC_MP3 = 16000;
+/** Per-request synthesize timeout (same rationale as the sibling providers). */
+const SYNTHESIZE_TIMEOUT_MS = 60000;
+async function defaultHumeProbe(apiKey) {
+    const start = Date.now();
+    const res = await fetch('https://api.hume.ai/v0/tts/voices?provider=HUME_AI&page_size=1', {
+        headers: { 'X-Hume-Api-Key': apiKey },
+        signal: AbortSignal.timeout(1000),
+    });
+    return { ok: res.ok, status: res.status, latencyMs: Date.now() - start };
+}
+/**
+ * Batch (one-shot) TTS provider using Hume's Octave `/v0/tts` endpoint.
+ */
+export class HumeBatchTTS {
+    constructor(config) {
+        this.providerId = 'hume-octave';
+        this.keyPool = new ApiKeyPool(config.apiKey);
+        this.voice = config.voice;
+        this.baseUrl = config.baseUrl ?? 'https://api.hume.ai';
+        this.priority = config.priority ?? 86;
+        this.capabilities = defaultCapabilities({
+            languages: ['*'],
+            streaming: false,
+            costTier: 'premium',
+            latencyClass: 'batch',
+            ...(config.capabilities ?? {}),
+        });
+        this.healthProbe = config.healthProbe ?? defaultHumeProbe;
+    }
+    async healthCheck() {
+        if (!this.keyPool.hasKeys) {
+            return { ok: false, error: { class: 'auth', message: 'no api key available' } };
+        }
+        const key = this.keyPool.next();
+        try {
+            const res = await this.healthProbe(key);
+            if (res.ok)
+                return { ok: true, latencyMs: res.latencyMs };
+            const classified = VoicePipelineError.classifyError(new Error(`HTTP ${res.status}`), { kind: 'tts', provider: this.providerId });
+            return {
+                ok: false,
+                latencyMs: res.latencyMs,
+                error: { class: classified.errorClass, message: `HTTP ${res.status}` },
+            };
+        }
+        catch (err) {
+            const classified = VoicePipelineError.classifyError(err, {
+                kind: 'tts',
+                provider: this.providerId,
+            });
+            return {
+                ok: false,
+                error: { class: classified.errorClass, message: classified.message },
+            };
+        }
+    }
+    /** Normalize a voice reference into Hume's `{id|name, provider}` shape. */
+    static toHumeVoice(voice) {
+        if (voice == null)
+            return undefined;
+        if (typeof voice === 'string')
+            return { name: voice, provider: 'HUME_AI' };
+        const out = { provider: voice.provider ?? 'HUME_AI' };
+        if (voice.id)
+            out.id = voice.id;
+        else if (voice.name)
+            out.name = voice.name;
+        else
+            return undefined;
+        return out;
+    }
+    /**
+     * Synthesize complete text into audio via Hume's Octave REST API.
+     *
+     * @param text - The text to synthesize.
+     * @param config - Optional synthesis configuration (voice, format, speed,
+     *   expressiveness.instructions → description).
+     * @returns Resolved {@link BatchTTSResult} with the decoded audio buffer.
+     * @throws Error if the API returns a non-OK status or an empty generation.
+     */
+    async synthesize(text, config) {
+        const requested = config?.format ?? 'mp3';
+        const format = requested === 'pcm' ? 'pcm' : 'mp3';
+        const applied = [];
+        const instructions = config?.expressiveness?.instructions;
+        if (instructions)
+            applied.push('instructions');
+        const rawSpeed = config?.speed ?? config?.expressiveness?.speed;
+        const speed = typeof rawSpeed === 'number' && Number.isFinite(rawSpeed) ? rawSpeed : undefined;
+        if (speed != null)
+            applied.push('speed');
+        const voice = HumeBatchTTS.toHumeVoice(config?.voice ?? this.voice);
+        // `version` is deliberately NOT defaulted (auto-routing); callers opting
+        // into Octave 2 via providerOptions must also supply a voice.
+        const body = {
+            utterances: [
+                {
+                    text,
+                    ...(instructions ? { description: instructions } : {}),
+                    ...(voice ? { voice } : {}),
+                    ...(speed != null ? { speed } : {}),
+                },
+            ],
+            format: { type: format },
+            ...(config?.providerOptions ?? {}),
+        };
+        const doFetch = (key) => fetch(`${this.baseUrl}/v0/tts`, {
+            method: 'POST',
+            headers: {
+                'X-Hume-Api-Key': key,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(SYNTHESIZE_TIMEOUT_MS),
+        });
+        const key = this.keyPool.next();
+        let res = await doFetch(key);
+        if (!res.ok && this.keyPool.size > 1) {
+            const errBody = await res.text().catch(() => '');
+            if (isQuotaError(res.status, errBody)) {
+                this.keyPool.markExhausted(key);
+                res = await doFetch(this.keyPool.next());
+            }
+            else {
+                throw new Error(`Hume TTS failed: ${res.status} ${errBody.slice(0, 200)}`);
+            }
+        }
+        if (!res.ok) {
+            const detail = await res.text().catch(() => '');
+            throw new Error(`Hume TTS failed: ${res.status} ${detail.slice(0, 200)}`);
+        }
+        const payload = (await res.json());
+        const generation = payload.generations?.[0];
+        if (!generation?.audio) {
+            throw new Error('Hume TTS returned no generations');
+        }
+        const audio = Buffer.from(generation.audio, 'base64');
+        const durationMs = typeof generation.duration === 'number' && Number.isFinite(generation.duration)
+            ? Math.round(generation.duration * 1000)
+            : Math.round((audio.byteLength / BYTES_PER_SEC_MP3) * 1000);
+        return {
+            audio,
+            format,
+            durationMs,
+            provider: this.providerId,
+            ...(applied.length > 0 ? { appliedExpressiveness: applied } : {}),
+        };
+    }
+}
+//# sourceMappingURL=HumeBatchTTS.js.map

package/dist/io/voice-pipeline/providers/HumeBatchTTS.js.map

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

package/dist/io/voice-pipeline/providers/HumeStreamingTTS.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @module voice-pipeline/providers/HumeStreamingTTS
+ *
+ * Streaming text-to-speech via Hume's Octave WSS input-streaming API.
+ * Implements {@link IStreamingTTS} for realtime token-in / audio-out
+ * synthesis.
+ *
+ * Contract notes (pinned from the vendor reference 2026-07-08):
+ * - Endpoint: `wss://api.hume.ai/v0/tts/stream/input?api_key=…`. This is the
+ *   TRUE incremental-input surface — `POST /v0/tts/stream/json` only streams
+ *   OUTPUT for a complete request and is deliberately not used here.
+ * - `no_binary=true` keeps every server frame a JSON `TtsOutput` message
+ *   (base64 `audio`, `audio_format`, `chunk_index`, …) — no binary frames to
+ *   special-case.
+ * - `instant_mode` requires an explicit voice; it is enabled exactly when a
+ *   voice is configured and disabled otherwise (voice-less sessions
+ *   auto-generate a voice from the description, which instant mode forbids).
+ * - Client publishes `InputMessage` JSON: `{ text }` per token batch,
+ *   `{ flush: true }` to force generation of buffered text, `{ close: true }`
+ *   to finish and close. Acting directions (`description`) and the voice ride
+ *   the FIRST publish; Hume persists them for subsequent utterances until
+ *   overridden.
+ * - There is no vendor cancel: `cancel()` is a local hard-stop — drop all
+ *   further inbound chunks and close the socket.
+ */
+import type { IStreamingTTS, StreamingTTSConfig, StreamingTTSSession } from '../types.js';
+import { type HealthyProvider, type HealthCheckResult, type ProviderCapabilities } from '../HealthyProvider.js';
+import type { HumeVoiceRef } from './HumeBatchTTS.js';
+/** Configuration for the Hume streaming TTS provider. */
+export interface HumeStreamingTTSConfig {
+    /** Hume API key. */
+    apiKey: string;
+    /** Default voice. Optional — voice-less sessions run without instant mode
+     *  and let Octave derive a voice from the acting description. */
+    voice?: HumeVoiceRef;
+    /** WebSocket endpoint. @default 'wss://api.hume.ai/v0/tts/stream/input' */
+    wsUrl?: string;
+    /** Chain priority. Lower values are tried first. @default 14 */
+    priority?: number;
+    /** Optional capability overrides. */
+    capabilities?: Partial<ProviderCapabilities>;
+}
+/**
+ * Streaming TTS provider for Hume Octave voices — the expressive leg of the
+ * chain (acting directions via `expressiveness.instructions`).
+ */
+export declare class HumeStreamingTTS implements IStreamingTTS, HealthyProvider {
+    readonly providerId = "hume-octave-stream";
+    readonly priority: number;
+    readonly capabilities: ProviderCapabilities;
+    private readonly keyPool;
+    private readonly voice;
+    private readonly wsUrl;
+    constructor(config: HumeStreamingTTSConfig);
+    healthCheck(): Promise<HealthCheckResult>;
+    startSession(config?: StreamingTTSConfig): Promise<StreamingTTSSession>;
+}
+//# sourceMappingURL=HumeStreamingTTS.d.ts.map

package/dist/io/voice-pipeline/providers/HumeStreamingTTS.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HumeStreamingTTS.d.ts","sourceRoot":"","sources":["../../../../src/io/voice-pipeline/providers/HumeStreamingTTS.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,OAAO,KAAK,EAEV,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAErB,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EAC1B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,yDAAyD;AACzD,MAAM,WAAW,sBAAsB;IACrC,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf;qEACiE;IACjE,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC9C;AAuJD;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,aAAa,EAAE,eAAe;IACrE,QAAQ,CAAC,UAAU,wBAAwB;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAE5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,MAAM,EAAE,sBAAsB;IAcpC,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAmCzC,YAAY,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAiB9E"}

package/dist/io/voice-pipeline/providers/HumeStreamingTTS.js

@@ -0,0 +1,240 @@
+/**
+ * @module voice-pipeline/providers/HumeStreamingTTS
+ *
+ * Streaming text-to-speech via Hume's Octave WSS input-streaming API.
+ * Implements {@link IStreamingTTS} for realtime token-in / audio-out
+ * synthesis.
+ *
+ * Contract notes (pinned from the vendor reference 2026-07-08):
+ * - Endpoint: `wss://api.hume.ai/v0/tts/stream/input?api_key=…`. This is the
+ *   TRUE incremental-input surface — `POST /v0/tts/stream/json` only streams
+ *   OUTPUT for a complete request and is deliberately not used here.
+ * - `no_binary=true` keeps every server frame a JSON `TtsOutput` message
+ *   (base64 `audio`, `audio_format`, `chunk_index`, …) — no binary frames to
+ *   special-case.
+ * - `instant_mode` requires an explicit voice; it is enabled exactly when a
+ *   voice is configured and disabled otherwise (voice-less sessions
+ *   auto-generate a voice from the description, which instant mode forbids).
+ * - Client publishes `InputMessage` JSON: `{ text }` per token batch,
+ *   `{ flush: true }` to force generation of buffered text, `{ close: true }`
+ *   to finish and close. Acting directions (`description`) and the voice ride
+ *   the FIRST publish; Hume persists them for subsequent utterances until
+ *   overridden.
+ * - There is no vendor cancel: `cancel()` is a local hard-stop — drop all
+ *   further inbound chunks and close the socket.
+ */
+import { EventEmitter } from 'node:events';
+import WebSocket from 'ws';
+import { ApiKeyPool } from '../../../core/providers/ApiKeyPool.js';
+import { defaultCapabilities, } from '../HealthyProvider.js';
+import { VoicePipelineError } from '../VoicePipelineError.js';
+/** Normalize a voice reference into Hume's `{id|name, provider}` shape. */
+function toHumeVoice(voice) {
+    if (voice == null)
+        return undefined;
+    if (typeof voice === 'string')
+        return { name: voice, provider: 'HUME_AI' };
+    const out = { provider: voice.provider ?? 'HUME_AI' };
+    if (voice.id)
+        out.id = voice.id;
+    else if (voice.name)
+        out.name = voice.name;
+    else
+        return undefined;
+    return out;
+}
+/**
+ * One live Hume input-streaming session. First publish carries the sticky
+ * session attributes (voice, description); later publishes are bare text.
+ */
+class HumeStreamingTTSSession extends EventEmitter {
+    constructor(opts) {
+        super();
+        this.opts = opts;
+        /** Exposed for tests (mirrors the sibling sessions' introspection seam). */
+        this.ws = null;
+        /** Attributes that ride the first publish only. */
+        this.firstPublishDone = false;
+        /** Local hard-cancel latch: drop every inbound frame once set. */
+        this.cancelled = false;
+        this.closed = false;
+        this.flushResolvers = [];
+        /** Tokens pushed since the last flush boundary — stamped on each chunk so
+         *  barge-in handlers can report the interrupted remainder. */
+        this.accumulatedText = '';
+    }
+    /** Open the socket; resolves once the connection is live. */
+    async connect() {
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(this.opts.url);
+            this.ws = ws;
+            ws.on('open', () => resolve());
+            ws.on('error', (err) => {
+                if (this.closed || this.cancelled)
+                    return;
+                this.emit('error', err);
+                reject(err);
+            });
+            ws.on('close', () => {
+                if (!this.closed)
+                    this.emit('close');
+            });
+            ws.on('message', (raw) => this.onMessage(raw));
+        });
+    }
+    onMessage(raw) {
+        if (this.cancelled)
+            return; // hard-cancel: late frames drop silently
+        let msg;
+        try {
+            msg = JSON.parse(String(raw));
+        }
+        catch {
+            return; // binary frames are disabled via no_binary=true
+        }
+        if (typeof msg.audio === 'string' && msg.audio.length > 0) {
+            const audio = Buffer.from(msg.audio, 'base64');
+            const format = msg.audio_format === 'pcm' ? 'pcm' : 'mp3';
+            const chunk = {
+                audio,
+                format,
+                sampleRate: format === 'pcm' ? 48000 : 44100,
+                durationMs: Math.max(1, Math.round((audio.byteLength / 16000) * 1000)),
+                text: this.accumulatedText,
+            };
+            this.emit('audio', chunk);
+            return;
+        }
+        // Any explicit flush/finish boundary resolves pending flush() callers.
+        if (msg.type === 'flushed' || msg.type === 'done') {
+            this.accumulatedText = '';
+            const resolvers = this.flushResolvers;
+            this.flushResolvers = [];
+            this.emit('flush_complete');
+            for (const r of resolvers)
+                r();
+        }
+    }
+    send(payload) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN)
+            return;
+        this.ws.send(JSON.stringify(payload));
+    }
+    pushTokens(tokens) {
+        if (this.closed || this.cancelled || tokens.length === 0)
+            return;
+        this.accumulatedText += tokens;
+        if (!this.firstPublishDone) {
+            this.firstPublishDone = true;
+            this.send({
+                text: tokens,
+                ...(this.opts.description ? { description: this.opts.description } : {}),
+                ...(this.opts.voice ? { voice: this.opts.voice } : {}),
+            });
+            return;
+        }
+        this.send({ text: tokens });
+    }
+    async flush() {
+        if (this.closed || this.cancelled)
+            return;
+        const done = new Promise((resolve) => this.flushResolvers.push(resolve));
+        this.send({ flush: true });
+        await done;
+    }
+    cancel() {
+        if (this.closed || this.cancelled)
+            return;
+        // No vendor cancel exists: latch locally so late chunks drop, then tear
+        // down the socket. Callers stop playback separately per the contract.
+        this.cancelled = true;
+        this.flushResolvers = [];
+        this.accumulatedText = '';
+        try {
+            this.ws?.close();
+        }
+        catch {
+            /* already gone */
+        }
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.send({ close: true });
+        try {
+            this.ws?.close();
+        }
+        catch {
+            /* already gone */
+        }
+        this.emit('close');
+    }
+}
+/**
+ * Streaming TTS provider for Hume Octave voices — the expressive leg of the
+ * chain (acting directions via `expressiveness.instructions`).
+ */
+export class HumeStreamingTTS {
+    constructor(config) {
+        this.providerId = 'hume-octave-stream';
+        this.keyPool = new ApiKeyPool(config.apiKey);
+        this.voice = config.voice;
+        this.wsUrl = config.wsUrl ?? 'wss://api.hume.ai/v0/tts/stream/input';
+        this.priority = config.priority ?? 14;
+        this.capabilities = defaultCapabilities({
+            languages: ['*'],
+            streaming: true,
+            costTier: 'premium',
+            latencyClass: 'realtime',
+            ...(config.capabilities ?? {}),
+        });
+    }
+    async healthCheck() {
+        if (!this.keyPool.hasKeys) {
+            return { ok: false, error: { class: 'auth', message: 'no api key available' } };
+        }
+        const start = Date.now();
+        try {
+            const res = await fetch('https://api.hume.ai/v0/tts/voices?provider=HUME_AI&page_size=1', {
+                headers: { 'X-Hume-Api-Key': this.keyPool.next() },
+                signal: AbortSignal.timeout(1000),
+            });
+            if (res.ok)
+                return { ok: true, latencyMs: Date.now() - start };
+            const classified = VoicePipelineError.classifyError(new Error(`HTTP ${res.status}`), { kind: 'tts', provider: this.providerId });
+            return {
+                ok: false,
+                latencyMs: Date.now() - start,
+                error: { class: classified.errorClass, message: `HTTP ${res.status}` },
+            };
+        }
+        catch (err) {
+            const classified = VoicePipelineError.classifyError(err, {
+                kind: 'tts',
+                provider: this.providerId,
+            });
+            return {
+                ok: false,
+                error: { class: classified.errorClass, message: classified.message },
+            };
+        }
+    }
+    async startSession(config) {
+        const key = this.keyPool.next();
+        const voice = toHumeVoice(config?.voice ?? this.voice);
+        // instant_mode demands an explicit voice — enable it exactly when we
+        // have one; voice-less sessions trade first-chunk latency for Octave's
+        // description-derived voice generation.
+        const url = `${this.wsUrl}?api_key=${encodeURIComponent(key)}` +
+            `&no_binary=true&instant_mode=${voice ? 'true' : 'false'}`;
+        const session = new HumeStreamingTTSSession({
+            url,
+            voice,
+            description: config?.expressiveness?.instructions,
+        });
+        await session.connect();
+        return session;
+    }
+}
+//# sourceMappingURL=HumeStreamingTTS.js.map

package/dist/io/voice-pipeline/providers/HumeStreamingTTS.js.map

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

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

@@ -17,6 +17,10 @@ export { AgentSessionVoiceAdapter } from './AgentSessionVoiceAdapter.js';
 export { OpenAIBatchTTS, type OpenAIBatchTTSConfig } from './OpenAIBatchTTS.js';
 export { ElevenLabsBatchTTS, type ElevenLabsBatchTTSConfig } from './ElevenLabsBatchTTS.js';
 export { DeepgramAuraBatchTTS, type DeepgramAuraBatchTTSConfig, chunkForAura, } from './DeepgramAuraBatchTTS.js';
+export { CartesiaBatchTTS, CARTESIA_VERSION, type CartesiaBatchTTSConfig, } from './CartesiaBatchTTS.js';
+export { CartesiaStreamingTTS, type CartesiaStreamingTTSConfig, } from './CartesiaStreamingTTS.js';
+export { HumeBatchTTS, type HumeBatchTTSConfig, type HumeVoiceRef, } from './HumeBatchTTS.js';
+export { HumeStreamingTTS, type HumeStreamingTTSConfig, } from './HumeStreamingTTS.js';
 export { BatchTTSFallback } from './BatchTTSFallback.js';
 export { BatchSTTFallback, EmptyTranscriptError, } from './BatchSTTFallback.js';
 export { DeepgramPreRecordedBatchSTT, type DeepgramPreRecordedBatchSTTConfig, } from './DeepgramPreRecordedBatchSTT.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/io/voice-pipeline/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;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,EACL,wBAAwB,EACxB,KAAK,8BAA8B,GACpC,MAAM,+BAA+B,CAAC;AACvC,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;AAC5F,OAAO,EACL,oBAAoB,EACpB,KAAK,0BAA0B,EAC/B,YAAY,GACb,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EACL,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,2BAA2B,EAC3B,KAAK,iCAAiC,GACvC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,qBAAqB,EACrB,KAAK,2BAA2B,GACjC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,GAC9B,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/io/voice-pipeline/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;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,EACL,wBAAwB,EACxB,KAAK,8BAA8B,GACpC,MAAM,+BAA+B,CAAC;AACvC,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;AAC5F,OAAO,EACL,oBAAoB,EACpB,KAAK,0BAA0B,EAC/B,YAAY,GACb,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,oBAAoB,EACpB,KAAK,0BAA0B,GAChC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,YAAY,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EACL,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,2BAA2B,EAC3B,KAAK,iCAAiC,GACvC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,qBAAqB,EACrB,KAAK,2BAA2B,GACjC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,GAC9B,MAAM,wBAAwB,CAAC"}

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

@@ -17,6 +17,10 @@ export { AgentSessionVoiceAdapter } from './AgentSessionVoiceAdapter.js';
 export { OpenAIBatchTTS } from './OpenAIBatchTTS.js';
 export { ElevenLabsBatchTTS } from './ElevenLabsBatchTTS.js';
 export { DeepgramAuraBatchTTS, chunkForAura, } from './DeepgramAuraBatchTTS.js';
+export { CartesiaBatchTTS, CARTESIA_VERSION, } from './CartesiaBatchTTS.js';
+export { CartesiaStreamingTTS, } from './CartesiaStreamingTTS.js';
+export { HumeBatchTTS, } from './HumeBatchTTS.js';
+export { HumeStreamingTTS, } from './HumeStreamingTTS.js';
 export { BatchTTSFallback } from './BatchTTSFallback.js';
 // Batch (one-shot) STT providers.
 export { BatchSTTFallback, EmptyTranscriptError, } from './BatchSTTFallback.js';