@agentforge/patterns 0.16.5 → 0.16.6

package/dist/index.cjs

@@ -1953,6 +1953,20 @@ function createFinisherNode2() {
 
 // src/reflection/agent.ts
 var import_langgraph3 = require("@langchain/langgraph");
+var generatorRouteMap = {
+  reflect: "reflector",
+  error: import_langgraph3.END
+};
+var reflectorRouteMap = {
+  revise: "reviser",
+  finish: "finisher",
+  error: import_langgraph3.END
+};
+var reviserRouteMap = {
+  reflect: "reflector",
+  finish: "finisher",
+  error: import_langgraph3.END
+};
 function createReflectionAgent(config) {
   const {
     generator,
@@ -1998,26 +2012,15 @@ function createReflectionAgent(config) {
   workflow.addEdge("__start__", "generator").addConditionalEdges(
     "generator",
     routeAfterGenerator,
-    {
-      reflect: "reflector",
-      error: import_langgraph3.END
-    }
+    generatorRouteMap
   ).addConditionalEdges(
     "reflector",
     routeAfterReflector,
-    {
-      revise: "reviser",
-      finish: "finisher",
-      error: import_langgraph3.END
-    }
+    reflectorRouteMap
   ).addConditionalEdges(
     "reviser",
     routeAfterReviser,
-    {
-      reflect: "reflector",
-      finish: "finisher",
-      error: import_langgraph3.END
-    }
+    reviserRouteMap
   ).addEdge("finisher", import_langgraph3.END);
   return workflow.compile(checkpointer ? { checkpointer } : void 0);
 }

package/dist/index.d.cts

@@ -2168,14 +2168,6 @@ declare function createReviserNode(config: ReviserConfig): (state: ReflectionSta
  */
 declare function createFinisherNode(): (state: ReflectionStateType) => Promise<Partial<ReflectionStateType>>;
 
-/**
- * Reflection Agent Factory
- *
- * Creates a Reflection agent using LangGraph.
- *
- * @module patterns/reflection/agent
- */
-
 /**
  * Create a Reflection agent
  *
@@ -2235,7 +2227,194 @@ declare function createFinisherNode(): (state: ReflectionStateType) => Promise<P
  * );
  * ```
  */
-declare function createReflectionAgent(config: ReflectionAgentConfig): any;
+declare function createReflectionAgent(config: ReflectionAgentConfig): _langchain_langgraph.CompiledStateGraph<{
+    input: string;
+    currentResponse: string | undefined;
+    reflections: {
+        issues: string[];
+        critique: string;
+        suggestions: string[];
+        meetsStandards: boolean;
+        timestamp?: Date | undefined;
+        score?: number | undefined;
+    }[];
+    revisions: {
+        content: string;
+        iteration: number;
+        timestamp?: Date | undefined;
+        basedOn?: {
+            issues: string[];
+            critique: string;
+            suggestions: string[];
+            meetsStandards: boolean;
+            timestamp?: Date | undefined;
+            score?: number | undefined;
+        } | undefined;
+    }[];
+    iteration: number;
+    status: "failed" | "completed" | "generating" | "reflecting" | "revising";
+    qualityCriteria: {
+        minScore: number;
+        requireAll: boolean;
+        criteria?: string[] | undefined;
+    } | undefined;
+    maxIterations: number;
+    response: string | undefined;
+    error: string | undefined;
+}, {
+    input?: string | undefined;
+    currentResponse?: string | undefined;
+    reflections?: {
+        issues: string[];
+        critique: string;
+        suggestions: string[];
+        meetsStandards: boolean;
+        timestamp?: Date | undefined;
+        score?: number | undefined;
+    }[] | undefined;
+    revisions?: {
+        content: string;
+        iteration: number;
+        timestamp?: Date | undefined;
+        basedOn?: {
+            issues: string[];
+            critique: string;
+            suggestions: string[];
+            meetsStandards: boolean;
+            timestamp?: Date | undefined;
+            score?: number | undefined;
+        } | undefined;
+    }[] | undefined;
+    iteration?: number | undefined;
+    status?: "failed" | "completed" | "generating" | "reflecting" | "revising" | undefined;
+    qualityCriteria?: {
+        minScore: number;
+        requireAll: boolean;
+        criteria?: string[] | undefined;
+    } | undefined;
+    maxIterations?: number | undefined;
+    response?: string | undefined;
+    error?: string | undefined;
+}, "__start__" | "finisher" | "generator" | "reflector" | "reviser", {
+    input: _langchain_langgraph.BaseChannel<string, string, unknown>;
+    currentResponse: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    reflections: _langchain_langgraph.BaseChannel<{
+        issues: string[];
+        critique: string;
+        suggestions: string[];
+        meetsStandards: boolean;
+        timestamp?: Date | undefined;
+        score?: number | undefined;
+    }[], {
+        issues: string[];
+        critique: string;
+        suggestions: string[];
+        meetsStandards: boolean;
+        timestamp?: Date | undefined;
+        score?: number | undefined;
+    }[], unknown>;
+    revisions: _langchain_langgraph.BaseChannel<{
+        content: string;
+        iteration: number;
+        timestamp?: Date | undefined;
+        basedOn?: {
+            issues: string[];
+            critique: string;
+            suggestions: string[];
+            meetsStandards: boolean;
+            timestamp?: Date | undefined;
+            score?: number | undefined;
+        } | undefined;
+    }[], {
+        content: string;
+        iteration: number;
+        timestamp?: Date | undefined;
+        basedOn?: {
+            issues: string[];
+            critique: string;
+            suggestions: string[];
+            meetsStandards: boolean;
+            timestamp?: Date | undefined;
+            score?: number | undefined;
+        } | undefined;
+    }[], unknown>;
+    iteration: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    status: _langchain_langgraph.BaseChannel<"failed" | "completed" | "generating" | "reflecting" | "revising", "failed" | "completed" | "generating" | "reflecting" | "revising", unknown>;
+    qualityCriteria: _langchain_langgraph.BaseChannel<{
+        minScore: number;
+        requireAll: boolean;
+        criteria?: string[] | undefined;
+    } | undefined, {
+        minScore: number;
+        requireAll: boolean;
+        criteria?: string[] | undefined;
+    } | undefined, unknown>;
+    maxIterations: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    response: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    error: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+}, {
+    input: _langchain_langgraph.BaseChannel<string, string, unknown>;
+    currentResponse: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    reflections: _langchain_langgraph.BaseChannel<{
+        issues: string[];
+        critique: string;
+        suggestions: string[];
+        meetsStandards: boolean;
+        timestamp?: Date | undefined;
+        score?: number | undefined;
+    }[], {
+        issues: string[];
+        critique: string;
+        suggestions: string[];
+        meetsStandards: boolean;
+        timestamp?: Date | undefined;
+        score?: number | undefined;
+    }[], unknown>;
+    revisions: _langchain_langgraph.BaseChannel<{
+        content: string;
+        iteration: number;
+        timestamp?: Date | undefined;
+        basedOn?: {
+            issues: string[];
+            critique: string;
+            suggestions: string[];
+            meetsStandards: boolean;
+            timestamp?: Date | undefined;
+            score?: number | undefined;
+        } | undefined;
+    }[], {
+        content: string;
+        iteration: number;
+        timestamp?: Date | undefined;
+        basedOn?: {
+            issues: string[];
+            critique: string;
+            suggestions: string[];
+            meetsStandards: boolean;
+            timestamp?: Date | undefined;
+            score?: number | undefined;
+        } | undefined;
+    }[], unknown>;
+    iteration: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    status: _langchain_langgraph.BaseChannel<"failed" | "completed" | "generating" | "reflecting" | "revising", "failed" | "completed" | "generating" | "reflecting" | "revising", unknown>;
+    qualityCriteria: _langchain_langgraph.BaseChannel<{
+        minScore: number;
+        requireAll: boolean;
+        criteria?: string[] | undefined;
+    } | undefined, {
+        minScore: number;
+        requireAll: boolean;
+        criteria?: string[] | undefined;
+    } | undefined, unknown>;
+    maxIterations: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    response: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    error: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+}, _langchain_langgraph.StateDefinition, {
+    generator: Partial<ReflectionStateType>;
+    reflector: Partial<ReflectionStateType>;
+    reviser: Partial<ReflectionStateType>;
+    finisher: Partial<ReflectionStateType>;
+}, unknown, unknown>;
 
 /**
  * Zod Schemas for Multi-Agent Coordination Pattern

package/dist/index.d.ts

@@ -2168,14 +2168,6 @@ declare function createReviserNode(config: ReviserConfig): (state: ReflectionSta
  */
 declare function createFinisherNode(): (state: ReflectionStateType) => Promise<Partial<ReflectionStateType>>;
 
-/**
- * Reflection Agent Factory
- *
- * Creates a Reflection agent using LangGraph.
- *
- * @module patterns/reflection/agent
- */
-
 /**
  * Create a Reflection agent
  *
@@ -2235,7 +2227,194 @@ declare function createFinisherNode(): (state: ReflectionStateType) => Promise<P
  * );
  * ```
  */
-declare function createReflectionAgent(config: ReflectionAgentConfig): any;
+declare function createReflectionAgent(config: ReflectionAgentConfig): _langchain_langgraph.CompiledStateGraph<{
+    input: string;
+    currentResponse: string | undefined;
+    reflections: {
+        issues: string[];
+        critique: string;
+        suggestions: string[];
+        meetsStandards: boolean;
+        timestamp?: Date | undefined;
+        score?: number | undefined;
+    }[];
+    revisions: {
+        content: string;
+        iteration: number;
+        timestamp?: Date | undefined;
+        basedOn?: {
+            issues: string[];
+            critique: string;
+            suggestions: string[];
+            meetsStandards: boolean;
+            timestamp?: Date | undefined;
+            score?: number | undefined;
+        } | undefined;
+    }[];
+    iteration: number;
+    status: "failed" | "completed" | "generating" | "reflecting" | "revising";
+    qualityCriteria: {
+        minScore: number;
+        requireAll: boolean;
+        criteria?: string[] | undefined;
+    } | undefined;
+    maxIterations: number;
+    response: string | undefined;
+    error: string | undefined;
+}, {
+    input?: string | undefined;
+    currentResponse?: string | undefined;
+    reflections?: {
+        issues: string[];
+        critique: string;
+        suggestions: string[];
+        meetsStandards: boolean;
+        timestamp?: Date | undefined;
+        score?: number | undefined;
+    }[] | undefined;
+    revisions?: {
+        content: string;
+        iteration: number;
+        timestamp?: Date | undefined;
+        basedOn?: {
+            issues: string[];
+            critique: string;
+            suggestions: string[];
+            meetsStandards: boolean;
+            timestamp?: Date | undefined;
+            score?: number | undefined;
+        } | undefined;
+    }[] | undefined;
+    iteration?: number | undefined;
+    status?: "failed" | "completed" | "generating" | "reflecting" | "revising" | undefined;
+    qualityCriteria?: {
+        minScore: number;
+        requireAll: boolean;
+        criteria?: string[] | undefined;
+    } | undefined;
+    maxIterations?: number | undefined;
+    response?: string | undefined;
+    error?: string | undefined;
+}, "__start__" | "finisher" | "generator" | "reflector" | "reviser", {
+    input: _langchain_langgraph.BaseChannel<string, string, unknown>;
+    currentResponse: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    reflections: _langchain_langgraph.BaseChannel<{
+        issues: string[];
+        critique: string;
+        suggestions: string[];
+        meetsStandards: boolean;
+        timestamp?: Date | undefined;
+        score?: number | undefined;
+    }[], {
+        issues: string[];
+        critique: string;
+        suggestions: string[];
+        meetsStandards: boolean;
+        timestamp?: Date | undefined;
+        score?: number | undefined;
+    }[], unknown>;
+    revisions: _langchain_langgraph.BaseChannel<{
+        content: string;
+        iteration: number;
+        timestamp?: Date | undefined;
+        basedOn?: {
+            issues: string[];
+            critique: string;
+            suggestions: string[];
+            meetsStandards: boolean;
+            timestamp?: Date | undefined;
+            score?: number | undefined;
+        } | undefined;
+    }[], {
+        content: string;
+        iteration: number;
+        timestamp?: Date | undefined;
+        basedOn?: {
+            issues: string[];
+            critique: string;
+            suggestions: string[];
+            meetsStandards: boolean;
+            timestamp?: Date | undefined;
+            score?: number | undefined;
+        } | undefined;
+    }[], unknown>;
+    iteration: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    status: _langchain_langgraph.BaseChannel<"failed" | "completed" | "generating" | "reflecting" | "revising", "failed" | "completed" | "generating" | "reflecting" | "revising", unknown>;
+    qualityCriteria: _langchain_langgraph.BaseChannel<{
+        minScore: number;
+        requireAll: boolean;
+        criteria?: string[] | undefined;
+    } | undefined, {
+        minScore: number;
+        requireAll: boolean;
+        criteria?: string[] | undefined;
+    } | undefined, unknown>;
+    maxIterations: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    response: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    error: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+}, {
+    input: _langchain_langgraph.BaseChannel<string, string, unknown>;
+    currentResponse: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    reflections: _langchain_langgraph.BaseChannel<{
+        issues: string[];
+        critique: string;
+        suggestions: string[];
+        meetsStandards: boolean;
+        timestamp?: Date | undefined;
+        score?: number | undefined;
+    }[], {
+        issues: string[];
+        critique: string;
+        suggestions: string[];
+        meetsStandards: boolean;
+        timestamp?: Date | undefined;
+        score?: number | undefined;
+    }[], unknown>;
+    revisions: _langchain_langgraph.BaseChannel<{
+        content: string;
+        iteration: number;
+        timestamp?: Date | undefined;
+        basedOn?: {
+            issues: string[];
+            critique: string;
+            suggestions: string[];
+            meetsStandards: boolean;
+            timestamp?: Date | undefined;
+            score?: number | undefined;
+        } | undefined;
+    }[], {
+        content: string;
+        iteration: number;
+        timestamp?: Date | undefined;
+        basedOn?: {
+            issues: string[];
+            critique: string;
+            suggestions: string[];
+            meetsStandards: boolean;
+            timestamp?: Date | undefined;
+            score?: number | undefined;
+        } | undefined;
+    }[], unknown>;
+    iteration: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    status: _langchain_langgraph.BaseChannel<"failed" | "completed" | "generating" | "reflecting" | "revising", "failed" | "completed" | "generating" | "reflecting" | "revising", unknown>;
+    qualityCriteria: _langchain_langgraph.BaseChannel<{
+        minScore: number;
+        requireAll: boolean;
+        criteria?: string[] | undefined;
+    } | undefined, {
+        minScore: number;
+        requireAll: boolean;
+        criteria?: string[] | undefined;
+    } | undefined, unknown>;
+    maxIterations: _langchain_langgraph.BaseChannel<number, number, unknown>;
+    response: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+    error: _langchain_langgraph.BaseChannel<string | undefined, string | undefined, unknown>;
+}, _langchain_langgraph.StateDefinition, {
+    generator: Partial<ReflectionStateType>;
+    reflector: Partial<ReflectionStateType>;
+    reviser: Partial<ReflectionStateType>;
+    finisher: Partial<ReflectionStateType>;
+}, unknown, unknown>;
 
 /**
  * Zod Schemas for Multi-Agent Coordination Pattern

package/dist/index.js

@@ -1855,6 +1855,20 @@ function createFinisherNode2() {
 
 // src/reflection/agent.ts
 import { StateGraph as StateGraph3, END as END3 } from "@langchain/langgraph";
+var generatorRouteMap = {
+  reflect: "reflector",
+  error: END3
+};
+var reflectorRouteMap = {
+  revise: "reviser",
+  finish: "finisher",
+  error: END3
+};
+var reviserRouteMap = {
+  reflect: "reflector",
+  finish: "finisher",
+  error: END3
+};
 function createReflectionAgent(config) {
   const {
     generator,
@@ -1900,26 +1914,15 @@ function createReflectionAgent(config) {
   workflow.addEdge("__start__", "generator").addConditionalEdges(
     "generator",
     routeAfterGenerator,
-    {
-      reflect: "reflector",
-      error: END3
-    }
+    generatorRouteMap
   ).addConditionalEdges(
     "reflector",
     routeAfterReflector,
-    {
-      revise: "reviser",
-      finish: "finisher",
-      error: END3
-    }
+    reflectorRouteMap
   ).addConditionalEdges(
     "reviser",
     routeAfterReviser,
-    {
-      reflect: "reflector",
-      finish: "finisher",
-      error: END3
-    }
+    reviserRouteMap
   ).addEdge("finisher", END3);
   return workflow.compile(checkpointer ? { checkpointer } : void 0);
 }

package/package.json

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