@ai.ntellect/core 0.8.1 → 0.8.3

package/dist/modules/agent/generic-executor.js

@@ -17,6 +17,7 @@ const chalk_1 = __importDefault(require("chalk"));
 const zod_1 = require("zod");
 const executor_1 = require("./base/executor");
 const llm_factory_1 = require("./llm-factory");
+const prompt_builder_1 = require("./prompt-builder");
 /**
  * Generic executor that handles the interaction between the agent and LLM
  * Uses a structured prompt format:
@@ -86,6 +87,25 @@ ${graph
         })
             .join("\n\n");
     }
+    buildSystemPrompt(context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return new prompt_builder_1.PromptBuilder()
+                .addSection("ROLE", this.agent.getRole())
+                .addSection("GOAL", this.agent.getGoal())
+                .addSection("BACKSTORY", this.agent.getBackstory())
+                .addSection("RECENT ACTIONS (check this before deciding what to do)", context.knowledge || "None")
+                .addSection("AVAILABLE ACTIONS (only if you need)", this.generateActionSchema())
+                .addSection("INSTRUCTIONS", `
+- Never take actions if an recent action matches the user's input
+- If you need to take actions, structure parameters according to the action's schema
+- If goal is achieved, explain that you achieved for examples:
+  - "I have achieved the goal"
+  - "I have done what I needed to do"
+  - "I have completed the task"
+      `)
+                .build(context);
+        });
+    }
     /**
      * Makes a decision based on the current context using the LLM
      * @param {AgentContext} context - The context to base the decision on
@@ -93,44 +113,13 @@ ${graph
      */
     makeDecision(context) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a;
             this.log("thinking", chalk_1.default.dim("Analyzing context and available actions..."));
-            const memories = yield this.agent.recall(context.input.raw);
-            if (memories.length > 0) {
-                this.log("info", chalk_1.default.dim("Retrieved relevant memories:"));
-                memories.forEach((m) => this.log("info", chalk_1.default.dim(`- ${m.content}`)));
-                context.knowledge =
-                    (context.knowledge || "") +
-                        "\n" +
-                        memories.map((m) => m.content).join("\n");
-            }
-            const systemPrompt = `
-      ## ROLE
-      ${this.agent.getRole()}
-
-      ## GOAL
-      ${this.agent.getGoal()}
-
-      ## BACKSTORY
-      ${this.agent.getBackstory()}
-
-      ## RECENT ACTIONS
-      ${context.knowledge ? `${context.knowledge}\n` : "None"}
-     
-      ## AVAILABLE ACTIONS
-      ${this.generateActionSchema()}
-
-      ## INSTRUCTIONS
-      - Analyze the user input and what you have done (if no action is needed, just return an empty array)
-      - Choose appropriate actions based on their parameters
-      - Structure parameters according to the action's schema
-      - Look at the goal and the actions you have done, if you have achieved the goal, STOP
-    `;
+            const systemPrompt = yield this.buildSystemPrompt(context);
+            console.log({ systemPrompt });
             this.log("info", chalk_1.default.dim("Generating response..."));
             const result = yield this.llm.generate({
                 system: systemPrompt,
-                user: `User input: ${context.input.raw}
-        Actions you have already done: ${((_a = context.executedActions) === null || _a === void 0 ? void 0 : _a.map((a) => `\n- ${a.name} => ${JSON.stringify(a.result)}`).join("")) || "None"}`,
+                user: `User sent you this message at ${new Date().toISOString()}\n${context.input.raw}`,
             }, zod_1.z.object({
                 actions: zod_1.z.array(zod_1.z.object({
                     name: zod_1.z.string(),
@@ -181,7 +170,7 @@ ${graph
                 // Initialize workflow context with input
                 const workflowContext = Object.assign(Object.assign({}, workflow.getContext()), input);
                 // Execute with merged context
-                const result = yield workflow.execute(startNode, undefined, workflowContext);
+                const result = yield workflow.execute(startNode, workflowContext);
                 this.log("success", chalk_1.default.green(`Workflow ${workflow.name} completed`));
                 this.log("info", chalk_1.default.dim(`Result: ${JSON.stringify(result, null, 2)}`));
                 if (context.executedActions) {

package/dist/modules/agent/generic-executor.js.map

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

package/dist/modules/agent/llm-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm-factory.d.ts","sourceRoot":"","sources":["../../../modules/agent/llm-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,qBAAa,UAAU;IACrB;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS;yDA8BysG,EAAG,OAAO;;CADtvG"}
+{"version":3,"file":"llm-factory.d.ts","sourceRoot":"","sources":["../../../modules/agent/llm-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,qBAAa,UAAU;IACrB;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS;;;CA6BnC"}

package/dist/types/index.d.ts

@@ -65,12 +65,44 @@ export type GraphContext<T extends ZodSchema> = {
     [key: string]: any;
 };
 /**
- * Configuration for event handling in a node
+ * Configuration for event handling strategies in nodes
+ * @typedef {Object} EventStrategy
+ * @property {"single" | "all" | "correlate"} type - The type of event handling strategy
+ * - single: Waits for any single event from the specified events
+ * - all: Waits for all specified events to occur
+ * - correlate: Uses a correlation function to match related events
+ * @property {(events: any[]) => boolean} [correlation] - Optional correlation function for "correlate" strategy
  */
 export type EventStrategy = {
     type: "single" | "all" | "correlate";
     correlation?: (events: any[]) => boolean;
 };
+/**
+ * Configuration for event handling in nodes
+ * @typedef {Object} EventConfig
+ * @property {string[]} events - Array of event names to wait for
+ * @property {number} [timeout] - Optional timeout in milliseconds
+ * @property {EventStrategy} strategy - Strategy for handling multiple events
+ * @property {(events: any[]) => Promise<void>} [onSuccess] - Optional callback when events are successfully received
+ * @property {() => Promise<void>} [onTimeout] - Optional callback when event waiting times out
+ * @example
+ * ```typescript
+ * const eventConfig: EventConfig = {
+ *   events: ["payment.received", "order.validated"],
+ *   timeout: 5000,
+ *   strategy: {
+ *     type: "correlate",
+ *     correlation: (events) => events.every(e => e.transactionId === events[0].transactionId)
+ *   },
+ *   onSuccess: async (events) => {
+ *     console.log("Correlated events received:", events);
+ *   },
+ *   onTimeout: async () => {
+ *     console.log("Event waiting timed out");
+ *   }
+ * };
+ * ```
+ */
 export type EventConfig = {
     events: string[];
     timeout?: number;
@@ -78,12 +110,60 @@ export type EventConfig = {
     onSuccess?: (events: any[]) => Promise<void>;
     onTimeout?: () => Promise<void>;
 };
+/**
+ * Represents an event in the graph system
+ * @template T - Schema type for context validation
+ * @property {string} type - The type/name of the event
+ * @property {any} [payload] - Optional payload data
+ * @property {number} timestamp - Unix timestamp of when the event occurred
+ * @example
+ * ```typescript
+ * const event: GraphEvent<MySchema> = {
+ *   type: "payment.received",
+ *   payload: {
+ *     transactionId: "tx123",
+ *     amount: 100,
+ *     currency: "USD"
+ *   },
+ *   timestamp: Date.now()
+ * };
+ * ```
+ */
+export type GraphEvent<T extends ZodSchema> = {
+    type: string;
+    payload?: any;
+    timestamp: number;
+};
+/**
+ * Configuration for waiting on multiple events
+ * @template T - Schema type for context validation
+ * @property {string[]} events - Array of event names to wait for
+ * @property {number} [timeout] - Optional timeout in milliseconds
+ * @property {"all" | "any" | "race"} strategy - Strategy for handling multiple events
+ * @property {(context: GraphContext<T>) => Promise<void>} [onSuccess] - Optional success callback
+ * @example
+ * ```typescript
+ * const config: WaitForEvents<MySchema> = {
+ *   events: ["event1", "event2"],
+ *   timeout: 5000,
+ *   strategy: "all",
+ *   onSuccess: async (context) => {
+ *     console.log("All events received");
+ *   }
+ * };
+ * ```
+ */
+export type WaitForEvents<T extends ZodSchema> = {
+    events: string[];
+    timeout?: number;
+    strategy: "all" | "any" | "race";
+    onSuccess?: <T extends ZodSchema>(context: GraphContext<T>) => Promise<void>;
+};
 /**
  * Interface representing a node in the graph
  * @interface
  * @template T - Schema type
- * @template I - Input schema type
- * @template O - Output schema type
+ * @template P - Parameters type
  */
 export interface GraphNodeConfig<T extends ZodSchema, P = any> {
     /** Name of the node */
@@ -93,12 +173,12 @@ export interface GraphNodeConfig<T extends ZodSchema, P = any> {
     /** Schema for node inputs */
     params?: P extends void ? never : ZodSchema<P>;
     /** Execute function for the node */
-    execute: (context: GraphContext<T>, params?: P, tools?: {
+    execute: (context: GraphContext<T>, tools?: {
         eventEmitter: IEventEmitter;
     }) => Promise<void>;
-    /** Optional condition for node start execution */
+    /** Optional condition for node execution */
     condition?: (context: GraphContext<T>, params?: P) => boolean;
-    /** Array of next node names or objects with conditions for the next node */
+    /** Array of next node names or objects with conditions */
     next?: Array<string | {
         node: string;
         condition: (context: GraphContext<T>) => boolean;
@@ -109,13 +189,9 @@ export interface GraphNodeConfig<T extends ZodSchema, P = any> {
     when?: EventConfig;
     /** Retry configuration */
     retry?: {
-        /** Maximum number of retry attempts */
         maxAttempts: number;
-        /** Delay between retries in milliseconds */
         delay: number;
-        /** Error handler function */
         onRetryFailed?: (error: Error, context: GraphContext<T>) => Promise<void>;
-        /** Continue execution on failed retry */
         continueOnFailed?: boolean;
     };
     /** Error handler function */
@@ -130,12 +206,12 @@ export interface GraphNodeConfig<T extends ZodSchema, P = any> {
 export type GraphConfig<T extends ZodSchema> = {
     /** Name of the graph */
     name: string;
-    /** Array of nodes in the graph */
-    nodes: GraphNodeConfig<T, any>[];
-    /** Initial context */
-    context: SchemaType<T>;
     /** Schema for validation */
     schema: T;
+    /** Initial context */
+    context: SchemaType<T>;
+    /** Array of nodes in the graph */
+    nodes: GraphNodeConfig<T, any>[];
     /** Global error handler */
     onError?: (error: Error, context: GraphContext<T>) => void;
     /** Entry node name */
@@ -178,17 +254,6 @@ export type MeilisearchSettings = {
     /** Array of sortable attributes */
     sortableAttributes?: string[];
 };
-export type GraphEvent<T extends ZodSchema> = {
-    type: string;
-    payload?: any;
-    timestamp: number;
-};
-export type WaitForEvents<T extends ZodSchema> = {
-    events: string[];
-    timeout?: number;
-    strategy: "all" | "any" | "race";
-    onSuccess?: <T extends ZodSchema>(context: GraphContext<T>) => Promise<void>;
-};
 /**
  * Configuration interface for NLP Engine
  * @interface NLPConfig

package/dist/types/index.d.ts.map

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

package/graph/controller.ts

@@ -1,7 +1,6 @@
 import { ZodSchema } from "zod";
 import { GraphExecutionResult } from "../types";
 import { GraphFlow } from "./index";
-import { NodeParams } from "./node";
 
 /**
  * Controller class for managing the execution of graph flows
@@ -12,19 +11,19 @@ export 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 params - Optional array of node parameters 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 async executeSequential<T extends ZodSchema>(
     graphs: GraphFlow<T>[],
     startNodes: string[],
-    params?: NodeParams[]
+    contexts?: Partial<any>[]
   ): Promise<GraphExecutionResult<T>[]> {
     const results: GraphExecutionResult<T>[] = [];
 
     for (let i = 0; i < graphs.length; i++) {
-      const context = await graphs[i].execute(startNodes[i], params?.[i]);
+      const context = await graphs[i].execute(startNodes[i], contexts?.[i]);
       results.push({
         graphName: graphs[i].name,
         nodeName: startNodes[i],
@@ -38,14 +37,14 @@ export class GraphController {
   private static async executeGraph<T extends ZodSchema>(
     graph: GraphFlow<T>,
     startNode: string,
-    params?: NodeParams
+    context?: Partial<any>
   ): Promise<GraphExecutionResult<T>> {
     try {
-      const context = await graph.execute(startNode, params);
+      const result = await graph.execute(startNode, context);
       return {
         graphName: graph.name,
         nodeName: startNode,
-        context,
+        context: result,
       };
     } catch (error) {
       throw error;
@@ -57,7 +56,7 @@ export class GraphController {
    * @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 params - Optional array of node parameters for each graph
+   * @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
    */
@@ -65,7 +64,7 @@ export class GraphController {
     graphs: GraphFlow<T>[],
     startNodes: string[],
     concurrency: number,
-    params?: NodeParams[]
+    contexts?: Partial<any>[]
   ): Promise<GraphExecutionResult<T>[]> {
     const results: GraphExecutionResult<T>[] = [];
 
@@ -73,8 +72,8 @@ export class GraphController {
       const batch = graphs.slice(i, i + concurrency);
       const batchResults = await Promise.all(
         batch.map((graph, idx) => {
-          const param = params?.[i + idx];
-          return this.executeGraph(graph, startNodes[i + idx], param);
+          const context = contexts?.[i + idx];
+          return this.executeGraph(graph, startNodes[i + idx], context);
         })
       );
       results.push(...batchResults);

package/graph/event-manager.ts

@@ -131,7 +131,6 @@ export class GraphEventManager<T extends ZodSchema> {
               await this.executeNode(
                 node.name,
                 freshContext,
-                undefined,
                 /* triggeredByEvent= */ true
               );
             }
@@ -161,12 +160,7 @@ export class GraphEventManager<T extends ZodSchema> {
               throw new Error("No entry node defined for graph event handling");
             }
 
-            await this.executeNode(
-              this.entryNode,
-              freshContext,
-              undefined,
-              false
-            );
+            await this.executeNode(this.entryNode, freshContext, false);
 
             // Emit "graphCompleted"
             this.eventEmitter.emit("graphCompleted", {
@@ -278,7 +272,6 @@ export class GraphEventManager<T extends ZodSchema> {
   private async executeNode(
     nodeName: string,
     context: GraphContext<T>,
-    inputs: any,
     triggeredByEvent: boolean
   ): Promise<void> {
     if (!this.nodeExecutor) {
@@ -295,12 +288,7 @@ export class GraphEventManager<T extends ZodSchema> {
       await this.handleNodeEvents(nodeName, node.when);
     }
 
-    return this.nodeExecutor.executeNode(
-      nodeName,
-      context,
-      inputs,
-      triggeredByEvent
-    );
+    return this.nodeExecutor.executeNode(nodeName, context, triggeredByEvent);
   }
 
   /**

package/graph/index.ts

@@ -1,7 +1,7 @@
 import { EventEmitter } from "events";
 import { BehaviorSubject, Subject } from "rxjs";
 import { ZodSchema } from "zod";
-import { GraphObservable, IEventEmitter, NLPNodeConfig } from "../interfaces";
+import { GraphObservable, IEventEmitter } from "../interfaces";
 import { NLPNode } from "../modules/nlp";
 import {
   GraphConfig,
@@ -11,7 +11,7 @@ import {
 } from "../types";
 import { GraphEventManager } from "./event-manager";
 import { GraphLogger } from "./logger";
-import { GraphNode, NodeParams } from "./node";
+import { GraphNode } from "./node";
 import { GraphObserver } from "./observer";
 import { GraphVisualizer } from "./visualizer";
 
@@ -37,6 +37,7 @@ export class GraphFlow<T extends ZodSchema> {
   private entryNode?: string;
   private verbose: boolean = false;
   public nodes: Map<string, GraphNodeConfig<T, any>>;
+  public name: string;
 
   private eventSubject: Subject<GraphEvent<T>> = new Subject();
   private stateSubject: BehaviorSubject<GraphContext<T>>;
@@ -51,15 +52,11 @@ export class GraphFlow<T extends ZodSchema> {
 
   /**
    * Creates a new instance of GraphFlow
-   * @param {string} name - The name of the graph flow
-   * @param {GraphConfig<T>} config - Configuration object containing nodes, schema, context, and error handlers
+   * @param {GraphConfig<T>} config - Configuration object containing name, nodes, schema, context, and error handlers
    * @param {Object} options - Optional options for the graph flow
    */
-  constructor(
-    public name: string,
-    config: GraphConfig<T>,
-    options: { verbose?: boolean } = {}
-  ) {
+  constructor(config: GraphConfig<T>, options: { verbose?: boolean } = {}) {
+    this.name = config.name;
     this.nodes = new Map(
       config.nodes.map((node: GraphNodeConfig<T, any>) => [node.name, node])
     );
@@ -69,22 +66,23 @@ export class GraphFlow<T extends ZodSchema> {
     this.eventEmitter =
       config.eventEmitter || (new EventEmitter() as IEventEmitter);
     this.graphEvents = config.events;
+    this.entryNode = config.entryNode;
     this.verbose = options.verbose ?? false;
 
     this.stateSubject = new BehaviorSubject<GraphContext<T>>(this.context);
 
-    this.logger = new GraphLogger(name, options.verbose);
+    this.logger = new GraphLogger(this.name, options.verbose);
     this.eventManager = new GraphEventManager(
       this.eventEmitter,
       this.nodes,
-      name,
+      this.name,
       this.context,
       config.events,
       config.entryNode,
       config.onError
     );
     this.nodeExecutor = new GraphNode(
-      this.nodes as Map<string, GraphNodeConfig<T, any>>,
+      this.nodes,
       this.logger,
       this.eventManager,
       this.eventSubject,
@@ -159,25 +157,18 @@ export class GraphFlow<T extends ZodSchema> {
    * @private
    * @param {string} nodeName - Name of the node to execute
    * @param {GraphContext<T>} context - Current execution context
-   * @param {any} inputs - Input parameters for the node
    * @param {boolean} triggeredByEvent - Whether the execution was triggered by an event
    * @returns {Promise<void>}
    */
   private async executeNode(
     nodeName: string,
     context: GraphContext<T>,
-    inputs: any,
     triggeredByEvent: boolean = false
   ): Promise<void> {
     const node = this.nodes.get(nodeName);
     if (!node) throw new Error(`Node "${nodeName}" not found`);
 
-    return this.nodeExecutor.executeNode(
-      nodeName,
-      context,
-      inputs,
-      triggeredByEvent
-    );
+    return this.nodeExecutor.executeNode(nodeName, context, triggeredByEvent);
   }
 
   private addLog(message: string): void {
@@ -227,36 +218,33 @@ export class GraphFlow<T extends ZodSchema> {
   /**
    * Executes the graph flow starting from a specific node
    * @param {string} startNode - Name of the node to start execution from
-   * @param {any} inputs - Optional input parameters for the start node
    * @param {Partial<GraphContext<T>>} context - Optional context to merge
-   * @param {NodeParams} params - Optional node parameters
    * @returns {Promise<GraphContext<T>>} Final context after execution
    */
   public async execute(
     startNode: string,
-    params?: NodeParams,
     context?: Partial<GraphContext<T>>
   ): Promise<GraphContext<T>> {
-    if (context) {
-      Object.assign(this.context, context);
-    }
+    try {
+      // Validate and merge context if provided
+      if (context) {
+        const mergedContext = { ...this.context, ...context };
+        const validationResult = this.validator?.safeParse(mergedContext);
+        if (!validationResult?.success) {
+          const errors = validationResult?.error?.errors.map(
+            (err) => `${err.path.join(".")}: ${err.message}`
+          );
+          throw new Error(`Context validation failed: ${errors?.join(", ")}`);
+        }
+        this.context = validationResult.data;
+      }
 
-    this.eventEmitter.emit("graphStarted", { name: this.name });
+      this.eventEmitter.emit("graphStarted", { name: this.name });
 
-    try {
       const node = this.nodes.get(startNode);
       if (!node) throw new Error(`Node "${startNode}" not found`);
 
-      if (node.params && !params) {
-        throw new Error(`Params required for node "${startNode}"`);
-      }
-
-      await this.nodeExecutor.executeNode(
-        startNode,
-        this.context,
-        params,
-        false
-      );
+      await this.nodeExecutor.executeNode(startNode, this.context, false);
 
       this.eventEmitter.emit("graphCompleted", {
         name: this.name,
@@ -307,8 +295,8 @@ export class GraphFlow<T extends ZodSchema> {
   public load(definition: GraphConfig<T>): void {
     // Clear all existing nodes
     this.nodes.clear();
+
     // Wipe out old node-based event listeners
-    // (We keep external test listeners like "nodeStarted" or "nodeCompleted".)
     if (definition.nodes?.length) {
       const allEvents = new Set<string>();
       definition.nodes.forEach((n) =>
@@ -323,14 +311,18 @@ export class GraphFlow<T extends ZodSchema> {
     definition.nodes.forEach((node) => this.nodes.set(node.name, node));
 
     // Parse the new context
-    this.context = definition.schema.parse(
-      definition.context
-    ) as GraphContext<T>;
+    const validationResult = definition.schema.safeParse(definition.context);
+    if (!validationResult.success) {
+      const errors = validationResult.error.errors.map(
+        (err) => `${err.path.join(".")}: ${err.message}`
+      );
+      throw new Error(`Context validation failed: ${errors.join(", ")}`);
+    }
+    this.context = validationResult.data;
     this.validator = definition.schema;
 
-    // Store entry node
+    // Store entry node and graph events
     this.entryNode = definition.entryNode;
-    // Store graph events
     this.graphEvents = definition.events;
 
     // Re-setup only node-based event triggers
@@ -342,7 +334,7 @@ export class GraphFlow<T extends ZodSchema> {
             async (data?: Partial<GraphContext<T>>) => {
               const freshContext = structuredClone(this.context);
               if (data) Object.assign(freshContext, data);
-              await this.executeNode(node.name, freshContext, undefined, true);
+              await this.executeNode(node.name, freshContext, true);
             }
           );
         });
@@ -423,28 +415,6 @@ export class GraphFlow<T extends ZodSchema> {
     return this.validator as T;
   }
 
-  /**
-   * Adds a new NLP node to the graph
-   * @param {NLPNodeConfig<T>} config - Configuration for the NLP node
-   * @returns {Promise<void>}
-   */
-  public async addNLPNode(config: NLPNodeConfig<T>) {
-    const node = new NLPNode(config);
-    await node.initialize();
-    this.nlpNodes.set(config.name, node);
-
-    this.addNode({
-      name: config.name,
-      execute: async (context, input) => {
-        if (!input?.input) return;
-        const result = await node.process(input.input);
-        console.log("GraphFlow NLP result:", result);
-        Object.assign(context, { nlpResult: result });
-      },
-      next: config.next,
-    });
-  }
-
   /**
    * Processes natural language input using a specific NLP node
    * @param {string} text - The input text to process