@get-bb/plugin-sdk 0.4.87 → 0.4.94

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

@@ -52,6 +52,14 @@ interface StandardSchemaV1<Input = unknown, Output = Input> {
         readonly version: 1;
         readonly vendor: string;
         readonly validate: (value: unknown) => StandardSchemaV1Result<Output> | Promise<StandardSchemaV1Result<Output>>;
+        readonly jsonSchema?: {
+            readonly input: (options: {
+                target: string;
+            }) => Record<string, unknown>;
+            readonly output: (options: {
+                target: string;
+            }) => Record<string, unknown>;
+        };
         readonly types?: {
             readonly input: Input;
             readonly output: Output;
@@ -73,6 +81,7 @@ interface StandardSchemaV1Issue {
 type StandardSchemaV1InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["input"];
 type StandardSchemaV1InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["output"];
 interface PluginRpcMethodContract<InputSchema extends StandardSchemaV1 = StandardSchemaV1, OutputSchema extends StandardSchemaV1 = StandardSchemaV1> {
+    readonly experimental_description?: string;
     readonly input: InputSchema;
     readonly output: OutputSchema;
 }
@@ -566,6 +575,16 @@ interface PluginThreadHeaderActionProps {
      */
     isCompactViewport: boolean;
 }
+interface ExperimentalPluginBrowserToolbarActionProps {
+    /** Thread that owns the Browser tab. */
+    threadId: string;
+    /** Browser tab currently rendering the action. */
+    tabId: string;
+    /** Current top-level URL shown in the address bar. */
+    url: string;
+    /** True when the Browser chrome needs compact controls. */
+    isCompactViewport: boolean;
+}
 /**
  * Where a file being opened by a `fileOpener` lives. `path` semantics follow
  * the source: workspace paths are relative to the environment's worktree,
@@ -1289,6 +1308,14 @@ interface PluginThreadHeaderActionRegistration {
     title: string;
     component: ComponentType<PluginThreadHeaderActionProps>;
 }
+interface ExperimentalPluginBrowserToolbarActionRegistration {
+    /** Unique within the plugin; letters, digits, `-`, `_`. */
+    id: string;
+    /** Accessible name for the host-wrapped control group. */
+    title: string;
+    /** Component rendered beside the Browser address bar. */
+    component: ComponentType<ExperimentalPluginBrowserToolbarActionProps>;
+}
 /** One pane's place in the split layout, as fractions of the split area. */
 interface PluginSidebarSplitPane {
     paneId: string;
@@ -1501,8 +1528,8 @@ interface PluginMessageActionRegistration {
      */
     run(context: PluginMessageActionContext): void | Promise<void>;
 }
-/** Context handed to a `commandPaletteAction`'s `isAvailable` and `run`. */
-interface PluginCommandPaletteActionContext {
+/** Current context for palette and keyboard command invocations. */
+interface PluginCommandContext {
     /** The thread in view, or null on a surface without one. */
     threadId: string | null;
     projectId: string | null;
@@ -1518,27 +1545,49 @@ interface PluginCommandPaletteActionContext {
      */
     openPanel(options: PluginTargetedPanelActionOpenOptions): boolean;
 }
+/** A default keyboard shortcut. Omitted modifiers are false. */
+interface PluginCommandShortcut {
+    key: string;
+    /** Command on macOS, Control elsewhere. */
+    mod?: boolean;
+    meta?: boolean;
+    control?: boolean;
+    alt?: boolean;
+    shift?: boolean;
+}
 /**
- * A row in bb's quick palette (Mod+Shift+P), listed under the plugin's name
+ * A command registered with `app.commands.register`, listed in bb's quick
+ * palette (Mod+Shift+P) under the plugin's name
  * beside bb's own commands. Host-rendered: the plugin supplies a title and
  * `run`, and the host owns matching, ordering, and recency.
  */
-interface PluginCommandPaletteActionRegistration {
+interface PluginCommandRegistration {
+    /** Initial keyboard binding. Users can rebind every command, including ones without a default. Conflicting defaults remain unbound. */
+    defaultShortcut?: PluginCommandShortcut;
     /** Unique within the plugin; letters, digits, `-`, `_`. */
     id: string;
     /** The row's label, e.g. "Linear: open issue for this thread". */
     title: string;
     /**
      * Hide the row when it cannot do anything — typically when it needs a thread
-     * and there is none. Called while the palette is open; keep it cheap and
-     * synchronous. Omitted means always listed.
+     * and there is none. Called before palette listing and keyboard invocation;
+     * keep it cheap and synchronous. Omitted means always listed.
      */
-    isAvailable?(context: PluginCommandPaletteActionContext): boolean;
+    isAvailable?(context: PluginCommandContext): boolean;
     /**
-     * Runs after the palette closes and focus is restored. Errors (sync or
-     * async) are contained and logged; they never break the palette.
+     * Runs on keyboard invocation, or after the palette closes and focus is
+     * restored. Errors (sync or async) are contained and logged; they never break the palette.
      */
-    run(context: PluginCommandPaletteActionContext): void | Promise<void>;
+    run(context: PluginCommandContext): void | Promise<void>;
+}
+/** @deprecated Use PluginCommandContext. */
+type PluginCommandPaletteActionContext = PluginCommandContext;
+/** @deprecated Use PluginCommandRegistration. */
+type PluginCommandPaletteActionRegistration = PluginCommandRegistration;
+/** Registers commands for bb's command palette. */
+interface PluginAppCommands {
+    /** Register a command. IDs are unique within this plugin, including legacy slot registrations. */
+    register(registration: PluginCommandRegistration): void;
 }
 /**
  * Supply an inline React mark for a provider. Agent, machine, and environment
@@ -1769,6 +1818,8 @@ interface PluginAppSlots {
      * docs/api_to_audit.md.
      */
     experimental_threadHeaderAction(registration: PluginThreadHeaderActionRegistration): void;
+    /** Render a component beside each Browser tab's address bar. */
+    experimental_browserToolbarAction(registration: ExperimentalPluginBrowserToolbarActionRegistration): void;
     fileOpener(registration: PluginFileOpenerRegistration): void;
     /**
      * Replace BB's source-code renderer (see
@@ -1785,10 +1836,10 @@ interface PluginAppSlots {
     messageDirective(registration: PluginMessageDirectiveRegistration): void;
     messageAction(registration: PluginMessageActionRegistration): void;
     /**
-     * Add a row to the quick palette (see
-     * {@link PluginCommandPaletteActionRegistration}).
+     * @deprecated Use `app.commands.register` with the same registration.
+     * Both entry points share the same command registry and ID namespace.
      */
-    commandPaletteAction(registration: PluginCommandPaletteActionRegistration): void;
+    commandPaletteAction(registration: PluginCommandRegistration): void;
     /**
      * Draw one agent, environment, or machine provider's icon with an inline
      * React component instead of its masked logo asset (see
@@ -1920,6 +1971,7 @@ interface ExperimentalAppIcons {
 }
 interface PluginAppBuilder {
     experimental_icons: ExperimentalAppIcons;
+    commands: PluginAppCommands;
     slots: PluginAppSlots;
     composer: PluginAppComposer;
     contentScripts: PluginAppContentScripts;
@@ -2126,7 +2178,7 @@ interface PluginComposerApi {
     focus(): void;
     /**
      * Submit this composer's draft through the composer's OWN submit pipeline,
-     * queued until `sendAt` instead of dispatched now.
+     * optionally scheduling it or attaching plugin-owned dispatch data.
      *
      * This is a real submission, not a plugin-issued send: the host builds the
      * request exactly as pressing Enter would, so the draft's attachments and
@@ -2136,12 +2188,11 @@ interface PluginComposerApi {
      * tuple itself, which is why sending from the backend instead would silently
      * run the message with different settings than the ones in front of the user.
      *
-     * In a thread composer the message is queued as a row instead of being
-     * sent or queued for the next idle moment. In the new-thread composer the
-     * thread is created `pending` and its first message becomes the queued row.
-     * Either way the resulting row is core's: the queued card above the
-     * composer, the countdown, Send now and Delete all work with no further
-     * plugin involvement.
+     * `sendAt` queues the submission until that time. `experimental_data` is
+     * opaque JSON delivered to dispatch hooks together with the calling plugin's
+     * id on this initial attempt. Hooks run before operational core waits. If a
+     * hook queues the message, its existing plugin wait identifies the owner on
+     * later attempts; core does not persist or interpret the opaque data.
      *
      * Resolves once the host has accepted the submission and cleared the draft.
      * Rejects when the composer refused to submit — a scope with no submit
@@ -2158,18 +2209,17 @@ interface PluginComposerApi {
 /**
  * What `experimental_submit` does differently from pressing Enter.
  *
- * There is deliberately no zero-argument overload and no "submit now" arm: a
- * plugin that wants a draft sent immediately is asking for the affordance the
- * user already has, and handing plugins an unconditional "send this draft"
- * button is a much larger surface than scheduling needs.
+ * `experimental_data` is opaque JSON delivered to dispatch hooks. The runtime
+ * associates it with the calling plugin automatically for the initial
+ * dispatch attempt.
  */
-interface ExperimentalComposerSubmitOptions {
-    /**
-     * Epoch ms the submission should dispatch at. Must be in the future; the
-     * host does not second-guess how far ahead it is.
-     */
+type ExperimentalComposerSubmitOptions = {
     sendAt: number;
-}
+    experimental_data?: JsonValue$1;
+} | {
+    experimental_data: JsonValue$1;
+    sendAt?: never;
+};
 /**
  * A consumer-supplied action on the messages of one `ThreadChat` instance,
  * rendered in the embedded timeline's per-message action bar alongside the
@@ -2829,4 +2879,4 @@ declare const experimental_useProviders: () => PluginProvidersState;
 declare const experimental_useCodeTheme: () => PluginCodeThemeState;
 
 export { Markdown, ThreadChat, UrlLink, definePluginApp, experimental_BranchPicker, experimental_Diff, experimental_FileLink, experimental_Icon, experimental_NewThreadComposer, experimental_PermissionModePicker, experimental_ProviderIcon, experimental_ProviderModelPicker, experimental_SourceCode, experimental_useAppPanel, experimental_useBranches, experimental_useCheckoutState, experimental_useCodeTheme, experimental_useFixedTabTarget, experimental_useProviders, experimental_useSidebarThreadActions, experimental_useSidebarThreadPullRequest, experimental_useSidebarThreadSplit, experimental_useSidebarThreads, useBbContext, useBbNavigate, useComposer, useComposerView, useRealtime, useRealtimeConnectionState, useRpc, useSettings };
-export type { BbContext, BbNavigate, BranchPickerProps, BranchesState, CheckoutState, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppIcons, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSubmitOptions, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalIconProps, ExperimentalIconRegistration, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginFixedTabReference, ExperimentalProviderIconProps, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalSidebarFooter, ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterActionRegistration, ExperimentalSidebarFooterDisclosureController, ExperimentalSidebarFooterDisclosureProps, ExperimentalSidebarFooterDisclosureRegistration, ExperimentalSidebarFooterItemBase, ExperimentalSidebarFooterItemRegistration, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, JsonValue$1 as JsonValue, MarkdownProps, NewThreadComposerProps, NewThreadRequest, PluginAppBuilder, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandPaletteActionContext, PluginCommandPaletteActionRegistration, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, PluginFileOpenerProps, PluginFileOpenerRegistration, PluginFileOpenerSource, PluginFixedTabDeclaration, PluginFixedTabRegistration, PluginHomepageSectionProps, PluginHomepageSectionRegistration, PluginMachineProviderInputsChange, PluginMachineProviderInputsProps, PluginMachineProviderInputsRegistration, PluginMessageActionContext, PluginMessageActionRegistration, PluginMessageDirectiveMessage, PluginMessageDirectiveOpenWorkspaceFile, PluginMessageDirectiveProps, PluginMessageDirectiveRegistration, PluginNavPanelProps, PluginNavPanelRegistration, PluginNewThreadPanelActionContext, PluginNewThreadPanelActionRegistration, PluginNewThreadPanelProps, PluginPanelActionOpenOptions, PluginPendingInteractionProps, PluginPendingInteractionRegistration, PluginPendingInteractionView, PluginProviderIconRegistration, PluginProvidersState, PluginRealtimeConnectionState, PluginRpcCallArgs, PluginRpcClient, PluginRpcContract, PluginRpcError, PluginRpcErrorCode, PluginRpcHandlers, PluginRpcIssuePathSegment, PluginRpcMethodContract, PluginRpcResult, PluginRpcValidationIssue, PluginSdkApp, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsState, PluginSidebarFooterActionContext, PluginSidebarFooterActionProps, PluginSidebarFooterActionRegistration, PluginSidebarProject, PluginSidebarPullRequest, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginTargetedPanelActionOpenOptions, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, ReadonlyJsonValue, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps, UseBranchesArgs, UseCheckoutStateArgs };
+export type { BbContext, BbNavigate, BranchPickerProps, BranchesState, CheckoutState, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppIcons, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSubmitOptions, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalIconProps, ExperimentalIconRegistration, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginBrowserToolbarActionProps, ExperimentalPluginBrowserToolbarActionRegistration, ExperimentalPluginFixedTabReference, ExperimentalProviderIconProps, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalSidebarFooter, ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterActionRegistration, ExperimentalSidebarFooterDisclosureController, ExperimentalSidebarFooterDisclosureProps, ExperimentalSidebarFooterDisclosureRegistration, ExperimentalSidebarFooterItemBase, ExperimentalSidebarFooterItemRegistration, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, JsonValue$1 as JsonValue, MarkdownProps, NewThreadComposerProps, NewThreadRequest, PluginAppBuilder, PluginAppCommands, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandContext, PluginCommandPaletteActionContext, PluginCommandPaletteActionRegistration, PluginCommandRegistration, PluginCommandShortcut, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, PluginFileOpenerProps, PluginFileOpenerRegistration, PluginFileOpenerSource, PluginFixedTabDeclaration, PluginFixedTabRegistration, PluginHomepageSectionProps, PluginHomepageSectionRegistration, PluginMachineProviderInputsChange, PluginMachineProviderInputsProps, PluginMachineProviderInputsRegistration, PluginMessageActionContext, PluginMessageActionRegistration, PluginMessageDirectiveMessage, PluginMessageDirectiveOpenWorkspaceFile, PluginMessageDirectiveProps, PluginMessageDirectiveRegistration, PluginNavPanelProps, PluginNavPanelRegistration, PluginNewThreadPanelActionContext, PluginNewThreadPanelActionRegistration, PluginNewThreadPanelProps, PluginPanelActionOpenOptions, PluginPendingInteractionProps, PluginPendingInteractionRegistration, PluginPendingInteractionView, PluginProviderIconRegistration, PluginProvidersState, PluginRealtimeConnectionState, PluginRpcCallArgs, PluginRpcClient, PluginRpcContract, PluginRpcError, PluginRpcErrorCode, PluginRpcHandlers, PluginRpcIssuePathSegment, PluginRpcMethodContract, PluginRpcResult, PluginRpcValidationIssue, PluginSdkApp, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsState, PluginSidebarFooterActionContext, PluginSidebarFooterActionProps, PluginSidebarFooterActionRegistration, PluginSidebarProject, PluginSidebarPullRequest, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginTargetedPanelActionOpenOptions, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, ReadonlyJsonValue, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps, UseBranchesArgs, UseCheckoutStateArgs };

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

@@ -19,6 +19,14 @@ interface StandardSchemaV1<Input = unknown, Output = Input> {
         readonly version: 1;
         readonly vendor: string;
         readonly validate: (value: unknown) => StandardSchemaV1Result<Output> | Promise<StandardSchemaV1Result<Output>>;
+        readonly jsonSchema?: {
+            readonly input: (options: {
+                target: string;
+            }) => Record<string, unknown>;
+            readonly output: (options: {
+                target: string;
+            }) => Record<string, unknown>;
+        };
         readonly types?: {
             readonly input: Input;
             readonly output: Output;
@@ -40,6 +48,7 @@ interface StandardSchemaV1Issue {
 type StandardSchemaV1InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["input"];
 type StandardSchemaV1InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["output"];
 interface PluginRpcMethodContract<InputSchema extends StandardSchemaV1 = StandardSchemaV1, OutputSchema extends StandardSchemaV1 = StandardSchemaV1> {
+    readonly experimental_description?: string;
     readonly input: InputSchema;
     readonly output: OutputSchema;
 }

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

@@ -427,6 +427,8 @@ declare const threadQueuedMessageSchema: z.ZodObject<{
         kind: z.ZodLiteral<"time">;
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"thread-busy">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"stopping">;
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"turn-starting">;
     }, z.core.$strip>, z.ZodObject<{
@@ -733,6 +735,14 @@ interface StandardSchemaV1<Input = unknown, Output = Input> {
         readonly version: 1;
         readonly vendor: string;
         readonly validate: (value: unknown) => StandardSchemaV1Result<Output> | Promise<StandardSchemaV1Result<Output>>;
+        readonly jsonSchema?: {
+            readonly input: (options: {
+                target: string;
+            }) => Record<string, unknown>;
+            readonly output: (options: {
+                target: string;
+            }) => Record<string, unknown>;
+        };
         readonly types?: {
             readonly input: Input;
             readonly output: Output;
@@ -751,6 +761,11 @@ interface StandardSchemaV1Issue {
         readonly key: PropertyKey;
     })[];
 }
+interface PluginRpcMethodContract<InputSchema extends StandardSchemaV1 = StandardSchemaV1, OutputSchema extends StandardSchemaV1 = StandardSchemaV1> {
+    readonly experimental_description?: string;
+    readonly input: InputSchema;
+    readonly output: OutputSchema;
+}
 
 type PluginSettingDescriptor = {
     type: "string";
@@ -1006,6 +1021,16 @@ interface MessageDispatchHookContext {
      * double-count.
      */
     queuedMessage: ThreadQueuedMessage | null;
+    /**
+     * Opaque JSON supplied by a plugin through the composer's
+     * `experimental_submit`, paired with that plugin's id. Null for ordinary
+     * submissions and queued re-attempts. Core does not persist or interpret
+     * the data.
+     */
+    experimental_submission: {
+        pluginId: string;
+        data: JsonValue;
+    } | null;
     /** How the dispatch was requested; null for internal/core-driven sends. */
     origin: ThreadCreateOrigin | null;
     originPluginId: string | null;
@@ -1509,6 +1534,16 @@ interface PluginMentionItem {
     subtitle?: string;
     icon?: string;
 }
+/** Agent-only image context resolved with a plugin mention. */
+type ExperimentalPluginMentionImage = {
+    type: "image";
+    url: string;
+    context?: string;
+} | {
+    type: "localImage";
+    path: string;
+    context?: string;
+};
 interface PluginMentionProviderRegistration {
     /** Unique within this plugin: [a-zA-Z0-9_-]+ (no ":" — the host composes
      * wire item ids as "<providerId>:<itemId>"). */
@@ -1535,8 +1570,10 @@ interface PluginMentionProviderRegistration {
      */
     resolve(itemId: string): {
         context: string;
+        experimental_images?: readonly ExperimentalPluginMentionImage[];
     } | Promise<{
         context: string;
+        experimental_images?: readonly ExperimentalPluginMentionImage[];
     }>;
 }
 /**
@@ -1691,6 +1728,17 @@ declare function deriveValidatedProviderOptions(args: {
     context: Parameters<NonNullable<PluginProviderDeclaration["deriveProviderOptions"]>>[0];
 }): Readonly<Record<string, JsonValue>>;
 declare function isStandardSchema(value: unknown): value is StandardSchemaV1;
+declare function readRpcPublicationOptions(value: unknown): {
+    experimental_discoverable: boolean;
+    experimental_description: string | null;
+};
+declare function publishRpcMethod(method: string, contract: PluginRpcMethodContract, options: ReturnType<typeof readRpcPublicationOptions>): {
+    method: string;
+    registrationDescription: string | null;
+    methodDescription: string | null;
+    inputSchema: Record<string, JsonValue$1>;
+    outputSchema: Record<string, JsonValue$1>;
+} | null;
 /**
  * The declared shape of `presentation`, copied field by field so
  * a plugin's object cannot smuggle prototypes or extra markup into the
@@ -1827,11 +1875,12 @@ declare function normalizeWebSocketRouteRegistration(path: string, handler: unkn
     auth: PluginHttpAuthMode;
 };
 type RpcRegistrationRecord = {
+    publication: ReturnType<typeof publishRpcMethod>;
     inputSchema: StandardSchemaV1;
     outputSchema: StandardSchemaV1;
     handler: (input: unknown) => unknown;
 };
-declare function normalizeRpcRegistration(contract: unknown, handlers: unknown, registered: ReadonlyMap<string, unknown>): Array<[string, RpcRegistrationRecord]>;
+declare function normalizeRpcRegistration(contract: unknown, handlers: unknown, registered: ReadonlyMap<string, unknown>, options: unknown): Array<[string, RpcRegistrationRecord]>;
 declare function normalizeRealtimePayload(channel: string, payload: unknown): unknown;
 declare function validateBackgroundServiceRegistration(name: string, service: {
     start(signal: AbortSignal): void | Promise<void>;
@@ -1913,5 +1962,5 @@ declare function normalizePluginAgentConfiguration(args: {
 declare function validateRpcValue(schema: StandardSchemaV1, value: unknown, phase: "input" | "output", fail: (error: PluginRpcError) => never): Promise<unknown>;
 declare function normalizeRpcJsonResult(value: unknown, fail: (error: PluginRpcError) => never): JsonValue;
 
-export { ENVIRONMENT_PROVIDER_DESCRIPTION_MAX_CHARS, ENVIRONMENT_PROVIDER_DISPLAY_NAME_MAX_CHARS, ENVIRONMENT_PROVIDER_ID_PATTERN, ENVIRONMENT_PROVIDER_REQUIREMENT_NAMES, KV_VALUE_MAX_BYTES, MACHINE_PROVIDER_DESCRIPTION_MAX_CHARS, PLUGIN_AGENT_STATUS_LABEL_MAX_CHARS, PLUGIN_MENTION_TRIGGER_VALUES, PLUGIN_PROVIDER_BRIDGE_OPTIONS_MAX_BYTES, PLUGIN_PROVIDER_COMPOSER_ACTION_VALUES, PLUGIN_PROVIDER_DISPLAY_NAME_MAX_CHARS, PLUGIN_PROVIDER_ENV_MAX_ENTRIES, PLUGIN_PROVIDER_ENV_NAME_PATTERN, PLUGIN_PROVIDER_PERMISSION_MODE_VALUES, PLUGIN_PROVIDER_REASONING_LEVEL_VALUES, PROVIDER_ID_PATTERN, RESERVED_AGENT_TOOL_NAMES, RESERVED_BB_CLI_COMMANDS, SERVER_DIRECT_AI_SERVICE_IDS, SETTING_KEY_PATTERN, adoptHttpRouteResponse, aiServiceAlreadyRegisteredMessage, assertAiServiceRegistrable, coerceStoredPluginSettingValue, deriveValidatedProviderOptions, enforcePluginCliOutputLimit, environmentCompositionSchema, isPluginMentionTrigger, isStandardSchema, normalizeAgentToolRegistration, normalizeCliRegistration, normalizeHttpRouteRegistration, normalizeInteractionRequest, normalizeMentionProviderRegistration, normalizePluginAgentConfiguration, normalizeRealtimePayload, normalizeRpcJsonResult, normalizeRpcRegistration, normalizeWebSocketRouteRegistration, parsePluginAgentToolPresentation, pluginCliCollisionWarning, pluginHookAlreadyRegisteredMessage, providerAlreadyRegisteredMessage, providerIconRefusalMessage, providerWithoutBridgeMessage, registerSettingDescriptors, runPluginStorageMigrations, storePluginHook, summarizeStandardIssues, undeclaredIconProblem, validateBackgroundServiceRegistration, validatePluginAiServiceDeclaration, validatePluginEnvironmentProviderDeclaration, validatePluginMachineProviderDeclaration, validatePluginProviderDeclaration, validatePluginProviderEnvEntries, validateProviderEnvContribution, validateRpcValue, validateScheduleRegistration, validateServerAccessProviderDeclaration, validateSettingsUpdate };
+export { ENVIRONMENT_PROVIDER_DESCRIPTION_MAX_CHARS, ENVIRONMENT_PROVIDER_DISPLAY_NAME_MAX_CHARS, ENVIRONMENT_PROVIDER_ID_PATTERN, ENVIRONMENT_PROVIDER_REQUIREMENT_NAMES, KV_VALUE_MAX_BYTES, MACHINE_PROVIDER_DESCRIPTION_MAX_CHARS, PLUGIN_AGENT_STATUS_LABEL_MAX_CHARS, PLUGIN_MENTION_TRIGGER_VALUES, PLUGIN_PROVIDER_BRIDGE_OPTIONS_MAX_BYTES, PLUGIN_PROVIDER_COMPOSER_ACTION_VALUES, PLUGIN_PROVIDER_DISPLAY_NAME_MAX_CHARS, PLUGIN_PROVIDER_ENV_MAX_ENTRIES, PLUGIN_PROVIDER_ENV_NAME_PATTERN, PLUGIN_PROVIDER_PERMISSION_MODE_VALUES, PLUGIN_PROVIDER_REASONING_LEVEL_VALUES, PROVIDER_ID_PATTERN, RESERVED_AGENT_TOOL_NAMES, RESERVED_BB_CLI_COMMANDS, SERVER_DIRECT_AI_SERVICE_IDS, SETTING_KEY_PATTERN, adoptHttpRouteResponse, aiServiceAlreadyRegisteredMessage, assertAiServiceRegistrable, coerceStoredPluginSettingValue, deriveValidatedProviderOptions, enforcePluginCliOutputLimit, environmentCompositionSchema, isPluginMentionTrigger, isStandardSchema, normalizeAgentToolRegistration, normalizeCliRegistration, normalizeHttpRouteRegistration, normalizeInteractionRequest, normalizeMentionProviderRegistration, normalizePluginAgentConfiguration, normalizeRealtimePayload, normalizeRpcJsonResult, normalizeRpcRegistration, normalizeWebSocketRouteRegistration, parsePluginAgentToolPresentation, pluginCliCollisionWarning, pluginHookAlreadyRegisteredMessage, providerAlreadyRegisteredMessage, providerIconRefusalMessage, providerWithoutBridgeMessage, publishRpcMethod, readRpcPublicationOptions, registerSettingDescriptors, runPluginStorageMigrations, storePluginHook, summarizeStandardIssues, undeclaredIconProblem, validateBackgroundServiceRegistration, validatePluginAiServiceDeclaration, validatePluginEnvironmentProviderDeclaration, validatePluginMachineProviderDeclaration, validatePluginProviderDeclaration, validatePluginProviderEnvEntries, validateProviderEnvContribution, validateRpcValue, validateScheduleRegistration, validateServerAccessProviderDeclaration, validateSettingsUpdate };
 export type { AiServiceHostBinding, NormalizedPluginEnvironmentComposition, NormalizedPluginEnvironmentProvider, NormalizedPluginEnvironmentProviderRequirements, NormalizedPluginMachineProvider, NormalizedPluginProviderDeclaration };

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

@@ -5,7 +5,8 @@
 // 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 { ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterItemRegistration, PluginHomepageSectionRegistration, PluginSettingsSectionRegistration, ExperimentalAppOverlayRegistration, PluginNavPanelRegistration, PluginThreadPanelActionRegistration, PluginNewThreadPanelActionRegistration, ComposerCustomization, PluginPendingInteractionRegistration, PluginSidebarFooterActionRegistration, ExperimentalSidebarNavigationRegistration, PluginThreadListRegistration, PluginThreadHeaderActionRegistration, PluginFileOpenerRegistration, PluginSourceCodeRendererRegistration, PluginDiffRendererRegistration, PluginMessageDirectiveRegistration, PluginMessageActionRegistration, PluginCommandPaletteActionRegistration, PluginProviderIconRegistration, ExperimentalIconRegistration, PluginTimelineRendererRegistration, PluginEnvironmentProviderInputsRegistration, PluginMachineProviderInputsRegistration, PluginContentScriptRegistration, PluginAppDefinition } from '@get-bb/plugin-sdk';
+import { z } from 'zod';
+import { ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterItemRegistration, PluginHomepageSectionRegistration, PluginSettingsSectionRegistration, ExperimentalAppOverlayRegistration, PluginNavPanelRegistration, PluginThreadPanelActionRegistration, PluginNewThreadPanelActionRegistration, ComposerCustomization, PluginPendingInteractionRegistration, PluginSidebarFooterActionRegistration, ExperimentalSidebarNavigationRegistration, PluginThreadListRegistration, PluginThreadHeaderActionRegistration, ExperimentalPluginBrowserToolbarActionRegistration, PluginFileOpenerRegistration, PluginSourceCodeRendererRegistration, PluginDiffRendererRegistration, PluginMessageDirectiveRegistration, PluginMessageActionRegistration, PluginCommandRegistration, PluginProviderIconRegistration, ExperimentalIconRegistration, PluginTimelineRendererRegistration, PluginEnvironmentProviderInputsRegistration, PluginMachineProviderInputsRegistration, PluginContentScriptRegistration, PluginAppDefinition } from '@get-bb/plugin-sdk';
 
 type ExperimentalSidebarFooterCommandKind = "close" | "open" | "toggle";
 interface ExperimentalSidebarFooterRuntimeSnapshot {
@@ -40,6 +41,17 @@ type CollectedPluginProviderIconRegistration = Omit<PluginProviderIconRegistrati
     providerKind: PluginProviderIconRegistration["providerKind"] | "all";
 };
 /** Validated registrations produced by one plugin app setup execution. */
+declare const commandShortcutSchema: z.ZodObject<{
+    alt: z.ZodDefault<z.ZodBoolean>;
+    control: z.ZodDefault<z.ZodBoolean>;
+    key: z.ZodString;
+    meta: z.ZodDefault<z.ZodBoolean>;
+    mod: z.ZodDefault<z.ZodBoolean>;
+    shift: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+interface CollectedPluginCommandRegistration extends Omit<PluginCommandRegistration, "defaultShortcut"> {
+    defaultShortcut: z.infer<typeof commandShortcutSchema> | null;
+}
 interface CollectedPluginAppRegistrations {
     homepageSections: PluginHomepageSectionRegistration[];
     settingsSections: PluginSettingsSectionRegistration[];
@@ -54,12 +66,13 @@ interface CollectedPluginAppRegistrations {
     experimentalSidebarNavigations: ExperimentalSidebarNavigationRegistration[];
     threadLists: PluginThreadListRegistration[];
     threadHeaderActions: PluginThreadHeaderActionRegistration[];
+    browserToolbarActions: ExperimentalPluginBrowserToolbarActionRegistration[];
     fileOpeners: PluginFileOpenerRegistration[];
     sourceCodeRenderers: PluginSourceCodeRendererRegistration[];
     diffRenderers: PluginDiffRendererRegistration[];
     messageDirectives: PluginMessageDirectiveRegistration[];
     messageActions: PluginMessageActionRegistration[];
-    commandPaletteActions: PluginCommandPaletteActionRegistration[];
+    commandPaletteActions: CollectedPluginCommandRegistration[];
     providerIcons: CollectedPluginProviderIconRegistration[];
     icons: ExperimentalIconRegistration[];
     timelineRenderers: PluginTimelineRendererRegistration[];
@@ -77,4 +90,4 @@ declare function getCollectedSidebarFooterItems(registrations: object): readonly
 declare function collectPluginAppRegistrations(definition: PluginAppDefinition, onComposerCustomizationRejected?: (reason: string) => void): CollectedPluginAppRegistrations;
 
 export { adaptSidebarFooterAction, collectPluginAppRegistrations, getCollectedSidebarFooterItems };
-export type { CollectedCompatibilitySidebarFooterItem, CollectedExperimentalSidebarFooterItem, CollectedManagedSidebarFooterItem, CollectedPluginAppRegistrations, CollectedPluginProviderIconRegistration, CollectedSidebarFooterItem, ExperimentalSidebarFooterCommandKind, ExperimentalSidebarFooterItemRuntime, ExperimentalSidebarFooterRuntimeSnapshot };
+export type { CollectedCompatibilitySidebarFooterItem, CollectedExperimentalSidebarFooterItem, CollectedManagedSidebarFooterItem, CollectedPluginAppRegistrations, CollectedPluginCommandRegistration, CollectedPluginProviderIconRegistration, CollectedSidebarFooterItem, ExperimentalSidebarFooterCommandKind, ExperimentalSidebarFooterItemRuntime, ExperimentalSidebarFooterRuntimeSnapshot };

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

@@ -3132,6 +3132,8 @@ declare const threadEventSchema: z.ZodPipe<z.ZodUnknown, z.ZodUnion<readonly [z.
     threadId: z.ZodString;
     tokenUsage: z.ZodObject<{
         last: z.ZodObject<{
+            cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+            cacheWriteInputTokens: z.ZodOptional<z.ZodNumber>;
             cachedInputTokens: z.ZodNumber;
             inputTokens: z.ZodNumber;
             outputTokens: z.ZodNumber;
@@ -3140,6 +3142,8 @@ declare const threadEventSchema: z.ZodPipe<z.ZodUnknown, z.ZodUnion<readonly [z.
         }, z.core.$strip>;
         modelContextWindow: z.ZodNullable<z.ZodNumber>;
         total: z.ZodObject<{
+            cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+            cacheWriteInputTokens: z.ZodOptional<z.ZodNumber>;
             cachedInputTokens: z.ZodNumber;
             inputTokens: z.ZodNumber;
             outputTokens: z.ZodNumber;
@@ -4732,6 +4736,8 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"usage">;
     last: z.ZodObject<{
+        cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheWriteInputTokens: z.ZodOptional<z.ZodNumber>;
         cachedInputTokens: z.ZodNumber;
         inputTokens: z.ZodNumber;
         outputTokens: z.ZodNumber;
@@ -4741,6 +4747,8 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     modelContextWindow: z.ZodNullable<z.ZodNumber>;
     providerTurnId: z.ZodOptional<z.ZodString>;
     total: z.ZodObject<{
+        cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheWriteInputTokens: z.ZodOptional<z.ZodNumber>;
         cachedInputTokens: z.ZodNumber;
         inputTokens: z.ZodNumber;
         outputTokens: z.ZodNumber;

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

@@ -414,6 +414,8 @@ declare const threadEventUserContentSchema: z.ZodDiscriminatedUnion<[z.ZodObject
 }, z.core.$strip>], "type">;
 type ThreadEventUserContent = z.infer<typeof threadEventUserContentSchema>;
 declare const threadEventTokenUsageBreakdownSchema: z.ZodObject<{
+    cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+    cacheWriteInputTokens: z.ZodOptional<z.ZodNumber>;
     cachedInputTokens: z.ZodNumber;
     inputTokens: z.ZodNumber;
     outputTokens: z.ZodNumber;
@@ -2912,6 +2914,8 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"usage">;
     last: z.ZodObject<{
+        cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheWriteInputTokens: z.ZodOptional<z.ZodNumber>;
         cachedInputTokens: z.ZodNumber;
         inputTokens: z.ZodNumber;
         outputTokens: z.ZodNumber;
@@ -2921,6 +2925,8 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     modelContextWindow: z.ZodNullable<z.ZodNumber>;
     providerTurnId: z.ZodOptional<z.ZodString>;
     total: z.ZodObject<{
+        cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheWriteInputTokens: z.ZodOptional<z.ZodNumber>;
         cachedInputTokens: z.ZodNumber;
         inputTokens: z.ZodNumber;
         outputTokens: z.ZodNumber;
@@ -3753,6 +3759,8 @@ declare const threadDeltaNotificationParamsSchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"usage">;
         last: z.ZodObject<{
+            cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+            cacheWriteInputTokens: z.ZodOptional<z.ZodNumber>;
             cachedInputTokens: z.ZodNumber;
             inputTokens: z.ZodNumber;
             outputTokens: z.ZodNumber;
@@ -3762,6 +3770,8 @@ declare const threadDeltaNotificationParamsSchema: z.ZodObject<{
         modelContextWindow: z.ZodNullable<z.ZodNumber>;
         providerTurnId: z.ZodOptional<z.ZodString>;
         total: z.ZodObject<{
+            cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+            cacheWriteInputTokens: z.ZodOptional<z.ZodNumber>;
             cachedInputTokens: z.ZodNumber;
             inputTokens: z.ZodNumber;
             outputTokens: z.ZodNumber;

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

@@ -7,7 +7,7 @@
 
 import { ReactNode, ComponentType } from 'react';
 import { RenderResult } from '@testing-library/react';
-import { ExperimentalSidebarFooterItemRegistration, PluginProviderIconRegistration, PluginHomepageSectionRegistration, PluginSettingsSectionRegistration, ExperimentalAppOverlayRegistration, PluginNavPanelRegistration, PluginThreadPanelActionRegistration, PluginNewThreadPanelActionRegistration, ComposerCustomization, PluginPendingInteractionRegistration, PluginSidebarFooterActionRegistration, ExperimentalSidebarNavigationRegistration, PluginThreadListRegistration, PluginThreadHeaderActionRegistration, PluginFileOpenerRegistration, PluginSourceCodeRendererRegistration, PluginDiffRendererRegistration, PluginMessageDirectiveRegistration, PluginMessageActionRegistration, ExperimentalIconRegistration, PluginTimelineRendererRegistration, PluginEnvironmentProviderInputsRegistration, PluginMachineProviderInputsRegistration, PluginContentScriptRegistration, PluginComposerScope, PluginComposerTextEffect, PluginComposerMention, PluginComposerThreadRowStatus, ExperimentalOpenFixedTabOptions, JsonValue, BbNavigate, ExperimentalFileOpenOptions, PluginAppDefinition, PluginRpcContract, StandardSchemaV1InferInput, PluginRpcResult, PluginRealtimeConnectionState, PluginSidebarThreadsState, PluginProvidersState, PluginCodeThemeState, BranchesState, CheckoutState, PluginSidebarPullRequest, PluginSidebarThreadActions } from '@get-bb/plugin-sdk';
+import { ExperimentalSidebarFooterItemRegistration, PluginProviderIconRegistration, PluginHomepageSectionRegistration, PluginSettingsSectionRegistration, ExperimentalAppOverlayRegistration, PluginNavPanelRegistration, PluginThreadPanelActionRegistration, PluginNewThreadPanelActionRegistration, ComposerCustomization, PluginPendingInteractionRegistration, PluginSidebarFooterActionRegistration, ExperimentalSidebarNavigationRegistration, PluginThreadListRegistration, PluginThreadHeaderActionRegistration, ExperimentalPluginBrowserToolbarActionRegistration, PluginFileOpenerRegistration, PluginSourceCodeRendererRegistration, PluginDiffRendererRegistration, PluginMessageDirectiveRegistration, PluginMessageActionRegistration, ExperimentalIconRegistration, PluginTimelineRendererRegistration, PluginEnvironmentProviderInputsRegistration, PluginMachineProviderInputsRegistration, PluginContentScriptRegistration, PluginComposerScope, PluginComposerTextEffect, PluginComposerMention, ExperimentalComposerSubmitOptions, PluginComposerThreadRowStatus, ExperimentalOpenFixedTabOptions, JsonValue, BbNavigate, ExperimentalFileOpenOptions, PluginAppDefinition, PluginRpcContract, StandardSchemaV1InferInput, PluginRpcResult, PluginRealtimeConnectionState, PluginSidebarThreadsState, PluginProvidersState, PluginCodeThemeState, BranchesState, CheckoutState, PluginSidebarPullRequest, PluginSidebarThreadActions } from '@get-bb/plugin-sdk';
 
 type ExperimentalSidebarFooterCommandKind = "close" | "open" | "toggle";
 interface ExperimentalSidebarFooterRuntimeSnapshot {
@@ -115,9 +115,7 @@ interface ComposerLog {
      * has no submit pipeline of its own, so it records the options and clears the
      * draft — enough to assert what a picker scheduled and that it tidied up.
      */
-    submits: Array<{
-        sendAt: number;
-    }>;
+    submits: ExperimentalComposerSubmitOptions[];
 }
 /** One recorded `experimental_useSidebarThreadActions()` call. */
 interface SidebarActionCall {
@@ -148,6 +146,7 @@ interface CapturedPluginApp {
     experimentalSidebarNavigations: ExperimentalSidebarNavigationRegistration[];
     threadLists: PluginThreadListRegistration[];
     threadHeaderActions: PluginThreadHeaderActionRegistration[];
+    browserToolbarActions: ExperimentalPluginBrowserToolbarActionRegistration[];
     fileOpeners: PluginFileOpenerRegistration[];
     sourceCodeRenderers: PluginSourceCodeRendererRegistration[];
     diffRenderers: PluginDiffRendererRegistration[];

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

@@ -5,7 +5,7 @@
 // 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 { StandardSchemaV1 as StandardSchemaV1$1, StandardSchemaV1InferOutput, PluginMachineValidateDecision, JsonValue as JsonValue$2, PluginEnvironmentProviderRequirements as PluginEnvironmentProviderRequirements$1, PluginEnvironmentValidateDecision, BbPluginApi, PluginSettingValue as PluginSettingValue$1, PluginSharedPortTunnelIdentity, PluginAgentToolPresentation, PluginAgentToolContext, PluginAgentToolResult, PluginCliCommandInfo, PluginCliContext, PluginCliResult, PluginHttpAuthMode, PluginHttpHandler, PluginMentionTrigger, PluginMentionSearchContext, PluginMentionItem, PluginCliExecutionResult, PluginThreadEventName, PluginThreadEventPayloads, PluginAgentConfigurationContext, ExperimentalPluginProviderEnvContext, ExperimentalPluginProviderEnvEntry, ExperimentalPluginProviderEnvHealthContext, ExperimentalPluginProviderEnvHealth, PluginSettingDescriptors, ExperimentalPluginWebSocketHandler, PluginAgentConfiguration, PluginHookName, PluginHookHandler, PluginAiServiceDeclaration, PluginInteractionRequest, MessageDispatchHookContext } from '@get-bb/plugin-sdk';
+import { StandardSchemaV1 as StandardSchemaV1$1, StandardSchemaV1InferOutput, PluginMachineValidateDecision, JsonValue as JsonValue$2, PluginEnvironmentProviderRequirements as PluginEnvironmentProviderRequirements$1, PluginEnvironmentValidateDecision, BbPluginApi, PluginSettingValue as PluginSettingValue$1, PluginSharedPortTunnelIdentity, PluginAgentToolPresentation, PluginAgentToolContext, PluginAgentToolResult, PluginCliCommandInfo, PluginCliContext, PluginCliResult, PluginHttpAuthMode, PluginHttpHandler, PluginMentionTrigger, PluginMentionSearchContext, PluginMentionItem, PluginMentionProviderRegistration, PluginCliExecutionResult, PluginThreadEventName, PluginThreadEventPayloads, PluginAgentConfigurationContext, ExperimentalPluginProviderEnvContext, ExperimentalPluginProviderEnvEntry, ExperimentalPluginProviderEnvHealthContext, ExperimentalPluginProviderEnvHealth, PluginSettingDescriptors, ExperimentalPluginWebSocketHandler, PluginAgentConfiguration, PluginHookName, PluginHookHandler, PluginAiServiceDeclaration, PluginInteractionRequest, MessageDispatchHookContext } from '@get-bb/plugin-sdk';
 import { z } from 'zod';
 
 type PluginMachineProviderResource = Exclude<JsonValue$2, null>;
@@ -468,6 +468,14 @@ interface StandardSchemaV1<Input = unknown, Output = Input> {
         readonly version: 1;
         readonly vendor: string;
         readonly validate: (value: unknown) => StandardSchemaV1Result<Output> | Promise<StandardSchemaV1Result<Output>>;
+        readonly jsonSchema?: {
+            readonly input: (options: {
+                target: string;
+            }) => Record<string, unknown>;
+            readonly output: (options: {
+                target: string;
+            }) => Record<string, unknown>;
+        };
         readonly types?: {
             readonly input: Input;
             readonly output: Output;
@@ -486,6 +494,11 @@ interface StandardSchemaV1Issue {
         readonly key: PropertyKey;
     })[];
 }
+interface PluginRpcMethodContract<InputSchema extends StandardSchemaV1 = StandardSchemaV1, OutputSchema extends StandardSchemaV1 = StandardSchemaV1> {
+    readonly experimental_description?: string;
+    readonly input: InputSchema;
+    readonly output: OutputSchema;
+}
 
 type PluginSettingValue = string | number | boolean;
 /**
@@ -917,6 +930,17 @@ type NormalizedPluginProviderDeclaration = Omit<PluginProviderDeclaration, "expe
         readonly scope: PluginProviderModelCatalogScope;
     };
 };
+declare function readRpcPublicationOptions(value: unknown): {
+    experimental_discoverable: boolean;
+    experimental_description: string | null;
+};
+declare function publishRpcMethod(method: string, contract: PluginRpcMethodContract, options: ReturnType<typeof readRpcPublicationOptions>): {
+    method: string;
+    registrationDescription: string | null;
+    methodDescription: string | null;
+    inputSchema: Record<string, JsonValue$1>;
+    outputSchema: Record<string, JsonValue$1>;
+} | null;
 declare const ENVIRONMENT_PROVIDER_REQUIREMENT_NAMES: readonly ["projectCheckout", "gitCheckout", "gitRemote", "projectless"];
 type NormalizedPluginEnvironmentProviderRequirements = {
     [K in (typeof ENVIRONMENT_PROVIDER_REQUIREMENT_NAMES)[number]]: boolean;
@@ -1107,11 +1131,7 @@ interface FakeMentionProviderRecord {
     label: string;
     triggers: readonly PluginMentionTrigger[];
     search: (ctx: PluginMentionSearchContext) => PluginMentionItem[] | Promise<PluginMentionItem[]>;
-    resolve: (itemId: string) => {
-        context: string;
-    } | Promise<{
-        context: string;
-    }>;
+    resolve: PluginMentionProviderRegistration["resolve"];
 }
 interface FakeRealtimeSignal {
     channel: string;
@@ -1129,6 +1149,7 @@ interface FakePluginRegistrations {
     settingsDescriptors: PluginSettingDescriptors;
     httpRoutes: FakeHttpRouteRecord[];
     websocketRoutes: ExperimentalFakeWebSocketRouteRecord[];
+    experimental_publishedRpcMethods: Array<NonNullable<ReturnType<typeof publishRpcMethod>>>;
     rpcMethods: string[];
     services: FakeServiceRecord[];
     schedules: FakeScheduleRecord[];