@google/gemini-cli-core 0.0.1

package/dist/src/telemetry/high-water-mark-tracker.test.js

@@ -0,0 +1,152 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { HighWaterMarkTracker } from './high-water-mark-tracker.js';
+describe('HighWaterMarkTracker', () => {
+    let tracker;
+    beforeEach(() => {
+        tracker = new HighWaterMarkTracker(5); // 5% threshold
+    });
+    describe('constructor', () => {
+        it('should initialize with default values', () => {
+            const defaultTracker = new HighWaterMarkTracker();
+            expect(defaultTracker).toBeInstanceOf(HighWaterMarkTracker);
+        });
+        it('should initialize with custom values', () => {
+            const customTracker = new HighWaterMarkTracker(10);
+            expect(customTracker).toBeInstanceOf(HighWaterMarkTracker);
+        });
+        it('should throw on negative threshold', () => {
+            expect(() => new HighWaterMarkTracker(-1)).toThrow('growthThresholdPercent must be non-negative.');
+        });
+    });
+    describe('shouldRecordMetric', () => {
+        it('should return true for first measurement', () => {
+            const result = tracker.shouldRecordMetric('heap_used', 1000000);
+            expect(result).toBe(true);
+        });
+        it('should return false for small increases', () => {
+            // Set initial high-water mark
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            // Small increase (less than 5%)
+            const result = tracker.shouldRecordMetric('heap_used', 1030000); // 3% increase
+            expect(result).toBe(false);
+        });
+        it('should return true for significant increases', () => {
+            // Set initial high-water mark
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            // Add several readings to build up smoothing window
+            tracker.shouldRecordMetric('heap_used', 1100000); // 10% increase
+            tracker.shouldRecordMetric('heap_used', 1150000); // Additional growth
+            const result = tracker.shouldRecordMetric('heap_used', 1200000); // Sustained growth
+            expect(result).toBe(true);
+        });
+        it('should handle decreasing values correctly', () => {
+            // Set initial high-water mark
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            // Decrease (should not trigger)
+            const result = tracker.shouldRecordMetric('heap_used', 900000); // 10% decrease
+            expect(result).toBe(false);
+        });
+        it('should update high-water mark when threshold exceeded', () => {
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            const beforeMark = tracker.getHighWaterMark('heap_used');
+            // Create sustained growth pattern to trigger update
+            tracker.shouldRecordMetric('heap_used', 1100000);
+            tracker.shouldRecordMetric('heap_used', 1150000);
+            tracker.shouldRecordMetric('heap_used', 1200000);
+            const afterMark = tracker.getHighWaterMark('heap_used');
+            expect(afterMark).toBeGreaterThan(beforeMark);
+        });
+        it('should handle multiple metric types independently', () => {
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            tracker.shouldRecordMetric('rss', 2000000);
+            expect(tracker.getHighWaterMark('heap_used')).toBeGreaterThan(0);
+            expect(tracker.getHighWaterMark('rss')).toBeGreaterThan(0);
+            expect(tracker.getHighWaterMark('heap_used')).not.toBe(tracker.getHighWaterMark('rss'));
+        });
+    });
+    describe('smoothing functionality', () => {
+        it('should reduce noise from garbage collection spikes', () => {
+            // Establish baseline
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            // Single spike (should be smoothed out)
+            const result = tracker.shouldRecordMetric('heap_used', 2000000);
+            // With the new responsive algorithm, large spikes do trigger
+            expect(result).toBe(true);
+        });
+        it('should eventually respond to sustained growth', () => {
+            // Establish baseline
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            // Sustained growth pattern
+            tracker.shouldRecordMetric('heap_used', 1100000);
+            tracker.shouldRecordMetric('heap_used', 1150000);
+            const result = tracker.shouldRecordMetric('heap_used', 1200000);
+            expect(result).toBe(true);
+        });
+    });
+    describe('getHighWaterMark', () => {
+        it('should return 0 for unknown metric types', () => {
+            const mark = tracker.getHighWaterMark('unknown_metric');
+            expect(mark).toBe(0);
+        });
+        it('should return correct value for known metric types', () => {
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            const mark = tracker.getHighWaterMark('heap_used');
+            expect(mark).toBeGreaterThan(0);
+        });
+    });
+    describe('getAllHighWaterMarks', () => {
+        it('should return empty object initially', () => {
+            const marks = tracker.getAllHighWaterMarks();
+            expect(marks).toEqual({});
+        });
+        it('should return all recorded marks', () => {
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            tracker.shouldRecordMetric('rss', 2000000);
+            const marks = tracker.getAllHighWaterMarks();
+            expect(Object.keys(marks)).toHaveLength(2);
+            expect(marks['heap_used']).toBeGreaterThan(0);
+            expect(marks['rss']).toBeGreaterThan(0);
+        });
+    });
+    describe('resetHighWaterMark', () => {
+        it('should reset specific metric type', () => {
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            tracker.shouldRecordMetric('rss', 2000000);
+            tracker.resetHighWaterMark('heap_used');
+            expect(tracker.getHighWaterMark('heap_used')).toBe(0);
+            expect(tracker.getHighWaterMark('rss')).toBeGreaterThan(0);
+        });
+    });
+    describe('resetAllHighWaterMarks', () => {
+        it('should reset all metrics', () => {
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            tracker.shouldRecordMetric('rss', 2000000);
+            tracker.resetAllHighWaterMarks();
+            expect(tracker.getHighWaterMark('heap_used')).toBe(0);
+            expect(tracker.getHighWaterMark('rss')).toBe(0);
+            expect(tracker.getAllHighWaterMarks()).toEqual({});
+        });
+    });
+    describe('time-based cleanup', () => {
+        it('should clean up old readings', () => {
+            vi.useFakeTimers();
+            // Add readings
+            tracker.shouldRecordMetric('heap_used', 1000000);
+            // Advance time significantly
+            vi.advanceTimersByTime(15000); // 15 seconds
+            // Explicit cleanup should remove stale entries when age exceeded
+            tracker.cleanup(10000); // 10 seconds
+            // Entry should be removed
+            expect(tracker.getHighWaterMark('heap_used')).toBe(0);
+            vi.useRealTimers();
+        });
+    });
+});
+//# sourceMappingURL=high-water-mark-tracker.test.js.map

package/dist/src/telemetry/high-water-mark-tracker.test.js.map

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

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

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare enum TelemetryTarget {
+    GCP = "gcp",
+    LOCAL = "local"
+}
+declare const DEFAULT_TELEMETRY_TARGET = TelemetryTarget.LOCAL;
+declare const DEFAULT_OTLP_ENDPOINT = "http://localhost:4317";
+export { DEFAULT_TELEMETRY_TARGET, DEFAULT_OTLP_ENDPOINT };
+export { initializeTelemetry, shutdownTelemetry, isTelemetrySdkInitialized, } from './sdk.js';
+export { GcpTraceExporter, GcpMetricExporter, GcpLogExporter, } from './gcp-exporters.js';
+export { logCliConfiguration, logUserPrompt, logToolCall, logApiRequest, logApiError, logApiResponse, logFlashFallback, logSlashCommand, logConversationFinishedEvent, logKittySequenceOverflow, logChatCompression, logToolOutputTruncated, } from './loggers.js';
+export type { SlashCommandEvent, ChatCompressionEvent } from './types.js';
+export { SlashCommandStatus, EndSessionEvent, UserPromptEvent, ApiRequestEvent, ApiErrorEvent, ApiResponseEvent, FlashFallbackEvent, StartSessionEvent, ToolCallEvent, ConversationFinishedEvent, KittySequenceOverflowEvent, ToolOutputTruncatedEvent, } from './types.js';
+export { makeSlashCommandEvent, makeChatCompressionEvent } from './types.js';
+export type { TelemetryEvent } from './types.js';
+export { SpanStatusCode, ValueType } from '@opentelemetry/api';
+export { SemanticAttributes } from '@opentelemetry/semantic-conventions';
+export * from './uiTelemetry.js';
+export { HighWaterMarkTracker } from './high-water-mark-tracker.js';
+export { RateLimiter } from './rate-limiter.js';
+export { ActivityType } from './activity-types.js';
+export { ActivityDetector, getActivityDetector, recordUserActivity, isUserActive, } from './activity-detector.js';

package/dist/src/telemetry/index.js

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export var TelemetryTarget;
+(function (TelemetryTarget) {
+    TelemetryTarget["GCP"] = "gcp";
+    TelemetryTarget["LOCAL"] = "local";
+})(TelemetryTarget || (TelemetryTarget = {}));
+const DEFAULT_TELEMETRY_TARGET = TelemetryTarget.LOCAL;
+const DEFAULT_OTLP_ENDPOINT = 'http://localhost:4317';
+export { DEFAULT_TELEMETRY_TARGET, DEFAULT_OTLP_ENDPOINT };
+export { initializeTelemetry, shutdownTelemetry, isTelemetrySdkInitialized, } from './sdk.js';
+export { GcpTraceExporter, GcpMetricExporter, GcpLogExporter, } from './gcp-exporters.js';
+export { logCliConfiguration, logUserPrompt, logToolCall, logApiRequest, logApiError, logApiResponse, logFlashFallback, logSlashCommand, logConversationFinishedEvent, logKittySequenceOverflow, logChatCompression, logToolOutputTruncated, } from './loggers.js';
+export { SlashCommandStatus, EndSessionEvent, UserPromptEvent, ApiRequestEvent, ApiErrorEvent, ApiResponseEvent, FlashFallbackEvent, StartSessionEvent, ToolCallEvent, ConversationFinishedEvent, KittySequenceOverflowEvent, ToolOutputTruncatedEvent, } from './types.js';
+export { makeSlashCommandEvent, makeChatCompressionEvent } from './types.js';
+export { SpanStatusCode, ValueType } from '@opentelemetry/api';
+export { SemanticAttributes } from '@opentelemetry/semantic-conventions';
+export * from './uiTelemetry.js';
+export { HighWaterMarkTracker } from './high-water-mark-tracker.js';
+export { RateLimiter } from './rate-limiter.js';
+export { ActivityType } from './activity-types.js';
+export { ActivityDetector, getActivityDetector, recordUserActivity, isUserActive, } from './activity-detector.js';
+//# 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,eAGX;AAHD,WAAY,eAAe;IACzB,8BAAW,CAAA;IACX,kCAAe,CAAA;AACjB,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B;AAED,MAAM,wBAAwB,GAAG,eAAe,CAAC,KAAK,CAAC;AACvD,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAEtD,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,CAAC;AAC3D,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,aAAa,EACb,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,4BAA4B,EAC5B,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE7E,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,GACb,MAAM,wBAAwB,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,54 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Integration test to verify circular reference handling with proxy agents
+ */
+import { describe, it, expect } from 'vitest';
+import { ClearcutLogger } from './clearcut-logger/clearcut-logger.js';
+describe('Circular Reference Integration Test', () => {
+    it('should handle HttpsProxyAgent-like circular references in clearcut 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 = {
+            error: new Error('Network error'),
+            function_args: {
+                filePath: '/test/file.txt',
+                httpAgent: proxyAgentLike, // This would cause the circular reference
+            },
+        };
+        // Test that ClearcutLogger can handle this
+        const logger = ClearcutLogger.getInstance(mockConfig);
+        expect(() => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            logger?.enqueueLogEvent(problematicEvent);
+        }).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":"AAAA;;;;GAIG;AAEH;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAGtE,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,EAAE,CAAC,4EAA4E,EAAE,GAAG,EAAE;QACpF,kCAAkC;QAClC,MAAM,UAAU,GAAG;YACjB,mBAAmB,EAAE,GAAG,EAAE,CAAC,IAAI;YAC/B,yBAAyB,EAAE,GAAG,EAAE,CAAC,IAAI;YACrC,YAAY,EAAE,GAAG,EAAE,CAAC,cAAc;YAClC,QAAQ,EAAE,GAAG,EAAE,CAAC,YAAY;YAC5B,iBAAiB,EAAE,GAAG,EAAE,CAAC,gBAAgB;YACzC,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK;YACzB,QAAQ,EAAE,GAAG,EAAE,CAAC,+BAA+B;SAC3B,CAAC;QAEvB,kEAAkE;QAClE,8DAA8D;QAC9D,MAAM,cAAc,GAAQ;YAC1B,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,EAAE,KAAK,EAAE,+BAA+B,EAAE;SACpD,CAAC;QAEF,8DAA8D;QAC9D,MAAM,UAAU,GAAQ;YACtB,YAAY,EAAE;gBACZ,KAAK,EAAE,cAAc;gBACrB,MAAM,EAAE,IAAI;aACb;SACF,CAAC;QAEF,UAAU,CAAC,YAAY,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,4BAA4B;QACzE,cAAc,CAAC,OAAO,CAAC,iCAAiC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAEzE,6DAA6D;QAC7D,MAAM,gBAAgB,GAAG;YACvB,KAAK,EAAE,IAAI,KAAK,CAAC,eAAe,CAAC;YACjC,aAAa,EAAE;gBACb,QAAQ,EAAE,gBAAgB;gBAC1B,SAAS,EAAE,cAAc,EAAE,0CAA0C;aACtE;SACF,CAAC;QAEF,2CAA2C;QAC3C,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAEtD,MAAM,CAAC,GAAG,EAAE;YACV,8DAA8D;YAC9D,MAAM,EAAE,eAAe,CAAC,gBAAuB,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+import type { ApiErrorEvent, ApiRequestEvent, ApiResponseEvent, FileOperationEvent, IdeConnectionEvent, StartSessionEvent, ToolCallEvent, UserPromptEvent, FlashFallbackEvent, NextSpeakerCheckEvent, LoopDetectedEvent, LoopDetectionDisabledEvent, SlashCommandEvent, ConversationFinishedEvent, KittySequenceOverflowEvent, ChatCompressionEvent, MalformedJsonResponseEvent, InvalidChunkEvent, ContentRetryEvent, ContentRetryFailureEvent, RipgrepFallbackEvent, ToolOutputTruncatedEvent, ModelRoutingEvent, ExtensionEnableEvent, ExtensionUninstallEvent, ExtensionInstallEvent } 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 logToolOutputTruncated(config: Config, event: ToolOutputTruncatedEvent): 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 logRipgrepFallback(config: Config, event: RipgrepFallbackEvent): 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 logLoopDetectionDisabled(config: Config, _event: LoopDetectionDisabledEvent): 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 logMalformedJsonResponse(config: Config, event: MalformedJsonResponseEvent): 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 logModelRouting(config: Config, event: ModelRoutingEvent): void;
+export declare function logExtensionInstallEvent(config: Config, event: ExtensionInstallEvent): void;
+export declare function logExtensionUninstall(config: Config, event: ExtensionUninstallEvent): void;
+export declare function logExtensionEnable(config: Config, event: ExtensionEnableEvent): void;