@get-bb/plugin-sdk 0.4.30 → 0.4.35

package/dist/testing/app.js

@@ -431,6 +431,7 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
     composerCustomizations: [],
     pendingInteractions: [],
     sidebarFooterActions: [],
+    experimentalSidebarNavigations: [],
     threadLists: [],
     threadHeaderActions: [],
     fileOpeners: [],
@@ -452,6 +453,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(),
@@ -643,6 +645,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);
@@ -1713,7 +1731,8 @@ function renderSlot(registration, props, options = {}) {
     inputLockCalls: [],
     quotes: [],
     mentions: [],
-    focusCount: 0
+    focusCount: 0,
+    submits: []
   };
   const composerOwnership = { active: true };
   const composer = {
@@ -1768,6 +1787,19 @@ ${block}
       },
       focus() {
         composerLog.focusCount += 1;
+      },
+      async experimental_submit({ sendAt }) {
+        if (!composerOwnership.active) {
+          throw new Error("This composer is no longer active.");
+        }
+        if (composerText.trim() === "") {
+          throw new Error("Type a message before scheduling it.");
+        }
+        if (!Number.isFinite(sendAt) || sendAt <= Date.now()) {
+          throw new Error("Pick a time in the future.");
+        }
+        composerLog.submits.push({ sendAt });
+        commitComposerText("");
       }
     }
   };

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",
@@ -1612,6 +1673,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`;
+}
 
 // src/testing/fake-sdk.ts
 function withSpawnAttribution(pluginId, args) {
@@ -2076,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);
@@ -2113,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();
@@ -2456,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`
@@ -2538,6 +2642,7 @@ function createFakePluginHostInternal(options, sharedState) {
       });
     }
   };
+  let requestedDrains = 0;
   const needsConfigurationMessages = [];
   const status = {
     needsConfiguration(message) {
@@ -2569,7 +2674,13 @@ function createFakePluginHostInternal(options, sharedState) {
     "thread.idle": [],
     "thread.failed": [],
     "thread.archived": [],
-    "thread.deleted": []
+    "thread.deleted": [],
+    "message.queued": [],
+    "message.dispatched": [],
+    "turn.failed": []
+  };
+  const hooks = {
+    "message.dispatch": null
   };
   const disposeHooks = [];
   const serviceControllers = [];
@@ -2787,6 +2898,18 @@ function createFakePluginHostInternal(options, sharedState) {
       return registerProviderDeclaration(declaration);
     }
   };
+  const experimental_hooks = {
+    on(hook, handler) {
+      if (hooks[hook] !== null) {
+        throw new Error(pluginHookAlreadyRegisteredMessage(hook));
+      }
+      storePluginHook(hooks, hook, handler);
+    },
+    async recheck(_hook) {
+      assertLive();
+      requestedDrains += 1;
+    }
+  };
   const bb = {
     pluginId,
     log,
@@ -2801,6 +2924,7 @@ function createFakePluginHostInternal(options, sharedState) {
     providers,
     ui,
     events,
+    experimental_hooks,
     status,
     server,
     hosts,
@@ -2858,6 +2982,9 @@ function createFakePluginHostInternal(options, sharedState) {
     logEntries,
     realtimeSignals,
     needsConfigurationMessages,
+    get recheckCount() {
+      return requestedDrains;
+    },
     sharedPortDeclarations,
     experimental_hostRpcCalls: hostRpcCalls,
     sdk: sdkHarness,
@@ -2886,9 +3013,15 @@ function createFakePluginHostInternal(options, sharedState) {
           "thread.idle": threadEventHandlers["thread.idle"].length,
           "thread.failed": threadEventHandlers["thread.failed"].length,
           "thread.archived": threadEventHandlers["thread.archived"].length,
-          "thread.deleted": threadEventHandlers["thread.deleted"].length
+          "thread.deleted": threadEventHandlers["thread.deleted"].length,
+          "message.queued": threadEventHandlers["message.queued"].length,
+          "message.dispatched": threadEventHandlers["message.dispatched"].length,
+          "turn.failed": threadEventHandlers["turn.failed"].length
         };
       },
+      get hooks() {
+        return { ...hooks };
+      },
       mentionProviders,
       providerRegistrations,
       aiServiceRegistrations
@@ -2943,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);
@@ -3195,6 +3308,43 @@ function makeThreadResponse(overrides = {}) {
     runtime: { displayStatus: "idle", hostReconnectGraceExpiresAt: null },
     activeBackgroundAgentCount: 0,
     canSpawnChild: true,
+    queuedMessageCount: 0,
+    ...overrides
+  };
+}
+function makeQueueEntry(overrides = {}) {
+  return {
+    id: "queued_1",
+    threadId: "thread-1",
+    content: [{ type: "text", text: "Queued turn", mentions: [] }],
+    model: "test-model",
+    reasoningLevel: "medium",
+    permissionMode: "auto",
+    serviceTier: "default",
+    groupWithNext: false,
+    sendAt: null,
+    waitingOn: {
+      kind: "plugin",
+      pluginId: "test-plugin",
+      reason: "Waiting"
+    },
+    failureReason: null,
+    payload: { kind: "inline" },
+    editable: true,
+    createdAt: 0,
+    updatedAt: 0,
+    ...overrides
+  };
+}
+function makeTurnFailedEvent(overrides = {}) {
+  return {
+    threadId: "thread-1",
+    requestId: "creq_2222222222",
+    turnId: "turn-1",
+    errorInfo: null,
+    inputAccepted: true,
+    rateLimits: null,
+    attemptNumber: 1,
     ...overrides
   };
 }
@@ -3299,5 +3449,7 @@ export {
   createFakePluginHost,
   createFakeSdk,
   scanPublicSdkOnly as experimental_scanPublicSdkOnly,
-  makeThreadResponse
+  makeQueueEntry,
+  makeThreadResponse,
+  makeTurnFailedEvent
 };

package/package.json

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