Skip to content

Releases: fedify-dev/botkit

BotKit 0.5.1

Choose a tag to compare

@github-actions github-actions released this 19 Jul 11:14
0.5.1
b674586

Released on July 19, 2026.

@fedify/botkit

  • Upgraded Fedify to 2.3.3, which addresses CVE-2026-62857, an SSRF vulnerability in NodeInfo lookups that could allow a malicious remote server to access non-public network resources. [GHSA-hqph-j65v-8cq5]

BotKit 0.4.5

Choose a tag to compare

@github-actions github-actions released this 19 Jul 10:52
0.4.5
06fae08

Released on July 19, 2026.

@fedify/botkit

  • Upgraded Fedify to 2.1.19, which fixes an SSRF vulnerability in NodeInfo lookups that could allow a malicious remote server to access non-public network resources. [CVE-2026-62857]

BotKit 0.5.0

Choose a tag to compare

@github-actions github-actions released this 08 Jul 14:36
0.5.0
d8151f6

Released on July 8, 2026.

@fedify/botkit

  • Redesigned the bot's web pages with a new, self-contained design language.

    The profile, post, and follower pages now use BotKit's own quiet, modern design instead of Pico CSS. The look is driven by the bot's accent color, adapts to light and dark color schemes automatically, and foregrounds the bot's own identity rather than BotKit's brand. Reposts are now clearly distinguished from the bot's own posts. The full system is described in the new DESIGN.md document.

    The stylesheet and web fonts are bundled with the package and served locally, so the pages no longer load anything from an external CDN and work with no build step on either Deno or Node.js.

    • Added the PagesOptions.theme option, which selects the color scheme ("auto", "light", or "dark"; default "auto").
  • Added support for hosting multiple bots on a single instance. [#16, #24]

    The new createInstance() function creates an instance that owns the shared infrastructure (the key–value store, the message queue, the repository, and HTTP handling), on which multiple bots can be hosted, each with its own actor identity and event handlers.

    • Added createInstance() function.
    • Added Instance interface.
    • Added InstanceWithVoidContextData interface.
    • Added CreateInstanceOptions interface.
    • Added Instance.createBot() method, which creates a static bot from an identifier and a BotProfile, or a dynamic BotGroup from a BotDispatcher function that resolves bots on demand (e.g. one bot per region, backed by a database).
    • Added BotProfile interface.
    • Added BotDispatcher type.
    • Added BotGroup interface.
    • Added CreateBotGroupOptions interface, whose mapUsername option resolves WebFinger usernames to dynamic bot identifiers.
    • Added BotEventHandlers interface, which Bot and BotGroup both extend.
    • Added DEFAULT_INSTANCE_ACTOR_IDENTIFIER constant. Multi-bot instances expose an instance actor under a reserved identifier, whose key signs shared-inbox related requests; it can be overridden through the CreateInstanceOptions.instanceActorIdentifier option.
    • Added @fedify/botkit/instance module.

    Activities delivered to the shared inbox are routed to the bots they are relevant to: the followed or unfollowed bot, the owner of the liked or replied-to message, mentioned bots, addressed bots, and bots following the author. Multi-bot instances serve a bot list at the web root and each bot's pages under /@{username}.

    The existing createBot() function keeps working for single-bot deployments and preserves their behavior, including the web pages served at the root.

  • Added support for consent-respecting quote posts using FEP-044f. [#27, #28, #29, #30, #31, #32, #33]

    BotKit now serializes quote policies on outgoing messages, handles incoming QuoteRequest activities, automatically accepts or rejects them according to each message's policy, and stores QuoteAuthorization stamps for accepted quotes. Applications can set a default CreateBotOptions.quotePolicy, override it per message with Session.publish() or AuthorizedMessage.update(), and moderate pending requests with the new Bot.onQuoteRequest event handler.

    When publishing a quote, BotKit now sets the FEP-044f quote property, sends a QuoteRequest to the quoted message's author, applies accepted QuoteAuthorization stamps to the stored message, and strips rejected quote targets from the stored message before delivering an Update. BotKit also verifies QuoteAuthorization stamps on received third-party quote posts and handles deleted stamps by forwarding the Delete activity before stripping the quote from the bot's own post.

    • Added QuotePolicy, QuotePolicyOption, QuoteRequest, and QuoteRequestEventHandler types. [#27, #28, #31]
    • Added Bot.onQuoteRequest event handler. [#27, #28, #31]
    • Added QuoteAcceptedEventHandler and QuoteRejectedEventHandler types. [#27, #29, #32]
    • Added Bot.onQuoteAccepted and Bot.onQuoteRejected event handlers. [#27, #29, #32]
    • Added QuoteRevokedEventHandler type and Bot.onQuoteRevoked event handler. [#27, #30, #33]
    • Added ReadonlyBot.quotePolicy, CreateBotOptions.quotePolicy, and BotProfile.quotePolicy properties. [#27, #28, #31]
    • Added SessionPublishOptions.quotePolicy and AuthorizedMessageUpdateOptions.quotePolicy options. [#27, #28, #31]
    • Added Message.quotePolicy and AuthorizedMessage.quoteApprovalState properties. [#27, #29, #32]
    • Added Message.quoteApproved property for inspecting whether a received quote post has valid FEP-044f approval. [#27, #30, #33]
    • Added AuthorizedMessage.unauthorizeQuote() method for revoking an existing quote authorization stamp by the quoted message or its URI. [#27, #28, #31]
    • Added @fedify/botkit/quote module. [#27, #28, #31]
  • The Repository interface now stores data for multiple bot actors: every method takes the identifier of the owning bot actor as its first parameter, and data belonging to different identifiers are isolated from each other. This is a breaking change for custom Repository implementations. [#16, #24]

    • Added identifier parameter to all Repository methods.
    • Added Repository.findFollowedBots() method, a reverse lookup answering which bots follow a given actor.
    • Added quote authorization storage methods: Repository.addQuoteAuthorization(), Repository.getQuoteAuthorization(), Repository.findQuoteAuthorization(), and Repository.removeQuoteAuthorization().
    • Added quote authorization reference methods: Repository.addQuoteAuthorizationReference(), Repository.findQuoteAuthorizationReference(), Repository.findQuoteAuthorizationReferenceIdentifiers(), Repository.findQuoteAuthorizationReferenceAttribution(), and Repository.removeQuoteAuthorizationReference(). [#27, #29, #30, #32, #33]
    • Added optional Repository.migrate() method for adopting data stored by BotKit 0.4 or earlier.
    • Added Repository.forIdentifier() method and ActorScopedRepository class, a view of a repository bound to a single bot actor.
    • KvRepository now stores data under bot-scoped keys. Its second constructor parameter is now a KvRepositoryOptions object with a single prefix option, replacing the removed KvStoreRepositoryPrefixes interface.
    • createBot() migrates data stored by BotKit 0.4 or earlier to the bot-scoped layout on startup.
  • Local object URIs now carry the identifier of the owning bot actor, e.g. /ap/actor/{identifier}/note/{id} instead of /ap/note/{id}. URIs in the old format are still recognized in incoming activities and are permanently redirected to their canonical URIs when dereferenced, so links stored by remote servers keep working after an upgrade. [#16, #24]

  • The Session.bot property is now typed as ReadonlyBot, a read-only view of the bot's identity and profile, instead of Bot. This is a breaking change for code that reached the full Bot through a session; such code should hold on to the Bot returned by createBot() instead. [[#16](https://github.com/fed...

Read more

BotKit 0.4.4

Choose a tag to compare

@github-actions github-actions released this 05 Jul 16:13
0.4.4
2a749fb

Released on July 6, 2026.

@fedify/botkit

  • Fixed MemoryRepository, KvRepository, and MemoryCachedRepository so removing one of multiple active follow requests for the same actor no longer deletes the follower too early or fires a premature unfollow event, and reassigning a follow request no longer leaves stale followers behind. [#25, #26]

@fedify/botkit-sqlite

  • Fixed SqliteRepository so removing one of multiple active follow requests for the same actor no longer fails with a foreign key error, and reassigning a follow request no longer leaves stale followers behind. [#25, #26]

@fedify/botkit-postgres

  • Fixed PostgresRepository so removing one of multiple active follow requests for the same actor no longer reports a follower removal until the last active follow request is removed. [#25, #26]

BotKit 0.4.3

Choose a tag to compare

@github-actions github-actions released this 04 Jun 08:35
0.4.3
55f73c3

Released on June 4, 2026.

  • Upgraded Fedify to 2.1.15, which fixes an SSRF protection bypass vulnerability. [CVE-2026-50131]

BotKit 0.3.4

Choose a tag to compare

@github-actions github-actions released this 04 Jun 08:28
0.3.4
e203848

Released on June 4, 2026.

  • Upgraded Fedify to 1.9.12, which fixes an SSRF protection bypass vulnerability. [CVE-2026-50131]

BotKit 0.4.2

Choose a tag to compare

@github-actions github-actions released this 21 May 13:13
0.4.2
1f11848

Released on May 21, 2026.

@fedify/botkit

  • Upgraded Fedify to 2.1.14 to fix a security vulnerability in Linked Data Signature verification that could allow certain signed activities to be interpreted differently than intended. [CVE-2026-42462]

BotKit 0.3.3

Choose a tag to compare

@github-actions github-actions released this 21 May 12:31
0.3.3
a4572ae

Released on May 21, 2026.

  • Upgraded Fedify to 1.9.11 to fix a security vulnerability in Linked Data Signature verification that could allow certain signed activities to be interpreted differently than intended. [CVE-2026-42462]

BotKit 0.4.1

Choose a tag to compare

@github-actions github-actions released this 11 May 15:34
0.4.1
2fd2dd0

Released on May 12, 2026.

@fedify/botkit

  • Upgraded Fedify to 2.1.12, which addresses a private network protection bypass vulnerability. This vulnerability allowed certain IPv4-mapped IPv6 literals (e.g., http://[::ffff:127.0.0.1]/) to bypass SSRF (Server-Side Request Forgery) protection, potentially allowing attackers to access internal network resources.

BotKit 0.3.2

Choose a tag to compare

@github-actions github-actions released this 11 May 15:28
0.3.2
c2b9367

Released on May 12, 2026.

  • Upgraded Fedify to 1.9.10, which addresses a private network protection bypass vulnerability. This vulnerability allowed certain IPv4-mapped IPv6 literals (e.g., http://[::ffff:127.0.0.1]/) to bypass SSRF (Server-Side Request Forgery) protection, potentially allowing attackers to access internal network resources.