@didim365/agent-cli-core 0.1.0

package/dist/src/telemetry/activity-detector.test.js

@@ -0,0 +1,136 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { ActivityDetector, getActivityDetector, recordUserActivity, isUserActive, } from './activity-detector.js';
+describe('ActivityDetector', () => {
+    let detector;
+    beforeEach(() => {
+        detector = new ActivityDetector(1000); // 1 second idle threshold for testing
+    });
+    describe('constructor', () => {
+        it('should initialize with default idle threshold', () => {
+            const defaultDetector = new ActivityDetector();
+            expect(defaultDetector).toBeInstanceOf(ActivityDetector);
+        });
+        it('should initialize with custom idle threshold', () => {
+            const customDetector = new ActivityDetector(5000);
+            expect(customDetector).toBeInstanceOf(ActivityDetector);
+        });
+    });
+    describe('recordActivity', () => {
+        beforeEach(() => {
+            vi.useFakeTimers();
+        });
+        afterEach(() => {
+            vi.useRealTimers();
+        });
+        it('should update last activity time', () => {
+            const beforeTime = detector.getLastActivityTime();
+            vi.advanceTimersByTime(100);
+            detector.recordActivity();
+            const afterTime = detector.getLastActivityTime();
+            expect(afterTime).toBeGreaterThan(beforeTime);
+        });
+    });
+    describe('isUserActive', () => {
+        beforeEach(() => {
+            vi.useFakeTimers();
+        });
+        afterEach(() => {
+            vi.useRealTimers();
+        });
+        it('should return true immediately after construction', () => {
+            expect(detector.isUserActive()).toBe(true);
+        });
+        it('should return true within idle threshold', () => {
+            detector.recordActivity();
+            expect(detector.isUserActive()).toBe(true);
+        });
+        it('should return false after idle threshold', () => {
+            // Advance time beyond idle threshold
+            vi.advanceTimersByTime(2000); // 2 seconds, threshold is 1 second
+            expect(detector.isUserActive()).toBe(false);
+        });
+        it('should return true again after recording new activity', () => {
+            // Go idle
+            vi.advanceTimersByTime(2000);
+            expect(detector.isUserActive()).toBe(false);
+            // Record new activity
+            detector.recordActivity();
+            expect(detector.isUserActive()).toBe(true);
+        });
+    });
+    describe('getTimeSinceLastActivity', () => {
+        beforeEach(() => {
+            vi.useFakeTimers();
+        });
+        afterEach(() => {
+            vi.useRealTimers();
+        });
+        it('should return time elapsed since last activity', () => {
+            detector.recordActivity();
+            vi.advanceTimersByTime(500);
+            const timeSince = detector.getTimeSinceLastActivity();
+            expect(timeSince).toBe(500);
+        });
+    });
+    describe('getLastActivityTime', () => {
+        it('should return the timestamp of last activity', () => {
+            const before = Date.now();
+            detector.recordActivity();
+            const activityTime = detector.getLastActivityTime();
+            const after = Date.now();
+            expect(activityTime).toBeGreaterThanOrEqual(before);
+            expect(activityTime).toBeLessThanOrEqual(after);
+        });
+    });
+});
+describe('Global Activity Detector Functions', () => {
+    describe('global instance', () => {
+        it('should expose a global ActivityDetector via getActivityDetector', () => {
+            const detector = getActivityDetector();
+            expect(detector).toBeInstanceOf(ActivityDetector);
+        });
+    });
+    describe('getActivityDetector', () => {
+        it('should always return the global instance', () => {
+            const detector = getActivityDetector();
+            const detectorAgain = getActivityDetector();
+            expect(detectorAgain).toBe(detector);
+        });
+    });
+    describe('recordUserActivity', () => {
+        beforeEach(() => {
+            vi.useFakeTimers();
+        });
+        afterEach(() => {
+            vi.useRealTimers();
+        });
+        it('should record activity on existing detector', () => {
+            const detector = getActivityDetector();
+            const beforeTime = detector.getLastActivityTime();
+            vi.advanceTimersByTime(100);
+            recordUserActivity();
+            const afterTime = detector.getLastActivityTime();
+            expect(afterTime).toBeGreaterThan(beforeTime);
+        });
+    });
+    describe('isUserActive', () => {
+        beforeEach(() => {
+            vi.useFakeTimers();
+        });
+        afterEach(() => {
+            vi.useRealTimers();
+        });
+        it('should reflect global detector state', () => {
+            expect(isUserActive()).toBe(true);
+            // Default idle threshold is 30s; advance beyond it
+            vi.advanceTimersByTime(31000);
+            expect(isUserActive()).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=activity-detector.test.js.map

package/dist/src/telemetry/activity-detector.test.js.map

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

package/dist/src/telemetry/activity-monitor.d.ts

@@ -0,0 +1,116 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+import { ActivityType } from './activity-types.js';
+/**
+ * Activity event data structure
+ */
+export interface ActivityEvent {
+    type: ActivityType;
+    timestamp: number;
+    context?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Configuration for activity monitoring
+ */
+export interface ActivityMonitorConfig {
+    /** Enable/disable activity monitoring */
+    enabled: boolean;
+    /** Minimum interval between memory snapshots (ms) */
+    snapshotThrottleMs: number;
+    /** Maximum number of events to buffer */
+    maxEventBuffer: number;
+    /** Activity types that should trigger immediate memory snapshots */
+    triggerActivities: ActivityType[];
+}
+/**
+ * Activity listener callback function
+ */
+export type ActivityListener = (event: ActivityEvent) => void;
+/**
+ * Default configuration for activity monitoring
+ */
+export declare const DEFAULT_ACTIVITY_CONFIG: ActivityMonitorConfig;
+/**
+ * Activity monitor class that tracks user activity and triggers memory monitoring
+ */
+export declare class ActivityMonitor {
+    private listeners;
+    private eventBuffer;
+    private lastSnapshotTime;
+    private config;
+    private isActive;
+    private memoryMonitoringListener;
+    constructor(config?: ActivityMonitorConfig);
+    /**
+     * Start activity monitoring
+     */
+    start(coreConfig: Config): void;
+    /**
+     * Stop activity monitoring
+     */
+    stop(): void;
+    /**
+     * Add an activity listener
+     */
+    addListener(listener: ActivityListener): void;
+    /**
+     * Remove an activity listener
+     */
+    removeListener(listener: ActivityListener): void;
+    /**
+     * Record a user activity event
+     */
+    recordActivity(type: ActivityType, context?: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Get recent activity events
+     */
+    getRecentActivity(limit?: number): ActivityEvent[];
+    /**
+     * Get activity statistics
+     */
+    getActivityStats(): {
+        totalEvents: number;
+        eventTypes: Record<ActivityType, number>;
+        timeRange: {
+            start: number;
+            end: number;
+        } | null;
+    };
+    /**
+     * Update configuration
+     */
+    updateConfig(newConfig: Partial<ActivityMonitorConfig>): void;
+    /**
+     * Handle memory monitoring for activity events
+     */
+    private handleMemoryMonitoringActivity;
+    /**
+     * Check if monitoring is active
+     */
+    isMonitoringActive(): boolean;
+}
+/**
+ * Initialize global activity monitor
+ */
+export declare function initializeActivityMonitor(config?: ActivityMonitorConfig): ActivityMonitor;
+/**
+ * Get global activity monitor instance
+ */
+export declare function getActivityMonitor(): ActivityMonitor | null;
+/**
+ * Record a user activity on the global monitor (convenience function)
+ */
+export declare function recordGlobalActivity(type: ActivityType, context?: string, metadata?: Record<string, unknown>): void;
+/**
+ * Start global activity monitoring
+ */
+export declare function startGlobalActivityMonitoring(coreConfig: Config, activityConfig?: ActivityMonitorConfig): void;
+/**
+ * Stop global activity monitoring
+ */
+export declare function stopGlobalActivityMonitoring(): void;

package/dist/src/telemetry/activity-monitor.js

@@ -0,0 +1,209 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { isPerformanceMonitoringActive } from './metrics.js';
+import { getMemoryMonitor } from './memory-monitor.js';
+import { ActivityType } from './activity-types.js';
+import { debugLogger } from '../utils/debugLogger.js';
+/**
+ * Default configuration for activity monitoring
+ */
+export const DEFAULT_ACTIVITY_CONFIG = {
+    enabled: true,
+    snapshotThrottleMs: 1000, // 1 second minimum between snapshots
+    maxEventBuffer: 100,
+    triggerActivities: [
+        ActivityType.USER_INPUT_START,
+        ActivityType.MESSAGE_ADDED,
+        ActivityType.TOOL_CALL_SCHEDULED,
+        ActivityType.STREAM_START,
+    ],
+};
+/**
+ * Activity monitor class that tracks user activity and triggers memory monitoring
+ */
+export class ActivityMonitor {
+    listeners = new Set();
+    eventBuffer = [];
+    lastSnapshotTime = 0;
+    config;
+    isActive = false;
+    memoryMonitoringListener = null;
+    constructor(config = DEFAULT_ACTIVITY_CONFIG) {
+        this.config = { ...config };
+    }
+    /**
+     * Start activity monitoring
+     */
+    start(coreConfig) {
+        if (!isPerformanceMonitoringActive() || this.isActive) {
+            return;
+        }
+        this.isActive = true;
+        // Register default memory monitoring listener
+        this.memoryMonitoringListener = (event) => {
+            this.handleMemoryMonitoringActivity(event, coreConfig);
+        };
+        this.addListener(this.memoryMonitoringListener);
+        // Record activity monitoring start
+        this.recordActivity(ActivityType.MANUAL_TRIGGER, 'activity_monitoring_start');
+    }
+    /**
+     * Stop activity monitoring
+     */
+    stop() {
+        if (!this.isActive) {
+            return;
+        }
+        this.isActive = false;
+        if (this.memoryMonitoringListener) {
+            this.removeListener(this.memoryMonitoringListener);
+            this.memoryMonitoringListener = null;
+        }
+        this.eventBuffer = [];
+    }
+    /**
+     * Add an activity listener
+     */
+    addListener(listener) {
+        this.listeners.add(listener);
+    }
+    /**
+     * Remove an activity listener
+     */
+    removeListener(listener) {
+        this.listeners.delete(listener);
+    }
+    /**
+     * Record a user activity event
+     */
+    recordActivity(type, context, metadata) {
+        if (!this.isActive || !this.config.enabled) {
+            return;
+        }
+        const event = {
+            type,
+            timestamp: Date.now(),
+            context,
+            metadata,
+        };
+        // Add to buffer
+        this.eventBuffer.push(event);
+        if (this.eventBuffer.length > this.config.maxEventBuffer) {
+            this.eventBuffer.shift(); // Remove oldest event
+        }
+        // Notify listeners
+        this.listeners.forEach((listener) => {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                // Silently catch listener errors to avoid disrupting the application
+                debugLogger.debug('ActivityMonitor listener error:', error);
+            }
+        });
+    }
+    /**
+     * Get recent activity events
+     */
+    getRecentActivity(limit) {
+        const events = [...this.eventBuffer];
+        return limit ? events.slice(-limit) : events;
+    }
+    /**
+     * Get activity statistics
+     */
+    getActivityStats() {
+        const eventTypes = {};
+        let start = Number.MAX_SAFE_INTEGER;
+        let end = 0;
+        for (const event of this.eventBuffer) {
+            eventTypes[event.type] = (eventTypes[event.type] || 0) + 1;
+            start = Math.min(start, event.timestamp);
+            end = Math.max(end, event.timestamp);
+        }
+        return {
+            totalEvents: this.eventBuffer.length,
+            eventTypes,
+            timeRange: this.eventBuffer.length > 0 ? { start, end } : null,
+        };
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(newConfig) {
+        this.config = { ...this.config, ...newConfig };
+    }
+    /**
+     * Handle memory monitoring for activity events
+     */
+    handleMemoryMonitoringActivity(event, config) {
+        // Check if this activity type should trigger memory monitoring
+        if (!this.config.triggerActivities.includes(event.type)) {
+            return;
+        }
+        // Throttle memory snapshots
+        const now = Date.now();
+        if (now - this.lastSnapshotTime < this.config.snapshotThrottleMs) {
+            return;
+        }
+        this.lastSnapshotTime = now;
+        // Take memory snapshot
+        const memoryMonitor = getMemoryMonitor();
+        if (memoryMonitor) {
+            const context = event.context
+                ? `activity_${event.type}_${event.context}`
+                : `activity_${event.type}`;
+            memoryMonitor.takeSnapshot(context, config);
+        }
+    }
+    /**
+     * Check if monitoring is active
+     */
+    isMonitoringActive() {
+        return this.isActive && this.config.enabled;
+    }
+}
+// Singleton instance for global activity monitoring
+let globalActivityMonitor = null;
+/**
+ * Initialize global activity monitor
+ */
+export function initializeActivityMonitor(config) {
+    if (!globalActivityMonitor) {
+        globalActivityMonitor = new ActivityMonitor(config);
+    }
+    return globalActivityMonitor;
+}
+/**
+ * Get global activity monitor instance
+ */
+export function getActivityMonitor() {
+    return globalActivityMonitor;
+}
+/**
+ * Record a user activity on the global monitor (convenience function)
+ */
+export function recordGlobalActivity(type, context, metadata) {
+    if (globalActivityMonitor) {
+        globalActivityMonitor.recordActivity(type, context, metadata);
+    }
+}
+/**
+ * Start global activity monitoring
+ */
+export function startGlobalActivityMonitoring(coreConfig, activityConfig) {
+    const monitor = initializeActivityMonitor(activityConfig);
+    monitor.start(coreConfig);
+}
+/**
+ * Stop global activity monitoring
+ */
+export function stopGlobalActivityMonitoring() {
+    if (globalActivityMonitor) {
+        globalActivityMonitor.stop();
+    }
+}
+//# sourceMappingURL=activity-monitor.js.map

package/dist/src/telemetry/activity-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-monitor.js","sourceRoot":"","sources":["../../../src/telemetry/activity-monitor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AA+BtD;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAA0B;IAC5D,OAAO,EAAE,IAAI;IACb,kBAAkB,EAAE,IAAI,EAAE,qCAAqC;IAC/D,cAAc,EAAE,GAAG;IACnB,iBAAiB,EAAE;QACjB,YAAY,CAAC,gBAAgB;QAC7B,YAAY,CAAC,aAAa;QAC1B,YAAY,CAAC,mBAAmB;QAChC,YAAY,CAAC,YAAY;KAC1B;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,eAAe;IAClB,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IACxC,WAAW,GAAoB,EAAE,CAAC;IAClC,gBAAgB,GAAG,CAAC,CAAC;IACrB,MAAM,CAAwB;IAC9B,QAAQ,GAAG,KAAK,CAAC;IACjB,wBAAwB,GAA4B,IAAI,CAAC;IAEjE,YAAY,SAAgC,uBAAuB;QACjE,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAkB;QACtB,IAAI,CAAC,6BAA6B,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAErB,8CAA8C;QAC9C,IAAI,CAAC,wBAAwB,GAAG,CAAC,KAAK,EAAE,EAAE;YACxC,IAAI,CAAC,8BAA8B,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACzD,CAAC,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QAEhD,mCAAmC;QACnC,IAAI,CAAC,cAAc,CACjB,YAAY,CAAC,cAAc,EAC3B,2BAA2B,CAC5B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,IAAI,CAAC,wBAAwB,EAAE,CAAC;YAClC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;YACnD,IAAI,CAAC,wBAAwB,GAAG,IAAI,CAAC;QACvC,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,QAA0B;QACpC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,QAA0B;QACvC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,cAAc,CACZ,IAAkB,EAClB,OAAgB,EAChB,QAAkC;QAElC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAkB;YAC3B,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,OAAO;YACP,QAAQ;SACT,CAAC;QAEF,gBAAgB;QAChB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YACzD,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,sBAAsB;QAClD,CAAC;QAED,mBAAmB;QACnB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YAClC,IAAI,CAAC;gBACH,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,qEAAqE;gBACrE,WAAW,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,KAAc;QAC9B,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;QACrC,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,gBAAgB;QAKd,MAAM,UAAU,GAAG,EAAkC,CAAC;QACtD,IAAI,KAAK,GAAG,MAAM,CAAC,gBAAgB,CAAC;QACpC,IAAI,GAAG,GAAG,CAAC,CAAC;QAEZ,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAC3D,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;YACzC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACvC,CAAC;QAED,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM;YACpC,UAAU;YACV,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI;SAC/D,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,SAAyC;QACpD,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;IACjD,CAAC;IAED;;OAEG;IACK,8BAA8B,CACpC,KAAoB,EACpB,MAAc;QAEd,+DAA+D;QAC/D,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACxD,OAAO;QACT,CAAC;QAED,4BAA4B;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,GAAG,GAAG,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;YACjE,OAAO;QACT,CAAC;QAED,IAAI,CAAC,gBAAgB,GAAG,GAAG,CAAC;QAE5B,uBAAuB;QACvB,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;QACzC,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO;gBAC3B,CAAC,CAAC,YAAY,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE;gBAC3C,CAAC,CAAC,YAAY,KAAK,CAAC,IAAI,EAAE,CAAC;YAE7B,aAAa,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC9C,CAAC;CACF;AAED,oDAAoD;AACpD,IAAI,qBAAqB,GAA2B,IAAI,CAAC;AAEzD;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAA8B;IAE9B,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC3B,qBAAqB,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,qBAAqB,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,qBAAqB,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAkB,EAClB,OAAgB,EAChB,QAAkC;IAElC,IAAI,qBAAqB,EAAE,CAAC;QAC1B,qBAAqB,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC3C,UAAkB,EAClB,cAAsC;IAEtC,MAAM,OAAO,GAAG,yBAAyB,CAAC,cAAc,CAAC,CAAC;IAC1D,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B;IAC1C,IAAI,qBAAqB,EAAE,CAAC;QAC1B,qBAAqB,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist/src/telemetry/activity-monitor.test.d.ts

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