@agentforge/patterns 0.15.3 → 0.15.5

package/dist/index.cjs

@@ -302,8 +302,8 @@ function generateToolCallCacheKey(toolName, args) {
   return `${toolName}:${sortedArgs}`;
 }
 function createPatternLogger(name, defaultLevel = "info") {
-  const logLevel4 = process.env.LOG_LEVEL?.toLowerCase() || defaultLevel;
-  return (0, import_core2.createLogger)(name, { level: logLevel4 });
+  const logLevel = process.env.LOG_LEVEL?.toLowerCase() || defaultLevel;
+  return (0, import_core2.createLogger)(name, { level: logLevel });
 }
 function calculateDeduplicationSavings(duplicatesSkipped, toolsExecuted) {
   if (duplicatesSkipped === 0) {
@@ -2403,17 +2403,87 @@ function getRoutingStrategy(name) {
 }
 
 // src/multi-agent/utils.ts
-var import_core8 = require("@agentforge/core");
-var logLevel = process.env.LOG_LEVEL?.toLowerCase() || import_core8.LogLevel.INFO;
-var logger = (0, import_core8.createLogger)("multi-agent", { level: logLevel });
+var logger = createPatternLogger("agentforge:patterns:multi-agent:utils");
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function toRunnableConfig(config) {
+  if (!isRecord(config)) {
+    return void 0;
+  }
+  return config;
+}
+function getReActResultShape(value) {
+  if (!isRecord(value)) {
+    return {};
+  }
+  const messages = Array.isArray(value.messages) ? value.messages.filter((message) => isRecord(message)) : void 0;
+  const actions = Array.isArray(value.actions) ? value.actions.filter((action) => isRecord(action)) : void 0;
+  return {
+    messages,
+    actions,
+    iteration: value.iteration
+  };
+}
+function safeSerializeContent(content) {
+  if (content === null || content === void 0) {
+    return void 0;
+  }
+  if (typeof content === "string") {
+    return content.length > 0 ? content : void 0;
+  }
+  if (Array.isArray(content)) {
+    const parts = content.map((part) => {
+      if (typeof part === "string") {
+        return part;
+      }
+      if (isRecord(part) && typeof part.text === "string" && part.text.length > 0) {
+        return part.text;
+      }
+      try {
+        return JSON.stringify(part);
+      } catch {
+        return String(part);
+      }
+    }).filter((part) => part.length > 0);
+    return parts.length > 0 ? parts.join("\n") : void 0;
+  }
+  try {
+    const serialized = JSON.stringify(content);
+    if (typeof serialized === "string" && serialized.length > 0 && serialized !== "null") {
+      return serialized;
+    }
+  } catch {
+  }
+  const fallback = String(content);
+  return fallback.length > 0 ? fallback : void 0;
+}
+function extractResponse(resultShape) {
+  const { messages } = resultShape;
+  const lastMessage = messages?.[messages.length - 1];
+  const serialized = safeSerializeContent(lastMessage?.content);
+  return serialized ?? "No response";
+}
+function extractToolsUsed(resultShape) {
+  const { actions } = resultShape;
+  const names = actions?.map((action) => action.name).filter((name) => typeof name === "string" && name.length > 0) || [];
+  return [...new Set(names)];
+}
+function extractIteration(resultShape) {
+  const { iteration } = resultShape;
+  return typeof iteration === "number" && Number.isFinite(iteration) ? iteration : 0;
+}
 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");
+  return Boolean(
+    obj && typeof obj === "object" && "invoke" in obj && typeof obj.invoke === "function" && "stream" in obj && 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, config) => {
     try {
       logger.debug("Wrapping ReAct agent execution", { workerId });
+      const runnableConfig = toRunnableConfig(config);
       const currentAssignment = state.activeAssignments.find(
         (assignment) => assignment.workerId === workerId && !state.completedTasks.some((task2) => task2.assignmentId === assignment.id)
       );
@@ -2427,17 +2497,17 @@ function wrapReActAgent(workerId, agent, verbose = false) {
         assignmentId: currentAssignment.id,
         taskPreview: task.substring(0, 100) + (task.length > 100 ? "..." : "")
       });
-      const workerThreadId = config?.configurable?.thread_id ? `${config.configurable.thread_id}:worker:${workerId}` : void 0;
+      const workerThreadId = runnableConfig?.configurable?.thread_id ? `${runnableConfig.configurable.thread_id}:worker:${workerId}` : void 0;
       const workerConfig = workerThreadId ? {
-        ...config,
+        ...runnableConfig,
         configurable: {
-          ...config.configurable,
+          ...runnableConfig?.configurable ?? {},
           thread_id: workerThreadId
         }
-      } : config;
+      } : runnableConfig;
       logger.debug("Invoking ReAct agent with worker-specific config", {
         workerId,
-        parentThreadId: config?.configurable?.thread_id,
+        parentThreadId: runnableConfig?.configurable?.thread_id,
         workerThreadId,
         hasConfig: !!workerConfig
       });
@@ -2448,13 +2518,13 @@ function wrapReActAgent(workerId, agent, verbose = false) {
         workerConfig
         // Worker-specific config with unique thread_id
       );
-      const response = result.messages?.[result.messages.length - 1]?.content || "No response";
+      const resultShape = getReActResultShape(result);
+      const response = extractResponse(resultShape);
       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)];
+      const uniqueTools = extractToolsUsed(resultShape);
       if (uniqueTools.length > 0) {
         logger.debug("Tools used by ReAct agent", { workerId, tools: uniqueTools });
       }
@@ -2466,7 +2536,7 @@ function wrapReActAgent(workerId, agent, verbose = false) {
         success: true,
         metadata: {
           agent_type: "react",
-          iterations: result.iteration || 0,
+          iterations: extractIteration(resultShape),
           tools_used: uniqueTools
         }
       };
@@ -2474,7 +2544,7 @@ function wrapReActAgent(workerId, agent, verbose = false) {
         completedTasks: [taskResult]
       };
     } catch (error) {
-      const errorMessage = handleNodeError(error, `react-agent:${workerId}`, false);
+      const errorMessage = handleNodeError(error, `react-agent:${workerId}`, verbose);
       logger.error("Error in ReAct agent execution", {
         workerId,
         error: errorMessage
@@ -2507,9 +2577,14 @@ function wrapReActAgent(workerId, agent, verbose = false) {
 
 // src/multi-agent/nodes.ts
 var import_messages5 = require("@langchain/core/messages");
-var import_core9 = require("@agentforge/core");
-var logLevel2 = process.env.LOG_LEVEL?.toLowerCase() || import_core9.LogLevel.INFO;
-var logger2 = (0, import_core9.createLogger)("multi-agent:nodes", { level: logLevel2 });
+var import_core8 = require("@agentforge/core");
+var logger2 = createPatternLogger("agentforge:patterns:multi-agent:nodes");
+function convertWorkerToolsForLangChain(tools) {
+  const safeTools = tools ?? [];
+  return (0, import_core8.toLangChainTools)(
+    safeTools
+  );
+}
 var DEFAULT_AGGREGATOR_SYSTEM_PROMPT = `You are an aggregator agent responsible for combining results from multiple worker agents.
 
 Your job is to:
@@ -2733,7 +2808,7 @@ Execute the assigned task using your skills and tools. Provide a clear, actionab
             toolCount: tools.length,
             toolNames: tools.map((t) => t.metadata.name)
           });
-          const langchainTools = (0, import_core9.toLangChainTools)(tools);
+          const langchainTools = convertWorkerToolsForLangChain(tools);
           modelToUse = model.bindTools(langchainTools);
         }
         logger2.debug("Invoking LLM", { workerId: id });
@@ -2955,15 +3030,17 @@ Please synthesize these results into a comprehensive response that addresses the
 
 // src/multi-agent/agent.ts
 var import_langgraph4 = require("@langchain/langgraph");
-var import_core10 = require("@agentforge/core");
-var logLevel3 = process.env.LOG_LEVEL?.toLowerCase() || import_core10.LogLevel.INFO;
-var logger3 = (0, import_core10.createLogger)("multi-agent:system", { level: logLevel3 });
+var logger3 = createPatternLogger("agentforge:patterns:multi-agent:system");
 function getToolName(tool) {
-  if (tool.metadata?.name) {
-    return tool.metadata.name;
+  if (!tool || typeof tool !== "object") {
+    return "unknown";
   }
-  if (tool.name) {
-    return tool.name;
+  const candidate = tool;
+  if (typeof candidate.metadata?.name === "string") {
+    return candidate.metadata.name;
+  }
+  if (typeof candidate.name === "string") {
+    return candidate.name;
   }
   return "unknown";
 }
@@ -3061,7 +3138,7 @@ function createMultiAgentSystem(config) {
   workflow.addConditionalEdges("aggregator", aggregatorRouter, [import_langgraph4.END]);
   const compiled = workflow.compile(checkpointer ? { checkpointer } : void 0);
   const originalInvoke = compiled.invoke.bind(compiled);
-  compiled.invoke = async function(input, config2) {
+  compiled.invoke = (async function(input, config2) {
     const mergedInput = {
       ...input,
       workers: {
@@ -3069,10 +3146,13 @@ function createMultiAgentSystem(config) {
         ...input.workers || {}
       }
     };
-    return originalInvoke(mergedInput, config2);
-  };
+    return originalInvoke(
+      mergedInput,
+      config2
+    );
+  });
   const originalStream = compiled.stream.bind(compiled);
-  compiled.stream = async function(input, config2) {
+  compiled.stream = (async function(input, config2) {
     const mergedInput = {
       ...input,
       workers: {
@@ -3080,8 +3160,11 @@ function createMultiAgentSystem(config) {
         ...input.workers || {}
       }
     };
-    return originalStream(mergedInput, config2);
-  };
+    return originalStream(
+      mergedInput,
+      config2
+    );
+  });
   return compiled;
 }
 var MultiAgentSystemBuilder = class {
@@ -3160,7 +3243,7 @@ var MultiAgentSystemBuilder = class {
 };
 function registerWorkers(system, workers) {
   console.warn(
-    "[AgentForge] registerWorkers() on a compiled system only updates worker capabilities in state.\nIt does NOT add worker nodes to the graph. Use MultiAgentSystemBuilder for proper worker registration.\nSee: https://github.com/agentforge/agentforge/blob/main/packages/patterns/docs/multi-agent-pattern.md"
+    "[AgentForge] registerWorkers() on a compiled system only updates worker capabilities in state.\nIt does NOT add worker nodes to the graph. Use MultiAgentSystemBuilder for proper worker registration.\nSee: https://github.com/TVScoundrel/agentforge/blob/main/packages/patterns/docs/multi-agent-pattern.md"
   );
   if (!system._workerRegistry) {
     system._workerRegistry = {};
@@ -3175,7 +3258,7 @@ function registerWorkers(system, workers) {
   }
   if (!system._originalInvoke) {
     system._originalInvoke = system.invoke.bind(system);
-    system.invoke = async function(input, config) {
+    system.invoke = (async function(input, config) {
       const mergedInput = {
         ...input,
         workers: {
@@ -3183,12 +3266,15 @@ function registerWorkers(system, workers) {
           ...input.workers || {}
         }
       };
-      return system._originalInvoke(mergedInput, config);
-    };
+      return system._originalInvoke(
+        mergedInput,
+        config
+      );
+    });
   }
   if (!system._originalStream) {
     system._originalStream = system.stream.bind(system);
-    system.stream = async function(input, config) {
+    system.stream = (async function(input, config) {
       const mergedInput = {
         ...input,
         workers: {
@@ -3196,8 +3282,11 @@ function registerWorkers(system, workers) {
           ...input.workers || {}
         }
       };
-      return system._originalStream(mergedInput, config);
-    };
+      return system._originalStream(
+        mergedInput,
+        config
+      );
+    });
   }
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/index.d.cts

@@ -4,6 +4,7 @@ import { BaseCheckpointSaver, CompiledStateGraph } from '@langchain/langgraph';
 import { BaseChatModel } from '@langchain/core/language_models/chat_models';
 import * as _agentforge_core from '@agentforge/core';
 import { ToolRegistry, Tool, LogLevel } from '@agentforge/core';
+import { RunnableConfig } from '@langchain/core/runnables';
 
 /**
  * Zod schemas for ReAct pattern state
@@ -2526,6 +2527,14 @@ type MultiAgentStateType = {
  * @module patterns/multi-agent/types
  */
 
+type WorkerTool = Tool<never, unknown>;
+/**
+ * Runtime config passed to worker execution functions.
+ *
+ * Includes LangGraph's RunnableConfig while remaining open to caller-defined
+ * keys used by integrations.
+ */
+type WorkerExecutionConfig = RunnableConfig | Record<string, unknown>;
 /**
  * Configuration for the supervisor node
  */
@@ -2582,7 +2591,7 @@ interface WorkerConfig {
     /**
      * Available tools for this worker
      */
-    tools?: Tool<any, any>[];
+    tools?: WorkerTool[];
     /**
      * System prompt for the worker
      */
@@ -2600,7 +2609,7 @@ interface WorkerConfig {
      * The config parameter contains LangGraph runtime configuration including
      * thread_id for checkpointing, which is required for interrupt functionality.
      */
-    executeFn?: (state: MultiAgentStateType, config?: any) => Promise<Partial<MultiAgentStateType>>;
+    executeFn?: (state: MultiAgentStateType, config?: WorkerExecutionConfig) => Promise<Partial<MultiAgentStateType>>;
     /**
      * ReAct agent instance
      *
@@ -2623,7 +2632,7 @@ interface WorkerConfig {
      * });
      * ```
      */
-    agent?: CompiledStateGraph<any, any>;
+    agent?: CompiledStateGraph<unknown, unknown>;
 }
 /**
  * Configuration for the aggregator node
@@ -2737,7 +2746,7 @@ type MultiAgentNode = 'supervisor' | 'aggregator' | string;
 /**
  * Route type for multi-agent graph
  */
-type MultiAgentRoute = 'continue' | 'aggregate' | 'end' | string;
+type MultiAgentRoute = 'continue' | 'aggregate' | 'end' | string | string[];
 /**
  * Router function type
  */
@@ -2985,9 +2994,9 @@ declare class MultiAgentSystemBuilder {
         name: string;
         description?: string;
         capabilities: string[];
-        tools?: any[];
+        tools?: WorkerConfig['tools'];
         systemPrompt?: string;
-        model?: any;
+        model?: WorkerConfig['model'];
     }>): this;
     /**
      * Build and compile the multi-agent system
@@ -2999,10 +3008,10 @@ declare class MultiAgentSystemBuilder {
 /**
  * Extended multi-agent system with worker registration support
  */
-interface MultiAgentSystemWithRegistry extends CompiledStateGraph<any, any, any> {
+interface MultiAgentSystemWithRegistry extends CompiledStateGraph<MultiAgentStateType, unknown> {
     _workerRegistry?: Record<string, WorkerCapabilities>;
-    _originalInvoke?: typeof CompiledStateGraph.prototype.invoke;
-    _originalStream?: typeof CompiledStateGraph.prototype.stream;
+    _originalInvoke?: MultiAgentSystemWithRegistry['invoke'];
+    _originalStream?: MultiAgentSystemWithRegistry['stream'];
 }
 /**
  * Register workers with a compiled multi-agent system
@@ -3035,7 +3044,7 @@ declare function registerWorkers(system: MultiAgentSystemWithRegistry, workers:
     name: string;
     description?: string;
     capabilities: string[];
-    tools?: any[];
+    tools?: WorkerConfig['tools'];
     systemPrompt?: string;
 }>): void;
 

package/dist/index.d.ts

@@ -4,6 +4,7 @@ import { BaseCheckpointSaver, CompiledStateGraph } from '@langchain/langgraph';
 import { BaseChatModel } from '@langchain/core/language_models/chat_models';
 import * as _agentforge_core from '@agentforge/core';
 import { ToolRegistry, Tool, LogLevel } from '@agentforge/core';
+import { RunnableConfig } from '@langchain/core/runnables';
 
 /**
  * Zod schemas for ReAct pattern state
@@ -2526,6 +2527,14 @@ type MultiAgentStateType = {
  * @module patterns/multi-agent/types
  */
 
+type WorkerTool = Tool<never, unknown>;
+/**
+ * Runtime config passed to worker execution functions.
+ *
+ * Includes LangGraph's RunnableConfig while remaining open to caller-defined
+ * keys used by integrations.
+ */
+type WorkerExecutionConfig = RunnableConfig | Record<string, unknown>;
 /**
  * Configuration for the supervisor node
  */
@@ -2582,7 +2591,7 @@ interface WorkerConfig {
     /**
      * Available tools for this worker
      */
-    tools?: Tool<any, any>[];
+    tools?: WorkerTool[];
     /**
      * System prompt for the worker
      */
@@ -2600,7 +2609,7 @@ interface WorkerConfig {
      * The config parameter contains LangGraph runtime configuration including
      * thread_id for checkpointing, which is required for interrupt functionality.
      */
-    executeFn?: (state: MultiAgentStateType, config?: any) => Promise<Partial<MultiAgentStateType>>;
+    executeFn?: (state: MultiAgentStateType, config?: WorkerExecutionConfig) => Promise<Partial<MultiAgentStateType>>;
     /**
      * ReAct agent instance
      *
@@ -2623,7 +2632,7 @@ interface WorkerConfig {
      * });
      * ```
      */
-    agent?: CompiledStateGraph<any, any>;
+    agent?: CompiledStateGraph<unknown, unknown>;
 }
 /**
  * Configuration for the aggregator node
@@ -2737,7 +2746,7 @@ type MultiAgentNode = 'supervisor' | 'aggregator' | string;
 /**
  * Route type for multi-agent graph
  */
-type MultiAgentRoute = 'continue' | 'aggregate' | 'end' | string;
+type MultiAgentRoute = 'continue' | 'aggregate' | 'end' | string | string[];
 /**
  * Router function type
  */
@@ -2985,9 +2994,9 @@ declare class MultiAgentSystemBuilder {
         name: string;
         description?: string;
         capabilities: string[];
-        tools?: any[];
+        tools?: WorkerConfig['tools'];
         systemPrompt?: string;
-        model?: any;
+        model?: WorkerConfig['model'];
     }>): this;
     /**
      * Build and compile the multi-agent system
@@ -2999,10 +3008,10 @@ declare class MultiAgentSystemBuilder {
 /**
  * Extended multi-agent system with worker registration support
  */
-interface MultiAgentSystemWithRegistry extends CompiledStateGraph<any, any, any> {
+interface MultiAgentSystemWithRegistry extends CompiledStateGraph<MultiAgentStateType, unknown> {
     _workerRegistry?: Record<string, WorkerCapabilities>;
-    _originalInvoke?: typeof CompiledStateGraph.prototype.invoke;
-    _originalStream?: typeof CompiledStateGraph.prototype.stream;
+    _originalInvoke?: MultiAgentSystemWithRegistry['invoke'];
+    _originalStream?: MultiAgentSystemWithRegistry['stream'];
 }
 /**
  * Register workers with a compiled multi-agent system
@@ -3035,7 +3044,7 @@ declare function registerWorkers(system: MultiAgentSystemWithRegistry, workers:
     name: string;
     description?: string;
     capabilities: string[];
-    tools?: any[];
+    tools?: WorkerConfig['tools'];
     systemPrompt?: string;
 }>): void;
 

package/dist/index.js

@@ -199,8 +199,8 @@ function generateToolCallCacheKey(toolName, args) {
   return `${toolName}:${sortedArgs}`;
 }
 function createPatternLogger(name, defaultLevel = "info") {
-  const logLevel4 = process.env.LOG_LEVEL?.toLowerCase() || defaultLevel;
-  return createLogger(name, { level: logLevel4 });
+  const logLevel = process.env.LOG_LEVEL?.toLowerCase() || defaultLevel;
+  return createLogger(name, { level: logLevel });
 }
 function calculateDeduplicationSavings(duplicatesSkipped, toolsExecuted) {
   if (duplicatesSkipped === 0) {
@@ -2300,17 +2300,87 @@ function getRoutingStrategy(name) {
 }
 
 // src/multi-agent/utils.ts
-import { createLogger as createLogger2, LogLevel } from "@agentforge/core";
-var logLevel = process.env.LOG_LEVEL?.toLowerCase() || LogLevel.INFO;
-var logger = createLogger2("multi-agent", { level: logLevel });
+var logger = createPatternLogger("agentforge:patterns:multi-agent:utils");
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function toRunnableConfig(config) {
+  if (!isRecord(config)) {
+    return void 0;
+  }
+  return config;
+}
+function getReActResultShape(value) {
+  if (!isRecord(value)) {
+    return {};
+  }
+  const messages = Array.isArray(value.messages) ? value.messages.filter((message) => isRecord(message)) : void 0;
+  const actions = Array.isArray(value.actions) ? value.actions.filter((action) => isRecord(action)) : void 0;
+  return {
+    messages,
+    actions,
+    iteration: value.iteration
+  };
+}
+function safeSerializeContent(content) {
+  if (content === null || content === void 0) {
+    return void 0;
+  }
+  if (typeof content === "string") {
+    return content.length > 0 ? content : void 0;
+  }
+  if (Array.isArray(content)) {
+    const parts = content.map((part) => {
+      if (typeof part === "string") {
+        return part;
+      }
+      if (isRecord(part) && typeof part.text === "string" && part.text.length > 0) {
+        return part.text;
+      }
+      try {
+        return JSON.stringify(part);
+      } catch {
+        return String(part);
+      }
+    }).filter((part) => part.length > 0);
+    return parts.length > 0 ? parts.join("\n") : void 0;
+  }
+  try {
+    const serialized = JSON.stringify(content);
+    if (typeof serialized === "string" && serialized.length > 0 && serialized !== "null") {
+      return serialized;
+    }
+  } catch {
+  }
+  const fallback = String(content);
+  return fallback.length > 0 ? fallback : void 0;
+}
+function extractResponse(resultShape) {
+  const { messages } = resultShape;
+  const lastMessage = messages?.[messages.length - 1];
+  const serialized = safeSerializeContent(lastMessage?.content);
+  return serialized ?? "No response";
+}
+function extractToolsUsed(resultShape) {
+  const { actions } = resultShape;
+  const names = actions?.map((action) => action.name).filter((name) => typeof name === "string" && name.length > 0) || [];
+  return [...new Set(names)];
+}
+function extractIteration(resultShape) {
+  const { iteration } = resultShape;
+  return typeof iteration === "number" && Number.isFinite(iteration) ? iteration : 0;
+}
 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");
+  return Boolean(
+    obj && typeof obj === "object" && "invoke" in obj && typeof obj.invoke === "function" && "stream" in obj && 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, config) => {
     try {
       logger.debug("Wrapping ReAct agent execution", { workerId });
+      const runnableConfig = toRunnableConfig(config);
       const currentAssignment = state.activeAssignments.find(
         (assignment) => assignment.workerId === workerId && !state.completedTasks.some((task2) => task2.assignmentId === assignment.id)
       );
@@ -2324,17 +2394,17 @@ function wrapReActAgent(workerId, agent, verbose = false) {
         assignmentId: currentAssignment.id,
         taskPreview: task.substring(0, 100) + (task.length > 100 ? "..." : "")
       });
-      const workerThreadId = config?.configurable?.thread_id ? `${config.configurable.thread_id}:worker:${workerId}` : void 0;
+      const workerThreadId = runnableConfig?.configurable?.thread_id ? `${runnableConfig.configurable.thread_id}:worker:${workerId}` : void 0;
       const workerConfig = workerThreadId ? {
-        ...config,
+        ...runnableConfig,
         configurable: {
-          ...config.configurable,
+          ...runnableConfig?.configurable ?? {},
           thread_id: workerThreadId
         }
-      } : config;
+      } : runnableConfig;
       logger.debug("Invoking ReAct agent with worker-specific config", {
         workerId,
-        parentThreadId: config?.configurable?.thread_id,
+        parentThreadId: runnableConfig?.configurable?.thread_id,
         workerThreadId,
         hasConfig: !!workerConfig
       });
@@ -2345,13 +2415,13 @@ function wrapReActAgent(workerId, agent, verbose = false) {
         workerConfig
         // Worker-specific config with unique thread_id
       );
-      const response = result.messages?.[result.messages.length - 1]?.content || "No response";
+      const resultShape = getReActResultShape(result);
+      const response = extractResponse(resultShape);
       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)];
+      const uniqueTools = extractToolsUsed(resultShape);
       if (uniqueTools.length > 0) {
         logger.debug("Tools used by ReAct agent", { workerId, tools: uniqueTools });
       }
@@ -2363,7 +2433,7 @@ function wrapReActAgent(workerId, agent, verbose = false) {
         success: true,
         metadata: {
           agent_type: "react",
-          iterations: result.iteration || 0,
+          iterations: extractIteration(resultShape),
           tools_used: uniqueTools
         }
       };
@@ -2371,7 +2441,7 @@ function wrapReActAgent(workerId, agent, verbose = false) {
         completedTasks: [taskResult]
       };
     } catch (error) {
-      const errorMessage = handleNodeError(error, `react-agent:${workerId}`, false);
+      const errorMessage = handleNodeError(error, `react-agent:${workerId}`, verbose);
       logger.error("Error in ReAct agent execution", {
         workerId,
         error: errorMessage
@@ -2404,9 +2474,14 @@ function wrapReActAgent(workerId, agent, verbose = false) {
 
 // src/multi-agent/nodes.ts
 import { HumanMessage as HumanMessage5, SystemMessage as SystemMessage5 } from "@langchain/core/messages";
-import { toLangChainTools as toLangChainTools2, createLogger as createLogger3, LogLevel as LogLevel2 } from "@agentforge/core";
-var logLevel2 = process.env.LOG_LEVEL?.toLowerCase() || LogLevel2.INFO;
-var logger2 = createLogger3("multi-agent:nodes", { level: logLevel2 });
+import { toLangChainTools as toLangChainTools2 } from "@agentforge/core";
+var logger2 = createPatternLogger("agentforge:patterns:multi-agent:nodes");
+function convertWorkerToolsForLangChain(tools) {
+  const safeTools = tools ?? [];
+  return toLangChainTools2(
+    safeTools
+  );
+}
 var DEFAULT_AGGREGATOR_SYSTEM_PROMPT = `You are an aggregator agent responsible for combining results from multiple worker agents.
 
 Your job is to:
@@ -2630,7 +2705,7 @@ Execute the assigned task using your skills and tools. Provide a clear, actionab
             toolCount: tools.length,
             toolNames: tools.map((t) => t.metadata.name)
           });
-          const langchainTools = toLangChainTools2(tools);
+          const langchainTools = convertWorkerToolsForLangChain(tools);
           modelToUse = model.bindTools(langchainTools);
         }
         logger2.debug("Invoking LLM", { workerId: id });
@@ -2852,15 +2927,17 @@ Please synthesize these results into a comprehensive response that addresses the
 
 // src/multi-agent/agent.ts
 import { StateGraph as StateGraph4, END as END4 } from "@langchain/langgraph";
-import { createLogger as createLogger4, LogLevel as LogLevel3 } from "@agentforge/core";
-var logLevel3 = process.env.LOG_LEVEL?.toLowerCase() || LogLevel3.INFO;
-var logger3 = createLogger4("multi-agent:system", { level: logLevel3 });
+var logger3 = createPatternLogger("agentforge:patterns:multi-agent:system");
 function getToolName(tool) {
-  if (tool.metadata?.name) {
-    return tool.metadata.name;
+  if (!tool || typeof tool !== "object") {
+    return "unknown";
+  }
+  const candidate = tool;
+  if (typeof candidate.metadata?.name === "string") {
+    return candidate.metadata.name;
   }
-  if (tool.name) {
-    return tool.name;
+  if (typeof candidate.name === "string") {
+    return candidate.name;
   }
   return "unknown";
 }
@@ -2958,7 +3035,7 @@ function createMultiAgentSystem(config) {
   workflow.addConditionalEdges("aggregator", aggregatorRouter, [END4]);
   const compiled = workflow.compile(checkpointer ? { checkpointer } : void 0);
   const originalInvoke = compiled.invoke.bind(compiled);
-  compiled.invoke = async function(input, config2) {
+  compiled.invoke = (async function(input, config2) {
     const mergedInput = {
       ...input,
       workers: {
@@ -2966,10 +3043,13 @@ function createMultiAgentSystem(config) {
         ...input.workers || {}
       }
     };
-    return originalInvoke(mergedInput, config2);
-  };
+    return originalInvoke(
+      mergedInput,
+      config2
+    );
+  });
   const originalStream = compiled.stream.bind(compiled);
-  compiled.stream = async function(input, config2) {
+  compiled.stream = (async function(input, config2) {
     const mergedInput = {
       ...input,
       workers: {
@@ -2977,8 +3057,11 @@ function createMultiAgentSystem(config) {
         ...input.workers || {}
       }
     };
-    return originalStream(mergedInput, config2);
-  };
+    return originalStream(
+      mergedInput,
+      config2
+    );
+  });
   return compiled;
 }
 var MultiAgentSystemBuilder = class {
@@ -3057,7 +3140,7 @@ var MultiAgentSystemBuilder = class {
 };
 function registerWorkers(system, workers) {
   console.warn(
-    "[AgentForge] registerWorkers() on a compiled system only updates worker capabilities in state.\nIt does NOT add worker nodes to the graph. Use MultiAgentSystemBuilder for proper worker registration.\nSee: https://github.com/agentforge/agentforge/blob/main/packages/patterns/docs/multi-agent-pattern.md"
+    "[AgentForge] registerWorkers() on a compiled system only updates worker capabilities in state.\nIt does NOT add worker nodes to the graph. Use MultiAgentSystemBuilder for proper worker registration.\nSee: https://github.com/TVScoundrel/agentforge/blob/main/packages/patterns/docs/multi-agent-pattern.md"
   );
   if (!system._workerRegistry) {
     system._workerRegistry = {};
@@ -3072,7 +3155,7 @@ function registerWorkers(system, workers) {
   }
   if (!system._originalInvoke) {
     system._originalInvoke = system.invoke.bind(system);
-    system.invoke = async function(input, config) {
+    system.invoke = (async function(input, config) {
       const mergedInput = {
         ...input,
         workers: {
@@ -3080,12 +3163,15 @@ function registerWorkers(system, workers) {
           ...input.workers || {}
         }
       };
-      return system._originalInvoke(mergedInput, config);
-    };
+      return system._originalInvoke(
+        mergedInput,
+        config
+      );
+    });
   }
   if (!system._originalStream) {
     system._originalStream = system.stream.bind(system);
-    system.stream = async function(input, config) {
+    system.stream = (async function(input, config) {
       const mergedInput = {
         ...input,
         workers: {
@@ -3093,8 +3179,11 @@ function registerWorkers(system, workers) {
           ...input.workers || {}
         }
       };
-      return system._originalStream(mergedInput, config);
-    };
+      return system._originalStream(
+        mergedInput,
+        config
+      );
+    });
   }
 }
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentforge/patterns",
-  "version": "0.15.3",
+  "version": "0.15.5",
   "description": "Production-ready agent workflow patterns for TypeScript including ReAct and Planner-Executor, built on LangGraph.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -41,13 +41,13 @@
     "url": "https://github.com/TVScoundrel/agentforge/issues"
   },
   "dependencies": {
-    "@agentforge/core": "0.15.3",
+    "@agentforge/core": "0.15.5",
     "@langchain/core": "^1.1.17",
     "@langchain/langgraph": "^1.1.2",
     "zod": "^3.23.8"
   },
   "devDependencies": {
-    "@agentforge/testing": "0.15.3",
+    "@agentforge/testing": "0.15.5",
     "@eslint/js": "^9.17.0",
     "@types/node": "^22.10.2",
     "eslint": "^9.17.0",