@cadenza.io/core 3.16.3 → 3.17.0

package/dist/index.mjs

@@ -1225,6 +1225,11 @@ var merge = createAssigner_default(function(object, source, srcIndex) {
 });
 var merge_default = merge;
 
+// src/utils/promise.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
 // src/engine/SignalBroker.ts
 var SignalBroker = class _SignalBroker {
   constructor() {
@@ -1233,6 +1238,8 @@ var SignalBroker = class _SignalBroker {
     this.debouncedEmitters = /* @__PURE__ */ new Map();
     this.squashedEmitters = /* @__PURE__ */ new Map();
     this.squashedContexts = /* @__PURE__ */ new Map();
+    this.throttleEmitters = /* @__PURE__ */ new Map();
+    this.throttleQueues = /* @__PURE__ */ new Map();
     // TODO: Signals should be a class with a the observers, registered flag and other data.
     this.signalObservers = /* @__PURE__ */ new Map();
     this.emittedSignalsRegistry = /* @__PURE__ */ new Set();
@@ -1433,6 +1440,35 @@ var SignalBroker = class _SignalBroker {
     }
     debouncedEmitter(context);
   }
+  throttle(signal, context, options = { delayMs: 1e3 }) {
+    let { groupId, delayMs = 300 } = options;
+    if (!groupId) {
+      groupId = signal;
+    }
+    if (!this.throttleQueues.has(groupId)) {
+      this.throttleQueues.set(groupId, []);
+    }
+    const queue = this.throttleQueues.get(groupId);
+    queue.push([signal, context]);
+    if (!this.throttleEmitters.has(groupId)) {
+      this.throttleEmitters.set(groupId, async () => {
+        while (queue.length > 0) {
+          let batchSize = options.throttleBatch ?? 1;
+          if (batchSize > queue.length) {
+            batchSize = queue.length;
+          }
+          for (let i = 0; i < batchSize; i++) {
+            const [nextSignal, nextContext] = queue.shift();
+            this.emit(nextSignal, nextContext);
+          }
+          await sleep(delayMs);
+        }
+        this.throttleEmitters.delete(groupId);
+        this.throttleQueues.delete(groupId);
+      });
+      this.throttleEmitters.get(groupId)();
+    }
+  }
   /**
    * Aggregates and debounces multiple events with the same identifier to minimize redundant operations.
    *
@@ -1445,7 +1481,7 @@ var SignalBroker = class _SignalBroker {
    * @return {void} Does not return a value.
    */
   squash(signal, context, options = { squash: true }) {
-    let { squashId, delayMs = 500 } = options;
+    let { squashId, delayMs = 300 } = options;
     if (!squashId) {
       squashId = signal;
     }
@@ -1453,10 +1489,11 @@ var SignalBroker = class _SignalBroker {
       this.squashedEmitters.set(
         squashId,
         debounce_default(() => {
-          this.emit(signal, this.squashedContexts.get(squashId));
+          options.squash = false;
+          this.emit(signal, this.squashedContexts.get(squashId), options);
           this.squashedEmitters.delete(squashId);
           this.squashedContexts.delete(squashId);
-        }, delayMs ?? 500)
+        }, delayMs ?? 300)
       );
       this.squashedContexts.set(squashId, context);
     } else {
@@ -2041,7 +2078,7 @@ var SignalEmitter = class {
    * @param options
    */
   emit(signal, data = {}, options = {}) {
-    Cadenza.broker.emit(signal, data);
+    Cadenza.broker.emit(signal, data, options);
   }
   /**
    * Emits a signal via the broker if not silent.
@@ -2053,15 +2090,10 @@ var SignalEmitter = class {
     if (this.silent) {
       return;
     }
-    Cadenza.broker.emit(signal, data);
+    Cadenza.broker.emit(signal, data, options);
   }
 };
 
-// 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, verbose = false) {
@@ -2305,7 +2337,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
           },
           filter: { uuid: this.routineExecId }
         },
-        { squash: true, squashId: this.routineExecId }
+        { squash: true, squashId: this.routineExecId, delayMs: 200 }
       );
     }
     if (this.debug && !this.task.isSubMeta && !this.context.getMetadata().__isSubMeta || this.verbose) {
@@ -2366,7 +2398,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
         },
         filter: { uuid: this.id }
       },
-      { squash: true, squashId: this.id }
+      { squash: true, squashId: this.id, delayMs: 0 }
     );
     if (this.graphDone()) {
       const context2 = this.context.getFullContext();
@@ -2388,7 +2420,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
           },
           filter: { uuid: this.routineExecId }
         },
-        { squash: true, squashId: this.routineExecId }
+        { squash: true, squashId: this.routineExecId, delayMs: 0 }
       );
     }
     return end;
@@ -3269,7 +3301,7 @@ var GraphRunner = class extends SignalEmitter {
             __executionTraceId: executionTraceId
           }
         },
-        { squash: true, squashId: routineExecId }
+        { squash: true, squashId: routineExecId, delayMs: 200 }
       );
     }
     allTasks.forEach(
@@ -3444,6 +3476,7 @@ var Task = class _Task extends SignalEmitter {
     this.signalsToEmitAfter = /* @__PURE__ */ new Set();
     this.signalsToEmitOnFail = /* @__PURE__ */ new Set();
     this.observedSignals = /* @__PURE__ */ new Set();
+    this.intents = /* @__PURE__ */ new Set();
     this.name = name;
     this.taskFunction = task;
     this.description = description;
@@ -3520,6 +3553,9 @@ var Task = class _Task extends SignalEmitter {
             signalsToEmitAfter: Array.from(this.signalsToEmitAfter),
             signalsToEmitOnFail: Array.from(this.signalsToEmitOnFail),
             observed: Array.from(this.observedSignals)
+          },
+          intents: {
+            handles: Array.from(this.intents)
           }
         },
         taskInstance: this,
@@ -4174,6 +4210,10 @@ var Task = class _Task extends SignalEmitter {
     this.signalsToEmitAfter.clear();
     return this;
   }
+  handlesIntent(intent) {
+    this.intents.add(intent);
+    return this;
+  }
   /**
    * Maps over the signals in the `signalsToEmitAfter` set and applies a callback function to each signal.
    *