flowcraft 2.4.0 → 2.5.0

package/dist/runtime/adapter.d.ts

@@ -1,4 +1,4 @@
-import { v as RuntimeOptions, c as FlowRuntime, A as ISerializer, x as ILogger, t as IAsyncContext, J as WorkflowResult, g as WorkflowBlueprint } from '../types-DWCZW68f.js';
+import { w as RuntimeOptions, c as FlowRuntime, D as ISerializer, y as ILogger, u as IAsyncContext, K as WorkflowResult, h as WorkflowBlueprint } from '../types-B-Drn84R.js';
 import '../errors.js';
 import '../container.js';
 
@@ -11,6 +11,8 @@ interface ICoordinationStore {
     increment: (key: string, ttlSeconds: number) => Promise<number>;
     /** Sets a key only if it does not already exist. Ideal for 'any' joins (locking). */
     setIfNotExist: (key: string, value: string, ttlSeconds: number) => Promise<boolean>;
+    /** Extends the TTL of an existing key. Used for heartbeat mechanism in long-running jobs. */
+    extendTTL: (key: string, ttlSeconds: number) => Promise<boolean>;
     /** Deletes a key. Used for cleanup. */
     delete: (key: string) => Promise<void>;
     /** Gets the value of a key. */
@@ -67,6 +69,16 @@ declare abstract class BaseDistributedAdapter {
         payload?: WorkflowResult;
         reason?: string;
     }): Promise<void>;
+    /**
+     * Registers a webhook endpoint for a specific node in a workflow run.
+     * @param runId The unique ID of the workflow run.
+     * @param nodeId The ID of the node that will wait for the webhook.
+     * @returns The URL and event name for the webhook.
+     */
+    abstract registerWebhookEndpoint(runId: string, nodeId: string): Promise<{
+        url: string;
+        event: string;
+    }>;
     /**
      * Hook called at the start of job processing. Subclasses can override this
      * to perform additional setup (e.g., timestamp tracking for reconciliation).

package/dist/runtime/adapter.js

@@ -1,25 +1,26 @@
-export { BaseDistributedAdapter } from '../chunk-J3HZD5ES.js';
-import '../chunk-CHG6O6JX.js';
+export { BaseDistributedAdapter } from '../chunk-5XPW6YEP.js';
+import '../chunk-OPRR4TAO.js';
+import '../chunk-SEI4Z3MO.js';
 import '../chunk-DL7KVYZF.js';
-import '../chunk-LM4ACVHL.js';
-import '../chunk-MCGK3FXQ.js';
-import '../chunk-LJ4COM7S.js';
-import '../chunk-K6LPGUPR.js';
-import '../chunk-G5BGBPFP.js';
-import '../chunk-GVF7GQXQ.js';
 import '../chunk-ONH7PIJZ.js';
-import '../chunk-DSYAC4WB.js';
+import '../chunk-LM4ACVHL.js';
 import '../chunk-BC4G7OM6.js';
 import '../chunk-RM677CNU.js';
-import '../chunk-233SESC2.js';
-import '../chunk-NDWVLU7J.js';
+import '../chunk-HNHM3FDK.js';
+import '../chunk-UXIASXSG.js';
+import '../chunk-FBPY44WL.js';
+import '../chunk-IDTYHLDQ.js';
+import '../chunk-I53JB2KW.js';
+import '../chunk-DSYAC4WB.js';
+import '../chunk-ZLW4QOTS.js';
+import '../chunk-XTW36KQZ.js';
 import '../chunk-HAZ26F3P.js';
-import '../chunk-KXXEA5VE.js';
-import '../chunk-OO3FF3DF.js';
+import '../chunk-N4NLAIEN.js';
+import '../chunk-5BOUGXZO.js';
 import '../chunk-4PELJWF7.js';
 import '../chunk-CYHZ2YVH.js';
 import '../chunk-WWGFIYKW.js';
-import '../chunk-R3HQXIEL.js';
+import '../chunk-XDI4TJHA.js';
 import '../chunk-BCRWXTWX.js';
 import '../chunk-PH2IYZHV.js';
 import '../chunk-LNK7LZER.js';

package/dist/runtime/execution-context.d.ts

@@ -1,3 +1,3 @@
-export { K as ExecutionContext } from '../types-DWCZW68f.js';
+export { L as ExecutionContext } from '../types-B-Drn84R.js';
 import '../errors.js';
 import '../container.js';

package/dist/runtime/execution-context.js

@@ -1,6 +1,6 @@
-export { ExecutionContext } from '../chunk-KXXEA5VE.js';
-import '../chunk-OO3FF3DF.js';
-import '../chunk-R3HQXIEL.js';
+export { ExecutionContext } from '../chunk-N4NLAIEN.js';
+import '../chunk-5BOUGXZO.js';
+import '../chunk-XDI4TJHA.js';
 import '../chunk-BCRWXTWX.js';
 //# sourceMappingURL=execution-context.js.map
 //# sourceMappingURL=execution-context.js.map

package/dist/runtime/executors.d.ts

@@ -1,3 +1,3 @@
 import '../errors.js';
-export { C as ClassNodeExecutor, E as ExecutionStrategy, F as FunctionNodeExecutor, N as NodeExecutionResult, b as NodeExecutor, a as NodeExecutorConfig } from '../types-DWCZW68f.js';
+export { C as ClassNodeExecutor, E as ExecutionStrategy, F as FunctionNodeExecutor, N as NodeExecutionResult, b as NodeExecutor, a as NodeExecutorConfig } from '../types-B-Drn84R.js';
 import '../container.js';

package/dist/runtime/index.d.ts

@@ -1,5 +1,5 @@
 export { AdapterOptions, BaseDistributedAdapter, ICoordinationStore, JobPayload } from './adapter.js';
-export { C as ClassNodeExecutor, e as ExecutionServices, E as ExecutionStrategy, c as FlowRuntime, F as FunctionNodeExecutor, G as GraphTraverser, I as IOrchestrator, f as IRuntime, N as NodeExecutionResult, b as NodeExecutor, a as NodeExecutorConfig, d as NodeExecutorFactory, R as ReadyNode, W as WorkflowState } from '../types-DWCZW68f.js';
+export { C as ClassNodeExecutor, e as ExecutionServices, E as ExecutionStrategy, c as FlowRuntime, F as FunctionNodeExecutor, G as GraphTraverser, I as IOrchestrator, f as IRuntime, N as NodeExecutionResult, b as NodeExecutor, a as NodeExecutorConfig, d as NodeExecutorFactory, R as ReadyNode, W as WorkflowState } from '../types-B-Drn84R.js';
 export { DefaultOrchestrator } from './orchestrator.js';
 export { executeBatch, processResults } from './orchestrators/utils.js';
 import '../errors.js';

package/dist/runtime/index.js

@@ -1,27 +1,28 @@
 import '../chunk-NVJ3ZO3P.js';
 import '../chunk-NVLZFLYM.js';
-export { BaseDistributedAdapter } from '../chunk-J3HZD5ES.js';
-export { FlowRuntime } from '../chunk-CHG6O6JX.js';
+export { BaseDistributedAdapter } from '../chunk-5XPW6YEP.js';
+export { FlowRuntime } from '../chunk-OPRR4TAO.js';
+import '../chunk-SEI4Z3MO.js';
 import '../chunk-DL7KVYZF.js';
-import '../chunk-LM4ACVHL.js';
-import '../chunk-MCGK3FXQ.js';
-import '../chunk-LJ4COM7S.js';
-import '../chunk-K6LPGUPR.js';
-export { GraphTraverser } from '../chunk-G5BGBPFP.js';
-import '../chunk-GVF7GQXQ.js';
 export { ClassNodeExecutor, FunctionNodeExecutor, NodeExecutor } from '../chunk-ONH7PIJZ.js';
-import '../chunk-DSYAC4WB.js';
+import '../chunk-LM4ACVHL.js';
 import '../chunk-BC4G7OM6.js';
 import '../chunk-RM677CNU.js';
-import '../chunk-233SESC2.js';
-export { DefaultOrchestrator } from '../chunk-NDWVLU7J.js';
+import '../chunk-HNHM3FDK.js';
+import '../chunk-UXIASXSG.js';
+export { GraphTraverser } from '../chunk-FBPY44WL.js';
+import '../chunk-IDTYHLDQ.js';
+import '../chunk-I53JB2KW.js';
+import '../chunk-DSYAC4WB.js';
+import '../chunk-ZLW4QOTS.js';
+export { DefaultOrchestrator } from '../chunk-XTW36KQZ.js';
 export { executeBatch, processResults } from '../chunk-HAZ26F3P.js';
-import '../chunk-KXXEA5VE.js';
-export { WorkflowState } from '../chunk-OO3FF3DF.js';
+import '../chunk-N4NLAIEN.js';
+export { WorkflowState } from '../chunk-5BOUGXZO.js';
 import '../chunk-4PELJWF7.js';
 import '../chunk-CYHZ2YVH.js';
 import '../chunk-WWGFIYKW.js';
-import '../chunk-R3HQXIEL.js';
+import '../chunk-XDI4TJHA.js';
 import '../chunk-BCRWXTWX.js';
 import '../chunk-PH2IYZHV.js';
 import '../chunk-LNK7LZER.js';

package/dist/runtime/node-executor-factory.d.ts

@@ -1,4 +1,4 @@
-import { z as IEventBus, K as ExecutionContext, b as NodeExecutor } from '../types-DWCZW68f.js';
+import { A as IEventBus, L as ExecutionContext, b as NodeExecutor } from '../types-B-Drn84R.js';
 import '../errors.js';
 import '../container.js';
 

package/dist/runtime/orchestrator.d.ts

@@ -1,4 +1,4 @@
-import { I as IOrchestrator, K as ExecutionContext, G as GraphTraverser, J as WorkflowResult } from '../types-DWCZW68f.js';
+import { I as IOrchestrator, L as ExecutionContext, G as GraphTraverser, K as WorkflowResult } from '../types-B-Drn84R.js';
 import '../errors.js';
 import '../container.js';
 

package/dist/runtime/orchestrator.js

@@ -1,8 +1,8 @@
-export { DefaultOrchestrator } from '../chunk-NDWVLU7J.js';
+export { DefaultOrchestrator } from '../chunk-XTW36KQZ.js';
 import '../chunk-HAZ26F3P.js';
-import '../chunk-KXXEA5VE.js';
-import '../chunk-OO3FF3DF.js';
-import '../chunk-R3HQXIEL.js';
+import '../chunk-N4NLAIEN.js';
+import '../chunk-5BOUGXZO.js';
+import '../chunk-XDI4TJHA.js';
 import '../chunk-BCRWXTWX.js';
 //# sourceMappingURL=orchestrator.js.map
 //# sourceMappingURL=orchestrator.js.map

package/dist/runtime/orchestrators/step-by-step.d.ts

@@ -1,4 +1,4 @@
-import { I as IOrchestrator, K as ExecutionContext, G as GraphTraverser, J as WorkflowResult } from '../../types-DWCZW68f.js';
+import { I as IOrchestrator, L as ExecutionContext, G as GraphTraverser, K as WorkflowResult } from '../../types-B-Drn84R.js';
 import '../../errors.js';
 import '../../container.js';
 

package/dist/runtime/orchestrators/utils.d.ts

@@ -1,4 +1,4 @@
-import { g as WorkflowBlueprint, W as WorkflowState, N as NodeExecutionResult, G as GraphTraverser } from '../../types-DWCZW68f.js';
+import { h as WorkflowBlueprint, W as WorkflowState, N as NodeExecutionResult, G as GraphTraverser } from '../../types-B-Drn84R.js';
 import '../../errors.js';
 import '../../container.js';
 

package/dist/runtime/runtime.d.ts

@@ -1,3 +1,3 @@
 import '../container.js';
-export { c as FlowRuntime } from '../types-DWCZW68f.js';
+export { c as FlowRuntime } from '../types-B-Drn84R.js';
 import '../errors.js';

package/dist/runtime/runtime.js

@@ -1,24 +1,25 @@
-export { FlowRuntime } from '../chunk-CHG6O6JX.js';
+export { FlowRuntime } from '../chunk-OPRR4TAO.js';
+import '../chunk-SEI4Z3MO.js';
 import '../chunk-DL7KVYZF.js';
-import '../chunk-LM4ACVHL.js';
-import '../chunk-MCGK3FXQ.js';
-import '../chunk-LJ4COM7S.js';
-import '../chunk-K6LPGUPR.js';
-import '../chunk-G5BGBPFP.js';
-import '../chunk-GVF7GQXQ.js';
 import '../chunk-ONH7PIJZ.js';
-import '../chunk-DSYAC4WB.js';
+import '../chunk-LM4ACVHL.js';
 import '../chunk-BC4G7OM6.js';
 import '../chunk-RM677CNU.js';
-import '../chunk-233SESC2.js';
-import '../chunk-NDWVLU7J.js';
+import '../chunk-HNHM3FDK.js';
+import '../chunk-UXIASXSG.js';
+import '../chunk-FBPY44WL.js';
+import '../chunk-IDTYHLDQ.js';
+import '../chunk-I53JB2KW.js';
+import '../chunk-DSYAC4WB.js';
+import '../chunk-ZLW4QOTS.js';
+import '../chunk-XTW36KQZ.js';
 import '../chunk-HAZ26F3P.js';
-import '../chunk-KXXEA5VE.js';
-import '../chunk-OO3FF3DF.js';
+import '../chunk-N4NLAIEN.js';
+import '../chunk-5BOUGXZO.js';
 import '../chunk-4PELJWF7.js';
 import '../chunk-CYHZ2YVH.js';
 import '../chunk-WWGFIYKW.js';
-import '../chunk-R3HQXIEL.js';
+import '../chunk-XDI4TJHA.js';
 import '../chunk-BCRWXTWX.js';
 import '../chunk-PH2IYZHV.js';
 import '../chunk-LNK7LZER.js';

package/dist/runtime/scheduler.d.ts

@@ -1,3 +1,3 @@
-export { L as AwaitingWorkflow, O as WorkflowScheduler } from '../types-DWCZW68f.js';
+export { O as AwaitingWorkflow, Q as WorkflowScheduler } from '../types-B-Drn84R.js';
 import '../errors.js';
 import '../container.js';

package/dist/runtime/state.d.ts

@@ -1,3 +1,3 @@
-export { W as WorkflowState } from '../types-DWCZW68f.js';
+export { W as WorkflowState } from '../types-B-Drn84R.js';
 import '../errors.js';
 import '../container.js';

package/dist/runtime/state.js

@@ -1,5 +1,5 @@
-export { WorkflowState } from '../chunk-OO3FF3DF.js';
-import '../chunk-R3HQXIEL.js';
+export { WorkflowState } from '../chunk-5BOUGXZO.js';
+import '../chunk-XDI4TJHA.js';
 import '../chunk-BCRWXTWX.js';
 //# sourceMappingURL=state.js.map
 //# sourceMappingURL=state.js.map

package/dist/runtime/traverser.d.ts

@@ -1,3 +1,3 @@
-export { G as GraphTraverser, R as ReadyNode } from '../types-DWCZW68f.js';
+export { G as GraphTraverser, R as ReadyNode } from '../types-B-Drn84R.js';
 import '../errors.js';
 import '../container.js';

package/dist/runtime/traverser.js

@@ -1,4 +1,4 @@
-export { GraphTraverser } from '../chunk-G5BGBPFP.js';
-import '../chunk-233SESC2.js';
+export { GraphTraverser } from '../chunk-FBPY44WL.js';
+import '../chunk-ZLW4QOTS.js';
 //# sourceMappingURL=traverser.js.map
 //# sourceMappingURL=traverser.js.map

package/dist/runtime/types.d.ts

@@ -1,3 +1,3 @@
-export { e as ExecutionServices, I as IOrchestrator, f as IRuntime, N as NodeExecutionResult, b as NodeExecutor, d as NodeExecutorFactory } from '../types-DWCZW68f.js';
+export { e as ExecutionServices, I as IOrchestrator, f as IRuntime, N as NodeExecutionResult, b as NodeExecutor, d as NodeExecutorFactory } from '../types-B-Drn84R.js';
 import '../errors.js';
 import '../container.js';

package/dist/runtime/workflow-logic-handler.d.ts

@@ -1,4 +1,4 @@
-import { w as IEvaluator, z as IEventBus, g as WorkflowBlueprint, l as NodeResult, r as ContextImplementation, h as NodeDefinition, j as EdgeDefinition } from '../types-DWCZW68f.js';
+import { x as IEvaluator, A as IEventBus, h as WorkflowBlueprint, m as NodeResult, s as ContextImplementation, j as NodeDefinition, k as EdgeDefinition } from '../types-B-Drn84R.js';
 import '../errors.js';
 import '../container.js';
 

package/dist/runtime/workflow-logic-handler.js

@@ -1,5 +1,5 @@
-export { WorkflowLogicHandler } from '../chunk-MCGK3FXQ.js';
-import '../chunk-R3HQXIEL.js';
+export { WorkflowLogicHandler } from '../chunk-SEI4Z3MO.js';
+import '../chunk-XDI4TJHA.js';
 import '../chunk-BCRWXTWX.js';
 //# sourceMappingURL=workflow-logic-handler.js.map
 //# sourceMappingURL=workflow-logic-handler.js.map

package/dist/sanitizer.d.ts

@@ -1,4 +1,4 @@
-import { g as WorkflowBlueprint } from './types-DWCZW68f.js';
+import { h as WorkflowBlueprint } from './types-B-Drn84R.js';
 import './errors.js';
 import './container.js';
 

package/dist/sdk.d.ts

@@ -0,0 +1,29 @@
+interface Webhook<T = any> {
+    /** The unique public URL to which the external system should send its POST request. */
+    url: string;
+    /** A unique event name which can be used to trigger the webhook */
+    event: string;
+    /** A promise-like object that resolves with the webhook's request details when it is invoked. */
+    request: Promise<{
+        json: () => Promise<T>;
+        text: () => Promise<string>;
+        headers: Record<string, string>;
+    }>;
+}
+/**
+ * Pauses workflow execution for a specified duration.
+ * Must be used with `await` inside a compiled `@flow` function.
+ */
+declare function sleep(_duration: number | string): Promise<void>;
+/**
+ * Pauses a workflow until an external event is received.
+ * Must be used with `await` inside a compiled `@flow` function.
+ */
+declare function waitForEvent<T = any>(_eventName: string): Promise<T>;
+/**
+ * Creates a durable, single-use webhook endpoint.
+ * Must be used with `await` inside a compiled `@flow` function.
+ */
+declare function createWebhook<T = any>(): Promise<Webhook<T>>;
+
+export { type Webhook, createWebhook, sleep, waitForEvent };

package/dist/sdk.js

@@ -0,0 +1,20 @@
+// src/sdk.ts
+function sleep(_duration) {
+  console.warn(`'sleep' should only be used inside a compiled @flow function.`);
+  return new Promise(() => {
+  });
+}
+function waitForEvent(_eventName) {
+  console.warn(`'waitForEvent' should only be used inside a compiled @flow function.`);
+  return new Promise(() => {
+  });
+}
+function createWebhook() {
+  console.warn(`'createWebhook' should only be used inside a compiled @flow function.`);
+  return new Promise(() => {
+  });
+}
+
+export { createWebhook, sleep, waitForEvent };
+//# sourceMappingURL=sdk.js.map
+//# sourceMappingURL=sdk.js.map

package/dist/sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sdk.ts"],"names":[],"mappings":";AAiBO,SAAS,MAAM,SAAA,EAA2C;AAChE,EAAA,OAAA,CAAQ,KAAK,CAAA,6DAAA,CAA+D,CAAA;AAC5E,EAAA,OAAO,IAAI,QAAQ,MAAM;AAAA,EAAC,CAAC,CAAA;AAC5B;AAMO,SAAS,aAAsB,UAAA,EAAgC;AACrE,EAAA,OAAA,CAAQ,KAAK,CAAA,oEAAA,CAAsE,CAAA;AACnF,EAAA,OAAO,IAAI,QAAQ,MAAM;AAAA,EAAC,CAAC,CAAA;AAC5B;AAMO,SAAS,aAAA,GAA8C;AAC7D,EAAA,OAAA,CAAQ,KAAK,CAAA,qEAAA,CAAuE,CAAA;AACpF,EAAA,OAAO,IAAI,QAAQ,MAAM;AAAA,EAAC,CAAC,CAAA;AAC5B","file":"sdk.js","sourcesContent":["export interface Webhook<T = any> {\n\t/** The unique public URL to which the external system should send its POST request. */\n\turl: string\n\t/** A unique event name which can be used to trigger the webhook */\n\tevent: string\n\t/** A promise-like object that resolves with the webhook's request details when it is invoked. */\n\trequest: Promise<{\n\t\tjson: () => Promise<T>\n\t\ttext: () => Promise<string>\n\t\theaders: Record<string, string>\n\t}>\n}\n\n/**\n * Pauses workflow execution for a specified duration.\n * Must be used with `await` inside a compiled `@flow` function.\n */\nexport function sleep(_duration: number | string): Promise<void> {\n\tconsole.warn(`'sleep' should only be used inside a compiled @flow function.`)\n\treturn new Promise(() => {}) // intentionally never resolves\n}\n\n/**\n * Pauses a workflow until an external event is received.\n * Must be used with `await` inside a compiled `@flow` function.\n */\nexport function waitForEvent<T = any>(_eventName: string): Promise<T> {\n\tconsole.warn(`'waitForEvent' should only be used inside a compiled @flow function.`)\n\treturn new Promise(() => {}) // intentionally never resolves\n}\n\n/**\n * Creates a durable, single-use webhook endpoint.\n * Must be used with `await` inside a compiled `@flow` function.\n */\nexport function createWebhook<T = any>(): Promise<Webhook<T>> {\n\tconsole.warn(`'createWebhook' should only be used inside a compiled @flow function.`)\n\treturn new Promise(() => {}) // intentionally never resolves\n}\n"]}

package/dist/serializer.d.ts

@@ -1,4 +1,4 @@
-import { A as ISerializer } from './types-DWCZW68f.js';
+import { D as ISerializer } from './types-B-Drn84R.js';
 import './errors.js';
 import './container.js';
 

package/dist/testing/event-logger.d.ts

@@ -1,4 +1,4 @@
-import { z as IEventBus, y as FlowcraftEvent } from '../types-DWCZW68f.js';
+import { A as IEventBus, z as FlowcraftEvent } from '../types-B-Drn84R.js';
 import '../errors.js';
 import '../container.js';
 

package/dist/testing/index.d.ts

@@ -1,6 +1,6 @@
 export { InMemoryEventLogger } from './event-logger.js';
 export { runWithTrace } from './run-with-trace.js';
 export { IWorkflowStepper, createStepper } from './stepper.js';
-import '../types-DWCZW68f.js';
+import '../types-B-Drn84R.js';
 import '../errors.js';
 import '../container.js';

package/dist/testing/index.js

@@ -1,31 +1,32 @@
-export { runWithTrace } from '../chunk-VN2JKKAE.js';
+export { runWithTrace } from '../chunk-6MGLU3UU.js';
 export { InMemoryEventLogger } from '../chunk-MUYLRTSR.js';
-export { createStepper } from '../chunk-GIJOZ3AN.js';
+export { createStepper } from '../chunk-JLDHCI2O.js';
 import '../chunk-G53CSLBF.js';
 import '../chunk-NVJ3ZO3P.js';
 import '../chunk-NVLZFLYM.js';
-import '../chunk-J3HZD5ES.js';
-import '../chunk-CHG6O6JX.js';
+import '../chunk-5XPW6YEP.js';
+import '../chunk-OPRR4TAO.js';
+import '../chunk-SEI4Z3MO.js';
 import '../chunk-DL7KVYZF.js';
-import '../chunk-LM4ACVHL.js';
-import '../chunk-MCGK3FXQ.js';
-import '../chunk-LJ4COM7S.js';
-import '../chunk-K6LPGUPR.js';
-import '../chunk-G5BGBPFP.js';
-import '../chunk-GVF7GQXQ.js';
 import '../chunk-ONH7PIJZ.js';
-import '../chunk-DSYAC4WB.js';
+import '../chunk-LM4ACVHL.js';
 import '../chunk-BC4G7OM6.js';
 import '../chunk-RM677CNU.js';
-import '../chunk-233SESC2.js';
-import '../chunk-NDWVLU7J.js';
+import '../chunk-HNHM3FDK.js';
+import '../chunk-UXIASXSG.js';
+import '../chunk-FBPY44WL.js';
+import '../chunk-IDTYHLDQ.js';
+import '../chunk-I53JB2KW.js';
+import '../chunk-DSYAC4WB.js';
+import '../chunk-ZLW4QOTS.js';
+import '../chunk-XTW36KQZ.js';
 import '../chunk-HAZ26F3P.js';
-import '../chunk-KXXEA5VE.js';
-import '../chunk-OO3FF3DF.js';
+import '../chunk-N4NLAIEN.js';
+import '../chunk-5BOUGXZO.js';
 import '../chunk-4PELJWF7.js';
 import '../chunk-CYHZ2YVH.js';
 import '../chunk-WWGFIYKW.js';
-import '../chunk-R3HQXIEL.js';
+import '../chunk-XDI4TJHA.js';
 import '../chunk-BCRWXTWX.js';
 import '../chunk-PH2IYZHV.js';
 import '../chunk-LNK7LZER.js';

package/dist/testing/run-with-trace.d.ts

@@ -1,4 +1,4 @@
-import { c as FlowRuntime, g as WorkflowBlueprint, J as WorkflowResult } from '../types-DWCZW68f.js';
+import { c as FlowRuntime, h as WorkflowBlueprint, K as WorkflowResult } from '../types-B-Drn84R.js';
 import '../errors.js';
 import '../container.js';
 

package/dist/testing/run-with-trace.js

@@ -1,29 +1,30 @@
-export { runWithTrace } from '../chunk-VN2JKKAE.js';
+export { runWithTrace } from '../chunk-6MGLU3UU.js';
 import '../chunk-MUYLRTSR.js';
 import '../chunk-NVJ3ZO3P.js';
 import '../chunk-NVLZFLYM.js';
-import '../chunk-J3HZD5ES.js';
-import '../chunk-CHG6O6JX.js';
+import '../chunk-5XPW6YEP.js';
+import '../chunk-OPRR4TAO.js';
+import '../chunk-SEI4Z3MO.js';
 import '../chunk-DL7KVYZF.js';
-import '../chunk-LM4ACVHL.js';
-import '../chunk-MCGK3FXQ.js';
-import '../chunk-LJ4COM7S.js';
-import '../chunk-K6LPGUPR.js';
-import '../chunk-G5BGBPFP.js';
-import '../chunk-GVF7GQXQ.js';
 import '../chunk-ONH7PIJZ.js';
-import '../chunk-DSYAC4WB.js';
+import '../chunk-LM4ACVHL.js';
 import '../chunk-BC4G7OM6.js';
 import '../chunk-RM677CNU.js';
-import '../chunk-233SESC2.js';
-import '../chunk-NDWVLU7J.js';
+import '../chunk-HNHM3FDK.js';
+import '../chunk-UXIASXSG.js';
+import '../chunk-FBPY44WL.js';
+import '../chunk-IDTYHLDQ.js';
+import '../chunk-I53JB2KW.js';
+import '../chunk-DSYAC4WB.js';
+import '../chunk-ZLW4QOTS.js';
+import '../chunk-XTW36KQZ.js';
 import '../chunk-HAZ26F3P.js';
-import '../chunk-KXXEA5VE.js';
-import '../chunk-OO3FF3DF.js';
+import '../chunk-N4NLAIEN.js';
+import '../chunk-5BOUGXZO.js';
 import '../chunk-4PELJWF7.js';
 import '../chunk-CYHZ2YVH.js';
 import '../chunk-WWGFIYKW.js';
-import '../chunk-R3HQXIEL.js';
+import '../chunk-XDI4TJHA.js';
 import '../chunk-BCRWXTWX.js';
 import '../chunk-PH2IYZHV.js';
 import '../chunk-LNK7LZER.js';

package/dist/testing/stepper.d.ts

@@ -1,4 +1,4 @@
-import { W as WorkflowState, G as GraphTraverser, J as WorkflowResult, c as FlowRuntime, g as WorkflowBlueprint, n as NodeFunction, o as NodeClass } from '../types-DWCZW68f.js';
+import { W as WorkflowState, G as GraphTraverser, K as WorkflowResult, c as FlowRuntime, h as WorkflowBlueprint, o as NodeFunction, p as NodeClass } from '../types-B-Drn84R.js';
 import '../errors.js';
 import '../container.js';
 

package/dist/testing/stepper.js

@@ -1,11 +1,11 @@
-export { createStepper } from '../chunk-GIJOZ3AN.js';
+export { createStepper } from '../chunk-JLDHCI2O.js';
 import '../chunk-G53CSLBF.js';
-import '../chunk-G5BGBPFP.js';
-import '../chunk-233SESC2.js';
+import '../chunk-FBPY44WL.js';
+import '../chunk-ZLW4QOTS.js';
 import '../chunk-HAZ26F3P.js';
-import '../chunk-KXXEA5VE.js';
-import '../chunk-OO3FF3DF.js';
-import '../chunk-R3HQXIEL.js';
+import '../chunk-N4NLAIEN.js';
+import '../chunk-5BOUGXZO.js';
+import '../chunk-XDI4TJHA.js';
 import '../chunk-BCRWXTWX.js';
 //# sourceMappingURL=stepper.js.map
 //# sourceMappingURL=stepper.js.map

package/dist/{types-DWCZW68f.d.ts → types-B-Drn84R.d.ts}

@@ -88,7 +88,7 @@ declare class WorkflowState<TContext extends Record<string, any>> {
     getCompletedNodes(): Set<string>;
     getErrors(): WorkflowError[];
     getAnyFallbackExecuted(): boolean;
-    markAsAwaiting(nodeId: string, details?: any): void;
+    markAsAwaiting(nodeId: string, details?: any): Promise<void>;
     isAwaiting(): boolean;
     getAwaitingNodeIds(): string[];
     getAwaitingDetails(nodeId: string): any;
@@ -287,12 +287,26 @@ declare class ExecutionContext<TContext extends Record<string, any>, TDependenci
     createForSubflow(subBlueprint: WorkflowBlueprint, initialSubState: Partial<TContext>): ExecutionContext<TContext, TDependencies>;
 }
 
+/** Source location information for debugging and visualization. */
+interface SourceLocation {
+    file: string;
+    line: number;
+    column: number;
+}
+/** Metadata associated with a workflow blueprint. */
+interface WorkflowBlueprintMetadata {
+    /** Optional version identifier for the blueprint. Used in distributed systems to ensure version compatibility. */
+    version?: string;
+    /** Entry points for cycles in the workflow graph. */
+    cycleEntryPoints?: string[];
+    [key: string]: any;
+}
 /** The central, serializable representation of a workflow. */
 interface WorkflowBlueprint {
     id: string;
     nodes: NodeDefinition[];
     edges: EdgeDefinition[];
-    metadata?: Record<string, any>;
+    metadata?: WorkflowBlueprintMetadata;
 }
 /** Defines a single step in the workflow. */
 interface NodeDefinition {
@@ -305,6 +319,8 @@ interface NodeDefinition {
     inputs?: string | Record<string, string>;
     /** Configuration for retries, timeouts, etc. */
     config?: NodeConfig;
+    /** Source location for debugging and visualization. */
+    _sourceLocation?: SourceLocation;
 }
 /** Defines the connection and data flow between two nodes. */
 interface EdgeDefinition {
@@ -316,6 +332,8 @@ interface EdgeDefinition {
     condition?: string;
     /** A string expression to transform the data before passing it to the target node. */
     transform?: string;
+    /** Source location for debugging and visualization. */
+    _sourceLocation?: SourceLocation;
 }
 /** Configuration for a node's resiliency and behavior. */
 interface NodeConfig {
@@ -391,7 +409,21 @@ interface IAsyncContext<TContext extends Record<string, any> = Record<string, an
     delete<K extends keyof TContext>(key: K): Promise<boolean>;
     delete(key: string): Promise<boolean>;
     toJSON: () => Promise<Record<string, any>>;
+    /**
+     * Applies a batch of patch operations atomically.
+     * More efficient than individual set/delete calls for bulk updates.
+     */
+    patch(operations: PatchOperation[]): Promise<void>;
 }
+/** Represents a single patch operation for delta-based state updates. */
+type PatchOperation = {
+    op: 'set';
+    key: string;
+    value: any;
+} | {
+    op: 'delete';
+    key: string;
+};
 /** Generic for any set of dependencies. */
 interface RuntimeDependencies {
     [key: string]: any;
@@ -588,4 +620,4 @@ interface UIGraph {
     }>;
 }
 
-export { type ISerializer as A, BaseNode as B, ClassNodeExecutor as C, type WorkflowError as D, type ExecutionStrategy as E, FunctionNodeExecutor as F, GraphTraverser as G, type WorkflowStatus as H, type IOrchestrator as I, type WorkflowResult as J, ExecutionContext as K, type AwaitingWorkflow as L, type Middleware as M, type NodeExecutionResult as N, WorkflowScheduler as O, type ReadyNode as R, type UIGraph as U, WorkflowState as W, type NodeExecutorConfig as a, NodeExecutor as b, FlowRuntime as c, type NodeExecutorFactory as d, type ExecutionServices as e, type IRuntime as f, type WorkflowBlueprint as g, type NodeDefinition as h, isNodeClass as i, type EdgeDefinition as j, type NodeConfig as k, type NodeResult as l, type NodeContext as m, type NodeFunction as n, type NodeClass as o, type NodeImplementation as p, type NodeRegistry as q, type ContextImplementation as r, type ISyncContext as s, type IAsyncContext as t, type RuntimeDependencies as u, type RuntimeOptions as v, type IEvaluator as w, type ILogger as x, type FlowcraftEvent as y, type IEventBus as z };
+export { type IEventBus as A, BaseNode as B, ClassNodeExecutor as C, type ISerializer as D, type ExecutionStrategy as E, FunctionNodeExecutor as F, GraphTraverser as G, type WorkflowError as H, type IOrchestrator as I, type WorkflowStatus as J, type WorkflowResult as K, ExecutionContext as L, type Middleware as M, type NodeExecutionResult as N, type AwaitingWorkflow as O, type PatchOperation as P, WorkflowScheduler as Q, type ReadyNode as R, type SourceLocation as S, type UIGraph as U, WorkflowState as W, type NodeExecutorConfig as a, NodeExecutor as b, FlowRuntime as c, type NodeExecutorFactory as d, type ExecutionServices as e, type IRuntime as f, type WorkflowBlueprintMetadata as g, type WorkflowBlueprint as h, isNodeClass as i, type NodeDefinition as j, type EdgeDefinition as k, type NodeConfig as l, type NodeResult as m, type NodeContext as n, type NodeFunction as o, type NodeClass as p, type NodeImplementation as q, type NodeRegistry as r, type ContextImplementation as s, type ISyncContext as t, type IAsyncContext as u, type RuntimeDependencies as v, type RuntimeOptions as w, type IEvaluator as x, type ILogger as y, type FlowcraftEvent as z };

package/dist/types.d.ts

@@ -1,3 +1,3 @@
 import './errors.js';
-export { r as ContextImplementation, j as EdgeDefinition, y as FlowcraftEvent, t as IAsyncContext, w as IEvaluator, z as IEventBus, x as ILogger, A as ISerializer, s as ISyncContext, M as Middleware, o as NodeClass, k as NodeConfig, m as NodeContext, h as NodeDefinition, n as NodeFunction, p as NodeImplementation, q as NodeRegistry, l as NodeResult, u as RuntimeDependencies, v as RuntimeOptions, U as UIGraph, g as WorkflowBlueprint, D as WorkflowError, J as WorkflowResult, H as WorkflowStatus } from './types-DWCZW68f.js';
+export { s as ContextImplementation, k as EdgeDefinition, z as FlowcraftEvent, u as IAsyncContext, x as IEvaluator, A as IEventBus, y as ILogger, D as ISerializer, t as ISyncContext, M as Middleware, p as NodeClass, l as NodeConfig, n as NodeContext, j as NodeDefinition, o as NodeFunction, q as NodeImplementation, r as NodeRegistry, m as NodeResult, P as PatchOperation, v as RuntimeDependencies, w as RuntimeOptions, S as SourceLocation, U as UIGraph, h as WorkflowBlueprint, g as WorkflowBlueprintMetadata, H as WorkflowError, K as WorkflowResult, J as WorkflowStatus } from './types-B-Drn84R.js';
 import './container.js';