agente-toolkit 0.2.0 → 0.3.0

package/README.md

@@ -26,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
 
@@ -350,10 +351,10 @@ const manager = new ManagerAgent(new ClaudeAdapter(process.env.ANTHROPIC_API_KEY
 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)
+- 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)
+Reference: [CHANGELOG](./CHANGELOG.md) · [CONTRIBUTING](./CONTRIBUTING.md) · [SECURITY](./SECURITY.md) · [LOGGING](./LOGGING.md) · [Examples](./examples/README.md) · [RAG Example](./examples/rag-example.md)
 
 ## 🤝 Contributing
 

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/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"}

package/dist/cjs/core/execution/ExecutionEngine.d.ts

@@ -2,6 +2,8 @@ import { ModelAdapter } from '../../infrastructure/adapters/base/base';
 import { AgentLogger } from '../../infrastructure/logging/interfaces/AgentLogger';
 import { Tool } from '../tools/types/Tool';
 import { RunOptions } from '../agent/types/RunOptions';
+import { RetrievalConfig } from '../retrieval/types/RetrievalConfig';
+import { SourceRegistry } from '../retrieval/SourceRegistry';
 /**
  * Context for execution requests
  */
@@ -12,6 +14,7 @@ export interface ExecutionContext {
     systemPrompt: string;
     model: ModelAdapter;
     options: RunOptions;
+    retrieval?: RetrievalConfig;
 }
 /**
  * Handles execution decisions and orchestration between native and planned execution
@@ -21,9 +24,10 @@ export declare class ExecutionEngine {
     private responseProcessor;
     private logger;
     private loggerUtils;
+    private retrievalAugmentor?;
     private _currentExecutionId?;
     private _currentExecutionStartTime?;
-    constructor(logger?: AgentLogger);
+    constructor(logger?: AgentLogger, sourceRegistry?: SourceRegistry);
     /**
      * Execute a request using the most appropriate method (native or planned)
      */

package/dist/cjs/core/execution/ExecutionEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExecutionEngine.d.ts","sourceRoot":"","sources":["../../../../src/core/execution/ExecutionEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAGvE,OAAO,EAAE,WAAW,EAAE,MAAM,qDAAqD,CAAC;AAGlF,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAOvD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,UAAU,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,iBAAiB,CAA2B;IACpD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,WAAW,CAAc;IAGjC,OAAO,CAAC,mBAAmB,CAAC,CAAS;IACrC,OAAO,CAAC,0BAA0B,CAAC,CAAS;gBAEhC,MAAM,CAAC,EAAE,WAAW;IAMhC;;OAEG;IAEG,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAezD;;OAEG;YAEW,mBAAmB;IA2BjC;;OAEG;YAEW,eAAe;IAqB7B;;OAEG;IACH,OAAO,CAAC,YAAY;CAerB"}
+{"version":3,"file":"ExecutionEngine.d.ts","sourceRoot":"","sources":["../../../../src/core/execution/ExecutionEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAGvE,OAAO,EAAE,WAAW,EAAE,MAAM,qDAAqD,CAAC;AAGlF,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAMvD,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,UAAU,CAAC;IACpB,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,iBAAiB,CAA2B;IACpD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,kBAAkB,CAAC,CAAqB;IAGhD,OAAO,CAAC,mBAAmB,CAAC,CAAS;IACrC,OAAO,CAAC,0BAA0B,CAAC,CAAS;gBAEhC,MAAM,CAAC,EAAE,WAAW,EAAE,cAAc,CAAC,EAAE,cAAc;IAUjE;;OAEG;IAEG,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAezD;;OAEG;YAEW,mBAAmB;IA2BjC;;OAEG;YAEW,eAAe;IAqB7B;;OAEG;YACW,YAAY;CAkD3B"}

package/dist/cjs/core/execution/ExecutionEngine.js

@@ -7,16 +7,20 @@ var defaultLoggers = require('../../infrastructure/logging/implementations/defau
 var loggerUtils = require('../../infrastructure/logging/utils/loggerUtils.js');
 var monitoring = require('../../infrastructure/monitoring/decorators/monitoring.js');
 var fallbackMonitoring = require('../../infrastructure/monitoring/decorators/fallbackMonitoring.js');
+var RetrievalAugmentor = require('../retrieval/RetrievalAugmentor.js');
 
 /**
  * Handles execution decisions and orchestration between native and planned execution
  */
 class ExecutionEngine {
-    constructor(logger) {
+    constructor(logger, sourceRegistry) {
         this.responseProcessor = new ResponseProcessor.ResponseProcessor();
         this.logger = logger || defaultLoggers.createDefaultLogger();
         this.loggerUtils = new loggerUtils.LoggerUtils(this.logger);
         this.planner = new Planner.Planner(this.logger);
+        if (sourceRegistry) {
+            this.retrievalAugmentor = new RetrievalAugmentor.RetrievalAugmentor(sourceRegistry);
+        }
     }
     /**
      * Execute a request using the most appropriate method (native or planned)
@@ -42,9 +46,9 @@ class ExecutionEngine {
      */
     async _tryNativeExecution(context) {
         var _a;
-        const { message, tools, memoryContext, systemPrompt, model } = context;
-        // Build the full prompt with context
-        const fullPrompt = this._buildPrompt(message, memoryContext, systemPrompt);
+        const { message, tools, memoryContext, systemPrompt, model, retrieval } = context;
+        // Build the full prompt with context (and retrieval if configured)
+        const fullPrompt = await this._buildPrompt(message, memoryContext, systemPrompt, retrieval);
         this.loggerUtils.logPrompt(fullPrompt, {
             userMessage: message,
             toolCount: tools.length,
@@ -75,8 +79,35 @@ class ExecutionEngine {
     /**
      * Build full prompt with context and system prompt
      */
-    _buildPrompt(message, memoryContext, systemPrompt) {
+    async _buildPrompt(message, memoryContext, systemPrompt, retrieval) {
         let fullPrompt = '';
+        // Apply retrieval augmentation if configured
+        if (retrieval && this.retrievalAugmentor) {
+            try {
+                this.logger.debug('Applying retrieval augmentation', {
+                    sources: retrieval.sources,
+                    maxDocuments: retrieval.maxDocuments,
+                });
+                // Augment returns the full prompt with system, context, and user message
+                fullPrompt = await this.retrievalAugmentor.augment(message, retrieval, systemPrompt);
+                // Add memory context after retrieval context
+                if (memoryContext && memoryContext !== 'No relevant context available.') {
+                    // Insert memory context before the user request
+                    const parts = fullPrompt.split('User request:');
+                    if (parts.length === 2) {
+                        fullPrompt = `${parts[0]}\nMemory context:\n${memoryContext}\n\nUser request:${parts[1]}`;
+                    }
+                }
+                return fullPrompt;
+            }
+            catch (error) {
+                this.logger.error('Retrieval augmentation failed, falling back to basic prompt', {
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                // Fall through to basic prompt building
+            }
+        }
+        // Basic prompt building (no retrieval)
         if (systemPrompt) {
             fullPrompt += `${systemPrompt}\n\n`;
         }

package/dist/cjs/core/execution/ExecutionEngine.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExecutionEngine.js","sources":["../../../../../src/core/execution/ExecutionEngine.ts"],"sourcesContent":[null],"names":["ResponseProcessor","createDefaultLogger","LoggerUtils","Planner","__decorate","withExecutionMonitoring","withFallbackMonitoring","withPlannedMonitoring"],"mappings":";;;;;;;;;;AA0BA;;AAEG;MACU,eAAe,CAAA;AAU1B,IAAA,WAAA,CAAY,MAAoB,EAAA;AARxB,QAAA,IAAA,CAAA,iBAAiB,GAAG,IAAIA,mCAAiB,EAAE;AASjD,QAAA,IAAI,CAAC,MAAM,GAAG,MAAM,IAAIC,kCAAmB,EAAE;QAC7C,IAAI,CAAC,WAAW,GAAG,IAAIC,uBAAW,CAAC,IAAI,CAAC,MAAM,CAAC;QAC/C,IAAI,CAAC,OAAO,GAAG,IAAIC,eAAO,CAAC,IAAI,CAAC,MAAM,CAAC;IACzC;AAEA;;AAEG;AAEG,IAAN,MAAM,OAAO,CAAC,OAAyB,EAAA;;AAErC,QAAA,IAAI,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE;YACrC,IAAI;AACF,gBAAA,OAAO,MAAM,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC;AAC/C,YAAA;AAAC,YAAA,OAAO,WAAW,EAAE;;AAEpB,gBAAA,OAAO,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;AAC3C,YAAA;AACF,QAAA;AAAM,aAAA;;AAEL,YAAA,OAAO,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;AAC3C,QAAA;IACH;AAEA;;AAEG;AAEW,IAAN,MAAM,mBAAmB,CAAC,OAAyB,EAAA;;AACzD,QAAA,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,OAAO;;AAGtE,QAAA,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,YAAY,CAAC;AAE1E,QAAA,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,UAAU,EAAE;AACrC,YAAA,WAAW,EAAE,OAAO;YACpB,SAAS,EAAE,KAAK,CAAC,MAAM;AACvB,YAAA,aAAa,EAAE,QAAQ;AACxB,SAAA,CAAC;QAEF,MAAM,eAAe,GAAG,MAAM,KAAK,CAAC,gBAAgB,CAAC,UAAU,EAAE,KAAK,CAAC;QAEvE,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,eAAe,CAAC,OAAO,EAAE;AACzD,YAAA,SAAS,EAAE,kBAAkB;AAC7B,YAAA,aAAa,EAAE,eAAe,CAAC,SAAS,CAAC,MAAM;YAC/C,OAAO,EAAE,eAAe,CAAC,OAAO;AACjC,SAAA,CAAC;QAEF,IAAI,eAAe,CAAC,OAAO,EAAE;YAC3B,OAAO,eAAe,CAAC,OAAO;AAC/B,QAAA;AAAM,aAAA;AACL,YAAA,MAAM,IAAI,KAAK,CAAC,CAAA,yBAAA,EAA4B,MAAA,eAAe,CAAC,MAAM,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAE,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE,CAAC;AAClF,QAAA;IACH;AAEA;;AAEG;AAEW,IAAN,MAAM,eAAe,CAAC,OAAyB,EAAA;AACrD,QAAA,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO;QAE/E,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAC1C,OAAO,EACP,KAAK,EACL,aAAa,EACb,YAAY,EACZ,KAAK,EACL,OAAO,CACR;;AAGD,QAAA,OAAO,IAAI,CAAC,iBAAiB,CAAC,8BAA8B,CAC1D,OAAO,EACP,SAAS,EACT,KAAK,EACL,YAAY,CACb;IACH;AAEA;;AAEG;AACK,IAAA,YAAY,CAAC,OAAe,EAAE,aAAqB,EAAE,YAAoB,EAAA;QAC/E,IAAI,UAAU,GAAG,EAAE;AAEnB,QAAA,IAAI,YAAY,EAAE;AAChB,YAAA,UAAU,IAAI,CAAA,EAAG,YAAY,CAAA,IAAA,CAAM;AACpC,QAAA;AAED,QAAA,IAAI,aAAa,IAAI,aAAa,KAAK,gCAAgC,EAAE;AACvE,YAAA,UAAU,IAAI,CAAA,mBAAA,EAAsB,aAAa,CAAA,IAAA,CAAM;AACxD,QAAA;AAED,QAAA,UAAU,IAAI,CAAA,cAAA,EAAiB,OAAO,CAAA,CAAE;AAExC,QAAA,OAAO,UAAU;IACnB;AACD;AAzFOC,oBAAA,CAAA;IADLC,kCAAuB;;;;AAcvB,CAAA,EAAA,eAAA,CAAA,SAAA,EAAA,SAAA,EAAA,IAAA,CAAA;AAMaD,oBAAA,CAAA;IADbE,yCAAsB;;;;AA0BtB,CAAA,EAAA,eAAA,CAAA,SAAA,EAAA,qBAAA,EAAA,IAAA,CAAA;AAMaF,oBAAA,CAAA;IADbG,wCAAqB;;;;AAoBrB,CAAA,EAAA,eAAA,CAAA,SAAA,EAAA,iBAAA,EAAA,IAAA,CAAA;;;;"}
+{"version":3,"file":"ExecutionEngine.js","sources":["../../../../../src/core/execution/ExecutionEngine.ts"],"sourcesContent":[null],"names":["ResponseProcessor","createDefaultLogger","LoggerUtils","Planner","RetrievalAugmentor","__decorate","withExecutionMonitoring","withFallbackMonitoring","withPlannedMonitoring"],"mappings":"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"}

package/dist/cjs/core/retrieval/RetrievalAugmentor.d.ts

@@ -0,0 +1,20 @@
+import { RetrievalConfig } from './types/RetrievalConfig';
+import { PromptComposer } from './interfaces/PromptComposer';
+import { SourceRegistry } from './SourceRegistry';
+/**
+ * Augments prompts with retrieved context from configured sources
+ */
+export declare class RetrievalAugmentor {
+    private sourceRegistry;
+    private promptComposer;
+    constructor(sourceRegistry: SourceRegistry, promptComposer?: PromptComposer);
+    /**
+     * Augment a prompt with retrieved context
+     * @param message The user message/query
+     * @param config Retrieval configuration
+     * @param systemPrompt Optional system prompt
+     * @returns Augmented prompt string
+     */
+    augment(message: string, config: RetrievalConfig, systemPrompt?: string): Promise<string>;
+}
+//# sourceMappingURL=RetrievalAugmentor.d.ts.map

package/dist/cjs/core/retrieval/RetrievalAugmentor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetrievalAugmentor.d.ts","sourceRoot":"","sources":["../../../../src/core/retrieval/RetrievalAugmentor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,cAAc,CAAiB;gBAE3B,cAAc,EAAE,cAAc,EAAE,cAAc,CAAC,EAAE,cAAc;IAK3E;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA2DhG"}

package/dist/cjs/core/retrieval/RetrievalAugmentor.js

@@ -0,0 +1,72 @@
+'use strict';
+
+var DefaultPromptComposer = require('./implementations/DefaultPromptComposer.js');
+
+/**
+ * Augments prompts with retrieved context from configured sources
+ */
+class RetrievalAugmentor {
+    constructor(sourceRegistry, promptComposer) {
+        this.sourceRegistry = sourceRegistry;
+        this.promptComposer = promptComposer || new DefaultPromptComposer.DefaultPromptComposer();
+    }
+    /**
+     * Augment a prompt with retrieved context
+     * @param message The user message/query
+     * @param config Retrieval configuration
+     * @param systemPrompt Optional system prompt
+     * @returns Augmented prompt string
+     */
+    async augment(message, config, systemPrompt) {
+        // Retrieve from all configured sources
+        const allDocuments = [];
+        for (const sourceId of config.sources) {
+            const retriever = this.sourceRegistry.getRetriever(sourceId);
+            const sourceConfig = this.sourceRegistry.getConfig(sourceId);
+            if (!retriever) {
+                console.warn(`Retrieval source '${sourceId}' not found in registry, skipping`);
+                continue;
+            }
+            try {
+                const docs = await retriever.retrieve(message, {
+                    topK: sourceConfig === null || sourceConfig === void 0 ? void 0 : sourceConfig.topK,
+                    minScore: sourceConfig === null || sourceConfig === void 0 ? void 0 : sourceConfig.minScore,
+                    filters: sourceConfig === null || sourceConfig === void 0 ? void 0 : sourceConfig.filters,
+                });
+                allDocuments.push(...docs);
+            }
+            catch (error) {
+                console.error(`Error retrieving from source '${sourceId}':`, error);
+            }
+        }
+        // Sort by score and deduplicate if needed
+        allDocuments.sort((a, b) => b.score - a.score);
+        if (config.deduplicate) {
+            const seen = new Set();
+            const deduplicated = [];
+            for (const doc of allDocuments) {
+                const key = doc.content.trim();
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    deduplicated.push(doc);
+                }
+            }
+            allDocuments.length = 0;
+            allDocuments.push(...deduplicated);
+        }
+        // Apply max documents limit
+        const maxDocs = config.maxDocuments || 10;
+        const finalDocuments = allDocuments.slice(0, maxDocs);
+        // Compose augmented prompt
+        const result = this.promptComposer.compose(message, finalDocuments, systemPrompt);
+        // For now, we only support string output (can be extended for Message[] later)
+        if (typeof result === 'string') {
+            return result;
+        }
+        // If composer returns messages, flatten to string
+        return result.map(m => `${m.role}: ${m.content}`).join('\n');
+    }
+}
+
+exports.RetrievalAugmentor = RetrievalAugmentor;
+//# sourceMappingURL=RetrievalAugmentor.js.map

package/dist/cjs/core/retrieval/RetrievalAugmentor.js.map

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