@cadenza.io/core 3.17.1 → 3.18.0

package/dist/index.d.mts

@@ -319,6 +319,81 @@ declare abstract class GraphLayer extends ExecutionChain implements Graph {
     log(): void;
 }
 
+type SchemaType = "string" | "number" | "boolean" | "array" | "object" | "any";
+type SchemaConstraints = {
+    min?: number;
+    max?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    enum?: any[];
+    multipleOf?: number;
+    format?: "email" | "url" | "date-time" | "uuid" | "custom";
+    oneOf?: any[];
+};
+type SchemaDefinition = {
+    type: SchemaType;
+    required?: string[];
+    properties?: {
+        [key: string]: SchemaDefinition;
+    };
+    items?: SchemaDefinition;
+    constraints?: SchemaConstraints;
+    description?: string;
+    strict?: boolean;
+};
+
+interface Intent {
+    name: string;
+    description?: string;
+    input?: SchemaDefinition;
+    output?: SchemaDefinition;
+}
+interface InquiryOptions {
+    timeout: number;
+}
+declare class InquiryBroker extends SignalEmitter {
+    static instance_: InquiryBroker;
+    static get instance(): InquiryBroker;
+    debug: boolean;
+    verbose: boolean;
+    setDebug(value: boolean): void;
+    setVerbose(value: boolean): void;
+    validateInquiryName(inquiryName: string): void;
+    runner: GraphRunner | undefined;
+    metaRunner: GraphRunner | undefined;
+    inquiryObservers: Map<string, {
+        fn: (runner: GraphRunner, tasks: Task[], context: AnyObject) => void;
+        tasks: Set<Task>;
+        registered: boolean;
+    }>;
+    intents: Map<string, Intent>;
+    /**
+     * Initializes with runners.
+     * @param runner Standard runner for user signals.
+     * @param metaRunner Meta runner for 'meta.' signals (suppresses further meta-emits).
+     */
+    bootstrap(runner: GraphRunner, metaRunner: GraphRunner): void;
+    init(): void;
+    /**
+     * Observes an inquiry with a routine/task.
+     * @param inquiry The inquiry (e.g., 'domain.action', 'domain.*' for wildcards).
+     * @param task The observer.
+     * @edge Duplicates ignored; supports wildcards for broad listening.
+     */
+    observe(inquiry: string, task: Task): void;
+    /**
+     * Unsubscribes a routine/task from an inquiry.
+     * @param inquiry The inquiry.
+     * @param task The observer.
+     * @edge Removes all instances if duplicate; deletes if empty.
+     */
+    unsubscribe(inquiry: string, task: Task): void;
+    addInquiry(inquiry: string): void;
+    addIntent(intent: Intent): void;
+    inquire(inquiry: string, context: AnyObject, options?: InquiryOptions): Promise<AnyObject>;
+}
+
 /**
  * Represents a node in a graph structure used for executing tasks.
  * A Node is a container for a task and its associated context, providing
@@ -474,6 +549,7 @@ declare class GraphNode extends SignalEmitter implements Graph {
      * failure and error propagation.
      */
     work(): TaskResult | Promise<TaskResult>;
+    inquire(inquiry: string, context: AnyObject, options: InquiryOptions): Promise<any>;
     /**
      * Emits a signal along with its associated metadata. The metadata includes
      * task-specific information such as task name, version, execution ID, and
@@ -748,31 +824,7 @@ declare class TaskIterator implements Iterator {
     next(): Task | undefined;
 }
 
-type SchemaType = "string" | "number" | "boolean" | "array" | "object" | "any";
-type SchemaConstraints = {
-    min?: number;
-    max?: number;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-    enum?: any[];
-    multipleOf?: number;
-    format?: "email" | "url" | "date-time" | "uuid" | "custom";
-    oneOf?: any[];
-};
-type SchemaDefinition = {
-    type: SchemaType;
-    required?: string[];
-    properties?: {
-        [key: string]: SchemaDefinition;
-    };
-    items?: SchemaDefinition;
-    constraints?: SchemaConstraints;
-    description?: string;
-    strict?: boolean;
-};
-
-type TaskFunction = (context: AnyObject, emit: (signal: string, context: AnyObject) => void, progressCallback: (progress: number) => void) => TaskResult;
+type TaskFunction = (context: AnyObject, emit: (signal: string, context: AnyObject) => void, inquire: (inquiry: string, context: AnyObject, options: InquiryOptions) => Promise<AnyObject>, progressCallback: (progress: number) => void) => TaskResult;
 type TaskResult = boolean | AnyObject | Generator | Promise<any> | void;
 type ThrottleTagGetter = (context?: AnyObject, task?: Task) => string;
 /**
@@ -817,7 +869,8 @@ declare class Task extends SignalEmitter implements Graph {
     signalsToEmitAfter: Set<string>;
     signalsToEmitOnFail: Set<string>;
     observedSignals: Set<string>;
-    intents: Set<string>;
+    handlesIntents: Set<string>;
+    inquiresIntents: Set<string>;
     readonly taskFunction: TaskFunction;
     /**
      * Constructs an instance of the task with the specified properties and configuration options.
@@ -913,11 +966,12 @@ declare class Task extends SignalEmitter implements Graph {
      *
      * @param {GraphContext} context The execution context which provides data and functions necessary for the task.
      * @param {function(string, AnyObject): void} emit A function to emit signals and communicate intermediate results or states.
+     * @param {function(string, AnyObject, InquiryOptions): Promise<AnyObject>} inquire A function to inquire something from another task.
      * @param {function(number): void} progressCallback A callback function used to report task progress as a percentage (0 to 100).
      * @param {{ nodeId: string; routineExecId: string }} nodeData An object containing identifiers related to the node and execution routine.
      * @return {TaskResult} The result of the executed task.
      */
-    execute(context: GraphContext, emit: (signal: string, context: AnyObject) => void, progressCallback: (progress: number) => void, nodeData: {
+    execute(context: GraphContext, emit: (signal: string, context: AnyObject) => void, inquire: (inquiry: string, context: AnyObject, options: InquiryOptions) => Promise<AnyObject>, progressCallback: (progress: number) => void, nodeData: {
         nodeId: string;
         routineExecId: string;
     }): TaskResult;
@@ -1053,7 +1107,10 @@ declare class Task extends SignalEmitter implements Graph {
      * @return {this} Returns the current instance to allow method chaining.
      */
     detachAllSignals(): this;
-    handlesIntent(intent: string): this;
+    respondsTo(...inquires: string[]): this;
+    attachIntents(...intentNames: string[]): this;
+    detachIntents(...intentNames: string[]): this;
+    detachAllIntents(): this;
     /**
      * Maps over the signals in the `signalsToEmitAfter` set and applies a callback function to each signal.
      *
@@ -1404,7 +1461,7 @@ interface EmitOptions {
     squash?: boolean;
     squashId?: string | null;
     groupId?: string | null;
-    mergeFunction?: ((oldContext: AnyObject, newContext: AnyObject) => AnyObject) | null;
+    mergeFunction?: ((oldContext: AnyObject, ...newContext: AnyObject[]) => AnyObject) | null;
     debounce?: boolean;
     throttle?: boolean;
     delayMs?: number;
@@ -1437,7 +1494,7 @@ declare class SignalBroker {
     metaRunner: GraphRunner | undefined;
     debouncedEmitters: Map<string, any>;
     squashedEmitters: Map<string, any>;
-    squashedContexts: Map<string, any>;
+    squashedContexts: Map<string, any[]>;
     throttleEmitters: Map<string, any>;
     throttleQueues: Map<string, any>;
     getSignalsTask: Task | undefined;
@@ -1621,6 +1678,7 @@ declare class DebounceTask extends Task {
     lastTimeout: NodeJS.Timeout | null;
     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);
     /**
      * Executes the taskFunction with the provided context, emit function, and progress callback.
@@ -1641,19 +1699,21 @@ declare class DebounceTask extends Task {
      * @param {GraphContext} context - The execution context for the operation.
      * @param {NodeJS.Timeout} timeout - A timeout object for managing execution delays.
      * @param {Function} emit - A callback function to emit signals with a specific context.
+     * @param inquire
      * @param {Function} progressCallback - A callback function to report progress during operation execution.
      * @return {void} Does not return a value but sets internal timers and invokes provided callbacks.
      */
-    debouncedTrigger(resolve: (value: unknown) => void, reject: (reason?: any) => void, context: GraphContext, timeout: NodeJS.Timeout, emit: (signal: string, context: any) => void, progressCallback: (progress: number) => void): void;
+    debouncedTrigger(resolve: (value: unknown) => void, reject: (reason?: any) => void, context: GraphContext, timeout: NodeJS.Timeout, emit: (signal: string, context: any) => void, inquire: (inquiry: string, context: AnyObject, options: InquiryOptions) => Promise<AnyObject>, progressCallback: (progress: number) => void): void;
     /**
      * Executes a task with a debounced trigger mechanism.
      *
      * @param {GraphContext} context - The context containing relevant graph data for the execution.
      * @param {function(string, any): void} emit - A function used to emit signals with associated context.
+     * @param inquire
      * @param {function(number): void} progressCallback - A callback function to report the progress of the task as a number between 0 and 1.
      * @return {Promise<TaskResult>} A promise that resolves with the task result upon completion or rejects on failure.
      */
-    execute(context: GraphContext, emit: (signal: string, context: any) => void, progressCallback: (progress: number) => void): TaskResult;
+    execute(context: GraphContext, emit: (signal: string, context: any) => void, inquire: (inquiry: string, context: AnyObject, options: InquiryOptions) => Promise<AnyObject>, progressCallback: (progress: number) => void): TaskResult;
 }
 
 type EphemeralTaskOptions = {
@@ -1679,11 +1739,12 @@ declare class EphemeralTask extends Task {
      *
      * @param {any} context - The execution context, carrying necessary parameters or states for the operation.
      * @param {function(string, AnyObject): void} emit - A function to emit signals with a string identifier and associated context.
+     * @param inquire
      * @param {function(number): void} progressCallback - A callback function to report the progress of the execution as a numerical value.
      * @param {{ nodeId: string, routineExecId: string }} nodeData - An object containing details about the node ID and routine execution ID.
      * @return {any} The result of the execution, returned from the base implementation or processed internally.
      */
-    execute(context: any, emit: (signal: string, context: AnyObject) => void, progressCallback: (progress: number) => void, nodeData: {
+    execute(context: any, emit: (signal: string, context: AnyObject) => void, inquire: (inquiry: string, context: AnyObject, options: InquiryOptions) => Promise<AnyObject>, progressCallback: (progress: number) => void, nodeData: {
         nodeId: string;
         routineExecId: string;
     }): TaskResult;
@@ -1749,7 +1810,8 @@ type CadenzaMode = "dev" | "debug" | "verbose" | "production";
  * utility methods to create, register, and manage various task types.
  */
 declare class Cadenza {
-    static broker: SignalBroker;
+    static signalBroker: SignalBroker;
+    static inquiryBroker: InquiryBroker;
     static runner: GraphRunner;
     static metaRunner: GraphRunner;
     static registry: GraphRegistry;
@@ -1834,6 +1896,8 @@ declare class Cadenza {
     static debounce(signalName: string, context: any, delayMs: number): void;
     static get(taskName: string): Task | undefined;
     static getRoutine(routineName: string): GraphRoutine | undefined;
+    static defineIntent(intent: Intent): Intent;
+    static inquire(inquiry: string, context: AnyObject, options?: InquiryOptions): Promise<any>;
     /**
      * Creates and registers a new task with the specified parameters and options.
      * Tasks are the basic building blocks of Cadenza graphs and are responsible for executing logic.
@@ -2185,8 +2249,4 @@ declare class Cadenza {
     static reset(): void;
 }
 
-declare class SignalTask extends Task {
-    constructor(signal: string, description?: string);
-}
-
-export { type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, type EmitOptions, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, type SchemaConstraints, type SchemaDefinition, type SchemaType, SignalBroker, SignalEmitter, SignalTask, 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, 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

@@ -319,6 +319,81 @@ declare abstract class GraphLayer extends ExecutionChain implements Graph {
     log(): void;
 }
 
+type SchemaType = "string" | "number" | "boolean" | "array" | "object" | "any";
+type SchemaConstraints = {
+    min?: number;
+    max?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    enum?: any[];
+    multipleOf?: number;
+    format?: "email" | "url" | "date-time" | "uuid" | "custom";
+    oneOf?: any[];
+};
+type SchemaDefinition = {
+    type: SchemaType;
+    required?: string[];
+    properties?: {
+        [key: string]: SchemaDefinition;
+    };
+    items?: SchemaDefinition;
+    constraints?: SchemaConstraints;
+    description?: string;
+    strict?: boolean;
+};
+
+interface Intent {
+    name: string;
+    description?: string;
+    input?: SchemaDefinition;
+    output?: SchemaDefinition;
+}
+interface InquiryOptions {
+    timeout: number;
+}
+declare class InquiryBroker extends SignalEmitter {
+    static instance_: InquiryBroker;
+    static get instance(): InquiryBroker;
+    debug: boolean;
+    verbose: boolean;
+    setDebug(value: boolean): void;
+    setVerbose(value: boolean): void;
+    validateInquiryName(inquiryName: string): void;
+    runner: GraphRunner | undefined;
+    metaRunner: GraphRunner | undefined;
+    inquiryObservers: Map<string, {
+        fn: (runner: GraphRunner, tasks: Task[], context: AnyObject) => void;
+        tasks: Set<Task>;
+        registered: boolean;
+    }>;
+    intents: Map<string, Intent>;
+    /**
+     * Initializes with runners.
+     * @param runner Standard runner for user signals.
+     * @param metaRunner Meta runner for 'meta.' signals (suppresses further meta-emits).
+     */
+    bootstrap(runner: GraphRunner, metaRunner: GraphRunner): void;
+    init(): void;
+    /**
+     * Observes an inquiry with a routine/task.
+     * @param inquiry The inquiry (e.g., 'domain.action', 'domain.*' for wildcards).
+     * @param task The observer.
+     * @edge Duplicates ignored; supports wildcards for broad listening.
+     */
+    observe(inquiry: string, task: Task): void;
+    /**
+     * Unsubscribes a routine/task from an inquiry.
+     * @param inquiry The inquiry.
+     * @param task The observer.
+     * @edge Removes all instances if duplicate; deletes if empty.
+     */
+    unsubscribe(inquiry: string, task: Task): void;
+    addInquiry(inquiry: string): void;
+    addIntent(intent: Intent): void;
+    inquire(inquiry: string, context: AnyObject, options?: InquiryOptions): Promise<AnyObject>;
+}
+
 /**
  * Represents a node in a graph structure used for executing tasks.
  * A Node is a container for a task and its associated context, providing
@@ -474,6 +549,7 @@ declare class GraphNode extends SignalEmitter implements Graph {
      * failure and error propagation.
      */
     work(): TaskResult | Promise<TaskResult>;
+    inquire(inquiry: string, context: AnyObject, options: InquiryOptions): Promise<any>;
     /**
      * Emits a signal along with its associated metadata. The metadata includes
      * task-specific information such as task name, version, execution ID, and
@@ -748,31 +824,7 @@ declare class TaskIterator implements Iterator {
     next(): Task | undefined;
 }
 
-type SchemaType = "string" | "number" | "boolean" | "array" | "object" | "any";
-type SchemaConstraints = {
-    min?: number;
-    max?: number;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-    enum?: any[];
-    multipleOf?: number;
-    format?: "email" | "url" | "date-time" | "uuid" | "custom";
-    oneOf?: any[];
-};
-type SchemaDefinition = {
-    type: SchemaType;
-    required?: string[];
-    properties?: {
-        [key: string]: SchemaDefinition;
-    };
-    items?: SchemaDefinition;
-    constraints?: SchemaConstraints;
-    description?: string;
-    strict?: boolean;
-};
-
-type TaskFunction = (context: AnyObject, emit: (signal: string, context: AnyObject) => void, progressCallback: (progress: number) => void) => TaskResult;
+type TaskFunction = (context: AnyObject, emit: (signal: string, context: AnyObject) => void, inquire: (inquiry: string, context: AnyObject, options: InquiryOptions) => Promise<AnyObject>, progressCallback: (progress: number) => void) => TaskResult;
 type TaskResult = boolean | AnyObject | Generator | Promise<any> | void;
 type ThrottleTagGetter = (context?: AnyObject, task?: Task) => string;
 /**
@@ -817,7 +869,8 @@ declare class Task extends SignalEmitter implements Graph {
     signalsToEmitAfter: Set<string>;
     signalsToEmitOnFail: Set<string>;
     observedSignals: Set<string>;
-    intents: Set<string>;
+    handlesIntents: Set<string>;
+    inquiresIntents: Set<string>;
     readonly taskFunction: TaskFunction;
     /**
      * Constructs an instance of the task with the specified properties and configuration options.
@@ -913,11 +966,12 @@ declare class Task extends SignalEmitter implements Graph {
      *
      * @param {GraphContext} context The execution context which provides data and functions necessary for the task.
      * @param {function(string, AnyObject): void} emit A function to emit signals and communicate intermediate results or states.
+     * @param {function(string, AnyObject, InquiryOptions): Promise<AnyObject>} inquire A function to inquire something from another task.
      * @param {function(number): void} progressCallback A callback function used to report task progress as a percentage (0 to 100).
      * @param {{ nodeId: string; routineExecId: string }} nodeData An object containing identifiers related to the node and execution routine.
      * @return {TaskResult} The result of the executed task.
      */
-    execute(context: GraphContext, emit: (signal: string, context: AnyObject) => void, progressCallback: (progress: number) => void, nodeData: {
+    execute(context: GraphContext, emit: (signal: string, context: AnyObject) => void, inquire: (inquiry: string, context: AnyObject, options: InquiryOptions) => Promise<AnyObject>, progressCallback: (progress: number) => void, nodeData: {
         nodeId: string;
         routineExecId: string;
     }): TaskResult;
@@ -1053,7 +1107,10 @@ declare class Task extends SignalEmitter implements Graph {
      * @return {this} Returns the current instance to allow method chaining.
      */
     detachAllSignals(): this;
-    handlesIntent(intent: string): this;
+    respondsTo(...inquires: string[]): this;
+    attachIntents(...intentNames: string[]): this;
+    detachIntents(...intentNames: string[]): this;
+    detachAllIntents(): this;
     /**
      * Maps over the signals in the `signalsToEmitAfter` set and applies a callback function to each signal.
      *
@@ -1404,7 +1461,7 @@ interface EmitOptions {
     squash?: boolean;
     squashId?: string | null;
     groupId?: string | null;
-    mergeFunction?: ((oldContext: AnyObject, newContext: AnyObject) => AnyObject) | null;
+    mergeFunction?: ((oldContext: AnyObject, ...newContext: AnyObject[]) => AnyObject) | null;
     debounce?: boolean;
     throttle?: boolean;
     delayMs?: number;
@@ -1437,7 +1494,7 @@ declare class SignalBroker {
     metaRunner: GraphRunner | undefined;
     debouncedEmitters: Map<string, any>;
     squashedEmitters: Map<string, any>;
-    squashedContexts: Map<string, any>;
+    squashedContexts: Map<string, any[]>;
     throttleEmitters: Map<string, any>;
     throttleQueues: Map<string, any>;
     getSignalsTask: Task | undefined;
@@ -1621,6 +1678,7 @@ declare class DebounceTask extends Task {
     lastTimeout: NodeJS.Timeout | null;
     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);
     /**
      * Executes the taskFunction with the provided context, emit function, and progress callback.
@@ -1641,19 +1699,21 @@ declare class DebounceTask extends Task {
      * @param {GraphContext} context - The execution context for the operation.
      * @param {NodeJS.Timeout} timeout - A timeout object for managing execution delays.
      * @param {Function} emit - A callback function to emit signals with a specific context.
+     * @param inquire
      * @param {Function} progressCallback - A callback function to report progress during operation execution.
      * @return {void} Does not return a value but sets internal timers and invokes provided callbacks.
      */
-    debouncedTrigger(resolve: (value: unknown) => void, reject: (reason?: any) => void, context: GraphContext, timeout: NodeJS.Timeout, emit: (signal: string, context: any) => void, progressCallback: (progress: number) => void): void;
+    debouncedTrigger(resolve: (value: unknown) => void, reject: (reason?: any) => void, context: GraphContext, timeout: NodeJS.Timeout, emit: (signal: string, context: any) => void, inquire: (inquiry: string, context: AnyObject, options: InquiryOptions) => Promise<AnyObject>, progressCallback: (progress: number) => void): void;
     /**
      * Executes a task with a debounced trigger mechanism.
      *
      * @param {GraphContext} context - The context containing relevant graph data for the execution.
      * @param {function(string, any): void} emit - A function used to emit signals with associated context.
+     * @param inquire
      * @param {function(number): void} progressCallback - A callback function to report the progress of the task as a number between 0 and 1.
      * @return {Promise<TaskResult>} A promise that resolves with the task result upon completion or rejects on failure.
      */
-    execute(context: GraphContext, emit: (signal: string, context: any) => void, progressCallback: (progress: number) => void): TaskResult;
+    execute(context: GraphContext, emit: (signal: string, context: any) => void, inquire: (inquiry: string, context: AnyObject, options: InquiryOptions) => Promise<AnyObject>, progressCallback: (progress: number) => void): TaskResult;
 }
 
 type EphemeralTaskOptions = {
@@ -1679,11 +1739,12 @@ declare class EphemeralTask extends Task {
      *
      * @param {any} context - The execution context, carrying necessary parameters or states for the operation.
      * @param {function(string, AnyObject): void} emit - A function to emit signals with a string identifier and associated context.
+     * @param inquire
      * @param {function(number): void} progressCallback - A callback function to report the progress of the execution as a numerical value.
      * @param {{ nodeId: string, routineExecId: string }} nodeData - An object containing details about the node ID and routine execution ID.
      * @return {any} The result of the execution, returned from the base implementation or processed internally.
      */
-    execute(context: any, emit: (signal: string, context: AnyObject) => void, progressCallback: (progress: number) => void, nodeData: {
+    execute(context: any, emit: (signal: string, context: AnyObject) => void, inquire: (inquiry: string, context: AnyObject, options: InquiryOptions) => Promise<AnyObject>, progressCallback: (progress: number) => void, nodeData: {
         nodeId: string;
         routineExecId: string;
     }): TaskResult;
@@ -1749,7 +1810,8 @@ type CadenzaMode = "dev" | "debug" | "verbose" | "production";
  * utility methods to create, register, and manage various task types.
  */
 declare class Cadenza {
-    static broker: SignalBroker;
+    static signalBroker: SignalBroker;
+    static inquiryBroker: InquiryBroker;
     static runner: GraphRunner;
     static metaRunner: GraphRunner;
     static registry: GraphRegistry;
@@ -1834,6 +1896,8 @@ declare class Cadenza {
     static debounce(signalName: string, context: any, delayMs: number): void;
     static get(taskName: string): Task | undefined;
     static getRoutine(routineName: string): GraphRoutine | undefined;
+    static defineIntent(intent: Intent): Intent;
+    static inquire(inquiry: string, context: AnyObject, options?: InquiryOptions): Promise<any>;
     /**
      * Creates and registers a new task with the specified parameters and options.
      * Tasks are the basic building blocks of Cadenza graphs and are responsible for executing logic.
@@ -2185,8 +2249,4 @@ declare class Cadenza {
     static reset(): void;
 }
 
-declare class SignalTask extends Task {
-    constructor(signal: string, description?: string);
-}
-
-export { type AnyObject, type CadenzaMode, type DebounceOptions, DebounceTask, type EmitOptions, EphemeralTask, type EphemeralTaskOptions, GraphContext, GraphRegistry, GraphRoutine, GraphRun, GraphRunner, type SchemaConstraints, type SchemaDefinition, type SchemaType, SignalBroker, SignalEmitter, SignalTask, 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, type SchemaConstraints, type SchemaDefinition, type SchemaType, SignalBroker, SignalEmitter, Task, type TaskFunction, type TaskOptions, type TaskResult, type ThrottleTagGetter, Cadenza as default };