tidy the api, next job is to improve the bot.js for simulation