@acpus/runtime 0.1.0

package/dist/store.js

@@ -0,0 +1,260 @@
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, rmSync, readdirSync, readFileSync, renameSync, lstatSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { encodeNodeKeyForFs, encodeNodeKeyForDir } from "./keys.js";
+/**
+ * Per-node JSON file persistence with write-to-temp-then-rename for crash safety.
+ *
+ * Directory layout:
+ *   .acpus/state/
+ *     runs/
+ *       <run_id>/
+ *         ir.json            # frozen IR snapshot
+ *         input.json         # resolved input
+ *         run-meta.json      # RunState
+ *         nodes/
+ *           workflow:step-a.json      # NodeExecutionState
+ *           workflow:mapped:item:0:lane:0.json
+ *         artifacts/
+ *           workflow:step-a/
+ *             transcript.json
+ *             stdout.txt
+ */
+/**
+ * Validate a runId is safe for filesystem path construction.
+ * Rejects path traversal (..), path separators, and null bytes.
+ * Does NOT require strict UUID format — tests may use short IDs like "run-1".
+ */
+const UNSAFE_RUN_ID = /(^|\/)\.\.?(\/|$)|[\\:\0]/;
+function validateRunId(runId) {
+    if (!runId || UNSAFE_RUN_ID.test(runId)) {
+        throw new Error(`Invalid runId: '${runId}' contains unsafe path characters`);
+    }
+}
+export class RunStore {
+    baseDir;
+    constructor(baseDir) {
+        this.baseDir = baseDir ?? join(process.cwd(), ".acpus", "state", "runs");
+    }
+    // ─── Run lifecycle ─────────────────────────────────────────────
+    /** Create a new run directory and write IR + input snapshots. */
+    initRun(runId, ir, input, source) {
+        validateRunId(runId);
+        const runDir = this.runDir(runId);
+        mkdirSync(join(runDir, "nodes"), { recursive: true });
+        mkdirSync(join(runDir, "artifacts"), { recursive: true });
+        const irJson = JSON.stringify(ir, null, 2);
+        const inputJson = JSON.stringify(input, null, 2);
+        const irDigest = sha256(irJson);
+        const inputDigest = sha256(inputJson);
+        writeFileSync(join(runDir, "ir.json"), irJson, "utf8");
+        writeFileSync(join(runDir, "input.json"), inputJson, "utf8");
+        const now = new Date().toISOString();
+        const meta = {
+            runId,
+            workflowName: ir.name,
+            workflowRef: source?.workflowRef,
+            workflowSourcePath: source?.workflowSourcePath ?? ir.source.path,
+            status: "running",
+            irDigest,
+            inputDigest,
+            createdAt: now,
+            updatedAt: now,
+            runAttempt: 1
+        };
+        this.writeRunMeta(runId, meta);
+        return meta;
+    }
+    /** Read the frozen IR snapshot for a run. */
+    readIr(runId) {
+        validateRunId(runId);
+        return this.readJson(join(this.runDir(runId), "ir.json"));
+    }
+    /** Read the resolved input for a run. */
+    readInput(runId) {
+        validateRunId(runId);
+        return this.readJson(join(this.runDir(runId), "input.json"));
+    }
+    // ─── Run metadata ──────────────────────────────────────────────
+    writeRunMeta(runId, meta) {
+        validateRunId(runId);
+        this.atomicWriteJson(join(this.runDir(runId), "run-meta.json"), meta);
+    }
+    readRunMeta(runId) {
+        validateRunId(runId);
+        return this.readJson(join(this.runDir(runId), "run-meta.json"));
+    }
+    // ─── Node state ────────────────────────────────────────────────
+    /** Atomically write node execution state. */
+    writeNodeState(runId, state) {
+        validateRunId(runId);
+        const filename = encodeNodeKeyForFs(state.nodeKey);
+        this.atomicWriteJson(join(this.runDir(runId), "nodes", filename), state);
+    }
+    /** Read node execution state. Returns undefined if not found. */
+    readNodeState(runId, nodeKey) {
+        validateRunId(runId);
+        const filename = encodeNodeKeyForFs(nodeKey);
+        return this.readJson(join(this.runDir(runId), "nodes", filename));
+    }
+    /** List all node states for a run. */
+    listNodeStates(runId) {
+        validateRunId(runId);
+        const nodesDir = join(this.runDir(runId), "nodes");
+        if (!existsSync(nodesDir))
+            return [];
+        const files = readdirSync(nodesDir).filter((f) => f.endsWith(".json"));
+        return files
+            .map((f) => this.readJson(join(nodesDir, f)))
+            .filter((s) => s !== undefined);
+    }
+    // ─── Run discovery ─────────────────────────────────────────────
+    /** List all run IDs on disk. */
+    listRunIds() {
+        if (!existsSync(this.baseDir))
+            return [];
+        return readdirSync(this.baseDir, { withFileTypes: true })
+            .filter((d) => d.isDirectory())
+            .map((d) => d.name);
+    }
+    /** Get the artifacts directory for a node. */
+    artifactsDir(runId, nodeKey) {
+        validateRunId(runId);
+        const dir = join(this.runDir(runId), "artifacts", encodeNodeKeyForDir(nodeKey));
+        mkdirSync(dir, { recursive: true });
+        return dir;
+    }
+    /** Check if a run exists on disk. */
+    hasRun(runId) {
+        validateRunId(runId);
+        return existsSync(this.runDir(runId));
+    }
+    cleanTerminalRuns(options = {}) {
+        const dryRun = Boolean(options.dryRun);
+        const deleted = [];
+        const skipped = [];
+        for (const runId of this.listRunIds()) {
+            const runDir = this.runDir(runId);
+            const meta = this.readRunMeta(runId);
+            const bytes = directorySize(runDir);
+            if (!meta) {
+                skipped.push({ runId, bytes, reason: "corrupt-metadata" });
+                continue;
+            }
+            if (meta.status !== "completed" && meta.status !== "failed" && meta.status !== "cancelled") {
+                skipped.push({ runId, status: meta.status, bytes, reason: "not-terminal" });
+                continue;
+            }
+            let deleteStatus = meta.status;
+            if (!dryRun) {
+                const latest = this.readRunMeta(runId);
+                if (!latest) {
+                    skipped.push({ runId, bytes, reason: "corrupt-metadata" });
+                    continue;
+                }
+                if (latest.status !== "completed" && latest.status !== "failed" && latest.status !== "cancelled") {
+                    skipped.push({ runId, status: latest.status, bytes, reason: "not-terminal" });
+                    continue;
+                }
+                deleteStatus = latest.status;
+            }
+            deleted.push({ runId, status: deleteStatus, bytes });
+            if (!dryRun) {
+                try {
+                    rmSync(runDir, { recursive: true });
+                }
+                catch {
+                    deleted.pop();
+                    skipped.push({ runId, status: meta.status, bytes, reason: "delete-failed" });
+                }
+            }
+        }
+        return {
+            dryRun,
+            deletedCount: deleted.length,
+            skippedCount: skipped.length,
+            bytesReclaimed: deleted.reduce((sum, item) => sum + item.bytes, 0),
+            deleted,
+            skipped
+        };
+    }
+    /** Get the base directory. */
+    getBaseDir() {
+        return this.baseDir;
+    }
+    /**
+     * Resolve an `artifact://runs/<runId>/nodes/<safeKey>/<filename>` URI to its
+     * absolute filesystem path. Pure (no mkdir). Returns undefined for malformed
+     * URIs. Mirrors ArtifactStore's layout: <baseDir>/<runId>/artifacts/<safeKey>/<filename>.
+     */
+    resolveArtifactPath(uri) {
+        const prefix = "artifact://runs/";
+        if (!uri.startsWith(prefix))
+            return undefined;
+        const parts = uri.slice(prefix.length).split("/");
+        // Format: <runId>/nodes/<safeKey>/<filename>
+        if (parts.length < 4 || parts[1] !== "nodes")
+            return undefined;
+        const runId = parts[0];
+        // Validate runId from URI before using it in path construction
+        if (!runId || UNSAFE_RUN_ID.test(runId))
+            return undefined;
+        // Reject path traversal in safeKey and filename segments
+        if (parts.slice(2).some((p) => p === ".." || p === "." || p === ""))
+            return undefined;
+        const filename = parts[parts.length - 1];
+        const safeKey = parts.slice(2, parts.length - 1).join("/");
+        if (!runId || !filename || !safeKey)
+            return undefined;
+        // safeKey is already the encoded form (slashes → colons) used on disk.
+        const resolved = resolve(join(this.runDir(runId), "artifacts", safeKey, filename));
+        // Defense-in-depth: verify the resolved path stays under the run directory
+        const runDir = this.runDir(runId);
+        if (!resolved.startsWith(runDir + "/") && resolved !== runDir)
+            return undefined;
+        return resolved;
+    }
+    // ─── Internal helpers ──────────────────────────────────────────
+    runDir(runId) {
+        return join(this.baseDir, runId);
+    }
+    /** Write JSON via temp file + atomic rename for crash safety. */
+    atomicWriteJson(filePath, data) {
+        const dir = dirname(filePath);
+        mkdirSync(dir, { recursive: true });
+        const tmpPath = filePath + ".tmp";
+        writeFileSync(tmpPath, JSON.stringify(data, null, 2), "utf8");
+        renameSync(tmpPath, filePath);
+    }
+    /** Read and parse a JSON file. Returns undefined if missing or invalid. */
+    readJson(filePath) {
+        if (!existsSync(filePath))
+            return undefined;
+        try {
+            return JSON.parse(readFileSync(filePath, "utf8"));
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+/** SHA-256 digest of a string. */
+function sha256(content) {
+    return `sha256:${createHash("sha256").update(content).digest("hex")}`;
+}
+function directorySize(path) {
+    try {
+        const stat = lstatSync(path);
+        if (!stat.isDirectory())
+            return stat.size;
+        let total = 0;
+        for (const entry of readdirSync(path, { withFileTypes: true })) {
+            total += directorySize(join(path, entry.name));
+        }
+        return total;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/supervisor-app.d.ts

@@ -0,0 +1,27 @@
+import { Hono } from "hono";
+import type { RunStore } from "./store.js";
+import type { ExecutorAdapter } from "./executors/types.js";
+import type { SupervisorConfig } from "./types.js";
+/**
+ * Creates a Hono HTTP app for the acpus Run Supervisor.
+ *
+ * Note: Node keys contain "/" characters (e.g. "workflow/step-a"), which are
+ * incompatible with URL path segments. Node-addressed routes accept the nodeKey
+ * as a query parameter instead.
+ *
+ * Returns the Hono app plus control handles for the runner to query
+ * idle-shutdown state and inject health-overrides after listen.
+ */
+export declare function createSupervisorApp(config: SupervisorConfig, store: RunStore, agentExecutor: ExecutorAdapter, programExecutor: ExecutorAdapter): {
+    app: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+    /** Expose for the runner to read idle-shutdown state. */
+    getLastActiveAt: () => number;
+    /** Expose for the runner to check how many Runs are still active. */
+    runningCount: () => number;
+    /** Expose for the runner to write the startedAt and endpoint after listen. */
+    setHealthOverrides: (overrides: {
+        startedAt?: string;
+        endpoint?: string;
+    }) => void;
+};
+//# sourceMappingURL=supervisor-app.d.ts.map

package/dist/supervisor-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-app.d.ts","sourceRoot":"","sources":["../src/supervisor-app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAgC,MAAM,YAAY,CAAC;AAYjF;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,QAAQ,EACf,aAAa,EAAE,eAAe,EAC9B,eAAe,EAAE,eAAe;;IAyiB9B,yDAAyD;;IAEzD,qEAAqE;;IAErE,8EAA8E;oCAC9C;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE;EAK5E"}