@ai.ntellect/core 1.0.0 → 1.1.0

package/dist/agent/tools/logger.js

@@ -0,0 +1,86 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.AgentLogger = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+class AgentLogger {
+    constructor(enabled = true, maxLogs = 1000) {
+        this.logs = [];
+        this.enabled = enabled;
+        this.maxLogs = maxLogs;
+    }
+    enable() { this.enabled = true; }
+    disable() { this.enabled = false; }
+    isEnabled() { return this.enabled; }
+    log(level, source, message, data) {
+        const entry = {
+            timestamp: new Date(),
+            level,
+            source,
+            message,
+            data,
+        };
+        this.logs.push(entry);
+        if (this.logs.length > this.maxLogs) {
+            this.logs.shift();
+        }
+        if (!this.enabled)
+            return;
+        const colors = {
+            debug: chalk_1.default.gray,
+            info: chalk_1.default.blue,
+            warn: chalk_1.default.yellow,
+            error: chalk_1.default.red,
+        };
+        const time = new Date().toLocaleTimeString("fr-FR", { hour12: false });
+        const prefix = colors[level](`[${time}]`);
+        const src = chalk_1.default.cyan(`[${source}]`);
+        console.log(`${prefix} ${src} ${message}`);
+    }
+    debug(source, message, data) { this.log("debug", source, message, data); }
+    info(source, message, data) { this.log("info", source, message, data); }
+    warn(source, message, data) { this.log("warn", source, message, data); }
+    error(source, message, data) { this.log("error", source, message, data); }
+    think(source, message, reasoning) {
+        const time = new Date().toLocaleTimeString("fr-FR", { hour12: false });
+        console.log(`${chalk_1.default.cyan(`[${time}]`)} ${chalk_1.default.cyan(`[${source}]`)} ${message}`);
+        if (reasoning) {
+            console.log(chalk_1.default.gray("  → ") + chalk_1.default.gray(reasoning.substring(0, 500)));
+        }
+    }
+    action(source, toolName, params) {
+        const time = new Date().toLocaleTimeString("fr-FR", { hour12: false });
+        const p = JSON.stringify(params).substring(0, 150);
+        console.log(`${chalk_1.default.yellow(`[${time}]`)} ${chalk_1.default.cyan(`[${source}]`)} → ${toolName}(${p})`);
+    }
+    result(source, toolName, result) {
+        const time = new Date().toLocaleTimeString("fr-FR", { hour12: false });
+        const r = JSON.stringify(result).substring(0, 150);
+        console.log(`${chalk_1.default.green(`[${time}]`)} ${chalk_1.default.green(`[${source}]`)} ${toolName} → ${r})`);
+    }
+    getLogs() { return [...this.logs]; }
+    getLogsByLevel(level) { return this.logs.filter((l) => l.level === level); }
+    getLogsBySource(source) { return this.logs.filter((l) => l.source === source); }
+    clearLogs() { this.logs = []; }
+    exportHistory() {
+        return this.logs.map((l) => {
+            const time = l.timestamp.toISOString();
+            const dataStr = l.data ? ` | ${JSON.stringify(l.data)}` : "";
+            return `[${time}] [${l.level.toUpperCase()}] [${l.source}] ${l.message}${dataStr}`;
+        }).join("\n");
+    }
+    printSummary() {
+        console.log(chalk_1.default.bold("\n=== Agent Log Summary ==="));
+        console.log(`Total logs: ${this.logs.length}`);
+        console.log(`Debug: ${this.getLogsByLevel("debug").length}`);
+        console.log(`Info: ${this.getLogsByLevel("info").length}`);
+        console.log(`Warn: ${this.getLogsByLevel("warn").length}`);
+        console.log(`Error: ${this.getLogsByLevel("error").length}`);
+        console.log(chalk_1.default.bold("========================\n"));
+    }
+}
+exports.AgentLogger = AgentLogger;
+exports.logger = new AgentLogger(true);
+//# sourceMappingURL=logger.js.map

package/dist/agent/tools/logger.js.map

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

package/dist/agent/tools/tool-resolver.d.ts

@@ -0,0 +1,7 @@
+export type ResolvedEntity = {
+    type: "file" | "dir";
+    path: string;
+};
+export declare function resolvePath(userPath: string, cwd: string): ResolvedEntity[];
+export declare function findInCwd(filename: string, cwd: string): string | null;
+//# sourceMappingURL=tool-resolver.d.ts.map

package/dist/agent/tools/tool-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-resolver.d.ts","sourceRoot":"","sources":["../../../agent/tools/tool-resolver.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE,CAwE3E;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqBtE"}

package/dist/agent/tools/tool-resolver.js

@@ -0,0 +1,122 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePath = resolvePath;
+exports.findInCwd = findInCwd;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function resolvePath(userPath, cwd) {
+    const candidates = [];
+    const absolutePath = path.isAbsolute(userPath) ? userPath : path.join(cwd, userPath);
+    if (fs.existsSync(absolutePath)) {
+        const stat = fs.statSync(absolutePath);
+        candidates.push({ type: stat.isDirectory() ? "dir" : "file", path: absolutePath });
+        return candidates;
+    }
+    if (path.isAbsolute(userPath)) {
+        return candidates;
+    }
+    const parentDir = path.dirname(absolutePath);
+    const baseName = path.basename(absolutePath);
+    if (fs.existsSync(parentDir)) {
+        const entries = fs.readdirSync(parentDir);
+        const lowerTarget = baseName.toLowerCase();
+        for (const entry of entries) {
+            if (entry.toLowerCase() === lowerTarget) {
+                const fullPath = path.join(parentDir, entry);
+                const stat = fs.statSync(fullPath);
+                candidates.push({ type: stat.isDirectory() ? "dir" : "file", path: fullPath });
+            }
+        }
+        const noExt = baseName.includes(".") ? null : baseName;
+        if (noExt) {
+            for (const entry of entries) {
+                const entryNoExt = entry.includes(".") ? entry.substring(0, entry.lastIndexOf(".")) : entry;
+                if (entryNoExt.toLowerCase() === noExt.toLowerCase()) {
+                    const fullPath = path.join(parentDir, entry);
+                    const stat = fs.statSync(fullPath);
+                    candidates.push({ type: stat.isDirectory() ? "dir" : "file", path: fullPath });
+                }
+            }
+        }
+    }
+    if (candidates.length === 0) {
+        const root = cwd;
+        const rootEntries = fs.readdirSync(root);
+        const lowerBase = baseName.toLowerCase();
+        for (const entry of rootEntries) {
+            if (entry.toLowerCase() === lowerBase) {
+                const fullPath = path.join(root, entry);
+                const stat = fs.statSync(fullPath);
+                candidates.push({ type: stat.isDirectory() ? "dir" : "file", path: fullPath });
+                break;
+            }
+        }
+        if (candidates.length === 0) {
+            const noExt2 = baseName.includes(".") ? null : baseName;
+            if (noExt2) {
+                for (const entry of rootEntries) {
+                    const entryNoExt = entry.includes(".") ? entry.substring(0, entry.lastIndexOf(".")) : entry;
+                    if (entryNoExt.toLowerCase() === noExt2.toLowerCase()) {
+                        const fullPath = path.join(root, entry);
+                        const stat = fs.statSync(fullPath);
+                        candidates.push({ type: stat.isDirectory() ? "dir" : "file", path: fullPath });
+                    }
+                }
+            }
+        }
+    }
+    return candidates;
+}
+function findInCwd(filename, cwd) {
+    const entries = fs.readdirSync(cwd);
+    const lowerName = filename.toLowerCase();
+    for (const entry of entries) {
+        if (entry.toLowerCase() === lowerName) {
+            return path.join(cwd, entry);
+        }
+    }
+    const noExt = filename.includes(".") ? null : filename;
+    if (noExt) {
+        for (const entry of entries) {
+            const entryNoExt = entry.includes(".") ? entry.substring(0, entry.lastIndexOf(".")) : entry;
+            if (entryNoExt.toLowerCase() === noExt.toLowerCase()) {
+                return path.join(cwd, entry);
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=tool-resolver.js.map

package/dist/agent/tools/tool-resolver.js.map

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

package/dist/execution/adapters/in-memory-checkpoint.d.ts

@@ -0,0 +1,11 @@
+import { ICheckpointAdapter } from "../../interfaces";
+import { Checkpoint } from "../../types";
+export declare class InMemoryCheckpointAdapter implements ICheckpointAdapter {
+    private storage;
+    save(checkpoint: Checkpoint): Promise<void>;
+    load(id: string): Promise<Checkpoint | null>;
+    list(graphName: string): Promise<Checkpoint[]>;
+    delete(id: string): Promise<void>;
+    clear(graphName?: string): Promise<void>;
+}
+//# sourceMappingURL=in-memory-checkpoint.d.ts.map

package/dist/execution/adapters/in-memory-checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-checkpoint.d.ts","sourceRoot":"","sources":["../../../execution/adapters/in-memory-checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,qBAAa,yBAA0B,YAAW,kBAAkB;IAClE,OAAO,CAAC,OAAO,CAAiC;IAE1C,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAK5C,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAM9C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAS/C"}

package/dist/execution/adapters/in-memory-checkpoint.js

@@ -0,0 +1,54 @@
+"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.InMemoryCheckpointAdapter = void 0;
+class InMemoryCheckpointAdapter {
+    constructor() {
+        this.storage = new Map();
+    }
+    save(checkpoint) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.storage.set(checkpoint.id, structuredClone(checkpoint));
+        });
+    }
+    load(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const cp = this.storage.get(id);
+            return cp ? structuredClone(cp) : null;
+        });
+    }
+    list(graphName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return Array.from(this.storage.values())
+                .filter((cp) => cp.graphName === graphName)
+                .sort((a, b) => b.metadata.createdAt - a.metadata.createdAt);
+        });
+    }
+    delete(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.storage.delete(id);
+        });
+    }
+    clear(graphName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!graphName) {
+                this.storage.clear();
+                return;
+            }
+            for (const [id, cp] of this.storage) {
+                if (cp.graphName === graphName)
+                    this.storage.delete(id);
+            }
+        });
+    }
+}
+exports.InMemoryCheckpointAdapter = InMemoryCheckpointAdapter;
+//# sourceMappingURL=in-memory-checkpoint.js.map

package/dist/execution/adapters/in-memory-checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-checkpoint.js","sourceRoot":"","sources":["../../../execution/adapters/in-memory-checkpoint.ts"],"names":[],"mappings":";;;;;;;;;;;;AAGA,MAAa,yBAAyB;IAAtC;QACU,YAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IA8BlD,CAAC;IA5BO,IAAI,CAAC,UAAsB;;YAC/B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC;QAC/D,CAAC;KAAA;IAEK,IAAI,CAAC,EAAU;;YACnB,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChC,OAAO,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACzC,CAAC;KAAA;IAEK,IAAI,CAAC,SAAiB;;YAC1B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;iBACrC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,KAAK,SAAS,CAAC;iBAC1C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACjE,CAAC;KAAA;IAEK,MAAM,CAAC,EAAU;;YACrB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC;KAAA;IAEK,KAAK,CAAC,SAAkB;;YAC5B,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBACrB,OAAO;YACT,CAAC;YACD,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACpC,IAAI,EAAE,CAAC,SAAS,KAAK,SAAS;oBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;KAAA;CACF;AA/BD,8DA+BC"}

package/dist/execution/compiler.d.ts

@@ -0,0 +1,8 @@
+import { GraphFlow } from './index';
+import { Plan } from './planner';
+import { ToolRegistry } from './registry';
+export declare function compilePlan(plan: Plan, registry: ToolRegistry): {
+    graph: GraphFlow<any>;
+    startNode: string;
+};
+//# sourceMappingURL=compiler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../execution/compiler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,GAAG;IAAE,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAyC5G"}

package/dist/execution/compiler.js

@@ -0,0 +1,50 @@
+"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.compilePlan = compilePlan;
+const index_1 = require("./index");
+const zod_1 = require("zod");
+function compilePlan(plan, registry) {
+    const graph = new index_1.GraphFlow({
+        name: 'compiled-plan',
+        context: {},
+        schema: zod_1.z.object({}).passthrough(),
+        nodes: [],
+        entryNode: '',
+    });
+    plan.steps.forEach((step, index) => {
+        const tool = registry.get(step.node);
+        if (!tool) {
+            throw new Error(`Unknown tool: ${step.node}`);
+        }
+        const nodeName = `step_${index}_${step.node}`;
+        const nextNode = index < plan.steps.length - 1
+            ? `step_${index + 1}_${plan.steps[index + 1].node}`
+            : undefined;
+        graph.addNode({
+            name: nodeName,
+            execute: (ctx) => __awaiter(this, void 0, void 0, function* () {
+                // Merge accumulated context with step params
+                const toolCtx = Object.assign(Object.assign({}, ctx), step.params);
+                console.log(`  [${nodeName}] Executing ${step.node} with:`, toolCtx);
+                // Execute the tool's graph
+                const resultCtx = yield tool.graph.execute(tool.startNode, toolCtx);
+                // Merge tool result back into ctx (which is the graph's context)
+                Object.assign(ctx, resultCtx, { _lastStep: step.node });
+                console.log(`  [${nodeName}] Updated context:`, ctx);
+            }),
+            next: nextNode,
+        });
+    });
+    const startNode = plan.steps.length > 0 ? `step_0_${plan.steps[0].node}` : '';
+    return { graph, startNode };
+}
+//# sourceMappingURL=compiler.js.map

package/dist/execution/compiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.js","sourceRoot":"","sources":["../../execution/compiler.ts"],"names":[],"mappings":";;;;;;;;;;;AAKA,kCAyCC;AA9CD,mCAAoC;AACpC,6BAAwB;AAIxB,SAAgB,WAAW,CAAC,IAAU,EAAE,QAAsB;IAC5D,MAAM,KAAK,GAAG,IAAI,iBAAS,CAAM;QAC/B,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE;QAClC,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,EAAE;KACd,CAAC,CAAC;IAEH,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,QAAQ,GAAG,QAAQ,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YAC5C,CAAC,CAAC,QAAQ,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;YACnD,CAAC,CAAC,SAAS,CAAC;QAEd,KAAK,CAAC,OAAO,CAAC;YACZ,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,CAAO,GAAQ,EAAE,EAAE;gBAC1B,6CAA6C;gBAC7C,MAAM,OAAO,mCAAQ,GAAG,GAAK,IAAI,CAAC,MAAM,CAAE,CAAC;gBAC3C,OAAO,CAAC,GAAG,CAAC,MAAM,QAAQ,eAAe,IAAI,CAAC,IAAI,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAErE,2BAA2B;gBAC3B,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;gBAEpE,iEAAiE;gBACjE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBACxD,OAAO,CAAC,GAAG,CAAC,MAAM,QAAQ,oBAAoB,EAAE,GAAG,CAAC,CAAC;YACvD,CAAC,CAAA;YACD,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAE9E,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC9B,CAAC"}

package/dist/execution/controller.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../execution/controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;;GAGG;AACH,qBAAa,eAAe;IAC1B;;;;;;;OAOG;WACU,iBAAiB,CAAC,CAAC,SAAS,SAAS,EAChD,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,EACtB,UAAU,EAAE,MAAM,EAAE,EACpB,QAAQ,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,GACxB,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;mBAehB,YAAY;IAiBjC;;;;;;;;OAQG;WACU,eAAe,CAAC,CAAC,SAAS,SAAS,EAC9C,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,EACtB,UAAU,EAAE,MAAM,EAAE,EACpB,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,GACxB,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;CAgBtC"}

package/dist/execution/controller.js

@@ -0,0 +1,80 @@
+"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.GraphController = void 0;
+/**
+ * Controller class for managing the execution of graph flows
+ * Handles both sequential and parallel execution of multiple graphs
+ */
+class GraphController {
+    /**
+     * Executes multiple graphs sequentially
+     * @param graphs - Array of GraphFlow instances to execute
+     * @param startNodes - Array of starting node identifiers for each graph
+     * @param contexts - Optional array of contexts for each graph
+     * @returns Map containing results of each graph execution, keyed by graph name and index
+     * @template T - Zod schema type for graph context validation
+     */
+    static executeSequential(graphs, startNodes, contexts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const results = [];
+            for (let i = 0; i < graphs.length; i++) {
+                const context = yield graphs[i].execute(startNodes[i], contexts === null || contexts === void 0 ? void 0 : contexts[i]);
+                results.push({
+                    graphName: graphs[i].name,
+                    nodeName: startNodes[i],
+                    context,
+                });
+            }
+            return results;
+        });
+    }
+    static executeGraph(graph, startNode, context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const result = yield graph.execute(startNode, context);
+                return {
+                    graphName: graph.name,
+                    nodeName: startNode,
+                    context: result,
+                };
+            }
+            catch (error) {
+                throw error;
+            }
+        });
+    }
+    /**
+     * Executes multiple graphs in parallel with optional concurrency control
+     * @param graphs - Array of GraphFlow instances to execute
+     * @param startNodes - Array of starting node identifiers for each graph
+     * @param concurrency - Optional limit on number of concurrent graph executions
+     * @param contexts - Optional array of contexts for each graph
+     * @returns Map containing results of each graph execution, keyed by graph name
+     * @template T - Zod schema type for graph context validation
+     */
+    static executeParallel(graphs, startNodes, concurrency, contexts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const results = [];
+            for (let i = 0; i < graphs.length; i += concurrency) {
+                const batch = graphs.slice(i, i + concurrency);
+                const batchResults = yield Promise.all(batch.map((graph, idx) => {
+                    const context = contexts === null || contexts === void 0 ? void 0 : contexts[i + idx];
+                    return this.executeGraph(graph, startNodes[i + idx], context);
+                }));
+                results.push(...batchResults);
+            }
+            return results;
+        });
+    }
+}
+exports.GraphController = GraphController;
+//# sourceMappingURL=controller.js.map

package/dist/execution/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../execution/controller.ts"],"names":[],"mappings":";;;;;;;;;;;;AAIA;;;GAGG;AACH,MAAa,eAAe;IAC1B;;;;;;;OAOG;IACH,MAAM,CAAO,iBAAiB,CAC5B,MAAsB,EACtB,UAAoB,EACpB,QAAyB;;YAEzB,MAAM,OAAO,GAA8B,EAAE,CAAC;YAE9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACvC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAG,CAAC,CAAC,CAAC,CAAC;gBACtE,OAAO,CAAC,IAAI,CAAC;oBACX,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI;oBACzB,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;oBACvB,OAAO;iBACR,CAAC,CAAC;YACL,CAAC;YAED,OAAO,OAAO,CAAC;QACjB,CAAC;KAAA;IAEO,MAAM,CAAO,YAAY,CAC/B,KAAmB,EACnB,SAAiB,EACjB,OAAsB;;YAEtB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;gBACvD,OAAO;oBACL,SAAS,EAAE,KAAK,CAAC,IAAI;oBACrB,QAAQ,EAAE,SAAS;oBACnB,OAAO,EAAE,MAAM;iBAChB,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KAAA;IAED;;;;;;;;OAQG;IACH,MAAM,CAAO,eAAe,CAC1B,MAAsB,EACtB,UAAoB,EACpB,WAAmB,EACnB,QAAyB;;YAEzB,MAAM,OAAO,GAA8B,EAAE,CAAC;YAE9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC;gBACpD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC;gBAC/C,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CACpC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;oBACvB,MAAM,OAAO,GAAG,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAG,CAAC,GAAG,GAAG,CAAC,CAAC;oBACpC,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,GAAG,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;gBAChE,CAAC,CAAC,CACH,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;YAChC,CAAC;YAED,OAAO,OAAO,CAAC;QACjB,CAAC;KAAA;CACF;AA3ED,0CA2EC"}

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

@@ -0,0 +1,29 @@
+import { ZodSchema } from "zod";
+import { IEventEmitter } from "../interfaces";
+import { EventConfig, GraphContext, GraphEvent, GraphNodeConfig } from "../types";
+import { GraphNode } from "./node";
+export declare class GraphEventManager<T extends ZodSchema> {
+    private eventEmitter;
+    private nodes;
+    private nodeExecutor?;
+    private context;
+    private name;
+    private graphEvents?;
+    private entryNode?;
+    private globalErrorHandler?;
+    private lastEvents;
+    constructor(eventEmitter: IEventEmitter, nodes: Map<string, GraphNodeConfig<T, any>>, name: string, context: GraphContext<T>, graphEvents?: string[], entryNode?: string, globalErrorHandler?: (error: Error, context: GraphContext<T>) => void, nodeExecutor?: GraphNode<T> | undefined);
+    /** @deprecated No-op — event streams are no longer managed here */
+    setupEventStreams(): void;
+    emitEvent<P = any>(type: string, payload?: P, _context?: GraphContext<T>): void;
+    setupEventListeners(): void;
+    setupGraphEventListeners(): void;
+    waitForEvents(events: string[], timeout?: number): Promise<any[]>;
+    on(eventName: string, handler: (...args: any[]) => void): void;
+    emit(eventName: string, data?: any): void;
+    private createNewContext;
+    private executeNode;
+    waitForCorrelatedEvents(eventTypes: string[], timeoutMs: number, correlationFn: (events: GraphEvent<T>[]) => boolean): Promise<GraphEvent<T>[]>;
+    handleNodeEvents(nodeName: string, config: EventConfig): Promise<any[]>;
+}
+//# sourceMappingURL=event-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-manager.d.ts","sourceRoot":"","sources":["../../execution/event-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EACL,WAAW,EACX,YAAY,EACZ,UAAU,EACV,eAAe,EAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAEnC,qBAAa,iBAAiB,CAAC,CAAC,SAAS,SAAS;IAS9C,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,YAAY,CAAC;IAfvB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,WAAW,CAAC,CAAW;IAC/B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,kBAAkB,CAAC,CAAmD;IAC9E,OAAO,CAAC,UAAU,CAA0B;gBAGlC,YAAY,EAAE,aAAa,EAC3B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EACnD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EACxB,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,SAAS,CAAC,EAAE,MAAM,EAClB,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,EAC7D,YAAY,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,YAAA;IASrC,mEAAmE;IAC5D,iBAAiB,IAAI,IAAI;IAEzB,SAAS,CAAC,CAAC,GAAG,GAAG,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,CAAC,EACX,QAAQ,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GACzB,IAAI;IAIP,mBAAmB,IAAI,IAAI;IAgC3B,wBAAwB,IAAI,IAAI;IA8B1B,aAAa,CACjB,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,GAAE,MAAc,GACtB,OAAO,CAAC,GAAG,EAAE,CAAC;IA2CjB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,IAAI;IAI9D,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAKzC,OAAO,CAAC,gBAAgB;YAIV,WAAW;IAqBzB,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;IAmDrB,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,GAAG,EAAE,CAAC;CAoFlB"}