@get-bb/plugin-sdk 0.4.35 → 0.4.45

package/dist/testing/index.js

@@ -289,10 +289,46 @@ var PLUGIN_HTTP_METHODS = /* @__PURE__ */ new Set([
   "HEAD",
   "OPTIONS"
 ]);
-var RPC_METHOD_PATTERN = /^[a-zA-Z0-9_-]+$/;
+var RPC_METHOD_PATTERN = /^[a-zA-Z0-9_-]+(?:\.[a-zA-Z0-9_-]+)*$/;
 var BACKGROUND_NAME_PATTERN = /^[a-zA-Z0-9_-]+$/;
 var CLI_COMMAND_NAME_PATTERN = /^[a-z0-9-]+$/;
 var AGENT_TOOL_NAME_PATTERN = /^[a-zA-Z0-9_-]+$/;
+var PLUGIN_PROVIDER_ENV_NAME_PATTERN = /^[A-Z_][A-Z0-9_]*$/;
+var PLUGIN_PROVIDER_ENV_MAX_ENTRIES = 32;
+var pluginProviderEnvEntrySchema = z3.object({
+  name: z3.string().regex(PLUGIN_PROVIDER_ENV_NAME_PATTERN),
+  value: z3.union([
+    z3.string(),
+    z3.object({ serverPath: z3.string().startsWith("/") }).strict()
+  ]),
+  reason: z3.string(),
+  secret: z3.boolean()
+}).strict();
+var pluginProviderEnvEntriesSchema = z3.array(pluginProviderEnvEntrySchema).max(PLUGIN_PROVIDER_ENV_MAX_ENTRIES).superRefine((entries, context) => {
+  const names = /* @__PURE__ */ new Set();
+  for (let index = 0; index < entries.length; index += 1) {
+    const name = entries[index]?.name;
+    if (name !== void 0 && names.has(name)) {
+      context.addIssue({
+        code: "custom",
+        path: [index, "name"],
+        message: "must be unique within one resolver"
+      });
+    }
+    if (name !== void 0) names.add(name);
+  }
+});
+function validatePluginProviderEnvEntries(value) {
+  const parsed = pluginProviderEnvEntriesSchema.safeParse(value);
+  if (!parsed.success) {
+    const issue = parsed.error.issues[0];
+    const path = issue?.path.length ? `[${issue.path.join(".")}] ` : "";
+    throw new Error(
+      `provider environment contribution ${path}${issue?.message ?? "is invalid"}`
+    );
+  }
+  return parsed.data;
+}
 var PLUGIN_AGENT_STATIC_INSTRUCTIONS_MAX_CHARS = 4096;
 var PLUGIN_AGENT_STATUS_LABEL_MAX_CHARS = 80;
 var PLUGIN_AGENT_SELECTION_MAX_IDS = 256;
@@ -312,6 +348,9 @@ var stringSettingSchemaSchema = z3.custom(
 var booleanSettingSchemaSchema = z3.custom(
   (value) => isStandardSchema(value)
 );
+var numberSettingSchemaSchema = z3.custom(
+  (value) => isStandardSchema(value)
+);
 var settingDescriptorSchema = z3.discriminatedUnion("type", [
   z3.object({
     type: z3.literal("string"),
@@ -333,6 +372,12 @@ var settingDescriptorSchema = z3.discriminatedUnion("type", [
     experimental_schema: booleanSettingSchemaSchema.optional(),
     default: z3.boolean().optional()
   }).strict(),
+  z3.object({
+    type: z3.literal("number"),
+    ...settingsBaseFields,
+    experimental_schema: numberSettingSchemaSchema.optional(),
+    default: z3.number().finite().optional()
+  }).strict(),
   z3.object({
     type: z3.literal("select"),
     ...settingsBaseFields,
@@ -429,6 +474,21 @@ function validateSettingsUpdate(descriptors, values) {
       }
       continue;
     }
+    if (descriptor.type === "number") {
+      if (typeof value !== "number" || !Number.isFinite(value)) {
+        errors.push(`setting "${key}" expects a finite number`);
+        continue;
+      }
+      const validationError2 = settingSchemaError(
+        key,
+        descriptor.experimental_schema,
+        value
+      );
+      if (validationError2 !== null) {
+        errors.push(validationError2);
+      }
+      continue;
+    }
     if (typeof value !== "string") {
       errors.push(`setting "${key}" expects a string`);
       continue;
@@ -1766,7 +1826,14 @@ function readSettingsValues(descriptors, stored) {
   const values = {};
   for (const [key, descriptor] of Object.entries(descriptors)) {
     let value = stored.get(key);
-    const expected = descriptor.type === "boolean" ? "boolean" : "string";
+    if (descriptor.type === "number" && typeof value === "string") {
+      const legacyNumber = Number(value.trim());
+      value = value.trim().length > 0 && Number.isFinite(legacyNumber) ? legacyNumber : void 0;
+    }
+    if (descriptor.type === "number" && typeof value === "number" && !Number.isFinite(value)) {
+      value = void 0;
+    }
+    const expected = descriptor.type === "boolean" ? "boolean" : descriptor.type === "number" ? "number" : "string";
     if (typeof value !== expected) value = void 0;
     if (descriptor.type === "select" && typeof value === "string" && !descriptor.options.includes(value)) {
       value = void 0;
@@ -2190,7 +2257,7 @@ function createFakePluginHostInternal(options, sharedState) {
     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") {
+      else if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
         storedSettings.set(key, value);
       } else {
         throw new Error(`setting "${key}" has an unsupported value`);
@@ -2302,7 +2369,7 @@ function createFakePluginHostInternal(options, sharedState) {
       for (const [name, contractValue] of contractEntries) {
         if (!RPC_METHOD_PATTERN.test(name)) {
           throw new Error(
-            `invalid rpc method name "${name}" \u2014 use letters, digits, "-" and "_"`
+            `invalid rpc method name "${name}" \u2014 use dot-separated segments with letters, digits, "-" and "_"`
           );
         }
         const methodContract = readRpcMethodContract(name, contractValue);
@@ -2437,6 +2504,8 @@ function createFakePluginHostInternal(options, sharedState) {
   };
   const agentTools = [];
   const providerRegistrations = [];
+  const providerEnvResolvers = /* @__PURE__ */ new Map();
+  const providerEnvHealthResolvers = /* @__PURE__ */ new Map();
   let agentConfigurationProvider = null;
   let instructionProvider = null;
   function registerProviderDeclaration(declaration) {
@@ -2652,9 +2721,14 @@ function createFakePluginHostInternal(options, sharedState) {
       );
     }
   };
+  const appUrl = options.appUrl ?? null;
   const loopbackBaseUrl = options.loopbackBaseUrl ?? "http://127.0.0.1:38886";
   const dataDir = options.dataDir ?? "/tmp/bb-fake-data-dir";
   const server = {
+    get experimental_appUrl() {
+      assertLive();
+      return appUrl;
+    },
     get loopbackBaseUrl() {
       assertLive();
       return loopbackBaseUrl;
@@ -2675,6 +2749,7 @@ function createFakePluginHostInternal(options, sharedState) {
     "thread.failed": [],
     "thread.archived": [],
     "thread.deleted": [],
+    "interaction.pending": [],
     "message.queued": [],
     "message.dispatched": [],
     "turn.failed": []
@@ -2896,6 +2971,44 @@ function createFakePluginHostInternal(options, sharedState) {
   const providers = {
     register(declaration) {
       return registerProviderDeclaration(declaration);
+    },
+    experimental_contributeEnv(providerId, resolve2) {
+      assertLive();
+      if (typeof providerId !== "string" || providerId.trim().length === 0) {
+        throw new Error(
+          "provider environment contribution requires a provider id"
+        );
+      }
+      if (providerEnvResolvers.has(providerId)) {
+        throw new Error(
+          `provider environment contribution for "${providerId}" is already registered`
+        );
+      }
+      if (typeof resolve2 !== "function") {
+        throw new Error(
+          "provider environment contribution requires a resolver function"
+        );
+      }
+      providerEnvResolvers.set(providerId, resolve2);
+    },
+    experimental_contributeEnvHealth(providerId, resolve2) {
+      assertLive();
+      if (typeof providerId !== "string" || providerId.trim().length === 0) {
+        throw new Error(
+          "provider environment health contribution requires a provider id"
+        );
+      }
+      if (providerEnvHealthResolvers.has(providerId)) {
+        throw new Error(
+          `provider environment health contribution for "${providerId}" is already registered`
+        );
+      }
+      if (typeof resolve2 !== "function") {
+        throw new Error(
+          "provider environment health contribution requires a resolver function"
+        );
+      }
+      providerEnvHealthResolvers.set(providerId, resolve2);
     }
   };
   const experimental_hooks = {
@@ -3014,6 +3127,7 @@ function createFakePluginHostInternal(options, sharedState) {
           "thread.failed": threadEventHandlers["thread.failed"].length,
           "thread.archived": threadEventHandlers["thread.archived"].length,
           "thread.deleted": threadEventHandlers["thread.deleted"].length,
+          "interaction.pending": threadEventHandlers["interaction.pending"].length,
           "message.queued": threadEventHandlers["message.queued"].length,
           "message.dispatched": threadEventHandlers["message.dispatched"].length,
           "turn.failed": threadEventHandlers["turn.failed"].length
@@ -3024,6 +3138,8 @@ function createFakePluginHostInternal(options, sharedState) {
       },
       mentionProviders,
       providerRegistrations,
+      providerEnvResolvers,
+      providerEnvHealthResolvers,
       aiServiceRegistrations
     },
     get pendingInteractions() {
@@ -3041,6 +3157,43 @@ function createFakePluginHostInternal(options, sharedState) {
         await handler({ hostId });
       }
     },
+    async resolveProviderEnv(providerId, context) {
+      assertLive();
+      const resolve2 = providerEnvResolvers.get(providerId);
+      if (resolve2 === void 0) return [];
+      try {
+        return validatePluginProviderEnvEntries(await resolve2(context));
+      } catch (error) {
+        emitLog(
+          "warn",
+          `provider environment contribution failed: ${error instanceof Error ? error.message : String(error)}`
+        );
+        return [];
+      }
+    },
+    async resolveProviderEnvHealth(providerId, context) {
+      assertLive();
+      if (!providerEnvResolvers.has(providerId)) return null;
+      const resolve2 = providerEnvHealthResolvers.get(providerId);
+      if (resolve2 === void 0) return null;
+      try {
+        const value = await resolve2(context);
+        if (value === null) return null;
+        if (value.label.trim().length === 0) {
+          throw new Error("label must not be empty");
+        }
+        if (value.statusMessage.trim().length === 0) {
+          throw new Error("statusMessage must not be empty");
+        }
+        return value;
+      } catch (error) {
+        emitLog(
+          "warn",
+          `provider environment health contribution failed: ${error instanceof Error ? error.message : String(error)}`
+        );
+        return null;
+      }
+    },
     async experimental_emitHostSignal(hostId, signal, payload) {
       assertLive();
       if (hostId.trim().length === 0) {
@@ -3312,6 +3465,151 @@ function makeThreadResponse(overrides = {}) {
     ...overrides
   };
 }
+function makePluginAgentConfigurationContext(overrides = {}) {
+  const context = {
+    thread: {
+      id: "thread-test",
+      title: null,
+      parentThreadId: null,
+      sourceThreadId: null
+    },
+    project: {
+      id: "project-test",
+      kind: "standard",
+      name: "Test project",
+      gitRemoteUrl: null
+    },
+    environment: {
+      id: "environment-test",
+      name: null,
+      path: "/tmp/test",
+      workspaceProvisionType: "unmanaged",
+      branchName: null
+    },
+    host: { id: "host-test", name: "Test host" },
+    provider: {
+      id: "test-provider",
+      model: "test-model",
+      capabilities: { supportsNativeUserQuestion: false }
+    },
+    origin: { kind: null, pluginId: null }
+  };
+  return {
+    thread: { ...context.thread, ...overrides.thread },
+    project: { ...context.project, ...overrides.project },
+    environment: { ...context.environment, ...overrides.environment },
+    host: { ...context.host, ...overrides.host },
+    provider: {
+      ...context.provider,
+      ...overrides.provider,
+      capabilities: {
+        ...context.provider.capabilities,
+        ...overrides.provider?.capabilities
+      }
+    },
+    origin: { ...context.origin, ...overrides.origin }
+  };
+}
+function makeMessageDispatchHookContext(overrides = {}) {
+  const context = {
+    thread: makeThreadResponse({ status: "pending" }),
+    project: {
+      id: "project-1",
+      kind: "standard",
+      name: "Test project",
+      gitRemoteUrl: null,
+      createdAt: 0,
+      updatedAt: 0
+    },
+    environment: null,
+    host: null,
+    input: { blocks: [], text: "Test message" },
+    requestedExecution: {
+      providerId: "test-provider",
+      model: null,
+      reasoningLevel: null,
+      serviceTier: null,
+      permissionMode: null
+    },
+    executionSources: {
+      providerId: null,
+      model: null,
+      reasoningLevel: null,
+      serviceTier: null,
+      permissionMode: null
+    },
+    attempt: "start-turn",
+    queuedMessage: null,
+    origin: null,
+    originPluginId: null,
+    startedOnBehalfOf: null,
+    parentThreadId: null
+  };
+  const environmentDefaults = {
+    id: "environment-1",
+    name: null,
+    projectId: "project-1",
+    hostId: "host-1",
+    path: "/tmp/test",
+    managed: true,
+    isGitRepo: true,
+    isWorktree: false,
+    workspaceProvisionType: "unmanaged",
+    branchName: "main",
+    baseBranch: null,
+    defaultBranch: "main",
+    mergeBaseBranch: null,
+    status: "ready",
+    createdAt: 0,
+    updatedAt: 0
+  };
+  const hostDefaults = {
+    id: "host-1",
+    name: "Test host",
+    type: "persistent",
+    status: "connected",
+    maxPermissionMode: "full",
+    lastSeenAt: null,
+    lastRejectedProtocolVersion: null,
+    createdAt: 0,
+    updatedAt: 0
+  };
+  const project = { ...context.project, ...overrides.project };
+  const host = overrides.host === void 0 ? context.host : overrides.host === null ? null : { ...hostDefaults, ...overrides.host };
+  const environment = overrides.environment === void 0 ? context.environment : overrides.environment === null ? null : {
+    ...environmentDefaults,
+    projectId: project.id,
+    hostId: host?.id ?? environmentDefaults.hostId,
+    ...overrides.environment
+  };
+  const thread = {
+    ...context.thread,
+    projectId: project.id,
+    environmentId: environment?.id ?? null,
+    ...overrides.thread
+  };
+  return {
+    ...context,
+    ...overrides,
+    thread,
+    project,
+    environment,
+    host,
+    input: { ...context.input, ...overrides.input },
+    requestedExecution: {
+      ...context.requestedExecution,
+      ...overrides.requestedExecution
+    },
+    executionSources: {
+      ...context.executionSources,
+      ...overrides.executionSources
+    },
+    queuedMessage: overrides.queuedMessage === void 0 ? context.queuedMessage : overrides.queuedMessage === null ? null : makeQueueEntry({
+      threadId: thread.id,
+      ...overrides.queuedMessage
+    })
+  };
+}
 function makeQueueEntry(overrides = {}) {
   return {
     id: "queued_1",
@@ -3449,6 +3747,8 @@ export {
   createFakePluginHost,
   createFakeSdk,
   scanPublicSdkOnly as experimental_scanPublicSdkOnly,
+  makeMessageDispatchHookContext,
+  makePluginAgentConfigurationContext,
   makeQueueEntry,
   makeThreadResponse,
   makeTurnFailedEvent

package/package.json

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