@ai.ntellect/core 0.7.1 → 0.7.4

package/dist/graph/index.d.ts

@@ -0,0 +1,157 @@
+import { ZodSchema } from "zod";
+import { GraphObservable } from "../interfaces";
+import { GraphContext, GraphDefinition, Node } from "../types";
+import { GraphObserver } from "./observer";
+/**
+ * @module GraphFlow
+ * @description A flexible workflow engine that manages the execution of nodes in a graph-like structure.
+ *
+ * Key features:
+ * - Multiple branches support
+ * - Conditional branching (runs first matching condition, or all if none have conditions)
+ * - Event-driven nodes
+ * - Zod validation of context/inputs/outputs
+ * - Automatic retry on node failures
+ *
+ * @template T - Extends ZodSchema for type validation
+ */
+export declare class GraphFlow<T extends ZodSchema> {
+    name: string;
+    private context;
+    validator?: T;
+    private eventEmitter;
+    private globalErrorHandler?;
+    private graphEvents?;
+    private entryNode?;
+    private verbose;
+    nodes: Map<string, Node<T, any>>;
+    private eventSubject;
+    private stateSubject;
+    private destroySubject;
+    observer: GraphObserver<T>;
+    private logger;
+    private eventManager;
+    private nodeExecutor;
+    /**
+     * Creates a new instance of GraphFlow
+     * @param {string} name - The name of the graph flow
+     * @param {GraphDefinition<T>} config - Configuration object containing nodes, schema, context, and error handlers
+     * @param {Object} options - Optional options for the graph flow
+     */
+    constructor(name: string, config: GraphDefinition<T>, options?: {
+        verbose?: boolean;
+    });
+    /**
+     * Sets up event listeners for node-based events
+     * @private
+     * @description Attaches all node-based event triggers while preserving external listeners
+     */
+    private setupEventStreams;
+    /**
+     * Sets up event listeners for node-based events
+     * @private
+     * @description Attaches all node-based event triggers while preserving external listeners
+     */
+    private setupEventListeners;
+    /**
+     * Sets up event listeners for graph-based events
+     * @private
+     * @description Attaches all graph-based event triggers
+     */
+    private setupGraphEventListeners;
+    /**
+     * Executes a specific node in the graph
+     * @private
+     * @param {string} nodeName - Name of the node to execute
+     * @param {GraphContext<T>} context - Current execution context
+     * @param {any} inputs - Input parameters for the node
+     * @param {boolean} triggeredByEvent - Whether the execution was triggered by an event
+     * @returns {Promise<void>}
+     */
+    private executeNode;
+    private addLog;
+    getLogs(): string[];
+    clearLogs(): void;
+    /**
+     * Get the observer instance for monitoring graph state and events
+     */
+    observe(options?: {
+        debounce?: number;
+        delay?: number;
+        stream?: boolean;
+        properties?: (keyof GraphContext<T> extends string ? keyof GraphContext<T> : never)[];
+        onStreamLetter?: (data: {
+            letter: string;
+            property: string;
+        }) => void;
+        onStreamComplete?: () => void;
+    }): GraphObservable<T>;
+    /**
+     * Enable or disable verbose logging
+     * @param {boolean} enabled - Whether to enable verbose logging
+     */
+    setVerbose(enabled: boolean): void;
+    /**
+     * Get current verbose setting
+     * @returns {boolean} Current verbose setting
+     */
+    isVerbose(): boolean;
+    /**
+     * Executes the graph flow starting from a specific node
+     * @param {string} startNode - Name of the node to start execution from
+     * @param {Partial<GraphContext<T>>} inputContext - Optional partial context to merge with current context
+     * @param {any} inputParams - Optional input parameters for the start node
+     * @returns {Promise<GraphContext<T>>} Final context after execution
+     */
+    execute(startNode: string, inputParams?: any, inputContext?: Partial<GraphContext<T>>): Promise<GraphContext<T>>;
+    /**
+     * Emits an event to trigger event-based nodes
+     * @param {string} eventName - Name of the event to emit
+     * @param {Partial<GraphContext<T>>} data - Optional data to merge with context
+     * @returns {Promise<void>}
+     */
+    emit(eventName: string, data?: Partial<GraphContext<T>>): Promise<void>;
+    /**
+     * Registers an event handler
+     * @param {string} eventName - Name of the event to listen for
+     * @param {Function} handler - Handler function to execute when event is emitted
+     */
+    on(eventName: string, handler: (...args: any[]) => void): void;
+    /**
+     * Updates the graph definition with new configuration
+     * @param {GraphDefinition<T>} definition - New graph definition
+     */
+    load(definition: GraphDefinition<T>): void;
+    /**
+     * Gets a copy of the current context
+     * @returns {GraphContext<T>} A deep copy of the current context
+     */
+    getContext(): GraphContext<T>;
+    /**
+     * Logs a message with optional data
+     * @param {string} message - Message to log
+     * @param {any} data - Optional data to log
+     */
+    log(message: string, data?: any): void;
+    /**
+     * Adds a new node to the graph
+     * @param {Node<T>} node - Node to add
+     * @throws {Error} If node with same name already exists
+     */
+    addNode(node: Node<T, any>): void;
+    /**
+     * Removes a node from the graph
+     * @param {string} nodeName - Name of the node to remove
+     */
+    removeNode(nodeName: string): void;
+    /**
+     * Returns all nodes in the graph
+     * @returns {Node<T>[]} Array of all nodes
+     */
+    getNodes(): Node<T, any>[];
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/graph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../graph/index.ts"],"names":[],"mappings":"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"}

package/dist/graph/index.js

@@ -0,0 +1,299 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphFlow = void 0;
+const events_1 = require("events");
+const rxjs_1 = require("rxjs");
+const event_manager_1 = require("./event-manager");
+const logger_1 = require("./logger");
+const node_1 = require("./node");
+const observer_1 = require("./observer");
+/**
+ * @module GraphFlow
+ * @description A flexible workflow engine that manages the execution of nodes in a graph-like structure.
+ *
+ * Key features:
+ * - Multiple branches support
+ * - Conditional branching (runs first matching condition, or all if none have conditions)
+ * - Event-driven nodes
+ * - Zod validation of context/inputs/outputs
+ * - Automatic retry on node failures
+ *
+ * @template T - Extends ZodSchema for type validation
+ */
+class GraphFlow {
+    /**
+     * Creates a new instance of GraphFlow
+     * @param {string} name - The name of the graph flow
+     * @param {GraphDefinition<T>} config - Configuration object containing nodes, schema, context, and error handlers
+     * @param {Object} options - Optional options for the graph flow
+     */
+    constructor(name, config, options = {}) {
+        var _a;
+        this.name = name;
+        this.verbose = false;
+        this.eventSubject = new rxjs_1.Subject();
+        this.destroySubject = new rxjs_1.Subject();
+        this.nodes = new Map(config.nodes.map((node) => [node.name, node]));
+        this.validator = config.schema;
+        this.context = config.schema.parse(config.context);
+        this.globalErrorHandler = config.onError;
+        this.eventEmitter =
+            config.eventEmitter || new events_1.EventEmitter();
+        this.graphEvents = config.events;
+        this.verbose = (_a = options.verbose) !== null && _a !== void 0 ? _a : false;
+        this.stateSubject = new rxjs_1.BehaviorSubject(this.context);
+        this.logger = new logger_1.GraphLogger(name, options.verbose);
+        this.eventManager = new event_manager_1.GraphEventManager(this.eventEmitter, this.nodes, name, this.context, config.events, config.entryNode, config.onError);
+        this.nodeExecutor = new node_1.GraphNode(this.nodes, this.logger, this.eventManager, this.eventSubject, this.stateSubject);
+        this.setupEventStreams();
+        this.setupEventListeners();
+        this.setupGraphEventListeners();
+        this.observer = new observer_1.GraphObserver(this, this.eventSubject, this.stateSubject, this.destroySubject);
+    }
+    /**
+     * Sets up event listeners for node-based events
+     * @private
+     * @description Attaches all node-based event triggers while preserving external listeners
+     */
+    setupEventStreams() {
+        this.eventManager.on("nodeStarted", (data) => {
+            this.addLog(`Event: Node "${data.name}" started`);
+        });
+        this.eventManager.on("nodeCompleted", (data) => {
+            this.addLog(`Event: Node "${data.name}" completed`);
+        });
+        this.eventManager.on("nodeError", (data) => {
+            var _a, _b;
+            let errorMessage = "Unknown error";
+            if (data.error) {
+                errorMessage =
+                    data.error instanceof Error
+                        ? data.error.message
+                        : ((_b = (_a = data.error.errors) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.message) ||
+                            data.error.message ||
+                            "Unknown error";
+            }
+            this.addLog(`Event: Node "${data.name}" error: ${errorMessage}`);
+        });
+        this.eventManager.on("nodeStateChanged", (data) => {
+            this.addLog(`Event: Node "${data.name}" state changed`);
+        });
+    }
+    /**
+     * Sets up event listeners for node-based events
+     * @private
+     * @description Attaches all node-based event triggers while preserving external listeners
+     */
+    setupEventListeners() {
+        this.eventManager.setupEventListeners();
+    }
+    /**
+     * Sets up event listeners for graph-based events
+     * @private
+     * @description Attaches all graph-based event triggers
+     */
+    setupGraphEventListeners() {
+        this.eventManager.setupGraphEventListeners();
+    }
+    /**
+     * Executes a specific node in the graph
+     * @private
+     * @param {string} nodeName - Name of the node to execute
+     * @param {GraphContext<T>} context - Current execution context
+     * @param {any} inputs - Input parameters for the node
+     * @param {boolean} triggeredByEvent - Whether the execution was triggered by an event
+     * @returns {Promise<void>}
+     */
+    executeNode(nodeName_1, context_1, inputs_1) {
+        return __awaiter(this, arguments, void 0, function* (nodeName, context, inputs, triggeredByEvent = false) {
+            return this.nodeExecutor.executeNode(nodeName, context, inputs, triggeredByEvent);
+        });
+    }
+    addLog(message) {
+        this.logger.addLog(message);
+    }
+    getLogs() {
+        return this.logger.getLogs();
+    }
+    clearLogs() {
+        this.logger.clearLogs();
+    }
+    /**
+     * Get the observer instance for monitoring graph state and events
+     */
+    observe(options = {}) {
+        return this.observer.state(options);
+    }
+    /**
+     * Enable or disable verbose logging
+     * @param {boolean} enabled - Whether to enable verbose logging
+     */
+    setVerbose(enabled) {
+        this.logger.setVerbose(enabled);
+    }
+    /**
+     * Get current verbose setting
+     * @returns {boolean} Current verbose setting
+     */
+    isVerbose() {
+        return this.logger.isVerbose();
+    }
+    /**
+     * Executes the graph flow starting from a specific node
+     * @param {string} startNode - Name of the node to start execution from
+     * @param {Partial<GraphContext<T>>} inputContext - Optional partial context to merge with current context
+     * @param {any} inputParams - Optional input parameters for the start node
+     * @returns {Promise<GraphContext<T>>} Final context after execution
+     */
+    execute(startNode, inputParams, inputContext) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            if (inputParams) {
+                Object.assign(this.context, inputParams);
+            }
+            if (inputContext) {
+                Object.assign(this.context, inputContext);
+            }
+            this.eventEmitter.emit("graphStarted", { name: this.name });
+            try {
+                yield this.nodeExecutor.executeNode(startNode, this.context, inputParams, false);
+                this.eventEmitter.emit("graphCompleted", {
+                    name: this.name,
+                    context: this.context,
+                });
+                return this.getContext();
+            }
+            catch (error) {
+                this.eventEmitter.emit("graphError", { name: this.name, error });
+                (_a = this.globalErrorHandler) === null || _a === void 0 ? void 0 : _a.call(this, error, this.context);
+                throw error;
+            }
+        });
+    }
+    /**
+     * Emits an event to trigger event-based nodes
+     * @param {string} eventName - Name of the event to emit
+     * @param {Partial<GraphContext<T>>} data - Optional data to merge with context
+     * @returns {Promise<void>}
+     */
+    emit(eventName, data) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const event = {
+                type: eventName,
+                payload: data,
+                timestamp: Date.now(),
+            };
+            this.eventSubject.next(event);
+            yield new Promise((resolve) => setTimeout(resolve, 0));
+        });
+    }
+    /**
+     * Registers an event handler
+     * @param {string} eventName - Name of the event to listen for
+     * @param {Function} handler - Handler function to execute when event is emitted
+     */
+    on(eventName, handler) {
+        this.eventManager.on(eventName, handler);
+    }
+    /**
+     * Updates the graph definition with new configuration
+     * @param {GraphDefinition<T>} definition - New graph definition
+     */
+    load(definition) {
+        var _a;
+        // Clear all existing nodes
+        this.nodes.clear();
+        // Wipe out old node-based event listeners
+        // (We keep external test listeners like "nodeStarted" or "nodeCompleted".)
+        if ((_a = definition.nodes) === null || _a === void 0 ? void 0 : _a.length) {
+            const allEvents = new Set();
+            definition.nodes.forEach((n) => { var _a; return (_a = n.events) === null || _a === void 0 ? void 0 : _a.forEach((evt) => allEvents.add(evt)); });
+            for (const evt of allEvents) {
+                this.eventEmitter.removeAllListeners(evt);
+            }
+        }
+        // Add in new nodes
+        definition.nodes.forEach((node) => this.nodes.set(node.name, node));
+        // Parse the new context
+        this.context = definition.schema.parse(definition.context);
+        this.validator = definition.schema;
+        // Store entry node
+        this.entryNode = definition.entryNode;
+        // Store graph events
+        this.graphEvents = definition.events;
+        // Re-setup only node-based event triggers
+        for (const node of this.nodes.values()) {
+            if (node.events && node.events.length > 0) {
+                node.events.forEach((event) => {
+                    this.eventEmitter.on(event, (data) => __awaiter(this, void 0, void 0, function* () {
+                        const freshContext = structuredClone(this.context);
+                        if (data)
+                            Object.assign(freshContext, data);
+                        yield this.executeNode(node.name, freshContext, undefined, true);
+                    }));
+                });
+            }
+        }
+        // Re-setup graph event listeners
+        this.setupGraphEventListeners();
+    }
+    /**
+     * Gets a copy of the current context
+     * @returns {GraphContext<T>} A deep copy of the current context
+     */
+    getContext() {
+        return structuredClone(this.context);
+    }
+    /**
+     * Logs a message with optional data
+     * @param {string} message - Message to log
+     * @param {any} data - Optional data to log
+     */
+    log(message, data) {
+        this.logger.log(message, data);
+    }
+    /**
+     * Adds a new node to the graph
+     * @param {Node<T>} node - Node to add
+     * @throws {Error} If node with same name already exists
+     */
+    addNode(node) {
+        this.nodes.set(node.name, node);
+        this.eventManager.setupEventListeners();
+    }
+    /**
+     * Removes a node from the graph
+     * @param {string} nodeName - Name of the node to remove
+     */
+    removeNode(nodeName) {
+        this.nodes.delete(nodeName);
+        this.eventManager.setupEventListeners();
+    }
+    /**
+     * Returns all nodes in the graph
+     * @returns {Node<T>[]} Array of all nodes
+     */
+    getNodes() {
+        return Array.from(this.nodes.values());
+    }
+    /**
+     * Cleanup resources
+     */
+    destroy() {
+        this.destroySubject.next();
+        this.destroySubject.complete();
+        this.eventSubject.complete();
+        this.stateSubject.complete();
+    }
+}
+exports.GraphFlow = GraphFlow;
+//# sourceMappingURL=index.js.map

package/dist/graph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../graph/index.ts"],"names":[],"mappings":"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"}

package/dist/graph/logger.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Handles logging operations for a graph instance
+ * Provides methods for adding, retrieving, and managing logs with optional verbose output
+ */
+export declare class GraphLogger {
+    private graphName;
+    private logs;
+    private verbose;
+    /**
+     * Creates a new GraphLogger instance
+     * @param graphName - The name of the graph this logger is associated with
+     * @param verbose - Whether to output logs to console in real-time
+     */
+    constructor(graphName: string, verbose?: boolean);
+    /**
+     * Adds a new log entry with timestamp
+     * @param message - The message to log
+     */
+    addLog(message: string): void;
+    /**
+     * Returns a copy of all stored logs
+     * @returns Array of log messages
+     */
+    getLogs(): string[];
+    /**
+     * Clears all stored logs
+     */
+    clearLogs(): void;
+    /**
+     * Sets the verbose mode
+     * @param enabled - Whether to enable verbose mode
+     */
+    setVerbose(enabled: boolean): void;
+    /**
+     * Gets the current verbose mode status
+     * @returns Current verbose mode state
+     */
+    isVerbose(): boolean;
+    /**
+     * Logs a message to console with graph name prefix
+     * @param message - The message to log
+     * @param data - Optional data to log
+     */
+    log(message: string, data?: any): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/graph/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../graph/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,WAAW;IASV,OAAO,CAAC,SAAS;IAR7B,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,OAAO,CAAkB;IAEjC;;;;OAIG;gBACiB,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,OAAe;IAI/D;;;OAGG;IACI,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IASpC;;;OAGG;IACI,OAAO,IAAI,MAAM,EAAE;IAI1B;;OAEG;IACI,SAAS,IAAI,IAAI;IAIxB;;;OAGG;IACI,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIzC;;;OAGG;IACI,SAAS,IAAI,OAAO;IAI3B;;;;OAIG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;CAGvC"}

package/dist/graph/logger.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphLogger = void 0;
+/**
+ * Handles logging operations for a graph instance
+ * Provides methods for adding, retrieving, and managing logs with optional verbose output
+ */
+class GraphLogger {
+    /**
+     * Creates a new GraphLogger instance
+     * @param graphName - The name of the graph this logger is associated with
+     * @param verbose - Whether to output logs to console in real-time
+     */
+    constructor(graphName, verbose = false) {
+        this.graphName = graphName;
+        this.logs = [];
+        this.verbose = false;
+        this.verbose = verbose;
+    }
+    /**
+     * Adds a new log entry with timestamp
+     * @param message - The message to log
+     */
+    addLog(message) {
+        const timestamp = new Date().toISOString();
+        const logMessage = `[${timestamp}] ${message}`;
+        this.logs.push(logMessage);
+        if (this.verbose) {
+            console.log(`${this.graphName} - ${message}`);
+        }
+    }
+    /**
+     * Returns a copy of all stored logs
+     * @returns Array of log messages
+     */
+    getLogs() {
+        return [...this.logs];
+    }
+    /**
+     * Clears all stored logs
+     */
+    clearLogs() {
+        this.logs = [];
+    }
+    /**
+     * Sets the verbose mode
+     * @param enabled - Whether to enable verbose mode
+     */
+    setVerbose(enabled) {
+        this.verbose = enabled;
+    }
+    /**
+     * Gets the current verbose mode status
+     * @returns Current verbose mode state
+     */
+    isVerbose() {
+        return this.verbose;
+    }
+    /**
+     * Logs a message to console with graph name prefix
+     * @param message - The message to log
+     * @param data - Optional data to log
+     */
+    log(message, data) {
+        console.log(`[Graph ${this.graphName}] ${message}`, data);
+    }
+}
+exports.GraphLogger = GraphLogger;
+//# sourceMappingURL=logger.js.map

package/dist/graph/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../graph/logger.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAa,WAAW;IAItB;;;;OAIG;IACH,YAAoB,SAAiB,EAAE,UAAmB,KAAK;QAA3C,cAAS,GAAT,SAAS,CAAQ;QAR7B,SAAI,GAAa,EAAE,CAAC;QACpB,YAAO,GAAY,KAAK,CAAC;QAQ/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,OAAe;QAC3B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAG,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,MAAM,OAAO,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,OAAO;QACZ,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED;;OAEG;IACI,SAAS;QACd,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;IACjB,CAAC;IAED;;;OAGG;IACI,UAAU,CAAC,OAAgB;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;OAGG;IACI,SAAS;QACd,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,OAAe,EAAE,IAAU;QAC7B,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,SAAS,KAAK,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IAC5D,CAAC;CACF;AAjED,kCAiEC"}