@get-bb/plugin-sdk 0.5.16 → 0.5.23

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

@@ -429,6 +429,7 @@ declare const changedMessageSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
     type: z$1.ZodLiteral<"changed">;
 }, z$1.core.$strict>, z$1.ZodObject<{
     changes: z$1.ZodReadonly<z$1.ZodArray<z$1.ZodEnum<{
+        "app-update-changed": "app-update-changed";
         "config-changed": "config-changed";
         "environment-availability-changed": "environment-availability-changed";
         "plugins-changed": "plugins-changed";
@@ -519,10 +520,8 @@ type Environment = z$1.infer<typeof environmentSchema>;
 declare const experimentsSchema: z$1.ZodRecord<z$1.ZodEnum<{
     changelogPreview: "changelogPreview";
     mobileApp: "mobileApp";
-    multiMachinePicker: "multiMachinePicker";
     serverMove: "serverMove";
     sidebarProgressiveDisclosure: "sidebarProgressiveDisclosure";
-    timelineWindowing: "timelineWindowing";
 }>, z$1.ZodBoolean>;
 type Experiments = z$1.infer<typeof experimentsSchema>;
 
@@ -8964,6 +8963,12 @@ declare const hostEnrollmentCommandResponseSchema: z$1.ZodNullable<z$1.ZodObject
     expiresAt: z$1.ZodNumber;
 }, z$1.core.$strip>>;
 type HostEnrollmentCommandResponse = z$1.infer<typeof hostEnrollmentCommandResponseSchema>;
+declare const hostReconnectResponseSchema: z$1.ZodObject<{
+    command: z$1.ZodString;
+    expiresAt: z$1.ZodNumber;
+    hostId: z$1.ZodString;
+}, z$1.core.$strict>;
+type HostReconnectResponse = z$1.infer<typeof hostReconnectResponseSchema>;
 declare const createHostJoinCodeResponseSchema: z$1.ZodObject<{
     expiresAt: z$1.ZodNumber;
     hostId: z$1.ZodString;
@@ -9651,6 +9656,7 @@ declare const systemExecutionOptionsResponseSchema: z$1.ZodObject<{
             provider_unavailable: "provider_unavailable";
             timeout: "timeout";
         }>;
+        detail: z$1.ZodNullable<z$1.ZodString>;
         providerId: z$1.ZodString;
     }, z$1.core.$strip>>;
     models: z$1.ZodArray<z$1.ZodObject<{
@@ -9857,21 +9863,93 @@ declare const systemProviderStatesResponseSchema: z$1.ZodObject<{
     }, z$1.core.$loose>>;
 }, z$1.core.$strip>;
 type SystemProviderStatesResponse = z$1.infer<typeof systemProviderStatesResponseSchema>;
-declare const systemConfigResponseSchema: z$1.ZodObject<{
-    aiServices: z$1.ZodObject<{
-        inference: z$1.ZodString;
-        inferenceFallback: z$1.ZodString;
-        services: z$1.ZodArray<z$1.ZodObject<{
-            displayName: z$1.ZodString;
-            id: z$1.ZodString;
-            kinds: z$1.ZodArray<z$1.ZodEnum<{
-                inference: "inference";
-                voice: "voice";
-            }>>;
+declare const systemAiServicesResponseSchema: z$1.ZodObject<{
+    selections: z$1.ZodObject<{
+        "commit-message": z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+            mode: z$1.ZodLiteral<"automatic">;
+        }, z$1.core.$strict>, z$1.ZodObject<{
+            mode: z$1.ZodLiteral<"off">;
+        }, z$1.core.$strict>, z$1.ZodObject<{
+            mode: z$1.ZodLiteral<"service">;
             pluginId: z$1.ZodString;
-        }, z$1.core.$strip>>;
-        transcription: z$1.ZodString;
-    }, z$1.core.$strip>;
+            serviceId: z$1.ZodString;
+        }, z$1.core.$strict>], "mode">;
+        "thread-title": z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+            mode: z$1.ZodLiteral<"automatic">;
+        }, z$1.core.$strict>, z$1.ZodObject<{
+            mode: z$1.ZodLiteral<"off">;
+        }, z$1.core.$strict>, z$1.ZodObject<{
+            mode: z$1.ZodLiteral<"service">;
+            pluginId: z$1.ZodString;
+            serviceId: z$1.ZodString;
+        }, z$1.core.$strict>], "mode">;
+        voice: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+            mode: z$1.ZodLiteral<"automatic">;
+        }, z$1.core.$strict>, z$1.ZodObject<{
+            mode: z$1.ZodLiteral<"off">;
+        }, z$1.core.$strict>, z$1.ZodObject<{
+            mode: z$1.ZodLiteral<"service">;
+            pluginId: z$1.ZodString;
+            serviceId: z$1.ZodString;
+        }, z$1.core.$strict>], "mode">;
+    }, z$1.core.$strict>;
+    services: z$1.ZodArray<z$1.ZodObject<{
+        automaticRank: z$1.ZodNullable<z$1.ZodNumber>;
+        displayName: z$1.ZodString;
+        id: z$1.ZodString;
+        pluginId: z$1.ZodString;
+        status: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+            ready: z$1.ZodLiteral<true>;
+        }, z$1.core.$strict>, z$1.ZodObject<{
+            message: z$1.ZodString;
+            ready: z$1.ZodLiteral<false>;
+        }, z$1.core.$strict>], "ready">;
+        tasks: z$1.ZodArray<z$1.ZodEnum<{
+            "commit-message": "commit-message";
+            "thread-title": "thread-title";
+            voice: "voice";
+        }>>;
+    }, z$1.core.$strip>>;
+}, z$1.core.$strip>;
+type SystemAiServicesResponse = z$1.infer<typeof systemAiServicesResponseSchema>;
+declare const setAiServiceSelectionRequestSchema: z$1.ZodObject<{
+    selection: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+        mode: z$1.ZodLiteral<"automatic">;
+    }, z$1.core.$strict>, z$1.ZodObject<{
+        mode: z$1.ZodLiteral<"off">;
+    }, z$1.core.$strict>, z$1.ZodObject<{
+        mode: z$1.ZodLiteral<"service">;
+        pluginId: z$1.ZodString;
+        serviceId: z$1.ZodString;
+    }, z$1.core.$strict>], "mode">;
+    task: z$1.ZodEnum<{
+        "commit-message": "commit-message";
+        "thread-title": "thread-title";
+        voice: "voice";
+    }>;
+}, z$1.core.$strict>;
+type SetAiServiceSelectionRequest = z$1.infer<typeof setAiServiceSelectionRequestSchema>;
+declare const testAiServiceRequestSchema: z$1.ZodObject<{
+    task: z$1.ZodEnum<{
+        "commit-message": "commit-message";
+        "thread-title": "thread-title";
+    }>;
+}, z$1.core.$strict>;
+type TestAiServiceRequest = z$1.infer<typeof testAiServiceRequestSchema>;
+declare const testAiServiceResponseSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+    displayName: z$1.ZodString;
+    durationMs: z$1.ZodNumber;
+    ok: z$1.ZodLiteral<true>;
+    pluginId: z$1.ZodString;
+    serviceId: z$1.ZodString;
+    text: z$1.ZodString;
+}, z$1.core.$strip>, z$1.ZodObject<{
+    durationMs: z$1.ZodNumber;
+    message: z$1.ZodString;
+    ok: z$1.ZodLiteral<false>;
+}, z$1.core.$strip>], "ok">;
+type TestAiServiceResponse = z$1.infer<typeof testAiServiceResponseSchema>;
+declare const systemConfigResponseSchema: z$1.ZodObject<{
     appearance: z$1.ZodObject<{
         customCss: z$1.ZodNullable<z$1.ZodString>;
         faviconColor: z$1.ZodEnum<{
@@ -10010,10 +10088,8 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
     experiments: z$1.ZodRecord<z$1.ZodEnum<{
         changelogPreview: "changelogPreview";
         mobileApp: "mobileApp";
-        multiMachinePicker: "multiMachinePicker";
         serverMove: "serverMove";
         sidebarProgressiveDisclosure: "sidebarProgressiveDisclosure";
-        timelineWindowing: "timelineWindowing";
     }>, z$1.ZodBoolean>;
     featureFlags: z$1.ZodObject<{
         placeholder: z$1.ZodBoolean;
@@ -10321,6 +10397,94 @@ declare const systemVersionResponseSchema: z$1.ZodObject<{
     upgradeCommand: z$1.ZodString;
 }, z$1.core.$strip>;
 type SystemVersionResponse = z$1.infer<typeof systemVersionResponseSchema>;
+declare const systemAppUpdateStatusSchema: z$1.ZodObject<{
+    activity: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+        phase: z$1.ZodLiteral<"idle">;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+        output: z$1.ZodArray<z$1.ZodString>;
+        phase: z$1.ZodLiteral<"preparing">;
+        startedAt: z$1.ZodString;
+        step: z$1.ZodString;
+        targetVersion: z$1.ZodString;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+        phase: z$1.ZodLiteral<"restarting">;
+        startedAt: z$1.ZodString;
+        targetVersion: z$1.ZodString;
+    }, z$1.core.$strip>], "phase">;
+    available: z$1.ZodNullable<z$1.ZodObject<{
+        channel: z$1.ZodEnum<{
+            latest: "latest";
+            main: "main";
+            nightly: "nightly";
+        }>;
+        commit: z$1.ZodNullable<z$1.ZodString>;
+        commitCount: z$1.ZodNullable<z$1.ZodNumber>;
+        subjects: z$1.ZodArray<z$1.ZodString>;
+        version: z$1.ZodString;
+    }, z$1.core.$strip>>;
+    blocked: z$1.ZodNullable<z$1.ZodObject<{
+        message: z$1.ZodString;
+        reason: z$1.ZodEnum<{
+            "detached-head": "detached-head";
+            "fetch-failed": "fetch-failed";
+            "not-on-main": "not-on-main";
+            "uncommitted-changes": "uncommitted-changes";
+            diverged: "diverged";
+        }>;
+    }, z$1.core.$strip>>;
+    current: z$1.ZodObject<{
+        commit: z$1.ZodNullable<z$1.ZodString>;
+        version: z$1.ZodString;
+    }, z$1.core.$strip>;
+    lastResult: z$1.ZodNullable<z$1.ZodObject<{
+        acknowledged: z$1.ZodBoolean;
+        finishedAt: z$1.ZodString;
+        from: z$1.ZodObject<{
+            commit: z$1.ZodNullable<z$1.ZodString>;
+            version: z$1.ZodString;
+        }, z$1.core.$strip>;
+        id: z$1.ZodString;
+        logTail: z$1.ZodArray<z$1.ZodString>;
+        message: z$1.ZodNullable<z$1.ZodString>;
+        outcome: z$1.ZodEnum<{
+            failed: "failed";
+            updated: "updated";
+        }>;
+        phase: z$1.ZodNullable<z$1.ZodEnum<{
+            install: "install";
+            prepare: "prepare";
+            startup: "startup";
+        }>>;
+        to: z$1.ZodObject<{
+            commit: z$1.ZodNullable<z$1.ZodString>;
+            version: z$1.ZodString;
+        }, z$1.core.$strip>;
+    }, z$1.core.$strip>>;
+    runningThreadCount: z$1.ZodNumber;
+    support: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+        kind: z$1.ZodLiteral<"supported">;
+        mode: z$1.ZodEnum<{
+            npm: "npm";
+            source: "source";
+        }>;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+        kind: z$1.ZodLiteral<"unsupported">;
+        reason: z$1.ZodEnum<{
+            desktop: "desktop";
+            development: "development";
+            unmanaged: "unmanaged";
+        }>;
+    }, z$1.core.$strip>], "kind">;
+}, z$1.core.$strip>;
+type SystemAppUpdateStatus = z$1.infer<typeof systemAppUpdateStatusSchema>;
+declare const systemAppUpdateApplyRequestSchema: z$1.ZodObject<{
+    confirmInterruptingThreads: z$1.ZodBoolean;
+}, z$1.core.$strip>;
+type SystemAppUpdateApplyRequest = z$1.infer<typeof systemAppUpdateApplyRequestSchema>;
+declare const systemAppUpdateAcknowledgeRequestSchema: z$1.ZodObject<{
+    id: z$1.ZodString;
+}, z$1.core.$strip>;
+type SystemAppUpdateAcknowledgeRequest = z$1.infer<typeof systemAppUpdateAcknowledgeRequestSchema>;
 declare const systemConfigReloadResponseSchema: z$1.ZodObject<{
     ok: z$1.ZodLiteral<true>;
 }, z$1.core.$strip>;
@@ -15289,6 +15453,9 @@ interface HostRetryUpdateArgs {
 interface HostActionArgs {
     hostId: string;
 }
+interface HostReconnectArgs extends HostActionArgs {
+    signal?: AbortSignal;
+}
 interface HostDirectoryArgs extends HostDirectoryQuery {
     hostId: string;
     signal?: AbortSignal;
@@ -15328,6 +15495,7 @@ type HostGetResult = Host & {
     connectMachineId: string | null;
 };
 type HostEnrollmentCommandResult = HostEnrollmentCommandResponse;
+type HostReconnectResult = HostReconnectResponse;
 type HostCloneDefaultPathResult = HostCloneDefaultPathResponse;
 type HostProviderCliInstallResult = HostProviderCliInstallEvent[];
 type HostListResult = Host[];
@@ -15341,6 +15509,7 @@ type MachineProviderListResult = SystemMachineProvider[];
 interface HostsArea {
     experimental_create(args: MachineCreateArgs): Promise<Host>;
     experimental_getEnrollmentCommand(args: HostGetArgs): Promise<HostEnrollmentCommandResult>;
+    experimental_reconnect(args: HostReconnectArgs): Promise<HostReconnectResult>;
     /** @deprecated Use experimental_create() and experimental_getEnrollmentCommand() for bootstrap enrollment. */
     createJoinCode(): Promise<HostCreateJoinCodeResult>;
     delete(args: HostDeleteArgs): Promise<HostDeleteResult>;
@@ -15906,6 +16075,13 @@ interface SystemVersionArgs {
     force?: boolean;
     signal?: AbortSignal;
 }
+interface SystemAppUpdateArgs {
+    force?: boolean;
+    signal?: AbortSignal;
+}
+type SystemApplyAppUpdateArgs = SystemAppUpdateApplyRequest;
+type SystemAcknowledgeAppUpdateArgs = SystemAppUpdateAcknowledgeRequest;
+type SystemAppUpdateStatusResult = SystemAppUpdateStatus;
 interface SystemVoiceTranscriptionArgs {
     file: Blob;
     prompt?: string;
@@ -15913,6 +16089,13 @@ interface SystemVoiceTranscriptionArgs {
 }
 type SystemAttentionResult = SystemAttentionResponse;
 type SystemConfigResult = SystemConfigResponse;
+type SystemAiServicesResult = SystemAiServicesResponse;
+type SystemSetAiServiceSelectionArgs = SetAiServiceSelectionRequest;
+type SystemTestAiServiceArgs = TestAiServiceRequest;
+type SystemTestAiServiceResult = TestAiServiceResponse;
+interface SystemAiServicesArgs {
+    signal?: AbortSignal;
+}
 type SystemExecutionOptionsResult = SystemExecutionOptionsResponse;
 type SystemReloadConfigResult = SystemConfigReloadResponse;
 type SystemInstallCliSkillsArgs = SystemInstallCliSkillsRequest;
@@ -15959,12 +16142,15 @@ interface SystemArea {
     }): Promise<MachineEnvironmentList>;
     machineEnvironment(): Promise<MachineEnvironmentList>;
     replaceMachineEnvironment(input: MachineEnvironmentReplace): Promise<MachineEnvironmentList>;
+    aiServices(args?: SystemAiServicesArgs): Promise<SystemAiServicesResult>;
     attention(args?: SystemAttentionArgs): Promise<SystemAttentionResult>;
     config(args?: SystemConfigArgs): Promise<SystemConfigResult>;
     executionOptions(args?: SystemExecutionOptionsArgs): Promise<SystemExecutionOptionsResult>;
     cliSkillsStatus(args?: SystemCliSkillsStatusArgs): Promise<SystemCliSkillsStatusResult>;
     installCliSkills(args: SystemInstallCliSkillsArgs): Promise<SystemInstallCliSkillsResult>;
     reloadConfig(): Promise<SystemReloadConfigResult>;
+    setAiServiceSelection(args: SystemSetAiServiceSelectionArgs): Promise<SystemAiServicesResult>;
+    testAiService(args: SystemTestAiServiceArgs): Promise<SystemTestAiServiceResult>;
     transcribeVoice(args: SystemVoiceTranscriptionArgs): Promise<SystemVoiceTranscriptionResult>;
     uiPreferences: SystemUiPreferencesArea;
     updateExperiments(args: Experiments): Promise<SystemUpdateExperimentsResult>;
@@ -15973,6 +16159,9 @@ interface SystemArea {
     providerStates(args?: SystemProviderStatesArgs): Promise<SystemProviderStatesResult>;
     usageLimits(args?: SystemUsageLimitsArgs): Promise<SystemUsageLimitsResult>;
     version(args?: SystemVersionArgs): Promise<SystemVersionResult>;
+    appUpdate(args?: SystemAppUpdateArgs): Promise<SystemAppUpdateStatusResult>;
+    applyAppUpdate(args: SystemApplyAppUpdateArgs): Promise<SystemAppUpdateStatusResult>;
+    acknowledgeAppUpdate(args: SystemAcknowledgeAppUpdateArgs): Promise<SystemAppUpdateStatusResult>;
 }
 
 interface TerminalThreadScope {
@@ -16606,6 +16795,30 @@ interface PluginPendingInteractionProps {
     submit(value: JsonValue$1): Promise<void>;
     cancel(): Promise<void>;
 }
+/** Display and accessibility metadata for a host-owned answer shortcut. */
+interface ExperimentalQuestionShortcut {
+    label: string;
+    ariaKeyshortcuts: string;
+}
+/**
+ * The keyboard shortcuts bb binds while a pending interaction is open. The
+ * host owns the bindings (users can remap them); a form shows them and decides
+ * what choosing an option means.
+ */
+interface ExperimentalQuestionFormHost {
+    /**
+     * Shortcut per zero-based option index, as a string (`"0"` is the first
+     * option). Missing entries have no binding.
+     */
+    shortcuts: ReadonlyMap<string, ExperimentalQuestionShortcut>;
+    /**
+     * Receive the index of the option the person chose with a shortcut while
+     * the thread's pane is focused. Return true when the index names an option
+     * the form handled. The last registered handler wins; call the returned
+     * function to unregister.
+     */
+    registerChoiceHandler(handler: (index: number) => boolean): () => void;
+}
 /**
  * Props for a `sidebarFooterAction` — host-rendered (no plugin component).
  * Deliberately empty; the registration's `run` carries the behavior.
@@ -17776,7 +17989,7 @@ interface PluginSidebarThreadActions {
     setRead(threadId: string, read: boolean): Promise<void>;
     /** Silent rename — no dialog. For inline editing in your own row. */
     rename(threadId: string, title: string): Promise<void>;
-    /** Opens bb's confirmation before archiving the thread and its children. */
+    /** Archives immediately, or confirms first if child threads will also be archived. */
     archive(threadId: string): void;
     /**
      * Opens bb's delete confirmation, which counts child threads first. Deletion
@@ -19368,6 +19581,13 @@ interface PluginSdkApp {
      * docs/api_to_audit.md.
      */
     experimental_usePluginId(): string;
+    /**
+     * The answer shortcuts bb binds while a pending interaction is open. Inside
+     * a `pendingInteraction` component the form shows each option's shortcut and
+     * registers a handler that chooses the option; outside one, the map is empty
+     * and handlers never run. Experimental: see docs/api_to_audit.md.
+     */
+    experimental_useQuestionFormHost(): ExperimentalQuestionFormHost;
     useBbNavigate(): BbNavigate;
     /** Select one of this plugin's eligible fixed tabs on the current surface. */
     experimental_useAppPanel(): ExperimentalAppPanel;
@@ -19499,9 +19719,10 @@ interface PluginSdkApp {
      * surfaces without further work. Reserve `useRpc` for work that needs your
      * server: secrets, host files, or your plugin's own storage.
      *
-     * Writes made here are not optimistic in bb's surfaces; they land when the
-     * realtime update does. `experimental_useSidebarThreadActions()` stays the
-     * optimistic path for pin, read state, rename, and archive.
+     * Thread title, section, and parent updates are optimistic in bb's surfaces
+     * and synchronous calls are applied as one cache transaction. Other writes
+     * land when their realtime update does. `experimental_useSidebarThreadActions()`
+     * stays the optimistic path for pin, read state, rename, and archive.
      *
      * The client is stable for the plugin's lifetime, so it is safe in effect
      * and callback dependency lists.
@@ -19617,6 +19838,7 @@ declare const useRealtimeConnectionState: () => PluginRealtimeConnectionState;
 declare const useSettings: () => PluginSettingsState;
 declare const useBbContext: () => BbContext;
 declare const experimental_usePluginId: () => string;
+declare const experimental_useQuestionFormHost: () => ExperimentalQuestionFormHost;
 declare const useBbNavigate: () => BbNavigate;
 declare const experimental_useAppPanel: () => ExperimentalAppPanel;
 declare const experimental_useFixedTabTarget: <Target extends JsonValue$1>(tab: ExperimentalPluginFixedTabReference<Target>) => ExperimentalFixedTabTargetState<Target> | null;
@@ -19643,5 +19865,5 @@ declare const useSdk: () => PluginBrowserBbSdk;
 declare const experimental_useProviders: () => PluginProvidersState;
 declare const experimental_useCodeTheme: () => PluginCodeThemeState;
 
-export { Markdown, ThreadChat, ThreadTitle, UrlLink, definePluginApp, experimental_BranchPicker, experimental_Diff, experimental_FileLink, experimental_Icon, experimental_NewThreadComposer, experimental_PermissionModePicker, experimental_ProviderIcon, experimental_ProviderModelPicker, experimental_SidebarNavigationIcon, experimental_SourceCode, experimental_useAppPanel, experimental_useBranches, experimental_useCheckoutState, experimental_useCodeTheme, experimental_useFixedTabTarget, experimental_usePluginId, experimental_useProviders, experimental_useSidebarNavigation, experimental_useSidebarNavigationSplit, experimental_useSidebarThreadActions, experimental_useSidebarThreadPullRequest, experimental_useSidebarThreadSplit, experimental_useSidebarThreads, useBbContext, useBbNavigate, useComposer, useComposerView, useEnvironmentProviders, useRealtime, useRealtimeConnectionState, useRpc, useSdk, useSettings, useSidebarSplitLayout, useSidebarThreadDraft, useSidebarThreadDraftIds, useSidebarThreadRowStatus, useSidebarThreadRowStatuses, useSidebarThreadShortcut };
-export type { BbContext, BbNavigate, BranchPickerProps, BranchesState, CheckoutState, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppIcons, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSelection, ExperimentalComposerSubmitOptions, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalIconProps, ExperimentalIconRegistration, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginBrowserPage, ExperimentalPluginBrowserPageEvaluateOptions, ExperimentalPluginBrowserPageWorld, ExperimentalPluginBrowserToolbarActionProps, ExperimentalPluginBrowserToolbarActionRegistration, ExperimentalPluginFixedTabReference, ExperimentalProviderIconProps, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalSidebarFooter, ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterActionRegistration, ExperimentalSidebarFooterDisclosureController, ExperimentalSidebarFooterDisclosureProps, ExperimentalSidebarFooterDisclosureRegistration, ExperimentalSidebarFooterItemBase, ExperimentalSidebarFooterItemRegistration, ExperimentalSidebarHeaderProps, ExperimentalSidebarHeaderRegistration, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActions, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationIconProps, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, ExperimentalSidebarNavigationSplit, ExperimentalSidebarNavigationSplitOptions, ExperimentalSidebarNavigationState, JsonValue$1 as JsonValue, MarkdownProps, NewThreadComposerProps, NewThreadRequest, PluginAppBuilder, PluginAppCommands, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginBoundThreadsArea, PluginBrowserBbSdk, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandContext, PluginCommandRegistration, PluginCommandShortcut, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginEnvironmentProvider, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, PluginEnvironmentProvidersState, PluginFileOpenerProps, PluginFileOpenerRegistration, PluginFileOpenerSource, PluginFixedTabDeclaration, PluginFixedTabRegistration, PluginHomepageSectionProps, PluginHomepageSectionRegistration, PluginMachineProviderInputsChange, PluginMachineProviderInputsProps, PluginMachineProviderInputsRegistration, PluginMessageActionContext, PluginMessageActionRegistration, PluginMessageDirectiveMessage, PluginMessageDirectiveOpenWorkspaceFile, PluginMessageDirectiveProps, PluginMessageDirectiveRegistration, PluginNavPanelProps, PluginNavPanelRegistration, PluginNewThreadPanelActionContext, PluginNewThreadPanelActionRegistration, PluginNewThreadPanelProps, PluginPanelActionOpenOptions, PluginPendingInteractionProps, PluginPendingInteractionRegistration, PluginPendingInteractionView, PluginProviderIconRegistration, PluginProvidersState, PluginRealtimeConnectionState, PluginRpcCallArgs, PluginRpcClient, PluginRpcContract, PluginRpcError, PluginRpcErrorCode, PluginRpcHandlers, PluginRpcIssuePathSegment, PluginRpcMethodContract, PluginRpcResult, PluginRpcValidationIssue, PluginSdkApp, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsState, PluginSidebarFooterActionContext, PluginSidebarFooterActionProps, PluginSidebarFooterActionRegistration, PluginSidebarProject, PluginSidebarPullRequest, PluginSidebarSection, PluginSidebarSplitLayout, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadDraftState, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadRowStatus, PluginSidebarThreadShortcut, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginTargetedPanelActionOpenOptions, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginThreadTitleProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, ReadonlyJsonValue, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps, UseBranchesArgs, UseCheckoutStateArgs };
+export { Markdown, ThreadChat, ThreadTitle, UrlLink, definePluginApp, experimental_BranchPicker, experimental_Diff, experimental_FileLink, experimental_Icon, experimental_NewThreadComposer, experimental_PermissionModePicker, experimental_ProviderIcon, experimental_ProviderModelPicker, experimental_SidebarNavigationIcon, experimental_SourceCode, experimental_useAppPanel, experimental_useBranches, experimental_useCheckoutState, experimental_useCodeTheme, experimental_useFixedTabTarget, experimental_usePluginId, experimental_useProviders, experimental_useQuestionFormHost, experimental_useSidebarNavigation, experimental_useSidebarNavigationSplit, experimental_useSidebarThreadActions, experimental_useSidebarThreadPullRequest, experimental_useSidebarThreadSplit, experimental_useSidebarThreads, useBbContext, useBbNavigate, useComposer, useComposerView, useEnvironmentProviders, useRealtime, useRealtimeConnectionState, useRpc, useSdk, useSettings, useSidebarSplitLayout, useSidebarThreadDraft, useSidebarThreadDraftIds, useSidebarThreadRowStatus, useSidebarThreadRowStatuses, useSidebarThreadShortcut };
+export type { BbContext, BbNavigate, BranchPickerProps, BranchesState, CheckoutState, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppIcons, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSelection, ExperimentalComposerSubmitOptions, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalIconProps, ExperimentalIconRegistration, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginBrowserPage, ExperimentalPluginBrowserPageEvaluateOptions, ExperimentalPluginBrowserPageWorld, ExperimentalPluginBrowserToolbarActionProps, ExperimentalPluginBrowserToolbarActionRegistration, ExperimentalPluginFixedTabReference, ExperimentalProviderIconProps, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalQuestionFormHost, ExperimentalQuestionShortcut, ExperimentalSidebarFooter, ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterActionRegistration, ExperimentalSidebarFooterDisclosureController, ExperimentalSidebarFooterDisclosureProps, ExperimentalSidebarFooterDisclosureRegistration, ExperimentalSidebarFooterItemBase, ExperimentalSidebarFooterItemRegistration, ExperimentalSidebarHeaderProps, ExperimentalSidebarHeaderRegistration, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActions, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationIconProps, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, ExperimentalSidebarNavigationSplit, ExperimentalSidebarNavigationSplitOptions, ExperimentalSidebarNavigationState, JsonValue$1 as JsonValue, MarkdownProps, NewThreadComposerProps, NewThreadRequest, PluginAppBuilder, PluginAppCommands, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginBoundThreadsArea, PluginBrowserBbSdk, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandContext, PluginCommandRegistration, PluginCommandShortcut, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginEnvironmentProvider, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, PluginEnvironmentProvidersState, PluginFileOpenerProps, PluginFileOpenerRegistration, PluginFileOpenerSource, PluginFixedTabDeclaration, PluginFixedTabRegistration, PluginHomepageSectionProps, PluginHomepageSectionRegistration, PluginMachineProviderInputsChange, PluginMachineProviderInputsProps, PluginMachineProviderInputsRegistration, PluginMessageActionContext, PluginMessageActionRegistration, PluginMessageDirectiveMessage, PluginMessageDirectiveOpenWorkspaceFile, PluginMessageDirectiveProps, PluginMessageDirectiveRegistration, PluginNavPanelProps, PluginNavPanelRegistration, PluginNewThreadPanelActionContext, PluginNewThreadPanelActionRegistration, PluginNewThreadPanelProps, PluginPanelActionOpenOptions, PluginPendingInteractionProps, PluginPendingInteractionRegistration, PluginPendingInteractionView, PluginProviderIconRegistration, PluginProvidersState, PluginRealtimeConnectionState, PluginRpcCallArgs, PluginRpcClient, PluginRpcContract, PluginRpcError, PluginRpcErrorCode, PluginRpcHandlers, PluginRpcIssuePathSegment, PluginRpcMethodContract, PluginRpcResult, PluginRpcValidationIssue, PluginSdkApp, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsState, PluginSidebarFooterActionContext, PluginSidebarFooterActionProps, PluginSidebarFooterActionRegistration, PluginSidebarProject, PluginSidebarPullRequest, PluginSidebarSection, PluginSidebarSplitLayout, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadDraftState, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadRowStatus, PluginSidebarThreadShortcut, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginTargetedPanelActionOpenOptions, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginThreadTitleProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, ReadonlyJsonValue, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps, UseBranchesArgs, UseCheckoutStateArgs };

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

@@ -1677,26 +1677,71 @@ interface PluginMentionProviderRegistration {
         experimental_images?: readonly ExperimentalPluginMentionImage[];
     }>;
 }
+/** Options for one `complete` call. */
+interface PluginAiCompleteOptions {
+    /**
+     * Aborted when bb stops waiting: the task timed out (5 seconds for titles
+     * and commit messages) or the request was cancelled. Pass it to `fetch`.
+     */
+    readonly signal: AbortSignal;
+}
+/** Options for one `transcribe` call. */
+interface PluginAiTranscribeOptions {
+    /** Aborted when bb stops waiting (10 seconds) or the request was cancelled. */
+    readonly signal: AbortSignal;
+    /**
+     * Vocabulary the speaker is likely to use (names, identifiers), for
+     * services that accept a transcription prompt; `null` when there is none.
+     */
+    readonly hint: string | null;
+}
 /**
- * What a plugin's AI service does. `inference` answers bb's server-side helper
- * completions (thread titles, commit messages: a prompt and a JSON Schema in,
- * a structured value out); `voice` transcribes recorded speech.
+ * Whether a service can answer right now. `message` is shown to the user
+ * beside the service ("Sign in to your bb account") and should say how to
+ * make it ready.
  */
-type PluginAiServiceKind = "inference" | "voice";
+type PluginAiServiceStatus = {
+    readonly ready: true;
+} | {
+    readonly ready: false;
+    readonly message: string;
+};
 /**
- * An AI service a plugin offers from its `bb.host` entry, which implements
- * `experimental_aiServicesHostContract` (`@get-bb/plugin-sdk/ai-services`).
- * The user selects it with `BB_INFERENCE` / `BB_TRANSCRIPTION` set to
- * `<id>/<model>`; core calls the plugin's host entry on the primary host with
- * the `id` on every request, so one entry can serve several services.
+ * An AI service bb can use for its helper tasks: thread titles and commit
+ * messages (`complete`) and voice input (`transcribe`). The user picks a
+ * service per task in Settings → AI services or with
+ * `bb settings ai-services set`. The functions run in the plugin's server
+ * process; a plugin that needs host-local state (a login file, a local model)
+ * reaches its own `bb.host` entry through `bb.hosts.experimental_client`.
+ *
+ * bb owns the prompts and cleans up replies (think blocks, quotes, labels,
+ * extra lines), so a service returns the model's text as-is. The plugin owns
+ * everything behind the function: which model, which API, any retries.
+ * Failure is a rejected promise.
  */
 interface PluginAiServiceDeclaration {
-    /** The `<serviceId>` segment of the user's setting; stable, lowercase. */
+    /**
+     * Stable, lowercase id, unique within this plugin. bb identifies a service
+     * by plugin id and service id, so another plugin may use the same id.
+     * `automatic` and `off` are reserved.
+     */
     readonly id: string;
-    /** Shown beside the id wherever the setting's options are listed. */
+    /** Shown in the picker; 1-64 characters. */
     readonly displayName: string;
-    /** Which kinds this service answers; a kind it lacks is not offered. */
-    readonly kinds: readonly PluginAiServiceKind[];
+    /**
+     * Answer one prompt with plain text. Offered for thread titles and commit
+     * messages. Declare `complete`, `transcribe`, or both.
+     */
+    readonly complete?: (prompt: string, options: PluginAiCompleteOptions) => Promise<string>;
+    /** Transcribe recorded speech to text. Offered for voice input. */
+    readonly transcribe?: (audio: File, options: PluginAiTranscribeOptions) => Promise<string>;
+    /**
+     * Report whether the service can answer. bb calls it for the picker's
+     * status line and to decide whether Automatic skips the service and
+     * whether the microphone shows; results are cached for a few seconds.
+     * Omit it when the service is always ready.
+     */
+    readonly status?: () => Promise<PluginAiServiceStatus>;
 }
 
 declare function pluginCliCollisionWarning(pluginId: string, commandName: string): string | null;
@@ -1733,57 +1778,24 @@ declare const PLUGIN_PROVIDER_PERMISSION_MODE_VALUES: readonly ["accept-edits",
 declare const PLUGIN_PROVIDER_REASONING_LEVEL_VALUES: readonly ["none", "low", "medium", "high", "xhigh", "ultracode", "max", "ultra"];
 declare const PLUGIN_PROVIDER_COMPOSER_ACTION_VALUES: readonly ["plan", "goal"];
 /**
- * AI-service ids the server serves itself: `openai` transcription and the
- * builtin inference providers (pi-ai 0.84). A plugin cannot register one —
- * it would capture the user's prompts and audio. This list is the one source
- * for both the fake host and production (`isServerDirectAiServiceId`);
- * apps/server/test/services/plugins/plugin-ai-services.test.ts pins it to
- * pi-ai's provider registry, so a pi-ai bump must move it in the same change.
+ * A validated `bb.experimental_aiServices.register` declaration. Absent
+ * functions are `null` so hosts never have to distinguish missing from
+ * undefined.
  */
-declare const SERVER_DIRECT_AI_SERVICE_IDS: readonly string[];
+interface NormalizedPluginAiService {
+    readonly id: string;
+    readonly displayName: string;
+    readonly complete: NonNullable<PluginAiServiceDeclaration["complete"]> | null;
+    readonly transcribe: NonNullable<PluginAiServiceDeclaration["transcribe"]> | null;
+    readonly status: NonNullable<PluginAiServiceDeclaration["status"]> | null;
+}
 /**
  * Validate one `bb.experimental_aiServices.register` declaration the same
  * way in the production host and the fake host. Throws on the first problem;
  * returns a normalized, frozen copy carrying only contract fields.
  */
-declare function validatePluginAiServiceDeclaration(declaration: PluginAiServiceDeclaration): PluginAiServiceDeclaration;
-/**
- * What an AI service binds to, decided at the
- * `bb.experimental_aiServices.register` call: the plugin's built `bb.host`
- * artifact, or — when the plugin declares an entry that failed to build —
- * nothing yet, with the build problem. An unbound service is staged so the
- * factory completes; the load then fails on that problem before the staged
- * registrations flush, so the service never goes live, while a provider the
- * same factory declared can still be retained as unavailable.
- */
-type AiServiceHostBinding<THostArtifact> = {
-    readonly artifact: THostArtifact;
-    readonly problem: null;
-} | {
-    readonly artifact: null;
-    readonly problem: string;
-};
-/**
- * The refusals a host makes at `bb.experimental_aiServices.register` before
- * it stages the declaration: a reserved server-direct id, and a plugin with
- * no `bb.host` entry for the service to run on. A plugin whose declared
- * entry failed to build is not refused here: the service is staged unbound,
- * carrying the build problem, so the load fails on that problem — the
- * actionable one — after the factory instead of at this call, and a
- * provider the same factory declares is listed as unavailable rather than
- * lost. Returns what the service binds to. The production host and the fake
- * host both call this, so they refuse identically;
- * apps/server/test/services/plugins/plugin-ai-services.test.ts pins the
- * messages.
- */
-declare function assertAiServiceRegistrable<THostArtifact>(args: {
-    id: string;
-    /** The plugin's built `bb.host` artifact, or null when it has none. */
-    hostArtifact: THostArtifact | null;
-    /** Why the artifact is missing when the plugin declared an entry that failed to build. */
-    hostArtifactProblem: string | null;
-}): AiServiceHostBinding<THostArtifact>;
-/** The collision a second registration of a live AI-service id raises. */
+declare function validatePluginAiServiceDeclaration(declaration: PluginAiServiceDeclaration): NormalizedPluginAiService;
+/** The collision a plugin's second registration of one AI-service id raises. */
 declare function aiServiceAlreadyRegisteredMessage(id: string): string;
 /** The collision a second registration of a live provider id raises. */
 declare function providerAlreadyRegisteredMessage(id: string): string;
@@ -2069,5 +2081,5 @@ declare function normalizePluginAgentConfiguration(args: {
 declare function validateRpcValue(schema: StandardSchemaV1, value: unknown, phase: "input" | "output", fail: (error: PluginRpcError) => never): Promise<unknown>;
 declare function normalizeRpcJsonResult(value: unknown, fail: (error: PluginRpcError) => never): JsonValue;
 
-export { ENVIRONMENT_PROVIDER_DESCRIPTION_MAX_CHARS, ENVIRONMENT_PROVIDER_DISPLAY_NAME_MAX_CHARS, ENVIRONMENT_PROVIDER_ID_PATTERN, ENVIRONMENT_PROVIDER_REQUIREMENT_NAMES, KV_VALUE_MAX_BYTES, MACHINE_PROVIDER_DESCRIPTION_MAX_CHARS, PLUGIN_AGENT_STATUS_LABEL_MAX_CHARS, PLUGIN_MENTION_TRIGGER_VALUES, PLUGIN_PROVIDER_BRIDGE_OPTIONS_MAX_BYTES, PLUGIN_PROVIDER_COMPOSER_ACTION_VALUES, PLUGIN_PROVIDER_DISPLAY_NAME_MAX_CHARS, PLUGIN_PROVIDER_ENV_MAX_ENTRIES, PLUGIN_PROVIDER_ENV_NAME_PATTERN, PLUGIN_PROVIDER_PERMISSION_MODE_VALUES, PLUGIN_PROVIDER_REASONING_LEVEL_VALUES, PROVIDER_ID_PATTERN, RESERVED_AGENT_TOOL_NAMES, RESERVED_BB_CLI_COMMANDS, SERVER_DIRECT_AI_SERVICE_IDS, SETTING_KEY_PATTERN, adoptHttpRouteResponse, aiServiceAlreadyRegisteredMessage, assertAiServiceRegistrable, coerceStoredPluginSettingValue, deriveValidatedProviderOptions, enforcePluginCliOutputLimit, environmentCompositionSchema, isPluginMentionTrigger, isStandardSchema, normalizeAgentToolRegistration, normalizeCliRegistration, normalizeHttpRouteRegistration, normalizeInteractionRequest, normalizeMentionProviderRegistration, normalizePluginAgentConfiguration, normalizeRealtimePayload, normalizeRpcJsonResult, normalizeRpcRegistration, normalizeWebSocketRouteRegistration, parsePluginRowPresentation, pluginCliCollisionWarning, pluginHookAlreadyRegisteredMessage, providerAlreadyRegisteredMessage, providerIconRefusalMessage, providerWithoutBridgeMessage, publishRpcMethod, readRpcPublicationOptions, registerSettingDescriptors, runPluginStorageMigrations, storePluginHook, summarizeStandardIssues, undeclaredIconProblem, validateBackgroundServiceRegistration, validatePluginAiServiceDeclaration, validatePluginEnvironmentProviderDeclaration, validatePluginMachineProviderDeclaration, validatePluginProviderDeclaration, validatePluginProviderEnvEntries, validateProviderEnvContribution, validateRpcValue, validateScheduleRegistration, validateServerAccessProviderDeclaration, validateSettingsUpdate };
-export type { AiServiceHostBinding, NormalizedPluginEnvironmentComposition, NormalizedPluginEnvironmentProvider, NormalizedPluginEnvironmentProviderRequirements, NormalizedPluginInteractionRequest, NormalizedPluginMachineProvider, NormalizedPluginProviderDeclaration };
+export { ENVIRONMENT_PROVIDER_DESCRIPTION_MAX_CHARS, ENVIRONMENT_PROVIDER_DISPLAY_NAME_MAX_CHARS, ENVIRONMENT_PROVIDER_ID_PATTERN, ENVIRONMENT_PROVIDER_REQUIREMENT_NAMES, KV_VALUE_MAX_BYTES, MACHINE_PROVIDER_DESCRIPTION_MAX_CHARS, PLUGIN_AGENT_STATUS_LABEL_MAX_CHARS, PLUGIN_MENTION_TRIGGER_VALUES, PLUGIN_PROVIDER_BRIDGE_OPTIONS_MAX_BYTES, PLUGIN_PROVIDER_COMPOSER_ACTION_VALUES, PLUGIN_PROVIDER_DISPLAY_NAME_MAX_CHARS, PLUGIN_PROVIDER_ENV_MAX_ENTRIES, PLUGIN_PROVIDER_ENV_NAME_PATTERN, PLUGIN_PROVIDER_PERMISSION_MODE_VALUES, PLUGIN_PROVIDER_REASONING_LEVEL_VALUES, PROVIDER_ID_PATTERN, RESERVED_AGENT_TOOL_NAMES, RESERVED_BB_CLI_COMMANDS, SETTING_KEY_PATTERN, adoptHttpRouteResponse, aiServiceAlreadyRegisteredMessage, coerceStoredPluginSettingValue, deriveValidatedProviderOptions, enforcePluginCliOutputLimit, environmentCompositionSchema, isPluginMentionTrigger, isStandardSchema, normalizeAgentToolRegistration, normalizeCliRegistration, normalizeHttpRouteRegistration, normalizeInteractionRequest, normalizeMentionProviderRegistration, normalizePluginAgentConfiguration, normalizeRealtimePayload, normalizeRpcJsonResult, normalizeRpcRegistration, normalizeWebSocketRouteRegistration, parsePluginRowPresentation, pluginCliCollisionWarning, pluginHookAlreadyRegisteredMessage, providerAlreadyRegisteredMessage, providerIconRefusalMessage, providerWithoutBridgeMessage, publishRpcMethod, readRpcPublicationOptions, registerSettingDescriptors, runPluginStorageMigrations, storePluginHook, summarizeStandardIssues, undeclaredIconProblem, validateBackgroundServiceRegistration, validatePluginAiServiceDeclaration, validatePluginEnvironmentProviderDeclaration, validatePluginMachineProviderDeclaration, validatePluginProviderDeclaration, validatePluginProviderEnvEntries, validateProviderEnvContribution, validateRpcValue, validateScheduleRegistration, validateServerAccessProviderDeclaration, validateSettingsUpdate };
+export type { NormalizedPluginAiService, NormalizedPluginEnvironmentComposition, NormalizedPluginEnvironmentProvider, NormalizedPluginEnvironmentProviderRequirements, NormalizedPluginInteractionRequest, NormalizedPluginMachineProvider, NormalizedPluginProviderDeclaration };

package/bundled-types/bb-plugin-sdk-provider-bridge.d.ts

@@ -1657,6 +1657,7 @@ declare const BRIDGE_JSON_RPC_ERRORS: {
     readonly NO_ACTIVE_TURN: -32001;
     readonly SESSION_NOT_RESTORABLE: -32002;
     readonly FORK_CHECKPOINT_UNSUPPORTED: -32003;
+    readonly MISSING_EXECUTABLE: -32004;
 };
 declare const providerRecoveryHintSchema: z.ZodObject<{
     kind: z.ZodEnum<{

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

@@ -1371,10 +1371,8 @@ interface CreateFakePluginHostOptions {
     sharedPortTunnelIdentities?: Record<string, PluginSharedPortTunnelIdentity>;
     /**
      * Whether the plugin's manifest declares a `bb.host` entry. Production
-     * refuses `bb.providers.register` (the provider would have no bridge to
-     * run on) and `experimental_aiServices.register` (the service would have
-     * nothing to run on) without one; the fake applies the same rules.
-     * Defaults to true.
+     * refuses `bb.providers.register` without one (the provider would have no
+     * bridge to run on); the fake applies the same rule. Defaults to true.
      */
     experimental_hostEntry?: boolean;
     /**