speechflow 1.7.1 → 2.0.0

package/speechflow-cli/dst/speechflow-util-llm.d.ts

@@ -0,0 +1,35 @@
+import EventEmitter from "node:events";
+export type LLMCompleteMessage = {
+    role: "system" | "user" | "assistant";
+    content: string;
+};
+export type LLMConfig = {
+    provider?: "openai" | "anthropic" | "google" | "ollama" | "transformers";
+    api?: string;
+    model?: string;
+    key?: string;
+    timeout?: number;
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    cacheDir?: string;
+};
+export type LLMCompleteOptions = {
+    system?: string;
+    messages?: LLMCompleteMessage[];
+    prompt: string;
+};
+export declare class LLM extends EventEmitter {
+    private config;
+    private openai;
+    private anthropic;
+    private google;
+    private ollama;
+    private transformer;
+    private initialized;
+    constructor(config: LLMConfig);
+    private log;
+    open(): Promise<void>;
+    complete(options: LLMCompleteOptions): Promise<string>;
+    close(): Promise<void>;
+}

package/speechflow-cli/dst/speechflow-util-llm.js

@@ -0,0 +1,363 @@
+"use strict";
+/*
+**  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>
+*/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLM = void 0;
+/*  standard dependencies  */
+const node_events_1 = __importDefault(require("node:events"));
+/*  external dependencies  */
+const openai_1 = __importDefault(require("openai"));
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const genai_1 = require("@google/genai");
+const ollama_1 = require("ollama");
+const Transformers = __importStar(require("@huggingface/transformers"));
+/*  LLM class for unified LLM access  */
+class LLM extends node_events_1.default {
+    /*  internal state  */
+    config;
+    openai = null;
+    anthropic = null;
+    google = null;
+    ollama = null;
+    transformer = null;
+    initialized = false;
+    /*  construct LLM instance  */
+    constructor(config) {
+        /*  pass-through to EventEmitter  */
+        super();
+        /*  provide configuration defaults  */
+        this.config = {
+            provider: "openai",
+            api: "",
+            model: "",
+            key: "",
+            timeout: 30 * 1000,
+            temperature: 0.7,
+            maxTokens: 1024,
+            topP: 0.5,
+            cacheDir: "",
+            ...config
+        };
+        /*  validate configuration options  */
+        if (this.config.key === "") {
+            if (this.config.provider === "openai")
+                this.config.key = process.env.SPEECHFLOW_OPENAI_KEY ?? "";
+            else if (this.config.provider === "anthropic")
+                this.config.key = process.env.SPEECHFLOW_ANTHROPIC_KEY ?? "";
+            else if (this.config.provider === "google")
+                this.config.key = process.env.SPEECHFLOW_GOOGLE_KEY ?? "";
+            if (this.config.provider.match(/^(?:openai|anthropic|google)$/) && this.config.key === "")
+                throw new Error(`API key is required for provider "${this.config.provider}"`);
+        }
+        if (this.config.model === "")
+            throw new Error("model is required");
+    }
+    /*  internal logging helper  */
+    log(level, message) {
+        this.emit("log", level, message);
+    }
+    /*  initialize the LLM client  */
+    async open() {
+        if (this.initialized)
+            return;
+        if (this.config.provider === "openai") {
+            /*  instantiate OpenAI API  */
+            this.openai = new openai_1.default({
+                ...(this.config.api !== "" ? { baseURL: this.config.api } : {}),
+                apiKey: this.config.key,
+                timeout: this.config.timeout
+            });
+        }
+        else if (this.config.provider === "anthropic") {
+            /*  instantiate Anthropic API  */
+            this.anthropic = new sdk_1.default({
+                ...(this.config.api !== "" ? { baseURL: this.config.api } : {}),
+                apiKey: this.config.key,
+                timeout: this.config.timeout
+            });
+        }
+        else if (this.config.provider === "google") {
+            /*  instantiate Google API  */
+            this.google = new genai_1.GoogleGenAI({
+                apiKey: this.config.key,
+                httpOptions: {
+                    timeout: this.config.timeout,
+                    ...(this.config.api !== "" ? { baseUrl: this.config.api } : {})
+                }
+            });
+        }
+        else if (this.config.provider === "ollama") {
+            /*  instantiate Ollama API  */
+            this.ollama = new ollama_1.Ollama({ host: this.config.api });
+            /*  ensure the model is available  */
+            let models;
+            try {
+                models = await this.ollama.list();
+            }
+            catch (err) {
+                throw new Error(`failed to connect to Ollama API at ${this.config.api}: ${err}`, { cause: err });
+            }
+            const exists = models.models.some((m) => m.name === this.config.model);
+            if (!exists) {
+                this.log("info", `LLM: model "${this.config.model}" still not present in Ollama -- ` +
+                    "automatically downloading model");
+                let artifact = "";
+                let percent = 0;
+                let lastLoggedPercent = -1;
+                const interval = setInterval(() => {
+                    if (percent !== lastLoggedPercent) {
+                        this.log("info", `LLM: downloaded ${percent.toFixed(2)}% of artifact "${artifact}"`);
+                        lastLoggedPercent = percent;
+                    }
+                }, 1000);
+                try {
+                    const progress = await this.ollama.pull({ model: this.config.model, stream: true });
+                    for await (const event of progress) {
+                        if (event.digest)
+                            artifact = event.digest;
+                        if (event.completed && event.total)
+                            percent = (event.completed / event.total) * 100;
+                    }
+                }
+                finally {
+                    clearInterval(interval);
+                }
+            }
+        }
+        else if (this.config.provider === "transformers") {
+            /*  track download progress when instantiating Transformers pipeline  */
+            const progressState = new Map();
+            const progressCallback = (progress) => {
+                let artifact = this.config.model;
+                if (typeof progress.file === "string")
+                    artifact += `:${progress.file}`;
+                let percent = 0;
+                if (typeof progress.loaded === "number" && typeof progress.total === "number")
+                    percent = (progress.loaded / progress.total) * 100;
+                else if (typeof progress.progress === "number")
+                    percent = progress.progress;
+                if (percent > 0)
+                    progressState.set(artifact, percent);
+            };
+            const interval = setInterval(() => {
+                for (const [artifact, percent] of progressState) {
+                    this.log("info", `LLM: downloaded ${percent.toFixed(2)}% of artifact "${artifact}"`);
+                    if (percent >= 100.0)
+                        progressState.delete(artifact);
+                }
+            }, 1000);
+            /*  instantiate HuggingFace Transformers text generation pipeline  */
+            try {
+                const pipelinePromise = Transformers.pipeline("text-generation", this.config.model, {
+                    ...(this.config.cacheDir !== "" ? { cache_dir: this.config.cacheDir } : {}),
+                    dtype: "q4",
+                    device: "auto",
+                    progress_callback: progressCallback
+                });
+                this.transformer = await pipelinePromise;
+            }
+            catch (err) {
+                throw new Error(`failed to instantiate HuggingFace Transformers pipeline: ${err}`, { cause: err });
+            }
+            finally {
+                clearInterval(interval);
+            }
+            if (this.transformer === null)
+                throw new Error("failed to instantiate HuggingFace Transformers pipeline");
+        }
+        else {
+            const exhaustive = this.config.provider;
+            throw new Error(`unsupported LLM provider: ${exhaustive}`);
+        }
+        this.log("info", `LLM: initialized ${this.config.provider} client ` +
+            `(${this.config.api !== "" ? `api: ${this.config.api}, ` : ""}model: ${this.config.model})`);
+        this.initialized = true;
+    }
+    /*  perform a completion  */
+    async complete(options) {
+        if (!this.initialized)
+            throw new Error("LLM still not initialized");
+        /*  build messages array  */
+        const messages = [];
+        if (options.system)
+            messages.push({ role: "system", content: options.system });
+        if (options.messages)
+            messages.push(...options.messages);
+        messages.push({ role: "user", content: options.prompt });
+        /*  perform LLM query  */
+        if (this.config.provider === "openai") {
+            if (!this.openai)
+                throw new Error("OpenAI client not available");
+            /*  perform OpenAI chat completion  */
+            const completion = await this.openai.chat.completions.create({
+                model: this.config.model,
+                max_tokens: this.config.maxTokens,
+                temperature: this.config.temperature,
+                top_p: this.config.topP,
+                messages: messages
+            }).catch((err) => {
+                throw new Error(`failed to perform OpenAI chat completion: ${err}`, { cause: err });
+            });
+            const content = completion?.choices?.[0]?.message?.content;
+            if (!content)
+                throw new Error("OpenAI API returned empty content");
+            return content;
+        }
+        else if (this.config.provider === "anthropic") {
+            if (!this.anthropic)
+                throw new Error("Anthropic client not available");
+            /*  separate system message from other messages for Anthropic API  */
+            const systemMessage = messages.find((m) => m.role === "system");
+            const chatMessages = messages.filter((m) => m.role !== "system");
+            /*  perform Anthropic chat completion  */
+            const message = await this.anthropic.messages.create({
+                model: this.config.model,
+                max_tokens: this.config.maxTokens,
+                temperature: this.config.temperature,
+                top_p: this.config.topP,
+                system: systemMessage?.content,
+                messages: chatMessages
+            }).catch((err) => {
+                throw new Error(`failed to perform Anthropic chat completion: ${err}`, { cause: err });
+            });
+            const content = message?.content?.[0];
+            if (!content || content.type !== "text")
+                throw new Error("Anthropic API returned empty or non-text content");
+            return content.text;
+        }
+        else if (this.config.provider === "google") {
+            if (!this.google)
+                throw new Error("Google client not available");
+            /*  convert messages for Google API  */
+            const systemInstruction = messages.find((m) => m.role === "system")?.content;
+            const contents = messages.filter((m) => m.role !== "system").map((m) => ({
+                role: m.role === "assistant" ? "model" : "user",
+                parts: [{ text: m.content }]
+            }));
+            /*  perform Google chat completion  */
+            const response = await this.google.models.generateContent({
+                model: this.config.model,
+                contents,
+                config: {
+                    maxOutputTokens: this.config.maxTokens,
+                    temperature: this.config.temperature,
+                    topP: this.config.topP,
+                    ...(systemInstruction ? { systemInstruction } : {})
+                }
+            }).catch((err) => {
+                throw new Error(`failed to perform Google chat completion: ${err}`, { cause: err });
+            });
+            const content = response?.text;
+            if (!content)
+                throw new Error("Google API returned empty content");
+            return content;
+        }
+        else if (this.config.provider === "ollama") {
+            if (!this.ollama)
+                throw new Error("Ollama client not available");
+            /*  perform Ollama chat completion  */
+            const response = await this.ollama.chat({
+                model: this.config.model,
+                messages,
+                keep_alive: "10m",
+                options: {
+                    num_predict: this.config.maxTokens,
+                    temperature: this.config.temperature,
+                    top_p: this.config.topP
+                }
+            }).catch((err) => {
+                throw new Error(`failed to perform Ollama chat completion: ${err}`, { cause: err });
+            });
+            const content = response?.message?.content;
+            if (!content)
+                throw new Error("Ollama API returned empty content");
+            return content;
+        }
+        else if (this.config.provider === "transformers") {
+            if (!this.transformer)
+                throw new Error("HuggingFace Transformers pipeline not available");
+            /*  perform HuggingFace Transformers text generation  */
+            const result = await this.transformer(messages, {
+                max_new_tokens: this.config.maxTokens,
+                temperature: this.config.temperature,
+                top_p: this.config.topP,
+                do_sample: true
+            }).catch((err) => {
+                throw new Error(`failed to perform HuggingFace Transformers text generation: ${err}`, { cause: err });
+            });
+            const single = Array.isArray(result) ? result[0] : result;
+            const generatedText = single.generated_text;
+            const content = typeof generatedText === "string" ?
+                generatedText :
+                generatedText.at(-1)?.content;
+            if (!content)
+                throw new Error("HuggingFace Transformers API returned empty content");
+            return content;
+        }
+        else {
+            const exhaustive = this.config.provider;
+            throw new Error(`unsupported LLM provider: ${exhaustive}`);
+        }
+    }
+    /*  close the LLM client  */
+    async close() {
+        if (!this.initialized)
+            return;
+        if (this.config.provider === "openai")
+            this.openai = null;
+        else if (this.config.provider === "anthropic")
+            this.anthropic = null;
+        else if (this.config.provider === "google")
+            this.google = null;
+        else if (this.config.provider === "ollama") {
+            this.ollama?.abort();
+            this.ollama = null;
+        }
+        else if (this.config.provider === "transformers") {
+            this.transformer?.dispose();
+            this.transformer = null;
+        }
+        this.initialized = false;
+    }
+}
+exports.LLM = LLM;
+//# sourceMappingURL=speechflow-util-llm.js.map

package/speechflow-cli/dst/speechflow-util-llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speechflow-util-llm.js","sourceRoot":"","sources":["../src/speechflow-util-llm.ts"],"names":[],"mappings":"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"}

package/speechflow-cli/dst/speechflow-util.d.ts

@@ -3,3 +3,4 @@ export * from "./speechflow-util-error";
 export * from "./speechflow-util-stream";
 export * from "./speechflow-util-queue";
 export * from "./speechflow-util-misc";
+export * from "./speechflow-util-llm";

package/speechflow-cli/dst/speechflow-util.js

@@ -24,4 +24,5 @@ __exportStar(require("./speechflow-util-error"), exports);
 __exportStar(require("./speechflow-util-stream"), exports);
 __exportStar(require("./speechflow-util-queue"), exports);
 __exportStar(require("./speechflow-util-misc"), exports);
+__exportStar(require("./speechflow-util-llm"), exports);
 //# sourceMappingURL=speechflow-util.js.map

package/speechflow-cli/dst/speechflow-util.js.map

@@ -1 +1 @@
-{"version":3,"file":"speechflow-util.js","sourceRoot":"","sources":["../src/speechflow-util.ts"],"names":[],"mappings":";AAAA;;;;EAIE;;;;;;;;;;;;;;;;AAEF,0DAAuC;AACvC,0DAAuC;AACvC,2DAAwC;AACxC,0DAAuC;AACvC,yDAAsC"}
+{"version":3,"file":"speechflow-util.js","sourceRoot":"","sources":["../src/speechflow-util.ts"],"names":[],"mappings":";AAAA;;;;EAIE;;;;;;;;;;;;;;;;AAEF,0DAAuC;AACvC,0DAAuC;AACvC,2DAAwC;AACxC,0DAAuC;AACvC,yDAAsC;AACtC,wDAAqC"}

package/speechflow-cli/etc/oxlint.jsonc

@@ -126,7 +126,8 @@
         "no-param-reassign":                  "off",
         "prefer-top-level-await":             "off",
         "no-process-env":                     "off",
-        "no-warning-comments":                "off"
+        "no-warning-comments":                "off",
+        "no-array-callback-reference":        "off"
     }
 }
 

package/speechflow-cli/package.json

@@ -20,18 +20,22 @@
         "flowlink":                             "1.2.3",
         "js-yaml":                              "4.1.1",
         "@gpeng/naudiodon":                     "2.4.1",
+        "execa":                                "9.6.1",
+        "shell-parser":                         "1.0.0",
         "@deepgram/sdk":                        "4.11.2",
-        "deepl-node":                           "1.22.0",
-        "@elevenlabs/elevenlabs-js":            "2.26.0",
+        "deepl-node":                           "1.24.0",
+        "@elevenlabs/elevenlabs-js":            "2.27.0",
         "get-stream":                           "9.0.1",
-        "@dotenvx/dotenvx":                     "1.51.1",
+        "@dotenvx/dotenvx":                     "1.51.2",
         "speex-resampler":                      "3.0.1",
         "@sapphi-red/speex-preprocess-wasm":    "0.4.0",
         "@shiguredo/rnnoise-wasm":              "2025.1.5",
-        "@aws-sdk/client-transcribe-streaming": "3.946.0",
-        "@aws-sdk/client-translate":            "3.946.0",
-        "@aws-sdk/client-polly":                "3.946.0",
+        "@aws-sdk/client-transcribe-streaming": "3.948.0",
+        "@aws-sdk/client-translate":            "3.948.0",
+        "@aws-sdk/client-polly":                "3.948.0",
         "@google-cloud/translate":              "9.3.0",
+        "@google-cloud/speech":                 "7.2.1",
+        "@google-cloud/text-to-speech":         "6.4.0",
         "node-web-audio-api":                   "1.0.7",
         "object-path":                          "0.11.8",
         "glob":                                 "13.0.0",
@@ -46,40 +50,49 @@
         "@opensumi/reconnecting-websocket":     "4.4.0",
         "ollama":                               "0.6.3",
         "openai":                               "6.10.0",
+        "@anthropic-ai/sdk":                    "0.71.2",
+        "@google/genai":                        "1.33.0",
         "@rse/ffmpeg":                          "1.4.2",
         "ffmpeg-stream":                        "1.0.1",
         "installed-packages":                   "1.0.13",
         "syspath":                              "1.0.8",
         "wav":                                  "1.0.2",
         "mqtt":                                 "5.14.1",
+        "vban":                                 "1.5.6",
         "cbor2":                                "2.0.1",
-        "arktype":                              "2.1.28",
+        "arktype":                              "2.1.29",
         "pure-uuid":                            "1.8.1",
         "wavefile":                             "11.0.0",
         "audio-inspect":                        "0.0.4",
         "@huggingface/transformers":            "3.8.1",
+        "@huggingface/hub":                     "2.7.1",
+        "onnxruntime-node":                     "1.20.1",
         "kokoro-js":                            "1.2.1",
         "@ericedouard/vad-node-realtime":       "0.2.0",
         "osc-js":                               "2.4.1",
         "luxon":                                "3.7.2",
         "node-interval-tree":                   "2.1.2",
         "wrap-text":                            "1.0.10",
+        "bad-words-next":                       "3.2.0",
         "cli-table3":                           "0.6.5",
+        "mkdirp":                               "3.0.1",
         "@soundtouchjs/audio-worklet":          "0.2.1",
+        "werift":                               "0.22.2",
+        "@discordjs/opus":                      "0.10.0",
         "@rse/stx":                             "1.1.2"
     },
     "devDependencies": {
-        "eslint":                               "9.39.1",
-        "@eslint/js":                           "9.39.1",
+        "eslint":                               "9.39.2",
+        "@eslint/js":                           "9.39.2",
         "neostandard":                          "0.12.2",
         "eslint-plugin-promise":                "7.2.1",
         "eslint-plugin-import":                 "2.32.0",
         "eslint-plugin-node":                   "11.1.0",
-        "typescript-eslint":                    "8.48.1",
-        "@typescript-eslint/eslint-plugin":     "8.48.1",
-        "@typescript-eslint/parser":            "8.48.1",
-        "oxlint":                               "1.31.0",
-        "eslint-plugin-oxlint":                 "1.31.0",
+        "typescript-eslint":                    "8.49.0",
+        "@typescript-eslint/eslint-plugin":     "8.49.0",
+        "@typescript-eslint/parser":            "8.49.0",
+        "oxlint":                               "1.32.0",
+        "eslint-plugin-oxlint":                 "1.32.0",
         "@biomejs/biome":                       "2.0.6",
         "eslint-config-biome":                  "2.1.3",
 
@@ -98,15 +111,19 @@
         "stmux":                                "1.8.11",
         "nodemon":                              "3.1.11",
         "shx":                                  "0.4.0",
-        "@yao-pkg/pkg":                         "6.10.1",
+        "@yao-pkg/pkg":                         "6.11.0",
         "typescript":                           "5.9.3",
         "delay-cli":                            "3.0.0",
         "cross-env":                            "10.1.0"
     },
     "overrides": {
-        "@huggingface/transformers":            { "onnxruntime-node": "1.23.0-dev.20250703-7fc6235861" }
+        "@huggingface/transformers":            { "onnxruntime-node": "1.23.2" }
     },
-    "upd":                                      [ "!@biomejs/biome" ],
+    "upd": [
+        "!@biomejs/biome",
+        "!onnxruntime-node",
+        "!@types/node"
+    ],
     "engines": {
         "node":                                 ">=22.0.0"
     },

package/speechflow-cli/src/lib.d.ts

@@ -35,3 +35,8 @@ declare function registerProcessor(
     processorCtor: new (...args: any[]) => AudioWorkletProcessor
 ): void
 
+/*  type definition for "shell-parser"  */
+declare module "shell-parser" {
+    export default function shellParser (command: string): string[]
+}
+

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

@@ -237,7 +237,32 @@ export class NodeGraph {
         this.cli.log("info", "**** everything established -- stream processing in SpeechFlow graph starts ****")
     }
 
-    /*  graph destruction: PASS 1: disconnect node streams  */
+    /*  graph destruction: PASS 1: end node streams  */
+    async endStreams(): Promise<void> {
+        /*  end all writable streams and wait for them to drain  */
+        const drainPromises: Promise<void>[] = []
+        for (const node of this.graphNodes) {
+            if (node.stream === null)
+                continue
+            const stream = node.stream
+            if ((stream instanceof Stream.Writable || stream instanceof Stream.Duplex) &&
+                (!stream.writableEnded && !stream.destroyed)) {
+                drainPromises.push(
+                    Promise.race([
+                        new Promise<void>((resolve) => {
+                            stream.end(() => { resolve() })
+                        }),
+                        util.timeout(5000)
+                    ]).catch(() => {
+                        /*  ignore timeout -- stream will be destroyed later  */
+                    })
+                )
+            }
+        }
+        await Promise.all(drainPromises)
+    }
+
+    /*  graph destruction: PASS 2: disconnect node streams  */
     async disconnectStreams(): Promise<void> {
         for (const node of this.graphNodes) {
             if (node.stream === null) {
@@ -265,7 +290,7 @@ export class NodeGraph {
         }
     }
 
-    /*  graph destruction: PASS 2: close nodes  */
+    /*  graph destruction: PASS 3: close nodes  */
     async closeNodes(): Promise<void> {
         for (const node of this.graphNodes) {
             this.cli.log("info", `close node <${node.id}>`)
@@ -278,7 +303,7 @@ export class NodeGraph {
         }
     }
 
-    /*  graph destruction: PASS 3: disconnect nodes  */
+    /*  graph destruction: PASS 4: disconnect nodes  */
     disconnectNodes(): void {
         for (const node of this.graphNodes) {
             this.cli.log("info", `disconnect node <${node.id}>`)
@@ -289,7 +314,7 @@ export class NodeGraph {
         }
     }
 
-    /*  graph destruction: PASS 4: destroy nodes  */
+    /*  graph destruction: PASS 5: destroy nodes  */
     destroyNodes(): void {
         for (const node of this.graphNodes) {
             this.cli.log("info", `destroy node <${node.id}>`)
@@ -345,7 +370,8 @@ export class NodeGraph {
         /*  shutdown API service  */
         await api.stop(args)
 
-        /*  disconnect, close and destroy nodes  */
+        /*  gracefully end, disconnect, close and destroy nodes  */
+        await this.endStreams()
         await this.disconnectStreams()
         await this.closeNodes()
         this.disconnectNodes()