#trilema bot spec
So you want to add a bot to #trilema ? Good for you - bots are welcome. You don't even have to ask for permission, with the exception that if you want the bot to also speak in channel then it must :
Respond to a two character control code - see the bot directory for the next available one (scroll down). It may not answer to anything else, with the sole exception that if your bot is connected to a web-based log of the channel and someone (humans or deedbot, but not other logger bots) posts a link to a certain line in that log then it may read out the line corresponding to the link.
Not speak of its own accord, but only in response to in-channel commands ; and generally limit its responses to one line at a time.
Answer to "help" sent in PM with a list of supported commands in plain text or html format, either directly or via a link to webpage.
Answer to "help json" sent in PM with a list of supported commands in json format, either directly or via a link to webpage.
Answer to "help sexpr" sent in PM with a list of supported commands in sexpr format, either directly or via a link to webpage.
Not join/part excessively. As a general rule please code your bot so it joins no more than once a day. Netsplits do not count towards this.
Not send unsolicited PMs to the people in the channel. Opt-in services such as deedbot's RSS reader are fine - but make sure they're opt-in and that there's a way to opt out.
The bot should implement self voicing via authenticating itself with deedbot. You may receive a derrogation from this rule if you need it, with the understanding that you will eventually implement the proper authentication mechanism.
Bots are also encouraged to submit all links they encounter in the channel to the web archival service of your choice.
In general failure to comply with this spec will result in a warning if/when someone notices. If your bot is enough of a pain in the ass it will be devoiced until compliant. That's about it, have fun!
« Two Moon Junction
The Human Latrine Pig »
Category: Bitcoin
Wednesday, 14 September, Year 8 d.Tr.
