@davidorex/pi-workflows 0.1.0 → 0.3.0

package/dist/step-agent.js.map

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

package/dist/step-command.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Command step executor — runs a shell command and captures output as data.
+ *
+ * Unlike gate (which judges pass/fail), command captures stdout as structured
+ * or text output for downstream steps. Non-zero exit codes produce a failed result.
+ */
+import type { StepResult } from "./types.js";
+/**
+ * Execute a command step: runs a shell command, captures stdout as output.
+ *
+ * The command string is expected to already have ${{ }} expressions resolved
+ * before being passed here.
+ */
+export declare function executeCommand(command: string, stepName: string, options: {
+    cwd: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    runDir?: string;
+    outputPath?: string;
+}, outputFormat?: "json" | "text"): Promise<StepResult>;
+//# sourceMappingURL=step-command.d.ts.map

package/dist/step-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-command.d.ts","sourceRoot":"","sources":["../src/step-command.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;GAKG;AACH,wBAAsB,cAAc,CACnC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EACxG,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAC5B,OAAO,CAAC,UAAU,CAAC,CAiIrB"}

package/dist/step-command.js

@@ -0,0 +1,150 @@
+/**
+ * Command step executor — runs a shell command and captures output as data.
+ *
+ * Unlike gate (which judges pass/fail), command captures stdout as structured
+ * or text output for downstream steps. Non-zero exit codes produce a failed result.
+ */
+import { persistStepOutput } from "./output.js";
+import { SIGKILL_GRACE_MS, zeroUsage } from "./step-shared.js";
+/**
+ * Execute a command step: runs a shell command, captures stdout as output.
+ *
+ * The command string is expected to already have ${{ }} expressions resolved
+ * before being passed here.
+ */
+export async function executeCommand(command, stepName, options, outputFormat) {
+    const startTime = Date.now();
+    try {
+        const { spawn } = await import("node:child_process");
+        const { stdout, stderr } = await new Promise((resolve, reject) => {
+            const proc = spawn("sh", ["-c", command], {
+                cwd: options.cwd,
+                stdio: ["ignore", "pipe", "pipe"],
+                detached: true,
+            });
+            let stdout = "";
+            let stderr = "";
+            let settled = false;
+            proc.stdout.on("data", (d) => {
+                stdout += d.toString();
+            });
+            proc.stderr.on("data", (d) => {
+                stderr += d.toString();
+            });
+            const killProc = () => {
+                if (!proc.pid)
+                    return;
+                try {
+                    process.kill(-proc.pid, "SIGTERM");
+                }
+                catch {
+                    /* already dead */
+                }
+                setTimeout(() => {
+                    if (!proc.pid)
+                        return;
+                    try {
+                        process.kill(-proc.pid, "SIGKILL");
+                    }
+                    catch {
+                        /* already dead */
+                    }
+                }, SIGKILL_GRACE_MS);
+            };
+            const onAbort = () => {
+                killProc();
+            };
+            if (options.signal) {
+                if (options.signal.aborted) {
+                    killProc();
+                }
+                else {
+                    options.signal.addEventListener("abort", onAbort, { once: true });
+                }
+            }
+            let timeoutId;
+            if (options.timeoutMs) {
+                timeoutId = setTimeout(() => {
+                    killProc();
+                }, options.timeoutMs);
+            }
+            proc.on("close", (code) => {
+                if (settled)
+                    return;
+                settled = true;
+                if (timeoutId)
+                    clearTimeout(timeoutId);
+                if (options.signal)
+                    options.signal.removeEventListener("abort", onAbort);
+                if (code === 0) {
+                    resolve({ stdout, stderr });
+                }
+                else {
+                    const err = new Error(`Process exited with code ${code}`);
+                    err.status = code;
+                    err.stdout = stdout;
+                    err.stderr = stderr;
+                    reject(err);
+                }
+            });
+            proc.on("error", (err) => {
+                if (settled)
+                    return;
+                settled = true;
+                if (timeoutId)
+                    clearTimeout(timeoutId);
+                if (options.signal)
+                    options.signal.removeEventListener("abort", onAbort);
+                reject(err);
+            });
+        });
+        // Exit 0: parse output
+        let output;
+        let textOutput;
+        if (outputFormat === "json") {
+            try {
+                output = JSON.parse(stdout);
+            }
+            catch {
+                output = { text: stdout.trim() };
+            }
+            textOutput = stdout.trim();
+        }
+        else {
+            textOutput = stdout.trim();
+            output = { text: textOutput };
+        }
+        const result = {
+            step: stepName,
+            agent: "command",
+            status: "completed",
+            output,
+            textOutput,
+            usage: zeroUsage(),
+            durationMs: Date.now() - startTime,
+        };
+        if (options.runDir) {
+            result.outputPath = persistStepOutput(options.runDir, stepName, output, textOutput, options.outputPath);
+        }
+        return result;
+    }
+    catch (err) {
+        const execErr = err;
+        const exitCode = execErr.status ?? 1;
+        const stderr = execErr.stderr?.trim() ?? "";
+        const stdout = execErr.stdout?.trim() ?? "";
+        const result = {
+            step: stepName,
+            agent: "command",
+            status: "failed",
+            usage: zeroUsage(),
+            durationMs: Date.now() - startTime,
+            error: `Command failed (exit ${exitCode}): ${stderr || stdout || execErr.message || "unknown error"}`,
+        };
+        if (options.runDir) {
+            persistStepOutput(options.runDir, stepName, { error: result.error, exitCode }, undefined, options.outputPath);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=step-command.js.map

package/dist/step-command.js.map

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

package/dist/step-foreach.d.ts

@@ -0,0 +1,33 @@
+/**
+ * ForEach step executor — iterates over an array, executing the step body
+ * once per element with the element bound to a named variable in scope.
+ */
+import type { ExecutionState, StepResult, StepSpec } from "./types.js";
+/** Options for forEach execution, matching the StepExecOptions pattern. */
+interface ForEachOptions {
+    ctx: any;
+    pi: any;
+    signal?: AbortSignal;
+    loadAgent: (name: string) => any;
+    runDir: string;
+    spec: any;
+    widgetState: any;
+    templateEnv?: any;
+    dispatchFn?: any;
+}
+/**
+ * Execute a forEach step: iterates over an array and executes the step body
+ * for each element.
+ *
+ * @param stepName - the name of the forEach step
+ * @param stepSpec - the full step spec (including forEach, as, and the body type)
+ * @param state - current execution state
+ * @param forEachExpr - the forEach expression string (without ${{ }} delimiters)
+ * @param asName - the variable name to bind each element (default: "item")
+ * @param executeSingleStep - the step executor function to delegate to
+ * @param options - step execution options
+ * @returns combined StepResult with array output
+ */
+export declare function executeForEach(stepName: string, stepSpec: StepSpec, state: ExecutionState, forEachExpr: string, asName: string, executeSingleStep: (name: string, spec: StepSpec, state: ExecutionState, opts: ForEachOptions) => Promise<boolean>, options: ForEachOptions): Promise<StepResult>;
+export {};
+//# sourceMappingURL=step-foreach.d.ts.map

package/dist/step-foreach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-foreach.d.ts","sourceRoot":"","sources":["../src/step-foreach.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAmB,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAExF,2EAA2E;AAC3E,UAAU,cAAc;IACvB,GAAG,EAAE,GAAG,CAAC;IACT,EAAE,EAAE,GAAG,CAAC;IACR,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,GAAG,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,GAAG,CAAC;IACV,WAAW,EAAE,GAAG,CAAC;IACjB,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,UAAU,CAAC,EAAE,GAAG,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,cAAc,EACrB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,EAClH,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,UAAU,CAAC,CAsGrB"}

package/dist/step-foreach.js

@@ -0,0 +1,112 @@
+/**
+ * ForEach step executor — iterates over an array, executing the step body
+ * once per element with the element bound to a named variable in scope.
+ */
+import { resolveExpression, resolveExpressions } from "./expression.js";
+import { persistStepOutput } from "./output.js";
+import { addUsage, zeroUsage } from "./step-shared.js";
+/**
+ * Execute a forEach step: iterates over an array and executes the step body
+ * for each element.
+ *
+ * @param stepName - the name of the forEach step
+ * @param stepSpec - the full step spec (including forEach, as, and the body type)
+ * @param state - current execution state
+ * @param forEachExpr - the forEach expression string (without ${{ }} delimiters)
+ * @param asName - the variable name to bind each element (default: "item")
+ * @param executeSingleStep - the step executor function to delegate to
+ * @param options - step execution options
+ * @returns combined StepResult with array output
+ */
+export async function executeForEach(stepName, stepSpec, state, forEachExpr, asName, executeSingleStep, options) {
+    const startTime = Date.now();
+    const scope = { input: state.input, steps: state.steps };
+    // Resolve the forEach expression to get the array
+    const rawExpr = forEachExpr.replace(/^\$\{\{\s*/, "").replace(/\s*\}\}$/, "");
+    let array;
+    try {
+        array = resolveExpression(rawExpr, scope);
+    }
+    catch (err) {
+        return {
+            step: stepName,
+            agent: "forEach",
+            status: "failed",
+            usage: zeroUsage(),
+            durationMs: Date.now() - startTime,
+            error: `forEach expression failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    if (!Array.isArray(array)) {
+        return {
+            step: stepName,
+            agent: "forEach",
+            status: "failed",
+            usage: zeroUsage(),
+            durationMs: Date.now() - startTime,
+            error: `forEach expression must resolve to an array, got ${typeof array}`,
+        };
+    }
+    // Empty array → completed with empty output
+    if (array.length === 0) {
+        return {
+            step: stepName,
+            agent: "forEach",
+            status: "completed",
+            output: [],
+            textOutput: "[]",
+            usage: zeroUsage(),
+            durationMs: Date.now() - startTime,
+        };
+    }
+    // Create the step body (strip forEach/as fields)
+    const bodySpec = { ...stepSpec };
+    delete bodySpec.forEach;
+    delete bodySpec.as;
+    const outputs = [];
+    const totalUsage = zeroUsage();
+    let failed = false;
+    for (let i = 0; i < array.length; i++) {
+        const element = array[i];
+        const iterStepName = `${stepName}[${i}]`;
+        // Create a scoped copy of state for this iteration
+        // The as binding and forEach metadata are added to a proxy state
+        // that exposes them in the expression scope
+        const iterState = {
+            ...state,
+            steps: { ...state.steps },
+            // Store forEach bindings that the executor can pick up
+            [asName]: element,
+            forEach: { index: i, length: array.length },
+        };
+        const cont = await executeSingleStep(iterStepName, bodySpec, iterState, options);
+        // Copy iteration results back to main state
+        const iterResult = iterState.steps[iterStepName];
+        if (iterResult) {
+            state.steps[iterStepName] = iterResult;
+            outputs.push(iterResult.output);
+            addUsage(totalUsage, iterResult.usage);
+        }
+        if (!cont || (iterResult && iterResult.status === "failed")) {
+            failed = true;
+            break;
+        }
+    }
+    const result = {
+        step: stepName,
+        agent: "forEach",
+        status: failed ? "failed" : "completed",
+        output: outputs,
+        textOutput: JSON.stringify(outputs, null, 2),
+        usage: totalUsage,
+        durationMs: Date.now() - startTime,
+        error: failed ? `forEach iteration failed` : undefined,
+    };
+    // Persist the collected output
+    if (options.runDir) {
+        const outputPath = stepSpec.output?.path ? String(resolveExpressions(stepSpec.output.path, scope)) : undefined;
+        result.outputPath = persistStepOutput(options.runDir, stepName, outputs, undefined, outputPath);
+    }
+    return result;
+}
+//# sourceMappingURL=step-foreach.js.map

package/dist/step-foreach.js.map

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

package/dist/step-gate.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Gate step executor — runs a shell command and passes/fails based on exit code.
+ */
+import type { GateSpec, StepResult } from "./types.js";
+/**
+ * Execute a gate step: runs a shell command, passes/fails based on exit code.
+ *
+ * The gate's check command is expected to already have ${{ }} expressions resolved
+ * before being passed here.
+ */
+export declare function executeGate(gate: GateSpec, stepName: string, options: {
+    cwd: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    runDir?: string;
+    outputPath?: string;
+}): Promise<StepResult>;
+//# sourceMappingURL=step-gate.d.ts.map

package/dist/step-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-gate.d.ts","sourceRoot":"","sources":["../src/step-gate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;GAKG;AACH,wBAAsB,WAAW,CAChC,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACtG,OAAO,CAAC,UAAU,CAAC,CAqHrB"}

package/dist/step-gate.js

@@ -0,0 +1,137 @@
+/**
+ * Gate step executor — runs a shell command and passes/fails based on exit code.
+ */
+import { persistStepOutput } from "./output.js";
+import { SIGKILL_GRACE_MS, zeroUsage } from "./step-shared.js";
+/**
+ * Execute a gate step: runs a shell command, passes/fails based on exit code.
+ *
+ * The gate's check command is expected to already have ${{ }} expressions resolved
+ * before being passed here.
+ */
+export async function executeGate(gate, stepName, options) {
+    const startTime = Date.now();
+    try {
+        const { spawn } = await import("node:child_process");
+        const output = await new Promise((resolve, reject) => {
+            const proc = spawn("sh", ["-c", gate.check], {
+                cwd: options.cwd,
+                stdio: ["ignore", "pipe", "pipe"],
+                detached: true,
+            });
+            let stdout = "";
+            let stderr = "";
+            let settled = false;
+            proc.stdout.on("data", (d) => {
+                stdout += d.toString();
+            });
+            proc.stderr.on("data", (d) => {
+                stderr += d.toString();
+            });
+            // Kill the entire process group (sh + children like sleep)
+            const killProc = () => {
+                if (!proc.pid)
+                    return;
+                try {
+                    process.kill(-proc.pid, "SIGTERM");
+                }
+                catch {
+                    /* already dead */
+                }
+                setTimeout(() => {
+                    if (!proc.pid)
+                        return;
+                    try {
+                        process.kill(-proc.pid, "SIGKILL");
+                    }
+                    catch {
+                        /* already dead */
+                    }
+                }, SIGKILL_GRACE_MS);
+            };
+            // Handle abort signal (from parallel cancellation or timeout)
+            const onAbort = () => {
+                killProc();
+            };
+            if (options.signal) {
+                if (options.signal.aborted) {
+                    killProc();
+                }
+                else {
+                    options.signal.addEventListener("abort", onAbort, { once: true });
+                }
+            }
+            // Handle step-level timeout
+            let timeoutId;
+            if (options.timeoutMs) {
+                timeoutId = setTimeout(() => {
+                    killProc();
+                }, options.timeoutMs);
+            }
+            proc.on("close", (code) => {
+                if (settled)
+                    return;
+                settled = true;
+                if (timeoutId)
+                    clearTimeout(timeoutId);
+                if (options.signal)
+                    options.signal.removeEventListener("abort", onAbort);
+                if (code === 0) {
+                    resolve(stdout);
+                }
+                else {
+                    const err = new Error(`Process exited with code ${code}`);
+                    err.status = code;
+                    err.stdout = stdout;
+                    err.stderr = stderr;
+                    reject(err);
+                }
+            });
+            proc.on("error", (err) => {
+                if (settled)
+                    return;
+                settled = true;
+                if (timeoutId)
+                    clearTimeout(timeoutId);
+                if (options.signal)
+                    options.signal.removeEventListener("abort", onAbort);
+                reject(err);
+            });
+        });
+        const gateOutput = { passed: true, exitCode: 0, output: output.trim() };
+        const result = {
+            step: stepName,
+            agent: "gate",
+            status: "completed",
+            textOutput: output.trim(),
+            output: gateOutput,
+            usage: zeroUsage(),
+            durationMs: Date.now() - startTime,
+        };
+        if (options.runDir) {
+            result.outputPath = persistStepOutput(options.runDir, stepName, gateOutput, undefined, options.outputPath);
+        }
+        return result;
+    }
+    catch (err) {
+        const execErr = err;
+        const exitCode = execErr.status ?? 1;
+        const stderr = execErr.stderr?.trim() ?? "";
+        const stdout = execErr.stdout?.trim() ?? "";
+        const gateOutput = { passed: false, exitCode, output: stderr || stdout };
+        const result = {
+            step: stepName,
+            agent: "gate",
+            status: "completed",
+            textOutput: stderr || stdout,
+            output: gateOutput,
+            usage: zeroUsage(),
+            durationMs: Date.now() - startTime,
+        };
+        if (options.runDir) {
+            result.outputPath = persistStepOutput(options.runDir, stepName, gateOutput, undefined, options.outputPath);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=step-gate.js.map

package/dist/step-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-gate.js","sourceRoot":"","sources":["../src/step-gate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG/D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAChC,IAAc,EACd,QAAgB,EAChB,OAAwG;IAExG,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,IAAI,CAAC;QACJ,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC5D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE;gBAC5C,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;gBACjC,QAAQ,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;gBACpC,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YACxB,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;gBACpC,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YACxB,CAAC,CAAC,CAAC;YAEH,2DAA2D;YAC3D,MAAM,QAAQ,GAAG,GAAG,EAAE;gBACrB,IAAI,CAAC,IAAI,CAAC,GAAG;oBAAE,OAAO;gBACtB,IAAI,CAAC;oBACJ,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;gBACpC,CAAC;gBAAC,MAAM,CAAC;oBACR,kBAAkB;gBACnB,CAAC;gBACD,UAAU,CAAC,GAAG,EAAE;oBACf,IAAI,CAAC,IAAI,CAAC,GAAG;wBAAE,OAAO;oBACtB,IAAI,CAAC;wBACJ,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;oBACpC,CAAC;oBAAC,MAAM,CAAC;wBACR,kBAAkB;oBACnB,CAAC;gBACF,CAAC,EAAE,gBAAgB,CAAC,CAAC;YACtB,CAAC,CAAC;YAEF,8DAA8D;YAC9D,MAAM,OAAO,GAAG,GAAG,EAAE;gBACpB,QAAQ,EAAE,CAAC;YACZ,CAAC,CAAC;YACF,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpB,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBAC5B,QAAQ,EAAE,CAAC;gBACZ,CAAC;qBAAM,CAAC;oBACP,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBACnE,CAAC;YACF,CAAC;YAED,4BAA4B;YAC5B,IAAI,SAAoD,CAAC;YACzD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBACvB,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC3B,QAAQ,EAAE,CAAC;gBACZ,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YACvB,CAAC;YAED,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzB,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,IAAI,SAAS;oBAAE,YAAY,CAAC,SAAS,CAAC,CAAC;gBACvC,IAAI,OAAO,CAAC,MAAM;oBAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACzE,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBAChB,OAAO,CAAC,MAAM,CAAC,CAAC;gBACjB,CAAC;qBAAM,CAAC;oBACP,MAAM,GAAG,GAAQ,IAAI,KAAK,CAAC,4BAA4B,IAAI,EAAE,CAAC,CAAC;oBAC/D,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC;oBAClB,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;oBACpB,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;oBACpB,MAAM,CAAC,GAAG,CAAC,CAAC;gBACb,CAAC;YACF,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACxB,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,IAAI,SAAS;oBAAE,YAAY,CAAC,SAAS,CAAC,CAAC;gBACvC,IAAI,OAAO,CAAC,MAAM;oBAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACzE,MAAM,CAAC,GAAG,CAAC,CAAC;YACb,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACxE,MAAM,MAAM,GAAe;YAC1B,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,WAAW;YACnB,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE;YACzB,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,SAAS,EAAE;YAClB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SAClC,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,CAAC,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QAC5G,CAAC;QACD,OAAO,MAAM,CAAC;IACf,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,GAA4D,CAAC;QAC7E,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC5C,MAAM,UAAU,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,IAAI,MAAM,EAAE,CAAC;QACzE,MAAM,MAAM,GAAe;YAC1B,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,WAAW;YACnB,UAAU,EAAE,MAAM,IAAI,MAAM;YAC5B,MAAM,EAAE,UAAU;YAClB,KAAK,EAAE,SAAS,EAAE;YAClB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SAClC,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,CAAC,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QAC5G,CAAC;QACD,OAAO,MAAM,CAAC;IACf,CAAC;AACF,CAAC"}

package/dist/step-loop.d.ts

@@ -0,0 +1,32 @@
+import type nunjucks from "nunjucks";
+import type { AgentSpec, ExecutionState, LoopSpec, StepResult, StepSpec, WorkflowSpec } from "./types.js";
+/** Options for executeLoop, including callback-injected dispatch to avoid circular imports. */
+export interface LoopExecuteOptions {
+    ctx: any;
+    pi: any;
+    signal?: AbortSignal;
+    loadAgent: (name: string) => AgentSpec;
+    dispatchAgent: (stepSpec: StepSpec, agentSpec: AgentSpec, prompt: string, opts: {
+        cwd: string;
+        sessionLogDir: string;
+        stepName: string;
+        signal?: AbortSignal;
+    }) => Promise<StepResult>;
+    runDir: string;
+    spec: WorkflowSpec;
+    templateEnv?: nunjucks.Environment;
+    outputPath?: string;
+}
+/**
+ * Execute a loop step: runs sub-steps repeatedly until a gate breaks,
+ * max attempts is reached, or a step fails.
+ *
+ * Loop sub-steps can be agent, gate, or transform steps.
+ * Gates inside loops support onPass: "break" (stop looping on success)
+ * and onFail: "continue" (retry on failure, the default inside loops).
+ *
+ * The loop scope provides ${{ loop.iteration }}, ${{ loop.maxAttempts }},
+ * and ${{ loop.priorAttempts }} for expression resolution inside sub-steps.
+ */
+export declare function executeLoop(loopSpec: LoopSpec, stepName: string, state: ExecutionState, options: LoopExecuteOptions): Promise<StepResult>;
+//# sourceMappingURL=step-loop.d.ts.map

package/dist/step-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-loop.d.ts","sourceRoot":"","sources":["../src/step-loop.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AAMrC,OAAO,KAAK,EACX,SAAS,EACT,cAAc,EAEd,QAAQ,EACR,UAAU,EACV,QAAQ,EAER,YAAY,EACZ,MAAM,YAAY,CAAC;AAEpB,+FAA+F;AAC/F,MAAM,WAAW,kBAAkB;IAClC,GAAG,EAAE,GAAG,CAAC;IACT,EAAE,EAAE,GAAG,CAAC;IACR,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC;IACvC,aAAa,EAAE,CACd,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAChF,OAAO,CAAC,UAAU,CAAC,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAChC,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,kBAAkB,GACzB,OAAO,CAAC,UAAU,CAAC,CAiRrB"}