@get-bb/plugin-sdk 0.5.8 → 0.5.15

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
@@ -19501,8 +19705,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;
     /**
@@ -21632,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. */
@@ -21867,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(