@get-bb/plugin-sdk 0.6.9 → 0.6.15

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

@@ -621,6 +621,8 @@ interface PortableOutputChildProcess extends PortableChildProcess {
     stdout: Readable;
     stderr: Readable;
 }
+declare function spawnPortableOutputProcess(request: PortablePipedSpawnRequest): PortableOutputChildProcess;
+
 interface ProcessWithCwd {
     pid: number;
     cwd: string;
@@ -629,12 +631,12 @@ interface KillProcessesWithCwdUnderArgs {
     directory: string;
     graceMs?: number;
 }
+declare function killProcessesWithCwdUnder(args: KillProcessesWithCwdUnderArgs): Promise<ProcessWithCwd[]>;
+
 interface SanitizeInheritedChildProcessEnvArgs {
     env: NodeJS.ProcessEnv;
     shellPath?: string;
 }
-declare function spawnPortableOutputProcess(request: PortablePipedSpawnRequest): PortableOutputChildProcess;
-declare function killProcessesWithCwdUnder(args: KillProcessesWithCwdUnderArgs): Promise<ProcessWithCwd[]>;
 declare function sanitizeInheritedChildProcessEnv(args: SanitizeInheritedChildProcessEnvArgs): NodeJS.ProcessEnv;
 
 export { experimental_defineHostEntry, experimental_filterResolvedNativeRoots, killProcessesWithCwdUnder as experimental_killProcessesWithCwdUnder, experimental_nativeRootsHostContract, experimental_nativeRootsResolveInputSchema, experimental_nativeRootsResolveOutputSchema, experimental_resolveClaudePluginRoots, experimental_resolveVendorPluginRoots, sanitizeInheritedChildProcessEnv as experimental_sanitizeInheritedChildProcessEnv, spawnPortableOutputProcess as experimental_spawnPortableOutputProcess };

package/bundled-types/bb-plugin-sdk-internal-composer-customization-validation.d.ts

@@ -40,6 +40,6 @@ declare function requireUniqueId(kind: string, seen: Set<string>, id: string): v
  * Validate one registration while isolating composer customization failures.
  * The host and test harness inject their own rejection reporters.
  */
-declare function collectComposerCustomization(registration: unknown, seenIds: Set<string>, onRejected: RejectionReporter): ComposerCustomization | null;
+declare function collectComposerCustomization(registration: unknown, seenIds: Set<string>, onRejected: RejectionReporter, seenPopupIds?: Set<string>): ComposerCustomization | null;
 
 export { PLUGIN_SLOT_ID_PATTERN, PLUGIN_TIMELINE_RENDERER_KIND_PATTERN, collectComposerCustomization, normalizePluginThreadRowStatus, requireComponent, requireEnvironmentProviderId, requireMessageDirectiveId, requireNonEmptyString, requireOptionalString, requireProviderId, requireSlotId, requireTimelineRendererKind, requireUniqueId };

package/bundled-types/bb-plugin-sdk-internal-composer-handle.d.ts

@@ -24,10 +24,7 @@ declare const reasoningLevelSchema: z.ZodEnum<{
     xhigh: "xhigh";
 }>;
 type ReasoningLevel = z.infer<typeof reasoningLevelSchema>;
-declare const serviceTierSchema: z.ZodEnum<{
-    default: "default";
-    fast: "fast";
-}>;
+declare const serviceTierSchema: z.ZodString;
 type ServiceTier = z.infer<typeof serviceTierSchema>;
 declare const permissionModeSchema: z.ZodEnum<{
     "accept-edits": "accept-edits";
@@ -50,7 +47,7 @@ declare const createThreadEnvironmentArgsSchema: z.ZodDiscriminatedUnion<[z.ZodO
             baseBranch: z.ZodString;
             kind: z.ZodLiteral<"new">;
         }, z.core.$strict>], "kind">>;
-        path: z.ZodNullable<z.ZodString>;
+        path: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
         type: z.ZodLiteral<"unmanaged">;
     }, z.core.$strip>, z.ZodObject<{
         baseBranch: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -223,6 +220,10 @@ interface PluginComposerMention {
  * text methods log a warning and do nothing.
  */
 interface PluginComposerApi {
+    /** Open this plugin's registered composer popup by popup id in this mounted composer. Returns false for an unavailable, suppressed or out-of-scope popup. */
+    experimental_openPopup(popupId: string): boolean;
+    /** Close this plugin's open popup in this composer and restore editor focus. Returns false if this plugin has no open popup. */
+    experimental_closePopup(): boolean;
     scope: PluginComposerScope;
     /**
      * Stable identity for this composer's draft: the same across remounts and
@@ -346,8 +347,8 @@ interface PluginComposerApi {
      * selection as it stands. The result carries only the fields this composer
      * has, so a missing key means "no such picker here" and a value that
      * differs from the one passed was reconciled (a reasoning level the model
-     * does not support, a permission mode above the machine's ceiling, a model
-     * the provider does not list). A provider the composer does not list is
+     * does not support, a service tier the model does not offer, a permission
+     * mode above the machine's ceiling, a model the provider does not list). A provider the composer does not list is
      * ignored together with the model and reasoning level meant for it, so the
      * stored provider preference never names something the picker could not
      * have chosen. `environment` is absent while the composer
@@ -358,8 +359,8 @@ interface PluginComposerApi {
      * Rejects, with a message safe to show to the user, in a composer with no
      * pickers at all (a queued-message editor, a side chat, a plugin surface
      * mounted outside any composer), when the calling surface is no longer
-     * active, and when a value is not a known reasoning level, service tier or
-     * permission mode.
+     * active, and when a value is not a known reasoning level or permission
+     * mode, or is an empty service tier.
      */
     setSelection(selection: ComposerSelection): Promise<ComposerSelection>;
 }
@@ -384,7 +385,11 @@ interface ComposerSelection {
     model?: string;
     /** Applied only when the composer ends up on the requested provider (or none was requested). */
     reasoningLevel?: ReasoningLevel;
-    /** Ignored by a provider with no service tiers. */
+    /**
+     * A tier id the provider declares (`"default"`, `"fast"`, …). Ignored by a
+     * provider with no service tiers; a tier the selected model does not offer
+     * becomes `"default"`.
+     */
     serviceTier?: ServiceTier;
     permissionMode?: PermissionMode;
 }
@@ -430,6 +435,8 @@ interface ComposerHandleTarget {
     insertAtCursor(value: ComposerDraft$1, block: boolean): boolean;
     isAvailable(): boolean;
     focus(): void;
+    openPopup?(pluginId: string, popupId: string): boolean;
+    closePopup?(pluginId: string): boolean;
     submit?(options: ComposerSubmitOptions$1, pluginSubmission: {
         pluginId: string;
         data: JsonValue$2;

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

@@ -203,10 +203,7 @@ declare const reasoningLevelSchema: z.ZodEnum<{
     xhigh: "xhigh";
 }>;
 type ReasoningLevel = z.infer<typeof reasoningLevelSchema>;
-declare const serviceTierSchema: z.ZodEnum<{
-    default: "default";
-    fast: "fast";
-}>;
+declare const serviceTierSchema: z.ZodString;
 type ServiceTier = z.infer<typeof serviceTierSchema>;
 declare const permissionModeSchema: z.ZodEnum<{
     "accept-edits": "accept-edits";
@@ -447,10 +444,7 @@ declare const threadQueuedMessageSchema: z.ZodObject<{
     }>;
     sendAt: z.ZodNullable<z.ZodNumber>;
     senderThreadId: z.ZodNullable<z.ZodString>;
-    serviceTier: z.ZodEnum<{
-        default: "default";
-        fast: "fast";
-    }>;
+    serviceTier: z.ZodString;
     threadId: z.ZodString;
     updatedAt: z.ZodNumber;
     waitingOn: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1546,8 +1540,10 @@ interface PluginProviderDeclaration {
     /** Provider copy for core surfaces ({@link PluginProviderStrings}). */
     strings?: PluginProviderStrings;
     /** Service tiers this provider accepts, as picker options. Non-empty when
-     * present, unique ids. The coarse `capabilities.supportsServiceTier` stays
-     * until WS2a stabilizes. */
+     * present, unique ids. Ids are open: `"default"` is the provider's standard
+     * tier and every other id is passed to the bridge as `serviceTier`. A
+     * `model/list` entry narrows the list with `supportedServiceTiers`. The
+     * coarse `capabilities.supportsServiceTier` stays until WS2a stabilizes. */
     serviceTiers?: readonly PluginProviderOptionDescriptor[];
     /** Reasoning levels as picker options with labels, beside the coarse
      * `capabilities.reasoningLevels` ladder (ids only). Non-empty when present,
@@ -1900,8 +1896,8 @@ declare function enforcePluginCliOutputLimit(result: Omit<PluginCliExecutionResu
 /**
  * Adopt the value a plugin HTTP route handler returned.
  *
- * Plugin handlers can run in a different realm (jiti-loaded modules, bundled
- * fetch polyfills), so a valid `Response` from a handler can fail
+ * Plugin handlers can run in a different realm (bundled fetch polyfills), so
+ * a valid `Response` from a handler can fail
  * `instanceof Response` in the host (#1661). Both the real host and the fake
  * host accept a structurally valid Response from any realm and re-wrap it
  * into a this-realm `Response`, so Hono always consumes a native object and a

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

@@ -6,7 +6,7 @@
 // and read the real source: https://github.com/get-bb/bb
 
 import { z } from 'zod';
-import { ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterItemRegistration, PluginHomepageSectionRegistration, PluginSettingsSectionRegistration, ExperimentalAppOverlayRegistration, PluginNavPanelRegistration, PluginThreadPanelActionRegistration, PluginNewThreadPanelActionRegistration, ComposerCustomization, PluginPendingInteractionRegistration, PluginSidebarFooterActionRegistration, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarHeaderRegistration, PluginThreadListRegistration, PluginThreadHeaderActionRegistration, ExperimentalPluginBrowserToolbarActionRegistration, PluginFileOpenerRegistration, PluginSourceCodeRendererRegistration, PluginDiffRendererRegistration, PluginMessageDirectiveRegistration, PluginMessageActionRegistration, PluginCommandRegistration, PluginProviderIconRegistration, ExperimentalIconRegistration, PluginTimelineRendererRegistration, PluginEnvironmentProviderInputsRegistration, PluginMachineProviderInputsRegistration, PluginContentScriptRegistration, PluginAppDefinition } from '@get-bb/plugin-sdk';
+import { ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterItemRegistration, PluginHomepageSectionRegistration, PluginSettingsSectionRegistration, ExperimentalAppOverlayRegistration, PluginNavPanelRegistration, PluginThreadPanelActionRegistration, PluginNewThreadPanelActionRegistration, ComposerCustomization, PluginPendingInteractionRegistration, PluginSidebarFooterActionRegistration, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarHeaderRegistration, PluginThreadListRegistration, PluginThreadHeaderActionRegistration, ExperimentalPluginBrowserToolbarActionRegistration, PluginFileOpenerRegistration, PluginSourceCodeRendererRegistration, PluginDiffRendererRegistration, PluginMessageDirectiveRegistration, PluginMessageActionRegistration, PluginCommandRegistration, ExperimentalComposerCommandRegistration, PluginProviderIconRegistration, ExperimentalIconRegistration, PluginTimelineRendererRegistration, PluginEnvironmentProviderInputsRegistration, PluginMachineProviderInputsRegistration, PluginContentScriptRegistration, PluginAppDefinition } from '@get-bb/plugin-sdk';
 
 type ExperimentalSidebarFooterCommandKind = "close" | "open" | "toggle";
 interface ExperimentalSidebarFooterRuntimeSnapshot {
@@ -49,9 +49,14 @@ declare const commandShortcutSchema: z.ZodObject<{
     mod: z.ZodDefault<z.ZodBoolean>;
     shift: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strict>;
-interface CollectedPluginCommandRegistration extends Omit<PluginCommandRegistration, "defaultShortcut"> {
-    defaultShortcut: z.infer<typeof commandShortcutSchema> | null;
-}
+type CollectedCommandShortcut = z.infer<typeof commandShortcutSchema> | null;
+type CollectedPluginCommandRegistration = (Omit<PluginCommandRegistration, "defaultShortcut"> & {
+    target: "app";
+    defaultShortcut: CollectedCommandShortcut;
+}) | (Omit<ExperimentalComposerCommandRegistration, "defaultShortcut"> & {
+    target: "composer";
+    defaultShortcut: CollectedCommandShortcut;
+});
 interface CollectedPluginAppRegistrations {
     homepageSections: PluginHomepageSectionRegistration[];
     settingsSections: PluginSettingsSectionRegistration[];

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

@@ -23,10 +23,7 @@ declare const reasoningLevelSchema: z.ZodEnum<{
     xhigh: "xhigh";
 }>;
 type ReasoningLevel = z.infer<typeof reasoningLevelSchema>;
-declare const serviceTierSchema: z.ZodEnum<{
-    default: "default";
-    fast: "fast";
-}>;
+declare const serviceTierSchema: z.ZodString;
 type ServiceTier = z.infer<typeof serviceTierSchema>;
 
 declare const availableModelSchema: z.ZodObject<{
@@ -59,6 +56,11 @@ declare const availableModelSchema: z.ZodObject<{
             xhigh: "xhigh";
         }>;
     }, z.core.$strip>>;
+    supportedServiceTiers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 type AvailableModel = z.infer<typeof availableModelSchema>;
 

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

@@ -3387,10 +3387,7 @@ declare const threadEventSchema: z.ZodUnion<readonly [z.ZodIntersection<z.ZodDis
             xhigh: "xhigh";
         }>;
         seq: z.ZodOptional<z.ZodNumber>;
-        serviceTier: z.ZodEnum<{
-            default: "default";
-            fast: "fast";
-        }>;
+        serviceTier: z.ZodString;
         source: z.ZodEnum<{
             "client/thread/start": "client/thread/start";
             "client/turn/requested": "client/turn/requested";

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

@@ -7,6 +7,7 @@
 
 import { z } from 'zod';
 import { Writable, Readable } from 'node:stream';
+import { StdioOptions, ChildProcess } from 'node:child_process';
 
 declare const contextEntrySchema: z.ZodObject<{
     id: z.ZodString;
@@ -1380,10 +1381,7 @@ declare const reasoningLevelSchema: z.ZodEnum<{
     xhigh: "xhigh";
 }>;
 type ReasoningLevel = z.infer<typeof reasoningLevelSchema>;
-declare const serviceTierSchema: z.ZodEnum<{
-    default: "default";
-    fast: "fast";
-}>;
+declare const serviceTierSchema: z.ZodString;
 type ServiceTier = z.infer<typeof serviceTierSchema>;
 declare const instructionModeValues: readonly ["append", "replace"];
 declare const instructionModeSchema: z.ZodEnum<{
@@ -1548,6 +1546,12 @@ declare const modelReasoningEffortSchema: z.ZodObject<{
     }>;
 }, z.core.$strip>;
 type ModelReasoningEffort = z.infer<typeof modelReasoningEffortSchema>;
+declare const modelServiceTierSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ModelServiceTier = z.infer<typeof modelServiceTierSchema>;
 declare const availableModelSchema: z.ZodObject<{
     defaultReasoningEffort: z.ZodEnum<{
         high: "high";
@@ -1578,6 +1582,11 @@ declare const availableModelSchema: z.ZodObject<{
             xhigh: "xhigh";
         }>;
     }, z.core.$strip>>;
+    supportedServiceTiers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 type AvailableModel = z.infer<typeof availableModelSchema>;
 declare const providerRecoveryKindValues: readonly ["sessionArchived", "authRequired", "restartRecommended", "staleTurn", "rateLimited"];
@@ -4296,7 +4305,10 @@ declare function npmGlobalInstallSource(args: {
     npmBin: string | null;
 }): ProviderInstallationSource;
 declare function installationVerification(status: Pick<ProviderInstallationStatus, "currentVersion" | "latestVersion">, action: "install" | "update"): ProviderInstallationVerification;
-declare function downloadedInstallerCommand(url: string): ProviderInstallationCommand;
+declare function downloadedInstallerCommand(url: string, options?: {
+    platform?: NodeJS.Platform;
+    powershellUrl?: string;
+}): ProviderInstallationCommand;
 declare function clampPercent(value: number): number;
 
 type JsonRpcObject = Record<string, unknown>;
@@ -4444,10 +4456,7 @@ declare const bridgeExecutionOptionsSchema: z.ZodIntersection<z.ZodObject<{
         ultracode: "ultracode";
         xhigh: "xhigh";
     }>>;
-    serviceTier: z.ZodOptional<z.ZodEnum<{
-        default: "default";
-        fast: "fast";
-    }>>;
+    serviceTier: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
     approvalReviewer: z.ZodLiteral<"user">;
     permissionEscalation: z.ZodEnum<{
@@ -4630,10 +4639,7 @@ declare const threadStartParamsSchema: z.ZodObject<{
             ultracode: "ultracode";
             xhigh: "xhigh";
         }>>;
-        serviceTier: z.ZodOptional<z.ZodEnum<{
-            default: "default";
-            fast: "fast";
-        }>>;
+        serviceTier: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
         approvalReviewer: z.ZodLiteral<"user">;
         permissionEscalation: z.ZodEnum<{
@@ -4711,10 +4717,7 @@ declare const threadResumeParamsSchema: z.ZodObject<{
             ultracode: "ultracode";
             xhigh: "xhigh";
         }>>;
-        serviceTier: z.ZodOptional<z.ZodEnum<{
-            default: "default";
-            fast: "fast";
-        }>>;
+        serviceTier: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
         approvalReviewer: z.ZodLiteral<"user">;
         permissionEscalation: z.ZodEnum<{
@@ -4793,10 +4796,7 @@ declare const threadForkParamsSchema: z.ZodObject<{
             ultracode: "ultracode";
             xhigh: "xhigh";
         }>>;
-        serviceTier: z.ZodOptional<z.ZodEnum<{
-            default: "default";
-            fast: "fast";
-        }>>;
+        serviceTier: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
         approvalReviewer: z.ZodLiteral<"user">;
         permissionEscalation: z.ZodEnum<{
@@ -4953,10 +4953,7 @@ declare const turnStartParamsSchema: z.ZodObject<{
             ultracode: "ultracode";
             xhigh: "xhigh";
         }>>;
-        serviceTier: z.ZodOptional<z.ZodEnum<{
-            default: "default";
-            fast: "fast";
-        }>>;
+        serviceTier: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
         approvalReviewer: z.ZodLiteral<"user">;
         permissionEscalation: z.ZodEnum<{
@@ -5083,10 +5080,7 @@ declare const turnSteerParamsSchema: z.ZodObject<{
             ultracode: "ultracode";
             xhigh: "xhigh";
         }>>;
-        serviceTier: z.ZodOptional<z.ZodEnum<{
-            default: "default";
-            fast: "fast";
-        }>>;
+        serviceTier: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
         approvalReviewer: z.ZodLiteral<"user">;
         permissionEscalation: z.ZodEnum<{
@@ -5149,6 +5143,19 @@ declare const BRIDGE_INBOUND_REQUEST_METHODS: {
     readonly interactionRequest: "interaction/request";
 };
 
+interface PortableSpawnRequest {
+    command: string;
+    args: string[];
+    cwd?: string;
+    detached?: boolean;
+    env?: NodeJS.ProcessEnv;
+    stdio?: StdioOptions;
+}
+type PortableChildProcess = ChildProcess;
+declare function spawnPortableProcess(request: PortableSpawnRequest): PortableChildProcess;
+
+declare function killPortableProcess(child: ChildProcess, signal: NodeJS.Signals): void;
+
 interface SanitizeInheritedChildProcessEnvArgs {
     env: NodeJS.ProcessEnv;
     shellPath?: string;
@@ -5305,5 +5312,5 @@ declare const claudeTaskToolOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
 }, z.core.$loose>]>;
 type ClaudeTaskToolOutput = z.infer<typeof claudeTaskToolOutputSchema>;
 
-export { BRIDGE_INBOUND_REQUEST_METHODS, BRIDGE_JSON_RPC_ERRORS, BRIDGE_NOTIFICATION_METHODS, BRIDGE_REQUEST_METHODS, HIGH_REASONING_EFFORT, LOCAL_BASH_TASK_TYPE, LOCAL_WORKFLOW_TASK_TYPE, LOW_REASONING_EFFORT, MAX_REASONING_EFFORT, MEDIUM_REASONING_EFFORT, PROVIDER_BRIDGE_EXPORT_NAME, PROVIDER_BRIDGE_PROTOCOL_VERSION, ProviderRequestDecodeError, ProviderResponseEncodeError, THREAD_DELTA_GRAMMAR_V2, THREAD_DELTA_GRAMMAR_V3, THREAD_DELTA_NOTIFICATION_METHOD, ULTRACODE_REASONING_EFFORT, USER_QUESTION_MAX_OPTIONS, USER_QUESTION_MAX_QUESTIONS, XHIGH_REASONING_EFFORT, ZERO_TOKEN_USAGE, acpNativeReasoningSchema, acpPermissionCliSchema, acpReasoningCliSchema, addTokenUsage, approvalInteractionOutcomeSchema, backgroundTaskItemStatus, bashArgsSchema, bridgeCapabilitiesSchema, bridgeErrorDataSchema, bridgeGrammarVersionsSchema, bridgeRequestEnvelopeSchema, bridgeSteerModeSchema, buildShellEnvOverrides, claudeTaskToolNameSchema, claudeTaskToolOutputSchema, contextSnapshotSchema, createBridgeIo, createBridgeLineHandler, createPendingToolCallTracker, createProviderVisibilityMetadata, decodeBridgeJsonRpcResponse, decodeToolCallResponsePayload, deltaBackgroundTaskShapeSchema, deltaDelegationShapeSchema, deltaExtensionShapeSchema, deltaFileChangeSchema, deltaFileReadShapeSchema, deltaItemKeySchema, deltaItemShapeSchema, deltaNoTurnFallbackSchema, deltaOutputChannelSchema, deltaPlanStepsShapeSchema, deltaPresentationSchema, deltaProgressSnapshotSchema, deltaSearchShapeSchema, deltaTextChannelSchema, dynamicToolSchema, errorEnvelopeSchema, BridgeRecoveryError as experimental_BridgeRecoveryError, COMPACTION_PRESENTATION as experimental_COMPACTION_PRESENTATION, REASONING_PRESENTATION as experimental_REASONING_PRESENTATION, buildBridgeToolCallContent as experimental_buildBridgeToolCallContent, clampPercent as experimental_clampPercent, commandOutput as experimental_commandOutput, compareVersions as experimental_compareVersions, experimental_defineProviderBridge, downloadedInstallerCommand as experimental_downloadedInstallerCommand, fileReadPresentation as experimental_fileReadPresentation, formatCommand as experimental_formatCommand, installationVerification as experimental_installationVerification, experimental_isProviderBridgeRecording, npmCommand as experimental_npmCommand, npmGlobalInstallCommand as experimental_npmGlobalInstallCommand, npmGlobalInstallSource as experimental_npmGlobalInstallSource, npmLatestVersion as experimental_npmLatestVersion, planStepsPresentation as experimental_planStepsPresentation, presentationDetail as experimental_presentationDetail, presentationFileName as experimental_presentationFileName, presentationTitle as experimental_presentationTitle, probeNpmGlobalPackage as experimental_probeNpmGlobalPackage, readBoundedLines as experimental_readBoundedLines, readCliVersion as experimental_readCliVersion, experimental_recordProviderChildIo, resolveExecutablePath as experimental_resolveExecutablePath, searchPresentation as experimental_searchPresentation, toolPresentation as experimental_toolPresentation, versionFrom as experimental_versionFrom, webFetchPresentation as experimental_webFetchPresentation, webSearchPresentation as experimental_webSearchPresentation, withTitle as experimental_withTitle, extensionKindSchema, extractResultText, getRawSdkMessage, getRecordProperty, getStringProperty, acpLaunchSpecSchema as hostDaemonAcpLaunchSpecSchema, initializeParamsSchema, instructionModeValues, interactionRequestPayloadSchema, isApprovalInteractionOutcome, isApprovalPendingInteractionPayload, isApprovalPendingInteractionResolution, isBackgroundAgentTaskType, isExtensionKind, isRecord, isSettledBackgroundTaskStatus, isStandaloneBuiltinCompactCommand, isUserQuestionPendingInteractionPayload, isUserQuestionPendingInteractionResolution, jsonRpcEnvelopeSchema, jsonValueSchema, mimeTypeFromExtension, modelListParamsSchema, normalizeAcpLaunchSpec as normalizeHostDaemonAcpLaunchSpec, normalizeProviderCommandOutput, pendingInteractionCommandActionSchema, pendingInteractionFileSystemPermissionsSchema, pendingInteractionMacOsPermissionsSchema, pendingInteractionNetworkPermissionsSchema, pendingInteractionRequestedPermissionProfileSchema, pendingInteractionResolutionSchema, permissionEscalationValues, providerHealthResultSchema, providerHealthSchema, providerInstallationActionKindSchema, providerInstallationActionSchema, providerInstallationCommandSchema, providerInstallationRequirementSchema, providerInstallationRunParamsSchema, providerInstallationRunResultSchema, providerInstallationSourceSchema, providerInstallationStatusParamsSchema, providerInstallationStatusSchema, providerInstallationVerificationSchema, providerInteractionOutcomeSchema, providerMaintenanceParamsSchema, providerRawEventSchema, providerRecoveryHintSchema, providerRecoveryKindSchema, providerRecoveryKindValues, providerRecoveryNotificationSchema, providerUsageResultSchema, providerUsageSchema, providerUsageWindowSchema, reasoningEffortsForLevels, reasoningLevelSchema, reasoningLevelValues, removeCommandMentionsFromPromptInput, runBridgeRequest, runtimePermissionScopeValues, sanitizeInheritedChildProcessEnv, sdkMessageEnvelopeSchema, shouldAutoDenyInteractiveRequest, skillsConfigureParamsSchema, textBlockSchema, threadArchiveParamsSchema, threadContextWindowUsageEnvelopeSchema, threadDeltaNotificationParamsSchema, threadDeltaSchema, threadDiscardParamsSchema, threadEventItemPresentationSchema, threadEventSearchModeSchema, threadForkParamsSchema, threadGoalClearParamsSchema, threadIdentityEnvelopeSchema, threadNameSetParamsSchema, threadResumeParamsSchema, threadStartParamsSchema, threadStopParamsSchema, threadUnarchiveParamsSchema, toNonNegativeNumber, toOptionalRecord, toOptionalString, toPositiveNumber, turnStartParamsSchema, turnSteerParamsSchema, userQuestionInteractionOutcomeSchema, withoutBridgeRuntimeEnv };
-export type { ApprovalInteractionOutcome, ApprovalPendingInteractionPayload, AvailableModel, BackgroundTaskStatus, BackgroundTaskUsage, BoundedLineReaderArgs, BridgeCapabilities, BridgeErrorData, BridgeExecutionOptions, BridgeGrammarVersions, BridgeJsonRpcResponse, BridgeSendError, BridgeSteerMode, BridgeToolCallRequest, BuildInteractiveResponseArgs, ClaudeTaskToolOutput, ClientTurnRequestId, ContextCategory, ContextEntry, ContextSnapshot, DecodedInteractiveRequest, DeltaBackgroundTaskShape, DeltaDelegationShape, DeltaExtensionShape, DeltaFileChange, DeltaFileReadShape, DeltaItemKey, DeltaItemShape, DeltaItemShapeType, DeltaNoTurnFallback, DeltaOutputChannel, DeltaPlanStepsShape, DeltaPresentation, DeltaProgressSnapshot, DeltaSearchShape, DeltaTextChannel, DynamicTool, ExtensionKind, AcpLaunchSpec as HostDaemonAcpLaunchSpec, InitializeResult, InstructionMode, InteractionRequestPayload, JsonObject, JsonRpcMessage, JsonValue, ModelReasoningEffort, NpmGlobalPackageProbe, PendingInteractionApprovalDecision, PendingInteractionApprovalSubject, PendingInteractionCommandAction, PendingInteractionGrantablePermissionProfile, PendingInteractionGrantedPermissionProfile, PendingInteractionPayload, PendingInteractionRequestedPermissionProfile, PendingInteractionResolution, PendingInteractionUserQuestionQuestion, PermissionEscalation, PermissionMode, PreparedProviderCommandDispatch, PromptInput, ProviderBridgeContext, ProviderBridgeDefinition, ProviderBridgeEntry, ProviderErrorCategory, ProviderErrorInfo, ProviderHealth, ProviderHealthResult, ProviderInboundRequest, ProviderInstallationAction, ProviderInstallationActionKind, ProviderInstallationCommand, ProviderInstallationRequirement, ProviderInstallationRunParams, ProviderInstallationRunResult, ProviderInstallationSource, ProviderInstallationStatus, ProviderInstallationStatusParams, ProviderInstallationVerification, ProviderInteractionOutcome, ProviderMaintenanceParams, ProviderPostInitializeRequest, ProviderRateLimitState, ProviderRateLimitStatus, ProviderRateLimitWindow, ProviderRawEvent, ProviderRawEventCoverage, ProviderRawEventDescription, ProviderRecoveryHint, ProviderRecoveryKind, ProviderRecoveryNotification, ProviderRuntimeEvent, ProviderUsage, ProviderUsageResult, ProviderUsageWindow, ProviderVisibilityMetadata, ReasoningLevel, RuntimePermissionPolicy, RuntimePermissionScope, ServiceTier, ThreadDelta, ThreadDeltaKind, ThreadDeltaNotificationParams, ThreadEventContextWindowUsage, ThreadEventItemPresentation, ThreadEventItemStatus, ThreadEventPlanStep, ThreadEventSearchMode, ThreadEventTokenUsageBreakdown, ThreadEventTurnStatus, ThreadEventUserContent, UserQuestionInteractionOutcome, UserQuestionPendingInteractionPayload, UserQuestionPendingInteractionResolution, WorkflowAgentSnapshot, WorkflowAgentState, WorkflowPhaseSnapshot, WorkflowProgressSnapshot };
+export { BRIDGE_INBOUND_REQUEST_METHODS, BRIDGE_JSON_RPC_ERRORS, BRIDGE_NOTIFICATION_METHODS, BRIDGE_REQUEST_METHODS, HIGH_REASONING_EFFORT, LOCAL_BASH_TASK_TYPE, LOCAL_WORKFLOW_TASK_TYPE, LOW_REASONING_EFFORT, MAX_REASONING_EFFORT, MEDIUM_REASONING_EFFORT, PROVIDER_BRIDGE_EXPORT_NAME, PROVIDER_BRIDGE_PROTOCOL_VERSION, ProviderRequestDecodeError, ProviderResponseEncodeError, THREAD_DELTA_GRAMMAR_V2, THREAD_DELTA_GRAMMAR_V3, THREAD_DELTA_NOTIFICATION_METHOD, ULTRACODE_REASONING_EFFORT, USER_QUESTION_MAX_OPTIONS, USER_QUESTION_MAX_QUESTIONS, XHIGH_REASONING_EFFORT, ZERO_TOKEN_USAGE, acpNativeReasoningSchema, acpPermissionCliSchema, acpReasoningCliSchema, addTokenUsage, approvalInteractionOutcomeSchema, backgroundTaskItemStatus, bashArgsSchema, bridgeCapabilitiesSchema, bridgeErrorDataSchema, bridgeGrammarVersionsSchema, bridgeRequestEnvelopeSchema, bridgeSteerModeSchema, buildShellEnvOverrides, claudeTaskToolNameSchema, claudeTaskToolOutputSchema, contextSnapshotSchema, createBridgeIo, createBridgeLineHandler, createPendingToolCallTracker, createProviderVisibilityMetadata, decodeBridgeJsonRpcResponse, decodeToolCallResponsePayload, deltaBackgroundTaskShapeSchema, deltaDelegationShapeSchema, deltaExtensionShapeSchema, deltaFileChangeSchema, deltaFileReadShapeSchema, deltaItemKeySchema, deltaItemShapeSchema, deltaNoTurnFallbackSchema, deltaOutputChannelSchema, deltaPlanStepsShapeSchema, deltaPresentationSchema, deltaProgressSnapshotSchema, deltaSearchShapeSchema, deltaTextChannelSchema, dynamicToolSchema, errorEnvelopeSchema, BridgeRecoveryError as experimental_BridgeRecoveryError, COMPACTION_PRESENTATION as experimental_COMPACTION_PRESENTATION, REASONING_PRESENTATION as experimental_REASONING_PRESENTATION, buildBridgeToolCallContent as experimental_buildBridgeToolCallContent, clampPercent as experimental_clampPercent, commandOutput as experimental_commandOutput, compareVersions as experimental_compareVersions, experimental_defineProviderBridge, downloadedInstallerCommand as experimental_downloadedInstallerCommand, fileReadPresentation as experimental_fileReadPresentation, formatCommand as experimental_formatCommand, installationVerification as experimental_installationVerification, experimental_isProviderBridgeRecording, killPortableProcess as experimental_killPortableProcess, npmCommand as experimental_npmCommand, npmGlobalInstallCommand as experimental_npmGlobalInstallCommand, npmGlobalInstallSource as experimental_npmGlobalInstallSource, npmLatestVersion as experimental_npmLatestVersion, planStepsPresentation as experimental_planStepsPresentation, presentationDetail as experimental_presentationDetail, presentationFileName as experimental_presentationFileName, presentationTitle as experimental_presentationTitle, probeNpmGlobalPackage as experimental_probeNpmGlobalPackage, readBoundedLines as experimental_readBoundedLines, readCliVersion as experimental_readCliVersion, experimental_recordProviderChildIo, resolveExecutablePath as experimental_resolveExecutablePath, searchPresentation as experimental_searchPresentation, spawnPortableProcess as experimental_spawnPortableProcess, toolPresentation as experimental_toolPresentation, versionFrom as experimental_versionFrom, webFetchPresentation as experimental_webFetchPresentation, webSearchPresentation as experimental_webSearchPresentation, withTitle as experimental_withTitle, extensionKindSchema, extractResultText, getRawSdkMessage, getRecordProperty, getStringProperty, acpLaunchSpecSchema as hostDaemonAcpLaunchSpecSchema, initializeParamsSchema, instructionModeValues, interactionRequestPayloadSchema, isApprovalInteractionOutcome, isApprovalPendingInteractionPayload, isApprovalPendingInteractionResolution, isBackgroundAgentTaskType, isExtensionKind, isRecord, isSettledBackgroundTaskStatus, isStandaloneBuiltinCompactCommand, isUserQuestionPendingInteractionPayload, isUserQuestionPendingInteractionResolution, jsonRpcEnvelopeSchema, jsonValueSchema, mimeTypeFromExtension, modelListParamsSchema, normalizeAcpLaunchSpec as normalizeHostDaemonAcpLaunchSpec, normalizeProviderCommandOutput, pendingInteractionCommandActionSchema, pendingInteractionFileSystemPermissionsSchema, pendingInteractionMacOsPermissionsSchema, pendingInteractionNetworkPermissionsSchema, pendingInteractionRequestedPermissionProfileSchema, pendingInteractionResolutionSchema, permissionEscalationValues, providerHealthResultSchema, providerHealthSchema, providerInstallationActionKindSchema, providerInstallationActionSchema, providerInstallationCommandSchema, providerInstallationRequirementSchema, providerInstallationRunParamsSchema, providerInstallationRunResultSchema, providerInstallationSourceSchema, providerInstallationStatusParamsSchema, providerInstallationStatusSchema, providerInstallationVerificationSchema, providerInteractionOutcomeSchema, providerMaintenanceParamsSchema, providerRawEventSchema, providerRecoveryHintSchema, providerRecoveryKindSchema, providerRecoveryKindValues, providerRecoveryNotificationSchema, providerUsageResultSchema, providerUsageSchema, providerUsageWindowSchema, reasoningEffortsForLevels, reasoningLevelSchema, reasoningLevelValues, removeCommandMentionsFromPromptInput, runBridgeRequest, runtimePermissionScopeValues, sanitizeInheritedChildProcessEnv, sdkMessageEnvelopeSchema, shouldAutoDenyInteractiveRequest, skillsConfigureParamsSchema, textBlockSchema, threadArchiveParamsSchema, threadContextWindowUsageEnvelopeSchema, threadDeltaNotificationParamsSchema, threadDeltaSchema, threadDiscardParamsSchema, threadEventItemPresentationSchema, threadEventSearchModeSchema, threadForkParamsSchema, threadGoalClearParamsSchema, threadIdentityEnvelopeSchema, threadNameSetParamsSchema, threadResumeParamsSchema, threadStartParamsSchema, threadStopParamsSchema, threadUnarchiveParamsSchema, toNonNegativeNumber, toOptionalRecord, toOptionalString, toPositiveNumber, turnStartParamsSchema, turnSteerParamsSchema, userQuestionInteractionOutcomeSchema, withoutBridgeRuntimeEnv };
+export type { ApprovalInteractionOutcome, ApprovalPendingInteractionPayload, AvailableModel, BackgroundTaskStatus, BackgroundTaskUsage, BoundedLineReaderArgs, BridgeCapabilities, BridgeErrorData, BridgeExecutionOptions, BridgeGrammarVersions, BridgeJsonRpcResponse, BridgeSendError, BridgeSteerMode, BridgeToolCallRequest, BuildInteractiveResponseArgs, ClaudeTaskToolOutput, ClientTurnRequestId, ContextCategory, ContextEntry, ContextSnapshot, DecodedInteractiveRequest, DeltaBackgroundTaskShape, DeltaDelegationShape, DeltaExtensionShape, DeltaFileChange, DeltaFileReadShape, DeltaItemKey, DeltaItemShape, DeltaItemShapeType, DeltaNoTurnFallback, DeltaOutputChannel, DeltaPlanStepsShape, DeltaPresentation, DeltaProgressSnapshot, DeltaSearchShape, DeltaTextChannel, DynamicTool, ExtensionKind, AcpLaunchSpec as HostDaemonAcpLaunchSpec, InitializeResult, InstructionMode, InteractionRequestPayload, JsonObject, JsonRpcMessage, JsonValue, ModelReasoningEffort, ModelServiceTier, NpmGlobalPackageProbe, PendingInteractionApprovalDecision, PendingInteractionApprovalSubject, PendingInteractionCommandAction, PendingInteractionGrantablePermissionProfile, PendingInteractionGrantedPermissionProfile, PendingInteractionPayload, PendingInteractionRequestedPermissionProfile, PendingInteractionResolution, PendingInteractionUserQuestionQuestion, PermissionEscalation, PermissionMode, PreparedProviderCommandDispatch, PromptInput, ProviderBridgeContext, ProviderBridgeDefinition, ProviderBridgeEntry, ProviderErrorCategory, ProviderErrorInfo, ProviderHealth, ProviderHealthResult, ProviderInboundRequest, ProviderInstallationAction, ProviderInstallationActionKind, ProviderInstallationCommand, ProviderInstallationRequirement, ProviderInstallationRunParams, ProviderInstallationRunResult, ProviderInstallationSource, ProviderInstallationStatus, ProviderInstallationStatusParams, ProviderInstallationVerification, ProviderInteractionOutcome, ProviderMaintenanceParams, ProviderPostInitializeRequest, ProviderRateLimitState, ProviderRateLimitStatus, ProviderRateLimitWindow, ProviderRawEvent, ProviderRawEventCoverage, ProviderRawEventDescription, ProviderRecoveryHint, ProviderRecoveryKind, ProviderRecoveryNotification, ProviderRuntimeEvent, ProviderUsage, ProviderUsageResult, ProviderUsageWindow, ProviderVisibilityMetadata, ReasoningLevel, RuntimePermissionPolicy, RuntimePermissionScope, ServiceTier, ThreadDelta, ThreadDeltaKind, ThreadDeltaNotificationParams, ThreadEventContextWindowUsage, ThreadEventItemPresentation, ThreadEventItemStatus, ThreadEventPlanStep, ThreadEventSearchMode, ThreadEventTokenUsageBreakdown, ThreadEventTurnStatus, ThreadEventUserContent, UserQuestionInteractionOutcome, UserQuestionPendingInteractionPayload, UserQuestionPendingInteractionResolution, WorkflowAgentSnapshot, WorkflowAgentState, WorkflowPhaseSnapshot, WorkflowProgressSnapshot };

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

@@ -842,8 +842,10 @@ interface PluginProviderDeclaration {
     /** Provider copy for core surfaces ({@link PluginProviderStrings}). */
     strings?: PluginProviderStrings;
     /** Service tiers this provider accepts, as picker options. Non-empty when
-     * present, unique ids. The coarse `capabilities.supportsServiceTier` stays
-     * until WS2a stabilizes. */
+     * present, unique ids. Ids are open: `"default"` is the provider's standard
+     * tier and every other id is passed to the bridge as `serviceTier`. A
+     * `model/list` entry narrows the list with `supportedServiceTiers`. The
+     * coarse `capabilities.supportsServiceTier` stays until WS2a stabilizes. */
     serviceTiers?: readonly PluginProviderOptionDescriptor[];
     /** Reasoning levels as picker options with labels, beside the coarse
      * `capabilities.reasoningLevels` ladder (ids only). Non-empty when present,