@cadenza.io/core 1.8.0 → 1.9.1

package/dist/index.d.mts

@@ -119,13 +119,13 @@ declare abstract class SignalEmitter {
      * @param data Optional payload (defaults to empty object).
      * @edge No emission if silent; for metrics in silent mode, consider override or separate method.
      */
-    emit(signal: string, data?: any): void;
+    protected emit(signal: string, data?: AnyObject): void;
     /**
      * Emits a signal via the broker even if silent.
      * @param signal The signal name.
      * @param data Optional payload (defaults to empty object).
      */
-    emitMetric(signal: string, data?: any): void;
+    protected emitMetric(signal: string, data?: AnyObject): void;
 }
 
 declare abstract class ExecutionChain {
@@ -228,6 +228,7 @@ declare class GraphNode extends SignalEmitter implements Graph {
     private workAsync;
     private executeAsync;
     private work;
+    protected emitWithMetadata(signal: string, context: AnyObject): void;
     private onProgress;
     private postProcess;
     private onError;
@@ -315,7 +316,8 @@ declare class TaskIterator implements Iterator {
 }
 
 declare class SignalParticipant extends SignalEmitter {
-    protected signalsToEmit: Set<string>;
+    protected emitsSignals: Set<string>;
+    protected signalsToEmitAfter: Set<string>;
     protected signalsToEmitOnFail: Set<string>;
     protected observedSignals: Set<string>;
     /**
@@ -330,7 +332,7 @@ declare class SignalParticipant extends SignalEmitter {
      * @param signals The signal names.
      * @returns This for chaining.
      */
-    emits(...signals: string[]): this;
+    emitsAfter(...signals: string[]): this;
     emitsOnFail(...signals: string[]): this;
     /**
      * Unsubscribes from all observed signals.
@@ -355,6 +357,8 @@ declare class SignalParticipant extends SignalEmitter {
      * @returns This for chaining.
      */
     detachAllSignals(): this;
+    mapSignals(callback: (signal: string) => void): void[];
+    mapOnFailSignals(callback: (signal: string) => void): void[];
     /**
      * Emits attached signals.
      * @param context The context for emission.
@@ -397,7 +401,7 @@ type SchemaDefinition = {
     strict?: boolean;
 };
 
-type TaskFunction = (context: AnyObject, progressCallback: (progress: number) => void) => TaskResult;
+type TaskFunction = (context: AnyObject, emit: (signal: string, context: AnyObject) => void, progressCallback: (progress: number) => void) => TaskResult;
 type TaskResult = boolean | AnyObject | Generator | Promise<any> | void;
 type ThrottleTagGetter = (context?: AnyObject, task?: Task) => string;
 declare class Task extends SignalParticipant implements Graph {
@@ -475,12 +479,13 @@ declare class Task extends SignalParticipant implements Graph {
     /**
      * 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: GraphContext, progressCallback: (progress: number) => void): TaskResult;
+    execute(context: GraphContext, emit: (signal: string, context: AnyObject) => void, progressCallback: (progress: number) => void): TaskResult;
     doAfter(...tasks: Task[]): this;
     then(...tasks: Task[]): this;
     decouple(task: Task): void;
@@ -723,10 +728,11 @@ declare class DebounceTask extends Task {
     private lastContext;
     private lastTimeout;
     private lastProgressCallback;
+    private lastEmitFunction;
     constructor(name: string, task: TaskFunction, description?: string, debounceTime?: number, leading?: boolean, trailing?: boolean, maxWait?: number, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, inputSchema?: SchemaDefinition | undefined, validateInputSchema?: boolean, outputSchema?: SchemaDefinition | undefined, validateOutputSchema?: boolean);
     private executeFunction;
     private debouncedTrigger;
-    execute(context: GraphContext, progressCallback: (progress: number) => void): TaskResult;
+    execute(context: GraphContext, emit: (signal: string, context: any) => void, progressCallback: (progress: number) => void): TaskResult;
 }
 
 declare class EphemeralTask extends Task {
@@ -734,7 +740,7 @@ declare class EphemeralTask extends Task {
     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, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
-    execute(context: any, progressCallback: (progress: number) => void): TaskResult;
+    execute(context: any, emit: (signal: string, context: AnyObject) => void, progressCallback: (progress: number) => void): TaskResult;
 }
 
 declare class GraphAsyncRun extends GraphRunStrategy {

package/dist/index.d.ts

@@ -119,13 +119,13 @@ declare abstract class SignalEmitter {
      * @param data Optional payload (defaults to empty object).
      * @edge No emission if silent; for metrics in silent mode, consider override or separate method.
      */
-    emit(signal: string, data?: any): void;
+    protected emit(signal: string, data?: AnyObject): void;
     /**
      * Emits a signal via the broker even if silent.
      * @param signal The signal name.
      * @param data Optional payload (defaults to empty object).
      */
-    emitMetric(signal: string, data?: any): void;
+    protected emitMetric(signal: string, data?: AnyObject): void;
 }
 
 declare abstract class ExecutionChain {
@@ -228,6 +228,7 @@ declare class GraphNode extends SignalEmitter implements Graph {
     private workAsync;
     private executeAsync;
     private work;
+    protected emitWithMetadata(signal: string, context: AnyObject): void;
     private onProgress;
     private postProcess;
     private onError;
@@ -315,7 +316,8 @@ declare class TaskIterator implements Iterator {
 }
 
 declare class SignalParticipant extends SignalEmitter {
-    protected signalsToEmit: Set<string>;
+    protected emitsSignals: Set<string>;
+    protected signalsToEmitAfter: Set<string>;
     protected signalsToEmitOnFail: Set<string>;
     protected observedSignals: Set<string>;
     /**
@@ -330,7 +332,7 @@ declare class SignalParticipant extends SignalEmitter {
      * @param signals The signal names.
      * @returns This for chaining.
      */
-    emits(...signals: string[]): this;
+    emitsAfter(...signals: string[]): this;
     emitsOnFail(...signals: string[]): this;
     /**
      * Unsubscribes from all observed signals.
@@ -355,6 +357,8 @@ declare class SignalParticipant extends SignalEmitter {
      * @returns This for chaining.
      */
     detachAllSignals(): this;
+    mapSignals(callback: (signal: string) => void): void[];
+    mapOnFailSignals(callback: (signal: string) => void): void[];
     /**
      * Emits attached signals.
      * @param context The context for emission.
@@ -397,7 +401,7 @@ type SchemaDefinition = {
     strict?: boolean;
 };
 
-type TaskFunction = (context: AnyObject, progressCallback: (progress: number) => void) => TaskResult;
+type TaskFunction = (context: AnyObject, emit: (signal: string, context: AnyObject) => void, progressCallback: (progress: number) => void) => TaskResult;
 type TaskResult = boolean | AnyObject | Generator | Promise<any> | void;
 type ThrottleTagGetter = (context?: AnyObject, task?: Task) => string;
 declare class Task extends SignalParticipant implements Graph {
@@ -475,12 +479,13 @@ declare class Task extends SignalParticipant implements Graph {
     /**
      * 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: GraphContext, progressCallback: (progress: number) => void): TaskResult;
+    execute(context: GraphContext, emit: (signal: string, context: AnyObject) => void, progressCallback: (progress: number) => void): TaskResult;
     doAfter(...tasks: Task[]): this;
     then(...tasks: Task[]): this;
     decouple(task: Task): void;
@@ -723,10 +728,11 @@ declare class DebounceTask extends Task {
     private lastContext;
     private lastTimeout;
     private lastProgressCallback;
+    private lastEmitFunction;
     constructor(name: string, task: TaskFunction, description?: string, debounceTime?: number, leading?: boolean, trailing?: boolean, maxWait?: number, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, inputSchema?: SchemaDefinition | undefined, validateInputSchema?: boolean, outputSchema?: SchemaDefinition | undefined, validateOutputSchema?: boolean);
     private executeFunction;
     private debouncedTrigger;
-    execute(context: GraphContext, progressCallback: (progress: number) => void): TaskResult;
+    execute(context: GraphContext, emit: (signal: string, context: any) => void, progressCallback: (progress: number) => void): TaskResult;
 }
 
 declare class EphemeralTask extends Task {
@@ -734,7 +740,7 @@ declare class EphemeralTask extends Task {
     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, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
-    execute(context: any, progressCallback: (progress: number) => void): TaskResult;
+    execute(context: any, emit: (signal: string, context: AnyObject) => void, progressCallback: (progress: number) => void): TaskResult;
 }
 
 declare class GraphAsyncRun extends GraphRunStrategy {

package/dist/index.js

@@ -745,6 +745,21 @@ var GraphNode = class _GraphNode extends SignalEmitter {
         ...this.lightExport(),
         __scheduled: Date.now()
       });
+      const context = this.context.getFullContext();
+      if (context.__emittedSignal !== void 0 && context.__consumedByNode === void 0 && !context.__emittedSignal.includes("meta.")) {
+        this.emit("meta.node.consumed_signal", {
+          __signal_log: {
+            signal_name: context.__emittedSignal,
+            log_type: "consume",
+            consumed_by_task_id: this.task.id,
+            task_execution_id: this.id,
+            relation_type: "listener",
+            metadata: {},
+            is_meta: false
+          }
+        });
+        context.__consumedByNode = this.id;
+      }
     }
   }
   start() {
@@ -819,6 +834,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
     try {
       const result = this.task.execute(
         this.context,
+        this.emitWithMetadata.bind(this),
         this.onProgress.bind(this)
       );
       if (result.errored || result.failed) {
@@ -836,6 +852,26 @@ var GraphNode = class _GraphNode extends SignalEmitter {
       });
     }
   }
+  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;
     progress = Math.min(Math.max(0, progress), 1);
@@ -860,9 +896,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();
   }
@@ -1124,8 +1164,8 @@ var import_uuid4 = require("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();
   }
@@ -1148,12 +1188,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;
   }
   /**
@@ -1188,7 +1234,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;
   }
   /**
@@ -1196,16 +1242,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());
     });
   }
@@ -1560,14 +1612,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
     );
   }
@@ -1707,7 +1761,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,
@@ -2108,6 +2162,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;
@@ -2121,6 +2176,7 @@ var DebounceTask = class extends Task {
     try {
       result = this.taskFunction(
         this.lastContext.getClonedContext(),
+        this.lastEmitFunction,
         this.lastProgressCallback
       );
     } catch (error) {
@@ -2137,7 +2193,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) {
@@ -2149,6 +2205,7 @@ var DebounceTask = class extends Task {
     this.lastContext = context;
     this.lastTimeout = timeout;
     this.lastProgressCallback = progressCallback;
+    this.lastEmitFunction = emit;
     if (!callNow) {
       this.hasLaterCall = true;
     }
@@ -2181,7 +2238,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);
@@ -2191,6 +2248,7 @@ var DebounceTask = class extends Task {
         reject,
         context,
         timeout,
+        emit,
         progressCallback
       );
     });
@@ -2223,9 +2281,8 @@ var EphemeralTask = class extends Task {
     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;
@@ -3194,7 +3251,7 @@ Cadenza.mode = "production";
 var SignalTask = class extends Task {
   constructor(signal, description = "") {
     super(signal, () => true, description);
-    this.signalsToEmit.add(signal);
+    this.signalsToEmitAfter.add(signal);
   }
 };