@nexus-cortex/executors 4.26.0

package/dist/implementations/file/WriteFileTool.js

@@ -0,0 +1,220 @@
+/**
+ * WriteFile Tool Executor
+ *
+ * Writes content to a specified file in the local filesystem.
+ * Can create new files or overwrite existing ones.
+ *
+ * Adapted from Gemini CLI patterns
+ */
+import fs from 'fs';
+import path from 'path';
+import { BaseTool } from '../../base/index.js';
+import { SchemaValidator } from '../../utils/SchemaValidator.js';
+import { makeRelative, shortenPath, fileExists, resolveFilePath, } from '../../utils/FileUtils.js';
+/**
+ * Document file extensions that get collapsible preview (no full content in metadata)
+ */
+const DOCUMENT_EXTENSIONS = ['.md', '.mdx', '.txt', '.rst', '.adoc', '.markdown'];
+/**
+ * Detect if a file is a document (markdown, text, etc.) vs code/other
+ */
+function isDocumentFile(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    return DOCUMENT_EXTENSIONS.includes(ext);
+}
+/**
+ * Detect programming language from file extension for syntax highlighting hints
+ */
+function detectLanguage(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    const languageMap = {
+        '.ts': 'typescript',
+        '.tsx': 'typescript',
+        '.js': 'javascript',
+        '.jsx': 'javascript',
+        '.py': 'python',
+        '.rb': 'ruby',
+        '.go': 'go',
+        '.rs': 'rust',
+        '.java': 'java',
+        '.c': 'c',
+        '.cpp': 'cpp',
+        '.h': 'c',
+        '.hpp': 'cpp',
+        '.cs': 'csharp',
+        '.php': 'php',
+        '.swift': 'swift',
+        '.kt': 'kotlin',
+        '.scala': 'scala',
+        '.r': 'r',
+        '.sql': 'sql',
+        '.sh': 'bash',
+        '.bash': 'bash',
+        '.zsh': 'bash',
+        '.json': 'json',
+        '.yaml': 'yaml',
+        '.yml': 'yaml',
+        '.toml': 'toml',
+        '.xml': 'xml',
+        '.html': 'html',
+        '.htm': 'html',
+        '.css': 'css',
+        '.scss': 'scss',
+        '.sass': 'sass',
+        '.less': 'less',
+        '.vue': 'vue',
+        '.svelte': 'svelte',
+    };
+    return languageMap[ext];
+}
+/**
+ * WriteFile Tool Executor
+ *
+ * Features:
+ * - Creates new files
+ * - Overwrites existing files
+ * - Creates parent directories if needed
+ * - Path normalization and validation
+ * - Security: prevents path traversal
+ */
+export class WriteFileTool extends BaseTool {
+    config;
+    constructor(config) {
+        super('Write', 'Write', 'Writes content to a specified file in the local filesystem. Can create new files or overwrite existing ones. Parent directories will be created if they do not exist.', {
+            type: 'object',
+            properties: {
+                file_path: {
+                    type: 'string',
+                    description: "The path to the file to write to (e.g., 'src/file.txt' or '/home/user/project/file.txt'). Can be absolute or relative to the current working directory.",
+                },
+                content: {
+                    type: 'string',
+                    description: 'The content to write to the file.',
+                },
+            },
+            required: ['file_path', 'content'],
+        });
+        this.config = config;
+    }
+    validateToolParams(params) {
+        // Schema validation
+        const schemaError = SchemaValidator.validate(this.parameterSchema, params);
+        if (schemaError) {
+            return schemaError;
+        }
+        // Normalize and resolve path (with smart fallback for doubled directory names)
+        let filePath = resolveFilePath(params.file_path, this.config.workingDirectory);
+        // Path validation: allow any absolute path (matching standard absolute-path behavior).
+        if (!path.isAbsolute(filePath)) {
+            return `File path must resolve to an absolute path: ${filePath}`;
+        }
+        // Update params with resolved path
+        params.file_path = filePath;
+        // Check if path is a directory
+        if (fileExists(filePath)) {
+            try {
+                const stats = fs.lstatSync(filePath);
+                if (stats.isDirectory()) {
+                    return `Path is a directory, not a file: ${filePath}`;
+                }
+            }
+            catch (error) {
+                return `Error accessing path: ${error.message}`;
+            }
+        }
+        return null;
+    }
+    getDescription(params) {
+        if (!params || !params.file_path) {
+            return 'Write file';
+        }
+        const relativePath = makeRelative(params.file_path, this.config.workingDirectory);
+        const shortened = shortenPath(relativePath);
+        const contentSize = params.content ? params.content.length : 0;
+        return `Write ${shortened} (${contentSize} bytes)`;
+    }
+    async execute(params, signal, updateOutput) {
+        const startTime = Date.now();
+        // Validate parameters
+        const validationError = this.validateToolParams(params);
+        if (validationError) {
+            return this.createErrorResult(validationError);
+        }
+        try {
+            // Ensure parent directory exists
+            const dirPath = path.dirname(params.file_path);
+            if (!fs.existsSync(dirPath)) {
+                fs.mkdirSync(dirPath, { recursive: true });
+            }
+            // Check if file exists (for reporting)
+            const existed = fileExists(params.file_path);
+            const action = existed ? 'Updated' : 'Created';
+            // Write file
+            await fs.promises.writeFile(params.file_path, params.content, 'utf-8');
+            // Get file stats
+            const stats = await fs.promises.stat(params.file_path);
+            const fileSize = stats.size;
+            const lineCount = params.content.split('\n').length;
+            // Format for display
+            const relativePath = makeRelative(params.file_path, this.config.workingDirectory);
+            const displayContent = `${action} ${relativePath} (${lineCount} lines, ${fileSize} bytes)`;
+            // Stream output if callback provided
+            if (updateOutput) {
+                updateOutput(displayContent);
+            }
+            // Build metadata with preview information
+            const metadata = {
+                executionTime: Date.now() - startTime,
+                resourcesUsed: {
+                    files: [params.file_path],
+                },
+                fileStats: {
+                    path: relativePath,
+                    size: fileSize,
+                    lines: lineCount,
+                    action,
+                    existed,
+                    operation: 'create',
+                },
+            };
+            // Add preview metadata based on file type
+            const isDocument = isDocumentFile(params.file_path);
+            if (isDocument) {
+                // Document files: store minimal metadata (content lazy-loaded on expand)
+                const wordCount = params.content.split(/\s+/).filter(Boolean).length;
+                const isMarkdown = params.file_path.endsWith('.md') || params.file_path.endsWith('.mdx');
+                metadata.documentPreview = {
+                    filePath: relativePath,
+                    lineCount,
+                    wordCount,
+                    isMarkdown,
+                };
+            }
+            else {
+                // Code/other files: store full content for preview persistence
+                metadata.writePreview = {
+                    filePath: relativePath,
+                    content: params.content,
+                    lineCount,
+                    byteSize: fileSize,
+                    language: detectLanguage(params.file_path),
+                };
+            }
+            return this.createSuccessResult(displayContent, metadata);
+        }
+        catch (error) {
+            // Handle write errors
+            if (error.code === 'EACCES') {
+                return this.createErrorResult(`Permission denied: ${params.file_path}`);
+            }
+            if (error.code === 'ENOSPC') {
+                return this.createErrorResult('No space left on device');
+            }
+            if (error.code === 'EROFS') {
+                return this.createErrorResult('Read-only file system');
+            }
+            return this.createErrorResult(`Failed to write file: ${error.message}`);
+        }
+    }
+}
+//# sourceMappingURL=WriteFileTool.js.map

package/dist/implementations/file/WriteFileTool.js.map

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

package/dist/implementations/file/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * File Operation Tool Executors
+ */
+export { ReadFileTool, type ReadFileToolParams } from './ReadFileTool.js';
+export { WriteFileTool, type WriteFileToolParams } from './WriteFileTool.js';
+export { WriteBinaryTool, type WriteBinaryToolParams } from './WriteBinaryTool.js';
+export { EditTool, type EditToolParams, FileReadTracker } from './EditTool.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/implementations/file/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/implementations/file/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/implementations/file/index.js

@@ -0,0 +1,8 @@
+/**
+ * File Operation Tool Executors
+ */
+export { ReadFileTool } from './ReadFileTool.js';
+export { WriteFileTool } from './WriteFileTool.js';
+export { WriteBinaryTool } from './WriteBinaryTool.js';
+export { EditTool, FileReadTracker } from './EditTool.js';
+//# sourceMappingURL=index.js.map

package/dist/implementations/file/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/implementations/file/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAA2B,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAA4B,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAA8B,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAuB,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/implementations/historical/GetConversationSegmentTool.d.ts

@@ -0,0 +1,44 @@
+/**
+ * GetConversationSegment Tool Executor
+ *
+ * Retrieves specific segments of conversation history at different detail levels.
+ * Can retrieve by turn range or checkpoint ID.
+ */
+import { BaseTool, type ToolResult } from '../../base/index.js';
+import type { ExecutorConfig } from '../../base/ToolRegistry.js';
+/**
+ * Parameters for the GetConversationSegment tool
+ */
+export interface GetConversationSegmentToolParams {
+    /** Turn range to retrieve */
+    turnRange?: {
+        start: number;
+        end: number;
+    };
+    /** Checkpoint ID to retrieve from */
+    checkpointId?: string;
+    /** Format of the returned segment */
+    format?: 'full' | 'summary' | 'compressed';
+}
+/**
+ * GetConversationSegment Tool Executor
+ *
+ * Features:
+ * - Retrieve by turn range or checkpoint
+ * - Multiple format options (full, summary, compressed)
+ * - Handles compacted sections
+ */
+export declare class GetConversationSegmentToolExecutor extends BaseTool<GetConversationSegmentToolParams, ToolResult> {
+    private config;
+    private historyStore;
+    private workspaceRoot;
+    constructor(config: ExecutorConfig);
+    validateToolParams(params: GetConversationSegmentToolParams): string | null;
+    getDescription(params: GetConversationSegmentToolParams): string;
+    execute(params: GetConversationSegmentToolParams, signal: AbortSignal, updateOutput?: (output: string) => void): Promise<ToolResult>;
+    /**
+     * Format conversation segment for display
+     */
+    private formatSegment;
+}
+//# sourceMappingURL=GetConversationSegmentTool.d.ts.map

package/dist/implementations/historical/GetConversationSegmentTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GetConversationSegmentTool.d.ts","sourceRoot":"","sources":["../../../src/implementations/historical/GetConversationSegmentTool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAOjE;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C,6BAA6B;IAC7B,SAAS,CAAC,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IAEF,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC;CAC5C;AAED;;;;;;;GAOG;AACH,qBAAa,kCAAmC,SAAQ,QAAQ,CAC9D,gCAAgC,EAChC,UAAU,CACX;IAIa,OAAO,CAAC,MAAM;IAH1B,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,aAAa,CAAS;gBAEV,MAAM,EAAE,cAAc;IA0C1C,kBAAkB,CAAC,MAAM,EAAE,gCAAgC,GAAG,MAAM,GAAG,IAAI;IA8B3E,cAAc,CAAC,MAAM,EAAE,gCAAgC,GAAG,MAAM;IAQ1D,OAAO,CACX,MAAM,EAAE,gCAAgC,EACxC,MAAM,EAAE,WAAW,EACnB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GACtC,OAAO,CAAC,UAAU,CAAC;IA+GtB;;OAEG;IACH,OAAO,CAAC,aAAa;CAiCtB"}

package/dist/implementations/historical/GetConversationSegmentTool.js

@@ -0,0 +1,220 @@
+/**
+ * GetConversationSegment Tool Executor
+ *
+ * Retrieves specific segments of conversation history at different detail levels.
+ * Can retrieve by turn range or checkpoint ID.
+ */
+import { BaseTool } from '../../base/index.js';
+import { SchemaValidator } from '../../utils/SchemaValidator.js';
+import { GetConversationSegmentTool as CoreGetSegmentTool, JSONLHistoryStore, } from '@nexus-cortex/core';
+/**
+ * GetConversationSegment Tool Executor
+ *
+ * Features:
+ * - Retrieve by turn range or checkpoint
+ * - Multiple format options (full, summary, compressed)
+ * - Handles compacted sections
+ */
+export class GetConversationSegmentToolExecutor extends BaseTool {
+    config;
+    historyStore;
+    workspaceRoot;
+    constructor(config) {
+        super('GetConversationSegment', 'GetConversationSegment', `Retrieve a specific segment of conversation history at different detail levels.
+
+Can retrieve by turn range or checkpoint ID in full, summary, or compressed format.`, {
+            type: 'object',
+            properties: {
+                turnRange: {
+                    type: 'object',
+                    properties: {
+                        start: {
+                            type: 'number',
+                            description: 'Starting turn number (1-based)',
+                        },
+                        end: {
+                            type: 'number',
+                            description: 'Ending turn number (inclusive)',
+                        },
+                    },
+                    description: 'Turn range to retrieve',
+                },
+                checkpointId: {
+                    type: 'string',
+                    description: 'Checkpoint ID to retrieve from',
+                },
+                format: {
+                    type: 'string',
+                    enum: ['full', 'summary', 'compressed'],
+                    description: 'Format of the returned segment',
+                    default: 'summary',
+                },
+            },
+        });
+        this.config = config;
+        this.workspaceRoot = config.workspaceRoot || config.workingDirectory;
+        this.historyStore = new JSONLHistoryStore({ baseDir: this.workspaceRoot });
+    }
+    validateToolParams(params) {
+        // Schema validation
+        const schemaError = SchemaValidator.validate(this.parameterSchema, params);
+        if (schemaError) {
+            return schemaError;
+        }
+        // Must provide either turnRange or checkpointId
+        if (!params.turnRange && !params.checkpointId) {
+            return 'Must provide either turnRange or checkpointId.';
+        }
+        // Validate turnRange if provided
+        if (params.turnRange) {
+            if (params.turnRange.start < 1) {
+                return 'Turn range start must be at least 1.';
+            }
+            if (params.turnRange.end < params.turnRange.start) {
+                return 'Turn range end must be >= start.';
+            }
+        }
+        // Validate format
+        if (params.format && !['full', 'summary', 'compressed'].includes(params.format)) {
+            return `Invalid format: ${params.format}. Must be 'full', 'summary', or 'compressed'.`;
+        }
+        return null;
+    }
+    getDescription(params) {
+        const format = params.format || 'summary';
+        if (params.turnRange) {
+            return `Getting conversation segment turns ${params.turnRange.start}-${params.turnRange.end} (${format})`;
+        }
+        return `Getting conversation segment from checkpoint ${params.checkpointId} (${format})`;
+    }
+    async execute(params, signal, updateOutput) {
+        const startTime = Date.now();
+        try {
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Segment retrieval was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Validate parameters
+            const validationError = this.validateToolParams(params);
+            if (validationError) {
+                return {
+                    ...this.createErrorResult(validationError),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Get session ID from config
+            const sessionId = this.config.sessionId;
+            if (!sessionId) {
+                return {
+                    ...this.createErrorResult('Session ID not provided in executor config. Historical tools require active session context.'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Load messages from session storage
+            const messages = await this.historyStore.loadSession(sessionId, this.workspaceRoot);
+            if (messages.length === 0) {
+                return {
+                    ...this.createSuccessResult('No messages found in session history.'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                        sessionId,
+                        messageCount: 0,
+                    },
+                };
+            }
+            // Create core tool and execute
+            const coreTool = new CoreGetSegmentTool(this.workspaceRoot);
+            const input = {
+                turnRange: params.turnRange,
+                checkpointId: params.checkpointId,
+                format: params.format,
+            };
+            const segment = await coreTool.execute(input, sessionId, messages);
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Segment retrieval was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            // Format output
+            const formattedOutput = this.formatSegment(segment, params.format || 'summary');
+            return {
+                ...this.createSuccessResult(formattedOutput),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    sessionId,
+                    totalTokens: segment.metadata.totalTokens,
+                    turnRange: segment.metadata.turnRange,
+                    hasCompactions: segment.metadata.hasCompactions,
+                    messageCount: segment.metadata.messageCount,
+                },
+            };
+        }
+        catch (error) {
+            // Check for abort
+            if (signal.aborted) {
+                return {
+                    ...this.createErrorResult('Segment retrieval was cancelled'),
+                    metadata: {
+                        executionTime: Date.now() - startTime,
+                    },
+                };
+            }
+            const errorMessage = error.message || String(error);
+            return {
+                ...this.createErrorResult(`Error retrieving conversation segment: ${errorMessage}`),
+                metadata: {
+                    executionTime: Date.now() - startTime,
+                    error: errorMessage,
+                },
+            };
+        }
+    }
+    /**
+     * Format conversation segment for display
+     */
+    formatSegment(segment, format) {
+        const lines = [];
+        lines.push('=== Conversation Segment ===\n\n');
+        lines.push(`Turns: ${segment.metadata.turnRange.start} - ${segment.metadata.turnRange.end}\n`);
+        lines.push(`Messages: ${segment.metadata.messageCount}\n`);
+        lines.push(`Estimated tokens: ${segment.metadata.totalTokens}\n`);
+        lines.push(`Has compactions: ${segment.metadata.hasCompactions ? 'Yes' : 'No'}\n\n`);
+        if (format === 'full' && segment.messages) {
+            lines.push('## Full Messages\n\n');
+            segment.messages.forEach((msg, index) => {
+                const msgAny = msg;
+                lines.push(`Message ${index + 1}:\n`);
+                if (msgAny.role) {
+                    lines.push(` Role: ${msgAny.role}\n`);
+                }
+                if (msgAny.content) {
+                    const content = typeof msgAny.content === 'string'
+                        ? msgAny.content
+                        : JSON.stringify(msgAny.content);
+                    lines.push(` Content: ${content.substring(0, 200)}${content.length > 200 ? '...' : ''}\n`);
+                }
+                lines.push('\n');
+            });
+        }
+        else if (segment.summary) {
+            lines.push('## Summary\n\n');
+            lines.push(segment.summary);
+            lines.push('\n');
+        }
+        return lines.join('');
+    }
+}
+//# sourceMappingURL=GetConversationSegmentTool.js.map

package/dist/implementations/historical/GetConversationSegmentTool.js.map

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

package/dist/implementations/historical/ListCompactionBoundariesTool.d.ts

@@ -0,0 +1,36 @@
+/**
+ * ListCompactionBoundaries Tool Executor
+ *
+ * Lists all compaction boundaries (conversation summaries) with metadata.
+ * Provides an overview of the compaction history for the session.
+ */
+import { BaseTool, type ToolResult } from '../../base/index.js';
+import type { ExecutorConfig } from '../../base/ToolRegistry.js';
+/**
+ * Parameters for the ListCompactionBoundaries tool
+ */
+export interface ListCompactionBoundariesToolParams {
+    /** Include detailed metadata in response */
+    includeMetadata?: boolean;
+}
+/**
+ * ListCompactionBoundaries Tool Executor
+ *
+ * Features:
+ * - Lists all compaction boundaries chronologically
+ * - Shows token savings and compression ratios
+ * - Optional detailed metadata (topics, decisions, tools used)
+ */
+export declare class ListCompactionBoundariesToolExecutor extends BaseTool<ListCompactionBoundariesToolParams, ToolResult> {
+    private config;
+    private workspaceRoot;
+    constructor(config: ExecutorConfig);
+    validateToolParams(params: ListCompactionBoundariesToolParams): string | null;
+    getDescription(params: ListCompactionBoundariesToolParams): string;
+    execute(params: ListCompactionBoundariesToolParams, signal: AbortSignal, updateOutput?: (output: string) => void): Promise<ToolResult>;
+    /**
+     * Format compaction boundaries for display
+     */
+    private formatBoundaries;
+}
+//# sourceMappingURL=ListCompactionBoundariesTool.d.ts.map

package/dist/implementations/historical/ListCompactionBoundariesTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListCompactionBoundariesTool.d.ts","sourceRoot":"","sources":["../../../src/implementations/historical/ListCompactionBoundariesTool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAMjE;;GAEG;AACH,MAAM,WAAW,kCAAkC;IACjD,4CAA4C;IAC5C,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,qBAAa,oCAAqC,SAAQ,QAAQ,CAChE,kCAAkC,EAClC,UAAU,CACX;IAGa,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,aAAa,CAAS;gBAEV,MAAM,EAAE,cAAc;IAuB1C,kBAAkB,CAAC,MAAM,EAAE,kCAAkC,GAAG,MAAM,GAAG,IAAI;IAU7E,cAAc,CAAC,MAAM,EAAE,kCAAkC,GAAG,MAAM;IAI5D,OAAO,CACX,MAAM,EAAE,kCAAkC,EAC1C,MAAM,EAAE,WAAW,EACnB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GACtC,OAAO,CAAC,UAAU,CAAC;IAyFtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAsDzB"}