@osolmaz/pi-workflows 0.1.0

package/dist/workflows/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/workflows/schema.ts"],"names":[],"mappings":"AAYA,MAAM,eAAe,GAAG,2BAA2B,CAAC;AAEpD,SAAS,IAAI,CAAC,OAAe;IAC3B,MAAM,IAAI,KAAK,CAAC,gCAAgC,OAAO,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,YAAY,CACnB,KAAc,EACd,WAAmB;IAEnB,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvE,IAAI,CAAC,GAAG,WAAW,oBAAoB,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc,EAAE,WAAmB;IACjE,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QACvD,IAAI,CAAC,GAAG,WAAW,mCAAmC,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,IAA4B,EAAE,MAAc;IAC1E,IACE,IAAI,CAAC,SAAS,KAAK,SAAS;QAC5B,CAAC,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,EAC/F,CAAC;QACD,IAAI,CAAC,QAAQ,MAAM,6CAA6C,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC7E,IAAI,CAAC,QAAQ,MAAM,gCAAgC,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAyB,EAAE,MAAM,GAAG,OAAO;IAC9E,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACtC,IAAI,CAAC,QAAQ,MAAM,6BAA6B,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;QACjF,IAAI,CAAC,QAAQ,MAAM,kCAAkC,CAAC,CAAC;IACzD,CAAC;IACD,sBAAsB,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,MAAM,WAAW,CAAC,CAAC;IACjE,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAA2B,EAAE,MAAM,GAAG,SAAS;IACpF,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC,QAAQ,MAAM,0BAA0B,CAAC,CAAC;IACjD,CAAC;IACD,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAA0B,EAAE,MAAM,GAAG,QAAQ;IACjF,2EAA2E;IAC3E,yEAAyE;IACzE,gCAAgC;IAChC,MAAM,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC;IAC/B,MAAM,MAAM,GAAG,KAAK,IAAI,IAAI,CAAC;IAC7B,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,QAAQ,MAAM,sCAAsC,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACpC,IAAI,CAAC,QAAQ,MAAM,0BAA0B,CAAC,CAAC;QACjD,CAAC;QACD,sBAAsB,CAAE,IAAkC,CAAC,KAAK,EAAE,QAAQ,MAAM,QAAQ,CAAC,CAAC;IAC5F,CAAC;SAAM,IAAI,OAAQ,IAAqC,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;QAC5E,IAAI,CAAC,QAAQ,MAAM,yBAAyB,CAAC,CAAC;IAChD,CAAC;IACD,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,IAA+B,EAC/B,MAAM,GAAG,OAAO;IAEhB,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACpC,IAAI,CAAC,QAAQ,MAAM,4BAA4B,CAAC,CAAC;IACnD,CAAC;IACD,sBAAsB,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,MAAM,QAAQ,CAAC,CAAC;IAC3D,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,IAA8B,EAC9B,MAAM,GAAG,YAAY;IAErB,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACnE,IAAI,CAAC,QAAQ,MAAM,2BAA2B,CAAC,CAAC;IAClD,CAAC;IACD,sBAAsB,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,MAAM,MAAM,CAAC,CAAC;IACvD,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,eAAe,CAAC,IAA4B,EAAE,MAAc;IACnE,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QACtB,KAAK,OAAO;YACV,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACnC,OAAO;QACT,KAAK,SAAS;YACZ,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACrC,OAAO;QACT,KAAK,QAAQ;YACX,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACpC,OAAO;QACT,KAAK,YAAY;YACf,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACxC,OAAO;QACT;YACE,IAAI,CACF,QAAQ,MAAM,yBAAyB,MAAM,CAAE,IAA+B,CAAC,QAAQ,CAAC,EAAE,CAC3F,CAAC;IACN,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAkB,EAAE,KAAa;IAC7D,YAAY,CAAC,IAAI,EAAE,QAAQ,KAAK,EAAE,CAAC,CAAC;IACpC,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC,QAAQ,KAAK,0BAA0B,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QACjB,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,IAAI,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxD,IAAI,CAAC,QAAQ,KAAK,wBAAwB,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO;IACT,CAAC;IACD,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC;IAClD,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtE,IAAI,CAAC,QAAQ,KAAK,uCAAuC,CAAC,CAAC;IAC7D,CAAC;IACD,0EAA0E;IAC1E,0EAA0E;IAC1E,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACrF,IAAI,CAAC,QAAQ,KAAK,4DAA4D,CAAC,CAAC;IAClF,CAAC;IACD,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,KAAK,eAAe,CAAC,CAAC;IAC9D,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,QAAQ,KAAK,iCAAiC,CAAC,CAAC;IACvD,CAAC;IACD,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAClE,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtD,IAAI,CAAC,QAAQ,KAAK,gBAAgB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE/E,MAAM,UAAU,kCAAkC,CAAC,UAA8B;IAC/E,YAAY,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACrC,IAAI,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxE,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,uBAAuB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,iBAAiB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACjG,CAAC;IACD,IACE,UAAU,CAAC,KAAK,KAAK,SAAS;QAC9B,OAAO,UAAU,CAAC,KAAK,KAAK,QAAQ;QACpC,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,EACtC,CAAC;QACD,IAAI,CAAC,6CAA6C,CAAC,CAAC;IACtD,CAAC;IACD,IACE,UAAU,CAAC,kBAAkB,KAAK,SAAS;QAC3C,OAAO,UAAU,CAAC,kBAAkB,KAAK,QAAQ;QACjD,OAAO,UAAU,CAAC,kBAAkB,KAAK,UAAU,EACnD,CAAC;QACD,IAAI,CAAC,0DAA0D,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,OAAO,UAAU,CAAC,OAAO,KAAK,QAAQ,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9E,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACpC,CAAC;IACD,IACE,UAAU,CAAC,QAAQ,KAAK,SAAS;QACjC,CAAC,OAAO,UAAU,CAAC,QAAQ,KAAK,QAAQ;YACtC,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC;YACtC,UAAU,CAAC,QAAQ,IAAI,CAAC,CAAC,EAC3B,CAAC;QACD,IAAI,CAAC,8CAA8C,CAAC,CAAC;IACvD,CAAC;IACD,YAAY,CAAC,UAAU,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAC9C,CAAC;IACD,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9D,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,eAAe,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,qEAAqE;QACrE,iEAAiE;QACjE,IAAI,MAAM,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,qCAAqC,CAAC,CAAC;QAC/E,CAAC;QACD,YAAY,CAAC,IAAI,EAAE,QAAQ,MAAM,EAAE,CAAC,CAAC;QACrC,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC1C,CAAC;IACD,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;AACjD,CAAC"}

package/dist/workflows/shell.d.ts

@@ -0,0 +1,9 @@
+import type { ShellActionExecution, ShellActionResult } from "./types.js";
+/**
+ * Retrieve the shell result attached to an error thrown by
+ * {@link runShellAction}, so callers can persist the action receipt even when
+ * the command failed.
+ */
+export declare function shellResultFromError(error: unknown): ShellActionResult | null;
+export declare function renderShellCommand(command: string, args: string[]): string;
+export declare function runShellAction(spec: ShellActionExecution, signal?: AbortSignal): Promise<ShellActionResult>;

package/dist/workflows/shell.js

@@ -0,0 +1,177 @@
+import { spawn } from "node:child_process";
+import { CancelledError, TimeoutError } from "./errors.js";
+/** Default cap on captured stdout/stderr, each. */
+const DEFAULT_MAX_OUTPUT_CHARS = 1_000_000;
+const TRUNCATION_MARKER = "\n…[output truncated]";
+const SHELL_RESULT = Symbol.for("pi-workflows.shell-result");
+/**
+ * Retrieve the shell result attached to an error thrown by
+ * {@link runShellAction}, so callers can persist the action receipt even when
+ * the command failed.
+ */
+export function shellResultFromError(error) {
+    if (error instanceof Error) {
+        const attached = error[SHELL_RESULT];
+        return attached ?? null;
+    }
+    return null;
+}
+export function renderShellCommand(command, args) {
+    const renderedArgs = args.map((arg) => JSON.stringify(arg)).join(" ");
+    return renderedArgs.length > 0 ? `${command} ${renderedArgs}` : command;
+}
+function shellFailure(spec, args, result, killedBy) {
+    if (killedBy === "timeout") {
+        return new TimeoutError(spec.timeoutMs ?? 0);
+    }
+    if (killedBy === "abort") {
+        return new CancelledError();
+    }
+    if (((result.exitCode ?? 0) !== 0 || result.signal != null) && spec.allowNonZeroExit !== true) {
+        const status = result.signal ? `signal ${result.signal}` : `exit ${String(result.exitCode)}`;
+        const details = result.stderr.length > 0 ? `\n${result.stderr.trim()}` : "";
+        return new Error(`Shell action failed (${renderShellCommand(spec.command, args)}): ${status}${details}`);
+    }
+    return undefined;
+}
+export async function runShellAction(spec, signal) {
+    // The node may have been cancelled while an async `exec` callback resolved;
+    // never start side effects for an already-abandoned attempt.
+    if (signal?.aborted) {
+        throw new CancelledError();
+    }
+    const cwd = spec.cwd ?? process.cwd();
+    const args = spec.args ?? [];
+    const startMs = Date.now();
+    // POSIX: run in its own process group so timeout/abort can kill the whole
+    // tree, including descendants that inherited the stdio pipes.
+    const useProcessGroup = process.platform !== "win32";
+    const child = spawn(spec.command, args, {
+        cwd,
+        env: { ...process.env, ...spec.env },
+        shell: spec.shell,
+        stdio: ["pipe", "pipe", "pipe"],
+        windowsHide: true,
+        detached: useProcessGroup,
+    });
+    let stdout = "";
+    let stderr = "";
+    let killedBy = null;
+    let timeout;
+    // Cap retained output so a verbose or unending command cannot exhaust
+    // memory before its timeout fires.
+    const maxOutputChars = spec.maxOutputChars ?? DEFAULT_MAX_OUTPUT_CHARS;
+    const appendCapped = (current, chunk) => {
+        if (current.endsWith(TRUNCATION_MARKER)) {
+            return current;
+        }
+        const room = maxOutputChars - current.length;
+        if (chunk.length <= room) {
+            return current + chunk;
+        }
+        return current + chunk.slice(0, Math.max(0, room)) + TRUNCATION_MARKER;
+    };
+    const signalTree = (killSignal) => {
+        if (useProcessGroup && child.pid !== undefined) {
+            try {
+                process.kill(-child.pid, killSignal);
+                return;
+            }
+            catch {
+                // Group already gone; fall back to the direct child.
+            }
+        }
+        child.kill(killSignal);
+    };
+    let killEscalation;
+    const kill = (reason) => {
+        killedBy ??= reason;
+        signalTree("SIGTERM");
+        killEscalation ??= setTimeout(() => {
+            signalTree("SIGKILL");
+        }, 1_000);
+        killEscalation.unref();
+    };
+    const onAbort = () => kill("abort");
+    const finish = new Promise((resolve, reject) => {
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        child.stdout.on("data", (chunk) => {
+            stdout = appendCapped(stdout, chunk);
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr = appendCapped(stderr, chunk);
+        });
+        child.once("error", (error) => {
+            // Spawn failures (missing executable, EACCES) still get a receipt so
+            // failed actions remain auditable.
+            const result = {
+                command: spec.command,
+                args,
+                cwd,
+                stdout,
+                stderr,
+                exitCode: null,
+                signal: null,
+                durationMs: Date.now() - startMs,
+            };
+            error[SHELL_RESULT] = result;
+            reject(error);
+        });
+        // `close` (unlike `exit`) fires only after stdio has fully closed, so
+        // captured output is never truncated.
+        child.once("close", (exitCode, signalName) => {
+            const result = {
+                command: spec.command,
+                args,
+                cwd,
+                stdout,
+                stderr,
+                exitCode,
+                signal: signalName,
+                durationMs: Date.now() - startMs,
+            };
+            const error = shellFailure(spec, args, result, killedBy);
+            if (error) {
+                // Attach the result so callers can persist the action receipt.
+                error[SHELL_RESULT] = result;
+                reject(error);
+                return;
+            }
+            resolve(result);
+        });
+    });
+    // A child that exits without consuming stdin emits EPIPE; without a
+    // listener that would crash the whole process instead of just this action.
+    child.stdin.on("error", () => { });
+    if (spec.stdin != null) {
+        child.stdin.write(spec.stdin);
+    }
+    child.stdin.end();
+    if (spec.timeoutMs != null && spec.timeoutMs > 0) {
+        timeout = setTimeout(() => kill("timeout"), spec.timeoutMs);
+    }
+    if (signal) {
+        if (signal.aborted) {
+            onAbort();
+        }
+        else {
+            signal.addEventListener("abort", onAbort, { once: true });
+        }
+    }
+    try {
+        return await finish;
+    }
+    finally {
+        if (timeout) {
+            clearTimeout(timeout);
+        }
+        if (killEscalation) {
+            // The group pid may be reused after the child exits; never let the
+            // delayed SIGKILL fire once the command has fully closed.
+            clearTimeout(killEscalation);
+        }
+        signal?.removeEventListener("abort", onAbort);
+    }
+}
+//# sourceMappingURL=shell.js.map

package/dist/workflows/shell.js.map

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

package/dist/workflows/store.d.ts

@@ -0,0 +1,35 @@
+import type { WorkflowDefinition, WorkflowDefinitionSnapshot, WorkflowRunManifest, WorkflowRunState, WorkflowTraceEvent, WorkflowTraceEventDraft } from "./types.js";
+export declare const RUN_BUNDLE_SCHEMA: "pi-workflows.run-bundle.v1";
+export declare const TRACE_EVENT_SCHEMA: "pi-workflows.trace-event.v1";
+export declare const DEFINITION_SNAPSHOT_SCHEMA: "pi-workflows.definition-snapshot.v1";
+/** Runs directory: `$PI_WORKFLOWS_RUNS_DIR` or `~/.pi/agent/workflows/runs`. */
+export declare function workflowRunsBaseDir(homeDir?: string): string;
+export declare function createRunId(workflowName: string, now?: Date): string;
+/**
+ * Persists run bundles. A bundle directory contains `manifest.json`,
+ * `workflow.json` (definition snapshot), `state.json` (full run projection,
+ * atomically replaced), and `trace.ndjson` (append-only event log).
+ */
+export declare class WorkflowRunStore {
+    readonly outputRoot: string;
+    private readonly traceSeqByRun;
+    private readonly appendChainByPath;
+    constructor(outputRoot?: string);
+    runDirFor(runId: string): string;
+    initializeRunBundle(workflow: WorkflowDefinition, state: WorkflowRunState): Promise<string>;
+    writeSnapshot(runDir: string, state: WorkflowRunState, event: WorkflowTraceEventDraft): Promise<WorkflowTraceEvent>;
+    appendTrace(runDir: string, state: WorkflowRunState, event: WorkflowTraceEventDraft): Promise<WorkflowTraceEvent>;
+    private nextTraceSeq;
+    private appendJsonLine;
+}
+export type LoadedRunBundle = {
+    runDir: string;
+    manifest: WorkflowRunManifest;
+    state: WorkflowRunState;
+    snapshot: WorkflowDefinitionSnapshot | null;
+};
+/** Read a run bundle from disk. Returns null when the bundle is unreadable. */
+export declare function readRunBundle(runDir: string): Promise<LoadedRunBundle | null>;
+/** List run bundles under `outputRoot`, most recently started first. */
+export declare function listRunBundles(outputRoot: string): Promise<LoadedRunBundle[]>;
+export declare function createDefinitionSnapshot(workflow: WorkflowDefinition): WorkflowDefinitionSnapshot;

package/dist/workflows/store.js

@@ -0,0 +1,181 @@
+import { randomUUID } from "node:crypto";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+export const RUN_BUNDLE_SCHEMA = "pi-workflows.run-bundle.v1";
+export const TRACE_EVENT_SCHEMA = "pi-workflows.trace-event.v1";
+export const DEFINITION_SNAPSHOT_SCHEMA = "pi-workflows.definition-snapshot.v1";
+const MANIFEST_PATH = "manifest.json";
+const WORKFLOW_SNAPSHOT_PATH = "workflow.json";
+const STATE_PATH = "state.json";
+const TRACE_PATH = "trace.ndjson";
+/** Runs directory: `$PI_WORKFLOWS_RUNS_DIR` or `~/.pi/agent/workflows/runs`. */
+export function workflowRunsBaseDir(homeDir = os.homedir()) {
+    const override = process.env.PI_WORKFLOWS_RUNS_DIR;
+    if (override !== undefined && override.length > 0) {
+        return override;
+    }
+    return path.join(homeDir, ".pi", "agent", "workflows", "runs");
+}
+export function createRunId(workflowName, now = new Date()) {
+    const stamp = now
+        .toISOString()
+        .replaceAll(/[-:]/g, "")
+        .replace(/\.\d+Z$/, "Z");
+    const slug = workflowName
+        .toLowerCase()
+        .replaceAll(/[^a-z0-9]+/g, "-")
+        .replaceAll(/(^-|-$)/g, "")
+        .slice(0, 40);
+    return `${stamp}-${slug || "workflow"}-${randomUUID().slice(0, 8)}`;
+}
+/**
+ * Persists run bundles. A bundle directory contains `manifest.json`,
+ * `workflow.json` (definition snapshot), `state.json` (full run projection,
+ * atomically replaced), and `trace.ndjson` (append-only event log).
+ */
+export class WorkflowRunStore {
+    outputRoot;
+    traceSeqByRun = new Map();
+    appendChainByPath = new Map();
+    constructor(outputRoot = workflowRunsBaseDir()) {
+        this.outputRoot = outputRoot;
+    }
+    runDirFor(runId) {
+        return path.join(this.outputRoot, runId);
+    }
+    async initializeRunBundle(workflow, state) {
+        const runDir = this.runDirFor(state.runId);
+        await fs.mkdir(runDir, { recursive: true });
+        this.traceSeqByRun.set(runDir, 0);
+        await writeJsonAtomic(path.join(runDir, WORKFLOW_SNAPSHOT_PATH), createDefinitionSnapshot(workflow));
+        await writeJsonAtomic(path.join(runDir, MANIFEST_PATH), createManifest(state));
+        await writeJsonAtomic(path.join(runDir, STATE_PATH), state);
+        await this.appendJsonLine(path.join(runDir, TRACE_PATH), null);
+        return runDir;
+    }
+    async writeSnapshot(runDir, state, event) {
+        state.updatedAt = new Date().toISOString();
+        await writeJsonAtomic(path.join(runDir, STATE_PATH), state);
+        await writeJsonAtomic(path.join(runDir, MANIFEST_PATH), createManifest(state));
+        return await this.appendTrace(runDir, state, event);
+    }
+    async appendTrace(runDir, state, event) {
+        const traceEvent = {
+            seq: this.nextTraceSeq(runDir),
+            at: new Date().toISOString(),
+            runId: state.runId,
+            ...event,
+        };
+        await this.appendJsonLine(path.join(runDir, TRACE_PATH), traceEvent);
+        return traceEvent;
+    }
+    nextTraceSeq(runDir) {
+        const next = (this.traceSeqByRun.get(runDir) ?? 0) + 1;
+        this.traceSeqByRun.set(runDir, next);
+        return next;
+    }
+    async appendJsonLine(filePath, value) {
+        const prior = this.appendChainByPath.get(filePath) ?? Promise.resolve();
+        const nextWrite = prior.then(async () => {
+            await fs.mkdir(path.dirname(filePath), { recursive: true });
+            await fs.appendFile(filePath, value === null ? "" : `${JSON.stringify(value)}\n`, "utf8");
+        });
+        const tracked = nextWrite.finally(() => {
+            if (this.appendChainByPath.get(filePath) === tracked) {
+                this.appendChainByPath.delete(filePath);
+            }
+        });
+        this.appendChainByPath.set(filePath, tracked);
+        await tracked;
+    }
+}
+/** Read a run bundle from disk. Returns null when the bundle is unreadable. */
+export async function readRunBundle(runDir) {
+    const manifest = await readJsonFile(path.join(runDir, MANIFEST_PATH));
+    const state = await readJsonFile(path.join(runDir, STATE_PATH));
+    if (!manifest || !state || manifest.schema !== RUN_BUNDLE_SCHEMA) {
+        return null;
+    }
+    const snapshot = await readJsonFile(path.join(runDir, WORKFLOW_SNAPSHOT_PATH));
+    return { runDir, manifest, state, snapshot };
+}
+/** List run bundles under `outputRoot`, most recently started first. */
+export async function listRunBundles(outputRoot) {
+    let entries;
+    try {
+        entries = await fs.readdir(outputRoot);
+    }
+    catch {
+        return [];
+    }
+    const bundles = [];
+    for (const entry of entries) {
+        const bundle = await readRunBundle(path.join(outputRoot, entry));
+        if (bundle) {
+            bundles.push(bundle);
+        }
+    }
+    bundles.sort((a, b) => b.state.startedAt.localeCompare(a.state.startedAt));
+    return bundles;
+}
+async function readJsonFile(filePath) {
+    try {
+        const raw = await fs.readFile(filePath, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function createManifest(state) {
+    return {
+        schema: RUN_BUNDLE_SCHEMA,
+        runId: state.runId,
+        workflowName: state.workflowName,
+        ...(state.runTitle !== undefined ? { runTitle: state.runTitle } : {}),
+        ...(state.workflowPath !== undefined ? { workflowPath: state.workflowPath } : {}),
+        startedAt: state.startedAt,
+        ...(state.finishedAt !== undefined ? { finishedAt: state.finishedAt } : {}),
+        status: state.status,
+        traceSchema: TRACE_EVENT_SCHEMA,
+        paths: {
+            workflow: WORKFLOW_SNAPSHOT_PATH,
+            state: STATE_PATH,
+            trace: TRACE_PATH,
+        },
+    };
+}
+export function createDefinitionSnapshot(workflow) {
+    return {
+        schema: DEFINITION_SNAPSHOT_SCHEMA,
+        name: workflow.name,
+        startAt: workflow.startAt,
+        nodes: Object.fromEntries(Object.entries(workflow.nodes).map(([nodeId, node]) => [nodeId, snapshotNode(node)])),
+        edges: structuredClone(workflow.edges),
+    };
+}
+function snapshotNode(node) {
+    const common = {
+        nodeType: node.nodeType,
+        ...(node.timeoutMs !== undefined ? { timeoutMs: node.timeoutMs } : {}),
+        ...(node.statusDetail !== undefined ? { statusDetail: node.statusDetail } : {}),
+    };
+    if (node.nodeType === "agent" && node.expectedOutput !== undefined) {
+        common.expectedOutput = node.expectedOutput;
+    }
+    if (node.nodeType === "checkpoint" && node.summary !== undefined) {
+        common.summary = node.summary;
+    }
+    if (node.nodeType === "action") {
+        common.actionExecution = "exec" in node ? "shell" : "function";
+    }
+    return common;
+}
+async function writeJsonAtomic(filePath, value) {
+    const tempPath = `${filePath}.${process.pid}.${randomUUID()}.tmp`;
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.writeFile(tempPath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+    await fs.rename(tempPath, filePath);
+}
+//# sourceMappingURL=store.js.map

package/dist/workflows/store.js.map

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

package/dist/workflows/text.d.ts

@@ -0,0 +1,10 @@
+/** Remove ANSI escape sequences (CSI style) from a string. */
+export declare function stripAnsi(text: string): string;
+/**
+ * Remove ANSI escapes and control characters from untrusted text (model
+ * outputs, errors, titles) so rendering it cannot alter terminal state. Line
+ * breaks and tabs collapse to single spaces because callers interpolate the
+ * result into single terminal lines, where a stray newline would break
+ * viewport math and allow fake rows.
+ */
+export declare function sanitizeText(text: string): string;

package/dist/workflows/text.js

@@ -0,0 +1,32 @@
+/** Remove ANSI escape sequences (CSI style) from a string. */
+export function stripAnsi(text) {
+    let result = "";
+    let index = 0;
+    while (index < text.length) {
+        if (text[index] === "\u001b" && text[index + 1] === "[") {
+            index += 2;
+            while (index < text.length && !/[A-Za-z]/.test(text[index])) {
+                index += 1;
+            }
+            index += 1;
+            continue;
+        }
+        result += text[index];
+        index += 1;
+    }
+    return result;
+}
+/**
+ * Remove ANSI escapes and control characters from untrusted text (model
+ * outputs, errors, titles) so rendering it cannot alter terminal state. Line
+ * breaks and tabs collapse to single spaces because callers interpolate the
+ * result into single terminal lines, where a stray newline would break
+ * viewport math and allow fake rows.
+ */
+export function sanitizeText(text) {
+    return (stripAnsi(text)
+        .replaceAll(/[\t\n\r]+/g, " ")
+        // eslint-disable-next-line no-control-regex
+        .replaceAll(/[\u0000-\u001f\u007f]/g, ""));
+}
+//# sourceMappingURL=text.js.map

package/dist/workflows/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/workflows/text.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACxD,KAAK,IAAI,CAAC,CAAC;YACX,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAW,CAAC,EAAE,CAAC;gBACtE,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;YACD,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,CACL,SAAS,CAAC,IAAI,CAAC;SACZ,UAAU,CAAC,YAAY,EAAE,GAAG,CAAC;QAC9B,4CAA4C;SAC3C,UAAU,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAC5C,CAAC;AACJ,CAAC"}