claude-ide-bridge 1.1.0

package/dist/tools/getDiagnostics.js

@@ -0,0 +1,204 @@
+import { ExtensionTimeoutError, } from "../extensionClient.js";
+import { biomeLinter } from "./linters/biome.js";
+import { cargoLinter } from "./linters/cargo.js";
+import { eslintLinter } from "./linters/eslint.js";
+import { govetLinter } from "./linters/govet.js";
+import { pyrightLinter } from "./linters/pyright.js";
+import { ruffLinter } from "./linters/ruff.js";
+import { typescriptLinter } from "./linters/typescript.js";
+import { optionalString, success, toFileUri } from "./utils.js";
+const ALL_LINTERS = [
+    typescriptLinter,
+    eslintLinter,
+    pyrightLinter,
+    ruffLinter,
+    cargoLinter,
+    govetLinter,
+    biomeLinter,
+];
+export function createGetDiagnosticsTool(workspace, probes, extensionClient, linterFilter) {
+    // Per-linter independent caches
+    const caches = new Map();
+    const runningPromises = new Map();
+    // Detect available linters at registration time
+    const availableLinters = probes
+        ? ALL_LINTERS.filter((l) => {
+            if (linterFilter && linterFilter.length > 0) {
+                return linterFilter.includes(l.name) && l.detect(workspace, probes);
+            }
+            return l.detect(workspace, probes);
+        })
+        : [];
+    async function runLinter(linter, signal) {
+        const now = Date.now();
+        const cached = caches.get(linter.name);
+        if (cached && now - cached.timestamp < linter.cacheTtl) {
+            return cached.data;
+        }
+        // Dedup concurrent runs — but don't serve a dedup'd result if our signal is fine
+        // and the existing promise was from an aborted request
+        let running = runningPromises.get(linter.name);
+        if (running && signal?.aborted) {
+            return running; // We're aborted anyway, dedup is fine
+        }
+        if (!running) {
+            running = linter
+                .run(workspace, signal)
+                .then((data) => {
+                caches.set(linter.name, { data, timestamp: Date.now() });
+                return data;
+            })
+                .catch((err) => {
+                // Don't cache aborted results — they're incomplete
+                if (!(err instanceof Error) || err.name !== "AbortError") {
+                    caches.set(linter.name, { data: [], timestamp: Date.now() });
+                }
+                return [];
+            })
+                .finally(() => {
+                runningPromises.delete(linter.name);
+            });
+            runningPromises.set(linter.name, running);
+        }
+        return running;
+    }
+    return {
+        schema: {
+            name: "getDiagnostics",
+            description: "Get diagnostics (errors, warnings) from available linters. Supports TypeScript, ESLint, Pyright, Ruff, Cargo, Go vet, and Biome. When the VS Code extension is connected, returns real-time LSP diagnostics instead.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    uri: {
+                        type: "string",
+                        description: "Optional file filter — accepts an absolute path, workspace-relative path, or file:// URI. When provided, returns diagnostics for that file only.",
+                    },
+                    severity: {
+                        type: "string",
+                        enum: ["error", "warning", "information", "hint"],
+                        description: "Only return diagnostics at or above this severity level. Ordered from highest to lowest: 'error', 'warning', 'information', 'hint'. Use 'error' to focus on build-breaking issues only.",
+                    },
+                    maxResults: {
+                        type: "number",
+                        description: "Limit the number of diagnostics returned. Default: 500. Use a lower value for large projects.",
+                    },
+                },
+            },
+        },
+        timeoutMs: 5_000,
+        async handler(args, signal) {
+            const uri = optionalString(args, "uri");
+            const severityFilter = optionalString(args, "severity");
+            const maxResults = typeof args.maxResults === "number"
+                ? Math.min(Math.max(1, Math.floor(args.maxResults)), 2000)
+                : 500;
+            const SEVERITY_RANK = {
+                error: 3,
+                warning: 2,
+                information: 1,
+                hint: 0,
+            };
+            const minRank = severityFilter !== undefined
+                ? (SEVERITY_RANK[severityFilter] ?? 0)
+                : -1;
+            function applyFilters(diags) {
+                let filtered = diags;
+                if (minRank >= 0) {
+                    filtered = filtered.filter((d) => {
+                        const sev = d.severity;
+                        return (SEVERITY_RANK[sev ?? "hint"] ?? 0) >= minRank;
+                    });
+                }
+                const truncated = filtered.length > maxResults;
+                return truncated ? filtered.slice(0, maxResults) : filtered;
+            }
+            // Try extension first — real-time aggregated LSP diagnostics
+            if (extensionClient?.isConnected()) {
+                try {
+                    const extDiags = await extensionClient.getDiagnostics(uri);
+                    if (extDiags !== null) {
+                        let extDiagsArr;
+                        let extTruncated = false;
+                        const raw = extDiags;
+                        if (raw !== null &&
+                            typeof raw === "object" &&
+                            !Array.isArray(raw) &&
+                            "diagnostics" in raw) {
+                            const env = raw;
+                            extDiagsArr = env.diagnostics;
+                            extTruncated = env.truncated ?? false;
+                        }
+                        else {
+                            extDiagsArr = raw;
+                        }
+                        const filtered = applyFilters(extDiagsArr);
+                        return success({
+                            available: true,
+                            source: "extension",
+                            linters: ["vscode-lsp"],
+                            diagnostics: filtered,
+                            ...(severityFilter ? { severityFilter } : {}),
+                            ...(extTruncated || filtered.length < extDiagsArr.length
+                                ? { truncated: true, totalBeforeFilter: extDiagsArr.length }
+                                : {}),
+                            ...(extTruncated
+                                ? {
+                                    note: "Capped at 500 total diagnostics — use uri filter to get complete diagnostics for a specific file",
+                                }
+                                : {}),
+                        });
+                    }
+                }
+                catch (err) {
+                    if (!(err instanceof ExtensionTimeoutError))
+                        throw err;
+                    // Timeout — fall through to CLI linter fallback
+                }
+            }
+            // Fallback to CLI linters — run all in parallel
+            if (availableLinters.length === 0) {
+                return success({
+                    available: false,
+                    source: "cli",
+                    linters: [],
+                    diagnostics: [],
+                    error: "No linters detected in workspace",
+                });
+            }
+            const results = await Promise.all(availableLinters.map((l) => runLinter(l, signal)));
+            let diagnostics = results.flat();
+            // Filter by URI if specified
+            if (uri) {
+                const normalizedUri = uri.startsWith("file://") ? uri : toFileUri(uri);
+                diagnostics = diagnostics.filter((d) => {
+                    const diagUri = d.file.startsWith("file://")
+                        ? d.file
+                        : toFileUri(d.file);
+                    return diagUri === normalizedUri;
+                });
+            }
+            const totalBeforeFilter = diagnostics.length;
+            const filteredDiags = applyFilters(diagnostics);
+            const summary = {
+                total: filteredDiags.length,
+                errors: filteredDiags.filter((d) => d.severity === "error").length,
+                warnings: filteredDiags.filter((d) => d.severity === "warning").length,
+            };
+            return success({
+                available: true,
+                source: "cli",
+                linters: availableLinters.map((l) => l.name),
+                summary,
+                diagnostics: filteredDiags,
+                ...(severityFilter ? { severityFilter } : {}),
+                ...(filteredDiags.length < totalBeforeFilter
+                    ? { truncated: true, totalBeforeFilter }
+                    : {}),
+            });
+        },
+    };
+}
+//# sourceMappingURL=getDiagnostics.js.map

package/dist/tools/getDiagnostics.js.map

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

package/dist/tools/getDocumentSymbols.d.ts

@@ -0,0 +1,27 @@
+import type { ExtensionClient } from "../extensionClient.js";
+export declare function createGetDocumentSymbolsTool(workspace: string, extensionClient?: ExtensionClient): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                filePath: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+    };
+    handler: (args: Record<string, unknown>) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};

package/dist/tools/getDocumentSymbols.js

@@ -0,0 +1,133 @@
+import fs from "node:fs";
+import { error, execSafe, languageIdFromPath, requireString, resolveFilePath, success, } from "./utils.js";
+// Language-specific patterns to detect symbol definitions (grep fallback)
+const SYMBOL_PATTERNS = {
+    typescript: String.raw `^\s*(export\s+)?(default\s+)?(abstract\s+)?(class|interface|type|enum|function|async\s+function|const|let|var)\s+\w`,
+    typescriptreact: String.raw `^\s*(export\s+)?(default\s+)?(abstract\s+)?(class|interface|type|enum|function|async\s+function|const|let|var)\s+\w`,
+    javascript: String.raw `^\s*(export\s+)?(default\s+)?(class|function|async\s+function|const|let|var)\s+\w`,
+    javascriptreact: String.raw `^\s*(export\s+)?(default\s+)?(class|function|async\s+function|const|let|var)\s+\w`,
+    python: String.raw `^\s*(class|def|async\s+def)\s+\w`,
+    rust: String.raw `^\s*(pub\s+)?(pub\s*\(.*\)\s+)?(fn|struct|enum|trait|impl|type|mod|const|static)\s+\w`,
+    go: String.raw `^(func|type|var|const)\s+\w`,
+};
+export function createGetDocumentSymbolsTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "getDocumentSymbols",
+            description: "List all symbols (functions, classes, interfaces, types, methods, etc.) defined in a file. " +
+                "Returns a flat list with names, kinds, line numbers, and parent relationships. " +
+                "Use this to understand a file's structure before editing, or to find where a specific symbol is defined. " +
+                "When the VS Code extension is connected, uses full LSP symbol data including nested symbols. " +
+                "Without the extension, falls back to regex-based detection for common languages.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Absolute or workspace-relative path to the file",
+                    },
+                },
+                required: ["filePath"],
+                additionalProperties: false,
+            },
+        },
+        handler: async (args) => {
+            const rawPath = requireString(args, "filePath");
+            const filePath = resolveFilePath(rawPath, workspace);
+            // Extension path: full LSP document symbols
+            if (extensionClient?.isConnected()) {
+                try {
+                    const result = await extensionClient.getDocumentSymbols(filePath);
+                    if (result !== null && typeof result === "object") {
+                        const r = result;
+                        return success({ ...r, source: "lsp" });
+                    }
+                    // null means LSP not ready for this file — fall through to grep
+                }
+                catch {
+                    // fall through
+                }
+            }
+            // Grep fallback: regex-based symbol detection
+            const langId = languageIdFromPath(filePath);
+            const pattern = SYMBOL_PATTERNS[langId];
+            if (!pattern) {
+                // No pattern — just return empty with a note
+                return success({
+                    symbols: [],
+                    count: 0,
+                    source: "unavailable",
+                    note: `No symbol patterns available for language '${langId}'. Connect the VS Code extension for LSP-based symbols.`,
+                });
+            }
+            if (!fs.existsSync(filePath)) {
+                return error(`File not found: ${filePath}`);
+            }
+            const rgResult = await execSafe("rg", ["-n", "--no-heading", "-e", pattern, filePath], {
+                cwd: workspace,
+                timeout: 10_000,
+                maxBuffer: 256 * 1024,
+            });
+            if (!rgResult.stdout.trim()) {
+                return success({ symbols: [], count: 0, source: "grep-fallback" });
+            }
+            const symbols = [];
+            for (const line of rgResult.stdout.split("\n")) {
+                if (!line)
+                    continue;
+                const m = line.match(/^(\d+):(.*)$/);
+                if (!m)
+                    continue;
+                const lineNum = Number.parseInt(m[1], 10);
+                const text = m[2].trim();
+                // Extract symbol name and kind from the matched line
+                const symMatch = text.match(/(?:export\s+)?(?:default\s+)?(?:abstract\s+)?(?:pub\s+(?:\(.*?\)\s+)?)?(?:async\s+)?(class|interface|type|enum|function|const|let|var|fn|struct|trait|impl|mod|def|type)\s+(\w+)/);
+                if (!symMatch)
+                    continue;
+                const kindRaw = symMatch[1];
+                const name = symMatch[2];
+                const kind = kindToSymbolKind(kindRaw);
+                symbols.push({ name, kind, line: lineNum, parent: null });
+            }
+            return success({
+                symbols,
+                count: symbols.length,
+                source: "grep-fallback",
+            });
+        },
+    };
+}
+function kindToSymbolKind(raw) {
+    switch (raw) {
+        case "class":
+            return "Class";
+        case "interface":
+            return "Interface";
+        case "type":
+            return "TypeParameter";
+        case "enum":
+            return "Enum";
+        case "function":
+        case "fn":
+        case "def":
+            return "Function";
+        case "const":
+            return "Constant";
+        case "let":
+        case "var":
+            return "Variable";
+        case "struct":
+            return "Struct";
+        case "trait":
+            return "Interface";
+        case "impl":
+            return "Class";
+        case "mod":
+        case "module":
+            return "Module";
+        default:
+            return "Variable";
+    }
+}
+//# sourceMappingURL=getDocumentSymbols.js.map

package/dist/tools/getDocumentSymbols.js.map

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

package/dist/tools/getFileTree.d.ts

@@ -0,0 +1,36 @@
+import type { ProbeResults } from "../probe.js";
+export declare function createGetFileTreeTool(workspace: string, probes: ProbeResults): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                directory: {
+                    type: string;
+                    description: string;
+                };
+                maxDepth: {
+                    type: string;
+                    description: string;
+                    minimum: number;
+                    maximum: number;
+                };
+                includeHidden: {
+                    type: string;
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+    };
+    handler: (args: Record<string, unknown>, signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};

package/dist/tools/getFileTree.js

@@ -0,0 +1,111 @@
+import fs from "node:fs";
+import path from "node:path";
+import { execSafe, optionalBool, optionalInt, optionalString, resolveFilePath, success, } from "./utils.js";
+const IGNORED_DIRS = new Set([
+    "node_modules",
+    ".git",
+    "dist",
+    "__pycache__",
+    ".next",
+    ".nuxt",
+    "build",
+    "coverage",
+    ".cache",
+]);
+const MAX_ENTRIES = 2000;
+export function createGetFileTreeTool(workspace, probes) {
+    return {
+        schema: {
+            name: "getFileTree",
+            description: "List files and directories in the workspace tree. Respects .gitignore when available.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    directory: {
+                        type: "string",
+                        description: "Subdirectory to list (relative to workspace, default: root)",
+                    },
+                    maxDepth: {
+                        type: "integer",
+                        description: "Maximum directory depth (default: 3, max: 10)",
+                        minimum: 1,
+                        maximum: 10,
+                    },
+                    includeHidden: {
+                        type: "boolean",
+                        description: "Include hidden files/dirs (default: false)",
+                    },
+                },
+                additionalProperties: false,
+            },
+        },
+        handler: async (args, signal) => {
+            const directory = optionalString(args, "directory", 500);
+            const maxDepth = optionalInt(args, "maxDepth", 1, 10) ?? 3;
+            const includeHidden = optionalBool(args, "includeHidden") ?? false;
+            const targetDir = directory
+                ? resolveFilePath(directory, workspace)
+                : workspace;
+            if (probes.git) {
+                const result = await execSafe("git", ["ls-files", "--cached", "--others", "--exclude-standard"], { cwd: workspace, timeout: 10000, signal });
+                if (result.exitCode === 0) {
+                    let entries = result.stdout.split("\n").filter(Boolean);
+                    // Filter by target directory
+                    if (directory) {
+                        entries = entries.filter((e) => e === directory || e.startsWith(`${directory}/`));
+                    }
+                    if (!includeHidden) {
+                        entries = entries.filter((e) => !e.split("/").some((p) => p.startsWith(".") && p !== "."));
+                    }
+                    // Apply depth limit
+                    const relBase = directory || "";
+                    entries = entries.filter((e) => {
+                        const rel = relBase ? e.slice(relBase.length + 1) : e;
+                        return rel.split("/").length <= maxDepth;
+                    });
+                    entries = entries.slice(0, MAX_ENTRIES);
+                    return success({
+                        entries,
+                        total: entries.length,
+                        truncated: entries.length >= MAX_ENTRIES,
+                        tool: "git",
+                    });
+                }
+            }
+            // Fallback: async fs.readdir
+            const entries = [];
+            async function walk(dir, depth) {
+                if (depth > maxDepth || entries.length >= MAX_ENTRIES)
+                    return;
+                let items;
+                try {
+                    items = await fs.promises.readdir(dir, { withFileTypes: true });
+                }
+                catch {
+                    return;
+                }
+                for (const item of items) {
+                    if (entries.length >= MAX_ENTRIES)
+                        break;
+                    if (!includeHidden && item.name.startsWith("."))
+                        continue;
+                    if (item.isDirectory() && IGNORED_DIRS.has(item.name))
+                        continue;
+                    const rel = path.relative(workspace, path.join(dir, item.name));
+                    entries.push(item.isDirectory() ? `${rel}/` : rel);
+                    if (item.isDirectory())
+                        await walk(path.join(dir, item.name), depth + 1);
+                }
+            }
+            await walk(targetDir, 1);
+            return success({
+                entries,
+                total: entries.length,
+                truncated: entries.length >= MAX_ENTRIES,
+                tool: "fs",
+            });
+        },
+    };
+}
+//# sourceMappingURL=getFileTree.js.map

package/dist/tools/getFileTree.js.map

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

package/dist/tools/getGitDiff.d.ts

@@ -0,0 +1,34 @@
+export declare function createGetGitDiffTool(workspace: string): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            $schema: string;
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                filePath: {
+                    type: string;
+                    description: string;
+                };
+                staged: {
+                    type: string;
+                    description: string;
+                };
+                context: {
+                    type: string;
+                    description: string;
+                };
+            };
+        };
+    };
+    handler(args: Record<string, unknown>, signal?: AbortSignal): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};

package/dist/tools/getGitDiff.js

@@ -0,0 +1,57 @@
+import { execSafe, optionalBool, optionalInt, optionalString, resolveFilePath, success, truncateOutput, } from "./utils.js";
+const MAX_DIFF_BYTES = 500 * 1024;
+export function createGetGitDiffTool(workspace) {
+    return {
+        schema: {
+            name: "getGitDiff",
+            description: "Get the git diff output for the workspace or a specific file",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Optional absolute or workspace-relative file path to diff",
+                    },
+                    staged: {
+                        type: "boolean",
+                        description: "If true, show staged (cached) changes. Default: false",
+                    },
+                    context: {
+                        type: "integer",
+                        description: "Number of context lines around changes. Default: 3",
+                    },
+                },
+            },
+        },
+        async handler(args, signal) {
+            const rawPath = optionalString(args, "filePath");
+            const staged = optionalBool(args, "staged") ?? false;
+            const context = optionalInt(args, "context", 0, 100) ?? 3;
+            const filterPath = rawPath
+                ? resolveFilePath(rawPath, workspace)
+                : undefined;
+            const diffArgs = ["diff"];
+            if (staged) {
+                diffArgs.push("--cached");
+            }
+            diffArgs.push(`-U${context}`);
+            if (filterPath) {
+                diffArgs.push("--", filterPath);
+            }
+            const result = await execSafe("git", diffArgs, {
+                cwd: workspace,
+                maxBuffer: MAX_DIFF_BYTES + 64 * 1024,
+                signal,
+            });
+            if (result.exitCode !== 0) {
+                return success({ error: result.stderr.trim() || "git diff failed" });
+            }
+            const { text, truncated } = truncateOutput(result.stdout, MAX_DIFF_BYTES);
+            return success({ diff: text, truncated });
+        },
+    };
+}
+//# sourceMappingURL=getGitDiff.js.map

package/dist/tools/getGitDiff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getGitDiff.js","sourceRoot":"","sources":["../../src/tools/getGitDiff.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,cAAc,EACd,eAAe,EACf,OAAO,EACP,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,MAAM,cAAc,GAAG,GAAG,GAAG,IAAI,CAAC;AAElC,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,YAAY;YAClB,WAAW,EACT,8DAA8D;YAChE,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;YACnC,WAAW,EAAE;gBACX,OAAO,EAAE,yCAAyC;gBAClD,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,KAAK;gBAC3B,UAAU,EAAE;oBACV,QAAQ,EAAE;wBACR,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,2DAA2D;qBAC9D;oBACD,MAAM,EAAE;wBACN,IAAI,EAAE,SAAS;wBACf,WAAW,EACT,uDAAuD;qBAC1D;oBACD,OAAO,EAAE;wBACP,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,oDAAoD;qBAClE;iBACF;aACF;SACF;QAED,KAAK,CAAC,OAAO,CAAC,IAA6B,EAAE,MAAoB;YAC/D,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,KAAK,CAAC;YACrD,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YAE1D,MAAM,UAAU,GAAG,OAAO;gBACxB,CAAC,CAAC,eAAe,CAAC,OAAO,EAAE,SAAS,CAAC;gBACrC,CAAC,CAAC,SAAS,CAAC;YAEd,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,MAAM,EAAE,CAAC;gBACX,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC5B,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;YAC9B,IAAI,UAAU,EAAE,CAAC;gBACf,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAClC,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE;gBAC7C,GAAG,EAAE,SAAS;gBACd,SAAS,EAAE,cAAc,GAAG,EAAE,GAAG,IAAI;gBACrC,MAAM;aACP,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,iBAAiB,EAAE,CAAC,CAAC;YACvE,CAAC;YAED,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;YAC1E,OAAO,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5C,CAAC;KACF,CAAC;AACJ,CAAC"}