speechflow 2.0.0 → 2.0.1

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

@@ -24,15 +24,15 @@ import * as util             from "./speechflow-util"
 /*  the SpeechFlow node graph management  */
 export class NodeGraph {
     /*  internal state  */
-    private graphNodes    = new Set<SpeechFlowNode>()
-    private activeNodes   = new Set<SpeechFlowNode>()
-    private finishEvents  = new EventEmitter()
+    private graphNodes                    = new Set<SpeechFlowNode>()
+    private activeNodes                   = new Set<SpeechFlowNode>()
+    private finishEvents                  = new EventEmitter()
     private timeZero:     DateTime | null = null
-    private shuttingDown  = false
+    private shuttingDown                  = false
 
     /*  simple construction  */
     constructor (
-        private cli:  CLIio,
+        private cli: CLIio,
         private debug = false
     ) {}
 
@@ -59,6 +59,7 @@ export class NodeGraph {
             err instanceof Error && err.name === "FlowLinkError"
                 ? err.toString() : (err instanceof Error ? err.message : "internal error")
 
+        /*  instantiate FlowLink parser  */
         const flowlink = new FlowLink<SpeechFlowNode>({
             trace: (msg: string) => {
                 this.cli.log("debug", msg)
@@ -97,10 +98,7 @@ export class NodeGraph {
                     }
                     catch (err) {
                         /*  fatal error  */
-                        if (err instanceof Error)
-                            this.cli.log("error", `creation of node <${id}> failed: ${err.message}`)
-                        else
-                            this.cli.log("error", `creation of node <${id}> failed: ${err}`)
+                        this.cli.log("error", `creation of node <${id}> failed: ${util.ensureError(err).message}`)
                         process.exit(1)
                     }
                     const params = Object.keys(node.params).map((key) => {

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

@@ -16,6 +16,7 @@ import SpeechFlowNode    from "./speechflow-node"
 export class NodeRegistry {
     public nodes: { [ id: string ]: typeof SpeechFlowNode } = {}
 
+    /*  simple constructor  */
     constructor (
         private cli: CLIio
     ) {}

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

@@ -4,6 +4,7 @@
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 
+/*  internal dependencies  */
 import * as util from "./speechflow-util"
 
 /*  downward compressor with soft knee  */

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

@@ -36,7 +36,7 @@ class AudioCompressor extends util.WebAudio {
     private gainNode:          GainNode | null = null
 
     /*  construct object  */
-    constructor(
+    constructor (
         sampleRate: number,
         channels:   number,
         type:       "standalone" | "sidechain" = "standalone",
@@ -106,8 +106,7 @@ class AudioCompressor extends util.WebAudio {
         /*  configure compressor worklet node  */
         const currentTime = this.audioContext.currentTime
         if (needsCompressor) {
-            const node = this.compressorNode!
-            const params = node.parameters as Map<string, AudioParam>
+            const params = this.compressorNode!.parameters as Map<string, AudioParam>
             params.get("threshold")!.setValueAtTime(this.config.thresholdDb, currentTime)
             params.get("ratio")!.setValueAtTime(this.config.ratio, currentTime)
             params.get("attack")!.setValueAtTime(this.config.attackMs / 1000, currentTime)
@@ -241,10 +240,12 @@ export default class SpeechFlowNodeA2ACompressor extends SpeechFlowNode {
                 }
                 if (!Buffer.isBuffer(chunk.payload))
                     callback(new Error("invalid chunk payload type"))
+                else if (self.compressor === null)
+                    callback(new Error("compressor not initialized"))
                 else {
                     /*  compress chunk  */
                     const payload = util.convertBufToI16(chunk.payload)
-                    self.compressor?.process(payload).then((result) => {
+                    self.compressor.process(payload).then((result) => {
                         if (self.closing) {
                             callback(new Error("stream already destroyed"))
                             return
@@ -258,17 +259,14 @@ export default class SpeechFlowNodeA2ACompressor extends SpeechFlowNode {
                         this.push(chunk)
                         callback()
                     }).catch((error: unknown) => {
-                        if (!self.closing)
+                        if (self.closing)
+                            callback()
+                        else
                             callback(util.ensureError(error, "compression failed"))
                     })
                 }
             },
             final (callback) {
-                if (self.closing) {
-                    callback()
-                    return
-                }
-                this.push(null)
                 callback()
             }
         })

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

@@ -4,6 +4,7 @@
 **  Licensed under GPL 3.0 <https://spdx.org/licenses/GPL-3.0-only>
 */
 
+/*  internal dependencies  */
 import * as util from "./speechflow-util"
 
 /*  downward expander with soft knee  */

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

@@ -33,7 +33,7 @@ class AudioExpander extends util.WebAudio {
     private expanderNode: AudioWorkletNode | null = null
 
     /*  construct object  */
-    constructor(
+    constructor (
         sampleRate: number,
         channels:   number,
         config:     AudioExpanderConfig = {}
@@ -71,8 +71,7 @@ class AudioExpander extends util.WebAudio {
 
         /*  configure expander node  */
         const currentTime = this.audioContext.currentTime
-        const node = this.expanderNode!
-        const params = node.parameters as Map<string, AudioParam>
+        const params = this.expanderNode.parameters as Map<string, AudioParam>
         params.get("threshold")!.setValueAtTime(this.config.thresholdDb, currentTime)
         params.get("floor")!.setValueAtTime(this.config.floorDb, currentTime)
         params.get("ratio")!.setValueAtTime(this.config.ratio, currentTime)
@@ -86,6 +85,7 @@ class AudioExpander extends util.WebAudio {
         this.expanderNode.connect(this.captureNode!)
     }
 
+    /*  destroy object  */
     public async destroy (): Promise<void> {
         /*  destroy expander node  */
         if (this.expanderNode !== null) {
@@ -164,10 +164,12 @@ export default class SpeechFlowNodeA2AExpander extends SpeechFlowNode {
                 }
                 if (!Buffer.isBuffer(chunk.payload))
                     callback(new Error("invalid chunk payload type"))
+                else if (self.expander === null)
+                    callback(new Error("expander not initialized"))
                 else {
                     /*  expand chunk  */
                     const payload = util.convertBufToI16(chunk.payload)
-                    self.expander?.process(payload).then((result) => {
+                    self.expander.process(payload).then((result) => {
                         if (self.closing) {
                             callback(new Error("stream already destroyed"))
                             return
@@ -179,17 +181,14 @@ export default class SpeechFlowNodeA2AExpander extends SpeechFlowNode {
                         this.push(chunk)
                         callback()
                     }).catch((error: unknown) => {
-                        if (!self.closing)
+                        if (self.closing)
+                            callback()
+                        else
                             callback(util.ensureError(error, "expansion failed"))
                     })
                 }
             },
             final (callback) {
-                if (self.closing) {
-                    callback()
-                    return
-                }
-                this.push(null)
                 callback()
             }
         })

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

@@ -13,6 +13,7 @@ import { Duration }     from "luxon"
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
 import * as util                           from "./speechflow-util"
 
+/*  audio gap filler class  */
 class AudioFiller extends EventEmitter {
     private emittedEndSamples = 0           /* stream position in samples already emitted */
     private maxInputEndSamples = 0
@@ -21,6 +22,7 @@ class AudioFiller extends EventEmitter {
     private readonly bytesPerFrame: number
     private readonly sampleTolerance = 0.5  /* tolerance for floating-point sample comparisons */
 
+    /*  construct object  */
     constructor (private sampleRate = 48000, private channels = 1) {
         super()
         this.bytesPerFrame = this.channels * this.bytesPerSample

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

@@ -134,7 +134,7 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
                 throw new Error("classifier destroyed during operation")
 
             /*  check volume level and return "unknown" if too low
-                in order to avoid a wrong classificaton  */
+                in order to avoid a wrong classification  */
             const audioData = {
                 sampleRate:       sampleRateTarget,
                 numberOfChannels: 1,
@@ -154,8 +154,8 @@ export default class SpeechFlowNodeA2AGender extends SpeechFlowNode {
             const classified = Array.isArray(result) ?
                 result as Transformers.AudioClassificationOutput :
                 [ result ]
-            const c1 = classified.find((c) => c.label === "male")
-            const c2 = classified.find((c) => 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
             const threshold  = this.params.threshold

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

@@ -83,7 +83,7 @@ export default class SpeechFlowNodeA2AMeter extends SpeechFlowNode {
             const chunkData = this.chunkBuffer
             this.chunkBuffer = new Float32Array(0)
 
-            /*  update internal audio sample sliding window for LUFS-S  */
+            /*  update internal audio sample sliding window for LUFS-M  */
             if (chunkData.length > sampleWindow.length)
                 sampleWindow.set(chunkData.subarray(chunkData.length - sampleWindow.length), 0)
             else {
@@ -218,4 +218,4 @@ export default class SpeechFlowNodeA2AMeter extends SpeechFlowNode {
             this.stream = null
         }
     }
-}
+}

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

@@ -172,12 +172,16 @@ export default class SpeechFlowNodeA2APitch extends SpeechFlowNode {
                 }
                 if (!Buffer.isBuffer(chunk.payload))
                     callback(new Error("invalid chunk payload type"))
+                else if (self.pitchShifter === null)
+                    callback(new Error("pitch shifter not initialized"))
                 else {
                     /*  shift pitch of audio chunk  */
                     const payload = util.convertBufToI16(chunk.payload, self.config.audioLittleEndian)
-                    self.pitchShifter?.process(payload).then((result) => {
-                        if (self.closing)
-                            throw new Error("stream already destroyed")
+                    self.pitchShifter.process(payload).then((result) => {
+                        if (self.closing) {
+                            callback(new Error("stream already destroyed"))
+                            return
+                        }
 
                         /*  take over pitch-shifted data  */
                         const payload = util.convertI16ToBuf(result, self.config.audioLittleEndian)
@@ -185,16 +189,14 @@ export default class SpeechFlowNodeA2APitch extends SpeechFlowNode {
                         this.push(chunk)
                         callback()
                     }).catch((error: unknown) => {
-                        callback(util.ensureError(error, "pitch shifting failed"))
+                        if (self.closing)
+                            callback()
+                        else
+                            callback(util.ensureError(error, "pitch shifting failed"))
                     })
                 }
             },
             final (callback) {
-                if (self.closing) {
-                    callback()
-                    return
-                }
-                this.push(null)
                 callback()
             }
         })

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

@@ -48,6 +48,7 @@ parentPort!.on("message", (msg) => {
         for (let i = 0; i < data.length; i++)
             i16[i] = Math.round(f32a[i])
 
+        /*  send processed frame back to parent  */
         parentPort!.postMessage({ type: "process-done", id, data: i16 }, [ i16.buffer ])
     }
     else if (msg.type === "close") {

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

@@ -93,7 +93,7 @@ export default class SpeechFlowNodeA2ARNNoise extends SpeechFlowNode {
                 return segment
             const id = `${seq++}`
             return new Promise<Int16Array<ArrayBuffer>>((resolve) => {
-                pending.set(id, (segment: Int16Array<ArrayBuffer>) => { resolve(segment) })
+                pending.set(id, (segment) => { resolve(segment) })
                 this.worker!.postMessage({ type: "process", id, data: segment }, [ segment.buffer ])
             })
         }

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

@@ -32,7 +32,7 @@ export default class SpeechFlowNodeA2ASpeex extends SpeechFlowNode {
 
         /*  declare node configuration parameters  */
         this.configure({
-            attenuate: { type: "number", val: -18, pos: 0, match: (n: number) => n >= -60 && n <= 0 },
+            attenuate: { type: "number", val: -18, pos: 0, match: (n: number) => n >= -60 && n <= 0 }
         })
 
         /*  declare node input/output format  */
@@ -53,7 +53,7 @@ export default class SpeechFlowNodeA2ASpeex extends SpeechFlowNode {
         const wasmBinary = await fs.promises.readFile(
             path.join(__dirname, "../node_modules/@sapphi-red/speex-preprocess-wasm/dist/speex.wasm"))
         const speexModule = await loadSpeexModule({
-            wasmBinary: wasmBinary.buffer as ArrayBuffer
+            wasmBinary: wasmBinary.buffer
         })
         this.speexProcessor = new SpeexPreprocessor(
             speexModule, this.sampleSize, this.config.audioSampleRate)
@@ -85,7 +85,9 @@ export default class SpeechFlowNodeA2ASpeex extends SpeechFlowNode {
                     util.processInt16ArrayInSegments(payload, self.sampleSize, (segment) => {
                         if (self.closing)
                             throw new Error("stream already destroyed")
-                        self.speexProcessor?.processInt16(segment)
+                        if (self.speexProcessor === null)
+                            throw new Error("speex processor not initialized")
+                        self.speexProcessor.processInt16(segment)
                         return Promise.resolve(segment)
                     }).then((payload: Int16Array<ArrayBuffer>) => {
                         if (self.closing)

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

@@ -85,6 +85,18 @@ export default class SpeechFlowNodeA2AVAD extends SpeechFlowNode {
             }
         }
 
+        /*  helper function for tail timer handling  */
+        const startTailTimer = () => {
+            tail = true
+            clearTailTimer()
+            this.tailTimer = setTimeout(() => {
+                if (this.closing || this.tailTimer === null)
+                    return
+                tail = false
+                this.tailTimer = null
+            }, this.params.postSpeechTail)
+        }
+
         /*  establish Voice Activity Detection (VAD) facility  */
         let tail = false
         try {
@@ -111,31 +123,15 @@ export default class SpeechFlowNodeA2AVAD extends SpeechFlowNode {
                         return
                     const duration = util.audioArrayDuration(audio, vadSampleRateTarget)
                     this.log("info", `VAD: speech end (duration: ${duration.toFixed(2)}s)`)
-                    if (this.params.mode === "unplugged") {
-                        tail = true
-                        clearTailTimer()
-                        this.tailTimer = setTimeout(() => {
-                            if (this.closing || this.tailTimer === null)
-                                return
-                            tail = false
-                            this.tailTimer = null
-                        }, this.params.postSpeechTail)
-                    }
+                    if (this.params.mode === "unplugged")
+                        startTailTimer()
                 },
                 onVADMisfire: () => {
                     if (this.closing)
                         return
                     this.log("info", "VAD: speech end (segment too short)")
-                    if (this.params.mode === "unplugged") {
-                        tail = true
-                        clearTailTimer()
-                        this.tailTimer = setTimeout(() => {
-                            if (this.closing || this.tailTimer === null)
-                                return
-                            tail = false
-                            this.tailTimer = null
-                        }, this.params.postSpeechTail)
-                    }
+                    if (this.params.mode === "unplugged")
+                        startTailTimer()
                 },
                 onFrameProcessed: (audio) => {
                     if (this.closing)
@@ -144,7 +140,7 @@ export default class SpeechFlowNodeA2AVAD extends SpeechFlowNode {
                         /*  annotate the current audio segment  */
                         const element = this.queueVAD.peek()
                         if (element === undefined || element.type !== "audio-frame")
-                            throw new Error("internal error which cannot happen: no more queued element")
+                            throw new Error("internal error that cannot happen: no more queued element")
                         if (element.segmentIdx >= element.segmentData.length)
                             throw new Error("segment index out of bounds")
                         const segment = element.segmentData[element.segmentIdx++]
@@ -227,6 +223,7 @@ export default class SpeechFlowNodeA2AVAD extends SpeechFlowNode {
                             }
                         }
 
+                        /*  signal completion  */
                         callback()
                     }
                     catch (error) {
@@ -322,6 +319,7 @@ export default class SpeechFlowNodeA2AVAD extends SpeechFlowNode {
                         }
                     }
 
+                    /*  peek at send queue element  */
                     const element = self.queueSend.peek()
                     if (element !== undefined && element.type === "audio-eof")
                         this.push(null)
@@ -371,8 +369,7 @@ export default class SpeechFlowNodeA2AVAD extends SpeechFlowNode {
         if (this.vad !== null) {
             try {
                 const flushPromise = this.vad.flush()
-                const timeoutPromise = new Promise((resolve) =>
-                    setTimeout(resolve, 5000))
+                const timeoutPromise = new Promise((resolve) => { setTimeout(resolve, 5000) })
                 await Promise.race([ flushPromise, timeoutPromise ])
             }
             catch (error) {

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

@@ -21,15 +21,18 @@ const writeWavHeader = (
     const sampleRate   = options?.sampleRate  ?? 44100 /* 44KHz */
     const bitDepth     = options?.bitDepth    ?? 16    /* 16-Bit */
 
+    /*  determine header dimensions  */
     const headerLength = 44
     const maxDataSize  = Math.pow(2, 32) - 100 /* safe maximum for 32-bit WAV files */
     const dataLength   = length ?? maxDataSize
     const fileSize     = dataLength + headerLength
     const header       = Buffer.alloc(headerLength)
 
+    /*  calculate byte rate and block alignment  */
     const byteRate     = (sampleRate * channels * bitDepth) / 8
     const blockAlign   = (channels * bitDepth) / 8
 
+    /*  write header fields  */
     let offset = 0
     header.write("RIFF", offset);               offset += 4
     header.writeUInt32LE(fileSize - 8, offset); offset += 4
@@ -45,6 +48,7 @@ const writeWavHeader = (
     header.write("data", offset);               offset += 4
     header.writeUInt32LE(dataLength, offset);   offset += 4
 
+    /*  return completed header  */
     return header
 }
 
@@ -53,6 +57,7 @@ const readWavHeader = (buffer: Buffer) => {
     if (buffer.length < 44)
         throw new Error("WAV header too short, expected at least 44 bytes")
 
+    /*  read header fields  */
     let offset = 0
     const riffHead     = buffer.subarray(offset, offset + 4).toString(); offset += 4
     const fileSize     = buffer.readUInt32LE(offset);                    offset += 4
@@ -68,6 +73,7 @@ const readWavHeader = (buffer: Buffer) => {
     const data         = buffer.subarray(offset, offset + 4).toString(); offset += 4
     const dataLength   = buffer.readUInt32LE(offset);                    offset += 4
 
+    /*  validate RIFF header  */
     if (riffHead !== "RIFF")
         throw new Error(`Invalid WAV file: expected RIFF header, got "${riffHead}"`)
     if (waveHead !== "WAVE")
@@ -77,6 +83,7 @@ const readWavHeader = (buffer: Buffer) => {
     if (data !== "data")
         throw new Error(`Invalid WAV file: expected "data" header, got "${data}"`)
 
+    /*  return parsed header data  */
     return {
         riffHead, fileSize, waveHead, fmtHead, formatLength, audioFormat,
         channels, sampleRate, byteRate, blockAlign, bitDepth, data, dataLength

package/speechflow-cli/src/speechflow-node-a2t-amazon.ts

@@ -53,7 +53,7 @@ class AsyncQueue<T> {
                 continue
             }
             else {
-                const it = await new Promise<IteratorResult<T>>((resolve) => this.resolvers.push(resolve))
+                const it = await new Promise<IteratorResult<T>>((resolve) => { this.resolvers.push(resolve) })
                 if (it.done)
                     return
                 yield it.value
@@ -68,11 +68,10 @@ export default class SpeechFlowNodeA2TAmazon extends SpeechFlowNode {
     public static name = "a2t-amazon"
 
     /*  internal state  */
-    private client:            TranscribeStreamingClient                | null = null
-    private clientStream:      AsyncIterable<TranscriptResultStream>    | null = null
-    private closing                                                            = false
-    private connectionTimeout: ReturnType<typeof setTimeout>            | null = null
-    private queue:             util.SingleQueue<SpeechFlowChunk | null> | null = null
+    private client:       TranscribeStreamingClient                | null = null
+    private clientStream: AsyncIterable<TranscriptResultStream>    | null = null
+    private closing                                                       = false
+    private queue:        util.SingleQueue<SpeechFlowChunk | null> | null = null
 
     /*  construct node  */
     constructor (id: string, cfg: { [ id: string ]: any }, opts: { [ id: string ]: any }, args: any[]) {
@@ -126,8 +125,6 @@ export default class SpeechFlowNodeA2TAmazon extends SpeechFlowNode {
                 secretAccessKey: this.params.secKey
             }
         })
-        if (this.client === null)
-            throw new Error("failed to establish Amazon Transcribe client")
 
         /*  create an AudioStream for Amazon Transcribe  */
         const audioQueue = new AsyncQueue<Uint8Array>()
@@ -236,11 +233,8 @@ export default class SpeechFlowNodeA2TAmazon extends SpeechFlowNode {
                     callback()
                     return
                 }
-
-                /*  await all read operations  */
                 await reads.awaitAll()
-
-                util.run(
+                util.run("closing Amazon Transcribe connection",
                     () => self.client!.destroy(),
                     (error: Error) => self.log("warning", `error closing Amazon Transcribe connection: ${error}`)
                 )
@@ -279,12 +273,6 @@ export default class SpeechFlowNodeA2TAmazon extends SpeechFlowNode {
         /*  indicate closing first to stop all async operations  */
         this.closing = true
 
-        /*  cleanup all timers  */
-        if (this.connectionTimeout !== null) {
-            clearTimeout(this.connectionTimeout)
-            this.connectionTimeout = null
-        }
-
         /*  close queue  */
         if (this.queue !== null) {
             this.queue.write(null)

package/speechflow-cli/src/speechflow-node-a2t-google.ts

@@ -22,11 +22,10 @@ export default class SpeechFlowNodeA2TGoogle extends SpeechFlowNode {
     public static name = "a2t-google"
 
     /*  internal state  */
-    private client:            GoogleSpeech.SpeechClient                                   | null = null
-    private recognizeStream:   ReturnType<GoogleSpeech.SpeechClient["streamingRecognize"]> | null = null
-    private connectionTimeout: ReturnType<typeof setTimeout>                               | null = null
-    private queue:             util.SingleQueue<SpeechFlowChunk | null>                    | null = null
-    private closing                                                                               = false
+    private client:          GoogleSpeech.SpeechClient                                   | null = null
+    private recognizeStream: ReturnType<GoogleSpeech.SpeechClient["streamingRecognize"]> | null = null
+    private queue:           util.SingleQueue<SpeechFlowChunk | null>                    | null = null
+    private closing                                                                             = false
 
     /*  construct node  */
     constructor (id: string, cfg: { [ id: string ]: any }, opts: { [ id: string ]: any }, args: any[]) {
@@ -280,12 +279,6 @@ export default class SpeechFlowNodeA2TGoogle extends SpeechFlowNode {
         /*  indicate closing first to stop all async operations  */
         this.closing = true
 
-        /*  cleanup all timers  */
-        if (this.connectionTimeout !== null) {
-            clearTimeout(this.connectionTimeout)
-            this.connectionTimeout = null
-        }
-
         /*  shutdown stream  */
         if (this.stream !== null) {
             await util.destroyStream(this.stream)

package/speechflow-cli/src/speechflow-node-a2t-openai.ts

@@ -23,12 +23,12 @@ export default class SpeechFlowNodeA2TOpenAI extends SpeechFlowNode {
     public static name = "a2t-openai"
 
     /*  internal state  */
-    private openai:            OpenAI | null = null
-    private ws:                ws.WebSocket | null = null
-    private queue:             util.SingleQueue<SpeechFlowChunk | null> | null = null
-    private resampler:         SpeexResampler | null = null
-    private closing            = false
-    private connectionTimeout: ReturnType<typeof setTimeout> | null = null
+    private openai:            OpenAI                                    | null = null
+    private ws:                ws.WebSocket                              | null = null
+    private queue:             util.SingleQueue<SpeechFlowChunk | null>  | null = null
+    private resampler:         SpeexResampler                            | null = null
+    private closing                                                             = false
+    private connectionTimeout: ReturnType<typeof setTimeout>             | null = null
 
     /*  construct node  */
     constructor (id: string, cfg: { [ id: string ]: any }, opts: { [ id: string ]: any }, args: any[]) {
@@ -150,6 +150,9 @@ export default class SpeechFlowNodeA2TOpenAI extends SpeechFlowNode {
         })
         this.ws.on("error", (err) => {
             this.log("error", `WebSocket connection error: ${err}`)
+            if (!this.closing && this.queue !== null)
+                this.queue.write(null)
+            this.emit("error", err)
         })
 
         /*  track speech timing by item_id (OpenAI provides timestamps via VAD events)  */
@@ -164,6 +167,7 @@ export default class SpeechFlowNodeA2TOpenAI extends SpeechFlowNode {
             }, new Map<string, any>())
         }
 
+        /*  track transcription text  */
         let text = ""
         this.ws.on("message", (data) => {
             let ev: any
@@ -353,7 +357,8 @@ export default class SpeechFlowNodeA2TOpenAI extends SpeechFlowNode {
             this.ws.close()
             this.ws = null
         }
-        this.openai = null
+        if (this.openai !== null)
+            this.openai = null
 
         /*  close resampler  */
         this.resampler = null