@cadenza.io/core 1.7.11 → 1.8.0

package/dist/index.d.mts

@@ -195,6 +195,9 @@ declare class GraphNode extends SignalEmitter implements Graph {
     private subgraphComplete;
     private graphComplete;
     private result;
+    private retryCount;
+    private retryDelay;
+    private retries;
     private previousNodes;
     private nextNodes;
     private executionTime;
@@ -222,11 +225,15 @@ declare class GraphNode extends SignalEmitter implements Graph {
     start(): number;
     end(): number;
     execute(): GraphNode[] | Promise<GraphNode[]>;
-    private processAsync;
+    private workAsync;
+    private executeAsync;
     private work;
     private onProgress;
     private postProcess;
     private onError;
+    private retry;
+    private retryAsync;
+    private delayRetry;
     private divide;
     private generateNewNodes;
     private differentiate;
@@ -248,7 +255,7 @@ declare class GraphNode extends SignalEmitter implements Graph {
             __id: string;
             __context: AnyObject;
         };
-        __result: unknown;
+        __result: TaskResult;
         __executionTime: number;
         __executionStart: number;
         __executionEnd: number;
@@ -391,7 +398,7 @@ type SchemaDefinition = {
 };
 
 type TaskFunction = (context: AnyObject, progressCallback: (progress: number) => void) => TaskResult;
-type TaskResult = boolean | object | Generator | Promise<any> | void;
+type TaskResult = boolean | AnyObject | Generator | Promise<any> | void;
 type ThrottleTagGetter = (context?: AnyObject, task?: Task) => string;
 declare class Task extends SignalParticipant implements Graph {
     id: string;
@@ -409,6 +416,10 @@ declare class Task extends SignalParticipant implements Graph {
     protected validateInputContext: boolean;
     protected outputContextSchema: SchemaDefinition | undefined;
     protected validateOutputContext: boolean;
+    readonly retryCount: number;
+    readonly retryDelay: number;
+    readonly retryDelayMax: number;
+    readonly retryDelayFactor: number;
     layerIndex: number;
     progressWeight: number;
     private nextTasks;
@@ -431,9 +442,13 @@ declare class Task extends SignalParticipant implements Graph {
      * @param validateInputContext
      * @param outputSchema
      * @param validateOutputContext
+     * @param retryCount
+     * @param retryDelay
+     * @param retryDelayMax
+     * @param retryDelayFactor
      * @edge Emits 'meta.task.created' with { __task: this } for seed.
      */
-    constructor(name: string, task: TaskFunction, description?: string, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, getTagCallback?: ThrottleTagGetter | undefined, inputSchema?: SchemaDefinition | undefined, validateInputContext?: boolean, outputSchema?: SchemaDefinition | undefined, validateOutputContext?: boolean);
+    constructor(name: string, task: TaskFunction, description?: string, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, getTagCallback?: ThrottleTagGetter | undefined, inputSchema?: SchemaDefinition | undefined, validateInputContext?: boolean, outputSchema?: SchemaDefinition | undefined, validateOutputContext?: boolean, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
     getTag(context?: AnyObject): string;
     setGlobalId(id: string): void;
     setTimeout(timeout: number): void;
@@ -718,7 +733,7 @@ declare class EphemeralTask extends Task {
     private readonly once;
     private readonly condition;
     readonly isEphemeral: boolean;
-    constructor(name: string, task: TaskFunction, description?: string, once?: boolean, condition?: (context: any) => boolean, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, getTagCallback?: ThrottleTagGetter | undefined, inputSchema?: SchemaDefinition | undefined, validateInputContext?: boolean, outputSchema?: SchemaDefinition | undefined, validateOutputContext?: boolean);
+    constructor(name: string, task: TaskFunction, description?: string, once?: boolean, condition?: (context: any) => boolean, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, getTagCallback?: ThrottleTagGetter | undefined, inputSchema?: SchemaDefinition | undefined, validateInputContext?: boolean, outputSchema?: SchemaDefinition | undefined, validateOutputContext?: boolean, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
     execute(context: any, progressCallback: (progress: number) => void): TaskResult;
 }
 
@@ -745,6 +760,10 @@ interface TaskOptions {
     validateInputContext?: boolean;
     outputSchema?: SchemaDefinition;
     validateOutputContext?: boolean;
+    retryCount?: number;
+    retryDelay?: number;
+    retryDelayMax?: number;
+    retryDelayFactor?: number;
 }
 type CadenzaMode = "dev" | "debug" | "production";
 declare class Cadenza {

package/dist/index.d.ts

@@ -195,6 +195,9 @@ declare class GraphNode extends SignalEmitter implements Graph {
     private subgraphComplete;
     private graphComplete;
     private result;
+    private retryCount;
+    private retryDelay;
+    private retries;
     private previousNodes;
     private nextNodes;
     private executionTime;
@@ -222,11 +225,15 @@ declare class GraphNode extends SignalEmitter implements Graph {
     start(): number;
     end(): number;
     execute(): GraphNode[] | Promise<GraphNode[]>;
-    private processAsync;
+    private workAsync;
+    private executeAsync;
     private work;
     private onProgress;
     private postProcess;
     private onError;
+    private retry;
+    private retryAsync;
+    private delayRetry;
     private divide;
     private generateNewNodes;
     private differentiate;
@@ -248,7 +255,7 @@ declare class GraphNode extends SignalEmitter implements Graph {
             __id: string;
             __context: AnyObject;
         };
-        __result: unknown;
+        __result: TaskResult;
         __executionTime: number;
         __executionStart: number;
         __executionEnd: number;
@@ -391,7 +398,7 @@ type SchemaDefinition = {
 };
 
 type TaskFunction = (context: AnyObject, progressCallback: (progress: number) => void) => TaskResult;
-type TaskResult = boolean | object | Generator | Promise<any> | void;
+type TaskResult = boolean | AnyObject | Generator | Promise<any> | void;
 type ThrottleTagGetter = (context?: AnyObject, task?: Task) => string;
 declare class Task extends SignalParticipant implements Graph {
     id: string;
@@ -409,6 +416,10 @@ declare class Task extends SignalParticipant implements Graph {
     protected validateInputContext: boolean;
     protected outputContextSchema: SchemaDefinition | undefined;
     protected validateOutputContext: boolean;
+    readonly retryCount: number;
+    readonly retryDelay: number;
+    readonly retryDelayMax: number;
+    readonly retryDelayFactor: number;
     layerIndex: number;
     progressWeight: number;
     private nextTasks;
@@ -431,9 +442,13 @@ declare class Task extends SignalParticipant implements Graph {
      * @param validateInputContext
      * @param outputSchema
      * @param validateOutputContext
+     * @param retryCount
+     * @param retryDelay
+     * @param retryDelayMax
+     * @param retryDelayFactor
      * @edge Emits 'meta.task.created' with { __task: this } for seed.
      */
-    constructor(name: string, task: TaskFunction, description?: string, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, getTagCallback?: ThrottleTagGetter | undefined, inputSchema?: SchemaDefinition | undefined, validateInputContext?: boolean, outputSchema?: SchemaDefinition | undefined, validateOutputContext?: boolean);
+    constructor(name: string, task: TaskFunction, description?: string, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, getTagCallback?: ThrottleTagGetter | undefined, inputSchema?: SchemaDefinition | undefined, validateInputContext?: boolean, outputSchema?: SchemaDefinition | undefined, validateOutputContext?: boolean, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
     getTag(context?: AnyObject): string;
     setGlobalId(id: string): void;
     setTimeout(timeout: number): void;
@@ -718,7 +733,7 @@ declare class EphemeralTask extends Task {
     private readonly once;
     private readonly condition;
     readonly isEphemeral: boolean;
-    constructor(name: string, task: TaskFunction, description?: string, once?: boolean, condition?: (context: any) => boolean, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, getTagCallback?: ThrottleTagGetter | undefined, inputSchema?: SchemaDefinition | undefined, validateInputContext?: boolean, outputSchema?: SchemaDefinition | undefined, validateOutputContext?: boolean);
+    constructor(name: string, task: TaskFunction, description?: string, once?: boolean, condition?: (context: any) => boolean, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, getTagCallback?: ThrottleTagGetter | undefined, inputSchema?: SchemaDefinition | undefined, validateInputContext?: boolean, outputSchema?: SchemaDefinition | undefined, validateOutputContext?: boolean, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
     execute(context: any, progressCallback: (progress: number) => void): TaskResult;
 }
 
@@ -745,6 +760,10 @@ interface TaskOptions {
     validateInputContext?: boolean;
     outputSchema?: SchemaDefinition;
     validateOutputContext?: boolean;
+    retryCount?: number;
+    retryDelay?: number;
+    retryDelayMax?: number;
+    retryDelayFactor?: number;
 }
 type CadenzaMode = "dev" | "debug" | "production";
 declare class Cadenza {

package/dist/index.js

@@ -646,6 +646,11 @@ var SignalEmitter = class {
   }
 };
 
+// src/utils/promise.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
 // src/graph/execution/GraphNode.ts
 var GraphNode = class _GraphNode extends SignalEmitter {
   constructor(task, context, routineExecId, prevNodes = [], debug = false) {
@@ -655,6 +660,10 @@ var GraphNode = class _GraphNode extends SignalEmitter {
     this.processing = false;
     this.subgraphComplete = false;
     this.graphComplete = false;
+    this.result = false;
+    this.retryCount = 0;
+    this.retryDelay = 0;
+    this.retries = 0;
     this.previousNodes = [];
     this.nextNodes = [];
     this.executionTime = 0;
@@ -663,10 +672,12 @@ var GraphNode = class _GraphNode extends SignalEmitter {
     this.errored = false;
     this.destroyed = false;
     this.debug = false;
+    this.id = (0, import_uuid3.v4)();
     this.task = task;
     this.context = context;
+    this.retryCount = task.retryCount;
+    this.retryDelay = task.retryDelay;
     this.previousNodes = prevNodes;
-    this.id = (0, import_uuid3.v4)();
     this.routineExecId = routineExecId;
     this.splitGroupId = routineExecId;
     this.debug = debug;
@@ -781,29 +792,49 @@ var GraphNode = class _GraphNode extends SignalEmitter {
         this.postProcess();
         return this.nextNodes;
       }
-      try {
-        this.result = this.work();
-      } catch (e) {
-        this.onError(e);
-      }
+      this.result = this.work();
       if (this.result instanceof Promise) {
-        return this.processAsync();
+        return this.executeAsync();
       }
       this.postProcess();
     }
     return this.nextNodes;
   }
-  async processAsync() {
+  async workAsync() {
     try {
       this.result = await this.result;
     } catch (e) {
-      this.onError(e);
+      const result = await this.retryAsync(e);
+      if (result === e) {
+        this.onError(e);
+      }
     }
+  }
+  async executeAsync() {
+    await this.workAsync();
     this.postProcess();
     return this.nextNodes;
   }
   work() {
-    return this.task.execute(this.context, this.onProgress.bind(this));
+    try {
+      const result = this.task.execute(
+        this.context,
+        this.onProgress.bind(this)
+      );
+      if (result.errored || result.failed) {
+        return this.retry(result);
+      }
+      return result;
+    } catch (e) {
+      const result = this.retry(e);
+      return result.then((result2) => {
+        if (result2 !== e) {
+          return result2;
+        }
+        this.onError(e);
+        return this.result;
+      });
+    }
   }
   onProgress(progress) {
     var _a, _b, _c;
@@ -839,6 +870,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
     this.result = {
       ...this.context.getFullContext(),
       __error: `Node error: ${error}`,
+      __retries: this.retries,
       error: `Node error: ${error}`,
       returnedValue: this.result,
       ...errorData
@@ -846,6 +878,30 @@ var GraphNode = class _GraphNode extends SignalEmitter {
     this.migrate(this.result);
     this.errored = true;
   }
+  async retry(prevResult) {
+    if (this.retryCount === 0) {
+      return prevResult;
+    }
+    await this.delayRetry();
+    return this.work();
+  }
+  async retryAsync(prevResult) {
+    if (this.retryCount === 0) {
+      return prevResult;
+    }
+    await this.delayRetry();
+    this.result = this.work();
+    return this.workAsync();
+  }
+  async delayRetry() {
+    this.retryCount--;
+    this.retries++;
+    await sleep(this.retryDelay);
+    this.retryDelay *= this.task.retryDelayFactor;
+    if (this.retryDelay > this.task.retryDelayMax) {
+      this.retryDelay = this.task.retryDelayMax;
+    }
+  }
   divide() {
     var _a;
     const newNodes = [];
@@ -869,7 +925,14 @@ var GraphNode = class _GraphNode extends SignalEmitter {
         if (outputValidation !== true) {
           this.onError(outputValidation.__validationErrors);
         }
-        this.migrate({ ...this.result, ...this.context.getMetaData() });
+        this.divided = true;
+        this.migrate({
+          ...this.result,
+          ...this.context.getMetaData(),
+          __nextNodes: newNodes.map((n) => n.id),
+          __retries: this.retries
+        });
+        return newNodes;
       }
     }
     if (this.errored) {
@@ -883,7 +946,8 @@ var GraphNode = class _GraphNode extends SignalEmitter {
     this.divided = true;
     this.migrate({
       ...this.context.getFullContext(),
-      __nextNodes: newNodes.map((n) => n.id)
+      __nextNodes: newNodes.map((n) => n.id),
+      __retries: this.retries
     });
     return newNodes;
   }
@@ -1260,9 +1324,13 @@ var Task = class extends SignalParticipant {
    * @param validateInputContext
    * @param outputSchema
    * @param validateOutputContext
+   * @param retryCount
+   * @param retryDelay
+   * @param retryDelayMax
+   * @param retryDelayFactor
    * @edge Emits 'meta.task.created' with { __task: this } for seed.
    */
-  constructor(name, task, description = "", concurrency = 0, timeout = 0, register = true, isUnique = false, isMeta = false, getTagCallback = void 0, inputSchema = void 0, validateInputContext = false, outputSchema = void 0, validateOutputContext = false) {
+  constructor(name, task, description = "", concurrency = 0, timeout = 0, register = true, isUnique = false, isMeta = false, getTagCallback = void 0, inputSchema = void 0, validateInputContext = false, outputSchema = void 0, validateOutputContext = false, retryCount = 0, retryDelay = 0, retryDelayMax = 0, retryDelayFactor = 1) {
     super();
     this.isMeta = false;
     this.isUnique = false;
@@ -1274,6 +1342,10 @@ var Task = class extends SignalParticipant {
     this.validateInputContext = false;
     this.outputContextSchema = void 0;
     this.validateOutputContext = false;
+    this.retryCount = 0;
+    this.retryDelay = 0;
+    this.retryDelayMax = 0;
+    this.retryDelayFactor = 1;
     this.layerIndex = 0;
     this.progressWeight = 0;
     this.nextTasks = /* @__PURE__ */ new Set();
@@ -1292,6 +1364,10 @@ var Task = class extends SignalParticipant {
     this.validateInputContext = validateInputContext;
     this.outputContextSchema = outputSchema;
     this.validateOutputContext = validateOutputContext;
+    this.retryCount = retryCount;
+    this.retryDelay = retryDelay;
+    this.retryDelayMax = retryDelayMax;
+    this.retryDelayFactor = retryDelayFactor;
     if (getTagCallback) {
       this.getTag = (context) => getTagCallback(context, this);
       this.throttled = true;
@@ -2123,7 +2199,7 @@ var DebounceTask = class extends Task {
 
 // src/graph/definition/EphemeralTask.ts
 var EphemeralTask = class extends Task {
-  constructor(name, task, description = "", once = true, condition = () => true, concurrency = 0, timeout = 0, register = false, isUnique = false, isMeta = false, getTagCallback = void 0, inputSchema = void 0, validateInputContext = false, outputSchema = void 0, validateOutputContext = false) {
+  constructor(name, task, description = "", once = true, condition = () => true, concurrency = 0, timeout = 0, register = false, isUnique = false, isMeta = false, getTagCallback = void 0, inputSchema = void 0, validateInputContext = false, outputSchema = void 0, validateOutputContext = false, retryCount = 0, retryDelay = 0, retryDelayMax = 0, retryDelayFactor = 1) {
     super(
       name,
       task,
@@ -2137,7 +2213,11 @@ var EphemeralTask = class extends Task {
       inputSchema,
       validateInputContext,
       outputSchema,
-      validateOutputContext
+      validateOutputContext,
+      retryCount,
+      retryDelay,
+      retryDelayMax,
+      retryDelayFactor
     );
     this.isEphemeral = true;
     this.once = once;
@@ -2475,11 +2555,6 @@ var GraphRunStrategy = class {
   }
 };
 
-// src/utils/promise.ts
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
 // src/engine/ThrottleEngine.ts
 var ThrottleEngine = class _ThrottleEngine {
   constructor() {
@@ -2736,7 +2811,11 @@ var Cadenza = class {
     inputSchema: void 0,
     validateInputContext: false,
     outputSchema: void 0,
-    validateOutputContext: false
+    validateOutputContext: false,
+    retryCount: 0,
+    retryDelay: 0,
+    retryDelayMax: 0,
+    retryDelayFactor: 1
   }) {
     this.bootstrap();
     this.validateName(name);
@@ -2753,7 +2832,11 @@ var Cadenza = class {
       options.inputSchema,
       options.validateInputContext,
       options.outputSchema,
-      options.validateOutputContext
+      options.validateOutputContext,
+      options.retryCount,
+      options.retryDelay,
+      options.retryDelayMax,
+      options.retryDelayFactor
     );
   }
   /**
@@ -2776,7 +2859,11 @@ var Cadenza = class {
     inputSchema: void 0,
     validateInputContext: false,
     outputSchema: void 0,
-    validateOutputContext: false
+    validateOutputContext: false,
+    retryCount: 0,
+    retryDelay: 0,
+    retryDelayMax: 0,
+    retryDelayFactor: 1
   }) {
     options.isMeta = true;
     return this.createTask(name, func, description, options);
@@ -2801,7 +2888,11 @@ var Cadenza = class {
     inputSchema: void 0,
     validateInputContext: false,
     outputSchema: void 0,
-    validateOutputContext: false
+    validateOutputContext: false,
+    retryCount: 0,
+    retryDelay: 0,
+    retryDelayMax: 0,
+    retryDelayFactor: 1
   }) {
     options.isUnique = true;
     return this.createTask(name, func, description, options);
@@ -2824,7 +2915,11 @@ var Cadenza = class {
     inputSchema: void 0,
     validateInputContext: false,
     outputSchema: void 0,
-    validateOutputContext: false
+    validateOutputContext: false,
+    retryCount: 0,
+    retryDelay: 0,
+    retryDelayMax: 0,
+    retryDelayFactor: 1
   }) {
     options.isMeta = true;
     return this.createUniqueTask(name, func, description, options);
@@ -2848,7 +2943,11 @@ var Cadenza = class {
     inputSchema: void 0,
     validateInputContext: false,
     outputSchema: void 0,
-    validateOutputContext: false
+    validateOutputContext: false,
+    retryCount: 0,
+    retryDelay: 0,
+    retryDelayMax: 0,
+    retryDelayFactor: 1
   }) {
     options.getTagCallback = throttledIdGetter;
     return this.createTask(name, func, description, options);
@@ -2871,7 +2970,11 @@ var Cadenza = class {
     inputSchema: void 0,
     validateInputContext: false,
     outputSchema: void 0,
-    validateOutputContext: false
+    validateOutputContext: false,
+    retryCount: 0,
+    retryDelay: 0,
+    retryDelayMax: 0,
+    retryDelayFactor: 1
   }) {
     options.isMeta = true;
     return this.createThrottledTask(
@@ -2981,7 +3084,11 @@ var Cadenza = class {
     inputSchema: void 0,
     validateInputContext: false,
     outputSchema: void 0,
-    validateOutputContext: false
+    validateOutputContext: false,
+    retryCount: 0,
+    retryDelay: 0,
+    retryDelayMax: 0,
+    retryDelayFactor: 1
   }) {
     this.bootstrap();
     this.validateName(name);
@@ -3000,7 +3107,11 @@ var Cadenza = class {
       options.inputSchema,
       options.validateInputContext,
       options.outputSchema,
-      options.validateOutputContext
+      options.validateOutputContext,
+      options.retryCount,
+      options.retryDelay,
+      options.retryDelayMax,
+      options.retryDelayFactor
     );
   }
   /**
@@ -3023,7 +3134,11 @@ var Cadenza = class {
     inputSchema: void 0,
     validateInputContext: false,
     outputSchema: void 0,
-    validateOutputContext: false
+    validateOutputContext: false,
+    retryCount: 0,
+    retryDelay: 0,
+    retryDelayMax: 0,
+    retryDelayFactor: 1
   }) {
     options.isMeta = true;
     return this.createEphemeralTask(