Reclaim Stray Sandboxes

​

Quick Start

praisonai managed ps

No running sandboxes.

INSTANCE ID                PROVIDER   STATUS     UPTIME   IMAGE
------------------------------------------------------------------------------
docker_5afaa3bfa704        docker     running    42s      python:3.12-slim

1 running. Stop with: praisonai managed stop <instance-id>

# One
praisonai managed stop docker_5afaa3bfa704

# All (across every provider)
praisonai managed stop --all

# All from one provider only
praisonai managed stop --all --provider docker

praisonai managed ps
# → No running sandboxes.

​

How It Works

​

Behaviour change: the silent leak on shutdown

1. SyncComputeProvider._offload() falls back to inline execution when the executor is gone — it catches a RuntimeError whose message contains "interpreter shutdown" or "no running event loop" and calls the sync function directly (blocking is fine: there is no event loop left to starve). Unrelated RuntimeErrors still propagate.
2. _shutdown_orphan() in tools_placement.py now logs at warning level (was debug), so a genuine teardown failure is visible instead of buried. SharedCompute.shutdown() re-raises the underlying exception after clearing instance_id, so the caller can log it.

​

…and the run_on= finalizer that was never registered (PR #4109)

from praisonaiagents import Agent

agent = Agent(name="builder", instructions="You build things.", run_on="docker")
agent.start("Write a script that prints the first 10 primes, then run it")
# When the script exits, the container is reclaimed automatically.

# praisonai/integrations/compute_managed_agent.py (inside _ensure())
self._finalizer = weakref.finalize(self, _release, provider, self._instance, self._place)

• It runs on garbage collection and at interpreter exit — not one or the other.
• It deliberately does not close over the backend self — closing over self would keep the backend alive and prevent the very collection it waits for.

• No running loop (asyncio.get_running_loop() raises) → asyncio.run(_shutdown()).
• A loop is already running → it bridges through concurrent.futures.ThreadPoolExecutor(max_workers=1) so the shutdown coroutine runs on its own loop instead of RuntimeError-ing. Without this bridge, GC landing inside async workflow code would raise and silently leak — the same class of bug PR #4107 fixed one layer down. This matches the pattern SharedCompute already uses.
• Errors are logged at warning and swallowed — teardown stays quiet.

​

When a provider can’t be queried

​

From a script

# JSON output for scripting
praisonai managed ps --json

{
  "sandboxes": [
    {
      "provider": "docker",
      "instance_id": "docker_5afaa3bfa704",
      "status": "running",
      "endpoint": "docker://5afaa3bfa704",
      "created_at": 1755253800.0,
      "metadata": {"image": "python:3.12-slim", "name": "praisonai_5afaa3bfa704"}
    }
  ],
  "errors": []
}

​

Best Practices

​

Related