speechflow 1.5.1 → 1.6.1

package/speechflow-cli/dst/speechflow-main-api.js

@@ -0,0 +1,319 @@
+"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.APIServer = void 0;
+/*  standard dependencies  */
+const node_path_1 = __importDefault(require("node:path"));
+/*  external dependencies  */
+const HAPI = __importStar(require("@hapi/hapi"));
+const inert_1 = __importDefault(require("@hapi/inert"));
+const ws_1 = __importDefault(require("ws"));
+const hapi_plugin_websocket_1 = __importDefault(require("hapi-plugin-websocket"));
+const hapi_plugin_header_1 = __importDefault(require("hapi-plugin-header"));
+const osc_js_1 = __importDefault(require("osc-js"));
+const arktype = __importStar(require("arktype"));
+/*  internal dependencies  */
+const util = __importStar(require("./speechflow-util"));
+const package_json_1 = __importDefault(require("../../package.json"));
+/*  Application Programming Interface (API) server management class  */
+class APIServer {
+    cli;
+    /*  internal state  */
+    wsPeers = new Map();
+    hapi = null;
+    sendOSC = null;
+    /*  creation  */
+    constructor(cli) {
+        this.cli = cli;
+    }
+    /*  start API server service  */
+    async start(args, graph) {
+        /*  define external request/response structure  */
+        const requestValidator = arktype.type({
+            request: "string",
+            node: "string",
+            args: "unknown[]"
+        });
+        /*  forward external request to target node in graph  */
+        const consumeExternalRequest = async (_req) => {
+            const req = requestValidator(_req);
+            if (req instanceof arktype.type.errors)
+                throw new Error(`invalid request: ${req.summary}`);
+            if (req.request !== "COMMAND")
+                throw new Error("invalid external request (command expected)");
+            const name = req.node;
+            const argList = req.args;
+            const foundNode = graph.findGraphNode(name);
+            if (foundNode === undefined) {
+                this.cli.log("warning", `external request failed: no such node <${name}>`);
+                throw new Error(`external request failed: no such node <${name}>`);
+            }
+            else {
+                await Promise.race([
+                    foundNode.receiveRequest(argList),
+                    new Promise((resolve, reject) => setTimeout(() => reject(new Error("timeout")), 10 * 1000))
+                ]).catch((err) => {
+                    this.cli.log("warning", `external request to node <${name}> failed: ${err.message}`);
+                });
+            }
+        };
+        /*  establish REST/WebSocket API  */
+        this.hapi = new HAPI.Server({
+            address: args.a,
+            port: args.p
+        });
+        await this.hapi.register({ plugin: inert_1.default });
+        await this.hapi.register({ plugin: hapi_plugin_header_1.default, options: { Server: `${package_json_1.default.name}/${package_json_1.default.version}` } });
+        await this.hapi.register({ plugin: hapi_plugin_websocket_1.default });
+        this.hapi.events.on("response", (request) => {
+            let protocol = `HTTP/${request.raw.req.httpVersion}`;
+            const ws = request.websocket();
+            if (ws.mode === "websocket") {
+                const wsVersion = ws.ws.protocolVersion ??
+                    request.headers["sec-websocket-version"] ?? "13?";
+                protocol = `WebSocket/${wsVersion}+${protocol}`;
+            }
+            const msg = "remote=" + request.info.remoteAddress + ", " +
+                "method=" + request.method.toUpperCase() + ", " +
+                "url=" + request.url.pathname + ", " +
+                "protocol=" + protocol + ", " +
+                "response=" + ("statusCode" in request.response ? request.response.statusCode : "<unknown>");
+            this.cli.log("info", `HAPI: request: ${msg}`);
+        });
+        this.hapi.events.on({ name: "request", channels: ["error"] }, (request, event, tags) => {
+            if (event.error instanceof Error)
+                this.cli.log("error", `HAPI: request-error: ${event.error.message}`);
+            else
+                this.cli.log("error", `HAPI: request-error: ${event.error}`);
+        });
+        this.hapi.events.on("log", (event, tags) => {
+            if (tags.error) {
+                const err = event.error;
+                if (err instanceof Error)
+                    this.cli.log("error", `HAPI: log: ${err.message}`);
+                else
+                    this.cli.log("error", `HAPI: log: ${err}`);
+            }
+        });
+        /*  define REST/WebSocket API endpoints  */
+        this.hapi.route({
+            method: "GET",
+            path: "/{param*}",
+            handler: {
+                directory: {
+                    path: node_path_1.default.join(__dirname, "../../speechflow-ui-db/dst"),
+                    redirectToSlash: true,
+                    index: true
+                }
+            }
+        });
+        this.hapi.route({
+            method: "GET",
+            path: "/api/dashboard",
+            handler: (request, h) => {
+                const config = [];
+                for (const block of args.d.split(",")) {
+                    const [type, id, name] = block.split(":");
+                    config.push({ type, id, name });
+                }
+                return h.response(config).code(200);
+            }
+        });
+        this.hapi.route({
+            method: "GET",
+            path: "/api/{req}/{node}/{params*}",
+            options: {},
+            handler: (request, h) => {
+                const peer = request.info.remoteAddress;
+                const params = request.params.params ?? "";
+                if (params.length > 1000)
+                    return h.response({ response: "ERROR", data: "parameters too long" }).code(400);
+                const req = {
+                    request: request.params.req,
+                    node: request.params.node,
+                    args: params.split("/").filter((seg) => seg !== "")
+                };
+                this.cli.log("info", `HAPI: peer ${peer}: GET: ${JSON.stringify(req)}`);
+                return consumeExternalRequest(req)
+                    .then(() => h.response({ response: "OK" }).code(200))
+                    .catch((error) => h.response({ response: "ERROR", data: util.ensureError(error).message }).code(417));
+            }
+        });
+        this.hapi.route({
+            method: "POST",
+            path: "/api",
+            options: {
+                payload: {
+                    output: "data",
+                    parse: true,
+                    allow: "application/json",
+                    maxBytes: 1 * 1024 * 1024
+                },
+                plugins: {
+                    websocket: {
+                        autoping: 30 * 1000,
+                        connect: (argList) => {
+                            const ctx = argList.ctx;
+                            const ws = argList.ws;
+                            const req = argList.req;
+                            const peer = `${req.socket.remoteAddress}:${req.socket.remotePort}`;
+                            ctx.peer = peer;
+                            this.wsPeers.set(peer, { ctx, ws, req });
+                            this.cli.log("info", `HAPI: WebSocket: connect: peer ${peer}`);
+                        },
+                        disconnect: (argList) => {
+                            const ctx = argList.ctx;
+                            const ws = argList.ws;
+                            const peer = ctx.peer;
+                            this.wsPeers.delete(peer);
+                            ws.removeAllListeners();
+                            if (ws.readyState === ws_1.default.OPEN)
+                                ws.close();
+                            this.cli.log("info", `HAPI: WebSocket: disconnect: peer ${peer}`);
+                        }
+                    }
+                }
+            },
+            handler: (request, h) => {
+                /*  on WebSocket message transfer  */
+                const peer = request.info.remoteAddress;
+                const req = requestValidator(request.payload);
+                if (req instanceof arktype.type.errors)
+                    return h.response({ response: "ERROR", data: `invalid request: ${req.summary}` }).code(417);
+                this.cli.log("info", `HAPI: peer ${peer}: POST: ${JSON.stringify(req)}`);
+                return consumeExternalRequest(req)
+                    .then(() => h.response({ response: "OK" }).code(200))
+                    .catch((err) => h.response({ response: "ERROR", data: err.message }).code(417));
+            }
+        });
+        /*  start up REST/WebSockets service  */
+        await this.hapi.start();
+        this.cli.log("info", `HAPI: started REST/WebSocket network service: http://${args.a}:${args.p}`);
+        /*  hook for sendResponse method of nodes  */
+        for (const node of graph.getGraphNodes()) {
+            node.on("send-response", (argList) => {
+                const data = JSON.stringify({ response: "NOTIFY", node: node.id, args: argList });
+                for (const [peer, info] of this.wsPeers.entries()) {
+                    this.cli.log("debug", `HAPI: remote peer ${peer}: sending ${data}`);
+                    if (info.ws.readyState === ws_1.default.OPEN)
+                        info.ws.send(data);
+                }
+            });
+        }
+        /*  establish Open State Control (OSC) event emission  */
+        if (args.o !== "") {
+            const osc = new osc_js_1.default({ plugin: new osc_js_1.default.DatagramPlugin({ type: "udp4" }) });
+            const m = args.o.match(/^(.+?):(\d+)$/);
+            if (m === null)
+                throw new Error("invalid OSC/UDP endpoint (expected <ip-adress>:<udp-port>)");
+            const host = m[1];
+            const port = m[2];
+            this.sendOSC = (url, ...argList) => {
+                const msg = new osc_js_1.default.Message(url, ...argList);
+                osc.send(msg, { host, port });
+            };
+        }
+        /*  hook for send-dashboard method of nodes  */
+        for (const node of graph.getGraphNodes()) {
+            node.on("send-dashboard", (info) => {
+                const data = JSON.stringify({
+                    response: "DASHBOARD",
+                    node: "",
+                    args: [info.type, info.id, info.kind, info.value]
+                });
+                for (const [peer, info] of this.wsPeers.entries()) {
+                    this.cli.log("debug", `HAPI: dashboard peer ${peer}: send ${data}`);
+                    info.ws.send(data);
+                }
+                for (const n of graph.getGraphNodes()) {
+                    Promise.race([
+                        n.receiveDashboard(info.type, info.id, info.kind, info.value),
+                        new Promise((resolve, reject) => setTimeout(() => reject(new Error("timeout")), 10 * 1000))
+                    ]).catch((err) => {
+                        this.cli.log("warning", `sending dashboard info to node <${n.id}> failed: ${err.message}`);
+                    });
+                }
+                if (args.o !== "" && this.sendOSC)
+                    this.sendOSC("/speechflow/dashboard", info.type, info.id, info.kind, info.value);
+            });
+        }
+    }
+    /*  stop API server service  */
+    async stop(args) {
+        /*  shutdown HAPI service  */
+        if (this.hapi) {
+            this.cli.log("info", `HAPI: stopping REST/WebSocket network service: http://${args.a}:${args.p}`);
+            await this.hapi.stop({ timeout: 2000 });
+        }
+        /*  clear WebSocket connections  */
+        if (this.wsPeers.size > 0) {
+            this.cli.log("info", "HAPI: closing WebSocket connections");
+            const closePromises = [];
+            for (const [peer, info] of this.wsPeers.entries()) {
+                closePromises.push(new Promise((resolve, reject) => {
+                    if (info.ws.readyState !== ws_1.default.OPEN)
+                        resolve();
+                    else {
+                        const timeout = setTimeout(() => {
+                            reject(new Error(`timeout for peer ${peer}`));
+                        }, 2 * 1000);
+                        info.ws.once("close", () => {
+                            clearTimeout(timeout);
+                            resolve();
+                        });
+                        info.ws.close();
+                    }
+                }));
+            }
+            await Promise.race([
+                Promise.all(closePromises),
+                new Promise((resolve, reject) => setTimeout(() => reject(new Error("timeout for all peers")), 5 * 1000))
+            ]).catch((error) => {
+                this.cli.log("warning", `HAPI: WebSockets failed to close: ${util.ensureError(error).message}`);
+            });
+            this.wsPeers.clear();
+        }
+    }
+}
+exports.APIServer = APIServer;
+//# sourceMappingURL=speechflow-main-api.js.map

package/speechflow-cli/dst/speechflow-main-api.js.map

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

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

@@ -0,0 +1,28 @@
+import CLIio from "cli-io";
+export interface CLIOptions {
+    V: boolean;
+    S: boolean;
+    v: string;
+    a: string;
+    p: number;
+    C: string;
+    d: string;
+    o: string;
+    e: string;
+    f: string;
+    c: string;
+    _: (string | number)[];
+}
+export declare class CLIContext {
+    cli: CLIio | null;
+    args: CLIOptions | null;
+    config: string | null;
+    debug: boolean;
+    isInitialized(): this is CLIContext & {
+        cli: CLIio;
+        args: CLIOptions;
+        config: string;
+    };
+    init(): Promise<void>;
+    handleTopLevelError(err: Error): never;
+}

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

@@ -0,0 +1,271 @@
+"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.CLIContext = void 0;
+/*  standard dependencies  */
+const node_path_1 = __importDefault(require("node:path"));
+/*  external dependencies  */
+const cli_io_1 = __importDefault(require("cli-io"));
+const yargs_1 = __importDefault(require("yargs"));
+const helpers_1 = require("yargs/helpers");
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const dotenvx_1 = __importDefault(require("@dotenvx/dotenvx"));
+const syspath_1 = __importDefault(require("syspath"));
+const chalk_1 = __importDefault(require("chalk"));
+/*  internal dependencies  */
+const util = __importStar(require("./speechflow-util"));
+const package_json_1 = __importDefault(require("../../package.json"));
+class CLIContext {
+    cli = null;
+    args = null;
+    config = null;
+    debug = false;
+    /*  type guard for initialization  */
+    isInitialized() {
+        return this.cli !== null && this.args !== null && this.config !== null;
+    }
+    /*  initialization of CLI  */
+    async init() {
+        /*  determine system paths  */
+        const { dataDir } = (0, syspath_1.default)({
+            appName: "speechflow",
+            dataDirAutoCreate: true
+        });
+        /*  parse command-line arguments  */
+        const coerce = (arg) => Array.isArray(arg) ? arg[arg.length - 1] : arg;
+        this.args = await (0, yargs_1.default)()
+            /* eslint @stylistic/indent: off */
+            .usage("Usage: $0 " +
+            "[-h|--help] " +
+            "[-V|--version] " +
+            "[-S|--status] " +
+            "[-v|--verbose <level>] " +
+            "[-a|--address <ip-address>] " +
+            "[-p|--port <tcp-port>] " +
+            "[-C|--cache <directory>] " +
+            "[-d|--dashboard <type>:<id>:<name>[,...]] " +
+            "[-o|--osc <ip-address>:<udp-port> " +
+            "[-e|--expression <expression>] " +
+            "[-f|--file <file>] " +
+            "[-c|--config <id>@<yaml-config-file>] " +
+            "[<argument> [...]]")
+            .version(false)
+            .option("V", {
+            alias: "version",
+            type: "boolean",
+            array: false,
+            coerce,
+            default: false,
+            describe: "show program version information"
+        })
+            .option("S", {
+            alias: "status",
+            type: "boolean",
+            array: false,
+            coerce,
+            default: false,
+            describe: "show one-time status of nodes"
+        })
+            .option("v", {
+            alias: "log-level",
+            type: "string",
+            array: false,
+            coerce,
+            nargs: 1,
+            default: "warning",
+            describe: "level for verbose logging ('none', 'error', 'warning', 'info', 'debug')"
+        })
+            .option("a", {
+            alias: "address",
+            type: "string",
+            array: false,
+            coerce,
+            nargs: 1,
+            default: "0.0.0.0",
+            describe: "IP address for REST/WebSocket API"
+        })
+            .option("p", {
+            alias: "port",
+            type: "number",
+            array: false,
+            coerce,
+            nargs: 1,
+            default: 8484,
+            describe: "TCP port for REST/WebSocket API"
+        })
+            .option("C", {
+            alias: "cache",
+            type: "string",
+            array: false,
+            coerce,
+            nargs: 1,
+            default: node_path_1.default.join(dataDir, "cache"),
+            describe: "directory for cached files (primarily AI model files)"
+        })
+            .option("d", {
+            alias: "dashboard",
+            type: "string",
+            array: false,
+            coerce,
+            nargs: 1,
+            default: "",
+            describe: "list of dashboard block types and names"
+        })
+            .option("o", {
+            alias: "osc",
+            type: "string",
+            array: false,
+            coerce,
+            nargs: 1,
+            default: "",
+            describe: "OSC/UDP endpoint to send dashboard information"
+        })
+            .option("e", {
+            alias: "expression",
+            type: "string",
+            array: false,
+            coerce,
+            nargs: 1,
+            default: "",
+            describe: "FlowLink expression string"
+        })
+            .option("f", {
+            alias: "file",
+            type: "string",
+            array: false,
+            coerce,
+            nargs: 1,
+            default: "",
+            describe: "FlowLink expression file"
+        })
+            .option("c", {
+            alias: "config",
+            type: "string",
+            array: false,
+            coerce,
+            nargs: 1,
+            default: "",
+            describe: "FlowLink expression reference into YAML file (in format <id>@<file>)"
+        })
+            .help("h", "show usage help")
+            .alias("h", "help")
+            .showHelpOnFail(true)
+            .strict()
+            .demand(0)
+            .parse((0, helpers_1.hideBin)(process.argv));
+        /*  short-circuit version request  */
+        if (this.args.V) {
+            process.stderr.write(`SpeechFlow ${package_json_1.default["x-stdver"]} (${package_json_1.default["x-release"]}) <${package_json_1.default.homepage}>\n`);
+            process.stderr.write(`${package_json_1.default.description}\n`);
+            process.stderr.write(`Copyright (c) 2024-2025 ${package_json_1.default.author.name} <${package_json_1.default.author.url}>\n`);
+            process.stderr.write(`Licensed under ${package_json_1.default.license} <http://spdx.org/licenses/${package_json_1.default.license}.html>\n`);
+            process.exit(0);
+        }
+        /*  establish CLI environment  */
+        this.cli = new cli_io_1.default({
+            encoding: "utf8",
+            logLevel: this.args.v,
+            logTime: true,
+            logPrefix: package_json_1.default.name
+        });
+        if (this.args.v.match(/^(?:info|debug)$/))
+            this.debug = true;
+        /*  provide startup information  */
+        this.cli.log("info", `starting SpeechFlow ${package_json_1.default["x-stdver"]} (${package_json_1.default["x-release"]})`);
+        /*  load .env files  */
+        const result = dotenvx_1.default.config({
+            encoding: "utf8",
+            ignore: ["MISSING_ENV_FILE"],
+            quiet: true
+        });
+        if (result?.parsed !== undefined)
+            for (const key of Object.keys(result.parsed))
+                this.cli.log("info", `loaded environment variable "${key}" from ".env" files`);
+        /*  sanity check configuration situation  */
+        let n = 0;
+        if (typeof this.args.e === "string" && this.args.e !== "")
+            n++;
+        if (typeof this.args.f === "string" && this.args.f !== "")
+            n++;
+        if (typeof this.args.c === "string" && this.args.c !== "")
+            n++;
+        if (n === 0)
+            throw new Error("need at least one FlowLink specification source (use one of the options -e, -f or -c)");
+        else if (n !== 1)
+            throw new Error("cannot use more than one FlowLink specification source (use only one of the options -e, -f or -c)");
+        /*  read configuration  */
+        if (typeof this.args.e === "string" && this.args.e !== "")
+            this.config = this.args.e;
+        else if (typeof this.args.f === "string" && this.args.f !== "")
+            this.config = await this.cli.input(this.args.f, { encoding: "utf8" });
+        else if (typeof this.args.c === "string" && this.args.c !== "") {
+            const m = this.args.c.match(/^(.+?)@(.+)$/);
+            if (m === null)
+                throw new Error("invalid configuration file specification (expected \"<id>@<yaml-config-file>\")");
+            const [, id, file] = m;
+            const yaml = await this.cli.input(file, { encoding: "utf8" });
+            const obj = util.run("parsing YAML configuration", () => js_yaml_1.default.load(yaml));
+            if (obj[id] === undefined)
+                throw new Error(`no such id "${id}" found in configuration file "${file}"`);
+            this.config = obj[id];
+        }
+    }
+    /*  utility function for handling a top-level error  */
+    handleTopLevelError(err) {
+        if (this.cli !== null) {
+            if (this.debug)
+                this.cli.log("error", `${err.message}\n${err.stack}`);
+            else
+                this.cli.log("error", `${err.message}`);
+        }
+        else {
+            if (this.debug)
+                process.stderr.write(`${package_json_1.default.name}: ${chalk_1.default.red("ERROR")}: ${err.message}\n${err.stack}\n`);
+            else
+                process.stderr.write(`${package_json_1.default.name}: ${chalk_1.default.red("ERROR")}: ${err.message}`);
+        }
+        process.exit(1);
+    }
+}
+exports.CLIContext = CLIContext;
+//# sourceMappingURL=speechflow-main-cli.js.map

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

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

package/speechflow-cli/dst/speechflow-main-config.d.ts

@@ -0,0 +1,9 @@
+export declare class NodeConfig {
+    readonly audioChannels: number;
+    readonly audioBitDepth: number;
+    readonly audioLittleEndian: boolean;
+    readonly audioSampleRate: number;
+    readonly textEncoding: string;
+    cacheDir: string;
+    constructor(audioChannels?: number, audioBitDepth?: number, audioLittleEndian?: boolean, audioSampleRate?: number, textEncoding?: string, cacheDir?: string);
+}