@get-bb/plugin-sdk 0.4.94 → 0.4.99

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

@@ -192,6 +192,7 @@ declare const promptInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             }>;
             trigger: z.ZodEnum<{
                 "/": "/";
+                $: "$";
             }>;
         }, z.core.$strip>, z.ZodObject<{
             icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -250,10 +251,15 @@ declare const providerInfoSchema: z.ZodObject<{
         supportsThreadArchive: z.ZodBoolean;
         supportsThreadRename: z.ZodBoolean;
     }, z.core.$strip>;
+    completedTurnDisplay: z.ZodEnum<{
+        collapse: "collapse";
+        flat: "flat";
+    }>;
     composerActions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"skills">;
         trigger: z.ZodEnum<{
             "/": "/";
+            $: "$";
         }>;
     }, z.core.$strip>, z.ZodObject<{
         command: z.ZodObject<{
@@ -261,6 +267,7 @@ declare const providerInfoSchema: z.ZodObject<{
             trailingText: z.ZodString;
             trigger: z.ZodEnum<{
                 "/": "/";
+                $: "$";
             }>;
         }, z.core.$strip>;
         kind: z.ZodLiteral<"plan">;
@@ -270,6 +277,7 @@ declare const providerInfoSchema: z.ZodObject<{
             trailingText: z.ZodString;
             trigger: z.ZodEnum<{
                 "/": "/";
+                $: "$";
             }>;
         }, z.core.$strip>;
         kind: z.ZodLiteral<"goal">;
@@ -575,6 +583,34 @@ interface PluginThreadHeaderActionProps {
      */
     isCompactViewport: boolean;
 }
+/** JavaScript world a Browser page expression runs in. */
+type ExperimentalPluginBrowserPageWorld = "isolated" | "main";
+interface ExperimentalPluginBrowserPageEvaluateOptions {
+    /**
+     * `isolated` (default) runs in a BB-owned world that shares the page DOM but
+     * not page globals, and binds `bb.postMessage(data)`. `main` runs beside the
+     * page's own scripts, where `bb` is `null`.
+     */
+    world?: ExperimentalPluginBrowserPageWorld;
+}
+/**
+ * Script access to the top-level document of one Browser tab. Independent of
+ * CDP control leases: it never attaches a debugger or shows a control banner.
+ */
+interface ExperimentalPluginBrowserPage {
+    /**
+     * Evaluate a JavaScript expression and resolve its JSON-serialized value.
+     * Promises are awaited and `undefined` resolves to `null`. The expression
+     * can reference `bb`. Rejects when the tab is gone or the expression throws.
+     * Anything the expression installs is lost when the document navigates.
+     */
+    evaluate(expression: string, options?: ExperimentalPluginBrowserPageEvaluateOptions): Promise<JsonValue$1>;
+    /**
+     * Subscribe to values this plugin's isolated-world scripts in this tab send
+     * with `bb.postMessage(data)`. Returns the unsubscribe function.
+     */
+    onMessage(listener: (data: JsonValue$1) => void): () => void;
+}
 interface ExperimentalPluginBrowserToolbarActionProps {
     /** Thread that owns the Browser tab. */
     threadId: string;
@@ -584,6 +620,8 @@ interface ExperimentalPluginBrowserToolbarActionProps {
     url: string;
     /** True when the Browser chrome needs compact controls. */
     isCompactViewport: boolean;
+    /** Script access to this tab's page; `null` outside the desktop app. */
+    experimental_page: ExperimentalPluginBrowserPage | null;
 }
 /**
  * Where a file being opened by a `fileOpener` lives. `path` semantics follow
@@ -2174,6 +2212,13 @@ interface PluginComposerApi {
      * content should be fetched fresh when the message is sent.
      */
     insertMention(mention: PluginComposerMention): void;
+    /** Remove this plugin's matching mention pills and their text from the current draft. */
+    experimental_removeMention(mention: {
+        provider: string;
+        id: string;
+    }): void;
+    /** Subscribe to successful local submissions in this composer scope, including accepted queued messages. Failed sends and draft clearing do not notify. Dispose on unmount. */
+    experimental_onSubmitted(listener: () => void): () => void;
     /** Focus the composer caret at the end of the draft. */
     focus(): void;
     /**
@@ -2528,7 +2573,13 @@ interface NewThreadComposerProps {
      *   the original `default` submission would have created from.
      */
     defaultEnvironment?: CreateThreadEnvironmentArgs;
-    /** Seeds the draft, only while the draft is still empty. */
+    /**
+     * Seeds the draft, only while the draft is still empty. Serialized
+     * `@thread:<id>`, `@project:<id>`, and `@section:<id>` tokens become mention
+     * pills with host-resolved titles/names. Missing projects/sections use their
+     * IDs; unavailable generated thread IDs use "Unavailable thread" ("Thread"
+     * if lookup fails). Other unknown thread IDs use the ID as their label.
+     */
     initialPrompt?: string;
     placeholder?: string;
     /**
@@ -2663,7 +2714,8 @@ interface BbNavigate {
     }): void;
     /**
      * Navigate to the root compose surface (the new-thread screen). Pass
-     * `initialPrompt` to seed the composer draft and `focusPrompt` to focus the
+     * `initialPrompt` to seed the composer draft (serialized thread, project,
+     * and section mention tokens become pills) and `focusPrompt` to focus the
      * composer on arrival — the pairing behind "Create via chat" style entry
      * points that drop the user into chat with a prefilled prompt.
      */
@@ -2879,4 +2931,4 @@ declare const experimental_useProviders: () => PluginProvidersState;
 declare const experimental_useCodeTheme: () => PluginCodeThemeState;
 
 export { Markdown, ThreadChat, UrlLink, definePluginApp, experimental_BranchPicker, experimental_Diff, experimental_FileLink, experimental_Icon, experimental_NewThreadComposer, experimental_PermissionModePicker, experimental_ProviderIcon, experimental_ProviderModelPicker, experimental_SourceCode, experimental_useAppPanel, experimental_useBranches, experimental_useCheckoutState, experimental_useCodeTheme, experimental_useFixedTabTarget, experimental_useProviders, experimental_useSidebarThreadActions, experimental_useSidebarThreadPullRequest, experimental_useSidebarThreadSplit, experimental_useSidebarThreads, useBbContext, useBbNavigate, useComposer, useComposerView, useRealtime, useRealtimeConnectionState, useRpc, useSettings };
-export type { BbContext, BbNavigate, BranchPickerProps, BranchesState, CheckoutState, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppIcons, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSubmitOptions, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalIconProps, ExperimentalIconRegistration, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginBrowserToolbarActionProps, ExperimentalPluginBrowserToolbarActionRegistration, ExperimentalPluginFixedTabReference, ExperimentalProviderIconProps, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalSidebarFooter, ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterActionRegistration, ExperimentalSidebarFooterDisclosureController, ExperimentalSidebarFooterDisclosureProps, ExperimentalSidebarFooterDisclosureRegistration, ExperimentalSidebarFooterItemBase, ExperimentalSidebarFooterItemRegistration, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, JsonValue$1 as JsonValue, MarkdownProps, NewThreadComposerProps, NewThreadRequest, PluginAppBuilder, PluginAppCommands, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandContext, PluginCommandPaletteActionContext, PluginCommandPaletteActionRegistration, PluginCommandRegistration, PluginCommandShortcut, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, 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, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginTargetedPanelActionOpenOptions, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, ReadonlyJsonValue, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps, UseBranchesArgs, UseCheckoutStateArgs };
+export type { BbContext, BbNavigate, BranchPickerProps, BranchesState, CheckoutState, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppIcons, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, 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, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, JsonValue$1 as JsonValue, MarkdownProps, NewThreadComposerProps, NewThreadRequest, PluginAppBuilder, PluginAppCommands, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandContext, PluginCommandPaletteActionContext, PluginCommandPaletteActionRegistration, PluginCommandRegistration, PluginCommandShortcut, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, 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, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginTargetedPanelActionOpenOptions, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, 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-environment-provider.d.ts

@@ -143,6 +143,7 @@ declare const threadResponseSchema: z.ZodObject<{
     id: z.ZodString;
     lastReadAt: z.ZodNullable<z.ZodNumber>;
     latestAttentionAt: z.ZodNumber;
+    lifecycleOwnerThreadId: z.ZodNullable<z.ZodString>;
     originKind: z.ZodNullable<z.ZodEnum<{
         fork: "fork";
     }>>;

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

@@ -252,6 +252,7 @@ declare const promptInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             }>;
             trigger: z.ZodEnum<{
                 "/": "/";
+                $: "$";
             }>;
         }, z.core.$strip>, z.ZodObject<{
             icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -344,6 +345,7 @@ declare const threadQueuedMessageSchema: z.ZodObject<{
                 }>;
                 trigger: z.ZodEnum<{
                     "/": "/";
+                    $: "$";
                 }>;
             }, z.core.$strip>, z.ZodObject<{
                 icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -472,6 +474,7 @@ declare const threadResponseSchema: z.ZodObject<{
     id: z.ZodString;
     lastReadAt: z.ZodNullable<z.ZodNumber>;
     latestAttentionAt: z.ZodNumber;
+    lifecycleOwnerThreadId: z.ZodNullable<z.ZodString>;
     originKind: z.ZodNullable<z.ZodEnum<{
         fork: "fork";
     }>>;
@@ -695,7 +698,9 @@ interface PluginMachineProviderDefinition<S extends PluginMachineProviderInputsS
         report: PluginMachineProviderProgress;
         signal: AbortSignal;
     }): Promise<PluginMachineProviderRemoveResult>;
+    /** Idempotent: preserve saved state when compute is already stopped; save and stop any remaining compute, including during reconciliation of a suspended machine. */
     suspend?(context: PluginMachineProviderResourceLifecycleContext): Promise<PluginMachineProviderResourceResult>;
+    /** Idempotent: reuse existing running compute instead of allocating a duplicate. */
     resume?(context: PluginMachineProviderResourceLifecycleContext): Promise<PluginMachineProviderResourceResult>;
     remove(context: PluginMachineProviderRemoveContext): Promise<PluginMachineProviderRemoveResult>;
 }
@@ -1311,6 +1316,8 @@ interface PluginProviderOptionsContext {
 }
 /** See {@link PluginProviderDeclaration.models}. */
 type PluginProviderModelCatalogScope = "host" | "workspace";
+/** See {@link PluginProviderDeclaration.completedTurnDisplay}. */
+type PluginProviderCompletedTurnDisplay = "collapse" | "flat";
 /**
  * One cold-cache fallback model. The provider's live `model/list` result is
  * the only real model source; this list stands in only while no probe has
@@ -1417,6 +1424,16 @@ interface PluginProviderDeclaration {
     /** Composer actions this provider supports. No duplicates; may be empty
      * (the universal skills typeahead is implicit). */
     composerActions: readonly PluginProviderComposerAction[];
+    /**
+     * How the thread timeline shows this provider's turns once they finish.
+     * `"collapse"` (the default) folds a finished turn's work into one
+     * "Worked for" row and leaves the final answer visible. `"flat"` keeps
+     * every row of a finished turn visible, as it was while the turn ran. This
+     * is only the provider's default: the user can choose either display for
+     * each provider in Settings → Providers or with
+     * `bb settings completed-turns`, and that choice wins.
+     */
+    completedTurnDisplay?: PluginProviderCompletedTurnDisplay;
     /** Provider copy for core surfaces ({@link PluginProviderStrings}). */
     strings?: PluginProviderStrings;
     /** Service tiers this provider accepts, as picker options. Non-empty when
@@ -1705,6 +1722,7 @@ type NormalizedPluginProviderDeclaration = Omit<PluginProviderDeclaration, "expe
     readonly experimental_nativeSkillRoots?: ProviderNativeRoots;
     readonly experimental_nativeCommandRoots?: ProviderNativeRoots;
     readonly experimental_resolvesNativeRoots: boolean;
+    readonly completedTurnDisplay: PluginProviderCompletedTurnDisplay;
     readonly maintenance: {
         readonly health: boolean;
         readonly usage: boolean;

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

@@ -76,7 +76,9 @@ interface PluginMachineProviderDefinition<S extends PluginMachineProviderInputsS
         report: PluginMachineProviderProgress;
         signal: AbortSignal;
     }): Promise<PluginMachineProviderRemoveResult>;
+    /** Idempotent: preserve saved state when compute is already stopped; save and stop any remaining compute, including during reconciliation of a suspended machine. */
     suspend?(context: PluginMachineProviderResourceLifecycleContext): Promise<PluginMachineProviderResourceResult>;
+    /** Idempotent: reuse existing running compute instead of allocating a duplicate. */
     resume?(context: PluginMachineProviderResourceLifecycleContext): Promise<PluginMachineProviderResourceResult>;
     remove(context: PluginMachineProviderRemoveContext): Promise<PluginMachineProviderRemoveResult>;
 }

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

@@ -3286,6 +3286,7 @@ declare const threadEventSchema: z.ZodPipe<z.ZodUnknown, z.ZodUnion<readonly [z.
             core: z.ZodEnum<{
                 "machine-environment": "machine-environment";
                 "machine-git": "machine-git";
+                "project-environment": "project-environment";
             }>;
         }, z.core.$strict>]>;
         value: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
@@ -3445,6 +3446,7 @@ declare const threadEventSchema: z.ZodPipe<z.ZodUnknown, z.ZodUnion<readonly [z.
                 }>;
                 trigger: z.ZodEnum<{
                     "/": "/";
+                    $: "$";
                 }>;
             }, z.core.$strip>, z.ZodObject<{
                 icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -3526,6 +3528,7 @@ declare const threadEventSchema: z.ZodPipe<z.ZodUnknown, z.ZodUnion<readonly [z.
                 }>;
                 trigger: z.ZodEnum<{
                     "/": "/";
+                    $: "$";
                 }>;
             }, z.core.$strip>, z.ZodObject<{
                 icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -4065,6 +4068,7 @@ declare const promptInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             }>;
             trigger: z.ZodEnum<{
                 "/": "/";
+                $: "$";
             }>;
         }, z.core.$strip>, z.ZodObject<{
             icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;

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

@@ -1375,6 +1375,7 @@ declare const permissionEscalationSchema: z.ZodEnum<{
 type PermissionEscalation = z.infer<typeof permissionEscalationSchema>;
 declare const promptMentionCommandTriggerSchema: z.ZodEnum<{
     "/": "/";
+    $: "$";
 }>;
 type PromptMentionCommandTrigger = z.infer<typeof promptMentionCommandTriggerSchema>;
 declare const promptInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1421,6 +1422,7 @@ declare const promptInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             }>;
             trigger: z.ZodEnum<{
                 "/": "/";
+                $: "$";
             }>;
         }, z.core.$strip>, z.ZodObject<{
             icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -4538,6 +4540,7 @@ declare const threadStartParamsSchema: z.ZodObject<{
                 }>;
                 trigger: z.ZodEnum<{
                     "/": "/";
+                    $: "$";
                 }>;
             }, z.core.$strip>, z.ZodObject<{
                 icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -4864,6 +4867,7 @@ declare const turnStartParamsSchema: z.ZodObject<{
                 }>;
                 trigger: z.ZodEnum<{
                     "/": "/";
+                    $: "$";
                 }>;
             }, z.core.$strip>, z.ZodObject<{
                 icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -4993,6 +4997,7 @@ declare const turnSteerParamsSchema: z.ZodObject<{
                 }>;
                 trigger: z.ZodEnum<{
                     "/": "/";
+                    $: "$";
                 }>;
             }, z.core.$strip>, z.ZodObject<{
                 icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;

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

@@ -77,7 +77,9 @@ interface PluginMachineProviderDefinition<S extends PluginMachineProviderInputsS
         report: PluginMachineProviderProgress;
         signal: AbortSignal;
     }): Promise<PluginMachineProviderRemoveResult>;
+    /** Idempotent: preserve saved state when compute is already stopped; save and stop any remaining compute, including during reconciliation of a suspended machine. */
     suspend?(context: PluginMachineProviderResourceLifecycleContext): Promise<PluginMachineProviderResourceResult>;
+    /** Idempotent: reuse existing running compute instead of allocating a duplicate. */
     resume?(context: PluginMachineProviderResourceLifecycleContext): Promise<PluginMachineProviderResourceResult>;
     remove(context: PluginMachineProviderRemoveContext): Promise<PluginMachineProviderRemoveResult>;
 }
@@ -272,6 +274,7 @@ declare const threadResponseSchema: z.ZodObject<{
     id: z.ZodString;
     lastReadAt: z.ZodNullable<z.ZodNumber>;
     latestAttentionAt: z.ZodNumber;
+    lifecycleOwnerThreadId: z.ZodNullable<z.ZodString>;
     originKind: z.ZodNullable<z.ZodEnum<{
         fork: "fork";
     }>>;
@@ -701,6 +704,8 @@ interface PluginProviderOptionsContext {
 }
 /** See {@link PluginProviderDeclaration.models}. */
 type PluginProviderModelCatalogScope = "host" | "workspace";
+/** See {@link PluginProviderDeclaration.completedTurnDisplay}. */
+type PluginProviderCompletedTurnDisplay = "collapse" | "flat";
 /**
  * One cold-cache fallback model. The provider's live `model/list` result is
  * the only real model source; this list stands in only while no probe has
@@ -807,6 +812,16 @@ interface PluginProviderDeclaration {
     /** Composer actions this provider supports. No duplicates; may be empty
      * (the universal skills typeahead is implicit). */
     composerActions: readonly PluginProviderComposerAction[];
+    /**
+     * How the thread timeline shows this provider's turns once they finish.
+     * `"collapse"` (the default) folds a finished turn's work into one
+     * "Worked for" row and leaves the final answer visible. `"flat"` keeps
+     * every row of a finished turn visible, as it was while the turn ran. This
+     * is only the provider's default: the user can choose either display for
+     * each provider in Settings → Providers or with
+     * `bb settings completed-turns`, and that choice wins.
+     */
+    completedTurnDisplay?: PluginProviderCompletedTurnDisplay;
     /** Provider copy for core surfaces ({@link PluginProviderStrings}). */
     strings?: PluginProviderStrings;
     /** Service tiers this provider accepts, as picker options. Non-empty when
@@ -920,6 +935,7 @@ type NormalizedPluginProviderDeclaration = Omit<PluginProviderDeclaration, "expe
     readonly experimental_nativeSkillRoots?: ProviderNativeRoots;
     readonly experimental_nativeCommandRoots?: ProviderNativeRoots;
     readonly experimental_resolvesNativeRoots: boolean;
+    readonly completedTurnDisplay: PluginProviderCompletedTurnDisplay;
     readonly maintenance: {
         readonly health: boolean;
         readonly usage: boolean;