@google/gemini-cli-core 0.0.3-preview.4

package/dist/src/test-utils/mockWorkspaceContext.js

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi } from 'vitest';
+/**
+ * Creates a mock WorkspaceContext for testing
+ * @param rootDir The root directory to use for the mock
+ * @param additionalDirs Optional additional directories to include in the workspace
+ * @returns A mock WorkspaceContext instance
+ */
+export function createMockWorkspaceContext(rootDir, additionalDirs = []) {
+    const allDirs = [rootDir, ...additionalDirs];
+    const mockWorkspaceContext = {
+        addDirectory: vi.fn(),
+        getDirectories: vi.fn().mockReturnValue(allDirs),
+        isPathWithinWorkspace: vi
+            .fn()
+            .mockImplementation((path) => allDirs.some((dir) => path.startsWith(dir))),
+    };
+    return mockWorkspaceContext;
+}
+//# sourceMappingURL=mockWorkspaceContext.js.map

package/dist/src/test-utils/mockWorkspaceContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockWorkspaceContext.js","sourceRoot":"","sources":["../../../src/test-utils/mockWorkspaceContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAG5B;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAe,EACf,iBAA2B,EAAE;IAE7B,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE,GAAG,cAAc,CAAC,CAAC;IAE7C,MAAM,oBAAoB,GAAG;QAC3B,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;QACrB,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC;QAChD,qBAAqB,EAAE,EAAE;aACtB,EAAE,EAAE;aACJ,kBAAkB,CAAC,CAAC,IAAY,EAAE,EAAE,CACnC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAC5C;KAC2B,CAAC;IAEjC,OAAO,oBAAoB,CAAC;AAC9B,CAAC"}

package/dist/src/test-utils/tools.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ToolCallConfirmationDetails, ToolInvocation, ToolResult } from '../tools/tools.js';
+import { BaseDeclarativeTool, BaseToolInvocation } from '../tools/tools.js';
+import type { ModifiableDeclarativeTool, ModifyContext } from '../tools/modifiable-tool.js';
+/**
+ * A highly configurable mock tool for testing purposes.
+ */
+export declare class MockTool extends BaseDeclarativeTool<{
+    [key: string]: unknown;
+}, ToolResult> {
+    executeFn: import("vitest").Mock<(...args: any[]) => any>;
+    shouldConfirm: boolean;
+    constructor(name?: string, displayName?: string, description?: string, params?: {
+        type: string;
+        properties: {
+            param: {
+                type: string;
+            };
+        };
+    });
+    protected createInvocation(params: {
+        [key: string]: unknown;
+    }): ToolInvocation<{
+        [key: string]: unknown;
+    }, ToolResult>;
+}
+export declare class MockModifiableToolInvocation extends BaseToolInvocation<Record<string, unknown>, ToolResult> {
+    private readonly tool;
+    constructor(tool: MockModifiableTool, params: Record<string, unknown>);
+    execute(_abortSignal: AbortSignal): Promise<ToolResult>;
+    shouldConfirmExecute(_abortSignal: AbortSignal): Promise<ToolCallConfirmationDetails | false>;
+    getDescription(): string;
+}
+/**
+ * Configurable mock modifiable tool for testing.
+ */
+export declare class MockModifiableTool extends MockTool implements ModifiableDeclarativeTool<Record<string, unknown>> {
+    constructor(name?: string);
+    getModifyContext(_abortSignal: AbortSignal): ModifyContext<Record<string, unknown>>;
+    protected createInvocation(params: Record<string, unknown>): ToolInvocation<Record<string, unknown>, ToolResult>;
+}

package/dist/src/test-utils/tools.js

@@ -0,0 +1,105 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi } from 'vitest';
+import { BaseDeclarativeTool, BaseToolInvocation, Kind, } from '../tools/tools.js';
+class MockToolInvocation extends BaseToolInvocation {
+    tool;
+    constructor(tool, params) {
+        super(params);
+        this.tool = tool;
+    }
+    async execute(_abortSignal) {
+        const result = this.tool.executeFn(this.params);
+        return (result ?? {
+            llmContent: `Tool ${this.tool.name} executed successfully.`,
+            returnDisplay: `Tool ${this.tool.name} executed successfully.`,
+        });
+    }
+    async shouldConfirmExecute(_abortSignal) {
+        if (this.tool.shouldConfirm) {
+            return {
+                type: 'exec',
+                title: `Confirm ${this.tool.displayName}`,
+                command: this.tool.name,
+                rootCommand: this.tool.name,
+                onConfirm: async () => { },
+            };
+        }
+        return false;
+    }
+    getDescription() {
+        return `A mock tool invocation for ${this.tool.name}`;
+    }
+}
+/**
+ * A highly configurable mock tool for testing purposes.
+ */
+export class MockTool extends BaseDeclarativeTool {
+    executeFn = vi.fn();
+    shouldConfirm = false;
+    constructor(name = 'mock-tool', displayName, description = 'A mock tool for testing.', params = {
+        type: 'object',
+        properties: { param: { type: 'string' } },
+    }) {
+        super(name, displayName ?? name, description, Kind.Other, params);
+    }
+    createInvocation(params) {
+        return new MockToolInvocation(this, params);
+    }
+}
+export class MockModifiableToolInvocation extends BaseToolInvocation {
+    tool;
+    constructor(tool, params) {
+        super(params);
+        this.tool = tool;
+    }
+    async execute(_abortSignal) {
+        const result = this.tool.executeFn(this.params);
+        return (result ?? {
+            llmContent: `Tool ${this.tool.name} executed successfully.`,
+            returnDisplay: `Tool ${this.tool.name} executed successfully.`,
+        });
+    }
+    async shouldConfirmExecute(_abortSignal) {
+        if (this.tool.shouldConfirm) {
+            return {
+                type: 'edit',
+                title: 'Confirm Mock Tool',
+                fileName: 'test.txt',
+                filePath: 'test.txt',
+                fileDiff: 'diff',
+                originalContent: 'originalContent',
+                newContent: 'newContent',
+                onConfirm: async () => { },
+            };
+        }
+        return false;
+    }
+    getDescription() {
+        return `A mock modifiable tool invocation for ${this.tool.name}`;
+    }
+}
+/**
+ * Configurable mock modifiable tool for testing.
+ */
+export class MockModifiableTool extends MockTool {
+    constructor(name = 'mockModifiableTool') {
+        super(name);
+        this.shouldConfirm = true;
+    }
+    getModifyContext(_abortSignal) {
+        return {
+            getFilePath: () => 'test.txt',
+            getCurrentContent: async () => 'old content',
+            getProposedContent: async () => 'new content',
+            createUpdatedParams: (_oldContent, modifiedProposedContent, _originalParams) => ({ newContent: modifiedProposedContent }),
+        };
+    }
+    createInvocation(params) {
+        return new MockModifiableToolInvocation(this, params);
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/src/test-utils/tools.js.map

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

package/dist/src/tools/diffOptions.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as Diff from 'diff';
+import type { DiffStat } from './tools.js';
+export declare const DEFAULT_DIFF_OPTIONS: Diff.PatchOptions;
+export declare function getDiffStat(fileName: string, oldStr: string, aiStr: string, userStr: string): DiffStat;

package/dist/src/tools/diffOptions.js

@@ -0,0 +1,38 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as Diff from 'diff';
+export const DEFAULT_DIFF_OPTIONS = {
+    context: 3,
+    ignoreWhitespace: true,
+};
+export function getDiffStat(fileName, oldStr, aiStr, userStr) {
+    const countLines = (patch) => {
+        let added = 0;
+        let removed = 0;
+        patch.hunks.forEach((hunk) => {
+            hunk.lines.forEach((line) => {
+                if (line.startsWith('+')) {
+                    added++;
+                }
+                else if (line.startsWith('-')) {
+                    removed++;
+                }
+            });
+        });
+        return { added, removed };
+    };
+    const patch = Diff.structuredPatch(fileName, fileName, oldStr, aiStr, 'Current', 'Proposed', DEFAULT_DIFF_OPTIONS);
+    const { added: aiAddedLines, removed: aiRemovedLines } = countLines(patch);
+    const userPatch = Diff.structuredPatch(fileName, fileName, aiStr, userStr, 'Proposed', 'User', DEFAULT_DIFF_OPTIONS);
+    const { added: userAddedLines, removed: userRemovedLines } = countLines(userPatch);
+    return {
+        ai_added_lines: aiAddedLines,
+        ai_removed_lines: aiRemovedLines,
+        user_added_lines: userAddedLines,
+        user_removed_lines: userRemovedLines,
+    };
+}
+//# sourceMappingURL=diffOptions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diffOptions.js","sourceRoot":"","sources":["../../../src/tools/diffOptions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B,MAAM,CAAC,MAAM,oBAAoB,GAAsB;IACrD,OAAO,EAAE,CAAC;IACV,gBAAgB,EAAE,IAAI;CACvB,CAAC;AAEF,MAAM,UAAU,WAAW,CACzB,QAAgB,EAChB,MAAc,EACd,KAAa,EACb,OAAe;IAEf,MAAM,UAAU,GAAG,CAAC,KAAsB,EAAE,EAAE;QAC5C,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAe,EAAE,EAAE;YACtC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAY,EAAE,EAAE;gBAClC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACzB,KAAK,EAAE,CAAC;gBACV,CAAC;qBAAM,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBAChC,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC5B,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAChC,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,KAAK,EACL,SAAS,EACT,UAAU,EACV,oBAAoB,CACrB,CAAC;IACF,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAE3E,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CACpC,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,OAAO,EACP,UAAU,EACV,MAAM,EACN,oBAAoB,CACrB,CAAC;IACF,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,gBAAgB,EAAE,GACxD,UAAU,CAAC,SAAS,CAAC,CAAC;IAExB,OAAO;QACL,cAAc,EAAE,YAAY;QAC5B,gBAAgB,EAAE,cAAc;QAChC,gBAAgB,EAAE,cAAc;QAChC,kBAAkB,EAAE,gBAAgB;KACrC,CAAC;AACJ,CAAC"}

package/dist/src/tools/diffOptions.test.d.ts

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

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

@@ -0,0 +1,119 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, expect, it } from 'vitest';
+import { getDiffStat } from './diffOptions.js';
+describe('getDiffStat', () => {
+    const fileName = 'test.txt';
+    it('should return 0 for all stats when there are no changes', () => {
+        const oldStr = 'line1\nline2\n';
+        const aiStr = 'line1\nline2\n';
+        const userStr = 'line1\nline2\n';
+        const diffStat = getDiffStat(fileName, oldStr, aiStr, userStr);
+        expect(diffStat).toEqual({
+            ai_added_lines: 0,
+            ai_removed_lines: 0,
+            user_added_lines: 0,
+            user_removed_lines: 0,
+        });
+    });
+    it('should correctly report AI additions', () => {
+        const oldStr = 'line1\nline2\n';
+        const aiStr = 'line1\nline2\nline3\n';
+        const userStr = 'line1\nline2\nline3\n';
+        const diffStat = getDiffStat(fileName, oldStr, aiStr, userStr);
+        expect(diffStat).toEqual({
+            ai_added_lines: 1,
+            ai_removed_lines: 0,
+            user_added_lines: 0,
+            user_removed_lines: 0,
+        });
+    });
+    it('should correctly report AI removals', () => {
+        const oldStr = 'line1\nline2\nline3\n';
+        const aiStr = 'line1\nline3\n';
+        const userStr = 'line1\nline3\n';
+        const diffStat = getDiffStat(fileName, oldStr, aiStr, userStr);
+        expect(diffStat).toEqual({
+            ai_added_lines: 0,
+            ai_removed_lines: 1,
+            user_added_lines: 0,
+            user_removed_lines: 0,
+        });
+    });
+    it('should correctly report AI modifications', () => {
+        const oldStr = 'line1\nline2\nline3\n';
+        const aiStr = 'line1\nline_two\nline3\n';
+        const userStr = 'line1\nline_two\nline3\n';
+        const diffStat = getDiffStat(fileName, oldStr, aiStr, userStr);
+        expect(diffStat).toEqual({
+            ai_added_lines: 1,
+            ai_removed_lines: 1,
+            user_added_lines: 0,
+            user_removed_lines: 0,
+        });
+    });
+    it('should correctly report user additions', () => {
+        const oldStr = 'line1\nline2\n';
+        const aiStr = 'line1\nline2\nline3\n';
+        const userStr = 'line1\nline2\nline3\nline4\n';
+        const diffStat = getDiffStat(fileName, oldStr, aiStr, userStr);
+        expect(diffStat).toEqual({
+            ai_added_lines: 1,
+            ai_removed_lines: 0,
+            user_added_lines: 1,
+            user_removed_lines: 0,
+        });
+    });
+    it('should correctly report user removals', () => {
+        const oldStr = 'line1\nline2\n';
+        const aiStr = 'line1\nline2\nline3\n';
+        const userStr = 'line1\nline2\n';
+        const diffStat = getDiffStat(fileName, oldStr, aiStr, userStr);
+        expect(diffStat).toEqual({
+            ai_added_lines: 1,
+            ai_removed_lines: 0,
+            user_added_lines: 0,
+            user_removed_lines: 1,
+        });
+    });
+    it('should correctly report user modifications', () => {
+        const oldStr = 'line1\nline2\n';
+        const aiStr = 'line1\nline2\nline3\n';
+        const userStr = 'line1\nline2\nline_three\n';
+        const diffStat = getDiffStat(fileName, oldStr, aiStr, userStr);
+        expect(diffStat).toEqual({
+            ai_added_lines: 1,
+            ai_removed_lines: 0,
+            user_added_lines: 1,
+            user_removed_lines: 1,
+        });
+    });
+    it('should handle complex changes from both AI and user', () => {
+        const oldStr = 'line1\nline2\nline3\nline4\n';
+        const aiStr = 'line_one\nline2\nline_three\nline4\n';
+        const userStr = 'line_one\nline_two\nline_three\nline4\nline5\n';
+        const diffStat = getDiffStat(fileName, oldStr, aiStr, userStr);
+        expect(diffStat).toEqual({
+            ai_added_lines: 2,
+            ai_removed_lines: 2,
+            user_added_lines: 2,
+            user_removed_lines: 1,
+        });
+    });
+    it('should report a single line modification as one addition and one removal', () => {
+        const oldStr = 'hello world';
+        const aiStr = 'hello universe';
+        const userStr = 'hello universe';
+        const diffStat = getDiffStat(fileName, oldStr, aiStr, userStr);
+        expect(diffStat).toEqual({
+            ai_added_lines: 1,
+            ai_removed_lines: 1,
+            user_added_lines: 0,
+            user_removed_lines: 0,
+        });
+    });
+});
+//# sourceMappingURL=diffOptions.test.js.map

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

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

package/dist/src/tools/edit.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ToolInvocation, ToolResult } from './tools.js';
+import { BaseDeclarativeTool } from './tools.js';
+import type { Config } from '../config/config.js';
+import type { ModifiableDeclarativeTool, ModifyContext } from './modifiable-tool.js';
+export declare function applyReplacement(currentContent: string | null, oldString: string, newString: string, isNewFile: boolean): string;
+/**
+ * Parameters for the Edit tool
+ */
+export interface EditToolParams {
+    /**
+     * The absolute path to the file to modify
+     */
+    file_path: string;
+    /**
+     * The text to replace
+     */
+    old_string: string;
+    /**
+     * The text to replace it with
+     */
+    new_string: string;
+    /**
+     * Number of replacements expected. Defaults to 1 if not specified.
+     * Use when you want to replace multiple occurrences.
+     */
+    expected_replacements?: number;
+    /**
+     * Whether the edit was modified manually by the user.
+     */
+    modified_by_user?: boolean;
+    /**
+     * Initially proposed string.
+     */
+    ai_proposed_string?: string;
+}
+/**
+ * Implementation of the Edit tool logic
+ */
+export declare class EditTool extends BaseDeclarativeTool<EditToolParams, ToolResult> implements ModifiableDeclarativeTool<EditToolParams> {
+    private readonly config;
+    static readonly Name = "replace";
+    constructor(config: Config);
+    /**
+     * Validates the parameters for the Edit tool
+     * @param params Parameters to validate
+     * @returns Error message string or null if valid
+     */
+    protected validateToolParamValues(params: EditToolParams): string | null;
+    protected createInvocation(params: EditToolParams): ToolInvocation<EditToolParams, ToolResult>;
+    getModifyContext(_: AbortSignal): ModifyContext<EditToolParams>;
+}