@osolmaz/pi-workflows 0.2.0 → 0.4.0

package/dist/host/runner.js

@@ -0,0 +1,379 @@
+import { randomUUID } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { builtinWorkflowCatalog } from "../builtins/catalog.js";
+import { ControllerManager, loadDiscoveredControllers, projectControllerStorePath, SqliteControllerStore, WorkflowEngineScheduler, } from "../controllers/index.js";
+import { WorkflowEngine } from "../workflows/engine.js";
+import { ClaimLostError, errorMessage, isClaimLostError, WorkflowSourceChangedError, } from "../workflows/errors.js";
+import { resolveWorkflowRef, resolveWorkflowSource } from "../workflows/loader.js";
+import { migrateLegacyWorkflowSources } from "../workflows/migrate-sources.js";
+import { WorkflowRunStore, readRunBundle } from "../workflows/store.js";
+import { HostProcessRegistry } from "./processes.js";
+import { RpcStepExecutor } from "./rpc-executor.js";
+const CLAIM_POLL_MS = 2_000;
+const RUN_CLAIM_LEASE_MS = 30_000;
+const RUN_CLAIM_RENEW_MS = 10_000;
+/**
+ * The always-on runner: claims parked workflow runs and reconciles durable
+ * controllers without a Pi session. Conversation nodes execute in headless
+ * `pi --mode rpc` children. Everything the host does is recoverable: claims
+ * expire, bundles fence stale writers, and child processes are reaped by
+ * the next host.
+ */
+export class WorkflowHost {
+    options;
+    runnerId;
+    registry;
+    store;
+    childRunStore;
+    manager = null;
+    pollTimer = null;
+    activeRuns = new Map();
+    migrationBlockedRuns = new Set();
+    schedulerExecutors = new Map();
+    /** Runs whose resume refused (edited source); skipped until a host restart. */
+    skippedRuns = new Set();
+    stopping = false;
+    stateDir;
+    constructor(options) {
+        this.options = options;
+        this.runnerId = options.runnerId ?? `host-${randomUUID().slice(0, 8)}`;
+        this.store = new SqliteControllerStore(options.storeFile ?? projectControllerStorePath(options.cwd));
+        this.stateDir = path.dirname(this.store.filePath);
+        this.registry = options.registry ?? new HostProcessRegistry(this.stateDir);
+        this.childRunStore = new WorkflowRunStore(options.runsDir ?? process.env.PI_WORKFLOWS_RUNS_DIR ?? undefined);
+    }
+    log(message) {
+        this.options.onLog?.(message);
+    }
+    /** Take the advisory lock, reap orphans, and start claiming. */
+    async start() {
+        // The lock comes first: a second host must refuse before touching the
+        // children registry, or it would kill the live host's child processes
+        // as supposed orphans.
+        acquireHostLock(this.stateDir, this.runnerId, this.options.cwd);
+        const reaped = this.registry.reapOrphans();
+        if (reaped.length > 0) {
+            this.log(`reaped ${reaped.length} orphaned headless session(s): ${reaped.join(", ")}`);
+        }
+        const migration = await migrateLegacyWorkflowSources({
+            catalog: builtinWorkflowCatalog,
+            store: this.childRunStore,
+            queue: this.store,
+        });
+        for (const blocked of migration.blocked) {
+            this.migrationBlockedRuns.add(blocked.runId);
+            this.log(`run ${blocked.runId} parked: ${blocked.reason}`);
+        }
+        const definitions = await loadDiscoveredControllers({ cwd: this.options.cwd });
+        if (definitions.length > 0) {
+            const scheduler = new WorkflowEngineScheduler({
+                store: this.childRunStore,
+                resolveWorkflow: async (name) => {
+                    const resolved = await resolveWorkflowRef(name, { cwd: this.options.cwd }, builtinWorkflowCatalog);
+                    return { workflow: resolved.definition, workflowSource: resolved.source };
+                },
+                createEngine: () => {
+                    const executor = new RpcStepExecutor({
+                        cwd: this.options.cwd,
+                        registry: this.registry,
+                        ...(this.options.piArgs !== undefined ? { piArgs: this.options.piArgs } : {}),
+                        ...(this.options.env !== undefined ? { env: this.options.env } : {}),
+                    });
+                    const engine = new WorkflowEngine({ executor, store: this.childRunStore });
+                    this.schedulerExecutors.set(engine, executor);
+                    return engine;
+                },
+                disposeEngine: async (engine) => {
+                    const executor = this.schedulerExecutors.get(engine);
+                    if (executor !== undefined) {
+                        this.schedulerExecutors.delete(engine);
+                        await executor.close();
+                    }
+                },
+            });
+            this.manager = new ControllerManager({
+                store: this.store,
+                controllers: definitions,
+                workflowScheduler: scheduler,
+            });
+            this.manager.start();
+            this.log(`controller workers started for ${definitions.length} controller(s)`);
+        }
+        this.pollTimer = setInterval(() => {
+            this.claimOnce();
+        }, this.options.claimPollMs ?? CLAIM_POLL_MS);
+        this.pollTimer.unref?.();
+        this.claimOnce();
+        this.log(`host ${this.runnerId} watching ${this.options.cwd}`);
+    }
+    /** Drain: stop claiming, park in-flight runs, stop controllers, kill children. */
+    async stop() {
+        if (this.stopping) {
+            return;
+        }
+        this.stopping = true;
+        if (this.pollTimer !== null) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = null;
+        }
+        const pending = [...this.activeRuns.values()];
+        for (const run of this.parkedEngines.splice(0)) {
+            run();
+        }
+        await Promise.allSettled(pending);
+        await this.manager?.stop().catch(() => undefined);
+        for (const executor of this.schedulerExecutors.values()) {
+            await executor.close().catch(() => undefined);
+        }
+        this.schedulerExecutors.clear();
+        this.registry.killAll();
+        releaseHostLock(this.stateDir, this.runnerId);
+        this.store.close();
+    }
+    parkedEngines = [];
+    claimOnce() {
+        if (this.stopping || this.activeRuns.size > 0) {
+            return;
+        }
+        let claimed;
+        try {
+            claimed = this.store.claimNextWorkflowRun({
+                runnerId: this.runnerId,
+                claimToken: randomUUID(),
+                leaseMs: RUN_CLAIM_LEASE_MS,
+                excludeRunIds: [...this.skippedRuns, ...this.migrationBlockedRuns],
+            });
+        }
+        catch (error) {
+            // Store contention or corruption must not kill the host's loop.
+            this.log(`claim failed, retrying shortly: ${errorMessage(error)}`);
+            return;
+        }
+        if (claimed === undefined) {
+            return;
+        }
+        const task = this.runClaimed(claimed).finally(() => {
+            this.activeRuns.delete(claimed.runId);
+        });
+        this.activeRuns.set(claimed.runId, task);
+    }
+    async runClaimed(record) {
+        const claimToken = record.claimToken;
+        const runId = record.runId;
+        this.log(`resuming ${record.workflowName} run ${runId}`);
+        let workflow;
+        let workflowSource;
+        try {
+            const bundle = await readRunBundle(this.childRunStore.runDirFor(runId));
+            if (bundle?.state.workflowSource === undefined) {
+                throw new Error(`Workflow run ${runId} has no canonical workflow source`);
+            }
+            workflow = await resolveWorkflowSource(bundle.state.workflowSource, builtinWorkflowCatalog, runId);
+            workflowSource = bundle.state.workflowSource;
+        }
+        catch (error) {
+            if (error instanceof WorkflowSourceChangedError) {
+                try {
+                    this.store.parkWorkflowRun({ runId, claimToken });
+                }
+                catch {
+                    // Best-effort.
+                }
+                this.skippedRuns.add(runId);
+                this.recordEvent(runId, record.workflowName, "parked", {
+                    reason: "workflow source changed",
+                });
+                this.log(`run ${runId} skipped: workflow source changed; install the matching package revision, then restart the host`);
+                return;
+            }
+            await this.failUnresumable(record, claimToken, errorMessage(error));
+            return;
+        }
+        if (this.stopping) {
+            // The drain started during setup: park before anything executes.
+            try {
+                this.store.parkWorkflowRun({ runId, claimToken });
+            }
+            catch {
+                // Best-effort.
+            }
+            return;
+        }
+        const store = this.store;
+        const fence = () => {
+            if (!store.verifyWorkflowRunClaim({ runId, claimToken })) {
+                throw new ClaimLostError(runId);
+            }
+        };
+        const fencedStore = new WorkflowRunStore(this.childRunStore.outputRoot, {
+            fenceProvider: () => fence,
+        });
+        const executor = new RpcStepExecutor({
+            cwd: this.options.cwd,
+            registry: this.registry,
+            ...(this.options.piArgs !== undefined ? { piArgs: this.options.piArgs } : {}),
+            ...(this.options.env !== undefined ? { env: this.options.env } : {}),
+        });
+        const engine = new WorkflowEngine({ executor, store: fencedStore });
+        const parkEngine = () => engine.park();
+        this.parkedEngines.push(parkEngine);
+        const renewTimer = setInterval(() => {
+            try {
+                if (!store.renewWorkflowRunClaim({ runId, claimToken, leaseMs: RUN_CLAIM_LEASE_MS })) {
+                    engine.cancel();
+                }
+            }
+            catch {
+                // Transient store errors leave fencing to decide ownership.
+            }
+        }, RUN_CLAIM_RENEW_MS);
+        renewTimer.unref?.();
+        this.recordEvent(runId, record.workflowName, "resumed", { runnerId: this.runnerId });
+        try {
+            const result = await engine.resumeRun(workflow, runId, { workflowSource });
+            clearInterval(renewTimer);
+            if (result.state.status === "running") {
+                // Parked again mid-drain: leave it claimable for the next runner.
+                this.store.parkWorkflowRun({ runId, claimToken });
+                this.recordEvent(runId, record.workflowName, "parked", {});
+                this.log(`parked ${record.workflowName} run ${runId}`);
+                return;
+            }
+            this.store.completeWorkflowRun({ runId, claimToken });
+            this.recordEvent(runId, record.workflowName, result.state.status, {
+                ...(result.state.error !== undefined ? { error: result.state.error } : {}),
+                ...(result.state.waitingOn !== undefined ? { waitingOn: result.state.waitingOn } : {}),
+            });
+            this.log(`${record.workflowName} run ${runId} ${result.state.status}`);
+        }
+        catch (error) {
+            clearInterval(renewTimer);
+            if (isClaimLostError(error)) {
+                this.log(`run ${runId} continues under another runner`);
+                return;
+            }
+            if (error instanceof WorkflowSourceChangedError) {
+                // Edited source is a refusal, not a failure: keep the run claimable
+                // for a later fix, and stop spinning on it for this host's lifetime.
+                try {
+                    this.store.parkWorkflowRun({ runId, claimToken });
+                }
+                catch {
+                    // Best-effort.
+                }
+                this.skippedRuns.add(runId);
+                this.recordEvent(runId, record.workflowName, "parked", {
+                    reason: "workflow source changed",
+                });
+                this.log(`run ${runId} skipped: workflow source changed; revert or force-resume it, then restart the host`);
+                return;
+            }
+            await this.failUnresumable(record, claimToken, errorMessage(error));
+        }
+        finally {
+            const index = this.parkedEngines.indexOf(parkEngine);
+            if (index !== -1) {
+                this.parkedEngines.splice(index, 1);
+            }
+            await executor.close().catch(() => undefined);
+        }
+    }
+    async failUnresumable(record, claimToken, message) {
+        let actualStatus;
+        let heldClaim = false;
+        try {
+            // The interruption write obeys the same fencing rule as every other
+            // bundle write: without a live claim, the current owner decides.
+            heldClaim = this.store.verifyWorkflowRunClaim({ runId: record.runId, claimToken });
+            if (heldClaim) {
+                const bundle = await this.childRunStore.markRunInterrupted(record.runId, message);
+                actualStatus = bundle?.state.status;
+            }
+        }
+        catch {
+            // The bundle may be unreadable; the queue row still needs closure.
+        }
+        try {
+            this.store.completeWorkflowRun({ runId: record.runId, claimToken });
+        }
+        catch {
+            // Best-effort.
+        }
+        if (!heldClaim) {
+            // Another runner owns the run; its owner reports from here.
+            this.log(`run ${record.runId} continues under another runner`);
+            return;
+        }
+        // Report the bundle's real terminal state when the interruption was a
+        // no-op (the bundle was already waiting or completed), so the feed
+        // stays truthful for sessions syncing from it.
+        if (actualStatus !== undefined && actualStatus !== "failed") {
+            this.recordEvent(record.runId, record.workflowName, actualStatus, {});
+        }
+        else {
+            this.recordEvent(record.runId, record.workflowName, "failed", { error: message });
+        }
+        this.log(`run ${record.runId} cannot resume: ${message}`);
+    }
+    recordEvent(runId, workflowRef, type, payload) {
+        try {
+            this.store.recordRunEvent({ runId, workflowRef, type, payload, runnerId: this.runnerId });
+        }
+        catch {
+            // The event feed is best-effort.
+        }
+    }
+}
+function hostLockPath(stateDir) {
+    return path.join(stateDir, "host.lock");
+}
+/**
+ * The advisory lock guards host-versus-host only: the embedded runner in a
+ * Pi session does not take it. A second host refuses to start while the
+ * recorded PID is alive.
+ */
+function acquireHostLock(stateDir, runnerId, cwd) {
+    const lockPath = hostLockPath(stateDir);
+    const existing = readLock(lockPath);
+    if (existing !== null && existing.runnerId !== runnerId && isAlive(existing.pid)) {
+        throw new Error(`Another workflow host (pid ${existing.pid}, ${existing.runnerId}) is already running for ${cwd}`);
+    }
+    fs.mkdirSync(path.dirname(lockPath), { recursive: true, mode: 0o700 });
+    fs.writeFileSync(lockPath, `${JSON.stringify({ pid: process.pid, runnerId, startedAt: new Date().toISOString() })}\n`, { encoding: "utf8", mode: 0o600 });
+}
+function releaseHostLock(stateDir, runnerId) {
+    const lockPath = hostLockPath(stateDir);
+    const existing = readLock(lockPath);
+    if (existing?.runnerId !== runnerId) {
+        return;
+    }
+    try {
+        fs.rmSync(lockPath);
+    }
+    catch {
+        // Already gone.
+    }
+}
+function readLock(lockPath) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(lockPath, "utf8"));
+        if (typeof parsed.pid !== "number" || typeof parsed.runnerId !== "string") {
+            return null;
+        }
+        return { pid: parsed.pid, runnerId: parsed.runnerId };
+    }
+    catch {
+        return null;
+    }
+}
+function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/host/runner.js.map

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

package/dist/viewer/cli.d.ts

@@ -1,10 +1,14 @@
 #!/usr/bin/env node
-type CliArgs = {
+export type CliArgs = {
     command: string;
-    runId?: string | undefined;
+    runId?: string;
+    controllerName?: string;
+    resourceKey?: string;
     dir: string;
+    controllerDir: string;
     once: boolean;
+    project?: string | undefined;
+    piArgs?: string[] | undefined;
 };
 export declare function parseCliArgs(argv: string[]): CliArgs;
 export declare function main(argv?: string[]): Promise<number>;
-export {};

package/dist/viewer/cli.js

@@ -1,53 +1,97 @@
 #!/usr/bin/env node
-import { realpathSync } from "node:fs";
+import fs, { realpathSync } from "node:fs";
+import path from "node:path";
 import { pathToFileURL } from "node:url";
+import { SqliteControllerStore } from "../controllers/sqlite.js";
+import { projectControllerStoreBaseDir } from "../controllers/store.js";
 import { sanitizeText } from "../render/ansi.js";
 import { listRunBundles, readRunBundle, workflowRunsBaseDir } from "../workflows/store.js";
 import { formatDuration, renderRunDetailLines, renderRunListLines, runElapsedMs, statusLabel, } from "./render.js";
 import { runViewer } from "./tui.js";
-const USAGE = `pi-workflows — live terminal viewer for pi workflow runs
+const USAGE = `pi-workflows — workflow runs and controller resources
 
 Usage:
   pi-workflows view [runId] [--dir <runsDir>] [--once]
   pi-workflows runs [--dir <runsDir>]
+  pi-workflows controllers [--controller-dir <dir>]
+  pi-workflows controller <controller> <key> [--controller-dir <dir>]
+  pi-workflows host [--project <dir>] [-- <extra pi args>]
 
 Commands:
-  view   Open the live TUI viewer. With --once, print a snapshot and exit.
-  runs   List recent workflow runs.
+  view          Open the live workflow TUI. With --once, print a snapshot.
+  runs          List recent workflow runs.
+  controllers   List durable controller resources.
+  controller    Show one resource, its effects, child workflows, and events.
+  host          Run the always-on workflow host in the foreground.
 
 Options:
-  --dir <runsDir>   Runs directory (default: ~/.pi/agent/workflows/runs)
-  --once            Render once to stdout without the interactive TUI
+  --dir <runsDir>          Runs directory (default: ~/.pi/agent/workflows/runs)
+  --controller-dir <dir>  Controller directory (default: project-scoped local store)
+  --once                   Render once without the interactive TUI
+  --project <dir>          Project directory for the host (default: cwd)
 `;
 export function parseCliArgs(argv) {
     const args = [...argv];
     const command = args[0] && !args[0].startsWith("-") ? args.shift() : "view";
     let dir = workflowRunsBaseDir();
+    let controllerDir = projectControllerStoreBaseDir(process.cwd());
     let once = false;
-    let runId;
+    const positionals = [];
+    let project;
+    const piArgs = [];
     while (args.length > 0) {
         const arg = args.shift();
         if (arg === "--dir") {
-            const value = args.shift();
-            if (!value) {
-                throw new Error("--dir requires a path");
-            }
-            dir = value;
+            dir = requiredValue(args, "--dir");
+        }
+        else if (arg === "--controller-dir") {
+            controllerDir = requiredValue(args, "--controller-dir");
+        }
+        else if (arg === "--project") {
+            project = requiredValue(args, "--project");
         }
         else if (arg === "--once") {
             once = true;
         }
         else if (arg === "--help" || arg === "-h") {
-            return { command: "help", dir, once };
+            return { command: "help", dir, controllerDir, once };
         }
-        else if (!arg.startsWith("-") && runId === undefined) {
-            runId = arg;
+        else if (arg === "--") {
+            piArgs.push(...args.splice(0));
         }
-        else {
+        else if (arg.startsWith("-")) {
             throw new Error(`Unknown argument: ${arg}`);
         }
+        else {
+            positionals.push(arg);
+        }
+    }
+    if (command === "host") {
+        return { command, dir, controllerDir, once, project, piArgs };
+    }
+    if (command === "controller") {
+        if (positionals.length !== 2) {
+            throw new Error("controller requires <controller> and <key>");
+        }
+        return {
+            command,
+            controllerName: positionals[0],
+            resourceKey: positionals[1],
+            dir,
+            controllerDir,
+            once,
+        };
     }
-    return { command, runId, dir, once };
+    if (positionals.length > 1) {
+        throw new Error(`Unexpected argument: ${positionals[1]}`);
+    }
+    return {
+        command,
+        ...(positionals[0] !== undefined ? { runId: positionals[0] } : {}),
+        dir,
+        controllerDir,
+        once,
+    };
 }
 async function printRuns(dir) {
     const bundles = await listRunBundles(dir);
@@ -57,7 +101,6 @@ async function printRuns(dir) {
     }
     for (const bundle of bundles) {
         const state = bundle.state;
-        // Titles can interpolate untrusted run input; strip control sequences.
         const title = state.runTitle ? ` — ${sanitizeText(state.runTitle)}` : "";
         process.stdout.write(`${statusLabel(state.status)}  ${sanitizeText(state.workflowName)}${title}  ${state.runId}  ${formatDuration(runElapsedMs(state))}\n`);
     }
@@ -79,6 +122,53 @@ async function printOnce(dir, runId) {
     }
     process.stdout.write(`${renderRunDetailLines(bundle, size).join("\n")}\n`);
 }
+function printControllers(controllerDir) {
+    const store = openControllerStore(controllerDir);
+    if (store === undefined) {
+        process.stdout.write(`No controller resources found in ${controllerDir}\n`);
+        return;
+    }
+    try {
+        const resources = store.listResources();
+        if (resources.length === 0) {
+            process.stdout.write(`No controller resources found in ${controllerDir}\n`);
+            return;
+        }
+        for (const resource of resources) {
+            const condition = resource.status.conditions.find((item) => item.type === "Ready") ??
+                resource.status.conditions[0];
+            const conditionText = condition === undefined
+                ? "unknown"
+                : `${String(condition.status)}:${sanitizeText(condition.reason)}`;
+            process.stdout.write(`${sanitizeText(resource.metadata.controller)}  ${sanitizeText(resource.metadata.key)}  generation=${resource.metadata.generation}  ready=${conditionText}\n`);
+        }
+    }
+    finally {
+        store.close();
+    }
+}
+function printController(controllerDir, controller, key) {
+    const store = openControllerStore(controllerDir);
+    if (store === undefined) {
+        throw new Error(`Controller store not found in ${controllerDir}`);
+    }
+    try {
+        const resource = store.getResource({ controller, key });
+        if (resource === undefined) {
+            throw new Error(`Controller resource not found: ${controller}/${key}`);
+        }
+        const value = {
+            resource,
+            effects: store.listEffects(resource.metadata.uid),
+            workflows: store.listWorkflows(resource.metadata.uid),
+            events: store.listEvents({ controller, key, limit: 50 }),
+        };
+        process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+    }
+    finally {
+        store.close();
+    }
+}
 export async function main(argv = process.argv.slice(2)) {
     let args;
     try {
@@ -97,6 +187,17 @@ export async function main(argv = process.argv.slice(2)) {
             await printRuns(args.dir);
             return 0;
         }
+        if (args.command === "controllers") {
+            printControllers(args.controllerDir);
+            return 0;
+        }
+        if (args.command === "controller") {
+            printController(args.controllerDir, args.controllerName, args.resourceKey);
+            return 0;
+        }
+        if (args.command === "host") {
+            return await runHost(args.project ?? process.cwd(), args.piArgs);
+        }
         if (args.command === "view") {
             if (args.once || !process.stdout.isTTY) {
                 await printOnce(args.dir, args.runId);
@@ -113,8 +214,38 @@ export async function main(argv = process.argv.slice(2)) {
         return 1;
     }
 }
+async function runHost(project, piArgs) {
+    const { WorkflowHost } = await import("../host/runner.js");
+    const host = new WorkflowHost({
+        cwd: project,
+        piArgs: piArgs ?? [],
+        onLog: (message) => process.stdout.write(`[host] ${message}\n`),
+    });
+    await host.start();
+    await new Promise((resolve) => {
+        const shutdown = () => {
+            void host.stop().then(() => resolve());
+        };
+        process.once("SIGTERM", shutdown);
+        process.once("SIGINT", shutdown);
+    });
+    return 0;
+}
+function openControllerStore(controllerDir) {
+    const file = path.join(controllerDir, "controller.sqlite");
+    if (!fs.existsSync(file)) {
+        return undefined;
+    }
+    return new SqliteControllerStore(file, { readOnly: true });
+}
+function requiredValue(args, option) {
+    const value = args.shift();
+    if (!value) {
+        throw new Error(`${option} requires a path`);
+    }
+    return value;
+}
 const entryPath = process.argv[1];
-// realpath so invocation through a bin symlink (npm link) still matches.
 const resolvedEntry = entryPath !== undefined ? realpathSyncSafe(entryPath) : undefined;
 if (resolvedEntry !== undefined && import.meta.url === pathToFileURL(resolvedEntry).href) {
     main().then((code) => {