@cadenza.io/core 1.10.0 → 1.11.0

package/dist/index.d.mts

@@ -163,6 +163,7 @@ declare abstract class GraphLayer extends ExecutionChain implements Graph {
     get hasPreceding(): boolean;
     getNumberOfNodes(): number;
     getNodesByRoutineExecId(routineExecId: string): GraphNode[];
+    getIdenticalNodes(node: GraphNode): GraphNode[];
     isProcessed(): boolean;
     graphDone(): boolean;
     setNext(next: GraphLayer): void;
@@ -411,11 +412,14 @@ declare class Task extends SignalParticipant implements Graph {
     concurrency: number;
     timeout: number;
     readonly isMeta: boolean;
+    readonly isSubMeta: boolean;
+    readonly isHidden: boolean;
     readonly isUnique: boolean;
     readonly throttled: boolean;
     readonly isSignal: boolean;
     readonly isDeputy: boolean;
     readonly isEphemeral: boolean;
+    readonly isDebounce: boolean;
     protected inputContextSchema: SchemaDefinition | undefined;
     protected validateInputContext: boolean;
     protected outputContextSchema: SchemaDefinition | undefined;
@@ -441,6 +445,8 @@ declare class Task extends SignalParticipant implements Graph {
      * @param register Register via signal (default true).
      * @param isUnique
      * @param isMeta
+     * @param isSubMeta
+     * @param isHidden
      * @param getTagCallback
      * @param inputSchema
      * @param validateInputContext
@@ -452,7 +458,7 @@ declare class Task extends SignalParticipant implements Graph {
      * @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, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
+    constructor(name: string, task: TaskFunction, description?: string, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, isSubMeta?: boolean, isHidden?: 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;
@@ -729,17 +735,21 @@ declare class DebounceTask extends Task {
     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);
+    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, isSubMeta?: boolean, isHidden?: boolean, inputSchema?: SchemaDefinition | undefined, validateInputSchema?: boolean, outputSchema?: SchemaDefinition | undefined, validateOutputSchema?: boolean);
     private executeFunction;
     private debouncedTrigger;
     execute(context: GraphContext, emit: (signal: string, context: any) => void, progressCallback: (progress: number) => void): TaskResult;
 }
 
+type EphemeralTaskOptions = {
+    once?: boolean;
+    destroyCondition?: (context: any) => boolean;
+};
 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, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
+    constructor(name: string, task: TaskFunction, description?: string, once?: boolean, condition?: (context: any) => boolean, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, isSubMeta?: boolean, isHidden?: 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;
 }
 
@@ -761,6 +771,8 @@ interface TaskOptions {
     register?: boolean;
     isUnique?: boolean;
     isMeta?: boolean;
+    isSubMeta?: boolean;
+    isHidden?: boolean;
     getTagCallback?: ThrottleTagGetter;
     inputSchema?: SchemaDefinition;
     validateInputContext?: boolean;
@@ -880,24 +892,20 @@ declare class Cadenza {
      * @param name Identifier (may not be unique if not registered).
      * @param func Function.
      * @param description Optional.
-     * @param once Destroy after first exec (default true).
-     * @param destroyCondition Predicate for destruction (default always true).
-     * @param options Optional task options.
+     * @param options Optional task options plus optional "once" (true) and "destroyCondition" (ctx => boolean).
      * @returns The created EphemeralTask.
      * @edge Destruction triggered post-exec via Node/Builder; emits meta-signal for cleanup.
      */
-    static createEphemeralTask(name: string, func: TaskFunction, description?: string, once?: boolean, destroyCondition?: (context: any) => boolean, options?: TaskOptions): EphemeralTask;
+    static createEphemeralTask(name: string, func: TaskFunction, description?: string, options?: TaskOptions & EphemeralTaskOptions): EphemeralTask;
     /**
      * Creates an EphemeralMetaTask for meta-layer transients.
      * @param name Identifier.
      * @param func Function.
      * @param description Optional.
-     * @param once Destroy after first (default true).
-     * @param destroyCondition Destruction predicate.
-     * @param options Optional task options.
+     * @param options Optional task options plus optional "once" (true) and "destroyCondition" (ctx => boolean).
      * @returns The created EphemeralMetaTask.
      */
-    static createEphemeralMetaTask(name: string, func: TaskFunction, description?: string, once?: boolean, destroyCondition?: (context: any) => boolean, options?: TaskOptions): EphemeralTask;
+    static createEphemeralMetaTask(name: string, func: TaskFunction, description?: string, options?: TaskOptions & EphemeralTaskOptions): EphemeralTask;
     /**
      * Creates a GraphRoutine (named entry to starting tasks) and registers it.
      * @param name Unique identifier.
@@ -922,4 +930,4 @@ declare class SignalTask extends Task {
     constructor(signal: string, description?: string);
 }
 
-export { type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, EphemeralTask, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, type SchemaConstraints, type SchemaDefinition, type SchemaType, SignalBroker, SignalEmitter, SignalParticipant, SignalTask, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default };
+export { type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, type SchemaConstraints, type SchemaDefinition, type SchemaType, SignalBroker, SignalEmitter, SignalParticipant, SignalTask, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default };

package/dist/index.d.ts

@@ -163,6 +163,7 @@ declare abstract class GraphLayer extends ExecutionChain implements Graph {
     get hasPreceding(): boolean;
     getNumberOfNodes(): number;
     getNodesByRoutineExecId(routineExecId: string): GraphNode[];
+    getIdenticalNodes(node: GraphNode): GraphNode[];
     isProcessed(): boolean;
     graphDone(): boolean;
     setNext(next: GraphLayer): void;
@@ -411,11 +412,14 @@ declare class Task extends SignalParticipant implements Graph {
     concurrency: number;
     timeout: number;
     readonly isMeta: boolean;
+    readonly isSubMeta: boolean;
+    readonly isHidden: boolean;
     readonly isUnique: boolean;
     readonly throttled: boolean;
     readonly isSignal: boolean;
     readonly isDeputy: boolean;
     readonly isEphemeral: boolean;
+    readonly isDebounce: boolean;
     protected inputContextSchema: SchemaDefinition | undefined;
     protected validateInputContext: boolean;
     protected outputContextSchema: SchemaDefinition | undefined;
@@ -441,6 +445,8 @@ declare class Task extends SignalParticipant implements Graph {
      * @param register Register via signal (default true).
      * @param isUnique
      * @param isMeta
+     * @param isSubMeta
+     * @param isHidden
      * @param getTagCallback
      * @param inputSchema
      * @param validateInputContext
@@ -452,7 +458,7 @@ declare class Task extends SignalParticipant implements Graph {
      * @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, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
+    constructor(name: string, task: TaskFunction, description?: string, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, isSubMeta?: boolean, isHidden?: 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;
@@ -729,17 +735,21 @@ declare class DebounceTask extends Task {
     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);
+    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, isSubMeta?: boolean, isHidden?: boolean, inputSchema?: SchemaDefinition | undefined, validateInputSchema?: boolean, outputSchema?: SchemaDefinition | undefined, validateOutputSchema?: boolean);
     private executeFunction;
     private debouncedTrigger;
     execute(context: GraphContext, emit: (signal: string, context: any) => void, progressCallback: (progress: number) => void): TaskResult;
 }
 
+type EphemeralTaskOptions = {
+    once?: boolean;
+    destroyCondition?: (context: any) => boolean;
+};
 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, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
+    constructor(name: string, task: TaskFunction, description?: string, once?: boolean, condition?: (context: any) => boolean, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, isSubMeta?: boolean, isHidden?: 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;
 }
 
@@ -761,6 +771,8 @@ interface TaskOptions {
     register?: boolean;
     isUnique?: boolean;
     isMeta?: boolean;
+    isSubMeta?: boolean;
+    isHidden?: boolean;
     getTagCallback?: ThrottleTagGetter;
     inputSchema?: SchemaDefinition;
     validateInputContext?: boolean;
@@ -880,24 +892,20 @@ declare class Cadenza {
      * @param name Identifier (may not be unique if not registered).
      * @param func Function.
      * @param description Optional.
-     * @param once Destroy after first exec (default true).
-     * @param destroyCondition Predicate for destruction (default always true).
-     * @param options Optional task options.
+     * @param options Optional task options plus optional "once" (true) and "destroyCondition" (ctx => boolean).
      * @returns The created EphemeralTask.
      * @edge Destruction triggered post-exec via Node/Builder; emits meta-signal for cleanup.
      */
-    static createEphemeralTask(name: string, func: TaskFunction, description?: string, once?: boolean, destroyCondition?: (context: any) => boolean, options?: TaskOptions): EphemeralTask;
+    static createEphemeralTask(name: string, func: TaskFunction, description?: string, options?: TaskOptions & EphemeralTaskOptions): EphemeralTask;
     /**
      * Creates an EphemeralMetaTask for meta-layer transients.
      * @param name Identifier.
      * @param func Function.
      * @param description Optional.
-     * @param once Destroy after first (default true).
-     * @param destroyCondition Destruction predicate.
-     * @param options Optional task options.
+     * @param options Optional task options plus optional "once" (true) and "destroyCondition" (ctx => boolean).
      * @returns The created EphemeralMetaTask.
      */
-    static createEphemeralMetaTask(name: string, func: TaskFunction, description?: string, once?: boolean, destroyCondition?: (context: any) => boolean, options?: TaskOptions): EphemeralTask;
+    static createEphemeralMetaTask(name: string, func: TaskFunction, description?: string, options?: TaskOptions & EphemeralTaskOptions): EphemeralTask;
     /**
      * Creates a GraphRoutine (named entry to starting tasks) and registers it.
      * @param name Unique identifier.
@@ -922,4 +930,4 @@ declare class SignalTask extends Task {
     constructor(signal: string, description?: string);
 }
 
-export { type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, EphemeralTask, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, type SchemaConstraints, type SchemaDefinition, type SchemaType, SignalBroker, SignalEmitter, SignalParticipant, SignalTask, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default };
+export { type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, type SchemaConstraints, type SchemaDefinition, type SchemaType, SignalBroker, SignalEmitter, SignalParticipant, SignalTask, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default };