@google/gemini-cli-core 0.0.3-preview.4

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

@@ -0,0 +1,121 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { HttpsProxyAgent } from 'https-proxy-agent';
+import type { StartSessionEvent, UserPromptEvent, ToolCallEvent, ApiRequestEvent, ApiResponseEvent, ApiErrorEvent, LoopDetectedEvent, NextSpeakerCheckEvent, SlashCommandEvent, MalformedJsonResponseEvent, IdeConnectionEvent, ConversationFinishedEvent, KittySequenceOverflowEvent, ChatCompressionEvent, FileOperationEvent, InvalidChunkEvent, ContentRetryEvent, ContentRetryFailureEvent } from '../types.js';
+import { EventMetadataKey } from './event-metadata-key.js';
+import type { Config } from '../../config/config.js';
+export declare enum EventNames {
+    START_SESSION = "start_session",
+    NEW_PROMPT = "new_prompt",
+    TOOL_CALL = "tool_call",
+    FILE_OPERATION = "file_operation",
+    API_REQUEST = "api_request",
+    API_RESPONSE = "api_response",
+    API_ERROR = "api_error",
+    END_SESSION = "end_session",
+    FLASH_FALLBACK = "flash_fallback",
+    LOOP_DETECTED = "loop_detected",
+    NEXT_SPEAKER_CHECK = "next_speaker_check",
+    SLASH_COMMAND = "slash_command",
+    MALFORMED_JSON_RESPONSE = "malformed_json_response",
+    IDE_CONNECTION = "ide_connection",
+    KITTY_SEQUENCE_OVERFLOW = "kitty_sequence_overflow",
+    CHAT_COMPRESSION = "chat_compression",
+    CONVERSATION_FINISHED = "conversation_finished",
+    INVALID_CHUNK = "invalid_chunk",
+    CONTENT_RETRY = "content_retry",
+    CONTENT_RETRY_FAILURE = "content_retry_failure"
+}
+export interface LogResponse {
+    nextRequestWaitMs?: number;
+}
+export interface LogEventEntry {
+    event_time_ms: number;
+    source_extension_json: string;
+}
+export interface EventValue {
+    gemini_cli_key: EventMetadataKey;
+    value: string;
+}
+export interface LogEvent {
+    console_type: 'GEMINI_CLI';
+    application: number;
+    event_name: string;
+    event_metadata: EventValue[][];
+    client_email?: string;
+    client_install_id?: string;
+}
+export interface LogRequest {
+    log_source_name: 'CONCORD';
+    request_time_ms: number;
+    log_event: LogEventEntry[][];
+}
+export declare class ClearcutLogger {
+    private static instance;
+    private config?;
+    private sessionData;
+    private promptId;
+    private readonly installationManager;
+    private readonly userAccountManager;
+    /**
+     * Queue of pending events that need to be flushed to the server.  New events
+     * are added to this queue and then flushed on demand (via `flushToClearcut`)
+     */
+    private readonly events;
+    /**
+     * The last time that the events were successfully flushed to the server.
+     */
+    private lastFlushTime;
+    /**
+     * the value is true when there is a pending flush happening. This prevents
+     * concurrent flush operations.
+     */
+    private flushing;
+    /**
+     * This value is true when a flush was requested during an ongoing flush.
+     */
+    private pendingFlush;
+    private constructor();
+    static getInstance(config?: Config): ClearcutLogger | undefined;
+    /** For testing purposes only. */
+    static clearInstance(): void;
+    enqueueLogEvent(event: LogEvent): void;
+    createLogEvent(eventName: EventNames, data?: EventValue[]): LogEvent;
+    flushIfNeeded(): void;
+    flushToClearcut(): Promise<LogResponse>;
+    logStartSessionEvent(event: StartSessionEvent): void;
+    logNewPromptEvent(event: UserPromptEvent): void;
+    logToolCallEvent(event: ToolCallEvent): void;
+    logFileOperationEvent(event: FileOperationEvent): void;
+    logApiRequestEvent(event: ApiRequestEvent): void;
+    logApiResponseEvent(event: ApiResponseEvent): void;
+    logApiErrorEvent(event: ApiErrorEvent): void;
+    logChatCompressionEvent(event: ChatCompressionEvent): void;
+    logFlashFallbackEvent(): void;
+    logLoopDetectedEvent(event: LoopDetectedEvent): void;
+    logNextSpeakerCheck(event: NextSpeakerCheckEvent): void;
+    logSlashCommandEvent(event: SlashCommandEvent): void;
+    logMalformedJsonResponseEvent(event: MalformedJsonResponseEvent): void;
+    logIdeConnectionEvent(event: IdeConnectionEvent): void;
+    logConversationFinishedEvent(event: ConversationFinishedEvent): void;
+    logKittySequenceOverflowEvent(event: KittySequenceOverflowEvent): void;
+    logEndSessionEvent(): void;
+    logInvalidChunkEvent(event: InvalidChunkEvent): void;
+    logContentRetryEvent(event: ContentRetryEvent): void;
+    logContentRetryFailureEvent(event: ContentRetryFailureEvent): void;
+    /**
+     * Adds default fields to data, and returns a new data array.  This fields
+     * should exist on all log events.
+     */
+    addDefaultFields(data: EventValue[], totalAccounts: number): EventValue[];
+    getProxyAgent(): HttpsProxyAgent<string> | undefined;
+    shutdown(): void;
+    private requeueFailedEvents;
+}
+export declare const TEST_ONLY: {
+    MAX_RETRY_EVENTS: number;
+    MAX_EVENTS: number;
+};