@blackbox_ai/blackbox-cli-core 0.0.4

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

@@ -0,0 +1,229 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// Defines valid event metadata keys for Blackbox 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";
+    // Logs the Gemini CLI version
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_VERSION"] = 54] = "GEMINI_CLI_VERSION";
+    // Logs the Gemini CLI Git commit hash
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_GIT_COMMIT_HASH"] = 55] = "GEMINI_CLI_GIT_COMMIT_HASH";
+    // Logs the Gemini CLI OS
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_OS"] = 82] = "GEMINI_CLI_OS";
+    // ==========================================================================
+    // 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";
+    // Logs the status of the slash command (e.g. 'success', 'error')
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_SLASH_COMMAND_STATUS"] = 51] = "GEMINI_CLI_SLASH_COMMAND_STATUS";
+    // ==========================================================================
+    // 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";
+    // ==========================================================================
+    // Kitty Sequence Overflow Event Keys
+    // ===========================================================================
+    // Logs the truncated kitty sequence.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_KITTY_TRUNCATED_SEQUENCE"] = 52] = "GEMINI_CLI_KITTY_TRUNCATED_SEQUENCE";
+    // Logs the length of the kitty sequence that overflowed.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_KITTY_SEQUENCE_LENGTH"] = 53] = "GEMINI_CLI_KITTY_SEQUENCE_LENGTH";
+    // ==========================================================================
+    // Conversation Finished Event Keys
+    // ===========================================================================
+    // Logs the approval mode of the session.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_APPROVAL_MODE"] = 58] = "GEMINI_CLI_APPROVAL_MODE";
+    // Logs the number of turns
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_CONVERSATION_TURN_COUNT"] = 59] = "GEMINI_CLI_CONVERSATION_TURN_COUNT";
+    // Logs the number of tokens before context window compression.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_COMPRESSION_TOKENS_BEFORE"] = 60] = "GEMINI_CLI_COMPRESSION_TOKENS_BEFORE";
+    // Logs the number of tokens after context window compression.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_COMPRESSION_TOKENS_AFTER"] = 61] = "GEMINI_CLI_COMPRESSION_TOKENS_AFTER";
+    // Logs tool type whether it is mcp or native.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_TOOL_TYPE"] = 62] = "GEMINI_CLI_TOOL_TYPE";
+    // Logs count of MCP servers in Start Session Event
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_START_SESSION_MCP_SERVERS_COUNT"] = 63] = "GEMINI_CLI_START_SESSION_MCP_SERVERS_COUNT";
+    // Logs count of MCP tools in Start Session Event
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_START_SESSION_MCP_TOOLS_COUNT"] = 64] = "GEMINI_CLI_START_SESSION_MCP_TOOLS_COUNT";
+    // Logs name of MCP tools as comma separated string
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_START_SESSION_MCP_TOOLS"] = 65] = "GEMINI_CLI_START_SESSION_MCP_TOOLS";
+    // ==========================================================================
+    // Research Event Keys
+    // ===========================================================================
+    // Logs the research opt-in status (true/false)
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_RESEARCH_OPT_IN_STATUS"] = 66] = "GEMINI_CLI_RESEARCH_OPT_IN_STATUS";
+    // Logs the contact email for research participation
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_RESEARCH_CONTACT_EMAIL"] = 67] = "GEMINI_CLI_RESEARCH_CONTACT_EMAIL";
+    // Logs the user ID for research events
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_RESEARCH_USER_ID"] = 68] = "GEMINI_CLI_RESEARCH_USER_ID";
+    // Logs the type of research feedback
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_RESEARCH_FEEDBACK_TYPE"] = 69] = "GEMINI_CLI_RESEARCH_FEEDBACK_TYPE";
+    // Logs the content of research feedback
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_RESEARCH_FEEDBACK_CONTENT"] = 70] = "GEMINI_CLI_RESEARCH_FEEDBACK_CONTENT";
+    // Logs survey responses for research feedback (JSON stringified)
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_RESEARCH_SURVEY_RESPONSES"] = 71] = "GEMINI_CLI_RESEARCH_SURVEY_RESPONSES";
+    // ==========================================================================
+    // File Operation Event Keys
+    // ===========================================================================
+    // Logs the programming language of the project.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_PROGRAMMING_LANGUAGE"] = 56] = "GEMINI_CLI_PROGRAMMING_LANGUAGE";
+    // Logs the operation type of the file operation.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_FILE_OPERATION_TYPE"] = 57] = "GEMINI_CLI_FILE_OPERATION_TYPE";
+    // Logs the number of lines in the file operation.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_FILE_OPERATION_LINES"] = 72] = "GEMINI_CLI_FILE_OPERATION_LINES";
+    // Logs the mimetype of the file in the file operation.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_FILE_OPERATION_MIMETYPE"] = 73] = "GEMINI_CLI_FILE_OPERATION_MIMETYPE";
+    // Logs the extension of the file in the file operation.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_FILE_OPERATION_EXTENSION"] = 74] = "GEMINI_CLI_FILE_OPERATION_EXTENSION";
+    // ==========================================================================
+    // Content Streaming Event Keys
+    // ===========================================================================
+    // Logs the error message for an invalid chunk.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_INVALID_CHUNK_ERROR_MESSAGE"] = 75] = "GEMINI_CLI_INVALID_CHUNK_ERROR_MESSAGE";
+    // Logs the attempt number for a content retry.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_CONTENT_RETRY_ATTEMPT_NUMBER"] = 76] = "GEMINI_CLI_CONTENT_RETRY_ATTEMPT_NUMBER";
+    // Logs the error type for a content retry.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_CONTENT_RETRY_ERROR_TYPE"] = 77] = "GEMINI_CLI_CONTENT_RETRY_ERROR_TYPE";
+    // Logs the delay in milliseconds for a content retry.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_CONTENT_RETRY_DELAY_MS"] = 78] = "GEMINI_CLI_CONTENT_RETRY_DELAY_MS";
+    // Logs the total number of attempts for a content retry failure.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_CONTENT_RETRY_FAILURE_TOTAL_ATTEMPTS"] = 79] = "GEMINI_CLI_CONTENT_RETRY_FAILURE_TOTAL_ATTEMPTS";
+    // Logs the final error type for a content retry failure.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_CONTENT_RETRY_FAILURE_FINAL_ERROR_TYPE"] = 80] = "GEMINI_CLI_CONTENT_RETRY_FAILURE_FINAL_ERROR_TYPE";
+    // Logs the total duration in milliseconds for a content retry failure.
+    EventMetadataKey[EventMetadataKey["GEMINI_CLI_CONTENT_RETRY_FAILURE_TOTAL_DURATION_MS"] = 81] = "GEMINI_CLI_CONTENT_RETRY_FAILURE_TOTAL_DURATION_MS";
+})(EventMetadataKey || (EventMetadataKey = {}));
+//# 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,34 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const SERVICE_NAME = "blackbox-cli";
+export declare const EVENT_USER_PROMPT = "blackbox-cli.user_prompt";
+export declare const EVENT_TOOL_CALL = "blackbox-cli.tool_call";
+export declare const EVENT_API_REQUEST = "blackbox-cli.api_request";
+export declare const EVENT_API_ERROR = "blackbox-cli.api_error";
+export declare const EVENT_API_RESPONSE = "blackbox-cli.api_response";
+export declare const EVENT_CLI_CONFIG = "blackbox-cli.config";
+export declare const EVENT_FLASH_FALLBACK = "blackbox-cli.flash_fallback";
+export declare const EVENT_NEXT_SPEAKER_CHECK = "blackbox-cli.next_speaker_check";
+export declare const EVENT_SLASH_COMMAND = "blackbox-cli.slash_command";
+export declare const EVENT_IDE_CONNECTION = "blackbox-cli.ide_connection";
+export declare const EVENT_CHAT_COMPRESSION = "blackbox-cli.chat_compression";
+export declare const EVENT_INVALID_CHUNK = "blackbox-cli.chat.invalid_chunk";
+export declare const EVENT_CONTENT_RETRY = "blackbox-cli.chat.content_retry";
+export declare const EVENT_CONTENT_RETRY_FAILURE = "blackbox-cli.chat.content_retry_failure";
+export declare const EVENT_CONVERSATION_FINISHED = "blackbox-cli.conversation_finished";
+export declare const EVENT_MALFORMED_JSON_RESPONSE = "blackbox-cli.malformed_json_response";
+export declare const EVENT_SUBAGENT_EXECUTION = "blackbox-cli.subagent_execution";
+export declare const METRIC_TOOL_CALL_COUNT = "blackbox-cli.tool.call.count";
+export declare const METRIC_TOOL_CALL_LATENCY = "blackbox-cli.tool.call.latency";
+export declare const METRIC_API_REQUEST_COUNT = "blackbox-cli.api.request.count";
+export declare const METRIC_API_REQUEST_LATENCY = "blackbox-cli.api.request.latency";
+export declare const METRIC_TOKEN_USAGE = "blackbox-cli.token.usage";
+export declare const METRIC_SESSION_COUNT = "blackbox-cli.session.count";
+export declare const METRIC_FILE_OPERATION_COUNT = "blackbox-cli.file.operation.count";
+export declare const METRIC_INVALID_CHUNK_COUNT = "blackbox-cli.chat.invalid_chunk.count";
+export declare const METRIC_CONTENT_RETRY_COUNT = "blackbox-cli.chat.content_retry.count";
+export declare const METRIC_CONTENT_RETRY_FAILURE_COUNT = "blackbox-cli.chat.content_retry_failure.count";
+export declare const METRIC_SUBAGENT_EXECUTION_COUNT = "blackbox-cli.subagent.execution.count";

package/dist/src/telemetry/constants.js

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export const SERVICE_NAME = 'blackbox-cli';
+export const EVENT_USER_PROMPT = 'blackbox-cli.user_prompt';
+export const EVENT_TOOL_CALL = 'blackbox-cli.tool_call';
+export const EVENT_API_REQUEST = 'blackbox-cli.api_request';
+export const EVENT_API_ERROR = 'blackbox-cli.api_error';
+export const EVENT_API_RESPONSE = 'blackbox-cli.api_response';
+export const EVENT_CLI_CONFIG = 'blackbox-cli.config';
+export const EVENT_FLASH_FALLBACK = 'blackbox-cli.flash_fallback';
+export const EVENT_NEXT_SPEAKER_CHECK = 'blackbox-cli.next_speaker_check';
+export const EVENT_SLASH_COMMAND = 'blackbox-cli.slash_command';
+export const EVENT_IDE_CONNECTION = 'blackbox-cli.ide_connection';
+export const EVENT_CHAT_COMPRESSION = 'blackbox-cli.chat_compression';
+export const EVENT_INVALID_CHUNK = 'blackbox-cli.chat.invalid_chunk';
+export const EVENT_CONTENT_RETRY = 'blackbox-cli.chat.content_retry';
+export const EVENT_CONTENT_RETRY_FAILURE = 'blackbox-cli.chat.content_retry_failure';
+export const EVENT_CONVERSATION_FINISHED = 'blackbox-cli.conversation_finished';
+export const EVENT_MALFORMED_JSON_RESPONSE = 'blackbox-cli.malformed_json_response';
+export const EVENT_SUBAGENT_EXECUTION = 'blackbox-cli.subagent_execution';
+export const METRIC_TOOL_CALL_COUNT = 'blackbox-cli.tool.call.count';
+export const METRIC_TOOL_CALL_LATENCY = 'blackbox-cli.tool.call.latency';
+export const METRIC_API_REQUEST_COUNT = 'blackbox-cli.api.request.count';
+export const METRIC_API_REQUEST_LATENCY = 'blackbox-cli.api.request.latency';
+export const METRIC_TOKEN_USAGE = 'blackbox-cli.token.usage';
+export const METRIC_SESSION_COUNT = 'blackbox-cli.session.count';
+export const METRIC_FILE_OPERATION_COUNT = 'blackbox-cli.file.operation.count';
+export const METRIC_INVALID_CHUNK_COUNT = 'blackbox-cli.chat.invalid_chunk.count';
+export const METRIC_CONTENT_RETRY_COUNT = 'blackbox-cli.chat.content_retry.count';
+export const METRIC_CONTENT_RETRY_FAILURE_COUNT = 'blackbox-cli.chat.content_retry_failure.count';
+export const METRIC_SUBAGENT_EXECUTION_COUNT = 'blackbox-cli.subagent.execution.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,cAAc,CAAC;AAE3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AAC5D,MAAM,CAAC,MAAM,eAAe,GAAG,wBAAwB,CAAC;AACxD,MAAM,CAAC,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AAC5D,MAAM,CAAC,MAAM,eAAe,GAAG,wBAAwB,CAAC;AACxD,MAAM,CAAC,MAAM,kBAAkB,GAAG,2BAA2B,CAAC;AAC9D,MAAM,CAAC,MAAM,gBAAgB,GAAG,qBAAqB,CAAC;AACtD,MAAM,CAAC,MAAM,oBAAoB,GAAG,6BAA6B,CAAC;AAClE,MAAM,CAAC,MAAM,wBAAwB,GAAG,iCAAiC,CAAC;AAC1E,MAAM,CAAC,MAAM,mBAAmB,GAAG,4BAA4B,CAAC;AAChE,MAAM,CAAC,MAAM,oBAAoB,GAAG,6BAA6B,CAAC;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG,+BAA+B,CAAC;AACtE,MAAM,CAAC,MAAM,mBAAmB,GAAG,iCAAiC,CAAC;AACrE,MAAM,CAAC,MAAM,mBAAmB,GAAG,iCAAiC,CAAC;AACrE,MAAM,CAAC,MAAM,2BAA2B,GACtC,yCAAyC,CAAC;AAC5C,MAAM,CAAC,MAAM,2BAA2B,GAAG,oCAAoC,CAAC;AAChF,MAAM,CAAC,MAAM,6BAA6B,GACxC,sCAAsC,CAAC;AACzC,MAAM,CAAC,MAAM,wBAAwB,GAAG,iCAAiC,CAAC;AAE1E,MAAM,CAAC,MAAM,sBAAsB,GAAG,8BAA8B,CAAC;AACrE,MAAM,CAAC,MAAM,wBAAwB,GAAG,gCAAgC,CAAC;AACzE,MAAM,CAAC,MAAM,wBAAwB,GAAG,gCAAgC,CAAC;AACzE,MAAM,CAAC,MAAM,0BAA0B,GAAG,kCAAkC,CAAC;AAC7E,MAAM,CAAC,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AAC7D,MAAM,CAAC,MAAM,oBAAoB,GAAG,4BAA4B,CAAC;AACjE,MAAM,CAAC,MAAM,2BAA2B,GAAG,mCAAmC,CAAC;AAC/E,MAAM,CAAC,MAAM,0BAA0B,GAAG,uCAAuC,CAAC;AAClF,MAAM,CAAC,MAAM,0BAA0B,GAAG,uCAAuC,CAAC;AAClF,MAAM,CAAC,MAAM,kCAAkC,GAC7C,+CAA+C,CAAC;AAClD,MAAM,CAAC,MAAM,+BAA+B,GAC1C,uCAAuC,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs';
+import type { ExportResult } from '@opentelemetry/core';
+import type { ReadableSpan, SpanExporter } from '@opentelemetry/sdk-trace-base';
+import type { ReadableLogRecord, LogRecordExporter } from '@opentelemetry/sdk-logs';
+import type { ResourceMetrics, PushMetricExporter } from '@opentelemetry/sdk-metrics';
+import { 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;AAE9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAUvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,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,20 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare enum TelemetryTarget {
+    GCP = "gcp",
+    LOCAL = "local",
+    BLACKBOX = "blackbox"
+}
+declare const DEFAULT_TELEMETRY_TARGET = TelemetryTarget.LOCAL;
+declare const DEFAULT_OTLP_ENDPOINT = "http://localhost:4317";
+export { SpanStatusCode, ValueType } from '@opentelemetry/api';
+export { SemanticAttributes } from '@opentelemetry/semantic-conventions';
+export { logApiError, logApiRequest, logApiResponse, logChatCompression, logCliConfiguration, logConversationFinishedEvent, logFlashFallback, logKittySequenceOverflow, logSlashCommand, logToolCall, logUserPrompt, } from './loggers.js';
+export { initializeTelemetry, isTelemetrySdkInitialized, shutdownTelemetry, } from './sdk.js';
+export { ApiErrorEvent, ApiRequestEvent, ApiResponseEvent, ConversationFinishedEvent, EndSessionEvent, FlashFallbackEvent, KittySequenceOverflowEvent, makeChatCompressionEvent, makeSlashCommandEvent, SlashCommandStatus, StartSessionEvent, ToolCallEvent, UserPromptEvent, } from './types.js';
+export type { ChatCompressionEvent, SlashCommandEvent, TelemetryEvent, } from './types.js';
+export * from './uiTelemetry.js';
+export { DEFAULT_OTLP_ENDPOINT, DEFAULT_TELEMETRY_TARGET };

package/dist/src/telemetry/index.js

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export var TelemetryTarget;
+(function (TelemetryTarget) {
+    TelemetryTarget["GCP"] = "gcp";
+    TelemetryTarget["LOCAL"] = "local";
+    TelemetryTarget["BLACKBOX"] = "blackbox";
+})(TelemetryTarget || (TelemetryTarget = {}));
+const DEFAULT_TELEMETRY_TARGET = TelemetryTarget.LOCAL;
+const DEFAULT_OTLP_ENDPOINT = 'http://localhost:4317';
+export { SpanStatusCode, ValueType } from '@opentelemetry/api';
+export { SemanticAttributes } from '@opentelemetry/semantic-conventions';
+export { logApiError, logApiRequest, logApiResponse, logChatCompression, logCliConfiguration, logConversationFinishedEvent, logFlashFallback, logKittySequenceOverflow, logSlashCommand, logToolCall, logUserPrompt, } from './loggers.js';
+export { initializeTelemetry, isTelemetrySdkInitialized, shutdownTelemetry, } from './sdk.js';
+export { ApiErrorEvent, ApiRequestEvent, ApiResponseEvent, ConversationFinishedEvent, EndSessionEvent, FlashFallbackEvent, KittySequenceOverflowEvent, makeChatCompressionEvent, makeSlashCommandEvent, SlashCommandStatus, StartSessionEvent, ToolCallEvent, UserPromptEvent, } from './types.js';
+export * from './uiTelemetry.js';
+export { DEFAULT_OTLP_ENDPOINT, DEFAULT_TELEMETRY_TARGET };
+//# 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,eAIX;AAJD,WAAY,eAAe;IACzB,8BAAW,CAAA;IACX,kCAAe,CAAA;IACf,wCAAqB,CAAA;AACvB,CAAC,EAJW,eAAe,KAAf,eAAe,QAI1B;AAED,MAAM,wBAAwB,GAAG,eAAe,CAAC,KAAK,CAAC;AACvD,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EACL,WAAW,EACX,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,4BAA4B,EAC5B,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,WAAW,EACX,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,yBAAyB,EACzB,eAAe,EACf,kBAAkB,EAClB,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,eAAe,GAChB,MAAM,YAAY,CAAC;AAMpB,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/src/telemetry/integration.test.circular.d.ts

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

package/dist/src/telemetry/integration.test.circular.js

@@ -0,0 +1,95 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Integration test to verify circular reference handling with proxy agents
+ */
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { BlackboxLogger } from './blackbox-logger/blackbox-logger.js';
+describe('Circular Reference Integration Test', () => {
+    beforeEach(() => {
+        // Clear singleton instance before each test
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        BlackboxLogger.instance = undefined;
+    });
+    afterEach(() => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        BlackboxLogger.instance = undefined;
+    });
+    it('should handle HttpsProxyAgent-like circular references in blackbox logging', () => {
+        // Create a mock config with proxy
+        const mockConfig = {
+            getTelemetryEnabled: () => true,
+            getUsageStatisticsEnabled: () => true,
+            getSessionId: () => 'test-session',
+            getModel: () => 'test-model',
+            getEmbeddingModel: () => 'test-embedding',
+            getDebugMode: () => false,
+            getProxy: () => 'http://proxy.example.com:8080',
+        };
+        // Simulate the structure that causes the circular reference error
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const proxyAgentLike = {
+            sockets: {},
+            options: { proxy: 'http://proxy.example.com:8080' },
+        };
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const socketLike = {
+            _httpMessage: {
+                agent: proxyAgentLike,
+                socket: null,
+            },
+        };
+        socketLike._httpMessage.socket = socketLike; // Create circular reference
+        proxyAgentLike.sockets['cloudcode-pa.googleapis.com:443'] = [socketLike];
+        // Create an event that would contain this circular structure
+        const problematicEvent = {
+            timestamp: Date.now(),
+            event_type: 'exception',
+            type: 'error',
+            name: 'api_error',
+            error: new Error('Network error'),
+            function_args: {
+                filePath: '/test/file.txt',
+                httpAgent: proxyAgentLike, // This would cause the circular reference
+            },
+        };
+        // Test that BlackboxLogger can handle this
+        const logger = BlackboxLogger.getInstance(mockConfig);
+        expect(() => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            logger?.enqueueLogEvent(problematicEvent);
+        }).not.toThrow();
+    });
+    it('should handle event overflow without memory leaks', () => {
+        const mockConfig = {
+            getTelemetryEnabled: () => true,
+            getUsageStatisticsEnabled: () => true,
+            getSessionId: () => 'test-session',
+            getDebugMode: () => true,
+        };
+        const logger = BlackboxLogger.getInstance(mockConfig);
+        // Add more events than the maximum capacity
+        for (let i = 0; i < 1100; i++) {
+            logger?.enqueueLogEvent({
+                timestamp: Date.now(),
+                event_type: 'action',
+                type: 'test',
+                name: `overflow-test-${i}`,
+            });
+        }
+        // Logger should still be functional
+        expect(logger).toBeDefined();
+        expect(() => {
+            logger?.enqueueLogEvent({
+                timestamp: Date.now(),
+                event_type: 'action',
+                type: 'test',
+                name: 'final-test',
+            });
+        }).not.toThrow();
+    });
+});
+//# sourceMappingURL=integration.test.circular.js.map

package/dist/src/telemetry/integration.test.circular.js.map

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

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

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+import type { ApiErrorEvent, ApiRequestEvent, ApiResponseEvent, ChatCompressionEvent, ContentRetryEvent, ContentRetryFailureEvent, ConversationFinishedEvent, FileOperationEvent, FlashFallbackEvent, IdeConnectionEvent, InvalidChunkEvent, KittySequenceOverflowEvent, LoopDetectedEvent, NextSpeakerCheckEvent, SlashCommandEvent, StartSessionEvent, SubagentExecutionEvent, 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 logFileOperation(config: Config, event: FileOperationEvent): void;
+export declare function logApiRequest(config: Config, event: ApiRequestEvent): void;
+export declare function logFlashFallback(config: Config, event: FlashFallbackEvent): void;
+export declare function logApiError(config: Config, event: ApiErrorEvent): void;
+export declare function logApiResponse(config: Config, event: ApiResponseEvent): void;
+export declare function logLoopDetected(config: Config, event: LoopDetectedEvent): void;
+export declare function logNextSpeakerCheck(config: Config, event: NextSpeakerCheckEvent): void;
+export declare function logSlashCommand(config: Config, event: SlashCommandEvent): void;
+export declare function logIdeConnection(config: Config, event: IdeConnectionEvent): void;
+export declare function logConversationFinishedEvent(config: Config, event: ConversationFinishedEvent): void;
+export declare function logChatCompression(config: Config, event: ChatCompressionEvent): void;
+export declare function logKittySequenceOverflow(config: Config, event: KittySequenceOverflowEvent): void;
+export declare function logInvalidChunk(config: Config, event: InvalidChunkEvent): void;
+export declare function logContentRetry(config: Config, event: ContentRetryEvent): void;
+export declare function logContentRetryFailure(config: Config, event: ContentRetryFailureEvent): void;
+export declare function logSubagentExecution(config: Config, event: SubagentExecutionEvent): void;