@get-bb/plugin-sdk 0.4.34 → 0.4.35

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

@@ -35,7 +35,7 @@ interface PluginRpcError {
     issues?: PluginRpcValidationIssue[];
 }
 /**
- * The validator-neutral subset of Standard Schema v1 used by plugin RPC.
+ * The validator-neutral subset of Standard Schema v1 used by plugin contracts.
  * Zod 4 schemas implement this interface directly; other validators can do
  * the same without becoming part of BB's public protocol.
  */

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

@@ -8,7 +8,7 @@
 import { z } from 'zod';
 
 /**
- * The validator-neutral subset of Standard Schema v1 used by plugin RPC.
+ * The validator-neutral subset of Standard Schema v1 used by plugin contracts.
  * Zod 4 schemas implement this interface directly; other validators can do
  * the same without becoming part of BB's public protocol.
  */

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

@@ -459,7 +459,7 @@ type JsonValue = string | number | boolean | null | JsonValue[] | {
 };
 
 /**
- * The validator-neutral subset of Standard Schema v1 used by plugin RPC.
+ * The validator-neutral subset of Standard Schema v1 used by plugin contracts.
  * Zod 4 schemas implement this interface directly; other validators can do
  * the same without becoming part of BB's public protocol.
  */
@@ -491,11 +491,6 @@ interface PluginRpcMethodContract<InputSchema extends StandardSchemaV1 = Standar
     readonly output: OutputSchema;
 }
 
-/**
- * Declarative settings descriptors (`bb.settings.define`). Deliberately plain
- * data — not zod — so the host can render settings forms and the CLI can
- * parse values without executing plugin code.
- */
 type PluginSettingDescriptor = {
     type: "string";
     label: string;
@@ -507,22 +502,30 @@ type PluginSettingDescriptor = {
      * be multi-line.
      */
     experimental_multiline?: boolean;
+    /** Synchronously validate without transforming a proposed value. */
+    experimental_schema?: StandardSchemaV1<string, string>;
     default?: string;
 } | {
     type: "boolean";
     label: string;
     description?: string;
+    /** Synchronously validate without transforming a proposed value. */
+    experimental_schema?: StandardSchemaV1<boolean, boolean>;
     default?: boolean;
 } | {
     type: "select";
     label: string;
     description?: string;
     options: string[];
+    /** Synchronously validate without transforming a proposed value. */
+    experimental_schema?: StandardSchemaV1<string, string>;
     default?: string;
 } | {
     type: "project";
     label: string;
     description?: string;
+    /** Synchronously validate without transforming a proposed value. */
+    experimental_schema?: StandardSchemaV1<string, string>;
     default?: string;
 };
 type PluginSettingDescriptors = Record<string, PluginSettingDescriptor>;
@@ -1227,7 +1230,12 @@ declare function isStandardSchema(value: unknown): value is StandardSchemaV1;
 declare function readRpcMethodContract(method: string, value: unknown): PluginRpcMethodContract;
 /** Duck-typed zod detection: plugin sources may carry their own zod copy,
  * so instanceof is useless — anything with safeParse is treated as zod. */
-declare function isZodSchemaLike(value: unknown): boolean;
+type ZodSchemaLike = {
+    safeParse: z.ZodType["safeParse"];
+    toJSONSchema?: z.ZodType["toJSONSchema"];
+};
+declare function isZodSchemaLike(value: unknown): value is ZodSchemaLike;
+declare function zodSchemaToJsonSchema(schema: ZodSchemaLike): unknown;
 /**
  * Reject recursive local references before a tool schema reaches a provider.
  * Some providers reject the complete tool list when any one schema contains a
@@ -1312,5 +1320,5 @@ declare function storePluginHook<K extends PluginHookName>(records: {
 /** The refusal a second handler for one hook from one plugin gets. */
 declare function pluginHookAlreadyRegisteredMessage(hook: PluginHookName): string;
 
-export { AGENT_TOOL_NAME_PATTERN, BACKGROUND_NAME_PATTERN, CLI_COMMAND_NAME_PATTERN, KV_VALUE_MAX_BYTES, MENTION_PROVIDER_ID_PATTERN, PLUGIN_AGENT_DYNAMIC_INSTRUCTIONS_MAX_CHARS, PLUGIN_AGENT_SELECTION_MAX_IDS, PLUGIN_AGENT_STATIC_INSTRUCTIONS_MAX_CHARS, PLUGIN_AGENT_STATUS_LABEL_MAX_CHARS, PLUGIN_AGENT_TOOL_PARAMETERS_MAX_BYTES, PLUGIN_HTTP_METHODS, PLUGIN_MENTION_TRIGGER_VALUES, PLUGIN_PROVIDER_BRIDGE_OPTIONS_MAX_BYTES, PLUGIN_PROVIDER_COMPOSER_ACTION_VALUES, PLUGIN_PROVIDER_DISPLAY_NAME_MAX_CHARS, PLUGIN_PROVIDER_PERMISSION_MODE_VALUES, PLUGIN_PROVIDER_REASONING_LEVEL_VALUES, PROVIDER_ID_PATTERN, RESERVED_AGENT_TOOL_NAMES, RESERVED_BB_CLI_COMMANDS, RPC_METHOD_PATTERN, SERVER_DIRECT_AI_SERVICE_IDS, SETTING_KEY_PATTERN, adoptHttpRouteResponse, agentToolIconRefusalMessage, aiServiceAlreadyRegisteredMessage, assertAiServiceRegistrable, assertNoRecursiveJsonSchemaReferences, deriveValidatedProviderOptions, enforcePluginCliOutputLimit, isPluginMentionTrigger, isStandardSchema, isZodSchemaLike, normalizeMentionProviderTriggers, parsePluginAgentToolPresentation, pluginCliCollisionWarning, pluginHookAlreadyRegisteredMessage, providerAlreadyRegisteredMessage, providerIconRefusalMessage, providerWithoutBridgeMessage, readRpcMethodContract, registerSettingDescriptors, rejectStaleAgentToolFields, storePluginHook, summarizeParseIssues, undeclaredIconProblem, validatePluginAiServiceDeclaration, validatePluginProviderDeclaration, validateSettingsUpdate };
+export { AGENT_TOOL_NAME_PATTERN, BACKGROUND_NAME_PATTERN, CLI_COMMAND_NAME_PATTERN, KV_VALUE_MAX_BYTES, MENTION_PROVIDER_ID_PATTERN, PLUGIN_AGENT_DYNAMIC_INSTRUCTIONS_MAX_CHARS, PLUGIN_AGENT_SELECTION_MAX_IDS, PLUGIN_AGENT_STATIC_INSTRUCTIONS_MAX_CHARS, PLUGIN_AGENT_STATUS_LABEL_MAX_CHARS, PLUGIN_AGENT_TOOL_PARAMETERS_MAX_BYTES, PLUGIN_HTTP_METHODS, PLUGIN_MENTION_TRIGGER_VALUES, PLUGIN_PROVIDER_BRIDGE_OPTIONS_MAX_BYTES, PLUGIN_PROVIDER_COMPOSER_ACTION_VALUES, PLUGIN_PROVIDER_DISPLAY_NAME_MAX_CHARS, PLUGIN_PROVIDER_PERMISSION_MODE_VALUES, PLUGIN_PROVIDER_REASONING_LEVEL_VALUES, PROVIDER_ID_PATTERN, RESERVED_AGENT_TOOL_NAMES, RESERVED_BB_CLI_COMMANDS, RPC_METHOD_PATTERN, SERVER_DIRECT_AI_SERVICE_IDS, SETTING_KEY_PATTERN, adoptHttpRouteResponse, agentToolIconRefusalMessage, aiServiceAlreadyRegisteredMessage, assertAiServiceRegistrable, assertNoRecursiveJsonSchemaReferences, deriveValidatedProviderOptions, enforcePluginCliOutputLimit, isPluginMentionTrigger, isStandardSchema, isZodSchemaLike, normalizeMentionProviderTriggers, parsePluginAgentToolPresentation, pluginCliCollisionWarning, pluginHookAlreadyRegisteredMessage, providerAlreadyRegisteredMessage, providerIconRefusalMessage, providerWithoutBridgeMessage, readRpcMethodContract, registerSettingDescriptors, rejectStaleAgentToolFields, storePluginHook, summarizeParseIssues, undeclaredIconProblem, validatePluginAiServiceDeclaration, validatePluginProviderDeclaration, validateSettingsUpdate, zodSchemaToJsonSchema };
 export type { AiServiceHostBinding, NormalizedPluginProviderDeclaration };

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

@@ -74,7 +74,7 @@ type JsonValue = string | number | boolean | null | JsonValue[] | {
 };
 
 /**
- * The validator-neutral subset of Standard Schema v1 used by plugin RPC.
+ * The validator-neutral subset of Standard Schema v1 used by plugin contracts.
  * Zod 4 schemas implement this interface directly; other validators can do
  * the same without becoming part of BB's public protocol.
  */

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

@@ -44,6 +44,7 @@ interface ProviderNativeRootsInputLike {
 
 declare const appSettingsSchema: z$1.ZodObject<{
     defaultProviderId: z$1.ZodNullable<z$1.ZodString>;
+    managedBranchPrefix: z$1.ZodString;
     providerOrder: z$1.ZodArray<z$1.ZodString>;
     showKeyboardHints: z$1.ZodBoolean;
     showUnhandledProviderEvents: z$1.ZodBoolean;
@@ -68,6 +69,7 @@ declare const appKeybindingOverridesSchema: z$1.ZodArray<z$1.ZodObject<{
         "modelPicker.cycleReasoning": "modelPicker.cycleReasoning";
         "modelPicker.cycleReasoningBackward": "modelPicker.cycleReasoningBackward";
         "modelPicker.toggle": "modelPicker.toggle";
+        "notifications.open": "notifications.open";
         "palette.open": "palette.open";
         "pane.close": "pane.close";
         "pane.focus.1": "pane.focus.1";
@@ -8324,6 +8326,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "modelPicker.cycleReasoning": "modelPicker.cycleReasoning";
             "modelPicker.cycleReasoningBackward": "modelPicker.cycleReasoningBackward";
             "modelPicker.toggle": "modelPicker.toggle";
+            "notifications.open": "notifications.open";
             "palette.open": "palette.open";
             "pane.close": "pane.close";
             "pane.focus.1": "pane.focus.1";
@@ -8422,6 +8425,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
     }, z$1.core.$strip>;
     generalSettings: z$1.ZodObject<{
         defaultProviderId: z$1.ZodNullable<z$1.ZodString>;
+        managedBranchPrefix: z$1.ZodString;
         providerOrder: z$1.ZodArray<z$1.ZodString>;
         showKeyboardHints: z$1.ZodBoolean;
         showUnhandledProviderEvents: z$1.ZodBoolean;
@@ -8445,6 +8449,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "modelPicker.cycleReasoning": "modelPicker.cycleReasoning";
             "modelPicker.cycleReasoningBackward": "modelPicker.cycleReasoningBackward";
             "modelPicker.toggle": "modelPicker.toggle";
+            "notifications.open": "notifications.open";
             "palette.open": "palette.open";
             "pane.close": "pane.close";
             "pane.focus.1": "pane.focus.1";
@@ -8518,6 +8523,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "modelPicker.cycleReasoning": "modelPicker.cycleReasoning";
             "modelPicker.cycleReasoningBackward": "modelPicker.cycleReasoningBackward";
             "modelPicker.toggle": "modelPicker.toggle";
+            "notifications.open": "notifications.open";
             "palette.open": "palette.open";
             "pane.close": "pane.close";
             "pane.focus.1": "pane.focus.1";
@@ -12418,7 +12424,7 @@ interface PluginRpcError {
     issues?: PluginRpcValidationIssue[];
 }
 /**
- * The validator-neutral subset of Standard Schema v1 used by plugin RPC.
+ * The validator-neutral subset of Standard Schema v1 used by plugin contracts.
  * Zod 4 schemas implement this interface directly; other validators can do
  * the same without becoming part of BB's public protocol.
  */
@@ -15977,11 +15983,6 @@ interface PluginLogger {
     warn(message: string): void;
     error(message: string): void;
 }
-/**
- * Declarative settings descriptors (`bb.settings.define`). Deliberately plain
- * data — not zod — so the host can render settings forms and the CLI can
- * parse values without executing plugin code.
- */
 type PluginSettingDescriptor = {
     type: "string";
     label: string;
@@ -15993,22 +15994,30 @@ type PluginSettingDescriptor = {
      * be multi-line.
      */
     experimental_multiline?: boolean;
+    /** Synchronously validate without transforming a proposed value. */
+    experimental_schema?: StandardSchemaV1<string, string>;
     default?: string;
 } | {
     type: "boolean";
     label: string;
     description?: string;
+    /** Synchronously validate without transforming a proposed value. */
+    experimental_schema?: StandardSchemaV1<boolean, boolean>;
     default?: boolean;
 } | {
     type: "select";
     label: string;
     description?: string;
     options: string[];
+    /** Synchronously validate without transforming a proposed value. */
+    experimental_schema?: StandardSchemaV1<string, string>;
     default?: string;
 } | {
     type: "project";
     label: string;
     description?: string;
+    /** Synchronously validate without transforming a proposed value. */
+    experimental_schema?: StandardSchemaV1<string, string>;
     default?: string;
 };
 type PluginSettingDescriptors = Record<string, PluginSettingDescriptor>;
@@ -16025,7 +16034,11 @@ type PluginSettingValueOf<D extends PluginSettingDescriptor> = D extends {
 interface PluginSettingsHandle<Ds extends Record<string, PluginSettingDescriptor>> {
     /** Load-safe: callable inside the factory. */
     get(): Promise<PluginSettingsValues<Ds>>;
-    /** Fires after values change through the settings route/CLI. */
+    /** Validate and persist this handle's fields; `null` unsets a stored value. */
+    experimental_set(values: Partial<{
+        [K in keyof Ds]: PluginSettingValueOf<Ds[K]> | null;
+    }>): Promise<PluginSettingsValues<Ds>>;
+    /** Fires after effective values change through any settings write. */
     onChange(listener: (next: PluginSettingsValues<Ds>, prev: PluginSettingsValues<Ds>) => void): void;
 }
 interface PluginSettings {

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",
@@ -1663,5 +1725,6 @@ export {
   undeclaredIconProblem,
   validatePluginAiServiceDeclaration,
   validatePluginProviderDeclaration,
-  validateSettingsUpdate
+  validateSettingsUpdate,
+  zodSchemaToJsonSchema
 };

package/dist/testing/index.js

@@ -6,7 +6,6 @@ import { join } from "node:path";
 import Database from "better-sqlite3";
 import { CronExpressionParser } from "cron-parser";
 import { Hono } from "hono";
-import { z as z4 } from "zod";
 
 // ../domain/src/plugin-interaction-limits.ts
 var PLUGIN_INTERACTION_MAX_TITLE_LENGTH = 160;
@@ -307,12 +306,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),
@@ -324,17 +330,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()
 ]);
@@ -363,11 +372,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)) {
@@ -380,6 +417,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;
     }
@@ -391,6 +437,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;
@@ -1294,6 +1349,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",
@@ -2082,7 +2143,9 @@ function createFakePluginHostInternal(options, sharedState) {
           "ALTER TABLE _bb_migrations ADD COLUMN statement_hash TEXT"
         );
       }
-      const rows = database.prepare("SELECT id, statement_hash FROM _bb_migrations ORDER BY id").all();
+      const rows = database.prepare(
+        "SELECT id, statement_hash FROM _bb_migrations ORDER BY id"
+      ).all();
       const applied = /* @__PURE__ */ new Map();
       for (const row of rows) applied.set(row.id, row.statement_hash);
       const statementHashes = statements.map(migrationStatementHash);
@@ -2119,20 +2182,57 @@ function createFakePluginHostInternal(options, sharedState) {
   const settingsDescriptors = {};
   const settingsListeners = [];
   const storedSettings = persistentState.storedSettings;
+  async function setSettingsValues(values) {
+    const errors = validateSettingsUpdate(settingsDescriptors, values);
+    if (errors.length > 0) {
+      throw new Error(errors.join("; "));
+    }
+    const prev = readSettingsValues(settingsDescriptors, storedSettings);
+    for (const [key, value] of Object.entries(values)) {
+      if (value === null) storedSettings.delete(key);
+      else if (typeof value === "string" || typeof value === "boolean") {
+        storedSettings.set(key, value);
+      } else {
+        throw new Error(`setting "${key}" has an unsupported value`);
+      }
+    }
+    const next = readSettingsValues(settingsDescriptors, storedSettings);
+    if (JSON.stringify(next) === JSON.stringify(prev)) return;
+    for (const listener of settingsListeners) {
+      try {
+        listener(next, prev);
+      } catch (error) {
+        emitLog(
+          "warn",
+          `settings onChange listener failed: ${errorMessage(error)}`
+        );
+      }
+    }
+  }
   const settings = {
     define(descriptors) {
       assertLive();
-      registerSettingDescriptors(
+      const validated = registerSettingDescriptors(
         settingsDescriptors,
         descriptors
       );
       return {
         async get() {
           assertLive();
-          return readSettingsValues(
-            settingsDescriptors,
-            storedSettings
-          );
+          return readSettingsValues(validated, storedSettings);
+        },
+        async experimental_set(values) {
+          assertLive();
+          const rawValues = {};
+          for (const [key, value] of Object.entries(values)) {
+            rawValues[key] = value;
+          }
+          const errors = validateSettingsUpdate(validated, rawValues);
+          if (errors.length > 0) {
+            throw new Error(errors.join("; "));
+          }
+          await setSettingsValues(rawValues);
+          return readSettingsValues(validated, storedSettings);
         },
         onChange(listener) {
           assertLive();
@@ -2462,9 +2562,7 @@ function createFakePluginHostInternal(options, sharedState) {
       let parse;
       if (isZodSchemaLike(parameters)) {
         try {
-          inputSchema = z4.toJSONSchema(parameters, {
-            io: "input"
-          });
+          inputSchema = zodSchemaToJsonSchema(parameters);
         } catch (error) {
           throw new Error(
             `tool "${name}" parameters look like a zod schema but could not be converted to JSON Schema (${errorMessage(error)}) \u2014 use zod 4, or pass a plain JSON-schema object`
@@ -2978,27 +3076,7 @@ function createFakePluginHostInternal(options, sharedState) {
       pending.resolve({ outcome: "cancelled", reason: "user" });
     },
     async setSettings(values) {
-      const errors = validateSettingsUpdate(settingsDescriptors, values);
-      if (errors.length > 0) {
-        throw new Error(errors.join("; "));
-      }
-      const prev = readSettingsValues(settingsDescriptors, storedSettings);
-      for (const [key, value] of Object.entries(values)) {
-        if (value === null) storedSettings.delete(key);
-        else storedSettings.set(key, value);
-      }
-      const next = readSettingsValues(settingsDescriptors, storedSettings);
-      if (JSON.stringify(next) === JSON.stringify(prev)) return;
-      for (const listener of settingsListeners) {
-        try {
-          listener(next, prev);
-        } catch (error) {
-          emitLog(
-            "warn",
-            `settings onChange listener failed: ${errorMessage(error)}`
-          );
-        }
-      }
+      await setSettingsValues(values);
     },
     async callRpc(method, input) {
       const record = rpcHandlers.get(method);

package/package.json

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