@office-ai/aioncli-core 0.1.21 → 0.2.3

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

@@ -3,11 +3,27 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Buffer } from 'buffer';
 import { HttpsProxyAgent } from 'https-proxy-agent';
-import { StartSessionEvent, EndSessionEvent, UserPromptEvent, ToolCallEvent, ApiRequestEvent, ApiResponseEvent, ApiErrorEvent, FlashFallbackEvent, LoopDetectedEvent, NextSpeakerCheckEvent, SlashCommandEvent, MalformedJsonResponseEvent, IdeConnectionEvent } from '../types.js';
+import { StartSessionEvent, UserPromptEvent, ToolCallEvent, ApiRequestEvent, ApiResponseEvent, ApiErrorEvent, LoopDetectedEvent, NextSpeakerCheckEvent, SlashCommandEvent, MalformedJsonResponseEvent, IdeConnectionEvent, KittySequenceOverflowEvent, ChatCompressionEvent } from '../types.js';
 import { EventMetadataKey } from './event-metadata-key.js';
 import { Config } from '../../config/config.js';
+export declare enum EventNames {
+    START_SESSION = "start_session",
+    NEW_PROMPT = "new_prompt",
+    TOOL_CALL = "tool_call",
+    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"
+}
 export interface LogResponse {
     nextRequestWaitMs?: number;
 }
@@ -15,51 +31,79 @@ export interface LogEventEntry {
     event_time_ms: number;
     source_extension_json: string;
 }
-export type EventValue = {
-    gemini_cli_key: EventMetadataKey | string;
+export interface EventValue {
+    gemini_cli_key: EventMetadataKey;
     value: string;
-};
-export type LogEvent = {
-    console_type: 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;
+    /**
+     * 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;
-    private last_flush_time;
-    private flush_interval_ms;
-    private readonly max_events;
-    private readonly max_retry_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: object): void;
-    createLogEvent(name: string, data: EventValue[]): LogEvent;
+    enqueueLogEvent(event: LogEvent): void;
+    createLogEvent(eventName: EventNames, data?: EventValue[]): LogEvent;
     flushIfNeeded(): void;
     flushToClearcut(): Promise<LogResponse>;
-    decodeLogResponse(buf: Buffer): LogResponse | undefined;
     logStartSessionEvent(event: StartSessionEvent): void;
     logNewPromptEvent(event: UserPromptEvent): void;
     logToolCallEvent(event: ToolCallEvent): void;
     logApiRequestEvent(event: ApiRequestEvent): void;
     logApiResponseEvent(event: ApiResponseEvent): void;
     logApiErrorEvent(event: ApiErrorEvent): void;
-    logFlashFallbackEvent(event: FlashFallbackEvent): 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;
-    logEndSessionEvent(event: EndSessionEvent): void;
+    logKittySequenceOverflowEvent(event: KittySequenceOverflowEvent): void;
+    logEndSessionEvent(): void;
+    /**
+     * Adds default fields to data, and returns a new data array.  This fields
+     * should exist on all log events.
+     */
+    addDefaultFields(data: EventValue[]): EventValue[];
     getProxyAgent(): HttpsProxyAgent<string> | undefined;
     shutdown(): void;
     private requeueFailedEvents;
 }
+export declare const TEST_ONLY: {
+    MAX_RETRY_EVENTS: number;
+    MAX_EVENTS: number;
+};