@didim365/agent-cli-core 0.1.0

package/dist/src/telemetry/activity-monitor.test.js

@@ -0,0 +1,251 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { ActivityMonitor, DEFAULT_ACTIVITY_CONFIG, initializeActivityMonitor, getActivityMonitor, recordGlobalActivity, startGlobalActivityMonitoring, stopGlobalActivityMonitoring, } from './activity-monitor.js';
+import { ActivityType } from './activity-types.js';
+import { debugLogger } from '../utils/debugLogger.js';
+// Mock the dependencies
+vi.mock('./metrics.js', () => ({
+    isPerformanceMonitoringActive: vi.fn(() => true),
+}));
+vi.mock('./memory-monitor.js', () => ({
+    getMemoryMonitor: vi.fn(() => ({
+        takeSnapshot: vi.fn(() => ({
+            timestamp: Date.now(),
+            heapUsed: 1000000,
+            heapTotal: 2000000,
+            external: 500000,
+            rss: 3000000,
+            arrayBuffers: 100000,
+            heapSizeLimit: 4000000,
+        })),
+    })),
+}));
+describe('ActivityMonitor', () => {
+    let activityMonitor;
+    let mockConfig;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockConfig = {
+            getSessionId: () => 'test-session-123',
+        };
+        activityMonitor = new ActivityMonitor();
+    });
+    afterEach(() => {
+        activityMonitor.stop();
+    });
+    describe('constructor', () => {
+        it('should initialize with default config', () => {
+            const monitor = new ActivityMonitor();
+            expect(monitor).toBeDefined();
+            expect(monitor.isMonitoringActive()).toBe(false);
+        });
+        it('should initialize with custom config', () => {
+            const customConfig = {
+                ...DEFAULT_ACTIVITY_CONFIG,
+                snapshotThrottleMs: 2000,
+            };
+            const monitor = new ActivityMonitor(customConfig);
+            expect(monitor).toBeDefined();
+        });
+    });
+    describe('start and stop', () => {
+        it('should start and stop monitoring', () => {
+            expect(activityMonitor.isMonitoringActive()).toBe(false);
+            activityMonitor.start(mockConfig);
+            expect(activityMonitor.isMonitoringActive()).toBe(true);
+            activityMonitor.stop();
+            expect(activityMonitor.isMonitoringActive()).toBe(false);
+        });
+        it('should not start monitoring when already active', () => {
+            activityMonitor.start(mockConfig);
+            expect(activityMonitor.isMonitoringActive()).toBe(true);
+            // Should not affect already active monitor
+            activityMonitor.start(mockConfig);
+            expect(activityMonitor.isMonitoringActive()).toBe(true);
+        });
+    });
+    describe('recordActivity', () => {
+        beforeEach(() => {
+            activityMonitor.start(mockConfig);
+        });
+        it('should record activity events', () => {
+            activityMonitor.recordActivity(ActivityType.USER_INPUT_START, 'test-context');
+            const stats = activityMonitor.getActivityStats();
+            expect(stats.totalEvents).toBe(2); // includes the start event
+            expect(stats.eventTypes[ActivityType.USER_INPUT_START]).toBe(1);
+        });
+        it('should include metadata in activity events', () => {
+            const metadata = { key: 'value', count: 42 };
+            activityMonitor.recordActivity(ActivityType.MESSAGE_ADDED, 'test-context', metadata);
+            const recentActivity = activityMonitor.getRecentActivity(1);
+            expect(recentActivity[0].metadata).toEqual(metadata);
+        });
+        it('should not record activity when monitoring is disabled', () => {
+            activityMonitor.updateConfig({ enabled: false });
+            activityMonitor.recordActivity(ActivityType.USER_INPUT_START);
+            const stats = activityMonitor.getActivityStats();
+            expect(stats.totalEvents).toBe(1); // only the start event
+        });
+        it('should limit event buffer size', () => {
+            activityMonitor.updateConfig({ maxEventBuffer: 3 });
+            // Record more events than buffer size
+            for (let i = 0; i < 5; i++) {
+                activityMonitor.recordActivity(ActivityType.USER_INPUT_START, `event-${i}`);
+            }
+            const stats = activityMonitor.getActivityStats();
+            expect(stats.totalEvents).toBe(3); // buffer limit
+        });
+    });
+    describe('listeners', () => {
+        let listenerCallCount;
+        let lastEvent;
+        beforeEach(() => {
+            listenerCallCount = 0;
+            lastEvent = null;
+            activityMonitor.start(mockConfig);
+        });
+        it('should notify listeners of activity events', () => {
+            const listener = (event) => {
+                listenerCallCount++;
+                lastEvent = event;
+            };
+            activityMonitor.addListener(listener);
+            activityMonitor.recordActivity(ActivityType.MESSAGE_ADDED, 'test');
+            expect(listenerCallCount).toBe(1);
+            expect(lastEvent?.type).toBe(ActivityType.MESSAGE_ADDED);
+            expect(lastEvent?.context).toBe('test');
+        });
+        it('should remove listeners correctly', () => {
+            const listener = () => {
+                listenerCallCount++;
+            };
+            activityMonitor.addListener(listener);
+            activityMonitor.recordActivity(ActivityType.USER_INPUT_START);
+            expect(listenerCallCount).toBe(1);
+            activityMonitor.removeListener(listener);
+            activityMonitor.recordActivity(ActivityType.USER_INPUT_START);
+            expect(listenerCallCount).toBe(1); // Should not increase
+        });
+        it('should handle listener errors gracefully', () => {
+            const faultyListener = () => {
+                throw new Error('Listener error');
+            };
+            const goodListener = () => {
+                listenerCallCount++;
+            };
+            // Spy on console.debug to check error handling
+            const debugSpy = vi
+                .spyOn(debugLogger, 'debug')
+                .mockImplementation(() => { });
+            activityMonitor.addListener(faultyListener);
+            activityMonitor.addListener(goodListener);
+            activityMonitor.recordActivity(ActivityType.USER_INPUT_START);
+            expect(listenerCallCount).toBe(1); // Good listener should still work
+            expect(debugSpy).toHaveBeenCalled();
+            debugSpy.mockRestore();
+        });
+    });
+    describe('getActivityStats', () => {
+        beforeEach(() => {
+            activityMonitor.start(mockConfig);
+        });
+        it('should return correct activity statistics', () => {
+            activityMonitor.recordActivity(ActivityType.USER_INPUT_START);
+            activityMonitor.recordActivity(ActivityType.MESSAGE_ADDED);
+            activityMonitor.recordActivity(ActivityType.USER_INPUT_START);
+            const stats = activityMonitor.getActivityStats();
+            expect(stats.totalEvents).toBe(4); // includes start event
+            expect(stats.eventTypes[ActivityType.USER_INPUT_START]).toBe(2);
+            expect(stats.eventTypes[ActivityType.MESSAGE_ADDED]).toBe(1);
+            expect(stats.timeRange).toBeDefined();
+        });
+        it('should return null time range for empty buffer', () => {
+            const emptyMonitor = new ActivityMonitor();
+            const stats = emptyMonitor.getActivityStats();
+            expect(stats.totalEvents).toBe(0);
+            expect(stats.timeRange).toBeNull();
+        });
+    });
+    describe('updateConfig', () => {
+        it('should update configuration correctly', () => {
+            const newConfig = { snapshotThrottleMs: 2000 };
+            activityMonitor.updateConfig(newConfig);
+            // Config should be updated (tested indirectly through behavior)
+            expect(activityMonitor).toBeDefined();
+        });
+    });
+});
+describe('Global activity monitoring functions', () => {
+    let mockConfig;
+    beforeEach(() => {
+        mockConfig = {
+            getSessionId: () => 'test-session-456',
+        };
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        stopGlobalActivityMonitoring();
+    });
+    describe('initializeActivityMonitor', () => {
+        it('should create global monitor instance', () => {
+            const monitor = initializeActivityMonitor();
+            expect(monitor).toBeDefined();
+            expect(getActivityMonitor()).toBe(monitor);
+        });
+        it('should return same instance on subsequent calls', () => {
+            const monitor1 = initializeActivityMonitor();
+            const monitor2 = initializeActivityMonitor();
+            expect(monitor1).toBe(monitor2);
+        });
+    });
+    describe('recordGlobalActivity', () => {
+        it('should record activity through global monitor', () => {
+            startGlobalActivityMonitoring(mockConfig);
+            recordGlobalActivity(ActivityType.TOOL_CALL_SCHEDULED, 'global-test');
+            const monitor = getActivityMonitor();
+            const stats = monitor?.getActivityStats();
+            expect(stats?.totalEvents).toBeGreaterThan(0);
+        });
+        it('should handle missing global monitor gracefully', () => {
+            stopGlobalActivityMonitoring();
+            // Should not throw error
+            expect(() => {
+                recordGlobalActivity(ActivityType.USER_INPUT_START);
+            }).not.toThrow();
+        });
+    });
+    describe('startGlobalActivityMonitoring', () => {
+        it('should start global monitoring with default config', () => {
+            startGlobalActivityMonitoring(mockConfig);
+            const monitor = getActivityMonitor();
+            expect(monitor?.isMonitoringActive()).toBe(true);
+        });
+        it('should start global monitoring with custom config', () => {
+            const customConfig = {
+                ...DEFAULT_ACTIVITY_CONFIG,
+                snapshotThrottleMs: 3000,
+            };
+            startGlobalActivityMonitoring(mockConfig, customConfig);
+            const monitor = getActivityMonitor();
+            expect(monitor?.isMonitoringActive()).toBe(true);
+        });
+    });
+    describe('stopGlobalActivityMonitoring', () => {
+        it('should stop global monitoring', () => {
+            startGlobalActivityMonitoring(mockConfig);
+            expect(getActivityMonitor()?.isMonitoringActive()).toBe(true);
+            stopGlobalActivityMonitoring();
+            expect(getActivityMonitor()?.isMonitoringActive()).toBe(false);
+        });
+        it('should handle missing global monitor gracefully', () => {
+            expect(() => {
+                stopGlobalActivityMonitoring();
+            }).not.toThrow();
+        });
+    });
+});
+//# sourceMappingURL=activity-monitor.test.js.map

package/dist/src/telemetry/activity-monitor.test.js.map

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

package/dist/src/telemetry/activity-types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Types of user activities that can be tracked
+ */
+export declare enum ActivityType {
+    USER_INPUT_START = "user_input_start",
+    USER_INPUT_END = "user_input_end",
+    MESSAGE_ADDED = "message_added",
+    TOOL_CALL_SCHEDULED = "tool_call_scheduled",
+    TOOL_CALL_COMPLETED = "tool_call_completed",
+    STREAM_START = "stream_start",
+    STREAM_END = "stream_end",
+    HISTORY_UPDATED = "history_updated",
+    MANUAL_TRIGGER = "manual_trigger"
+}

package/dist/src/telemetry/activity-types.js

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Types of user activities that can be tracked
+ */
+export var ActivityType;
+(function (ActivityType) {
+    ActivityType["USER_INPUT_START"] = "user_input_start";
+    ActivityType["USER_INPUT_END"] = "user_input_end";
+    ActivityType["MESSAGE_ADDED"] = "message_added";
+    ActivityType["TOOL_CALL_SCHEDULED"] = "tool_call_scheduled";
+    ActivityType["TOOL_CALL_COMPLETED"] = "tool_call_completed";
+    ActivityType["STREAM_START"] = "stream_start";
+    ActivityType["STREAM_END"] = "stream_end";
+    ActivityType["HISTORY_UPDATED"] = "history_updated";
+    ActivityType["MANUAL_TRIGGER"] = "manual_trigger";
+})(ActivityType || (ActivityType = {}));
+//# sourceMappingURL=activity-types.js.map

package/dist/src/telemetry/activity-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-types.js","sourceRoot":"","sources":["../../../src/telemetry/activity-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,YAUX;AAVD,WAAY,YAAY;IACtB,qDAAqC,CAAA;IACrC,iDAAiC,CAAA;IACjC,+CAA+B,CAAA;IAC/B,2DAA2C,CAAA;IAC3C,2DAA2C,CAAA;IAC3C,6CAA6B,CAAA;IAC7B,yCAAyB,CAAA;IACzB,mDAAmC,CAAA;IACnC,iDAAiC,CAAA;AACnC,CAAC,EAVW,YAAY,KAAZ,YAAY,QAUvB"}

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

@@ -0,0 +1,172 @@
+/**
+ * @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, ChatCompressionEvent, FileOperationEvent, InvalidChunkEvent, ContentRetryEvent, ContentRetryFailureEvent, ExtensionInstallEvent, ToolOutputTruncatedEvent, ExtensionUninstallEvent, ModelRoutingEvent, ExtensionEnableEvent, ModelSlashCommandEvent, ExtensionDisableEvent, EditStrategyEvent, EditCorrectionEvent, AgentStartEvent, AgentFinishEvent, RecoveryAttemptEvent, WebFetchFallbackAttemptEvent, ExtensionUpdateEvent, LlmLoopCheckEvent, HookCallEvent, ApprovalModeSwitchEvent, ApprovalModeDurationEvent } 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",
+    RIPGREP_FALLBACK = "ripgrep_fallback",
+    LOOP_DETECTED = "loop_detected",
+    LOOP_DETECTION_DISABLED = "loop_detection_disabled",
+    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",
+    EXTENSION_ENABLE = "extension_enable",
+    EXTENSION_DISABLE = "extension_disable",
+    EXTENSION_INSTALL = "extension_install",
+    EXTENSION_UNINSTALL = "extension_uninstall",
+    EXTENSION_UPDATE = "extension_update",
+    TOOL_OUTPUT_TRUNCATED = "tool_output_truncated",
+    MODEL_ROUTING = "model_routing",
+    MODEL_SLASH_COMMAND = "model_slash_command",
+    EDIT_STRATEGY = "edit_strategy",
+    EDIT_CORRECTION = "edit_correction",
+    AGENT_START = "agent_start",
+    AGENT_FINISH = "agent_finish",
+    RECOVERY_ATTEMPT = "recovery_attempt",
+    WEB_FETCH_FALLBACK_ATTEMPT = "web_fetch_fallback_attempt",
+    LLM_LOOP_CHECK = "llm_loop_check",
+    HOOK_CALL = "hook_call",
+    APPROVAL_MODE_SWITCH = "approval_mode_switch",
+    APPROVAL_MODE_DURATION = "approval_mode_duration"
+}
+export interface LogResponse {
+    nextRequestWaitMs?: number;
+}
+export interface LogEventEntry {
+    event_time_ms: number;
+    source_extension_json: string;
+    exp?: {
+        gws_experiment: number[];
+    };
+}
+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[][];
+}
+declare function refreshGpuInfo(): Promise<void>;
+export declare class ClearcutLogger {
+    private static instance;
+    private config?;
+    private sessionData;
+    private promptId;
+    private readonly installationManager;
+    private readonly userAccountManager;
+    private readonly hashedGHRepositoryName?;
+    /**
+     * 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;
+    enqueueHelper(event: LogEvent, experimentIds?: number[]): void;
+    enqueueLogEvent(event: LogEvent): void;
+    enqueueLogEventAfterExperimentsLoadAsync(event: LogEvent): Promise<void>;
+    createBasicLogEvent(eventName: EventNames, data?: EventValue[]): LogEvent;
+    createLogEvent(eventName: EventNames, data?: EventValue[]): LogEvent;
+    flushIfNeeded(): void;
+    flushToClearcut(): Promise<LogResponse>;
+    logStartSessionEvent(event: StartSessionEvent): Promise<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;
+    logRipgrepFallbackEvent(): void;
+    logLoopDetectedEvent(event: LoopDetectedEvent): void;
+    logLoopDetectionDisabledEvent(): void;
+    logNextSpeakerCheck(event: NextSpeakerCheckEvent): void;
+    logSlashCommandEvent(event: SlashCommandEvent): void;
+    logMalformedJsonResponseEvent(event: MalformedJsonResponseEvent): void;
+    logIdeConnectionEvent(event: IdeConnectionEvent): void;
+    logConversationFinishedEvent(event: ConversationFinishedEvent): void;
+    logEndSessionEvent(): void;
+    logInvalidChunkEvent(event: InvalidChunkEvent): void;
+    logContentRetryEvent(event: ContentRetryEvent): void;
+    logContentRetryFailureEvent(event: ContentRetryFailureEvent): void;
+    logExtensionInstallEvent(event: ExtensionInstallEvent): Promise<void>;
+    logExtensionUninstallEvent(event: ExtensionUninstallEvent): Promise<void>;
+    logExtensionUpdateEvent(event: ExtensionUpdateEvent): Promise<void>;
+    logToolOutputTruncatedEvent(event: ToolOutputTruncatedEvent): void;
+    logModelRoutingEvent(event: ModelRoutingEvent): void;
+    logExtensionEnableEvent(event: ExtensionEnableEvent): Promise<void>;
+    logModelSlashCommandEvent(event: ModelSlashCommandEvent): void;
+    logExtensionDisableEvent(event: ExtensionDisableEvent): Promise<void>;
+    logEditStrategyEvent(event: EditStrategyEvent): void;
+    logEditCorrectionEvent(event: EditCorrectionEvent): void;
+    logAgentStartEvent(event: AgentStartEvent): void;
+    logAgentFinishEvent(event: AgentFinishEvent): void;
+    logRecoveryAttemptEvent(event: RecoveryAttemptEvent): void;
+    logWebFetchFallbackAttemptEvent(event: WebFetchFallbackAttemptEvent): void;
+    logLlmLoopCheckEvent(event: LlmLoopCheckEvent): void;
+    logHookCallEvent(event: HookCallEvent): void;
+    logApprovalModeSwitchEvent(event: ApprovalModeSwitchEvent): void;
+    logApprovalModeDurationEvent(event: ApprovalModeDurationEvent): 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;
+    getConfigJson(): string;
+    shutdown(): void;
+    private requeueFailedEvents;
+}
+export declare const TEST_ONLY: {
+    MAX_RETRY_EVENTS: number;
+    MAX_EVENTS: number;
+    refreshGpuInfo: typeof refreshGpuInfo;
+    resetCachedGpuInfoForTesting: () => void;
+};
+export {};