@get-bb/plugin-sdk 0.4.35 → 0.4.40

package/README.md

@@ -65,6 +65,16 @@ action id, or a surface with no side panel). A decline is a return value, never
 a thrown error, so a plugin registering several kinds of action can share one
 open routine and branch on the result.
 
+Use `app.slots.experimental_appOverlay({ id, component })` for additive,
+app-wide floating React UI. BB mounts the component once per app window through
+the normal plugin slot boundary, so SDK hooks and plugin CSS work and React
+context survives portals. This app-level boundary includes the sidebar thread
+data and action hooks. Hooks whose contract requires a particular surface,
+including `useComposer` and `useComposerView`, remain limited to that surface.
+The plugin owns the overlay's chrome, positioning, visibility, focus, and
+responsive behavior; a crashing overlay is hidden without affecting siblings.
+Use a content script for app-wide DOM behavior that does not need React context.
+
 See the
 [`composer-customization` reference plugin](../../examples/plugins/composer-customization/README.md)
 for every region in one small app. The deprecated pre-1.0

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

@@ -341,6 +341,14 @@ interface PluginHomepageSectionProps {
  */
 interface PluginSettingsSectionProps {
 }
+/**
+ * Props passed to an `experimental_appOverlay` component.
+ *
+ * Deliberately empty while the component reads live app state through SDK
+ * hooks; versioned additive like the other slot props.
+ */
+interface ExperimentalAppOverlayProps {
+}
 /** Props passed to a `navPanel` component (it owns its whole route). */
 interface PluginNavPanelProps {
     /**
@@ -705,6 +713,21 @@ interface PluginSettingsSectionRegistration {
     description?: string;
     component: ComponentType<PluginSettingsSectionProps>;
 }
+/**
+ * Render app-wide plugin UI outside BB's layout regions.
+ *
+ * The host mounts each registration once per app window through the ordinary
+ * plugin React boundary. The component therefore keeps PluginContext, router,
+ * query, realtime, and other app-level SDK contexts when it renders fixed UI
+ * or creates a React portal. BB supplies no chrome, positioning, visibility,
+ * or interaction policy; the plugin owns those details and responsive
+ * behavior. Registrations are additive and a crash hides only that overlay.
+ */
+interface ExperimentalAppOverlayRegistration {
+    /** Unique within the plugin; letters, digits, `-`, `_`. */
+    id: string;
+    component: ComponentType<ExperimentalAppOverlayProps>;
+}
 /**
  * Owner-defined validator for a fixed tab's transient target. The host first
  * verifies that the value is JSON-safe, then calls this validator before
@@ -1522,6 +1545,12 @@ interface PluginTimelineRendererRegistration {
 interface PluginAppSlots {
     homepageSection(registration: PluginHomepageSectionRegistration): void;
     settingsSection(registration: PluginSettingsSectionRegistration): void;
+    /**
+     * Render one app-wide overlay component (see
+     * {@link ExperimentalAppOverlayRegistration}). Experimental: see
+     * docs/api_to_audit.md.
+     */
+    experimental_appOverlay(registration: ExperimentalAppOverlayRegistration): void;
     navPanel(registration: PluginNavPanelRegistration): void;
     /**
      * Add an action to an existing thread's panel launcher. This slot is
@@ -1661,7 +1690,7 @@ interface PluginSettingsState {
      * Effective non-secret setting values (secret settings are excluded —
      * read them server-side). Undefined while loading or unavailable.
      */
-    values: Record<string, string | boolean> | undefined;
+    values: Record<string, string | number | boolean> | undefined;
     isLoading: boolean;
 }
 /** State of the app's shared realtime connection to the bb server. */
@@ -2441,4 +2470,4 @@ declare const experimental_useProviders: () => PluginProvidersState;
 declare const experimental_useCodeTheme: () => PluginCodeThemeState;
 
 export { Markdown, ThreadChat, UrlLink, definePluginApp, experimental_Diff, experimental_FileLink, experimental_NewThreadComposer, experimental_PermissionModePicker, experimental_ProviderModelPicker, experimental_SourceCode, experimental_useAppPanel, experimental_useCodeTheme, experimental_useFixedTabTarget, experimental_useProviders, experimental_useSidebarThreadActions, experimental_useSidebarThreadPullRequest, experimental_useSidebarThreadSplit, experimental_useSidebarThreads, useBbContext, useBbNavigate, useComposer, useComposerView, useRealtime, useRealtimeConnectionState, useRpc, useSettings };
-export type { BbContext, BbNavigate, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSubmitOptions, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginFixedTabReference, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, JsonValue, MarkdownProps, NewThreadComposerProps, NewThreadRequest, PluginAppBuilder, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandPaletteActionContext, PluginCommandPaletteActionRegistration, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginFileOpenerProps, PluginFileOpenerRegistration, PluginFileOpenerSource, PluginFixedTabDeclaration, PluginFixedTabRegistration, PluginHomepageSectionProps, PluginHomepageSectionRegistration, PluginMessageActionContext, PluginMessageActionRegistration, PluginMessageDirectiveMessage, PluginMessageDirectiveOpenWorkspaceFile, PluginMessageDirectiveProps, PluginMessageDirectiveRegistration, PluginNavPanelProps, PluginNavPanelRegistration, PluginNewThreadPanelActionContext, PluginNewThreadPanelActionRegistration, PluginNewThreadPanelProps, PluginPanelActionOpenOptions, PluginPendingInteractionProps, PluginPendingInteractionRegistration, PluginPendingInteractionView, PluginProviderIconRegistration, PluginProvidersState, PluginRealtimeConnectionState, PluginRpcCallArgs, PluginRpcClient, PluginRpcContract, PluginRpcError, PluginRpcErrorCode, PluginRpcHandlers, PluginRpcIssuePathSegment, PluginRpcMethodContract, PluginRpcResult, PluginRpcValidationIssue, PluginSdkApp, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsState, PluginSidebarFooterActionContext, PluginSidebarFooterActionProps, PluginSidebarFooterActionRegistration, PluginSidebarProject, PluginSidebarPullRequest, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSidebarWorkspaceKind, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginTargetedPanelActionOpenOptions, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps };
+export type { BbContext, BbNavigate, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSubmitOptions, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginFixedTabReference, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, JsonValue, MarkdownProps, NewThreadComposerProps, NewThreadRequest, PluginAppBuilder, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandPaletteActionContext, PluginCommandPaletteActionRegistration, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginFileOpenerProps, PluginFileOpenerRegistration, PluginFileOpenerSource, PluginFixedTabDeclaration, PluginFixedTabRegistration, PluginHomepageSectionProps, PluginHomepageSectionRegistration, PluginMessageActionContext, PluginMessageActionRegistration, PluginMessageDirectiveMessage, PluginMessageDirectiveOpenWorkspaceFile, PluginMessageDirectiveProps, PluginMessageDirectiveRegistration, PluginNavPanelProps, PluginNavPanelRegistration, PluginNewThreadPanelActionContext, PluginNewThreadPanelActionRegistration, PluginNewThreadPanelProps, PluginPanelActionOpenOptions, PluginPendingInteractionProps, PluginPendingInteractionRegistration, PluginPendingInteractionView, PluginProviderIconRegistration, PluginProvidersState, PluginRealtimeConnectionState, PluginRpcCallArgs, PluginRpcClient, PluginRpcContract, PluginRpcError, PluginRpcErrorCode, PluginRpcHandlers, PluginRpcIssuePathSegment, PluginRpcMethodContract, PluginRpcResult, PluginRpcValidationIssue, PluginSdkApp, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsState, PluginSidebarFooterActionContext, PluginSidebarFooterActionProps, PluginSidebarFooterActionRegistration, PluginSidebarProject, PluginSidebarPullRequest, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSidebarWorkspaceKind, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginTargetedPanelActionOpenOptions, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps };

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

@@ -512,6 +512,12 @@ type PluginSettingDescriptor = {
     /** Synchronously validate without transforming a proposed value. */
     experimental_schema?: StandardSchemaV1<boolean, boolean>;
     default?: boolean;
+} | {
+    type: "number";
+    label: string;
+    description?: string;
+    experimental_schema?: StandardSchemaV1<number, number>;
+    default?: number;
 } | {
     type: "select";
     label: string;
@@ -529,7 +535,7 @@ type PluginSettingDescriptor = {
     default?: string;
 };
 type PluginSettingDescriptors = Record<string, PluginSettingDescriptor>;
-type PluginSettingValue = string | boolean;
+type PluginSettingValue = string | number | boolean;
 /**
  * What a `message.dispatch` hook answers.
  *

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

@@ -5,12 +5,13 @@
 // Confused by the API, or need a symbol that isn't here? Clone the BB repo
 // and read the real source: https://github.com/get-bb/bb
 
-import { PluginHomepageSectionRegistration, PluginSettingsSectionRegistration, PluginNavPanelRegistration, PluginThreadPanelActionRegistration, PluginNewThreadPanelActionRegistration, ComposerCustomization, PluginPendingInteractionRegistration, PluginSidebarFooterActionRegistration, ExperimentalSidebarNavigationRegistration, PluginThreadListRegistration, PluginThreadHeaderActionRegistration, PluginFileOpenerRegistration, PluginSourceCodeRendererRegistration, PluginDiffRendererRegistration, PluginMessageDirectiveRegistration, PluginMessageActionRegistration, PluginCommandPaletteActionRegistration, PluginProviderIconRegistration, PluginTimelineRendererRegistration, PluginContentScriptRegistration, PluginAppDefinition } from '@get-bb/plugin-sdk';
+import { PluginHomepageSectionRegistration, PluginSettingsSectionRegistration, ExperimentalAppOverlayRegistration, PluginNavPanelRegistration, PluginThreadPanelActionRegistration, PluginNewThreadPanelActionRegistration, ComposerCustomization, PluginPendingInteractionRegistration, PluginSidebarFooterActionRegistration, ExperimentalSidebarNavigationRegistration, PluginThreadListRegistration, PluginThreadHeaderActionRegistration, PluginFileOpenerRegistration, PluginSourceCodeRendererRegistration, PluginDiffRendererRegistration, PluginMessageDirectiveRegistration, PluginMessageActionRegistration, PluginCommandPaletteActionRegistration, PluginProviderIconRegistration, PluginTimelineRendererRegistration, PluginContentScriptRegistration, PluginAppDefinition } from '@get-bb/plugin-sdk';
 
 /** Validated registrations produced by one plugin app setup execution. */
 interface CollectedPluginAppRegistrations {
     homepageSections: PluginHomepageSectionRegistration[];
     settingsSections: PluginSettingsSectionRegistration[];
+    appOverlays: ExperimentalAppOverlayRegistration[];
     navPanels: PluginNavPanelRegistration[];
     threadPanelActions: PluginThreadPanelActionRegistration[];
     newThreadPanelActions: PluginNewThreadPanelActionRegistration[];

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 { PluginHomepageSectionRegistration, PluginSettingsSectionRegistration, PluginNavPanelRegistration, PluginThreadPanelActionRegistration, PluginNewThreadPanelActionRegistration, ComposerCustomization, PluginPendingInteractionRegistration, PluginSidebarFooterActionRegistration, ExperimentalSidebarNavigationRegistration, PluginThreadListRegistration, PluginThreadHeaderActionRegistration, PluginFileOpenerRegistration, PluginSourceCodeRendererRegistration, PluginDiffRendererRegistration, PluginMessageDirectiveRegistration, PluginMessageActionRegistration, PluginProviderIconRegistration, PluginTimelineRendererRegistration, PluginContentScriptRegistration, PluginComposerScope, PluginComposerTextEffect, PluginComposerMention, PluginComposerThreadRowStatus, ExperimentalOpenFixedTabOptions, JsonValue, BbNavigate, ExperimentalFileOpenOptions, PluginAppDefinition, PluginRpcContract, StandardSchemaV1InferInput, PluginRpcResult, PluginRealtimeConnectionState, PluginSidebarThreadsState, PluginProvidersState, PluginCodeThemeState, PluginSidebarPullRequest, PluginSidebarThreadActions } from '@get-bb/plugin-sdk';
+import { PluginHomepageSectionRegistration, PluginSettingsSectionRegistration, ExperimentalAppOverlayRegistration, PluginNavPanelRegistration, PluginThreadPanelActionRegistration, PluginNewThreadPanelActionRegistration, ComposerCustomization, PluginPendingInteractionRegistration, PluginSidebarFooterActionRegistration, ExperimentalSidebarNavigationRegistration, PluginThreadListRegistration, PluginThreadHeaderActionRegistration, PluginFileOpenerRegistration, PluginSourceCodeRendererRegistration, PluginDiffRendererRegistration, PluginMessageDirectiveRegistration, PluginMessageActionRegistration, PluginProviderIconRegistration, PluginTimelineRendererRegistration, PluginContentScriptRegistration, PluginComposerScope, PluginComposerTextEffect, PluginComposerMention, PluginComposerThreadRowStatus, ExperimentalOpenFixedTabOptions, JsonValue, BbNavigate, ExperimentalFileOpenOptions, PluginAppDefinition, PluginRpcContract, StandardSchemaV1InferInput, PluginRpcResult, PluginRealtimeConnectionState, PluginSidebarThreadsState, PluginProvidersState, PluginCodeThemeState, PluginSidebarPullRequest, PluginSidebarThreadActions } from '@get-bb/plugin-sdk';
 
 /**
  * `@get-bb/plugin-sdk/testing/app` — the frontend plugin test harness. Tests a
@@ -118,6 +118,7 @@ declare function installTestPluginRuntime(): void;
 interface CapturedPluginApp {
     homepageSections: PluginHomepageSectionRegistration[];
     settingsSections: PluginSettingsSectionRegistration[];
+    appOverlays: ExperimentalAppOverlayRegistration[];
     navPanels: PluginNavPanelRegistration[];
     threadPanelActions: PluginThreadPanelActionRegistration[];
     newThreadPanelActions: PluginNewThreadPanelActionRegistration[];
@@ -192,7 +193,7 @@ interface RenderSlotOptions<Contract extends PluginRpcContract = PluginRpcContra
      */
     rpc?: PluginRpcTestHandlers<Contract>;
     /** `useSettings()` values; omitted → `{ values: undefined, isLoading: false }`. */
-    settings?: Record<string, string | boolean>;
+    settings?: Record<string, string | number | boolean>;
     /** `useBbContext()` selection; both default to null. */
     context?: {
         projectId?: string | null;

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

@@ -102,7 +102,7 @@ interface StandardSchemaV1Issue {
     })[];
 }
 
-type PluginSettingValue = string | boolean;
+type PluginSettingValue = string | number | boolean;
 /**
  * Permission modes a provider can run a session in — BB's own permission
  * vocabulary, ordered least ("accept-edits") to most ("full") privileged.
@@ -770,6 +770,10 @@ interface FakePluginHarness extends FakePluginInspectionState, FakePluginBehavio
 interface CreateFakePluginHostOptions {
     /** Defaults to "test-plugin". */
     pluginId?: string;
+    /**
+     * Value served by `bb.server.experimental_appUrl`. Defaults to `null`.
+     */
+    appUrl?: string | null;
     /**
      * Value served by `bb.server.loopbackBaseUrl` (always bound here, like
      * `bb.sdk`). Defaults to "http://127.0.0.1:38886".

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

@@ -4464,15 +4464,6 @@ declare const commitActionResponseSchema: z$1.ZodObject<{
     ok: z$1.ZodLiteral<true>;
 }, z$1.core.$strip>;
 type CommitActionResponse = z$1.infer<typeof commitActionResponseSchema>;
-declare const squashMergeActionResponseSchema: z$1.ZodObject<{
-    action: z$1.ZodLiteral<"squash_merge">;
-    commitSha: z$1.ZodString;
-    commitSubject: z$1.ZodString;
-    merged: z$1.ZodBoolean;
-    message: z$1.ZodString;
-    ok: z$1.ZodLiteral<true>;
-}, z$1.core.$strip>;
-type SquashMergeActionResponse = z$1.infer<typeof squashMergeActionResponseSchema>;
 declare const pullRequestReadyActionResponseSchema: z$1.ZodObject<{
     action: z$1.ZodLiteral<"pull_request_ready">;
     message: z$1.ZodString;
@@ -6086,24 +6077,6 @@ declare const hostDaemonCommandRegistry: {
         commitSha: z$1.ZodString;
         commitSubject: z$1.ZodString;
     }, z$1.core.$strip>, "settled", false>;
-    "workspace.squash_merge": HostDaemonCommandDescriptor<"workspace.squash_merge", z$1.ZodObject<{
-        commitMessage: z$1.ZodString;
-        environmentId: z$1.ZodString;
-        targetBranch: z$1.ZodString;
-        type: z$1.ZodLiteral<"workspace.squash_merge">;
-        workspaceContext: z$1.ZodObject<{
-            workspacePath: z$1.ZodString;
-            workspaceProvisionType: z$1.ZodEnum<{
-                "managed-worktree": "managed-worktree";
-                personal: "personal";
-                unmanaged: "unmanaged";
-            }>;
-        }, z$1.core.$strip>;
-    }, z$1.core.$strict>, z$1.ZodObject<{
-        commitSha: z$1.ZodString;
-        commitSubject: z$1.ZodString;
-        merged: z$1.ZodBoolean;
-    }, z$1.core.$strip>, "settled", false>;
     "workspace.pull_request_action": HostDaemonCommandDescriptor<"workspace.pull_request_action", z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
         environmentId: z$1.ZodString;
         operation: z$1.ZodLiteral<"ready">;
@@ -7581,10 +7554,16 @@ declare const installedPluginSchema: z$1.ZodObject<{
     }, z$1.core.$strip>>>;
     catalogEntryId: z$1.ZodOptional<z$1.ZodString>;
     catalogMarketplaceName: z$1.ZodOptional<z$1.ZodString>;
+    category: z$1.ZodOptional<z$1.ZodString>;
+    categoryId: z$1.ZodOptional<z$1.ZodString>;
     cliCommand: z$1.ZodNullable<z$1.ZodObject<{
         name: z$1.ZodString;
         summary: z$1.ZodString;
     }, z$1.core.$strip>>;
+    collections: z$1.ZodArray<z$1.ZodObject<{
+        id: z$1.ZodString;
+        rank: z$1.ZodNumber;
+    }, z$1.core.$strip>>;
     description: z$1.ZodNullable<z$1.ZodString>;
     enabled: z$1.ZodBoolean;
     handlerStats: z$1.ZodObject<{
@@ -7608,6 +7587,7 @@ declare const installedPluginSchema: z$1.ZodObject<{
         direct: "direct";
     }>;
     providerIds: z$1.ZodArray<z$1.ZodString>;
+    publishedAt: z$1.ZodOptional<z$1.ZodISODateTime>;
     publisherLabel: z$1.ZodDefault<z$1.ZodNullable<z$1.ZodString>>;
     rootDir: z$1.ZodString;
     schedules: z$1.ZodArray<z$1.ZodObject<{
@@ -7622,6 +7602,7 @@ declare const installedPluginSchema: z$1.ZodObject<{
         name: z$1.ZodString;
         nextRunAt: z$1.ZodNumber;
     }, z$1.core.$strip>>;
+    screenshots: z$1.ZodArray<z$1.ZodString>;
     services: z$1.ZodArray<z$1.ZodObject<{
         name: z$1.ZodString;
         state: z$1.ZodEnum<{
@@ -7661,6 +7642,7 @@ declare const installedPluginSchema: z$1.ZodObject<{
             unavailable: "unavailable";
         }>>;
     }, z$1.core.$strip>;
+    updatedAt: z$1.ZodOptional<z$1.ZodISODateTime>;
     version: z$1.ZodString;
 }, z$1.core.$strip>;
 type InstalledPlugin = z$1.infer<typeof installedPluginSchema>;
@@ -7691,10 +7673,16 @@ declare const pluginListResponseSchema: z$1.ZodObject<{
         }, z$1.core.$strip>>>;
         catalogEntryId: z$1.ZodOptional<z$1.ZodString>;
         catalogMarketplaceName: z$1.ZodOptional<z$1.ZodString>;
+        category: z$1.ZodOptional<z$1.ZodString>;
+        categoryId: z$1.ZodOptional<z$1.ZodString>;
         cliCommand: z$1.ZodNullable<z$1.ZodObject<{
             name: z$1.ZodString;
             summary: z$1.ZodString;
         }, z$1.core.$strip>>;
+        collections: z$1.ZodArray<z$1.ZodObject<{
+            id: z$1.ZodString;
+            rank: z$1.ZodNumber;
+        }, z$1.core.$strip>>;
         description: z$1.ZodNullable<z$1.ZodString>;
         enabled: z$1.ZodBoolean;
         handlerStats: z$1.ZodObject<{
@@ -7718,6 +7706,7 @@ declare const pluginListResponseSchema: z$1.ZodObject<{
             direct: "direct";
         }>;
         providerIds: z$1.ZodArray<z$1.ZodString>;
+        publishedAt: z$1.ZodOptional<z$1.ZodISODateTime>;
         publisherLabel: z$1.ZodDefault<z$1.ZodNullable<z$1.ZodString>>;
         rootDir: z$1.ZodString;
         schedules: z$1.ZodArray<z$1.ZodObject<{
@@ -7732,6 +7721,7 @@ declare const pluginListResponseSchema: z$1.ZodObject<{
             name: z$1.ZodString;
             nextRunAt: z$1.ZodNumber;
         }, z$1.core.$strip>>;
+        screenshots: z$1.ZodArray<z$1.ZodString>;
         services: z$1.ZodArray<z$1.ZodObject<{
             name: z$1.ZodString;
             state: z$1.ZodEnum<{
@@ -7771,6 +7761,7 @@ declare const pluginListResponseSchema: z$1.ZodObject<{
                 unavailable: "unavailable";
             }>>;
         }, z$1.core.$strip>;
+        updatedAt: z$1.ZodOptional<z$1.ZodISODateTime>;
         version: z$1.ZodString;
     }, z$1.core.$strip>>;
 }, z$1.core.$strip>;
@@ -7803,10 +7794,16 @@ declare const pluginReloadResponseSchema: z$1.ZodObject<{
         }, z$1.core.$strip>>>;
         catalogEntryId: z$1.ZodOptional<z$1.ZodString>;
         catalogMarketplaceName: z$1.ZodOptional<z$1.ZodString>;
+        category: z$1.ZodOptional<z$1.ZodString>;
+        categoryId: z$1.ZodOptional<z$1.ZodString>;
         cliCommand: z$1.ZodNullable<z$1.ZodObject<{
             name: z$1.ZodString;
             summary: z$1.ZodString;
         }, z$1.core.$strip>>;
+        collections: z$1.ZodArray<z$1.ZodObject<{
+            id: z$1.ZodString;
+            rank: z$1.ZodNumber;
+        }, z$1.core.$strip>>;
         description: z$1.ZodNullable<z$1.ZodString>;
         enabled: z$1.ZodBoolean;
         handlerStats: z$1.ZodObject<{
@@ -7830,6 +7827,7 @@ declare const pluginReloadResponseSchema: z$1.ZodObject<{
             direct: "direct";
         }>;
         providerIds: z$1.ZodArray<z$1.ZodString>;
+        publishedAt: z$1.ZodOptional<z$1.ZodISODateTime>;
         publisherLabel: z$1.ZodDefault<z$1.ZodNullable<z$1.ZodString>>;
         rootDir: z$1.ZodString;
         schedules: z$1.ZodArray<z$1.ZodObject<{
@@ -7844,6 +7842,7 @@ declare const pluginReloadResponseSchema: z$1.ZodObject<{
             name: z$1.ZodString;
             nextRunAt: z$1.ZodNumber;
         }, z$1.core.$strip>>;
+        screenshots: z$1.ZodArray<z$1.ZodString>;
         services: z$1.ZodArray<z$1.ZodObject<{
             name: z$1.ZodString;
             state: z$1.ZodEnum<{
@@ -7883,6 +7882,7 @@ declare const pluginReloadResponseSchema: z$1.ZodObject<{
                 unavailable: "unavailable";
             }>>;
         }, z$1.core.$strip>;
+        updatedAt: z$1.ZodOptional<z$1.ZodISODateTime>;
         version: z$1.ZodString;
     }, z$1.core.$strip>>;
 }, z$1.core.$strip>;
@@ -7905,6 +7905,11 @@ declare const pluginSettingsResponseSchema: z$1.ZodObject<{
         description: z$1.ZodOptional<z$1.ZodString>;
         label: z$1.ZodString;
         type: z$1.ZodLiteral<"boolean">;
+    }, z$1.core.$strict>, z$1.ZodObject<{
+        default: z$1.ZodOptional<z$1.ZodNumber>;
+        description: z$1.ZodOptional<z$1.ZodString>;
+        label: z$1.ZodString;
+        type: z$1.ZodLiteral<"number">;
     }, z$1.core.$strict>, z$1.ZodObject<{
         default: z$1.ZodOptional<z$1.ZodString>;
         description: z$1.ZodOptional<z$1.ZodString>;
@@ -7931,32 +7936,48 @@ declare const pluginCatalogStatusSchema: z$1.ZodObject<{
     pluginCount: z$1.ZodNumber;
 }, z$1.core.$strip>;
 type PluginCatalogStatus = z$1.infer<typeof pluginCatalogStatusSchema>;
-declare const pluginCatalogSearchResultSchema: z$1.ZodObject<{
-    author: z$1.ZodNullable<z$1.ZodObject<{
-        name: z$1.ZodString;
-        url: z$1.ZodNullable<z$1.ZodString>;
+declare const pluginCatalogSearchResponseSchema: z$1.ZodObject<{
+    collections: z$1.ZodArray<z$1.ZodObject<{
+        displayName: z$1.ZodString;
+        id: z$1.ZodString;
+        pluginIds: z$1.ZodArray<z$1.ZodString>;
+    }, z$1.core.$strip>>;
+    results: z$1.ZodArray<z$1.ZodObject<{
+        author: z$1.ZodNullable<z$1.ZodObject<{
+            github: z$1.ZodDefault<z$1.ZodNullable<z$1.ZodString>>;
+            name: z$1.ZodString;
+            url: z$1.ZodNullable<z$1.ZodString>;
+        }, z$1.core.$strip>>;
+        category: z$1.ZodOptional<z$1.ZodString>;
+        categoryId: z$1.ZodOptional<z$1.ZodString>;
+        collections: z$1.ZodDefault<z$1.ZodArray<z$1.ZodObject<{
+            id: z$1.ZodString;
+            rank: z$1.ZodNumber;
+        }, z$1.core.$strip>>>;
+        compatible: z$1.ZodBoolean;
+        description: z$1.ZodString;
+        displayName: z$1.ZodString;
+        entryId: z$1.ZodString;
+        icon: z$1.ZodNullable<z$1.ZodString>;
+        iconTinted: z$1.ZodDefault<z$1.ZodBoolean>;
+        iconUrl: z$1.ZodNullable<z$1.ZodString>;
+        incompatibleReason: z$1.ZodNullable<z$1.ZodString>;
+        installed: z$1.ZodBoolean;
+        installs: z$1.ZodDefault<z$1.ZodNullable<z$1.ZodNumber>>;
+        marketplace: z$1.ZodString;
+        marketplaceDisplayName: z$1.ZodString;
+        official: z$1.ZodBoolean;
+        pluginId: z$1.ZodString;
+        publishedAt: z$1.ZodOptional<z$1.ZodISODateTime>;
+        publisherKey: z$1.ZodString;
+        publisherLabel: z$1.ZodString;
+        repositoryUrl: z$1.ZodDefault<z$1.ZodNullable<z$1.ZodString>>;
+        screenshots: z$1.ZodDefault<z$1.ZodArray<z$1.ZodString>>;
+        source: z$1.ZodString;
+        updatedAt: z$1.ZodOptional<z$1.ZodISODateTime>;
     }, z$1.core.$strip>>;
-    category: z$1.ZodString;
-    compatible: z$1.ZodBoolean;
-    description: z$1.ZodString;
-    displayName: z$1.ZodString;
-    entryId: z$1.ZodString;
-    icon: z$1.ZodNullable<z$1.ZodString>;
-    iconTinted: z$1.ZodDefault<z$1.ZodBoolean>;
-    iconUrl: z$1.ZodNullable<z$1.ZodString>;
-    incompatibleReason: z$1.ZodNullable<z$1.ZodString>;
-    installed: z$1.ZodBoolean;
-    installs: z$1.ZodDefault<z$1.ZodNullable<z$1.ZodNumber>>;
-    marketplace: z$1.ZodString;
-    marketplaceDisplayName: z$1.ZodString;
-    official: z$1.ZodBoolean;
-    pluginId: z$1.ZodString;
-    publisherKey: z$1.ZodString;
-    publisherLabel: z$1.ZodString;
-    repositoryUrl: z$1.ZodDefault<z$1.ZodNullable<z$1.ZodString>>;
-    source: z$1.ZodString;
 }, z$1.core.$strip>;
-type PluginCatalogSearchResult$1 = z$1.infer<typeof pluginCatalogSearchResultSchema>;
+type PluginCatalogSearchResponse = z$1.infer<typeof pluginCatalogSearchResponseSchema>;
 declare const pluginCatalogResolvedSourceSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
     kind: z$1.ZodLiteral<"npm">;
     package: z$1.ZodString;
@@ -7988,6 +8009,7 @@ declare const pluginCatalogInstallPlanSchema: z$1.ZodDiscriminatedUnion<[z$1.Zod
     source: z$1.ZodString;
 }, z$1.core.$strip>, z$1.ZodObject<{
     author: z$1.ZodObject<{
+        github: z$1.ZodDefault<z$1.ZodNullable<z$1.ZodString>>;
         name: z$1.ZodString;
         url: z$1.ZodNullable<z$1.ZodString>;
     }, z$1.core.$strip>;
@@ -10280,26 +10302,143 @@ declare const sendMessageResponseSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObjec
 }, z$1.core.$strip>, z$1.ZodObject<{
     delivery: z$1.ZodLiteral<"queued">;
     ok: z$1.ZodLiteral<true>;
-    queuedMessageId: z$1.ZodString;
-    sendAt: z$1.ZodNullable<z$1.ZodNumber>;
-    waitingOn: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
-        kind: z$1.ZodLiteral<"time">;
-    }, z$1.core.$strip>, z$1.ZodObject<{
-        kind: z$1.ZodLiteral<"thread-busy">;
-    }, z$1.core.$strip>, z$1.ZodObject<{
-        kind: z$1.ZodLiteral<"turn-starting">;
-    }, z$1.core.$strip>, z$1.ZodObject<{
-        kind: z$1.ZodLiteral<"provisioning">;
-    }, z$1.core.$strip>, z$1.ZodObject<{
-        hostName: z$1.ZodString;
-        kind: z$1.ZodLiteral<"host-offline">;
-    }, z$1.core.$strip>, z$1.ZodObject<{
-        kind: z$1.ZodLiteral<"interaction">;
-    }, z$1.core.$strip>, z$1.ZodObject<{
-        kind: z$1.ZodLiteral<"plugin">;
-        pluginId: z$1.ZodString;
-        reason: z$1.ZodString;
-    }, z$1.core.$strip>], "kind">;
+    queuedMessage: z$1.ZodObject<{
+        content: z$1.ZodArray<z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+            mentions: z$1.ZodDefault<z$1.ZodArray<z$1.ZodObject<{
+                end: z$1.ZodNumber;
+                resource: z$1.ZodPipe<z$1.ZodTransform<unknown, unknown>, z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+                    kind: z$1.ZodLiteral<"thread">;
+                    label: z$1.ZodString;
+                    projectId: z$1.ZodOptional<z$1.ZodString>;
+                    threadId: z$1.ZodString;
+                }, z$1.core.$strip>, z$1.ZodObject<{
+                    kind: z$1.ZodLiteral<"project">;
+                    label: z$1.ZodString;
+                    projectId: z$1.ZodString;
+                }, z$1.core.$strip>, z$1.ZodObject<{
+                    kind: z$1.ZodLiteral<"section">;
+                    label: z$1.ZodString;
+                    sectionId: z$1.ZodString;
+                }, z$1.core.$strip>, z$1.ZodObject<{
+                    entryKind: z$1.ZodEnum<{
+                        directory: "directory";
+                        file: "file";
+                    }>;
+                    kind: z$1.ZodLiteral<"path">;
+                    label: z$1.ZodString;
+                    path: z$1.ZodString;
+                    source: z$1.ZodEnum<{
+                        "thread-storage": "thread-storage";
+                        workspace: "workspace";
+                    }>;
+                }, z$1.core.$strip>, z$1.ZodObject<{
+                    argumentHint: z$1.ZodNullable<z$1.ZodString>;
+                    kind: z$1.ZodLiteral<"command">;
+                    label: z$1.ZodString;
+                    name: z$1.ZodString;
+                    origin: z$1.ZodEnum<{
+                        builtin: "builtin";
+                        project: "project";
+                        user: "user";
+                    }>;
+                    source: z$1.ZodEnum<{
+                        command: "command";
+                        skill: "skill";
+                    }>;
+                    trigger: z$1.ZodEnum<{
+                        "/": "/";
+                    }>;
+                }, z$1.core.$strip>, z$1.ZodObject<{
+                    icon: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodString>>;
+                    itemId: z$1.ZodString;
+                    kind: z$1.ZodLiteral<"plugin">;
+                    label: z$1.ZodString;
+                    pluginId: z$1.ZodString;
+                }, z$1.core.$strip>], "kind">>;
+                start: z$1.ZodNumber;
+            }, z$1.core.$strip>>>;
+            text: z$1.ZodString;
+            type: z$1.ZodLiteral<"text">;
+            visibility: z$1.ZodOptional<z$1.ZodEnum<{
+                "agent-only": "agent-only";
+            }>>;
+        }, z$1.core.$strip>, z$1.ZodObject<{
+            type: z$1.ZodLiteral<"image">;
+            url: z$1.ZodString;
+            visibility: z$1.ZodOptional<z$1.ZodEnum<{
+                "agent-only": "agent-only";
+            }>>;
+        }, z$1.core.$strip>, z$1.ZodObject<{
+            path: z$1.ZodString;
+            type: z$1.ZodLiteral<"localImage">;
+            visibility: z$1.ZodOptional<z$1.ZodEnum<{
+                "agent-only": "agent-only";
+            }>>;
+        }, z$1.core.$strip>, z$1.ZodObject<{
+            mimeType: z$1.ZodOptional<z$1.ZodString>;
+            name: z$1.ZodOptional<z$1.ZodString>;
+            path: z$1.ZodString;
+            sizeBytes: z$1.ZodOptional<z$1.ZodNumber>;
+            type: z$1.ZodLiteral<"localFile">;
+            visibility: z$1.ZodOptional<z$1.ZodEnum<{
+                "agent-only": "agent-only";
+            }>>;
+        }, z$1.core.$strip>], "type">>;
+        createdAt: z$1.ZodNumber;
+        editable: z$1.ZodBoolean;
+        failureReason: z$1.ZodNullable<z$1.ZodString>;
+        groupWithNext: z$1.ZodBoolean;
+        id: z$1.ZodString;
+        model: z$1.ZodString;
+        payload: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+            kind: z$1.ZodLiteral<"inline">;
+        }, z$1.core.$strip>, z$1.ZodObject<{
+            attempt: z$1.ZodNumber;
+            kind: z$1.ZodLiteral<"retry">;
+            reason: z$1.ZodString;
+            retryOfTurnRequestId: z$1.ZodString;
+        }, z$1.core.$strip>], "kind">;
+        permissionMode: z$1.ZodEnum<{
+            "accept-edits": "accept-edits";
+            auto: "auto";
+            full: "full";
+        }>;
+        reasoningLevel: z$1.ZodEnum<{
+            high: "high";
+            low: "low";
+            max: "max";
+            medium: "medium";
+            none: "none";
+            ultra: "ultra";
+            ultracode: "ultracode";
+            xhigh: "xhigh";
+        }>;
+        sendAt: z$1.ZodNullable<z$1.ZodNumber>;
+        serviceTier: z$1.ZodEnum<{
+            default: "default";
+            fast: "fast";
+        }>;
+        threadId: z$1.ZodString;
+        updatedAt: z$1.ZodNumber;
+        waitingOn: z$1.ZodNullable<z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+            kind: z$1.ZodLiteral<"time">;
+        }, z$1.core.$strip>, z$1.ZodObject<{
+            kind: z$1.ZodLiteral<"thread-busy">;
+        }, z$1.core.$strip>, z$1.ZodObject<{
+            kind: z$1.ZodLiteral<"turn-starting">;
+        }, z$1.core.$strip>, z$1.ZodObject<{
+            kind: z$1.ZodLiteral<"provisioning">;
+        }, z$1.core.$strip>, z$1.ZodObject<{
+            hostName: z$1.ZodString;
+            kind: z$1.ZodLiteral<"host-offline">;
+        }, z$1.core.$strip>, z$1.ZodObject<{
+            kind: z$1.ZodLiteral<"interaction">;
+        }, z$1.core.$strip>, z$1.ZodObject<{
+            kind: z$1.ZodLiteral<"plugin">;
+            pluginId: z$1.ZodString;
+            reason: z$1.ZodString;
+        }, z$1.core.$strip>], "kind">>;
+    }, z$1.core.$strip>;
 }, z$1.core.$strip>], "delivery">;
 type SendMessageResponse = z$1.infer<typeof sendMessageResponseSchema>;
 declare const editMessageRequestSchema: z$1.ZodObject<{
@@ -10698,7 +10837,11 @@ declare const setQueuedMessageGroupBoundaryRequestSchema: z$1.ZodObject<{
     groupBoundaryQueuedMessageId: z$1.ZodString;
 }, z$1.core.$strip>;
 type SetQueuedMessageGroupBoundaryRequest = z$1.infer<typeof setQueuedMessageGroupBoundaryRequestSchema>;
-declare const sendQueuedMessageResponseSchema: z$1.ZodObject<{
+declare const sendQueuedMessageResponseSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+    delivery: z$1.ZodLiteral<"sent">;
+    ok: z$1.ZodLiteral<true>;
+}, z$1.core.$strip>, z$1.ZodObject<{
+    delivery: z$1.ZodLiteral<"queued">;
     ok: z$1.ZodLiteral<true>;
     queuedMessage: z$1.ZodObject<{
         content: z$1.ZodArray<z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
@@ -10837,7 +10980,7 @@ declare const sendQueuedMessageResponseSchema: z$1.ZodObject<{
             reason: z$1.ZodString;
         }, z$1.core.$strip>], "kind">>;
     }, z$1.core.$strip>;
-}, z$1.core.$strip>;
+}, z$1.core.$strip>], "delivery">;
 type SendQueuedMessageResponse = z$1.infer<typeof sendQueuedMessageResponseSchema>;
 declare const threadListResponseSchema: z$1.ZodArray<z$1.ZodObject<{
     activity: z$1.ZodObject<{
@@ -12487,6 +12630,14 @@ interface PluginHomepageSectionProps {
  */
 interface PluginSettingsSectionProps {
 }
+/**
+ * Props passed to an `experimental_appOverlay` component.
+ *
+ * Deliberately empty while the component reads live app state through SDK
+ * hooks; versioned additive like the other slot props.
+ */
+interface ExperimentalAppOverlayProps {
+}
 /** Props passed to a `navPanel` component (it owns its whole route). */
 interface PluginNavPanelProps {
     /**
@@ -12851,6 +13002,21 @@ interface PluginSettingsSectionRegistration {
     description?: string;
     component: ComponentType<PluginSettingsSectionProps>;
 }
+/**
+ * Render app-wide plugin UI outside BB's layout regions.
+ *
+ * The host mounts each registration once per app window through the ordinary
+ * plugin React boundary. The component therefore keeps PluginContext, router,
+ * query, realtime, and other app-level SDK contexts when it renders fixed UI
+ * or creates a React portal. BB supplies no chrome, positioning, visibility,
+ * or interaction policy; the plugin owns those details and responsive
+ * behavior. Registrations are additive and a crash hides only that overlay.
+ */
+interface ExperimentalAppOverlayRegistration {
+    /** Unique within the plugin; letters, digits, `-`, `_`. */
+    id: string;
+    component: ComponentType<ExperimentalAppOverlayProps>;
+}
 /**
  * Owner-defined validator for a fixed tab's transient target. The host first
  * verifies that the value is JSON-safe, then calls this validator before
@@ -13668,6 +13834,12 @@ interface PluginTimelineRendererRegistration {
 interface PluginAppSlots {
     homepageSection(registration: PluginHomepageSectionRegistration): void;
     settingsSection(registration: PluginSettingsSectionRegistration): void;
+    /**
+     * Render one app-wide overlay component (see
+     * {@link ExperimentalAppOverlayRegistration}). Experimental: see
+     * docs/api_to_audit.md.
+     */
+    experimental_appOverlay(registration: ExperimentalAppOverlayRegistration): void;
     navPanel(registration: PluginNavPanelRegistration): void;
     /**
      * Add an action to an existing thread's panel launcher. This slot is
@@ -13807,7 +13979,7 @@ interface PluginSettingsState {
      * Effective non-secret setting values (secret settings are excluded —
      * read them server-side). Undefined while loading or unavailable.
      */
-    values: Record<string, string | boolean> | undefined;
+    values: Record<string, string | number | boolean> | undefined;
     isLoading: boolean;
 }
 /** State of the app's shared realtime connection to the bb server. */
@@ -14598,10 +14770,6 @@ interface EnvironmentDiffBranchesArgs extends EnvironmentDiffBranchesQuery {
 interface EnvironmentCommitArgs {
     environmentId: string;
 }
-interface EnvironmentSquashMergeArgs {
-    environmentId: string;
-    mergeBaseBranch: string;
-}
 interface EnvironmentPullRequestMergeArgs {
     environmentId: string;
     method: PullRequestMergeMethod;
@@ -14627,7 +14795,6 @@ type EnvironmentMarkPullRequestReadyResult = PullRequestReadyActionResponse;
 type EnvironmentMergePullRequestResult = PullRequestMergeActionResponse;
 type EnvironmentPathsResult = WorkspacePathListResponse;
 type EnvironmentPullRequestResult = EnvironmentPullRequestResponse;
-type EnvironmentSquashMergeResult = SquashMergeActionResponse;
 type EnvironmentStatusResult = EnvironmentStatusResponse;
 type EnvironmentUpdateResult = Environment;
 interface EnvironmentsArea {
@@ -14644,7 +14811,6 @@ interface EnvironmentsArea {
     markPullRequestReady(args: EnvironmentActionArgs): Promise<EnvironmentMarkPullRequestReadyResult>;
     mergePullRequest(args: EnvironmentPullRequestMergeArgs): Promise<EnvironmentMergePullRequestResult>;
     paths(args: EnvironmentPathsArgs): Promise<EnvironmentPathsResult>;
-    squashMerge(args: EnvironmentSquashMergeArgs): Promise<EnvironmentSquashMergeResult>;
     status(args: EnvironmentStatusArgs): Promise<EnvironmentStatusResult>;
     update(args: EnvironmentUpdateArgs): Promise<EnvironmentUpdateResult>;
 }
@@ -15057,7 +15223,7 @@ type PluginGetSourceResult = PluginSourceDetail;
 type PluginCheckUpdatesResult = PluginUpdateCheckEntry[];
 type PluginApplyUpdateResult = PluginApplyUpdateResult$1;
 type PluginCatalogStatusResult = PluginCatalogStatus;
-type PluginCatalogSearchResult = PluginCatalogSearchResult$1[];
+type PluginCatalogSearchResult = PluginCatalogSearchResponse;
 type PluginCatalogInstallPlanResult = PluginCatalogInstallPlan;
 type PluginMarketplaceListResult = PluginMarketplace[];
 type PluginMarketplaceAddResult = PluginMarketplace;
@@ -16004,6 +16170,12 @@ type PluginSettingDescriptor = {
     /** Synchronously validate without transforming a proposed value. */
     experimental_schema?: StandardSchemaV1<boolean, boolean>;
     default?: boolean;
+} | {
+    type: "number";
+    label: string;
+    description?: string;
+    experimental_schema?: StandardSchemaV1<number, number>;
+    default?: number;
 } | {
     type: "select";
     label: string;
@@ -16021,16 +16193,18 @@ type PluginSettingDescriptor = {
     default?: string;
 };
 type PluginSettingDescriptors = Record<string, PluginSettingDescriptor>;
-type PluginSettingValue = string | boolean;
+type PluginSettingValue = string | number | boolean;
 /** `default` present → non-optional value; absent → `T | undefined`. */
 type PluginSettingsValues<Ds extends Record<string, PluginSettingDescriptor>> = {
     [K in keyof Ds]: Ds[K] extends {
-        default: string | boolean;
+        default: string | number | boolean;
     } ? PluginSettingValueOf<Ds[K]> : PluginSettingValueOf<Ds[K]> | undefined;
 };
 type PluginSettingValueOf<D extends PluginSettingDescriptor> = D extends {
     type: "boolean";
-} ? boolean : string;
+} ? boolean : D extends {
+    type: "number";
+} ? number : string;
 interface PluginSettingsHandle<Ds extends Record<string, PluginSettingDescriptor>> {
     /** Load-safe: callable inside the factory. */
     get(): Promise<PluginSettingsValues<Ds>>;
@@ -16161,6 +16335,11 @@ interface PluginThreadEventPayloads {
     "thread.deleted": {
         thread: ThreadResponse;
     };
+    /** Fired after a pending interaction row is committed. */
+    "interaction.pending": {
+        thread: ThreadResponse;
+        interaction: PendingInteraction;
+    };
     /**
      * Fired after a dispatch attempt is queued as a row — by a `message.dispatch`
      * hook's `wait` decision, by a `sendAt` in the future, or by a core wait (the
@@ -17187,6 +17366,11 @@ interface PluginEvents {
     on<E extends PluginThreadEventName>(event: E, handler: PluginThreadEventHandler<E>): void;
 }
 interface PluginServerApi {
+    /**
+     * The operator-configured public app URL from `BB_APP_URL`, or `null` when
+     * the operator has not configured one. This value is not bind-gated.
+     */
+    readonly experimental_appUrl: string | null;
     /**
      * This BB server's own loopback base URL (e.g. "http://127.0.0.1:38886"),
      * which serves the SPA + /api + /ws. For plugins that proxy or relay
@@ -17351,4 +17535,4 @@ interface BbPluginApi {
 }
 
 export { PLUGIN_CLI_OUTPUT_MAX_BYTES, defineRpcContract, experimental_defineHostEntry };
-export type { BbContext, BbNavigate, BbPluginApi, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSubmitOptions, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalHostCallOptions, ExperimentalHostClient, ExperimentalHostEntry, ExperimentalHostPaths, ExperimentalHostRpcContext, ExperimentalHostRpcHandlers, ExperimentalHostSignalContract, ExperimentalHostSignalEvent, ExperimentalHostSignals, ExperimentalHostWatchChange, ExperimentalHostWatchChangeType, ExperimentalHostWatchEvent, ExperimentalHostWatchListener, ExperimentalHostWatchOptions, ExperimentalHostWatchSubscription, ExperimentalHostWorkerLease, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginFixedTabReference, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, JsonValue, MarkdownProps, MessageDispatchHookContext, MessageDispatchHookDecision, NewThreadComposerProps, NewThreadRequest, PluginAgentConfiguration, PluginAgentConfigurationContext, PluginAgentToolContentPart, PluginAgentToolContext, PluginAgentToolLabels, PluginAgentToolPresentation, PluginAgentToolRegistrationBase, PluginAgentToolResult, PluginAgentToolSelection, PluginAgents, PluginAiServiceDeclaration, PluginAiServiceKind, PluginAiServices, PluginAppBuilder, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginBackground, PluginCli, PluginCliCommandInfo, PluginCliContext, PluginCliExecutionResult, PluginCliOutputLimitError, PluginCliRegistration, PluginCliResult, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandPaletteActionContext, PluginCommandPaletteActionRegistration, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginDispatchAttemptKind, PluginDispatchExecution, PluginDispatchExecutionSources, PluginDispatchInput, PluginEvents, PluginFileOpenerProps, PluginFileOpenerRegistration, PluginFileOpenerSource, PluginFixedTabDeclaration, PluginFixedTabRegistration, PluginHomepageSectionProps, PluginHomepageSectionRegistration, PluginHookHandler, PluginHookName, PluginHookSignatures, PluginHooks, PluginHosts, PluginHttp, PluginHttpAuthMode, PluginHttpHandler, PluginInteractionCancelReason, PluginInteractionRequest, PluginInteractionResult, PluginKvStorage, PluginLogger, PluginMentionItem, PluginMentionProviderRegistration, PluginMentionSearchContext, PluginMentionTrigger, PluginMessageActionContext, PluginMessageActionRegistration, PluginMessageDirectiveMessage, PluginMessageDirectiveOpenWorkspaceFile, PluginMessageDirectiveProps, PluginMessageDirectiveRegistration, PluginNavPanelProps, PluginNavPanelRegistration, PluginNewThreadPanelActionContext, PluginNewThreadPanelActionRegistration, PluginNewThreadPanelProps, PluginPanelActionOpenOptions, PluginPendingInteractionProps, PluginPendingInteractionRegistration, PluginPendingInteractionView, PluginProviderCapabilities, PluginProviderComposerAction, PluginProviderDeclaration, PluginProviderExtensionKindDeclaration, PluginProviderFallbackModel, PluginProviderIconRegistration, PluginProviderMaintenance, PluginProviderModelCatalogScope, PluginProviderNativeRootEntry, PluginProviderNativeRoots, PluginProviderOptionDescriptor, PluginProviderOptionsContext, PluginProviderPermissionMode, PluginProviderReasoningLevel, PluginProviderStrings, PluginProviders, PluginProvidersState, PluginRealtime, PluginRealtimeConnectionState, PluginRpc, PluginRpcCallArgs, PluginRpcClient, PluginRpcContract, PluginRpcError, PluginRpcErrorCode, PluginRpcHandlers, PluginRpcIssuePathSegment, PluginRpcMethodContract, PluginRpcResult, PluginRpcValidationIssue, PluginSdkApp, PluginServerApi, PluginSettingDescriptor, PluginSettingDescriptors, PluginSettingValue, PluginSettings, PluginSettingsHandle, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsState, PluginSettingsValues, PluginSharedPortTunnelIdentity, PluginSidebarFooterActionContext, PluginSidebarFooterActionProps, PluginSidebarFooterActionRegistration, PluginSidebarProject, PluginSidebarPullRequest, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSidebarWorkspaceKind, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginStatusApi, PluginStorage, PluginTargetedPanelActionOpenOptions, PluginThreadEventHandler, PluginThreadEventName, PluginThreadEventPayloads, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, PluginTurnFailedEvent, PluginUi, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps };
+export type { BbContext, BbNavigate, BbPluginApi, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSubmitOptions, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalHostCallOptions, ExperimentalHostClient, ExperimentalHostEntry, ExperimentalHostPaths, ExperimentalHostRpcContext, ExperimentalHostRpcHandlers, ExperimentalHostSignalContract, ExperimentalHostSignalEvent, ExperimentalHostSignals, ExperimentalHostWatchChange, ExperimentalHostWatchChangeType, ExperimentalHostWatchEvent, ExperimentalHostWatchListener, ExperimentalHostWatchOptions, ExperimentalHostWatchSubscription, ExperimentalHostWorkerLease, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginFixedTabReference, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, JsonValue, MarkdownProps, MessageDispatchHookContext, MessageDispatchHookDecision, NewThreadComposerProps, NewThreadRequest, PluginAgentConfiguration, PluginAgentConfigurationContext, PluginAgentToolContentPart, PluginAgentToolContext, PluginAgentToolLabels, PluginAgentToolPresentation, PluginAgentToolRegistrationBase, PluginAgentToolResult, PluginAgentToolSelection, PluginAgents, PluginAiServiceDeclaration, PluginAiServiceKind, PluginAiServices, PluginAppBuilder, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginBackground, PluginCli, PluginCliCommandInfo, PluginCliContext, PluginCliExecutionResult, PluginCliOutputLimitError, PluginCliRegistration, PluginCliResult, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandPaletteActionContext, PluginCommandPaletteActionRegistration, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginDispatchAttemptKind, PluginDispatchExecution, PluginDispatchExecutionSources, PluginDispatchInput, PluginEvents, PluginFileOpenerProps, PluginFileOpenerRegistration, PluginFileOpenerSource, PluginFixedTabDeclaration, PluginFixedTabRegistration, PluginHomepageSectionProps, PluginHomepageSectionRegistration, PluginHookHandler, PluginHookName, PluginHookSignatures, PluginHooks, PluginHosts, PluginHttp, PluginHttpAuthMode, PluginHttpHandler, PluginInteractionCancelReason, PluginInteractionRequest, PluginInteractionResult, PluginKvStorage, PluginLogger, PluginMentionItem, PluginMentionProviderRegistration, PluginMentionSearchContext, PluginMentionTrigger, PluginMessageActionContext, PluginMessageActionRegistration, PluginMessageDirectiveMessage, PluginMessageDirectiveOpenWorkspaceFile, PluginMessageDirectiveProps, PluginMessageDirectiveRegistration, PluginNavPanelProps, PluginNavPanelRegistration, PluginNewThreadPanelActionContext, PluginNewThreadPanelActionRegistration, PluginNewThreadPanelProps, PluginPanelActionOpenOptions, PluginPendingInteractionProps, PluginPendingInteractionRegistration, PluginPendingInteractionView, PluginProviderCapabilities, PluginProviderComposerAction, PluginProviderDeclaration, PluginProviderExtensionKindDeclaration, PluginProviderFallbackModel, PluginProviderIconRegistration, PluginProviderMaintenance, PluginProviderModelCatalogScope, PluginProviderNativeRootEntry, PluginProviderNativeRoots, PluginProviderOptionDescriptor, PluginProviderOptionsContext, PluginProviderPermissionMode, PluginProviderReasoningLevel, PluginProviderStrings, PluginProviders, PluginProvidersState, PluginRealtime, PluginRealtimeConnectionState, PluginRpc, PluginRpcCallArgs, PluginRpcClient, PluginRpcContract, PluginRpcError, PluginRpcErrorCode, PluginRpcHandlers, PluginRpcIssuePathSegment, PluginRpcMethodContract, PluginRpcResult, PluginRpcValidationIssue, PluginSdkApp, PluginServerApi, PluginSettingDescriptor, PluginSettingDescriptors, PluginSettingValue, PluginSettings, PluginSettingsHandle, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsState, PluginSettingsValues, PluginSharedPortTunnelIdentity, PluginSidebarFooterActionContext, PluginSidebarFooterActionProps, PluginSidebarFooterActionRegistration, PluginSidebarProject, PluginSidebarPullRequest, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSidebarWorkspaceKind, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginStatusApi, PluginStorage, PluginTargetedPanelActionOpenOptions, PluginThreadEventHandler, PluginThreadEventName, PluginThreadEventPayloads, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, PluginTurnFailedEvent, PluginUi, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps };

package/dist/internal/host-policy.js

@@ -276,7 +276,7 @@ var PLUGIN_HTTP_METHODS = /* @__PURE__ */ new Set([
   "HEAD",
   "OPTIONS"
 ]);
-var RPC_METHOD_PATTERN = /^[a-zA-Z0-9_-]+$/;
+var RPC_METHOD_PATTERN = /^[a-zA-Z0-9_-]+(?:\.[a-zA-Z0-9_-]+)*$/;
 var BACKGROUND_NAME_PATTERN = /^[a-zA-Z0-9_-]+$/;
 var CLI_COMMAND_NAME_PATTERN = /^[a-z0-9-]+$/;
 var AGENT_TOOL_NAME_PATTERN = /^[a-zA-Z0-9_-]+$/;
@@ -299,6 +299,9 @@ var stringSettingSchemaSchema = z3.custom(
 var booleanSettingSchemaSchema = z3.custom(
   (value) => isStandardSchema(value)
 );
+var numberSettingSchemaSchema = z3.custom(
+  (value) => isStandardSchema(value)
+);
 var settingDescriptorSchema = z3.discriminatedUnion("type", [
   z3.object({
     type: z3.literal("string"),
@@ -320,6 +323,12 @@ var settingDescriptorSchema = z3.discriminatedUnion("type", [
     experimental_schema: booleanSettingSchemaSchema.optional(),
     default: z3.boolean().optional()
   }).strict(),
+  z3.object({
+    type: z3.literal("number"),
+    ...settingsBaseFields,
+    experimental_schema: numberSettingSchemaSchema.optional(),
+    default: z3.number().finite().optional()
+  }).strict(),
   z3.object({
     type: z3.literal("select"),
     ...settingsBaseFields,
@@ -416,6 +425,21 @@ function validateSettingsUpdate(descriptors, values) {
       }
       continue;
     }
+    if (descriptor.type === "number") {
+      if (typeof value !== "number" || !Number.isFinite(value)) {
+        errors.push(`setting "${key}" expects a finite number`);
+        continue;
+      }
+      const validationError2 = settingSchemaError(
+        key,
+        descriptor.experimental_schema,
+        value
+      );
+      if (validationError2 !== null) {
+        errors.push(validationError2);
+      }
+      continue;
+    }
     if (typeof value !== "string") {
       errors.push(`setting "${key}" expects a string`);
       continue;

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

@@ -246,6 +246,7 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
   const collected = {
     homepageSections: [],
     settingsSections: [],
+    appOverlays: [],
     navPanels: [],
     threadPanelActions: [],
     newThreadPanelActions: [],
@@ -268,6 +269,7 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
   const seenIds = {
     homepageSection: /* @__PURE__ */ new Set(),
     settingsSection: /* @__PURE__ */ new Set(),
+    appOverlay: /* @__PURE__ */ new Set(),
     navPanel: /* @__PURE__ */ new Set(),
     threadPanelAction: /* @__PURE__ */ new Set(),
     newThreadPanelAction: /* @__PURE__ */ new Set(),
@@ -316,6 +318,15 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
           component: requireComponent(kind, registration.component)
         });
       },
+      experimental_appOverlay(registration) {
+        const kind = "slots.experimental_appOverlay";
+        const id = requireSlotId(kind, registration?.id);
+        requireUniqueId(kind, seenIds.appOverlay, id);
+        collected.appOverlays.push({
+          id,
+          component: requireComponent(kind, registration.component)
+        });
+      },
       navPanel(registration) {
         const kind = "slots.navPanel";
         const id = requireSlotId(kind, registration?.id);

package/dist/provider-bridge-acp.js

@@ -4189,6 +4189,11 @@ var acpCompactionCompletedNotificationParamsSchema = z34.discriminatedUnion("sta
     threadId: z34.string().min(1),
     status: z34.literal("interrupted")
   }).passthrough(),
+  z34.object({
+    threadId: z34.string().min(1),
+    status: z34.literal("skipped"),
+    detail: z34.string().min(1)
+  }).passthrough(),
   z34.object({
     threadId: z34.string().min(1),
     status: z34.literal("failed"),
@@ -4820,6 +4825,18 @@ function ompCommandResult(event) {
     ...output.length === 0 ? {} : { output }
   };
 }
+var OMP_COMPACTION_FAILURE_PATTERN = /\bcompaction failed\b/i;
+var OMP_COMPACTION_NOOP_PATTERN = /\b(?:nothing to compact|already compacted)\b/i;
+function compactionOutcomeForEndTurn(dialect, agentMessage) {
+  if (dialect.id !== "omp") {
+    return { status: "completed" };
+  }
+  const text = agentMessage.trim();
+  if (!OMP_COMPACTION_FAILURE_PATTERN.test(text)) {
+    return { status: "completed" };
+  }
+  return OMP_COMPACTION_NOOP_PATTERN.test(text) ? { status: "skipped", detail: text } : { status: "failed", error: text };
+}
 var OMP_ACP_DIALECT = {
   id: "omp",
   commandResult: ompCommandResult
@@ -6022,12 +6039,22 @@ function createAcpDeltaTranslator(options = {}) {
           return [];
         }
         const status = params.data.status;
+        const turnStatus = status === "skipped" ? "completed" : status;
         return [
-          ...flushOpenTurnWork(context, status),
+          ...flushOpenTurnWork(context, itemStatusForTurnStatus(turnStatus)),
           ...status === "completed" ? [{ kind: "context.compacted" }] : [],
+          ...status === "skipped" ? [
+            {
+              kind: "provider.warning",
+              category: "compaction-skipped",
+              summary: "Context compaction skipped",
+              details: params.data.detail,
+              vouchedTurn: true
+            }
+          ] : [],
           {
             kind: "turn.boundary",
-            status,
+            status: turnStatus,
             ...status === "failed" ? { error: { message: params.data.error } } : {}
           }
         ];
@@ -6663,6 +6690,93 @@ function splitPrimaryModels(catalogModels, primaryModels) {
   };
 }
 
+// ../provider-bridge-acp/src/cursor-model-selection.ts
+var CURSOR_LEGACY_FAMILY_SELECTIONS = {
+  "claude-4-sonnet": { modelId: "claude-sonnet-4" },
+  "claude-4.5-opus": { modelId: "claude-opus-4-5" },
+  "claude-4.5-sonnet": { modelId: "claude-sonnet-4-5" },
+  "claude-4.6-opus": { modelId: "claude-opus-4-6" },
+  "claude-4.6-sonnet": { modelId: "claude-sonnet-4-6" },
+  "gemini-3.6-flash-minimal": {
+    modelId: "gemini-3.6-flash",
+    reasoningLevel: "low"
+  },
+  "gpt-5.1-codex-max": { modelId: "gpt-5.1" }
+};
+function bareCursorFamilyId(model) {
+  const familyId = model === "auto" ? "default" : agentModelFamilyId(model);
+  return familyId.startsWith("cursor-") ? familyId.slice("cursor-".length) : familyId;
+}
+function cursorParameterizedSelection(model, reasoningLevel) {
+  const familyId = bareCursorFamilyId(model);
+  const selection = CURSOR_LEGACY_FAMILY_SELECTIONS[familyId] ?? {
+    modelId: familyId
+  };
+  return selection.reasoningLevel !== void 0 || reasoningLevel === void 0 ? selection : { ...selection, reasoningLevel };
+}
+function cursorCatalogModel(model) {
+  const selection = cursorParameterizedSelection(
+    model.id,
+    model.defaultReasoningEffort
+  );
+  const efforts = /* @__PURE__ */ new Map();
+  for (const effort of model.supportedReasoningEfforts) {
+    const level = cursorParameterizedSelection(model.id, effort.reasoningEffort).reasoningLevel ?? effort.reasoningEffort;
+    if (!efforts.has(level)) {
+      efforts.set(level, { ...effort, reasoningEffort: level });
+    }
+  }
+  return {
+    model: {
+      ...model,
+      id: selection.modelId,
+      model: selection.modelId,
+      supportedReasoningEfforts: [...efforts.values()].sort(
+        (a, b) => reasoningLevelValues.indexOf(a.reasoningEffort) - reasoningLevelValues.indexOf(b.reasoningEffort)
+      ),
+      defaultReasoningEffort: selection.reasoningLevel ?? model.defaultReasoningEffort
+    },
+    directFamily: bareCursorFamilyId(model.id) === selection.modelId
+  };
+}
+function buildCursorParameterizedModelCatalog(models) {
+  const normalized = /* @__PURE__ */ new Map();
+  for (const model of models) {
+    const candidate = cursorCatalogModel(model);
+    const current = normalized.get(candidate.model.id);
+    if (current === void 0) {
+      normalized.set(candidate.model.id, candidate);
+      continue;
+    }
+    const preferred = candidate.directFamily && !current.directFamily ? candidate : current;
+    const efforts = new Map(
+      preferred.model.supportedReasoningEfforts.map((effort) => [
+        effort.reasoningEffort,
+        effort
+      ])
+    );
+    for (const effort of [
+      ...current.model.supportedReasoningEfforts,
+      ...candidate.model.supportedReasoningEfforts
+    ]) {
+      if (!efforts.has(effort.reasoningEffort)) {
+        efforts.set(effort.reasoningEffort, effort);
+      }
+    }
+    normalized.set(candidate.model.id, {
+      model: {
+        ...preferred.model,
+        supportedReasoningEfforts: [...efforts.values()].sort(
+          (a, b) => reasoningLevelValues.indexOf(a.reasoningEffort) - reasoningLevelValues.indexOf(b.reasoningEffort)
+        ),
+        isDefault: current.model.isDefault || candidate.model.isDefault
+      },
+      directFamily: preferred.directFamily
+    });
+  }
+  return [...normalized.values()].map((entry) => entry.model);
+}
+
 // ../provider-bridge-acp/src/session-params.ts
 function sanitizeAcpSkillDescription(description) {
   const sanitized = description.replace(/[\r\n]+/gu, " ").replace(/\s+/gu, " ").replace(/[<>]/gu, "").trim();
@@ -6751,26 +6865,6 @@ function buildAcpModelListParams(launchSpec, options) {
     ...launchSpec.nativeReasoning !== void 0 ? { nativeReasoning: launchSpec.nativeReasoning } : {}
   };
 }
-var CURSOR_LEGACY_FAMILY_SELECTIONS = {
-  "claude-4-sonnet": { modelId: "claude-sonnet-4" },
-  "claude-4.5-opus": { modelId: "claude-opus-4-5" },
-  "claude-4.5-sonnet": { modelId: "claude-sonnet-4-5" },
-  "claude-4.6-opus": { modelId: "claude-opus-4-6" },
-  "claude-4.6-sonnet": { modelId: "claude-sonnet-4-6" },
-  "gemini-3.6-flash-minimal": {
-    modelId: "gemini-3.6-flash",
-    reasoningLevel: "low"
-  },
-  "gpt-5.1-codex-max": { modelId: "gpt-5.1" }
-};
-function cursorParameterizedSelection(model, reasoningLevel) {
-  const familyId = model === "auto" ? "default" : agentModelFamilyId(model);
-  const bareFamilyId = familyId.startsWith("cursor-") ? familyId.slice("cursor-".length) : familyId;
-  const selection = CURSOR_LEGACY_FAMILY_SELECTIONS[bareFamilyId] ?? {
-    modelId: bareFamilyId
-  };
-  return selection.reasoningLevel !== void 0 || reasoningLevel === void 0 ? selection : { ...selection, reasoningLevel };
-}
 function buildAcpModelSelectionParam(launchSpec, options, parameterizedModelPicker, dialectId) {
   const model = options.model;
   const listCommand = buildAcpModelListCommand(launchSpec);
@@ -8636,6 +8730,7 @@ async function startAgentSession(request) {
     },
     pendingInstructions: params.instructions,
     activePromptKind: null,
+    compactionAgentMessage: "",
     queuedInputs: [],
     promptRequestPending: false,
     cancelRequested: false,
@@ -8977,6 +9072,7 @@ function runTurn(session, firstInput) {
 }
 function startCompaction(session, pending) {
   session.activePromptKind = "compaction";
+  session.compactionAgentMessage = "";
   emitForSession(session, ACP_COMPACTION_STARTED_METHOD, {
     threadId: session.bbThreadId
   });
@@ -8994,7 +9090,10 @@ function startCompaction(session, pending) {
   acceptTurnInput(session, pending);
   session.turnSettled = promptResult.then((result) => {
     finish(
-      result.stopReason === "end_turn" ? { status: "completed" } : result.stopReason === "cancelled" ? { status: "interrupted" } : {
+      result.stopReason === "end_turn" ? compactionOutcomeForEndTurn(
+        session.dialect,
+        session.compactionAgentMessage
+      ) : result.stopReason === "cancelled" ? { status: "interrupted" } : {
         status: "failed",
         error: `Agent stopped compaction: ${result.stopReason}`
       }
@@ -9080,6 +9179,14 @@ function handleAgentNotification(session, method, params) {
   if (parsed.data.sessionId !== session.providerThreadId) {
     return;
   }
+  if (session.activePromptKind === "compaction") {
+    const chunk = acpAgentMessageChunkUpdateSchema.safeParse(
+      parsed.data.update
+    );
+    if (chunk.success) {
+      session.compactionAgentMessage += extractAcpContentText(chunk.data.content) ?? "";
+    }
+  }
   emitForSession(session, ACP_UPDATE_METHOD, update);
 }
 function decodeAcpBridgeJsonRpcRequest(raw) {
@@ -9113,13 +9220,14 @@ function decodeAcpBridgeJsonRpcRequest(raw) {
     issues: command.error.issues.map((issue) => `${issue.path.join(".")}: ${issue.message}`).join("; ")
   };
 }
-async function handleModelList(id, params) {
+async function handleModelList(id, params, dialectId) {
   const catalog = params.listCommand ? await loadAgentModelCatalog(params.listCommand) : null;
   if (catalog) {
+    const catalogModels = params.parameterizedModelPicker && dialectId === "cursor" ? buildCursorParameterizedModelCatalog(catalog.models) : catalog.models;
     sendResult(
       id,
       splitPrimaryModels(
-        applyConfiguredReasoningToModels(catalog.models, {
+        applyConfiguredReasoningToModels(catalogModels, {
           reasoningCli: params.reasoningCli,
           nativeReasoning: params.nativeReasoning
         }),
@@ -9221,7 +9329,8 @@ async function handleRequest2(request) {
         buildAcpModelListParams(
           decodeLaunchSpec(request.params.providerOptions),
           modelPicker
-        )
+        ),
+        decodeDialectId(request.params.providerOptions)
       );
       return;
     }

package/dist/testing/app.js

@@ -425,6 +425,7 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
   const collected = {
     homepageSections: [],
     settingsSections: [],
+    appOverlays: [],
     navPanels: [],
     threadPanelActions: [],
     newThreadPanelActions: [],
@@ -447,6 +448,7 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
   const seenIds = {
     homepageSection: /* @__PURE__ */ new Set(),
     settingsSection: /* @__PURE__ */ new Set(),
+    appOverlay: /* @__PURE__ */ new Set(),
     navPanel: /* @__PURE__ */ new Set(),
     threadPanelAction: /* @__PURE__ */ new Set(),
     newThreadPanelAction: /* @__PURE__ */ new Set(),
@@ -495,6 +497,15 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
           component: requireComponent(kind, registration.component)
         });
       },
+      experimental_appOverlay(registration) {
+        const kind = "slots.experimental_appOverlay";
+        const id = requireSlotId(kind, registration?.id);
+        requireUniqueId(kind, seenIds.appOverlay, id);
+        collected.appOverlays.push({
+          id,
+          component: requireComponent(kind, registration.component)
+        });
+      },
       navPanel(registration) {
         const kind = "slots.navPanel";
         const id = requireSlotId(kind, registration?.id);

package/dist/testing/index.js

@@ -289,7 +289,7 @@ var PLUGIN_HTTP_METHODS = /* @__PURE__ */ new Set([
   "HEAD",
   "OPTIONS"
 ]);
-var RPC_METHOD_PATTERN = /^[a-zA-Z0-9_-]+$/;
+var RPC_METHOD_PATTERN = /^[a-zA-Z0-9_-]+(?:\.[a-zA-Z0-9_-]+)*$/;
 var BACKGROUND_NAME_PATTERN = /^[a-zA-Z0-9_-]+$/;
 var CLI_COMMAND_NAME_PATTERN = /^[a-z0-9-]+$/;
 var AGENT_TOOL_NAME_PATTERN = /^[a-zA-Z0-9_-]+$/;
@@ -312,6 +312,9 @@ var stringSettingSchemaSchema = z3.custom(
 var booleanSettingSchemaSchema = z3.custom(
   (value) => isStandardSchema(value)
 );
+var numberSettingSchemaSchema = z3.custom(
+  (value) => isStandardSchema(value)
+);
 var settingDescriptorSchema = z3.discriminatedUnion("type", [
   z3.object({
     type: z3.literal("string"),
@@ -333,6 +336,12 @@ var settingDescriptorSchema = z3.discriminatedUnion("type", [
     experimental_schema: booleanSettingSchemaSchema.optional(),
     default: z3.boolean().optional()
   }).strict(),
+  z3.object({
+    type: z3.literal("number"),
+    ...settingsBaseFields,
+    experimental_schema: numberSettingSchemaSchema.optional(),
+    default: z3.number().finite().optional()
+  }).strict(),
   z3.object({
     type: z3.literal("select"),
     ...settingsBaseFields,
@@ -429,6 +438,21 @@ function validateSettingsUpdate(descriptors, values) {
       }
       continue;
     }
+    if (descriptor.type === "number") {
+      if (typeof value !== "number" || !Number.isFinite(value)) {
+        errors.push(`setting "${key}" expects a finite number`);
+        continue;
+      }
+      const validationError2 = settingSchemaError(
+        key,
+        descriptor.experimental_schema,
+        value
+      );
+      if (validationError2 !== null) {
+        errors.push(validationError2);
+      }
+      continue;
+    }
     if (typeof value !== "string") {
       errors.push(`setting "${key}" expects a string`);
       continue;
@@ -1766,7 +1790,14 @@ function readSettingsValues(descriptors, stored) {
   const values = {};
   for (const [key, descriptor] of Object.entries(descriptors)) {
     let value = stored.get(key);
-    const expected = descriptor.type === "boolean" ? "boolean" : "string";
+    if (descriptor.type === "number" && typeof value === "string") {
+      const legacyNumber = Number(value.trim());
+      value = value.trim().length > 0 && Number.isFinite(legacyNumber) ? legacyNumber : void 0;
+    }
+    if (descriptor.type === "number" && typeof value === "number" && !Number.isFinite(value)) {
+      value = void 0;
+    }
+    const expected = descriptor.type === "boolean" ? "boolean" : descriptor.type === "number" ? "number" : "string";
     if (typeof value !== expected) value = void 0;
     if (descriptor.type === "select" && typeof value === "string" && !descriptor.options.includes(value)) {
       value = void 0;
@@ -2143,9 +2174,7 @@ function createFakePluginHostInternal(options, sharedState) {
           "ALTER TABLE _bb_migrations ADD COLUMN statement_hash TEXT"
         );
       }
-      const rows = database.prepare(
-        "SELECT id, statement_hash FROM _bb_migrations ORDER BY id"
-      ).all();
+      const rows = database.prepare("SELECT id, statement_hash FROM _bb_migrations ORDER BY id").all();
       const applied = /* @__PURE__ */ new Map();
       for (const row of rows) applied.set(row.id, row.statement_hash);
       const statementHashes = statements.map(migrationStatementHash);
@@ -2190,7 +2219,7 @@ function createFakePluginHostInternal(options, sharedState) {
     const prev = readSettingsValues(settingsDescriptors, storedSettings);
     for (const [key, value] of Object.entries(values)) {
       if (value === null) storedSettings.delete(key);
-      else if (typeof value === "string" || typeof value === "boolean") {
+      else if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
         storedSettings.set(key, value);
       } else {
         throw new Error(`setting "${key}" has an unsupported value`);
@@ -2302,7 +2331,7 @@ function createFakePluginHostInternal(options, sharedState) {
       for (const [name, contractValue] of contractEntries) {
         if (!RPC_METHOD_PATTERN.test(name)) {
           throw new Error(
-            `invalid rpc method name "${name}" \u2014 use letters, digits, "-" and "_"`
+            `invalid rpc method name "${name}" \u2014 use dot-separated segments with letters, digits, "-" and "_"`
           );
         }
         const methodContract = readRpcMethodContract(name, contractValue);
@@ -2652,9 +2681,14 @@ function createFakePluginHostInternal(options, sharedState) {
       );
     }
   };
+  const appUrl = options.appUrl ?? null;
   const loopbackBaseUrl = options.loopbackBaseUrl ?? "http://127.0.0.1:38886";
   const dataDir = options.dataDir ?? "/tmp/bb-fake-data-dir";
   const server = {
+    get experimental_appUrl() {
+      assertLive();
+      return appUrl;
+    },
     get loopbackBaseUrl() {
       assertLive();
       return loopbackBaseUrl;
@@ -2675,6 +2709,7 @@ function createFakePluginHostInternal(options, sharedState) {
     "thread.failed": [],
     "thread.archived": [],
     "thread.deleted": [],
+    "interaction.pending": [],
     "message.queued": [],
     "message.dispatched": [],
     "turn.failed": []
@@ -3014,6 +3049,7 @@ function createFakePluginHostInternal(options, sharedState) {
           "thread.failed": threadEventHandlers["thread.failed"].length,
           "thread.archived": threadEventHandlers["thread.archived"].length,
           "thread.deleted": threadEventHandlers["thread.deleted"].length,
+          "interaction.pending": threadEventHandlers["interaction.pending"].length,
           "message.queued": threadEventHandlers["message.queued"].length,
           "message.dispatched": threadEventHandlers["message.dispatched"].length,
           "turn.failed": threadEventHandlers["turn.failed"].length

package/package.json

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