create ──▶ execute ──▶ read/write files ──▶ stop
   │                                          │
timeout_seconds is the ceiling ───────────────┘

# 1. Provision
curl -X POST https://api.sandbox.stateset.com/api/v1/sandbox/create \
  -H "Authorization: ApiKey $STATESET_SANDBOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"timeout_seconds": 300}'

# 2. Run something
curl -X POST https://api.sandbox.stateset.com/api/v1/sandbox/$SANDBOX_ID/execute \
  -H "Authorization: ApiKey $STATESET_SANDBOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"command": "python3 -c \"print(2+2)\""}'

# 3. Tear down — do not wait for the timeout
curl -X POST https://api.sandbox.stateset.com/api/v1/sandbox/$SANDBOX_ID/stop \
  -H "Authorization: ApiKey $STATESET_SANDBOX_API_KEY"

const sandbox = await create({ timeout_seconds: 300 });
try {
  await run(sandbox);
} finally {
  await stop(sandbox.id);     // even if run() throws
}