@cadenza.io/core 1.11.15 → 1.12.0

package/dist/index.mjs

@@ -896,7 +896,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;
   }
@@ -912,7 +916,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() {
@@ -998,7 +1006,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();
     }
@@ -1055,6 +1076,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) {
@@ -1098,6 +1122,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 = uuid3();
     const newNodes = [];
@@ -3095,26 +3141,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,
@@ -3147,24 +3195,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);
   }
@@ -3178,24 +3209,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);
   }
@@ -3207,25 +3221,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);
   }
   /**
@@ -3238,23 +3236,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);
   }
@@ -3267,23 +3250,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,
@@ -3303,24 +3270,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,
@@ -3351,22 +3320,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,
@@ -3386,28 +3340,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,
@@ -3440,26 +3396,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);
   }