mcp-code-context 3.5.3 → 3.6.0

package/dist/src/utils/diff.js

@@ -1,18 +1,92 @@
 /**
- * Diff Engine - v3.5.3
- * LCS-based unified diff with memory safety cap
+ * Diff Utilities - v3.6.0
+ * Uses diff-match-patch for efficient diffing
  */
-const MAX_DIFF_LINES = 5000;
+import DiffMatchPatch from 'diff-match-patch';
+import { DIFF_MAX_FILE_LINES } from './constants.js';
+const dmp = new DiffMatchPatch();
+const COMPACT_DIFF_THRESHOLD = 2048;
 /**
- * Longest Common Subsequence algorithm
+ * Generates a unified diff using Myers algorithm.
+ * Falls back to simple diff for files exceeding line limit.
+ *
+ * @param oldText - Original file content
+ * @param newText - Modified file content
+ * @returns Unified diff in patch format
  */
-function lcs(a, b) {
-    const m = a.length;
-    const n = b.length;
-    const dp = Array(m + 1).fill(0).map(() => Array(n + 1).fill(0));
+export function generateUnifiedDiff(oldText, newText) {
+    const oldLines = oldText.split('\n');
+    const newLines = newText.split('\n');
+    if (oldLines.length > DIFF_MAX_FILE_LINES || newLines.length > DIFF_MAX_FILE_LINES) {
+        return generateSimpleDiff(oldText, newText);
+    }
+    const diffs = dmp.diff_main(oldText, newText);
+    dmp.diff_cleanupSemantic(diffs);
+    const patch = dmp.patch_make(oldText, diffs);
+    return dmp.patch_toText(patch);
+}
+/**
+ * Generates a simple diff summary for large files.
+ *
+ * @param oldText - Original file content
+ * @param newText - Modified file content
+ * @returns Simple line count summary
+ */
+export function generateSimpleDiff(oldText, newText) {
+    const oldLines = oldText.split('\n');
+    const newLines = newText.split('\n');
+    return `File too large for detailed diff.
+Old: ${oldLines.length} lines
+New: ${newLines.length} lines
+Changed: ${Math.abs(oldLines.length - newLines.length)} lines`;
+}
+/**
+ * Generates a compact diff showing only changes (no context).
+ *
+ * @param oldText - Original file content
+ * @param newText - Modified file content
+ * @returns Compact diff with + and - prefixes
+ */
+export function generateCompactDiff(oldText, newText) {
+    const diffs = dmp.diff_main(oldText, newText);
+    dmp.diff_cleanupSemantic(diffs);
+    const compactLines = [];
+    for (const [op, text] of diffs) {
+        if (op === 0)
+            continue;
+        const prefix = op === 1 ? '+ ' : '- ';
+        const lines = text.split('\n').filter(line => line.trim().length > 0);
+        for (const line of lines) {
+            compactLines.push(prefix + line);
+        }
+    }
+    return compactLines.join('\n');
+}
+/**
+ * Automatically selects compact or full diff based on size.
+ *
+ * @param oldText - Original file content
+ * @param newText - Modified file content
+ * @returns Compact diff if full diff exceeds threshold, otherwise full diff
+ */
+export function generateSmartDiff(oldText, newText) {
+    const fullDiff = generateUnifiedDiff(oldText, newText);
+    if (fullDiff.length > COMPACT_DIFF_THRESHOLD) {
+        return generateCompactDiff(oldText, newText);
+    }
+    return fullDiff;
+}
+export function lcs(lines1, lines2) {
+    const m = lines1.length;
+    const n = lines2.length;
+    if (m === 0 || n === 0)
+        return [];
+    if (m > DIFF_MAX_FILE_LINES || n > DIFF_MAX_FILE_LINES)
+        return [];
+    const dp = Array(m + 1).fill(null).map(() => Array(n + 1).fill(0));
     for (let i = 1; i <= m; i++) {
         for (let j = 1; j <= n; j++) {
-            if (a[i - 1] === b[j - 1]) {
+            if (lines1[i - 1] === lines2[j - 1]) {
                 dp[i][j] = dp[i - 1][j - 1] + 1;
             }
             else {
@@ -20,105 +94,21 @@ function lcs(a, b) {
             }
         }
     }
-    return dp;
-}
-/**
- * Generate unified diff using LCS algorithm
- * Falls back to simple diff for large files to prevent OOM
- */
-export function generateUnifiedDiff(oldContent, newContent, contextLines = 3) {
-    const oldLines = oldContent.split('\n');
-    const newLines = newContent.split('\n');
-    // SAFETY: Fall back to simple diff for large files (LCS is O(n*m) memory)
-    if (oldLines.length > MAX_DIFF_LINES || newLines.length > MAX_DIFF_LINES) {
-        return generateSimpleDiff(oldContent, newContent);
-    }
-    const dp = lcs(oldLines, newLines);
-    const diff = [];
-    // Backtrack to find differences
-    let i = oldLines.length;
-    let j = newLines.length;
-    while (i > 0 || j > 0) {
-        if (i > 0 && j > 0 && oldLines[i - 1] === newLines[j - 1]) {
-            diff.unshift({ type: 'context', content: oldLines[i - 1], lineNumber: i });
+    const result = [];
+    let i = m, j = n;
+    while (i > 0 && j > 0) {
+        if (lines1[i - 1] === lines2[j - 1]) {
+            result.unshift(lines1[i - 1]);
             i--;
             j--;
         }
-        else if (j > 0 && (i === 0 || dp[i][j - 1] >= dp[i - 1][j])) {
-            diff.unshift({ type: 'add', content: newLines[j - 1], lineNumber: j });
-            j--;
-        }
-        else if (i > 0 && (j === 0 || dp[i][j - 1] < dp[i - 1][j])) {
-            diff.unshift({ type: 'remove', content: oldLines[i - 1], lineNumber: i });
+        else if (dp[i - 1][j] > dp[i][j - 1]) {
             i--;
         }
-    }
-    // Format output with context
-    const output = [];
-    let inHunk = false;
-    let contextCount = 0;
-    for (let idx = 0; idx < diff.length; idx++) {
-        const line = diff[idx];
-        if (line.type === 'context') {
-            if (inHunk) {
-                contextCount++;
-                if (contextCount <= contextLines) {
-                    output.push(`  ${line.content}`);
-                }
-                else {
-                    inHunk = false;
-                    contextCount = 0;
-                }
-            }
-            else {
-                // Check if change is coming
-                const hasChangeAhead = diff.slice(idx, idx + contextLines + 1)
-                    .some(l => l.type !== 'context');
-                if (hasChangeAhead) {
-                    output.push(`  ${line.content}`);
-                }
-            }
-        }
-        else {
-            if (!inHunk) {
-                // Add context before change
-                const contextBefore = diff.slice(Math.max(0, idx - contextLines), idx)
-                    .filter(l => l.type === 'context');
-                contextBefore.forEach(l => output.push(`  ${l.content}`));
-            }
-            inHunk = true;
-            contextCount = 0;
-            if (line.type === 'add') {
-                output.push(`+ ${line.content}`);
-            }
-            else {
-                output.push(`- ${line.content}`);
-            }
-        }
-    }
-    return output.join('\n');
-}
-/**
- * Simple line-by-line diff (O(n) memory fallback for large files)
- */
-export function generateSimpleDiff(oldContent, newContent) {
-    const oldLines = oldContent.split('\n');
-    const newLines = newContent.split('\n');
-    const diff = [];
-    const maxLen = Math.max(oldLines.length, newLines.length);
-    for (let i = 0; i < maxLen; i++) {
-        const oldLine = oldLines[i];
-        const newLine = newLines[i];
-        if (oldLine === newLine) {
-            diff.push(`  ${oldLine || ''}`);
-        }
         else {
-            if (oldLine !== undefined)
-                diff.push(`- ${oldLine}`);
-            if (newLine !== undefined)
-                diff.push(`+ ${newLine}`);
+            j--;
         }
     }
-    return diff.join('\n');
+    return result;
 }
 //# sourceMappingURL=diff.js.map

package/dist/src/utils/diff.js.map

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

package/dist/src/utils/fileLock.d.ts

@@ -1,63 +1,38 @@
 /**
- * File Lock Manager - v3.5.3
- * Prevents concurrent writes to same file
+ * File Lock Manager - v3.6.0
+ * Filesystem-based locks for multi-process safety
+ */
+/**
+ * Manages filesystem-based locks for multi-process safety.
+ * Locks are stored in OS temp directory to prevent conflicts.
  */
-interface LockInfo {
-    clientId: string;
-    operation: string;
-    timestamp: number;
-    timeout: NodeJS.Timeout;
-}
 export declare class FileLockManager {
-    private locks;
-    private readonly lockTimeout;
-    constructor(lockTimeoutMs?: number);
-    /**
-     * Acquire lock on file
-     */
-    acquireLock(filePath: string, clientId: string, operation: string): Promise<{
-        acquired: boolean;
-        error?: string;
-        lockedBy?: string;
-    }>;
-    /**
-     * Release lock on file
-     */
-    releaseLock(filePath: string, clientId: string): boolean;
+    private lockDir;
+    private activeLocks;
     /**
-     * Check if file is locked
+     * Creates a new FileLockManager instance.
+     * Initializes lock directory in OS temp with project-specific hash.
      */
-    isLocked(filePath: string): boolean;
+    constructor();
     /**
-     * Get lock info
+     * Acquires an exclusive lock on a file.
+     *
+     * @param filePath - Absolute path to file to lock
+     * @param timeoutMs - Stale lock timeout in milliseconds (default: 30000)
+     * @returns Release function to unlock the file
+     * @throws Error if lock cannot be acquired after retries
      */
-    getLockInfo(filePath: string): LockInfo | null;
+    acquireLock(filePath: string, timeoutMs?: number): Promise<() => Promise<void>>;
     /**
-     * Force release lock (admin only)
+     * Checks if a file is currently locked.
+     *
+     * @param filePath - Absolute path to file
+     * @returns True if file is locked, false otherwise
      */
-    forceRelease(filePath: string): boolean;
+    isLocked(filePath: string): Promise<boolean>;
     /**
-     * Release all locks for client
+     * Releases all active locks managed by this instance.
      */
-    releaseAllForClient(clientId: string): number;
-    /**
-     * Get all active locks
-     */
-    getActiveLocks(): Array<{
-        path: string;
-        info: LockInfo;
-    }>;
-    /**
-     * Clear all locks
-     */
-    clearAll(): void;
-    /**
-     * Normalize path for consistent comparison
-     */
-    private normalizePath;
+    releaseAll(): Promise<void>;
 }
-/**
- * Global lock manager instance
- */
 export declare const globalLockManager: FileLockManager;
-export {};

package/dist/src/utils/fileLock.js

@@ -1,123 +1,89 @@
 /**
- * File Lock Manager - v3.5.3
- * Prevents concurrent writes to same file
+ * File Lock Manager - v3.6.0
+ * Filesystem-based locks for multi-process safety
+ */
+import lockfile from 'proper-lockfile';
+import { tmpdir } from 'os';
+import { mkdirSync, existsSync } from 'fs';
+import path from 'path';
+import crypto from 'crypto';
+import { LOCK_TIMEOUT_MS, LOCK_RETRY_COUNT, LOCK_RETRY_MIN_MS, LOCK_RETRY_MAX_MS, LOCK_RETRY_FACTOR, HASH_LENGTH } from './constants.js';
+/**
+ * Manages filesystem-based locks for multi-process safety.
+ * Locks are stored in OS temp directory to prevent conflicts.
  */
 export class FileLockManager {
-    locks = new Map();
-    lockTimeout;
-    constructor(lockTimeoutMs = 30000) {
-        this.lockTimeout = lockTimeoutMs;
-    }
+    lockDir;
+    activeLocks = new Map();
     /**
-     * Acquire lock on file
+     * Creates a new FileLockManager instance.
+     * Initializes lock directory in OS temp with project-specific hash.
      */
-    async acquireLock(filePath, clientId, operation) {
-        const normalizedPath = this.normalizePath(filePath);
-        const existingLock = this.locks.get(normalizedPath);
-        if (existingLock) {
-            return {
-                acquired: false,
-                error: `File locked by ${existingLock.operation} (client: ${existingLock.clientId})`,
-                lockedBy: existingLock.clientId,
-            };
+    constructor() {
+        const projectHash = crypto.createHash('md5')
+            .update(process.cwd())
+            .digest('hex')
+            .substring(0, HASH_LENGTH);
+        this.lockDir = path.join(tmpdir(), `mcp-locks-${projectHash}`);
+        if (!existsSync(this.lockDir)) {
+            mkdirSync(this.lockDir, { recursive: true });
         }
-        // Create lock with auto-release timeout
-        const timeout = setTimeout(() => {
-            this.releaseLock(filePath, clientId);
-            console.warn(`⚠️  Lock auto-released for ${normalizedPath} (timeout)`);
-        }, this.lockTimeout);
-        this.locks.set(normalizedPath, {
-            clientId,
-            operation,
-            timestamp: Date.now(),
-            timeout,
-        });
-        return { acquired: true };
     }
     /**
-     * Release lock on file
+     * Acquires an exclusive lock on a file.
+     *
+     * @param filePath - Absolute path to file to lock
+     * @param timeoutMs - Stale lock timeout in milliseconds (default: 30000)
+     * @returns Release function to unlock the file
+     * @throws Error if lock cannot be acquired after retries
      */
-    releaseLock(filePath, clientId) {
-        const normalizedPath = this.normalizePath(filePath);
-        const lock = this.locks.get(normalizedPath);
-        if (!lock) {
-            return false; // No lock exists
+    async acquireLock(filePath, timeoutMs = LOCK_TIMEOUT_MS) {
+        const normalizedPath = path.resolve(filePath);
+        try {
+            const release = await lockfile.lock(normalizedPath, {
+                stale: timeoutMs,
+                retries: {
+                    retries: LOCK_RETRY_COUNT,
+                    minTimeout: LOCK_RETRY_MIN_MS,
+                    maxTimeout: LOCK_RETRY_MAX_MS,
+                    factor: LOCK_RETRY_FACTOR
+                },
+                lockfilePath: path.join(this.lockDir, `${crypto.createHash('md5').update(normalizedPath).digest('hex')}.lock`)
+            });
+            this.activeLocks.set(normalizedPath, release);
+            return async () => {
+                await release();
+                this.activeLocks.delete(normalizedPath);
+            };
         }
-        if (lock.clientId !== clientId) {
-            return false; // Lock owned by different client
+        catch (error) {
+            throw new Error(`Failed to acquire lock for "${filePath}": ${error.message || String(error)}`);
         }
-        clearTimeout(lock.timeout);
-        this.locks.delete(normalizedPath);
-        return true;
-    }
-    /**
-     * Check if file is locked
-     */
-    isLocked(filePath) {
-        const normalizedPath = this.normalizePath(filePath);
-        return this.locks.has(normalizedPath);
-    }
-    /**
-     * Get lock info
-     */
-    getLockInfo(filePath) {
-        const normalizedPath = this.normalizePath(filePath);
-        return this.locks.get(normalizedPath) || null;
     }
     /**
-     * Force release lock (admin only)
+     * Checks if a file is currently locked.
+     *
+     * @param filePath - Absolute path to file
+     * @returns True if file is locked, false otherwise
      */
-    forceRelease(filePath) {
-        const normalizedPath = this.normalizePath(filePath);
-        const lock = this.locks.get(normalizedPath);
-        if (lock) {
-            clearTimeout(lock.timeout);
-            this.locks.delete(normalizedPath);
-            return true;
+    async isLocked(filePath) {
+        const normalizedPath = path.resolve(filePath);
+        try {
+            const lockfilePath = path.join(this.lockDir, `${crypto.createHash('md5').update(normalizedPath).digest('hex')}.lock`);
+            return await lockfile.check(normalizedPath, { lockfilePath });
         }
-        return false;
-    }
-    /**
-     * Release all locks for client
-     */
-    releaseAllForClient(clientId) {
-        let count = 0;
-        for (const [path, lock] of this.locks.entries()) {
-            if (lock.clientId === clientId) {
-                clearTimeout(lock.timeout);
-                this.locks.delete(path);
-                count++;
-            }
+        catch {
+            return false;
         }
-        return count;
-    }
-    /**
-     * Get all active locks
-     */
-    getActiveLocks() {
-        return Array.from(this.locks.entries()).map(([path, info]) => ({
-            path,
-            info,
-        }));
     }
     /**
-     * Clear all locks
+     * Releases all active locks managed by this instance.
      */
-    clearAll() {
-        for (const lock of this.locks.values()) {
-            clearTimeout(lock.timeout);
-        }
-        this.locks.clear();
-    }
-    /**
-     * Normalize path for consistent comparison
-     */
-    normalizePath(filePath) {
-        return filePath.replace(/\\/g, '/').toLowerCase();
+    async releaseAll() {
+        const releases = Array.from(this.activeLocks.values());
+        await Promise.all(releases.map(release => release()));
+        this.activeLocks.clear();
     }
 }
-/**
- * Global lock manager instance
- */
 export const globalLockManager = new FileLockManager();
 //# sourceMappingURL=fileLock.js.map

package/dist/src/utils/fileLock.js.map

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

package/dist/src/utils/fileWalker.d.ts

@@ -0,0 +1,28 @@
+/**
+ * File Walker Utility - v3.6.0
+ * Centralized directory traversal with filtering
+ */
+export interface WalkOptions {
+    /** Extensions to include (e.g., [".ts", ".js"]) */
+    extensions?: readonly string[];
+    /** Directories to exclude (e.g., ["node_modules", ".git"]) */
+    excludeDirs?: readonly string[];
+    /** Maximum files to collect (prevents OOM) */
+    maxFiles?: number;
+    /** Maximum total size in bytes (prevents OOM) */
+    maxSize?: number;
+    /** Callback for each file found */
+    onFile?: (filePath: string) => Promise<void> | void;
+}
+/**
+ * Recursively walks a directory tree with filtering options.
+ * Supports extension filtering, directory exclusion, and size/count limits.
+ *
+ * @param dir - Root directory to walk
+ * @param options - Filtering and callback options
+ * @param state - Internal state for tracking counts (do not pass manually)
+ */
+export declare function walkDir(dir: string, options?: WalkOptions, state?: {
+    fileCount: number;
+    totalSize: number;
+}): Promise<void>;

package/dist/src/utils/fileWalker.js

@@ -0,0 +1,57 @@
+/**
+ * File Walker Utility - v3.6.0
+ * Centralized directory traversal with filtering
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+/**
+ * Recursively walks a directory tree with filtering options.
+ * Supports extension filtering, directory exclusion, and size/count limits.
+ *
+ * @param dir - Root directory to walk
+ * @param options - Filtering and callback options
+ * @param state - Internal state for tracking counts (do not pass manually)
+ */
+export async function walkDir(dir, options = {}, state = { fileCount: 0, totalSize: 0 }) {
+    // Check limits
+    if (options.maxFiles && state.fileCount >= options.maxFiles)
+        return;
+    if (options.maxSize && state.totalSize >= options.maxSize)
+        return;
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        // Check limits again in loop
+        if (options.maxFiles && state.fileCount >= options.maxFiles)
+            break;
+        if (options.maxSize && state.totalSize >= options.maxSize)
+            break;
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            // Recurse if not excluded
+            if (!options.excludeDirs || !options.excludeDirs.includes(entry.name)) {
+                await walkDir(fullPath, options, state);
+            }
+        }
+        else if (entry.isFile()) {
+            // Check extension filter
+            if (options.extensions) {
+                const ext = path.extname(entry.name);
+                if (!options.extensions.includes(ext))
+                    continue;
+            }
+            // Update size tracking
+            if (options.maxSize) {
+                const stat = await fs.stat(fullPath);
+                if (state.totalSize + stat.size > options.maxSize)
+                    break;
+                state.totalSize += stat.size;
+            }
+            // Increment count and invoke callback
+            state.fileCount++;
+            if (options.onFile) {
+                await options.onFile(fullPath);
+            }
+        }
+    }
+}
+//# sourceMappingURL=fileWalker.js.map

package/dist/src/utils/fileWalker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileWalker.js","sourceRoot":"","sources":["../../../src/utils/fileWalker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAelC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAW,EACX,UAAuB,EAAE,EACzB,QAAkD,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;IAEhF,eAAe;IACf,IAAI,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC,SAAS,IAAI,OAAO,CAAC,QAAQ;QAAE,OAAO;IACpE,IAAI,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC,SAAS,IAAI,OAAO,CAAC,OAAO;QAAE,OAAO;IAElE,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,6BAA6B;QAC7B,IAAI,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC,SAAS,IAAI,OAAO,CAAC,QAAQ;YAAE,MAAM;QACnE,IAAI,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC,SAAS,IAAI,OAAO,CAAC,OAAO;YAAE,MAAM;QAEjE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAE5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,0BAA0B;YAC1B,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtE,MAAM,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1B,yBAAyB;YACzB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACvB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACrC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC;oBAAE,SAAS;YAClD,CAAC;YAED,uBAAuB;YACvB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACrC,IAAI,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,OAAO;oBAAE,MAAM;gBACzD,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC;YAC/B,CAAC;YAED,sCAAsC;YACtC,KAAK,CAAC,SAAS,EAAE,CAAC;YAClB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnB,MAAM,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}