speechflow 2.2.0 → 2.3.0

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

@@ -1,6 +1,6 @@
 /*
 **  SpeechFlow - Speech Processing Flow Graph
-**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2024-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 
@@ -171,10 +171,13 @@ export class NodeGraph {
             /*  open node  */
             this.cli.log("info", `open node <${node.id}>`)
             node.setTimeZero(this.timeZero)
+            const ac = new AbortController()
             await Promise.race([
                 node.open(),
-                util.timeout(30 * 1000)
-            ]).catch((err: Error) => {
+                util.timeout(30 * 1000, "timeout", ac.signal)
+            ]).finally(() => {
+                ac.abort()
+            }).catch((err: Error) => {
                 this.cli.log("error", `<${node.id}>: failed to open node <${node.id}>: ${err.message}`)
                 throw new Error(`failed to open node <${node.id}>: ${err.message}`)
             })
@@ -211,8 +214,9 @@ export class NodeGraph {
             this.cli.log("info", `observe stream of node <${node.id}> for finish event`)
             this.activeNodes.add(node)
             const deactivateNode = (node: SpeechFlowNode, msg: string) => {
-                if (this.activeNodes.has(node))
-                    this.activeNodes.delete(node)
+                if (!this.activeNodes.has(node))
+                    return
+                this.activeNodes.delete(node)
                 this.cli.log("info", `${msg} (${this.activeNodes.size} active nodes remaining)`)
                 if (this.activeNodes.size === 0) {
                     const timeFinished = DateTime.now()
@@ -220,7 +224,9 @@ export class NodeGraph {
                     this.cli.log("info", "**** everything finished -- stream processing in SpeechFlow graph stops " +
                         `(total duration: ${duration?.toFormat("hh:mm:ss.SSS") ?? "unknown"}) ****`)
                     this.finishEvents.emit("finished")
-                    this.shutdown("finished", args, api)
+                    this.shutdown("finished", args, api).catch((err: Error) => {
+                        this.cli.log("error", `failed to shutdown: ${err.message}`)
+                    })
                 }
             }
             node.stream.on("error", (err: unknown) => {
@@ -228,12 +234,26 @@ export class NodeGraph {
                 this.cli.log("warning", `stream of node <${node.id}> raised "error" event: ${error.message}`)
                 api.sendErrorToDashboard(Date.now(), node.id, "warning", error.message)
             })
-            node.stream.on("finish", () => {
-                deactivateNode(node, `writable stream side (input) of node <${node.id}> raised "finish" event`)
-            })
-            node.stream.on("end", () => {
-                deactivateNode(node, `readable stream side (output) of node <${node.id}> raised "end" event`)
-            })
+
+            /*  listen for the semantically correct completion event per stream type:
+                - for Duplex/Transform listen only for "end"
+                  (readable-side, fires last, guarantees all output is drained),
+                - for pure Readable listen only for "end"
+                - for pure Writable listen only for "finish"  */
+            if (node.stream instanceof Stream.Duplex)
+                node.stream.on("end", () => {
+                    deactivateNode(node, `readable stream side (output) of node <${node.id}> raised "end" event`)
+                })
+            else if (node.stream instanceof Stream.Readable)
+                node.stream.on("end", () => {
+                    deactivateNode(node, `readable stream side (output) of node <${node.id}> raised "end" event`)
+                })
+            else if (node.stream instanceof Stream.Writable)
+                node.stream.on("finish", () => {
+                    deactivateNode(node, `writable stream side (input) of node <${node.id}> raised "finish" event`)
+                })
+            else
+                throw new Error(`stream of node <${node.id}> is neither of Duplex, Writable, nor Readable type`)
         }
 
         /*  start of internal stream processing  */
@@ -250,13 +270,16 @@ export class NodeGraph {
             const stream = node.stream
             if ((stream instanceof Stream.Writable || stream instanceof Stream.Duplex)
                 && (!stream.writableEnded && !stream.destroyed)) {
+                const ac = new AbortController()
                 drainPromises.push(
                     Promise.race([
                         new Promise<void>((resolve) => {
                             stream.end(() => { resolve() })
                         }),
-                        util.timeout(5000)
-                    ]).catch(() => {
+                        util.timeout(5000, "timeout", ac.signal)
+                    ]).finally(() => {
+                        ac.abort()
+                    }).catch(() => {
                         /*  ignore timeout -- stream will be destroyed later  */
                     })
                 )
@@ -297,10 +320,13 @@ export class NodeGraph {
     async closeNodes (): Promise<void> {
         for (const node of this.graphNodes) {
             this.cli.log("info", `close node <${node.id}>`)
+            const ac = new AbortController()
             await Promise.race([
                 node.close(),
-                util.timeout(10 * 1000)
-            ]).catch((err: Error) => {
+                util.timeout(10 * 1000, "timeout", ac.signal)
+            ]).finally(() => {
+                ac.abort()
+            }).catch((err: Error) => {
                 this.cli.log("warning", `node <${node.id}> failed to close: ${err.message}`)
             })
         }
@@ -319,25 +345,33 @@ export class NodeGraph {
 
     /*  graph destruction: PASS 5: destroy nodes  */
     destroyNodes (): void {
-        for (const node of this.graphNodes) {
+        for (const node of this.graphNodes)
             this.cli.log("info", `destroy node <${node.id}>`)
-            this.graphNodes.delete(node)
-        }
+        this.graphNodes.clear()
     }
 
     /*  setup signal handling for shutdown  */
     setupSignalHandlers (args: CLIOptions, api: APIServer): void {
         /*  internal helper functions  */
-        const shutdownHandler = (signal: string) =>
-            this.shutdown(signal, args, api)
         const logError = (error: Error) => {
             if (this.debug)
                 this.cli.log("error", `${error.message}\n${error.stack}`)
             else
                 this.cli.log("error", error.message)
         }
+        const shutdownHandler = (signal: string) => {
+            this.shutdown(signal, args, api).catch((err: unknown) => {
+                const error = util.ensureError(err, "shutdown error")
+                logError(error)
+                process.exit(1)
+            })
+        }
 
-        /*  hook into process signals  */
+        /*  re-hook into process signals  */
+        process.removeAllListeners("SIGINT")
+        process.removeAllListeners("SIGUSR1")
+        process.removeAllListeners("SIGUSR2")
+        process.removeAllListeners("SIGTERM")
         process.on("SIGINT",  () => { shutdownHandler("SIGINT")   })
         process.on("SIGUSR1", () => { shutdownHandler("SIGUSR1")  })
         process.on("SIGUSR2", () => { shutdownHandler("SIGUSR2")  })

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

@@ -1,6 +1,6 @@
 /*
 **  SpeechFlow - Speech Processing Flow Graph
-**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2024-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 

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

@@ -1,6 +1,6 @@
 /*
 **  SpeechFlow - Speech Processing Flow Graph
-**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2024-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 
@@ -47,10 +47,13 @@ export class NodeStatusManager {
             this.cli.log("info", `gathering status of node <${name}>`)
             const node = new nodes[name](name, cfg, {}, [])
             node._accessBus = accessBus
+            const ac = new AbortController()
             const status = await Promise.race<{ [ key: string ]: string | number }>([
                 node.status(),
-                util.timeout(10 * 1000)
-            ]).catch((err: Error) => {
+                util.timeout(10 * 1000, "timeout", ac.signal)
+            ]).finally(() => {
+                ac.abort()
+            }).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 }
             })

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

@@ -1,6 +1,6 @@
 /*
 **  SpeechFlow - Speech Processing Flow Graph
-**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2024-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 

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

@@ -1,6 +1,6 @@
 /*
 **  SpeechFlow - Speech Processing Flow Graph
-**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2024-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 
@@ -21,8 +21,7 @@ class CompressorProcessor extends AudioWorkletProcessor {
             { name: "ratio",      defaultValue: 4.0,   minValue: 1.0,    maxValue: 20,  automationRate: "k-rate" }, // compression ratio
             { name: "attack",     defaultValue: 0.010, minValue: 0.0,    maxValue: 1,   automationRate: "k-rate" }, // seconds
             { name: "release",    defaultValue: 0.050, minValue: 0.0,    maxValue: 1,   automationRate: "k-rate" }, // seconds
-            { name: "knee",       defaultValue: 6.0,   minValue: 0.0,    maxValue: 40,  automationRate: "k-rate" }, // dB
-            { name: "makeup",     defaultValue: 0.0,   minValue: -24,    maxValue: 24,  automationRate: "k-rate" }  // dB
+            { name: "knee",       defaultValue: 6.0,   minValue: 0.0,    maxValue: 40,  automationRate: "k-rate" }  // dB
         ]
     }
 
@@ -94,21 +93,18 @@ class CompressorProcessor extends AudioWorkletProcessor {
         const kneeDB      = parameters["knee"][0]
         const attackS     = Math.max(parameters["attack"][0],  1 / this.sampleRate)
         const releaseS    = Math.max(parameters["release"][0], 1 / this.sampleRate)
-        const makeupDB    = parameters["makeup"][0]
 
-        /*  update envelope per channel  */
+        /*  update envelope per channel and collect RMS values  */
+        const rms = Array.from<number>({ length: nCh })
         for (let ch = 0; ch < nCh; ch++)
-            this.env[ch] = util.updateEnvelopeForChannel(this.env, this.sampleRate, ch, input[ch], attackS, releaseS)
-
-        /*  determine linear value from decibel makeup value */
-        const makeUpLin = util.dB2lin(makeupDB)
+            rms[ch] = util.updateEnvelopeForChannel(this.env, this.sampleRate, ch, input[ch], attackS, releaseS)
 
         /*  iterate over all channels  */
         this.reduction = 0
         for (let ch = 0; ch < nCh; ch++) {
-            const levelDB = util.lin2dB(this.env[ch])
+            const levelDB = util.lin2dB(rms[ch])
             const gainDB  = this.gainDBFor(levelDB, thresholdDB, ratio, kneeDB)
-            const gainLin = util.dB2lin(gainDB) * makeUpLin
+            const gainLin = util.dB2lin(gainDB)
 
             /*  on first channel, calculate reduction  */
             if (ch === 0)

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

@@ -1,6 +1,6 @@
 /*
 **  SpeechFlow - Speech Processing Flow Graph
-**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2024-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 
@@ -112,7 +112,6 @@ class AudioCompressor extends util.WebAudio {
             params.get("attack")!.setValueAtTime(this.config.attackMs / 1000, currentTime)
             params.get("release")!.setValueAtTime(this.config.releaseMs / 1000, currentTime)
             params.get("knee")!.setValueAtTime(this.config.kneeDb, currentTime)
-            params.get("makeup")!.setValueAtTime(this.config.makeupDb, currentTime)
         }
 
         /*  configure gain node  */
@@ -244,7 +243,7 @@ export default class SpeechFlowNodeA2ACompressor extends SpeechFlowNode {
                     callback(new Error("compressor not initialized"))
                 else {
                     /*  compress chunk  */
-                    const payload = util.convertBufToI16(chunk.payload)
+                    const payload = util.convertBufToI16(chunk.payload, self.config.audioLittleEndian)
                     self.compressor.process(payload).then((result) => {
                         if (self.closing) {
                             callback(new Error("stream already destroyed"))
@@ -253,10 +252,13 @@ export default class SpeechFlowNodeA2ACompressor extends SpeechFlowNode {
                         if ((self.params.type === "standalone" && self.params.mode === "compress")
                             || (self.params.type === "sidechain"  && self.params.mode === "adjust")) {
                             /*  take over compressed data  */
-                            const payload = util.convertI16ToBuf(result)
-                            chunk.payload = payload
+                            const payload = util.convertI16ToBuf(result, self.config.audioLittleEndian)
+                            const chunkNew = chunk.clone()
+                            chunkNew.payload = payload
+                            this.push(chunkNew)
                         }
-                        this.push(chunk)
+                        else
+                            this.push(chunk)
                         callback()
                     }).catch((error: unknown) => {
                         if (self.closing)

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

@@ -1,6 +1,6 @@
 /*
 **  SpeechFlow - Speech Processing Flow Graph
-**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2024-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 
@@ -56,7 +56,7 @@ class ExpanderProcessor extends AudioWorkletProcessor {
         }
 
         /*  determine target level  */
-        const targetOut = thresholdDB + (levelDB - thresholdDB) / ratio
+        const targetOut = thresholdDB + (levelDB - thresholdDB) * ratio
 
         /*  return gain difference  */
         return targetOut - levelDB
@@ -97,16 +97,17 @@ class ExpanderProcessor extends AudioWorkletProcessor {
         const releaseS    = Math.max(parameters["release"][0], 1 / this.sampleRate)
         const makeupDB    = parameters["makeup"][0]
 
-        /*  update envelope per channel  */
+        /*  update envelope per channel and collect RMS values  */
+        const rms = Array.from<number>({ length: nCh })
         for (let ch = 0; ch < nCh; ch++)
-            this.env[ch] = util.updateEnvelopeForChannel(this.env, this.sampleRate, ch, input[ch], attackS, releaseS)
+            rms[ch] = util.updateEnvelopeForChannel(this.env, this.sampleRate, ch, input[ch], attackS, releaseS)
 
         /*  determine linear value from decibel makeup value */
         const makeUpLin = util.dB2lin(makeupDB)
 
         /*  iterate over all channels  */
         for (let ch = 0; ch < nCh; ch++) {
-            const levelDB = util.lin2dB(this.env[ch])
+            const levelDB = util.lin2dB(rms[ch])
             const gainDB  = this.gainDBFor(levelDB, thresholdDB, ratio, kneeDB)
             let gainLin = util.dB2lin(gainDB) * makeUpLin
 
@@ -117,6 +118,10 @@ class ExpanderProcessor extends AudioWorkletProcessor {
                 gainLin *= util.dB2lin(neededLiftDB)
             }
 
+            /*  guard against IEEE 754 edge case (0 * Infinity = NaN on silence)  */
+            if (!Number.isFinite(gainLin))
+                gainLin = 0
+
             /*  apply gain change to channel  */
             const inp = input[ch]
             const out = output[ch]

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

@@ -1,6 +1,6 @@
 /*
 **  SpeechFlow - Speech Processing Flow Graph
-**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2024-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 
@@ -168,7 +168,7 @@ export default class SpeechFlowNodeA2AExpander extends SpeechFlowNode {
                     callback(new Error("expander not initialized"))
                 else {
                     /*  expand chunk  */
-                    const payload = util.convertBufToI16(chunk.payload)
+                    const payload = util.convertBufToI16(chunk.payload, self.config.audioLittleEndian)
                     self.expander.process(payload).then((result) => {
                         if (self.closing) {
                             callback(new Error("stream already destroyed"))
@@ -176,9 +176,10 @@ export default class SpeechFlowNodeA2AExpander extends SpeechFlowNode {
                         }
 
                         /*  take over expanded data  */
-                        const payload = util.convertI16ToBuf(result)
-                        chunk.payload = payload
-                        this.push(chunk)
+                        const payload = util.convertI16ToBuf(result, self.config.audioLittleEndian)
+                        const chunkNew = chunk.clone()
+                        chunkNew.payload = payload
+                        this.push(chunkNew)
                         callback()
                     }).catch((error: unknown) => {
                         if (self.closing)

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

@@ -1,6 +1,6 @@
 /*
 **  SpeechFlow - Speech Processing Flow Graph
-**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2024-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 
@@ -100,7 +100,8 @@ export default class SpeechFlowNodeA2AFFMPEG extends SpeechFlowNode {
 
         /*  wrap streams with conversions for chunk vs plain audio  */
         const wrapper1 = util.createTransformStreamForWritableSide("audio", 1)
-        const wrapper2 = util.createTransformStreamForReadableSide("audio", () => this.timeZero)
+        const wrapper2 = util.createTransformStreamForReadableSide("audio", () => this.timeZero, undefined,
+            this.config.audioSampleRate, this.config.audioBitDepth, this.config.audioChannels)
         this.stream = Stream.compose(wrapper1, ffmpegStream, wrapper2)
     }
 

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

@@ -1,6 +1,6 @@
 /*
 **  SpeechFlow - Speech Processing Flow Graph
-**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2024-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 
@@ -221,10 +221,8 @@ export default class SpeechFlowNodeA2AFiller extends SpeechFlowNode {
                         self.log("info", "received EOF signal")
                         this.push(null)
                     }
-                    else if (!(chunk.payload instanceof Buffer)) {
+                    else if (!Buffer.isBuffer(chunk.payload))
                         self.log("warning", "invalid chunk (expected audio buffer)")
-                        this.push(null)
-                    }
                     else {
                         self.log("debug", `received data (${chunk.payload.byteLength} bytes)`)
                         this.push(chunk)

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

@@ -1,6 +1,6 @@
 /*
 **  SpeechFlow - Speech Processing Flow Graph
-**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2024-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 

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

@@ -1,6 +1,6 @@
 /*
 **  SpeechFlow - Speech Processing Flow Graph
-**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2024-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 
@@ -105,10 +105,13 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
                 device:    "auto",
                 progress_callback: progressCallback
             })
+            const ac = new AbortController()
             this.classifier = await Promise.race([
                 pipelinePromise,
-                util.timeout(30 * 1000, "model initialization timeout")
-            ]) as Transformers.AudioClassificationPipeline
+                util.timeout(30 * 1000, "model initialization timeout", ac.signal)
+            ]).finally(() => {
+                ac.abort()
+            }) as Transformers.AudioClassificationPipeline
         }
         catch (error) {
             if (this.progressInterval) {
@@ -147,10 +150,13 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
                 return genderLast
 
             /*  classify audio  */
+            const ac = new AbortController()
             const result = await Promise.race([
                 this.classifier(data),
-                util.timeout(30 * 1000, "classification timeout")
-            ]) as Transformers.AudioClassificationOutput | Transformers.AudioClassificationOutput[]
+                util.timeout(30 * 1000, "classification timeout", ac.signal)
+            ]).finally(() => {
+                ac.abort()
+            }) as Transformers.AudioClassificationOutput | Transformers.AudioClassificationOutput[]
             const classified = Array.isArray(result) ?
                 result as Transformers.AudioClassificationOutput :
                 [ result ]
@@ -199,7 +205,7 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
                     const element = this.queueAC.peek(pos)
                     if (element === undefined || element.type !== "audio-frame")
                         break
-                    if ((samples + element.data.length) < frameWindowSamples) {
+                    if ((samples + element.data.length) <= frameWindowSamples) {
                         data.set(element.data, samples)
                         samples += element.data.length
                     }
@@ -224,12 +230,13 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
             catch (error) {
                 this.log("error", `gender classification error: ${error}`)
             }
-
-            /*  re-initiate working off round  */
-            workingOff = false
-            if (!this.closing) {
-                this.workingOffTimer = setTimeout(workOffQueue, 100)
-                this.queue.once("write", workOffQueue)
+            finally {
+                /*  re-initiate working off round  */
+                workingOff = false
+                if (!this.closing) {
+                    this.workingOffTimer = setTimeout(workOffQueue, 100)
+                    this.queue.once("write", workOffQueue)
+                }
             }
         }
         this.queue.once("write", workOffQueue)
@@ -313,7 +320,7 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
                             else if (element.type === "audio-frame"
                                 && element.gender === undefined)
                                 break
-                            const duration = util.audioArrayDuration(element.data)
+                            const duration = util.audioArrayDuration(element.data, sampleRateTarget)
                             const fmtTime = (t: Duration) => t.toFormat("hh:mm:ss.SSS")
                             const times = `start: ${fmtTime(element.chunk.timestampStart)}, ` +
                                 `end: ${fmtTime(element.chunk.timestampEnd)}`

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

@@ -1,6 +1,6 @@
 /*
 **  SpeechFlow - Speech Processing Flow Graph
-**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2024-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 

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

@@ -1,6 +1,6 @@
 /*
 **  SpeechFlow - Speech Processing Flow Graph
-**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2024-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 
@@ -114,17 +114,27 @@ export default class SpeechFlowNodeA2AGTCRN extends SpeechFlowNode {
             })
         })
 
-        /*  receive message from worker  */
-        const pending = new Map<string, (arr: Float32Array<ArrayBuffer>) => void>()
+        /*  track pending promises  */
+        const pending = new Map<string, {
+            resolve: (arr: Float32Array<ArrayBuffer>) => void,
+            reject:  (err: Error)                     => void
+        }>()
+
+        /*  reject all pending promises on worker exit  */
         this.worker.on("exit", () => {
+            const err = new Error("worker terminated")
+            for (const cb of pending.values())
+                cb.reject(err)
             pending.clear()
         })
+
+        /*  receive message from worker  */
         this.worker.on("message", (msg: any) => {
             if (typeof msg === "object" && msg !== null && msg.type === "process-done") {
                 const cb = pending.get(msg.id)
                 pending.delete(msg.id)
                 if (cb)
-                    cb(msg.data)
+                    cb.resolve(msg.data)
                 else
                     this.log("warning", `GTCRN worker thread sent back unexpected id: ${msg.id}`)
             }
@@ -140,8 +150,8 @@ export default class SpeechFlowNodeA2AGTCRN extends SpeechFlowNode {
             if (this.closing)
                 return samples
             const id = `${seq++}`
-            return new Promise<Float32Array<ArrayBuffer>>((resolve) => {
-                pending.set(id, (result) => { resolve(result) })
+            return new Promise<Float32Array<ArrayBuffer>>((resolve, reject) => {
+                pending.set(id, { resolve, reject })
                 this.worker!.postMessage({ type: "process", id, samples }, [ samples.buffer ])
             })
         }
@@ -161,24 +171,37 @@ export default class SpeechFlowNodeA2AGTCRN extends SpeechFlowNode {
                     callback(new Error("invalid chunk payload type"))
                 else {
                     /*  resample Buffer from 48KHz (SpeechFlow) to 16KHz (GTCRN)  */
-                    const resampledDown = self.resamplerDown!.processChunk(chunk.payload)
+                    if (self.resamplerDown === null) {
+                        callback(new Error("resamplerDown already destroyed"))
+                        return
+                    }
+                    const resampledDown = self.resamplerDown.processChunk(chunk.payload)
 
                     /*  convert Buffer into Float32Array  */
                     const payload = util.convertBufToF32(resampledDown)
 
                     /*  process with GTCRN  */
                     workerProcess(payload).then((result: Float32Array<ArrayBuffer>) => {
+                        /*  short-circuit if already closing  */
+                        if (self.closing) {
+                            callback()
+                            return
+                        }
+
                         /*  convert Float32Array into Buffer  */
                         const buf = util.convertF32ToBuf(result)
 
                         /*  resample Buffer from 16KHz (GTCRN) back to 48KHz (SpeechFlow)  */
-                        const resampledUp = self.resamplerUp!.processChunk(buf)
-
-                        /*  update chunk  */
-                        chunk.payload = resampledUp
-
-                        /*  forward updated chunk  */
-                        this.push(chunk)
+                        if (self.resamplerUp === null) {
+                            callback(new Error("resamplerUp already destroyed"))
+                            return
+                        }
+                        const resampledUp = self.resamplerUp.processChunk(buf)
+
+                        /*  forward cloned chunk with updated payload  */
+                        const chunkNew = chunk.clone()
+                        chunkNew.payload = resampledUp
+                        this.push(chunkNew)
                         callback()
                     }).catch((err: unknown) => {
                         const error = util.ensureError(err)
@@ -211,9 +234,13 @@ export default class SpeechFlowNodeA2AGTCRN extends SpeechFlowNode {
         }
 
         /*  destroy resamplers  */
-        if (this.resamplerDown !== null)
+        if (this.resamplerDown !== null) {
+            this.resamplerDown.destroy()
             this.resamplerDown = null
-        if (this.resamplerUp !== null)
+        }
+        if (this.resamplerUp !== null) {
+            this.resamplerUp.destroy()
             this.resamplerUp = null
+        }
     }
 }

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

@@ -1,6 +1,6 @@
 /*
 **  SpeechFlow - Speech Processing Flow Graph
-**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2024-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 

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

@@ -1,6 +1,6 @@
 /*
 **  SpeechFlow - Speech Processing Flow Graph
-**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2024-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 

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

@@ -1,6 +1,6 @@
 /*
 **  SpeechFlow - Speech Processing Flow Graph
-**  Copyright (c) 2024-2025 Dr. Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2024-2026 Dr. Ralf S. Engelschall <rse@engelschall.com>
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 
@@ -185,8 +185,9 @@ export default class SpeechFlowNodeA2APitch extends SpeechFlowNode {
 
                         /*  take over pitch-shifted data  */
                         const payload = util.convertI16ToBuf(result, self.config.audioLittleEndian)
-                        chunk.payload = payload
-                        this.push(chunk)
+                        const chunkNew = chunk.clone()
+                        chunkNew.payload = payload
+                        this.push(chunkNew)
                         callback()
                     }).catch((error: unknown) => {
                         if (self.closing)