@cadenza.io/core 1.5.1 → 1.7.0

package/dist/index.d.mts

@@ -382,6 +382,7 @@ type SchemaDefinition = {
     items?: SchemaDefinition;
     constraints?: SchemaConstraints;
     description?: string;
+    strict?: boolean;
 };
 
 type TaskFunction = (context: AnyObject, progressCallback: (progress: number) => void) => TaskResult;
@@ -604,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;
@@ -651,7 +655,6 @@ declare class SignalBroker {
      * @returns Array of signals.
      */
     listObservedSignals(): string[];
-    private getRunner;
     reset(): void;
 }
 
@@ -662,6 +665,8 @@ declare class GraphRegistry {
     private routines;
     registerTask: Task;
     updateTaskId: Task;
+    updateTaskInputSchema: Task;
+    updateTaskOutputSchema: Task;
     getTaskById: Task;
     getTaskByName: Task;
     getTasksByLayer: Task;
@@ -730,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

@@ -382,6 +382,7 @@ type SchemaDefinition = {
     items?: SchemaDefinition;
     constraints?: SchemaConstraints;
     description?: string;
+    strict?: boolean;
 };
 
 type TaskFunction = (context: AnyObject, progressCallback: (progress: number) => void) => TaskResult;
@@ -604,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;
@@ -651,7 +655,6 @@ declare class SignalBroker {
      * @returns Array of signals.
      */
     listObservedSignals(): string[];
-    private getRunner;
     reset(): void;
 }
 
@@ -662,6 +665,8 @@ declare class GraphRegistry {
     private routines;
     registerTask: Task;
     updateTaskId: Task;
+    updateTaskInputSchema: Task;
+    updateTaskOutputSchema: Task;
     getTaskById: Task;
     getTaskByName: Task;
     getTasksByLayer: Task;
@@ -730,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();
@@ -1369,6 +1395,8 @@ var Task = class extends SignalParticipant {
         } else if (constraints.oneOf && !constraints.oneOf.includes(value)) {
           errors[`${path}.${key}`] = `Value '${value}' for '${key}' not in oneOf ${JSON.stringify(constraints.oneOf)}`;
         }
+      } else if (schema.strict) {
+        errors[`${path}.${key}`] = `Key '${key}' is not allowed`;
       }
     }
     if (Object.keys(errors).length > 0) {
@@ -1628,6 +1656,28 @@ var GraphRegistry = class _GraphRegistry {
       },
       "Updates task id."
     ).doOn("meta.task.global_id_set");
+    this.updateTaskInputSchema = Cadenza.createMetaTask(
+      "Update task input schema",
+      (context) => {
+        const { __id, __schema } = context;
+        const task = this.tasks.get(__id);
+        if (!task) return true;
+        task.setInputContextSchema(__schema);
+        return true;
+      },
+      "Updates task input schema."
+    ).doOn("meta.task.input_schema_updated");
+    this.updateTaskOutputSchema = Cadenza.createMetaTask(
+      "Update task input schema",
+      (context) => {
+        const { __id, __schema } = context;
+        const task = this.tasks.get(__id);
+        if (!task) return true;
+        task.setOutputContextSchema(__schema);
+        return true;
+      },
+      "Updates task input schema."
+    ).doOn("meta.task.output_schema_updated");
     this.getTaskById = Cadenza.createMetaTask(
       "Get task by id",
       (context) => {
@@ -1827,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,
@@ -1841,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))
     );
@@ -2554,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.
@@ -2917,6 +2979,7 @@ var Cadenza = class {
   }
 };
 Cadenza.isBootstrapped = false;
+Cadenza.mode = "production";
 
 // src/graph/definition/SignalTask.ts
 var SignalTask = class extends Task {