@get-bb/plugin-sdk 0.5.23 → 0.5.27

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

@@ -211,6 +211,7 @@ declare const appKeybindingOverridesSchema: z$1.ZodArray<z$1.ZodObject<{
         "browser.focusLocation": "browser.focusLocation";
         "browser.reload": "browser.reload";
         "composer.focus": "composer.focus";
+        "dataDirectory.open": "dataDirectory.open";
         "diff.toggle": "diff.toggle";
         "file.quickOpen": "file.quickOpen";
         "logs.openServerDaemon": "logs.openServerDaemon";
@@ -247,6 +248,8 @@ declare const appKeybindingOverridesSchema: z$1.ZodArray<z$1.ZodObject<{
         "panel.previousTab": "panel.previousTab";
         "panel.reopenClosedTab": "panel.reopenClosedTab";
         "panel.toggle": "panel.toggle";
+        "plugins.enterSafeMode": "plugins.enterSafeMode";
+        "plugins.exitSafeMode": "plugins.exitSafeMode";
         "question.select.1": "question.select.1";
         "question.select.2": "question.select.2";
         "question.select.3": "question.select.3";
@@ -475,6 +478,12 @@ declare const environmentSchema: z$1.ZodObject<{
         }, z$1.core.$strip>], "type">;
     }, z$1.core.$strip>>;
     hostId: z$1.ZodString;
+    hostLifecycle: z$1.ZodEnum<{
+        "cleanup-failed": "cleanup-failed";
+        active: "active";
+        removed: "removed";
+        removing: "removing";
+    }>;
     id: z$1.ZodString;
     isGitRepo: z$1.ZodBoolean;
     isWorktree: z$1.ZodBoolean;
@@ -546,6 +555,11 @@ declare const workspaceGitOperationSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObj
 }, z$1.core.$strip>], "kind">;
 type WorkspaceGitOperation = z$1.infer<typeof workspaceGitOperationSchema>;
 
+declare const hostTypeSchema: z$1.ZodEnum<{
+    ephemeral: "ephemeral";
+    persistent: "persistent";
+}>;
+type HostType = z$1.infer<typeof hostTypeSchema>;
 declare const hostSchema: z$1.ZodObject<{
     createdAt: z$1.ZodNumber;
     id: z$1.ZodString;
@@ -3091,6 +3105,7 @@ declare const threadEventSchema: z$1.ZodPipe<z$1.ZodUnknown, z$1.ZodUnion<readon
     cause: z$1.ZodOptional<z$1.ZodLiteral<"host-connection-lost">>;
     reason: z$1.ZodEnum<{
         "host-daemon-restarted": "host-daemon-restarted";
+        "host-removed": "host-removed";
         "manual-stop": "manual-stop";
         "provider-turn-idle": "provider-turn-idle";
     }>;
@@ -9461,6 +9476,15 @@ declare const pluginSettingsResponseSchema: z$1.ZodObject<{
     values: z$1.ZodRecord<z$1.ZodString, z$1.ZodType<JsonValue, unknown, z$1.core.$ZodTypeInternals<JsonValue, unknown>>>;
 }, z$1.core.$strip>;
 type PluginSettingsResponse = z$1.infer<typeof pluginSettingsResponseSchema>;
+declare const pluginSafeModeResponseSchema: z$1.ZodObject<{
+    enabled: z$1.ZodBoolean;
+}, z$1.core.$strip>;
+type PluginSafeModeResponse = z$1.infer<typeof pluginSafeModeResponseSchema>;
+declare const pluginSafeModeUpdateResponseSchema: z$1.ZodObject<{
+    enabled: z$1.ZodBoolean;
+    problems: z$1.ZodArray<z$1.ZodString>;
+}, z$1.core.$strip>;
+type PluginSafeModeUpdateResponse = z$1.infer<typeof pluginSafeModeUpdateResponseSchema>;
 declare const pluginTokenResponseSchema: z$1.ZodObject<{
     ok: z$1.ZodLiteral<true>;
     token: z$1.ZodString;
@@ -9979,6 +10003,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "browser.focusLocation": "browser.focusLocation";
             "browser.reload": "browser.reload";
             "composer.focus": "composer.focus";
+            "dataDirectory.open": "dataDirectory.open";
             "diff.toggle": "diff.toggle";
             "file.quickOpen": "file.quickOpen";
             "logs.openServerDaemon": "logs.openServerDaemon";
@@ -10015,6 +10040,8 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "panel.previousTab": "panel.previousTab";
             "panel.reopenClosedTab": "panel.reopenClosedTab";
             "panel.toggle": "panel.toggle";
+            "plugins.enterSafeMode": "plugins.enterSafeMode";
+            "plugins.exitSafeMode": "plugins.exitSafeMode";
             "question.select.1": "question.select.1";
             "question.select.2": "question.select.2";
             "question.select.3": "question.select.3";
@@ -10121,6 +10148,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "browser.focusLocation": "browser.focusLocation";
             "browser.reload": "browser.reload";
             "composer.focus": "composer.focus";
+            "dataDirectory.open": "dataDirectory.open";
             "diff.toggle": "diff.toggle";
             "file.quickOpen": "file.quickOpen";
             "logs.openServerDaemon": "logs.openServerDaemon";
@@ -10157,6 +10185,8 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "panel.previousTab": "panel.previousTab";
             "panel.reopenClosedTab": "panel.reopenClosedTab";
             "panel.toggle": "panel.toggle";
+            "plugins.enterSafeMode": "plugins.enterSafeMode";
+            "plugins.exitSafeMode": "plugins.exitSafeMode";
             "question.select.1": "question.select.1";
             "question.select.2": "question.select.2";
             "question.select.3": "question.select.3";
@@ -10205,6 +10235,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "browser.focusLocation": "browser.focusLocation";
             "browser.reload": "browser.reload";
             "composer.focus": "composer.focus";
+            "dataDirectory.open": "dataDirectory.open";
             "diff.toggle": "diff.toggle";
             "file.quickOpen": "file.quickOpen";
             "logs.openServerDaemon": "logs.openServerDaemon";
@@ -10241,6 +10272,8 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "panel.previousTab": "panel.previousTab";
             "panel.reopenClosedTab": "panel.reopenClosedTab";
             "panel.toggle": "panel.toggle";
+            "plugins.enterSafeMode": "plugins.enterSafeMode";
+            "plugins.exitSafeMode": "plugins.exitSafeMode";
             "question.select.1": "question.select.1";
             "question.select.2": "question.select.2";
             "question.select.3": "question.select.3";
@@ -13516,6 +13549,12 @@ declare const threadWithIncludesResponseSchema: z$1.ZodObject<{
             }, z$1.core.$strip>], "type">;
         }, z$1.core.$strip>>;
         hostId: z$1.ZodString;
+        hostLifecycle: z$1.ZodEnum<{
+            "cleanup-failed": "cleanup-failed";
+            active: "active";
+            removed: "removed";
+            removing: "removing";
+        }>;
         id: z$1.ZodString;
         isGitRepo: z$1.ZodBoolean;
         isWorktree: z$1.ZodBoolean;
@@ -13556,6 +13595,7 @@ declare const threadWithIncludesResponseSchema: z$1.ZodObject<{
             unmanaged: "unmanaged";
         }>>;
     }, z$1.core.$strip>>>;
+    environmentHostName: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodString>>;
     environmentId: z$1.ZodNullable<z$1.ZodString>;
     host: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodObject<{
         createdAt: z$1.ZodNumber;
@@ -14169,6 +14209,7 @@ declare const threadListQuerySchema: z$1.ZodObject<{
         false: "false";
         true: "true";
     }>>;
+    hostId: z$1.ZodOptional<z$1.ZodString>;
     includeHidden: z$1.ZodOptional<z$1.ZodEnum<{
         false: "false";
         true: "true";
@@ -15477,6 +15518,7 @@ interface HostProviderCliInstallArgs extends HostProviderCliInstallRequest {
 }
 interface HostListArgs {
     includeCreating?: boolean;
+    type?: HostType;
     signal?: AbortSignal;
 }
 interface MachineCreateArgs extends CreateMachineRequest {
@@ -15817,6 +15859,12 @@ interface PluginListArgs {
 interface PluginListUpdateResultsArgs {
     signal?: AbortSignal;
 }
+interface PluginGetSafeModeArgs {
+    signal?: AbortSignal;
+}
+interface PluginSetSafeModeArgs {
+    enabled: boolean;
+}
 type PluginDisableResult = InstalledPlugin;
 type PluginEnableResult = InstalledPlugin;
 type PluginGetSettingsResult = PluginSettingsResponse;
@@ -15824,6 +15872,8 @@ type PluginInstallResult = InstalledPlugin;
 type PluginListResult = PluginListResponse;
 type PluginReloadResult = PluginReloadResponse;
 type PluginRemoveResult = PluginRemoveResponse;
+type PluginSafeModeResult = PluginSafeModeResponse;
+type PluginSetSafeModeResult = PluginSafeModeUpdateResponse;
 type PluginTokenResult = PluginTokenResponse;
 type PluginUpdateSettingsResult = PluginSettingsResponse;
 type PluginGetSourceResult = PluginSourceDetail;
@@ -15852,6 +15902,8 @@ interface PluginMarketplacesArea {
 }
 interface PluginsArea {
     experimental_discoverRpc(args?: PluginRpcDiscoveryQuery): Promise<PublishedPluginRpcMethod[]>;
+    experimental_getSafeMode(args?: PluginGetSafeModeArgs): Promise<PluginSafeModeResult>;
+    experimental_setSafeMode(args: PluginSetSafeModeArgs): Promise<PluginSetSafeModeResult>;
     applyUpdate(args: PluginIdArgs): Promise<PluginApplyUpdateResult>;
     callRpc<TOutput>(args: PluginRpcArgs<TOutput>): Promise<TOutput>;
     checkUpdates(args?: PluginCheckUpdatesArgs): Promise<PluginCheckUpdatesResult>;
@@ -16255,6 +16307,7 @@ interface TerminalsArea {
 interface ThreadListArgs {
     archived?: boolean;
     environmentId?: string;
+    hostId?: string;
     sectionId?: string;
     hasParent?: boolean;
     includeHidden?: boolean;
@@ -18100,12 +18153,13 @@ interface PluginSidebarThreadSplit {
  * Replace the sidebar's thread list with a plugin component.
  *
  * Unlike every other slot, this one is EXCLUSIVE: two lists cannot share one
- * scroll area. Registering activates the replacement while the plugin is
- * enabled. If multiple plugins register one, the first in deterministic slot
- * order is active by default; removing it reveals the next. The user can pin
- * BB's list or a specific provider under Settings → Appearance. A plugin can
- * also use its own setting and render `Original` conditionally.
- * An absent or crashing replacement falls back to BB's list rather than
+ * scroll area. bb ships its own list as the bundled Thread list plugin
+ * (`thread-list/thread-list`). Registering activates the replacement while the
+ * plugin is enabled: by default the first registered list other than the
+ * bundled one, in deterministic slot order, is active, falling back to the
+ * bundled list; removing it reveals the next. The user can pin a specific
+ * provider, including the bundled one, under Settings → Appearance → Sidebar.
+ * A missing pinned provider or a crashing list shows a placeholder rather than
  * leaving the user with no sidebar.
  *
  * The plugin gets the scrolling list and nothing else. The New-thread button,
@@ -18124,11 +18178,12 @@ interface PluginThreadListRegistration {
 }
 /**
  * Replace the navigation controls above the sidebar thread list. Exclusive:
- * the user picks one provider under Settings → Appearance → Navigation, and
  * bb ships its own rows as the bundled Navigation plugin
- * (`navigation/navigation`, the default). A picked provider that is disabled
- * or removed falls back to Navigation; a crashing provider is replaced by a
- * placeholder with a Reload button.
+ * (`navigation/navigation`). By default the first registered provider other
+ * than Navigation is active, falling back to Navigation; the user can pin one
+ * provider under Settings → Appearance → Navigation. A pinned provider that is
+ * disabled or removed falls back to Navigation; a crashing provider is
+ * replaced by a placeholder with a Reload button.
  */
 interface ExperimentalSidebarNavigationRegistration {
     /** Unique within the plugin; letters, digits, `-`, `_`. */

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

@@ -32,6 +32,12 @@ declare const environmentSchema: z.ZodObject<{
         }, z.core.$strip>], "type">;
     }, z.core.$strip>>;
     hostId: z.ZodString;
+    hostLifecycle: z.ZodEnum<{
+        "cleanup-failed": "cleanup-failed";
+        active: "active";
+        removed: "removed";
+        removing: "removing";
+    }>;
     id: z.ZodString;
     isGitRepo: z.ZodBoolean;
     isWorktree: z.ZodBoolean;

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

@@ -85,6 +85,12 @@ declare const environmentSchema: z.ZodObject<{
         }, z.core.$strip>], "type">;
     }, z.core.$strip>>;
     hostId: z.ZodString;
+    hostLifecycle: z.ZodEnum<{
+        "cleanup-failed": "cleanup-failed";
+        active: "active";
+        removed: "removed";
+        removing: "removing";
+    }>;
     id: z.ZodString;
     isGitRepo: z.ZodBoolean;
     isWorktree: z.ZodBoolean;

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

@@ -3661,6 +3661,7 @@ declare const threadEventSchema: z.ZodPipe<z.ZodUnknown, z.ZodUnion<readonly [z.
     cause: z.ZodOptional<z.ZodLiteral<"host-connection-lost">>;
     reason: z.ZodEnum<{
         "host-daemon-restarted": "host-daemon-restarted";
+        "host-removed": "host-removed";
         "manual-stop": "manual-stop";
         "provider-turn-idle": "provider-turn-idle";
     }>;

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

@@ -160,6 +160,12 @@ declare const environmentSchema: z.ZodObject<{
         }, z.core.$strip>], "type">;
     }, z.core.$strip>>;
     hostId: z.ZodString;
+    hostLifecycle: z.ZodEnum<{
+        "cleanup-failed": "cleanup-failed";
+        active: "active";
+        removed: "removed";
+        removing: "removing";
+    }>;
     id: z.ZodString;
     isGitRepo: z.ZodBoolean;
     isWorktree: z.ZodBoolean;

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

@@ -160,6 +160,7 @@ declare const appKeybindingOverridesSchema: z$1.ZodArray<z$1.ZodObject<{
         "browser.focusLocation": "browser.focusLocation";
         "browser.reload": "browser.reload";
         "composer.focus": "composer.focus";
+        "dataDirectory.open": "dataDirectory.open";
         "diff.toggle": "diff.toggle";
         "file.quickOpen": "file.quickOpen";
         "logs.openServerDaemon": "logs.openServerDaemon";
@@ -196,6 +197,8 @@ declare const appKeybindingOverridesSchema: z$1.ZodArray<z$1.ZodObject<{
         "panel.previousTab": "panel.previousTab";
         "panel.reopenClosedTab": "panel.reopenClosedTab";
         "panel.toggle": "panel.toggle";
+        "plugins.enterSafeMode": "plugins.enterSafeMode";
+        "plugins.exitSafeMode": "plugins.exitSafeMode";
         "question.select.1": "question.select.1";
         "question.select.2": "question.select.2";
         "question.select.3": "question.select.3";
@@ -430,6 +433,12 @@ declare const environmentSchema: z$1.ZodObject<{
         }, z$1.core.$strip>], "type">;
     }, z$1.core.$strip>>;
     hostId: z$1.ZodString;
+    hostLifecycle: z$1.ZodEnum<{
+        "cleanup-failed": "cleanup-failed";
+        active: "active";
+        removed: "removed";
+        removing: "removing";
+    }>;
     id: z$1.ZodString;
     isGitRepo: z$1.ZodBoolean;
     isWorktree: z$1.ZodBoolean;
@@ -501,6 +510,11 @@ declare const workspaceGitOperationSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObj
 }, z$1.core.$strip>], "kind">;
 type WorkspaceGitOperation = z$1.infer<typeof workspaceGitOperationSchema>;
 
+declare const hostTypeSchema: z$1.ZodEnum<{
+    ephemeral: "ephemeral";
+    persistent: "persistent";
+}>;
+type HostType = z$1.infer<typeof hostTypeSchema>;
 declare const hostSchema: z$1.ZodObject<{
     createdAt: z$1.ZodNumber;
     id: z$1.ZodString;
@@ -3107,6 +3121,7 @@ declare const threadEventSchema: z$1.ZodPipe<z$1.ZodUnknown, z$1.ZodUnion<readon
     cause: z$1.ZodOptional<z$1.ZodLiteral<"host-connection-lost">>;
     reason: z$1.ZodEnum<{
         "host-daemon-restarted": "host-daemon-restarted";
+        "host-removed": "host-removed";
         "manual-stop": "manual-stop";
         "provider-turn-idle": "provider-turn-idle";
     }>;
@@ -9512,6 +9527,15 @@ declare const pluginSettingsResponseSchema: z$1.ZodObject<{
     values: z$1.ZodRecord<z$1.ZodString, z$1.ZodType<JsonValue$1, unknown, z$1.core.$ZodTypeInternals<JsonValue$1, unknown>>>;
 }, z$1.core.$strip>;
 type PluginSettingsResponse = z$1.infer<typeof pluginSettingsResponseSchema>;
+declare const pluginSafeModeResponseSchema: z$1.ZodObject<{
+    enabled: z$1.ZodBoolean;
+}, z$1.core.$strip>;
+type PluginSafeModeResponse = z$1.infer<typeof pluginSafeModeResponseSchema>;
+declare const pluginSafeModeUpdateResponseSchema: z$1.ZodObject<{
+    enabled: z$1.ZodBoolean;
+    problems: z$1.ZodArray<z$1.ZodString>;
+}, z$1.core.$strip>;
+type PluginSafeModeUpdateResponse = z$1.infer<typeof pluginSafeModeUpdateResponseSchema>;
 declare const pluginTokenResponseSchema: z$1.ZodObject<{
     ok: z$1.ZodLiteral<true>;
     token: z$1.ZodString;
@@ -10030,6 +10054,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "browser.focusLocation": "browser.focusLocation";
             "browser.reload": "browser.reload";
             "composer.focus": "composer.focus";
+            "dataDirectory.open": "dataDirectory.open";
             "diff.toggle": "diff.toggle";
             "file.quickOpen": "file.quickOpen";
             "logs.openServerDaemon": "logs.openServerDaemon";
@@ -10066,6 +10091,8 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "panel.previousTab": "panel.previousTab";
             "panel.reopenClosedTab": "panel.reopenClosedTab";
             "panel.toggle": "panel.toggle";
+            "plugins.enterSafeMode": "plugins.enterSafeMode";
+            "plugins.exitSafeMode": "plugins.exitSafeMode";
             "question.select.1": "question.select.1";
             "question.select.2": "question.select.2";
             "question.select.3": "question.select.3";
@@ -10172,6 +10199,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "browser.focusLocation": "browser.focusLocation";
             "browser.reload": "browser.reload";
             "composer.focus": "composer.focus";
+            "dataDirectory.open": "dataDirectory.open";
             "diff.toggle": "diff.toggle";
             "file.quickOpen": "file.quickOpen";
             "logs.openServerDaemon": "logs.openServerDaemon";
@@ -10208,6 +10236,8 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "panel.previousTab": "panel.previousTab";
             "panel.reopenClosedTab": "panel.reopenClosedTab";
             "panel.toggle": "panel.toggle";
+            "plugins.enterSafeMode": "plugins.enterSafeMode";
+            "plugins.exitSafeMode": "plugins.exitSafeMode";
             "question.select.1": "question.select.1";
             "question.select.2": "question.select.2";
             "question.select.3": "question.select.3";
@@ -10256,6 +10286,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "browser.focusLocation": "browser.focusLocation";
             "browser.reload": "browser.reload";
             "composer.focus": "composer.focus";
+            "dataDirectory.open": "dataDirectory.open";
             "diff.toggle": "diff.toggle";
             "file.quickOpen": "file.quickOpen";
             "logs.openServerDaemon": "logs.openServerDaemon";
@@ -10292,6 +10323,8 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "panel.previousTab": "panel.previousTab";
             "panel.reopenClosedTab": "panel.reopenClosedTab";
             "panel.toggle": "panel.toggle";
+            "plugins.enterSafeMode": "plugins.enterSafeMode";
+            "plugins.exitSafeMode": "plugins.exitSafeMode";
             "question.select.1": "question.select.1";
             "question.select.2": "question.select.2";
             "question.select.3": "question.select.3";
@@ -13568,6 +13601,12 @@ declare const threadWithIncludesResponseSchema: z$1.ZodObject<{
             }, z$1.core.$strip>], "type">;
         }, z$1.core.$strip>>;
         hostId: z$1.ZodString;
+        hostLifecycle: z$1.ZodEnum<{
+            "cleanup-failed": "cleanup-failed";
+            active: "active";
+            removed: "removed";
+            removing: "removing";
+        }>;
         id: z$1.ZodString;
         isGitRepo: z$1.ZodBoolean;
         isWorktree: z$1.ZodBoolean;
@@ -13608,6 +13647,7 @@ declare const threadWithIncludesResponseSchema: z$1.ZodObject<{
             unmanaged: "unmanaged";
         }>>;
     }, z$1.core.$strip>>>;
+    environmentHostName: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodString>>;
     environmentId: z$1.ZodNullable<z$1.ZodString>;
     host: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodObject<{
         createdAt: z$1.ZodNumber;
@@ -14221,6 +14261,7 @@ declare const threadListQuerySchema: z$1.ZodObject<{
         false: "false";
         true: "true";
     }>>;
+    hostId: z$1.ZodOptional<z$1.ZodString>;
     includeHidden: z$1.ZodOptional<z$1.ZodEnum<{
         false: "false";
         true: "true";
@@ -15540,6 +15581,7 @@ interface HostProviderCliInstallArgs extends HostProviderCliInstallRequest {
 }
 interface HostListArgs {
     includeCreating?: boolean;
+    type?: HostType;
     signal?: AbortSignal;
 }
 interface MachineCreateArgs extends CreateMachineRequest {
@@ -15880,6 +15922,12 @@ interface PluginListArgs {
 interface PluginListUpdateResultsArgs {
     signal?: AbortSignal;
 }
+interface PluginGetSafeModeArgs {
+    signal?: AbortSignal;
+}
+interface PluginSetSafeModeArgs {
+    enabled: boolean;
+}
 type PluginDisableResult = InstalledPlugin;
 type PluginEnableResult = InstalledPlugin;
 type PluginGetSettingsResult = PluginSettingsResponse;
@@ -15887,6 +15935,8 @@ type PluginInstallResult = InstalledPlugin;
 type PluginListResult = PluginListResponse;
 type PluginReloadResult = PluginReloadResponse;
 type PluginRemoveResult = PluginRemoveResponse;
+type PluginSafeModeResult = PluginSafeModeResponse;
+type PluginSetSafeModeResult = PluginSafeModeUpdateResponse;
 type PluginTokenResult = PluginTokenResponse;
 type PluginUpdateSettingsResult = PluginSettingsResponse;
 type PluginGetSourceResult = PluginSourceDetail;
@@ -15915,6 +15965,8 @@ interface PluginMarketplacesArea {
 }
 interface PluginsArea {
     experimental_discoverRpc(args?: PluginRpcDiscoveryQuery): Promise<PublishedPluginRpcMethod[]>;
+    experimental_getSafeMode(args?: PluginGetSafeModeArgs): Promise<PluginSafeModeResult>;
+    experimental_setSafeMode(args: PluginSetSafeModeArgs): Promise<PluginSetSafeModeResult>;
     applyUpdate(args: PluginIdArgs): Promise<PluginApplyUpdateResult>;
     callRpc<TOutput>(args: PluginRpcArgs<TOutput>): Promise<TOutput>;
     checkUpdates(args?: PluginCheckUpdatesArgs): Promise<PluginCheckUpdatesResult>;
@@ -16318,6 +16370,7 @@ interface TerminalsArea {
 interface ThreadListArgs {
     archived?: boolean;
     environmentId?: string;
+    hostId?: string;
     sectionId?: string;
     hasParent?: boolean;
     includeHidden?: boolean;
@@ -18252,12 +18305,13 @@ interface PluginSidebarThreadSplit {
  * Replace the sidebar's thread list with a plugin component.
  *
  * Unlike every other slot, this one is EXCLUSIVE: two lists cannot share one
- * scroll area. Registering activates the replacement while the plugin is
- * enabled. If multiple plugins register one, the first in deterministic slot
- * order is active by default; removing it reveals the next. The user can pin
- * BB's list or a specific provider under Settings → Appearance. A plugin can
- * also use its own setting and render `Original` conditionally.
- * An absent or crashing replacement falls back to BB's list rather than
+ * scroll area. bb ships its own list as the bundled Thread list plugin
+ * (`thread-list/thread-list`). Registering activates the replacement while the
+ * plugin is enabled: by default the first registered list other than the
+ * bundled one, in deterministic slot order, is active, falling back to the
+ * bundled list; removing it reveals the next. The user can pin a specific
+ * provider, including the bundled one, under Settings → Appearance → Sidebar.
+ * A missing pinned provider or a crashing list shows a placeholder rather than
  * leaving the user with no sidebar.
  *
  * The plugin gets the scrolling list and nothing else. The New-thread button,
@@ -18276,11 +18330,12 @@ interface PluginThreadListRegistration {
 }
 /**
  * Replace the navigation controls above the sidebar thread list. Exclusive:
- * the user picks one provider under Settings → Appearance → Navigation, and
  * bb ships its own rows as the bundled Navigation plugin
- * (`navigation/navigation`, the default). A picked provider that is disabled
- * or removed falls back to Navigation; a crashing provider is replaced by a
- * placeholder with a Reload button.
+ * (`navigation/navigation`). By default the first registered provider other
+ * than Navigation is active, falling back to Navigation; the user can pin one
+ * provider under Settings → Appearance → Navigation. A pinned provider that is
+ * disabled or removed falls back to Navigation; a crashing provider is
+ * replaced by a placeholder with a Reload button.
  */
 interface ExperimentalSidebarNavigationRegistration {
     /** Unique within the plugin; letters, digits, `-`, `_`. */
@@ -20474,6 +20529,15 @@ interface PluginThreadEventPayloads {
     "experimental_terminal.input": {
         terminal: TerminalSession;
     };
+    /**
+     * Fired once after a machine is removed, whether a user removed it or its
+     * machine provider finished tearing it down. `host` is the record as it was
+     * when it was removed; `bb.sdk.hosts.get` answers 404 for it from now on, so
+     * this is the moment to drop anything the plugin keeps per host.
+     */
+    "experimental_host.deleted": {
+        host: Host;
+    };
     /** Fired after a thread row is created. */
     "thread.created": {
         thread: ThreadResponse;

package/dist/provider-bridge-acp.js

@@ -1876,6 +1876,7 @@ var systemUserQuestionLifecycleEventDataSchema = z13.object({
 var systemThreadInterruptedReasonValues = [
   "manual-stop",
   "host-daemon-restarted",
+  "host-removed",
   "provider-turn-idle"
 ];
 var systemThreadInterruptedReasonSchema = z13.enum(

package/dist/provider-bridge-testing.js

@@ -965,6 +965,7 @@ var systemUserQuestionLifecycleEventDataSchema = z11.object({
 var systemThreadInterruptedReasonValues = [
   "manual-stop",
   "host-daemon-restarted",
+  "host-removed",
   "provider-turn-idle"
 ];
 var systemThreadInterruptedReasonSchema = z11.enum(

package/dist/provider-bridge.js

@@ -2403,6 +2403,7 @@ var systemUserQuestionLifecycleEventDataSchema = z15.object({
 var systemThreadInterruptedReasonValues = [
   "manual-stop",
   "host-daemon-restarted",
+  "host-removed",
   "provider-turn-idle"
 ];
 var systemThreadInterruptedReasonSchema = z15.enum(

package/dist/testing/index.js

@@ -3295,6 +3295,7 @@ function createFakePluginHostInternal(options, sharedState) {
   const threadEventHandlers = {
     "experimental_thread.events": [],
     "experimental_terminal.input": [],
+    "experimental_host.deleted": [],
     "thread.created": [],
     "thread.active": [],
     "thread.idle": [],
@@ -3732,6 +3733,7 @@ function createFakePluginHostInternal(options, sharedState) {
         return {
           "experimental_thread.events": threadEventHandlers["experimental_thread.events"].length,
           "experimental_terminal.input": threadEventHandlers["experimental_terminal.input"].length,
+          "experimental_host.deleted": threadEventHandlers["experimental_host.deleted"].length,
           "thread.created": threadEventHandlers["thread.created"].length,
           "thread.active": threadEventHandlers["thread.active"].length,
           "thread.idle": threadEventHandlers["thread.idle"].length,
@@ -4357,6 +4359,7 @@ function makeMessageDispatchHookContext(overrides = {}) {
     environmentProviderSelection: null,
     environmentProviderInstanceKey: null,
     lifecycle: { phase: "active", retireAt: null, teardown: null },
+    hostLifecycle: "active",
     managed: false,
     workspaceProvisionType: null,
     status: "ready",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@get-bb/plugin-sdk",
-  "version": "0.5.23",
+  "version": "0.5.27",
   "homepage": "https://github.com/get-bb/bb#readme",
   "bugs": {
     "url": "https://github.com/get-bb/bb/issues"