@davidorex/pi-workflows 0.2.0 → 0.3.0

package/dist/workflow-discovery.js

@@ -0,0 +1,103 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { parseWorkflowSpec } from "./workflow-spec.js";
+import { WORKFLOWS_DIR } from "./workflows-dir.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 function discoverWorkflows(cwd, builtinDir) {
+    const projectDir = path.join(cwd, WORKFLOWS_DIR);
+    const userDir = path.join(os.homedir(), ".pi", "agent", "workflows");
+    const demoDir = builtinDir ?? path.resolve(import.meta.dirname, "..", "workflows");
+    const projectSpecs = scanDirectory(projectDir, "project");
+    const userSpecs = scanDirectory(userDir, "user");
+    const builtinSpecs = scanDirectory(demoDir, "user");
+    // Deduplicate: project > user > builtin (last write wins, so add lowest priority first)
+    const byName = new Map();
+    for (const spec of builtinSpecs) {
+        byName.set(spec.name, spec);
+    }
+    for (const spec of userSpecs) {
+        byName.set(spec.name, spec);
+    }
+    for (const spec of projectSpecs) {
+        byName.set(spec.name, spec);
+    }
+    // Return sorted by name
+    const result = Array.from(byName.values());
+    result.sort((a, b) => a.name.localeCompare(b.name));
+    return result;
+}
+/**
+ * Find a workflow by name from discovered workflows.
+ * Returns undefined if not found.
+ */
+export function findWorkflow(name, cwd, builtinDir) {
+    const specs = discoverWorkflows(cwd, builtinDir);
+    return specs.find((s) => s.name === name);
+}
+/**
+ * Scan a directory for *.workflow.yaml files and parse them.
+ * Non-recursive. Returns parsed specs; logs warnings for parse failures.
+ */
+function scanDirectory(dirPath, source) {
+    if (!fs.existsSync(dirPath)) {
+        return [];
+    }
+    let entries;
+    try {
+        entries = fs.readdirSync(dirPath);
+    }
+    catch {
+        return [];
+    }
+    const specs = [];
+    for (const entry of entries) {
+        if (!entry.endsWith(".workflow.yaml")) {
+            continue;
+        }
+        const filePath = path.join(dirPath, entry);
+        // Only process files, not directories
+        let stat;
+        try {
+            stat = fs.statSync(filePath);
+        }
+        catch {
+            continue;
+        }
+        if (!stat.isFile()) {
+            continue;
+        }
+        let content;
+        try {
+            content = fs.readFileSync(filePath, "utf-8");
+        }
+        catch {
+            console.error(`[pi-workflows] Warning: skipping ${filePath}: could not read file`);
+            continue;
+        }
+        try {
+            const spec = parseWorkflowSpec(content, filePath, source);
+            specs.push(spec);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`[pi-workflows] Warning: skipping ${filePath}: ${msg}`);
+        }
+    }
+    return specs;
+}
+//# sourceMappingURL=workflow-discovery.js.map

package/dist/workflow-discovery.js.map

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

package/dist/workflow-executor.d.ts

@@ -0,0 +1,50 @@
+import { dispatch } from "./dispatch.js";
+import { SIGKILL_GRACE_MS } from "./step-shared.js";
+import type { AgentSpec, ExecutionState, WorkflowResult, WorkflowSpec } from "./types.js";
+export { SIGKILL_GRACE_MS };
+/** Set by the extension keybinding to request a pause after the current step. */
+export declare function requestPause(): void;
+export interface ExecuteOptions {
+    /** pi extension context (for TUI, cwd, etc.) */
+    ctx: any;
+    /** pi extension API (for sendMessage) */
+    pi: any;
+    /** AbortSignal for cancellation (e.g. user presses Ctrl+C) */
+    signal?: AbortSignal;
+    /**
+     * Agent spec loader. Given an agent name, returns the AgentSpec.
+     * The executor does not know how to load agent specs — the caller provides this.
+     * If the agent is not found, return a minimal spec with just the name.
+     */
+    loadAgent: (name: string) => AgentSpec;
+    /** Injectable dispatch function for testing; defaults to real dispatch. */
+    dispatchFn?: typeof dispatch;
+    /** Project-level model config; loaded from .project/model-config.json if not provided. */
+    modelConfig?: import("./dispatch.js").ModelConfig;
+    /** Resume from an incomplete run instead of starting fresh. */
+    resume?: {
+        runId: string;
+        runDir: string;
+        state: ExecutionState;
+    };
+}
+/** Retry context passed to step executors on retry attempts. */
+export interface RetryContext {
+    attempt: number;
+    priorErrors: string[];
+    steeringMessage?: string;
+}
+/**
+ * Execute a workflow from a parsed spec and validated input.
+ *
+ * Runs steps sequentially (phase 1), resolving ${{ }} expressions,
+ * dispatching subprocesses, validating outputs, persisting state,
+ * updating TUI, and injecting the result into the conversation.
+ *
+ * Supports step types: agent (default), gate, transform, loop.
+ * Supports `when` conditionals for skipping steps.
+ *
+ * Returns the WorkflowResult (also injected into conversation via sendMessage).
+ */
+export declare function executeWorkflow(spec: WorkflowSpec, input: unknown, options: ExecuteOptions): Promise<WorkflowResult>;
+//# sourceMappingURL=workflow-executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-executor.d.ts","sourceRoot":"","sources":["../src/workflow-executor.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAmBzC,OAAO,EAAkC,gBAAgB,EAAwB,MAAM,kBAAkB,CAAC;AAK1G,OAAO,KAAK,EACX,SAAS,EACT,cAAc,EAId,cAAc,EACd,YAAY,EACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAK5B,iFAAiF;AACjF,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAOD,MAAM,WAAW,cAAc;IAC9B,gDAAgD;IAChD,GAAG,EAAE,GAAG,CAAC;IACT,yCAAyC;IACzC,EAAE,EAAE,GAAG,CAAC;IACR,8DAA8D;IAC9D,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;OAIG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC;IACvC,2EAA2E;IAC3E,UAAU,CAAC,EAAE,OAAO,QAAQ,CAAC;IAC7B,0FAA0F;IAC1F,WAAW,CAAC,EAAE,OAAO,eAAe,EAAE,WAAW,CAAC;IAClD,+DAA+D;IAC/D,MAAM,CAAC,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,cAAc,CAAC;KACtB,CAAC;CACF;AAgTD,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAuND;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACpC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,cAAc,CAAC,CAiQzB"}