@ai.ntellect/core 0.8.3 → 1.1.0

package/dist/{graph → execution}/event-manager.js

@@ -10,81 +10,24 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 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.lastEvents = 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) {
-        const event = {
-            type,
-            payload,
-            timestamp: Date.now(),
-        };
-        this.eventSubject.next(event);
+    /** @deprecated No-op — event streams are no longer managed here */
+    setupEventStreams() { }
+    emitEvent(type, payload, _context) {
         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) {
@@ -92,10 +35,8 @@ class GraphEventManager {
             }
         }
         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) => {
@@ -103,18 +44,12 @@ class GraphEventManager {
                         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, 
-                        /* triggeredByEvent= */ true);
+                        yield this.executeNode(node.name, freshContext, 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) => {
@@ -123,22 +58,18 @@ class GraphEventManager {
                     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, 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;
@@ -147,13 +78,6 @@ class GraphEventManager {
             });
         }
     }
-    /**
-     * 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) => {
@@ -193,41 +117,16 @@ class GraphEventManager {
             });
         });
     }
-    /**
-     * 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.lastEvents.set(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, triggeredByEvent) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!this.nodeExecutor) {
@@ -237,16 +136,12 @@ class GraphEventManager {
             if (!node) {
                 throw new Error(`Node "${nodeName}" not found`);
             }
-            // Remplacer le code existant de gestion d'événements
             if (node.when) {
                 yield this.handleNodeEvents(nodeName, node.when);
             }
             return this.nodeExecutor.executeNode(nodeName, context, triggeredByEvent);
         });
     }
-    /**
-     * Waits for correlated events to occur and validates them using a correlation function
-     */
     waitForCorrelatedEvents(eventTypes, timeoutMs, correlationFn) {
         return new Promise((resolve, reject) => {
             const receivedEvents = new Map();
@@ -288,9 +183,6 @@ class GraphEventManager {
             }, timeoutMs);
         });
     }
-    /**
-     * Handles events based on the node's event handler configuration
-     */
     handleNodeEvents(nodeName, config) {
         return __awaiter(this, void 0, void 0, function* () {
             const { events, timeout = 30000, strategy } = config;
@@ -298,7 +190,6 @@ class GraphEventManager {
                 const receivedEvents = new Map();
                 const eventHandlers = new Map();
                 let isResolved = false;
-                // Ajouter les événements déjà reçus
                 events.forEach((event) => {
                     const existingEvent = this.lastEvents.get(event);
                     if (existingEvent) {
@@ -309,7 +200,6 @@ class GraphEventManager {
                         });
                     }
                 });
-                // Vérifier si on a déjà tous les événements nécessaires
                 const checkEvents = () => {
                     var _a;
                     if (isResolved)

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/{graph → execution}/index.d.ts

@@ -1,6 +1,6 @@
 import { ZodSchema } from "zod";
-import { GraphObservable } from "../interfaces";
-import { GraphConfig, GraphContext, GraphNodeConfig } from "../types";
+import { GraphObservable, ICheckpointAdapter } from "../interfaces";
+import { Checkpoint, CheckpointConfig, GraphConfig, GraphContext, GraphNodeConfig } from "../types";
 import { GraphObserver } from "./observer";
 import { GraphVisualizer } from "./visualizer";
 /**
@@ -18,6 +18,7 @@ import { GraphVisualizer } from "./visualizer";
  */
 export declare class GraphFlow<T extends ZodSchema> {
     private context;
+    private _initialContext;
     validator?: T;
     private eventEmitter;
     private globalErrorHandler?;
@@ -34,6 +35,10 @@ export declare class GraphFlow<T extends ZodSchema> {
     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
@@ -103,6 +108,41 @@ export declare class GraphFlow<T extends ZodSchema> {
      * @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
@@ -170,4 +210,12 @@ export declare class GraphFlow<T extends ZodSchema> {
      */
     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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"}