Agent providers

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

experimental The composer #6 in group Show on the zone map

Adds an agent to bb's model picker and runs the threads started with it. With this, a plugin can:

What it gives you

• Appear in the model picker beside bb's built-in providers
• Declare what the provider supports, then serve its model list at runtime
• Supply a small icon that appears next to its name; React icon overrides require providerKind and providerId
• Publish context snapshots through contextWindow deltas, with provider-defined category IDs and labels. Each category declares used, free, reserved, or deferred accounting; entries are included in its total and may be partial. Snapshots include capture time, session identity, model, totals, and an optional auto-compaction threshold
• Receive every message in a thread started with it, through a bridge process the plugin ships
• Contribute validated environment variables to any provider for each session and turn

API

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

• contextSnapshotSchema const
• ContextSnapshot type
• ContextCategory type
• ContextEntry type
• PluginProviderDeclaration interface
• PluginProviderIconRegistration interface
• ExperimentalPluginProviderEnvContext interface
• ExperimentalPluginProviderEnvEntry interface
• ExperimentalPluginProviderEnvHealthContext interface
• ExperimentalPluginProviderEnvHealth interface

Used by

ACP providers, Claude Code provider, Codex provider, Pi provider

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.