speechflow 1.6.4 → 1.6.6

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

@@ -87,13 +87,14 @@ class AudioExpander extends util.WebAudio {
     }
 
     public async destroy (): Promise<void> {
-        await super.destroy()
-
         /*  destroy expander node  */
         if (this.expanderNode !== null) {
             this.expanderNode.disconnect()
             this.expanderNode = null
         }
+
+        /*  destroy parent  */
+        await super.destroy()
     }
 }
 
@@ -103,7 +104,7 @@ export default class SpeechFlowNodeA2AExpander extends SpeechFlowNode {
     public static name = "a2a-expander"
 
     /*  internal state  */
-    private destroyed = false
+    private closing = false
     private expander: AudioExpander | null = null
 
     /*  construct node  */
@@ -133,7 +134,7 @@ export default class SpeechFlowNodeA2AExpander extends SpeechFlowNode {
     /*  open node  */
     async open () {
         /*  clear destruction flag  */
-        this.destroyed = false
+        this.closing = false
 
         /*  setup expander  */
         this.expander = new AudioExpander(
@@ -157,7 +158,7 @@ export default class SpeechFlowNodeA2AExpander extends SpeechFlowNode {
             writableObjectMode: true,
             decodeStrings:      false,
             transform (chunk: SpeechFlowChunk & { payload: Buffer }, encoding, callback) {
-                if (self.destroyed) {
+                if (self.closing) {
                     callback(new Error("stream already destroyed"))
                     return
                 }
@@ -167,7 +168,7 @@ export default class SpeechFlowNodeA2AExpander extends SpeechFlowNode {
                     /*  expand chunk  */
                     const payload = util.convertBufToI16(chunk.payload)
                     self.expander?.process(payload).then((result) => {
-                        if (self.destroyed)
+                        if (self.closing)
                             throw new Error("stream already destroyed")
 
                         /*  take over expanded data  */
@@ -176,13 +177,13 @@ export default class SpeechFlowNodeA2AExpander extends SpeechFlowNode {
                         this.push(chunk)
                         callback()
                     }).catch((error: unknown) => {
-                        if (!self.destroyed)
+                        if (!self.closing)
                             callback(util.ensureError(error, "expansion failed"))
                     })
                 }
             },
             final (callback) {
-                if (self.destroyed) {
+                if (self.closing) {
                     callback()
                     return
                 }
@@ -194,8 +195,8 @@ export default class SpeechFlowNodeA2AExpander extends SpeechFlowNode {
 
     /*  close node  */
     async close () {
-        /*  indicate destruction  */
-        this.destroyed = true
+        /*  indicate closing  */
+        this.closing = true
 
         /*  destroy expander  */
         if (this.expander !== null) {
@@ -203,9 +204,9 @@ export default class SpeechFlowNodeA2AExpander extends SpeechFlowNode {
             this.expander = null
         }
 
-        /*  close stream  */
+        /*  shutdown stream  */
         if (this.stream !== null) {
-            this.stream.destroy()
+            await util.destroyStream(this.stream)
             this.stream = null
         }
     }

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

@@ -93,7 +93,7 @@ export default class SpeechFlowNodeA2AFFMPEG extends SpeechFlowNode {
         util.run("starting FFmpeg process", () => this.ffmpeg!.run())
 
         /*  establish a duplex stream and connect it to FFmpeg  */
-        this.stream = Stream.Duplex.from({
+        const ffmpegStream = Stream.Duplex.from({
             writable: streamInput,
             readable: streamOutput
         })
@@ -101,20 +101,14 @@ export default class SpeechFlowNodeA2AFFMPEG extends SpeechFlowNode {
         /*  wrap streams with conversions for chunk vs plain audio  */
         const wrapper1 = util.createTransformStreamForWritableSide()
         const wrapper2 = util.createTransformStreamForReadableSide("audio", () => this.timeZero)
-        this.stream = Stream.compose(wrapper1, this.stream, wrapper2)
+        this.stream = Stream.compose(wrapper1, ffmpegStream, wrapper2)
     }
 
     /*  close node  */
     async close () {
-        /*  close duplex stream  */
+        /*  shutdown stream  */
         if (this.stream !== null) {
-            await new Promise<void>((resolve) => {
-                if (this.stream instanceof Stream.Duplex)
-                    this.stream.end(() => { resolve() })
-                else
-                    resolve()
-            })
-            this.stream.destroy()
+            await util.destroyStream(this.stream)
             this.stream = null
         }
 

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

@@ -44,14 +44,14 @@ class AudioFiller extends EventEmitter {
     }
 
     /*  emit a chunk of silence  */
-    private emitSilence (fromSamples: number, toSamples: number) {
+    private emitSilence (fromSamples: number, toSamples: number, meta?: Map<string, any>) {
         const frames = Math.max(0, Math.floor(toSamples - fromSamples))
         if (frames <= 0)
             return
         const payload = Buffer.alloc(frames * this.bytesPerFrame) /* already zeroed */
         const timestampStart = this.durationFromSamples(fromSamples)
         const timestampEnd   = this.durationFromSamples(toSamples)
-        const chunk = new SpeechFlowChunk(timestampStart, timestampEnd, "final", "audio", payload)
+        const chunk = new SpeechFlowChunk(timestampStart, timestampEnd, "final", "audio", payload, meta ? new Map(meta) : undefined)
         this.emit("chunk", chunk)
     }
 
@@ -64,7 +64,7 @@ class AudioFiller extends EventEmitter {
 
         /*  if chunk starts beyond what we've emitted, insert silence for the gap  */
         if (startSamp > this.emittedEndSamples + this.sampleTolerance) {
-            this.emitSilence(this.emittedEndSamples, startSamp)
+            this.emitSilence(this.emittedEndSamples, startSamp, chunk.meta)
             this.emittedEndSamples = startSamp
         }
 
@@ -95,7 +95,7 @@ class AudioFiller extends EventEmitter {
         const outEndSamples   = outStartSamples + Math.floor(payload.length / this.bytesPerFrame)
         const timestampStart  = this.durationFromSamples(outStartSamples)
         const timestampEnd    = this.durationFromSamples(outEndSamples)
-        const c = new SpeechFlowChunk(timestampStart, timestampEnd, "final", "audio", payload)
+        const c = new SpeechFlowChunk(timestampStart, timestampEnd, "final", "audio", payload, new Map(chunk.meta))
         this.emit("chunk", c)
 
         /*  advance emitted cursor  */
@@ -109,7 +109,7 @@ export default class SpeechFlowNodeA2AFiller extends SpeechFlowNode {
     public static name = "a2a-filler"
 
     /*  internal state  */
-    private destroyed = false
+    private closing = false
     private filler: AudioFiller | null = null
     private sendQueue: util.AsyncQueue<SpeechFlowChunk | null> | null = null
 
@@ -130,7 +130,7 @@ export default class SpeechFlowNodeA2AFiller extends SpeechFlowNode {
     /*  open node  */
     async open () {
         /*  clear destruction flag  */
-        this.destroyed = false
+        this.closing = false
 
         /*  establish queues  */
         this.filler  = new AudioFiller(this.config.audioSampleRate, this.config.audioChannels)
@@ -148,27 +148,29 @@ export default class SpeechFlowNodeA2AFiller extends SpeechFlowNode {
             writableObjectMode: true,
             decodeStrings:      false,
             write (chunk: SpeechFlowChunk & { type: "audio", payload: Buffer }, encoding, callback) {
-                if (self.destroyed || self.filler === null)
+                if (self.closing || self.filler === null)
                     callback(new Error("stream already destroyed"))
                 else if (!Buffer.isBuffer(chunk.payload))
                     callback(new Error("invalid chunk payload type"))
                 else {
                     try {
+                        if (self.closing || self.filler === null)
+                            throw new Error("stream already destroyed")
                         self.filler.add(chunk)
                         callback()
                     }
-                    catch (error: any) {
-                        callback(error)
+                    catch (error: unknown) {
+                        callback(util.ensureError(error))
                     }
                 }
             },
             read (size) {
-                if (self.destroyed || self.sendQueue === null) {
+                if (self.closing || self.sendQueue === null) {
                     this.push(null)
                     return
                 }
                 self.sendQueue.read().then((chunk) => {
-                    if (self.destroyed) {
+                    if (self.closing || self.sendQueue === null) {
                         this.push(null)
                         return
                     }
@@ -181,12 +183,12 @@ export default class SpeechFlowNodeA2AFiller extends SpeechFlowNode {
                         this.push(chunk)
                     }
                 }).catch((error: unknown) => {
-                    if (!self.destroyed)
+                    if (!self.closing && self.sendQueue !== null)
                         self.log("error", `queue read error: ${util.ensureError(error).message}`)
                 })
             },
             final (callback) {
-                if (self.destroyed) {
+                if (self.closing) {
                     callback()
                     return
                 }
@@ -198,8 +200,8 @@ export default class SpeechFlowNodeA2AFiller extends SpeechFlowNode {
 
     /*  close node  */
     async close () {
-        /*  indicate destruction  */
-        this.destroyed = true
+        /*  indicate closing  */
+        this.closing = true
 
         /*  destroy queues  */
         if (this.sendQueue !== null) {
@@ -213,9 +215,9 @@ export default class SpeechFlowNodeA2AFiller extends SpeechFlowNode {
             this.filler = null
         }
 
-        /*  close stream  */
+        /*  shutdown stream  */
         if (this.stream !== null) {
-            this.stream.destroy()
+            await util.destroyStream(this.stream)
             this.stream = null
         }
     }

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

@@ -17,7 +17,7 @@ export default class SpeechFlowNodeA2AGain extends SpeechFlowNode {
     public static name = "a2a-gain"
 
     /*  internal state  */
-    private destroyed = false
+    private closing = false
 
     /*  construct node  */
     constructor (id: string, cfg: { [ id: string ]: any }, opts: { [ id: string ]: any }, args: any[]) {
@@ -36,7 +36,7 @@ export default class SpeechFlowNodeA2AGain extends SpeechFlowNode {
     /*  open node  */
     async open () {
         /*  clear destruction flag  */
-        this.destroyed = false
+        this.closing = false
 
         /*  adjust gain  */
         const adjustGain = (chunk: SpeechFlowChunk & { payload: Buffer }, db: number) => {
@@ -57,7 +57,7 @@ export default class SpeechFlowNodeA2AGain extends SpeechFlowNode {
             writableObjectMode: true,
             decodeStrings:      false,
             transform (chunk: SpeechFlowChunk & { payload: Buffer }, encoding, callback) {
-                if (self.destroyed) {
+                if (self.closing) {
                     callback(new Error("stream already destroyed"))
                     return
                 }
@@ -73,7 +73,7 @@ export default class SpeechFlowNodeA2AGain extends SpeechFlowNode {
                 }
             },
             final (callback) {
-                if (self.destroyed) {
+                if (self.closing) {
                     callback()
                     return
                 }
@@ -85,12 +85,12 @@ export default class SpeechFlowNodeA2AGain extends SpeechFlowNode {
 
     /*  close node  */
     async close () {
-        /*  indicate destruction  */
-        this.destroyed = true
+        /*  indicate closing  */
+        this.closing = true
 
-        /*  close stream  */
+        /*  shutdown stream  */
         if (this.stream !== null) {
-            this.stream.destroy()
+            await util.destroyStream(this.stream)
             this.stream = null
         }
     }

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

@@ -5,23 +5,26 @@
 */
 
 /*  standard dependencies  */
-import path               from "node:path"
-import Stream             from "node:stream"
+import path    from "node:path"
+import Stream  from "node:stream"
 
 /*  external dependencies  */
-import * as Transformers  from "@huggingface/transformers"
-import { WaveFile }       from "wavefile"
+import * as Transformers     from "@huggingface/transformers"
+import { WaveFile }          from "wavefile"
+import { getRMS, AudioData } from "audio-inspect"
+import { Duration }          from "luxon"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
 import * as util                           from "./speechflow-util"
 
 /*  audio stream queue element */
+type Gender = "male" | "female" | "unknown"
 type AudioQueueElement = {
     type:         "audio-frame",
     chunk:        SpeechFlowChunk,
     data:         Float32Array,
-    gender?:      "male" | "female" | "unknown"
+    gender?:      Gender
 } | {
     type:         "audio-eof"
 }
@@ -37,7 +40,7 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
     private queueRecv = this.queue.pointerUse("recv")
     private queueAC   = this.queue.pointerUse("ac")
     private queueSend = this.queue.pointerUse("send")
-    private shutdown  = false
+    private closing = false
     private workingOffTimer:  ReturnType<typeof setTimeout>  | null = null
     private progressInterval: ReturnType<typeof setInterval> | null = null
 
@@ -47,7 +50,10 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
 
         /*  declare node configuration parameters  */
         this.configure({
-            window: { type: "number", pos: 0, val: 500 }
+            window:          { type: "number", pos: 0, val: 500  },
+            threshold:       { type: "number", pos: 1, val: 0.50 },
+            hysteresis:      { type: "number", pos: 2, val: 0.25 },
+            volumeThreshold: { type: "number", pos: 3, val: -45  }
         })
 
         /*  declare node input/output format  */
@@ -61,11 +67,8 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
         if (this.config.audioBitDepth !== 16 || !this.config.audioLittleEndian)
             throw new Error("Gender node currently supports PCM-S16LE audio only")
 
-        /*  clear shutdown flag  */
-        this.shutdown = false
-
-        /*  pass-through logging  */
-        const log = this.log.bind(this)
+        /*  clear destruction flag  */
+        this.closing = false
 
         /*  the used model  */
         const model = "Xenova/wav2vec2-large-xlsr-53-gender-recognition-librispeech"
@@ -73,7 +76,7 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
         /*  track download progress when instantiating Transformers engine and model  */
         const progressState = new Map<string, number>()
         const progressCallback: Transformers.ProgressCallback = (progress: any) => {
-            if (this.shutdown)
+            if (this.closing)
                 return
             let artifact = model
             if (typeof progress.file === "string")
@@ -87,7 +90,7 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
                 progressState.set(artifact, percent)
         }
         this.progressInterval = setInterval(() => {
-            if (this.shutdown)
+            if (this.closing)
                 return
             for (const [ artifact, percent ] of progressState) {
                 this.log("info", `downloaded ${percent.toFixed(2)}% of artifact "${artifact}"`)
@@ -102,24 +105,17 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
                 device:    "auto",
                 progress_callback: progressCallback
             })
-            let timeoutId: ReturnType<typeof setTimeout> | null = null
-            const timeoutPromise = new Promise((resolve, reject) => {
-                timeoutId = setTimeout(() =>
-                    reject(new Error("model initialization timeout")), 30 * 1000)
-            })
             this.classifier = await Promise.race([
-                pipelinePromise, timeoutPromise
-            ]).finally(() => {
-                if (timeoutId !== null)
-                    clearTimeout(timeoutId)
-            }) as Transformers.AudioClassificationPipeline
+                pipelinePromise,
+                util.timeoutPromise(30 * 1000, "model initialization timeout")
+            ]) as Transformers.AudioClassificationPipeline
         }
         catch (error) {
             if (this.progressInterval) {
                 clearInterval(this.progressInterval)
                 this.progressInterval = null
             }
-            throw new Error(`failed to initialize classifier pipeline: ${error}`)
+            throw new Error(`failed to initialize classifier pipeline: ${error}`, { cause: error })
         }
         if (this.progressInterval) {
             clearInterval(this.progressInterval)
@@ -128,46 +124,61 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
         if (this.classifier === null)
             throw new Error("failed to instantiate classifier pipeline")
 
+        /*  define sample rate required by model  */
+        const sampleRateTarget = 16000
+
         /*  classify a single large-enough concatenated audio frame  */
+        let genderLast: Gender = "unknown"
         const classify = async (data: Float32Array) => {
-            if (this.shutdown || this.classifier === null)
-                throw new Error("classifier shutdown during operation")
-            const classifyPromise = this.classifier(data)
-            let timeoutId: ReturnType<typeof setTimeout> | null = null
-            const timeoutPromise = new Promise((resolve, reject) => {
-                timeoutId = setTimeout(() =>
-                    reject(new Error("classification timeout")), 30 * 1000)
-            })
-            const result = await Promise.race([ classifyPromise, timeoutPromise ]).finally(() => {
-                if (timeoutId !== null)
-                    clearTimeout(timeoutId)
-            }) as Transformers.AudioClassificationOutput | Transformers.AudioClassificationOutput[]
+            if (this.closing || this.classifier === null)
+                throw new Error("classifier destroyed during operation")
+
+            /*  check volume level and return "unknown" if too low
+                in order to avoid a wrong classificaton  */
+            const audioData = {
+                sampleRate:       sampleRateTarget,
+                numberOfChannels: 1,
+                channelData:      [ data ],
+                duration:         data.length / sampleRateTarget,
+                length:           data.length
+            } satisfies AudioData
+            const rms = getRMS(audioData, { asDB: true })
+            if (rms < this.params.volumeThreshold)
+                return genderLast
+
+            /*  classify audio  */
+            const result = await Promise.race([
+                this.classifier(data),
+                util.timeoutPromise(30 * 1000, "classification timeout")
+            ]) as Transformers.AudioClassificationOutput | Transformers.AudioClassificationOutput[]
             const classified = Array.isArray(result) ?
                 result as Transformers.AudioClassificationOutput :
                 [ result ]
-            const c1 = classified.find((c: any) => c.label === "male")
-            const c2 = classified.find((c: any) => c.label === "female")
+            const c1 = classified.find((c) => c.label === "male")
+            const c2 = classified.find((c) => c.label === "female")
             const male   = c1 ? c1.score : 0.0
             const female = c2 ? c2.score : 0.0
-            if (male > 0.50 && male > female + 0.25)
-                return "male"
-            else if (female > 0.50 && female > male + 0.25)
-                return "female"
-            else
-                return "unknown"
+            const threshold  = this.params.threshold
+            const hysteresis = this.params.hysteresis
+            let genderNow: Gender = genderLast
+            if (male > threshold && male > female + hysteresis)
+                genderNow = "male"
+            else if (female > threshold && female > male + hysteresis)
+                genderNow = "female"
+            if (genderNow !== genderLast) {
+                this.log("info", `switching detected gender from <${genderLast}> to <${genderNow}>`)
+                genderLast = genderNow
+            }
+            return genderNow
         }
 
-        /*  define sample rate required by model  */
-        const sampleRateTarget = 16000
-
         /*  work off queued audio frames  */
         const frameWindowDuration = this.params.window / 1000
         const frameWindowSamples  = Math.floor(frameWindowDuration * sampleRateTarget)
-        let lastGender = ""
         let workingOff = false
         const workOffQueue = async () => {
             /*  control working off round  */
-            if (workingOff || this.shutdown)
+            if (workingOff || this.closing)
                 return
             workingOff = true
             if (this.workingOffTimer !== null) {
@@ -184,7 +195,7 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
                 data.fill(0)
                 let samples = 0
                 let pos = pos0
-                while (pos < posL && samples < frameWindowSamples && !this.shutdown) {
+                while (pos < posL && samples < frameWindowSamples && !this.closing) {
                     const element = this.queueAC.peek(pos)
                     if (element === undefined || element.type !== "audio-frame")
                         break
@@ -194,12 +205,12 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
                     }
                     pos++
                 }
-                if (pos0 < pos && samples > frameWindowSamples * 0.75 && !this.shutdown) {
+                if (pos0 < pos && samples > frameWindowSamples * 0.75 && !this.closing) {
                     const gender = await classify(data)
-                    if (this.shutdown)
+                    if (this.closing)
                         return
                     const posM = pos0 + Math.trunc((pos - pos0) * 0.25)
-                    while (pos0 < posM && pos0 < posL && !this.shutdown) {
+                    while (pos0 < posM && pos0 < posL && !this.closing) {
                         const element = this.queueAC.peek(pos0)
                         if (element === undefined || element.type !== "audio-frame")
                             break
@@ -208,19 +219,15 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
                         this.queueAC.walk(+1)
                         pos0++
                     }
-                    if (lastGender !== gender && !this.shutdown) {
-                        log("info", `gender now recognized as <${gender}>`)
-                        lastGender = gender
-                    }
                 }
             }
             catch (error) {
-                log("error", `gender classification error: ${error}`)
+                this.log("error", `gender classification error: ${error}`)
             }
 
             /*  re-initiate working off round  */
             workingOff = false
-            if (!this.shutdown) {
+            if (!this.closing) {
                 this.workingOffTimer = setTimeout(workOffQueue, 100)
                 this.queue.once("write", workOffQueue)
             }
@@ -237,7 +244,7 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
 
             /*  receive audio chunk (writable side of stream)  */
             write (chunk: SpeechFlowChunk, encoding, callback) {
-                if (self.shutdown) {
+                if (self.closing) {
                     callback(new Error("stream already destroyed"))
                     return
                 }
@@ -252,21 +259,21 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
                         const wav = new WaveFile()
                         wav.fromScratch(self.config.audioChannels, self.config.audioSampleRate, "32f", data)
                         wav.toSampleRate(sampleRateTarget, { method: "cubic" })
-                        data = wav.getSamples(false, Float32Array) as any as Float32Array<ArrayBuffer>
+                        data = wav.getSamples(false, Float32Array) as unknown as Float32Array<ArrayBuffer>
 
                         /*  queue chunk and converted data  */
                         self.queueRecv.append({ type: "audio-frame", chunk, data })
                         callback()
                     }
                     catch (error) {
-                        callback(error instanceof Error ? error : new Error("audio processing failed"))
+                        callback(util.ensureError(error, "audio processing failed"))
                     }
                 }
             },
 
             /*  receive no more audio chunks (writable side of stream)  */
             final (callback) {
-                if (self.shutdown) {
+                if (self.closing) {
                     callback()
                     return
                 }
@@ -280,7 +287,7 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
             read (_size) {
                 /*  flush pending audio chunks  */
                 const flushPendingChunks = () => {
-                    if (self.shutdown) {
+                    if (self.closing) {
                         this.push(null)
                         return
                     }
@@ -292,7 +299,7 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
                         && element.type === "audio-frame"
                         && element.gender !== undefined) {
                         while (true) {
-                            if (self.shutdown) {
+                            if (self.closing) {
                                 this.push(null)
                                 return
                             }
@@ -307,14 +314,18 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
                                 && element.gender === undefined)
                                 break
                             const duration = util.audioArrayDuration(element.data)
-                            log("debug", `send chunk (${duration.toFixed(3)}s) with gender <${element.gender}>`)
+                            const fmtTime = (t: Duration) => t.toFormat("hh:mm:ss.SSS")
+                            const times = `start: ${fmtTime(element.chunk.timestampStart)}, ` +
+                                `end: ${fmtTime(element.chunk.timestampEnd)}`
+                            self.log("debug", `send chunk (${times}, duration: ${duration.toFixed(3)}s) ` +
+                                `with gender <${element.gender}>`)
                             element.chunk.meta.set("gender", element.gender)
                             this.push(element.chunk)
                             self.queueSend.walk(+1)
                             self.queue.trim()
                         }
                     }
-                    else if (!self.shutdown)
+                    else if (!self.closing)
                         self.queue.once("write", flushPendingChunks)
                 }
                 flushPendingChunks()
@@ -324,8 +335,8 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
 
     /*  close node  */
     async close () {
-        /*  indicate shutdown  */
-        this.shutdown = true
+        /*  indicate closing  */
+        this.closing = true
 
         /*  cleanup working-off timer  */
         if (this.workingOffTimer !== null) {
@@ -342,9 +353,9 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
         /*  remove all event listeners  */
         this.queue.removeAllListeners("write")
 
-        /*  close stream  */
+        /*  shutdown stream  */
         if (this.stream !== null) {
-            this.stream.destroy()
+            await util.destroyStream(this.stream)
             this.stream = null
         }