@davidorex/pi-workflows 0.2.0 → 0.3.1

package/dist/step-monitor.js

@@ -0,0 +1,317 @@
+/**
+ * Monitor step executor — runs a monitor's classification as a workflow
+ * verification gate. Lightweight: reads monitor spec, loads patterns,
+ * renders prompt (Nunjucks or inline), calls LLM, parses verdict.
+ *
+ * Does NOT depend on pi-behavior-monitors — implements just enough to
+ * classify. No event handling, steering, ceiling, or escalation.
+ */
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { complete } from "@mariozechner/pi-ai";
+import nunjucks from "nunjucks";
+import { persistStepOutput } from "./output.js";
+import { zeroUsage } from "./step-shared.js";
+// ── Discovery ────────────────────────────────────────────────────────────────
+/**
+ * Find a monitor spec by name. Searches:
+ *   1. .pi/monitors/ (project)
+ *   2. ~/.pi/agent/monitors/ (user)
+ *   3. pi-behavior-monitors examples (if installed as peer)
+ */
+export function findMonitorSpec(monitorName, cwd) {
+    const searchDirs = [
+        path.join(cwd, ".pi", "monitors"),
+        path.join(os.homedir(), ".pi", "agent", "monitors"),
+    ];
+    // Also check pi-behavior-monitors examples via node_modules
+    try {
+        const bmPath = require.resolve("@davidorex/pi-behavior-monitors/package.json", { paths: [cwd] });
+        searchDirs.push(path.join(path.dirname(bmPath), "examples"));
+    }
+    catch {
+        // pi-behavior-monitors not installed — skip
+    }
+    for (const dir of searchDirs) {
+        const filePath = path.join(dir, `${monitorName}.monitor.json`);
+        try {
+            const raw = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+            if (raw.name && raw.classify && raw.patterns?.path) {
+                return {
+                    spec: {
+                        name: raw.name,
+                        classify: {
+                            model: raw.classify.model ?? "claude-sonnet-4-20250514",
+                            context: Array.isArray(raw.classify.context) ? raw.classify.context : [],
+                            prompt: raw.classify.prompt ?? "",
+                            promptTemplate: typeof raw.classify.promptTemplate === "string" ? raw.classify.promptTemplate : undefined,
+                        },
+                        patterns: { path: raw.patterns.path },
+                        instructions: raw.instructions?.path ? { path: raw.instructions.path } : undefined,
+                    },
+                    dir,
+                };
+            }
+        }
+        catch {
+            // file doesn't exist or is invalid — try next
+        }
+    }
+    return null;
+}
+// ── Pattern & instruction loading ────────────────────────────────────────────
+function loadPatterns(dir, patternsPath) {
+    try {
+        const resolved = path.resolve(dir, patternsPath);
+        return JSON.parse(fs.readFileSync(resolved, "utf-8"));
+    }
+    catch {
+        return [];
+    }
+}
+function loadInstructions(dir, instructionsPath) {
+    if (!instructionsPath)
+        return [];
+    try {
+        const resolved = path.resolve(dir, instructionsPath);
+        return JSON.parse(fs.readFileSync(resolved, "utf-8"));
+    }
+    catch {
+        return [];
+    }
+}
+function formatPatterns(patterns) {
+    return patterns.map((p, i) => `${i + 1}. [${p.severity ?? "warning"}] ${p.description}`).join("\n");
+}
+function formatInstructions(instructions) {
+    if (instructions.length === 0)
+        return "";
+    const lines = instructions.map((i) => `- ${i.text}`).join("\n");
+    return `\nOperating instructions from the user (follow these strictly):\n${lines}\n`;
+}
+// ── Template rendering ───────────────────────────────────────────────────────
+function createTemplateEnv(cwd) {
+    const searchPaths = [];
+    const projectDir = path.join(cwd, ".pi", "monitors");
+    const userDir = path.join(os.homedir(), ".pi", "agent", "monitors");
+    if (fs.existsSync(projectDir))
+        searchPaths.push(projectDir);
+    if (fs.existsSync(userDir))
+        searchPaths.push(userDir);
+    // pi-behavior-monitors examples
+    try {
+        const bmPath = require.resolve("@davidorex/pi-behavior-monitors/package.json", { paths: [cwd] });
+        const exDir = path.join(path.dirname(bmPath), "examples");
+        if (fs.existsSync(exDir))
+            searchPaths.push(exDir);
+    }
+    catch {
+        /* not installed */
+    }
+    const loader = searchPaths.length > 0 ? new nunjucks.FileSystemLoader(searchPaths) : undefined;
+    return new nunjucks.Environment(loader, { autoescape: false, throwOnUndefined: false });
+}
+function renderPrompt(spec, dir, input, templateEnv) {
+    const patterns = loadPatterns(dir, spec.patterns.path);
+    if (patterns.length === 0)
+        return null;
+    const instructions = loadInstructions(dir, spec.instructions?.path);
+    // Build context: patterns, instructions, plus any input fields
+    const context = {
+        patterns: formatPatterns(patterns),
+        instructions: formatInstructions(instructions),
+        iteration: 0,
+        ...input,
+    };
+    if (spec.classify.promptTemplate) {
+        try {
+            return templateEnv.render(spec.classify.promptTemplate, context);
+        }
+        catch {
+            // Fall through to inline prompt
+            if (!spec.classify.prompt)
+                return null;
+        }
+    }
+    if (!spec.classify.prompt)
+        return null;
+    return spec.classify.prompt.replace(/\{(\w+)\}/g, (match, key) => {
+        return String(context[key] ?? match);
+    });
+}
+// ── Verdict parsing ──────────────────────────────────────────────────────────
+function parseVerdict(raw) {
+    const text = raw.trim();
+    if (text.startsWith("CLEAN"))
+        return { verdict: "clean" };
+    if (text.startsWith("NEW:")) {
+        const rest = text.slice(4);
+        const pipe = rest.indexOf("|");
+        if (pipe !== -1) {
+            return { verdict: "new", pattern: rest.slice(0, pipe).trim(), description: rest.slice(pipe + 1).trim() };
+        }
+        return { verdict: "new", pattern: rest.trim(), description: rest.trim() };
+    }
+    if (text.startsWith("FLAG:"))
+        return { verdict: "flag", description: text.slice(5).trim() };
+    return { verdict: "clean" };
+}
+function extractText(parts) {
+    return parts
+        .filter((b) => b.type === "text")
+        .map((b) => b.text)
+        .join("");
+}
+/**
+ * Execute a monitor step: discover monitor, render prompt, classify, return verdict.
+ *
+ * - CLEAN → status: "completed", output: { verdict: "clean" }
+ * - FLAG  → status: "failed",    output: { verdict: "flag", description }
+ * - NEW   → status: "failed",    output: { verdict: "new", pattern, description }
+ */
+export async function executeMonitor(monitorName, stepName, input, options) {
+    const startTime = Date.now();
+    // 1. Discover monitor
+    const found = findMonitorSpec(monitorName, options.cwd);
+    if (!found) {
+        return {
+            step: stepName,
+            agent: `monitor:${monitorName}`,
+            status: "failed",
+            usage: zeroUsage(),
+            durationMs: Date.now() - startTime,
+            error: `Monitor '${monitorName}' not found`,
+        };
+    }
+    const { spec, dir } = found;
+    // 2. Render prompt
+    const templateEnv = createTemplateEnv(options.cwd);
+    const prompt = renderPrompt(spec, dir, input, templateEnv);
+    if (!prompt) {
+        return {
+            step: stepName,
+            agent: `monitor:${monitorName}`,
+            status: "completed",
+            output: { verdict: "clean", note: "No patterns loaded — nothing to classify" },
+            textOutput: "CLEAN (no patterns)",
+            usage: zeroUsage(),
+            durationMs: Date.now() - startTime,
+        };
+    }
+    // 3. Resolve model
+    const { provider, modelId } = parseModelSpec(spec.classify.model);
+    const model = options.ctx.modelRegistry.find(provider, modelId);
+    if (!model) {
+        return {
+            step: stepName,
+            agent: `monitor:${monitorName}`,
+            status: "failed",
+            usage: zeroUsage(),
+            durationMs: Date.now() - startTime,
+            error: `Model '${spec.classify.model}' not found in registry`,
+        };
+    }
+    const apiKey = await options.ctx.modelRegistry.getApiKey(model);
+    if (!apiKey) {
+        return {
+            step: stepName,
+            agent: `monitor:${monitorName}`,
+            status: "failed",
+            usage: zeroUsage(),
+            durationMs: Date.now() - startTime,
+            error: `No API key for model '${spec.classify.model}'`,
+        };
+    }
+    // 4. Classify
+    let response;
+    try {
+        response = await complete(model, { messages: [{ role: "user", content: [{ type: "text", text: prompt }], timestamp: Date.now() }] }, { apiKey, maxTokens: 150, signal: options.signal });
+    }
+    catch (err) {
+        if (options.signal?.aborted) {
+            return {
+                step: stepName,
+                agent: `monitor:${monitorName}`,
+                status: "failed",
+                usage: zeroUsage(),
+                durationMs: Date.now() - startTime,
+                error: "Monitor classification cancelled",
+            };
+        }
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            step: stepName,
+            agent: `monitor:${monitorName}`,
+            status: "failed",
+            usage: zeroUsage(),
+            durationMs: Date.now() - startTime,
+            error: `Classification failed: ${msg}`,
+        };
+    }
+    // 5. Parse verdict
+    const rawText = extractText(response.content);
+    const verdict = parseVerdict(rawText);
+    const durationMs = Date.now() - startTime;
+    // Estimate usage from response
+    const usage = zeroUsage();
+    // Token counts not directly available from complete() — leave as zero
+    const output = {
+        verdict: verdict.verdict,
+        ...(verdict.description ? { description: verdict.description } : {}),
+        ...(verdict.pattern ? { pattern: verdict.pattern } : {}),
+    };
+    const result = {
+        step: stepName,
+        agent: `monitor:${monitorName}`,
+        status: verdict.verdict === "clean" ? "completed" : "failed",
+        output,
+        textOutput: rawText.trim(),
+        usage,
+        durationMs,
+        ...(verdict.verdict !== "clean" ? { error: verdict.description ?? "Monitor flagged an issue" } : {}),
+    };
+    if (options.runDir) {
+        result.outputPath = persistStepOutput(options.runDir, stepName, output, rawText.trim(), options.outputPath);
+    }
+    return result;
+}
+// ── Utility ──────────────────────────────────────────────────────────────────
+function parseModelSpec(spec) {
+    const slashIndex = spec.indexOf("/");
+    if (slashIndex !== -1) {
+        return { provider: spec.slice(0, slashIndex), modelId: spec.slice(slashIndex + 1) };
+    }
+    return { provider: "anthropic", modelId: spec };
+}
+/**
+ * List all discoverable monitor names for validation.
+ */
+export function availableMonitors(cwd) {
+    const searchDirs = [
+        path.join(cwd, ".pi", "monitors"),
+        path.join(os.homedir(), ".pi", "agent", "monitors"),
+    ];
+    try {
+        const bmPath = require.resolve("@davidorex/pi-behavior-monitors/package.json", { paths: [cwd] });
+        searchDirs.push(path.join(path.dirname(bmPath), "examples"));
+    }
+    catch {
+        /* not installed */
+    }
+    const seen = new Set();
+    for (const dir of searchDirs) {
+        try {
+            for (const file of fs.readdirSync(dir)) {
+                if (file.endsWith(".monitor.json")) {
+                    seen.add(file.replace(".monitor.json", ""));
+                }
+            }
+        }
+        catch {
+            /* dir doesn't exist */
+        }
+    }
+    return Array.from(seen).sort();
+}
+//# sourceMappingURL=step-monitor.js.map

package/dist/step-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-monitor.js","sourceRoot":"","sources":["../src/step-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAqC7C,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,GAAW;IAC/D,MAAM,UAAU,GAAG;QAClB,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC;KACnD,CAAC;IAEF,4DAA4D;IAC5D,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,8CAA8C,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACR,4CAA4C;IAC7C,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,eAAe,CAAC,CAAC;QAC/D,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;YAC3D,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;gBACpD,OAAO;oBACN,IAAI,EAAE;wBACL,IAAI,EAAE,GAAG,CAAC,IAAI;wBACd,QAAQ,EAAE;4BACT,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,0BAA0B;4BACvD,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;4BACxE,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE;4BACjC,cAAc,EACb,OAAO,GAAG,CAAC,QAAQ,CAAC,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS;yBAC1F;wBACD,QAAQ,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE;wBACrC,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;qBAClF;oBACD,GAAG;iBACH,CAAC;YACH,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,8CAA8C;QAC/C,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,gFAAgF;AAEhF,SAAS,YAAY,CAAC,GAAW,EAAE,YAAoB;IACtD,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,CAAC;IACX,CAAC;AACF,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW,EAAE,gBAAyB;IAC/D,IAAI,CAAC,gBAAgB;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,CAAC;IACX,CAAC;AACF,CAAC;AAED,SAAS,cAAc,CAAC,QAA0B;IACjD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,IAAI,SAAS,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrG,CAAC;AAED,SAAS,kBAAkB,CAAC,YAAkC;IAC7D,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChE,OAAO,oEAAoE,KAAK,IAAI,CAAC;AACtF,CAAC;AAED,gFAAgF;AAEhF,SAAS,iBAAiB,CAAC,GAAW;IACrC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAEpE,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5D,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEtD,gCAAgC;IAChC,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,8CAA8C,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjG,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC;QAC1D,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACR,mBAAmB;IACpB,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/F,OAAO,IAAI,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,YAAY,CACpB,IAAiB,EACjB,GAAW,EACX,KAA8B,EAC9B,WAAiC;IAEjC,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,MAAM,YAAY,GAAG,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAEpE,+DAA+D;IAC/D,MAAM,OAAO,GAA4B;QACxC,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC;QAClC,YAAY,EAAE,kBAAkB,CAAC,YAAY,CAAC;QAC9C,SAAS,EAAE,CAAC;QACZ,GAAG,KAAK;KACR,CAAC;IAEF,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;QAClC,IAAI,CAAC;YACJ,OAAO,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAClE,CAAC;QAAC,MAAM,CAAC;YACR,gCAAgC;YAChC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC;QACxC,CAAC;IACF,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE;QACxE,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAEhF,SAAS,YAAY,CAAC,GAAW;IAChC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACxB,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAC1D,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1G,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;IAC3E,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAC5F,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED,SAAS,WAAW,CAAC,KAAkC;IACtD,OAAO,KAAK;SACV,MAAM,CAAC,CAAC,CAAC,EAAoB,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;SAClD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,IAAI,CAAC,EAAE,CAAC,CAAC;AACZ,CAAC;AAYD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,WAAmB,EACnB,QAAgB,EAChB,KAA8B,EAC9B,OAA2B;IAE3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,sBAAsB;IACtB,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACxD,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO;YACN,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,WAAW,WAAW,EAAE;YAC/B,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,SAAS,EAAE;YAClB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAClC,KAAK,EAAE,YAAY,WAAW,aAAa;SAC3C,CAAC;IACH,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;IAE5B,mBAAmB;IACnB,MAAM,WAAW,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IAC3D,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,OAAO;YACN,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,WAAW,WAAW,EAAE;YAC/B,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,0CAA0C,EAAE;YAC9E,UAAU,EAAE,qBAAqB;YACjC,KAAK,EAAE,SAAS,EAAE;YAClB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SAClC,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChE,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO;YACN,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,WAAW,WAAW,EAAE;YAC/B,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,SAAS,EAAE;YAClB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAClC,KAAK,EAAE,UAAU,IAAI,CAAC,QAAQ,CAAC,KAAK,yBAAyB;SAC7D,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,OAAO;YACN,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,WAAW,WAAW,EAAE;YAC/B,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,SAAS,EAAE;YAClB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAClC,KAAK,EAAE,yBAAyB,IAAI,CAAC,QAAQ,CAAC,KAAK,GAAG;SACtD,CAAC;IACH,CAAC;IAED,cAAc;IACd,IAAI,QAA0B,CAAC;IAC/B,IAAI,CAAC;QACJ,QAAQ,GAAG,MAAM,QAAQ,CACxB,KAAmB,EACnB,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAClG,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAClD,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YAC7B,OAAO;gBACN,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,WAAW,WAAW,EAAE;gBAC/B,MAAM,EAAE,QAAQ;gBAChB,KAAK,EAAE,SAAS,EAAE;gBAClB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBAClC,KAAK,EAAE,kCAAkC;aACzC,CAAC;QACH,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO;YACN,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,WAAW,WAAW,EAAE;YAC/B,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,SAAS,EAAE;YAClB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAClC,KAAK,EAAE,0BAA0B,GAAG,EAAE;SACtC,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAE1C,+BAA+B;IAC/B,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,sEAAsE;IAEtE,MAAM,MAAM,GAAG;QACd,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxD,CAAC;IAEF,MAAM,MAAM,GAAe;QAC1B,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,WAAW,WAAW,EAAE;QAC/B,MAAM,EAAE,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ;QAC5D,MAAM;QACN,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE;QAC1B,KAAK;QACL,UAAU;QACV,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,WAAW,IAAI,0BAA0B,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpG,CAAC;IAEF,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,CAAC,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7G,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC;AAED,gFAAgF;AAEhF,SAAS,cAAc,CAAC,IAAY;IACnC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC;IACrF,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC5C,MAAM,UAAU,GAAG;QAClB,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC;KACnD,CAAC;IAEF,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,8CAA8C,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACR,mBAAmB;IACpB,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,CAAC;YACJ,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxC,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;oBACpC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,CAAC;gBAC7C,CAAC;YACF,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,uBAAuB;QACxB,CAAC;IACF,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAChC,CAAC"}

package/dist/step-parallel.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Parallel step executors — concurrent step execution within a layer
+ * or within a single parallel step declaration.
+ */
+import type nunjucks from "nunjucks";
+import type { ExecutionLayer } from "./dag.js";
+import type { ProgressWidgetState } from "./tui.js";
+import type { ExecutionState, StepResult, StepSpec, WorkflowSpec } from "./types.js";
+/** Options shared by parallel execution helpers. */
+export interface ParallelOptions {
+    ctx: any;
+    pi: any;
+    signal?: AbortSignal;
+    loadAgent: (name: string) => any;
+    runDir: string;
+    spec: WorkflowSpec;
+    widgetState: ProgressWidgetState;
+    templateEnv?: nunjucks.Environment;
+}
+/** Callback type for executing a single step — injected to avoid circular imports. */
+export type SingleStepExecutor = (stepName: string, stepSpec: StepSpec, state: ExecutionState, options: ParallelOptions) => Promise<boolean>;
+/**
+ * Execute all steps in a layer concurrently.
+ *
+ * All steps start at the same time. If any step fails, remaining steps
+ * are cancelled via a shared AbortController. All results are collected
+ * before proceeding to the next layer.
+ *
+ * Parallel steps write to distinct keys in `state.steps`, which is safe
+ * in single-threaded Node.js. `writeState` uses atomic write (tmp + rename),
+ * so concurrent calls are safe — last one wins.
+ */
+export declare function executeParallelLayer(layer: ExecutionLayer, spec: WorkflowSpec, state: ExecutionState, executeSingleStep: SingleStepExecutor, options: ParallelOptions): Promise<void>;
+/**
+ * Execute a parallel step — runs all named sub-steps concurrently.
+ *
+ * Similar to executeParallelLayer but operates on sub-steps within
+ * a single declared step. The parallel step's result aggregates
+ * all sub-step results. Sub-step outputs are accessible via
+ * `${{ steps.<parallelStepName>.output.<subStepName> }}`.
+ */
+export declare function executeParallelStep(parallelSpec: Record<string, StepSpec>, stepName: string, state: ExecutionState, executeSingleStep: SingleStepExecutor, options: ParallelOptions): Promise<StepResult>;
+//# sourceMappingURL=step-parallel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"step-parallel.d.ts","sourceRoot":"","sources":["../src/step-parallel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAErF,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC/B,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,YAAY,CAAC;IACnB,WAAW,EAAE,mBAAmB,CAAC;IACjC,WAAW,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC;CACnC;AAED,sFAAsF;AACtF,MAAM,MAAM,kBAAkB,GAAG,CAChC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,eAAe,KACpB,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACzC,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,cAAc,EACrB,iBAAiB,EAAE,kBAAkB,EACrC,OAAO,EAAE,eAAe,GACtB,OAAO,CAAC,IAAI,CAAC,CA6Cf;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACxC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EACtC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,cAAc,EACrB,iBAAiB,EAAE,kBAAkB,EACrC,OAAO,EAAE,eAAe,GACtB,OAAO,CAAC,UAAU,CAAC,CA0DrB"}

package/dist/step-parallel.js

@@ -0,0 +1,122 @@
+/**
+ * Parallel step executors — concurrent step execution within a layer
+ * or within a single parallel step declaration.
+ */
+import { addUsage, WIDGET_ID, zeroUsage } from "./step-shared.js";
+import { createProgressWidget } from "./tui.js";
+/**
+ * Execute all steps in a layer concurrently.
+ *
+ * All steps start at the same time. If any step fails, remaining steps
+ * are cancelled via a shared AbortController. All results are collected
+ * before proceeding to the next layer.
+ *
+ * Parallel steps write to distinct keys in `state.steps`, which is safe
+ * in single-threaded Node.js. `writeState` uses atomic write (tmp + rename),
+ * so concurrent calls are safe — last one wins.
+ */
+export async function executeParallelLayer(layer, spec, state, executeSingleStep, options) {
+    const { ctx, signal, widgetState } = options;
+    // Create a child AbortController to cancel siblings on failure
+    const layerController = new AbortController();
+    if (signal) {
+        if (signal.aborted) {
+            layerController.abort(signal.reason);
+        }
+        else {
+            signal.addEventListener("abort", () => layerController.abort(signal.reason), { once: true });
+        }
+    }
+    // Update widget to show all parallel steps as running
+    widgetState.currentStep = layer.steps.join(", ");
+    if (ctx.hasUI) {
+        ctx.ui.setWidget(WIDGET_ID, createProgressWidget(widgetState));
+    }
+    // Launch all steps concurrently
+    const promises = layer.steps.map(async (stepName) => {
+        const stepSpec = spec.steps[stepName];
+        const success = await executeSingleStep(stepName, stepSpec, state, {
+            ...options,
+            signal: layerController.signal,
+        });
+        if (!success && !layerController.signal.aborted) {
+            layerController.abort(new Error(`Step '${stepName}' failed`));
+        }
+        return { stepName, success };
+    });
+    const results = await Promise.allSettled(promises);
+    // Check for failures
+    for (const result of results) {
+        if (result.status === "rejected") {
+            state.status = "failed";
+            break;
+        }
+        if (result.status === "fulfilled" && !result.value.success) {
+            state.status = "failed";
+            break;
+        }
+    }
+}
+/**
+ * Execute a parallel step — runs all named sub-steps concurrently.
+ *
+ * Similar to executeParallelLayer but operates on sub-steps within
+ * a single declared step. The parallel step's result aggregates
+ * all sub-step results. Sub-step outputs are accessible via
+ * `${{ steps.<parallelStepName>.output.<subStepName> }}`.
+ */
+export async function executeParallelStep(parallelSpec, stepName, state, executeSingleStep, options) {
+    const startTime = Date.now();
+    const { signal } = options;
+    const parallelController = new AbortController();
+    if (signal) {
+        if (signal.aborted) {
+            parallelController.abort(signal.reason);
+        }
+        else {
+            signal.addEventListener("abort", () => parallelController.abort(signal.reason), { once: true });
+        }
+    }
+    // Sub-steps share the outer state for reading but write to their own keys
+    const subResults = {};
+    const subPromises = Object.entries(parallelSpec).map(async ([subName, subSpec]) => {
+        const success = await executeSingleStep(subName, subSpec, state, {
+            ...options,
+            signal: parallelController.signal,
+        });
+        subResults[subName] = state.steps[subName];
+        if (!success && !parallelController.signal.aborted) {
+            parallelController.abort(new Error(`Sub-step '${subName}' failed`));
+        }
+        return success;
+    });
+    const settled = await Promise.allSettled(subPromises);
+    // Aggregate usage and outputs
+    const totalUsage = zeroUsage();
+    const subOutputs = {};
+    let anyFailed = false;
+    for (const [subName] of Object.entries(parallelSpec)) {
+        const sub = subResults[subName];
+        if (sub) {
+            addUsage(totalUsage, sub.usage);
+            subOutputs[subName] = sub.output ?? sub.textOutput;
+            if (sub.status === "failed")
+                anyFailed = true;
+        }
+    }
+    // Check for rejected promises too
+    for (const s of settled) {
+        if (s.status === "rejected")
+            anyFailed = true;
+    }
+    return {
+        step: stepName,
+        agent: "parallel",
+        status: anyFailed ? "failed" : "completed",
+        output: subOutputs,
+        textOutput: JSON.stringify(subOutputs, null, 2),
+        usage: totalUsage,
+        durationMs: Date.now() - startTime,
+    };
+}
+//# sourceMappingURL=step-parallel.js.map

package/dist/step-parallel.js.map

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

package/{src/step-pause.ts → dist/step-pause.d.ts}

@@ -2,8 +2,7 @@
  * Pause step executor — halts workflow execution at a deliberate checkpoint.
  * The workflow can be resumed later via /workflow resume or Ctrl+J.
  */
-import type { StepResult, StepUsage } from "./types.ts";
-
+import type { StepResult } from "./types.js";
 /**
  * Execute a pause step.
  *
@@ -14,14 +13,5 @@ import type { StepResult, StepUsage } from "./types.ts";
  * @param message - optional message to display (from pause field)
  * @returns StepResult with status "completed"
  */
-export function executePause(stepName: string, message?: string): StepResult {
-  return {
-    step: stepName,
-    agent: "pause",
-    status: "completed",
-    output: message ? { message } : undefined,
-    textOutput: message || "Workflow paused",
-    usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0, turns: 0 } as StepUsage,
-    durationMs: 0,
-  };
-}
+export declare function executePause(stepName: string, message?: string): StepResult;
+//# sourceMappingURL=step-pause.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"step-pause.d.ts","sourceRoot":"","sources":["../src/step-pause.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,YAAY,CAAC;AAExD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAU3E"}

package/dist/step-pause.js

@@ -0,0 +1,22 @@
+/**
+ * Execute a pause step.
+ *
+ * Returns a completed result immediately. The executor is responsible
+ * for setting state.status = "paused" and stopping the loop.
+ *
+ * @param stepName - name of the pause step
+ * @param message - optional message to display (from pause field)
+ * @returns StepResult with status "completed"
+ */
+export function executePause(stepName, message) {
+    return {
+        step: stepName,
+        agent: "pause",
+        status: "completed",
+        output: message ? { message } : undefined,
+        textOutput: message || "Workflow paused",
+        usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0, turns: 0 },
+        durationMs: 0,
+    };
+}
+//# sourceMappingURL=step-pause.js.map

package/dist/step-pause.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-pause.js","sourceRoot":"","sources":["../src/step-pause.ts"],"names":[],"mappings":"AAMA;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,OAAgB;IAC9D,OAAO;QACN,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,WAAW;QACnB,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS;QACzC,UAAU,EAAE,OAAO,IAAI,iBAAiB;QACxC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAe;QAC3F,UAAU,EAAE,CAAC;KACb,CAAC;AACH,CAAC"}

package/dist/step-shared.d.ts

@@ -0,0 +1,63 @@
+import type nunjucks from "nunjucks";
+import type { ProgressWidgetState } from "./tui.js";
+import type { AgentSpec, ExecutionState, StepResult, StepUsage } from "./types.js";
+/** Grace period (ms) between SIGTERM and SIGKILL when killing subprocesses. */
+export declare const SIGKILL_GRACE_MS = 3000;
+/** Widget ID used for the workflow progress widget. */
+export declare const WIDGET_ID = "workflow-progress";
+/** Default max loop attempts when not specified. */
+export declare const DEFAULT_MAX_ATTEMPTS = 3;
+/**
+ * Helper that returns a StepUsage with all zeroes.
+ */
+export declare function zeroUsage(): StepUsage;
+/**
+ * Add step usage into a running total (mutates `total`).
+ */
+export declare function addUsage(total: StepUsage, step: StepUsage): void;
+/**
+ * Resolve a schema path to an absolute filesystem path.
+ *
+ * Three resolution modes:
+ * - Absolute paths: returned as-is
+ * - `block:<name>` prefix: resolves to `.project/schemas/<name>.schema.json` from cwd.
+ *   This is the portable way to reference project block schemas from any workflow or
+ *   agent spec regardless of package install location. Uses the user's actual schemas
+ *   (which may be customized).
+ * - Relative paths: resolved against the directory containing the spec file
+ */
+export declare function resolveSchemaPath(schemaPath: string, specFilePath: string, cwd?: string): string;
+/**
+ * Build the prompt string sent to the subprocess.
+ *
+ * The prompt includes:
+ * 1. The compiled task template (if set), or the resolved input as context
+ * 2. Output instructions (if schema-bound)
+ */
+export declare function buildPrompt(step: {
+    agent?: string;
+    input?: Record<string, unknown>;
+    output?: {
+        format?: string;
+        schema?: string;
+    };
+}, agentSpec: AgentSpec, resolvedInput: unknown, runDir: string, stepName: string, cwd?: string): string;
+/**
+ * Persist step result to state and update TUI widget.
+ * Replaces the repeated writeState + setWidget pattern.
+ */
+export declare function persistStep(state: ExecutionState, stepName: string, result: StepResult, runDir: string, widgetState: ProgressWidgetState, ctx: {
+    hasUI: boolean;
+    ui: {
+        setWidget(id: string, w: unknown): void;
+        notify?(msg: string, level: string): void;
+    };
+}): void;
+/**
+ * Compile an agent spec: render system and task templates through Nunjucks.
+ *
+ * Every agent's prompts go through Nunjucks. Plain text without template
+ * tags renders to itself. The .md that pi receives is compiled output.
+ */
+export declare function compileAgentSpec(agentSpec: AgentSpec, resolvedInput: unknown, templateEnv?: nunjucks.Environment): AgentSpec;
+//# sourceMappingURL=step-shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"step-shared.d.ts","sourceRoot":"","sources":["../src/step-shared.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AAGrC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEnF,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,uDAAuD;AACvD,eAAO,MAAM,SAAS,sBAAsB,CAAC;AAE7C,oDAAoD;AACpD,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC;;GAEG;AACH,wBAAgB,SAAS,IAAI,SAAS,CAErC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAOhE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAQhG;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAC1B,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EACxG,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,OAAO,EACtB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,MAAM,GACV,MAAM,CA2BR;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAC1B,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,mBAAmB,EAChC,GAAG,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE;QAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,GACjH,IAAI,CAgBN;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC/B,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,OAAO,EACtB,WAAW,CAAC,EAAE,QAAQ,CAAC,WAAW,GAChC,SAAS,CAwBX"}