@get-bb/plugin-sdk 0.4.4 → 0.4.8

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, PluginMessageDirectiveRegistration, PluginMessageActionRegistration, PluginContentScriptRegistration, PluginComposerScope, PluginComposerTextEffect, PluginComposerMention, PluginComposerThreadRowStatus, BbNavigate, PluginAppDefinition, PluginRpcContract, StandardSchemaV1InferInput, PluginRpcResult, PluginRealtimeConnectionState, PluginSidebarThreadsState, PluginSidebarPullRequest, PluginSidebarThreadActions } from '@get-bb/plugin-sdk';
+import { PluginHomepageSectionRegistration, PluginSettingsSectionRegistration, PluginNavPanelRegistration, PluginThreadPanelActionRegistration, PluginNewThreadPanelActionRegistration, ComposerCustomization, PluginPendingInteractionRegistration, PluginSidebarFooterActionRegistration, PluginThreadListRegistration, PluginThreadHeaderActionRegistration, PluginFileOpenerRegistration, PluginMessageDirectiveRegistration, PluginMessageActionRegistration, PluginProviderIconRegistration, PluginContentScriptRegistration, PluginComposerScope, PluginComposerTextEffect, PluginComposerMention, PluginComposerThreadRowStatus, BbNavigate, PluginAppDefinition, PluginRpcContract, StandardSchemaV1InferInput, PluginRpcResult, PluginRealtimeConnectionState, PluginSidebarThreadsState, PluginSidebarPullRequest, PluginSidebarThreadActions } from '@get-bb/plugin-sdk';
 
 /**
  * `@get-bb/plugin-sdk/testing/app` — the frontend plugin test harness. Tests a
@@ -106,6 +106,7 @@ interface CapturedPluginApp {
     fileOpeners: PluginFileOpenerRegistration[];
     messageDirectives: PluginMessageDirectiveRegistration[];
     messageActions: PluginMessageActionRegistration[];
+    providerIcons: PluginProviderIconRegistration[];
     contentScripts: PluginContentScriptRegistration[];
 }
 type PluginAppModule = {

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

@@ -0,0 +1,47 @@
+// Portable type declarations for `@get-bb/plugin-sdk`. Unpublished BB
+// workspace contracts are flattened; public subpaths may reuse the
+// package root without requiring any other @bb/* package.
+//
+// Confused by the API, or need a symbol that isn't here? Clone the BB repo
+// and read the real source: https://github.com/get-bb/bb
+
+import { ExperimentalHostWatchOptions, ExperimentalHostWatchListener, ExperimentalHostWatchSubscription, PluginRpcContract, ExperimentalHostSignals, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, ExperimentalHostEntry } from '@get-bb/plugin-sdk';
+
+type HostMethodName<Contract extends PluginRpcContract> = keyof Contract & string;
+type HostSignalName<Signals extends ExperimentalHostSignals> = keyof Signals & string;
+type ExperimentalHostHarnessSignal<Signals extends ExperimentalHostSignals> = {
+    [SignalName in HostSignalName<Signals>]: {
+        readonly signal: SignalName;
+        readonly payload: StandardSchemaV1InferOutput<Signals[SignalName]["payload"]>;
+    };
+}[HostSignalName<Signals>];
+interface ExperimentalCreateHostEntryHarnessOptions {
+    readonly experimental_paths?: {
+        readonly dataDir: string;
+        readonly tempDir: string;
+    };
+    readonly experimental_watch?: (options: ExperimentalHostWatchOptions, listener: ExperimentalHostWatchListener) => ExperimentalHostWatchSubscription | Promise<ExperimentalHostWatchSubscription>;
+}
+interface ExperimentalHostEntryHarness<Contract extends PluginRpcContract, Signals extends ExperimentalHostSignals> {
+    /** Invoke one handler through the same validation boundaries as the daemon. */
+    experimental_call<MethodName extends HostMethodName<Contract>>(method: MethodName, input: StandardSchemaV1InferInput<Contract[MethodName]["input"]>, options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<StandardSchemaV1InferOutput<Contract[MethodName]["output"]>>;
+    /** Validated signals emitted by handlers, in emission order. */
+    experimental_getSignals(): readonly ExperimentalHostHarnessSignal<Signals>[];
+    /** Number of worker-retention leases currently held by the entry. */
+    experimental_getRetainedWorkerLeaseCount(): number;
+    /** Aborted before the entry's dispose hook runs. */
+    readonly experimental_lifecycleSignal: AbortSignal;
+    /** Abort active calls and run the entry's dispose hook once. */
+    experimental_dispose(): Promise<void>;
+}
+/**
+ * Test one host entry in-process with the same validation, JSON transport,
+ * cancellation, lifecycle, and output-size boundaries as the daemon worker.
+ * Process crashes remain an integration concern for PluginHostManager tests.
+ */
+declare function experimental_createHostEntryHarness<Contract extends PluginRpcContract, Signals extends ExperimentalHostSignals>(entry: ExperimentalHostEntry<Contract, Signals>, harnessOptions?: ExperimentalCreateHostEntryHarnessOptions): ExperimentalHostEntryHarness<Contract, Signals>;
+
+export { experimental_createHostEntryHarness };
+export type { ExperimentalCreateHostEntryHarnessOptions, ExperimentalHostEntryHarness, ExperimentalHostHarnessSignal };

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

@@ -5,7 +5,7 @@
 // Confused by the API, or need a symbol that isn't here? Clone the BB repo
 // and read the real source: https://github.com/get-bb/bb
 
-import { BbPluginApi, PluginSettingValue, PluginSharedPortTunnelIdentity, PluginAgentToolExperimentalStatusLabels, PluginAgentToolContext, PluginAgentToolResult, PluginCliCommandInfo, PluginCliContext, PluginCliResult, PluginHttpAuthMode, PluginHttpHandler, PluginMentionTrigger, PluginMentionSearchContext, PluginMentionItem, JsonValue, PluginCliExecutionResult, PluginThreadEventName, PluginThreadEventPayloads, PluginAgentConfigurationContext, PluginSettingDescriptors, PluginAgentConfiguration, PluginInteractionRequest } from '@get-bb/plugin-sdk';
+import { BbPluginApi, PluginSettingValue, PluginSharedPortTunnelIdentity, PluginAgentToolExperimentalStatusLabels, PluginAgentToolContext, PluginAgentToolResult, PluginCliCommandInfo, PluginCliContext, PluginCliResult, PluginHttpAuthMode, PluginHttpHandler, PluginMentionTrigger, PluginMentionSearchContext, PluginMentionItem, JsonValue, PluginCliExecutionResult, PluginThreadEventName, PluginThreadEventPayloads, PluginAgentConfigurationContext, PluginSettingDescriptors, PluginAgentConfiguration, PluginProviderDeclaration, PluginInteractionRequest } from '@get-bb/plugin-sdk';
 
 type BbSdk = BbPluginApi["sdk"];
 /**
@@ -79,7 +79,7 @@ declare function createFakeSdk(options: {
 declare class PluginContextStaleError extends Error {
     constructor(pluginId: string);
 }
-type FakeLogLevel = "debug" | "info" | "warn" | "error";
+type FakeLogLevel = "debug" | "error" | "info" | "warn";
 interface FakeLogEntry {
     level: FakeLogLevel;
     message: string;
@@ -137,6 +137,12 @@ interface FakeRealtimeSignal {
     /** JSON-round-tripped, like the WS broadcast; `undefined` → `null`. */
     payload: unknown;
 }
+interface ExperimentalFakeHostRpcCall {
+    method: string;
+    input: unknown;
+    hostId: string;
+    signal?: AbortSignal;
+}
 /** Everything the plugin registered, exposed raw for assertions. */
 interface FakePluginRegistrations {
     settingsDescriptors: PluginSettingDescriptors;
@@ -155,6 +161,9 @@ interface FakePluginRegistrations {
     }) => string | null) | null;
     threadEventHandlers: Record<PluginThreadEventName, number>;
     mentionProviders: FakeMentionProviderRecord[];
+    /** Live provider registrations from `experimental_registerProvider`
+     * (normalized declarations, registration order; dispose removes). */
+    providerRegistrations: PluginProviderDeclaration[];
 }
 /** Read-only state for assertions after a plugin registers or handles work. */
 interface FakePluginInspectionState {
@@ -172,12 +181,18 @@ interface FakePluginInspectionState {
         hostId: string;
         ports: number[];
     }>;
+    /** Calls made through bb.hosts.experimental_client, after input validation. */
+    readonly experimental_hostRpcCalls: readonly ExperimentalFakeHostRpcCall[];
     readonly pendingInteractions: readonly (PluginInteractionRequest & {
         id: string;
     })[];
 }
 /** Deterministic inputs that stand in for behavior normally driven by BB. */
 interface FakePluginBehaviorDrivers {
+    /** Deliver an unexpected host-worker exit to every registered client. */
+    experimental_emitHostWorkerExit(hostId: string): Promise<void>;
+    /** Deliver a host signal through its registered payload schema. */
+    experimental_emitHostSignal(hostId: string, signal: string, payload: unknown): Promise<void>;
     submitInteraction(id: string, value: JsonValue): void;
     cancelInteraction(id: string): void;
     /**
@@ -289,6 +304,8 @@ interface CreateFakePluginHostOptions {
     agentSkillIds?: readonly string[];
     /** Read-only identities returned by bb.hosts.ensureSharedPortTunnel. */
     sharedPortTunnelIdentities?: Record<string, PluginSharedPortTunnelIdentity>;
+    /** Deterministic stand-in for the targeted daemon host entry. */
+    experimental_callHostRpc?: (call: ExperimentalFakeHostRpcCall) => unknown | Promise<unknown>;
 }
 interface FakePluginHost {
     bb: BbPluginApi;