ai-mind-map 1.1.3 → 1.4.0

package/dist/tools/digest-tools.js

@@ -0,0 +1,332 @@
+/**
+ * AI Mind Map — Digest & Verification Tools (MCP)
+ *
+ * Tools for compressed codebase summaries and content verification:
+ *   - mindmap_digest       — Compressed project summary (<2000 tokens)
+ *   - mindmap_file_digest  — Compressed file summary without reading full file
+ *   - mindmap_verify       — Hash-based content verification
+ */
+import { z } from 'zod';
+import { relative, basename } from 'node:path';
+import { createHash } from 'node:crypto';
+import { readFile, stat } from 'node:fs/promises';
+// ── Helpers ─────────────────────────────────────────────────
+const defaultEstimator = {
+    estimate: (s) => Math.ceil(s.length / 4),
+};
+function ok(data, estimator) {
+    const json = JSON.stringify(data, null, 2);
+    const tokens = estimator.estimate(json);
+    return JSON.stringify({ success: true, data, tokenCount: tokens });
+}
+function fail(message) {
+    return JSON.stringify({ success: false, error: message });
+}
+function mcpText(text) {
+    return { content: [{ type: 'text', text }] };
+}
+// ============================================================
+// Registration
+// ============================================================
+export function registerDigestTools(server, graph, changelog, config, estimator = defaultEstimator) {
+    // ── mindmap_digest ─────────────────────────────────────────
+    server.tool('mindmap_digest', 'Get a compressed codebase summary in under 2000 tokens. ' +
+        'Includes: file tree, tech stack, architecture layers, key symbols, ' +
+        'and recent changes. USE THIS instead of reading multiple files to ' +
+        'understand a project.', {
+        includeChanges: z.boolean().optional().describe('Include recent changes in digest (default: true)'),
+        maxTokens: z.number().optional().describe('Max tokens for digest (default: 2000)'),
+    }, async (args) => {
+        try {
+            const maxTokens = args.maxTokens || 2000;
+            const includeChanges = args.includeChanges !== false;
+            // Check cache first
+            const cacheKey = `digest_${maxTokens}_${includeChanges}`;
+            const cached = changelog.getCachedDigest(cacheKey);
+            if (cached) {
+                return mcpText(cached);
+            }
+            const stats = graph.getStats();
+            const overview = graph.getProjectOverview();
+            // Build file tree summary
+            const filesByDir = new Map();
+            const indexedFiles = graph.getIndexedFiles();
+            for (const f of indexedFiles) {
+                const rel = relative(config.projectRoot, f).replace(/\\/g, '/');
+                const dir = rel.includes('/') ? rel.substring(0, rel.lastIndexOf('/')) : '.';
+                if (!filesByDir.has(dir))
+                    filesByDir.set(dir, []);
+                filesByDir.get(dir).push(basename(rel));
+            }
+            // Sort dirs by file count
+            const sortedDirs = Array.from(filesByDir.entries())
+                .sort(([, a], [, b]) => b.length - a.length);
+            // Build directory tree (compact)
+            const dirTree = sortedDirs.slice(0, 15).map(([dir, files]) => {
+                if (files.length <= 3) {
+                    return `  ${dir}/ — ${files.join(', ')}`;
+                }
+                return `  ${dir}/ — ${files.length} files (${files.slice(0, 3).join(', ')}...)`;
+            });
+            // Key symbols by type (top by PageRank or alphabetical)
+            const symbolsByType = {};
+            for (const [typeName, nodes] of overview) {
+                if (typeName === 'file')
+                    continue;
+                const top = nodes
+                    .filter(n => n.isExported || n.visibility === 'public')
+                    .slice(0, 10)
+                    .map(n => ({
+                    name: n.qualifiedName || n.name,
+                    file: relative(config.projectRoot, n.filePath).replace(/\\/g, '/'),
+                    sig: n.signature ? n.signature.substring(0, 80) : '',
+                }));
+                if (top.length > 0) {
+                    symbolsByType[typeName] = top;
+                }
+            }
+            // Tech stack detection
+            const languages = Object.entries(stats.languageBreakdown)
+                .sort(([, a], [, b]) => b - a)
+                .map(([lang, count]) => `${lang} (${count} files)`);
+            // Build the digest
+            const lines = [];
+            lines.push(`# Project Digest: ${basename(config.projectRoot)}`);
+            lines.push(`Stack: ${languages.join(', ')}`);
+            lines.push(`Total: ${stats.totalFiles} files, ${stats.totalNodes} symbols, ${stats.totalEdges} relationships`);
+            lines.push('');
+            lines.push('## Structure');
+            lines.push(...dirTree);
+            lines.push('');
+            // Key exported symbols
+            lines.push('## Key Symbols');
+            for (const [type, symbols] of Object.entries(symbolsByType)) {
+                const symbolList = symbols.map(s => s.sig ? `  ${s.name}: ${s.sig}` : `  ${s.name} (${s.file})`);
+                if (symbolList.length > 0) {
+                    lines.push(`### ${type}s (${symbols.length})`);
+                    lines.push(...symbolList.slice(0, 8));
+                }
+            }
+            // Recent changes
+            if (includeChanges) {
+                const changes = changelog.getChangesSince(Date.now() - 24 * 3600_000);
+                if (changes.totalChanges > 0) {
+                    lines.push('');
+                    lines.push(`## Recent Changes (${changes.sinceLabel})`);
+                    for (const f of changes.files.slice(0, 5)) {
+                        const relPath = relative(config.projectRoot, f.filePath).replace(/\\/g, '/');
+                        const parts = [];
+                        if (f.added.length > 0)
+                            parts.push(`+${f.added.length} added`);
+                        if (f.modified.length > 0)
+                            parts.push(`~${f.modified.length} modified`);
+                        if (f.deleted.length > 0)
+                            parts.push(`-${f.deleted.length} deleted`);
+                        lines.push(`  ${relPath}: ${parts.join(', ')}`);
+                    }
+                }
+            }
+            // Hotspots
+            const hotspots = changelog.getHotspots(3);
+            if (hotspots.length > 0) {
+                lines.push('');
+                lines.push('## Hot Files (most frequently changed)');
+                for (const h of hotspots) {
+                    const rel = relative(config.projectRoot, h.filePath).replace(/\\/g, '/');
+                    lines.push(`  ${rel}: ${h.changeCount} changes`);
+                }
+            }
+            let digest = lines.join('\n');
+            // Trim to token budget
+            const tokens = estimator.estimate(digest);
+            if (tokens > maxTokens) {
+                // Truncate by removing sections from the bottom
+                while (estimator.estimate(digest) > maxTokens && digest.includes('\n')) {
+                    const lastNewline = digest.lastIndexOf('\n');
+                    digest = digest.substring(0, lastNewline);
+                }
+                digest += '\n\n[Truncated to fit token budget]';
+            }
+            const result = ok({
+                digest,
+                tokenCount: estimator.estimate(digest),
+                tokensSaved: `~${Math.round(stats.totalNodes * 15)} tokens saved vs reading all files`,
+            }, estimator);
+            // Cache for 5 minutes
+            changelog.setCachedDigest(cacheKey, result, 300_000);
+            return mcpText(result);
+        }
+        catch (err) {
+            return mcpText(fail(`Failed to generate digest: ${err instanceof Error ? err.message : String(err)}`));
+        }
+    });
+    // ── mindmap_file_digest ────────────────────────────────────
+    server.tool('mindmap_file_digest', 'Get a compressed summary of a single file WITHOUT reading the full file. ' +
+        'Returns: exports, key functions with signatures, dependencies, and recent changes. ' +
+        'Use this to understand a file before deciding whether to read it fully.', {
+        file: z.string().describe('File path (relative to project root or absolute)'),
+    }, async (args) => {
+        try {
+            // Resolve file path
+            let filePath = args.file;
+            if (!filePath.includes(':') && !filePath.startsWith('/')) {
+                filePath = `${config.projectRoot}/${filePath}`;
+            }
+            filePath = filePath.replace(/\//g, '\\');
+            // Get all nodes for this file
+            const fileNodes = graph.getFileStructure(filePath);
+            if (fileNodes.length === 0) {
+                // Try relative path match
+                const allFiles = graph.getIndexedFiles();
+                const match = allFiles.find(f => relative(config.projectRoot, f).replace(/\\/g, '/') === args.file.replace(/\\/g, '/'));
+                if (match) {
+                    const nodes = graph.getFileStructure(match);
+                    if (nodes.length > 0) {
+                        return buildFileDigest(match, nodes, args.file);
+                    }
+                }
+                return mcpText(fail(`File not found in index: ${args.file}`));
+            }
+            return buildFileDigest(filePath, fileNodes, args.file);
+        }
+        catch (err) {
+            return mcpText(fail(`Failed to get file digest: ${err instanceof Error ? err.message : String(err)}`));
+        }
+    });
+    function buildFileDigest(filePath, fileNodes, displayPath) {
+        const relPath = relative(config.projectRoot, filePath).replace(/\\/g, '/');
+        // Categorize symbols
+        const exports = fileNodes.filter((n) => n.isExported && n.type !== 'file');
+        const functions = fileNodes.filter((n) => ['function', 'method'].includes(n.type));
+        const classes = fileNodes.filter((n) => n.type === 'class');
+        const interfaces = fileNodes.filter((n) => n.type === 'interface');
+        const types = fileNodes.filter((n) => n.type === 'type_alias');
+        // Get file changes
+        const changes = changelog.getFileChanges(filePath, 10);
+        const result = {
+            file: relPath,
+            language: fileNodes[0]?.language || 'unknown',
+            totalSymbols: fileNodes.filter((n) => n.type !== 'file').length,
+            lineRange: {
+                start: Math.min(...fileNodes.map((n) => n.startLine || 0)),
+                end: Math.max(...fileNodes.map((n) => n.endLine || 0)),
+            },
+        };
+        if (exports.length > 0) {
+            result.exports = exports.map((n) => ({
+                name: n.name,
+                type: n.type,
+                signature: n.signature ? n.signature.substring(0, 120) : undefined,
+                lines: `${n.startLine}-${n.endLine}`,
+            }));
+        }
+        if (classes.length > 0) {
+            result.classes = classes.map((c) => ({
+                name: c.name,
+                exported: c.isExported,
+                methods: functions
+                    .filter((f) => f.qualifiedName?.startsWith(c.name + '.'))
+                    .map((f) => f.name),
+            }));
+        }
+        if (functions.length > 0 && !result.exports) {
+            result.functions = functions.slice(0, 15).map((f) => ({
+                name: f.qualifiedName || f.name,
+                signature: f.signature ? f.signature.substring(0, 100) : undefined,
+                async: f.isAsync || undefined,
+                lines: `${f.startLine}-${f.endLine}`,
+            }));
+        }
+        if (changes.length > 0) {
+            result.recentChanges = changes.slice(0, 5).map(c => ({
+                when: new Date(c.timestamp).toISOString(),
+                type: c.changeType,
+                symbol: c.symbolName,
+                detail: c.changeType === 'modified' && c.oldSignature !== c.newSignature
+                    ? `${c.oldSignature} → ${c.newSignature}`
+                    : undefined,
+            }));
+        }
+        result.tokensSaved = `~${Math.round(result.lineRange?.end * 4 || 5000)} tokens saved vs reading full file`;
+        return mcpText(ok(result, estimator));
+    }
+    // ── mindmap_verify ─────────────────────────────────────────
+    server.tool('mindmap_verify', 'Verify that a file or symbol still matches what you expect. ' +
+        'Returns the current content hash and signature without re-reading the file. ' +
+        'Use this to check if your cached knowledge of code is still valid.', {
+        file: z.string().describe('File path to verify'),
+        symbol: z.string().optional().describe('Specific symbol name to verify (e.g., "handleLogin")'),
+    }, async (args) => {
+        try {
+            let filePath = args.file;
+            if (!filePath.includes(':') && !filePath.startsWith('/')) {
+                filePath = `${config.projectRoot}/${filePath}`;
+            }
+            filePath = filePath.replace(/\//g, '\\');
+            // Get current file hash from disk
+            let diskHash = null;
+            let diskMtime = null;
+            let diskSize = null;
+            try {
+                const content = await readFile(filePath, 'utf-8');
+                diskHash = createHash('sha256').update(content).digest('hex').substring(0, 16);
+                const fileStat = await stat(filePath);
+                diskMtime = fileStat.mtimeMs;
+                diskSize = fileStat.size;
+            }
+            catch {
+                return mcpText(fail(`Cannot read file: ${args.file}`));
+            }
+            // Get indexed hash
+            const indexEntry = graph.getFileIndexEntry(filePath);
+            const indexedHash = indexEntry?.content_hash || null;
+            const isStale = indexedHash !== null && indexedHash !== diskHash;
+            if (args.symbol) {
+                // Verify specific symbol
+                const nodes = graph.getNodesByName(args.symbol);
+                const match = nodes.find(n => n.filePath === filePath || n.filePath.replace(/\\/g, '/') === filePath.replace(/\\/g, '/'));
+                if (!match) {
+                    return mcpText(ok({
+                        file: args.file,
+                        symbol: args.symbol,
+                        status: 'not_found',
+                        message: `Symbol "${args.symbol}" not found in ${args.file}. It may have been renamed or deleted.`,
+                        fileIsStale: isStale,
+                    }, estimator));
+                }
+                return mcpText(ok({
+                    file: args.file,
+                    symbol: args.symbol,
+                    status: isStale ? 'stale' : 'valid',
+                    currentSignature: match.signature,
+                    lines: `${match.startLine}-${match.endLine}`,
+                    hash: match.hash,
+                    type: match.type,
+                    fileIsStale: isStale,
+                    message: isStale
+                        ? 'File has been modified since last index. Symbol data may be outdated.'
+                        : 'Symbol data is up-to-date.',
+                }, estimator));
+            }
+            // Verify entire file
+            return mcpText(ok({
+                file: args.file,
+                status: isStale ? 'stale' : 'valid',
+                diskHash,
+                indexedHash,
+                diskSize,
+                lastIndexed: indexEntry?.indexed_at
+                    ? new Date(indexEntry.indexed_at).toISOString()
+                    : null,
+                lastModified: diskMtime ? new Date(diskMtime).toISOString() : null,
+                message: isStale
+                    ? 'File has changed since last index. Run mindmap_reindex or wait for auto-update.'
+                    : 'File is up-to-date in the index.',
+            }, estimator));
+        }
+        catch (err) {
+            return mcpText(fail(`Verification failed: ${err instanceof Error ? err.message : String(err)}`));
+        }
+    });
+}
+//# sourceMappingURL=digest-tools.js.map

package/dist/tools/digest-tools.js.map

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

package/dist/tools/semantic-tools.d.ts

@@ -0,0 +1,20 @@
+/**
+ * AI Mind Map — Semantic Search MCP Tools
+ *
+ * Registers the `mindmap_semantic_search` tool that provides
+ * concept-level search using TF-IDF cosine similarity with
+ * synonym expansion. Searches like "save user preferences"
+ * find `persistSettings()`.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { MindMapConfig } from '../types.js';
+import { KnowledgeGraph } from '../knowledge-graph/graph.js';
+import { SemanticSearchEngine } from '../knowledge-graph/semantic-search.js';
+export interface ITokenEstimator {
+    estimate(text: string): number;
+}
+/**
+ * Register semantic search tools on the MCP server.
+ */
+export declare function registerSemanticTools(server: McpServer, graph: KnowledgeGraph, semanticEngine: SemanticSearchEngine, config: MindMapConfig, estimator?: ITokenEstimator): void;
+//# sourceMappingURL=semantic-tools.d.ts.map

package/dist/tools/semantic-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-tools.d.ts","sourceRoot":"","sources":["../../src/tools/semantic-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAc,aAAa,EAAa,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAM7E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AA8BD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,cAAc,EACrB,cAAc,EAAE,oBAAoB,EACpC,MAAM,EAAE,aAAa,EACrB,SAAS,GAAE,eAAkC,GAC5C,IAAI,CAwIN"}

package/dist/tools/semantic-tools.js

@@ -0,0 +1,141 @@
+/**
+ * AI Mind Map — Semantic Search MCP Tools
+ *
+ * Registers the `mindmap_semantic_search` tool that provides
+ * concept-level search using TF-IDF cosine similarity with
+ * synonym expansion. Searches like "save user preferences"
+ * find `persistSettings()`.
+ */
+import { z } from 'zod';
+import { relative } from 'node:path';
+const defaultEstimator = {
+    estimate: (text) => Math.ceil(text.length / 4),
+};
+// ============================================================
+// Helpers
+// ============================================================
+function mcpText(result) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result) }],
+    };
+}
+function ok(data, estimator) {
+    const serialised = JSON.stringify(data);
+    const tokens = estimator.estimate(serialised);
+    return { success: true, data, tokenCount: tokens, tokensSaved: 0 };
+}
+function fail(message) {
+    return { success: false, data: null, tokenCount: 0, tokensSaved: 0, message };
+}
+// ============================================================
+// Registration
+// ============================================================
+/**
+ * Register semantic search tools on the MCP server.
+ */
+export function registerSemanticTools(server, graph, semanticEngine, config, estimator = defaultEstimator) {
+    // ── mindmap_semantic_search ─────────────────────────────────
+    server.tool('mindmap_semantic_search', 'Concept-level semantic search that finds code by MEANING, not just name. ' +
+        'Search "save user preferences" to find persistSettings(). ' +
+        'Search "authentication" to find login(), signin(), verifyCredentials(). ' +
+        'Uses TF-IDF + synonym expansion for intelligent matching. ' +
+        'Returns similarity scores and which synonyms were activated.', {
+        query: z.string().describe('Natural language query describing what you\'re looking for. ' +
+            'Examples: "save user data", "handle authentication", "validate input"'),
+        limit: z.number().int().min(1).max(50).default(10).describe('Maximum number of results (default 10)'),
+        threshold: z.number().min(0).max(1).default(0.01).describe('Minimum similarity score 0-1 (default 0.01). Raise for more precise results.'),
+        useSynonyms: z.boolean().default(true).describe('Whether to expand query with programming synonyms (default true). ' +
+            'Set false for exact-term matching only.'),
+    }, async ({ query, limit, threshold, useSynonyms }) => {
+        try {
+            const searchResults = semanticEngine.search(query, limit, threshold, useSynonyms);
+            if (searchResults.length === 0) {
+                return mcpText(ok({
+                    query,
+                    results: [],
+                    totalResults: 0,
+                    synonymsExpanded: [],
+                    message: 'No semantic matches found. Try a broader query or different terms.',
+                }, estimator));
+            }
+            // Enrich results with graph node data
+            const enrichedResults = [];
+            for (const sr of searchResults) {
+                const node = graph.getNode(sr.nodeId);
+                if (!node)
+                    continue;
+                const relPath = relative(config.projectRoot, node.filePath);
+                enrichedResults.push({
+                    name: node.name,
+                    qualifiedName: node.qualifiedName,
+                    type: node.type,
+                    file: relPath,
+                    line: node.startLine,
+                    endLine: node.endLine,
+                    signature: node.signature,
+                    visibility: node.visibility,
+                    isExported: node.isExported,
+                    docComment: node.docComment,
+                    // Semantic search metadata
+                    semanticScore: Math.round(sr.score * 1000) / 1000,
+                    matchedTerms: sr.matchedTerms,
+                });
+            }
+            // Collect activated synonyms from the first result (same for all)
+            const synonymsExpanded = searchResults.length > 0
+                ? searchResults[0].expandedSynonyms
+                : [];
+            const response = {
+                query,
+                results: enrichedResults,
+                totalResults: enrichedResults.length,
+                synonymsExpanded: synonymsExpanded.length > 0 ? synonymsExpanded : undefined,
+                searchMode: 'semantic',
+            };
+            return mcpText(ok(response, estimator));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return mcpText(fail(`semantic_search failed: ${msg}`));
+        }
+    });
+    // ── mindmap_semantic_stats ──────────────────────────────────
+    server.tool('mindmap_semantic_stats', 'Get statistics about the semantic search index: vocabulary size, ' +
+        'document count, and available synonym groups.', {}, async () => {
+        try {
+            const stats = semanticEngine.getStats();
+            const synonymGroups = semanticEngine.getSynonymGroups();
+            const response = {
+                index: stats,
+                synonymGroups: synonymGroups.length,
+                synonymExamples: synonymGroups.slice(0, 5).map(group => `${group[0]} ↔ ${group.slice(1, 4).join(', ')}...`),
+            };
+            return mcpText(ok(response, estimator));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return mcpText(fail(`semantic_stats failed: ${msg}`));
+        }
+    });
+    // ── mindmap_synonyms ────────────────────────────────────────
+    server.tool('mindmap_synonyms', 'Look up programming synonyms for a term. Useful to understand ' +
+        'what the semantic search will expand to.', {
+        term: z.string().describe('Term to look up synonyms for (e.g., "save", "auth", "delete")'),
+    }, async ({ term }) => {
+        try {
+            const synonyms = semanticEngine.getSynonyms(term);
+            return mcpText(ok({
+                term,
+                synonyms: synonyms.length > 0 ? synonyms : null,
+                message: synonyms.length > 0
+                    ? `Found ${synonyms.length} synonyms for "${term}"`
+                    : `No synonyms found for "${term}". This term will be matched literally.`,
+            }, estimator));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return mcpText(fail(`synonyms lookup failed: ${msg}`));
+        }
+    });
+}
+//# sourceMappingURL=semantic-tools.js.map

package/dist/tools/semantic-tools.js.map

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

package/dist/tools/session-tools.d.ts

@@ -0,0 +1,17 @@
+/**
+ * AI Mind Map — Session Tools (MCP)
+ *
+ * Tools for AI agent session management:
+ *   - mindmap_session_start   — Start tracking an AI session
+ *   - mindmap_session_resume  — Resume from last session (returns what changed)
+ *   - mindmap_session_end     — End session with summary
+ *   - mindmap_changelog       — What changed since a given time
+ *   - mindmap_hotspots        — Most frequently changed files
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { KnowledgeGraph } from '../knowledge-graph/graph.js';
+import type { ChangelogEngine } from '../knowledge-graph/changelog.js';
+import type { MindMapConfig } from '../types.js';
+import type { ITokenEstimator } from './advanced-tools.js';
+export declare function registerSessionTools(server: McpServer, graph: KnowledgeGraph, changelog: ChangelogEngine, config: MindMapConfig, estimator?: ITokenEstimator): void;
+//# sourceMappingURL=session-tools.d.ts.map

package/dist/tools/session-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tools.d.ts","sourceRoot":"","sources":["../../src/tools/session-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AA0B3D,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,aAAa,EACrB,SAAS,GAAE,eAAkC,GAC5C,IAAI,CAwPN"}