@actrun_ai/tastekit-voice 0.1.0

package/dist/resolve.js.map

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

package/dist/stt/elevenlabs-stt.d.ts

@@ -0,0 +1,25 @@
+import type { STTProvider, TranscriptEvent } from './provider.js';
+export interface ElevenLabsSTTOptions {
+    apiKey: string;
+    language?: string;
+    /** VAD silence threshold in seconds (default 1.5) */
+    vadSilenceThreshold?: number;
+    /** Base WebSocket URL (default: wss://api.elevenlabs.io) */
+    baseUrl?: string;
+    sampleRate?: number;
+}
+/**
+ * ElevenLabs Scribe v2 realtime speech-to-text provider.
+ *
+ * Opens a WebSocket to the ElevenLabs realtime STT endpoint.
+ * Sends base64-encoded PCM audio chunks and yields transcript events.
+ * Built-in VAD commits transcription when the user stops speaking.
+ */
+export declare class ElevenLabsSTT implements STTProvider {
+    readonly name = "elevenlabs-stt";
+    private options;
+    constructor(options: ElevenLabsSTTOptions);
+    transcribe(audio: AsyncIterable<Buffer>): AsyncIterable<TranscriptEvent>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=elevenlabs-stt.d.ts.map

package/dist/stt/elevenlabs-stt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs-stt.d.ts","sourceRoot":"","sources":["../../src/stt/elevenlabs-stt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,qBAAa,aAAc,YAAW,WAAW;IAC/C,QAAQ,CAAC,IAAI,oBAAoB;IACjC,OAAO,CAAC,OAAO,CAAiH;gBAEpH,OAAO,EAAE,oBAAoB;IAUlC,UAAU,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,eAAe,CAAC;IA6HzE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/dist/stt/elevenlabs-stt.js

@@ -0,0 +1,140 @@
+import WebSocket from 'ws';
+/**
+ * ElevenLabs Scribe v2 realtime speech-to-text provider.
+ *
+ * Opens a WebSocket to the ElevenLabs realtime STT endpoint.
+ * Sends base64-encoded PCM audio chunks and yields transcript events.
+ * Built-in VAD commits transcription when the user stops speaking.
+ */
+export class ElevenLabsSTT {
+    name = 'elevenlabs-stt';
+    options;
+    constructor(options) {
+        this.options = {
+            apiKey: options.apiKey,
+            language: options.language ?? 'en',
+            vadSilenceThreshold: options.vadSilenceThreshold ?? 1.5,
+            baseUrl: options.baseUrl ?? 'wss://api.elevenlabs.io',
+            sampleRate: options.sampleRate ?? 16000,
+        };
+    }
+    async *transcribe(audio) {
+        const { apiKey, language, vadSilenceThreshold, baseUrl, sampleRate } = this.options;
+        const url = `${baseUrl}/v1/speech-to-text/realtime?model_id=scribe_v2_realtime&language_code=${language}&audio_format=pcm_${sampleRate}`;
+        const ws = new WebSocket(url, {
+            headers: { 'xi-api-key': apiKey },
+        });
+        // Queue for transcript events received from the server
+        const eventQueue = [];
+        let resolveWaiting = null;
+        let done = false;
+        let error = null;
+        ws.on('message', (data) => {
+            try {
+                const msg = JSON.parse(data.toString());
+                if (msg.message_type === 'partial_transcript' && msg.text) {
+                    eventQueue.push({ type: 'partial', text: msg.text });
+                }
+                else if (msg.message_type === 'committed_transcript' && msg.text) {
+                    eventQueue.push({ type: 'final', text: msg.text });
+                }
+                else if (msg.message_type === 'error' || msg.message_type === 'auth_error') {
+                    error = new Error(`ElevenLabs STT error: ${msg.message ?? msg.error ?? 'unknown'}`);
+                }
+                if (resolveWaiting) {
+                    resolveWaiting();
+                    resolveWaiting = null;
+                }
+            }
+            catch {
+                // Ignore malformed messages
+            }
+        });
+        ws.on('error', (err) => {
+            error = err instanceof Error ? err : new Error(String(err));
+            if (resolveWaiting) {
+                resolveWaiting();
+                resolveWaiting = null;
+            }
+        });
+        ws.on('close', () => {
+            done = true;
+            if (resolveWaiting) {
+                resolveWaiting();
+                resolveWaiting = null;
+            }
+        });
+        // Wait for connection to open
+        await new Promise((resolve, reject) => {
+            ws.on('open', resolve);
+            ws.on('error', reject);
+        });
+        // Start sending audio in the background
+        const sendAudio = (async () => {
+            try {
+                let isFirst = true;
+                for await (const chunk of audio) {
+                    if (ws.readyState !== WebSocket.OPEN)
+                        break;
+                    const message = {
+                        message_type: 'input_audio_chunk',
+                        audio_base_64: chunk.toString('base64'),
+                        sample_rate: sampleRate,
+                        commit: false,
+                    };
+                    // Only send previous_text on the first chunk
+                    if (isFirst) {
+                        message.previous_text = '';
+                        isFirst = false;
+                    }
+                    ws.send(JSON.stringify(message));
+                }
+                // Send a final commit to flush any remaining audio
+                if (ws.readyState === WebSocket.OPEN) {
+                    ws.send(JSON.stringify({
+                        message_type: 'input_audio_chunk',
+                        audio_base_64: '',
+                        sample_rate: sampleRate,
+                        commit: true,
+                    }));
+                }
+            }
+            catch {
+                // Audio stream ended or WebSocket closed
+            }
+        })();
+        // Yield transcript events as they arrive
+        try {
+            while (!done || eventQueue.length > 0) {
+                if (error)
+                    throw error;
+                if (eventQueue.length > 0) {
+                    yield eventQueue.shift();
+                    // If we got a final transcript, we're done with this utterance
+                    if (eventQueue.length === 0) {
+                        const lastEvent = eventQueue[eventQueue.length];
+                        // Check if the last yielded event was final
+                        // Actually, let's check: we already yielded it above, so we need
+                        // to track differently. Let's just continue and let the caller
+                        // decide when to stop.
+                    }
+                }
+                else if (!done) {
+                    await new Promise((resolve) => {
+                        resolveWaiting = resolve;
+                    });
+                }
+            }
+        }
+        finally {
+            await sendAudio;
+            if (ws.readyState === WebSocket.OPEN || ws.readyState === WebSocket.CONNECTING) {
+                ws.close();
+            }
+        }
+    }
+    async dispose() {
+        // No persistent state to clean up — each transcribe() call manages its own WebSocket
+    }
+}
+//# sourceMappingURL=elevenlabs-stt.js.map

package/dist/stt/elevenlabs-stt.js.map

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

package/dist/stt/provider.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Speech-to-Text Provider Interface
+ *
+ * Consumes an audio stream and yields transcription events.
+ * Implementations: ElevenLabs Scribe v2, Whisper.cpp
+ */
+export interface TranscriptEvent {
+    /** 'partial' = interim result, 'final' = committed transcription */
+    type: 'partial' | 'final';
+    /** Transcribed text */
+    text: string;
+    /** Confidence score 0-1, if available */
+    confidence?: number;
+}
+export interface STTProvider {
+    readonly name: string;
+    /**
+     * Transcribe an audio stream into text events.
+     * @param audio PCM audio chunks (16-bit, 16kHz mono)
+     */
+    transcribe(audio: AsyncIterable<Buffer>): AsyncIterable<TranscriptEvent>;
+    /** Clean up resources (close WebSocket, etc.) */
+    dispose?(): Promise<void>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/stt/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/stt/provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAC1B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,UAAU,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC;IACzE,iDAAiD;IACjD,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}

package/dist/stt/provider.js

@@ -0,0 +1,8 @@
+/**
+ * Speech-to-Text Provider Interface
+ *
+ * Consumes an audio stream and yields transcription events.
+ * Implementations: ElevenLabs Scribe v2, Whisper.cpp
+ */
+export {};
+//# sourceMappingURL=provider.js.map

package/dist/stt/provider.js.map

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

package/dist/stt/whisper-stt.d.ts

@@ -0,0 +1,27 @@
+import type { STTProvider, TranscriptEvent } from './provider.js';
+export interface WhisperSTTOptions {
+    /** Path to whisper.cpp main binary (default: 'whisper-cpp') */
+    binaryPath?: string;
+    /** Whisper model name/path (default: 'base.en') */
+    model?: string;
+    /** Language for transcription */
+    language?: string;
+}
+/**
+ * Local Whisper.cpp speech-to-text provider.
+ *
+ * Records the full utterance, writes to a temp WAV file,
+ * then runs whisper.cpp for batch transcription.
+ * No partial transcripts — yields a single final event.
+ */
+export declare class WhisperSTT implements STTProvider {
+    readonly name = "whisper-stt";
+    private binaryPath;
+    private model;
+    private language;
+    constructor(options?: WhisperSTTOptions);
+    transcribe(audio: AsyncIterable<Buffer>): AsyncIterable<TranscriptEvent>;
+    private runWhisper;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=whisper-stt.d.ts.map

package/dist/stt/whisper-stt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whisper-stt.d.ts","sourceRoot":"","sources":["../../src/stt/whisper-stt.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,qBAAa,UAAW,YAAW,WAAW;IAC5C,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,CAAC,EAAE,iBAAiB;IAMhC,UAAU,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,eAAe,CAAC;IA0B/E,OAAO,CAAC,UAAU;IAoBZ,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/dist/stt/whisper-stt.js

@@ -0,0 +1,95 @@
+import { execFile } from 'child_process';
+import { writeFileSync, unlinkSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+/**
+ * Local Whisper.cpp speech-to-text provider.
+ *
+ * Records the full utterance, writes to a temp WAV file,
+ * then runs whisper.cpp for batch transcription.
+ * No partial transcripts — yields a single final event.
+ */
+export class WhisperSTT {
+    name = 'whisper-stt';
+    binaryPath;
+    model;
+    language;
+    constructor(options) {
+        this.binaryPath = options?.binaryPath ?? 'whisper-cpp';
+        this.model = options?.model ?? 'base.en';
+        this.language = options?.language ?? 'en';
+    }
+    async *transcribe(audio) {
+        // Collect all audio chunks into a single buffer
+        const chunks = [];
+        for await (const chunk of audio) {
+            chunks.push(chunk);
+        }
+        const rawPcm = Buffer.concat(chunks);
+        if (rawPcm.length === 0) {
+            return;
+        }
+        // Write raw PCM as a WAV file (16-bit, 16kHz, mono)
+        const tempPath = join(tmpdir(), `tastekit-voice-${Date.now()}.wav`);
+        writeWav(tempPath, rawPcm, 16000);
+        try {
+            const text = await this.runWhisper(tempPath);
+            if (text.trim()) {
+                yield { type: 'final', text: text.trim() };
+            }
+        }
+        finally {
+            try {
+                unlinkSync(tempPath);
+            }
+            catch { /* ignore */ }
+        }
+    }
+    runWhisper(wavPath) {
+        return new Promise((resolve, reject) => {
+            const args = [
+                '-m', this.model,
+                '-l', this.language,
+                '-f', wavPath,
+                '--no-timestamps',
+                '--print-progress', 'false',
+            ];
+            execFile(this.binaryPath, args, { timeout: 30000 }, (err, stdout, stderr) => {
+                if (err) {
+                    reject(new Error(`Whisper failed: ${stderr || err.message}`));
+                }
+                else {
+                    resolve(stdout);
+                }
+            });
+        });
+    }
+    async dispose() {
+        // Stateless
+    }
+}
+/** Write raw 16-bit PCM data as a WAV file. */
+function writeWav(path, pcm, sampleRate) {
+    const numChannels = 1;
+    const bitsPerSample = 16;
+    const byteRate = sampleRate * numChannels * (bitsPerSample / 8);
+    const blockAlign = numChannels * (bitsPerSample / 8);
+    const dataSize = pcm.length;
+    const headerSize = 44;
+    const header = Buffer.alloc(headerSize);
+    header.write('RIFF', 0);
+    header.writeUInt32LE(dataSize + headerSize - 8, 4);
+    header.write('WAVE', 8);
+    header.write('fmt ', 12);
+    header.writeUInt32LE(16, 16); // fmt chunk size
+    header.writeUInt16LE(1, 20); // PCM format
+    header.writeUInt16LE(numChannels, 22);
+    header.writeUInt32LE(sampleRate, 24);
+    header.writeUInt32LE(byteRate, 28);
+    header.writeUInt16LE(blockAlign, 32);
+    header.writeUInt16LE(bitsPerSample, 34);
+    header.write('data', 36);
+    header.writeUInt32LE(dataSize, 40);
+    writeFileSync(path, Buffer.concat([header, pcm]));
+}
+//# sourceMappingURL=whisper-stt.js.map

package/dist/stt/whisper-stt.js.map

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

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

@@ -0,0 +1,24 @@
+import type { TTSProvider } from './provider.js';
+export interface ElevenLabsTTSOptions {
+    apiKey: string;
+    /** ElevenLabs voice ID (default: Rachel - 21m00Tcm4TlvDq8ikWAM) */
+    voiceId?: string;
+    /** Model ID (default: eleven_multilingual_v2) */
+    modelId?: string;
+    /** Base URL (default: https://api.elevenlabs.io) */
+    baseUrl?: string;
+}
+/**
+ * ElevenLabs streaming text-to-speech provider.
+ *
+ * Uses the REST streaming endpoint to convert text to audio.
+ * Returns raw PCM audio chunks for streaming playback.
+ */
+export declare class ElevenLabsTTS implements TTSProvider {
+    readonly name = "elevenlabs-tts";
+    private options;
+    constructor(options: ElevenLabsTTSOptions);
+    synthesize(text: string): Promise<AsyncIterable<Buffer>>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=elevenlabs-tts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs-tts.d.ts","sourceRoot":"","sources":["../../src/tts/elevenlabs-tts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,WAAW;IAC/C,QAAQ,CAAC,IAAI,oBAAoB;IACjC,OAAO,CAAC,OAAO,CAAqF;gBAExF,OAAO,EAAE,oBAAoB;IASnC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAmDxD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/dist/tts/elevenlabs-tts.js

@@ -0,0 +1,67 @@
+/**
+ * ElevenLabs streaming text-to-speech provider.
+ *
+ * Uses the REST streaming endpoint to convert text to audio.
+ * Returns raw PCM audio chunks for streaming playback.
+ */
+export class ElevenLabsTTS {
+    name = 'elevenlabs-tts';
+    options;
+    constructor(options) {
+        this.options = {
+            apiKey: options.apiKey,
+            voiceId: options.voiceId ?? '21m00Tcm4TlvDq8ikWAM',
+            modelId: options.modelId ?? 'eleven_multilingual_v2',
+            baseUrl: options.baseUrl ?? 'https://api.elevenlabs.io',
+        };
+    }
+    async synthesize(text) {
+        const { apiKey, voiceId, modelId, baseUrl } = this.options;
+        // output_format is a query parameter, not a body field
+        const url = `${baseUrl}/v1/text-to-speech/${voiceId}/stream?output_format=pcm_22050`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'xi-api-key': apiKey,
+            },
+            body: JSON.stringify({
+                text,
+                model_id: modelId,
+                voice_settings: {
+                    stability: 0.5,
+                    similarity_boost: 0.75,
+                    style: 0.0,
+                    use_speaker_boost: true,
+                },
+            }),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`ElevenLabs TTS error (${response.status}): ${errorText}`);
+        }
+        if (!response.body) {
+            throw new Error('ElevenLabs TTS returned no body');
+        }
+        // Convert the ReadableStream to AsyncIterable<Buffer>
+        const reader = response.body.getReader();
+        async function* streamToAsyncIterable() {
+            try {
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    yield Buffer.from(value);
+                }
+            }
+            finally {
+                reader.releaseLock();
+            }
+        }
+        return streamToAsyncIterable();
+    }
+    async dispose() {
+        // Stateless — nothing to clean up
+    }
+}
+//# sourceMappingURL=elevenlabs-tts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs-tts.js","sourceRoot":"","sources":["../../src/tts/elevenlabs-tts.ts"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IACf,IAAI,GAAG,gBAAgB,CAAC;IACzB,OAAO,CAAqF;IAEpG,YAAY,OAA6B;QACvC,IAAI,CAAC,OAAO,GAAG;YACb,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,sBAAsB;YAClD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,wBAAwB;YACpD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,2BAA2B;SACxD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAE3D,uDAAuD;QACvD,MAAM,GAAG,GAAG,GAAG,OAAO,sBAAsB,OAAO,iCAAiC,CAAC;QAErF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,YAAY,EAAE,MAAM;aACrB;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,IAAI;gBACJ,QAAQ,EAAE,OAAO;gBACjB,cAAc,EAAE;oBACd,SAAS,EAAE,GAAG;oBACd,gBAAgB,EAAE,IAAI;oBACtB,KAAK,EAAE,GAAG;oBACV,iBAAiB,EAAE,IAAI;iBACxB;aACF,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,CAAC,MAAM,MAAM,SAAS,EAAE,CAAC,CAAC;QAC7E,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QAED,sDAAsD;QACtD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAEzC,KAAK,SAAS,CAAC,CAAC,qBAAqB;YACnC,IAAI,CAAC;gBACH,OAAO,IAAI,EAAE,CAAC;oBACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;oBAC5C,IAAI,IAAI;wBAAE,MAAM;oBAChB,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC3B,CAAC;YACH,CAAC;oBAAS,CAAC;gBACT,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,CAAC;QACH,CAAC;QAED,OAAO,qBAAqB,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,OAAO;QACX,kCAAkC;IACpC,CAAC;CACF"}

package/dist/tts/piper-tts.d.ts

@@ -0,0 +1,23 @@
+import type { TTSProvider } from './provider.js';
+export interface PiperTTSOptions {
+    /** Path to piper binary (default: 'piper') */
+    binaryPath?: string;
+    /** Path to voice model ONNX file */
+    model?: string;
+}
+/**
+ * Local Piper text-to-speech provider.
+ *
+ * Runs piper via child process to generate WAV audio.
+ * Returns the audio as a single-chunk AsyncIterable for playback.
+ */
+export declare class PiperTTS implements TTSProvider {
+    readonly name = "piper-tts";
+    private binaryPath;
+    private model;
+    constructor(options?: PiperTTSOptions);
+    synthesize(text: string): Promise<AsyncIterable<Buffer>>;
+    private runPiper;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=piper-tts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"piper-tts.d.ts","sourceRoot":"","sources":["../../src/tts/piper-tts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,qBAAa,QAAS,YAAW,WAAW;IAC1C,QAAQ,CAAC,IAAI,eAAe;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAqB;gBAEtB,OAAO,CAAC,EAAE,eAAe;IAK/B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAkB9D,OAAO,CAAC,QAAQ;IAuBV,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/dist/tts/piper-tts.js

@@ -0,0 +1,59 @@
+import { execFile } from 'child_process';
+import { readFileSync, unlinkSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+/**
+ * Local Piper text-to-speech provider.
+ *
+ * Runs piper via child process to generate WAV audio.
+ * Returns the audio as a single-chunk AsyncIterable for playback.
+ */
+export class PiperTTS {
+    name = 'piper-tts';
+    binaryPath;
+    model;
+    constructor(options) {
+        this.binaryPath = options?.binaryPath ?? 'piper';
+        this.model = options?.model;
+    }
+    async synthesize(text) {
+        const tempPath = join(tmpdir(), `tastekit-tts-${Date.now()}.wav`);
+        await this.runPiper(text, tempPath);
+        const audioData = readFileSync(tempPath);
+        try {
+            unlinkSync(tempPath);
+        }
+        catch { /* ignore */ }
+        // Strip the WAV header (44 bytes) to get raw PCM
+        const pcm = audioData.subarray(44);
+        async function* singleChunk() {
+            yield pcm;
+        }
+        return singleChunk();
+    }
+    runPiper(text, outputPath) {
+        return new Promise((resolve, reject) => {
+            const args = ['--output_file', outputPath];
+            if (this.model) {
+                args.push('--model', this.model);
+            }
+            const child = execFile(this.binaryPath, args, { timeout: 30000 }, (err) => {
+                if (err) {
+                    reject(new Error(`Piper failed: ${err.message}`));
+                }
+                else {
+                    resolve();
+                }
+            });
+            // Pipe text to piper's stdin
+            if (child.stdin) {
+                child.stdin.write(text);
+                child.stdin.end();
+            }
+        });
+    }
+    async dispose() {
+        // Stateless
+    }
+}
+//# sourceMappingURL=piper-tts.js.map

package/dist/tts/piper-tts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"piper-tts.js","sourceRoot":"","sources":["../../src/tts/piper-tts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAU5B;;;;;GAKG;AACH,MAAM,OAAO,QAAQ;IACV,IAAI,GAAG,WAAW,CAAC;IACpB,UAAU,CAAS;IACnB,KAAK,CAAqB;IAElC,YAAY,OAAyB;QACnC,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,OAAO,CAAC;QACjD,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,gBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAElE,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAEpC,MAAM,SAAS,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC;YAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAEpD,iDAAiD;QACjD,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAEnC,KAAK,SAAS,CAAC,CAAC,WAAW;YACzB,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,OAAO,WAAW,EAAE,CAAC;IACvB,CAAC;IAEO,QAAQ,CAAC,IAAY,EAAE,UAAkB;QAC/C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,IAAI,GAAG,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;YAC3C,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;YAED,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE;gBACxE,IAAI,GAAG,EAAE,CAAC;oBACR,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBACpD,CAAC;qBAAM,CAAC;oBACN,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,6BAA6B;YAC7B,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACxB,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YACpB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO;QACX,YAAY;IACd,CAAC;CACF"}

package/dist/tts/provider.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Text-to-Speech Provider Interface
+ *
+ * Converts text into an audio stream for playback.
+ * Implementations: ElevenLabs, Piper
+ */
+export interface TTSProvider {
+    readonly name: string;
+    /**
+     * Synthesize text into an audio stream.
+     * @returns AsyncIterable of PCM or MP3 audio chunks
+     */
+    synthesize(text: string): Promise<AsyncIterable<Buffer>>;
+    /** Clean up resources */
+    dispose?(): Promise<void>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/tts/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/tts/provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;IACzD,yBAAyB;IACzB,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}

package/dist/tts/provider.js

@@ -0,0 +1,8 @@
+/**
+ * Text-to-Speech Provider Interface
+ *
+ * Converts text into an audio stream for playback.
+ * Implementations: ElevenLabs, Piper
+ */
+export {};
+//# sourceMappingURL=provider.js.map

package/dist/tts/provider.js.map

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

package/dist/voice-io.d.ts

@@ -0,0 +1,48 @@
+import type { STTProvider } from './stt/provider.js';
+import type { TTSProvider } from './tts/provider.js';
+import { MicRecorder } from './audio/recorder.js';
+import { AudioPlayer } from './audio/player.js';
+export interface VoiceIOOptions {
+    /** Show live transcription while user speaks */
+    showTranscription?: boolean;
+    /** Called with partial transcription updates */
+    onPartial?: (text: string) => void;
+    /** Called when the user's final transcription is ready */
+    onFinalTranscript?: (text: string) => void;
+    /** Print interviewer text to console alongside audio */
+    printText?: boolean;
+}
+/**
+ * Voice I/O orchestrator for TasteKit onboarding.
+ *
+ * Composes STT + TTS + mic recorder + audio player into the two
+ * callbacks the Interviewer expects: getUserInput() and onInterviewerMessage().
+ *
+ * Drop-in replacement for the text-based inquirer callbacks.
+ */
+export declare class VoiceIO {
+    private stt;
+    private tts;
+    private recorder;
+    private player;
+    private options;
+    constructor(stt: STTProvider, tts: TTSProvider, recorder?: MicRecorder, player?: AudioPlayer, options?: VoiceIOOptions);
+    /**
+     * Drop-in replacement for Interviewer's getUserInput callback.
+     * Records from mic → runs STT → returns transcribed text.
+     */
+    getUserInput(): Promise<string>;
+    /**
+     * Drop-in replacement for Interviewer's onInterviewerMessage callback.
+     * Prints text AND plays it as audio via TTS.
+     */
+    onInterviewerMessage(message: string): Promise<void>;
+    /** Clean up all resources. */
+    dispose(): Promise<void>;
+    /**
+     * Wrap an async iterable so it stops yielding when a condition is met.
+     * This lets us stop the mic recording when STT returns a final transcript.
+     */
+    private createControlledStream;
+}
+//# sourceMappingURL=voice-io.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voice-io.d.ts","sourceRoot":"","sources":["../src/voice-io.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAmB,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gDAAgD;IAChD,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAA2B;gBAGxC,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,WAAW,EAChB,QAAQ,CAAC,EAAE,WAAW,EACtB,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,cAAc;IAc1B;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IA8CrC;;;OAGG;IACG,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB1D,8BAA8B;IACxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B;;;OAGG;YACY,sBAAsB;CAStC"}