speechflow 1.5.0 → 1.6.0

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

@@ -14,9 +14,9 @@ import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
 import * as utils                          from "./speechflow-utils"
 
 /*  SpeechFlow node for RNNoise based noise suppression in audio-to-audio passing  */
-export default class SpeechFlowNodeRNNoise extends SpeechFlowNode {
+export default class SpeechFlowNodeA2ARNNoise extends SpeechFlowNode {
     /*  declare official node name  */
-    public static name = "rnnoise"
+    public static name = "a2a-rnnoise"
 
     /*  internal state  */
     private destroyed = false

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

@@ -17,9 +17,9 @@ import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
 import * as utils                          from "./speechflow-utils"
 
 /*  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

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

@@ -30,9 +30,9 @@ 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

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}

@@ -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
@@ -224,8 +224,8 @@ export default class SpeechFlowNodeAWSTranscribe extends SpeechFlowNode {
                         if (chunk.meta.size > 0)
                             metastore.store(chunk.timestampStart, chunk.timestampEnd, chunk.meta)
                         audioQueue.push(new Uint8Array(chunk.payload)) /* intentionally discard all time information */
-                        ensureAudioStreamActive().catch((err) => {
-                            self.log("error", `failed to start audio stream: ${err}`)
+                        ensureAudioStreamActive().catch((error: unknown) => {
+                            self.log("error", `failed to start audio stream: ${utils.ensureError(error).message}`)
                         })
                     }
                     callback()
@@ -249,9 +249,9 @@ export default class SpeechFlowNodeAWSTranscribe extends SpeechFlowNode {
                         self.log("debug", `received data (${chunk.payload.length} bytes): "${chunk.payload}"`)
                         this.push(chunk)
                     }
-                }).catch((error) => {
+                }).catch((error: unknown) => {
                     if (!self.destroyed)
-                        self.log("error", `queue read error: ${error.message}`)
+                        self.log("error", `queue read error: ${utils.ensureError(error).message}`)
                 })
             },
             final (callback) {
@@ -259,12 +259,10 @@ export default class SpeechFlowNodeAWSTranscribe extends SpeechFlowNode {
                     callback()
                     return
                 }
-                try {
-                    self.client.destroy()
-                }
-                catch (error) {
-                    self.log("warning", `error closing Amazon Transcribe connection: ${error}`)
-                }
+                utils.run(
+                    () => self.client!.destroy(),
+                    (error: Error) => self.log("warning", `error closing Amazon Transcribe connection: ${error}`)
+                )
                 audioQueue.push(null) /* do not push null to stream, let Amazon Transcribe do it */
                 audioQueue.destroy()
                 callback()

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

@@ -16,9 +16,9 @@ import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
 import * as utils                          from "./speechflow-utils"
 
 /*  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
@@ -232,9 +232,9 @@ export default class SpeechFlowNodeDeepgram extends SpeechFlowNode {
                         self.log("debug", `received data (${chunk.payload.length} bytes)`)
                         this.push(chunk)
                     }
-                }).catch((error) => {
+                }).catch((error: unknown) => {
                     if (!self.destroyed)
-                        self.log("error", `queue read error: ${error.message}`)
+                        self.log("error", `queue read error: ${utils.ensureError(error).message}`)
                 })
             },
             final (callback) {

package/speechflow-cli/src/{speechflow-node-a2t-openaitranscribe.ts → speechflow-node-a2t-openai.ts}

@@ -17,10 +17,10 @@ import ws                     from "ws"
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
 import * as utils                          from "./speechflow-utils"
 
-/*  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
@@ -71,10 +71,10 @@ export default class SpeechFlowNodeOpenAITranscribe extends SpeechFlowNode {
 
         /*  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)
 
@@ -279,9 +279,9 @@ export default class SpeechFlowNodeOpenAITranscribe extends SpeechFlowNode {
                         self.log("debug", `received data (${chunk.payload.length} bytes)`)
                         this.push(chunk)
                     }
-                }).catch((error) => {
+                }).catch((error: unknown) => {
                     if (!self.destroyed)
-                        self.log("error", `queue read error: ${error.message}`)
+                        self.log("error", `queue read error: ${utils.ensureError(error).message}`)
                 })
             },
             final (callback) {

package/speechflow-cli/src/{speechflow-node-t2a-awspolly.ts → speechflow-node-t2a-amazon.ts}

@@ -17,11 +17,12 @@ import {
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
+import * as utils                          from "./speechflow-utils"
 
-/*  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
@@ -113,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)
 
@@ -144,9 +145,8 @@ export default class SpeechFlowNodeAWSPolly extends SpeechFlowNode {
                         chunkNew.payload = buffer
                         this.push(chunkNew)
                         callback()
-                    }).catch((error) => {
-                        callback(error instanceof Error ?
-                            error : new Error(`failed to send to AWS Polly: ${String(error)}`))
+                    }).catch((error: unknown) => {
+                        callback(utils.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,11 +13,12 @@ import SpeexResampler from "speex-resampler"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
+import * as utils                          from "./speechflow-utils"
 
 /*  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
@@ -81,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)
@@ -141,8 +142,8 @@ export default class SpeechFlowNodeKokoro extends SpeechFlowNode {
                         chunk.payload = buffer
                         this.push(chunk)
                         callback()
-                    }).catch((err) => {
-                        callback(err)
+                    }).catch((error: unknown) => {
+                        callback(utils.ensureError(error))
                     })
                 }
             },

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

@@ -12,11 +12,12 @@ import { TranslateClient, TranslateTextCommand } from "@aws-sdk/client-translate
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
+import * as utils                          from "./speechflow-utils"
 
-/*  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
@@ -122,8 +123,8 @@ export default class SpeechFlowNodeAWSTranslate extends SpeechFlowNode {
                         chunkNew.payload = payload
                         this.push(chunkNew)
                         callback()
-                    }).catch((err) => {
-                        callback(err)
+                    }).catch((error: unknown) => {
+                        callback(utils.ensureError(error))
                     })
                 }
             },

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

@@ -12,11 +12,12 @@ import * as DeepL from "deepl-node"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
+import * as utils                          from "./speechflow-utils"
 
 /*  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
@@ -93,8 +94,8 @@ export default class SpeechFlowNodeDeepL extends SpeechFlowNode {
                         chunkNew.payload = payload
                         this.push(chunkNew)
                         callback()
-                    }).catch((err) => {
-                        callback(err)
+                    }).catch((error: unknown) => {
+                        callback(utils.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

@@ -0,0 +1,133 @@
+/*
+**  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"
+
+/*  external dependencies  */
+import { TranslationServiceClient } from "@google-cloud/translate"
+import * as arktype                 from "arktype"
+
+/*  internal dependencies  */
+import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
+import * as utils                          from "./speechflow-utils"
+
+/*  SpeechFlow node for Google Translate text-to-text translations  */
+export default class SpeechFlowNodeT2TGoogle extends SpeechFlowNode {
+    /*  declare official node name  */
+    public static name = "t2t-google"
+
+    /*  internal state  */
+    private client: TranslationServiceClient | null = null
+
+    /*  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({
+            key: { type: "string",         val: process.env.SPEECHFLOW_GOOGLE_KEY ?? "" },
+            src: { type: "string", pos: 0, val: "de", match: /^(?:de|en|fr|it)$/ },
+            dst: { type: "string", pos: 1, val: "en", match: /^(?:de|en|fr|it)$/ }
+        })
+
+        /*  validate API key and project  */
+        if (this.params.key === "")
+            throw new Error("Google Cloud API credentials JSON key is required")
+
+        /*  sanity check situation  */
+        if (this.params.src === this.params.dst)
+            throw new Error("source and destination languages cannot be the same")
+
+        /*  declare node input/output format  */
+        this.input  = "text"
+        this.output = "text"
+    }
+
+    /*  one-time status of node  */
+    async status () {
+        return {}
+    }
+
+    /*  open node  */
+    async open () {
+        /*  instantiate Google Translate client  */
+        const data = utils.run("Google Cloud API credentials key", () =>
+            JSON.parse(this.params.key))
+        const credentials = utils.importObject("Google Cloud API credentials key",
+            data,
+            arktype.type({
+                project_id:   "string",
+                private_key:  "string",
+                client_email: "string",
+            })
+        )
+        this.client = new TranslationServiceClient({
+            credentials: {
+                private_key:  credentials.private_key,
+                client_email: credentials.client_email
+            },
+            projectId: credentials.project_id
+        })
+
+        /*  provide text-to-text translation  */
+        const translate = utils.runner("Google Translate API", async (text: string) => {
+            const [ response ] = await this.client!.translateText({
+                parent:   `projects/${credentials.project_id}/locations/global`,
+                contents: [ text ],
+                mimeType: "text/plain",
+                sourceLanguageCode: this.params.src,
+                targetLanguageCode: this.params.dst
+            })
+            return response.translations?.[0]?.translatedText ?? text
+        })
+
+        /*  establish a duplex stream and connect it to Google Translate  */
+        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 {
+                    translate(chunk.payload).then((payload) => {
+                        const chunkNew = chunk.clone()
+                        chunkNew.payload = payload
+                        this.push(chunkNew)
+                        callback()
+                    }).catch((error: unknown) => {
+                        callback(utils.ensureError(error))
+                    })
+                }
+            },
+            final (callback) {
+                this.push(null)
+                callback()
+            }
+        })
+    }
+
+    /*  close node  */
+    async close () {
+        /*  close stream  */
+        if (this.stream !== null) {
+            this.stream.destroy()
+            this.stream = null
+        }
+
+        /*  shutdown Google Translate client  */
+        if (this.client !== null) {
+            this.client.close()
+            this.client = null
+        }
+    }
+}

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 utils                          from "./speechflow-utils"
+
+/*  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 = utils.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,15 +12,16 @@ import { Ollama, type ListResponse } from "ollama"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
+import * as utils                          from "./speechflow-utils"
 
 /*  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
@@ -250,8 +251,8 @@ export default class SpeechFlowNodeOllama extends SpeechFlowNode {
                             chunkNew.payload = payload
                             this.push(chunkNew)
                             callback()
-                        }).catch((err) => {
-                            callback(err)
+                        }).catch((error: unknown) => {
+                            callback(utils.ensureError(error))
                         })
                     }
                 }

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

@@ -12,15 +12,16 @@ import OpenAI from "openai"
 
 /*  internal dependencies  */
 import SpeechFlowNode, { SpeechFlowChunk } from "./speechflow-node"
+import * as utils                          from "./speechflow-utils"
 
 /*  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
@@ -219,8 +220,8 @@ export default class SpeechFlowNodeOpenAI extends SpeechFlowNode {
                         chunkNew.payload = payload
                         this.push(chunkNew)
                         callback()
-                    }).catch((err) => {
-                        callback(err)
+                    }).catch((error: unknown) => {
+                        callback(utils.ensureError(error))
                     })
                 }
             },

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

@@ -24,9 +24,9 @@ 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>()