PraisonAI 4.6.104__tar.gz → 4.6.108__tar.gz

{praisonai-4.6.104 → praisonai-4.6.108}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.6.104
+Version: 4.6.108
 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,8 +11,8 @@ 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.104
-Requires-Dist: praisonai-code
+Requires-Dist: praisonaiagents>=1.6.108
+Requires-Dist: praisonai-code>=0.0.6
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm<2,>=1.83.14
 Requires-Dist: PyYAML>=6.0
@@ -36,6 +36,12 @@ Requires-Dist: fastapi>=0.115.0; extra == "os"
 Requires-Dist: uvicorn>=0.34.0; extra == "os"
 Requires-Dist: PyJWT>=2.8.0; extra == "os"
 Requires-Dist: sse-starlette>=1.6.0; extra == "os"
+Provides-Extra: gateway
+Requires-Dist: fastapi>=0.115.0; extra == "gateway"
+Requires-Dist: uvicorn>=0.34.0; extra == "gateway"
+Requires-Dist: sse-starlette>=1.6.0; extra == "gateway"
+Requires-Dist: websockets>=12.0; extra == "gateway"
+Requires-Dist: watchdog>=3.0.0; extra == "gateway"
 Provides-Extra: agentops
 Requires-Dist: agentops>=0.3.12; extra == "agentops"
 Provides-Extra: langfuse
@@ -123,6 +129,7 @@ Requires-Dist: fastapi>=0.115.0; extra == "all"
 Requires-Dist: uvicorn>=0.34.0; extra == "all"
 Requires-Dist: sse-starlette>=1.6.0; extra == "all"
 Requires-Dist: websockets>=12.0; extra == "all"
+Requires-Dist: watchdog>=3.0.0; extra == "all"
 Requires-Dist: tavily-python==0.5.0; extra == "all"
 Requires-Dist: crawl4ai>=0.7.0; extra == "all"
 Requires-Dist: playwright>=1.47.0; extra == "all"

{praisonai-4.6.104 → praisonai-4.6.108}/PraisonAI.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.6.104
+Version: 4.6.108
 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,8 +11,8 @@ 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.104
-Requires-Dist: praisonai-code
+Requires-Dist: praisonaiagents>=1.6.108
+Requires-Dist: praisonai-code>=0.0.6
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm<2,>=1.83.14
 Requires-Dist: PyYAML>=6.0
@@ -36,6 +36,12 @@ Requires-Dist: fastapi>=0.115.0; extra == "os"
 Requires-Dist: uvicorn>=0.34.0; extra == "os"
 Requires-Dist: PyJWT>=2.8.0; extra == "os"
 Requires-Dist: sse-starlette>=1.6.0; extra == "os"
+Provides-Extra: gateway
+Requires-Dist: fastapi>=0.115.0; extra == "gateway"
+Requires-Dist: uvicorn>=0.34.0; extra == "gateway"
+Requires-Dist: sse-starlette>=1.6.0; extra == "gateway"
+Requires-Dist: websockets>=12.0; extra == "gateway"
+Requires-Dist: watchdog>=3.0.0; extra == "gateway"
 Provides-Extra: agentops
 Requires-Dist: agentops>=0.3.12; extra == "agentops"
 Provides-Extra: langfuse
@@ -123,6 +129,7 @@ Requires-Dist: fastapi>=0.115.0; extra == "all"
 Requires-Dist: uvicorn>=0.34.0; extra == "all"
 Requires-Dist: sse-starlette>=1.6.0; extra == "all"
 Requires-Dist: websockets>=12.0; extra == "all"
+Requires-Dist: watchdog>=3.0.0; extra == "all"
 Requires-Dist: tavily-python==0.5.0; extra == "all"
 Requires-Dist: crawl4ai>=0.7.0; extra == "all"
 Requires-Dist: playwright>=1.47.0; extra == "all"

{praisonai-4.6.104 → praisonai-4.6.108}/PraisonAI.egg-info/SOURCES.txt

@@ -96,6 +96,7 @@ praisonai/bots/_protocol_mixin.py
 praisonai/bots/_rate_limit.py
 praisonai/bots/_registry.py
 praisonai/bots/_relay_adapter.py
+praisonai/bots/_reliability.py
 praisonai/bots/_reset_policy.py
 praisonai/bots/_resilience.py
 praisonai/bots/_run_control.py
@@ -168,13 +169,17 @@ praisonai/claw/default_app.py
 praisonai/cli/__init__.py
 praisonai/cli/_paths.py
 praisonai/cli/_shim.py
+praisonai/cli/_warnings.py
 praisonai/cli/app.py
 praisonai/cli/approval_backend.py
 praisonai/cli/branding.py
 praisonai/cli/config_loader.py
+praisonai/cli/fallback_schema.py
 praisonai/cli/langfuse_client.py
 praisonai/cli/main.py
 praisonai/cli/schedule_cli.py
+praisonai/cli/schema_provider.py
+praisonai/cli/unified_schema.py
 praisonai/cli/commands/__init__.py
 praisonai/cli/commands/acp.py
 praisonai/cli/commands/agent.py

{praisonai-4.6.104 → praisonai-4.6.108}/PraisonAI.egg-info/requires.txt

@@ -1,8 +1,8 @@
 rich>=13.7
 markdown>=3.5
 pyparsing>=3.0.0
-praisonaiagents>=1.6.104
-praisonai-code
+praisonaiagents>=1.6.108
+praisonai-code>=0.0.6
 python-dotenv>=0.19.0
 litellm<2,>=1.83.14
 PyYAML>=6.0
@@ -32,6 +32,7 @@ fastapi>=0.115.0
 uvicorn>=0.34.0
 sse-starlette>=1.6.0
 websockets>=12.0
+watchdog>=3.0.0
 tavily-python==0.5.0
 crawl4ai>=0.7.0
 playwright>=1.47.0
@@ -152,6 +153,13 @@ boto3>=1.35.0
 langflow>=1.0.0
 requests>=2.31.0
 
+[gateway]
+fastapi>=0.115.0
+uvicorn>=0.34.0
+sse-starlette>=1.6.0
+websockets>=12.0
+watchdog>=3.0.0
+
 [google-adk]
 praisonai-frameworks[google-adk]>=0.1.8
 praisonai-tools>=0.1.0

{praisonai-4.6.104 → praisonai-4.6.108}/praisonai/__init__.py

@@ -153,8 +153,8 @@ def __getattr__(name):
     elif name == 'run_integrated_gateway':
         from .integration.gateway_host import run_integrated_gateway
         return run_integrated_gateway
-    elif name == 'AgentApp':
-        # Silent alias for AgentOS (backward compatibility)
+    elif name in ('AgentOS', 'AgentApp'):
+        # AgentApp is a silent alias for AgentOS (backward compatibility)
         from .app import AgentOS
         return AgentOS
     elif name in ('ManagedAgent', 'ManagedAgentIntegration'):

{praisonai-4.6.104 → praisonai-4.6.108}/praisonai/__main__.py

@@ -116,7 +116,12 @@ def _run_typer(argv):
 
 
 def _run_legacy(argv):
-    """Dispatch to the legacy argparse CLI (prompts, YAML, deprecated flags)."""
+    """Dispatch to the legacy argparse CLI (prompts, YAML, deprecated flags).
+
+    Wrapper-enhanced: multi-framework YAML and ``--framework crewai`` paths load
+    framework adapters via ``praisonai_code._wrapper_bridge`` (requires
+    ``pip install praisonai``). Typer hot path remains in ``_run_typer``.
+    """
     from praisonai.cli.main import PraisonAI
 
     original = sys.argv

{praisonai-4.6.104 → praisonai-4.6.108}/praisonai/_dev/parity/docs_generator.py

@@ -195,7 +195,6 @@ PYTHON_DOC_ORPHAN_EXCLUSIONS = frozenset({
 DOC_FEATURE_CATEGORY_ALIASES = {
     'Callbacks': 'Hooks',
     'Middleware': 'Hooks',
-    'Vector Store': 'Knowledge',
     'Token Management': 'Context Management',
     'Jobs': 'Workflows',
     'Chat': 'Agent',
@@ -377,7 +376,9 @@ class DocsParityGenerator:
     def _calculate_category_parity(
         self,
         feature_groups: Dict[str, List[str]],
-        doc_groups: Dict[str, tuple[List[str], int]]
+        doc_groups: Dict[str, tuple[List[str], int]],
+        *,
+        apply_python_doc_rules: bool = False,
     ) -> tuple[DocsParitySummary, List[CategoryParity]]:
         """Calculate parity at category level, grouped by display name."""
         # Convert prefix-based groups to display-name-based groups
@@ -398,9 +399,10 @@ class DocsParityGenerator:
                 if prefix == 'other':
                     continue
                 display_name = FEATURE_CATEGORIES.get(prefix, prefix.title())
-                if display_name in PYTHON_DOC_ORPHAN_EXCLUSIONS:
-                    continue
-                display_name = DOC_FEATURE_CATEGORY_ALIASES.get(display_name, display_name)
+                if apply_python_doc_rules:
+                    if display_name in PYTHON_DOC_ORPHAN_EXCLUSIONS:
+                        continue
+                    display_name = DOC_FEATURE_CATEGORY_ALIASES.get(display_name, display_name)
                 if display_name not in result:
                     result[display_name] = ([], 0)
                 existing_names, existing_lines = result[display_name]
@@ -466,7 +468,9 @@ class DocsParityGenerator:
         doc_groups = self._group_docs(docs)
         
         # Calculate parity
-        summary, categories = self._calculate_category_parity(feature_groups, doc_groups)
+        summary, categories = self._calculate_category_parity(
+            feature_groups, doc_groups, apply_python_doc_rules=True
+        )
         
         # Build category lists - stubs are separate from documented
         documented = [c for c in categories if c.has_features and c.has_docs and not c.is_stub]

praisonai-4.6.108/praisonai/_framework_availability.py

@@ -0,0 +1,14 @@
+"""Backward-compatibility shim for :mod:`praisonai._framework_availability`.
+
+The implementation moved to :mod:`praisonai_code._framework_availability` (C7).
+"""
+
+import sys as _sys
+
+from praisonai._bootstrap import ensure_praisonai_code
+
+ensure_praisonai_code()
+
+import praisonai_code._framework_availability as _impl
+
+_sys.modules[__name__] = _impl

praisonai-4.6.108/praisonai/_safe_loader.py

@@ -0,0 +1,14 @@
+"""Backward-compatibility shim for :mod:`praisonai._safe_loader`.
+
+The implementation moved to :mod:`praisonai_code._safe_loader` (C7).
+"""
+
+import sys as _sys
+
+from praisonai._bootstrap import ensure_praisonai_code
+
+ensure_praisonai_code()
+
+import praisonai_code._safe_loader as _impl
+
+_sys.modules[__name__] = _impl

{praisonai-4.6.104 → praisonai-4.6.108}/praisonai/agents_generator.py

@@ -205,11 +205,15 @@ def sanitize_agent_name_for_autogen_v4(name):
     return sanitized
 
 def _resolve_yaml_cli_backend(cli_backend_config, logger):
-    """Resolve a YAML ``cli_backend`` field to a CliBackendProtocol instance.
-    Deprecated wrapper. Use praisonai.cli_backends.resolve_cli_backend_config directly.
-    """
-    from praisonai.cli_backends import resolve_cli_backend_config
-    return resolve_cli_backend_config(cli_backend_config)
+    """Resolve a YAML ``cli_backend`` field to a CliBackendProtocol instance."""
+    if cli_backend_config is None:
+        return None
+    try:
+        from praisonai.cli_backends import resolve_cli_backend_config
+        return resolve_cli_backend_config(cli_backend_config)
+    except (ImportError, ValueError, TypeError) as exc:
+        logger.warning("Failed to resolve cli_backend %r: %s", cli_backend_config, exc)
+        return None
 
 
 class AgentsGenerator:

{praisonai-4.6.104 → praisonai-4.6.108}/praisonai/bots/_protocol_mixin.py

@@ -508,6 +508,52 @@ def fire_schedule_trigger(
         logger.debug(f"SCHEDULE_TRIGGER hook error (non-fatal): {e}")
 
 
+def fire_job_completed(
+    runner: Any,
+    job_id: str,
+    status: str,
+    *,
+    result: Any = None,
+    error: Optional[str] = None,
+    deliver: str = "",
+    platform: str = "",
+    chat_id: str = "",
+    thread_id: str = "",
+    session_id: str = "",
+    agent_name: str = "background",
+) -> None:
+    """Fire JOB_COMPLETED hook when a background job reaches a terminal state.
+
+    Best-effort and non-fatal: an observability/delivery plugin may subscribe
+    to this to react to background completion, but delivery itself is routed by
+    the gateway's ``on_job_complete`` callback (see :class:`BotOS`).
+    """
+    if runner is None:
+        return
+    try:
+        from praisonaiagents.hooks.types import HookEvent
+        from praisonaiagents.hooks.events import JobCompletedInput
+
+        event_input = JobCompletedInput(
+            session_id=session_id,
+            cwd=os.getcwd(),
+            event_name=HookEvent.JOB_COMPLETED,
+            timestamp=str(time.time()),
+            agent_name=agent_name,
+            job_id=job_id,
+            status=status,
+            result=result,
+            error=error,
+            deliver=deliver,
+            platform=platform,
+            chat_id=chat_id,
+            thread_id=thread_id,
+        )
+        _emit(runner, HookEvent.JOB_COMPLETED, event_input)
+    except Exception as e:
+        logger.debug(f"JOB_COMPLETED hook error (non-fatal): {e}")
+
+
 def fire_session_start(
     runner: Any,
     session_id: str,

praisonai-4.6.108/praisonai/bots/_reliability.py

@@ -0,0 +1,190 @@
+"""
+Gateway reliability presets (Issue #2531).
+
+The gateway ships strong reliability building blocks — a durable inbound
+journal (default-on at the session level), a durable outbound outbox, gateway
+-wide admission control, and graceful-shutdown draining — but the two strongest
+lifecycle knobs (graceful drain and inbound admission) are individually opt-in.
+An operator running the gateway the "obvious" way therefore silently gets a
+no-backpressure deployment that cuts in-flight turns on restart.
+
+This module resolves a single, discoverable ``reliability`` preset onto the
+already-existing :class:`BotOS` constructor arguments so the happy path is
+production-grade in one switch, while explicit fields still win.
+
+Profiles
+--------
+``"production"``
+    Graceful drain (15s window), inbound admission with a CPU-scaled
+    concurrency ceiling and a bounded fair wait queue.
+``"default"`` / ``None``
+    A sane, small graceful-drain window (5s) so a restart doesn't cut
+    in-flight turns, but no admission ceiling (unbounded, legacy dispatch).
+    Durable inbound journal remains on by default (session level).
+``"off"``
+    Today's immediate-teardown behaviour: no drain, no admission.
+
+Precedence
+----------
+Explicit constructor fields always override the preset. A caller passing
+``drain_timeout=`` / ``max_concurrent_runs=`` / ``admission_policy=`` keeps
+exactly that value; the preset only fills in the fields left unset.
+"""
+
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass
+from typing import Optional
+
+# Sane default graceful-drain window (seconds) applied when neither a preset
+# nor an explicit ``drain_timeout`` selects one. Small enough to keep restarts
+# snappy, long enough that a mid-turn reply is not cut on a rolling deploy.
+_DEFAULT_DRAIN_SECONDS = 5.0
+
+# Graceful-drain window for the ``production`` preset.
+_PRODUCTION_DRAIN_SECONDS = 15.0
+
+# Bounded wait-queue depth for the ``production`` preset — absorbs short bursts
+# without letting the queue grow unbounded.
+_PRODUCTION_QUEUE_DEPTH = 32
+
+_KNOWN_PROFILES = ("production", "default", "off")
+
+
+def _cpu_scaled_ceiling() -> int:
+    """A conservative CPU-scaled default concurrency ceiling.
+
+    Agent turns are latency-bound (provider calls) rather than CPU-bound, so we
+    allow several turns per core while keeping a sane floor/ceiling so a burst
+    can't fan out unboundedly.
+    """
+    try:
+        cpus = os.cpu_count() or 2
+    except Exception:  # pragma: no cover — defensive
+        cpus = 2
+    return max(4, min(32, cpus * 4))
+
+
+@dataclass(frozen=True)
+class ResolvedReliability:
+    """The concrete knobs a reliability preset resolves to.
+
+    ``None`` fields mean "leave the constructor default / explicit value in
+    place"; non-``None`` fields are the preset-supplied values that fill unset
+    constructor arguments.
+    """
+
+    drain_timeout: Optional[float]
+    max_concurrent_runs: int
+    queue_depth: int
+    overflow_policy: str
+
+
+def normalize_reliability(reliability: Optional[str]) -> Optional[str]:
+    """Normalise a reliability value to a known profile name (or ``None``).
+
+    Accepts ``None`` (unset → the ``default`` posture) and is case/space
+    insensitive. Raises ``ValueError`` on an unknown profile so a typo fails
+    fast rather than silently degrading robustness.
+    """
+    if reliability is None:
+        return None
+    if not isinstance(reliability, str):
+        raise ValueError(
+            f"reliability must be a string profile name, got {reliability!r}"
+        )
+    name = reliability.strip().lower()
+    if name in ("", "none"):
+        return None
+    if name not in _KNOWN_PROFILES:
+        raise ValueError(
+            f"unknown reliability profile {reliability!r}; "
+            f"expected one of {', '.join(_KNOWN_PROFILES)}"
+        )
+    return name
+
+
+def resolve_reliability(
+    reliability: Optional[str],
+    *,
+    drain_timeout: Optional[float] = None,
+    max_concurrent_runs: int = 0,
+    queue_depth: int = 0,
+    overflow_policy: str = "reject",
+    admission_policy: Optional[object] = None,
+) -> ResolvedReliability:
+    """Compose a reliability preset with explicit constructor overrides.
+
+    Args:
+        reliability: Profile name (``"production"`` | ``"default"`` | ``"off"``)
+            or ``None`` for the default posture.
+        drain_timeout: Explicit graceful-drain window; ``None`` means "let the
+            preset decide".
+        max_concurrent_runs: Explicit admission ceiling; a positive value wins
+            over the preset. ``0`` means "let the preset decide".
+        queue_depth: Explicit bounded wait-queue depth (used with admission).
+        overflow_policy: Explicit overflow behaviour when the queue is full.
+        admission_policy: Explicit admission policy object; when supplied the
+            preset does not synthesise admission knobs (the policy wins).
+
+    Returns:
+        A :class:`ResolvedReliability` carrying the effective knobs.
+    """
+    profile = normalize_reliability(reliability)
+
+    # Start from the caller's explicit values (these always win).
+    resolved_drain = drain_timeout
+    resolved_max = int(max_concurrent_runs or 0)
+    resolved_queue = int(queue_depth or 0)
+    resolved_overflow = overflow_policy or "reject"
+
+    explicit_admission = admission_policy is not None or resolved_max > 0
+
+    if profile == "off":
+        # Preserve today's immediate-teardown / unbounded-dispatch behaviour,
+        # but never override an explicit opt-in.
+        if resolved_drain is None:
+            resolved_drain = 0.0
+        return ResolvedReliability(
+            drain_timeout=resolved_drain,
+            max_concurrent_runs=resolved_max,
+            queue_depth=resolved_queue,
+            overflow_policy=resolved_overflow,
+        )
+
+    if profile == "production":
+        if resolved_drain is None:
+            resolved_drain = _PRODUCTION_DRAIN_SECONDS
+        if not explicit_admission:
+            resolved_max = _cpu_scaled_ceiling()
+            if resolved_queue <= 0:
+                resolved_queue = _PRODUCTION_QUEUE_DEPTH
+            # A bounded queue is the production-safe default; only fall back to
+            # plain reject when the caller has said so explicitly.
+            if overflow_policy == "reject":
+                resolved_overflow = "queue"
+        return ResolvedReliability(
+            drain_timeout=resolved_drain,
+            max_concurrent_runs=resolved_max,
+            queue_depth=resolved_queue,
+            overflow_policy=resolved_overflow,
+        )
+
+    # profile in (None, "default"): a sane small drain window so a restart does
+    # not cut in-flight turns, but no admission ceiling by default.
+    if resolved_drain is None:
+        resolved_drain = _DEFAULT_DRAIN_SECONDS
+    return ResolvedReliability(
+        drain_timeout=resolved_drain,
+        max_concurrent_runs=resolved_max,
+        queue_depth=resolved_queue,
+        overflow_policy=resolved_overflow,
+    )
+
+
+__all__ = [
+    "ResolvedReliability",
+    "normalize_reliability",
+    "resolve_reliability",
+]