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

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

@@ -0,0 +1,364 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Buffer } from 'buffer';
+import * as https from 'https';
+import { EndSessionEvent, } from '../types.js';
+import { EventMetadataKey } from './event-metadata-key.js';
+import { getInstallationId } from '../../utils/user_id.js';
+import { getGoogleAccountId } from '../../utils/user_id.js';
+const start_session_event_name = 'start_session';
+const new_prompt_event_name = 'new_prompt';
+const tool_call_event_name = 'tool_call';
+const api_request_event_name = 'api_request';
+const api_response_event_name = 'api_response';
+const api_error_event_name = 'api_error';
+const end_session_event_name = 'end_session';
+// Singleton class for batch posting log events to Clearcut. When a new event comes in, the elapsed time
+// is checked and events are flushed to Clearcut if at least a minute has passed since the last flush.
+export class ClearcutLogger {
+    static instance;
+    config;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Clearcut expects this format.
+    events = [];
+    last_flush_time = Date.now();
+    flush_interval_ms = 1000 * 60; // Wait at least a minute before flushing events.
+    constructor(config) {
+        this.config = config;
+    }
+    static getInstance(config) {
+        if (config === undefined || !config?.getUsageStatisticsEnabled())
+            return undefined;
+        if (!ClearcutLogger.instance) {
+            ClearcutLogger.instance = new ClearcutLogger(config);
+        }
+        return ClearcutLogger.instance;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Clearcut expects this format.
+    enqueueLogEvent(event) {
+        this.events.push([
+            {
+                event_time_ms: Date.now(),
+                source_extension_json: JSON.stringify(event),
+            },
+        ]);
+    }
+    createLogEvent(name, data) {
+        return {
+            console_type: 'GEMINI_CLI',
+            application: 102,
+            event_name: name,
+            client_install_id: getInstallationId(),
+            event_metadata: [data],
+        };
+    }
+    flushIfNeeded() {
+        if (Date.now() - this.last_flush_time < this.flush_interval_ms) {
+            return;
+        }
+        // Fire and forget - don't await
+        this.flushToClearcut().catch((error) => {
+            console.debug('Error flushing to Clearcut:', error);
+        });
+    }
+    async flushToClearcut() {
+        if (this.config?.getDebugMode()) {
+            console.log('Flushing log events to Clearcut.');
+        }
+        const eventsToSend = [...this.events];
+        this.events.length = 0;
+        const googleAccountId = await getGoogleAccountId();
+        return new Promise((resolve, reject) => {
+            const request = [
+                {
+                    log_source_name: 'CONCORD',
+                    request_time_ms: Date.now(),
+                    log_event: eventsToSend,
+                    // Add UserInfo with the raw Gaia ID
+                    user_info: googleAccountId
+                        ? {
+                            UserID: googleAccountId,
+                        }
+                        : undefined,
+                },
+            ];
+            const body = JSON.stringify(request);
+            const options = {
+                hostname: 'play.googleapis.com',
+                path: '/log',
+                method: 'POST',
+                headers: { 'Content-Length': Buffer.byteLength(body) },
+            };
+            const bufs = [];
+            const req = https.request(options, (res) => {
+                res.on('data', (buf) => bufs.push(buf));
+                res.on('end', () => {
+                    resolve(Buffer.concat(bufs));
+                });
+            });
+            req.on('error', (e) => {
+                if (this.config?.getDebugMode()) {
+                    console.log('Clearcut POST request error: ', e);
+                }
+                // Add the events back to the front of the queue to be retried.
+                this.events.unshift(...eventsToSend);
+                reject(e);
+            });
+            req.end(body);
+        })
+            .then((buf) => {
+            try {
+                this.last_flush_time = Date.now();
+                return this.decodeLogResponse(buf) || {};
+            }
+            catch (error) {
+                console.error('Error flushing log events:', error);
+                return {};
+            }
+        })
+            .catch((error) => {
+            // Handle all errors to prevent unhandled promise rejections
+            console.error('Error flushing log events:', error);
+            // Return empty response to maintain the Promise<LogResponse> contract
+            return {};
+        });
+    }
+    // Visible for testing. Decodes protobuf-encoded response from Clearcut server.
+    decodeLogResponse(buf) {
+        // TODO(obrienowen): return specific errors to facilitate debugging.
+        if (buf.length < 1) {
+            return undefined;
+        }
+        // The first byte of the buffer is `field<<3 | type`. We're looking for field
+        // 1, with type varint, represented by type=0. If the first byte isn't 8, that
+        // means field 1 is missing or the message is corrupted. Either way, we return
+        // undefined.
+        if (buf.readUInt8(0) !== 8) {
+            return undefined;
+        }
+        let ms = BigInt(0);
+        let cont = true;
+        // In each byte, the most significant bit is the continuation bit. If it's
+        // set, we keep going. The lowest 7 bits, are data bits. They are concatenated
+        // in reverse order to form the final number.
+        for (let i = 1; cont && i < buf.length; i++) {
+            const byte = buf.readUInt8(i);
+            ms |= BigInt(byte & 0x7f) << BigInt(7 * (i - 1));
+            cont = (byte & 0x80) !== 0;
+        }
+        if (cont) {
+            // We have fallen off the buffer without seeing a terminating byte. The
+            // message is corrupted.
+            return undefined;
+        }
+        const returnVal = {
+            nextRequestWaitMs: Number(ms),
+        };
+        return returnVal;
+    }
+    logStartSessionEvent(event) {
+        const data = [
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_START_SESSION_MODEL,
+                value: event.model,
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_START_SESSION_EMBEDDING_MODEL,
+                value: event.embedding_model,
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_START_SESSION_SANDBOX,
+                value: event.sandbox_enabled.toString(),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_START_SESSION_CORE_TOOLS,
+                value: event.core_tools_enabled,
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_START_SESSION_APPROVAL_MODE,
+                value: event.approval_mode,
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_START_SESSION_API_KEY_ENABLED,
+                value: event.api_key_enabled.toString(),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_START_SESSION_VERTEX_API_ENABLED,
+                value: event.vertex_ai_enabled.toString(),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_START_SESSION_DEBUG_MODE_ENABLED,
+                value: event.debug_enabled.toString(),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_START_SESSION_VERTEX_API_ENABLED,
+                value: event.vertex_ai_enabled.toString(),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_START_SESSION_MCP_SERVERS,
+                value: event.mcp_servers,
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_START_SESSION_VERTEX_API_ENABLED,
+                value: event.vertex_ai_enabled.toString(),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_START_SESSION_TELEMETRY_ENABLED,
+                value: event.telemetry_enabled.toString(),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_START_SESSION_TELEMETRY_LOG_USER_PROMPTS_ENABLED,
+                value: event.telemetry_log_user_prompts_enabled.toString(),
+            },
+        ];
+        this.enqueueLogEvent(this.createLogEvent(start_session_event_name, data));
+        // Flush start event immediately
+        this.flushToClearcut().catch((error) => {
+            console.debug('Error flushing start session event to Clearcut:', error);
+        });
+    }
+    logNewPromptEvent(event) {
+        const data = [
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_USER_PROMPT_LENGTH,
+                value: JSON.stringify(event.prompt_length),
+            },
+        ];
+        this.enqueueLogEvent(this.createLogEvent(new_prompt_event_name, data));
+        this.flushToClearcut().catch((error) => {
+            console.debug('Error flushing to Clearcut:', error);
+        });
+    }
+    logToolCallEvent(event) {
+        const data = [
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_TOOL_CALL_NAME,
+                value: JSON.stringify(event.function_name),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_TOOL_CALL_DECISION,
+                value: JSON.stringify(event.decision),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_TOOL_CALL_SUCCESS,
+                value: JSON.stringify(event.success),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_TOOL_CALL_DURATION_MS,
+                value: JSON.stringify(event.duration_ms),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_TOOL_ERROR_MESSAGE,
+                value: JSON.stringify(event.error),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_TOOL_CALL_ERROR_TYPE,
+                value: JSON.stringify(event.error_type),
+            },
+        ];
+        this.enqueueLogEvent(this.createLogEvent(tool_call_event_name, data));
+        this.flushToClearcut().catch((error) => {
+            console.debug('Error flushing to Clearcut:', error);
+        });
+    }
+    logApiRequestEvent(event) {
+        const data = [
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_API_REQUEST_MODEL,
+                value: JSON.stringify(event.model),
+            },
+        ];
+        this.enqueueLogEvent(this.createLogEvent(api_request_event_name, data));
+        this.flushToClearcut().catch((error) => {
+            console.debug('Error flushing to Clearcut:', error);
+        });
+    }
+    logApiResponseEvent(event) {
+        const data = [
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_API_RESPONSE_MODEL,
+                value: JSON.stringify(event.model),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_API_RESPONSE_STATUS_CODE,
+                value: JSON.stringify(event.status_code),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_API_RESPONSE_DURATION_MS,
+                value: JSON.stringify(event.duration_ms),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_API_ERROR_MESSAGE,
+                value: JSON.stringify(event.error),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_API_RESPONSE_INPUT_TOKEN_COUNT,
+                value: JSON.stringify(event.input_token_count),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_API_RESPONSE_OUTPUT_TOKEN_COUNT,
+                value: JSON.stringify(event.output_token_count),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_API_RESPONSE_CACHED_TOKEN_COUNT,
+                value: JSON.stringify(event.cached_content_token_count),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_API_RESPONSE_THINKING_TOKEN_COUNT,
+                value: JSON.stringify(event.thoughts_token_count),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_API_RESPONSE_TOOL_TOKEN_COUNT,
+                value: JSON.stringify(event.tool_token_count),
+            },
+        ];
+        this.enqueueLogEvent(this.createLogEvent(api_response_event_name, data));
+        this.flushToClearcut().catch((error) => {
+            console.debug('Error flushing to Clearcut:', error);
+        });
+    }
+    logApiErrorEvent(event) {
+        const data = [
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_API_ERROR_MODEL,
+                value: JSON.stringify(event.model),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_API_ERROR_TYPE,
+                value: JSON.stringify(event.error_type),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_API_ERROR_STATUS_CODE,
+                value: JSON.stringify(event.status_code),
+            },
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_API_ERROR_DURATION_MS,
+                value: JSON.stringify(event.duration_ms),
+            },
+        ];
+        this.enqueueLogEvent(this.createLogEvent(api_error_event_name, data));
+        this.flushToClearcut().catch((error) => {
+            console.debug('Error flushing to Clearcut:', error);
+        });
+    }
+    logEndSessionEvent(event) {
+        const data = [
+            {
+                gemini_cli_key: EventMetadataKey.GEMINI_CLI_END_SESSION_ID,
+                value: event?.session_id?.toString() ?? '',
+            },
+        ];
+        this.enqueueLogEvent(this.createLogEvent(end_session_event_name, data));
+        // Flush immediately on session end.
+        this.flushToClearcut().catch((error) => {
+            console.debug('Error flushing to Clearcut:', error);
+        });
+    }
+    shutdown() {
+        const event = new EndSessionEvent(this.config);
+        this.logEndSessionEvent(event);
+    }
+}
+//# sourceMappingURL=clearcut-logger.js.map

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

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

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

@@ -0,0 +1,43 @@
+/**
+ * @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
+}
+export declare function getEventMetadataKey(keyName: string): EventMetadataKey | undefined;

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

@@ -0,0 +1,109 @@
+/**
+ * @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";
+})(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":"AAAA;;;;GAIG;AAEH,0DAA0D;AAC1D,MAAM,CAAN,IAAY,gBAoIX;AApID,WAAY,gBAAgB;IAC1B,2FAA0B,CAAA;IAE1B,6EAA6E;IAC7E,2BAA2B;IAC3B,8EAA8E;IAE9E,yCAAyC;IACzC,2GAAkC,CAAA;IAElC,mDAAmD;IACnD,+HAA4C,CAAA;IAE5C,iDAAiD;IACjD,+GAAoC,CAAA;IAEpC,wDAAwD;IACxD,qHAAuC,CAAA;IAEvC,uDAAuD;IACvD,2HAA0C,CAAA;IAE1C,mDAAmD;IACnD,+HAA4C,CAAA;IAE5C,uDAAuD;IACvD,qIAA+C,CAAA;IAE/C,sDAAsD;IACtD,qIAA+C,CAAA;IAE/C,yDAAyD;IACzD,uHAAwC,CAAA;IAExC,oEAAoE;IACpE,oIAA+C,CAAA;IAE/C,2EAA2E;IAC3E,sKAAgE,CAAA;IAEhE,sEAAsE;IACtE,oIAA+C,CAAA;IAE/C,6EAA6E;IAC7E,yBAAyB;IACzB,8EAA8E;IAE9E,iCAAiC;IACjC,0GAAkC,CAAA;IAElC,6EAA6E;IAC7E,uBAAuB;IACvB,8EAA8E;IAE9E,0BAA0B;IAC1B,kGAA8B,CAAA;IAE9B,8DAA8D;IAC9D,0GAAkC,CAAA;IAElC,wCAAwC;IACxC,wGAAiC,CAAA;IAEjC,+CAA+C;IAC/C,gHAAqC,CAAA;IAErC,4CAA4C;IAC5C,0GAAkC,CAAA;IAElC,yCAAyC;IACzC,8GAAoC,CAAA;IAEpC,6EAA6E;IAC7E,+BAA+B;IAC/B,8EAA8E;IAE9E,oCAAoC;IACpC,wGAAiC,CAAA;IAEjC,6EAA6E;IAC7E,gCAAgC;IAChC,8EAA8E;IAE9E,qCAAqC;IACrC,0GAAkC,CAAA;IAElC,wCAAwC;IACxC,sHAAwC,CAAA;IAExC,qDAAqD;IACrD,sHAAwC,CAAA;IAExC,kDAAkD;IAClD,wGAAiC,CAAA;IAEjC,8CAA8C;IAC9C,kIAA8C,CAAA;IAE9C,+CAA+C;IAC/C,oIAA+C,CAAA;IAE/C,+CAA+C;IAC/C,oIAA+C,CAAA;IAE/C,iDAAiD;IACjD,wIAAiD,CAAA;IAEjD,iDAAiD;IACjD,gIAA6C,CAAA;IAE7C,6EAA6E;IAC7E,6BAA6B;IAC7B,8EAA8E;IAE9E,qCAAqC;IACrC,oGAA+B,CAAA;IAE/B,uBAAuB;IACvB,kGAA8B,CAAA;IAE9B,8CAA8C;IAC9C,gHAAqC,CAAA;IAErC,qDAAqD;IACrD,gHAAqC,CAAA;IAErC,6EAA6E;IAC7E,yBAAyB;IACzB,8EAA8E;IAE9E,6BAA6B;IAC7B,kGAA8B,CAAA;AAChC,CAAC,EApIW,gBAAgB,KAAhB,gBAAgB,QAoI3B;AAED,MAAM,UAAU,mBAAmB,CACjC,OAAe;IAEf,4CAA4C;IAC5C,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAwC,CAAC,CAAC;IAEvE,6EAA6E;IAC7E,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * @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 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,20 @@
+/**
+ * @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 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;AAEpD,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/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, } from './loggers.js';
+export { StartSessionEvent, EndSessionEvent, UserPromptEvent, ToolCallEvent, ApiRequestEvent, ApiErrorEvent, ApiResponseEvent, TelemetryEvent, } 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, } from './loggers.js';
+export { StartSessionEvent, EndSessionEvent, UserPromptEvent, ToolCallEvent, ApiRequestEvent, ApiErrorEvent, ApiResponseEvent, } 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,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,aAAa,EACb,eAAe,EACf,aAAa,EACb,gBAAgB,GAEjB,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"}

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

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Config } from '../config/config.js';
+import { ApiErrorEvent, ApiRequestEvent, ApiResponseEvent, StartSessionEvent, ToolCallEvent, UserPromptEvent } from './types.js';
+export declare function logCliConfiguration(config: Config, event: StartSessionEvent): void;
+export declare function logUserPrompt(config: Config, event: UserPromptEvent): void;
+export declare function logToolCall(config: Config, event: ToolCallEvent): void;
+export declare function logApiRequest(config: Config, event: ApiRequestEvent): void;
+export declare function logApiError(config: Config, event: ApiErrorEvent): void;
+export declare function logApiResponse(config: Config, event: ApiResponseEvent): void;