@get-bb/plugin-sdk 0.4.35 → 0.4.45

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

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

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