@get-bb/plugin-sdk 0.4.30 → 0.4.34

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<{
@@ -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 };