@get-bb/plugin-sdk 0.4.101 → 0.4.106

package/dist/internal/host-policy.js

@@ -25,6 +25,7 @@ function parseNamespacedGlyph(glyph) {
 // ../domain/src/plugin-cli.ts
 var RESERVED_BB_CLI_COMMANDS = [
   "browser",
+  "diagnostics",
   "environment",
   "file",
   "guide",
@@ -1705,12 +1706,12 @@ function rejectStaleAgentToolFields(toolName, tool) {
     );
   }
 }
-function parsePluginAgentToolPresentation(toolName, value) {
+function parsePluginRowPresentation(subject, value) {
   if (value === void 0) {
     return null;
   }
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
-    throw new Error(`tool "${toolName}" presentation must be an object`);
+    throw new Error(`${subject} presentation must be an object`);
   }
   const declared = value;
   const presentation = {};
@@ -1718,13 +1719,13 @@ function parsePluginAgentToolPresentation(toolName, value) {
     const label = declared.label;
     if (typeof label !== "object" || label === null || typeof label.pending !== "string" || typeof label.completed !== "string") {
       throw new Error(
-        `tool "${toolName}" presentation.label must provide pending and completed strings`
+        `${subject} presentation.label must provide pending and completed strings`
       );
     }
     const { pending, completed } = label;
     if (pending.trim().length === 0 || completed.trim().length === 0 || pending.length > PLUGIN_AGENT_STATUS_LABEL_MAX_CHARS || completed.length > PLUGIN_AGENT_STATUS_LABEL_MAX_CHARS) {
       throw new Error(
-        `tool "${toolName}" presentation.label strings must be non-empty and at most ${PLUGIN_AGENT_STATUS_LABEL_MAX_CHARS} characters`
+        `${subject} presentation.label strings must be non-empty and at most ${PLUGIN_AGENT_STATUS_LABEL_MAX_CHARS} characters`
       );
     }
     presentation.label = { pending, completed };
@@ -1732,17 +1733,13 @@ function parsePluginAgentToolPresentation(toolName, value) {
   if (declared.icon !== void 0) {
     const icon = declared.icon;
     if (typeof icon !== "object" || icon === null || typeof icon.glyph !== "string" || icon.glyph.trim().length === 0) {
-      throw new Error(
-        `tool "${toolName}" presentation.icon must be { glyph: string }`
-      );
+      throw new Error(`${subject} presentation.icon must be { glyph: string }`);
     }
     presentation.icon = { glyph: icon.glyph };
   }
   if (declared.suppress !== void 0) {
     if (typeof declared.suppress !== "boolean") {
-      throw new Error(
-        `tool "${toolName}" presentation.suppress must be a boolean`
-      );
+      throw new Error(`${subject} presentation.suppress must be a boolean`);
     }
     presentation.suppress = declared.suppress;
   }
@@ -1750,7 +1747,7 @@ function parsePluginAgentToolPresentation(toolName, value) {
     const tint = declared.tint;
     if (typeof tint !== "object" || tint === null || typeof tint.light !== "string" || typeof tint.dark !== "string") {
       throw new Error(
-        `tool "${toolName}" presentation.tint must provide light and dark strings`
+        `${subject} presentation.tint must provide light and dark strings`
       );
     }
     presentation.tint = {
@@ -1986,6 +1983,12 @@ function validatePluginEnvironmentProviderDeclaration(declaration) {
     declaration.availability,
     "availability"
   );
+  assertOptionalFunction(
+    "environment provider",
+    id,
+    declaration.experimental_existingPath,
+    "experimental_existingPath"
+  );
   return {
     id,
     displayName,
@@ -1996,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 ?? {})
@@ -2333,6 +2337,7 @@ function normalizeCliRegistration(registration, alreadyRegistered) {
     name,
     summary: registration.summary,
     commands: validatedCommands,
+    rendersHelp: registration.rendersHelp === true,
     run: registration.run.bind(registration)
   };
 }
@@ -2361,8 +2366,8 @@ function normalizeAgentToolRegistration(args) {
       `tool "${name}" instructions exceed the ${PLUGIN_AGENT_STATIC_INSTRUCTIONS_MAX_CHARS}-character limit`
     );
   }
-  const presentation = parsePluginAgentToolPresentation(
-    name,
+  const presentation = parsePluginRowPresentation(
+    `tool "${name}"`,
     tool.presentation
   );
   if (presentation?.icon !== void 0) {
@@ -2490,12 +2495,20 @@ function normalizeInteractionRequest(request) {
   if (!Number.isInteger(timeoutMs) || timeoutMs <= 0 || timeoutMs > 60 * 60 * 1e3) {
     throw new Error("ui.requestInput timeoutMs must be between 1 and 3600000");
   }
+  if (request.describeSubmission !== void 0 && typeof request.describeSubmission !== "function") {
+    throw new Error("ui.requestInput describeSubmission must be a function");
+  }
   return {
     threadId: request.threadId,
     rendererId: request.rendererId,
     title: request.title.trim(),
     payload,
-    timeoutMs
+    timeoutMs,
+    presentation: parsePluginRowPresentation(
+      `ui.requestInput form "${request.rendererId}"`,
+      request.presentation
+    ),
+    describeSubmission: request.describeSubmission ?? null
   };
 }
 function validateProviderEnvContribution(label, providerId, resolve, registered) {
@@ -2807,7 +2820,7 @@ export {
   normalizeRpcJsonResult,
   normalizeRpcRegistration,
   normalizeWebSocketRouteRegistration,
-  parsePluginAgentToolPresentation,
+  parsePluginRowPresentation,
   pluginCliCollisionWarning,
   pluginHookAlreadyRegisteredMessage,
   providerAlreadyRegisteredMessage,

package/dist/provider-bridge-acp.js

@@ -1500,7 +1500,8 @@ var userQuestionPendingInteractionPayloadSchema = z10.object({
 var pluginPendingInteractionPayloadSchema = z10.object({
   kind: z10.literal("plugin"),
   title: z10.string().trim().min(1).max(PLUGIN_INTERACTION_MAX_TITLE_LENGTH),
-  data: jsonValueSchema
+  data: jsonValueSchema,
+  presentation: threadEventItemPresentationSchema.optional()
 });
 var pluginExtensionInteractionRequestPayloadSchema = z10.object({
   kind: extensionKindSchema,
@@ -1551,8 +1552,17 @@ var userQuestionPendingInteractionResolutionSchema = z10.object({
   kind: z10.literal("user_answer"),
   answers: z10.record(z10.string().min(1), pendingInteractionUserAnswerSchema)
 });
+var pluginInteractionDescriptionSchema = z10.object({
+  title: z10.string().trim().min(1).max(PLUGIN_INTERACTION_MAX_TITLE_LENGTH).optional(),
+  detail: z10.string().trim().min(1).max(THREAD_EVENT_ITEM_PRESENTATION_DETAIL_MAX_LENGTH).optional(),
+  payload: jsonValueSchema.refine(
+    (value) => jsonByteLength(value) <= PLUGIN_INTERACTION_MAX_PAYLOAD_BYTES,
+    { message: "Plugin interaction description payload exceeds 64 KiB" }
+  ).optional()
+});
 var pluginPendingInteractionResolutionSchema = z10.object({
-  kind: z10.literal("plugin_submitted")
+  kind: z10.literal("plugin_submitted"),
+  description: pluginInteractionDescriptionSchema.optional()
 });
 var pluginExtensionInteractionResolutionSchema = z10.object({
   kind: z10.literal("request_answer"),
@@ -1703,6 +1713,7 @@ var systemMessageKindValues = [
   "child-failed",
   "child-interrupted",
   "child-outcome-batch",
+  "tool-result-delivered",
   "unlabeled"
 ];
 var systemMessageKindSchema = z12.enum(systemMessageKindValues);
@@ -1715,6 +1726,11 @@ var systemMessageSubjectSchema = z12.discriminatedUnion("kind", [
   z12.object({
     kind: z12.literal("thread-batch"),
     count: z12.number()
+  }),
+  z12.object({
+    kind: z12.literal("tool-call"),
+    toolName: z12.string(),
+    suppress: z12.boolean()
   })
 ]);
 
@@ -9261,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/provider-bridge-testing.js

@@ -595,7 +595,8 @@ var userQuestionPendingInteractionPayloadSchema = z8.object({
 var pluginPendingInteractionPayloadSchema = z8.object({
   kind: z8.literal("plugin"),
   title: z8.string().trim().min(1).max(PLUGIN_INTERACTION_MAX_TITLE_LENGTH),
-  data: jsonValueSchema
+  data: jsonValueSchema,
+  presentation: threadEventItemPresentationSchema.optional()
 });
 var pluginExtensionInteractionRequestPayloadSchema = z8.object({
   kind: extensionKindSchema,
@@ -643,8 +644,17 @@ var userQuestionPendingInteractionResolutionSchema = z8.object({
   kind: z8.literal("user_answer"),
   answers: z8.record(z8.string().min(1), pendingInteractionUserAnswerSchema)
 });
+var pluginInteractionDescriptionSchema = z8.object({
+  title: z8.string().trim().min(1).max(PLUGIN_INTERACTION_MAX_TITLE_LENGTH).optional(),
+  detail: z8.string().trim().min(1).max(THREAD_EVENT_ITEM_PRESENTATION_DETAIL_MAX_LENGTH).optional(),
+  payload: jsonValueSchema.refine(
+    (value) => jsonByteLength(value) <= PLUGIN_INTERACTION_MAX_PAYLOAD_BYTES,
+    { message: "Plugin interaction description payload exceeds 64 KiB" }
+  ).optional()
+});
 var pluginPendingInteractionResolutionSchema = z8.object({
-  kind: z8.literal("plugin_submitted")
+  kind: z8.literal("plugin_submitted"),
+  description: pluginInteractionDescriptionSchema.optional()
 });
 var pluginExtensionInteractionResolutionSchema = z8.object({
   kind: z8.literal("request_answer"),
@@ -792,6 +802,7 @@ var systemMessageKindValues = [
   "child-failed",
   "child-interrupted",
   "child-outcome-batch",
+  "tool-result-delivered",
   "unlabeled"
 ];
 var systemMessageKindSchema = z10.enum(systemMessageKindValues);
@@ -804,6 +815,11 @@ var systemMessageSubjectSchema = z10.discriminatedUnion("kind", [
   z10.object({
     kind: z10.literal("thread-batch"),
     count: z10.number()
+  }),
+  z10.object({
+    kind: z10.literal("tool-call"),
+    toolName: z10.string(),
+    suppress: z10.boolean()
   })
 ]);
 

package/dist/provider-bridge.js

@@ -2521,7 +2521,8 @@ var userQuestionPendingInteractionPayloadSchema = z12.object({
 var pluginPendingInteractionPayloadSchema = z12.object({
   kind: z12.literal("plugin"),
   title: z12.string().trim().min(1).max(PLUGIN_INTERACTION_MAX_TITLE_LENGTH),
-  data: jsonValueSchema
+  data: jsonValueSchema,
+  presentation: threadEventItemPresentationSchema.optional()
 });
 var pluginExtensionInteractionRequestPayloadSchema = z12.object({
   kind: extensionKindSchema,
@@ -2575,8 +2576,17 @@ var userQuestionPendingInteractionResolutionSchema = z12.object({
   kind: z12.literal("user_answer"),
   answers: z12.record(z12.string().min(1), pendingInteractionUserAnswerSchema)
 });
+var pluginInteractionDescriptionSchema = z12.object({
+  title: z12.string().trim().min(1).max(PLUGIN_INTERACTION_MAX_TITLE_LENGTH).optional(),
+  detail: z12.string().trim().min(1).max(THREAD_EVENT_ITEM_PRESENTATION_DETAIL_MAX_LENGTH).optional(),
+  payload: jsonValueSchema.refine(
+    (value) => jsonByteLength(value) <= PLUGIN_INTERACTION_MAX_PAYLOAD_BYTES,
+    { message: "Plugin interaction description payload exceeds 64 KiB" }
+  ).optional()
+});
 var pluginPendingInteractionResolutionSchema = z12.object({
-  kind: z12.literal("plugin_submitted")
+  kind: z12.literal("plugin_submitted"),
+  description: pluginInteractionDescriptionSchema.optional()
 });
 var pluginExtensionInteractionResolutionSchema = z12.object({
   kind: z12.literal("request_answer"),
@@ -2733,6 +2743,7 @@ var systemMessageKindValues = [
   "child-failed",
   "child-interrupted",
   "child-outcome-batch",
+  "tool-result-delivered",
   "unlabeled"
 ];
 var systemMessageKindSchema = z14.enum(systemMessageKindValues);
@@ -2745,6 +2756,11 @@ var systemMessageSubjectSchema = z14.discriminatedUnion("kind", [
   z14.object({
     kind: z14.literal("thread-batch"),
     count: z14.number()
+  }),
+  z14.object({
+    kind: z14.literal("tool-call"),
+    toolName: z14.string(),
+    suppress: z14.boolean()
   })
 ]);
 

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) => {
@@ -15800,7 +15800,8 @@ function renderSlot(registration, props, options = {}) {
     quotes: [],
     mentions: [],
     focusCount: 0,
-    submits: []
+    submits: [],
+    selections: []
   };
   const composerOwnership = { active: true };
   const submissionListeners = /* @__PURE__ */ new Set();
@@ -15885,6 +15886,22 @@ ${block}
         composerLog.submits.push(options2);
         commitComposerText("");
         for (const listener of submissionListeners) listener();
+      },
+      async experimental_setSelection(selection) {
+        if (!composerOwnership.active) {
+          throw new Error("This composer is no longer active.");
+        }
+        if (composerScope.kind === "queued-message" || composerScope.kind === "side-chat") {
+          throw new Error("This composer has no pickers to set.");
+        }
+        const {
+          projectId: _projectId,
+          environment: _environment,
+          ...rest
+        } = selection;
+        const accepted = composerScope.kind === "thread" ? rest : { ...selection };
+        composerLog.selections.push(accepted);
+        return accepted;
       }
     }
   };

package/dist/testing/index.js

@@ -25,6 +25,7 @@ function parseNamespacedGlyph(glyph) {
 // ../domain/src/plugin-cli.ts
 var RESERVED_BB_CLI_COMMANDS = [
   "browser",
+  "diagnostics",
   "environment",
   "file",
   "guide",
@@ -1740,12 +1741,12 @@ function rejectStaleAgentToolFields(toolName, tool) {
     );
   }
 }
-function parsePluginAgentToolPresentation(toolName, value) {
+function parsePluginRowPresentation(subject, value) {
   if (value === void 0) {
     return null;
   }
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
-    throw new Error(`tool "${toolName}" presentation must be an object`);
+    throw new Error(`${subject} presentation must be an object`);
   }
   const declared = value;
   const presentation = {};
@@ -1753,13 +1754,13 @@ function parsePluginAgentToolPresentation(toolName, value) {
     const label = declared.label;
     if (typeof label !== "object" || label === null || typeof label.pending !== "string" || typeof label.completed !== "string") {
       throw new Error(
-        `tool "${toolName}" presentation.label must provide pending and completed strings`
+        `${subject} presentation.label must provide pending and completed strings`
       );
     }
     const { pending, completed } = label;
     if (pending.trim().length === 0 || completed.trim().length === 0 || pending.length > PLUGIN_AGENT_STATUS_LABEL_MAX_CHARS || completed.length > PLUGIN_AGENT_STATUS_LABEL_MAX_CHARS) {
       throw new Error(
-        `tool "${toolName}" presentation.label strings must be non-empty and at most ${PLUGIN_AGENT_STATUS_LABEL_MAX_CHARS} characters`
+        `${subject} presentation.label strings must be non-empty and at most ${PLUGIN_AGENT_STATUS_LABEL_MAX_CHARS} characters`
       );
     }
     presentation.label = { pending, completed };
@@ -1767,17 +1768,13 @@ function parsePluginAgentToolPresentation(toolName, value) {
   if (declared.icon !== void 0) {
     const icon = declared.icon;
     if (typeof icon !== "object" || icon === null || typeof icon.glyph !== "string" || icon.glyph.trim().length === 0) {
-      throw new Error(
-        `tool "${toolName}" presentation.icon must be { glyph: string }`
-      );
+      throw new Error(`${subject} presentation.icon must be { glyph: string }`);
     }
     presentation.icon = { glyph: icon.glyph };
   }
   if (declared.suppress !== void 0) {
     if (typeof declared.suppress !== "boolean") {
-      throw new Error(
-        `tool "${toolName}" presentation.suppress must be a boolean`
-      );
+      throw new Error(`${subject} presentation.suppress must be a boolean`);
     }
     presentation.suppress = declared.suppress;
   }
@@ -1785,7 +1782,7 @@ function parsePluginAgentToolPresentation(toolName, value) {
     const tint = declared.tint;
     if (typeof tint !== "object" || tint === null || typeof tint.light !== "string" || typeof tint.dark !== "string") {
       throw new Error(
-        `tool "${toolName}" presentation.tint must provide light and dark strings`
+        `${subject} presentation.tint must provide light and dark strings`
       );
     }
     presentation.tint = {
@@ -2011,6 +2008,12 @@ function validatePluginEnvironmentProviderDeclaration(declaration) {
     declaration.availability,
     "availability"
   );
+  assertOptionalFunction(
+    "environment provider",
+    id,
+    declaration.experimental_existingPath,
+    "experimental_existingPath"
+  );
   return {
     id,
     displayName,
@@ -2021,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 ?? {})
@@ -2358,6 +2362,7 @@ function normalizeCliRegistration(registration, alreadyRegistered) {
     name,
     summary: registration.summary,
     commands: validatedCommands,
+    rendersHelp: registration.rendersHelp === true,
     run: registration.run.bind(registration)
   };
 }
@@ -2386,8 +2391,8 @@ function normalizeAgentToolRegistration(args) {
       `tool "${name}" instructions exceed the ${PLUGIN_AGENT_STATIC_INSTRUCTIONS_MAX_CHARS}-character limit`
     );
   }
-  const presentation = parsePluginAgentToolPresentation(
-    name,
+  const presentation = parsePluginRowPresentation(
+    `tool "${name}"`,
     tool.presentation
   );
   if (presentation?.icon !== void 0) {
@@ -2515,12 +2520,20 @@ function normalizeInteractionRequest(request) {
   if (!Number.isInteger(timeoutMs) || timeoutMs <= 0 || timeoutMs > 60 * 60 * 1e3) {
     throw new Error("ui.requestInput timeoutMs must be between 1 and 3600000");
   }
+  if (request.describeSubmission !== void 0 && typeof request.describeSubmission !== "function") {
+    throw new Error("ui.requestInput describeSubmission must be a function");
+  }
   return {
     threadId: request.threadId,
     rendererId: request.rendererId,
     title: request.title.trim(),
     payload,
-    timeoutMs
+    timeoutMs,
+    presentation: parsePluginRowPresentation(
+      `ui.requestInput form "${request.rendererId}"`,
+      request.presentation
+    ),
+    describeSubmission: request.describeSubmission ?? null
   };
 }
 function validateProviderEnvContribution(label, providerId, resolve2, registered) {
@@ -3354,8 +3367,13 @@ function createFakePluginHostInternal(options, sharedState) {
     assertLive();
     const normalized = normalizeInteractionRequest(request);
     const normalizedRequest = {
-      ...request,
-      ...normalized
+      threadId: normalized.threadId,
+      rendererId: normalized.rendererId,
+      title: normalized.title,
+      payload: normalized.payload,
+      timeoutMs: normalized.timeoutMs,
+      ...normalized.presentation === null ? {} : { presentation: normalized.presentation },
+      ...normalized.describeSubmission === null ? {} : { describeSubmission: normalized.describeSubmission }
     };
     const id = `fake-interaction-${nextInteractionId++}`;
     return new Promise((resolve2) => {

package/package.json

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