@didim365/agent-cli-core 0.1.0

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

@@ -0,0 +1,33 @@
+/**
+ * @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, flushTelemetry, isTelemetrySdkInitialized, } from './sdk.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, logChatCompression, logToolOutputTruncated, logExtensionEnable, logExtensionInstallEvent, logExtensionUninstall, logExtensionUpdateEvent, logWebFetchFallbackAttempt, } from './loggers.js';
+export type { SlashCommandEvent, ChatCompressionEvent } from './types.js';
+export { SlashCommandStatus, EndSessionEvent, UserPromptEvent, ApiRequestEvent, ApiErrorEvent, ApiResponseEvent, FlashFallbackEvent, StartSessionEvent, ToolCallEvent, ConversationFinishedEvent, ToolOutputTruncatedEvent, WebFetchFallbackAttemptEvent, ToolCallDecision, } 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 { MemoryMonitor, initializeMemoryMonitor, getMemoryMonitor, recordCurrentMemoryUsage, startGlobalMemoryMonitoring, stopGlobalMemoryMonitoring, } from './memory-monitor.js';
+export type { MemorySnapshot, ProcessMetrics } from './memory-monitor.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 { ActivityMonitor, initializeActivityMonitor, getActivityMonitor, startGlobalActivityMonitoring, stopGlobalActivityMonitoring, } from './activity-monitor.js';
+export { recordToolCallMetrics, recordTokenUsageMetrics, recordApiResponseMetrics, recordApiErrorMetrics, recordFileOperationMetric, recordInvalidChunk, recordContentRetry, recordContentRetryFailure, recordModelRoutingMetrics, recordCustomTokenUsageMetrics, recordCustomApiResponseMetrics, recordExitFail, recordGenAiClientTokenUsage, recordGenAiClientOperationDuration, getConventionAttributes, recordStartupPerformance, recordMemoryUsage, recordCpuUsage, recordToolQueueDepth, recordToolExecutionBreakdown, recordTokenEfficiency, recordApiRequestBreakdown, recordPerformanceScore, recordPerformanceRegression, recordBaselineComparison, isPerformanceMonitoringActive, recordFlickerFrame, recordSlowRender, PerformanceMetricType, MemoryMetricType, ToolExecutionPhase, ApiRequestPhase, FileOperation, GenAiOperationName, GenAiProviderName, GenAiTokenType, } from './metrics.js';
+export { runInDevTraceSpan, type SpanMetadata } from './trace.js';
+export { startupProfiler, StartupProfiler } from './startupProfiler.js';

package/dist/src/telemetry/index.js

@@ -0,0 +1,44 @@
+/**
+ * @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, flushTelemetry, isTelemetrySdkInitialized, } from './sdk.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, logChatCompression, logToolOutputTruncated, logExtensionEnable, logExtensionInstallEvent, logExtensionUninstall, logExtensionUpdateEvent, logWebFetchFallbackAttempt, } from './loggers.js';
+export { SlashCommandStatus, EndSessionEvent, UserPromptEvent, ApiRequestEvent, ApiErrorEvent, ApiResponseEvent, FlashFallbackEvent, StartSessionEvent, ToolCallEvent, ConversationFinishedEvent, ToolOutputTruncatedEvent, WebFetchFallbackAttemptEvent, ToolCallDecision, } 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 { MemoryMonitor, initializeMemoryMonitor, getMemoryMonitor, recordCurrentMemoryUsage, startGlobalMemoryMonitoring, stopGlobalMemoryMonitoring, } from './memory-monitor.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 { ActivityMonitor, initializeActivityMonitor, getActivityMonitor, startGlobalActivityMonitoring, stopGlobalActivityMonitoring, } from './activity-monitor.js';
+export { 
+// Core metrics functions
+recordToolCallMetrics, recordTokenUsageMetrics, recordApiResponseMetrics, recordApiErrorMetrics, recordFileOperationMetric, recordInvalidChunk, recordContentRetry, recordContentRetryFailure, recordModelRoutingMetrics, 
+// Custom metrics for token usage and API responses
+recordCustomTokenUsageMetrics, recordCustomApiResponseMetrics, recordExitFail, 
+// OpenTelemetry GenAI semantic convention for token usage and operation duration
+recordGenAiClientTokenUsage, recordGenAiClientOperationDuration, getConventionAttributes, 
+// Performance monitoring functions
+recordStartupPerformance, recordMemoryUsage, recordCpuUsage, recordToolQueueDepth, recordToolExecutionBreakdown, recordTokenEfficiency, recordApiRequestBreakdown, recordPerformanceScore, recordPerformanceRegression, recordBaselineComparison, isPerformanceMonitoringActive, recordFlickerFrame, recordSlowRender, 
+// Performance monitoring types
+PerformanceMetricType, MemoryMetricType, ToolExecutionPhase, ApiRequestPhase, FileOperation, 
+// OpenTelemetry Semantic Convention types
+GenAiOperationName, GenAiProviderName, GenAiTokenType, } from './metrics.js';
+export { runInDevTraceSpan } from './trace.js';
+export { startupProfiler, StartupProfiler } from './startupProfiler.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":"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"}

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,46 @@
+/**
+ * @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, ChatCompressionEvent, MalformedJsonResponseEvent, InvalidChunkEvent, ContentRetryEvent, ContentRetryFailureEvent, RipgrepFallbackEvent, ToolOutputTruncatedEvent, ModelRoutingEvent, ExtensionDisableEvent, ExtensionEnableEvent, ExtensionUninstallEvent, ExtensionInstallEvent, ModelSlashCommandEvent, EditStrategyEvent, EditCorrectionEvent, AgentStartEvent, AgentFinishEvent, RecoveryAttemptEvent, WebFetchFallbackAttemptEvent, ExtensionUpdateEvent, ApprovalModeSwitchEvent, ApprovalModeDurationEvent, HookCallEvent, StartupStatsEvent, LlmLoopCheckEvent } 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 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): Promise<void>;
+export declare function logExtensionUninstall(config: Config, event: ExtensionUninstallEvent): Promise<void>;
+export declare function logExtensionUpdateEvent(config: Config, event: ExtensionUpdateEvent): Promise<void>;
+export declare function logExtensionEnable(config: Config, event: ExtensionEnableEvent): Promise<void>;
+export declare function logExtensionDisable(config: Config, event: ExtensionDisableEvent): Promise<void>;
+export declare function logEditStrategy(config: Config, event: EditStrategyEvent): void;
+export declare function logEditCorrectionEvent(config: Config, event: EditCorrectionEvent): void;
+export declare function logAgentStart(config: Config, event: AgentStartEvent): void;
+export declare function logAgentFinish(config: Config, event: AgentFinishEvent): void;
+export declare function logRecoveryAttempt(config: Config, event: RecoveryAttemptEvent): void;
+export declare function logWebFetchFallbackAttempt(config: Config, event: WebFetchFallbackAttemptEvent): void;
+export declare function logLlmLoopCheck(config: Config, event: LlmLoopCheckEvent): void;
+export declare function logApprovalModeSwitch(config: Config, event: ApprovalModeSwitchEvent): void;
+export declare function logApprovalModeDuration(config: Config, event: ApprovalModeDurationEvent): void;
+export declare function logHookCall(config: Config, event: HookCallEvent): void;
+export declare function logStartupStats(config: Config, event: StartupStatsEvent): void;