@cadenza.io/core 1.11.15 → 1.12.0

package/dist/index.d.mts

@@ -232,12 +232,15 @@ declare class GraphNode extends SignalEmitter implements Graph {
     emitWithMetadata(signal: string, ctx: AnyObject): void;
     emitMetricsWithMetadata(signal: string, ctx: AnyObject): void;
     onProgress(progress: number): void;
-    postProcess(): void;
+    postProcess(): GraphNode[] | Promise<GraphNode[]>;
+    postProcessAsync(nextNodes: Promise<GraphNode[]>): Promise<GraphNode[]>;
+    finalize(): void;
     onError(error: unknown, errorData?: AnyObject): void;
     retry(prevResult?: any): Promise<TaskResult>;
     retryAsync(prevResult?: any): Promise<TaskResult>;
     delayRetry(): Promise<void>;
-    divide(): GraphNode[];
+    divide(): GraphNode[] | Promise<GraphNode[]>;
+    divideAsync(current: Promise<IteratorResult<any>>): Promise<GraphNode[]>;
     generateNewNodes(result: any): GraphNode[];
     differentiate(task: Task): GraphNode;
     migrate(ctx: any): GraphNode;

package/dist/index.d.ts

@@ -232,12 +232,15 @@ declare class GraphNode extends SignalEmitter implements Graph {
     emitWithMetadata(signal: string, ctx: AnyObject): void;
     emitMetricsWithMetadata(signal: string, ctx: AnyObject): void;
     onProgress(progress: number): void;
-    postProcess(): void;
+    postProcess(): GraphNode[] | Promise<GraphNode[]>;
+    postProcessAsync(nextNodes: Promise<GraphNode[]>): Promise<GraphNode[]>;
+    finalize(): void;
     onError(error: unknown, errorData?: AnyObject): void;
     retry(prevResult?: any): Promise<TaskResult>;
     retryAsync(prevResult?: any): Promise<TaskResult>;
     delayRetry(): Promise<void>;
-    divide(): GraphNode[];
+    divide(): GraphNode[] | Promise<GraphNode[]>;
+    divideAsync(current: Promise<IteratorResult<any>>): Promise<GraphNode[]>;
     generateNewNodes(result: any): GraphNode[];
     differentiate(task: Task): GraphNode;
     migrate(ctx: any): GraphNode;

package/dist/index.js

@@ -934,7 +934,11 @@ var GraphNode = class _GraphNode extends SignalEmitter {
       if (this.result instanceof Promise) {
         return this.executeAsync();
       }
-      this.postProcess();
+      const nextNodes = this.postProcess();
+      if (nextNodes instanceof Promise) {
+        return nextNodes;
+      }
+      this.nextNodes = nextNodes;
     }
     return this.nextNodes;
   }
@@ -950,7 +954,11 @@ var GraphNode = class _GraphNode extends SignalEmitter {
   }
   async executeAsync() {
     await this.workAsync();
-    this.postProcess();
+    const nextNodes = this.postProcess();
+    if (nextNodes instanceof Promise) {
+      return nextNodes;
+    }
+    this.nextNodes = nextNodes;
     return this.nextNodes;
   }
   work() {
@@ -1036,7 +1044,20 @@ var GraphNode = class _GraphNode extends SignalEmitter {
     if (Array.isArray(this.result)) {
       this.onError(`Returning arrays is not allowed. Returned: ${this.result}`);
     }
-    this.nextNodes = this.divide();
+    const nextNodes = this.divide();
+    if (nextNodes instanceof Promise) {
+      return this.postProcessAsync(nextNodes);
+    }
+    this.nextNodes = nextNodes;
+    this.finalize();
+    return this.nextNodes;
+  }
+  async postProcessAsync(nextNodes) {
+    this.nextNodes = await nextNodes;
+    this.finalize();
+    return this.nextNodes;
+  }
+  finalize() {
     if (this.nextNodes.length === 0) {
       this.completeSubgraph();
     }
@@ -1093,6 +1114,9 @@ var GraphNode = class _GraphNode extends SignalEmitter {
     if (((_a = this.result) == null ? void 0 : _a.next) && typeof this.result.next === "function") {
       const generator = this.result;
       let current = generator.next();
+      if (current instanceof Promise) {
+        return this.divideAsync(current);
+      }
       while (!current.done && current.value !== void 0) {
         const outputValidation = this.task.validateOutput(current.value);
         if (outputValidation !== true) {
@@ -1136,6 +1160,28 @@ var GraphNode = class _GraphNode extends SignalEmitter {
     });
     return newNodes;
   }
+  async divideAsync(current) {
+    const nextNodes = [];
+    const _current = await current;
+    const outputValidation = this.task.validateOutput(_current.value);
+    if (outputValidation !== true) {
+      this.onError(outputValidation.__validationErrors);
+      return nextNodes;
+    } else {
+      nextNodes.push(...this.generateNewNodes(_current.value));
+    }
+    for await (const result of this.result) {
+      const outputValidation2 = this.task.validateOutput(result);
+      if (outputValidation2 !== true) {
+        this.onError(outputValidation2.__validationErrors);
+        return [];
+      } else {
+        nextNodes.push(...this.generateNewNodes(result));
+      }
+    }
+    this.divided = true;
+    return nextNodes;
+  }
   generateNewNodes(result) {
     const groupId = (0, import_uuid3.v4)();
     const newNodes = [];
@@ -3133,26 +3179,28 @@ var Cadenza = class {
    * @returns The created Task instance.
    * @throws Error if name is invalid or duplicate in registry.
    */
-  static createTask(name, func, description, options = {
-    concurrency: 0,
-    timeout: 0,
-    register: true,
-    isUnique: false,
-    isMeta: false,
-    isSubMeta: false,
-    isHidden: false,
-    getTagCallback: void 0,
-    inputSchema: void 0,
-    validateInputContext: false,
-    outputSchema: void 0,
-    validateOutputContext: false,
-    retryCount: 0,
-    retryDelay: 0,
-    retryDelayMax: 0,
-    retryDelayFactor: 1
-  }) {
+  static createTask(name, func, description, options = {}) {
     this.bootstrap();
     this.validateName(name);
+    options = {
+      concurrency: 0,
+      timeout: 0,
+      register: true,
+      isUnique: false,
+      isMeta: false,
+      isSubMeta: false,
+      isHidden: false,
+      getTagCallback: void 0,
+      inputSchema: void 0,
+      validateInputContext: false,
+      outputSchema: void 0,
+      validateOutputContext: false,
+      retryCount: 0,
+      retryDelay: 0,
+      retryDelayMax: 0,
+      retryDelayFactor: 1,
+      ...options
+    };
     return new Task(
       name,
       func,
@@ -3185,24 +3233,7 @@ var Cadenza = class {
    * @returns The created MetaTask instance.
    * @throws Error if name invalid or duplicate.
    */
-  static createMetaTask(name, func, description, options = {
-    concurrency: 0,
-    timeout: 0,
-    register: true,
-    isUnique: false,
-    isMeta: true,
-    isSubMeta: false,
-    isHidden: false,
-    getTagCallback: void 0,
-    inputSchema: void 0,
-    validateInputContext: false,
-    outputSchema: void 0,
-    validateOutputContext: false,
-    retryCount: 0,
-    retryDelay: 0,
-    retryDelayMax: 0,
-    retryDelayFactor: 1
-  }) {
+  static createMetaTask(name, func, description, options = {}) {
     options.isMeta = true;
     return this.createTask(name, func, description, options);
   }
@@ -3216,24 +3247,7 @@ var Cadenza = class {
    * @returns The created UniqueTask.
    * @throws Error if invalid.
    */
-  static createUniqueTask(name, func, description, options = {
-    concurrency: 0,
-    timeout: 0,
-    register: true,
-    isUnique: true,
-    isMeta: false,
-    isSubMeta: false,
-    isHidden: false,
-    getTagCallback: void 0,
-    inputSchema: void 0,
-    validateInputContext: false,
-    outputSchema: void 0,
-    validateOutputContext: false,
-    retryCount: 0,
-    retryDelay: 0,
-    retryDelayMax: 0,
-    retryDelayFactor: 1
-  }) {
+  static createUniqueTask(name, func, description, options = {}) {
     options.isUnique = true;
     return this.createTask(name, func, description, options);
   }
@@ -3245,25 +3259,9 @@ var Cadenza = class {
    * @param options Optional task options.
    * @returns The created UniqueMetaTask.
    */
-  static createUniqueMetaTask(name, func, description, options = {
-    concurrency: 0,
-    timeout: 0,
-    register: true,
-    isUnique: true,
-    isMeta: true,
-    isSubMeta: false,
-    isHidden: false,
-    getTagCallback: void 0,
-    inputSchema: void 0,
-    validateInputContext: false,
-    outputSchema: void 0,
-    validateOutputContext: false,
-    retryCount: 0,
-    retryDelay: 0,
-    retryDelayMax: 0,
-    retryDelayFactor: 1
-  }) {
+  static createUniqueMetaTask(name, func, description, options = {}) {
     options.isMeta = true;
+    options.isUnique = true;
     return this.createUniqueTask(name, func, description, options);
   }
   /**
@@ -3276,23 +3274,8 @@ var Cadenza = class {
    * @returns The created ThrottledTask.
    * @edge If no getter, throttles per task ID; use for resource protection.
    */
-  static createThrottledTask(name, func, throttledIdGetter = () => "default", description, options = {
-    concurrency: 1,
-    timeout: 0,
-    register: true,
-    isUnique: false,
-    isMeta: false,
-    isSubMeta: false,
-    isHidden: false,
-    inputSchema: void 0,
-    validateInputContext: false,
-    outputSchema: void 0,
-    validateOutputContext: false,
-    retryCount: 0,
-    retryDelay: 0,
-    retryDelayMax: 0,
-    retryDelayFactor: 1
-  }) {
+  static createThrottledTask(name, func, throttledIdGetter = () => "default", description, options = {}) {
+    options.concurrency = 1;
     options.getTagCallback = throttledIdGetter;
     return this.createTask(name, func, description, options);
   }
@@ -3305,23 +3288,7 @@ var Cadenza = class {
    * @param options Optional task options.
    * @returns The created ThrottledMetaTask.
    */
-  static createThrottledMetaTask(name, func, throttledIdGetter, description, options = {
-    concurrency: 0,
-    timeout: 0,
-    register: true,
-    isUnique: false,
-    isMeta: true,
-    isSubMeta: false,
-    isHidden: false,
-    inputSchema: void 0,
-    validateInputContext: false,
-    outputSchema: void 0,
-    validateOutputContext: false,
-    retryCount: 0,
-    retryDelay: 0,
-    retryDelayMax: 0,
-    retryDelayFactor: 1
-  }) {
+  static createThrottledMetaTask(name, func, throttledIdGetter, description, options = {}) {
     options.isMeta = true;
     return this.createThrottledTask(
       name,
@@ -3341,24 +3308,26 @@ var Cadenza = class {
    * @returns The created DebounceTask.
    * @edge Multiple triggers within time collapse to one exec.
    */
-  static createDebounceTask(name, func, description, debounceTime = 1e3, options = {
-    concurrency: 0,
-    timeout: 0,
-    register: true,
-    leading: false,
-    trailing: true,
-    maxWait: 0,
-    isUnique: false,
-    isMeta: false,
-    isSubMeta: false,
-    isHidden: false,
-    inputSchema: void 0,
-    validateInputContext: false,
-    outputSchema: void 0,
-    validateOutputContext: false
-  }) {
+  static createDebounceTask(name, func, description, debounceTime = 1e3, options = {}) {
     this.bootstrap();
     this.validateName(name);
+    options = {
+      concurrency: 0,
+      timeout: 0,
+      register: true,
+      leading: false,
+      trailing: true,
+      maxWait: 0,
+      isUnique: false,
+      isMeta: false,
+      isSubMeta: false,
+      isHidden: false,
+      inputSchema: void 0,
+      validateInputContext: false,
+      outputSchema: void 0,
+      validateOutputContext: false,
+      ...options
+    };
     return new DebounceTask(
       name,
       func,
@@ -3389,22 +3358,7 @@ var Cadenza = class {
    * @param options Optional task options plus optional debounce config (e.g., leading/trailing).
    * @returns The created DebouncedMetaTask.
    */
-  static createDebounceMetaTask(name, func, description, debounceTime = 1e3, options = {
-    concurrency: 0,
-    timeout: 0,
-    register: true,
-    leading: false,
-    trailing: true,
-    maxWait: 0,
-    isUnique: false,
-    isMeta: false,
-    isSubMeta: false,
-    isHidden: false,
-    inputSchema: void 0,
-    validateInputContext: false,
-    outputSchema: void 0,
-    validateOutputContext: false
-  }) {
+  static createDebounceMetaTask(name, func, description, debounceTime = 1e3, options = {}) {
     options.isMeta = true;
     return this.createDebounceTask(
       name,
@@ -3424,28 +3378,30 @@ var Cadenza = class {
    * @returns The created EphemeralTask.
    * @edge Destruction triggered post-exec via Node/Builder; emits meta-signal for cleanup.
    */
-  static createEphemeralTask(name, func, description, options = {
-    concurrency: 0,
-    timeout: 0,
-    register: true,
-    isUnique: false,
-    isMeta: false,
-    isSubMeta: false,
-    isHidden: false,
-    once: true,
-    destroyCondition: () => true,
-    getTagCallback: void 0,
-    inputSchema: void 0,
-    validateInputContext: false,
-    outputSchema: void 0,
-    validateOutputContext: false,
-    retryCount: 0,
-    retryDelay: 0,
-    retryDelayMax: 0,
-    retryDelayFactor: 1
-  }) {
+  static createEphemeralTask(name, func, description, options = {}) {
     this.bootstrap();
     this.validateName(name);
+    options = {
+      concurrency: 0,
+      timeout: 0,
+      register: true,
+      isUnique: false,
+      isMeta: false,
+      isSubMeta: false,
+      isHidden: false,
+      once: true,
+      destroyCondition: () => true,
+      getTagCallback: void 0,
+      inputSchema: void 0,
+      validateInputContext: false,
+      outputSchema: void 0,
+      validateOutputContext: false,
+      retryCount: 0,
+      retryDelay: 0,
+      retryDelayMax: 0,
+      retryDelayFactor: 1,
+      ...options
+    };
     return new EphemeralTask(
       name,
       func,
@@ -3478,26 +3434,7 @@ var Cadenza = class {
    * @param options Optional task options plus optional "once" (true) and "destroyCondition" (ctx => boolean).
    * @returns The created EphemeralMetaTask.
    */
-  static createEphemeralMetaTask(name, func, description, options = {
-    concurrency: 0,
-    timeout: 0,
-    register: true,
-    isUnique: false,
-    isMeta: true,
-    isSubMeta: false,
-    isHidden: false,
-    once: true,
-    destroyCondition: () => true,
-    getTagCallback: void 0,
-    inputSchema: void 0,
-    validateInputContext: false,
-    outputSchema: void 0,
-    validateOutputContext: false,
-    retryCount: 0,
-    retryDelay: 0,
-    retryDelayMax: 0,
-    retryDelayFactor: 1
-  }) {
+  static createEphemeralMetaTask(name, func, description, options = {}) {
     options.isMeta = true;
     return this.createEphemeralTask(name, func, description, options);
   }