@agentforge/patterns 0.16.22 → 0.16.24

package/README.md

@@ -6,13 +6,13 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue)](https://www.typescriptlang.org/)
 [![License](https://img.shields.io/badge/license-MIT-green)](../../LICENSE)
 
-## 🎉 Status: Production Ready & Published
+## Status: Production Ready & Published
 
 **All 4 patterns complete** | **143 tests passing** | **Full TypeScript support** | **Comprehensive documentation**
 
-## 🤖 Agent Patterns
+## Agent Patterns
 
-### ✅ ReAct Pattern (Reasoning and Action)
+### ReAct Pattern (Reasoning and Action)
 
 The ReAct pattern implements a thought-action-observation loop for exploratory tasks:
 
@@ -30,7 +30,7 @@ The ReAct pattern implements a thought-action-observation loop for exploratory t
 - Comprehensive error handling
 - **55 tests** - Full coverage
 
-### ✅ Plan-Execute Pattern
+### Plan-Execute Pattern
 
 The Plan-Execute pattern separates planning from execution for complex, structured tasks:
 
@@ -49,7 +49,7 @@ The Plan-Execute pattern separates planning from execution for complex, structur
 - Progress tracking
 - **35+ tests** - Comprehensive coverage
 
-### ✅ Reflection Pattern
+### Reflection Pattern
 
 The Reflection pattern implements iterative self-improvement through critique and revision:
 
@@ -68,7 +68,7 @@ The Reflection pattern implements iterative self-improvement through critique an
 - Configurable iteration limits
 - **30+ tests** - Full coverage
 
-### ✅ Multi-Agent Pattern
+### Multi-Agent Pattern
 
 The Multi-Agent pattern coordinates multiple specialized agents for complex tasks:
 
@@ -284,19 +284,19 @@ console.log(result.response); // Aggregated response
 
 ## Documentation
 
-### 📖 Pattern Guides (GitHub Pages)
-- 🤖 **[ReAct Pattern Guide](https://tvscoundrel.github.io/agentforge/guide/patterns/react)** - Comprehensive ReAct usage guide
-- 📋 **[Plan-Execute Pattern Guide](https://tvscoundrel.github.io/agentforge/guide/patterns/plan-execute)** - Comprehensive Plan-Execute guide
-- 🔄 **[Reflection Pattern Guide](https://tvscoundrel.github.io/agentforge/guide/patterns/reflection)** - Comprehensive Reflection guide
-- 👥 **[Multi-Agent Pattern Guide](https://tvscoundrel.github.io/agentforge/guide/patterns/multi-agent)** - Comprehensive Multi-Agent guide
+### Pattern Guides (GitHub Pages)
+- **[ReAct Pattern Guide](https://tvscoundrel.github.io/agentforge/guide/patterns/react)** - Comprehensive ReAct usage guide
+- **[Plan-Execute Pattern Guide](https://tvscoundrel.github.io/agentforge/guide/patterns/plan-execute)** - Comprehensive Plan-Execute guide
+- **[Reflection Pattern Guide](https://tvscoundrel.github.io/agentforge/guide/patterns/reflection)** - Comprehensive Reflection guide
+- **[Multi-Agent Pattern Guide](https://tvscoundrel.github.io/agentforge/guide/patterns/multi-agent)** - Comprehensive Multi-Agent guide
 
-### 💡 Examples (GitHub Pages)
+### Examples (GitHub Pages)
 - **[ReAct Examples](https://tvscoundrel.github.io/agentforge/examples/react-agent)** - ReAct pattern examples
 - **[Plan-Execute Examples](https://tvscoundrel.github.io/agentforge/examples/plan-execute)** - Plan-Execute pattern examples
 - **[Reflection Examples](https://tvscoundrel.github.io/agentforge/examples/reflection)** - Reflection pattern examples
 - **[Multi-Agent Examples](https://tvscoundrel.github.io/agentforge/examples/multi-agent)** - Multi-Agent pattern examples
 
-### 📂 Source Documentation
+### Source Documentation
 For contributors and advanced users, detailed implementation docs are available in the repository:
 - [Pattern Comparison](./docs/pattern-comparison.md) - Detailed pattern comparison
 - [ReAct Implementation](./docs/react-pattern.md) - ReAct implementation details
@@ -499,17 +499,17 @@ import {
 | **Reflection** | Quality-critical outputs | Iterative improvement | Slow, expensive |
 | **Multi-Agent** | Specialized tasks | Coordinated expertise | High complexity |
 
-📚 **[Pattern Comparison Guide](https://tvscoundrel.github.io/agentforge/guide/patterns/comparison)** - Detailed guidance on choosing the right pattern
+- **[Pattern Comparison Guide](https://tvscoundrel.github.io/agentforge/guide/patterns/comparison)** - Detailed guidance on choosing the right pattern
 
 ## Documentation
 
-- 📖 **[Full Documentation](https://tvscoundrel.github.io/agentforge/)**
-- 🚀 **[Quick Start](https://tvscoundrel.github.io/agentforge/guide/quick-start)**
-- 🤖 **[ReAct Pattern Guide](https://tvscoundrel.github.io/agentforge/guide/patterns/react)**
-- 📋 **[Plan-Execute Pattern Guide](https://tvscoundrel.github.io/agentforge/guide/patterns/plan-execute)**
-- 🔄 **[Reflection Pattern Guide](https://tvscoundrel.github.io/agentforge/guide/patterns/reflection)**
-- 👥 **[Multi-Agent Pattern Guide](https://tvscoundrel.github.io/agentforge/guide/patterns/multi-agent)**
-- 💡 **[Examples](https://tvscoundrel.github.io/agentforge/examples/react-agent)**
+- **[Full Documentation](https://tvscoundrel.github.io/agentforge/)**
+- **[Quick Start](https://tvscoundrel.github.io/agentforge/guide/quick-start)**
+- **[ReAct Pattern Guide](https://tvscoundrel.github.io/agentforge/guide/patterns/react)**
+- **[Plan-Execute Pattern Guide](https://tvscoundrel.github.io/agentforge/guide/patterns/plan-execute)**
+- **[Reflection Pattern Guide](https://tvscoundrel.github.io/agentforge/guide/patterns/reflection)**
+- **[Multi-Agent Pattern Guide](https://tvscoundrel.github.io/agentforge/guide/patterns/multi-agent)**
+- **[Examples](https://tvscoundrel.github.io/agentforge/examples/react-agent)**
 
 ## Development
 
@@ -530,7 +530,7 @@ pnpm test:coverage
 pnpm typecheck
 ```
 
-## 🔗 Links
+## Links
 
 - [GitHub Repository](https://github.com/TVScoundrel/agentforge)
 - [npm Package](https://www.npmjs.com/package/@agentforge/patterns)

package/dist/index.d.cts

@@ -206,6 +206,11 @@ type ReActStateType = typeof ReActState.State;
  * @module langgraph/patterns/react/types
  */
 
+type ReActTool = Tool<unknown, unknown>;
+type ReActToolInput = Omit<ReActTool, 'invoke' | 'execute'> & Pick<Tool<never, unknown>, 'invoke' | 'execute'>;
+type ReActToolSource = ToolRegistry | ReActToolInput[];
+type ReActCheckpointer = BaseCheckpointSaver | true;
+type ReActAgentGraph = CompiledStateGraph<ReActStateType, unknown>;
 /**
  * Configuration for creating a ReAct agent
  */
@@ -218,7 +223,7 @@ interface ReActAgentConfig {
      * Tools available to the agent
      * Can be a ToolRegistry or an array of Tools
      */
-    tools: ToolRegistry | Tool<any, any>[];
+    tools: ReActToolSource;
     /**
      * System prompt for the agent
      * @default "You are a helpful assistant that uses tools to solve problems."
@@ -270,7 +275,7 @@ interface ReActAgentConfig {
      * });
      * ```
      */
-    checkpointer?: BaseCheckpointSaver | true;
+    checkpointer?: ReActCheckpointer;
     /**
      * Enable tool call deduplication to prevent calling the same tool with identical parameters multiple times
      * @default true
@@ -309,6 +314,7 @@ type StopConditionFn = (state: ReActStateType) => boolean;
  *
  * @module langgraph/patterns/react/prompts
  */
+
 /**
  * Default system prompt for ReAct agents
  */
@@ -399,7 +405,7 @@ declare const DEFAULT_REACT_SYSTEM_PROMPT = "You are a helpful assistant that us
  * // Format: {parent_thread_id}:worker:hr
  * ```
  */
-declare function createReActAgent(config: ReActAgentConfig, options?: ReActBuilderOptions): CompiledStateGraph<any, any>;
+declare function createReActAgent(config: ReActAgentConfig, options?: ReActBuilderOptions): ReActAgentGraph;
 
 /**
  * ReAct Agent Builder
@@ -442,7 +448,7 @@ declare class ReActAgentBuilder {
      *
      * @param tools - Tool registry or array of tools
      */
-    withTools(tools: ToolRegistry | Tool<any, any>[]): this;
+    withTools(tools: ReActToolSource): this;
     /**
      * Set the system prompt (optional)
      *
@@ -516,14 +522,14 @@ declare class ReActAgentBuilder {
      *   .build();
      * ```
      */
-    withCheckpointer(checkpointer: any): this;
+    withCheckpointer(checkpointer: ReActCheckpointer): this;
     /**
      * Build the ReAct agent
      *
      * @returns A compiled LangGraph StateGraph
      * @throws Error if required configuration is missing
      */
-    build(): CompiledStateGraph<any, any>;
+    build(): ReActAgentGraph;
 }
 /**
  * Create a new ReAct agent builder

package/dist/index.d.ts

@@ -206,6 +206,11 @@ type ReActStateType = typeof ReActState.State;
  * @module langgraph/patterns/react/types
  */
 
+type ReActTool = Tool<unknown, unknown>;
+type ReActToolInput = Omit<ReActTool, 'invoke' | 'execute'> & Pick<Tool<never, unknown>, 'invoke' | 'execute'>;
+type ReActToolSource = ToolRegistry | ReActToolInput[];
+type ReActCheckpointer = BaseCheckpointSaver | true;
+type ReActAgentGraph = CompiledStateGraph<ReActStateType, unknown>;
 /**
  * Configuration for creating a ReAct agent
  */
@@ -218,7 +223,7 @@ interface ReActAgentConfig {
      * Tools available to the agent
      * Can be a ToolRegistry or an array of Tools
      */
-    tools: ToolRegistry | Tool<any, any>[];
+    tools: ReActToolSource;
     /**
      * System prompt for the agent
      * @default "You are a helpful assistant that uses tools to solve problems."
@@ -270,7 +275,7 @@ interface ReActAgentConfig {
      * });
      * ```
      */
-    checkpointer?: BaseCheckpointSaver | true;
+    checkpointer?: ReActCheckpointer;
     /**
      * Enable tool call deduplication to prevent calling the same tool with identical parameters multiple times
      * @default true
@@ -309,6 +314,7 @@ type StopConditionFn = (state: ReActStateType) => boolean;
  *
  * @module langgraph/patterns/react/prompts
  */
+
 /**
  * Default system prompt for ReAct agents
  */
@@ -399,7 +405,7 @@ declare const DEFAULT_REACT_SYSTEM_PROMPT = "You are a helpful assistant that us
  * // Format: {parent_thread_id}:worker:hr
  * ```
  */
-declare function createReActAgent(config: ReActAgentConfig, options?: ReActBuilderOptions): CompiledStateGraph<any, any>;
+declare function createReActAgent(config: ReActAgentConfig, options?: ReActBuilderOptions): ReActAgentGraph;
 
 /**
  * ReAct Agent Builder
@@ -442,7 +448,7 @@ declare class ReActAgentBuilder {
      *
      * @param tools - Tool registry or array of tools
      */
-    withTools(tools: ToolRegistry | Tool<any, any>[]): this;
+    withTools(tools: ReActToolSource): this;
     /**
      * Set the system prompt (optional)
      *
@@ -516,14 +522,14 @@ declare class ReActAgentBuilder {
      *   .build();
      * ```
      */
-    withCheckpointer(checkpointer: any): this;
+    withCheckpointer(checkpointer: ReActCheckpointer): this;
     /**
      * Build the ReAct agent
      *
      * @returns A compiled LangGraph StateGraph
      * @throws Error if required configuration is missing
      */
-    build(): CompiledStateGraph<any, any>;
+    build(): ReActAgentGraph;
 }
 /**
  * Create a new ReAct agent builder

package/package.json

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