@ai.ntellect/core 0.7.1 → 0.7.4

package/dist/graph/node.d.ts

@@ -0,0 +1,103 @@
+import { BehaviorSubject, Subject } from "rxjs";
+import { ZodSchema } from "zod";
+import { GraphContext, GraphEvent, Node } from "../types";
+import { GraphEventManager } from "./event-manager";
+import { GraphLogger } from "./logger";
+/**
+ * Represents a node in the graph that can execute operations and manage state
+ * @template T - The Zod schema type for validation
+ */
+export declare class GraphNode<T extends ZodSchema> {
+    private nodes;
+    private logger;
+    private eventManager;
+    private eventSubject;
+    private stateSubject;
+    /**
+     * Creates a new GraphNode instance
+     * @param nodes - Map of all nodes in the graph
+     * @param logger - Logger instance for tracking node operations
+     * @param eventManager - Manager for handling graph events
+     * @param eventSubject - Subject for emitting events
+     * @param stateSubject - Subject for managing graph state
+     */
+    constructor(nodes: Map<string, Node<T, any>>, logger: GraphLogger, eventManager: GraphEventManager<T>, eventSubject: Subject<GraphEvent<T>>, stateSubject: BehaviorSubject<GraphContext<T>>);
+    /**
+     * Emits an event with the specified type and payload
+     * @param type - The type of event to emit
+     * @param payload - The data associated with the event
+     * @private
+     */
+    private emitEvent;
+    /**
+     * Executes a node with the given name and context
+     * @param nodeName - The name of the node to execute
+     * @param context - The current graph context
+     * @param inputs - Input data for the node
+     * @param triggeredByEvent - Whether the execution was triggered by an event
+     * @throws Error if the node is not found or execution fails
+     */
+    executeNode(nodeName: string, context: GraphContext<T>, inputs: any, triggeredByEvent?: boolean): Promise<void>;
+    /**
+     * Validates the inputs for a node using its schema
+     * @param node - The node whose inputs need validation
+     * @param inputs - The input data to validate
+     * @param nodeName - The name of the node (for error messages)
+     * @throws Error if validation fails
+     * @private
+     */
+    private validateInputs;
+    /**
+     * Validates the outputs of a node against its schema
+     * @param node - The node whose outputs need validation
+     * @param context - The current graph context
+     * @param nodeName - The name of the node (for error messages)
+     * @throws Error if validation fails
+     * @private
+     */
+    private validateOutputs;
+    /**
+     * Handles event-related operations for a node
+     * @param node - The node whose events need handling
+     * @param nodeName - The name of the node
+     * @param context - The current graph context
+     * @private
+     */
+    private handleEvents;
+    /**
+     * Executes a node with retry logic
+     * @param node - The node to execute
+     * @param contextProxy - The proxied graph context
+     * @param inputs - Input data for the node
+     * @param nodeName - The name of the node
+     * @throws Error if all retry attempts fail
+     * @private
+     */
+    private executeWithRetry;
+    /**
+     * Handles the failure of retry attempts
+     * @param node - The node that failed
+     * @param error - The error that caused the failure
+     * @param context - The current graph context
+     * @param nodeName - The name of the node
+     * @private
+     */
+    private handleRetryFailure;
+    /**
+     * Handles correlated events for a node
+     * @param node - The node with correlated events
+     * @param nodeName - The name of the node
+     * @throws Error if correlation fails or timeout occurs
+     * @private
+     */
+    private handleCorrelatedEvents;
+    /**
+     * Handles waiting for events
+     * @param node - The node waiting for events
+     * @param nodeName - The name of the node
+     * @throws Error if timeout occurs
+     * @private
+     */
+    private handleWaitForEvents;
+}
+//# sourceMappingURL=node.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../graph/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;;GAGG;AACH,qBAAa,SAAS,CAAC,CAAC,SAAS,SAAS;IAUtC,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,YAAY;IAbtB;;;;;;;OAOG;gBAEO,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAChC,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAClC,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EACpC,YAAY,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAGxD;;;;;OAKG;IACH,OAAO,CAAC,SAAS;IAwBjB;;;;;;;OAOG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EACxB,MAAM,EAAE,GAAG,EACX,gBAAgB,GAAE,OAAe,GAChC,OAAO,CAAC,IAAI,CAAC;IA+DhB;;;;;;;OAOG;YACW,cAAc;IAkB5B;;;;;;;OAOG;YACW,eAAe;IAgB7B;;;;;;OAMG;YACW,YAAY;IAc1B;;;;;;;;OAQG;YACW,gBAAgB;IA0C9B;;;;;;;OAOG;YACW,kBAAkB;IA8BhC;;;;;;OAMG;YACW,sBAAsB;IAuCpC;;;;;;OAMG;YACW,mBAAmB;CAalC"}

package/dist/graph/node.js

@@ -0,0 +1,284 @@
+"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.GraphNode = void 0;
+/**
+ * Represents a node in the graph that can execute operations and manage state
+ * @template T - The Zod schema type for validation
+ */
+class GraphNode {
+    /**
+     * Creates a new GraphNode instance
+     * @param nodes - Map of all nodes in the graph
+     * @param logger - Logger instance for tracking node operations
+     * @param eventManager - Manager for handling graph events
+     * @param eventSubject - Subject for emitting events
+     * @param stateSubject - Subject for managing graph state
+     */
+    constructor(nodes, logger, eventManager, eventSubject, stateSubject) {
+        this.nodes = nodes;
+        this.logger = logger;
+        this.eventManager = eventManager;
+        this.eventSubject = eventSubject;
+        this.stateSubject = stateSubject;
+    }
+    /**
+     * Emits an event with the specified type and payload
+     * @param type - The type of event to emit
+     * @param payload - The data associated with the event
+     * @private
+     */
+    emitEvent(type, payload) {
+        this.logger.addLog(`📢 Event: ${type}`);
+        const event = {
+            type,
+            payload: Object.assign(Object.assign({}, payload), { name: type === "nodeStateChanged"
+                    ? payload.name || payload.nodeName
+                    : payload.name, context: Object.assign({}, payload.context) }),
+            timestamp: Date.now(),
+        };
+        this.eventSubject.next(event);
+        this.eventManager.emitEvent(type, event);
+        // Update state subject only for state changes
+        if (type === "nodeStateChanged") {
+            this.stateSubject.next(Object.assign({}, payload.context));
+        }
+    }
+    /**
+     * Executes a node with the given name and context
+     * @param nodeName - The name of the node to execute
+     * @param context - The current graph context
+     * @param inputs - Input data for the node
+     * @param triggeredByEvent - Whether the execution was triggered by an event
+     * @throws Error if the node is not found or execution fails
+     */
+    executeNode(nodeName_1, context_1, inputs_1) {
+        return __awaiter(this, arguments, void 0, function* (nodeName, context, inputs, triggeredByEvent = false) {
+            const node = this.nodes.get(nodeName);
+            if (!node)
+                throw new Error(`Node "${nodeName}" not found.`);
+            this.logger.addLog(`🚀 Starting node "${nodeName}`);
+            this.emitEvent("nodeStarted", { name: nodeName, context });
+            try {
+                // Vérifier la condition avant d'exécuter
+                if (node.condition && !node.condition(context)) {
+                    this.logger.addLog(`⏭️ Skipping node "${nodeName}" - condition not met`);
+                    return;
+                }
+                const contextProxy = new Proxy(context, {
+                    set: (target, prop, value) => {
+                        const oldValue = target[prop];
+                        if (oldValue === value)
+                            return true;
+                        target[prop] = value;
+                        this.emitEvent("nodeStateChanged", {
+                            nodeName,
+                            property: prop.toString(),
+                            oldValue,
+                            newValue: value,
+                            context: target,
+                        });
+                        return true;
+                    },
+                    get: (target, prop) => target[prop],
+                });
+                // Exécuter le nœud
+                yield node.execute(contextProxy, inputs);
+                // Gérer la suite uniquement si pas déclenché par un événement
+                if (!triggeredByEvent) {
+                    const nextNodes = typeof node.next === "function"
+                        ? node.next(contextProxy)
+                        : node.next || [];
+                    for (const nextNodeName of nextNodes) {
+                        yield this.executeNode(nextNodeName, context, undefined, false);
+                    }
+                }
+                this.logger.addLog(`✅ Node "${nodeName}" executed successfully`);
+                this.emitEvent("nodeCompleted", { name: nodeName, context });
+            }
+            catch (error) {
+                this.logger.addLog(`❌ Error in node "${nodeName}": ${error instanceof Error ? error.message : String(error)}`);
+                this.emitEvent("nodeError", { name: nodeName, error, context });
+                throw error;
+            }
+        });
+    }
+    /**
+     * Validates the inputs for a node using its schema
+     * @param node - The node whose inputs need validation
+     * @param inputs - The input data to validate
+     * @param nodeName - The name of the node (for error messages)
+     * @throws Error if validation fails
+     * @private
+     */
+    validateInputs(node, inputs, nodeName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            if (!inputs) {
+                throw new Error(`Inputs required for node "${nodeName}"`);
+            }
+            try {
+                return node.inputs.parse(inputs);
+            }
+            catch (error) {
+                throw new Error(((_b = (_a = error.errors) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.message) || error.message || "Input validation failed");
+            }
+        });
+    }
+    /**
+     * Validates the outputs of a node against its schema
+     * @param node - The node whose outputs need validation
+     * @param context - The current graph context
+     * @param nodeName - The name of the node (for error messages)
+     * @throws Error if validation fails
+     * @private
+     */
+    validateOutputs(node, context, nodeName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            try {
+                node.outputs.parse(context);
+            }
+            catch (error) {
+                throw new Error(((_b = (_a = error.errors) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.message) ||
+                    error.message ||
+                    "Output validation failed");
+            }
+        });
+    }
+    /**
+     * Handles event-related operations for a node
+     * @param node - The node whose events need handling
+     * @param nodeName - The name of the node
+     * @param context - The current graph context
+     * @private
+     */
+    handleEvents(node, nodeName, context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (node.correlateEvents) {
+                yield this.handleCorrelatedEvents(node, nodeName);
+            }
+            if (node.waitForEvents) {
+                yield this.handleWaitForEvents(node, nodeName);
+            }
+        });
+    }
+    /**
+     * Executes a node with retry logic
+     * @param node - The node to execute
+     * @param contextProxy - The proxied graph context
+     * @param inputs - Input data for the node
+     * @param nodeName - The name of the node
+     * @throws Error if all retry attempts fail
+     * @private
+     */
+    executeWithRetry(node, contextProxy, inputs, nodeName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let attempts = 0;
+            let lastError = null;
+            while (attempts < node.retry.maxAttempts) {
+                try {
+                    this.logger.addLog(`🔄 Attempt ${attempts + 1}/${node.retry.maxAttempts}`);
+                    yield node.execute(contextProxy, inputs);
+                    return;
+                }
+                catch (error) {
+                    lastError = error instanceof Error ? error : new Error(error.message);
+                    attempts++;
+                    this.logger.addLog(`❌ Attempt ${attempts} failed: ${lastError.message}`);
+                    if (attempts === node.retry.maxAttempts) {
+                        if (node.retry.onRetryFailed && lastError) {
+                            yield this.handleRetryFailure(node, lastError, contextProxy, nodeName);
+                        }
+                        throw lastError;
+                    }
+                    yield new Promise((resolve) => { var _a; return setTimeout(resolve, ((_a = node.retry) === null || _a === void 0 ? void 0 : _a.delay) || 0); });
+                }
+            }
+        });
+    }
+    /**
+     * Handles the failure of retry attempts
+     * @param node - The node that failed
+     * @param error - The error that caused the failure
+     * @param context - The current graph context
+     * @param nodeName - The name of the node
+     * @private
+     */
+    handleRetryFailure(node, error, context, nodeName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            this.logger.addLog(`🔄 Executing retry failure handler for node "${nodeName}"`);
+            try {
+                if ((_a = node.retry) === null || _a === void 0 ? void 0 : _a.onRetryFailed) {
+                    yield node.retry.onRetryFailed(error, context);
+                    if (node.retry.continueOnFailed) {
+                        this.logger.addLog(`✅ Retry failure handler succeeded - continuing execution`);
+                        return;
+                    }
+                    this.logger.addLog(`⚠️ Retry failure handler executed but node will still fail`);
+                }
+            }
+            catch (handlerError) {
+                this.logger.addLog(`❌ Retry failure handler failed: ${handlerError.message}`);
+                throw handlerError;
+            }
+        });
+    }
+    /**
+     * Handles correlated events for a node
+     * @param node - The node with correlated events
+     * @param nodeName - The name of the node
+     * @throws Error if correlation fails or timeout occurs
+     * @private
+     */
+    handleCorrelatedEvents(node, nodeName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (node.correlateEvents) {
+                const { events, timeout, correlation } = node.correlateEvents;
+                this.logger.addLog(`⏳ Node "${nodeName}" waiting for correlated events: ${events.join(", ")}`);
+                try {
+                    // Attendre les événements
+                    const receivedEvents = yield this.eventManager.waitForEvents(events, timeout);
+                    // Vérifier la corrélation
+                    if (!correlation(receivedEvents)) {
+                        this.logger.addLog(`❌ Event correlation failed for node "${nodeName}"`);
+                        throw new Error(`Event correlation failed for node "${nodeName}"`);
+                    }
+                    this.logger.addLog(`✅ Event correlation succeeded for node "${nodeName}"`);
+                }
+                catch (error) {
+                    this.logger.addLog(`❌ Error waiting for events: ${error.message}`);
+                    throw error;
+                }
+            }
+        });
+    }
+    /**
+     * Handles waiting for events
+     * @param node - The node waiting for events
+     * @param nodeName - The name of the node
+     * @throws Error if timeout occurs
+     * @private
+     */
+    handleWaitForEvents(node, nodeName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (node.waitForEvents) {
+                const { events, timeout } = node.waitForEvents;
+                this.logger.addLog(`⏳ Node "${nodeName}" waiting for events: ${events.join(", ")}`);
+                yield this.eventManager.waitForEvents(events, timeout);
+                this.logger.addLog(`✅ All events received for node "${nodeName}"`);
+            }
+        });
+    }
+}
+exports.GraphNode = GraphNode;
+//# sourceMappingURL=node.js.map

package/dist/graph/node.js.map

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

package/dist/graph/observer.d.ts

@@ -0,0 +1,113 @@
+import { BehaviorSubject, Observable, Subject } from "rxjs";
+import { ZodSchema } from "zod";
+import { GraphObservable } from "../interfaces";
+import { GraphContext, GraphEvent } from "../types";
+import { GraphFlow } from "./index";
+/**
+ * GraphObserver class provides reactive observation capabilities for a GraphFlow instance
+ * It allows monitoring state changes, node updates, and specific events in the graph
+ * @template T - The Zod schema type that defines the structure of the graph data
+ */
+export declare class GraphObserver<T extends ZodSchema> {
+    private graph;
+    private eventSubject;
+    private stateSubject;
+    private destroySubject;
+    constructor(graph: GraphFlow<T>, eventSubject: Subject<GraphEvent<T>>, stateSubject: BehaviorSubject<GraphContext<T>>, destroySubject: Subject<void>);
+    /**
+     * Observes the entire graph state changes
+     * @param options Configuration options for the observation
+     * @param options.debounce Debounce time in milliseconds
+     * @param options.delay Delay between emissions in milliseconds
+     * @param options.stream If true, streams the specified properties letter by letter
+     * @param options.properties List of properties to stream
+     * @param options.onStreamLetter Callback for each letter emitted during streaming
+     * @param options.onStreamComplete Callback when streaming is complete
+     * @returns An Observable that emits the complete graph context whenever it changes
+     */
+    state(options?: {
+        debounce?: number;
+        delay?: number;
+        stream?: boolean;
+        properties?: (keyof GraphContext<T>)[];
+        onStreamLetter?: (data: {
+            letter: string;
+            property: string;
+        }) => void;
+        onStreamComplete?: () => void;
+    }): GraphObservable<T>;
+    /**
+     * Observes state changes for a specific node
+     * @param name - The name of the node to observe
+     * @returns An Observable that emits the graph context when the specified node changes
+     */
+    node(name: string): Observable<GraphContext<T>>;
+    /**
+     * Observes state changes for multiple nodes
+     * @param names - Array of node names to observe
+     * @returns An Observable that emits the graph context when any of the specified nodes change
+     */
+    nodes(names: string[]): Observable<GraphContext<T>>;
+    /**
+     * Observes specific properties of the graph context
+     * @param keys - Single or multiple property keys to observe
+     * @returns An Observable that emits an object containing only the specified properties
+     * @template K - The key of the property to observe from GraphContext<T>
+     */
+    property<K extends keyof GraphContext<T>>(keys: K | K[]): Observable<{
+        [P in K]: GraphContext<T>[P];
+    } & {
+        name: string;
+    }>;
+    /**
+     * Observes specific events in the graph
+     * @param type - The type of event to observe
+     * @returns An Observable that emits events of the specified type
+     */
+    event(type: string): Observable<GraphEvent<T>>;
+    /**
+     * Waits for a specific condition to be met on an observable
+     * @param observable - The Observable to watch
+     * @param predicate - A function that returns true when the desired condition is met
+     * @returns A Promise that resolves with the value when the predicate returns true
+     * @template R - The type of value emitted by the observable
+     */
+    until<R>(observable: Observable<R>, predicate: (value: R) => boolean): Promise<R>;
+    /**
+     * Waits for correlated events to occur and validates them using a correlation function
+     * @param eventTypes - Array of event types to wait for
+     * @param timeoutMs - Timeout duration in milliseconds
+     * @param correlationFn - Function to validate the correlation between events
+     * @returns Promise that resolves when all correlated events are received
+     */
+    waitForCorrelatedEvents(eventTypes: string[], timeoutMs: number, correlationFn: (events: GraphEvent<T>[]) => boolean): Promise<GraphEvent<T>[]>;
+    /**
+     * Observes the current state of the graph
+     * @returns Observable that emits the current graph context
+     */
+    observeState(): Observable<GraphContext<T>>;
+    /**
+     * Observes specific event types in the graph
+     * @param eventType - The type of event to observe
+     * @returns Observable that emits events of the specified type
+     */
+    observeEvents(eventType: string): Observable<GraphEvent<T>>;
+    /**
+     * Observes state changes for a specific node
+     * @param nodeName - The name of the node to observe
+     * @returns Observable that emits the graph context when the specified node changes
+     */
+    observeNodeState(nodeName: string): Observable<GraphContext<T>>;
+    /**
+     * Streams a message letter by letter with a specified delay
+     * @param message - The message to stream
+     * @param delayMs - The delay in milliseconds between each letter
+     * @param property - The property name being streamed
+     * @returns An Observable that emits each letter of the message along with its property
+     */
+    streamMessage(message: string, delayMs: number, property: string): Observable<{
+        letter: string;
+        property: string;
+    }>;
+}
+//# sourceMappingURL=observer.d.ts.map

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

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