flowfram-runtime 1.0.2

package/dist/cli.js

@@ -0,0 +1,184 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * FlowRed Runtime CLI
+ *
+ * A distributed runtime execution engine for FlowRed/FRAM flows.
+ *
+ * Usage:
+ *   flowfram-runtime [options]
+ *
+ * Options:
+ *   --port, -p     Port to listen on (default: 3001)
+ *   --host         Host to bind to (default: 0.0.0.0)
+ *   --help         Show this help message
+ *   --version, -v  Show version number
+ */
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const server_1 = require("./server");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const args = process.argv.slice(2);
+// Get package.json for version info
+function getPackageInfo() {
+    try {
+        const pkgPath = path.resolve(__dirname, '../package.json');
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+        return { version: pkg.version, name: pkg.name };
+    }
+    catch {
+        return { version: '1.0.0', name: 'flowfram-runtime' };
+    }
+}
+// Parse command line arguments
+function parseArgs() {
+    const config = {
+        port: parseInt(process.env.PORT || '3001', 10),
+        host: process.env.HOST || '0.0.0.0',
+        help: false,
+        version: false,
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--help' || arg === '-h') {
+            config.help = true;
+        }
+        else if (arg === '--version' || arg === '-v') {
+            config.version = true;
+        }
+        else if (arg === '--port' || arg === '-p') {
+            const nextArg = args[++i];
+            if (nextArg) {
+                config.port = parseInt(nextArg, 10);
+            }
+        }
+        else if (arg === '--host') {
+            const nextArg = args[++i];
+            if (nextArg) {
+                config.host = nextArg;
+            }
+        }
+    }
+    return config;
+}
+function showHelp() {
+    const pkg = getPackageInfo();
+    console.log(`
+FlowRed Runtime Service v${pkg.version}
+
+A distributed runtime execution engine for FlowRed/FRAM flows.
+
+USAGE:
+  flowfram-runtime [options]
+
+OPTIONS:
+  --port, -p <port>    Port to listen on (default: 3001, env: PORT)
+  --host <host>        Host to bind to (default: 0.0.0.0, env: HOST)
+  --help, -h           Show this help message
+  --version, -v        Show version number
+
+ENVIRONMENT VARIABLES:
+  PORT                 Server port (default: 3001)
+  HOST                 Server host (default: 0.0.0.0)
+  LOG_LEVEL            Logging level: debug, info, warn, error (default: info)
+
+EXAMPLES:
+  # Start on default port 3001
+  flowfram-runtime
+
+  # Start on custom port
+  flowfram-runtime --port 8080
+
+  # Start with environment variable
+  PORT=8080 flowfram-runtime
+
+ENDPOINTS:
+  POST /deploy         Deploy a flow
+  POST /inject         Inject a message into a node
+  POST /batch-run      Run multiple iterations
+  POST /stop           Stop a running flow
+  GET  /events         SSE stream for real-time events
+  GET  /health         Health check endpoint
+
+For more information, visit: https://flowfram.com/agent
+`);
+}
+function showVersion() {
+    const pkg = getPackageInfo();
+    console.log(`flowfram-runtime v${pkg.version}`);
+}
+async function main() {
+    const config = parseArgs();
+    if (config.help) {
+        showHelp();
+        process.exit(0);
+    }
+    if (config.version) {
+        showVersion();
+        process.exit(0);
+    }
+    // Set environment variables for the server
+    process.env.PORT = String(config.port);
+    process.env.HOST = config.host;
+    try {
+        const server = await (0, server_1.createServer)({
+            port: config.port,
+            host: config.host,
+        });
+        // Handle graceful shutdown
+        const shutdown = () => {
+            console.log('\nShutting down...');
+            server.close(() => {
+                console.log('Server stopped.');
+                process.exit(0);
+            });
+        };
+        process.on('SIGINT', shutdown);
+        process.on('SIGTERM', shutdown);
+    }
+    catch (error) {
+        if (error.code === 'EADDRINUSE') {
+            console.error(`Error: Port ${config.port} is already in use.`);
+            console.error(`Try using a different port: flowfram-runtime --port <port>`);
+        }
+        else {
+            console.error('Failed to start server:', error.message);
+        }
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Logger utility that respects LOG_LEVEL environment variable
+ * Levels: debug < info < warn < error
+ *
+ * Default level is 'warn' for production — only warnings and errors are shown.
+ * Set LOG_LEVEL=info for operational logs (deploy/stop/startup).
+ * Set LOG_LEVEL=debug for full tracing (per-node, per-message, validation).
+ */
+export declare const logger: {
+    debug: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+    always: (...args: unknown[]) => void;
+};
+export default logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqBH,eAAO,MAAM,MAAM;qBACA,OAAO,EAAE;oBAMV,OAAO,EAAE;oBAMT,OAAO,EAAE;qBAMR,OAAO,EAAE;sBAOR,OAAO,EAAE;CAG5B,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/logger.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * Logger utility that respects LOG_LEVEL environment variable
+ * Levels: debug < info < warn < error
+ *
+ * Default level is 'warn' for production — only warnings and errors are shown.
+ * Set LOG_LEVEL=info for operational logs (deploy/stop/startup).
+ * Set LOG_LEVEL=debug for full tracing (per-node, per-message, validation).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+function getConfiguredLevel() {
+    const level = (process.env.LOG_LEVEL || "warn").toLowerCase();
+    return LOG_LEVELS[level] ?? LOG_LEVELS.warn;
+}
+// Read level dynamically so .env changes after import are picked up
+function currentLevel() {
+    return getConfiguredLevel();
+}
+exports.logger = {
+    debug: (...args) => {
+        if (currentLevel() <= LOG_LEVELS.debug) {
+            console.log(...args);
+        }
+    },
+    info: (...args) => {
+        if (currentLevel() <= LOG_LEVELS.info) {
+            console.log(...args);
+        }
+    },
+    warn: (...args) => {
+        if (currentLevel() <= LOG_LEVELS.warn) {
+            console.warn(...args);
+        }
+    },
+    error: (...args) => {
+        if (currentLevel() <= LOG_LEVELS.error) {
+            console.error(...args);
+        }
+    },
+    // Always log regardless of level (for startup banner, etc.)
+    always: (...args) => {
+        console.log(...args);
+    },
+};
+exports.default = exports.logger;
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAIH,MAAM,UAAU,GAA6B;IAC3C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,SAAS,kBAAkB;IACzB,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,CAAC,CAAC,WAAW,EAAc,CAAC;IAC1E,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC;AAC9C,CAAC;AAED,oEAAoE;AACpE,SAAS,YAAY;IACnB,OAAO,kBAAkB,EAAE,CAAC;AAC9B,CAAC;AAEY,QAAA,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;QAC5B,IAAI,YAAY,EAAE,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YACvC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;QAC3B,IAAI,YAAY,EAAE,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;QAC3B,IAAI,YAAY,EAAE,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;QAC5B,IAAI,YAAY,EAAE,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YACvC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,4DAA4D;IAC5D,MAAM,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;QAC7B,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,CAAC;CACF,CAAC;AAEF,kBAAe,cAAM,CAAC"}

package/dist/persistence.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Runtime State Persistence
+ *
+ * Persists deployed flows to disk so they survive runtime restarts.
+ * Uses a simple JSON file-based storage.
+ */
+interface PersistedFlow {
+    flowId: string;
+    flowData: any;
+    deployedAt: number;
+    tenantId?: string;
+}
+interface PersistedState {
+    version: string;
+    flows: PersistedFlow[];
+    lastUpdated: number;
+}
+/**
+ * Load persisted state from disk
+ */
+export declare function loadPersistedState(): PersistedState | null;
+/**
+ * Save state to disk
+ */
+export declare function savePersistedState(flows: Map<string, {
+    flowData: any;
+    deployedAt: number;
+    tenantId?: string;
+}>): void;
+/**
+ * Remove a flow from persisted state
+ */
+export declare function removePersistedFlow(flowId: string): void;
+/**
+ * Clear all persisted state
+ */
+export declare function clearPersistedState(): void;
+export {};
+//# sourceMappingURL=persistence.d.ts.map

package/dist/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,UAAU,aAAa;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,GAAG,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAYD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,GAAG,IAAI,CAkB1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,GAAG,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,CAoBrH;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAcxD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAS1C"}

package/dist/persistence.js

@@ -0,0 +1,138 @@
+"use strict";
+/**
+ * Runtime State Persistence
+ *
+ * Persists deployed flows to disk so they survive runtime restarts.
+ * Uses a simple JSON file-based storage.
+ */
+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.loadPersistedState = loadPersistedState;
+exports.savePersistedState = savePersistedState;
+exports.removePersistedFlow = removePersistedFlow;
+exports.clearPersistedState = clearPersistedState;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logger_1 = __importDefault(require("./logger"));
+const DATA_DIR = process.env.RUNTIME_DATA_DIR || './data';
+const FLOWS_FILE = path.join(DATA_DIR, 'deployed-flows.json');
+/**
+ * Ensure data directory exists
+ */
+function ensureDataDir() {
+    if (!fs.existsSync(DATA_DIR)) {
+        fs.mkdirSync(DATA_DIR, { recursive: true });
+        logger_1.default.info(`[Persistence] Created data directory: ${DATA_DIR}`);
+    }
+}
+/**
+ * Load persisted state from disk
+ */
+function loadPersistedState() {
+    try {
+        ensureDataDir();
+        if (!fs.existsSync(FLOWS_FILE)) {
+            logger_1.default.info('[Persistence] No persisted state found');
+            return null;
+        }
+        const data = fs.readFileSync(FLOWS_FILE, 'utf-8');
+        const state = JSON.parse(data);
+        logger_1.default.info(`[Persistence] Loaded ${state.flows.length} persisted flows`);
+        return state;
+    }
+    catch (error) {
+        logger_1.default.error('[Persistence] Error loading state:', error);
+        return null;
+    }
+}
+/**
+ * Save state to disk
+ */
+function savePersistedState(flows) {
+    try {
+        ensureDataDir();
+        const state = {
+            version: '1.0',
+            flows: Array.from(flows.entries()).map(([flowId, data]) => ({
+                flowId,
+                flowData: data.flowData,
+                deployedAt: data.deployedAt,
+                tenantId: data.tenantId,
+            })),
+            lastUpdated: Date.now(),
+        };
+        fs.writeFileSync(FLOWS_FILE, JSON.stringify(state, null, 2));
+        logger_1.default.info(`[Persistence] Saved ${state.flows.length} flows to disk`);
+    }
+    catch (error) {
+        logger_1.default.error('[Persistence] Error saving state:', error);
+    }
+}
+/**
+ * Remove a flow from persisted state
+ */
+function removePersistedFlow(flowId) {
+    try {
+        const state = loadPersistedState();
+        if (!state)
+            return;
+        state.flows = state.flows.filter(f => f.flowId !== flowId);
+        state.lastUpdated = Date.now();
+        ensureDataDir();
+        fs.writeFileSync(FLOWS_FILE, JSON.stringify(state, null, 2));
+        logger_1.default.info(`[Persistence] Removed flow ${flowId} from disk`);
+    }
+    catch (error) {
+        logger_1.default.error('[Persistence] Error removing flow:', error);
+    }
+}
+/**
+ * Clear all persisted state
+ */
+function clearPersistedState() {
+    try {
+        if (fs.existsSync(FLOWS_FILE)) {
+            fs.unlinkSync(FLOWS_FILE);
+            logger_1.default.info('[Persistence] Cleared all persisted state');
+        }
+    }
+    catch (error) {
+        logger_1.default.error('[Persistence] Error clearing state:', error);
+    }
+}
+//# sourceMappingURL=persistence.js.map

package/dist/persistence.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,23 @@
+/**
+ * FlowRed Runtime Service
+ *
+ * Distributed runtime execution engine with REST API + SSE events.
+ *
+ * Endpoints:
+ * - POST /deploy    - Deploy a flow
+ * - POST /stop      - Stop a flow
+ * - POST /inject    - Execute an inject node
+ * - GET  /status    - Get runtime status
+ * - GET  /events    - SSE endpoint for real-time events
+ * - GET  /health    - Health check
+ */
+import { Application } from "express";
+declare const app: Application;
+export interface ServerOptions {
+    port?: number;
+    host?: string;
+    silent?: boolean;
+}
+export declare function createServer(options?: ServerOptions): Promise<ReturnType<typeof app.listen>>;
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAqBH,OAAgB,EAAqB,WAAW,EAAE,MAAM,SAAS,CAAC;AAUlE,QAAA,MAAM,GAAG,EAAE,WAAuB,CAAC;AA6lCnC,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,YAAY,CAC1B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,UAAU,CAAC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CA+CxC"}