termux-tts 1.6.0 → 1.7.0

package/README.md

@@ -127,42 +127,6 @@ main();
 
 ---
 
-## Distributed Clustering & Memory Pooling (AMEVA-Cluster)
-
-Termux-TTS natively integrates with **AMEVA-Cluster** (`pip install ameva-cluster`) for distributed speech synthesis across interconnected mobile nodes.
-
-### 1. Install Cluster Runtime
-```bash
-pip install ameva-cluster
-# or Node.js:
-npm install @ameva/cluster
-```
-
-### 2. Launch Worker Node on Remote Phone
-```bash
-# On remote worker device (e.g. Galaxy A53):
-ameva-cluster worker --port 50052
-```
-
-### 3. Distributed Speech Synthesis via Master Node
-```bash
-# Master CLI offloading neural vocoder synthesis:
-termux-tts synthesize "Clustering active across distributed phone fleet." \
-  --rpc 192.0.2.10:50052,192.0.2.11:50052 \
-  -o cluster_output.wav
-```
-
-```python
-import termux_tts as tts
-
-# Python SDK Distributed TTS
-with tts.load(cluster_rpc_servers="192.0.2.10:50052,192.0.2.11:50052") as engine:
-    result = engine.synthesize("Distributed TTS voice synthesis active.", output="distributed.wav")
-    print(f"Elapsed: {result.elapsed_ms:.1f}ms")
-```
-
----
-
 ## Official Documentation & Benchmarks
 - [Official Architecture & API Reference](https://uno-km.vercel.app/lib/tts/)
 - [Ecosystem Metrics & Registry Stats](https://uno-km.vercel.app/foundation/metrics)

package/bin/cli.js

@@ -1,4 +1,8 @@
 #!/usr/bin/env node
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
 /**
  * AMEVA Standard Node.js CLI Runner for termux_tts.
  * Automatically resolves Python 3 environment and dispatches to python -m termux_tts.

package/binding_node/index.js

@@ -1,125 +1,129 @@
-/**
- * termux-tts Node.js SDK
- * Secure On-Device Speech Synthesis Binding (CWE-94 Remediation).
- */
-
-const { spawn } = require('child_process');
-const path = require('path');
-
-class TTSEngine {
-    constructor(options = {}) {
-        this.language = options.language || 'ko';
-        this.preset = options.preset || 'balanced';
-        this.sampleRate = options.sampleRate || 22050;
-        this.engine = options.engine || 'auto';
-        this.device = options.device || (options.gpu ? 'gpu' : 'auto');
-        this.tier = options.tier || null;
-        this.model = options.model || null;
-    }
-
-    async synthesize(text, options = {}) {
-        if (!text || typeof text !== 'string' || !text.trim()) {
-            throw new Error('TTSInferenceError: Input text cannot be empty.');
-        }
-
-        const output = options.output || path.join(process.cwd(), 'output.wav');
-        const speed = typeof options.speed === 'number' ? options.speed : 1.0;
-        const preset = options.preset || this.preset;
-        const engineType = options.engine || this.engine;
-        const deviceType = options.device || (options.gpu ? 'gpu' : this.device);
-        const tierType = options.tier || this.tier;
-        const modelPath = options.model || this.model;
-
-        const payload = JSON.stringify({
-            text: text,
-            output: output,
-            language: this.language,
-            sample_rate: this.sampleRate,
-            speed: speed,
-            preset: preset,
-            engine: engineType,
-            device: deviceType,
-            tier: tierType,
-            model: modelPath
-        });
-
-        return new Promise((resolve, reject) => {
-            const pythonDriver = `
-import sys, json
-import termux_tts as tts
-
-try:
-    data = json.loads(sys.stdin.read())
-    engine = tts.load(
-        model=data.get('model'),
-        language=data.get('language', 'ko'),
-        preset=data.get('preset', 'balanced'),
-        sample_rate=data.get('sample_rate', 22050),
-        engine=data.get('engine', 'auto'),
-        device=data.get('device', 'auto'),
-        tier=data.get('tier', None)
-    )
-    res = engine.synthesize(data['text'], output=data['output'], speed=float(data.get('speed', 1.0)))
-    result = {
-        'status': 'SUCCESS',
-        'text': res.text,
-        'outputPath': data['output'],
-        'durationSec': res.duration_sec,
-        'elapsedMs': res.elapsed_ms,
-        'rtf': res.rtf,
-        'sampleRate': res.sample_rate,
-        'backend': res.backend,
-        'modelName': getattr(res, 'model_name', 'default')
-    }
-    sys.stdout.write(json.dumps(result))
-except Exception as e:
-    sys.stderr.write(f"TTSInferenceError: {str(e)}")
-    sys.exit(1)
-`;
-            const pyBin = process.env.PYTHON_BIN || (process.platform === 'win32' ? 'py' : 'python3');
-            const proc = spawn(pyBin, ['-c', pythonDriver], {
-                env: { ...process.env, PYTHONPATH: path.join(__dirname, '..') }
-            });
-
-            let stdout = '';
-            let stderr = '';
-
-            proc.stdout.on('data', (d) => { stdout += d.toString(); });
-            proc.stderr.on('data', (d) => { stderr += d.toString(); });
-
-            proc.on('close', (code) => {
-                if (code !== 0) {
-                    return reject(new Error(`TTSInferenceError (${code}): ${stderr.trim() || stdout.trim()}`));
-                }
-                try {
-                    const parsed = JSON.parse(stdout);
-                    if (parsed.status === 'SUCCESS') {
-                        resolve(parsed);
-                    } else {
-                        reject(new Error(`TTSInferenceError: Unexpected execution status in ${stdout}`));
-                    }
-                } catch (err) {
-                    reject(new Error(`TTSParseError: Failed to parse Python worker JSON response: ${stdout}`));
-                }
-            });
-
-            proc.on('error', (err) => {
-                reject(new Error(`TTSProcessError: Failed to spawn python3 worker: ${err.message}`));
-            });
-
-            // Write JSON payload securely to stdin and close stream
-            proc.stdin.write(payload);
-            proc.stdin.end();
-        });
-    }
-
-    close() {
-        // Resource clean up
-    }
-}
-
-module.exports = {
-    TTSEngine,
-    load: (opts) => new TTSEngine(opts),
-    version: "0.1.0"
-};
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
+/**
+ * termux-tts Node.js SDK
+ * Secure On-Device Speech Synthesis Binding (CWE-94 Remediation).
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+
+class TTSEngine {
+    constructor(options = {}) {
+        this.language = options.language || 'ko';
+        this.preset = options.preset || 'balanced';
+        this.sampleRate = options.sampleRate || 22050;
+        this.engine = options.engine || 'auto';
+        this.device = options.device || (options.gpu ? 'gpu' : 'auto');
+        this.tier = options.tier || null;
+        this.model = options.model || null;
+    }
+
+    async synthesize(text, options = {}) {
+        if (!text || typeof text !== 'string' || !text.trim()) {
+            throw new Error('TTSInferenceError: Input text cannot be empty.');
+        }
+
+        const output = options.output || path.join(process.cwd(), 'output.wav');
+        const speed = typeof options.speed === 'number' ? options.speed : 1.0;
+        const preset = options.preset || this.preset;
+        const engineType = options.engine || this.engine;
+        const deviceType = options.device || (options.gpu ? 'gpu' : this.device);
+        const tierType = options.tier || this.tier;
+        const modelPath = options.model || this.model;
+
+        const payload = JSON.stringify({
+            text: text,
+            output: output,
+            language: this.language,
+            sample_rate: this.sampleRate,
+            speed: speed,
+            preset: preset,
+            engine: engineType,
+            device: deviceType,
+            tier: tierType,
+            model: modelPath
+        });
+
+        return new Promise((resolve, reject) => {
+            const pythonDriver = `
+import sys, json
+import termux_tts as tts
+
+try:
+    data = json.loads(sys.stdin.read())
+    engine = tts.load(
+        model=data.get('model'),
+        language=data.get('language', 'ko'),
+        preset=data.get('preset', 'balanced'),
+        sample_rate=data.get('sample_rate', 22050),
+        engine=data.get('engine', 'auto'),
+        device=data.get('device', 'auto'),
+        tier=data.get('tier', None)
+    )
+    res = engine.synthesize(data['text'], output=data['output'], speed=float(data.get('speed', 1.0)))
+    result = {
+        'status': 'SUCCESS',
+        'text': res.text,
+        'outputPath': data['output'],
+        'durationSec': res.duration_sec,
+        'elapsedMs': res.elapsed_ms,
+        'rtf': res.rtf,
+        'sampleRate': res.sample_rate,
+        'backend': res.backend,
+        'modelName': getattr(res, 'model_name', 'default')
+    }
+    sys.stdout.write(json.dumps(result))
+except Exception as e:
+    sys.stderr.write(f"TTSInferenceError: {str(e)}")
+    sys.exit(1)
+`;
+            const pyBin = process.env.PYTHON_BIN || (process.platform === 'win32' ? 'py' : 'python3');
+            const proc = spawn(pyBin, ['-c', pythonDriver], {
+                env: { ...process.env, PYTHONPATH: path.join(__dirname, '..') }
+            });
+
+            let stdout = '';
+            let stderr = '';
+
+            proc.stdout.on('data', (d) => { stdout += d.toString(); });
+            proc.stderr.on('data', (d) => { stderr += d.toString(); });
+
+            proc.on('close', (code) => {
+                if (code !== 0) {
+                    return reject(new Error(`TTSInferenceError (${code}): ${stderr.trim() || stdout.trim()}`));
+                }
+                try {
+                    const parsed = JSON.parse(stdout);
+                    if (parsed.status === 'SUCCESS') {
+                        resolve(parsed);
+                    } else {
+                        reject(new Error(`TTSInferenceError: Unexpected execution status in ${stdout}`));
+                    }
+                } catch (err) {
+                    reject(new Error(`TTSParseError: Failed to parse Python worker JSON response: ${stdout}`));
+                }
+            });
+
+            proc.on('error', (err) => {
+                reject(new Error(`TTSProcessError: Failed to spawn python3 worker: ${err.message}`));
+            });
+
+            // Write JSON payload securely to stdin and close stream
+            proc.stdin.write(payload);
+            proc.stdin.end();
+        });
+    }
+
+    close() {
+        // Resource clean up
+    }
+}
+
+module.exports = {
+    TTSEngine,
+    load: (opts) => new TTSEngine(opts),
+    version: "0.1.0"
+};

package/binding_node/test_node.js

@@ -1,40 +1,44 @@
-const tts = require('./index.js');
-const assert = require('assert');
-const path = require('path');
-const fs = require('fs');
-
-async function testNode() {
-    console.log('[*] Testing termux-tts Node.js SDK...');
-    const engine = tts.load({ language: 'ko' });
-    assert.strictEqual(engine.language, 'ko');
-
-    // 1. Valid synthesis test
-    const outWav = path.join(__dirname, 'test_node_out.wav');
-    const res = await engine.synthesize("노드 JS SDK 보안 무결성 합성 검증입니다.", {
-        output: outWav,
-        speed: 1.0
-    });
-    assert.strictEqual(res.status, 'SUCCESS');
-    assert(res.durationSec > 0.3);
-    assert(fs.existsSync(outWav));
-    assert(fs.statSync(outWav).size > 1000);
-    fs.unlinkSync(outWav);
-    console.log(`[PASS] Node.js Synthesis: ${res.durationSec}s in ${res.elapsedMs}ms`);
-
-    // 2. Security payload test (Command/Code Injection Attack payload)
-    const attackPayload = 'Hello"""\nimport os\nos.system("echo HACKED")\n"""World';
-    const attackOut = path.join(__dirname, 'test_attack_out.wav');
-    const attackRes = await engine.synthesize(attackPayload, {
-        output: attackOut
-    });
-    assert.strictEqual(attackRes.status, 'SUCCESS');
-    if (fs.existsSync(attackOut)) {
-        fs.unlinkSync(attackOut);
-    }
-    console.log('[PASS] Node.js RCE Injection Defense verified.');
-}
-
-testNode().catch((err) => {
-    console.error('[FAIL]', err);
-    process.exit(1);
-});
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
+const tts = require('./index.js');
+const assert = require('assert');
+const path = require('path');
+const fs = require('fs');
+
+async function testNode() {
+    console.log('[*] Testing termux-tts Node.js SDK...');
+    const engine = tts.load({ language: 'ko' });
+    assert.strictEqual(engine.language, 'ko');
+
+    // 1. Valid synthesis test
+    const outWav = path.join(__dirname, 'test_node_out.wav');
+    const res = await engine.synthesize("노드 JS SDK 보안 무결성 합성 검증입니다.", {
+        output: outWav,
+        speed: 1.0
+    });
+    assert.strictEqual(res.status, 'SUCCESS');
+    assert(res.durationSec > 0.3);
+    assert(fs.existsSync(outWav));
+    assert(fs.statSync(outWav).size > 1000);
+    fs.unlinkSync(outWav);
+    console.log(`[PASS] Node.js Synthesis: ${res.durationSec}s in ${res.elapsedMs}ms`);
+
+    // 2. Security payload test (Command/Code Injection Attack payload)
+    const attackPayload = 'Hello"""\nimport os\nos.system("echo HACKED")\n"""World';
+    const attackOut = path.join(__dirname, 'test_attack_out.wav');
+    const attackRes = await engine.synthesize(attackPayload, {
+        output: attackOut
+    });
+    assert.strictEqual(attackRes.status, 'SUCCESS');
+    if (fs.existsSync(attackOut)) {
+        fs.unlinkSync(attackOut);
+    }
+    console.log('[PASS] Node.js RCE Injection Defense verified.');
+}
+
+testNode().catch((err) => {
+    console.error('[FAIL]', err);
+    process.exit(1);
+});

package/index.js

@@ -1,3 +1,7 @@
+/**
+ * Copyright (c) 2026 Uno Kim / AMEVA Foundation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0 OR Commercial-License
+ */
 /**
  * termux-tts Node.js SDK Entrypoint
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termux-tts",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "On-device Text-to-Speech framework utilizing device resources (DSP Formant Vocoder, ONNX Neural Runtime & Android Native Voice)",
   "main": "index.js",
   "bin": {