@cadenza.io/core 3.19.2 → 3.19.4

package/dist/index.d.mts

@@ -335,13 +335,14 @@ type SchemaDefinition = {
     type: SchemaType;
     required?: string[];
     properties?: {
-        [key: string]: SchemaDefinition;
+        [key: string]: Schema;
     };
-    items?: SchemaDefinition;
+    items?: Schema;
     constraints?: SchemaConstraints;
     description?: string;
     strict?: boolean;
 };
+type Schema = SchemaDefinition | SchemaDefinition[];
 
 interface Intent {
     name: string;
@@ -848,9 +849,9 @@ declare class Task extends SignalEmitter implements Graph {
     readonly isDeputy: boolean;
     readonly isEphemeral: boolean;
     readonly isDebounce: boolean;
-    inputContextSchema: SchemaDefinition;
+    inputContextSchema: Schema;
     validateInputContext: boolean;
-    outputContextSchema: SchemaDefinition;
+    outputContextSchema: Schema;
     validateOutputContext: boolean;
     readonly retryCount: number;
     readonly retryDelay: number;
@@ -886,16 +887,16 @@ declare class Task extends SignalEmitter implements Graph {
      * @param {boolean} [isSubMeta=false] - Indicates if the task is a sub-meta-task.
      * @param {boolean} [isHidden=false] - Determines if the task is hidden and not exposed publicly.
      * @param {ThrottleTagGetter} [getTagCallback=undefined] - A callback to generate a throttle tag for the task.
-     * @param {SchemaDefinition} [inputSchema=undefined] - The input schema for validating the task's input context.
+     * @param {Schema} [inputSchema=undefined] - The input schema for validating the task's input context.
      * @param {boolean} [validateInputContext=false] - Specifies if the input context should be validated against the input schema.
-     * @param {SchemaDefinition} [outputSchema=undefined] - The output schema for validating the task's output context.
+     * @param {Schema} [outputSchema=undefined] - The output schema for validating the task's output context.
      * @param {boolean} [validateOutputContext=false] - Specifies if the output context should be validated against the output schema.
      * @param {number} [retryCount=0] - The number of retry attempts allowed for the task in case of failure.
      * @param {number} [retryDelay=0] - The initial delay (in milliseconds) between retry attempts.
      * @param {number} [retryDelayMax=0] - The maximum delay (in milliseconds) allowed between retries.
      * @param {number} [retryDelayFactor=1] - The factor by which the retry delay increases after each attempt.
      */
-    constructor(name: string, task: TaskFunction, description?: string, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, isSubMeta?: boolean, isHidden?: boolean, getTagCallback?: ThrottleTagGetter | undefined, inputSchema?: SchemaDefinition, validateInputContext?: boolean, outputSchema?: SchemaDefinition, validateOutputContext?: boolean, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
+    constructor(name: string, task: TaskFunction, description?: string, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, isSubMeta?: boolean, isHidden?: boolean, getTagCallback?: ThrottleTagGetter | undefined, inputSchema?: Schema, validateInputContext?: boolean, outputSchema?: Schema, validateOutputContext?: boolean, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
     clone(traverse?: boolean, includeSignals?: boolean): Task;
     /**
      * Retrieves the tag associated with the instance.
@@ -909,8 +910,8 @@ declare class Task extends SignalEmitter implements Graph {
     setTimeout(timeout: number): void;
     setConcurrency(concurrency: number): void;
     setProgressWeight(weight: number): void;
-    setInputContextSchema(schema: SchemaDefinition): void;
-    setOutputContextSchema(schema: SchemaDefinition): void;
+    setInputContextSchema(schema: Schema): void;
+    setOutputContextSchema(schema: Schema): void;
     setValidateInputContext(value: boolean): void;
     setValidateOutputContext(value: boolean): void;
     /**
@@ -937,15 +938,16 @@ declare class Task extends SignalEmitter implements Graph {
      * Validates a data object against a specified schema definition and returns validation results.
      *
      * @param {any} data - The target object to validate against the schema.
-     * @param {SchemaDefinition | undefined} schema - The schema definition describing the expected structure and constraints of the data.
+     * @param {Schema | undefined} schema - The schema definition describing the expected structure and constraints of the data.
      * @param {string} [path="context"] - The base path or context for traversing the data, used in generating error messages.
      * @return {{ valid: boolean, errors: Record<string, string> }} - An object containing a validity flag (`valid`)
      * and a map (`errors`) of validation error messages keyed by property paths.
      */
-    validateSchema(data: any, schema: SchemaDefinition | undefined, path?: string): {
+    validateSchema(data: any, schema: Schema | undefined, path?: string): {
         valid: boolean;
         errors: Record<string, string>;
     };
+    validateProp(prop: SchemaDefinition, key: string, value?: any, path?: string): Record<string, string>;
     /**
      * Validates the input context against the predefined schema and emits metadata if validation fails.
      *
@@ -1504,6 +1506,7 @@ declare class SignalBroker {
     private isStrategyFlushing;
     private readonly defaultStrategyName;
     constructor();
+    logMemoryFootprint(label?: string): void;
     /**
      * Validates the provided signal name string to ensure it adheres to specific formatting rules.
      * Throws an error if any of the validation checks fail.
@@ -1685,7 +1688,7 @@ declare class DebounceTask extends Task {
     lastProgressCallback: ((progress: number) => void) | null;
     lastEmitFunction: ((signal: string, context: any) => void) | null;
     lastInquireFunction: ((inquiry: string, context: AnyObject, options: InquiryOptions) => Promise<AnyObject>) | null;
-    constructor(name: string, task: TaskFunction, description?: string, debounceTime?: number, leading?: boolean, trailing?: boolean, maxWait?: number, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, isSubMeta?: boolean, isHidden?: boolean, inputSchema?: SchemaDefinition | undefined, validateInputSchema?: boolean, outputSchema?: SchemaDefinition | undefined, validateOutputSchema?: boolean);
+    constructor(name: string, task: TaskFunction, description?: string, debounceTime?: number, leading?: boolean, trailing?: boolean, maxWait?: number, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, isSubMeta?: boolean, isHidden?: boolean, inputSchema?: Schema | undefined, validateInputSchema?: boolean, outputSchema?: Schema | undefined, validateOutputSchema?: boolean);
     /**
      * Executes the taskFunction with the provided context, emit function, and progress callback.
      * It clears any existing timeout before execution.
@@ -1739,7 +1742,7 @@ declare class EphemeralTask extends Task {
     readonly once: boolean;
     readonly condition: (context: any) => boolean;
     readonly isEphemeral: boolean;
-    constructor(name: string, task: TaskFunction, description?: string, once?: boolean, condition?: (context: any) => boolean, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, isSubMeta?: boolean, isHidden?: boolean, getTagCallback?: ThrottleTagGetter | undefined, inputSchema?: SchemaDefinition | undefined, validateInputContext?: boolean, outputSchema?: SchemaDefinition | undefined, validateOutputContext?: boolean, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
+    constructor(name: string, task: TaskFunction, description?: string, once?: boolean, condition?: (context: any) => boolean, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, isSubMeta?: boolean, isHidden?: boolean, getTagCallback?: ThrottleTagGetter | undefined, inputSchema?: Schema | undefined, validateInputContext?: boolean, outputSchema?: Schema | undefined, validateOutputContext?: boolean, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
     /**
      * Executes the process logic with the provided context, emit function, progress callback, and node data.
      *
@@ -1800,9 +1803,9 @@ interface TaskOptions {
     isSubMeta?: boolean;
     isHidden?: boolean;
     getTagCallback?: ThrottleTagGetter;
-    inputSchema?: SchemaDefinition;
+    inputSchema?: Schema;
     validateInputContext?: boolean;
-    outputSchema?: SchemaDefinition;
+    outputSchema?: Schema;
     validateOutputContext?: boolean;
     retryCount?: number;
     retryDelay?: number;
@@ -1897,7 +1900,7 @@ declare class Cadenza {
      * ```
      */
     static emit(event: string, data?: AnyObject, options?: EmitOptions): void;
-    static schedule(taskName: string, context: AnyObject, delayMs: number, exactDateTime?: Date): void;
+    static schedule(signalName: string, context: AnyObject, delayMs: number, exactDateTime?: Date): void;
     static interval(taskName: string, context: AnyObject, intervalMs: number, leading?: boolean, startDateTime?: Date): void;
     static debounce(signalName: string, context: any, delayMs: number): void;
     static get(taskName: string): Task | undefined;
@@ -2255,4 +2258,4 @@ declare class Cadenza {
     static reset(): void;
 }
 
-export { type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, type EmitOptions, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, InquiryBroker, type InquiryOptions, type Intent, type SchemaConstraints, type SchemaDefinition, type SchemaType, SignalBroker, SignalEmitter, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default };
+export { type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, type EmitOptions, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, InquiryBroker, type InquiryOptions, type Intent, type Schema, type SchemaConstraints, type SchemaDefinition, type SchemaType, SignalBroker, SignalEmitter, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default };

package/dist/index.d.ts

@@ -335,13 +335,14 @@ type SchemaDefinition = {
     type: SchemaType;
     required?: string[];
     properties?: {
-        [key: string]: SchemaDefinition;
+        [key: string]: Schema;
     };
-    items?: SchemaDefinition;
+    items?: Schema;
     constraints?: SchemaConstraints;
     description?: string;
     strict?: boolean;
 };
+type Schema = SchemaDefinition | SchemaDefinition[];
 
 interface Intent {
     name: string;
@@ -848,9 +849,9 @@ declare class Task extends SignalEmitter implements Graph {
     readonly isDeputy: boolean;
     readonly isEphemeral: boolean;
     readonly isDebounce: boolean;
-    inputContextSchema: SchemaDefinition;
+    inputContextSchema: Schema;
     validateInputContext: boolean;
-    outputContextSchema: SchemaDefinition;
+    outputContextSchema: Schema;
     validateOutputContext: boolean;
     readonly retryCount: number;
     readonly retryDelay: number;
@@ -886,16 +887,16 @@ declare class Task extends SignalEmitter implements Graph {
      * @param {boolean} [isSubMeta=false] - Indicates if the task is a sub-meta-task.
      * @param {boolean} [isHidden=false] - Determines if the task is hidden and not exposed publicly.
      * @param {ThrottleTagGetter} [getTagCallback=undefined] - A callback to generate a throttle tag for the task.
-     * @param {SchemaDefinition} [inputSchema=undefined] - The input schema for validating the task's input context.
+     * @param {Schema} [inputSchema=undefined] - The input schema for validating the task's input context.
      * @param {boolean} [validateInputContext=false] - Specifies if the input context should be validated against the input schema.
-     * @param {SchemaDefinition} [outputSchema=undefined] - The output schema for validating the task's output context.
+     * @param {Schema} [outputSchema=undefined] - The output schema for validating the task's output context.
      * @param {boolean} [validateOutputContext=false] - Specifies if the output context should be validated against the output schema.
      * @param {number} [retryCount=0] - The number of retry attempts allowed for the task in case of failure.
      * @param {number} [retryDelay=0] - The initial delay (in milliseconds) between retry attempts.
      * @param {number} [retryDelayMax=0] - The maximum delay (in milliseconds) allowed between retries.
      * @param {number} [retryDelayFactor=1] - The factor by which the retry delay increases after each attempt.
      */
-    constructor(name: string, task: TaskFunction, description?: string, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, isSubMeta?: boolean, isHidden?: boolean, getTagCallback?: ThrottleTagGetter | undefined, inputSchema?: SchemaDefinition, validateInputContext?: boolean, outputSchema?: SchemaDefinition, validateOutputContext?: boolean, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
+    constructor(name: string, task: TaskFunction, description?: string, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, isSubMeta?: boolean, isHidden?: boolean, getTagCallback?: ThrottleTagGetter | undefined, inputSchema?: Schema, validateInputContext?: boolean, outputSchema?: Schema, validateOutputContext?: boolean, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
     clone(traverse?: boolean, includeSignals?: boolean): Task;
     /**
      * Retrieves the tag associated with the instance.
@@ -909,8 +910,8 @@ declare class Task extends SignalEmitter implements Graph {
     setTimeout(timeout: number): void;
     setConcurrency(concurrency: number): void;
     setProgressWeight(weight: number): void;
-    setInputContextSchema(schema: SchemaDefinition): void;
-    setOutputContextSchema(schema: SchemaDefinition): void;
+    setInputContextSchema(schema: Schema): void;
+    setOutputContextSchema(schema: Schema): void;
     setValidateInputContext(value: boolean): void;
     setValidateOutputContext(value: boolean): void;
     /**
@@ -937,15 +938,16 @@ declare class Task extends SignalEmitter implements Graph {
      * Validates a data object against a specified schema definition and returns validation results.
      *
      * @param {any} data - The target object to validate against the schema.
-     * @param {SchemaDefinition | undefined} schema - The schema definition describing the expected structure and constraints of the data.
+     * @param {Schema | undefined} schema - The schema definition describing the expected structure and constraints of the data.
      * @param {string} [path="context"] - The base path or context for traversing the data, used in generating error messages.
      * @return {{ valid: boolean, errors: Record<string, string> }} - An object containing a validity flag (`valid`)
      * and a map (`errors`) of validation error messages keyed by property paths.
      */
-    validateSchema(data: any, schema: SchemaDefinition | undefined, path?: string): {
+    validateSchema(data: any, schema: Schema | undefined, path?: string): {
         valid: boolean;
         errors: Record<string, string>;
     };
+    validateProp(prop: SchemaDefinition, key: string, value?: any, path?: string): Record<string, string>;
     /**
      * Validates the input context against the predefined schema and emits metadata if validation fails.
      *
@@ -1504,6 +1506,7 @@ declare class SignalBroker {
     private isStrategyFlushing;
     private readonly defaultStrategyName;
     constructor();
+    logMemoryFootprint(label?: string): void;
     /**
      * Validates the provided signal name string to ensure it adheres to specific formatting rules.
      * Throws an error if any of the validation checks fail.
@@ -1685,7 +1688,7 @@ declare class DebounceTask extends Task {
     lastProgressCallback: ((progress: number) => void) | null;
     lastEmitFunction: ((signal: string, context: any) => void) | null;
     lastInquireFunction: ((inquiry: string, context: AnyObject, options: InquiryOptions) => Promise<AnyObject>) | null;
-    constructor(name: string, task: TaskFunction, description?: string, debounceTime?: number, leading?: boolean, trailing?: boolean, maxWait?: number, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, isSubMeta?: boolean, isHidden?: boolean, inputSchema?: SchemaDefinition | undefined, validateInputSchema?: boolean, outputSchema?: SchemaDefinition | undefined, validateOutputSchema?: boolean);
+    constructor(name: string, task: TaskFunction, description?: string, debounceTime?: number, leading?: boolean, trailing?: boolean, maxWait?: number, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, isSubMeta?: boolean, isHidden?: boolean, inputSchema?: Schema | undefined, validateInputSchema?: boolean, outputSchema?: Schema | undefined, validateOutputSchema?: boolean);
     /**
      * Executes the taskFunction with the provided context, emit function, and progress callback.
      * It clears any existing timeout before execution.
@@ -1739,7 +1742,7 @@ declare class EphemeralTask extends Task {
     readonly once: boolean;
     readonly condition: (context: any) => boolean;
     readonly isEphemeral: boolean;
-    constructor(name: string, task: TaskFunction, description?: string, once?: boolean, condition?: (context: any) => boolean, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, isSubMeta?: boolean, isHidden?: boolean, getTagCallback?: ThrottleTagGetter | undefined, inputSchema?: SchemaDefinition | undefined, validateInputContext?: boolean, outputSchema?: SchemaDefinition | undefined, validateOutputContext?: boolean, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
+    constructor(name: string, task: TaskFunction, description?: string, once?: boolean, condition?: (context: any) => boolean, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, isSubMeta?: boolean, isHidden?: boolean, getTagCallback?: ThrottleTagGetter | undefined, inputSchema?: Schema | undefined, validateInputContext?: boolean, outputSchema?: Schema | undefined, validateOutputContext?: boolean, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
     /**
      * Executes the process logic with the provided context, emit function, progress callback, and node data.
      *
@@ -1800,9 +1803,9 @@ interface TaskOptions {
     isSubMeta?: boolean;
     isHidden?: boolean;
     getTagCallback?: ThrottleTagGetter;
-    inputSchema?: SchemaDefinition;
+    inputSchema?: Schema;
     validateInputContext?: boolean;
-    outputSchema?: SchemaDefinition;
+    outputSchema?: Schema;
     validateOutputContext?: boolean;
     retryCount?: number;
     retryDelay?: number;
@@ -1897,7 +1900,7 @@ declare class Cadenza {
      * ```
      */
     static emit(event: string, data?: AnyObject, options?: EmitOptions): void;
-    static schedule(taskName: string, context: AnyObject, delayMs: number, exactDateTime?: Date): void;
+    static schedule(signalName: string, context: AnyObject, delayMs: number, exactDateTime?: Date): void;
     static interval(taskName: string, context: AnyObject, intervalMs: number, leading?: boolean, startDateTime?: Date): void;
     static debounce(signalName: string, context: any, delayMs: number): void;
     static get(taskName: string): Task | undefined;
@@ -2255,4 +2258,4 @@ declare class Cadenza {
     static reset(): void;
 }
 
-export { type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, type EmitOptions, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, InquiryBroker, type InquiryOptions, type Intent, type SchemaConstraints, type SchemaDefinition, type SchemaType, SignalBroker, SignalEmitter, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default };
+export { type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, type EmitOptions, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, InquiryBroker, type InquiryOptions, type Intent, type Schema, type SchemaConstraints, type SchemaDefinition, type SchemaType, SignalBroker, SignalEmitter, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default };

package/dist/index.js

@@ -1309,6 +1309,36 @@ var SignalBroker = class _SignalBroker {
   setVerbose(value) {
     this.verbose = value;
   }
+  // Dor debugging
+  logMemoryFootprint(label = "current") {
+    console.log(`[${label}] SignalBroker state sizes:`);
+    console.log(`  \u2022 signalObservers entries: ${this.signalObservers.size}`);
+    console.log(
+      `  \u2022 emittedSignalsRegistry size: ${this.emittedSignalsRegistry.size}`
+    );
+    let totalSquashContexts = 0;
+    let totalSquashGroups = 0;
+    for (const groups of this.strategyData.values()) {
+      totalSquashGroups += groups.size;
+      for (const data of groups.values()) {
+        totalSquashContexts += data.contexts.length;
+      }
+    }
+    console.log(`  \u2022 Active squash groups: ${totalSquashGroups}`);
+    console.log(`  \u2022 Total queued squash contexts: ${totalSquashContexts}`);
+    let totalDebouncers = this.debouncedEmitters.size;
+    console.log(`  \u2022 Active debouncers: ${totalDebouncers}`);
+    let totalThrottleQueues = 0;
+    for (const q of this.throttleQueues.values()) {
+      totalThrottleQueues += q.length;
+    }
+    console.log(`  \u2022 Total items in throttle queues: ${totalThrottleQueues}`);
+    let totalScheduled = 0;
+    for (const bucket of this.scheduledBuckets.values()) {
+      totalScheduled += bucket.length;
+    }
+    console.log(`  \u2022 Pending scheduled items: ${totalScheduled}`);
+  }
   /**
    * Validates the provided signal name string to ensure it adheres to specific formatting rules.
    * Throws an error if any of the validation checks fail.
@@ -1504,7 +1534,8 @@ var SignalBroker = class _SignalBroker {
       delay = options.exactDateTime.getTime() - Date.now();
     }
     delay = Math.max(0, delay);
-    const bucketKey = Math.ceil(delay / 100) * 100;
+    const dueAt = Date.now() + delay;
+    const bucketKey = Math.ceil(dueAt / 100) * 100;
     let bucket = this.scheduledBuckets.get(bucketKey);
     if (!bucket) {
       bucket = [];
@@ -3609,9 +3640,9 @@ var Task = class _Task extends SignalEmitter {
    * @param {boolean} [isSubMeta=false] - Indicates if the task is a sub-meta-task.
    * @param {boolean} [isHidden=false] - Determines if the task is hidden and not exposed publicly.
    * @param {ThrottleTagGetter} [getTagCallback=undefined] - A callback to generate a throttle tag for the task.
-   * @param {SchemaDefinition} [inputSchema=undefined] - The input schema for validating the task's input context.
+   * @param {Schema} [inputSchema=undefined] - The input schema for validating the task's input context.
    * @param {boolean} [validateInputContext=false] - Specifies if the input context should be validated against the input schema.
-   * @param {SchemaDefinition} [outputSchema=undefined] - The output schema for validating the task's output context.
+   * @param {Schema} [outputSchema=undefined] - The output schema for validating the task's output context.
    * @param {boolean} [validateOutputContext=false] - Specifies if the output context should be validated against the output schema.
    * @param {number} [retryCount=0] - The number of retry attempts allowed for the task in case of failure.
    * @param {number} [retryDelay=0] - The initial delay (in milliseconds) between retry attempts.
@@ -3856,14 +3887,27 @@ var Task = class _Task extends SignalEmitter {
    * Validates a data object against a specified schema definition and returns validation results.
    *
    * @param {any} data - The target object to validate against the schema.
-   * @param {SchemaDefinition | undefined} schema - The schema definition describing the expected structure and constraints of the data.
+   * @param {Schema | undefined} schema - The schema definition describing the expected structure and constraints of the data.
    * @param {string} [path="context"] - The base path or context for traversing the data, used in generating error messages.
    * @return {{ valid: boolean, errors: Record<string, string> }} - An object containing a validity flag (`valid`)
    * and a map (`errors`) of validation error messages keyed by property paths.
    */
   validateSchema(data, schema, path = "context") {
     const errors = {};
-    if (!schema || typeof schema !== "object") return { valid: true, errors };
+    if (!schema || typeof schema !== "object" && !Array.isArray(schema))
+      return { valid: true, errors };
+    if (Array.isArray(schema)) {
+      for (const s of schema) {
+        const subValidation = this.validateSchema(data, s, path);
+        if (!subValidation.valid) {
+          Object.assign(errors, subValidation.errors);
+        }
+        if (subValidation.valid) {
+          return { valid: true, errors: {} };
+        }
+      }
+      return { valid: false, errors };
+    }
     const required = schema.required || [];
     for (const key of required) {
       if (!(key in data)) {
@@ -3874,84 +3918,12 @@ var Task = class _Task extends SignalEmitter {
     for (const [key, value] of Object.entries(data)) {
       if (key in properties) {
         const prop = properties[key];
-        const propType = prop.type;
-        if (propType === "any") {
-          continue;
-        }
-        if ((value === void 0 || value === null) && !prop.strict) {
-          continue;
-        }
-        if (propType === "string" && typeof value !== "string") {
-          errors[`${path}.${key}`] = `Expected 'string' for '${key}', got '${typeof value}'`;
-        } else if (propType === "number" && typeof value !== "number") {
-          errors[`${path}.${key}`] = `Expected 'number' for '${key}', got '${typeof value}'`;
-        } else if (propType === "boolean" && typeof value !== "boolean") {
-          errors[`${path}.${key}`] = `Expected 'boolean' for '${key}', got '${typeof value}'`;
-        } else if (propType === "array" && !Array.isArray(value)) {
-          errors[`${path}.${key}`] = `Expected 'array' for '${key}', got '${typeof value}'`;
-        } else if (propType === "object" && (typeof value !== "object" || value === null || Array.isArray(value))) {
-          errors[`${path}.${key}`] = `Expected 'object' for '${key}', got '${typeof value}'`;
-        } else if (propType === "array" && prop.items) {
-          if (Array.isArray(value)) {
-            value.forEach((item, index) => {
-              const subValidation = this.validateSchema(
-                item,
-                prop.items,
-                `${path}.${key}[${index}]`
-              );
-              if (!subValidation.valid) {
-                Object.assign(errors, subValidation.errors);
-              }
-            });
-          }
-        } else if (propType === "object" && !Array.isArray(value) && value !== null) {
-          const subValidation = this.validateSchema(
-            value,
-            prop,
-            `${path}.${key}`
-          );
-          if (!subValidation.valid) {
-            Object.assign(errors, subValidation.errors);
-          }
-        }
-        const constraints = prop.constraints || {};
-        if (typeof value === "string") {
-          if (constraints.minLength && value.length < constraints.minLength) {
-            errors[`${path}.${key}`] = `String '${key}' shorter than minLength ${constraints.minLength}`;
-          }
-          if (constraints.maxLength && value.length > constraints.maxLength) {
-            errors[`${path}.${key}`] = `String '${key}' exceeds maxLength ${constraints.maxLength}`;
-          }
-          if (constraints.pattern && !new RegExp(constraints.pattern).test(value)) {
-            errors[`${path}.${key}`] = `String '${key}' does not match pattern ${constraints.pattern}`;
-          }
-        } else if (typeof value === "number") {
-          if (constraints.min && value < constraints.min) {
-            errors[`${path}.${key}`] = `Number '${key}' below min ${constraints.min}`;
+        if (Array.isArray(prop)) {
+          for (const p of prop) {
+            Object.assign(errors, this.validateProp(p, key, value, path));
           }
-          if (constraints.max && value > constraints.max) {
-            errors[`${path}.${key}`] = `Number '${key}' exceeds max ${constraints.max}`;
-          }
-          if (constraints.multipleOf && value % constraints.multipleOf !== 0) {
-            errors[`${path}.${key}`] = `Number '${key}' not multiple of ${constraints.multipleOf}`;
-          }
-        } else if (constraints.enum && !constraints.enum.includes(value)) {
-          errors[`${path}.${key}`] = `Value '${value}' for '${key}' not in enum ${JSON.stringify(constraints.enum)}`;
-        } else if (constraints.format) {
-          const formats = {
-            email: /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/,
-            url: /^(https?|ftp):\/\/[^\s/$.?#].[^\s]*$/,
-            "date-time": /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})?$/,
-            uuid: /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
-            custom: /.*/
-            // Placeholder; override with prop.constraints.pattern if present
-          };
-          const regex = formats[constraints.format] || new RegExp(constraints.pattern || ".*");
-          if (typeof value === "string" && !regex.test(value)) {
-            errors[`${path}.${key}`] = `Value '${value}' for '${key}' does not match format '${constraints.format}'`;
-          }
-        } else if (constraints.oneOf && !constraints.oneOf.includes(value)) {
-          errors[`${path}.${key}`] = `Value '${value}' for '${key}' not in oneOf ${JSON.stringify(constraints.oneOf)}`;
+        } else {
+          Object.assign(errors, this.validateProp(prop, key, value, path));
         }
       } else if (schema.strict) {
         errors[`${path}.${key}`] = `Key '${key}' is not allowed`;
@@ -3962,6 +3934,83 @@ var Task = class _Task extends SignalEmitter {
     }
     return { valid: true, errors: {} };
   }
+  validateProp(prop, key, value, path = "context") {
+    const propType = prop.type;
+    const errors = {};
+    if (propType === "any") {
+      return errors;
+    }
+    if ((value === void 0 || value === null) && !prop.strict) {
+      return errors;
+    }
+    if (propType === "string" && typeof value !== "string") {
+      errors[`${path}.${key}`] = `Expected 'string' for '${key}', got '${typeof value}'`;
+    } else if (propType === "number" && typeof value !== "number") {
+      errors[`${path}.${key}`] = `Expected 'number' for '${key}', got '${typeof value}'`;
+    } else if (propType === "boolean" && typeof value !== "boolean") {
+      errors[`${path}.${key}`] = `Expected 'boolean' for '${key}', got '${typeof value}'`;
+    } else if (propType === "array" && !Array.isArray(value)) {
+      errors[`${path}.${key}`] = `Expected 'array' for '${key}', got '${typeof value}'`;
+    } else if (propType === "object" && (typeof value !== "object" || value === null || Array.isArray(value))) {
+      errors[`${path}.${key}`] = `Expected 'object' for '${key}', got '${typeof value}'`;
+    } else if (propType === "array" && prop.items) {
+      value.forEach((item, index) => {
+        const subValidation = this.validateSchema(
+          item,
+          prop.items,
+          `${path}.${key}[${index}]`
+        );
+        if (!subValidation.valid) {
+          Object.assign(errors, subValidation.errors);
+        }
+      });
+    } else if (propType === "object" && !Array.isArray(value) && value !== null) {
+      const subValidation = this.validateSchema(value, prop, `${path}.${key}`);
+      if (!subValidation.valid) {
+        Object.assign(errors, subValidation.errors);
+      }
+    }
+    const constraints = prop.constraints || {};
+    if (typeof value === "string") {
+      if (constraints.minLength && value.length < constraints.minLength) {
+        errors[`${path}.${key}`] = `String '${key}' shorter than minLength ${constraints.minLength}`;
+      }
+      if (constraints.maxLength && value.length > constraints.maxLength) {
+        errors[`${path}.${key}`] = `String '${key}' exceeds maxLength ${constraints.maxLength}`;
+      }
+      if (constraints.pattern && !new RegExp(constraints.pattern).test(value)) {
+        errors[`${path}.${key}`] = `String '${key}' does not match pattern ${constraints.pattern}`;
+      }
+    } else if (typeof value === "number") {
+      if (constraints.min && value < constraints.min) {
+        errors[`${path}.${key}`] = `Number '${key}' below min ${constraints.min}`;
+      }
+      if (constraints.max && value > constraints.max) {
+        errors[`${path}.${key}`] = `Number '${key}' exceeds max ${constraints.max}`;
+      }
+      if (constraints.multipleOf && value % constraints.multipleOf !== 0) {
+        errors[`${path}.${key}`] = `Number '${key}' not multiple of ${constraints.multipleOf}`;
+      }
+    } else if (constraints.enum && !constraints.enum.includes(value)) {
+      errors[`${path}.${key}`] = `Value '${value}' for '${key}' not in enum ${JSON.stringify(constraints.enum)}`;
+    } else if (constraints.format) {
+      const formats = {
+        email: /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/,
+        url: /^(https?|ftp):\/\/[^\s/$.?#].[^\s]*$/,
+        "date-time": /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})?$/,
+        uuid: /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/,
+        custom: /.*/
+        // Placeholder; override with prop.constraints.pattern if present
+      };
+      const regex = formats[constraints.format] || new RegExp(constraints.pattern || ".*");
+      if (typeof value === "string" && !regex.test(value)) {
+        errors[`${path}.${key}`] = `Value '${value}' for '${key}' does not match format '${constraints.format}'`;
+      }
+    } else if (constraints.oneOf && !constraints.oneOf.includes(value)) {
+      errors[`${path}.${key}`] = `Value '${value}' for '${key}' not in oneOf ${JSON.stringify(constraints.oneOf)}`;
+    }
+    return errors;
+  }
   /**
    * Validates the input context against the predefined schema and emits metadata if validation fails.
    *
@@ -6004,8 +6053,11 @@ var Cadenza = class {
   static emit(event, data = {}, options = {}) {
     this.signalBroker?.emit(event, data, options);
   }
-  static schedule(taskName, context, delayMs, exactDateTime) {
-    this.signalBroker?.schedule(taskName, context, { delayMs, exactDateTime });
+  static schedule(signalName, context, delayMs, exactDateTime) {
+    this.signalBroker?.schedule(signalName, context, {
+      delayMs,
+      exactDateTime
+    });
   }
   static interval(taskName, context, intervalMs, leading = false, startDateTime) {
     this.signalBroker?.interval(