PraisonAI 4.6.111__tar.gz → 4.6.118__tar.gz

{praisonai-4.6.111 → praisonai-4.6.118}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.6.111
+Version: 4.6.118
 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,8 +11,8 @@ 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.111
-Requires-Dist: praisonai-code>=0.0.9
+Requires-Dist: praisonaiagents>=1.6.118
+Requires-Dist: praisonai-code>=0.0.16
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm<2,>=1.83.14
 Requires-Dist: PyYAML>=6.0

{praisonai-4.6.111 → praisonai-4.6.118}/PraisonAI.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.6.111
+Version: 4.6.118
 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,8 +11,8 @@ 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.111
-Requires-Dist: praisonai-code>=0.0.9
+Requires-Dist: praisonaiagents>=1.6.118
+Requires-Dist: praisonai-code>=0.0.16
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm<2,>=1.83.14
 Requires-Dist: PyYAML>=6.0

{praisonai-4.6.111 → praisonai-4.6.118}/PraisonAI.egg-info/SOURCES.txt

@@ -274,12 +274,42 @@ praisonai/cli/configuration/__init__.py
 praisonai/cli/configuration/config.schema.json
 praisonai/cli/execution/__init__.py
 praisonai/cli/features/__init__.py
+praisonai/cli/features/acp.py
+praisonai/cli/features/agent_scheduler.py
+praisonai/cli/features/agent_tools.py
 praisonai/cli/features/approval.py
+praisonai/cli/features/background.py
 praisonai/cli/features/bots_cli.py
+praisonai/cli/features/deploy.py
+praisonai/cli/features/endpoints.py
+praisonai/cli/features/eval.py
 praisonai/cli/features/gateway.py
+praisonai/cli/features/ollama.py
 praisonai/cli/features/onboard.py
+praisonai/cli/features/persistence.py
+praisonai/cli/features/recipe.py
+praisonai/cli/features/recipe_optimizer.py
+praisonai/cli/features/registry.py
+praisonai/cli/features/sandbox_cli.py
 praisonai/cli/features/serve.py
+praisonai/cli/features/templates.py
+praisonai/cli/features/tools.py
+praisonai/cli/features/workflow.py
+praisonai/cli/features/tui/__init__.py
+praisonai/cli/features/tui/app.py
 praisonai/cli/interactive/__init__.py
+praisonai/cli/interactive/async_tui.py
+praisonai/cli/interactive/core.py
+praisonai/cli/legacy/__init__.py
+praisonai/cli/legacy/direct_prompt.py
+praisonai/cli/legacy/framework_run.py
+praisonai/cli/legacy/inbuilt_tools.py
+praisonai/cli/legacy/interactive_legacy.py
+praisonai/cli/legacy/subcommand_handlers.py
+praisonai/cli/legacy/workflow_commands.py
+praisonai/cli/legacy/dispatch/__init__.py
+praisonai/cli/legacy/dispatch/argparse_builder.py
+praisonai/cli/legacy/dispatch/legacy_dispatch.py
 praisonai/cli/output/__init__.py
 praisonai/cli/session/__init__.py
 praisonai/cli/state/__init__.py
@@ -331,13 +361,6 @@ praisonai/deploy/providers/aws.py
 praisonai/deploy/providers/azure.py
 praisonai/deploy/providers/base.py
 praisonai/deploy/providers/gcp.py
-praisonai/docs_runner/__init__.py
-praisonai/docs_runner/classifier.py
-praisonai/docs_runner/executor.py
-praisonai/docs_runner/extractor.py
-praisonai/docs_runner/reporter.py
-praisonai/docs_runner/runner.py
-praisonai/docs_runner/workspace.py
 praisonai/endpoints/__init__.py
 praisonai/endpoints/a2u_server.py
 praisonai/endpoints/discovery.py

{praisonai-4.6.111 → praisonai-4.6.118}/PraisonAI.egg-info/requires.txt

@@ -1,8 +1,8 @@
 rich>=13.7
 markdown>=3.5
 pyparsing>=3.0.0
-praisonaiagents>=1.6.111
-praisonai-code>=0.0.9
+praisonaiagents>=1.6.118
+praisonai-code>=0.0.16
 python-dotenv>=0.19.0
 litellm<2,>=1.83.14
 PyYAML>=6.0

praisonai-4.6.118/praisonai/_registry.py

@@ -0,0 +1,26 @@
+"""Backward-compatibility shim for :mod:`praisonai._registry`.
+
+The canonical ``PluginRegistry`` base lives in
+:mod:`praisonai_code._registry`. This module re-exports it so the historical
+import path (``from praisonai._registry import PluginRegistry``) keeps working
+while there is a single owner of the registry-resolution logic (mirroring the
+existing ``tool_resolver`` / ``tool_registry`` shims).
+"""
+
+from praisonai._bootstrap import ensure_praisonai_code
+
+ensure_praisonai_code()
+
+from praisonai_code._registry import (  # noqa: F401
+    PluginRegistry,
+    create_lazy_getattr,
+)
+
+import logging as _logging
+
+# Preserve the historical logger name so any existing log-level configuration
+# targeting ``'praisonai._registry'`` still takes effect (the canonical module's
+# logger is named ``'praisonai_code._registry'``).
+logger = _logging.getLogger(__name__)
+
+__all__ = ["PluginRegistry", "create_lazy_getattr", "logger"]

{praisonai-4.6.111 → praisonai-4.6.118}/praisonai/adapters/__init__.py

@@ -6,8 +6,13 @@ This module provides concrete implementations of:
 - Vector store adapters (ChromaAdapter, PineconeAdapter, etc.)
 - Retriever implementations
 - Reranker implementations
+- CLI protocol adapters (C8.5: ServeHandlerAdapter, template store helper)
 """
 
+from __future__ import annotations
+
+from typing import Any, Optional
+
 # Lazy loading to avoid heavy imports at package load time
 _LAZY_IMPORTS = {
     # Readers
@@ -16,22 +21,44 @@ _LAZY_IMPORTS = {
     "TextReader": ("praisonai.adapters.readers", "TextReader"),
     "DirectoryReader": ("praisonai.adapters.readers", "DirectoryReader"),
     "register_default_readers": ("praisonai.adapters.readers", "register_default_readers"),
-    
+
     # Vector stores
     "ChromaVectorStore": ("praisonai.adapters.vector_stores", "ChromaVectorStore"),
     "register_default_vector_stores": ("praisonai.adapters.vector_stores", "register_default_vector_stores"),
-    
+
     # Retrievers
     "BasicRetriever": ("praisonai.adapters.retrievers", "BasicRetriever"),
     "FusionRetriever": ("praisonai.adapters.retrievers", "FusionRetriever"),
     "register_default_retrievers": ("praisonai.adapters.retrievers", "register_default_retrievers"),
-    
+
     # Rerankers
     "LLMReranker": ("praisonai.adapters.rerankers", "LLMReranker"),
     "register_default_rerankers": ("praisonai.adapters.rerankers", "register_default_rerankers"),
 }
 
 
+class ServeHandlerAdapter:
+    """Adapter wrapping ``praisonai.cli.features.serve.handle_serve_command``."""
+
+    def handle(self, args: list[str]) -> int:
+        from praisonai.cli.features.serve import handle_serve_command
+        return int(handle_serve_command(args) or 0)
+
+
+def get_template_store() -> Optional[Any]:
+    """Return template store when wrapper templates feature is available."""
+    try:
+        from praisonai.cli.features import templates as templates_mod
+        return templates_mod
+    except ImportError:
+        return None
+
+
+# C8.5 CLI adapters are defined in this module (not lazy) since they are
+# lightweight and only trigger heavy wrapper imports when their methods run.
+_LOCAL_EXPORTS = {"ServeHandlerAdapter", "get_template_store"}
+
+
 def __getattr__(name: str):
     """Lazy load adapters."""
     if name in _LAZY_IMPORTS:
@@ -44,7 +71,7 @@ def __getattr__(name: str):
 
 def __dir__():
     """List available attributes."""
-    return list(_LAZY_IMPORTS.keys())
+    return list(_LAZY_IMPORTS.keys()) + sorted(_LOCAL_EXPORTS)
 
 
-__all__ = list(_LAZY_IMPORTS.keys())
+__all__ = list(_LAZY_IMPORTS.keys()) + sorted(_LOCAL_EXPORTS)

{praisonai-4.6.111 → praisonai-4.6.118}/praisonai/agents_generator.py

@@ -511,7 +511,37 @@ class AgentsGenerator:
                     tools_dict[tool_class.__name__] = tool_class()
                 except (TypeError, ValueError, RuntimeError) as e:
                     self.logger.warning(f"Failed to instantiate tool class {tool_class.__name__}: {e}")
+
+        # Enforce tool_timeout from CLI/YAML at the wrapper layer so the field is
+        # not silently dropped. The timeout stack (_wrap_tool_with_timeout) is
+        # framework-agnostic and works for both the native and external adapters.
+        effective = self._resolve_effective_tool_timeout(config)
+        if effective and effective > 0:
+            tools_dict = {
+                name: self._wrap_tool_with_timeout(tool, effective)
+                for name, tool in tools_dict.items()
+            }
         return tools_dict
+
+    def _resolve_effective_tool_timeout(self, config):
+        """Resolve the effective per-tool timeout in seconds.
+
+        Precedence: an explicit CLI ``tool_timeout`` wins; otherwise use the
+        largest ``tool_timeout`` declared on any role/agent (safest default for
+        a shared tool dict). Returns ``None`` when nothing declares a timeout.
+        """
+        cli_timeout = (self.cli_config or {}).get("tool_timeout")
+        if isinstance(cli_timeout, (int, float)) and not isinstance(cli_timeout, bool):
+            return float(cli_timeout)
+
+        entities = {**config.get("roles", {}), **config.get("agents", {})}
+        timeouts = [
+            e.get("tool_timeout") for e in entities.values()
+            if isinstance(e, dict)
+            and isinstance(e.get("tool_timeout"), (int, float))
+            and not isinstance(e.get("tool_timeout"), bool)
+        ]
+        return float(max(timeouts)) if timeouts else None
     
     def _select_framework(self, framework: str, config: Dict[str, Any]) -> Any:
         """Select and resolve the appropriate framework adapter.

{praisonai-4.6.111 → praisonai-4.6.118}/praisonai/cli/commands/__init__.py

@@ -112,4 +112,10 @@ def __getattr__(name: str):
     elif name == 'command_app':
         from .command import app as command_app
         return command_app
+    # C8: allow ``praisonai.cli.commands.<name>`` attribute access for patching
+    import importlib
+    try:
+        return importlib.import_module(f".{name}", __package__)
+    except ModuleNotFoundError:
+        pass
     raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

praisonai-4.6.118/praisonai/cli/commands/app.py

@@ -0,0 +1,139 @@
+"""
+CLI command for AgentOS - production deployment of AI agents.
+
+Usage:
+    praisonai app                    # Start server with default config
+    praisonai app --port 9000        # Start on custom port
+    praisonai app --config app.yaml  # Load from config file
+    praisonai app --reload           # Enable auto-reload for development
+"""
+
+import click
+from typing import Optional
+
+
+@click.command("app")
+@click.option("--port", "-p", type=int, default=8000, help="Port to listen on")
+@click.option("--host", "-h", type=str, default="0.0.0.0", help="Host to bind to")
+@click.option("--config", "-c", type=click.Path(exists=True), help="Path to config file (YAML)")
+@click.option("--reload", "-r", is_flag=True, help="Enable auto-reload for development")
+@click.option("--debug", "-d", is_flag=True, help="Enable debug mode")
+@click.option("--name", "-n", type=str, default="PraisonAI App", help="Application name")
+def app_command(
+    port: int,
+    host: str,
+    config: Optional[str],
+    reload: bool,
+    debug: bool,
+    name: str,
+):
+    """
+    Start an AgentOS server for production deployment.
+    
+    AgentOS provides a FastAPI-based web service for deploying AI agents
+    with REST and WebSocket endpoints.
+    
+    Examples:
+    
+        # Start with defaults (port 8000)
+        praisonai app
+        
+        # Start on custom port
+        praisonai app --port 9000
+        
+        # Enable auto-reload for development
+        praisonai app --reload
+        
+        # Load agents from config file
+        praisonai app --config agents.yaml
+    """
+    from rich.console import Console
+    console = Console()
+    
+    try:
+        from praisonai import AgentOS
+        from praisonaiagents import AgentOSConfig
+    except ImportError as e:
+        console.print(f"[red]Error importing AgentOS: {e}[/red]")
+        console.print("[yellow]Install with: pip install praisonai[api][/yellow]")
+        raise click.Abort()
+    
+    # Load agents from config file if provided
+    agents = []
+    if config:
+        agents = _load_agents_from_config(config, console)
+    
+    # Create config
+    app_config = AgentOSConfig(
+        name=name,
+        host=host,
+        port=port,
+        reload=reload,
+        debug=debug,
+    )
+    
+    # Create and start app
+    console.print(f"\n[bold green]🚀 Starting {name}[/bold green]")
+    console.print(f"[dim]Host: {host}:{port}[/dim]")
+    if agents:
+        console.print(f"[dim]Agents: {len(agents)}[/dim]")
+    if reload:
+        console.print("[yellow]Auto-reload enabled (development mode)[/yellow]")
+    console.print()
+    
+    try:
+        agent_app = AgentOS(
+            name=name,
+            agents=agents,
+            config=app_config,
+        )
+        agent_app.serve()
+    except ImportError as e:
+        console.print(f"[red]Missing dependency: {e}[/red]")
+        console.print("[yellow]Install with: pip install praisonai[api][/yellow]")
+        raise click.Abort()
+    except Exception as e:
+        console.print(f"[red]Error starting server: {e}[/red]")
+        raise click.Abort()
+
+
+def _load_agents_from_config(config_path: str, console) -> list:
+    """Load agents from a YAML config file."""
+    import yaml
+    from pathlib import Path
+    
+    try:
+        with open(config_path, 'r') as f:
+            config_data = yaml.safe_load(f)
+    except Exception as e:
+        console.print(f"[red]Error loading config: {e}[/red]")
+        return []
+    
+    if not config_data:
+        return []
+    
+    agents = []
+    
+    # Try to load agents from config
+    agents_config = config_data.get('agents', [])
+    if not agents_config and 'agent' in config_data:
+        agents_config = [config_data['agent']]
+    
+    if agents_config:
+        try:
+            from praisonaiagents import Agent
+            
+            for agent_data in agents_config:
+                if isinstance(agent_data, dict):
+                    agent = Agent(
+                        name=agent_data.get('name', 'Agent'),
+                        role=agent_data.get('role'),
+                        instructions=agent_data.get('instructions', agent_data.get('goal', '')),
+                        llm=agent_data.get('llm'),
+                    )
+                    agents.append(agent)
+                    console.print(f"[green]✓ Loaded agent: {agent.name}[/green]")
+        except Exception as e:
+            console.print(f"[yellow]Warning: Could not load agents from config: {e}[/yellow]")
+    
+    return agents

praisonai-4.6.118/praisonai/cli/commands/audit.py

@@ -0,0 +1,102 @@
+"""
+CLI command for agent-centric compliance auditing.
+
+Usage:
+    praisonai audit agent-centric --scan /path/to/examples
+    praisonai audit agent-centric --fix /path/to/examples
+    praisonai audit agent-centric --check /path/to/examples
+"""
+
+import click
+import json
+import sys
+from pathlib import Path
+
+
+@click.group()
+def audit():
+    """Audit commands for compliance checking."""
+    pass
+
+
+@audit.command("agent-centric")
+@click.option("--scan", "scan_path", type=click.Path(exists=True), help="Scan path for compliance")
+@click.option("--fix", "fix_path", type=click.Path(exists=True), help="Fix non-compliant files")
+@click.option("--check", "check_path", type=click.Path(exists=True), help="Check and fail if non-compliant")
+@click.option("--json", "output_json", is_flag=True, help="Output as JSON")
+@click.option("--line-limit", default=40, help="Line limit for header scan (default: 40)")
+@click.option("--only-examples", is_flag=True, help="Only scan Python examples")
+@click.option("--only-docs", is_flag=True, help="Only scan documentation")
+@click.option("--verbose", "-v", is_flag=True, help="Verbose output")
+def agent_centric(scan_path, fix_path, check_path, output_json, line_limit, only_examples, only_docs, verbose):
+    """
+    Audit agent-centric compliance for examples and docs.
+    
+    Examples:
+        praisonai audit agent-centric --scan ./examples
+        praisonai audit agent-centric --fix ./examples --verbose
+        praisonai audit agent-centric --check ./examples  # Fails if non-compliant
+    """
+    from praisonai.audit.agent_centric import AgentCentricAuditor, ComplianceStatus
+    
+    path = scan_path or fix_path or check_path
+    if not path:
+        click.echo("Error: Must specify --scan, --fix, or --check with a path", err=True)
+        sys.exit(1)
+    
+    auditor = AgentCentricAuditor(line_limit=line_limit, verbose=verbose)
+    
+    if fix_path:
+        # Fix mode
+        click.echo(f"Fixing non-compliant files in: {fix_path}")
+        report = auditor.scan(fix_path)
+        
+        fixed_count = 0
+        for result in report.results:
+            if result.status == ComplianceStatus.NON_COMPLIANT:
+                success, reason = auditor.fix_file(result.file_path)
+                if success:
+                    fixed_count += 1
+                    if verbose:
+                        click.echo(f"  Fixed: {result.file_path} - {reason}")
+        
+        click.echo(f"\nFixed {fixed_count} files")
+        
+        # Re-scan to verify
+        report = auditor.scan(fix_path)
+        click.echo(f"Compliance rate: {report.compliance_rate():.1f}%")
+        
+    else:
+        # Scan or check mode
+        report = auditor.scan(path)
+        
+        if output_json:
+            click.echo(auditor.to_json(report))
+        else:
+            click.echo(f"\n{'='*60}")
+            click.echo("AGENT-CENTRIC COMPLIANCE REPORT")
+            click.echo(f"{'='*60}")
+            click.echo(f"Total files:    {report.total_files}")
+            click.echo(f"Compliant:      {report.compliant}")
+            click.echo(f"Non-compliant:  {report.non_compliant}")
+            click.echo(f"Skipped:        {report.skipped}")
+            click.echo(f"Compliance rate: {report.compliance_rate():.1f}%")
+            
+            if report.by_reason:
+                click.echo(f"\nBy Reason:")
+                for reason, count in sorted(report.by_reason.items()):
+                    click.echo(f"  {reason}: {count}")
+            
+            if verbose and report.non_compliant > 0:
+                click.echo(f"\nNon-compliant files:")
+                for r in report.results:
+                    if r.status == ComplianceStatus.NON_COMPLIANT:
+                        click.echo(f"  {r.file_path}")
+                        click.echo(f"    Reason: {r.reason.value if r.reason else 'unknown'}")
+        
+        # Check mode - fail if non-compliant
+        if check_path and report.non_compliant > 0:
+            click.echo(f"\n❌ FAILED: {report.non_compliant} non-compliant files found", err=True)
+            sys.exit(1)
+        elif check_path:
+            click.echo(f"\n✓ PASSED: All files are agent-centric compliant")