@evanp/activitypub-bot 0.53.1 → 0.54.2

package/CHANGELOG.md

@@ -9,6 +9,45 @@ and this project adheres to
 
 ## [Unreleased]
 
+## [0.54.2] - 2026-10-09
+
+### Fixed
+
+- Authenticate Docker Hub pulls for PostgreSQL and Redis service containers
+  in the release integration tests using repository secrets, avoiding the
+  unauthenticated pull rate limit.
+
+## [0.54.1] - 2026-10-09
+
+### Fixed
+
+- Restore "OK" as OKBot's default reply content and update the default
+  description to match. Custom response content remains configurable.
+- Update the actor route test to expect OKBot's fullname default of the
+  username followed by " bot".
+
+## [0.54.0] - 2026-10-09
+
+### Added
+
+- Configure OKBot with a fixed response or an array of randomly selected
+  responses, a content language, and custom fullname and description.
+- Support an optional `language` option in `BotContext.sendNote()` and a third
+  language argument in `sendReply()`. Notes always include `content` and also
+  include `contentMap` when a language is supplied.
+
+### Changed
+
+- Default OKBot replies to its username and fullname to its username followed
+  by " bot". The shipped `ok` bot now replies with "ok" instead of "OK" and
+  uses "ok bot" instead of "OK Bot" as its fullname. Default descriptions
+  reflect the configured response content.
+
+### Fixed
+
+- Keep single-language `contentMap` entries synchronized with `content` when
+  updating a Note through `BotContext.updateNote()`.
+
 ## [0.53.1] - 2026-10-09
 
 ### Security
@@ -1720,7 +1759,10 @@ Hot patch on the `stable` branch.
 - Docker multi-platform build workflow.
 - Dependabot configuration.
 
-[Unreleased]: https://github.com/evanp/activitypub-bot/compare/v0.53.1...HEAD
+[Unreleased]: https://github.com/evanp/activitypub-bot/compare/v0.54.2...HEAD
+[0.54.2]: https://github.com/evanp/activitypub-bot/compare/v0.54.1...v0.54.2
+[0.54.1]: https://github.com/evanp/activitypub-bot/compare/v0.54.0...v0.54.1
+[0.54.0]: https://github.com/evanp/activitypub-bot/compare/v0.53.1...v0.54.0
 [0.53.1]: https://github.com/evanp/activitypub-bot/compare/v0.53.0...v0.53.1
 [0.53.0]: https://github.com/evanp/activitypub-bot/compare/v0.52.2...v0.53.0
 [0.52.2]: https://github.com/evanp/activitypub-bot/compare/v0.52.1...v0.52.2

package/README.md

@@ -198,7 +198,36 @@ The following bot classes are pre-installed with the server.
 
 #### OKBot
 
-An *OKBot* instance will reply to any message that it's mentioned in with the constant string 'OK'.
+An *OKBot* instance replies when mentioned, using "OK" as the default
+response. The shipped `ok` bot replies with "OK" and has the fullname "ok bot".
+Each message receives at most one reply. When the author's WebFinger handle is
+available, the reply starts with a mention of that author.
+
+The constructor accepts a username and an optional options object:
+
+| Option | Behavior | Default |
+| --- | --- | --- |
+| `content` | A response string or a nonempty array of response strings. An array selects one response at random for each new mention; a string behaves like a one-element array. | `"OK"`. |
+| `language` | A BCP 47 language tag, such as `fr` or `fr-CA`, for the outgoing Note's content. | Untagged. |
+| `fullname` | The bot's display name. | The username followed by " bot". |
+| `description` | The bot's profile description. | See below. |
+
+With default content or a configured string, the default description is
+`A bot that says "<response>" when mentioned.` With a configured array,
+including a one-element array, it is
+`A bot that says random things when mentioned.` An explicit description
+overrides either default. With no configured content, the description is
+`A bot that says "OK" when mentioned.`
+
+Outgoing Notes always include rendered HTML in `content`. When `language` is
+supplied, they also include the same HTML in `contentMap` under that language
+tag. Language keys are normalized to lowercase, so `fr-CA` is published as
+`fr-ca`.
+
+For a Magic 8-Ball-style bot, configure `content` with an array of answers such
+as "Yes", "No", and "Ask again later", and set `fullname` to "Magic 8-Ball".
+Other options supported by [Bot](#bot), such as `icon` and `image`, can also be
+supplied.
 
 #### DoNothingBot
 

package/lib/botcontext.js

@@ -118,7 +118,7 @@ export class BotContext {
     }
   }
 
-  async sendNote (content, { to, cc, bto, bcc, audience, inReplyTo, thread, context, conversation }) {
+  async sendNote (content, { to, cc, bto, bcc, audience, inReplyTo, thread, context, conversation, language }) {
     assert.ok(content)
     assert.equal(typeof content, 'string')
     assert.ok(to || cc || bto || bcc || audience)
@@ -129,6 +129,7 @@ export class BotContext {
       type: 'note',
       nanoid: noteNanoid
     }
+    const optional = {}
     if (!inReplyTo) {
       if (!thread) {
         thread = this.#formatter.format({ ...idProps, collection: 'thread' })
@@ -140,6 +141,9 @@ export class BotContext {
         conversation = thread
       }
     }
+    if (language) {
+      optional.contentMap = { [language]: html }
+    }
     const note = await as2.import({
       '@context': [
         'https://www.w3.org/ns/activitystreams',
@@ -163,7 +167,8 @@ export class BotContext {
       thread,
       'ostatus:conversation': conversation,
       published: new Date().toISOString(),
-      attributedTo: this.#formatter.format({ username: this.#botId })
+      attributedTo: this.#formatter.format({ username: this.#botId }),
+      ...optional
     })
     await this.#objectStorage.create(note)
     await this.#doActivity({
@@ -183,7 +188,7 @@ export class BotContext {
     return note
   }
 
-  async sendReply (content, object) {
+  async sendReply (content, object, language = null) {
     const r = this.#getRecipients(object)
     const attributedTo = object.attributedTo?.first?.id
     if (r.to) {
@@ -211,6 +216,9 @@ export class BotContext {
     if (conversationProp) {
       opt.conversation = Array.from(conversationProp)[0]
     }
+    if (language) {
+      opt.language = language
+    }
     return await this.sendNote(content, opt)
   }
 
@@ -348,6 +356,12 @@ export class BotContext {
     assert.equal(typeof content, 'string')
     const exported = await note.export({ useOriginalContext: true })
     exported.content = content
+    if ('contentMap' in exported) {
+      const keys = Object.keys(exported.contentMap)
+      if (keys.length === 1) {
+        exported.contentMap[keys[0]] = content
+      }
+    }
     const updated = await as2.import(exported)
     const { to, cc, bto, bcc, audience } = this.#getRecipients(note)
     await this.#objectStorage.update(updated)

package/lib/bots/ok.js

@@ -1,12 +1,29 @@
 import Bot from '../bot.js'
 
 export default class OKBot extends Bot {
-  get fullname () {
-    return 'OK Bot'
-  }
+  #content
+  #language
 
-  get description () {
-    return 'A bot that says "OK" when mentioned.'
+  constructor (username, options = {}) {
+    const says = ('content' in options)
+      ? Array.isArray(options.content)
+        ? 'random things'
+        : `"${options.content}"`
+      : '"OK"'
+    options = {
+      fullname: `${username} bot`,
+      description: `A bot that says ${says} when mentioned.`,
+      ...options
+    }
+    super(username, options)
+    this.#content = ('content' in options)
+      ? (Array.isArray(options.content))
+          ? options.content
+          : [options.content]
+      : ['OK']
+    this.#language = ('language' in options)
+      ? options.language
+      : null
   }
 
   async onMention (object, activity) {
@@ -27,14 +44,16 @@ export default class OKBot extends Bot {
         'attributed to'
       )
       const wf = await this._context.toWebfinger(attributedTo)
-      const content = (wf) ? `@${wf} OK` : 'OK'
+      const response = this.#response()
+      const content = (wf) ? `@${wf} ${response}` : response
       this._context.logger.info({
         object: object.id,
         attributedTo,
         wf,
         content
       }, 'sending reply')
-      const reply = await this._context.sendReply(content, object)
+
+      const reply = await this._context.sendReply(content, object, this.#language)
       this._context.logger.info({
         reply: reply.id,
         content,
@@ -55,4 +74,9 @@ export default class OKBot extends Bot {
     const key = `seen:${id}`
     return this._context.setData(key, true)
   }
+
+  #response () {
+    const idx = Math.floor(Math.random() * this.#content.length)
+    return this.#content[idx]
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evanp/activitypub-bot",
-  "version": "0.53.1",
+  "version": "0.54.2",
   "description": "server-side ActivityPub bot framework",
   "type": "module",
   "main": "lib/index.js",