agente-toolkit 0.1.0 → 0.3.0

package/README.md

@@ -1,5 +1,10 @@
 # agente-toolkit
 
+[![npm version](https://badge.fury.io/js/agente-toolkit.svg)](https://www.npmjs.com/package/agente-toolkit)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-4.9-blue.svg)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
+
 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
@@ -21,6 +26,7 @@ A modern TypeScript library for building AI agents with **native tool calling**
 
 - **Conversational Responses**: Automatic post-processing converts raw tool results into natural language
 - **Memory Management**: Context-aware memory with relevance scoring
+- **Retrieval-Augmented Generation (RAG)**: Optional pluggable retrieval system to ground responses in external knowledge
 - **Safety Guardrails**: Max steps, max duration, stop-on-first-error
 - **Comprehensive Logging**: Detailed execution tracking with step-level timings
 
@@ -49,38 +55,142 @@ The `ManagerAgent` intelligently manages any registered agents with automatic di
 ### Quick Example
 
 ```typescript
-import {
-  ManagerAgent,
-  CalculatorAgent,
-  WeatherAgent,
-  registerAgent,
-  ClaudeAdapter,
-} from 'agente-toolkit';
+import { ManagerAgent, registerAgent, ClaudeAdapter } from 'agente-toolkit';
+
+// For this example, you'll need to copy the example agents from the GitHub repository
+// See: https://github.com/LordShiroe/agente-toolkit/tree/main/examples/agents
+// import { CalculatorAgent, WeatherAgent } from './your-agents-directory';
+
+// For demonstration, let's create simple agents inline
+class CalculatorAgent extends Agent {
+  constructor() {
+    super();
+    this.addTool({
+      name: 'add',
+      description: 'Add two numbers',
+      paramsSchema: Type.Object({
+        a: Type.Number(),
+        b: Type.Number(),
+      }),
+      action: async params => (params.a + params.b).toString(),
+    });
+  }
+
+  static metadata = {
+    metadata: {
+      id: 'calculator',
+      name: 'Calculator Agent',
+      description: 'Performs arithmetic calculations',
+      categories: ['math'],
+      keywords: ['calculate', 'math', 'add'],
+      priority: 5,
+    },
+    capabilities: {
+      taskTypes: ['arithmetic'],
+      examples: ['What is 15 + 27?'],
+      limitations: [],
+    },
+  };
+}
 
 // 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!
+
+// The manager routes: "Calculate 15+27" → Calculator agent
+const result = await manager.run('Calculate 15 + 27', adapter);
+console.log(result); // "The result is 42"
 ```
 
-## 📦 Install
+> **Note:** Full example agents (Calculator, Weather) are available in the [GitHub repository](https://github.com/LordShiroe/agente-toolkit/tree/main/examples/agents) but not included in the npm package. Copy them to your project as needed.
+
+## 📦 Installation
 
-Clone and install dependencies:
+### From NPM (Recommended)
 
 ```bash
-git clone <repository-url>
+npm install agente-toolkit
+```
+
+Or using yarn:
+
+```bash
+yarn add agente-toolkit
+```
+
+Or using pnpm:
+
+```bash
+pnpm add agente-toolkit
+```
+
+### Requirements
+
+- **Node.js**: >= 18.0.0
+- **TypeScript**: >= 4.9.0 (for TypeScript projects)
+
+### From Source (Development)
+
+```bash
+git clone https://github.com/LordShiroe/agente-toolkit.git
 cd agente-toolkit
 npm install
 npm run build
 ```
 
+## 🚀 Quick Start
+
+### 1. Set up your API key
+
+```bash
+export ANTHROPIC_API_KEY="your-api-key-here"
+# or for OpenAI
+export OPENAI_API_KEY="your-api-key-here"
+```
+
+### 2. Create your first agent
+
+```typescript
+import { Agent, ClaudeAdapter } from 'agente-toolkit';
+
+// Create agent
+const agent = new Agent();
+agent.setPrompt('You are a helpful assistant.');
+
+// Create adapter
+const adapter = new ClaudeAdapter(process.env.ANTHROPIC_API_KEY);
+
+// Run!
+const result = await agent.run('Hello! What can you help me with?', adapter);
+console.log(result);
+```
+
+### 3. Add custom tools
+
+```typescript
+import { Agent, ClaudeAdapter } from 'agente-toolkit';
+import { Type } from '@sinclair/typebox';
+
+const agent = new Agent();
+
+// Add a custom tool
+agent.addTool({
+  name: 'get_time',
+  description: 'Get the current time',
+  paramsSchema: Type.Object({}),
+  action: async () => new Date().toLocaleTimeString(),
+});
+
+const adapter = new ClaudeAdapter(process.env.ANTHROPIC_API_KEY);
+const result = await agent.run('What time is it?', adapter);
+console.log(result); // "The current time is 2:30:45 PM"
+```
+
 ## Programmatic Usage
 
 ### Basic Agent with Native Tool Support
@@ -107,20 +217,45 @@ console.log(result); // Natural, conversational response
 ### Intelligent Manager Agent with Native Tools
 
 ```typescript
-import {
-  ManagerAgent,
-  CalculatorAgent,
-  WeatherAgent,
-  registerAgent,
-  ClaudeAdapter,
-} from 'agente-toolkit';
+import { ManagerAgent, registerAgent, ClaudeAdapter, Agent } from 'agente-toolkit';
+import { Type } from '@sinclair/typebox';
+
+// Create specialized agents
+class CalculatorAgent extends Agent {
+  constructor() {
+    super();
+    this.addTool({
+      name: 'add',
+      description: 'Add two numbers',
+      paramsSchema: Type.Object({
+        a: Type.Number({ description: 'First number' }),
+        b: Type.Number({ description: 'Second number' }),
+      }),
+      action: async params => (params.a + params.b).toString(),
+    });
+  }
+
+  static metadata = {
+    metadata: {
+      id: 'calculator',
+      name: 'Calculator Agent',
+      description: 'Performs arithmetic calculations',
+      categories: ['math'],
+      keywords: ['calculate', 'add', 'subtract', 'multiply', 'divide'],
+      priority: 5,
+    },
+    capabilities: {
+      taskTypes: ['arithmetic', 'calculations'],
+      examples: ['What is 15 + 27?', 'Calculate 144 divided by 12'],
+      limitations: ['Cannot handle complex mathematical functions'],
+    },
+  };
+}
 
 // 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);
@@ -130,13 +265,14 @@ 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"
 ```
 
+> **Pro Tip:** Check out the [examples directory](https://github.com/LordShiroe/agente-toolkit/tree/main/examples) for complete Calculator and Weather agent implementations.
+
 ### Architecture Benefits
 
 ```typescript
@@ -207,5 +343,30 @@ const manager = new ManagerAgent(new ClaudeAdapter(process.env.ANTHROPIC_API_KEY
 - **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
+- **Example agents** (Calculator, Weather) are available in the [GitHub repository](https://github.com/LordShiroe/agente-toolkit/tree/main/examples/agents) for reference
+- **API Keys**: Ensure you have valid API keys for your chosen provider (Claude, OpenAI, Ollama)
+
+## 📚 Documentation
+
+See the docs for guides and references:
+
+- Getting Started: [Installation](./docs/getting-started/installation.md) · [Quick Start](./docs/getting-started/quick-start.md) · [Configuration](./docs/getting-started/configuration.md)
+- Guides: [Building Agents](./docs/guides/building-agents.md) · [Tool Development](./docs/guides/tool-development.md) · [RAG Integration](./docs/guides/rag-integration.md)
+- Providers: [Claude](./docs/adapters/claude.md) · [OpenAI](./docs/adapters/openai.md) · [Ollama](./docs/adapters/ollama.md)
+
+Reference: [CHANGELOG](./CHANGELOG.md) · [CONTRIBUTING](./CONTRIBUTING.md) · [SECURITY](./SECURITY.md) · [LOGGING](./LOGGING.md) · [Examples](./examples/README.md) · [RAG Example](./examples/rag-example.md)
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md) for details.
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
+
+## 🔗 Links
+
+- [npm Package](https://www.npmjs.com/package/agente-toolkit)
+- [GitHub Repository](https://github.com/LordShiroe/agente-toolkit)
+- [Issue Tracker](https://github.com/LordShiroe/agente-toolkit/issues)
+- [Example Agents](https://github.com/LordShiroe/agente-toolkit/tree/main/examples/agents)

package/dist/cjs/_virtual/_commonjs-dynamic-modules.js

@@ -0,0 +1,8 @@
+'use strict';
+
+function commonjsRequire(path) {
+	throw new Error('Could not dynamically require "' + path + '". Please configure the dynamicRequireTargets or/and ignoreDynamicRequires option of @rollup/plugin-commonjs appropriately for this require call to work.');
+}
+
+exports.commonjsRequire = commonjsRequire;
+//# sourceMappingURL=_commonjs-dynamic-modules.js.map

package/dist/cjs/_virtual/_commonjs-dynamic-modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_commonjs-dynamic-modules.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}

package/dist/cjs/_virtual/_commonjsHelpers.js

@@ -0,0 +1,41 @@
+'use strict';
+
+var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
+
+function getDefaultExportFromCjs (x) {
+	return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, 'default') ? x['default'] : x;
+}
+
+function getAugmentedNamespace(n) {
+  if (Object.prototype.hasOwnProperty.call(n, '__esModule')) return n;
+  var f = n.default;
+	if (typeof f == "function") {
+		var a = function a () {
+			var isInstance = false;
+      try {
+        isInstance = this instanceof a;
+      } catch {}
+			if (isInstance) {
+        return Reflect.construct(f, arguments, this.constructor);
+			}
+			return f.apply(this, arguments);
+		};
+		a.prototype = f.prototype;
+  } else a = {};
+  Object.defineProperty(a, '__esModule', {value: true});
+	Object.keys(n).forEach(function (k) {
+		var d = Object.getOwnPropertyDescriptor(n, k);
+		Object.defineProperty(a, k, d.get ? d : {
+			enumerable: true,
+			get: function () {
+				return n[k];
+			}
+		});
+	});
+	return a;
+}
+
+exports.commonjsGlobal = commonjsGlobal;
+exports.getAugmentedNamespace = getAugmentedNamespace;
+exports.getDefaultExportFromCjs = getDefaultExportFromCjs;
+//# sourceMappingURL=_commonjsHelpers.js.map

package/dist/cjs/_virtual/_commonjsHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_commonjsHelpers.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/cjs/_virtual/backend.js

@@ -0,0 +1,6 @@
+'use strict';
+
+var backend = {};
+
+exports.__exports = backend;
+//# sourceMappingURL=backend.js.map

package/dist/cjs/_virtual/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

package/dist/cjs/_virtual/binding.js

@@ -0,0 +1,6 @@
+'use strict';
+
+var binding = {};
+
+exports.__exports = binding;
+//# sourceMappingURL=binding.js.map

package/dist/cjs/_virtual/binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

package/dist/cjs/_virtual/index.js

@@ -0,0 +1,12 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _commonjsHelpers = require('./_commonjsHelpers.js');
+var index = require('../node_modules/sharp/lib/index.js');
+
+var libExports = index.__require();
+var sharp = /*@__PURE__*/_commonjsHelpers.getDefaultExportFromCjs(libExports);
+
+exports.default = sharp;
+//# sourceMappingURL=index.js.map

package/dist/cjs/_virtual/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;"}

package/dist/cjs/_virtual/index2.js

@@ -0,0 +1,12 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _commonjsHelpers = require('./_commonjsHelpers.js');
+var index$1 = require('../node_modules/onnxruntime-node/dist/index.js');
+
+var distExports = index$1.__require();
+var index = /*@__PURE__*/_commonjsHelpers.getDefaultExportFromCjs(distExports);
+
+exports.default = index;
+//# sourceMappingURL=index2.js.map

package/dist/cjs/_virtual/index2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index2.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;"}

package/dist/cjs/_virtual/index3.js

@@ -0,0 +1,6 @@
+'use strict';
+
+var dist = {};
+
+exports.__exports = dist;
+//# sourceMappingURL=index3.js.map

package/dist/cjs/_virtual/index3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index3.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

package/dist/cjs/_virtual/index4.js

@@ -0,0 +1,11 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _commonjsHelpers = require('./_commonjsHelpers.js');
+var index = require('../node_modules/onnxruntime-common/dist/lib/index.js');
+
+var require$$6 = /*@__PURE__*/_commonjsHelpers.getAugmentedNamespace(index);
+
+exports.default = require$$6;
+//# sourceMappingURL=index4.js.map

package/dist/cjs/_virtual/index4.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index4.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;"}

package/dist/cjs/_virtual/index5.js

@@ -0,0 +1,6 @@
+'use strict';
+
+var colorString = {exports: {}};
+
+exports.__module = colorString;
+//# sourceMappingURL=index5.js.map

package/dist/cjs/_virtual/index5.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index5.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

package/dist/cjs/_virtual/index6.js

@@ -0,0 +1,6 @@
+'use strict';
+
+var simpleSwizzle = {exports: {}};
+
+exports.__module = simpleSwizzle;
+//# sourceMappingURL=index6.js.map

package/dist/cjs/_virtual/index6.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index6.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

package/dist/cjs/_virtual/ort-web.node.js

@@ -0,0 +1,12 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _commonjsHelpers = require('./_commonjsHelpers.js');
+var ortWeb_node$1 = require('../node_modules/onnxruntime-web/dist/ort-web.node.js');
+
+var ortWeb_nodeExports = ortWeb_node$1.__require();
+var ortWeb_node = /*@__PURE__*/_commonjsHelpers.getDefaultExportFromCjs(ortWeb_nodeExports);
+
+exports.default = ortWeb_node;
+//# sourceMappingURL=ort-web.node.js.map

package/dist/cjs/_virtual/ort-web.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ort-web.node.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;"}

package/dist/cjs/_virtual/ort-web.node2.js

@@ -0,0 +1,6 @@
+'use strict';
+
+var ortWeb_node = {};
+
+exports.__exports = ortWeb_node;
+//# sourceMappingURL=ort-web.node2.js.map

package/dist/cjs/_virtual/ort-web.node2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ort-web.node2.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

package/dist/cjs/_virtual/re.js

@@ -0,0 +1,6 @@
+'use strict';
+
+var re = {exports: {}};
+
+exports.__module = re;
+//# sourceMappingURL=re.js.map

package/dist/cjs/_virtual/re.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"re.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

package/dist/cjs/_virtual/sharp.js

@@ -0,0 +1,6 @@
+'use strict';
+
+var sharp = {exports: {}};
+
+exports.__module = sharp;
+//# sourceMappingURL=sharp.js.map

package/dist/cjs/_virtual/sharp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharp.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

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

@@ -1,4 +1,2 @@
-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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC"}

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

@@ -4,14 +4,17 @@ import { AgentLogger } from '../../infrastructure/logging/interfaces/AgentLogger
 import { Tool, Serializable } from '../tools/types/Tool';
 import { RunOptions } from './types/RunOptions';
 import { TSchema } from '@sinclair/typebox';
+import { RetrievalConfig } from '../retrieval/types/RetrievalConfig';
+import { SourceRegistry } from '../retrieval/SourceRegistry';
 export declare class Agent {
     private memoryManager;
-    private tools;
+    protected tools: Tool<any, any>[];
     private prompt;
     private executionEngine;
     private logger;
     private loggerUtils;
-    constructor(memoryManager?: MemoryManager, logger?: AgentLogger);
+    private retrievalConfig?;
+    constructor(memoryManager?: MemoryManager, logger?: AgentLogger, sourceRegistry?: SourceRegistry);
     addTool<TParams extends TSchema, TResult extends Serializable = string>(tool: Tool<TParams, TResult>): void;
     remember(message: string, type?: Memory['type'], importance?: number): void;
     getMemory(): Memory[];
@@ -19,6 +22,8 @@ export declare class Agent {
     getRelevantMemories(context: string, maxCount?: number): Memory[];
     setPrompt(prompt: string): void;
     getPrompt(): string;
+    setRetrievalConfig(config: RetrievalConfig): void;
+    getRetrievalConfig(): RetrievalConfig | undefined;
     run(message: string, model: ModelAdapter, options?: RunOptions): Promise<string>;
     private _executeDecisionCycle;
 }

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

@@ -1 +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"}
+{"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;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,qBAAa,KAAK;IAChB,OAAO,CAAC,aAAa,CAAgB;IACrC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAM;IACvC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,eAAe,CAAC,CAAkB;gBAGxC,aAAa,CAAC,EAAE,aAAa,EAC7B,MAAM,CAAC,EAAE,WAAW,EACpB,cAAc,CAAC,EAAE,cAAc;IAQjC,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;IAInB,kBAAkB,CAAC,MAAM,EAAE,eAAe;IAI1C,kBAAkB,IAAI,eAAe,GAAG,SAAS;IAI3C,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC;YAY5E,qBAAqB;CAmDpC"}

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

@@ -6,12 +6,12 @@ var defaultLoggers = require('../../infrastructure/logging/implementations/defau
 var loggerUtils = require('../../infrastructure/logging/utils/loggerUtils.js');
 
 class Agent {
-    constructor(memoryManager, logger) {
+    constructor(memoryManager, logger, sourceRegistry) {
         this.tools = [];
         this.prompt = '';
         this.memoryManager = memoryManager || new memory.SlidingWindowMemoryManager();
         this.logger = logger || defaultLoggers.createDefaultLogger();
-        this.executionEngine = new ExecutionEngine.ExecutionEngine(this.logger);
+        this.executionEngine = new ExecutionEngine.ExecutionEngine(this.logger, sourceRegistry);
         this.loggerUtils = new loggerUtils.LoggerUtils(this.logger);
     }
     addTool(tool) {
@@ -40,6 +40,12 @@ class Agent {
     getPrompt() {
         return this.prompt;
     }
+    setRetrievalConfig(config) {
+        this.retrievalConfig = config;
+    }
+    getRetrievalConfig() {
+        return this.retrievalConfig;
+    }
     async run(message, model, options = {}) {
         this.loggerUtils.logRunStart({
             message: message.substring(0, 50) + '...',
@@ -69,6 +75,7 @@ class Agent {
                 systemPrompt: this.prompt,
                 model,
                 options,
+                retrieval: this.retrievalConfig,
             };
             // Delegate to execution engine
             const result = await this.executionEngine.execute(executionContext);

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

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

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

@@ -1,3 +1,4 @@
+import { RetrievalConfig } from '../../retrieval/types/RetrievalConfig';
 export interface AgentMetadata {
     /**
      * Unique identifier for the agent
@@ -50,5 +51,9 @@ export interface AgentCapability {
 export interface AgentRegistration {
     metadata: AgentMetadata;
     capabilities: AgentCapability;
+    /**
+     * Optional retrieval configuration for RAG
+     */
+    retrieval?: RetrievalConfig;
 }
 //# sourceMappingURL=AgentMetadata.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"AgentMetadata.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/types/AgentMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAExE,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;IAE9B;;OAEG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B"}