modular-voice-agent-sdk 1.0.0

package/dist/cli.js

@@ -0,0 +1,392 @@
+#!/usr/bin/env node
+/**
+ * Modular Voice Agent SDK CLI
+ *
+ * Usage:
+ *   npx mvas setup <config.json>   - Download models from config file
+ *   npx mvas setup --binaries-only - Set up native binaries only
+ *   npx mvas help                  - Show help
+ */
+import { spawn, execSync, spawnSync } from 'child_process';
+import { existsSync, readFileSync, mkdirSync, unlinkSync, readdirSync, statSync, createReadStream } from 'fs';
+import { createHash } from 'crypto';
+import { fileURLToPath } from 'url';
+import { dirname, join, basename } from 'path';
+import { homedir } from 'os';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// ============ Cache Paths ============
+function getCacheDir() {
+    return process.env.MVAS_CACHE || join(homedir(), '.cache', 'mvas');
+}
+function getModelsDir() {
+    return join(getCacheDir(), 'models');
+}
+// ============ Hash Verification ============
+async function computeSha256(filePath) {
+    return new Promise((resolve, reject) => {
+        const hash = createHash('sha256');
+        const stream = createReadStream(filePath);
+        stream.on('data', (data) => hash.update(data));
+        stream.on('end', () => resolve(hash.digest('hex')));
+        stream.on('error', reject);
+    });
+}
+async function verifyFile(filePath, config) {
+    if (!existsSync(filePath)) {
+        return { valid: false, reason: 'file does not exist' };
+    }
+    const stats = statSync(filePath);
+    // Check size if provided
+    if (config.size !== undefined) {
+        if (stats.size !== config.size) {
+            return {
+                valid: false,
+                reason: `size mismatch (got ${formatBytes(stats.size)}, expected ${formatBytes(config.size)})`
+            };
+        }
+    }
+    else {
+        // No size specified - check if file is suspiciously small (< 1MB for models)
+        if (stats.size < 1024 * 1024) {
+            return { valid: false, reason: `file too small (${formatBytes(stats.size)})` };
+        }
+    }
+    // Check hash if provided
+    if (config.sha256) {
+        console.log('    Verifying checksum...');
+        const actualHash = await computeSha256(filePath);
+        if (actualHash !== config.sha256.toLowerCase()) {
+            return {
+                valid: false,
+                reason: `checksum mismatch`
+            };
+        }
+    }
+    return { valid: true };
+}
+// ============ Download Helpers ============
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+    return `${(bytes / (1024 * 1024 * 1024)).toFixed(2)} GB`;
+}
+/**
+ * Download a file using curl with resume support.
+ * curl -C - automatically resumes partial downloads.
+ */
+function downloadWithCurl(url, destPath) {
+    return new Promise((resolve, reject) => {
+        // Check if partial file exists
+        const isResume = existsSync(destPath);
+        if (isResume) {
+            const stats = statSync(destPath);
+            console.log(`    Resuming from ${formatBytes(stats.size)}...`);
+        }
+        // curl with:
+        // -L: follow redirects
+        // -C -: auto-resume from where it left off
+        // --progress-bar: show progress
+        // -o: output file
+        const child = spawn('curl', [
+            '-L',
+            '-C', '-',
+            '--progress-bar',
+            '-o', destPath,
+            url
+        ], {
+            stdio: ['inherit', 'inherit', 'inherit'],
+        });
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+            }
+            else if (code === 33) {
+                // curl exit 33 = range request not supported, but file may be complete
+                // Check if this is because file is already complete
+                resolve();
+            }
+            else {
+                reject(new Error(`curl exited with code ${code}`));
+            }
+        });
+        child.on('error', (err) => {
+            reject(new Error(`Failed to run curl: ${err.message}. Make sure curl is installed.`));
+        });
+    });
+}
+function extractArchive(archivePath, destDir) {
+    const ext = archivePath.toLowerCase();
+    if (ext.endsWith('.tar.bz2') || ext.endsWith('.tbz2')) {
+        execSync(`tar -xjf "${archivePath}" -C "${destDir}"`, { stdio: 'inherit' });
+    }
+    else if (ext.endsWith('.tar.gz') || ext.endsWith('.tgz')) {
+        execSync(`tar -xzf "${archivePath}" -C "${destDir}"`, { stdio: 'inherit' });
+    }
+    else if (ext.endsWith('.zip')) {
+        execSync(`unzip -o "${archivePath}" -d "${destDir}"`, { stdio: 'inherit' });
+    }
+    else {
+        throw new Error(`Unknown archive format: ${archivePath}`);
+    }
+}
+// ============ Model Download ============
+async function downloadModel(type, config, modelsDir) {
+    console.log(`\n==> ${type.toUpperCase()} model`);
+    const url = config.url;
+    const urlFilename = basename(new URL(url).pathname);
+    if (config.extract) {
+        // Archive - download, extract, cleanup
+        const archivePath = join(modelsDir, urlFilename);
+        const targetDir = config.directory || urlFilename.replace(/\.(tar\.bz2|tar\.gz|tbz2|tgz|zip)$/, '');
+        const finalPath = join(modelsDir, targetDir);
+        if (existsSync(finalPath)) {
+            console.log(`    ✓ Already exists: ${targetDir}`);
+            return;
+        }
+        console.log(`    Downloading: ${url}`);
+        console.log(`    Extracting to: ${targetDir}`);
+        await downloadWithCurl(url, archivePath);
+        // Verify archive if hash provided
+        if (config.sha256 || config.size) {
+            const result = await verifyFile(archivePath, config);
+            if (!result.valid) {
+                console.log(`    ⚠️  Verification failed: ${result.reason}`);
+                console.log(`    Deleting partial file and retrying...`);
+                unlinkSync(archivePath);
+                await downloadWithCurl(url, archivePath);
+            }
+        }
+        extractArchive(archivePath, modelsDir);
+        // Cleanup archive
+        try {
+            unlinkSync(archivePath);
+        }
+        catch { /* ignore */ }
+        console.log(`    ✓ Done!`);
+    }
+    else {
+        // Single file
+        const filename = config.filename || urlFilename;
+        const destPath = join(modelsDir, filename);
+        // Check if file exists and is valid
+        if (existsSync(destPath)) {
+            const result = await verifyFile(destPath, config);
+            if (result.valid) {
+                console.log(`    ✓ Already exists: ${filename}`);
+                return;
+            }
+            console.log(`    Existing file invalid: ${result.reason}`);
+            console.log(`    Re-downloading...`);
+        }
+        console.log(`    URL: ${url}`);
+        console.log(`    Saving as: ${filename}`);
+        if (config.size) {
+            console.log(`    Expected size: ${formatBytes(config.size)}`);
+        }
+        await downloadWithCurl(url, destPath);
+        // Verify after download
+        if (config.sha256 || config.size) {
+            const result = await verifyFile(destPath, config);
+            if (!result.valid) {
+                console.log(`    ⚠️  Verification failed: ${result.reason}`);
+                console.log(`    You may need to delete the file and re-run setup.`);
+                return;
+            }
+            if (config.sha256) {
+                console.log(`    ✓ Checksum verified`);
+            }
+        }
+        console.log(`    ✓ Done!`);
+    }
+}
+async function setupFromConfig(configPath) {
+    if (!existsSync(configPath)) {
+        console.error(`Error: Config file not found: ${configPath}`);
+        process.exit(1);
+    }
+    let config;
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        config = JSON.parse(content);
+    }
+    catch (err) {
+        console.error(`Error: Invalid JSON in config file: ${configPath}`);
+        console.error(err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+    if (!config.models || typeof config.models !== 'object') {
+        console.error('Error: Config must have a "models" object');
+        process.exit(1);
+    }
+    // Check curl is available
+    const curlCheck = spawnSync('curl', ['--version']);
+    if (curlCheck.error) {
+        console.error('Error: curl is required but not found. Please install curl.');
+        process.exit(1);
+    }
+    const modelsDir = getModelsDir();
+    mkdirSync(modelsDir, { recursive: true });
+    console.log('Modular Voice Agent SDK Setup');
+    console.log('====================');
+    console.log(`Config: ${configPath}`);
+    console.log(`Models directory: ${modelsDir}`);
+    const modelTypes = ['stt', 'llm', 'tts'];
+    for (const type of modelTypes) {
+        const modelConfig = config.models[type];
+        if (modelConfig) {
+            await downloadModel(type, modelConfig, modelsDir);
+        }
+    }
+    console.log('\n============================================================');
+    console.log('Setup complete!');
+    console.log('============================================================');
+    console.log(`\nModels location: ${modelsDir}`);
+    // List what's there with sizes
+    const files = readdirSync(modelsDir);
+    if (files.length > 0) {
+        console.log('\nDownloaded models:');
+        for (const file of files) {
+            const filePath = join(modelsDir, file);
+            const stats = statSync(filePath);
+            const size = stats.isDirectory() ? '(dir)' : formatBytes(stats.size);
+            console.log(`  - ${file} ${size}`);
+        }
+    }
+    console.log('\n💡 To set up native binaries (whisper-cli, llama-completion, sherpa-onnx):');
+    console.log('   npx mvas setup --binaries-only');
+}
+// ============ Binaries Setup ============
+async function setupBinaries() {
+    // Find and run the setup script for binaries only
+    const scriptPath = join(__dirname, '..', 'scripts', 'setup-binaries.sh');
+    // Check if the binaries-only script exists, otherwise use original script with a message
+    const originalScript = join(__dirname, '..', 'scripts', 'setup.sh');
+    const targetScript = existsSync(scriptPath) ? scriptPath : originalScript;
+    if (!existsSync(targetScript)) {
+        console.error('Error: Setup script not found');
+        process.exit(1);
+    }
+    console.log('Setting up native binaries...');
+    console.log('This will configure: whisper-cli, llama-completion, sherpa-onnx');
+    console.log('');
+    const child = spawn('bash', [targetScript, '--binaries-only'], {
+        stdio: 'inherit',
+    });
+    child.on('error', (err) => {
+        if (err.message.includes('ENOENT')) {
+            console.error('Error: bash not found. Please run the setup script manually:');
+            console.error(`  bash ${targetScript}`);
+        }
+        else {
+            console.error('Error running setup:', err.message);
+        }
+        process.exit(1);
+    });
+    return new Promise((resolve) => {
+        child.on('close', (code) => {
+            if (code !== 0) {
+                process.exit(code ?? 1);
+            }
+            resolve();
+        });
+    });
+}
+// ============ Help ============
+function printHelp() {
+    console.log(`
+mvas - Modular Voice Agent SDK CLI
+
+Commands:
+  setup <config.json>     Download models specified in config file
+  setup --binaries-only   Set up native binaries (whisper-cli, llama-completion, sherpa-onnx)
+  help                    Show this help message
+
+Config file format (JSON):
+  {
+    "models": {
+      "stt": {
+        "url": "https://huggingface.co/.../model.bin",
+        "filename": "whisper-model.bin",
+        "size": 874123456,
+        "sha256": "abc123..."
+      },
+      "llm": {
+        "url": "https://huggingface.co/.../model.gguf",
+        "filename": "llm-model.gguf"
+      },
+      "tts": {
+        "url": "https://github.com/.../model.tar.bz2",
+        "extract": true,
+        "directory": "tts-model"
+      }
+    }
+  }
+
+Options for each model:
+  url         - Download URL (required)
+  filename    - Local filename (defaults to URL filename)
+  size        - Expected file size in bytes (for verification)
+  sha256      - Expected SHA256 hash (for verification)
+  extract     - Set to true for archives (.tar.bz2, .tar.gz, .zip)
+  directory   - Directory name after extraction
+
+Features:
+  • Automatic resume of interrupted downloads
+  • File integrity verification (size + optional SHA256)
+  • Skips already-downloaded valid files
+
+Examples:
+  npx mvas setup ./models.json           # Download models from config
+  npx mvas setup --binaries-only         # Just set up native binaries
+
+Cache location: ${getCacheDir()}
+  Override with: export MVAS_CACHE=/path/to/cache
+
+For more info: https://github.com/bigfive/modular-voice-agent-sdk
+`);
+}
+// ============ Main ============
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    switch (command) {
+        case 'setup': {
+            const arg = args[1];
+            if (!arg) {
+                console.error('Error: setup requires a config file or --binaries-only flag');
+                console.error('');
+                console.error('Usage:');
+                console.error('  npx mvas setup <config.json>');
+                console.error('  npx mvas setup --binaries-only');
+                process.exit(1);
+            }
+            if (arg === '--binaries-only' || arg === '--binaries') {
+                await setupBinaries();
+            }
+            else {
+                await setupFromConfig(arg);
+            }
+            break;
+        }
+        case 'help':
+        case '--help':
+        case '-h':
+        case undefined:
+            printHelp();
+            break;
+        default:
+            console.error(`Unknown command: ${command}`);
+            printHelp();
+            process.exit(1);
+    }
+}
+main().catch((err) => {
+    console.error('Error:', err.message || err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/client/audio-player.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Audio Player
+ *
+ * Manages a queue of audio chunks and plays them in order.
+ */
+export interface AudioPlayerConfig {
+    /** Callback when playback starts */
+    onStart?: () => void;
+    /** Callback when all queued audio finishes */
+    onEnd?: () => void;
+}
+export declare class AudioPlayer {
+    private audioContext;
+    private queue;
+    private isPlaying;
+    private onStartCallback?;
+    private onEndCallback?;
+    constructor(config?: AudioPlayerConfig);
+    /**
+     * Check if currently playing
+     */
+    get playing(): boolean;
+    /**
+     * Number of items in the queue
+     */
+    get queueLength(): number;
+    /**
+     * Enqueue audio for playback
+     */
+    enqueue(audio: Float32Array, sampleRate: number): void;
+    /**
+     * Clear the queue and stop playback
+     */
+    clear(): void;
+    /**
+     * Stop playback and clear queue
+     */
+    stop(): void;
+    private playNext;
+    /**
+     * Clean up resources
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=audio-player.d.ts.map

package/dist/client/audio-player.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-player.d.ts","sourceRoot":"","sources":["../../src/client/audio-player.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB;AAOD,qBAAa,WAAW;IACtB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAAC,CAAa;IACrC,OAAO,CAAC,aAAa,CAAC,CAAa;gBAEvB,MAAM,GAAE,iBAAsB;IAK1C;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAKtD;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,IAAI,IAAI;YASE,QAAQ;IAkCtB;;OAEG;IACH,OAAO,IAAI,IAAI;CAKhB"}

package/dist/client/audio-player.js

@@ -0,0 +1,90 @@
+/**
+ * Audio Player
+ *
+ * Manages a queue of audio chunks and plays them in order.
+ */
+export class AudioPlayer {
+    audioContext = null;
+    queue = [];
+    isPlaying = false;
+    onStartCallback;
+    onEndCallback;
+    constructor(config = {}) {
+        this.onStartCallback = config.onStart;
+        this.onEndCallback = config.onEnd;
+    }
+    /**
+     * Check if currently playing
+     */
+    get playing() {
+        return this.isPlaying;
+    }
+    /**
+     * Number of items in the queue
+     */
+    get queueLength() {
+        return this.queue.length;
+    }
+    /**
+     * Enqueue audio for playback
+     */
+    enqueue(audio, sampleRate) {
+        this.queue.push({ audio, sampleRate });
+        this.playNext();
+    }
+    /**
+     * Clear the queue and stop playback
+     */
+    clear() {
+        this.queue = [];
+        // Note: current playback will finish, but nothing else will play
+    }
+    /**
+     * Stop playback and clear queue
+     */
+    stop() {
+        this.clear();
+        if (this.audioContext) {
+            this.audioContext.close();
+            this.audioContext = null;
+        }
+        this.isPlaying = false;
+    }
+    async playNext() {
+        if (this.isPlaying || this.queue.length === 0)
+            return;
+        this.isPlaying = true;
+        this.onStartCallback?.();
+        const { audio, sampleRate } = this.queue.shift();
+        // Create or reuse audio context
+        if (!this.audioContext || this.audioContext.state === 'closed') {
+            this.audioContext = new AudioContext();
+        }
+        // Create buffer and source
+        const buffer = this.audioContext.createBuffer(1, audio.length, sampleRate);
+        buffer.getChannelData(0).set(audio);
+        const source = this.audioContext.createBufferSource();
+        source.buffer = buffer;
+        source.connect(this.audioContext.destination);
+        // Handle completion
+        source.onended = () => {
+            this.isPlaying = false;
+            if (this.queue.length > 0) {
+                this.playNext();
+            }
+            else {
+                this.onEndCallback?.();
+            }
+        };
+        source.start();
+    }
+    /**
+     * Clean up resources
+     */
+    dispose() {
+        this.stop();
+        this.onStartCallback = undefined;
+        this.onEndCallback = undefined;
+    }
+}
+//# sourceMappingURL=audio-player.js.map

package/dist/client/audio-player.js.map

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

package/dist/client/audio-recorder.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Audio Recorder
+ *
+ * Handles microphone capture with AudioWorklet for real-time PCM streaming.
+ */
+export interface AudioRecorderConfig {
+    /** Sample rate for recording (default: 16000) */
+    sampleRate?: number;
+}
+export type AudioChunkCallback = (chunk: Float32Array) => void;
+export declare class AudioRecorder {
+    private sampleRate;
+    private audioContext;
+    private mediaStream;
+    private mediaStreamSource;
+    private workletNode;
+    private workletRegistered;
+    private isRecording;
+    private onChunkCallback;
+    constructor(config?: AudioRecorderConfig);
+    /**
+     * Check if currently recording
+     */
+    get recording(): boolean;
+    /**
+     * Set callback for audio chunks (called during streaming recording)
+     */
+    onChunk(callback: AudioChunkCallback): void;
+    /**
+     * Start recording from microphone
+     */
+    start(): Promise<void>;
+    /**
+     * Stop recording and clean up resources
+     */
+    stop(): Promise<void>;
+    /**
+     * Clean up all resources
+     */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=audio-recorder.d.ts.map

package/dist/client/audio-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-recorder.d.ts","sourceRoot":"","sources":["../../src/client/audio-recorder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;AAoB/D,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,iBAAiB,CAA2C;IACpE,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAAmC;gBAE9C,MAAM,GAAE,mBAAwB;IAI5C;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAI3C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgD5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B3B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAI/B"}