@google/gemini-cli-core 0.1.0-development.1

package/dist/src/telemetry/uiTelemetry.test.js

@@ -0,0 +1,411 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { UiTelemetryService } from './uiTelemetry.js';
+import { ToolCallEvent, ToolCallDecision, } from './types.js';
+import { EVENT_API_ERROR, EVENT_API_RESPONSE, EVENT_TOOL_CALL, } from './constants.js';
+import { ToolConfirmationOutcome } from '../tools/tools.js';
+const createFakeCompletedToolCall = (name, success, duration = 100, outcome, error) => {
+    const request = {
+        callId: `call_${name}_${Date.now()}`,
+        name,
+        args: { foo: 'bar' },
+        isClientInitiated: false,
+    };
+    if (success) {
+        return {
+            status: 'success',
+            request,
+            tool: { name }, // Mock tool
+            response: {
+                callId: request.callId,
+                responseParts: {
+                    functionResponse: {
+                        id: request.callId,
+                        name,
+                        response: { output: 'Success!' },
+                    },
+                },
+                error: undefined,
+                resultDisplay: 'Success!',
+            },
+            durationMs: duration,
+            outcome,
+        };
+    }
+    else {
+        return {
+            status: 'error',
+            request,
+            response: {
+                callId: request.callId,
+                responseParts: {
+                    functionResponse: {
+                        id: request.callId,
+                        name,
+                        response: { error: 'Tool failed' },
+                    },
+                },
+                error: error || new Error('Tool failed'),
+                resultDisplay: 'Failure!',
+            },
+            durationMs: duration,
+            outcome,
+        };
+    }
+};
+describe('UiTelemetryService', () => {
+    let service;
+    beforeEach(() => {
+        service = new UiTelemetryService();
+    });
+    it('should have correct initial metrics', () => {
+        const metrics = service.getMetrics();
+        expect(metrics).toEqual({
+            models: {},
+            tools: {
+                totalCalls: 0,
+                totalSuccess: 0,
+                totalFail: 0,
+                totalDurationMs: 0,
+                totalDecisions: {
+                    [ToolCallDecision.ACCEPT]: 0,
+                    [ToolCallDecision.REJECT]: 0,
+                    [ToolCallDecision.MODIFY]: 0,
+                },
+                byName: {},
+            },
+        });
+        expect(service.getLastPromptTokenCount()).toBe(0);
+    });
+    it('should emit an update event when an event is added', () => {
+        const spy = vi.fn();
+        service.on('update', spy);
+        const event = {
+            'event.name': EVENT_API_RESPONSE,
+            model: 'gemini-2.5-pro',
+            duration_ms: 500,
+            input_token_count: 10,
+            output_token_count: 20,
+            total_token_count: 30,
+            cached_content_token_count: 5,
+            thoughts_token_count: 2,
+            tool_token_count: 3,
+        };
+        service.addEvent(event);
+        expect(spy).toHaveBeenCalledOnce();
+        const { metrics, lastPromptTokenCount } = spy.mock.calls[0][0];
+        expect(metrics).toBeDefined();
+        expect(lastPromptTokenCount).toBe(10);
+    });
+    describe('API Response Event Processing', () => {
+        it('should process a single ApiResponseEvent', () => {
+            const event = {
+                'event.name': EVENT_API_RESPONSE,
+                model: 'gemini-2.5-pro',
+                duration_ms: 500,
+                input_token_count: 10,
+                output_token_count: 20,
+                total_token_count: 30,
+                cached_content_token_count: 5,
+                thoughts_token_count: 2,
+                tool_token_count: 3,
+            };
+            service.addEvent(event);
+            const metrics = service.getMetrics();
+            expect(metrics.models['gemini-2.5-pro']).toEqual({
+                api: {
+                    totalRequests: 1,
+                    totalErrors: 0,
+                    totalLatencyMs: 500,
+                },
+                tokens: {
+                    prompt: 10,
+                    candidates: 20,
+                    total: 30,
+                    cached: 5,
+                    thoughts: 2,
+                    tool: 3,
+                },
+            });
+            expect(service.getLastPromptTokenCount()).toBe(10);
+        });
+        it('should aggregate multiple ApiResponseEvents for the same model', () => {
+            const event1 = {
+                'event.name': EVENT_API_RESPONSE,
+                model: 'gemini-2.5-pro',
+                duration_ms: 500,
+                input_token_count: 10,
+                output_token_count: 20,
+                total_token_count: 30,
+                cached_content_token_count: 5,
+                thoughts_token_count: 2,
+                tool_token_count: 3,
+            };
+            const event2 = {
+                'event.name': EVENT_API_RESPONSE,
+                model: 'gemini-2.5-pro',
+                duration_ms: 600,
+                input_token_count: 15,
+                output_token_count: 25,
+                total_token_count: 40,
+                cached_content_token_count: 10,
+                thoughts_token_count: 4,
+                tool_token_count: 6,
+            };
+            service.addEvent(event1);
+            service.addEvent(event2);
+            const metrics = service.getMetrics();
+            expect(metrics.models['gemini-2.5-pro']).toEqual({
+                api: {
+                    totalRequests: 2,
+                    totalErrors: 0,
+                    totalLatencyMs: 1100,
+                },
+                tokens: {
+                    prompt: 25,
+                    candidates: 45,
+                    total: 70,
+                    cached: 15,
+                    thoughts: 6,
+                    tool: 9,
+                },
+            });
+            expect(service.getLastPromptTokenCount()).toBe(15);
+        });
+        it('should handle ApiResponseEvents for different models', () => {
+            const event1 = {
+                'event.name': EVENT_API_RESPONSE,
+                model: 'gemini-2.5-pro',
+                duration_ms: 500,
+                input_token_count: 10,
+                output_token_count: 20,
+                total_token_count: 30,
+                cached_content_token_count: 5,
+                thoughts_token_count: 2,
+                tool_token_count: 3,
+            };
+            const event2 = {
+                'event.name': EVENT_API_RESPONSE,
+                model: 'gemini-2.5-flash',
+                duration_ms: 1000,
+                input_token_count: 100,
+                output_token_count: 200,
+                total_token_count: 300,
+                cached_content_token_count: 50,
+                thoughts_token_count: 20,
+                tool_token_count: 30,
+            };
+            service.addEvent(event1);
+            service.addEvent(event2);
+            const metrics = service.getMetrics();
+            expect(metrics.models['gemini-2.5-pro']).toBeDefined();
+            expect(metrics.models['gemini-2.5-flash']).toBeDefined();
+            expect(metrics.models['gemini-2.5-pro'].api.totalRequests).toBe(1);
+            expect(metrics.models['gemini-2.5-flash'].api.totalRequests).toBe(1);
+            expect(service.getLastPromptTokenCount()).toBe(100);
+        });
+    });
+    describe('API Error Event Processing', () => {
+        it('should process a single ApiErrorEvent', () => {
+            const event = {
+                'event.name': EVENT_API_ERROR,
+                model: 'gemini-2.5-pro',
+                duration_ms: 300,
+                error: 'Something went wrong',
+            };
+            service.addEvent(event);
+            const metrics = service.getMetrics();
+            expect(metrics.models['gemini-2.5-pro']).toEqual({
+                api: {
+                    totalRequests: 1,
+                    totalErrors: 1,
+                    totalLatencyMs: 300,
+                },
+                tokens: {
+                    prompt: 0,
+                    candidates: 0,
+                    total: 0,
+                    cached: 0,
+                    thoughts: 0,
+                    tool: 0,
+                },
+            });
+        });
+        it('should aggregate ApiErrorEvents and ApiResponseEvents', () => {
+            const responseEvent = {
+                'event.name': EVENT_API_RESPONSE,
+                model: 'gemini-2.5-pro',
+                duration_ms: 500,
+                input_token_count: 10,
+                output_token_count: 20,
+                total_token_count: 30,
+                cached_content_token_count: 5,
+                thoughts_token_count: 2,
+                tool_token_count: 3,
+            };
+            const errorEvent = {
+                'event.name': EVENT_API_ERROR,
+                model: 'gemini-2.5-pro',
+                duration_ms: 300,
+                error: 'Something went wrong',
+            };
+            service.addEvent(responseEvent);
+            service.addEvent(errorEvent);
+            const metrics = service.getMetrics();
+            expect(metrics.models['gemini-2.5-pro']).toEqual({
+                api: {
+                    totalRequests: 2,
+                    totalErrors: 1,
+                    totalLatencyMs: 800,
+                },
+                tokens: {
+                    prompt: 10,
+                    candidates: 20,
+                    total: 30,
+                    cached: 5,
+                    thoughts: 2,
+                    tool: 3,
+                },
+            });
+        });
+    });
+    describe('Tool Call Event Processing', () => {
+        it('should process a single successful ToolCallEvent', () => {
+            const toolCall = createFakeCompletedToolCall('test_tool', true, 150, ToolConfirmationOutcome.ProceedOnce);
+            service.addEvent({
+                ...JSON.parse(JSON.stringify(new ToolCallEvent(toolCall))),
+                'event.name': EVENT_TOOL_CALL,
+            });
+            const metrics = service.getMetrics();
+            const { tools } = metrics;
+            expect(tools.totalCalls).toBe(1);
+            expect(tools.totalSuccess).toBe(1);
+            expect(tools.totalFail).toBe(0);
+            expect(tools.totalDurationMs).toBe(150);
+            expect(tools.totalDecisions[ToolCallDecision.ACCEPT]).toBe(1);
+            expect(tools.byName['test_tool']).toEqual({
+                count: 1,
+                success: 1,
+                fail: 0,
+                durationMs: 150,
+                decisions: {
+                    [ToolCallDecision.ACCEPT]: 1,
+                    [ToolCallDecision.REJECT]: 0,
+                    [ToolCallDecision.MODIFY]: 0,
+                },
+            });
+        });
+        it('should process a single failed ToolCallEvent', () => {
+            const toolCall = createFakeCompletedToolCall('test_tool', false, 200, ToolConfirmationOutcome.Cancel);
+            service.addEvent({
+                ...JSON.parse(JSON.stringify(new ToolCallEvent(toolCall))),
+                'event.name': EVENT_TOOL_CALL,
+            });
+            const metrics = service.getMetrics();
+            const { tools } = metrics;
+            expect(tools.totalCalls).toBe(1);
+            expect(tools.totalSuccess).toBe(0);
+            expect(tools.totalFail).toBe(1);
+            expect(tools.totalDurationMs).toBe(200);
+            expect(tools.totalDecisions[ToolCallDecision.REJECT]).toBe(1);
+            expect(tools.byName['test_tool']).toEqual({
+                count: 1,
+                success: 0,
+                fail: 1,
+                durationMs: 200,
+                decisions: {
+                    [ToolCallDecision.ACCEPT]: 0,
+                    [ToolCallDecision.REJECT]: 1,
+                    [ToolCallDecision.MODIFY]: 0,
+                },
+            });
+        });
+        it('should process a ToolCallEvent with modify decision', () => {
+            const toolCall = createFakeCompletedToolCall('test_tool', true, 250, ToolConfirmationOutcome.ModifyWithEditor);
+            service.addEvent({
+                ...JSON.parse(JSON.stringify(new ToolCallEvent(toolCall))),
+                'event.name': EVENT_TOOL_CALL,
+            });
+            const metrics = service.getMetrics();
+            const { tools } = metrics;
+            expect(tools.totalDecisions[ToolCallDecision.MODIFY]).toBe(1);
+            expect(tools.byName['test_tool'].decisions[ToolCallDecision.MODIFY]).toBe(1);
+        });
+        it('should process a ToolCallEvent without a decision', () => {
+            const toolCall = createFakeCompletedToolCall('test_tool', true, 100);
+            service.addEvent({
+                ...JSON.parse(JSON.stringify(new ToolCallEvent(toolCall))),
+                'event.name': EVENT_TOOL_CALL,
+            });
+            const metrics = service.getMetrics();
+            const { tools } = metrics;
+            expect(tools.totalDecisions).toEqual({
+                [ToolCallDecision.ACCEPT]: 0,
+                [ToolCallDecision.REJECT]: 0,
+                [ToolCallDecision.MODIFY]: 0,
+            });
+            expect(tools.byName['test_tool'].decisions).toEqual({
+                [ToolCallDecision.ACCEPT]: 0,
+                [ToolCallDecision.REJECT]: 0,
+                [ToolCallDecision.MODIFY]: 0,
+            });
+        });
+        it('should aggregate multiple ToolCallEvents for the same tool', () => {
+            const toolCall1 = createFakeCompletedToolCall('test_tool', true, 100, ToolConfirmationOutcome.ProceedOnce);
+            const toolCall2 = createFakeCompletedToolCall('test_tool', false, 150, ToolConfirmationOutcome.Cancel);
+            service.addEvent({
+                ...JSON.parse(JSON.stringify(new ToolCallEvent(toolCall1))),
+                'event.name': EVENT_TOOL_CALL,
+            });
+            service.addEvent({
+                ...JSON.parse(JSON.stringify(new ToolCallEvent(toolCall2))),
+                'event.name': EVENT_TOOL_CALL,
+            });
+            const metrics = service.getMetrics();
+            const { tools } = metrics;
+            expect(tools.totalCalls).toBe(2);
+            expect(tools.totalSuccess).toBe(1);
+            expect(tools.totalFail).toBe(1);
+            expect(tools.totalDurationMs).toBe(250);
+            expect(tools.totalDecisions[ToolCallDecision.ACCEPT]).toBe(1);
+            expect(tools.totalDecisions[ToolCallDecision.REJECT]).toBe(1);
+            expect(tools.byName['test_tool']).toEqual({
+                count: 2,
+                success: 1,
+                fail: 1,
+                durationMs: 250,
+                decisions: {
+                    [ToolCallDecision.ACCEPT]: 1,
+                    [ToolCallDecision.REJECT]: 1,
+                    [ToolCallDecision.MODIFY]: 0,
+                },
+            });
+        });
+        it('should handle ToolCallEvents for different tools', () => {
+            const toolCall1 = createFakeCompletedToolCall('tool_A', true, 100);
+            const toolCall2 = createFakeCompletedToolCall('tool_B', false, 200);
+            service.addEvent({
+                ...JSON.parse(JSON.stringify(new ToolCallEvent(toolCall1))),
+                'event.name': EVENT_TOOL_CALL,
+            });
+            service.addEvent({
+                ...JSON.parse(JSON.stringify(new ToolCallEvent(toolCall2))),
+                'event.name': EVENT_TOOL_CALL,
+            });
+            const metrics = service.getMetrics();
+            const { tools } = metrics;
+            expect(tools.totalCalls).toBe(2);
+            expect(tools.totalSuccess).toBe(1);
+            expect(tools.totalFail).toBe(1);
+            expect(tools.byName['tool_A']).toBeDefined();
+            expect(tools.byName['tool_B']).toBeDefined();
+            expect(tools.byName['tool_A'].count).toBe(1);
+            expect(tools.byName['tool_B'].count).toBe(1);
+        });
+    });
+});
+//# sourceMappingURL=uiTelemetry.test.js.map

package/dist/src/telemetry/uiTelemetry.test.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as Diff from 'diff';
+export declare const DEFAULT_DIFF_OPTIONS: Diff.PatchOptions;

package/dist/src/tools/diffOptions.js

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export const DEFAULT_DIFF_OPTIONS = {
+    context: 3,
+    ignoreWhitespace: true,
+};
+//# 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;AAIH,MAAM,CAAC,MAAM,oBAAoB,GAAsB;IACrD,OAAO,EAAE,CAAC;IACV,gBAAgB,EAAE,IAAI;CACvB,CAAC"}

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

@@ -0,0 +1,84 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseTool, ToolCallConfirmationDetails, ToolResult } from './tools.js';
+import { Config } from '../config/config.js';
+import { ModifiableTool, ModifyContext } from './modifiable-tool.js';
+/**
+ * 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;
+}
+/**
+ * Implementation of the Edit tool logic
+ */
+export declare class EditTool extends BaseTool<EditToolParams, ToolResult> implements ModifiableTool<EditToolParams> {
+    private readonly config;
+    static readonly Name = "replace";
+    private readonly rootDirectory;
+    /**
+     * Creates a new instance of the EditLogic
+     * @param rootDirectory Root directory to ground this tool in.
+     */
+    constructor(config: Config);
+    /**
+     * Checks if a path is within the root directory.
+     * @param pathToCheck The absolute path to check.
+     * @returns True if the path is within the root directory, false otherwise.
+     */
+    private isWithinRoot;
+    /**
+     * Validates the parameters for the Edit tool
+     * @param params Parameters to validate
+     * @returns Error message string or null if valid
+     */
+    validateToolParams(params: EditToolParams): string | null;
+    private _applyReplacement;
+    /**
+     * Calculates the potential outcome of an edit operation.
+     * @param params Parameters for the edit operation
+     * @returns An object describing the potential edit outcome
+     * @throws File system errors if reading the file fails unexpectedly (e.g., permissions)
+     */
+    private calculateEdit;
+    /**
+     * Handles the confirmation prompt for the Edit tool in the CLI.
+     * It needs to calculate the diff to show the user.
+     */
+    shouldConfirmExecute(params: EditToolParams, abortSignal: AbortSignal): Promise<ToolCallConfirmationDetails | false>;
+    getDescription(params: EditToolParams): string;
+    /**
+     * Executes the edit operation with the given parameters.
+     * @param params Parameters for the edit operation
+     * @returns Result of the edit operation
+     */
+    execute(params: EditToolParams, signal: AbortSignal): Promise<ToolResult>;
+    /**
+     * Creates parent directories if they don't exist
+     */
+    private ensureParentDirectoriesExist;
+    getModifyContext(_: AbortSignal): ModifyContext<EditToolParams>;
+}