@vybestack/llxprt-code-tools 0.10.0-nightly.260613.1adad3b34

package/dist/src/tools/memoryTool.js

@@ -0,0 +1,435 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, Kind, ToolConfirmationOutcome, } from './tools.js';
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import process from 'node:process';
+import * as Diff from 'diff';
+import { DEFAULT_CREATE_PATCH_OPTIONS } from '../utils/diffOptions.js';
+import { shortenPath } from '../utils/paths.js';
+import { ToolErrorType } from '../types/tool-error.js';
+import { debugLogger as logger } from '../utils/debugLogger.js';
+function tildeifyPath(filePath) {
+    const homeDir = os.homedir();
+    if (homeDir &&
+        (filePath === homeDir || filePath.startsWith(`${homeDir}${path.sep}`))) {
+        return `~${filePath.slice(homeDir.length)}`;
+    }
+    return shortenPath(filePath);
+}
+const memoryToolSchemaData = {
+    name: 'save_memory',
+    description: 'Saves a specific piece of information or fact to your long-term memory. Use this when the user explicitly asks you to remember something, or when they state a clear, concise fact that seems important to retain for future interactions.',
+    parametersJsonSchema: {
+        type: 'object',
+        properties: {
+            fact: {
+                type: 'string',
+                description: 'The specific fact or piece of information to remember. Should be a clear, self-contained statement.',
+            },
+            scope: {
+                type: 'string',
+                enum: ['global', 'project', 'core.global', 'core.project'],
+                description: 'Where to save the memory: "global" or "project" (default, saves to project-local .llxprt directory). ' +
+                    '"core.global" and "core.project" save to the system prompt (.LLXPRT_SYSTEM) — requires model.canSaveCore to be enabled.',
+                default: 'project',
+            },
+        },
+        required: ['fact'],
+    },
+};
+const memoryToolDescription = `
+Saves a specific piece of information or fact to your long-term memory.
+
+Use this tool:
+
+- When the user explicitly asks you to remember something (e.g., "Remember that I like pineapple on pizza", "Please save this: my cat's name is Whiskers").
+- When the user states a clear, concise fact about themselves, their preferences, or their environment that seems important for you to retain for future interactions to provide a more personalized and effective assistance.
+
+Do NOT use this tool:
+
+- To remember conversational context that is only relevant for the current session.
+- To save long, complex, or rambling pieces of text. The fact should be relatively short and to the point.
+- If you are unsure whether the information is a fact worth remembering long-term. If in doubt, you can ask the user, "Should I remember that for you?"
+
+## Parameters
+
+- \`fact\` (string, required): The specific fact or piece of information to remember. This should be a clear, self-contained statement. For example, if the user says "My favorite color is blue", the fact would be "My favorite color is blue".
+- \`scope\` (string, optional): Where to save the memory. Defaults to "project".
+  - \`"global"\` — saved to the global LLXPRT.md file.
+  - \`"project"\` — saved to the project-local .llxprt/LLXPRT.md file.
+  - \`"core.global"\` — saved to the global system prompt (.LLXPRT_SYSTEM). Requires \`model.canSaveCore\` to be enabled.
+  - \`"core.project"\` — saved to the project system prompt (.LLXPRT_SYSTEM). Requires \`model.canSaveCore\` to be enabled.
+`;
+export const LLXPRT_CONFIG_DIR = '.llxprt';
+// Alias for backward compatibility with gemini-cli code
+export const GEMINI_DIR = LLXPRT_CONFIG_DIR;
+export const DEFAULT_CONTEXT_FILENAME = 'LLXPRT.md';
+export const CORE_MEMORY_FILENAME = '.LLXPRT_SYSTEM';
+export const MEMORY_SECTION_HEADER = '## LLxprt Code Added Memories';
+// This variable will hold the currently configured filename for LLXPRT.md context files.
+// It defaults to DEFAULT_CONTEXT_FILENAME but can be overridden by setLlxprtMdFilename.
+let currentLlxprtMdFilename = DEFAULT_CONTEXT_FILENAME;
+export function setLlxprtMdFilename(newFilename) {
+    if (Array.isArray(newFilename)) {
+        if (newFilename.length > 0) {
+            currentLlxprtMdFilename = newFilename.map((name) => name.trim());
+        }
+    }
+    else if (newFilename && newFilename.trim() !== '') {
+        currentLlxprtMdFilename = newFilename.trim();
+    }
+}
+export function getCurrentLlxprtMdFilename() {
+    if (Array.isArray(currentLlxprtMdFilename)) {
+        return currentLlxprtMdFilename[0];
+    }
+    return currentLlxprtMdFilename;
+}
+export function getAllLlxprtMdFilenames() {
+    if (Array.isArray(currentLlxprtMdFilename)) {
+        return currentLlxprtMdFilename;
+    }
+    return [currentLlxprtMdFilename];
+}
+function isCoreScope(scope) {
+    return scope === 'core.global' || scope === 'core.project';
+}
+function getDefaultGlobalLlxprtDir() {
+    const homeDir = os.homedir();
+    if (!homeDir) {
+        return path.join(os.tmpdir(), LLXPRT_CONFIG_DIR);
+    }
+    return path.join(homeDir, LLXPRT_CONFIG_DIR);
+}
+function getGlobalMemoryFilePath(storageService) {
+    return path.join(storageService.getLLXPRTDir(), getCurrentLlxprtMdFilename());
+}
+function getProjectMemoryFilePath(workingDir) {
+    return path.join(workingDir, LLXPRT_CONFIG_DIR, getCurrentLlxprtMdFilename());
+}
+export function getGlobalCoreMemoryFilePath(storageService) {
+    return path.join(storageService?.getLLXPRTDir() ?? getDefaultGlobalLlxprtDir(), CORE_MEMORY_FILENAME);
+}
+export function getProjectCoreMemoryFilePath(workingDir) {
+    return path.join(workingDir, LLXPRT_CONFIG_DIR, CORE_MEMORY_FILENAME);
+}
+/**
+ * Ensures proper newline separation before appending content.
+ */
+function ensureNewlineSeparation(currentContent) {
+    if (currentContent.length === 0)
+        return '';
+    if (currentContent.endsWith('\n\n') || currentContent.endsWith('\r\n\r\n'))
+        return '';
+    if (currentContent.endsWith('\n') || currentContent.endsWith('\r\n'))
+        return '\n';
+    return '\n\n';
+}
+/**
+ * Computes the new content that would result from adding a memory entry
+ */
+function computeNewContent(currentContent, fact) {
+    let processedText = fact.trim();
+    // eslint-disable-next-line sonarjs/regular-expr -- Static regex reviewed for lint hardening; behavior preserved.
+    processedText = processedText.replace(/^(-+\s*)+/, '').trim();
+    const newMemoryItem = `- ${processedText}`;
+    const headerIndex = currentContent.indexOf(MEMORY_SECTION_HEADER);
+    if (headerIndex === -1) {
+        // Header not found, append header and then the entry
+        const separator = ensureNewlineSeparation(currentContent);
+        return (currentContent +
+            `${separator}${MEMORY_SECTION_HEADER}\n${newMemoryItem}\n`);
+    }
+    // Header found, find where to insert the new memory entry
+    const startOfSectionContent = headerIndex + MEMORY_SECTION_HEADER.length;
+    let endOfSectionIndex = currentContent.indexOf('\n## ', startOfSectionContent);
+    if (endOfSectionIndex === -1) {
+        endOfSectionIndex = currentContent.length; // End of file
+    }
+    const beforeSectionMarker = currentContent
+        .substring(0, startOfSectionContent)
+        .trimEnd();
+    let sectionContent = currentContent
+        .substring(startOfSectionContent, endOfSectionIndex)
+        .trimEnd();
+    const afterSectionMarker = currentContent.substring(endOfSectionIndex);
+    sectionContent += `\n${newMemoryItem}`;
+    return (`${beforeSectionMarker}\n${sectionContent.trimStart()}\n${afterSectionMarker}`.trimEnd() +
+        '\n');
+}
+class MemoryToolInvocation extends BaseToolInvocation {
+    storageService;
+    getWorkingDir;
+    static allowlist = new Set();
+    constructor(params, messageBus, storageService, getWorkingDir) {
+        super(params, messageBus);
+        this.storageService = storageService;
+        this.getWorkingDir = getWorkingDir;
+    }
+    setWorkingDir(workingDir) {
+        this.getWorkingDir = () => workingDir;
+    }
+    resolveWorkingDir() {
+        return this.getWorkingDir?.();
+    }
+    getMemoryFilePath() {
+        // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: scope is optional string, empty string should fall through to default
+        const scope = this.params.scope || 'project';
+        const workingDir = this.resolveWorkingDir();
+        switch (scope) {
+            case 'core.project':
+                // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: workingDir is optional string, empty string should fall through to cwd
+                return getProjectCoreMemoryFilePath(workingDir || process.cwd());
+            case 'core.global':
+                return getGlobalCoreMemoryFilePath(this.storageService);
+            case 'project':
+                if (workingDir) {
+                    return getProjectMemoryFilePath(workingDir);
+                }
+                return getGlobalMemoryFilePath(this.storageService);
+            case 'global':
+            default:
+                return getGlobalMemoryFilePath(this.storageService);
+        }
+    }
+    async readMemoryFileContent() {
+        try {
+            return await this.storageService.readFile(this.getMemoryFilePath());
+        }
+        catch (err) {
+            const error = err;
+            if (!(error instanceof Error) || error.code !== 'ENOENT')
+                throw err;
+            return '';
+        }
+    }
+    getToolName() {
+        return MemoryTool.Name;
+    }
+    getDescription() {
+        const memoryFilePath = this.getMemoryFilePath();
+        return `in ${tildeifyPath(memoryFilePath)}`;
+    }
+    async shouldConfirmExecute(_abortSignal) {
+        const memoryFilePath = this.getMemoryFilePath();
+        const allowlistKey = memoryFilePath;
+        if (MemoryToolInvocation.allowlist.has(allowlistKey)) {
+            return false;
+        }
+        const currentContent = await this.readMemoryFileContent();
+        const fact = this.params.fact ?? this.params.content ?? '';
+        const newContent = computeNewContent(currentContent, fact);
+        const fileName = path.basename(memoryFilePath);
+        const fileDiff = Diff.createPatch(fileName, currentContent, newContent, 'Current', 'Proposed', DEFAULT_CREATE_PATCH_OPTIONS);
+        const confirmationDetails = {
+            type: 'edit',
+            title: `Confirm Memory Save: ${tildeifyPath(memoryFilePath)}`,
+            fileName: memoryFilePath,
+            filePath: memoryFilePath,
+            fileDiff,
+            originalContent: currentContent,
+            newContent,
+            onConfirm: async (outcome) => {
+                if (outcome === ToolConfirmationOutcome.ProceedAlways) {
+                    MemoryToolInvocation.allowlist.add(allowlistKey);
+                }
+                await this.publishPolicyUpdate(outcome);
+            },
+        };
+        return confirmationDetails;
+    }
+    async execute(_signal) {
+        const { modified_by_user, modified_content } = this.params;
+        const fact = this.params.fact ?? this.params.content ?? '';
+        if (this.params.read === true) {
+            const content = await this.readMemoryFileContent();
+            return {
+                llmContent: content,
+                returnDisplay: content,
+            };
+        }
+        const memoryFilePath = this.getMemoryFilePath();
+        try {
+            if (modified_by_user === true && modified_content !== undefined) {
+                // User modified the content in external editor, write it directly
+                await this.storageService.ensureDir(path.dirname(memoryFilePath));
+                await this.storageService.writeFile(memoryFilePath, modified_content);
+                const successMessage = `Okay, I've updated the memory file with your modifications.`;
+                return {
+                    llmContent: JSON.stringify({
+                        success: true,
+                        message: successMessage,
+                    }),
+                    returnDisplay: successMessage,
+                };
+            }
+            // Use the normal memory entry logic
+            await MemoryTool.performAddMemoryEntry(fact, memoryFilePath, {
+                readFile: (filePath) => this.storageService.readFile(filePath),
+                writeFile: (filePath, data) => this.storageService.writeFile(filePath, data),
+                mkdir: async (dirPath) => {
+                    await this.storageService.ensureDir(dirPath);
+                    return undefined;
+                },
+            });
+            const successMessage = `Okay, I've remembered that: "${fact}"`;
+            return {
+                llmContent: JSON.stringify({
+                    success: true,
+                    message: successMessage,
+                }),
+                returnDisplay: successMessage,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error(`Error executing save_memory for fact "${fact}": ${errorMessage}`);
+            return {
+                llmContent: JSON.stringify({
+                    success: false,
+                    error: `Failed to save memory. Detail: ${errorMessage}`,
+                }),
+                returnDisplay: `Error saving memory: ${errorMessage}`,
+                error: {
+                    message: errorMessage,
+                    type: ToolErrorType.MEMORY_TOOL_EXECUTION_ERROR,
+                },
+            };
+        }
+    }
+}
+export class MemoryTool extends BaseDeclarativeTool {
+    static Name = memoryToolSchemaData.name;
+    storageService;
+    settingsService;
+    getWorkingDir;
+    constructor(dependencies = {
+        storageService: {
+            getLLXPRTDir: getDefaultGlobalLlxprtDir,
+            readFile: (filePath) => fs.readFile(filePath, 'utf-8'),
+            writeFile: (filePath, content) => fs.writeFile(filePath, content, 'utf-8'),
+            ensureDir: (dirPath) => fs.mkdir(dirPath, { recursive: true }).then(() => undefined),
+        },
+    }) {
+        const resolvedDependencies = 'storageService' in dependencies
+            ? dependencies
+            : { storageService: dependencies };
+        super(MemoryTool.Name, 'SaveMemory', memoryToolDescription, Kind.Think, memoryToolSchemaData.parametersJsonSchema, false, // output is not markdown
+        false, // output cannot be updated
+        resolvedDependencies.messageBus);
+        this.storageService = resolvedDependencies.storageService;
+        this.settingsService = resolvedDependencies.settingsService;
+        this.getWorkingDir = resolvedDependencies.getWorkingDir;
+    }
+    validateToolParamValues(params) {
+        if (params.read !== true &&
+            (params.fact ?? params.content ?? '').trim() === '') {
+            return 'Parameter "fact" must be a non-empty string.';
+        }
+        // Core scopes require model.canSaveCore to be enabled
+        if (isCoreScope(params.scope)) {
+            try {
+                const canSaveCore = this.settingsService?.getSetting('model.canSaveCore');
+                if (canSaveCore !== true) {
+                    return ('Core memory scopes (core.global, core.project) are disabled. ' +
+                        'Enable them with: /set model.canSaveCore true\n' +
+                        'WARNING: This allows the model to modify your system directives.');
+                }
+            }
+            catch {
+                return 'Core memory scopes require model.canSaveCore to be enabled.';
+            }
+        }
+        return null;
+    }
+    createInvocation(params, messageBus) {
+        return new MemoryToolInvocation(params, messageBus, this.storageService, this.getWorkingDir);
+    }
+    async execute(params) {
+        const invocation = this.build({
+            ...params,
+            fact: params.fact ?? params.content ?? '',
+        });
+        return invocation.execute(new AbortController().signal);
+    }
+    static async performAddMemoryEntry(text, memoryFilePath, fsAdapter) {
+        try {
+            await fsAdapter.mkdir(path.dirname(memoryFilePath), { recursive: true });
+            let currentContent = '';
+            try {
+                currentContent = await fsAdapter.readFile(memoryFilePath, 'utf-8');
+            }
+            catch {
+                // File doesn't exist - currentContent remains empty
+            }
+            const newContent = computeNewContent(currentContent, text);
+            await fsAdapter.writeFile(memoryFilePath, newContent, 'utf-8');
+        }
+        catch (error) {
+            logger.error(`Error adding memory entry to ${memoryFilePath}: ${error instanceof Error ? error.message : String(error)}`);
+            throw new Error(`[MemoryTool] Failed to add memory entry: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    getModifyContext(_abortSignal) {
+        const resolvePath = (scope) => {
+            // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: scope is optional string, empty string should fall through to default
+            const resolvedScope = scope || 'project';
+            const workingDir = this.getWorkingDir?.();
+            switch (resolvedScope) {
+                case 'core.project':
+                    return getProjectCoreMemoryFilePath(
+                    // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: getWorkingDir returns string | undefined, empty string should fall through to cwd
+                    workingDir || process.cwd());
+                case 'core.global':
+                    return getGlobalCoreMemoryFilePath(this.storageService);
+                case 'project':
+                    if (workingDir) {
+                        return getProjectMemoryFilePath(workingDir);
+                    }
+                    return getGlobalMemoryFilePath(this.storageService);
+                case 'global':
+                default:
+                    return getGlobalMemoryFilePath(this.storageService);
+            }
+        };
+        return {
+            getFilePath: (params) => resolvePath(params.scope),
+            getCurrentContent: async (params) => {
+                const memoryFilePath = resolvePath(params.scope);
+                try {
+                    return await this.storageService.readFile(memoryFilePath);
+                }
+                catch (err) {
+                    const error = err;
+                    if (!(error instanceof Error) || error.code !== 'ENOENT')
+                        throw err;
+                    return '';
+                }
+            },
+            getProposedContent: async (params) => {
+                const memoryFilePath = resolvePath(params.scope);
+                try {
+                    const currentContent = await this.storageService.readFile(memoryFilePath);
+                    return computeNewContent(currentContent, params.fact ?? params.content ?? '');
+                }
+                catch (err) {
+                    const error = err;
+                    if (!(error instanceof Error) || error.code !== 'ENOENT')
+                        throw err;
+                    return computeNewContent('', params.fact ?? params.content ?? '');
+                }
+            },
+            createUpdatedParams: (_oldContent, modifiedProposedContent, originalParams) => ({
+                ...originalParams,
+                modified_by_user: true,
+                modified_content: modifiedProposedContent,
+            }),
+        };
+    }
+}
+//# sourceMappingURL=memoryTool.js.map

package/dist/src/tools/memoryTool.js.map

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

package/dist/src/tools/modifiable-tool.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type EditorType } from '../utils/editor.js';
+import type { DeclarativeTool } from './tools.js';
+import { type AnyDeclarativeTool, type ToolResult } from './tools.js';
+/**
+ * A declarative tool that supports a modify operation.
+ */
+export interface ModifiableDeclarativeTool<TParams extends object> extends DeclarativeTool<TParams, ToolResult> {
+    getModifyContext(abortSignal: AbortSignal): ModifyContext<TParams>;
+}
+export interface ModifyContext<ToolParams> {
+    getFilePath: (params: ToolParams) => string;
+    getCurrentContent: (params: ToolParams) => Promise<string>;
+    getProposedContent: (params: ToolParams) => Promise<string>;
+    createUpdatedParams: (oldContent: string, modifiedProposedContent: string, originalParams: ToolParams) => ToolParams;
+}
+export interface ModifyResult<ToolParams> {
+    updatedParams: ToolParams;
+    updatedDiff: string;
+}
+export interface ModifyContentOverrides {
+    currentContent?: string | null;
+    proposedContent?: string;
+}
+/**
+ * Type guard to check if a declarative tool is modifiable.
+ */
+export declare function isModifiableDeclarativeTool(tool: AnyDeclarativeTool): tool is ModifiableDeclarativeTool<object>;
+/**
+ * Triggers an external editor for the user to modify the proposed content,
+ * and returns the updated tool parameters and the diff after the user has modified the proposed content.
+ */
+export declare function modifyWithEditor<ToolParams>(originalParams: ToolParams, modifyContext: ModifyContext<ToolParams>, editorType: EditorType, _abortSignal: AbortSignal, onEditorClose: () => void, onEditorOpen?: () => void, overrides?: ModifyContentOverrides): Promise<ModifyResult<ToolParams>>;

package/dist/src/tools/modifiable-tool.js

@@ -0,0 +1,120 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { openDiff } from '../utils/editor.js';
+import os from 'os';
+import path from 'path';
+import fs from 'fs';
+import * as Diff from 'diff';
+import { DEFAULT_CREATE_PATCH_OPTIONS } from '../utils/diffOptions.js';
+import { isNodeError } from '../utils/errors.js';
+const debugLogger = {
+    error: (..._args) => { },
+};
+/**
+ * Type guard to check if a declarative tool is modifiable.
+ */
+export function isModifiableDeclarativeTool(tool) {
+    return 'getModifyContext' in tool;
+}
+function createTempFilesForModify(currentContent, proposedContent, file_path) {
+    const diffDir = fs.mkdtempSync(path.join(os.tmpdir(), 'gemini-cli-tool-modify-'));
+    try {
+        fs.chmodSync(diffDir, 0o700);
+    }
+    catch (e) {
+        debugLogger.error(`Error setting permissions on temp diff directory: ${diffDir}`, e);
+        throw e;
+    }
+    const ext = path.extname(file_path);
+    const fileName = path.basename(file_path, ext);
+    const timestamp = Date.now();
+    const tempOldPath = path.join(diffDir, `gemini-cli-modify-${fileName}-old-${timestamp}${ext}`);
+    const tempNewPath = path.join(diffDir, `gemini-cli-modify-${fileName}-new-${timestamp}${ext}`);
+    fs.writeFileSync(tempOldPath, currentContent, {
+        encoding: 'utf8',
+        mode: 0o600,
+    });
+    fs.writeFileSync(tempNewPath, proposedContent, {
+        encoding: 'utf8',
+        mode: 0o600,
+    });
+    return { oldPath: tempOldPath, newPath: tempNewPath, dirPath: diffDir };
+}
+function getUpdatedParams(tmpOldPath, tempNewPath, originalParams, modifyContext) {
+    let oldContent = '';
+    let newContent = '';
+    try {
+        oldContent = fs.readFileSync(tmpOldPath, 'utf8');
+    }
+    catch (err) {
+        if (!isNodeError(err) || err.code !== 'ENOENT')
+            throw err;
+        oldContent = '';
+    }
+    try {
+        newContent = fs.readFileSync(tempNewPath, 'utf8');
+    }
+    catch (err) {
+        if (!isNodeError(err) || err.code !== 'ENOENT')
+            throw err;
+        newContent = '';
+    }
+    const updatedParams = modifyContext.createUpdatedParams(oldContent, newContent, originalParams);
+    const updatedDiff = Diff.createPatch(path.basename(modifyContext.getFilePath(originalParams)), oldContent, newContent, 'Current', 'Proposed', DEFAULT_CREATE_PATCH_OPTIONS);
+    return { updatedParams, updatedDiff };
+}
+function deleteTempFiles(oldPath, newPath, dirPath) {
+    try {
+        fs.unlinkSync(oldPath);
+    }
+    catch {
+        debugLogger.error(`Error deleting temp diff file: ${oldPath}`);
+    }
+    try {
+        fs.unlinkSync(newPath);
+    }
+    catch {
+        debugLogger.error(`Error deleting temp diff file: ${newPath}`);
+    }
+    try {
+        fs.rmdirSync(dirPath);
+    }
+    catch {
+        debugLogger.error(`Error deleting temp diff directory: ${dirPath}`);
+    }
+}
+/**
+ * Triggers an external editor for the user to modify the proposed content,
+ * and returns the updated tool parameters and the diff after the user has modified the proposed content.
+ */
+export async function modifyWithEditor(originalParams, modifyContext, editorType, _abortSignal, onEditorClose, onEditorOpen, overrides) {
+    const hasCurrentOverride = overrides !== undefined && 'currentContent' in overrides;
+    const hasProposedOverride = overrides !== undefined && 'proposedContent' in overrides;
+    const currentContent = hasCurrentOverride
+        ? (overrides.currentContent ?? '')
+        : await modifyContext.getCurrentContent(originalParams);
+    const proposedContent = hasProposedOverride
+        ? (overrides.proposedContent ?? '')
+        : await modifyContext.getProposedContent(originalParams);
+    const { oldPath, newPath, dirPath } = createTempFilesForModify(currentContent, proposedContent, modifyContext.getFilePath(originalParams));
+    try {
+        if (onEditorOpen) {
+            try {
+                onEditorOpen();
+            }
+            catch (error) {
+                debugLogger.error('Error in onEditorOpen callback:', error);
+            }
+        }
+        await openDiff(oldPath, newPath, editorType, onEditorClose);
+        const result = getUpdatedParams(oldPath, newPath, originalParams, modifyContext);
+        return result;
+    }
+    finally {
+        deleteTempFiles(oldPath, newPath, dirPath);
+    }
+}
+//# sourceMappingURL=modifiable-tool.js.map

package/dist/src/tools/modifiable-tool.js.map

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