@get-bb/plugin-sdk 0.4.30 → 0.4.35

package/dist/internal/host-policy.js

@@ -293,12 +293,19 @@ var settingsBaseFields = {
   label: z3.string().min(1),
   description: z3.string().min(1).optional()
 };
+var stringSettingSchemaSchema = z3.custom(
+  (value) => isStandardSchema(value)
+);
+var booleanSettingSchemaSchema = z3.custom(
+  (value) => isStandardSchema(value)
+);
 var settingDescriptorSchema = z3.discriminatedUnion("type", [
   z3.object({
     type: z3.literal("string"),
     ...settingsBaseFields,
     secret: z3.literal(true).optional(),
     experimental_multiline: z3.boolean().optional(),
+    experimental_schema: stringSettingSchemaSchema.optional(),
     default: z3.string().optional()
   }).strict().refine(
     (descriptor) => !(descriptor.secret === true && descriptor.experimental_multiline === true),
@@ -310,17 +317,20 @@ var settingDescriptorSchema = z3.discriminatedUnion("type", [
   z3.object({
     type: z3.literal("boolean"),
     ...settingsBaseFields,
+    experimental_schema: booleanSettingSchemaSchema.optional(),
     default: z3.boolean().optional()
   }).strict(),
   z3.object({
     type: z3.literal("select"),
     ...settingsBaseFields,
     options: z3.array(z3.string().min(1)).min(1),
+    experimental_schema: stringSettingSchemaSchema.optional(),
     default: z3.string().optional()
   }).strict(),
   z3.object({
     type: z3.literal("project"),
     ...settingsBaseFields,
+    experimental_schema: stringSettingSchemaSchema.optional(),
     default: z3.string().optional()
   }).strict()
 ]);
@@ -349,11 +359,39 @@ function registerSettingDescriptors(target, added) {
         `default for setting "${key}" must be one of its options`
       );
     }
+    if (descriptor.default !== void 0) {
+      const errors = validateSettingsUpdate(
+        { [key]: descriptor },
+        { [key]: descriptor.default }
+      );
+      if (errors.length > 0) {
+        throw new Error(`invalid default for setting "${key}": ${errors[0]}`);
+      }
+    }
     validated[key] = descriptor;
   }
   Object.assign(target, validated);
   return validated;
 }
+function settingSchemaError(key, schema, value) {
+  if (schema === void 0) return null;
+  try {
+    const result = schema["~standard"].validate(value);
+    if (result instanceof Promise) {
+      return `schema for setting "${key}" must validate synchronously`;
+    }
+    if (result.issues !== void 0) {
+      return result.issues[0]?.message ?? `schema for setting "${key}" rejected the value`;
+    }
+    if (result.value !== value) {
+      return `schema for setting "${key}" must not transform its value`;
+    }
+    return null;
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    return `schema for setting "${key}" failed: ${detail}`;
+  }
+}
 function validateSettingsUpdate(descriptors, values) {
   const errors = [];
   for (const [key, value] of Object.entries(values)) {
@@ -366,6 +404,15 @@ function validateSettingsUpdate(descriptors, values) {
     if (descriptor.type === "boolean") {
       if (typeof value !== "boolean") {
         errors.push(`setting "${key}" expects a boolean`);
+        continue;
+      }
+      const validationError2 = settingSchemaError(
+        key,
+        descriptor.experimental_schema,
+        value
+      );
+      if (validationError2 !== null) {
+        errors.push(validationError2);
       }
       continue;
     }
@@ -377,6 +424,15 @@ function validateSettingsUpdate(descriptors, values) {
       errors.push(
         `setting "${key}" must be one of: ${descriptor.options.join(", ")}`
       );
+      continue;
+    }
+    const validationError = settingSchemaError(
+      key,
+      descriptor.experimental_schema,
+      value
+    );
+    if (validationError !== null) {
+      errors.push(validationError);
     }
   }
   return errors;
@@ -1290,6 +1346,12 @@ function readRpcMethodContract(method, value) {
 function isZodSchemaLike(value) {
   return typeof value === "object" && value !== null && typeof value.safeParse === "function";
 }
+function zodSchemaToJsonSchema(schema) {
+  if (typeof schema.toJSONSchema === "function") {
+    return schema.toJSONSchema({ io: "input" });
+  }
+  return z3.toJSONSchema(schema, { io: "input" });
+}
 var SINGLE_SCHEMA_KEYWORDS = [
   "additionalItems",
   "additionalProperties",
@@ -1608,6 +1670,12 @@ function agentToolIconRefusalMessage(toolName, problem) {
 function providerWithoutBridgeMessage(providerId) {
   return `provider "${providerId}" has no bridge to run on: this plugin declares no "bb.host" entry in its manifest`;
 }
+function storePluginHook(records, hook, handler) {
+  records[hook] = handler;
+}
+function pluginHookAlreadyRegisteredMessage(hook) {
+  return `a "${hook}" hook handler is already registered by this plugin`;
+}
 export {
   AGENT_TOOL_NAME_PATTERN,
   BACKGROUND_NAME_PATTERN,
@@ -1645,15 +1713,18 @@ export {
   normalizeMentionProviderTriggers,
   parsePluginAgentToolPresentation,
   pluginCliCollisionWarning,
+  pluginHookAlreadyRegisteredMessage,
   providerAlreadyRegisteredMessage,
   providerIconRefusalMessage,
   providerWithoutBridgeMessage,
   readRpcMethodContract,
   registerSettingDescriptors,
   rejectStaleAgentToolFields,
+  storePluginHook,
   summarizeParseIssues,
   undeclaredIconProblem,
   validatePluginAiServiceDeclaration,
   validatePluginProviderDeclaration,
-  validateSettingsUpdate
+  validateSettingsUpdate,
+  zodSchemaToJsonSchema
 };

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

@@ -252,6 +252,7 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
     composerCustomizations: [],
     pendingInteractions: [],
     sidebarFooterActions: [],
+    experimentalSidebarNavigations: [],
     threadLists: [],
     threadHeaderActions: [],
     fileOpeners: [],
@@ -273,6 +274,7 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
     composerCustomization: /* @__PURE__ */ new Set(),
     pendingInteraction: /* @__PURE__ */ new Set(),
     sidebarFooterAction: /* @__PURE__ */ new Set(),
+    sidebarNavigation: /* @__PURE__ */ new Set(),
     threadList: /* @__PURE__ */ new Set(),
     threadHeaderAction: /* @__PURE__ */ new Set(),
     fileOpener: /* @__PURE__ */ new Set(),
@@ -464,6 +466,22 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
           run: registration.run
         });
       },
+      experimental_sidebarNavigation(registration) {
+        const kind = "slots.experimental_sidebarNavigation";
+        const id = requireSlotId(kind, registration?.id);
+        requireUniqueId(kind, seenIds.sidebarNavigation, id);
+        const description = requireOptionalString(
+          kind,
+          "description",
+          registration.description
+        );
+        collected.experimentalSidebarNavigations.push({
+          id,
+          title: requireNonEmptyString(kind, "title", registration.title),
+          ...description !== void 0 ? { description } : {},
+          component: requireComponent(kind, registration.component)
+        });
+      },
       experimental_threadList(registration) {
         const kind = "slots.experimental_threadList";
         const id = requireSlotId(kind, registration?.id);