@davidorex/pi-workflows 0.2.0 → 0.3.1

package/dist/step-agent.js

@@ -0,0 +1,171 @@
+/**
+ * Agent step executor — dispatches an LLM subprocess and validates output.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { validateFromFile } from "@davidorex/pi-project/src/schema-validator.js";
+import { dispatch } from "./dispatch.js";
+import { resolveExpressions } from "./expression.js";
+import { persistStepOutput } from "./output.js";
+import { buildPrompt, compileAgentSpec, resolveSchemaPath, zeroUsage } from "./step-shared.js";
+/**
+ * Execute an agent step: resolve input, render templates, dispatch subprocess,
+ * validate output, persist result.
+ *
+ * Returns the StepResult.
+ */
+export async function executeAgentStep(stepName, stepSpec, state, options) {
+    const { ctx, signal, loadAgent, runDir, specFilePath, templateEnv } = options;
+    const agentName = stepSpec.agent;
+    const scope = { input: state.input, steps: state.steps };
+    // Expose forEach bindings (as name + forEach metadata) if present on the state
+    const stateAny = state;
+    if (stateAny.forEach !== undefined) {
+        scope.forEach = stateAny.forEach;
+    }
+    for (const key of Object.keys(stateAny)) {
+        if (key !== "input" &&
+            key !== "steps" &&
+            key !== "status" &&
+            key !== "loop" &&
+            key !== "workflowName" &&
+            key !== "specVersion" &&
+            key !== "startedAt" &&
+            key !== "updatedAt" &&
+            key !== "forEach") {
+            scope[key] = stateAny[key];
+        }
+    }
+    // Resolve input expressions
+    let resolvedInput;
+    try {
+        resolvedInput = resolveExpressions(stepSpec.input ?? {}, scope);
+    }
+    catch (err) {
+        return {
+            step: stepName,
+            agent: agentName,
+            status: "failed",
+            usage: zeroUsage(),
+            durationMs: 0,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+    // Load and optionally render agent template
+    let agentSpec;
+    try {
+        agentSpec = loadAgent(agentName);
+    }
+    catch (err) {
+        return {
+            step: stepName,
+            agent: agentName,
+            status: "failed",
+            usage: zeroUsage(),
+            durationMs: 0,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+    // Inject output schema into template context if available
+    if (stepSpec.output?.schema && typeof resolvedInput === "object" && resolvedInput !== null) {
+        const schemaPath = resolveSchemaPath(stepSpec.output.schema, options.specFilePath, options.ctx.cwd);
+        try {
+            const schemaContent = fs.readFileSync(schemaPath, "utf8");
+            resolvedInput.output_schema = schemaContent;
+        }
+        catch {
+            /* schema file not found — template can still render without it */
+        }
+    }
+    agentSpec = compileAgentSpec(agentSpec, resolvedInput, templateEnv);
+    let prompt = buildPrompt(stepSpec, agentSpec, resolvedInput, runDir, stepName, ctx.cwd);
+    // Inject context from prior steps (narrative text inlining)
+    if (stepSpec.context && stepSpec.context.length > 0) {
+        const contextParts = [];
+        for (const ctxStepName of stepSpec.context) {
+            const ctxResult = state.steps[ctxStepName];
+            if (!ctxResult?.textOutput)
+                continue;
+            contextParts.push(`### ${ctxStepName}\n`);
+            contextParts.push(ctxResult.textOutput);
+            contextParts.push("");
+        }
+        if (contextParts.length > 0) {
+            prompt = `## Context from Prior Steps\n\n${contextParts.join("\n")}\n---\n\n${prompt}`;
+        }
+    }
+    // Inject retry context if this is a retry attempt
+    if (options.retryContext) {
+        const rc = options.retryContext;
+        const retryParts = [];
+        retryParts.push(`## Retry Context (attempt ${rc.attempt})\n`);
+        retryParts.push("Your previous attempt failed. The filesystem has been rolled back to its pre-attempt state.\n");
+        retryParts.push("### Prior Errors");
+        for (let i = 0; i < rc.priorErrors.length; i++) {
+            retryParts.push(`${i + 1}. ${rc.priorErrors[i]}`);
+        }
+        retryParts.push("");
+        if (rc.steeringMessage) {
+            retryParts.push("### Steering");
+            retryParts.push(rc.steeringMessage);
+            retryParts.push("");
+        }
+        retryParts.push("---\n");
+        prompt = retryParts.join("\n") + prompt;
+    }
+    const dispatchFn = options.dispatchFn ?? dispatch;
+    const result = await dispatchFn(stepSpec, agentSpec, prompt, {
+        cwd: ctx.cwd,
+        sessionLogDir: path.join(runDir, "sessions"),
+        stepName,
+        signal,
+        timeoutMs: stepSpec.timeout ? stepSpec.timeout.seconds * 1000 : undefined,
+        onEvent: (event) => {
+            if (event.type === "tool_execution_start" && event.toolName && options.onStepActivity) {
+                options.onStepActivity({
+                    tool: event.toolName,
+                    preview: event.toolArgs || "",
+                    timestamp: Date.now(),
+                });
+            }
+        },
+        modelConfig: options.modelConfig,
+    });
+    // Resolve output path from spec (may contain ${{ }} expressions)
+    const resolvedOutputPath = stepSpec.output?.path
+        ? String(resolveExpressions(stepSpec.output.path, scope))
+        : undefined;
+    // Validate output against schema (if defined)
+    if (stepSpec.output?.schema && result.status === "completed") {
+        const schemaPath = resolveSchemaPath(stepSpec.output.schema, specFilePath, ctx.cwd);
+        try {
+            const outputFilePath = path.join(runDir, "outputs", `${stepName}.json`);
+            if (fs.existsSync(outputFilePath)) {
+                const rawOutput = JSON.parse(fs.readFileSync(outputFilePath, "utf-8"));
+                validateFromFile(schemaPath, rawOutput, `step output for '${stepName}'`);
+                result.output = rawOutput;
+            }
+            else {
+                try {
+                    const parsed = JSON.parse(result.textOutput || "");
+                    validateFromFile(schemaPath, parsed, `step output for '${stepName}'`);
+                    result.output = parsed;
+                    result.outputPath = persistStepOutput(runDir, stepName, parsed, undefined, resolvedOutputPath);
+                }
+                catch {
+                    result.status = "failed";
+                    result.error = `Step '${stepName}' has output schema but no valid JSON output was produced`;
+                }
+            }
+        }
+        catch (err) {
+            result.status = "failed";
+            result.error = err instanceof Error ? err.message : String(err);
+        }
+    }
+    else {
+        result.outputPath = persistStepOutput(runDir, stepName, result.output, result.textOutput, resolvedOutputPath);
+    }
+    return result;
+}
+//# sourceMappingURL=step-agent.js.map

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"}