@get-bb/plugin-sdk 0.4.40 → 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.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<{
@@ -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 {
@@ -827,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
@@ -834,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
@@ -880,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 };