@cascade-flow/runner 0.2.5 → 0.2.7

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;AA+I7B,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cascade-flow/runner",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "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.5",
-    "@cascade-flow/backend-interface": "0.2.3",
-    "@cascade-flow/workflow": "0.2.3",
+    "@cascade-flow/backend-filesystem": "0.2.7",
+    "@cascade-flow/backend-interface": "0.2.5",
+    "@cascade-flow/workflow": "0.3.0",
     "zod": "^4.1.12"
   },
   "devDependencies": {