@office-ai/aioncli-core 0.1.1-8.1

package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.d.ts

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

package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.js

@@ -0,0 +1,186 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi, describe, it, expect, beforeEach, afterEach } from 'vitest';
+import * as https from 'https';
+import { Readable, Writable } from 'stream';
+import { ClearcutLogger, } from './clearcut-logger.js';
+import * as userAccount from '../../utils/user_account.js';
+import * as userId from '../../utils/user_id.js';
+// Mock dependencies
+vi.mock('https-proxy-agent');
+vi.mock('https');
+vi.mock('../../utils/user_account');
+vi.mock('../../utils/user_id');
+const mockHttps = vi.mocked(https);
+const mockUserAccount = vi.mocked(userAccount);
+const mockUserId = vi.mocked(userId);
+describe('ClearcutLogger', () => {
+    let mockConfig;
+    let logger;
+    // A helper to get the internal events array for testing
+    const getEvents = (l) => l['events'].toArray();
+    const getEventsSize = (l) => l['events'].size;
+    const getMaxEvents = (l) => l['max_events'];
+    const getMaxRetryEvents = (l) => l['max_retry_events'];
+    const requeueFailedEvents = (l, events) => l['requeueFailedEvents'](events);
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date());
+        mockConfig = {
+            getUsageStatisticsEnabled: vi.fn().mockReturnValue(true),
+            getDebugMode: vi.fn().mockReturnValue(false),
+            getSessionId: vi.fn().mockReturnValue('test-session-id'),
+            getProxy: vi.fn().mockReturnValue(undefined),
+        };
+        mockUserAccount.getCachedGoogleAccount.mockReturnValue('test@google.com');
+        mockUserAccount.getLifetimeGoogleAccounts.mockReturnValue(1);
+        mockUserId.getInstallationId.mockReturnValue('test-installation-id');
+        logger = ClearcutLogger.getInstance(mockConfig);
+        expect(logger).toBeDefined();
+    });
+    afterEach(() => {
+        ClearcutLogger.clearInstance();
+        vi.useRealTimers();
+        vi.restoreAllMocks();
+    });
+    it('should not return an instance if usage statistics are disabled', () => {
+        ClearcutLogger.clearInstance();
+        vi.spyOn(mockConfig, 'getUsageStatisticsEnabled').mockReturnValue(false);
+        const disabledLogger = ClearcutLogger.getInstance(mockConfig);
+        expect(disabledLogger).toBeUndefined();
+    });
+    describe('enqueueLogEvent', () => {
+        it('should add events to the queue', () => {
+            logger.enqueueLogEvent({ test: 'event1' });
+            expect(getEventsSize(logger)).toBe(1);
+        });
+        it('should evict the oldest event when the queue is full', () => {
+            const maxEvents = getMaxEvents(logger);
+            for (let i = 0; i < maxEvents; i++) {
+                logger.enqueueLogEvent({ event_id: i });
+            }
+            expect(getEventsSize(logger)).toBe(maxEvents);
+            const firstEvent = JSON.parse(getEvents(logger)[0][0].source_extension_json);
+            expect(firstEvent.event_id).toBe(0);
+            // This should push out the first event
+            logger.enqueueLogEvent({ event_id: maxEvents });
+            expect(getEventsSize(logger)).toBe(maxEvents);
+            const newFirstEvent = JSON.parse(getEvents(logger)[0][0].source_extension_json);
+            expect(newFirstEvent.event_id).toBe(1);
+            const lastEvent = JSON.parse(getEvents(logger)[maxEvents - 1][0].source_extension_json);
+            expect(lastEvent.event_id).toBe(maxEvents);
+        });
+    });
+    describe('flushToClearcut', () => {
+        let mockRequest;
+        let mockResponse;
+        beforeEach(() => {
+            mockRequest = new Writable({
+                write(chunk, encoding, callback) {
+                    callback();
+                },
+            });
+            vi.spyOn(mockRequest, 'on');
+            vi.spyOn(mockRequest, 'end').mockReturnThis();
+            vi.spyOn(mockRequest, 'destroy').mockReturnThis();
+            mockResponse = new Readable({ read() { } });
+            mockHttps.request.mockImplementation((_options, ...args) => {
+                const callback = args.find((arg) => typeof arg === 'function');
+                if (callback) {
+                    callback(mockResponse);
+                }
+                return mockRequest;
+            });
+        });
+        it('should clear events on successful flush', async () => {
+            mockResponse.statusCode = 200;
+            const mockResponseBody = { nextRequestWaitMs: 1000 };
+            // Encoded protobuf for {nextRequestWaitMs: 1000} which is `08 E8 07`
+            const encodedResponse = Buffer.from([8, 232, 7]);
+            logger.enqueueLogEvent({ event_id: 1 });
+            const flushPromise = logger.flushToClearcut();
+            mockResponse.push(encodedResponse);
+            mockResponse.push(null); // End the stream
+            const response = await flushPromise;
+            expect(getEventsSize(logger)).toBe(0);
+            expect(response.nextRequestWaitMs).toBe(mockResponseBody.nextRequestWaitMs);
+        });
+        it('should handle a network error and requeue events', async () => {
+            logger.enqueueLogEvent({ event_id: 1 });
+            logger.enqueueLogEvent({ event_id: 2 });
+            expect(getEventsSize(logger)).toBe(2);
+            const flushPromise = logger.flushToClearcut();
+            mockRequest.emit('error', new Error('Network error'));
+            await flushPromise;
+            expect(getEventsSize(logger)).toBe(2);
+            const events = getEvents(logger);
+            expect(JSON.parse(events[0][0].source_extension_json).event_id).toBe(1);
+        });
+        it('should handle an HTTP error and requeue events', async () => {
+            mockResponse.statusCode = 500;
+            mockResponse.statusMessage = 'Internal Server Error';
+            logger.enqueueLogEvent({ event_id: 1 });
+            logger.enqueueLogEvent({ event_id: 2 });
+            expect(getEventsSize(logger)).toBe(2);
+            const flushPromise = logger.flushToClearcut();
+            mockResponse.emit('end'); // End the response to trigger promise resolution
+            await flushPromise;
+            expect(getEventsSize(logger)).toBe(2);
+            const events = getEvents(logger);
+            expect(JSON.parse(events[0][0].source_extension_json).event_id).toBe(1);
+        });
+    });
+    describe('requeueFailedEvents logic', () => {
+        it('should limit the number of requeued events to max_retry_events', () => {
+            const maxRetryEvents = getMaxRetryEvents(logger);
+            const eventsToLogCount = maxRetryEvents + 5;
+            const eventsToSend = [];
+            for (let i = 0; i < eventsToLogCount; i++) {
+                eventsToSend.push([
+                    {
+                        event_time_ms: Date.now(),
+                        source_extension_json: JSON.stringify({ event_id: i }),
+                    },
+                ]);
+            }
+            requeueFailedEvents(logger, eventsToSend);
+            expect(getEventsSize(logger)).toBe(maxRetryEvents);
+            const firstRequeuedEvent = JSON.parse(getEvents(logger)[0][0].source_extension_json);
+            // The last `maxRetryEvents` are kept. The oldest of those is at index `eventsToLogCount - maxRetryEvents`.
+            expect(firstRequeuedEvent.event_id).toBe(eventsToLogCount - maxRetryEvents);
+        });
+        it('should not requeue more events than available space in the queue', () => {
+            const maxEvents = getMaxEvents(logger);
+            const spaceToLeave = 5;
+            const initialEventCount = maxEvents - spaceToLeave;
+            for (let i = 0; i < initialEventCount; i++) {
+                logger.enqueueLogEvent({ event_id: `initial_${i}` });
+            }
+            expect(getEventsSize(logger)).toBe(initialEventCount);
+            const failedEventsCount = 10; // More than spaceToLeave
+            const eventsToSend = [];
+            for (let i = 0; i < failedEventsCount; i++) {
+                eventsToSend.push([
+                    {
+                        event_time_ms: Date.now(),
+                        source_extension_json: JSON.stringify({ event_id: `failed_${i}` }),
+                    },
+                ]);
+            }
+            requeueFailedEvents(logger, eventsToSend);
+            // availableSpace is 5. eventsToRequeue is min(10, 5) = 5.
+            // Total size should be initialEventCount + 5 = maxEvents.
+            expect(getEventsSize(logger)).toBe(maxEvents);
+            // The requeued events are the *last* 5 of the failed events.
+            // startIndex = max(0, 10 - 5) = 5.
+            // Loop unshifts events from index 9 down to 5.
+            // The first element in the deque is the one with id 'failed_5'.
+            const firstRequeuedEvent = JSON.parse(getEvents(logger)[0][0].source_extension_json);
+            expect(firstRequeuedEvent.event_id).toBe('failed_5');
+        });
+    });
+});
+//# sourceMappingURL=clearcut-logger.test.js.map

package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.js.map

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

package/dist/src/telemetry/clearcut-logger/event-metadata-key.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare enum EventMetadataKey {
+    GEMINI_CLI_KEY_UNKNOWN = 0,
+    GEMINI_CLI_START_SESSION_MODEL = 1,
+    GEMINI_CLI_START_SESSION_EMBEDDING_MODEL = 2,
+    GEMINI_CLI_START_SESSION_SANDBOX = 3,
+    GEMINI_CLI_START_SESSION_CORE_TOOLS = 4,
+    GEMINI_CLI_START_SESSION_APPROVAL_MODE = 5,
+    GEMINI_CLI_START_SESSION_API_KEY_ENABLED = 6,
+    GEMINI_CLI_START_SESSION_VERTEX_API_ENABLED = 7,
+    GEMINI_CLI_START_SESSION_DEBUG_MODE_ENABLED = 8,
+    GEMINI_CLI_START_SESSION_MCP_SERVERS = 9,
+    GEMINI_CLI_START_SESSION_TELEMETRY_ENABLED = 10,
+    GEMINI_CLI_START_SESSION_TELEMETRY_LOG_USER_PROMPTS_ENABLED = 11,
+    GEMINI_CLI_START_SESSION_RESPECT_GITIGNORE = 12,
+    GEMINI_CLI_USER_PROMPT_LENGTH = 13,
+    GEMINI_CLI_TOOL_CALL_NAME = 14,
+    GEMINI_CLI_TOOL_CALL_DECISION = 15,
+    GEMINI_CLI_TOOL_CALL_SUCCESS = 16,
+    GEMINI_CLI_TOOL_CALL_DURATION_MS = 17,
+    GEMINI_CLI_TOOL_ERROR_MESSAGE = 18,
+    GEMINI_CLI_TOOL_CALL_ERROR_TYPE = 19,
+    GEMINI_CLI_API_REQUEST_MODEL = 20,
+    GEMINI_CLI_API_RESPONSE_MODEL = 21,
+    GEMINI_CLI_API_RESPONSE_STATUS_CODE = 22,
+    GEMINI_CLI_API_RESPONSE_DURATION_MS = 23,
+    GEMINI_CLI_API_ERROR_MESSAGE = 24,
+    GEMINI_CLI_API_RESPONSE_INPUT_TOKEN_COUNT = 25,
+    GEMINI_CLI_API_RESPONSE_OUTPUT_TOKEN_COUNT = 26,
+    GEMINI_CLI_API_RESPONSE_CACHED_TOKEN_COUNT = 27,
+    GEMINI_CLI_API_RESPONSE_THINKING_TOKEN_COUNT = 28,
+    GEMINI_CLI_API_RESPONSE_TOOL_TOKEN_COUNT = 29,
+    GEMINI_CLI_API_ERROR_MODEL = 30,
+    GEMINI_CLI_API_ERROR_TYPE = 31,
+    GEMINI_CLI_API_ERROR_STATUS_CODE = 32,
+    GEMINI_CLI_API_ERROR_DURATION_MS = 33,
+    GEMINI_CLI_END_SESSION_ID = 34,
+    GEMINI_CLI_PROMPT_ID = 35,
+    GEMINI_CLI_AUTH_TYPE = 36,
+    GEMINI_CLI_GOOGLE_ACCOUNTS_COUNT = 37,
+    GEMINI_CLI_SURFACE = 39,
+    GEMINI_CLI_SESSION_ID = 40,
+    GEMINI_CLI_LOOP_DETECTED_TYPE = 38,
+    GEMINI_CLI_SLASH_COMMAND_NAME = 41,
+    GEMINI_CLI_SLASH_COMMAND_SUBCOMMAND = 42,
+    GEMINI_CLI_RESPONSE_FINISH_REASON = 43,
+    GEMINI_CLI_NEXT_SPEAKER_CHECK_RESULT = 44,
+    GEMINI_CLI_MALFORMED_JSON_RESPONSE_MODEL = 45,
+    GEMINI_CLI_IDE_CONNECTION_TYPE = 46,
+    GEMINI_CLI_AI_ADDED_LINES = 47,
+    GEMINI_CLI_AI_REMOVED_LINES = 48,
+    GEMINI_CLI_USER_ADDED_LINES = 49,
+    GEMINI_CLI_USER_REMOVED_LINES = 50
+}
+export declare function getEventMetadataKey(keyName: string): EventMetadataKey | undefined;

package/dist/src/telemetry/clearcut-logger/event-metadata-key.js

@@ -0,0 +1,159 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// Defines valid event metadata keys for Clearcut logging.
+export var EventMetadataKey;
+(function (EventMetadataKey) {
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_KEY_UNKNOWN"] = 0] = "GEMINI_CLI_KEY_UNKNOWN";
+    // ==========================================================================
+    // Start Session Event Keys
+    // ===========================================================================
+    // Logs the model id used in the session.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_START_SESSION_MODEL"] = 1] = "GEMINI_CLI_START_SESSION_MODEL";
+    // Logs the embedding model id used in the session.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_START_SESSION_EMBEDDING_MODEL"] = 2] = "GEMINI_CLI_START_SESSION_EMBEDDING_MODEL";
+    // Logs the sandbox that was used in the session.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_START_SESSION_SANDBOX"] = 3] = "GEMINI_CLI_START_SESSION_SANDBOX";
+    // Logs the core tools that were enabled in the session.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_START_SESSION_CORE_TOOLS"] = 4] = "GEMINI_CLI_START_SESSION_CORE_TOOLS";
+    // Logs the approval mode that was used in the session.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_START_SESSION_APPROVAL_MODE"] = 5] = "GEMINI_CLI_START_SESSION_APPROVAL_MODE";
+    // Logs whether an API key was used in the session.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_START_SESSION_API_KEY_ENABLED"] = 6] = "GEMINI_CLI_START_SESSION_API_KEY_ENABLED";
+    // Logs whether the Vertex API was used in the session.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_START_SESSION_VERTEX_API_ENABLED"] = 7] = "GEMINI_CLI_START_SESSION_VERTEX_API_ENABLED";
+    // Logs whether debug mode was enabled in the session.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_START_SESSION_DEBUG_MODE_ENABLED"] = 8] = "GEMINI_CLI_START_SESSION_DEBUG_MODE_ENABLED";
+    // Logs the MCP servers that were enabled in the session.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_START_SESSION_MCP_SERVERS"] = 9] = "GEMINI_CLI_START_SESSION_MCP_SERVERS";
+    // Logs whether user-collected telemetry was enabled in the session.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_START_SESSION_TELEMETRY_ENABLED"] = 10] = "GEMINI_CLI_START_SESSION_TELEMETRY_ENABLED";
+    // Logs whether prompt collection was enabled for user-collected telemetry.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_START_SESSION_TELEMETRY_LOG_USER_PROMPTS_ENABLED"] = 11] = "GEMINI_CLI_START_SESSION_TELEMETRY_LOG_USER_PROMPTS_ENABLED";
+    // Logs whether the session was configured to respect gitignore files.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_START_SESSION_RESPECT_GITIGNORE"] = 12] = "GEMINI_CLI_START_SESSION_RESPECT_GITIGNORE";
+    // ==========================================================================
+    // User Prompt Event Keys
+    // ===========================================================================
+    // Logs the length of the prompt.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_USER_PROMPT_LENGTH"] = 13] = "GEMINI_CLI_USER_PROMPT_LENGTH";
+    // ==========================================================================
+    // Tool Call Event Keys
+    // ===========================================================================
+    // Logs the function name.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_TOOL_CALL_NAME"] = 14] = "GEMINI_CLI_TOOL_CALL_NAME";
+    // Logs the user's decision about how to handle the tool call.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_TOOL_CALL_DECISION"] = 15] = "GEMINI_CLI_TOOL_CALL_DECISION";
+    // Logs whether the tool call succeeded.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_TOOL_CALL_SUCCESS"] = 16] = "GEMINI_CLI_TOOL_CALL_SUCCESS";
+    // Logs the tool call duration in milliseconds.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_TOOL_CALL_DURATION_MS"] = 17] = "GEMINI_CLI_TOOL_CALL_DURATION_MS";
+    // Logs the tool call error message, if any.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_TOOL_ERROR_MESSAGE"] = 18] = "GEMINI_CLI_TOOL_ERROR_MESSAGE";
+    // Logs the tool call error type, if any.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_TOOL_CALL_ERROR_TYPE"] = 19] = "GEMINI_CLI_TOOL_CALL_ERROR_TYPE";
+    // ==========================================================================
+    // GenAI API Request Event Keys
+    // ===========================================================================
+    // Logs the model id of the request.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_API_REQUEST_MODEL"] = 20] = "GEMINI_CLI_API_REQUEST_MODEL";
+    // ==========================================================================
+    // GenAI API Response Event Keys
+    // ===========================================================================
+    // Logs the model id of the API call.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_API_RESPONSE_MODEL"] = 21] = "GEMINI_CLI_API_RESPONSE_MODEL";
+    // Logs the status code of the response.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_API_RESPONSE_STATUS_CODE"] = 22] = "GEMINI_CLI_API_RESPONSE_STATUS_CODE";
+    // Logs the duration of the API call in milliseconds.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_API_RESPONSE_DURATION_MS"] = 23] = "GEMINI_CLI_API_RESPONSE_DURATION_MS";
+    // Logs the error message of the API call, if any.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_API_ERROR_MESSAGE"] = 24] = "GEMINI_CLI_API_ERROR_MESSAGE";
+    // Logs the input token count of the API call.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_API_RESPONSE_INPUT_TOKEN_COUNT"] = 25] = "GEMINI_CLI_API_RESPONSE_INPUT_TOKEN_COUNT";
+    // Logs the output token count of the API call.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_API_RESPONSE_OUTPUT_TOKEN_COUNT"] = 26] = "GEMINI_CLI_API_RESPONSE_OUTPUT_TOKEN_COUNT";
+    // Logs the cached token count of the API call.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_API_RESPONSE_CACHED_TOKEN_COUNT"] = 27] = "GEMINI_CLI_API_RESPONSE_CACHED_TOKEN_COUNT";
+    // Logs the thinking token count of the API call.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_API_RESPONSE_THINKING_TOKEN_COUNT"] = 28] = "GEMINI_CLI_API_RESPONSE_THINKING_TOKEN_COUNT";
+    // Logs the tool use token count of the API call.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_API_RESPONSE_TOOL_TOKEN_COUNT"] = 29] = "GEMINI_CLI_API_RESPONSE_TOOL_TOKEN_COUNT";
+    // ==========================================================================
+    // GenAI API Error Event Keys
+    // ===========================================================================
+    // Logs the model id of the API call.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_API_ERROR_MODEL"] = 30] = "GEMINI_CLI_API_ERROR_MODEL";
+    // Logs the error type.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_API_ERROR_TYPE"] = 31] = "GEMINI_CLI_API_ERROR_TYPE";
+    // Logs the status code of the error response.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_API_ERROR_STATUS_CODE"] = 32] = "GEMINI_CLI_API_ERROR_STATUS_CODE";
+    // Logs the duration of the API call in milliseconds.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_API_ERROR_DURATION_MS"] = 33] = "GEMINI_CLI_API_ERROR_DURATION_MS";
+    // ==========================================================================
+    // End Session Event Keys
+    // ===========================================================================
+    // Logs the end of a session.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_END_SESSION_ID"] = 34] = "GEMINI_CLI_END_SESSION_ID";
+    // ==========================================================================
+    // Shared Keys
+    // ===========================================================================
+    // Logs the Prompt Id
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_PROMPT_ID"] = 35] = "GEMINI_CLI_PROMPT_ID";
+    // Logs the Auth type for the prompt, api responses and errors.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_AUTH_TYPE"] = 36] = "GEMINI_CLI_AUTH_TYPE";
+    // Logs the total number of Google accounts ever used.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_GOOGLE_ACCOUNTS_COUNT"] = 37] = "GEMINI_CLI_GOOGLE_ACCOUNTS_COUNT";
+    // Logs the Surface from where the Gemini CLI was invoked, eg: VSCode.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_SURFACE"] = 39] = "GEMINI_CLI_SURFACE";
+    // Logs the session id
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_SESSION_ID"] = 40] = "GEMINI_CLI_SESSION_ID";
+    // ==========================================================================
+    // Loop Detected Event Keys
+    // ===========================================================================
+    // Logs the type of loop detected.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_LOOP_DETECTED_TYPE"] = 38] = "GEMINI_CLI_LOOP_DETECTED_TYPE";
+    // ==========================================================================
+    // Slash Command Event Keys
+    // ===========================================================================
+    // Logs the name of the slash command.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_SLASH_COMMAND_NAME"] = 41] = "GEMINI_CLI_SLASH_COMMAND_NAME";
+    // Logs the subcommand of the slash command.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_SLASH_COMMAND_SUBCOMMAND"] = 42] = "GEMINI_CLI_SLASH_COMMAND_SUBCOMMAND";
+    // ==========================================================================
+    // Next Speaker Check Event Keys
+    // ===========================================================================
+    // Logs the finish reason of the previous streamGenerateContent response
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_RESPONSE_FINISH_REASON"] = 43] = "GEMINI_CLI_RESPONSE_FINISH_REASON";
+    // Logs the result of the next speaker check
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_NEXT_SPEAKER_CHECK_RESULT"] = 44] = "GEMINI_CLI_NEXT_SPEAKER_CHECK_RESULT";
+    // ==========================================================================
+    // Malformed JSON Response Event Keys
+    // ==========================================================================
+    // Logs the model that produced the malformed JSON response.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_MALFORMED_JSON_RESPONSE_MODEL"] = 45] = "GEMINI_CLI_MALFORMED_JSON_RESPONSE_MODEL";
+    // ==========================================================================
+    // IDE Connection Event Keys
+    // ===========================================================================
+    // Logs the type of the IDE connection.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_IDE_CONNECTION_TYPE"] = 46] = "GEMINI_CLI_IDE_CONNECTION_TYPE";
+    // Logs AI added lines in edit/write tool response.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_AI_ADDED_LINES"] = 47] = "GEMINI_CLI_AI_ADDED_LINES";
+    // Logs AI removed lines in edit/write tool response.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_AI_REMOVED_LINES"] = 48] = "GEMINI_CLI_AI_REMOVED_LINES";
+    // Logs user added lines in edit/write tool response.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_USER_ADDED_LINES"] = 49] = "GEMINI_CLI_USER_ADDED_LINES";
+    // Logs user removed lines in edit/write tool response.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_USER_REMOVED_LINES"] = 50] = "GEMINI_CLI_USER_REMOVED_LINES";
+})(EventMetadataKey || (EventMetadataKey = {}));
+export function getEventMetadataKey(keyName) {
+    // Access the enum member by its string name
+    const key = EventMetadataKey[keyName];
+    // Check if the result is a valid enum member (not undefined and is a number)
+    if (typeof key === 'number') {
+        return key;
+    }
+    return undefined;
+}
+//# sourceMappingURL=event-metadata-key.js.map

package/dist/src/telemetry/clearcut-logger/event-metadata-key.js.map

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

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

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const SERVICE_NAME = "gemini-cli";
+export declare const EVENT_USER_PROMPT = "gemini_cli.user_prompt";
+export declare const EVENT_TOOL_CALL = "gemini_cli.tool_call";
+export declare const EVENT_API_REQUEST = "gemini_cli.api_request";
+export declare const EVENT_API_ERROR = "gemini_cli.api_error";
+export declare const EVENT_API_RESPONSE = "gemini_cli.api_response";
+export declare const EVENT_CLI_CONFIG = "gemini_cli.config";
+export declare const EVENT_FLASH_FALLBACK = "gemini_cli.flash_fallback";
+export declare const EVENT_NEXT_SPEAKER_CHECK = "gemini_cli.next_speaker_check";
+export declare const EVENT_SLASH_COMMAND = "gemini_cli.slash_command";
+export declare const EVENT_IDE_CONNECTION = "gemini_cli.ide_connection";
+export declare const METRIC_TOOL_CALL_COUNT = "gemini_cli.tool.call.count";
+export declare const METRIC_TOOL_CALL_LATENCY = "gemini_cli.tool.call.latency";
+export declare const METRIC_API_REQUEST_COUNT = "gemini_cli.api.request.count";
+export declare const METRIC_API_REQUEST_LATENCY = "gemini_cli.api.request.latency";
+export declare const METRIC_TOKEN_USAGE = "gemini_cli.token.usage";
+export declare const METRIC_SESSION_COUNT = "gemini_cli.session.count";
+export declare const METRIC_FILE_OPERATION_COUNT = "gemini_cli.file.operation.count";

package/dist/src/telemetry/constants.js

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export const SERVICE_NAME = 'gemini-cli';
+export const EVENT_USER_PROMPT = 'gemini_cli.user_prompt';
+export const EVENT_TOOL_CALL = 'gemini_cli.tool_call';
+export const EVENT_API_REQUEST = 'gemini_cli.api_request';
+export const EVENT_API_ERROR = 'gemini_cli.api_error';
+export const EVENT_API_RESPONSE = 'gemini_cli.api_response';
+export const EVENT_CLI_CONFIG = 'gemini_cli.config';
+export const EVENT_FLASH_FALLBACK = 'gemini_cli.flash_fallback';
+export const EVENT_NEXT_SPEAKER_CHECK = 'gemini_cli.next_speaker_check';
+export const EVENT_SLASH_COMMAND = 'gemini_cli.slash_command';
+export const EVENT_IDE_CONNECTION = 'gemini_cli.ide_connection';
+export const METRIC_TOOL_CALL_COUNT = 'gemini_cli.tool.call.count';
+export const METRIC_TOOL_CALL_LATENCY = 'gemini_cli.tool.call.latency';
+export const METRIC_API_REQUEST_COUNT = 'gemini_cli.api.request.count';
+export const METRIC_API_REQUEST_LATENCY = 'gemini_cli.api.request.latency';
+export const METRIC_TOKEN_USAGE = 'gemini_cli.token.usage';
+export const METRIC_SESSION_COUNT = 'gemini_cli.session.count';
+export const METRIC_FILE_OPERATION_COUNT = 'gemini_cli.file.operation.count';
+//# sourceMappingURL=constants.js.map

package/dist/src/telemetry/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/telemetry/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,YAAY,CAAC;AAEzC,MAAM,CAAC,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AAC1D,MAAM,CAAC,MAAM,eAAe,GAAG,sBAAsB,CAAC;AACtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AAC1D,MAAM,CAAC,MAAM,eAAe,GAAG,sBAAsB,CAAC;AACtD,MAAM,CAAC,MAAM,kBAAkB,GAAG,yBAAyB,CAAC;AAC5D,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AACpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,2BAA2B,CAAC;AAChE,MAAM,CAAC,MAAM,wBAAwB,GAAG,+BAA+B,CAAC;AACxE,MAAM,CAAC,MAAM,mBAAmB,GAAG,0BAA0B,CAAC;AAC9D,MAAM,CAAC,MAAM,oBAAoB,GAAG,2BAA2B,CAAC;AAEhE,MAAM,CAAC,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AACnE,MAAM,CAAC,MAAM,wBAAwB,GAAG,8BAA8B,CAAC;AACvE,MAAM,CAAC,MAAM,wBAAwB,GAAG,8BAA8B,CAAC;AACvE,MAAM,CAAC,MAAM,0BAA0B,GAAG,gCAAgC,CAAC;AAC3E,MAAM,CAAC,MAAM,kBAAkB,GAAG,wBAAwB,CAAC;AAC3D,MAAM,CAAC,MAAM,oBAAoB,GAAG,0BAA0B,CAAC;AAC/D,MAAM,CAAC,MAAM,2BAA2B,GAAG,iCAAiC,CAAC"}

package/dist/src/telemetry/file-exporters.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs';
+import { ExportResult } from '@opentelemetry/core';
+import { ReadableSpan, SpanExporter } from '@opentelemetry/sdk-trace-base';
+import { ReadableLogRecord, LogRecordExporter } from '@opentelemetry/sdk-logs';
+import { ResourceMetrics, PushMetricExporter, AggregationTemporality } from '@opentelemetry/sdk-metrics';
+declare class FileExporter {
+    protected writeStream: fs.WriteStream;
+    constructor(filePath: string);
+    protected serialize(data: unknown): string;
+    shutdown(): Promise<void>;
+}
+export declare class FileSpanExporter extends FileExporter implements SpanExporter {
+    export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void;
+}
+export declare class FileLogExporter extends FileExporter implements LogRecordExporter {
+    export(logs: ReadableLogRecord[], resultCallback: (result: ExportResult) => void): void;
+}
+export declare class FileMetricExporter extends FileExporter implements PushMetricExporter {
+    export(metrics: ResourceMetrics, resultCallback: (result: ExportResult) => void): void;
+    getPreferredAggregationTemporality(): AggregationTemporality;
+    forceFlush(): Promise<void>;
+}
+export {};

package/dist/src/telemetry/file-exporters.js

@@ -0,0 +1,62 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs';
+import { ExportResultCode } from '@opentelemetry/core';
+import { AggregationTemporality, } from '@opentelemetry/sdk-metrics';
+class FileExporter {
+    writeStream;
+    constructor(filePath) {
+        this.writeStream = fs.createWriteStream(filePath, { flags: 'a' });
+    }
+    serialize(data) {
+        return JSON.stringify(data, null, 2) + '\n';
+    }
+    shutdown() {
+        return new Promise((resolve) => {
+            this.writeStream.end(resolve);
+        });
+    }
+}
+export class FileSpanExporter extends FileExporter {
+    export(spans, resultCallback) {
+        const data = spans.map((span) => this.serialize(span)).join('');
+        this.writeStream.write(data, (err) => {
+            resultCallback({
+                code: err ? ExportResultCode.FAILED : ExportResultCode.SUCCESS,
+                error: err || undefined,
+            });
+        });
+    }
+}
+export class FileLogExporter extends FileExporter {
+    export(logs, resultCallback) {
+        const data = logs.map((log) => this.serialize(log)).join('');
+        this.writeStream.write(data, (err) => {
+            resultCallback({
+                code: err ? ExportResultCode.FAILED : ExportResultCode.SUCCESS,
+                error: err || undefined,
+            });
+        });
+    }
+}
+export class FileMetricExporter extends FileExporter {
+    export(metrics, resultCallback) {
+        const data = this.serialize(metrics);
+        this.writeStream.write(data, (err) => {
+            resultCallback({
+                code: err ? ExportResultCode.FAILED : ExportResultCode.SUCCESS,
+                error: err || undefined,
+            });
+        });
+    }
+    getPreferredAggregationTemporality() {
+        return AggregationTemporality.CUMULATIVE;
+    }
+    async forceFlush() {
+        return Promise.resolve();
+    }
+}
+//# sourceMappingURL=file-exporters.js.map

package/dist/src/telemetry/file-exporters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-exporters.js","sourceRoot":"","sources":["../../../src/telemetry/file-exporters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAgB,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGrE,OAAO,EAGL,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,YAAY;IACN,WAAW,CAAiB;IAEtC,YAAY,QAAgB;QAC1B,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC,iBAAiB,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IACpE,CAAC;IAES,SAAS,CAAC,IAAa;QAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9C,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IAChD,MAAM,CACJ,KAAqB,EACrB,cAA8C;QAE9C,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;YACnC,cAAc,CAAC;gBACb,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO;gBAC9D,KAAK,EAAE,GAAG,IAAI,SAAS;aACxB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,YAAY;IAC/C,MAAM,CACJ,IAAyB,EACzB,cAA8C;QAE9C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;YACnC,cAAc,CAAC;gBACb,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO;gBAC9D,KAAK,EAAE,GAAG,IAAI,SAAS;aACxB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,OAAO,kBACX,SAAQ,YAAY;IAGpB,MAAM,CACJ,OAAwB,EACxB,cAA8C;QAE9C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;YACnC,cAAc,CAAC;gBACb,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO;gBAC9D,KAAK,EAAE,GAAG,IAAI,SAAS;aACxB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,kCAAkC;QAChC,OAAO,sBAAsB,CAAC,UAAU,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;CACF"}

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

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare enum TelemetryTarget {
+    GCP = "gcp",
+    LOCAL = "local"
+}
+declare const DEFAULT_TELEMETRY_TARGET = TelemetryTarget.LOCAL;
+declare const DEFAULT_OTLP_ENDPOINT = "http://localhost:4317";
+export { DEFAULT_TELEMETRY_TARGET, DEFAULT_OTLP_ENDPOINT };
+export { initializeTelemetry, shutdownTelemetry, isTelemetrySdkInitialized, } from './sdk.js';
+export { logCliConfiguration, logUserPrompt, logToolCall, logApiRequest, logApiError, logApiResponse, logFlashFallback, logSlashCommand, } from './loggers.js';
+export { StartSessionEvent, EndSessionEvent, UserPromptEvent, ToolCallEvent, ApiRequestEvent, ApiErrorEvent, ApiResponseEvent, TelemetryEvent, FlashFallbackEvent, SlashCommandEvent, } from './types.js';
+export { SpanStatusCode, ValueType } from '@opentelemetry/api';
+export { SemanticAttributes } from '@opentelemetry/semantic-conventions';
+export * from './uiTelemetry.js';

package/dist/src/telemetry/index.js

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export var TelemetryTarget;
+(function (TelemetryTarget) {
+    TelemetryTarget["GCP"] = "gcp";
+    TelemetryTarget["LOCAL"] = "local";
+})(TelemetryTarget || (TelemetryTarget = {}));
+const DEFAULT_TELEMETRY_TARGET = TelemetryTarget.LOCAL;
+const DEFAULT_OTLP_ENDPOINT = 'http://localhost:4317';
+export { DEFAULT_TELEMETRY_TARGET, DEFAULT_OTLP_ENDPOINT };
+export { initializeTelemetry, shutdownTelemetry, isTelemetrySdkInitialized, } from './sdk.js';
+export { logCliConfiguration, logUserPrompt, logToolCall, logApiRequest, logApiError, logApiResponse, logFlashFallback, logSlashCommand, } from './loggers.js';
+export { StartSessionEvent, EndSessionEvent, UserPromptEvent, ToolCallEvent, ApiRequestEvent, ApiErrorEvent, ApiResponseEvent, FlashFallbackEvent, SlashCommandEvent, } from './types.js';
+export { SpanStatusCode, ValueType } from '@opentelemetry/api';
+export { SemanticAttributes } from '@opentelemetry/semantic-conventions';
+export * from './uiTelemetry.js';
+//# sourceMappingURL=index.js.map

package/dist/src/telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,8BAAW,CAAA;IACX,kCAAe,CAAA;AACjB,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B;AAED,MAAM,wBAAwB,GAAG,eAAe,CAAC,KAAK,CAAC;AACvD,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAEtD,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,CAAC;AAC3D,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,aAAa,EACb,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,aAAa,EACb,eAAe,EACf,aAAa,EACb,gBAAgB,EAEhB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,cAAc,kBAAkB,CAAC"}