@mxf-dev/core 1.0.0 → 2.0.0

package/dist/mxp/MxpEventForwardingEnhancer.js

@@ -1,361 +0,0 @@
-/**
- * Copyright 2024 Brad Anderson
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * @author Brad Anderson <BradA1878@pm.me>
- * @repository https://github.com/mxf-dev/mxf
- * @documentation https://mxf-dev.github.io/mxf/
- */
-/**
- * MXP Event Forwarding Queue Enhancer
- *
- * Enhances the existing EventForwardingQueue with MXP 2.0 compression and optimization.
- * Integrates binary protocol, message batching, and priority-aware compression.
- * Only activates when bandwidth optimization is enabled.
- */
-import { v4 as uuidv4 } from 'uuid';
-import { Logger } from '../utils/Logger.js';
-import { createStrictValidator } from '../utils/validation.js';
-import { MxpConfigManager } from './MxpConfigManager.js';
-import { BinaryProtocolLayer } from './BinaryProtocolLayer.js';
-// Event priority levels (matching existing system)
-export var EventPriority;
-(function (EventPriority) {
-    EventPriority[EventPriority["CRITICAL"] = 0] = "CRITICAL";
-    EventPriority[EventPriority["HIGH"] = 1] = "HIGH";
-    EventPriority[EventPriority["NORMAL"] = 2] = "NORMAL";
-    EventPriority[EventPriority["LOW"] = 3] = "LOW";
-    EventPriority[EventPriority["BACKGROUND"] = 4] = "BACKGROUND"; // Memory updates, analytics
-})(EventPriority || (EventPriority = {}));
-// Default MXP-enhanced configuration
-const defaultMxpQueueConfig = {
-    enabled: true,
-    batchSize: 10,
-    processingDelayMs: 25,
-    maxQueueSize: 1000,
-    maxRetries: 3,
-    mxpEnabled: true,
-    compressionByPriority: {
-        [EventPriority.CRITICAL]: {
-            enabled: false, // Speed over size for critical events
-            algorithm: 'none',
-            minSize: 0
-        },
-        [EventPriority.HIGH]: {
-            enabled: true, // Light compression for high priority
-            algorithm: 'msgpack',
-            minSize: 512 // 512 bytes minimum
-        },
-        [EventPriority.NORMAL]: {
-            enabled: true, // Standard compression
-            algorithm: 'msgpack',
-            minSize: 256 // 256 bytes minimum
-        },
-        [EventPriority.LOW]: {
-            enabled: true, // Aggressive compression for low priority
-            algorithm: 'msgpack-compressed',
-            minSize: 128 // 128 bytes minimum
-        },
-        [EventPriority.BACKGROUND]: {
-            enabled: true, // Maximum compression for background
-            algorithm: 'msgpack-compressed',
-            minSize: 64 // 64 bytes minimum
-        }
-    }
-};
-export class MxpEventForwardingEnhancer {
-    static instance = null;
-    logger;
-    validator = createStrictValidator('MxpEventForwardingEnhancer');
-    config;
-    // Enhanced queues with MXP support
-    enhancedQueues = new Map();
-    processing = false;
-    processingTimer = null;
-    // Statistics tracking
-    stats = {
-        totalEvents: 0,
-        compressedEvents: 0,
-        totalBandwidthSaved: 0,
-        averageCompressionRatio: 0,
-        processingTimeMs: 0
-    };
-    constructor(config = defaultMxpQueueConfig) {
-        this.config = { ...config };
-        this.logger = new Logger('info', 'MxpEventForwardingEnhancer', 'server');
-        // Initialize enhanced priority queues
-        Object.values(EventPriority).forEach(priority => {
-            if (typeof priority === 'number') {
-                this.enhancedQueues.set(priority, []);
-            }
-        });
-    }
-    /**
-     * Get the singleton instance of MxpEventForwardingEnhancer
-     */
-    static getInstance() {
-        if (!MxpEventForwardingEnhancer.instance) {
-            MxpEventForwardingEnhancer.instance = new MxpEventForwardingEnhancer();
-        }
-        return MxpEventForwardingEnhancer.instance;
-    }
-    /**
-     * Enhanced event queueing with MXP compression support
-     * Only applies compression when bandwidth optimization is enabled
-     */
-    async enqueueEvent(eventName, payload, priority, targetId, type, channelId, excludedAgentId) {
-        this.validator.assertIsNonEmptyString(eventName, 'Event name is required');
-        this.validator.assertIsObject(payload, 'Event payload must be an object');
-        this.validator.assertIsNonEmptyString(targetId, 'Target ID is required');
-        try {
-            const startTime = Date.now();
-            // Check if MXP bandwidth optimization is enabled for this context
-            const isBandwidthOptEnabled = channelId ?
-                MxpConfigManager.getInstance().isFeatureEnabled(channelId, 'bandwidthOptimization', targetId) :
-                false;
-            // Create base event
-            const event = {
-                id: `mxp_event_${uuidv4()}`,
-                priority,
-                type,
-                eventName,
-                payload,
-                targetId,
-                excludedAgentId,
-                timestamp: Date.now(),
-                retryCount: 0,
-                compressionEnabled: isBandwidthOptEnabled && this.config.mxpEnabled,
-                channelId
-            };
-            // Apply MXP compression if enabled
-            if (event.compressionEnabled && this.shouldCompressEvent(event)) {
-                await this.applyMxpCompression(event);
-            }
-            // Add to appropriate priority queue
-            const queue = this.enhancedQueues.get(priority);
-            if (queue) {
-                // Check queue size limits
-                if (queue.length >= this.config.maxQueueSize) {
-                    this.logger.warn(`Queue full for priority ${priority}, dropping oldest event`);
-                    queue.shift(); // Remove oldest event
-                }
-                queue.push(event);
-                this.stats.totalEvents++;
-                // ;
-            }
-            // Start processing if not already running
-            if (!this.processing && this.config.enabled) {
-                this.startProcessing();
-            }
-        }
-        catch (error) {
-            this.logger.error('Failed to enqueue MXP event', {
-                error: error instanceof Error ? error.message : String(error),
-                eventName,
-                priority: EventPriority[priority],
-                targetId
-            });
-            throw error;
-        }
-    }
-    /**
-     * Enhanced batch processing with MXP compression awareness
-     */
-    async processBatch() {
-        const batch = [];
-        const batchStartTime = Date.now();
-        // Collect events by priority (CRITICAL first)
-        for (const priority of [EventPriority.CRITICAL, EventPriority.HIGH, EventPriority.NORMAL, EventPriority.LOW, EventPriority.BACKGROUND]) {
-            const queue = this.enhancedQueues.get(priority);
-            if (queue && queue.length > 0) {
-                const batchSize = Math.min(this.config.batchSize - batch.length, queue.length);
-                batch.push(...queue.splice(0, batchSize));
-                if (batch.length >= this.config.batchSize)
-                    break;
-            }
-        }
-        if (batch.length === 0)
-            return;
-        try {
-            // Group events by compression status for efficient processing
-            const compressedEvents = batch.filter(e => e.compressedData);
-            const uncompressedEvents = batch.filter(e => !e.compressedData);
-            // ;
-            // Process compressed events (may need decompression for forwarding)
-            for (const event of compressedEvents) {
-                await this.processCompressedEvent(event);
-            }
-            // Process uncompressed events normally
-            for (const event of uncompressedEvents) {
-                await this.processUncompressedEvent(event);
-            }
-            // Update statistics
-            this.stats.processingTimeMs += (Date.now() - batchStartTime);
-        }
-        catch (error) {
-            this.logger.error('Batch processing failed', {
-                error: error instanceof Error ? error.message : String(error),
-                batchSize: batch.length
-            });
-        }
-    }
-    /**
-     * Apply MXP compression to an event if warranted
-     */
-    async applyMxpCompression(event) {
-        const priorityConfig = this.config.compressionByPriority[event.priority];
-        if (!priorityConfig.enabled) {
-            return; // Compression disabled for this priority level
-        }
-        try {
-            // Calculate payload size
-            const payloadString = JSON.stringify(event.payload);
-            const payloadSize = Buffer.byteLength(payloadString, 'utf8');
-            event.originalSize = payloadSize;
-            // Check minimum size threshold
-            if (payloadSize < priorityConfig.minSize) {
-                return;
-            }
-            // Create MXP message for compression
-            const mxpMessage = {
-                type: event.eventName,
-                payload: event.payload,
-                metadata: {
-                    eventId: event.id,
-                    priority: event.priority,
-                    timestamp: event.timestamp
-                },
-                size: payloadSize
-            };
-            // Apply compression using BinaryProtocolLayer
-            const compressionResult = BinaryProtocolLayer.getInstance().encodeMessage(mxpMessage, event.channelId || 'default', event.targetId);
-            if (compressionResult) {
-                event.compressedData = compressionResult;
-                this.stats.compressedEvents++;
-                this.stats.totalBandwidthSaved += (compressionResult.originalSize - compressionResult.compressedSize);
-                // Update average compression ratio
-                const totalCompressed = this.stats.compressedEvents;
-                this.stats.averageCompressionRatio =
-                    ((this.stats.averageCompressionRatio * (totalCompressed - 1)) + compressionResult.compressionRatio) / totalCompressed;
-                // ;
-            }
-        }
-        catch (error) {
-            this.logger.warn('MXP compression failed, proceeding without compression', {
-                error: error instanceof Error ? error.message : String(error),
-                eventId: event.id
-            });
-        }
-    }
-    /**
-     * Check if an event should be compressed based on configuration
-     */
-    shouldCompressEvent(event) {
-        const priorityConfig = this.config.compressionByPriority[event.priority];
-        return priorityConfig.enabled && this.config.mxpEnabled;
-    }
-    /**
-     * Process a compressed event (placeholder for actual forwarding logic)
-     */
-    async processCompressedEvent(event) {
-        // In full implementation, this would forward the compressed event
-        // For now, we'll decompress and forward normally as a placeholder
-        if (event.compressedData) {
-            // Optionally decompress for forwarding (depends on receiving end capability)
-            const decompressed = BinaryProtocolLayer.getInstance().decodeMessage(event.compressedData);
-            if (decompressed) {
-                // Forward the decompressed message
-                // ;
-            }
-        }
-    }
-    /**
-     * Process an uncompressed event (placeholder for actual forwarding logic)
-     */
-    async processUncompressedEvent(event) {
-        // In full implementation, this would forward the event normally
-        // ;
-    }
-    /**
-     * Start enhanced batch processing
-     */
-    startProcessing() {
-        if (this.processing || !this.config.enabled)
-            return;
-        this.processing = true;
-        this.scheduleNextBatch();
-    }
-    /**
-     * Stop enhanced batch processing
-     */
-    stopProcessing() {
-        this.processing = false;
-        if (this.processingTimer) {
-            clearTimeout(this.processingTimer);
-            this.processingTimer = null;
-        }
-    }
-    /**
-     * Schedule next batch processing
-     */
-    scheduleNextBatch() {
-        if (!this.processing)
-            return;
-        this.processingTimer = setTimeout(() => {
-            this.processBatch();
-            this.scheduleNextBatch();
-        }, this.config.processingDelayMs);
-    }
-    /**
-     * Get MXP-enhanced queue statistics
-     */
-    getEnhancedStats() {
-        const queueSizes = {};
-        for (const [priority, queue] of this.enhancedQueues.entries()) {
-            queueSizes[EventPriority[priority]] = queue.length;
-        }
-        return {
-            totalEvents: this.stats.totalEvents,
-            compressedEvents: this.stats.compressedEvents,
-            compressionRate: this.stats.totalEvents > 0 ?
-                Math.round((this.stats.compressedEvents / this.stats.totalEvents) * 100) : 0,
-            totalBandwidthSaved: this.stats.totalBandwidthSaved,
-            averageCompressionRatio: this.stats.averageCompressionRatio,
-            queueSizes,
-            processingTimeMs: this.stats.processingTimeMs
-        };
-    }
-    /**
-     * Update configuration at runtime
-     */
-    updateConfig(newConfig) {
-        this.config = { ...this.config, ...newConfig };
-    }
-    /**
-     * Clear all queues (useful for testing or shutdown)
-     */
-    clearQueues() {
-        for (const queue of this.enhancedQueues.values()) {
-            queue.length = 0;
-        }
-    }
-    /**
-     * Check if MXP enhancement is enabled
-     */
-    isMxpEnabled() {
-        return this.config.mxpEnabled;
-    }
-}
-// Note: Use MxpEventForwardingEnhancer.getInstance() to get the singleton instance
-//# sourceMappingURL=MxpEventForwardingEnhancer.js.map

package/dist/mxp/MxpEventForwardingEnhancer.js.map

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

package/dist/protocols/mcp/services/ToolSchemaEnhancements.d.ts

@@ -1,56 +0,0 @@
-/**
- * Copyright 2024 Brad Anderson
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * @author Brad Anderson <BradA1878@pm.me>
- * @repository https://github.com/mxf-dev/mxf
- * @documentation https://mxf-dev.github.io/mxf/
- */
-/**
- * ToolSchemaEnhancements.ts
- *
- * Provides enhanced schemas and examples for external MCP tools to improve
- * agent understanding of complex tool structures. This is particularly useful
- * for tools with nested objects or domain-specific knowledge (like n8n workflows).
- */
-/**
- * Schema enhancement for a specific tool
- */
-export interface ToolSchemaEnhancement {
-    /** Tool name to enhance */
-    toolName: string;
-    /** Server ID that provides the tool */
-    serverId: string;
-    /** Examples to add to the schema */
-    examples?: any[];
-    /** Additional schema properties to merge */
-    propertyEnhancements?: Record<string, any>;
-}
-/**
- * All tool schema enhancements
- *
- * NOTE: Previously contained n8n workflow enhancements, but those are no longer
- * needed since the actual n8n-mcp server (czlonkowski/n8n-mcp) has built-in
- * validation, autofix, and example support.
- */
-export declare const TOOL_SCHEMA_ENHANCEMENTS: ToolSchemaEnhancement[];
-/**
- * Find enhancement for a specific tool
- */
-export declare const findToolEnhancement: (toolName: string, serverId: string) => ToolSchemaEnhancement | undefined;
-/**
- * Apply enhancements to a tool's input schema
- */
-export declare const enhanceToolSchema: (toolName: string, serverId: string, originalSchema: Record<string, any>) => Record<string, any>;
-//# sourceMappingURL=ToolSchemaEnhancements.d.ts.map

package/dist/protocols/mcp/services/ToolSchemaEnhancements.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ToolSchemaEnhancements.d.ts","sourceRoot":"","sources":["../../../../src/protocols/mcp/services/ToolSchemaEnhancements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;IACjB,4CAA4C;IAC5C,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,EAAE,qBAAqB,EAAO,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,UAAU,MAAM,EAAE,UAAU,MAAM,KAAG,qBAAqB,GAAG,SAIhG,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC1B,UAAU,MAAM,EAChB,UAAU,MAAM,EAChB,gBAAgB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KACpC,MAAM,CAAC,MAAM,EAAE,GAAG,CAwBpB,CAAC"}

package/dist/protocols/mcp/services/ToolSchemaEnhancements.js

@@ -1,57 +0,0 @@
-/**
- * Copyright 2024 Brad Anderson
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * @author Brad Anderson <BradA1878@pm.me>
- * @repository https://github.com/mxf-dev/mxf
- * @documentation https://mxf-dev.github.io/mxf/
- */
-/**
- * All tool schema enhancements
- *
- * NOTE: Previously contained n8n workflow enhancements, but those are no longer
- * needed since the actual n8n-mcp server (czlonkowski/n8n-mcp) has built-in
- * validation, autofix, and example support.
- */
-export const TOOL_SCHEMA_ENHANCEMENTS = [];
-/**
- * Find enhancement for a specific tool
- */
-export const findToolEnhancement = (toolName, serverId) => {
-    return TOOL_SCHEMA_ENHANCEMENTS.find(enhancement => enhancement.toolName === toolName && enhancement.serverId === serverId);
-};
-/**
- * Apply enhancements to a tool's input schema
- */
-export const enhanceToolSchema = (toolName, serverId, originalSchema) => {
-    const enhancement = findToolEnhancement(toolName, serverId);
-    if (!enhancement) {
-        return originalSchema;
-    }
-    // Create enhanced schema by merging
-    const enhancedSchema = { ...originalSchema };
-    // Add examples if provided
-    if (enhancement.examples && enhancement.examples.length > 0) {
-        enhancedSchema.examples = enhancement.examples;
-    }
-    // Enhance property definitions if provided
-    if (enhancement.propertyEnhancements && enhancedSchema.properties) {
-        enhancedSchema.properties = {
-            ...enhancedSchema.properties,
-            ...enhancement.propertyEnhancements
-        };
-    }
-    return enhancedSchema;
-};
-//# sourceMappingURL=ToolSchemaEnhancements.js.map

package/dist/protocols/mcp/services/ToolSchemaEnhancements.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ToolSchemaEnhancements.js","sourceRoot":"","sources":["../../../../src/protocols/mcp/services/ToolSchemaEnhancements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAwBH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAA4B,EAAE,CAAC;AAEpE;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,QAAgB,EAAE,QAAgB,EAAqC,EAAE;IACzG,OAAO,wBAAwB,CAAC,IAAI,CAChC,WAAW,CAAC,EAAE,CAAC,WAAW,CAAC,QAAQ,KAAK,QAAQ,IAAI,WAAW,CAAC,QAAQ,KAAK,QAAQ,CACxF,CAAC;AACN,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC7B,QAAgB,EAChB,QAAgB,EAChB,cAAmC,EAChB,EAAE;IACrB,MAAM,WAAW,GAAG,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAE5D,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,OAAO,cAAc,CAAC;IAC1B,CAAC;IAED,oCAAoC;IACpC,MAAM,cAAc,GAAG,EAAE,GAAG,cAAc,EAAE,CAAC;IAE7C,2BAA2B;IAC3B,IAAI,WAAW,CAAC,QAAQ,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,cAAc,CAAC,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC;IACnD,CAAC;IAED,2CAA2C;IAC3C,IAAI,WAAW,CAAC,oBAAoB,IAAI,cAAc,CAAC,UAAU,EAAE,CAAC;QAChE,cAAc,CAAC,UAAU,GAAG;YACxB,GAAG,cAAc,CAAC,UAAU;YAC5B,GAAG,WAAW,CAAC,oBAAoB;SACtC,CAAC;IACN,CAAC;IAED,OAAO,cAAc,CAAC;AAC1B,CAAC,CAAC"}