@hazeljs/rag 0.2.0-alpha.1

package/dist/agentic/agentic-rag.service.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * Agentic RAG Service
+ * Main service class demonstrating all agentic RAG capabilities
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgenticRAGService = void 0;
+const decorators_1 = require("./decorators");
+class AgenticRAGService {
+    constructor(config) {
+        this.vectorStore = config.vectorStore;
+        this.llmProvider = config.llmProvider;
+    }
+    /**
+     * Basic retrieval with all agentic features
+     */
+    async retrieve(query, options) {
+        return this.vectorStore.search(query, options);
+    }
+    /**
+     * Advanced retrieval with HyDE
+     */
+    async hydeRetrieve(query, options) {
+        return this.vectorStore.search(query, options);
+    }
+    /**
+     * Multi-hop reasoning retrieval
+     */
+    async deepRetrieve(query, options) {
+        return this.vectorStore.search(query, options);
+    }
+    /**
+     * Context-aware conversational retrieval
+     */
+    async conversationalRetrieve(query, sessionId, options) {
+        return this.vectorStore.search(query, {
+            ...options,
+            sessionId: sessionId,
+        });
+    }
+    /**
+     * Verified retrieval with source checking
+     */
+    async verifiedRetrieve(query, options) {
+        return this.vectorStore.search(query, options);
+    }
+    /**
+     * Learning-enabled retrieval
+     */
+    async learningRetrieve(query, options) {
+        return this.vectorStore.search(query, options);
+    }
+    /**
+     * Provide feedback for active learning
+     */
+    async provideFeedback(_resultId, _rating, _relevant) {
+        // Feedback is stored by decorator
+    }
+    /**
+     * Combined: All features enabled
+     */
+    async superRetrieve(query, sessionId, options) {
+        return this.vectorStore.search(query, {
+            ...options,
+            sessionId: sessionId,
+        });
+    }
+}
+exports.AgenticRAGService = AgenticRAGService;
+__decorate([
+    (0, decorators_1.QueryPlanner)({ decompose: true, maxSubQueries: 5, parallel: true }),
+    (0, decorators_1.SelfReflective)({ maxIterations: 3, qualityThreshold: 0.8 }),
+    (0, decorators_1.AdaptiveRetrieval)({ autoSelect: true, contextAware: true }),
+    (0, decorators_1.Cached)({ ttl: 3600 }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object]),
+    __metadata("design:returntype", Promise)
+], AgenticRAGService.prototype, "retrieve", null);
+__decorate([
+    (0, decorators_1.HyDE)({ generateHypothesis: true, numHypotheses: 3 }),
+    (0, decorators_1.CorrectiveRAG)({ relevanceThreshold: 0.7, fallbackToWeb: true }),
+    (0, decorators_1.Cached)({ ttl: 1800 }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object]),
+    __metadata("design:returntype", Promise)
+], AgenticRAGService.prototype, "hydeRetrieve", null);
+__decorate([
+    (0, decorators_1.MultiHop)({ maxHops: 3, strategy: 'breadth-first' }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object]),
+    __metadata("design:returntype", Promise)
+], AgenticRAGService.prototype, "deepRetrieve", null);
+__decorate([
+    (0, decorators_1.ContextAware)({ windowSize: 5, entityTracking: true, topicModeling: true }),
+    (0, decorators_1.QueryRewriter)({ techniques: ['expansion', 'synonym'], llmBased: true }),
+    (0, decorators_1.Cached)({ ttl: 600 }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, Object]),
+    __metadata("design:returntype", Promise)
+], AgenticRAGService.prototype, "conversationalRetrieve", null);
+__decorate([
+    (0, decorators_1.SourceVerification)({
+        checkFreshness: true,
+        verifyAuthority: true,
+        requireCitations: true,
+    }),
+    (0, decorators_1.SelfReflective)({ maxIterations: 2, qualityThreshold: 0.85 }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object]),
+    __metadata("design:returntype", Promise)
+], AgenticRAGService.prototype, "verifiedRetrieve", null);
+__decorate([
+    (0, decorators_1.ActiveLearning)({ feedbackEnabled: true, retrainThreshold: 100 }),
+    (0, decorators_1.AdaptiveRetrieval)({ autoSelect: true }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object]),
+    __metadata("design:returntype", Promise)
+], AgenticRAGService.prototype, "learningRetrieve", null);
+__decorate([
+    (0, decorators_1.Feedback)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Number, Boolean]),
+    __metadata("design:returntype", Promise)
+], AgenticRAGService.prototype, "provideFeedback", null);
+__decorate([
+    (0, decorators_1.QueryPlanner)({ decompose: true, maxSubQueries: 5 }),
+    (0, decorators_1.SelfReflective)({ maxIterations: 3, qualityThreshold: 0.8 }),
+    (0, decorators_1.AdaptiveRetrieval)({ autoSelect: true, contextAware: true }),
+    (0, decorators_1.HyDE)({ generateHypothesis: true, numHypotheses: 2 }),
+    (0, decorators_1.CorrectiveRAG)({ relevanceThreshold: 0.7 }),
+    (0, decorators_1.ContextAware)({ windowSize: 5, entityTracking: true }),
+    (0, decorators_1.QueryRewriter)({ techniques: ['expansion', 'synonym'] }),
+    (0, decorators_1.SourceVerification)({ checkFreshness: true, verifyAuthority: true }),
+    (0, decorators_1.ActiveLearning)({ feedbackEnabled: true }),
+    (0, decorators_1.Cached)({ ttl: 3600 }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, Object]),
+    __metadata("design:returntype", Promise)
+], AgenticRAGService.prototype, "superRetrieve", null);
+//# sourceMappingURL=agentic-rag.service.js.map

package/dist/agentic/agentic-rag.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentic-rag.service.js","sourceRoot":"","sources":["../../src/agentic/agentic-rag.service.ts"],"names":[],"mappings":"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"}

package/dist/agentic/decorators/active-learning.decorator.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Active Learning Decorator
+ * Learns from user feedback to improve retrieval
+ */
+import 'reflect-metadata';
+export interface ActiveLearningConfig {
+    feedbackEnabled?: boolean;
+    retrainThreshold?: number;
+    storageKey?: string;
+}
+export declare function ActiveLearning(config?: ActiveLearningConfig): MethodDecorator;
+export declare function Feedback(): MethodDecorator;
+export declare function getFeedbackStats(storageKey?: string): {
+    totalFeedback: number;
+    avgRating: number;
+    relevantCount: number;
+};
+export declare function clearFeedback(storageKey?: string): void;
+//# sourceMappingURL=active-learning.decorator.d.ts.map

package/dist/agentic/decorators/active-learning.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-learning.decorator.d.ts","sourceRoot":"","sources":["../../../src/agentic/decorators/active-learning.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAG1B,MAAM,WAAW,oBAAoB;IACnC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,wBAAgB,cAAc,CAAC,MAAM,GAAE,oBAAyB,GAAG,eAAe,CAmBjF;AAED,wBAAgB,QAAQ,IAAI,eAAe,CAkB1C;AAqDD,wBAAgB,gBAAgB,CAAC,UAAU,GAAE,MAAkB,GAAG;IAChE,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB,CAeA;AAED,wBAAgB,aAAa,CAAC,UAAU,GAAE,MAAkB,GAAG,IAAI,CAElE"}

package/dist/agentic/decorators/active-learning.decorator.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * Active Learning Decorator
+ * Learns from user feedback to improve retrieval
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActiveLearning = ActiveLearning;
+exports.Feedback = Feedback;
+exports.getFeedbackStats = getFeedbackStats;
+exports.clearFeedback = clearFeedback;
+require("reflect-metadata");
+const feedbackStore = new Map();
+function ActiveLearning(config = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const results = await originalMethod.apply(this, args);
+            if (!config.feedbackEnabled) {
+                return results;
+            }
+            // Apply learned adjustments
+            const adjusted = applyLearning(results, config);
+            return adjusted;
+        };
+        return descriptor;
+    };
+}
+function Feedback() {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const feedbackData = args[0];
+            // Store feedback
+            storeFeedback(feedbackData);
+            // Execute original method if any
+            if (originalMethod) {
+                return originalMethod.apply(this, args);
+            }
+        };
+        return descriptor;
+    };
+}
+function applyLearning(results, config) {
+    if (!Array.isArray(results)) {
+        return results;
+    }
+    const storageKey = config.storageKey || 'default';
+    const feedback = feedbackStore.get(storageKey) || [];
+    if (feedback.length === 0) {
+        return results;
+    }
+    // Adjust scores based on feedback
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return results
+        .map((result) => {
+        const relevantFeedback = feedback.filter((f) => f.resultId === result.id);
+        if (relevantFeedback.length === 0) {
+            return result;
+        }
+        const avgRating = relevantFeedback.reduce((sum, f) => sum + f.rating, 0) / relevantFeedback.length;
+        const relevanceBoost = (avgRating - 3) / 5; // Normalize to -0.4 to 0.4
+        return {
+            ...result,
+            score: Math.max(0, Math.min(1, (result.score || 0.5) + relevanceBoost)),
+            feedbackCount: relevantFeedback.length,
+            avgRating,
+        };
+    })
+        .sort((a, b) => (b.score || 0) - (a.score || 0));
+}
+function storeFeedback(feedback) {
+    const storageKey = 'default';
+    const existing = feedbackStore.get(storageKey) || [];
+    existing.push(feedback);
+    // Keep only recent feedback
+    const maxFeedback = 1000;
+    if (existing.length > maxFeedback) {
+        existing.splice(0, existing.length - maxFeedback);
+    }
+    feedbackStore.set(storageKey, existing);
+}
+function getFeedbackStats(storageKey = 'default') {
+    const feedback = feedbackStore.get(storageKey) || [];
+    if (feedback.length === 0) {
+        return { totalFeedback: 0, avgRating: 0, relevantCount: 0 };
+    }
+    const avgRating = feedback.reduce((sum, f) => sum + f.rating, 0) / feedback.length;
+    const relevantCount = feedback.filter((f) => f.relevant).length;
+    return {
+        totalFeedback: feedback.length,
+        avgRating,
+        relevantCount,
+    };
+}
+function clearFeedback(storageKey = 'default') {
+    feedbackStore.delete(storageKey);
+}
+//# sourceMappingURL=active-learning.decorator.js.map

package/dist/agentic/decorators/active-learning.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-learning.decorator.js","sourceRoot":"","sources":["../../../src/agentic/decorators/active-learning.decorator.ts"],"names":[],"mappings":"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"}

package/dist/agentic/decorators/adaptive-retrieval.decorator.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Adaptive Retrieval Decorator
+ * Automatically selects the best retrieval strategy
+ */
+import 'reflect-metadata';
+import { AdaptiveStrategyResult, AgenticLLMProvider } from '../types';
+import { RetrievalStrategy } from '../../types';
+import '../../prompts/agentic/adaptive-retrieval.prompt';
+export interface AdaptiveRetrievalConfig {
+    strategies?: RetrievalStrategy[];
+    autoSelect?: boolean;
+    contextAware?: boolean;
+    llmProvider?: AgenticLLMProvider;
+}
+export declare function AdaptiveRetrieval(config?: AdaptiveRetrievalConfig): MethodDecorator;
+export declare function getAdaptiveStrategy(target: object, propertyKey: string | symbol): AdaptiveStrategyResult | undefined;
+//# sourceMappingURL=adaptive-retrieval.decorator.d.ts.map

package/dist/agentic/decorators/adaptive-retrieval.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive-retrieval.decorator.d.ts","sourceRoot":"","sources":["../../../src/agentic/decorators/adaptive-retrieval.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,iDAAiD,CAAC;AAGzD,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC;AAID,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,uBAA4B,GAAG,eAAe,CA4BvF;AA0FD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,sBAAsB,GAAG,SAAS,CAEpC"}

package/dist/agentic/decorators/adaptive-retrieval.decorator.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * Adaptive Retrieval Decorator
+ * Automatically selects the best retrieval strategy
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdaptiveRetrieval = AdaptiveRetrieval;
+exports.getAdaptiveStrategy = getAdaptiveStrategy;
+require("reflect-metadata");
+const types_1 = require("../../types");
+const prompts_1 = require("@hazeljs/prompts");
+require("../../prompts/agentic/adaptive-retrieval.prompt");
+const adaptive_retrieval_prompt_1 = require("../../prompts/agentic/adaptive-retrieval.prompt");
+const ADAPTIVE_METADATA_KEY = Symbol('adaptive');
+function AdaptiveRetrieval(config = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const query = args[0];
+            if (!config.autoSelect) {
+                return originalMethod.apply(this, args);
+            }
+            // Select best strategy
+            const strategyResult = await selectStrategy(query, config);
+            // Store metadata
+            Reflect.defineMetadata(ADAPTIVE_METADATA_KEY, strategyResult, target, propertyKey);
+            // Execute with selected strategy
+            const modifiedArgs = [...args];
+            if (modifiedArgs[1] && typeof modifiedArgs[1] === 'object') {
+                modifiedArgs[1] = { ...modifiedArgs[1], strategy: strategyResult.selectedStrategy };
+            }
+            return originalMethod.apply(this, modifiedArgs);
+        };
+        return descriptor;
+    };
+}
+async function selectStrategy(query, config) {
+    const strategies = config.strategies || [
+        types_1.RetrievalStrategy.SIMILARITY,
+        types_1.RetrievalStrategy.HYBRID,
+        types_1.RetrievalStrategy.MMR,
+    ];
+    if (config.llmProvider) {
+        return selectStrategyWithLLM(query, strategies, config);
+    }
+    return selectStrategyHeuristic(query, strategies);
+}
+async function selectStrategyWithLLM(query, strategies, config) {
+    const prompt = prompts_1.PromptRegistry.get(adaptive_retrieval_prompt_1.ADAPTIVE_RETRIEVAL_KEY).render({ query });
+    try {
+        const result = await config.llmProvider.generateStructured(prompt, {});
+        return {
+            ...result,
+            alternatives: strategies
+                .filter((s) => s !== result.selectedStrategy)
+                .map((s) => ({ strategy: s, score: 0.5 })),
+        };
+    }
+    catch {
+        return selectStrategyHeuristic(query, strategies);
+    }
+}
+function selectStrategyHeuristic(query, strategies) {
+    const lowerQuery = query.toLowerCase();
+    // Check for diversity needs
+    if (lowerQuery.includes('different') ||
+        lowerQuery.includes('various') ||
+        lowerQuery.includes('diverse')) {
+        return {
+            selectedStrategy: types_1.RetrievalStrategy.MMR,
+            reason: 'Query requires diverse results',
+            confidence: 0.8,
+            alternatives: strategies
+                .filter((s) => s !== types_1.RetrievalStrategy.MMR)
+                .map((s) => ({ strategy: s, score: 0.5 })),
+        };
+    }
+    // Check for keyword-heavy queries
+    const hasSpecificTerms = /\b(exact|specific|precise|"[^"]+")/.test(query);
+    if (hasSpecificTerms) {
+        return {
+            selectedStrategy: types_1.RetrievalStrategy.HYBRID,
+            reason: 'Query contains specific terms requiring keyword matching',
+            confidence: 0.85,
+            alternatives: strategies
+                .filter((s) => s !== types_1.RetrievalStrategy.HYBRID)
+                .map((s) => ({ strategy: s, score: 0.6 })),
+        };
+    }
+    // Default to similarity
+    return {
+        selectedStrategy: types_1.RetrievalStrategy.SIMILARITY,
+        reason: 'General semantic search',
+        confidence: 0.7,
+        alternatives: strategies
+            .filter((s) => s !== types_1.RetrievalStrategy.SIMILARITY)
+            .map((s) => ({ strategy: s, score: 0.5 })),
+    };
+}
+function getAdaptiveStrategy(target, propertyKey) {
+    return Reflect.getMetadata(ADAPTIVE_METADATA_KEY, target, propertyKey);
+}
+//# sourceMappingURL=adaptive-retrieval.decorator.js.map

package/dist/agentic/decorators/adaptive-retrieval.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive-retrieval.decorator.js","sourceRoot":"","sources":["../../../src/agentic/decorators/adaptive-retrieval.decorator.ts"],"names":[],"mappings":"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"}

package/dist/agentic/decorators/cached.decorator.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Cached Decorator
+ * Caches retrieval results for performance
+ */
+import 'reflect-metadata';
+export interface CachedConfig {
+    ttl?: number;
+    maxSize?: number;
+    keyGenerator?: (args: unknown[]) => string;
+}
+export declare function Cached(config?: CachedConfig): MethodDecorator;
+export declare function getCacheStats(): {
+    size: number;
+    totalHits: number;
+    hitRate: number;
+};
+export declare function clearCache(): void;
+//# sourceMappingURL=cached.decorator.d.ts.map

package/dist/agentic/decorators/cached.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached.decorator.d.ts","sourceRoot":"","sources":["../../../src/agentic/decorators/cached.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAG1B,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC;CAC5C;AAKD,wBAAgB,MAAM,CAAC,MAAM,GAAE,YAAiB,GAAG,eAAe,CA4CjE;AAmCD,wBAAgB,aAAa,IAAI;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAcA;AAED,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}

package/dist/agentic/decorators/cached.decorator.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * Cached Decorator
+ * Caches retrieval results for performance
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Cached = Cached;
+exports.getCacheStats = getCacheStats;
+exports.clearCache = clearCache;
+require("reflect-metadata");
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const cache = new Map();
+function Cached(config = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        const ttl = (config.ttl || 3600) * 1000; // Convert to ms
+        const maxSize = config.maxSize || 100;
+        descriptor.value = async function (...args) {
+            // Generate cache key
+            const key = config.keyGenerator
+                ? config.keyGenerator(args)
+                : generateCacheKey(propertyKey, args);
+            // Check cache
+            const cached = cache.get(key);
+            if (cached && !isExpired(cached)) {
+                cached.hits++;
+                return cached.value;
+            }
+            // Execute method
+            const result = await originalMethod.apply(this, args);
+            // Store in cache
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const entry = {
+                key,
+                value: result,
+                timestamp: Date.now(),
+                ttl,
+                hits: 0,
+            };
+            cache.set(key, entry);
+            // Enforce max size
+            if (cache.size > maxSize) {
+                evictLRU();
+            }
+            return result;
+        };
+        return descriptor;
+    };
+}
+function generateCacheKey(method, args) {
+    const argsStr = JSON.stringify(args);
+    return `${String(method)}:${argsStr}`;
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function isExpired(entry) {
+    return Date.now() - entry.timestamp > entry.ttl;
+}
+function evictLRU() {
+    let oldestKey = null;
+    let oldestTime = Infinity;
+    let lowestHits = Infinity;
+    for (const [key, entry] of cache.entries()) {
+        if (isExpired(entry)) {
+            cache.delete(key);
+            continue;
+        }
+        if (entry.hits < lowestHits || (entry.hits === lowestHits && entry.timestamp < oldestTime)) {
+            oldestKey = key;
+            oldestTime = entry.timestamp;
+            lowestHits = entry.hits;
+        }
+    }
+    if (oldestKey) {
+        cache.delete(oldestKey);
+    }
+}
+function getCacheStats() {
+    let totalHits = 0;
+    let totalRequests = 0;
+    for (const entry of cache.values()) {
+        totalHits += entry.hits;
+        totalRequests += entry.hits + 1; // +1 for initial miss
+    }
+    return {
+        size: cache.size,
+        totalHits,
+        hitRate: totalRequests > 0 ? totalHits / totalRequests : 0,
+    };
+}
+function clearCache() {
+    cache.clear();
+}
+//# sourceMappingURL=cached.decorator.js.map

package/dist/agentic/decorators/cached.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached.decorator.js","sourceRoot":"","sources":["../../../src/agentic/decorators/cached.decorator.ts"],"names":[],"mappings":"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"}

package/dist/agentic/decorators/context-aware.decorator.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Context-Aware Decorator
+ * Maintains conversation context for improved retrieval
+ */
+import 'reflect-metadata';
+import { Context } from '../types';
+export interface ContextAwareConfig {
+    windowSize?: number;
+    entityTracking?: boolean;
+    topicModeling?: boolean;
+    sessionId?: string;
+}
+export declare function ContextAware(config?: ContextAwareConfig): MethodDecorator;
+export declare function getContext(target: object, propertyKey: string | symbol): Context | undefined;
+export declare function clearContext(sessionId: string): void;
+//# sourceMappingURL=context-aware.decorator.d.ts.map

package/dist/agentic/decorators/context-aware.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-aware.decorator.d.ts","sourceRoot":"","sources":["../../../src/agentic/decorators/context-aware.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAiB,MAAM,UAAU,CAAC;AAElD,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD,wBAAgB,YAAY,CAAC,MAAM,GAAE,kBAAuB,GAAG,eAAe,CA0E7E;AA0GD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAE5F;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAEpD"}