@get-bb/plugin-sdk 0.4.88 → 0.4.97

package/bundled-types/bb-plugin-sdk-app.d.ts

@@ -52,6 +52,14 @@ interface StandardSchemaV1<Input = unknown, Output = Input> {
         readonly version: 1;
         readonly vendor: string;
         readonly validate: (value: unknown) => StandardSchemaV1Result<Output> | Promise<StandardSchemaV1Result<Output>>;
+        readonly jsonSchema?: {
+            readonly input: (options: {
+                target: string;
+            }) => Record<string, unknown>;
+            readonly output: (options: {
+                target: string;
+            }) => Record<string, unknown>;
+        };
         readonly types?: {
             readonly input: Input;
             readonly output: Output;
@@ -73,6 +81,7 @@ interface StandardSchemaV1Issue {
 type StandardSchemaV1InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["input"];
 type StandardSchemaV1InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["output"];
 interface PluginRpcMethodContract<InputSchema extends StandardSchemaV1 = StandardSchemaV1, OutputSchema extends StandardSchemaV1 = StandardSchemaV1> {
+    readonly experimental_description?: string;
     readonly input: InputSchema;
     readonly output: OutputSchema;
 }
@@ -241,6 +250,10 @@ declare const providerInfoSchema: z.ZodObject<{
         supportsThreadArchive: z.ZodBoolean;
         supportsThreadRename: z.ZodBoolean;
     }, z.core.$strip>;
+    completedTurnDisplay: z.ZodEnum<{
+        collapse: "collapse";
+        flat: "flat";
+    }>;
     composerActions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"skills">;
         trigger: z.ZodEnum<{
@@ -566,6 +579,16 @@ interface PluginThreadHeaderActionProps {
      */
     isCompactViewport: boolean;
 }
+interface ExperimentalPluginBrowserToolbarActionProps {
+    /** Thread that owns the Browser tab. */
+    threadId: string;
+    /** Browser tab currently rendering the action. */
+    tabId: string;
+    /** Current top-level URL shown in the address bar. */
+    url: string;
+    /** True when the Browser chrome needs compact controls. */
+    isCompactViewport: boolean;
+}
 /**
  * Where a file being opened by a `fileOpener` lives. `path` semantics follow
  * the source: workspace paths are relative to the environment's worktree,
@@ -1289,6 +1312,14 @@ interface PluginThreadHeaderActionRegistration {
     title: string;
     component: ComponentType<PluginThreadHeaderActionProps>;
 }
+interface ExperimentalPluginBrowserToolbarActionRegistration {
+    /** Unique within the plugin; letters, digits, `-`, `_`. */
+    id: string;
+    /** Accessible name for the host-wrapped control group. */
+    title: string;
+    /** Component rendered beside the Browser address bar. */
+    component: ComponentType<ExperimentalPluginBrowserToolbarActionProps>;
+}
 /** One pane's place in the split layout, as fractions of the split area. */
 interface PluginSidebarSplitPane {
     paneId: string;
@@ -1501,8 +1532,8 @@ interface PluginMessageActionRegistration {
      */
     run(context: PluginMessageActionContext): void | Promise<void>;
 }
-/** Context handed to a `commandPaletteAction`'s `isAvailable` and `run`. */
-interface PluginCommandPaletteActionContext {
+/** Current context for palette and keyboard command invocations. */
+interface PluginCommandContext {
     /** The thread in view, or null on a surface without one. */
     threadId: string | null;
     projectId: string | null;
@@ -1518,27 +1549,49 @@ interface PluginCommandPaletteActionContext {
      */
     openPanel(options: PluginTargetedPanelActionOpenOptions): boolean;
 }
+/** A default keyboard shortcut. Omitted modifiers are false. */
+interface PluginCommandShortcut {
+    key: string;
+    /** Command on macOS, Control elsewhere. */
+    mod?: boolean;
+    meta?: boolean;
+    control?: boolean;
+    alt?: boolean;
+    shift?: boolean;
+}
 /**
- * A row in bb's quick palette (Mod+Shift+P), listed under the plugin's name
+ * A command registered with `app.commands.register`, listed in bb's quick
+ * palette (Mod+Shift+P) under the plugin's name
  * beside bb's own commands. Host-rendered: the plugin supplies a title and
  * `run`, and the host owns matching, ordering, and recency.
  */
-interface PluginCommandPaletteActionRegistration {
+interface PluginCommandRegistration {
+    /** Initial keyboard binding. Users can rebind every command, including ones without a default. Conflicting defaults remain unbound. */
+    defaultShortcut?: PluginCommandShortcut;
     /** Unique within the plugin; letters, digits, `-`, `_`. */
     id: string;
     /** The row's label, e.g. "Linear: open issue for this thread". */
     title: string;
     /**
      * Hide the row when it cannot do anything — typically when it needs a thread
-     * and there is none. Called while the palette is open; keep it cheap and
-     * synchronous. Omitted means always listed.
+     * and there is none. Called before palette listing and keyboard invocation;
+     * keep it cheap and synchronous. Omitted means always listed.
      */
-    isAvailable?(context: PluginCommandPaletteActionContext): boolean;
+    isAvailable?(context: PluginCommandContext): boolean;
     /**
-     * Runs after the palette closes and focus is restored. Errors (sync or
-     * async) are contained and logged; they never break the palette.
+     * Runs on keyboard invocation, or after the palette closes and focus is
+     * restored. Errors (sync or async) are contained and logged; they never break the palette.
      */
-    run(context: PluginCommandPaletteActionContext): void | Promise<void>;
+    run(context: PluginCommandContext): void | Promise<void>;
+}
+/** @deprecated Use PluginCommandContext. */
+type PluginCommandPaletteActionContext = PluginCommandContext;
+/** @deprecated Use PluginCommandRegistration. */
+type PluginCommandPaletteActionRegistration = PluginCommandRegistration;
+/** Registers commands for bb's command palette. */
+interface PluginAppCommands {
+    /** Register a command. IDs are unique within this plugin, including legacy slot registrations. */
+    register(registration: PluginCommandRegistration): void;
 }
 /**
  * Supply an inline React mark for a provider. Agent, machine, and environment
@@ -1769,6 +1822,8 @@ interface PluginAppSlots {
      * docs/api_to_audit.md.
      */
     experimental_threadHeaderAction(registration: PluginThreadHeaderActionRegistration): void;
+    /** Render a component beside each Browser tab's address bar. */
+    experimental_browserToolbarAction(registration: ExperimentalPluginBrowserToolbarActionRegistration): void;
     fileOpener(registration: PluginFileOpenerRegistration): void;
     /**
      * Replace BB's source-code renderer (see
@@ -1785,10 +1840,10 @@ interface PluginAppSlots {
     messageDirective(registration: PluginMessageDirectiveRegistration): void;
     messageAction(registration: PluginMessageActionRegistration): void;
     /**
-     * Add a row to the quick palette (see
-     * {@link PluginCommandPaletteActionRegistration}).
+     * @deprecated Use `app.commands.register` with the same registration.
+     * Both entry points share the same command registry and ID namespace.
      */
-    commandPaletteAction(registration: PluginCommandPaletteActionRegistration): void;
+    commandPaletteAction(registration: PluginCommandRegistration): void;
     /**
      * Draw one agent, environment, or machine provider's icon with an inline
      * React component instead of its masked logo asset (see
@@ -1920,6 +1975,7 @@ interface ExperimentalAppIcons {
 }
 interface PluginAppBuilder {
     experimental_icons: ExperimentalAppIcons;
+    commands: PluginAppCommands;
     slots: PluginAppSlots;
     composer: PluginAppComposer;
     contentScripts: PluginAppContentScripts;
@@ -2126,7 +2182,7 @@ interface PluginComposerApi {
     focus(): void;
     /**
      * Submit this composer's draft through the composer's OWN submit pipeline,
-     * queued until `sendAt` instead of dispatched now.
+     * optionally scheduling it or attaching plugin-owned dispatch data.
      *
      * This is a real submission, not a plugin-issued send: the host builds the
      * request exactly as pressing Enter would, so the draft's attachments and
@@ -2136,12 +2192,11 @@ interface PluginComposerApi {
      * tuple itself, which is why sending from the backend instead would silently
      * run the message with different settings than the ones in front of the user.
      *
-     * In a thread composer the message is queued as a row instead of being
-     * sent or queued for the next idle moment. In the new-thread composer the
-     * thread is created `pending` and its first message becomes the queued row.
-     * Either way the resulting row is core's: the queued card above the
-     * composer, the countdown, Send now and Delete all work with no further
-     * plugin involvement.
+     * `sendAt` queues the submission until that time. `experimental_data` is
+     * opaque JSON delivered to dispatch hooks together with the calling plugin's
+     * id on this initial attempt. Hooks run before operational core waits. If a
+     * hook queues the message, its existing plugin wait identifies the owner on
+     * later attempts; core does not persist or interpret the opaque data.
      *
      * Resolves once the host has accepted the submission and cleared the draft.
      * Rejects when the composer refused to submit — a scope with no submit
@@ -2158,18 +2213,17 @@ interface PluginComposerApi {
 /**
  * What `experimental_submit` does differently from pressing Enter.
  *
- * There is deliberately no zero-argument overload and no "submit now" arm: a
- * plugin that wants a draft sent immediately is asking for the affordance the
- * user already has, and handing plugins an unconditional "send this draft"
- * button is a much larger surface than scheduling needs.
+ * `experimental_data` is opaque JSON delivered to dispatch hooks. The runtime
+ * associates it with the calling plugin automatically for the initial
+ * dispatch attempt.
  */
-interface ExperimentalComposerSubmitOptions {
-    /**
-     * Epoch ms the submission should dispatch at. Must be in the future; the
-     * host does not second-guess how far ahead it is.
-     */
+type ExperimentalComposerSubmitOptions = {
     sendAt: number;
-}
+    experimental_data?: JsonValue$1;
+} | {
+    experimental_data: JsonValue$1;
+    sendAt?: never;
+};
 /**
  * A consumer-supplied action on the messages of one `ThreadChat` instance,
  * rendered in the embedded timeline's per-message action bar alongside the
@@ -2478,7 +2532,13 @@ interface NewThreadComposerProps {
      *   the original `default` submission would have created from.
      */
     defaultEnvironment?: CreateThreadEnvironmentArgs;
-    /** Seeds the draft, only while the draft is still empty. */
+    /**
+     * Seeds the draft, only while the draft is still empty. Serialized
+     * `@thread:<id>`, `@project:<id>`, and `@section:<id>` tokens become mention
+     * pills with host-resolved titles/names. Missing projects/sections use their
+     * IDs; unavailable generated thread IDs use "Unavailable thread" ("Thread"
+     * if lookup fails). Other unknown thread IDs use the ID as their label.
+     */
     initialPrompt?: string;
     placeholder?: string;
     /**
@@ -2613,7 +2673,8 @@ interface BbNavigate {
     }): void;
     /**
      * Navigate to the root compose surface (the new-thread screen). Pass
-     * `initialPrompt` to seed the composer draft and `focusPrompt` to focus the
+     * `initialPrompt` to seed the composer draft (serialized thread, project,
+     * and section mention tokens become pills) and `focusPrompt` to focus the
      * composer on arrival — the pairing behind "Create via chat" style entry
      * points that drop the user into chat with a prefilled prompt.
      */
@@ -2829,4 +2890,4 @@ declare const experimental_useProviders: () => PluginProvidersState;
 declare const experimental_useCodeTheme: () => PluginCodeThemeState;
 
 export { Markdown, ThreadChat, UrlLink, definePluginApp, experimental_BranchPicker, experimental_Diff, experimental_FileLink, experimental_Icon, experimental_NewThreadComposer, experimental_PermissionModePicker, experimental_ProviderIcon, experimental_ProviderModelPicker, experimental_SourceCode, experimental_useAppPanel, experimental_useBranches, experimental_useCheckoutState, experimental_useCodeTheme, experimental_useFixedTabTarget, experimental_useProviders, experimental_useSidebarThreadActions, experimental_useSidebarThreadPullRequest, experimental_useSidebarThreadSplit, experimental_useSidebarThreads, useBbContext, useBbNavigate, useComposer, useComposerView, useRealtime, useRealtimeConnectionState, useRpc, useSettings };
-export type { BbContext, BbNavigate, BranchPickerProps, BranchesState, CheckoutState, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppIcons, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSubmitOptions, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalIconProps, ExperimentalIconRegistration, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginFixedTabReference, ExperimentalProviderIconProps, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalSidebarFooter, ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterActionRegistration, ExperimentalSidebarFooterDisclosureController, ExperimentalSidebarFooterDisclosureProps, ExperimentalSidebarFooterDisclosureRegistration, ExperimentalSidebarFooterItemBase, ExperimentalSidebarFooterItemRegistration, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, JsonValue$1 as JsonValue, MarkdownProps, NewThreadComposerProps, NewThreadRequest, PluginAppBuilder, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandPaletteActionContext, PluginCommandPaletteActionRegistration, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, PluginFileOpenerProps, PluginFileOpenerRegistration, PluginFileOpenerSource, PluginFixedTabDeclaration, PluginFixedTabRegistration, PluginHomepageSectionProps, PluginHomepageSectionRegistration, PluginMachineProviderInputsChange, PluginMachineProviderInputsProps, PluginMachineProviderInputsRegistration, PluginMessageActionContext, PluginMessageActionRegistration, PluginMessageDirectiveMessage, PluginMessageDirectiveOpenWorkspaceFile, PluginMessageDirectiveProps, PluginMessageDirectiveRegistration, PluginNavPanelProps, PluginNavPanelRegistration, PluginNewThreadPanelActionContext, PluginNewThreadPanelActionRegistration, PluginNewThreadPanelProps, PluginPanelActionOpenOptions, PluginPendingInteractionProps, PluginPendingInteractionRegistration, PluginPendingInteractionView, PluginProviderIconRegistration, PluginProvidersState, PluginRealtimeConnectionState, PluginRpcCallArgs, PluginRpcClient, PluginRpcContract, PluginRpcError, PluginRpcErrorCode, PluginRpcHandlers, PluginRpcIssuePathSegment, PluginRpcMethodContract, PluginRpcResult, PluginRpcValidationIssue, PluginSdkApp, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsState, PluginSidebarFooterActionContext, PluginSidebarFooterActionProps, PluginSidebarFooterActionRegistration, PluginSidebarProject, PluginSidebarPullRequest, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginTargetedPanelActionOpenOptions, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, ReadonlyJsonValue, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps, UseBranchesArgs, UseCheckoutStateArgs };
+export type { BbContext, BbNavigate, BranchPickerProps, BranchesState, CheckoutState, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppIcons, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSubmitOptions, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalIconProps, ExperimentalIconRegistration, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginBrowserToolbarActionProps, ExperimentalPluginBrowserToolbarActionRegistration, ExperimentalPluginFixedTabReference, ExperimentalProviderIconProps, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalSidebarFooter, ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterActionRegistration, ExperimentalSidebarFooterDisclosureController, ExperimentalSidebarFooterDisclosureProps, ExperimentalSidebarFooterDisclosureRegistration, ExperimentalSidebarFooterItemBase, ExperimentalSidebarFooterItemRegistration, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, JsonValue$1 as JsonValue, MarkdownProps, NewThreadComposerProps, NewThreadRequest, PluginAppBuilder, PluginAppCommands, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandContext, PluginCommandPaletteActionContext, PluginCommandPaletteActionRegistration, PluginCommandRegistration, PluginCommandShortcut, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, PluginFileOpenerProps, PluginFileOpenerRegistration, PluginFileOpenerSource, PluginFixedTabDeclaration, PluginFixedTabRegistration, PluginHomepageSectionProps, PluginHomepageSectionRegistration, PluginMachineProviderInputsChange, PluginMachineProviderInputsProps, PluginMachineProviderInputsRegistration, PluginMessageActionContext, PluginMessageActionRegistration, PluginMessageDirectiveMessage, PluginMessageDirectiveOpenWorkspaceFile, PluginMessageDirectiveProps, PluginMessageDirectiveRegistration, PluginNavPanelProps, PluginNavPanelRegistration, PluginNewThreadPanelActionContext, PluginNewThreadPanelActionRegistration, PluginNewThreadPanelProps, PluginPanelActionOpenOptions, PluginPendingInteractionProps, PluginPendingInteractionRegistration, PluginPendingInteractionView, PluginProviderIconRegistration, PluginProvidersState, PluginRealtimeConnectionState, PluginRpcCallArgs, PluginRpcClient, PluginRpcContract, PluginRpcError, PluginRpcErrorCode, PluginRpcHandlers, PluginRpcIssuePathSegment, PluginRpcMethodContract, PluginRpcResult, PluginRpcValidationIssue, PluginSdkApp, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsState, PluginSidebarFooterActionContext, PluginSidebarFooterActionProps, PluginSidebarFooterActionRegistration, PluginSidebarProject, PluginSidebarPullRequest, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginTargetedPanelActionOpenOptions, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, ReadonlyJsonValue, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps, UseBranchesArgs, UseCheckoutStateArgs };

package/bundled-types/bb-plugin-sdk-host.d.ts

@@ -19,6 +19,14 @@ interface StandardSchemaV1<Input = unknown, Output = Input> {
         readonly version: 1;
         readonly vendor: string;
         readonly validate: (value: unknown) => StandardSchemaV1Result<Output> | Promise<StandardSchemaV1Result<Output>>;
+        readonly jsonSchema?: {
+            readonly input: (options: {
+                target: string;
+            }) => Record<string, unknown>;
+            readonly output: (options: {
+                target: string;
+            }) => Record<string, unknown>;
+        };
         readonly types?: {
             readonly input: Input;
             readonly output: Output;
@@ -40,6 +48,7 @@ interface StandardSchemaV1Issue {
 type StandardSchemaV1InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["input"];
 type StandardSchemaV1InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["output"];
 interface PluginRpcMethodContract<InputSchema extends StandardSchemaV1 = StandardSchemaV1, OutputSchema extends StandardSchemaV1 = StandardSchemaV1> {
+    readonly experimental_description?: string;
     readonly input: InputSchema;
     readonly output: OutputSchema;
 }

package/bundled-types/bb-plugin-sdk-internal-host-policy.d.ts

@@ -427,6 +427,8 @@ declare const threadQueuedMessageSchema: z.ZodObject<{
         kind: z.ZodLiteral<"time">;
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"thread-busy">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"stopping">;
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"turn-starting">;
     }, z.core.$strip>, z.ZodObject<{
@@ -693,7 +695,9 @@ interface PluginMachineProviderDefinition<S extends PluginMachineProviderInputsS
         report: PluginMachineProviderProgress;
         signal: AbortSignal;
     }): Promise<PluginMachineProviderRemoveResult>;
+    /** Idempotent: preserve saved state when compute is already stopped; save and stop any remaining compute, including during reconciliation of a suspended machine. */
     suspend?(context: PluginMachineProviderResourceLifecycleContext): Promise<PluginMachineProviderResourceResult>;
+    /** Idempotent: reuse existing running compute instead of allocating a duplicate. */
     resume?(context: PluginMachineProviderResourceLifecycleContext): Promise<PluginMachineProviderResourceResult>;
     remove(context: PluginMachineProviderRemoveContext): Promise<PluginMachineProviderRemoveResult>;
 }
@@ -733,6 +737,14 @@ interface StandardSchemaV1<Input = unknown, Output = Input> {
         readonly version: 1;
         readonly vendor: string;
         readonly validate: (value: unknown) => StandardSchemaV1Result<Output> | Promise<StandardSchemaV1Result<Output>>;
+        readonly jsonSchema?: {
+            readonly input: (options: {
+                target: string;
+            }) => Record<string, unknown>;
+            readonly output: (options: {
+                target: string;
+            }) => Record<string, unknown>;
+        };
         readonly types?: {
             readonly input: Input;
             readonly output: Output;
@@ -751,6 +763,11 @@ interface StandardSchemaV1Issue {
         readonly key: PropertyKey;
     })[];
 }
+interface PluginRpcMethodContract<InputSchema extends StandardSchemaV1 = StandardSchemaV1, OutputSchema extends StandardSchemaV1 = StandardSchemaV1> {
+    readonly experimental_description?: string;
+    readonly input: InputSchema;
+    readonly output: OutputSchema;
+}
 
 type PluginSettingDescriptor = {
     type: "string";
@@ -1006,6 +1023,16 @@ interface MessageDispatchHookContext {
      * double-count.
      */
     queuedMessage: ThreadQueuedMessage | null;
+    /**
+     * Opaque JSON supplied by a plugin through the composer's
+     * `experimental_submit`, paired with that plugin's id. Null for ordinary
+     * submissions and queued re-attempts. Core does not persist or interpret
+     * the data.
+     */
+    experimental_submission: {
+        pluginId: string;
+        data: JsonValue;
+    } | null;
     /** How the dispatch was requested; null for internal/core-driven sends. */
     origin: ThreadCreateOrigin | null;
     originPluginId: string | null;
@@ -1286,6 +1313,8 @@ interface PluginProviderOptionsContext {
 }
 /** See {@link PluginProviderDeclaration.models}. */
 type PluginProviderModelCatalogScope = "host" | "workspace";
+/** See {@link PluginProviderDeclaration.completedTurnDisplay}. */
+type PluginProviderCompletedTurnDisplay = "collapse" | "flat";
 /**
  * One cold-cache fallback model. The provider's live `model/list` result is
  * the only real model source; this list stands in only while no probe has
@@ -1392,6 +1421,16 @@ interface PluginProviderDeclaration {
     /** Composer actions this provider supports. No duplicates; may be empty
      * (the universal skills typeahead is implicit). */
     composerActions: readonly PluginProviderComposerAction[];
+    /**
+     * How the thread timeline shows this provider's turns once they finish.
+     * `"collapse"` (the default) folds a finished turn's work into one
+     * "Worked for" row and leaves the final answer visible. `"flat"` keeps
+     * every row of a finished turn visible, as it was while the turn ran. This
+     * is only the provider's default: the user can choose either display for
+     * each provider in Settings → Providers or with
+     * `bb settings completed-turns`, and that choice wins.
+     */
+    completedTurnDisplay?: PluginProviderCompletedTurnDisplay;
     /** Provider copy for core surfaces ({@link PluginProviderStrings}). */
     strings?: PluginProviderStrings;
     /** Service tiers this provider accepts, as picker options. Non-empty when
@@ -1509,6 +1548,16 @@ interface PluginMentionItem {
     subtitle?: string;
     icon?: string;
 }
+/** Agent-only image context resolved with a plugin mention. */
+type ExperimentalPluginMentionImage = {
+    type: "image";
+    url: string;
+    context?: string;
+} | {
+    type: "localImage";
+    path: string;
+    context?: string;
+};
 interface PluginMentionProviderRegistration {
     /** Unique within this plugin: [a-zA-Z0-9_-]+ (no ":" — the host composes
      * wire item ids as "<providerId>:<itemId>"). */
@@ -1535,8 +1584,10 @@ interface PluginMentionProviderRegistration {
      */
     resolve(itemId: string): {
         context: string;
+        experimental_images?: readonly ExperimentalPluginMentionImage[];
     } | Promise<{
         context: string;
+        experimental_images?: readonly ExperimentalPluginMentionImage[];
     }>;
 }
 /**
@@ -1668,6 +1719,7 @@ type NormalizedPluginProviderDeclaration = Omit<PluginProviderDeclaration, "expe
     readonly experimental_nativeSkillRoots?: ProviderNativeRoots;
     readonly experimental_nativeCommandRoots?: ProviderNativeRoots;
     readonly experimental_resolvesNativeRoots: boolean;
+    readonly completedTurnDisplay: PluginProviderCompletedTurnDisplay;
     readonly maintenance: {
         readonly health: boolean;
         readonly usage: boolean;
@@ -1691,6 +1743,17 @@ declare function deriveValidatedProviderOptions(args: {
     context: Parameters<NonNullable<PluginProviderDeclaration["deriveProviderOptions"]>>[0];
 }): Readonly<Record<string, JsonValue>>;
 declare function isStandardSchema(value: unknown): value is StandardSchemaV1;
+declare function readRpcPublicationOptions(value: unknown): {
+    experimental_discoverable: boolean;
+    experimental_description: string | null;
+};
+declare function publishRpcMethod(method: string, contract: PluginRpcMethodContract, options: ReturnType<typeof readRpcPublicationOptions>): {
+    method: string;
+    registrationDescription: string | null;
+    methodDescription: string | null;
+    inputSchema: Record<string, JsonValue$1>;
+    outputSchema: Record<string, JsonValue$1>;
+} | null;
 /**
  * The declared shape of `presentation`, copied field by field so
  * a plugin's object cannot smuggle prototypes or extra markup into the
@@ -1827,11 +1890,12 @@ declare function normalizeWebSocketRouteRegistration(path: string, handler: unkn
     auth: PluginHttpAuthMode;
 };
 type RpcRegistrationRecord = {
+    publication: ReturnType<typeof publishRpcMethod>;
     inputSchema: StandardSchemaV1;
     outputSchema: StandardSchemaV1;
     handler: (input: unknown) => unknown;
 };
-declare function normalizeRpcRegistration(contract: unknown, handlers: unknown, registered: ReadonlyMap<string, unknown>): Array<[string, RpcRegistrationRecord]>;
+declare function normalizeRpcRegistration(contract: unknown, handlers: unknown, registered: ReadonlyMap<string, unknown>, options: unknown): Array<[string, RpcRegistrationRecord]>;
 declare function normalizeRealtimePayload(channel: string, payload: unknown): unknown;
 declare function validateBackgroundServiceRegistration(name: string, service: {
     start(signal: AbortSignal): void | Promise<void>;
@@ -1913,5 +1977,5 @@ declare function normalizePluginAgentConfiguration(args: {
 declare function validateRpcValue(schema: StandardSchemaV1, value: unknown, phase: "input" | "output", fail: (error: PluginRpcError) => never): Promise<unknown>;
 declare function normalizeRpcJsonResult(value: unknown, fail: (error: PluginRpcError) => never): JsonValue;
 
-export { ENVIRONMENT_PROVIDER_DESCRIPTION_MAX_CHARS, ENVIRONMENT_PROVIDER_DISPLAY_NAME_MAX_CHARS, ENVIRONMENT_PROVIDER_ID_PATTERN, ENVIRONMENT_PROVIDER_REQUIREMENT_NAMES, KV_VALUE_MAX_BYTES, MACHINE_PROVIDER_DESCRIPTION_MAX_CHARS, PLUGIN_AGENT_STATUS_LABEL_MAX_CHARS, PLUGIN_MENTION_TRIGGER_VALUES, PLUGIN_PROVIDER_BRIDGE_OPTIONS_MAX_BYTES, PLUGIN_PROVIDER_COMPOSER_ACTION_VALUES, PLUGIN_PROVIDER_DISPLAY_NAME_MAX_CHARS, PLUGIN_PROVIDER_ENV_MAX_ENTRIES, PLUGIN_PROVIDER_ENV_NAME_PATTERN, PLUGIN_PROVIDER_PERMISSION_MODE_VALUES, PLUGIN_PROVIDER_REASONING_LEVEL_VALUES, PROVIDER_ID_PATTERN, RESERVED_AGENT_TOOL_NAMES, RESERVED_BB_CLI_COMMANDS, SERVER_DIRECT_AI_SERVICE_IDS, SETTING_KEY_PATTERN, adoptHttpRouteResponse, aiServiceAlreadyRegisteredMessage, assertAiServiceRegistrable, coerceStoredPluginSettingValue, deriveValidatedProviderOptions, enforcePluginCliOutputLimit, environmentCompositionSchema, isPluginMentionTrigger, isStandardSchema, normalizeAgentToolRegistration, normalizeCliRegistration, normalizeHttpRouteRegistration, normalizeInteractionRequest, normalizeMentionProviderRegistration, normalizePluginAgentConfiguration, normalizeRealtimePayload, normalizeRpcJsonResult, normalizeRpcRegistration, normalizeWebSocketRouteRegistration, parsePluginAgentToolPresentation, pluginCliCollisionWarning, pluginHookAlreadyRegisteredMessage, providerAlreadyRegisteredMessage, providerIconRefusalMessage, providerWithoutBridgeMessage, registerSettingDescriptors, runPluginStorageMigrations, storePluginHook, summarizeStandardIssues, undeclaredIconProblem, validateBackgroundServiceRegistration, validatePluginAiServiceDeclaration, validatePluginEnvironmentProviderDeclaration, validatePluginMachineProviderDeclaration, validatePluginProviderDeclaration, validatePluginProviderEnvEntries, validateProviderEnvContribution, validateRpcValue, validateScheduleRegistration, validateServerAccessProviderDeclaration, validateSettingsUpdate };
+export { ENVIRONMENT_PROVIDER_DESCRIPTION_MAX_CHARS, ENVIRONMENT_PROVIDER_DISPLAY_NAME_MAX_CHARS, ENVIRONMENT_PROVIDER_ID_PATTERN, ENVIRONMENT_PROVIDER_REQUIREMENT_NAMES, KV_VALUE_MAX_BYTES, MACHINE_PROVIDER_DESCRIPTION_MAX_CHARS, PLUGIN_AGENT_STATUS_LABEL_MAX_CHARS, PLUGIN_MENTION_TRIGGER_VALUES, PLUGIN_PROVIDER_BRIDGE_OPTIONS_MAX_BYTES, PLUGIN_PROVIDER_COMPOSER_ACTION_VALUES, PLUGIN_PROVIDER_DISPLAY_NAME_MAX_CHARS, PLUGIN_PROVIDER_ENV_MAX_ENTRIES, PLUGIN_PROVIDER_ENV_NAME_PATTERN, PLUGIN_PROVIDER_PERMISSION_MODE_VALUES, PLUGIN_PROVIDER_REASONING_LEVEL_VALUES, PROVIDER_ID_PATTERN, RESERVED_AGENT_TOOL_NAMES, RESERVED_BB_CLI_COMMANDS, SERVER_DIRECT_AI_SERVICE_IDS, SETTING_KEY_PATTERN, adoptHttpRouteResponse, aiServiceAlreadyRegisteredMessage, assertAiServiceRegistrable, coerceStoredPluginSettingValue, deriveValidatedProviderOptions, enforcePluginCliOutputLimit, environmentCompositionSchema, isPluginMentionTrigger, isStandardSchema, normalizeAgentToolRegistration, normalizeCliRegistration, normalizeHttpRouteRegistration, normalizeInteractionRequest, normalizeMentionProviderRegistration, normalizePluginAgentConfiguration, normalizeRealtimePayload, normalizeRpcJsonResult, normalizeRpcRegistration, normalizeWebSocketRouteRegistration, parsePluginAgentToolPresentation, pluginCliCollisionWarning, pluginHookAlreadyRegisteredMessage, providerAlreadyRegisteredMessage, providerIconRefusalMessage, providerWithoutBridgeMessage, publishRpcMethod, readRpcPublicationOptions, registerSettingDescriptors, runPluginStorageMigrations, storePluginHook, summarizeStandardIssues, undeclaredIconProblem, validateBackgroundServiceRegistration, validatePluginAiServiceDeclaration, validatePluginEnvironmentProviderDeclaration, validatePluginMachineProviderDeclaration, validatePluginProviderDeclaration, validatePluginProviderEnvEntries, validateProviderEnvContribution, validateRpcValue, validateScheduleRegistration, validateServerAccessProviderDeclaration, validateSettingsUpdate };
 export type { AiServiceHostBinding, NormalizedPluginEnvironmentComposition, NormalizedPluginEnvironmentProvider, NormalizedPluginEnvironmentProviderRequirements, NormalizedPluginMachineProvider, NormalizedPluginProviderDeclaration };

package/bundled-types/bb-plugin-sdk-internal-plugin-app-collector.d.ts

@@ -5,7 +5,8 @@
 // Confused by the API, or need a symbol that isn't here? Clone the BB repo
 // and read the real source: https://github.com/get-bb/bb
 
-import { ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterItemRegistration, PluginHomepageSectionRegistration, PluginSettingsSectionRegistration, ExperimentalAppOverlayRegistration, PluginNavPanelRegistration, PluginThreadPanelActionRegistration, PluginNewThreadPanelActionRegistration, ComposerCustomization, PluginPendingInteractionRegistration, PluginSidebarFooterActionRegistration, ExperimentalSidebarNavigationRegistration, PluginThreadListRegistration, PluginThreadHeaderActionRegistration, PluginFileOpenerRegistration, PluginSourceCodeRendererRegistration, PluginDiffRendererRegistration, PluginMessageDirectiveRegistration, PluginMessageActionRegistration, PluginCommandPaletteActionRegistration, PluginProviderIconRegistration, ExperimentalIconRegistration, PluginTimelineRendererRegistration, PluginEnvironmentProviderInputsRegistration, PluginMachineProviderInputsRegistration, PluginContentScriptRegistration, PluginAppDefinition } from '@get-bb/plugin-sdk';
+import { z } from 'zod';
+import { ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterItemRegistration, PluginHomepageSectionRegistration, PluginSettingsSectionRegistration, ExperimentalAppOverlayRegistration, PluginNavPanelRegistration, PluginThreadPanelActionRegistration, PluginNewThreadPanelActionRegistration, ComposerCustomization, PluginPendingInteractionRegistration, PluginSidebarFooterActionRegistration, ExperimentalSidebarNavigationRegistration, PluginThreadListRegistration, PluginThreadHeaderActionRegistration, ExperimentalPluginBrowserToolbarActionRegistration, PluginFileOpenerRegistration, PluginSourceCodeRendererRegistration, PluginDiffRendererRegistration, PluginMessageDirectiveRegistration, PluginMessageActionRegistration, PluginCommandRegistration, PluginProviderIconRegistration, ExperimentalIconRegistration, PluginTimelineRendererRegistration, PluginEnvironmentProviderInputsRegistration, PluginMachineProviderInputsRegistration, PluginContentScriptRegistration, PluginAppDefinition } from '@get-bb/plugin-sdk';
 
 type ExperimentalSidebarFooterCommandKind = "close" | "open" | "toggle";
 interface ExperimentalSidebarFooterRuntimeSnapshot {
@@ -40,6 +41,17 @@ type CollectedPluginProviderIconRegistration = Omit<PluginProviderIconRegistrati
     providerKind: PluginProviderIconRegistration["providerKind"] | "all";
 };
 /** Validated registrations produced by one plugin app setup execution. */
+declare const commandShortcutSchema: z.ZodObject<{
+    alt: z.ZodDefault<z.ZodBoolean>;
+    control: z.ZodDefault<z.ZodBoolean>;
+    key: z.ZodString;
+    meta: z.ZodDefault<z.ZodBoolean>;
+    mod: z.ZodDefault<z.ZodBoolean>;
+    shift: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+interface CollectedPluginCommandRegistration extends Omit<PluginCommandRegistration, "defaultShortcut"> {
+    defaultShortcut: z.infer<typeof commandShortcutSchema> | null;
+}
 interface CollectedPluginAppRegistrations {
     homepageSections: PluginHomepageSectionRegistration[];
     settingsSections: PluginSettingsSectionRegistration[];
@@ -54,12 +66,13 @@ interface CollectedPluginAppRegistrations {
     experimentalSidebarNavigations: ExperimentalSidebarNavigationRegistration[];
     threadLists: PluginThreadListRegistration[];
     threadHeaderActions: PluginThreadHeaderActionRegistration[];
+    browserToolbarActions: ExperimentalPluginBrowserToolbarActionRegistration[];
     fileOpeners: PluginFileOpenerRegistration[];
     sourceCodeRenderers: PluginSourceCodeRendererRegistration[];
     diffRenderers: PluginDiffRendererRegistration[];
     messageDirectives: PluginMessageDirectiveRegistration[];
     messageActions: PluginMessageActionRegistration[];
-    commandPaletteActions: PluginCommandPaletteActionRegistration[];
+    commandPaletteActions: CollectedPluginCommandRegistration[];
     providerIcons: CollectedPluginProviderIconRegistration[];
     icons: ExperimentalIconRegistration[];
     timelineRenderers: PluginTimelineRendererRegistration[];
@@ -77,4 +90,4 @@ declare function getCollectedSidebarFooterItems(registrations: object): readonly
 declare function collectPluginAppRegistrations(definition: PluginAppDefinition, onComposerCustomizationRejected?: (reason: string) => void): CollectedPluginAppRegistrations;
 
 export { adaptSidebarFooterAction, collectPluginAppRegistrations, getCollectedSidebarFooterItems };
-export type { CollectedCompatibilitySidebarFooterItem, CollectedExperimentalSidebarFooterItem, CollectedManagedSidebarFooterItem, CollectedPluginAppRegistrations, CollectedPluginProviderIconRegistration, CollectedSidebarFooterItem, ExperimentalSidebarFooterCommandKind, ExperimentalSidebarFooterItemRuntime, ExperimentalSidebarFooterRuntimeSnapshot };
+export type { CollectedCompatibilitySidebarFooterItem, CollectedExperimentalSidebarFooterItem, CollectedManagedSidebarFooterItem, CollectedPluginAppRegistrations, CollectedPluginCommandRegistration, CollectedPluginProviderIconRegistration, CollectedSidebarFooterItem, ExperimentalSidebarFooterCommandKind, ExperimentalSidebarFooterItemRuntime, ExperimentalSidebarFooterRuntimeSnapshot };

package/bundled-types/bb-plugin-sdk-machine-provider.d.ts

@@ -76,7 +76,9 @@ interface PluginMachineProviderDefinition<S extends PluginMachineProviderInputsS
         report: PluginMachineProviderProgress;
         signal: AbortSignal;
     }): Promise<PluginMachineProviderRemoveResult>;
+    /** Idempotent: preserve saved state when compute is already stopped; save and stop any remaining compute, including during reconciliation of a suspended machine. */
     suspend?(context: PluginMachineProviderResourceLifecycleContext): Promise<PluginMachineProviderResourceResult>;
+    /** Idempotent: reuse existing running compute instead of allocating a duplicate. */
     resume?(context: PluginMachineProviderResourceLifecycleContext): Promise<PluginMachineProviderResourceResult>;
     remove(context: PluginMachineProviderRemoveContext): Promise<PluginMachineProviderRemoveResult>;
 }

package/bundled-types/bb-plugin-sdk-provider-bridge-testing.d.ts

@@ -3132,6 +3132,8 @@ declare const threadEventSchema: z.ZodPipe<z.ZodUnknown, z.ZodUnion<readonly [z.
     threadId: z.ZodString;
     tokenUsage: z.ZodObject<{
         last: z.ZodObject<{
+            cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+            cacheWriteInputTokens: z.ZodOptional<z.ZodNumber>;
             cachedInputTokens: z.ZodNumber;
             inputTokens: z.ZodNumber;
             outputTokens: z.ZodNumber;
@@ -3140,6 +3142,8 @@ declare const threadEventSchema: z.ZodPipe<z.ZodUnknown, z.ZodUnion<readonly [z.
         }, z.core.$strip>;
         modelContextWindow: z.ZodNullable<z.ZodNumber>;
         total: z.ZodObject<{
+            cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+            cacheWriteInputTokens: z.ZodOptional<z.ZodNumber>;
             cachedInputTokens: z.ZodNumber;
             inputTokens: z.ZodNumber;
             outputTokens: z.ZodNumber;
@@ -4732,6 +4736,8 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"usage">;
     last: z.ZodObject<{
+        cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheWriteInputTokens: z.ZodOptional<z.ZodNumber>;
         cachedInputTokens: z.ZodNumber;
         inputTokens: z.ZodNumber;
         outputTokens: z.ZodNumber;
@@ -4741,6 +4747,8 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     modelContextWindow: z.ZodNullable<z.ZodNumber>;
     providerTurnId: z.ZodOptional<z.ZodString>;
     total: z.ZodObject<{
+        cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheWriteInputTokens: z.ZodOptional<z.ZodNumber>;
         cachedInputTokens: z.ZodNumber;
         inputTokens: z.ZodNumber;
         outputTokens: z.ZodNumber;

package/bundled-types/bb-plugin-sdk-provider-bridge.d.ts

@@ -414,6 +414,8 @@ declare const threadEventUserContentSchema: z.ZodDiscriminatedUnion<[z.ZodObject
 }, z.core.$strip>], "type">;
 type ThreadEventUserContent = z.infer<typeof threadEventUserContentSchema>;
 declare const threadEventTokenUsageBreakdownSchema: z.ZodObject<{
+    cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+    cacheWriteInputTokens: z.ZodOptional<z.ZodNumber>;
     cachedInputTokens: z.ZodNumber;
     inputTokens: z.ZodNumber;
     outputTokens: z.ZodNumber;
@@ -2912,6 +2914,8 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"usage">;
     last: z.ZodObject<{
+        cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheWriteInputTokens: z.ZodOptional<z.ZodNumber>;
         cachedInputTokens: z.ZodNumber;
         inputTokens: z.ZodNumber;
         outputTokens: z.ZodNumber;
@@ -2921,6 +2925,8 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     modelContextWindow: z.ZodNullable<z.ZodNumber>;
     providerTurnId: z.ZodOptional<z.ZodString>;
     total: z.ZodObject<{
+        cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheWriteInputTokens: z.ZodOptional<z.ZodNumber>;
         cachedInputTokens: z.ZodNumber;
         inputTokens: z.ZodNumber;
         outputTokens: z.ZodNumber;
@@ -3753,6 +3759,8 @@ declare const threadDeltaNotificationParamsSchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"usage">;
         last: z.ZodObject<{
+            cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+            cacheWriteInputTokens: z.ZodOptional<z.ZodNumber>;
             cachedInputTokens: z.ZodNumber;
             inputTokens: z.ZodNumber;
             outputTokens: z.ZodNumber;
@@ -3762,6 +3770,8 @@ declare const threadDeltaNotificationParamsSchema: z.ZodObject<{
         modelContextWindow: z.ZodNullable<z.ZodNumber>;
         providerTurnId: z.ZodOptional<z.ZodString>;
         total: z.ZodObject<{
+            cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+            cacheWriteInputTokens: z.ZodOptional<z.ZodNumber>;
             cachedInputTokens: z.ZodNumber;
             inputTokens: z.ZodNumber;
             outputTokens: z.ZodNumber;

package/bundled-types/bb-plugin-sdk-testing-app.d.ts

@@ -7,7 +7,7 @@
 
 import { ReactNode, ComponentType } from 'react';
 import { RenderResult } from '@testing-library/react';
-import { ExperimentalSidebarFooterItemRegistration, PluginProviderIconRegistration, PluginHomepageSectionRegistration, PluginSettingsSectionRegistration, ExperimentalAppOverlayRegistration, PluginNavPanelRegistration, PluginThreadPanelActionRegistration, PluginNewThreadPanelActionRegistration, ComposerCustomization, PluginPendingInteractionRegistration, PluginSidebarFooterActionRegistration, ExperimentalSidebarNavigationRegistration, PluginThreadListRegistration, PluginThreadHeaderActionRegistration, PluginFileOpenerRegistration, PluginSourceCodeRendererRegistration, PluginDiffRendererRegistration, PluginMessageDirectiveRegistration, PluginMessageActionRegistration, ExperimentalIconRegistration, PluginTimelineRendererRegistration, PluginEnvironmentProviderInputsRegistration, PluginMachineProviderInputsRegistration, PluginContentScriptRegistration, PluginComposerScope, PluginComposerTextEffect, PluginComposerMention, PluginComposerThreadRowStatus, ExperimentalOpenFixedTabOptions, JsonValue, BbNavigate, ExperimentalFileOpenOptions, PluginAppDefinition, PluginRpcContract, StandardSchemaV1InferInput, PluginRpcResult, PluginRealtimeConnectionState, PluginSidebarThreadsState, PluginProvidersState, PluginCodeThemeState, BranchesState, CheckoutState, PluginSidebarPullRequest, PluginSidebarThreadActions } from '@get-bb/plugin-sdk';
+import { ExperimentalSidebarFooterItemRegistration, PluginProviderIconRegistration, PluginHomepageSectionRegistration, PluginSettingsSectionRegistration, ExperimentalAppOverlayRegistration, PluginNavPanelRegistration, PluginThreadPanelActionRegistration, PluginNewThreadPanelActionRegistration, ComposerCustomization, PluginPendingInteractionRegistration, PluginSidebarFooterActionRegistration, ExperimentalSidebarNavigationRegistration, PluginThreadListRegistration, PluginThreadHeaderActionRegistration, ExperimentalPluginBrowserToolbarActionRegistration, PluginFileOpenerRegistration, PluginSourceCodeRendererRegistration, PluginDiffRendererRegistration, PluginMessageDirectiveRegistration, PluginMessageActionRegistration, ExperimentalIconRegistration, PluginTimelineRendererRegistration, PluginEnvironmentProviderInputsRegistration, PluginMachineProviderInputsRegistration, PluginContentScriptRegistration, PluginComposerScope, PluginComposerTextEffect, PluginComposerMention, ExperimentalComposerSubmitOptions, PluginComposerThreadRowStatus, ExperimentalOpenFixedTabOptions, JsonValue, BbNavigate, ExperimentalFileOpenOptions, PluginAppDefinition, PluginRpcContract, StandardSchemaV1InferInput, PluginRpcResult, PluginRealtimeConnectionState, PluginSidebarThreadsState, PluginProvidersState, PluginCodeThemeState, BranchesState, CheckoutState, PluginSidebarPullRequest, PluginSidebarThreadActions } from '@get-bb/plugin-sdk';
 
 type ExperimentalSidebarFooterCommandKind = "close" | "open" | "toggle";
 interface ExperimentalSidebarFooterRuntimeSnapshot {
@@ -115,9 +115,7 @@ interface ComposerLog {
      * has no submit pipeline of its own, so it records the options and clears the
      * draft — enough to assert what a picker scheduled and that it tidied up.
      */
-    submits: Array<{
-        sendAt: number;
-    }>;
+    submits: ExperimentalComposerSubmitOptions[];
 }
 /** One recorded `experimental_useSidebarThreadActions()` call. */
 interface SidebarActionCall {
@@ -148,6 +146,7 @@ interface CapturedPluginApp {
     experimentalSidebarNavigations: ExperimentalSidebarNavigationRegistration[];
     threadLists: PluginThreadListRegistration[];
     threadHeaderActions: PluginThreadHeaderActionRegistration[];
+    browserToolbarActions: ExperimentalPluginBrowserToolbarActionRegistration[];
     fileOpeners: PluginFileOpenerRegistration[];
     sourceCodeRenderers: PluginSourceCodeRendererRegistration[];
     diffRenderers: PluginDiffRendererRegistration[];