@get-bb/plugin-sdk 0.4.3 → 0.4.6

package/README.md

@@ -136,6 +136,10 @@ The complete root declaration flattens the unpublished BB workspace contracts.
 The testing declarations reuse that public `@get-bb/plugin-sdk` root instead of
 embedding a second copy, and no declaration depends on unpublished `@bb/*`
 packages. Genuine npm types (`hono`, `better-sqlite3`, `zod`, React, and Testing
-Library) remain peer imports. Scaffolded plugins still vendor the root/app
-declarations in `types/`; installing this package is needed only when their
-tests import the testing subpaths.
+Library) remain peer imports. Scaffolded plugins depend on this package —
+`bb plugin new` pins it exactly in `devDependencies` — and read the root/app
+declarations straight from `node_modules/@get-bb/plugin-sdk/bundled-types/`,
+the same files the testing subpaths reuse. Plugins scaffolded before that
+switch still vendor a copy of the root/app declarations in `types/` and map
+`@get-bb/plugin-sdk` onto them through their `tsconfig.json`; `bb plugin
+types` keeps those refreshed until they migrate.

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

@@ -255,6 +255,7 @@ declare const experimentsSchema: z$1.ZodRecord<z$1.ZodEnum<{
     claudeCodeMockCliTraffic: "claudeCodeMockCliTraffic";
     editMessages: "editMessages";
     newOnboarding: "newOnboarding";
+    providerSessionReaping: "providerSessionReaping";
 }>, z$1.ZodBoolean>;
 type Experiments = z$1.infer<typeof experimentsSchema>;
 
@@ -2556,8 +2557,8 @@ declare const skillListResponseSchema: z$1.ZodObject<{
         name: z$1.ZodString;
         description: z$1.ZodNullable<z$1.ZodString>;
         provider: z$1.ZodNullable<z$1.ZodEnum<{
-            codex: "codex";
             "claude-code": "claude-code";
+            codex: "codex";
             "acp-cursor": "acp-cursor";
         }>>;
         scope: z$1.ZodEnum<{
@@ -2942,8 +2943,8 @@ declare const environmentArchiveThreadsResponseSchema: z$1.ZodObject<{
 type EnvironmentArchiveThreadsResponse = z$1.infer<typeof environmentArchiveThreadsResponseSchema>;
 declare const pullRequestMergeMethodSchema: z$1.ZodEnum<{
     merge: "merge";
-    squash: "squash";
     rebase: "rebase";
+    squash: "squash";
 }>;
 type PullRequestMergeMethod = z$1.infer<typeof pullRequestMergeMethodSchema>;
 declare const commitActionResponseSchema: z$1.ZodObject<{
@@ -2974,8 +2975,8 @@ declare const pullRequestMergeActionResponseSchema: z$1.ZodObject<{
     action: z$1.ZodLiteral<"pull_request_merge">;
     method: z$1.ZodEnum<{
         merge: "merge";
-        squash: "squash";
         rebase: "rebase";
+        squash: "squash";
     }>;
     message: z$1.ZodString;
 }, z$1.core.$strip>;
@@ -3238,6 +3239,7 @@ declare const environmentDiffFilesResponseSchema: z$1.ZodDiscriminatedUnion<[z$1
             too_large: "too_large";
         }>;
     }, z$1.core.$strip>>;
+    truncated: z$1.ZodBoolean;
     shortstat: z$1.ZodString;
     mergeBaseRef: z$1.ZodNullable<z$1.ZodString>;
     initialPatches: z$1.ZodArray<z$1.ZodObject<{
@@ -3249,7 +3251,6 @@ declare const environmentDiffFilesResponseSchema: z$1.ZodDiscriminatedUnion<[z$1
     outcome: z$1.ZodLiteral<"not_applicable">;
     reason: z$1.ZodEnum<{
         non_git_environment: "non_git_environment";
-        too_many_files: "too_many_files";
     }>;
     message: z$1.ZodString;
 }, z$1.core.$strict>, z$1.ZodObject<{
@@ -3571,16 +3572,16 @@ declare const hostDaemonCommandRegistry: {
             permissionScope: z$1.ZodLiteral<"workspace">;
             approvalReviewer: z$1.ZodLiteral<"user">;
             permissionEscalation: z$1.ZodEnum<{
-                ask: "ask";
                 deny: "deny";
+                ask: "ask";
             }>;
         }, z$1.core.$strip>, z$1.ZodObject<{
             permissionMode: z$1.ZodLiteral<"auto">;
             permissionScope: z$1.ZodLiteral<"workspace">;
             approvalReviewer: z$1.ZodLiteral<"automatic">;
             permissionEscalation: z$1.ZodEnum<{
-                ask: "ask";
                 deny: "deny";
+                ask: "ask";
             }>;
         }, z$1.core.$strip>, z$1.ZodObject<{
             permissionMode: z$1.ZodLiteral<"full">;
@@ -3772,16 +3773,16 @@ declare const hostDaemonCommandRegistry: {
             permissionScope: z$1.ZodLiteral<"workspace">;
             approvalReviewer: z$1.ZodLiteral<"user">;
             permissionEscalation: z$1.ZodEnum<{
-                ask: "ask";
                 deny: "deny";
+                ask: "ask";
             }>;
         }, z$1.core.$strip>, z$1.ZodObject<{
             permissionMode: z$1.ZodLiteral<"auto">;
             permissionScope: z$1.ZodLiteral<"workspace">;
             approvalReviewer: z$1.ZodLiteral<"automatic">;
             permissionEscalation: z$1.ZodEnum<{
-                ask: "ask";
                 deny: "deny";
+                ask: "ask";
             }>;
         }, z$1.core.$strip>, z$1.ZodObject<{
             permissionMode: z$1.ZodLiteral<"full">;
@@ -3875,9 +3876,9 @@ declare const hostDaemonCommandRegistry: {
                         skill: "skill";
                     }>;
                     origin: z$1.ZodEnum<{
-                        builtin: "builtin";
-                        project: "project";
                         user: "user";
+                        project: "project";
+                        builtin: "builtin";
                     }>;
                     label: z$1.ZodString;
                     argumentHint: z$1.ZodNullable<z$1.ZodString>;
@@ -3956,9 +3957,9 @@ declare const hostDaemonCommandRegistry: {
                         skill: "skill";
                     }>;
                     origin: z$1.ZodEnum<{
-                        builtin: "builtin";
-                        project: "project";
                         user: "user";
+                        project: "project";
+                        builtin: "builtin";
                     }>;
                     label: z$1.ZodString;
                     argumentHint: z$1.ZodNullable<z$1.ZodString>;
@@ -4049,9 +4050,9 @@ declare const hostDaemonCommandRegistry: {
                         skill: "skill";
                     }>;
                     origin: z$1.ZodEnum<{
-                        builtin: "builtin";
-                        project: "project";
                         user: "user";
+                        project: "project";
+                        builtin: "builtin";
                     }>;
                     label: z$1.ZodString;
                     argumentHint: z$1.ZodNullable<z$1.ZodString>;
@@ -4130,9 +4131,9 @@ declare const hostDaemonCommandRegistry: {
                         skill: "skill";
                     }>;
                     origin: z$1.ZodEnum<{
-                        builtin: "builtin";
-                        project: "project";
                         user: "user";
+                        project: "project";
+                        builtin: "builtin";
                     }>;
                     label: z$1.ZodString;
                     argumentHint: z$1.ZodNullable<z$1.ZodString>;
@@ -4195,16 +4196,16 @@ declare const hostDaemonCommandRegistry: {
             permissionScope: z$1.ZodLiteral<"workspace">;
             approvalReviewer: z$1.ZodLiteral<"user">;
             permissionEscalation: z$1.ZodEnum<{
-                ask: "ask";
                 deny: "deny";
+                ask: "ask";
             }>;
         }, z$1.core.$strip>, z$1.ZodObject<{
             permissionMode: z$1.ZodLiteral<"auto">;
             permissionScope: z$1.ZodLiteral<"workspace">;
             approvalReviewer: z$1.ZodLiteral<"automatic">;
             permissionEscalation: z$1.ZodEnum<{
-                ask: "ask";
                 deny: "deny";
+                ask: "ask";
             }>;
         }, z$1.core.$strip>, z$1.ZodObject<{
             permissionMode: z$1.ZodLiteral<"full">;
@@ -4317,12 +4318,13 @@ declare const hostDaemonCommandRegistry: {
                     personal: "personal";
                 }>;
             }, z$1.core.$strip>;
+            projectId: z$1.ZodString;
+            providerThreadId: z$1.ZodString;
+            providerId: z$1.ZodString;
             instructionMode: z$1.ZodEnum<{
                 append: "append";
                 replace: "replace";
             }>;
-            projectId: z$1.ZodString;
-            providerId: z$1.ZodString;
             acpLaunchSpec: z$1.ZodOptional<z$1.ZodObject<{
                 displayName: z$1.ZodString;
                 command: z$1.ZodString;
@@ -4454,7 +4456,6 @@ declare const hostDaemonCommandRegistry: {
                 skillFilePath: z$1.ZodString;
             }, z$1.core.$strict>], "kind">>;
             disallowedTools: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
-            providerThreadId: z$1.ZodString;
         }, z$1.core.$strict>;
         target: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
             mode: z$1.ZodLiteral<"start">;
@@ -4467,14 +4468,18 @@ declare const hostDaemonCommandRegistry: {
         }, z$1.core.$strip>], "mode">;
     }, z$1.core.$strict>, z$1.ZodObject<{
         appliedAs: z$1.ZodEnum<{
-            steer: "steer";
             "new-turn": "new-turn";
+            steer: "steer";
         }>;
     }, z$1.core.$strip>, "settled", false>;
     "thread.stop": HostDaemonCommandDescriptor<"thread.stop", z$1.ZodObject<{
         environmentId: z$1.ZodString;
         threadId: z$1.ZodString;
         type: z$1.ZodLiteral<"thread.stop">;
+        intent: z$1.ZodEnum<{
+            interrupt: "interrupt";
+            release: "release";
+        }>;
     }, z$1.core.$strict>, z$1.ZodObject<{
         providerCheckpointId: z$1.ZodNullable<z$1.ZodString>;
     }, z$1.core.$strict>, "settled", false>;
@@ -4511,16 +4516,16 @@ declare const hostDaemonCommandRegistry: {
             permissionScope: z$1.ZodLiteral<"workspace">;
             approvalReviewer: z$1.ZodLiteral<"user">;
             permissionEscalation: z$1.ZodEnum<{
-                ask: "ask";
                 deny: "deny";
+                ask: "ask";
             }>;
         }, z$1.core.$strip>, z$1.ZodObject<{
             permissionMode: z$1.ZodLiteral<"auto">;
             permissionScope: z$1.ZodLiteral<"workspace">;
             approvalReviewer: z$1.ZodLiteral<"automatic">;
             permissionEscalation: z$1.ZodEnum<{
-                ask: "ask";
                 deny: "deny";
+                ask: "ask";
             }>;
         }, z$1.core.$strip>, z$1.ZodObject<{
             permissionMode: z$1.ZodLiteral<"full">;
@@ -4633,12 +4638,13 @@ declare const hostDaemonCommandRegistry: {
                     personal: "personal";
                 }>;
             }, z$1.core.$strip>;
+            projectId: z$1.ZodString;
+            providerThreadId: z$1.ZodString;
+            providerId: z$1.ZodString;
             instructionMode: z$1.ZodEnum<{
                 append: "append";
                 replace: "replace";
             }>;
-            projectId: z$1.ZodString;
-            providerId: z$1.ZodString;
             acpLaunchSpec: z$1.ZodOptional<z$1.ZodObject<{
                 displayName: z$1.ZodString;
                 command: z$1.ZodString;
@@ -4770,7 +4776,6 @@ declare const hostDaemonCommandRegistry: {
                 skillFilePath: z$1.ZodString;
             }, z$1.core.$strict>], "kind">>;
             disallowedTools: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
-            providerThreadId: z$1.ZodString;
         }, z$1.core.$strict>;
     }, z$1.core.$strict>, z$1.ZodObject<{
         cleared: z$1.ZodBoolean;
@@ -4930,9 +4935,9 @@ declare const hostDaemonCommandRegistry: {
             text: z$1.ZodString;
             startedAt: z$1.ZodOptional<z$1.ZodNumber>;
             status: z$1.ZodOptional<z$1.ZodEnum<{
-                started: "started";
                 completed: "completed";
                 failed: "failed";
+                started: "started";
             }>>;
             metadata: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodUnknown>>;
         }, z$1.core.$strip>>;
@@ -5164,8 +5169,8 @@ declare const hostDaemonCommandRegistry: {
                 skill: "skill";
             }>;
             origin: z$1.ZodEnum<{
-                project: "project";
                 user: "user";
+                project: "project";
             }>;
             description: z$1.ZodNullable<z$1.ZodString>;
             argumentHint: z$1.ZodNullable<z$1.ZodString>;
@@ -5186,9 +5191,9 @@ declare const hostDaemonCommandRegistry: {
             description: z$1.ZodNullable<z$1.ZodString>;
             filePath: z$1.ZodString;
             rootKind: z$1.ZodEnum<{
+                plugin: "plugin";
                 "shared-user": "shared-user";
                 "shared-project": "shared-project";
-                plugin: "plugin";
                 "bb-project": "bb-project";
                 "bb-data-dir": "bb-data-dir";
                 "bb-builtin": "bb-builtin";
@@ -5682,8 +5687,8 @@ declare const hostDaemonCommandRegistry: {
         npmGlobalPackageVersion: z$1.ZodNullable<z$1.ZodString>;
         installAction: z$1.ZodNullable<z$1.ZodObject<{
             kind: z$1.ZodEnum<{
-                install: "install";
                 update: "update";
+                install: "install";
             }>;
             label: z$1.ZodEnum<{
                 Install: "Install";
@@ -5705,8 +5710,8 @@ declare const hostDaemonCommandRegistry: {
             cursor: "cursor";
         }>;
         actionKind: z$1.ZodEnum<{
-            install: "install";
             update: "update";
+            install: "install";
         }>;
         type: z$1.ZodLiteral<"provider_cli.install">;
     }, z$1.core.$strict>, z$1.ZodObject<{
@@ -5762,6 +5767,8 @@ declare const hostDaemonCommandRegistry: {
         }, z$1.core.$strip>;
         type: z$1.ZodLiteral<"workspace.status">;
         mergeBaseBranch: z$1.ZodOptional<z$1.ZodString>;
+        maxUntrackedLineStatFiles: z$1.ZodNumber;
+        maxUntrackedLineStatBytes: z$1.ZodNumber;
     }, z$1.core.$strict>, z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
         outcome: z$1.ZodLiteral<"available">;
         workspaceStatus: z$1.ZodObject<{
@@ -5848,13 +5855,13 @@ declare const hostDaemonCommandRegistry: {
         outcome: z$1.ZodLiteral<"unavailable">;
         failure: z$1.ZodObject<{
             code: z$1.ZodEnum<{
+                unknown: "unknown";
                 path_not_found: "path_not_found";
                 not_git_repo: "not_git_repo";
                 not_worktree: "not_worktree";
                 workspace_type_mismatch: "workspace_type_mismatch";
                 permission_denied: "permission_denied";
                 unknown_environment: "unknown_environment";
-                unknown: "unknown";
             }>;
             workspacePath: z$1.ZodString;
             message: z$1.ZodString;
@@ -5899,13 +5906,13 @@ declare const hostDaemonCommandRegistry: {
         outcome: z$1.ZodLiteral<"unavailable">;
         failure: z$1.ZodObject<{
             code: z$1.ZodEnum<{
+                unknown: "unknown";
                 path_not_found: "path_not_found";
                 not_git_repo: "not_git_repo";
                 not_worktree: "not_worktree";
                 workspace_type_mismatch: "workspace_type_mismatch";
                 permission_denied: "permission_denied";
                 unknown_environment: "unknown_environment";
-                unknown: "unknown";
             }>;
             workspacePath: z$1.ZodString;
             message: z$1.ZodString;
@@ -5958,17 +5965,18 @@ declare const hostDaemonCommandRegistry: {
         }, z$1.core.$strip>>;
         shortstat: z$1.ZodString;
         mergeBaseRef: z$1.ZodNullable<z$1.ZodString>;
+        truncated: z$1.ZodBoolean;
     }, z$1.core.$strict>, z$1.ZodObject<{
         outcome: z$1.ZodLiteral<"unavailable">;
         failure: z$1.ZodObject<{
             code: z$1.ZodEnum<{
+                unknown: "unknown";
                 path_not_found: "path_not_found";
                 not_git_repo: "not_git_repo";
                 not_worktree: "not_worktree";
                 workspace_type_mismatch: "workspace_type_mismatch";
                 permission_denied: "permission_denied";
                 unknown_environment: "unknown_environment";
-                unknown: "unknown";
             }>;
             workspacePath: z$1.ZodString;
             message: z$1.ZodString;
@@ -6010,13 +6018,13 @@ declare const hostDaemonCommandRegistry: {
         outcome: z$1.ZodLiteral<"unavailable">;
         failure: z$1.ZodObject<{
             code: z$1.ZodEnum<{
+                unknown: "unknown";
                 path_not_found: "path_not_found";
                 not_git_repo: "not_git_repo";
                 not_worktree: "not_worktree";
                 workspace_type_mismatch: "workspace_type_mismatch";
                 permission_denied: "permission_denied";
                 unknown_environment: "unknown_environment";
-                unknown: "unknown";
             }>;
             workspacePath: z$1.ZodString;
             message: z$1.ZodString;
@@ -6059,9 +6067,9 @@ declare const hostDaemonCommandRegistry: {
                 conclusion: z$1.ZodNullable<z$1.ZodEnum<{
                     unknown: "unknown";
                     success: "success";
+                    skipped: "skipped";
                     cancelled: "cancelled";
                     failure: "failure";
-                    skipped: "skipped";
                     neutral: "neutral";
                     timed_out: "timed_out";
                     action_required: "action_required";
@@ -6146,8 +6154,8 @@ declare const providerCliStatusResponseSchema: z$1.ZodRecord<z$1.ZodEnum<{
     npmGlobalPackageVersion: z$1.ZodNullable<z$1.ZodString>;
     installAction: z$1.ZodNullable<z$1.ZodObject<{
         kind: z$1.ZodEnum<{
-            install: "install";
             update: "update";
+            install: "install";
         }>;
         label: z$1.ZodEnum<{
             Install: "Install";
@@ -6170,8 +6178,8 @@ declare const providerCliInstallRequestSchema: z$1.ZodObject<{
         cursor: "cursor";
     }>;
     actionKind: z$1.ZodEnum<{
-        install: "install";
         update: "update";
+        install: "install";
     }>;
 }, z$1.core.$strip>;
 type ProviderCliInstallRequest = z$1.infer<typeof providerCliInstallRequestSchema>;
@@ -6331,6 +6339,10 @@ type PluginApplyUpdateResult$1 = z$1.infer<typeof pluginApplyUpdateResultSchema>
 declare const pluginSourceDetailSchema: z$1.ZodObject<{
     requested: z$1.ZodString;
     resolved: z$1.ZodString;
+    subdirectory: z$1.ZodOptional<z$1.ZodString>;
+    range: z$1.ZodOptional<z$1.ZodString>;
+    tagPrefix: z$1.ZodOptional<z$1.ZodString>;
+    resolvedTag: z$1.ZodOptional<z$1.ZodString>;
     integrity: z$1.ZodOptional<z$1.ZodString>;
     registry: z$1.ZodOptional<z$1.ZodString>;
     engines: z$1.ZodObject<{
@@ -6356,6 +6368,8 @@ declare const installedPluginSchema: z$1.ZodObject<{
     }>;
     isOrphanedBuiltin: z$1.ZodBoolean;
     catalogEntryId: z$1.ZodOptional<z$1.ZodString>;
+    catalogMarketplaceName: z$1.ZodOptional<z$1.ZodString>;
+    publisherLabel: z$1.ZodNullable<z$1.ZodString>;
     sourceDisplay: z$1.ZodString;
     updateState: z$1.ZodObject<{
         outcome: z$1.ZodOptional<z$1.ZodEnum<{
@@ -6365,6 +6379,7 @@ declare const installedPluginSchema: z$1.ZodObject<{
             "update-available": "update-available";
             pinned: "pinned";
         }>>;
+        detail: z$1.ZodOptional<z$1.ZodString>;
         availableVersion: z$1.ZodOptional<z$1.ZodString>;
         blockedVersion: z$1.ZodOptional<z$1.ZodString>;
         blockedReasons: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
@@ -6460,6 +6475,8 @@ declare const pluginListResponseSchema: z$1.ZodObject<{
         }>;
         isOrphanedBuiltin: z$1.ZodBoolean;
         catalogEntryId: z$1.ZodOptional<z$1.ZodString>;
+        catalogMarketplaceName: z$1.ZodOptional<z$1.ZodString>;
+        publisherLabel: z$1.ZodNullable<z$1.ZodString>;
         sourceDisplay: z$1.ZodString;
         updateState: z$1.ZodObject<{
             outcome: z$1.ZodOptional<z$1.ZodEnum<{
@@ -6469,6 +6486,7 @@ declare const pluginListResponseSchema: z$1.ZodObject<{
                 "update-available": "update-available";
                 pinned: "pinned";
             }>>;
+            detail: z$1.ZodOptional<z$1.ZodString>;
             availableVersion: z$1.ZodOptional<z$1.ZodString>;
             blockedVersion: z$1.ZodOptional<z$1.ZodString>;
             blockedReasons: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
@@ -6566,6 +6584,8 @@ declare const pluginReloadResponseSchema: z$1.ZodObject<{
         }>;
         isOrphanedBuiltin: z$1.ZodBoolean;
         catalogEntryId: z$1.ZodOptional<z$1.ZodString>;
+        catalogMarketplaceName: z$1.ZodOptional<z$1.ZodString>;
+        publisherLabel: z$1.ZodNullable<z$1.ZodString>;
         sourceDisplay: z$1.ZodString;
         updateState: z$1.ZodObject<{
             outcome: z$1.ZodOptional<z$1.ZodEnum<{
@@ -6575,6 +6595,7 @@ declare const pluginReloadResponseSchema: z$1.ZodObject<{
                 "update-available": "update-available";
                 pinned: "pinned";
             }>>;
+            detail: z$1.ZodOptional<z$1.ZodString>;
             availableVersion: z$1.ZodOptional<z$1.ZodString>;
             blockedVersion: z$1.ZodOptional<z$1.ZodString>;
             blockedReasons: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
@@ -6707,13 +6728,141 @@ declare const pluginCatalogSearchResultSchema: z$1.ZodObject<{
     displayName: z$1.ZodString;
     description: z$1.ZodString;
     icon: z$1.ZodNullable<z$1.ZodString>;
+    iconUrl: z$1.ZodNullable<z$1.ZodString>;
     category: z$1.ZodString;
     source: z$1.ZodString;
+    marketplace: z$1.ZodString;
+    marketplaceDisplayName: z$1.ZodString;
+    publisherKey: z$1.ZodString;
+    publisherLabel: z$1.ZodString;
+    official: z$1.ZodBoolean;
+    author: z$1.ZodNullable<z$1.ZodObject<{
+        name: z$1.ZodString;
+        url: z$1.ZodNullable<z$1.ZodString>;
+    }, z$1.core.$strip>>;
     installed: z$1.ZodBoolean;
     compatible: z$1.ZodBoolean;
     incompatibleReason: z$1.ZodNullable<z$1.ZodString>;
 }, z$1.core.$strip>;
 type PluginCatalogSearchResult$1 = z$1.infer<typeof pluginCatalogSearchResultSchema>;
+/**
+ * The true source an install will run against, resolved before anything runs.
+ * Both kinds report the exact artifact they resolve to right now — a commit
+ * for git, a version and its integrity for npm — so a range or tag install is
+ * confirmed against the exact code it will fetch.
+ */
+declare const pluginCatalogResolvedSourceSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+    kind: z$1.ZodLiteral<"npm">;
+    package: z$1.ZodString;
+    range: z$1.ZodOptional<z$1.ZodString>;
+    tag: z$1.ZodOptional<z$1.ZodString>;
+    registry: z$1.ZodOptional<z$1.ZodString>;
+    resolvedVersion: z$1.ZodOptional<z$1.ZodString>;
+    resolvedIntegrity: z$1.ZodOptional<z$1.ZodString>;
+    unresolvedReason: z$1.ZodOptional<z$1.ZodString>;
+}, z$1.core.$strict>, z$1.ZodObject<{
+    kind: z$1.ZodLiteral<"git">;
+    url: z$1.ZodString;
+    subdir: z$1.ZodOptional<z$1.ZodString>;
+    ref: z$1.ZodOptional<z$1.ZodString>;
+    range: z$1.ZodOptional<z$1.ZodString>;
+    tagPrefix: z$1.ZodOptional<z$1.ZodString>;
+    resolvedTag: z$1.ZodOptional<z$1.ZodString>;
+    resolvedCommit: z$1.ZodOptional<z$1.ZodString>;
+    unresolvedReason: z$1.ZodOptional<z$1.ZodString>;
+}, z$1.core.$strict>], "kind">;
+type PluginCatalogResolvedSource = z$1.infer<typeof pluginCatalogResolvedSourceSchema>;
+/**
+ * What `POST /plugin-catalog/install` would do with the same arguments, shown
+ * to the user before anything runs. `bundled` entries install from the copy
+ * inside the app; `marketplace` entries install from their listed source.
+ */
+declare const pluginCatalogInstallPlanSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+    kind: z$1.ZodLiteral<"bundled">;
+    entryId: z$1.ZodString;
+    pluginId: z$1.ZodString;
+    displayName: z$1.ZodString;
+    source: z$1.ZodString;
+    compatible: z$1.ZodBoolean;
+    incompatibleReason: z$1.ZodNullable<z$1.ZodString>;
+}, z$1.core.$strip>, z$1.ZodObject<{
+    kind: z$1.ZodLiteral<"marketplace">;
+    entryId: z$1.ZodString;
+    pluginId: z$1.ZodString;
+    displayName: z$1.ZodString;
+    marketplace: z$1.ZodString;
+    marketplaceDisplayName: z$1.ZodString;
+    official: z$1.ZodBoolean;
+    author: z$1.ZodObject<{
+        name: z$1.ZodString;
+        url: z$1.ZodNullable<z$1.ZodString>;
+    }, z$1.core.$strip>;
+    source: z$1.ZodString;
+    resolvedSource: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+        kind: z$1.ZodLiteral<"npm">;
+        package: z$1.ZodString;
+        range: z$1.ZodOptional<z$1.ZodString>;
+        tag: z$1.ZodOptional<z$1.ZodString>;
+        registry: z$1.ZodOptional<z$1.ZodString>;
+        resolvedVersion: z$1.ZodOptional<z$1.ZodString>;
+        resolvedIntegrity: z$1.ZodOptional<z$1.ZodString>;
+        unresolvedReason: z$1.ZodOptional<z$1.ZodString>;
+    }, z$1.core.$strict>, z$1.ZodObject<{
+        kind: z$1.ZodLiteral<"git">;
+        url: z$1.ZodString;
+        subdir: z$1.ZodOptional<z$1.ZodString>;
+        ref: z$1.ZodOptional<z$1.ZodString>;
+        range: z$1.ZodOptional<z$1.ZodString>;
+        tagPrefix: z$1.ZodOptional<z$1.ZodString>;
+        resolvedTag: z$1.ZodOptional<z$1.ZodString>;
+        resolvedCommit: z$1.ZodOptional<z$1.ZodString>;
+        unresolvedReason: z$1.ZodOptional<z$1.ZodString>;
+    }, z$1.core.$strict>], "kind">;
+    compatible: z$1.ZodBoolean;
+    incompatibleReason: z$1.ZodNullable<z$1.ZodString>;
+}, z$1.core.$strip>], "kind">;
+type PluginCatalogInstallPlan = z$1.infer<typeof pluginCatalogInstallPlanSchema>;
+declare const pluginMarketplaceSchema: z$1.ZodObject<{
+    name: z$1.ZodString;
+    displayName: z$1.ZodString;
+    description: z$1.ZodNullable<z$1.ZodString>;
+    official: z$1.ZodBoolean;
+    sourceKind: z$1.ZodEnum<{
+        path: "path";
+        git: "git";
+        https: "https";
+    }>;
+    source: z$1.ZodString;
+    resolvedCommit: z$1.ZodNullable<z$1.ZodString>;
+    entryCount: z$1.ZodNumber;
+    lastRefreshAt: z$1.ZodNullable<z$1.ZodNumber>;
+    lastAttemptAt: z$1.ZodNullable<z$1.ZodNumber>;
+    lastError: z$1.ZodNullable<z$1.ZodString>;
+}, z$1.core.$strip>;
+type PluginMarketplace = z$1.infer<typeof pluginMarketplaceSchema>;
+declare const pluginMarketplaceRefreshResultSchema: z$1.ZodObject<{
+    name: z$1.ZodString;
+    ok: z$1.ZodBoolean;
+    error: z$1.ZodNullable<z$1.ZodString>;
+    marketplace: z$1.ZodObject<{
+        name: z$1.ZodString;
+        displayName: z$1.ZodString;
+        description: z$1.ZodNullable<z$1.ZodString>;
+        official: z$1.ZodBoolean;
+        sourceKind: z$1.ZodEnum<{
+            path: "path";
+            git: "git";
+            https: "https";
+        }>;
+        source: z$1.ZodString;
+        resolvedCommit: z$1.ZodNullable<z$1.ZodString>;
+        entryCount: z$1.ZodNumber;
+        lastRefreshAt: z$1.ZodNullable<z$1.ZodNumber>;
+        lastAttemptAt: z$1.ZodNullable<z$1.ZodNumber>;
+        lastError: z$1.ZodNullable<z$1.ZodString>;
+    }, z$1.core.$strip>;
+}, z$1.core.$strip>;
+type PluginMarketplaceRefreshResult$1 = z$1.infer<typeof pluginMarketplaceRefreshResultSchema>;
 
 declare const systemExecutionOptionsResponseSchema: z$1.ZodObject<{
     providers: z$1.ZodArray<z$1.ZodObject<{
@@ -7206,6 +7355,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
         claudeCodeMockCliTraffic: "claudeCodeMockCliTraffic";
         editMessages: "editMessages";
         newOnboarding: "newOnboarding";
+        providerSessionReaping: "providerSessionReaping";
     }>, z$1.ZodBoolean>;
     appearance: z$1.ZodObject<{
         themeId: z$1.ZodString;
@@ -10034,8 +10184,8 @@ declare const threadTimelineResponseSchema: z$1.ZodObject<{
     activePromptMode: z$1.ZodNullable<z$1.ZodObject<{
         mode: z$1.ZodLiteral<"plan">;
         providerId: z$1.ZodEnum<{
-            codex: "codex";
             "claude-code": "claude-code";
+            codex: "codex";
         }>;
         prompt: z$1.ZodString;
     }, z$1.core.$strict>>;
@@ -12224,11 +12374,62 @@ interface PluginIdArgs {
 }
 /** Install directly from a path:, git:, npm:, or builtin: source spec. */
 interface PluginInstallArgs {
+    /**
+     * `path:<dir>`, `builtin:<name>`, `npm:<package>[@<version|tag|range>]`, or
+     * `git:<url>[@<spec>]`. A git spec is one ref, or a semver range resolved
+     * over the repository's `[<tagPrefix>]vX.Y.Z` release tags:
+     * `git:<url>@semver:<range>` and `git:<url>@semver:<tagPrefix>:<range>` say
+     * range explicitly, `git:<url>@ref:<name>` says ref explicitly, and a bare
+     * `^1.2.0` resolves over tags unless the repository also has a ref of that
+     * literal name (which is refused as ambiguous).
+     */
     source: string;
+    /**
+     * Directory of a multi-plugin repository to install, relative to the
+     * repository root (`git:` and `path:` sources only).
+     */
+    subdirectory?: string;
+    /**
+     * Name of a `.bb/plugins.json` collection entry to install, resolved to its
+     * directory in the repository. Mutually exclusive with `subdirectory`.
+     */
+    plugin?: string;
 }
-/** Install an entry from BB's official catalog. */
+/** Install a catalog entry, from BB's official catalog or another marketplace. */
 interface PluginCatalogInstallArgs {
     entryId: string;
+    /**
+     * Marketplace that lists the entry. Omitted resolves across every
+     * marketplace: exactly one match installs, none falls back to the bundled
+     * official plugin of that name, and several are refused as ambiguous.
+     */
+    marketplace?: string;
+    /**
+     * Source facts returned by installPlan for a third-party entry. The server
+     * refuses the install when the listing or its git commit changed afterward.
+     */
+    confirmedSource?: PluginCatalogResolvedSource;
+}
+/** Ask what an install would do before confirming it. */
+interface PluginCatalogInstallPlanArgs {
+    entryId: string;
+    marketplace?: string;
+    signal?: AbortSignal;
+}
+/** Add a marketplace by `https:` manifest URL, `git:<url>[@ref]`, or `path:<dir>`. */
+interface PluginMarketplaceAddArgs {
+    source: string;
+}
+interface PluginMarketplaceListArgs {
+    signal?: AbortSignal;
+}
+interface PluginMarketplaceRefreshArgs {
+    /** One marketplace to refresh; omitted refreshes every one of them. */
+    name?: string;
+    signal?: AbortSignal;
+}
+interface PluginMarketplaceRemoveArgs {
+    name: string;
 }
 interface PluginReloadArgs {
     pluginId?: string;
@@ -12281,22 +12482,34 @@ type PluginCheckUpdatesResult = PluginUpdateCheckEntry[];
 type PluginApplyUpdateResult = PluginApplyUpdateResult$1;
 type PluginCatalogStatusResult = PluginCatalogStatus;
 type PluginCatalogSearchResult = PluginCatalogSearchResult$1[];
-interface PluginCatalogSubmissionResult {
-    /** BB's canonical browser form for proposing a plugin to the marketplace. */
-    url: string;
+type PluginCatalogInstallPlanResult = PluginCatalogInstallPlan;
+type PluginMarketplaceListResult = PluginMarketplace[];
+type PluginMarketplaceAddResult = PluginMarketplace;
+type PluginMarketplaceRefreshResult = PluginMarketplaceRefreshResult$1[];
+interface PluginMarketplaceRemoveResult {
+    /** Installs whose provenance became `direct`; they keep running as before. */
+    convertedPluginIds: string[];
 }
 interface PluginCatalogArea {
     install(args: PluginCatalogInstallArgs): Promise<PluginInstallResult>;
+    /** The true resolved source an install would use, before anything runs. */
+    installPlan(args: PluginCatalogInstallPlanArgs): Promise<PluginCatalogInstallPlanResult>;
     search(args: PluginCatalogSearchArgs): Promise<PluginCatalogSearchResult>;
     status(args?: PluginCatalogStatusArgs): Promise<PluginCatalogStatusResult>;
-    /** Return the canonical marketplace submission form; submitting stays browser-owned. */
-    submission(): PluginCatalogSubmissionResult;
+}
+/** Registered marketplaces. Adding one installs nothing; removing one uninstalls nothing. */
+interface PluginMarketplacesArea {
+    add(args: PluginMarketplaceAddArgs): Promise<PluginMarketplaceAddResult>;
+    list(args?: PluginMarketplaceListArgs): Promise<PluginMarketplaceListResult>;
+    refresh(args?: PluginMarketplaceRefreshArgs): Promise<PluginMarketplaceRefreshResult>;
+    remove(args: PluginMarketplaceRemoveArgs): Promise<PluginMarketplaceRemoveResult>;
 }
 interface PluginsArea {
     applyUpdate(args: PluginIdArgs): Promise<PluginApplyUpdateResult>;
     callRpc<TOutput>(args: PluginRpcArgs<TOutput>): Promise<TOutput>;
     checkUpdates(args?: PluginCheckUpdatesArgs): Promise<PluginCheckUpdatesResult>;
     catalog: PluginCatalogArea;
+    marketplaces: PluginMarketplacesArea;
     disable(args: PluginIdArgs): Promise<PluginDisableResult>;
     enable(args: PluginIdArgs): Promise<PluginEnableResult>;
     getSettings(args: PluginGetSettingsArgs): Promise<PluginGetSettingsResult>;
@@ -12996,6 +13209,10 @@ interface ThreadsArea {
     search(args: ThreadSearchArgs): Promise<ThreadSearchResult>;
     send(args: ThreadSendArgs): Promise<ThreadSendResult>;
     spawn(args: ThreadSpawnArgs): Promise<ThreadSpawnResult>;
+    /**
+     * Stop active work and release the loaded agent runtime. This operation is
+     * idempotent and preserves thread history for a later resume.
+     */
     stop(args: ThreadActionArgs): Promise<ThreadStopResult>;
     tabs: ThreadTabsArea;
     timeline(args: ThreadTimelineArgs): Promise<ThreadTimelineResult>;

package/package.json

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