PraisonAI 4.6.77__tar.gz → 4.6.82__tar.gz

{praisonai-4.6.77 → praisonai-4.6.82}/PKG-INFO

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

{praisonai-4.6.77 → praisonai-4.6.82}/PraisonAI.egg-info/PKG-INFO

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

{praisonai-4.6.77 → praisonai-4.6.82}/PraisonAI.egg-info/SOURCES.txt

@@ -63,10 +63,12 @@ praisonai/bots/__init__.py
 praisonai/bots/_ack.py
 praisonai/bots/_approval.py
 praisonai/bots/_approval_base.py
+praisonai/bots/_approval_store.py
 praisonai/bots/_auth.py
 praisonai/bots/_chunk.py
 praisonai/bots/_commands.py
 praisonai/bots/_config_schema.py
+praisonai/bots/_correlation.py
 praisonai/bots/_debounce.py
 praisonai/bots/_defaults.py
 praisonai/bots/_delivery.py
@@ -77,7 +79,10 @@ praisonai/bots/_email_utils.py
 praisonai/bots/_http_approval.py
 praisonai/bots/_identity.py
 praisonai/bots/_ingress.py
+praisonai/bots/_media.py
+praisonai/bots/_metrics.py
 praisonai/bots/_mirror.py
+praisonai/bots/_outbound_messenger.py
 praisonai/bots/_outbox.py
 praisonai/bots/_pairing_ui.py
 praisonai/bots/_presentation_approval.py
@@ -172,6 +177,7 @@ praisonai/cli/commands/acp.py
 praisonai/cli/commands/agent.py
 praisonai/cli/commands/agents.py
 praisonai/cli/commands/app.py
+praisonai/cli/commands/attach.py
 praisonai/cli/commands/audit.py
 praisonai/cli/commands/auth.py
 praisonai/cli/commands/batch.py
@@ -180,6 +186,7 @@ praisonai/cli/commands/bot.py
 praisonai/cli/commands/browser.py
 praisonai/cli/commands/call.py
 praisonai/cli/commands/chat.py
+praisonai/cli/commands/checkpoint.py
 praisonai/cli/commands/claw.py
 praisonai/cli/commands/code.py
 praisonai/cli/commands/command.py
@@ -187,6 +194,7 @@ praisonai/cli/commands/commit.py
 praisonai/cli/commands/completion.py
 praisonai/cli/commands/config.py
 praisonai/cli/commands/context.py
+praisonai/cli/commands/daemon.py
 praisonai/cli/commands/dashboard.py
 praisonai/cli/commands/debug.py
 praisonai/cli/commands/deploy.py
@@ -257,6 +265,8 @@ praisonai/cli/configuration/__init__.py
 praisonai/cli/configuration/config.schema.json
 praisonai/cli/configuration/credentials.py
 praisonai/cli/configuration/loader.py
+praisonai/cli/configuration/model_resolver.py
+praisonai/cli/configuration/oauth.py
 praisonai/cli/configuration/paths.py
 praisonai/cli/configuration/resolver.py
 praisonai/cli/configuration/schema.py
@@ -447,6 +457,7 @@ praisonai/cli/output/__init__.py
 praisonai/cli/output/console.py
 praisonai/cli/output/event_bridge.py
 praisonai/cli/session/__init__.py
+praisonai/cli/session/resume.py
 praisonai/cli/session/unified.py
 praisonai/cli/state/__init__.py
 praisonai/cli/state/identifiers.py
@@ -589,6 +600,7 @@ praisonai/integrations/__init__.py
 praisonai/integrations/_session_info.py
 praisonai/integrations/_tool_aliases.py
 praisonai/integrations/_unified_registry.py
+praisonai/integrations/backend_registry.py
 praisonai/integrations/base.py
 praisonai/integrations/claude_code.py
 praisonai/integrations/codex_cli.py
@@ -621,6 +633,7 @@ praisonai/kanban/paths.py
 praisonai/kanban/sqlite_store.py
 praisonai/llm/__init__.py
 praisonai/llm/catalogue.py
+praisonai/llm/config.py
 praisonai/llm/credentials.py
 praisonai/llm/env.py
 praisonai/llm/gateways.py
@@ -671,6 +684,7 @@ praisonai/persistence/orchestrator.py
 praisonai/persistence/registry.py
 praisonai/persistence/conversation/__init__.py
 praisonai/persistence/conversation/_sql_base.py
+praisonai/persistence/conversation/_sqlite_base.py
 praisonai/persistence/conversation/async_mysql.py
 praisonai/persistence/conversation/async_postgres.py
 praisonai/persistence/conversation/async_sqlite.py
@@ -749,6 +763,11 @@ praisonai/replay/player.py
 praisonai/replay/reader.py
 praisonai/replay/storage.py
 praisonai/replay/writer.py
+praisonai/runtime/__init__.py
+praisonai/runtime/__main__.py
+praisonai/runtime/client.py
+praisonai/runtime/descriptor.py
+praisonai/runtime/server.py
 praisonai/sandbox/__init__.py
 praisonai/sandbox/_compat.py
 praisonai/sandbox/_registry.py

{praisonai-4.6.77 → praisonai-4.6.82}/PraisonAI.egg-info/requires.txt

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

{praisonai-4.6.77 → praisonai-4.6.82}/praisonai/_async_bridge.py

@@ -6,6 +6,7 @@ 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
 import concurrent.futures
@@ -24,6 +25,10 @@ class AsyncBridge:
         self._loop: asyncio.AbstractEventLoop | None = None
         self._thread: threading.Thread | None = None
         self._lock = threading.Lock()
+        # Identity of the thread currently holding ``self._lock``. Set under the
+        # lock by ``get()``/``submit()`` so ``_spawn_locked()`` can verify the
+        # *caller* (not merely *someone*) owns the lock.
+        self._lock_owner: int | None = None
 
     def _spawn_locked(self) -> asyncio.AbstractEventLoop:
         """Create the loop+thread; caller must hold ``self._lock``.
@@ -31,11 +36,17 @@ class AsyncBridge:
         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
+        server processes should call :meth:`shutdown` explicitly to cancel
         in-flight tasks before process exit.
         """
-        # Create the loop+thread; caller must hold self._lock.
-        # The lock contract is now enforced structurally by submit() method.
+        # Enforce the "caller must hold the lock" contract. We compare the
+        # recorded lock owner against the current thread so the check detects
+        # both an unlocked lock *and* a lock held by a different thread (a bare
+        # non-blocking acquire could only prove the lock was free for *anyone*).
+        if self._lock_owner != threading.get_ident():
+            raise AssertionError(
+                "_spawn_locked() must be called while holding self._lock"
+            )
         if self._loop is None or self._loop.is_closed():
             self._loop = asyncio.new_event_loop()
             self._thread = threading.Thread(
@@ -48,13 +59,21 @@ class AsyncBridge:
 
     def get(self) -> asyncio.AbstractEventLoop:
         with self._lock:
-            return self._spawn_locked()
+            self._lock_owner = threading.get_ident()
+            try:
+                return self._spawn_locked()
+            finally:
+                self._lock_owner = None
 
     def submit(self, coro):
         """Atomically (re)spawn loop if needed and submit coro. Returns concurrent.futures.Future."""
         with self._lock:
-            loop = self._spawn_locked()
-            return asyncio.run_coroutine_threadsafe(coro, loop)
+            self._lock_owner = threading.get_ident()
+            try:
+                loop = self._spawn_locked()
+                return asyncio.run_coroutine_threadsafe(coro, loop)
+            finally:
+                self._lock_owner = None
 
     def run_sync(self, coro: Awaitable[T], *, timeout: float | None = _DEFAULT_TIMEOUT) -> T:
         try:
@@ -112,17 +131,41 @@ class AsyncBridge:
             if not loop.is_closed():
                 loop.close()
 
-# Backwards-compatible module-level shared default:
-_DEFAULT_BRIDGE: AsyncBridge | None = None
-_DEFAULT_LOCK = threading.Lock()
+# Backwards-compatible module-level shared default.
+#
+# The shared bridge's lifecycle is owned exclusively by the process (via the
+# ``atexit`` hook registered on first use). It is intentionally NOT exposed as a
+# public ``shutdown()`` on the module surface: in a multi-agent / multi-tenant
+# process every ``run_sync()`` caller shares this single loop+thread, so allowing
+# any one caller to tear it down would silently cancel in-flight work belonging
+# to every other agent/session. Embedders that need explicit lifecycle control
+# must construct and own their own :class:`AsyncBridge` instance and pass it via
+# dependency injection.
+
+# Single stable shared instance. It is created eagerly (cheap: no loop/thread is
+# spawned until the first ``run_sync()`` call) so the reference never has to be
+# rebound. Keeping the *same* object means callers that captured ``_BG`` always
+# observe its live state, and only the process-exit hook tears it down.
+_BG: AsyncBridge = AsyncBridge()
+
 
 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
+    return _BG
+
+
+def _shutdown_default() -> None:
+    """Private process-exit hook: tear down the shared default bridge.
+
+    Registered with :mod:`atexit`. This is the ONLY sanctioned way the shared
+    default is shut down; it is deliberately absent from the public module
+    surface so a single caller cannot terminate async work for the whole
+    process. Embedders needing explicit lifecycle control own their own
+    :class:`AsyncBridge` instance.
+    """
+    _BG.shutdown()
+
+
+atexit.register(_shutdown_default)
 
 
 def run_sync(coro: Awaitable[T], *, timeout: float | None = _DEFAULT_TIMEOUT) -> T:
@@ -145,12 +188,3 @@ def run_sync(coro: Awaitable[T], *, timeout: float | None = _DEFAULT_TIMEOUT) ->
         Any exception raised by the coroutine
     """
     return _default_bridge().run_sync(coro, timeout=timeout)
-
-
-def shutdown() -> None:
-    """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.77 → praisonai-4.6.82}/praisonai/_entrypoint.py

@@ -10,16 +10,8 @@ from typing import Any
 
 def _build_config_list() -> list[dict[str, Any]]:
     """Reuse the same env/keyfile resolution the CLI already performs."""
-    # Import LLM endpoint resolution from the same path the CLI uses
-    from praisonai.llm.env import resolve_llm_endpoint
-    ep = resolve_llm_endpoint()
-    
-    return [{
-        'model': ep.model,
-        'base_url': ep.base_url,
-        'api_key': ep.api_key,
-        'api_type': 'openai'        # AutoGen expects this field
-    }]
+    from praisonai.llm.config import build_config_list
+    return build_config_list()
 
 
 def run(agent_file: str,
@@ -30,19 +22,12 @@ def run(agent_file: str,
         cli_config: dict | None = None) -> str:
     """One-line Python entry point. Equivalent to `praisonai <agent_file>`."""
     from .agents_generator import AgentsGenerator
-    from ._framework_availability import is_available
+    from .framework_adapters.registry import get_default_registry
 
     if framework is None:
-        # Mirror the CLI default-resolution order
-        for candidate in ("crewai", "praisonaiagents", "autogen", "ag2"):
-            if is_available(candidate):
-                framework = "praisonai" if candidate == "praisonaiagents" else candidate
-                break
-        else:
-            raise RuntimeError(
-                "No supported framework installed. "
-                "Install one of: crewai, praisonaiagents, autogen, ag2."
-            )
+        # Single source of truth for default selection: the registry, which
+        # honours entry-point plugins as well as the built-in priority order.
+        framework = get_default_registry().pick_default()
     else:
         # Validate explicit framework like CLI does
         from .framework_adapters.validators import assert_framework_available
@@ -67,19 +52,12 @@ async def arun(agent_file: str,
                cli_config: dict | None = None) -> str:
     """Async equivalent of `run()` using native async framework adapters."""
     from .agents_generator import AgentsGenerator
-    from ._framework_availability import is_available
+    from .framework_adapters.registry import get_default_registry
 
     if framework is None:
-        # Mirror the CLI default-resolution order
-        for candidate in ("crewai", "praisonaiagents", "autogen", "ag2"):
-            if is_available(candidate):
-                framework = "praisonai" if candidate == "praisonaiagents" else candidate
-                break
-        else:
-            raise RuntimeError(
-                "No supported framework installed. "
-                "Install one of: crewai, praisonaiagents, autogen, ag2."
-            )
+        # Single source of truth for default selection: the registry, which
+        # honours entry-point plugins as well as the built-in priority order.
+        framework = get_default_registry().pick_default()
     else:
         # Validate explicit framework like CLI does
         from .framework_adapters.validators import assert_framework_available

{praisonai-4.6.77 → praisonai-4.6.82}/praisonai/agents_generator.py

@@ -4,6 +4,7 @@ import sys
 import os
 import inspect
 import logging
+import threading
 import re
 import keyword
 import difflib
@@ -18,6 +19,8 @@ from .version import __version__
 from .framework_adapters.base import FrameworkAdapter
 from .framework_adapters.registry import FrameworkAdapterRegistry, get_default_registry
 
+logger = logging.getLogger("praisonai.agents_generator")
+
 
 def _rich_print(*args, **kwargs):
     """Lazy alias for rich.print — pays the import cost only on first use."""
@@ -77,14 +80,72 @@ def __dir__():
 
 
 
+_TOOL_TIMEOUT_EXECUTOR = None
+# Eagerly initialised so concurrent first-callers always share one lock (and
+# therefore one executor); a lazily-created lock would itself race.
+_TOOL_TIMEOUT_EXECUTOR_LOCK = threading.Lock()
+_DEFAULT_TOOL_TIMEOUT_WORKERS = 32
+
+
+def _resolve_tool_timeout_workers():
+    """Resolve the timeout worker count, tolerating a bad env value.
+
+    A typo or non-positive ``PRAISONAI_TOOL_TIMEOUT_WORKERS`` must not crash
+    every timed tool call; we warn and fall back to the safe default instead.
+    """
+    raw = os.environ.get("PRAISONAI_TOOL_TIMEOUT_WORKERS")
+    if raw is None:
+        return _DEFAULT_TOOL_TIMEOUT_WORKERS
+    try:
+        workers = int(raw)
+    except (TypeError, ValueError):
+        logger.warning(
+            "Invalid PRAISONAI_TOOL_TIMEOUT_WORKERS=%r; using default of %d.",
+            raw, _DEFAULT_TOOL_TIMEOUT_WORKERS,
+        )
+        return _DEFAULT_TOOL_TIMEOUT_WORKERS
+    if workers < 1:
+        logger.warning(
+            "PRAISONAI_TOOL_TIMEOUT_WORKERS must be >= 1 (got %d); using default of %d.",
+            workers, _DEFAULT_TOOL_TIMEOUT_WORKERS,
+        )
+        return _DEFAULT_TOOL_TIMEOUT_WORKERS
+    return workers
+
+
+def _get_tool_timeout_executor():
+    """Lazily create a bounded, observable thread pool for sync tool timeouts.
+
+    Using a bounded pool (instead of unbounded bare daemon threads) means any
+    background work left running after a timeout is at least capped and named,
+    so operators can enumerate it rather than accumulating phantom threads.
+    """
+    global _TOOL_TIMEOUT_EXECUTOR
+    import concurrent.futures
+
+    with _TOOL_TIMEOUT_EXECUTOR_LOCK:
+        if _TOOL_TIMEOUT_EXECUTOR is None:
+            _TOOL_TIMEOUT_EXECUTOR = concurrent.futures.ThreadPoolExecutor(
+                max_workers=_resolve_tool_timeout_workers(),
+                thread_name_prefix="praisonai-tool-timeout",
+            )
+    return _TOOL_TIMEOUT_EXECUTOR
+
+
 def _wrap_with_timeout(tool, timeout_seconds: float):
-    """Enforce per-call timeout on a tool, sync or async, without
-    leaking the worker thread/task on timeout.
+    """Enforce a per-call timeout on a tool, sync or async.
+
+    For async tools the underlying task is cancelled on timeout. For sync tools
+    the call runs in a bounded thread pool; on timeout we best-effort cancel the
+    future and log a warning. Note: a synchronous call that has already started
+    cannot be forcibly interrupted, so background work may continue executing —
+    the returned payload flags this with ``background_work_may_continue``.
     """
     if timeout_seconds is None or timeout_seconds <= 0 or not callable(tool):
         return tool
     
     import asyncio
+    import concurrent.futures
     import functools
     import inspect
     import json
@@ -104,43 +165,27 @@ def _wrap_with_timeout(tool, timeout_seconds: float):
 
     @functools.wraps(tool)
     def _sync_wrapped(*args, **kwargs):
-        import queue
-        import threading
-
-        result_queue: queue.Queue[tuple[bool, object]] = queue.Queue(maxsize=1)
-
-        def _runner():
-            try:
-                result_queue.put((True, tool(*args, **kwargs)))
-            except BaseException as exc:
-                result_queue.put((False, exc))
-
-        # Daemon thread avoids blocking process shutdown if the tool call hangs.
-        worker = threading.Thread(target=_runner, daemon=True)
-        worker.start()
-        worker.join(timeout_seconds)
-
-        if worker.is_alive():
+        executor = _get_tool_timeout_executor()
+        future = executor.submit(tool, *args, **kwargs)
+        try:
+            return future.result(timeout=timeout_seconds)
+        except concurrent.futures.TimeoutError:
+            # Best-effort cancel; only effective if the future has not started.
+            # A started sync call cannot be interrupted, so warn operators that
+            # the worker may keep running (and its side effects may still occur).
+            cancelled = future.cancel()
+            logger.warning(
+                "Tool %r exceeded %.1fs (cancel=%s); worker may continue "
+                "executing in the background.",
+                getattr(tool, "__name__", repr(tool)),
+                timeout_seconds, cancelled,
+            )
             return json.dumps({
                 "error": "tool_timeout",
                 "tool": getattr(tool, "__name__", repr(tool)),
                 "timeout_seconds": timeout_seconds,
+                "background_work_may_continue": not cancelled,
             })
-
-        try:
-            success, payload = result_queue.get_nowait()
-        except queue.Empty:
-            # Defensive fallback: if the worker exits without publishing a result,
-            # avoid blocking indefinitely and surface an execution failure.
-            return json.dumps({
-                "error": "tool_execution_error",
-                "tool": getattr(tool, "__name__", repr(tool)),
-                "detail": "worker_exited_without_result",
-            })
-
-        if success:
-            return payload
-        raise payload
     return _sync_wrapped
 
 

{praisonai-4.6.77 → praisonai-4.6.82}/praisonai/api/agent_invoke.py

@@ -38,9 +38,9 @@ def _call_auth_disabled() -> bool:
     return os.getenv('PRAISONAI_CALL_AUTH', '').lower() == 'disabled'
 
 
-def _bind_host_from_request(request: Request) -> str:
-    host = getattr(getattr(request, 'url', None), 'hostname', None)
-    return host or os.getenv('PRAISONAI_CALL_BIND_HOST', '127.0.0.1')
+def _configured_bind_host() -> Optional[str]:
+    """Server bind address from env only — never trust client Host headers."""
+    return os.getenv('PRAISONAI_CALL_BIND_HOST')
 
 
 async def verify_token(
@@ -51,11 +51,14 @@ async def verify_token(
     if not FASTAPI_AVAILABLE:
         return
     if _call_auth_disabled():
-        bind_host = _bind_host_from_request(request)
-        if bind_host not in _LOCALHOST_HOSTS:
+        bind_host = _configured_bind_host()
+        if bind_host is None or bind_host not in _LOCALHOST_HOSTS:
             raise HTTPException(
                 status_code=503,
-                detail="PRAISONAI_CALL_AUTH=disabled is only permitted for localhost binding",
+                detail=(
+                    "PRAISONAI_CALL_AUTH=disabled is only permitted for localhost binding; "
+                    "set PRAISONAI_CALL_BIND_HOST to 127.0.0.1 when binding locally"
+                ),
             )
         warnings.warn(
             "PRAISONAI_CALL_AUTH=disabled bypasses authentication; "

{praisonai-4.6.77 → praisonai-4.6.82}/praisonai/api/call.py

@@ -372,7 +372,9 @@ def run_server(port: int, host: str = "127.0.0.1", use_public: bool = False):
     if host == "0.0.0.0" and not use_public:
         print("WARNING: Server is binding to all network interfaces (0.0.0.0). "
               "This exposes the service to your local network.")
-    
+
+    os.environ["PRAISONAI_CALL_BIND_HOST"] = host
+
     uvicorn.run(app, host=host, port=port, log_level="warning")
 
 def main(args=None):