@agentforge/patterns 0.15.12 → 0.15.14

package/dist/index.cjs

@@ -1374,19 +1374,30 @@ function createFinisherNode() {
 }
 
 // src/plan-execute/agent.ts
+var executorRouteMap = {
+  execute: "executor",
+  replan: "replanner",
+  finish: "finisher",
+  error: import_langgraph2.END
+};
+var replannerRouteMap = {
+  replan: "planner",
+  execute: "executor",
+  error: import_langgraph2.END,
+  finish: import_langgraph2.END
+};
 function createPlanExecuteAgent(config) {
   const {
     planner,
     executor,
     replanner,
     maxIterations = 5,
-    verbose = false,
     checkpointer
   } = config;
   const plannerNode = createPlannerNode(planner);
   const executorNode = createExecutorNode(executor);
   const finisherNode = createFinisherNode();
-  const replannerNode = replanner ? createReplannerNode(replanner) : async (state) => ({ status: "executing" });
+  const replannerNode = replanner ? createReplannerNode(replanner) : async () => ({ status: "executing" });
   const workflow = new import_langgraph2.StateGraph(PlanExecuteState).addNode("planner", plannerNode).addNode("executor", executorNode).addNode("finisher", finisherNode).addNode("replanner", replannerNode);
   const routeAfterExecutor = (state) => {
     if (state.status === "failed") {
@@ -1422,24 +1433,13 @@ function createPlanExecuteAgent(config) {
   workflow.addConditionalEdges(
     "executor",
     routeAfterExecutor,
-    {
-      execute: "executor",
-      // Loop back to execute next step
-      replan: "replanner",
-      finish: "finisher",
-      error: import_langgraph2.END
-    }
+    executorRouteMap
   );
   workflow.addEdge("finisher", import_langgraph2.END);
   workflow.addConditionalEdges(
     "replanner",
     routeAfterReplanner,
-    {
-      replan: "planner",
-      execute: "executor",
-      error: import_langgraph2.END,
-      finish: import_langgraph2.END
-    }
+    replannerRouteMap
   );
   return workflow.compile(checkpointer ? { checkpointer } : void 0);
 }

package/dist/index.d.cts

@@ -1175,14 +1175,6 @@ type PlanExecuteRoute = 'execute' | 'replan' | 'finish' | 'error';
  */
 type PlanExecuteRouter = (state: PlanExecuteStateType) => PlanExecuteRoute;
 
-/**
- * Plan-and-Execute Agent Factory
- *
- * This module provides the main factory function for creating Plan-and-Execute agents.
- *
- * @module patterns/plan-execute/agent
- */
-
 /**
  * Create a Plan-and-Execute agent
  *
@@ -1242,7 +1234,190 @@ type PlanExecuteRouter = (state: PlanExecuteStateType) => PlanExecuteRoute;
  * );
  * ```
  */
-declare function createPlanExecuteAgent(config: PlanExecuteAgentConfig): any;
+declare function createPlanExecuteAgent(config: PlanExecuteAgentConfig): _langchain_langgraph.CompiledStateGraph<{
+    input: string;
+    plan: {
+        steps: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        }[];
+        goal: string;
+        createdAt: string;
+        confidence?: number | undefined;
+    } | undefined;
+    pastSteps: {
+        timestamp: string;
+        step: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        };
+        success: boolean;
+        result?: any;
+        error?: string | undefined;
+    }[];
+    currentStepIndex: number | undefined;
+    status: "failed" | "planning" | "executing" | "replanning" | "completed";
+    response: string | undefined;
+    error: string | undefined;
+    iteration: number;
+    maxIterations: number;
+}, {
+    input?: string | undefined;
+    plan?: {
+        steps: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        }[];
+        goal: string;
+        createdAt: string;
+        confidence?: number | undefined;
+    } | undefined;
+    pastSteps?: {
+        timestamp: string;
+        step: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        };
+        success: boolean;
+        result?: any;
+        error?: string | undefined;
+    }[] | undefined;
+    currentStepIndex?: number | undefined;
+    status?: "failed" | "planning" | "executing" | "replanning" | "completed" | undefined;
+    response?: string | undefined;
+    error?: string | undefined;
+    iteration?: number | undefined;
+    maxIterations?: number | undefined;
+}, "__start__" | "executor" | "replanner" | "finisher" | "planner", {
+    input: _langchain_langgraph.BaseChannel<string, string, unknown>;
+    plan: _langchain_langgraph.BaseChannel<{
+        steps: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        }[];
+        goal: string;
+        createdAt: string;
+        confidence?: number | undefined;
+    } | undefined, {
+        steps: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        }[];
+        goal: string;
+        createdAt: string;
+        confidence?: number | undefined;
+    } | undefined, unknown>;
+    pastSteps: _langchain_langgraph.BaseChannel<{
+        timestamp: string;
+        step: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        };
+        success: boolean;
+        result?: any;
+        error?: string | undefined;
+    }[], {
+        timestamp: string;
+        step: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        };
+        success: boolean;
+        result?: any;
+        error?: string | undefined;
+    }[], unknown>;
+    currentStepIndex: _langchain_langgraph.BaseChannel<number | undefined, number | undefined, unknown>;
+    status: _langchain_langgraph.BaseChannel<"failed" | "planning" | "executing" | "replanning" | "completed", "failed" | "planning" | "executing" | "replanning" | "completed", unknown>;
+    response: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    error: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    iteration: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    maxIterations: _langchain_langgraph.BaseChannel<number, number, unknown>;
+}, {
+    input: _langchain_langgraph.BaseChannel<string, string, unknown>;
+    plan: _langchain_langgraph.BaseChannel<{
+        steps: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        }[];
+        goal: string;
+        createdAt: string;
+        confidence?: number | undefined;
+    } | undefined, {
+        steps: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        }[];
+        goal: string;
+        createdAt: string;
+        confidence?: number | undefined;
+    } | undefined, unknown>;
+    pastSteps: _langchain_langgraph.BaseChannel<{
+        timestamp: string;
+        step: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        };
+        success: boolean;
+        result?: any;
+        error?: string | undefined;
+    }[], {
+        timestamp: string;
+        step: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        };
+        success: boolean;
+        result?: any;
+        error?: string | undefined;
+    }[], unknown>;
+    currentStepIndex: _langchain_langgraph.BaseChannel<number | undefined, number | undefined, unknown>;
+    status: _langchain_langgraph.BaseChannel<"failed" | "planning" | "executing" | "replanning" | "completed", "failed" | "planning" | "executing" | "replanning" | "completed", unknown>;
+    response: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    error: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    iteration: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    maxIterations: _langchain_langgraph.BaseChannel<number, number, unknown>;
+}, _langchain_langgraph.StateDefinition, {
+    planner: Partial<PlanExecuteStateType>;
+    executor: Partial<PlanExecuteStateType>;
+    finisher: Partial<PlanExecuteStateType>;
+    replanner: Partial<PlanExecuteStateType>;
+}, unknown, unknown>;
 
 /**
  * Node Implementations for Plan-and-Execute Pattern

package/dist/index.d.ts

@@ -1175,14 +1175,6 @@ type PlanExecuteRoute = 'execute' | 'replan' | 'finish' | 'error';
  */
 type PlanExecuteRouter = (state: PlanExecuteStateType) => PlanExecuteRoute;
 
-/**
- * Plan-and-Execute Agent Factory
- *
- * This module provides the main factory function for creating Plan-and-Execute agents.
- *
- * @module patterns/plan-execute/agent
- */
-
 /**
  * Create a Plan-and-Execute agent
  *
@@ -1242,7 +1234,190 @@ type PlanExecuteRouter = (state: PlanExecuteStateType) => PlanExecuteRoute;
  * );
  * ```
  */
-declare function createPlanExecuteAgent(config: PlanExecuteAgentConfig): any;
+declare function createPlanExecuteAgent(config: PlanExecuteAgentConfig): _langchain_langgraph.CompiledStateGraph<{
+    input: string;
+    plan: {
+        steps: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        }[];
+        goal: string;
+        createdAt: string;
+        confidence?: number | undefined;
+    } | undefined;
+    pastSteps: {
+        timestamp: string;
+        step: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        };
+        success: boolean;
+        result?: any;
+        error?: string | undefined;
+    }[];
+    currentStepIndex: number | undefined;
+    status: "failed" | "planning" | "executing" | "replanning" | "completed";
+    response: string | undefined;
+    error: string | undefined;
+    iteration: number;
+    maxIterations: number;
+}, {
+    input?: string | undefined;
+    plan?: {
+        steps: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        }[];
+        goal: string;
+        createdAt: string;
+        confidence?: number | undefined;
+    } | undefined;
+    pastSteps?: {
+        timestamp: string;
+        step: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        };
+        success: boolean;
+        result?: any;
+        error?: string | undefined;
+    }[] | undefined;
+    currentStepIndex?: number | undefined;
+    status?: "failed" | "planning" | "executing" | "replanning" | "completed" | undefined;
+    response?: string | undefined;
+    error?: string | undefined;
+    iteration?: number | undefined;
+    maxIterations?: number | undefined;
+}, "__start__" | "executor" | "replanner" | "finisher" | "planner", {
+    input: _langchain_langgraph.BaseChannel<string, string, unknown>;
+    plan: _langchain_langgraph.BaseChannel<{
+        steps: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        }[];
+        goal: string;
+        createdAt: string;
+        confidence?: number | undefined;
+    } | undefined, {
+        steps: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        }[];
+        goal: string;
+        createdAt: string;
+        confidence?: number | undefined;
+    } | undefined, unknown>;
+    pastSteps: _langchain_langgraph.BaseChannel<{
+        timestamp: string;
+        step: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        };
+        success: boolean;
+        result?: any;
+        error?: string | undefined;
+    }[], {
+        timestamp: string;
+        step: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        };
+        success: boolean;
+        result?: any;
+        error?: string | undefined;
+    }[], unknown>;
+    currentStepIndex: _langchain_langgraph.BaseChannel<number | undefined, number | undefined, unknown>;
+    status: _langchain_langgraph.BaseChannel<"failed" | "planning" | "executing" | "replanning" | "completed", "failed" | "planning" | "executing" | "replanning" | "completed", unknown>;
+    response: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    error: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    iteration: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    maxIterations: _langchain_langgraph.BaseChannel<number, number, unknown>;
+}, {
+    input: _langchain_langgraph.BaseChannel<string, string, unknown>;
+    plan: _langchain_langgraph.BaseChannel<{
+        steps: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        }[];
+        goal: string;
+        createdAt: string;
+        confidence?: number | undefined;
+    } | undefined, {
+        steps: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        }[];
+        goal: string;
+        createdAt: string;
+        confidence?: number | undefined;
+    } | undefined, unknown>;
+    pastSteps: _langchain_langgraph.BaseChannel<{
+        timestamp: string;
+        step: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        };
+        success: boolean;
+        result?: any;
+        error?: string | undefined;
+    }[], {
+        timestamp: string;
+        step: {
+            id: string;
+            description: string;
+            tool?: string | undefined;
+            args?: Record<string, any> | undefined;
+            dependencies?: string[] | undefined;
+        };
+        success: boolean;
+        result?: any;
+        error?: string | undefined;
+    }[], unknown>;
+    currentStepIndex: _langchain_langgraph.BaseChannel<number | undefined, number | undefined, unknown>;
+    status: _langchain_langgraph.BaseChannel<"failed" | "planning" | "executing" | "replanning" | "completed", "failed" | "planning" | "executing" | "replanning" | "completed", unknown>;
+    response: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    error: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    iteration: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    maxIterations: _langchain_langgraph.BaseChannel<number, number, unknown>;
+}, _langchain_langgraph.StateDefinition, {
+    planner: Partial<PlanExecuteStateType>;
+    executor: Partial<PlanExecuteStateType>;
+    finisher: Partial<PlanExecuteStateType>;
+    replanner: Partial<PlanExecuteStateType>;
+}, unknown, unknown>;
 
 /**
  * Node Implementations for Plan-and-Execute Pattern

package/dist/index.js

@@ -1276,19 +1276,30 @@ function createFinisherNode() {
 }
 
 // src/plan-execute/agent.ts
+var executorRouteMap = {
+  execute: "executor",
+  replan: "replanner",
+  finish: "finisher",
+  error: END2
+};
+var replannerRouteMap = {
+  replan: "planner",
+  execute: "executor",
+  error: END2,
+  finish: END2
+};
 function createPlanExecuteAgent(config) {
   const {
     planner,
     executor,
     replanner,
     maxIterations = 5,
-    verbose = false,
     checkpointer
   } = config;
   const plannerNode = createPlannerNode(planner);
   const executorNode = createExecutorNode(executor);
   const finisherNode = createFinisherNode();
-  const replannerNode = replanner ? createReplannerNode(replanner) : async (state) => ({ status: "executing" });
+  const replannerNode = replanner ? createReplannerNode(replanner) : async () => ({ status: "executing" });
   const workflow = new StateGraph2(PlanExecuteState).addNode("planner", plannerNode).addNode("executor", executorNode).addNode("finisher", finisherNode).addNode("replanner", replannerNode);
   const routeAfterExecutor = (state) => {
     if (state.status === "failed") {
@@ -1324,24 +1335,13 @@ function createPlanExecuteAgent(config) {
   workflow.addConditionalEdges(
     "executor",
     routeAfterExecutor,
-    {
-      execute: "executor",
-      // Loop back to execute next step
-      replan: "replanner",
-      finish: "finisher",
-      error: END2
-    }
+    executorRouteMap
   );
   workflow.addEdge("finisher", END2);
   workflow.addConditionalEdges(
     "replanner",
     routeAfterReplanner,
-    {
-      replan: "planner",
-      execute: "executor",
-      error: END2,
-      finish: END2
-    }
+    replannerRouteMap
   );
   return workflow.compile(checkpointer ? { checkpointer } : void 0);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentforge/patterns",
-  "version": "0.15.12",
+  "version": "0.15.14",
   "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.12",
+    "@agentforge/core": "0.15.14",
     "@langchain/core": "^1.1.17",
     "@langchain/langgraph": "^1.1.2",
     "zod": "^3.23.8"
   },
   "devDependencies": {
-    "@agentforge/testing": "0.15.12",
+    "@agentforge/testing": "0.15.14",
     "@eslint/js": "^9.17.0",
     "@types/node": "^22.10.2",
     "eslint": "^9.17.0",