@smartmemory/stratum 0.3.0

package/dist/connectors/proc_identity.js

@@ -0,0 +1,90 @@
+import { execFile } from "node:child_process";
+import { readFile } from "node:fs/promises";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+const DARWIN_PROC_INFO = String.raw `
+import ctypes,json,sys
+class I(ctypes.Structure):
+ _fields_=[('pbi_flags',ctypes.c_uint32),('pbi_status',ctypes.c_uint32),('pbi_xstatus',ctypes.c_uint32),('pbi_pid',ctypes.c_uint32),('pbi_ppid',ctypes.c_uint32),('pbi_uid',ctypes.c_uint32),('pbi_gid',ctypes.c_uint32),('pbi_ruid',ctypes.c_uint32),('pbi_rgid',ctypes.c_uint32),('pbi_svuid',ctypes.c_uint32),('pbi_svgid',ctypes.c_uint32),('rfu_1',ctypes.c_uint32),('pbi_comm',ctypes.c_char*16),('pbi_name',ctypes.c_char*32),('pbi_nfiles',ctypes.c_uint32),('pbi_pgid',ctypes.c_uint32),('pbi_pjobc',ctypes.c_uint32),('e_tdev',ctypes.c_uint32),('e_tpgid',ctypes.c_int32),('pbi_nice',ctypes.c_int32),('pbi_start_tvsec',ctypes.c_uint64),('pbi_start_tvusec',ctypes.c_uint64)]
+i=I(); r=ctypes.CDLL('libproc.dylib').proc_pidinfo(int(sys.argv[1]),3,0,ctypes.byref(i),ctypes.sizeof(i))
+print(json.dumps({'start':f'{i.pbi_start_tvsec}.{i.pbi_start_tvusec}','pgid':i.pbi_pgid}) if r==ctypes.sizeof(i) and i.pbi_start_tvsec else '')
+`;
+async function darwinStat(pid) {
+    try {
+        // Node has no libproc binding. This is the exact PROC_PIDTBSDINFO query used
+        // by the Python source contract; /usr/bin/python3 is present on supported
+        // development Macs. ps remains a compatibility fallback below.
+        const { stdout } = await execFileAsync("/usr/bin/python3", ["-c", DARWIN_PROC_INFO, String(pid)], { timeout: 5_000 });
+        const value = JSON.parse(stdout.trim());
+        if (typeof value !== "object" || value === null)
+            return undefined;
+        const { start, pgid } = value;
+        return typeof start === "string" && start && Number.isSafeInteger(pgid) && Number(pgid) > 0
+            ? { startTime: start, processGroupId: Number(pgid) }
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function linuxStat(pid) {
+    if (!Number.isSafeInteger(pid) || pid <= 0)
+        return undefined;
+    let value;
+    try {
+        value = await readFile(`/proc/${pid}/stat`, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+    const close = value.lastIndexOf(")");
+    if (close < 0)
+        return undefined;
+    const fields = value.slice(close + 2).trim().split(/\s+/);
+    const processGroupId = Number(fields[2]); // rest[0] is field 3; pgrp is field 5.
+    const startTime = fields[19]; // starttime is field 22.
+    if (!startTime || !Number.isSafeInteger(processGroupId) || processGroupId <= 0)
+        return undefined;
+    return { startTime, processGroupId };
+}
+export async function procStartTime(pid) {
+    if (!Number.isSafeInteger(pid) || pid <= 0)
+        return undefined;
+    if (process.platform === "linux")
+        return (await linuxStat(pid))?.startTime;
+    if (process.platform === "darwin") {
+        // Fail closed like the Python reference: `ps -o lstart` has only second
+        // precision, too coarse to gate a killpg — no fallback when libproc is
+        // unreachable; the run is then treated as dead and never signalled.
+        return (await darwinStat(pid))?.startTime;
+    }
+    try {
+        const { stdout } = await execFileAsync("ps", ["-o", "lstart=", "-p", String(pid)], { timeout: 5_000 });
+        return stdout.trim() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function processGroupId(pid) {
+    if (!Number.isSafeInteger(pid) || pid <= 0)
+        return undefined;
+    if (process.platform === "linux")
+        return (await linuxStat(pid))?.processGroupId;
+    if (process.platform === "darwin")
+        return (await darwinStat(pid))?.processGroupId;
+    try {
+        const { stdout } = await execFileAsync("ps", ["-o", "pgid=", "-p", String(pid)], { timeout: 5_000 });
+        const value = Number(stdout.trim());
+        return Number.isSafeInteger(value) && value > 0 ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function processIdentityMatches(pid, expectedStartTime) {
+    if (!expectedStartTime)
+        return false;
+    return (await procStartTime(pid)) === expectedStartTime;
+}
+//# sourceMappingURL=proc_identity.js.map

package/dist/connectors/proc_identity.js.map

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

package/dist/connectors/runner.js

@@ -0,0 +1,63 @@
+import { startBackgroundRun } from "./background.js";
+import { ClaudeConnector } from "./claude.js";
+import { CodexConnector } from "./codex.js";
+// Module-level discriminant sets — created once, not per-call (intentionally isolated
+// from the identical sets in background.ts to avoid a cross-module import dependency).
+const VALID_AGENTS = new Set(["claude", "codex"]);
+const VALID_SANDBOX_MODES = new Set(["read-only", "workspace-write"]);
+export async function runAgent(options, boundaries = {}) {
+    // 4c: discriminant validation — reject unknown agent and sandboxMode values before
+    // either the background or foreground dispatch branch. Mirrors background.ts guards
+    // (D11) but is intentionally independent (no cross-module import).
+    if (!VALID_AGENTS.has(options.agent)) {
+        throw new Error(`Unknown agent ${JSON.stringify(options.agent)}; must be "claude" or "codex"`);
+    }
+    if (options.sandboxMode !== undefined && !VALID_SANDBOX_MODES.has(options.sandboxMode)) {
+        throw new Error(`Unknown sandboxMode ${JSON.stringify(options.sandboxMode)}; must be "read-only" or "workspace-write"`);
+    }
+    // D8 applies to the FOREGROUND claude path too: ClaudeConnector hardcodes
+    // permissionMode "acceptEdits" and cannot enforce read-only, so accepting the
+    // request would be a false guarantee. (The background path rejects in
+    // startClaudeBackgroundRun; codex enforces read-only natively.)
+    if (options.agent === "claude" && options.sandboxMode === "read-only") {
+        throw new Error('claude runs with sandboxMode="read-only" are not supported: the Claude connector ' +
+            'cannot enforce read-only (D8). Omit sandboxMode or pass "workspace-write".');
+    }
+    const cwd = options.cwd ?? process.cwd();
+    if (options.background) {
+        return startBackgroundRun({
+            agent: options.agent,
+            prompt: options.prompt,
+            cwd,
+            ...(options.model !== undefined ? { model: options.model } : {}),
+            ...(options.sandboxMode !== undefined ? { sandboxMode: options.sandboxMode } : {}),
+            ...(options.budgeted !== undefined ? { budgeted: options.budgeted } : {}),
+            ...(options.registryRoot !== undefined ? { registryRoot: options.registryRoot } : {}),
+            ...(options.env !== undefined ? { env: options.env } : {}),
+            ...(boundaries.backgroundCommand !== undefined ? { command: boundaries.backgroundCommand } : {}),
+            // 4b: carry tool filters through to background runs (D5 / BG-WRITE-A)
+            ...(options.allowedTools !== undefined ? { allowedTools: options.allowedTools } : {}),
+            ...(options.disallowedTools !== undefined ? { disallowedTools: options.disallowedTools } : {}),
+        });
+    }
+    if (options.agent === "codex") {
+        return new CodexConnector({
+            cwd,
+            ...(options.model !== undefined ? { model: options.model } : {}),
+            ...(options.sandboxMode !== undefined ? { sandboxMode: options.sandboxMode } : {}),
+            ...(options.env !== undefined ? { env: options.env } : {}),
+            ...(boundaries.codexSpawn !== undefined ? { spawn: boundaries.codexSpawn } : {}),
+            ...(options.onEvent !== undefined ? { onEvent: options.onEvent } : {}),
+        }).run(options.prompt);
+    }
+    return new ClaudeConnector({
+        cwd,
+        ...(options.model !== undefined ? { model: options.model } : {}),
+        ...(options.allowedTools !== undefined ? { allowedTools: options.allowedTools } : {}),
+        ...(options.disallowedTools !== undefined ? { disallowedTools: options.disallowedTools } : {}),
+        ...(options.env !== undefined ? { env: options.env } : {}),
+        ...(boundaries.claudeQuery !== undefined ? { query: boundaries.claudeQuery } : {}),
+        ...(options.onEvent !== undefined ? { onEvent: options.onEvent } : {}),
+    }).run(options.prompt);
+}
+//# sourceMappingURL=runner.js.map

package/dist/connectors/runner.js.map

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

package/dist/contracts/events.json

@@ -0,0 +1,65 @@
+{
+  "events": 1,
+  "shapeLanguage": "Each kind maps to the full event payload shape minus the implicit {at: string, type: string}. Leaf types: number|string|boolean|object|array|null|any, unions with '|', optional keys end in '?', nested objects are declared inline. Undeclared keys are contract violations.",
+  "kinds": {
+    "planned": {},
+    "ready": { "stepId": "string", "detail": { "attempt": "number" } },
+    "result": {
+      "stepId": "string",
+      "detail": {
+        "attempt": "number",
+        "result?": "any",
+        "failure?": { "attempt": "number", "reason": "string" },
+        "iterate?": { "iteration": "number", "max": "number" }
+      }
+    },
+    "judged": {
+      "stepId": "string",
+      "detail": {
+        "statement": "string",
+        "holds": "boolean",
+        "reason": "string",
+        "stakes": "string",
+        "model": "string",
+        "usage": { "tokens": "number", "usd": "number" },
+        "itemIndex?": "number",
+        "stage?": "number"
+      }
+    },
+    "routed": {
+      "stepId": "string",
+      "detail": { "target": "string", "failure": { "attempt": "number", "reason": "string" } }
+    },
+    "skipped": { "stepId": "string", "detail?": { "reason?": "string" } },
+    "resumed": {},
+    "completed": { "detail": { "output": "any" } },
+    "failed": { "detail": { "attempt": "number", "reason": "string" } },
+    "budget_exhausted": { "detail": { "attempt": "number", "reason": "string" } },
+    "gate_waiting": { "stepId": "string" },
+    "gate_resolved": { "stepId": "string", "detail": { "decision": "string", "target": "string|null" } },
+    "fanout_item_ready": { "stepId": "string", "detail": { "itemIndex": "number" } },
+    "fanout_item_dispatched": {
+      "stepId": "string",
+      "detail": { "itemIndex": "number", "stage": "number", "attempt": "number" }
+    },
+    "fanout_attempt_result": {
+      "stepId": "string",
+      "detail": {
+        "itemIndex": "number",
+        "stage": "number",
+        "attempt": "number",
+        "success": "boolean",
+        "failure?": { "kind": "string", "reason": "string" }
+      }
+    },
+    "fanout_item_skipped": { "stepId": "string", "detail": { "itemIndex": "number", "stage": "number" } },
+    "fanout_ledger_debit": {
+      "stepId": "string",
+      "detail": { "itemIndex": "number", "amount": "object", "source?": "string" }
+    },
+    "fanout_merge": {
+      "stepId": "string",
+      "detail": { "itemIndex": "number", "success": "boolean", "reason?": "string" }
+    }
+  }
+}

package/dist/contracts/mcp-surface.json

@@ -0,0 +1,215 @@
+{
+  "surface": 9,
+  "shapeLanguage": "Same shape language as events.json. Each tool declares its request shape and one response shape per status variant; a response's status field is implicit. Undeclared keys are contract violations.",
+  "errors": {
+    "consumer_dispatch_bg_unsupported": {
+      "data": {
+        "code": "string",
+        "errors": {
+          "$array": {
+            "code": "string",
+            "path": "string",
+            "message": "string"
+          }
+        }
+      }
+    }
+  },
+  "tools": {
+    "stratum_validate": {
+      "request": { "spec": "any" },
+      "responses": {
+        "valid": {},
+        "invalid": { "errors": "array" }
+      }
+    },
+    "stratum_compile_speckit": {
+      "request": { "tasks_dir": "string", "flow_name?": "string" },
+      "responses": {
+        "ok": { "yaml": "string", "flow_name": "string", "steps": "array" },
+        "error": { "error_type": "string", "message": "string" }
+      }
+    },
+    "stratum_plan": {
+      "request": { "spec": "any", "input": "any", "workspaceRoot?": "string" },
+      "responses": {
+        "ready": { "runId": "string", "ready": { "$array": { "$oneOf": [
+          { "id": "string", "do": "string", "agent": "string", "attempt": "number", "epoch": "number", "dispatchToken": "string", "previousFailure?": { "attempt": "number", "reason": "string" } },
+          { "id": "string", "do": "string", "agent": "string", "attempt": "number", "epoch": "number", "dispatchToken": "string", "previousFailure?": { "attempt": "number", "reason": "string" }, "flow": "string", "step": "string", "stage": "number", "isFinalStage": "boolean", "itemIndex": "number", "generation": "number", "contract": { "$oneOf": [{ "root": "string", "contracts": "object" }, "null"] }, "contractDigest": "string|null", "policy": { "isolation": "string", "merge": "string", "pre_merge": { "$array": "string" } }, "revisionDigest": "string" }
+        ] } }, "ledger": { "spent": "object", "budget?": "object" }, "revisionDigest": "string" },
+        "running": { "runId": "string", "ledger": { "spent": "object", "budget?": "object" }, "revisionDigest": "string" },
+        "completed": { "runId": "string", "output": "any", "ledger": { "spent": "object", "budget?": "object" }, "revisionDigest": "string" },
+        "failed": { "runId": "string", "failure": { "attempt": "number", "reason": "string" }, "ledger": { "spent": "object", "budget?": "object" }, "revisionDigest": "string" },
+        "budget_exhausted": { "runId": "string", "failure": { "attempt": "number", "reason": "string" }, "ledger": { "spent": "object", "budget?": "object" }, "revisionDigest": "string" }
+      }
+    },
+    "stratum_step_done": {
+      "request": { "runId": "string", "stepId": "string", "result": { "output?": "any", "failure?": "string", "usage?": "object", "telemetry?": { "durationMs": "number", "model": "string", "effort?": "string" } }, "dispatchToken": "string" },
+      "responses": {
+        "ready": { "runId": "string", "ready": { "$array": { "$oneOf": [
+          { "id": "string", "do": "string", "agent": "string", "attempt": "number", "epoch": "number", "dispatchToken": "string", "previousFailure?": { "attempt": "number", "reason": "string" } },
+          { "id": "string", "do": "string", "agent": "string", "attempt": "number", "epoch": "number", "dispatchToken": "string", "previousFailure?": { "attempt": "number", "reason": "string" }, "flow": "string", "step": "string", "stage": "number", "isFinalStage": "boolean", "itemIndex": "number", "generation": "number", "contract": { "$oneOf": [{ "root": "string", "contracts": "object" }, "null"] }, "contractDigest": "string|null", "policy": { "isolation": "string", "merge": "string", "pre_merge": { "$array": "string" } }, "revisionDigest": "string" }
+        ] } }, "ledger": { "spent": "object", "budget?": "object" } },
+        "running": { "runId": "string", "ledger": { "spent": "object", "budget?": "object" } },
+        "completed": { "runId": "string", "output": "any", "ledger": { "spent": "object", "budget?": "object" } },
+        "failed": { "runId": "string", "failure": { "attempt": "number", "reason": "string" }, "ledger": { "spent": "object", "budget?": "object" } },
+        "budget_exhausted": { "runId": "string", "failure": { "attempt": "number", "reason": "string" }, "ledger": { "spent": "object", "budget?": "object" } }
+      }
+    },
+    "stratum_commit": {
+      "description": "Save a named checkpoint of the current flow state; state-only; no files are touched; the caller owns file-level undo.",
+      "request": { "flow_id": "string", "label": "string" },
+      "responses": {
+        "committed": { "flow_id": "string", "label": "string", "step_number": "number", "current_step_id": "string|null", "checkpoints": "array" },
+        "error": { "error_type": "string", "message": "string", "available?": "array" }
+      }
+    },
+    "stratum_revert": {
+      "description": "Roll back flow state to a named checkpoint; state-only; no files are touched; the caller owns file-level undo.",
+      "request": { "flow_id": "string", "label": "string" },
+      "responses": {
+        "ready": { "runId": "string", "ready": { "$array": { "$oneOf": [
+          { "id": "string", "do": "string", "agent": "string", "attempt": "number", "epoch": "number", "dispatchToken": "string", "previousFailure?": { "attempt": "number", "reason": "string" } },
+          { "id": "string", "do": "string", "agent": "string", "attempt": "number", "epoch": "number", "dispatchToken": "string", "previousFailure?": { "attempt": "number", "reason": "string" }, "flow": "string", "step": "string", "stage": "number", "isFinalStage": "boolean", "itemIndex": "number", "generation": "number", "contract": { "$oneOf": [{ "root": "string", "contracts": "object" }, "null"] }, "contractDigest": "string|null", "policy": { "isolation": "string", "merge": "string", "pre_merge": { "$array": "string" } }, "revisionDigest": "string" }
+        ] } }, "ledger": { "spent": "object", "budget?": "object" }, "reverted_to": "string" },
+        "running": { "runId": "string", "ledger": { "spent": "object", "budget?": "object" }, "reverted_to": "string" },
+        "completed": { "runId": "string", "output": "any", "ledger": { "spent": "object", "budget?": "object" }, "reverted_to": "string" },
+        "failed": { "runId": "string", "failure": { "attempt": "number", "reason": "string" }, "ledger": { "spent": "object", "budget?": "object" }, "reverted_to": "string" },
+        "budget_exhausted": { "runId": "string", "failure": { "attempt": "number", "reason": "string" }, "ledger": { "spent": "object", "budget?": "object" }, "reverted_to": "string" },
+        "error": { "error_type": "string", "message": "string", "available?": "array" }
+      }
+    },
+    "stratum_resume": {
+      "request": { "runId": "string" },
+      "responses": {
+        "ready": { "runId": "string", "ready": { "$array": { "$oneOf": [
+          { "id": "string", "do": "string", "agent": "string", "attempt": "number", "epoch": "number", "dispatchToken": "string", "previousFailure?": { "attempt": "number", "reason": "string" } },
+          { "id": "string", "do": "string", "agent": "string", "attempt": "number", "epoch": "number", "dispatchToken": "string", "previousFailure?": { "attempt": "number", "reason": "string" }, "flow": "string", "step": "string", "stage": "number", "isFinalStage": "boolean", "itemIndex": "number", "generation": "number", "contract": { "$oneOf": [{ "root": "string", "contracts": "object" }, "null"] }, "contractDigest": "string|null", "policy": { "isolation": "string", "merge": "string", "pre_merge": { "$array": "string" } }, "revisionDigest": "string" }
+        ] } }, "ledger": { "spent": "object", "budget?": "object" }, "revisionDigest": "string" },
+        "running": { "runId": "string", "ledger": { "spent": "object", "budget?": "object" }, "revisionDigest": "string" },
+        "completed": { "runId": "string", "output": "any", "ledger": { "spent": "object", "budget?": "object" }, "revisionDigest": "string" },
+        "failed": { "runId": "string", "failure": { "attempt": "number", "reason": "string" }, "ledger": { "spent": "object", "budget?": "object" }, "revisionDigest": "string" },
+        "budget_exhausted": { "runId": "string", "failure": { "attempt": "number", "reason": "string" }, "ledger": { "spent": "object", "budget?": "object" }, "revisionDigest": "string" }
+      }
+    },
+    "stratum_audit": {
+      "request": { "runId": "string" },
+      "responses": {
+        "running": { "runId": "string", "events": "array", "steps": "object", "flowSpent": "object", "output?": "any" },
+        "completed": { "runId": "string", "events": "array", "steps": "object", "flowSpent": "object", "output?": "any" },
+        "failed": { "runId": "string", "events": "array", "steps": "object", "flowSpent": "object", "output?": "any" },
+        "budget_exhausted": { "runId": "string", "events": "array", "steps": "object", "flowSpent": "object", "output?": "any" }
+      }
+    },
+    "stratum_gate_resolve": {
+      "request": { "runId": "string", "stepId": "string", "decision": "string", "gateToken": "string" },
+      "responses": {
+        "ready": { "runId": "string", "ready": { "$array": { "$oneOf": [
+          { "id": "string", "do": "string", "agent": "string", "attempt": "number", "epoch": "number", "dispatchToken": "string", "previousFailure?": { "attempt": "number", "reason": "string" } },
+          { "id": "string", "do": "string", "agent": "string", "attempt": "number", "epoch": "number", "dispatchToken": "string", "previousFailure?": { "attempt": "number", "reason": "string" }, "flow": "string", "step": "string", "stage": "number", "isFinalStage": "boolean", "itemIndex": "number", "generation": "number", "contract": { "$oneOf": [{ "root": "string", "contracts": "object" }, "null"] }, "contractDigest": "string|null", "policy": { "isolation": "string", "merge": "string", "pre_merge": { "$array": "string" } }, "revisionDigest": "string" }
+        ] } }, "ledger": { "spent": "object", "budget?": "object" } },
+        "running": { "runId": "string", "ledger": { "spent": "object", "budget?": "object" } },
+        "completed": { "runId": "string", "output": "any", "ledger": { "spent": "object", "budget?": "object" } },
+        "failed": { "runId": "string", "failure": { "attempt": "number", "reason": "string" }, "ledger": { "spent": "object", "budget?": "object" } },
+        "budget_exhausted": { "runId": "string", "failure": { "attempt": "number", "reason": "string" }, "ledger": { "spent": "object", "budget?": "object" } }
+      }
+    },
+    "stratum_flow_poll": {
+      "request": { "runId": "string", "cursor?": "number" },
+      "responses": {
+        "running": { "runId": "string", "events": "array", "nextCursor": "number", "ledger": { "spent": "object", "budget?": "object" }, "output?": "any", "failure?": "object" },
+        "completed": { "runId": "string", "events": "array", "nextCursor": "number", "ledger": { "spent": "object", "budget?": "object" }, "output?": "any", "failure?": "object" },
+        "failed": { "runId": "string", "events": "array", "nextCursor": "number", "ledger": { "spent": "object", "budget?": "object" }, "output?": "any", "failure?": "object" },
+        "budget_exhausted": { "runId": "string", "events": "array", "nextCursor": "number", "ledger": { "spent": "object", "budget?": "object" }, "output?": "any", "failure?": "object" }
+      }
+    },
+    "stratum_flow_run_bg": {
+      "request": { "spec": "any", "input": "any", "workspaceRoot?": "string" },
+      "responses": {
+        "running": { "runId": "string" }
+      }
+    },
+    "stratum_flow_bg_poll": {
+      "request": { "runId": "string", "cursor?": "number" },
+      "responses": {
+        "running": { "runId": "string", "events": "array", "nextCursor": "number", "ledger": { "spent": "object", "budget?": "object" }, "output?": "any", "failure?": "object", "bg": { "status": "string", "cancelRequested": "boolean", "pendingGates": "array", "gateStepId?": "string" } },
+        "completed": { "runId": "string", "events": "array", "nextCursor": "number", "ledger": { "spent": "object", "budget?": "object" }, "output?": "any", "failure?": "object", "bg": { "status": "string", "cancelRequested": "boolean", "pendingGates": "array", "gateStepId?": "string" } },
+        "failed": { "runId": "string", "events": "array", "nextCursor": "number", "ledger": { "spent": "object", "budget?": "object" }, "output?": "any", "failure?": "object", "bg": { "status": "string", "cancelRequested": "boolean", "pendingGates": "array", "gateStepId?": "string" } },
+        "budget_exhausted": { "runId": "string", "events": "array", "nextCursor": "number", "ledger": { "spent": "object", "budget?": "object" }, "output?": "any", "failure?": "object", "bg": { "status": "string", "cancelRequested": "boolean", "pendingGates": "array", "gateStepId?": "string" } }
+      }
+    },
+    "stratum_flow_cancel_bg": {
+      "request": { "runId": "string" },
+      "responses": {
+        "running": {},
+        "completed": {},
+        "failed": {},
+        "budget_exhausted": {},
+        "cancelled": {}
+      }
+    },
+    "stratum_agent_run": {
+      "request": { "agent": "string", "prompt": "string", "cwd": "string", "model?": "string", "sandboxMode?": "string", "background?": "boolean", "allowedTools?": { "$array": "string" }, "disallowedTools?": { "$array": "string" } },
+      "responses": {
+        "complete": { "text": "string", "usage": "object", "telemetry": { "durationMs": "number", "model": "string", "effort?": "string" } },
+        "bg_started": { "runId": "string", "pid?": "number", "streamPath": "string" }
+      }
+    },
+    "stratum_agent_poll": {
+      "request": { "runId": "string" },
+      "responses": {
+        "not_found": { "runId": "string" },
+        "running": { "runId": "string", "textTail": "string", "eventsSeen": "number", "streamPath": "string" },
+        "complete": { "runId": "string", "text": "string", "usage": "object", "exitCode": "number", "telemetry": { "durationMs": "number", "model": "string", "effort?": "string" } },
+        "error": { "runId": "string", "textTail": "string", "stderrTail": "string", "reason?": "string", "exitCode?": "number", "eventsSeen?": "number", "streamPath?": "string", "telemetry?": { "durationMs": "number", "model": "string", "effort?": "string" } }
+      }
+    },
+    "stratum_cancel_agent_run": {
+      "request": { "runId": "string" },
+      "responses": {
+        "cancelled": { "runId": "string" },
+        "already_complete": { "runId": "string" },
+        "already_error": { "runId": "string" },
+        "not_found": { "runId": "string" }
+      }
+    },
+    "stratum_guard_register": {
+      "request": { "resource_id": "string", "graph": "object", "edge_predicates": "object", "initial": "string", "terminal?": "array|null", "stakes?": "object|null", "workspace_root?": "string|null" },
+      "responses": {
+        "registered": { "guard_id": "string", "checksum": "string" },
+        "exists": { "guard_id": "string", "checksum": "string" },
+        "error": { "error_type": "string", "message": "string" }
+      }
+    },
+    "stratum_guard_transition": {
+      "request": { "resource_id": "string", "from_state": "string", "to_state": "string", "artifacts": "object", "modified_files?": "array|null", "idempotency_key?": "string|null", "resolved_by?": "string" },
+      "responses": {
+        "applied": { "verdict": "object", "ledger_ref": "string", "current_state": "string" },
+        "refused": { "verdict": "object", "ledger_ref": "string", "current_state": "string" },
+        "replayed": { "verdict": "object", "ledger_ref": "string", "current_state": "string" },
+        "error": { "error_type": "string", "message": "string" }
+      }
+    },
+    "stratum_guard_override": {
+      "request": { "resource_id": "string", "from_state": "string", "to_state": "string", "override_token": "string", "rationale": "string", "resolved_by?": "string" },
+      "responses": {
+        "deviation": { "ledger_ref": "string", "current_state": "string", "rationale": "string" },
+        "error": { "error_type": "string", "message": "string" }
+      }
+    },
+    "stratum_guard_migrate": {
+      "request": { "resource_id": "string", "new_graph": "object", "new_edge_predicates": "object", "override_token": "string", "rationale": "string", "new_terminal?": "array|null", "new_stakes?": "object|null" },
+      "responses": {
+        "migrated": { "checksum": "string", "graph_version": "number", "ledger_ref": "string", "rationale": "string" },
+        "error": { "error_type": "string", "message": "string" }
+      }
+    },
+    "stratum_guard_history": {
+      "request": { "resource_id": "string" },
+      "responses": {
+        "success": { "resource_id": "string", "current_state": "string", "graph_version": "number", "ledger": "array" },
+        "error": { "error_type": "string", "message": "string" }
+      }
+    }
+  }
+}

package/dist/engine/checkpoint.js

@@ -0,0 +1,50 @@
+/**
+ * Python FlowState -> TS PersistedRun checkpoint mapping:
+ * step_outputs / attempts / iteration state -> steps
+ * records / child_audits / judge history -> events
+ * round / rounds -> rounds
+ * terminal_status -> status / output / failure
+ * budget state -> flowSpent
+ * detached/fanout mutable state -> cancelRequested / parallel
+ */
+export const CHECKPOINT_FIELDS = [
+    "status", "output", "failure", "flowSpent", "rounds", "steps", "events", "cancelRequested", "parallel",
+];
+/** Immutable identity/config fields plus the deliberately non-recursive checkpoint map. */
+export const CHECKPOINT_EXCLUDED = {
+    id: "immutable run identity",
+    spec: "immutable validated specification",
+    revisionDigest: "immutable digest of the validated effective specification",
+    generationCounter: "monotonic issuance identity that must never roll back",
+    input: "immutable flow input",
+    flowName: "immutable flow selection",
+    workspaceRoot: "immutable execution configuration",
+    bgDriven: "ownership metadata set by background-run setup, not flow advancement",
+    checkpoints: "checkpoint maps are not nested inside snapshots",
+};
+export function commitCheckpoint(run, label) {
+    const snapshot = Object.fromEntries(CHECKPOINT_FIELDS.flatMap((field) => Object.hasOwn(run, field) ? [[field, structuredClone(run[field])]] : []));
+    run.checkpoints ??= [];
+    const existing = run.checkpoints.find((entry) => entry.label === label);
+    // Overwrite-same-label keeps the label's original position (parity with a dict
+    // reassignment); a new label appends.
+    if (existing)
+        existing.snapshot = snapshot;
+    else
+        run.checkpoints.push({ label, snapshot });
+}
+export function revertCheckpoint(run, label) {
+    const entry = run.checkpoints?.find((candidate) => candidate.label === label);
+    if (entry === undefined)
+        return false;
+    const restored = structuredClone(entry.snapshot);
+    const mutableRun = run;
+    for (const field of CHECKPOINT_FIELDS) {
+        if (Object.hasOwn(restored, field))
+            mutableRun[field] = restored[field];
+        else
+            delete mutableRun[field];
+    }
+    return true;
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/engine/checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.js","sourceRoot":"","sources":["../../src/engine/checkpoint.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,UAAU;CACpD,CAAC;AAIrD,2FAA2F;AAC3F,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,EAAE,EAAE,wBAAwB;IAC5B,IAAI,EAAE,mCAAmC;IACzC,cAAc,EAAE,2DAA2D;IAC3E,iBAAiB,EAAE,uDAAuD;IAC1E,KAAK,EAAE,sBAAsB;IAC7B,QAAQ,EAAE,0BAA0B;IACpC,aAAa,EAAE,mCAAmC;IAClD,QAAQ,EAAE,sEAAsE;IAChF,WAAW,EAAE,iDAAiD;CACiB,CAAC;AAElF,MAAM,UAAU,gBAAgB,CAAC,GAAiB,EAAE,KAAa;IAC/D,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CACtE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAuB,CAAC;IAClG,GAAG,CAAC,WAAW,KAAK,EAAE,CAAC;IACvB,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IACxE,+EAA+E;IAC/E,sCAAsC;IACtC,IAAI,QAAQ;QAAE,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;;QACtC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAiB,EAAE,KAAa;IAC/D,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IAC9E,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAqC,CAAC;IACrF,MAAM,UAAU,GAAG,GAAkD,CAAC;IACtE,KAAK,MAAM,KAAK,IAAI,iBAAiB,EAAE,CAAC;QACtC,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC;YAAE,UAAU,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;;YACnE,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}