@monoes/monomindcli 1.17.2 → 1.18.0

package/dist/src/capabilities/cap-documents.js

@@ -0,0 +1,139 @@
+import fs from 'fs';
+const DOC_EXTENSIONS = new Set([
+    '.pdf',
+    '.docx',
+    '.doc',
+    '.md',
+    '.txt',
+    '.rtf',
+    '.rst',
+    '.tex',
+    '.odt',
+    '.pages',
+    '.epub',
+]);
+const MAX_INDEX_FILE_SIZE = 50 * 1024 * 1024; // 50MB — skip oversized text files
+// In-memory index for T0 (metadata) and T1 (content) — replaced by memory DB in production
+const indexedDocs = new Map();
+async function extractText(file) {
+    if (file.size > MAX_INDEX_FILE_SIZE)
+        return '';
+    const ext = file.extension;
+    if (ext === '.md' || ext === '.txt' || ext === '.rst' || ext === '.tex') {
+        return fs.readFileSync(file.absolutePath, 'utf-8');
+    }
+    if (ext === '.pdf') {
+        try {
+            // monolean: pdf-parse is an optional dependency — degrade to metadata-only if missing
+            const pdfParse = (await import('pdf-parse')).default;
+            const buffer = fs.readFileSync(file.absolutePath);
+            const data = await pdfParse(buffer);
+            return data.text;
+        }
+        catch {
+            return ''; // pdf-parse not installed or file unreadable
+        }
+    }
+    if (ext === '.docx') {
+        try {
+            // monolean: mammoth is an optional dependency — degrade to metadata-only if missing
+            const mammoth = await import('mammoth');
+            const result = await mammoth.extractRawText({ path: file.absolutePath });
+            return result.value;
+        }
+        catch {
+            return ''; // mammoth not installed or file unreadable
+        }
+    }
+    return '';
+}
+export const documentsCapability = {
+    name: 'documents',
+    detect(scan) {
+        return scan.capabilities.documents.confidence;
+    },
+    async activate(_rootDir) {
+        indexedDocs.clear();
+    },
+    async index(files) {
+        let indexed = 0;
+        let skipped = 0;
+        const errors = [];
+        for (const file of files) {
+            if (!DOC_EXTENSIONS.has(file.extension)) {
+                skipped++;
+                continue;
+            }
+            try {
+                const content = await extractText(file);
+                indexedDocs.set(file.path, {
+                    path: file.path,
+                    content,
+                    metadata: {
+                        size: file.size,
+                        modified: file.modified.toISOString(),
+                        created: file.created.toISOString(),
+                        extension: file.extension,
+                    },
+                });
+                indexed++;
+            }
+            catch (err) {
+                errors.push(`${file.path}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        return { indexed, skipped, errors };
+    },
+    async search(query, limit = 20) {
+        // monolean: simple substring search for T0/T1 — vector search added when memory integration lands
+        const queryLower = query.toLowerCase();
+        const results = [];
+        for (const [docPath, doc] of indexedDocs) {
+            const contentLower = doc.content.toLowerCase();
+            const idx = contentLower.indexOf(queryLower);
+            if (idx !== -1) {
+                const start = Math.max(0, idx - 40);
+                const end = Math.min(doc.content.length, idx + query.length + 40);
+                results.push({
+                    path: docPath,
+                    score: 1 / (idx + 1), // closer to start = higher score
+                    snippet: doc.content.slice(start, end).trim(),
+                    type: 'documents',
+                    metadata: doc.metadata,
+                });
+            }
+        }
+        return results.sort((a, b) => b.score - a.score).slice(0, limit);
+    },
+    async healthChecks() {
+        const checks = [];
+        // Check if PDF extraction is available
+        try {
+            await import('pdf-parse');
+            checks.push({ name: 'PDF Extraction', status: 'pass', message: 'pdf-parse available' });
+        }
+        catch {
+            checks.push({
+                name: 'PDF Extraction',
+                status: 'warn',
+                message: 'pdf-parse not installed',
+                hint: 'pnpm add pdf-parse',
+            });
+        }
+        // Check if docx extraction is available
+        try {
+            await import('mammoth');
+            checks.push({ name: 'DOCX Extraction', status: 'pass', message: 'mammoth available' });
+        }
+        catch {
+            checks.push({
+                name: 'DOCX Extraction',
+                status: 'warn',
+                message: 'mammoth not installed',
+                hint: 'pnpm add mammoth',
+            });
+        }
+        return checks;
+    },
+};
+//# sourceMappingURL=cap-documents.js.map

package/dist/src/capabilities/cap-documents.js.map

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

package/dist/src/capabilities/cap-graph.d.ts

@@ -0,0 +1,3 @@
+import type { CapabilityModule } from './types.js';
+export declare const graphCapability: CapabilityModule;
+//# sourceMappingURL=cap-graph.d.ts.map

package/dist/src/capabilities/cap-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cap-graph.d.ts","sourceRoot":"","sources":["../../../src/capabilities/cap-graph.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAuD,MAAM,YAAY,CAAC;AAkDxG,eAAO,MAAM,eAAe,EAAE,gBAgD7B,CAAC"}

package/dist/src/capabilities/cap-graph.js

@@ -0,0 +1,84 @@
+import path from 'path';
+const nodes = new Map();
+// Cap neighbors per node to keep memory bounded on large flat directories
+const MAX_NEIGHBORS = 50;
+function buildRelationships() {
+    // Relationship 1: same directory = siblings (capped to avoid O(n²) on huge flat dirs)
+    const byDir = new Map();
+    for (const [filePath, node] of nodes) {
+        const dir = node.directory;
+        if (!byDir.has(dir))
+            byDir.set(dir, []);
+        byDir.get(dir).push(filePath);
+    }
+    for (const siblings of byDir.values()) {
+        // For large directories, only link first MAX_NEIGHBORS items to each other
+        const capped = siblings.length > MAX_NEIGHBORS ? siblings.slice(0, MAX_NEIGHBORS) : siblings;
+        for (const a of capped) {
+            for (const b of capped) {
+                if (a !== b) {
+                    nodes.get(a).neighbors.add(b);
+                }
+            }
+        }
+    }
+    // Relationship 2: same date (within 1 day) = temporal neighbors
+    const sorted = [...nodes.entries()].sort((a, b) => a[1].modified.getTime() - b[1].modified.getTime());
+    for (let i = 0; i < sorted.length; i++) {
+        if (sorted[i][1].neighbors.size >= MAX_NEIGHBORS)
+            continue;
+        for (let j = i + 1; j < sorted.length; j++) {
+            const diffMs = sorted[j][1].modified.getTime() - sorted[i][1].modified.getTime();
+            if (diffMs >= 86400000)
+                break; // sorted — no further matches possible
+            if (sorted[i][1].directory !== sorted[j][1].directory) {
+                if (sorted[i][1].neighbors.size < MAX_NEIGHBORS)
+                    sorted[i][1].neighbors.add(sorted[j][0]);
+                if (sorted[j][1].neighbors.size < MAX_NEIGHBORS)
+                    sorted[j][1].neighbors.add(sorted[i][0]);
+            }
+        }
+    }
+}
+export const graphCapability = {
+    name: 'graph',
+    detect(_scan) {
+        return 0; // cross-cutting — activated by manager
+    },
+    async activate(_rootDir) {
+        nodes.clear();
+    },
+    async index(files) {
+        for (const file of files) {
+            nodes.set(file.path, {
+                path: file.path,
+                extension: file.extension,
+                directory: path.dirname(file.path),
+                modified: file.modified,
+                neighbors: new Set(),
+            });
+        }
+        buildRelationships();
+        return { indexed: files.length, skipped: 0, errors: [] };
+    },
+    async search(query, limit = 20) {
+        const queryLower = query.toLowerCase();
+        const results = [];
+        for (const [filePath, node] of nodes) {
+            if (filePath.toLowerCase().includes(queryLower)) {
+                const neighborList = [...node.neighbors].slice(0, 3);
+                results.push({
+                    path: filePath,
+                    score: 1.0,
+                    snippet: neighborList.length > 0
+                        ? `Related: ${neighborList.join(', ')}`
+                        : `Standalone file in ${node.directory}`,
+                    type: 'graph',
+                    metadata: { neighbors: [...node.neighbors], directory: node.directory },
+                });
+            }
+        }
+        return results.sort((a, b) => b.score - a.score).slice(0, limit);
+    },
+};
+//# sourceMappingURL=cap-graph.js.map

package/dist/src/capabilities/cap-graph.js.map

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

package/dist/src/capabilities/cap-media.d.ts

@@ -0,0 +1,3 @@
+import type { CapabilityModule } from './types.js';
+export declare const mediaCapability: CapabilityModule;
+//# sourceMappingURL=cap-media.d.ts.map

package/dist/src/capabilities/cap-media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cap-media.d.ts","sourceRoot":"","sources":["../../../src/capabilities/cap-media.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAMjB,MAAM,YAAY,CAAC;AAkEpB,eAAO,MAAM,eAAe,EAAE,gBA2F7B,CAAC"}

package/dist/src/capabilities/cap-media.js

@@ -0,0 +1,147 @@
+import fs from 'fs';
+const IMAGE_EXTENSIONS = new Set([
+    '.jpg',
+    '.jpeg',
+    '.png',
+    '.gif',
+    '.bmp',
+    '.heic',
+    '.heif',
+    '.webp',
+    '.svg',
+    '.raw',
+    '.cr2',
+    '.nef',
+    '.tiff',
+    '.tif',
+]);
+const VIDEO_EXTENSIONS = new Set(['.mp4', '.mov', '.avi', '.mkv', '.wmv', '.flv', '.webm']);
+const AUDIO_EXTENSIONS = new Set(['.mp3', '.wav', '.flac', '.aac', '.ogg', '.m4a', '.wma']);
+const ALL_MEDIA = new Set([...IMAGE_EXTENSIONS, ...VIDEO_EXTENSIONS, ...AUDIO_EXTENSIONS]);
+// In-memory index for T0 (metadata) — replaced by memory DB in production
+const indexedMedia = new Map();
+const MAX_EXIF_FILE_SIZE = 100 * 1024 * 1024; // 100MB — avoid OOM on large files
+async function extractExif(file) {
+    if (file.size > MAX_EXIF_FILE_SIZE)
+        return {};
+    try {
+        // monolean: exifreader is an optional dependency — degrade to metadata-only if missing
+        const mod = await import('exifreader');
+        const ExifReader = mod.default ?? mod;
+        const buffer = fs.readFileSync(file.absolutePath);
+        const tags = ExifReader.load(buffer, { expanded: true });
+        const result = {};
+        if (tags.exif) {
+            if (tags.exif.DateTimeOriginal)
+                result.dateTaken = tags.exif.DateTimeOriginal.description;
+            if (tags.exif.Make)
+                result.cameraMake = tags.exif.Make.description;
+            if (tags.exif.Model)
+                result.cameraModel = tags.exif.Model.description;
+            if (tags.exif.ImageWidth)
+                result.width = tags.exif.ImageWidth.value;
+            if (tags.exif.ImageLength)
+                result.height = tags.exif.ImageLength.value;
+        }
+        if (tags.gps) {
+            if (tags.gps.Latitude)
+                result.latitude = tags.gps.Latitude;
+            if (tags.gps.Longitude)
+                result.longitude = tags.gps.Longitude;
+        }
+        return result;
+    }
+    catch {
+        return {}; // exifreader not installed or file has no EXIF
+    }
+}
+function mediaType(ext) {
+    if (IMAGE_EXTENSIONS.has(ext))
+        return 'image';
+    if (VIDEO_EXTENSIONS.has(ext))
+        return 'video';
+    return 'audio';
+}
+export const mediaCapability = {
+    name: 'media',
+    detect(scan) {
+        return scan.capabilities.media.confidence;
+    },
+    async activate(_rootDir) {
+        indexedMedia.clear();
+    },
+    async index(files) {
+        let indexed = 0;
+        let skipped = 0;
+        const errors = [];
+        for (const file of files) {
+            if (!ALL_MEDIA.has(file.extension)) {
+                skipped++;
+                continue;
+            }
+            try {
+                const type = mediaType(file.extension);
+                // Video/audio: never readFileSync (multi-GB files) — metadata comes from fs.stat only
+                const exif = type === 'image' && file.extension !== '.svg' ? await extractExif(file) : {};
+                // Build searchable description from metadata + filename
+                const descParts = [file.path.replace(/[_-]/g, ' ')];
+                if (exif.dateTaken)
+                    descParts.push(`taken ${exif.dateTaken}`);
+                if (exif.cameraMake)
+                    descParts.push(`${exif.cameraMake} ${exif.cameraModel ?? ''}`);
+                indexedMedia.set(file.path, {
+                    path: file.path,
+                    type,
+                    metadata: {
+                        ...exif,
+                        size: file.size,
+                        modified: file.modified.toISOString(),
+                        created: file.created.toISOString(),
+                        extension: file.extension,
+                    },
+                    description: descParts.join(' '),
+                });
+                indexed++;
+            }
+            catch (err) {
+                errors.push(`${file.path}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        return { indexed, skipped, errors };
+    },
+    async search(query, limit = 20) {
+        const queryLower = query.toLowerCase();
+        const results = [];
+        for (const [mediaPath, entry] of indexedMedia) {
+            const descLower = entry.description.toLowerCase();
+            const pathLower = mediaPath.toLowerCase();
+            if (descLower.includes(queryLower) || pathLower.includes(queryLower)) {
+                results.push({
+                    path: mediaPath,
+                    score: pathLower.includes(queryLower) ? 1.0 : 0.5,
+                    snippet: entry.description,
+                    type: 'media',
+                    metadata: entry.metadata,
+                });
+            }
+        }
+        return results.sort((a, b) => b.score - a.score).slice(0, limit);
+    },
+    async healthChecks() {
+        const checks = [];
+        try {
+            await import('exifreader');
+            checks.push({ name: 'EXIF Extraction', status: 'pass', message: 'exifreader available' });
+        }
+        catch {
+            checks.push({
+                name: 'EXIF Extraction',
+                status: 'warn',
+                message: 'exifreader not installed',
+                hint: 'pnpm add exifreader',
+            });
+        }
+        return checks;
+    },
+};
+//# sourceMappingURL=cap-media.js.map

package/dist/src/capabilities/cap-media.js.map

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

package/dist/src/capabilities/cap-timeline.d.ts

@@ -0,0 +1,3 @@
+import type { CapabilityModule } from './types.js';
+export declare const timelineCapability: CapabilityModule;
+//# sourceMappingURL=cap-timeline.d.ts.map

package/dist/src/capabilities/cap-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cap-timeline.d.ts","sourceRoot":"","sources":["../../../src/capabilities/cap-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAuD,MAAM,YAAY,CAAC;AAyCxG,eAAO,MAAM,kBAAkB,EAAE,gBAyEhC,CAAC"}

package/dist/src/capabilities/cap-timeline.js

@@ -0,0 +1,90 @@
+const timelineIndex = new Map();
+const MONTH_NAMES = ['january', 'february', 'march', 'april', 'may', 'june', 'july', 'august', 'september', 'october', 'november', 'december'];
+const MONTH_SHORT = ['jan', 'feb', 'mar', 'apr', 'may', 'jun', 'jul', 'aug', 'sep', 'oct', 'nov', 'dec'];
+const MONTH_NAME_REGEXPS = MONTH_NAMES.map(m => new RegExp(`\\b${m}\\b`));
+const MONTH_SHORT_REGEXPS = MONTH_SHORT.map(m => new RegExp(`\\b${m}\\b`));
+function extractDatesFromFilename(filename) {
+    const dates = [];
+    // Match YYYY-MM-DD or YYYY-MM
+    const isoMatch = filename.match(/(\d{4})-(\d{2})(?:-(\d{2}))?/);
+    if (isoMatch) {
+        const d = new Date(`${isoMatch[1]}-${isoMatch[2]}-${isoMatch[3] ?? '01'}`);
+        if (!isNaN(d.getTime()))
+            dates.push(d);
+    }
+    // Match month names (word-boundary — avoid 'mar' matching 'marketplace', 'may' matching 'payment', etc.)
+    const lower = filename.toLowerCase();
+    for (let i = 0; i < MONTH_NAMES.length; i++) {
+        if (MONTH_NAME_REGEXPS[i].test(lower) || MONTH_SHORT_REGEXPS[i].test(lower)) {
+            const yearMatch = filename.match(/(\d{4})/);
+            if (yearMatch) {
+                const year = parseInt(yearMatch[1]);
+                if (year >= 1900 && year <= 2100) {
+                    dates.push(new Date(year, i, 1));
+                }
+            }
+        }
+    }
+    return dates;
+}
+export const timelineCapability = {
+    name: 'timeline',
+    detect(_scan) {
+        return 0; // cross-cutting — activated by manager, not by detection
+    },
+    async activate(_rootDir) {
+        timelineIndex.clear();
+    },
+    async index(files) {
+        let indexed = 0;
+        const errors = [];
+        for (const file of files) {
+            const dates = [];
+            dates.push({ label: 'modified', date: file.modified });
+            dates.push({ label: 'created', date: file.created });
+            const filenameDates = extractDatesFromFilename(file.path);
+            for (const d of filenameDates) {
+                dates.push({ label: 'filename', date: d });
+            }
+            timelineIndex.set(file.path, { path: file.path, dates });
+            indexed++;
+        }
+        return { indexed, skipped: 0, errors };
+    },
+    async search(query, limit = 20) {
+        const queryLower = query.toLowerCase();
+        const results = [];
+        // Parse date hints from query
+        let targetMonth = -1;
+        let targetYear = -1;
+        for (let i = 0; i < MONTH_NAMES.length; i++) {
+            if (MONTH_NAME_REGEXPS[i].test(queryLower) || MONTH_SHORT_REGEXPS[i].test(queryLower)) {
+                targetMonth = i;
+                break;
+            }
+        }
+        const yearMatch = query.match(/(\d{4})/);
+        if (yearMatch)
+            targetYear = parseInt(yearMatch[1]);
+        if (targetMonth === -1 && targetYear === -1)
+            return [];
+        for (const [filePath, entry] of timelineIndex) {
+            for (const { label, date } of entry.dates) {
+                const monthMatch = targetMonth === -1 || date.getMonth() === targetMonth;
+                const yearMatches = targetYear === -1 || date.getFullYear() === targetYear;
+                if (monthMatch && yearMatches) {
+                    results.push({
+                        path: filePath,
+                        score: label === 'filename' ? 1.0 : 0.7,
+                        snippet: `📅 ${date.toISOString().slice(0, 10)}: ${filePath} (${label})`,
+                        type: 'timeline',
+                        metadata: { date: date.toISOString(), dateSource: label },
+                    });
+                    break; // one result per file
+                }
+            }
+        }
+        return results.sort((a, b) => b.score - a.score).slice(0, limit);
+    },
+};
+//# sourceMappingURL=cap-timeline.js.map

package/dist/src/capabilities/cap-timeline.js.map

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

package/dist/src/capabilities/enrichment.d.ts

@@ -0,0 +1,44 @@
+import type { EnrichmentState, EnrichmentTier, FileEntry } from './types.js';
+import type { CapabilityManager } from './manager.js';
+export interface EnrichmentSummary {
+    total: number;
+    fullyEnriched: number;
+    t0Done: number;
+    t1Done: number;
+    t2Done: number;
+}
+export interface EnrichmentStatusReport {
+    paused: boolean;
+    summary: EnrichmentSummary;
+}
+export declare class EnrichmentPipeline {
+    private state;
+    private _paused;
+    private manager?;
+    constructor(manager?: CapabilityManager);
+    get isPaused(): boolean;
+    markDone(filePath: string, tier: EnrichmentTier): void;
+    markQueued(filePath: string, tier: EnrichmentTier): void;
+    markFailed(filePath: string, tier: EnrichmentTier): void;
+    markSkipped(filePath: string, tier: EnrichmentTier): void;
+    getState(): EnrichmentState;
+    getSummary(): EnrichmentSummary;
+    getStatus(): EnrichmentStatusReport;
+    pause(): void;
+    resume(): void;
+    /**
+     * Run a single enrichment tier over the given files using the active
+     * capability modules from the CapabilityManager (if provided).
+     *
+     * - t0/t1: each active module's `index()` is invoked (T0 = metadata,
+     *   T1 = content indexing; capability modules decide internally how to
+     *   split the work between these tiers).
+     * - t2: each active module's optional `enrich()` is invoked; modules
+     *   without an `enrich()` implementation have their files marked skipped.
+     */
+    runTier(tier: EnrichmentTier, files: FileEntry[], monomindDir?: string): Promise<void>;
+    saveState(monomindDir: string): void;
+    loadState(monomindDir: string): void;
+    private ensureEntry;
+}
+//# sourceMappingURL=enrichment.d.ts.map

package/dist/src/capabilities/enrichment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrichment.d.ts","sourceRoot":"","sources":["../../../src/capabilities/enrichment.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAID,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAC,CAAoB;gBAExB,OAAO,CAAC,EAAE,iBAAiB;IAIvC,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IAKtD,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IAKxD,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IAQxD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IAMzD,QAAQ,IAAI,eAAe;IAI3B,UAAU,IAAI,iBAAiB;IAW/B,SAAS,IAAI,sBAAsB;IAOnC,KAAK,IAAI,IAAI;IAIb,MAAM,IAAI,IAAI;IAId;;;;;;;;;OASG;IACG,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+B5F,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAQpC,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAqBpC,OAAO,CAAC,WAAW;CAKpB"}