@serfab/cadre-host 0.7.1

package/dist/orchestrator/host-process-orchestrator.js

@@ -0,0 +1,557 @@
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+import { randomBytes } from 'node:crypto';
+import { existsSync, readFileSync, rmSync, writeFileSync, mkdirSync, statSync, openSync, readSync, closeSync, } from 'node:fs';
+import { join, resolve as resolvePath } from 'node:path';
+import debug from 'debug';
+import pidusage from 'pidusage';
+import { defaultLogPath, rotateOnDisk } from './log-rotator.js';
+import { PortAllocator } from './port-allocator.js';
+import { StateStore } from './state-store.js';
+import { isPidAlive } from './pid-liveness.js';
+import { decodeDockerId, encodeDockerId, } from './types.js';
+const log = debug('cadre:host:orchestrator');
+const DEFAULTS = {
+    portRangeStart: 10000,
+    portRangeEnd: 20000,
+    stopTimeoutMs: 10000,
+    logMaxBytes: 10 * 1024 * 1024,
+    logMaxFiles: 5,
+};
+const STARTUP_TOKEN_FILE = '.startup-token';
+const CONFIG_FILE = 'cadre.json';
+const LIVENESS_POLL_MS = 100;
+/**
+ * Runs cadre nodes as plain Node child processes on the host.
+ *
+ * Each container gets its own workdir under `rootDir`. Handles are mirrored
+ * to `<rootDir>/state.json` so cadre-host can re-attach after a restart.
+ *
+ * ## Child stdio: direct-fd inheritance
+ *
+ * Spawned children inherit a file descriptor opened on `<workdir>/node.log`
+ * directly as their stdout and stderr. The orchestrator closes its own copy
+ * of the fd immediately after spawn, so the child's write path no longer
+ * touches any handle owned by this process. This is what lets children
+ * survive — and keep logging through — an orchestrator restart. Were the
+ * orchestrator instead piping stdout/stderr through an in-process Writable,
+ * a parent exit would deliver SIGPIPE to the child (POSIX) or fail its
+ * writes with EPIPE (Windows), silently breaking the documented "init()
+ * re-attach" flow.
+ *
+ * ## Log rotation: spawn-time only
+ *
+ * Because the child holds a stable fd open against the inode, the
+ * orchestrator cannot safely rename `node.log` while the child is running.
+ * Rotation therefore happens only at spawn time, when no live child is
+ * attached to the workdir (`createContainer` is the single producer per
+ * workdir). If `node.log` already exceeds `logMaxBytes`, the rotation
+ * cascade runs against the on-disk paths before the fresh fd is opened.
+ * A child whose log grows past `logMaxBytes` mid-run will keep appending
+ * to the active file until it (or its successor) is restarted; v1 traffic
+ * is low enough that this is acceptable.
+ */
+export class HostProcessOrchestrator {
+    constructor(cfg) {
+        this.cfg = cfg;
+        this.handles = new Map();
+        /** State-change listeners — invoked when a handle's alive state changes. */
+        this.stateListeners = new Set();
+        this.rootDir = resolvePath(cfg.rootDir);
+        mkdirSync(this.rootDir, { recursive: true });
+        this.portAllocator = new PortAllocator(cfg.portRange?.start ?? DEFAULTS.portRangeStart, cfg.portRange?.end ?? DEFAULTS.portRangeEnd);
+        this.stateStore = new StateStore(this.rootDir);
+        this.stopTimeoutMs = cfg.stopTimeoutMs ?? DEFAULTS.stopTimeoutMs;
+        this.logMaxBytes = cfg.logMaxBytes ?? DEFAULTS.logMaxBytes;
+        this.logMaxFiles = cfg.logMaxFiles ?? DEFAULTS.logMaxFiles;
+        this.defaultMemoryLimit = cfg.defaultResources?.memoryLimit;
+        this.cliEntrypoint = cfg.spawn?.entrypoint ?? resolveCadreCliBin();
+        log('HostProcessOrchestrator rootDir=%s cli=%s', this.rootDir, this.cliEntrypoint);
+    }
+    /**
+     * Read persisted state and re-attach to surviving children. Not part of
+     * `Orchestrator` — call once before handing the instance to a container
+     * service.
+     */
+    async init() {
+        const state = this.stateStore.load();
+        for (const persisted of state.handles) {
+            const alive = isPidAlive(persisted.pid) && tokenMatches(persisted.workdir, persisted.startupToken);
+            const handle = {
+                containerId: persisted.containerId,
+                dockerId: persisted.dockerId,
+                pid: persisted.pid,
+                startupToken: persisted.startupToken,
+                workdir: persisted.workdir,
+                ports: persisted.ports,
+                spawnedAt: persisted.spawnedAt,
+                partyId: persisted.partyId,
+                profile: persisted.profile,
+                alive,
+            };
+            this.handles.set(handle.dockerId, handle);
+            // Always reserve ports — even for dead handles, until the caller cleans them up
+            this.portAllocator.markUsed(persisted.ports.health);
+            this.portAllocator.markUsed(persisted.ports.metrics);
+            this.portAllocator.markUsed(persisted.ports.p2p);
+        }
+        log('init: re-attached %d handles', state.handles.length);
+    }
+    /**
+     * Snapshot of currently-known managed nodes. Used by the local UI's
+     * `/api/nodes` route.
+     */
+    listNodes() {
+        return [...this.handles.values()].map((h) => toNodeInfo(h));
+    }
+    /**
+     * Look up a single managed node by either containerId (friendly id) or
+     * dockerId (opaque `pid:token`). Returns undefined when neither matches.
+     */
+    getNode(idOrDockerId) {
+        const direct = this.handles.get(idOrDockerId);
+        if (direct)
+            return toNodeInfo(direct);
+        for (const h of this.handles.values()) {
+            if (h.containerId === idOrDockerId)
+                return toNodeInfo(h);
+        }
+        return undefined;
+    }
+    /**
+     * Resolve the opaque dockerId for a friendly containerId so callers can
+     * pass it into stopContainer / getLogs / getStats.
+     */
+    resolveDockerId(idOrDockerId) {
+        if (this.handles.has(idOrDockerId))
+            return idOrDockerId;
+        for (const h of this.handles.values()) {
+            if (h.containerId === idOrDockerId)
+                return h.dockerId;
+        }
+        return undefined;
+    }
+    /**
+     * Register a state-change listener. Invoked when a handle's `alive`
+     * transitions (child exit, manual stop). Returns an unsubscribe fn.
+     */
+    onStateChange(listener) {
+        this.stateListeners.add(listener);
+        return () => { this.stateListeners.delete(listener); };
+    }
+    /** Handles that init() found dead (PID gone or token mismatch). */
+    listDeadHandles() {
+        const dead = [];
+        for (const h of this.handles.values()) {
+            if (!h.alive) {
+                dead.push(this.toPersisted(h));
+            }
+        }
+        return dead;
+    }
+    async createContainer(request) {
+        const healthPort = this.portAllocator.allocate();
+        const metricsPort = this.portAllocator.allocate();
+        const p2pPort = this.portAllocator.allocate();
+        const workdir = join(this.rootDir, request.containerId);
+        mkdirSync(workdir, { recursive: true });
+        mkdirSync(join(workdir, 'storage'), { recursive: true });
+        const token = randomBytes(16).toString('hex');
+        const tokenPath = join(workdir, STARTUP_TOKEN_FILE);
+        // Ensure stale token from a previous container with the same id is cleared.
+        if (existsSync(tokenPath)) {
+            try {
+                rmSync(tokenPath);
+            }
+            catch { /* ignore */ }
+        }
+        const configPath = join(workdir, CONFIG_FILE);
+        writeFileSync(configPath, JSON.stringify(this.buildChildConfig(request, workdir), null, 2), 'utf8');
+        const memoryLimit = request.resources?.memoryLimit ?? this.defaultMemoryLimit;
+        const heapBytes = parseMemoryLimit(memoryLimit);
+        const heapMB = heapBytes !== undefined ? Math.max(64, Math.floor(heapBytes / (1024 * 1024))) : undefined;
+        const env = {
+            ...process.env,
+            CADRE_STARTUP_TOKEN: token,
+            CADRE_HEALTH_PORT: String(healthPort),
+            CADRE_METRICS_PORT: String(metricsPort),
+            CADRE_LISTEN_ADDRS: `/ip4/0.0.0.0/tcp/${p2pPort}`,
+        };
+        if (heapMB !== undefined) {
+            env.NODE_OPTIONS = `${process.env.NODE_OPTIONS ?? ''} --max-old-space-size=${heapMB}`.trim();
+        }
+        // Rotate the on-disk log files BEFORE opening the fd — once the child
+        // is running it holds the inode open and any later rename would leave
+        // it writing to the rotated file. See class docstring.
+        const logPath = defaultLogPath(workdir);
+        maybeRotateAtSpawn(logPath, this.logMaxBytes, this.logMaxFiles);
+        const logFd = openSync(logPath, 'a');
+        let child;
+        try {
+            child = spawn(process.execPath, [
+                this.cliEntrypoint,
+                'start',
+                '-c', configPath,
+                '--health-port', String(healthPort),
+                '--metrics-port', String(metricsPort),
+                '--startup-token-file', tokenPath,
+            ], {
+                cwd: workdir,
+                detached: true,
+                // Inherit the log fd directly. OS duplicates it into the child;
+                // closing our copy below is safe and severs the parent's only
+                // tie to the child's write path.
+                stdio: ['ignore', logFd, logFd],
+                env,
+            });
+        }
+        catch (err) {
+            // Synchronous spawn failure — release the fd and the reserved ports
+            // before propagating, so a bad-args bug doesn't leak resources.
+            closeSync(logFd);
+            this.portAllocator.release(healthPort);
+            this.portAllocator.release(metricsPort);
+            this.portAllocator.release(p2pPort);
+            throw err;
+        }
+        // Always release the parent's copy of the fd — the child has its own.
+        closeSync(logFd);
+        if (!child.pid) {
+            // Spawn returned without a pid — release reservations and report.
+            this.portAllocator.release(healthPort);
+            this.portAllocator.release(metricsPort);
+            this.portAllocator.release(p2pPort);
+            throw new Error(`Failed to spawn child for container ${request.containerId}`);
+        }
+        child.unref();
+        const dockerId = encodeDockerId(child.pid, token);
+        const handle = {
+            containerId: request.containerId,
+            dockerId,
+            pid: child.pid,
+            startupToken: token,
+            workdir,
+            ports: { health: healthPort, metrics: metricsPort, p2p: p2pPort },
+            spawnedAt: new Date().toISOString(),
+            partyId: request.partyId,
+            profile: request.profile,
+            child,
+            alive: true,
+        };
+        child.once('exit', () => {
+            const h = this.handles.get(dockerId);
+            if (h && h.alive) {
+                h.alive = false;
+                this.emitStateChange(h);
+            }
+        });
+        this.handles.set(dockerId, handle);
+        this.persist();
+        this.emitStateChange(handle);
+        log('created container %s -> pid %d ports=%j', request.containerId, child.pid, handle.ports);
+        return {
+            dockerId,
+            healthEndpoint: `http://localhost:${healthPort}/health`,
+            metricsEndpoint: `http://localhost:${metricsPort}/metrics`,
+            p2pPort,
+        };
+    }
+    async stopContainer(dockerId) {
+        const handle = this.requireHandle(dockerId);
+        if (!isPidAlive(handle.pid)) {
+            handle.alive = false;
+            this.persist();
+            return;
+        }
+        // Capture the exit event before we send signals so we can await full
+        // teardown — important on Windows where cwd handles release lazily.
+        const exitPromise = handle.child
+            ? new Promise((resolve) => handle.child.once('exit', () => resolve()))
+            : Promise.resolve();
+        log('SIGTERM container %s (pid=%d)', handle.containerId, handle.pid);
+        try {
+            process.kill(handle.pid, 'SIGTERM');
+        }
+        catch (err) {
+            const code = err.code;
+            if (code !== 'ESRCH') {
+                throw err;
+            }
+        }
+        const deadline = Date.now() + this.stopTimeoutMs;
+        while (Date.now() < deadline) {
+            if (!isPidAlive(handle.pid))
+                break;
+            await sleep(LIVENESS_POLL_MS);
+        }
+        if (isPidAlive(handle.pid)) {
+            log('SIGKILL container %s (pid=%d)', handle.containerId, handle.pid);
+            try {
+                process.kill(handle.pid, 'SIGKILL');
+            }
+            catch (err) {
+                const code = err.code;
+                if (code !== 'ESRCH') {
+                    throw err;
+                }
+            }
+            const killDeadline = Date.now() + 2000;
+            while (Date.now() < killDeadline && isPidAlive(handle.pid)) {
+                await sleep(LIVENESS_POLL_MS);
+            }
+        }
+        // Wait briefly for the OS to fully tear down the child (Windows cwd lock).
+        await Promise.race([exitPromise, sleep(1000)]);
+        const wasAlive = handle.alive;
+        handle.alive = false;
+        this.persist();
+        if (wasAlive)
+            this.emitStateChange(handle);
+    }
+    async removeContainer(dockerId) {
+        const handle = this.requireHandle(dockerId);
+        if (isPidAlive(handle.pid)) {
+            await this.stopContainer(dockerId);
+        }
+        this.portAllocator.release(handle.ports.health);
+        this.portAllocator.release(handle.ports.metrics);
+        this.portAllocator.release(handle.ports.p2p);
+        // On Windows the OS releases the child's cwd handle asynchronously, so
+        // retry rmSync to give the kernel a chance to drop it.
+        try {
+            rmSync(handle.workdir, { recursive: true, force: true, maxRetries: 20, retryDelay: 200 });
+        }
+        catch (err) {
+            log('failed to remove workdir %s: %o', handle.workdir, err);
+        }
+        this.handles.delete(dockerId);
+        this.persist();
+    }
+    async isRunning(dockerId) {
+        let handle = this.handles.get(dockerId);
+        let pid;
+        let token;
+        let workdir;
+        if (handle) {
+            pid = handle.pid;
+            token = handle.startupToken;
+            workdir = handle.workdir;
+        }
+        else {
+            try {
+                const decoded = decodeDockerId(dockerId);
+                pid = decoded.pid;
+                token = decoded.token;
+            }
+            catch {
+                return false;
+            }
+        }
+        if (!isPidAlive(pid)) {
+            if (handle)
+                handle.alive = false;
+            return false;
+        }
+        if (workdir === undefined) {
+            // We have no record — without a workdir we can't verify the token,
+            // so we must treat this as unknown rather than running.
+            return false;
+        }
+        return tokenMatches(workdir, token);
+    }
+    async getStats(dockerId) {
+        const handle = this.requireHandle(dockerId);
+        if (!isPidAlive(handle.pid)) {
+            return { cpuPercent: 0, memoryBytes: 0, networkRxBytes: 0, networkTxBytes: 0 };
+        }
+        try {
+            const usage = await pidusage(handle.pid);
+            return {
+                cpuPercent: usage.cpu,
+                memoryBytes: usage.memory,
+                networkRxBytes: 0,
+                networkTxBytes: 0,
+            };
+        }
+        catch (err) {
+            log('pidusage failed for %d: %o', handle.pid, err);
+            return { cpuPercent: 0, memoryBytes: 0, networkRxBytes: 0, networkTxBytes: 0 };
+        }
+    }
+    async getLogs(dockerId, tail = 100) {
+        const handle = this.requireHandle(dockerId);
+        const logPath = defaultLogPath(handle.workdir);
+        return tailFile(logPath, tail);
+    }
+    requireHandle(dockerId) {
+        const handle = this.handles.get(dockerId);
+        if (!handle) {
+            throw new Error(`Container not found: ${dockerId}`);
+        }
+        return handle;
+    }
+    buildChildConfig(req, workdir) {
+        const cfg = {
+            controlNetwork: {
+                partyId: req.partyId,
+                bootstrapNodes: req.bootstrapNodes,
+            },
+            profile: req.profile,
+            strandFilter: req.strandFilter ?? 'all',
+        };
+        if (req.profile === 'storage') {
+            const storage = {
+                type: 'file',
+                path: join(workdir, 'storage'),
+            };
+            if (req.resources?.storageQuotaBytes !== undefined) {
+                storage.quotaBytes = req.resources.storageQuotaBytes;
+            }
+            cfg.storage = storage;
+        }
+        return cfg;
+    }
+    persist() {
+        const state = {
+            version: 1,
+            handles: [...this.handles.values()].map((h) => this.toPersisted(h)),
+        };
+        this.stateStore.save(state);
+    }
+    emitStateChange(handle) {
+        if (this.stateListeners.size === 0)
+            return;
+        const info = toNodeInfo(handle);
+        for (const listener of this.stateListeners) {
+            try {
+                listener(info);
+            }
+            catch (err) {
+                log('state listener threw for %s: %o', info.id, err);
+            }
+        }
+    }
+    toPersisted(h) {
+        return {
+            containerId: h.containerId,
+            dockerId: h.dockerId,
+            pid: h.pid,
+            startupToken: h.startupToken,
+            workdir: h.workdir,
+            ports: h.ports,
+            spawnedAt: h.spawnedAt,
+            partyId: h.partyId,
+            profile: h.profile,
+        };
+    }
+}
+function toNodeInfo(h) {
+    return {
+        id: h.containerId,
+        dockerId: h.dockerId,
+        partyId: h.partyId,
+        profile: h.profile,
+        status: h.alive ? 'running' : 'stopped',
+        spawnedAt: h.spawnedAt,
+        workdir: h.workdir,
+        ports: { ...h.ports },
+    };
+}
+/**
+ * Locate the cadre-cli bin via the consumer-style module resolver. Works for
+ * both yarn-managed workspaces and traditional npm installs.
+ */
+function resolveCadreCliBin() {
+    const req = createRequire(import.meta.url);
+    try {
+        return req.resolve('@serfab/cadre-cli/bin/cadre.js');
+    }
+    catch (err) {
+        throw new Error(`Unable to resolve @serfab/cadre-cli bin from cadre-host. ` +
+            `Ensure cadre-cli is built (yarn workspace @serfab/cadre-cli build) ` +
+            `and listed as a dependency. Underlying error: ${err.message}`);
+    }
+}
+function tokenMatches(workdir, expected) {
+    const tokenPath = join(workdir, STARTUP_TOKEN_FILE);
+    try {
+        const contents = readFileSync(tokenPath, 'utf8').trim();
+        return contents === expected;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Rotate the on-disk log files for a workdir if the active file is already
+ * at or above the byte threshold. Called from `createContainer` before the
+ * child's stdio fd is opened — the only safe rotation point because the
+ * caller guarantees no live child is attached to this workdir.
+ */
+function maybeRotateAtSpawn(logPath, maxBytes, maxFiles) {
+    if (maxBytes <= 0 || maxFiles < 1)
+        return;
+    let size = 0;
+    try {
+        size = statSync(logPath).size;
+    }
+    catch {
+        return;
+    }
+    if (size >= maxBytes) {
+        rotateOnDisk(logPath, maxFiles);
+    }
+}
+function sleep(ms) {
+    return new Promise((res) => {
+        const t = setTimeout(res, ms);
+        if (typeof t.unref === 'function')
+            t.unref();
+    });
+}
+/**
+ * Read the last `n` lines from a log file. Reads from the tail in chunks
+ * rather than slurping the whole file.
+ */
+function tailFile(path, n) {
+    if (!existsSync(path))
+        return '';
+    const fd = openSync(path, 'r');
+    try {
+        const size = statSync(path).size;
+        const chunkSize = 8192;
+        let pos = size;
+        const buffers = [];
+        let newlineCount = 0;
+        while (pos > 0 && newlineCount <= n) {
+            const readLen = Math.min(chunkSize, pos);
+            pos -= readLen;
+            const buf = Buffer.alloc(readLen);
+            readSync(fd, buf, 0, readLen, pos);
+            buffers.unshift(buf);
+            for (let i = 0; i < buf.length; i++) {
+                if (buf[i] === 0x0a)
+                    newlineCount++;
+            }
+        }
+        const joined = Buffer.concat(buffers).toString('utf8');
+        const lines = joined.split('\n');
+        // Drop any trailing empty line from a terminating newline before counting.
+        const trimmed = lines[lines.length - 1] === '' ? lines.slice(0, -1) : lines;
+        return trimmed.slice(-n).join('\n');
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+function parseMemoryLimit(limit) {
+    if (!limit)
+        return undefined;
+    const match = limit.match(/^(\d+(?:\.\d+)?)\s*(B|K|M|G|T)?$/i);
+    if (!match)
+        return undefined;
+    const [, num, unit] = match;
+    const multipliers = { B: 1, K: 1024, M: 1024 ** 2, G: 1024 ** 3, T: 1024 ** 4 };
+    return Math.floor(parseFloat(num) * (multipliers[unit?.toUpperCase() ?? 'B'] ?? 1));
+}
+//# sourceMappingURL=host-process-orchestrator.js.map

package/dist/orchestrator/host-process-orchestrator.js.map

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

package/dist/orchestrator/index.d.ts

@@ -0,0 +1,3 @@
+export { HostProcessOrchestrator } from './host-process-orchestrator.js';
+export type { HostProcessConfig, ManagedNodeInfo, NodeStateListener } from './types.js';
+export type { PersistedHandle } from './state-store.js';

package/dist/orchestrator/index.js

@@ -0,0 +1,2 @@
+export { HostProcessOrchestrator } from './host-process-orchestrator.js';
+//# sourceMappingURL=index.js.map

package/dist/orchestrator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/orchestrator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/orchestrator/log-rotator.d.ts

@@ -0,0 +1,25 @@
+/**
+ * On-disk log rotation helper.
+ *
+ * Children spawned by the orchestrator inherit a direct file descriptor to
+ * their `node.log` (see `host-process-orchestrator.ts`), so rotation can no
+ * longer be driven by an in-process byte counter — renaming the path under a
+ * running child would leave it writing to the renamed inode. Instead the
+ * orchestrator calls `rotateOnDisk(...)` at spawn time, before the child is
+ * launched and its fd is opened. This is the only safe point to rotate
+ * without coordinating with the running process.
+ *
+ * Within a workdir there is at most one live child, so spawn-time rotation
+ * is sufficient for v1: a child that exceeds `logMaxBytes` mid-run will
+ * keep appending to the active file until it (or its successor) is restarted.
+ */
+/**
+ * Perform a rotation cascade against on-disk paths: drop the oldest, then
+ * shift `.N-1 → .N`, …, `.1 → .2`, and finally `filePath → .1`.
+ *
+ * Caller is responsible for deciding when to rotate (e.g. when
+ * `statSync(filePath).size >= logMaxBytes`). No fd is held by this helper.
+ */
+export declare function rotateOnDisk(filePath: string, maxFiles: number): void;
+/** Build the standard log file path for a workdir. */
+export declare function defaultLogPath(workdir: string): string;