@get-bb/plugin-sdk 0.5.9 → 0.5.16

package/README.md

@@ -178,13 +178,15 @@ slot.lifecycle.unmount();
 await scripts.lifecycle.dispose();
 ```
 
-`loadPluginApp` installs the runtime before a thunk import and validates all
-registrations. `mountPluginContentScripts` mirrors the host's ordered mount,
+`loadPluginApp` installs the runtime and validates all registrations; pass the
+imported module or a thunk. `@get-bb/plugin-sdk/app` exports look the runtime
+up when they are called or rendered, so a static import of `app.tsx` or of
+components works too. `mountPluginContentScripts` mirrors the host's ordered mount,
 rollback, independent per-window signal, and exact-once disposal. `renderSlot` supplies
 RPC, realtime, settings, navigation, context, and scoped composer behavior,
 then returns Testing Library queries plus the same behavior/inspection/lifecycle
-split. Use a setup-file `installTestPluginRuntime()` only when a static app
-import is unavoidable.
+split; it installs the runtime too. Call `installTestPluginRuntime()` yourself
+only when a test renders plugin components without `renderSlot`.
 
 ## Fidelity boundaries
 

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"]>;
@@ -274,6 +275,7 @@ declare const appKeybindingOverridesSchema: z$1.ZodArray<z$1.ZodObject<{
         "thread.previous": "thread.previous";
         "thread.rename": "thread.rename";
         "thread.search": "thread.search";
+        "window.find": "window.find";
         "window.new": "window.new";
         "workspace.openPreferred": "workspace.openPreferred";
     }>, z$1.ZodTemplateLiteral<`plugin:${string}/${string}`>]>;
@@ -5867,18 +5869,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 +5908,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 +8758,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 +8858,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>;
@@ -9955,6 +9965,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "thread.previous": "thread.previous";
             "thread.rename": "thread.rename";
             "thread.search": "thread.search";
+            "window.find": "window.find";
             "window.new": "window.new";
             "workspace.openPreferred": "workspace.openPreferred";
         }>, z$1.ZodTemplateLiteral<`plugin:${string}/${string}`>]>;
@@ -10098,6 +10109,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "thread.previous": "thread.previous";
             "thread.rename": "thread.rename";
             "thread.search": "thread.search";
+            "window.find": "window.find";
             "window.new": "window.new";
             "workspace.openPreferred": "workspace.openPreferred";
         }>, z$1.ZodTemplateLiteral<`plugin:${string}/${string}`>]>;
@@ -10181,6 +10193,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "thread.previous": "thread.previous";
             "thread.rename": "thread.rename";
             "thread.search": "thread.search";
+            "window.find": "window.find";
             "window.new": "window.new";
             "workspace.openPreferred": "workspace.openPreferred";
         }>, z$1.ZodTemplateLiteral<`plugin:${string}/${string}`>]>;
@@ -14512,18 +14525,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 +16629,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 +16651,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.
@@ -17619,7 +17776,7 @@ interface PluginSidebarThreadActions {
     setRead(threadId: string, read: boolean): Promise<void>;
     /** Silent rename — no dialog. For inline editing in your own row. */
     rename(threadId: string, title: string): Promise<void>;
-    /** Archives the thread AND its children, closing any panes showing them. */
+    /** Opens bb's confirmation before archiving the thread and its children. */
     archive(threadId: string): void;
     /**
      * Opens bb's delete confirmation, which counts child threads first. Deletion
@@ -17752,7 +17909,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 +17926,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 +18347,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
@@ -19172,6 +19359,15 @@ interface PluginSdkApp {
     useRealtimeConnectionState(): PluginRealtimeConnectionState;
     useSettings(): PluginSettingsState;
     useBbContext(): BbContext;
+    /**
+     * The id of the plugin that owns the calling component: the same id
+     * `bb.pluginId` reports on the server, derived from the package name. Key
+     * state the plugin keeps outside bb's per-plugin storage with it, such as
+     * localStorage entries and log prefixes, so a copy of the plugin published
+     * under another name does not collide with the original. Experimental: see
+     * docs/api_to_audit.md.
+     */
+    experimental_usePluginId(): string;
     useBbNavigate(): BbNavigate;
     /** Select one of this plugin's eligible fixed tabs on the current surface. */
     experimental_useAppPanel(): ExperimentalAppPanel;
@@ -19221,6 +19417,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
@@ -19381,7 +19598,7 @@ interface PluginSdkApp {
 
 declare const experimental_Icon: react.ComponentType<ExperimentalIconProps>;
 declare const experimental_ProviderIcon: react.ComponentType<ExperimentalProviderIconProps>;
-declare const definePluginApp: (setup: PluginAppSetup) => PluginAppDefinition;
+declare const definePluginApp: PluginSdkApp["definePluginApp"];
 declare const ThreadChat: react.ComponentType<ThreadChatProps>;
 declare const Markdown: react.ComponentType<MarkdownProps>;
 declare const experimental_FileLink: react.ComponentType<ExperimentalFileLinkProps>;
@@ -19399,6 +19616,7 @@ declare const useRealtime: (channel: string, handler: (payload: unknown) => void
 declare const useRealtimeConnectionState: () => PluginRealtimeConnectionState;
 declare const useSettings: () => PluginSettingsState;
 declare const useBbContext: () => BbContext;
+declare const experimental_usePluginId: () => string;
 declare const useBbNavigate: () => BbNavigate;
 declare const experimental_useAppPanel: () => ExperimentalAppPanel;
 declare const experimental_useFixedTabTarget: <Target extends JsonValue$1>(tab: ExperimentalPluginFixedTabReference<Target>) => ExperimentalFixedTabTargetState<Target> | null;
@@ -19410,6 +19628,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 +19643,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_usePluginId, 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[];