@cadenza.io/core 1.10.1 → 1.11.1

package/dist/index.mjs

@@ -1,3 +1,38 @@
+// src/utils/tools.ts
+function deepCloneFilter(input, filterOut = () => false) {
+  if (input === null || typeof input !== "object") {
+    return input;
+  }
+  const visited = /* @__PURE__ */ new WeakMap();
+  const stack = [];
+  const output = Array.isArray(input) ? [] : {};
+  stack.push({ source: input, target: output });
+  visited.set(input, output);
+  while (stack.length) {
+    const { source, target, key } = stack.pop();
+    const currentTarget = key !== void 0 ? target[key] : target;
+    for (const [k, value] of Object.entries(source)) {
+      if (filterOut(k)) continue;
+      if (value && typeof value === "object") {
+        if (visited.has(value)) {
+          currentTarget[k] = visited.get(value);
+          continue;
+        }
+        const clonedValue = Array.isArray(value) ? [] : {};
+        currentTarget[k] = clonedValue;
+        visited.set(value, clonedValue);
+        stack.push({ source: value, target: currentTarget, key: k });
+      } else {
+        currentTarget[k] = value;
+      }
+    }
+  }
+  return output;
+}
+function formatTimestamp(timestamp) {
+  return new Date(timestamp).toISOString();
+}
+
 // src/engine/SignalBroker.ts
 var SignalBroker = class _SignalBroker {
   // execId -> emitted signals
@@ -64,8 +99,11 @@ var SignalBroker = class _SignalBroker {
       },
       "Executes queued signals and clears the stack",
       500,
-      { maxWait: 1e4 }
-    ).doOn("meta.process_signal_queue_requested");
+      {
+        maxWait: 1e4,
+        leading: true
+      }
+    ).doOn("meta.process_signal_queue_requested").emitsAfter("meta.signal_broker.queue_empty");
     this.getSignalsTask = Cadenza.createMetaTask("Get signals", (ctx) => {
       return {
         __signals: Array.from(this.signalObservers.keys()),
@@ -107,6 +145,7 @@ var SignalBroker = class _SignalBroker {
    */
   emit(signal, context = {}) {
     const execId = context.__routineExecId || "global";
+    delete context.__routineExecId;
     if (!this.emitStacks.has(execId)) this.emitStacks.set(execId, /* @__PURE__ */ new Map());
     const stack = this.emitStacks.get(execId);
     stack.set(signal, context);
@@ -119,30 +158,36 @@ var SignalBroker = class _SignalBroker {
     }
   }
   execute(signal, context) {
-    const isMeta = signal.startsWith("meta");
-    const emittedAt = Date.now();
-    const data = {
-      ...context,
-      __signalEmission: {
+    const isMeta = signal.startsWith("meta.");
+    const isSubMeta = signal.startsWith("sub_meta.");
+    if (!isSubMeta && (!isMeta || this.debug)) {
+      const emittedAt = Date.now();
+      context.__signalEmission = {
         ...context.__signalEmission,
         signalName: signal,
-        emittedAt,
+        emittedAt: formatTimestamp(emittedAt),
         isMeta
-      }
-    };
-    let executed;
-    executed = this.executeListener(signal, data);
-    const parts = signal.slice(0, Math.max(signal.lastIndexOf(":"), signal.lastIndexOf("."))).split(".");
-    for (let i = parts.length; i > 0; i--) {
-      const parent = parts.slice(0, i).join(".");
-      executed = executed || this.executeListener(parent + ".*", data);
+      };
+    } else if (isSubMeta) {
+      context.__isSubMeta = true;
+      delete context.__signalEmission;
+    } else {
+      delete context.__signalEmission;
     }
     if (this.debug) {
       console.log(
-        `Emitted signal ${signal} with context ${JSON.stringify(data)}`,
-        executed ? "\u2705" : "\u274C"
+        `Emitting signal ${signal} with context ${JSON.stringify(context)}`
       );
     }
+    let executed;
+    executed = this.executeListener(signal, context);
+    if (!isSubMeta) {
+      const parts = signal.slice(0, Math.max(signal.lastIndexOf(":"), signal.lastIndexOf("."))).split(".");
+      for (let i = parts.length; i > 0; i--) {
+        const parent = parts.slice(0, i).join(".");
+        executed = executed || this.executeListener(parent + ".*", context);
+      }
+    }
     return executed;
   }
   executeListener(signal, context) {
@@ -448,40 +493,6 @@ import { v4 as uuid3 } from "uuid";
 
 // src/graph/context/GraphContext.ts
 import { v4 as uuid2 } from "uuid";
-
-// src/utils/tools.ts
-function deepCloneFilter(input, filterOut = () => false) {
-  if (input === null || typeof input !== "object") {
-    return input;
-  }
-  const visited = /* @__PURE__ */ new WeakMap();
-  const stack = [];
-  const output = Array.isArray(input) ? [] : {};
-  stack.push({ source: input, target: output });
-  visited.set(input, output);
-  while (stack.length) {
-    const { source, target, key } = stack.pop();
-    const currentTarget = key !== void 0 ? target[key] : target;
-    for (const [k, value] of Object.entries(source)) {
-      if (filterOut(k)) continue;
-      if (value && typeof value === "object") {
-        if (visited.has(value)) {
-          currentTarget[k] = visited.get(value);
-          continue;
-        }
-        const clonedValue = Array.isArray(value) ? [] : {};
-        currentTarget[k] = clonedValue;
-        visited.set(value, clonedValue);
-        stack.push({ source: value, target: currentTarget, key: k });
-      } else {
-        currentTarget[k] = value;
-      }
-    }
-  }
-  return output;
-}
-
-// src/graph/context/GraphContext.ts
 var GraphContext = class _GraphContext {
   // __keys, frozen
   constructor(context) {
@@ -641,7 +652,10 @@ function sleep(ms) {
 // src/graph/execution/GraphNode.ts
 var GraphNode = class _GraphNode extends SignalEmitter {
   constructor(task, context, routineExecId, prevNodes = [], debug = false) {
-    super(task.isMeta);
+    var _a;
+    super(
+      task.isMeta && !debug || task.isSubMeta || ((_a = context == null ? void 0 : context.getMetaData()) == null ? void 0 : _a.__isSubMeta)
+    );
     this.divided = false;
     this.splitGroupId = "";
     this.processing = false;
@@ -712,6 +726,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
     return this.task.getTag(this.context);
   }
   scheduleOn(layer) {
+    var _a;
     let shouldSchedule = true;
     const nodes = layer.getNodesByRoutineExecId(this.routineExecId);
     for (const node of nodes) {
@@ -728,23 +743,56 @@ var GraphNode = class _GraphNode extends SignalEmitter {
     if (shouldSchedule) {
       this.layer = layer;
       layer.add(this);
+      const context = this.context.getFullContext();
       const scheduledAt = Date.now();
       this.emitWithMetadata("meta.node.scheduled", {
-        ...this.lightExport(),
-        __scheduled: scheduledAt
+        data: {
+          uuid: this.id,
+          routineExecutionId: this.routineExecId,
+          contractId: context.__contractId,
+          context: this.context.export(),
+          taskId: this.task.id,
+          taskName: this.task.name,
+          isMeta: this.isMeta(),
+          isScheduled: true,
+          splitGroupId: this.splitGroupId,
+          created: formatTimestamp(scheduledAt)
+        }
       });
-      const context = this.context.getFullContext();
-      if (context.__signalEmission !== void 0 && (!this.isMeta() || this.debug)) {
+      this.previousNodes.forEach((node) => {
+        this.emitWithMetadata("meta.node.mapped", {
+          data: {
+            taskExecutionId: this.id,
+            previousTaskExecutionId: node.id,
+            executionCount: "increment"
+          },
+          filter: {
+            taskId: this.task.id,
+            previousTaskId: node.task.id
+          }
+        });
+        if (node.failed || node.errored) {
+          this.emitWithMetadata("meta.node.failed_mapped", {
+            data: {
+              executionCount: "increment"
+            },
+            filter: {
+              taskId: this.task.id,
+              failTaskId: node.task.id
+            }
+          });
+        }
+      });
+      if (((_a = context.__signalEmission) == null ? void 0 : _a.signalName) && (!this.isMeta() || this.debug)) {
         this.emitWithMetadata("meta.node.consumed_signal", {
-          __signalConsumption: {
+          data: {
             signalName: context.__signalEmission.signalName,
             taskId: this.task.id,
             taskExecutionId: this.id,
-            consumedAt: scheduledAt
+            consumedAt: formatTimestamp(scheduledAt)
           }
         });
         delete context.__signalEmission;
-        this.migrate(context);
       }
     }
   }
@@ -752,14 +800,25 @@ var GraphNode = class _GraphNode extends SignalEmitter {
     if (this.executionStart === 0) {
       this.executionStart = Date.now();
     }
-    const memento = this.lightExport();
     if (this.previousNodes.length === 0) {
-      this.emitWithMetadata("meta.node.started_routine_execution", memento);
+      this.emitWithMetadata("meta.node.started_routine_execution", {
+        data: {
+          isRunning: true,
+          started: formatTimestamp(this.executionStart)
+        },
+        filter: { uuid: this.routineExecId }
+      });
     }
     if (this.debug) {
       this.log();
     }
-    this.emitWithMetadata("meta.node.started", memento);
+    this.emitWithMetadata("meta.node.started", {
+      data: {
+        isRunning: true,
+        started: formatTimestamp(this.executionStart)
+      },
+      filter: { uuid: this.id }
+    });
     return this.executionStart;
   }
   end() {
@@ -769,15 +828,44 @@ var GraphNode = class _GraphNode extends SignalEmitter {
     this.processing = false;
     const end = Date.now();
     this.executionTime = end - this.executionStart;
-    const memento = this.lightExport();
+    const context = this.context.getFullContext();
     if (this.errored || this.failed) {
-      this.emitWithMetadata("meta.node.errored", memento);
+      this.emitWithMetadata("meta.node.errored", {
+        data: {
+          isRunning: false,
+          errored: this.errored,
+          failed: this.failed,
+          errorMessage: context.__error
+        },
+        filter: { uuid: this.id }
+      });
     }
-    this.emitWithMetadata("meta.node.ended", memento);
+    this.emitWithMetadata("meta.node.ended", {
+      data: {
+        isRunning: false,
+        isComplete: true,
+        resultContext: this.context.export(),
+        errored: this.errored,
+        failed: this.failed,
+        errorMessage: context.__error,
+        progress: 1,
+        ended: formatTimestamp(end)
+      },
+      filter: { uuid: this.id }
+    });
     if (this.graphDone()) {
       this.emitWithMetadata(
         `meta.node.ended_routine_execution:${this.routineExecId}`,
-        memento
+        {
+          data: {
+            isRunning: false,
+            isComplete: true,
+            resultContext: this.context.export(),
+            progress: 1,
+            ended: formatTimestamp(end)
+          },
+          filter: { uuid: this.routineExecId }
+        }
       );
     }
     return end;
@@ -839,23 +927,41 @@ var GraphNode = class _GraphNode extends SignalEmitter {
     }
   }
   emitWithMetadata(signal, ctx) {
-    this.emit(signal, {
-      ...ctx,
-      __signalEmission: {
+    if (this.silent) return;
+    const data = { ...ctx };
+    if (!this.task.isHidden) {
+      data.__signalEmission = {
         taskId: this.task.id,
         taskExecutionId: this.id
-      }
-    });
+      };
+      data.__metadata = {
+        __routineExecId: this.routineExecId
+      };
+    }
+    this.emit(signal, data);
   }
   onProgress(progress) {
-    var _a, _b, _c;
+    var _a, _b;
     progress = Math.min(Math.max(0, progress), 1);
-    this.emitWithMetadata(`meta.node.progress:${this.routineExecId}`, {
-      __nodeId: this.id,
-      __routineExecId: this.routineExecId,
-      __progress: progress,
-      __weight: this.task.progressWeight / ((_c = (_b = (_a = this.layer) == null ? void 0 : _a.getNodesByRoutineExecId(this.routineExecId)) == null ? void 0 : _b.length) != null ? _c : 1)
+    this.emitWithMetadata("meta.node.progress", {
+      data: {
+        progress
+      },
+      filter: {
+        uuid: this.id
+      }
     });
+    this.emitWithMetadata(
+      `meta.node.routine_execution_progress:${this.routineExecId}`,
+      {
+        data: {
+          progress: progress * this.task.progressWeight / ((_b = (_a = this.layer) == null ? void 0 : _a.getIdenticalNodes(this).length) != null ? _b : 1)
+        },
+        filter: {
+          uuid: this.routineExecId
+        }
+      }
+    );
   }
   postProcess() {
     if (typeof this.result === "string") {
@@ -872,11 +978,11 @@ var GraphNode = class _GraphNode extends SignalEmitter {
     }
     if (this.errored || this.failed) {
       this.task.mapOnFailSignals(
-        (signal) => this.emitWithMetadata(signal, this.context)
+        (signal) => this.emitWithMetadata(signal, this.context.getFullContext())
       );
     } else {
       this.task.mapSignals(
-        (signal) => this.emitWithMetadata(signal, this.context)
+        (signal) => this.emitWithMetadata(signal, this.context.getFullContext())
       );
     }
     this.end();
@@ -1265,8 +1371,24 @@ var GraphRoutine = class extends SignalParticipant {
     this.name = name;
     this.description = description;
     this.isMeta = isMeta;
-    tasks.forEach((t) => this.tasks.add(t));
-    this.emit("meta.routine.created", { __routine: this });
+    this.emit("meta.routine.created", {
+      data: {
+        uuid: this.id,
+        name: this.name,
+        description: this.description,
+        isMeta: this.isMeta
+      },
+      __routineInstance: this
+    });
+    tasks.forEach((t) => {
+      this.tasks.add(t);
+      this.emit("meta.routine.task_added", {
+        data: {
+          taskId: t.id,
+          routineId: this.id
+        }
+      });
+    });
   }
   /**
    * Applies callback to starting tasks.
@@ -1296,7 +1418,10 @@ var GraphRoutine = class extends SignalParticipant {
    */
   destroy() {
     this.tasks.clear();
-    this.emit("meta.routine.destroyed", { __id: this.id });
+    this.emit("meta.routine.destroyed", {
+      data: { deleted: true },
+      filter: { uuid: this.id }
+    });
   }
 };
 
@@ -1346,6 +1471,8 @@ var Task = class extends SignalParticipant {
    * @param register Register via signal (default true).
    * @param isUnique
    * @param isMeta
+   * @param isSubMeta
+   * @param isHidden
    * @param getTagCallback
    * @param inputSchema
    * @param validateInputContext
@@ -1357,14 +1484,17 @@ var Task = class extends SignalParticipant {
    * @param retryDelayFactor
    * @edge Emits 'meta.task.created' with { __task: this } for seed.
    */
-  constructor(name, task, description = "", concurrency = 0, timeout = 0, register = true, isUnique = false, isMeta = false, getTagCallback = void 0, inputSchema = void 0, validateInputContext = false, outputSchema = void 0, validateOutputContext = false, retryCount = 0, retryDelay = 0, retryDelayMax = 0, retryDelayFactor = 1) {
+  constructor(name, task, description = "", 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) {
     super();
     this.isMeta = false;
+    this.isSubMeta = false;
+    this.isHidden = false;
     this.isUnique = false;
     this.throttled = false;
     this.isSignal = false;
     this.isDeputy = false;
     this.isEphemeral = false;
+    this.isDebounce = false;
     this.inputContextSchema = void 0;
     this.validateInputContext = false;
     this.outputContextSchema = void 0;
@@ -1387,6 +1517,8 @@ var Task = class extends SignalParticipant {
     this.timeout = timeout;
     this.isUnique = isUnique;
     this.isMeta = isMeta;
+    this.isSubMeta = isSubMeta;
+    this.isHidden = isHidden;
     this.inputContextSchema = inputSchema;
     this.validateInputContext = validateInputContext;
     this.outputContextSchema = outputSchema;
@@ -1399,8 +1531,35 @@ var Task = class extends SignalParticipant {
       this.getTag = (context) => getTagCallback(context, this);
       this.throttled = true;
     }
-    if (register) {
-      this.emit("meta.task.created", { __task: this });
+    if (register && !this.isHidden && !this.isSubMeta) {
+      const { __functionString, __getTagCallback } = this.export();
+      this.emit("meta.task.created", {
+        __task: {
+          uuid: this.id,
+          name: this.name,
+          description: this.description,
+          functionString: __functionString,
+          tagIdGetter: __getTagCallback,
+          layerIndex: this.layerIndex,
+          concurrency: this.concurrency,
+          retryCount: this.retryCount,
+          retryDelay: this.retryDelay,
+          retryDelayMax: this.retryDelayMax,
+          retryDelayFactor: this.retryDelayFactor,
+          timeout: this.timeout,
+          isUnique: this.isUnique,
+          isSignal: this.isSignal,
+          isThrottled: this.throttled,
+          isDebounce: this.isDebounce,
+          isEphemeral: this.isEphemeral,
+          isMeta: this.isMeta,
+          validateInputContext: this.validateInputContext,
+          validateOutputContext: this.validateOutputContext,
+          inputContextSchemaId: this.inputContextSchema,
+          outputContextSchemaId: this.outputContextSchema
+        },
+        __taskInstance: this
+      });
     }
   }
   getTag(context) {
@@ -1610,6 +1769,12 @@ var Task = class extends SignalParticipant {
         this.decouple(pred);
         throw new Error(`Cycle adding pred ${pred.name} to ${this.name}`);
       }
+      this.emit("meta.task.relationship_added", {
+        data: {
+          taskId: this.id,
+          predecessorTaskId: pred.id
+        }
+      });
     }
     this.updateProgressWeights();
     return this;
@@ -1624,6 +1789,12 @@ var Task = class extends SignalParticipant {
         this.decouple(next);
         throw new Error(`Cycle adding next ${next.name} to ${this.name}`);
       }
+      this.emit("meta.task.relationship_added", {
+        data: {
+          taskId: next.id,
+          predecessorTaskId: this.id
+        }
+      });
     }
     this.updateProgressWeights();
     return this;
@@ -1649,6 +1820,12 @@ var Task = class extends SignalParticipant {
         this.decouple(task);
         throw new Error(`Cycle adding onFail ${task.name} to ${this.name}`);
       }
+      this.emit("meta.task.on_fail_relationship_added", {
+        data: {
+          taskId: this.id,
+          onFailTaskId: task.id
+        }
+      });
     }
     return this;
   }
@@ -1680,11 +1857,20 @@ var Task = class extends SignalParticipant {
     return layers;
   }
   updateLayerFromPredecessors() {
+    const prevLayerIndex = this.layerIndex;
     let maxPred = 0;
     this.predecessorTasks.forEach(
       (pred) => maxPred = Math.max(maxPred, pred.layerIndex)
     );
     this.layerIndex = maxPred + 1;
+    if (prevLayerIndex !== this.layerIndex) {
+      this.emit("meta.task.layer_index_changed", {
+        data: {
+          layerIndex: this.layerIndex
+        },
+        filter: { uuid: this.id }
+      });
+    }
     const queue = Array.from(this.nextTasks);
     while (queue.length) {
       const next = queue.shift();
@@ -1724,7 +1910,10 @@ var Task = class extends SignalParticipant {
     this.predecessorTasks.clear();
     this.onFailTasks.clear();
     this.destroyed = true;
-    this.emit("meta.task.destroyed", { __id: this.id });
+    this.emit("meta.task.destroyed", {
+      data: { deleted: true },
+      filter: { uuid: this.id }
+    });
   }
   export() {
     return {
@@ -1772,10 +1961,11 @@ var GraphRegistry = class _GraphRegistry {
     this.registerTask = new Task(
       "Register task",
       (context) => {
-        const { __task } = context;
-        if (__task && !this.tasks.has(__task.id)) {
-          this.tasks.set(__task.id, __task);
+        const { __taskInstance } = context;
+        if (__taskInstance && !this.tasks.has(__taskInstance.id)) {
+          this.tasks.set(__taskInstance.id, __taskInstance);
         }
+        delete context.__taskInstance;
         return true;
       },
       "Registers tasks. Seed for meta.taskCreated",
@@ -1880,10 +2070,11 @@ var GraphRegistry = class _GraphRegistry {
     this.registerRoutine = Cadenza.createMetaTask(
       "Register routine",
       (context) => {
-        const { __routine } = context;
-        if (__routine && !this.routines.has(__routine.id)) {
-          this.routines.set(__routine.id, __routine);
+        const { __routineInstance } = context;
+        if (__routineInstance && !this.routines.has(__routineInstance.id)) {
+          this.routines.set(__routineInstance.id, __routineInstance);
         }
+        delete context.__routineInstance;
         return true;
       },
       "Registers routine."
@@ -2020,28 +2211,18 @@ var GraphRunner = class extends SignalEmitter {
     const ctx = new GraphContext(context || {});
     const routineExecId = (_a = context.__routineExecId) != null ? _a : uuid6();
     context.__routineExecId = routineExecId;
-    const data = {
-      __routineExecId: routineExecId,
-      __routineName: routineName,
-      __isMeta: isMeta,
-      __routineId: routineId,
-      __context: ctx.export(),
-      __previousRoutineExecution: (_c = (_b = context.__metaData) == null ? void 0 : _b.__routineExecId) != null ? _c : null,
-      __contractId: (_f = (_e = (_d = context.__metaData) == null ? void 0 : _d.__contractId) != null ? _e : context.__contractId) != null ? _f : null,
-      __task: {
-        __name: routineName
-      },
-      __scheduled: Date.now()
-    };
-    this.emit("meta.runner.added_tasks", data);
-    if (this.debug) {
-      console.log(
-        `${this.isMeta ? "Meta" : ""}Runner added tasks`,
-        allTasks.map((t) => t.name),
-        "with context",
-        ctx.getFullContext()
-      );
-    }
+    this.emit("meta.runner.added_tasks", {
+      data: {
+        uuid: routineExecId,
+        name: routineName,
+        isMeta,
+        contractId: (_d = (_c = (_b = context.__metaData) == null ? void 0 : _b.__contractId) != null ? _c : context.__contractId) != null ? _d : null,
+        context: ctx.export(),
+        previousRoutineExecution: (_f = (_e = context.__metaData) == null ? void 0 : _e.__routineExecId) != null ? _f : null,
+        // TODO: There is a chance this is not added to the database yet...
+        created: formatTimestamp(Date.now())
+      }
+    });
     allTasks.forEach(
       (task) => this.currentRun.addNode(
         new GraphNode(task, ctx, routineExecId, [], this.debug)
@@ -2112,7 +2293,7 @@ var GraphRunner = class extends SignalEmitter {
 
 // src/graph/definition/DebounceTask.ts
 var DebounceTask = class extends Task {
-  constructor(name, task, description = "", debounceTime = 1e3, leading = false, trailing = true, maxWait = 0, concurrency = 0, timeout = 0, register = true, isUnique = false, isMeta = false, inputSchema = void 0, validateInputSchema = false, outputSchema = void 0, validateOutputSchema = false) {
+  constructor(name, task, description = "", debounceTime = 1e3, leading = false, trailing = true, maxWait = 0, concurrency = 0, timeout = 0, register = true, isUnique = false, isMeta = false, isSubMeta = false, isHidden = false, inputSchema = void 0, validateInputSchema = false, outputSchema = void 0, validateOutputSchema = false) {
     super(
       name,
       task,
@@ -2122,6 +2303,8 @@ var DebounceTask = class extends Task {
       register,
       isUnique,
       isMeta,
+      isSubMeta,
+      isHidden,
       void 0,
       inputSchema,
       validateInputSchema,
@@ -2231,7 +2414,7 @@ var DebounceTask = class extends Task {
 
 // src/graph/definition/EphemeralTask.ts
 var EphemeralTask = class extends Task {
-  constructor(name, task, description = "", once = true, condition = () => true, concurrency = 0, timeout = 0, register = false, isUnique = false, isMeta = false, getTagCallback = void 0, inputSchema = void 0, validateInputContext = false, outputSchema = void 0, validateOutputContext = false, retryCount = 0, retryDelay = 0, retryDelayMax = 0, retryDelayFactor = 1) {
+  constructor(name, task, description = "", once = true, condition = () => true, concurrency = 0, timeout = 0, register = false, 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) {
     super(
       name,
       task,
@@ -2241,6 +2424,8 @@ var EphemeralTask = class extends Task {
       register,
       isUnique,
       isMeta,
+      isSubMeta,
+      isHidden,
       getTagCallback,
       inputSchema,
       validateInputContext,
@@ -2257,7 +2442,7 @@ var EphemeralTask = class extends Task {
   }
   execute(context, emit, progressCallback) {
     const result = super.execute(context, emit, progressCallback);
-    if (this.once || !this.condition(result)) {
+    if (this.once || this.condition(result)) {
       this.destroy();
       return result;
     }
@@ -2365,6 +2550,11 @@ var GraphLayer = class _GraphLayer extends ExecutionChain {
   getNodesByRoutineExecId(routineExecId) {
     return this.nodes.filter((node) => node.routineExecId === routineExecId);
   }
+  getIdenticalNodes(node) {
+    return this.nodes.filter(
+      (n) => node.routineExecId === n.routineExecId && node.sharesTaskWith(n)
+    );
+  }
   isProcessed() {
     for (const node of this.nodes) {
       if (!node.isProcessed()) {
@@ -2838,6 +3028,8 @@ var Cadenza = class {
     register: true,
     isUnique: false,
     isMeta: false,
+    isSubMeta: false,
+    isHidden: false,
     getTagCallback: void 0,
     inputSchema: void 0,
     validateInputContext: false,
@@ -2859,6 +3051,8 @@ var Cadenza = class {
       options.register,
       options.isUnique,
       options.isMeta,
+      options.isSubMeta,
+      options.isHidden,
       options.getTagCallback,
       options.inputSchema,
       options.validateInputContext,
@@ -2886,6 +3080,8 @@ var Cadenza = class {
     register: true,
     isUnique: false,
     isMeta: true,
+    isSubMeta: false,
+    isHidden: false,
     getTagCallback: void 0,
     inputSchema: void 0,
     validateInputContext: false,
@@ -2915,6 +3111,8 @@ var Cadenza = class {
     register: true,
     isUnique: true,
     isMeta: false,
+    isSubMeta: false,
+    isHidden: false,
     getTagCallback: void 0,
     inputSchema: void 0,
     validateInputContext: false,
@@ -2942,6 +3140,8 @@ var Cadenza = class {
     register: true,
     isUnique: true,
     isMeta: true,
+    isSubMeta: false,
+    isHidden: false,
     getTagCallback: void 0,
     inputSchema: void 0,
     validateInputContext: false,
@@ -2971,6 +3171,8 @@ var Cadenza = class {
     register: true,
     isUnique: false,
     isMeta: false,
+    isSubMeta: false,
+    isHidden: false,
     inputSchema: void 0,
     validateInputContext: false,
     outputSchema: void 0,
@@ -2998,6 +3200,8 @@ var Cadenza = class {
     register: true,
     isUnique: false,
     isMeta: true,
+    isSubMeta: false,
+    isHidden: false,
     inputSchema: void 0,
     validateInputContext: false,
     outputSchema: void 0,
@@ -3035,6 +3239,8 @@ var Cadenza = class {
     maxWait: 0,
     isUnique: false,
     isMeta: false,
+    isSubMeta: false,
+    isHidden: false,
     inputSchema: void 0,
     validateInputContext: false,
     outputSchema: void 0,
@@ -3055,6 +3261,8 @@ var Cadenza = class {
       options.register,
       options.isUnique,
       options.isMeta,
+      options.isSubMeta,
+      options.isHidden,
       options.inputSchema,
       options.validateInputContext,
       options.outputSchema,
@@ -3079,6 +3287,8 @@ var Cadenza = class {
     maxWait: 0,
     isUnique: false,
     isMeta: false,
+    isSubMeta: false,
+    isHidden: false,
     inputSchema: void 0,
     validateInputContext: false,
     outputSchema: void 0,
@@ -3099,18 +3309,20 @@ var Cadenza = class {
    * @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, func, description, once = true, destroyCondition = () => true, options = {
+  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,
@@ -3127,13 +3339,15 @@ var Cadenza = class {
       name,
       func,
       description,
-      once,
-      destroyCondition,
+      options.once,
+      options.destroyCondition,
       options.concurrency,
       options.timeout,
       options.register,
       options.isUnique,
       options.isMeta,
+      options.isSubMeta,
+      options.isHidden,
       options.getTagCallback,
       options.inputSchema,
       options.validateInputContext,
@@ -3150,17 +3364,19 @@ var Cadenza = class {
    * @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, func, description, once = true, destroyCondition = () => true, options = {
+  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,
@@ -3172,14 +3388,7 @@ var Cadenza = class {
     retryDelayFactor: 1
   }) {
     options.isMeta = true;
-    return this.createEphemeralTask(
-      name,
-      func,
-      description,
-      once,
-      destroyCondition,
-      options
-    );
+    return this.createEphemeralTask(name, func, description, options);
   }
   /**
    * Creates a GraphRoutine (named entry to starting tasks) and registers it.
@@ -3216,6 +3425,7 @@ var Cadenza = class {
     var _a, _b;
     (_a = this.broker) == null ? void 0 : _a.reset();
     (_b = this.registry) == null ? void 0 : _b.reset();
+    this.isBootstrapped = false;
   }
 };
 Cadenza.isBootstrapped = false;