@hibanacloud/core 0.3.15

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

@@ -0,0 +1,419 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi, describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { MemoryTool, setGeminiMdFilename, getCurrentGeminiMdFilename, getAllGeminiMdFilenames, DEFAULT_CONTEXT_FILENAME, } from './memoryTool.js';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { ToolConfirmationOutcome } from './tools.js';
+import { ToolErrorType } from './tool-error.js';
+// Mock dependencies
+vi.mock(import('node:fs/promises'), async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        mkdir: vi.fn(),
+        readFile: vi.fn(),
+    };
+});
+vi.mock('fs', () => ({
+    mkdirSync: vi.fn(),
+}));
+vi.mock('os');
+const MEMORY_SECTION_HEADER = '## Qwen Added Memories';
+describe('MemoryTool', () => {
+    const mockAbortSignal = new AbortController().signal;
+    const mockFsAdapter = {
+        readFile: vi.fn(),
+        writeFile: vi.fn(),
+        mkdir: vi.fn(),
+    };
+    beforeEach(() => {
+        vi.mocked(os.homedir).mockReturnValue(path.join('/mock', 'home'));
+        mockFsAdapter.readFile.mockReset();
+        mockFsAdapter.writeFile.mockReset().mockResolvedValue(undefined);
+        mockFsAdapter.mkdir
+            .mockReset()
+            .mockResolvedValue(undefined);
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        // Reset GEMINI_MD_FILENAME to its original value after each test
+        setGeminiMdFilename(DEFAULT_CONTEXT_FILENAME);
+    });
+    describe('setGeminiMdFilename', () => {
+        it('should update currentGeminiMdFilename when a valid new name is provided', () => {
+            const newName = 'CUSTOM_CONTEXT.md';
+            setGeminiMdFilename(newName);
+            expect(getCurrentGeminiMdFilename()).toBe(newName);
+        });
+        it('should not update currentGeminiMdFilename if the new name is empty or whitespace', () => {
+            const initialName = getCurrentGeminiMdFilename(); // Get current before trying to change
+            setGeminiMdFilename('  ');
+            expect(getCurrentGeminiMdFilename()).toBe(initialName);
+            setGeminiMdFilename('');
+            expect(getCurrentGeminiMdFilename()).toBe(initialName);
+        });
+        it('should handle an array of filenames', () => {
+            const newNames = ['CUSTOM_CONTEXT.md', 'ANOTHER_CONTEXT.md'];
+            setGeminiMdFilename(newNames);
+            expect(getCurrentGeminiMdFilename()).toBe('CUSTOM_CONTEXT.md');
+            expect(getAllGeminiMdFilenames()).toEqual(newNames);
+        });
+    });
+    describe('performAddMemoryEntry (static method)', () => {
+        let testFilePath;
+        beforeEach(() => {
+            testFilePath = path.join(os.homedir(), '.qwen', DEFAULT_CONTEXT_FILENAME);
+        });
+        it('should create section and save a fact if file does not exist', async () => {
+            mockFsAdapter.readFile.mockRejectedValue({ code: 'ENOENT' }); // Simulate file not found
+            const fact = 'The sky is blue';
+            await MemoryTool.performAddMemoryEntry(fact, testFilePath, mockFsAdapter);
+            expect(mockFsAdapter.mkdir).toHaveBeenCalledWith(path.dirname(testFilePath), {
+                recursive: true,
+            });
+            expect(mockFsAdapter.writeFile).toHaveBeenCalledOnce();
+            const writeFileCall = mockFsAdapter.writeFile.mock.calls[0];
+            expect(writeFileCall[0]).toBe(testFilePath);
+            const expectedContent = `${MEMORY_SECTION_HEADER}\n- ${fact}\n`;
+            expect(writeFileCall[1]).toBe(expectedContent);
+            expect(writeFileCall[2]).toBe('utf-8');
+        });
+        it('should create section and save a fact if file is empty', async () => {
+            mockFsAdapter.readFile.mockResolvedValue(''); // Simulate empty file
+            const fact = 'The sky is blue';
+            await MemoryTool.performAddMemoryEntry(fact, testFilePath, mockFsAdapter);
+            const writeFileCall = mockFsAdapter.writeFile.mock.calls[0];
+            const expectedContent = `${MEMORY_SECTION_HEADER}\n- ${fact}\n`;
+            expect(writeFileCall[1]).toBe(expectedContent);
+        });
+        it('should add a fact to an existing section', async () => {
+            const initialContent = `Some preamble.\n\n${MEMORY_SECTION_HEADER}\n- Existing fact 1\n`;
+            mockFsAdapter.readFile.mockResolvedValue(initialContent);
+            const fact = 'New fact 2';
+            await MemoryTool.performAddMemoryEntry(fact, testFilePath, mockFsAdapter);
+            expect(mockFsAdapter.writeFile).toHaveBeenCalledOnce();
+            const writeFileCall = mockFsAdapter.writeFile.mock.calls[0];
+            const expectedContent = `Some preamble.\n\n${MEMORY_SECTION_HEADER}\n- Existing fact 1\n- ${fact}\n`;
+            expect(writeFileCall[1]).toBe(expectedContent);
+        });
+        it('should add a fact to an existing empty section', async () => {
+            const initialContent = `Some preamble.\n\n${MEMORY_SECTION_HEADER}\n`; // Empty section
+            mockFsAdapter.readFile.mockResolvedValue(initialContent);
+            const fact = 'First fact in section';
+            await MemoryTool.performAddMemoryEntry(fact, testFilePath, mockFsAdapter);
+            expect(mockFsAdapter.writeFile).toHaveBeenCalledOnce();
+            const writeFileCall = mockFsAdapter.writeFile.mock.calls[0];
+            const expectedContent = `Some preamble.\n\n${MEMORY_SECTION_HEADER}\n- ${fact}\n`;
+            expect(writeFileCall[1]).toBe(expectedContent);
+        });
+        it('should add a fact when other ## sections exist and preserve spacing', async () => {
+            const initialContent = `${MEMORY_SECTION_HEADER}\n- Fact 1\n\n## Another Section\nSome other text.`;
+            mockFsAdapter.readFile.mockResolvedValue(initialContent);
+            const fact = 'Fact 2';
+            await MemoryTool.performAddMemoryEntry(fact, testFilePath, mockFsAdapter);
+            expect(mockFsAdapter.writeFile).toHaveBeenCalledOnce();
+            const writeFileCall = mockFsAdapter.writeFile.mock.calls[0];
+            // Note: The implementation ensures a single newline at the end if content exists.
+            const expectedContent = `${MEMORY_SECTION_HEADER}\n- Fact 1\n- ${fact}\n\n## Another Section\nSome other text.\n`;
+            expect(writeFileCall[1]).toBe(expectedContent);
+        });
+        it('should correctly trim and add a fact that starts with a dash', async () => {
+            mockFsAdapter.readFile.mockResolvedValue(`${MEMORY_SECTION_HEADER}\n`);
+            const fact = '- - My fact with dashes';
+            await MemoryTool.performAddMemoryEntry(fact, testFilePath, mockFsAdapter);
+            const writeFileCall = mockFsAdapter.writeFile.mock.calls[0];
+            const expectedContent = `${MEMORY_SECTION_HEADER}\n- My fact with dashes\n`;
+            expect(writeFileCall[1]).toBe(expectedContent);
+        });
+        it('should handle error from fsAdapter.writeFile', async () => {
+            mockFsAdapter.readFile.mockResolvedValue('');
+            mockFsAdapter.writeFile.mockRejectedValue(new Error('Disk full'));
+            const fact = 'This will fail';
+            await expect(MemoryTool.performAddMemoryEntry(fact, testFilePath, mockFsAdapter)).rejects.toThrow('[MemoryTool] Failed to add memory entry: Disk full');
+        });
+    });
+    describe('execute (instance method)', () => {
+        let memoryTool;
+        let performAddMemoryEntrySpy;
+        beforeEach(() => {
+            memoryTool = new MemoryTool();
+            // Spy on the static method for these tests
+            performAddMemoryEntrySpy = vi
+                .spyOn(MemoryTool, 'performAddMemoryEntry')
+                .mockResolvedValue(undefined);
+            // Cast needed as spyOn returns MockInstance
+        });
+        it('should have correct name, displayName, description, and schema', () => {
+            expect(memoryTool.name).toBe('save_memory');
+            expect(memoryTool.displayName).toBe('SaveMemory');
+            expect(memoryTool.description).toContain('Saves a specific piece of information');
+            expect(memoryTool.schema).toBeDefined();
+            expect(memoryTool.schema.name).toBe('save_memory');
+            expect(memoryTool.schema.parametersJsonSchema).toBeDefined();
+        });
+        it('should call performAddMemoryEntry with correct parameters and return success for global scope', async () => {
+            const params = { fact: 'The sky is blue', scope: 'global' };
+            const invocation = memoryTool.build(params);
+            const result = await invocation.execute(mockAbortSignal);
+            // Use getCurrentGeminiMdFilename for the default expectation before any setGeminiMdFilename calls in a test
+            const expectedFilePath = path.join(os.homedir(), '.qwen', getCurrentGeminiMdFilename());
+            // For this test, we expect the actual fs methods to be passed
+            const expectedFsArgument = {
+                readFile: fs.readFile,
+                writeFile: fs.writeFile,
+                mkdir: fs.mkdir,
+            };
+            expect(performAddMemoryEntrySpy).toHaveBeenCalledWith(params.fact, expectedFilePath, expectedFsArgument);
+            const successMessage = `Okay, I've remembered that in global memory: "${params.fact}"`;
+            expect(result.llmContent).toBe(successMessage);
+            expect(result.returnDisplay).toBe(successMessage);
+        });
+        it('should call performAddMemoryEntry with correct parameters and return success for project scope', async () => {
+            const params = { fact: 'The sky is blue', scope: 'project' };
+            const invocation = memoryTool.build(params);
+            const result = await invocation.execute(mockAbortSignal);
+            // For project scope, expect the file to be in current working directory
+            const expectedFilePath = path.join(process.cwd(), getCurrentGeminiMdFilename());
+            // For this test, we expect the actual fs methods to be passed
+            const expectedFsArgument = {
+                readFile: fs.readFile,
+                writeFile: fs.writeFile,
+                mkdir: fs.mkdir,
+            };
+            expect(performAddMemoryEntrySpy).toHaveBeenCalledWith(params.fact, expectedFilePath, expectedFsArgument);
+            const successMessage = `Okay, I've remembered that in project memory: "${params.fact}"`;
+            expect(result.llmContent).toBe(successMessage);
+            expect(result.returnDisplay).toBe(successMessage);
+        });
+        it('should return an error if fact is empty', async () => {
+            const params = { fact: ' ' }; // Empty fact
+            expect(memoryTool.validateToolParams(params)).toBe('Parameter "fact" must be a non-empty string.');
+            expect(() => memoryTool.build(params)).toThrow('Parameter "fact" must be a non-empty string.');
+        });
+        it('should handle errors from performAddMemoryEntry', async () => {
+            const params = { fact: 'This will fail', scope: 'global' };
+            const underlyingError = new Error('[MemoryTool] Failed to add memory entry: Disk full');
+            performAddMemoryEntrySpy.mockRejectedValue(underlyingError);
+            const invocation = memoryTool.build(params);
+            const result = await invocation.execute(mockAbortSignal);
+            expect(result.llmContent).toBe(`Error saving memory: ${underlyingError.message}`);
+            expect(result.returnDisplay).toBe(`Error saving memory: ${underlyingError.message}`);
+            expect(result.error?.type).toBe(ToolErrorType.MEMORY_TOOL_EXECUTION_ERROR);
+        });
+        it('should return error when executing without scope parameter', async () => {
+            const params = { fact: 'Test fact' };
+            const invocation = memoryTool.build(params);
+            const result = await invocation.execute(mockAbortSignal);
+            expect(result.llmContent).toContain('Please specify where to save this memory');
+            expect(result.llmContent).toContain('Global:');
+            expect(result.llmContent).toContain('Project:');
+            expect(result.returnDisplay).toContain('Global:');
+            expect(result.returnDisplay).toContain('Project:');
+        });
+    });
+    describe('shouldConfirmExecute', () => {
+        let memoryTool;
+        beforeEach(() => {
+            memoryTool = new MemoryTool();
+            // Mock fs.readFile to return empty string (file doesn't exist)
+            vi.mocked(fs.readFile).mockResolvedValue('');
+            // Clear allowlist before each test to ensure clean state
+            const invocation = memoryTool.build({ fact: 'test', scope: 'global' });
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            invocation.constructor.allowlist.clear();
+        });
+        it('should return confirmation details when memory file is not allowlisted for global scope', async () => {
+            const params = { fact: 'Test fact', scope: 'global' };
+            const invocation = memoryTool.build(params);
+            const result = await invocation.shouldConfirmExecute(mockAbortSignal);
+            expect(result).toBeDefined();
+            expect(result).not.toBe(false);
+            if (result && result.type === 'edit') {
+                const expectedPath = path.join('~', '.qwen', 'QWEN.md');
+                expect(result.title).toBe(`Confirm Memory Save: ${expectedPath} (global)`);
+                expect(result.fileName).toContain(path.join('mock', 'home', '.qwen'));
+                expect(result.fileName).toContain('QWEN.md');
+                expect(result.fileDiff).toContain('Index: QWEN.md');
+                expect(result.fileDiff).toContain('+## Qwen Added Memories');
+                expect(result.fileDiff).toContain('+- Test fact');
+                expect(result.originalContent).toBe('');
+                expect(result.newContent).toContain('## Qwen Added Memories');
+                expect(result.newContent).toContain('- Test fact');
+            }
+        });
+        it('should return confirmation details when memory file is not allowlisted for project scope', async () => {
+            const params = { fact: 'Test fact', scope: 'project' };
+            const invocation = memoryTool.build(params);
+            const result = await invocation.shouldConfirmExecute(mockAbortSignal);
+            expect(result).toBeDefined();
+            expect(result).not.toBe(false);
+            if (result && result.type === 'edit') {
+                const expectedPath = path.join(process.cwd(), 'QWEN.md');
+                expect(result.title).toBe(`Confirm Memory Save: ${expectedPath} (project)`);
+                expect(result.fileName).toBe(expectedPath);
+                expect(result.fileDiff).toContain('Index: QWEN.md');
+                expect(result.fileDiff).toContain('+## Qwen Added Memories');
+                expect(result.fileDiff).toContain('+- Test fact');
+                expect(result.originalContent).toBe('');
+                expect(result.newContent).toContain('## Qwen Added Memories');
+                expect(result.newContent).toContain('- Test fact');
+            }
+        });
+        it('should return false when memory file is already allowlisted for global scope', async () => {
+            const params = { fact: 'Test fact', scope: 'global' };
+            const memoryFilePath = path.join(os.homedir(), '.qwen', getCurrentGeminiMdFilename());
+            const invocation = memoryTool.build(params);
+            // Add the memory file to the allowlist with the scope-specific key format
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            invocation.constructor.allowlist.add(`${memoryFilePath}_global`);
+            const result = await invocation.shouldConfirmExecute(mockAbortSignal);
+            expect(result).toBe(false);
+        });
+        it('should return false when memory file is already allowlisted for project scope', async () => {
+            const params = { fact: 'Test fact', scope: 'project' };
+            const memoryFilePath = path.join(process.cwd(), getCurrentGeminiMdFilename());
+            const invocation = memoryTool.build(params);
+            // Add the memory file to the allowlist with the scope-specific key format
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            invocation.constructor.allowlist.add(`${memoryFilePath}_project`);
+            const result = await invocation.shouldConfirmExecute(mockAbortSignal);
+            expect(result).toBe(false);
+        });
+        it('should add memory file to allowlist when ProceedAlways is confirmed for global scope', async () => {
+            const params = { fact: 'Test fact', scope: 'global' };
+            const memoryFilePath = path.join(os.homedir(), '.qwen', getCurrentGeminiMdFilename());
+            const invocation = memoryTool.build(params);
+            const result = await invocation.shouldConfirmExecute(mockAbortSignal);
+            expect(result).toBeDefined();
+            expect(result).not.toBe(false);
+            if (result && result.type === 'edit') {
+                // Simulate the onConfirm callback
+                await result.onConfirm(ToolConfirmationOutcome.ProceedAlways);
+                // Check that the memory file was added to the allowlist with the scope-specific key format
+                expect(
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                invocation.constructor.allowlist.has(`${memoryFilePath}_global`)).toBe(true);
+            }
+        });
+        it('should add memory file to allowlist when ProceedAlways is confirmed for project scope', async () => {
+            const params = { fact: 'Test fact', scope: 'project' };
+            const memoryFilePath = path.join(process.cwd(), getCurrentGeminiMdFilename());
+            const invocation = memoryTool.build(params);
+            const result = await invocation.shouldConfirmExecute(mockAbortSignal);
+            expect(result).toBeDefined();
+            expect(result).not.toBe(false);
+            if (result && result.type === 'edit') {
+                // Simulate the onConfirm callback
+                await result.onConfirm(ToolConfirmationOutcome.ProceedAlways);
+                // Check that the memory file was added to the allowlist with the scope-specific key format
+                expect(
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                invocation.constructor.allowlist.has(`${memoryFilePath}_project`)).toBe(true);
+            }
+        });
+        it('should not add memory file to allowlist when other outcomes are confirmed', async () => {
+            const params = { fact: 'Test fact', scope: 'global' };
+            const memoryFilePath = path.join(os.homedir(), '.qwen', getCurrentGeminiMdFilename());
+            const invocation = memoryTool.build(params);
+            const result = await invocation.shouldConfirmExecute(mockAbortSignal);
+            expect(result).toBeDefined();
+            expect(result).not.toBe(false);
+            if (result && result.type === 'edit') {
+                // Simulate the onConfirm callback with different outcomes
+                await result.onConfirm(ToolConfirmationOutcome.ProceedOnce);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const allowlist = invocation.constructor.allowlist;
+                expect(allowlist.has(`${memoryFilePath}_global`)).toBe(false);
+                await result.onConfirm(ToolConfirmationOutcome.Cancel);
+                expect(allowlist.has(`${memoryFilePath}_global`)).toBe(false);
+            }
+        });
+        it('should handle existing memory file with content for global scope', async () => {
+            const params = { fact: 'New fact', scope: 'global' };
+            const existingContent = 'Some existing content.\n\n## Qwen Added Memories\n- Old fact\n';
+            // Mock fs.readFile to return existing content
+            vi.mocked(fs.readFile).mockResolvedValue(existingContent);
+            const invocation = memoryTool.build(params);
+            const result = await invocation.shouldConfirmExecute(mockAbortSignal);
+            expect(result).toBeDefined();
+            expect(result).not.toBe(false);
+            if (result && result.type === 'edit') {
+                const expectedPath = path.join('~', '.qwen', 'QWEN.md');
+                expect(result.title).toBe(`Confirm Memory Save: ${expectedPath} (global)`);
+                expect(result.fileDiff).toContain('Index: QWEN.md');
+                expect(result.fileDiff).toContain('+- New fact');
+                expect(result.originalContent).toBe(existingContent);
+                expect(result.newContent).toContain('- Old fact');
+                expect(result.newContent).toContain('- New fact');
+            }
+        });
+        it('should prompt for scope selection when scope is not specified', async () => {
+            const params = { fact: 'Test fact' };
+            const invocation = memoryTool.build(params);
+            const result = await invocation.shouldConfirmExecute(mockAbortSignal);
+            expect(result).toBeDefined();
+            expect(result).not.toBe(false);
+            if (result && result.type === 'edit') {
+                expect(result.title).toContain('Choose Memory Location');
+                expect(result.title).toContain('GLOBAL');
+                expect(result.title).toContain('PROJECT');
+                expect(result.fileName).toBe('QWEN.md');
+                expect(result.fileDiff).toContain('Test fact');
+                expect(result.fileDiff).toContain('--- QWEN.md');
+                expect(result.fileDiff).toContain('+++ QWEN.md');
+                expect(result.fileDiff).toContain('+- Test fact');
+                expect(result.originalContent).toContain('scope: global');
+                expect(result.originalContent).toContain('INSTRUCTIONS:');
+            }
+        });
+        it('should show correct file paths in scope selection prompt', async () => {
+            const params = { fact: 'Test fact' };
+            const invocation = memoryTool.build(params);
+            const result = await invocation.shouldConfirmExecute(mockAbortSignal);
+            expect(result).toBeDefined();
+            expect(result).not.toBe(false);
+            if (result && result.type === 'edit') {
+                const globalPath = path.join('~', '.qwen', 'QWEN.md');
+                const projectPath = path.join(process.cwd(), 'QWEN.md');
+                expect(result.fileDiff).toContain(`Global: ${globalPath}`);
+                expect(result.fileDiff).toContain(`Project: ${projectPath}`);
+                expect(result.fileDiff).toContain('(shared across all projects)');
+                expect(result.fileDiff).toContain('(current project only)');
+            }
+        });
+    });
+    describe('getDescription', () => {
+        let memoryTool;
+        beforeEach(() => {
+            memoryTool = new MemoryTool();
+        });
+        it('should return correct description for global scope', () => {
+            const params = { fact: 'Test fact', scope: 'global' };
+            const invocation = memoryTool.build(params);
+            const description = invocation.getDescription();
+            const expectedPath = path.join('~', '.qwen', 'QWEN.md');
+            expect(description).toBe(`${expectedPath} (global)`);
+        });
+        it('should return correct description for project scope', () => {
+            const params = { fact: 'Test fact', scope: 'project' };
+            const invocation = memoryTool.build(params);
+            const description = invocation.getDescription();
+            const expectedPath = path.join(process.cwd(), 'QWEN.md');
+            expect(description).toBe(`${expectedPath} (project)`);
+        });
+        it('should show choice prompt when scope is not specified', () => {
+            const params = { fact: 'Test fact' };
+            const invocation = memoryTool.build(params);
+            const description = invocation.getDescription();
+            const globalPath = path.join('~', '.qwen', 'QWEN.md');
+            const projectPath = path.join(process.cwd(), 'QWEN.md');
+            expect(description).toBe(`CHOOSE: ${globalPath} (global) OR ${projectPath} (project)`);
+        });
+    });
+});
+//# sourceMappingURL=memoryTool.test.js.map

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

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

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

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { EditorType } from '../utils/editor.js';
+import type { AnyDeclarativeTool, DeclarativeTool, 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;
+}
+/**
+ * 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): Promise<ModifyResult<ToolParams>>;

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

@@ -0,0 +1,88 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { openDiff } from '../utils/editor.js';
+import os from 'node:os';
+import path from 'node:path';
+import fs from 'node:fs';
+import * as Diff from 'diff';
+import { DEFAULT_DIFF_OPTIONS } from './diffOptions.js';
+import { isNodeError } from '../utils/errors.js';
+/**
+ * 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 tempDir = os.tmpdir();
+    const diffDir = path.join(tempDir, 'qwen-code-tool-modify-diffs');
+    if (!fs.existsSync(diffDir)) {
+        fs.mkdirSync(diffDir, { recursive: true });
+    }
+    const ext = path.extname(file_path);
+    const fileName = path.basename(file_path, ext);
+    const timestamp = Date.now();
+    const tempOldPath = path.join(diffDir, `qwen-code-modify-${fileName}-old-${timestamp}${ext}`);
+    const tempNewPath = path.join(diffDir, `qwen-code-modify-${fileName}-new-${timestamp}${ext}`);
+    fs.writeFileSync(tempOldPath, currentContent, 'utf8');
+    fs.writeFileSync(tempNewPath, proposedContent, 'utf8');
+    return { oldPath: tempOldPath, newPath: tempNewPath };
+}
+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_DIFF_OPTIONS);
+    return { updatedParams, updatedDiff };
+}
+function deleteTempFiles(oldPath, newPath) {
+    try {
+        fs.unlinkSync(oldPath);
+    }
+    catch {
+        console.error(`Error deleting temp diff file: ${oldPath}`);
+    }
+    try {
+        fs.unlinkSync(newPath);
+    }
+    catch {
+        console.error(`Error deleting temp diff file: ${newPath}`);
+    }
+}
+/**
+ * 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) {
+    const currentContent = await modifyContext.getCurrentContent(originalParams);
+    const proposedContent = await modifyContext.getProposedContent(originalParams);
+    const { oldPath, newPath } = createTempFilesForModify(currentContent, proposedContent, modifyContext.getFilePath(originalParams));
+    try {
+        await openDiff(oldPath, newPath, editorType, onEditorClose);
+        const result = getUpdatedParams(oldPath, newPath, originalParams, modifyContext);
+        return result;
+    }
+    finally {
+        deleteTempFiles(oldPath, newPath);
+    }
+}
+//# 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":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAkCjD;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,IAAwB;IAExB,OAAO,kBAAkB,IAAI,IAAI,CAAC;AACpC,CAAC;AAED,SAAS,wBAAwB,CAC/B,cAAsB,EACtB,eAAuB,EACvB,SAAiB;IAEjB,MAAM,OAAO,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,6BAA6B,CAAC,CAAC;IAElE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAC3B,OAAO,EACP,oBAAoB,QAAQ,QAAQ,SAAS,GAAG,GAAG,EAAE,CACtD,CAAC;IACF,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAC3B,OAAO,EACP,oBAAoB,QAAQ,QAAQ,SAAS,GAAG,GAAG,EAAE,CACtD,CAAC;IAEF,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IACtD,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;IAEvD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AACxD,CAAC;AAED,SAAS,gBAAgB,CACvB,UAAkB,EAClB,WAAmB,EACnB,cAA0B,EAC1B,aAAwC;IAExC,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,IAAI,UAAU,GAAG,EAAE,CAAC;IAEpB,IAAI,CAAC;QACH,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,GAAG,CAAC;QAC1D,UAAU,GAAG,EAAE,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,GAAG,CAAC;QAC1D,UAAU,GAAG,EAAE,CAAC;IAClB,CAAC;IAED,MAAM,aAAa,GAAG,aAAa,CAAC,mBAAmB,CACrD,UAAU,EACV,UAAU,EACV,cAAc,CACf,CAAC;IACF,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAClC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,EACxD,UAAU,EACV,UAAU,EACV,SAAS,EACT,UAAU,EACV,oBAAoB,CACrB,CAAC;IAEF,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC;AACxC,CAAC;AAED,SAAS,eAAe,CAAC,OAAe,EAAE,OAAe;IACvD,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,KAAK,CAAC,kCAAkC,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,KAAK,CAAC,kCAAkC,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,cAA0B,EAC1B,aAAwC,EACxC,UAAsB,EACtB,YAAyB,EACzB,aAAyB;IAEzB,MAAM,cAAc,GAAG,MAAM,aAAa,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAC7E,MAAM,eAAe,GACnB,MAAM,aAAa,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;IAEzD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,wBAAwB,CACnD,cAAc,EACd,eAAe,EACf,aAAa,CAAC,WAAW,CAAC,cAAc,CAAC,CAC1C,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,gBAAgB,CAC7B,OAAO,EACP,OAAO,EACP,cAAc,EACd,aAAa,CACd,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;AACH,CAAC"}

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

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