@cadenza.io/core 2.0.0 → 3.0.0

package/dist/index.js

@@ -29,7 +29,6 @@ __export(index_exports, {
   GraphRunner: () => GraphRunner,
   SignalBroker: () => SignalBroker,
   SignalEmitter: () => SignalEmitter,
-  SignalParticipant: () => SignalParticipant,
   SignalTask: () => SignalTask,
   Task: () => Task,
   default: () => index_default
@@ -140,7 +139,7 @@ var SignalBroker = class _SignalBroker {
         return true;
       },
       "Executes queued signals and clears the stack"
-    ).doOn("meta.process_signal_queue_requested").emitsAfter("meta.signal_broker.queue_empty");
+    ).doOn("meta.process_signal_queue_requested").emits("meta.signal_broker.queue_empty");
     this.getSignalsTask = Cadenza.createMetaTask("Get signals", (ctx) => {
       return {
         __signals: Array.from(this.signalObservers.keys()),
@@ -365,10 +364,10 @@ var VueFlowExportVisitor = class {
   }
   visitNode(node) {
     const snapshot = node.export();
-    if (!this.contextToColor[snapshot.__context.__id]) {
-      this.contextToColor[snapshot.__context.__id] = this.colorRandomizer.getRandomColor();
+    if (!this.contextToColor[snapshot.__context.id]) {
+      this.contextToColor[snapshot.__context.id] = this.colorRandomizer.getRandomColor();
     }
-    const color = this.contextToColor[snapshot.__context.__id];
+    const color = this.contextToColor[snapshot.__context.id];
     this.elements.push({
       id: snapshot.__id.slice(0, 8),
       label: snapshot.__task.__name,
@@ -385,7 +384,7 @@ var VueFlowExportVisitor = class {
         executionEnd: snapshot.__executionEnd,
         description: snapshot.__task.__description,
         functionString: snapshot.__task.__functionString,
-        context: snapshot.__context.__context,
+        context: snapshot.__context.context,
         layerIndex: snapshot.__task.__layerIndex
       }
     });
@@ -619,8 +618,8 @@ var GraphContext = class _GraphContext {
    */
   export() {
     return {
-      __id: this.id,
-      __context: this.getFullContext()
+      id: this.id,
+      context: this.getFullContext()
     };
   }
 };
@@ -768,7 +767,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
     return this.task.getTag(this.context);
   }
   scheduleOn(layer) {
-    var _a;
+    var _a, _b, _c;
     let shouldSchedule = true;
     const nodes = layer.getNodesByRoutineExecId(this.routineExecId);
     for (const node of nodes) {
@@ -791,7 +790,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
         data: {
           uuid: this.id,
           routineExecutionId: this.routineExecId,
-          contractId: context.__contractId,
+          executionTraceId: (_b = context.__executionTraceId) != null ? _b : (_a = context.__metadata) == null ? void 0 : _a.__executionTraceId,
           context: this.context.export(),
           taskName: this.task.name,
           taskVersion: this.task.version,
@@ -816,7 +815,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
           }
         });
       });
-      if (((_a = context.__signalEmission) == null ? void 0 : _a.consumed) === false && (!this.isMeta() || this.debug)) {
+      if (((_c = context.__signalEmission) == null ? void 0 : _c.consumed) === false && (!this.isMeta() || this.debug)) {
         this.emitMetricsWithMetadata("meta.node.consumed_signal", {
           data: {
             signalName: context.__signalEmission.signalName,
@@ -1338,139 +1337,21 @@ var GraphNode = class _GraphNode extends SignalEmitter {
   }
 };
 
-// src/interfaces/SignalParticipant.ts
-var SignalParticipant = class extends SignalEmitter {
-  constructor() {
-    super(...arguments);
-    this.emitsSignals = /* @__PURE__ */ new Set();
-    this.signalsToEmitAfter = /* @__PURE__ */ new Set();
-    this.signalsToEmitOnFail = /* @__PURE__ */ new Set();
-    this.observedSignals = /* @__PURE__ */ new Set();
-  }
-  /**
-   * Subscribes to signals (chainable).
-   * @param signals The signal names.
-   * @returns This for chaining.
-   * @edge Duplicates ignored; assumes broker.observe binds this as handler.
-   */
-  doOn(...signals) {
-    signals.forEach((signal) => {
-      if (this.observedSignals.has(signal)) return;
-      Cadenza.broker.observe(signal, this);
-      this.observedSignals.add(signal);
-    });
-    return this;
-  }
-  /**
-   * Sets signals to emit post-execution (chainable).
-   * @param signals The signal names.
-   * @returns This for chaining.
-   */
-  emitsAfter(...signals) {
-    signals.forEach((signal) => {
-      this.signalsToEmitAfter.add(signal);
-      this.emitsSignals.add(signal);
-    });
-    return this;
-  }
-  emitsOnFail(...signals) {
-    signals.forEach((signal) => {
-      this.signalsToEmitOnFail.add(signal);
-      this.emitsSignals.add(signal);
-    });
-    return this;
-  }
-  /**
-   * Unsubscribes from all observed signals.
-   * @returns This for chaining.
-   */
-  unsubscribeAll() {
-    this.observedSignals.forEach(
-      (signal) => Cadenza.broker.unsubscribe(signal, this)
-    );
-    this.observedSignals.clear();
-    return this;
-  }
-  /**
-   * Unsubscribes from specific signals.
-   * @param signals The signals.
-   * @returns This for chaining.
-   * @edge No-op if not subscribed.
-   */
-  unsubscribe(...signals) {
-    signals.forEach((signal) => {
-      if (this.observedSignals.has(signal)) {
-        Cadenza.broker.unsubscribe(signal, this);
-        this.observedSignals.delete(signal);
-      }
-    });
-    return this;
-  }
-  /**
-   * Detaches specific emitted signals.
-   * @param signals The signals.
-   * @returns This for chaining.
-   */
-  detachSignals(...signals) {
-    signals.forEach((signal) => this.signalsToEmitAfter.delete(signal));
-    return this;
-  }
-  /**
-   * Detaches all emitted signals.
-   * @returns This for chaining.
-   */
-  detachAllSignals() {
-    this.signalsToEmitAfter.clear();
-    return this;
-  }
-  mapSignals(callback) {
-    return Array.from(this.signalsToEmitAfter).map(callback);
-  }
-  mapOnFailSignals(callback) {
-    return Array.from(this.signalsToEmitOnFail).map(callback);
-  }
-  /**
-   * Emits attached signals.
-   * @param context The context for emission.
-   * @edge If isMeta (from Task), suppresses further "meta.*" to prevent loops.
-   */
-  emitSignals(context) {
-    this.signalsToEmitAfter.forEach((signal) => {
-      this.emit(signal, context.getFullContext());
-    });
-  }
-  /**
-   * Emits attached fail signals.
-   * @param context The context for emission.
-   * @edge If isMeta (from Task), suppresses further "meta.*" to prevent loops.
-   */
-  emitOnFailSignals(context) {
-    this.signalsToEmitOnFail.forEach((signal) => {
-      this.emit(signal, context.getFullContext());
-    });
-  }
-  /**
-   * Destroys the participant (unsub/detach).
-   */
-  destroy() {
-    this.unsubscribeAll();
-    this.detachAllSignals();
-  }
-};
-
 // src/graph/definition/GraphRoutine.ts
-var GraphRoutine = class extends SignalParticipant {
+var GraphRoutine = class extends SignalEmitter {
   constructor(name, tasks, description, isMeta = false) {
     super();
     this.version = 1;
     this.isMeta = false;
     this.tasks = /* @__PURE__ */ new Set();
+    this.observedSignals = /* @__PURE__ */ new Set();
     this.name = name;
     this.description = description;
     this.isMeta = isMeta;
     this.emit("meta.routine.created", {
       data: {
         name: this.name,
+        version: this.version,
         description: this.description,
         isMeta: this.isMeta
       },
@@ -1509,11 +1390,51 @@ var GraphRoutine = class extends SignalParticipant {
     this.version = version;
     this.emit("meta.routine.global_version_set", { version: this.version });
   }
-  // Removed emitsSignals per clarification (routines as listeners only)
+  /**
+   * Subscribes to signals (chainable).
+   * @param signals The signal names.
+   * @returns This for chaining.
+   * @edge Duplicates ignored; assumes broker.observe binds this as handler.
+   */
+  doOn(...signals) {
+    signals.forEach((signal) => {
+      if (this.observedSignals.has(signal)) return;
+      Cadenza.broker.observe(signal, this);
+      this.observedSignals.add(signal);
+    });
+    return this;
+  }
+  /**
+   * Unsubscribes from all observed signals.
+   * @returns This for chaining.
+   */
+  unsubscribeAll() {
+    this.observedSignals.forEach(
+      (signal) => Cadenza.broker.unsubscribe(signal, this)
+    );
+    this.observedSignals.clear();
+    return this;
+  }
+  /**
+   * Unsubscribes from specific signals.
+   * @param signals The signals.
+   * @returns This for chaining.
+   * @edge No-op if not subscribed.
+   */
+  unsubscribe(...signals) {
+    signals.forEach((signal) => {
+      if (this.observedSignals.has(signal)) {
+        Cadenza.broker.unsubscribe(signal, this);
+        this.observedSignals.delete(signal);
+      }
+    });
+    return this;
+  }
   /**
    * Destroys the routine.
    */
   destroy() {
+    this.unsubscribeAll();
     this.tasks.clear();
     this.emit("meta.routine.destroyed", {
       data: { deleted: true },
@@ -1554,7 +1475,7 @@ var TaskIterator = class {
 };
 
 // src/graph/definition/Task.ts
-var Task = class extends SignalParticipant {
+var Task = class extends SignalEmitter {
   /**
    * Constructs a Task (static definition).
    * @param name Name.
@@ -1604,6 +1525,10 @@ var Task = class extends SignalParticipant {
     this.onFailTasks = /* @__PURE__ */ new Set();
     this.predecessorTasks = /* @__PURE__ */ new Set();
     this.destroyed = false;
+    this.emitsSignals = /* @__PURE__ */ new Set();
+    this.signalsToEmitAfter = /* @__PURE__ */ new Set();
+    this.signalsToEmitOnFail = /* @__PURE__ */ new Set();
+    this.observedSignals = /* @__PURE__ */ new Set();
     this.name = name;
     this.taskFunction = task.bind(this);
     this.description = description;
@@ -1628,8 +1553,9 @@ var Task = class extends SignalParticipant {
     if (register && !this.isHidden && !this.isSubMeta) {
       const { __functionString, __getTagCallback } = this.export();
       this.emitWithMetadata("meta.task.created", {
-        __task: {
+        data: {
           name: this.name,
+          version: this.version,
           description: this.description,
           functionString: __functionString,
           tagIdGetter: __getTagCallback,
@@ -1648,8 +1574,8 @@ var Task = class extends SignalParticipant {
           isMeta: this.isMeta,
           validateInputContext: this.validateInputContext,
           validateOutputContext: this.validateOutputContext,
-          inputContextSchemaId: this.inputContextSchema,
-          outputContextSchemaId: this.outputContextSchema
+          inputContextSchema: this.inputContextSchema,
+          outputContextSchema: this.outputContextSchema
         },
         __taskInstance: this
       });
@@ -2002,8 +1928,165 @@ var Task = class extends SignalParticipant {
   mapPrevious(callback) {
     return Array.from(this.predecessorTasks).map(callback);
   }
+  /**
+   * Subscribes to signals (chainable).
+   * @param signals The signal names.
+   * @returns This for chaining.
+   * @edge Duplicates ignored; assumes broker.observe binds this as handler.
+   */
+  doOn(...signals) {
+    signals.forEach((signal) => {
+      if (this.observedSignals.has(signal)) return;
+      Cadenza.broker.observe(signal, this);
+      this.observedSignals.add(signal);
+      this.emitWithMetadata("meta.task.observed_signal", {
+        data: {
+          signalName: signal,
+          taskName: this.name,
+          taskVersion: this.version
+        }
+      });
+    });
+    return this;
+  }
+  /**
+   * Sets signals to emit post-execution (chainable).
+   * @param signals The signal names.
+   * @returns This for chaining.
+   */
+  emits(...signals) {
+    signals.forEach((signal) => {
+      this.signalsToEmitAfter.add(signal);
+      this.emitsSignals.add(signal);
+      this.emitWithMetadata("meta.task.attached_signal", {
+        data: {
+          signalName: signal,
+          taskName: this.name,
+          taskVersion: this.version
+        }
+      });
+    });
+    return this;
+  }
+  emitsOnFail(...signals) {
+    signals.forEach((signal) => {
+      this.signalsToEmitOnFail.add(signal);
+      this.emitsSignals.add(signal);
+      this.emitWithMetadata("meta.task.attached_signal", {
+        data: {
+          signalName: signal,
+          taskName: this.name,
+          taskVersion: this.version,
+          isOnFail: true
+        }
+      });
+    });
+    return this;
+  }
+  /**
+   * Unsubscribes from all observed signals.
+   * @returns This for chaining.
+   */
+  unsubscribeAll() {
+    this.observedSignals.forEach((signal) => {
+      Cadenza.broker.unsubscribe(signal, this);
+      this.emitWithMetadata("meta.task.unsubscribed_signal", {
+        filter: {
+          signalName: signal,
+          taskName: this.name,
+          taskVersion: this.version
+        }
+      });
+    });
+    this.observedSignals.clear();
+    return this;
+  }
+  /**
+   * Unsubscribes from specific signals.
+   * @param signals The signals.
+   * @returns This for chaining.
+   * @edge No-op if not subscribed.
+   */
+  unsubscribe(...signals) {
+    signals.forEach((signal) => {
+      if (this.observedSignals.has(signal)) {
+        Cadenza.broker.unsubscribe(signal, this);
+        this.observedSignals.delete(signal);
+        this.emitWithMetadata("meta.task.unsubscribed_signal", {
+          filter: {
+            signalName: signal,
+            taskName: this.name,
+            taskVersion: this.version
+          }
+        });
+      }
+    });
+    return this;
+  }
+  /**
+   * Detaches specific emitted signals.
+   * @param signals The signals.
+   * @returns This for chaining.
+   */
+  detachSignals(...signals) {
+    signals.forEach((signal) => {
+      this.signalsToEmitAfter.delete(signal);
+      this.emitWithMetadata("meta.task.detached_signal", {
+        filter: {
+          signalName: signal,
+          taskName: this.name,
+          taskVersion: this.version
+        }
+      });
+    });
+    return this;
+  }
+  /**
+   * Detaches all emitted signals.
+   * @returns This for chaining.
+   */
+  detachAllSignals() {
+    this.signalsToEmitAfter.forEach((signal) => {
+      this.emitWithMetadata("meta.task.detached_signal", {
+        filter: {
+          signalName: signal,
+          taskName: this.name,
+          taskVersion: this.version
+        }
+      });
+    });
+    this.signalsToEmitAfter.clear();
+    return this;
+  }
+  mapSignals(callback) {
+    return Array.from(this.signalsToEmitAfter).map(callback);
+  }
+  mapOnFailSignals(callback) {
+    return Array.from(this.signalsToEmitOnFail).map(callback);
+  }
+  /**
+   * Emits attached signals.
+   * @param context The context for emission.
+   * @edge If isMeta (from Task), suppresses further "meta.*" to prevent loops.
+   */
+  emitSignals(context) {
+    this.signalsToEmitAfter.forEach((signal) => {
+      this.emit(signal, context.getFullContext());
+    });
+  }
+  /**
+   * Emits attached fail signals.
+   * @param context The context for emission.
+   * @edge If isMeta (from Task), suppresses further "meta.*" to prevent loops.
+   */
+  emitOnFailSignals(context) {
+    this.signalsToEmitOnFail.forEach((signal) => {
+      this.emit(signal, context.getFullContext());
+    });
+  }
   destroy() {
-    super.destroy();
+    this.unsubscribeAll();
+    this.detachAllSignals();
     this.predecessorTasks.forEach((pred) => pred.nextTasks.delete(this));
     this.nextTasks.forEach((next) => next.predecessorTasks.delete(this));
     this.onFailTasks.forEach((fail) => fail.predecessorTasks.delete(this));
@@ -2074,7 +2157,7 @@ var GraphRegistry = class _GraphRegistry {
       true,
       false,
       true
-    ).doOn("meta.task.created");
+    ).doOn("meta.task.created").emits("meta.graph_registry.task_registered");
     this.tasks.set(this.registerTask.name, this.registerTask);
     this.updateTaskInputSchema = Cadenza.createMetaTask(
       "Update task input schema",
@@ -2247,7 +2330,7 @@ var GraphRunner = class extends SignalEmitter {
    * @edge Empty tasks warns no-op.
    */
   addTasks(tasks, context = {}) {
-    var _a, _b, _c, _d, _e, _f;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l;
     let _tasks = Array.isArray(tasks) ? tasks : [tasks];
     if (_tasks.length === 0) {
       console.warn("No tasks/routines to add.");
@@ -2270,18 +2353,35 @@ var GraphRunner = class extends SignalEmitter {
     const isSubMeta = allTasks.some((t) => t.isSubMeta) || !!context.__isSubMeta;
     context.__isSubMeta = isSubMeta;
     const ctx = new GraphContext(context || {});
+    const isNewTrace = !!context.__routineExecId;
     const routineExecId = (_a = context.__routineExecId) != null ? _a : (0, import_uuid4.v4)();
     context.__routineExecId = routineExecId;
     if (!isSubMeta) {
+      const executionTraceId = (_d = (_c = (_b = context.__metadata) == null ? void 0 : _b.__executionTraceId) != null ? _c : context.__executionTraceId) != null ? _d : (0, import_uuid4.v4)();
+      const contextData = ctx.export();
+      if (isNewTrace) {
+        this.emitMetrics("meta.runner.new_trace", {
+          data: {
+            uuid: executionTraceId,
+            issuer_type: "service",
+            // TODO: Add issuer type
+            issuer_id: (_g = (_f = (_e = context.__metadata) == null ? void 0 : _e.__issuerId) != null ? _f : context.__issuerId) != null ? _g : null,
+            issued_at: formatTimestamp(Date.now()),
+            intent: (_j = (_i = (_h = context.__metadata) == null ? void 0 : _h.__intent) != null ? _i : context.__intent) != null ? _j : null,
+            context: contextData,
+            is_meta: isMeta
+          }
+        });
+      }
       this.emitMetrics("meta.runner.added_tasks", {
         data: {
           uuid: routineExecId,
           name: routineName,
           routineVersion,
           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,
+          executionTraceId,
+          context: isNewTrace ? contextData.id : contextData,
+          previousRoutineExecution: (_l = (_k = context.__metadata) == null ? void 0 : _k.__routineExecId) != null ? _l : null,
           // TODO: There is a chance this is not added to the database yet...
           created: formatTimestamp(Date.now())
         }
@@ -3420,7 +3520,6 @@ var index_default = Cadenza;
   GraphRunner,
   SignalBroker,
   SignalEmitter,
-  SignalParticipant,
   SignalTask,
   Task
 });