@ai.ntellect/core 0.7.1 → 0.7.4

package/README.md

@@ -34,50 +34,35 @@ npm install @ai.ntellect/core zod
 ## Example
 
 ```typescript
-import { z } from "zod";
 import { GraphFlow } from "@ai.ntellect/core";
+import { z } from "zod";
 
-// Define context schema
+// Definition of the context schema
 const ContextSchema = z.object({
   message: z.string(),
-  counter: z.number(),
 });
 
-// Create graph instance
-const graph = new GraphFlow<typeof ContextSchema>("MyGraph", {
-  name: "MyGraph",
+type ContextSchema = typeof ContextSchema;
+
+// Definition of the graph
+const myGraph = new GraphFlow<ContextSchema>("TestGraph", {
+  name: "TestGraph",
+  context: { message: "Installation success" },
   schema: ContextSchema,
-  context: { message: "Hello", counter: 0 },
   nodes: [
     {
-      name: "incrementCounter",
-      execute: async (context) => {
-        context.counter++;
-      },
-      next: ["checkThreshold"],
-    },
-    {
-      name: "checkThreshold",
-      condition: (context) => context.counter < 5,
+      name: "printMessage",
       execute: async (context) => {
-        if (context.counter >= 5) {
-          context.message = "Threshold reached!";
-        }
-      },
-      next: ["incrementCounter"],
-      retry: {
-        maxAttempts: 3,
-        delay: 1000,
+        console.log(context.message);
       },
+      next: [],
     },
   ],
 });
 
-// Observe state changes
+// Execution of the graph
 (async () => {
-  // Execute the graph
-  graph.execute("incrementCounter");
-  graph.observe().state().subscribe(console.log);
+  await myGraph.execute("printMessage");
 })();
 ```
 

package/dist/graph/controller.d.ts

@@ -0,0 +1,33 @@
+import { ZodSchema } from "zod";
+import { GraphFlow } from "./index";
+/**
+ * Controller class for managing the execution of graph flows
+ * Handles both sequential and parallel execution of multiple graphs
+ */
+export declare class GraphFlowController {
+    /**
+     * Executes multiple graphs sequentially
+     * @param graphs - Array of GraphFlow instances to execute
+     * @param startNodes - Array of starting node identifiers for each graph
+     * @param inputContexts - Optional array of initial contexts for each graph
+     * @returns Map containing results of each graph execution, keyed by graph name and index
+     * @template T - Zod schema type for graph context validation
+     */
+    static executeSequential<T extends ZodSchema[]>(graphs: {
+        [K in keyof T]: GraphFlow<T[K]>;
+    }, startNodes: string[], inputs: any[]): Promise<any[]>;
+    /**
+     * Executes multiple graphs in parallel with optional concurrency control
+     * @param graphs - Array of GraphFlow instances to execute
+     * @param startNodes - Array of starting node identifiers for each graph
+     * @param inputContexts - Optional array of initial contexts for each graph
+     * @param inputs - Optional array of additional inputs for each graph
+     * @param concurrencyLimit - Optional limit on number of concurrent graph executions
+     * @returns Map containing results of each graph execution, keyed by graph name
+     * @template T - Zod schema type for graph context validation
+     */
+    static executeParallel<T extends ZodSchema[]>(graphs: {
+        [K in keyof T]: GraphFlow<T[K]>;
+    }, startNodes: string[], concurrency: number, inputs: any[]): Promise<any[]>;
+}
+//# sourceMappingURL=controller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../graph/controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAEhC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B;;;;;;;OAOG;WACU,iBAAiB,CAAC,CAAC,SAAS,SAAS,EAAE,EAClD,MAAM,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,EAC3C,UAAU,EAAE,MAAM,EAAE,EACpB,MAAM,EAAE,GAAG,EAAE,GACZ,OAAO,CAAC,GAAG,EAAE,CAAC;IASjB;;;;;;;;;OASG;WACU,eAAe,CAAC,CAAC,SAAS,SAAS,EAAE,EAChD,MAAM,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,EAC3C,UAAU,EAAE,MAAM,EAAE,EACpB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,GAAG,EAAE,GACZ,OAAO,CAAC,GAAG,EAAE,CAAC;CAgClB"}

package/dist/graph/controller.js

@@ -0,0 +1,73 @@
+"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.GraphFlowController = void 0;
+/**
+ * Controller class for managing the execution of graph flows
+ * Handles both sequential and parallel execution of multiple graphs
+ */
+class GraphFlowController {
+    /**
+     * Executes multiple graphs sequentially
+     * @param graphs - Array of GraphFlow instances to execute
+     * @param startNodes - Array of starting node identifiers for each graph
+     * @param inputContexts - Optional array of initial contexts for each graph
+     * @returns Map containing results of each graph execution, keyed by graph name and index
+     * @template T - Zod schema type for graph context validation
+     */
+    static executeSequential(graphs, startNodes, inputs) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const results = new Map();
+            for (let i = 0; i < graphs.length; i++) {
+                const result = yield graphs[i].execute(startNodes[i], inputs[i]);
+                results.set(`${graphs[i].name}-${i}`, result);
+            }
+            return Array.from(results.values());
+        });
+    }
+    /**
+     * Executes multiple graphs in parallel with optional concurrency control
+     * @param graphs - Array of GraphFlow instances to execute
+     * @param startNodes - Array of starting node identifiers for each graph
+     * @param inputContexts - Optional array of initial contexts for each graph
+     * @param inputs - Optional array of additional inputs for each graph
+     * @param concurrencyLimit - Optional limit on number of concurrent graph executions
+     * @returns Map containing results of each graph execution, keyed by graph name
+     * @template T - Zod schema type for graph context validation
+     */
+    static executeParallel(graphs, startNodes, concurrency, inputs) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const results = new Map();
+            if (inputs) {
+                inputs = inputs.map((input) => input || {});
+            }
+            if (concurrency) {
+                for (let i = 0; i < graphs.length; i += concurrency) {
+                    const batchResults = yield Promise.all(graphs
+                        .slice(i, i + concurrency)
+                        .map((graph, index) => graph.execute(startNodes[i + index], inputs === null || inputs === void 0 ? void 0 : inputs[i + index])));
+                    batchResults.forEach((result, index) => {
+                        results.set(`${graphs[i + index].name}`, result);
+                    });
+                }
+            }
+            else {
+                const allResults = yield Promise.all(graphs.map((graph, index) => graph.execute(startNodes[index], (inputs === null || inputs === void 0 ? void 0 : inputs[index]) || {})));
+                allResults.forEach((result, index) => {
+                    results.set(`${graphs[index].name}`, result);
+                });
+            }
+            return Array.from(results.values());
+        });
+    }
+}
+exports.GraphFlowController = GraphFlowController;
+//# sourceMappingURL=controller.js.map

package/dist/graph/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../graph/controller.ts"],"names":[],"mappings":";;;;;;;;;;;;AAIA;;;GAGG;AACH,MAAa,mBAAmB;IAC9B;;;;;;;OAOG;IACH,MAAM,CAAO,iBAAiB,CAC5B,MAA2C,EAC3C,UAAoB,EACpB,MAAa;;YAEb,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoC,CAAC;YAC5D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACvC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBACjE,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAChD,CAAC;YACD,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACtC,CAAC;KAAA;IAED;;;;;;;;;OASG;IACH,MAAM,CAAO,eAAe,CAC1B,MAA2C,EAC3C,UAAoB,EACpB,WAAmB,EACnB,MAAa;;YAEb,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoC,CAAC;YAE5D,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAC9C,CAAC;YAED,IAAI,WAAW,EAAE,CAAC;gBAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC;oBACpD,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CACpC,MAAM;yBACH,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC;yBACzB,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CACpB,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAC1D,CACJ,CAAC;oBACF,YAAY,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;wBACrC,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;oBACnD,CAAC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAClC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAC1B,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAG,KAAK,CAAC,KAAI,EAAE,CAAC,CACxD,CACF,CAAC;gBACF,UAAU,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;oBACnC,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;gBAC/C,CAAC,CAAC,CAAC;YACL,CAAC;YACD,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACtC,CAAC;KAAA;CACF;AArED,kDAqEC"}

package/dist/graph/event-manager.d.ts

@@ -0,0 +1,92 @@
+import { ZodSchema } from "zod";
+import { IEventEmitter } from "../interfaces";
+import { GraphContext, Node } from "../types";
+import { GraphNode } from "./node";
+/**
+ * Manages event handling and routing for a graph
+ * Coordinates event emission, listening, and execution of event-driven nodes
+ * @template T - The Zod schema type for validation
+ */
+export declare class GraphEventManager<T extends ZodSchema> {
+    private eventEmitter;
+    private nodes;
+    private nodeExecutor?;
+    private eventSubject;
+    private nodeStreams;
+    private context;
+    private name;
+    private graphEvents?;
+    private entryNode?;
+    private globalErrorHandler?;
+    /**
+     * Creates a new GraphEventManager instance
+     * @param eventEmitter - The event emitter implementation to use
+     * @param nodes - Map of all nodes in the graph
+     * @param name - Name of the graph
+     * @param context - Initial graph context
+     * @param graphEvents - List of events the graph should listen to
+     * @param entryNode - Name of the entry node for graph events
+     * @param globalErrorHandler - Global error handling function
+     * @param nodeExecutor - GraphNode instance for executing nodes
+     */
+    constructor(eventEmitter: IEventEmitter, nodes: Map<string, Node<T, any>>, name: string, context: GraphContext<T>, graphEvents?: string[], entryNode?: string, globalErrorHandler?: (error: Error, context: GraphContext<T>) => void, nodeExecutor?: GraphNode<T> | undefined);
+    /**
+     * Sets up event streams for all nodes that listen to events
+     */
+    setupEventStreams(): void;
+    /**
+     * Emits an event with optional payload and context
+     * @param type - The type of event to emit
+     * @param payload - Optional payload data
+     * @param context - Optional graph context
+     */
+    emitEvent<P = any>(type: string, payload?: P, context?: GraphContext<T>): void;
+    /**
+     * Sets up event listeners for all nodes in the graph
+     * Handles cleanup and re-registration of event listeners
+     */
+    setupEventListeners(): void;
+    /**
+     * Sets up listeners for graph-level events
+     * Handles graph start, completion, and error events
+     */
+    setupGraphEventListeners(): void;
+    /**
+     * Waits for a set of events to occur within a timeout period
+     * @param events - Array of event names to wait for
+     * @param timeout - Maximum time to wait in milliseconds
+     * @returns Promise that resolves with array of received events
+     * @throws Error if timeout occurs before all events are received
+     */
+    waitForEvents(events: string[], timeout?: number): Promise<any[]>;
+    /**
+     * Registers an event handler
+     * @param eventName - Name of the event to listen for
+     * @param handler - Function to handle the event
+     */
+    on(eventName: string, handler: (...args: any[]) => void): void;
+    /**
+     * Emits an event through the event emitter
+     * @param eventName - Name of the event to emit
+     * @param data - Optional data to include with the event
+     */
+    emit(eventName: string, data?: any): void;
+    /**
+     * Creates a new context object by cloning the current context
+     * @returns A new graph context instance
+     * @private
+     */
+    private createNewContext;
+    /**
+     * Executes a node with the given parameters
+     * @param nodeName - Name of the node to execute
+     * @param context - Graph context for execution
+     * @param inputs - Input data for the node
+     * @param triggeredByEvent - Whether execution was triggered by an event
+     * @returns Promise that resolves when execution is complete
+     * @throws Error if nodeExecutor is not initialized
+     * @private
+     */
+    private executeNode;
+}
+//# sourceMappingURL=event-manager.d.ts.map

package/dist/graph/event-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-manager.d.ts","sourceRoot":"","sources":["../../graph/event-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAc,IAAI,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAEnC;;;;GAIG;AACH,qBAAa,iBAAiB,CAAC,CAAC,SAAS,SAAS;IAqB9C,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,YAAY,CAAC;IA3BvB,OAAO,CAAC,YAAY,CAAyC;IAC7D,OAAO,CAAC,WAAW,CAAqD;IACxE,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,WAAW,CAAC,CAAW;IAC/B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,kBAAkB,CAAC,CAAmD;IAE9E;;;;;;;;;;OAUG;gBAEO,YAAY,EAAE,aAAa,EAC3B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EACxC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EACxB,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,SAAS,CAAC,EAAE,MAAM,EAClB,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,EAC7D,YAAY,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,YAAA;IAUrC;;OAEG;IACI,iBAAiB,IAAI,IAAI;IAWhC;;;;;OAKG;IACI,SAAS,CAAC,CAAC,GAAG,GAAG,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,CAAC,EACX,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GACxB,IAAI;IAaP;;;OAGG;IACH,mBAAmB,IAAI,IAAI;IAiD3B;;;OAGG;IACH,wBAAwB,IAAI,IAAI;IAuChC;;;;;;OAMG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,GAAE,MAAc,GACtB,OAAO,CAAC,GAAG,EAAE,CAAC;IAiDjB;;;;OAIG;IACH,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,IAAI;IAI9D;;;;OAIG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIzC;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;;;;;;;;OASG;YACW,WAAW;CAgB1B"}

package/dist/graph/event-manager.js

@@ -0,0 +1,244 @@
+"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;
+const rxjs_1 = require("rxjs");
+/**
+ * Manages event handling and routing for a graph
+ * Coordinates event emission, listening, and execution of event-driven nodes
+ * @template T - The Zod schema type for validation
+ */
+class GraphEventManager {
+    /**
+     * Creates a new GraphEventManager instance
+     * @param eventEmitter - The event emitter implementation to use
+     * @param nodes - Map of all nodes in the graph
+     * @param name - Name of the graph
+     * @param context - Initial graph context
+     * @param graphEvents - List of events the graph should listen to
+     * @param entryNode - Name of the entry node for graph events
+     * @param globalErrorHandler - Global error handling function
+     * @param nodeExecutor - GraphNode instance for executing nodes
+     */
+    constructor(eventEmitter, nodes, name, context, graphEvents, entryNode, globalErrorHandler, nodeExecutor) {
+        this.eventEmitter = eventEmitter;
+        this.nodes = nodes;
+        this.nodeExecutor = nodeExecutor;
+        this.eventSubject = new rxjs_1.Subject();
+        this.nodeStreams = new Map();
+        this.name = name;
+        this.context = context;
+        this.graphEvents = graphEvents;
+        this.entryNode = entryNode;
+        this.globalErrorHandler = globalErrorHandler;
+        this.setupEventStreams();
+    }
+    /**
+     * Sets up event streams for all nodes that listen to events
+     */
+    setupEventStreams() {
+        for (const [nodeName, node] of this.nodes.entries()) {
+            if (node.events && node.events.length > 0) {
+                const nodeStream = this.eventSubject.pipe((0, rxjs_1.filter)((event) => node.events.includes(event.type)));
+                this.nodeStreams.set(nodeName, nodeStream);
+            }
+        }
+    }
+    /**
+     * Emits an event with optional payload and context
+     * @param type - The type of event to emit
+     * @param payload - Optional payload data
+     * @param context - Optional graph context
+     */
+    emitEvent(type, payload, context) {
+        // Éviter la double imbrication des événements
+        const event = {
+            type,
+            payload,
+            timestamp: Date.now(),
+        };
+        // Émettre l'événement une seule fois
+        this.eventSubject.next(event);
+        this.eventEmitter.emit(type, payload);
+    }
+    /**
+     * Sets up event listeners for all nodes in the graph
+     * Handles cleanup and re-registration of event listeners
+     */
+    setupEventListeners() {
+        // First remove only the existing node-based listeners that we might have created previously
+        // We do NOT remove, for example, "nodeStarted" or "nodeCompleted" listeners that test code added.
+        for (const [eventName, listener] of this.eventEmitter
+            .rawListeners("*")
+            .entries()) {
+            // This can be tricky—EventEmitter doesn't directly let you remove by "type" of listener.
+            // Alternatively, we can store references in a separate structure.
+            // For simplicity, let's do a full removeAllListeners() on node-specified events (only),
+            // then re-add them below, but keep the test-based events like "nodeStarted" or "nodeCompleted".
+        }
+        // The simplest approach: removeAllListeners for each event that is declared as a node event
+        // so we don't stack up duplicates:
+        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) {
+            // remove only those events that are used by nodes
+            this.eventEmitter.removeAllListeners(evt);
+        }
+        // Now re-add the 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);
+                        // If triggered by an event, we pass "true" so event-driven node will skip `next`.
+                        yield this.executeNode(node.name, freshContext, undefined, 
+                        /* triggeredByEvent= */ true);
+                    }));
+                });
+            }
+        }
+    }
+    /**
+     * Sets up listeners for graph-level events
+     * Handles graph start, completion, and error events
+     */
+    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);
+                    // Emit "graphStarted"
+                    this.eventEmitter.emit("graphStarted", { name: this.name });
+                    try {
+                        // Execute the graph starting from the entry node
+                        if (!this.entryNode) {
+                            throw new Error("No entry node defined for graph event handling");
+                        }
+                        yield this.executeNode(this.entryNode, freshContext, undefined, false);
+                        // Emit "graphCompleted"
+                        this.eventEmitter.emit("graphCompleted", {
+                            name: this.name,
+                            context: this.context,
+                        });
+                    }
+                    catch (error) {
+                        // Emit "graphError"
+                        this.eventEmitter.emit("graphError", { name: this.name, error });
+                        (_a = this.globalErrorHandler) === null || _a === void 0 ? void 0 : _a.call(this, error, freshContext);
+                        throw error;
+                    }
+                }));
+            });
+        }
+    }
+    /**
+     * Waits for a set of events to occur within a timeout period
+     * @param events - Array of event names to wait for
+     * @param timeout - Maximum time to wait in milliseconds
+     * @returns Promise that resolves with array of received events
+     * @throws Error if timeout occurs before all events are received
+     */
+    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) => {
+                        console.log(`Received event: ${event}`, eventData);
+                        if (!isResolved) {
+                            receivedEvents.set(event, eventData);
+                            console.log("Current received events:", Array.from(receivedEvents.keys()));
+                            if (events.every((e) => receivedEvents.has(e))) {
+                                console.log("All events received, resolving");
+                                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);
+            });
+        });
+    }
+    /**
+     * Registers an event handler
+     * @param eventName - Name of the event to listen for
+     * @param handler - Function to handle the event
+     */
+    on(eventName, handler) {
+        this.eventEmitter.on(eventName, handler);
+    }
+    /**
+     * Emits an event through the event emitter
+     * @param eventName - Name of the event to emit
+     * @param data - Optional data to include with the event
+     */
+    emit(eventName, data) {
+        this.eventEmitter.emit(eventName, data);
+    }
+    /**
+     * Creates a new context object by cloning the current context
+     * @returns A new graph context instance
+     * @private
+     */
+    createNewContext() {
+        return structuredClone(this.context);
+    }
+    /**
+     * Executes a node with the given parameters
+     * @param nodeName - Name of the node to execute
+     * @param context - Graph context for execution
+     * @param inputs - Input data for the node
+     * @param triggeredByEvent - Whether execution was triggered by an event
+     * @returns Promise that resolves when execution is complete
+     * @throws Error if nodeExecutor is not initialized
+     * @private
+     */
+    executeNode(nodeName, context, inputs, triggeredByEvent) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.nodeExecutor) {
+                throw new Error("NodeExecutor not initialized");
+            }
+            return this.nodeExecutor.executeNode(nodeName, context, inputs, triggeredByEvent);
+        });
+    }
+}
+exports.GraphEventManager = GraphEventManager;
+//# sourceMappingURL=event-manager.js.map

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

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