PraisonAI 4.6.131__tar.gz → 4.6.133__tar.gz

{praisonai-4.6.131 → praisonai-4.6.133}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.6.131
+Version: 4.6.133
 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,9 +11,9 @@ 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.134
-Requires-Dist: praisonai-code>=0.0.30
-Requires-Dist: praisonai-bot>=0.0.15
+Requires-Dist: praisonaiagents>=1.6.136
+Requires-Dist: praisonai-code>=0.0.32
+Requires-Dist: praisonai-bot>=0.0.17
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm<2,>=1.83.14
 Requires-Dist: PyYAML>=6.0

{praisonai-4.6.131 → praisonai-4.6.133}/PraisonAI.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.6.131
+Version: 4.6.133
 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,9 +11,9 @@ 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.134
-Requires-Dist: praisonai-code>=0.0.30
-Requires-Dist: praisonai-bot>=0.0.15
+Requires-Dist: praisonaiagents>=1.6.136
+Requires-Dist: praisonai-code>=0.0.32
+Requires-Dist: praisonai-bot>=0.0.17
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm<2,>=1.83.14
 Requires-Dist: PyYAML>=6.0

{praisonai-4.6.131 → praisonai-4.6.133}/PraisonAI.egg-info/requires.txt

@@ -1,9 +1,9 @@
 rich>=13.7
 markdown>=3.5
 pyparsing>=3.0.0
-praisonaiagents>=1.6.134
-praisonai-code>=0.0.30
-praisonai-bot>=0.0.15
+praisonaiagents>=1.6.136
+praisonai-code>=0.0.32
+praisonai-bot>=0.0.17
 python-dotenv>=0.19.0
 litellm<2,>=1.83.14
 PyYAML>=6.0

praisonai-4.6.133/praisonai/agent.py

@@ -0,0 +1,91 @@
+"""Wrapper Agent class with CLI backend resolution support.
+
+This module provides a wrapper around praisonaiagents.Agent that handles
+CLI backend string resolution in the wrapper layer, maintaining proper
+dependency direction per AGENTS.md.
+"""
+
+import threading
+from typing import Union, Optional, Any, TYPE_CHECKING
+
+if TYPE_CHECKING:  # zero runtime cost — only for static analysis / IDEs
+    from praisonaiagents import Agent as CoreAgent
+
+
+def _build_agent_class():
+    """Construct the wrapper Agent class, importing the heavy core lazily.
+
+    ``praisonaiagents`` (and its transitive ``asyncio``/``ssl`` cost) is only
+    imported here, on first construction of the class, keeping
+    ``from praisonai import Agent`` cheap until the class is actually used.
+    """
+    from praisonaiagents import Agent as CoreAgent
+
+    class Agent(CoreAgent):
+        """Agent wrapper with CLI backend string resolution support.
+
+        This class extends the core Agent to handle CLI backend string resolution
+        in the wrapper layer, maintaining proper architectural separation between
+        core protocols and heavy implementations.
+        """
+
+        def __init__(self, *args, cli_backend: Optional[Union[str, Any]] = None, **kwargs):
+            """Initialize Agent with CLI backend string resolution.
+
+            Args:
+                *args: Positional arguments for core Agent
+                cli_backend: CLI backend for delegating full turns. Accepts:
+                    - str: Backend ID ("claude-code", "codex-cli") - resolved in wrapper
+                    - dict: Backend config {"id": "claude-code", "overrides": {...}}
+                    - CliBackendProtocol: Pre-resolved backend instance
+                    - callable: Factory function returning CliBackendProtocol
+                    - None: No CLI backend
+                **kwargs: Keyword arguments for core Agent
+            """
+            # Deprecation warning will be emitted by the core Agent class
+            # Resolve CLI backend configuration using unified resolver
+            if cli_backend is not None and not self._is_protocol_instance(cli_backend):
+                from .cli_backends import resolve_cli_backend_config
+                cli_backend = resolve_cli_backend_config(cli_backend)
+
+            # Pass resolved backend to core Agent
+            super().__init__(*args, cli_backend=cli_backend, **kwargs)
+
+        def _is_protocol_instance(self, obj) -> bool:
+            """Check if object is a pre-resolved CliBackendProtocol instance (duck typing).
+
+            A CliBackendProtocol instance exposes both ``execute()`` and ``stream()``.
+            Factory callables are intentionally NOT treated as protocol instances here
+            so that wrapper-level normalization in ``resolve_cli_backend_config`` runs.
+            """
+            return hasattr(obj, "execute") and hasattr(obj, "stream")
+
+    return Agent
+
+
+_build_lock = threading.Lock()
+
+
+def __getattr__(name: str):
+    """Lazily build and cache the wrapper ``Agent`` class on first access.
+
+    This defers the eager ``praisonaiagents`` import (previously at module top)
+    so that reaching ``praisonai.agent`` no longer pays ~420 ms up front. The
+    class is built once, under a lock, and written back into the module's
+    ``__dict__`` so subsequent accesses resolve directly (bypassing
+    ``__getattr__``) and every caller observes the *same* class object — keeping
+    ``isinstance`` / ``type(...) is Agent`` checks consistent across threads.
+    """
+    if name == "Agent":
+        with _build_lock:
+            # Double-checked: another thread may have built it while we waited.
+            agent = globals().get("Agent")
+            if agent is None:
+                agent = _build_agent_class()
+                globals()["Agent"] = agent
+        return agent
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+# Export the wrapper Agent as the default for import from praisonai
+__all__ = ["Agent"]

praisonai-4.6.133/praisonai/version.py

@@ -0,0 +1 @@
+__version__ = "4.6.133"

{praisonai-4.6.131 → praisonai-4.6.133}/pyproject.toml

@@ -12,9 +12,9 @@ dependencies = [
     "rich>=13.7",
     "markdown>=3.5",
     "pyparsing>=3.0.0",
-    "praisonaiagents>=1.6.134",
-    "praisonai-code>=0.0.30",
-    "praisonai-bot>=0.0.15",
+    "praisonaiagents>=1.6.136",
+    "praisonai-code>=0.0.32",
+    "praisonai-bot>=0.0.17",
     "python-dotenv>=0.19.0",
     "litellm>=1.83.14,<2",
     "PyYAML>=6.0",

praisonai-4.6.131/praisonai/agent.py

@@ -1,53 +0,0 @@
-"""Wrapper Agent class with CLI backend resolution support.
-
-This module provides a wrapper around praisonaiagents.Agent that handles
-CLI backend string resolution in the wrapper layer, maintaining proper
-dependency direction per AGENTS.md.
-"""
-
-from typing import Union, Optional, Any
-from praisonaiagents import Agent as CoreAgent
-
-
-class Agent(CoreAgent):
-    """Agent wrapper with CLI backend string resolution support.
-    
-    This class extends the core Agent to handle CLI backend string resolution
-    in the wrapper layer, maintaining proper architectural separation between
-    core protocols and heavy implementations.
-    """
-    
-    def __init__(self, *args, cli_backend: Optional[Union[str, Any]] = None, **kwargs):
-        """Initialize Agent with CLI backend string resolution.
-        
-        Args:
-            *args: Positional arguments for core Agent
-            cli_backend: CLI backend for delegating full turns. Accepts:
-                - str: Backend ID ("claude-code", "codex-cli") - resolved in wrapper
-                - dict: Backend config {"id": "claude-code", "overrides": {...}}
-                - CliBackendProtocol: Pre-resolved backend instance
-                - callable: Factory function returning CliBackendProtocol
-                - None: No CLI backend
-            **kwargs: Keyword arguments for core Agent
-        """
-        # Deprecation warning will be emitted by the core Agent class
-        # Resolve CLI backend configuration using unified resolver
-        if cli_backend is not None and not self._is_protocol_instance(cli_backend):
-            from .cli_backends import resolve_cli_backend_config
-            cli_backend = resolve_cli_backend_config(cli_backend)
-        
-        # Pass resolved backend to core Agent
-        super().__init__(*args, cli_backend=cli_backend, **kwargs)
-    
-    def _is_protocol_instance(self, obj) -> bool:
-        """Check if object is a pre-resolved CliBackendProtocol instance (duck typing).
-
-        A CliBackendProtocol instance exposes both ``execute()`` and ``stream()``.
-        Factory callables are intentionally NOT treated as protocol instances here
-        so that wrapper-level normalization in ``resolve_cli_backend_config`` runs.
-        """
-        return hasattr(obj, "execute") and hasattr(obj, "stream")
-
-
-# Export the wrapper Agent as the default for import from praisonai
-__all__ = ["Agent"]

praisonai-4.6.131/praisonai/version.py

@@ -1 +0,0 @@
-__version__ = "4.6.131"