@office-ai/aioncli-core 0.2.3 → 0.8.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

@@ -11,8 +11,18 @@ 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 { logCliConfiguration, logUserPrompt, logToolCall, logApiRequest, logApiError, logApiResponse, logFlashFallback, logSlashCommand, logKittySequenceOverflow, logChatCompression, } from './loggers.js';
-export { StartSessionEvent, EndSessionEvent, UserPromptEvent, ToolCallEvent, ApiRequestEvent, ApiErrorEvent, ApiResponseEvent, TelemetryEvent, FlashFallbackEvent, KittySequenceOverflowEvent, SlashCommandEvent, makeSlashCommandEvent, SlashCommandStatus, ChatCompressionEvent, makeChatCompressionEvent, } from './types.js';
+export { resolveTelemetrySettings, parseBooleanEnvFlag, parseTelemetryTargetValue, } from './config.js';
+export { GcpTraceExporter, GcpMetricExporter, GcpLogExporter, } from './gcp-exporters.js';
+export { logCliConfiguration, logUserPrompt, logToolCall, logApiRequest, logApiError, logApiResponse, logFlashFallback, logSlashCommand, logConversationFinishedEvent, logKittySequenceOverflow, logChatCompression, logToolOutputTruncated, logExtensionEnable, logExtensionInstallEvent, logExtensionUninstall, } 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';
+export { recordToolCallMetrics, recordTokenUsageMetrics, recordApiResponseMetrics, recordApiErrorMetrics, recordFileOperationMetric, recordInvalidChunk, recordContentRetry, recordContentRetryFailure, recordModelRoutingMetrics, recordStartupPerformance, recordMemoryUsage, recordCpuUsage, recordToolQueueDepth, recordToolExecutionBreakdown, recordTokenEfficiency, recordApiRequestBreakdown, recordPerformanceScore, recordPerformanceRegression, recordBaselineComparison, isPerformanceMonitoringActive, PerformanceMetricType, MemoryMetricType, ToolExecutionPhase, ApiRequestPhase, FileOperation, } from './metrics.js';

package/dist/src/telemetry/index.js

@@ -12,9 +12,23 @@ 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 { logCliConfiguration, logUserPrompt, logToolCall, logApiRequest, logApiError, logApiResponse, logFlashFallback, logSlashCommand, logKittySequenceOverflow, logChatCompression, } from './loggers.js';
-export { StartSessionEvent, EndSessionEvent, UserPromptEvent, ToolCallEvent, ApiRequestEvent, ApiErrorEvent, ApiResponseEvent, FlashFallbackEvent, KittySequenceOverflowEvent, makeSlashCommandEvent, SlashCommandStatus, makeChatCompressionEvent, } from './types.js';
+export { resolveTelemetrySettings, parseBooleanEnvFlag, parseTelemetryTargetValue, } from './config.js';
+export { GcpTraceExporter, GcpMetricExporter, GcpLogExporter, } from './gcp-exporters.js';
+export { logCliConfiguration, logUserPrompt, logToolCall, logApiRequest, logApiError, logApiResponse, logFlashFallback, logSlashCommand, logConversationFinishedEvent, logKittySequenceOverflow, logChatCompression, logToolOutputTruncated, logExtensionEnable, logExtensionInstallEvent, logExtensionUninstall, } 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';
+export { 
+// Core metrics functions
+recordToolCallMetrics, recordTokenUsageMetrics, recordApiResponseMetrics, recordApiErrorMetrics, recordFileOperationMetric, recordInvalidChunk, recordContentRetry, recordContentRetryFailure, recordModelRoutingMetrics, 
+// Performance monitoring functions
+recordStartupPerformance, recordMemoryUsage, recordCpuUsage, recordToolQueueDepth, recordToolExecutionBreakdown, recordTokenEfficiency, recordApiRequestBreakdown, recordPerformanceScore, recordPerformanceRegression, recordBaselineComparison, isPerformanceMonitoringActive, 
+// Performance monitoring types
+PerformanceMetricType, MemoryMetricType, ToolExecutionPhase, ApiRequestPhase, FileOperation, } from './metrics.js';
 //# sourceMappingURL=index.js.map

package/dist/src/telemetry/index.js.map

@@ -1 +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,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,aAAa,EACb,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,aAAa,EACb,eAAe,EACf,aAAa,EACb,gBAAgB,EAEhB,kBAAkB,EAClB,0BAA0B,EAE1B,qBAAqB,EACrB,kBAAkB,EAElB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,cAAc,kBAAkB,CAAC"}
+{"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,wBAAwB,EACxB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AACrB,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,EACtB,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,GACtB,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;AAChC,OAAO;AACL,yBAAyB;AACzB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,EACzB,yBAAyB;AACzB,mCAAmC;AACnC,wBAAwB,EACxB,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,4BAA4B,EAC5B,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,2BAA2B,EAC3B,wBAAwB,EACxB,6BAA6B;AAC7B,+BAA+B;AAC/B,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,aAAa,GACd,MAAM,cAAc,CAAC"}

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

@@ -3,18 +3,33 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Config } from '../config/config.js';
-import { ApiErrorEvent, ApiRequestEvent, ApiResponseEvent, IdeConnectionEvent, StartSessionEvent, ToolCallEvent, UserPromptEvent, FlashFallbackEvent, NextSpeakerCheckEvent, LoopDetectedEvent, SlashCommandEvent, KittySequenceOverflowEvent, ChatCompressionEvent } from './types.js';
+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, ExtensionDisableEvent, ExtensionEnableEvent, ExtensionUninstallEvent, ExtensionInstallEvent, ModelSlashCommandEvent } 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 logModelSlashCommand(config: Config, event: ModelSlashCommandEvent): 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;
+export declare function logExtensionDisable(config: Config, event: ExtensionDisableEvent): void;