@get-bb/plugin-sdk 0.4.56 → 0.4.84

package/dist/app.js

@@ -1,5 +1,7 @@
 // src/app.ts
 var runtime = globalThis.__bbPluginRuntime?.pluginSdkApp ?? {};
+var experimental_Icon = runtime.experimental_Icon;
+var experimental_ProviderIcon = runtime.experimental_ProviderIcon;
 var definePluginApp = runtime.definePluginApp;
 var ThreadChat = runtime.ThreadChat;
 var Markdown = runtime.Markdown;
@@ -37,8 +39,10 @@ export {
   experimental_BranchPicker,
   experimental_Diff,
   experimental_FileLink,
+  experimental_Icon,
   experimental_NewThreadComposer,
   experimental_PermissionModePicker,
+  experimental_ProviderIcon,
   experimental_ProviderModelPicker,
   experimental_SourceCode,
   experimental_useAppPanel,

package/dist/internal/host-policy.js

@@ -306,8 +306,7 @@ var pluginProviderEnvEntrySchema = z4.object({
     z4.string(),
     z4.object({ serverPath: z4.string().startsWith("/") }).strict()
   ]),
-  reason: z4.string(),
-  secret: z4.boolean()
+  reason: z4.string()
 }).strict();
 var pluginProviderEnvEntriesSchema = z4.array(pluginProviderEnvEntrySchema).max(PLUGIN_PROVIDER_ENV_MAX_ENTRIES).superRefine((entries, context) => {
   const names = /* @__PURE__ */ new Set();
@@ -1776,12 +1775,23 @@ function pluginHookAlreadyRegisteredMessage(hook) {
 }
 var ENVIRONMENT_PROVIDER_ID_PATTERN = /^[a-z0-9][a-z0-9-]{1,63}$/;
 var ENVIRONMENT_PROVIDER_DISPLAY_NAME_MAX_CHARS = 80;
+var ENVIRONMENT_PROVIDER_DESCRIPTION_MAX_CHARS = 200;
 var ENVIRONMENT_PROVIDER_REQUIREMENT_NAMES = [
   "projectCheckout",
   "gitCheckout",
   "gitRemote",
   "projectless"
 ];
+var environmentCompositionSchema = z4.object({
+  id: z4.string().regex(ENVIRONMENT_PROVIDER_ID_PATTERN),
+  displayName: z4.string().trim().min(1).max(ENVIRONMENT_PROVIDER_DISPLAY_NAME_MAX_CHARS),
+  description: z4.string().trim().min(1).max(ENVIRONMENT_PROVIDER_DESCRIPTION_MAX_CHARS).optional().transform((value) => value ?? null),
+  icon: z4.string().trim().min(1).transform(
+    (icon) => isPluginOwnedIconPath(icon) ? validateProviderRelativePath(icon, "Composition icon") : icon
+  ).optional().transform((value) => value ?? null),
+  machineProviderId: z4.string().regex(ENVIRONMENT_PROVIDER_ID_PATTERN),
+  environmentProviderId: z4.string().regex(ENVIRONMENT_PROVIDER_ID_PATTERN)
+}).strict();
 function validatePluginEnvironmentProviderDeclaration(declaration) {
   if (typeof declaration !== "object" || declaration === null) {
     throw new Error("environment provider declaration must be an object");
@@ -1798,17 +1808,14 @@ function validatePluginEnvironmentProviderDeclaration(declaration) {
       `environment provider "${id}" needs a displayName of 1-${ENVIRONMENT_PROVIDER_DISPLAY_NAME_MAX_CHARS} characters`
     );
   }
-  const icon = declaration.icon === void 0 ? null : z4.string().min(1).parse(declaration.icon).trim();
-  if (icon !== null) {
-    if (isPluginOwnedIconPath(icon))
-      validateProviderRelativePath(icon, `"${id}" icon`);
-    else if (!isNamespacedGlyph(icon) && /[/\\]/u.test(icon))
-      throw new Error(
-        `environment provider "${id}" icon must be a glyph, declared icon, or plugin-relative path`
-      );
-  }
-  if (icon !== null && icon.length === 0) {
-    throw new Error(`environment provider "${id}" declares an empty icon`);
+  const description = z4.string().trim().min(1).max(ENVIRONMENT_PROVIDER_DESCRIPTION_MAX_CHARS).optional().transform((value) => value ?? null).parse(declaration.description);
+  const icon = z4.string().trim().min(1).optional().transform((value) => value ?? null).parse(declaration.icon);
+  if (icon !== null && isPluginOwnedIconPath(icon)) {
+    validateProviderRelativePath(icon, `"${id}" icon`);
+  } else if (icon !== null && !isNamespacedGlyph(icon) && /[/\\]/u.test(icon)) {
+    throw new Error(
+      `environment provider "${id}" icon must be a glyph, declared icon, or plugin-relative path`
+    );
   }
   const requires = normalizeEnvironmentProviderRequirements(id, declaration);
   const inputs = normalizeEnvironmentProviderInputs(id, declaration);
@@ -1830,6 +1837,7 @@ function validatePluginEnvironmentProviderDeclaration(declaration) {
   return {
     id,
     displayName,
+    description,
     icon,
     requires,
     inputs: inputs === null ? null : inputs.schema,
@@ -1898,16 +1906,116 @@ var environmentProviderPolicySchema = z4.object({
   retireGraceMs: z4.number().int().nonnegative().nullable().default(3e5),
   pathKeys: z4.enum(["per-thread", "per-attempt"]).default("per-thread")
 }).strict();
-var MACHINE_PROVIDER_REQUIREMENT_NAMES = ["gitRemote"];
+var MACHINE_PROVIDER_DESCRIPTION_MAX_CHARS = 200;
+function validatePluginMachineProviderDeclaration(declaration) {
+  if (typeof declaration !== "object" || declaration === null) {
+    throw new Error("machine provider declaration must be an object");
+  }
+  const id = declaration.id;
+  if (typeof id !== "string" || !ENVIRONMENT_PROVIDER_ID_PATTERN.test(id)) {
+    throw new Error(
+      `invalid machine provider id ${JSON.stringify(id)} \u2014 use 2-64 lowercase letters, digits, or "-", starting with a letter or digit`
+    );
+  }
+  const displayName = typeof declaration.displayName === "string" ? declaration.displayName.trim() : "";
+  if (displayName.length === 0 || displayName.length > ENVIRONMENT_PROVIDER_DISPLAY_NAME_MAX_CHARS) {
+    throw new Error(
+      `machine provider "${id}" needs a displayName of 1-${ENVIRONMENT_PROVIDER_DISPLAY_NAME_MAX_CHARS} characters`
+    );
+  }
+  const description = z4.string().trim().min(1).max(MACHINE_PROVIDER_DESCRIPTION_MAX_CHARS).parse(declaration.description);
+  const icon = z4.string().trim().min(1).parse(declaration.icon);
+  if (isPluginOwnedIconPath(icon)) {
+    validateProviderRelativePath(icon, `"${id}" icon`);
+  } else if (!isNamespacedGlyph(icon) && /[/\\]/u.test(icon)) {
+    throw new Error(
+      `machine provider "${id}" icon must be a glyph, declared icon, or plugin-relative path`
+    );
+  }
+  const ephemeral = z4.boolean().default(false).parse(declaration.ephemeral);
+  const inputs = normalizeMachineProviderInputs(id, declaration);
+  if (typeof declaration.create !== "function" || typeof declaration.reconcileCleanup !== "function" || typeof declaration.remove !== "function") {
+    throw new Error(
+      `machine provider "${id}" must declare create, reconcileCleanup and remove functions`
+    );
+  }
+  const hasSuspend = typeof declaration.suspend === "function";
+  const hasResume = typeof declaration.resume === "function";
+  if (hasSuspend !== hasResume) {
+    throw new Error(
+      `machine provider "${id}" must declare suspend and resume together`
+    );
+  }
+  if (declaration.validate !== void 0 && typeof declaration.validate !== "function") {
+    throw new Error(
+      `machine provider "${id}" declares a validate that is not a function`
+    );
+  }
+  if (declaration.availability !== void 0 && typeof declaration.availability !== "function") {
+    throw new Error(
+      `machine provider "${id}" declares availability that is not a function`
+    );
+  }
+  return {
+    id,
+    displayName,
+    description,
+    icon,
+    ephemeral,
+    inputs: inputs === null ? null : inputs.schema,
+    inputsJsonSchema: inputs === null ? null : inputs.jsonSchema,
+    availability: declaration.availability ?? null,
+    validate: declaration.validate ?? null,
+    reconcileCleanup: declaration.reconcileCleanup,
+    create: declaration.create,
+    suspend: declaration.suspend ?? null,
+    resume: declaration.resume ?? null,
+    remove: declaration.remove
+  };
+}
+function normalizeMachineProviderInputs(id, declaration) {
+  const inputs = declaration.inputs;
+  if (inputs === void 0) return null;
+  if (!isStandardSchema(inputs)) {
+    throw new Error(
+      `machine provider "${id}" declares an inputs that is not a Standard Schema v1 validator`
+    );
+  }
+  let converted;
+  try {
+    converted = JSON.parse(JSON.stringify(standardSchemaToJsonSchema(inputs)));
+  } catch (error) {
+    throw new Error(
+      `machine provider "${id}" declares an inputs validator that cannot be published as JSON Schema (${error instanceof Error ? error.message : String(error)}) \u2014 declare it with zod 4 or a validator exposing toJSONSchema()`
+    );
+  }
+  const jsonSchema = jsonValueSchema.safeParse(converted);
+  if (!jsonSchema.success) {
+    throw new Error(
+      `machine provider "${id}" declares an inputs schema whose JSON Schema is not JSON-serializable`
+    );
+  }
+  return { schema: inputs, jsonSchema: jsonSchema.data };
+}
+function validateServerAccessProviderDeclaration(declaration) {
+  if (typeof declaration !== "object" || declaration === null)
+    throw new Error("Invalid server access provider declaration");
+  if (typeof declaration.id !== "string" || !/^[a-z][a-z0-9-]*$/u.test(declaration.id) || declaration.id === "direct")
+    throw new Error("Invalid or reserved server access provider id");
+  if (typeof declaration.displayName !== "string" || !declaration.displayName.trim() || typeof declaration.description !== "string" || !declaration.description.trim() || typeof declaration.availability !== "function" || typeof declaration.acquire !== "function" || typeof declaration.release !== "function")
+    throw new Error("Invalid server access provider declaration");
+  return declaration;
+}
 export {
   AGENT_TOOL_NAME_PATTERN,
   BACKGROUND_NAME_PATTERN,
   CLI_COMMAND_NAME_PATTERN,
+  ENVIRONMENT_PROVIDER_DESCRIPTION_MAX_CHARS,
   ENVIRONMENT_PROVIDER_DISPLAY_NAME_MAX_CHARS,
   ENVIRONMENT_PROVIDER_ID_PATTERN,
   ENVIRONMENT_PROVIDER_REQUIREMENT_NAMES,
   KV_VALUE_MAX_BYTES,
-  MACHINE_PROVIDER_REQUIREMENT_NAMES,
+  MACHINE_PROVIDER_DESCRIPTION_MAX_CHARS,
   MENTION_PROVIDER_ID_PATTERN,
   PLUGIN_AGENT_DYNAMIC_INSTRUCTIONS_MAX_CHARS,
   PLUGIN_AGENT_SELECTION_MAX_IDS,
@@ -1936,6 +2044,7 @@ export {
   assertNoRecursiveJsonSchemaReferences,
   deriveValidatedProviderOptions,
   enforcePluginCliOutputLimit,
+  environmentCompositionSchema,
   isPluginMentionTrigger,
   isStandardSchema,
   isZodSchemaLike,
@@ -1955,8 +2064,10 @@ export {
   undeclaredIconProblem,
   validatePluginAiServiceDeclaration,
   validatePluginEnvironmentProviderDeclaration,
+  validatePluginMachineProviderDeclaration,
   validatePluginProviderDeclaration,
   validatePluginProviderEnvEntries,
+  validateServerAccessProviderDeclaration,
   validateSettingsUpdate,
   zodSchemaToJsonSchema
 };

package/dist/internal/plugin-app-collector.js

@@ -398,8 +398,10 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
     messageActions: [],
     commandPaletteActions: [],
     providerIcons: [],
+    icons: [],
     timelineRenderers: [],
     environmentProviderInputs: [],
+    machineProviderInputs: [],
     contentScripts: []
   };
   sidebarFooterItemsByRegistrationSet.set(collected, sidebarFooterItems);
@@ -425,6 +427,7 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
     providerIcon: /* @__PURE__ */ new Set(),
     timelineRenderer: /* @__PURE__ */ new Set(),
     environmentProviderInputs: /* @__PURE__ */ new Set(),
+    machineProviderInputs: /* @__PURE__ */ new Set(),
     contentScript: /* @__PURE__ */ new Set()
   };
   definition.setup({
@@ -761,8 +764,18 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
       experimental_providerIcon(registration) {
         const kind = "slots.experimental_providerIcon";
         const providerId = requireProviderId(kind, registration?.providerId);
-        requireUniqueId(kind, seenIds.providerIcon, providerId);
+        const declaredKind = registration.providerKind;
+        if (declaredKind !== void 0 && declaredKind !== "agent" && declaredKind !== "machine" && declaredKind !== "environment") {
+          throw new Error(`${kind}: invalid providerKind`);
+        }
+        const providerKind = declaredKind ?? "all";
+        requireUniqueId(
+          kind,
+          seenIds.providerIcon,
+          `${providerKind}:${providerId}`
+        );
         collected.providerIcons.push({
+          providerKind,
           providerId,
           icon: requireComponent(kind, registration.icon)
         });
@@ -791,6 +804,18 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
           environmentProviderId,
           component: requireComponent(kind, registration.component)
         });
+      },
+      experimental_machineProviderInputs(registration) {
+        const kind = "slots.experimental_machineProviderInputs";
+        const machineProviderId = requireProviderId(
+          kind,
+          registration?.machineProviderId
+        );
+        requireUniqueId(kind, seenIds.machineProviderInputs, machineProviderId);
+        collected.machineProviderInputs.push({
+          machineProviderId,
+          component: requireComponent(kind, registration.component)
+        });
       }
     },
     experimental_sidebarFooter: new SidebarFooterCollector(
@@ -810,6 +835,25 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
         }
       }
     },
+    experimental_icons: {
+      register(registration) {
+        const kind = "experimental_icons.register";
+        const name = requireNonEmptyString(
+          kind,
+          "name",
+          registration?.name
+        ).trim();
+        if (name.length === 0)
+          throw new Error(`${kind}: "name" must not be blank`);
+        if (collected.icons.some((icon) => icon.name === name)) {
+          throw new Error(`${kind}: duplicate icon name "${name}"`);
+        }
+        collected.icons.push({
+          name,
+          component: requireComponent(kind, registration.component)
+        });
+      }
+    },
     contentScripts: {
       register(registration) {
         const kind = "contentScripts.register";

package/dist/provider-bridge-acp.js

@@ -2089,7 +2089,8 @@ var unscopedProviderEventSchema = z14.discriminatedUnion("type", [
         name: z14.string(),
         source: z14.union([
           z14.literal("shell"),
-          z14.object({ plugin: z14.string() }).strict()
+          z14.object({ plugin: z14.string() }).strict(),
+          z14.object({ core: z14.enum(["machine-git", "machine-environment"]) }).strict()
         ]),
         value: z14.union([
           z14.string(),

package/dist/provider-bridge-testing.js

@@ -1728,7 +1728,8 @@ var unscopedProviderEventSchema = z12.discriminatedUnion("type", [
         name: z12.string(),
         source: z12.union([
           z12.literal("shell"),
-          z12.object({ plugin: z12.string() }).strict()
+          z12.object({ plugin: z12.string() }).strict(),
+          z12.object({ core: z12.enum(["machine-git", "machine-environment"]) }).strict()
         ]),
         value: z12.union([
           z12.string(),

package/dist/provider-bridge.js

@@ -3394,7 +3394,8 @@ var unscopedProviderEventSchema = z18.discriminatedUnion("type", [
         name: z18.string(),
         source: z18.union([
           z18.literal("shell"),
-          z18.object({ plugin: z18.string() }).strict()
+          z18.object({ plugin: z18.string() }).strict(),
+          z18.object({ core: z18.enum(["machine-git", "machine-environment"]) }).strict()
         ]),
         value: z18.union([
           z18.string(),

package/dist/testing/app.js

@@ -574,8 +574,10 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
     messageActions: [],
     commandPaletteActions: [],
     providerIcons: [],
+    icons: [],
     timelineRenderers: [],
     environmentProviderInputs: [],
+    machineProviderInputs: [],
     contentScripts: []
   };
   sidebarFooterItemsByRegistrationSet.set(collected, sidebarFooterItems);
@@ -601,6 +603,7 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
     providerIcon: /* @__PURE__ */ new Set(),
     timelineRenderer: /* @__PURE__ */ new Set(),
     environmentProviderInputs: /* @__PURE__ */ new Set(),
+    machineProviderInputs: /* @__PURE__ */ new Set(),
     contentScript: /* @__PURE__ */ new Set()
   };
   definition.setup({
@@ -937,8 +940,18 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
       experimental_providerIcon(registration) {
         const kind = "slots.experimental_providerIcon";
         const providerId = requireProviderId(kind, registration?.providerId);
-        requireUniqueId(kind, seenIds.providerIcon, providerId);
+        const declaredKind = registration.providerKind;
+        if (declaredKind !== void 0 && declaredKind !== "agent" && declaredKind !== "machine" && declaredKind !== "environment") {
+          throw new Error(`${kind}: invalid providerKind`);
+        }
+        const providerKind = declaredKind ?? "all";
+        requireUniqueId(
+          kind,
+          seenIds.providerIcon,
+          `${providerKind}:${providerId}`
+        );
         collected.providerIcons.push({
+          providerKind,
           providerId,
           icon: requireComponent(kind, registration.icon)
         });
@@ -967,6 +980,18 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
           environmentProviderId,
           component: requireComponent(kind, registration.component)
         });
+      },
+      experimental_machineProviderInputs(registration) {
+        const kind = "slots.experimental_machineProviderInputs";
+        const machineProviderId = requireProviderId(
+          kind,
+          registration?.machineProviderId
+        );
+        requireUniqueId(kind, seenIds.machineProviderInputs, machineProviderId);
+        collected.machineProviderInputs.push({
+          machineProviderId,
+          component: requireComponent(kind, registration.component)
+        });
       }
     },
     experimental_sidebarFooter: new SidebarFooterCollector(
@@ -986,6 +1011,25 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
         }
       }
     },
+    experimental_icons: {
+      register(registration) {
+        const kind = "experimental_icons.register";
+        const name = requireNonEmptyString(
+          kind,
+          "name",
+          registration?.name
+        ).trim();
+        if (name.length === 0)
+          throw new Error(`${kind}: "name" must not be blank`);
+        if (collected.icons.some((icon) => icon.name === name)) {
+          throw new Error(`${kind}: duplicate icon name "${name}"`);
+        }
+        collected.icons.push({
+          name,
+          component: requireComponent(kind, registration.component)
+        });
+      }
+    },
     contentScripts: {
       register(registration) {
         const kind = "contentScripts.register";
@@ -1499,6 +1543,24 @@ var testPluginSdkApp = {
   ThreadChat: TestThreadChat,
   Markdown: TestMarkdown,
   experimental_FileLink: TestFileLink,
+  experimental_Icon: ({ name, fallback, ...props }) => /* @__PURE__ */ jsx("span", { ...props, "data-icon": name, "data-icon-fallback": fallback }),
+  experimental_ProviderIcon: ({
+    providerKind,
+    provider,
+    fallback,
+    ...props
+  }) => /* @__PURE__ */ jsx(
+    "span",
+    {
+      ...props,
+      "data-provider-kind": providerKind,
+      "data-provider-id": provider.id,
+      "data-provider-logo": provider.logoUrl ?? void 0,
+      "data-provider-glyph": (typeof provider.icon === "string" ? provider.icon : provider.icon?.glyph) ?? void 0,
+      "data-provider-tint": provider.strings?.iconTint == null ? void 0 : JSON.stringify(provider.strings.iconTint),
+      "data-provider-fallback": fallback
+    }
+  ),
   UrlLink: TestUrlLink,
   experimental_NewThreadComposer: TestNewThreadComposer,
   experimental_ProviderModelPicker: TestProviderModelPicker,