@anthropic-field/core 0.1.0

package/dist/src/telemetry/loggers.test.circular.js

@@ -0,0 +1,107 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Test to verify circular reference handling in telemetry logging
+ */
+import { describe, it, expect } from 'vitest';
+import { logToolCall } from './loggers.js';
+import { ToolCallEvent } from './types.js';
+import {} from '../scheduler/types.js';
+import { MockTool } from '../test-utils/mock-tool.js';
+describe('Circular Reference Handling', () => {
+    it('should handle circular references in tool function arguments', () => {
+        // Create a mock config
+        const mockConfig = {
+            getTelemetryEnabled: () => true,
+            getUsageStatisticsEnabled: () => true,
+            getSessionId: () => 'test-session',
+            getModel: () => 'test-model',
+            getEmbeddingModel: () => 'test-embedding',
+            getDebugMode: () => false,
+        };
+        // Create an object with circular references (similar to HttpsProxyAgent)
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const circularObject = {
+            sockets: {},
+            agent: null,
+        };
+        circularObject.agent = circularObject; // Create circular reference
+        circularObject.sockets['test-host'] = [
+            { _httpMessage: { agent: circularObject } },
+        ];
+        // Create a mock CompletedToolCall with circular references in function_args
+        const mockRequest = {
+            callId: 'test-call-id',
+            name: 'ReadFile',
+            args: circularObject, // This would cause the original error
+            isClientInitiated: false,
+            prompt_id: 'test-prompt-id',
+        };
+        const mockResponse = {
+            callId: 'test-call-id',
+            responseParts: [{ text: 'test result' }],
+            resultDisplay: undefined,
+            error: undefined, // undefined means success
+            errorType: undefined,
+        };
+        const tool = new MockTool({ name: 'mock-tool' });
+        const mockCompletedToolCall = {
+            status: 'success',
+            request: mockRequest,
+            response: mockResponse,
+            tool,
+            invocation: tool.build({}),
+            durationMs: 100,
+        };
+        const event = new ToolCallEvent(mockCompletedToolCall);
+        // This should not throw an error
+        expect(() => {
+            logToolCall(mockConfig, event);
+        }).not.toThrow();
+    });
+    it('should handle normal objects without circular references', () => {
+        const mockConfig = {
+            getTelemetryEnabled: () => true,
+            getUsageStatisticsEnabled: () => true,
+            getSessionId: () => 'test-session',
+            getModel: () => 'test-model',
+            getEmbeddingModel: () => 'test-embedding',
+            getDebugMode: () => false,
+        };
+        const normalObject = {
+            filePath: '/test/path',
+            options: { encoding: 'utf8' },
+        };
+        const mockRequest = {
+            callId: 'test-call-id',
+            name: 'ReadFile',
+            args: normalObject,
+            isClientInitiated: false,
+            prompt_id: 'test-prompt-id',
+        };
+        const mockResponse = {
+            callId: 'test-call-id',
+            responseParts: [{ text: 'test result' }],
+            resultDisplay: undefined,
+            error: undefined, // undefined means success
+            errorType: undefined,
+        };
+        const tool = new MockTool({ name: 'mock-tool' });
+        const mockCompletedToolCall = {
+            status: 'success',
+            request: mockRequest,
+            response: mockResponse,
+            tool,
+            invocation: tool.build({}),
+            durationMs: 100,
+        };
+        const event = new ToolCallEvent(mockCompletedToolCall);
+        expect(() => {
+            logToolCall(mockConfig, event);
+        }).not.toThrow();
+    });
+});
+//# sourceMappingURL=loggers.test.circular.js.map

package/dist/src/telemetry/loggers.test.circular.js.map

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

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

@@ -0,0 +1,149 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import v8 from 'node:v8';
+import type { Config } from '../config/config.js';
+export interface MemorySnapshot {
+    timestamp: number;
+    heapUsed: number;
+    heapTotal: number;
+    external: number;
+    rss: number;
+    arrayBuffers: number;
+    heapSizeLimit: number;
+}
+export interface ProcessMetrics {
+    cpuUsage: NodeJS.CpuUsage;
+    memoryUsage: NodeJS.MemoryUsage;
+    uptime: number;
+}
+export declare class MemoryMonitor {
+    private intervalId;
+    private isRunning;
+    private lastSnapshot;
+    private monitoringInterval;
+    private highWaterMarkTracker;
+    private rateLimiter;
+    private useEnhancedMonitoring;
+    private lastCleanupTimestamp;
+    private static readonly STATE_CLEANUP_INTERVAL_MS;
+    private static readonly STATE_CLEANUP_MAX_AGE_MS;
+    constructor();
+    /**
+     * Start continuous memory monitoring
+     */
+    start(config: Config, intervalMs?: number): void;
+    /**
+     * Check if we should record memory metrics and do so if conditions are met
+     */
+    private checkAndRecordIfNeeded;
+    /**
+     * Periodically prune tracker state to avoid unbounded growth when keys change.
+     */
+    private performPeriodicCleanup;
+    /**
+     * Stop continuous memory monitoring
+     */
+    stop(config?: Config): void;
+    /**
+     * Take a memory snapshot and record metrics
+     */
+    takeSnapshot(context: string, config: Config): MemorySnapshot;
+    /**
+     * Take a memory snapshot without recording metrics (for internal tracking)
+     */
+    private takeSnapshotWithoutRecording;
+    /**
+     * Get current memory usage without recording metrics
+     */
+    getCurrentMemoryUsage(): MemorySnapshot;
+    /**
+     * Get memory growth since last snapshot
+     */
+    getMemoryGrowth(): Partial<MemorySnapshot> | null;
+    /**
+     * Get detailed heap statistics
+     */
+    getHeapStatistics(): v8.HeapInfo;
+    /**
+     * Get heap space statistics
+     */
+    getHeapSpaceStatistics(): v8.HeapSpaceInfo[];
+    /**
+     * Get process CPU and memory metrics
+     */
+    getProcessMetrics(): ProcessMetrics;
+    /**
+     * Record memory usage for a specific component or operation
+     */
+    recordComponentMemoryUsage(config: Config, component: string, operation?: string): MemorySnapshot;
+    /**
+     * Check if memory usage exceeds threshold
+     */
+    checkMemoryThreshold(thresholdMB: number): boolean;
+    /**
+     * Get memory usage summary in MB
+     */
+    getMemoryUsageSummary(): {
+        heapUsedMB: number;
+        heapTotalMB: number;
+        externalMB: number;
+        rssMB: number;
+        heapSizeLimitMB: number;
+    };
+    /**
+     * Enable or disable enhanced monitoring features
+     */
+    setEnhancedMonitoring(enabled: boolean): void;
+    /**
+     * Get high-water mark statistics
+     */
+    getHighWaterMarkStats(): Record<string, number>;
+    /**
+     * Get rate limiting statistics
+     */
+    getRateLimitingStats(): {
+        totalMetrics: number;
+        oldestRecord: number;
+        newestRecord: number;
+        averageInterval: number;
+    };
+    /**
+     * Force record memory metrics (bypasses rate limiting for critical events)
+     */
+    forceRecordMemory(config: Config, context?: string): MemorySnapshot;
+    /**
+     * Reset high-water marks (useful after memory optimizations)
+     */
+    resetHighWaterMarks(): void;
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+}
+/**
+ * Initialize global memory monitor
+ */
+export declare function initializeMemoryMonitor(): MemoryMonitor;
+/**
+ * Get global memory monitor instance
+ */
+export declare function getMemoryMonitor(): MemoryMonitor | null;
+/**
+ * Record memory usage for current operation
+ */
+export declare function recordCurrentMemoryUsage(config: Config, context: string): MemorySnapshot;
+/**
+ * Start global memory monitoring
+ */
+export declare function startGlobalMemoryMonitoring(config: Config, intervalMs?: number): void;
+/**
+ * Stop global memory monitoring
+ */
+export declare function stopGlobalMemoryMonitoring(config?: Config): void;
+/**
+ * Reset the global memory monitor singleton (test-only helper).
+ */
+export declare function _resetGlobalMemoryMonitorForTests(): void;

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

@@ -0,0 +1,335 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import v8 from 'node:v8';
+import process from 'node:process';
+import { bytesToMB } from '../utils/formatters.js';
+import { isUserActive } from './activity-detector.js';
+import { HighWaterMarkTracker } from './high-water-mark-tracker.js';
+import { recordMemoryUsage, MemoryMetricType, isPerformanceMonitoringActive, } from './metrics.js';
+import { RateLimiter } from './rate-limiter.js';
+export class MemoryMonitor {
+    intervalId = null;
+    isRunning = false;
+    lastSnapshot = null;
+    monitoringInterval = 10000;
+    highWaterMarkTracker;
+    rateLimiter;
+    useEnhancedMonitoring = true;
+    lastCleanupTimestamp = Date.now();
+    static STATE_CLEANUP_INTERVAL_MS = 15 * 60 * 1000; // 15 minutes
+    static STATE_CLEANUP_MAX_AGE_MS = 60 * 60 * 1000; // 1 hour
+    constructor() {
+        // No config stored to avoid multi-session attribution issues
+        this.highWaterMarkTracker = new HighWaterMarkTracker(5); // 5% threshold
+        this.rateLimiter = new RateLimiter(60000); // 1 minute minimum between recordings
+    }
+    /**
+     * Start continuous memory monitoring
+     */
+    start(config, intervalMs = 10000) {
+        if (!isPerformanceMonitoringActive() || this.isRunning) {
+            return;
+        }
+        this.monitoringInterval = intervalMs;
+        this.isRunning = true;
+        // Take initial snapshot
+        this.takeSnapshot('monitoring_start', config);
+        // Set up periodic monitoring with enhanced logic
+        this.intervalId = setInterval(() => {
+            this.checkAndRecordIfNeeded(config);
+        }, this.monitoringInterval).unref();
+    }
+    /**
+     * Check if we should record memory metrics and do so if conditions are met
+     */
+    checkAndRecordIfNeeded(config) {
+        this.performPeriodicCleanup();
+        if (!this.useEnhancedMonitoring) {
+            // Fall back to original behavior
+            this.takeSnapshot('periodic', config);
+            return;
+        }
+        // Only proceed if user is active
+        if (!isUserActive()) {
+            return;
+        }
+        // Get current memory usage
+        const currentMemory = this.getCurrentMemoryUsage();
+        // Check if RSS has grown significantly (5% threshold)
+        const shouldRecordRss = this.highWaterMarkTracker.shouldRecordMetric('rss', currentMemory.rss);
+        const shouldRecordHeap = this.highWaterMarkTracker.shouldRecordMetric('heap_used', currentMemory.heapUsed);
+        // Also check rate limiting
+        const canRecordPeriodic = this.rateLimiter.shouldRecord('periodic_memory');
+        const canRecordHighWater = this.rateLimiter.shouldRecord('high_water_memory', true); // High priority
+        // Record if we have significant growth and aren't rate limited
+        if ((shouldRecordRss || shouldRecordHeap) && canRecordHighWater) {
+            const context = shouldRecordRss ? 'rss_growth' : 'heap_growth';
+            this.takeSnapshot(context, config);
+        }
+        else if (canRecordPeriodic) {
+            // Occasionally record even without growth for baseline tracking
+            this.takeSnapshotWithoutRecording('periodic_check', config);
+        }
+    }
+    /**
+     * Periodically prune tracker state to avoid unbounded growth when keys change.
+     */
+    performPeriodicCleanup() {
+        const now = Date.now();
+        if (now - this.lastCleanupTimestamp <
+            MemoryMonitor.STATE_CLEANUP_INTERVAL_MS) {
+            return;
+        }
+        this.lastCleanupTimestamp = now;
+        this.highWaterMarkTracker.cleanup(MemoryMonitor.STATE_CLEANUP_MAX_AGE_MS);
+        this.rateLimiter.cleanup(MemoryMonitor.STATE_CLEANUP_MAX_AGE_MS);
+    }
+    /**
+     * Stop continuous memory monitoring
+     */
+    stop(config) {
+        if (!this.isRunning) {
+            return;
+        }
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+        // Take final snapshot if config is provided
+        if (config) {
+            this.takeSnapshot('monitoring_stop', config);
+        }
+        this.isRunning = false;
+    }
+    /**
+     * Take a memory snapshot and record metrics
+     */
+    takeSnapshot(context, config) {
+        const memUsage = process.memoryUsage();
+        const heapStats = v8.getHeapStatistics();
+        const snapshot = {
+            timestamp: Date.now(),
+            heapUsed: memUsage.heapUsed,
+            heapTotal: memUsage.heapTotal,
+            external: memUsage.external,
+            rss: memUsage.rss,
+            arrayBuffers: memUsage.arrayBuffers,
+            heapSizeLimit: heapStats.heap_size_limit,
+        };
+        // Record memory metrics if monitoring is active
+        if (isPerformanceMonitoringActive()) {
+            recordMemoryUsage(config, snapshot.heapUsed, {
+                memory_type: MemoryMetricType.HEAP_USED,
+                component: context,
+            });
+            recordMemoryUsage(config, snapshot.heapTotal, {
+                memory_type: MemoryMetricType.HEAP_TOTAL,
+                component: context,
+            });
+            recordMemoryUsage(config, snapshot.external, {
+                memory_type: MemoryMetricType.EXTERNAL,
+                component: context,
+            });
+            recordMemoryUsage(config, snapshot.rss, {
+                memory_type: MemoryMetricType.RSS,
+                component: context,
+            });
+        }
+        this.lastSnapshot = snapshot;
+        return snapshot;
+    }
+    /**
+     * Take a memory snapshot without recording metrics (for internal tracking)
+     */
+    takeSnapshotWithoutRecording(_context, _config) {
+        const memUsage = process.memoryUsage();
+        const heapStats = v8.getHeapStatistics();
+        const snapshot = {
+            timestamp: Date.now(),
+            heapUsed: memUsage.heapUsed,
+            heapTotal: memUsage.heapTotal,
+            external: memUsage.external,
+            rss: memUsage.rss,
+            arrayBuffers: memUsage.arrayBuffers,
+            heapSizeLimit: heapStats.heap_size_limit,
+        };
+        // Update internal tracking but don't record metrics
+        this.highWaterMarkTracker.shouldRecordMetric('rss', snapshot.rss);
+        this.highWaterMarkTracker.shouldRecordMetric('heap_used', snapshot.heapUsed);
+        this.lastSnapshot = snapshot;
+        return snapshot;
+    }
+    /**
+     * Get current memory usage without recording metrics
+     */
+    getCurrentMemoryUsage() {
+        const memUsage = process.memoryUsage();
+        const heapStats = v8.getHeapStatistics();
+        return {
+            timestamp: Date.now(),
+            heapUsed: memUsage.heapUsed,
+            heapTotal: memUsage.heapTotal,
+            external: memUsage.external,
+            rss: memUsage.rss,
+            arrayBuffers: memUsage.arrayBuffers,
+            heapSizeLimit: heapStats.heap_size_limit,
+        };
+    }
+    /**
+     * Get memory growth since last snapshot
+     */
+    getMemoryGrowth() {
+        if (!this.lastSnapshot) {
+            return null;
+        }
+        const current = this.getCurrentMemoryUsage();
+        return {
+            heapUsed: current.heapUsed - this.lastSnapshot.heapUsed,
+            heapTotal: current.heapTotal - this.lastSnapshot.heapTotal,
+            external: current.external - this.lastSnapshot.external,
+            rss: current.rss - this.lastSnapshot.rss,
+            arrayBuffers: current.arrayBuffers - this.lastSnapshot.arrayBuffers,
+        };
+    }
+    /**
+     * Get detailed heap statistics
+     */
+    getHeapStatistics() {
+        return v8.getHeapStatistics();
+    }
+    /**
+     * Get heap space statistics
+     */
+    getHeapSpaceStatistics() {
+        return v8.getHeapSpaceStatistics();
+    }
+    /**
+     * Get process CPU and memory metrics
+     */
+    getProcessMetrics() {
+        return {
+            cpuUsage: process.cpuUsage(),
+            memoryUsage: process.memoryUsage(),
+            uptime: process.uptime(),
+        };
+    }
+    /**
+     * Record memory usage for a specific component or operation
+     */
+    recordComponentMemoryUsage(config, component, operation) {
+        const snapshot = this.takeSnapshot(operation ? `${component}_${operation}` : component, config);
+        return snapshot;
+    }
+    /**
+     * Check if memory usage exceeds threshold
+     */
+    checkMemoryThreshold(thresholdMB) {
+        const current = this.getCurrentMemoryUsage();
+        const currentMB = bytesToMB(current.heapUsed);
+        return currentMB > thresholdMB;
+    }
+    /**
+     * Get memory usage summary in MB
+     */
+    getMemoryUsageSummary() {
+        const current = this.getCurrentMemoryUsage();
+        return {
+            heapUsedMB: Math.round(bytesToMB(current.heapUsed) * 100) / 100,
+            heapTotalMB: Math.round(bytesToMB(current.heapTotal) * 100) / 100,
+            externalMB: Math.round(bytesToMB(current.external) * 100) / 100,
+            rssMB: Math.round(bytesToMB(current.rss) * 100) / 100,
+            heapSizeLimitMB: Math.round(bytesToMB(current.heapSizeLimit) * 100) / 100,
+        };
+    }
+    /**
+     * Enable or disable enhanced monitoring features
+     */
+    setEnhancedMonitoring(enabled) {
+        this.useEnhancedMonitoring = enabled;
+    }
+    /**
+     * Get high-water mark statistics
+     */
+    getHighWaterMarkStats() {
+        return this.highWaterMarkTracker.getAllHighWaterMarks();
+    }
+    /**
+     * Get rate limiting statistics
+     */
+    getRateLimitingStats() {
+        return this.rateLimiter.getStats();
+    }
+    /**
+     * Force record memory metrics (bypasses rate limiting for critical events)
+     */
+    forceRecordMemory(config, context = 'forced') {
+        this.rateLimiter.forceRecord('forced_memory');
+        return this.takeSnapshot(context, config);
+    }
+    /**
+     * Reset high-water marks (useful after memory optimizations)
+     */
+    resetHighWaterMarks() {
+        this.highWaterMarkTracker.resetAllHighWaterMarks();
+    }
+    /**
+     * Cleanup resources
+     */
+    destroy() {
+        this.stop();
+        this.rateLimiter.reset();
+        this.highWaterMarkTracker.resetAllHighWaterMarks();
+    }
+}
+// Singleton instance for global memory monitoring
+let globalMemoryMonitor = null;
+/**
+ * Initialize global memory monitor
+ */
+export function initializeMemoryMonitor() {
+    if (!globalMemoryMonitor) {
+        globalMemoryMonitor = new MemoryMonitor();
+    }
+    return globalMemoryMonitor;
+}
+/**
+ * Get global memory monitor instance
+ */
+export function getMemoryMonitor() {
+    return globalMemoryMonitor;
+}
+/**
+ * Record memory usage for current operation
+ */
+export function recordCurrentMemoryUsage(config, context) {
+    const monitor = initializeMemoryMonitor();
+    return monitor.takeSnapshot(context, config);
+}
+/**
+ * Start global memory monitoring
+ */
+export function startGlobalMemoryMonitoring(config, intervalMs = 10000) {
+    const monitor = initializeMemoryMonitor();
+    monitor.start(config, intervalMs);
+}
+/**
+ * Stop global memory monitoring
+ */
+export function stopGlobalMemoryMonitoring(config) {
+    if (globalMemoryMonitor) {
+        globalMemoryMonitor.stop(config);
+    }
+}
+/**
+ * Reset the global memory monitor singleton (test-only helper).
+ */
+export function _resetGlobalMemoryMonitorForTests() {
+    if (globalMemoryMonitor) {
+        globalMemoryMonitor.destroy();
+    }
+    globalMemoryMonitor = null;
+}
+//# sourceMappingURL=memory-monitor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-monitor.js","sourceRoot":"","sources":["../../../src/telemetry/memory-monitor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,6BAA6B,GAC9B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAkBhD,MAAM,OAAO,aAAa;IAChB,UAAU,GAA0B,IAAI,CAAC;IACzC,SAAS,GAAG,KAAK,CAAC;IAClB,YAAY,GAA0B,IAAI,CAAC;IAC3C,kBAAkB,GAAW,KAAK,CAAC;IACnC,oBAAoB,CAAuB;IAC3C,WAAW,CAAc;IACzB,qBAAqB,GAAY,IAAI,CAAC;IACtC,oBAAoB,GAAW,IAAI,CAAC,GAAG,EAAE,CAAC;IAE1C,MAAM,CAAU,yBAAyB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;IACzE,MAAM,CAAU,wBAAwB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,SAAS;IAE5E;QACE,6DAA6D;QAC7D,IAAI,CAAC,oBAAoB,GAAG,IAAI,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe;QACxE,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,sCAAsC;IACnF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAc,EAAE,aAAqB,KAAK;QAC9C,IAAI,CAAC,6BAA6B,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACvD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,kBAAkB,GAAG,UAAU,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAEtB,wBAAwB;QACxB,IAAI,CAAC,YAAY,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;QAE9C,iDAAiD;QACjD,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE;YACjC,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC,KAAK,EAAE,CAAC;IACtC,CAAC;IAED;;OAEG;IACK,sBAAsB,CAAC,MAAc;QAC3C,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAE9B,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAChC,iCAAiC;YACjC,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACtC,OAAO;QACT,CAAC;QAED,iCAAiC;QACjC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,2BAA2B;QAC3B,MAAM,aAAa,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAEnD,sDAAsD;QACtD,MAAM,eAAe,GAAG,IAAI,CAAC,oBAAoB,CAAC,kBAAkB,CAClE,KAAK,EACL,aAAa,CAAC,GAAG,CAClB,CAAC;QACF,MAAM,gBAAgB,GAAG,IAAI,CAAC,oBAAoB,CAAC,kBAAkB,CACnE,WAAW,EACX,aAAa,CAAC,QAAQ,CACvB,CAAC;QAEF,2BAA2B;QAC3B,MAAM,iBAAiB,GAAG,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;QAC3E,MAAM,kBAAkB,GAAG,IAAI,CAAC,WAAW,CAAC,YAAY,CACtD,mBAAmB,EACnB,IAAI,CACL,CAAC,CAAC,gBAAgB;QAEnB,+DAA+D;QAC/D,IAAI,CAAC,eAAe,IAAI,gBAAgB,CAAC,IAAI,kBAAkB,EAAE,CAAC;YAChE,MAAM,OAAO,GAAG,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC;YAC/D,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACrC,CAAC;aAAM,IAAI,iBAAiB,EAAE,CAAC;YAC7B,gEAAgE;YAChE,IAAI,CAAC,4BAA4B,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED;;OAEG;IACK,sBAAsB;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IACE,GAAG,GAAG,IAAI,CAAC,oBAAoB;YAC/B,aAAa,CAAC,yBAAyB,EACvC,CAAC;YACD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,oBAAoB,GAAG,GAAG,CAAC;QAChC,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,aAAa,CAAC,wBAAwB,CAAC,CAAC;QAC1E,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,aAAa,CAAC,wBAAwB,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,MAAe;QAClB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;QAED,4CAA4C;QAC5C,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,OAAe,EAAE,MAAc;QAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,EAAE,CAAC,iBAAiB,EAAE,CAAC;QAEzC,MAAM,QAAQ,GAAmB;YAC/B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,aAAa,EAAE,SAAS,CAAC,eAAe;SACzC,CAAC;QAEF,gDAAgD;QAChD,IAAI,6BAA6B,EAAE,EAAE,CAAC;YACpC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,EAAE;gBAC3C,WAAW,EAAE,gBAAgB,CAAC,SAAS;gBACvC,SAAS,EAAE,OAAO;aACnB,CAAC,CAAC;YACH,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,EAAE;gBAC5C,WAAW,EAAE,gBAAgB,CAAC,UAAU;gBACxC,SAAS,EAAE,OAAO;aACnB,CAAC,CAAC;YACH,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,EAAE;gBAC3C,WAAW,EAAE,gBAAgB,CAAC,QAAQ;gBACtC,SAAS,EAAE,OAAO;aACnB,CAAC,CAAC;YACH,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,EAAE;gBACtC,WAAW,EAAE,gBAAgB,CAAC,GAAG;gBACjC,SAAS,EAAE,OAAO;aACnB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC;QAC7B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,4BAA4B,CAClC,QAAgB,EAChB,OAAe;QAEf,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,EAAE,CAAC,iBAAiB,EAAE,CAAC;QAEzC,MAAM,QAAQ,GAAmB;YAC/B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,aAAa,EAAE,SAAS,CAAC,eAAe;SACzC,CAAC;QAEF,oDAAoD;QACpD,IAAI,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;QAClE,IAAI,CAAC,oBAAoB,CAAC,kBAAkB,CAC1C,WAAW,EACX,QAAQ,CAAC,QAAQ,CAClB,CAAC;QAEF,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC;QAC7B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,qBAAqB;QACnB,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,EAAE,CAAC,iBAAiB,EAAE,CAAC;QAEzC,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,aAAa,EAAE,SAAS,CAAC,eAAe;SACzC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,eAAe;QACb,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC7C,OAAO;YACL,QAAQ,EAAE,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ;YACvD,SAAS,EAAE,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,SAAS;YAC1D,QAAQ,EAAE,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ;YACvD,GAAG,EAAE,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG;YACxC,YAAY,EAAE,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY;SACpE,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,EAAE,CAAC,iBAAiB,EAAE,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,sBAAsB;QACpB,OAAO,EAAE,CAAC,sBAAsB,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO;YACL,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE;YAC5B,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE;YAClC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;SACzB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,0BAA0B,CACxB,MAAc,EACd,SAAiB,EACjB,SAAkB;QAElB,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAChC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,EACnD,MAAM,CACP,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,WAAmB;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC7C,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC9C,OAAO,SAAS,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,qBAAqB;QAOnB,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC7C,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;YAC/D,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;YACjE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;YAC/D,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;YACrD,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;SAC1E,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,OAAgB;QACpC,IAAI,CAAC,qBAAqB,GAAG,OAAO,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,qBAAqB;QACnB,OAAO,IAAI,CAAC,oBAAoB,CAAC,oBAAoB,EAAE,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,oBAAoB;QAMlB,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,iBAAiB,CACf,MAAc,EACd,UAAkB,QAAQ;QAE1B,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,IAAI,CAAC,oBAAoB,CAAC,sBAAsB,EAAE,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,oBAAoB,CAAC,sBAAsB,EAAE,CAAC;IACrD,CAAC;;AAGH,kDAAkD;AAClD,IAAI,mBAAmB,GAAyB,IAAI,CAAC;AAErD;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACzB,mBAAmB,GAAG,IAAI,aAAa,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAc,EACd,OAAe;IAEf,MAAM,OAAO,GAAG,uBAAuB,EAAE,CAAC;IAC1C,OAAO,OAAO,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAc,EACd,aAAqB,KAAK;IAE1B,MAAM,OAAO,GAAG,uBAAuB,EAAE,CAAC;IAC1C,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAe;IACxD,IAAI,mBAAmB,EAAE,CAAC;QACxB,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iCAAiC;IAC/C,IAAI,mBAAmB,EAAE,CAAC;QACxB,mBAAmB,CAAC,OAAO,EAAE,CAAC;IAChC,CAAC;IACD,mBAAmB,GAAG,IAAI,CAAC;AAC7B,CAAC"}