@mxf-dev/core 1.0.0

package/dist/middleware/MxpMiddleware.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 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 Protocol Middleware
+ *
+ * Handles protocol detection, translation, and encryption/decryption
+ * for seamless integration with existing MXF message flow.
+ */
+import { MxpMessage } from '../schemas/MxpProtocolSchemas.js';
+import { ChannelMessage, AgentMessage } from '../schemas/MessageSchemas.js';
+/**
+ * MXP Middleware for message transformation
+ */
+export declare class MxpMiddleware {
+    /**
+     * Process outgoing message - detect if it should be converted to MXP
+     */
+    static processOutgoing(message: ChannelMessage | AgentMessage | MxpMessage, senderId: string, options?: {
+        enableMxp?: boolean;
+        forceEncryption?: boolean;
+        preferredFormat?: 'mxp' | 'natural-language';
+    }): Promise<ChannelMessage | AgentMessage | MxpMessage>;
+    /**
+     * Process incoming message - detect format and decrypt if needed
+     */
+    static processIncoming(message: any): Promise<ChannelMessage | AgentMessage | MxpMessage>;
+    /**
+     * Convert natural language message to MXP format
+     */
+    private static convertToMxp;
+    /**
+     * Extract operation arguments from natural language
+     */
+    private static extractOperationArgs;
+    /**
+     * Handle encryption for MXP messages
+     */
+    private static handleMxpEncryption;
+    /**
+     * Convert MXP message back to natural language (for display/logging)
+     */
+    static mxpToNaturalLanguage(message: any): string;
+    /**
+     * Check if a message should be converted to MXP
+     */
+    static shouldConvertToMxp(content: string): boolean;
+    /**
+     * Get MXP statistics for monitoring
+     */
+    private static stats;
+    static getStats(): {
+        uptime: number;
+        totalMessages: number;
+        mxpPercentage: string;
+        encryptionRate: string;
+        messagesConverted: number;
+        messagesEncrypted: number;
+        messagesDecrypted: number;
+        conversionFailures: number;
+        encryptionFailures: number;
+        naturalLanguageMessages: number;
+        mxpMessages: number;
+        startTime: number;
+    };
+    static resetStats(): void;
+}
+//# sourceMappingURL=MxpMiddleware.d.ts.map

package/dist/middleware/MxpMiddleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MxpMiddleware.d.ts","sourceRoot":"","sources":["../../src/middleware/MxpMiddleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;GAKG;AAEH,OAAO,EACH,UAAU,EAQb,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAK5E;;GAEG;AACH,qBAAa,aAAa;IACtB;;OAEG;WACiB,eAAe,CAC/B,OAAO,EAAE,cAAc,GAAG,YAAY,GAAG,UAAU,EACnD,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;QACL,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,eAAe,CAAC,EAAE,KAAK,GAAG,kBAAkB,CAAC;KAC3C,GACP,OAAO,CAAC,cAAc,GAAG,YAAY,GAAG,UAAU,CAAC;IA8BtD;;OAEG;WACiB,eAAe,CAC/B,OAAO,EAAE,GAAG,GACb,OAAO,CAAC,cAAc,GAAG,YAAY,GAAG,UAAU,CAAC;IA+BtD;;OAEG;mBACkB,YAAY;IA+CjC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IA8BnC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA8BlC;;OAEG;WACW,oBAAoB,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM;IAmDxD;;OAEG;WACW,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAS1D;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,KAAK,CASlB;WAEY,QAAQ;;;;;;;;;;;;;;WAaR,UAAU;CAY3B"}

package/dist/middleware/MxpMiddleware.js

@@ -0,0 +1,284 @@
+/**
+ * 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 Protocol Middleware
+ *
+ * Handles protocol detection, translation, and encryption/decryption
+ * for seamless integration with existing MXF message flow.
+ */
+import { isMxpMessage, isEncryptedPayload, createMxpMessage, MxpMessageType, detectOperation, MxpOperation } from '../schemas/MxpProtocolSchemas.js';
+import { mxpEncryption } from '../utils/MxpEncryption.js';
+import { Logger } from '../utils/Logger.js';
+const logger = new Logger('debug', 'MxpMiddleware', 'server');
+/**
+ * MXP Middleware for message transformation
+ */
+export class MxpMiddleware {
+    /**
+     * Process outgoing message - detect if it should be converted to MXP
+     */
+    static async processOutgoing(message, senderId, options = {}) {
+        // If MXP is disabled, return original message
+        if (options.enableMxp === false) {
+            this.stats.naturalLanguageMessages++;
+            return message;
+        }
+        // If already an MXP message, just handle encryption
+        if (isMxpMessage(message)) {
+            this.stats.mxpMessages++;
+            return this.handleMxpEncryption(message, options.forceEncryption);
+        }
+        // Try to convert natural language to MXP if preferred
+        if (options.preferredFormat === 'mxp') {
+            const converted = await this.convertToMxp(message, senderId);
+            if (converted) {
+                this.stats.messagesConverted++;
+                this.stats.mxpMessages++;
+                return this.handleMxpEncryption(converted, options.forceEncryption);
+            }
+            else {
+                this.stats.conversionFailures++;
+            }
+        }
+        // Return original message if no conversion
+        this.stats.naturalLanguageMessages++;
+        return message;
+    }
+    /**
+     * Process incoming message - detect format and decrypt if needed
+     */
+    static async processIncoming(message) {
+        // Check if it's an MXP message
+        if (isMxpMessage(message)) {
+            this.stats.mxpMessages++;
+            const mxpMsg = message;
+            // Decrypt if needed
+            if (mxpMsg.encrypted && isEncryptedPayload(mxpMsg.payload)) {
+                const decrypted = mxpEncryption.decryptMessage(mxpMsg.payload);
+                if (decrypted) {
+                    this.stats.messagesDecrypted++;
+                    return {
+                        ...mxpMsg,
+                        payload: decrypted,
+                        encrypted: false
+                    };
+                }
+                else {
+                    logger.error('Failed to decrypt MXP message');
+                    this.stats.encryptionFailures++;
+                    throw new Error('Decryption failed');
+                }
+            }
+            return mxpMsg;
+        }
+        // Return as-is if not MXP
+        this.stats.naturalLanguageMessages++;
+        return message;
+    }
+    /**
+     * Convert natural language message to MXP format
+     */
+    static async convertToMxp(message, senderId) {
+        try {
+            // Extract content from message
+            const content = message.content?.data;
+            if (typeof content !== 'string') {
+                return null; // Can't convert non-string content
+            }
+            // Try to detect operation from natural language
+            const detection = detectOperation(content);
+            if (!detection || detection.confidence < 0.6) {
+                return null; // Not confident enough to convert
+            }
+            // Extract arguments based on operation type
+            const args = this.extractOperationArgs(content, detection.op);
+            // Create MXP message
+            const mxpMessage = createMxpMessage(MxpMessageType.OPERATION, senderId, {
+                op: detection.op,
+                args,
+                reasoning: content, // Keep original for context
+                metadata: {
+                    priority: 5,
+                    correlationId: message.metadata?.correlationId
+                }
+            }, {
+                receiverId: message.receiverId,
+                channelId: message.context?.channelId
+            });
+            return mxpMessage;
+        }
+        catch (error) {
+            logger.error(`Failed to convert to MXP: ${error}`);
+            return null;
+        }
+    }
+    /**
+     * Extract operation arguments from natural language
+     */
+    static extractOperationArgs(content, operation) {
+        // This is a simplified example - in production, use NLP
+        const args = [];
+        switch (operation) {
+            case MxpOperation.CALC_SUM:
+            case MxpOperation.CALC_AVERAGE:
+                // Extract numbers from text
+                const numbers = content.match(/\d+(\.\d+)?/g);
+                if (numbers) {
+                    args.push(...numbers.map(n => parseFloat(n)));
+                }
+                break;
+            case MxpOperation.DATA_FETCH:
+                // Extract quoted strings as data identifiers
+                const quotes = content.match(/"([^"]+)"|'([^']+)'/g);
+                if (quotes) {
+                    args.push(...quotes.map(q => q.slice(1, -1)));
+                }
+                break;
+            default:
+                // Generic extraction
+                args.push({ raw: content });
+        }
+        return args;
+    }
+    /**
+     * Handle encryption for MXP messages
+     */
+    static handleMxpEncryption(message, forceEncryption) {
+        // Skip if already encrypted
+        if (message.encrypted && isEncryptedPayload(message.payload)) {
+            return message;
+        }
+        // Check if encryption should be applied
+        const shouldEncrypt = forceEncryption ||
+            (mxpEncryption.isEncryptionEnabled() && message.type !== MxpMessageType.REASONING);
+        if (shouldEncrypt && !isEncryptedPayload(message.payload)) {
+            const encrypted = mxpEncryption.encrypt(message.payload);
+            if (encrypted) {
+                this.stats.messagesEncrypted++;
+                return {
+                    ...message,
+                    encrypted: true,
+                    payload: encrypted
+                };
+            }
+            else {
+                this.stats.encryptionFailures++;
+            }
+        }
+        return message;
+    }
+    /**
+     * Convert MXP message back to natural language (for display/logging)
+     */
+    static mxpToNaturalLanguage(message) {
+        if (!isMxpMessage(message)) {
+            return String(message);
+        }
+        // Handle new format (with operation and values at root level)
+        // Cast to any to check for these properties since they're not in the strict type
+        const messageAsAny = message;
+        if (messageAsAny.operation && messageAsAny.values) {
+            switch (messageAsAny.operation) {
+                case 'calc.sum':
+                case MxpOperation.CALC_SUM:
+                    return `Calculate the sum of ${messageAsAny.values.join(', ')}`;
+                case 'calc.average':
+                case MxpOperation.CALC_AVERAGE:
+                    return `Calculate the average of ${messageAsAny.values.join(', ')}`;
+                default:
+                    return `MXP operation: ${messageAsAny.operation} with values: ${JSON.stringify(messageAsAny.values)}`;
+            }
+        }
+        // Handle standard format (with payload)
+        const typedMessage = message;
+        const payload = typedMessage.payload;
+        if (payload) {
+            // If there's reasoning, use it
+            if (payload.reasoning) {
+                return payload.reasoning;
+            }
+            // Otherwise, generate human-readable description
+            switch (payload.op) {
+                case MxpOperation.CALC_SUM:
+                    return `Calculate the sum of ${payload.args?.join(', ')}`;
+                case MxpOperation.CALC_AVERAGE:
+                    return `Calculate the average of ${payload.args?.join(', ')}`;
+                case MxpOperation.DATA_FETCH:
+                    return `Fetch data: ${payload.args?.join(', ')}`;
+                case MxpOperation.TOOL_EXECUTE:
+                    const toolInfo = payload.args?.[0];
+                    return `Execute tool ${toolInfo?.tool} with args: ${JSON.stringify(toolInfo?.input)}`;
+                case MxpOperation.COORD_SYNC:
+                    return `Synchronize coordination status: ${JSON.stringify(payload.args?.[0])}`;
+                default:
+                    return `MXP Operation: ${payload.op} with args: ${JSON.stringify(payload.args)}`;
+            }
+        }
+        return `MXP message: ${JSON.stringify(message)}`;
+    }
+    /**
+     * Check if a message should be converted to MXP
+     */
+    static shouldConvertToMxp(content) {
+        // Don't convert complex reasoning or explanations
+        if (content.length > 500)
+            return false;
+        // Check for operation patterns
+        const detection = detectOperation(content);
+        return detection !== null && detection.confidence >= 0.7;
+    }
+    /**
+     * Get MXP statistics for monitoring
+     */
+    static stats = {
+        messagesConverted: 0,
+        messagesEncrypted: 0,
+        messagesDecrypted: 0,
+        conversionFailures: 0,
+        encryptionFailures: 0,
+        naturalLanguageMessages: 0,
+        mxpMessages: 0,
+        startTime: Date.now()
+    };
+    static getStats() {
+        const uptime = Date.now() - this.stats.startTime;
+        const totalMessages = this.stats.naturalLanguageMessages + this.stats.mxpMessages;
+        return {
+            ...this.stats,
+            uptime,
+            totalMessages,
+            mxpPercentage: totalMessages > 0 ? (this.stats.mxpMessages / totalMessages * 100).toFixed(2) + '%' : '0%',
+            encryptionRate: this.stats.mxpMessages > 0 ? (this.stats.messagesEncrypted / this.stats.mxpMessages * 100).toFixed(2) + '%' : '0%'
+        };
+    }
+    static resetStats() {
+        this.stats = {
+            messagesConverted: 0,
+            messagesEncrypted: 0,
+            messagesDecrypted: 0,
+            conversionFailures: 0,
+            encryptionFailures: 0,
+            naturalLanguageMessages: 0,
+            mxpMessages: 0,
+            startTime: Date.now()
+        };
+    }
+}
+//# sourceMappingURL=MxpMiddleware.js.map

package/dist/middleware/MxpMiddleware.js.map

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

package/dist/models/PatternLearningModels.d.ts

@@ -0,0 +1,163 @@
+/**
+ * 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/
+ */
+import mongoose, { Document } from 'mongoose';
+import { AgentId } from '../types/Agent.js';
+import { ChannelId } from '../types/ChannelContext.js';
+/**
+ * Pattern learning configuration constants
+ */
+export declare const PATTERN_LEARNING_CONFIG: {
+    readonly MAX_PATTERNS_PER_TOOL: 1000;
+    readonly MIN_FREQUENCY_THRESHOLD: 2;
+    readonly CONFIDENCE_WEIGHTS: {
+        readonly frequency: 0.4;
+        readonly recentUsage: 0.3;
+        readonly successRate: 0.3;
+    };
+    readonly PATTERN_DECAY_DAYS: 30;
+};
+/**
+ * Parameter pattern document interface
+ */
+export interface IParameterPattern extends Document {
+    toolName: string;
+    patternHash: string;
+    channelId: ChannelId;
+    isShared: boolean;
+    parameters: Record<string, any>;
+    patternType: 'successful' | 'failed';
+    errorType?: string;
+    errorMessage?: string;
+    frequency: number;
+    successCount: number;
+    failureCount: number;
+    confidenceScore: number;
+    discoveredBy: AgentId;
+    usedByAgents: Array<{
+        agentId: AgentId;
+        usageCount: number;
+        lastUsed: Date;
+    }>;
+    firstSeen: Date;
+    lastUsed: Date;
+    lastUpdated: Date;
+    metadata: {
+        validationInsights: {
+            commonMistakes: string[];
+            suggestedFixes: string[];
+            relatedPatterns: string[];
+        };
+        performance: {
+            averageExecutionTime?: number;
+            executionTimeVariance?: number;
+        };
+        context: {
+            systemState?: Record<string, any>;
+            environmentInfo?: Record<string, any>;
+        };
+    };
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Pattern evolution document interface
+ */
+export interface IPatternEvolution extends Document {
+    basePatternId: mongoose.Types.ObjectId;
+    toolName: string;
+    channelId: ChannelId;
+    evolutionType: 'improvement' | 'adaptation' | 'correction' | 'optimization';
+    changes: Array<{
+        timestamp: Date;
+        agentId: AgentId;
+        changeType: 'parameter_added' | 'parameter_removed' | 'parameter_modified' | 'metadata_updated';
+        oldValue: any;
+        newValue: any;
+        reason: string;
+        impact: {
+            successRateChange: number;
+            confidenceChange: number;
+            usageChange: number;
+        };
+    }>;
+    improvementScore: number;
+    version: number;
+    evolutionStarted: Date;
+    lastEvolved: Date;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Pattern sharing analytics document interface
+ */
+export interface IPatternSharingAnalytics extends Document {
+    channelId: ChannelId;
+    patternId: mongoose.Types.ObjectId;
+    toolName: string;
+    shareEvents: Array<{
+        timestamp: Date;
+        fromAgent: AgentId;
+        toAgent: AgentId;
+        shareType: 'automatic' | 'recommended' | 'manual';
+        adoptionSuccess: boolean;
+        adoptionTime: number;
+        feedbackScore: number;
+    }>;
+    totalShares: number;
+    successfulAdoptions: number;
+    adoptionRate: number;
+    impact: {
+        errorReductionPercent: number;
+        timesSaved: number;
+        agentsHelped: number;
+    };
+    channelMetrics: {
+        totalPatterns: number;
+        sharedPatterns: number;
+        patternDiversity: number;
+        collaborationIndex: number;
+    };
+    createdAt: Date;
+    updatedAt: Date;
+}
+export declare const ParameterPattern: mongoose.Model<IParameterPattern, {}, {}, {}, mongoose.Document<unknown, {}, IParameterPattern> & IParameterPattern & Required<{
+    _id: unknown;
+}> & {
+    __v: number;
+}, any>;
+export declare const PatternEvolution: mongoose.Model<IPatternEvolution, {}, {}, {}, mongoose.Document<unknown, {}, IPatternEvolution> & IPatternEvolution & Required<{
+    _id: unknown;
+}> & {
+    __v: number;
+}, any>;
+export declare const PatternSharingAnalytics: mongoose.Model<IPatternSharingAnalytics, {}, {}, {}, mongoose.Document<unknown, {}, IPatternSharingAnalytics> & IPatternSharingAnalytics & Required<{
+    _id: unknown;
+}> & {
+    __v: number;
+}, any>;
+/**
+ * Generate a hash for parameter patterns to enable fast duplicate detection
+ */
+export declare function generatePatternHash(toolName: string, parameters: Record<string, any>): string;
+/**
+ * Calculate confidence score based on usage patterns
+ */
+export declare function calculateConfidenceScore(frequency: number, successCount: number, failureCount: number, daysSinceLastUsed: number): number;
+//# sourceMappingURL=PatternLearningModels.d.ts.map

package/dist/models/PatternLearningModels.d.ts.map

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