@hibanacloud/core 0.3.15

package/dist/src/utils/llm-edit-fixer.js

@@ -0,0 +1,131 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { createHash } from 'node:crypto';
+import { Type } from '@google/genai';
+import {} from '../core/baseLlmClient.js';
+import { LruCache } from './LruCache.js';
+import { DEFAULT_GEMINI_FLASH_MODEL } from '../config/models.js';
+import { promptIdContext } from './promptIdContext.js';
+const MAX_CACHE_SIZE = 50;
+const EDIT_SYS_PROMPT = `
+You are an expert code-editing assistant specializing in debugging and correcting failed search-and-replace operations.
+
+# Primary Goal
+Your task is to analyze a failed edit attempt and provide a corrected \`search\` string that will match the text in the file precisely. The correction should be as minimal as possible, staying very close to the original, failed \`search\` string. Do NOT invent a completely new edit based on the instruction; your job is to fix the provided parameters.
+
+It is important that you do no try to figure out if the instruction is correct. DO NOT GIVE ADVICE. Your only goal here is to do your best to perform the search and replace task! 
+
+# Input Context
+You will be given:
+1. The high-level instruction for the original edit.
+2. The exact \`search\` and \`replace\` strings that failed.
+3. The error message that was produced.
+4. The full content of the source file.
+
+# Rules for Correction
+1.  **Minimal Correction:** Your new \`search\` string must be a close variation of the original. Focus on fixing issues like whitespace, indentation, line endings, or small contextual differences.
+2.  **Explain the Fix:** Your \`explanation\` MUST state exactly why the original \`search\` failed and how your new \`search\` string resolves that specific failure. (e.g., "The original search failed due to incorrect indentation; the new search corrects the indentation to match the source file.").
+3.  **Preserve the \`replace\` String:** Do NOT modify the \`replace\` string unless the instruction explicitly requires it and it was the source of the error. Your primary focus is fixing the \`search\` string.
+4.  **No Changes Case:** CRUCIAL: if the change is already present in the file,  set \`noChangesRequired\` to True and explain why in the \`explanation\`. It is crucial that you only do this if the changes outline in \`replace\` are alredy in the file and suits the instruction!! 
+5.  **Exactness:** The final \`search\` field must be the EXACT literal text from the file. Do not escape characters.
+`;
+const EDIT_USER_PROMPT = `
+# Goal of the Original Edit
+<instruction>
+{instruction}
+</instruction>
+
+# Failed Attempt Details
+- **Original \`search\` parameter (failed):**
+<search>
+{old_string}
+</search>
+- **Original \`replace\` parameter:**
+<replace>
+{new_string}
+</replace>
+- **Error Encountered:**
+<error>
+{error}
+</error>
+
+# Full File Content
+<file_content>
+{current_content}
+</file_content>
+
+# Your Task
+Based on the error and the file content, provide a corrected \`search\` string that will succeed. Remember to keep your correction minimal and explain the precise reason for the failure in your \`explanation\`.
+`;
+const SearchReplaceEditSchema = {
+    type: Type.OBJECT,
+    properties: {
+        explanation: { type: Type.STRING },
+        search: { type: Type.STRING },
+        replace: { type: Type.STRING },
+        noChangesRequired: { type: Type.BOOLEAN },
+    },
+    required: ['search', 'replace', 'explanation'],
+};
+const editCorrectionWithInstructionCache = new LruCache(MAX_CACHE_SIZE);
+/**
+ * Attempts to fix a failed edit by using an LLM to generate a new search and replace pair.
+ * @param instruction The instruction for what needs to be done.
+ * @param old_string The original string to be replaced.
+ * @param new_string The original replacement string.
+ * @param error The error that occurred during the initial edit.
+ * @param current_content The current content of the file.
+ * @param baseLlmClient The BaseLlmClient to use for the LLM call.
+ * @param abortSignal An abort signal to cancel the operation.
+ * @param promptId A unique ID for the prompt.
+ * @returns A new search and replace pair.
+ */
+export async function FixLLMEditWithInstruction(instruction, old_string, new_string, error, current_content, baseLlmClient, abortSignal) {
+    let promptId = promptIdContext.getStore();
+    if (!promptId) {
+        promptId = `llm-fixer-fallback-${Date.now()}-${Math.random().toString(16).slice(2)}`;
+        console.warn(`Could not find promptId in context. This is unexpected. Using a fallback ID: ${promptId}`);
+    }
+    const cacheKey = createHash('sha256')
+        .update(JSON.stringify([
+        current_content,
+        old_string,
+        new_string,
+        instruction,
+        error,
+    ]))
+        .digest('hex');
+    const cachedResult = editCorrectionWithInstructionCache.get(cacheKey);
+    if (cachedResult) {
+        return cachedResult;
+    }
+    const userPrompt = EDIT_USER_PROMPT.replace('{instruction}', instruction)
+        .replace('{old_string}', old_string)
+        .replace('{new_string}', new_string)
+        .replace('{error}', error)
+        .replace('{current_content}', current_content);
+    const contents = [
+        {
+            role: 'user',
+            parts: [{ text: userPrompt }],
+        },
+    ];
+    const result = (await baseLlmClient.generateJson({
+        contents,
+        schema: SearchReplaceEditSchema,
+        abortSignal,
+        model: DEFAULT_GEMINI_FLASH_MODEL,
+        systemInstruction: EDIT_SYS_PROMPT,
+        promptId,
+        maxAttempts: 1,
+    }));
+    editCorrectionWithInstructionCache.set(cacheKey, result);
+    return result;
+}
+export function resetLlmEditFixerCaches_TEST_ONLY() {
+    editCorrectionWithInstructionCache.clear();
+}
+//# sourceMappingURL=llm-edit-fixer.js.map

package/dist/src/utils/llm-edit-fixer.js.map

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

package/dist/src/utils/llm-edit-fixer.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/utils/llm-edit-fixer.test.js

@@ -0,0 +1,186 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { FixLLMEditWithInstruction, resetLlmEditFixerCaches_TEST_ONLY, } from './llm-edit-fixer.js';
+import { promptIdContext } from './promptIdContext.js';
+// Mock the BaseLlmClient
+const mockGenerateJson = vi.fn();
+const mockBaseLlmClient = {
+    generateJson: mockGenerateJson,
+};
+describe('FixLLMEditWithInstruction', () => {
+    const instruction = 'Replace the title';
+    const old_string = '<h1>Old Title</h1>';
+    const new_string = '<h1>New Title</h1>';
+    const error = 'String not found';
+    const current_content = '<body><h1>Old Title</h1></body>';
+    const abortController = new AbortController();
+    const abortSignal = abortController.signal;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        resetLlmEditFixerCaches_TEST_ONLY(); // Ensure cache is cleared before each test
+    });
+    afterEach(() => {
+        vi.useRealTimers(); // Reset timers after each test
+    });
+    const mockApiResponse = {
+        search: '<h1>Old Title</h1>',
+        replace: '<h1>New Title</h1>',
+        noChangesRequired: false,
+        explanation: 'The original search was correct.',
+    };
+    it('should use the promptId from the AsyncLocalStorage context when available', async () => {
+        const testPromptId = 'test-prompt-id-12345';
+        mockGenerateJson.mockResolvedValue(mockApiResponse);
+        await promptIdContext.run(testPromptId, async () => {
+            await FixLLMEditWithInstruction(instruction, old_string, new_string, error, current_content, mockBaseLlmClient, abortSignal);
+        });
+        // Verify that generateJson was called with the promptId from the context
+        expect(mockGenerateJson).toHaveBeenCalledTimes(1);
+        expect(mockGenerateJson).toHaveBeenCalledWith(expect.objectContaining({
+            promptId: testPromptId,
+        }));
+    });
+    it('should generate and use a fallback promptId when context is not available', async () => {
+        mockGenerateJson.mockResolvedValue(mockApiResponse);
+        const consoleWarnSpy = vi
+            .spyOn(console, 'warn')
+            .mockImplementation(() => { });
+        // Run the function outside of any context
+        await FixLLMEditWithInstruction(instruction, old_string, new_string, error, current_content, mockBaseLlmClient, abortSignal);
+        // Verify the warning was logged
+        expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining('Could not find promptId in context. This is unexpected. Using a fallback ID: llm-fixer-fallback-'));
+        // Verify that generateJson was called with the generated fallback promptId
+        expect(mockGenerateJson).toHaveBeenCalledTimes(1);
+        expect(mockGenerateJson).toHaveBeenCalledWith(expect.objectContaining({
+            promptId: expect.stringContaining('llm-fixer-fallback-'),
+        }));
+        // Restore mocks
+        consoleWarnSpy.mockRestore();
+    });
+    it('should construct the user prompt correctly', async () => {
+        mockGenerateJson.mockResolvedValue(mockApiResponse);
+        const promptId = 'test-prompt-id-prompt-construction';
+        await promptIdContext.run(promptId, async () => {
+            await FixLLMEditWithInstruction(instruction, old_string, new_string, error, current_content, mockBaseLlmClient, abortSignal);
+        });
+        const generateJsonCall = mockGenerateJson.mock.calls[0][0];
+        const userPromptContent = generateJsonCall.contents[0].parts[0].text;
+        expect(userPromptContent).toContain(`<instruction>\n${instruction}\n</instruction>`);
+        expect(userPromptContent).toContain(`<search>\n${old_string}\n</search>`);
+        expect(userPromptContent).toContain(`<replace>\n${new_string}\n</replace>`);
+        expect(userPromptContent).toContain(`<error>\n${error}\n</error>`);
+        expect(userPromptContent).toContain(`<file_content>\n${current_content}\n</file_content>`);
+    });
+    it('should return a cached result on subsequent identical calls', async () => {
+        mockGenerateJson.mockResolvedValue(mockApiResponse);
+        const testPromptId = 'test-prompt-id-caching';
+        await promptIdContext.run(testPromptId, async () => {
+            // First call - should call the API
+            const result1 = await FixLLMEditWithInstruction(instruction, old_string, new_string, error, current_content, mockBaseLlmClient, abortSignal);
+            // Second call with identical parameters - should hit the cache
+            const result2 = await FixLLMEditWithInstruction(instruction, old_string, new_string, error, current_content, mockBaseLlmClient, abortSignal);
+            expect(result1).toEqual(mockApiResponse);
+            expect(result2).toEqual(mockApiResponse);
+            // Verify the underlying service was only called ONCE
+            expect(mockGenerateJson).toHaveBeenCalledTimes(1);
+        });
+    });
+    it('should not use cache for calls with different parameters', async () => {
+        mockGenerateJson.mockResolvedValue(mockApiResponse);
+        const testPromptId = 'test-prompt-id-cache-miss';
+        await promptIdContext.run(testPromptId, async () => {
+            // First call
+            await FixLLMEditWithInstruction(instruction, old_string, new_string, error, current_content, mockBaseLlmClient, abortSignal);
+            // Second call with a different instruction
+            await FixLLMEditWithInstruction('A different instruction', old_string, new_string, error, current_content, mockBaseLlmClient, abortSignal);
+            // Verify the underlying service was called TWICE
+            expect(mockGenerateJson).toHaveBeenCalledTimes(2);
+        });
+    });
+    describe('cache collision prevention', () => {
+        it('should prevent cache collisions when parameters contain separator sequences', async () => {
+            // This test would have failed with the old string concatenation approach
+            // but passes with JSON.stringify implementation
+            const firstResponse = {
+                search: 'original text',
+                replace: 'first replacement',
+                noChangesRequired: false,
+                explanation: 'First edit correction',
+            };
+            const secondResponse = {
+                search: 'different text',
+                replace: 'second replacement',
+                noChangesRequired: false,
+                explanation: 'Second edit correction',
+            };
+            mockGenerateJson
+                .mockResolvedValueOnce(firstResponse)
+                .mockResolvedValueOnce(secondResponse);
+            const testPromptId = 'cache-collision-test';
+            await promptIdContext.run(testPromptId, async () => {
+                // Scenario 1: Parameters that would create collision with string concatenation
+                // Cache key with old method would be: "Fix YAML---content---update--some---data--error"
+                const call1 = await FixLLMEditWithInstruction('Fix YAML', // instruction
+                'content', // old_string
+                'update--some', // new_string (contains --)
+                'data', // current_content
+                'error', // error
+                mockBaseLlmClient, abortSignal);
+                // Scenario 2: Different parameters that would create same cache key with concatenation
+                // Cache key with old method would be: "Fix YAML---content---update--some---data--error"
+                const call2 = await FixLLMEditWithInstruction('Fix YAML---content---update', // instruction (contains ---)
+                'some---data', // old_string (contains ---)
+                'error', // new_string
+                '', // current_content
+                '', // error
+                mockBaseLlmClient, abortSignal);
+                // With the fixed JSON.stringify approach, these should be different
+                // and each should get its own LLM response
+                expect(call1).toEqual(firstResponse);
+                expect(call2).toEqual(secondResponse);
+                expect(call1).not.toEqual(call2);
+                // Most importantly: the LLM should be called TWICE, not once
+                // (proving no cache collision occurred)
+                expect(mockGenerateJson).toHaveBeenCalledTimes(2);
+            });
+        });
+        it('should handle YAML frontmatter without cache collisions', async () => {
+            // Real-world test case with YAML frontmatter containing ---
+            const yamlResponse = {
+                search: '---\ntitle: Old\n---',
+                replace: '---\ntitle: New\n---',
+                noChangesRequired: false,
+                explanation: 'Updated YAML frontmatter',
+            };
+            const contentResponse = {
+                search: 'old content',
+                replace: 'new content',
+                noChangesRequired: false,
+                explanation: 'Updated content',
+            };
+            mockGenerateJson
+                .mockResolvedValueOnce(yamlResponse)
+                .mockResolvedValueOnce(contentResponse);
+            const testPromptId = 'yaml-frontmatter-test';
+            await promptIdContext.run(testPromptId, async () => {
+                // Call 1: Edit YAML frontmatter
+                const yamlEdit = await FixLLMEditWithInstruction('Update YAML frontmatter', '---\ntitle: Old\n---', // Contains ---
+                '---\ntitle: New\n---', // Contains ---
+                'Some markdown content', 'YAML parse error', mockBaseLlmClient, abortSignal);
+                // Call 2: Edit regular content
+                const contentEdit = await FixLLMEditWithInstruction('Update content', 'old content', 'new content', 'Different file content', 'Content not found', mockBaseLlmClient, abortSignal);
+                // Verify both calls succeeded with different results
+                expect(yamlEdit).toEqual(yamlResponse);
+                expect(contentEdit).toEqual(contentResponse);
+                expect(yamlEdit).not.toEqual(contentEdit);
+                // Verify no cache collision - both calls should hit the LLM
+                expect(mockGenerateJson).toHaveBeenCalledTimes(2);
+            });
+        });
+    });
+});
+//# sourceMappingURL=llm-edit-fixer.test.js.map

package/dist/src/utils/llm-edit-fixer.test.js.map

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

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

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { FileDiscoveryService } from '../services/fileDiscoveryService.js';
+import type { FileFilteringOptions } from '../config/constants.js';
+export interface LoadServerHierarchicalMemoryResponse {
+    memoryContent: string;
+    fileCount: number;
+}
+/**
+ * Loads hierarchical QWEN.md files and concatenates their content.
+ * This function is intended for use by the server.
+ */
+export declare function loadServerHierarchicalMemory(currentWorkingDirectory: string, includeDirectoriesToReadGemini: readonly string[], debugMode: boolean, fileService: FileDiscoveryService, extensionContextFilePaths: string[] | undefined, folderTrust: boolean, importFormat?: 'flat' | 'tree', fileFilteringOptions?: FileFilteringOptions, maxDirs?: number): Promise<LoadServerHierarchicalMemoryResponse>;

package/dist/src/utils/memoryDiscovery.js

@@ -0,0 +1,272 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs/promises';
+import * as fsSync from 'node:fs';
+import * as path from 'node:path';
+import { homedir } from 'node:os';
+import { bfsFileSearch } from './bfsFileSearch.js';
+import { getAllGeminiMdFilenames } from '../tools/memoryTool.js';
+import { processImports } from './memoryImportProcessor.js';
+import { DEFAULT_MEMORY_FILE_FILTERING_OPTIONS } from '../config/constants.js';
+import { QWEN_DIR } from './paths.js';
+// Simple console logger, similar to the one previously in CLI's config.ts
+// TODO: Integrate with a more robust server-side logger if available/appropriate.
+const logger = {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    debug: (...args) => console.debug('[DEBUG] [MemoryDiscovery]', ...args),
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    warn: (...args) => console.warn('[WARN] [MemoryDiscovery]', ...args),
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    error: (...args) => console.error('[ERROR] [MemoryDiscovery]', ...args),
+};
+async function findProjectRoot(startDir) {
+    let currentDir = path.resolve(startDir);
+    while (true) {
+        const gitPath = path.join(currentDir, '.git');
+        try {
+            const stats = await fs.lstat(gitPath);
+            if (stats.isDirectory()) {
+                return currentDir;
+            }
+        }
+        catch (error) {
+            // Don't log ENOENT errors as they're expected when .git doesn't exist
+            // Also don't log errors in test environments, which often have mocked fs
+            const isENOENT = typeof error === 'object' &&
+                error !== null &&
+                'code' in error &&
+                error.code === 'ENOENT';
+            // Only log unexpected errors in non-test environments
+            // process.env['NODE_ENV'] === 'test' or VITEST are common test indicators
+            const isTestEnv = process.env['NODE_ENV'] === 'test' || process.env['VITEST'];
+            if (!isENOENT && !isTestEnv) {
+                if (typeof error === 'object' && error !== null && 'code' in error) {
+                    const fsError = error;
+                    logger.warn(`Error checking for .git directory at ${gitPath}: ${fsError.message}`);
+                }
+                else {
+                    logger.warn(`Non-standard error checking for .git directory at ${gitPath}: ${String(error)}`);
+                }
+            }
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir) {
+            return null;
+        }
+        currentDir = parentDir;
+    }
+}
+async function getGeminiMdFilePathsInternal(currentWorkingDirectory, includeDirectoriesToReadGemini, userHomePath, debugMode, fileService, extensionContextFilePaths = [], folderTrust, fileFilteringOptions, maxDirs) {
+    const dirs = new Set([
+        ...includeDirectoriesToReadGemini,
+        currentWorkingDirectory,
+    ]);
+    // Process directories in parallel with concurrency limit to prevent EMFILE errors
+    const CONCURRENT_LIMIT = 10;
+    const dirsArray = Array.from(dirs);
+    const pathsArrays = [];
+    for (let i = 0; i < dirsArray.length; i += CONCURRENT_LIMIT) {
+        const batch = dirsArray.slice(i, i + CONCURRENT_LIMIT);
+        const batchPromises = batch.map((dir) => getGeminiMdFilePathsInternalForEachDir(dir, userHomePath, debugMode, fileService, extensionContextFilePaths, folderTrust, fileFilteringOptions, maxDirs));
+        const batchResults = await Promise.allSettled(batchPromises);
+        for (const result of batchResults) {
+            if (result.status === 'fulfilled') {
+                pathsArrays.push(result.value);
+            }
+            else {
+                const error = result.reason;
+                const message = error instanceof Error ? error.message : String(error);
+                logger.error(`Error discovering files in directory: ${message}`);
+                // Continue processing other directories
+            }
+        }
+    }
+    const paths = pathsArrays.flat();
+    return Array.from(new Set(paths));
+}
+async function getGeminiMdFilePathsInternalForEachDir(dir, userHomePath, debugMode, fileService, extensionContextFilePaths = [], folderTrust, fileFilteringOptions, maxDirs) {
+    const allPaths = new Set();
+    const geminiMdFilenames = getAllGeminiMdFilenames();
+    for (const geminiMdFilename of geminiMdFilenames) {
+        const resolvedHome = path.resolve(userHomePath);
+        const globalMemoryPath = path.join(resolvedHome, QWEN_DIR, geminiMdFilename);
+        // This part that finds the global file always runs.
+        try {
+            await fs.access(globalMemoryPath, fsSync.constants.R_OK);
+            allPaths.add(globalMemoryPath);
+            if (debugMode)
+                logger.debug(`Found readable global ${geminiMdFilename}: ${globalMemoryPath}`);
+        }
+        catch {
+            // It's okay if it's not found.
+        }
+        // Handle the case where we're in the home directory (dir is empty string or home path)
+        const resolvedDir = dir ? path.resolve(dir) : resolvedHome;
+        const isHomeDirectory = resolvedDir === resolvedHome;
+        if (isHomeDirectory) {
+            // For home directory, only check for QWEN.md directly in the home directory
+            const homeContextPath = path.join(resolvedHome, geminiMdFilename);
+            try {
+                await fs.access(homeContextPath, fsSync.constants.R_OK);
+                if (homeContextPath !== globalMemoryPath) {
+                    allPaths.add(homeContextPath);
+                    if (debugMode)
+                        logger.debug(`Found readable home ${geminiMdFilename}: ${homeContextPath}`);
+                }
+            }
+            catch {
+                // Not found, which is okay
+            }
+        }
+        else if (dir && folderTrust) {
+            // FIX: Only perform the workspace search (upward and downward scans)
+            // if a valid currentWorkingDirectory is provided and it's not the home directory.
+            const resolvedCwd = path.resolve(dir);
+            if (debugMode)
+                logger.debug(`Searching for ${geminiMdFilename} starting from CWD: ${resolvedCwd}`);
+            const projectRoot = await findProjectRoot(resolvedCwd);
+            if (debugMode)
+                logger.debug(`Determined project root: ${projectRoot ?? 'None'}`);
+            const upwardPaths = [];
+            let currentDir = resolvedCwd;
+            const ultimateStopDir = projectRoot
+                ? path.dirname(projectRoot)
+                : path.dirname(resolvedHome);
+            while (currentDir && currentDir !== path.dirname(currentDir)) {
+                if (currentDir === path.join(resolvedHome, QWEN_DIR)) {
+                    break;
+                }
+                const potentialPath = path.join(currentDir, geminiMdFilename);
+                try {
+                    await fs.access(potentialPath, fsSync.constants.R_OK);
+                    if (potentialPath !== globalMemoryPath) {
+                        upwardPaths.unshift(potentialPath);
+                    }
+                }
+                catch {
+                    // Not found, continue.
+                }
+                if (currentDir === ultimateStopDir) {
+                    break;
+                }
+                currentDir = path.dirname(currentDir);
+            }
+            upwardPaths.forEach((p) => allPaths.add(p));
+            const mergedOptions = {
+                ...DEFAULT_MEMORY_FILE_FILTERING_OPTIONS,
+                ...fileFilteringOptions,
+            };
+            const downwardPaths = await bfsFileSearch(resolvedCwd, {
+                fileName: geminiMdFilename,
+                maxDirs,
+                debug: debugMode,
+                fileService,
+                fileFilteringOptions: mergedOptions,
+            });
+            downwardPaths.sort();
+            for (const dPath of downwardPaths) {
+                allPaths.add(dPath);
+            }
+        }
+    }
+    // Add extension context file paths.
+    for (const extensionPath of extensionContextFilePaths) {
+        allPaths.add(extensionPath);
+    }
+    const finalPaths = Array.from(allPaths);
+    if (debugMode)
+        logger.debug(`Final ordered ${getAllGeminiMdFilenames()} paths to read: ${JSON.stringify(finalPaths)}`);
+    return finalPaths;
+}
+async function readGeminiMdFiles(filePaths, debugMode, importFormat = 'tree') {
+    // Process files in parallel with concurrency limit to prevent EMFILE errors
+    const CONCURRENT_LIMIT = 20; // Higher limit for file reads as they're typically faster
+    const results = [];
+    for (let i = 0; i < filePaths.length; i += CONCURRENT_LIMIT) {
+        const batch = filePaths.slice(i, i + CONCURRENT_LIMIT);
+        const batchPromises = batch.map(async (filePath) => {
+            try {
+                const content = await fs.readFile(filePath, 'utf-8');
+                // Process imports in the content
+                const processedResult = await processImports(content, path.dirname(filePath), debugMode, undefined, undefined, importFormat);
+                if (debugMode)
+                    logger.debug(`Successfully read and processed imports: ${filePath} (Length: ${processedResult.content.length})`);
+                return { filePath, content: processedResult.content };
+            }
+            catch (error) {
+                const isTestEnv = process.env['NODE_ENV'] === 'test' || process.env['VITEST'];
+                if (!isTestEnv) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    logger.warn(`Warning: Could not read ${getAllGeminiMdFilenames()} file at ${filePath}. Error: ${message}`);
+                }
+                if (debugMode)
+                    logger.debug(`Failed to read: ${filePath}`);
+                return { filePath, content: null }; // Still include it with null content
+            }
+        });
+        const batchResults = await Promise.allSettled(batchPromises);
+        for (const result of batchResults) {
+            if (result.status === 'fulfilled') {
+                results.push(result.value);
+            }
+            else {
+                // This case shouldn't happen since we catch all errors above,
+                // but handle it for completeness
+                const error = result.reason;
+                const message = error instanceof Error ? error.message : String(error);
+                logger.error(`Unexpected error processing file: ${message}`);
+            }
+        }
+    }
+    return results;
+}
+function concatenateInstructions(instructionContents, 
+// CWD is needed to resolve relative paths for display markers
+currentWorkingDirectoryForDisplay) {
+    return instructionContents
+        .filter((item) => typeof item.content === 'string')
+        .map((item) => {
+        const trimmedContent = item.content.trim();
+        if (trimmedContent.length === 0) {
+            return null;
+        }
+        const displayPath = path.isAbsolute(item.filePath)
+            ? path.relative(currentWorkingDirectoryForDisplay, item.filePath)
+            : item.filePath;
+        return `--- Context from: ${displayPath} ---\n${trimmedContent}\n--- End of Context from: ${displayPath} ---`;
+    })
+        .filter((block) => block !== null)
+        .join('\n\n');
+}
+/**
+ * Loads hierarchical QWEN.md files and concatenates their content.
+ * This function is intended for use by the server.
+ */
+export async function loadServerHierarchicalMemory(currentWorkingDirectory, includeDirectoriesToReadGemini, debugMode, fileService, extensionContextFilePaths = [], folderTrust, importFormat = 'tree', fileFilteringOptions, maxDirs = 200) {
+    if (debugMode)
+        logger.debug(`Loading server hierarchical memory for CWD: ${currentWorkingDirectory} (importFormat: ${importFormat})`);
+    // For the server, homedir() refers to the server process's home.
+    // This is consistent with how MemoryTool already finds the global path.
+    const userHomePath = homedir();
+    const filePaths = await getGeminiMdFilePathsInternal(currentWorkingDirectory, includeDirectoriesToReadGemini, userHomePath, debugMode, fileService, extensionContextFilePaths, folderTrust, fileFilteringOptions || DEFAULT_MEMORY_FILE_FILTERING_OPTIONS, maxDirs);
+    if (filePaths.length === 0) {
+        if (debugMode)
+            logger.debug('No QWEN.md files found in hierarchy.');
+        return { memoryContent: '', fileCount: 0 };
+    }
+    const contentsWithPaths = await readGeminiMdFiles(filePaths, debugMode, importFormat);
+    // Pass CWD for relative path display in concatenated content
+    const combinedInstructions = concatenateInstructions(contentsWithPaths, currentWorkingDirectory);
+    if (debugMode)
+        logger.debug(`Combined instructions length: ${combinedInstructions.length}`);
+    if (debugMode && combinedInstructions.length > 0)
+        logger.debug(`Combined instructions (snippet): ${combinedInstructions.substring(0, 500)}...`);
+    return {
+        memoryContent: combinedInstructions,
+        fileCount: contentsWithPaths.length,
+    };
+}
+//# sourceMappingURL=memoryDiscovery.js.map