@davidorex/pi-workflows 0.2.0 → 0.3.0

package/{src/template.ts → dist/template.js}

@@ -3,11 +3,10 @@
  * Provides three-tier template resolution (project > user > builtin)
  * and renders agent system prompts with step input as context.
  */
-import nunjucks from "nunjucks";
-import path from "node:path";
-import os from "node:os";
 import fs from "node:fs";
-
+import os from "node:os";
+import path from "node:path";
+import nunjucks from "nunjucks";
 /**
  * Create a Nunjucks environment with three-tier template resolution.
  *
@@ -21,32 +20,28 @@ import fs from "node:fs";
  * @param cwd - project root directory
  * @param builtinDir - optional path to builtin templates (defaults to templates/ relative to package root)
  */
-export function createTemplateEnv(cwd: string, builtinDir?: string): nunjucks.Environment {
-  const projectDir = path.join(cwd, ".pi", "templates");
-  const userDir = path.join(os.homedir(), ".pi", "agent", "templates");
-  const defaultBuiltinDir = builtinDir ?? path.resolve(import.meta.dirname, "..", "templates");
-
-  // Nunjucks FileSystemLoader searches directories in order — first match wins.
-  // Only include directories that exist to avoid noisy warnings.
-  const searchPaths: string[] = [];
-  if (fs.existsSync(projectDir)) searchPaths.push(projectDir);
-  if (fs.existsSync(userDir)) searchPaths.push(userDir);
-  if (fs.existsSync(defaultBuiltinDir)) searchPaths.push(defaultBuiltinDir);
-
-  // If no template directories exist, use a no-op loader — plain text passes through.
-  const loader = searchPaths.length > 0
-    ? new nunjucks.FileSystemLoader(searchPaths)
-    : undefined;
-
-  return new nunjucks.Environment(loader, {
-    autoescape: false,
-    throwOnUndefined: false,
-  });
+export function createTemplateEnv(cwd, builtinDir) {
+    const projectDir = path.join(cwd, ".pi", "templates");
+    const userDir = path.join(os.homedir(), ".pi", "agent", "templates");
+    const defaultBuiltinDir = builtinDir ?? path.resolve(import.meta.dirname, "..", "templates");
+    // Nunjucks FileSystemLoader searches directories in order — first match wins.
+    // Only include directories that exist to avoid noisy warnings.
+    const searchPaths = [];
+    if (fs.existsSync(projectDir))
+        searchPaths.push(projectDir);
+    if (fs.existsSync(userDir))
+        searchPaths.push(userDir);
+    if (fs.existsSync(defaultBuiltinDir))
+        searchPaths.push(defaultBuiltinDir);
+    // If no template directories exist, use a no-op loader — plain text passes through.
+    const loader = searchPaths.length > 0 ? new nunjucks.FileSystemLoader(searchPaths) : undefined;
+    return new nunjucks.Environment(loader, {
+        autoescape: false,
+        throwOnUndefined: false,
+    });
 }
-
 /** Sentinel used to protect ${{ }} workflow expressions from Nunjucks rendering. */
 const WORKFLOW_EXPR_PLACEHOLDER = "\x00__PI_WORKFLOW_EXPR__";
-
 /**
  * Render a template string through Nunjucks.
  *
@@ -61,18 +56,16 @@ const WORKFLOW_EXPR_PLACEHOLDER = "\x00__PI_WORKFLOW_EXPR__";
  * @param context - variables available in the template
  * @returns rendered string
  */
-export function renderTemplate(env: nunjucks.Environment, templateStr: string, context: Record<string, unknown>): string {
-  // Protect ${{ }} workflow expressions from Nunjucks
-  const escaped = templateStr.replace(/\$\{\{/g, WORKFLOW_EXPR_PLACEHOLDER);
-  const rendered = env.renderString(escaped, context);
-  return rendered.replace(new RegExp(escapeRegExp(WORKFLOW_EXPR_PLACEHOLDER), "g"), "${{");
+export function renderTemplate(env, templateStr, context) {
+    // Protect ${{ }} workflow expressions from Nunjucks
+    const escaped = templateStr.replace(/\$\{\{/g, WORKFLOW_EXPR_PLACEHOLDER);
+    const rendered = env.renderString(escaped, context);
+    return rendered.replace(new RegExp(escapeRegExp(WORKFLOW_EXPR_PLACEHOLDER), "g"), "${{");
 }
-
 /** Escape special regex characters in a string. */
-function escapeRegExp(s: string): string {
-  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-
 /**
  * Render a named template file through Nunjucks.
  *
@@ -87,6 +80,7 @@ function escapeRegExp(s: string): string {
  * @param context - variables available in the template
  * @returns rendered string
  */
-export function renderTemplateFile(env: nunjucks.Environment, templateName: string, context: Record<string, unknown>): string {
-  return env.render(templateName, context);
+export function renderTemplateFile(env, templateName, context) {
+    return env.render(templateName, context);
 }
+//# sourceMappingURL=template.js.map

package/dist/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,UAAmB;IACjE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IACrE,MAAM,iBAAiB,GAAG,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IAE7F,8EAA8E;IAC9E,+DAA+D;IAC/D,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,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;IACtD,IAAI,EAAE,CAAC,UAAU,CAAC,iBAAiB,CAAC;QAAE,WAAW,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAE1E,oFAAoF;IACpF,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE/F,OAAO,IAAI,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE;QACvC,UAAU,EAAE,KAAK;QACjB,gBAAgB,EAAE,KAAK;KACvB,CAAC,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,MAAM,yBAAyB,GAAG,0BAA0B,CAAC;AAE7D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAC7B,GAAyB,EACzB,WAAmB,EACnB,OAAgC;IAEhC,oDAAoD;IACpD,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpD,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,yBAAyB,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;AAC1F,CAAC;AAED,mDAAmD;AACnD,SAAS,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CACjC,GAAyB,EACzB,YAAoB,EACpB,OAAgC;IAEhC,OAAO,GAAG,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC"}

package/dist/test-helpers.d.ts

@@ -0,0 +1,17 @@
+import type { StepSpec, WorkflowSpec } from "./types.js";
+/**
+ * Create a mock extension context for testing.
+ */
+export declare function mockCtx(cwd: string): any;
+/**
+ * Create a mock pi API for testing.
+ */
+export declare function mockPi(): any;
+/**
+ * Create a minimal WorkflowSpec for testing.
+ * A fresh temp directory is created for filePath.
+ */
+export declare function makeSpec(overrides: Partial<WorkflowSpec> & {
+    steps: Record<string, StepSpec>;
+}): WorkflowSpec;
+//# sourceMappingURL=test-helpers.d.ts.map

package/dist/test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../src/test-helpers.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEzD;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAS7B,GAAG,CACR;AAED;;GAEG;AACH,wBAAgB,MAAM,IAKhB,GAAG,CACR;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;CAAE,GAAG,YAAY,CAU7G"}

package/dist/test-helpers.js

@@ -0,0 +1,46 @@
+/**
+ * Shared test helpers — mock factories for ctx, pi, and workflow specs.
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+/**
+ * Create a mock extension context for testing.
+ */
+export function mockCtx(cwd) {
+    return {
+        cwd,
+        hasUI: false,
+        ui: {
+            setWidget: () => { },
+            notify: () => { },
+            setStatus: () => { },
+        },
+    };
+}
+/**
+ * Create a mock pi API for testing.
+ */
+export function mockPi() {
+    const messages = [];
+    return {
+        sendMessage: (msg, opts) => messages.push({ msg, opts }),
+        _messages: messages,
+    };
+}
+/**
+ * Create a minimal WorkflowSpec for testing.
+ * A fresh temp directory is created for filePath.
+ */
+export function makeSpec(overrides) {
+    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "wf-test-"));
+    return {
+        name: "test-workflow",
+        description: "Test workflow",
+        version: "1",
+        source: "project",
+        filePath: path.join(tmpDir, "test.workflow.yaml"),
+        ...overrides,
+    };
+}
+//# sourceMappingURL=test-helpers.js.map

package/dist/test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../src/test-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW;IAClC,OAAO;QACN,GAAG;QACH,KAAK,EAAE,KAAK;QACZ,EAAE,EAAE;YACH,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC;YACnB,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;YAChB,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC;SACnB;KACM,CAAC;AACV,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM;IACrB,MAAM,QAAQ,GAAU,EAAE,CAAC;IAC3B,OAAO;QACN,WAAW,EAAE,CAAC,GAAQ,EAAE,IAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QAClE,SAAS,EAAE,QAAQ;KACZ,CAAC;AACV,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,SAAsE;IAC9F,MAAM,MAAM,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;IAClE,OAAO;QACN,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,eAAe;QAC5B,OAAO,EAAE,GAAG;QACZ,MAAM,EAAE,SAAkB;QAC1B,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,oBAAoB,CAAC;QACjD,GAAG,SAAS;KACZ,CAAC;AACH,CAAC"}

package/dist/tui.d.ts

@@ -0,0 +1,47 @@
+/**
+ * TUI progress widget for workflow execution.
+ * Shows step status, timing, cost, and parallel execution indicators.
+ */
+import type { Theme } from "@mariozechner/pi-coding-agent";
+import type { Component, TUI } from "@mariozechner/pi-tui";
+import type { ExecutionState, WorkflowSpec } from "./types.js";
+export interface StepActivity {
+    tool: string;
+    preview: string;
+    timestamp: number;
+}
+export interface StepOutputSummary {
+    tasks?: Array<{
+        name: string;
+        status: string;
+        files?: string[];
+    }>;
+    testCount?: number;
+    note?: string;
+}
+export interface ProgressWidgetState {
+    spec: WorkflowSpec;
+    state: ExecutionState;
+    currentStep?: string;
+    startTime: number;
+    parallelSubSteps?: Record<string, import("./types.js").StepResult>;
+    resumedSteps?: number;
+    activities: Map<string, StepActivity[]>;
+    outputSummaries: Map<string, StepOutputSummary>;
+}
+/**
+ * Create a widget factory for ctx.ui.setWidget().
+ * Returns a function that pi calls to get the component.
+ *
+ * The returned component renders a compact progress view:
+ *   ─────────────────────────────────────
+ *   ● bugfix  step 2/3              1m32s
+ *     ✓ diagnose     42s   $0.03  12k tok
+ *     ▸ fix           50s   8k tok...
+ *     · verify
+ *   ─────────────────────────────────────
+ */
+export declare function createProgressWidget(widgetState: ProgressWidgetState): (tui: TUI, theme: Theme) => Component & {
+    dispose?(): void;
+};
+//# sourceMappingURL=tui.d.ts.map

package/dist/tui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../src/tui.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAc,YAAY,EAAE,MAAM,YAAY,CAAC;AAE3E,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IACjC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,cAAc,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,YAAY,EAAE,UAAU,CAAC,CAAC;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IACxC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAChD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CACnC,WAAW,EAAE,mBAAmB,GAC9B,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,KAAK,SAAS,GAAG;IAAE,OAAO,CAAC,IAAI,IAAI,CAAA;CAAE,CAuI9D"}

package/dist/tui.js

@@ -0,0 +1,143 @@
+import { formatCost, formatDuration, formatTokens } from "./format.js";
+/**
+ * Create a widget factory for ctx.ui.setWidget().
+ * Returns a function that pi calls to get the component.
+ *
+ * The returned component renders a compact progress view:
+ *   ─────────────────────────────────────
+ *   ● bugfix  step 2/3              1m32s
+ *     ✓ diagnose     42s   $0.03  12k tok
+ *     ▸ fix           50s   8k tok...
+ *     · verify
+ *   ─────────────────────────────────────
+ */
+export function createProgressWidget(widgetState) {
+    return (tui, theme) => {
+        /** Pulse interval (ms) for the elapsed-time ticker. Balances update frequency vs overhead. */
+        const PULSE_INTERVAL_MS = 800;
+        let pulseOn = true;
+        const interval = setInterval(() => {
+            pulseOn = !pulseOn;
+            tui.requestRender();
+        }, PULSE_INTERVAL_MS);
+        return {
+            render(width) {
+                const lines = [];
+                const stepNames = Object.keys(widgetState.spec.steps);
+                const totalSteps = stepNames.length;
+                // Parse current steps (may be comma-separated for parallel)
+                const currentSteps = widgetState.currentStep?.split(", ") ?? [];
+                const parallelCount = currentSteps.length;
+                // Determine current step number
+                let currentStepNum = 0;
+                if (currentSteps.length > 0 && currentSteps[0]) {
+                    const idx = stepNames.indexOf(currentSteps[0]);
+                    currentStepNum = idx >= 0 ? idx + 1 : 0;
+                }
+                else {
+                    // Count completed steps
+                    currentStepNum = Object.values(widgetState.state.steps).filter((s) => s.status === "completed").length;
+                }
+                const elapsed = formatDuration(Date.now() - widgetState.startTime);
+                const workflowName = theme.bold(widgetState.spec.name);
+                const indicator = pulseOn ? theme.fg("accent", "\u25cf") : theme.fg("dim", "\u25cf");
+                const parallelTag = parallelCount > 1 ? ` [${parallelCount} parallel]` : "";
+                const headerLine = `${indicator} ${workflowName}  step ${currentStepNum}/${totalSteps}${parallelTag}  ${theme.fg("dim", elapsed)}`;
+                lines.push(headerLine.length > width ? headerLine.slice(0, width) : headerLine);
+                // Resumed indicator
+                if (widgetState.resumedSteps) {
+                    const resumedLine = `  ${theme.fg("dim", "\u21bb")} Resumed: ${widgetState.resumedSteps} steps from prior run`;
+                    lines.push(resumedLine.length > width ? resumedLine.slice(0, width) : resumedLine);
+                }
+                // Paused indicator
+                if (widgetState.state.status === "paused") {
+                    const pausedLine = `  ${theme.fg("accent", "\u23f8")} Paused`;
+                    lines.push(pausedLine.length > width ? pausedLine.slice(0, width) : pausedLine);
+                }
+                // Step lines
+                for (const stepName of stepNames) {
+                    const stepResult = widgetState.state.steps[stepName];
+                    let line;
+                    if (stepResult && stepResult.status === "skipped") {
+                        // Skipped step: ⊘ stepName [skipped]
+                        line = `  ${theme.fg("dim", "\u2298")} ${stepName} ${theme.fg("dim", "[skipped]")}`;
+                    }
+                    else if (stepResult && stepResult.status === "completed") {
+                        const dur = formatDuration(stepResult.durationMs);
+                        const cost = formatCost(stepResult.usage.cost);
+                        const tok = formatTokens(stepResult.usage.input + stepResult.usage.output);
+                        // Show step type indicator for gate/transform
+                        const typeTag = stepResult.agent === "gate" ? " [gate]" : stepResult.agent === "transform" ? " [transform]" : "";
+                        const truncTag = stepResult.truncated ? ` ${theme.fg("warning", "[truncated]")}` : "";
+                        line = `  ${theme.fg("success", "\u2713")} ${stepName}${typeTag}  ${theme.fg("dim", dur)}  ${theme.fg("dim", cost)}  ${theme.fg("dim", tok)}${truncTag}`;
+                        lines.push(line.length > width ? line.slice(0, width) : line);
+                        // Render output summary sub-lines (capped at 3)
+                        const summary = widgetState.outputSummaries?.get(stepName);
+                        if (summary) {
+                            let summaryLines = 0;
+                            const MAX_SUMMARY_LINES = 3;
+                            if (summary.tasks) {
+                                for (const task of summary.tasks) {
+                                    if (summaryLines >= MAX_SUMMARY_LINES)
+                                        break;
+                                    const files = task.files?.join(", ") || "";
+                                    const statusIcon = task.status === "done" ? "\u2713" : task.status === "failed" ? "\u2717" : "\u00b7";
+                                    const taskLine = `      ${theme.fg("dim", statusIcon)} ${theme.fg("dim", task.name)}${files ? "  " + theme.fg("dim", files) : ""}`;
+                                    lines.push(taskLine.length > width ? taskLine.slice(0, width) : taskLine);
+                                    summaryLines++;
+                                }
+                            }
+                            if (summary.testCount && summaryLines < MAX_SUMMARY_LINES) {
+                                const testLine = `      ${theme.fg("dim", `${summary.testCount} tests pass`)}`;
+                                lines.push(testLine.length > width ? testLine.slice(0, width) : testLine);
+                                summaryLines++;
+                            }
+                            if (summary.note && summaryLines < MAX_SUMMARY_LINES) {
+                                const noteLine = `      ${theme.fg("dim", summary.note)}`;
+                                lines.push(noteLine.length > width ? noteLine.slice(0, width) : noteLine);
+                            }
+                        }
+                        continue; // skip the push below, already pushed
+                    }
+                    else if (stepResult && stepResult.status === "failed") {
+                        const dur = formatDuration(stepResult.durationMs);
+                        const errorPreview = stepResult.error || "Unknown error";
+                        line = `  ${theme.fg("error", "\u2717")} ${stepName}  ${theme.fg("dim", dur)}  ${errorPreview}`;
+                    }
+                    else if (stepResult && stepResult.agent === "parallel") {
+                        // Completed parallel step — show with sub-step count
+                        const dur = formatDuration(stepResult.durationMs);
+                        const cost = formatCost(stepResult.usage.cost);
+                        const tok = formatTokens(stepResult.usage.input + stepResult.usage.output);
+                        line = `  ${theme.fg("success", "\u2713")} ${stepName} [parallel]  ${theme.fg("dim", dur)}  ${theme.fg("dim", cost)}  ${theme.fg("dim", tok)}`;
+                    }
+                    else if (currentSteps.includes(stepName)) {
+                        const stepElapsed = formatDuration(Date.now() - widgetState.startTime);
+                        line = `  ${theme.fg("accent", "\u25b8")} ${theme.fg("accent", stepName)}  ${theme.fg("dim", stepElapsed + "...")}`;
+                        lines.push(line.length > width ? line.slice(0, width) : line);
+                        // Render most recent tool activity under running step
+                        const activities = widgetState.activities?.get(stepName);
+                        if (activities && activities.length > 0) {
+                            const latest = activities[activities.length - 1];
+                            const actLine = `      ${theme.fg("dim", latest.tool)} ${theme.fg("dim", latest.preview)}`;
+                            lines.push(actLine.length > width ? actLine.slice(0, width) : actLine);
+                        }
+                        continue; // skip the push below, already pushed
+                    }
+                    else {
+                        line = `  ${theme.fg("dim", "\u00b7")} ${stepName}`;
+                    }
+                    lines.push(line.length > width ? line.slice(0, width) : line);
+                }
+                return lines;
+            },
+            invalidate() {
+                /* no cached state to clear */
+            },
+            dispose() {
+                clearInterval(interval);
+            },
+        };
+    };
+}
+//# sourceMappingURL=tui.js.map

package/dist/tui.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,164 @@
+export interface WorkflowSpec {
+    name: string;
+    description: string;
+    version?: string;
+    input?: Record<string, unknown>;
+    output?: Record<string, unknown>;
+    triggerTurn?: boolean;
+    completion?: CompletionSpec;
+    steps: Record<string, StepSpec>;
+    artifacts?: Record<string, ArtifactSpec>;
+    source: "user" | "project";
+    filePath: string;
+}
+export interface ArtifactSpec {
+    path: string;
+    from: string;
+    schema?: string;
+}
+export interface RetryConfig {
+    maxAttempts?: number;
+    onExhausted?: "fail" | "skip";
+    steeringMessage?: string;
+}
+export interface StepSpec {
+    agent?: string;
+    model?: string;
+    input?: Record<string, unknown>;
+    output?: StepOutputSpec;
+    when?: string;
+    timeout?: {
+        seconds: number;
+    };
+    retry?: RetryConfig;
+    loop?: LoopSpec;
+    gate?: GateSpec;
+    transform?: TransformSpec;
+    parallel?: Record<string, StepSpec>;
+    pause?: string | boolean;
+    monitor?: string;
+    command?: string;
+    forEach?: string;
+    as?: string;
+    workflow?: string;
+}
+export interface LoopSpec {
+    maxAttempts: number;
+    attempts?: string;
+    steps: Record<string, StepSpec>;
+    onExhausted?: StepSpec;
+}
+export interface GateSpec {
+    check: string;
+    onPass?: "continue" | "break";
+    onFail?: "continue" | "break" | "fail";
+}
+export interface TransformSpec {
+    /**
+     * A mapping of output field names to ${{ }} expressions.
+     * The result is an object with each field resolved.
+     * No LLM invocation — pure data transformation.
+     */
+    mapping: Record<string, unknown>;
+}
+export interface StepOutputSpec {
+    format?: "json" | "text";
+    schema?: string;
+    path?: string;
+}
+export interface AgentSpec {
+    name: string;
+    description?: string;
+    role?: string;
+    systemPrompt?: string;
+    promptTemplate?: string;
+    taskTemplate?: string;
+    model?: string;
+    thinking?: string;
+    tools?: string[];
+    extensions?: string[];
+    skills?: string[];
+    output?: string;
+    inputSchema?: Record<string, unknown>;
+    outputFormat?: "json" | "text";
+    outputSchema?: string;
+}
+export interface ExecutionState {
+    input: unknown;
+    steps: Record<string, StepResult>;
+    status: "running" | "completed" | "failed" | "paused";
+    loop?: LoopState;
+    workflowName?: string;
+    specVersion?: string;
+    startedAt?: string;
+    updatedAt?: string;
+}
+export interface LoopState {
+    stepName: string;
+    iteration: number;
+    maxAttempts: number;
+    priorAttempts: LoopAttempt[];
+}
+export interface LoopAttempt {
+    iteration: number;
+    steps: Record<string, StepResult>;
+}
+export interface StepResult {
+    step: string;
+    agent: string;
+    status: "completed" | "failed" | "skipped";
+    output?: unknown;
+    textOutput?: string;
+    outputPath?: string;
+    sessionLog?: string;
+    usage: StepUsage;
+    durationMs: number;
+    error?: string;
+    truncated?: boolean;
+    warnings?: string[];
+    attempt?: number;
+    totalAttempts?: number;
+    priorErrors?: string[];
+}
+export interface StepUsage {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    cost: number;
+    turns: number;
+}
+export interface WorkflowResult {
+    workflow: string;
+    runId: string;
+    status: "completed" | "failed" | "paused";
+    steps: Record<string, StepResult>;
+    output?: unknown;
+    totalUsage: StepUsage;
+    totalDurationMs: number;
+    runDir: string;
+    artifacts?: Record<string, string>;
+}
+export interface CompletionSpec {
+    message?: string;
+    include?: string[];
+    template?: string;
+}
+export interface ExpressionScope {
+    input: unknown;
+    steps: Record<string, StepResult>;
+    [key: string]: unknown;
+}
+export interface CompletionScope {
+    input: unknown;
+    steps: Record<string, StepResult>;
+    totalUsage: StepUsage;
+    totalDurationMs: number;
+    runDir: string;
+    runId: string;
+    workflow: string;
+    status: "completed" | "failed";
+    output?: unknown;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+// ── Workflow Spec (parsed from YAML) ──
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,yCAAyC"}

package/dist/workflow-discovery.d.ts

@@ -0,0 +1,23 @@
+import type { WorkflowSpec } from "./types.js";
+/**
+ * Discover all workflow specs from project, user, and builtin directories.
+ *
+ * Scans (highest priority first):
+ *   1. .workflows/                (project-level, source: "project")
+ *   2. ~/.pi/agent/workflows/     (user-level, source: "user")
+ *   3. <package>/workflows/       (builtin workflows, source: "user")
+ *
+ * Higher-priority specs shadow lower-priority specs with the same name.
+ *
+ * @param cwd - current working directory (project root)
+ * @param builtinDir - optional path to builtin workflows (defaults to workflows/ relative to package root)
+ * @returns Array of parsed WorkflowSpec objects. Specs that fail parsing are
+ *          skipped with a warning (logged to stderr), not thrown.
+ */
+export declare function discoverWorkflows(cwd: string, builtinDir?: string): WorkflowSpec[];
+/**
+ * Find a workflow by name from discovered workflows.
+ * Returns undefined if not found.
+ */
+export declare function findWorkflow(name: string, cwd: string, builtinDir?: string): WorkflowSpec | undefined;
+//# sourceMappingURL=workflow-discovery.d.ts.map

package/dist/workflow-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-discovery.d.ts","sourceRoot":"","sources":["../src/workflow-discovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CA0BlF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAGrG"}