@get-bb/plugin-sdk 0.5.27 → 0.5.30

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

@@ -480,9 +480,92 @@ 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>;
+    draft: z.ZodNullable<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        mentions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            end: z.ZodNumber;
+            resource: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"thread">;
+                label: z.ZodString;
+                projectId: z.ZodOptional<z.ZodString>;
+                threadId: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"project">;
+                label: z.ZodString;
+                projectId: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"section">;
+                label: z.ZodString;
+                sectionId: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                entryKind: z.ZodEnum<{
+                    directory: "directory";
+                    file: "file";
+                }>;
+                kind: z.ZodLiteral<"path">;
+                label: z.ZodString;
+                path: z.ZodString;
+                source: z.ZodEnum<{
+                    "thread-storage": "thread-storage";
+                    workspace: "workspace";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                argumentHint: z.ZodNullable<z.ZodString>;
+                kind: z.ZodLiteral<"command">;
+                label: z.ZodString;
+                name: z.ZodString;
+                origin: z.ZodEnum<{
+                    builtin: "builtin";
+                    project: "project";
+                    user: "user";
+                }>;
+                source: z.ZodEnum<{
+                    command: "command";
+                    skill: "skill";
+                }>;
+                trigger: z.ZodEnum<{
+                    "/": "/";
+                    $: "$";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                itemId: z.ZodString;
+                kind: z.ZodLiteral<"plugin">;
+                label: z.ZodString;
+                pluginId: z.ZodString;
+            }, z.core.$strip>], "kind">>;
+            start: z.ZodNumber;
+        }, z.core.$strip>>>;
+        text: z.ZodString;
+        type: z.ZodLiteral<"text">;
+        visibility: z.ZodOptional<z.ZodEnum<{
+            "agent-only": "agent-only";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        url: z.ZodString;
+        visibility: z.ZodOptional<z.ZodEnum<{
+            "agent-only": "agent-only";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        path: z.ZodString;
+        type: z.ZodLiteral<"localImage">;
+        visibility: z.ZodOptional<z.ZodEnum<{
+            "agent-only": "agent-only";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        mimeType: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        path: z.ZodString;
+        sizeBytes: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodLiteral<"localFile">;
+        visibility: z.ZodOptional<z.ZodEnum<{
+            "agent-only": "agent-only";
+        }>>;
+    }, z.core.$strip>], "type">>>;
     environmentId: z.ZodNullable<z.ZodString>;
     id: z.ZodString;
     lastReadAt: z.ZodNullable<z.ZodNumber>;
@@ -579,13 +662,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 +710,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 +730,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 +2046,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-provider-bridge-testing.d.ts

@@ -3594,11 +3594,45 @@ declare const threadEventSchema: z.ZodPipe<z.ZodUnknown, z.ZodUnion<readonly [z.
     }>>;
     systemMessageSubject: z.ZodOptional<z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"thread">;
+        outcomes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            interruption: z.ZodOptional<z.ZodObject<{
+                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";
+                }>;
+            }, z.core.$strip>>;
+            status: z.ZodEnum<{
+                completed: "completed";
+                failed: "failed";
+                interrupted: "interrupted";
+            }>;
+            threadId: z.ZodString;
+        }, z.core.$strip>>>;
         threadId: z.ZodString;
         threadName: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         count: z.ZodNumber;
         kind: z.ZodLiteral<"thread-batch">;
+        outcomes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            interruption: z.ZodOptional<z.ZodObject<{
+                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";
+                }>;
+            }, z.core.$strip>>;
+            status: z.ZodEnum<{
+                completed: "completed";
+                failed: "failed";
+                interrupted: "interrupted";
+            }>;
+            threadId: z.ZodString;
+        }, z.core.$strip>>>;
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"tool-call">;
         suppress: z.ZodBoolean;

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

@@ -273,9 +273,92 @@ 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>;
+    draft: z.ZodNullable<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        mentions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            end: z.ZodNumber;
+            resource: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"thread">;
+                label: z.ZodString;
+                projectId: z.ZodOptional<z.ZodString>;
+                threadId: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"project">;
+                label: z.ZodString;
+                projectId: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"section">;
+                label: z.ZodString;
+                sectionId: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                entryKind: z.ZodEnum<{
+                    directory: "directory";
+                    file: "file";
+                }>;
+                kind: z.ZodLiteral<"path">;
+                label: z.ZodString;
+                path: z.ZodString;
+                source: z.ZodEnum<{
+                    "thread-storage": "thread-storage";
+                    workspace: "workspace";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                argumentHint: z.ZodNullable<z.ZodString>;
+                kind: z.ZodLiteral<"command">;
+                label: z.ZodString;
+                name: z.ZodString;
+                origin: z.ZodEnum<{
+                    builtin: "builtin";
+                    project: "project";
+                    user: "user";
+                }>;
+                source: z.ZodEnum<{
+                    command: "command";
+                    skill: "skill";
+                }>;
+                trigger: z.ZodEnum<{
+                    "/": "/";
+                    $: "$";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                itemId: z.ZodString;
+                kind: z.ZodLiteral<"plugin">;
+                label: z.ZodString;
+                pluginId: z.ZodString;
+            }, z.core.$strip>], "kind">>;
+            start: z.ZodNumber;
+        }, z.core.$strip>>>;
+        text: z.ZodString;
+        type: z.ZodLiteral<"text">;
+        visibility: z.ZodOptional<z.ZodEnum<{
+            "agent-only": "agent-only";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        url: z.ZodString;
+        visibility: z.ZodOptional<z.ZodEnum<{
+            "agent-only": "agent-only";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        path: z.ZodString;
+        type: z.ZodLiteral<"localImage">;
+        visibility: z.ZodOptional<z.ZodEnum<{
+            "agent-only": "agent-only";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        mimeType: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        path: z.ZodString;
+        sizeBytes: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodLiteral<"localFile">;
+        visibility: z.ZodOptional<z.ZodEnum<{
+            "agent-only": "agent-only";
+        }>>;
+    }, z.core.$strip>], "type">>>;
     environmentId: z.ZodNullable<z.ZodString>;
     id: z.ZodString;
     lastReadAt: z.ZodNullable<z.ZodNumber>;
@@ -372,13 +455,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 +503,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 +523,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 +1083,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;
 }