PraisonAI 4.7.10__tar.gz → 4.7.12__tar.gz

{praisonai-4.7.10 → praisonai-4.7.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.7.10
+Version: 4.7.12
 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,14 +11,14 @@ 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.7.8
-Requires-Dist: praisonai-code>=0.1.7
-Requires-Dist: praisonai-bot>=0.1.7
-Requires-Dist: praisonai-train>=0.1.7
-Requires-Dist: praisonai-browser>=0.1.7
-Requires-Dist: praisonai-mcp>=0.1.9
-Requires-Dist: praisonai-sandbox>=0.1.7
-Requires-Dist: praisonai-deploy>=0.1.7
+Requires-Dist: praisonaiagents>=1.7.10
+Requires-Dist: praisonai-code>=0.1.9
+Requires-Dist: praisonai-bot>=0.1.9
+Requires-Dist: praisonai-train>=0.1.9
+Requires-Dist: praisonai-browser>=0.1.9
+Requires-Dist: praisonai-mcp>=0.1.11
+Requires-Dist: praisonai-sandbox>=0.1.9
+Requires-Dist: praisonai-deploy>=0.1.9
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm<2,>=1.83.14
 Requires-Dist: PyYAML>=6.0
@@ -182,7 +182,7 @@ Requires-Dist: psycopg2-binary>=2.9.0; extra == "postgresql"
 Provides-Extra: dynamodb
 Requires-Dist: boto3>=1.35.0; extra == "dynamodb"
 Provides-Extra: valkey
-Requires-Dist: valkey-glide-sync>=2.3.1; extra == "valkey"
+Requires-Dist: valkey-glide-sync>=2.5.2; extra == "valkey"
 Provides-Extra: neon
 Requires-Dist: psycopg2-binary>=2.9.0; extra == "neon"
 Provides-Extra: turso
@@ -227,7 +227,6 @@ Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
 <a href="https://github.com/MervinPraison/PraisonAI"><img src="https://static.pepy.tech/badge/PraisonAI" alt="Total Downloads" /></a>
 <a href="https://github.com/MervinPraison/PraisonAI"><img src="https://img.shields.io/github/v/release/MervinPraison/PraisonAI" alt="Latest Stable Version" /></a>
 <a href="https://github.com/MervinPraison/PraisonAI"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License" /></a>
-<a href="https://registry.modelcontextprotocol.io/servers/io.github.MervinPraison/praisonai"><img src="https://img.shields.io/badge/MCP-Registry-blue" alt="MCP Registry" /></a>
 </p>
 
 <div align="center">

{praisonai-4.7.10 → praisonai-4.7.12}/PraisonAI.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.7.10
+Version: 4.7.12
 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,14 +11,14 @@ 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.7.8
-Requires-Dist: praisonai-code>=0.1.7
-Requires-Dist: praisonai-bot>=0.1.7
-Requires-Dist: praisonai-train>=0.1.7
-Requires-Dist: praisonai-browser>=0.1.7
-Requires-Dist: praisonai-mcp>=0.1.9
-Requires-Dist: praisonai-sandbox>=0.1.7
-Requires-Dist: praisonai-deploy>=0.1.7
+Requires-Dist: praisonaiagents>=1.7.10
+Requires-Dist: praisonai-code>=0.1.9
+Requires-Dist: praisonai-bot>=0.1.9
+Requires-Dist: praisonai-train>=0.1.9
+Requires-Dist: praisonai-browser>=0.1.9
+Requires-Dist: praisonai-mcp>=0.1.11
+Requires-Dist: praisonai-sandbox>=0.1.9
+Requires-Dist: praisonai-deploy>=0.1.9
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm<2,>=1.83.14
 Requires-Dist: PyYAML>=6.0
@@ -182,7 +182,7 @@ Requires-Dist: psycopg2-binary>=2.9.0; extra == "postgresql"
 Provides-Extra: dynamodb
 Requires-Dist: boto3>=1.35.0; extra == "dynamodb"
 Provides-Extra: valkey
-Requires-Dist: valkey-glide-sync>=2.3.1; extra == "valkey"
+Requires-Dist: valkey-glide-sync>=2.5.2; extra == "valkey"
 Provides-Extra: neon
 Requires-Dist: psycopg2-binary>=2.9.0; extra == "neon"
 Provides-Extra: turso
@@ -227,7 +227,6 @@ Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
 <a href="https://github.com/MervinPraison/PraisonAI"><img src="https://static.pepy.tech/badge/PraisonAI" alt="Total Downloads" /></a>
 <a href="https://github.com/MervinPraison/PraisonAI"><img src="https://img.shields.io/github/v/release/MervinPraison/PraisonAI" alt="Latest Stable Version" /></a>
 <a href="https://github.com/MervinPraison/PraisonAI"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License" /></a>
-<a href="https://registry.modelcontextprotocol.io/servers/io.github.MervinPraison/praisonai"><img src="https://img.shields.io/badge/MCP-Registry-blue" alt="MCP Registry" /></a>
 </p>
 
 <div align="center">

{praisonai-4.7.10 → praisonai-4.7.12}/PraisonAI.egg-info/requires.txt

@@ -1,14 +1,14 @@
 rich>=13.7
 markdown>=3.5
 pyparsing>=3.0.0
-praisonaiagents>=1.7.8
-praisonai-code>=0.1.7
-praisonai-bot>=0.1.7
-praisonai-train>=0.1.7
-praisonai-browser>=0.1.7
-praisonai-mcp>=0.1.9
-praisonai-sandbox>=0.1.7
-praisonai-deploy>=0.1.7
+praisonaiagents>=1.7.10
+praisonai-code>=0.1.9
+praisonai-bot>=0.1.9
+praisonai-train>=0.1.9
+praisonai-browser>=0.1.9
+praisonai-mcp>=0.1.11
+praisonai-sandbox>=0.1.9
+praisonai-deploy>=0.1.9
 python-dotenv>=0.19.0
 litellm<2,>=1.83.14
 PyYAML>=6.0
@@ -249,7 +249,7 @@ libsql-experimental>=0.0.50
 aiui<0.4,>=0.3.121
 
 [valkey]
-valkey-glide-sync>=2.3.1
+valkey-glide-sync>=2.5.2
 
 [xata]
 psycopg2-binary>=2.9.0

{praisonai-4.7.10 → praisonai-4.7.12}/README.md

@@ -12,7 +12,6 @@
 <a href="https://github.com/MervinPraison/PraisonAI"><img src="https://static.pepy.tech/badge/PraisonAI" alt="Total Downloads" /></a>
 <a href="https://github.com/MervinPraison/PraisonAI"><img src="https://img.shields.io/github/v/release/MervinPraison/PraisonAI" alt="Latest Stable Version" /></a>
 <a href="https://github.com/MervinPraison/PraisonAI"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License" /></a>
-<a href="https://registry.modelcontextprotocol.io/servers/io.github.MervinPraison/praisonai"><img src="https://img.shields.io/badge/MCP-Registry-blue" alt="MCP Registry" /></a>
 </p>
 
 <div align="center">

{praisonai-4.7.10 → praisonai-4.7.12}/praisonai/_api_auth.py

@@ -15,8 +15,11 @@ def build_api_key_middleware(api_key: str, public_paths: Optional[Iterable[str]]
         api_key: The expected API key; requests must present it via a
             ``Bearer`` ``Authorization`` header or ``X-API-Key`` header.
         public_paths: Paths that bypass authentication. Any request whose path
-            is in this set, or starts with ``/__praisonai__/``, is allowed
-            through without a token.
+            is in this set, or is exactly ``/__praisonai__/discovery`` (the
+            unauthenticated capability document), is allowed through without a
+            token. The discovery path is matched exactly -- never by prefix --
+            so a server whose ``api_prefix`` happens to sit under
+            ``/__praisonai__`` does not silently expose its routes.
 
     Imports of ``hmac``/``starlette`` are kept inside this function so callers
     stay lazy-import friendly.
@@ -26,11 +29,12 @@ def build_api_key_middleware(api_key: str, public_paths: Optional[Iterable[str]]
     from starlette.responses import JSONResponse
 
     public = set(public_paths or ())
+    public.add("/__praisonai__/discovery")
 
     class _APIKeyMiddleware(BaseHTTPMiddleware):
         async def dispatch(self, request, call_next):
             path = request.url.path
-            if path in public or path.startswith("/__praisonai__/"):
+            if path in public:
                 return await call_next(request)
             auth = request.headers.get("Authorization", "")
             header_key = request.headers.get("X-API-Key", "")

{praisonai-4.7.10 → praisonai-4.7.12}/praisonai/_async_bridge.py

@@ -307,6 +307,47 @@ def scoped_bridge(bridge: Optional[AsyncBridge] = None) -> Iterator[AsyncBridge]
             bridge.shutdown(permanent=True)
 
 
+@contextlib.asynccontextmanager
+async def async_scoped_bridge(
+    bridge: Optional[AsyncBridge] = None,
+) -> "contextlib.AbstractAsyncContextManager[AsyncBridge]":
+    """Async-safe sibling of :func:`scoped_bridge` for ``async def`` callers.
+
+    Identical binding semantics to :func:`scoped_bridge`, but the teardown of a
+    scope-owned bridge is offloaded to a worker thread with
+    :func:`asyncio.to_thread` so the blocking :meth:`AsyncBridge.shutdown`
+    (which waits up to ``timeout`` for in-flight tasks to cancel and then joins
+    the background thread) never runs on the caller's event loop. Using the sync
+    :func:`scoped_bridge` from inside an ``async def`` would park the loop thread
+    for up to ~10s on scope exit (normal, error, or cancellation) — the exact
+    "one stuck tenant stalls every other tenant" pathology this bridge exists to
+    prevent (see AGENTS.md §4.5, async-safe).
+
+    Args:
+        bridge: An existing bridge to bind. When ``None`` a fresh bridge is
+            created for the scope and shut down off-loop on exit. A caller-
+            provided bridge is left untouched (the caller owns its lifecycle).
+    """
+    owns = bridge is None
+    if bridge is None:
+        bridge = AsyncBridge()
+    token = _bridge_var.set(bridge)
+    try:
+        yield bridge
+    finally:
+        _bridge_var.reset(token)
+        if owns:
+            # Offload the blocking cancel+join teardown so it cannot pin the
+            # caller's event loop. ``permanent=True`` poisons the bridge so a
+            # context that copied the ContextVar inside this block cannot
+            # resurrect it after we exit. ``asyncio.shield`` keeps the teardown
+            # running to completion even when the surrounding scope is being
+            # cancelled, so we neither leak the loop+thread nor block the loop.
+            await asyncio.shield(
+                asyncio.to_thread(bridge.shutdown, permanent=True)
+            )
+
+
 def _shutdown_default() -> None:
     """Private process-exit hook: tear down the shared default bridge.
 
@@ -343,6 +384,37 @@ def run_sync(coro: Awaitable[T], *, timeout: "float | None | _Unset" = _UNSET) -
     return _default_bridge().run_sync(coro, timeout=timeout)
 
 
+def run_cli_coro(coro: Awaitable[T], *, timeout: "float | None | _Unset" = None) -> T:
+    """Preferred entry point for CLI subcommands running a coroutine.
+
+    Routes through the shared :class:`AsyncBridge` (via :func:`run_sync`) so
+    per-loop connection pools survive across calls, any embedder-installed
+    ``scoped_bridge()`` is honoured, and a fresh event loop is NOT spawned on
+    every invocation. This replaces bare ``asyncio.run(...)`` at CLI leaves,
+    which tears down the loop each call and breaks per-loop cached clients
+    (e.g. ``httpx.AsyncClient``) with ``RuntimeError: Event loop is closed``.
+
+    Timeout defaults to ``None`` (**unbounded**) to preserve the prior
+    ``asyncio.run(...)`` semantics these leaves replaced: CLI commands own their
+    own runtime (an interactive sandbox shell, a multi-artifact ``standardise``
+    run, or a long background job must not be aborted by the 300s ``run_sync``
+    default). Callers that want a deadline pass an explicit ``timeout=``.
+
+    Sync context  -> :func:`run_sync` on the shared background loop.
+    Async context -> ``RuntimeError``; the caller must ``await coro`` directly.
+    """
+    try:
+        asyncio.get_running_loop()
+    except RuntimeError:
+        return run_sync(coro, timeout=timeout)
+    with contextlib.suppress(Exception):
+        coro.close()  # type: ignore[attr-defined]
+    raise RuntimeError(
+        "run_cli_coro() cannot be called from within a running event loop; "
+        "await the coroutine directly instead."
+    )
+
+
 def run_sync_or_offload(
     coro: Awaitable[T],
     *,

{praisonai-4.7.10 → praisonai-4.7.12}/praisonai/_entrypoint.py

@@ -100,14 +100,9 @@ def run(agent_file: str,
     """
     from .agents_generator import AgentsGenerator
 
-    # Wire the built-in readers/retrievers/rerankers into the core-SDK
-    # registries so YAML/CLI declarations (e.g. `retriever: fusion`,
-    # `reranker: llm`) resolve. Idempotent + thread-safe, and register-only-if-
-    # absent: a custom adapter already registered under a built-in name (e.g. a
-    # multi-tenant host's own `fusion`) is preserved, never overwritten.
-    from .adapters import register_default_adapters
-    register_default_adapters()
-
+    # Adapter wiring (readers/retrievers/rerankers) is single-sourced in
+    # AgentsGenerator.__init__ so every launch path (CLI, serve, eval, Python)
+    # is covered identically.
     adapter, config_list = _resolve_run_inputs(framework)
     _apply_model_override(config_list, kwargs)
     cli_config = _merge_cli_config(cli_config, kwargs)
@@ -142,11 +137,11 @@ async def arun(agent_file: str,
 
     from .agents_generator import AgentsGenerator
 
-    # Wire the built-in readers/retrievers/rerankers into the core-SDK
-    # registries so YAML/CLI declarations resolve. Run off the event loop since
-    # registration performs lazy imports. Idempotent + thread-safe, and
-    # register-only-if-absent: a custom adapter already registered under a
-    # built-in name is preserved, never overwritten.
+    # Adapter wiring (readers/retrievers/rerankers) is single-sourced in
+    # AgentsGenerator.__init__. Pre-warm it off the caller's event loop here so
+    # the (lazy-import) registration does not run on the loop when the generator
+    # is constructed synchronously below. Idempotent: __init__ then hits the fast
+    # path. Every launch path is covered identically via __init__.
     from .adapters import register_default_adapters
     await asyncio.to_thread(register_default_adapters)
 
@@ -159,7 +154,8 @@ async def arun(agent_file: str,
 
     # Own the generator's lifecycle so its lazily-allocated tool-timeout
     # executor is released once the single run completes, instead of leaking
-    # daemon threads per call in long-lived async server workers.
+    # daemon threads per call in long-lived async server workers. Adapter wiring
+    # was pre-warmed above, so __init__ hits the fast path without blocking loop.
     with AgentsGenerator(
         agent_file=agent_file,
         framework=adapter.name,