flowscale 2.1.0-beta.1 → 2.1.0-beta.3

package/dist/index.d.ts

@@ -126,3 +126,4 @@ export { FlowscalePlatformAPI } from './platform';
 export { LocalPodsAPI } from './local-pods';
 export * from './local-types';
 export * from './platform-types';
+export { RemotePodsTransport } from './remote-transport';

package/dist/index.js

@@ -73,7 +73,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LocalPodsAPI = exports.FlowscalePlatformAPI = exports.FlowscaleAPI = void 0;
+exports.RemotePodsTransport = exports.LocalPodsAPI = exports.FlowscalePlatformAPI = exports.FlowscaleAPI = void 0;
 var axios_1 = __importDefault(require("axios"));
 var FlowscaleAPI = /** @class */ (function () {
     function FlowscaleAPI(config) {
@@ -1302,3 +1302,5 @@ var local_pods_1 = require("./local-pods");
 Object.defineProperty(exports, "LocalPodsAPI", { enumerable: true, get: function () { return local_pods_1.LocalPodsAPI; } });
 __exportStar(require("./local-types"), exports);
 __exportStar(require("./platform-types"), exports);
+var remote_transport_1 = require("./remote-transport");
+Object.defineProperty(exports, "RemotePodsTransport", { enumerable: true, get: function () { return remote_transport_1.RemotePodsTransport; } });

package/dist/local-types.d.ts

@@ -33,6 +33,12 @@ export interface LocalPodInstance {
     lastDetectedAt: number | null;
     comfyuiInfo?: ComfyUISystemStats;
     createdAt: number;
+    /**
+     * Pre-computed base URL for reaching this instance.
+     * Set by RemotePodsTransport to `http://operatorHost:port`.
+     * When undefined, consumers should fall back to `http://localhost:port`.
+     */
+    baseUrl?: string;
 }
 export interface LocalPod {
     id: string;

package/dist/node-index.d.ts

@@ -0,0 +1,2 @@
+export { NodePodsTransport } from './node-transport';
+export { PodsOperatorServer } from './operator-server';

package/dist/node-index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PodsOperatorServer = exports.NodePodsTransport = void 0;
+var node_transport_1 = require("./node-transport");
+Object.defineProperty(exports, "NodePodsTransport", { enumerable: true, get: function () { return node_transport_1.NodePodsTransport; } });
+var operator_server_1 = require("./operator-server");
+Object.defineProperty(exports, "PodsOperatorServer", { enumerable: true, get: function () { return operator_server_1.PodsOperatorServer; } });

package/dist/node-transport.d.ts

@@ -0,0 +1,80 @@
+import type { LocalPodsTransport, LocalPod, LocalPodInstance, LocalPodDevice, LocalPodInstanceStatus, SystemInfo, ComfyUISystemStats, CreateLocalPodRequest, UpdateLocalPodRequest, StartInstanceRequest } from './local-types';
+/**
+ * NodePodsTransport — manages local pod data in a shared SQLite DB at
+ * `~/.flowscale/pods.db` (or a custom path).
+ *
+ * Implements CRUD for pods and instances. Process-lifecycle methods
+ * (startInstance, stopInstance, etc.) are NOT implemented here; they
+ * must be provided by the consuming application (e.g. creativeflow-electron).
+ *
+ * Export path: `flowscale/node`
+ */
+export declare class NodePodsTransport implements LocalPodsTransport {
+    /** The underlying better-sqlite3 database handle */
+    private db;
+    private emitter;
+    constructor(dbPath?: string);
+    private _initSchema;
+    create(data: CreateLocalPodRequest): Promise<LocalPod>;
+    list(): Promise<LocalPod[]>;
+    get(id: string): Promise<LocalPod | null>;
+    update(id: string, data: UpdateLocalPodRequest): Promise<LocalPod>;
+    delete(id: string): Promise<void>;
+    /**
+     * Insert a new instance row and return the hydrated LocalPodInstance.
+     * Used by process-management code (e.g. startInstance in electron).
+     */
+    dbInsertInstance(data: {
+        id: string;
+        podId: string;
+        port: number;
+        device: LocalPodDevice;
+        status: LocalPodInstanceStatus;
+        pid: number | null;
+        lastDetectedAt: number | null;
+        createdAt: number;
+    }): LocalPodInstance;
+    /**
+     * Update specific fields of an instance row.
+     * Used by process-management code for status/pid updates.
+     */
+    dbUpdateInstance(id: string, updates: {
+        status?: LocalPodInstanceStatus;
+        pid?: number | null;
+        lastDetectedAt?: number | null;
+        device?: LocalPodDevice;
+    }): void;
+    /** Get a single instance row by ID. */
+    dbGetInstance(id: string): LocalPodInstance | null;
+    /** Get all instances for a given pod. */
+    dbGetInstancesForPod(podId: string): LocalPodInstance[];
+    /** Get all instance rows across all pods. */
+    dbGetAllInstances(): LocalPodInstance[];
+    /** Get a raw pod row (for accessing comfyuiPath etc in process-mgmt code). */
+    dbGetPodRow(id: string): {
+        id: string;
+        comfyuiPath: string | null;
+    } | null;
+    deleteInstance(instanceId: string): Promise<void>;
+    refreshInstance(instanceId: string): Promise<LocalPodInstance>;
+    onInstanceStatusChanged(cb: (instanceId: string, status: LocalPodInstanceStatus, info?: ComfyUISystemStats) => void): () => void;
+    onLog(cb: (instanceId: string, line: string) => void): () => void;
+    /** Emit an instanceStatusChanged event (called by subclasses / process-lifecycle code). */
+    emitInstanceStatusChanged(instanceId: string, status: LocalPodInstanceStatus, info?: ComfyUISystemStats): void;
+    /** Emit a log event (called by subclasses / process-lifecycle code). */
+    emitLog(instanceId: string, line: string): void;
+    scanPaths(): Promise<string | null>;
+    scanPorts(_podId: string): Promise<LocalPodInstance[]>;
+    startInstance(_req: StartInstanceRequest): Promise<LocalPodInstance>;
+    stopInstance(_instanceId: string): Promise<void>;
+    restartInstance(_instanceId: string): Promise<void>;
+    getSystemInfo(): Promise<SystemInfo>;
+    getLogs(_instanceId: string): Promise<string[]>;
+    installRocmPyTorch(_podId: string): void;
+    onRocmSetupDone(_cb: (data: {
+        podId: string;
+        success: boolean;
+    }) => void): () => void;
+    private _getInstancesForPod;
+    private _probePort;
+}

package/dist/node-transport.js

@@ -0,0 +1,400 @@
+"use strict";
+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 __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodePodsTransport = void 0;
+var path = __importStar(require("path"));
+var os = __importStar(require("os"));
+var fs = __importStar(require("fs"));
+var crypto_1 = require("crypto");
+var events_1 = require("events");
+// ── Helpers ────────────────────────────────────────────────────────────────────
+function rowToInstance(row) {
+    var _a, _b;
+    return {
+        id: row.id,
+        podId: row.pod_id,
+        port: row.port,
+        device: JSON.parse(row.device),
+        status: row.status,
+        pid: (_a = row.pid) !== null && _a !== void 0 ? _a : null,
+        lastDetectedAt: (_b = row.last_detected_at) !== null && _b !== void 0 ? _b : null,
+        createdAt: row.created_at,
+    };
+}
+function rowToPod(row, instances) {
+    var _a, _b;
+    return {
+        id: row.id,
+        name: row.name,
+        description: (_a = row.description) !== null && _a !== void 0 ? _a : undefined,
+        comfyuiPath: (_b = row.comfyui_path) !== null && _b !== void 0 ? _b : null,
+        instances: instances,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+// ── NodePodsTransport ──────────────────────────────────────────────────────────
+/**
+ * NodePodsTransport — manages local pod data in a shared SQLite DB at
+ * `~/.flowscale/pods.db` (or a custom path).
+ *
+ * Implements CRUD for pods and instances. Process-lifecycle methods
+ * (startInstance, stopInstance, etc.) are NOT implemented here; they
+ * must be provided by the consuming application (e.g. creativeflow-electron).
+ *
+ * Export path: `flowscale/node`
+ */
+var NodePodsTransport = /** @class */ (function () {
+    function NodePodsTransport(dbPath) {
+        this.emitter = new events_1.EventEmitter();
+        var resolvedPath = dbPath !== null && dbPath !== void 0 ? dbPath : path.join(os.homedir(), '.flowscale', 'pods.db');
+        // Ensure parent directory exists
+        fs.mkdirSync(path.dirname(resolvedPath), { recursive: true });
+        // Lazy-require so consumers that don't use this class don't need better-sqlite3
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        var Database = require('better-sqlite3');
+        this.db = new Database(resolvedPath);
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('foreign_keys = ON');
+        this._initSchema();
+    }
+    NodePodsTransport.prototype._initSchema = function () {
+        this.db.exec("\n      CREATE TABLE IF NOT EXISTS pods (\n        id TEXT PRIMARY KEY,\n        name TEXT NOT NULL,\n        description TEXT,\n        comfyui_path TEXT,\n        created_at INTEGER NOT NULL,\n        updated_at INTEGER NOT NULL\n      );\n\n      CREATE TABLE IF NOT EXISTS pod_instances (\n        id TEXT PRIMARY KEY,\n        pod_id TEXT NOT NULL REFERENCES pods(id) ON DELETE CASCADE,\n        port INTEGER NOT NULL,\n        device TEXT NOT NULL,\n        status TEXT NOT NULL DEFAULT 'idle',\n        pid INTEGER,\n        last_detected_at INTEGER,\n        created_at INTEGER NOT NULL\n      );\n    ");
+    };
+    // ── Pod CRUD ───────────────────────────────────────────────────────────────
+    NodePodsTransport.prototype.create = function (data) {
+        return __awaiter(this, void 0, void 0, function () {
+            var id, now, row;
+            var _a, _b;
+            return __generator(this, function (_c) {
+                id = (0, crypto_1.randomUUID)();
+                now = Date.now();
+                this.db
+                    .prepare('INSERT INTO pods (id, name, description, comfyui_path, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)')
+                    .run(id, data.name, (_a = data.description) !== null && _a !== void 0 ? _a : null, (_b = data.comfyuiPath) !== null && _b !== void 0 ? _b : null, now, now);
+                row = this.db.prepare('SELECT * FROM pods WHERE id = ?').get(id);
+                return [2 /*return*/, rowToPod(row, [])];
+            });
+        });
+    };
+    NodePodsTransport.prototype.list = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var rows;
+            var _this = this;
+            return __generator(this, function (_a) {
+                rows = this.db.prepare('SELECT * FROM pods ORDER BY created_at ASC').all();
+                return [2 /*return*/, rows.map(function (row) {
+                        var instances = _this._getInstancesForPod(row.id);
+                        return rowToPod(row, instances);
+                    })];
+            });
+        });
+    };
+    NodePodsTransport.prototype.get = function (id) {
+        return __awaiter(this, void 0, void 0, function () {
+            var row, instances;
+            return __generator(this, function (_a) {
+                row = this.db.prepare('SELECT * FROM pods WHERE id = ?').get(id);
+                if (!row)
+                    return [2 /*return*/, null];
+                instances = this._getInstancesForPod(id);
+                return [2 /*return*/, rowToPod(row, instances)];
+            });
+        });
+    };
+    NodePodsTransport.prototype.update = function (id, data) {
+        return __awaiter(this, void 0, void 0, function () {
+            var now, sets, values, row, instances;
+            var _a;
+            var _b, _c;
+            return __generator(this, function (_d) {
+                now = Date.now();
+                sets = ['updated_at = ?'];
+                values = [now];
+                if (data.name !== undefined) {
+                    sets.push('name = ?');
+                    values.push(data.name);
+                }
+                if (data.description !== undefined) {
+                    sets.push('description = ?');
+                    values.push((_b = data.description) !== null && _b !== void 0 ? _b : null);
+                }
+                if ('comfyuiPath' in data) {
+                    sets.push('comfyui_path = ?');
+                    values.push((_c = data.comfyuiPath) !== null && _c !== void 0 ? _c : null);
+                }
+                values.push(id);
+                (_a = this.db.prepare("UPDATE pods SET ".concat(sets.join(', '), " WHERE id = ?"))).run.apply(_a, values);
+                row = this.db.prepare('SELECT * FROM pods WHERE id = ?').get(id);
+                instances = this._getInstancesForPod(id);
+                return [2 /*return*/, rowToPod(row, instances)];
+            });
+        });
+    };
+    NodePodsTransport.prototype.delete = function (id) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                this.db.prepare('DELETE FROM pods WHERE id = ?').run(id);
+                return [2 /*return*/];
+            });
+        });
+    };
+    // ── Instance CRUD helpers (for use by process-lifecycle code) ──────────────
+    /**
+     * Insert a new instance row and return the hydrated LocalPodInstance.
+     * Used by process-management code (e.g. startInstance in electron).
+     */
+    NodePodsTransport.prototype.dbInsertInstance = function (data) {
+        this.db
+            .prepare("INSERT INTO pod_instances (id, pod_id, port, device, status, pid, last_detected_at, created_at)\n         VALUES (?, ?, ?, ?, ?, ?, ?, ?)")
+            .run(data.id, data.podId, data.port, JSON.stringify(data.device), data.status, data.pid, data.lastDetectedAt, data.createdAt);
+        var row = this.db
+            .prepare('SELECT * FROM pod_instances WHERE id = ?')
+            .get(data.id);
+        return rowToInstance(row);
+    };
+    /**
+     * Update specific fields of an instance row.
+     * Used by process-management code for status/pid updates.
+     */
+    NodePodsTransport.prototype.dbUpdateInstance = function (id, updates) {
+        var _a;
+        var _b, _c;
+        var sets = [];
+        var values = [];
+        if (updates.status !== undefined) {
+            sets.push('status = ?');
+            values.push(updates.status);
+        }
+        if ('pid' in updates) {
+            sets.push('pid = ?');
+            values.push((_b = updates.pid) !== null && _b !== void 0 ? _b : null);
+        }
+        if ('lastDetectedAt' in updates) {
+            sets.push('last_detected_at = ?');
+            values.push((_c = updates.lastDetectedAt) !== null && _c !== void 0 ? _c : null);
+        }
+        if (updates.device !== undefined) {
+            sets.push('device = ?');
+            values.push(JSON.stringify(updates.device));
+        }
+        if (sets.length === 0)
+            return;
+        values.push(id);
+        (_a = this.db.prepare("UPDATE pod_instances SET ".concat(sets.join(', '), " WHERE id = ?"))).run.apply(_a, values);
+    };
+    /** Get a single instance row by ID. */
+    NodePodsTransport.prototype.dbGetInstance = function (id) {
+        var row = this.db
+            .prepare('SELECT * FROM pod_instances WHERE id = ?')
+            .get(id);
+        return row ? rowToInstance(row) : null;
+    };
+    /** Get all instances for a given pod. */
+    NodePodsTransport.prototype.dbGetInstancesForPod = function (podId) {
+        return this._getInstancesForPod(podId);
+    };
+    /** Get all instance rows across all pods. */
+    NodePodsTransport.prototype.dbGetAllInstances = function () {
+        var rows = this.db
+            .prepare('SELECT * FROM pod_instances')
+            .all();
+        return rows.map(rowToInstance);
+    };
+    /** Get a raw pod row (for accessing comfyuiPath etc in process-mgmt code). */
+    NodePodsTransport.prototype.dbGetPodRow = function (id) {
+        var _a;
+        var row = this.db
+            .prepare('SELECT * FROM pods WHERE id = ?')
+            .get(id);
+        if (!row)
+            return null;
+        return { id: row.id, comfyuiPath: (_a = row.comfyui_path) !== null && _a !== void 0 ? _a : null };
+    };
+    // ── Instance interface methods ─────────────────────────────────────────────
+    NodePodsTransport.prototype.deleteInstance = function (instanceId) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                this.db.prepare('DELETE FROM pod_instances WHERE id = ?').run(instanceId);
+                return [2 /*return*/];
+            });
+        });
+    };
+    NodePodsTransport.prototype.refreshInstance = function (instanceId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var row, info, now, newStatus, updated, inst;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        row = this.db
+                            .prepare('SELECT * FROM pod_instances WHERE id = ?')
+                            .get(instanceId);
+                        if (!row)
+                            throw new Error("Instance ".concat(instanceId, " not found"));
+                        return [4 /*yield*/, this._probePort(row.port)];
+                    case 1:
+                        info = _a.sent();
+                        now = Date.now();
+                        newStatus = info ? 'running' : 'idle';
+                        this.db
+                            .prepare('UPDATE pod_instances SET status = ?, last_detected_at = ? WHERE id = ?')
+                            .run(newStatus, info ? now : row.last_detected_at, instanceId);
+                        updated = this.db
+                            .prepare('SELECT * FROM pod_instances WHERE id = ?')
+                            .get(instanceId);
+                        inst = rowToInstance(updated);
+                        this.emitter.emit('instanceStatusChanged', instanceId, newStatus, info !== null && info !== void 0 ? info : undefined);
+                        return [2 /*return*/, inst];
+                }
+            });
+        });
+    };
+    // ── Events ─────────────────────────────────────────────────────────────────
+    NodePodsTransport.prototype.onInstanceStatusChanged = function (cb) {
+        var _this = this;
+        this.emitter.on('instanceStatusChanged', cb);
+        return function () { return _this.emitter.off('instanceStatusChanged', cb); };
+    };
+    NodePodsTransport.prototype.onLog = function (cb) {
+        var _this = this;
+        this.emitter.on('log', cb);
+        return function () { return _this.emitter.off('log', cb); };
+    };
+    /** Emit an instanceStatusChanged event (called by subclasses / process-lifecycle code). */
+    NodePodsTransport.prototype.emitInstanceStatusChanged = function (instanceId, status, info) {
+        this.emitter.emit('instanceStatusChanged', instanceId, status, info);
+    };
+    /** Emit a log event (called by subclasses / process-lifecycle code). */
+    NodePodsTransport.prototype.emitLog = function (instanceId, line) {
+        this.emitter.emit('log', instanceId, line);
+    };
+    // ── Not-implemented stubs ──────────────────────────────────────────────────
+    NodePodsTransport.prototype.scanPaths = function () {
+        return Promise.reject(new Error('NodePodsTransport: scanPaths() not implemented — use full LocalPodService'));
+    };
+    NodePodsTransport.prototype.scanPorts = function (_podId) {
+        return Promise.reject(new Error('NodePodsTransport: scanPorts() not implemented — use full LocalPodService'));
+    };
+    NodePodsTransport.prototype.startInstance = function (_req) {
+        return Promise.reject(new Error('NodePodsTransport: startInstance() not implemented — use full LocalPodService'));
+    };
+    NodePodsTransport.prototype.stopInstance = function (_instanceId) {
+        return Promise.reject(new Error('NodePodsTransport: stopInstance() not implemented — use full LocalPodService'));
+    };
+    NodePodsTransport.prototype.restartInstance = function (_instanceId) {
+        return Promise.reject(new Error('NodePodsTransport: restartInstance() not implemented — use full LocalPodService'));
+    };
+    NodePodsTransport.prototype.getSystemInfo = function () {
+        return Promise.reject(new Error('NodePodsTransport: getSystemInfo() not implemented — use full LocalPodService'));
+    };
+    NodePodsTransport.prototype.getLogs = function (_instanceId) {
+        return Promise.reject(new Error('NodePodsTransport: getLogs() not implemented — use full LocalPodService'));
+    };
+    NodePodsTransport.prototype.installRocmPyTorch = function (_podId) {
+        throw new Error('NodePodsTransport: installRocmPyTorch() not implemented — use full LocalPodService');
+    };
+    NodePodsTransport.prototype.onRocmSetupDone = function (_cb) {
+        throw new Error('NodePodsTransport: onRocmSetupDone() not implemented — use full LocalPodService');
+    };
+    // ── Private helpers ────────────────────────────────────────────────────────
+    NodePodsTransport.prototype._getInstancesForPod = function (podId) {
+        var rows = this.db
+            .prepare('SELECT * FROM pod_instances WHERE pod_id = ?')
+            .all(podId);
+        return rows.map(rowToInstance);
+    };
+    NodePodsTransport.prototype._probePort = function (port) {
+        return __awaiter(this, void 0, void 0, function () {
+            var res, _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        _b.trys.push([0, 3, , 4]);
+                        return [4 /*yield*/, fetch("http://localhost:".concat(port, "/system_stats"), {
+                                signal: AbortSignal.timeout(1500)
+                            })];
+                    case 1:
+                        res = _b.sent();
+                        if (!res.ok)
+                            return [2 /*return*/, null];
+                        return [4 /*yield*/, res.json()];
+                    case 2: return [2 /*return*/, (_b.sent())];
+                    case 3:
+                        _a = _b.sent();
+                        return [2 /*return*/, null];
+                    case 4: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    return NodePodsTransport;
+}());
+exports.NodePodsTransport = NodePodsTransport;

package/dist/operator-server.d.ts

@@ -0,0 +1,26 @@
+import type { NodePodsTransport } from './node-transport';
+/**
+ * PodsOperatorServer — exposes a read-only pod list HTTP API so that remote
+ * FlowScale Studio instances on the same network can discover and use pods
+ * managed by this machine.
+ *
+ * Serves on all interfaces (0.0.0.0) so any machine on the LAN can reach it.
+ * Includes CORS headers for browser-based clients.
+ *
+ * Usage in creativeflow-electron (main process):
+ *   import { NodePodsTransport, PodsOperatorServer } from 'flowscale/node'
+ *   const server = new PodsOperatorServer(transport)  // default port 3001
+ *   server.start()
+ *
+ * Remote clients connect via:
+ *   import { RemotePodsTransport, LocalPodsAPI } from 'flowscale'
+ *   const api = new LocalPodsAPI(new RemotePodsTransport('http://192.168.1.100:3001'))
+ */
+export declare class PodsOperatorServer {
+    private server;
+    private readonly transport;
+    private readonly port;
+    constructor(transport: NodePodsTransport, port?: number);
+    start(): void;
+    stop(): void;
+}

package/dist/operator-server.js

@@ -0,0 +1,178 @@
+"use strict";
+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 __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PodsOperatorServer = void 0;
+var http = __importStar(require("http"));
+/**
+ * PodsOperatorServer — exposes a read-only pod list HTTP API so that remote
+ * FlowScale Studio instances on the same network can discover and use pods
+ * managed by this machine.
+ *
+ * Serves on all interfaces (0.0.0.0) so any machine on the LAN can reach it.
+ * Includes CORS headers for browser-based clients.
+ *
+ * Usage in creativeflow-electron (main process):
+ *   import { NodePodsTransport, PodsOperatorServer } from 'flowscale/node'
+ *   const server = new PodsOperatorServer(transport)  // default port 3001
+ *   server.start()
+ *
+ * Remote clients connect via:
+ *   import { RemotePodsTransport, LocalPodsAPI } from 'flowscale'
+ *   const api = new LocalPodsAPI(new RemotePodsTransport('http://192.168.1.100:3001'))
+ */
+var PodsOperatorServer = /** @class */ (function () {
+    function PodsOperatorServer(transport, port) {
+        if (port === void 0) { port = 3001; }
+        this.server = null;
+        this.transport = transport;
+        this.port = port;
+    }
+    PodsOperatorServer.prototype.start = function () {
+        var _this = this;
+        if (this.server)
+            return;
+        this.server = http.createServer(function (req, res) { return __awaiter(_this, void 0, void 0, function () {
+            var url, pods, podMatch, id, pod, err_1;
+            var _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        // CORS — allow any origin (LAN usage only, not a public service)
+                        res.setHeader('Access-Control-Allow-Origin', '*');
+                        res.setHeader('Access-Control-Allow-Methods', 'GET, OPTIONS');
+                        res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+                        if (req.method === 'OPTIONS') {
+                            res.writeHead(204);
+                            res.end();
+                            return [2 /*return*/];
+                        }
+                        if (req.method !== 'GET') {
+                            res.writeHead(405);
+                            res.end('Method Not Allowed');
+                            return [2 /*return*/];
+                        }
+                        url = ((_a = req.url) !== null && _a !== void 0 ? _a : '/').split('?')[0];
+                        _b.label = 1;
+                    case 1:
+                        _b.trys.push([1, 6, , 7]);
+                        if (!(url === '/api/pods' || url === '/api/pods/')) return [3 /*break*/, 3];
+                        return [4 /*yield*/, this.transport.list()];
+                    case 2:
+                        pods = _b.sent();
+                        res.writeHead(200, { 'Content-Type': 'application/json' });
+                        res.end(JSON.stringify(pods));
+                        return [2 /*return*/];
+                    case 3:
+                        podMatch = url.match(/^\/api\/pods\/([^/]+)$/);
+                        if (!podMatch) return [3 /*break*/, 5];
+                        id = decodeURIComponent(podMatch[1]);
+                        return [4 /*yield*/, this.transport.get(id)];
+                    case 4:
+                        pod = _b.sent();
+                        if (!pod) {
+                            res.writeHead(404, { 'Content-Type': 'application/json' });
+                            res.end(JSON.stringify({ error: 'Pod not found' }));
+                        }
+                        else {
+                            res.writeHead(200, { 'Content-Type': 'application/json' });
+                            res.end(JSON.stringify(pod));
+                        }
+                        return [2 /*return*/];
+                    case 5:
+                        res.writeHead(404);
+                        res.end('Not found');
+                        return [3 /*break*/, 7];
+                    case 6:
+                        err_1 = _b.sent();
+                        console.error('[PodsOperatorServer] Error handling request:', err_1);
+                        res.writeHead(500, { 'Content-Type': 'application/json' });
+                        res.end(JSON.stringify({ error: 'Internal server error' }));
+                        return [3 /*break*/, 7];
+                    case 7: return [2 /*return*/];
+                }
+            });
+        }); });
+        this.server.listen(this.port, '0.0.0.0', function () {
+            console.log("[PodsOperatorServer] Listening on 0.0.0.0:".concat(_this.port));
+        });
+        this.server.on('error', function (err) {
+            console.error('[PodsOperatorServer] Server error:', err);
+        });
+    };
+    PodsOperatorServer.prototype.stop = function () {
+        if (this.server) {
+            this.server.close();
+            this.server = null;
+        }
+    };
+    return PodsOperatorServer;
+}());
+exports.PodsOperatorServer = PodsOperatorServer;

package/dist/remote-transport.d.ts

@@ -0,0 +1,43 @@
+import type { LocalPodsTransport, LocalPod, LocalPodInstance, LocalPodInstanceStatus, SystemInfo, ComfyUISystemStats, CreateLocalPodRequest, UpdateLocalPodRequest, StartInstanceRequest } from './local-types';
+/**
+ * RemotePodsTransport — reads pods from a FlowScale Operator HTTP API
+ * served by PodsOperatorServer running on another machine.
+ *
+ * Only `list()` and `get()` are functional. All other methods throw since
+ * process lifecycle management must be done on the machine running the operator.
+ *
+ * Instance `baseUrl` fields are automatically set to `http://operatorHost:port`
+ * so that callers can reach the ComfyUI instances across the network.
+ *
+ * Usage:
+ *   import { RemotePodsTransport, LocalPodsAPI } from 'flowscale'
+ *   const podsApi = new LocalPodsAPI(new RemotePodsTransport('http://192.168.1.100:3001'))
+ */
+export declare class RemotePodsTransport implements LocalPodsTransport {
+    private readonly operatorUrl;
+    private readonly operatorHost;
+    constructor(operatorUrl: string);
+    private _injectBaseUrls;
+    list(): Promise<LocalPod[]>;
+    get(id: string): Promise<LocalPod | null>;
+    private _notSupported;
+    create(_data: CreateLocalPodRequest): Promise<LocalPod>;
+    update(_id: string, _data: UpdateLocalPodRequest): Promise<LocalPod>;
+    delete(_id: string): Promise<void>;
+    scanPaths(): Promise<string | null>;
+    scanPorts(_podId: string): Promise<LocalPodInstance[]>;
+    refreshInstance(_instanceId: string): Promise<LocalPodInstance>;
+    startInstance(_req: StartInstanceRequest): Promise<LocalPodInstance>;
+    stopInstance(_instanceId: string): Promise<void>;
+    restartInstance(_instanceId: string): Promise<void>;
+    deleteInstance(_instanceId: string): Promise<void>;
+    getSystemInfo(): Promise<SystemInfo>;
+    getLogs(_instanceId: string): Promise<string[]>;
+    installRocmPyTorch(_podId: string): void;
+    onInstanceStatusChanged(_cb: (instanceId: string, status: LocalPodInstanceStatus, info?: ComfyUISystemStats) => void): () => void;
+    onLog(_cb: (instanceId: string, line: string) => void): () => void;
+    onRocmSetupDone(_cb: (data: {
+        podId: string;
+        success: boolean;
+    }) => void): () => void;
+}

package/dist/remote-transport.js

@@ -0,0 +1,175 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemotePodsTransport = void 0;
+/**
+ * RemotePodsTransport — reads pods from a FlowScale Operator HTTP API
+ * served by PodsOperatorServer running on another machine.
+ *
+ * Only `list()` and `get()` are functional. All other methods throw since
+ * process lifecycle management must be done on the machine running the operator.
+ *
+ * Instance `baseUrl` fields are automatically set to `http://operatorHost:port`
+ * so that callers can reach the ComfyUI instances across the network.
+ *
+ * Usage:
+ *   import { RemotePodsTransport, LocalPodsAPI } from 'flowscale'
+ *   const podsApi = new LocalPodsAPI(new RemotePodsTransport('http://192.168.1.100:3001'))
+ */
+var RemotePodsTransport = /** @class */ (function () {
+    function RemotePodsTransport(operatorUrl) {
+        this.operatorUrl = operatorUrl.replace(/\/$/, '');
+        try {
+            this.operatorHost = new URL(this.operatorUrl).hostname;
+        }
+        catch (_a) {
+            this.operatorHost = 'localhost';
+        }
+    }
+    RemotePodsTransport.prototype._injectBaseUrls = function (pod) {
+        var _this = this;
+        return __assign(__assign({}, pod), { instances: pod.instances.map(function (inst) { return (__assign(__assign({}, inst), { baseUrl: "http://".concat(_this.operatorHost, ":").concat(inst.port) })); }) });
+    };
+    RemotePodsTransport.prototype.list = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var res, pods;
+            var _this = this;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, fetch("".concat(this.operatorUrl, "/api/pods"), {
+                            signal: AbortSignal.timeout(5000),
+                        })];
+                    case 1:
+                        res = _a.sent();
+                        if (!res.ok)
+                            throw new Error("Operator /api/pods failed (".concat(res.status, ")"));
+                        return [4 /*yield*/, res.json()];
+                    case 2:
+                        pods = (_a.sent());
+                        return [2 /*return*/, pods.map(function (p) { return _this._injectBaseUrls(p); })];
+                }
+            });
+        });
+    };
+    RemotePodsTransport.prototype.get = function (id) {
+        return __awaiter(this, void 0, void 0, function () {
+            var res, pod;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, fetch("".concat(this.operatorUrl, "/api/pods/").concat(encodeURIComponent(id)), { signal: AbortSignal.timeout(5000) })];
+                    case 1:
+                        res = _a.sent();
+                        if (res.status === 404)
+                            return [2 /*return*/, null];
+                        if (!res.ok)
+                            throw new Error("Operator /api/pods/".concat(id, " failed (").concat(res.status, ")"));
+                        return [4 /*yield*/, res.json()];
+                    case 2:
+                        pod = (_a.sent());
+                        return [2 /*return*/, this._injectBaseUrls(pod)];
+                }
+            });
+        });
+    };
+    // ── Not available via remote operator ──────────────────────────────────────
+    RemotePodsTransport.prototype._notSupported = function (method) {
+        throw new Error("RemotePodsTransport: \"".concat(method, "\" is not available via remote operator \u2014 ") +
+            'connect to the operator machine directly to manage pods.');
+    };
+    RemotePodsTransport.prototype.create = function (_data) {
+        return this._notSupported('create');
+    };
+    RemotePodsTransport.prototype.update = function (_id, _data) {
+        return this._notSupported('update');
+    };
+    RemotePodsTransport.prototype.delete = function (_id) {
+        return this._notSupported('delete');
+    };
+    RemotePodsTransport.prototype.scanPaths = function () {
+        return this._notSupported('scanPaths');
+    };
+    RemotePodsTransport.prototype.scanPorts = function (_podId) {
+        return this._notSupported('scanPorts');
+    };
+    RemotePodsTransport.prototype.refreshInstance = function (_instanceId) {
+        return this._notSupported('refreshInstance');
+    };
+    RemotePodsTransport.prototype.startInstance = function (_req) {
+        return this._notSupported('startInstance');
+    };
+    RemotePodsTransport.prototype.stopInstance = function (_instanceId) {
+        return this._notSupported('stopInstance');
+    };
+    RemotePodsTransport.prototype.restartInstance = function (_instanceId) {
+        return this._notSupported('restartInstance');
+    };
+    RemotePodsTransport.prototype.deleteInstance = function (_instanceId) {
+        return this._notSupported('deleteInstance');
+    };
+    RemotePodsTransport.prototype.getSystemInfo = function () {
+        return this._notSupported('getSystemInfo');
+    };
+    RemotePodsTransport.prototype.getLogs = function (_instanceId) {
+        return this._notSupported('getLogs');
+    };
+    RemotePodsTransport.prototype.installRocmPyTorch = function (_podId) {
+        this._notSupported('installRocmPyTorch');
+    };
+    RemotePodsTransport.prototype.onInstanceStatusChanged = function (_cb) {
+        return function () { };
+    };
+    RemotePodsTransport.prototype.onLog = function (_cb) {
+        return function () { };
+    };
+    RemotePodsTransport.prototype.onRocmSetupDone = function (_cb) {
+        return function () { };
+    };
+    return RemotePodsTransport;
+}());
+exports.RemotePodsTransport = RemotePodsTransport;

package/package.json

@@ -1,9 +1,19 @@
 {
   "name": "flowscale",
-  "version": "2.1.0-beta.1",
+  "version": "2.1.0-beta.3",
   "description": "An NPM library for communicating with the Flowscale APIs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./node": {
+      "require": "./dist/node-index.js",
+      "types": "./dist/node-index.d.ts"
+    }
+  },
   "keywords": [
     "flowscale",
     "api",
@@ -33,7 +43,16 @@
     "axios": "^1.7.7",
     "form-data": "^4.0.1"
   },
+  "peerDependencies": {
+    "better-sqlite3": ">=9.0.0"
+  },
+  "peerDependenciesMeta": {
+    "better-sqlite3": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
     "@types/form-data": "^2.5.2",
     "@types/node": "^22.9.1",
     "typescript": "^5.6.3"