@actrun_ai/tastekit-voice 0.1.0

package/dist/voice-io.js

@@ -0,0 +1,110 @@
+import { MicRecorder } from './audio/recorder.js';
+import { AudioPlayer } from './audio/player.js';
+/**
+ * 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 class VoiceIO {
+    stt;
+    tts;
+    recorder;
+    player;
+    options;
+    constructor(stt, tts, recorder, player, options) {
+        this.stt = stt;
+        this.tts = tts;
+        this.recorder = recorder ?? new MicRecorder();
+        this.player = player ?? new AudioPlayer();
+        this.options = {
+            showTranscription: options?.showTranscription ?? true,
+            onPartial: options?.onPartial ?? (() => { }),
+            onFinalTranscript: options?.onFinalTranscript ?? (() => { }),
+            printText: options?.printText ?? true,
+        };
+    }
+    /**
+     * Drop-in replacement for Interviewer's getUserInput callback.
+     * Records from mic → runs STT → returns transcribed text.
+     */
+    async getUserInput() {
+        if (this.options.showTranscription) {
+            process.stdout.write('\n  🎤 Listening... (speak now)\n');
+        }
+        // Start recording
+        const audioStream = this.recorder.start();
+        // Create a controlled audio iterator that we can stop
+        let stopRecording = false;
+        const controlledAudio = this.createControlledStream(audioStream, () => stopRecording);
+        let finalText = '';
+        // Run STT on the audio stream
+        for await (const event of this.stt.transcribe(controlledAudio)) {
+            if (event.type === 'partial') {
+                if (this.options.showTranscription) {
+                    // Overwrite the current line with partial transcript
+                    process.stdout.write(`\r  📝 ${event.text}${''.padEnd(20)}`);
+                }
+                this.options.onPartial(event.text);
+            }
+            else if (event.type === 'final') {
+                finalText = event.text;
+                stopRecording = true;
+                this.recorder.stop();
+                if (this.options.showTranscription) {
+                    // Clear the partial and show final
+                    process.stdout.write(`\r  ✅ ${finalText}${''.padEnd(20)}\n`);
+                }
+                this.options.onFinalTranscript(finalText);
+                break;
+            }
+        }
+        // Ensure recorder is stopped
+        this.recorder.stop();
+        if (!finalText) {
+            throw new Error('No speech detected');
+        }
+        return finalText;
+    }
+    /**
+     * Drop-in replacement for Interviewer's onInterviewerMessage callback.
+     * Prints text AND plays it as audio via TTS.
+     */
+    async onInterviewerMessage(message) {
+        // Always print to console so user can read along
+        if (this.options.printText) {
+            process.stdout.write(`\n  🔊 ${message}\n`);
+        }
+        // Synthesize and play audio
+        try {
+            const audioChunks = await this.tts.synthesize(message);
+            await this.player.playStream(audioChunks, { sampleRate: 22050 });
+        }
+        catch (err) {
+            // TTS failure is non-fatal — text was already printed
+            const msg = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`  ⚠ TTS playback failed: ${msg}\n`);
+        }
+    }
+    /** Clean up all resources. */
+    async dispose() {
+        this.recorder.stop();
+        this.player.stop();
+        await this.stt.dispose?.();
+        await this.tts.dispose?.();
+    }
+    /**
+     * 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.
+     */
+    async *createControlledStream(source, shouldStop) {
+        for await (const chunk of source) {
+            if (shouldStop())
+                break;
+            yield chunk;
+        }
+    }
+}
+//# sourceMappingURL=voice-io.js.map

package/dist/voice-io.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@actrun_ai/tastekit-voice",
+  "version": "0.1.0",
+  "description": "Voice I/O layer for TasteKit onboarding — ElevenLabs, Whisper, Piper",
+  "type": "module",
+  "license": "MIT",
+  "author": "TasteKit Contributors",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tastekit/tastekit.git",
+    "directory": "packages/voice"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "lint": "eslint --ignore-pattern dist/ --ignore-pattern __tests__/ .",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "zod": "^3.23.0",
+    "ws": "^8.16.0"
+  },
+  "optionalDependencies": {
+    "node-record-lpcm16": "^1.0.1",
+    "speaker": "^0.5.5",
+    "play-sound": "^1.1.6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.0.0"
+  }
+}