@get-bb/plugin-sdk 0.5.27 → 0.5.29

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

@@ -528,6 +528,7 @@ type Environment = z$1.infer<typeof environmentSchema>;
 
 declare const experimentsSchema: z$1.ZodRecord<z$1.ZodEnum<{
     changelogPreview: "changelogPreview";
+    legacyJitiPluginLoader: "legacyJitiPluginLoader";
     mobileApp: "mobileApp";
     serverMove: "serverMove";
     sidebarProgressiveDisclosure: "sidebarProgressiveDisclosure";
@@ -7813,6 +7814,22 @@ declare const hostDaemonCommandRegistry: {
         sha256: z$1.ZodString;
         sizeBytes: z$1.ZodNumber;
     }, z$1.core.$strip>]>, "onlineRpc", true>;
+    "host.read_file_chunk": HostDaemonCommandDescriptor<"host.read_file_chunk", z$1.ZodObject<{
+        length: z$1.ZodNumber;
+        offset: z$1.ZodNumber;
+        path: z$1.ZodString;
+        revision: z$1.ZodNullable<z$1.ZodString>;
+        rootPath: z$1.ZodString;
+        type: z$1.ZodLiteral<"host.read_file_chunk">;
+    }, z$1.core.$strict>, z$1.ZodObject<{
+        content: z$1.ZodString;
+        mimeType: z$1.ZodNullable<z$1.ZodString>;
+        modifiedAtMs: z$1.ZodNumber;
+        offset: z$1.ZodNumber;
+        path: z$1.ZodString;
+        revision: z$1.ZodString;
+        sizeBytes: z$1.ZodNumber;
+    }, z$1.core.$strict>, "onlineRpc", true>;
     "host.read_file_relative": HostDaemonCommandDescriptor<"host.read_file_relative", z$1.ZodObject<{
         dotfiles: z$1.ZodEnum<{
             allow: "allow";
@@ -10114,6 +10131,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
     }, z$1.core.$strict>>;
     experiments: z$1.ZodRecord<z$1.ZodEnum<{
         changelogPreview: "changelogPreview";
+        legacyJitiPluginLoader: "legacyJitiPluginLoader";
         mobileApp: "mobileApp";
         serverMove: "serverMove";
         sidebarProgressiveDisclosure: "sidebarProgressiveDisclosure";
@@ -13469,6 +13487,7 @@ type ThreadSearchResponse = z$1.infer<typeof threadSearchResponseSchema>;
 declare const threadResponseSchema: z$1.ZodObject<{
     activeBackgroundAgentCount: z$1.ZodNumber;
     archivedAt: z$1.ZodNullable<z$1.ZodNumber>;
+    canRestoreEnvironment: z$1.ZodBoolean;
     canSpawnChild: z$1.ZodBoolean;
     createdAt: z$1.ZodNumber;
     deletedAt: z$1.ZodNullable<z$1.ZodNumber>;
@@ -13527,6 +13546,7 @@ type ThreadPluginMetadataResponse = z$1.infer<typeof pluginMetadataSchema>;
 declare const threadWithIncludesResponseSchema: z$1.ZodObject<{
     activeBackgroundAgentCount: z$1.ZodNumber;
     archivedAt: z$1.ZodNullable<z$1.ZodNumber>;
+    canRestoreEnvironment: z$1.ZodBoolean;
     canSpawnChild: z$1.ZodBoolean;
     createdAt: z$1.ZodNumber;
     deletedAt: z$1.ZodNullable<z$1.ZodNumber>;
@@ -16419,6 +16439,7 @@ type ThreadUnarchiveResult = {
 };
 type ThreadArchiveAllResult = ThreadArchiveAllResponse;
 type ThreadReadStateResult = ThreadResponse;
+type ThreadRestoreEnvironmentResult = ThreadResponse;
 type ThreadPinOrderResult = ThreadListResponse;
 type ThreadPromptHistoryResult = PromptHistoryResponse;
 type ThreadQueuedMessagesResult = ThreadQueuedMessageListResponse;
@@ -16711,6 +16732,14 @@ interface ThreadsArea {
      * `sendAt` in the future queues it on the clock and a `message.dispatch` hook
      * can still hold it; the response says which of the two happened.
      */
+    /**
+     * Ask the environment provider to restore the destroyed workspace of a
+     * thread and attach it; the provider decides what restoring means, such as
+     * checking the recorded branch out again. Sends fail until this runs. Starts
+     * no turn: the thread settles back to `idle` once the workspace is ready.
+     * Refused unless the thread's `canRestoreEnvironment` is true.
+     */
+    restoreEnvironment(args: ThreadActionArgs): Promise<ThreadRestoreEnvironmentResult>;
     retry(args: ThreadRetryArgs): Promise<ThreadRetryResult>;
     search(args: ThreadSearchArgs): Promise<ThreadSearchResult>;
     send(args: ThreadSendArgs): Promise<ThreadSendResult>;
@@ -17866,6 +17895,10 @@ interface PluginSidebarThreadsState {
     } | null;
     status: "error" | "loading" | "ready";
     threads: readonly PluginSidebarThread[];
+    experimental_hosts?: readonly {
+        id: string;
+        name: string;
+    }[];
     projects: readonly PluginSidebarProject[];
     /** Every section, in the server's order (creation order). */
     sections: readonly PluginSidebarSection[];
@@ -18031,11 +18064,15 @@ interface PluginSidebarThreadActions {
      * `sectionId` files the new thread under that section, and
      * `environmentId` reuses that environment (the "New thread in
      * environment" affordance), both exactly as bb's own list does.
+     * `hostId` selects a machine for a new environment when it
+     * is known and supports an environment provider. `environmentId` wins when
+     * both are supplied.
      */
     openNewThread(options?: {
         projectId?: string;
         sectionId?: string;
         environmentId?: string;
+        hostId?: string;
         focusPrompt?: boolean;
     }): void;
     setPinned(threadId: string, pinned: boolean): Promise<void>;

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

@@ -142,6 +142,7 @@ type Project = z.infer<typeof projectSchema>;
 declare const threadResponseSchema: z.ZodObject<{
     activeBackgroundAgentCount: z.ZodNumber;
     archivedAt: z.ZodNullable<z.ZodNumber>;
+    canRestoreEnvironment: z.ZodBoolean;
     canSpawnChild: z.ZodBoolean;
     createdAt: z.ZodNumber;
     deletedAt: z.ZodNullable<z.ZodNumber>;
@@ -241,13 +242,21 @@ interface PluginEnvironmentProviderCreateContext<R extends PluginEnvironmentProv
     suggestedBranchName: string;
     attempt: number;
     pathKey: string;
-    rebuild: boolean;
+    experimental_claimPath(path: string): Promise<boolean>;
+    report: PluginEnvironmentProviderProgress;
+    signal: AbortSignal;
+}
+/** Rebuilds a thread's destroyed environment; `inputs` are the ones it was created with. */
+interface PluginEnvironmentProviderRestoreContext<R extends PluginEnvironmentProviderRequirements = PluginEnvironmentProviderRequirements, S extends PluginEnvironmentProviderInputsSchema = PluginEnvironmentProviderInputsSchema> extends PluginEnvironmentProviderValidateContext<R, S> {
+    thread: ThreadResponse;
+    attempt: number;
+    pathKey: string;
     experimental_claimPath(path: string): Promise<boolean>;
     /** Resource is private to this provider; null after completed removal. */
     previous: {
         environment: Environment;
         resource: JsonValue$1 | null;
-    } | null;
+    };
     report: PluginEnvironmentProviderProgress;
     signal: AbortSignal;
 }
@@ -281,7 +290,7 @@ type PluginEnvironmentProviderRemoveResult = {
 interface PluginEnvironmentProviderPolicy {
     /** Default five minutes; null keeps the environment indefinitely. */
     retireGraceMs: number | null;
-    /** Default per-thread; rebuilds use a fresh key to avoid dead paths. */
+    /** Default per-thread; replacement environments use a fresh key to avoid dead paths. */
     pathKeys: "per-attempt" | "per-thread";
 }
 /** Resource operations only. Core owns durable launches, retries and retirement. */
@@ -301,7 +310,9 @@ interface PluginEnvironmentProviderDefinition<R extends PluginEnvironmentProvide
     /** Pure path selection from parsed inputs. Core reuses a recorded environment on the selected host before calling create; null requests normal creation. */
     experimental_existingPath?(inputs: InputsValue<S>): string | null;
     create(context: PluginEnvironmentProviderCreateContext<R, S>): Promise<PluginEnvironmentProviderCreateResult>;
+    /** Experimental: rebuild a destroyed environment when its thread asks for it back. Without it, core never rebuilds this provider's destroyed environments: see docs/api_to_audit.md. */
+    restore?(context: PluginEnvironmentProviderRestoreContext<R, S>): Promise<PluginEnvironmentProviderCreateResult>;
     remove(context: PluginEnvironmentProviderRemoveContext): Promise<PluginEnvironmentProviderRemoveResult>;
 }
 
-export type { PluginEnvironmentProviderAvailability, PluginEnvironmentProviderAvailabilityContext, PluginEnvironmentProviderCreateContext, PluginEnvironmentProviderCreateResult, PluginEnvironmentProviderDefinition, PluginEnvironmentProviderInputsSchema, PluginEnvironmentProviderPolicy, PluginEnvironmentProviderProgress, PluginEnvironmentProviderRemoveContext, PluginEnvironmentProviderRemoveResult, PluginEnvironmentProviderValidateContext };
+export type { PluginEnvironmentProviderAvailability, PluginEnvironmentProviderAvailabilityContext, PluginEnvironmentProviderCreateContext, PluginEnvironmentProviderCreateResult, PluginEnvironmentProviderDefinition, PluginEnvironmentProviderInputsSchema, PluginEnvironmentProviderPolicy, PluginEnvironmentProviderProgress, PluginEnvironmentProviderRemoveContext, PluginEnvironmentProviderRemoveResult, PluginEnvironmentProviderRestoreContext, PluginEnvironmentProviderValidateContext };

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

@@ -480,6 +480,7 @@ type ExecutionInputFieldSource = CallerExecutionInputSource;
 declare const threadResponseSchema: z.ZodObject<{
     activeBackgroundAgentCount: z.ZodNumber;
     archivedAt: z.ZodNullable<z.ZodNumber>;
+    canRestoreEnvironment: z.ZodBoolean;
     canSpawnChild: z.ZodBoolean;
     createdAt: z.ZodNumber;
     deletedAt: z.ZodNullable<z.ZodNumber>;
@@ -579,13 +580,21 @@ interface PluginEnvironmentProviderCreateContext<R extends PluginEnvironmentProv
     suggestedBranchName: string;
     attempt: number;
     pathKey: string;
-    rebuild: boolean;
+    experimental_claimPath(path: string): Promise<boolean>;
+    report: PluginEnvironmentProviderProgress;
+    signal: AbortSignal;
+}
+/** Rebuilds a thread's destroyed environment; `inputs` are the ones it was created with. */
+interface PluginEnvironmentProviderRestoreContext<R extends PluginEnvironmentProviderRequirements$1 = PluginEnvironmentProviderRequirements$1, S extends PluginEnvironmentProviderInputsSchema = PluginEnvironmentProviderInputsSchema> extends PluginEnvironmentProviderValidateContext<R, S> {
+    thread: ThreadResponse;
+    attempt: number;
+    pathKey: string;
     experimental_claimPath(path: string): Promise<boolean>;
     /** Resource is private to this provider; null after completed removal. */
     previous: {
         environment: Environment;
         resource: JsonValue$2 | null;
-    } | null;
+    };
     report: PluginEnvironmentProviderProgress;
     signal: AbortSignal;
 }
@@ -619,7 +628,7 @@ type PluginEnvironmentProviderRemoveResult = {
 interface PluginEnvironmentProviderPolicy {
     /** Default five minutes; null keeps the environment indefinitely. */
     retireGraceMs: number | null;
-    /** Default per-thread; rebuilds use a fresh key to avoid dead paths. */
+    /** Default per-thread; replacement environments use a fresh key to avoid dead paths. */
     pathKeys: "per-attempt" | "per-thread";
 }
 /** Resource operations only. Core owns durable launches, retries and retirement. */
@@ -639,6 +648,8 @@ interface PluginEnvironmentProviderDefinition<R extends PluginEnvironmentProvide
     /** Pure path selection from parsed inputs. Core reuses a recorded environment on the selected host before calling create; null requests normal creation. */
     experimental_existingPath?(inputs: InputsValue$1<S>): string | null;
     create(context: PluginEnvironmentProviderCreateContext<R, S>): Promise<PluginEnvironmentProviderCreateResult>;
+    /** Experimental: rebuild a destroyed environment when its thread asks for it back. Without it, core never rebuilds this provider's destroyed environments: see docs/api_to_audit.md. */
+    restore?(context: PluginEnvironmentProviderRestoreContext<R, S>): Promise<PluginEnvironmentProviderCreateResult>;
     remove(context: PluginEnvironmentProviderRemoveContext): Promise<PluginEnvironmentProviderRemoveResult>;
 }
 
@@ -1953,6 +1964,7 @@ interface NormalizedPluginEnvironmentProvider {
     validate: NonNullable<PluginEnvironmentProviderDeclaration["validate"]> | null;
     experimental_existingPath: NonNullable<PluginEnvironmentProviderDeclaration["experimental_existingPath"]> | null;
     create: PluginEnvironmentProviderDeclaration["create"];
+    restore: NonNullable<PluginEnvironmentProviderDeclaration["restore"]> | null;
     remove: PluginEnvironmentProviderDeclaration["remove"];
     policy: PluginEnvironmentProviderPolicy;
 }

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

@@ -273,6 +273,7 @@ type ProviderFork = (typeof PROVIDER_FORK_VALUES)[number];
 declare const threadResponseSchema: z.ZodObject<{
     activeBackgroundAgentCount: z.ZodNumber;
     archivedAt: z.ZodNullable<z.ZodNumber>;
+    canRestoreEnvironment: z.ZodBoolean;
     canSpawnChild: z.ZodBoolean;
     createdAt: z.ZodNumber;
     deletedAt: z.ZodNullable<z.ZodNumber>;
@@ -372,13 +373,21 @@ interface PluginEnvironmentProviderCreateContext<R extends PluginEnvironmentProv
     suggestedBranchName: string;
     attempt: number;
     pathKey: string;
-    rebuild: boolean;
+    experimental_claimPath(path: string): Promise<boolean>;
+    report: PluginEnvironmentProviderProgress;
+    signal: AbortSignal;
+}
+/** Rebuilds a thread's destroyed environment; `inputs` are the ones it was created with. */
+interface PluginEnvironmentProviderRestoreContext<R extends PluginEnvironmentProviderRequirements$1 = PluginEnvironmentProviderRequirements$1, S extends PluginEnvironmentProviderInputsSchema = PluginEnvironmentProviderInputsSchema> extends PluginEnvironmentProviderValidateContext<R, S> {
+    thread: ThreadResponse$1;
+    attempt: number;
+    pathKey: string;
     experimental_claimPath(path: string): Promise<boolean>;
     /** Resource is private to this provider; null after completed removal. */
     previous: {
         environment: Environment;
         resource: JsonValue$2 | null;
-    } | null;
+    };
     report: PluginEnvironmentProviderProgress;
     signal: AbortSignal;
 }
@@ -412,7 +421,7 @@ type PluginEnvironmentProviderRemoveResult = {
 interface PluginEnvironmentProviderPolicy {
     /** Default five minutes; null keeps the environment indefinitely. */
     retireGraceMs: number | null;
-    /** Default per-thread; rebuilds use a fresh key to avoid dead paths. */
+    /** Default per-thread; replacement environments use a fresh key to avoid dead paths. */
     pathKeys: "per-attempt" | "per-thread";
 }
 /** Resource operations only. Core owns durable launches, retries and retirement. */
@@ -432,6 +441,8 @@ interface PluginEnvironmentProviderDefinition<R extends PluginEnvironmentProvide
     /** Pure path selection from parsed inputs. Core reuses a recorded environment on the selected host before calling create; null requests normal creation. */
     experimental_existingPath?(inputs: InputsValue<S>): string | null;
     create(context: PluginEnvironmentProviderCreateContext<R, S>): Promise<PluginEnvironmentProviderCreateResult>;
+    /** Experimental: rebuild a destroyed environment when its thread asks for it back. Without it, core never rebuilds this provider's destroyed environments: see docs/api_to_audit.md. */
+    restore?(context: PluginEnvironmentProviderRestoreContext<R, S>): Promise<PluginEnvironmentProviderCreateResult>;
     remove(context: PluginEnvironmentProviderRemoveContext): Promise<PluginEnvironmentProviderRemoveResult>;
 }
 
@@ -990,6 +1001,7 @@ interface NormalizedPluginEnvironmentProvider {
     validate: NonNullable<PluginEnvironmentProviderDeclaration["validate"]> | null;
     experimental_existingPath: NonNullable<PluginEnvironmentProviderDeclaration["experimental_existingPath"]> | null;
     create: PluginEnvironmentProviderDeclaration["create"];
+    restore: NonNullable<PluginEnvironmentProviderDeclaration["restore"]> | null;
     remove: PluginEnvironmentProviderDeclaration["remove"];
     policy: PluginEnvironmentProviderPolicy;
 }

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

@@ -483,6 +483,7 @@ type Environment = z$1.infer<typeof environmentSchema>;
 
 declare const experimentsSchema: z$1.ZodRecord<z$1.ZodEnum<{
     changelogPreview: "changelogPreview";
+    legacyJitiPluginLoader: "legacyJitiPluginLoader";
     mobileApp: "mobileApp";
     serverMove: "serverMove";
     sidebarProgressiveDisclosure: "sidebarProgressiveDisclosure";
@@ -7864,6 +7865,22 @@ declare const hostDaemonCommandRegistry: {
         sha256: z$1.ZodString;
         sizeBytes: z$1.ZodNumber;
     }, z$1.core.$strip>]>, "onlineRpc", true>;
+    "host.read_file_chunk": HostDaemonCommandDescriptor<"host.read_file_chunk", z$1.ZodObject<{
+        length: z$1.ZodNumber;
+        offset: z$1.ZodNumber;
+        path: z$1.ZodString;
+        revision: z$1.ZodNullable<z$1.ZodString>;
+        rootPath: z$1.ZodString;
+        type: z$1.ZodLiteral<"host.read_file_chunk">;
+    }, z$1.core.$strict>, z$1.ZodObject<{
+        content: z$1.ZodString;
+        mimeType: z$1.ZodNullable<z$1.ZodString>;
+        modifiedAtMs: z$1.ZodNumber;
+        offset: z$1.ZodNumber;
+        path: z$1.ZodString;
+        revision: z$1.ZodString;
+        sizeBytes: z$1.ZodNumber;
+    }, z$1.core.$strict>, "onlineRpc", true>;
     "host.read_file_relative": HostDaemonCommandDescriptor<"host.read_file_relative", z$1.ZodObject<{
         dotfiles: z$1.ZodEnum<{
             allow: "allow";
@@ -10165,6 +10182,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
     }, z$1.core.$strict>>;
     experiments: z$1.ZodRecord<z$1.ZodEnum<{
         changelogPreview: "changelogPreview";
+        legacyJitiPluginLoader: "legacyJitiPluginLoader";
         mobileApp: "mobileApp";
         serverMove: "serverMove";
         sidebarProgressiveDisclosure: "sidebarProgressiveDisclosure";
@@ -13521,6 +13539,7 @@ type ThreadSearchResponse = z$1.infer<typeof threadSearchResponseSchema>;
 declare const threadResponseSchema: z$1.ZodObject<{
     activeBackgroundAgentCount: z$1.ZodNumber;
     archivedAt: z$1.ZodNullable<z$1.ZodNumber>;
+    canRestoreEnvironment: z$1.ZodBoolean;
     canSpawnChild: z$1.ZodBoolean;
     createdAt: z$1.ZodNumber;
     deletedAt: z$1.ZodNullable<z$1.ZodNumber>;
@@ -13579,6 +13598,7 @@ type ThreadPluginMetadataResponse = z$1.infer<typeof pluginMetadataSchema>;
 declare const threadWithIncludesResponseSchema: z$1.ZodObject<{
     activeBackgroundAgentCount: z$1.ZodNumber;
     archivedAt: z$1.ZodNullable<z$1.ZodNumber>;
+    canRestoreEnvironment: z$1.ZodBoolean;
     canSpawnChild: z$1.ZodBoolean;
     createdAt: z$1.ZodNumber;
     deletedAt: z$1.ZodNullable<z$1.ZodNumber>;
@@ -16482,6 +16502,7 @@ type ThreadUnarchiveResult = {
 };
 type ThreadArchiveAllResult = ThreadArchiveAllResponse;
 type ThreadReadStateResult = ThreadResponse;
+type ThreadRestoreEnvironmentResult = ThreadResponse;
 type ThreadPinOrderResult = ThreadListResponse;
 type ThreadPromptHistoryResult = PromptHistoryResponse;
 type ThreadQueuedMessagesResult = ThreadQueuedMessageListResponse;
@@ -16774,6 +16795,14 @@ interface ThreadsArea {
      * `sendAt` in the future queues it on the clock and a `message.dispatch` hook
      * can still hold it; the response says which of the two happened.
      */
+    /**
+     * Ask the environment provider to restore the destroyed workspace of a
+     * thread and attach it; the provider decides what restoring means, such as
+     * checking the recorded branch out again. Sends fail until this runs. Starts
+     * no turn: the thread settles back to `idle` once the workspace is ready.
+     * Refused unless the thread's `canRestoreEnvironment` is true.
+     */
+    restoreEnvironment(args: ThreadActionArgs): Promise<ThreadRestoreEnvironmentResult>;
     retry(args: ThreadRetryArgs): Promise<ThreadRetryResult>;
     search(args: ThreadSearchArgs): Promise<ThreadSearchResult>;
     send(args: ThreadSendArgs): Promise<ThreadSendResult>;
@@ -18018,6 +18047,10 @@ interface PluginSidebarThreadsState {
     } | null;
     status: "error" | "loading" | "ready";
     threads: readonly PluginSidebarThread[];
+    experimental_hosts?: readonly {
+        id: string;
+        name: string;
+    }[];
     projects: readonly PluginSidebarProject[];
     /** Every section, in the server's order (creation order). */
     sections: readonly PluginSidebarSection[];
@@ -18183,11 +18216,15 @@ interface PluginSidebarThreadActions {
      * `sectionId` files the new thread under that section, and
      * `environmentId` reuses that environment (the "New thread in
      * environment" affordance), both exactly as bb's own list does.
+     * `hostId` selects a machine for a new environment when it
+     * is known and supports an environment provider. `environmentId` wins when
+     * both are supplied.
      */
     openNewThread(options?: {
         projectId?: string;
         sectionId?: string;
         environmentId?: string;
+        hostId?: string;
         focusPrompt?: boolean;
     }): void;
     setPinned(threadId: string, pinned: boolean): Promise<void>;
@@ -20148,13 +20185,21 @@ interface PluginEnvironmentProviderCreateContext<R extends PluginEnvironmentProv
     suggestedBranchName: string;
     attempt: number;
     pathKey: string;
-    rebuild: boolean;
+    experimental_claimPath(path: string): Promise<boolean>;
+    report: PluginEnvironmentProviderProgress;
+    signal: AbortSignal;
+}
+/** Rebuilds a thread's destroyed environment; `inputs` are the ones it was created with. */
+interface PluginEnvironmentProviderRestoreContext<R extends PluginEnvironmentProviderRequirements$1 = PluginEnvironmentProviderRequirements$1, S extends PluginEnvironmentProviderInputsSchema = PluginEnvironmentProviderInputsSchema> extends PluginEnvironmentProviderValidateContext<R, S> {
+    thread: ThreadResponse;
+    attempt: number;
+    pathKey: string;
     experimental_claimPath(path: string): Promise<boolean>;
     /** Resource is private to this provider; null after completed removal. */
     previous: {
         environment: Environment;
         resource: JsonValue$2 | null;
-    } | null;
+    };
     report: PluginEnvironmentProviderProgress;
     signal: AbortSignal;
 }
@@ -20188,7 +20233,7 @@ type PluginEnvironmentProviderRemoveResult = {
 interface PluginEnvironmentProviderPolicy {
     /** Default five minutes; null keeps the environment indefinitely. */
     retireGraceMs: number | null;
-    /** Default per-thread; rebuilds use a fresh key to avoid dead paths. */
+    /** Default per-thread; replacement environments use a fresh key to avoid dead paths. */
     pathKeys: "per-attempt" | "per-thread";
 }
 /** Resource operations only. Core owns durable launches, retries and retirement. */
@@ -20208,6 +20253,8 @@ interface PluginEnvironmentProviderDefinition<R extends PluginEnvironmentProvide
     /** Pure path selection from parsed inputs. Core reuses a recorded environment on the selected host before calling create; null requests normal creation. */
     experimental_existingPath?(inputs: InputsValue<S>): string | null;
     create(context: PluginEnvironmentProviderCreateContext<R, S>): Promise<PluginEnvironmentProviderCreateResult>;
+    /** Experimental: rebuild a destroyed environment when its thread asks for it back. Without it, core never rebuilds this provider's destroyed environments: see docs/api_to_audit.md. */
+    restore?(context: PluginEnvironmentProviderRestoreContext<R, S>): Promise<PluginEnvironmentProviderCreateResult>;
     remove(context: PluginEnvironmentProviderRemoveContext): Promise<PluginEnvironmentProviderRemoveResult>;
 }
 

package/dist/internal/host-policy.js

@@ -1943,6 +1943,12 @@ function validatePluginEnvironmentProviderDeclaration(declaration) {
     declaration.experimental_existingPath,
     "experimental_existingPath"
   );
+  assertOptionalFunction(
+    "environment provider",
+    id,
+    declaration.restore,
+    "a restore"
+  );
   return {
     id,
     displayName,
@@ -1955,6 +1961,7 @@ function validatePluginEnvironmentProviderDeclaration(declaration) {
     validate: declaration.validate ?? null,
     experimental_existingPath: declaration.experimental_existingPath ?? null,
     create: declaration.create,
+    restore: declaration.restore ?? null,
     remove: declaration.remove,
     policy: environmentProviderPolicySchema.parse(declaration.policy ?? {})
   };

package/dist/testing/app.js

@@ -2073,6 +2073,7 @@ function renderSlot(registration, props, options = {}) {
     experimental_archived: options.sidebarThreads?.experimental_archived ?? null,
     status: options.sidebarThreads?.status ?? "ready",
     threads: options.sidebarThreads?.threads ?? [],
+    experimental_hosts: options.sidebarThreads?.experimental_hosts ?? [],
     projects: options.sidebarThreads?.projects ?? [],
     sections: options.sidebarThreads?.sections ?? []
   };

package/dist/testing/index.js

@@ -1968,6 +1968,12 @@ function validatePluginEnvironmentProviderDeclaration(declaration) {
     declaration.experimental_existingPath,
     "experimental_existingPath"
   );
+  assertOptionalFunction(
+    "environment provider",
+    id,
+    declaration.restore,
+    "a restore"
+  );
   return {
     id,
     displayName,
@@ -1980,6 +1986,7 @@ function validatePluginEnvironmentProviderDeclaration(declaration) {
     validate: declaration.validate ?? null,
     experimental_existingPath: declaration.experimental_existingPath ?? null,
     create: declaration.create,
+    restore: declaration.restore ?? null,
     remove: declaration.remove,
     policy: environmentProviderPolicySchema.parse(declaration.policy ?? {})
   };
@@ -4253,6 +4260,7 @@ function makeThreadResponse(overrides = {}) {
     updatedAt: 0,
     runtime: { displayStatus: "idle", hostReconnectGraceExpiresAt: null },
     activeBackgroundAgentCount: 0,
+    canRestoreEnvironment: false,
     canSpawnChild: true,
     queuedMessageCount: 0,
     ...overrides

package/package.json

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