@get-bb/plugin-sdk 0.5.31 → 0.6.9

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

@@ -1411,7 +1411,7 @@ type PromptMentionCommandTrigger = z.infer<typeof promptMentionCommandTriggerSch
 declare const promptInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     mentions: z.ZodDefault<z.ZodArray<z.ZodObject<{
         end: z.ZodNumber;
-        resource: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        resource: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"thread">;
             label: z.ZodString;
             projectId: z.ZodOptional<z.ZodString>;
@@ -1460,7 +1460,7 @@ declare const promptInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"plugin">;
             label: z.ZodString;
             pluginId: z.ZodString;
-        }, z.core.$strip>], "kind">>;
+        }, z.core.$strip>], "kind">, unknown>;
         start: z.ZodNumber;
     }, z.core.$strip>>>;
     text: z.ZodString;
@@ -4057,6 +4057,7 @@ declare const providerInstallationRequirementSchema: z.ZodEnum<{
 }>;
 type ProviderInstallationRequirement = z.infer<typeof providerInstallationRequirementSchema>;
 declare const providerInstallationStatusParamsSchema: z.ZodObject<{
+    checkUpdates: z.ZodDefault<z.ZodBoolean>;
     cwd: z.ZodOptional<z.ZodString>;
     providerId: z.ZodString;
     providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -4400,7 +4401,7 @@ declare const initializeParamsSchema: z.ZodObject<{
     protocolVersion: z.ZodNumber;
 }, z.core.$loose>;
 declare const initializeResultSchema: z.ZodObject<{
-    capabilities: z.ZodPipe<z.ZodTransform<{}, unknown>, z.ZodObject<{
+    capabilities: z.ZodPreprocess<z.ZodObject<{
         approvalEnforcedBy: z.ZodDefault<z.ZodEnum<{
             provider: "provider";
             runtime: "runtime";
@@ -4422,7 +4423,7 @@ declare const initializeResultSchema: z.ZodObject<{
         threadArchive: z.ZodDefault<z.ZodBoolean>;
         threadGoalClear: z.ZodDefault<z.ZodBoolean>;
         threadRename: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$loose>>;
+    }, z.core.$loose>, unknown>;
     protocolVersion: z.ZodNumber;
 }, z.core.$loose>;
 type InitializeResult = z.infer<typeof initializeResultSchema>;
@@ -4530,7 +4531,7 @@ declare const threadStartParamsSchema: z.ZodObject<{
     input: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         mentions: z.ZodDefault<z.ZodArray<z.ZodObject<{
             end: z.ZodNumber;
-            resource: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+            resource: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"thread">;
                 label: z.ZodString;
                 projectId: z.ZodOptional<z.ZodString>;
@@ -4579,7 +4580,7 @@ declare const threadStartParamsSchema: z.ZodObject<{
                 kind: z.ZodLiteral<"plugin">;
                 label: z.ZodString;
                 pluginId: z.ZodString;
-            }, z.core.$strip>], "kind">>;
+            }, z.core.$strip>], "kind">, unknown>;
             start: z.ZodNumber;
         }, z.core.$strip>>>;
         text: z.ZodString;
@@ -4857,7 +4858,7 @@ declare const turnStartParamsSchema: z.ZodObject<{
     input: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         mentions: z.ZodDefault<z.ZodArray<z.ZodObject<{
             end: z.ZodNumber;
-            resource: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+            resource: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"thread">;
                 label: z.ZodString;
                 projectId: z.ZodOptional<z.ZodString>;
@@ -4906,7 +4907,7 @@ declare const turnStartParamsSchema: z.ZodObject<{
                 kind: z.ZodLiteral<"plugin">;
                 label: z.ZodString;
                 pluginId: z.ZodString;
-            }, z.core.$strip>], "kind">>;
+            }, z.core.$strip>], "kind">, unknown>;
             start: z.ZodNumber;
         }, z.core.$strip>>>;
         text: z.ZodString;
@@ -4987,7 +4988,7 @@ declare const turnSteerParamsSchema: z.ZodObject<{
     input: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         mentions: z.ZodDefault<z.ZodArray<z.ZodObject<{
             end: z.ZodNumber;
-            resource: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+            resource: z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"thread">;
                 label: z.ZodString;
                 projectId: z.ZodOptional<z.ZodString>;
@@ -5036,7 +5037,7 @@ declare const turnSteerParamsSchema: z.ZodObject<{
                 kind: z.ZodLiteral<"plugin">;
                 label: z.ZodString;
                 pluginId: z.ZodString;
-            }, z.core.$strip>], "kind">>;
+            }, z.core.$strip>], "kind">, unknown>;
             start: z.ZodNumber;
         }, z.core.$strip>>>;
         text: z.ZodString;

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, ExperimentalSidebarHeaderRegistration, PluginThreadListRegistration, PluginThreadHeaderActionRegistration, ExperimentalPluginBrowserToolbarActionRegistration, PluginFileOpenerRegistration, PluginSourceCodeRendererRegistration, PluginDiffRendererRegistration, PluginMessageDirectiveRegistration, PluginMessageActionRegistration, ExperimentalIconRegistration, PluginTimelineRendererRegistration, PluginEnvironmentProviderInputsRegistration, PluginMachineProviderInputsRegistration, PluginContentScriptRegistration, PluginComposerScope, PluginComposerTextEffect, PluginComposerMention, ExperimentalComposerSubmitOptions, ExperimentalComposerSelection, PluginComposerThreadRowStatus, ExperimentalOpenFixedTabOptions, JsonValue, BbNavigate, ExperimentalFileOpenOptions, PluginAppDefinition, PluginRpcContract, StandardSchemaV1InferInput, PluginRpcResult, PluginBrowserBbSdk, PluginRealtimeConnectionState, PluginSidebarThreadsState, PluginProvidersState, PluginCodeThemeState, BranchesState, CheckoutState, PluginSidebarPullRequest, PluginSidebarThreadRowStatus, PluginSidebarThreadShortcut, PluginSidebarSplitLayout, ExperimentalSidebarNavigationItem, PluginEnvironmentProvidersState, PluginSidebarThreadActions, ExperimentalSidebarNavigationActions } from '@get-bb/plugin-sdk';
+import { ExperimentalSidebarFooterItemRegistration, PluginProviderIconRegistration, PluginHomepageSectionRegistration, PluginSettingsSectionRegistration, ExperimentalAppOverlayRegistration, PluginNavPanelRegistration, PluginThreadPanelActionRegistration, PluginNewThreadPanelActionRegistration, ComposerCustomization, PluginPendingInteractionRegistration, PluginSidebarFooterActionRegistration, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarHeaderRegistration, PluginThreadListRegistration, PluginThreadHeaderActionRegistration, ExperimentalPluginBrowserToolbarActionRegistration, PluginFileOpenerRegistration, PluginSourceCodeRendererRegistration, PluginDiffRendererRegistration, PluginMessageDirectiveRegistration, PluginMessageActionRegistration, ExperimentalIconRegistration, PluginTimelineRendererRegistration, PluginEnvironmentProviderInputsRegistration, PluginMachineProviderInputsRegistration, PluginContentScriptRegistration, ComposerDraftSnapshot, PluginComposerScope, ComposerSelection, PluginComposerTextEffect, PluginComposerMention, ComposerSubmitOptions, PluginComposerThreadRowStatus, ExperimentalOpenFixedTabOptions, JsonValue, BbNavigate, ExperimentalFileOpenOptions, PluginAppDefinition, PluginRpcContract, StandardSchemaV1InferInput, PluginRpcResult, PluginBrowserBbSdk, PluginRealtimeConnectionState, ComposerMention, ComposerAttachment, PluginSidebarThreadsState, PluginProvidersState, PluginCodeThemeState, BranchesState, CheckoutState, PluginSidebarPullRequest, PluginSidebarThreadRowStatus, PluginSidebarThreadShortcut, PluginSidebarSplitLayout, ExperimentalSidebarNavigationItem, PluginEnvironmentProvidersState, PluginSidebarThreadActions, ExperimentalSidebarNavigationActions } from '@get-bb/plugin-sdk';
 
 type ExperimentalSidebarFooterCommandKind = "close" | "open" | "toggle";
 interface ExperimentalSidebarFooterRuntimeSnapshot {
@@ -112,8 +112,17 @@ interface ExperimentalFixedTabOpenCall {
 interface ComposerLog {
     /** Latest plain text in this isolated composer scope. */
     readonly text: string;
+    /**
+     * Latest text and mention pills, as `useComposer().draft` reports them.
+     * The harness composer has no caret, so cursor inserts land at the end.
+     */
+    readonly draft: ComposerDraftSnapshot;
+    /** The key `useComposer().key` reports for the current scope. */
+    readonly key: string;
     /** Latest host-provided composer scope. */
     readonly scope: PluginComposerScope;
+    /** Current picker snapshot, or null for a composer without pickers. */
+    readonly selection: ComposerSelection | null;
     /** Latest host-provided attachment count exposed through `useComposerView()`. */
     readonly attachmentCount: number;
     /** Latest host-rendered text effect requested by the plugin. */
@@ -126,19 +135,19 @@ interface ComposerLog {
     mentions: PluginComposerMention[];
     focusCount: number;
     /**
-     * Every `experimental_submit` the plugin ran, in order. The harness composer
-     * has no submit pipeline of its own, so it records the options and clears the
+     * Every `submit` the plugin ran, in order. The harness composer 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: ExperimentalComposerSubmitOptions[];
+    submits: ComposerSubmitOptions[];
     /**
-     * Every `experimental_setSelection` the harness composer accepted, in
-     * order. The harness has no pickers of its own, so it records the request
-     * and echoes it back as the settled selection, minus the fields the
-     * composer's scope has no picker for (a thread has no project or
-     * environment). Queued-message and side-chat scopes reject, as the app does.
+     * Every `setSelection` the harness composer accepted, in order. The
+     * harness has no pickers of its own, so it merges accepted fields into
+     * its current selection and returns that snapshot. A thread drops
+     * project and environment because it has no pickers for them. The
+     * queued-message scope rejects, as the app does.
      */
-    selections: ExperimentalComposerSelection[];
+    selections: ComposerSelection[];
 }
 /** One recorded `experimental_useSidebarThreadActions()` call. */
 interface SidebarActionCall {
@@ -264,8 +273,21 @@ interface RenderSlotOptions<Contract extends PluginRpcContract = PluginRpcContra
     /** Initial state for this render's isolated composer scope and view. */
     composer?: {
         text?: string;
+        /** Mention pills already in `text`, with ranges into it. */
+        mentions?: readonly ComposerMention[];
         scope?: PluginComposerScope;
         attachmentCount?: number;
+        attachments?: readonly ComposerAttachment[];
+        layout?: "compact" | "expanded";
+        isRunning?: boolean;
+        isSubmitting?: boolean;
+        selection?: ComposerSelection;
+        /**
+         * What `submittingBlockedReason` reports, and what `submit` rejects
+         * with. Omitted → "Type a message first." while the draft is empty,
+         * "Submitting..." while `isSubmitting`, otherwise null.
+         */
+        submittingBlockedReason?: string | null;
     };
     /**
      * Threads and projects `experimental_useSidebarThreads()` reports. Omitted →

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, PluginRowPresentation, 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 { StandardSchemaV1 as StandardSchemaV1$1, StandardSchemaV1InferOutput, PluginMachineValidateDecision, JsonValue as JsonValue$2, PluginEnvironmentProviderRequirements as PluginEnvironmentProviderRequirements$1, PluginEnvironmentValidateDecision, BbPluginApi, PluginSettingValue as PluginSettingValue$1, PluginSharedPortTunnelIdentity, PluginRowPresentation, PluginAgentToolContext, PluginAgentToolResult, PluginCliCommandInfo, PluginCliContext, PluginCliResult, PluginHttpAuthMode, PluginHttpHandler, PluginMentionTrigger, PluginMentionSearchContext, PluginMentionItem, PluginMentionProviderRegistration, ExperimentalPluginRpcCaller, 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>;
@@ -649,7 +649,7 @@ interface PluginProviderCapabilities {
  * Provider copy core surfaces render from per-provider tables today (usage
  * banners, sign-in hints, the mobile picker, the agent guide). Declared once
  * here so no core surface keys copy on a provider id. Mirrors
- * `ProviderStrings` in `@bb/domain`, which is the client projection.
+ * `providerStringsSchema` in `@bb/domain`, which is the client projection.
  */
 interface PluginProviderStrings {
     /** How to sign in on the host ("Run `claude` on the machine to sign in."). */
@@ -1262,9 +1262,14 @@ interface FakePluginBehaviorDrivers {
     /**
      * Invoke a registered rpc method with host semantics: input/output schemas,
      * strict JSON result normalization, and structured failure codes. Rejects
-     * with the same message/code/issues the frontend client surfaces.
+     * with the same message/code/issues the frontend client surfaces. The
+     * handler sees `options.experimental_caller` as its caller, `{ kind:
+     * "client" }` by default; pass `{ kind: "plugin", pluginId }` to act as
+     * another plugin calling through `bb.sdk.plugins.callRpc`.
      */
-    callRpc(method: string, input?: unknown): Promise<unknown>;
+    callRpc(method: string, input?: unknown, options?: {
+        experimental_caller?: ExperimentalPluginRpcCaller;
+    }): Promise<unknown>;
     /**
      * Invoke the plugin's CLI command with host semantics: the result's
      * exitCode must be a number, stdout/stderr default to "", and a throwing