resumable-workflow 1.1.3 → 1.3.0

package/dist/index.d.mts

@@ -46,8 +46,17 @@ declare class Workflow<TInput = unknown, TState extends Record<string, unknown>
     private run;
     start(input: TInput): Promise<WorkflowResult<TState>>;
     resume(runId: string): Promise<WorkflowResult<TState>>;
+    /**
+     * Retrieves the current state of a specific run
+     */
+    getRun(runId: string): Promise<WorkflowRunState<TInput, TState> | null>;
     listIncomplete(): Promise<WorkflowRunState<unknown, Record<string, unknown>>[]>;
     resumeAllIncomplete(): Promise<WorkflowResult<TState>[]>;
+    /**
+     * Clears all incomplete runs for this workflow from storage.
+     * Useful for manual cleanup of stuck processes.
+     */
+    clearIncomplete(): Promise<void>;
 }
 /**
  * Factory function for backward compatibility and ease of use

package/dist/index.d.ts

@@ -46,8 +46,17 @@ declare class Workflow<TInput = unknown, TState extends Record<string, unknown>
     private run;
     start(input: TInput): Promise<WorkflowResult<TState>>;
     resume(runId: string): Promise<WorkflowResult<TState>>;
+    /**
+     * Retrieves the current state of a specific run
+     */
+    getRun(runId: string): Promise<WorkflowRunState<TInput, TState> | null>;
     listIncomplete(): Promise<WorkflowRunState<unknown, Record<string, unknown>>[]>;
     resumeAllIncomplete(): Promise<WorkflowResult<TState>[]>;
+    /**
+     * Clears all incomplete runs for this workflow from storage.
+     * Useful for manual cleanup of stuck processes.
+     */
+    clearIncomplete(): Promise<void>;
 }
 /**
  * Factory function for backward compatibility and ease of use

package/dist/index.js

@@ -195,6 +195,13 @@ var Workflow = class {
       runState
     );
   }
+  /**
+   * Retrieves the current state of a specific run
+   */
+  async getRun(runId) {
+    const runState = await this.storage.getRun(runId);
+    return runState;
+  }
   listIncomplete() {
     return this.storage.listIncompleteRuns(this.workflowId);
   }
@@ -209,6 +216,20 @@ var Workflow = class {
       )
     );
   }
+  /**
+   * Clears all incomplete runs for this workflow from storage.
+   * Useful for manual cleanup of stuck processes.
+   */
+  async clearIncomplete() {
+    const incomplete = await this.storage.listIncompleteRuns(this.workflowId);
+    const fs2 = await import("fs/promises");
+    const path2 = await import("path");
+    for (const run of incomplete) {
+      const filePath = path2.join(".resumable-workflow", `${run.runId}.json`);
+      await fs2.unlink(filePath).catch(() => {
+      });
+    }
+  }
 };
 function createWorkflow(config) {
   return new Workflow(config);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/core/engine.ts","../src/storage/file-storage.ts"],"sourcesContent":["export { createWorkflow, Workflow } from './core/engine';\nexport { FileStorage } from './storage/file-storage';\nexport type {\n  Step,\n  StorageProvider,\n  WorkflowConfig,\n  WorkflowResult,\n  WorkflowRunState,\n  WorkflowStatus,\n} from './types';\n","import { randomUUID } from 'node:crypto';\nimport { FileStorage } from '../storage/file-storage';\nimport type {\n  StorageProvider,\n  WorkflowConfig,\n  WorkflowResult,\n  WorkflowRunState,\n  WorkflowStatus,\n} from '../types';\n\ntype Mutable<T> = {\n  -readonly [P in keyof T]: T[P];\n};\n\nexport class Workflow<\n  TInput = unknown,\n  TState extends Record<string, unknown> = Record<string, unknown>,\n> {\n  private readonly storage: StorageProvider;\n  private readonly workflowId: string;\n  private readonly config: WorkflowConfig<TInput, TState>;\n\n  constructor(config: WorkflowConfig<TInput, TState>) {\n    this.config = config;\n    this.storage = config.storage || new FileStorage();\n    this.workflowId = config.id;\n\n    if (config.autoResume) {\n      this.resumeAllIncomplete().catch((err) => {\n        console.error(\n          `[ResumableWorkflow: ${this.workflowId}] Auto-resume failed:`,\n          err\n        );\n      });\n    }\n  }\n\n  private async executeStep(\n    currentState: Mutable<WorkflowRunState<TInput, TState>>,\n    stepIndex: number\n  ): Promise<void> {\n    const step = this.config.steps[stepIndex];\n    if (!step) {\n      return;\n    }\n\n    try {\n      const result = await step.run({\n        input: currentState.input,\n        state: currentState.state,\n      });\n\n      if (\n        result !== null &&\n        typeof result === 'object' &&\n        !Array.isArray(result)\n      ) {\n        currentState.state = {\n          ...currentState.state,\n          ...(result as Partial<TState>),\n        };\n      } else if (result !== undefined) {\n        (currentState.state as Record<string, unknown>)[\n          step.name || `step_${stepIndex}`\n        ] = result;\n      }\n\n      currentState.currentStepIndex = stepIndex + 1;\n\n      if (currentState.currentStepIndex === this.config.steps.length) {\n        currentState.status = 'completed';\n      }\n\n      await this.storage.saveRun(currentState);\n    } catch (error) {\n      currentState.status = 'failed';\n      currentState.error =\n        error instanceof Error ? error.message : String(error);\n      await this.storage.saveRun(currentState);\n      throw error;\n    }\n  }\n\n  private async run(\n    input: TInput,\n    existingRun?: WorkflowRunState<TInput, TState>\n  ): Promise<WorkflowResult<TState>> {\n    const runId = existingRun?.runId || randomUUID();\n    const currentState: Mutable<WorkflowRunState<TInput, TState>> =\n      (existingRun as Mutable<WorkflowRunState<TInput, TState>>) || {\n        workflowId: this.workflowId,\n        runId,\n        status: 'pending' as WorkflowStatus,\n        currentStepIndex: 0,\n        input,\n        state: {} as TState,\n      };\n\n    // If resuming a failed/halted run, reset its status to pending\n    if (existingRun && existingRun.status !== 'completed') {\n      currentState.status = 'pending';\n    }\n\n    if (!existingRun) {\n      await this.storage.saveRun(currentState);\n    }\n\n    try {\n      for (\n        let i = currentState.currentStepIndex;\n        i < this.config.steps.length;\n        i++\n      ) {\n        await this.executeStep(currentState, i);\n      }\n    } catch (_error) {\n      return {\n        success: false,\n        error: currentState.error || 'Unknown error',\n        runId: currentState.runId,\n        stepName:\n          this.config.steps[currentState.currentStepIndex]?.name ||\n          `step_${currentState.currentStepIndex}`,\n      };\n    }\n\n    return {\n      success: true,\n      result: currentState.state,\n      runId: currentState.runId,\n    };\n  }\n\n  start(input: TInput): Promise<WorkflowResult<TState>> {\n    return this.run(input);\n  }\n\n  async resume(runId: string): Promise<WorkflowResult<TState>> {\n    const runState = await this.storage.getRun(runId);\n    if (!runState) {\n      return {\n        success: false,\n        error: `Run ${runId} not found`,\n        runId,\n        stepName: 'unknown',\n      };\n    }\n    if (runState.status === 'completed') {\n      return {\n        success: true,\n        result: runState.state as TState,\n        runId: runState.runId,\n      };\n    }\n    return this.run(\n      runState.input as TInput,\n      runState as WorkflowRunState<TInput, TState>\n    );\n  }\n\n  listIncomplete(): Promise<\n    WorkflowRunState<unknown, Record<string, unknown>>[]\n  > {\n    return this.storage.listIncompleteRuns(this.workflowId);\n  }\n\n  async resumeAllIncomplete(): Promise<WorkflowResult<TState>[]> {\n    const incomplete = await this.storage.listIncompleteRuns(this.workflowId);\n    return Promise.all(\n      incomplete.map((runState) =>\n        this.run(\n          runState.input as TInput,\n          runState as WorkflowRunState<TInput, TState>\n        )\n      )\n    );\n  }\n}\n\n/**\n * Factory function for backward compatibility and ease of use\n */\nexport function createWorkflow<\n  TInput = unknown,\n  TState extends Record<string, unknown> = Record<string, unknown>,\n>(config: WorkflowConfig<TInput, TState>) {\n  return new Workflow(config);\n}\n","import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport type { StorageProvider, WorkflowRunState } from '../types';\n\nexport class FileStorage implements StorageProvider {\n  private readonly baseDir: string;\n\n  constructor(baseDir = '.resumable-workflow') {\n    this.baseDir = path.resolve(baseDir);\n  }\n\n  private async ensureDir(): Promise<void> {\n    await fs.mkdir(this.baseDir, { recursive: true });\n  }\n\n  private getFilePath(runId: string): string {\n    return path.join(this.baseDir, `${runId}.json`);\n  }\n\n  async saveRun(\n    state: WorkflowRunState<unknown, Record<string, unknown>>\n  ): Promise<void> {\n    await this.ensureDir();\n    await fs.writeFile(\n      this.getFilePath(state.runId),\n      JSON.stringify(state, null, 2)\n    );\n  }\n\n  async getRun(\n    runId: string\n  ): Promise<WorkflowRunState<unknown, Record<string, unknown>> | null> {\n    try {\n      const data = await fs.readFile(this.getFilePath(runId), 'utf-8');\n      return JSON.parse(data) as WorkflowRunState<\n        unknown,\n        Record<string, unknown>\n      >;\n    } catch (_e) {\n      // Return null if file doesn't exist or is invalid\n      return null;\n    }\n  }\n\n  async listIncompleteRuns(\n    workflowId: string\n  ): Promise<WorkflowRunState<unknown, Record<string, unknown>>[]> {\n    try {\n      await this.ensureDir();\n      const files = await fs.readdir(this.baseDir);\n      const runs: WorkflowRunState<unknown, Record<string, unknown>>[] = [];\n\n      for (const file of files) {\n        if (file.endsWith('.json')) {\n          const data = await fs.readFile(\n            path.join(this.baseDir, file),\n            'utf-8'\n          );\n          const run = JSON.parse(data) as WorkflowRunState<\n            unknown,\n            Record<string, unknown>\n          >;\n          if (\n            run.workflowId === workflowId &&\n            (run.status === 'pending' || run.status === 'failed')\n          ) {\n            runs.push(run);\n          }\n        }\n      }\n      return runs;\n    } catch (_e) {\n      // Return empty array if directory doesn't exist or fails to read\n      return [];\n    }\n  }\n}\n"],"mappings":"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","names":["path","fs"]}
+{"version":3,"sources":["../src/index.ts","../src/core/engine.ts","../src/storage/file-storage.ts"],"sourcesContent":["export { createWorkflow, Workflow } from './core/engine';\nexport { FileStorage } from './storage/file-storage';\nexport type {\n  Step,\n  StorageProvider,\n  WorkflowConfig,\n  WorkflowResult,\n  WorkflowRunState,\n  WorkflowStatus,\n} from './types';\n","import { randomUUID } from 'node:crypto';\nimport { FileStorage } from '../storage/file-storage';\nimport type {\n  StorageProvider,\n  WorkflowConfig,\n  WorkflowResult,\n  WorkflowRunState,\n  WorkflowStatus,\n} from '../types';\n\ntype Mutable<T> = {\n  -readonly [P in keyof T]: T[P];\n};\n\nexport class Workflow<\n  TInput = unknown,\n  TState extends Record<string, unknown> = Record<string, unknown>,\n> {\n  private readonly storage: StorageProvider;\n  private readonly workflowId: string;\n  private readonly config: WorkflowConfig<TInput, TState>;\n\n  constructor(config: WorkflowConfig<TInput, TState>) {\n    this.config = config;\n    this.storage = config.storage || new FileStorage();\n    this.workflowId = config.id;\n\n    if (config.autoResume) {\n      this.resumeAllIncomplete().catch((err) => {\n        console.error(\n          `[ResumableWorkflow: ${this.workflowId}] Auto-resume failed:`,\n          err\n        );\n      });\n    }\n  }\n\n  private async executeStep(\n    currentState: Mutable<WorkflowRunState<TInput, TState>>,\n    stepIndex: number\n  ): Promise<void> {\n    const step = this.config.steps[stepIndex];\n    if (!step) {\n      return;\n    }\n\n    try {\n      const result = await step.run({\n        input: currentState.input,\n        state: currentState.state,\n      });\n\n      if (\n        result !== null &&\n        typeof result === 'object' &&\n        !Array.isArray(result)\n      ) {\n        currentState.state = {\n          ...currentState.state,\n          ...(result as Partial<TState>),\n        };\n      } else if (result !== undefined) {\n        (currentState.state as Record<string, unknown>)[\n          step.name || `step_${stepIndex}`\n        ] = result;\n      }\n\n      currentState.currentStepIndex = stepIndex + 1;\n\n      if (currentState.currentStepIndex === this.config.steps.length) {\n        currentState.status = 'completed';\n      }\n\n      await this.storage.saveRun(currentState);\n    } catch (error) {\n      currentState.status = 'failed';\n      currentState.error =\n        error instanceof Error ? error.message : String(error);\n      await this.storage.saveRun(currentState);\n      throw error;\n    }\n  }\n\n  private async run(\n    input: TInput,\n    existingRun?: WorkflowRunState<TInput, TState>\n  ): Promise<WorkflowResult<TState>> {\n    const runId = existingRun?.runId || randomUUID();\n    const currentState: Mutable<WorkflowRunState<TInput, TState>> =\n      (existingRun as Mutable<WorkflowRunState<TInput, TState>>) || {\n        workflowId: this.workflowId,\n        runId,\n        status: 'pending' as WorkflowStatus,\n        currentStepIndex: 0,\n        input,\n        state: {} as TState,\n      };\n\n    // If resuming a failed/halted run, reset its status to pending\n    if (existingRun && existingRun.status !== 'completed') {\n      currentState.status = 'pending';\n    }\n\n    if (!existingRun) {\n      await this.storage.saveRun(currentState);\n    }\n\n    try {\n      for (\n        let i = currentState.currentStepIndex;\n        i < this.config.steps.length;\n        i++\n      ) {\n        await this.executeStep(currentState, i);\n      }\n    } catch (_error) {\n      return {\n        success: false,\n        error: currentState.error || 'Unknown error',\n        runId: currentState.runId,\n        stepName:\n          this.config.steps[currentState.currentStepIndex]?.name ||\n          `step_${currentState.currentStepIndex}`,\n      };\n    }\n\n    return {\n      success: true,\n      result: currentState.state,\n      runId: currentState.runId,\n    };\n  }\n\n  start(input: TInput): Promise<WorkflowResult<TState>> {\n    return this.run(input);\n  }\n\n  async resume(runId: string): Promise<WorkflowResult<TState>> {\n    const runState = await this.storage.getRun(runId);\n    if (!runState) {\n      return {\n        success: false,\n        error: `Run ${runId} not found`,\n        runId,\n        stepName: 'unknown',\n      };\n    }\n    if (runState.status === 'completed') {\n      return {\n        success: true,\n        result: runState.state as TState,\n        runId: runState.runId,\n      };\n    }\n    return this.run(\n      runState.input as TInput,\n      runState as WorkflowRunState<TInput, TState>\n    );\n  }\n\n  /**\n   * Retrieves the current state of a specific run\n   */\n  async getRun(runId: string): Promise<WorkflowRunState<TInput, TState> | null> {\n    const runState = await this.storage.getRun(runId);\n    return runState as WorkflowRunState<TInput, TState> | null;\n  }\n\n  listIncomplete(): Promise<\n    WorkflowRunState<unknown, Record<string, unknown>>[]\n  > {\n    return this.storage.listIncompleteRuns(this.workflowId);\n  }\n\n  async resumeAllIncomplete(): Promise<WorkflowResult<TState>[]> {\n    const incomplete = await this.storage.listIncompleteRuns(this.workflowId);\n    return Promise.all(\n      incomplete.map((runState) =>\n        this.run(\n          runState.input as TInput,\n          runState as WorkflowRunState<TInput, TState>\n        )\n      )\n    );\n  }\n\n  /**\n   * Clears all incomplete runs for this workflow from storage.\n   * Useful for manual cleanup of stuck processes.\n   */\n  async clearIncomplete(): Promise<void> {\n    const incomplete = await this.storage.listIncompleteRuns(this.workflowId);\n    const fs = await import('node:fs/promises');\n    const path = await import('node:path');\n    \n    // Note: This assumes FileStorage. For custom storage, \n    // we should ideally add a deleteRun method to the StorageProvider interface.\n    // For now, we'll implement a safe cleanup.\n    for (const run of incomplete) {\n      const filePath = path.join('.resumable-workflow', `${run.runId}.json`);\n      await fs.unlink(filePath).catch(() => {});\n    }\n  }\n}\n\n/**\n * Factory function for backward compatibility and ease of use\n */\nexport function createWorkflow<\n  TInput = unknown,\n  TState extends Record<string, unknown> = Record<string, unknown>,\n>(config: WorkflowConfig<TInput, TState>) {\n  return new Workflow(config);\n}\n","import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport type { StorageProvider, WorkflowRunState } from '../types';\n\nexport class FileStorage implements StorageProvider {\n  private readonly baseDir: string;\n\n  constructor(baseDir = '.resumable-workflow') {\n    this.baseDir = path.resolve(baseDir);\n  }\n\n  private async ensureDir(): Promise<void> {\n    await fs.mkdir(this.baseDir, { recursive: true });\n  }\n\n  private getFilePath(runId: string): string {\n    return path.join(this.baseDir, `${runId}.json`);\n  }\n\n  async saveRun(\n    state: WorkflowRunState<unknown, Record<string, unknown>>\n  ): Promise<void> {\n    await this.ensureDir();\n    await fs.writeFile(\n      this.getFilePath(state.runId),\n      JSON.stringify(state, null, 2)\n    );\n  }\n\n  async getRun(\n    runId: string\n  ): Promise<WorkflowRunState<unknown, Record<string, unknown>> | null> {\n    try {\n      const data = await fs.readFile(this.getFilePath(runId), 'utf-8');\n      return JSON.parse(data) as WorkflowRunState<\n        unknown,\n        Record<string, unknown>\n      >;\n    } catch (_e) {\n      // Return null if file doesn't exist or is invalid\n      return null;\n    }\n  }\n\n  async listIncompleteRuns(\n    workflowId: string\n  ): Promise<WorkflowRunState<unknown, Record<string, unknown>>[]> {\n    try {\n      await this.ensureDir();\n      const files = await fs.readdir(this.baseDir);\n      const runs: WorkflowRunState<unknown, Record<string, unknown>>[] = [];\n\n      for (const file of files) {\n        if (file.endsWith('.json')) {\n          const data = await fs.readFile(\n            path.join(this.baseDir, file),\n            'utf-8'\n          );\n          const run = JSON.parse(data) as WorkflowRunState<\n            unknown,\n            Record<string, unknown>\n          >;\n          if (\n            run.workflowId === workflowId &&\n            (run.status === 'pending' || run.status === 'failed')\n          ) {\n            runs.push(run);\n          }\n        }\n      }\n      return runs;\n    } catch (_e) {\n      // Return empty array if directory doesn't exist or fails to read\n      return [];\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,yBAA2B;;;ACA3B,sBAAe;AACf,uBAAiB;AAGV,IAAM,cAAN,MAA6C;AAAA,EAGlD,YAAY,UAAU,uBAAuB;AAC3C,SAAK,UAAU,iBAAAA,QAAK,QAAQ,OAAO;AAAA,EACrC;AAAA,EAEA,MAAc,YAA2B;AACvC,UAAM,gBAAAC,QAAG,MAAM,KAAK,SAAS,EAAE,WAAW,KAAK,CAAC;AAAA,EAClD;AAAA,EAEQ,YAAY,OAAuB;AACzC,WAAO,iBAAAD,QAAK,KAAK,KAAK,SAAS,GAAG,KAAK,OAAO;AAAA,EAChD;AAAA,EAEA,MAAM,QACJ,OACe;AACf,UAAM,KAAK,UAAU;AACrB,UAAM,gBAAAC,QAAG;AAAA,MACP,KAAK,YAAY,MAAM,KAAK;AAAA,MAC5B,KAAK,UAAU,OAAO,MAAM,CAAC;AAAA,IAC/B;AAAA,EACF;AAAA,EAEA,MAAM,OACJ,OACoE;AACpE,QAAI;AACF,YAAM,OAAO,MAAM,gBAAAA,QAAG,SAAS,KAAK,YAAY,KAAK,GAAG,OAAO;AAC/D,aAAO,KAAK,MAAM,IAAI;AAAA,IAIxB,SAAS,IAAI;AAEX,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAM,mBACJ,YAC+D;AAC/D,QAAI;AACF,YAAM,KAAK,UAAU;AACrB,YAAM,QAAQ,MAAM,gBAAAA,QAAG,QAAQ,KAAK,OAAO;AAC3C,YAAM,OAA6D,CAAC;AAEpE,iBAAW,QAAQ,OAAO;AACxB,YAAI,KAAK,SAAS,OAAO,GAAG;AAC1B,gBAAM,OAAO,MAAM,gBAAAA,QAAG;AAAA,YACpB,iBAAAD,QAAK,KAAK,KAAK,SAAS,IAAI;AAAA,YAC5B;AAAA,UACF;AACA,gBAAM,MAAM,KAAK,MAAM,IAAI;AAI3B,cACE,IAAI,eAAe,eAClB,IAAI,WAAW,aAAa,IAAI,WAAW,WAC5C;AACA,iBAAK,KAAK,GAAG;AAAA,UACf;AAAA,QACF;AAAA,MACF;AACA,aAAO;AAAA,IACT,SAAS,IAAI;AAEX,aAAO,CAAC;AAAA,IACV;AAAA,EACF;AACF;;;AD9DO,IAAM,WAAN,MAGL;AAAA,EAKA,YAAY,QAAwC;AAClD,SAAK,SAAS;AACd,SAAK,UAAU,OAAO,WAAW,IAAI,YAAY;AACjD,SAAK,aAAa,OAAO;AAEzB,QAAI,OAAO,YAAY;AACrB,WAAK,oBAAoB,EAAE,MAAM,CAAC,QAAQ;AACxC,gBAAQ;AAAA,UACN,uBAAuB,KAAK,UAAU;AAAA,UACtC;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAAA,EAEA,MAAc,YACZ,cACA,WACe;AACf,UAAM,OAAO,KAAK,OAAO,MAAM,SAAS;AACxC,QAAI,CAAC,MAAM;AACT;AAAA,IACF;AAEA,QAAI;AACF,YAAM,SAAS,MAAM,KAAK,IAAI;AAAA,QAC5B,OAAO,aAAa;AAAA,QACpB,OAAO,aAAa;AAAA,MACtB,CAAC;AAED,UACE,WAAW,QACX,OAAO,WAAW,YAClB,CAAC,MAAM,QAAQ,MAAM,GACrB;AACA,qBAAa,QAAQ;AAAA,UACnB,GAAG,aAAa;AAAA,UAChB,GAAI;AAAA,QACN;AAAA,MACF,WAAW,WAAW,QAAW;AAC/B,QAAC,aAAa,MACZ,KAAK,QAAQ,QAAQ,SAAS,EAChC,IAAI;AAAA,MACN;AAEA,mBAAa,mBAAmB,YAAY;AAE5C,UAAI,aAAa,qBAAqB,KAAK,OAAO,MAAM,QAAQ;AAC9D,qBAAa,SAAS;AAAA,MACxB;AAEA,YAAM,KAAK,QAAQ,QAAQ,YAAY;AAAA,IACzC,SAAS,OAAO;AACd,mBAAa,SAAS;AACtB,mBAAa,QACX,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACvD,YAAM,KAAK,QAAQ,QAAQ,YAAY;AACvC,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEA,MAAc,IACZ,OACA,aACiC;AACjC,UAAM,QAAQ,aAAa,aAAS,+BAAW;AAC/C,UAAM,eACH,eAA6D;AAAA,MAC5D,YAAY,KAAK;AAAA,MACjB;AAAA,MACA,QAAQ;AAAA,MACR,kBAAkB;AAAA,MAClB;AAAA,MACA,OAAO,CAAC;AAAA,IACV;AAGF,QAAI,eAAe,YAAY,WAAW,aAAa;AACrD,mBAAa,SAAS;AAAA,IACxB;AAEA,QAAI,CAAC,aAAa;AAChB,YAAM,KAAK,QAAQ,QAAQ,YAAY;AAAA,IACzC;AAEA,QAAI;AACF,eACM,IAAI,aAAa,kBACrB,IAAI,KAAK,OAAO,MAAM,QACtB,KACA;AACA,cAAM,KAAK,YAAY,cAAc,CAAC;AAAA,MACxC;AAAA,IACF,SAAS,QAAQ;AACf,aAAO;AAAA,QACL,SAAS;AAAA,QACT,OAAO,aAAa,SAAS;AAAA,QAC7B,OAAO,aAAa;AAAA,QACpB,UACE,KAAK,OAAO,MAAM,aAAa,gBAAgB,GAAG,QAClD,QAAQ,aAAa,gBAAgB;AAAA,MACzC;AAAA,IACF;AAEA,WAAO;AAAA,MACL,SAAS;AAAA,MACT,QAAQ,aAAa;AAAA,MACrB,OAAO,aAAa;AAAA,IACtB;AAAA,EACF;AAAA,EAEA,MAAM,OAAgD;AACpD,WAAO,KAAK,IAAI,KAAK;AAAA,EACvB;AAAA,EAEA,MAAM,OAAO,OAAgD;AAC3D,UAAM,WAAW,MAAM,KAAK,QAAQ,OAAO,KAAK;AAChD,QAAI,CAAC,UAAU;AACb,aAAO;AAAA,QACL,SAAS;AAAA,QACT,OAAO,OAAO,KAAK;AAAA,QACnB;AAAA,QACA,UAAU;AAAA,MACZ;AAAA,IACF;AACA,QAAI,SAAS,WAAW,aAAa;AACnC,aAAO;AAAA,QACL,SAAS;AAAA,QACT,QAAQ,SAAS;AAAA,QACjB,OAAO,SAAS;AAAA,MAClB;AAAA,IACF;AACA,WAAO,KAAK;AAAA,MACV,SAAS;AAAA,MACT;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAO,OAAiE;AAC5E,UAAM,WAAW,MAAM,KAAK,QAAQ,OAAO,KAAK;AAChD,WAAO;AAAA,EACT;AAAA,EAEA,iBAEE;AACA,WAAO,KAAK,QAAQ,mBAAmB,KAAK,UAAU;AAAA,EACxD;AAAA,EAEA,MAAM,sBAAyD;AAC7D,UAAM,aAAa,MAAM,KAAK,QAAQ,mBAAmB,KAAK,UAAU;AACxE,WAAO,QAAQ;AAAA,MACb,WAAW;AAAA,QAAI,CAAC,aACd,KAAK;AAAA,UACH,SAAS;AAAA,UACT;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,kBAAiC;AACrC,UAAM,aAAa,MAAM,KAAK,QAAQ,mBAAmB,KAAK,UAAU;AACxE,UAAME,MAAK,MAAM,OAAO,aAAkB;AAC1C,UAAMC,QAAO,MAAM,OAAO,MAAW;AAKrC,eAAW,OAAO,YAAY;AAC5B,YAAM,WAAWA,MAAK,KAAK,uBAAuB,GAAG,IAAI,KAAK,OAAO;AACrE,YAAMD,IAAG,OAAO,QAAQ,EAAE,MAAM,MAAM;AAAA,MAAC,CAAC;AAAA,IAC1C;AAAA,EACF;AACF;AAKO,SAAS,eAGd,QAAwC;AACxC,SAAO,IAAI,SAAS,MAAM;AAC5B;","names":["path","fs","fs","path"]}

package/dist/index.mjs

@@ -157,6 +157,13 @@ var Workflow = class {
       runState
     );
   }
+  /**
+   * Retrieves the current state of a specific run
+   */
+  async getRun(runId) {
+    const runState = await this.storage.getRun(runId);
+    return runState;
+  }
   listIncomplete() {
     return this.storage.listIncompleteRuns(this.workflowId);
   }
@@ -171,6 +178,20 @@ var Workflow = class {
       )
     );
   }
+  /**
+   * Clears all incomplete runs for this workflow from storage.
+   * Useful for manual cleanup of stuck processes.
+   */
+  async clearIncomplete() {
+    const incomplete = await this.storage.listIncompleteRuns(this.workflowId);
+    const fs2 = await import("fs/promises");
+    const path2 = await import("path");
+    for (const run of incomplete) {
+      const filePath = path2.join(".resumable-workflow", `${run.runId}.json`);
+      await fs2.unlink(filePath).catch(() => {
+      });
+    }
+  }
 };
 function createWorkflow(config) {
   return new Workflow(config);

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/engine.ts","../src/storage/file-storage.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { FileStorage } from '../storage/file-storage';\nimport type {\n  StorageProvider,\n  WorkflowConfig,\n  WorkflowResult,\n  WorkflowRunState,\n  WorkflowStatus,\n} from '../types';\n\ntype Mutable<T> = {\n  -readonly [P in keyof T]: T[P];\n};\n\nexport class Workflow<\n  TInput = unknown,\n  TState extends Record<string, unknown> = Record<string, unknown>,\n> {\n  private readonly storage: StorageProvider;\n  private readonly workflowId: string;\n  private readonly config: WorkflowConfig<TInput, TState>;\n\n  constructor(config: WorkflowConfig<TInput, TState>) {\n    this.config = config;\n    this.storage = config.storage || new FileStorage();\n    this.workflowId = config.id;\n\n    if (config.autoResume) {\n      this.resumeAllIncomplete().catch((err) => {\n        console.error(\n          `[ResumableWorkflow: ${this.workflowId}] Auto-resume failed:`,\n          err\n        );\n      });\n    }\n  }\n\n  private async executeStep(\n    currentState: Mutable<WorkflowRunState<TInput, TState>>,\n    stepIndex: number\n  ): Promise<void> {\n    const step = this.config.steps[stepIndex];\n    if (!step) {\n      return;\n    }\n\n    try {\n      const result = await step.run({\n        input: currentState.input,\n        state: currentState.state,\n      });\n\n      if (\n        result !== null &&\n        typeof result === 'object' &&\n        !Array.isArray(result)\n      ) {\n        currentState.state = {\n          ...currentState.state,\n          ...(result as Partial<TState>),\n        };\n      } else if (result !== undefined) {\n        (currentState.state as Record<string, unknown>)[\n          step.name || `step_${stepIndex}`\n        ] = result;\n      }\n\n      currentState.currentStepIndex = stepIndex + 1;\n\n      if (currentState.currentStepIndex === this.config.steps.length) {\n        currentState.status = 'completed';\n      }\n\n      await this.storage.saveRun(currentState);\n    } catch (error) {\n      currentState.status = 'failed';\n      currentState.error =\n        error instanceof Error ? error.message : String(error);\n      await this.storage.saveRun(currentState);\n      throw error;\n    }\n  }\n\n  private async run(\n    input: TInput,\n    existingRun?: WorkflowRunState<TInput, TState>\n  ): Promise<WorkflowResult<TState>> {\n    const runId = existingRun?.runId || randomUUID();\n    const currentState: Mutable<WorkflowRunState<TInput, TState>> =\n      (existingRun as Mutable<WorkflowRunState<TInput, TState>>) || {\n        workflowId: this.workflowId,\n        runId,\n        status: 'pending' as WorkflowStatus,\n        currentStepIndex: 0,\n        input,\n        state: {} as TState,\n      };\n\n    // If resuming a failed/halted run, reset its status to pending\n    if (existingRun && existingRun.status !== 'completed') {\n      currentState.status = 'pending';\n    }\n\n    if (!existingRun) {\n      await this.storage.saveRun(currentState);\n    }\n\n    try {\n      for (\n        let i = currentState.currentStepIndex;\n        i < this.config.steps.length;\n        i++\n      ) {\n        await this.executeStep(currentState, i);\n      }\n    } catch (_error) {\n      return {\n        success: false,\n        error: currentState.error || 'Unknown error',\n        runId: currentState.runId,\n        stepName:\n          this.config.steps[currentState.currentStepIndex]?.name ||\n          `step_${currentState.currentStepIndex}`,\n      };\n    }\n\n    return {\n      success: true,\n      result: currentState.state,\n      runId: currentState.runId,\n    };\n  }\n\n  start(input: TInput): Promise<WorkflowResult<TState>> {\n    return this.run(input);\n  }\n\n  async resume(runId: string): Promise<WorkflowResult<TState>> {\n    const runState = await this.storage.getRun(runId);\n    if (!runState) {\n      return {\n        success: false,\n        error: `Run ${runId} not found`,\n        runId,\n        stepName: 'unknown',\n      };\n    }\n    if (runState.status === 'completed') {\n      return {\n        success: true,\n        result: runState.state as TState,\n        runId: runState.runId,\n      };\n    }\n    return this.run(\n      runState.input as TInput,\n      runState as WorkflowRunState<TInput, TState>\n    );\n  }\n\n  listIncomplete(): Promise<\n    WorkflowRunState<unknown, Record<string, unknown>>[]\n  > {\n    return this.storage.listIncompleteRuns(this.workflowId);\n  }\n\n  async resumeAllIncomplete(): Promise<WorkflowResult<TState>[]> {\n    const incomplete = await this.storage.listIncompleteRuns(this.workflowId);\n    return Promise.all(\n      incomplete.map((runState) =>\n        this.run(\n          runState.input as TInput,\n          runState as WorkflowRunState<TInput, TState>\n        )\n      )\n    );\n  }\n}\n\n/**\n * Factory function for backward compatibility and ease of use\n */\nexport function createWorkflow<\n  TInput = unknown,\n  TState extends Record<string, unknown> = Record<string, unknown>,\n>(config: WorkflowConfig<TInput, TState>) {\n  return new Workflow(config);\n}\n","import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport type { StorageProvider, WorkflowRunState } from '../types';\n\nexport class FileStorage implements StorageProvider {\n  private readonly baseDir: string;\n\n  constructor(baseDir = '.resumable-workflow') {\n    this.baseDir = path.resolve(baseDir);\n  }\n\n  private async ensureDir(): Promise<void> {\n    await fs.mkdir(this.baseDir, { recursive: true });\n  }\n\n  private getFilePath(runId: string): string {\n    return path.join(this.baseDir, `${runId}.json`);\n  }\n\n  async saveRun(\n    state: WorkflowRunState<unknown, Record<string, unknown>>\n  ): Promise<void> {\n    await this.ensureDir();\n    await fs.writeFile(\n      this.getFilePath(state.runId),\n      JSON.stringify(state, null, 2)\n    );\n  }\n\n  async getRun(\n    runId: string\n  ): Promise<WorkflowRunState<unknown, Record<string, unknown>> | null> {\n    try {\n      const data = await fs.readFile(this.getFilePath(runId), 'utf-8');\n      return JSON.parse(data) as WorkflowRunState<\n        unknown,\n        Record<string, unknown>\n      >;\n    } catch (_e) {\n      // Return null if file doesn't exist or is invalid\n      return null;\n    }\n  }\n\n  async listIncompleteRuns(\n    workflowId: string\n  ): Promise<WorkflowRunState<unknown, Record<string, unknown>>[]> {\n    try {\n      await this.ensureDir();\n      const files = await fs.readdir(this.baseDir);\n      const runs: WorkflowRunState<unknown, Record<string, unknown>>[] = [];\n\n      for (const file of files) {\n        if (file.endsWith('.json')) {\n          const data = await fs.readFile(\n            path.join(this.baseDir, file),\n            'utf-8'\n          );\n          const run = JSON.parse(data) as WorkflowRunState<\n            unknown,\n            Record<string, unknown>\n          >;\n          if (\n            run.workflowId === workflowId &&\n            (run.status === 'pending' || run.status === 'failed')\n          ) {\n            runs.push(run);\n          }\n        }\n      }\n      return runs;\n    } catch (_e) {\n      // Return empty array if directory doesn't exist or fails to read\n      return [];\n    }\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/core/engine.ts","../src/storage/file-storage.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { FileStorage } from '../storage/file-storage';\nimport type {\n  StorageProvider,\n  WorkflowConfig,\n  WorkflowResult,\n  WorkflowRunState,\n  WorkflowStatus,\n} from '../types';\n\ntype Mutable<T> = {\n  -readonly [P in keyof T]: T[P];\n};\n\nexport class Workflow<\n  TInput = unknown,\n  TState extends Record<string, unknown> = Record<string, unknown>,\n> {\n  private readonly storage: StorageProvider;\n  private readonly workflowId: string;\n  private readonly config: WorkflowConfig<TInput, TState>;\n\n  constructor(config: WorkflowConfig<TInput, TState>) {\n    this.config = config;\n    this.storage = config.storage || new FileStorage();\n    this.workflowId = config.id;\n\n    if (config.autoResume) {\n      this.resumeAllIncomplete().catch((err) => {\n        console.error(\n          `[ResumableWorkflow: ${this.workflowId}] Auto-resume failed:`,\n          err\n        );\n      });\n    }\n  }\n\n  private async executeStep(\n    currentState: Mutable<WorkflowRunState<TInput, TState>>,\n    stepIndex: number\n  ): Promise<void> {\n    const step = this.config.steps[stepIndex];\n    if (!step) {\n      return;\n    }\n\n    try {\n      const result = await step.run({\n        input: currentState.input,\n        state: currentState.state,\n      });\n\n      if (\n        result !== null &&\n        typeof result === 'object' &&\n        !Array.isArray(result)\n      ) {\n        currentState.state = {\n          ...currentState.state,\n          ...(result as Partial<TState>),\n        };\n      } else if (result !== undefined) {\n        (currentState.state as Record<string, unknown>)[\n          step.name || `step_${stepIndex}`\n        ] = result;\n      }\n\n      currentState.currentStepIndex = stepIndex + 1;\n\n      if (currentState.currentStepIndex === this.config.steps.length) {\n        currentState.status = 'completed';\n      }\n\n      await this.storage.saveRun(currentState);\n    } catch (error) {\n      currentState.status = 'failed';\n      currentState.error =\n        error instanceof Error ? error.message : String(error);\n      await this.storage.saveRun(currentState);\n      throw error;\n    }\n  }\n\n  private async run(\n    input: TInput,\n    existingRun?: WorkflowRunState<TInput, TState>\n  ): Promise<WorkflowResult<TState>> {\n    const runId = existingRun?.runId || randomUUID();\n    const currentState: Mutable<WorkflowRunState<TInput, TState>> =\n      (existingRun as Mutable<WorkflowRunState<TInput, TState>>) || {\n        workflowId: this.workflowId,\n        runId,\n        status: 'pending' as WorkflowStatus,\n        currentStepIndex: 0,\n        input,\n        state: {} as TState,\n      };\n\n    // If resuming a failed/halted run, reset its status to pending\n    if (existingRun && existingRun.status !== 'completed') {\n      currentState.status = 'pending';\n    }\n\n    if (!existingRun) {\n      await this.storage.saveRun(currentState);\n    }\n\n    try {\n      for (\n        let i = currentState.currentStepIndex;\n        i < this.config.steps.length;\n        i++\n      ) {\n        await this.executeStep(currentState, i);\n      }\n    } catch (_error) {\n      return {\n        success: false,\n        error: currentState.error || 'Unknown error',\n        runId: currentState.runId,\n        stepName:\n          this.config.steps[currentState.currentStepIndex]?.name ||\n          `step_${currentState.currentStepIndex}`,\n      };\n    }\n\n    return {\n      success: true,\n      result: currentState.state,\n      runId: currentState.runId,\n    };\n  }\n\n  start(input: TInput): Promise<WorkflowResult<TState>> {\n    return this.run(input);\n  }\n\n  async resume(runId: string): Promise<WorkflowResult<TState>> {\n    const runState = await this.storage.getRun(runId);\n    if (!runState) {\n      return {\n        success: false,\n        error: `Run ${runId} not found`,\n        runId,\n        stepName: 'unknown',\n      };\n    }\n    if (runState.status === 'completed') {\n      return {\n        success: true,\n        result: runState.state as TState,\n        runId: runState.runId,\n      };\n    }\n    return this.run(\n      runState.input as TInput,\n      runState as WorkflowRunState<TInput, TState>\n    );\n  }\n\n  /**\n   * Retrieves the current state of a specific run\n   */\n  async getRun(runId: string): Promise<WorkflowRunState<TInput, TState> | null> {\n    const runState = await this.storage.getRun(runId);\n    return runState as WorkflowRunState<TInput, TState> | null;\n  }\n\n  listIncomplete(): Promise<\n    WorkflowRunState<unknown, Record<string, unknown>>[]\n  > {\n    return this.storage.listIncompleteRuns(this.workflowId);\n  }\n\n  async resumeAllIncomplete(): Promise<WorkflowResult<TState>[]> {\n    const incomplete = await this.storage.listIncompleteRuns(this.workflowId);\n    return Promise.all(\n      incomplete.map((runState) =>\n        this.run(\n          runState.input as TInput,\n          runState as WorkflowRunState<TInput, TState>\n        )\n      )\n    );\n  }\n\n  /**\n   * Clears all incomplete runs for this workflow from storage.\n   * Useful for manual cleanup of stuck processes.\n   */\n  async clearIncomplete(): Promise<void> {\n    const incomplete = await this.storage.listIncompleteRuns(this.workflowId);\n    const fs = await import('node:fs/promises');\n    const path = await import('node:path');\n    \n    // Note: This assumes FileStorage. For custom storage, \n    // we should ideally add a deleteRun method to the StorageProvider interface.\n    // For now, we'll implement a safe cleanup.\n    for (const run of incomplete) {\n      const filePath = path.join('.resumable-workflow', `${run.runId}.json`);\n      await fs.unlink(filePath).catch(() => {});\n    }\n  }\n}\n\n/**\n * Factory function for backward compatibility and ease of use\n */\nexport function createWorkflow<\n  TInput = unknown,\n  TState extends Record<string, unknown> = Record<string, unknown>,\n>(config: WorkflowConfig<TInput, TState>) {\n  return new Workflow(config);\n}\n","import fs from 'node:fs/promises';\nimport path from 'node:path';\nimport type { StorageProvider, WorkflowRunState } from '../types';\n\nexport class FileStorage implements StorageProvider {\n  private readonly baseDir: string;\n\n  constructor(baseDir = '.resumable-workflow') {\n    this.baseDir = path.resolve(baseDir);\n  }\n\n  private async ensureDir(): Promise<void> {\n    await fs.mkdir(this.baseDir, { recursive: true });\n  }\n\n  private getFilePath(runId: string): string {\n    return path.join(this.baseDir, `${runId}.json`);\n  }\n\n  async saveRun(\n    state: WorkflowRunState<unknown, Record<string, unknown>>\n  ): Promise<void> {\n    await this.ensureDir();\n    await fs.writeFile(\n      this.getFilePath(state.runId),\n      JSON.stringify(state, null, 2)\n    );\n  }\n\n  async getRun(\n    runId: string\n  ): Promise<WorkflowRunState<unknown, Record<string, unknown>> | null> {\n    try {\n      const data = await fs.readFile(this.getFilePath(runId), 'utf-8');\n      return JSON.parse(data) as WorkflowRunState<\n        unknown,\n        Record<string, unknown>\n      >;\n    } catch (_e) {\n      // Return null if file doesn't exist or is invalid\n      return null;\n    }\n  }\n\n  async listIncompleteRuns(\n    workflowId: string\n  ): Promise<WorkflowRunState<unknown, Record<string, unknown>>[]> {\n    try {\n      await this.ensureDir();\n      const files = await fs.readdir(this.baseDir);\n      const runs: WorkflowRunState<unknown, Record<string, unknown>>[] = [];\n\n      for (const file of files) {\n        if (file.endsWith('.json')) {\n          const data = await fs.readFile(\n            path.join(this.baseDir, file),\n            'utf-8'\n          );\n          const run = JSON.parse(data) as WorkflowRunState<\n            unknown,\n            Record<string, unknown>\n          >;\n          if (\n            run.workflowId === workflowId &&\n            (run.status === 'pending' || run.status === 'failed')\n          ) {\n            runs.push(run);\n          }\n        }\n      }\n      return runs;\n    } catch (_e) {\n      // Return empty array if directory doesn't exist or fails to read\n      return [];\n    }\n  }\n}\n"],"mappings":"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","names":["fs","path"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "resumable-workflow",
-  "version": "1.1.3",
+  "version": "1.3.0",
   "description": "A lightweight, persistent workflow engine for Node.js. Ensure multi-step processes survive crashes and resume automatically.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/dist/.fuse_hidden00018eed00000002

@@ -1,219 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  FileStorage: () => FileStorage,
-  Workflow: () => Workflow,
-  createWorkflow: () => createWorkflow
-});
-module.exports = __toCommonJS(index_exports);
-
-// src/core/engine.ts
-var import_node_crypto = require("crypto");
-
-// src/storage/file-storage.ts
-var import_promises = __toESM(require("fs/promises"));
-var import_node_path = __toESM(require("path"));
-var FileStorage = class {
-  constructor(baseDir = ".resumable-workflow") {
-    this.baseDir = import_node_path.default.resolve(baseDir);
-  }
-  async ensureDir() {
-    await import_promises.default.mkdir(this.baseDir, { recursive: true });
-  }
-  getFilePath(runId) {
-    return import_node_path.default.join(this.baseDir, `${runId}.json`);
-  }
-  async saveRun(state) {
-    await this.ensureDir();
-    await import_promises.default.writeFile(
-      this.getFilePath(state.runId),
-      JSON.stringify(state, null, 2)
-    );
-  }
-  async getRun(runId) {
-    try {
-      const data = await import_promises.default.readFile(this.getFilePath(runId), "utf-8");
-      return JSON.parse(data);
-    } catch (_e) {
-      return null;
-    }
-  }
-  async listIncompleteRuns(workflowId) {
-    try {
-      await this.ensureDir();
-      const files = await import_promises.default.readdir(this.baseDir);
-      const runs = [];
-      for (const file of files) {
-        if (file.endsWith(".json")) {
-          const data = await import_promises.default.readFile(
-            import_node_path.default.join(this.baseDir, file),
-            "utf-8"
-          );
-          const run = JSON.parse(data);
-          if (run.workflowId === workflowId && (run.status === "pending" || run.status === "failed")) {
-            runs.push(run);
-          }
-        }
-      }
-      return runs;
-    } catch (_e) {
-      return [];
-    }
-  }
-};
-
-// src/core/engine.ts
-var Workflow = class {
-  constructor(config) {
-    this.config = config;
-    this.storage = config.storage || new FileStorage();
-    this.workflowId = config.id;
-    if (config.autoResume) {
-      this.resumeAllIncomplete().catch((err) => {
-        console.error(
-          `[ResumableWorkflow: ${this.workflowId}] Auto-resume failed:`,
-          err
-        );
-      });
-    }
-  }
-  async executeStep(currentState, stepIndex) {
-    const step = this.config.steps[stepIndex];
-    if (!step) {
-      return;
-    }
-    try {
-      const result = await step.run({
-        input: currentState.input,
-        state: currentState.state
-      });
-      if (result !== null && typeof result === "object" && !Array.isArray(result)) {
-        currentState.state = {
-          ...currentState.state,
-          ...result
-        };
-      } else if (result !== void 0) {
-        currentState.state[step.name || `step_${stepIndex}`] = result;
-      }
-      currentState.currentStepIndex = stepIndex + 1;
-      if (currentState.currentStepIndex === this.config.steps.length) {
-        currentState.status = "completed";
-      }
-      await this.storage.saveRun(currentState);
-    } catch (error) {
-      currentState.status = "failed";
-      currentState.error = error instanceof Error ? error.message : String(error);
-      await this.storage.saveRun(currentState);
-      throw error;
-    }
-  }
-  async run(input, existingRun) {
-    const runId = existingRun?.runId || (0, import_node_crypto.randomUUID)();
-    const currentState = existingRun || {
-      workflowId: this.workflowId,
-      runId,
-      status: "pending",
-      currentStepIndex: 0,
-      input,
-      state: {}
-    };
-    if (!existingRun) {
-      await this.storage.saveRun(currentState);
-    }
-    try {
-      for (let i = currentState.currentStepIndex; i < this.config.steps.length; i++) {
-        await this.executeStep(currentState, i);
-      }
-    } catch (_error) {
-      return {
-        success: false,
-        error: currentState.error || "Unknown error",
-        runId: currentState.runId,
-        stepName: this.config.steps[currentState.currentStepIndex]?.name || `step_${currentState.currentStepIndex}`
-      };
-    }
-    return {
-      success: true,
-      result: currentState.state,
-      runId: currentState.runId
-    };
-  }
-  start(input) {
-    return this.run(input);
-  }
-  async resume(runId) {
-    const runState = await this.storage.getRun(runId);
-    if (!runState) {
-      return {
-        success: false,
-        error: `Run ${runId} not found`,
-        runId,
-        stepName: "unknown"
-      };
-    }
-    if (runState.status === "completed") {
-      return {
-        success: true,
-        result: runState.state,
-        runId: runState.runId
-      };
-    }
-    return this.run(
-      runState.input,
-      runState
-    );
-  }
-  listIncomplete() {
-    return this.storage.listIncompleteRuns(this.workflowId);
-  }
-  async resumeAllIncomplete() {
-    const incomplete = await this.storage.listIncompleteRuns(this.workflowId);
-    return Promise.all(
-      incomplete.map(
-        (runState) => this.run(
-          runState.input,
-          runState
-        )
-      )
-    );
-  }
-};
-function createWorkflow(config) {
-  return new Workflow(config);
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  FileStorage,
-  Workflow,
-  createWorkflow
-});
-//# sourceMappingURL=index.js.map