speechflow 1.6.0 → 1.6.2

package/speechflow-cli/src/speechflow-main-nodes.ts

@@ -0,0 +1,61 @@
+/*
+**  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>
+*/
+
+/*  external dependencies  */
+import CLIio             from "cli-io"
+import installedPackages from "installed-packages"
+import { glob }          from "glob"
+
+/*  internal dependencies  */
+import SpeechFlowNode    from "./speechflow-node"
+
+/*  the node loader  */
+export class NodeRegistry {
+    public nodes: { [ id: string ]: typeof SpeechFlowNode } = {}
+
+    constructor (
+        private cli: CLIio
+    ) {}
+
+    /*  node internal and external SpeechFlow nodes  */
+    async load () {
+        /*  load internal SpeechFlow nodes  */
+        const pkgsI = await glob("speechflow-node-*-*.js", {
+            cwd: __dirname,
+            ignore: {
+                ignored: (p) => p.name.endsWith("-wt.js")
+            }
+        })
+        for (const pkg of pkgsI) {
+            let node: any = await import(`./${pkg}`)
+            while (node.default !== undefined)
+                node = node.default
+            if (typeof node === "function" && typeof node.name === "string") {
+                this.cli.log("info", `loading SpeechFlow node <${node.name}> from internal module`)
+                this.nodes[node.name] = node as typeof SpeechFlowNode
+            }
+        }
+
+        /*  load external SpeechFlow nodes  */
+        const pkgsE = await installedPackages()
+        for (const pkg of pkgsE) {
+            if (pkg.match(/^(?:@[^/]+\/)?speechflow-node-.+$/)) {
+                let node: any = await import(pkg)
+                while (node.default !== undefined)
+                    node = node.default
+                if (typeof node === "function" && typeof node.name === "string") {
+                    if (this.nodes[node.name] !== undefined) {
+                        this.cli.log("warning", `failed loading SpeechFlow node <${node.name}> ` +
+                            `from external module "${pkg}" -- node already exists`)
+                        continue
+                    }
+                    this.cli.log("info", `loading SpeechFlow node <${node.name}> from external module "${pkg}"`)
+                    this.nodes[node.name] = node as typeof SpeechFlowNode
+                }
+            }
+        }
+    }
+}

package/speechflow-cli/src/speechflow-main-status.ts

@@ -0,0 +1,70 @@
+/*
+**  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>
+*/
+
+/*  internal dependencies  */
+import { EventEmitter }      from "node:events"
+
+/*  external dependencies  */
+import CLIio                 from "cli-io"
+import Table                 from "cli-table3"
+import chalk                 from "chalk"
+
+/*  internal dependencies  */
+import SpeechFlowNode        from "./speechflow-node"
+import { NodeConfig }        from "./speechflow-main-config"
+
+/*  the node status manager  */
+export class NodeStatusManager {
+    constructor (
+        private cli: CLIio
+    ) {}
+
+    /*  gather and show status of all nodes  */
+    async showNodeStatus(
+        nodes:     { [ id: string ]: typeof SpeechFlowNode },
+        cfg:       NodeConfig,
+        accessBus: (name: string) => EventEmitter
+    ) {
+        /*  create CLI table  */
+        const table = new Table({
+            head: [
+                chalk.reset.bold("NODE"),
+                chalk.reset.bold("PROPERTY"),
+                chalk.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": "" }
+        })
+
+        /*  iterate over all nodes...  */
+        for (const name of Object.keys(nodes)) {
+            /*  instantiate node and query its status  */
+            this.cli.log("info", `gathering status of node <${name}>`)
+            const node = new nodes[name](name, cfg, {}, [])
+            node._accessBus = accessBus
+            const status = await Promise.race<{ [ key: string ]: string | number }>([
+                node.status(),
+                new Promise<never>((resolve, reject) => setTimeout(() =>
+                    reject(new Error("timeout")), 10 * 1000))
+            ]).catch((err: Error) => {
+                this.cli.log("warning", `[${node.id}]: failed to gather status of node <${node.id}>: ${err.message}`)
+                return {} as { [ key: string ]: string | number }
+            })
+
+            /*  render output as a table row  */
+            if (Object.keys(status).length > 0) {
+                let first = true
+                for (const key of Object.keys(status)) {
+                    table.push([ first ? chalk.bold(name) : "", key, chalk.blue(status[key]) ])
+                    first = false
+                }
+            }
+        }
+        const output = table.toString()
+        process.stdout.write(output + "\n")
+    }
+}

package/speechflow-cli/src/speechflow-main.ts

@@ -0,0 +1,106 @@
+/*
+**  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>
+*/
+
+/*  standard dependencies  */
+import { EventEmitter }       from "node:events"
+
+/*  internal dependencies  */
+import { CLIContext }         from "./speechflow-main-cli"
+import { NodeConfig }         from "./speechflow-main-config"
+import { NodeRegistry }       from "./speechflow-main-nodes"
+import { NodeStatusManager }  from "./speechflow-main-status"
+import { NodeGraph }          from "./speechflow-main-graph"
+import { APIServer }          from "./speechflow-main-api"
+import * as util              from "./speechflow-util"
+
+/*  class of main procedure  */
+export default class Main {
+    /*  static entry point  */
+    static main () {
+        /*  create CLI environment  */
+        const cli = new CLIContext()
+
+        /*  early catch and handle uncaught exceptions (will be replaced later)  */
+        process.on("uncaughtException", (err) => {
+            const error = util.ensureError(err, "uncaught exception")
+            cli.handleTopLevelError(error)
+        })
+
+        /*  early catch and handle unhandled promise rejections (will be replaced later)  */
+        process.on("unhandledRejection", (reason) => {
+            const error = util.ensureError(reason, "unhandled promise rejection")
+            cli.handleTopLevelError(error)
+        })
+
+        /*  instantiate ourself  */
+        const main = new Main(cli)
+        main.run().catch((err) => {
+            /*  handle errors at the top-level  */
+            const error = util.ensureError(err, "top-level error")
+            cli.handleTopLevelError(error)
+        })
+    }
+
+    /*  simple constructor  */
+    constructor (
+        private cli: CLIContext
+    ) {}
+
+    /*  effective main procedure  */
+    async run () {
+        /*  initialize CLI context  */
+        await this.cli.init()
+        if (!this.cli.isInitialized())
+            throw new Error("CLI context initialization failed")
+        const { cli, args, config, debug } = this.cli
+
+        /*  load nodes  */
+        const nodes = new NodeRegistry(cli)
+        await nodes.load()
+
+        /*  define static read-only configuration  */
+        const cfg = new NodeConfig()
+        cfg.cacheDir = args.C
+
+        /*  provide access to internal communication busses  */
+        const busses = new Map<string, EventEmitter>()
+        const accessBus = (name: string): EventEmitter => {
+            let bus = busses.get(name)
+            if (bus === undefined) {
+                bus = new EventEmitter()
+                busses.set(name, bus)
+            }
+            return bus
+        }
+
+        /*  handle one-time status query of nodes  */
+        if (args.S) {
+            const statusManager = new NodeStatusManager(cli)
+            await statusManager.showNodeStatus(nodes.nodes, cfg, accessBus)
+            process.exit(0)
+        }
+
+        /*  initialize graph processor  */
+        const graph = new NodeGraph(cli, debug)
+
+        /*  create and connect nodes into a graph  */
+        const variables = { argv: args._, env: process.env }
+        await graph.createAndConnectNodes(config, nodes.nodes, cfg, variables, accessBus)
+        await graph.pruneConnections()
+
+        /*  open nodes and connect streams  */
+        await graph.openNodes()
+        await graph.connectStreams()
+
+        /*  initialize API server  */
+        const api = new APIServer(cli)
+        await api.start(args, graph)
+
+        /*  setup signal handlers and track stream finishing  */
+        graph.setupSignalHandlers(args, api)
+        graph.trackFinishing(args, api)
+    }
+}

package/speechflow-cli/src/speechflow-node-a2a-compressor-wt.ts

@@ -4,7 +4,7 @@
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 
-import * as utils from "./speechflow-utils"
+import * as util from "./speechflow-util"
 
 /*  downward compressor with soft knee  */
 class CompressorProcessor extends AudioWorkletProcessor {
@@ -124,14 +124,14 @@ class CompressorProcessor extends AudioWorkletProcessor {
             this.updateEnvelopeForChannel(ch, input[ch], attackS, releaseS)
 
         /*  determine linear value from decibel makeup value */
-        const makeUpLin = utils.dB2lin(makeupDB)
+        const makeUpLin = util.dB2lin(makeupDB)
 
         /*  iterate over all channels  */
         this.reduction = 0
         for (let ch = 0; ch < nCh; ch++) {
-            const levelDB = utils.lin2dB(this.env[ch])
+            const levelDB = util.lin2dB(this.env[ch])
             const gainDB  = this.gainDBFor(levelDB, thresholdDB, ratio, kneeDB)
-            const gainLin = utils.dB2lin(gainDB) * makeUpLin
+            const gainLin = util.dB2lin(gainDB) * makeUpLin
 
             /*  on first channel, calculate reduction  */
             if (ch === 0)

package/speechflow-cli/src/speechflow-node-a2a-compressor.ts

@@ -14,8 +14,7 @@ import { GainNode, AudioWorkletNode } from "node-web-audio-api"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
-import { WebAudio }                        from "./speechflow-utils-audio"
+import * as util                           from "./speechflow-util"
 
 /*  internal types  */
 interface AudioCompressorConfig {
@@ -28,7 +27,7 @@ interface AudioCompressorConfig {
 }
 
 /*  audio compressor class  */
-class AudioCompressor extends WebAudio {
+class AudioCompressor extends util.WebAudio {
     /*  internal state  */
     private type:              "standalone" | "sidechain"
     private mode:              "compress" | "measure" | "adjust"
@@ -243,20 +242,20 @@ export default class SpeechFlowNodeA2ACompressor extends SpeechFlowNode {
                     callback(new Error("invalid chunk payload type"))
                 else {
                     /*  compress chunk  */
-                    const payload = utils.convertBufToI16(chunk.payload)
+                    const payload = util.convertBufToI16(chunk.payload)
                     self.compressor?.process(payload).then((result) => {
                         if (self.destroyed)
                             throw new Error("stream already destroyed")
                         if ((self.params.type === "standalone" && self.params.mode === "compress") ||
                             (self.params.type === "sidechain"  && self.params.mode === "adjust")     ) {
                             /*  take over compressed data  */
-                            const payload = utils.convertI16ToBuf(result)
+                            const payload = util.convertI16ToBuf(result)
                             chunk.payload = payload
                         }
                         this.push(chunk)
                         callback()
                     }).catch((error: unknown) => {
-                        callback(utils.ensureError(error, "compression failed"))
+                        callback(util.ensureError(error, "compression failed"))
                     })
                 }
             },

package/speechflow-cli/src/speechflow-node-a2a-expander-wt.ts

@@ -4,7 +4,7 @@
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 
-import * as utils from "./speechflow-utils"
+import * as util from "./speechflow-util"
 
 /*  downward expander with soft knee  */
 class ExpanderProcessor extends AudioWorkletProcessor {
@@ -129,19 +129,19 @@ class ExpanderProcessor extends AudioWorkletProcessor {
             this.updateEnvelopeForChannel(ch, input[ch], attackS, releaseS)
 
         /*  determine linear value from decibel makeup value */
-        const makeUpLin = utils.dB2lin(makeupDB)
+        const makeUpLin = util.dB2lin(makeupDB)
 
         /*  iterate over all channels  */
         for (let ch = 0; ch < nCh; ch++) {
-            const levelDB = utils.lin2dB(this.env[ch])
+            const levelDB = util.lin2dB(this.env[ch])
             const gainDB  = this.gainDBFor(levelDB, thresholdDB, ratio, kneeDB)
-            let gainLin = utils.dB2lin(gainDB) * makeUpLin
+            let gainLin = util.dB2lin(gainDB) * makeUpLin
 
             /*  do not attenuate below floor  */
             const expectedOutLevelDB = levelDB + gainDB + makeupDB
             if (expectedOutLevelDB < floorDB) {
                 const neededLiftDB = floorDB - expectedOutLevelDB
-                gainLin /= utils.dB2lin(neededLiftDB)
+                gainLin /= util.dB2lin(neededLiftDB)
             }
 
             /*  apply gain change to channel  */

package/speechflow-cli/src/speechflow-node-a2a-expander.ts

@@ -13,8 +13,7 @@ import { AudioWorkletNode } from "node-web-audio-api"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
-import { WebAudio }                        from "./speechflow-utils-audio"
+import * as util                           from "./speechflow-util"
 
 /*  internal types  */
 interface AudioExpanderConfig {
@@ -28,7 +27,7 @@ interface AudioExpanderConfig {
 }
 
 /*  audio noise expander class  */
-class AudioExpander extends WebAudio {
+class AudioExpander extends util.WebAudio {
     /*  internal state  */
     private config:       Required<AudioExpanderConfig>
     private expanderNode: AudioWorkletNode | null = null
@@ -166,18 +165,18 @@ export default class SpeechFlowNodeA2AExpander extends SpeechFlowNode {
                     callback(new Error("invalid chunk payload type"))
                 else {
                     /*  expand chunk  */
-                    const payload = utils.convertBufToI16(chunk.payload)
+                    const payload = util.convertBufToI16(chunk.payload)
                     self.expander?.process(payload).then((result) => {
                         if (self.destroyed)
                             throw new Error("stream already destroyed")
 
                         /*  take over expanded data  */
-                        const payload = utils.convertI16ToBuf(result)
+                        const payload = util.convertI16ToBuf(result)
                         chunk.payload = payload
                         this.push(chunk)
                         callback()
                     }).catch((error: unknown) => {
-                        callback(utils.ensureError(error, "expansion failed"))
+                        callback(util.ensureError(error, "expansion failed"))
                     })
                 }
             },

package/speechflow-cli/src/speechflow-node-a2a-ffmpeg.ts

@@ -13,7 +13,7 @@ import { Converter as FFmpegStream } from "ffmpeg-stream"
 
 /*  internal dependencies  */
 import SpeechFlowNode                from "./speechflow-node"
-import * as utils                    from "./speechflow-utils"
+import * as util                     from "./speechflow-util"
 
 /*  SpeechFlow node for FFmpeg  */
 export default class SpeechFlowNodeA2AFFMPEG extends SpeechFlowNode {
@@ -90,7 +90,7 @@ export default class SpeechFlowNodeA2AFFMPEG extends SpeechFlowNode {
                 "f":           "opus"
             } : {})
         })
-        utils.run("starting FFmpeg process", () => this.ffmpeg!.run())
+        util.run("starting FFmpeg process", () => this.ffmpeg!.run())
 
         /*  establish a duplex stream and connect it to FFmpeg  */
         this.stream = Stream.Duplex.from({
@@ -99,8 +99,8 @@ export default class SpeechFlowNodeA2AFFMPEG extends SpeechFlowNode {
         })
 
         /*  wrap streams with conversions for chunk vs plain audio  */
-        const wrapper1 = utils.createTransformStreamForWritableSide()
-        const wrapper2 = utils.createTransformStreamForReadableSide("audio", () => this.timeZero)
+        const wrapper1 = util.createTransformStreamForWritableSide()
+        const wrapper2 = util.createTransformStreamForReadableSide("audio", () => this.timeZero)
         this.stream = Stream.compose(wrapper1, this.stream, wrapper2)
     }
 
@@ -120,7 +120,7 @@ export default class SpeechFlowNodeA2AFFMPEG extends SpeechFlowNode {
 
         /*  shutdown FFmpeg  */
         if (this.ffmpeg !== null) {
-            utils.run(() => this.ffmpeg!.kill(), () => {})
+            util.run(() => this.ffmpeg!.kill(), () => {})
             this.ffmpeg = null
         }
     }

package/speechflow-cli/src/speechflow-node-a2a-filler.ts

@@ -11,7 +11,7 @@ import { Duration }     from "luxon"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 class AudioFiller extends EventEmitter {
     private emittedEndSamples = 0           /* stream position in samples already emitted */
@@ -111,7 +111,7 @@ export default class SpeechFlowNodeA2AFiller extends SpeechFlowNode {
     /*  internal state  */
     private destroyed = false
     private filler: AudioFiller | null = null
-    private sendQueue: utils.AsyncQueue<SpeechFlowChunk | null> | null = null
+    private sendQueue: util.AsyncQueue<SpeechFlowChunk | null> | null = null
 
     /*  construct node  */
     constructor (id: string, cfg: { [ id: string ]: any }, opts: { [ id: string ]: any }, args: any[]) {
@@ -134,7 +134,7 @@ export default class SpeechFlowNodeA2AFiller extends SpeechFlowNode {
 
         /*  establish queues  */
         this.filler  = new AudioFiller(this.config.audioSampleRate, this.config.audioChannels)
-        this.sendQueue = new utils.AsyncQueue<SpeechFlowChunk | null>()
+        this.sendQueue = new util.AsyncQueue<SpeechFlowChunk | null>()
 
         /*  shift chunks from filler to send queue  */
         this.filler.on("chunk", (chunk) => {
@@ -182,7 +182,7 @@ export default class SpeechFlowNodeA2AFiller extends SpeechFlowNode {
                     }
                 }).catch((error: unknown) => {
                     if (!self.destroyed)
-                        self.log("error", `queue read error: ${utils.ensureError(error).message}`)
+                        self.log("error", `queue read error: ${util.ensureError(error).message}`)
                 })
             },
             final (callback) {

package/speechflow-cli/src/speechflow-node-a2a-gain.ts

@@ -9,7 +9,7 @@ import Stream from "node:stream"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  SpeechFlow node for gain adjustment in audio-to-audio passing  */
 export default class SpeechFlowNodeA2AGain extends SpeechFlowNode {
@@ -41,7 +41,7 @@ export default class SpeechFlowNodeA2AGain extends SpeechFlowNode {
         /*  adjust gain  */
         const adjustGain = (chunk: SpeechFlowChunk & { payload: Buffer }, db: number) => {
             const dv = new DataView(chunk.payload.buffer, chunk.payload.byteOffset, chunk.payload.byteLength)
-            const gainFactor = utils.dB2lin(db)
+            const gainFactor = util.dB2lin(db)
             for (let i = 0; i < dv.byteLength; i += 2) {
                 let sample = dv.getInt16(i, true)
                 sample *= gainFactor

package/speechflow-cli/src/speechflow-node-a2a-gender.ts

@@ -14,7 +14,7 @@ import { WaveFile }       from "wavefile"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  audio stream queue element */
 type AudioQueueElement = {
@@ -33,7 +33,7 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
 
     /*  internal state  */
     private classifier: Transformers.AudioClassificationPipeline | null = null
-    private queue     = new utils.Queue<AudioQueueElement>()
+    private queue     = new util.Queue<AudioQueueElement>()
     private queueRecv = this.queue.pointerUse("recv")
     private queueAC   = this.queue.pointerUse("ac")
     private queueSend = this.queue.pointerUse("send")
@@ -247,7 +247,7 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
                 else {
                     try {
                         /*  convert audio samples from PCM/I16/48KHz to PCM/F32/16KHz  */
-                        let data = utils.convertBufToF32(chunk.payload, self.config.audioLittleEndian)
+                        let data = util.convertBufToF32(chunk.payload, self.config.audioLittleEndian)
                         const wav = new WaveFile()
                         wav.fromScratch(self.config.audioChannels, self.config.audioSampleRate, "32f", data)
                         wav.toSampleRate(sampleRateTarget, { method: "cubic" })
@@ -305,7 +305,7 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
                             else if (element.type === "audio-frame"
                                 && element.gender === undefined)
                                 break
-                            const duration = utils.audioArrayDuration(element.data)
+                            const duration = util.audioArrayDuration(element.data)
                             log("debug", `send chunk (${duration.toFixed(3)}s) with gender <${element.gender}>`)
                             element.chunk.meta.set("gender", element.gender)
                             this.push(element.chunk)

package/speechflow-cli/src/speechflow-node-a2a-meter.ts

@@ -12,7 +12,7 @@ import { getLUFS, getRMS, AudioData } from "audio-inspect"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  SpeechFlow node for audio metering  */
 export default class SpeechFlowNodeA2AMeter extends SpeechFlowNode {
@@ -141,7 +141,7 @@ export default class SpeechFlowNodeA2AMeter extends SpeechFlowNode {
                 else {
                     try {
                         /*  convert audio samples from PCM/I16 to PCM/F32  */
-                        const data = utils.convertBufToF32(chunk.payload, self.config.audioLittleEndian)
+                        const data = util.convertBufToF32(chunk.payload, self.config.audioLittleEndian)
 
                         /*  append new data to buffer  */
                         const combinedLength = self.chunkBuffer.length + data.length

package/speechflow-cli/src/speechflow-node-a2a-rnnoise.ts

@@ -11,7 +11,7 @@ import { resolve }          from "node:path"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  SpeechFlow node for RNNoise based noise suppression in audio-to-audio passing  */
 export default class SpeechFlowNodeA2ARNNoise extends SpeechFlowNode {
@@ -112,14 +112,14 @@ export default class SpeechFlowNodeA2ARNNoise extends SpeechFlowNode {
                     callback(new Error("invalid chunk payload type"))
                 else {
                     /*  convert Buffer into Int16Array  */
-                    const payload = utils.convertBufToI16(chunk.payload)
+                    const payload = util.convertBufToI16(chunk.payload)
 
                     /*  process Int16Array in necessary segments  */
-                    utils.processInt16ArrayInSegments(payload, self.sampleSize, (segment) =>
+                    util.processInt16ArrayInSegments(payload, self.sampleSize, (segment) =>
                         workerProcessSegment(segment)
                     ).then((payload: Int16Array<ArrayBuffer>) => {
                         /*  convert Int16Array into Buffer  */
-                        const buf = utils.convertI16ToBuf(payload)
+                        const buf = util.convertI16ToBuf(payload)
 
                         /*  update chunk  */
                         chunk.payload = buf

package/speechflow-cli/src/speechflow-node-a2a-speex.ts

@@ -14,7 +14,7 @@ import { loadSpeexModule, SpeexPreprocessor } from "@sapphi-red/speex-preprocess
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  SpeechFlow node for Speex based noise suppression in audio-to-audio passing  */
 export default class SpeechFlowNodeA2ASpeex extends SpeechFlowNode {
@@ -79,10 +79,10 @@ export default class SpeechFlowNodeA2ASpeex extends SpeechFlowNode {
                     callback(new Error("invalid chunk payload type"))
                 else {
                     /*  convert Buffer into Int16Array  */
-                    const payload = utils.convertBufToI16(chunk.payload)
+                    const payload = util.convertBufToI16(chunk.payload)
 
                     /*  process Int16Array in necessary fixed-size segments  */
-                    utils.processInt16ArrayInSegments(payload, self.sampleSize, (segment) => {
+                    util.processInt16ArrayInSegments(payload, self.sampleSize, (segment) => {
                         if (self.destroyed)
                             throw new Error("stream already destroyed")
                         self.speexProcessor?.processInt16(segment)
@@ -92,7 +92,7 @@ export default class SpeechFlowNodeA2ASpeex extends SpeechFlowNode {
                             throw new Error("stream already destroyed")
 
                         /*  convert Int16Array back into Buffer  */
-                        const buf = utils.convertI16ToBuf(payload)
+                        const buf = util.convertI16ToBuf(payload)
 
                         /*  update chunk  */
                         chunk.payload = buf

package/speechflow-cli/src/speechflow-node-a2a-vad.ts

@@ -12,7 +12,7 @@ import { RealTimeVAD }    from "@ericedouard/vad-node-realtime"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  audio stream queue element */
 type AudioQueueElementSegment = {
@@ -36,7 +36,7 @@ export default class SpeechFlowNodeA2AVAD extends SpeechFlowNode {
 
     /*  internal state  */
     private vad: RealTimeVAD | null = null
-    private queue     = new utils.Queue<AudioQueueElement>()
+    private queue     = new util.Queue<AudioQueueElement>()
     private queueRecv = this.queue.pointerUse("recv")
     private queueVAD  = this.queue.pointerUse("vad")
     private queueSend = this.queue.pointerUse("send")
@@ -109,7 +109,7 @@ export default class SpeechFlowNodeA2AVAD extends SpeechFlowNode {
                 onSpeechEnd: (audio) => {
                     if (this.destroyed)
                         return
-                    const duration = utils.audioArrayDuration(audio, vadSampleRateTarget)
+                    const duration = util.audioArrayDuration(audio, vadSampleRateTarget)
                     this.log("info", `VAD: speech end (duration: ${duration.toFixed(2)}s)`)
                     if (this.params.mode === "unplugged") {
                         tail = true
@@ -189,7 +189,7 @@ export default class SpeechFlowNodeA2AVAD extends SpeechFlowNode {
                 else {
                     try {
                         /*  convert audio samples from PCM/I16 to PCM/F32  */
-                        const data = utils.convertBufToF32(chunk.payload,
+                        const data = util.convertBufToF32(chunk.payload,
                             self.config.audioLittleEndian)
 
                         /*  segment audio samples as individual VAD-sized frames  */