@hexabot-ai/agentic 3.0.2-alpha.0 → 3.1.0-alpha.0

package/dist/cjs/action/abstract-action.js

@@ -19,7 +19,6 @@ class AbstractAction {
      * Sets up core metadata and schemas for the action.
      *
      * @param metadata - Describes the action name, description, and schemas.
-     * @param options - Optional configuration or definition override.
      */
     constructor(metadata) {
         if (metadata.settingsSchema instanceof zod_1.z.ZodObject) {
@@ -59,7 +58,6 @@ class AbstractAction {
      * Executes the action with retry, timeout, and schema safety.
      *
      * @param payload - Raw input being provided to the action.
-     * @param context - Workflow context used during execution.
      * @returns Validated output produced by the action.
      * @throws Error when retries are exhausted or validation fails.
      */

package/dist/cjs/context.js

@@ -5,7 +5,30 @@
  * Full terms: see LICENSE.md.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseWorkflowContext = void 0;
+exports.BaseWorkflowContext = exports.WORKFLOW_RUN_STATUSES = exports.EWorkflowRunStatus = void 0;
+/**
+ * Lifecycle of a workflow run:
+ * - idle: runner constructed but `start` not invoked.
+ * - running: set when `start` or `resume` begins executing steps.
+ * - suspended: an action awaited `workflow.suspend`; `resume` moves back to running.
+ * - finished: all steps completed and outputs were evaluated successfully.
+ * - failed: an uncaught error bubbled out of a step or continuation.
+ */
+var EWorkflowRunStatus;
+(function (EWorkflowRunStatus) {
+    EWorkflowRunStatus["IDLE"] = "idle";
+    EWorkflowRunStatus["RUNNING"] = "running";
+    EWorkflowRunStatus["SUSPENDED"] = "suspended";
+    EWorkflowRunStatus["FINISHED"] = "finished";
+    EWorkflowRunStatus["FAILED"] = "failed";
+})(EWorkflowRunStatus || (exports.EWorkflowRunStatus = EWorkflowRunStatus = {}));
+exports.WORKFLOW_RUN_STATUSES = [
+    EWorkflowRunStatus.IDLE,
+    EWorkflowRunStatus.RUNNING,
+    EWorkflowRunStatus.SUSPENDED,
+    EWorkflowRunStatus.FINISHED,
+    EWorkflowRunStatus.FAILED,
+];
 /**
  * Base context that is threaded through every workflow execution.
  *

package/dist/cjs/index.js

@@ -19,13 +19,15 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.withTimeout = exports.sleep = exports.toSnakeCase = exports.isSnakeCaseName = exports.assertSnakeCaseName = exports.createDeferred = exports.mergeSettings = exports.evaluateValue = exports.evaluateMapping = exports.compileValue = exports.NonDeterministicWorkflowError = exports.StepType = exports.WorkflowRunner = exports.WorkflowEventEmitter = exports.Workflow = exports.compileWorkflow = exports.BaseWorkflowContext = exports.defineAction = exports.AbstractAction = void 0;
+exports.withTimeout = exports.sleep = exports.toSnakeCase = exports.isSnakeCaseName = exports.assertSnakeCaseName = exports.createDeferred = exports.mergeSettings = exports.evaluateValue = exports.evaluateMapping = exports.compileValue = exports.NonDeterministicWorkflowError = exports.StepType = exports.WorkflowRunner = exports.WorkflowEventEmitter = exports.Workflow = exports.compileWorkflow = exports.WORKFLOW_RUN_STATUSES = exports.EWorkflowRunStatus = exports.BaseWorkflowContext = exports.defineAction = exports.AbstractAction = void 0;
 var abstract_action_1 = require("./action/abstract-action");
 Object.defineProperty(exports, "AbstractAction", { enumerable: true, get: function () { return abstract_action_1.AbstractAction; } });
 var action_1 = require("./action/action");
 Object.defineProperty(exports, "defineAction", { enumerable: true, get: function () { return action_1.defineAction; } });
 var context_1 = require("./context");
 Object.defineProperty(exports, "BaseWorkflowContext", { enumerable: true, get: function () { return context_1.BaseWorkflowContext; } });
+Object.defineProperty(exports, "EWorkflowRunStatus", { enumerable: true, get: function () { return context_1.EWorkflowRunStatus; } });
+Object.defineProperty(exports, "WORKFLOW_RUN_STATUSES", { enumerable: true, get: function () { return context_1.WORKFLOW_RUN_STATUSES; } });
 __exportStar(require("./dsl.types"), exports);
 var workflow_1 = require("./workflow");
 Object.defineProperty(exports, "compileWorkflow", { enumerable: true, get: function () { return workflow_1.compileWorkflow; } });

package/dist/cjs/workflow-runner.js

@@ -6,6 +6,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WorkflowRunner = void 0;
+const context_1 = require("./context");
 const runner_runtime_control_1 = require("./runner-runtime-control");
 const conditional_executor_1 = require("./step-executors/conditional-executor");
 const loop_executor_1 = require("./step-executors/loop-executor");
@@ -27,7 +28,7 @@ class WorkflowRunner {
      */
     constructor(compiled, options) {
         // Current lifecycle status of the workflow execution.
-        this.status = 'idle';
+        this.status = context_1.EWorkflowRunStatus.IDLE;
         // Snapshots of action execution keyed by step id for inspection/resume.
         this.snapshots = {};
         // Detailed execution records for each task step, used by UI/telemetry.
@@ -101,7 +102,7 @@ class WorkflowRunner {
      * @returns Execution result including status and snapshot.
      */
     async start(args) {
-        this.status = 'running';
+        this.status = context_1.EWorkflowRunStatus.RUNNING;
         this.snapshots = {};
         this.stepLog = {};
         this.suspension = undefined;
@@ -129,13 +130,13 @@ class WorkflowRunner {
      * @returns Execution result including status and snapshot.
      */
     async resume(args) {
-        if (this.status !== 'suspended' || !this.suspension) {
+        if (this.status !== context_1.EWorkflowRunStatus.SUSPENDED || !this.suspension) {
             throw new Error('Cannot resume a workflow that is not suspended.');
         }
         if (!this.context || !this.state) {
             throw new Error('Workflow state is not initialized.');
         }
-        this.status = 'running';
+        this.status = context_1.EWorkflowRunStatus.RUNNING;
         this.lastResumeData = args.resumeData;
         const suspension = this.suspension;
         return this.runExecution(() => suspension.continue(args.resumeData));
@@ -151,7 +152,7 @@ class WorkflowRunner {
             const suspension = await execute();
             if (suspension) {
                 this.suspension = suspension;
-                this.status = 'suspended';
+                this.status = context_1.EWorkflowRunStatus.SUSPENDED;
                 this.emit('hook:workflow:suspended', {
                     runId: this.runId,
                     step: suspension.step,
@@ -159,7 +160,7 @@ class WorkflowRunner {
                     data: suspension.data,
                 });
                 return {
-                    status: 'suspended',
+                    status: context_1.EWorkflowRunStatus.SUSPENDED,
                     step: suspension.step,
                     reason: suspension.reason,
                     data: suspension.data,
@@ -171,7 +172,7 @@ class WorkflowRunner {
                 };
             }
             const output = await this.evaluateWorkflowOutputs();
-            this.status = 'finished';
+            this.status = context_1.EWorkflowRunStatus.FINISHED;
             this.suspension = undefined;
             this.currentStep = undefined;
             this.emit('hook:workflow:finish', { runId: this.runId, output });
@@ -179,14 +180,22 @@ class WorkflowRunner {
                 throw new Error('Workflow context is not attached.');
             }
             this.context.attachWorkflowRuntime(undefined);
-            return { status: 'finished', output, snapshot: this.getSnapshot() };
+            return {
+                status: context_1.EWorkflowRunStatus.FINISHED,
+                output,
+                snapshot: this.getSnapshot(),
+            };
         }
         catch (error) {
-            this.status = 'failed';
+            this.status = context_1.EWorkflowRunStatus.FAILED;
             this.currentStep = undefined;
             this.emit('hook:workflow:failure', { runId: this.runId, error });
             this.context?.attachWorkflowRuntime(undefined);
-            return { status: 'failed', error, snapshot: this.getSnapshot() };
+            return {
+                status: context_1.EWorkflowRunStatus.FAILED,
+                error,
+                snapshot: this.getSnapshot(),
+            };
         }
     }
     /**
@@ -210,7 +219,7 @@ class WorkflowRunner {
         runner.context = options.context;
         runner.snapshots = options.snapshot.actions ?? {};
         runner.stepLog = {};
-        runner.status = options.snapshot.status ?? 'idle';
+        runner.status = options.snapshot.status ?? context_1.EWorkflowRunStatus.IDLE;
         runner.lastResumeData = options.lastResumeData;
         runner.runtimeControl = new runner_runtime_control_1.RunnerRuntimeControl(runner);
         options.context.attachWorkflowRuntime(runner.runtimeControl);
@@ -229,7 +238,7 @@ class WorkflowRunner {
                 throw new Error(`Unable to rebuild suspension for step ${options.suspension.stepId}`);
             }
             runner.suspension = suspension;
-            runner.status = 'suspended';
+            runner.status = context_1.EWorkflowRunStatus.SUSPENDED;
         }
         return runner;
     }
@@ -436,7 +445,7 @@ class WorkflowRunner {
     }
     /**
      * Store the raw task result under the task name in the workflow output state.
-     * @reviewed
+     *
      * @param task The task whose output is being captured.
      * @param state Current execution state to mutate.
      * @param result Raw result returned by the task action.

package/dist/cjs/workflow.js

@@ -7,6 +7,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Workflow = exports.WorkflowRunner = exports.WorkflowEventEmitter = exports.compileWorkflow = void 0;
 const yaml_1 = require("yaml");
+const context_1 = require("./context");
 const dsl_types_1 = require("./dsl.types");
 const workflow_definition_1 = require("./utils/workflow-definition");
 const workflow_compiler_1 = require("./workflow-compiler");
@@ -213,10 +214,10 @@ class Workflow {
             inputData,
             context,
         });
-        if (result.status === 'finished') {
+        if (result.status === context_1.EWorkflowRunStatus.FINISHED) {
             return result.output;
         }
-        if (result.status === 'failed') {
+        if (result.status === context_1.EWorkflowRunStatus.FAILED) {
             throw result.error instanceof Error
                 ? result.error
                 : new Error(String(result.error));

package/dist/esm/action/abstract-action.js

@@ -16,7 +16,6 @@ export class AbstractAction {
      * Sets up core metadata and schemas for the action.
      *
      * @param metadata - Describes the action name, description, and schemas.
-     * @param options - Optional configuration or definition override.
      */
     constructor(metadata) {
         if (metadata.settingsSchema instanceof z.ZodObject) {
@@ -56,7 +55,6 @@ export class AbstractAction {
      * Executes the action with retry, timeout, and schema safety.
      *
      * @param payload - Raw input being provided to the action.
-     * @param context - Workflow context used during execution.
      * @returns Validated output produced by the action.
      * @throws Error when retries are exhausted or validation fails.
      */

package/dist/esm/context.js

@@ -3,6 +3,29 @@
  * Copyright (c) 2025 Hexastack.
  * Full terms: see LICENSE.md.
  */
+/**
+ * Lifecycle of a workflow run:
+ * - idle: runner constructed but `start` not invoked.
+ * - running: set when `start` or `resume` begins executing steps.
+ * - suspended: an action awaited `workflow.suspend`; `resume` moves back to running.
+ * - finished: all steps completed and outputs were evaluated successfully.
+ * - failed: an uncaught error bubbled out of a step or continuation.
+ */
+export var EWorkflowRunStatus;
+(function (EWorkflowRunStatus) {
+    EWorkflowRunStatus["IDLE"] = "idle";
+    EWorkflowRunStatus["RUNNING"] = "running";
+    EWorkflowRunStatus["SUSPENDED"] = "suspended";
+    EWorkflowRunStatus["FINISHED"] = "finished";
+    EWorkflowRunStatus["FAILED"] = "failed";
+})(EWorkflowRunStatus || (EWorkflowRunStatus = {}));
+export const WORKFLOW_RUN_STATUSES = [
+    EWorkflowRunStatus.IDLE,
+    EWorkflowRunStatus.RUNNING,
+    EWorkflowRunStatus.SUSPENDED,
+    EWorkflowRunStatus.FINISHED,
+    EWorkflowRunStatus.FAILED,
+];
 /**
  * Base context that is threaded through every workflow execution.
  *

package/dist/esm/index.js

@@ -5,9 +5,9 @@
  */
 export { AbstractAction } from './action/abstract-action';
 export { defineAction } from './action/action';
-export { BaseWorkflowContext, } from './context';
+export { BaseWorkflowContext, EWorkflowRunStatus, WORKFLOW_RUN_STATUSES, } from './context';
 export * from './dsl.types';
-export { compileWorkflow, Workflow as Workflow, WorkflowEventEmitter, WorkflowRunner, } from './workflow';
+export { compileWorkflow, Workflow, WorkflowEventEmitter, WorkflowRunner, } from './workflow';
 export { StepType } from './workflow-event-emitter';
 export { NonDeterministicWorkflowError } from './runner-runtime-control';
 export { compileValue, evaluateMapping, evaluateValue, mergeSettings, } from './workflow-values';

package/dist/esm/workflow-runner.js

@@ -3,6 +3,7 @@
  * Copyright (c) 2025 Hexastack.
  * Full terms: see LICENSE.md.
  */
+import { EWorkflowRunStatus, } from './context';
 import { RunnerRuntimeControl } from './runner-runtime-control';
 import { executeConditional as runConditionalExecutor } from './step-executors/conditional-executor';
 import { executeLoop as runLoopExecutor } from './step-executors/loop-executor';
@@ -24,7 +25,7 @@ export class WorkflowRunner {
      */
     constructor(compiled, options) {
         // Current lifecycle status of the workflow execution.
-        this.status = 'idle';
+        this.status = EWorkflowRunStatus.IDLE;
         // Snapshots of action execution keyed by step id for inspection/resume.
         this.snapshots = {};
         // Detailed execution records for each task step, used by UI/telemetry.
@@ -98,7 +99,7 @@ export class WorkflowRunner {
      * @returns Execution result including status and snapshot.
      */
     async start(args) {
-        this.status = 'running';
+        this.status = EWorkflowRunStatus.RUNNING;
         this.snapshots = {};
         this.stepLog = {};
         this.suspension = undefined;
@@ -126,13 +127,13 @@ export class WorkflowRunner {
      * @returns Execution result including status and snapshot.
      */
     async resume(args) {
-        if (this.status !== 'suspended' || !this.suspension) {
+        if (this.status !== EWorkflowRunStatus.SUSPENDED || !this.suspension) {
             throw new Error('Cannot resume a workflow that is not suspended.');
         }
         if (!this.context || !this.state) {
             throw new Error('Workflow state is not initialized.');
         }
-        this.status = 'running';
+        this.status = EWorkflowRunStatus.RUNNING;
         this.lastResumeData = args.resumeData;
         const suspension = this.suspension;
         return this.runExecution(() => suspension.continue(args.resumeData));
@@ -148,7 +149,7 @@ export class WorkflowRunner {
             const suspension = await execute();
             if (suspension) {
                 this.suspension = suspension;
-                this.status = 'suspended';
+                this.status = EWorkflowRunStatus.SUSPENDED;
                 this.emit('hook:workflow:suspended', {
                     runId: this.runId,
                     step: suspension.step,
@@ -156,7 +157,7 @@ export class WorkflowRunner {
                     data: suspension.data,
                 });
                 return {
-                    status: 'suspended',
+                    status: EWorkflowRunStatus.SUSPENDED,
                     step: suspension.step,
                     reason: suspension.reason,
                     data: suspension.data,
@@ -168,7 +169,7 @@ export class WorkflowRunner {
                 };
             }
             const output = await this.evaluateWorkflowOutputs();
-            this.status = 'finished';
+            this.status = EWorkflowRunStatus.FINISHED;
             this.suspension = undefined;
             this.currentStep = undefined;
             this.emit('hook:workflow:finish', { runId: this.runId, output });
@@ -176,14 +177,22 @@ export class WorkflowRunner {
                 throw new Error('Workflow context is not attached.');
             }
             this.context.attachWorkflowRuntime(undefined);
-            return { status: 'finished', output, snapshot: this.getSnapshot() };
+            return {
+                status: EWorkflowRunStatus.FINISHED,
+                output,
+                snapshot: this.getSnapshot(),
+            };
         }
         catch (error) {
-            this.status = 'failed';
+            this.status = EWorkflowRunStatus.FAILED;
             this.currentStep = undefined;
             this.emit('hook:workflow:failure', { runId: this.runId, error });
             this.context?.attachWorkflowRuntime(undefined);
-            return { status: 'failed', error, snapshot: this.getSnapshot() };
+            return {
+                status: EWorkflowRunStatus.FAILED,
+                error,
+                snapshot: this.getSnapshot(),
+            };
         }
     }
     /**
@@ -207,7 +216,7 @@ export class WorkflowRunner {
         runner.context = options.context;
         runner.snapshots = options.snapshot.actions ?? {};
         runner.stepLog = {};
-        runner.status = options.snapshot.status ?? 'idle';
+        runner.status = options.snapshot.status ?? EWorkflowRunStatus.IDLE;
         runner.lastResumeData = options.lastResumeData;
         runner.runtimeControl = new RunnerRuntimeControl(runner);
         options.context.attachWorkflowRuntime(runner.runtimeControl);
@@ -226,7 +235,7 @@ export class WorkflowRunner {
                 throw new Error(`Unable to rebuild suspension for step ${options.suspension.stepId}`);
             }
             runner.suspension = suspension;
-            runner.status = 'suspended';
+            runner.status = EWorkflowRunStatus.SUSPENDED;
         }
         return runner;
     }
@@ -433,7 +442,7 @@ export class WorkflowRunner {
     }
     /**
      * Store the raw task result under the task name in the workflow output state.
-     * @reviewed
+     *
      * @param task The task whose output is being captured.
      * @param state Current execution state to mutate.
      * @param result Raw result returned by the task action.

package/dist/esm/workflow.js

@@ -4,8 +4,9 @@
  * Full terms: see LICENSE.md.
  */
 import { stringify as stringifyYaml } from 'yaml';
+import { EWorkflowRunStatus, } from './context';
 import { TASK_KIND, WorkflowDefinitionSchema, validateWorkflow, } from './dsl.types';
-import { safeRenameTaskInDefinition as safeRenameTaskInDefinitionHelper } from './utils/workflow-definition';
+import { safeRenameTaskInDefinition as renameTaskInDefinition } from './utils/workflow-definition';
 import { compileWorkflow, } from './workflow-compiler';
 import { WorkflowRunner } from './workflow-runner';
 export { compileWorkflow } from './workflow-compiler';
@@ -195,7 +196,7 @@ export class Workflow {
      * Rename a task key and update references in flow steps and output expressions.
      */
     static safeRenameTaskInDefinition(definition, currentTaskName, nextTaskName) {
-        return safeRenameTaskInDefinitionHelper(definition, currentTaskName, nextTaskName);
+        return renameTaskInDefinition(definition, currentTaskName, nextTaskName);
     }
     /**
      * Run the workflow until completion or suspension.
@@ -207,10 +208,10 @@ export class Workflow {
             inputData,
             context,
         });
-        if (result.status === 'finished') {
+        if (result.status === EWorkflowRunStatus.FINISHED) {
             return result.output;
         }
-        if (result.status === 'failed') {
+        if (result.status === EWorkflowRunStatus.FAILED) {
             throw result.error instanceof Error
                 ? result.error
                 : new Error(String(result.error));

package/dist/types/action/abstract-action.d.ts

@@ -15,7 +15,6 @@ export declare abstract class AbstractAction<I, O, C extends BaseWorkflowContext
      * Sets up core metadata and schemas for the action.
      *
      * @param metadata - Describes the action name, description, and schemas.
-     * @param options - Optional configuration or definition override.
      */
     protected constructor(metadata: ActionMetadata<I, O, S>);
     /**
@@ -36,7 +35,6 @@ export declare abstract class AbstractAction<I, O, C extends BaseWorkflowContext
      * Executes the action with retry, timeout, and schema safety.
      *
      * @param payload - Raw input being provided to the action.
-     * @param context - Workflow context used during execution.
      * @returns Validated output produced by the action.
      * @throws Error when retries are exhausted or validation fails.
      */

package/dist/types/action/abstract-action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abstract-action.d.ts","sourceRoot":"","sources":["../../../src/action/abstract-action.ts"],"names":[],"mappings":"AAMA,OAAO,EAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAEjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAKjD,OAAO,EACL,MAAM,EACN,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,eAAe,EAChB,MAAM,gBAAgB,CAAC;AAIxB;;GAEG;AACH,8BAAsB,cAAc,CAClC,CAAC,EACD,CAAC,EACD,CAAC,SAAS,mBAAmB,EAC7B,CAAC,EACD,CAAC,SAAS,kBAAkB,GAAG,kBAAkB,CACjD,YAAW,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAEhC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B,SAAgB,WAAW,EAAE,MAAM,CAAC;IAEpC,SAAgB,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAExC,SAAgB,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAEzC,SAAgB,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAE1C,SAAgB,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAErD;;;;;OAKG;IACH,SAAS,aAAa,QAAQ,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAuBvD;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC;IAI/B;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC;IAIhC;;;;;;;OAOG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAAC,CAAC,CAAC;IAQ7C,GAAG,CACP,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,CAAC,EACV,QAAQ,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EACtC,QAAQ,CAAC,EAAE,CAAC,GACX,OAAO,CAAC,CAAC,CAAC;IAmEb,OAAO,CAAC,uBAAuB;IAwB/B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CACpE"}
+{"version":3,"file":"abstract-action.d.ts","sourceRoot":"","sources":["../../../src/action/abstract-action.ts"],"names":[],"mappings":"AAMA,OAAO,EAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAEjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAKjD,OAAO,EACL,MAAM,EACN,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,eAAe,EAChB,MAAM,gBAAgB,CAAC;AAIxB;;GAEG;AACH,8BAAsB,cAAc,CAClC,CAAC,EACD,CAAC,EACD,CAAC,SAAS,mBAAmB,EAC7B,CAAC,EACD,CAAC,SAAS,kBAAkB,GAAG,kBAAkB,CACjD,YAAW,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAEhC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B,SAAgB,WAAW,EAAE,MAAM,CAAC;IAEpC,SAAgB,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAExC,SAAgB,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAEzC,SAAgB,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAE1C,SAAgB,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAErD;;;;OAIG;IACH,SAAS,aAAa,QAAQ,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAuBvD;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC;IAI/B;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC;IAIhC;;;;;;OAMG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAAC,CAAC,CAAC;IAQ7C,GAAG,CACP,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,CAAC,EACV,QAAQ,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EACtC,QAAQ,CAAC,EAAE,CAAC,GACX,OAAO,CAAC,CAAC,CAAC;IAmEb,OAAO,CAAC,uBAAuB;IAwB/B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CACpE"}

package/dist/types/context.d.ts

@@ -7,7 +7,15 @@ import type { EventEmitterLike, WorkflowEventEmitterLike } from './workflow-even
  * - finished: all steps completed and outputs were evaluated successfully.
  * - failed: an uncaught error bubbled out of a step or continuation.
  */
-export type WorkflowRunStatus = 'idle' | 'running' | 'suspended' | 'finished' | 'failed';
+export declare enum EWorkflowRunStatus {
+    IDLE = "idle",
+    RUNNING = "running",
+    SUSPENDED = "suspended",
+    FINISHED = "finished",
+    FAILED = "failed"
+}
+export type WorkflowRunStatus = `${EWorkflowRunStatus}`;
+export declare const WORKFLOW_RUN_STATUSES: WorkflowRunStatus[];
 /**
  * Lifecycle of an individual action/step captured in snapshots:
  * - pending: defined but not yet executed (default before runner touches the step).

package/dist/types/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,0BAA0B,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,SAAS,GACT,WAAW,GACX,UAAU,GACV,QAAQ,CAAC;AAEb;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,SAAS,GACT,WAAW,GACX,WAAW,GACX,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC;IACF,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B;;;;;OAKG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,WAAW,IAAI,gBAAgB,CAAC;CACjC;AAED;;;;;GAKG;AACH,8BAAsB,mBAAmB,CACvC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,CAAC,GAAG,gBAAgB;IAEb,KAAK,EAAE,CAAC,CAAC;IAEhB,OAAO,CAAC,gBAAgB,CAAC,CAAyB;IAElD,SAAgB,YAAY,EAAE,wBAAwB,CAAC,CAAC,CAAC,CAAC;IAE1D;;;;;OAKG;gBACS,YAAY,EAAE,CAAC;IAI3B;;;OAGG;IACH,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAInC;;;;;OAKG;IACH,IAAI,QAAQ,IAAI,sBAAsB,CAMrC;IAED;;;;;OAKG;IACH,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,SAAS,GAAG,IAAI;CAGzE"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,0BAA0B,CAAC;AAElC;;;;;;;GAOG;AACH,oBAAY,kBAAkB;IAC5B,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB;AAED,MAAM,MAAM,iBAAiB,GAAG,GAAG,kBAAkB,EAAE,CAAC;AAExD,eAAO,MAAM,qBAAqB,EAAE,iBAAiB,EAMpD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,SAAS,GACT,WAAW,GACX,WAAW,GACX,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC;IACF,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B;;;;;OAKG;IACH,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,WAAW,IAAI,gBAAgB,CAAC;CACjC;AAED;;;;;GAKG;AACH,8BAAsB,mBAAmB,CACvC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,CAAC,GAAG,gBAAgB;IAEb,KAAK,EAAE,CAAC,CAAC;IAEhB,OAAO,CAAC,gBAAgB,CAAC,CAAyB;IAElD,SAAgB,YAAY,EAAE,wBAAwB,CAAC,CAAC,CAAC,CAAC;IAE1D;;;;;OAKG;gBACS,YAAY,EAAE,CAAC;IAI3B;;;OAGG;IACH,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAInC;;;;;OAKG;IACH,IAAI,QAAQ,IAAI,sBAAsB,CAMrC;IAED;;;;;OAKG;IACH,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,SAAS,GAAG,IAAI;CAGzE"}

package/dist/types/index.d.ts

@@ -2,10 +2,10 @@ export { AbstractAction } from './action/abstract-action';
 export { defineAction } from './action/action';
 export type { DefineActionParams } from './action/action';
 export type { Action, ActionExecutionArgs, ActionExecutionOutcome, ActionMetadata, Actions, InferActionArgs, InferActionBindings, InferActionContext, InferActionInput, InferActionOutput, InferActionSettings, SuspensionNotice, } from './action/action.types';
-export { BaseWorkflowContext, type ActionSnapshot, type ActionStatus, type StepExecutionRecord, type SuspensionOptions, type WorkflowRunStatus, type WorkflowRuntimeControl, type WorkflowSnapshot, } from './context';
+export { BaseWorkflowContext, EWorkflowRunStatus, WORKFLOW_RUN_STATUSES, type ActionSnapshot, type ActionStatus, type StepExecutionRecord, type SuspensionOptions, type WorkflowRunStatus, type WorkflowRuntimeControl, type WorkflowSnapshot, } from './context';
 export * from './dsl.types';
 export type { BindingKindDescriptor, BindingKindSchemas, InferMountedBindingValue, InferWorkflowBindings, } from './bindings/base-binding';
-export { compileWorkflow, Workflow as Workflow, WorkflowEventEmitter, WorkflowRunner, type FlowStepPath, type WorkflowCompileOptions, type WorkflowResumeResult, type WorkflowRunOptions, type WorkflowStartResult, } from './workflow';
+export { compileWorkflow, Workflow, WorkflowEventEmitter, WorkflowRunner, type FlowStepPath, type WorkflowCompileOptions, type WorkflowResumeResult, type WorkflowRunOptions, type WorkflowStartResult, } from './workflow';
 export { StepType } from './workflow-event-emitter';
 export type { StepInfo, WorkflowEventEmitterLike, WorkflowEventMap, } from './workflow-event-emitter';
 export type { BaseStep as CompiledBaseStep, ConditionalBranch as CompiledConditionalBranch, ConditionalStep as CompiledConditionalStep, LoopStep as CompiledLoopStep, CompiledMapping, ParallelStep as CompiledParallelStep, CompiledStep, CompiledTask, CompiledTaskBindings, TaskStep as CompiledTaskStep, CompiledValue, CompiledWorkflow, EvaluationScope, ExecutionState, PersistedSuspension, RunnerResumeArgs, RunnerStartArgs, Suspension, ResumeResult as WorkflowResumeOutcome, StartResult as WorkflowStartOutcome, } from './workflow-types';

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,YAAY,EACV,MAAM,EACN,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACd,OAAO,EACP,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,GACtB,MAAM,WAAW,CAAC;AAEnB,cAAc,aAAa,CAAC;AAE5B,YAAY,EACV,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,eAAe,EACf,QAAQ,IAAI,QAAQ,EACpB,oBAAoB,EACpB,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,YAAY,EACV,QAAQ,EACR,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,QAAQ,IAAI,gBAAgB,EAC5B,iBAAiB,IAAI,yBAAyB,EAC9C,eAAe,IAAI,uBAAuB,EAC1C,QAAQ,IAAI,gBAAgB,EAC5B,eAAe,EACf,YAAY,IAAI,oBAAoB,EACpC,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,QAAQ,IAAI,gBAAgB,EAC5B,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,YAAY,IAAI,qBAAqB,EACrC,WAAW,IAAI,oBAAoB,GACpC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAEzE,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,GAC7B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,YAAY,EACV,MAAM,EACN,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACd,OAAO,EACP,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,GACtB,MAAM,WAAW,CAAC;AAEnB,cAAc,aAAa,CAAC;AAE5B,YAAY,EACV,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,eAAe,EACf,QAAQ,EACR,oBAAoB,EACpB,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,YAAY,EACV,QAAQ,EACR,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,QAAQ,IAAI,gBAAgB,EAC5B,iBAAiB,IAAI,yBAAyB,EAC9C,eAAe,IAAI,uBAAuB,EAC1C,QAAQ,IAAI,gBAAgB,EAC5B,eAAe,EACf,YAAY,IAAI,oBAAoB,EACpC,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,QAAQ,IAAI,gBAAgB,EAC5B,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,YAAY,IAAI,qBAAqB,EACrC,WAAW,IAAI,oBAAoB,GACpC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAEzE,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,GAC7B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types/workflow-runner.d.ts

@@ -1,4 +1,4 @@
-import type { BaseWorkflowContext, StepExecutionRecord, WorkflowRunStatus, WorkflowSnapshot } from './context';
+import { type BaseWorkflowContext, type StepExecutionRecord, type WorkflowRunStatus, type WorkflowSnapshot } from './context';
 import { type StepInfo } from './workflow-event-emitter';
 import type { CompiledWorkflow, ExecutionState, PersistedSuspension, ResumeResult, RunnerResumeArgs, RunnerStartArgs, StartResult, WorkflowRunOptions } from './workflow-types';
 /**
@@ -169,7 +169,7 @@ export declare class WorkflowRunner {
     private executeStep;
     /**
      * Store the raw task result under the task name in the workflow output state.
-     * @reviewed
+     *
      * @param task The task whose output is being captured.
      * @param state Current execution state to mutate.
      * @param result Raw result returned by the task action.

package/dist/types/workflow-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-runner.d.ts","sourceRoot":"","sources":["../../src/workflow-runner.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAGV,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,WAAW,CAAC;AAWnB,OAAO,EAEL,KAAK,QAAQ,EAEd,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAGV,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,WAAW,EAEX,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAG1B;;;GAGG;AACH,qBAAa,cAAc;IAEzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAG5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAGhC,OAAO,CAAC,MAAM,CAA6B;IAG3C,OAAO,CAAC,SAAS,CAAsC;IAGvD,OAAO,CAAC,OAAO,CAA2C;IAG1D,OAAO,CAAC,UAAU,CAAC,CAAa;IAGhC,OAAO,CAAC,cAAc,CAAC,CAAuB;IAG9C,OAAO,CAAC,WAAW,CAAC,CAAW;IAG/B,OAAO,CAAC,cAAc,CAAC,CAAU;IAGjC,OAAO,CAAC,KAAK,CAAC,CAAiB;IAG/B,OAAO,CAAC,OAAO,CAAC,CAAsB;IAEtC;;;;;OAKG;gBACS,QAAQ,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,kBAAkB;IAKpE;;;;OAIG;IACH,QAAQ,IAAI,cAAc,GAAG,SAAS;IAItC;;;;OAIG;IACH,SAAS,IAAI,iBAAiB;IAI9B;;;;OAIG;IACH,WAAW,IAAI,gBAAgB;IAO/B;;;;OAIG;IACH,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAajD;;;;OAIG;IACH,cAAc,IAAI,QAAQ,GAAG,SAAS;IAItC;;;;OAIG;IACH,iBAAiB,IAAI,OAAO;IAI5B;;;;;;OAMG;IACG,KAAK,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IA6BxD;;;;;OAKG;IACG,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IAiB3D;;;;;OAKG;YACW,YAAY;IAkD1B;;;;;;OAMG;WACU,kBAAkB,CAC7B,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE;QACP,KAAK,EAAE,cAAc,CAAC;QACtB,OAAO,EAAE,mBAAmB,CAAC;QAC7B,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,UAAU,CAAC,EAAE,mBAAmB,CAAC;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,GACA,OAAO,CAAC,cAAc,CAAC;IAgD1B;;;;;OAKG;IACH,OAAO,CAAC,IAAI;IAOZ;;;;;;OAMG;YACW,uBAAuB;IAYrC;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IASpB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAqDzB;;;;OAIG;IACH,OAAO,CAAC,6BAA6B;IAkBrC;;;;;;;;OAQG;YACW,WAAW;IA8BzB;;;;;;;OAOG;YACW,WAAW;IAkBzB;;;;;;OAMG;YACW,iBAAiB;CAOhC"}
+{"version":3,"file":"workflow-runner.d.ts","sourceRoot":"","sources":["../../src/workflow-runner.ts"],"names":[],"mappings":"AAMA,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,WAAW,CAAC;AAWnB,OAAO,EAEL,KAAK,QAAQ,EAEd,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAGV,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,WAAW,EAEX,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAG1B;;;GAGG;AACH,qBAAa,cAAc;IAEzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAG5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAGhC,OAAO,CAAC,MAAM,CAA8C;IAG5D,OAAO,CAAC,SAAS,CAAsC;IAGvD,OAAO,CAAC,OAAO,CAA2C;IAG1D,OAAO,CAAC,UAAU,CAAC,CAAa;IAGhC,OAAO,CAAC,cAAc,CAAC,CAAuB;IAG9C,OAAO,CAAC,WAAW,CAAC,CAAW;IAG/B,OAAO,CAAC,cAAc,CAAC,CAAU;IAGjC,OAAO,CAAC,KAAK,CAAC,CAAiB;IAG/B,OAAO,CAAC,OAAO,CAAC,CAAsB;IAEtC;;;;;OAKG;gBACS,QAAQ,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,kBAAkB;IAKpE;;;;OAIG;IACH,QAAQ,IAAI,cAAc,GAAG,SAAS;IAItC;;;;OAIG;IACH,SAAS,IAAI,iBAAiB;IAI9B;;;;OAIG;IACH,WAAW,IAAI,gBAAgB;IAO/B;;;;OAIG;IACH,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAajD;;;;OAIG;IACH,cAAc,IAAI,QAAQ,GAAG,SAAS;IAItC;;;;OAIG;IACH,iBAAiB,IAAI,OAAO;IAI5B;;;;;;OAMG;IACG,KAAK,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IA6BxD;;;;;OAKG;IACG,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IAiB3D;;;;;OAKG;YACW,YAAY;IA0D1B;;;;;;OAMG;WACU,kBAAkB,CAC7B,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE;QACP,KAAK,EAAE,cAAc,CAAC;QACtB,OAAO,EAAE,mBAAmB,CAAC;QAC7B,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,UAAU,CAAC,EAAE,mBAAmB,CAAC;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,GACA,OAAO,CAAC,cAAc,CAAC;IAgD1B;;;;;OAKG;IACH,OAAO,CAAC,IAAI;IAOZ;;;;;;OAMG;YACW,uBAAuB;IAYrC;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IASpB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAqDzB;;;;OAIG;IACH,OAAO,CAAC,6BAA6B;IAkBrC;;;;;;;;OAQG;YACW,WAAW;IA8BzB;;;;;;;OAOG;YACW,WAAW;IAkBzB;;;;;;OAMG;YACW,iBAAiB;CAOhC"}

package/dist/types/workflow.d.ts

@@ -1,4 +1,4 @@
-import type { BaseWorkflowContext, WorkflowSnapshot } from './context';
+import { type BaseWorkflowContext, type WorkflowSnapshot } from './context';
 import { WorkflowDefinition, type FlowStep } from './dsl.types';
 import { type WorkflowCompileOptions } from './workflow-compiler';
 import { WorkflowRunner } from './workflow-runner';

package/dist/types/workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/workflow.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EAEL,kBAAkB,EAGlB,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AAErB,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAEV,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;AAqDlD;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAE5C,OAAO;IAIP;;;OAGG;IACH,MAAM,CAAC,cAAc,CACnB,UAAU,EAAE,kBAAkB,EAC9B,OAAO,EAAE,sBAAsB,GAC9B,QAAQ;IAgBX;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,QAAQ;IAgBxE;;;OAGG;IACH,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM;IAMlE;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO;IAgBlE;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,CAAC,EACrB,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,OAAO,GACjB,CAAC;IAgCJ;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,EAAE,YAAY,GACrB,kBAAkB,GAAG,IAAI;IA4D5B;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,UAAU,EAAE,kBAAkB,EAC9B,UAAU,EAAE,YAAY,EACxB,IAAI,EAAE,QAAQ,GACb,kBAAkB,GAAG,IAAI;IA0B5B;;OAEG;IACH,MAAM,CAAC,0BAA0B,CAC/B,UAAU,EAAE,kBAAkB,EAC9B,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,GACnB,kBAAkB;IAQrB;;;OAGG;IACG,GAAG,CACP,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAwBnC;;OAEG;IACG,gBAAgB,CACpB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,cAAc,CAAC;IAI1B;;OAEG;IACG,oBAAoB,CAAC,OAAO,EAAE;QAClC,KAAK,EAAE,cAAc,CAAC;QACtB,OAAO,EAAE,mBAAmB,CAAC;QAC7B,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,UAAU,CAAC,EAAE,mBAAmB,CAAC;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,GAAG,OAAO,CAAC,cAAc,CAAC;CAG5B"}
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/workflow.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACtB,MAAM,WAAW,CAAC;AACnB,OAAO,EAEL,kBAAkB,EAGlB,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AAErB,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAEV,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;AAqDlD;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAE5C,OAAO;IAIP;;;OAGG;IACH,MAAM,CAAC,cAAc,CACnB,UAAU,EAAE,kBAAkB,EAC9B,OAAO,EAAE,sBAAsB,GAC9B,QAAQ;IAgBX;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,QAAQ;IAgBxE;;;OAGG;IACH,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM;IAMlE;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO;IAgBlE;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,CAAC,EACrB,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,OAAO,GACjB,CAAC;IAgCJ;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,EAAE,YAAY,GACrB,kBAAkB,GAAG,IAAI;IA4D5B;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,UAAU,EAAE,kBAAkB,EAC9B,UAAU,EAAE,YAAY,EACxB,IAAI,EAAE,QAAQ,GACb,kBAAkB,GAAG,IAAI;IA0B5B;;OAEG;IACH,MAAM,CAAC,0BAA0B,CAC/B,UAAU,EAAE,kBAAkB,EAC9B,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,GACnB,kBAAkB;IAIrB;;;OAGG;IACG,GAAG,CACP,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAwBnC;;OAEG;IACG,gBAAgB,CACpB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,cAAc,CAAC;IAI1B;;OAEG;IACG,oBAAoB,CAAC,OAAO,EAAE;QAClC,KAAK,EAAE,cAAc,CAAC;QACtB,OAAO,EAAE,mBAAmB,CAAC;QAC7B,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,UAAU,CAAC,EAAE,mBAAmB,CAAC;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,GAAG,OAAO,CAAC,cAAc,CAAC;CAG5B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hexabot-ai/agentic",
-  "version": "3.0.2-alpha.0",
+  "version": "3.1.0-alpha.0",
   "description": "Schemas and utilities for the Hexabot agentic workflow DSL.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -50,11 +50,13 @@
     "build": "pnpm run build:cjs && pnpm run build:esm",
     "build:cjs": "tsc -p tsconfig.build.cjs.json",
     "build:esm": "tsc -p tsconfig.build.esm.json",
-    "dev": "pnpm run build:watch",
+    "dev": "pnpm exec concurrently -k -n cjs,esm \"pnpm run build:cjs:watch\" \"pnpm run build:esm:watch\"",
     "build:watch": "tsc -p tsconfig.json --watch",
     "lint": "eslint \"{src,examples}/**/*.ts\" \"jest.config.ts\"",
     "lint:fix": "eslint \"{src,examples}/**/*.ts\" \"jest.config.ts\" --fix",
     "typecheck": "tsc --noEmit -p tsconfig.json",
-    "test": "jest --config jest.config.ts"
+    "test": "jest --config jest.config.ts",
+    "build:cjs:watch": "tsc -p tsconfig.build.cjs.json --watch",
+    "build:esm:watch": "tsc -p tsconfig.build.esm.json --watch"
   }
 }

package/src/action/abstract-action.ts

@@ -48,7 +48,6 @@ export abstract class AbstractAction<
    * Sets up core metadata and schemas for the action.
    *
    * @param metadata - Describes the action name, description, and schemas.
-   * @param options - Optional configuration or definition override.
    */
   protected constructor(metadata: ActionMetadata<I, O, S>) {
     if (metadata.settingsSchema instanceof z.ZodObject) {
@@ -97,7 +96,6 @@ export abstract class AbstractAction<
    * Executes the action with retry, timeout, and schema safety.
    *
    * @param payload - Raw input being provided to the action.
-   * @param context - Workflow context used during execution.
    * @returns Validated output produced by the action.
    * @throws Error when retries are exhausted or validation fails.
    */

package/src/context.ts

@@ -17,12 +17,23 @@ import type {
  * - finished: all steps completed and outputs were evaluated successfully.
  * - failed: an uncaught error bubbled out of a step or continuation.
  */
-export type WorkflowRunStatus =
-  | 'idle'
-  | 'running'
-  | 'suspended'
-  | 'finished'
-  | 'failed';
+export enum EWorkflowRunStatus {
+  IDLE = 'idle',
+  RUNNING = 'running',
+  SUSPENDED = 'suspended',
+  FINISHED = 'finished',
+  FAILED = 'failed',
+}
+
+export type WorkflowRunStatus = `${EWorkflowRunStatus}`;
+
+export const WORKFLOW_RUN_STATUSES: WorkflowRunStatus[] = [
+  EWorkflowRunStatus.IDLE,
+  EWorkflowRunStatus.RUNNING,
+  EWorkflowRunStatus.SUSPENDED,
+  EWorkflowRunStatus.FINISHED,
+  EWorkflowRunStatus.FAILED,
+];
 
 /**
  * Lifecycle of an individual action/step captured in snapshots:

package/src/index.ts

@@ -27,6 +27,8 @@ export type {
 
 export {
   BaseWorkflowContext,
+  EWorkflowRunStatus,
+  WORKFLOW_RUN_STATUSES,
   type ActionSnapshot,
   type ActionStatus,
   type StepExecutionRecord,
@@ -47,7 +49,7 @@ export type {
 
 export {
   compileWorkflow,
-  Workflow as Workflow,
+  Workflow,
   WorkflowEventEmitter,
   WorkflowRunner,
   type FlowStepPath,

package/src/workflow-runner.ts

@@ -4,13 +4,14 @@
  * Full terms: see LICENSE.md.
  */
 
-import type {
-  ActionSnapshot,
-  ActionStatus,
-  BaseWorkflowContext,
-  StepExecutionRecord,
-  WorkflowRunStatus,
-  WorkflowSnapshot,
+import {
+  EWorkflowRunStatus,
+  type ActionSnapshot,
+  type ActionStatus,
+  type BaseWorkflowContext,
+  type StepExecutionRecord,
+  type WorkflowRunStatus,
+  type WorkflowSnapshot,
 } from './context';
 import { RunnerRuntimeControl } from './runner-runtime-control';
 import { executeConditional as runConditionalExecutor } from './step-executors/conditional-executor';
@@ -54,7 +55,7 @@ export class WorkflowRunner {
   private readonly runId?: string;
 
   // Current lifecycle status of the workflow execution.
-  private status: WorkflowRunStatus = 'idle';
+  private status: WorkflowRunStatus = EWorkflowRunStatus.IDLE;
 
   // Snapshots of action execution keyed by step id for inspection/resume.
   private snapshots: Record<string, ActionSnapshot> = {};
@@ -165,7 +166,7 @@ export class WorkflowRunner {
    * @returns Execution result including status and snapshot.
    */
   async start(args: RunnerStartArgs): Promise<StartResult> {
-    this.status = 'running';
+    this.status = EWorkflowRunStatus.RUNNING;
     this.snapshots = {};
     this.stepLog = {};
     this.suspension = undefined;
@@ -200,7 +201,7 @@ export class WorkflowRunner {
    * @returns Execution result including status and snapshot.
    */
   async resume(args: RunnerResumeArgs): Promise<ResumeResult> {
-    if (this.status !== 'suspended' || !this.suspension) {
+    if (this.status !== EWorkflowRunStatus.SUSPENDED || !this.suspension) {
       throw new Error('Cannot resume a workflow that is not suspended.');
     }
 
@@ -208,7 +209,7 @@ export class WorkflowRunner {
       throw new Error('Workflow state is not initialized.');
     }
 
-    this.status = 'running';
+    this.status = EWorkflowRunStatus.RUNNING;
     this.lastResumeData = args.resumeData;
 
     const suspension: Suspension = this.suspension;
@@ -230,7 +231,7 @@ export class WorkflowRunner {
 
       if (suspension) {
         this.suspension = suspension;
-        this.status = 'suspended';
+        this.status = EWorkflowRunStatus.SUSPENDED;
         this.emit('hook:workflow:suspended', {
           runId: this.runId,
           step: suspension.step,
@@ -239,7 +240,7 @@ export class WorkflowRunner {
         });
 
         return {
-          status: 'suspended',
+          status: EWorkflowRunStatus.SUSPENDED,
           step: suspension.step,
           reason: suspension.reason,
           data: suspension.data,
@@ -252,7 +253,7 @@ export class WorkflowRunner {
       }
 
       const output = await this.evaluateWorkflowOutputs();
-      this.status = 'finished';
+      this.status = EWorkflowRunStatus.FINISHED;
       this.suspension = undefined;
       this.currentStep = undefined;
       this.emit('hook:workflow:finish', { runId: this.runId, output });
@@ -261,14 +262,22 @@ export class WorkflowRunner {
       }
       this.context.attachWorkflowRuntime(undefined);
 
-      return { status: 'finished', output, snapshot: this.getSnapshot() };
+      return {
+        status: EWorkflowRunStatus.FINISHED,
+        output,
+        snapshot: this.getSnapshot(),
+      };
     } catch (error) {
-      this.status = 'failed';
+      this.status = EWorkflowRunStatus.FAILED;
       this.currentStep = undefined;
       this.emit('hook:workflow:failure', { runId: this.runId, error });
       this.context?.attachWorkflowRuntime(undefined);
 
-      return { status: 'failed', error, snapshot: this.getSnapshot() };
+      return {
+        status: EWorkflowRunStatus.FAILED,
+        error,
+        snapshot: this.getSnapshot(),
+      };
     }
   }
 
@@ -304,7 +313,7 @@ export class WorkflowRunner {
     runner.context = options.context;
     runner.snapshots = options.snapshot.actions ?? {};
     runner.stepLog = {};
-    runner.status = options.snapshot.status ?? 'idle';
+    runner.status = options.snapshot.status ?? EWorkflowRunStatus.IDLE;
     runner.lastResumeData = options.lastResumeData;
     runner.runtimeControl = new RunnerRuntimeControl(runner);
     options.context.attachWorkflowRuntime(runner.runtimeControl);
@@ -331,7 +340,7 @@ export class WorkflowRunner {
       }
 
       runner.suspension = suspension;
-      runner.status = 'suspended';
+      runner.status = EWorkflowRunStatus.SUSPENDED;
     }
 
     return runner;
@@ -588,7 +597,7 @@ export class WorkflowRunner {
 
   /**
    * Store the raw task result under the task name in the workflow output state.
-   * @reviewed
+   *
    * @param task The task whose output is being captured.
    * @param state Current execution state to mutate.
    * @param result Raw result returned by the task action.

package/src/workflow.ts

@@ -6,7 +6,11 @@
 
 import { stringify as stringifyYaml } from 'yaml';
 
-import type { BaseWorkflowContext, WorkflowSnapshot } from './context';
+import {
+  EWorkflowRunStatus,
+  type BaseWorkflowContext,
+  type WorkflowSnapshot,
+} from './context';
 import {
   TASK_KIND,
   WorkflowDefinition,
@@ -14,7 +18,7 @@ import {
   validateWorkflow,
   type FlowStep,
 } from './dsl.types';
-import { safeRenameTaskInDefinition as safeRenameTaskInDefinitionHelper } from './utils/workflow-definition';
+import { safeRenameTaskInDefinition as renameTaskInDefinition } from './utils/workflow-definition';
 import {
   compileWorkflow,
   type WorkflowCompileOptions,
@@ -323,11 +327,7 @@ export class Workflow {
     currentTaskName: string,
     nextTaskName: string,
   ): WorkflowDefinition {
-    return safeRenameTaskInDefinitionHelper(
-      definition,
-      currentTaskName,
-      nextTaskName,
-    );
+    return renameTaskInDefinition(definition, currentTaskName, nextTaskName);
   }
 
   /**
@@ -345,11 +345,11 @@ export class Workflow {
       context,
     });
 
-    if (result.status === 'finished') {
+    if (result.status === EWorkflowRunStatus.FINISHED) {
       return result.output;
     }
 
-    if (result.status === 'failed') {
+    if (result.status === EWorkflowRunStatus.FAILED) {
       throw result.error instanceof Error
         ? result.error
         : new Error(String(result.error));