PraisonAI 4.6.151__tar.gz → 4.6.152__tar.gz

{praisonai-4.6.151 → praisonai-4.6.152}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.6.151
+Version: 4.6.152
 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,12 +11,13 @@ 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.154
-Requires-Dist: praisonai-code>=0.0.50
-Requires-Dist: praisonai-bot>=0.0.35
-Requires-Dist: praisonai-train>=0.0.6
-Requires-Dist: praisonai-browser>=0.0.3
-Requires-Dist: praisonai-mcp>=0.0.3
+Requires-Dist: praisonaiagents>=1.6.155
+Requires-Dist: praisonai-code>=0.0.51
+Requires-Dist: praisonai-bot>=0.0.36
+Requires-Dist: praisonai-train>=0.0.7
+Requires-Dist: praisonai-browser>=0.0.4
+Requires-Dist: praisonai-mcp>=0.0.4
+Requires-Dist: praisonai-sandbox>=0.0.2
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm<2,>=1.83.14
 Requires-Dist: PyYAML>=6.0
@@ -60,11 +61,11 @@ Requires-Dist: tavily-python==0.5.0; extra == "code"
 Requires-Dist: crawl4ai>=0.7.0; extra == "code"
 Requires-Dist: playwright>=1.47.0; extra == "code"
 Provides-Extra: sandbox
-Requires-Dist: sandlock>=0.1.0; extra == "sandbox"
+Requires-Dist: praisonai-sandbox[all]; extra == "sandbox"
 Provides-Extra: ssh
-Requires-Dist: asyncssh>=2.14.0; extra == "ssh"
+Requires-Dist: praisonai-sandbox[ssh]; extra == "ssh"
 Provides-Extra: modal
-Requires-Dist: modal>=0.64.0; extra == "modal"
+Requires-Dist: praisonai-sandbox[modal]; extra == "modal"
 Provides-Extra: daytona
 Provides-Extra: realtime
 Requires-Dist: aiui<0.4,>=0.3.121; extra == "realtime"

{praisonai-4.6.151 → praisonai-4.6.152}/PraisonAI.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PraisonAI
-Version: 4.6.151
+Version: 4.6.152
 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,12 +11,13 @@ 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.154
-Requires-Dist: praisonai-code>=0.0.50
-Requires-Dist: praisonai-bot>=0.0.35
-Requires-Dist: praisonai-train>=0.0.6
-Requires-Dist: praisonai-browser>=0.0.3
-Requires-Dist: praisonai-mcp>=0.0.3
+Requires-Dist: praisonaiagents>=1.6.155
+Requires-Dist: praisonai-code>=0.0.51
+Requires-Dist: praisonai-bot>=0.0.36
+Requires-Dist: praisonai-train>=0.0.7
+Requires-Dist: praisonai-browser>=0.0.4
+Requires-Dist: praisonai-mcp>=0.0.4
+Requires-Dist: praisonai-sandbox>=0.0.2
 Requires-Dist: python-dotenv>=0.19.0
 Requires-Dist: litellm<2,>=1.83.14
 Requires-Dist: PyYAML>=6.0
@@ -60,11 +61,11 @@ Requires-Dist: tavily-python==0.5.0; extra == "code"
 Requires-Dist: crawl4ai>=0.7.0; extra == "code"
 Requires-Dist: playwright>=1.47.0; extra == "code"
 Provides-Extra: sandbox
-Requires-Dist: sandlock>=0.1.0; extra == "sandbox"
+Requires-Dist: praisonai-sandbox[all]; extra == "sandbox"
 Provides-Extra: ssh
-Requires-Dist: asyncssh>=2.14.0; extra == "ssh"
+Requires-Dist: praisonai-sandbox[ssh]; extra == "ssh"
 Provides-Extra: modal
-Requires-Dist: modal>=0.64.0; extra == "modal"
+Requires-Dist: praisonai-sandbox[modal]; extra == "modal"
 Provides-Extra: daytona
 Provides-Extra: realtime
 Requires-Dist: aiui<0.4,>=0.3.121; extra == "realtime"

{praisonai-4.6.151 → praisonai-4.6.152}/PraisonAI.egg-info/SOURCES.txt

@@ -471,16 +471,7 @@ praisonai/replay/writer.py
 praisonai/runtime/__init__.py
 praisonai/runtime/__main__.py
 praisonai/sandbox/__init__.py
-praisonai/sandbox/_compat.py
 praisonai/sandbox/_registry.py
-praisonai/sandbox/_shell.py
-praisonai/sandbox/daytona.py
-praisonai/sandbox/docker.py
-praisonai/sandbox/e2b.py
-praisonai/sandbox/modal.py
-praisonai/sandbox/sandlock.py
-praisonai/sandbox/ssh.py
-praisonai/sandbox/subprocess.py
 praisonai/scheduler/__init__.py
 praisonai/scheduler/_base_scheduler.py
 praisonai/scheduler/_delivery.py

{praisonai-4.6.151 → praisonai-4.6.152}/PraisonAI.egg-info/requires.txt

@@ -1,12 +1,13 @@
 rich>=13.7
 markdown>=3.5
 pyparsing>=3.0.0
-praisonaiagents>=1.6.154
-praisonai-code>=0.0.50
-praisonai-bot>=0.0.35
-praisonai-train>=0.0.6
-praisonai-browser>=0.0.3
-praisonai-mcp>=0.0.3
+praisonaiagents>=1.6.155
+praisonai-code>=0.0.51
+praisonai-bot>=0.0.36
+praisonai-train>=0.0.7
+praisonai-browser>=0.0.4
+praisonai-mcp>=0.0.4
+praisonai-sandbox>=0.0.2
 python-dotenv>=0.19.0
 litellm<2,>=1.83.14
 PyYAML>=6.0
@@ -171,7 +172,7 @@ praisonai-tools>=0.1.0
 praisonai-mcp[all]
 
 [modal]
-modal>=0.64.0
+praisonai-sandbox[modal]
 
 [mongodb]
 pymongo>=4.6.0
@@ -216,10 +217,10 @@ ddgs>=9.0.0
 redis>=5.0.0
 
 [sandbox]
-sandlock>=0.1.0
+praisonai-sandbox[all]
 
 [ssh]
-asyncssh>=2.14.0
+praisonai-sandbox[ssh]
 
 [train]
 praisonai-train[llm]

{praisonai-4.6.151 → praisonai-4.6.152}/praisonai/_bootstrap.py

@@ -91,3 +91,19 @@ def ensure_praisonai_mcp() -> None:
         root = str(mcp_src)
         if root not in sys.path:
             sys.path.insert(0, root)
+
+
+def ensure_praisonai_sandbox() -> None:
+    """Ensure ``praisonai_sandbox`` can be imported in monorepo dev layouts."""
+    try:
+        import praisonai_sandbox  # noqa: F401
+        return
+    except ImportError:
+        pass
+
+    wrapper_src = Path(__file__).resolve().parents[1]  # .../src/praisonai
+    sandbox_src = wrapper_src.parent / "praisonai-sandbox"
+    if (sandbox_src / "praisonai_sandbox").is_dir():
+        root = str(sandbox_src)
+        if root not in sys.path:
+            sys.path.insert(0, root)

{praisonai-4.6.151 → praisonai-4.6.152}/praisonai/agents_generator.py

@@ -705,30 +705,40 @@ class AgentsGenerator:
         framework_name = self.framework or config.get('framework', 'praisonai')
         adapter = self._select_framework(framework_name, config)
         
-        # Validate framework availability
+        # Validate framework availability through the injected registry so a
+        # scoped/per-tenant adapter registered on this generator's registry is
+        # not rejected just because it is absent from the process default.
         from .framework_adapters.validators import assert_framework_available
-        assert_framework_available(adapter.name)
+        assert_framework_available(adapter.name, registry=self._adapter_registry)
         
         # Validate cli_backend compatibility
         self._validate_cli_backend_compatibility(config, adapter.name, adapter=adapter)
-        
-        # Initialize observability hooks
-        from .observability.hooks import init_observability
-        init_observability(adapter.name)
-        
-        # Run adapter setup hooks
-        adapter.setup(framework_tag=adapter.name)
-        
+
         # Update framework reference if resolution changed it
         self.framework = adapter.name
         self.framework_adapter = adapter
-        
+
+        # NB: adapter setup is intentionally NOT run here. The caller opens the
+        # observability_session (which owns init/finalize for every adapter) and
+        # then invokes _run_adapter_setup INSIDE that session, so setup events —
+        # and any setup/import failure — are recorded and finalized instead of
+        # slipping outside observability. See generate_crew_and_kickoff /
+        # agenerate_crew_and_kickoff.
         return {
             'adapter': adapter,
             'config': config,
             'topic': topic,
             'tools_dict': tools_dict,
         }
+
+    def _run_adapter_setup(self, adapter):
+        """Run an adapter's setup hooks.
+
+        Kept as a tiny seam so both the sync and async run paths execute setup
+        *inside* the observability_session, keeping init/setup/run/finalize
+        bracketed together for every adapter.
+        """
+        adapter.setup(framework_tag=adapter.name)
     
     def _build_tools_dict(self, config):
         """Shared tool resolution logic for sync and async paths."""
@@ -997,15 +1007,22 @@ class AgentsGenerator:
         prep = self._prepare_for_run(config)
         
         self.logger.info(f"Using framework: {prep['adapter'].name}")
-        return prep['adapter'].run(
-            prep['config'],
-            self.config_list,
-            prep['topic'],
-            tools_dict=prep['tools_dict'],
-            agent_callback=getattr(self, 'agent_callback', None),
-            task_callback=getattr(self, 'task_callback', None),
-            cli_config=getattr(self, 'cli_config', None),
-        )
+        # Own the observability lifecycle here so init and finalize are always
+        # paired for every adapter (the CM finalizes on success and error alike).
+        from .observability.hooks import observability_session
+        with observability_session(prep['adapter'].name):
+            # Run setup INSIDE the session so setup events and any setup/import
+            # failure are recorded and finalized, not dropped outside observability.
+            self._run_adapter_setup(prep['adapter'])
+            return prep['adapter'].run(
+                prep['config'],
+                self.config_list,
+                prep['topic'],
+                tools_dict=prep['tools_dict'],
+                agent_callback=getattr(self, 'agent_callback', None),
+                task_callback=getattr(self, 'task_callback', None),
+                cli_config=getattr(self, 'cli_config', None),
+            )
 
     async def _aload_config(self):
         """Async-safe config loading (blocking file I/O off the event loop)."""
@@ -1013,7 +1030,8 @@ class AgentsGenerator:
         return await asyncio.to_thread(self._load_config)
 
     async def _aprepare_for_run(self, config):
-        """Async-safe run preparation (heavy imports + adapter.setup() off the loop)."""
+        """Async-safe run preparation (heavy imports off the loop). Adapter setup
+        runs later, inside the observability_session (see agenerate_crew_and_kickoff)."""
         import asyncio
         return await asyncio.to_thread(self._prepare_for_run, config)
 
@@ -1032,15 +1050,24 @@ class AgentsGenerator:
         prep = await self._aprepare_for_run(config)
         
         self.logger.info(f"Using framework: {prep['adapter'].name}")
-        return await prep['adapter'].arun(
-            prep['config'],
-            self.config_list,
-            prep['topic'],
-            tools_dict=prep['tools_dict'],
-            agent_callback=getattr(self, 'agent_callback', None),
-            task_callback=getattr(self, 'task_callback', None),
-            cli_config=getattr(self, 'cli_config', None),
-        )
+        # Own the observability lifecycle here so init and finalize are always
+        # paired for every adapter (the CM finalizes on success and error alike).
+        import asyncio
+        from .observability.hooks import observability_session
+        with observability_session(prep['adapter'].name):
+            # Run setup INSIDE the session (off the event loop, as it may block)
+            # so setup events and any setup/import failure are recorded and
+            # finalized, not dropped outside observability.
+            await asyncio.to_thread(self._run_adapter_setup, prep['adapter'])
+            return await prep['adapter'].arun(
+                prep['config'],
+                self.config_list,
+                prep['topic'],
+                tools_dict=prep['tools_dict'],
+                agent_callback=getattr(self, 'agent_callback', None),
+                task_callback=getattr(self, 'task_callback', None),
+                cli_config=getattr(self, 'cli_config', None),
+            )
 
 
     def _build_yaml_workflow(self, config):

{praisonai-4.6.151 → praisonai-4.6.152}/praisonai/cli/features/sandbox_cli.py

@@ -15,6 +15,16 @@ from typing import Optional
 logger = logging.getLogger(__name__)
 
 
+def _ensure_backends():
+    """Bootstrap praisonai-sandbox before registry imports (fail loud if missing)."""
+    try:
+        from praisonai._bootstrap import ensure_praisonai_sandbox
+
+        ensure_praisonai_sandbox()
+    except ImportError:
+        pass
+
+
 class SandboxHandler:
     """Handler for sandbox CLI commands."""
     
@@ -39,6 +49,8 @@ class SandboxHandler:
             print("Error: Provide code via --code or --file")
             return
         
+        _ensure_backends()
+        
         if file:
             if not os.path.exists(file):
                 print(f"Error: File not found: {file}")
@@ -49,7 +61,7 @@ class SandboxHandler:
         try:
             from praisonaiagents.sandbox import ResourceLimits
             
-            from praisonai.sandbox._registry import SandboxRegistry
+            from praisonai_sandbox._registry import SandboxRegistry
             
             registry = SandboxRegistry.default()
             try:
@@ -59,7 +71,8 @@ class SandboxHandler:
                 print(
                     f"Error: sandbox '{sandbox_type}' is unavailable: {e}\n"
                     f"Available: {registry.list_names()}\n"
-                    f"To install the optional backend:  pip install \"praisonai[{sandbox_type}]\"\n"
+                    f"To install the optional backend:  pip install praisonai-sandbox[{sandbox_type}] "
+                    f"or pip install \"praisonai[sandbox]\"\n"
                     f"Or explicitly choose another sandbox:  --sandbox-type subprocess"
                 )
                 sys.exit(2)
@@ -110,10 +123,11 @@ class SandboxHandler:
             sandbox_type: Type of sandbox (subprocess, docker)
             image: Docker image to use
         """
+        _ensure_backends()
         try:
             from praisonaiagents.sandbox import ResourceLimits
             
-            from praisonai.sandbox._registry import SandboxRegistry
+            from praisonai_sandbox._registry import SandboxRegistry
             
             registry = SandboxRegistry.default()
             try:
@@ -123,7 +137,8 @@ class SandboxHandler:
                 print(
                     f"Error: sandbox '{sandbox_type}' is unavailable: {e}\n"
                     f"Available: {registry.list_names()}\n"
-                    f"To install the optional backend:  pip install \"praisonai[{sandbox_type}]\"\n"
+                    f"To install the optional backend:  pip install praisonai-sandbox[{sandbox_type}] "
+                    f"or pip install \"praisonai[sandbox]\"\n"
                     f"Or explicitly choose another sandbox:  --sandbox-type subprocess"
                 )
                 sys.exit(2)
@@ -174,21 +189,18 @@ class SandboxHandler:
         asyncio.run(run_shell())
     
     def status(self) -> None:
-        """Check sandbox availability."""
-        print("Sandbox Status:")
+        """Check sandbox backend availability."""
+        print("Sandbox backends:")
         print()
-        
-        print("Subprocess sandbox: Available")
-        
         try:
-            from praisonai.sandbox import DockerSandbox
-            sandbox = DockerSandbox()
-            if sandbox.is_available:
-                print("Docker sandbox: Available")
-            else:
-                print("Docker sandbox: Not available (Docker not running)")
-        except ImportError:
-            print("Docker sandbox: Not available (dependencies not installed)")
+            from praisonaiagents.sandbox import SandboxManager, SandboxConfig
+
+            manager = SandboxManager(SandboxConfig.subprocess())
+            for name, info in sorted(manager.get_available_types().items()):
+                flag = "Available" if info.get("available") else "Unavailable"
+                print(f"  {name}: {flag}")
+        except ImportError as exc:
+            print(f"  Error: {exc}")
 
 
 def handle_sandbox_command(args) -> None:
@@ -243,7 +255,7 @@ def add_sandbox_parser(subparsers) -> None:
     )
     run_parser.add_argument(
         "--type", "-t",
-        choices=["subprocess", "docker"],
+        choices=["subprocess", "docker", "daytona"],
         default="subprocess",
         help="Sandbox type (default: subprocess)",
     )
@@ -265,7 +277,7 @@ def add_sandbox_parser(subparsers) -> None:
     )
     shell_parser.add_argument(
         "--type", "-t",
-        choices=["subprocess", "docker"],
+        choices=["subprocess", "docker", "daytona"],
         default="subprocess",
         help="Sandbox type (default: subprocess)",
     )

{praisonai-4.6.151 → praisonai-4.6.152}/praisonai/framework_adapters/crewai_adapter.py

@@ -51,27 +51,23 @@ class CrewAIAdapter(BaseFrameworkAdapter):
         Returns:
             Execution result as string
         """
-        # Observability is initialized upstream (agents_generator._prepare_for_run);
-        # finalize on EVERY exit path with the correct status so sessions are
-        # never orphaned "in progress" on errors / cancellation. The guard starts
-        # before the lazy imports so an import failure still finalizes the session.
-        import sys as _sys
-        from ..observability.hooks import finalize_observability
-
-        try:
-            # Import CrewAI only when needed (availability already validated at CLI entry)
-            import os
-            from crewai import Agent, Task, Crew
-            from crewai.telemetry import Telemetry
-            from .._framework_availability import is_available
-
-            # Suppress crewai.cli.config logger (scoped to when CrewAI is actually used)
-            logging.getLogger('crewai.cli.config').setLevel(logging.ERROR)
-
-            # Disable CrewAI telemetry while constructing agents/tasks/crew. The
-            # class-level fallback is locked + reference counted, so concurrent
-            # runs cannot corrupt the Telemetry class during this window.
-            with scoped_telemetry_disable(Telemetry):
+        # Observability init/finalize is owned by the generator via the
+        # observability_session context manager, so the adapter no longer
+        # finalizes here — this keeps the lifecycle symmetric across every
+        # adapter and prevents double-finalize.
+        # Import CrewAI only when needed (availability already validated at CLI entry)
+        import os
+        from crewai import Agent, Task, Crew
+        from crewai.telemetry import Telemetry
+        from .._framework_availability import is_available
+
+        # Suppress crewai.cli.config logger (scoped to when CrewAI is actually used)
+        logging.getLogger('crewai.cli.config').setLevel(logging.ERROR)
+
+        # Disable CrewAI telemetry while constructing agents/tasks/crew. The
+        # class-level fallback is locked + reference counted, so concurrent
+        # runs cannot corrupt the Telemetry class during this window.
+        with scoped_telemetry_disable(Telemetry):
                 from ._config_builder import build_agent_specs
 
                 agents = {}
@@ -179,11 +175,4 @@ class CrewAIAdapter(BaseFrameworkAdapter):
                 result = f"### Task Output ###\n{response}"
 
                 return result
-        finally:
-            # Close observability session with status derived from exc state
-            status = "Failure" if _sys.exc_info()[0] is not None else "Success"
-            try:
-                finalize_observability(self.name, status=status)
-            except Exception as e:  # noqa: BLE001 -- telemetry must not crash the run
-                logger.error(f"Error finalizing observability: {e}")
     

{praisonai-4.6.151 → praisonai-4.6.152}/praisonai/framework_adapters/praisonai_adapter.py

@@ -430,14 +430,10 @@ class PraisonAIAdapter(BaseFrameworkAdapter):
         
         This uses AgentTeam.astart() instead of thread offloading for true async execution.
         """
-        # Observability is initialized upstream (agents_generator._prepare_for_run);
-        # finalize here on EVERY exit path with the correct status so sessions are
-        # never orphaned "in progress" on errors / cancellation. The guard starts
-        # before the lazy imports and runtime startup so any failure or
-        # cancellation there still finalizes the session.
-        import sys as _sys
-        from ..observability.hooks import finalize_observability
-
+        # Observability init/finalize is owned by the generator via the
+        # observability_session context manager, so the adapter no longer
+        # finalizes here — this keeps the lifecycle symmetric across every
+        # adapter and prevents double-finalize.
         interactive_runtime = None
         try:
             # Import PraisonAI components only when needed
@@ -470,13 +466,6 @@ class PraisonAIAdapter(BaseFrameworkAdapter):
             logger.info("PraisonAI async execution completed")
             return result
         finally:
-            # Close observability session with status derived from exc state
-            status = "Failure" if _sys.exc_info()[0] is not None else "Success"
-            try:
-                finalize_observability(self.name, status=status)
-            except Exception as e:  # noqa: BLE001 -- telemetry must not crash the run
-                logger.error(f"Error finalizing observability: {e}")
-
             # Cleanup InteractiveRuntime if it was started
             if interactive_runtime is not None:
                 try:

{praisonai-4.6.151 → praisonai-4.6.152}/praisonai/framework_adapters/registry.py

@@ -213,13 +213,18 @@ def list_available_frameworks() -> list[str]:
     return get_default_registry().list_available_frameworks()
 
 
-def get_install_hint(name: str) -> str:
+def get_install_hint(name: str, *, registry: Optional[FrameworkAdapterRegistry] = None) -> str:
     """Return install hint for a framework, consulting the adapter when registered.
 
     Falls back to ``pip install 'praisonai[<extra>]'`` when the adapter cannot
     be resolved (e.g. its dependencies are missing) or does not declare a hint.
+
+    Args:
+        name: Framework name to build the install hint for.
+        registry: Optional adapter registry to consult; defaults to the
+            process-default registry when omitted (DI-friendly).
     """
-    registry = get_default_registry()
+    registry = registry or get_default_registry()
     try:
         adapter = registry.create(name)
         hint = getattr(adapter, "install_hint", None)

praisonai-4.6.152/praisonai/framework_adapters/validators.py

@@ -0,0 +1,45 @@
+"""
+Framework availability validators.
+
+Provides early validation of framework availability to fail fast at CLI entry
+rather than inside run() methods after expensive setup work.
+"""
+
+from .registry import get_default_registry, get_install_hint
+
+
+def assert_framework_available(name: str, *, registry=None) -> None:
+    """
+    Raise ImportError immediately if the chosen framework is missing.
+
+    Args:
+        name: Framework name to validate
+        registry: Optional adapter registry to consult. When omitted, the
+            process-default registry is used. Passing the caller's injected
+            registry keeps DI intact so a scoped/per-tenant adapter is not
+            rejected just because it is absent from the process default.
+
+    Raises:
+        ImportError: If framework is not available with actionable install hint
+    """
+    registry = registry or get_default_registry()
+
+    if registry.is_available(name):
+        return
+
+    # A router/alias may resolve to a concrete adapter (e.g. ``autogen`` ->
+    # ``autogen_v2``) whose name is a built-in key that lives on the process
+    # default rather than a scoped/injected registry. Falling back to the
+    # default here keeps the DI seam (scoped adapters pass on the injected
+    # registry) without rejecting a resolved built-in that selection already
+    # accepted. The fallback is skipped when no registry was injected, since
+    # ``registry`` is then already the default.
+    default_registry = get_default_registry()
+    if registry is not default_registry and default_registry.is_available(name):
+        return
+
+    hint = get_install_hint(name, registry=registry)
+    raise ImportError(
+        f"Framework '{name}' was requested but is not installed.\n"
+        f"Install it with:\n    {hint}"
+    )

praisonai-4.6.152/praisonai/sandbox/__init__.py

@@ -0,0 +1,13 @@
+"""C13 shim: sandbox backends moved to ``praisonai_sandbox``.
+
+Old import paths (``praisonai.sandbox``, ``praisonai.sandbox.docker``) keep working
+and resolve to the same module objects as ``praisonai_sandbox.*``.
+"""
+
+from praisonai._bootstrap import ensure_praisonai_sandbox
+
+ensure_praisonai_sandbox()
+
+from praisonai.cli._shim import alias_package
+
+alias_package("praisonai.sandbox", "praisonai_sandbox")

praisonai-4.6.152/praisonai/sandbox/_registry.py

@@ -0,0 +1,13 @@
+"""C13 shim: ``praisonai.sandbox._registry`` → ``praisonai_sandbox._registry``."""
+
+from __future__ import annotations
+
+import sys
+
+from praisonai._bootstrap import ensure_praisonai_sandbox
+
+ensure_praisonai_sandbox()
+
+import praisonai_sandbox._registry as _reg
+
+sys.modules[__name__] = _reg