PraisonAI 4.6.30__tar.gz → 4.6.32__tar.gz

{praisonai-4.6.30 → praisonai-4.6.32}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.6.30
+Version: 4.6.32
 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,7 +11,7 @@ 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.30
+Requires-Dist: praisonaiagents>=1.6.32
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm<=1.82.6,>=1.81.0
 Requires-Dist: PyYAML>=6.0
@@ -203,7 +203,7 @@ Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
 
 </div>
 
-PraisonAI 🦞 — **Hire a 24/7 AI Workforce.** Stop writing boilerplate and start shipping autonomous agents that research, plan, and execute tasks across your apps. From one agent to an entire organization, deployed in 5 lines of code.
+PraisonAI 🦞 — **Hire a 24/7 AI Workforce.** Stop writing boilerplate and start shipping autonomous, self-improving agents that research, plan, and execute tasks across your apps. From one agent to an entire organization, deployed in 5 lines of code.
 
 ```bash
 curl -fsSL https://praison.ai/install.sh | bash

{praisonai-4.6.30 → praisonai-4.6.32}/PraisonAI.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.6.30
+Version: 4.6.32
 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,7 +11,7 @@ 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.30
+Requires-Dist: praisonaiagents>=1.6.32
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm<=1.82.6,>=1.81.0
 Requires-Dist: PyYAML>=6.0
@@ -203,7 +203,7 @@ Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
 
 </div>
 
-PraisonAI 🦞 — **Hire a 24/7 AI Workforce.** Stop writing boilerplate and start shipping autonomous agents that research, plan, and execute tasks across your apps. From one agent to an entire organization, deployed in 5 lines of code.
+PraisonAI 🦞 — **Hire a 24/7 AI Workforce.** Stop writing boilerplate and start shipping autonomous, self-improving agents that research, plan, and execute tasks across your apps. From one agent to an entire organization, deployed in 5 lines of code.
 
 ```bash
 curl -fsSL https://praison.ai/install.sh | bash

{praisonai-4.6.30 → praisonai-4.6.32}/PraisonAI.egg-info/SOURCES.txt

@@ -490,6 +490,7 @@ praisonai/framework_adapters/autogen_adapter.py
 praisonai/framework_adapters/base.py
 praisonai/framework_adapters/crewai_adapter.py
 praisonai/framework_adapters/praisonai_adapter.py
+praisonai/framework_adapters/registry.py
 praisonai/gateway/__init__.py
 praisonai/gateway/auth.py
 praisonai/gateway/cookie_auth.py
@@ -520,6 +521,8 @@ praisonai/integrations/codex_cli.py
 praisonai/integrations/cursor_cli.py
 praisonai/integrations/db_session_adapter.py
 praisonai/integrations/gemini_cli.py
+praisonai/integrations/hosted_agent.py
+praisonai/integrations/local_agent.py
 praisonai/integrations/managed_agents.py
 praisonai/integrations/managed_local.py
 praisonai/integrations/registry.py

{praisonai-4.6.30 → praisonai-4.6.32}/PraisonAI.egg-info/requires.txt

@@ -1,7 +1,7 @@
 rich>=13.7
 markdown>=3.5
 pyparsing>=3.0.0
-praisonaiagents>=1.6.30
+praisonaiagents>=1.6.32
 python-dotenv>=0.19.0
 litellm<=1.82.6,>=1.81.0
 PyYAML>=6.0

{praisonai-4.6.30 → praisonai-4.6.32}/README.md

@@ -23,7 +23,7 @@
 
 </div>
 
-PraisonAI 🦞 — **Hire a 24/7 AI Workforce.** Stop writing boilerplate and start shipping autonomous agents that research, plan, and execute tasks across your apps. From one agent to an entire organization, deployed in 5 lines of code.
+PraisonAI 🦞 — **Hire a 24/7 AI Workforce.** Stop writing boilerplate and start shipping autonomous, self-improving agents that research, plan, and execute tasks across your apps. From one agent to an entire organization, deployed in 5 lines of code.
 
 ```bash
 curl -fsSL https://praison.ai/install.sh | bash

{praisonai-4.6.30 → praisonai-4.6.32}/praisonai/__init__.py

@@ -1,5 +1,6 @@
 # Suppress crewai.cli.config logger BEFORE any imports to prevent INFO log
 import logging
+import threading
 logging.getLogger('crewai.cli.config').setLevel(logging.ERROR)
 
 # Version is lightweight, import directly
@@ -27,35 +28,45 @@ __all__ = [
     'LocalManagedConfig',         # backward compat alias
     'SandboxedAgent',             # new honest name
     'SandboxedAgentConfig',       # new honest name
+    # New canonical agent backends
+    'HostedAgent',
+    'HostedAgentConfig', 
+    'LocalAgent',
+    'LocalAgentConfig',
 ]
 
-# Telemetry initialization state
+# Telemetry initialization state - thread-safe (threading imported above)
+_telemetry_lock = threading.Lock()
 _telemetry_initialized = False
 
 def _ensure_telemetry_defaults() -> None:
-    """Apply telemetry env defaults exactly once, on first observability use."""
+    """Apply telemetry env defaults exactly once, on first observability use.
+    
+    Thread-safe implementation using double-checked locking pattern.
+    """
     global _telemetry_initialized
-    if _telemetry_initialized:
+    if _telemetry_initialized:  # fast path, OK without lock
         return
-    import os
-    langfuse_configured = bool(
-        os.getenv("LANGFUSE_PUBLIC_KEY")
-        or os.path.exists(os.path.expanduser("~/.praisonai/langfuse.env"))
-    )
-    if langfuse_configured:
-        # Explicitly enable OTEL for Langfuse integration
-        os.environ["OTEL_SDK_DISABLED"] = "false"
-    else:
-        os.environ.setdefault("OTEL_SDK_DISABLED", "true")
-    os.environ.setdefault("EC_TELEMETRY", "false")  # respect user overrides
-    _telemetry_initialized = True
+    with _telemetry_lock:
+        if _telemetry_initialized:
+            return
+        import os
+        # Respect any value the user already set
+        if "OTEL_SDK_DISABLED" not in os.environ:
+            langfuse_configured = bool(
+                os.getenv("LANGFUSE_PUBLIC_KEY")
+                or os.path.exists(os.path.expanduser("~/.praisonai/langfuse.env"))
+            )
+            os.environ["OTEL_SDK_DISABLED"] = "false" if langfuse_configured else "true"
+        os.environ.setdefault("EC_TELEMETRY", "false")  # respect user overrides
+        _telemetry_initialized = True
 
 
 # Lazy loading for heavy imports
 def __getattr__(name):
     """Lazy load heavy modules to improve import time."""
-    # Ensure telemetry defaults before any lazy import that may touch OTEL.
-    _ensure_telemetry_defaults()
+    # Note: Telemetry initialization moved out of lazy hook to avoid side effects
+    # It should be called explicitly from cli.PraisonAI.__init__ instead
 
     if name == 'PraisonAI':
         from .cli import PraisonAI
@@ -123,6 +134,19 @@ def __getattr__(name):
     elif name in ('ManagedConfig', 'ManagedBackendConfig'):
         from .integrations.managed_agents import ManagedConfig
         return ManagedConfig
+    # New canonical agent backends
+    elif name == 'HostedAgent':
+        from .integrations.hosted_agent import HostedAgent
+        return HostedAgent
+    elif name == 'HostedAgentConfig':
+        from .integrations.hosted_agent import HostedAgentConfig
+        return HostedAgentConfig
+    elif name == 'LocalAgent':
+        from .integrations.local_agent import LocalAgent
+        return LocalAgent
+    elif name == 'LocalAgentConfig':
+        from .integrations.local_agent import LocalAgentConfig
+        return LocalAgentConfig
     elif name in ('DB', 'PraisonAIDB', 'PraisonDB'):
         from .db.adapter import DB
         return DB

{praisonai-4.6.30 → praisonai-4.6.32}/praisonai/__main__.py

@@ -13,6 +13,7 @@ Design:
 """
 
 import sys
+import threading
 
 
 # ---------------------------------------------------------------------------
@@ -20,32 +21,41 @@ import sys
 # ---------------------------------------------------------------------------
 
 _typer_commands_cache = None
+_typer_commands_lock = threading.Lock()
 
 
 def _get_typer_commands():
-    """Auto-discover registered Typer commands via Click introspection.
-
-    Returns a set of command names that the Typer app knows about.
-    This is populated from app.py's register_commands() — no manual
-    lists to maintain.
-    """
+    """Auto-discover registered Typer commands via Click introspection."""
     global _typer_commands_cache
+
+    # Fast path
     if _typer_commands_cache is not None:
         return _typer_commands_cache
 
-    try:
-        from praisonai.cli.app import app, register_commands
-        register_commands()
-
-        import typer.main
-        import click
-        click_app = typer.main.get_command(app)
-        ctx = click.Context(click_app, info_name="praisonai")
-        _typer_commands_cache = set(click_app.list_commands(ctx))
-    except Exception:
-        _typer_commands_cache = set()
-
-    return _typer_commands_cache
+    with _typer_commands_lock:
+        if _typer_commands_cache is not None:  # Double-check
+            return _typer_commands_cache
+
+        try:
+            from praisonai.cli.app import app, register_commands
+            register_commands()
+
+            import typer.main
+            import click
+            click_app = typer.main.get_command(app)
+            ctx = click.Context(click_app, info_name="praisonai")
+            commands = set(click_app.list_commands(ctx))
+        except Exception:
+            # Do NOT poison the cache on failure — let the next caller retry.
+            import logging
+            logging.getLogger("praisonai.__main__").warning(
+                "Typer command discovery failed; falling back to legacy dispatch.",
+                exc_info=True,
+            )
+            return set()
+
+        _typer_commands_cache = commands
+        return _typer_commands_cache
 
 
 def _find_first_command(argv):
@@ -72,13 +82,39 @@ def _find_first_command(argv):
 
 def _run_typer(argv):
     """Dispatch to the Typer CLI app."""
+    import os
+    
+    # Set up safer encoding for Windows legacy terminals
+    if sys.platform == "win32" and hasattr(sys.stdout, 'encoding'):
+        encoding = getattr(sys.stdout, 'encoding', '').lower()
+        if encoding in ('cp1252', 'cp1251', 'cp850', 'ascii') or ('cp' in encoding and encoding != 'cp65001'):
+            # Force UTF-8 mode for subprocess safety
+            if 'PYTHONIOENCODING' not in os.environ:
+                os.environ['PYTHONIOENCODING'] = 'utf-8'
+    
+    # Serialize Typer registration through the discovery lock so this path
+    # cannot race with ``_get_typer_commands`` mid-registration on another
+    # thread. ``register_commands()`` is idempotent on success; we hold the
+    # lock around it (and not just call it) so that a concurrent
+    # discoverer cannot observe a partially-registered command tree.
+    # Crucially we do NOT wrap this in try/except: registration errors
+    # (e.g. ``ImportError`` from a missing optional dep) must propagate
+    # from ``main()`` rather than be silently downgraded to an empty
+    # command set, otherwise the user just sees Typer's "no command" path
+    # instead of a real diagnostic.
     from praisonai.cli.app import app, register_commands
-    register_commands()  # idempotent
+    with _typer_commands_lock:
+        register_commands()
 
     original = sys.argv
     sys.argv = ["praisonai"] + list(argv)
     try:
         app()
+    except UnicodeEncodeError as e:
+        # Handle Unicode encoding errors gracefully
+        print("Error: Unable to display help due to terminal encoding limitations.", file=sys.stderr)
+        print("Try setting: $env:PYTHONIOENCODING='utf-8' (PowerShell) or set PYTHONIOENCODING=utf-8 (cmd)", file=sys.stderr)
+        sys.exit(0)
     except SystemExit as e:
         sys.exit(e.code if isinstance(e.code, int) else 0)
     finally:

{praisonai-4.6.30 → praisonai-4.6.32}/praisonai/_async_bridge.py

@@ -6,7 +6,6 @@ handling nested event loop scenarios without creating a new event loop
 on every call (which is expensive and breaks multi-agent workflows).
 """
 import asyncio
-import atexit
 import os
 import threading
 from concurrent.futures import Future
@@ -22,18 +21,38 @@ class _BackgroundLoop:
         self._thread: threading.Thread | None = None
         self._lock = threading.Lock()
 
+    def _spawn_locked(self) -> asyncio.AbstractEventLoop:
+        """Create the loop+thread; caller must hold ``self._lock``.
+
+        The thread is marked ``daemon=True`` so that short-lived scripts
+        (e.g. CLI commands, smoke tests) exit cleanly without waiting on
+        the background loop to be shut down explicitly. Long-running
+        server processes should call :func:`shutdown` explicitly to cancel
+        in-flight tasks before process exit.
+        """
+        # Enforce the documented invariant. ``threading.Lock.locked()``
+        # is process-wide, not thread-local, but combined with the fact
+        # that the only callers are :py:meth:`get` and :py:meth:`get_unlocked`
+        # (the latter only invoked from inside ``run_sync`` while holding
+        # the lock), this catches the "forgot to hold the lock" mistake.
+        assert self._lock.locked(), "_spawn_locked() requires self._lock to be held"
+        if self._loop is None or self._loop.is_closed():
+            self._loop = asyncio.new_event_loop()
+            self._thread = threading.Thread(
+                target=self._loop.run_forever,
+                name="praisonai-async",
+                daemon=True,
+            )
+            self._thread.start()
+        return self._loop
+
     def get(self) -> asyncio.AbstractEventLoop:
         with self._lock:
-            if self._loop is None or self._loop.is_closed():
-                self._loop = asyncio.new_event_loop()
-                # non-daemon so shutdown must be explicit and clean
-                self._thread = threading.Thread(
-                    target=self._loop.run_forever,
-                    name="praisonai-async",
-                    daemon=False,
-                )
-                self._thread.start()
-            return self._loop
+            return self._spawn_locked()
+
+    def get_unlocked(self) -> asyncio.AbstractEventLoop:
+        """Get loop assuming caller holds _lock. For run_sync() use only."""
+        return self._spawn_locked()
 
     def shutdown(self, timeout: float = 5.0) -> None:
         with self._lock:
@@ -58,17 +77,14 @@ class _BackgroundLoop:
                 self._thread = None
 
 _BG = _BackgroundLoop()
-atexit.register(_BG.shutdown)
 
 
 def run_sync(coro: Awaitable[T], *, timeout: float | None = _DEFAULT_TIMEOUT) -> T:
     """
-    Run a coroutine synchronously, safe inside a running loop.
+    Run a coroutine synchronously using the background loop.
     
-    This function automatically detects if there's already a running event loop
-    and handles the execution appropriately:
-    - If no loop is running: uses background loop (consistent behavior)
-    - If a loop is running: schedules on background loop (safe path)
+    IMPORTANT: This function cannot be called from within a running event loop
+    as it would cause deadlock. Use 'await coro' directly from async contexts.
     
     Args:
         coro: The coroutine to run
@@ -78,24 +94,27 @@ def run_sync(coro: Awaitable[T], *, timeout: float | None = _DEFAULT_TIMEOUT) ->
         The result of the coroutine
         
     Raises:
+        RuntimeError: If called from within a running event loop
         TimeoutError: If timeout is exceeded
         Any exception raised by the coroutine
     """
     try:
         asyncio.get_running_loop()
-        running = True
     except RuntimeError:
-        running = False
-
-    if not running:
-        # Reuse the background loop instead of creating a new one per call.
-        fut: Future = asyncio.run_coroutine_threadsafe(coro, _BG.get())
-        return fut.result(timeout=timeout)
+        pass
+    else:
+        raise RuntimeError(
+            "run_sync() cannot be called from a running event loop; "
+            "await the coroutine directly instead."
+        )
 
-    fut = asyncio.run_coroutine_threadsafe(coro, _BG.get())
+    # Submit the coroutine inside the lock to prevent shutdown races
+    with _BG._lock:
+        loop = _BG.get_unlocked()
+        fut: Future = asyncio.run_coroutine_threadsafe(coro, loop)
     return fut.result(timeout=timeout)
 
 
 def shutdown() -> None:
-    """Public hook for servers (gateway, a2u, mcp_server) to stop the bridge cleanly."""
+    """Public hook for long-running server processes to stop the bridge cleanly."""
     _BG.shutdown()

praisonai-4.6.32/praisonai/agent_scheduler.py

@@ -0,0 +1,19 @@
+"""Backward-compatible re-export. Prefer `praisonai.scheduler`.
+
+This module is deprecated. Use the canonical implementation in the
+scheduler package for full functionality including YAML and recipe support.
+"""
+
+import warnings
+
+warnings.warn(
+    "praisonai.agent_scheduler is deprecated; "
+    "use 'from praisonai.scheduler import AgentScheduler' instead.",
+    DeprecationWarning, stacklevel=2,
+)
+
+from praisonai.scheduler.agent_scheduler import (  # noqa: F401
+    AgentScheduler, PraisonAgentExecutor, create_agent_scheduler
+)
+# Preserve the legacy public name as an alias of the canonical interface
+from praisonai.scheduler.base import ExecutorInterface as AgentExecutorInterface  # noqa: F401

{praisonai-4.6.30 → praisonai-4.6.32}/praisonai/agents_generator.py

@@ -17,10 +17,8 @@ import re
 import keyword
 
 # Import new architecture components
-from .framework_adapters import (
-    FrameworkAdapter, CrewAIAdapter, AutoGenAdapter, 
-    AutoGenV4Adapter, AG2Adapter, PraisonAIAdapter
-)
+from .framework_adapters.base import FrameworkAdapter
+from .framework_adapters.registry import FrameworkAdapterRegistry
 from .tool_registry import ToolRegistry
 
 # Import availability flags
@@ -51,14 +49,8 @@ try:
 except ImportError:
     pass
 
-# Registry of available adapters (lazy-loaded)
-FRAMEWORK_ADAPTERS = {
-    "crewai": CrewAIAdapter,
-    "autogen": AutoGenAdapter, 
-    "autogen_v4": AutoGenV4Adapter,
-    "ag2": AG2Adapter,
-    "praisonai": PraisonAIAdapter
-}
+# Framework adapter registry - now uses proper registry pattern
+# This replaces the hardcoded FRAMEWORK_ADAPTERS dict
 
 # Note: OTEL_SDK_DISABLED moved to CLI entry point per issue requirements
 
@@ -258,12 +250,8 @@ class AgentsGenerator:
         Raises:
             ValueError: If framework is not supported
         """
-        if framework not in FRAMEWORK_ADAPTERS:
-            raise ValueError(f"Unsupported framework: {framework}. "
-                           f"Supported frameworks: {list(FRAMEWORK_ADAPTERS.keys())}")
-        
-        adapter_class = FRAMEWORK_ADAPTERS[framework]
-        return adapter_class()
+        adapter_registry = FrameworkAdapterRegistry.get_instance()
+        return adapter_registry.create(framework)
 
     def _merge_cli_config(self, config, cli_config):
         """