@google/gemini-cli-core 0.9.0-preview.1 → 0.10.0-nightly.20251009.ae02236c

package/dist/src/telemetry/memory-monitor.test.js

@@ -0,0 +1,472 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import v8 from 'node:v8';
+import process from 'node:process';
+import { MemoryMonitor, initializeMemoryMonitor, getMemoryMonitor, recordCurrentMemoryUsage, startGlobalMemoryMonitoring, stopGlobalMemoryMonitoring, _resetGlobalMemoryMonitorForTests, } from './memory-monitor.js';
+import { recordMemoryUsage, isPerformanceMonitoringActive } from './metrics.js';
+import { HighWaterMarkTracker } from './high-water-mark-tracker.js';
+import { RateLimiter } from './rate-limiter.js';
+// Mock dependencies
+vi.mock('./metrics.js', () => ({
+    recordMemoryUsage: vi.fn(),
+    isPerformanceMonitoringActive: vi.fn(),
+    MemoryMetricType: {
+        HEAP_USED: 'heap_used',
+        HEAP_TOTAL: 'heap_total',
+        EXTERNAL: 'external',
+        RSS: 'rss',
+    },
+}));
+// Mock Node.js modules
+vi.mock('node:v8', () => ({
+    default: {
+        getHeapStatistics: vi.fn(),
+        getHeapSpaceStatistics: vi.fn(),
+    },
+}));
+vi.mock('node:process', () => ({
+    default: {
+        memoryUsage: vi.fn(),
+        cpuUsage: vi.fn(),
+        uptime: vi.fn(),
+    },
+}));
+const mockRecordMemoryUsage = vi.mocked(recordMemoryUsage);
+const mockIsPerformanceMonitoringActive = vi.mocked(isPerformanceMonitoringActive);
+const mockV8GetHeapStatistics = vi.mocked(v8.getHeapStatistics);
+const mockV8GetHeapSpaceStatistics = vi.mocked(v8.getHeapSpaceStatistics);
+const mockProcessMemoryUsage = vi.mocked(process.memoryUsage);
+const mockProcessCpuUsage = vi.mocked(process.cpuUsage);
+const mockProcessUptime = vi.mocked(process.uptime);
+// Mock config object
+const mockConfig = {
+    getSessionId: () => 'test-session-id',
+    getTelemetryEnabled: () => true,
+};
+// Test data
+const mockMemoryUsage = {
+    heapUsed: 15728640, // ~15MB
+    heapTotal: 31457280, // ~30MB
+    external: 2097152, // ~2MB
+    rss: 41943040, // ~40MB
+    arrayBuffers: 1048576, // ~1MB
+};
+const mockHeapStatistics = {
+    heap_size_limit: 536870912, // ~512MB
+    total_heap_size: 31457280,
+    total_heap_size_executable: 4194304, // ~4MB
+    total_physical_size: 31457280,
+    total_available_size: 1000000000, // ~1GB
+    used_heap_size: 15728640,
+    malloced_memory: 8192,
+    peak_malloced_memory: 16384,
+    does_zap_garbage: 0,
+    number_of_native_contexts: 1,
+    number_of_detached_contexts: 0,
+    total_global_handles_size: 8192,
+    used_global_handles_size: 4096,
+    external_memory: 2097152,
+};
+const mockHeapSpaceStatistics = [
+    {
+        space_name: 'new_space',
+        space_size: 8388608,
+        space_used_size: 4194304,
+        space_available_size: 4194304,
+        physical_space_size: 8388608,
+    },
+    {
+        space_name: 'old_space',
+        space_size: 16777216,
+        space_used_size: 8388608,
+        space_available_size: 8388608,
+        physical_space_size: 16777216,
+    },
+];
+const mockCpuUsage = {
+    user: 1000000, // 1 second
+    system: 500000, // 0.5 seconds
+};
+describe('MemoryMonitor', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date('2025-01-01T00:00:00.000Z'));
+        // Setup default mocks
+        mockIsPerformanceMonitoringActive.mockReturnValue(true);
+        mockProcessMemoryUsage.mockReturnValue(mockMemoryUsage);
+        mockV8GetHeapStatistics.mockReturnValue(mockHeapStatistics);
+        mockV8GetHeapSpaceStatistics.mockReturnValue(mockHeapSpaceStatistics);
+        mockProcessCpuUsage.mockReturnValue(mockCpuUsage);
+        mockProcessUptime.mockReturnValue(123.456);
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        vi.useRealTimers();
+        _resetGlobalMemoryMonitorForTests();
+    });
+    describe('MemoryMonitor Class', () => {
+        describe('constructor', () => {
+            it('should create a new MemoryMonitor instance without config to avoid multi-session attribution', () => {
+                const monitor = new MemoryMonitor();
+                expect(monitor).toBeInstanceOf(MemoryMonitor);
+            });
+        });
+        describe('takeSnapshot', () => {
+            it('should take a memory snapshot and record metrics when performance monitoring is active', () => {
+                const monitor = new MemoryMonitor();
+                const snapshot = monitor.takeSnapshot('test_context', mockConfig);
+                expect(snapshot).toEqual({
+                    timestamp: Date.now(),
+                    heapUsed: mockMemoryUsage.heapUsed,
+                    heapTotal: mockMemoryUsage.heapTotal,
+                    external: mockMemoryUsage.external,
+                    rss: mockMemoryUsage.rss,
+                    arrayBuffers: mockMemoryUsage.arrayBuffers,
+                    heapSizeLimit: mockHeapStatistics.heap_size_limit,
+                });
+                // Verify metrics were recorded
+                expect(mockRecordMemoryUsage).toHaveBeenCalledWith(mockConfig, mockMemoryUsage.heapUsed, {
+                    memory_type: 'heap_used',
+                    component: 'test_context',
+                });
+                expect(mockRecordMemoryUsage).toHaveBeenCalledWith(mockConfig, mockMemoryUsage.heapTotal, {
+                    memory_type: 'heap_total',
+                    component: 'test_context',
+                });
+                expect(mockRecordMemoryUsage).toHaveBeenCalledWith(mockConfig, mockMemoryUsage.external, {
+                    memory_type: 'external',
+                    component: 'test_context',
+                });
+                expect(mockRecordMemoryUsage).toHaveBeenCalledWith(mockConfig, mockMemoryUsage.rss, {
+                    memory_type: 'rss',
+                    component: 'test_context',
+                });
+            });
+            it('should not record metrics when performance monitoring is inactive', () => {
+                mockIsPerformanceMonitoringActive.mockReturnValue(false);
+                const monitor = new MemoryMonitor();
+                const snapshot = monitor.takeSnapshot('test_context', mockConfig);
+                expect(snapshot).toEqual({
+                    timestamp: Date.now(),
+                    heapUsed: mockMemoryUsage.heapUsed,
+                    heapTotal: mockMemoryUsage.heapTotal,
+                    external: mockMemoryUsage.external,
+                    rss: mockMemoryUsage.rss,
+                    arrayBuffers: mockMemoryUsage.arrayBuffers,
+                    heapSizeLimit: mockHeapStatistics.heap_size_limit,
+                });
+                // Verify no metrics were recorded
+                expect(mockRecordMemoryUsage).not.toHaveBeenCalled();
+            });
+        });
+        describe('getCurrentMemoryUsage', () => {
+            it('should return current memory usage without recording metrics', () => {
+                const monitor = new MemoryMonitor();
+                const usage = monitor.getCurrentMemoryUsage();
+                expect(usage).toEqual({
+                    timestamp: Date.now(),
+                    heapUsed: mockMemoryUsage.heapUsed,
+                    heapTotal: mockMemoryUsage.heapTotal,
+                    external: mockMemoryUsage.external,
+                    rss: mockMemoryUsage.rss,
+                    arrayBuffers: mockMemoryUsage.arrayBuffers,
+                    heapSizeLimit: mockHeapStatistics.heap_size_limit,
+                });
+                // Verify no metrics were recorded
+                expect(mockRecordMemoryUsage).not.toHaveBeenCalled();
+            });
+        });
+        describe('start and stop', () => {
+            it('should start and stop memory monitoring with proper lifecycle', () => {
+                const monitor = new MemoryMonitor();
+                const intervalMs = 1000;
+                // Start monitoring
+                monitor.start(mockConfig, intervalMs);
+                // Verify initial snapshot was taken
+                expect(mockRecordMemoryUsage).toHaveBeenCalledWith(mockConfig, mockMemoryUsage.heapUsed, {
+                    memory_type: 'heap_used',
+                    component: 'monitoring_start',
+                });
+                // Fast-forward time to trigger periodic snapshot
+                vi.advanceTimersByTime(intervalMs);
+                // Verify monitoring_start snapshot was taken (multiple metrics)
+                expect(mockRecordMemoryUsage).toHaveBeenCalledWith(mockConfig, expect.any(Number), {
+                    memory_type: 'heap_used',
+                    component: 'monitoring_start',
+                });
+                // Stop monitoring
+                monitor.stop(mockConfig);
+                // Verify final snapshot was taken
+                expect(mockRecordMemoryUsage).toHaveBeenCalledWith(mockConfig, mockMemoryUsage.heapUsed, {
+                    memory_type: 'heap_used',
+                    component: 'monitoring_stop',
+                });
+            });
+            it('should not start monitoring when performance monitoring is inactive', () => {
+                mockIsPerformanceMonitoringActive.mockReturnValue(false);
+                const monitor = new MemoryMonitor();
+                monitor.start(mockConfig, 1000);
+                // Verify no snapshots were taken
+                expect(mockRecordMemoryUsage).not.toHaveBeenCalled();
+            });
+            it('should not start monitoring when already running', () => {
+                const monitor = new MemoryMonitor();
+                // Start monitoring twice
+                monitor.start(mockConfig, 1000);
+                const initialCallCount = mockRecordMemoryUsage.mock.calls.length;
+                monitor.start(mockConfig, 1000);
+                // Verify no additional snapshots were taken
+                expect(mockRecordMemoryUsage).toHaveBeenCalledTimes(initialCallCount);
+            });
+            it('should handle stop when not running', () => {
+                const monitor = new MemoryMonitor();
+                // Should not throw error
+                expect(() => monitor.stop(mockConfig)).not.toThrow();
+            });
+            it('should stop without taking final snapshot when no config provided', () => {
+                const monitor = new MemoryMonitor();
+                monitor.start(mockConfig, 1000);
+                const callsBeforeStop = mockRecordMemoryUsage.mock.calls.length;
+                monitor.stop(); // No config provided
+                // Verify no final snapshot was taken
+                expect(mockRecordMemoryUsage).toHaveBeenCalledTimes(callsBeforeStop);
+            });
+            it('should periodically cleanup tracker state to prevent growth', () => {
+                const trackerCleanupSpy = vi.spyOn(HighWaterMarkTracker.prototype, 'cleanup');
+                const rateLimiterCleanupSpy = vi.spyOn(RateLimiter.prototype, 'cleanup');
+                const monitor = new MemoryMonitor();
+                monitor.start(mockConfig, 1000);
+                trackerCleanupSpy.mockClear();
+                rateLimiterCleanupSpy.mockClear();
+                // Advance timers beyond the cleanup interval (15 minutes) to trigger cleanup
+                vi.advanceTimersByTime(16 * 60 * 1000);
+                expect(trackerCleanupSpy).toHaveBeenCalled();
+                expect(rateLimiterCleanupSpy).toHaveBeenCalled();
+                monitor.stop(mockConfig);
+                trackerCleanupSpy.mockRestore();
+                rateLimiterCleanupSpy.mockRestore();
+            });
+        });
+        describe('getMemoryGrowth', () => {
+            it('should calculate memory growth between snapshots', () => {
+                const monitor = new MemoryMonitor();
+                // Take initial snapshot
+                monitor.takeSnapshot('initial', mockConfig);
+                // Change memory usage
+                const newMemoryUsage = {
+                    ...mockMemoryUsage,
+                    heapUsed: mockMemoryUsage.heapUsed + 1048576, // +1MB
+                    rss: mockMemoryUsage.rss + 2097152, // +2MB
+                };
+                mockProcessMemoryUsage.mockReturnValue(newMemoryUsage);
+                const growth = monitor.getMemoryGrowth();
+                expect(growth).toEqual({
+                    heapUsed: 1048576,
+                    heapTotal: 0,
+                    external: 0,
+                    rss: 2097152,
+                    arrayBuffers: 0,
+                });
+            });
+            it('should return null when no previous snapshot exists', () => {
+                const monitor = new MemoryMonitor();
+                const growth = monitor.getMemoryGrowth();
+                expect(growth).toBeNull();
+            });
+        });
+        describe('checkMemoryThreshold', () => {
+            it('should return true when memory usage exceeds threshold', () => {
+                const monitor = new MemoryMonitor();
+                const thresholdMB = 10; // 10MB threshold
+                const exceeds = monitor.checkMemoryThreshold(thresholdMB);
+                expect(exceeds).toBe(true); // heapUsed is ~15MB
+            });
+            it('should return false when memory usage is below threshold', () => {
+                const monitor = new MemoryMonitor();
+                const thresholdMB = 20; // 20MB threshold
+                const exceeds = monitor.checkMemoryThreshold(thresholdMB);
+                expect(exceeds).toBe(false); // heapUsed is ~15MB
+            });
+        });
+        describe('getMemoryUsageSummary', () => {
+            it('should return memory usage summary in MB with proper rounding', () => {
+                const monitor = new MemoryMonitor();
+                const summary = monitor.getMemoryUsageSummary();
+                expect(summary).toEqual({
+                    heapUsedMB: 15.0, // 15728640 bytes = 15MB
+                    heapTotalMB: 30.0, // 31457280 bytes = 30MB
+                    externalMB: 2.0, // 2097152 bytes = 2MB
+                    rssMB: 40.0, // 41943040 bytes = 40MB
+                    heapSizeLimitMB: 512.0, // 536870912 bytes = 512MB
+                });
+            });
+        });
+        describe('getHeapStatistics', () => {
+            it('should return V8 heap statistics', () => {
+                const monitor = new MemoryMonitor();
+                const stats = monitor.getHeapStatistics();
+                expect(stats).toBe(mockHeapStatistics);
+                expect(mockV8GetHeapStatistics).toHaveBeenCalled();
+            });
+        });
+        describe('getHeapSpaceStatistics', () => {
+            it('should return V8 heap space statistics', () => {
+                const monitor = new MemoryMonitor();
+                const stats = monitor.getHeapSpaceStatistics();
+                expect(stats).toBe(mockHeapSpaceStatistics);
+                expect(mockV8GetHeapSpaceStatistics).toHaveBeenCalled();
+            });
+        });
+        describe('getProcessMetrics', () => {
+            it('should return process CPU and memory metrics', () => {
+                const monitor = new MemoryMonitor();
+                const metrics = monitor.getProcessMetrics();
+                expect(metrics).toEqual({
+                    cpuUsage: mockCpuUsage,
+                    memoryUsage: mockMemoryUsage,
+                    uptime: 123.456,
+                });
+            });
+        });
+        describe('recordComponentMemoryUsage', () => {
+            it('should record memory usage for specific component', () => {
+                const monitor = new MemoryMonitor();
+                const snapshot = monitor.recordComponentMemoryUsage(mockConfig, 'test_component');
+                expect(snapshot).toEqual({
+                    timestamp: Date.now(),
+                    heapUsed: mockMemoryUsage.heapUsed,
+                    heapTotal: mockMemoryUsage.heapTotal,
+                    external: mockMemoryUsage.external,
+                    rss: mockMemoryUsage.rss,
+                    arrayBuffers: mockMemoryUsage.arrayBuffers,
+                    heapSizeLimit: mockHeapStatistics.heap_size_limit,
+                });
+                expect(mockRecordMemoryUsage).toHaveBeenCalledWith(mockConfig, mockMemoryUsage.heapUsed, {
+                    memory_type: 'heap_used',
+                    component: 'test_component',
+                });
+            });
+            it('should record memory usage for component with operation', () => {
+                const monitor = new MemoryMonitor();
+                monitor.recordComponentMemoryUsage(mockConfig, 'test_component', 'test_operation');
+                expect(mockRecordMemoryUsage).toHaveBeenCalledWith(mockConfig, mockMemoryUsage.heapUsed, {
+                    memory_type: 'heap_used',
+                    component: 'test_component_test_operation',
+                });
+            });
+        });
+        describe('destroy', () => {
+            it('should stop monitoring and cleanup resources', () => {
+                const monitor = new MemoryMonitor();
+                monitor.start(mockConfig, 1000);
+                monitor.destroy();
+                // Fast-forward time to ensure no more periodic snapshots
+                const callsBeforeDestroy = mockRecordMemoryUsage.mock.calls.length;
+                vi.advanceTimersByTime(2000);
+                expect(mockRecordMemoryUsage).toHaveBeenCalledTimes(callsBeforeDestroy);
+            });
+        });
+    });
+    describe('Global Memory Monitor Functions', () => {
+        describe('initializeMemoryMonitor', () => {
+            it('should create singleton instance', () => {
+                const monitor1 = initializeMemoryMonitor();
+                const monitor2 = initializeMemoryMonitor();
+                expect(monitor1).toBe(monitor2);
+                expect(monitor1).toBeInstanceOf(MemoryMonitor);
+            });
+        });
+        describe('getMemoryMonitor', () => {
+            it('should return null when not initialized', () => {
+                _resetGlobalMemoryMonitorForTests();
+                expect(getMemoryMonitor()).toBeNull();
+            });
+            it('should return initialized monitor', () => {
+                const initialized = initializeMemoryMonitor();
+                const retrieved = getMemoryMonitor();
+                expect(retrieved).toBe(initialized);
+            });
+        });
+        describe('recordCurrentMemoryUsage', () => {
+            it('should initialize monitor and take snapshot', () => {
+                const snapshot = recordCurrentMemoryUsage(mockConfig, 'test_context');
+                expect(snapshot).toEqual({
+                    timestamp: Date.now(),
+                    heapUsed: mockMemoryUsage.heapUsed,
+                    heapTotal: mockMemoryUsage.heapTotal,
+                    external: mockMemoryUsage.external,
+                    rss: mockMemoryUsage.rss,
+                    arrayBuffers: mockMemoryUsage.arrayBuffers,
+                    heapSizeLimit: mockHeapStatistics.heap_size_limit,
+                });
+                expect(mockRecordMemoryUsage).toHaveBeenCalledWith(mockConfig, mockMemoryUsage.heapUsed, {
+                    memory_type: 'heap_used',
+                    component: 'test_context',
+                });
+            });
+        });
+        describe('startGlobalMemoryMonitoring', () => {
+            it('should initialize and start global monitoring', () => {
+                startGlobalMemoryMonitoring(mockConfig, 1000);
+                // Verify initial snapshot
+                expect(mockRecordMemoryUsage).toHaveBeenCalledWith(mockConfig, mockMemoryUsage.heapUsed, {
+                    memory_type: 'heap_used',
+                    component: 'monitoring_start',
+                });
+                // Fast-forward and verify monitoring snapshot
+                vi.advanceTimersByTime(1000);
+                expect(mockRecordMemoryUsage).toHaveBeenCalledWith(mockConfig, expect.any(Number), {
+                    memory_type: 'heap_used',
+                    component: 'monitoring_start',
+                });
+            });
+        });
+        describe('stopGlobalMemoryMonitoring', () => {
+            it('should stop global monitoring when monitor exists', () => {
+                startGlobalMemoryMonitoring(mockConfig, 1000);
+                stopGlobalMemoryMonitoring(mockConfig);
+                // Verify final snapshot
+                expect(mockRecordMemoryUsage).toHaveBeenCalledWith(mockConfig, mockMemoryUsage.heapUsed, {
+                    memory_type: 'heap_used',
+                    component: 'monitoring_stop',
+                });
+                // Verify no more periodic snapshots
+                const callsAfterStop = mockRecordMemoryUsage.mock.calls.length;
+                vi.advanceTimersByTime(2000);
+                expect(mockRecordMemoryUsage.mock.calls.length).toBe(callsAfterStop);
+            });
+            it('should handle stop when no global monitor exists', () => {
+                expect(() => stopGlobalMemoryMonitoring(mockConfig)).not.toThrow();
+            });
+        });
+    });
+    describe('Error Scenarios', () => {
+        it('should handle process.memoryUsage() errors gracefully', () => {
+            mockProcessMemoryUsage.mockImplementation(() => {
+                throw new Error('Memory access error');
+            });
+            const monitor = new MemoryMonitor();
+            expect(() => monitor.getCurrentMemoryUsage()).toThrow('Memory access error');
+        });
+        it('should handle v8.getHeapStatistics() errors gracefully', () => {
+            mockV8GetHeapStatistics.mockImplementation(() => {
+                throw new Error('Heap statistics error');
+            });
+            const monitor = new MemoryMonitor();
+            expect(() => monitor.getCurrentMemoryUsage()).toThrow('Heap statistics error');
+        });
+        it('should handle metric recording errors gracefully', () => {
+            mockRecordMemoryUsage.mockImplementation(() => {
+                throw new Error('Metric recording error');
+            });
+            const monitor = new MemoryMonitor();
+            // Should propagate error if metric recording fails
+            expect(() => monitor.takeSnapshot('test', mockConfig)).toThrow('Metric recording error');
+        });
+    });
+});
+//# sourceMappingURL=memory-monitor.test.js.map

package/dist/src/telemetry/memory-monitor.test.js.map

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

package/dist/src/telemetry/metrics.d.ts

@@ -7,7 +7,7 @@ import type { Attributes, Meter, Counter, Histogram } from '@opentelemetry/api';
 import { ValueType } from '@opentelemetry/api';
 import { EVENT_CHAT_COMPRESSION } from './constants.js';
 import type { Config } from '../config/config.js';
-import type { ModelRoutingEvent, ModelSlashCommandEvent } from './types.js';
+import type { ModelRoutingEvent, ModelSlashCommandEvent, AgentFinishEvent } from './types.js';
 declare const TOOL_CALL_COUNT = "gemini_cli.tool.call.count";
 declare const API_REQUEST_COUNT = "gemini_cli.api.request.count";
 declare const TOKEN_USAGE = "gemini_cli.token.usage";
@@ -116,6 +116,15 @@ declare const COUNTER_DEFINITIONS: {
             tokens_after: number;
         };
     };
+    readonly "gemini_cli.agent.run.count": {
+        readonly description: "Counts agent runs, tagged by name and termination reason.";
+        readonly valueType: ValueType.INT;
+        readonly assign: (c: Counter) => Counter<Attributes>;
+        readonly attributes: {
+            agent_name: string;
+            terminate_reason: string;
+        };
+    };
 };
 declare const HISTOGRAM_DEFINITIONS: {
     readonly "gemini_cli.tool.call.latency": {
@@ -146,6 +155,24 @@ declare const HISTOGRAM_DEFINITIONS: {
             "routing.decision_source": string;
         };
     };
+    readonly "gemini_cli.agent.duration": {
+        readonly description: "Duration of agent runs in milliseconds.";
+        readonly unit: "ms";
+        readonly valueType: ValueType.INT;
+        readonly assign: (h: Histogram) => Histogram<Attributes>;
+        readonly attributes: {
+            agent_name: string;
+        };
+    };
+    readonly "gemini_cli.agent.turns": {
+        readonly description: "Number of turns taken by agents.";
+        readonly unit: "turns";
+        readonly valueType: ValueType.INT;
+        readonly assign: (h: Histogram) => Histogram<Attributes>;
+        readonly attributes: {
+            agent_name: string;
+        };
+    };
     readonly "gen_ai.client.token.usage": {
         readonly description: "Number of input and output tokens used.";
         readonly unit: "token";
@@ -363,6 +390,7 @@ export declare function recordContentRetry(config: Config): void;
 export declare function recordContentRetryFailure(config: Config): void;
 export declare function recordModelSlashCommand(config: Config, event: ModelSlashCommandEvent): void;
 export declare function recordModelRoutingMetrics(config: Config, event: ModelRoutingEvent): void;
+export declare function recordAgentRunMetrics(config: Config, event: AgentFinishEvent): void;
 export declare function recordGenAiClientTokenUsage(config: Config, tokenCount: number, attributes: MetricDefinitions[typeof GEN_AI_CLIENT_TOKEN_USAGE]['attributes']): void;
 export declare function recordGenAiClientOperationDuration(config: Config, durationSeconds: number, attributes: MetricDefinitions[typeof GEN_AI_CLIENT_OPERATION_DURATION]['attributes']): void;
 export declare function getConventionAttributes(event: {

package/dist/src/telemetry/metrics.js

@@ -19,6 +19,10 @@ const CONTENT_RETRY_FAILURE_COUNT = 'gemini_cli.chat.content_retry_failure.count
 const MODEL_ROUTING_LATENCY = 'gemini_cli.model_routing.latency';
 const MODEL_ROUTING_FAILURE_COUNT = 'gemini_cli.model_routing.failure.count';
 const MODEL_SLASH_COMMAND_CALL_COUNT = 'gemini_cli.slash_command.model.call_count';
+// Agent Metrics
+const AGENT_RUN_COUNT = 'gemini_cli.agent.run.count';
+const AGENT_DURATION_MS = 'gemini_cli.agent.duration';
+const AGENT_TURNS = 'gemini_cli.agent.turns';
 // OpenTelemetry GenAI Semantic Convention Metrics
 const GEN_AI_CLIENT_TOKEN_USAGE = 'gen_ai.client.token.usage';
 const GEN_AI_CLIENT_OPERATION_DURATION = 'gen_ai.client.operation.duration';
@@ -106,6 +110,12 @@ const COUNTER_DEFINITIONS = {
         assign: (c) => (chatCompressionCounter = c),
         attributes: {},
     },
+    [AGENT_RUN_COUNT]: {
+        description: 'Counts agent runs, tagged by name and termination reason.',
+        valueType: ValueType.INT,
+        assign: (c) => (agentRunCounter = c),
+        attributes: {},
+    },
 };
 const HISTOGRAM_DEFINITIONS = {
     [TOOL_CALL_LATENCY]: {
@@ -129,6 +139,20 @@ const HISTOGRAM_DEFINITIONS = {
         assign: (h) => (modelRoutingLatencyHistogram = h),
         attributes: {},
     },
+    [AGENT_DURATION_MS]: {
+        description: 'Duration of agent runs in milliseconds.',
+        unit: 'ms',
+        valueType: ValueType.INT,
+        assign: (h) => (agentDurationHistogram = h),
+        attributes: {},
+    },
+    [AGENT_TURNS]: {
+        description: 'Number of turns taken by agents.',
+        unit: 'turns',
+        valueType: ValueType.INT,
+        assign: (h) => (agentTurnsHistogram = h),
+        attributes: {},
+    },
     [GEN_AI_CLIENT_TOKEN_USAGE]: {
         description: 'Number of input and output tokens used.',
         unit: 'token',
@@ -289,6 +313,9 @@ let contentRetryFailureCounter;
 let modelRoutingLatencyHistogram;
 let modelRoutingFailureCounter;
 let modelSlashCommandCallCounter;
+let agentRunCounter;
+let agentDurationHistogram;
+let agentTurnsHistogram;
 // OpenTelemetry GenAI Semantic Convention Metrics
 let genAiClientTokenUsageHistogram;
 let genAiClientOperationDurationHistogram;
@@ -452,6 +479,27 @@ export function recordModelRoutingMetrics(config, event) {
         });
     }
 }
+export function recordAgentRunMetrics(config, event) {
+    if (!agentRunCounter ||
+        !agentDurationHistogram ||
+        !agentTurnsHistogram ||
+        !isMetricsInitialized)
+        return;
+    const commonAttributes = baseMetricDefinition.getCommonAttributes(config);
+    agentRunCounter.add(1, {
+        ...commonAttributes,
+        agent_name: event.agent_name,
+        terminate_reason: event.terminate_reason,
+    });
+    agentDurationHistogram.record(event.duration_ms, {
+        ...commonAttributes,
+        agent_name: event.agent_name,
+    });
+    agentTurnsHistogram.record(event.turn_count, {
+        ...commonAttributes,
+        agent_name: event.agent_name,
+    });
+}
 // OpenTelemetry GenAI Semantic Convention Recording Functions
 export function recordGenAiClientTokenUsage(config, tokenCount, attributes) {
     if (!genAiClientTokenUsageHistogram || !isMetricsInitialized)