@ai.ntellect/core 0.7.1 → 0.7.2

package/dist/graph/node.js

@@ -0,0 +1,310 @@
+"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: Object.assign({}, context) });
+            try {
+                const contextProxy = new Proxy(context, {
+                    set: (target, prop, value) => {
+                        const oldValue = target[prop];
+                        target[prop] = value;
+                        this.emitEvent("nodeStateChanged", {
+                            nodeName,
+                            name: nodeName,
+                            property: prop.toString(),
+                            oldValue,
+                            newValue: value,
+                            context: Object.assign({}, target),
+                        });
+                        return true;
+                    },
+                    get: (target, prop) => {
+                        return target[prop];
+                    },
+                });
+                if (node.condition && !node.condition(contextProxy)) {
+                    this.logger.addLog(`⏭️ Skipping node "${nodeName}" - condition not met`);
+                    return;
+                }
+                if (node.inputs) {
+                    yield this.validateInputs(node, inputs, nodeName);
+                }
+                if (node.retry && node.retry.maxAttempts > 0) {
+                    yield this.executeWithRetry(node, contextProxy, inputs, nodeName);
+                }
+                else {
+                    yield node.execute(contextProxy, inputs);
+                }
+                if (node.outputs) {
+                    yield this.validateOutputs(node, contextProxy, nodeName);
+                }
+                if (!triggeredByEvent) {
+                    const nextNodes = typeof node.next === "function"
+                        ? node.next(contextProxy)
+                        : node.next || [];
+                    for (const nextNodeName of nextNodes) {
+                        const nextNode = this.nodes.get(nextNodeName);
+                        if (nextNode &&
+                            (!nextNode.condition || nextNode.condition(contextProxy))) {
+                            yield this.executeNode(nextNodeName, contextProxy, undefined, false);
+                        }
+                    }
+                }
+                if (!triggeredByEvent) {
+                    yield this.handleEvents(node, nodeName, contextProxy);
+                }
+                this.logger.addLog(`✅ Node "${nodeName}" executed successfully`);
+                this.emitEvent("nodeCompleted", {
+                    name: nodeName,
+                    context: Object.assign({}, contextProxy),
+                });
+            }
+            catch (error) {
+                const errorToThrow = error instanceof Error
+                    ? error
+                    : new Error(error.message || "Unknown error");
+                this.logger.addLog(`❌ Error in node "${nodeName}": ${errorToThrow.message}`);
+                this.emitEvent("nodeError", {
+                    name: nodeName,
+                    error: errorToThrow,
+                    context,
+                });
+                throw errorToThrow;
+            }
+        });
+    }
+    /**
+     * 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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"}

package/dist/graph/observer.js

@@ -0,0 +1,197 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphObserver = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+/**
+ * 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
+ */
+class GraphObserver {
+    constructor(graph, eventSubject, stateSubject, destroySubject) {
+        this.graph = graph;
+        this.eventSubject = eventSubject;
+        this.stateSubject = stateSubject;
+        this.destroySubject = destroySubject;
+    }
+    /**
+     * 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 = {}) {
+        const baseObservable = new rxjs_1.Observable((subscriber) => {
+            const subscription = this.eventSubject
+                .pipe((0, operators_1.filter)((event) => event.type === "nodeStateChanged" ||
+                event.type === "nodeStarted" ||
+                event.type === "nodeCompleted"), (0, operators_1.map)((event) => event.payload.context), (0, operators_1.startWith)(this.stateSubject.getValue()), (0, operators_1.distinctUntilChanged)((prev, curr) => JSON.stringify(prev) === JSON.stringify(curr)))
+                .subscribe(subscriber);
+            // Stream the specified properties if specified
+            if (options.stream && options.properties) {
+                const context = this.stateSubject.getValue();
+                options.properties.forEach((property) => {
+                    const message = context[property];
+                    if (message) {
+                        this.streamMessage(message.toString(), 500, property).subscribe({
+                            next: (data) => { var _a; return (_a = options.onStreamLetter) === null || _a === void 0 ? void 0 : _a.call(options, data); },
+                            complete: () => { var _a; return (_a = options.onStreamComplete) === null || _a === void 0 ? void 0 : _a.call(options); },
+                        });
+                    }
+                });
+            }
+            return () => subscription.unsubscribe();
+        });
+        // Extend the observable with our custom methods
+        return Object.assign(baseObservable, {
+            state: () => this.stateSubject.asObservable(),
+            node: (nodeName) => this.stateSubject.pipe((0, operators_1.map)((state) => (Object.assign(Object.assign({}, state), { nodeName })))),
+            nodes: (nodeNames) => this.eventSubject.pipe((0, operators_1.filter)((event) => {
+                var _a, _b;
+                return event.type === "nodeStateChanged" &&
+                    nodeNames.includes((_b = (_a = event.payload) === null || _a === void 0 ? void 0 : _a.name) !== null && _b !== void 0 ? _b : "");
+            }), (0, operators_1.map)((event) => event.payload.context), (0, operators_1.distinctUntilChanged)((prev, curr) => JSON.stringify(prev) === JSON.stringify(curr)), (0, operators_1.takeUntil)(this.destroySubject), (0, operators_1.share)()),
+            property: (props) => this.stateSubject.pipe((0, operators_1.map)((state) => {
+                const properties = Array.isArray(props) ? props : [props];
+                return properties.reduce((acc, prop) => (Object.assign(Object.assign({}, acc), { [prop]: state[prop] })), {});
+            })),
+            event: (eventName) => this.eventSubject.pipe((0, operators_1.filter)((event) => event.type === eventName)),
+            until: (observable, predicate) => (0, rxjs_1.firstValueFrom)(observable.pipe((0, operators_1.filter)(predicate), (0, operators_1.take)(1))),
+        });
+    }
+    /**
+     * 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) {
+        return this.eventSubject.pipe((0, operators_1.filter)((event) => { var _a; return event.type === "nodeStateChanged" && ((_a = event.payload) === null || _a === void 0 ? void 0 : _a.name) === name; }), (0, operators_1.map)((event) => event.payload.context), (0, operators_1.distinctUntilChanged)((prev, curr) => JSON.stringify(prev) === JSON.stringify(curr)), (0, operators_1.takeUntil)(this.destroySubject), (0, operators_1.share)());
+    }
+    /**
+     * 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) {
+        return this.eventSubject.pipe((0, operators_1.filter)((event) => {
+            var _a, _b;
+            return names.includes((_b = (_a = event.payload) === null || _a === void 0 ? void 0 : _a.name) !== null && _b !== void 0 ? _b : "") &&
+                event.type === "nodeStateChanged";
+        }), (0, operators_1.map)(() => this.graph.getContext()), (0, operators_1.distinctUntilChanged)((prev, curr) => JSON.stringify(prev) === JSON.stringify(curr)), (0, operators_1.takeUntil)(this.destroySubject), (0, operators_1.share)());
+    }
+    /**
+     * 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(keys) {
+        const properties = Array.isArray(keys) ? keys : [keys];
+        return this.eventSubject.pipe((0, operators_1.filter)((event) => event.type === "nodeStateChanged" &&
+            properties.some((key) => { var _a; return ((_a = event.payload) === null || _a === void 0 ? void 0 : _a.property) === key; })), (0, operators_1.map)((event) => (Object.assign(Object.assign({}, properties.reduce((obj, key) => (Object.assign(Object.assign({}, obj), { [key]: event.payload.context[key] })), {})), { name: event.payload.name }))), (0, operators_1.startWith)(Object.assign(Object.assign({}, properties.reduce((obj, key) => (Object.assign(Object.assign({}, obj), { [key]: this.stateSubject.value[key] })), {})), { name: "initial" })), (0, operators_1.distinctUntilChanged)((prev, curr) => JSON.stringify(prev) === JSON.stringify(curr)), (0, operators_1.share)());
+    }
+    /**
+     * 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) {
+        return this.eventSubject.pipe((0, operators_1.filter)((event) => event.type === type), (0, operators_1.map)((event) => event), (0, operators_1.takeUntil)(this.destroySubject), (0, operators_1.share)());
+    }
+    /**
+     * 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(observable, predicate) {
+        return new Promise((resolve) => {
+            const subscription = observable.subscribe({
+                next: (value) => {
+                    if (predicate(value)) {
+                        subscription.unsubscribe();
+                        resolve(value);
+                    }
+                },
+            });
+        });
+    }
+    /**
+     * 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, timeoutMs, correlationFn) {
+        return new Promise((resolve, reject) => {
+            const eventObservables = eventTypes.map((eventType) => this.eventSubject.pipe((0, operators_1.filter)((event) => {
+                return event.type === eventType && "timestamp" in event;
+            }), (0, operators_1.take)(1)));
+            (0, rxjs_1.combineLatest)(eventObservables)
+                .pipe((0, operators_1.timeout)(timeoutMs), (0, operators_1.take)(1))
+                .subscribe({
+                next: (events) => {
+                    if (correlationFn(events)) {
+                        resolve(events);
+                    }
+                    else {
+                        reject(new Error(`Correlation validation failed`));
+                    }
+                },
+                error: (error) => reject(error),
+            });
+        });
+    }
+    /**
+     * Observes the current state of the graph
+     * @returns Observable that emits the current graph context
+     */
+    observeState() {
+        return this.stateSubject.asObservable().pipe((0, operators_1.takeUntil)(this.destroySubject), (0, operators_1.distinctUntilChanged)((prev, curr) => JSON.stringify(prev) === JSON.stringify(curr)));
+    }
+    /**
+     * 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) {
+        return this.eventSubject.asObservable().pipe((0, operators_1.takeUntil)(this.destroySubject), (0, operators_1.filter)((event) => event.type === eventType));
+    }
+    /**
+     * 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) {
+        return this.eventSubject.asObservable().pipe((0, operators_1.takeUntil)(this.destroySubject), (0, operators_1.filter)((event) => { var _a; return event.type === "nodeStateChanged" && ((_a = event.payload) === null || _a === void 0 ? void 0 : _a.name) === nodeName; }), (0, operators_1.map)(() => this.stateSubject.value));
+    }
+    /**
+     * 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, delayMs, property) {
+        return new rxjs_1.Observable((subscriber) => {
+            for (let i = 0; i < message.length; i++) {
+                setTimeout(() => {
+                    subscriber.next({ letter: message[i], property });
+                    if (i === message.length - 1) {
+                        subscriber.complete();
+                    }
+                }, i * delayMs);
+            }
+        });
+    }
+}
+exports.GraphObserver = GraphObserver;
+//# sourceMappingURL=observer.js.map

package/dist/graph/observer.js.map

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