@blackbox_ai/blackbox-cli-core 0.0.4

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

@@ -0,0 +1,301 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach, afterAll, } from 'vitest';
+import { BlackboxLogger, TEST_ONLY } from './blackbox-logger.js';
+import { StartSessionEvent, EndSessionEvent, IdeConnectionEvent, KittySequenceOverflowEvent, IdeConnectionType, } from '../types.js';
+// Mock dependencies
+vi.mock('../../utils/user_id.js', () => ({
+    getInstallationId: vi.fn(() => 'test-installation-id'),
+}));
+vi.mock('../../utils/safeJsonStringify.js', () => ({
+    safeJsonStringify: vi.fn((obj) => JSON.stringify(obj)),
+}));
+// Mock https module
+vi.mock('https', () => ({
+    request: vi.fn(),
+}));
+const makeFakeConfig = (overrides = {}) => {
+    const defaults = {
+        getUsageStatisticsEnabled: () => true,
+        getDebugMode: () => false,
+        getSessionId: () => 'test-session-id',
+        getCliVersion: () => '1.0.0',
+        getProxy: () => undefined,
+        getContentGeneratorConfig: () => ({ authType: 'test-auth' }),
+        getMcpServers: () => ({}),
+        getModel: () => 'test-model',
+        getEmbeddingModel: () => 'test-embedding',
+        getSandbox: () => false,
+        getCoreTools: () => [],
+        getApprovalMode: () => 'auto',
+        getTelemetryEnabled: () => true,
+        getTelemetryLogPromptsEnabled: () => false,
+        getFileFilteringRespectGitIgnore: () => true,
+        ...overrides,
+    };
+    return defaults;
+};
+describe('BlackboxLogger', () => {
+    let mockConfig;
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date('2025-01-01T12:00:00.000Z'));
+        mockConfig = makeFakeConfig();
+        // Clear singleton instance
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        BlackboxLogger.instance = undefined;
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+        vi.restoreAllMocks();
+    });
+    afterAll(() => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        BlackboxLogger.instance = undefined;
+    });
+    describe('getInstance', () => {
+        it('returns undefined when usage statistics are disabled', () => {
+            const config = makeFakeConfig({ getUsageStatisticsEnabled: () => false });
+            const logger = BlackboxLogger.getInstance(config);
+            expect(logger).toBeUndefined();
+        });
+        it('returns an instance when usage statistics are enabled', () => {
+            const logger = BlackboxLogger.getInstance(mockConfig);
+            expect(logger).toBeInstanceOf(BlackboxLogger);
+        });
+        it('is a singleton', () => {
+            const logger1 = BlackboxLogger.getInstance(mockConfig);
+            const logger2 = BlackboxLogger.getInstance(mockConfig);
+            expect(logger1).toBe(logger2);
+        });
+    });
+    describe('event queue management', () => {
+        it('should handle event overflow gracefully', () => {
+            const debugConfig = makeFakeConfig({ getDebugMode: () => true });
+            const logger = BlackboxLogger.getInstance(debugConfig);
+            const consoleSpy = vi
+                .spyOn(console, 'debug')
+                .mockImplementation(() => { });
+            // Fill the queue beyond capacity
+            for (let i = 0; i < TEST_ONLY.MAX_EVENTS + 10; i++) {
+                logger.enqueueLogEvent({
+                    timestamp: Date.now(),
+                    event_type: 'action',
+                    type: 'test',
+                    name: `test-event-${i}`,
+                });
+            }
+            // Should have logged debug messages about dropping events
+            expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('BlackboxLogger: Dropped old event to prevent memory leak'));
+        });
+        it('should handle enqueue errors gracefully', () => {
+            const debugConfig = makeFakeConfig({ getDebugMode: () => true });
+            const logger = BlackboxLogger.getInstance(debugConfig);
+            const consoleSpy = vi
+                .spyOn(console, 'error')
+                .mockImplementation(() => { });
+            // Mock the events deque to throw an error
+            const originalPush = logger['events'].push;
+            logger['events'].push = vi.fn(() => {
+                throw new Error('Test error');
+            });
+            logger.enqueueLogEvent({
+                timestamp: Date.now(),
+                event_type: 'action',
+                type: 'test',
+                name: 'test-event',
+            });
+            expect(consoleSpy).toHaveBeenCalledWith('BlackboxLogger: Failed to enqueue log event.', expect.any(Error));
+            // Restore original method
+            logger['events'].push = originalPush;
+        });
+    });
+    describe('concurrent flush protection', () => {
+        it('should handle concurrent flush requests', () => {
+            const debugConfig = makeFakeConfig({ getDebugMode: () => true });
+            const logger = BlackboxLogger.getInstance(debugConfig);
+            const consoleSpy = vi
+                .spyOn(console, 'debug')
+                .mockImplementation(() => { });
+            // Manually set the flush in progress flag to simulate concurrent access
+            logger['isFlushInProgress'] = true;
+            // Try to flush while another flush is in progress
+            const result = logger.flushToRum();
+            // Should have logged about pending flush
+            expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('BlackboxLogger: Flush already in progress, marking pending flush'));
+            // Should return a resolved promise
+            expect(result).toBeInstanceOf(Promise);
+            // Reset the flag
+            logger['isFlushInProgress'] = false;
+        });
+    });
+    describe('failed event retry mechanism', () => {
+        it('should requeue failed events with size limits', () => {
+            const debugConfig = makeFakeConfig({ getDebugMode: () => true });
+            const logger = BlackboxLogger.getInstance(debugConfig);
+            const consoleSpy = vi
+                .spyOn(console, 'debug')
+                .mockImplementation(() => { });
+            const failedEvents = [];
+            for (let i = 0; i < TEST_ONLY.MAX_RETRY_EVENTS + 50; i++) {
+                failedEvents.push({
+                    timestamp: Date.now(),
+                    event_type: 'action',
+                    type: 'test',
+                    name: `failed-event-${i}`,
+                });
+            }
+            // Call the private method using bracket notation
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            logger.requeueFailedEvents(failedEvents);
+            // Should have logged about dropping events due to retry limit
+            expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('BlackboxLogger: Re-queued'));
+        });
+        it('should handle empty retry queue gracefully', () => {
+            const debugConfig = makeFakeConfig({ getDebugMode: () => true });
+            const logger = BlackboxLogger.getInstance(debugConfig);
+            const consoleSpy = vi
+                .spyOn(console, 'debug')
+                .mockImplementation(() => { });
+            // Fill the queue to capacity first
+            for (let i = 0; i < TEST_ONLY.MAX_EVENTS; i++) {
+                logger.enqueueLogEvent({
+                    timestamp: Date.now(),
+                    event_type: 'action',
+                    type: 'test',
+                    name: `event-${i}`,
+                });
+            }
+            // Try to requeue when no space is available
+            const failedEvents = [
+                {
+                    timestamp: Date.now(),
+                    event_type: 'action',
+                    type: 'test',
+                    name: 'failed-event',
+                },
+            ];
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            logger.requeueFailedEvents(failedEvents);
+            expect(consoleSpy).toHaveBeenCalledWith(expect.stringContaining('BlackboxLogger: No events re-queued'));
+        });
+    });
+    describe('event handlers', () => {
+        it('should log IDE connection events', () => {
+            const logger = BlackboxLogger.getInstance(mockConfig);
+            const enqueueSpy = vi.spyOn(logger, 'enqueueLogEvent');
+            const event = new IdeConnectionEvent(IdeConnectionType.SESSION);
+            logger.logIdeConnectionEvent(event);
+            expect(enqueueSpy).toHaveBeenCalledWith(expect.objectContaining({
+                event_type: 'action',
+                type: 'connection',
+                name: 'ide_connection',
+                snapshots: JSON.stringify({
+                    connection_type: IdeConnectionType.SESSION,
+                }),
+            }));
+        });
+        it('should log Kitty sequence overflow events', () => {
+            const logger = BlackboxLogger.getInstance(mockConfig);
+            const enqueueSpy = vi.spyOn(logger, 'enqueueLogEvent');
+            const event = new KittySequenceOverflowEvent(1024, 'truncated...');
+            logger.logKittySequenceOverflowEvent(event);
+            expect(enqueueSpy).toHaveBeenCalledWith(expect.objectContaining({
+                event_type: 'exception',
+                type: 'overflow',
+                name: 'kitty_sequence_overflow',
+                subtype: 'kitty_sequence_overflow',
+                snapshots: JSON.stringify({
+                    sequence_length: 1024,
+                    truncated_sequence: 'truncated...',
+                }),
+            }));
+        });
+        it('should flush start session events immediately', async () => {
+            const logger = BlackboxLogger.getInstance(mockConfig);
+            const flushSpy = vi.spyOn(logger, 'flushToRum').mockResolvedValue({});
+            const testConfig = makeFakeConfig({
+                getModel: () => 'test-model',
+                getEmbeddingModel: () => 'test-embedding',
+            });
+            const event = new StartSessionEvent(testConfig);
+            logger.logStartSessionEvent(event);
+            expect(flushSpy).toHaveBeenCalled();
+        });
+        it('should flush end session events immediately', async () => {
+            const logger = BlackboxLogger.getInstance(mockConfig);
+            const flushSpy = vi.spyOn(logger, 'flushToRum').mockResolvedValue({});
+            const event = new EndSessionEvent(mockConfig);
+            logger.logEndSessionEvent(event);
+            expect(flushSpy).toHaveBeenCalled();
+        });
+    });
+    describe('flush timing', () => {
+        it('should not flush if interval has not passed', () => {
+            const logger = BlackboxLogger.getInstance(mockConfig);
+            const flushSpy = vi.spyOn(logger, 'flushToRum');
+            // Add an event and try to flush immediately
+            logger.enqueueLogEvent({
+                timestamp: Date.now(),
+                event_type: 'action',
+                type: 'test',
+                name: 'test-event',
+            });
+            logger.flushIfNeeded();
+            expect(flushSpy).not.toHaveBeenCalled();
+        });
+        it('should flush when interval has passed', () => {
+            const logger = BlackboxLogger.getInstance(mockConfig);
+            const flushSpy = vi.spyOn(logger, 'flushToRum').mockResolvedValue({});
+            // Add an event
+            logger.enqueueLogEvent({
+                timestamp: Date.now(),
+                event_type: 'action',
+                type: 'test',
+                name: 'test-event',
+            });
+            // Advance time beyond flush interval
+            vi.advanceTimersByTime(TEST_ONLY.FLUSH_INTERVAL_MS + 1000);
+            logger.flushIfNeeded();
+            expect(flushSpy).toHaveBeenCalled();
+        });
+    });
+    describe('error handling', () => {
+        it('should handle flush errors gracefully with debug mode', async () => {
+            const debugConfig = makeFakeConfig({ getDebugMode: () => true });
+            const logger = BlackboxLogger.getInstance(debugConfig);
+            const consoleSpy = vi
+                .spyOn(console, 'debug')
+                .mockImplementation(() => { });
+            // Add an event first
+            logger.enqueueLogEvent({
+                timestamp: Date.now(),
+                event_type: 'action',
+                type: 'test',
+                name: 'test-event',
+            });
+            // Mock flushToRum to throw an error
+            const originalFlush = logger.flushToRum.bind(logger);
+            logger.flushToRum = vi.fn().mockRejectedValue(new Error('Network error'));
+            // Advance time to trigger flush
+            vi.advanceTimersByTime(TEST_ONLY.FLUSH_INTERVAL_MS + 1000);
+            logger.flushIfNeeded();
+            // Wait for async operations
+            await vi.runAllTimersAsync();
+            expect(consoleSpy).toHaveBeenCalledWith('Error flushing to RUM:', expect.any(Error));
+            // Restore original method
+            logger.flushToRum = originalFlush;
+        });
+    });
+    describe('constants export', () => {
+        it('should export test constants', () => {
+            expect(TEST_ONLY.MAX_EVENTS).toBe(1000);
+            expect(TEST_ONLY.MAX_RETRY_EVENTS).toBe(100);
+            expect(TEST_ONLY.FLUSH_INTERVAL_MS).toBe(60000);
+        });
+    });
+});
+//# sourceMappingURL=blackbox-logger.test.js.map

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

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

package/dist/src/telemetry/blackbox-logger/event-types.d.ts

@@ -0,0 +1,73 @@
+export interface RumApp {
+    id: string;
+    env: string;
+    version: string;
+    type: 'cli' | 'extension';
+}
+export interface RumUser {
+    id: string;
+}
+export interface RumSession {
+    id: string;
+}
+export interface RumView {
+    id: string;
+    name: string;
+}
+export interface RumEvent {
+    timestamp?: number;
+    event_type?: 'view' | 'action' | 'exception' | 'resource';
+    type: string;
+    name: string;
+    snapshots?: string;
+    properties?: Record<string, unknown>;
+}
+export interface RumViewEvent extends RumEvent {
+    view_type?: string;
+    time_spent?: number;
+}
+export interface RumActionEvent extends RumEvent {
+    target_name?: string;
+    duration?: number;
+    method_info?: string;
+}
+export interface RumExceptionEvent extends RumEvent {
+    source?: string;
+    file?: string;
+    subtype?: string;
+    message?: string;
+    stack?: string;
+    caused_by?: string;
+    line?: number;
+    column?: number;
+    thread_id?: string;
+    binary_images?: string;
+}
+export interface RumResourceEvent extends RumEvent {
+    method?: string;
+    status_code?: string;
+    message?: string;
+    url?: string;
+    provider_type?: string;
+    trace_id?: string;
+    success?: number;
+    duration?: number;
+    size?: number;
+    connect_duration?: number;
+    ssl_duration?: number;
+    dns_duration?: number;
+    redirect_duration?: number;
+    first_byte_duration?: number;
+    download_duration?: number;
+    timing_data?: string;
+    trace_data?: string;
+}
+export interface RumPayload {
+    app: RumApp;
+    user: RumUser;
+    session: RumSession;
+    view: RumView;
+    events: RumEvent[];
+    properties?: Record<string, unknown>;
+    _v: string;
+}

package/dist/src/telemetry/blackbox-logger/event-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=event-types.js.map

package/dist/src/telemetry/blackbox-logger/event-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-types.js","sourceRoot":"","sources":["../../../../src/telemetry/blackbox-logger/event-types.ts"],"names":[],"mappings":""}

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;
+};