@ai.ntellect/core 1.0.0 → 1.1.0

package/dist/execution/logger.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Handles logging operations for a graph instance
+ * Provides methods for adding, retrieving, and managing logs with optional verbose output
+ */
+export declare class GraphLogger {
+    private graphName;
+    private logs;
+    private verbose;
+    /**
+     * Creates a new GraphLogger instance
+     * @param graphName - The name of the graph this logger is associated with
+     * @param verbose - Whether to output logs to console in real-time
+     */
+    constructor(graphName: string, verbose?: boolean);
+    /**
+     * Adds a new log entry with timestamp
+     * @param message - The message to log
+     */
+    addLog(message: string): void;
+    /**
+     * Returns a copy of all stored logs
+     * @returns Array of log messages
+     */
+    getLogs(): string[];
+    /**
+     * Clears all stored logs
+     */
+    clearLogs(): void;
+    /**
+     * Sets the verbose mode
+     * @param enabled - Whether to enable verbose mode
+     */
+    setVerbose(enabled: boolean): void;
+    /**
+     * Gets the current verbose mode status
+     * @returns Current verbose mode state
+     */
+    isVerbose(): boolean;
+    /**
+     * Logs a message to console with graph name prefix
+     * @param message - The message to log
+     * @param data - Optional data to log
+     */
+    log(message: string, data?: any): void;
+}
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../execution/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,WAAW;IASV,OAAO,CAAC,SAAS;IAR7B,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,OAAO,CAAkB;IAEjC;;;;OAIG;gBACiB,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,OAAe;IAI/D;;;OAGG;IACI,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IASpC;;;OAGG;IACI,OAAO,IAAI,MAAM,EAAE;IAI1B;;OAEG;IACI,SAAS,IAAI,IAAI;IAIxB;;;OAGG;IACI,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIzC;;;OAGG;IACI,SAAS,IAAI,OAAO;IAI3B;;;;OAIG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;CAGvC"}

package/dist/execution/logger.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphLogger = void 0;
+/**
+ * Handles logging operations for a graph instance
+ * Provides methods for adding, retrieving, and managing logs with optional verbose output
+ */
+class GraphLogger {
+    /**
+     * Creates a new GraphLogger instance
+     * @param graphName - The name of the graph this logger is associated with
+     * @param verbose - Whether to output logs to console in real-time
+     */
+    constructor(graphName, verbose = false) {
+        this.graphName = graphName;
+        this.logs = [];
+        this.verbose = false;
+        this.verbose = verbose;
+    }
+    /**
+     * Adds a new log entry with timestamp
+     * @param message - The message to log
+     */
+    addLog(message) {
+        const timestamp = new Date().toISOString();
+        const logMessage = `[${timestamp}] ${message}`;
+        this.logs.push(logMessage);
+        if (this.verbose) {
+            console.log(`${this.graphName} - ${message}`);
+        }
+    }
+    /**
+     * Returns a copy of all stored logs
+     * @returns Array of log messages
+     */
+    getLogs() {
+        return [...this.logs];
+    }
+    /**
+     * Clears all stored logs
+     */
+    clearLogs() {
+        this.logs = [];
+    }
+    /**
+     * Sets the verbose mode
+     * @param enabled - Whether to enable verbose mode
+     */
+    setVerbose(enabled) {
+        this.verbose = enabled;
+    }
+    /**
+     * Gets the current verbose mode status
+     * @returns Current verbose mode state
+     */
+    isVerbose() {
+        return this.verbose;
+    }
+    /**
+     * Logs a message to console with graph name prefix
+     * @param message - The message to log
+     * @param data - Optional data to log
+     */
+    log(message, data) {
+        console.log(`[Graph ${this.graphName}] ${message}`, data);
+    }
+}
+exports.GraphLogger = GraphLogger;
+//# sourceMappingURL=logger.js.map

package/dist/execution/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../execution/logger.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAa,WAAW;IAItB;;;;OAIG;IACH,YAAoB,SAAiB,EAAE,UAAmB,KAAK;QAA3C,cAAS,GAAT,SAAS,CAAQ;QAR7B,SAAI,GAAa,EAAE,CAAC;QACpB,YAAO,GAAY,KAAK,CAAC;QAQ/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,OAAe;QAC3B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAG,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,MAAM,OAAO,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED;;;OAGG;IACI,OAAO;QACZ,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED;;OAEG;IACI,SAAS;QACd,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;IACjB,CAAC;IAED;;;OAGG;IACI,UAAU,CAAC,OAAgB;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;OAGG;IACI,SAAS;QACd,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,OAAe,EAAE,IAAU;QAC7B,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,SAAS,KAAK,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;IAC5D,CAAC;CACF;AAjED,kCAiEC"}

package/dist/execution/node.d.ts

@@ -0,0 +1,65 @@
+import { BehaviorSubject, Subject } from "rxjs";
+import { ZodSchema } from "zod";
+import { GraphContext, GraphEvent, GraphNodeConfig } from "../types";
+import { GraphEventManager } from "./event-manager";
+/**
+ * Represents a node in the graph that can execute operations and manage state
+ * @template T - The Zod schema type for validation
+ */
+export interface NodeParams<T = any> {
+    [key: string]: T;
+}
+export interface GraphLogger {
+    addLog: (message: string, data?: any) => void;
+}
+export interface NodeExecutionHooks<T extends ZodSchema> {
+    onBeforeExecute?: (nodeName: string, context: GraphContext<T>) => Promise<void>;
+    onBeforeExecuteNext?: (nodeName: string, context: GraphContext<T>, nextNodes: string[]) => Promise<void>;
+}
+export declare class GraphNode<T extends ZodSchema> {
+    private nodes;
+    private logger;
+    private eventManager;
+    private eventSubject;
+    private stateSubject;
+    private lastStateEvent;
+    private eventEmitter;
+    /**
+     * 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, GraphNodeConfig<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 params - Input data for the node
+     * @param triggeredByEvent - Whether the execution was triggered by an event
+     * @param hooks - Optional execution hooks
+     * @throws Error if the node is not found or execution fails
+     */
+    executeNode(nodeName: string, context: GraphContext<T>, triggeredByEvent?: boolean, hooks?: NodeExecutionHooks<T>): Promise<void>;
+    /**
+     * Executes a node with retry logic
+     * @param node - The node to execute
+     * @param contextProxy - The proxied graph context
+     * @param params - Input data for the node
+     * @param nodeName - The name of the node
+     * @param params - Parameters for the node
+     * @throws Error if all retry attempts fail
+     * @private
+     */
+    private executeWithRetry;
+}
+//# sourceMappingURL=node.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../execution/node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAc,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAIpD;;;GAGG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,GAAG;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,SAAS;IACrD,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,mBAAmB,CAAC,EAAE,CACpB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EACxB,SAAS,EAAE,MAAM,EAAE,KAChB,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED,qBAAa,SAAS,CAAC,CAAC,SAAS,SAAS;IAatC,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,YAAY;IAhBtB,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,YAAY,CAAgB;IAEpC;;;;;;;OAOG;gBAEO,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAC3C,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;IAKxD;;;;;OAKG;IACH,OAAO,CAAC,SAAS;IA+BjB;;;;;;;;OAQG;IACU,WAAW,CACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EACxB,gBAAgB,GAAE,OAAe,EACjC,KAAK,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC;IAuKhB;;;;;;;;;OASG;YACW,gBAAgB;CAmC/B"}

package/dist/execution/node.js

@@ -0,0 +1,250 @@
+"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;
+const send_api_1 = require("./send-api");
+const reducer_1 = require("./reducer");
+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;
+        this.lastStateEvent = null;
+        this.eventEmitter = eventManager["eventEmitter"];
+    }
+    /**
+     * 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) {
+        var _a;
+        if (type === "nodeStateChanged") {
+            if (((_a = this.lastStateEvent) === null || _a === void 0 ? void 0 : _a.type) === type &&
+                this.lastStateEvent.payload.property === payload.property &&
+                this.lastStateEvent.payload.newValue === payload.newValue &&
+                this.lastStateEvent.payload.nodeName === payload.nodeName) {
+                return;
+            }
+        }
+        const event = {
+            type,
+            payload: Object.assign(Object.assign({}, payload), { name: type === "nodeStateChanged" ? payload.nodeName : payload.name, context: Object.assign({}, payload.context) }),
+            timestamp: Date.now(),
+        };
+        this.eventSubject.next(event);
+        this.eventManager.emitEvent(type, event);
+        if (type === "nodeStateChanged") {
+            this.lastStateEvent = event;
+            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 params - Input data for the node
+     * @param triggeredByEvent - Whether the execution was triggered by an event
+     * @param hooks - Optional execution hooks
+     * @throws Error if the node is not found or execution fails
+     */
+    executeNode(nodeName_1, context_1) {
+        return __awaiter(this, arguments, void 0, function* (nodeName, context, triggeredByEvent = false, hooks) {
+            var _a, _b;
+            const node = this.nodes.get(nodeName);
+            if (!node)
+                throw new Error(`Node "${nodeName}" not found.`);
+            if (hooks === null || hooks === void 0 ? void 0 : hooks.onBeforeExecute) {
+                yield hooks.onBeforeExecute(nodeName, context);
+            }
+            const nodeContext = Object.assign({}, context);
+            this.emitEvent("nodeStarted", { name: nodeName, context: nodeContext });
+            try {
+                if (node.when) {
+                    yield this.eventManager.handleNodeEvents(nodeName, node.when);
+                }
+                const contextProxy = new Proxy(nodeContext, {
+                    set: (target, prop, value) => {
+                        const oldValue = target[prop.toString()];
+                        if (oldValue === value)
+                            return true;
+                        target[prop.toString()] = value;
+                        context[prop.toString()] = value;
+                        this.emitEvent("nodeStateChanged", {
+                            nodeName,
+                            property: prop.toString(),
+                            oldValue,
+                            newValue: value,
+                            context: Object.assign({}, target),
+                        });
+                        return true;
+                    },
+                });
+                if (node.condition && !node.condition(contextProxy)) {
+                    return;
+                }
+                yield this.executeWithRetry(node, contextProxy, nodeName);
+                this.emitEvent("nodeCompleted", { name: nodeName, context: nodeContext });
+                // ====== HANDOFF / COMMAND DETECTION ======
+                const command = context._handoff || context._command;
+                if (command === null || command === void 0 ? void 0 : command.goto) {
+                    if (command.graph === "PARENT") {
+                        return; // Stop here; parent orchestrator checks context._handoff
+                    }
+                    if (this.nodes.has(command.goto)) {
+                        if (command.update)
+                            Object.assign(context, command.update);
+                        yield this.executeNode(command.goto, context, false, hooks);
+                        return;
+                    }
+                }
+                if (!triggeredByEvent && (node.next || node.send)) {
+                    const nextNodes = typeof node.next === "function" ? node.next(contextProxy) : node.next;
+                    // ====== SEND API (Fan-out dynamique) ======
+                    if (node.send) {
+                        const sends = node.send(contextProxy);
+                        const branchResults = yield send_api_1.SendAPI.processSends(sends, context, (nodeName, ctx) => this.executeNode(nodeName, ctx, false, hooks));
+                        // Merge avec reducers
+                        const merged = (0, reducer_1.applyReducers)(context, branchResults, node.reducers || []);
+                        Object.assign(context, merged);
+                        // Si un joinNode est spécifié (dans parallel), l'exécuter
+                        const joinNode = (_a = node.parallel) === null || _a === void 0 ? void 0 : _a.joinNode;
+                        if (joinNode) {
+                            yield this.executeNode(joinNode, context, false, hooks);
+                        }
+                        return; // Pas de next séquentiel après Send
+                    }
+                    // Filtrer les valeurs nulles/undefined
+                    const nextNodeConfigs = (Array.isArray(nextNodes) ? nextNodes : [nextNodes]).filter((n) => n != null);
+                    const validNextNodes = nextNodeConfigs
+                        .map((nextNode) => {
+                        const nextNodeName = typeof nextNode === "string" ? nextNode : nextNode.node;
+                        const condition = typeof nextNode === "string" ? undefined : nextNode.condition;
+                        return {
+                            name: nextNodeName,
+                            condition,
+                            isValid: !condition || (condition && condition(contextProxy)),
+                        };
+                    })
+                        .filter((n) => n.isValid);
+                    const nextNodeNames = validNextNodes.map((n) => n.name);
+                    if (hooks === null || hooks === void 0 ? void 0 : hooks.onBeforeExecuteNext) {
+                        yield hooks.onBeforeExecuteNext(nodeName, context, nextNodeNames);
+                    }
+                    // ====== PARALLÉLISME FORK-JOIN ======
+                    if ((_b = node.parallel) === null || _b === void 0 ? void 0 : _b.enabled) {
+                        const { joinNode, reducers, mergeStrategy } = node.parallel;
+                        // Fork : cloner le contexte pour chaque branche
+                        const branchContexts = validNextNodes.map((n, i) => ({
+                            nodeName: n.name,
+                            context: structuredClone(context),
+                            branchId: `${n.name}_${i}`,
+                        }));
+                        // Exécution parallèle (Promise.all)
+                        const branchResults = yield Promise.all(branchContexts.map((_a) => __awaiter(this, [_a], void 0, function* ({ nodeName, context: ctx, branchId }) {
+                            yield this.executeNode(nodeName, ctx, false, hooks);
+                            return { branchId, context: ctx };
+                        })));
+                        // Join : merger les résultats
+                        if (reducers && reducers.length > 0) {
+                            const merged = (0, reducer_1.applyReducers)(context, branchResults, reducers);
+                            Object.assign(context, merged);
+                        }
+                        else if (mergeStrategy === "isolated") {
+                            branchResults.forEach(({ branchId, context: ctx }) => {
+                                context[`branch_${branchId}`] = ctx;
+                            });
+                        }
+                        else {
+                            // deep-merge par défaut
+                            const { deepMerge } = require("./reducer");
+                            const merged = deepMerge(context, ...branchResults.map((r) => r.context));
+                            Object.assign(context, merged);
+                        }
+                        // Si un joinNode est spécifié, l'exécuter
+                        if (joinNode) {
+                            yield this.executeNode(joinNode, context, false, hooks);
+                        }
+                        return;
+                    }
+                    // ====== SÉQUENTIEL (logique existante) ======
+                    for (const nextNode of validNextNodes) {
+                        yield this.executeNode(nextNode.name, context, false, hooks);
+                        if (context._handoff || context._command)
+                            break;
+                    }
+                }
+            }
+            catch (error) {
+                this.emitEvent("nodeError", {
+                    name: nodeName,
+                    error,
+                    context: nodeContext,
+                });
+                throw error;
+            }
+        });
+    }
+    /**
+     * Executes a node with retry logic
+     * @param node - The node to execute
+     * @param contextProxy - The proxied graph context
+     * @param params - Input data for the node
+     * @param nodeName - The name of the node
+     * @param params - Parameters for the node
+     * @throws Error if all retry attempts fail
+     * @private
+     */
+    executeWithRetry(node, contextProxy, nodeName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            let attempts = 0;
+            let lastError = new Error("Unknown error");
+            while (attempts < (((_a = node.retry) === null || _a === void 0 ? void 0 : _a.maxAttempts) || 1)) {
+                try {
+                    yield node.execute(contextProxy, {
+                        eventEmitter: this.eventEmitter,
+                    });
+                    return;
+                }
+                catch (error) {
+                    lastError =
+                        error instanceof Error
+                            ? error
+                            : new Error((error === null || error === void 0 ? void 0 : error.message) || "Unknown error");
+                    attempts++;
+                    if (attempts === (((_b = node.retry) === null || _b === void 0 ? void 0 : _b.maxAttempts) || 1)) {
+                        if ((_c = node.retry) === null || _c === void 0 ? void 0 : _c.onRetryFailed) {
+                            yield node.retry.onRetryFailed(lastError, contextProxy);
+                            if (node.retry.continueOnFailed)
+                                return;
+                        }
+                        throw lastError;
+                    }
+                    yield new Promise((resolve) => { var _a; return setTimeout(resolve, ((_a = node.retry) === null || _a === void 0 ? void 0 : _a.delay) || 0); });
+                }
+            }
+        });
+    }
+}
+exports.GraphNode = GraphNode;
+//# sourceMappingURL=node.js.map

package/dist/execution/node.js.map

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

package/dist/execution/observer.d.ts

@@ -0,0 +1,38 @@
+import { BehaviorSubject, Subject } from "rxjs";
+import { ZodSchema } from "zod";
+import { GraphObservable } from "../interfaces";
+import { GraphContext, GraphEvent, ObserverOptions } from "../types";
+import { GraphEventManager } from "./event-manager";
+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;
+    private eventManager;
+    constructor(graph: GraphFlow<T>, eventSubject: Subject<GraphEvent<T>>, stateSubject: BehaviorSubject<GraphContext<T>>, destroySubject: Subject<void>, eventManager: GraphEventManager<T>);
+    /**
+     * Observes the entire graph state changes
+     * @param options Configuration options for the observation
+     * @returns An Observable that emits the complete graph context whenever it changes
+     */
+    state(options?: ObserverOptions): GraphObservable<T>;
+    /**
+     * 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 in milliseconds
+     * @param correlationFn - Function to validate event correlation
+     * @returns Promise that resolves with the correlated events
+     */
+    waitForCorrelatedEvents(eventTypes: string[], timeoutMs: number, correlationFn: (events: GraphEvent<T>[]) => boolean): Promise<GraphEvent<T>[]>;
+    /**
+     * Streams a message letter by letter with a specified delay
+     */
+    private streamMessage;
+}
+//# sourceMappingURL=observer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observer.d.ts","sourceRoot":"","sources":["../../execution/observer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAEf,OAAO,EAGR,MAAM,MAAM,CAAC;AAUd,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;;;GAIG;AACH,qBAAa,aAAa,CAAC,CAAC,SAAS,SAAS;IAE1C,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,YAAY;gBAJZ,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EACpC,YAAY,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAC9C,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,EAC7B,YAAY,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAG5C;;;;OAIG;IACH,KAAK,CAAC,OAAO,GAAE,eAAoB,GAAG,eAAe,CAAC,CAAC,CAAC;IAoFxD;;;;;;OAMG;IACH,uBAAuB,CACrB,UAAU,EAAE,MAAM,EAAE,EACpB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,GAClD,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAkC3B;;OAEG;IACH,OAAO,CAAC,aAAa;CAkBtB"}

package/dist/execution/observer.js

@@ -0,0 +1,111 @@
+"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, eventManager) {
+        this.graph = graph;
+        this.eventSubject = eventSubject;
+        this.stateSubject = stateSubject;
+        this.destroySubject = destroySubject;
+        this.eventManager = eventManager;
+    }
+    /**
+     * Observes the entire graph state changes
+     * @param options Configuration options for the observation
+     * @returns An Observable that emits the complete graph context whenever it changes
+     */
+    state(options = {}) {
+        const baseObservable = new rxjs_1.Observable((subscriber) => {
+            const subscription = (0, rxjs_1.combineLatest)([
+                this.eventSubject.pipe((0, operators_1.filter)((event) => event.type === "nodeStateChanged"), (0, operators_1.map)((event) => event.payload.context), (0, operators_1.distinctUntilChanged)((prev, curr) => JSON.stringify(prev) === JSON.stringify(curr)), (0, operators_1.debounceTime)(options.debounce || 100)),
+                this.stateSubject,
+            ])
+                .pipe((0, operators_1.map)(([eventContext, stateContext]) => (Object.assign(Object.assign({}, stateContext), eventContext))), (0, operators_1.distinctUntilChanged)((prev, curr) => JSON.stringify(prev) === JSON.stringify(curr)))
+                .subscribe(subscriber);
+            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();
+        });
+        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))),
+        });
+    }
+    /**
+     * 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 in milliseconds
+     * @param correlationFn - Function to validate event correlation
+     * @returns Promise that resolves with the correlated events
+     */
+    waitForCorrelatedEvents(eventTypes, timeoutMs, correlationFn) {
+        return new Promise((resolve, reject) => {
+            const events = [];
+            const timeout = setTimeout(() => {
+                reject(new Error(`Timeout waiting for correlated events: ${eventTypes.join(", ")}`));
+            }, timeoutMs);
+            const subscription = this.eventSubject
+                .pipe((0, operators_1.filter)((event) => eventTypes.includes(event.type)), (0, operators_1.takeUntil)(this.destroySubject))
+                .subscribe({
+                next: (event) => {
+                    events.push(event);
+                    if (events.length === eventTypes.length && correlationFn(events)) {
+                        clearTimeout(timeout);
+                        subscription.unsubscribe();
+                        resolve(events);
+                    }
+                },
+                error: (error) => {
+                    clearTimeout(timeout);
+                    subscription.unsubscribe();
+                    reject(error);
+                },
+            });
+        });
+    }
+    /**
+     * Streams a message letter by letter with a specified delay
+     */
+    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/execution/observer.js.map

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

package/dist/execution/planner.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+import { ToolRegistry } from './registry';
+export declare const PlanSchema: z.ZodObject<{
+    goal: z.ZodString;
+    steps: z.ZodArray<z.ZodObject<{
+        node: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Plan = z.infer<typeof PlanSchema>;
+export declare function generatePlan(userIntent: string, registry: ToolRegistry, llmCall: (prompt: string) => Promise<string>): Promise<Plan>;
+export declare function renderPlan(plan: Plan): string;
+//# sourceMappingURL=planner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../execution/planner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAY,MAAM,YAAY,CAAC;AAEpD,eAAO,MAAM,UAAU;;;;;;;iBASrB,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C"}