universal-llm-client 4.1.0 → 4.3.0

package/src/demos/mcp/mcp-mongodb-demo.ts

@@ -1,275 +0,0 @@
-/**
- * MCP MongoDB Integration Demo
- *
- * This demo showcases how to integrate MongoDB operations through MCP
- * (Model Context Protocol) with the Universal LLM Client.
- */
-
-import { AIModelFactory } from '../../factory';
-import { MCPIntegration, createModelWithMCP } from '../../mcp-integration';
-import type { LLMChatMessage } from '../../interfaces';
-import { join } from 'node:path';
-import {readFile} from 'fs/promises';
-
-/**
- * Demo 1: Basic MCP Connection and Tool Discovery
- */
-async function basicMCPDemo() {
-    console.log('\n🎯 Demo 1: Basic MCP Connection and Tool Discovery');
-    console.log('=' .repeat(60));
-
-    try {
-        // Create MCP integration instance
-        const mcpIntegration = new MCPIntegration();
-
-        // Create a model
-        const model = AIModelFactory.createOllamaChatModel('qwen3:8b');
-
-        // Connect to MCP servers and register tools
-        await mcpIntegration.connectAndRegisterTools(model);
-
-        console.log('✅ MCP integration successful!');
-        console.log('📋 MongoDB tools are now available to the AI model');
-
-        // Clean up
-        await mcpIntegration.disconnect();
-
-    } catch (error) {
-        console.error('❌ Basic MCP demo failed:', error);
-    }
-}
-
-/**
- * Demo 2: MongoDB Database Operations through MCP
- */
-async function mongoDBOperationsDemo() {
-    console.log('\n🎯 Demo 2: MongoDB Database Operations through MCP');
-    console.log('=' .repeat(60));
-
-    try {
-        // Create model with MCP tools using convenience function
-        const { model, mcpIntegration } = await createModelWithMCP(() => {
-            return AIModelFactory.createOllamaChatModel('qwen3:8b');
-        });
-
-        // Test basic database queries
-        console.log('\n🔍 Asking AI to explore the database...');
-
-        const messages: LLMChatMessage[] = [{
-            role: 'user',
-            content: `Please help me explore the MongoDB database. First, list all available databases,
-                     then for the main database, show me the available collections.
-                     Finally, give me a count of documents in the users collection if it exists.`
-        }];
-
-        const response = await model.chatWithTools(messages);
-
-        console.log('\n🤖 AI Response:');
-        console.log(response.content);
-
-        if (response.tool_calls && response.tool_calls.length > 0) {
-            console.log('\n🛠️  Tools Used:');
-            response.tool_calls.forEach((call, index) => {
-                console.log(`  ${index + 1}. ${call.function.name}`);
-                console.log(`     Arguments: ${call.function.arguments}`);
-            });
-        }
-
-        // Clean up
-        await mcpIntegration.disconnect();
-
-    } catch (error) {
-        console.error('❌ MongoDB operations demo failed:', error);
-    }
-}
-
-/**
- * Demo 3: Complex MongoDB Query with AI Analysis
- */
-async function complexMongoQueryDemo() {
-    console.log('\n🎯 Demo 3: Complex MongoDB Query with AI Analysis');
-    console.log('=' .repeat(60));
-
-    try {
-        const { model, mcpIntegration } = await createModelWithMCP(() => {
-            return AIModelFactory.createOllamaChatModel('qwen3:8b');
-        });
-
-        console.log('\n🧠 Asking AI to perform complex database analysis...');
-
-        const messages: LLMChatMessage[] = [{
-            role: 'user',
-            content: `I need to analyze user activity in our system. Can you:
-                     1. First check what collections are available in the main database
-                     2. Count the total number of users
-                     3. If there's a conversations collection, aggregate the data to show user activity patterns
-                     4. Provide insights about the data you found`
-        }];
-
-        const response = await model.chatWithTools(messages);
-
-        console.log('\n🤖 AI Analysis:');
-        console.log(response.content);
-
-        if (response.tool_calls && response.tool_calls.length > 0) {
-            console.log('\n📊 Database Operations Performed:');
-            response.tool_calls.forEach((call, index) => {
-                console.log(`\n  Operation ${index + 1}: ${call.function.name}`);
-                console.log(`  Purpose: ${call.function.name.includes('list') ? 'Discovery' :
-                           call.function.name.includes('count') ? 'Counting' :
-                           call.function.name.includes('aggregate') ? 'Analysis' : 'Query'}`);
-                console.log(`  Arguments: ${call.function.arguments}`);
-            });
-        }
-
-        await mcpIntegration.disconnect();
-
-    } catch (error) {
-        console.error('❌ Complex MongoDB query demo failed:', error);
-    }
-}
-
-/**
- * Demo 4: Data Insertion and Validation
- */
-async function dataInsertionDemo() {
-    console.log('\n🎯 Demo 4: Data Insertion and Validation');
-    console.log('=' .repeat(60));
-
-    try {
-        const { model, mcpIntegration } = await createModelWithMCP(() => {
-            return AIModelFactory.createOllamaChatModel('qwen3:8b');
-        });
-
-        console.log('\n💾 Asking AI to insert test data...');
-
-        const messages: LLMChatMessage[] = [{
-            role: 'user',
-            content: `Please help me add some test user data to the database.
-                     First check if there's a 'test_users' collection, and if not, create it.
-                     Then insert 3 sample user records with fields like name, email, age, and created_date.
-                     After insertion, verify the data was added correctly by counting the documents.`
-        }];
-
-        const response = await model.chatWithTools(messages);
-
-        console.log('\n🤖 AI Response:');
-        console.log(response.content);
-
-        if (response.tool_calls && response.tool_calls.length > 0) {
-            console.log('\n📝 Database Modifications:');
-            response.tool_calls.forEach((call, index) => {
-                console.log(`\n  Step ${index + 1}: ${call.function.name}`);
-
-                if (call.function.name.includes('insert')) {
-                    try {
-                        const args = JSON.parse(call.function.arguments);
-                        console.log(`  📄 Documents to insert: ${args.documents?.length || 0}`);
-                        if (args.documents) {
-                            args.documents.forEach((doc: any, i: number) => {
-                                console.log(`    ${i + 1}. ${doc.name || 'Unknown'} (${doc.email || 'No email'})`);
-                            });
-                        }
-                    } catch (e) {
-                        console.log(`  📄 Arguments: ${call.function.arguments}`);
-                    }
-                }
-            });
-        }
-
-        await mcpIntegration.disconnect();
-
-    } catch (error) {
-        console.error('❌ Data insertion demo failed:', error);
-    }
-}
-
-/**
- * Demo 5: Error Handling and Fallbacks
- */
-async function errorHandlingDemo() {
-    console.log('\n🎯 Demo 5: Error Handling and Fallbacks');
-    console.log('=' .repeat(60));
-
-    try {
-        const { model, mcpIntegration } = await createModelWithMCP(() => {
-            return AIModelFactory.createOllamaChatModel('qwen3:8b');
-        });
-
-        console.log('\n🚨 Testing AI error handling with invalid queries...');
-
-        const messages: LLMChatMessage[] = [{
-            role: 'user',
-            content: `Try to query a collection called 'nonexistent_collection' in a database called 'fake_db'.
-                     When this fails, please explain what went wrong and suggest alternative approaches
-                     to explore the actual available databases and collections.`
-        }];
-
-        const response = await model.chatWithTools(messages);
-
-        console.log('\n🤖 AI Error Handling:');
-        console.log(response.content);
-
-        if (response.tool_calls && response.tool_calls.length > 0) {
-            console.log('\n🔍 Error Recovery Process:');
-            response.tool_calls.forEach((call, index) => {
-                console.log(`\n  Attempt ${index + 1}: ${call.function.name}`);
-                console.log(`     Arguments: ${call.function.arguments}`);
-            });
-        }
-
-        await mcpIntegration.disconnect();
-
-    } catch (error) {
-        console.error('❌ Error handling demo failed:', error);
-    }
-}
-
-/**
- * Run all MCP MongoDB demos
- */
-async function runAllMCPDemos() {
-    console.log('🚀 Starting MCP MongoDB Integration Demos');
-    console.log('==========================================');
-
-    // Check if MCP config exists
-
-    try {
-        const mcpConfigPath = join(process.cwd(), '.vscode', 'mcp.json');
-        await readFile(mcpConfigPath, 'utf-8');
-        console.log('✅ MCP configuration found');
-    } catch {
-        console.log('⚠️  MCP configuration not found - demos will use mock data');
-        console.log('   To use real MongoDB MCP server, ensure .vscode/mcp.json is configured');
-    }
-
-    // Run all demos
-    await basicMCPDemo();
-    await mongoDBOperationsDemo();
-    await complexMongoQueryDemo();
-    await dataInsertionDemo();
-    await errorHandlingDemo();
-
-    console.log('\n🎉 All MCP MongoDB demos completed!');
-    console.log('\n📋 Summary:');
-    console.log('• MCP integration allows seamless database operations through AI');
-    console.log('• Tools are automatically discovered and registered');
-    console.log('• AI can perform complex multi-step database workflows');
-    console.log('• Error handling and recovery is built-in');
-    console.log('• Perfect for building AI-powered database assistants');
-}
-
-// Export the demos
-export {
-    basicMCPDemo,
-    mongoDBOperationsDemo,
-    complexMongoQueryDemo,
-    dataInsertionDemo,
-    errorHandlingDemo,
-    runAllMCPDemos
-};
-
-// Run demos if this file is executed directly
-if (require.main === module) {
-    runAllMCPDemos().catch(console.error);
-}

package/src/demos/mcp/simple-astrid-memory.ts

@@ -1,148 +0,0 @@
-/**
- * Simple Astrid Memory Demo - Shows autonomous memory usage in romantic conversation
- */
-
-import { AIModelFactory } from '../../factory';
-import { ToolBuilder } from '../../tools';
-
-// Simple memory storage
-const userMemories = new Map<string, Array<{ content: string; category: string; timestamp: Date }>>();
-
-// Create memory tools for Astrid
-const memoryTools = [
-    ToolBuilder.createTool<{ content: string; category: string }>(
-        'remember_about_user',
-        'Store important information about the user for future conversations',
-        {
-            properties: {
-                content: { type: 'string', description: 'What to remember about the user' },
-                category: { 
-                    type: 'string', 
-                    description: 'Type of information',
-                    enum: ['personal', 'preferences', 'experiences', 'emotions', 'goals']
-                }
-            },
-            required: ['content', 'category']
-        },
-        (args) => {
-            const userId = 'alex';
-            if (!userMemories.has(userId)) {
-                userMemories.set(userId, []);
-            }
-            userMemories.get(userId)!.push({
-                content: args.content,
-                category: args.category,
-                timestamp: new Date()
-            });
-            return { success: true, stored: args.content };
-        }
-    ),
-
-    ToolBuilder.createTool<{ query: string }>(
-        'recall_about_user',
-        'Recall information about the user to personalize the conversation',
-        {
-            properties: {
-                query: { type: 'string', description: 'What to recall about the user' }
-            },
-            required: ['query']
-        },
-        (args) => {
-            const userId = 'alex';
-            const memories = userMemories.get(userId) || [];
-            const relevant = memories.filter(m => 
-                m.content.toLowerCase().includes(args.query.toLowerCase())
-            );
-            return { memories: relevant.map(m => m.content) };
-        }
-    )
-];
-
-// Astrid's system prompt with memory instructions
-const astridPrompt = `You are Astrid, a confident Swedish model and influencer having a romantic conversation.
-
-IMPORTANT: You have memory tools available:
-- Use "remember_about_user" when you learn something meaningful about the user
-- Use "recall_about_user" when you want to reference something personal about them
-- Do this naturally - don't mention you're using memory tools
-
-Keep responses short (1-2 sentences), be flirtatious and warm, and use the person's name occasionally.
-Show genuine interest in their life and experiences.`;
-
-async function simpleAstridMemoryDemo() {
-    console.log('💕 Simple Astrid Memory Demo\n');
-    
-    const astrid = AIModelFactory.createOllamaChatModel('qwen2.5:3b-instruct');
-    await astrid.ensureReady();
-    
-    const scenarios = [
-        "Hi Astrid! I'm Alex. I just moved to Stockholm for my new job as a software engineer.",
-        "Hey! Work was stressful today. I'm still getting used to the new city.",
-        "I've been exploring Stockholm with my camera. I love photography in my free time.",
-        "I'm feeling a bit lonely here. It's hard making friends in a new place."
-    ];
-    
-    for (let i = 0; i < scenarios.length; i++) {
-        console.log(`\n${'='.repeat(50)}`);
-        console.log(`📱 Conversation ${i + 1}`);
-        console.log(`${'='.repeat(50)}\n`);
-        
-        console.log(`👤 Alex: ${scenarios[i]}\n`);
-        
-        try {
-            const messages = [
-                { role: 'system' as const, content: astridPrompt },
-                { role: 'user' as const, content: scenarios[i] }
-            ];
-            
-            const response = await astrid.chat(messages, {
-                tools: memoryTools,
-                tool_choice: 'auto'
-            });
-            
-            // Show tool usage
-            if (response.tool_calls && response.tool_calls.length > 0) {
-                console.log('🧠 Memory activity:');
-                for (const call of response.tool_calls) {
-                    const args = JSON.parse(call.function.arguments);
-                    if (call.function.name === 'remember_about_user') {
-                        console.log(`   📝 Remembered: ${args.content} (${args.category})`);
-                    } else if (call.function.name === 'recall_about_user') {
-                        console.log(`   🔍 Recalled: ${args.query}`);
-                    }
-                }
-                console.log();
-            }
-            
-            console.log(`💕 Astrid: ${response.content}\n`);
-            
-        } catch (error) {
-            console.error('Error:', error);
-        }
-        
-        await new Promise(resolve => setTimeout(resolve, 1000));
-    }
-    
-    // Show accumulated memories
-    console.log(`\n${'='.repeat(50)}`);
-    console.log('🧠 Astrid\'s Memories About Alex');
-    console.log(`${'='.repeat(50)}\n`);
-    
-    const memories = userMemories.get('alex') || [];
-    if (memories.length > 0) {
-        memories.forEach((memory, i) => {
-            console.log(`${i + 1}. [${memory.category}] ${memory.content}`);
-        });
-    } else {
-        console.log('No memories stored.');
-    }
-    
-    console.log('\n✨ Demo complete! This shows how Astrid can naturally store and recall');
-    console.log('   user information to build deeper romantic connections over time.');
-}
-
-if (require.main === module) {
-    simpleAstridMemoryDemo().catch(console.error);
-}
-
-export { simpleAstridMemoryDemo };

package/src/demos/mcp/simple-mcp-demo.ts

@@ -1,68 +0,0 @@
-/**
- * MCP MongoDB Demo - Working Demo
- */
-
-import { AIModelFactory } from './factory';
-import { createModelWithMCP } from './mcp-integration';
-import type { LLMChatMessage } from './interfaces';
-
-async function runMCPMongoDemo() {
-    console.log('🚀 Starting MCP MongoDB Demo');
-    console.log('============================');
-    
-    let mcpIntegration;
-    
-    try {
-        // Create model with MCP tools
-        console.log('🔌 Creating model with MCP integration...');
-        const result = await createModelWithMCP(() => {
-            return AIModelFactory.createOllamaChatModel('qwen3:8b');
-        });
-        
-        const model = result.model;
-        mcpIntegration = result.mcpIntegration;
-        
-        console.log('✅ MCP integration successful!');
-        
-        // Test simple database query
-        console.log('\n🔍 Asking AI to explore the database...');
-        
-        const messages: LLMChatMessage[] = [{
-            role: 'user',
-            content: 'Please list all available databases in our MongoDB instance and tell me what you find.'
-        }];
-        
-        const response = await model.chatWithTools(messages);
-        
-        console.log('\n🤖 AI Response:');
-        console.log(response.content);
-        
-        if (response.tool_calls && response.tool_calls.length > 0) {
-            console.log('\n🛠️  Tools Used:');
-            response.tool_calls.forEach((call, index) => {
-                console.log(`  ${index + 1}. ${call.function.name}`);
-                try {
-                    const args = JSON.parse(call.function.arguments);
-                    console.log(`     Arguments: ${JSON.stringify(args, null, 2)}`);
-                } catch {
-                    console.log(`     Arguments: ${call.function.arguments}`);
-                }
-            });
-        }
-        
-    } catch (error) {
-        console.error('❌ Demo failed:', error);
-    } finally {
-        // Always clean up the MCP connection
-        if (mcpIntegration) {
-            console.log('\n🔌 Disconnecting from MCP servers...');
-            await mcpIntegration.disconnect();
-            console.log('✅ MCP servers disconnected');
-        }
-    }
-    
-    console.log('\n🎉 Demo completed!');
-}
-
-// Run the demo
-runMCPMongoDemo().catch(console.error);

package/src/demos/mcp/working-mcp-demo.ts

@@ -1,62 +0,0 @@
-/**
- * Working MCP MongoDB Demo
- */
-
-import { AIModelFactory } from './factory';
-import { createModelWithMCP } from './mcp-integration';
-import type { LLMChatMessage } from './interfaces';
-
-async function workingMCPDemo() {
-    console.log('🚀 Working MCP MongoDB Demo');
-    console.log('===========================');
-    
-    let mcpIntegration;
-    
-    try {
-        // Create model with MCP tools
-        console.log('🔌 Setting up AI model with MongoDB tools...');
-        const result = await createModelWithMCP(() => {
-            return AIModelFactory.createOllamaChatModel('qwen3:8b');
-        });
-        
-        const model = result.model;
-        mcpIntegration = result.mcpIntegration;
-        
-        console.log('✅ AI model ready with MongoDB capabilities!');
-        
-        // Simple database exploration
-        console.log('\n🔍 Asking AI to explore the database...');
-        
-        const messages: LLMChatMessage[] = [{
-            role: 'user',
-            content: 'Please list all databases in our MongoDB instance and tell me what you find.'
-        }];
-        
-        const response = await model.chatWithTools(messages);
-        
-        console.log('\n🤖 AI Response:');
-        console.log(response.content);
-        
-        if (response.tool_calls && response.tool_calls.length > 0) {
-            console.log('\n🛠️  MongoDB Tools Used:');
-            response.tool_calls.forEach((call, index) => {
-                console.log(`  ${index + 1}. ${call.function.name}`);
-            });
-        }
-        
-    } catch (error) {
-        console.error('❌ Demo failed:', error);
-    } finally {
-        // Clean up
-        if (mcpIntegration) {
-            console.log('\n🔌 Cleaning up...');
-            await mcpIntegration.disconnect();
-            console.log('✅ Disconnected from MongoDB MCP server');
-        }
-    }
-    
-    console.log('\n🎉 Demo completed successfully!');
-}
-
-// Run the demo
-workingMCPDemo().catch(console.error);