@anthropic-field/core 0.1.0

package/dist/src/utils/ignorePatterns.js

@@ -0,0 +1,220 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import path from 'node:path';
+import { getCurrentGeminiMdFilename } from '../tools/memoryTool.js';
+/**
+ * Common ignore patterns used across multiple tools for basic exclusions.
+ * These are the most commonly ignored directories in development projects.
+ */
+export const COMMON_IGNORE_PATTERNS = [
+    '**/node_modules/**',
+    '**/.git/**',
+    '**/bower_components/**',
+    '**/.svn/**',
+    '**/.hg/**',
+];
+/**
+ * Binary file extension patterns that are typically excluded from text processing.
+ */
+export const BINARY_FILE_PATTERNS = [
+    '**/*.bin',
+    '**/*.exe',
+    '**/*.dll',
+    '**/*.so',
+    '**/*.dylib',
+    '**/*.class',
+    '**/*.jar',
+    '**/*.war',
+    '**/*.zip',
+    '**/*.tar',
+    '**/*.gz',
+    '**/*.bz2',
+    '**/*.rar',
+    '**/*.7z',
+    '**/*.doc',
+    '**/*.docx',
+    '**/*.xls',
+    '**/*.xlsx',
+    '**/*.ppt',
+    '**/*.pptx',
+    '**/*.odt',
+    '**/*.ods',
+    '**/*.odp',
+];
+/**
+ * Media file patterns that require special handling in tools like read-many-files.
+ * These files can be processed as inlineData when explicitly requested.
+ */
+export const MEDIA_FILE_PATTERNS = [
+    '**/*.pdf',
+    '**/*.png',
+    '**/*.jpg',
+    '**/*.jpeg',
+    '**/*.gif',
+    '**/*.webp',
+    '**/*.bmp',
+    '**/*.svg',
+];
+/**
+ * Common directory patterns that are typically ignored in development projects.
+ */
+export const COMMON_DIRECTORY_EXCLUDES = [
+    '**/.vscode/**',
+    '**/.idea/**',
+    '**/dist/**',
+    '**/build/**',
+    '**/coverage/**',
+    '**/__pycache__/**',
+];
+/**
+ * Python-specific patterns.
+ */
+export const PYTHON_EXCLUDES = ['**/*.pyc', '**/*.pyo'];
+/**
+ * System and environment file patterns.
+ */
+export const SYSTEM_FILE_EXCLUDES = ['**/.DS_Store', '**/.env'];
+/**
+ * Comprehensive file exclusion patterns combining all common ignore patterns.
+ * These patterns are compatible with glob ignore patterns.
+ * Note: Media files (PDF, images) are not excluded here as they need special handling in read-many-files.
+ */
+export const DEFAULT_FILE_EXCLUDES = [
+    ...COMMON_IGNORE_PATTERNS,
+    ...COMMON_DIRECTORY_EXCLUDES,
+    ...BINARY_FILE_PATTERNS,
+    ...PYTHON_EXCLUDES,
+    ...SYSTEM_FILE_EXCLUDES,
+];
+/**
+ * Centralized file exclusion utility that provides configurable and extensible
+ * file exclusion patterns for different tools and use cases.
+ */
+export class FileExclusions {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Gets core ignore patterns for basic file operations like glob.
+     * These are the minimal essential patterns that should almost always be excluded.
+     */
+    getCoreIgnorePatterns() {
+        return [...COMMON_IGNORE_PATTERNS];
+    }
+    /**
+     * Gets comprehensive default exclusion patterns for operations like read-many-files.
+     * Includes all standard exclusions: directories, binary files, system files, etc.
+     */
+    getDefaultExcludePatterns(options = {}) {
+        const { includeDefaults = true, customPatterns = [], runtimePatterns = [], includeDynamicPatterns = true, } = options;
+        const patterns = [];
+        // Add base defaults if requested
+        if (includeDefaults) {
+            patterns.push(...DEFAULT_FILE_EXCLUDES);
+        }
+        // Add dynamic patterns (like current Gemini MD filename)
+        if (includeDynamicPatterns) {
+            patterns.push(`**/${getCurrentGeminiMdFilename()}`);
+        }
+        // Add custom patterns from configuration
+        // TODO: getCustomExcludes method needs to be implemented in Config interface
+        if (this.config) {
+            const configCustomExcludes = this.config.getCustomExcludes?.() ?? [];
+            patterns.push(...configCustomExcludes);
+        }
+        // Add user-provided custom patterns
+        patterns.push(...customPatterns);
+        // Add runtime patterns (e.g., from CLI)
+        patterns.push(...runtimePatterns);
+        return patterns;
+    }
+    /**
+     * Gets exclude patterns for read-many-files tool with legacy compatibility.
+     * This maintains the same behavior as the previous getDefaultExcludes() function.
+     */
+    getReadManyFilesExcludes(additionalExcludes = []) {
+        return this.getDefaultExcludePatterns({
+            includeDefaults: true,
+            runtimePatterns: additionalExcludes,
+            includeDynamicPatterns: true,
+        });
+    }
+    /**
+     * Gets exclude patterns for glob tool operations.
+     * Uses core patterns by default but can be extended with additional patterns.
+     */
+    getGlobExcludes(additionalExcludes = []) {
+        const corePatterns = this.getCoreIgnorePatterns();
+        // Add any custom patterns from config if available
+        // TODO: getCustomExcludes method needs to be implemented in Config interface
+        const configPatterns = this.config?.getCustomExcludes?.() ?? [];
+        return [...corePatterns, ...configPatterns, ...additionalExcludes];
+    }
+    /**
+     * Builds exclude patterns with full customization options.
+     * This is the most flexible method for advanced use cases.
+     */
+    buildExcludePatterns(options) {
+        return this.getDefaultExcludePatterns(options);
+    }
+}
+/**
+ * Extracts file extensions from glob patterns.
+ * Converts patterns like glob/*.exe to .exe
+ * Handles brace expansion like glob/*.{js,ts} to .js and .ts
+ */
+export function extractExtensionsFromPatterns(patterns) {
+    const extensions = new Set(patterns
+        .filter((pattern) => pattern.includes('*.'))
+        .flatMap((pattern) => {
+        const extPart = pattern.substring(pattern.lastIndexOf('*.') + 1);
+        // Handle brace expansion e.g. `**/*.{jpg,png}`
+        if (extPart.startsWith('.{') && extPart.endsWith('}')) {
+            const inner = extPart.slice(2, -1); // get 'jpg,png'
+            return inner
+                .split(',')
+                .map((ext) => `.${ext.trim()}`)
+                .filter((ext) => ext !== '.');
+        }
+        // Handle simple/compound/dotfile extensions
+        if (extPart.startsWith('.') &&
+            !extPart.includes('/') &&
+            !extPart.includes('{') &&
+            !extPart.includes('}')) {
+            // Using path.extname on a dummy file handles various cases like
+            // '.tar.gz' -> '.gz' and '.profile' -> '.profile' correctly.
+            const extracted = path.extname(`dummy${extPart}`);
+            // If extname returns empty (e.g. for '.'), use the original part.
+            // Then filter out empty or '.' results and invalid double dot patterns.
+            const result = extracted || extPart;
+            return result && result !== '.' && !result.substring(1).includes('.')
+                ? [result]
+                : [];
+        }
+        return [];
+    }));
+    return Array.from(extensions).sort();
+}
+/**
+ * Binary file extensions extracted from BINARY_FILE_PATTERNS for quick lookup.
+ * Additional extensions not covered by the patterns are included for completeness.
+ */
+export const BINARY_EXTENSIONS = [
+    ...extractExtensionsFromPatterns([
+        ...BINARY_FILE_PATTERNS,
+        ...MEDIA_FILE_PATTERNS,
+        ...PYTHON_EXCLUDES,
+    ]),
+    // Additional binary extensions not in the main patterns
+    '.dat',
+    '.obj',
+    '.o',
+    '.a',
+    '.lib',
+    '.wasm',
+].sort();
+//# sourceMappingURL=ignorePatterns.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare class InstallationManager {
+    private getInstallationIdPath;
+    private readInstallationIdFromFile;
+    private writeInstallationIdToFile;
+    /**
+     * Retrieves the installation ID from a file, creating it if it doesn't exist.
+     * This ID is used for unique user installation tracking.
+     * @returns A UUID string for the user.
+     */
+    getInstallationId(): string;
+}

package/dist/src/utils/installationManager.js

@@ -0,0 +1,51 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs';
+import { randomUUID } from 'node:crypto';
+import * as path from 'node:path';
+import { Storage } from '../config/storage.js';
+import { debugLogger } from './debugLogger.js';
+export class InstallationManager {
+    getInstallationIdPath() {
+        return Storage.getInstallationIdPath();
+    }
+    readInstallationIdFromFile() {
+        const installationIdFile = this.getInstallationIdPath();
+        if (fs.existsSync(installationIdFile)) {
+            const installationid = fs
+                .readFileSync(installationIdFile, 'utf-8')
+                .trim();
+            return installationid || null;
+        }
+        return null;
+    }
+    writeInstallationIdToFile(installationId) {
+        const installationIdFile = this.getInstallationIdPath();
+        const dir = path.dirname(installationIdFile);
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(installationIdFile, installationId, 'utf-8');
+    }
+    /**
+     * Retrieves the installation ID from a file, creating it if it doesn't exist.
+     * This ID is used for unique user installation tracking.
+     * @returns A UUID string for the user.
+     */
+    getInstallationId() {
+        try {
+            let installationId = this.readInstallationIdFromFile();
+            if (!installationId) {
+                installationId = randomUUID();
+                this.writeInstallationIdToFile(installationId);
+            }
+            return installationId;
+        }
+        catch (error) {
+            debugLogger.warn('Error accessing installation ID file, generating ephemeral ID:', error);
+            return '123456789';
+        }
+    }
+}
+//# sourceMappingURL=installationManager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"installationManager.js","sourceRoot":"","sources":["../../../src/utils/installationManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,OAAO,mBAAmB;IACtB,qBAAqB;QAC3B,OAAO,OAAO,CAAC,qBAAqB,EAAE,CAAC;IACzC,CAAC;IAEO,0BAA0B;QAChC,MAAM,kBAAkB,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACxD,IAAI,EAAE,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACtC,MAAM,cAAc,GAAG,EAAE;iBACtB,YAAY,CAAC,kBAAkB,EAAE,OAAO,CAAC;iBACzC,IAAI,EAAE,CAAC;YACV,OAAO,cAAc,IAAI,IAAI,CAAC;QAChC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,yBAAyB,CAAC,cAAsB;QACtD,MAAM,kBAAkB,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACxD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAC7C,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,EAAE,CAAC,aAAa,CAAC,kBAAkB,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED;;;;OAIG;IACH,iBAAiB;QACf,IAAI,CAAC;YACH,IAAI,cAAc,GAAG,IAAI,CAAC,0BAA0B,EAAE,CAAC;YAEvD,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,cAAc,GAAG,UAAU,EAAE,CAAC;gBAC9B,IAAI,CAAC,yBAAyB,CAAC,cAAc,CAAC,CAAC;YACjD,CAAC;YAED,OAAO,cAAc,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,IAAI,CACd,gEAAgE,EAChE,KAAK,CACN,CAAC;YACF,OAAO,WAAW,CAAC;QACrB,CAAC;IACH,CAAC;CACF"}

package/dist/src/utils/language-detection.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare function getLanguageFromFilePath(filePath: string): string | undefined;

package/dist/src/utils/language-detection.js

@@ -0,0 +1,101 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as path from 'node:path';
+const extensionToLanguageMap = {
+    '.ts': 'TypeScript',
+    '.js': 'JavaScript',
+    '.mjs': 'JavaScript',
+    '.cjs': 'JavaScript',
+    '.jsx': 'JavaScript',
+    '.tsx': 'TypeScript',
+    '.py': 'Python',
+    '.java': 'Java',
+    '.go': 'Go',
+    '.rb': 'Ruby',
+    '.php': 'PHP',
+    '.phtml': 'PHP',
+    '.cs': 'C#',
+    '.cpp': 'C++',
+    '.cxx': 'C++',
+    '.cc': 'C++',
+    '.c': 'C',
+    '.h': 'C/C++',
+    '.hpp': 'C++',
+    '.swift': 'Swift',
+    '.kt': 'Kotlin',
+    '.rs': 'Rust',
+    '.m': 'Objective-C',
+    '.mm': 'Objective-C',
+    '.pl': 'Perl',
+    '.pm': 'Perl',
+    '.lua': 'Lua',
+    '.r': 'R',
+    '.scala': 'Scala',
+    '.sc': 'Scala',
+    '.sh': 'Shell',
+    '.ps1': 'PowerShell',
+    '.bat': 'Batch',
+    '.cmd': 'Batch',
+    '.sql': 'SQL',
+    '.html': 'HTML',
+    '.htm': 'HTML',
+    '.css': 'CSS',
+    '.less': 'Less',
+    '.sass': 'Sass',
+    '.scss': 'Sass',
+    '.json': 'JSON',
+    '.xml': 'XML',
+    '.yaml': 'YAML',
+    '.yml': 'YAML',
+    '.md': 'Markdown',
+    '.markdown': 'Markdown',
+    '.dockerfile': 'Dockerfile',
+    '.vim': 'Vim script',
+    '.vb': 'Visual Basic',
+    '.fs': 'F#',
+    '.clj': 'Clojure',
+    '.cljs': 'Clojure',
+    '.dart': 'Dart',
+    '.ex': 'Elixir',
+    '.erl': 'Erlang',
+    '.hs': 'Haskell',
+    '.lisp': 'Lisp',
+    '.rkt': 'Racket',
+    '.groovy': 'Groovy',
+    '.jl': 'Julia',
+    '.tex': 'LaTeX',
+    '.ino': 'Arduino',
+    '.asm': 'Assembly',
+    '.s': 'Assembly',
+    '.toml': 'TOML',
+    '.vue': 'Vue',
+    '.svelte': 'Svelte',
+    '.gohtml': 'Go Template',
+    '.hbs': 'Handlebars',
+    '.ejs': 'EJS',
+    '.erb': 'ERB',
+    '.jsp': 'JSP',
+    '.dockerignore': 'Docker',
+    '.gitignore': 'Git',
+    '.npmignore': 'npm',
+    '.editorconfig': 'EditorConfig',
+    '.prettierrc': 'Prettier',
+    '.eslintrc': 'ESLint',
+    '.babelrc': 'Babel',
+    '.tsconfig': 'TypeScript',
+    '.flow': 'Flow',
+    '.graphql': 'GraphQL',
+    '.proto': 'Protocol Buffers',
+};
+export function getLanguageFromFilePath(filePath) {
+    const extension = path.extname(filePath).toLowerCase();
+    if (extension) {
+        return extensionToLanguageMap[extension];
+    }
+    const filename = path.basename(filePath).toLowerCase();
+    return extensionToLanguageMap[`.${filename}`];
+}
+//# sourceMappingURL=language-detection.js.map

package/dist/src/utils/language-detection.js.map

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

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

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type BaseLlmClient } from '../core/baseLlmClient.js';
+export interface SearchReplaceEdit {
+    search: string;
+    replace: string;
+    noChangesRequired: boolean;
+    explanation: string;
+}
+/**
+ * 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 declare function FixLLMEditWithInstruction(instruction: string, old_string: string, new_string: string, error: string, current_content: string, baseLlmClient: BaseLlmClient, abortSignal: AbortSignal): Promise<SearchReplaceEdit | null>;
+export declare function resetLlmEditFixerCaches_TEST_ONLY(): void;

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

@@ -0,0 +1,152 @@
+/**
+ * @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 'mnemonist';
+import { getPromptIdWithFallback } from './promptIdContext.js';
+import { debugLogger } from './debugLogger.js';
+const MAX_CACHE_SIZE = 50;
+const GENERATE_JSON_TIMEOUT_MS = 40000; // 40 seconds
+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 latest version 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. Do not escape any characters in \`replace\`. 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 already 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);
+async function generateJsonWithTimeout(client, params, timeoutMs) {
+    try {
+        // Create a signal that aborts automatically after the specified timeout.
+        const timeoutSignal = AbortSignal.timeout(timeoutMs);
+        const result = await client.generateJson({
+            ...params,
+            // The operation will be aborted if either the original signal is aborted
+            // or if the timeout is reached.
+            abortSignal: AbortSignal.any([
+                params.abortSignal ?? new AbortController().signal,
+                timeoutSignal,
+            ]),
+        });
+        return result;
+    }
+    catch (err) {
+        debugLogger.debug('[LLM Edit Fixer] Timeout or error during generateJson', err);
+        // An AbortError will be thrown on timeout.
+        // We catch it and return null to signal that the operation timed out.
+        return null;
+    }
+}
+/**
+ * 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) {
+    const promptId = getPromptIdWithFallback('llm-fixer');
+    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 generateJsonWithTimeout(baseLlmClient, {
+        modelConfigKey: { model: 'llm-edit-fixer' },
+        contents,
+        schema: SearchReplaceEditSchema,
+        abortSignal,
+        systemInstruction: EDIT_SYS_PROMPT,
+        promptId,
+        maxAttempts: 1,
+    }, GENERATE_JSON_TIMEOUT_MS);
+    if (result) {
+        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":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAgB,IAAI,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAsB,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,cAAc,GAAG,EAAE,CAAC;AAC1B,MAAM,wBAAwB,GAAG,KAAK,CAAC,CAAC,aAAa;AAErD,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;CAqBvB,CAAC;AAEF,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BxB,CAAC;AASF,MAAM,uBAAuB,GAAG;IAC9B,IAAI,EAAE,IAAI,CAAC,MAAM;IACjB,UAAU,EAAE;QACV,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE;QAClC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE;QAC7B,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE;QAC9B,iBAAiB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE;KAC1C;IACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,aAAa,CAAC;CAC/C,CAAC;AAEF,MAAM,kCAAkC,GAAG,IAAI,QAAQ,CAGrD,cAAc,CAAC,CAAC;AAElB,KAAK,UAAU,uBAAuB,CACpC,MAAqB,EACrB,MAAoD,EACpD,SAAiB;IAEjB,IAAI,CAAC;QACH,yEAAyE;QACzE,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAErD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;YACvC,GAAG,MAAM;YACT,yEAAyE;YACzE,gCAAgC;YAChC,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC;gBAC3B,MAAM,CAAC,WAAW,IAAI,IAAI,eAAe,EAAE,CAAC,MAAM;gBAClD,aAAa;aACd,CAAC;SACH,CAAC,CAAC;QACH,OAAO,MAAW,CAAC;IACrB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,WAAW,CAAC,KAAK,CACf,uDAAuD,EACvD,GAAG,CACJ,CAAC;QACF,2CAA2C;QAC3C,sEAAsE;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,WAAmB,EACnB,UAAkB,EAClB,UAAkB,EAClB,KAAa,EACb,eAAuB,EACvB,aAA4B,EAC5B,WAAwB;IAExB,MAAM,QAAQ,GAAG,uBAAuB,CAAC,WAAW,CAAC,CAAC;IAEtD,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;SAClC,MAAM,CACL,IAAI,CAAC,SAAS,CAAC;QACb,eAAe;QACf,UAAU;QACV,UAAU;QACV,WAAW;QACX,KAAK;KACN,CAAC,CACH;SACA,MAAM,CAAC,KAAK,CAAC,CAAC;IACjB,MAAM,YAAY,GAAG,kCAAkC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtE,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC,eAAe,EAAE,WAAW,CAAC;SACtE,OAAO,CAAC,cAAc,EAAE,UAAU,CAAC;SACnC,OAAO,CAAC,cAAc,EAAE,UAAU,CAAC;SACnC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC;SACzB,OAAO,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC;IAEjD,MAAM,QAAQ,GAAc;QAC1B;YACE,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;SAC9B;KACF,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAC1C,aAAa,EACb;QACE,cAAc,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE;QAC3C,QAAQ;QACR,MAAM,EAAE,uBAAuB;QAC/B,WAAW;QACX,iBAAiB,EAAE,eAAe;QAClC,QAAQ;QACR,WAAW,EAAE,CAAC;KACf,EACD,wBAAwB,CACzB,CAAC;IAEF,IAAI,MAAM,EAAE,CAAC;QACX,kCAAkC,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,iCAAiC;IAC/C,kCAAkC,CAAC,KAAK,EAAE,CAAC;AAC7C,CAAC"}

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

@@ -0,0 +1,40 @@
+/**
+ * @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';
+import type { ExtensionLoader } from './extensionLoader.js';
+import type { Config } from '../config/config.js';
+export interface GeminiFileContent {
+    filePath: string;
+    content: string | null;
+}
+export declare function concatenateInstructions(instructionContents: GeminiFileContent[], currentWorkingDirectoryForDisplay: string): string;
+export interface MemoryLoadResult {
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+}
+export declare function loadGlobalMemory(debugMode?: boolean): Promise<MemoryLoadResult>;
+export declare function loadEnvironmentMemory(trustedRoots: string[], extensionLoader: ExtensionLoader, debugMode?: boolean): Promise<MemoryLoadResult>;
+export interface LoadServerHierarchicalMemoryResponse {
+    memoryContent: string;
+    fileCount: number;
+    filePaths: string[];
+}
+/**
+ * Loads hierarchical GEMINI.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, extensionLoader: ExtensionLoader, folderTrust: boolean, importFormat?: 'flat' | 'tree', fileFilteringOptions?: FileFilteringOptions, maxDirs?: number): Promise<LoadServerHierarchicalMemoryResponse>;
+/**
+ * Loads the hierarchical memory and resets the state of `config` as needed such
+ * that it reflects the new memory.
+ *
+ * Returns the result of the call to `loadHierarchicalGeminiMemory`.
+ */
+export declare function refreshServerHierarchicalMemory(config: Config): Promise<LoadServerHierarchicalMemoryResponse>;
+export declare function loadJitSubdirectoryMemory(targetPath: string, trustedRoots: string[], alreadyLoadedPaths: Set<string>, debugMode?: boolean): Promise<MemoryLoadResult>;