n8n-atom-mcp 0.0.1

package/dist/telemetry/mutation-tracker.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mutationTracker = exports.MutationTracker = void 0;
+const intent_classifier_js_1 = require("./intent-classifier.js");
+const mutation_validator_js_1 = require("./mutation-validator.js");
+const intent_sanitizer_js_1 = require("./intent-sanitizer.js");
+const workflow_sanitizer_js_1 = require("./workflow-sanitizer.js");
+const logger_js_1 = require("../utils/logger.js");
+class MutationTracker {
+    constructor() {
+        this.recentMutations = [];
+        this.RECENT_MUTATIONS_LIMIT = 100;
+    }
+    async processMutation(data, userId) {
+        try {
+            if (!this.validateMutationData(data)) {
+                logger_js_1.logger.debug('Mutation data validation failed');
+                return null;
+            }
+            const workflowBefore = workflow_sanitizer_js_1.WorkflowSanitizer.sanitizeWorkflowRaw(data.workflowBefore);
+            const workflowAfter = workflow_sanitizer_js_1.WorkflowSanitizer.sanitizeWorkflowRaw(data.workflowAfter);
+            const sanitizedIntent = intent_sanitizer_js_1.intentSanitizer.sanitize(data.userIntent);
+            if (mutation_validator_js_1.mutationValidator.shouldExclude(data)) {
+                logger_js_1.logger.debug('Mutation excluded from tracking based on quality criteria');
+                return null;
+            }
+            if (mutation_validator_js_1.mutationValidator.isDuplicate(workflowBefore, workflowAfter, data.operations, this.recentMutations)) {
+                logger_js_1.logger.debug('Duplicate mutation detected, skipping tracking');
+                return null;
+            }
+            const hashBefore = mutation_validator_js_1.mutationValidator.hashWorkflow(workflowBefore);
+            const hashAfter = mutation_validator_js_1.mutationValidator.hashWorkflow(workflowAfter);
+            const structureHashBefore = workflow_sanitizer_js_1.WorkflowSanitizer.generateWorkflowHash(workflowBefore);
+            const structureHashAfter = workflow_sanitizer_js_1.WorkflowSanitizer.generateWorkflowHash(workflowAfter);
+            const intentClassification = intent_classifier_js_1.intentClassifier.classify(data.operations, sanitizedIntent);
+            const changeMetrics = this.calculateChangeMetrics(data.operations);
+            const validationMetrics = this.calculateValidationMetrics(data.validationBefore, data.validationAfter);
+            const record = {
+                userId,
+                sessionId: data.sessionId,
+                workflowBefore,
+                workflowAfter,
+                workflowHashBefore: hashBefore,
+                workflowHashAfter: hashAfter,
+                workflowStructureHashBefore: structureHashBefore,
+                workflowStructureHashAfter: structureHashAfter,
+                userIntent: sanitizedIntent,
+                intentClassification,
+                toolName: data.toolName,
+                operations: data.operations,
+                operationCount: data.operations.length,
+                operationTypes: this.extractOperationTypes(data.operations),
+                validationBefore: data.validationBefore,
+                validationAfter: data.validationAfter,
+                ...validationMetrics,
+                ...changeMetrics,
+                mutationSuccess: data.mutationSuccess,
+                mutationError: data.mutationError,
+                durationMs: data.durationMs,
+            };
+            this.addToRecentMutations(hashBefore, hashAfter, data.operations);
+            return record;
+        }
+        catch (error) {
+            logger_js_1.logger.error('Error processing mutation:', error);
+            return null;
+        }
+    }
+    validateMutationData(data) {
+        const validationResult = mutation_validator_js_1.mutationValidator.validate(data);
+        if (!validationResult.valid) {
+            logger_js_1.logger.warn('Mutation data validation failed:', validationResult.errors);
+            return false;
+        }
+        if (validationResult.warnings.length > 0) {
+            logger_js_1.logger.debug('Mutation data validation warnings:', validationResult.warnings);
+        }
+        return true;
+    }
+    calculateChangeMetrics(operations) {
+        const metrics = {
+            nodesAdded: 0,
+            nodesRemoved: 0,
+            nodesModified: 0,
+            connectionsAdded: 0,
+            connectionsRemoved: 0,
+            propertiesChanged: 0,
+        };
+        for (const op of operations) {
+            switch (op.type) {
+                case 'addNode':
+                    metrics.nodesAdded++;
+                    break;
+                case 'removeNode':
+                    metrics.nodesRemoved++;
+                    break;
+                case 'updateNode':
+                    metrics.nodesModified++;
+                    if ('updates' in op && op.updates) {
+                        metrics.propertiesChanged += Object.keys(op.updates).length;
+                    }
+                    break;
+                case 'addConnection':
+                    metrics.connectionsAdded++;
+                    break;
+                case 'removeConnection':
+                    metrics.connectionsRemoved++;
+                    break;
+                case 'rewireConnection':
+                    metrics.connectionsRemoved++;
+                    metrics.connectionsAdded++;
+                    break;
+                case 'replaceConnections':
+                    if ('connections' in op && op.connections) {
+                        metrics.connectionsRemoved++;
+                        metrics.connectionsAdded++;
+                    }
+                    break;
+                case 'updateSettings':
+                    if ('settings' in op && op.settings) {
+                        metrics.propertiesChanged += Object.keys(op.settings).length;
+                    }
+                    break;
+                case 'moveNode':
+                case 'enableNode':
+                case 'disableNode':
+                case 'updateName':
+                case 'addTag':
+                case 'removeTag':
+                case 'activateWorkflow':
+                case 'deactivateWorkflow':
+                case 'cleanStaleConnections':
+                    metrics.propertiesChanged++;
+                    break;
+            }
+        }
+        return metrics;
+    }
+    calculateValidationMetrics(validationBefore, validationAfter) {
+        if (!validationBefore || !validationAfter) {
+            return {
+                validationImproved: null,
+                errorsResolved: 0,
+                errorsIntroduced: 0,
+            };
+        }
+        const errorsBefore = validationBefore.errors?.length || 0;
+        const errorsAfter = validationAfter.errors?.length || 0;
+        const errorsResolved = Math.max(0, errorsBefore - errorsAfter);
+        const errorsIntroduced = Math.max(0, errorsAfter - errorsBefore);
+        const validationImproved = errorsBefore > errorsAfter;
+        return {
+            validationImproved,
+            errorsResolved,
+            errorsIntroduced,
+        };
+    }
+    extractOperationTypes(operations) {
+        const types = new Set(operations.map((op) => op.type));
+        return Array.from(types);
+    }
+    addToRecentMutations(hashBefore, hashAfter, operations) {
+        this.recentMutations.push({ hashBefore, hashAfter, operations });
+        if (this.recentMutations.length > this.RECENT_MUTATIONS_LIMIT) {
+            this.recentMutations.shift();
+        }
+    }
+    clearRecentMutations() {
+        this.recentMutations = [];
+    }
+    getRecentMutationsCount() {
+        return this.recentMutations.length;
+    }
+}
+exports.MutationTracker = MutationTracker;
+exports.mutationTracker = new MutationTracker();
+//# sourceMappingURL=mutation-tracker.js.map

package/dist/telemetry/mutation-tracker.js.map

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

package/dist/telemetry/mutation-types.d.ts

@@ -0,0 +1,106 @@
+import { DiffOperation } from '../types/workflow-diff.js';
+export declare enum IntentClassification {
+    ADD_FUNCTIONALITY = "add_functionality",
+    MODIFY_CONFIGURATION = "modify_configuration",
+    REWIRE_LOGIC = "rewire_logic",
+    FIX_VALIDATION = "fix_validation",
+    CLEANUP = "cleanup",
+    UNKNOWN = "unknown"
+}
+export declare enum MutationToolName {
+    UPDATE_PARTIAL = "n8n_update_partial_workflow",
+    UPDATE_FULL = "n8n_update_full_workflow"
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: Array<{
+        type: string;
+        message: string;
+        severity?: string;
+        location?: string;
+    }>;
+    warnings?: Array<{
+        type: string;
+        message: string;
+    }>;
+}
+export interface MutationChangeMetrics {
+    nodesAdded: number;
+    nodesRemoved: number;
+    nodesModified: number;
+    connectionsAdded: number;
+    connectionsRemoved: number;
+    propertiesChanged: number;
+}
+export interface MutationValidationMetrics {
+    validationImproved: boolean | null;
+    errorsResolved: number;
+    errorsIntroduced: number;
+}
+export interface WorkflowMutationData {
+    sessionId: string;
+    toolName: MutationToolName;
+    userIntent: string;
+    operations: DiffOperation[];
+    workflowBefore: any;
+    workflowAfter: any;
+    validationBefore?: ValidationResult;
+    validationAfter?: ValidationResult;
+    mutationSuccess: boolean;
+    mutationError?: string;
+    durationMs: number;
+}
+export interface WorkflowMutationRecord {
+    id?: string;
+    userId: string;
+    sessionId: string;
+    workflowBefore: any;
+    workflowAfter: any;
+    workflowHashBefore: string;
+    workflowHashAfter: string;
+    workflowStructureHashBefore?: string;
+    workflowStructureHashAfter?: string;
+    isTrulySuccessful?: boolean;
+    userIntent: string;
+    intentClassification: IntentClassification;
+    toolName: MutationToolName;
+    operations: DiffOperation[];
+    operationCount: number;
+    operationTypes: string[];
+    validationBefore?: ValidationResult;
+    validationAfter?: ValidationResult;
+    validationImproved: boolean | null;
+    errorsResolved: number;
+    errorsIntroduced: number;
+    nodesAdded: number;
+    nodesRemoved: number;
+    nodesModified: number;
+    connectionsAdded: number;
+    connectionsRemoved: number;
+    propertiesChanged: number;
+    mutationSuccess: boolean;
+    mutationError?: string;
+    durationMs: number;
+    createdAt?: Date;
+}
+export interface MutationTrackingOptions {
+    enabled?: boolean;
+    maxWorkflowSizeKb?: number;
+    validateQuality?: boolean;
+    sanitize?: boolean;
+}
+export interface MutationTrackingStats {
+    totalMutationsTracked: number;
+    successfulMutations: number;
+    failedMutations: number;
+    mutationsWithValidationImprovement: number;
+    averageDurationMs: number;
+    intentClassificationBreakdown: Record<IntentClassification, number>;
+    operationTypeBreakdown: Record<string, number>;
+}
+export interface MutationDataQualityResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+//# sourceMappingURL=mutation-types.d.ts.map

package/dist/telemetry/mutation-types.d.ts.map

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

package/dist/telemetry/mutation-types.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MutationToolName = exports.IntentClassification = void 0;
+var IntentClassification;
+(function (IntentClassification) {
+    IntentClassification["ADD_FUNCTIONALITY"] = "add_functionality";
+    IntentClassification["MODIFY_CONFIGURATION"] = "modify_configuration";
+    IntentClassification["REWIRE_LOGIC"] = "rewire_logic";
+    IntentClassification["FIX_VALIDATION"] = "fix_validation";
+    IntentClassification["CLEANUP"] = "cleanup";
+    IntentClassification["UNKNOWN"] = "unknown";
+})(IntentClassification || (exports.IntentClassification = IntentClassification = {}));
+var MutationToolName;
+(function (MutationToolName) {
+    MutationToolName["UPDATE_PARTIAL"] = "n8n_update_partial_workflow";
+    MutationToolName["UPDATE_FULL"] = "n8n_update_full_workflow";
+})(MutationToolName || (exports.MutationToolName = MutationToolName = {}));
+//# sourceMappingURL=mutation-types.js.map

package/dist/telemetry/mutation-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-types.js","sourceRoot":"","sources":["../../src/telemetry/mutation-types.ts"],"names":[],"mappings":";;;AAUA,IAAY,oBAOX;AAPD,WAAY,oBAAoB;IAC9B,+DAAuC,CAAA;IACvC,qEAA6C,CAAA;IAC7C,qDAA6B,CAAA;IAC7B,yDAAiC,CAAA;IACjC,2CAAmB,CAAA;IACnB,2CAAmB,CAAA;AACrB,CAAC,EAPW,oBAAoB,oCAApB,oBAAoB,QAO/B;AAKD,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IAC1B,kEAA8C,CAAA;IAC9C,4DAAwC,CAAA;AAC1C,CAAC,EAHW,gBAAgB,gCAAhB,gBAAgB,QAG3B"}

package/dist/telemetry/mutation-validator.d.ts

@@ -0,0 +1,20 @@
+import { WorkflowMutationData, MutationDataQualityResult, MutationTrackingOptions } from './mutation-types.js';
+export declare const DEFAULT_MUTATION_TRACKING_OPTIONS: Required<MutationTrackingOptions>;
+export declare class MutationValidator {
+    private options;
+    constructor(options?: MutationTrackingOptions);
+    validate(data: WorkflowMutationData): MutationDataQualityResult;
+    private isValidWorkflow;
+    private getWorkflowSizeKb;
+    private hasMeaningfulChange;
+    hashWorkflow(workflow: any): string;
+    shouldExclude(data: WorkflowMutationData): boolean;
+    isDuplicate(workflowBefore: any, workflowAfter: any, operations: any[], recentMutations: Array<{
+        hashBefore: string;
+        hashAfter: string;
+        operations: any[];
+    }>): boolean;
+    private hashOperations;
+}
+export declare const mutationValidator: MutationValidator;
+//# sourceMappingURL=mutation-validator.d.ts.map

package/dist/telemetry/mutation-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-validator.d.ts","sourceRoot":"","sources":["../../src/telemetry/mutation-validator.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAK7B,eAAO,MAAM,iCAAiC,EAAE,QAAQ,CAAC,uBAAuB,CAK/E,CAAC;AAKF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAoC;gBAEvC,OAAO,GAAE,uBAA4B;IAOjD,QAAQ,CAAC,IAAI,EAAE,oBAAoB,GAAG,yBAAyB;IA+E/D,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,mBAAmB;IAe3B,YAAY,CAAC,QAAQ,EAAE,GAAG,GAAG,MAAM;IAYnC,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO;IA4BlD,WAAW,CACT,cAAc,EAAE,GAAG,EACnB,aAAa,EAAE,GAAG,EAClB,UAAU,EAAE,GAAG,EAAE,EACjB,eAAe,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC,GACnF,OAAO;IAgBV,OAAO,CAAC,cAAc;CAQvB;AAKD,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/telemetry/mutation-validator.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mutationValidator = exports.MutationValidator = exports.DEFAULT_MUTATION_TRACKING_OPTIONS = void 0;
+const crypto_1 = require("crypto");
+exports.DEFAULT_MUTATION_TRACKING_OPTIONS = {
+    enabled: true,
+    maxWorkflowSizeKb: 500,
+    validateQuality: true,
+    sanitize: true,
+};
+class MutationValidator {
+    constructor(options = {}) {
+        this.options = { ...exports.DEFAULT_MUTATION_TRACKING_OPTIONS, ...options };
+    }
+    validate(data) {
+        const errors = [];
+        const warnings = [];
+        if (!this.isValidWorkflow(data.workflowBefore)) {
+            errors.push('Invalid workflow_before structure');
+        }
+        if (!this.isValidWorkflow(data.workflowAfter)) {
+            errors.push('Invalid workflow_after structure');
+        }
+        const beforeSizeKb = this.getWorkflowSizeKb(data.workflowBefore);
+        const afterSizeKb = this.getWorkflowSizeKb(data.workflowAfter);
+        if (beforeSizeKb > this.options.maxWorkflowSizeKb) {
+            errors.push(`workflow_before size (${beforeSizeKb}KB) exceeds maximum (${this.options.maxWorkflowSizeKb}KB)`);
+        }
+        if (afterSizeKb > this.options.maxWorkflowSizeKb) {
+            errors.push(`workflow_after size (${afterSizeKb}KB) exceeds maximum (${this.options.maxWorkflowSizeKb}KB)`);
+        }
+        if (!this.hasMeaningfulChange(data.workflowBefore, data.workflowAfter)) {
+            warnings.push('No meaningful change detected between before and after workflows');
+        }
+        if (!data.userIntent || data.userIntent.trim().length === 0) {
+            warnings.push('User intent is empty');
+        }
+        else if (data.userIntent.trim().length < 5) {
+            warnings.push('User intent is too short (less than 5 characters)');
+        }
+        else if (data.userIntent.length > 1000) {
+            warnings.push('User intent is very long (over 1000 characters)');
+        }
+        if (!data.operations || data.operations.length === 0) {
+            errors.push('No operations provided');
+        }
+        if (data.validationBefore && data.validationAfter) {
+            if (typeof data.validationBefore.valid !== 'boolean') {
+                warnings.push('Invalid validation_before structure');
+            }
+            if (typeof data.validationAfter.valid !== 'boolean') {
+                warnings.push('Invalid validation_after structure');
+            }
+        }
+        if (data.durationMs !== undefined) {
+            if (data.durationMs < 0) {
+                errors.push('Duration cannot be negative');
+            }
+            if (data.durationMs > 300000) {
+                warnings.push('Duration is very long (over 5 minutes)');
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    isValidWorkflow(workflow) {
+        if (!workflow || typeof workflow !== 'object') {
+            return false;
+        }
+        if (!Array.isArray(workflow.nodes)) {
+            return false;
+        }
+        if (!workflow.connections || typeof workflow.connections !== 'object') {
+            return false;
+        }
+        return true;
+    }
+    getWorkflowSizeKb(workflow) {
+        try {
+            const json = JSON.stringify(workflow);
+            return json.length / 1024;
+        }
+        catch {
+            return 0;
+        }
+    }
+    hasMeaningfulChange(workflowBefore, workflowAfter) {
+        try {
+            const hashBefore = this.hashWorkflow(workflowBefore);
+            const hashAfter = this.hashWorkflow(workflowAfter);
+            return hashBefore !== hashAfter;
+        }
+        catch {
+            return false;
+        }
+    }
+    hashWorkflow(workflow) {
+        try {
+            const json = JSON.stringify(workflow);
+            return (0, crypto_1.createHash)('sha256').update(json).digest('hex').substring(0, 16);
+        }
+        catch {
+            return '';
+        }
+    }
+    shouldExclude(data) {
+        if (!data.mutationSuccess && !data.mutationError) {
+            return true;
+        }
+        if (!this.hasMeaningfulChange(data.workflowBefore, data.workflowAfter)) {
+            return true;
+        }
+        const beforeSizeKb = this.getWorkflowSizeKb(data.workflowBefore);
+        const afterSizeKb = this.getWorkflowSizeKb(data.workflowAfter);
+        if (beforeSizeKb > this.options.maxWorkflowSizeKb ||
+            afterSizeKb > this.options.maxWorkflowSizeKb) {
+            return true;
+        }
+        return false;
+    }
+    isDuplicate(workflowBefore, workflowAfter, operations, recentMutations) {
+        const hashBefore = this.hashWorkflow(workflowBefore);
+        const hashAfter = this.hashWorkflow(workflowAfter);
+        const operationsHash = this.hashOperations(operations);
+        return recentMutations.some((m) => m.hashBefore === hashBefore &&
+            m.hashAfter === hashAfter &&
+            this.hashOperations(m.operations) === operationsHash);
+    }
+    hashOperations(operations) {
+        try {
+            const json = JSON.stringify(operations);
+            return (0, crypto_1.createHash)('sha256').update(json).digest('hex').substring(0, 16);
+        }
+        catch {
+            return '';
+        }
+    }
+}
+exports.MutationValidator = MutationValidator;
+exports.mutationValidator = new MutationValidator();
+//# sourceMappingURL=mutation-validator.js.map

package/dist/telemetry/mutation-validator.js.map

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

package/dist/telemetry/performance-monitor.d.ts

@@ -0,0 +1,113 @@
+export declare class TelemetryPerformanceMonitor {
+    private metrics;
+    private operationTimers;
+    private readonly maxMetrics;
+    private startupTime;
+    private operationCounts;
+    startOperation(operation: string): void;
+    endOperation(operation: string): number;
+    private recordMetric;
+    private captureMemoryUsage;
+    getStatistics(): {
+        totalOperations: number;
+        averageDuration: number;
+        slowOperations: number;
+        operationsByType: {};
+        memoryUsage: {
+            heapUsed: number;
+            heapTotal: number;
+            external: number;
+        } | undefined;
+        uptimeMs: number;
+        overhead: {
+            percentage: number;
+            totalMs: number;
+        };
+        operationsInLastMinute?: undefined;
+    } | {
+        totalOperations: number;
+        operationsInLastMinute: number;
+        averageDuration: number;
+        slowOperations: number;
+        operationsByType: Record<string, {
+            count: number;
+            avgDuration: number;
+        }>;
+        memoryUsage: {
+            heapUsed: number;
+            heapTotal: number;
+            external: number;
+        } | undefined;
+        uptimeMs: number;
+        overhead: {
+            percentage: number;
+            totalMs: number;
+        };
+    };
+    getDetailedReport(): {
+        summary: {
+            totalOperations: number;
+            averageDuration: number;
+            slowOperations: number;
+            operationsByType: {};
+            memoryUsage: {
+                heapUsed: number;
+                heapTotal: number;
+                external: number;
+            } | undefined;
+            uptimeMs: number;
+            overhead: {
+                percentage: number;
+                totalMs: number;
+            };
+            operationsInLastMinute?: undefined;
+        } | {
+            totalOperations: number;
+            operationsInLastMinute: number;
+            averageDuration: number;
+            slowOperations: number;
+            operationsByType: Record<string, {
+                count: number;
+                avgDuration: number;
+            }>;
+            memoryUsage: {
+                heapUsed: number;
+                heapTotal: number;
+                external: number;
+            } | undefined;
+            uptimeMs: number;
+            overhead: {
+                percentage: number;
+                totalMs: number;
+            };
+        };
+        percentiles: {
+            p50: number;
+            p75: number;
+            p90: number;
+            p95: number;
+            p99: number;
+        };
+        topSlowOperations: {
+            operation: string;
+            duration: number;
+            timestamp: number;
+        }[];
+        memoryTrend: {
+            trend: string;
+            delta: number;
+        };
+        recommendations: string[];
+    };
+    private calculatePercentiles;
+    private percentile;
+    private getTopSlowOperations;
+    private getMemoryTrend;
+    private generateRecommendations;
+    reset(): void;
+    getTelemetryOverhead(): {
+        percentage: number;
+        impact: 'minimal' | 'low' | 'moderate' | 'high';
+    };
+}
+//# sourceMappingURL=performance-monitor.d.ts.map

package/dist/telemetry/performance-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-monitor.d.ts","sourceRoot":"","sources":["../../src/telemetry/performance-monitor.ts"],"names":[],"mappings":"AAkBA,qBAAa,2BAA2B;IACtC,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,eAAe,CAAkC;IAKzD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOvC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IA8BvC,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,kBAAkB;IAe1B,aAAa;;;;;;;;;;;;;;;;;;;;;;mBA0BqC,MAAM;yBAAe,MAAM;;;;;;;;;;;;;IAwC7E,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;uBAxCiC,MAAM;6BAAe,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwD7E,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,oBAAoB;IAc5B,OAAO,CAAC,cAAc;IAsBtB,OAAO,CAAC,uBAAuB;IAmC/B,KAAK,IAAI,IAAI;IAUb,oBAAoB,IAAI;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,CAAA;KAAE;CAYhG"}