@cadenza.io/core 1.7.11 → 1.9.0

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 {
@@ -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,16 @@ declare class GraphNode extends SignalEmitter implements Graph {
     start(): number;
     end(): number;
     execute(): GraphNode[] | Promise<GraphNode[]>;
-    private processAsync;
+    private workAsync;
+    private executeAsync;
     private work;
+    protected emitWithMetadata(signal: string, context: AnyObject): void;
     private onProgress;
     private postProcess;
     private onError;
+    private retry;
+    private retryAsync;
+    private delayRetry;
     private divide;
     private generateNewNodes;
     private differentiate;
@@ -248,7 +256,7 @@ declare class GraphNode extends SignalEmitter implements Graph {
             __id: string;
             __context: AnyObject;
         };
-        __result: unknown;
+        __result: TaskResult;
         __executionTime: number;
         __executionStart: number;
         __executionEnd: number;
@@ -308,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>;
     /**
@@ -323,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.
@@ -348,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.
@@ -390,8 +401,8 @@ type SchemaDefinition = {
     strict?: boolean;
 };
 
-type TaskFunction = (context: AnyObject, progressCallback: (progress: number) => void) => TaskResult;
-type TaskResult = boolean | object | Generator | Promise<any> | void;
+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 {
     id: string;
@@ -409,6 +420,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 +446,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;
@@ -460,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;
@@ -708,18 +728,19 @@ 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 {
     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);
-    execute(context: any, progressCallback: (progress: number) => void): TaskResult;
+    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, emit: (signal: string, context: AnyObject) => void, progressCallback: (progress: number) => void): TaskResult;
 }
 
 declare class GraphAsyncRun extends GraphRunStrategy {
@@ -745,6 +766,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

@@ -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 {
@@ -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,16 @@ declare class GraphNode extends SignalEmitter implements Graph {
     start(): number;
     end(): number;
     execute(): GraphNode[] | Promise<GraphNode[]>;
-    private processAsync;
+    private workAsync;
+    private executeAsync;
     private work;
+    protected emitWithMetadata(signal: string, context: AnyObject): void;
     private onProgress;
     private postProcess;
     private onError;
+    private retry;
+    private retryAsync;
+    private delayRetry;
     private divide;
     private generateNewNodes;
     private differentiate;
@@ -248,7 +256,7 @@ declare class GraphNode extends SignalEmitter implements Graph {
             __id: string;
             __context: AnyObject;
         };
-        __result: unknown;
+        __result: TaskResult;
         __executionTime: number;
         __executionStart: number;
         __executionEnd: number;
@@ -308,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>;
     /**
@@ -323,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.
@@ -348,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.
@@ -390,8 +401,8 @@ type SchemaDefinition = {
     strict?: boolean;
 };
 
-type TaskFunction = (context: AnyObject, progressCallback: (progress: number) => void) => TaskResult;
-type TaskResult = boolean | object | Generator | Promise<any> | void;
+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 {
     id: string;
@@ -409,6 +420,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 +446,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;
@@ -460,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;
@@ -708,18 +728,19 @@ 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 {
     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);
-    execute(context: any, progressCallback: (progress: number) => void): TaskResult;
+    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, emit: (signal: string, context: AnyObject) => void, progressCallback: (progress: number) => void): TaskResult;
 }
 
 declare class GraphAsyncRun extends GraphRunStrategy {
@@ -745,6 +766,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 {