@get-bb/plugin-sdk 0.4.30 → 0.4.35

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, 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, 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
@@ -91,6 +91,14 @@ interface ComposerLog {
     quotes: string[];
     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
+     * draft — enough to assert what a picker scheduled and that it tidied up.
+     */
+    submits: Array<{
+        sendAt: number;
+    }>;
 }
 /** One recorded `experimental_useSidebarThreadActions()` call. */
 interface SidebarActionCall {
@@ -116,6 +124,7 @@ interface CapturedPluginApp {
     composerCustomizations: ComposerCustomization[];
     pendingInteractions: PluginPendingInteractionRegistration[];
     sidebarFooterActions: PluginSidebarFooterActionRegistration[];
+    experimentalSidebarNavigations: ExperimentalSidebarNavigationRegistration[];
     threadLists: PluginThreadListRegistration[];
     threadHeaderActions: PluginThreadHeaderActionRegistration[];
     fileOpeners: PluginFileOpenerRegistration[];

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, 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, PluginSettingDescriptors, PluginAgentConfiguration, PluginHookName, PluginHookHandler, PluginAiServiceDeclaration, PluginInteractionRequest } 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<{
@@ -74,7 +74,7 @@ type JsonValue = string | number | boolean | null | JsonValue[] | {
 };
 
 /**
- * The validator-neutral subset of Standard Schema v1 used by plugin RPC.
+ * The validator-neutral subset of Standard Schema v1 used by plugin contracts.
  * Zod 4 schemas implement this interface directly; other validators can do
  * the same without becoming part of BB's public protocol.
  */
@@ -631,6 +631,10 @@ interface FakePluginRegistrations {
         projectId: string;
     }) => string | null) | null;
     threadEventHandlers: Record<PluginThreadEventName, number>;
+    /** The handler registered per hook by `bb.experimental_hooks.on`. */
+    hooks: {
+        [K in PluginHookName]: PluginHookHandler<K> | null;
+    };
     mentionProviders: FakeMentionProviderRecord[];
     /** Live provider registrations from `bb.providers.register`
      * (normalized declarations, registration order; dispose removes). */
@@ -648,6 +652,12 @@ interface FakePluginInspectionState {
     readonly realtimeSignals: FakeRealtimeSignal[];
     /** Every `bb.status.needsConfiguration` message, in order. */
     readonly needsConfigurationMessages: string[];
+    /**
+     * How many times the plugin called
+     * `bb.experimental_hooks.recheck()` — the wake it asks core for when a
+     * condition its own waits depend on has changed.
+     */
+    readonly recheckCount: number;
     /** Recorded `bb.sdk` calls + stub control. */
     readonly sdk: FakeSdkHarness;
     readonly registrations: FakePluginRegistrations;
@@ -811,6 +821,8 @@ interface FakePluginHost {
 declare function createFakePluginHost(options?: CreateFakePluginHostOptions): FakePluginHost;
 
 type ThreadResponse = PluginThreadEventPayloads["thread.created"]["thread"];
+type QueueEntry = PluginThreadEventPayloads["message.queued"]["entry"];
+type TurnFailedEvent = PluginThreadEventPayloads["turn.failed"];
 /**
  * A complete, deterministic `ThreadResponse` for thread lifecycle event
  * payloads (`harness.emitThreadEvent`). Defaults are the minimal idle
@@ -818,6 +830,22 @@ type ThreadResponse = PluginThreadEventPayloads["thread.created"]["thread"];
  * required field, this builder fails typecheck — update the default here.
  */
 declare function makeThreadResponse(overrides?: Partial<ThreadResponse>): ThreadResponse;
+/**
+ * A complete, deterministic queued row for the `message.*` event payloads
+ * and for faking `sdk.threads.queuedMessages.list`. Defaults are a live inline
+ * row on this plugin's wait; override what the test is about. If the
+ * contract grows a required field, this builder fails typecheck — update the
+ * default here.
+ */
+declare function makeQueueEntry(overrides?: Partial<QueueEntry>): QueueEntry;
+/**
+ * A complete, deterministic `turn.failed` payload. Defaults are a first attempt
+ * that failed inside a provider turn with neither structured error info nor
+ * rate limits — the shape a retry policy must handle before it handles the
+ * interesting ones. If the contract grows a required field, this builder fails
+ * typecheck — update the default here.
+ */
+declare function makeTurnFailedEvent(overrides?: Partial<TurnFailedEvent>): TurnFailedEvent;
 
 interface PublicSdkOnlyScanOptions {
     /**
@@ -848,5 +876,5 @@ interface PublicSdkOnlyScan {
  */
 declare function scanPublicSdkOnly(packageRoot: string, options?: PublicSdkOnlyScanOptions): PublicSdkOnlyScan;
 
-export { PluginContextStaleError, createFakePluginHost, createFakeSdk, scanPublicSdkOnly as experimental_scanPublicSdkOnly, makeThreadResponse };
+export { PluginContextStaleError, createFakePluginHost, createFakeSdk, scanPublicSdkOnly as experimental_scanPublicSdkOnly, 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 };