modular-voice-agent-sdk 2.6.1 → 2.7.0

package/dist/backends/native/index.d.ts

@@ -1,7 +1,9 @@
 export { NativeSTT } from './stt';
 export { NativeLLM } from './llm';
-export { NativeTTS } from './tts';
+export { NativeTTS, synthesizeToWav } from './tts';
+export type { SynthesizeToWavOptions } from './tts';
 export type { TTSModelProvider } from './tts-providers';
 export { PiperTTSProvider, KokoroTTSProvider } from './tts-providers';
-export { getCacheDir, getModelsDir, getBinDir, getModelPath, getBinaryPath, defaultBinaries, } from '../../cache';
+export { getCacheDir, getModelsDir, getBinDir, getModelPath, getBinaryPath, defaultBinaries, getCacheStatus, checkModelsInstalled, } from '../../cache';
+export type { ModelConfig, SetupConfig, ModelStatus } from '../../cache';
 //# sourceMappingURL=index.d.ts.map

package/dist/backends/native/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/backends/native/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGtE,OAAO,EACL,WAAW,EACX,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,aAAa,EACb,eAAe,GAChB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/backends/native/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AACnD,YAAY,EAAE,sBAAsB,EAAE,MAAM,OAAO,CAAC;AACpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGtE,OAAO,EACL,WAAW,EACX,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,aAAa,EACb,eAAe,EACf,cAAc,EACd,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/backends/native/index.js

@@ -1,7 +1,7 @@
 export { NativeSTT } from './stt';
 export { NativeLLM } from './llm';
-export { NativeTTS } from './tts';
+export { NativeTTS, synthesizeToWav } from './tts';
 export { PiperTTSProvider, KokoroTTSProvider } from './tts-providers';
 // Cache utilities (Node.js only)
-export { getCacheDir, getModelsDir, getBinDir, getModelPath, getBinaryPath, defaultBinaries, } from '../../cache';
+export { getCacheDir, getModelsDir, getBinDir, getModelPath, getBinaryPath, defaultBinaries, getCacheStatus, checkModelsInstalled, } from '../../cache';
 //# sourceMappingURL=index.js.map

package/dist/backends/native/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/backends/native/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEtE,iCAAiC;AACjC,OAAO,EACL,WAAW,EACX,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,aAAa,EACb,eAAe,GAChB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/backends/native/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAGnD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEtE,iCAAiC;AACjC,OAAO,EACL,WAAW,EACX,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,aAAa,EACb,eAAe,EACf,cAAc,EACd,oBAAoB,GACrB,MAAM,aAAa,CAAC"}

package/dist/backends/native/tts.d.ts

@@ -17,4 +17,25 @@ export declare class NativeTTS implements TTSPipeline {
     private parseWav;
     isReady(): boolean;
 }
+export interface SynthesizeToWavOptions {
+    modelDir: string;
+    speakerId?: number;
+    provider?: TTSModelProvider;
+    /** Defaults to getBinaryPath('sherpa-onnx-offline-tts') */
+    binaryPath?: string;
+    speedScale?: number;
+    numThreads?: number;
+}
+/**
+ * One-shot TTS: synthesize text directly to a WAV Buffer.
+ * Handles NativeTTS setup, synthesis, and WAV encoding in a single call.
+ *
+ * @example
+ * ```typescript
+ * import { synthesizeToWav } from 'modular-voice-agent-sdk/native';
+ * const wav = await synthesizeToWav('Hello!', { modelDir: '/path/to/model', speakerId: 3 });
+ * fs.writeFileSync('hello.wav', wav);
+ * ```
+ */
+export declare function synthesizeToWav(text: string, options: SynthesizeToWavOptions): Promise<Buffer>;
 //# sourceMappingURL=tts.d.ts.map

package/dist/backends/native/tts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tts.d.ts","sourceRoot":"","sources":["../../../src/backends/native/tts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,gBAAgB,EAAe,aAAa,EAAE,MAAM,aAAa,CAAC;AAElH,OAAO,EAAE,gBAAgB,EAAoB,MAAM,iBAAiB,CAAC;AAErE,qBAAa,SAAU,YAAW,WAAW;IAC3C,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,KAAK,CAAS;gBAEV,MAAM,EAAE,mBAAmB,EAAE,QAAQ,CAAC,EAAE,gBAAgB;IAS9D,UAAU,CAAC,WAAW,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAazD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAqCtD,OAAO,CAAC,QAAQ;IAsBhB,OAAO,IAAI,OAAO;CAGnB"}
+{"version":3,"file":"tts.d.ts","sourceRoot":"","sources":["../../../src/backends/native/tts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,gBAAgB,EAAe,aAAa,EAAE,MAAM,aAAa,CAAC;AAElH,OAAO,EAAE,gBAAgB,EAAoB,MAAM,iBAAiB,CAAC;AAIrE,qBAAa,SAAU,YAAW,WAAW;IAC3C,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,KAAK,CAAS;gBAEV,MAAM,EAAE,mBAAmB,EAAE,QAAQ,CAAC,EAAE,gBAAgB;IAS9D,UAAU,CAAC,WAAW,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAazD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAqCtD,OAAO,CAAC,QAAQ;IAsBhB,OAAO,IAAI,OAAO;CAGnB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAuBjB"}

package/dist/backends/native/tts.js

@@ -11,6 +11,8 @@ import { join } from 'path';
 import { tmpdir } from 'os';
 import { BufferedAudioPlayable } from '../../types';
 import { PiperTTSProvider } from './tts-providers';
+import { getBinaryPath } from '../../cache';
+import { encodeWav } from '../../server/encoding';
 export class NativeTTS {
     config;
     provider;
@@ -84,4 +86,32 @@ export class NativeTTS {
         return this.ready;
     }
 }
+/**
+ * One-shot TTS: synthesize text directly to a WAV Buffer.
+ * Handles NativeTTS setup, synthesis, and WAV encoding in a single call.
+ *
+ * @example
+ * ```typescript
+ * import { synthesizeToWav } from 'modular-voice-agent-sdk/native';
+ * const wav = await synthesizeToWav('Hello!', { modelDir: '/path/to/model', speakerId: 3 });
+ * fs.writeFileSync('hello.wav', wav);
+ * ```
+ */
+export async function synthesizeToWav(text, options) {
+    const binaryPath = options.binaryPath ?? getBinaryPath('sherpa-onnx-offline-tts');
+    const tts = new NativeTTS({
+        binaryPath,
+        modelDir: options.modelDir,
+        speakerId: options.speakerId,
+        speedScale: options.speedScale,
+        numThreads: options.numThreads,
+    }, options.provider);
+    await tts.initialize();
+    const playable = await tts.synthesize(text);
+    const raw = playable.getRawAudio();
+    if (!raw) {
+        throw new Error('TTS synthesis produced no audio');
+    }
+    return encodeWav(raw.audio, raw.sampleRate);
+}
 //# sourceMappingURL=tts.js.map

package/dist/backends/native/tts.js.map

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

package/dist/cache.d.ts

@@ -5,6 +5,8 @@
  * NOTE: This module uses Node.js APIs (os, path) and is SERVER-ONLY.
  * For browser model caching, use the ModelStore passed to backend constructors.
  */
+import type { SetupConfig, ModelStatus } from './setup-types';
+export type { ModelConfig, SetupConfig, ModelStatus } from './setup-types';
 /**
  * Get the cache directory for mvas assets.
  * Default: ~/.cache/mvas
@@ -37,4 +39,18 @@ export declare const defaultBinaries: {
     llamaCompletion: string;
     sherpaOnnxTts: string;
 };
+/**
+ * Check the installation status of all models defined in a setup config.
+ * Returns per-model status indicating whether each is installed and its expected path.
+ *
+ * @param configOrPath - A SetupConfig object, or a path to a JSON config file
+ */
+export declare function getCacheStatus(configOrPath: string | SetupConfig): ModelStatus[];
+/**
+ * Check whether all models in a setup config are installed.
+ *
+ * @param configOrPath - A SetupConfig object, or a path to a JSON config file
+ * @returns true if every model is present on disk
+ */
+export declare function checkModelsInstalled(configOrPath: string | SetupConfig): boolean;
 //# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;CAI3B,CAAC"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAe,WAAW,EAAE,MAAM,eAAe,CAAC;AAE3E,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE3E;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;CAI3B,CAAC;AAaF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,EAAE,CAuBhF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAEhF"}

package/dist/cache.js

@@ -5,8 +5,9 @@
  * NOTE: This module uses Node.js APIs (os, path) and is SERVER-ONLY.
  * For browser model caching, use the ModelStore passed to backend constructors.
  */
+import { existsSync, readFileSync } from 'fs';
 import { homedir } from 'os';
-import { join } from 'path';
+import { basename, join } from 'path';
 /**
  * Get the cache directory for mvas assets.
  * Default: ~/.cache/mvas
@@ -49,4 +50,49 @@ export const defaultBinaries = {
     llamaCompletion: 'llama-completion',
     sherpaOnnxTts: 'sherpa-onnx-offline-tts',
 };
+function resolveModelPath(config) {
+    const urlFilename = basename(new URL(config.url).pathname);
+    if (config.extract) {
+        const targetDir = config.directory || urlFilename.replace(/\.(tar\.bz2|tar\.gz|tbz2|tgz|zip)$/, '');
+        return join(getModelsDir(), targetDir);
+    }
+    return join(getModelsDir(), config.filename || urlFilename);
+}
+/**
+ * Check the installation status of all models defined in a setup config.
+ * Returns per-model status indicating whether each is installed and its expected path.
+ *
+ * @param configOrPath - A SetupConfig object, or a path to a JSON config file
+ */
+export function getCacheStatus(configOrPath) {
+    let config;
+    if (typeof configOrPath === 'string') {
+        const content = readFileSync(configOrPath, 'utf-8');
+        config = JSON.parse(content);
+    }
+    else {
+        config = configOrPath;
+    }
+    if (!config.models || typeof config.models !== 'object') {
+        throw new Error('Config must have a "models" object');
+    }
+    return Object.entries(config.models).map(([name, modelConfig]) => {
+        const expectedPath = resolveModelPath(modelConfig);
+        return {
+            name,
+            installed: existsSync(expectedPath),
+            path: expectedPath,
+            expectedFilename: modelConfig.filename || basename(new URL(modelConfig.url).pathname),
+        };
+    });
+}
+/**
+ * Check whether all models in a setup config are installed.
+ *
+ * @param configOrPath - A SetupConfig object, or a path to a JSON config file
+ * @returns true if every model is present on disk
+ */
+export function checkModelsInstalled(configOrPath) {
+    return getCacheStatus(configOrPath).every((m) => m.installed);
+}
 //# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,IAAI,CAAC,YAAY,EAAE,EAAE,QAAQ,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,UAAU,EAAE,aAAa;IACzB,eAAe,EAAE,kBAAkB;IACnC,aAAa,EAAE,yBAAyB;CACzC,CAAC"}
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -2,6 +2,8 @@
 /**
  * Modular Voice Agent SDK CLI
  *
+ * Thin wrapper around the programmatic setup API.
+ *
  * Usage:
  *   npx mvas setup <config.json>   - Download models from config file
  *   npx mvas setup --binaries-only - Set up native binaries only

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG"}

package/dist/cli.js

@@ -2,70 +2,60 @@
 /**
  * Modular Voice Agent SDK CLI
  *
+ * Thin wrapper around the programmatic setup API.
+ *
  * 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`
-            };
-        }
+import { readdirSync, statSync } from 'fs';
+import { join } from 'path';
+import { getCacheDir, getModelsDir } from './cache';
+import { setup, setupBinaries } from './setup';
+// ============ CLI Progress Reporter ============
+function cliProgressReporter(event) {
+    switch (event.type) {
+        case 'start':
+            console.log('Modular Voice Agent SDK Setup');
+            console.log('====================');
+            console.log(`Models directory: ${event.modelsDir}`);
+            break;
+        case 'model_start':
+            console.log(`\n==> ${event.model?.toUpperCase()} model`);
+            break;
+        case 'model_skip':
+            console.log(`    ✓ ${event.message}`);
+            break;
+        case 'model_downloading':
+            console.log(`    ${event.message}`);
+            break;
+        case 'model_resuming':
+            console.log(`    ${event.message}`);
+            break;
+        case 'model_extracting':
+            console.log(`    ${event.message}`);
+            break;
+        case 'model_verifying':
+            console.log(`    ${event.message}`);
+            break;
+        case 'model_verification_failed':
+            console.log(`    ⚠️  ${event.message}`);
+            break;
+        case 'model_done':
+            console.log(`    ✓ Done!`);
+            break;
+        case 'model_failed':
+            console.error(`    ❌ ${event.message}`);
+            break;
+        case 'complete':
+            console.log('\n============================================================');
+            console.log('Setup complete!');
+            console.log('============================================================');
+            break;
     }
-    return { valid: true };
 }
-// ============ Download Helpers ============
+// ============ Helpers ============
 function formatBytes(bytes) {
     if (bytes < 1024)
         return `${bytes} B`;
@@ -75,216 +65,12 @@ function formatBytes(bytes) {
         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
-        // -f: fail on HTTP errors (4xx, 5xx)
-        // -o: output file
-        // --write-out: output HTTP code for debugging
-        const child = spawn('curl', [
-            '-L',
-            '-C', '-',
-            '--progress-bar',
-            '-f', // Fail on HTTP errors
-            '-o', destPath,
-            '--write-out', '\\nHTTP_CODE:%{http_code}\\n',
-            url
-        ], {
-            stdio: ['inherit', 'inherit', 'pipe'], // Capture stderr for error info
-        });
-        let stderrData = '';
-        child.stderr?.on('data', (data) => {
-            stderrData += data.toString();
-        });
-        child.on('close', (code) => {
-            if (code === 0) {
-                resolve();
-            }
-            else if (code === 33) {
-                // curl exit 33 = range request not supported, but file may be complete
-                resolve();
-            }
-            else if (code === 22) {
-                // curl exit 22 = HTTP error (when -f is used)
-                // Try to extract HTTP code from stderr
-                const httpMatch = stderrData.match(/HTTP_CODE:(\d+)/);
-                const httpCode = httpMatch ? httpMatch[1] : 'unknown';
-                reject(new Error(`HTTP error ${httpCode} - URL may be invalid or not found`));
-            }
-            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!`);
-    }
-}
+// ============ Commands ============
 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}`);
-    // Iterate over ALL model keys in config (not just stt/llm/tts)
-    const modelTypes = Object.keys(config.models);
-    if (modelTypes.length === 0) {
-        console.error('Error: No models defined in config');
-        process.exit(1);
-    }
-    let downloadedCount = 0;
-    let failedCount = 0;
-    const failures = [];
-    for (const type of modelTypes) {
-        const modelConfig = config.models[type];
-        if (modelConfig) {
-            try {
-                await downloadModel(type, modelConfig, modelsDir);
-                downloadedCount++;
-            }
-            catch (err) {
-                failedCount++;
-                const errorMsg = err instanceof Error ? err.message : String(err);
-                failures.push(`${type}: ${errorMsg}`);
-                console.error(`    ❌ Failed: ${errorMsg}`);
-            }
-        }
-    }
-    // Report failures
-    if (failedCount > 0) {
-        console.error(`\n⚠️  ${failedCount} download(s) failed:`);
-        for (const failure of failures) {
-            console.error(`   - ${failure}`);
-        }
-    }
-    console.log('\n============================================================');
-    console.log('Setup complete!');
-    console.log('============================================================');
+    const result = await setup(configPath, { onProgress: cliProgressReporter });
+    const modelsDir = getModelsDir();
     console.log(`\nModels location: ${modelsDir}`);
-    // List what's there with sizes
     const files = readdirSync(modelsDir);
     if (files.length > 0) {
         console.log('\nDownloaded models:');
@@ -295,44 +81,28 @@ async function setupFromConfig(configPath) {
             console.log(`  - ${file} ${size}`);
         }
     }
+    if (result.failed > 0) {
+        console.error(`\n⚠️  ${result.failed} download(s) failed:`);
+        for (const m of result.models) {
+            if (!m.success) {
+                console.error(`   - ${m.name}: ${m.error}`);
+            }
+        }
+    }
     console.log('\n💡 To set up native binaries (whisper-cli, llama-completion, llama-mtmd-cli, 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);
-    }
+async function runSetupBinaries() {
     console.log('Setting up native binaries...');
     console.log('This will configure: whisper-cli, llama-completion, llama-mtmd-cli, 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);
-        }
+    try {
+        await setupBinaries();
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
         process.exit(1);
-    });
-    return new Promise((resolve) => {
-        child.on('close', (code) => {
-            if (code !== 0) {
-                process.exit(code ?? 1);
-            }
-            resolve();
-        });
-    });
+    }
 }
 // ============ Help ============
 function printHelp() {
@@ -406,7 +176,7 @@ async function main() {
                 process.exit(1);
             }
             if (arg === '--binaries-only' || arg === '--binaries') {
-                await setupBinaries();
+                await runSetupBinaries();
             }
             else {
                 await setupFromConfig(arg);