@agentforge/patterns 0.12.0 → 0.12.1

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 Tom Van Schoor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -156,7 +156,8 @@ const searchTool = {
   name: 'search',
   description: 'Search for information',
   schema: z.object({ query: z.string() }),
-  execute: async ({ query }) => {
+  metadata: { category: 'search' },
+  invoke: async ({ query }) => {
     // Search implementation
     return { results: [...] };
   },
@@ -166,7 +167,8 @@ const analyzeTool = {
   name: 'analyze',
   description: 'Analyze data',
   schema: z.object({ data: z.any() }),
-  execute: async ({ data }) => {
+  metadata: { category: 'utility' },
+  invoke: async ({ data }) => {
     // Analysis implementation
     return { insights: [...] };
   },
@@ -175,7 +177,7 @@ const analyzeTool = {
 // Create the agent
 const agent = createPlanExecuteAgent({
   planner: {
-    llm: new ChatOpenAI({ model: 'gpt-4' }),
+    model: new ChatOpenAI({ model: 'gpt-4' }),
     maxSteps: 5,
   },
   executor: {
@@ -183,7 +185,7 @@ const agent = createPlanExecuteAgent({
     parallel: true, // Enable parallel execution
   },
   replanner: {
-    llm: new ChatOpenAI({ model: 'gpt-4' }),
+    model: new ChatOpenAI({ model: 'gpt-4' }),
     replanThreshold: 0.7, // Replan if confidence < 0.7
   },
 });
@@ -209,20 +211,24 @@ import { ChatOpenAI } from '@langchain/openai';
 // Create the agent
 const agent = createReflectionAgent({
   generator: {
-    llm: new ChatOpenAI({ model: 'gpt-4' }),
+    model: new ChatOpenAI({ model: 'gpt-4' }),
     systemPrompt: 'You are a professional writer. Create high-quality content.',
   },
   reflector: {
-    llm: new ChatOpenAI({ model: 'gpt-4' }),
+    model: new ChatOpenAI({ model: 'gpt-4' }),
     systemPrompt: 'Critique the content for clarity, engagement, and professionalism.',
   },
+  reviser: {
+    model: new ChatOpenAI({ model: 'gpt-4' }),
+    systemPrompt: 'Revise the content based on the critique.',
+  },
   maxIterations: 3,
   verbose: true,
 });
 
 // Use the agent
 const result = await agent.invoke({
-  messages: [{ role: 'user', content: 'Write a blog post about AI' }],
+  input: 'Write a blog post about AI',
 });
 
 console.log(result.reflections); // All critiques
@@ -237,41 +243,31 @@ Coordinate specialized agents:
 import { MultiAgentSystemBuilder } from '@agentforge/patterns';
 import { ChatOpenAI } from '@langchain/openai';
 
-const llm = new ChatOpenAI({ model: 'gpt-4' });
+const model = new ChatOpenAI({ model: 'gpt-4' });
 
 // Create builder
 const builder = new MultiAgentSystemBuilder({
   supervisor: {
-    llm,
+    model,
     strategy: 'skill-based', // or 'llm-based', 'round-robin', etc.
   },
-  aggregator: { llm },
+  aggregator: { model },
 });
 
 // Register specialized workers
 builder.registerWorkers([
   {
-    id: 'tech_support',
-    name: 'Tech Support',
+    name: 'tech_support',
     description: 'Handles technical issues',
-    capabilities: {
-      skills: ['technical', 'troubleshooting', 'debugging'],
-      tools: ['diagnostic', 'troubleshoot'],
-      available: true,
-    },
-    llm,
+    capabilities: ['technical', 'troubleshooting', 'debugging'],
+    model,
     tools: [diagnosticTool, troubleshootTool],
   },
   {
-    id: 'billing_support',
-    name: 'Billing Support',
+    name: 'billing_support',
     description: 'Handles billing inquiries',
-    capabilities: {
-      skills: ['billing', 'payments', 'refunds'],
-      tools: ['account_check', 'refund_process'],
-      available: true,
-    },
-    llm,
+    capabilities: ['billing', 'payments', 'refunds'],
+    model,
     tools: [checkAccountTool, processRefundTool],
   },
 ]);
@@ -350,25 +346,23 @@ import {
 ```typescript
 {
   planner: {
-    llm: BaseChatModel,           // LLM for planning
+    model: BaseChatModel,          // LLM for planning
     systemPrompt?: string,         // Custom planning prompt
-    maxSteps?: number,             // Max steps in plan (default: 10)
+    maxSteps?: number,             // Max steps in plan (default: 7)
     includeToolDescriptions?: boolean,
   },
   executor: {
     tools: Tool[],                 // Available tools
-    llm?: BaseChatModel,           // Optional LLM for sub-tasks
+    model?: BaseChatModel,         // Optional LLM for sub-tasks
     parallel?: boolean,            // Enable parallel execution
     stepTimeout?: number,          // Timeout per step (ms)
-    maxParallelSteps?: number,     // Max concurrent steps
   },
   replanner?: {
-    llm: BaseChatModel,            // LLM for replanning
+    model: BaseChatModel,          // LLM for replanning
     replanThreshold?: number,      // Confidence threshold (0-1)
     systemPrompt?: string,         // Custom replanning prompt
   },
   maxIterations?: number,          // Max planning iterations
-  returnIntermediateSteps?: boolean,
   verbose?: boolean,
 }
 ```
@@ -397,17 +391,19 @@ import {
 ```typescript
 {
   generator: {
-    llm: BaseChatModel,           // LLM for generation
+    model: BaseChatModel,          // LLM for generation
     systemPrompt?: string,         // Custom generation prompt
   },
   reflector: {
-    llm: BaseChatModel,            // LLM for reflection
+    model: BaseChatModel,          // LLM for reflection
     systemPrompt?: string,         // Custom reflection prompt
-    criteria?: string[],           // Reflection criteria
+  },
+  reviser: {
+    model: BaseChatModel,          // LLM for revision
+    systemPrompt?: string,         // Custom revision prompt
   },
   maxIterations?: number,          // Max reflection cycles (default: 3)
-  qualityThreshold?: number,       // Quality score threshold (0-1)
-  returnIntermediateSteps?: boolean,
+  qualityCriteria?: string[],      // Quality criteria for reflection
   verbose?: boolean,
 }
 ```
@@ -431,7 +427,8 @@ import {
 
 **Main API**:
 - `createMultiAgentSystem(config)` - Create a complete Multi-Agent system
-- `registerWorkers(system, workers)` - Register workers with the system
+- `MultiAgentSystemBuilder` - Builder for creating Multi-Agent systems with workers
+- `registerWorkers(system, workers)` - Update worker capabilities in state (Note: does not add worker nodes to compiled graphs; use builder or pass workers to createMultiAgentSystem)
 
 **Configuration**:
 ```typescript
@@ -458,13 +455,32 @@ import {
 - `'load-balanced'` - Route to least busy worker
 - Custom rule-based routing
 
-**Worker Configuration**:
+**Worker Configuration** (for createMultiAgentSystem):
+```typescript
+{
+  id: string,                     // Unique worker identifier
+  capabilities: {                 // Worker capabilities
+    skills: string[],             // Worker skills
+    tools: string[],              // Tool names (not objects)
+    available: boolean,           // Availability status
+    currentWorkload?: number,     // Current workload
+  },
+  tools?: Tool[],                 // Actual tool implementations
+  model?: BaseChatModel,          // Worker-specific model
+  systemPrompt?: string,          // Worker-specific prompt
+  executeFn?: Function,           // Custom execution function
+  agent?: CompiledStateGraph,     // Pre-built agent
+}
+```
+
+**Worker Configuration** (for MultiAgentSystemBuilder.registerWorkers):
 ```typescript
 {
-  name: string,                   // Unique worker identifier
-  description: string,            // Worker description
-  capabilities: string[],         // Worker capabilities/skills
-  tools: Tool[],                  // Available tools
+  name: string,                   // Worker name (becomes 'id')
+  description?: string,           // Worker description
+  capabilities: string[],         // Array of skill names
+  tools?: Tool[],                 // Available tools
+  model?: BaseChatModel,          // Worker-specific model
   systemPrompt?: string,          // Worker-specific prompt
 }
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentforge/patterns",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "description": "Agent patterns (ReAct, Planner-Executor) for AgentForge framework",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -16,17 +16,6 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsup src/index.ts --format esm,cjs --dts --clean",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
-    "test": "vitest",
-    "test:coverage": "vitest --coverage",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint src",
-    "lint:fix": "eslint src --fix",
-    "format": "prettier --write \"src/**/*.ts\"",
-    "clean": "rm -rf dist *.tsbuildinfo"
-  },
   "keywords": [
     "agents",
     "ai",
@@ -47,13 +36,13 @@
     "url": "https://github.com/TVScoundrel/agentforge/issues"
   },
   "dependencies": {
-    "@agentforge/core": "workspace:*",
+    "@agentforge/core": "0.12.1",
     "@langchain/core": "^1.1.17",
     "@langchain/langgraph": "^1.1.2",
     "zod": "^3.23.8"
   },
   "devDependencies": {
-    "@agentforge/testing": "workspace:*",
+    "@agentforge/testing": "0.12.1",
     "@eslint/js": "^9.17.0",
     "@types/node": "^22.10.2",
     "eslint": "^9.17.0",
@@ -62,5 +51,16 @@
     "typescript": "^5.3.3",
     "typescript-eslint": "^8.19.1",
     "vitest": "^1.6.1"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "clean": "rm -rf dist *.tsbuildinfo"
   }
-}
+}