@get-bb/plugin-sdk 0.5.9 → 0.5.15

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

@@ -149,7 +149,7 @@ declare const appSettingsUpdateSchema: z$1.ZodUnion<readonly [z$1.ZodObject<{
 }, z$1.core.$strict>]>;
 type AppSettingsUpdate = z$1.infer<typeof appSettingsUpdateSchema>;
 
-declare const UI_PREFERENCE_KEYS: readonly ["sidebar.organizationMode", "sidebar.threadGrouping.environment", "sidebar.chronologicalSort", "sidebar.sortDirection", "sidebar.sectionOrder", "sidebar.manualSectionOrder", "sidebar.machineSectionOrder", "sidebar.hiddenGroups", "sidebar.collapsedSections", "sidebar.collapsedProjects", "sidebar.collapsedThreads", "sidebar.collapsedEnvironments", "sidebar.collapsedThreadSections", "sidebar.collapsedMachines", "sidebar.footerOrder", "sidebar.hiddenFooterItems", "sidebar.pluginPanelOrder", "sidebar.visiblePluginPanels", "sidebar.navigationProvider", "sidebar.threadListProvider"];
+declare const UI_PREFERENCE_KEYS: readonly ["sidebar.organizationMode", "sidebar.threadGrouping.environment", "sidebar.chronologicalSort", "sidebar.sortDirection", "sidebar.sectionOrder", "sidebar.manualSectionOrder", "sidebar.machineSectionOrder", "sidebar.hiddenGroups", "sidebar.collapsedSections", "sidebar.collapsedProjects", "sidebar.collapsedThreads", "sidebar.collapsedEnvironments", "sidebar.collapsedThreadSections", "sidebar.collapsedMachines", "sidebar.footerOrder", "sidebar.hiddenFooterItems", "sidebar.pluginPanelOrder", "sidebar.visiblePluginPanels", "sidebar.navigationProvider", "sidebar.headerProvider", "sidebar.threadListProvider"];
 type UiPreferenceKey = (typeof UI_PREFERENCE_KEYS)[number];
 interface UiPreferenceDefinition<Schema extends z$1.ZodTypeAny = z$1.ZodTypeAny> {
     schema: Schema;
@@ -191,7 +191,8 @@ declare const uiPreferenceDefinitions: {
     readonly "sidebar.hiddenFooterItems": UiPreferenceDefinition<z$1.ZodArray<z$1.ZodString>>;
     readonly "sidebar.pluginPanelOrder": UiPreferenceDefinition<z$1.ZodArray<z$1.ZodString>>;
     readonly "sidebar.visiblePluginPanels": UiPreferenceDefinition<z$1.ZodNullable<z$1.ZodArray<z$1.ZodString>>>;
-    readonly "sidebar.navigationProvider": UiPreferenceDefinition<z$1.ZodString>;
+    readonly "sidebar.navigationProvider": UiPreferenceDefinition<z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<string, string>>>;
+    readonly "sidebar.headerProvider": UiPreferenceDefinition<z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<string, string>>>;
     readonly "sidebar.threadListProvider": UiPreferenceDefinition<z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<string, string>>>;
 };
 type UiPreferenceValue<Key extends UiPreferenceKey> = z$1.infer<(typeof uiPreferenceDefinitions)[Key]["schema"]>;
@@ -5867,18 +5868,20 @@ declare const hostDaemonCommandRegistry: {
     }, z$1.core.$strict>, z$1.ZodObject<{
         sources: z$1.ZodArray<z$1.ZodObject<{
             icon: z$1.ZodOptional<z$1.ZodString>;
-            id: z$1.ZodEnum<{
+            id: z$1.ZodUnion<readonly [z$1.ZodEnum<{
                 arc: "arc";
                 brave: "brave";
                 chrome: "chrome";
                 chromium: "chromium";
+                dia: "dia";
                 edge: "edge";
                 firefox: "firefox";
                 helium: "helium";
                 opera: "opera";
                 safari: "safari";
                 vivaldi: "vivaldi";
-            }>;
+                zen: "zen";
+            }>, z$1.ZodString]>;
             name: z$1.ZodString;
             profiles: z$1.ZodArray<z$1.ZodObject<{
                 cookieCount: z$1.ZodOptional<z$1.ZodNumber>;
@@ -5904,18 +5907,20 @@ declare const hostDaemonCommandRegistry: {
         }, z$1.core.$strip>, z$1.ZodObject<{
             kind: z$1.ZodLiteral<"personal">;
         }, z$1.core.$strip>], "kind">;
-        sourceId: z$1.ZodEnum<{
+        sourceId: z$1.ZodUnion<readonly [z$1.ZodEnum<{
             arc: "arc";
             brave: "brave";
             chrome: "chrome";
             chromium: "chromium";
+            dia: "dia";
             edge: "edge";
             firefox: "firefox";
             helium: "helium";
             opera: "opera";
             safari: "safari";
             vivaldi: "vivaldi";
-        }>;
+            zen: "zen";
+        }>, z$1.ZodString]>;
         sourceProfileDirectory: z$1.ZodString;
         type: z$1.ZodLiteral<"desktop.browser.import_cookies">;
     }, z$1.core.$strict>, z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
@@ -8752,18 +8757,20 @@ declare const desktopBrowserCommandSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObj
     }, z$1.core.$strip>, z$1.ZodObject<{
         kind: z$1.ZodLiteral<"personal">;
     }, z$1.core.$strip>], "kind">;
-    sourceId: z$1.ZodEnum<{
+    sourceId: z$1.ZodUnion<readonly [z$1.ZodEnum<{
         arc: "arc";
         brave: "brave";
         chrome: "chrome";
         chromium: "chromium";
+        dia: "dia";
         edge: "edge";
         firefox: "firefox";
         helium: "helium";
         opera: "opera";
         safari: "safari";
         vivaldi: "vivaldi";
-    }>;
+        zen: "zen";
+    }>, z$1.ZodString]>;
     sourceProfileDirectory: z$1.ZodString;
     type: z$1.ZodLiteral<"desktop.browser.import_cookies">;
 }, z$1.core.$strict>], "type">;
@@ -8850,18 +8857,20 @@ declare const desktopBrowserResultSchemas: {
     "desktop.browser.list_import_sources": z$1.ZodObject<{
         sources: z$1.ZodArray<z$1.ZodObject<{
             icon: z$1.ZodOptional<z$1.ZodString>;
-            id: z$1.ZodEnum<{
+            id: z$1.ZodUnion<readonly [z$1.ZodEnum<{
                 arc: "arc";
                 brave: "brave";
                 chrome: "chrome";
                 chromium: "chromium";
+                dia: "dia";
                 edge: "edge";
                 firefox: "firefox";
                 helium: "helium";
                 opera: "opera";
                 safari: "safari";
                 vivaldi: "vivaldi";
-            }>;
+                zen: "zen";
+            }>, z$1.ZodString]>;
             name: z$1.ZodString;
             profiles: z$1.ZodArray<z$1.ZodObject<{
                 cookieCount: z$1.ZodOptional<z$1.ZodNumber>;
@@ -14512,18 +14521,20 @@ declare const desktopBrowserImportCookiesRequestSchema: z$1.ZodObject<{
     }, z$1.core.$strip>, z$1.ZodObject<{
         kind: z$1.ZodLiteral<"personal">;
     }, z$1.core.$strip>], "kind">>;
-    sourceId: z$1.ZodEnum<{
+    sourceId: z$1.ZodUnion<readonly [z$1.ZodEnum<{
         arc: "arc";
         brave: "brave";
         chrome: "chrome";
         chromium: "chromium";
+        dia: "dia";
         edge: "edge";
         firefox: "firefox";
         helium: "helium";
         opera: "opera";
         safari: "safari";
         vivaldi: "vivaldi";
-    }>;
+        zen: "zen";
+    }>, z$1.ZodString]>;
     sourceProfileDirectory: z$1.ZodString;
 }, z$1.core.$strict>;
 type ExperimentalDesktopBrowserHostRequest = z$1.infer<typeof desktopBrowserHostRequestSchema>;
@@ -16614,15 +16625,21 @@ type ExperimentalSidebarNavigationAction = {
     kind: "search-threads";
 } | {
     kind: "open-extensions";
+} | {
+    kind: "open-skills";
 } | {
     kind: "open-plugin-panel";
     pluginId: string;
     panelId: string;
 };
-/** Semantic icon identity for one sidebar navigation item. */
+/**
+ * Semantic icon identity for one sidebar navigation item. Render it with
+ * {@link PluginSdkApp.experimental_SidebarNavigationIcon} to match bb's
+ * artwork, including plugin branding.
+ */
 type ExperimentalSidebarNavigationIcon = {
     kind: "host";
-    name: "extensions" | "new-thread" | "search";
+    name: "extensions" | "new-thread" | "search" | "skills";
 } | {
     kind: "plugin";
     pluginId: string;
@@ -16630,28 +16647,164 @@ type ExperimentalSidebarNavigationIcon = {
 };
 /** One host-owned destination or action a plugin may arrange. */
 interface ExperimentalSidebarNavigationItem {
+    /**
+     * Arrangement key, stable across reloads: `__bb__/new-thread`,
+     * `__bb__/search-threads`, `__bb__/extensions`, `__bb__/skills`,
+     * `__bb__/automations`, or `<pluginId>/<panelId>`. The same keys appear in
+     * the `sidebar.pluginPanelOrder` and `sidebar.visiblePluginPanels`
+     * settings.
+     */
     id: string;
     label: string;
     icon: ExperimentalSidebarNavigationIcon;
     action: ExperimentalSidebarNavigationAction;
     isDisabled: boolean;
+    /**
+     * False when the user hid the item from the sidebar. Draw hidden items in an
+     * overflow menu rather than dropping them, so they stay reachable.
+     */
+    isVisible: boolean;
+    /**
+     * A plugin panel remembered from the last session whose bundle has not
+     * registered yet. Activating it does nothing until it loads.
+     */
+    isLoading: boolean;
+    /**
+     * The plugin that contributed this panel; null for bb's own items. Gates
+     * `openDetails` and `disablePlugin`.
+     */
+    pluginId: string | null;
     shortcut: ExperimentalSidebarNavigationShortcut | null;
-    experimental_splitProps: {
-        onPointerDown?: (event: react.PointerEvent<HTMLElement>) => void;
-    };
+    /**
+     * The panel's `experimental_sidebarAccessory`, already wrapped in the host's
+     * crash boundary. Null for bb's items, panels without an accessory, and on
+     * compact viewports. Keep it within one line, about 4rem by 1.25rem.
+     */
+    experimental_Accessory: ComponentType | null;
 }
 /** How the host should activate a sidebar navigation item. */
 interface ExperimentalSidebarNavigationActivationOptions {
     openInSplit: boolean;
 }
-/** Props passed to an `experimental_sidebarNavigation` component. */
-interface ExperimentalSidebarNavigationProps {
+/**
+ * Host behavior for sidebar navigation items (see
+ * {@link ExperimentalSidebarNavigationState}). Unknown item ids are ignored.
+ * Calls made after the calling component unmounts do nothing.
+ */
+interface ExperimentalSidebarNavigationActions {
+    /**
+     * Run the item's host behavior and close the mobile sidebar drawer.
+     * `openInSplit` is ignored where splits are unavailable, and disabled or
+     * loading items do nothing.
+     */
+    activate(itemId: string, options: ExperimentalSidebarNavigationActivationOptions): void;
+    /** Hide or show one item. Persists to `sidebar.visiblePluginPanels`. */
+    setVisible(itemId: string, isVisible: boolean): void;
+    /**
+     * Save a new order. Pass item ids in the order you want; unknown ids are
+     * dropped and ids you leave out keep their relative order after the ones
+     * you pass. Persists to `sidebar.pluginPanelOrder`.
+     */
+    setOrder(itemIds: readonly string[]): void;
+    /** Open bb's customize editor, which reorders and hides items. */
+    openCustomize(): void;
+    /** Open the owning plugin's details. Does nothing when `pluginId` is null. */
+    openDetails(itemId: string): void;
+    /**
+     * Disable the owning plugin, leave its panel if it is open, and show a
+     * toast. Rejects after the host's error toast when disabling fails. Does
+     * nothing when `pluginId` is null.
+     */
+    disablePlugin(itemId: string): Promise<void>;
+}
+/** What {@link PluginSdkApp.experimental_useSidebarNavigation} returns. */
+interface ExperimentalSidebarNavigationState {
+    /** Every item in the user's saved order, visible and hidden. */
     items: readonly ExperimentalSidebarNavigationItem[];
+    /** The item whose destination the route currently shows, or null. */
     activeItemId: string | null;
+    /**
+     * True while the user holds the app command modifier, when bb's own rows
+     * reveal their `shortcut` labels. Show yours at the same time.
+     */
+    isShortcutModifierHeld: boolean;
+    actions: ExperimentalSidebarNavigationActions;
+}
+/**
+ * Per-item drag-to-split support (see
+ * {@link PluginSdkApp.experimental_useSidebarNavigationSplit}). Same contract
+ * as {@link PluginSidebarThreadSplit}.
+ */
+interface ExperimentalSidebarNavigationSplit {
+    /**
+     * Spread onto the item's interactive element. Empty when the item cannot
+     * open in a pane, so spreading it is always safe.
+     */
+    splitProps: {
+        onPointerDown?: (event: react.PointerEvent<HTMLElement>) => void;
+    };
+    /**
+     * False for items that cannot open in a pane (Search, Plugins, Skills), on
+     * compact viewports, and when splits are unavailable.
+     */
+    isAvailable: boolean;
+    /** Where this item's destination sits in the split layout, or null. */
+    layout: {
+        panes: readonly PluginSidebarSplitPane[];
+    } | null;
+}
+/** Options for {@link PluginSdkApp.experimental_useSidebarNavigationSplit}. */
+interface ExperimentalSidebarNavigationSplitOptions {
+    /**
+     * `sidebar` (the default) engages the drag once the pointer leaves the
+     * sidebar, so a row list with its own drag-to-reorder keeps working.
+     * `distance` engages after a short movement in any direction; use it for
+     * rows inside a menu or popover that covers the main area.
+     */
+    activation?: "distance" | "sidebar";
+    /** Called when the drag engages, for example to close the menu the row is in. */
+    onDragStart?: () => void;
+}
+/** Props for {@link PluginSdkApp.experimental_SidebarNavigationIcon}. */
+interface ExperimentalSidebarNavigationIconProps {
+    icon: ExperimentalSidebarNavigationIcon;
+    className?: string;
+}
+/**
+ * Props passed to an `experimental_sidebarNavigation` component. Read the
+ * items and their actions with
+ * {@link PluginSdkApp.experimental_useSidebarNavigation}.
+ */
+interface ExperimentalSidebarNavigationProps {
     isCompactViewport: boolean;
-    experimental_activate(itemId: string, options: ExperimentalSidebarNavigationActivationOptions): void;
+    /**
+     * Renders bb's bundled Navigation plugin, or nothing while it is disabled.
+     * Kept for plugins written before `experimental_useSidebarNavigation`;
+     * render items from that hook instead. Scheduled for removal.
+     *
+     * @deprecated
+     */
     experimental_Original: ComponentType;
 }
+/**
+ * Props passed to an `experimental_sidebarHeader` component, rendered in the
+ * sidebar's header row between the sidebar toggle (and the macOS window
+ * controls) and bb's back and forward buttons.
+ */
+interface ExperimentalSidebarHeaderProps {
+    /**
+     * Width in px of the space the component may use, updated when the sidebar
+     * resizes or the window chrome changes. It can be smaller than
+     * `controlSize` in a narrow sidebar.
+     */
+    width: number;
+    /**
+     * Width and height in px of the header's own buttons, equal to the
+     * `--bb-sidebar-control-size` CSS variable. Size your controls to match.
+     */
+    controlSize: number;
+    isCompactViewport: boolean;
+}
 /**
  * Props passed to an `experimental_threadList` component — the sidebar's
  * scrolling thread area, replaced wholesale by one plugin.
@@ -17752,7 +17905,14 @@ interface PluginThreadListRegistration {
     description?: string;
     component: ComponentType<PluginThreadListProps>;
 }
-/** Replace the bounded navigation controls above the sidebar thread list. */
+/**
+ * Replace the navigation controls above the sidebar thread list. Exclusive:
+ * the user picks one provider under Settings → Appearance → Navigation, and
+ * bb ships its own rows as the bundled Navigation plugin
+ * (`navigation/navigation`, the default). A picked provider that is disabled
+ * or removed falls back to Navigation; a crashing provider is replaced by a
+ * placeholder with a Reload button.
+ */
 interface ExperimentalSidebarNavigationRegistration {
     /** Unique within the plugin; letters, digits, `-`, `_`. */
     id: string;
@@ -17762,6 +17922,23 @@ interface ExperimentalSidebarNavigationRegistration {
     description?: string;
     component: ComponentType<ExperimentalSidebarNavigationProps>;
 }
+/**
+ * Render a component in the sidebar's header row, between the sidebar toggle
+ * and bb's back and forward buttons. Exclusive: the user picks at most one
+ * header under Settings → Appearance, and by default the header shows only
+ * bb's own controls. Content is clipped to the row, so it cannot move the
+ * thread list or bb's controls. On macOS the empty space keeps dragging the
+ * window; buttons, links, and inputs do not.
+ */
+interface ExperimentalSidebarHeaderRegistration {
+    /** Unique within the plugin; letters, digits, `-`, `_`. */
+    id: string;
+    /** Label shown in Settings → Appearance and capability details. */
+    title: string;
+    /** Optional one-line description shown with the provider choice. */
+    description?: string;
+    component: ComponentType<ExperimentalSidebarHeaderProps>;
+}
 /**
  * Register this plugin as a viewer/editor for file extensions. By default,
  * matching files render the first applicable opener in deterministic slot
@@ -18166,6 +18343,12 @@ interface PluginAppSlots {
     sidebarFooterAction(registration: PluginSidebarFooterActionRegistration): void;
     /** Replace the bounded sidebar navigation controls. */
     experimental_sidebarNavigation(registration: ExperimentalSidebarNavigationRegistration): void;
+    /**
+     * Render a component in the sidebar header row (see
+     * {@link ExperimentalSidebarHeaderRegistration}). Experimental: see
+     * docs/api_to_audit.md.
+     */
+    experimental_sidebarHeader(registration: ExperimentalSidebarHeaderRegistration): void;
     /**
      * Replace the sidebar's thread list (see
      * {@link PluginThreadListRegistration}). Experimental: see
@@ -19221,6 +19404,27 @@ interface PluginSdkApp {
      * Experimental: see docs/api_to_audit.md.
      */
     experimental_useSidebarThreadSplit(threadId: string): PluginSidebarThreadSplit;
+    /**
+     * The sidebar navigation items in the user's saved order, the active item,
+     * and the host actions that activate, hide, reorder, and customize them
+     * (see {@link ExperimentalSidebarNavigationState}). One model shared by
+     * every caller in the sidebar. Items keep their identity while unchanged.
+     * Outside the sidebar it returns no items and actions that do nothing.
+     * Experimental: see docs/api_to_audit.md.
+     */
+    experimental_useSidebarNavigation(): ExperimentalSidebarNavigationState;
+    /**
+     * Per-item drag-to-split support for navigation items (see
+     * {@link ExperimentalSidebarNavigationSplit}). Call it once per rendered
+     * item. Experimental: see docs/api_to_audit.md.
+     */
+    experimental_useSidebarNavigationSplit(itemId: string, options?: ExperimentalSidebarNavigationSplitOptions): ExperimentalSidebarNavigationSplit;
+    /**
+     * bb's artwork for a navigation item's icon: bb's glyphs for its own items,
+     * and the contributing plugin's branding for plugin panels. Experimental:
+     * see docs/api_to_audit.md.
+     */
+    experimental_SidebarNavigationIcon: ComponentType<ExperimentalSidebarNavigationIconProps>;
     /**
      * Whether the composer holds an unsent draft for one thread (see
      * {@link PluginSidebarThreadDraftState}). Per row, because a draft is
@@ -19410,6 +19614,9 @@ declare const experimental_useSidebarThreads: (options?: {
 declare const experimental_useSidebarThreadActions: () => PluginSidebarThreadActions;
 declare const experimental_useSidebarThreadPullRequest: (threadId: string) => PluginSidebarThreadPullRequestState;
 declare const experimental_useSidebarThreadSplit: (threadId: string) => PluginSidebarThreadSplit;
+declare const experimental_useSidebarNavigation: () => ExperimentalSidebarNavigationState;
+declare const experimental_useSidebarNavigationSplit: (itemId: string, options?: ExperimentalSidebarNavigationSplitOptions) => ExperimentalSidebarNavigationSplit;
+declare const experimental_SidebarNavigationIcon: react.ComponentType<ExperimentalSidebarNavigationIconProps>;
 declare const useSidebarThreadDraft: (threadId: string) => PluginSidebarThreadDraftState;
 declare const useSidebarThreadDraftIds: () => ReadonlySet<string>;
 declare const useSidebarThreadRowStatus: (threadId: string) => PluginSidebarThreadRowStatus | null;
@@ -19422,5 +19629,5 @@ declare const useSdk: () => PluginBrowserBbSdk;
 declare const experimental_useProviders: () => PluginProvidersState;
 declare const experimental_useCodeTheme: () => PluginCodeThemeState;
 
-export { Markdown, ThreadChat, ThreadTitle, 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, useEnvironmentProviders, useRealtime, useRealtimeConnectionState, useRpc, useSdk, useSettings, useSidebarSplitLayout, useSidebarThreadDraft, useSidebarThreadDraftIds, useSidebarThreadRowStatus, useSidebarThreadRowStatuses, useSidebarThreadShortcut };
-export type { BbContext, BbNavigate, BranchPickerProps, BranchesState, CheckoutState, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppIcons, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSelection, ExperimentalComposerSubmitOptions, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalIconProps, ExperimentalIconRegistration, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginBrowserPage, ExperimentalPluginBrowserPageEvaluateOptions, ExperimentalPluginBrowserPageWorld, 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, PluginBoundThreadsArea, PluginBrowserBbSdk, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandContext, PluginCommandRegistration, PluginCommandShortcut, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginEnvironmentProvider, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, PluginEnvironmentProvidersState, 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, PluginSidebarSection, PluginSidebarSplitLayout, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadDraftState, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadRowStatus, PluginSidebarThreadShortcut, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginTargetedPanelActionOpenOptions, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginThreadTitleProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, ReadonlyJsonValue, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps, UseBranchesArgs, UseCheckoutStateArgs };
+export { Markdown, ThreadChat, ThreadTitle, UrlLink, definePluginApp, experimental_BranchPicker, experimental_Diff, experimental_FileLink, experimental_Icon, experimental_NewThreadComposer, experimental_PermissionModePicker, experimental_ProviderIcon, experimental_ProviderModelPicker, experimental_SidebarNavigationIcon, experimental_SourceCode, experimental_useAppPanel, experimental_useBranches, experimental_useCheckoutState, experimental_useCodeTheme, experimental_useFixedTabTarget, experimental_useProviders, experimental_useSidebarNavigation, experimental_useSidebarNavigationSplit, experimental_useSidebarThreadActions, experimental_useSidebarThreadPullRequest, experimental_useSidebarThreadSplit, experimental_useSidebarThreads, useBbContext, useBbNavigate, useComposer, useComposerView, useEnvironmentProviders, useRealtime, useRealtimeConnectionState, useRpc, useSdk, useSettings, useSidebarSplitLayout, useSidebarThreadDraft, useSidebarThreadDraftIds, useSidebarThreadRowStatus, useSidebarThreadRowStatuses, useSidebarThreadShortcut };
+export type { BbContext, BbNavigate, BranchPickerProps, BranchesState, CheckoutState, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppIcons, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSelection, ExperimentalComposerSubmitOptions, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalIconProps, ExperimentalIconRegistration, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginBrowserPage, ExperimentalPluginBrowserPageEvaluateOptions, ExperimentalPluginBrowserPageWorld, ExperimentalPluginBrowserToolbarActionProps, ExperimentalPluginBrowserToolbarActionRegistration, ExperimentalPluginFixedTabReference, ExperimentalProviderIconProps, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalSidebarFooter, ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterActionRegistration, ExperimentalSidebarFooterDisclosureController, ExperimentalSidebarFooterDisclosureProps, ExperimentalSidebarFooterDisclosureRegistration, ExperimentalSidebarFooterItemBase, ExperimentalSidebarFooterItemRegistration, ExperimentalSidebarHeaderProps, ExperimentalSidebarHeaderRegistration, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActions, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationIconProps, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, ExperimentalSidebarNavigationSplit, ExperimentalSidebarNavigationSplitOptions, ExperimentalSidebarNavigationState, JsonValue$1 as JsonValue, MarkdownProps, NewThreadComposerProps, NewThreadRequest, PluginAppBuilder, PluginAppCommands, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginBoundThreadsArea, PluginBrowserBbSdk, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandContext, PluginCommandRegistration, PluginCommandShortcut, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginEnvironmentProvider, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, PluginEnvironmentProvidersState, 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, PluginSidebarSection, PluginSidebarSplitLayout, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadDraftState, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadRowStatus, PluginSidebarThreadShortcut, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginTargetedPanelActionOpenOptions, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginThreadTitleProps, 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-internal-plugin-app-collector.d.ts

@@ -6,7 +6,7 @@
 // and read the real source: https://github.com/get-bb/bb
 
 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';
+import { ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterItemRegistration, PluginHomepageSectionRegistration, PluginSettingsSectionRegistration, ExperimentalAppOverlayRegistration, PluginNavPanelRegistration, PluginThreadPanelActionRegistration, PluginNewThreadPanelActionRegistration, ComposerCustomization, PluginPendingInteractionRegistration, PluginSidebarFooterActionRegistration, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarHeaderRegistration, 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 {
@@ -64,6 +64,7 @@ interface CollectedPluginAppRegistrations {
     sidebarFooterActions: PluginSidebarFooterActionRegistration[];
     experimentalSidebarFooterItems: CollectedExperimentalSidebarFooterItem[];
     experimentalSidebarNavigations: ExperimentalSidebarNavigationRegistration[];
+    experimentalSidebarHeaders: ExperimentalSidebarHeaderRegistration[];
     threadLists: PluginThreadListRegistration[];
     threadHeaderActions: PluginThreadHeaderActionRegistration[];
     browserToolbarActions: ExperimentalPluginBrowserToolbarActionRegistration[];

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, ExperimentalPluginBrowserToolbarActionRegistration, PluginFileOpenerRegistration, PluginSourceCodeRendererRegistration, PluginDiffRendererRegistration, PluginMessageDirectiveRegistration, PluginMessageActionRegistration, ExperimentalIconRegistration, PluginTimelineRendererRegistration, PluginEnvironmentProviderInputsRegistration, PluginMachineProviderInputsRegistration, PluginContentScriptRegistration, PluginComposerScope, PluginComposerTextEffect, PluginComposerMention, ExperimentalComposerSubmitOptions, ExperimentalComposerSelection, PluginComposerThreadRowStatus, ExperimentalOpenFixedTabOptions, JsonValue, BbNavigate, ExperimentalFileOpenOptions, PluginAppDefinition, PluginRpcContract, StandardSchemaV1InferInput, PluginRpcResult, PluginBrowserBbSdk, PluginRealtimeConnectionState, PluginSidebarThreadsState, PluginProvidersState, PluginCodeThemeState, BranchesState, CheckoutState, PluginSidebarPullRequest, PluginSidebarThreadRowStatus, PluginSidebarThreadShortcut, PluginSidebarSplitLayout, PluginEnvironmentProvidersState, PluginSidebarThreadActions } from '@get-bb/plugin-sdk';
+import { ExperimentalSidebarFooterItemRegistration, PluginProviderIconRegistration, PluginHomepageSectionRegistration, PluginSettingsSectionRegistration, ExperimentalAppOverlayRegistration, PluginNavPanelRegistration, PluginThreadPanelActionRegistration, PluginNewThreadPanelActionRegistration, ComposerCustomization, PluginPendingInteractionRegistration, PluginSidebarFooterActionRegistration, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarHeaderRegistration, PluginThreadListRegistration, PluginThreadHeaderActionRegistration, ExperimentalPluginBrowserToolbarActionRegistration, PluginFileOpenerRegistration, PluginSourceCodeRendererRegistration, PluginDiffRendererRegistration, PluginMessageDirectiveRegistration, PluginMessageActionRegistration, ExperimentalIconRegistration, PluginTimelineRendererRegistration, PluginEnvironmentProviderInputsRegistration, PluginMachineProviderInputsRegistration, PluginContentScriptRegistration, PluginComposerScope, PluginComposerTextEffect, PluginComposerMention, ExperimentalComposerSubmitOptions, ExperimentalComposerSelection, PluginComposerThreadRowStatus, ExperimentalOpenFixedTabOptions, JsonValue, BbNavigate, ExperimentalFileOpenOptions, PluginAppDefinition, PluginRpcContract, StandardSchemaV1InferInput, PluginRpcResult, PluginBrowserBbSdk, PluginRealtimeConnectionState, PluginSidebarThreadsState, PluginProvidersState, PluginCodeThemeState, BranchesState, CheckoutState, PluginSidebarPullRequest, PluginSidebarThreadRowStatus, PluginSidebarThreadShortcut, PluginSidebarSplitLayout, ExperimentalSidebarNavigationItem, PluginEnvironmentProvidersState, PluginSidebarThreadActions, ExperimentalSidebarNavigationActions } from '@get-bb/plugin-sdk';
 
 type ExperimentalSidebarFooterCommandKind = "close" | "open" | "toggle";
 interface ExperimentalSidebarFooterRuntimeSnapshot {
@@ -149,6 +149,17 @@ interface SidebarActionCall {
     pinned?: boolean;
     read?: boolean;
 }
+/**
+ * One recorded `experimental_useSidebarNavigation()` action, or a split drag
+ * started from `experimental_useSidebarNavigationSplit()` (`beginSplitDrag`).
+ */
+interface SidebarNavigationCall {
+    method: keyof ExperimentalSidebarNavigationActions | "beginSplitDrag";
+    itemId?: string;
+    itemIds?: string[];
+    isVisible?: boolean;
+    openInSplit?: boolean;
+}
 /**
  * Install the test runtime at `globalThis.__bbPluginRuntime.pluginSdkApp`.
  * Idempotent per module instance; must run before the plugin's `app.tsx`
@@ -167,6 +178,7 @@ interface CapturedPluginApp {
     sidebarFooterActions: PluginSidebarFooterActionRegistration[];
     experimentalSidebarFooterItems: CollectedExperimentalSidebarFooterItem[];
     experimentalSidebarNavigations: ExperimentalSidebarNavigationRegistration[];
+    experimentalSidebarHeaders: ExperimentalSidebarHeaderRegistration[];
     threadLists: PluginThreadListRegistration[];
     threadHeaderActions: PluginThreadHeaderActionRegistration[];
     browserToolbarActions: ExperimentalPluginBrowserToolbarActionRegistration[];
@@ -293,6 +305,16 @@ interface RenderSlotOptions<Contract extends PluginRpcContract = PluginRpcContra
     sidebarShortcuts?: Record<string, PluginSidebarThreadShortcut>;
     /** The split layout `useSidebarSplitLayout()` reports. Omitted → null. */
     sidebarSplitLayout?: PluginSidebarSplitLayout;
+    /**
+     * Items and the active item `experimental_useSidebarNavigation()` reports.
+     * Omitted → no items. Actions are recorded in
+     * `inspection.sidebarNavigationCalls` and do not change the items.
+     */
+    sidebarNavigation?: {
+        items?: readonly ExperimentalSidebarNavigationItem[];
+        activeItemId?: string | null;
+        isShortcutModifierHeld?: boolean;
+    };
     /**
      * The environment provider catalog `useEnvironmentProviders()` reports.
      * Omitted → a ready, empty list. Pass `{ status: "loading" }` to test that
@@ -345,6 +367,11 @@ interface RenderedSlotInspectionState {
     readonly experimental_fixedTabOpenCalls: ExperimentalFixedTabOpenCall[];
     /** Every `experimental_useSidebarThreadActions()` call, in order. */
     readonly sidebarActionCalls: SidebarActionCall[];
+    /**
+     * Every `experimental_useSidebarNavigation()` action and navigation split
+     * drag, in order.
+     */
+    readonly sidebarNavigationCalls: SidebarNavigationCall[];
     /** Every `useSdk()` call, in order, as `"<area>.<method>"`. */
     readonly sdkCalls: SdkCall[];
     /** Everything written through `useComposer()`. */
@@ -369,4 +396,4 @@ declare function renderSlot<Props extends object, Contract extends PluginRpcCont
 }, props: Props, options?: RenderSlotOptions<Contract>): RenderedSlot;
 
 export { installTestPluginRuntime, loadPluginApp, mountPluginContentScripts, renderSlot };
-export type { CapturedPluginApp, ComposerLog, ContentScriptTestMountOptions, ContentScriptThreadRowStatusCall, ExperimentalFixedTabOpenCall, MountedPluginContentScripts, NavigateCall, PluginAppSource, PluginRpcTestHandlers, PluginSdkTestFakes, RenderSlotOptions, RenderedSlot, RenderedSlotBehaviorDrivers, RenderedSlotInspectionState, RenderedSlotLifecycleControls, RpcCall, SdkCall, SidebarActionCall };
+export type { CapturedPluginApp, ComposerLog, ContentScriptTestMountOptions, ContentScriptThreadRowStatusCall, ExperimentalFixedTabOpenCall, MountedPluginContentScripts, NavigateCall, PluginAppSource, PluginRpcTestHandlers, PluginSdkTestFakes, RenderSlotOptions, RenderedSlot, RenderedSlotBehaviorDrivers, RenderedSlotInspectionState, RenderedSlotLifecycleControls, RpcCall, SdkCall, SidebarActionCall, SidebarNavigationCall };

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

@@ -1321,6 +1321,12 @@ interface FakePluginLifecycleControls {
      * PluginContextStaleError). Idempotent.
      */
     dispose(): Promise<void>;
+    /**
+     * Run every handler registered with `bb.onInstall`, in
+     * registration order, as bb does right after a fresh install. A handler
+     * that throws is logged at warn level and the rest still run.
+     */
+    install(): Promise<void>;
 }
 /**
  * Complete fake-host harness. Direct members are retained for compatibility;

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

@@ -98,7 +98,7 @@ declare const appSettingsUpdateSchema: z$1.ZodUnion<readonly [z$1.ZodObject<{
 }, z$1.core.$strict>]>;
 type AppSettingsUpdate = z$1.infer<typeof appSettingsUpdateSchema>;
 
-declare const UI_PREFERENCE_KEYS: readonly ["sidebar.organizationMode", "sidebar.threadGrouping.environment", "sidebar.chronologicalSort", "sidebar.sortDirection", "sidebar.sectionOrder", "sidebar.manualSectionOrder", "sidebar.machineSectionOrder", "sidebar.hiddenGroups", "sidebar.collapsedSections", "sidebar.collapsedProjects", "sidebar.collapsedThreads", "sidebar.collapsedEnvironments", "sidebar.collapsedThreadSections", "sidebar.collapsedMachines", "sidebar.footerOrder", "sidebar.hiddenFooterItems", "sidebar.pluginPanelOrder", "sidebar.visiblePluginPanels", "sidebar.navigationProvider", "sidebar.threadListProvider"];
+declare const UI_PREFERENCE_KEYS: readonly ["sidebar.organizationMode", "sidebar.threadGrouping.environment", "sidebar.chronologicalSort", "sidebar.sortDirection", "sidebar.sectionOrder", "sidebar.manualSectionOrder", "sidebar.machineSectionOrder", "sidebar.hiddenGroups", "sidebar.collapsedSections", "sidebar.collapsedProjects", "sidebar.collapsedThreads", "sidebar.collapsedEnvironments", "sidebar.collapsedThreadSections", "sidebar.collapsedMachines", "sidebar.footerOrder", "sidebar.hiddenFooterItems", "sidebar.pluginPanelOrder", "sidebar.visiblePluginPanels", "sidebar.navigationProvider", "sidebar.headerProvider", "sidebar.threadListProvider"];
 type UiPreferenceKey = (typeof UI_PREFERENCE_KEYS)[number];
 interface UiPreferenceDefinition<Schema extends z$1.ZodTypeAny = z$1.ZodTypeAny> {
     schema: Schema;
@@ -140,7 +140,8 @@ declare const uiPreferenceDefinitions: {
     readonly "sidebar.hiddenFooterItems": UiPreferenceDefinition<z$1.ZodArray<z$1.ZodString>>;
     readonly "sidebar.pluginPanelOrder": UiPreferenceDefinition<z$1.ZodArray<z$1.ZodString>>;
     readonly "sidebar.visiblePluginPanels": UiPreferenceDefinition<z$1.ZodNullable<z$1.ZodArray<z$1.ZodString>>>;
-    readonly "sidebar.navigationProvider": UiPreferenceDefinition<z$1.ZodString>;
+    readonly "sidebar.navigationProvider": UiPreferenceDefinition<z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<string, string>>>;
+    readonly "sidebar.headerProvider": UiPreferenceDefinition<z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<string, string>>>;
     readonly "sidebar.threadListProvider": UiPreferenceDefinition<z$1.ZodPipe<z$1.ZodString, z$1.ZodTransform<string, string>>>;
 };
 type UiPreferenceValue<Key extends UiPreferenceKey> = z$1.infer<(typeof uiPreferenceDefinitions)[Key]["schema"]>;
@@ -5918,18 +5919,20 @@ declare const hostDaemonCommandRegistry: {
     }, z$1.core.$strict>, z$1.ZodObject<{
         sources: z$1.ZodArray<z$1.ZodObject<{
             icon: z$1.ZodOptional<z$1.ZodString>;
-            id: z$1.ZodEnum<{
+            id: z$1.ZodUnion<readonly [z$1.ZodEnum<{
                 arc: "arc";
                 brave: "brave";
                 chrome: "chrome";
                 chromium: "chromium";
+                dia: "dia";
                 edge: "edge";
                 firefox: "firefox";
                 helium: "helium";
                 opera: "opera";
                 safari: "safari";
                 vivaldi: "vivaldi";
-            }>;
+                zen: "zen";
+            }>, z$1.ZodString]>;
             name: z$1.ZodString;
             profiles: z$1.ZodArray<z$1.ZodObject<{
                 cookieCount: z$1.ZodOptional<z$1.ZodNumber>;
@@ -5955,18 +5958,20 @@ declare const hostDaemonCommandRegistry: {
         }, z$1.core.$strip>, z$1.ZodObject<{
             kind: z$1.ZodLiteral<"personal">;
         }, z$1.core.$strip>], "kind">;
-        sourceId: z$1.ZodEnum<{
+        sourceId: z$1.ZodUnion<readonly [z$1.ZodEnum<{
             arc: "arc";
             brave: "brave";
             chrome: "chrome";
             chromium: "chromium";
+            dia: "dia";
             edge: "edge";
             firefox: "firefox";
             helium: "helium";
             opera: "opera";
             safari: "safari";
             vivaldi: "vivaldi";
-        }>;
+            zen: "zen";
+        }>, z$1.ZodString]>;
         sourceProfileDirectory: z$1.ZodString;
         type: z$1.ZodLiteral<"desktop.browser.import_cookies">;
     }, z$1.core.$strict>, z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
@@ -8803,18 +8808,20 @@ declare const desktopBrowserCommandSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObj
     }, z$1.core.$strip>, z$1.ZodObject<{
         kind: z$1.ZodLiteral<"personal">;
     }, z$1.core.$strip>], "kind">;
-    sourceId: z$1.ZodEnum<{
+    sourceId: z$1.ZodUnion<readonly [z$1.ZodEnum<{
         arc: "arc";
         brave: "brave";
         chrome: "chrome";
         chromium: "chromium";
+        dia: "dia";
         edge: "edge";
         firefox: "firefox";
         helium: "helium";
         opera: "opera";
         safari: "safari";
         vivaldi: "vivaldi";
-    }>;
+        zen: "zen";
+    }>, z$1.ZodString]>;
     sourceProfileDirectory: z$1.ZodString;
     type: z$1.ZodLiteral<"desktop.browser.import_cookies">;
 }, z$1.core.$strict>], "type">;
@@ -8901,18 +8908,20 @@ declare const desktopBrowserResultSchemas: {
     "desktop.browser.list_import_sources": z$1.ZodObject<{
         sources: z$1.ZodArray<z$1.ZodObject<{
             icon: z$1.ZodOptional<z$1.ZodString>;
-            id: z$1.ZodEnum<{
+            id: z$1.ZodUnion<readonly [z$1.ZodEnum<{
                 arc: "arc";
                 brave: "brave";
                 chrome: "chrome";
                 chromium: "chromium";
+                dia: "dia";
                 edge: "edge";
                 firefox: "firefox";
                 helium: "helium";
                 opera: "opera";
                 safari: "safari";
                 vivaldi: "vivaldi";
-            }>;
+                zen: "zen";
+            }>, z$1.ZodString]>;
             name: z$1.ZodString;
             profiles: z$1.ZodArray<z$1.ZodObject<{
                 cookieCount: z$1.ZodOptional<z$1.ZodNumber>;
@@ -14564,18 +14573,20 @@ declare const desktopBrowserImportCookiesRequestSchema: z$1.ZodObject<{
     }, z$1.core.$strip>, z$1.ZodObject<{
         kind: z$1.ZodLiteral<"personal">;
     }, z$1.core.$strip>], "kind">>;
-    sourceId: z$1.ZodEnum<{
+    sourceId: z$1.ZodUnion<readonly [z$1.ZodEnum<{
         arc: "arc";
         brave: "brave";
         chrome: "chrome";
         chromium: "chromium";
+        dia: "dia";
         edge: "edge";
         firefox: "firefox";
         helium: "helium";
         opera: "opera";
         safari: "safari";
         vivaldi: "vivaldi";
-    }>;
+        zen: "zen";
+    }>, z$1.ZodString]>;
     sourceProfileDirectory: z$1.ZodString;
 }, z$1.core.$strict>;
 type ExperimentalDesktopBrowserHostRequest = z$1.infer<typeof desktopBrowserHostRequestSchema>;
@@ -16766,15 +16777,21 @@ type ExperimentalSidebarNavigationAction = {
     kind: "search-threads";
 } | {
     kind: "open-extensions";
+} | {
+    kind: "open-skills";
 } | {
     kind: "open-plugin-panel";
     pluginId: string;
     panelId: string;
 };
-/** Semantic icon identity for one sidebar navigation item. */
+/**
+ * Semantic icon identity for one sidebar navigation item. Render it with
+ * {@link PluginSdkApp.experimental_SidebarNavigationIcon} to match bb's
+ * artwork, including plugin branding.
+ */
 type ExperimentalSidebarNavigationIcon = {
     kind: "host";
-    name: "extensions" | "new-thread" | "search";
+    name: "extensions" | "new-thread" | "search" | "skills";
 } | {
     kind: "plugin";
     pluginId: string;
@@ -16782,28 +16799,164 @@ type ExperimentalSidebarNavigationIcon = {
 };
 /** One host-owned destination or action a plugin may arrange. */
 interface ExperimentalSidebarNavigationItem {
+    /**
+     * Arrangement key, stable across reloads: `__bb__/new-thread`,
+     * `__bb__/search-threads`, `__bb__/extensions`, `__bb__/skills`,
+     * `__bb__/automations`, or `<pluginId>/<panelId>`. The same keys appear in
+     * the `sidebar.pluginPanelOrder` and `sidebar.visiblePluginPanels`
+     * settings.
+     */
     id: string;
     label: string;
     icon: ExperimentalSidebarNavigationIcon;
     action: ExperimentalSidebarNavigationAction;
     isDisabled: boolean;
+    /**
+     * False when the user hid the item from the sidebar. Draw hidden items in an
+     * overflow menu rather than dropping them, so they stay reachable.
+     */
+    isVisible: boolean;
+    /**
+     * A plugin panel remembered from the last session whose bundle has not
+     * registered yet. Activating it does nothing until it loads.
+     */
+    isLoading: boolean;
+    /**
+     * The plugin that contributed this panel; null for bb's own items. Gates
+     * `openDetails` and `disablePlugin`.
+     */
+    pluginId: string | null;
     shortcut: ExperimentalSidebarNavigationShortcut | null;
-    experimental_splitProps: {
-        onPointerDown?: (event: react.PointerEvent<HTMLElement>) => void;
-    };
+    /**
+     * The panel's `experimental_sidebarAccessory`, already wrapped in the host's
+     * crash boundary. Null for bb's items, panels without an accessory, and on
+     * compact viewports. Keep it within one line, about 4rem by 1.25rem.
+     */
+    experimental_Accessory: ComponentType | null;
 }
 /** How the host should activate a sidebar navigation item. */
 interface ExperimentalSidebarNavigationActivationOptions {
     openInSplit: boolean;
 }
-/** Props passed to an `experimental_sidebarNavigation` component. */
-interface ExperimentalSidebarNavigationProps {
+/**
+ * Host behavior for sidebar navigation items (see
+ * {@link ExperimentalSidebarNavigationState}). Unknown item ids are ignored.
+ * Calls made after the calling component unmounts do nothing.
+ */
+interface ExperimentalSidebarNavigationActions {
+    /**
+     * Run the item's host behavior and close the mobile sidebar drawer.
+     * `openInSplit` is ignored where splits are unavailable, and disabled or
+     * loading items do nothing.
+     */
+    activate(itemId: string, options: ExperimentalSidebarNavigationActivationOptions): void;
+    /** Hide or show one item. Persists to `sidebar.visiblePluginPanels`. */
+    setVisible(itemId: string, isVisible: boolean): void;
+    /**
+     * Save a new order. Pass item ids in the order you want; unknown ids are
+     * dropped and ids you leave out keep their relative order after the ones
+     * you pass. Persists to `sidebar.pluginPanelOrder`.
+     */
+    setOrder(itemIds: readonly string[]): void;
+    /** Open bb's customize editor, which reorders and hides items. */
+    openCustomize(): void;
+    /** Open the owning plugin's details. Does nothing when `pluginId` is null. */
+    openDetails(itemId: string): void;
+    /**
+     * Disable the owning plugin, leave its panel if it is open, and show a
+     * toast. Rejects after the host's error toast when disabling fails. Does
+     * nothing when `pluginId` is null.
+     */
+    disablePlugin(itemId: string): Promise<void>;
+}
+/** What {@link PluginSdkApp.experimental_useSidebarNavigation} returns. */
+interface ExperimentalSidebarNavigationState {
+    /** Every item in the user's saved order, visible and hidden. */
     items: readonly ExperimentalSidebarNavigationItem[];
+    /** The item whose destination the route currently shows, or null. */
     activeItemId: string | null;
+    /**
+     * True while the user holds the app command modifier, when bb's own rows
+     * reveal their `shortcut` labels. Show yours at the same time.
+     */
+    isShortcutModifierHeld: boolean;
+    actions: ExperimentalSidebarNavigationActions;
+}
+/**
+ * Per-item drag-to-split support (see
+ * {@link PluginSdkApp.experimental_useSidebarNavigationSplit}). Same contract
+ * as {@link PluginSidebarThreadSplit}.
+ */
+interface ExperimentalSidebarNavigationSplit {
+    /**
+     * Spread onto the item's interactive element. Empty when the item cannot
+     * open in a pane, so spreading it is always safe.
+     */
+    splitProps: {
+        onPointerDown?: (event: react.PointerEvent<HTMLElement>) => void;
+    };
+    /**
+     * False for items that cannot open in a pane (Search, Plugins, Skills), on
+     * compact viewports, and when splits are unavailable.
+     */
+    isAvailable: boolean;
+    /** Where this item's destination sits in the split layout, or null. */
+    layout: {
+        panes: readonly PluginSidebarSplitPane[];
+    } | null;
+}
+/** Options for {@link PluginSdkApp.experimental_useSidebarNavigationSplit}. */
+interface ExperimentalSidebarNavigationSplitOptions {
+    /**
+     * `sidebar` (the default) engages the drag once the pointer leaves the
+     * sidebar, so a row list with its own drag-to-reorder keeps working.
+     * `distance` engages after a short movement in any direction; use it for
+     * rows inside a menu or popover that covers the main area.
+     */
+    activation?: "distance" | "sidebar";
+    /** Called when the drag engages, for example to close the menu the row is in. */
+    onDragStart?: () => void;
+}
+/** Props for {@link PluginSdkApp.experimental_SidebarNavigationIcon}. */
+interface ExperimentalSidebarNavigationIconProps {
+    icon: ExperimentalSidebarNavigationIcon;
+    className?: string;
+}
+/**
+ * Props passed to an `experimental_sidebarNavigation` component. Read the
+ * items and their actions with
+ * {@link PluginSdkApp.experimental_useSidebarNavigation}.
+ */
+interface ExperimentalSidebarNavigationProps {
     isCompactViewport: boolean;
-    experimental_activate(itemId: string, options: ExperimentalSidebarNavigationActivationOptions): void;
+    /**
+     * Renders bb's bundled Navigation plugin, or nothing while it is disabled.
+     * Kept for plugins written before `experimental_useSidebarNavigation`;
+     * render items from that hook instead. Scheduled for removal.
+     *
+     * @deprecated
+     */
     experimental_Original: ComponentType;
 }
+/**
+ * Props passed to an `experimental_sidebarHeader` component, rendered in the
+ * sidebar's header row between the sidebar toggle (and the macOS window
+ * controls) and bb's back and forward buttons.
+ */
+interface ExperimentalSidebarHeaderProps {
+    /**
+     * Width in px of the space the component may use, updated when the sidebar
+     * resizes or the window chrome changes. It can be smaller than
+     * `controlSize` in a narrow sidebar.
+     */
+    width: number;
+    /**
+     * Width and height in px of the header's own buttons, equal to the
+     * `--bb-sidebar-control-size` CSS variable. Size your controls to match.
+     */
+    controlSize: number;
+    isCompactViewport: boolean;
+}
 /**
  * Props passed to an `experimental_threadList` component — the sidebar's
  * scrolling thread area, replaced wholesale by one plugin.
@@ -17904,7 +18057,14 @@ interface PluginThreadListRegistration {
     description?: string;
     component: ComponentType<PluginThreadListProps>;
 }
-/** Replace the bounded navigation controls above the sidebar thread list. */
+/**
+ * Replace the navigation controls above the sidebar thread list. Exclusive:
+ * the user picks one provider under Settings → Appearance → Navigation, and
+ * bb ships its own rows as the bundled Navigation plugin
+ * (`navigation/navigation`, the default). A picked provider that is disabled
+ * or removed falls back to Navigation; a crashing provider is replaced by a
+ * placeholder with a Reload button.
+ */
 interface ExperimentalSidebarNavigationRegistration {
     /** Unique within the plugin; letters, digits, `-`, `_`. */
     id: string;
@@ -17914,6 +18074,23 @@ interface ExperimentalSidebarNavigationRegistration {
     description?: string;
     component: ComponentType<ExperimentalSidebarNavigationProps>;
 }
+/**
+ * Render a component in the sidebar's header row, between the sidebar toggle
+ * and bb's back and forward buttons. Exclusive: the user picks at most one
+ * header under Settings → Appearance, and by default the header shows only
+ * bb's own controls. Content is clipped to the row, so it cannot move the
+ * thread list or bb's controls. On macOS the empty space keeps dragging the
+ * window; buttons, links, and inputs do not.
+ */
+interface ExperimentalSidebarHeaderRegistration {
+    /** Unique within the plugin; letters, digits, `-`, `_`. */
+    id: string;
+    /** Label shown in Settings → Appearance and capability details. */
+    title: string;
+    /** Optional one-line description shown with the provider choice. */
+    description?: string;
+    component: ComponentType<ExperimentalSidebarHeaderProps>;
+}
 /**
  * Register this plugin as a viewer/editor for file extensions. By default,
  * matching files render the first applicable opener in deterministic slot
@@ -18318,6 +18495,12 @@ interface PluginAppSlots {
     sidebarFooterAction(registration: PluginSidebarFooterActionRegistration): void;
     /** Replace the bounded sidebar navigation controls. */
     experimental_sidebarNavigation(registration: ExperimentalSidebarNavigationRegistration): void;
+    /**
+     * Render a component in the sidebar header row (see
+     * {@link ExperimentalSidebarHeaderRegistration}). Experimental: see
+     * docs/api_to_audit.md.
+     */
+    experimental_sidebarHeader(registration: ExperimentalSidebarHeaderRegistration): void;
     /**
      * Replace the sidebar's thread list (see
      * {@link PluginThreadListRegistration}). Experimental: see
@@ -19373,6 +19556,27 @@ interface PluginSdkApp {
      * Experimental: see docs/api_to_audit.md.
      */
     experimental_useSidebarThreadSplit(threadId: string): PluginSidebarThreadSplit;
+    /**
+     * The sidebar navigation items in the user's saved order, the active item,
+     * and the host actions that activate, hide, reorder, and customize them
+     * (see {@link ExperimentalSidebarNavigationState}). One model shared by
+     * every caller in the sidebar. Items keep their identity while unchanged.
+     * Outside the sidebar it returns no items and actions that do nothing.
+     * Experimental: see docs/api_to_audit.md.
+     */
+    experimental_useSidebarNavigation(): ExperimentalSidebarNavigationState;
+    /**
+     * Per-item drag-to-split support for navigation items (see
+     * {@link ExperimentalSidebarNavigationSplit}). Call it once per rendered
+     * item. Experimental: see docs/api_to_audit.md.
+     */
+    experimental_useSidebarNavigationSplit(itemId: string, options?: ExperimentalSidebarNavigationSplitOptions): ExperimentalSidebarNavigationSplit;
+    /**
+     * bb's artwork for a navigation item's icon: bb's glyphs for its own items,
+     * and the contributing plugin's branding for plugin panels. Experimental:
+     * see docs/api_to_audit.md.
+     */
+    experimental_SidebarNavigationIcon: ComponentType<ExperimentalSidebarNavigationIconProps>;
     /**
      * Whether the composer holds an unsent draft for one thread (see
      * {@link PluginSidebarThreadDraftState}). Per row, because a draft is
@@ -21634,6 +21838,16 @@ interface BbPluginApi {
      * The sanctioned place to clear timers and close connections.
      */
     onDispose(hook: () => void | Promise<void>): void;
+    /**
+     * Run a handler once, right after this plugin is installed and its server
+     * entry has loaded: for example to pick its own sidebar slots with
+     * `bb.sdk.system.uiPreferences`. It does not run on update, reload,
+     * enable, or server restart, nor for bb's bundled plugins; reinstalling
+     * after removal runs it again. Register it while the entry loads. A
+     * handler that throws is logged and the install still succeeds; the
+     * install waits at most 30 seconds for handlers to finish.
+     */
+    onInstall(handler: () => void | Promise<void>): void;
 }
 
 /** Duration suffixes, shared with the core `bb` CLI grammar. */
@@ -21869,4 +22083,4 @@ declare function cliCommand<const TOptions extends CliOptions = Record<string, n
 declare function defineCli(spec: PluginCliSpec): PluginCliRegistration;
 
 export { PLUGIN_CLI_OUTPUT_MAX_BYTES, PluginCliError, cliCommand, defineCli, defineRpcContract, experimental_defineHostEntry };
-export type { BbContext, BbNavigate, BbPluginApi, BranchPickerProps, BranchesState, CheckoutState, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppIcons, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSelection, ExperimentalComposerSubmitOptions, ExperimentalDesktopBrowserAcquireInput, ExperimentalDesktopBrowserCreateInput, ExperimentalDesktopBrowserLease, ExperimentalDesktopBrowserScope, ExperimentalDesktopBrowsersArea, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalHostCallOptions, ExperimentalHostClient, ExperimentalHostEntry, ExperimentalHostPaths, ExperimentalHostRpcContext, ExperimentalHostRpcHandlers, ExperimentalHostSignalContract, ExperimentalHostSignalEvent, ExperimentalHostSignals, ExperimentalHostWatchChange, ExperimentalHostWatchChangeType, ExperimentalHostWatchEvent, ExperimentalHostWatchListener, ExperimentalHostWatchOptions, ExperimentalHostWatchSubscription, ExperimentalHostWorkerLease, ExperimentalIconProps, ExperimentalIconRegistration, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginBrowserPage, ExperimentalPluginBrowserPageEvaluateOptions, ExperimentalPluginBrowserPageWorld, ExperimentalPluginBrowserToolbarActionProps, ExperimentalPluginBrowserToolbarActionRegistration, ExperimentalPluginFixedTabReference, ExperimentalPluginMentionImage, ExperimentalPluginProviderEnvContext, ExperimentalPluginProviderEnvEntry, ExperimentalPluginProviderEnvHealth, ExperimentalPluginProviderEnvHealthContext, ExperimentalPluginWebSocket, ExperimentalPluginWebSocketContext, ExperimentalPluginWebSocketHandler, ExperimentalPluginWebSocketHandlers, ExperimentalProviderIconProps, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalSidebarFooter, ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterActionRegistration, ExperimentalSidebarFooterDisclosureController, ExperimentalSidebarFooterDisclosureProps, ExperimentalSidebarFooterDisclosureRegistration, ExperimentalSidebarFooterItemBase, ExperimentalSidebarFooterItemRegistration, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, JsonValue, MachineBootstrapApi, MachineBootstrapRequest, MachineExecutor, MachineExecutorRequest, MarkdownProps, MessageDispatchHookContext, MessageDispatchHookDecision, NewThreadComposerProps, NewThreadRequest, PluginAgentConfiguration, PluginAgentConfigurationContext, PluginAgentToolContentPart, PluginAgentToolContext, PluginAgentToolRegistrationBase, PluginAgentToolResult, PluginAgentToolSelection, PluginAgents, PluginAiServiceDeclaration, PluginAiServiceKind, PluginAiServices, PluginAppBuilder, PluginAppCommands, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginBackground, PluginBbSdk, PluginBoundThreadsArea, PluginBrowserBbSdk, PluginCli, PluginCliBooleanOption, PluginCliCommand, PluginCliCommandInfo, PluginCliConstraint, PluginCliContext, PluginCliDurationOption, PluginCliDurationUnit, PluginCliEnumOption, PluginCliErrorCode, PluginCliExecutionResult, PluginCliIntegerOption, PluginCliOption, PluginCliOptionValues, PluginCliOutputLimitError, PluginCliPositional, PluginCliPositionalValues, PluginCliRegistration, PluginCliResult, PluginCliRunInput, PluginCliSpec, PluginCliStringOption, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandContext, PluginCommandRegistration, PluginCommandShortcut, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginDispatchAttemptKind, PluginDispatchEnvironmentIntent, PluginDispatchExecution, PluginDispatchExecutionSources, PluginDispatchInput, PluginEnvironmentProvider, PluginEnvironmentProviderDeclaration, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, PluginEnvironmentProviderRequirements, PluginEnvironmentProvidersState, PluginEnvironmentValidateDecision, PluginEnvironments, PluginEvents, PluginFileOpenerProps, PluginFileOpenerRegistration, PluginFileOpenerSource, PluginFixedTabDeclaration, PluginFixedTabRegistration, PluginHomepageSectionProps, PluginHomepageSectionRegistration, PluginHookHandler, PluginHookName, PluginHookSignatures, PluginHooks, PluginHosts, PluginHttp, PluginHttpAuthMode, PluginHttpHandler, PluginInteractionCancelReason, PluginInteractionDescription, PluginInteractionRequest, PluginInteractionResult, PluginKvStorage, PluginLogger, PluginMachineProviderDeclaration, PluginMachineProviderInputsChange, PluginMachineProviderInputsProps, PluginMachineProviderInputsRegistration, PluginMachineValidateDecision, PluginMachines, PluginMentionItem, PluginMentionProviderRegistration, PluginMentionSearchContext, PluginMentionTrigger, PluginMessageActionContext, PluginMessageActionRegistration, PluginMessageDirectiveMessage, PluginMessageDirectiveOpenWorkspaceFile, PluginMessageDirectiveProps, PluginMessageDirectiveRegistration, PluginNavPanelProps, PluginNavPanelRegistration, PluginNewThreadPanelActionContext, PluginNewThreadPanelActionRegistration, PluginNewThreadPanelProps, PluginPanelActionOpenOptions, PluginPendingInteractionProps, PluginPendingInteractionRegistration, PluginPendingInteractionView, PluginProviderCapabilities, PluginProviderCompletedTurnDisplay, PluginProviderComposerAction, PluginProviderDeclaration, PluginProviderExtensionKindDeclaration, PluginProviderFallbackModel, PluginProviderIconRegistration, PluginProviderMaintenance, PluginProviderModelCatalogScope, PluginProviderNativeRootEntry, PluginProviderNativeRoots, PluginProviderOptionDescriptor, PluginProviderOptionsContext, PluginProviderPermissionMode, PluginProviderReasoningLevel, PluginProviderStrings, PluginProviders, PluginProvidersState, PluginRealtime, PluginRealtimeConnectionState, PluginRowLabels, PluginRowPresentation, PluginRpc, PluginRpcCallArgs, PluginRpcClient, PluginRpcContract, PluginRpcError, PluginRpcErrorCode, PluginRpcHandlers, PluginRpcIssuePathSegment, PluginRpcMethodContract, PluginRpcResult, PluginRpcValidationIssue, PluginSdkApp, PluginServerAccess, PluginServerApi, PluginSettingDescriptor, PluginSettingDescriptors, PluginSettingValue, PluginSettings, PluginSettingsHandle, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsState, PluginSettingsValues, PluginSharedPortTunnelIdentity, PluginSidebarFooterActionContext, PluginSidebarFooterActionProps, PluginSidebarFooterActionRegistration, PluginSidebarProject, PluginSidebarPullRequest, PluginSidebarSection, PluginSidebarSplitLayout, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadDraftState, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadRowStatus, PluginSidebarThreadShortcut, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginStatusApi, PluginStorage, PluginTargetedPanelActionOpenOptions, PluginThreadEventHandler, PluginThreadEventName, PluginThreadEventPayloads, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginThreadTitleProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, PluginTurnFailedEvent, PluginUi, ReadonlyJsonValue, ServerAccessGrant, ServerAccessProviderDeclaration, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps, UseBranchesArgs, UseCheckoutStateArgs };
+export type { BbContext, BbNavigate, BbPluginApi, BranchPickerProps, BranchesState, CheckoutState, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppIcons, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSelection, ExperimentalComposerSubmitOptions, ExperimentalDesktopBrowserAcquireInput, ExperimentalDesktopBrowserCreateInput, ExperimentalDesktopBrowserLease, ExperimentalDesktopBrowserScope, ExperimentalDesktopBrowsersArea, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalHostCallOptions, ExperimentalHostClient, ExperimentalHostEntry, ExperimentalHostPaths, ExperimentalHostRpcContext, ExperimentalHostRpcHandlers, ExperimentalHostSignalContract, ExperimentalHostSignalEvent, ExperimentalHostSignals, ExperimentalHostWatchChange, ExperimentalHostWatchChangeType, ExperimentalHostWatchEvent, ExperimentalHostWatchListener, ExperimentalHostWatchOptions, ExperimentalHostWatchSubscription, ExperimentalHostWorkerLease, ExperimentalIconProps, ExperimentalIconRegistration, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginBrowserPage, ExperimentalPluginBrowserPageEvaluateOptions, ExperimentalPluginBrowserPageWorld, ExperimentalPluginBrowserToolbarActionProps, ExperimentalPluginBrowserToolbarActionRegistration, ExperimentalPluginFixedTabReference, ExperimentalPluginMentionImage, ExperimentalPluginProviderEnvContext, ExperimentalPluginProviderEnvEntry, ExperimentalPluginProviderEnvHealth, ExperimentalPluginProviderEnvHealthContext, ExperimentalPluginWebSocket, ExperimentalPluginWebSocketContext, ExperimentalPluginWebSocketHandler, ExperimentalPluginWebSocketHandlers, ExperimentalProviderIconProps, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalSidebarFooter, ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterActionRegistration, ExperimentalSidebarFooterDisclosureController, ExperimentalSidebarFooterDisclosureProps, ExperimentalSidebarFooterDisclosureRegistration, ExperimentalSidebarFooterItemBase, ExperimentalSidebarFooterItemRegistration, ExperimentalSidebarHeaderProps, ExperimentalSidebarHeaderRegistration, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActions, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationIconProps, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, ExperimentalSidebarNavigationSplit, ExperimentalSidebarNavigationSplitOptions, ExperimentalSidebarNavigationState, JsonValue, MachineBootstrapApi, MachineBootstrapRequest, MachineExecutor, MachineExecutorRequest, MarkdownProps, MessageDispatchHookContext, MessageDispatchHookDecision, NewThreadComposerProps, NewThreadRequest, PluginAgentConfiguration, PluginAgentConfigurationContext, PluginAgentToolContentPart, PluginAgentToolContext, PluginAgentToolRegistrationBase, PluginAgentToolResult, PluginAgentToolSelection, PluginAgents, PluginAiServiceDeclaration, PluginAiServiceKind, PluginAiServices, PluginAppBuilder, PluginAppCommands, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginBackground, PluginBbSdk, PluginBoundThreadsArea, PluginBrowserBbSdk, PluginCli, PluginCliBooleanOption, PluginCliCommand, PluginCliCommandInfo, PluginCliConstraint, PluginCliContext, PluginCliDurationOption, PluginCliDurationUnit, PluginCliEnumOption, PluginCliErrorCode, PluginCliExecutionResult, PluginCliIntegerOption, PluginCliOption, PluginCliOptionValues, PluginCliOutputLimitError, PluginCliPositional, PluginCliPositionalValues, PluginCliRegistration, PluginCliResult, PluginCliRunInput, PluginCliSpec, PluginCliStringOption, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandContext, PluginCommandRegistration, PluginCommandShortcut, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginDispatchAttemptKind, PluginDispatchEnvironmentIntent, PluginDispatchExecution, PluginDispatchExecutionSources, PluginDispatchInput, PluginEnvironmentProvider, PluginEnvironmentProviderDeclaration, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, PluginEnvironmentProviderRequirements, PluginEnvironmentProvidersState, PluginEnvironmentValidateDecision, PluginEnvironments, PluginEvents, PluginFileOpenerProps, PluginFileOpenerRegistration, PluginFileOpenerSource, PluginFixedTabDeclaration, PluginFixedTabRegistration, PluginHomepageSectionProps, PluginHomepageSectionRegistration, PluginHookHandler, PluginHookName, PluginHookSignatures, PluginHooks, PluginHosts, PluginHttp, PluginHttpAuthMode, PluginHttpHandler, PluginInteractionCancelReason, PluginInteractionDescription, PluginInteractionRequest, PluginInteractionResult, PluginKvStorage, PluginLogger, PluginMachineProviderDeclaration, PluginMachineProviderInputsChange, PluginMachineProviderInputsProps, PluginMachineProviderInputsRegistration, PluginMachineValidateDecision, PluginMachines, PluginMentionItem, PluginMentionProviderRegistration, PluginMentionSearchContext, PluginMentionTrigger, PluginMessageActionContext, PluginMessageActionRegistration, PluginMessageDirectiveMessage, PluginMessageDirectiveOpenWorkspaceFile, PluginMessageDirectiveProps, PluginMessageDirectiveRegistration, PluginNavPanelProps, PluginNavPanelRegistration, PluginNewThreadPanelActionContext, PluginNewThreadPanelActionRegistration, PluginNewThreadPanelProps, PluginPanelActionOpenOptions, PluginPendingInteractionProps, PluginPendingInteractionRegistration, PluginPendingInteractionView, PluginProviderCapabilities, PluginProviderCompletedTurnDisplay, PluginProviderComposerAction, PluginProviderDeclaration, PluginProviderExtensionKindDeclaration, PluginProviderFallbackModel, PluginProviderIconRegistration, PluginProviderMaintenance, PluginProviderModelCatalogScope, PluginProviderNativeRootEntry, PluginProviderNativeRoots, PluginProviderOptionDescriptor, PluginProviderOptionsContext, PluginProviderPermissionMode, PluginProviderReasoningLevel, PluginProviderStrings, PluginProviders, PluginProvidersState, PluginRealtime, PluginRealtimeConnectionState, PluginRowLabels, PluginRowPresentation, PluginRpc, PluginRpcCallArgs, PluginRpcClient, PluginRpcContract, PluginRpcError, PluginRpcErrorCode, PluginRpcHandlers, PluginRpcIssuePathSegment, PluginRpcMethodContract, PluginRpcResult, PluginRpcValidationIssue, PluginSdkApp, PluginServerAccess, PluginServerApi, PluginSettingDescriptor, PluginSettingDescriptors, PluginSettingValue, PluginSettings, PluginSettingsHandle, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsState, PluginSettingsValues, PluginSharedPortTunnelIdentity, PluginSidebarFooterActionContext, PluginSidebarFooterActionProps, PluginSidebarFooterActionRegistration, PluginSidebarProject, PluginSidebarPullRequest, PluginSidebarSection, PluginSidebarSplitLayout, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadDraftState, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadRowStatus, PluginSidebarThreadShortcut, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginStatusApi, PluginStorage, PluginTargetedPanelActionOpenOptions, PluginThreadEventHandler, PluginThreadEventName, PluginThreadEventPayloads, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginThreadTitleProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, PluginTurnFailedEvent, PluginUi, ReadonlyJsonValue, ServerAccessGrant, ServerAccessProviderDeclaration, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps, UseBranchesArgs, UseCheckoutStateArgs };

package/dist/app.js

@@ -29,6 +29,9 @@ var experimental_useSidebarThreads = runtime.experimental_useSidebarThreads;
 var experimental_useSidebarThreadActions = runtime.experimental_useSidebarThreadActions;
 var experimental_useSidebarThreadPullRequest = runtime.experimental_useSidebarThreadPullRequest;
 var experimental_useSidebarThreadSplit = runtime.experimental_useSidebarThreadSplit;
+var experimental_useSidebarNavigation = runtime.experimental_useSidebarNavigation;
+var experimental_useSidebarNavigationSplit = runtime.experimental_useSidebarNavigationSplit;
+var experimental_SidebarNavigationIcon = runtime.experimental_SidebarNavigationIcon;
 var useSidebarThreadDraft = runtime.useSidebarThreadDraft;
 var useSidebarThreadDraftIds = runtime.useSidebarThreadDraftIds;
 var useSidebarThreadRowStatus = runtime.useSidebarThreadRowStatus;
@@ -54,6 +57,7 @@ export {
   experimental_PermissionModePicker,
   experimental_ProviderIcon,
   experimental_ProviderModelPicker,
+  experimental_SidebarNavigationIcon,
   experimental_SourceCode,
   experimental_useAppPanel,
   experimental_useBranches,
@@ -61,6 +65,8 @@ export {
   experimental_useCodeTheme,
   experimental_useFixedTabTarget,
   experimental_useProviders,
+  experimental_useSidebarNavigation,
+  experimental_useSidebarNavigationSplit,
   experimental_useSidebarThreadActions,
   experimental_useSidebarThreadPullRequest,
   experimental_useSidebarThreadSplit,

package/dist/internal/plugin-app-collector.js

@@ -446,6 +446,7 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
     sidebarFooterActions: [],
     experimentalSidebarFooterItems: [],
     experimentalSidebarNavigations: [],
+    experimentalSidebarHeaders: [],
     threadLists: [],
     threadHeaderActions: [],
     browserToolbarActions: [],
@@ -474,6 +475,7 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
     pendingInteraction: /* @__PURE__ */ new Set(),
     sidebarFooterItem: /* @__PURE__ */ new Set(),
     sidebarNavigation: /* @__PURE__ */ new Set(),
+    sidebarHeader: /* @__PURE__ */ new Set(),
     threadList: /* @__PURE__ */ new Set(),
     threadHeaderAction: /* @__PURE__ */ new Set(),
     browserToolbarAction: /* @__PURE__ */ new Set(),
@@ -683,6 +685,15 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
           )
         );
       },
+      experimental_sidebarHeader(registration) {
+        collected.experimentalSidebarHeaders.push(
+          collectTitledComponent(
+            "slots.experimental_sidebarHeader",
+            seenIds.sidebarHeader,
+            registration
+          )
+        );
+      },
       experimental_threadList(registration) {
         collected.threadLists.push(
           collectTitledComponent(

package/dist/testing/app.js

@@ -620,6 +620,7 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
     sidebarFooterActions: [],
     experimentalSidebarFooterItems: [],
     experimentalSidebarNavigations: [],
+    experimentalSidebarHeaders: [],
     threadLists: [],
     threadHeaderActions: [],
     browserToolbarActions: [],
@@ -648,6 +649,7 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
     pendingInteraction: /* @__PURE__ */ new Set(),
     sidebarFooterItem: /* @__PURE__ */ new Set(),
     sidebarNavigation: /* @__PURE__ */ new Set(),
+    sidebarHeader: /* @__PURE__ */ new Set(),
     threadList: /* @__PURE__ */ new Set(),
     threadHeaderAction: /* @__PURE__ */ new Set(),
     browserToolbarAction: /* @__PURE__ */ new Set(),
@@ -857,6 +859,15 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
           )
         );
       },
+      experimental_sidebarHeader(registration) {
+        collected.experimentalSidebarHeaders.push(
+          collectTitledComponent(
+            "slots.experimental_sidebarHeader",
+            seenIds.sidebarHeader,
+            registration
+          )
+        );
+      },
       experimental_threadList(registration) {
         collected.threadLists.push(
           collectTitledComponent(
@@ -1100,6 +1111,19 @@ function TestThreadTitle({ threadId }) {
   if (thread === void 0) return null;
   return /* @__PURE__ */ jsx("span", { "data-thread-title": threadId, children: thread.displayTitle });
 }
+function TestSidebarNavigationIcon({
+  icon,
+  className
+}) {
+  return /* @__PURE__ */ jsx(
+    "span",
+    {
+      "aria-hidden": "true",
+      className,
+      "data-sidebar-navigation-icon": icon.kind === "host" ? icon.name : `${icon.pluginId}/${icon.icon ?? ""}`
+    }
+  );
+}
 function SlotLifecycleGuard({
   children,
   onUnmount
@@ -1679,6 +1703,28 @@ var testPluginSdkApp = {
     return env.sidebarShortcuts.get(threadId) ?? null;
   },
   ThreadTitle: TestThreadTitle,
+  experimental_useSidebarNavigation() {
+    return useSlotEnv("experimental_useSidebarNavigation").sidebarNavigation;
+  },
+  experimental_useSidebarNavigationSplit(itemId, _options) {
+    const env = useSlotEnv("experimental_useSidebarNavigationSplit");
+    return useMemo(
+      () => ({
+        splitProps: {
+          onPointerDown: () => {
+            env.sidebarNavigationCalls.push({
+              method: "beginSplitDrag",
+              itemId
+            });
+          }
+        },
+        isAvailable: true,
+        layout: null
+      }),
+      [env, itemId]
+    );
+  },
+  experimental_SidebarNavigationIcon: TestSidebarNavigationIcon,
   useEnvironmentProviders() {
     return useSlotEnv("useEnvironmentProviders").environmentProviders;
   },
@@ -1965,6 +2011,43 @@ function renderSlot(registration, props, options = {}) {
     }
   };
   const sidebarActionCalls = [];
+  const sidebarNavigationCalls = [];
+  const sidebarNavigation = {
+    items: options.sidebarNavigation?.items ?? [],
+    activeItemId: options.sidebarNavigation?.activeItemId ?? null,
+    isShortcutModifierHeld: options.sidebarNavigation?.isShortcutModifierHeld ?? false,
+    actions: {
+      activate(itemId, activationOptions) {
+        sidebarNavigationCalls.push({
+          method: "activate",
+          itemId,
+          openInSplit: activationOptions.openInSplit
+        });
+      },
+      setVisible(itemId, isVisible) {
+        sidebarNavigationCalls.push({
+          method: "setVisible",
+          itemId,
+          isVisible
+        });
+      },
+      setOrder(itemIds) {
+        sidebarNavigationCalls.push({
+          method: "setOrder",
+          itemIds: [...itemIds]
+        });
+      },
+      openCustomize() {
+        sidebarNavigationCalls.push({ method: "openCustomize" });
+      },
+      openDetails(itemId) {
+        sidebarNavigationCalls.push({ method: "openDetails", itemId });
+      },
+      async disablePlugin(itemId) {
+        sidebarNavigationCalls.push({ method: "disablePlugin", itemId });
+      }
+    }
+  };
   const sidebarPullRequests = new Map(
     Object.entries(options.sidebarPullRequests ?? {})
   );
@@ -2235,6 +2318,8 @@ ${block}
     sidebarRowStatuses,
     sidebarShortcuts,
     sidebarSplitLayout: options.sidebarSplitLayout ?? null,
+    sidebarNavigation,
+    sidebarNavigationCalls,
     environmentProviders,
     sdk,
     sdkCalls,
@@ -2306,6 +2391,7 @@ ${block}
     navigateCalls,
     experimental_fixedTabOpenCalls,
     sidebarActionCalls,
+    sidebarNavigationCalls,
     sdkCalls,
     composer: composerLog,
     behavior: {
@@ -2319,6 +2405,7 @@ ${block}
       navigateCalls,
       experimental_fixedTabOpenCalls,
       sidebarActionCalls,
+      sidebarNavigationCalls,
       sdkCalls,
       composer: composerLog
     },

package/dist/testing/index.js

@@ -3360,6 +3360,7 @@ function createFakePluginHostInternal(options, sharedState) {
   const machineProviders = /* @__PURE__ */ new Map();
   const serverAccessProviders = /* @__PURE__ */ new Map();
   const disposeHooks = [];
+  const installHandlers = [];
   const serviceControllers = [];
   let nextInteractionId = 1;
   const pendingInteractions = /* @__PURE__ */ new Map();
@@ -3685,6 +3686,13 @@ function createFakePluginHostInternal(options, sharedState) {
     onDispose(hook) {
       assertLive();
       disposeHooks.push(hook);
+    },
+    onInstall(handler) {
+      assertLive();
+      if (typeof handler !== "function") {
+        throw new Error("onInstall expects a function");
+      }
+      installHandlers.push(handler);
     }
   };
   async function disposeHost(cleanupStorage) {
@@ -4223,6 +4231,16 @@ function createFakePluginHostInternal(options, sharedState) {
     },
     async dispose() {
       await disposeHost(true);
+    },
+    async install() {
+      assertLive();
+      for (const handler of [...installHandlers]) {
+        try {
+          await handler();
+        } catch (error) {
+          emitLog("warn", `install handler failed: ${errorMessage(error)}`);
+        }
+      }
     }
   };
   fakeHostDisposers.set(harness, disposeHost);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@get-bb/plugin-sdk",
-  "version": "0.5.9",
+  "version": "0.5.15",
   "homepage": "https://github.com/get-bb/bb#readme",
   "bugs": {
     "url": "https://github.com/get-bb/bb/issues"