@agentforge/patterns 0.6.0 → 0.6.2

package/dist/index.cjs

@@ -327,6 +327,9 @@ function createActionNode(tools, verbose = false) {
           console.log(`[action] Tool '${action.name}' executed successfully`);
         }
       } catch (error) {
+        if (error && typeof error === "object" && "constructor" in error && error.constructor.name === "GraphInterrupt") {
+          throw error;
+        }
         const errorMessage = error instanceof Error ? error.message : String(error);
         observations.push({
           toolCallId: action.id,
@@ -870,6 +873,9 @@ function createExecutorNode(config) {
           result = { message: "Step completed without tool execution" };
         }
       } catch (execError) {
+        if (execError && typeof execError === "object" && "constructor" in execError && execError.constructor.name === "GraphInterrupt") {
+          throw execError;
+        }
         success = false;
         error = execError instanceof Error ? execError.message : "Unknown execution error";
         result = null;
@@ -2097,43 +2103,48 @@ function getRoutingStrategy(name) {
 }
 
 // src/multi-agent/utils.ts
+var import_core7 = require("@agentforge/core");
+var logLevel = process.env.LOG_LEVEL?.toLowerCase() || import_core7.LogLevel.INFO;
+var logger = (0, import_core7.createLogger)("multi-agent", { level: logLevel });
 function isReActAgent(obj) {
   return obj && typeof obj === "object" && typeof obj.invoke === "function" && typeof obj.stream === "function" && // Additional check to ensure it's not just any object with invoke/stream
   (obj.constructor?.name === "CompiledGraph" || obj.constructor?.name === "CompiledStateGraph");
 }
 function wrapReActAgent(workerId, agent, verbose = false) {
-  return async (state) => {
+  return async (state, config) => {
     try {
-      if (verbose) {
-        console.log(`[ReActWrapper:${workerId}] Wrapping ReAct agent execution`);
-      }
+      logger.debug("Wrapping ReAct agent execution", { workerId });
       const task = state.messages[state.messages.length - 1]?.content || state.input;
-      if (verbose) {
-        console.log(`[ReActWrapper:${workerId}] Task:`, task.substring(0, 100) + "...");
-      }
+      logger.debug("Extracted task", {
+        workerId,
+        taskPreview: task.substring(0, 100) + (task.length > 100 ? "..." : "")
+      });
       const currentAssignment = state.activeAssignments.find(
         (assignment) => assignment.workerId === workerId && !state.completedTasks.some((task2) => task2.assignmentId === assignment.id)
       );
       if (!currentAssignment) {
-        if (verbose) {
-          console.log(`[ReActWrapper:${workerId}] No active assignment found`);
-        }
+        logger.debug("No active assignment found", { workerId });
         return {
           currentAgent: "supervisor",
           status: "routing"
         };
       }
-      const result = await agent.invoke({
-        messages: [{ role: "user", content: task }]
-      });
+      const result = await agent.invoke(
+        {
+          messages: [{ role: "user", content: task }]
+        },
+        config
+        // Pass through the config for checkpointing and interrupt support
+      );
       const response = result.messages?.[result.messages.length - 1]?.content || "No response";
-      if (verbose) {
-        console.log(`[ReActWrapper:${workerId}] Response:`, response.substring(0, 100) + "...");
-      }
+      logger.debug("Received response from ReAct agent", {
+        workerId,
+        responsePreview: response.substring(0, 100) + (response.length > 100 ? "..." : "")
+      });
       const toolsUsed = result.actions?.map((action) => action.name).filter(Boolean) || [];
       const uniqueTools = [...new Set(toolsUsed)];
-      if (verbose && uniqueTools.length > 0) {
-        console.log(`[ReActWrapper:${workerId}] Tools used:`, uniqueTools.join(", "));
+      if (uniqueTools.length > 0) {
+        logger.debug("Tools used by ReAct agent", { workerId, tools: uniqueTools });
       }
       const taskResult = {
         assignmentId: currentAssignment.id,
@@ -2153,7 +2164,15 @@ function wrapReActAgent(workerId, agent, verbose = false) {
         status: "routing"
       };
     } catch (error) {
-      console.error(`[ReActWrapper:${workerId}] Error:`, error);
+      if (error && typeof error === "object" && "constructor" in error && error.constructor.name === "GraphInterrupt") {
+        logger.debug("GraphInterrupt detected - re-throwing", { workerId });
+        throw error;
+      }
+      logger.error("Error in ReAct agent execution", {
+        workerId,
+        error: error instanceof Error ? error.message : String(error),
+        stack: error instanceof Error ? error.stack : void 0
+      });
       const currentAssignment = state.activeAssignments.find(
         (assignment) => assignment.workerId === workerId
       );
@@ -2182,7 +2201,7 @@ function wrapReActAgent(workerId, agent, verbose = false) {
 
 // src/multi-agent/nodes.ts
 var import_messages5 = require("@langchain/core/messages");
-var import_core7 = require("@agentforge/core");
+var import_core8 = require("@agentforge/core");
 var DEFAULT_AGGREGATOR_SYSTEM_PROMPT = `You are an aggregator agent responsible for combining results from multiple worker agents.
 
 Your job is to:
@@ -2276,7 +2295,7 @@ function createWorkerNode(config) {
     executeFn,
     agent
   } = config;
-  return async (state) => {
+  return async (state, runConfig) => {
     try {
       if (verbose) {
         console.log(`[Worker:${id}] Executing task`);
@@ -2297,7 +2316,7 @@ function createWorkerNode(config) {
         if (verbose) {
           console.log(`[Worker:${id}] Using custom executeFn`);
         }
-        return await executeFn(state);
+        return await executeFn(state, runConfig);
       }
       if (agent) {
         if (isReActAgent(agent)) {
@@ -2305,7 +2324,7 @@ function createWorkerNode(config) {
             console.log(`[Worker:${id}] Using ReAct agent (auto-wrapped)`);
           }
           const wrappedFn = wrapReActAgent(id, agent, verbose);
-          return await wrappedFn(state);
+          return await wrappedFn(state, runConfig);
         } else {
           console.warn(`[Worker:${id}] Agent provided but does not appear to be a ReAct agent. Falling back to default execution.`);
         }
@@ -2326,7 +2345,7 @@ Execute the assigned task using your skills and tools. Provide a clear, actionab
       ];
       let modelToUse = model;
       if (tools.length > 0 && model.bindTools) {
-        const langchainTools = (0, import_core7.toLangChainTools)(tools);
+        const langchainTools = (0, import_core8.toLangChainTools)(tools);
         modelToUse = model.bindTools(langchainTools);
       }
       const response = await modelToUse.invoke(messages);
@@ -2371,6 +2390,9 @@ Execute the assigned task using your skills and tools. Provide a clear, actionab
         status: "routing"
       };
     } catch (error) {
+      if (error && typeof error === "object" && "constructor" in error && error.constructor.name === "GraphInterrupt") {
+        throw error;
+      }
       console.error(`[Worker:${id}] Error:`, error);
       const currentAssignment = state.activeAssignments.find(
         (assignment) => assignment.workerId === id
@@ -2466,7 +2488,7 @@ Please synthesize these results into a comprehensive response that addresses the
 
 // src/multi-agent/agent.ts
 var import_langgraph4 = require("@langchain/langgraph");
-var import_core8 = require("@agentforge/core");
+var import_core9 = require("@agentforge/core");
 function createMultiAgentSystem(config) {
   const {
     supervisor,
@@ -2479,7 +2501,7 @@ function createMultiAgentSystem(config) {
   const workflow = new import_langgraph4.StateGraph(MultiAgentState);
   let supervisorConfig = { ...supervisor, maxIterations, verbose };
   if (supervisor.model && supervisor.tools && supervisor.tools.length > 0) {
-    const langchainTools = (0, import_core8.toLangChainTools)(supervisor.tools);
+    const langchainTools = (0, import_core9.toLangChainTools)(supervisor.tools);
     const modelWithTools = supervisor.model.bindTools(langchainTools);
     supervisorConfig.model = modelWithTools;
   }

package/dist/index.d.cts

@@ -2476,8 +2476,11 @@ interface WorkerConfig {
      *
      * If provided, this function will be used to execute tasks for this worker.
      * Takes precedence over the `agent` property.
+     *
+     * The config parameter contains LangGraph runtime configuration including
+     * thread_id for checkpointing, which is required for interrupt functionality.
      */
-    executeFn?: (state: MultiAgentStateType) => Promise<Partial<MultiAgentStateType>>;
+    executeFn?: (state: MultiAgentStateType, config?: any) => Promise<Partial<MultiAgentStateType>>;
     /**
      * ReAct agent instance
      *
@@ -2655,7 +2658,7 @@ declare function createSupervisorNode(config: SupervisorConfig): (state: MultiAg
 /**
  * Create a worker agent node
  */
-declare function createWorkerNode(config: WorkerConfig): (state: MultiAgentStateType) => Promise<Partial<MultiAgentStateType>>;
+declare function createWorkerNode(config: WorkerConfig): (state: MultiAgentStateType, runConfig?: any) => Promise<Partial<MultiAgentStateType>>;
 /**
  * Create an aggregator node that combines worker results
  */

package/dist/index.d.ts

@@ -2476,8 +2476,11 @@ interface WorkerConfig {
      *
      * If provided, this function will be used to execute tasks for this worker.
      * Takes precedence over the `agent` property.
+     *
+     * The config parameter contains LangGraph runtime configuration including
+     * thread_id for checkpointing, which is required for interrupt functionality.
      */
-    executeFn?: (state: MultiAgentStateType) => Promise<Partial<MultiAgentStateType>>;
+    executeFn?: (state: MultiAgentStateType, config?: any) => Promise<Partial<MultiAgentStateType>>;
     /**
      * ReAct agent instance
      *
@@ -2655,7 +2658,7 @@ declare function createSupervisorNode(config: SupervisorConfig): (state: MultiAg
 /**
  * Create a worker agent node
  */
-declare function createWorkerNode(config: WorkerConfig): (state: MultiAgentStateType) => Promise<Partial<MultiAgentStateType>>;
+declare function createWorkerNode(config: WorkerConfig): (state: MultiAgentStateType, runConfig?: any) => Promise<Partial<MultiAgentStateType>>;
 /**
  * Create an aggregator node that combines worker results
  */

package/dist/index.js

@@ -228,6 +228,9 @@ function createActionNode(tools, verbose = false) {
           console.log(`[action] Tool '${action.name}' executed successfully`);
         }
       } catch (error) {
+        if (error && typeof error === "object" && "constructor" in error && error.constructor.name === "GraphInterrupt") {
+          throw error;
+        }
         const errorMessage = error instanceof Error ? error.message : String(error);
         observations.push({
           toolCallId: action.id,
@@ -771,6 +774,9 @@ function createExecutorNode(config) {
           result = { message: "Step completed without tool execution" };
         }
       } catch (execError) {
+        if (execError && typeof execError === "object" && "constructor" in execError && execError.constructor.name === "GraphInterrupt") {
+          throw execError;
+        }
         success = false;
         error = execError instanceof Error ? execError.message : "Unknown execution error";
         result = null;
@@ -1998,43 +2004,48 @@ function getRoutingStrategy(name) {
 }
 
 // src/multi-agent/utils.ts
+import { createLogger, LogLevel } from "@agentforge/core";
+var logLevel = process.env.LOG_LEVEL?.toLowerCase() || LogLevel.INFO;
+var logger = createLogger("multi-agent", { level: logLevel });
 function isReActAgent(obj) {
   return obj && typeof obj === "object" && typeof obj.invoke === "function" && typeof obj.stream === "function" && // Additional check to ensure it's not just any object with invoke/stream
   (obj.constructor?.name === "CompiledGraph" || obj.constructor?.name === "CompiledStateGraph");
 }
 function wrapReActAgent(workerId, agent, verbose = false) {
-  return async (state) => {
+  return async (state, config) => {
     try {
-      if (verbose) {
-        console.log(`[ReActWrapper:${workerId}] Wrapping ReAct agent execution`);
-      }
+      logger.debug("Wrapping ReAct agent execution", { workerId });
       const task = state.messages[state.messages.length - 1]?.content || state.input;
-      if (verbose) {
-        console.log(`[ReActWrapper:${workerId}] Task:`, task.substring(0, 100) + "...");
-      }
+      logger.debug("Extracted task", {
+        workerId,
+        taskPreview: task.substring(0, 100) + (task.length > 100 ? "..." : "")
+      });
       const currentAssignment = state.activeAssignments.find(
         (assignment) => assignment.workerId === workerId && !state.completedTasks.some((task2) => task2.assignmentId === assignment.id)
       );
       if (!currentAssignment) {
-        if (verbose) {
-          console.log(`[ReActWrapper:${workerId}] No active assignment found`);
-        }
+        logger.debug("No active assignment found", { workerId });
         return {
           currentAgent: "supervisor",
           status: "routing"
         };
       }
-      const result = await agent.invoke({
-        messages: [{ role: "user", content: task }]
-      });
+      const result = await agent.invoke(
+        {
+          messages: [{ role: "user", content: task }]
+        },
+        config
+        // Pass through the config for checkpointing and interrupt support
+      );
       const response = result.messages?.[result.messages.length - 1]?.content || "No response";
-      if (verbose) {
-        console.log(`[ReActWrapper:${workerId}] Response:`, response.substring(0, 100) + "...");
-      }
+      logger.debug("Received response from ReAct agent", {
+        workerId,
+        responsePreview: response.substring(0, 100) + (response.length > 100 ? "..." : "")
+      });
       const toolsUsed = result.actions?.map((action) => action.name).filter(Boolean) || [];
       const uniqueTools = [...new Set(toolsUsed)];
-      if (verbose && uniqueTools.length > 0) {
-        console.log(`[ReActWrapper:${workerId}] Tools used:`, uniqueTools.join(", "));
+      if (uniqueTools.length > 0) {
+        logger.debug("Tools used by ReAct agent", { workerId, tools: uniqueTools });
       }
       const taskResult = {
         assignmentId: currentAssignment.id,
@@ -2054,7 +2065,15 @@ function wrapReActAgent(workerId, agent, verbose = false) {
         status: "routing"
       };
     } catch (error) {
-      console.error(`[ReActWrapper:${workerId}] Error:`, error);
+      if (error && typeof error === "object" && "constructor" in error && error.constructor.name === "GraphInterrupt") {
+        logger.debug("GraphInterrupt detected - re-throwing", { workerId });
+        throw error;
+      }
+      logger.error("Error in ReAct agent execution", {
+        workerId,
+        error: error instanceof Error ? error.message : String(error),
+        stack: error instanceof Error ? error.stack : void 0
+      });
       const currentAssignment = state.activeAssignments.find(
         (assignment) => assignment.workerId === workerId
       );
@@ -2177,7 +2196,7 @@ function createWorkerNode(config) {
     executeFn,
     agent
   } = config;
-  return async (state) => {
+  return async (state, runConfig) => {
     try {
       if (verbose) {
         console.log(`[Worker:${id}] Executing task`);
@@ -2198,7 +2217,7 @@ function createWorkerNode(config) {
         if (verbose) {
           console.log(`[Worker:${id}] Using custom executeFn`);
         }
-        return await executeFn(state);
+        return await executeFn(state, runConfig);
       }
       if (agent) {
         if (isReActAgent(agent)) {
@@ -2206,7 +2225,7 @@ function createWorkerNode(config) {
             console.log(`[Worker:${id}] Using ReAct agent (auto-wrapped)`);
           }
           const wrappedFn = wrapReActAgent(id, agent, verbose);
-          return await wrappedFn(state);
+          return await wrappedFn(state, runConfig);
         } else {
           console.warn(`[Worker:${id}] Agent provided but does not appear to be a ReAct agent. Falling back to default execution.`);
         }
@@ -2272,6 +2291,9 @@ Execute the assigned task using your skills and tools. Provide a clear, actionab
         status: "routing"
       };
     } catch (error) {
+      if (error && typeof error === "object" && "constructor" in error && error.constructor.name === "GraphInterrupt") {
+        throw error;
+      }
       console.error(`[Worker:${id}] Error:`, error);
       const currentAssignment = state.activeAssignments.find(
         (assignment) => assignment.workerId === id

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentforge/patterns",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Agent patterns (ReAct, Planner-Executor) for AgentForge framework",
   "type": "module",
   "main": "./dist/index.cjs",