@davidorex/pi-workflows 0.2.0 → 0.3.0

package/dist/agent-spec.js

@@ -0,0 +1,112 @@
+/**
+ * Agent spec loading — YAML specs are the source of truth.
+ *
+ * Agent specs are declarative YAML files that define typed functions:
+ * InputSchema → OutputSchema, with template references for prompt
+ * composition. The .md that pi consumes is compiled at dispatch time
+ * from spec + templates + typed input. It exists in memory only.
+ *
+ * Search order (first match wins):
+ *   1. .pi/agents/<name>.agent.yaml     (project)
+ *   2. ~/.pi/agent/agents/<name>.agent.yaml  (user)
+ *   3. <package>/agents/<name>.agent.yaml (builtin)
+ */
+import fs from "node:fs";
+import path from "node:path";
+/** Check if a prompt.system value looks like a template file path vs inline text. */
+function isTemplatePath(value) {
+    if (!value)
+        return false;
+    return value.endsWith(".md") || value.endsWith(".txt") || (value.includes("/") && !value.includes("\n"));
+}
+import os from "node:os";
+import { parse as parseYaml } from "yaml";
+/**
+ * Thrown when an agent spec file is not found in any search path.
+ */
+export class AgentNotFoundError extends Error {
+    agentName;
+    searchPaths;
+    constructor(agentName, searchPaths) {
+        const pathList = searchPaths.map((p) => `  - ${p}`).join("\n");
+        super(`Agent '${agentName}' not found. Searched:\n${pathList}`);
+        this.name = "AgentNotFoundError";
+        this.agentName = agentName;
+        this.searchPaths = searchPaths;
+    }
+}
+/**
+ * Thrown when an agent spec file exists but cannot be read or parsed.
+ */
+export class AgentParseError extends Error {
+    agentName;
+    filePath;
+    cause;
+    constructor(agentName, filePath, cause) {
+        super(`Agent '${agentName}' at ${filePath}: ${cause.message}`);
+        this.name = "AgentParseError";
+        this.agentName = agentName;
+        this.filePath = filePath;
+        this.cause = cause;
+    }
+}
+/**
+ * Parse a YAML agent spec file into an AgentSpec.
+ */
+export function parseAgentYaml(filePath) {
+    const name = path.basename(filePath, ".agent.yaml");
+    let content;
+    try {
+        content = fs.readFileSync(filePath, "utf-8");
+    }
+    catch (err) {
+        throw new AgentParseError(name, filePath, err instanceof Error ? err : new Error(String(err)));
+    }
+    let spec;
+    try {
+        spec = parseYaml(content);
+    }
+    catch (err) {
+        throw new AgentParseError(name, filePath, err instanceof Error ? err : new Error(String(err)));
+    }
+    // Handle null/undefined from parsing empty file or non-mapping YAML
+    if (!spec || typeof spec !== "object") {
+        throw new AgentParseError(name, filePath, new Error("File is empty or does not contain a YAML mapping"));
+    }
+    return {
+        name: spec.name || name,
+        description: spec.description,
+        role: spec.role,
+        model: spec.model,
+        thinking: spec.thinking,
+        tools: spec.tools,
+        extensions: spec.extensions,
+        skills: spec.skills,
+        output: spec.output?.file,
+        promptTemplate: isTemplatePath(spec.prompt?.system) ? spec.prompt?.system : undefined,
+        systemPrompt: isTemplatePath(spec.prompt?.system) ? undefined : spec.prompt?.system,
+        taskTemplate: spec.prompt?.task,
+        inputSchema: spec.input,
+        outputFormat: spec.output?.format,
+        outputSchema: spec.output?.schema,
+    };
+}
+/**
+ * Create an agent loader that finds .agent.yaml specs.
+ */
+export function createAgentLoader(cwd, builtinDir) {
+    const defaultBuiltinDir = builtinDir ?? path.resolve(import.meta.dirname, "..", "agents");
+    return (name) => {
+        const searchPaths = [
+            path.join(cwd, ".pi", "agents", `${name}.agent.yaml`),
+            path.join(os.homedir(), ".pi", "agent", "agents", `${name}.agent.yaml`),
+            path.join(defaultBuiltinDir, `${name}.agent.yaml`),
+        ];
+        for (const p of searchPaths) {
+            if (fs.existsSync(p))
+                return parseAgentYaml(p);
+        }
+        throw new AgentNotFoundError(name, searchPaths);
+    };
+}
+//# sourceMappingURL=agent-spec.js.map

package/dist/agent-spec.js.map

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

package/dist/checkpoint.d.ts

@@ -0,0 +1,50 @@
+import type { ExecutionState, WorkflowSpec } from "./types.js";
+export interface IncompleteRun {
+    runId: string;
+    runDir: string;
+    state: ExecutionState;
+    completedSteps: string[];
+    failedStep?: string;
+    updatedAt?: string;
+}
+/**
+ * Find the most recent incomplete run for a workflow.
+ *
+ * Scans .workflows/runs/<name>/runs/ for state.json files
+ * with status "running" or "failed". Returns the most recent one
+ * (by directory name, which encodes timestamp).
+ *
+ * Returns null if no incomplete runs exist.
+ */
+export declare function findIncompleteRun(cwd: string, workflowName: string): IncompleteRun | null;
+/**
+ * Validate that a saved state is compatible with the current workflow spec.
+ *
+ * Checks:
+ * 1. Spec version matches (if both specify one)
+ * 2. All completed steps still exist in the spec
+ *
+ * Returns null if compatible, or a string describing the incompatibility.
+ */
+export declare function validateResumeCompatibility(state: ExecutionState, spec: WorkflowSpec): string | null;
+/**
+ * Determine which steps need to run when resuming.
+ *
+ * Given the execution plan (layers of step names) and the set of
+ * already-completed steps, returns the layer index to resume from
+ * and which steps within that layer still need to run.
+ *
+ * For a partially-complete parallel layer (some steps done, some not),
+ * returns only the incomplete steps from that layer.
+ */
+export declare function computeResumePoint(plan: Array<{
+    steps: string[];
+}>, completedSteps: Set<string>): {
+    resumeLayerIndex: number;
+    pendingStepsInLayer: string[];
+} | null;
+/**
+ * Format a human-readable summary of an incomplete run for display.
+ */
+export declare function formatIncompleteRun(run: IncompleteRun, spec: WorkflowSpec): string;
+//# sourceMappingURL=checkpoint.d.ts.map

package/dist/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../src/checkpoint.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/D,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,cAAc,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAqCzF;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAepG;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EAChC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,GACzB;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAYpE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAQlF"}

package/dist/checkpoint.js

@@ -0,0 +1,109 @@
+/**
+ * Checkpoint and resume logic for workflow runs.
+ *
+ * Finds incomplete runs, validates they match the current spec,
+ * and provides state needed to resume execution.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { readState } from "./state.js";
+import { WORKFLOWS_DIR } from "./workflows-dir.js";
+/**
+ * Find the most recent incomplete run for a workflow.
+ *
+ * Scans .workflows/runs/<name>/runs/ for state.json files
+ * with status "running" or "failed". Returns the most recent one
+ * (by directory name, which encodes timestamp).
+ *
+ * Returns null if no incomplete runs exist.
+ */
+export function findIncompleteRun(cwd, workflowName) {
+    const runsDir = path.join(cwd, WORKFLOWS_DIR, "runs", workflowName, "runs");
+    if (!fs.existsSync(runsDir))
+        return null;
+    const entries = fs
+        .readdirSync(runsDir)
+        .filter((e) => {
+        const stat = fs.statSync(path.join(runsDir, e));
+        return stat.isDirectory();
+    })
+        .sort() // lexicographic — timestamp-based IDs sort chronologically
+        .reverse(); // most recent first
+    for (const runId of entries) {
+        const runDir = path.join(runsDir, runId);
+        const state = readState(runDir);
+        if (!state)
+            continue;
+        if (state.status === "running" || state.status === "failed" || state.status === "paused") {
+            const completedSteps = Object.entries(state.steps)
+                .filter(([, r]) => r.status === "completed" || r.status === "skipped")
+                .map(([name]) => name);
+            const failedStep = Object.entries(state.steps).find(([, r]) => r.status === "failed")?.[0];
+            return {
+                runId,
+                runDir,
+                state,
+                completedSteps,
+                failedStep,
+                updatedAt: state.updatedAt,
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Validate that a saved state is compatible with the current workflow spec.
+ *
+ * Checks:
+ * 1. Spec version matches (if both specify one)
+ * 2. All completed steps still exist in the spec
+ *
+ * Returns null if compatible, or a string describing the incompatibility.
+ */
+export function validateResumeCompatibility(state, spec) {
+    // Check version match
+    if (state.specVersion && spec.version && state.specVersion !== spec.version) {
+        return `Spec version changed: run has '${state.specVersion}', current is '${spec.version}'`;
+    }
+    // Check all completed steps still exist in spec
+    const specStepNames = new Set(Object.keys(spec.steps));
+    for (const stepName of Object.keys(state.steps)) {
+        if (!specStepNames.has(stepName)) {
+            return `Step '${stepName}' was completed in the saved run but no longer exists in the workflow spec`;
+        }
+    }
+    return null; // compatible
+}
+/**
+ * Determine which steps need to run when resuming.
+ *
+ * Given the execution plan (layers of step names) and the set of
+ * already-completed steps, returns the layer index to resume from
+ * and which steps within that layer still need to run.
+ *
+ * For a partially-complete parallel layer (some steps done, some not),
+ * returns only the incomplete steps from that layer.
+ */
+export function computeResumePoint(plan, completedSteps) {
+    for (let i = 0; i < plan.length; i++) {
+        const layer = plan[i];
+        const pending = layer.steps.filter((s) => !completedSteps.has(s));
+        if (pending.length > 0) {
+            return { resumeLayerIndex: i, pendingStepsInLayer: pending };
+        }
+    }
+    // All steps completed — nothing to resume
+    return null;
+}
+/**
+ * Format a human-readable summary of an incomplete run for display.
+ */
+export function formatIncompleteRun(run, spec) {
+    const totalSteps = Object.keys(spec.steps).length;
+    const completed = run.completedSteps.length;
+    const status = run.state.status === "paused" ? "paused" : run.state.status === "running" ? "interrupted" : "failed";
+    const failedInfo = run.failedStep ? ` at step '${run.failedStep}'` : "";
+    const timeInfo = run.updatedAt ? ` (last updated: ${run.updatedAt})` : "";
+    return `Found ${status} run${failedInfo}: ${completed}/${totalSteps} steps completed${timeInfo}. Run ID: ${run.runId}`;
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/checkpoint.js.map

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

package/dist/completion.d.ts

@@ -0,0 +1,18 @@
+import type { CompletionSpec, WorkflowResult } from "./types.js";
+/**
+ * Resolve a completion spec into the final message string injected into
+ * the main LLM conversation after workflow execution.
+ *
+ * Two forms:
+ * - Template: the template string is resolved with ${{ }} expressions
+ *   and returned as the full content.
+ * - Message + include: the message is resolved, then each include path
+ *   is resolved and appended as structured data.
+ *
+ * @param spec - the CompletionSpec from the workflow YAML
+ * @param result - the completed WorkflowResult
+ * @param executionInput - the original workflow input
+ * @returns the resolved message string
+ */
+export declare function resolveCompletion(spec: CompletionSpec, result: WorkflowResult, executionInput: unknown): string;
+//# sourceMappingURL=completion.d.ts.map

package/dist/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../src/completion.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAmB,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAElF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,GAAG,MAAM,CA6C/G"}

package/dist/completion.js

@@ -0,0 +1,58 @@
+import { resolveExpression, resolveExpressions } from "./expression.js";
+/**
+ * Resolve a completion spec into the final message string injected into
+ * the main LLM conversation after workflow execution.
+ *
+ * Two forms:
+ * - Template: the template string is resolved with ${{ }} expressions
+ *   and returned as the full content.
+ * - Message + include: the message is resolved, then each include path
+ *   is resolved and appended as structured data.
+ *
+ * @param spec - the CompletionSpec from the workflow YAML
+ * @param result - the completed WorkflowResult
+ * @param executionInput - the original workflow input
+ * @returns the resolved message string
+ */
+export function resolveCompletion(spec, result, executionInput) {
+    const scope = {
+        input: executionInput,
+        steps: result.steps,
+        totalUsage: result.totalUsage,
+        totalDurationMs: result.totalDurationMs,
+        runDir: result.runDir,
+        runId: result.runId,
+        workflow: result.workflow,
+        status: result.status,
+        output: result.output,
+    };
+    if (spec.template) {
+        const resolved = resolveExpressions(spec.template, scope);
+        return String(resolved ?? "");
+    }
+    // Message form
+    const parts = [];
+    if (spec.message) {
+        const resolvedMessage = resolveExpressions(spec.message, scope);
+        parts.push(String(resolvedMessage ?? ""));
+    }
+    if (spec.include && spec.include.length > 0) {
+        const included = {};
+        for (const path of spec.include) {
+            const value = resolveExpression(path, scope);
+            included[path] = value;
+        }
+        parts.push("");
+        parts.push("---");
+        for (const [path, value] of Object.entries(included)) {
+            if (value !== null && typeof value === "object") {
+                parts.push(`\n### ${path}\n\`\`\`json\n${JSON.stringify(value, null, 2)}\n\`\`\``);
+            }
+            else {
+                parts.push(`\n### ${path}\n${String(value ?? "")}`);
+            }
+        }
+    }
+    return parts.join("\n");
+}
+//# sourceMappingURL=completion.js.map

package/dist/completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../src/completion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGxE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAoB,EAAE,MAAsB,EAAE,cAAuB;IACtG,MAAM,KAAK,GAAoB;QAC9B,KAAK,EAAE,cAAc;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAgC;QAC/C,MAAM,EAAE,MAAM,CAAC,MAAM;KACrB,CAAC;IAEF,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC1D,OAAO,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,eAAe;IACf,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,eAAe,GAAG,kBAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAChE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAA4B,EAAE,CAAC;QAC7C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC7C,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACxB,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACjD,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,iBAAiB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;YACpF,CAAC;iBAAM,CAAC;gBACP,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,KAAK,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YACrD,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/dist/dag.d.ts

@@ -0,0 +1,56 @@
+/**
+ * DAG dependency analysis and execution planning for workflow steps.
+ * Extracts `${{ steps.X }}` references, builds a dependency graph,
+ * and produces layered execution plans for parallel dispatch.
+ */
+import type { WorkflowSpec } from "./types.js";
+/**
+ * A single layer in the execution plan.
+ * All steps in a layer are independent and can run concurrently.
+ */
+export interface ExecutionLayer {
+    steps: string[];
+}
+/**
+ * The full execution plan: an ordered list of layers.
+ * Steps in the same layer have no mutual dependencies.
+ * Steps in layer N depend only on steps in layers 0..N-1.
+ */
+export type ExecutionPlan = ExecutionLayer[];
+/**
+ * Extract all step dependencies from a workflow spec.
+ *
+ * Scans all expression-bearing fields in each step:
+ * - `input` values (recursive — expressions can be nested in objects/arrays)
+ * - `when` condition
+ * - `gate.check` (may contain ${{ }})
+ * - `transform.mapping` values (recursive)
+ * - `loop.attempts` (may be an expression)
+ *
+ * Does NOT descend into loop sub-steps — a loop step's internal steps
+ * are the loop's own concern, not part of the top-level DAG.
+ *
+ * Returns a map: stepName → Set of step names it depends on.
+ */
+export declare function extractDependencies(spec: WorkflowSpec): Map<string, Set<string>>;
+/**
+ * Build an execution plan from a pre-computed dependency map.
+ * Performs topological sort, grouping independent steps into layers.
+ * Throws if the dependency graph contains a cycle.
+ */
+export declare function buildPlanFromDeps(allSteps: string[], deps: Map<string, Set<string>>): ExecutionPlan;
+/**
+ * Build an execution plan from a workflow spec.
+ *
+ * Performs topological sort, grouping independent steps into layers.
+ * Steps within a layer can execute concurrently.
+ *
+ * Throws if the dependency graph contains a cycle.
+ */
+export declare function buildExecutionPlan(spec: WorkflowSpec): ExecutionPlan;
+/**
+ * Check if an execution plan is fully sequential
+ * (every layer has exactly one step).
+ */
+export declare function isSequential(plan: ExecutionPlan): boolean;
+//# sourceMappingURL=dag.d.ts.map

package/dist/dag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag.d.ts","sourceRoot":"","sources":["../src/dag.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAY,YAAY,EAAE,MAAM,YAAY,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,cAAc,EAAE,CAAC;AAE7C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAyBhF;AAkGD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,aAAa,CA4BnG;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,aAAa,CAGpE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAEzD"}

package/dist/dag.js

@@ -0,0 +1,172 @@
+/**
+ * Extract all step dependencies from a workflow spec.
+ *
+ * Scans all expression-bearing fields in each step:
+ * - `input` values (recursive — expressions can be nested in objects/arrays)
+ * - `when` condition
+ * - `gate.check` (may contain ${{ }})
+ * - `transform.mapping` values (recursive)
+ * - `loop.attempts` (may be an expression)
+ *
+ * Does NOT descend into loop sub-steps — a loop step's internal steps
+ * are the loop's own concern, not part of the top-level DAG.
+ *
+ * Returns a map: stepName → Set of step names it depends on.
+ */
+export function extractDependencies(spec) {
+    const stepNames = new Set(Object.keys(spec.steps));
+    const deps = new Map();
+    for (const [name, step] of Object.entries(spec.steps)) {
+        const stepDeps = new Set();
+        // Collect all expression strings from this step
+        const expressions = collectExpressions(step);
+        // Parse each expression for `steps.<name>` references
+        for (const expr of expressions) {
+            const referenced = extractStepReferences(expr, stepNames);
+            for (const ref of referenced) {
+                if (ref !== name) {
+                    // no self-dependencies
+                    stepDeps.add(ref);
+                }
+            }
+        }
+        deps.set(name, stepDeps);
+    }
+    return deps;
+}
+/**
+ * Collect all raw expression strings from a step spec.
+ * Walks `input`, `when`, `gate.check`, `transform.mapping`, `loop.attempts`.
+ */
+function collectExpressions(step) {
+    const exprs = [];
+    // input values (recursive)
+    if (step.input) {
+        collectExpressionsFromValue(step.input, exprs);
+    }
+    // when condition
+    if (step.when) {
+        exprs.push(step.when);
+    }
+    // gate check
+    if (step.gate) {
+        collectExpressionsFromValue(step.gate.check, exprs);
+    }
+    // transform mapping (recursive)
+    if (step.transform) {
+        collectExpressionsFromValue(step.transform.mapping, exprs);
+    }
+    // loop attempts expression
+    if (step.loop?.attempts) {
+        exprs.push(step.loop.attempts);
+    }
+    // forEach expression
+    if (step.forEach) {
+        collectExpressionsFromValue(step.forEach, exprs);
+    }
+    // command expression (may contain ${{ }} references)
+    if (step.command) {
+        collectExpressionsFromValue(step.command, exprs);
+    }
+    return exprs;
+}
+/**
+ * Recursively collect expression strings from a value.
+ * Walks objects, arrays, and strings looking for ${{ }} patterns.
+ */
+function collectExpressionsFromValue(value, exprs) {
+    if (typeof value === "string") {
+        // Extract all ${{ ... }} patterns from the string
+        const regex = /\$\{\{([^}]+)\}\}/g;
+        let match;
+        while ((match = regex.exec(value)) !== null) {
+            exprs.push(match[1].trim());
+        }
+        // Also handle bare expressions (no ${{ }} wrapper, e.g. in `when`)
+        if (!value.includes("${{") && value.includes("steps.")) {
+            exprs.push(value);
+        }
+    }
+    else if (Array.isArray(value)) {
+        for (const item of value) {
+            collectExpressionsFromValue(item, exprs);
+        }
+    }
+    else if (value !== null && typeof value === "object") {
+        for (const v of Object.values(value)) {
+            collectExpressionsFromValue(v, exprs);
+        }
+    }
+}
+/**
+ * Extract step name references from an expression string.
+ *
+ * Looks for patterns like:
+ * - `steps.diagnose.output`
+ * - `steps.diagnose.textOutput`
+ * - `steps.diagnose.status`
+ *
+ * Returns the set of step names referenced.
+ */
+function extractStepReferences(expr, validStepNames) {
+    const refs = new Set();
+    // Match `steps.<name>` — name is a word (alphanumeric + underscore + hyphen)
+    const regex = /steps\.([a-zA-Z_][\w-]*)/g;
+    let match;
+    while ((match = regex.exec(expr)) !== null) {
+        const name = match[1];
+        if (validStepNames.has(name)) {
+            refs.add(name);
+        }
+    }
+    return refs;
+}
+/**
+ * Build an execution plan from a pre-computed dependency map.
+ * Performs topological sort, grouping independent steps into layers.
+ * Throws if the dependency graph contains a cycle.
+ */
+export function buildPlanFromDeps(allSteps, deps) {
+    const plan = [];
+    const placed = new Set();
+    while (placed.size < allSteps.length) {
+        const layer = [];
+        for (const step of allSteps) {
+            if (placed.has(step))
+                continue;
+            const stepDeps = deps.get(step) ?? new Set();
+            if ([...stepDeps].every((d) => placed.has(d))) {
+                layer.push(step);
+            }
+        }
+        if (layer.length === 0) {
+            const remaining = allSteps.filter((s) => !placed.has(s));
+            throw new Error(`Dependency cycle detected among steps: ${remaining.join(", ")}`);
+        }
+        plan.push({ steps: layer });
+        for (const s of layer) {
+            placed.add(s);
+        }
+    }
+    return plan;
+}
+/**
+ * Build an execution plan from a workflow spec.
+ *
+ * Performs topological sort, grouping independent steps into layers.
+ * Steps within a layer can execute concurrently.
+ *
+ * Throws if the dependency graph contains a cycle.
+ */
+export function buildExecutionPlan(spec) {
+    const deps = extractDependencies(spec);
+    return buildPlanFromDeps(Object.keys(spec.steps), deps);
+}
+/**
+ * Check if an execution plan is fully sequential
+ * (every layer has exactly one step).
+ */
+export function isSequential(plan) {
+    return plan.every((layer) => layer.steps.length === 1);
+}
+//# sourceMappingURL=dag.js.map

package/dist/dag.js.map

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

package/dist/dispatch.d.ts

@@ -0,0 +1,35 @@
+import type { AgentSpec, StepResult, StepSpec, StepUsage } from "./types.js";
+export interface ModelConfig {
+    default?: string;
+    by_role?: Record<string, string>;
+}
+export interface DispatchOptions {
+    cwd: string;
+    sessionLogDir: string;
+    stepName: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    onEvent?: (event: ProcessEvent) => void;
+    modelConfig?: ModelConfig;
+}
+export interface ProcessEvent {
+    type: string;
+    raw: unknown;
+    toolName?: string;
+    toolArgs?: string;
+    messageText?: string;
+    usage?: Partial<StepUsage>;
+}
+export declare function extractText(content: unknown): string;
+export declare function extractToolArgsPreview(args: unknown): string;
+export declare function buildArgs(step: StepSpec, agentSpec: AgentSpec, prompt: string, options: DispatchOptions): string[];
+/**
+ * Spawn a pi subprocess for a workflow step and collect the result.
+ *
+ * Builds CLI args from the step spec and agent spec.
+ * Streams stdout as newline-delimited JSON.
+ * Collects messages, usage, timing.
+ * Returns StepResult when the process exits.
+ */
+export declare function dispatch(step: StepSpec, agentSpec: AgentSpec, prompt: string, options: DispatchOptions): Promise<StepResult>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE7E,MAAM,WAAW,WAAW;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC,WAAW,CAAC,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;IAEb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CAC3B;AAaD,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAQpD;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAU5D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,EAAE,CAqDlH;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC7B,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,GACtB,OAAO,CAAC,UAAU,CAAC,CA6NrB"}