@machina.ai/cell-cli-core 1.6.1-rc2 → 1.8.2-rc1

package/dist/src/telemetry/metrics.js

@@ -3,20 +3,252 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { metrics, ValueType } from '@opentelemetry/api';
-import { SERVICE_NAME, METRIC_TOOL_CALL_COUNT, METRIC_TOOL_CALL_LATENCY, METRIC_API_REQUEST_COUNT, METRIC_API_REQUEST_LATENCY, METRIC_TOKEN_USAGE, METRIC_SESSION_COUNT, METRIC_FILE_OPERATION_COUNT, EVENT_CHAT_COMPRESSION, METRIC_INVALID_CHUNK_COUNT, METRIC_CONTENT_RETRY_COUNT, METRIC_CONTENT_RETRY_FAILURE_COUNT, METRIC_MODEL_ROUTING_LATENCY, METRIC_MODEL_ROUTING_FAILURE_COUNT, } from './constants.js';
+import { diag, metrics, ValueType } from '@opentelemetry/api';
+import { SERVICE_NAME, EVENT_CHAT_COMPRESSION } from './constants.js';
+const TOOL_CALL_COUNT = 'gemini_cli.tool.call.count';
+const TOOL_CALL_LATENCY = 'gemini_cli.tool.call.latency';
+const API_REQUEST_COUNT = 'gemini_cli.api.request.count';
+const API_REQUEST_LATENCY = 'gemini_cli.api.request.latency';
+const TOKEN_USAGE = 'gemini_cli.token.usage';
+const SESSION_COUNT = 'gemini_cli.session.count';
+const FILE_OPERATION_COUNT = 'gemini_cli.file.operation.count';
+const INVALID_CHUNK_COUNT = 'gemini_cli.chat.invalid_chunk.count';
+const CONTENT_RETRY_COUNT = 'gemini_cli.chat.content_retry.count';
+const CONTENT_RETRY_FAILURE_COUNT = 'gemini_cli.chat.content_retry_failure.count';
+const MODEL_ROUTING_LATENCY = 'gemini_cli.model_routing.latency';
+const MODEL_ROUTING_FAILURE_COUNT = 'gemini_cli.model_routing.failure.count';
+const MODEL_SLASH_COMMAND_CALL_COUNT = 'gemini_cli.slash_command.model.call_count';
+// Performance Monitoring Metrics
+const STARTUP_TIME = 'gemini_cli.startup.duration';
+const MEMORY_USAGE = 'gemini_cli.memory.usage';
+const CPU_USAGE = 'gemini_cli.cpu.usage';
+const TOOL_QUEUE_DEPTH = 'gemini_cli.tool.queue.depth';
+const TOOL_EXECUTION_BREAKDOWN = 'gemini_cli.tool.execution.breakdown';
+const TOKEN_EFFICIENCY = 'gemini_cli.token.efficiency';
+const API_REQUEST_BREAKDOWN = 'gemini_cli.api.request.breakdown';
+const PERFORMANCE_SCORE = 'gemini_cli.performance.score';
+const REGRESSION_DETECTION = 'gemini_cli.performance.regression';
+const REGRESSION_PERCENTAGE_CHANGE = 'gemini_cli.performance.regression.percentage_change';
+const BASELINE_COMPARISON = 'gemini_cli.performance.baseline.comparison';
+const baseMetricDefinition = {
+    getCommonAttributes: (config) => ({
+        'session.id': config.getSessionId(),
+    }),
+};
+const COUNTER_DEFINITIONS = {
+    [TOOL_CALL_COUNT]: {
+        description: 'Counts tool calls, tagged by function name and success.',
+        valueType: ValueType.INT,
+        assign: (c) => (toolCallCounter = c),
+        attributes: {},
+    },
+    [API_REQUEST_COUNT]: {
+        description: 'Counts API requests, tagged by model and status.',
+        valueType: ValueType.INT,
+        assign: (c) => (apiRequestCounter = c),
+        attributes: {},
+    },
+    [TOKEN_USAGE]: {
+        description: 'Counts the total number of tokens used.',
+        valueType: ValueType.INT,
+        assign: (c) => (tokenUsageCounter = c),
+        attributes: {},
+    },
+    [SESSION_COUNT]: {
+        description: 'Count of CLI sessions started.',
+        valueType: ValueType.INT,
+        assign: (c) => (sessionCounter = c),
+        attributes: {},
+    },
+    [FILE_OPERATION_COUNT]: {
+        description: 'Counts file operations (create, read, update).',
+        valueType: ValueType.INT,
+        assign: (c) => (fileOperationCounter = c),
+        attributes: {},
+    },
+    [INVALID_CHUNK_COUNT]: {
+        description: 'Counts invalid chunks received from a stream.',
+        valueType: ValueType.INT,
+        assign: (c) => (invalidChunkCounter = c),
+        attributes: {},
+    },
+    [CONTENT_RETRY_COUNT]: {
+        description: 'Counts retries due to content errors (e.g., empty stream).',
+        valueType: ValueType.INT,
+        assign: (c) => (contentRetryCounter = c),
+        attributes: {},
+    },
+    [CONTENT_RETRY_FAILURE_COUNT]: {
+        description: 'Counts occurrences of all content retries failing.',
+        valueType: ValueType.INT,
+        assign: (c) => (contentRetryFailureCounter = c),
+        attributes: {},
+    },
+    [MODEL_ROUTING_FAILURE_COUNT]: {
+        description: 'Counts model routing failures.',
+        valueType: ValueType.INT,
+        assign: (c) => (modelRoutingFailureCounter = c),
+        attributes: {},
+    },
+    [MODEL_SLASH_COMMAND_CALL_COUNT]: {
+        description: 'Counts model slash command calls.',
+        valueType: ValueType.INT,
+        assign: (c) => (modelSlashCommandCallCounter = c),
+        attributes: {},
+    },
+    [EVENT_CHAT_COMPRESSION]: {
+        description: 'Counts chat compression events.',
+        valueType: ValueType.INT,
+        assign: (c) => (chatCompressionCounter = c),
+        attributes: {},
+    },
+};
+const HISTOGRAM_DEFINITIONS = {
+    [TOOL_CALL_LATENCY]: {
+        description: 'Latency of tool calls in milliseconds.',
+        unit: 'ms',
+        valueType: ValueType.INT,
+        assign: (h) => (toolCallLatencyHistogram = h),
+        attributes: {},
+    },
+    [API_REQUEST_LATENCY]: {
+        description: 'Latency of API requests in milliseconds.',
+        unit: 'ms',
+        valueType: ValueType.INT,
+        assign: (h) => (apiRequestLatencyHistogram = h),
+        attributes: {},
+    },
+    [MODEL_ROUTING_LATENCY]: {
+        description: 'Latency of model routing decisions in milliseconds.',
+        unit: 'ms',
+        valueType: ValueType.INT,
+        assign: (h) => (modelRoutingLatencyHistogram = h),
+        attributes: {},
+    },
+};
+const PERFORMANCE_COUNTER_DEFINITIONS = {
+    [REGRESSION_DETECTION]: {
+        description: 'Performance regression detection events.',
+        valueType: ValueType.INT,
+        assign: (c) => (regressionDetectionCounter = c),
+        attributes: {},
+    },
+};
+const PERFORMANCE_HISTOGRAM_DEFINITIONS = {
+    [STARTUP_TIME]: {
+        description: 'CLI startup time in milliseconds, broken down by initialization phase.',
+        unit: 'ms',
+        valueType: ValueType.DOUBLE,
+        assign: (h) => (startupTimeHistogram = h),
+        attributes: {},
+    },
+    [MEMORY_USAGE]: {
+        description: 'Memory usage in bytes.',
+        unit: 'bytes',
+        valueType: ValueType.INT,
+        assign: (h) => (memoryUsageGauge = h),
+        attributes: {},
+    },
+    [CPU_USAGE]: {
+        description: 'CPU usage percentage.',
+        unit: 'percent',
+        valueType: ValueType.DOUBLE,
+        assign: (h) => (cpuUsageGauge = h),
+        attributes: {},
+    },
+    [TOOL_QUEUE_DEPTH]: {
+        description: 'Number of tools in execution queue.',
+        unit: 'count',
+        valueType: ValueType.INT,
+        assign: (h) => (toolQueueDepthGauge = h),
+        attributes: {},
+    },
+    [TOOL_EXECUTION_BREAKDOWN]: {
+        description: 'Tool execution time breakdown by phase in milliseconds.',
+        unit: 'ms',
+        valueType: ValueType.INT,
+        assign: (h) => (toolExecutionBreakdownHistogram = h),
+        attributes: {},
+    },
+    [TOKEN_EFFICIENCY]: {
+        description: 'Token efficiency metrics (tokens per operation, cache hit rate, etc.).',
+        unit: 'ratio',
+        valueType: ValueType.DOUBLE,
+        assign: (h) => (tokenEfficiencyHistogram = h),
+        attributes: {},
+    },
+    [API_REQUEST_BREAKDOWN]: {
+        description: 'API request time breakdown by phase in milliseconds.',
+        unit: 'ms',
+        valueType: ValueType.INT,
+        assign: (h) => (apiRequestBreakdownHistogram = h),
+        attributes: {},
+    },
+    [PERFORMANCE_SCORE]: {
+        description: 'Composite performance score (0-100).',
+        unit: 'score',
+        valueType: ValueType.DOUBLE,
+        assign: (h) => (performanceScoreGauge = h),
+        attributes: {},
+    },
+    [REGRESSION_PERCENTAGE_CHANGE]: {
+        description: 'Percentage change compared to baseline for detected regressions.',
+        unit: 'percent',
+        valueType: ValueType.DOUBLE,
+        assign: (h) => (regressionPercentageChangeHistogram = h),
+        attributes: {},
+    },
+    [BASELINE_COMPARISON]: {
+        description: 'Performance comparison to established baseline (percentage change).',
+        unit: 'percent',
+        valueType: ValueType.DOUBLE,
+        assign: (h) => (baselineComparisonHistogram = h),
+        attributes: {},
+    },
+};
 export var FileOperation;
 (function (FileOperation) {
     FileOperation["CREATE"] = "create";
     FileOperation["READ"] = "read";
     FileOperation["UPDATE"] = "update";
 })(FileOperation || (FileOperation = {}));
+export var PerformanceMetricType;
+(function (PerformanceMetricType) {
+    PerformanceMetricType["STARTUP"] = "startup";
+    PerformanceMetricType["MEMORY"] = "memory";
+    PerformanceMetricType["CPU"] = "cpu";
+    PerformanceMetricType["TOOL_EXECUTION"] = "tool_execution";
+    PerformanceMetricType["API_REQUEST"] = "api_request";
+    PerformanceMetricType["TOKEN_EFFICIENCY"] = "token_efficiency";
+})(PerformanceMetricType || (PerformanceMetricType = {}));
+export var MemoryMetricType;
+(function (MemoryMetricType) {
+    MemoryMetricType["HEAP_USED"] = "heap_used";
+    MemoryMetricType["HEAP_TOTAL"] = "heap_total";
+    MemoryMetricType["EXTERNAL"] = "external";
+    MemoryMetricType["RSS"] = "rss";
+})(MemoryMetricType || (MemoryMetricType = {}));
+export var ToolExecutionPhase;
+(function (ToolExecutionPhase) {
+    ToolExecutionPhase["VALIDATION"] = "validation";
+    ToolExecutionPhase["PREPARATION"] = "preparation";
+    ToolExecutionPhase["EXECUTION"] = "execution";
+    ToolExecutionPhase["RESULT_PROCESSING"] = "result_processing";
+})(ToolExecutionPhase || (ToolExecutionPhase = {}));
+export var ApiRequestPhase;
+(function (ApiRequestPhase) {
+    ApiRequestPhase["REQUEST_PREPARATION"] = "request_preparation";
+    ApiRequestPhase["NETWORK_LATENCY"] = "network_latency";
+    ApiRequestPhase["RESPONSE_PROCESSING"] = "response_processing";
+    ApiRequestPhase["TOKEN_PROCESSING"] = "token_processing";
+})(ApiRequestPhase || (ApiRequestPhase = {}));
 let cliMeter;
 let toolCallCounter;
 let toolCallLatencyHistogram;
 let apiRequestCounter;
 let apiRequestLatencyHistogram;
 let tokenUsageCounter;
+let sessionCounter;
 let fileOperationCounter;
 let chatCompressionCounter;
 let invalidChunkCounter;
@@ -24,12 +256,21 @@ let contentRetryCounter;
 let contentRetryFailureCounter;
 let modelRoutingLatencyHistogram;
 let modelRoutingFailureCounter;
+let modelSlashCommandCallCounter;
+// Performance Monitoring Metrics
+let startupTimeHistogram;
+let memoryUsageGauge; // Using Histogram until ObservableGauge is available
+let cpuUsageGauge;
+let toolQueueDepthGauge;
+let toolExecutionBreakdownHistogram;
+let tokenEfficiencyHistogram;
+let apiRequestBreakdownHistogram;
+let performanceScoreGauge;
+let regressionDetectionCounter;
+let regressionPercentageChangeHistogram;
+let baselineComparisonHistogram;
 let isMetricsInitialized = false;
-function getCommonAttributes(config) {
-    return {
-        'session.id': config.getSessionId(),
-    };
-}
+let isPerformanceMonitoringEnabled = false;
 export function getMeter() {
     if (!cliMeter) {
         cliMeter = metrics.getMeter(SERVICE_NAME);
@@ -42,148 +283,88 @@ export function initializeMetrics(config) {
     const meter = getMeter();
     if (!meter)
         return;
-    toolCallCounter = meter.createCounter(METRIC_TOOL_CALL_COUNT, {
-        description: 'Counts tool calls, tagged by function name and success.',
-        valueType: ValueType.INT,
-    });
-    toolCallLatencyHistogram = meter.createHistogram(METRIC_TOOL_CALL_LATENCY, {
-        description: 'Latency of tool calls in milliseconds.',
-        unit: 'ms',
-        valueType: ValueType.INT,
-    });
-    apiRequestCounter = meter.createCounter(METRIC_API_REQUEST_COUNT, {
-        description: 'Counts API requests, tagged by model and status.',
-        valueType: ValueType.INT,
-    });
-    apiRequestLatencyHistogram = meter.createHistogram(METRIC_API_REQUEST_LATENCY, {
-        description: 'Latency of API requests in milliseconds.',
-        unit: 'ms',
-        valueType: ValueType.INT,
-    });
-    tokenUsageCounter = meter.createCounter(METRIC_TOKEN_USAGE, {
-        description: 'Counts the total number of tokens used.',
-        valueType: ValueType.INT,
-    });
-    fileOperationCounter = meter.createCounter(METRIC_FILE_OPERATION_COUNT, {
-        description: 'Counts file operations (create, read, update).',
-        valueType: ValueType.INT,
-    });
-    chatCompressionCounter = meter.createCounter(EVENT_CHAT_COMPRESSION, {
-        description: 'Counts chat compression events.',
-        valueType: ValueType.INT,
-    });
-    // New counters for content errors
-    invalidChunkCounter = meter.createCounter(METRIC_INVALID_CHUNK_COUNT, {
-        description: 'Counts invalid chunks received from a stream.',
-        valueType: ValueType.INT,
-    });
-    contentRetryCounter = meter.createCounter(METRIC_CONTENT_RETRY_COUNT, {
-        description: 'Counts retries due to content errors (e.g., empty stream).',
-        valueType: ValueType.INT,
+    // Initialize core metrics
+    Object.entries(COUNTER_DEFINITIONS).forEach(([name, { description, valueType, assign }]) => {
+        assign(meter.createCounter(name, { description, valueType }));
     });
-    contentRetryFailureCounter = meter.createCounter(METRIC_CONTENT_RETRY_FAILURE_COUNT, {
-        description: 'Counts occurrences of all content retries failing.',
-        valueType: ValueType.INT,
-    });
-    modelRoutingLatencyHistogram = meter.createHistogram(METRIC_MODEL_ROUTING_LATENCY, {
-        description: 'Latency of model routing decisions in milliseconds.',
-        unit: 'ms',
-        valueType: ValueType.INT,
-    });
-    modelRoutingFailureCounter = meter.createCounter(METRIC_MODEL_ROUTING_FAILURE_COUNT, {
-        description: 'Counts model routing failures.',
-        valueType: ValueType.INT,
+    Object.entries(HISTOGRAM_DEFINITIONS).forEach(([name, { description, unit, valueType, assign }]) => {
+        assign(meter.createHistogram(name, { description, unit, valueType }));
     });
-    const sessionCounter = meter.createCounter(METRIC_SESSION_COUNT, {
-        description: 'Count of CLI sessions started.',
-        valueType: ValueType.INT,
-    });
-    sessionCounter.add(1, getCommonAttributes(config));
+    // Increment session counter after all metrics are initialized
+    sessionCounter?.add(1, baseMetricDefinition.getCommonAttributes(config));
+    // Initialize performance monitoring metrics if enabled
+    initializePerformanceMonitoring(config);
     isMetricsInitialized = true;
 }
-export function recordChatCompressionMetrics(config, args) {
+export function recordChatCompressionMetrics(config, attributes) {
     if (!chatCompressionCounter || !isMetricsInitialized)
         return;
     chatCompressionCounter.add(1, {
-        ...getCommonAttributes(config),
-        ...args,
+        ...baseMetricDefinition.getCommonAttributes(config),
+        ...attributes,
     });
 }
-export function recordToolCallMetrics(config, functionName, durationMs, success, decision, tool_type) {
+export function recordToolCallMetrics(config, durationMs, attributes) {
     if (!toolCallCounter || !toolCallLatencyHistogram || !isMetricsInitialized)
         return;
     const metricAttributes = {
-        ...getCommonAttributes(config),
-        function_name: functionName,
-        success,
-        decision,
-        tool_type,
+        ...baseMetricDefinition.getCommonAttributes(config),
+        ...attributes,
     };
     toolCallCounter.add(1, metricAttributes);
     toolCallLatencyHistogram.record(durationMs, {
-        ...getCommonAttributes(config),
-        function_name: functionName,
+        ...baseMetricDefinition.getCommonAttributes(config),
+        function_name: attributes.function_name,
     });
 }
-export function recordTokenUsageMetrics(config, model, tokenCount, type) {
+export function recordTokenUsageMetrics(config, tokenCount, attributes) {
     if (!tokenUsageCounter || !isMetricsInitialized)
         return;
     tokenUsageCounter.add(tokenCount, {
-        ...getCommonAttributes(config),
-        model,
-        type,
+        ...baseMetricDefinition.getCommonAttributes(config),
+        ...attributes,
     });
 }
-export function recordApiResponseMetrics(config, model, durationMs, statusCode) {
+export function recordApiResponseMetrics(config, durationMs, attributes) {
     if (!apiRequestCounter ||
         !apiRequestLatencyHistogram ||
         !isMetricsInitialized)
         return;
     const metricAttributes = {
-        ...getCommonAttributes(config),
-        model,
-        status_code: statusCode ?? 'ok',
+        ...baseMetricDefinition.getCommonAttributes(config),
+        model: attributes.model,
+        status_code: attributes.status_code ?? 'ok',
     };
     apiRequestCounter.add(1, metricAttributes);
     apiRequestLatencyHistogram.record(durationMs, {
-        ...getCommonAttributes(config),
-        model,
+        ...baseMetricDefinition.getCommonAttributes(config),
+        model: attributes.model,
     });
 }
-export function recordApiErrorMetrics(config, model, durationMs, statusCode, errorType) {
+export function recordApiErrorMetrics(config, durationMs, attributes) {
     if (!apiRequestCounter ||
         !apiRequestLatencyHistogram ||
         !isMetricsInitialized)
         return;
     const metricAttributes = {
-        ...getCommonAttributes(config),
-        model,
-        status_code: statusCode ?? 'error',
-        error_type: errorType ?? 'unknown',
+        ...baseMetricDefinition.getCommonAttributes(config),
+        model: attributes.model,
+        status_code: attributes.status_code ?? 'error',
+        error_type: attributes.error_type ?? 'unknown',
     };
     apiRequestCounter.add(1, metricAttributes);
     apiRequestLatencyHistogram.record(durationMs, {
-        ...getCommonAttributes(config),
-        model,
+        ...baseMetricDefinition.getCommonAttributes(config),
+        model: attributes.model,
     });
 }
-export function recordFileOperationMetric(config, operation, lines, mimetype, extension, programming_language) {
+export function recordFileOperationMetric(config, attributes) {
     if (!fileOperationCounter || !isMetricsInitialized)
         return;
-    const attributes = {
-        ...getCommonAttributes(config),
-        operation,
-    };
-    if (lines !== undefined)
-        attributes['lines'] = lines;
-    if (mimetype !== undefined)
-        attributes['mimetype'] = mimetype;
-    if (extension !== undefined)
-        attributes['extension'] = extension;
-    if (programming_language !== undefined) {
-        attributes['programming_language'] = programming_language;
-    }
-    fileOperationCounter.add(1, attributes);
+    fileOperationCounter.add(1, {
+        ...baseMetricDefinition.getCommonAttributes(config),
+        ...attributes,
+    });
 }
 // --- New Metric Recording Functions ---
 /**
@@ -192,7 +373,7 @@ export function recordFileOperationMetric(config, operation, lines, mimetype, ex
 export function recordInvalidChunk(config) {
     if (!invalidChunkCounter || !isMetricsInitialized)
         return;
-    invalidChunkCounter.add(1, getCommonAttributes(config));
+    invalidChunkCounter.add(1, baseMetricDefinition.getCommonAttributes(config));
 }
 /**
  * Records a metric for when a retry is triggered due to a content error.
@@ -200,7 +381,7 @@ export function recordInvalidChunk(config) {
 export function recordContentRetry(config) {
     if (!contentRetryCounter || !isMetricsInitialized)
         return;
-    contentRetryCounter.add(1, getCommonAttributes(config));
+    contentRetryCounter.add(1, baseMetricDefinition.getCommonAttributes(config));
 }
 /**
  * Records a metric for when all content error retries have failed for a request.
@@ -208,7 +389,15 @@ export function recordContentRetry(config) {
 export function recordContentRetryFailure(config) {
     if (!contentRetryFailureCounter || !isMetricsInitialized)
         return;
-    contentRetryFailureCounter.add(1, getCommonAttributes(config));
+    contentRetryFailureCounter.add(1, baseMetricDefinition.getCommonAttributes(config));
+}
+export function recordModelSlashCommand(config, event) {
+    if (!modelSlashCommandCallCounter || !isMetricsInitialized)
+        return;
+    modelSlashCommandCallCounter.add(1, {
+        ...baseMetricDefinition.getCommonAttributes(config),
+        'slash_command.model.model_name': event.model_name,
+    });
 }
 export function recordModelRoutingMetrics(config, event) {
     if (!modelRoutingLatencyHistogram ||
@@ -216,16 +405,141 @@ export function recordModelRoutingMetrics(config, event) {
         !isMetricsInitialized)
         return;
     modelRoutingLatencyHistogram.record(event.routing_latency_ms, {
-        ...getCommonAttributes(config),
+        ...baseMetricDefinition.getCommonAttributes(config),
         'routing.decision_model': event.decision_model,
         'routing.decision_source': event.decision_source,
     });
     if (event.failed) {
         modelRoutingFailureCounter.add(1, {
-            ...getCommonAttributes(config),
+            ...baseMetricDefinition.getCommonAttributes(config),
             'routing.decision_source': event.decision_source,
             'routing.error_message': event.error_message,
         });
     }
 }
+// Performance Monitoring Functions
+export function initializePerformanceMonitoring(config) {
+    const meter = getMeter();
+    if (!meter)
+        return;
+    // Check if performance monitoring is enabled in config
+    // For now, enable performance monitoring when telemetry is enabled
+    // TODO: Add specific performance monitoring settings to config
+    isPerformanceMonitoringEnabled = config.getTelemetryEnabled();
+    if (!isPerformanceMonitoringEnabled)
+        return;
+    Object.entries(PERFORMANCE_COUNTER_DEFINITIONS).forEach(([name, { description, valueType, assign }]) => {
+        assign(meter.createCounter(name, { description, valueType }));
+    });
+    Object.entries(PERFORMANCE_HISTOGRAM_DEFINITIONS).forEach(([name, { description, unit, valueType, assign }]) => {
+        assign(meter.createHistogram(name, { description, unit, valueType }));
+    });
+}
+export function recordStartupPerformance(config, durationMs, attributes) {
+    if (!startupTimeHistogram || !isPerformanceMonitoringEnabled)
+        return;
+    const metricAttributes = {
+        ...baseMetricDefinition.getCommonAttributes(config),
+        phase: attributes.phase,
+        ...attributes.details,
+    };
+    startupTimeHistogram.record(durationMs, metricAttributes);
+}
+export function recordMemoryUsage(config, bytes, attributes) {
+    if (!memoryUsageGauge || !isPerformanceMonitoringEnabled)
+        return;
+    const metricAttributes = {
+        ...baseMetricDefinition.getCommonAttributes(config),
+        ...attributes,
+    };
+    memoryUsageGauge.record(bytes, metricAttributes);
+}
+export function recordCpuUsage(config, percentage, attributes) {
+    if (!cpuUsageGauge || !isPerformanceMonitoringEnabled)
+        return;
+    const metricAttributes = {
+        ...baseMetricDefinition.getCommonAttributes(config),
+        ...attributes,
+    };
+    cpuUsageGauge.record(percentage, metricAttributes);
+}
+export function recordToolQueueDepth(config, queueDepth) {
+    if (!toolQueueDepthGauge || !isPerformanceMonitoringEnabled)
+        return;
+    const attributes = {
+        ...baseMetricDefinition.getCommonAttributes(config),
+    };
+    toolQueueDepthGauge.record(queueDepth, attributes);
+}
+export function recordToolExecutionBreakdown(config, durationMs, attributes) {
+    if (!toolExecutionBreakdownHistogram || !isPerformanceMonitoringEnabled)
+        return;
+    const metricAttributes = {
+        ...baseMetricDefinition.getCommonAttributes(config),
+        ...attributes,
+    };
+    toolExecutionBreakdownHistogram.record(durationMs, metricAttributes);
+}
+export function recordTokenEfficiency(config, value, attributes) {
+    if (!tokenEfficiencyHistogram || !isPerformanceMonitoringEnabled)
+        return;
+    const metricAttributes = {
+        ...baseMetricDefinition.getCommonAttributes(config),
+        ...attributes,
+    };
+    tokenEfficiencyHistogram.record(value, metricAttributes);
+}
+export function recordApiRequestBreakdown(config, durationMs, attributes) {
+    if (!apiRequestBreakdownHistogram || !isPerformanceMonitoringEnabled)
+        return;
+    const metricAttributes = {
+        ...baseMetricDefinition.getCommonAttributes(config),
+        ...attributes,
+    };
+    apiRequestBreakdownHistogram.record(durationMs, metricAttributes);
+}
+export function recordPerformanceScore(config, score, attributes) {
+    if (!performanceScoreGauge || !isPerformanceMonitoringEnabled)
+        return;
+    const metricAttributes = {
+        ...baseMetricDefinition.getCommonAttributes(config),
+        ...attributes,
+    };
+    performanceScoreGauge.record(score, metricAttributes);
+}
+export function recordPerformanceRegression(config, attributes) {
+    if (!regressionDetectionCounter || !isPerformanceMonitoringEnabled)
+        return;
+    const metricAttributes = {
+        ...baseMetricDefinition.getCommonAttributes(config),
+        ...attributes,
+    };
+    regressionDetectionCounter.add(1, metricAttributes);
+    if (attributes.baseline_value !== 0 && regressionPercentageChangeHistogram) {
+        const percentageChange = ((attributes.current_value - attributes.baseline_value) /
+            attributes.baseline_value) *
+            100;
+        regressionPercentageChangeHistogram.record(percentageChange, metricAttributes);
+    }
+}
+export function recordBaselineComparison(config, attributes) {
+    if (!baselineComparisonHistogram || !isPerformanceMonitoringEnabled)
+        return;
+    if (attributes.baseline_value === 0) {
+        diag.warn('Baseline value is zero, skipping comparison.');
+        return;
+    }
+    const percentageChange = ((attributes.current_value - attributes.baseline_value) /
+        attributes.baseline_value) *
+        100;
+    const metricAttributes = {
+        ...baseMetricDefinition.getCommonAttributes(config),
+        ...attributes,
+    };
+    baselineComparisonHistogram.record(percentageChange, metricAttributes);
+}
+// Utility function to check if performance monitoring is enabled
+export function isPerformanceMonitoringActive() {
+    return isPerformanceMonitoringEnabled && isMetricsInitialized;
+}
 //# sourceMappingURL=metrics.js.map