Lifecycle and long-running sandboxes

from anona import Sandbox

sbx = Sandbox.create("base", timeout=600)  # 10 minutes
sbx.set_timeout(3600)                      # now one hour from this call
print(sbx.get_info().end_at)
sbx.kill()

import { Sandbox } from "@anona/sdk";

const sbx = await Sandbox.create("base", { timeoutMs: 600_000 }); // 10 minutes
await sbx.setTimeout(3_600_000);                                    // one hour from now
console.log((await sbx.getInfo()).endAt);
await sbx.kill();

SANDBOX_ID=$(anona-compute create -t base --timeout 10m --json | jq -r .sandboxID)
anona-compute timeout "$SANDBOX_ID" 1h
anona-compute delete "$SANDBOX_ID"

from anona import Sandbox

sbx = Sandbox.create("base", timeout=-1)
print(sbx.get_info().end_at)  # 9999-12-31 23:59:59+00:00
sbx.kill()

# The REST API takes -1 directly; so do the dashboard and the MCP create_sandbox tool.
curl -sS https://api.compute.anonalabs.com/v2/sandboxes \
  -H "X-API-Key: $E2B_API_KEY" -H 'Content-Type: application/json' \
  -d '{"templateID": "base", "timeout": -1}' | jq -r .sandboxID > sandbox.id
curl -sS -X DELETE "https://api.compute.anonalabs.com/sandboxes/$(cat sandbox.id)" -H "X-API-Key: $E2B_API_KEY"

from anona import Sandbox

sbx = Sandbox.create("base")
sbx.commands.run("echo kept > /dev/shm/marker")
sbx.pause()

sbx = Sandbox.connect(sbx.sandbox_id)  # resumes a paused sandbox
print(sbx.commands.run("cat /dev/shm/marker").stdout)
sbx.kill()

import { Sandbox } from "@anona/sdk";

const sbx = await Sandbox.create("base");
await sbx.commands.run("echo kept > /dev/shm/marker");
await sbx.pause();

const again = await Sandbox.connect(sbx.sandboxId); // resumes a paused sandbox
console.log((await again.commands.run("cat /dev/shm/marker")).stdout);
await again.kill();

SANDBOX_ID=$(anona-compute create -t base --json | jq -r .sandboxID)
anona-compute pause "$SANDBOX_ID"
anona-compute list --state paused
anona-compute resume "$SANDBOX_ID"
anona-compute delete "$SANDBOX_ID"

from anona import Sandbox

sbx = Sandbox.create("base", timeout=3600, lifecycle={"on_timeout": "pause"})
print(sbx.get_info().state)
sbx.kill()

import { Sandbox } from "@anona/sdk";

const sbx = await Sandbox.create("base", { timeoutMs: 3_600_000, lifecycle: { onTimeout: "pause" } });
console.log((await sbx.getInfo()).state);
await sbx.kill();

SANDBOX_ID=$(anona-compute create -t base --timeout 1h --auto-pause --json | jq -r .sandboxID)
anona-compute info "$SANDBOX_ID"
anona-compute delete "$SANDBOX_ID"

import os
import httpx
from anona import Sandbox

sbx = Sandbox.create("base", timeout=-1)  # no deadline ...
api = httpx.Client(base_url="https://api.compute.anonalabs.com", headers={"X-API-Key": os.environ["E2B_API_KEY"]})
r = api.put(f"/v1/sandboxes/{sbx.sandbox_id}/auto-pause", json={"idleMinutes": 15})  # ... but pause after 15 idle minutes
r.raise_for_status()
print(r.json())  # {"sandboxID": ..., "allowPublicTraffic": ..., "publicPorts": [], "idlePauseMinutes": 15}
sbx.kill()

# Or at create time, over the API: autoPause takes {"idleMinutes": n} (0 = off; {} = the team default, else 15).
curl -sS https://api.compute.anonalabs.com/v2/sandboxes -H "X-API-Key: $E2B_API_KEY" -H 'Content-Type: application/json' \
  -d '{"templateID": "base", "timeout": -1, "autoPause": {"idleMinutes": 30}}' | jq -r .sandboxID > sandbox.id
curl -sS "https://api.compute.anonalabs.com/v1/sandboxes/$(cat sandbox.id)/access" -H "X-API-Key: $E2B_API_KEY" | jq .idlePauseMinutes
curl -sS -X DELETE "https://api.compute.anonalabs.com/sandboxes/$(cat sandbox.id)" -H "X-API-Key: $E2B_API_KEY"

from anona import Sandbox

sbx = Sandbox.create("base", timeout=300)
sbx.files.write("/root/state.txt", "reached an interesting state")
sbx.commands.run("nohup sh -c 'while true; do date >> /root/ticks; sleep 1; done' >/dev/null 2>&1 &")

# Each entry is a Sandbox or the exception that stopped that one fork.
forks = sbx.fork(count=3, timeout=300)
for f in forks:
    if isinstance(f, Exception):
        print("fork failed:", f)
        continue
    print(f.sandbox_id, f.files.read("/root/state.txt"))   # the parent's file
    print(f.commands.run("wc -l < /root/ticks").stdout)    # the parent's process, still ticking
    f.kill()
sbx.kill()

import { Sandbox } from "@anona/sdk";

const sbx = await Sandbox.create("base", { timeoutMs: 300_000 });
await sbx.files.write("/root/state.txt", "reached an interesting state");

const forks = await sbx.fork({ count: 3, timeoutMs: 300_000 });
for (const f of forks) {
  if (f instanceof Error) {
    console.log("fork failed:", f.message);
    continue;
  }
  console.log(f.sandboxId, await f.files.read("/root/state.txt"));
  await f.kill();
}
await sbx.kill();

SANDBOX_ID=$(anona-compute create -t base --json | jq -r .sandboxID)
anona-compute exec "$SANDBOX_ID" -- sh -c 'echo "reached an interesting state" > /root/state.txt'
anona-compute fork "$SANDBOX_ID" --count 3 --timeout 5m   # one sandbox ID per line
anona-compute delete "$SANDBOX_ID"