PraisonAI 4.6.62__tar.gz → 4.6.64__tar.gz

{praisonai-4.6.62 → praisonai-4.6.64}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.6.62
+Version: 4.6.64
 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.62
+Requires-Dist: praisonaiagents>=1.6.64
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm<2,>=1.83.14
 Requires-Dist: PyYAML>=6.0

{praisonai-4.6.62 → praisonai-4.6.64}/PraisonAI.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.6.62
+Version: 4.6.64
 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.62
+Requires-Dist: praisonaiagents>=1.6.64
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm<2,>=1.83.14
 Requires-Dist: PyYAML>=6.0

{praisonai-4.6.62 → praisonai-4.6.64}/PraisonAI.egg-info/SOURCES.txt

@@ -12,6 +12,8 @@ praisonai/_approval_spec.py
 praisonai/_async_bridge.py
 praisonai/_entrypoint.py
 praisonai/_framework_availability.py
+praisonai/_lazy_cache.py
+praisonai/_lockmap.py
 praisonai/_logging.py
 praisonai/_registry.py
 praisonai/_safe_loader.py
@@ -68,6 +70,7 @@ praisonai/bots/_commands.py
 praisonai/bots/_config_schema.py
 praisonai/bots/_debounce.py
 praisonai/bots/_defaults.py
+praisonai/bots/_delivery.py
 praisonai/bots/_discord_approval.py
 praisonai/bots/_dlq.py
 praisonai/bots/_email_utils.py
@@ -75,6 +78,8 @@ praisonai/bots/_http_approval.py
 praisonai/bots/_ingress.py
 praisonai/bots/_mirror.py
 praisonai/bots/_pairing_ui.py
+praisonai/bots/_presentation_approval.py
+praisonai/bots/_presentation_renderer.py
 praisonai/bots/_protocol_mixin.py
 praisonai/bots/_rate_limit.py
 praisonai/bots/_registry.py
@@ -82,8 +87,10 @@ praisonai/bots/_resilience.py
 praisonai/bots/_run_control.py
 praisonai/bots/_session.py
 praisonai/bots/_slack_approval.py
+praisonai/bots/_status.py
 praisonai/bots/_streaming.py
 praisonai/bots/_telegram_approval.py
+praisonai/bots/_typing.py
 praisonai/bots/_typing_indicator.py
 praisonai/bots/_unknown_user.py
 praisonai/bots/_webhook_approval.py
@@ -91,6 +98,7 @@ praisonai/bots/_whatsapp_web_adapter.py
 praisonai/bots/agentmail.py
 praisonai/bots/bot.py
 praisonai/bots/botos.py
+praisonai/bots/delivery.py
 praisonai/bots/discord.py
 praisonai/bots/email.py
 praisonai/bots/linear.py
@@ -146,6 +154,7 @@ praisonai/claw/default_app.py
 praisonai/cli/__init__.py
 praisonai/cli/_paths.py
 praisonai/cli/app.py
+praisonai/cli/approval_backend.py
 praisonai/cli/branding.py
 praisonai/cli/config_loader.py
 praisonai/cli/fallback_schema.py
@@ -160,6 +169,7 @@ praisonai/cli/commands/acp.py
 praisonai/cli/commands/agents.py
 praisonai/cli/commands/app.py
 praisonai/cli/commands/audit.py
+praisonai/cli/commands/auth.py
 praisonai/cli/commands/batch.py
 praisonai/cli/commands/benchmark.py
 praisonai/cli/commands/bot.py
@@ -202,6 +212,7 @@ praisonai/cli/commands/onboard.py
 praisonai/cli/commands/package.py
 praisonai/cli/commands/pairing.py
 praisonai/cli/commands/paths.py
+praisonai/cli/commands/permissions.py
 praisonai/cli/commands/plugins.py
 praisonai/cli/commands/port.py
 praisonai/cli/commands/profile.py
@@ -234,8 +245,10 @@ praisonai/cli/commands/up.py
 praisonai/cli/commands/version.py
 praisonai/cli/commands/workflow.py
 praisonai/cli/configuration/__init__.py
+praisonai/cli/configuration/credentials.py
 praisonai/cli/configuration/loader.py
 praisonai/cli/configuration/paths.py
+praisonai/cli/configuration/resolver.py
 praisonai/cli/configuration/schema.py
 praisonai/cli/execution/__init__.py
 praisonai/cli/execution/core.py
@@ -362,6 +375,7 @@ praisonai/cli/features/doctor/checks/obs_checks.py
 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/selftest_checks.py
 praisonai/cli/features/doctor/checks/serve_checks.py
 praisonai/cli/features/doctor/checks/skills_checks.py
@@ -512,6 +526,7 @@ praisonai/gateway/auth.py
 praisonai/gateway/cookie_auth.py
 praisonai/gateway/exec_approval.py
 praisonai/gateway/gateway_approval.py
+praisonai/gateway/health_monitor.py
 praisonai/gateway/kanban_dispatcher.py
 praisonai/gateway/magic_link.py
 praisonai/gateway/origin_check.py
@@ -533,7 +548,6 @@ praisonai/inc/__init__.py
 praisonai/inc/config.py
 praisonai/inc/models.py
 praisonai/integration/__init__.py
-praisonai/integration/_legacy_handlers.py
 praisonai/integration/context_files.py
 praisonai/integration/gateway_host.py
 praisonai/integration/host_app.py
@@ -582,6 +596,7 @@ praisonai/kanban/models.py
 praisonai/kanban/paths.py
 praisonai/kanban/sqlite_store.py
 praisonai/llm/__init__.py
+praisonai/llm/credentials.py
 praisonai/llm/env.py
 praisonai/llm/registry.py
 praisonai/mcp_server/__init__.py

{praisonai-4.6.62 → praisonai-4.6.64}/PraisonAI.egg-info/requires.txt

@@ -1,7 +1,7 @@
 rich>=13.7
 markdown>=3.5
 pyparsing>=3.0.0
-praisonaiagents>=1.6.62
+praisonaiagents>=1.6.64
 python-dotenv>=0.19.0
 litellm<2,>=1.83.14
 PyYAML>=6.0

{praisonai-4.6.62 → praisonai-4.6.64}/praisonai/_async_bridge.py

@@ -16,7 +16,10 @@ T = TypeVar("T")
 
 _DEFAULT_TIMEOUT = float(os.environ.get("PRAISONAI_RUN_SYNC_TIMEOUT", "300"))
 
-class _BackgroundLoop:
+class AsyncBridge:
+    """Per-instance async runner. The module-level `run_sync()` keeps the
+    historical shared default; embedders/services should construct their own."""
+
     def __init__(self) -> None:
         self._loop: asyncio.AbstractEventLoop | None = None
         self._thread: threading.Thread | None = None
@@ -53,6 +56,34 @@ class _BackgroundLoop:
             loop = self._spawn_locked()
             return asyncio.run_coroutine_threadsafe(coro, loop)
 
+    def run_sync(self, coro: Awaitable[T], *, timeout: float | None = _DEFAULT_TIMEOUT) -> T:
+        try:
+            asyncio.get_running_loop()
+        except RuntimeError:
+            pass
+        else:
+            raise RuntimeError(
+                "run_sync() cannot be called from a running event loop"
+            )
+        fut = self.submit(coro)
+        try:
+            return fut.result(timeout=timeout)
+        except (TimeoutError, concurrent.futures.TimeoutError):
+            fut.cancel()
+            try:
+                fut.exception(timeout=1.0)
+            except (
+                TimeoutError,
+                concurrent.futures.TimeoutError,
+                asyncio.CancelledError,
+                FutureCancelledError,
+            ):
+                pass
+            raise
+        except BaseException:
+            fut.cancel()
+            raise
+
     def shutdown(self, timeout: float = 5.0) -> None:
         with self._lock:
             loop, thread = self._loop, self._thread
@@ -75,16 +106,17 @@ class _BackgroundLoop:
                 self._loop = None
                 self._thread = None
 
-_BG: "_BackgroundLoop | None" = None
-_BG_LOCK = threading.Lock()
+# Backwards-compatible module-level shared default:
+_DEFAULT_BRIDGE: AsyncBridge | None = None
+_DEFAULT_LOCK = threading.Lock()
 
-def _get_bg() -> "_BackgroundLoop":
-    global _BG
-    if _BG is None:
-        with _BG_LOCK:
-            if _BG is None:
-                _BG = _BackgroundLoop()
-    return _BG
+def _default_bridge() -> AsyncBridge:
+    global _DEFAULT_BRIDGE
+    if _DEFAULT_BRIDGE is None:
+        with _DEFAULT_LOCK:
+            if _DEFAULT_BRIDGE is None:
+                _DEFAULT_BRIDGE = AsyncBridge()
+    return _DEFAULT_BRIDGE
 
 
 def run_sync(coro: Awaitable[T], *, timeout: float | None = _DEFAULT_TIMEOUT) -> T:
@@ -106,44 +138,13 @@ def run_sync(coro: Awaitable[T], *, timeout: float | None = _DEFAULT_TIMEOUT) ->
         TimeoutError: If timeout is exceeded
         Any exception raised by the coroutine
     """
-    try:
-        asyncio.get_running_loop()
-    except RuntimeError:
-        pass
-    else:
-        raise RuntimeError(
-            "run_sync() cannot be called from a running event loop; "
-            "await the coroutine directly instead."
-        )
-
-    # Submit the coroutine atomically
-    fut = _get_bg().submit(coro)
-    
-    try:
-        return fut.result(timeout=timeout)
-    except (TimeoutError, concurrent.futures.TimeoutError):
-        # Propagate cancellation into the background loop so the underlying
-        # awaitable (DB query, HTTP call, subprocess wait) actually unwinds.
-        fut.cancel()
-        try:
-            # Give cancellation a short grace period to release resources.
-            fut.exception(timeout=1.0)
-        except (
-            TimeoutError,
-            concurrent.futures.TimeoutError,
-            asyncio.CancelledError,
-            FutureCancelledError,
-        ):
-            pass
-        raise
-    except BaseException:
-        # Ctrl-C / GeneratorExit / SystemExit must also cancel the bg task.
-        fut.cancel()
-        raise
+    return _default_bridge().run_sync(coro, timeout=timeout)
 
 
 def shutdown() -> None:
-    """Public hook for long-running server processes to stop the bridge cleanly."""
-    bg = _BG
-    if bg is not None:
-        bg.shutdown()
+    """Shut down ONLY the shared default bridge (not user-owned instances)."""
+    global _DEFAULT_BRIDGE
+    with _DEFAULT_LOCK:
+        if _DEFAULT_BRIDGE is not None:
+            _DEFAULT_BRIDGE.shutdown()
+            _DEFAULT_BRIDGE = None

praisonai-4.6.64/praisonai/_lazy_cache.py

@@ -0,0 +1,38 @@
+"""Single source of truth for thread-safe lazy loading of optional deps."""
+import threading
+from typing import Callable, Dict, Optional, TypeVar
+
+T = TypeVar("T")
+
+
+class LazyCache:
+    """Thread-safe double-checked lazy cache. Caches None for ImportError."""
+
+    def __init__(self) -> None:
+        self._cache: Dict[str, object] = {}
+        self._lock = threading.Lock()
+
+    def get(self, key: str, loader: Callable[[], T]) -> Optional[T]:
+        if key in self._cache:
+            return self._cache[key]  # type: ignore[return-value]
+        with self._lock:
+            if key in self._cache:
+                return self._cache[key]  # type: ignore[return-value]
+            try:
+                value: object = loader()
+            except ImportError:
+                value = None
+            self._cache[key] = value
+            return value  # type: ignore[return-value]
+
+    def reset(self, key: Optional[str] = None) -> None:
+        with self._lock:
+            if key is None:
+                self._cache.clear()
+            else:
+                self._cache.pop(key, None)
+
+
+_GLOBAL = LazyCache()
+lazy_get = _GLOBAL.get
+lazy_reset = _GLOBAL.reset

praisonai-4.6.64/praisonai/_lockmap.py

@@ -0,0 +1,86 @@
+"""Per-key asyncio.Lock map with bounded LRU eviction and optional TTL.
+
+Use this anywhere you need 'a lock per (user_id|chat_id|key)' instead of
+re-implementing the dict-of-Lock pattern.
+"""
+from __future__ import annotations
+import asyncio
+import time
+from collections import OrderedDict
+from typing import Hashable
+
+
+class LockMap:
+    """Asyncio-safe per-key asyncio.Lock map with automatic cleanup.
+    
+    Provides a lock per key with LRU eviction and TTL-based cleanup to prevent
+    unbounded memory growth in long-running applications.
+    
+    Note: Safe for use within a single asyncio event loop (cooperative
+    multitasking means no interleaving between non-awaited calls), but NOT
+    safe for concurrent access from multiple OS threads.
+    """
+
+    def __init__(self, *, max_entries: int = 10_000, ttl_seconds: float = 3600.0):
+        """Initialize LockMap with bounds.
+        
+        Args:
+            max_entries: Maximum number of locks to cache (LRU eviction)
+            ttl_seconds: Time-to-live for unused locks in seconds
+        """
+        self._locks: "OrderedDict[Hashable, tuple[asyncio.Lock, float]]" = OrderedDict()
+        self._max = max_entries
+        self._ttl = ttl_seconds
+
+    def get(self, key: Hashable) -> asyncio.Lock:
+        """Get or create a lock for the given key.
+        
+        Args:
+            key: The key to get a lock for
+            
+        Returns:
+            asyncio.Lock for the key
+        """
+        now = time.monotonic()
+        entry = self._locks.get(key)
+        if entry is not None:
+            lock, _ = entry
+            # Move to end (most recently used) and update timestamp
+            self._locks.move_to_end(key)
+            self._locks[key] = (lock, now)
+            return lock
+        
+        # Create new lock + insert + LRU/TTL evict
+        lock = asyncio.Lock()
+        self._locks[key] = (lock, now)
+        self._evict_stale(now)
+        return lock
+
+    def _evict_stale(self, now: float) -> None:
+        """Evict expired and excess entries."""
+        # Expire by TTL (only if not currently locked)
+        expired = [
+            k for k, (lock, ts) in self._locks.items()
+            if (now - ts) > self._ttl and not lock.locked()
+        ]
+        for k in expired:
+            self._locks.pop(k, None)
+        
+        # Cap by LRU (don't evict locks currently held)
+        while len(self._locks) > self._max:
+            k, (lock, _) = next(iter(self._locks.items()))
+            if lock.locked():
+                # Don't evict locks currently held; bump them to the end
+                self._locks.move_to_end(k)
+                # Continue trying to evict other unlocked entries
+                continue
+            self._locks.popitem(last=False)
+            break
+
+    def drop(self, key: Hashable) -> None:
+        """Manually remove a lock for the given key."""
+        self._locks.pop(key, None)
+
+    def size(self) -> int:
+        """Return current number of cached locks."""
+        return len(self._locks)

{praisonai-4.6.62 → praisonai-4.6.64}/praisonai/agent.py

@@ -30,6 +30,7 @@ class Agent(CoreAgent):
                 - 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