PraisonAI 4.6.70__tar.gz → 4.6.71__tar.gz

{praisonai-4.6.70 → praisonai-4.6.71}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.6.70
+Version: 4.6.71
 Summary: PraisonAI is an AI Agents Framework with Self Reflection. PraisonAI application combines PraisonAI Agents, AutoGen, and CrewAI into a low-code solution for building and managing multi-agent LLM systems, focusing on simplicity, customisation, and efficient human-agent collaboration.
 Author: Mervin Praison
 License: MIT
@@ -11,13 +11,14 @@ Description-Content-Type: text/markdown
 Requires-Dist: rich>=13.7
 Requires-Dist: markdown>=3.5
 Requires-Dist: pyparsing>=3.0.0
-Requires-Dist: praisonaiagents>=1.6.70
+Requires-Dist: praisonaiagents>=1.6.71
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm<2,>=1.83.14
 Requires-Dist: PyYAML>=6.0
 Requires-Dist: mcp>=1.20.0
 Requires-Dist: typer>=0.9.0
 Requires-Dist: textual>=0.47.0
+Requires-Dist: pydantic>=2.0.0
 Provides-Extra: ui
 Requires-Dist: aiui<0.4,>=0.3.121; extra == "ui"
 Provides-Extra: gradio

{praisonai-4.6.70 → praisonai-4.6.71}/PraisonAI.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.6.70
+Version: 4.6.71
 Summary: PraisonAI is an AI Agents Framework with Self Reflection. PraisonAI application combines PraisonAI Agents, AutoGen, and CrewAI into a low-code solution for building and managing multi-agent LLM systems, focusing on simplicity, customisation, and efficient human-agent collaboration.
 Author: Mervin Praison
 License: MIT
@@ -11,13 +11,14 @@ Description-Content-Type: text/markdown
 Requires-Dist: rich>=13.7
 Requires-Dist: markdown>=3.5
 Requires-Dist: pyparsing>=3.0.0
-Requires-Dist: praisonaiagents>=1.6.70
+Requires-Dist: praisonaiagents>=1.6.71
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm<2,>=1.83.14
 Requires-Dist: PyYAML>=6.0
 Requires-Dist: mcp>=1.20.0
 Requires-Dist: typer>=0.9.0
 Requires-Dist: textual>=0.47.0
+Requires-Dist: pydantic>=2.0.0
 Provides-Extra: ui
 Requires-Dist: aiui<0.4,>=0.3.121; extra == "ui"
 Provides-Extra: gradio

{praisonai-4.6.70 → praisonai-4.6.71}/PraisonAI.egg-info/SOURCES.txt

@@ -248,6 +248,7 @@ praisonai/cli/commands/tracker.py
 praisonai/cli/commands/train.py
 praisonai/cli/commands/ui.py
 praisonai/cli/commands/up.py
+praisonai/cli/commands/validate.py
 praisonai/cli/commands/version.py
 praisonai/cli/commands/workflow.py
 praisonai/cli/configuration/__init__.py
@@ -386,6 +387,7 @@ praisonai/cli/features/doctor/checks/packaging_checks.py
 praisonai/cli/features/doctor/checks/performance_checks.py
 praisonai/cli/features/doctor/checks/permissions_checks.py
 praisonai/cli/features/doctor/checks/runtime_checks.py
+praisonai/cli/features/doctor/checks/runtime_migration_checks.py
 praisonai/cli/features/doctor/checks/selftest_checks.py
 praisonai/cli/features/doctor/checks/serve_checks.py
 praisonai/cli/features/doctor/checks/skills_checks.py
@@ -472,6 +474,9 @@ praisonai/code/utils/__init__.py
 praisonai/code/utils/file_utils.py
 praisonai/code/utils/ignore_utils.py
 praisonai/code/utils/text_utils.py
+praisonai/config/__init__.py
+praisonai/config/schema.py
+praisonai/config/validator.py
 praisonai/context/__init__.py
 praisonai/context/_storage_path.py
 praisonai/context/artifact_store.py

{praisonai-4.6.70 → praisonai-4.6.71}/PraisonAI.egg-info/requires.txt

@@ -1,13 +1,14 @@
 rich>=13.7
 markdown>=3.5
 pyparsing>=3.0.0
-praisonaiagents>=1.6.70
+praisonaiagents>=1.6.71
 python-dotenv>=0.19.0
 litellm<2,>=1.83.14
 PyYAML>=6.0
 mcp>=1.20.0
 typer>=0.9.0
 textual>=0.47.0
+pydantic>=2.0.0
 
 [acp]
 agent-client-protocol>=0.7.0

{praisonai-4.6.70 → praisonai-4.6.71}/praisonai/agents_generator.py

@@ -238,6 +238,11 @@ class AgentsGenerator:
         # Defer framework adapter creation until YAML is loaded
         # This fixes the issue where empty framework string fails before YAML framework is read
         self.framework_adapter = None
+        
+        # Only autogen-family adapters need the autogen tool shim
+        # Note: autogen_v2 is also part of the autogen family
+        if framework and framework in {"autogen", "autogen_v2", "autogen_v4", "ag2"}:
+            self.tool_registry.register_builtin_autogen_adapters()
 
     def _get_framework_adapter(self, framework: str) -> FrameworkAdapter:
         """
@@ -493,96 +498,45 @@ class AgentsGenerator:
 
     def _validate_agents_config(self, config):
         """
-        Validate agent configuration for typos in field names and provide suggestions.
+        Validate agent configuration with fail-fast validation and aggregated errors.
         
         Args:
             config (dict): The parsed YAML configuration
+            
+        Raises:
+            ValueError: If configuration has validation errors
         """
-        known_fields = {
-            'role', 'goal', 'instructions', 'backstory', 'tools', 'toolsets', 'tasks', 'llm',
-            'function_calling_llm', 'allow_delegation', 'max_iter', 'max_rpm',
-            'max_execution_time', 'verbose', 'cache', 'system_template',
-            'prompt_template', 'response_template', 'tool_timeout', 'tool_retry_policy',
-            'planning_tools', 'planning', 'autonomy', 'guardrails', 'streaming', 'stream',
-            'approval', 'skills', 'cli_backend', 'runtime', 'reflection', 'handoff', 'web', 'web_fetch'
-        }
+        # Use the new comprehensive validator
+        from .config.validator import ConfigValidator
         
-        # Collect YAML-local model aliases (valid even if not in global catalogue)
-        local_model_aliases = set()
-        models_cfg = config.get("models", {})
-        if isinstance(models_cfg, dict):
-            local_model_aliases = {k for k in models_cfg.keys() if isinstance(k, str)}
+        # Use existing tool resolver if available
+        validator = ConfigValidator(tool_resolver=self.tool_resolver)
         
-        # Try to load model catalogue for validation
-        model_catalogue = None
-        try:
-            from .llm.catalogue import ModelCatalogue
-            model_catalogue = ModelCatalogue()
-        except ImportError:
-            pass  # Catalogue not available
-
-        for section_name in ('agents', 'roles'):
-            section = config.get(section_name, {})
-            if not isinstance(section, dict):
-                continue
-
-            entity_name = 'agent' if section_name == 'agents' else 'role'
-            for name, section_config in section.items():
-                if not isinstance(section_config, dict):
-                    continue
-
-                for field_name in section_config:
-                    if field_name in known_fields:
-                        continue
-
-                    close_matches = difflib.get_close_matches(
-                        field_name,
-                        known_fields,
-                        n=1,
-                        cutoff=0.6
-                    )
-                    suggestion = f" Did you mean '{close_matches[0]}'?" if close_matches else ""
-                    self.logger.warning(
-                        f"Unknown field '{field_name}' in {entity_name} '{name}'.{suggestion}"
-                    )
-                
-                # Validate model/llm values if catalogue available
-                if model_catalogue:
-                    for model_field in ('llm', 'function_calling_llm'):
-                        model_value = section_config.get(model_field)
-                        if model_value and isinstance(model_value, str):
-                            # Skip validation for local model aliases defined in YAML
-                            if model_value in local_model_aliases:
-                                continue
-                            try:
-                                model_catalogue.validate_model(model_value)
-                            except ValueError as e:
-                                self.logger.warning(
-                                    f"Invalid model '{model_value}' in {entity_name} '{name}' field '{model_field}': {e}"
-                                )
-                    
-                    # Check for tools configured with non-tool-calling models
-                    if section_config.get('tools'):
-                        llm_value = section_config.get('llm')
-                        if llm_value:
-                            model_info = model_catalogue.describe_model(llm_value)
-                            if model_info and not model_info.get('supports_tools'):
-                                self.logger.warning(
-                                    f"{entity_name.capitalize()} '{name}' has tools configured but model '{llm_value}' does not support tool calling"
-                                )
-        
-        # Also validate top-level llm/model config
-        if model_catalogue:
-            for model_field in ('llm', 'model'):
-                model_value = config.get(model_field)
-                if model_value and isinstance(model_value, str):
-                    # Skip validation for local model aliases defined in YAML
-                    if model_value in local_model_aliases:
-                        continue
-                    try:
-                        model_catalogue.validate_model(model_value)
-                    except ValueError as e:
-                        self.logger.warning(f"Invalid model '{model_value}' in top-level '{model_field}': {e}")
+        # Check for strict mode from environment or config
+        import os
+        strict_mode = os.getenv('PRAISONAI_VALIDATE_STRICT', 'false').lower() == 'true'
+        
+        # Validate configuration
+        result = validator.validate_config(config, strict=strict_mode)
+        
+        # Log warnings
+        for warning in result.warnings:
+            self.logger.warning(warning)
+        
+        # If there are errors, fail fast with aggregated error message
+        if not result.valid:
+            error_msg = f"Configuration validation failed with {len(result.errors)} error(s):\n"
+            for i, error in enumerate(result.errors, 1):
+                error_msg += f"  {i}. {error}\n"
+            
+            # Include warnings if any
+            if result.warnings:
+                error_msg += f"\nAdditionally, there are {len(result.warnings)} warning(s):\n"
+                for i, warning in enumerate(result.warnings, 1):
+                    error_msg += f"  {i}. {warning}\n"
+            
+            self.logger.error(error_msg)
+            raise ValueError(error_msg)
 
 
 

{praisonai-4.6.70 → praisonai-4.6.71}/praisonai/cli/app.py

@@ -127,6 +127,7 @@ _LAZY_COMMANDS: Dict[str, Tuple[str, str, str]] = {
     "setup": (".commands.setup", "app", "Interactive onboarding / configuration wizard"),
     "onboard": (".commands.onboard", "app", "Messaging bot onboarding wizard"),
     "obs": (".commands.obs", "app", "Observability diagnostics and management"),
+    "validate": (".commands.validate", "app", "Validate YAML configuration files"),
     "acp": (".commands.acp", "app", "Agent Client Protocol server"),
     "mcp": (".commands.mcp", "app", "MCP server management"),
     "serve": (".commands.serve", "app", "API server management"),

{praisonai-4.6.70 → praisonai-4.6.71}/praisonai/cli/commands/doctor.py

@@ -29,7 +29,7 @@ def _run_doctor(args: list) -> int:
         return 4
     except Exception as e:
         output = get_output_controller()
-        output.print_error(f"Doctor error: {e}")
+        output.print_error(f"Doctor command failed: {e}")
         return 1
 
 
@@ -37,25 +37,23 @@ def _run_doctor(args: list) -> int:
 def doctor_env(
     deep: bool = typer.Option(False, "--deep", help="Enable deeper probes"),
     json_output: bool = typer.Option(False, "--json", help="Output JSON"),
-    timeout: float = typer.Option(10.0, "--timeout", help="Per-check timeout"),
 ):
-    """Check environment variables and API keys."""
+    """Check environment variables."""
     args = ["env"]
     if deep:
         args.append("--deep")
     if json_output:
         args.append("--json")
-    args.extend(["--timeout", str(timeout)])
     raise typer.Exit(_run_doctor(args))
 
 
-@app.command("config")
-def doctor_config(
+@app.command("docker")
+def doctor_docker(
     deep: bool = typer.Option(False, "--deep", help="Enable deeper probes"),
     json_output: bool = typer.Option(False, "--json", help="Output JSON"),
 ):
-    """Check configuration files."""
-    args = ["config"]
+    """Check Docker installation and configuration."""
+    args = ["docker"]
     if deep:
         args.append("--deep")
     if json_output:
@@ -63,13 +61,13 @@ def doctor_config(
     raise typer.Exit(_run_doctor(args))
 
 
-@app.command("tools")
-def doctor_tools(
+@app.command("llm-providers")
+def doctor_llm_providers(
     deep: bool = typer.Option(False, "--deep", help="Enable deeper probes"),
     json_output: bool = typer.Option(False, "--json", help="Output JSON"),
 ):
-    """Check tools availability."""
-    args = ["tools"]
+    """Check LLM providers configuration."""
+    args = ["llm-providers"]
     if deep:
         args.append("--deep")
     if json_output:
@@ -77,13 +75,13 @@ def doctor_tools(
     raise typer.Exit(_run_doctor(args))
 
 
-@app.command("db")
-def doctor_db(
+@app.command("memory-store")
+def doctor_memory_store(
     deep: bool = typer.Option(False, "--deep", help="Enable deeper probes"),
     json_output: bool = typer.Option(False, "--json", help="Output JSON"),
 ):
-    """Check database connections."""
-    args = ["db"]
+    """Check memory store backends."""
+    args = ["memory-store"]
     if deep:
         args.append("--deep")
     if json_output:
@@ -91,12 +89,23 @@ def doctor_db(
     raise typer.Exit(_run_doctor(args))
 
 
+@app.command("metadata-store")
+def doctor_metadata_store(
+    json_output: bool = typer.Option(False, "--json", help="Output JSON"),
+):
+    """Check metadata store configuration."""
+    args = ["metadata-store"]
+    if json_output:
+        args.append("--json")
+    raise typer.Exit(_run_doctor(args))
+
+
 @app.command("mcp")
 def doctor_mcp(
     deep: bool = typer.Option(False, "--deep", help="Enable deeper probes"),
     json_output: bool = typer.Option(False, "--json", help="Output JSON"),
 ):
-    """Check MCP servers."""
+    """Check MCP server connectivity and health."""
     args = ["mcp"]
     if deep:
         args.append("--deep")
@@ -258,19 +267,28 @@ def doctor_skills(
 def doctor_runtime(
     team: str = typer.Option(None, "--team", help="Team YAML file to validate"),
     workflow: str = typer.Option(None, "--workflow", help="Workflow YAML file to validate (future)"),
+    fix: bool = typer.Option(False, "--fix", help="Apply migration fixes automatically"),
+    dry_run: bool = typer.Option(True, "--dry-run/--execute", help="Show what would be fixed without applying changes"),
     json_output: bool = typer.Option(False, "--json", help="Output JSON"),
     deep: bool = typer.Option(False, "--deep", help="Enable deeper probes"),
+    file: Optional[str] = typer.Option(None, "--file", "-f", help="Config file to check (default: search for agents.yaml)"),
 ):
-    """Check runtime compatibility for multi-agent setups."""
+    """Check runtime configuration and migrate legacy cli_backend settings."""
     args = ["runtime"]
     if team:
         args.extend(["--team", team])
     if workflow:
         args.extend(["--workflow", workflow])
+    if fix:
+        args.append("--fix")
+    if not dry_run:
+        args.append("--execute")
     if json_output:
         args.append("--json")
     if deep:
         args.append("--deep")
+    if file:
+        args.extend(["--file", file])
     raise typer.Exit(_run_doctor(args))
 
 
@@ -279,124 +297,36 @@ def doctor_troubleshoot():
     """
     Show troubleshooting information for common import errors.
     
-    This command displays diagnostic information and solutions for:
+    This command provides detailed troubleshooting steps for:
     - ImportError: cannot import name 'Agent' from 'praisonaiagents'
-    - Namespace package shadowing issues
-    - Stale package artifacts
+    - ModuleNotFoundError: No module named 'praisonaiagents'
+    - Other common environment issues
     """
     output = get_output_controller()
     
-    output.console.print("\n[bold cyan]PraisonAI Import Troubleshooting[/bold cyan]\n")
+    output.console.print("[bold cyan]PraisonAI Import Troubleshooting Guide[/bold cyan]\n")
     
-    # Check current state
-    output.console.print("[bold]1. Checking praisonaiagents package state...[/bold]")
+    # Provide troubleshooting steps
+    output.console.print("[bold]If you're seeing import errors:[/bold]\n")
     
-    try:
-        import praisonaiagents
-        file_attr = praisonaiagents.__file__
-        spec_origin = praisonaiagents.__spec__.origin if praisonaiagents.__spec__ else None
-        
-        if file_attr is None:
-            output.print_error("  ✗ praisonaiagents.__file__ is None (namespace package detected)")
-            output.console.print("    [yellow]This indicates stale artifacts in site-packages.[/yellow]")
-        else:
-            output.print_success(f"  ✓ praisonaiagents.__file__: {file_attr}")
-        
-        if spec_origin is None:
-            output.print_error("  ✗ praisonaiagents.__spec__.origin is None")
-        else:
-            output.print_success(f"  ✓ praisonaiagents.__spec__.origin: {spec_origin}")
-        
-        # Try importing Agent
-        output.console.print("\n[bold]2. Testing Agent import...[/bold]")
-        try:
-            from praisonaiagents import Agent
-            output.print_success(f"  ✓ Agent imported successfully: {Agent}")
-        except ImportError as e:
-            output.print_error(f"  ✗ Agent import failed: {e}")
-            
-    except ImportError as e:
-        output.print_error(f"  ✗ Cannot import praisonaiagents: {e}")
+    output.console.print("1. [yellow]Check for stale package artifacts:[/yellow]")
+    output.console.print("   praisonai doctor cleanup --execute\n")
     
-    # Check for stale directories
-    output.console.print("\n[bold]3. Checking for stale artifacts...[/bold]")
-    import site
-    import os
+    output.console.print("2. [yellow]Reinstall praisonaiagents:[/yellow]")
+    output.console.print("   pip uninstall praisonaiagents -y")
+    output.console.print("   pip install praisonaiagents\n")
     
-    stale_found = False
-    try:
-        site_packages = site.getsitepackages()
-    except AttributeError:
-        site_packages = []
+    output.console.print("3. [yellow]Check installation location:[/yellow]")
+    output.console.print("   pip show praisonaiagents\n")
     
-    for sp in site_packages:
-        praisonai_dir = os.path.join(sp, 'praisonaiagents')
-        if os.path.isdir(praisonai_dir):
-            init_path = os.path.join(praisonai_dir, '__init__.py')
-            if not os.path.exists(init_path):
-                output.print_error(f"  ✗ Stale directory found: {praisonai_dir}")
-                stale_found = True
-            else:
-                output.print_success(f"  ✓ Valid package at: {praisonai_dir}")
+    output.console.print("4. [yellow]Verify Python path:[/yellow]")
+    output.console.print("   python -c \"import sys; print('\\n'.join(sys.path))\"\n")
     
-    if not stale_found:
-        output.print_success("  ✓ No stale artifacts found")
+    output.console.print("5. [yellow]For editable installs, reinstall from source:[/yellow]")
+    output.console.print("   git clone https://github.com/MervinPraison/PraisonAI.git")
+    output.console.print("   cd PraisonAI/src/praisonai-agents")
+    output.console.print("   pip install -e .\n")
     
-    # Show solutions
-    output.console.print("\n[bold]Solutions:[/bold]")
-    output.console.print("""
-[cyan]If you see import errors:[/cyan]
-
-1. Run cleanup to remove stale artifacts:
-   [green]praisonai doctor cleanup --execute[/green]
-
-2. Reinstall praisonaiagents:
-   [green]pip install --force-reinstall praisonaiagents[/green]
-
-3. Or manually remove stale directory:
-   [green]rm -rf $(python -c "import site; print(site.getsitepackages()[0])")/praisonaiagents/[/green]
-
-[cyan]For editable installs:[/cyan]
-   [green]pip install -e /path/to/praisonai-agents[/green]
-""")
+    output.console.print("[dim]For more help, visit: https://github.com/MervinPraison/PraisonAI[/dim]")
     
-    raise typer.Exit(0)
-
-
-@app.command("fix")
-def doctor_fix(
-    dry_run: bool = typer.Option(True, "--dry-run/--execute", help="Show what would be fixed without applying changes"),
-    backup: bool = typer.Option(True, "--backup/--no-backup", help="Create backup files before modifying"),
-    config_path: Optional[str] = typer.Option(None, "--config", help="Specific config file to fix"),
-):
-    """Fix common configuration issues, including deprecated cli_backend usage."""
-    args = ["fix"]
-    if not dry_run:
-        args.append("--execute")
-    if not backup:
-        args.append("--no-backup") 
-    if config_path:
-        args.extend(["--file", config_path])
-    raise typer.Exit(_run_doctor(args))
-
-
-@app.callback(invoke_without_command=True)
-def doctor_callback(
-    ctx: typer.Context,
-    deep: bool = typer.Option(False, "--deep", help="Enable deeper probes"),
-    json_output: bool = typer.Option(False, "--json", help="Output JSON"),
-    strict: bool = typer.Option(False, "--strict", help="Treat warnings as failures"),
-    quiet: bool = typer.Option(False, "--quiet", "-q", help="Minimal output"),
-):
-    """Run all fast health checks."""
-    if ctx.invoked_subcommand is None:
-        args = []
-        if deep:
-            args.append("--deep")
-        if json_output:
-            args.append("--json")
-        if strict:
-            args.append("--strict")
-        if quiet:
-            args.append("--quiet")
-        raise typer.Exit(_run_doctor(args))
+    raise typer.Exit(0)