@hazeljs/rag 0.2.0-alpha.1

package/dist/agentic/decorators/context-aware.decorator.js

@@ -0,0 +1,169 @@
+"use strict";
+/**
+ * Context-Aware Decorator
+ * Maintains conversation context for improved retrieval
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextAware = ContextAware;
+exports.getContext = getContext;
+exports.clearContext = clearContext;
+require("reflect-metadata");
+const CONTEXT_METADATA_KEY = Symbol('contextAware');
+const contextStore = new Map();
+function ContextAware(config = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const query = args[0];
+            const sessionId = (typeof args[1] === 'object' && args[1] !== null && 'sessionId' in args[1]
+                ? args[1].sessionId
+                : undefined) ||
+                config.sessionId ||
+                'default';
+            // Get or create context
+            let context = contextStore.get(sessionId);
+            if (!context) {
+                context = {
+                    sessionId,
+                    conversationHistory: [],
+                    entities: [],
+                    topics: [],
+                    metadata: {},
+                };
+                contextStore.set(sessionId, context);
+            }
+            // Update context with current query
+            context.conversationHistory.push({
+                role: 'user',
+                content: query,
+                timestamp: new Date(),
+            });
+            // Maintain window size
+            const windowSize = config.windowSize || 5;
+            if (context.conversationHistory.length > windowSize * 2) {
+                context.conversationHistory = context.conversationHistory.slice(-windowSize * 2);
+            }
+            // Extract entities if enabled
+            if (config.entityTracking) {
+                const entities = extractEntities(query);
+                updateEntities(context, entities);
+            }
+            // Extract topics if enabled
+            if (config.topicModeling) {
+                const topics = extractTopics(query, context);
+                updateTopics(context, topics);
+            }
+            // Enhance query with context
+            const enhancedQuery = enhanceQueryWithContext(query, context);
+            // Execute with enhanced query
+            const modifiedArgs = [enhancedQuery, ...args.slice(1)];
+            const results = await originalMethod.apply(this, modifiedArgs);
+            // Store assistant response in context
+            if (results) {
+                context.conversationHistory.push({
+                    role: 'assistant',
+                    content: JSON.stringify(results).slice(0, 500),
+                    timestamp: new Date(),
+                });
+            }
+            Reflect.defineMetadata(CONTEXT_METADATA_KEY, context, target, propertyKey);
+            return results;
+        };
+        return descriptor;
+    };
+}
+function extractEntities(text) {
+    const entities = [];
+    // Simple named entity extraction (capitalized words)
+    const words = text.split(/\s+/);
+    const capitalizedWords = words.filter((w) => /^[A-Z][a-z]+/.test(w));
+    const entityCounts = new Map();
+    capitalizedWords.forEach((word) => {
+        entityCounts.set(word, (entityCounts.get(word) || 0) + 1);
+    });
+    entityCounts.forEach((count, name) => {
+        entities.push({
+            name,
+            type: 'UNKNOWN',
+            mentions: count,
+            lastSeen: new Date(),
+            attributes: {},
+        });
+    });
+    return entities;
+}
+function updateEntities(context, newEntities) {
+    newEntities.forEach((newEntity) => {
+        const existing = context.entities.find((e) => e.name === newEntity.name);
+        if (existing) {
+            existing.mentions += newEntity.mentions;
+            existing.lastSeen = new Date();
+        }
+        else {
+            context.entities.push(newEntity);
+        }
+    });
+    // Keep only recent entities
+    context.entities = context.entities
+        .sort((a, b) => b.lastSeen.getTime() - a.lastSeen.getTime())
+        .slice(0, 20);
+}
+function extractTopics(query, _context) {
+    const topics = [];
+    // Extract keywords
+    const words = query.toLowerCase().split(/\s+/);
+    const stopWords = new Set(['the', 'a', 'an', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for']);
+    const keywords = words.filter((w) => w.length > 3 && !stopWords.has(w));
+    // Group into topics
+    const topicMap = new Map();
+    keywords.forEach((keyword) => {
+        const topic = keyword.slice(0, 5); // Simple topic grouping
+        if (!topicMap.has(topic)) {
+            topicMap.set(topic, []);
+        }
+        topicMap.get(topic).push(keyword);
+    });
+    topicMap.forEach((keywords, name) => {
+        topics.push({
+            name,
+            relevance: keywords.length / words.length,
+            keywords,
+        });
+    });
+    return topics;
+}
+function updateTopics(context, newTopics) {
+    newTopics.forEach((newTopic) => {
+        const existing = context.topics.find((t) => t.name === newTopic.name);
+        if (existing) {
+            existing.relevance = (existing.relevance + newTopic.relevance) / 2;
+            existing.keywords = [...new Set([...existing.keywords, ...newTopic.keywords])];
+        }
+        else {
+            context.topics.push(newTopic);
+        }
+    });
+    // Keep top topics
+    context.topics = context.topics.sort((a, b) => b.relevance - a.relevance).slice(0, 10);
+}
+function enhanceQueryWithContext(query, context) {
+    const enhancements = [query];
+    // Add recent entities
+    const topEntities = context.entities.slice(0, 3).map((e) => e.name);
+    if (topEntities.length > 0) {
+        enhancements.push(`Context entities: ${topEntities.join(', ')}`);
+    }
+    // Add recent topics
+    const topTopics = context.topics.slice(0, 2).map((t) => t.keywords[0]);
+    if (topTopics.length > 0) {
+        enhancements.push(`Related topics: ${topTopics.join(', ')}`);
+    }
+    return enhancements.join(' | ');
+}
+function getContext(target, propertyKey) {
+    return Reflect.getMetadata(CONTEXT_METADATA_KEY, target, propertyKey);
+}
+function clearContext(sessionId) {
+    contextStore.delete(sessionId);
+}
+//# sourceMappingURL=context-aware.decorator.js.map

package/dist/agentic/decorators/context-aware.decorator.js.map

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

package/dist/agentic/decorators/corrective-rag.decorator.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Corrective RAG (CRAG) Decorator
+ * Self-corrects retrieval errors with fallback mechanisms
+ */
+import 'reflect-metadata';
+import { CorrectiveRAGResult, AgenticLLMProvider } from '../types';
+import '../../prompts/agentic/corrective-rag.prompt';
+export interface CorrectiveRAGConfig {
+    relevanceThreshold?: number;
+    fallbackToWeb?: boolean;
+    maxCorrections?: number;
+    llmProvider?: AgenticLLMProvider;
+}
+export declare function CorrectiveRAG(config?: CorrectiveRAGConfig): MethodDecorator;
+export declare function getCorrectiveRAGResult(target: object, propertyKey: string | symbol): CorrectiveRAGResult | undefined;
+//# sourceMappingURL=corrective-rag.decorator.d.ts.map

package/dist/agentic/decorators/corrective-rag.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"corrective-rag.decorator.d.ts","sourceRoot":"","sources":["../../../src/agentic/decorators/corrective-rag.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAc,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE/E,OAAO,6CAA6C,CAAC;AAGrD,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC;AAID,wBAAgB,aAAa,CAAC,MAAM,GAAE,mBAAwB,GAAG,eAAe,CAgD/E;AAgHD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,mBAAmB,GAAG,SAAS,CAEjC"}

package/dist/agentic/decorators/corrective-rag.decorator.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * Corrective RAG (CRAG) Decorator
+ * Self-corrects retrieval errors with fallback mechanisms
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CorrectiveRAG = CorrectiveRAG;
+exports.getCorrectiveRAGResult = getCorrectiveRAGResult;
+require("reflect-metadata");
+const prompts_1 = require("@hazeljs/prompts");
+require("../../prompts/agentic/corrective-rag.prompt");
+const corrective_rag_prompt_1 = require("../../prompts/agentic/corrective-rag.prompt");
+const CRAG_METADATA_KEY = Symbol('correctiveRAG');
+function CorrectiveRAG(config = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            let results = await originalMethod.apply(this, args);
+            const query = args[0];
+            // Evaluate results
+            const evaluation = await evaluateResults(results, query, config);
+            const corrections = [];
+            let fallbackUsed = false;
+            // Apply corrections if needed
+            if (evaluation.needsCorrection) {
+                for (const issue of evaluation.issues) {
+                    corrections.push({
+                        type: issue.type,
+                        description: issue.description,
+                        action: issue.action,
+                    });
+                }
+                // Attempt to correct
+                const corrected = await correctResults(results, query, evaluation, config);
+                if (corrected) {
+                    results = corrected;
+                }
+                else if (config.fallbackToWeb) {
+                    // Fallback mechanism (placeholder)
+                    fallbackUsed = true;
+                }
+            }
+            const cragResult = {
+                results: Array.isArray(results) ? results : [results],
+                corrections,
+                fallbackUsed,
+                confidence: evaluation.confidence,
+            };
+            Reflect.defineMetadata(CRAG_METADATA_KEY, cragResult, target, propertyKey);
+            return results;
+        };
+        return descriptor;
+    };
+}
+async function evaluateResults(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+results, query, config) {
+    const threshold = config.relevanceThreshold || 0.7;
+    const issues = [];
+    if (!results || (Array.isArray(results) && results.length === 0)) {
+        issues.push({
+            type: 'missing_info',
+            description: 'No results returned',
+            action: 'Expand query or use fallback',
+        });
+        return { needsCorrection: true, confidence: 0, issues };
+    }
+    const resultArray = Array.isArray(results) ? results : [results];
+    // Check relevance scores
+    const avgScore = resultArray.reduce((sum, r) => sum + (r.score || 0), 0) / resultArray.length;
+    if (avgScore < threshold) {
+        issues.push({
+            type: 'low_relevance',
+            description: `Average relevance score ${avgScore.toFixed(2)} below threshold ${threshold}`,
+            action: 'Rewrite query or adjust retrieval strategy',
+        });
+    }
+    // Check for contradictions
+    if (resultArray.length > 1 && config.llmProvider) {
+        const hasContradictions = await checkContradictions(resultArray, config.llmProvider);
+        if (hasContradictions) {
+            issues.push({
+                type: 'contradictory',
+                description: 'Results contain contradictory information',
+                action: 'Filter or re-rank results',
+            });
+        }
+    }
+    return {
+        needsCorrection: issues.length > 0,
+        confidence: Math.max(avgScore, 0.5),
+        issues,
+    };
+}
+async function correctResults(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+results, query, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+evaluation, config
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+) {
+    if (!config.llmProvider) {
+        return null;
+    }
+    const prompt = prompts_1.PromptRegistry.get(corrective_rag_prompt_1.CORRECTIVE_RAG_KEY).render({
+        query,
+        issues: evaluation.issues.map((i) => i.description).join(', '),
+    });
+    try {
+        await config.llmProvider.generateStructured(prompt, {});
+        // Return null to signal re-query needed
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+async function checkContradictions(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+results, llmProvider) {
+    if (results.length < 2)
+        return false;
+    const contents = results
+        .slice(0, 3)
+        .map((r) => r.content)
+        .join('\n\n');
+    const prompt = `Do these texts contain contradictory information? Answer yes or no.
+
+Texts:
+${contents.slice(0, 1000)}`;
+    try {
+        const response = await llmProvider.generate(prompt, { maxTokens: 10 });
+        return response.toLowerCase().includes('yes');
+    }
+    catch {
+        return false;
+    }
+}
+function getCorrectiveRAGResult(target, propertyKey) {
+    return Reflect.getMetadata(CRAG_METADATA_KEY, target, propertyKey);
+}
+//# sourceMappingURL=corrective-rag.decorator.js.map

package/dist/agentic/decorators/corrective-rag.decorator.js.map

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

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

@@ -0,0 +1,15 @@
+/**
+ * HyDE (Hypothetical Document Embeddings) Decorator
+ * Generates hypothetical documents to improve retrieval
+ */
+import 'reflect-metadata';
+import { HyDEResult, AgenticLLMProvider } from '../types';
+import '../../prompts/agentic/hyde.prompt';
+export interface HyDEConfig {
+    generateHypothesis?: boolean;
+    numHypotheses?: number;
+    llmProvider?: AgenticLLMProvider;
+}
+export declare function HyDE(config?: HyDEConfig): MethodDecorator;
+export declare function getHyDEResult(target: object, propertyKey: string | symbol): HyDEResult | undefined;
+//# sourceMappingURL=hyde.decorator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hyde.decorator.d.ts","sourceRoot":"","sources":["../../../src/agentic/decorators/hyde.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE1D,OAAO,mCAAmC,CAAC;AAG3C,MAAM,WAAW,UAAU;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC;AAID,wBAAgB,IAAI,CAAC,MAAM,GAAE,UAAe,GAAG,eAAe,CAmD7D;AAgDD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,UAAU,GAAG,SAAS,CAExB"}

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

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * HyDE (Hypothetical Document Embeddings) Decorator
+ * Generates hypothetical documents to improve retrieval
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HyDE = HyDE;
+exports.getHyDEResult = getHyDEResult;
+require("reflect-metadata");
+const prompts_1 = require("@hazeljs/prompts");
+require("../../prompts/agentic/hyde.prompt");
+const hyde_prompt_1 = require("../../prompts/agentic/hyde.prompt");
+const HYDE_METADATA_KEY = Symbol('hyde');
+function HyDE(config = {}) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const query = args[0];
+            if (!config.generateHypothesis || !config.llmProvider) {
+                return originalMethod.apply(this, args);
+            }
+            // Generate hypothetical documents
+            const hypotheses = await generateHypotheticalDocuments(query, config.numHypotheses || 3, config.llmProvider);
+            // Retrieve using each hypothesis
+            const allResults = [];
+            const seenIds = new Set();
+            for (const hypothesis of hypotheses) {
+                const results = await originalMethod.apply(this, [hypothesis, ...args.slice(1)]);
+                if (Array.isArray(results)) {
+                    for (const result of results) {
+                        if (result.id && !seenIds.has(result.id)) {
+                            seenIds.add(result.id);
+                            allResults.push(result);
+                        }
+                    }
+                }
+            }
+            // Re-rank by aggregated scores
+            const reranked = rerankResults(allResults, hypotheses.length);
+            const hydeResult = {
+                hypotheticalDocuments: hypotheses,
+                retrievedResults: reranked,
+                aggregatedScore: calculateAggregatedScore(reranked),
+            };
+            Reflect.defineMetadata(HYDE_METADATA_KEY, hydeResult, target, propertyKey);
+            return reranked;
+        };
+        return descriptor;
+    };
+}
+async function generateHypotheticalDocuments(query, count, llmProvider) {
+    const prompt = prompts_1.PromptRegistry.get(hyde_prompt_1.HYDE_KEY).render({
+        count: String(count),
+        query,
+    });
+    try {
+        const response = await llmProvider.generate(prompt, {
+            temperature: 0.7,
+            maxTokens: 1000,
+        });
+        const documents = response
+            .split('\n')
+            .map((line) => line.replace(/^\d+\.\s*/, '').trim())
+            .filter((line) => line.length > 50)
+            .slice(0, count);
+        return documents.length > 0 ? documents : [query];
+    }
+    catch {
+        return [query];
+    }
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function rerankResults(results, hypothesisCount) {
+    return results
+        .map((result) => ({
+        ...result,
+        score: (result.score || 0) * (1 + 0.1 * hypothesisCount),
+    }))
+        .sort((a, b) => (b.score || 0) - (a.score || 0));
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function calculateAggregatedScore(results) {
+    if (results.length === 0)
+        return 0;
+    const totalScore = results.reduce((sum, r) => sum + (r.score || 0), 0);
+    return totalScore / results.length;
+}
+function getHyDEResult(target, propertyKey) {
+    return Reflect.getMetadata(HYDE_METADATA_KEY, target, propertyKey);
+}
+//# sourceMappingURL=hyde.decorator.js.map

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

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

package/dist/agentic/decorators/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Agentic RAG Decorators
+ * Export all decorators
+ */
+export * from './query-planner.decorator';
+export * from './self-reflective.decorator';
+export * from './adaptive-retrieval.decorator';
+export * from './multi-hop.decorator';
+export * from './hyde.decorator';
+export * from './corrective-rag.decorator';
+export * from './context-aware.decorator';
+export * from './query-rewriter.decorator';
+export * from './source-verification.decorator';
+export * from './active-learning.decorator';
+export * from './cached.decorator';
+//# sourceMappingURL=index.d.ts.map

package/dist/agentic/decorators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agentic/decorators/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC"}

package/dist/agentic/decorators/index.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Agentic RAG Decorators
+ * Export all decorators
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./query-planner.decorator"), exports);
+__exportStar(require("./self-reflective.decorator"), exports);
+__exportStar(require("./adaptive-retrieval.decorator"), exports);
+__exportStar(require("./multi-hop.decorator"), exports);
+__exportStar(require("./hyde.decorator"), exports);
+__exportStar(require("./corrective-rag.decorator"), exports);
+__exportStar(require("./context-aware.decorator"), exports);
+__exportStar(require("./query-rewriter.decorator"), exports);
+__exportStar(require("./source-verification.decorator"), exports);
+__exportStar(require("./active-learning.decorator"), exports);
+__exportStar(require("./cached.decorator"), exports);
+//# sourceMappingURL=index.js.map

package/dist/agentic/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agentic/decorators/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAEH,4DAA0C;AAC1C,8DAA4C;AAC5C,iEAA+C;AAC/C,wDAAsC;AACtC,mDAAiC;AACjC,6DAA2C;AAC3C,4DAA0C;AAC1C,6DAA2C;AAC3C,kEAAgD;AAChD,8DAA4C;AAC5C,qDAAmC"}

package/dist/agentic/decorators/multi-hop.decorator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Multi-Hop Decorator
+ * Performs multi-hop reasoning across documents
+ */
+import 'reflect-metadata';
+import { ReasoningChain, AgenticLLMProvider } from '../types';
+import '../../prompts/agentic/multi-hop.prompt';
+export interface MultiHopConfig {
+    maxHops?: number;
+    strategy?: 'breadth-first' | 'depth-first' | 'adaptive';
+    llmProvider?: AgenticLLMProvider;
+}
+export declare function MultiHop(config?: MultiHopConfig): MethodDecorator;
+export declare function getReasoningChain(target: object, propertyKey: string | symbol): ReasoningChain | undefined;
+//# sourceMappingURL=multi-hop.decorator.d.ts.map

package/dist/agentic/decorators/multi-hop.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-hop.decorator.d.ts","sourceRoot":"","sources":["../../../src/agentic/decorators/multi-hop.decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAgB,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE5E,OAAO,wCAAwC,CAAC;AAGhD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,eAAe,GAAG,aAAa,GAAG,UAAU,CAAC;IACxD,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC;AAID,wBAAgB,QAAQ,CAAC,MAAM,GAAE,cAAmB,GAAG,eAAe,CAuDrE;AAsED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,cAAc,GAAG,SAAS,CAE5B"}