@cadenza.io/core 1.6.0 → 1.7.0

package/dist/index.d.mts

@@ -605,6 +605,9 @@ declare class SignalBroker {
      * @returns The broker instance.
      */
     static get instance(): SignalBroker;
+    private debug;
+    setDebug(value: boolean): void;
+    protected sanitizeSignalName(signalName: string): void;
     protected runner: GraphRunner | undefined;
     protected metaRunner: GraphRunner | undefined;
     getSignalsTask: Task | undefined;
@@ -652,7 +655,6 @@ declare class SignalBroker {
      * @returns Array of signals.
      */
     listObservedSignals(): string[];
-    private getRunner;
     reset(): void;
 }
 
@@ -733,17 +735,20 @@ interface TaskOptions {
     outputSchema?: SchemaDefinition;
     validateOutputContext?: boolean;
 }
+type CadenzaMode = "dev" | "debug" | "production";
 declare class Cadenza {
     static broker: SignalBroker;
     static runner: GraphRunner;
     static metaRunner: GraphRunner;
     static registry: GraphRegistry;
     protected static isBootstrapped: boolean;
+    protected static mode: CadenzaMode;
     protected static bootstrap(): void;
     static get runStrategy(): {
         PARALLEL: GraphAsyncRun;
         SEQUENTIAL: GraphStandardRun;
     };
+    static setMode(mode: CadenzaMode): void;
     /**
      * Validates a name for uniqueness and non-emptiness.
      * @param name The name to validate.

package/dist/index.d.ts

@@ -605,6 +605,9 @@ declare class SignalBroker {
      * @returns The broker instance.
      */
     static get instance(): SignalBroker;
+    private debug;
+    setDebug(value: boolean): void;
+    protected sanitizeSignalName(signalName: string): void;
     protected runner: GraphRunner | undefined;
     protected metaRunner: GraphRunner | undefined;
     getSignalsTask: Task | undefined;
@@ -652,7 +655,6 @@ declare class SignalBroker {
      * @returns Array of signals.
      */
     listObservedSignals(): string[];
-    private getRunner;
     reset(): void;
 }
 
@@ -733,17 +735,20 @@ interface TaskOptions {
     outputSchema?: SchemaDefinition;
     validateOutputContext?: boolean;
 }
+type CadenzaMode = "dev" | "debug" | "production";
 declare class Cadenza {
     static broker: SignalBroker;
     static runner: GraphRunner;
     static metaRunner: GraphRunner;
     static registry: GraphRegistry;
     protected static isBootstrapped: boolean;
+    protected static mode: CadenzaMode;
     protected static bootstrap(): void;
     static get runStrategy(): {
         PARALLEL: GraphAsyncRun;
         SEQUENTIAL: GraphStandardRun;
     };
+    static setMode(mode: CadenzaMode): void;
     /**
      * Validates a name for uniqueness and non-emptiness.
      * @param name The name to validate.

package/dist/index.js

@@ -38,9 +38,10 @@ module.exports = __toCommonJS(index_exports);
 var SignalBroker = class _SignalBroker {
   // execId -> emitted signals
   constructor() {
+    this.debug = false;
     this.signalObservers = /* @__PURE__ */ new Map();
     this.emitStacks = /* @__PURE__ */ new Map();
-    this.addSignal("meta.signal.added");
+    this.addSignal("meta.signal_broker.added");
   }
   /**
    * Singleton instance for signal management.
@@ -52,6 +53,28 @@ var SignalBroker = class _SignalBroker {
     }
     return this.instance_;
   }
+  setDebug(value) {
+    this.debug = value;
+  }
+  sanitizeSignalName(signalName) {
+    if (signalName.length > 100) {
+      throw new Error("Signal name must be less than 100 characters");
+    }
+    if (signalName.includes(" ")) {
+      throw new Error("Signal name must not contain spaces");
+    }
+    if (signalName.includes("/")) {
+      throw new Error("Signal name must not contain slashes");
+    }
+    if (signalName.includes("\\")) {
+      throw new Error("Signal name must not contain backslashes");
+    }
+    if (/[A-Z]/.test(signalName.split(".").slice(1).join("."))) {
+      throw new Error(
+        "Signal name must not contain uppercase letters in the middle of the signal name. It is only allowed in the first part of the signal name."
+      );
+    }
+  }
   /**
    * Initializes with runners.
    * @param runner Standard runner for user signals.
@@ -117,7 +140,7 @@ var SignalBroker = class _SignalBroker {
    * @throws Error on detected loop.
    */
   emit(signal, context = {}) {
-    const execId = context.__graphExecId || "global";
+    const execId = context.__routineExecId || "global";
     if (!this.emitStacks.has(execId)) this.emitStacks.set(execId, /* @__PURE__ */ new Map());
     const stack = this.emitStacks.get(execId);
     stack.set(signal, context);
@@ -140,20 +163,26 @@ var SignalBroker = class _SignalBroker {
   }
   executeListener(signal, context) {
     const obs = this.signalObservers.get(signal);
-    const runner = this.getRunner(signal);
+    const runner = signal.startsWith("meta") ? this.metaRunner : this.runner;
     if (obs && obs.tasks.size && runner) {
       obs.fn(runner, Array.from(obs.tasks), context);
+      if (this.debug) {
+        console.log(
+          `Emitted signal ${signal} with context ${JSON.stringify(context)}`
+        );
+      }
       return true;
     }
     return false;
   }
   addSignal(signal) {
     if (!this.signalObservers.has(signal)) {
+      this.sanitizeSignalName(signal);
       this.signalObservers.set(signal, {
         fn: (runner, tasks, context) => runner.run(tasks, context),
         tasks: /* @__PURE__ */ new Set()
       });
-      this.emit("meta.signal.added", { __signal: signal });
+      this.emit("meta.signal_broker.added", { __signalName: signal });
     }
   }
   /**
@@ -163,9 +192,6 @@ var SignalBroker = class _SignalBroker {
   listObservedSignals() {
     return Array.from(this.signalObservers.keys());
   }
-  getRunner(signal) {
-    return signal.startsWith("meta") ? this.metaRunner : this.runner;
-  }
   reset() {
     this.emitStacks.clear();
     this.signalObservers.clear();
@@ -1851,6 +1877,7 @@ var GraphRunner = class extends SignalEmitter {
     });
     const ctx = new GraphContext(context || {});
     const routineExecId = (_a = context.__routineExecId) != null ? _a : (0, import_uuid6.v4)();
+    context.__routineExecId = routineExecId;
     const data = {
       __routineExecId: routineExecId,
       __routineName: routineName,
@@ -1865,6 +1892,11 @@ var GraphRunner = class extends SignalEmitter {
       __scheduled: Date.now()
     };
     this.emit("meta.runner.added_tasks", data);
+    if (this.debug) {
+      console.log(
+        `Running routine ${routineName} with context ${JSON.stringify(ctx.getContext())}`
+      );
+    }
     allTasks.forEach(
       (task) => this.currentRun.addNode(new GraphNode(task, ctx, routineExecId))
     );
@@ -2578,6 +2610,12 @@ var Cadenza = class {
       SEQUENTIAL: new GraphStandardRun()
     };
   }
+  static setMode(mode) {
+    this.mode = mode;
+    if (mode === "debug" || mode === "dev") {
+      this.broker.setDebug(true);
+    }
+  }
   /**
    * Validates a name for uniqueness and non-emptiness.
    * @param name The name to validate.
@@ -2941,6 +2979,7 @@ var Cadenza = class {
   }
 };
 Cadenza.isBootstrapped = false;
+Cadenza.mode = "production";
 
 // src/graph/definition/SignalTask.ts
 var SignalTask = class extends Task {