@cascade-flow/runner 0.1.0 → 0.2.1

package/dist/subprocess-executor.d.ts

@@ -1,5 +1,5 @@
 import type { LogEntry } from "@cascade-flow/backend-interface";
-import type { StepOutput, RunnerContext } from "./types.ts";
+import type { StepOutput, RunnerContext } from "@cascade-flow/workflow";
 type SubprocessOptions = {
     signal?: AbortSignal;
 };

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,YAAY,CAAC;AAc5D,KAAK,iBAAiB,GAAG;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAiDF;;;;;;;;;;;;;;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,CA4JnD"}
+{"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"}

package/dist/types.d.ts

@@ -2,42 +2,7 @@
  * Shared types for the workflow runner
  */
 import { z } from "zod";
-/**
- * JSON primitive types
- */
-export type JSONPrimitive = string | number | boolean | null;
-/**
- * JSON array - an array of JSON values
- */
-export interface JSONArray extends Array<JSONValue> {
-}
-/**
- * JSON object - an object with string keys and JSON values
- */
-export interface JSONObject {
-    [key: string]: JSONValue;
-}
-/**
- * JSON value - any valid JSON type
- */
-export type JSONValue = JSONPrimitive | JSONArray | JSONObject;
-/**
- * Step output must be JSON-serializable
- */
-export type StepOutput = JSONValue;
-/**
- * Base step definition with common properties
- * Generic over dependencies type and function signature
- */
-export type BaseStepDefinition<TDeps = any, TFn = any> = {
-    name?: string;
-    dependencies?: TDeps;
-    exportOutput?: boolean;
-    maxRetries?: number;
-    retryDelayMs?: number;
-    timeoutMs?: number;
-    fn: TFn;
-};
+import type { StepOutput, BaseStepDefinition, RunnerContext } from "@cascade-flow/workflow";
 export type StepModuleExport = {
     step: BaseStepDefinition<Record<string, any>, // other steps' `step` objects
     (args: {
@@ -47,8 +12,10 @@ export type StepModuleExport = {
 };
 /**
  * Loaded step representation after discovery
- * - id: The step's unique identifier (always the directory name)
- * - name: The step's display name (from step.name or falls back to directory name)
+ * - id: The step's unique identifier (relative path from steps directory)
+ *       For flat steps: just the directory name (e.g., "fetch-users")
+ *       For nested steps: full relative path (e.g., "data-processing/extract/fetch-users")
+ * - name: The step's display name (from step.name or falls back to last segment of path)
  * - dir: Absolute path to the step directory
  */
 export type LoadedStep = {
@@ -96,32 +63,4 @@ export type LocalWorkflowMetadata = {
     stepsDir: string;
     inputSchema?: z.ZodSchema<any>;
 };
-export type RunnerContext = {
-    runId: string;
-    workflow: {
-        slug: string;
-        name: string;
-    };
-    input?: unknown;
-    log: (...args: any[]) => void;
-};
-export type InferStepOutput<T> = T extends {
-    fn: (...args: any[]) => infer R;
-} ? Awaited<R> : never;
-/**
- * Unwrap an OptionalDependency to get the underlying step type
- * @internal
- */
-export type UnwrapOptional<T> = T extends import("@cascade-flow/workflow").OptionalDependency<infer U extends {
-    fn: (...args: any[]) => any;
-}> ? U : T;
-/**
- * Infer the output type of a dependency, making it optional if wrapped with optional()
- * - Regular dependency: returns the step's output type
- * - Optional dependency: returns the step's output type | undefined
- *
- * Uses branded type check (__optional property) for unambiguous type narrowing
- * @internal
- */
-export type InferDependencyOutput<T> = '__optional' extends keyof T ? InferStepOutput<UnwrapOptional<T>> | undefined : InferStepOutput<T>;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,aAAa,EACd,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,gBAAgB,GAAG;IAE7B,IAAI,EAAE,kBAAkB,CACtB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,8BAA8B;IACnD,CAAC,IAAI,EAAE;QACL,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACzC,GAAG,EAAE,aAAa,CAAC;KACpB,KAAK,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CACvC,CAAC;CACH,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;IACnC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAC1C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB;;iBAE/B,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;kBAUlB,CAAC;AAEZ;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;CAChC,CAAC"}

package/dist/versioning.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Workflow versioning utilities
+ *
+ * Provides functions to calculate workflow content hashes and collect git metadata
+ * for tracking workflow versions over time.
+ */
+import type { LocalWorkflowMetadata } from "./types.js";
+import type { WorkflowVersionGitInfo } from "@cascade-flow/backend-interface";
+/**
+ * Calculate a deterministic hash of workflow content
+ *
+ * Hashes all step files, workflow.json, and input-schema.ts (if exists)
+ * to create a unique identifier for this version of the workflow.
+ *
+ * @param workflow - Workflow metadata including directory path
+ * @returns SHA-256 hash prefixed with "sha256:"
+ */
+export declare function calculateWorkflowHash(workflow: LocalWorkflowMetadata): Promise<string>;
+/**
+ * Get git information for the current repository
+ *
+ * Returns commit hash, branch name, and dirty status.
+ * Returns undefined if not in a git repository or if git is not available.
+ *
+ * @param workflowDir - Workflow directory (used to find git root)
+ * @returns Git info or undefined
+ */
+export declare function getGitInfo(workflowDir: string): Promise<WorkflowVersionGitInfo | undefined>;
+//# sourceMappingURL=versioning.d.ts.map

package/dist/versioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.d.ts","sourceRoot":"","sources":["../src/versioning.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAM9E;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,qBAAqB,GAC9B,OAAO,CAAC,MAAM,CAAC,CA+CjB;AAmCD;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CA6B7C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cascade-flow/runner",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "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.1.0",
-    "@cascade-flow/backend-interface": "0.1.0",
-    "@cascade-flow/workflow": "0.1.0",
+    "@cascade-flow/backend-filesystem": "0.2.1",
+    "@cascade-flow/backend-interface": "0.2.0",
+    "@cascade-flow/workflow": "0.2.0",
     "zod": "^4.1.12"
   },
   "devDependencies": {