@get-bb/plugin-sdk 0.5.15 → 0.5.23

package/dist/testing/index.js

@@ -1127,48 +1127,17 @@ function validateProviderFallbackModels(providerId, value) {
   }
   return Object.freeze(normalized);
 }
-var AI_SERVICE_KINDS = /* @__PURE__ */ new Set(["inference", "voice"]);
-var SERVER_DIRECT_AI_SERVICE_IDS = Object.freeze([
-  "openai",
-  "amazon-bedrock",
-  "ant-ling",
-  "anthropic",
-  "azure-openai-responses",
-  "baseten",
-  "cerebras",
-  "cloudflare-ai-gateway",
-  "cloudflare-workers-ai",
-  "deepseek",
-  "fireworks",
-  "github-copilot",
-  "google",
-  "google-vertex",
-  "groq",
-  "huggingface",
-  "kimi-coding",
-  "minimax",
-  "minimax-cn",
-  "mistral",
-  "moonshotai",
-  "moonshotai-cn",
-  "nvidia",
-  "openai-codex",
-  "opencode",
-  "opencode-go",
-  "openrouter",
-  "qwen-token-plan",
-  "qwen-token-plan-cn",
-  "radius",
-  "together",
-  "vercel-ai-gateway",
-  "xai",
-  "xiaomi",
-  "xiaomi-token-plan-ams",
-  "xiaomi-token-plan-cn",
-  "xiaomi-token-plan-sgp",
-  "zai",
-  "zai-coding-cn"
+var RESERVED_AI_SERVICE_IDS = /* @__PURE__ */ new Set([
+  "automatic",
+  "off"
 ]);
+function optionalAiServiceFunction(id, name, value) {
+  if (value === void 0) return null;
+  if (typeof value !== "function") {
+    throw new Error(`AI service "${id}" ${name} must be a function`);
+  }
+  return value;
+}
 function validatePluginAiServiceDeclaration(declaration) {
   if (typeof declaration !== "object" || declaration === null) {
     throw new Error("AI service declaration must be an object");
@@ -1179,50 +1148,35 @@ function validatePluginAiServiceDeclaration(declaration) {
       `invalid AI service id ${JSON.stringify(id)} \u2014 use 2-64 lowercase letters, digits, and "-", starting with a letter or digit`
     );
   }
+  if (RESERVED_AI_SERVICE_IDS.has(id)) {
+    throw new Error(
+      `AI service id "${id}" is reserved: bb uses "automatic" and "off" as selection modes. Choose another id.`
+    );
+  }
   const displayName = typeof declaration.displayName === "string" ? declaration.displayName.trim() : "";
   if (displayName.length === 0 || displayName.length > 64) {
     throw new Error(`AI service "${id}" displayName must be 1-64 characters`);
   }
-  const kinds = declaration.kinds;
-  if (!Array.isArray(kinds) || kinds.length === 0) {
-    throw new Error(`AI service "${id}" must declare at least one kind`);
-  }
-  const seen = /* @__PURE__ */ new Set();
-  for (const kind of kinds) {
-    if (typeof kind !== "string" || !AI_SERVICE_KINDS.has(kind)) {
-      throw new Error(
-        `AI service "${id}" kind ${JSON.stringify(kind)} is not one of: ${[...AI_SERVICE_KINDS].join(", ")}`
-      );
-    }
-    if (seen.has(kind)) {
-      throw new Error(`AI service "${id}" declares kind "${kind}" twice`);
-    }
-    seen.add(kind);
-  }
-  return Object.freeze({
+  const complete = optionalAiServiceFunction(
     id,
-    displayName,
-    kinds: Object.freeze([...seen])
-  });
-}
-function assertAiServiceRegistrable(args) {
-  if (SERVER_DIRECT_AI_SERVICE_IDS.includes(args.id)) {
+    "complete",
+    declaration.complete
+  );
+  const transcribe = optionalAiServiceFunction(
+    id,
+    "transcribe",
+    declaration.transcribe
+  );
+  const status = optionalAiServiceFunction(id, "status", declaration.status);
+  if (complete === null && transcribe === null) {
     throw new Error(
-      `AI service id "${args.id}" is reserved: the server serves it directly, so a plugin cannot register it`
+      `AI service "${id}" must declare complete, transcribe, or both`
     );
   }
-  if (args.hostArtifact !== null) {
-    return { artifact: args.hostArtifact, problem: null };
-  }
-  if (args.hostArtifactProblem !== null) {
-    return { artifact: null, problem: args.hostArtifactProblem };
-  }
-  throw new Error(
-    `AI service "${args.id}" needs a bb.host entry to run on: this plugin declares none`
-  );
+  return Object.freeze({ id, displayName, complete, transcribe, status });
 }
 function aiServiceAlreadyRegisteredMessage(id) {
-  return `AI service "${id}" is already registered; a plugin cannot shadow an existing service.`;
+  return `AI service "${id}" is already registered by this plugin.`;
 }
 function providerAlreadyRegisteredMessage(id) {
   return `Provider "${id}" is already registered; a plugin cannot shadow an existing provider.`;
@@ -3237,20 +3191,22 @@ function createFakePluginHostInternal(options, sharedState) {
     register(declaration) {
       assertLive();
       const normalized = validatePluginAiServiceDeclaration(declaration);
-      assertAiServiceRegistrable({
-        id: normalized.id,
-        hostArtifact: options.experimental_hostEntry === false ? null : "declared",
-        hostArtifactProblem: null
-      });
       if (aiServiceRegistrations.some((existing) => existing.id === normalized.id)) {
         throw new Error(aiServiceAlreadyRegisteredMessage(normalized.id));
       }
-      aiServiceRegistrations.push(normalized);
+      const registration = Object.freeze({
+        id: normalized.id,
+        displayName: normalized.displayName,
+        ...normalized.complete === null ? {} : { complete: normalized.complete },
+        ...normalized.transcribe === null ? {} : { transcribe: normalized.transcribe },
+        ...normalized.status === null ? {} : { status: normalized.status }
+      });
+      aiServiceRegistrations.push(registration);
       let disposed2 = false;
       const dispose = () => {
         if (disposed2) return;
         disposed2 = true;
-        const index = aiServiceRegistrations.indexOf(normalized);
+        const index = aiServiceRegistrations.indexOf(registration);
         if (index !== -1) aiServiceRegistrations.splice(index, 1);
       };
       disposeHooks.push(dispose);
@@ -4493,7 +4449,7 @@ var TEST_FILE_PATTERN = /\.test\.[cm]?[jt]sx?$/u;
 var PRIVATE_PACKAGE_PREFIX = "@bb/";
 var PLUGIN_IMPORT_ALLOWLIST = [
   /^@get-bb\/plugin-sdk$/u,
-  /^@get-bb\/plugin-sdk\/(?:host|app|ai-services|provider-bridge|provider-bridge\/acp)$/u,
+  /^@get-bb\/plugin-sdk\/(?:host|app|provider-bridge|provider-bridge\/acp)$/u,
   /^zod$/u,
   /^node:/u,
   /^\.\.?\//u

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@get-bb/plugin-sdk",
-  "version": "0.5.15",
+  "version": "0.5.23",
   "homepage": "https://github.com/get-bb/bb#readme",
   "bugs": {
     "url": "https://github.com/get-bb/bb/issues"
@@ -26,12 +26,6 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
-    "./ai-services": {
-      "source": "./src/ai-services.ts",
-      "types": "./bundled-types/bb-plugin-sdk-ai-services.d.ts",
-      "import": "./dist/ai-services.js",
-      "default": "./dist/ai-services.js"
-    },
     "./provider-bridge": {
       "source": "./src/provider-bridge.ts",
       "types": "./bundled-types/bb-plugin-sdk-provider-bridge.d.ts",
@@ -134,6 +128,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
+    "cross-spawn": "^7.0.6",
     "zod": "^4.3.6"
   },
   "devDependencies": {

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

@@ -1,141 +0,0 @@
-// Portable type declarations for `@get-bb/plugin-sdk`. Unpublished BB
-// workspace contracts are flattened; public subpaths may reuse the
-// package root without requiring any other @bb/* package.
-//
-// Confused by the API, or need a symbol that isn't here? Clone the BB repo
-// and read the real source: https://github.com/get-bb/bb
-
-import { z } from 'zod';
-
-interface JsonObject {
-    [key: string]: JsonValue;
-}
-type JsonValue = string | number | boolean | null | JsonValue[] | JsonObject;
-
-/** Why a call did not produce a result; core's retry policy keys on it. */
-declare const experimental_aiServiceErrorCodeSchema: z.ZodEnum<{
-    auth_required: "auth_required";
-    invalid_response: "invalid_response";
-    rate_limited: "rate_limited";
-    request_failed: "request_failed";
-    service_unavailable: "service_unavailable";
-    timeout: "timeout";
-}>;
-type ExperimentalAiServiceErrorCode = z.infer<typeof experimental_aiServiceErrorCodeSchema>;
-declare const experimental_aiInferenceCompleteInputSchema: z.ZodObject<{
-    model: z.ZodString;
-    outputSchema: z.ZodType<JsonObject, unknown, z.core.$ZodTypeInternals<JsonObject, unknown>>;
-    prompt: z.ZodString;
-    reasoningEffort: z.ZodLiteral<"none">;
-    serviceId: z.ZodString;
-    timeoutMs: z.ZodNumber;
-}, z.core.$strict>;
-type ExperimentalAiInferenceCompleteInput = z.infer<typeof experimental_aiInferenceCompleteInputSchema>;
-declare const experimental_aiInferenceCompleteOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
-    model: z.ZodString;
-    ok: z.ZodLiteral<true>;
-    value: z.ZodType<JsonObject, unknown, z.core.$ZodTypeInternals<JsonObject, unknown>>;
-}, z.core.$strict>, z.ZodObject<{
-    code: z.ZodEnum<{
-        auth_required: "auth_required";
-        invalid_response: "invalid_response";
-        rate_limited: "rate_limited";
-        request_failed: "request_failed";
-        service_unavailable: "service_unavailable";
-        timeout: "timeout";
-    }>;
-    message: z.ZodString;
-    ok: z.ZodLiteral<false>;
-}, z.core.$strict>]>;
-type ExperimentalAiInferenceCompleteOutput = z.infer<typeof experimental_aiInferenceCompleteOutputSchema>;
-declare const experimental_aiVoiceTranscribeInputSchema: z.ZodObject<{
-    audioBase64: z.ZodString;
-    filename: z.ZodString;
-    mimeType: z.ZodString;
-    model: z.ZodString;
-    prompt: z.ZodNullable<z.ZodString>;
-    serviceId: z.ZodString;
-    timeoutMs: z.ZodNumber;
-}, z.core.$strict>;
-type ExperimentalAiVoiceTranscribeInput = z.infer<typeof experimental_aiVoiceTranscribeInputSchema>;
-declare const experimental_aiVoiceTranscribeOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
-    model: z.ZodString;
-    ok: z.ZodLiteral<true>;
-    text: z.ZodString;
-}, z.core.$strict>, z.ZodObject<{
-    code: z.ZodEnum<{
-        auth_required: "auth_required";
-        invalid_response: "invalid_response";
-        rate_limited: "rate_limited";
-        request_failed: "request_failed";
-        service_unavailable: "service_unavailable";
-        timeout: "timeout";
-    }>;
-    message: z.ZodString;
-    ok: z.ZodLiteral<false>;
-}, z.core.$strict>]>;
-type ExperimentalAiVoiceTranscribeOutput = z.infer<typeof experimental_aiVoiceTranscribeOutputSchema>;
-/**
- * The host RPC methods an AI-service plugin implements. A plugin that
- * registers only `inference` still builds against the full contract; the
- * unregistered method may answer `{ ok: false, code: "request_failed" }`.
- */
-declare const experimental_aiServicesHostContract: {
-    readonly "ai.inference.complete": {
-        readonly input: z.ZodObject<{
-            model: z.ZodString;
-            outputSchema: z.ZodType<JsonObject, unknown, z.core.$ZodTypeInternals<JsonObject, unknown>>;
-            prompt: z.ZodString;
-            reasoningEffort: z.ZodLiteral<"none">;
-            serviceId: z.ZodString;
-            timeoutMs: z.ZodNumber;
-        }, z.core.$strict>;
-        readonly output: z.ZodUnion<readonly [z.ZodObject<{
-            model: z.ZodString;
-            ok: z.ZodLiteral<true>;
-            value: z.ZodType<JsonObject, unknown, z.core.$ZodTypeInternals<JsonObject, unknown>>;
-        }, z.core.$strict>, z.ZodObject<{
-            code: z.ZodEnum<{
-                auth_required: "auth_required";
-                invalid_response: "invalid_response";
-                rate_limited: "rate_limited";
-                request_failed: "request_failed";
-                service_unavailable: "service_unavailable";
-                timeout: "timeout";
-            }>;
-            message: z.ZodString;
-            ok: z.ZodLiteral<false>;
-        }, z.core.$strict>]>;
-    };
-    readonly "ai.voice.transcribe": {
-        readonly input: z.ZodObject<{
-            audioBase64: z.ZodString;
-            filename: z.ZodString;
-            mimeType: z.ZodString;
-            model: z.ZodString;
-            prompt: z.ZodNullable<z.ZodString>;
-            serviceId: z.ZodString;
-            timeoutMs: z.ZodNumber;
-        }, z.core.$strict>;
-        readonly output: z.ZodUnion<readonly [z.ZodObject<{
-            model: z.ZodString;
-            ok: z.ZodLiteral<true>;
-            text: z.ZodString;
-        }, z.core.$strict>, z.ZodObject<{
-            code: z.ZodEnum<{
-                auth_required: "auth_required";
-                invalid_response: "invalid_response";
-                rate_limited: "rate_limited";
-                request_failed: "request_failed";
-                service_unavailable: "service_unavailable";
-                timeout: "timeout";
-            }>;
-            message: z.ZodString;
-            ok: z.ZodLiteral<false>;
-        }, z.core.$strict>]>;
-    };
-};
-type ExperimentalAiServicesHostContract = typeof experimental_aiServicesHostContract;
-
-export { experimental_aiInferenceCompleteInputSchema, experimental_aiInferenceCompleteOutputSchema, experimental_aiServiceErrorCodeSchema, experimental_aiServicesHostContract, experimental_aiVoiceTranscribeInputSchema, experimental_aiVoiceTranscribeOutputSchema };
-export type { ExperimentalAiInferenceCompleteInput, ExperimentalAiInferenceCompleteOutput, ExperimentalAiServiceErrorCode, ExperimentalAiServicesHostContract, ExperimentalAiVoiceTranscribeInput, ExperimentalAiVoiceTranscribeOutput };

package/dist/ai-services.js

@@ -1,95 +0,0 @@
-// src/ai-services.ts
-import { z as z2 } from "zod";
-
-// ../domain/src/json-value.ts
-import { z } from "zod";
-var jsonValueSchema = z.lazy(
-  () => z.union([
-    z.string(),
-    z.number(),
-    z.boolean(),
-    z.null(),
-    z.array(jsonValueSchema),
-    z.record(z.string(), jsonValueSchema)
-  ])
-);
-var jsonObjectSchema = z.record(
-  z.string(),
-  jsonValueSchema
-);
-
-// src/rpc-contract.ts
-function defineRpcContract(contract) {
-  return contract;
-}
-
-// src/ai-services.ts
-var experimental_aiServiceErrorCodeSchema = z2.enum([
-  /** The service did not answer within the request's `timeoutMs`. */
-  "timeout",
-  /** The upstream rejected the request for rate or quota reasons; retryable. */
-  "rate_limited",
-  /** The upstream is down or overloaded; retryable. */
-  "service_unavailable",
-  /** No usable credentials on this host; the user must sign in. Not retryable. */
-  "auth_required",
-  /** The upstream rejected the request (bad model, bad input, policy). Not retryable. */
-  "request_failed",
-  /** The upstream answered, but not with something that satisfies the request. */
-  "invalid_response"
-]);
-var failureSchema = z2.object({
-  ok: z2.literal(false),
-  code: experimental_aiServiceErrorCodeSchema,
-  message: z2.string().min(1)
-}).strict();
-var experimental_aiInferenceCompleteInputSchema = z2.object({
-  serviceId: z2.string().min(1),
-  /** The model segment of the user's `<serviceId>/<model>` setting. */
-  model: z2.string().min(1),
-  /** Helper inference is short and latency-bound; no reasoning. */
-  reasoningEffort: z2.literal("none"),
-  prompt: z2.string().min(1),
-  /** A JSON Schema object the structured result must satisfy. */
-  outputSchema: jsonObjectSchema,
-  timeoutMs: z2.number().int().positive()
-}).strict();
-var experimental_aiInferenceCompleteOutputSchema = z2.union([
-  z2.object({
-    ok: z2.literal(true),
-    model: z2.string().min(1),
-    value: jsonObjectSchema
-  }).strict(),
-  failureSchema
-]);
-var experimental_aiVoiceTranscribeInputSchema = z2.object({
-  serviceId: z2.string().min(1),
-  model: z2.string().min(1),
-  audioBase64: z2.string().min(1),
-  mimeType: z2.string().min(1),
-  filename: z2.string().min(1),
-  prompt: z2.string().nullable(),
-  timeoutMs: z2.number().int().positive()
-}).strict();
-var experimental_aiVoiceTranscribeOutputSchema = z2.union([
-  z2.object({ ok: z2.literal(true), model: z2.string().min(1), text: z2.string() }).strict(),
-  failureSchema
-]);
-var experimental_aiServicesHostContract = defineRpcContract({
-  "ai.inference.complete": {
-    input: experimental_aiInferenceCompleteInputSchema,
-    output: experimental_aiInferenceCompleteOutputSchema
-  },
-  "ai.voice.transcribe": {
-    input: experimental_aiVoiceTranscribeInputSchema,
-    output: experimental_aiVoiceTranscribeOutputSchema
-  }
-});
-export {
-  experimental_aiInferenceCompleteInputSchema,
-  experimental_aiInferenceCompleteOutputSchema,
-  experimental_aiServiceErrorCodeSchema,
-  experimental_aiServicesHostContract,
-  experimental_aiVoiceTranscribeInputSchema,
-  experimental_aiVoiceTranscribeOutputSchema
-};