@lumenflow/runtime 3.0.0

package/dist/transport/unix-socket-server.js

@@ -0,0 +1,112 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { createServer } from 'node:net';
+import { chmod, mkdir, rm } from 'node:fs/promises';
+import path from 'node:path';
+import { z } from 'zod';
+export const DaemonRequestSchema = z.object({
+    id: z.string().min(1),
+    method: z.string().min(1),
+    params: z.unknown(),
+});
+export class UnixSocketServer {
+    socketPath;
+    handler;
+    server;
+    constructor(options) {
+        this.socketPath = path.resolve(options.socketPath);
+        this.handler = options.handler;
+        this.server = null;
+    }
+    async start() {
+        await mkdir(path.dirname(this.socketPath), { recursive: true });
+        await rm(this.socketPath, { force: true });
+        this.server = createServer((socket) => {
+            this.attachConnection(socket);
+        });
+        await new Promise((resolve, reject) => {
+            if (!this.server) {
+                reject(new Error('Unix socket server was not created.'));
+                return;
+            }
+            this.server.once('error', reject);
+            this.server.listen(this.socketPath, () => {
+                this.server?.off('error', reject);
+                resolve();
+            });
+        });
+        await chmod(this.socketPath, 0o600);
+    }
+    async stop() {
+        const activeServer = this.server;
+        this.server = null;
+        if (activeServer) {
+            await new Promise((resolve, reject) => {
+                activeServer.close((error) => {
+                    if (error) {
+                        reject(error);
+                        return;
+                    }
+                    resolve();
+                });
+            });
+        }
+        await rm(this.socketPath, { force: true });
+    }
+    isRunning() {
+        return this.server !== null;
+    }
+    attachConnection(socket) {
+        let buffer = '';
+        socket.on('data', (chunk) => {
+            buffer += chunk.toString('utf8');
+            const lines = buffer.split('\n');
+            buffer = lines.pop() ?? '';
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed) {
+                    continue;
+                }
+                this.processLine(trimmed, socket).catch(() => {
+                    socket.write(`${JSON.stringify({
+                        id: 'unknown',
+                        ok: false,
+                        error: 'Failed to process daemon request.',
+                    })}\n`);
+                });
+            }
+        });
+    }
+    async processLine(line, socket) {
+        let parsedRequestJson;
+        try {
+            parsedRequestJson = JSON.parse(line);
+        }
+        catch {
+            socket.write(`${JSON.stringify({
+                id: 'unknown',
+                ok: false,
+                error: 'Invalid JSON payload.',
+            })}\n`);
+            return;
+        }
+        const parsedRequest = DaemonRequestSchema.safeParse(parsedRequestJson);
+        if (!parsedRequest.success) {
+            const requestId = parsedRequestJson &&
+                typeof parsedRequestJson === 'object' &&
+                'id' in parsedRequestJson &&
+                typeof parsedRequestJson.id === 'string'
+                ? (parsedRequestJson.id ?? 'unknown')
+                : 'unknown';
+            socket.write(`${JSON.stringify({
+                id: requestId,
+                ok: false,
+                error: `Invalid daemon request: ${parsedRequest.error.issues[0]?.message ?? parsedRequest.error.message}`,
+            })}\n`);
+            return;
+        }
+        const response = await this.handler(parsedRequest.data);
+        socket.write(`${JSON.stringify(response)}\n`);
+    }
+}
+//# sourceMappingURL=unix-socket-server.js.map

package/dist/transport/unix-socket-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unix-socket-server.js","sourceRoot":"","sources":["../../src/transport/unix-socket-server.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC,OAAO,EAAE,YAAY,EAA4B,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;CACpB,CAAC,CAAC;AAiBH,MAAM,OAAO,gBAAgB;IACV,UAAU,CAAS;IACnB,OAAO,CAAuB;IACvC,MAAM,CAAgB;IAE9B,YAAY,OAAgC;QAC1C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAE3C,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;YACpC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjB,MAAM,CAAC,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC,CAAC;gBACzD,OAAO;YACT,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE;gBACvC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAClC,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QAEnB,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC1C,YAAY,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;oBAC3B,IAAI,KAAK,EAAE,CAAC;wBACV,MAAM,CAAC,KAAK,CAAC,CAAC;wBACd,OAAO;oBACT,CAAC;oBACD,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;IAC9B,CAAC;IAEO,gBAAgB,CAAC,MAAc;QACrC,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1B,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACjC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;YAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,SAAS;gBACX,CAAC;gBACD,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;oBAC3C,MAAM,CAAC,KAAK,CACV,GAAG,IAAI,CAAC,SAAS,CAAC;wBAChB,EAAE,EAAE,SAAS;wBACb,EAAE,EAAE,KAAK;wBACT,KAAK,EAAE,mCAAmC;qBAClB,CAAC,IAAI,CAChC,CAAC;gBACJ,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,IAAY,EAAE,MAAc;QACpD,IAAI,iBAA0B,CAAC;QAC/B,IAAI,CAAC;YACH,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,KAAK,CACV,GAAG,IAAI,CAAC,SAAS,CAAC;gBAChB,EAAE,EAAE,SAAS;gBACb,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,uBAAuB;aACN,CAAC,IAAI,CAChC,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,aAAa,GAAG,mBAAmB,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QACvE,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;YAC3B,MAAM,SAAS,GACb,iBAAiB;gBACjB,OAAO,iBAAiB,KAAK,QAAQ;gBACrC,IAAI,IAAI,iBAAiB;gBACzB,OAAQ,iBAAsC,CAAC,EAAE,KAAK,QAAQ;gBAC5D,CAAC,CAAC,CAAE,iBAAoC,CAAC,EAAE,IAAI,SAAS,CAAC;gBACzD,CAAC,CAAC,SAAS,CAAC;YAEhB,MAAM,CAAC,KAAK,CACV,GAAG,IAAI,CAAC,SAAS,CAAC;gBAChB,EAAE,EAAE,SAAS;gBACb,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,2BAA2B,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE;aACjF,CAAC,IAAI,CAChC,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;CACF"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@lumenflow/runtime",
+  "version": "3.0.0",
+  "description": "Runtime daemon, scheduler, sessions, and IPC transport for LumenFlow",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "zod": "^4.3.6"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:dist": "tsc -p tsconfig.build.json",
+    "pack:dist": "pnpm pack",
+    "clean": "rm -rf dist *.tgz",
+    "test": "vitest run",
+    "lint": "eslint src __tests__ --quiet --rule no-console:off --rule @typescript-eslint/no-unused-vars:off",
+    "typecheck": "tsc --noEmit"
+  }
+}