@get-bb/plugin-sdk 0.4.104 → 0.4.106

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

@@ -2470,9 +2470,8 @@ interface ExperimentalProviderModelPickerProps {
 /**
  * Props of the host-owned `experimental_BranchPicker` component — bb's branch
  * picker bundled with its branch-options loading for the given host and
- * project, the control bb's own New Thread composer renders as "Branch from".
- * The host owns fetching, searching, and refreshing the branch list; the
- * caller owns only the selection.
+ * project. The host owns fetching, searching, and refreshing the branch list;
+ * the caller owns the selection and its meaning.
  */
 interface BranchPickerProps {
     /**
@@ -2483,21 +2482,21 @@ interface BranchPickerProps {
     /** The project whose source on `hostId` is listed; null disables loading. */
     projectId: string | null;
     /**
-     * The selected branch name, or null when no branch is chosen (the host
-     * shows its placeholder and the consumer falls back to its own default).
+     * The selected branch name, or null when no branch is chosen. A null value
+     * shows the placeholder without selecting or implying a default branch.
      */
     value: string | null;
     /** Called with the picked branch name, or null when the pick is cleared. */
     onChange(next: string | null): void;
     /**
-     * Text placed before the branch on the trigger, e.g. "Base:". Omitted, the
-     * trigger is the branch alone.
+     * Text placed before the branch on the trigger and used as the menu heading,
+     * e.g. "Compare with:". Omitted, the trigger is the branch alone and the menu
+     * uses the neutral "Branches" heading.
      */
     label?: string;
     /**
-     * The trigger while nothing is picked. Omitted, the host shows the resolved
-     * default worktree base branch muted, or a neutral `default` placeholder
-     * when the base cannot be resolved.
+     * The complete trigger text while nothing is picked, without the label
+     * prefix. Defaults to "Select branch".
      */
     placeholder?: string;
     /** Render the current selection without allowing changes. */

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

@@ -292,6 +292,8 @@ interface PluginEnvironmentProviderDefinition<R extends PluginEnvironmentProvide
     /** Experimental per-machine availability, probed in the background for pickers and again at thread creation: see docs/api_to_audit.md. */
     availability?(context: PluginEnvironmentProviderAvailabilityContext): PluginEnvironmentProviderAvailability | Promise<PluginEnvironmentProviderAvailability>;
     validate?(context: PluginEnvironmentProviderValidateContext<R, S>): PluginEnvironmentValidateDecision | Promise<PluginEnvironmentValidateDecision>;
+    /** 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>;
     remove(context: PluginEnvironmentProviderRemoveContext): Promise<PluginEnvironmentProviderRemoveResult>;
 }

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

@@ -630,6 +630,8 @@ interface PluginEnvironmentProviderDefinition<R extends PluginEnvironmentProvide
     /** Experimental per-machine availability, probed in the background for pickers and again at thread creation: see docs/api_to_audit.md. */
     availability?(context: PluginEnvironmentProviderAvailabilityContext): PluginEnvironmentProviderAvailability | Promise<PluginEnvironmentProviderAvailability>;
     validate?(context: PluginEnvironmentProviderValidateContext<R, S>): PluginEnvironmentValidateDecision | Promise<PluginEnvironmentValidateDecision>;
+    /** 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>;
     remove(context: PluginEnvironmentProviderRemoveContext): Promise<PluginEnvironmentProviderRemoveResult>;
 }
@@ -1931,6 +1933,7 @@ interface NormalizedPluginEnvironmentProvider {
     inputsJsonSchema: JsonValue | null;
     availability: NonNullable<PluginEnvironmentProviderDeclaration["availability"]> | null;
     validate: NonNullable<PluginEnvironmentProviderDeclaration["validate"]> | null;
+    experimental_existingPath: NonNullable<PluginEnvironmentProviderDeclaration["experimental_existingPath"]> | null;
     create: PluginEnvironmentProviderDeclaration["create"];
     remove: PluginEnvironmentProviderDeclaration["remove"];
     policy: PluginEnvironmentProviderPolicy;

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

@@ -423,6 +423,8 @@ interface PluginEnvironmentProviderDefinition<R extends PluginEnvironmentProvide
     /** Experimental per-machine availability, probed in the background for pickers and again at thread creation: see docs/api_to_audit.md. */
     availability?(context: PluginEnvironmentProviderAvailabilityContext): PluginEnvironmentProviderAvailability | Promise<PluginEnvironmentProviderAvailability>;
     validate?(context: PluginEnvironmentProviderValidateContext<R, S>): PluginEnvironmentValidateDecision | Promise<PluginEnvironmentValidateDecision>;
+    /** 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>;
     remove(context: PluginEnvironmentProviderRemoveContext): Promise<PluginEnvironmentProviderRemoveResult>;
 }
@@ -980,6 +982,7 @@ interface NormalizedPluginEnvironmentProvider {
     inputsJsonSchema: JsonValue | null;
     availability: NonNullable<PluginEnvironmentProviderDeclaration["availability"]> | null;
     validate: NonNullable<PluginEnvironmentProviderDeclaration["validate"]> | null;
+    experimental_existingPath: NonNullable<PluginEnvironmentProviderDeclaration["experimental_existingPath"]> | null;
     create: PluginEnvironmentProviderDeclaration["create"];
     remove: PluginEnvironmentProviderDeclaration["remove"];
     policy: PluginEnvironmentProviderPolicy;

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

@@ -17215,9 +17215,8 @@ interface ExperimentalProviderModelPickerProps {
 /**
  * Props of the host-owned `experimental_BranchPicker` component — bb's branch
  * picker bundled with its branch-options loading for the given host and
- * project, the control bb's own New Thread composer renders as "Branch from".
- * The host owns fetching, searching, and refreshing the branch list; the
- * caller owns only the selection.
+ * project. The host owns fetching, searching, and refreshing the branch list;
+ * the caller owns the selection and its meaning.
  */
 interface BranchPickerProps {
     /**
@@ -17228,21 +17227,21 @@ interface BranchPickerProps {
     /** The project whose source on `hostId` is listed; null disables loading. */
     projectId: string | null;
     /**
-     * The selected branch name, or null when no branch is chosen (the host
-     * shows its placeholder and the consumer falls back to its own default).
+     * The selected branch name, or null when no branch is chosen. A null value
+     * shows the placeholder without selecting or implying a default branch.
      */
     value: string | null;
     /** Called with the picked branch name, or null when the pick is cleared. */
     onChange(next: string | null): void;
     /**
-     * Text placed before the branch on the trigger, e.g. "Base:". Omitted, the
-     * trigger is the branch alone.
+     * Text placed before the branch on the trigger and used as the menu heading,
+     * e.g. "Compare with:". Omitted, the trigger is the branch alone and the menu
+     * uses the neutral "Branches" heading.
      */
     label?: string;
     /**
-     * The trigger while nothing is picked. Omitted, the host shows the resolved
-     * default worktree base branch muted, or a neutral `default` placeholder
-     * when the base cannot be resolved.
+     * The complete trigger text while nothing is picked, without the label
+     * prefix. Defaults to "Select branch".
      */
     placeholder?: string;
     /** Render the current selection without allowing changes. */
@@ -17917,6 +17916,8 @@ interface PluginEnvironmentProviderDefinition<R extends PluginEnvironmentProvide
     /** Experimental per-machine availability, probed in the background for pickers and again at thread creation: see docs/api_to_audit.md. */
     availability?(context: PluginEnvironmentProviderAvailabilityContext): PluginEnvironmentProviderAvailability | Promise<PluginEnvironmentProviderAvailability>;
     validate?(context: PluginEnvironmentProviderValidateContext<R, S>): PluginEnvironmentValidateDecision$1 | Promise<PluginEnvironmentValidateDecision$1>;
+    /** 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>;
     remove(context: PluginEnvironmentProviderRemoveContext): Promise<PluginEnvironmentProviderRemoveResult>;
 }

package/dist/internal/host-policy.js

@@ -1983,6 +1983,12 @@ function validatePluginEnvironmentProviderDeclaration(declaration) {
     declaration.availability,
     "availability"
   );
+  assertOptionalFunction(
+    "environment provider",
+    id,
+    declaration.experimental_existingPath,
+    "experimental_existingPath"
+  );
   return {
     id,
     displayName,
@@ -1993,6 +1999,7 @@ function validatePluginEnvironmentProviderDeclaration(declaration) {
     inputsJsonSchema: inputs === null ? null : inputs.jsonSchema,
     availability: declaration.availability ?? null,
     validate: declaration.validate ?? null,
+    experimental_existingPath: declaration.experimental_existingPath ?? null,
     create: declaration.create,
     remove: declaration.remove,
     policy: environmentProviderPolicySchema.parse(declaration.policy ?? {})

package/dist/provider-bridge-acp.js

@@ -9277,7 +9277,7 @@ async function handleFsWriteTextFile(session, params, responder) {
       ...oldText === void 0 ? {} : { oldText },
       content: parsed.data.content
     });
-    responder.result(null);
+    responder.result({});
   } catch (error) {
     responder.error(
       -32603,

package/dist/testing/app.js

@@ -15157,7 +15157,7 @@ function TestBranchPicker({
         "input",
         {
           "aria-label": label ?? "Branch",
-          placeholder: placeholder ?? "",
+          placeholder: placeholder ?? "Select branch",
           disabled: inert,
           value: value ?? "",
           onChange: (event) => {

package/dist/testing/index.js

@@ -2008,6 +2008,12 @@ function validatePluginEnvironmentProviderDeclaration(declaration) {
     declaration.availability,
     "availability"
   );
+  assertOptionalFunction(
+    "environment provider",
+    id,
+    declaration.experimental_existingPath,
+    "experimental_existingPath"
+  );
   return {
     id,
     displayName,
@@ -2018,6 +2024,7 @@ function validatePluginEnvironmentProviderDeclaration(declaration) {
     inputsJsonSchema: inputs === null ? null : inputs.jsonSchema,
     availability: declaration.availability ?? null,
     validate: declaration.validate ?? null,
+    experimental_existingPath: declaration.experimental_existingPath ?? null,
     create: declaration.create,
     remove: declaration.remove,
     policy: environmentProviderPolicySchema.parse(declaration.policy ?? {})

package/package.json

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