@get-bb/plugin-sdk 0.4.40 → 0.4.47

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

@@ -191,6 +191,15 @@ declare function backgroundTaskItemStatus(taskStatus: BackgroundTaskStatus): "co
 declare function isSettledBackgroundTaskStatus(taskStatus: BackgroundTaskStatus): boolean;
 
 declare const threadEventItemPresentationSchema: z.ZodObject<{
+    badge: z.ZodOptional<z.ZodObject<{
+        glyph: z.ZodString;
+        hint: z.ZodString;
+        label: z.ZodString;
+        tone: z.ZodEnum<{
+            destructive: "destructive";
+            neutral: "neutral";
+        }>;
+    }, z.core.$strip>>;
     detail: z.ZodOptional<z.ZodString>;
     icon: z.ZodObject<{
         glyph: z.ZodString;
@@ -379,6 +388,15 @@ declare const pendingInteractionApprovalSubjectSchema: z.ZodDiscriminatedUnion<[
     itemId: z.ZodString;
     kind: z.ZodLiteral<"tool_use">;
     presentation: z.ZodObject<{
+        badge: z.ZodOptional<z.ZodObject<{
+            glyph: z.ZodString;
+            hint: z.ZodString;
+            label: z.ZodString;
+            tone: z.ZodEnum<{
+                destructive: "destructive";
+                neutral: "neutral";
+            }>;
+        }, z.core.$strip>>;
         detail: z.ZodOptional<z.ZodString>;
         icon: z.ZodObject<{
             glyph: z.ZodString;
@@ -472,6 +490,15 @@ declare const approvalPendingInteractionPayloadSchema: z.ZodObject<{
         itemId: z.ZodString;
         kind: z.ZodLiteral<"tool_use">;
         presentation: z.ZodObject<{
+            badge: z.ZodOptional<z.ZodObject<{
+                glyph: z.ZodString;
+                hint: z.ZodString;
+                label: z.ZodString;
+                tone: z.ZodEnum<{
+                    destructive: "destructive";
+                    neutral: "neutral";
+                }>;
+            }, z.core.$strip>>;
             detail: z.ZodOptional<z.ZodString>;
             icon: z.ZodObject<{
                 glyph: z.ZodString;
@@ -623,6 +650,15 @@ declare const pendingInteractionPayloadSchema: z.ZodUnion<readonly [z.ZodObject<
         itemId: z.ZodString;
         kind: z.ZodLiteral<"tool_use">;
         presentation: z.ZodObject<{
+            badge: z.ZodOptional<z.ZodObject<{
+                glyph: z.ZodString;
+                hint: z.ZodString;
+                label: z.ZodString;
+                tone: z.ZodEnum<{
+                    destructive: "destructive";
+                    neutral: "neutral";
+                }>;
+            }, z.core.$strip>>;
             detail: z.ZodOptional<z.ZodString>;
             icon: z.ZodObject<{
                 glyph: z.ZodString;
@@ -812,6 +848,15 @@ declare const approvalInteractionOutcomeSchema: z.ZodObject<{
             itemId: z.ZodString;
             kind: z.ZodLiteral<"tool_use">;
             presentation: z.ZodObject<{
+                badge: z.ZodOptional<z.ZodObject<{
+                    glyph: z.ZodString;
+                    hint: z.ZodString;
+                    label: z.ZodString;
+                    tone: z.ZodEnum<{
+                        destructive: "destructive";
+                        neutral: "neutral";
+                    }>;
+                }, z.core.$strip>>;
                 detail: z.ZodOptional<z.ZodString>;
                 icon: z.ZodObject<{
                     glyph: z.ZodString;
@@ -958,6 +1003,15 @@ declare const providerInteractionOutcomeSchema: z.ZodUnion<readonly [z.ZodObject
             itemId: z.ZodString;
             kind: z.ZodLiteral<"tool_use">;
             presentation: z.ZodObject<{
+                badge: z.ZodOptional<z.ZodObject<{
+                    glyph: z.ZodString;
+                    hint: z.ZodString;
+                    label: z.ZodString;
+                    tone: z.ZodEnum<{
+                        destructive: "destructive";
+                        neutral: "neutral";
+                    }>;
+                }, z.core.$strip>>;
                 detail: z.ZodOptional<z.ZodString>;
                 icon: z.ZodObject<{
                     glyph: z.ZodString;
@@ -1429,6 +1483,15 @@ declare const dynamicToolSchema: z.ZodObject<{
     inputSchema: z.ZodUnknown;
     name: z.ZodString;
     presentation: z.ZodOptional<z.ZodObject<{
+        badge: z.ZodOptional<z.ZodObject<{
+            glyph: z.ZodString;
+            hint: z.ZodString;
+            label: z.ZodString;
+            tone: z.ZodEnum<{
+                destructive: "destructive";
+                neutral: "neutral";
+            }>;
+        }, z.core.$strip>>;
         detail: z.ZodOptional<z.ZodString>;
         icon: z.ZodObject<{
             glyph: z.ZodString;
@@ -1725,6 +1788,15 @@ declare function shouldAutoDenyInteractiveRequest(policy: InteractiveRequestPoli
 
 declare const THREAD_DELTA_NOTIFICATION_METHOD = "thread/delta";
 declare const deltaPresentationSchema: z.ZodObject<{
+    badge: z.ZodOptional<z.ZodObject<{
+        glyph: z.ZodString;
+        hint: z.ZodString;
+        label: z.ZodString;
+        tone: z.ZodEnum<{
+            destructive: "destructive";
+            neutral: "neutral";
+        }>;
+    }, z.core.$strip>>;
     detail: z.ZodOptional<z.ZodString>;
     icon: z.ZodObject<{
         glyph: z.ZodString;
@@ -2328,6 +2400,15 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         rawType: z.ZodString;
     }, z.core.$strip>>;
     presentation: z.ZodOptional<z.ZodObject<{
+        badge: z.ZodOptional<z.ZodObject<{
+            glyph: z.ZodString;
+            hint: z.ZodString;
+            label: z.ZodString;
+            tone: z.ZodEnum<{
+                destructive: "destructive";
+                neutral: "neutral";
+            }>;
+        }, z.core.$strip>>;
         detail: z.ZodOptional<z.ZodString>;
         icon: z.ZodObject<{
             glyph: z.ZodString;
@@ -2519,6 +2600,15 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         rawType: z.ZodString;
     }, z.core.$strip>>;
     presentation: z.ZodOptional<z.ZodObject<{
+        badge: z.ZodOptional<z.ZodObject<{
+            glyph: z.ZodString;
+            hint: z.ZodString;
+            label: z.ZodString;
+            tone: z.ZodEnum<{
+                destructive: "destructive";
+                neutral: "neutral";
+            }>;
+        }, z.core.$strip>>;
         detail: z.ZodOptional<z.ZodString>;
         icon: z.ZodObject<{
             glyph: z.ZodString;
@@ -3111,6 +3201,15 @@ declare const threadDeltaNotificationParamsSchema: z.ZodObject<{
             rawType: z.ZodString;
         }, z.core.$strip>>;
         presentation: z.ZodOptional<z.ZodObject<{
+            badge: z.ZodOptional<z.ZodObject<{
+                glyph: z.ZodString;
+                hint: z.ZodString;
+                label: z.ZodString;
+                tone: z.ZodEnum<{
+                    destructive: "destructive";
+                    neutral: "neutral";
+                }>;
+            }, z.core.$strip>>;
             detail: z.ZodOptional<z.ZodString>;
             icon: z.ZodObject<{
                 glyph: z.ZodString;
@@ -3302,6 +3401,15 @@ declare const threadDeltaNotificationParamsSchema: z.ZodObject<{
             rawType: z.ZodString;
         }, z.core.$strip>>;
         presentation: z.ZodOptional<z.ZodObject<{
+            badge: z.ZodOptional<z.ZodObject<{
+                glyph: z.ZodString;
+                hint: z.ZodString;
+                label: z.ZodString;
+                tone: z.ZodEnum<{
+                    destructive: "destructive";
+                    neutral: "neutral";
+                }>;
+            }, z.core.$strip>>;
             detail: z.ZodOptional<z.ZodString>;
             icon: z.ZodObject<{
                 glyph: z.ZodString;
@@ -4187,6 +4295,15 @@ declare const threadStartParamsSchema: z.ZodObject<{
         inputSchema: z.ZodUnknown;
         name: z.ZodString;
         presentation: z.ZodOptional<z.ZodObject<{
+            badge: z.ZodOptional<z.ZodObject<{
+                glyph: z.ZodString;
+                hint: z.ZodString;
+                label: z.ZodString;
+                tone: z.ZodEnum<{
+                    destructive: "destructive";
+                    neutral: "neutral";
+                }>;
+            }, z.core.$strip>>;
             detail: z.ZodOptional<z.ZodString>;
             icon: z.ZodObject<{
                 glyph: z.ZodString;
@@ -4340,6 +4457,15 @@ declare const threadResumeParamsSchema: z.ZodObject<{
         inputSchema: z.ZodUnknown;
         name: z.ZodString;
         presentation: z.ZodOptional<z.ZodObject<{
+            badge: z.ZodOptional<z.ZodObject<{
+                glyph: z.ZodString;
+                hint: z.ZodString;
+                label: z.ZodString;
+                tone: z.ZodEnum<{
+                    destructive: "destructive";
+                    neutral: "neutral";
+                }>;
+            }, z.core.$strip>>;
             detail: z.ZodOptional<z.ZodString>;
             icon: z.ZodObject<{
                 glyph: z.ZodString;
@@ -4413,6 +4539,15 @@ declare const threadForkParamsSchema: z.ZodObject<{
         inputSchema: z.ZodUnknown;
         name: z.ZodString;
         presentation: z.ZodOptional<z.ZodObject<{
+            badge: z.ZodOptional<z.ZodObject<{
+                glyph: z.ZodString;
+                hint: z.ZodString;
+                label: z.ZodString;
+                tone: z.ZodEnum<{
+                    destructive: "destructive";
+                    neutral: "neutral";
+                }>;
+            }, z.core.$strip>>;
             detail: z.ZodOptional<z.ZodString>;
             icon: z.ZodObject<{
                 glyph: z.ZodString;

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

@@ -7,7 +7,23 @@
 
 import { ReactNode, ComponentType } from 'react';
 import { RenderResult } from '@testing-library/react';
-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';
+import { ExperimentalSidebarFooterItemRegistration, 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';
+
+type ExperimentalSidebarFooterCommandKind = "close" | "open" | "toggle";
+interface ExperimentalSidebarFooterRuntimeSnapshot {
+    command: {
+        sequence: number;
+        kind: ExperimentalSidebarFooterCommandKind;
+    } | null;
+}
+interface ExperimentalSidebarFooterItemRuntime {
+    subscribe(listener: () => void): () => void;
+    getSnapshot(): ExperimentalSidebarFooterRuntimeSnapshot;
+    acknowledgeCommand(sequence: number): void;
+}
+type CollectedExperimentalSidebarFooterItem = ExperimentalSidebarFooterItemRegistration & {
+    runtime: ExperimentalSidebarFooterItemRuntime;
+};
 
 /**
  * `@get-bb/plugin-sdk/testing/app` — the frontend plugin test harness. Tests a
@@ -125,6 +141,7 @@ interface CapturedPluginApp {
     composerCustomizations: ComposerCustomization[];
     pendingInteractions: PluginPendingInteractionRegistration[];
     sidebarFooterActions: PluginSidebarFooterActionRegistration[];
+    experimentalSidebarFooterItems: CollectedExperimentalSidebarFooterItem[];
     experimentalSidebarNavigations: ExperimentalSidebarNavigationRegistration[];
     threadLists: PluginThreadListRegistration[];
     threadHeaderActions: PluginThreadHeaderActionRegistration[];

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

@@ -6,7 +6,7 @@
 // and read the real source: https://github.com/get-bb/bb
 
 import { z } from 'zod';
-import { BbPluginApi, PluginSettingValue as PluginSettingValue$1, PluginSharedPortTunnelIdentity, PluginAgentToolPresentation, PluginAgentToolContext, PluginAgentToolResult, PluginCliCommandInfo, PluginCliContext, PluginCliResult, PluginHttpAuthMode, PluginHttpHandler, PluginMentionTrigger, PluginMentionSearchContext, PluginMentionItem, JsonValue as JsonValue$1, PluginCliExecutionResult, PluginThreadEventName, PluginThreadEventPayloads, PluginAgentConfigurationContext, PluginSettingDescriptors, PluginAgentConfiguration, PluginHookName, PluginHookHandler, PluginAiServiceDeclaration, PluginInteractionRequest } from '@get-bb/plugin-sdk';
+import { BbPluginApi, PluginSettingValue as PluginSettingValue$1, PluginSharedPortTunnelIdentity, PluginAgentToolPresentation, PluginAgentToolContext, PluginAgentToolResult, PluginCliCommandInfo, PluginCliContext, PluginCliResult, PluginHttpAuthMode, PluginHttpHandler, PluginMentionTrigger, PluginMentionSearchContext, PluginMentionItem, JsonValue as JsonValue$1, PluginCliExecutionResult, PluginThreadEventName, PluginThreadEventPayloads, PluginAgentConfigurationContext, ExperimentalPluginProviderEnvContext, ExperimentalPluginProviderEnvEntry, ExperimentalPluginProviderEnvHealthContext, ExperimentalPluginProviderEnvHealth, PluginSettingDescriptors, ExperimentalPluginWebSocketHandler, PluginAgentConfiguration, PluginHookName, PluginHookHandler, PluginAiServiceDeclaration, PluginInteractionRequest, MessageDispatchHookContext } from '@get-bb/plugin-sdk';
 
 /** Input-form entry: a path, or a path with options. */
 declare const providerNativeRootInputSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
@@ -555,6 +555,22 @@ interface FakeHttpRouteRecord {
     auth: PluginHttpAuthMode;
     handler: PluginHttpHandler;
 }
+interface ExperimentalFakeWebSocketRouteRecord {
+    path: string;
+    auth: PluginHttpAuthMode;
+    handler: ExperimentalPluginWebSocketHandler;
+}
+interface ExperimentalFakeWebSocketSession {
+    readonly sent: readonly (string | Uint8Array)[];
+    readonly closeCalls: readonly {
+        code: number | null;
+        reason: string | null;
+    }[];
+    readonly readyState: number;
+    receive(data: string | Uint8Array): Promise<void>;
+    close(code?: number, reason?: string): Promise<void>;
+    error(error: Error): Promise<void>;
+}
 interface FakeScheduleRecord {
     name: string;
     cron: string;
@@ -618,6 +634,7 @@ interface ExperimentalFakeHostRpcCall {
 interface FakePluginRegistrations {
     settingsDescriptors: PluginSettingDescriptors;
     httpRoutes: FakeHttpRouteRecord[];
+    websocketRoutes: ExperimentalFakeWebSocketRouteRecord[];
     rpcMethods: string[];
     services: FakeServiceRecord[];
     schedules: FakeScheduleRecord[];
@@ -639,6 +656,8 @@ interface FakePluginRegistrations {
     /** Live provider registrations from `bb.providers.register`
      * (normalized declarations, registration order; dispose removes). */
     providerRegistrations: NormalizedPluginProviderDeclaration[];
+    providerEnvResolvers: ReadonlyMap<string, (context: ExperimentalPluginProviderEnvContext) => Promise<readonly ExperimentalPluginProviderEnvEntry[]> | readonly ExperimentalPluginProviderEnvEntry[]>;
+    providerEnvHealthResolvers: ReadonlyMap<string, (context: ExperimentalPluginProviderEnvHealthContext) => ExperimentalPluginProviderEnvHealth | null | Promise<ExperimentalPluginProviderEnvHealth | null>>;
     /** Live AI-service registrations from `experimental_aiServices.register`
      * (normalized declarations, registration order; dispose removes). */
     aiServiceRegistrations: PluginAiServiceDeclaration[];
@@ -705,6 +724,8 @@ interface FakePluginBehaviorDrivers {
      * `{ ok: false, error: "plugin route failed: …" }` response.
      */
     fetchHttp(method: string, path: string, init?: RequestInit): Promise<Response>;
+    /** Open and drive an exact-match `bb.http.experimental_websocket` route. */
+    experimental_openWebSocket(path: string, init?: RequestInit): Promise<ExperimentalFakeWebSocketSession>;
     /**
      * Start a registered background service once, deterministically. `done`
      * settles when `start` returns; abort `controller` to signal shutdown.
@@ -741,6 +762,8 @@ interface FakePluginBehaviorDrivers {
         skills: string[];
         instructions: string | null;
     }>;
+    resolveProviderEnv(providerId: string, context: ExperimentalPluginProviderEnvContext): Promise<ExperimentalPluginProviderEnvEntry[]>;
+    resolveProviderEnvHealth(providerId: string, context: ExperimentalPluginProviderEnvHealthContext): Promise<ExperimentalPluginProviderEnvHealth | null>;
 }
 /** Reload/shutdown controls, kept separate from behavior and inspection. */
 interface FakePluginLifecycleControls {
@@ -827,6 +850,26 @@ declare function createFakePluginHost(options?: CreateFakePluginHostOptions): Fa
 type ThreadResponse = PluginThreadEventPayloads["thread.created"]["thread"];
 type QueueEntry = PluginThreadEventPayloads["message.queued"]["entry"];
 type TurnFailedEvent = PluginThreadEventPayloads["turn.failed"];
+type PluginAgentConfigurationContextOverrides = {
+    thread?: Partial<PluginAgentConfigurationContext["thread"]>;
+    project?: Partial<PluginAgentConfigurationContext["project"]>;
+    environment?: Partial<PluginAgentConfigurationContext["environment"]>;
+    host?: Partial<PluginAgentConfigurationContext["host"]>;
+    provider?: Omit<Partial<PluginAgentConfigurationContext["provider"]>, "capabilities"> & {
+        capabilities?: Partial<PluginAgentConfigurationContext["provider"]["capabilities"]>;
+    };
+    origin?: Partial<PluginAgentConfigurationContext["origin"]>;
+};
+type MessageDispatchHookContextOverrides = Omit<Partial<MessageDispatchHookContext>, "environment" | "executionSources" | "host" | "input" | "project" | "queuedMessage" | "requestedExecution" | "thread"> & {
+    thread?: Partial<MessageDispatchHookContext["thread"]>;
+    project?: Partial<MessageDispatchHookContext["project"]>;
+    environment?: Partial<NonNullable<MessageDispatchHookContext["environment"]>> | null;
+    host?: Partial<NonNullable<MessageDispatchHookContext["host"]>> | null;
+    input?: Partial<MessageDispatchHookContext["input"]>;
+    requestedExecution?: Partial<MessageDispatchHookContext["requestedExecution"]>;
+    executionSources?: Partial<MessageDispatchHookContext["executionSources"]>;
+    queuedMessage?: Partial<NonNullable<MessageDispatchHookContext["queuedMessage"]>> | null;
+};
 /**
  * A complete, deterministic `ThreadResponse` for thread lifecycle event
  * payloads (`harness.emitThreadEvent`). Defaults are the minimal idle
@@ -834,6 +877,20 @@ type TurnFailedEvent = PluginThreadEventPayloads["turn.failed"];
  * required field, this builder fails typecheck — update the default here.
  */
 declare function makeThreadResponse(overrides?: Partial<ThreadResponse>): ThreadResponse;
+/**
+ * A complete, deterministic context for conditional agent configuration.
+ * Defaults describe a standard project on an unmanaged local environment;
+ * override the fields the test cares about. If the contract grows a required
+ * field, this builder fails typecheck — update the default here.
+ */
+declare function makePluginAgentConfigurationContext(overrides?: PluginAgentConfigurationContextOverrides): PluginAgentConfigurationContext;
+/**
+ * A complete, deterministic context for the `message.dispatch` hook. Defaults
+ * describe a first inline dispatch before an environment or host is selected;
+ * override the fields the test cares about. If the contract grows a required
+ * field, this builder fails typecheck — update the default here.
+ */
+declare function makeMessageDispatchHookContext(overrides?: MessageDispatchHookContextOverrides): MessageDispatchHookContext;
 /**
  * A complete, deterministic queued row for the `message.*` event payloads
  * and for faking `sdk.threads.queuedMessages.list`. Defaults are a live inline
@@ -880,5 +937,5 @@ interface PublicSdkOnlyScan {
  */
 declare function scanPublicSdkOnly(packageRoot: string, options?: PublicSdkOnlyScanOptions): PublicSdkOnlyScan;
 
-export { PluginContextStaleError, createFakePluginHost, createFakeSdk, scanPublicSdkOnly as experimental_scanPublicSdkOnly, makeQueueEntry, makeThreadResponse, makeTurnFailedEvent };
+export { PluginContextStaleError, createFakePluginHost, createFakeSdk, scanPublicSdkOnly as experimental_scanPublicSdkOnly, makeMessageDispatchHookContext, makePluginAgentConfigurationContext, makeQueueEntry, makeThreadResponse, makeTurnFailedEvent };
 export type { CreateFakePluginHostOptions, FakeAgentToolRecord, FakeCliRecord, FakeHttpRouteRecord, FakeLogEntry, FakeLogLevel, FakeMentionProviderRecord, FakePluginBehaviorDrivers, FakePluginHarness, FakePluginHost, FakePluginInspectionState, FakePluginLifecycleControls, FakePluginRegistrations, FakeRealtimeSignal, FakeScheduleRecord, FakeSdkCall, FakeSdkHarness, FakeSdkOverrides, FakeServiceRecord, PublicSdkOnlyScan, PublicSdkOnlyScanOptions, PublicSdkOnlyViolation };