speechflow 1.5.1 → 1.6.1

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

@@ -14,12 +14,12 @@ 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 SpeechFlowNodeSpeex extends SpeechFlowNode {
+export default class SpeechFlowNodeA2ASpeex extends SpeechFlowNode {
     /*  declare official node name  */
-    public static name = "speex"
+    public static name = "a2a-speex"
 
     /*  internal state  */
     private destroyed = false
@@ -79,10 +79,10 @@ export default class SpeechFlowNodeSpeex 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 SpeechFlowNodeSpeex 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 = {
@@ -30,13 +30,13 @@ type AudioQueueElement = {
 }
 
 /*  SpeechFlow node for VAD speech-to-speech processing  */
-export default class SpeechFlowNodeVAD extends SpeechFlowNode {
+export default class SpeechFlowNodeA2AVAD extends SpeechFlowNode {
     /*  declare official node name  */
-    public static name = "vad"
+    public static name = "a2a-vad"
 
     /*  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 SpeechFlowNodeVAD 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 SpeechFlowNodeVAD 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  */

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

@@ -83,9 +83,9 @@ const readWavHeader = (buffer: Buffer) => {
 }
 
 /*  SpeechFlow node for WAV format conversion  */
-export default class SpeechFlowNodeWAV extends SpeechFlowNode {
+export default class SpeechFlowNodeA2AWAV extends SpeechFlowNode {
     /*  declare official node name  */
-    public static name = "wav"
+    public static name = "a2a-wav"
 
     /*  construct node  */
     constructor (id: string, cfg: { [ id: string ]: any }, opts: { [ id: string ]: any }, args: any[]) {

package/speechflow-cli/src/{speechflow-node-a2t-awstranscribe.ts → speechflow-node-a2t-amazon.ts}

@@ -19,7 +19,7 @@ import { DateTime, Duration } from "luxon"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  helper class for an asynchronous queue  */
 class AsyncQueue<T> {
@@ -62,10 +62,10 @@ class AsyncQueue<T> {
     }
 }
 
-/*  SpeechFlow node for AWS Transcribe speech-to-text conversion  */
-export default class SpeechFlowNodeAWSTranscribe extends SpeechFlowNode {
+/*  SpeechFlow node for Amazon Transcribe speech-to-text conversion  */
+export default class SpeechFlowNodeA2TAmazon extends SpeechFlowNode {
     /*  declare official node name  */
-    public static name = "awstranscribe"
+    public static name = "a2t-amazon"
 
     /*  internal state  */
     private client:            TranscribeStreamingClient     | null             = null
@@ -73,7 +73,7 @@ export default class SpeechFlowNodeAWSTranscribe extends SpeechFlowNode {
     private destroyed                                                           = false
     private initTimeout:       ReturnType<typeof setTimeout> | null             = null
     private connectionTimeout: ReturnType<typeof setTimeout> | null             = null
-    private queue:             utils.SingleQueue<SpeechFlowChunk | null> | null = null
+    private queue:             util.SingleQueue<SpeechFlowChunk | null> | null = null
 
     /*  construct node  */
     constructor (id: string, cfg: { [ id: string ]: any }, opts: { [ id: string ]: any }, args: any[]) {
@@ -114,10 +114,10 @@ export default class SpeechFlowNodeAWSTranscribe extends SpeechFlowNode {
         this.destroyed = false
 
         /*  create queue for results  */
-        this.queue = new utils.SingleQueue<SpeechFlowChunk | null>()
+        this.queue = new util.SingleQueue<SpeechFlowChunk | null>()
 
         /*  create a store for the meta information  */
-        const metastore = new utils.TimeStore<Map<string, any>>()
+        const metastore = new util.TimeStore<Map<string, any>>()
 
         /*  connect to Amazon Transcribe API  */
         this.client = new TranscribeStreamingClient({
@@ -225,7 +225,7 @@ export default class SpeechFlowNodeAWSTranscribe extends SpeechFlowNode {
                             metastore.store(chunk.timestampStart, chunk.timestampEnd, chunk.meta)
                         audioQueue.push(new Uint8Array(chunk.payload)) /* intentionally discard all time information */
                         ensureAudioStreamActive().catch((error: unknown) => {
-                            self.log("error", `failed to start audio stream: ${utils.ensureError(error).message}`)
+                            self.log("error", `failed to start audio stream: ${util.ensureError(error).message}`)
                         })
                     }
                     callback()
@@ -251,7 +251,7 @@ export default class SpeechFlowNodeAWSTranscribe 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) {
@@ -259,7 +259,7 @@ export default class SpeechFlowNodeAWSTranscribe extends SpeechFlowNode {
                     callback()
                     return
                 }
-                utils.run(
+                util.run(
                     () => self.client!.destroy(),
                     (error: Error) => self.log("warning", `error closing Amazon Transcribe connection: ${error}`)
                 )

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

@@ -13,19 +13,19 @@ import { DateTime, Duration } from "luxon"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  SpeechFlow node for Deepgram speech-to-text conversion  */
-export default class SpeechFlowNodeDeepgram extends SpeechFlowNode {
+export default class SpeechFlowNodeA2TDeepgram extends SpeechFlowNode {
     /*  declare official node name  */
-    public static name = "deepgram"
+    public static name = "a2t-deepgram"
 
     /*  internal state  */
     private dg:                Deepgram.LiveClient | null                       = null
     private destroyed                                                           = false
     private initTimeout:       ReturnType<typeof setTimeout> | null             = null
     private connectionTimeout: ReturnType<typeof setTimeout> | null             = null
-    private queue:             utils.SingleQueue<SpeechFlowChunk | null> | null = null
+    private queue:             util.SingleQueue<SpeechFlowChunk | null> | null = null
 
     /*  construct node  */
     constructor (id: string, cfg: { [ id: string ]: any }, opts: { [ id: string ]: any }, args: any[]) {
@@ -78,10 +78,10 @@ export default class SpeechFlowNodeDeepgram extends SpeechFlowNode {
         this.destroyed = false
 
         /*  create queue for results  */
-        this.queue = new utils.SingleQueue<SpeechFlowChunk | null>()
+        this.queue = new util.SingleQueue<SpeechFlowChunk | null>()
 
         /*  create a store for the meta information  */
-        const metastore = new utils.TimeStore<Map<string, any>>()
+        const metastore = new util.TimeStore<Map<string, any>>()
 
         /*  connect to Deepgram API  */
         const deepgram = Deepgram.createClient(this.params.key)
@@ -234,7 +234,7 @@ export default class SpeechFlowNodeDeepgram 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-a2t-openaitranscribe.ts → speechflow-node-a2t-openai.ts}

@@ -15,18 +15,18 @@ import ws                     from "ws"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
-/*  SpeechFlow node for OpenAI Transcribe speech-to-text conversion  */
-export default class SpeechFlowNodeOpenAITranscribe extends SpeechFlowNode {
+/*  SpeechFlow node for OpenAI speech-to-text conversion  */
+export default class SpeechFlowNodeA2TOpenAI extends SpeechFlowNode {
     /*  declare official node name  */
-    public static name = "openaitranscribe"
+    public static name = "a2t-openai"
 
     /*  internal state  */
     private static speexInitialized = false
     private openai:     OpenAI | null = null
     private ws:         ws.WebSocket | null = null
-    private queue:      utils.SingleQueue<SpeechFlowChunk | null> | null = null
+    private queue:      util.SingleQueue<SpeechFlowChunk | null> | null = null
     private resampler:  SpeexResampler | null = null
     private destroyed   = false
     private connectionTimeout: ReturnType<typeof setTimeout> | null = null
@@ -64,17 +64,17 @@ export default class SpeechFlowNodeOpenAITranscribe extends SpeechFlowNode {
         this.destroyed = false
 
         /*  create queue for results  */
-        this.queue = new utils.SingleQueue<SpeechFlowChunk | null>()
+        this.queue = new util.SingleQueue<SpeechFlowChunk | null>()
 
         /*  create a store for the meta information  */
-        const metastore = new utils.TimeStore<Map<string, any>>()
+        const metastore = new util.TimeStore<Map<string, any>>()
 
         /*  establish resampler from our standard audio sample rate (48Khz)
             to OpenAI's maximum 24Khz input sample rate  */
-        if (!SpeechFlowNodeOpenAITranscribe.speexInitialized) {
+        if (!SpeechFlowNodeA2TOpenAI.speexInitialized) {
             /*  at least once initialize resampler  */
             await SpeexResampler.initPromise
-            SpeechFlowNodeOpenAITranscribe.speexInitialized = true
+            SpeechFlowNodeA2TOpenAI.speexInitialized = true
         }
         this.resampler = new SpeexResampler(1, this.config.audioSampleRate, 24000, 7)
 
@@ -281,7 +281,7 @@ export default class SpeechFlowNodeOpenAITranscribe 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-t2a-awspolly.ts → speechflow-node-t2a-amazon.ts}

@@ -17,12 +17,12 @@ import {
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
-/*  SpeechFlow node for AWS Polly text-to-speech conversion  */
-export default class SpeechFlowNodeAWSPolly extends SpeechFlowNode {
+/*  SpeechFlow node for Amazon Polly text-to-speech conversion  */
+export default class SpeechFlowNodeT2AAmazon extends SpeechFlowNode {
     /*  declare official node name  */
-    public static name = "awspolly"
+    public static name = "t2a-amazon"
 
     /*  internal state  */
     private client: PollyClient | null = null
@@ -114,10 +114,10 @@ export default class SpeechFlowNodeAWSPolly extends SpeechFlowNode {
 
         /*  establish resampler from AWS Polly's maximum 16Khz output
             (for PCM output) to our standard audio sample rate (48KHz)  */
-        if (!SpeechFlowNodeAWSPolly.speexInitialized) {
+        if (!SpeechFlowNodeT2AAmazon.speexInitialized) {
             /*  at least once initialize resampler  */
             await SpeexResampler.initPromise
-            SpeechFlowNodeAWSPolly.speexInitialized = true
+            SpeechFlowNodeT2AAmazon.speexInitialized = true
         }
         this.resampler = new SpeexResampler(1, 16000, this.config.audioSampleRate, 7)
 
@@ -146,7 +146,7 @@ export default class SpeechFlowNodeAWSPolly extends SpeechFlowNode {
                         this.push(chunkNew)
                         callback()
                     }).catch((error: unknown) => {
-                        callback(utils.ensureError(error, "failed to send to AWS Polly"))
+                        callback(util.ensureError(error, "failed to send to AWS Polly"))
                     })
                 }
                 else

package/speechflow-cli/src/speechflow-node-t2a-elevenlabs.ts

@@ -16,9 +16,9 @@ import SpeexResampler        from "speex-resampler"
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
 
 /*  SpeechFlow node for Elevenlabs text-to-speech conversion  */
-export default class SpeechFlowNodeElevenlabs extends SpeechFlowNode {
+export default class SpeechFlowNodeT2AElevenlabs extends SpeechFlowNode {
     /*  declare official node name  */
-    public static name = "elevenlabs"
+    public static name = "t2a-elevenlabs"
 
     /*  internal state  */
     private elevenlabs: ElevenLabs.ElevenLabsClient | null = null
@@ -131,10 +131,10 @@ export default class SpeechFlowNodeElevenlabs extends SpeechFlowNode {
 
         /*  establish resampler from ElevenLabs's maximum 24Khz
             output to our standard audio sample rate (48KHz)  */
-        if (!SpeechFlowNodeElevenlabs.speexInitialized) {
+        if (!SpeechFlowNodeT2AElevenlabs.speexInitialized) {
             /*  at least once initialize resampler  */
             await SpeexResampler.initPromise
-            SpeechFlowNodeElevenlabs.speexInitialized = true
+            SpeechFlowNodeT2AElevenlabs.speexInitialized = true
         }
         this.resampler = new SpeexResampler(1, maxSampleRate, this.config.audioSampleRate, 7)
 

package/speechflow-cli/src/speechflow-node-t2a-kokoro.ts

@@ -13,12 +13,12 @@ import SpeexResampler from "speex-resampler"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  SpeechFlow node for Kokoro text-to-speech conversion  */
-export default class SpeechFlowNodeKokoro extends SpeechFlowNode {
+export default class SpeechFlowNodeT2AKokoro extends SpeechFlowNode {
     /*  declare official node name  */
-    public static name = "kokoro"
+    public static name = "t2a-kokoro"
 
     /*  internal state  */
     private kokoro: KokoroTTS | null = null
@@ -82,9 +82,9 @@ export default class SpeechFlowNodeKokoro extends SpeechFlowNode {
 
         /*  establish resampler from Kokoro's maximum 24Khz
             output to our standard audio sample rate (48KHz)  */
-        if (!SpeechFlowNodeKokoro.speexInitialized) {
+        if (!SpeechFlowNodeT2AKokoro.speexInitialized) {
             /*  at least once initialize resampler  */
-            SpeechFlowNodeKokoro.speexInitialized = true
+            SpeechFlowNodeT2AKokoro.speexInitialized = true
             await SpeexResampler.initPromise
         }
         this.resampler = new SpeexResampler(1, 24000, this.config.audioSampleRate, 7)
@@ -143,7 +143,7 @@ export default class SpeechFlowNodeKokoro extends SpeechFlowNode {
                         this.push(chunk)
                         callback()
                     }).catch((error: unknown) => {
-                        callback(utils.ensureError(error))
+                        callback(util.ensureError(error))
                     })
                 }
             },

package/speechflow-cli/src/{speechflow-node-t2t-awstranslate.ts → speechflow-node-t2t-amazon.ts}

@@ -12,12 +12,12 @@ import { TranslateClient, TranslateTextCommand } from "@aws-sdk/client-translate
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
-/*  SpeechFlow node for AWS Translate text-to-text translations  */
-export default class SpeechFlowNodeAWSTranslate extends SpeechFlowNode {
+/*  SpeechFlow node for Amazon Translate text-to-text translations  */
+export default class SpeechFlowNodeT2TAmazon extends SpeechFlowNode {
     /*  declare official node name  */
-    public static name = "awstranslate"
+    public static name = "t2t-amazon"
 
     /*  internal state  */
     private client: TranslateClient | null = null
@@ -124,7 +124,7 @@ export default class SpeechFlowNodeAWSTranslate extends SpeechFlowNode {
                         this.push(chunkNew)
                         callback()
                     }).catch((error: unknown) => {
-                        callback(utils.ensureError(error))
+                        callback(util.ensureError(error))
                     })
                 }
             },

package/speechflow-cli/src/speechflow-node-t2t-deepl.ts

@@ -12,12 +12,12 @@ import * as DeepL from "deepl-node"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  SpeechFlow node for DeepL text-to-text translations  */
-export default class SpeechFlowNodeDeepL extends SpeechFlowNode {
+export default class SpeechFlowNodeT2TDeepL extends SpeechFlowNode {
     /*  declare official node name  */
-    public static name = "deepl"
+    public static name = "t2t-deepl"
 
     /*  internal state  */
     private deepl: DeepL.Translator | null = null
@@ -95,7 +95,7 @@ export default class SpeechFlowNodeDeepL extends SpeechFlowNode {
                         this.push(chunkNew)
                         callback()
                     }).catch((error: unknown) => {
-                        callback(utils.ensureError(error))
+                        callback(util.ensureError(error))
                     })
                 }
             },

package/speechflow-cli/src/speechflow-node-t2t-format.ts

@@ -14,9 +14,9 @@ import wrapText from "wrap-text"
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
 
 /*  SpeechFlow node for text-to-text formatting  */
-export default class SpeechFlowNodeFormat extends SpeechFlowNode {
+export default class SpeechFlowNodeT2TFormat extends SpeechFlowNode {
     /*  declare official node name  */
-    public static name = "format"
+    public static name = "t2t-format"
 
     /*  construct node  */
     constructor (id: string, cfg: { [ id: string ]: any }, opts: { [ id: string ]: any }, args: any[]) {

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

@@ -13,12 +13,12 @@ import * as arktype                 from "arktype"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  SpeechFlow node for Google Translate text-to-text translations  */
-export default class SpeechFlowNodeGoogle extends SpeechFlowNode {
+export default class SpeechFlowNodeT2TGoogle extends SpeechFlowNode {
     /*  declare official node name  */
-    public static name = "google"
+    public static name = "t2t-google"
 
     /*  internal state  */
     private client: TranslationServiceClient | null = null
@@ -55,9 +55,9 @@ export default class SpeechFlowNodeGoogle extends SpeechFlowNode {
     /*  open node  */
     async open () {
         /*  instantiate Google Translate client  */
-        const data = utils.run("Google Cloud API credentials key", () =>
+        const data = util.run("Google Cloud API credentials key", () =>
             JSON.parse(this.params.key))
-        const credentials = utils.importObject("Google Cloud API credentials key",
+        const credentials = util.importObject("Google Cloud API credentials key",
             data,
             arktype.type({
                 project_id:   "string",
@@ -74,7 +74,7 @@ export default class SpeechFlowNodeGoogle extends SpeechFlowNode {
         })
 
         /*  provide text-to-text translation  */
-        const translate = utils.runner("Google Translate API", async (text: string) => {
+        const translate = util.runner("Google Translate API", async (text: string) => {
             const [ response ] = await this.client!.translateText({
                 parent:   `projects/${credentials.project_id}/locations/global`,
                 contents: [ text ],
@@ -105,7 +105,7 @@ export default class SpeechFlowNodeGoogle extends SpeechFlowNode {
                         this.push(chunkNew)
                         callback()
                     }).catch((error: unknown) => {
-                        callback(utils.ensureError(error))
+                        callback(util.ensureError(error))
                     })
                 }
             },

package/speechflow-cli/src/speechflow-node-t2t-modify.ts

@@ -0,0 +1,84 @@
+/*
+**  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 Stream   from "node:stream"
+
+/*  internal dependencies  */
+import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
+import * as util                           from "./speechflow-util"
+
+/*  SpeechFlow node for text-to-text modification via regex  */
+export default class SpeechFlowNodeT2TModify extends SpeechFlowNode {
+    /*  declare official node name  */
+    public static name = "t2t-modify"
+
+    /*  construct node  */
+    constructor (id: string, cfg: { [ id: string ]: any }, opts: { [ id: string ]: any }, args: any[]) {
+        super(id, cfg, opts, args)
+
+        /*  declare node configuration parameters  */
+        this.configure({
+            match:   { type: "string", val: "" },
+            replace: { type: "string", val: "" }
+        })
+
+        /*  declare node input/output format  */
+        this.input  = "text"
+        this.output = "text"
+    }
+
+    /*  open node  */
+    async open () {
+        /*  validate parameters  */
+        if (this.params.match === "")
+            throw new Error("match parameter cannot be empty")
+
+        /*  compile regex pattern  */
+        const regex = util.run("compiling regex pattern",
+            () => new RegExp(this.params.match, "g"))
+
+        /*  apply regex-based modification  */
+        const modify = (text: string): string =>
+            text.replace(regex, this.params.replace)
+
+        /*  establish a duplex stream and connect it to text modification  */
+        this.stream = new Stream.Transform({
+            readableObjectMode: true,
+            writableObjectMode: true,
+            decodeStrings:      false,
+            highWaterMark:      1,
+            transform (chunk: SpeechFlowChunk, encoding, callback) {
+                if (Buffer.isBuffer(chunk.payload))
+                    callback(new Error("invalid chunk payload type"))
+                else if (chunk.payload === "") {
+                    this.push(chunk)
+                    callback()
+                }
+                else {
+                    const payload = modify(chunk.payload)
+                    const chunkNew = chunk.clone()
+                    chunkNew.payload = payload
+                    this.push(chunkNew)
+                    callback()
+                }
+            },
+            final (callback) {
+                this.push(null)
+                callback()
+            }
+        })
+    }
+
+    /*  close node  */
+    async close () {
+        /*  close stream  */
+        if (this.stream !== null) {
+            this.stream.destroy()
+            this.stream = null
+        }
+    }
+}

package/speechflow-cli/src/speechflow-node-t2t-ollama.ts

@@ -12,16 +12,16 @@ import { Ollama, type ListResponse } from "ollama"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  internal utility types  */
 type ConfigEntry = { systemPrompt: string, chat: Array<{ role: string, content: string }> }
 type Config      = { [ key: string ]: ConfigEntry }
 
 /*  SpeechFlow node for Ollama text-to-text translation  */
-export default class SpeechFlowNodeOllama extends SpeechFlowNode {
+export default class SpeechFlowNodeT2TOllama extends SpeechFlowNode {
     /*  declare official node name  */
-    public static name = "ollama"
+    public static name = "t2t-ollama"
 
     /*  internal state  */
     private ollama: Ollama | null = null
@@ -252,7 +252,7 @@ export default class SpeechFlowNodeOllama extends SpeechFlowNode {
                             this.push(chunkNew)
                             callback()
                         }).catch((error: unknown) => {
-                            callback(utils.ensureError(error))
+                            callback(util.ensureError(error))
                         })
                     }
                 }

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

@@ -12,16 +12,16 @@ import OpenAI from "openai"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
-import * as utils                          from "./speechflow-utils"
+import * as util                           from "./speechflow-util"
 
 /*  internal utility types  */
 type ConfigEntry = { systemPrompt: string, chat: OpenAI.ChatCompletionMessageParam[] }
 type Config      = { [ key: string ]: ConfigEntry }
 
 /*  SpeechFlow node for OpenAI/GPT text-to-text translation  */
-export default class SpeechFlowNodeOpenAI extends SpeechFlowNode {
+export default class SpeechFlowNodeT2TOpenAI extends SpeechFlowNode {
     /*  declare official node name  */
-    public static name = "openai"
+    public static name = "t2t-openai"
 
     /*  internal state  */
     private openai: OpenAI | null = null
@@ -221,7 +221,7 @@ export default class SpeechFlowNodeOpenAI extends SpeechFlowNode {
                         this.push(chunkNew)
                         callback()
                     }).catch((error: unknown) => {
-                        callback(utils.ensureError(error))
+                        callback(util.ensureError(error))
                     })
                 }
             },

package/speechflow-cli/src/speechflow-node-t2t-sentence.ts

@@ -12,7 +12,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"
 
 /*  text stream queue element */
 type TextQueueElement = {
@@ -24,12 +24,12 @@ type TextQueueElement = {
 }
 
 /*  SpeechFlow node for sentence splitting  */
-export default class SpeechFlowNodeSentence extends SpeechFlowNode {
+export default class SpeechFlowNodeT2TSentence extends SpeechFlowNode {
     /*  declare official node name  */
-    public static name = "sentence"
+    public static name = "t2t-sentence"
 
     /*  internal state  */
-    private queue      = new utils.Queue<TextQueueElement>()
+    private queue      = new util.Queue<TextQueueElement>()
     private queueRecv  = this.queue.pointerUse("recv")
     private queueSplit = this.queue.pointerUse("split")
     private queueSend  = this.queue.pointerUse("send")