speechflow 0.9.9 → 1.1.0

package/dst/speechflow-utils.js

@@ -8,8 +8,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DoubleQueue = exports.SingleQueue = void 0;
+exports.Queue = exports.QueuePointer = exports.DoubleQueue = exports.SingleQueue = void 0;
 exports.audioBufferDuration = audioBufferDuration;
+exports.audioArrayDuration = audioArrayDuration;
+exports.convertBufToF32 = convertBufToF32;
+exports.convertF32ToBuf = convertF32ToBuf;
 exports.createTransformStreamForWritableSide = createTransformStreamForWritableSide;
 exports.createTransformStreamForReadableSide = createTransformStreamForReadableSide;
 exports.ensureStreamChunk = ensureStreamChunk;
@@ -32,6 +35,26 @@ function audioBufferDuration(buffer, sampleRate = 48000, bitDepth = 16, channels
     const totalSamples = buffer.length / (bytesPerSample * channels);
     return totalSamples / sampleRate;
 }
+/*  calculate duration of an audio array  */
+function audioArrayDuration(arr, sampleRate = 48000, channels = 1) {
+    const totalSamples = arr.length / channels;
+    return totalSamples / sampleRate;
+}
+/*  helper function: convert Buffer in PCM/I16 to Float32Array in PCM/F32 format  */
+function convertBufToF32(buf, littleEndian = true) {
+    const dataView = new DataView(buf.buffer);
+    const arr = new Float32Array(buf.length / 2);
+    for (let i = 0; i < arr.length; i++)
+        arr[i] = dataView.getInt16(i * 2, littleEndian) / 32768;
+    return arr;
+}
+/*  helper function: convert Float32Array in PCM/F32 to Buffer in PCM/I16 format  */
+function convertF32ToBuf(arr) {
+    const int16Array = new Int16Array(arr.length);
+    for (let i = 0; i < arr.length; i++)
+        int16Array[i] = Math.max(-32768, Math.min(32767, Math.round(arr[i] * 32768)));
+    return Buffer.from(int16Array.buffer);
+}
 /*  create a Duplex/Transform stream which has
     object-mode on Writable side and buffer/string-mode on Readable side  */
 function createTransformStreamForWritableSide() {
@@ -192,3 +215,162 @@ class DoubleQueue extends node_events_1.EventEmitter {
     }
 }
 exports.DoubleQueue = DoubleQueue;
+/*  queue pointer  */
+class QueuePointer extends node_events_1.EventEmitter {
+    name;
+    queue;
+    /*  internal state  */
+    index = 0;
+    /*  construction  */
+    constructor(name, queue) {
+        super();
+        this.name = name;
+        this.queue = queue;
+    }
+    /*  positioning operations  */
+    maxPosition() {
+        return this.queue.elements.length;
+    }
+    position(index) {
+        if (index !== undefined) {
+            this.index = index;
+            if (this.index < 0)
+                this.index = 0;
+            else if (this.index >= this.queue.elements.length)
+                this.index = this.queue.elements.length;
+            this.emit("position", this.index);
+        }
+        return this.index;
+    }
+    walk(num) {
+        if (num > 0) {
+            for (let i = 0; i < num && this.index < this.queue.elements.length; i++)
+                this.index++;
+            this.emit("position", { start: this.index });
+        }
+        else if (num < 0) {
+            for (let i = 0; i < Math.abs(num) && this.index > 0; i++)
+                this.index--;
+            this.emit("position", { start: this.index });
+        }
+    }
+    walkForwardUntil(type) {
+        while (this.index < this.queue.elements.length
+            && this.queue.elements[this.index].type !== type)
+            this.index++;
+        this.emit("position", { start: this.index });
+    }
+    walkBackwardUntil(type) {
+        while (this.index > 0
+            && this.queue.elements[this.index].type !== type)
+            this.index--;
+        this.emit("position", { start: this.index });
+    }
+    /*  search operations  */
+    searchForward(type) {
+        let position = this.index;
+        while (position < this.queue.elements.length
+            && this.queue.elements[position].type !== type)
+            position++;
+        this.emit("search", { start: this.index, end: position });
+        return position;
+    }
+    searchBackward(type) {
+        let position = this.index;
+        while (position > 0
+            && this.queue.elements[position].type !== type)
+            position--;
+        this.emit("search", { start: position, end: this.index });
+        return position;
+    }
+    /*  reading operations  */
+    peek(position) {
+        if (position === undefined)
+            position = this.index;
+        else {
+            if (position < 0)
+                position = 0;
+            else if (position > this.queue.elements.length)
+                position = this.queue.elements.length;
+        }
+        const element = this.queue.elements[position];
+        this.queue.emit("read", { start: position, end: position });
+        return element;
+    }
+    read() {
+        const element = this.queue.elements[this.index];
+        if (this.index < this.queue.elements.length)
+            this.index++;
+        this.queue.emit("read", { start: this.index - 1, end: this.index - 1 });
+        return element;
+    }
+    slice(size) {
+        let slice;
+        const start = this.index;
+        if (size !== undefined) {
+            if (size < 0)
+                size = 0;
+            else if (size > this.queue.elements.length - this.index)
+                size = this.queue.elements.length - this.index;
+            slice = this.queue.elements.slice(this.index, size);
+            this.index += size;
+        }
+        else {
+            slice = this.queue.elements.slice(this.index);
+            this.index = this.queue.elements.length;
+        }
+        this.queue.emit("read", { start, end: this.index });
+        return slice;
+    }
+    /*  writing operations  */
+    touch() {
+        if (this.index >= this.queue.elements.length)
+            throw new Error("cannot touch after last element");
+        this.queue.emit("write", { start: this.index, end: this.index + 1 });
+    }
+    append(element) {
+        this.queue.elements.push(element);
+        this.index = this.queue.elements.length;
+        this.queue.emit("write", { start: this.index - 1, end: this.index - 1 });
+    }
+    insert(element) {
+        this.queue.elements.splice(this.index++, 0, element);
+        this.queue.emit("write", { start: this.index - 1, end: this.index });
+    }
+    delete() {
+        if (this.index >= this.queue.elements.length)
+            throw new Error("cannot delete after last element");
+        this.queue.elements.splice(this.index, 1);
+        this.queue.emit("write", { start: this.index, end: this.index });
+    }
+}
+exports.QueuePointer = QueuePointer;
+/*  queue  */
+class Queue extends node_events_1.EventEmitter {
+    elements = [];
+    pointers = new Map();
+    pointerUse(name) {
+        if (!this.pointers.has(name))
+            this.pointers.set(name, new QueuePointer(name, this));
+        return this.pointers.get(name);
+    }
+    pointerDelete(name) {
+        if (!this.pointers.has(name))
+            throw new Error("pointer not exists");
+        this.pointers.delete(name);
+    }
+    trim() {
+        /*  determine minimum pointer position  */
+        let min = this.elements.length;
+        for (const pointer of this.pointers.values())
+            if (min > pointer.position())
+                min = pointer.position();
+        /*  trim the maximum amount of first elements  */
+        this.elements.splice(0, min);
+        /*  shift all pointers  */
+        for (const pointer of this.pointers.values())
+            pointer.position(pointer.position() - min);
+    }
+}
+exports.Queue = Queue;
+//# sourceMappingURL=speechflow-utils.js.map

package/dst/speechflow-utils.js.map

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

package/dst/speechflow.js

@@ -5,6 +5,39 @@
 **  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 };
 };
@@ -13,6 +46,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const node_path_1 = __importDefault(require("node:path"));
 const node_stream_1 = __importDefault(require("node:stream"));
 const node_events_1 = require("node:events");
+const HAPI = __importStar(require("@hapi/hapi"));
+const hapi_plugin_websocket_1 = __importDefault(require("hapi-plugin-websocket"));
+const hapi_plugin_header_1 = __importDefault(require("hapi-plugin-header"));
 /*  external dependencies  */
 const luxon_1 = require("luxon");
 const cli_io_1 = __importDefault(require("cli-io"));
@@ -24,6 +60,9 @@ const object_path_1 = __importDefault(require("object-path"));
 const installed_packages_1 = __importDefault(require("installed-packages"));
 const dotenvx_1 = __importDefault(require("@dotenvx/dotenvx"));
 const syspath_1 = __importDefault(require("syspath"));
+const arktype = __importStar(require("arktype"));
+const cli_table3_1 = __importDefault(require("cli-table3"));
+const chalk_1 = __importDefault(require("chalk"));
 const package_json_1 = __importDefault(require("../package.json"));
 /*  central CLI context  */
 let cli = null;
@@ -41,11 +80,15 @@ let cli = null;
         "[-h|--help] " +
         "[-V|--version] " +
         "[-v|--verbose <level>] " +
+        "[-a|--address <ip-address>] " +
+        "[-p|--port <tcp-port>] " +
         "[-C|--cache <directory>] " +
+        "[-S|--status] " +
         "[-e|--expression <expression>] " +
         "[-f|--file <file>] " +
         "[-c|--config <id>@<yaml-config-file>] " +
         "[<argument> [...]]")
+        .version(false)
         .option("V", {
         alias: "version",
         type: "boolean",
@@ -62,6 +105,24 @@ let cli = null;
         nargs: 1,
         default: "warning",
         describe: "level for verbose logging ('none', 'error', 'warning', 'info', 'debug')"
+    })
+        .option("a", {
+        alias: "address",
+        type: "string",
+        array: false,
+        coerce,
+        nargs: 1,
+        default: "0.0.0.0",
+        describe: "IP address for REST/WebSocket API"
+    })
+        .option("p", {
+        alias: "port",
+        type: "number",
+        array: false,
+        coerce,
+        nargs: 1,
+        default: 8484,
+        describe: "TCP port for REST/WebSocket API"
     })
         .option("C", {
         alias: "cache",
@@ -71,6 +132,14 @@ let cli = null;
         nargs: 1,
         default: node_path_1.default.join(dataDir, "cache"),
         describe: "directory for cached files (primarily AI model files)"
+    })
+        .option("S", {
+        alias: "status",
+        type: "boolean",
+        array: false,
+        coerce,
+        default: false,
+        describe: "show one-time status of nodes"
     })
         .option("e", {
         alias: "expression",
@@ -102,7 +171,6 @@ let cli = null;
         .help("h", "show usage help")
         .alias("h", "help")
         .showHelpOnFail(true)
-        .version(false)
         .strict()
         .demand(0)
         .parse((0, helpers_1.hideBin)(process.argv));
@@ -174,6 +242,9 @@ let cli = null;
     const pkgsI = [
         "./speechflow-node-a2a-ffmpeg.js",
         "./speechflow-node-a2a-wav.js",
+        "./speechflow-node-a2a-mute.js",
+        "./speechflow-node-a2a-meter.js",
+        "./speechflow-node-a2a-vad.js",
         "./speechflow-node-a2t-deepgram.js",
         "./speechflow-node-t2a-elevenlabs.js",
         "./speechflow-node-t2a-kokoro.js",
@@ -181,7 +252,6 @@ let cli = null;
         "./speechflow-node-t2t-openai.js",
         "./speechflow-node-t2t-ollama.js",
         "./speechflow-node-t2t-transformers.js",
-        "./speechflow-node-t2t-opus.js",
         "./speechflow-node-t2t-subtitle.js",
         "./speechflow-node-t2t-format.js",
         "./speechflow-node-x2x-trace.js",
@@ -217,15 +287,7 @@ let cli = null;
             }
         }
     }
-    /*  graph processing: PASS 1: parse DSL and create and connect nodes  */
-    const flowlink = new flowlink_1.default({
-        trace: (msg) => {
-            cli.log("debug", msg);
-        }
-    });
-    let nodenum = 1;
-    const variables = { argv: args._, env: process.env };
-    const graphNodes = new Set();
+    /*  static configuration  */
     const cfg = {
         audioChannels: 1,
         audioBitDepth: 16,
@@ -234,6 +296,43 @@ let cli = null;
         textEncoding: "utf8",
         cacheDir: args.C
     };
+    /*  handle one-time status query of nodes  */
+    if (args.S) {
+        const table = new cli_table3_1.default({
+            head: [
+                chalk_1.default.reset.bold("NODE"),
+                chalk_1.default.reset.bold("PROPERTY"),
+                chalk_1.default.reset.bold("VALUE")
+            ],
+            colWidths: [15, 15, 50 - (2 * 2 + 2 * 3)],
+            style: { "padding-left": 1, "padding-right": 1, border: ["grey"], compact: true },
+            chars: { "left-mid": "", mid: "", "mid-mid": "", "right-mid": "" }
+        });
+        for (const name of Object.keys(nodes)) {
+            cli.log("info", `gathering status of node <${name}>`);
+            const node = new nodes[name](name, cfg, {}, []);
+            const status = await node.status();
+            if (Object.keys(status).length > 0) {
+                let first = true;
+                for (const key of Object.keys(status)) {
+                    table.push([first ? chalk_1.default.bold(name) : "", key, chalk_1.default.blue(status[key])]);
+                    first = false;
+                }
+            }
+        }
+        const output = table.toString();
+        process.stdout.write(output + "\n");
+        process.exit(0);
+    }
+    /*  graph processing: PASS 1: parse DSL and create and connect nodes  */
+    const flowlink = new flowlink_1.default({
+        trace: (msg) => {
+            cli.log("debug", msg);
+        }
+    });
+    const variables = { argv: args._, env: process.env };
+    const graphNodes = new Set();
+    const nodeNums = new Map();
     let ast;
     try {
         ast = flowlink.compile(config);
@@ -261,17 +360,19 @@ let cli = null;
                     throw new Error(`unknown node "${id}"`);
                 let node;
                 try {
-                    node = new nodes[id](`${id}[${nodenum}]`, cfg, opts, args);
+                    let num = nodeNums.get(nodes[id]) ?? 0;
+                    nodeNums.set(nodes[id], ++num);
+                    const name = num === 1 ? id : `${id}:${num}`;
+                    node = new nodes[id](name, cfg, opts, args);
                 }
                 catch (err) {
                     /*  fatal error  */
                     if (err instanceof Error)
-                        cli.log("error", `creation of "${id}[${nodenum}]" node failed: ${err.message}`);
+                        cli.log("error", `creation of <${id}> node failed: ${err.message}`);
                     else
-                        cli.log("error", `creation of "${id}"[${nodenum}] node failed: ${err}`);
+                        cli.log("error", `creation of <${id}> node failed: ${err}`);
                     process.exit(1);
                 }
-                nodenum++;
                 const params = Object.keys(node.params)
                     .map((key) => `${key}: ${JSON.stringify(node.params[key])}`).join(", ");
                 cli.log("info", `create node "${node.id}" (${params})`);
@@ -377,6 +478,144 @@ let cli = null;
             }
         });
     }
+    /*  define external request/response structure  */
+    const requestValidator = arktype.type({
+        request: "string",
+        node: "string",
+        args: "unknown[]"
+    });
+    /*  forward external request to target node in graph  */
+    const consumeExternalRequest = async (_req) => {
+        const req = requestValidator(_req);
+        if (req instanceof arktype.type.errors)
+            throw new Error(`invalid request: ${req.summary}`);
+        if (req.request !== "COMMAND")
+            throw new Error("invalid external request (command expected)");
+        const name = req.node;
+        const args = req.args;
+        const foundNode = Array.from(graphNodes).find((node) => node.id === name);
+        if (foundNode === undefined)
+            cli.log("warning", `external request failed: no such node <${name}>`);
+        else {
+            await foundNode.receiveRequest(args).catch((err) => {
+                cli.log("warning", `external request to node <${name}> failed: ${err}`);
+                throw new Error(`external request to node <${name}> failed: ${err}`);
+            });
+        }
+    };
+    /*  establish REST/WebSocket API  */
+    const wsPeers = new Map();
+    const hapi = new HAPI.Server({
+        address: args.a,
+        port: args.p
+    });
+    await hapi.register({ plugin: hapi_plugin_header_1.default, options: { Server: `${package_json_1.default.name}/${package_json_1.default.version}` } });
+    await hapi.register({ plugin: hapi_plugin_websocket_1.default });
+    hapi.events.on("response", (request) => {
+        let protocol = `HTTP/${request.raw.req.httpVersion}`;
+        const ws = request.websocket();
+        if (ws.mode === "websocket") {
+            const wsVersion = ws.ws.protocolVersion ??
+                request.headers["sec-websocket-version"] ?? "13?";
+            protocol = `WebSocket/${wsVersion}+${protocol}`;
+        }
+        const msg = "remote=" + request.info.remoteAddress + ", " +
+            "method=" + request.method.toUpperCase() + ", " +
+            "url=" + request.url.pathname + ", " +
+            "protocol=" + protocol + ", " +
+            "response=" + ("statusCode" in request.response ? request.response.statusCode : "<unknown>");
+        cli.log("info", `HAPI: request: ${msg}`);
+    });
+    hapi.events.on({ name: "request", channels: ["error"] }, (request, event, tags) => {
+        if (event.error instanceof Error)
+            cli.log("error", `HAPI: request-error: ${event.error.message}`);
+        else
+            cli.log("error", `HAPI: request-error: ${event.error}`);
+    });
+    hapi.events.on("log", (event, tags) => {
+        if (tags.error) {
+            const err = event.error;
+            if (err instanceof Error)
+                cli.log("error", `HAPI: log: ${err.message}`);
+            else
+                cli.log("error", `HAPI: log: ${err}`);
+        }
+    });
+    hapi.route({
+        method: "GET",
+        path: "/api/{req}/{node}/{params*}",
+        options: {},
+        handler: (request, h) => {
+            const peer = request.info.remoteAddress;
+            const req = {
+                request: request.params.req,
+                node: request.params.node,
+                args: (request.params.params ?? "").split("/").filter((seg) => seg !== "")
+            };
+            cli.log("info", `HAPI: peer ${peer}: GET: ${JSON.stringify(req)}`);
+            return consumeExternalRequest(req).then(() => {
+                return h.response({ response: "OK" }).code(200);
+            }).catch((err) => {
+                return h.response({ response: "ERROR", data: err.message }).code(417);
+            });
+        }
+    });
+    hapi.route({
+        method: "POST",
+        path: "/api",
+        options: {
+            payload: {
+                output: "data",
+                parse: true,
+                allow: "application/json"
+            },
+            plugins: {
+                websocket: {
+                    autoping: 30 * 1000,
+                    connect: (args) => {
+                        const ctx = args.ctx;
+                        const ws = args.ws;
+                        const req = args.req;
+                        const peer = `${req.socket.remoteAddress}:${req.socket.remotePort}`;
+                        ctx.peer = peer;
+                        wsPeers.set(peer, { ctx, ws, req });
+                        cli.log("info", `HAPI: WebSocket: connect: peer ${peer}`);
+                    },
+                    disconnect: (args) => {
+                        const ctx = args.ctx;
+                        const peer = ctx.peer;
+                        wsPeers.delete(peer);
+                        cli.log("info", `HAPI: WebSocket: disconnect: peer ${peer}`);
+                    }
+                }
+            }
+        },
+        handler: (request, h) => {
+            /*  on WebSocket message transfer  */
+            const peer = request.info.remoteAddress;
+            const req = requestValidator(request.payload);
+            if (req instanceof arktype.type.errors)
+                return h.response({ response: "ERROR", data: `invalid request: ${req.summary}` }).code(417);
+            cli.log("info", `HAPI: peer ${peer}: POST: ${JSON.stringify(req)}`);
+            return consumeExternalRequest(req).then(() => {
+                return h.response({ response: "OK" }).code(200);
+            }).catch((err) => {
+                return h.response({ response: "ERROR", data: err.message }).code(417);
+            });
+        }
+    });
+    await hapi.start();
+    cli.log("info", `HAPI: started REST/WebSocket network service: http://${args.address}:${args.port}`);
+    /*  hook for sendResponse method of nodes  */
+    for (const node of graphNodes) {
+        node.on("send-response", (args) => {
+            const data = JSON.stringify({ response: "NOTIFY", node: node.id, args });
+            for (const [peer, info] of wsPeers.entries()) {
+                cli.log("info", `HAPI: peer ${peer}: ${data}`);
+                info.ws.send(data);
+            }
+        });
+    }
     /*  start of internal stream processing  */
     cli.log("info", "**** everything established -- stream processing in SpeechFlow graph starts ****");
     /*  gracefully shutdown process  */
@@ -389,6 +628,9 @@ let cli = null;
             cli.log("info", "**** streams of all nodes finished -- shutting down service ****");
         else
             cli.log("warning", `**** received signal ${signal} -- shutting down service ****`);
+        /*  shutdown HAPI service  */
+        cli.log("info", `HAPI: stopping REST/WebSocket network service: http://${args.address}:${args.port}`);
+        await hapi.stop();
         /*  graph processing: PASS 1: disconnect node streams  */
         for (const node of graphNodes) {
             if (node.stream === null) {
@@ -459,6 +701,7 @@ let cli = null;
     if (cli !== null)
         cli.log("error", err.message);
     else
-        process.stderr.write(`${package_json_1.default.name}: ERROR: ${err.message}\n`);
+        process.stderr.write(`${package_json_1.default.name}: ${chalk_1.default.red("ERROR")}: ${err.message} ${err.stack}\n`);
     process.exit(1);
 });
+//# sourceMappingURL=speechflow.js.map