@get-bb/plugin-sdk 0.5.30 → 0.6.5

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

@@ -484,88 +484,6 @@ declare const threadResponseSchema: z.ZodObject<{
     canSpawnChild: z.ZodBoolean;
     createdAt: z.ZodNumber;
     deletedAt: z.ZodNullable<z.ZodNumber>;
-    draft: z.ZodNullable<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<{
-                kind: z.ZodLiteral<"thread">;
-                label: z.ZodString;
-                projectId: z.ZodOptional<z.ZodString>;
-                threadId: z.ZodString;
-            }, z.core.$strip>, z.ZodObject<{
-                kind: z.ZodLiteral<"project">;
-                label: z.ZodString;
-                projectId: z.ZodString;
-            }, z.core.$strip>, z.ZodObject<{
-                kind: z.ZodLiteral<"section">;
-                label: z.ZodString;
-                sectionId: z.ZodString;
-            }, z.core.$strip>, z.ZodObject<{
-                entryKind: z.ZodEnum<{
-                    directory: "directory";
-                    file: "file";
-                }>;
-                kind: z.ZodLiteral<"path">;
-                label: z.ZodString;
-                path: z.ZodString;
-                source: z.ZodEnum<{
-                    "thread-storage": "thread-storage";
-                    workspace: "workspace";
-                }>;
-            }, z.core.$strip>, z.ZodObject<{
-                argumentHint: z.ZodNullable<z.ZodString>;
-                kind: z.ZodLiteral<"command">;
-                label: z.ZodString;
-                name: z.ZodString;
-                origin: z.ZodEnum<{
-                    builtin: "builtin";
-                    project: "project";
-                    user: "user";
-                }>;
-                source: z.ZodEnum<{
-                    command: "command";
-                    skill: "skill";
-                }>;
-                trigger: z.ZodEnum<{
-                    "/": "/";
-                    $: "$";
-                }>;
-            }, z.core.$strip>, z.ZodObject<{
-                icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                itemId: z.ZodString;
-                kind: z.ZodLiteral<"plugin">;
-                label: z.ZodString;
-                pluginId: z.ZodString;
-            }, z.core.$strip>], "kind">>;
-            start: z.ZodNumber;
-        }, z.core.$strip>>>;
-        text: z.ZodString;
-        type: z.ZodLiteral<"text">;
-        visibility: z.ZodOptional<z.ZodEnum<{
-            "agent-only": "agent-only";
-        }>>;
-    }, z.core.$strip>, z.ZodObject<{
-        type: z.ZodLiteral<"image">;
-        url: z.ZodString;
-        visibility: z.ZodOptional<z.ZodEnum<{
-            "agent-only": "agent-only";
-        }>>;
-    }, z.core.$strip>, z.ZodObject<{
-        path: z.ZodString;
-        type: z.ZodLiteral<"localImage">;
-        visibility: z.ZodOptional<z.ZodEnum<{
-            "agent-only": "agent-only";
-        }>>;
-    }, z.core.$strip>, z.ZodObject<{
-        mimeType: z.ZodOptional<z.ZodString>;
-        name: z.ZodOptional<z.ZodString>;
-        path: z.ZodString;
-        sizeBytes: z.ZodOptional<z.ZodNumber>;
-        type: z.ZodLiteral<"localFile">;
-        visibility: z.ZodOptional<z.ZodEnum<{
-            "agent-only": "agent-only";
-        }>>;
-    }, z.core.$strip>], "type">>>;
     environmentId: z.ZodNullable<z.ZodString>;
     id: z.ZodString;
     lastReadAt: z.ZodNullable<z.ZodNumber>;
@@ -582,7 +500,6 @@ declare const threadResponseSchema: z.ZodObject<{
     queuedMessageCount: z.ZodNumber;
     runtime: z.ZodObject<{
         displayStatus: z.ZodEnum<{
-            "host-reconnecting": "host-reconnecting";
             "waiting-for-host": "waiting-for-host";
             active: "active";
             error: "error";
@@ -592,7 +509,6 @@ declare const threadResponseSchema: z.ZodObject<{
             starting: "starting";
             stopping: "stopping";
         }>;
-        hostReconnectGraceExpiresAt: z.ZodNullable<z.ZodNumber>;
     }, z.core.$strip>;
     sectionId: z.ZodNullable<z.ZodString>;
     sourceThreadId: z.ZodNullable<z.ZodString>;
@@ -879,6 +795,22 @@ interface PluginRpcMethodContract<InputSchema extends StandardSchemaV1 = Standar
     readonly input: InputSchema;
     readonly output: OutputSchema;
 }
+/**
+ * Who invoked an rpc method. `plugin` means another loaded plugin (or this
+ * one) called through its own `bb.sdk.plugins.callRpc`; the host verifies
+ * that with a per-load token only the server knows. Every other caller — the
+ * app, the `bb` CLI, agents, and bb itself — is `client`.
+ */
+type ExperimentalPluginRpcCaller = {
+    readonly kind: "plugin";
+    readonly pluginId: string;
+} | {
+    readonly kind: "client";
+};
+/** Second argument of every rpc handler. */
+interface ExperimentalPluginRpcHandlerContext {
+    readonly experimental_caller: ExperimentalPluginRpcCaller;
+}
 
 type PluginSettingDescriptor = {
     type: "string";
@@ -1154,7 +1086,7 @@ interface MessageDispatchHookContext {
     queuedMessages: ThreadQueuedMessage[];
     /**
      * Opaque JSON supplied by a plugin through the composer's
-     * `experimental_submit`, paired with that plugin's id. Null for ordinary
+     * `submit`, paired with that plugin's id. Null for ordinary
      * submissions and queued re-attempts. Core does not persist or interpret
      * the data.
      */
@@ -1728,8 +1660,9 @@ interface PluginMentionItem {
     subtitle?: string;
     /**
      * BB icon name: a built-in name, or a name the plugin's app bundle
-     * registered with `app.experimental_icons.register()`. The row prefers the
-     * plugin's own branding icon when it ships one; unknown names fall back to
+     * registered with `app.experimental_icons.register()`. Resolved names take
+     * precedence over plugin branding in menu rows, composer pills, and sent
+     * messages. Omitted or unknown names fall back to plugin branding, then
      * the generic plugin icon.
      */
     icon?: string;
@@ -2093,7 +2026,7 @@ type RpcRegistrationRecord = {
     publication: ReturnType<typeof publishRpcMethod>;
     inputSchema: StandardSchemaV1;
     outputSchema: StandardSchemaV1;
-    handler: (input: unknown) => unknown;
+    handler: (input: unknown, context: ExperimentalPluginRpcHandlerContext) => unknown;
 };
 declare function normalizeRpcRegistration(contract: unknown, handlers: unknown, registered: ReadonlyMap<string, unknown>, options: unknown): Array<[string, RpcRegistrationRecord]>;
 declare function normalizeRealtimePayload(channel: string, payload: unknown): unknown;

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>;
@@ -277,88 +277,6 @@ declare const threadResponseSchema: z.ZodObject<{
     canSpawnChild: z.ZodBoolean;
     createdAt: z.ZodNumber;
     deletedAt: z.ZodNullable<z.ZodNumber>;
-    draft: z.ZodNullable<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<{
-                kind: z.ZodLiteral<"thread">;
-                label: z.ZodString;
-                projectId: z.ZodOptional<z.ZodString>;
-                threadId: z.ZodString;
-            }, z.core.$strip>, z.ZodObject<{
-                kind: z.ZodLiteral<"project">;
-                label: z.ZodString;
-                projectId: z.ZodString;
-            }, z.core.$strip>, z.ZodObject<{
-                kind: z.ZodLiteral<"section">;
-                label: z.ZodString;
-                sectionId: z.ZodString;
-            }, z.core.$strip>, z.ZodObject<{
-                entryKind: z.ZodEnum<{
-                    directory: "directory";
-                    file: "file";
-                }>;
-                kind: z.ZodLiteral<"path">;
-                label: z.ZodString;
-                path: z.ZodString;
-                source: z.ZodEnum<{
-                    "thread-storage": "thread-storage";
-                    workspace: "workspace";
-                }>;
-            }, z.core.$strip>, z.ZodObject<{
-                argumentHint: z.ZodNullable<z.ZodString>;
-                kind: z.ZodLiteral<"command">;
-                label: z.ZodString;
-                name: z.ZodString;
-                origin: z.ZodEnum<{
-                    builtin: "builtin";
-                    project: "project";
-                    user: "user";
-                }>;
-                source: z.ZodEnum<{
-                    command: "command";
-                    skill: "skill";
-                }>;
-                trigger: z.ZodEnum<{
-                    "/": "/";
-                    $: "$";
-                }>;
-            }, z.core.$strip>, z.ZodObject<{
-                icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-                itemId: z.ZodString;
-                kind: z.ZodLiteral<"plugin">;
-                label: z.ZodString;
-                pluginId: z.ZodString;
-            }, z.core.$strip>], "kind">>;
-            start: z.ZodNumber;
-        }, z.core.$strip>>>;
-        text: z.ZodString;
-        type: z.ZodLiteral<"text">;
-        visibility: z.ZodOptional<z.ZodEnum<{
-            "agent-only": "agent-only";
-        }>>;
-    }, z.core.$strip>, z.ZodObject<{
-        type: z.ZodLiteral<"image">;
-        url: z.ZodString;
-        visibility: z.ZodOptional<z.ZodEnum<{
-            "agent-only": "agent-only";
-        }>>;
-    }, z.core.$strip>, z.ZodObject<{
-        path: z.ZodString;
-        type: z.ZodLiteral<"localImage">;
-        visibility: z.ZodOptional<z.ZodEnum<{
-            "agent-only": "agent-only";
-        }>>;
-    }, z.core.$strip>, z.ZodObject<{
-        mimeType: z.ZodOptional<z.ZodString>;
-        name: z.ZodOptional<z.ZodString>;
-        path: z.ZodString;
-        sizeBytes: z.ZodOptional<z.ZodNumber>;
-        type: z.ZodLiteral<"localFile">;
-        visibility: z.ZodOptional<z.ZodEnum<{
-            "agent-only": "agent-only";
-        }>>;
-    }, z.core.$strip>], "type">>>;
     environmentId: z.ZodNullable<z.ZodString>;
     id: z.ZodString;
     lastReadAt: z.ZodNullable<z.ZodNumber>;
@@ -375,7 +293,6 @@ declare const threadResponseSchema: z.ZodObject<{
     queuedMessageCount: z.ZodNumber;
     runtime: z.ZodObject<{
         displayStatus: z.ZodEnum<{
-            "host-reconnecting": "host-reconnecting";
             "waiting-for-host": "waiting-for-host";
             active: "active";
             error: "error";
@@ -385,7 +302,6 @@ declare const threadResponseSchema: z.ZodObject<{
             starting: "starting";
             stopping: "stopping";
         }>;
-        hostReconnectGraceExpiresAt: z.ZodNullable<z.ZodNumber>;
     }, z.core.$strip>;
     sectionId: z.ZodNullable<z.ZodString>;
     sourceThreadId: z.ZodNullable<z.ZodString>;
@@ -1346,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