@agentforge/patterns 0.6.4 → 0.7.0

package/dist/index.cjs

@@ -138,15 +138,46 @@ var ScratchpadEntrySchema = import_zod.z.object({
 });
 
 // src/react/state.ts
-var import_zod2 = require("zod");
+var import_zod3 = require("zod");
 var import_core = require("@agentforge/core");
+
+// src/shared/state-fields.ts
+var import_zod2 = require("zod");
+var iterationField = {
+  schema: import_zod2.z.number().int().nonnegative(),
+  reducer: (left, right) => left + right,
+  default: () => 0,
+  description: "Current iteration number"
+};
+function maxIterationsField(defaultValue) {
+  return {
+    schema: import_zod2.z.number().int().positive(),
+    default: () => defaultValue,
+    description: "Maximum number of iterations allowed"
+  };
+}
+var errorField = {
+  schema: import_zod2.z.string().optional(),
+  description: "Error message if execution failed"
+};
+var responseField = {
+  schema: import_zod2.z.string().optional(),
+  description: "Final response after completion"
+};
+var inputField = {
+  schema: import_zod2.z.string(),
+  default: () => "",
+  description: "Original user input or query"
+};
+
+// src/react/state.ts
 var ReActStateConfig = {
   /**
    * Conversation messages
    * Accumulates all messages in the conversation
    */
   messages: {
-    schema: import_zod2.z.array(MessageSchema),
+    schema: import_zod3.z.array(MessageSchema),
     reducer: (left, right) => [...left, ...right],
     default: () => [],
     description: "Conversation message history"
@@ -156,7 +187,7 @@ var ReActStateConfig = {
    * Accumulates all reasoning steps the agent takes
    */
   thoughts: {
-    schema: import_zod2.z.array(ThoughtSchema),
+    schema: import_zod3.z.array(ThoughtSchema),
     reducer: (left, right) => [...left, ...right],
     default: () => [],
     description: "Agent reasoning steps"
@@ -166,7 +197,7 @@ var ReActStateConfig = {
    * Accumulates all tool calls made by the agent
    */
   actions: {
-    schema: import_zod2.z.array(ToolCallSchema),
+    schema: import_zod3.z.array(ToolCallSchema),
     reducer: (left, right) => [...left, ...right],
     default: () => [],
     description: "Tool calls made by the agent"
@@ -176,7 +207,7 @@ var ReActStateConfig = {
    * Accumulates all observations from tool executions
    */
   observations: {
-    schema: import_zod2.z.array(ToolResultSchema),
+    schema: import_zod3.z.array(ToolResultSchema),
     reducer: (left, right) => [...left, ...right],
     default: () => [],
     description: "Results from tool executions"
@@ -186,7 +217,7 @@ var ReActStateConfig = {
    * Accumulates step-by-step reasoning process
    */
   scratchpad: {
-    schema: import_zod2.z.array(ScratchpadEntrySchema),
+    schema: import_zod3.z.array(ScratchpadEntrySchema),
     reducer: (left, right) => [...left, ...right],
     default: () => [],
     description: "Intermediate reasoning scratchpad"
@@ -195,27 +226,19 @@ var ReActStateConfig = {
    * Current iteration count
    * Tracks how many thought-action-observation loops have been executed
    */
-  iteration: {
-    schema: import_zod2.z.number(),
-    reducer: (left, right) => left + right,
-    default: () => 0,
-    description: "Current iteration count"
-  },
+  iteration: iterationField,
   /**
    * Whether the agent should continue iterating
    */
   shouldContinue: {
-    schema: import_zod2.z.boolean().optional(),
+    schema: import_zod3.z.boolean().optional(),
     default: () => true,
     description: "Whether to continue the ReAct loop"
   },
   /**
    * Final response (if any)
    */
-  response: {
-    schema: import_zod2.z.string().optional(),
-    description: "Final response from the agent"
-  }
+  response: responseField
 };
 var ReActState = (0, import_core.createStateAnnotation)(ReActStateConfig);
 
@@ -279,6 +302,24 @@ function buildDeduplicationMetrics(toolsExecuted, duplicatesSkipped, totalObserv
   };
 }
 
+// src/shared/error-handling.ts
+function isGraphInterrupt(error) {
+  return error !== null && typeof error === "object" && "constructor" in error && error.constructor.name === "GraphInterrupt";
+}
+function handleNodeError(error, context, verbose = false) {
+  if (isGraphInterrupt(error)) {
+    throw error;
+  }
+  const errorMessage = error instanceof Error ? error.message : String(error);
+  if (verbose) {
+    console.error(`[${context}] Error:`, errorMessage);
+    if (error instanceof Error && error.stack) {
+      console.error(`[${context}] Stack:`, error.stack);
+    }
+  }
+  return errorMessage;
+}
+
 // src/react/nodes.ts
 var reasoningLogger = createPatternLogger("agentforge:patterns:react:reasoning");
 var actionLogger = createPatternLogger("agentforge:patterns:react:action");
@@ -441,10 +482,7 @@ function createActionNode(tools, verbose = false, enableDeduplication = true) {
           executionCache.set(cacheKey, observation);
         }
       } 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);
+        const errorMessage = handleNodeError(error, `action:${action.name}`, false);
         actionLogger.error("Tool execution failed", {
           toolName: action.name,
           error: errorMessage,
@@ -683,34 +721,34 @@ function createReActAgentBuilder() {
 var import_langgraph2 = require("@langchain/langgraph");
 
 // src/plan-execute/state.ts
-var import_zod4 = require("zod");
+var import_zod5 = require("zod");
 var import_core5 = require("@agentforge/core");
 
 // src/plan-execute/schemas.ts
-var import_zod3 = require("zod");
-var PlanStepSchema = import_zod3.z.object({
+var import_zod4 = require("zod");
+var PlanStepSchema = import_zod4.z.object({
   /**
    * Unique identifier for the step
    */
-  id: import_zod3.z.string().describe("Unique identifier for the step"),
+  id: import_zod4.z.string().describe("Unique identifier for the step"),
   /**
    * Description of what this step should accomplish
    */
-  description: import_zod3.z.string().describe("Description of what this step should accomplish"),
+  description: import_zod4.z.string().describe("Description of what this step should accomplish"),
   /**
    * Optional dependencies on other steps (by ID)
    */
-  dependencies: import_zod3.z.array(import_zod3.z.string()).optional().describe("IDs of steps that must complete before this one"),
+  dependencies: import_zod4.z.array(import_zod4.z.string()).optional().describe("IDs of steps that must complete before this one"),
   /**
    * Optional tool to use for this step
    */
-  tool: import_zod3.z.string().optional().describe("Name of the tool to use for this step"),
+  tool: import_zod4.z.string().optional().describe("Name of the tool to use for this step"),
   /**
    * Optional arguments for the tool
    */
-  args: import_zod3.z.record(import_zod3.z.any()).optional().describe("Arguments to pass to the tool")
+  args: import_zod4.z.record(import_zod4.z.any()).optional().describe("Arguments to pass to the tool")
 });
-var CompletedStepSchema = import_zod3.z.object({
+var CompletedStepSchema = import_zod4.z.object({
   /**
    * The step that was executed
    */
@@ -718,53 +756,53 @@ var CompletedStepSchema = import_zod3.z.object({
   /**
    * The result of executing the step
    */
-  result: import_zod3.z.any().describe("The result of executing the step"),
+  result: import_zod4.z.any().describe("The result of executing the step"),
   /**
    * Whether the step succeeded
    */
-  success: import_zod3.z.boolean().describe("Whether the step succeeded"),
+  success: import_zod4.z.boolean().describe("Whether the step succeeded"),
   /**
    * Optional error message if the step failed
    */
-  error: import_zod3.z.string().optional().describe("Error message if the step failed"),
+  error: import_zod4.z.string().optional().describe("Error message if the step failed"),
   /**
    * Timestamp when the step was completed
    */
-  timestamp: import_zod3.z.string().datetime().describe("ISO timestamp when the step was completed")
+  timestamp: import_zod4.z.string().datetime().describe("ISO timestamp when the step was completed")
 });
-var PlanSchema = import_zod3.z.object({
+var PlanSchema = import_zod4.z.object({
   /**
    * List of steps in the plan
    */
-  steps: import_zod3.z.array(PlanStepSchema).describe("List of steps in the plan"),
+  steps: import_zod4.z.array(PlanStepSchema).describe("List of steps in the plan"),
   /**
    * Overall goal of the plan
    */
-  goal: import_zod3.z.string().describe("Overall goal of the plan"),
+  goal: import_zod4.z.string().describe("Overall goal of the plan"),
   /**
    * Timestamp when the plan was created
    */
-  createdAt: import_zod3.z.string().datetime().describe("ISO timestamp when the plan was created"),
+  createdAt: import_zod4.z.string().datetime().describe("ISO timestamp when the plan was created"),
   /**
    * Optional confidence score (0-1)
    */
-  confidence: import_zod3.z.number().min(0).max(1).optional().describe("Confidence score for the plan (0-1)")
+  confidence: import_zod4.z.number().min(0).max(1).optional().describe("Confidence score for the plan (0-1)")
 });
-var ReplanDecisionSchema = import_zod3.z.object({
+var ReplanDecisionSchema = import_zod4.z.object({
   /**
    * Whether to replan
    */
-  shouldReplan: import_zod3.z.boolean().describe("Whether to replan based on current results"),
+  shouldReplan: import_zod4.z.boolean().describe("Whether to replan based on current results"),
   /**
    * Reason for the decision
    */
-  reason: import_zod3.z.string().describe("Reason for the replan decision"),
+  reason: import_zod4.z.string().describe("Reason for the replan decision"),
   /**
    * Optional new goal if replanning
    */
-  newGoal: import_zod3.z.string().optional().describe("Updated goal if replanning")
+  newGoal: import_zod4.z.string().optional().describe("Updated goal if replanning")
 });
-var ExecutionStatusSchema = import_zod3.z.enum([
+var ExecutionStatusSchema = import_zod4.z.enum([
   "planning",
   "executing",
   "replanning",
@@ -777,11 +815,7 @@ var PlanExecuteStateConfig = {
   /**
    * Original user input/query
    */
-  input: {
-    schema: import_zod4.z.string(),
-    default: () => "",
-    description: "Original user input or query"
-  },
+  input: inputField,
   /**
    * The current plan
    */
@@ -794,7 +828,7 @@ var PlanExecuteStateConfig = {
    * Accumulates all completed steps
    */
   pastSteps: {
-    schema: import_zod4.z.array(CompletedStepSchema),
+    schema: import_zod5.z.array(CompletedStepSchema),
     reducer: (left, right) => [...left, ...right],
     default: () => [],
     description: "Completed steps with their results"
@@ -803,7 +837,7 @@ var PlanExecuteStateConfig = {
    * Index of the current step being executed
    */
   currentStepIndex: {
-    schema: import_zod4.z.number().int().nonnegative().optional(),
+    schema: import_zod5.z.number().int().nonnegative().optional(),
     description: "Index of the current step being executed"
   },
   /**
@@ -817,34 +851,19 @@ var PlanExecuteStateConfig = {
   /**
    * Final response
    */
-  response: {
-    schema: import_zod4.z.string().optional(),
-    description: "Final response after plan execution"
-  },
+  response: responseField,
   /**
    * Error message if execution failed
    */
-  error: {
-    schema: import_zod4.z.string().optional(),
-    description: "Error message if execution failed"
-  },
+  error: errorField,
   /**
    * Iteration counter for replanning
    */
-  iteration: {
-    schema: import_zod4.z.number().int().nonnegative(),
-    reducer: (left, right) => left + right,
-    default: () => 0,
-    description: "Number of planning iterations"
-  },
+  iteration: iterationField,
   /**
    * Maximum iterations allowed
    */
-  maxIterations: {
-    schema: import_zod4.z.number().int().positive(),
-    default: () => 5,
-    description: "Maximum number of planning iterations allowed"
-  }
+  maxIterations: maxIterationsField(5)
 };
 var PlanExecuteState = (0, import_core5.createStateAnnotation)(PlanExecuteStateConfig);
 
@@ -1077,11 +1096,8 @@ 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;
-        }
+        error = handleNodeError(execError, `executor:${currentStep.description}`, false);
         success = false;
-        error = execError instanceof Error ? execError.message : "Unknown execution error";
         result = null;
         executorLogger.warn("Step execution failed", {
           stepId: currentStep.id,
@@ -1284,46 +1300,46 @@ function createPlanExecuteAgent(config) {
 }
 
 // src/reflection/state.ts
-var import_zod6 = require("zod");
+var import_zod7 = require("zod");
 var import_core6 = require("@agentforge/core");
 
 // src/reflection/schemas.ts
-var import_zod5 = require("zod");
-var ReflectionSchema = import_zod5.z.object({
+var import_zod6 = require("zod");
+var ReflectionSchema = import_zod6.z.object({
   /**
    * The critique or feedback on the current response
    */
-  critique: import_zod5.z.string().describe("Critique or feedback on the current response"),
+  critique: import_zod6.z.string().describe("Critique or feedback on the current response"),
   /**
    * Specific issues identified
    */
-  issues: import_zod5.z.array(import_zod5.z.string()).describe("Specific issues or problems identified"),
+  issues: import_zod6.z.array(import_zod6.z.string()).describe("Specific issues or problems identified"),
   /**
    * Suggestions for improvement
    */
-  suggestions: import_zod5.z.array(import_zod5.z.string()).describe("Suggestions for improving the response"),
+  suggestions: import_zod6.z.array(import_zod6.z.string()).describe("Suggestions for improving the response"),
   /**
    * Quality score (0-10)
    */
-  score: import_zod5.z.number().min(0).max(10).optional().describe("Quality score from 0 to 10"),
+  score: import_zod6.z.number().min(0).max(10).optional().describe("Quality score from 0 to 10"),
   /**
    * Whether the response meets quality standards
    */
-  meetsStandards: import_zod5.z.boolean().describe("Whether the response meets quality standards"),
+  meetsStandards: import_zod6.z.boolean().describe("Whether the response meets quality standards"),
   /**
    * Timestamp of the reflection
    */
-  timestamp: import_zod5.z.date().optional().describe("When this reflection was created")
+  timestamp: import_zod6.z.date().optional().describe("When this reflection was created")
 });
-var RevisionSchema = import_zod5.z.object({
+var RevisionSchema = import_zod6.z.object({
   /**
    * The revised content
    */
-  content: import_zod5.z.string().describe("The revised content"),
+  content: import_zod6.z.string().describe("The revised content"),
   /**
    * Which iteration this revision is from
    */
-  iteration: import_zod5.z.number().int().nonnegative().describe("Iteration number"),
+  iteration: import_zod6.z.number().int().nonnegative().describe("Iteration number"),
   /**
    * The reflection that prompted this revision
    */
@@ -1331,9 +1347,9 @@ var RevisionSchema = import_zod5.z.object({
   /**
    * Timestamp of the revision
    */
-  timestamp: import_zod5.z.date().optional().describe("When this revision was created")
+  timestamp: import_zod6.z.date().optional().describe("When this revision was created")
 });
-var ReflectionStatusSchema = import_zod5.z.enum([
+var ReflectionStatusSchema = import_zod6.z.enum([
   "generating",
   // Initial generation
   "reflecting",
@@ -1345,25 +1361,25 @@ var ReflectionStatusSchema = import_zod5.z.enum([
   "failed"
   // Max iterations reached without meeting standards
 ]);
-var QualityCriteriaSchema = import_zod5.z.object({
+var QualityCriteriaSchema = import_zod6.z.object({
   /**
    * Minimum quality score required (0-10)
    */
-  minScore: import_zod5.z.number().min(0).max(10).default(7).describe("Minimum quality score required"),
+  minScore: import_zod6.z.number().min(0).max(10).default(7).describe("Minimum quality score required"),
   /**
    * Specific criteria to evaluate
    */
-  criteria: import_zod5.z.array(import_zod5.z.string()).optional().describe("Specific criteria to evaluate"),
+  criteria: import_zod6.z.array(import_zod6.z.string()).optional().describe("Specific criteria to evaluate"),
   /**
    * Whether all criteria must be met
    */
-  requireAll: import_zod5.z.boolean().default(true).describe("Whether all criteria must be met")
+  requireAll: import_zod6.z.boolean().default(true).describe("Whether all criteria must be met")
 });
-var ReflectionConfigSchema = import_zod5.z.object({
+var ReflectionConfigSchema = import_zod6.z.object({
   /**
    * Maximum number of reflection iterations
    */
-  maxIterations: import_zod5.z.number().int().positive().default(3).describe("Maximum reflection iterations"),
+  maxIterations: import_zod6.z.number().int().positive().default(3).describe("Maximum reflection iterations"),
   /**
    * Quality criteria for completion
    */
@@ -1371,7 +1387,7 @@ var ReflectionConfigSchema = import_zod5.z.object({
   /**
    * Whether to include previous reflections in context
    */
-  includeHistory: import_zod5.z.boolean().default(true).describe("Include previous reflections in context")
+  includeHistory: import_zod6.z.boolean().default(true).describe("Include previous reflections in context")
 });
 
 // src/reflection/state.ts
@@ -1379,16 +1395,12 @@ var ReflectionStateConfig = {
   /**
    * Original user input/task
    */
-  input: {
-    schema: import_zod6.z.string(),
-    default: () => "",
-    description: "Original user input or task"
-  },
+  input: inputField,
   /**
    * Current response/output
    */
   currentResponse: {
-    schema: import_zod6.z.string().optional(),
+    schema: import_zod7.z.string().optional(),
     description: "Current response or output"
   },
   /**
@@ -1396,7 +1408,7 @@ var ReflectionStateConfig = {
    * Accumulates all reflections
    */
   reflections: {
-    schema: import_zod6.z.array(ReflectionSchema),
+    schema: import_zod7.z.array(ReflectionSchema),
     reducer: (left, right) => [...left, ...right],
     default: () => [],
     description: "History of all reflections and critiques"
@@ -1406,7 +1418,7 @@ var ReflectionStateConfig = {
    * Accumulates all revisions
    */
   revisions: {
-    schema: import_zod6.z.array(RevisionSchema),
+    schema: import_zod7.z.array(RevisionSchema),
     reducer: (left, right) => [...left, ...right],
     default: () => [],
     description: "History of all revisions"
@@ -1414,12 +1426,7 @@ var ReflectionStateConfig = {
   /**
    * Current iteration number
    */
-  iteration: {
-    schema: import_zod6.z.number().int().nonnegative(),
-    reducer: (left, right) => left + right,
-    default: () => 0,
-    description: "Current iteration number"
-  },
+  iteration: iterationField,
   /**
    * Current status
    */
@@ -1438,25 +1445,15 @@ var ReflectionStateConfig = {
   /**
    * Maximum iterations allowed
    */
-  maxIterations: {
-    schema: import_zod6.z.number().int().positive(),
-    default: () => 3,
-    description: "Maximum number of reflection iterations allowed"
-  },
+  maxIterations: maxIterationsField(3),
   /**
    * Final response (when completed)
    */
-  response: {
-    schema: import_zod6.z.string().optional(),
-    description: "Final response after reflection process"
-  },
+  response: responseField,
   /**
    * Error message if failed
    */
-  error: {
-    schema: import_zod6.z.string().optional(),
-    description: "Error message if reflection failed"
-  }
+  error: errorField
 };
 var ReflectionState = (0, import_core6.createStateAnnotation)(ReflectionStateConfig);
 
@@ -1605,14 +1602,15 @@ ${lastReflection.critique}`;
         iteration: 1
       };
     } catch (error) {
+      const errorMessage = handleNodeError(error, "generator", false);
       generatorLogger.error("Response generation failed", {
         attempt: state.iteration + 1,
-        error: error instanceof Error ? error.message : String(error),
+        error: errorMessage,
         duration: Date.now() - startTime
       });
       return {
         status: "failed",
-        error: error instanceof Error ? error.message : "Unknown error in generator"
+        error: errorMessage
       };
     }
   };
@@ -1694,14 +1692,15 @@ function createReflectorNode(config) {
         status: reflection.meetsStandards ? "completed" : "revising"
       };
     } catch (error) {
+      const errorMessage = handleNodeError(error, "reflector", false);
       reflectorLogger.error("Reflection failed", {
         attempt: state.iteration,
-        error: error instanceof Error ? error.message : String(error),
+        error: errorMessage,
         duration: Date.now() - startTime
       });
       return {
         status: "failed",
-        error: error instanceof Error ? error.message : "Unknown error in reflector"
+        error: errorMessage
       };
     }
   };
@@ -1762,14 +1761,15 @@ ${revisionsText}`;
         iteration: 1
       };
     } catch (error) {
+      const errorMessage = handleNodeError(error, "reviser", false);
       reviserLogger.error("Revision failed", {
         attempt: state.iteration,
-        error: error instanceof Error ? error.message : String(error),
+        error: errorMessage,
         duration: Date.now() - startTime
       });
       return {
         status: "failed",
-        error: error instanceof Error ? error.message : "Unknown error in reviser"
+        error: errorMessage
       };
     }
   };
@@ -1855,13 +1855,13 @@ function createReflectionAgent(config) {
 }
 
 // src/multi-agent/state.ts
-var import_zod8 = require("zod");
+var import_zod9 = require("zod");
 var import_core7 = require("@agentforge/core");
 
 // src/multi-agent/schemas.ts
-var import_zod7 = require("zod");
-var AgentRoleSchema = import_zod7.z.enum(["supervisor", "worker"]);
-var MessageTypeSchema = import_zod7.z.enum([
+var import_zod8 = require("zod");
+var AgentRoleSchema = import_zod8.z.enum(["supervisor", "worker"]);
+var MessageTypeSchema = import_zod8.z.enum([
   "user_input",
   // Initial user message
   "task_assignment",
@@ -1875,11 +1875,11 @@ var MessageTypeSchema = import_zod7.z.enum([
   "completion"
   // Final completion message
 ]);
-var AgentMessageSchema = import_zod7.z.object({
+var AgentMessageSchema = import_zod8.z.object({
   /**
    * Unique identifier for the message
    */
-  id: import_zod7.z.string().describe("Unique message identifier"),
+  id: import_zod8.z.string().describe("Unique message identifier"),
   /**
    * Type of message
    */
@@ -1887,25 +1887,25 @@ var AgentMessageSchema = import_zod7.z.object({
   /**
    * Agent that sent the message
    */
-  from: import_zod7.z.string().describe("Agent identifier that sent the message"),
+  from: import_zod8.z.string().describe("Agent identifier that sent the message"),
   /**
    * Agent(s) that should receive the message
    */
-  to: import_zod7.z.union([import_zod7.z.string(), import_zod7.z.array(import_zod7.z.string())]).describe("Target agent(s)"),
+  to: import_zod8.z.union([import_zod8.z.string(), import_zod8.z.array(import_zod8.z.string())]).describe("Target agent(s)"),
   /**
    * Message content
    */
-  content: import_zod7.z.string().describe("Message content"),
+  content: import_zod8.z.string().describe("Message content"),
   /**
    * Optional metadata
    */
-  metadata: import_zod7.z.record(import_zod7.z.any()).optional().describe("Additional message metadata"),
+  metadata: import_zod8.z.record(import_zod8.z.any()).optional().describe("Additional message metadata"),
   /**
    * Timestamp when message was created
    */
-  timestamp: import_zod7.z.number().describe("Timestamp when message was created")
+  timestamp: import_zod8.z.number().describe("Timestamp when message was created")
 });
-var RoutingStrategySchema = import_zod7.z.enum([
+var RoutingStrategySchema = import_zod8.z.enum([
   "llm-based",
   // LLM decides which agent to route to
   "rule-based",
@@ -1917,25 +1917,25 @@ var RoutingStrategySchema = import_zod7.z.enum([
   "load-balanced"
   // Route based on agent workload
 ]);
-var RoutingDecisionSchema = import_zod7.z.object({
+var RoutingDecisionSchema = import_zod8.z.object({
   /**
    * Target agent to route to (single agent routing)
    * @deprecated Use targetAgents for parallel routing support
    */
-  targetAgent: import_zod7.z.string().nullable().default(null).describe("Agent to route the task to (single routing)"),
+  targetAgent: import_zod8.z.string().nullable().default(null).describe("Agent to route the task to (single routing)"),
   /**
    * Target agents to route to (parallel routing)
    * When multiple agents are specified, they execute in parallel
    */
-  targetAgents: import_zod7.z.array(import_zod7.z.string()).nullable().default(null).describe("Agents to route the task to (parallel routing)"),
+  targetAgents: import_zod8.z.array(import_zod8.z.string()).nullable().default(null).describe("Agents to route the task to (parallel routing)"),
   /**
    * Reasoning for the routing decision
    */
-  reasoning: import_zod7.z.string().default("").describe("Explanation for routing decision"),
+  reasoning: import_zod8.z.string().default("").describe("Explanation for routing decision"),
   /**
    * Confidence in the routing decision (0-1)
    */
-  confidence: import_zod7.z.number().min(0).max(1).default(0.8).describe("Confidence score"),
+  confidence: import_zod8.z.number().min(0).max(1).default(0.8).describe("Confidence score"),
   /**
    * Strategy used for routing
    */
@@ -1943,86 +1943,86 @@ var RoutingDecisionSchema = import_zod7.z.object({
   /**
    * Timestamp of the routing decision
    */
-  timestamp: import_zod7.z.number().default(() => Date.now()).describe("Timestamp of the decision")
+  timestamp: import_zod8.z.number().default(() => Date.now()).describe("Timestamp of the decision")
 }).refine(
   (data) => data.targetAgent || data.targetAgents && data.targetAgents.length > 0,
   { message: "Either targetAgent or targetAgents must be provided" }
 );
-var WorkerCapabilitiesSchema = import_zod7.z.object({
+var WorkerCapabilitiesSchema = import_zod8.z.object({
   /**
    * Skills/capabilities the agent has
    */
-  skills: import_zod7.z.array(import_zod7.z.string()).describe("List of agent skills"),
+  skills: import_zod8.z.array(import_zod8.z.string()).describe("List of agent skills"),
   /**
    * Tools available to the agent
    */
-  tools: import_zod7.z.array(import_zod7.z.string()).describe("List of tool names available to agent"),
+  tools: import_zod8.z.array(import_zod8.z.string()).describe("List of tool names available to agent"),
   /**
    * Whether the agent is currently available
    */
-  available: import_zod7.z.boolean().default(true).describe("Whether agent is available"),
+  available: import_zod8.z.boolean().default(true).describe("Whether agent is available"),
   /**
    * Current workload (number of active tasks)
    */
-  currentWorkload: import_zod7.z.number().int().nonnegative().default(0).describe("Current number of active tasks")
+  currentWorkload: import_zod8.z.number().int().nonnegative().default(0).describe("Current number of active tasks")
 });
-var TaskAssignmentSchema = import_zod7.z.object({
+var TaskAssignmentSchema = import_zod8.z.object({
   /**
    * Unique assignment identifier
    */
-  id: import_zod7.z.string().describe("Unique assignment identifier"),
+  id: import_zod8.z.string().describe("Unique assignment identifier"),
   /**
    * Worker ID assigned to the task
    */
-  workerId: import_zod7.z.string().describe("Worker identifier assigned to task"),
+  workerId: import_zod8.z.string().describe("Worker identifier assigned to task"),
   /**
    * Task description
    */
-  task: import_zod7.z.string().describe("Description of the task"),
+  task: import_zod8.z.string().describe("Description of the task"),
   /**
    * Task priority (1-10, higher is more urgent)
    */
-  priority: import_zod7.z.number().int().min(1).max(10).default(5).describe("Task priority"),
+  priority: import_zod8.z.number().int().min(1).max(10).default(5).describe("Task priority"),
   /**
    * Timestamp when task was assigned
    */
-  assignedAt: import_zod7.z.number().describe("Timestamp when task was assigned"),
+  assignedAt: import_zod8.z.number().describe("Timestamp when task was assigned"),
   /**
    * Optional deadline for task completion
    */
-  deadline: import_zod7.z.number().optional().describe("Optional task deadline timestamp")
+  deadline: import_zod8.z.number().optional().describe("Optional task deadline timestamp")
 });
-var TaskResultSchema = import_zod7.z.object({
+var TaskResultSchema = import_zod8.z.object({
   /**
    * Assignment identifier
    */
-  assignmentId: import_zod7.z.string().describe("Assignment identifier"),
+  assignmentId: import_zod8.z.string().describe("Assignment identifier"),
   /**
    * Worker that completed the task
    */
-  workerId: import_zod7.z.string().describe("Worker that completed the task"),
+  workerId: import_zod8.z.string().describe("Worker that completed the task"),
   /**
    * Whether the task succeeded
    */
-  success: import_zod7.z.boolean().describe("Whether the task succeeded"),
+  success: import_zod8.z.boolean().describe("Whether the task succeeded"),
   /**
    * Task result/output
    */
-  result: import_zod7.z.string().describe("Task result or output"),
+  result: import_zod8.z.string().describe("Task result or output"),
   /**
    * Optional error message if task failed
    */
-  error: import_zod7.z.string().optional().describe("Error message if task failed"),
+  error: import_zod8.z.string().optional().describe("Error message if task failed"),
   /**
    * Timestamp when task was completed
    */
-  completedAt: import_zod7.z.number().describe("Timestamp when task was completed"),
+  completedAt: import_zod8.z.number().describe("Timestamp when task was completed"),
   /**
    * Optional metadata about execution
    */
-  metadata: import_zod7.z.record(import_zod7.z.any()).optional().describe("Execution metadata")
+  metadata: import_zod8.z.record(import_zod8.z.any()).optional().describe("Execution metadata")
 });
-var MultiAgentStatusSchema = import_zod7.z.enum([
+var MultiAgentStatusSchema = import_zod8.z.enum([
   "initializing",
   // System is initializing
   "routing",
@@ -2038,27 +2038,27 @@ var MultiAgentStatusSchema = import_zod7.z.enum([
   "failed"
   // Task failed
 ]);
-var HandoffRequestSchema = import_zod7.z.object({
+var HandoffRequestSchema = import_zod8.z.object({
   /**
    * Agent requesting the handoff
    */
-  from: import_zod7.z.string().describe("Agent requesting handoff"),
+  from: import_zod8.z.string().describe("Agent requesting handoff"),
   /**
    * Target agent for handoff
    */
-  to: import_zod7.z.string().describe("Target agent for handoff"),
+  to: import_zod8.z.string().describe("Target agent for handoff"),
   /**
    * Reason for handoff
    */
-  reason: import_zod7.z.string().describe("Reason for requesting handoff"),
+  reason: import_zod8.z.string().describe("Reason for requesting handoff"),
   /**
    * Context to pass to next agent
    */
-  context: import_zod7.z.any().describe("Context to pass to next agent"),
+  context: import_zod8.z.any().describe("Context to pass to next agent"),
   /**
    * Timestamp of handoff request
    */
-  timestamp: import_zod7.z.string().datetime().describe("ISO timestamp of handoff request")
+  timestamp: import_zod8.z.string().datetime().describe("ISO timestamp of handoff request")
 });
 
 // src/multi-agent/state.ts
@@ -2066,17 +2066,13 @@ var MultiAgentStateConfig = {
   /**
    * Original user input/query
    */
-  input: {
-    schema: import_zod8.z.string(),
-    default: () => "",
-    description: "Original user input or query"
-  },
+  input: inputField,
   /**
    * All messages in the multi-agent conversation
    * Accumulates all messages between agents
    */
   messages: {
-    schema: import_zod8.z.array(AgentMessageSchema),
+    schema: import_zod9.z.array(AgentMessageSchema),
     reducer: (left, right) => [...left, ...right],
     default: () => [],
     description: "All messages in the multi-agent conversation"
@@ -2085,7 +2081,7 @@ var MultiAgentStateConfig = {
    * Available worker agents and their capabilities
    */
   workers: {
-    schema: import_zod8.z.record(import_zod8.z.string(), WorkerCapabilitiesSchema),
+    schema: import_zod9.z.record(import_zod9.z.string(), WorkerCapabilitiesSchema),
     reducer: (left, right) => ({
       ...left,
       ...right
@@ -2097,7 +2093,7 @@ var MultiAgentStateConfig = {
    * Current active agent
    */
   currentAgent: {
-    schema: import_zod8.z.string().optional(),
+    schema: import_zod9.z.string().optional(),
     description: "Identifier of the currently active agent"
   },
   /**
@@ -2105,7 +2101,7 @@ var MultiAgentStateConfig = {
    * Accumulates all routing decisions
    */
   routingHistory: {
-    schema: import_zod8.z.array(RoutingDecisionSchema),
+    schema: import_zod9.z.array(RoutingDecisionSchema),
     reducer: (left, right) => [...left, ...right],
     default: () => [],
     description: "History of routing decisions"
@@ -2114,7 +2110,7 @@ var MultiAgentStateConfig = {
    * Active task assignments
    */
   activeAssignments: {
-    schema: import_zod8.z.array(TaskAssignmentSchema),
+    schema: import_zod9.z.array(TaskAssignmentSchema),
     reducer: (left, right) => [...left, ...right],
     default: () => [],
     description: "Currently active task assignments"
@@ -2124,7 +2120,7 @@ var MultiAgentStateConfig = {
    * Accumulates all completed tasks
    */
   completedTasks: {
-    schema: import_zod8.z.array(TaskResultSchema),
+    schema: import_zod9.z.array(TaskResultSchema),
     reducer: (left, right) => [...left, ...right],
     default: () => [],
     description: "Completed task results"
@@ -2134,7 +2130,7 @@ var MultiAgentStateConfig = {
    * Accumulates all handoff requests
    */
   handoffs: {
-    schema: import_zod8.z.array(HandoffRequestSchema),
+    schema: import_zod9.z.array(HandoffRequestSchema),
     reducer: (left, right) => [...left, ...right],
     default: () => [],
     description: "Handoff requests between agents"
@@ -2150,34 +2146,19 @@ var MultiAgentStateConfig = {
   /**
    * Iteration counter
    */
-  iteration: {
-    schema: import_zod8.z.number().int().nonnegative(),
-    reducer: (left, right) => left + right,
-    default: () => 0,
-    description: "Current iteration number"
-  },
+  iteration: iterationField,
   /**
    * Maximum iterations allowed
    */
-  maxIterations: {
-    schema: import_zod8.z.number().int().positive(),
-    default: () => 10,
-    description: "Maximum number of iterations allowed"
-  },
+  maxIterations: maxIterationsField(10),
   /**
    * Final aggregated response
    */
-  response: {
-    schema: import_zod8.z.string().optional(),
-    description: "Final aggregated response"
-  },
+  response: responseField,
   /**
    * Error message if execution failed
    */
-  error: {
-    schema: import_zod8.z.string().optional(),
-    description: "Error message if execution failed"
-  }
+  error: errorField
 };
 var MultiAgentState = (0, import_core7.createStateAnnotation)(MultiAgentStateConfig);
 
@@ -2624,14 +2605,10 @@ function wrapReActAgent(workerId, agent, verbose = false) {
         completedTasks: [taskResult]
       };
     } catch (error) {
-      if (error && typeof error === "object" && "constructor" in error && error.constructor.name === "GraphInterrupt") {
-        logger2.debug("GraphInterrupt detected - re-throwing", { workerId });
-        throw error;
-      }
+      const errorMessage = handleNodeError(error, `react-agent:${workerId}`, false);
       logger2.error("Error in ReAct agent execution", {
         workerId,
-        error: error instanceof Error ? error.message : String(error),
-        stack: error instanceof Error ? error.stack : void 0
+        error: errorMessage
       });
       const currentAssignment = state.activeAssignments.find(
         (assignment) => assignment.workerId === workerId
@@ -2642,7 +2619,7 @@ function wrapReActAgent(workerId, agent, verbose = false) {
           workerId,
           success: false,
           result: "",
-          error: error instanceof Error ? error.message : "Unknown error in ReAct agent",
+          error: errorMessage,
           completedAt: Date.now()
         };
         return {
@@ -2653,7 +2630,7 @@ function wrapReActAgent(workerId, agent, verbose = false) {
       }
       return {
         status: "failed",
-        error: error instanceof Error ? error.message : `Unknown error in ReAct wrapper for ${workerId}`
+        error: errorMessage
       };
     }
   };
@@ -2935,14 +2912,10 @@ Execute the assigned task using your skills and tools. Provide a clear, actionab
         workers: updatedWorkers
       };
     } catch (error) {
-      if (error && typeof error === "object" && "constructor" in error && error.constructor.name === "GraphInterrupt") {
-        logger3.info("GraphInterrupt detected, re-throwing", { workerId: id });
-        throw error;
-      }
+      const errorMessage = handleNodeError(error, `worker:${id}`, false);
       logger3.error("Worker node error", {
         workerId: id,
-        error: error instanceof Error ? error.message : String(error),
-        stack: error instanceof Error ? error.stack : void 0
+        error: errorMessage
       });
       const currentAssignment = state.activeAssignments.find(
         (assignment) => assignment.workerId === id
@@ -2957,7 +2930,7 @@ Execute the assigned task using your skills and tools. Provide a clear, actionab
           workerId: id,
           success: false,
           result: "",
-          error: error instanceof Error ? error.message : "Unknown error",
+          error: errorMessage,
           completedAt: Date.now()
         };
         return {
@@ -2969,7 +2942,7 @@ Execute the assigned task using your skills and tools. Provide a clear, actionab
       logger3.error("No assignment found for error handling", { workerId: id });
       return {
         status: "failed",
-        error: error instanceof Error ? error.message : `Unknown error in worker ${id}`
+        error: errorMessage
       };
     }
   };