@nexus-cortex/core 4.26.0

package/dist/tools/historical/RequestHistoricalContext.js

@@ -0,0 +1,250 @@
+/**
+ * RequestHistoricalContext Tool
+ *
+ * Requests historical context using a cheap helper model (e.g., FREE Gemma).
+ * Cost-effective way to access archived context outside the main model's window.
+ *
+ * Phase 1.5: Week 3 Implementation
+ * Based on: CORTEX_V4_PHASE_1.5_ARCHITECTURE.md, Part 4
+ */
+import { isSystemMessage } from '../../session/MessageTypes.js';
+import { StoredCompactionManager } from '../../conversation/StoredCompactionManager.js';
+/**
+ * Tool for requesting historical context via helper models
+ */
+export class RequestHistoricalContextTool {
+    compactionManager;
+    helperAdapter;
+    helperConfig;
+    constructor(workspaceRoot, helperAdapter, helperConfig) {
+        this.compactionManager = new StoredCompactionManager(workspaceRoot);
+        this.helperAdapter = helperAdapter;
+        this.helperConfig = helperConfig;
+    }
+    /**
+     * Tool definition for registration
+     */
+    static get definition() {
+        return {
+            name: 'RequestHistoricalContext',
+            description: 'Request historical context using cheap helper model. Cost-effective for accessing archived context.',
+            input_schema: {
+                type: 'object',
+                properties: {
+                    query: {
+                        type: 'string',
+                        description: 'Query describing what historical context is needed'
+                    },
+                    detailLevel: {
+                        type: 'string',
+                        enum: ['brief', 'standard', 'detailed'],
+                        description: 'Detail level for the response',
+                        default: 'standard'
+                    },
+                    maxTokens: {
+                        type: 'number',
+                        description: 'Maximum tokens for the response',
+                        default: 1000
+                    },
+                    useHelperModel: {
+                        type: 'boolean',
+                        description: 'Whether to use helper model (vs main model)',
+                        default: true
+                    }
+                },
+                required: ['query']
+            }
+        };
+    }
+    /**
+     * Execute the historical context request
+     */
+    async execute(input, sessionId, recentMessages) {
+        const startTime = Date.now();
+        const detailLevel = input.detailLevel || 'standard';
+        const maxTokens = input.maxTokens || 1000;
+        const useHelperModel = input.useHelperModel !== false;
+        // Gather relevant historical data
+        const relevantData = await this.gatherRelevantData(input.query, sessionId, recentMessages);
+        // Generate context based on detail level
+        let context;
+        let modelUsed;
+        let cost;
+        if (useHelperModel && this.helperAdapter) {
+            // Use FREE Gemma model
+            const result = await this.generateContextWithGemma(relevantData, input.query, detailLevel, maxTokens);
+            context = result.context;
+            modelUsed = result.model;
+            cost = 0; // Gemma is FREE!
+        }
+        else {
+            // Fallback to simple extraction
+            context = this.generateSimpleContext(relevantData, input.query, detailLevel, maxTokens);
+            modelUsed = 'simple-extraction';
+            cost = 0;
+        }
+        const processingTime = Date.now() - startTime;
+        return {
+            context,
+            sources: relevantData.sources,
+            tokensUsed: Math.ceil(context.length / 4), // Estimate
+            modelUsed,
+            cost,
+            processingTime
+        };
+    }
+    /**
+     * Gather relevant data for the query
+     */
+    async gatherRelevantData(query, sessionId, recentMessages) {
+        const sources = [];
+        const contentParts = [];
+        // Search compactions for relevant content
+        const compactions = await this.compactionManager.searchCompactions(query, sessionId);
+        for (const compaction of compactions.slice(0, 3)) { // Limit to top 3
+            contentParts.push(`[Compacted Section - Turns ${compaction.timeline.turnRange.start}-${compaction.timeline.turnRange.end}]\n` +
+                `${compaction.summaries.standard}\n`);
+            sources.push({
+                turnNumber: compaction.timeline.turnRange.start,
+                timestamp: new Date(compaction.timestamp),
+                isCompacted: true,
+                compactionId: compaction.id
+            });
+        }
+        // Search recent messages
+        const queryLower = query.toLowerCase();
+        const relevantMessages = recentMessages.filter(msg => {
+            const content = this.extractMessageContent(msg);
+            return content.toLowerCase().includes(queryLower);
+        }).slice(0, 5); // Limit to top 5
+        for (const msg of relevantMessages) {
+            const index = recentMessages.indexOf(msg);
+            const content = this.extractMessageContent(msg);
+            const role = this.getMessageRole(msg);
+            contentParts.push(`[Turn ${index + 1}]\n` +
+                `Role: ${role}\n` +
+                `Content: ${this.truncateContent(content, 200)}\n`);
+            sources.push({
+                turnNumber: index + 1,
+                timestamp: new Date(msg.timestamp),
+                isCompacted: false
+            });
+        }
+        return {
+            content: contentParts.join('\n---\n'),
+            sources
+        };
+    }
+    /**
+     * Generate context using configured helper model
+     */
+    async generateContextWithGemma(relevantData, query, detailLevel, maxTokens) {
+        if (!this.helperAdapter || !this.helperConfig) {
+            throw new Error('Helper adapter not configured');
+        }
+        // Prepare prompt based on detail level
+        let prompt;
+        let targetTokens;
+        switch (detailLevel) {
+            case 'brief':
+                targetTokens = Math.min(maxTokens, 200);
+                prompt = `Based on the following historical conversation data, provide a BRIEF answer (max ${targetTokens} tokens) to this query: "${query}"
+
+Historical Data:
+${relevantData.content}
+
+Provide only the essential information needed to answer the query.`;
+                break;
+            case 'detailed':
+                targetTokens = Math.min(maxTokens, 2000);
+                prompt = `Based on the following historical conversation data, provide a DETAILED answer (max ${targetTokens} tokens) to this query: "${query}"
+
+Historical Data:
+${relevantData.content}
+
+Include all relevant details, context, and examples from the historical data.`;
+                break;
+            case 'standard':
+            default:
+                targetTokens = Math.min(maxTokens, 1000);
+                prompt = `Based on the following historical conversation data, provide a clear answer (max ${targetTokens} tokens) to this query: "${query}"
+
+Historical Data:
+${relevantData.content}
+
+Provide a comprehensive but concise response with key information.`;
+                break;
+        }
+        // Use configured helper adapter to generate context
+        const response = await this.helperAdapter.summarizeToolResult(prompt, this.helperConfig, targetTokens);
+        return {
+            context: response.summary,
+            model: response.helperModelId
+        };
+    }
+    /**
+     * Generate simple context without helper model
+     */
+    generateSimpleContext(relevantData, query, detailLevel, maxTokens) {
+        const lines = relevantData.content.split('\n');
+        let context = `Historical context for query: "${query}"\n\n`;
+        switch (detailLevel) {
+            case 'brief':
+                // Take first few lines
+                context += lines.slice(0, 10).join('\n');
+                break;
+            case 'detailed':
+                // Take more content
+                context += lines.slice(0, 50).join('\n');
+                break;
+            case 'standard':
+            default:
+                // Take moderate amount
+                context += lines.slice(0, 25).join('\n');
+                break;
+        }
+        // Truncate to max tokens
+        const maxChars = maxTokens * 4; // ~4 chars per token
+        if (context.length > maxChars) {
+            context = context.substring(0, maxChars) + '...';
+        }
+        return context;
+    }
+    /**
+     * Truncate content to specified length
+     */
+    truncateContent(content, maxLength) {
+        if (content.length <= maxLength) {
+            return content;
+        }
+        return content.substring(0, maxLength) + '...';
+    }
+    /**
+     * Extract content from any message type
+     */
+    extractMessageContent(msg) {
+        if (isSystemMessage(msg)) {
+            return msg.content;
+        }
+        if ('message' in msg && msg.message.content) {
+            if (typeof msg.message.content === 'string') {
+                return msg.message.content;
+            }
+            return JSON.stringify(msg.message.content);
+        }
+        return '';
+    }
+    /**
+     * Get role from message
+     */
+    getMessageRole(msg) {
+        if (isSystemMessage(msg)) {
+            return 'system';
+        }
+        if ('message' in msg) {
+            return msg.message.role;
+        }
+        return msg.type;
+    }
+}
+//# sourceMappingURL=RequestHistoricalContext.js.map

package/dist/tools/historical/RequestHistoricalContext.js.map

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

package/dist/tools/historical/SearchConversationHistory.d.ts

@@ -0,0 +1,117 @@
+/**
+ * SearchConversationHistory Tool
+ *
+ * Searches conversation history including both recent messages and compacted boundaries.
+ * Provides semantic search across the full conversation timeline.
+ *
+ * Phase 1.5: Week 3 Implementation
+ * Based on: CORTEX_V4_PHASE_1.5_ARCHITECTURE.md, Part 4
+ */
+import type { Message } from '../../session/MessageTypes.js';
+/**
+ * Input schema for SearchConversationHistory tool
+ */
+export interface SearchConversationHistoryInput {
+    /** Search query string */
+    query: string;
+    /** Maximum number of results to return */
+    maxResults?: number;
+    /** Time range filter */
+    timeRange?: {
+        start: Date;
+        end: Date;
+    };
+    /** Include compacted messages in search */
+    includeCompacted?: boolean;
+}
+/**
+ * Search result from conversation history
+ */
+export interface SearchResult {
+    /** Session ID this result came from */
+    sessionId: string;
+    /** Turn number in conversation */
+    turnNumber: number;
+    /** Timestamp of the message */
+    timestamp: Date;
+    /** Preview of the content */
+    preview: string;
+    /** Relevance score (0-100) */
+    relevanceScore: number;
+    /** Whether this result is from a compacted section */
+    isCompacted: boolean;
+    /** Compaction ID if applicable */
+    compactionId?: string;
+    /** Message ID */
+    messageId?: string;
+}
+/**
+ * Tool for searching conversation history
+ */
+export declare class SearchConversationHistoryTool {
+    private compactionManager;
+    constructor(workspaceRoot?: string);
+    /**
+     * Tool definition for registration
+     */
+    static get definition(): {
+        name: string;
+        description: string;
+        input_schema: {
+            type: string;
+            properties: {
+                query: {
+                    type: string;
+                    description: string;
+                };
+                maxResults: {
+                    type: string;
+                    description: string;
+                    default: number;
+                };
+                timeRange: {
+                    type: string;
+                    properties: {
+                        start: {
+                            type: string;
+                            format: string;
+                        };
+                        end: {
+                            type: string;
+                            format: string;
+                        };
+                    };
+                    description: string;
+                };
+                includeCompacted: {
+                    type: string;
+                    description: string;
+                    default: boolean;
+                };
+            };
+            required: string[];
+        };
+    };
+    /**
+     * Execute the search
+     */
+    execute(input: SearchConversationHistoryInput, sessionId: string, recentMessages: Message[]): Promise<SearchResult[]>;
+    /**
+     * Search recent uncompacted messages
+     */
+    private searchRecentMessages;
+    /**
+     * Search compacted messages
+     */
+    private searchCompactedMessages;
+    /**
+     * Extract content from any message type
+     * Combines all searchable content (content + tool_use + tool_result)
+     */
+    private extractMessageContent;
+    /**
+     * Extract a preview around the matched query
+     */
+    private extractPreview;
+}
+//# sourceMappingURL=SearchConversationHistory.d.ts.map

package/dist/tools/historical/SearchConversationHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchConversationHistory.d.ts","sourceRoot":"","sources":["../../../src/tools/historical/SearchConversationHistory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAI7D;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IAEd,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,wBAAwB;IACxB,SAAS,CAAC,EAAE;QACV,KAAK,EAAE,IAAI,CAAC;QACZ,GAAG,EAAE,IAAI,CAAC;KACX,CAAC;IAEF,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAElB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IAEnB,+BAA+B;IAC/B,SAAS,EAAE,IAAI,CAAC;IAEhB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAEhB,8BAA8B;IAC9B,cAAc,EAAE,MAAM,CAAC;IAEvB,sDAAsD;IACtD,WAAW,EAAE,OAAO,CAAC;IAErB,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,6BAA6B;IACxC,OAAO,CAAC,iBAAiB,CAA0B;gBAEvC,aAAa,CAAC,EAAE,MAAM;IAIlC;;OAEG;IACH,MAAM,KAAK,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAiCpB;IAED;;OAEG;IACG,OAAO,CACX,KAAK,EAAE,8BAA8B,EACrC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,OAAO,EAAE,GACxB,OAAO,CAAC,YAAY,EAAE,CAAC;IAoC1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmD5B;;OAEG;YACW,uBAAuB;IA4ErC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAqC7B;;OAEG;IACH,OAAO,CAAC,cAAc;CAkBvB"}

package/dist/tools/historical/SearchConversationHistory.js

@@ -0,0 +1,239 @@
+/**
+ * SearchConversationHistory Tool
+ *
+ * Searches conversation history including both recent messages and compacted boundaries.
+ * Provides semantic search across the full conversation timeline.
+ *
+ * Phase 1.5: Week 3 Implementation
+ * Based on: CORTEX_V4_PHASE_1.5_ARCHITECTURE.md, Part 4
+ */
+import { isSystemMessage } from '../../session/MessageTypes.js';
+import { StoredCompactionManager } from '../../conversation/StoredCompactionManager.js';
+/**
+ * Tool for searching conversation history
+ */
+export class SearchConversationHistoryTool {
+    compactionManager;
+    constructor(workspaceRoot) {
+        this.compactionManager = new StoredCompactionManager(workspaceRoot);
+    }
+    /**
+     * Tool definition for registration
+     */
+    static get definition() {
+        return {
+            name: 'SearchConversationHistory',
+            description: 'Search through conversation history including compacted boundaries',
+            input_schema: {
+                type: 'object',
+                properties: {
+                    query: {
+                        type: 'string',
+                        description: 'Search query string'
+                    },
+                    maxResults: {
+                        type: 'number',
+                        description: 'Maximum number of results to return',
+                        default: 10
+                    },
+                    timeRange: {
+                        type: 'object',
+                        properties: {
+                            start: { type: 'string', format: 'date-time' },
+                            end: { type: 'string', format: 'date-time' }
+                        },
+                        description: 'Optional time range filter'
+                    },
+                    includeCompacted: {
+                        type: 'boolean',
+                        description: 'Include compacted messages in search',
+                        default: true
+                    }
+                },
+                required: ['query']
+            }
+        };
+    }
+    /**
+     * Execute the search
+     */
+    async execute(input, sessionId, recentMessages) {
+        const results = [];
+        const queryLower = input.query.toLowerCase();
+        const maxResults = input.maxResults || 10;
+        // Search recent uncompacted messages
+        const recentResults = this.searchRecentMessages(recentMessages, queryLower, input.timeRange, sessionId);
+        results.push(...recentResults);
+        // Search compacted boundaries if requested
+        if (input.includeCompacted !== false) {
+            const compactedResults = await this.searchCompactedMessages(sessionId, queryLower, input.timeRange);
+            results.push(...compactedResults);
+        }
+        // Sort by relevance score and timestamp
+        results.sort((a, b) => {
+            if (Math.abs(a.relevanceScore - b.relevanceScore) > 10) {
+                return b.relevanceScore - a.relevanceScore;
+            }
+            return b.timestamp.getTime() - a.timestamp.getTime();
+        });
+        // Return top N results
+        return results.slice(0, maxResults);
+    }
+    /**
+     * Search recent uncompacted messages
+     */
+    searchRecentMessages(messages, queryLower, timeRange, sessionId) {
+        const results = [];
+        messages.forEach((message, index) => {
+            // Apply time range filter
+            if (timeRange) {
+                const messageTime = new Date(message.timestamp);
+                if (messageTime < timeRange.start || messageTime > timeRange.end) {
+                    return;
+                }
+            }
+            // Calculate relevance score
+            let score = 0;
+            let matchedContent = '';
+            // Search in message content
+            const content = this.extractMessageContent(message);
+            if (content && content.toLowerCase().includes(queryLower)) {
+                score += 50;
+                matchedContent = this.extractPreview(content, queryLower);
+            }
+            if (score > 0) {
+                // Extract source session ID from tagged message (for cross-session search)
+                // or fall back to timeline.sessionId or provided sessionId
+                const sourceSessionId = message._sourceSessionId
+                    || message.timeline?.sessionId
+                    || sessionId
+                    || 'unknown';
+                results.push({
+                    sessionId: sourceSessionId,
+                    turnNumber: index + 1,
+                    timestamp: new Date(message.timestamp),
+                    preview: matchedContent,
+                    relevanceScore: Math.min(100, score),
+                    isCompacted: false,
+                    messageId: message.uuid || message.id
+                });
+            }
+        });
+        return results;
+    }
+    /**
+     * Search compacted messages
+     */
+    async searchCompactedMessages(sessionId, queryLower, timeRange) {
+        const results = [];
+        // Query compactions for this session
+        const compactions = await this.compactionManager.searchCompactions(queryLower, sessionId);
+        for (const compaction of compactions) {
+            // Apply time range filter
+            if (timeRange) {
+                const compactionTime = new Date(compaction.timestamp);
+                if (compactionTime < timeRange.start || compactionTime > timeRange.end) {
+                    continue;
+                }
+            }
+            // Calculate relevance based on where match was found
+            let score = 0;
+            let preview = '';
+            // Check compressed summary
+            if (compaction.summaries.compressed.toLowerCase().includes(queryLower)) {
+                score += 30;
+                preview = this.extractPreview(compaction.summaries.compressed, queryLower);
+            }
+            // Check standard summary
+            if (compaction.summaries.standard.toLowerCase().includes(queryLower)) {
+                score += 40;
+                if (!preview) {
+                    preview = this.extractPreview(compaction.summaries.standard, queryLower);
+                }
+            }
+            // Check detailed summary
+            if (compaction.summaries.detailed.toLowerCase().includes(queryLower)) {
+                score += 20;
+                if (!preview) {
+                    preview = this.extractPreview(compaction.summaries.detailed, queryLower);
+                }
+            }
+            // Check metadata
+            const metadata = compaction.summaries.metadata;
+            if (metadata.topics.some(t => t.toLowerCase().includes(queryLower))) {
+                score += 50;
+                if (!preview) {
+                    preview = `Topic: ${metadata.topics.find(t => t.toLowerCase().includes(queryLower))}`;
+                }
+            }
+            if (score > 0) {
+                // Add result for the compaction boundary
+                results.push({
+                    sessionId: sessionId,
+                    turnNumber: compaction.timeline.turnRange.start,
+                    timestamp: new Date(compaction.timestamp),
+                    preview: preview || compaction.summaries.compressed.substring(0, 150),
+                    relevanceScore: Math.min(100, score),
+                    isCompacted: true,
+                    compactionId: compaction.id
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Extract content from any message type
+     * Combines all searchable content (content + tool_use + tool_result)
+     */
+    extractMessageContent(msg) {
+        const msgAny = msg;
+        const parts = [];
+        // Handle flat content (CanonicalMessage, test fixtures)
+        if (msgAny.content && typeof msgAny.content === 'string') {
+            parts.push(msgAny.content);
+        }
+        // Handle SystemMessage
+        if (isSystemMessage(msg) && msg.content) {
+            parts.push(msg.content);
+        }
+        // Handle nested message.content (real Message types)
+        if ('message' in msg && msg.message.content) {
+            if (typeof msg.message.content === 'string') {
+                parts.push(msg.message.content);
+            }
+            else {
+                parts.push(JSON.stringify(msg.message.content));
+            }
+        }
+        // Handle tool_use - ALWAYS include if present
+        if (msgAny.tool_use) {
+            parts.push(JSON.stringify(msgAny.tool_use));
+        }
+        // Handle tool_result - ALWAYS include if present
+        if (msgAny.tool_result) {
+            parts.push(JSON.stringify(msgAny.tool_result));
+        }
+        // Combine all parts with space separator
+        return parts.join(' ');
+    }
+    /**
+     * Extract a preview around the matched query
+     */
+    extractPreview(content, query, maxLength = 150) {
+        const index = content.toLowerCase().indexOf(query);
+        if (index === -1) {
+            return content.substring(0, maxLength);
+        }
+        // Get context around the match
+        const start = Math.max(0, index - 50);
+        const end = Math.min(content.length, index + query.length + 50);
+        let preview = content.substring(start, end);
+        // Add ellipsis if truncated
+        if (start > 0)
+            preview = '...' + preview;
+        if (end < content.length)
+            preview = preview + '...';
+        return preview;
+    }
+}
+//# sourceMappingURL=SearchConversationHistory.js.map

package/dist/tools/historical/SearchConversationHistory.js.map

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

package/dist/tools/historical/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Historical Retrieval Tools
+ *
+ * Exports for the 6 historical retrieval tools and the coordinating service.
+ * Phase 1.5: Week 3 Implementation
+ */
+export * from './SearchConversationHistory.js';
+export * from './GetConversationSegment.js';
+export * from './ListCompactionBoundaries.js';
+export * from './RequestHistoricalContext.js';
+export * from './ListSessions.js';
+export * from './LoadSession.js';
+export * from './HistoricalContextService.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/historical/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/historical/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC"}

package/dist/tools/historical/index.js

@@ -0,0 +1,14 @@
+/**
+ * Historical Retrieval Tools
+ *
+ * Exports for the 6 historical retrieval tools and the coordinating service.
+ * Phase 1.5: Week 3 Implementation
+ */
+export * from './SearchConversationHistory.js';
+export * from './GetConversationSegment.js';
+export * from './ListCompactionBoundaries.js';
+export * from './RequestHistoricalContext.js';
+export * from './ListSessions.js';
+export * from './LoadSession.js';
+export * from './HistoricalContextService.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/historical/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/historical/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC"}