refactor: Rename MultiModelAgent to RouterAgent for better clarity

- Renamed MultiModelAgent class to RouterAgent throughout codebase
- Updated multi_model_agent.py -> router_agent.py
- Updated all imports, exports, and references in:
  - src/praisonai-agents/praisonaiagents/agent/__init__.py
  - examples/python/agents/multi-provider-agent.py
  - examples/python/agents/MULTI_PROVIDER_README.md
  - src/praisonai-agents/test_multi_provider.py
- RouterAgent better reflects the primary purpose of intelligent model routing
- Maintains all existing functionality and backward compatibility

Co-authored-by: Mervin Praison <MervinPraison@users.noreply.github.com>

Author: github-actions[bot]

examples/python/agents/MULTI_PROVIDER_README.md

@@ -39,10 +39,10 @@ pip install praisonaiagents
 
 ```python
 from praisonaiagents import Task, PraisonAIAgents
-from praisonaiagents.agent import MultiModelAgent
+from praisonaiagents.agent import RouterAgent
 
 # Create a multi-model agent
-agent = MultiModelAgent(
+agent = RouterAgent(
     name="Smart Assistant",
     role="Adaptive AI Assistant",
     goal="Complete tasks using the most appropriate model",
@@ -84,7 +84,7 @@ router = ModelRouter(
 )
 
 # Create cost-conscious agent
-analyzer = MultiModelAgent(
+analyzer = RouterAgent(
     name="Budget Analyzer",
     role="Data Analyst",
     goal="Analyze data efficiently",
@@ -203,7 +203,7 @@ auto = AutoAgents(
 
 # Convert to multi-model agents
 for i, agent in enumerate(auto.agents):
-    auto.agents[i] = MultiModelAgent(
+    auto.agents[i] = RouterAgent(
         name=agent.name,
         role=agent.role,
         goal=agent.goal,

examples/python/agents/multi-provider-agent.py

@@ -7,16 +7,16 @@
 
 import os
 from praisonaiagents import Agent, Task, PraisonAIAgents
-from praisonaiagents.agent import MultiModelAgent
+from praisonaiagents.agent import RouterAgent
 from praisonaiagents.llm.model_router import ModelRouter, ModelProfile, TaskComplexity
 
 # Example 1: Simple Multi-Model Agent with Auto-Routing
 def example_auto_routing():
     """Example of automatic model routing based on task complexity"""
     print("\n=== Example 1: Auto-Routing Multi-Model Agent ===\n")
 
-    # Create a multi-model agent that automatically selects models
-    research_agent = MultiModelAgent(
+    # Create a router agent that automatically selects models
+    research_agent = RouterAgent(
         name="Smart Researcher",
         role="Adaptive Research Assistant",
         goal="Research topics using the most appropriate AI model",
@@ -75,7 +75,7 @@ def example_cost_optimized_workflow():
     )
 
     # Create specialized agents with different model strategies
-    analyzer = MultiModelAgent(
+    analyzer = RouterAgent(
         name="Cost-Conscious Analyzer",
         role="Data Analyzer",
         goal="Analyze data efficiently while minimizing costs",
@@ -89,7 +89,7 @@ def example_cost_optimized_workflow():
         verbose=True
     )
 
-    writer = MultiModelAgent(
+    writer = RouterAgent(
         name="Quality Writer",
         role="Content Writer", 
         goal="Create high-quality content",
@@ -152,7 +152,7 @@ def example_auto_agents_multi_provider():
     multi_model_agents = []
     for agent in auto_agents.agents:
         # Convert regular agents to multi-model agents
-        multi_agent = MultiModelAgent(
+        multi_agent = RouterAgent(
             name=agent.name,
             role=agent.role,
             goal=agent.goal,
@@ -220,7 +220,7 @@ def search_web(query: str) -> str:
         return f"Search results for: {query}"
 
     # Create specialized agent
-    coder = MultiModelAgent(
+    coder = RouterAgent(
         name="Adaptive Coder",
         role="Software Developer",
         goal="Write and debug code using the best model for each task",

src/praisonai-agents/praisonaiagents/agent/__init__.py

@@ -2,6 +2,6 @@
 from .agent import Agent
 from .image_agent import ImageAgent
 from .handoff import Handoff, handoff, handoff_filters, RECOMMENDED_PROMPT_PREFIX, prompt_with_handoff_instructions
-from .multi_model_agent import MultiModelAgent
+from .router_agent import RouterAgent
 
-__all__ = ['Agent', 'ImageAgent', 'Handoff', 'handoff', 'handoff_filters', 'RECOMMENDED_PROMPT_PREFIX', 'prompt_with_handoff_instructions', 'MultiModelAgent']
+__all__ = ['Agent', 'ImageAgent', 'Handoff', 'handoff', 'handoff_filters', 'RECOMMENDED_PROMPT_PREFIX', 'prompt_with_handoff_instructions', 'RouterAgent']

…aisonaiagents/agent/multi_model_agent.py …ts/praisonaiagents/agent/router_agent.pysrc/praisonai-agents/praisonaiagents/agent/multi_model_agent.py renamed to src/praisonai-agents/praisonaiagents/agent/router_agent.py src/praisonai-agents/praisonaiagents/agent/multi_model_agent.py renamed to src/praisonai-agents/praisonaiagents/agent/router_agent.py

@@ -1,5 +1,5 @@
 """
-Multi-Model Agent that can use different LLM models based on task requirements.
+Router Agent that can use different LLM models based on task requirements.
 
 This module extends the base Agent class to support multiple models and intelligent
 model selection based on task characteristics.
@@ -15,7 +15,7 @@
 logger = logging.getLogger(__name__)
 
 
-class MultiModelAgent(Agent):
+class RouterAgent(Agent):
     """
     An enhanced agent that can dynamically select and use different LLM models
     based on task requirements, optimizing for cost and performance.
@@ -31,7 +31,7 @@ def __init__(
         **kwargs
     ):
         """
-        Initialize a MultiModelAgent.
+        Initialize a RouterAgent.
         
         Args:
             models: List of model names or dict mapping model names to configurations
@@ -284,7 +284,7 @@ def execute(
             context_size=context_size
         )
 
-        logger.info(f"MultiModelAgent '{self.name}' selected model: {selected_model} for task")
+        logger.info(f"RouterAgent '{self.name}' selected model: {selected_model} for task")
 
         # Execute with the selected model
         return self._execute_with_model(

src/praisonai-agents/test_multi_provider.py

@@ -8,7 +8,7 @@
 sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
 
 from praisonaiagents import Agent, Task, PraisonAIAgents
-from praisonaiagents.agent import MultiModelAgent
+from praisonaiagents.agent import RouterAgent
 from praisonaiagents.llm import ModelRouter, TaskComplexity
 
 def test_model_router():
@@ -49,12 +49,12 @@ def test_model_router():
     print("\n✓ ModelRouter tests completed")
 
 
-def test_multi_model_agent():
-    """Test the MultiModelAgent functionality"""
-    print("\n=== Testing MultiModelAgent ===\n")
+def test_router_agent():
+    """Test the RouterAgent functionality"""
+    print("\n=== Testing RouterAgent ===\n")
 
-    # Create a multi-model agent
-    agent = MultiModelAgent(
+    # Create a router agent
+    agent = RouterAgent(
         name="Test Agent",
         role="Test Assistant",
         goal="Test multi-model functionality",
@@ -74,15 +74,15 @@ def test_multi_model_agent():
     )
     print(f"Selected model for simple task: {selected}")
 
-    print("\n✓ MultiModelAgent tests completed")
+    print("\n✓ RouterAgent tests completed")
 
 
 def test_integration():
     """Test integration with PraisonAIAgents"""
     print("\n=== Testing Integration ===\n")
 
-    # Create a simple multi-model agent
-    agent = MultiModelAgent(
+    # Create a simple router agent
+    agent = RouterAgent(
         name="Integration Test Agent",
         role="Tester",
         goal="Test the integration",
@@ -107,7 +107,7 @@ def test_integration():
         verbose=False
     )
 
-    print("Created PraisonAIAgents with MultiModelAgent")
+    print("Created PraisonAIAgents with RouterAgent")
     print("✓ Integration test setup completed")
 
     # Note: Actual execution would require API keys
@@ -119,14 +119,14 @@ def main():
 
     try:
         test_model_router()
-        test_multi_model_agent()
+        test_router_agent()
         test_integration()
 
         print("\n✅ All tests completed successfully!")
         print("\n📝 Summary:")
         print("- ModelRouter can analyze task complexity")
         print("- ModelRouter can select appropriate models")
-        print("- MultiModelAgent can be created and configured")
+        print("- RouterAgent can be created and configured")
         print("- Integration with PraisonAIAgents works")
         print("\n🎉 Multi-provider support is ready to use!")