agente-toolkit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Carlos Angarita
+
+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

@@ -0,0 +1,211 @@
+# agente-toolkit
+
+A modern TypeScript library for building AI agents with **native tool calling** and intelligent orchestration patterns. Features both single-agent execution and intelligent manager agents that automatically discover and route to specialized agents.
+
+## 🚀 Key Features
+
+### **Native Tool Calling Support**
+
+- **Claude Native Integration**: Leverages Anthropic's built-in tool calling for optimal performance
+- **Automatic Fallback**: Gracefully falls back to traditional planning when native tools aren't available
+- **Adapter-Driven**: Clean abstraction that works with multiple LLM providers
+
+### **Intelligent Agent Architecture**
+
+- **Single-agent execution** with memory, tools, and conversational responses
+- **Intelligent Manager pattern** via enhanced `ManagerAgent` with dynamic agent discovery
+- **Smart routing** using agent keywords, capabilities, and examples for better delegation
+- **Clean Architecture**: Separated concerns with ExecutionEngine, ResponseProcessor, and Planner
+
+### **Advanced Capabilities**
+
+- **Conversational Responses**: Automatic post-processing converts raw tool results into natural language
+- **Memory Management**: Context-aware memory with relevance scoring
+- **Safety Guardrails**: Max steps, max duration, stop-on-first-error
+- **Comprehensive Logging**: Detailed execution tracking with step-level timings
+
+## 🏗️ Architecture Overview
+
+```
+Agent (Coordinator)
+├── ExecutionEngine (Execution Orchestration)
+│   ├── Native tool calling (when supported)
+│   ├── Fallback to planned execution
+│   └── ResponseProcessor (Conversational formatting)
+└── Planner (Traditional step-by-step execution)
+    ├── Plan creation and validation
+    └── Tool coordination and execution
+```
+
+## 🎯 Enhanced ManagerAgent
+
+The `ManagerAgent` intelligently manages any registered agents with automatic discovery:
+
+- **Dynamic Discovery**: Automatically finds and creates tools for all registered agents
+- **Keyword-based Routing**: Uses agent keywords to match user requests to appropriate agents
+- **Capability Awareness**: Leverages task types, examples, and limitations for smart delegation
+- **Native Tool Integration**: Benefits from both native tool calling and conversational responses
+
+### Quick Example
+
+```typescript
+import {
+  ManagerAgent,
+  CalculatorAgent,
+  WeatherAgent,
+  registerAgent,
+  ClaudeAdapter,
+} from 'agente-toolkit';
+
+// Register agents with their metadata
+registerAgent('calculator', new CalculatorAgent(), CalculatorAgent.metadata);
+registerAgent('weather', new WeatherAgent(), WeatherAgent.metadata);
+
+// Create adapter with native tool support
+const adapter = new ClaudeAdapter(process.env.ANTHROPIC_API_KEY);
+
+// Create intelligent manager that routes based on keywords and capabilities
+const manager = new ManagerAgent(adapter);
+// Now handles: "Calculate 15+27" → Calculator, "Weather in NYC" → Weather
+// All with conversational responses!
+```
+
+## 📦 Install
+
+Clone and install dependencies:
+
+```bash
+git clone <repository-url>
+cd agente-toolkit
+npm install
+npm run build
+```
+
+## Programmatic Usage
+
+### Basic Agent with Native Tool Support
+
+```typescript
+import { Agent, ClaudeAdapter } from 'agente-toolkit';
+
+// Create agent with native tool calling support
+const agent = new Agent();
+agent.setPrompt('You are a helpful assistant.');
+// agent.addTool(...) - Add your custom tools
+
+// Claude adapter automatically uses native tools when available
+const adapter = new ClaudeAdapter(process.env.ANTHROPIC_API_KEY);
+
+// Get conversational responses regardless of execution method
+const result = await agent.run('Hello!', adapter, {
+  maxSteps: 8,
+  stopOnFirstToolError: true,
+});
+console.log(result); // Natural, conversational response
+```
+
+### Intelligent Manager Agent with Native Tools
+
+```typescript
+import {
+  ManagerAgent,
+  CalculatorAgent,
+  WeatherAgent,
+  registerAgent,
+  ClaudeAdapter,
+} from 'agente-toolkit';
+
+// Register agents with rich metadata
+const calc = new CalculatorAgent();
+const weather = new WeatherAgent();
+
+registerAgent('calculator', calc, CalculatorAgent.metadata);
+registerAgent('weather', weather, WeatherAgent.metadata);
+
+// Create adapter with native tool calling support
+const adapter = new ClaudeAdapter(process.env.ANTHROPIC_API_KEY);
+
+// Create manager that intelligently routes and provides conversational responses
+const manager = new ManagerAgent(adapter);
+
+// The manager intelligently routes with natural responses:
+// "Calculate 15 + 27" → Calculator agent → "The result is 42"
+// "Weather in Tokyo" → Weather agent → "Current weather in Tokyo is 22°C with clear skies"
+// "What's 50 divided by 2?" → Calculator agent → "50 divided by 2 equals 25"
+
+const result = await manager.run('What is 25 * 4?', adapter);
+// Returns: "25 multiplied by 4 equals 100"
+```
+
+### Architecture Benefits
+
+```typescript
+// Native tool calling (when supported)
+const result1 = await agent.run('Weather in Paris', claudeAdapter);
+// → Uses Claude's native tools → Conversational response
+
+// Automatic fallback (when native tools fail or unavailable)
+const result2 = await agent.run('Weather in Paris', basicAdapter);
+// → Uses traditional planner → Converts to conversational response
+
+// Both paths provide natural, user-friendly responses!
+```
+
+### Custom Agent with Modern Architecture
+
+```typescript
+import { Agent, AgentRegistration, ClaudeAdapter } from 'agente-toolkit';
+
+class CustomAgent extends Agent {
+  static readonly metadata: AgentRegistration = {
+    metadata: {
+      id: 'custom',
+      name: 'Custom Agent',
+      description: 'Handles custom tasks with native tool support',
+      categories: ['utility', 'custom'],
+      keywords: ['custom', 'utility', 'helper', 'process'],
+      priority: 3,
+    },
+    capabilities: {
+      taskTypes: ['data processing', 'utility functions'],
+      examples: ['Process this data', 'Help with utility task'],
+      limitations: ['Cannot handle real-time data'],
+    },
+  };
+
+  constructor() {
+    super();
+    this.setPrompt('I am a helpful custom utility agent.');
+    // Add custom tools that benefit from native calling...
+  }
+}
+
+// Register and use with ManagerAgent (gets native tool benefits automatically)
+registerAgent('custom', new CustomAgent(), CustomAgent.metadata);
+const manager = new ManagerAgent(new ClaudeAdapter(process.env.ANTHROPIC_API_KEY));
+```
+
+## 🔧 Technical Highlights
+
+### Execution Flow
+
+1. **Agent receives request** → Memory retrieval → Context building
+2. **ExecutionEngine decides** → Native tools (if supported) OR Traditional planner
+3. **Native path**: Direct tool calling → Immediate conversational response
+4. **Planned path**: Step-by-step execution → ResponseProcessor → Conversational response
+5. **Result**: Always natural, user-friendly responses regardless of execution method
+
+### Adapter Support
+
+- **ClaudeAdapter**: Full native tool calling support with automatic fallback
+- **Future adapters**: Can implement native tools or rely on traditional planning
+- **Graceful degradation**: System works with any adapter capability level
+
+## 📝 Notes
+
+- **Native tool calling** provides faster, more natural interactions when available
+- **Automatic fallback** ensures reliability across different model capabilities
+- **Conversational responses** are generated for all execution paths
+- **ManagerAgent** automatically benefits from native tools for all registered agents
+- **Weather functions** call public APIs; ensure network access when using them
+- **Verbose logging** (`--verbose`) shows detailed execution flow including native vs planned paths

package/dist/cjs/agents/calculator/CalculatorAgent.d.ts

@@ -0,0 +1,10 @@
+import { Agent } from '../../core/agent/Agent';
+import { MemoryManager } from '../../core/memory/memory';
+import { AgentRegistration } from '../../core/agent/types/AgentMetadata';
+export declare class CalculatorAgent extends Agent {
+    static readonly metadata: AgentRegistration;
+    constructor(memoryManager?: MemoryManager);
+    getMetadata(): AgentRegistration;
+    private setupCalculatorTools;
+}
+//# sourceMappingURL=CalculatorAgent.d.ts.map

package/dist/cjs/agents/calculator/CalculatorAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CalculatorAgent.d.ts","sourceRoot":"","sources":["../../../../src/agents/calculator/CalculatorAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAEzE,qBAAa,eAAgB,SAAQ,KAAK;IACxC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAgCzC;gBAEU,aAAa,CAAC,EAAE,aAAa;IAQzC,WAAW,IAAI,iBAAiB;IAIhC,OAAO,CAAC,oBAAoB;CA4C7B"}

package/dist/cjs/agents/index.d.ts

@@ -0,0 +1,4 @@
+export { CalculatorAgent } from './calculator/CalculatorAgent';
+export { ManagerAgent } from './manager/ManagerAgent';
+export { WeatherAgent } from './weather/WeatherAgent';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/cjs/agents/manager/ManagerAgent.d.ts

@@ -0,0 +1,34 @@
+import { Agent } from '../../core/agent/Agent';
+import { MemoryManager } from '../../core/memory/memory';
+import { ModelAdapter } from '../../infrastructure/adapters/base/base';
+import { AgentRegistration } from '../../core/agent/types/AgentMetadata';
+export interface ManagerAgentOptions {
+    /**
+     * Optional filter to only include agents from specific categories
+     */
+    allowedCategories?: string[];
+    /**
+     * Maximum number of agents to register as tools (default: 10)
+     */
+    maxAgents?: number;
+    /**
+     * Custom prompt override
+     */
+    customPrompt?: string;
+    /**
+     * Whether to include detailed capability information in prompts
+     */
+    includeDetailedCapabilities?: boolean;
+}
+export declare class ManagerAgent extends Agent {
+    constructor(adapter: ModelAdapter, memoryManager?: MemoryManager, options?: ManagerAgentOptions);
+    /**
+     * Static method to create a ManagerAgent with specific agents pre-registered
+     */
+    static withAgents(adapter: ModelAdapter, agents: Array<{
+        name: string;
+        agent: Agent;
+        registration?: AgentRegistration;
+    }>, memoryManager?: MemoryManager, options?: ManagerAgentOptions): ManagerAgent;
+}
+//# sourceMappingURL=ManagerAgent.d.ts.map

package/dist/cjs/agents/manager/ManagerAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManagerAgent.d.ts","sourceRoot":"","sources":["../../../../src/agents/manager/ManagerAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAMvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAEzE,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE7B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC;AAED,qBAAa,YAAa,SAAQ,KAAK;gBAEnC,OAAO,EAAE,YAAY,EACrB,aAAa,CAAC,EAAE,aAAa,EAC7B,OAAO,GAAE,mBAAwB;IA4HnC;;OAEG;IACH,MAAM,CAAC,UAAU,CACf,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,KAAK,CAAC;QACb,YAAY,CAAC,EAAE,iBAAiB,CAAC;KAClC,CAAC,EACF,aAAa,CAAC,EAAE,aAAa,EAC7B,OAAO,GAAE,mBAAwB,GAChC,YAAY;CAUhB"}

package/dist/cjs/agents/weather/WeatherAgent.d.ts

@@ -0,0 +1,10 @@
+import { Agent } from '../../core/agent/Agent';
+import { MemoryManager } from '../../core/memory/memory';
+import { AgentRegistration } from '../../core/agent/types/AgentMetadata';
+export declare class WeatherAgent extends Agent {
+    static readonly metadata: AgentRegistration;
+    constructor(memoryManager?: MemoryManager);
+    getMetadata(): AgentRegistration;
+    private setupWeatherTools;
+}
+//# sourceMappingURL=WeatherAgent.d.ts.map

package/dist/cjs/agents/weather/WeatherAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WeatherAgent.d.ts","sourceRoot":"","sources":["../../../../src/agents/weather/WeatherAgent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAEzE,qBAAa,YAAa,SAAQ,KAAK;IACrC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAiCzC;gBAEU,aAAa,CAAC,EAAE,aAAa;IAQzC,WAAW,IAAI,iBAAiB;IAIhC,OAAO,CAAC,iBAAiB;CA+F1B"}

package/dist/cjs/core/agent/Agent.d.ts

@@ -0,0 +1,25 @@
+import { ModelAdapter } from '../../infrastructure/adapters/base/base';
+import { MemoryManager, Memory } from '../memory/memory';
+import { AgentLogger } from '../../infrastructure/logging/interfaces/AgentLogger';
+import { Tool, Serializable } from '../tools/types/Tool';
+import { RunOptions } from './types/RunOptions';
+import { TSchema } from '@sinclair/typebox';
+export declare class Agent {
+    private memoryManager;
+    private tools;
+    private prompt;
+    private executionEngine;
+    private logger;
+    private loggerUtils;
+    constructor(memoryManager?: MemoryManager, logger?: AgentLogger);
+    addTool<TParams extends TSchema, TResult extends Serializable = string>(tool: Tool<TParams, TResult>): void;
+    remember(message: string, type?: Memory['type'], importance?: number): void;
+    getMemory(): Memory[];
+    getMemoryCount(): number;
+    getRelevantMemories(context: string, maxCount?: number): Memory[];
+    setPrompt(prompt: string): void;
+    getPrompt(): string;
+    run(message: string, model: ModelAdapter, options?: RunOptions): Promise<string>;
+    private _executeDecisionCycle;
+}
+//# sourceMappingURL=Agent.d.ts.map

package/dist/cjs/core/agent/Agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Agent.d.ts","sourceRoot":"","sources":["../../../../src/core/agent/Agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,EAAE,aAAa,EAA8B,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAErF,OAAO,EAAE,WAAW,EAAE,MAAM,qDAAqD,CAAC;AAGlF,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,qBAAa,KAAK;IAChB,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,WAAW,CAAc;gBAErB,aAAa,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,WAAW;IAO/D,OAAO,CAAC,OAAO,SAAS,OAAO,EAAE,OAAO,SAAS,YAAY,GAAG,MAAM,EACpE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC;IAK9B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,CAAkB,EAAE,UAAU,SAAM,GAAG,IAAI;IASxF,SAAS,IAAI,MAAM,EAAE;IAIrB,cAAc,IAAI,MAAM;IAIxB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAIjE,SAAS,CAAC,MAAM,EAAE,MAAM;IAIxB,SAAS,IAAI,MAAM;IAIb,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC;YAY5E,qBAAqB;CAkDpC"}

package/dist/cjs/core/agent/Agent.js

@@ -0,0 +1,95 @@
+'use strict';
+
+var memory = require('../memory/memory.js');
+var ExecutionEngine = require('../execution/ExecutionEngine.js');
+var defaultLoggers = require('../../infrastructure/logging/implementations/defaultLoggers.js');
+var loggerUtils = require('../../infrastructure/logging/utils/loggerUtils.js');
+
+class Agent {
+    constructor(memoryManager, logger) {
+        this.tools = [];
+        this.prompt = '';
+        this.memoryManager = memoryManager || new memory.SlidingWindowMemoryManager();
+        this.logger = logger || defaultLoggers.createDefaultLogger();
+        this.executionEngine = new ExecutionEngine.ExecutionEngine(this.logger);
+        this.loggerUtils = new loggerUtils.LoggerUtils(this.logger);
+    }
+    addTool(tool) {
+        this.tools.push(tool);
+    }
+    remember(message, type = 'conversation', importance = 0.5) {
+        this.memoryManager.addMemory({
+            type,
+            content: message,
+            importance,
+        });
+        this.loggerUtils.logMemoryOperation('add', { type, importance, contentLength: message.length });
+    }
+    getMemory() {
+        return this.memoryManager.getAllMemories();
+    }
+    getMemoryCount() {
+        return this.memoryManager.getMemoryCount();
+    }
+    getRelevantMemories(context, maxCount) {
+        return this.memoryManager.getRelevantMemories(context, maxCount);
+    }
+    setPrompt(prompt) {
+        this.prompt = prompt;
+    }
+    getPrompt() {
+        return this.prompt;
+    }
+    async run(message, model, options = {}) {
+        this.loggerUtils.logRunStart({
+            message: message.substring(0, 50) + '...',
+            options,
+        });
+        this.remember(message, 'conversation', 0.8);
+        const response = await this._executeDecisionCycle(message, model, options);
+        this.remember(`Agent response: ${response}`, 'conversation', 0.6);
+        this.loggerUtils.logRunEnd();
+        return response;
+    }
+    async _executeDecisionCycle(message, model, options) {
+        try {
+            const relevantMemories = this.memoryManager.getRelevantMemories(message, 5);
+            const memoryContext = relevantMemories.length > 0
+                ? relevantMemories.map(m => `[${m.type}] ${m.content}`).join('\n')
+                : 'No relevant context available.';
+            this.logger.debug('Retrieved relevant memories', {
+                count: relevantMemories.length,
+                contextLength: memoryContext.length,
+            });
+            // Create execution context
+            const executionContext = {
+                message,
+                tools: this.tools,
+                memoryContext,
+                systemPrompt: this.prompt,
+                model,
+                options,
+            };
+            // Delegate to execution engine
+            const result = await this.executionEngine.execute(executionContext);
+            // Log the overall execution result
+            this.logger.debug('Agent execution completed', {
+                executionType: model.supportsNativeTools ? 'native' : 'planned',
+                resultLength: result.length,
+            });
+            // Remember the overall result
+            this.remember(`Agent processed request. Result: ${result}`, 'tool_result', 0.6);
+            return result;
+        }
+        catch (error) {
+            const errorMessage = `Execution failed: ${error instanceof Error ? error.message : String(error)}`;
+            this.logger.error('Agent execution failed', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return errorMessage;
+        }
+    }
+}
+
+exports.Agent = Agent;
+//# sourceMappingURL=Agent.js.map

package/dist/cjs/core/agent/Agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Agent.js","sources":["../../../../../src/core/agent/Agent.ts"],"sourcesContent":[null],"names":["SlidingWindowMemoryManager","createDefaultLogger","ExecutionEngine","LoggerUtils"],"mappings":";;;;;;;MAUa,KAAK,CAAA;IAQhB,WAAA,CAAY,aAA6B,EAAE,MAAoB,EAAA;QANvD,IAAA,CAAA,KAAK,GAAqB,EAAE;QAC5B,IAAA,CAAA,MAAM,GAAW,EAAE;QAMzB,IAAI,CAAC,aAAa,GAAG,aAAa,IAAI,IAAIA,iCAA0B,EAAE;AACtE,QAAA,IAAI,CAAC,MAAM,GAAG,MAAM,IAAIC,kCAAmB,EAAE;QAC7C,IAAI,CAAC,eAAe,GAAG,IAAIC,+BAAe,CAAC,IAAI,CAAC,MAAM,CAAC;QACvD,IAAI,CAAC,WAAW,GAAG,IAAIC,uBAAW,CAAC,IAAI,CAAC,MAAM,CAAC;IACjD;AAEA,IAAA,OAAO,CACL,IAA4B,EAAA;AAE5B,QAAA,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IACvB;IAEA,QAAQ,CAAC,OAAe,EAAE,IAAA,GAAuB,cAAc,EAAE,UAAU,GAAG,GAAG,EAAA;AAC/E,QAAA,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC;YAC3B,IAAI;AACJ,YAAA,OAAO,EAAE,OAAO;YAChB,UAAU;AACX,SAAA,CAAC;AACF,QAAA,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IACjG;IAEA,SAAS,GAAA;AACP,QAAA,OAAO,IAAI,CAAC,aAAa,CAAC,cAAc,EAAE;IAC5C;IAEA,cAAc,GAAA;AACZ,QAAA,OAAO,IAAI,CAAC,aAAa,CAAC,cAAc,EAAE;IAC5C;IAEA,mBAAmB,CAAC,OAAe,EAAE,QAAiB,EAAA;QACpD,OAAO,IAAI,CAAC,aAAa,CAAC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC;IAClE;AAEA,IAAA,SAAS,CAAC,MAAc,EAAA;AACtB,QAAA,IAAI,CAAC,MAAM,GAAG,MAAM;IACtB;IAEA,SAAS,GAAA;QACP,OAAO,IAAI,CAAC,MAAM;IACpB;IAEA,MAAM,GAAG,CAAC,OAAe,EAAE,KAAmB,EAAE,UAAsB,EAAE,EAAA;AACtE,QAAA,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC;YAC3B,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK;YACzC,OAAO;AACR,SAAA,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,CAAC;AAC3C,QAAA,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC;QAC1E,IAAI,CAAC,QAAQ,CAAC,CAAA,gBAAA,EAAmB,QAAQ,CAAA,CAAE,EAAE,cAAc,EAAE,GAAG,CAAC;AACjE,QAAA,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE;AAC5B,QAAA,OAAO,QAAQ;IACjB;AAEQ,IAAA,MAAM,qBAAqB,CACjC,OAAe,EACf,KAAmB,EACnB,OAAmB,EAAA;QAEnB,IAAI;AACF,YAAA,MAAM,gBAAgB,GAAG,IAAI,CAAC,aAAa,CAAC,mBAAmB,CAAC,OAAO,EAAE,CAAC,CAAC;AAC3E,YAAA,MAAM,aAAa,GACjB,gBAAgB,CAAC,MAAM,GAAG;kBACtB,gBAAgB,CAAC,GAAG,CAAC,CAAC,IAAI,CAAA,CAAA,EAAI,CAAC,CAAC,IAAI,CAAA,EAAA,EAAK,CAAC,CAAC,OAAO,CAAA,CAAE,CAAC,CAAC,IAAI,CAAC,IAAI;kBAC/D,gCAAgC;AAEtC,YAAA,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE;gBAC/C,KAAK,EAAE,gBAAgB,CAAC,MAAM;gBAC9B,aAAa,EAAE,aAAa,CAAC,MAAM;AACpC,aAAA,CAAC;;AAGF,YAAA,MAAM,gBAAgB,GAAqB;gBACzC,OAAO;gBACP,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,aAAa;gBACb,YAAY,EAAE,IAAI,CAAC,MAAM;gBACzB,KAAK;gBACL,OAAO;aACR;;YAGD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,gBAAgB,CAAC;;AAGnE,YAAA,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE;gBAC7C,aAAa,EAAE,KAAK,CAAC,mBAAmB,GAAG,QAAQ,GAAG,SAAS;gBAC/D,YAAY,EAAE,MAAM,CAAC,MAAM;AAC5B,aAAA,CAAC;;YAGF,IAAI,CAAC,QAAQ,CAAC,CAAA,iCAAA,EAAoC,MAAM,CAAA,CAAE,EAAE,aAAa,EAAE,GAAG,CAAC;AAE/E,YAAA,OAAO,MAAM;AACd,QAAA;AAAC,QAAA,OAAO,KAAK,EAAE;YACd,MAAM,YAAY,GAAG,CAAA,kBAAA,EACnB,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CACvD,EAAE;AACF,YAAA,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE;AAC1C,gBAAA,KAAK,EAAE,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC;AAC9D,aAAA,CAAC;AACF,YAAA,OAAO,YAAY;AACpB,QAAA;IACH;AACD;;;;"}

package/dist/cjs/core/agent/AgentRegistry.d.ts

@@ -0,0 +1,28 @@
+import { Agent } from './Agent';
+import { AgentRegistration } from './types/AgentMetadata';
+interface RegisteredAgent {
+    agent: Agent;
+    registration: AgentRegistration;
+}
+export declare function registerAgent(name: string, agent: Agent, registration?: AgentRegistration): void;
+export declare function getAgent(name: string): Agent | undefined;
+export declare function getAgentRegistration(name: string): AgentRegistration | undefined;
+export declare function getAllAgents(): Map<string, RegisteredAgent>;
+export declare function findAgentsByCategory(category: string): Array<{
+    name: string;
+    agent: Agent;
+    registration: AgentRegistration;
+}>;
+export declare function findAgentsByKeywords(keywords: string[]): Array<{
+    name: string;
+    agent: Agent;
+    registration: AgentRegistration;
+}>;
+export declare function getAvailableAgents(): Array<{
+    name: string;
+    agent: Agent;
+    registration: AgentRegistration;
+}>;
+export declare function clearRegistry(): void;
+export {};
+//# sourceMappingURL=AgentRegistry.d.ts.map

package/dist/cjs/core/agent/AgentRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRegistry.d.ts","sourceRoot":"","sources":["../../../../src/core/agent/AgentRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,UAAU,eAAe;IACvB,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,iBAAiB,CAAC;CACjC;AAID,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,EAAE,iBAAiB,QAqBzF;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAExD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEhF;AAED,wBAAgB,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAE3D;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,GACf,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,YAAY,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAgBxE;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAAE,GACjB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,YAAY,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAwBxE;AAED,wBAAgB,kBAAkB,IAAI,KAAK,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,iBAAiB,CAAC;CACjC,CAAC,CAYD;AAED,wBAAgB,aAAa,SAE5B"}

package/dist/cjs/core/agent/AgentRegistry.js

@@ -0,0 +1,74 @@
+'use strict';
+
+const registry = new Map();
+function registerAgent(name, agent, registration) {
+    const defaultRegistration = {
+        metadata: {
+            id: name,
+            name: name,
+            description: `Agent: ${name}`,
+            categories: ['general'],
+            keywords: [name],
+            priority: 1,
+            enabled: true,
+        },
+        capabilities: {
+            taskTypes: ['general'],
+            examples: [],
+        },
+    };
+    registry.set(name, {
+        agent,
+        registration: registration || defaultRegistration,
+    });
+}
+function getAgent(name) {
+    var _a;
+    return (_a = registry.get(name)) === null || _a === void 0 ? void 0 : _a.agent;
+}
+function findAgentsByCategory(category) {
+    const results = [];
+    for (const [name, registered] of registry.entries()) {
+        if (registered.registration.metadata.categories.includes(category) &&
+            registered.registration.metadata.enabled !== false) {
+            results.push({ name, agent: registered.agent, registration: registered.registration });
+        }
+    }
+    // Sort by priority (higher priority first)
+    return results.sort((a, b) => (b.registration.metadata.priority || 0) - (a.registration.metadata.priority || 0));
+}
+function findAgentsByKeywords(keywords) {
+    const results = [];
+    for (const [name, registered] of registry.entries()) {
+        if (registered.registration.metadata.enabled === false)
+            continue;
+        const agentKeywords = registered.registration.metadata.keywords.map(k => k.toLowerCase());
+        const hasMatchingKeyword = keywords.some(keyword => agentKeywords.some(agentKeyword => agentKeyword.includes(keyword.toLowerCase()) ||
+            keyword.toLowerCase().includes(agentKeyword)));
+        if (hasMatchingKeyword) {
+            results.push({ name, agent: registered.agent, registration: registered.registration });
+        }
+    }
+    // Sort by priority (higher priority first)
+    return results.sort((a, b) => (b.registration.metadata.priority || 0) - (a.registration.metadata.priority || 0));
+}
+function getAvailableAgents() {
+    const results = [];
+    for (const [name, registered] of registry.entries()) {
+        if (registered.registration.metadata.enabled !== false) {
+            results.push({ name, agent: registered.agent, registration: registered.registration });
+        }
+    }
+    return results.sort((a, b) => (b.registration.metadata.priority || 0) - (a.registration.metadata.priority || 0));
+}
+function clearRegistry() {
+    registry.clear();
+}
+
+exports.clearRegistry = clearRegistry;
+exports.findAgentsByCategory = findAgentsByCategory;
+exports.findAgentsByKeywords = findAgentsByKeywords;
+exports.getAgent = getAgent;
+exports.getAvailableAgents = getAvailableAgents;
+exports.registerAgent = registerAgent;
+//# sourceMappingURL=AgentRegistry.js.map

package/dist/cjs/core/agent/AgentRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRegistry.js","sources":["../../../../../src/core/agent/AgentRegistry.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/cjs/core/agent/index.d.ts

@@ -0,0 +1,5 @@
+export { Agent } from './Agent';
+export { registerAgent, getAgent, getAvailableAgents, findAgentsByCategory, findAgentsByKeywords, clearRegistry, } from './AgentRegistry';
+export type { AgentMetadata, AgentCapability, AgentRegistration } from './types/AgentMetadata';
+export type { RunOptions } from './types/RunOptions';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/core/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/agent/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EACL,aAAa,EACb,QAAQ,EACR,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,GACd,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/F,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/cjs/core/agent/types/AgentMetadata.d.ts

@@ -0,0 +1,54 @@
+export interface AgentMetadata {
+    /**
+     * Unique identifier for the agent
+     */
+    id: string;
+    /**
+     * Human-readable name for the agent
+     */
+    name: string;
+    /**
+     * Description of what the agent does
+     */
+    description: string;
+    /**
+     * Categories that this agent belongs to (e.g., "math", "weather", "search")
+     */
+    categories: string[];
+    /**
+     * Keywords that can help identify when this agent should be used
+     */
+    keywords: string[];
+    /**
+     * Priority level for this agent when multiple agents match a request
+     * Higher numbers = higher priority
+     */
+    priority?: number;
+    /**
+     * Whether this agent is currently available for use
+     */
+    enabled?: boolean;
+    /**
+     * Additional metadata that specific implementations might need
+     */
+    custom?: Record<string, any>;
+}
+export interface AgentCapability {
+    /**
+     * What types of tasks this agent can handle
+     */
+    taskTypes: string[];
+    /**
+     * Examples of questions/requests this agent can handle
+     */
+    examples: string[];
+    /**
+     * Limitations or things this agent cannot do
+     */
+    limitations?: string[];
+}
+export interface AgentRegistration {
+    metadata: AgentMetadata;
+    capabilities: AgentCapability;
+}
+//# sourceMappingURL=AgentMetadata.d.ts.map

package/dist/cjs/core/agent/types/AgentMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentMetadata.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/types/AgentMetadata.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;IAErB;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,EAAE,eAAe,CAAC;CAC/B"}

package/dist/cjs/core/agent/types/RunOptions.d.ts

@@ -0,0 +1,7 @@
+export interface RunOptions {
+    maxSteps?: number;
+    maxDurationMs?: number;
+    stopOnFirstToolError?: boolean;
+    requiredOutputRegex?: string;
+}
+//# sourceMappingURL=RunOptions.d.ts.map

package/dist/cjs/core/agent/types/RunOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunOptions.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/types/RunOptions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B"}