Bots
Short overview of the bot subsystem. For full protocol and implementation documentation, see Bot framework.
Bots are first-class players with Cognito M2M credentials and an HTTPS webhook endpoint. AP delivers challenges and move notifications via signed POSTs; bots submit moves via /botQuery.
Key code
| Component | Path |
|---|---|
| Owner API | api/abstractplay.ts — createBot, updateBot, deleteBot |
| Outbound worker | utils/bot-outbound.ts + lib/botOutbound.ts |
| Reference bot | api/testBot.ts (dev only) |
| Verify / client libs | lib/botVerify.ts, lib/botClient.ts |
Record types
BOT/<clientId>— identity, endpoint, owner, healthBOTNAME/<normalizedName>— display name reservation
See Database schema.
Documentation
- Bot framework — design, stages, traffic flow
- Authentication
- Protocol — ping, challenge, move
- Registration —
create_bot, secret rotation - Implementation guide
- Bot queries