@mxf-dev/core 1.0.0

package/dist/protocols/mcp/providers/CustomMcpClient.js

@@ -0,0 +1,282 @@
+/**
+ * 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/
+ */
+/**
+ * Custom MCP Client
+ *
+ * This module provides a base implementation for custom Model Context Protocol (MCP) clients.
+ * Developers can extend this class to implement support for other LLM providers while
+ * maintaining compatibility with the MXF.
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { BaseMcpClient } from './BaseMcpClient.js';
+import { McpContentType, McpRole } from '../IMcpClient.js';
+import { Observable } from 'rxjs';
+/**
+ * Custom implementation of the MCP client
+ * Extend this class to add support for additional LLM providers
+ */
+export class CustomMcpClient extends BaseMcpClient {
+    /**
+     * Initialize the custom provider
+     * Override this method to implement custom initialization logic
+     */
+    async initializeProvider() {
+        // Custom initialization code goes here
+        // This method must be implemented by the subclass
+        // If no initialization is needed, simply return
+    }
+    /**
+     * Send a message to the custom provider
+     * Override this method to implement custom message sending logic
+     *
+     * @param messages MCP messages to send
+     * @param tools Optional tools to make available
+     * @param options Additional options
+     * @returns Promise with the provider response
+     */
+    async sendProviderMessage(messages, tools, options) {
+        // This method must be implemented by the subclass
+        throw new Error('sendProviderMessage must be implemented by the subclass');
+    }
+    /**
+     * Helper method to create a simple text-only MCP response
+     * Useful for quick implementation of custom providers
+     *
+     * @param text Text response content
+     * @param modelName Name of the model used
+     * @returns MCP API response
+     */
+    createTextResponse(text, modelName) {
+        return {
+            id: uuidv4(),
+            type: 'completion',
+            role: 'assistant',
+            content: [{
+                    type: McpContentType.TEXT,
+                    text
+                }],
+            model: modelName,
+            stop_reason: 'stop',
+            stop_sequence: null,
+            usage: {
+                input_tokens: 0, // These should be populated by the actual implementation
+                output_tokens: 0,
+                total_tokens: 0
+            }
+        };
+    }
+    /**
+     * Helper method to extract plain text from MCP messages
+     * Useful for providers that don't support rich content
+     *
+     * @param messages MCP messages
+     * @returns Plain text representation of the messages
+     */
+    extractPlainText(messages) {
+        return messages.map(message => {
+            // Convert the role to a format suitable for plain text
+            const rolePrefix = message.role === McpRole.SYSTEM
+                ? 'System: '
+                : message.role === McpRole.USER
+                    ? 'User: '
+                    : 'Assistant: ';
+            // Extract text content
+            let textContent = '';
+            if (Array.isArray(message.content)) {
+                // Handle array of content
+                for (const item of message.content) {
+                    if (item.type === McpContentType.TEXT) {
+                        textContent += item.text + '\n';
+                    }
+                    else if (item.type === McpContentType.IMAGE) {
+                        textContent += '[Image]\n';
+                    }
+                    else if (item.type === McpContentType.TOOL_USE) {
+                        textContent += `[Tool Call: ${item.name} with args ${JSON.stringify(item.input)}]\n`;
+                    }
+                    else if (item.type === McpContentType.TOOL_RESULT) {
+                        const resultContent = Array.isArray(item.content)
+                            ? item.content.map(c => c.type === McpContentType.TEXT ? c.text : '[Image]').join('\n')
+                            : item.content.type === McpContentType.TEXT ? item.content.text : '[Image]';
+                        textContent += `[Tool Result: ${resultContent}]\n`;
+                    }
+                }
+            }
+            else {
+                // Handle single content item
+                if (message.content.type === McpContentType.TEXT) {
+                    textContent = message.content.text;
+                }
+                else if (message.content.type === McpContentType.IMAGE) {
+                    textContent = '[Image]';
+                }
+                else if (message.content.type === McpContentType.TOOL_USE) {
+                    textContent = `[Tool Call: ${message.content.name} with args ${JSON.stringify(message.content.input)}]`;
+                }
+                else if (message.content.type === McpContentType.TOOL_RESULT) {
+                    const resultContent = Array.isArray(message.content.content)
+                        ? message.content.content.map(c => c.type === McpContentType.TEXT ? c.text : '[Image]').join('\n')
+                        : message.content.content.type === McpContentType.TEXT ? message.content.content.text : '[Image]';
+                    textContent = `[Tool Result: ${resultContent}]`;
+                }
+            }
+            return rolePrefix + textContent;
+        }).join('\n\n');
+    }
+    /**
+     * Helper method to extract tool definitions in a plain text format
+     * Useful for providers that don't support structured tool definitions
+     *
+     * @param tools MCP tools
+     * @returns Plain text representation of the tools
+     */
+    extractToolsAsText(tools) {
+        if (!tools || tools.length === 0) {
+            return '';
+        }
+        return 'Available Tools:\n\n' + tools.map(tool => {
+            let toolText = `Tool: ${tool.name}\nDescription: ${tool.description}\nParameters:`;
+            const properties = tool.input_schema.properties || {};
+            for (const [key, value] of Object.entries(properties)) {
+                toolText += `\n  - ${key}: ${value.description || 'No description'} (${value.type || 'any'})`;
+                if (value.enum) {
+                    toolText += ` [Options: ${value.enum.join(', ')}]`;
+                }
+            }
+            if (tool.input_schema.required && tool.input_schema.required.length > 0) {
+                toolText += `\nRequired: ${tool.input_schema.required.join(', ')}`;
+            }
+            return toolText;
+        }).join('\n\n');
+    }
+    /**
+     * Send message using full agent context
+     * Override this method to implement context-based sending for your custom provider.
+     *
+     * The default implementation throws an error - subclasses must implement this method.
+     *
+     * @param context - Complete agent context from SDK
+     * @param options - Additional provider-specific options
+     * @returns Observable with API response
+     */
+    sendWithContext(context, options) {
+        return new Observable(subscriber => {
+            this.sendWithContextImpl(context, options)
+                .then(response => {
+                subscriber.next(response);
+                subscriber.complete();
+            })
+                .catch(error => subscriber.error(error));
+        });
+    }
+    /**
+     * Implementation of context-based sending
+     * Override this method for your custom provider implementation.
+     *
+     * This method should:
+     * 1. Structure messages using structureMessagesFromContext() or custom logic
+     * 2. Send to your custom API
+     * 3. Return MCP-formatted response
+     */
+    async sendWithContextImpl(context, options) {
+        // Default implementation throws an error
+        // Subclasses should override this method
+        throw new Error('sendWithContextImpl must be implemented by the subclass');
+    }
+    /**
+     * Helper method to structure messages from AgentContext
+     *
+     * This provides the standard message ordering:
+     * 1. System message (framework rules + agent identity)
+     * 2. Conversation history (chronological)
+     * 3. Task prompt (if present) - AFTER conversation for proper ordering
+     * 4. Recent actions (if needed)
+     *
+     * Subclasses can use this helper or implement custom structuring.
+     */
+    structureMessagesFromContext(context) {
+        const messages = [];
+        // 1. System message: Combine framework rules + agent identity
+        const systemContent = [
+            context.systemPrompt,
+            '',
+            `## Your Agent Identity`,
+            `**You are**: ${context.agentConfig.purpose || context.agentConfig.agentId}`,
+            `**Your Agent ID**: ${context.agentId}`,
+            ...(context.agentConfig.capabilities ? [`**Capabilities**: ${context.agentConfig.capabilities.join(', ')}`] : [])
+        ].join('\n');
+        messages.push({
+            role: 'system',
+            content: systemContent
+        });
+        // 2. Conversation history: Filter to actual dialogue and tool results
+        const dialogueMessages = context.conversationHistory.filter(msg => {
+            const layer = msg.metadata?.contextLayer;
+            // INCLUDE: SystemLLM messages - they are "held" until the next real prompt
+            // and should be bundled with that prompt to provide coordination insights
+            // (Previously these were skipped, breaking the SystemLLM flow)
+            // INCLUDE: Messages with conversation, tool-result, or task layer
+            // Task messages must be included to prevent re-injection on every turn
+            if (layer === 'conversation' || layer === 'tool-result' || layer === 'task') {
+                return true;
+            }
+            // SKIP: Messages with system/identity/action layers (already in system context)
+            if (layer === 'system' || layer === 'identity' || layer === 'action') {
+                return false;
+            }
+            // INCLUDE: Messages without contextLayer (legacy or direct additions)
+            if (!layer && msg.role !== 'system') {
+                return true;
+            }
+            return false;
+        });
+        // Convert to simple format
+        for (const msg of dialogueMessages) {
+            messages.push({
+                role: msg.role === 'assistant' ? 'assistant' : msg.role === 'system' ? 'system' : 'user',
+                content: msg.content
+            });
+        }
+        // 3. Task message (if present) - Only inject if NOT already in conversation history
+        // Task messages are now included in dialogueMessages, so they appear in their chronological position.
+        // This prevents the task from appearing AFTER tool results, which the LLM interprets as a new request.
+        const taskAlreadyInHistory = dialogueMessages.some(m => m.content?.includes('## Current Task') ||
+            m.metadata?.contextLayer === 'task');
+        if (context.currentTask && !taskAlreadyInHistory) {
+            messages.push({
+                role: 'user',
+                content: `## Current Task\n${context.currentTask.description}`
+            });
+        }
+        // 4. Recent actions (if needed for context)
+        if (context.recentActions.length > 0) {
+            const actionsContent = [
+                `## Your Recent Actions`,
+                ...context.recentActions.map(a => `- ${a.action}${a.result ? `: ${a.result}` : ''}`)
+            ].join('\n');
+            messages.push({
+                role: 'user',
+                content: actionsContent
+            });
+        }
+        return messages;
+    }
+}
+//# sourceMappingURL=CustomMcpClient.js.map

package/dist/protocols/mcp/providers/CustomMcpClient.js.map

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

package/dist/protocols/mcp/providers/GeminiMcpClient.d.ts

@@ -0,0 +1,121 @@
+/**
+ * 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 { BaseMcpClient } from './BaseMcpClient.js';
+import { McpMessage, McpTool, McpApiResponse } from '../IMcpClient.js';
+import { Observable } from 'rxjs';
+import { AgentContext } from '../../../interfaces/AgentContext.js';
+/**
+ * Gemini implementation of the MCP client using the official Google Gen AI SDK
+ */
+export declare class GeminiMcpClient extends BaseMcpClient {
+    private genAiClient;
+    private GoogleGenAI;
+    private Type;
+    private FunctionCallingConfigMode;
+    /**
+     * Initialize the Gemini provider
+     */
+    protected initializeProvider(): Promise<void>;
+    /**
+     * Convert MCP messages to Google Gen AI Content format
+     *
+     * @param messages MCP messages
+     * @returns Google Gen AI Content array
+     */
+    private convertToGeminiContent;
+    /**
+     * Extract text from MCP content (using utility)
+     *
+     * @param content MCP content
+     * @returns Extracted text
+     */
+    private extractTextFromContent;
+    /**
+     * Convert MCP message content to Google Gen AI parts
+     *
+     * @param content MCP content
+     * @returns Array of Google Gen AI parts
+     */
+    private convertMessageContentToParts;
+    /**
+     * Convert a single MCP content item to a Google Gen AI part
+     *
+     * @param item MCP content item
+     * @returns Google Gen AI part or null if not convertible
+     */
+    private convertContentItemToPart;
+    /**
+     * Convert MCP tools to Google Gen AI function declarations
+     *
+     * @param tools MCP tools
+     * @returns Google Gen AI function declarations
+     */
+    private convertToFunctionDeclarations;
+    /**
+     * Convert JSON Schema to Gemini parameter schema
+     *
+     * @param schema JSON Schema object
+     * @returns Gemini parameter schema
+     */
+    private convertJsonSchemaToGeminiSchema;
+    /**
+     * Convert Google Gen AI response to MCP response
+     *
+     * @param response Google Gen AI response
+     * @param modelName Model name used in the request
+     * @returns MCP response
+     */
+    private convertToMcpResponse;
+    /**
+     * Send a message to Gemini
+     *
+     * @param messages MCP messages to send
+     * @param tools Optional tools to make available
+     * @param options Additional options
+     * @returns Promise with the Gemini response
+     */
+    protected sendProviderMessage(messages: McpMessage[], tools?: McpTool[], options?: Record<string, any>): Promise<McpApiResponse>;
+    /**
+     * Send message using full agent context
+     *
+     * This method structures messages for Gemini based on semantic metadata,
+     * ensuring proper chronological ordering of tasks and conversation history.
+     *
+     * @param context - Complete agent context from SDK
+     * @param options - Additional Gemini-specific options
+     * @returns Observable with Gemini response
+     */
+    sendWithContext(context: AgentContext, options?: Record<string, any>): Observable<McpApiResponse>;
+    /**
+     * Implementation of context-based sending for Gemini
+     */
+    private sendWithContextImpl;
+    /**
+     * Structure messages from AgentContext for Gemini
+     *
+     * Gemini uses systemInstruction separately, so we return both.
+     * Message ordering:
+     * 1. Conversation history (chronological)
+     * 2. Task prompt (if present) - AFTER conversation for proper ordering
+     * 3. Recent actions (if needed)
+     */
+    private structureMessagesFromContext;
+}
+//# sourceMappingURL=GeminiMcpClient.d.ts.map

package/dist/protocols/mcp/providers/GeminiMcpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeminiMcpClient.d.ts","sourceRoot":"","sources":["../../../../src/protocols/mcp/providers/GeminiMcpClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAcH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACH,UAAU,EACV,OAAO,EACP,cAAc,EAGjB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAiBnE;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa;IAE9C,OAAO,CAAC,WAAW,CAAa;IAGhC,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,yBAAyB,CAA0C;IAE3E;;OAEG;cACa,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BnD;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAiF9B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAI9B;;;;;OAKG;IACH,OAAO,CAAC,4BAA4B;IAoBpC;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;IA8ChC;;;;;OAKG;IACH,OAAO,CAAC,6BAA6B;IAiBrC;;;;;OAKG;IACH,OAAO,CAAC,+BAA+B;IAoDvC;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAmE5B;;;;;;;OAOG;cACa,mBAAmB,CAC/B,QAAQ,EAAE,UAAU,EAAE,EACtB,KAAK,CAAC,EAAE,OAAO,EAAE,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC9B,OAAO,CAAC,cAAc,CAAC;IAuE1B;;;;;;;;;OASG;IACI,eAAe,CAClB,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC9B,UAAU,CAAC,cAAc,CAAC;IAW7B;;OAEG;YACW,mBAAmB;IAmDjC;;;;;;;;OAQG;IACH,OAAO,CAAC,4BAA4B;CAmFvC"}