@get-bb/plugin-sdk 0.5.8 → 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
@@ -19349,8 +19553,10 @@ interface PluginSdkApp {
      */
     experimental_BranchPicker: ComponentType<BranchPickerProps>;
     /**
-     * Search and refresh the branch list for one project source. Experimental:
-     * see docs/api_to_audit.md.
+     * Search and refresh the branch list for one project source. `query` is
+     * debounced before it reaches the host, so a control can pass it on every
+     * keystroke; filtering the returned lists stays the caller's job.
+     * Experimental: see docs/api_to_audit.md.
      */
     experimental_useBranches(args: UseBranchesArgs): BranchesState;
     /**
@@ -19408,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;
@@ -19420,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;