speechflow 1.7.1 → 2.0.0

package/speechflow-cli/dst/{speechflow-node-t2t-transformers.js → speechflow-node-t2t-translate.js}

@@ -42,26 +42,22 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 /*  standard dependencies  */
-const node_path_1 = __importDefault(require("node:path"));
 const node_stream_1 = __importDefault(require("node:stream"));
-/*  external dependencies  */
-const Transformers = __importStar(require("@huggingface/transformers"));
 /*  internal dependencies  */
 const speechflow_node_1 = __importDefault(require("./speechflow-node"));
 const util = __importStar(require("./speechflow-util"));
-/*  SpeechFlow node for Transformers text-to-text translation  */
-class SpeechFlowNodeT2TTransformers extends speechflow_node_1.default {
+const speechflow_util_llm_1 = require("./speechflow-util-llm");
+/*  SpeechFlow node for LLM-based text-to-text translation  */
+class SpeechFlowNodeT2TTranslate extends speechflow_node_1.default {
     /*  declare official node name  */
-    static name = "t2t-transformers";
+    static name = "t2t-translate";
     /*  internal state  */
-    translator = null;
-    generator = null;
+    llm = null;
     /*  internal LLM setup  */
     setup = {
-        /*  SmolLM3: English (EN) to German (DE) translation  */
-        "SmolLM3:en-de": {
-            systemPrompt: "/no_think\n" +
-                "You are a translator.\n" +
+        /*  English (EN) to German (DE) translation  */
+        "en-de": {
+            systemPrompt: "You are a translator.\n" +
                 "Output only the requested text.\n" +
                 "Do not use markdown.\n" +
                 "Do not chat.\n" +
@@ -82,10 +78,9 @@ class SpeechFlowNodeT2TTransformers extends speechflow_node_1.default {
                 { role: "assistant", content: "Das Leben ist einfach großartig." }
             ]
         },
-        /*  SmolLM3: German (DE) to English (EN) translation  */
-        "SmolLM3:de-en": {
-            systemPrompt: "/no_think\n" +
-                "You are a translator.\n" +
+        /*  German (DE) to English (EN) translation  */
+        "de-en": {
+            systemPrompt: "You are a translator.\n" +
                 "Output only the requested text.\n" +
                 "Do not use markdown.\n" +
                 "Do not chat.\n" +
@@ -114,102 +109,50 @@ class SpeechFlowNodeT2TTransformers extends speechflow_node_1.default {
         this.configure({
             src: { type: "string", pos: 0, val: "de", match: /^(?:de|en)$/ },
             dst: { type: "string", pos: 1, val: "en", match: /^(?:de|en)$/ },
-            model: { type: "string", val: "OPUS", match: /^(?:OPUS|SmolLM3)$/ }
+            provider: { type: "string", val: "ollama", match: /^(?:openai|anthropic|google|ollama|transformers)$/ },
+            api: { type: "string", val: "http://127.0.0.1:11434", match: /^https?:\/\/.+?(:\d+)?$/ },
+            model: { type: "string", val: "gemma3:4b-it-q4_K_M", match: /^.+$/ },
+            key: { type: "string", val: "", match: /^.*$/ }
         });
-        /*  sanity check parameters  */
+        /*  validate translation direction  */
         if (this.params.src === this.params.dst)
-            throw new Error("source and destination languages cannot be the same");
+            throw new Error("source and destination language must be different for translation");
+        /*  tell effective mode  */
+        this.log("info", `translating from language "${this.params.src}" to language "${this.params.dst}" ` +
+            `via ${this.params.provider} LLM (model: ${this.params.model})`);
         /*  declare node input/output format  */
         this.input = "text";
         this.output = "text";
     }
     /*  open node  */
     async open() {
-        let model = "";
-        /*  track download progress when instantiating Transformers engine and model  */
-        const progressState = new Map();
-        const progressCallback = (progress) => {
-            let artifact = model;
-            if (typeof progress.file === "string")
-                artifact += `:${progress.file}`;
-            let percent = 0;
-            if (typeof progress.loaded === "number" && typeof progress.total === "number")
-                percent = (progress.loaded / progress.total) * 100;
-            else if (typeof progress.progress === "number")
-                percent = progress.progress;
-            if (percent > 0)
-                progressState.set(artifact, percent);
-        };
-        const interval = setInterval(() => {
-            for (const [artifact, percent] of progressState) {
-                this.log("info", `downloaded ${percent.toFixed(2)}% of artifact "${artifact}"`);
-                if (percent >= 100.0)
-                    progressState.delete(artifact);
-            }
-        }, 1000);
-        /*  instantiate Transformers engine and model  */
-        if (this.params.model === "OPUS") {
-            model = `onnx-community/opus-mt-${this.params.src}-${this.params.dst}`;
-            const pipeline = Transformers.pipeline("translation", model, {
-                cache_dir: node_path_1.default.join(this.config.cacheDir, "transformers"),
-                dtype: "q4",
-                device: "auto",
-                progress_callback: progressCallback
-            });
-            this.translator = await pipeline;
-            if (this.translator === null)
-                throw new Error("failed to instantiate translator pipeline");
-        }
-        else if (this.params.model === "SmolLM3") {
-            model = "HuggingFaceTB/SmolLM3-3B-ONNX";
-            const pipeline = Transformers.pipeline("text-generation", model, {
-                cache_dir: node_path_1.default.join(this.config.cacheDir, "transformers"),
-                dtype: "q4",
-                device: "auto",
-                progress_callback: progressCallback
-            });
-            this.generator = await pipeline;
-            if (this.generator === null)
-                throw new Error("failed to instantiate generator pipeline");
-        }
-        else
-            throw new Error("invalid model");
-        /*  clear progress interval again  */
-        clearInterval(interval);
+        /*  instantiate LLM  */
+        this.llm = new speechflow_util_llm_1.LLM({
+            provider: this.params.provider,
+            api: this.params.api,
+            model: this.params.model,
+            key: this.params.key,
+            temperature: 0.7,
+            topP: 0.5
+        });
+        this.llm.on("log", (level, message) => {
+            this.log(level, message);
+        });
+        await this.llm.open();
         /*  provide text-to-text translation  */
+        const llm = this.llm;
         const translate = async (text) => {
-            if (this.params.model === "OPUS") {
-                const result = await this.translator(text);
-                const single = Array.isArray(result) ? result[0] : result;
-                return single.translation_text;
-            }
-            else if (this.params.model === "SmolLM3") {
-                const key = `SmolLM3:${this.params.src}-${this.params.dst}`;
-                const cfg = this.setup[key];
-                const messages = [
-                    { role: "system", content: cfg.systemPrompt },
-                    ...cfg.chat,
-                    { role: "user", content: text }
-                ];
-                const result = await this.generator(messages, {
-                    max_new_tokens: 100,
-                    temperature: 0.6,
-                    top_p: 0.95,
-                    streamer: new Transformers.TextStreamer(this.generator.tokenizer, {
-                        skip_prompt: true,
-                        skip_special_tokens: true
-                    })
-                });
-                const single = Array.isArray(result) ? result[0] : result;
-                const generatedText = single.generated_text;
-                return typeof generatedText === "string" ?
-                    generatedText :
-                    generatedText.at(-1).content;
-            }
-            else
-                throw new Error("invalid model");
+            const key = `${this.params.src}-${this.params.dst}`;
+            const cfg = this.setup[key];
+            if (!cfg)
+                throw new Error(`unsupported language pair: ${key}`);
+            return llm.complete({
+                system: cfg.systemPrompt,
+                messages: cfg.chat,
+                prompt: text
+            });
         };
-        /*  establish a duplex stream and connect it to Transformers  */
+        /*  establish a transform stream and connect it to LLM  */
         this.stream = new node_stream_1.default.Transform({
             readableObjectMode: true,
             writableObjectMode: true,
@@ -224,9 +167,9 @@ class SpeechFlowNodeT2TTransformers extends speechflow_node_1.default {
                 }
                 else {
                     translate(chunk.payload).then((payload) => {
-                        chunk = chunk.clone();
-                        chunk.payload = payload;
-                        this.push(chunk);
+                        const chunkNew = chunk.clone();
+                        chunkNew.payload = payload;
+                        this.push(chunkNew);
                         callback();
                     }).catch((error) => {
                         callback(util.ensureError(error));
@@ -234,7 +177,6 @@ class SpeechFlowNodeT2TTransformers extends speechflow_node_1.default {
                 }
             },
             final(callback) {
-                this.push(null);
                 callback();
             }
         });
@@ -246,16 +188,12 @@ class SpeechFlowNodeT2TTransformers extends speechflow_node_1.default {
             await util.destroyStream(this.stream);
             this.stream = null;
         }
-        /*  shutdown Transformers  */
-        if (this.translator !== null) {
-            this.translator.dispose();
-            this.translator = null;
-        }
-        if (this.generator !== null) {
-            this.generator.dispose();
-            this.generator = null;
+        /*  shutdown LLM  */
+        if (this.llm !== null) {
+            await this.llm.close();
+            this.llm = null;
         }
     }
 }
-exports.default = SpeechFlowNodeT2TTransformers;
-//# sourceMappingURL=speechflow-node-t2t-transformers.js.map
+exports.default = SpeechFlowNodeT2TTranslate;
+//# sourceMappingURL=speechflow-node-t2t-translate.js.map

package/speechflow-cli/dst/speechflow-node-t2t-translate.js.map

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

package/speechflow-cli/dst/speechflow-node-xio-exec.d.ts

@@ -0,0 +1,12 @@
+import SpeechFlowNode from "./speechflow-node";
+export default class SpeechFlowNodeXIOExec extends SpeechFlowNode {
+    static name: string;
+    private subprocess;
+    constructor(id: string, cfg: {
+        [id: string]: any;
+    }, opts: {
+        [id: string]: any;
+    }, args: any[]);
+    open(): Promise<void>;
+    close(): Promise<void>;
+}

package/speechflow-cli/dst/speechflow-node-xio-exec.js

@@ -0,0 +1,223 @@
+"use strict";
+/*
+**  SpeechFlow - Speech Processing Flow Graph
+**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
+*/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/*  standard dependencies  */
+const node_stream_1 = __importDefault(require("node:stream"));
+/*  external dependencies  */
+const execa_1 = require("execa");
+const shell_parser_1 = __importDefault(require("shell-parser"));
+/*  internal dependencies  */
+const speechflow_node_1 = __importDefault(require("./speechflow-node"));
+const util = __importStar(require("./speechflow-util"));
+/*  SpeechFlow node for external command execution  */
+class SpeechFlowNodeXIOExec extends speechflow_node_1.default {
+    /*  declare official node name  */
+    static name = "xio-exec";
+    /*  internal state  */
+    subprocess = null;
+    /*  construct node  */
+    constructor(id, cfg, opts, args) {
+        super(id, cfg, opts, args);
+        /*  declare node configuration parameters  */
+        this.configure({
+            command: { type: "string", pos: 0, val: "" },
+            mode: { type: "string", pos: 1, val: "r", match: /^(?:r|w|rw)$/ },
+            type: { type: "string", pos: 2, val: "audio", match: /^(?:audio|text)$/ },
+            chunkAudio: { type: "number", val: 200, match: (n) => n >= 10 && n <= 1000 },
+            chunkText: { type: "number", val: 65536, match: (n) => n >= 1024 && n <= 131072 }
+        });
+        /*  sanity check parameters  */
+        if (this.params.command === "")
+            throw new Error("required parameter \"command\" has to be given");
+        /*  declare node input/output format  */
+        if (this.params.mode === "rw") {
+            this.input = this.params.type;
+            this.output = this.params.type;
+        }
+        else if (this.params.mode === "r") {
+            this.input = "none";
+            this.output = this.params.type;
+        }
+        else if (this.params.mode === "w") {
+            this.input = this.params.type;
+            this.output = "none";
+        }
+    }
+    /*  open node  */
+    async open() {
+        /*  determine how many bytes we need per chunk when
+            the chunk should be of the required duration/size  */
+        const highWaterMarkAudio = (this.config.audioSampleRate *
+            (this.config.audioBitDepth / 8)) / (1000 / this.params.chunkAudio);
+        const highWaterMarkText = this.params.chunkText;
+        /*  parse command into executable and arguments
+            (SECURITY: caller must ensure command parameter is properly validated
+            and does not contain untrusted user input to prevent command injection)  */
+        const cmdParts = (0, shell_parser_1.default)(this.params.command);
+        if (cmdParts.length === 0)
+            throw new Error("failed to parse command: no executable found");
+        /*  warn about potentially dangerous shell metacharacters  */
+        if (/[;&|`$()<>]/.test(this.params.command))
+            this.log("warning", "command contains shell metacharacters -- ensure input is trusted");
+        const executable = cmdParts[0];
+        const args = cmdParts.slice(1);
+        /*  determine subprocess options  */
+        const encoding = (this.params.type === "text" ?
+            this.config.textEncoding : "buffer");
+        /*  spawn subprocess  */
+        this.log("info", `executing command: ${this.params.command}`);
+        this.subprocess = (0, execa_1.execa)(executable, args, {
+            buffer: false,
+            encoding,
+            ...(this.params.mode === "rw" ? { stdin: "pipe", stdout: "pipe" } : {}),
+            ...(this.params.mode === "r" ? { stdin: "ignore", stdout: "pipe" } : {}),
+            ...(this.params.mode === "w" ? { stdin: "pipe", stdout: "ignore" } : {})
+        });
+        /*  handle subprocess errors  */
+        this.subprocess.on("error", (err) => {
+            this.log("error", `subprocess error: ${err.message}`);
+            this.emit("error", err);
+            if (this.stream !== null)
+                this.stream.emit("error", err);
+        });
+        /*  handle subprocess exit  */
+        this.subprocess.on("exit", (code, signal) => {
+            if (code !== 0 && code !== null)
+                this.log("warning", `subprocess exited with code ${code}`);
+            else if (signal)
+                this.log("warning", `subprocess terminated by signal ${signal}`);
+            else
+                this.log("info", "subprocess terminated gracefully");
+        });
+        /*  determine high water mark based on type  */
+        const highWaterMark = this.params.type === "audio" ? highWaterMarkAudio : highWaterMarkText;
+        /*  configure stream encoding  */
+        if (this.subprocess.stdout && this.params.type === "text")
+            this.subprocess.stdout.setEncoding(this.config.textEncoding);
+        if (this.subprocess.stdin)
+            this.subprocess.stdin.setDefaultEncoding(this.params.type === "text" ?
+                this.config.textEncoding : "binary");
+        /*  dispatch according to mode  */
+        if (this.params.mode === "rw") {
+            /*  bidirectional mode: both stdin and stdout  */
+            this.stream = node_stream_1.default.Duplex.from({
+                readable: this.subprocess.stdout,
+                writable: this.subprocess.stdin
+            });
+            const wrapper1 = util.createTransformStreamForWritableSide(this.params.type, highWaterMark);
+            const wrapper2 = util.createTransformStreamForReadableSide(this.params.type, () => this.timeZero, highWaterMark);
+            this.stream = node_stream_1.default.compose(wrapper1, this.stream, wrapper2);
+        }
+        else if (this.params.mode === "r") {
+            /*  read-only mode: stdout only  */
+            const wrapper = util.createTransformStreamForReadableSide(this.params.type, () => this.timeZero, highWaterMark);
+            this.stream = node_stream_1.default.compose(this.subprocess.stdout, wrapper);
+        }
+        else if (this.params.mode === "w") {
+            /*  write-only mode: stdin only  */
+            const wrapper = util.createTransformStreamForWritableSide(this.params.type, highWaterMark);
+            this.stream = node_stream_1.default.compose(wrapper, this.subprocess.stdin);
+        }
+    }
+    /*  close node  */
+    async close() {
+        /*  terminate subprocess  */
+        if (this.subprocess !== null) {
+            /*  gracefully end stdin if in write or read/write mode  */
+            if ((this.params.mode === "w" || this.params.mode === "rw") && this.subprocess.stdin &&
+                !this.subprocess.stdin.destroyed && !this.subprocess.stdin.writableEnded) {
+                await Promise.race([
+                    new Promise((resolve, reject) => {
+                        this.subprocess.stdin.end((err) => {
+                            if (err)
+                                reject(err);
+                            else
+                                resolve();
+                        });
+                    }),
+                    util.timeout(2000)
+                ]).catch((err) => {
+                    const error = util.ensureError(err);
+                    this.log("warning", `failed to gracefully close stdin: ${error.message}`);
+                });
+            }
+            /*  wait for subprocess to exit gracefully  */
+            await Promise.race([
+                this.subprocess,
+                util.timeout(5000, "subprocess exit timeout")
+            ]).catch(async (err) => {
+                /*  force kill with SIGTERM  */
+                const error = util.ensureError(err);
+                if (error.message.includes("timeout")) {
+                    this.log("warning", "subprocess did not exit gracefully, forcing termination");
+                    this.subprocess.kill("SIGTERM");
+                    return Promise.race([
+                        this.subprocess,
+                        util.timeout(2000)
+                    ]);
+                }
+            }).catch(async () => {
+                /*  force kill with SIGKILL  */
+                this.log("warning", "subprocess did not respond to SIGTERM, forcing SIGKILL");
+                this.subprocess.kill("SIGKILL");
+                return Promise.race([
+                    this.subprocess,
+                    util.timeout(1000)
+                ]);
+            }).catch(() => {
+                this.log("error", "subprocess did not terminate even after SIGKILL");
+            });
+            /*  remove event listeners to prevent memory leaks  */
+            this.subprocess.removeAllListeners("error");
+            this.subprocess.removeAllListeners("exit");
+            this.subprocess = null;
+        }
+        /*  shutdown stream  */
+        if (this.stream !== null) {
+            await util.destroyStream(this.stream);
+            this.stream = null;
+        }
+    }
+}
+exports.default = SpeechFlowNodeXIOExec;
+//# sourceMappingURL=speechflow-node-xio-exec.js.map

package/speechflow-cli/dst/speechflow-node-xio-exec.js.map

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

package/speechflow-cli/dst/speechflow-node-xio-file.d.ts

@@ -1,6 +1,7 @@
 import SpeechFlowNode from "./speechflow-node";
 export default class SpeechFlowNodeXIOFile extends SpeechFlowNode {
     static name: string;
+    private fd;
     constructor(id: string, cfg: {
         [id: string]: any;
     }, opts: {