@google/gemini-cli-core 0.0.1

package/dist/src/telemetry/gcp-exporters.js

@@ -0,0 +1,117 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { TraceExporter } from '@google-cloud/opentelemetry-cloud-trace-exporter';
+import { MetricExporter } from '@google-cloud/opentelemetry-cloud-monitoring-exporter';
+import { Logging } from '@google-cloud/logging';
+import { hrTimeToMilliseconds } from '@opentelemetry/core';
+import { ExportResultCode } from '@opentelemetry/core';
+/**
+ * Google Cloud Trace exporter that extends the official trace exporter
+ */
+export class GcpTraceExporter extends TraceExporter {
+    constructor(projectId) {
+        super({
+            projectId,
+            resourceFilter: /^gcp\./,
+        });
+    }
+}
+/**
+ * Google Cloud Monitoring exporter that extends the official metrics exporter
+ */
+export class GcpMetricExporter extends MetricExporter {
+    constructor(projectId) {
+        super({
+            projectId,
+            prefix: 'custom.googleapis.com/gemini_cli',
+        });
+    }
+}
+/**
+ * Google Cloud Logging exporter that uses the Cloud Logging client
+ */
+export class GcpLogExporter {
+    logging;
+    log;
+    pendingWrites = [];
+    constructor(projectId) {
+        this.logging = new Logging({ projectId });
+        this.log = this.logging.log('gemini_cli');
+    }
+    export(logs, resultCallback) {
+        try {
+            const entries = logs.map((log) => {
+                const entry = this.log.entry({
+                    severity: this.mapSeverityToCloudLogging(log.severityNumber),
+                    timestamp: new Date(hrTimeToMilliseconds(log.hrTime)),
+                    resource: {
+                        type: 'global',
+                        labels: {
+                            project_id: this.logging.projectId,
+                        },
+                    },
+                }, {
+                    session_id: log.attributes?.['session.id'],
+                    ...log.attributes,
+                    ...log.resource?.attributes,
+                    message: log.body,
+                });
+                return entry;
+            });
+            const writePromise = this.log
+                .write(entries)
+                .then(() => {
+                resultCallback({ code: ExportResultCode.SUCCESS });
+            })
+                .catch((error) => {
+                resultCallback({
+                    code: ExportResultCode.FAILED,
+                    error,
+                });
+            })
+                .finally(() => {
+                const index = this.pendingWrites.indexOf(writePromise);
+                if (index > -1) {
+                    this.pendingWrites.splice(index, 1);
+                }
+            });
+            this.pendingWrites.push(writePromise);
+        }
+        catch (error) {
+            resultCallback({
+                code: ExportResultCode.FAILED,
+                error: error,
+            });
+        }
+    }
+    async forceFlush() {
+        if (this.pendingWrites.length > 0) {
+            await Promise.all(this.pendingWrites);
+        }
+    }
+    async shutdown() {
+        await this.forceFlush();
+        this.pendingWrites = [];
+    }
+    mapSeverityToCloudLogging(severityNumber) {
+        if (!severityNumber)
+            return 'DEFAULT';
+        // Map OpenTelemetry severity numbers to Cloud Logging severity levels
+        // https://opentelemetry.io/docs/specs/otel/logs/data-model/#field-severitynumber
+        if (severityNumber >= 21)
+            return 'CRITICAL';
+        if (severityNumber >= 17)
+            return 'ERROR';
+        if (severityNumber >= 13)
+            return 'WARNING';
+        if (severityNumber >= 9)
+            return 'INFO';
+        if (severityNumber >= 5)
+            return 'DEBUG';
+        return 'DEFAULT';
+    }
+}
+//# sourceMappingURL=gcp-exporters.js.map

package/dist/src/telemetry/gcp-exporters.js.map

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

package/dist/src/telemetry/gcp-exporters.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/telemetry/gcp-exporters.test.js

@@ -0,0 +1,318 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { ExportResultCode } from '@opentelemetry/core';
+import { GcpTraceExporter, GcpMetricExporter, GcpLogExporter, } from './gcp-exporters.js';
+const mockLogEntry = { test: 'entry' };
+const mockLogWrite = vi.fn().mockResolvedValue(undefined);
+const mockLog = {
+    entry: vi.fn().mockReturnValue(mockLogEntry),
+    write: mockLogWrite,
+};
+const mockLogging = {
+    projectId: 'test-project',
+    log: vi.fn().mockReturnValue(mockLog),
+};
+vi.mock('@google-cloud/opentelemetry-cloud-trace-exporter', () => ({
+    TraceExporter: vi.fn().mockImplementation(() => ({
+        export: vi.fn(),
+        shutdown: vi.fn(),
+        forceFlush: vi.fn(),
+    })),
+}));
+vi.mock('@google-cloud/opentelemetry-cloud-monitoring-exporter', () => ({
+    MetricExporter: vi.fn().mockImplementation(() => ({
+        export: vi.fn(),
+        shutdown: vi.fn(),
+        forceFlush: vi.fn(),
+    })),
+}));
+vi.mock('@google-cloud/logging', () => ({
+    Logging: vi.fn().mockImplementation(() => mockLogging),
+}));
+describe('GCP Exporters', () => {
+    describe('GcpTraceExporter', () => {
+        it('should create a trace exporter with correct configuration', () => {
+            const exporter = new GcpTraceExporter('test-project');
+            expect(exporter).toBeDefined();
+        });
+        it('should create a trace exporter without project ID', () => {
+            const exporter = new GcpTraceExporter();
+            expect(exporter).toBeDefined();
+        });
+    });
+    describe('GcpMetricExporter', () => {
+        it('should create a metric exporter with correct configuration', () => {
+            const exporter = new GcpMetricExporter('test-project');
+            expect(exporter).toBeDefined();
+        });
+        it('should create a metric exporter without project ID', () => {
+            const exporter = new GcpMetricExporter();
+            expect(exporter).toBeDefined();
+        });
+    });
+    describe('GcpLogExporter', () => {
+        let exporter;
+        beforeEach(() => {
+            vi.clearAllMocks();
+            mockLogWrite.mockResolvedValue(undefined);
+            mockLog.entry.mockReturnValue(mockLogEntry);
+            exporter = new GcpLogExporter('test-project');
+        });
+        describe('constructor', () => {
+            it('should create a log exporter with project ID', () => {
+                expect(exporter).toBeDefined();
+                expect(mockLogging.log).toHaveBeenCalledWith('gemini_cli');
+            });
+            it('should create a log exporter without project ID', () => {
+                const exporterNoProject = new GcpLogExporter();
+                expect(exporterNoProject).toBeDefined();
+            });
+        });
+        describe('export', () => {
+            it('should export logs successfully', async () => {
+                const mockLogRecords = [
+                    {
+                        hrTime: [1234567890, 123456789],
+                        hrTimeObserved: [1234567890, 123456789],
+                        severityNumber: 9,
+                        severityText: 'INFO',
+                        body: 'Test log message',
+                        attributes: {
+                            'session.id': 'test-session',
+                            'custom.attribute': 'value',
+                        },
+                        resource: {
+                            attributes: {
+                                'service.name': 'test-service',
+                            },
+                        },
+                    },
+                ];
+                const callback = vi.fn();
+                exporter.export(mockLogRecords, callback);
+                await new Promise((resolve) => setTimeout(resolve, 0));
+                expect(mockLog.entry).toHaveBeenCalledWith(expect.objectContaining({
+                    severity: 'INFO',
+                    timestamp: expect.any(Date),
+                    resource: {
+                        type: 'global',
+                        labels: {
+                            project_id: 'test-project',
+                        },
+                    },
+                }), expect.objectContaining({
+                    message: 'Test log message',
+                    session_id: 'test-session',
+                    'custom.attribute': 'value',
+                    'service.name': 'test-service',
+                }));
+                expect(mockLog.write).toHaveBeenCalledWith([mockLogEntry]);
+                expect(callback).toHaveBeenCalledWith({
+                    code: ExportResultCode.SUCCESS,
+                });
+            });
+            it('should handle export failures', async () => {
+                const mockLogRecords = [
+                    {
+                        hrTime: [1234567890, 123456789],
+                        hrTimeObserved: [1234567890, 123456789],
+                        body: 'Test log message',
+                    },
+                ];
+                const error = new Error('Write failed');
+                mockLogWrite.mockRejectedValueOnce(error);
+                const callback = vi.fn();
+                exporter.export(mockLogRecords, callback);
+                await new Promise((resolve) => setTimeout(resolve, 0));
+                expect(callback).toHaveBeenCalledWith({
+                    code: ExportResultCode.FAILED,
+                    error,
+                });
+            });
+            it('should handle synchronous errors', () => {
+                const mockLogRecords = [
+                    {
+                        hrTime: [1234567890, 123456789],
+                        hrTimeObserved: [1234567890, 123456789],
+                        body: 'Test log message',
+                    },
+                ];
+                mockLog.entry.mockImplementation(() => {
+                    throw new Error('Entry creation failed');
+                });
+                const callback = vi.fn();
+                exporter.export(mockLogRecords, callback);
+                expect(callback).toHaveBeenCalledWith({
+                    code: ExportResultCode.FAILED,
+                    error: expect.any(Error),
+                });
+            });
+        });
+        describe('severity mapping', () => {
+            it('should map OpenTelemetry severity numbers to Cloud Logging levels', () => {
+                const testCases = [
+                    { severityNumber: undefined, expected: 'DEFAULT' },
+                    { severityNumber: 1, expected: 'DEFAULT' },
+                    { severityNumber: 5, expected: 'DEBUG' },
+                    { severityNumber: 9, expected: 'INFO' },
+                    { severityNumber: 13, expected: 'WARNING' },
+                    { severityNumber: 17, expected: 'ERROR' },
+                    { severityNumber: 21, expected: 'CRITICAL' },
+                    { severityNumber: 25, expected: 'CRITICAL' },
+                ];
+                testCases.forEach(({ severityNumber, expected }) => {
+                    const mockLogRecords = [
+                        {
+                            hrTime: [1234567890, 123456789],
+                            hrTimeObserved: [1234567890, 123456789],
+                            severityNumber,
+                            body: 'Test message',
+                        },
+                    ];
+                    const callback = vi.fn();
+                    exporter.export(mockLogRecords, callback);
+                    expect(mockLog.entry).toHaveBeenCalledWith(expect.objectContaining({
+                        severity: expected,
+                    }), expect.any(Object));
+                    mockLog.entry.mockClear();
+                });
+            });
+        });
+        describe('forceFlush', () => {
+            it('should resolve immediately when no pending writes exist', async () => {
+                await expect(exporter.forceFlush()).resolves.toBeUndefined();
+            });
+            it('should wait for pending writes to complete', async () => {
+                const mockLogRecords = [
+                    {
+                        hrTime: [1234567890, 123456789],
+                        hrTimeObserved: [1234567890, 123456789],
+                        body: 'Test log message',
+                    },
+                ];
+                let resolveWrite;
+                const writePromise = new Promise((resolve) => {
+                    resolveWrite = resolve;
+                });
+                mockLogWrite.mockReturnValueOnce(writePromise);
+                const callback = vi.fn();
+                exporter.export(mockLogRecords, callback);
+                const flushPromise = exporter.forceFlush();
+                await new Promise((resolve) => setTimeout(resolve, 1));
+                resolveWrite();
+                await writePromise;
+                await expect(flushPromise).resolves.toBeUndefined();
+            });
+            it('should handle multiple pending writes', async () => {
+                const mockLogRecords1 = [
+                    {
+                        hrTime: [1234567890, 123456789],
+                        hrTimeObserved: [1234567890, 123456789],
+                        body: 'Test log message 1',
+                    },
+                ];
+                const mockLogRecords2 = [
+                    {
+                        hrTime: [1234567890, 123456789],
+                        hrTimeObserved: [1234567890, 123456789],
+                        body: 'Test log message 2',
+                    },
+                ];
+                let resolveWrite1;
+                let resolveWrite2;
+                const writePromise1 = new Promise((resolve) => {
+                    resolveWrite1 = resolve;
+                });
+                const writePromise2 = new Promise((resolve) => {
+                    resolveWrite2 = resolve;
+                });
+                mockLogWrite
+                    .mockReturnValueOnce(writePromise1)
+                    .mockReturnValueOnce(writePromise2);
+                const callback = vi.fn();
+                exporter.export(mockLogRecords1, callback);
+                exporter.export(mockLogRecords2, callback);
+                const flushPromise = exporter.forceFlush();
+                resolveWrite1();
+                await writePromise1;
+                resolveWrite2();
+                await writePromise2;
+                await expect(flushPromise).resolves.toBeUndefined();
+            });
+            it('should handle write failures gracefully', async () => {
+                const mockLogRecords = [
+                    {
+                        hrTime: [1234567890, 123456789],
+                        hrTimeObserved: [1234567890, 123456789],
+                        body: 'Test log message',
+                    },
+                ];
+                const error = new Error('Write failed');
+                mockLogWrite.mockRejectedValueOnce(error);
+                const callback = vi.fn();
+                exporter.export(mockLogRecords, callback);
+                await expect(exporter.forceFlush()).resolves.toBeUndefined();
+                await new Promise((resolve) => setTimeout(resolve, 10));
+                expect(callback).toHaveBeenCalledWith({
+                    code: ExportResultCode.FAILED,
+                    error,
+                });
+            });
+        });
+        describe('shutdown', () => {
+            it('should call forceFlush', async () => {
+                const forceFlushSpy = vi.spyOn(exporter, 'forceFlush');
+                await exporter.shutdown();
+                expect(forceFlushSpy).toHaveBeenCalled();
+            });
+            it('should handle shutdown gracefully', async () => {
+                const forceFlushSpy = vi.spyOn(exporter, 'forceFlush');
+                await expect(exporter.shutdown()).resolves.toBeUndefined();
+                expect(forceFlushSpy).toHaveBeenCalled();
+            });
+            it('should wait for pending writes before shutting down', async () => {
+                const mockLogRecords = [
+                    {
+                        hrTime: [1234567890, 123456789],
+                        hrTimeObserved: [1234567890, 123456789],
+                        body: 'Test log message',
+                    },
+                ];
+                let resolveWrite;
+                const writePromise = new Promise((resolve) => {
+                    resolveWrite = resolve;
+                });
+                mockLogWrite.mockReturnValueOnce(writePromise);
+                const callback = vi.fn();
+                exporter.export(mockLogRecords, callback);
+                const shutdownPromise = exporter.shutdown();
+                await new Promise((resolve) => setTimeout(resolve, 1));
+                resolveWrite();
+                await writePromise;
+                await expect(shutdownPromise).resolves.toBeUndefined();
+            });
+            it('should clear pending writes array after shutdown', async () => {
+                const mockLogRecords = [
+                    {
+                        hrTime: [1234567890, 123456789],
+                        hrTimeObserved: [1234567890, 123456789],
+                        body: 'Test log message',
+                    },
+                ];
+                const callback = vi.fn();
+                exporter.export(mockLogRecords, callback);
+                await new Promise((resolve) => setTimeout(resolve, 10));
+                await exporter.shutdown();
+                const start = Date.now();
+                await exporter.forceFlush();
+                const elapsed = Date.now() - start;
+                expect(elapsed).toBeLessThan(50);
+            });
+        });
+    });
+});
+//# sourceMappingURL=gcp-exporters.test.js.map

package/dist/src/telemetry/gcp-exporters.test.js.map

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

package/dist/src/telemetry/high-water-mark-tracker.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * High-water mark tracker for memory metrics
+ * Only triggers when memory usage increases by a significant threshold
+ */
+export declare class HighWaterMarkTracker {
+    private waterMarks;
+    private lastUpdateTimes;
+    private readonly growthThresholdPercent;
+    constructor(growthThresholdPercent?: number);
+    /**
+     * Check if current value represents a new high-water mark that should trigger recording
+     * @param metricType - Type of metric (e.g., 'heap_used', 'rss')
+     * @param currentValue - Current memory value in bytes
+     * @returns true if this value should trigger a recording
+     */
+    shouldRecordMetric(metricType: string, currentValue: number): boolean;
+    /**
+     * Get current high-water mark for a metric type
+     */
+    getHighWaterMark(metricType: string): number;
+    /**
+     * Get all high-water marks
+     */
+    getAllHighWaterMarks(): Record<string, number>;
+    /**
+     * Reset high-water mark for a specific metric type
+     */
+    resetHighWaterMark(metricType: string): void;
+    /**
+     * Reset all high-water marks
+     */
+    resetAllHighWaterMarks(): void;
+    /**
+     * Remove stale entries to avoid unbounded growth if metric types are variable.
+     * Entries not updated within maxAgeMs will be removed.
+     */
+    cleanup(maxAgeMs?: number): void;
+}

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

@@ -0,0 +1,88 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * High-water mark tracker for memory metrics
+ * Only triggers when memory usage increases by a significant threshold
+ */
+export class HighWaterMarkTracker {
+    waterMarks = new Map();
+    lastUpdateTimes = new Map();
+    growthThresholdPercent;
+    constructor(growthThresholdPercent = 5) {
+        if (growthThresholdPercent < 0) {
+            throw new Error('growthThresholdPercent must be non-negative.');
+        }
+        this.growthThresholdPercent = growthThresholdPercent;
+    }
+    /**
+     * Check if current value represents a new high-water mark that should trigger recording
+     * @param metricType - Type of metric (e.g., 'heap_used', 'rss')
+     * @param currentValue - Current memory value in bytes
+     * @returns true if this value should trigger a recording
+     */
+    shouldRecordMetric(metricType, currentValue) {
+        const now = Date.now();
+        // Track last seen time for cleanup regardless of whether we record
+        this.lastUpdateTimes.set(metricType, now);
+        // Get current high-water mark
+        const currentWaterMark = this.waterMarks.get(metricType) || 0;
+        // For first measurement, always record
+        if (currentWaterMark === 0) {
+            this.waterMarks.set(metricType, currentValue);
+            this.lastUpdateTimes.set(metricType, now);
+            return true;
+        }
+        // Check if current value exceeds threshold
+        const thresholdValue = currentWaterMark * (1 + this.growthThresholdPercent / 100);
+        if (currentValue > thresholdValue) {
+            // Update high-water mark
+            this.waterMarks.set(metricType, currentValue);
+            this.lastUpdateTimes.set(metricType, now);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get current high-water mark for a metric type
+     */
+    getHighWaterMark(metricType) {
+        return this.waterMarks.get(metricType) || 0;
+    }
+    /**
+     * Get all high-water marks
+     */
+    getAllHighWaterMarks() {
+        return Object.fromEntries(this.waterMarks);
+    }
+    /**
+     * Reset high-water mark for a specific metric type
+     */
+    resetHighWaterMark(metricType) {
+        this.waterMarks.delete(metricType);
+        this.lastUpdateTimes.delete(metricType);
+    }
+    /**
+     * Reset all high-water marks
+     */
+    resetAllHighWaterMarks() {
+        this.waterMarks.clear();
+        this.lastUpdateTimes.clear();
+    }
+    /**
+     * Remove stale entries to avoid unbounded growth if metric types are variable.
+     * Entries not updated within maxAgeMs will be removed.
+     */
+    cleanup(maxAgeMs = 3600000) {
+        const cutoffTime = Date.now() - maxAgeMs;
+        for (const [metricType, lastTime] of this.lastUpdateTimes.entries()) {
+            if (lastTime < cutoffTime) {
+                this.lastUpdateTimes.delete(metricType);
+                this.waterMarks.delete(metricType);
+            }
+        }
+    }
+}
+//# sourceMappingURL=high-water-mark-tracker.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"high-water-mark-tracker.js","sourceRoot":"","sources":["../../../src/telemetry/high-water-mark-tracker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IACvB,UAAU,GAAwB,IAAI,GAAG,EAAE,CAAC;IAC5C,eAAe,GAAwB,IAAI,GAAG,EAAE,CAAC;IACxC,sBAAsB,CAAS;IAEhD,YAAY,yBAAiC,CAAC;QAC5C,IAAI,sBAAsB,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,sBAAsB,GAAG,sBAAsB,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACH,kBAAkB,CAAC,UAAkB,EAAE,YAAoB;QACzD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,mEAAmE;QACnE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC1C,8BAA8B;QAC9B,MAAM,gBAAgB,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAE9D,uCAAuC;QACvC,IAAI,gBAAgB,KAAK,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;YAC9C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,2CAA2C;QAC3C,MAAM,cAAc,GAClB,gBAAgB,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,sBAAsB,GAAG,GAAG,CAAC,CAAC;QAE7D,IAAI,YAAY,GAAG,cAAc,EAAE,CAAC;YAClC,yBAAyB;YACzB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;YAC9C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,UAAkB;QACjC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,UAAkB;QACnC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACnC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,sBAAsB;QACpB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,WAAmB,OAAO;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC;QACzC,KAAK,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,EAAE,CAAC;YACpE,IAAI,QAAQ,GAAG,UAAU,EAAE,CAAC;gBAC1B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBACxC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};