@agentforge/patterns 0.11.0 → 0.11.2

package/README.md

@@ -514,6 +514,13 @@ pnpm test:coverage
 pnpm typecheck
 ```
 
+## 🔗 Links
+
+- [GitHub Repository](https://github.com/TVScoundrel/agentforge)
+- [npm Package](https://www.npmjs.com/package/@agentforge/patterns)
+- [Changelog](https://tvscoundrel.github.io/agentforge/changelog.html) - See what's new before upgrading
+- [Report Issues](https://github.com/TVScoundrel/agentforge/issues)
+
 ## License
 
 MIT © 2026 Tom Van Schoor

package/dist/index.cjs

@@ -2608,11 +2608,22 @@ function createSupervisorNode(config) {
           priority: assignment.priority
         }
       }));
+      const updatedWorkers = { ...state.workers };
+      for (const assignment of assignments) {
+        const worker = updatedWorkers[assignment.workerId];
+        if (worker) {
+          updatedWorkers[assignment.workerId] = {
+            ...worker,
+            currentWorkload: worker.currentWorkload + 1
+          };
+        }
+      }
       logger2.info("Supervisor routing complete", {
         currentAgent: targetAgents.join(","),
         status: "executing",
         assignmentCount: assignments.length,
-        nextIteration: state.iteration + 1
+        nextIteration: state.iteration + 1,
+        workloadUpdates: Object.entries(updatedWorkers).filter(([id]) => targetAgents.includes(id)).map(([id, caps]) => ({ workerId: id, newWorkload: caps.currentWorkload }))
       });
       return {
         currentAgent: targetAgents.join(","),
@@ -2622,6 +2633,8 @@ function createSupervisorNode(config) {
         activeAssignments: assignments,
         // Multiple assignments for parallel execution!
         messages,
+        workers: updatedWorkers,
+        // Include updated workload
         // Add 1 to iteration counter (uses additive reducer)
         iteration: 1
       };
@@ -2673,96 +2686,100 @@ function createWorkerNode(config) {
         taskLength: currentAssignment.task.length,
         taskPreview: currentAssignment.task.substring(0, 100)
       });
+      let executionResult;
       if (executeFn) {
         logger2.debug("Using custom execution function", { workerId: id });
-        return await executeFn(state, runConfig);
-      }
-      if (agent) {
-        if (isReActAgent(agent)) {
-          logger2.debug("Using ReAct agent", { workerId: id });
-          const wrappedFn = wrapReActAgent(id, agent, verbose);
-          return await wrappedFn(state, runConfig);
-        } else {
-          logger2.warn("Agent provided but not a ReAct agent, falling back", { workerId: id });
-        }
-      }
-      if (!model) {
+        executionResult = await executeFn(state, runConfig);
+      } else if (agent && isReActAgent(agent)) {
+        logger2.debug("Using ReAct agent", { workerId: id });
+        const wrappedFn = wrapReActAgent(id, agent, verbose);
+        executionResult = await wrappedFn(state, runConfig);
+      } else if (model) {
+        executionResult = await executeWithLLM();
+      } else {
         logger2.error("Worker missing required configuration", { workerId: id });
         throw new Error(
           `Worker ${id} requires either a model, an agent, or a custom execution function. Provide one of: config.model, config.agent, or config.executeFn`
         );
       }
-      logger2.debug("Using default LLM execution", {
-        workerId: id,
-        hasTools: tools.length > 0,
-        toolCount: tools.length
-      });
-      const defaultSystemPrompt = `You are a specialized worker agent with the following capabilities:
-Skills: ${capabilities.skills.join(", ")}
-Tools: ${capabilities.tools.join(", ")}
-
-Execute the assigned task using your skills and tools. Provide a clear, actionable result.`;
-      const messages = [
-        new import_messages5.SystemMessage(systemPrompt || defaultSystemPrompt),
-        new import_messages5.HumanMessage(currentAssignment.task)
-      ];
-      let modelToUse = model;
-      if (tools.length > 0 && model.bindTools) {
-        logger2.debug("Binding tools to model", {
-          workerId: id,
-          toolCount: tools.length,
-          toolNames: tools.map((t) => t.metadata.name)
-        });
-        const langchainTools = (0, import_core9.toLangChainTools)(tools);
-        modelToUse = model.bindTools(langchainTools);
-      }
-      logger2.debug("Invoking LLM", { workerId: id });
-      const response = await modelToUse.invoke(messages);
-      const result = typeof response.content === "string" ? response.content : JSON.stringify(response.content);
-      logger2.info("Worker task completed", {
-        workerId: id,
-        assignmentId: currentAssignment.id,
-        resultLength: result.length,
-        resultPreview: result.substring(0, 100)
-      });
-      const taskResult = {
-        assignmentId: currentAssignment.id,
-        workerId: id,
-        success: true,
-        result,
-        completedAt: Date.now(),
-        metadata: {
-          skills_used: capabilities.skills
-        }
-      };
-      const message = {
-        id: `msg-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
-        from: id,
-        to: ["supervisor"],
-        type: "task_result",
-        content: result,
-        timestamp: Date.now(),
-        metadata: {
-          assignmentId: currentAssignment.id,
-          success: true
-        }
-      };
+      const currentWorker = state.workers[id];
       const updatedWorkers = {
         ...state.workers,
         [id]: {
-          ...capabilities,
-          currentWorkload: Math.max(0, capabilities.currentWorkload - 1)
+          ...currentWorker,
+          currentWorkload: Math.max(0, currentWorker.currentWorkload - 1)
         }
       };
       logger2.debug("Worker state update", {
         workerId: id,
+        previousWorkload: currentWorker.currentWorkload,
         newWorkload: updatedWorkers[id].currentWorkload
       });
       return {
-        completedTasks: [taskResult],
-        messages: [message],
+        ...executionResult,
         workers: updatedWorkers
       };
+      async function executeWithLLM() {
+        logger2.debug("Using default LLM execution", {
+          workerId: id,
+          hasTools: tools.length > 0,
+          toolCount: tools.length
+        });
+        const defaultSystemPrompt = `You are a specialized worker agent with the following capabilities:
+Skills: ${capabilities.skills.join(", ")}
+Tools: ${capabilities.tools.join(", ")}
+
+Execute the assigned task using your skills and tools. Provide a clear, actionable result.`;
+        const messages = [
+          new import_messages5.SystemMessage(systemPrompt || defaultSystemPrompt),
+          new import_messages5.HumanMessage(currentAssignment.task)
+        ];
+        let modelToUse = model;
+        if (tools.length > 0 && model.bindTools) {
+          logger2.debug("Binding tools to model", {
+            workerId: id,
+            toolCount: tools.length,
+            toolNames: tools.map((t) => t.metadata.name)
+          });
+          const langchainTools = (0, import_core9.toLangChainTools)(tools);
+          modelToUse = model.bindTools(langchainTools);
+        }
+        logger2.debug("Invoking LLM", { workerId: id });
+        const response = await modelToUse.invoke(messages);
+        const result = typeof response.content === "string" ? response.content : JSON.stringify(response.content);
+        logger2.info("Worker task completed", {
+          workerId: id,
+          assignmentId: currentAssignment.id,
+          resultLength: result.length,
+          resultPreview: result.substring(0, 100)
+        });
+        const taskResult = {
+          assignmentId: currentAssignment.id,
+          workerId: id,
+          success: true,
+          result,
+          completedAt: Date.now(),
+          metadata: {
+            skills_used: capabilities.skills
+          }
+        };
+        const message = {
+          id: `msg-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+          from: id,
+          to: ["supervisor"],
+          type: "task_result",
+          content: result,
+          timestamp: Date.now(),
+          metadata: {
+            assignmentId: currentAssignment.id,
+            success: true
+          }
+        };
+        return {
+          completedTasks: [taskResult],
+          messages: [message]
+        };
+      }
     } catch (error) {
       const errorMessage = handleNodeError(error, `worker:${id}`, false);
       logger2.error("Worker node error", {

package/dist/index.js

@@ -2505,11 +2505,22 @@ function createSupervisorNode(config) {
           priority: assignment.priority
         }
       }));
+      const updatedWorkers = { ...state.workers };
+      for (const assignment of assignments) {
+        const worker = updatedWorkers[assignment.workerId];
+        if (worker) {
+          updatedWorkers[assignment.workerId] = {
+            ...worker,
+            currentWorkload: worker.currentWorkload + 1
+          };
+        }
+      }
       logger2.info("Supervisor routing complete", {
         currentAgent: targetAgents.join(","),
         status: "executing",
         assignmentCount: assignments.length,
-        nextIteration: state.iteration + 1
+        nextIteration: state.iteration + 1,
+        workloadUpdates: Object.entries(updatedWorkers).filter(([id]) => targetAgents.includes(id)).map(([id, caps]) => ({ workerId: id, newWorkload: caps.currentWorkload }))
       });
       return {
         currentAgent: targetAgents.join(","),
@@ -2519,6 +2530,8 @@ function createSupervisorNode(config) {
         activeAssignments: assignments,
         // Multiple assignments for parallel execution!
         messages,
+        workers: updatedWorkers,
+        // Include updated workload
         // Add 1 to iteration counter (uses additive reducer)
         iteration: 1
       };
@@ -2570,96 +2583,100 @@ function createWorkerNode(config) {
         taskLength: currentAssignment.task.length,
         taskPreview: currentAssignment.task.substring(0, 100)
       });
+      let executionResult;
       if (executeFn) {
         logger2.debug("Using custom execution function", { workerId: id });
-        return await executeFn(state, runConfig);
-      }
-      if (agent) {
-        if (isReActAgent(agent)) {
-          logger2.debug("Using ReAct agent", { workerId: id });
-          const wrappedFn = wrapReActAgent(id, agent, verbose);
-          return await wrappedFn(state, runConfig);
-        } else {
-          logger2.warn("Agent provided but not a ReAct agent, falling back", { workerId: id });
-        }
-      }
-      if (!model) {
+        executionResult = await executeFn(state, runConfig);
+      } else if (agent && isReActAgent(agent)) {
+        logger2.debug("Using ReAct agent", { workerId: id });
+        const wrappedFn = wrapReActAgent(id, agent, verbose);
+        executionResult = await wrappedFn(state, runConfig);
+      } else if (model) {
+        executionResult = await executeWithLLM();
+      } else {
         logger2.error("Worker missing required configuration", { workerId: id });
         throw new Error(
           `Worker ${id} requires either a model, an agent, or a custom execution function. Provide one of: config.model, config.agent, or config.executeFn`
         );
       }
-      logger2.debug("Using default LLM execution", {
-        workerId: id,
-        hasTools: tools.length > 0,
-        toolCount: tools.length
-      });
-      const defaultSystemPrompt = `You are a specialized worker agent with the following capabilities:
-Skills: ${capabilities.skills.join(", ")}
-Tools: ${capabilities.tools.join(", ")}
-
-Execute the assigned task using your skills and tools. Provide a clear, actionable result.`;
-      const messages = [
-        new SystemMessage5(systemPrompt || defaultSystemPrompt),
-        new HumanMessage5(currentAssignment.task)
-      ];
-      let modelToUse = model;
-      if (tools.length > 0 && model.bindTools) {
-        logger2.debug("Binding tools to model", {
-          workerId: id,
-          toolCount: tools.length,
-          toolNames: tools.map((t) => t.metadata.name)
-        });
-        const langchainTools = toLangChainTools2(tools);
-        modelToUse = model.bindTools(langchainTools);
-      }
-      logger2.debug("Invoking LLM", { workerId: id });
-      const response = await modelToUse.invoke(messages);
-      const result = typeof response.content === "string" ? response.content : JSON.stringify(response.content);
-      logger2.info("Worker task completed", {
-        workerId: id,
-        assignmentId: currentAssignment.id,
-        resultLength: result.length,
-        resultPreview: result.substring(0, 100)
-      });
-      const taskResult = {
-        assignmentId: currentAssignment.id,
-        workerId: id,
-        success: true,
-        result,
-        completedAt: Date.now(),
-        metadata: {
-          skills_used: capabilities.skills
-        }
-      };
-      const message = {
-        id: `msg-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
-        from: id,
-        to: ["supervisor"],
-        type: "task_result",
-        content: result,
-        timestamp: Date.now(),
-        metadata: {
-          assignmentId: currentAssignment.id,
-          success: true
-        }
-      };
+      const currentWorker = state.workers[id];
       const updatedWorkers = {
         ...state.workers,
         [id]: {
-          ...capabilities,
-          currentWorkload: Math.max(0, capabilities.currentWorkload - 1)
+          ...currentWorker,
+          currentWorkload: Math.max(0, currentWorker.currentWorkload - 1)
         }
       };
       logger2.debug("Worker state update", {
         workerId: id,
+        previousWorkload: currentWorker.currentWorkload,
         newWorkload: updatedWorkers[id].currentWorkload
       });
       return {
-        completedTasks: [taskResult],
-        messages: [message],
+        ...executionResult,
         workers: updatedWorkers
       };
+      async function executeWithLLM() {
+        logger2.debug("Using default LLM execution", {
+          workerId: id,
+          hasTools: tools.length > 0,
+          toolCount: tools.length
+        });
+        const defaultSystemPrompt = `You are a specialized worker agent with the following capabilities:
+Skills: ${capabilities.skills.join(", ")}
+Tools: ${capabilities.tools.join(", ")}
+
+Execute the assigned task using your skills and tools. Provide a clear, actionable result.`;
+        const messages = [
+          new SystemMessage5(systemPrompt || defaultSystemPrompt),
+          new HumanMessage5(currentAssignment.task)
+        ];
+        let modelToUse = model;
+        if (tools.length > 0 && model.bindTools) {
+          logger2.debug("Binding tools to model", {
+            workerId: id,
+            toolCount: tools.length,
+            toolNames: tools.map((t) => t.metadata.name)
+          });
+          const langchainTools = toLangChainTools2(tools);
+          modelToUse = model.bindTools(langchainTools);
+        }
+        logger2.debug("Invoking LLM", { workerId: id });
+        const response = await modelToUse.invoke(messages);
+        const result = typeof response.content === "string" ? response.content : JSON.stringify(response.content);
+        logger2.info("Worker task completed", {
+          workerId: id,
+          assignmentId: currentAssignment.id,
+          resultLength: result.length,
+          resultPreview: result.substring(0, 100)
+        });
+        const taskResult = {
+          assignmentId: currentAssignment.id,
+          workerId: id,
+          success: true,
+          result,
+          completedAt: Date.now(),
+          metadata: {
+            skills_used: capabilities.skills
+          }
+        };
+        const message = {
+          id: `msg-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+          from: id,
+          to: ["supervisor"],
+          type: "task_result",
+          content: result,
+          timestamp: Date.now(),
+          metadata: {
+            assignmentId: currentAssignment.id,
+            success: true
+          }
+        };
+        return {
+          completedTasks: [taskResult],
+          messages: [message]
+        };
+      }
     } catch (error) {
       const errorMessage = handleNodeError(error, `worker:${id}`, false);
       logger2.error("Worker node error", {

package/package.json

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