@osolmaz/pi-workflows 0.5.2 → 0.6.0

package/dist/workflows/progress.js

@@ -0,0 +1,268 @@
+import { sanitizeText } from "./text.js";
+import { validateProgressData } from "./updates.js";
+const TERMINAL = new Set(["completed", "failed", "cancelled"]);
+export function estimateProgress(key, samples, now = new Date()) {
+    if (samples.length === 0)
+        throw new Error("progress estimation requires at least one sample");
+    for (const sample of samples)
+        validateProgressData(sample.data);
+    const latest = samples.at(-1);
+    const data = latest.data;
+    const base = { key, data, sampleCount: 1 };
+    if (TERMINAL.has(data.status))
+        return base;
+    const sourceFinish = validSourceFinish(latest, now);
+    if (sourceFinish !== undefined)
+        base.sourceEstimatedFinishAt = sourceFinish;
+    if (data.status === "waiting" || data.status === "blocked") {
+        return sourceFinish === undefined
+            ? { ...base, unavailableReason: `progress is ${data.status}` }
+            : base;
+    }
+    if (data.completed === undefined || data.total === undefined) {
+        return sourceFinish === undefined ? { ...base, unavailableReason: "total is unknown" } : base;
+    }
+    const epoch = currentEpoch(samples);
+    const intervals = [];
+    for (let index = Math.max(1, epoch.length - 8); index < epoch.length; index += 1) {
+        const previous = epoch[index - 1];
+        const current = epoch[index];
+        const elapsedMs = Date.parse(current.at) - Date.parse(previous.at);
+        const previousCompleted = previous.data.completed;
+        const currentCompleted = current.data.completed;
+        if (elapsedMs <= 0 || previousCompleted === undefined || currentCompleted === undefined)
+            continue;
+        intervals.push({
+            rate: (currentCompleted - previousCompleted) / elapsedMs,
+            delta: currentCompleted - previousCompleted,
+        });
+    }
+    base.sampleCount = intervals.length + 1;
+    const latestDelta = intervals.at(-1)?.delta;
+    if (latestDelta !== undefined)
+        base.delta = latestDelta;
+    if (intervals.length === 0) {
+        return sourceFinish === undefined
+            ? { ...base, unavailableReason: "needs another progress sample" }
+            : base;
+    }
+    const rates = intervals.map((item) => item.rate).sort((a, b) => a - b);
+    const median = quantile(rates, 0.5);
+    const p25 = quantile(rates, 0.25);
+    const p75 = quantile(rates, 0.75);
+    const remaining = Math.max(0, data.total - data.completed);
+    const positive = rates.filter((rate) => rate > 0);
+    if (median <= 0 || positive.length === 0) {
+        return sourceFinish === undefined
+            ? { ...base, unavailableReason: "no positive progress rate" }
+            : base;
+    }
+    const spread = (p75 - p25) / median;
+    const confidence = intervals.length >= 5
+        ? spread <= 0.25
+            ? "high"
+            : spread <= 0.5
+                ? "medium"
+                : "low"
+        : intervals.length >= 2 && spread <= 0.5
+            ? "medium"
+            : "low";
+    const slow = p25 > 0 ? p25 : undefined;
+    const fast = p75 > 0 ? p75 : median;
+    return {
+        ...base,
+        ...(slow !== undefined ? { rateLow: slow } : {}),
+        rateMedian: median,
+        rateHigh: fast,
+        remainingLowMs: remaining / fast,
+        remainingMedianMs: remaining / median,
+        ...(slow !== undefined ? { remainingHighMs: remaining / slow } : {}),
+        confidence,
+    };
+}
+export function progressRecordsFromTrace(events) {
+    const records = [];
+    for (const event of events) {
+        if (event.type !== "update_published" ||
+            event.nodeId === undefined ||
+            event.attemptId === undefined)
+            continue;
+        const payload = event.payload;
+        if (typeof payload.updateId !== "string" ||
+            typeof payload.type !== "string" ||
+            typeof payload.key !== "string" ||
+            payload.data === null ||
+            typeof payload.data !== "object" ||
+            Array.isArray(payload.data))
+            continue;
+        records.push({
+            updateId: payload.updateId,
+            seq: event.seq,
+            at: event.at,
+            runId: event.runId,
+            nodeId: event.nodeId,
+            attemptId: event.attemptId,
+            type: payload.type,
+            key: payload.key,
+            data: payload.data,
+        });
+    }
+    return records;
+}
+export function appendProgressHistory(history, additions, maxPerTrack = 9, maxRecords = 576) {
+    const retained = [];
+    const counts = new Map();
+    const combined = [...history, ...additions];
+    for (let index = combined.length - 1; index >= 0 && retained.length < maxRecords; index -= 1) {
+        const record = combined[index];
+        if (record.type !== "progress")
+            continue;
+        const count = counts.get(record.key) ?? 0;
+        if (count >= maxPerTrack)
+            continue;
+        counts.set(record.key, count + 1);
+        retained.push(record);
+    }
+    return retained.reverse();
+}
+export function progressTracksFromRecords(records, now = new Date()) {
+    const grouped = new Map();
+    for (const record of records) {
+        if (record.type !== "progress")
+            continue;
+        try {
+            const data = validateProgressData(record.data);
+            const samples = grouped.get(record.key) ?? [];
+            samples.push({ at: record.at, data });
+            grouped.set(record.key, samples);
+        }
+        catch {
+            // Readers skip malformed historical update data instead of failing.
+        }
+    }
+    return [...grouped.entries()].map(([key, samples]) => ({
+        key,
+        samples,
+        estimate: estimateProgress(key, samples, now),
+    }));
+}
+export function formatProgressLine(estimate, now = new Date()) {
+    const { data } = estimate;
+    const label = sanitizeText(data.label ?? estimate.key);
+    const unit = data.unit === undefined ? "" : sanitizeText(data.unit);
+    const count = data.completed === undefined
+        ? data.status
+        : data.total === undefined
+            ? `${formatNumber(data.completed)} ${unit}`.trim()
+            : `${formatNumber(data.completed)}/${formatNumber(data.total)} ${unit}`.trim();
+    let eta = "";
+    if (estimate.sourceEstimatedFinishAt !== undefined) {
+        eta = `source ETA ${formatRemaining(Date.parse(estimate.sourceEstimatedFinishAt) - now.getTime())}`;
+    }
+    else if (estimate.remainingMedianMs !== undefined) {
+        const range = estimate.remainingLowMs !== undefined &&
+            estimate.remainingHighMs !== undefined &&
+            Math.abs(estimate.remainingHighMs - estimate.remainingLowMs) >= 1_000
+            ? `${formatRemaining(estimate.remainingLowMs)}–${formatRemaining(estimate.remainingHighMs)}`
+            : formatRemaining(estimate.remainingMedianMs);
+        eta = `ETA ${range}`;
+    }
+    else if (!TERMINAL.has(data.status)) {
+        eta = `ETA unavailable${estimate.unavailableReason ? ` (${estimate.unavailableReason})` : ""}`;
+    }
+    return [label, count, eta].filter(Boolean).join("  ");
+}
+export function formatProgressReport(estimates, nextCheckMinutes, now = new Date(), maxChars = 4_000) {
+    const footer = nextCheckMinutes === undefined ? undefined : `Next check: ${nextCheckMinutes} min`;
+    const lines = [];
+    let omitted = 0;
+    for (const estimate of prioritizeProgressEstimates(estimates)) {
+        const block = [`Progress: ${formatProgressLine(estimate, now)}`];
+        if (estimate.rateMedian !== undefined && estimate.data.unit !== undefined) {
+            const median = estimate.rateMedian * 60_000;
+            const low = estimate.rateLow === undefined ? undefined : estimate.rateLow * 60_000;
+            const high = estimate.rateHigh === undefined ? undefined : estimate.rateHigh * 60_000;
+            const rate = low !== undefined && high !== undefined && Math.abs(high - low) >= 0.01
+                ? `${formatNumber(low)}–${formatNumber(high)}`
+                : formatNumber(median);
+            block.push(`Rate: ${rate} ${estimate.data.unit}/min`);
+            block.push(`Estimate: ${estimate.confidence ?? "low"} confidence, ${estimate.sampleCount} samples`);
+        }
+        const candidate = [...lines, ...block, ...(footer === undefined ? [] : [footer])].join("\n");
+        if (candidate.length > maxChars) {
+            omitted += 1;
+            continue;
+        }
+        lines.push(...block);
+    }
+    if (omitted > 0) {
+        const marker = `${omitted} progress track${omitted === 1 ? "" : "s"} omitted.`;
+        if ([...lines, marker, ...(footer === undefined ? [] : [footer])].join("\n").length <= maxChars) {
+            lines.push(marker);
+        }
+    }
+    if (footer !== undefined && [...lines, footer].join("\n").length <= maxChars)
+        lines.push(footer);
+    return lines.join("\n").slice(0, maxChars);
+}
+export function formatRemaining(ms) {
+    const value = Math.ceil(Math.max(0, ms) / 1_000) * 1_000;
+    if (value < 60_000)
+        return `${Math.ceil(value / 1_000)}s`;
+    if (value < 3_600_000)
+        return `${Math.ceil(value / 60_000)}m`;
+    if (value < 86_400_000)
+        return `${(value / 3_600_000).toFixed(value < 36_000_000 ? 1 : 0)}h`;
+    return `${(value / 86_400_000).toFixed(1)}d`;
+}
+function currentEpoch(samples) {
+    const epoch = [];
+    for (const sample of samples) {
+        const prior = epoch.at(-1);
+        if (prior !== undefined && resetsEpoch(prior.data, sample.data))
+            epoch.length = 0;
+        epoch.push(sample);
+    }
+    return epoch;
+}
+function resetsEpoch(previous, next) {
+    return (previous.phase !== next.phase ||
+        previous.unit !== next.unit ||
+        previous.total !== next.total ||
+        (previous.completed !== undefined &&
+            next.completed !== undefined &&
+            next.completed < previous.completed) ||
+        (TERMINAL.has(previous.status) && !TERMINAL.has(next.status)));
+}
+function validSourceFinish(sample, now) {
+    const finish = sample.data.sourceEstimatedFinishAt;
+    if (finish === undefined)
+        return undefined;
+    const finishMs = Date.parse(finish);
+    const sourceMs = Date.parse(sample.data.sourceUpdatedAt ?? sample.at);
+    return finishMs > sourceMs && finishMs > now.getTime() ? finish : undefined;
+}
+function quantile(sorted, p) {
+    if (sorted.length === 1)
+        return sorted[0];
+    const position = (sorted.length - 1) * p;
+    const lower = Math.floor(position);
+    const fraction = position - lower;
+    const a = sorted[lower];
+    const b = sorted[Math.min(lower + 1, sorted.length - 1)];
+    return a + (b - a) * fraction;
+}
+export function prioritizeProgressEstimates(estimates) {
+    const weight = (item) => item.key === "overall"
+        ? -3
+        : item.data.status === "failed" || item.data.status === "blocked"
+            ? -2
+            : item.data.status === "waiting"
+                ? -1
+                : 0;
+    return [...estimates].sort((a, b) => weight(a) - weight(b));
+}
+function formatNumber(value) {
+    return new Intl.NumberFormat("en-US", { maximumFractionDigits: 2 }).format(value);
+}
+//# sourceMappingURL=progress.js.map

package/dist/workflows/progress.js.map

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

package/dist/workflows/schema.js

@@ -60,7 +60,9 @@ export function assertValidActionNode(node, nodeId = "action") {
         if (typeof node.exec !== "function") {
             fail(`node ${nodeId} exec must be a function`);
         }
-        assertOptionalFunction(node.parse, `node ${nodeId} parse`);
+        const shell = node;
+        assertOptionalFunction(shell.parse, `node ${nodeId} parse`);
+        assertShellUpdates(shell, nodeId);
     }
     else if (typeof node.run !== "function") {
         fail(`node ${nodeId} run must be a function`);
@@ -72,8 +74,26 @@ export function assertValidShellActionNode(node, nodeId = "shell") {
         fail(`node ${nodeId} requires an exec function`);
     }
     assertOptionalFunction(node.parse, `node ${nodeId} parse`);
+    assertShellUpdates(node, nodeId);
     assertCommonNodeFields(node, nodeId);
 }
+function assertShellUpdates(node, nodeId) {
+    if (node.updates === undefined)
+        return;
+    if (node.updates === null || typeof node.updates !== "object") {
+        fail(`node ${nodeId} updates must be an object`);
+    }
+    if (typeof node.updates.parseLine !== "function") {
+        fail(`node ${nodeId} updates.parseLine must be a function`);
+    }
+    if (node.updates.streams !== undefined) {
+        if (!Array.isArray(node.updates.streams) ||
+            node.updates.streams.length === 0 ||
+            node.updates.streams.some((stream) => stream !== "stdout" && stream !== "stderr")) {
+            fail(`node ${nodeId} updates.streams must contain stdout or stderr`);
+        }
+    }
+}
 export function assertValidCheckpointNode(node, nodeId = "checkpoint") {
     if (node.summary !== undefined && typeof node.summary !== "string") {
         fail(`node ${nodeId} summary must be a string`);

package/dist/workflows/schema.js.map

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

package/dist/workflows/shell.d.ts

@@ -1,4 +1,4 @@
-import type { ShellActionExecution, ShellActionResult } from "./types.js";
+import type { ShellActionExecution, ShellActionResult, ShellUpdateLine } from "./types.js";
 /**
  * Retrieve the shell result attached to an error thrown by
  * {@link runShellAction}, so callers can persist the action receipt even when
@@ -6,4 +6,4 @@ import type { ShellActionExecution, ShellActionResult } from "./types.js";
  */
 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>;
+export declare function runShellAction(spec: ShellActionExecution, signal?: AbortSignal, onLine?: (line: ShellUpdateLine) => Promise<void>): Promise<ShellActionResult>;

package/dist/workflows/shell.js

@@ -34,7 +34,7 @@ function shellFailure(spec, args, result, killedBy) {
     }
     return undefined;
 }
-export async function runShellAction(spec, signal) {
+export async function runShellAction(spec, signal, onLine) {
     // The node may have been cancelled while an async `exec` callback resolved;
     // never start side effects for an already-abandoned attempt.
     if (signal?.aborted) {
@@ -57,6 +57,7 @@ export async function runShellAction(spec, signal) {
     let stdout = "";
     let stderr = "";
     let killedBy = null;
+    let lineError;
     let timeout;
     // Cap retained output so a verbose or unending command cannot exhaust
     // memory before its timeout fires.
@@ -93,15 +94,66 @@ export async function runShellAction(spec, signal) {
         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) => {
+    const lineBuffers = { stdout: "", stderr: "" };
+    const decoders = {
+        stdout: new TextDecoder("utf-8", { fatal: onLine !== undefined }),
+        stderr: new TextDecoder("utf-8", { fatal: onLine !== undefined }),
+    };
+    let lineWork = Promise.resolve();
+    const processChunk = (stream, chunk, source) => {
+        if (stream === "stdout")
             stdout = appendCapped(stdout, chunk);
-        });
-        child.stderr.on("data", (chunk) => {
+        else
             stderr = appendCapped(stderr, chunk);
-        });
+        if (onLine === undefined || lineError !== undefined)
+            return;
+        source.pause();
+        lineWork = lineWork
+            .then(async () => {
+            const parts = `${lineBuffers[stream]}${chunk}`.split("\n");
+            lineBuffers[stream] = parts.pop() ?? "";
+            if (Buffer.byteLength(lineBuffers[stream], "utf8") > 64 * 1024) {
+                throw new Error(`shell ${stream} update line exceeded 65536 bytes`);
+            }
+            for (const raw of parts) {
+                const text = raw.endsWith("\r") ? raw.slice(0, -1) : raw;
+                if (Buffer.byteLength(text, "utf8") > 64 * 1024) {
+                    throw new Error(`shell ${stream} update line exceeded 65536 bytes`);
+                }
+                await onLine({ stream, text });
+            }
+        })
+            .catch((error) => {
+            lineError = error instanceof Error ? error : new Error(String(error));
+            kill("abort");
+        })
+            .finally(() => source.resume());
+    };
+    const flushLines = async () => {
+        await lineWork;
+        if (onLine === undefined || lineError !== undefined)
+            return;
+        for (const stream of ["stdout", "stderr"]) {
+            const text = lineBuffers[stream];
+            if (Buffer.byteLength(text, "utf8") > 64 * 1024) {
+                throw new Error(`shell ${stream} update line exceeded 65536 bytes`);
+            }
+            if (text.length > 0)
+                await onLine({ stream, text: text.endsWith("\r") ? text.slice(0, -1) : text });
+        }
+    };
+    const decodeChunk = (stream, chunk, source) => {
+        try {
+            processChunk(stream, decoders[stream].decode(chunk, { stream: true }), source);
+        }
+        catch (error) {
+            lineError = error instanceof Error ? error : new Error(String(error));
+            kill("abort");
+        }
+    };
+    const finish = new Promise((resolve, reject) => {
+        child.stdout.on("data", (chunk) => decodeChunk("stdout", chunk, child.stdout));
+        child.stderr.on("data", (chunk) => decodeChunk("stderr", chunk, child.stderr));
         child.once("error", (error) => {
             // Spawn failures (missing executable, EACCES) still get a receipt so
             // failed actions remain auditable.
@@ -121,24 +173,50 @@ export async function runShellAction(spec, signal) {
         // `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;
+            try {
+                processChunk("stdout", decoders.stdout.decode(), child.stdout);
+                processChunk("stderr", decoders.stderr.decode(), child.stderr);
+            }
+            catch (error) {
+                lineError = error instanceof Error ? error : new Error(String(error));
             }
-            resolve(result);
+            void flushLines()
+                .then(() => {
+                const result = {
+                    command: spec.command,
+                    args,
+                    cwd,
+                    stdout,
+                    stderr,
+                    exitCode,
+                    signal: signalName,
+                    durationMs: Date.now() - startMs,
+                };
+                const error = lineError ?? 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);
+            })
+                .catch((error) => {
+                const failure = error instanceof Error ? error : new Error(String(error));
+                lineError = failure;
+                const result = {
+                    command: spec.command,
+                    args,
+                    cwd,
+                    stdout,
+                    stderr,
+                    exitCode,
+                    signal: signalName,
+                    durationMs: Date.now() - startMs,
+                };
+                failure[SHELL_RESULT] = result;
+                reject(failure);
+            });
         });
     });
     // A child that exits without consuming stdin emits EPIPE; without a

package/dist/workflows/shell.js.map

@@ -1 +1 @@
-{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../src/workflows/shell.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../src/workflows/shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3D,mDAAmD;AACnD,MAAM,wBAAwB,GAAG,SAAS,CAAC;AAC3C,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AAElD,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;AAE7D;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAI,KAAwD,CAAC,YAAY,CAAC,CAAC;QACzF,OAAO,QAAQ,IAAI,IAAI,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,IAAc;IAChE,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtE,OAAO,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,YAAY,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;AAC1E,CAAC;AAED,SAAS,YAAY,CACnB,IAA0B,EAC1B,IAAc,EACd,MAAyB,EACzB,QAAoC;IAEpC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,IAAI,cAAc,EAAE,CAAC;IAC9B,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC9F,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7F,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,OAAO,IAAI,KAAK,CACd,wBAAwB,kBAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,MAAM,GAAG,OAAO,EAAE,CACvF,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAA0B,EAC1B,MAAoB,EACpB,MAAiD;IAEjD,4EAA4E;IAC5E,6DAA6D;IAC7D,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,cAAc,EAAE,CAAC;IAC7B,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,0EAA0E;IAC1E,8DAA8D;IAC9D,MAAM,eAAe,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;IACrD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE;QACtC,GAAG;QACH,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE;QACpC,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QAC/B,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,eAAe;KAC1B,CAAC,CAAC;IAEH,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,QAAQ,GAA+B,IAAI,CAAC;IAChD,IAAI,SAA4B,CAAC;IACjC,IAAI,OAAmC,CAAC;IAExC,sEAAsE;IACtE,mCAAmC;IACnC,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,wBAAwB,CAAC;IACvE,MAAM,YAAY,GAAG,CAAC,OAAe,EAAE,KAAa,EAAU,EAAE;QAC9D,IAAI,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACxC,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,MAAM,IAAI,GAAG,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7C,IAAI,KAAK,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;YACzB,OAAO,OAAO,GAAG,KAAK,CAAC;QACzB,CAAC;QACD,OAAO,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,iBAAiB,CAAC;IACzE,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,CAAC,UAA0B,EAAE,EAAE;QAChD,IAAI,eAAe,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAC/C,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;gBACrC,OAAO;YACT,CAAC;YAAC,MAAM,CAAC;gBACP,qDAAqD;YACvD,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC,CAAC;IAEF,IAAI,cAA0C,CAAC;IAC/C,MAAM,IAAI,GAAG,CAAC,MAA2B,EAAE,EAAE;QAC3C,QAAQ,KAAK,MAAM,CAAC;QACpB,UAAU,CAAC,SAAS,CAAC,CAAC;QACtB,cAAc,KAAK,UAAU,CAAC,GAAG,EAAE;YACjC,UAAU,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC,EAAE,KAAK,CAAC,CAAC;QACV,cAAc,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEpC,MAAM,WAAW,GAAwC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACpF,MAAM,QAAQ,GAAG;QACf,MAAM,EAAE,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;QACjE,MAAM,EAAE,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;KAClE,CAAC;IACF,IAAI,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IACjC,MAAM,YAAY,GAAG,CACnB,MAA2B,EAC3B,KAAa,EACb,MAAuE,EACvE,EAAE;QACF,IAAI,MAAM,KAAK,QAAQ;YAAE,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;;YACzD,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC1C,IAAI,MAAM,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO;QAC5D,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,QAAQ,GAAG,QAAQ;aAChB,IAAI,CAAC,KAAK,IAAI,EAAE;YACf,MAAM,KAAK,GAAG,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3D,WAAW,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;YACxC,IAAI,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;gBAC/D,MAAM,IAAI,KAAK,CAAC,SAAS,MAAM,mCAAmC,CAAC,CAAC;YACtE,CAAC;YACD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;gBACxB,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;gBACzD,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;oBAChD,MAAM,IAAI,KAAK,CAAC,SAAS,MAAM,mCAAmC,CAAC,CAAC;gBACtE,CAAC;gBACD,MAAM,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACjC,CAAC;QACH,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACxB,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACtE,IAAI,CAAC,OAAO,CAAC,CAAC;QAChB,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,KAAK,IAAI,EAAE;QAC5B,MAAM,QAAQ,CAAC;QACf,IAAI,MAAM,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO;QAC5D,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAU,EAAE,CAAC;YACnD,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;YACjC,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;gBAChD,MAAM,IAAI,KAAK,CAAC,SAAS,MAAM,mCAAmC,CAAC,CAAC;YACtE,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBACjB,MAAM,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACnF,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,CAClB,MAA2B,EAC3B,KAAa,EACb,MAAuE,EACvE,EAAE;QACF,IAAI,CAAC;YACH,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACtE,IAAI,CAAC,OAAO,CAAC,CAAC;QAChB,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,OAAO,CAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAChE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACvF,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAEvF,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC5B,qEAAqE;YACrE,mCAAmC;YACnC,MAAM,MAAM,GAAsB;gBAChC,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,IAAI;gBACJ,GAAG;gBACH,MAAM;gBACN,MAAM;gBACN,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,IAAI;gBACZ,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;aACjC,CAAC;YACD,KAAwD,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YACjF,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,sEAAsE;QACtE,sCAAsC;QACtC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE;YAC3C,IAAI,CAAC;gBACH,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC/D,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YACjE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACxE,CAAC;YACD,KAAK,UAAU,EAAE;iBACd,IAAI,CAAC,GAAG,EAAE;gBACT,MAAM,MAAM,GAAsB;oBAChC,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,IAAI;oBACJ,GAAG;oBACH,MAAM;oBACN,MAAM;oBACN,QAAQ;oBACR,MAAM,EAAE,UAAU;oBAClB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;iBACjC,CAAC;gBACF,MAAM,KAAK,GAAG,SAAS,IAAI,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACtE,IAAI,KAAK,EAAE,CAAC;oBACV,+DAA+D;oBAC9D,KAAwD,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;oBACjF,MAAM,CAAC,KAAK,CAAC,CAAC;oBACd,OAAO;gBACT,CAAC;gBACD,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC1E,SAAS,GAAG,OAAO,CAAC;gBACpB,MAAM,MAAM,GAAsB;oBAChC,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,IAAI;oBACJ,GAAG;oBACH,MAAM;oBACN,MAAM;oBACN,QAAQ;oBACR,MAAM,EAAE,UAAU;oBAClB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;iBACjC,CAAC;gBACD,OAA0D,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;gBACnF,MAAM,CAAC,OAAO,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,oEAAoE;IACpE,2EAA2E;IAC3E,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAClC,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IAElB,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;QACjD,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,EAAE,CAAC;QACZ,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC;IACtB,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,EAAE,CAAC;YACZ,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QACD,IAAI,cAAc,EAAE,CAAC;YACnB,mEAAmE;YACnE,0DAA0D;YAC1D,YAAY,CAAC,cAAc,CAAC,CAAC;QAC/B,CAAC;QACD,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/workflows/store.d.ts

@@ -1,4 +1,4 @@
-import type { WorkflowDefinition, WorkflowDefinitionSnapshot, WorkflowRunManifest, WorkflowRunState, WorkflowSessionBinding, WorkflowSessionCapture, WorkflowSessionEntryRecord, WorkflowSessionEventRecord, WorkflowTraceEvent, WorkflowTraceEventDraft } from "./types.js";
+import type { WorkflowDefinition, WorkflowDefinitionSnapshot, WorkflowRunManifest, WorkflowRunState, WorkflowSessionBinding, WorkflowSessionCapture, WorkflowSessionEntryRecord, WorkflowSessionEventRecord, WorkflowTraceEvent, WorkflowTraceEventDraft, WorkflowUpdateInput, WorkflowUpdateRecord } from "./types.js";
 export declare const RUN_BUNDLE_SCHEMA: "pi-workflows.run-bundle.v1";
 export declare const RUN_STATE_SCHEMA: "pi-workflows.run-state.v1";
 export declare const TRACE_EVENT_SCHEMA: "pi-workflows.trace-event.v1";
@@ -57,6 +57,13 @@ export declare class WorkflowRunStore {
     private finalizeRecordingCaptures;
     /** Mark a nonterminal bundle failed and append an interruption event. */
     markRunInterrupted(runId: string, reason?: string): Promise<LoadedRunBundle | null>;
+    /** Publish one durable update under the run's serialized claim-fenced writer. */
+    publishUpdate(runDir: string, state: WorkflowRunState, nodeId: string, attemptId: string, update: WorkflowUpdateInput, options?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        event: WorkflowTraceEvent;
+        record: WorkflowUpdateRecord;
+    }>;
     /**
      * Persist one transition: append the trace event, then rewrite the
      * projections reflecting it.
@@ -106,6 +113,8 @@ export type LoadedRunBundle = {
     manifest: WorkflowRunManifest;
     state: WorkflowRunState;
     snapshot: WorkflowDefinitionSnapshot | null;
+    /** Full durable trace when loaded by the current reader. */
+    traceEvents?: WorkflowTraceEvent[];
     sessionBinding: WorkflowSessionBinding | null;
     sessionEntries: WorkflowSessionEntryRecord[];
     sessionEvents: WorkflowSessionEventRecord[];
@@ -116,8 +125,12 @@ export type LoadedRunBundle = {
 };
 /** Read the final trace record without loading the rest of a run bundle. */
 export declare function readLastTraceEvent(runDir: string, tracePath?: string): Promise<WorkflowTraceEvent | null>;
+export type ReadRunBundleOptions = {
+    /** Load the full append-only trace. Detail views need it; run lists do not. */
+    includeTrace?: boolean;
+};
 /** Read a run bundle from disk. Returns null when the bundle is unreadable. */
-export declare function readRunBundle(runDir: string): Promise<LoadedRunBundle | null>;
+export declare function readRunBundle(runDir: string, options?: ReadRunBundleOptions): 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;