@cascade-flow/runner 0.2.4 → 0.2.6

package/dist/step-executor.d.ts

@@ -2,24 +2,21 @@
 /**
  * Step executor - runs a single step in isolation
  *
- * Receives via stdin:
+ * Environment variables:
+ * - CF_STEP_INPUT_FILE: Path to temp file containing JSON input (required)
+ * - STEP_OUTPUT_FILE: Path to write step result as JSON (required)
+ * - CF_CHECKPOINT_DIR: Path to directory for checkpoint IPC (optional)
+ *
+ * Input format (in CF_STEP_INPUT_FILE):
  * {
  *   "stepPath": "/path/to/step.ts",
  *   "dependencies": { "depName": <serialized-output> },
  *   "ctx": { "runId": "...", ... }
  * }
  *
- * Environment variables:
- * - STEP_OUTPUT_FILE: If set, write step result to this file (enables stdout/stderr capture)
- *
- * When STEP_OUTPUT_FILE is set:
- * - Outputs to file: Step result as JSON
- * - Outputs to stdout: console.log/info output
- * - Outputs to stderr: console.error/warn output
- *
- * When STEP_OUTPUT_FILE is NOT set (backward compatibility):
- * - Outputs to stdout: Step result as JSON
- * - Outputs to stderr: All console output (redirected)
+ * Output:
+ * - Step result written to STEP_OUTPUT_FILE as JSON
+ * - stdout/stderr: console output from step
  */
 export {};
 //# sourceMappingURL=step-executor.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"step-executor.d.ts","sourceRoot":"","sources":["../src/step-executor.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;GAqBG"}
+{"version":3,"file":"step-executor.d.ts","sourceRoot":"","sources":["../src/step-executor.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/subprocess-executor.d.ts

@@ -1,5 +1,6 @@
 import type { LogEntry } from "@cascade-flow/backend-interface";
 import type { StepOutput, RunnerContext } from "@cascade-flow/workflow";
+import { type CheckpointData, type CheckpointFailedData } from "./checkpoint-ipc.ts";
 type SubprocessOptions = {
     signal?: AbortSignal;
 };
@@ -16,9 +17,13 @@ type SubprocessOptions = {
  * @param attemptNumber - Current attempt number (for retries)
  * @param outputPath - Path where subprocess should write output JSON
  * @param onLog - Optional callback for real-time log emission
+ * @param onCheckpoint - Optional callback for persisting checkpoints
+ * @param onCheckpointFailed - Optional callback for persisting checkpoint failures
+ * @param existingCheckpoints - Existing checkpoints to replay (name -> data[] by sequence)
+ * @param options - Additional options (signal for abort)
  * @returns Promise resolving to step result and collected logs
  */
-export declare function executeStepInSubprocess(stepFile: string, stepId: string, dependencies: Record<string, unknown>, ctx: RunnerContext, attemptNumber: number, outputPath: string, onLog?: (log: LogEntry) => void | Promise<void>, options?: SubprocessOptions): Promise<{
+export declare function executeStepInSubprocess(stepFile: string, stepId: string, dependencies: Record<string, unknown>, ctx: RunnerContext, attemptNumber: number, outputPath: string, onLog?: (log: LogEntry) => void | Promise<void>, onCheckpoint?: (checkpoint: CheckpointData) => Promise<void>, onCheckpointFailed?: (checkpoint: CheckpointFailedData) => Promise<void>, existingCheckpoints?: Map<string, string[]>, options?: SubprocessOptions): Promise<{
     result: StepOutput;
     logs: LogEntry[];
 }>;

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

@@ -1 +1 @@
-{"version":3,"file":"subprocess-executor.d.ts","sourceRoot":"","sources":["../src/subprocess-executor.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAEhE,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAcxE,KAAK,iBAAiB,GAAG;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAkDF;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,GAAG,EAAE,aAAa,EAClB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAC/C,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAC,CA8JnD"}
+{"version":3,"file":"subprocess-executor.d.ts","sourceRoot":"","sources":["../src/subprocess-executor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAEhE,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAQL,KAAK,cAAc,EAEnB,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AA4H7B,KAAK,iBAAiB,GAAG;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AA2LF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,GAAG,EAAE,aAAa,EAClB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAC/C,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,EAC5D,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,EACxE,mBAAmB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAC3C,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAC,CAwOnD"}

package/dist/validation.d.ts

@@ -2,6 +2,7 @@
  * Step validation - detects circular dependencies and other graph issues
  */
 import type { LoadedStep } from "./types.ts";
+import type { Backend } from "@cascade-flow/backend-interface";
 /**
  * Detects circular dependencies in the step dependency graph
  * Uses depth-first search to find cycles
@@ -10,4 +11,30 @@ import type { LoadedStep } from "./types.ts";
  * @throws Error if a cycle is detected
  */
 export declare function detectCycles(steps: LoadedStep[]): void;
+/**
+ * Get all steps that depend on a given target step (directly or transitively)
+ *
+ * This builds a reverse dependency map and performs DFS to find all dependents.
+ * Used for rerun-from-step functionality to determine which steps need re-execution.
+ *
+ * @param targetStepId - The step ID to find dependents for
+ * @param allSteps - Array of all loaded steps in the workflow
+ * @returns Set of step IDs that depend on the target step (excluding the target itself)
+ */
+export declare function getAllDependents(targetStepId: string, allSteps: LoadedStep[]): Set<string>;
+/**
+ * Get parent workflow version and log any version differences
+ *
+ * Checks if the workflow structure has changed since the parent run
+ * and logs informational messages about version differences.
+ * Used for rerun-from-step functionality.
+ *
+ * @param workflowSlug - Workflow identifier
+ * @param parentRunId - Parent run ID to compare against
+ * @param currentVersionId - Current workflow version ID
+ * @param backend - Backend instance to load version info
+ * @param log - Optional log function for version info
+ * @returns Parent version ID
+ */
+export declare function validateWorkflowVersion(workflowSlug: string, parentRunId: string, currentVersionId: string, backend: Backend, log?: (msg: string) => void): Promise<string>;
 //# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI,CAgBtD"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAE/D;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI,CAgBtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,UAAU,EAAE,GACrB,GAAG,CAAC,MAAM,CAAC,CA8Bb;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE,OAAO,EAChB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAC1B,OAAO,CAAC,MAAM,CAAC,CA6BjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cascade-flow/runner",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -22,9 +22,9 @@
     "test:coverage": "bun test --coverage"
   },
   "dependencies": {
-    "@cascade-flow/backend-filesystem": "0.2.4",
-    "@cascade-flow/backend-interface": "0.2.2",
-    "@cascade-flow/workflow": "0.2.2",
+    "@cascade-flow/backend-filesystem": "0.2.6",
+    "@cascade-flow/backend-interface": "0.2.4",
+    "@cascade-flow/workflow": "0.2.6",
     "zod": "^4.1.12"
   },
   "devDependencies": {