ai-prompt-guide-mcp 1.0.0

package/dist/tools/implementations/manage-document.js

@@ -0,0 +1,180 @@
+/**
+ * Implementation for the manage_document tool
+ * Updated to use central addressing system for consistent document addressing
+ */
+import { ToolIntegration, AddressingError, DocumentNotFoundError } from '../../shared/addressing-system.js';
+/**
+ * Maximum number of operations allowed in a single batch request
+ * Prevents performance issues and potential DoS attacks
+ */
+const MAX_BATCH_SIZE = 100;
+export async function manageDocument(args, _state, manager) {
+    try {
+        // Detect if this is a batch operation (array input) or single operation
+        const isBatch = Array.isArray(args);
+        if (isBatch) {
+            // Handle batch operations
+            const operations = args;
+            // Comprehensive array validation
+            if (!Array.isArray(operations)) {
+                throw new AddressingError('Operations parameter must be an array', 'INVALID_BATCH', { receivedType: typeof operations });
+            }
+            if (operations.length === 0) {
+                throw new AddressingError('Batch operations array cannot be empty', 'EMPTY_BATCH');
+            }
+            if (operations.length > MAX_BATCH_SIZE) {
+                throw new AddressingError(`Batch size ${operations.length} exceeds maximum of ${MAX_BATCH_SIZE}`, 'BATCH_TOO_LARGE', { batchSize: operations.length, maxSize: MAX_BATCH_SIZE });
+            }
+            // Validate array contents
+            for (let i = 0; i < operations.length; i++) {
+                const op = operations[i];
+                if (op == null || typeof op !== 'object' || Array.isArray(op)) {
+                    throw new AddressingError(`Invalid operation at index ${i}: must be a non-null object`, 'INVALID_BATCH_ITEM', { index: i, value: op, type: typeof op });
+                }
+            }
+            const batchResults = [];
+            let operationsCompleted = 0;
+            // Process each operation sequentially using addressing system validation
+            for (const op of operations) {
+                try {
+                    const operation = ToolIntegration.validateStringParameter(op.operation, 'operation');
+                    const docPath = ToolIntegration.validateDocumentParameter(op.document);
+                    const result = await performDocumentOperation(manager, operation, docPath, op);
+                    batchResults.push({
+                        success: true,
+                        action: result.action,
+                        document: result.document ?? docPath
+                    });
+                    operationsCompleted++;
+                }
+                catch (opError) {
+                    const message = opError instanceof Error ? opError.message : String(opError);
+                    batchResults.push({
+                        success: false,
+                        document: op.document ?? 'unknown',
+                        error: message
+                    });
+                }
+            }
+            return {
+                batch_results: batchResults,
+                operations_completed: operationsCompleted,
+                total_operations: operations.length,
+                timestamp: new Date().toISOString()
+            };
+        }
+        else {
+            // Handle single operation
+            const singleOp = args;
+            const operation = ToolIntegration.validateStringParameter(singleOp.operation, 'operation');
+            const docPath = ToolIntegration.validateDocumentParameter(singleOp.document);
+            const result = await performDocumentOperation(manager, operation, docPath, singleOp);
+            return {
+                ...result,
+                timestamp: new Date().toISOString()
+            };
+        }
+    }
+    catch (error) {
+        // Handle addressing errors appropriately - re-throw to maintain error structure
+        if (error instanceof AddressingError) {
+            throw error;
+        }
+        // Handle other errors - wrap in AddressingError for proper MCP handling
+        const message = error instanceof Error ? error.message : String(error);
+        throw new AddressingError(`Failed to manage document: ${message}`, 'DOCUMENT_MANAGE_ERROR', { args, originalError: message });
+    }
+}
+/**
+ * Perform a single document management operation
+ */
+async function performDocumentOperation(manager, operation, docPath, options) {
+    // Use addressing system for validation and parsing
+    const { addresses } = ToolIntegration.validateAndParse({
+        document: docPath
+    });
+    // Check if document exists using validated addresses
+    const document = await manager.getDocument(addresses.document.path);
+    if (document == null) {
+        throw new DocumentNotFoundError(addresses.document.path);
+    }
+    // Helper function to create document info object using addressing system
+    const createDocumentInfo = (docAddress, doc) => {
+        const currentDoc = doc ?? document;
+        return ToolIntegration.formatDocumentInfo(docAddress, {
+            title: currentDoc?.metadata.title ?? 'Untitled'
+        });
+    };
+    // Validate operation using standardized utilities
+    const validatedOperation = ToolIntegration.validateOperation(operation, ['archive', 'delete', 'rename'], 'manage-document');
+    switch (validatedOperation) {
+        case 'archive': {
+            // Archive document (move to archive folder with audit trail) using validated addresses
+            const archiveResult = await manager.archiveDocument(addresses.document.path);
+            // Use the actual paths returned by archiveDocument (handles duplicates correctly)
+            const auditPath = `${archiveResult.archivePath}.audit`;
+            return {
+                action: 'archived',
+                document: addresses.document.path,
+                from: archiveResult.originalPath,
+                to: archiveResult.archivePath,
+                audit_file: auditPath,
+                document_info: createDocumentInfo(addresses.document)
+            };
+        }
+        case 'delete': {
+            // Permanent deletion
+            // Use the file system directly for permanent deletion with validated addresses
+            const { promises: fs } = await import('node:fs');
+            const { loadConfig } = await import('../../config.js');
+            const path = await import('node:path');
+            const config = loadConfig();
+            const deleteAbsolutePath = path.join(config.docsBasePath, addresses.document.path);
+            await fs.unlink(deleteAbsolutePath);
+            return {
+                action: 'deleted',
+                document: addresses.document.path,
+                document_info: createDocumentInfo(addresses.document)
+            };
+        }
+        case 'rename': {
+            // Rename document title
+            const newTitle = ToolIntegration.validateStringParameter(options.new_title, 'new_title');
+            // Get current title
+            const oldTitle = document.headings.find(h => h.depth === 1)?.title ?? 'Untitled';
+            // Update the document title (first heading) using validated addresses
+            const { renameHeading } = await import('../../sections.js');
+            const { readFileSnapshot, writeFileIfUnchanged } = await import('../../fsio.js');
+            const { loadConfig } = await import('../../config.js');
+            const path = await import('node:path');
+            const config = loadConfig();
+            const renameAbsolutePath = path.join(config.docsBasePath, addresses.document.path);
+            const snapshot = await readFileSnapshot(renameAbsolutePath);
+            // Find the first heading (title) and rename it
+            const titleHeadings = document.headings.filter(h => h.depth === 1);
+            if (titleHeadings.length > 0) {
+                const firstHeading = titleHeadings[0];
+                if (firstHeading != null) {
+                    const updatedContent = renameHeading(snapshot.content, firstHeading.slug, newTitle);
+                    await writeFileIfUnchanged(renameAbsolutePath, snapshot.mtimeMs, updatedContent);
+                }
+            }
+            // Refresh cache and get updated document info using validated addresses
+            manager.cache.invalidateDocument(addresses.document.path);
+            const updatedDocument = await manager.getDocument(addresses.document.path);
+            return {
+                action: 'renamed',
+                document: addresses.document.path,
+                old_title: oldTitle,
+                new_title: options.new_title,
+                document_info: createDocumentInfo(addresses.document, updatedDocument)
+            };
+        }
+        default:
+            throw new AddressingError(`Invalid operation: ${operation}. Must be one of: archive, delete, rename`, 'INVALID_OPERATION', {
+                document: addresses.document.path,
+                operation
+            });
+    }
+}
+//# sourceMappingURL=manage-document.js.map

package/dist/tools/implementations/manage-document.js.map

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

package/dist/tools/implementations/move-document.d.ts

@@ -0,0 +1,12 @@
+/**
+ * move_document tool implementation
+ * Relocates documents within the filesystem
+ */
+import type { SessionState } from '../../session/types.js';
+import type { DocumentManager } from '../../document-manager.js';
+/**
+ * Move a document from one location to another
+ * Creates destination directories as needed and invalidates caches
+ */
+export declare function moveDocument(args: Record<string, unknown>, _state: SessionState, manager: DocumentManager): Promise<unknown>;
+//# sourceMappingURL=move-document.d.ts.map

package/dist/tools/implementations/move-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"move-document.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/move-document.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAOjE;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,OAAO,CAAC,CA6ElB"}

package/dist/tools/implementations/move-document.js

@@ -0,0 +1,72 @@
+/**
+ * move_document tool implementation
+ * Relocates documents within the filesystem
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { ToolIntegration, AddressingError, DocumentNotFoundError, } from '../../shared/addressing-system.js';
+/**
+ * Move a document from one location to another
+ * Creates destination directories as needed and invalidates caches
+ */
+export async function moveDocument(args, _state, manager) {
+    // Variables
+    let fromPath;
+    let toPath;
+    let normalizedToPath;
+    let finalToPath;
+    try {
+        // Input validation
+        fromPath = ToolIntegration.validateStringParameter(args['from'], 'from');
+        toPath = ToolIntegration.validateStringParameter(args['to'], 'to');
+        // Parse and validate source path
+        const { addresses: fromAddresses } = ToolIntegration.validateAndParse({
+            document: fromPath,
+        });
+        // Validate source document exists
+        const sourceDoc = await manager.getDocument(fromAddresses.document.path);
+        if (sourceDoc == null) {
+            throw new DocumentNotFoundError(fromAddresses.document.path);
+        }
+        // Parse and validate destination path
+        // Normalize destination: ensure it starts with / and ends with .md
+        normalizedToPath = toPath.startsWith('/') ? toPath : `/${toPath}`;
+        finalToPath = normalizedToPath.endsWith('.md')
+            ? normalizedToPath
+            : `${normalizedToPath}.md`;
+        const { addresses: toAddresses } = ToolIntegration.validateAndParse({
+            document: finalToPath,
+        });
+        // Check if destination already exists
+        const destDoc = await manager.getDocument(toAddresses.document.path);
+        if (destDoc != null) {
+            throw new AddressingError(`Destination document already exists: ${toAddresses.document.path}`, 'DESTINATION_EXISTS', { to: toAddresses.document.path });
+        }
+        // Processing - perform the filesystem move
+        const sourceAbsPath = manager.pathResolver.resolve(fromAddresses.document.path);
+        const destAbsPath = manager.pathResolver.resolve(toAddresses.document.path);
+        // Create destination directory if needed
+        const destDir = path.dirname(destAbsPath);
+        await fs.mkdir(destDir, { recursive: true });
+        // Move the file
+        await fs.rename(sourceAbsPath, destAbsPath);
+        // Invalidate caches for both old and new paths
+        manager.cache.invalidateDocument(fromAddresses.document.path);
+        manager.cache.invalidateDocument(toAddresses.document.path);
+        // Output construction
+        return {
+            success: true,
+            moved_to: toAddresses.document.path,
+        };
+    }
+    catch (error) {
+        if (error instanceof AddressingError) {
+            throw error;
+        }
+        if (error instanceof DocumentNotFoundError) {
+            throw error;
+        }
+        throw new AddressingError(`Failed to move document: ${error instanceof Error ? error.message : String(error)}`, 'MOVE_DOCUMENT_FAILED', { from: args['from'], to: args['to'] });
+    }
+}
+//# sourceMappingURL=move-document.js.map

package/dist/tools/implementations/move-document.js.map

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

package/dist/tools/implementations/move.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Move tool implementation
+ *
+ * Moves sections or tasks between documents or within the same document.
+ * Data-safe approach: Creates in new location BEFORE deleting from old location.
+ */
+import type { SessionState } from '../../session/types.js';
+import type { DocumentManager } from '../../document-manager.js';
+/**
+ * Move a section or task to a new location
+ *
+ * Implementation follows data-safe pattern:
+ * 1. Validate all inputs (source, destination, reference)
+ * 2. Read source content and title
+ * 3. Create in new location FIRST
+ * 4. Delete from old location ONLY after successful creation
+ *
+ * @param args - Tool arguments with from, to, reference, position
+ * @param _state - Session state (unused)
+ * @param manager - Document manager instance
+ * @returns Move result with source and destination info
+ */
+export declare function move(args: Record<string, unknown>, _state: SessionState, manager: DocumentManager): Promise<unknown>;
+//# sourceMappingURL=move.d.ts.map

package/dist/tools/implementations/move.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"move.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/move.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAWjE;;;;;;;;;;;;;GAaG;AACH,wBAAsB,IAAI,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,OAAO,CAAC,CAkOlB"}

package/dist/tools/implementations/move.js

@@ -0,0 +1,167 @@
+/**
+ * Move tool implementation
+ *
+ * Moves sections or tasks between documents or within the same document.
+ * Data-safe approach: Creates in new location BEFORE deleting from old location.
+ */
+import { performSectionEdit } from '../../shared/utilities.js';
+import { ToolIntegration, AddressingError, DocumentNotFoundError, SectionNotFoundError, } from '../../shared/addressing-system.js';
+import { isValidMovePosition } from '../schemas/move-schemas.js';
+import { titleToSlug } from '../../slug.js';
+/**
+ * Move a section or task to a new location
+ *
+ * Implementation follows data-safe pattern:
+ * 1. Validate all inputs (source, destination, reference)
+ * 2. Read source content and title
+ * 3. Create in new location FIRST
+ * 4. Delete from old location ONLY after successful creation
+ *
+ * @param args - Tool arguments with from, to, reference, position
+ * @param _state - Session state (unused)
+ * @param manager - Document manager instance
+ * @returns Move result with source and destination info
+ */
+export async function move(args, _state, manager) {
+    // Input validation and normalization
+    const fromPath = ToolIntegration.validateStringParameter(args['from'], 'from');
+    const toPath = ToolIntegration.validateStringParameter(args['to'], 'to');
+    const reference = ToolIntegration.validateStringParameter(args['reference'], 'reference');
+    const positionRaw = ToolIntegration.validateStringParameter(args['position'], 'position');
+    // Validate position enum
+    if (!isValidMovePosition(positionRaw)) {
+        throw new AddressingError(`Invalid position: ${positionRaw}. Must be one of: before, after, child`, 'INVALID_POSITION', { position: positionRaw });
+    }
+    const position = positionRaw;
+    // Parse source path - must include section slug
+    if (!fromPath.includes('#')) {
+        throw new AddressingError('Source path must include section slug (e.g., "/docs/api/auth.md#section")', 'INVALID_SOURCE_PATH', { from: fromPath });
+    }
+    const [sourceDocPath, sourceSection] = fromPath.split('#');
+    if (sourceDocPath == null || sourceSection == null || sourceSection === '') {
+        throw new AddressingError('Invalid source path format. Expected: "/document.md#section"', 'INVALID_SOURCE_FORMAT', { from: fromPath });
+    }
+    // Parse and validate source addresses
+    const { addresses: sourceAddresses } = ToolIntegration.validateAndParse({
+        document: sourceDocPath,
+        section: sourceSection,
+    });
+    if (sourceAddresses.section == null) {
+        throw new AddressingError('Failed to parse source section', 'SOURCE_PARSE_ERROR');
+    }
+    const sourceSectionAddress = sourceAddresses.section;
+    // Get source document
+    const sourceDoc = await manager.getDocument(sourceAddresses.document.path);
+    if (sourceDoc == null) {
+        throw new DocumentNotFoundError(sourceAddresses.document.path);
+    }
+    // Find source heading and validate existence
+    const sourceHeading = sourceDoc.headings.find((h) => h.slug === sourceSectionAddress.slug);
+    if (sourceHeading == null) {
+        throw new SectionNotFoundError(sourceSectionAddress.slug, sourceAddresses.document.path);
+    }
+    // Get source content (what we'll move)
+    const sourceContent = await manager.getSectionContent(sourceAddresses.document.path, sourceSectionAddress.slug);
+    if (sourceContent == null) {
+        throw new AddressingError('Failed to read source section content', 'SOURCE_CONTENT_ERROR', {
+            document: sourceAddresses.document.path,
+            section: sourceSectionAddress.slug,
+        });
+    }
+    const sourceTitle = sourceHeading.title;
+    // Parse and validate destination document
+    const { addresses: destAddresses } = ToolIntegration.validateAndParse({
+        document: toPath,
+    });
+    // Get destination document
+    const destDoc = await manager.getDocument(destAddresses.document.path);
+    if (destDoc == null) {
+        throw new DocumentNotFoundError(destAddresses.document.path);
+    }
+    // Normalize reference section slug
+    const normalizedReference = reference.startsWith('#') ? reference.slice(1) : reference;
+    // Validate reference section exists in destination
+    const refHeading = destDoc.headings.find((h) => h.slug === normalizedReference);
+    if (refHeading == null) {
+        throw new SectionNotFoundError(normalizedReference, destAddresses.document.path);
+    }
+    // Map position to InsertMode for performSectionEdit
+    const insertMode = position === 'before'
+        ? 'insert_before'
+        : position === 'after'
+            ? 'insert_after'
+            : 'append_child';
+    // Detect same-document move
+    const isSameDocument = sourceAddresses.document.path === destAddresses.document.path;
+    try {
+        if (isSameDocument) {
+            // SAME-DOCUMENT MOVE: Remove first to avoid duplicate heading error
+            // Store content for rollback in case create fails
+            const contentBackup = sourceContent;
+            const titleBackup = sourceTitle;
+            // STEP 1: Delete from old location
+            await performSectionEdit(manager, sourceAddresses.document.path, sourceSectionAddress.slug, '', // Content doesn't matter for remove operation
+            'remove');
+            try {
+                // STEP 2: Create in new location
+                await performSectionEdit(manager, destAddresses.document.path, normalizedReference, contentBackup, insertMode, titleBackup);
+            }
+            catch (createError) {
+                // Rollback: Restore section at original location
+                // This is best-effort - if restore fails, content may be lost
+                try {
+                    await performSectionEdit(manager, sourceAddresses.document.path, normalizedReference, // Use reference as anchor for restoration
+                    contentBackup, 'insert_before', // Use insert_before as safe default
+                    titleBackup);
+                }
+                catch (rollbackError) {
+                    // Rollback failed - content is lost
+                    const errorMsg = rollbackError instanceof Error ? rollbackError.message : String(rollbackError);
+                    throw new AddressingError(`Same-document move failed and rollback failed. Content may be lost. Original error: ${createError instanceof Error ? createError.message : String(createError)}. Rollback error: ${errorMsg}`, 'MOVE_ROLLBACK_FAILED', {
+                        from: fromPath,
+                        to: toPath,
+                        reference: normalizedReference,
+                        position,
+                        originalError: createError instanceof Error ? createError.message : String(createError),
+                        rollbackError: errorMsg,
+                    });
+                }
+                // Rollback succeeded - re-throw original error
+                throw createError;
+            }
+        }
+        else {
+            // CROSS-DOCUMENT MOVE: Create first for data safety
+            // STEP 1: Create section/task in new location FIRST (data safety)
+            await performSectionEdit(manager, destAddresses.document.path, normalizedReference, sourceContent, insertMode, sourceTitle);
+            // STEP 2: Delete from old location ONLY after successful creation
+            await performSectionEdit(manager, sourceAddresses.document.path, sourceSectionAddress.slug, '', // Content doesn't matter for remove operation
+            'remove');
+        }
+        // Determine the position description based on the operation
+        const positionDescription = position === 'before' ? `before ${normalizedReference}` :
+            position === 'after' ? `after ${normalizedReference}` :
+                `child of ${normalizedReference}`;
+        // Format minimal response
+        return {
+            success: true,
+            moved_to: `${destAddresses.document.path}#${titleToSlug(sourceTitle)}`,
+            position: positionDescription,
+        };
+    }
+    catch (error) {
+        // If creation succeeded but deletion failed, we have duplicate content
+        // This is safer than losing data
+        if (error instanceof Error) {
+            throw new AddressingError(`Move operation failed: ${error.message}. Note: If creation succeeded but deletion failed, content may be duplicated.`, 'MOVE_OPERATION_FAILED', {
+                from: fromPath,
+                to: toPath,
+                reference: normalizedReference,
+                position,
+                originalError: error.message,
+            });
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=move.js.map

package/dist/tools/implementations/move.js.map

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

package/dist/tools/implementations/search-documents.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Implementation for the search_documents tool
+ * Full-text and regex search across all documents with structured results
+ */
+import type { SessionState } from '../../session/types.js';
+import type { DocumentManager } from '../../document-manager.js';
+interface SearchMatch {
+    section: string;
+    line_number: number;
+    match_text: string;
+    context_before?: string;
+    context_after?: string;
+    type: 'task' | 'section';
+}
+interface DocumentResult {
+    document: {
+        path: string;
+        title: string;
+        namespace: string;
+        slug: string;
+    };
+    matches: SearchMatch[];
+    match_count: number;
+}
+interface SearchResponse {
+    query: string;
+    search_type: 'fulltext' | 'regex';
+    scope: string | null;
+    results: DocumentResult[];
+    total_matches: number;
+    total_documents: number;
+    truncated: boolean;
+}
+/**
+ * Search documents implementation
+ */
+export declare function searchDocuments(args: Record<string, unknown>, _state: SessionState, manager: DocumentManager): Promise<SearchResponse>;
+export {};
+//# sourceMappingURL=search-documents.d.ts.map

package/dist/tools/implementations/search-documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-documents.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/search-documents.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAKjE,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,UAAU,cAAc;IACtB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,UAAU,GAAG,OAAO,CAAC;IAClC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;CACpB;AA0GD;;GAEG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAsNzB"}