@ai.ntellect/core 1.0.0 → 1.1.0

package/dist/execution/event-manager.js

@@ -0,0 +1,264 @@
+"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.GraphEventManager = void 0;
+class GraphEventManager {
+    constructor(eventEmitter, nodes, name, context, graphEvents, entryNode, globalErrorHandler, nodeExecutor) {
+        this.eventEmitter = eventEmitter;
+        this.nodes = nodes;
+        this.nodeExecutor = nodeExecutor;
+        this.lastEvents = new Map();
+        this.name = name;
+        this.context = context;
+        this.graphEvents = graphEvents;
+        this.entryNode = entryNode;
+        this.globalErrorHandler = globalErrorHandler;
+    }
+    /** @deprecated No-op — event streams are no longer managed here */
+    setupEventStreams() { }
+    emitEvent(type, payload, _context) {
+        this.eventEmitter.emit(type, payload);
+    }
+    setupEventListeners() {
+        const allEvents = new Set();
+        for (const node of this.nodes.values()) {
+            if (node.events) {
+                node.events.forEach((evt) => allEvents.add(evt));
+            }
+        }
+        for (const evt of allEvents) {
+            this.eventEmitter.removeAllListeners(evt);
+        }
+        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, true);
+                    }));
+                });
+            }
+        }
+    }
+    setupGraphEventListeners() {
+        if (this.graphEvents && this.graphEvents.length > 0) {
+            this.graphEvents.forEach((event) => {
+                this.eventEmitter.on(event, (data) => __awaiter(this, void 0, void 0, function* () {
+                    var _a;
+                    const freshContext = this.createNewContext();
+                    if (data)
+                        Object.assign(freshContext, data);
+                    this.eventEmitter.emit("graphStarted", { name: this.name });
+                    try {
+                        if (!this.entryNode) {
+                            throw new Error("No entry node defined for graph event handling");
+                        }
+                        yield this.executeNode(this.entryNode, freshContext, false);
+                        this.eventEmitter.emit("graphCompleted", {
+                            name: this.name,
+                            context: this.context,
+                        });
+                    }
+                    catch (error) {
+                        this.eventEmitter.emit("graphError", { name: this.name, error });
+                        (_a = this.globalErrorHandler) === null || _a === void 0 ? void 0 : _a.call(this, error, freshContext);
+                        throw error;
+                    }
+                }));
+            });
+        }
+    }
+    waitForEvents(events_1) {
+        return __awaiter(this, arguments, void 0, function* (events, timeout = 30000) {
+            return new Promise((resolve, reject) => {
+                const receivedEvents = new Map();
+                const eventHandlers = new Map();
+                let isResolved = false;
+                const cleanup = () => {
+                    events.forEach((event) => {
+                        const handler = eventHandlers.get(event);
+                        if (handler) {
+                            this.eventEmitter.removeListener(event, handler);
+                        }
+                    });
+                };
+                events.forEach((event) => {
+                    const handler = (eventData) => {
+                        if (!isResolved) {
+                            receivedEvents.set(event, eventData);
+                            if (events.every((e) => receivedEvents.has(e))) {
+                                isResolved = true;
+                                clearTimeout(timeoutId);
+                                cleanup();
+                                resolve(Array.from(receivedEvents.values()));
+                            }
+                        }
+                    };
+                    eventHandlers.set(event, handler);
+                    this.eventEmitter.on(event, handler);
+                });
+                const timeoutId = setTimeout(() => {
+                    if (!isResolved) {
+                        isResolved = true;
+                        cleanup();
+                        reject(new Error(`Timeout waiting for events: ${events.join(", ")}`));
+                    }
+                }, timeout);
+            });
+        });
+    }
+    on(eventName, handler) {
+        this.eventEmitter.on(eventName, handler);
+    }
+    emit(eventName, data) {
+        this.lastEvents.set(eventName, data);
+        this.eventEmitter.emit(eventName, data);
+    }
+    createNewContext() {
+        return structuredClone(this.context);
+    }
+    executeNode(nodeName, context, triggeredByEvent) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.nodeExecutor) {
+                throw new Error("NodeExecutor not initialized");
+            }
+            const node = this.nodes.get(nodeName);
+            if (!node) {
+                throw new Error(`Node "${nodeName}" not found`);
+            }
+            if (node.when) {
+                yield this.handleNodeEvents(nodeName, node.when);
+            }
+            return this.nodeExecutor.executeNode(nodeName, context, triggeredByEvent);
+        });
+    }
+    waitForCorrelatedEvents(eventTypes, timeoutMs, correlationFn) {
+        return new Promise((resolve, reject) => {
+            const receivedEvents = new Map();
+            const eventHandlers = new Map();
+            let isResolved = false;
+            const cleanup = () => {
+                eventHandlers.forEach((handler, event) => {
+                    this.eventEmitter.removeListener(event, handler);
+                });
+            };
+            eventTypes.forEach((eventType) => {
+                const handler = (eventData) => {
+                    if (!isResolved) {
+                        const event = {
+                            type: eventType,
+                            payload: eventData,
+                            timestamp: Date.now(),
+                        };
+                        receivedEvents.set(eventType, event);
+                        if (eventTypes.every((type) => receivedEvents.has(type))) {
+                            const events = Array.from(receivedEvents.values());
+                            if (correlationFn(events)) {
+                                isResolved = true;
+                                clearTimeout(timeoutId);
+                                cleanup();
+                                resolve(events);
+                            }
+                        }
+                    }
+                };
+                eventHandlers.set(eventType, handler);
+                this.eventEmitter.on(eventType, handler);
+            });
+            const timeoutId = setTimeout(() => {
+                if (!isResolved) {
+                    cleanup();
+                    reject(new Error(`Timeout waiting for correlated events: ${eventTypes.join(", ")}`));
+                }
+            }, timeoutMs);
+        });
+    }
+    handleNodeEvents(nodeName, config) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { events, timeout = 30000, strategy } = config;
+            return new Promise((resolve, reject) => {
+                const receivedEvents = new Map();
+                const eventHandlers = new Map();
+                let isResolved = false;
+                events.forEach((event) => {
+                    const existingEvent = this.lastEvents.get(event);
+                    if (existingEvent) {
+                        receivedEvents.set(event, {
+                            type: event,
+                            payload: existingEvent,
+                            timestamp: Date.now(),
+                        });
+                    }
+                });
+                const checkEvents = () => {
+                    var _a;
+                    if (isResolved)
+                        return;
+                    const eventsList = Array.from(receivedEvents.values());
+                    switch (strategy.type) {
+                        case "single":
+                            if (receivedEvents.size > 0) {
+                                resolve(eventsList);
+                                isResolved = true;
+                            }
+                            break;
+                        case "all":
+                        case "correlate":
+                            const allReceived = events.every((e) => receivedEvents.has(e));
+                            if (allReceived) {
+                                if (strategy.type === "correlate") {
+                                    const correlated = (_a = strategy.correlation) === null || _a === void 0 ? void 0 : _a.call(strategy, eventsList);
+                                    if (!correlated)
+                                        return;
+                                }
+                                resolve(eventsList);
+                                isResolved = true;
+                            }
+                            break;
+                    }
+                    if (isResolved) {
+                        cleanup();
+                    }
+                };
+                events.forEach((event) => {
+                    if (!receivedEvents.has(event)) {
+                        const handler = (eventData) => {
+                            receivedEvents.set(event, {
+                                type: event,
+                                payload: eventData,
+                                timestamp: Date.now(),
+                            });
+                            checkEvents();
+                        };
+                        eventHandlers.set(event, handler);
+                        this.eventEmitter.on(event, handler);
+                    }
+                });
+                const cleanup = () => {
+                    eventHandlers.forEach((handler, event) => {
+                        this.eventEmitter.removeListener(event, handler);
+                    });
+                };
+                checkEvents();
+                const timeoutId = setTimeout(() => {
+                    if (!isResolved) {
+                        cleanup();
+                        reject(new Error(`Timeout waiting for events: ${events.join(", ")}`));
+                    }
+                }, timeout);
+            });
+        });
+    }
+}
+exports.GraphEventManager = GraphEventManager;
+//# sourceMappingURL=event-manager.js.map

package/dist/execution/event-manager.js.map

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

package/dist/execution/index.d.ts

@@ -0,0 +1,221 @@
+import { ZodSchema } from "zod";
+import { GraphObservable, ICheckpointAdapter } from "../interfaces";
+import { Checkpoint, CheckpointConfig, GraphConfig, GraphContext, GraphNodeConfig } from "../types";
+import { GraphObserver } from "./observer";
+import { GraphVisualizer } from "./visualizer";
+/**
+ * @module GraphFlow
+ * @description A 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> {
+    private context;
+    private _initialContext;
+    validator?: T;
+    private eventEmitter;
+    private globalErrorHandler?;
+    private graphEvents?;
+    private entryNode?;
+    private verbose;
+    nodes: Map<string, GraphNodeConfig<T, any>>;
+    name: string;
+    private eventSubject;
+    private stateSubject;
+    private destroySubject;
+    observer: GraphObserver<T>;
+    private logger;
+    private eventManager;
+    private nodeExecutor;
+    private nlpNodes;
+    private _interrupted;
+    private _interruptCheckpoint;
+    private _checkpointCounter;
+    private _breakpoints;
+    /**
+     * Creates a new instance of GraphFlow
+     * @param {GraphConfig<T>} config - Configuration object containing name, nodes, schema, context, and error handlers
+     * @param {Object} options - Optional options for the graph flow
+     */
+    constructor(config: GraphConfig<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 {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?: (string | number)[];
+        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>>} context - Optional context to merge
+     * @returns {Promise<GraphContext<T>>} Final context after execution
+     */
+    execute(startNode: string, context?: Partial<GraphContext<T>>): Promise<GraphContext<T>>;
+    /**
+     * Executes the graph flow with automatic checkpointing at each node
+     * @param startNode - Name of the node to start execution from
+     * @param adapter - Checkpoint persistence adapter
+     * @param config - Checkpoint configuration options
+     * @returns Execution result with final context and checkpoint ID
+     */
+    executeWithCheckpoint(startNode: string, adapter: ICheckpointAdapter, config?: CheckpointConfig): Promise<{
+        context: GraphContext<T>;
+        checkpointId: string;
+    }>;
+    /**
+     * Resumes execution from a saved checkpoint
+     * @param checkpointId - ID of the checkpoint to resume from
+     * @param adapter - Checkpoint persistence adapter
+     * @returns Final context after execution
+     */
+    resumeFromCheckpoint(checkpointId: string, adapter: ICheckpointAdapter, contextModifications?: Partial<Record<string, any>>): Promise<GraphContext<T>>;
+    /**
+     * Interrupts the current execution and saves a checkpoint
+     */
+    interrupt(): void;
+    /**
+     * Lists all checkpoints for this graph
+     * @param adapter - Checkpoint persistence adapter
+     * @returns Array of checkpoints sorted by creation date (newest first)
+     */
+    listCheckpoints(adapter: ICheckpointAdapter): Promise<Checkpoint<T>[]>;
+    /**
+     * Gets checkpoint history for a specific run
+     * @param runId - Run identifier
+     * @param adapter - Checkpoint persistence adapter
+     * @returns Checkpoints for the specified run, sorted newest first
+     */
+    getCheckpointHistory(runId: string, adapter: ICheckpointAdapter): Promise<Checkpoint<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 {GraphConfig<T>} definition - New graph definition
+     */
+    load(definition: GraphConfig<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 {GraphNodeConfig<T, any>} node - Node to add
+     * @throws {Error} If node with same name already exists
+     */
+    addNode(node: GraphNodeConfig<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(): GraphNodeConfig<T, any>[];
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+    /**
+     * Creates a visualizer instance for the current graph
+     * @returns {GraphVisualizer<T>} A visualizer instance
+     */
+    createVisualizer(): GraphVisualizer<T>;
+    /**
+     * Gets the schema for the current graph
+     * @returns {T} The schema for the current graph
+     */
+    getSchema(): T;
+    /**
+     * Processes natural language input using a specific NLP node
+     * @param {string} text - The input text to process
+     * @param {string} nodeName - The name of the NLP node to use
+     * @returns {Promise<GraphContext<T>>} The result of the NLP node execution
+     */
+    processNaturalLanguage(text: string, nodeName: string): Promise<GraphContext<T>>;
+}
+export declare class CheckpointInterruptError extends Error {
+    readonly checkpointId: string;
+    constructor(message: string, checkpointId: string);
+}
+export declare class CheckpointAwaitApprovalError extends Error {
+    readonly checkpointId: string;
+    constructor(message: string, checkpointId: string);
+}
+//# sourceMappingURL=index.d.ts.map

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

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