@cadenza.io/core 1.7.11 → 1.9.0

package/dist/index.mjs

@@ -608,6 +608,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) {
@@ -617,6 +622,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;
@@ -625,10 +634,12 @@ var GraphNode = class _GraphNode extends SignalEmitter {
     this.errored = false;
     this.destroyed = false;
     this.debug = false;
+    this.id = uuid3();
     this.task = task;
     this.context = context;
+    this.retryCount = task.retryCount;
+    this.retryDelay = task.retryDelay;
     this.previousNodes = prevNodes;
-    this.id = uuid3();
     this.routineExecId = routineExecId;
     this.splitGroupId = routineExecId;
     this.debug = debug;
@@ -696,6 +707,20 @@ var GraphNode = class _GraphNode extends SignalEmitter {
         ...this.lightExport(),
         __scheduled: Date.now()
       });
+      const context = this.context.getFullContext();
+      if (context.__signalName !== void 0 && !context.__signalName.includes("meta.")) {
+        this.emit("meta.node.consumed_signal", {
+          __signal_log: {
+            signal_name: context.__signalName,
+            log_type: "consume",
+            consumed_by_task_id: this.task.id,
+            task_execution_id: this.id,
+            relation_type: "listener",
+            metadata: {},
+            is_meta: false
+          }
+        });
+      }
     }
   }
   start() {
@@ -743,29 +768,70 @@ 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.emitWithMetadata.bind(this),
+        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;
+      });
+    }
+  }
+  emitWithMetadata(signal, context) {
+    this.emit(signal, {
+      ...context,
+      __emittedSignal: signal,
+      __emittedByNode: this.id
+    });
+    if (!signal.includes(".meta")) {
+      this.emit("meta.node.emitted_signal", {
+        __signal_log: {
+          signal_name: signal,
+          log_type: "emit",
+          emitted_by_task_id: this.task.id,
+          task_execution_id: this.id,
+          relation_type: "emitter",
+          metadata: {},
+          is_meta: false
+        }
+      });
+    }
   }
   onProgress(progress) {
     var _a, _b, _c;
@@ -791,9 +857,13 @@ var GraphNode = class _GraphNode extends SignalEmitter {
       this.completeSubgraph();
     }
     if (this.errored || this.failed) {
-      this.task.emitOnFailSignals(this.context);
+      this.task.mapOnFailSignals(
+        (signal) => this.emitWithMetadata(signal, this.context)
+      );
     } else {
-      this.task.emitSignals(this.context);
+      this.task.mapSignals(
+        (signal) => this.emitWithMetadata(signal, this.context)
+      );
     }
     this.end();
   }
@@ -801,6 +871,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
@@ -808,6 +879,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 = [];
@@ -831,7 +926,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) {
@@ -845,7 +947,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;
   }
@@ -1022,8 +1125,8 @@ import { v4 as uuid4 } from "uuid";
 var SignalParticipant = class extends SignalEmitter {
   constructor() {
     super(...arguments);
-    this.signalsToEmit = /* @__PURE__ */ new Set();
-    // Use Set to prevent duplicates
+    this.emitsSignals = /* @__PURE__ */ new Set();
+    this.signalsToEmitAfter = /* @__PURE__ */ new Set();
     this.signalsToEmitOnFail = /* @__PURE__ */ new Set();
     this.observedSignals = /* @__PURE__ */ new Set();
   }
@@ -1046,12 +1149,18 @@ var SignalParticipant = class extends SignalEmitter {
    * @param signals The signal names.
    * @returns This for chaining.
    */
-  emits(...signals) {
-    signals.forEach((signal) => this.signalsToEmit.add(signal));
+  emitsAfter(...signals) {
+    signals.forEach((signal) => {
+      this.signalsToEmitAfter.add(signal);
+      this.emitsSignals.add(signal);
+    });
     return this;
   }
   emitsOnFail(...signals) {
-    signals.forEach((signal) => this.signalsToEmitOnFail.add(signal));
+    signals.forEach((signal) => {
+      this.signalsToEmitOnFail.add(signal);
+      this.emitsSignals.add(signal);
+    });
     return this;
   }
   /**
@@ -1086,7 +1195,7 @@ var SignalParticipant = class extends SignalEmitter {
    * @returns This for chaining.
    */
   detachSignals(...signals) {
-    signals.forEach((signal) => this.signalsToEmit.delete(signal));
+    signals.forEach((signal) => this.signalsToEmitAfter.delete(signal));
     return this;
   }
   /**
@@ -1094,16 +1203,22 @@ var SignalParticipant = class extends SignalEmitter {
    * @returns This for chaining.
    */
   detachAllSignals() {
-    this.signalsToEmit.clear();
+    this.signalsToEmitAfter.clear();
     return this;
   }
+  mapSignals(callback) {
+    return Array.from(this.signalsToEmitAfter).map(callback);
+  }
+  mapOnFailSignals(callback) {
+    return Array.from(this.signalsToEmitOnFail).map(callback);
+  }
   /**
    * Emits attached signals.
    * @param context The context for emission.
    * @edge If isMeta (from Task), suppresses further "meta.*" to prevent loops.
    */
   emitSignals(context) {
-    this.signalsToEmit.forEach((signal) => {
+    this.signalsToEmitAfter.forEach((signal) => {
       this.emit(signal, context.getFullContext());
     });
   }
@@ -1222,9 +1337,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;
@@ -1236,6 +1355,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();
@@ -1254,6 +1377,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;
@@ -1446,14 +1573,16 @@ var Task = class extends SignalParticipant {
   /**
    * Executes the task function after optional input validation.
    * @param context - The GraphContext to validate and execute.
+   * @param emit
    * @param progressCallback - Callback for progress updates.
    * @returns TaskResult from the taskFunction or error object on validation failure.
    * @edge If validateInputContext is true, validates context; on failure, emits 'meta.task.validationFailed' with detailed errors.
    * @edge If validateOutputContext is true, validates output; on failure, emits 'meta.task.outputValidationFailed' with detailed errors.
    */
-  execute(context, progressCallback) {
+  execute(context, emit, progressCallback) {
     return this.taskFunction(
       this.isMeta ? context.getClonedFullContext() : context.getClonedContext(),
+      emit,
       progressCallback
     );
   }
@@ -1593,7 +1722,7 @@ var Task = class extends SignalParticipant {
       __isMeta: this.isMeta,
       __isSignal: this.isSignal,
       __eventTriggers: this.observedSignals,
-      __attachedEvents: this.signalsToEmit,
+      __attachedEvents: this.signalsToEmitAfter,
       __isDeputy: this.isDeputy,
       __throttled: this.throttled,
       __isEphemeral: this.isEphemeral,
@@ -1994,6 +2123,7 @@ var DebounceTask = class extends Task {
     this.lastContext = null;
     this.lastTimeout = null;
     this.lastProgressCallback = null;
+    this.lastEmitFunction = null;
     this.debounceTime = debounceTime;
     this.leading = leading;
     this.trailing = trailing;
@@ -2007,6 +2137,7 @@ var DebounceTask = class extends Task {
     try {
       result = this.taskFunction(
         this.lastContext.getClonedContext(),
+        this.lastEmitFunction,
         this.lastProgressCallback
       );
     } catch (error) {
@@ -2023,7 +2154,7 @@ var DebounceTask = class extends Task {
       }
     }
   }
-  debouncedTrigger(resolve, reject, context, timeout, progressCallback) {
+  debouncedTrigger(resolve, reject, context, timeout, emit, progressCallback) {
     const callNow = this.leading && this.timer === null;
     const isNewBurst = this.timer === null;
     if (this.timer !== null) {
@@ -2035,6 +2166,7 @@ var DebounceTask = class extends Task {
     this.lastContext = context;
     this.lastTimeout = timeout;
     this.lastProgressCallback = progressCallback;
+    this.lastEmitFunction = emit;
     if (!callNow) {
       this.hasLaterCall = true;
     }
@@ -2067,7 +2199,7 @@ var DebounceTask = class extends Task {
       }, this.maxWait);
     }
   }
-  execute(context, progressCallback) {
+  execute(context, emit, progressCallback) {
     return new Promise((resolve, reject) => {
       const timeout = setTimeout(() => {
         resolve(false);
@@ -2077,6 +2209,7 @@ var DebounceTask = class extends Task {
         reject,
         context,
         timeout,
+        emit,
         progressCallback
       );
     });
@@ -2085,7 +2218,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,
@@ -2099,15 +2232,18 @@ var EphemeralTask = class extends Task {
       inputSchema,
       validateInputContext,
       outputSchema,
-      validateOutputContext
+      validateOutputContext,
+      retryCount,
+      retryDelay,
+      retryDelayMax,
+      retryDelayFactor
     );
     this.isEphemeral = true;
     this.once = once;
     this.condition = condition;
   }
-  execute(context, progressCallback) {
-    const result = super.execute(context, progressCallback);
-    this.emit("meta.ephemeral.executed", result);
+  execute(context, emit, progressCallback) {
+    const result = super.execute(context, emit, progressCallback);
     if (this.once || !this.condition(result)) {
       this.destroy();
       return result;
@@ -2437,11 +2573,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() {
@@ -2698,7 +2829,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);
@@ -2715,7 +2850,11 @@ var Cadenza = class {
       options.inputSchema,
       options.validateInputContext,
       options.outputSchema,
-      options.validateOutputContext
+      options.validateOutputContext,
+      options.retryCount,
+      options.retryDelay,
+      options.retryDelayMax,
+      options.retryDelayFactor
     );
   }
   /**
@@ -2738,7 +2877,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);
@@ -2763,7 +2906,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);
@@ -2786,7 +2933,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);
@@ -2810,7 +2961,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);
@@ -2833,7 +2988,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(
@@ -2943,7 +3102,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);
@@ -2962,7 +3125,11 @@ var Cadenza = class {
       options.inputSchema,
       options.validateInputContext,
       options.outputSchema,
-      options.validateOutputContext
+      options.validateOutputContext,
+      options.retryCount,
+      options.retryDelay,
+      options.retryDelayMax,
+      options.retryDelayFactor
     );
   }
   /**
@@ -2985,7 +3152,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(
@@ -3041,7 +3212,7 @@ Cadenza.mode = "production";
 var SignalTask = class extends Task {
   constructor(signal, description = "") {
     super(signal, () => true, description);
-    this.signalsToEmit.add(signal);
+    this.signalsToEmitAfter.add(signal);
   }
 };