@relayplane/sdk/examples/interactive-demo.js

RelayPlane SDK with zero-config AI access, intelligent model selection, built-in examples, and contextual error handling. The easiest way to add AI to your app with automatic optimization and fallback.

#!/usr/bin/env node

/**
 * RelayPlane SDK - Interactive Demo
 * 
 * Run this script to experience all SDK features in an interactive guided demo.
 * Perfect for new developers to understand capabilities in under 5 minutes.
 * 
 * Usage: node examples/interactive-demo.js
 */

const RelayPlane = require('@relayplane/sdk');
const readline = require('readline');

const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout
});

function ask(question) {
  return new Promise(resolve => rl.question(question, resolve));
}

function sleep(ms) {
  return new Promise(resolve => setTimeout(resolve, ms));
}

async function main() {
  console.log('🪄 Welcome to RelayPlane SDK Interactive Demo!');
  console.log('═══════════════════════════════════════════════\n');
  
  console.log('This demo will show you:');
  console.log('✨ Zero-config AI magic');
  console.log('🧠 Intelligent model selection');
  console.log('📚 Built-in examples library');
  console.log('⚡ Smart retry and error handling');
  console.log('🔧 Advanced configuration options\n');

  // Check environment setup
  console.log('🔍 Checking your environment...');
  const hasOpenAI = !!process.env.OPENAI_API_KEY;
  const hasAnthropic = !!process.env.ANTHROPIC_API_KEY;
  const hasGoogle = !!process.env.GOOGLE_API_KEY;
  const hasRelayPlane = !!process.env.RELAY_API_KEY;
  
  console.log(`   OpenAI API Key: ${hasOpenAI ? '✅' : '❌'}`);
  console.log(`   Anthropic API Key: ${hasAnthropic ? '✅' : '❌'}`);
  console.log(`   Google API Key: ${hasGoogle ? '✅' : '❌'}`);
  console.log(`   RelayPlane API Key: ${hasRelayPlane ? '✅' : '❌'}\n`);

  if (!hasOpenAI && !hasAnthropic && !hasGoogle && !hasRelayPlane) {
    console.log('⚠️  No API keys detected. Some features will be simulated.');
    console.log('💡 To test with real AI models, set one of these environment variables:');
    console.log('   export OPENAI_API_KEY="sk-..."');
    console.log('   export ANTHROPIC_API_KEY="sk-ant-..."');
    console.log('   export GOOGLE_API_KEY="..."');
    console.log('   export RELAY_API_KEY="rp_..."');
    console.log();
  }

  await ask('Press Enter to start the demo...');
  console.clear();

  // Demo 1: Zero-Config Magic
  await demo1ZeroConfig();
  
  // Demo 2: Built-in Examples
  await demo2Examples();
  
  // Demo 3: Error Handling
  await demo3ErrorHandling();
  
  // Demo 4: Advanced Features
  await demo4Advanced();
  
  // Conclusion
  await demoConclusion();
  
  rl.close();
}

async function demo1ZeroConfig() {
  console.log('🪄 Demo 1: Zero-Config Magic');
  console.log('═══════════════════════════════════\n');
  
  console.log('The RelayPlane SDK can automatically:');
  console.log('• Detect your available API keys');
  console.log('• Choose the best model for your task');
  console.log('• Provide reasoning for its decisions');
  console.log('• Handle fallbacks gracefully\n');

  const question = await ask('Enter a question to ask the AI (or press Enter for default): ');
  const prompt = question.trim() || 'Explain quantum computing in simple terms';
  
  console.log(`\n🤖 Asking: "${prompt}"`);
  console.log('⏳ Processing...\n');

  try {
    const startTime = Date.now();
    const result = await RelayPlane.ask(prompt, {
      budget: 'moderate',
      priority: 'balanced',
      taskType: 'general'
    });
    const duration = Date.now() - startTime;

    console.log('✅ Response received!');
    console.log(`🧠 Model Selected: ${result.reasoning.selectedModel}`);
    console.log(`💡 Reasoning: ${result.reasoning.rationale}`);
    console.log(`⚡ Response Time: ${duration}ms`);
    console.log(`📝 Answer: ${result.response.body}\n`);

  } catch (error) {
    console.log('❌ Demo Error:', error.message);
    console.log('💡 This is expected if no API keys are configured.');
    console.log('   The SDK would normally auto-detect and route to available models.\n');
  }

  await ask('Press Enter to continue to built-in examples...');
  console.clear();
}

async function demo2Examples() {
  console.log('📚 Demo 2: Built-in Examples Library');
  console.log('═══════════════════════════════════════\n');
  
  console.log('RelayPlane includes ready-to-use patterns for common tasks:');
  console.log('1. 📝 Summarization');
  console.log('2. 🌍 Translation');
  console.log('3. 🔍 Code Review');
  console.log('4. 🔬 Research');
  console.log('5. 💬 Chatbot\n');

  const choice = await ask('Choose an example (1-5) or press Enter for summarization: ');
  const exampleChoice = choice.trim() || '1';

  console.log('\n⏳ Running example...\n');

  try {
    let result;
    
    switch (exampleChoice) {
      case '1':
        console.log('📝 Summarization Example');
        const longText = 'Artificial intelligence (AI) is intelligence demonstrated by machines, in contrast to the natural intelligence displayed by humans and animals. Leading AI textbooks define the field as the study of "intelligent agents": any device that perceives its environment and takes actions that maximize its chance of successfully achieving its goals. Colloquially, the term "artificial intelligence" is often used to describe machines that mimic "cognitive" functions that humans associate with the human mind, such as "learning" and "problem solving".';
        result = await RelayPlane.examples.summarize(longText, { length: 'brief' });
        console.log('✅ Summary:', result);
        break;
        
      case '2':
        console.log('🌍 Translation Example');
        result = await RelayPlane.examples.translate('Hello, how are you today?', 'Spanish');
        console.log('✅ Translation:', result);
        break;
        
      case '3':
        console.log('🔍 Code Review Example');
        const code = 'function add(a, b) { return a + b; }';
        result = await RelayPlane.examples.codeReview(code, { focus: 'best-practices' });
        console.log('✅ Code Review:', result);
        break;
        
      case '4':
        console.log('🔬 Research Example');
        result = await RelayPlane.examples.research('Benefits of renewable energy');
        console.log('✅ Research:', result);
        break;
        
      case '5':
        console.log('💬 Chatbot Example');
        result = await RelayPlane.examples.chatbot('What can you help me with?', {
          personality: 'helpful and friendly assistant'
        });
        console.log('✅ Chatbot Response:', result);
        break;
        
      default:
        console.log('Invalid choice, showing summarization example...');
        result = await RelayPlane.examples.summarize(longText, { length: 'brief' });
        console.log('✅ Summary:', result);
    }

  } catch (error) {
    console.log('❌ Example Error:', error.message);
    console.log('💡 Examples require API keys to function.');
    console.log('   In production, these would return real AI-generated content.\n');
  }

  await ask('\nPress Enter to continue to error handling demo...');
  console.clear();
}

async function demo3ErrorHandling() {
  console.log('🔧 Demo 3: Smart Error Handling');
  console.log('═══════════════════════════════════════\n');
  
  console.log('RelayPlane provides intelligent error handling:');
  console.log('• Contextual error messages');
  console.log('• Helpful recovery suggestions');
  console.log('• Automatic retry with backoff');
  console.log('• Smart model fallbacks\n');

  console.log('⏳ Simulating various error scenarios...\n');

  // Simulate API key error
  console.log('🔑 Testing API Key Error Handling:');
  try {
    // This will likely fail without proper API keys
    await RelayPlane.relay({
      to: 'nonexistent-model',
      payload: { messages: [{ role: 'user', content: 'test' }] }
    });
  } catch (error) {
    if (error.getHelpfulMessage) {
      console.log('✅ Contextual Error Message:');
      console.log(error.getHelpfulMessage());
    } else {
      console.log('❌ Standard Error:', error.message);
    }
  }

  await sleep(1000);

  // Show smart retry example
  console.log('\n⚡ Smart Retry Example:');
  try {
    const result = await RelayPlane.smartRetry({
      to: 'claude-sonnet-4-20250514',
      payload: { messages: [{ role: 'user', content: 'Hello' }] }
    }, {
      maxRetries: 3,
      retryOnFailureTypes: ['rate_limit', 'timeout', 'model_error']
    });
    
    console.log('✅ Smart retry succeeded!');
    console.log('📊 Retry info:', result.retryInfo);
    
  } catch (error) {
    console.log('❌ Smart retry demo error:', error.message);
    console.log('💡 In production, this would automatically try fallback models.');
  }

  await ask('\nPress Enter to continue to advanced features...');
  console.clear();
}

async function demo4Advanced() {
  console.log('🚀 Demo 4: Advanced Features');
  console.log('═══════════════════════════════════\n');
  
  console.log('Advanced SDK capabilities:');
  console.log('• Multi-agent chaining');
  console.log('• Batch processing');
  console.log('• Streaming optimization');
  console.log('• Cost management\n');

  const feature = await ask('Choose feature to demo (chain/batch/stream/cost) or Enter for chain: ');
  const featureChoice = feature.trim() || 'chain';

  console.log(`\n⏳ Demonstrating ${featureChoice}...\n`);

  try {
    switch (featureChoice.toLowerCase()) {
      case 'chain':
        console.log('🔗 Multi-Agent Chaining Example');
        const chainResult = await RelayPlane.chain({
          steps: [
            { step: 'research', to: 'claude-3-5-haiku-20241022', prompt: 'Research AI trends' },
            { step: 'analyze', to: 'gpt-4o-mini', prompt: 'Analyze findings' },
            { step: 'summarize', to: 'claude-3-5-haiku-20241022', prompt: 'Create summary' }
          ],
          input: 'Current state of AI development',
          optimization: true
        });
        console.log('✅ Chain completed:', chainResult);
        break;
        
      case 'batch':
        console.log('📦 Batch Processing Example');
        const batchResult = await RelayPlane.batch({
          requests: [
            { to: 'claude-3-5-haiku-20241022', payload: { messages: [{ role: 'user', content: 'Hello' }] } },
            { to: 'gpt-4o-mini', payload: { messages: [{ role: 'user', content: 'Hi there' }] } }
          ],
          parallel: true,
          optimization: { enabled: true }
        });
        console.log('✅ Batch completed:', batchResult.length, 'responses');
        break;
        
      case 'stream':
        console.log('🌊 Streaming Optimization Example');
        console.log('✅ Streaming would provide real-time chunks with:');
        console.log('   • Optimized chunk sizes');
        console.log('   • Typing indicators');
        console.log('   • Progress estimation');
        console.log('   • Real-time cost tracking');
        break;
        
      case 'cost':
        console.log('💰 Cost Management Example');
        console.log('✅ Cost features include:');
        console.log('   • Real-time cost tracking');
        console.log('   • Budget limits');
        console.log('   • Cost-optimized model selection');
        console.log('   • Usage analytics');
        break;
        
      default:
        console.log('🔗 Showing chain example by default...');
        console.log('✅ Multi-agent chains allow complex workflows');
    }

  } catch (error) {
    console.log('❌ Advanced feature demo error:', error.message);
    console.log('💡 Advanced features require API keys and may need RelayPlane account.');
  }

  await ask('\nPress Enter for conclusion...');
  console.clear();
}

async function demoConclusion() {
  console.log('🎉 Demo Complete!');
  console.log('═══════════════════════\n');
  
  console.log('You\'ve experienced RelayPlane SDK\'s key features:');
  console.log('✅ Zero-config AI access');
  console.log('✅ Intelligent model selection');
  console.log('✅ Built-in examples library');
  console.log('✅ Smart error handling');
  console.log('✅ Advanced orchestration\n');

  console.log('🚀 Next Steps:');
  console.log('1. Install: npm install @relayplane/sdk');
  console.log('2. Set your API keys (OpenAI, Anthropic, Google, or RelayPlane)');
  console.log('3. Start with: RelayPlane.ask("Your question here")');
  console.log('4. Explore examples: RelayPlane.examples.*');
  console.log('5. Read docs: https://relayplane.com/docs/sdk\n');

  console.log('📚 Example Files to Try:');
  console.log('• examples/gpt-example.js - OpenAI integration');
  console.log('• examples/claude-example.js - Anthropic integration');
  console.log('• examples/optimize-example.js - Advanced optimization');
  console.log('• examples/chained-agents.js - Multi-agent workflows\n');

  console.log('🆘 Get Help:');
  console.log('• Documentation: https://relayplane.com/docs');
  console.log('• GitHub: https://github.com/relayplane/sdk');
  console.log('• Support: support@relayplane.com\n');

  console.log('Thank you for trying RelayPlane SDK! 🪄');
}

// Handle Ctrl+C gracefully
process.on('SIGINT', () => {
  console.log('\n\n👋 Demo interrupted. Thanks for trying RelayPlane SDK!');
  rl.close();
  process.exit(0);
});

// Run the demo
if (require.main === module) {
  main().catch(console.error);
}

module.exports = { main };