rcrewai 0.1.0

data/examples/hierarchical_crew_example.rb

@@ -0,0 +1,193 @@
+#!/usr/bin/env ruby
+
+require_relative '../lib/rcrewai'
+
+puts "🏗️ Hierarchical Crew Process Example"
+puts "=" * 50
+
+# Configure RCrewAI
+RCrewAI.configure do |config|
+  config.llm_provider = :openai  # Change as needed
+  config.temperature = 0.1
+end
+
+# Create a hierarchical crew
+crew = RCrewAI::Crew.new("product_development_crew", process: :hierarchical, verbose: true)
+
+puts "📋 Creating hierarchical crew with manager and specialists..."
+
+# Create a manager agent
+project_manager = RCrewAI::Agent.new(
+  name: "project_manager",
+  role: "Senior Project Manager", 
+  goal: "Coordinate team efforts and ensure project success",
+  backstory: "You are an experienced project manager with 10+ years leading cross-functional teams. You excel at delegation, coordination, and ensuring deliverables meet requirements.",
+  manager: true,  # This makes the agent a manager
+  allow_delegation: true,
+  tools: [RCrewAI::Tools::FileWriter.new],
+  verbose: true,
+  max_iterations: 6
+)
+
+# Create specialist agents
+market_researcher = RCrewAI::Agent.new(
+  name: "market_researcher",
+  role: "Market Research Specialist",
+  goal: "Conduct thorough market analysis and competitive research",
+  backstory: "You are a market research expert who excels at finding market opportunities, analyzing competitors, and identifying customer needs.",
+  tools: [RCrewAI::Tools::WebSearch.new(max_results: 10)],
+  verbose: true
+)
+
+product_designer = RCrewAI::Agent.new(
+  name: "product_designer", 
+  role: "Senior Product Designer",
+  goal: "Design user-centered products and experiences",
+  backstory: "You are a product designer with expertise in UX/UI design, user research, and product strategy. You create designs that solve real user problems.",
+  tools: [RCrewAI::Tools::FileWriter.new],
+  verbose: true
+)
+
+technical_lead = RCrewAI::Agent.new(
+  name: "technical_lead",
+  role: "Technical Lead",
+  goal: "Define technical architecture and implementation strategy", 
+  backstory: "You are a senior software architect who designs scalable, maintainable systems. You excel at technical planning and risk assessment.",
+  tools: [
+    RCrewAI::Tools::FileWriter.new,
+    RCrewAI::Tools::FileReader.new
+  ],
+  verbose: true
+)
+
+# Add agents to crew
+crew.add_agent(project_manager)  # Manager added first
+crew.add_agent(market_researcher)
+crew.add_agent(product_designer) 
+crew.add_agent(technical_lead)
+
+puts "👥 Crew created with:"
+puts "  📊 Manager: #{project_manager.name}"
+puts "  🔍 Specialists: #{crew.agents.length - 1} agents"
+
+# Set up manager relationships
+project_manager.add_subordinate(market_researcher)
+project_manager.add_subordinate(product_designer)
+project_manager.add_subordinate(technical_lead)
+
+# Create tasks that will be delegated by the manager
+market_research_task = RCrewAI::Task.new(
+  name: "market_analysis",
+  description: "Conduct comprehensive market research for a new AI-powered productivity app. Focus on market size, target demographics, competitors, pricing strategies, and key opportunities.",
+  expected_output: "Detailed market analysis report with actionable insights and recommendations",
+  max_retries: 2
+)
+
+product_design_task = RCrewAI::Task.new(
+  name: "product_design",
+  description: "Design the core user experience and feature set for an AI productivity app based on market research. Include user personas, key features, user journey, and design principles.",
+  expected_output: "Product design document with UX strategy, feature specifications, and user flow diagrams",
+  context: [market_research_task]  # Depends on market research
+)
+
+technical_architecture_task = RCrewAI::Task.new(
+  name: "technical_architecture",
+  description: "Define the technical architecture for an AI productivity app. Include technology stack, system design, scalability considerations, AI integration approach, and implementation roadmap.",
+  expected_output: "Technical architecture document with system design, technology recommendations, and implementation plan",
+  context: [market_research_task, product_design_task]  # Depends on both previous tasks
+)
+
+project_plan_task = RCrewAI::Task.new(
+  name: "project_planning",
+  description: "Create comprehensive project plan integrating market research, product design, and technical architecture. Include timeline, milestones, resource requirements, and risk assessment.",
+  expected_output: "Complete project plan with timelines, deliverables, and coordination strategy saved to project_plan.md",
+  agent: project_manager,  # Manager handles this directly
+  context: [market_research_task, product_design_task, technical_architecture_task]
+)
+
+# Add tasks to crew
+crew.add_task(market_research_task)
+crew.add_task(product_design_task)
+crew.add_task(technical_architecture_task)
+crew.add_task(project_plan_task)
+
+puts "📋 Tasks created with dependencies:"
+crew.tasks.each_with_index do |task, i|
+  deps = task.context&.length || 0
+  puts "  #{i + 1}. #{task.name} (#{deps} dependencies)"
+end
+
+# Execute the hierarchical crew
+puts "\n🚀 Starting hierarchical execution..."
+puts "The project manager will coordinate and delegate tasks to specialists"
+
+begin
+  start_time = Time.now
+  
+  # Execute with hierarchical process
+  results = crew.execute
+  
+  execution_time = Time.now - start_time
+  
+  # Display results
+  puts "\n" + "=" * 60
+  puts "🎉 HIERARCHICAL EXECUTION COMPLETED"
+  puts "=" * 60
+  puts "Total execution time: #{execution_time.round(2)} seconds"
+  puts "Process type: #{results[:process]}"
+  puts "Success rate: #{results[:success_rate]}%"
+  puts "Completed tasks: #{results[:completed_tasks]}/#{results[:total_tasks]}"
+  
+  # Show task results
+  puts "\n📊 Task Results:"
+  results[:results].each do |result|
+    status_icon = result[:status] == :completed ? "✅" : "❌"
+    agent_name = result[:assigned_agent]&.name || result[:task].agent&.name
+    
+    puts "#{status_icon} #{result[:task].name}"
+    puts "    Assigned to: #{agent_name}"
+    puts "    Status: #{result[:status]}"
+    
+    if result[:phase]
+      puts "    Phase: #{result[:phase]}"
+    end
+    
+    if result[:status] == :completed
+      preview = result[:result][0..150]
+      preview += "..." if result[:result].length > 150
+      puts "    Result: #{preview}"
+    else
+      puts "    Error: #{result[:result]}"
+    end
+    
+    puts
+  end
+  
+  # Show delegation insights
+  puts "🎯 Hierarchical Process Insights:"
+  puts "  • Manager coordinated #{crew.agents.length - 1} specialists"
+  puts "  • Tasks were delegated based on agent expertise"
+  puts "  • Dependencies were handled automatically"
+  puts "  • Cross-phase coordination was managed"
+  
+  # Check for output files
+  if File.exist?('project_plan.md')
+    puts "\n📄 Generated Files:"
+    puts "  ✅ project_plan.md (#{File.size('project_plan.md')} bytes)"
+  end
+  
+rescue RCrewAI::ProcessError => e
+  puts "\n❌ Process Error: #{e.message}"
+  puts "This might indicate issues with agent setup or task dependencies"
+  
+rescue RCrewAI::AgentError => e
+  puts "\n❌ Agent Error: #{e.message}"
+  
+rescue => e
+  puts "\n💥 Unexpected error: #{e.message}"
+  puts e.backtrace.first(3).join("\n") if ENV['DEBUG']
+end
+
+puts "\n" + "=" * 50
+puts "🏗️ Hierarchical Crew Example Complete!"
+puts "=" * 50

data/examples/human_in_the_loop_example.rb

@@ -0,0 +1,233 @@
+#!/usr/bin/env ruby
+
+require_relative '../lib/rcrewai'
+
+puts "🤝 Human-in-the-Loop Example"
+puts "=" * 50
+
+# Configure RCrewAI
+RCrewAI.configure do |config|
+  config.llm_provider = :openai  # Change as needed
+  config.temperature = 0.1
+end
+
+puts "🔧 Setting up crew with human interaction capabilities..."
+
+# Create crew
+crew = RCrewAI::Crew.new("human_assisted_crew")
+
+# Create agents with human input capabilities
+research_agent = RCrewAI::Agent.new(
+  name: "research_assistant",
+  role: "Research Specialist", 
+  goal: "Conduct thorough research with human oversight",
+  backstory: "You work closely with humans to ensure research quality and accuracy.",
+  tools: [RCrewAI::Tools::WebSearch.new, RCrewAI::Tools::FileWriter.new],
+  verbose: true,
+  human_input: true,  # Enable human input
+  require_approval_for_tools: true,  # Require approval for tool usage
+  require_approval_for_final_answer: true  # Require approval for final answers
+)
+
+content_creator = RCrewAI::Agent.new(
+  name: "content_creator",
+  role: "Content Writer",
+  goal: "Create engaging content with human guidance",
+  backstory: "You collaborate with humans to create compelling, accurate content.",
+  tools: [RCrewAI::Tools::FileWriter.new, RCrewAI::Tools::FileReader.new],
+  verbose: true,
+  human_input: true,
+  require_approval_for_final_answer: true
+)
+
+quality_checker = RCrewAI::Agent.new(
+  name: "quality_checker", 
+  role: "Quality Assurance Specialist",
+  goal: "Ensure content meets quality standards",
+  backstory: "You work with humans to maintain high quality standards.",
+  tools: [RCrewAI::Tools::FileReader.new],
+  verbose: true,
+  human_input: true
+)
+
+# Add agents to crew
+crew.add_agent(research_agent)
+crew.add_agent(content_creator)
+crew.add_agent(quality_checker)
+
+puts "👥 Created crew with #{crew.agents.length} agents (all human-enabled)"
+
+# Create tasks with various levels of human interaction
+
+# Task 1: Research with human confirmation and guidance
+research_task = RCrewAI::Task.new(
+  name: "research_ai_trends",
+  description: "Research the latest AI trends for 2024, focusing on practical business applications",
+  agent: research_agent,
+  expected_output: "Comprehensive research document saved as ai_trends_2024.md",
+  human_input: true,
+  require_confirmation: true,  # Human must confirm before starting
+  allow_guidance: true,        # Allow human to provide guidance during execution
+  human_review_points: [:completion]  # Review when completed
+)
+
+# Task 2: Content creation with human oversight
+content_task = RCrewAI::Task.new(
+  name: "create_ai_article",
+  description: "Write an engaging article based on the research findings about AI trends",
+  agent: content_creator,
+  expected_output: "Well-structured article saved as ai_trends_article.md",
+  context: [research_task],
+  human_input: true,
+  allow_guidance: true,
+  human_review_points: [:completion]
+)
+
+# Task 3: Quality check with human review
+quality_task = RCrewAI::Task.new(
+  name: "quality_review",
+  description: "Review the article for accuracy, clarity, and engagement",
+  agent: quality_checker,
+  expected_output: "Quality assessment report with recommendations",
+  context: [content_task],
+  human_input: true,
+  human_review_points: [:completion]
+)
+
+crew.add_task(research_task)
+crew.add_task(content_task)
+crew.add_task(quality_task)
+
+puts "📋 Created #{crew.tasks.length} tasks with human interaction points"
+
+# Demonstrate different human interaction modes
+puts "\n🎯 HUMAN-IN-THE-LOOP EXECUTION MODES"
+puts "-" * 40
+
+puts "\n1️⃣ BASIC HUMAN APPROVAL MODE"
+puts "Tasks will request human approval at key decision points..."
+
+begin
+  results = crew.execute
+  
+  puts "\n📊 Execution Results:"
+  puts "  Completed: #{results[:completed_tasks]}/#{results[:total_tasks]}"
+  puts "  Success Rate: #{results[:success_rate]}%"
+  
+  # Show any generated files
+  output_files = ['ai_trends_2024.md', 'ai_trends_article.md']
+  puts "\n📄 Generated Files:"
+  output_files.each do |file|
+    if File.exist?(file)
+      puts "  ✅ #{file} (#{File.size(file)} bytes)"
+    else
+      puts "  ❌ #{file} (not created)"
+    end
+  end
+
+rescue => e
+  puts "❌ Execution failed or was cancelled: #{e.message}"
+end
+
+puts "\n2️⃣ AGENT-LEVEL HUMAN INTERACTION DEMONSTRATION"
+puts "Creating a standalone task to show detailed human interactions..."
+
+# Create a simple demonstration task
+demo_agent = RCrewAI::Agent.new(
+  name: "demo_agent",
+  role: "Demonstration Agent",
+  goal: "Show human interaction capabilities",
+  backstory: "I demonstrate various human interaction patterns.",
+  tools: [RCrewAI::Tools::FileWriter.new],
+  verbose: true
+)
+
+# Enable different types of human interaction
+demo_agent.enable_human_input(
+  require_approval_for_tools: true,
+  require_approval_for_final_answer: true
+)
+
+demo_task = RCrewAI::Task.new(
+  name: "human_interaction_demo",
+  description: "Write a short summary of Ruby programming benefits and save it to ruby_benefits.txt",
+  agent: demo_agent,
+  expected_output: "A text file containing Ruby programming benefits",
+  human_input: true,
+  require_confirmation: true,
+  allow_guidance: true
+)
+
+puts "\n🚀 Starting human interaction demonstration..."
+
+begin
+  demo_result = demo_task.execute
+  puts "\nDemo result: #{demo_result}"
+  
+  if File.exist?('ruby_benefits.txt')
+    puts "\n📄 Generated demo file:"
+    puts File.read('ruby_benefits.txt')[0..200] + "..."
+  end
+
+rescue => e
+  puts "Demo task result: #{e.message}"
+end
+
+puts "\n3️⃣ HUMAN INPUT UTILITY DEMONSTRATION"
+puts "Testing different types of human input requests..."
+
+# Demonstrate the HumanInput utility directly
+human_input = RCrewAI::HumanInput.new(verbose: true)
+
+puts "\nTesting approval request..."
+approval_result = human_input.request_approval(
+  "Test approval request - this is just a demonstration",
+  context: "This is a test of the human input system",
+  consequences: "Nothing will actually happen",
+  timeout: 30
+)
+puts "Approval result: #{approval_result[:approved] ? 'APPROVED' : 'REJECTED'}"
+
+puts "\nTesting choice request..."
+choice_result = human_input.request_choice(
+  "What's your preferred programming language?",
+  ["Ruby", "Python", "JavaScript", "Other"],
+  timeout: 30
+)
+puts "Choice result: #{choice_result[:choice]}" if choice_result[:valid]
+
+puts "\nTesting input request..."
+input_result = human_input.request_input(
+  "Enter a short message (or press Enter to skip):",
+  help_text: "This is just for testing the input system",
+  timeout: 20
+)
+puts "Input result: '#{input_result[:input]}'" if input_result[:valid]
+
+# Show session summary
+puts "\n📈 Human Input Session Summary:"
+summary = human_input.session_summary
+summary.each { |key, value| puts "  #{key}: #{value}" }
+
+puts "\n🎯 HUMAN-IN-THE-LOOP FEATURES DEMONSTRATED:"
+puts "  • Task-level human confirmation before execution"
+puts "  • Agent-level tool approval workflows"
+puts "  • Final answer review and revision capabilities"
+puts "  • Human guidance integration into agent reasoning"
+puts "  • Task completion review and feedback handling"
+puts "  • Error handling with human intervention options"
+puts "  • Flexible human input types (approval, choice, input, review)"
+puts "  • Session tracking and interaction history"
+puts "  • Configurable timeouts and auto-approval modes"
+puts "  • Integration with both sync and async execution"
+
+puts "\n💡 USAGE PATTERNS:"
+puts "  1. Development & Testing: Use human approval for tool usage"
+puts "  2. Content Creation: Human review of final outputs"
+puts "  3. Critical Tasks: Human confirmation before execution"
+puts "  4. Learning & Training: Human guidance during reasoning"
+puts "  5. Quality Assurance: Human review at completion points"
+
+puts "\n" + "=" * 50
+puts "🤝 Human-in-the-Loop Demo Complete!"
+puts "=" * 50