brobbot-react
Train brobbot to react to certain terms. Multiple responses to the same term are allowed. One will be selected at-random.
Bob: brobbot react homestar seriously.
Brobbot: reacting to homestar with seriously.
...
Alice: Homestar Runner is the best.
Brobbot: seriously.
Matching
It currently uses natural's PorterStemmer to match words regardless of conjugation, tense, etc. This is almost certainly going to change as I experiment with it more.
Throttling
Responses to the same term will be throttled according to how often a message including the term is seen. Specifically, the throttle expiration time grows exponentially with the frequency of the term.
timeToThrottle = minimumThrottleTime * (throttleMultiplier ^ ((totalMessageCount + termUsageCount) / totalMessageCount) - (throttleMultiplier / 2))
Configuration
Store size
Remember at most N messages (default 200).
BROBBOT_REACT_STORE_SIZE=N
Throttle expiration
Throttle responses to the same term for a minimum of N seconds (minimumThrottleTime above) (default 300).
BROBBOT_REACT_THROTTLE_EXPIRATION=N
Throttle frequency multiplier
Multiplier used to tweak the computed throttle times (throttleMultiplier above) (default 10).
BROBBOT_REACT_THROTTLE_FREQUENCY_MULTIPLIER=N
Commands
React (single-word term)
Tell brobbot to react with <response> when it hears <term>.
brobbot react <term> <response>
React (multi-word term)
Tell brobbot to react with <response> when it hears <term>.
brobbot react "<term>" <response>
What was that
Ask brobbot about the last <response> uttered.
brobbot what was that
Ignore
Tell brobbot to forget the last <term> <response> pair that was uttered.
brobbot ignore that