Thread lifecycle events

bb 0.43.3·SDK 0.4.104·pinned e865697 (desktop-v0.43.3)

stable Plugin backend Show on the zone map

Runs server code when a thread changes state. With this, a plugin can:

React when threads start, finish, or fail

What it gives you

• Subscribe to threads being created, going active or idle, failing, being archived or unarchived, or being deleted
• Subscribe to messages being queued behind a wait, dispatching when it clears, or being cancelled before dispatch
• Subscribe when a thread receives a pending interaction
• Observe debounced experimental_thread.events notifications with the latest sequence and current thread, or experimental_terminal.input without keystroke contents
• Subscribe to a turn failing, with the provider's error and rate-limit windows attached
• Respond by sending a notification, asking for a retry, or writing to its own storage

API

Each symbol links to the pinned commit it was read at.

• PluginEvents interface
• PluginThreadEventPayloads interface
• PluginTurnFailedEvent interface

Used by

Automations, Provider retry, Push notifications, Tasks, Workflows

Brief for agent…as a bb mentionAdd to set

The brief is Markdown, written for a coding agent: what the capability is, where it registers, every SDK symbol with a pinned permalink, the rules that bite, and what done means.