specmem-hardwicksoftware 3.5.99

package/dist/tools/goofy/whatDidIMean.d.ts

@@ -0,0 +1,113 @@
+/**
+ * whatDidIMean - recall memories by ID or filters
+ *
+ * when you need to get specific memories back
+ * supports pagination, sorting, and filtering
+ */
+import { MCPTool } from '../../mcp/toolRegistry.js';
+import { DatabaseManager } from '../../database.js';
+import { RecallMemoryParams, Memory } from '../../types/index.js';
+/**
+ * WhatDidIMean - memory recall tool
+ *
+ * retrieves memories by ID or filter criteria
+ * supports pagination because we might have A LOT of memories
+ *
+ * Returns human-readable format for better readability
+ */
+export declare class WhatDidIMean implements MCPTool<RecallMemoryParams, string> {
+    private db;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            id: {
+                type: string;
+                format: string;
+                description: string;
+            };
+            tags: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            limit: {
+                type: string;
+                default: number;
+                minimum: number;
+                maximum: number;
+                description: string;
+            };
+            offset: {
+                type: string;
+                default: number;
+                minimum: number;
+                description: string;
+            };
+            orderBy: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+            orderDirection: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+            summarize: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
+            maxContentLength: {
+                type: string;
+                default: number;
+                description: string;
+            };
+        };
+    };
+    private compactionOpts;
+    constructor(db: DatabaseManager);
+    execute(params: RecallMemoryParams & {
+        summarize?: boolean;
+        maxContentLength?: number;
+    }): Promise<string>;
+    /**
+     * get a single memory by ID
+     *
+     * also updates access count cuz we tracking that
+     */
+    private getMemoryById;
+    /**
+     * get memories with filters, pagination, and sorting
+     */
+    private getMemoriesWithFilters;
+    /**
+     * get related memories through the relationship graph
+     *
+     * traverses memory_relations to find connected memories
+     */
+    getRelatedMemories(memoryId: string, depth?: number): Promise<Memory[]>;
+    /**
+     * get all chunks of a chunked memory
+     *
+     * useful when you stored something big and it got split
+     */
+    getMemoryChunks(parentId: string): Promise<Memory[]>;
+    private getOrderColumn;
+    private rowToMemory;
+    private parseEmbedding;
+    /**
+     * Extract semantic keywords from content for drill-down context
+     * Returns Chinese-compacted keywords sorted by relevance
+     *
+     * This replaces the useless 1536-number embedding with actual meaningful words
+     */
+    private extractSemanticKeywords;
+}
+//# sourceMappingURL=whatDidIMean.d.ts.map

package/dist/tools/goofy/whatDidIMean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatDidIMean.d.ts","sourceRoot":"","sources":["../../../src/tools/goofy/whatDidIMean.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAkCnG;;;;;;;GAOG;AACH,qBAAa,YAAa,YAAW,OAAO,CAAC,kBAAkB,EAAE,MAAM,CAAC;IA0D1D,OAAO,CAAC,EAAE;IAzDtB,IAAI,SAAgB;IACpB,WAAW,SAA6G;IAExH,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAiDT;IAGF,OAAO,CAAC,cAAc,CAA0D;gBAE5D,EAAE,EAAE,eAAe;IAEjC,OAAO,CAAC,MAAM,EAAE,kBAAkB,GAAG;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA0D/G;;;;OAIG;YACW,aAAa;IAoB3B;;OAEG;YACW,sBAAsB;IA0EpC;;;;OAIG;IACG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA0ChF;;;;OAIG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAyB1D,OAAO,CAAC,cAAc;IAqBtB,OAAO,CAAC,WAAW;IA8DnB,OAAO,CAAC,cAAc;IAKtB;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;CA4ChC"}

package/dist/tools/goofy/whatDidIMean.js

@@ -0,0 +1,401 @@
+/**
+ * whatDidIMean - recall memories by ID or filters
+ *
+ * when you need to get specific memories back
+ * supports pagination, sorting, and filtering
+ */
+import { logger } from '../../utils/logger.js';
+import { smartCompress } from '../../utils/tokenCompressor.js';
+import { buildProjectWhereClause, getProjectContext } from '../../services/ProjectContext.js';
+import { formatHumanReadable } from '../../utils/humanReadableOutput.js';
+/**
+ * WhatDidIMean - memory recall tool
+ *
+ * retrieves memories by ID or filter criteria
+ * supports pagination because we might have A LOT of memories
+ *
+ * Returns human-readable format for better readability
+ */
+export class WhatDidIMean {
+    db;
+    name = 'get_memory';
+    description = 'Get memories by ID or filter criteria - supports pagination and sorting. Returns human-readable format.';
+    inputSchema = {
+        type: 'object',
+        properties: {
+            id: {
+                type: 'string',
+                format: 'uuid',
+                description: 'specific memory ID to retrieve'
+            },
+            tags: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'filter by tags (OR logic)'
+            },
+            limit: {
+                type: 'number',
+                default: 50,
+                minimum: 1,
+                maximum: 1000,
+                description: 'max number of memories to return'
+            },
+            offset: {
+                type: 'number',
+                default: 0,
+                minimum: 0,
+                description: 'skip this many memories for pagination'
+            },
+            orderBy: {
+                type: 'string',
+                enum: ['created', 'updated', 'accessed', 'importance'],
+                default: 'created',
+                description: 'how to sort the results'
+            },
+            orderDirection: {
+                type: 'string',
+                enum: ['asc', 'desc'],
+                default: 'desc',
+                description: 'sort direction'
+            },
+            summarize: {
+                type: 'boolean',
+                default: false,
+                description: 'Optional - truncate content to save context when browsing. Default false (full content for drill-down)'
+            },
+            maxContentLength: {
+                type: 'number',
+                default: 0,
+                description: 'Optional - truncate content to this many chars. 0 = full content (default)'
+            }
+        }
+    };
+    // Compaction options interface
+    compactionOpts = {};
+    constructor(db) {
+        this.db = db;
+    }
+    async execute(params) {
+        logger.debug({ params }, 'recalling memories');
+        // Store compaction options for use in rowToMemory
+        this.compactionOpts = {
+            summarize: params.summarize,
+            maxContentLength: params.maxContentLength
+        };
+        try {
+            // if we got a specific ID, just get that one
+            if (params.id) {
+                const memory = await this.getMemoryById(params.id);
+                if (!memory) {
+                    // Return empty results - memory not found
+                    return formatHumanReadable('get_memory', [], {
+                        grey: true,
+                        showSimilarity: false,
+                        maxContentLength: params.maxContentLength || 300
+                    });
+                }
+                // Convert single memory to human-readable format
+                const humanReadableData = [{
+                        id: memory.id,
+                        similarity: 1.0,
+                        content: memory.content || '',
+                    }];
+                return formatHumanReadable('get_memory', humanReadableData, {
+                    grey: true,
+                    showSimilarity: false,
+                    maxContentLength: params.maxContentLength || 300
+                });
+            }
+            // otherwise do a filtered query - return as human-readable
+            const result = await this.getMemoriesWithFilters(params);
+            // Convert memories array to human-readable format
+            const humanReadableData = result.memories.map(m => ({
+                id: m.id,
+                similarity: 0.5,
+                content: m.content || '',
+            }));
+            return formatHumanReadable('get_memory', humanReadableData, {
+                grey: true,
+                showSimilarity: true,
+                maxContentLength: params.maxContentLength || 300
+            });
+        }
+        catch (error) {
+            logger.error({ error, params }, 'recall failed');
+            throw error;
+        }
+    }
+    /**
+     * get a single memory by ID
+     *
+     * also updates access count cuz we tracking that
+     */
+    async getMemoryById(id) {
+        const result = await this.db.query(`UPDATE memories
+       SET access_count = access_count + 1,
+           last_accessed_at = NOW()
+       WHERE id = $1
+       RETURNING
+         id, content, memory_type, importance, tags, metadata,
+         embedding, created_at, updated_at, access_count, last_accessed_at,
+         expires_at, consolidated_from, image_data, image_mime_type`, [id]);
+        if (result.rows.length === 0) {
+            return null;
+        }
+        return this.rowToMemory(result.rows[0]);
+    }
+    /**
+     * get memories with filters, pagination, and sorting
+     */
+    async getMemoriesWithFilters(params) {
+        const conditions = [];
+        const queryParams = [];
+        let paramIndex = 1;
+        // PROJECT NAMESPACING: Filter by current project
+        const projectFilter = buildProjectWhereClause(paramIndex);
+        conditions.push(projectFilter.sql);
+        queryParams.push(projectFilter.param);
+        paramIndex = projectFilter.nextIndex;
+        // tags filter
+        if (params.tags?.length) {
+            conditions.push(`tags && $${paramIndex}::text[]`);
+            queryParams.push(params.tags);
+            paramIndex++;
+        }
+        // default: exclude expired
+        conditions.push('(expires_at IS NULL OR expires_at > NOW())');
+        // build ORDER BY clause
+        const orderColumn = this.getOrderColumn(params.orderBy ?? 'created');
+        const orderDirection = params.orderDirection === 'asc' ? 'ASC' : 'DESC';
+        const whereClause = conditions.length > 0
+            ? `WHERE ${conditions.join(' AND ')}`
+            : '';
+        // get total count first
+        const countResult = await this.db.query(`SELECT COUNT(*) as count FROM memories ${whereClause}`, queryParams);
+        const total = parseInt(countResult.rows[0]?.count ?? '0', 10);
+        // get the memories
+        const limit = params.limit ?? 50;
+        const offset = params.offset ?? 0;
+        const query = `
+      SELECT
+        id, content, memory_type, importance, tags, metadata,
+        embedding, created_at, updated_at, access_count, last_accessed_at,
+        expires_at, consolidated_from, image_data, image_mime_type
+      FROM memories
+      ${whereClause}
+      ORDER BY ${orderColumn} ${orderDirection} NULLS LAST
+      LIMIT ${limit}
+      OFFSET ${offset}
+    `;
+        const result = await this.db.query(query, queryParams);
+        // update access counts for retrieved memories
+        if (result.rows.length > 0) {
+            const ids = result.rows.map((r) => r.id);
+            await this.db.query(`UPDATE memories
+         SET access_count = access_count + 1,
+             last_accessed_at = NOW()
+         WHERE id = ANY($1::uuid[])`, [ids]);
+        }
+        return {
+            memories: result.rows.map((row) => this.rowToMemory(row)),
+            total,
+            hasMore: offset + result.rows.length < total,
+            page: { offset, limit }
+        };
+    }
+    /**
+     * get related memories through the relationship graph
+     *
+     * traverses memory_relations to find connected memories
+     */
+    async getRelatedMemories(memoryId, depth = 1) {
+        // PROJECT NAMESPACING: Filter by current project
+        const projectPath = getProjectContext().getProjectPath();
+        const query = `
+      WITH RECURSIVE related AS (
+        -- start with direct relations
+        SELECT target_id AS id, 1 AS depth
+        FROM memory_relations
+        WHERE source_id = $1
+
+        UNION
+
+        -- add reverse relations
+        SELECT source_id AS id, 1 AS depth
+        FROM memory_relations
+        WHERE target_id = $1
+
+        UNION ALL
+
+        -- traverse deeper
+        SELECT
+          CASE WHEN mr.source_id = r.id THEN mr.target_id ELSE mr.source_id END AS id,
+          r.depth + 1
+        FROM related r
+        JOIN memory_relations mr ON (mr.source_id = r.id OR mr.target_id = r.id)
+        WHERE r.depth < $2
+      )
+      SELECT DISTINCT m.*
+      FROM related r
+      JOIN memories m ON m.id = r.id
+      WHERE m.id != $1
+        AND (m.expires_at IS NULL OR m.expires_at > NOW())
+        AND m.project_path = $3
+      LIMIT 50
+    `;
+        const result = await this.db.query(query, [memoryId, depth, projectPath]);
+        return result.rows.map((row) => this.rowToMemory(row));
+    }
+    /**
+     * get all chunks of a chunked memory
+     *
+     * useful when you stored something big and it got split
+     */
+    async getMemoryChunks(parentId) {
+        // PROJECT NAMESPACING: Filter by current project
+        const projectPath = getProjectContext().getProjectPath();
+        const query = `
+      SELECT
+        id, content, memory_type, importance, tags, metadata,
+        embedding, created_at, updated_at, access_count, last_accessed_at,
+        expires_at, consolidated_from, image_data, image_mime_type
+      FROM memories
+      WHERE
+        (id = $1
+        OR tags @> ARRAY['parent-' || $1]::text[]
+        OR metadata->>'parentId' = $1)
+        AND project_path = $2
+      ORDER BY
+        CASE WHEN id = $1 THEN 0 ELSE 1 END,
+        (metadata->>'chunkIndex')::int NULLS LAST
+    `;
+        const result = await this.db.query(query, [parentId, projectPath]);
+        return result.rows.map((row) => this.rowToMemory(row));
+    }
+    getOrderColumn(orderBy) {
+        switch (orderBy) {
+            case 'created':
+                return 'created_at';
+            case 'updated':
+                return 'updated_at';
+            case 'accessed':
+                return 'last_accessed_at';
+            case 'importance':
+                return `CASE importance
+          WHEN 'critical' THEN 1
+          WHEN 'high' THEN 2
+          WHEN 'medium' THEN 3
+          WHEN 'low' THEN 4
+          WHEN 'trivial' THEN 5
+        END`;
+            default:
+                return 'created_at';
+        }
+    }
+    rowToMemory(row) {
+        // Apply Chinese Compactor approach with truncation + compression
+        let content = row.content;
+        let contentTruncated = false;
+        let compressionRatio = 1.0;
+        const originalLength = row.content.length;
+        // STEP 1: Truncate first based on options
+        if (this.compactionOpts.summarize) {
+            // Default summary: first 500 chars
+            if (content.length > 500) {
+                content = content.substring(0, 500) + '...';
+                contentTruncated = true;
+            }
+        }
+        else if (this.compactionOpts.maxContentLength && this.compactionOpts.maxContentLength > 0) {
+            if (content.length > this.compactionOpts.maxContentLength) {
+                content = content.substring(0, this.compactionOpts.maxContentLength) + '...';
+                contentTruncated = true;
+            }
+        }
+        // STEP 2: Apply Chinese compression for additional token savings
+        // Only compress if content is long enough to benefit
+        if (content.length > 50) {
+            const compressed = smartCompress(content, {
+                threshold: 0.80, // Allow slightly lossy for big savings
+                minLength: 30
+            });
+            content = compressed.result;
+            compressionRatio = compressed.compressionRatio;
+        }
+        return {
+            id: row.id,
+            content: content,
+            memoryType: row.memory_type,
+            importance: row.importance,
+            tags: row.tags,
+            metadata: {
+                ...row.metadata,
+                // Add truncation/compression indicators for drill-down awareness
+                ...(contentTruncated ? {
+                    _truncated: true,
+                    _len: originalLength,
+                    _drill: `get_memory id:${row.id.substring(0, 8)}`
+                } : {}),
+                ...(compressionRatio < 0.9 ? { _compressed: true } : {}),
+                // SEMANTIC HINTS: Extract keywords from content instead of raw embedding
+                _semanticHints: this.extractSemanticKeywords(row.content, row.tags)
+            },
+            embedding: undefined, // Replaced with semantic keywords in metadata._semanticHints
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+            accessCount: row.access_count,
+            lastAccessedAt: row.last_accessed_at ?? undefined,
+            expiresAt: row.expires_at ?? undefined,
+            consolidatedFrom: row.consolidated_from ?? undefined,
+            imageData: row.image_data ? row.image_data.toString('base64') : undefined,
+            imageMimeType: row.image_mime_type ?? undefined
+        };
+    }
+    parseEmbedding(embeddingStr) {
+        const cleaned = embeddingStr.replace(/[\[\]]/g, '');
+        return cleaned.split(',').map(Number);
+    }
+    /**
+     * Extract semantic keywords from content for drill-down context
+     * Returns Chinese-compacted keywords sorted by relevance
+     *
+     * This replaces the useless 1536-number embedding with actual meaningful words
+     */
+    extractSemanticKeywords(content, tags) {
+        // Extract technical terms (PascalCase, CONSTANTS, technical words)
+        const techTerms = content.match(/\b(?:[A-Z][a-z]+){2,}\b|\b[A-Z][A-Z0-9_]{2,}\b/g) || [];
+        // Extract code-related words
+        const codeWords = content.match(/\b(?:function|class|const|let|var|async|await|return|import|export|interface|type)\b/g) || [];
+        // Extract file paths
+        const filePaths = content.match(/(?:\/[\w.-]+)+\.(?:ts|js|tsx|jsx|py|go|rs|java|json|yaml|md|css|html|sql|sh)/g) || [];
+        // Extract common nouns and verbs (simple heuristic)
+        const words = content.toLowerCase().match(/\b[a-z]{4,}\b/g) || [];
+        const stopWords = new Set(['this', 'that', 'with', 'from', 'have', 'been', 'were', 'will', 'would', 'could', 'should']);
+        const meaningfulWords = words.filter(w => !stopWords.has(w));
+        // Count word frequency
+        const wordFreq = new Map();
+        for (const word of meaningfulWords) {
+            wordFreq.set(word, (wordFreq.get(word) || 0) + 1);
+        }
+        // Get top 10 most frequent words
+        const topWords = Array.from(wordFreq.entries())
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 10)
+            .map(([word]) => word);
+        // Combine all keywords
+        const keywords = [
+            ...new Set([
+                ...techTerms.slice(0, 5),
+                ...codeWords.slice(0, 3),
+                ...filePaths.slice(0, 2).map(p => p.split('/').pop().replace(/\.\w+$/, '')),
+                ...topWords.slice(0, 8),
+                ...tags.filter(t => !t.startsWith('claude-') && !t.startsWith('role:')).slice(0, 3)
+            ])
+        ];
+        // NO compression here - these keywords feed into Mini COT which expects English
+        // Compression happens on OUTPUT, not INPUT to Mini COT
+        const keywordString = keywords.join(', ');
+        return keywordString.slice(0, 200); // Max 200 chars
+    }
+}
+//# sourceMappingURL=whatDidIMean.js.map

package/dist/tools/goofy/whatDidIMean.js.map

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

package/dist/tools/goofy/yeahNahDeleteThat.d.ts

@@ -0,0 +1,109 @@
+/**
+ * yeahNahDeleteThat - yeet memories we dont need
+ *
+ * delete memories by ID, criteria, or expired status
+ * handles cascading deletes for relations too
+ *
+ * Now integrated with LWJEB event bus for memory:deleted events
+ * NOW WITH PROJECT ISOLATION - won't accidentally nuke other projects' data
+ */
+import { MCPTool } from '../../mcp/toolRegistry.js';
+import { DatabaseManager } from '../../database.js';
+import { DeleteMemoryParams } from '../../types/index.js';
+interface DeleteResult {
+    success: boolean;
+    deletedCount: number;
+    message: string;
+    deletedIds?: string[];
+}
+/**
+ * YeahNahDeleteThat - memory deletion tool
+ *
+ * nice try lmao - but fr we validate everything
+ * supports batch deletes and cleanup operations
+ *
+ * Emits LWJEB events: memory:deleted
+ */
+export declare class YeahNahDeleteThat implements MCPTool<DeleteMemoryParams, DeleteResult> {
+    private db;
+    name: string;
+    description: string;
+    private coordinator;
+    inputSchema: {
+        type: "object";
+        properties: {
+            id: {
+                type: string;
+                format: string;
+                description: string;
+            };
+            ids: {
+                type: string;
+                items: {
+                    type: string;
+                    format: string;
+                };
+                description: string;
+            };
+            olderThan: {
+                type: string;
+                format: string;
+                description: string;
+            };
+            tags: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            expiredOnly: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
+        };
+    };
+    constructor(db: DatabaseManager);
+    execute(params: DeleteMemoryParams): Promise<DeleteResult>;
+    /**
+     * delete a single memory by ID
+     * PROJECT ISOLATED: Only deletes from current project
+     */
+    private deleteById;
+    /**
+     * delete multiple memories by IDs
+     * PROJECT ISOLATED: Only deletes from current project
+     *
+     * uses batch delete for efficiency
+     */
+    private deleteByIds;
+    /**
+     * delete by criteria (tags, age, expired status)
+     * PROJECT ISOLATED: Only deletes from current project
+     */
+    private deleteByCriteria;
+    /**
+     * cleanup expired memories - scheduled task style
+     * PROJECT ISOLATED: Only cleans up current project's expired memories
+     *
+     * call this periodically to keep the db clean
+     */
+    cleanupExpired(): Promise<DeleteResult>;
+    /**
+     * delete orphaned relations
+     *
+     * cleanup relations where source or target no longer exists
+     */
+    cleanupOrphanedRelations(): Promise<number>;
+    /**
+     * delete consolidated source memories
+     * PROJECT ISOLATED: Only deletes from current project
+     *
+     * after consolidation, we can optionally remove the originals
+     */
+    deleteConsolidatedSources(consolidatedId: string): Promise<DeleteResult>;
+    private isValidUuid;
+}
+export {};
+//# sourceMappingURL=yeahNahDeleteThat.d.ts.map

package/dist/tools/goofy/yeahNahDeleteThat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yeahNahDeleteThat.d.ts","sourceRoot":"","sources":["../../../src/tools/goofy/yeahNahDeleteThat.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAM1D,UAAU,YAAY;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,qBAAa,iBAAkB,YAAW,OAAO,CAAC,kBAAkB,EAAE,YAAY,CAAC;IAoCrE,OAAO,CAAC,EAAE;IAnCtB,IAAI,SAAmB;IACvB,WAAW,SAA2F;IACtG,OAAO,CAAC,WAAW,CAAoB;IAEvC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA6BT;gBAEkB,EAAE,EAAE,eAAe;IAEjC,OAAO,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IA2ChE;;;OAGG;YACW,UAAU;IAmCxB;;;;;OAKG;YACW,WAAW;IA0CzB;;;OAGG;YACW,gBAAgB;IAsE9B;;;;;OAKG;IACG,cAAc,IAAI,OAAO,CAAC,YAAY,CAAC;IA0B7C;;;;OAIG;IACG,wBAAwB,IAAI,OAAO,CAAC,MAAM,CAAC;IAqBjD;;;;;OAKG;IACG,yBAAyB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA6C9E,OAAO,CAAC,WAAW;CAIpB"}