@get-bb/plugin-sdk 0.4.34 → 0.4.40

package/dist/internal/host-policy.js

@@ -276,7 +276,7 @@ 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_-]+$/;
@@ -293,12 +293,22 @@ 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 numberSettingSchemaSchema = 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 +320,26 @@ 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("number"),
+    ...settingsBaseFields,
+    experimental_schema: numberSettingSchemaSchema.optional(),
+    default: z3.number().finite().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 +368,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 +413,30 @@ 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;
+    }
+    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;
     }
@@ -377,6 +448,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 +1370,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 +1749,6 @@ export {
   undeclaredIconProblem,
   validatePluginAiServiceDeclaration,
   validatePluginProviderDeclaration,
-  validateSettingsUpdate
+  validateSettingsUpdate,
+  zodSchemaToJsonSchema
 };

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

@@ -246,6 +246,7 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
   const collected = {
     homepageSections: [],
     settingsSections: [],
+    appOverlays: [],
     navPanels: [],
     threadPanelActions: [],
     newThreadPanelActions: [],
@@ -268,6 +269,7 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
   const seenIds = {
     homepageSection: /* @__PURE__ */ new Set(),
     settingsSection: /* @__PURE__ */ new Set(),
+    appOverlay: /* @__PURE__ */ new Set(),
     navPanel: /* @__PURE__ */ new Set(),
     threadPanelAction: /* @__PURE__ */ new Set(),
     newThreadPanelAction: /* @__PURE__ */ new Set(),
@@ -316,6 +318,15 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
           component: requireComponent(kind, registration.component)
         });
       },
+      experimental_appOverlay(registration) {
+        const kind = "slots.experimental_appOverlay";
+        const id = requireSlotId(kind, registration?.id);
+        requireUniqueId(kind, seenIds.appOverlay, id);
+        collected.appOverlays.push({
+          id,
+          component: requireComponent(kind, registration.component)
+        });
+      },
       navPanel(registration) {
         const kind = "slots.navPanel";
         const id = requireSlotId(kind, registration?.id);

package/dist/provider-bridge-acp.js

@@ -4189,6 +4189,11 @@ var acpCompactionCompletedNotificationParamsSchema = z34.discriminatedUnion("sta
     threadId: z34.string().min(1),
     status: z34.literal("interrupted")
   }).passthrough(),
+  z34.object({
+    threadId: z34.string().min(1),
+    status: z34.literal("skipped"),
+    detail: z34.string().min(1)
+  }).passthrough(),
   z34.object({
     threadId: z34.string().min(1),
     status: z34.literal("failed"),
@@ -4820,6 +4825,18 @@ function ompCommandResult(event) {
     ...output.length === 0 ? {} : { output }
   };
 }
+var OMP_COMPACTION_FAILURE_PATTERN = /\bcompaction failed\b/i;
+var OMP_COMPACTION_NOOP_PATTERN = /\b(?:nothing to compact|already compacted)\b/i;
+function compactionOutcomeForEndTurn(dialect, agentMessage) {
+  if (dialect.id !== "omp") {
+    return { status: "completed" };
+  }
+  const text = agentMessage.trim();
+  if (!OMP_COMPACTION_FAILURE_PATTERN.test(text)) {
+    return { status: "completed" };
+  }
+  return OMP_COMPACTION_NOOP_PATTERN.test(text) ? { status: "skipped", detail: text } : { status: "failed", error: text };
+}
 var OMP_ACP_DIALECT = {
   id: "omp",
   commandResult: ompCommandResult
@@ -6022,12 +6039,22 @@ function createAcpDeltaTranslator(options = {}) {
           return [];
         }
         const status = params.data.status;
+        const turnStatus = status === "skipped" ? "completed" : status;
         return [
-          ...flushOpenTurnWork(context, status),
+          ...flushOpenTurnWork(context, itemStatusForTurnStatus(turnStatus)),
           ...status === "completed" ? [{ kind: "context.compacted" }] : [],
+          ...status === "skipped" ? [
+            {
+              kind: "provider.warning",
+              category: "compaction-skipped",
+              summary: "Context compaction skipped",
+              details: params.data.detail,
+              vouchedTurn: true
+            }
+          ] : [],
           {
             kind: "turn.boundary",
-            status,
+            status: turnStatus,
             ...status === "failed" ? { error: { message: params.data.error } } : {}
           }
         ];
@@ -6663,6 +6690,93 @@ function splitPrimaryModels(catalogModels, primaryModels) {
   };
 }
 
+// ../provider-bridge-acp/src/cursor-model-selection.ts
+var CURSOR_LEGACY_FAMILY_SELECTIONS = {
+  "claude-4-sonnet": { modelId: "claude-sonnet-4" },
+  "claude-4.5-opus": { modelId: "claude-opus-4-5" },
+  "claude-4.5-sonnet": { modelId: "claude-sonnet-4-5" },
+  "claude-4.6-opus": { modelId: "claude-opus-4-6" },
+  "claude-4.6-sonnet": { modelId: "claude-sonnet-4-6" },
+  "gemini-3.6-flash-minimal": {
+    modelId: "gemini-3.6-flash",
+    reasoningLevel: "low"
+  },
+  "gpt-5.1-codex-max": { modelId: "gpt-5.1" }
+};
+function bareCursorFamilyId(model) {
+  const familyId = model === "auto" ? "default" : agentModelFamilyId(model);
+  return familyId.startsWith("cursor-") ? familyId.slice("cursor-".length) : familyId;
+}
+function cursorParameterizedSelection(model, reasoningLevel) {
+  const familyId = bareCursorFamilyId(model);
+  const selection = CURSOR_LEGACY_FAMILY_SELECTIONS[familyId] ?? {
+    modelId: familyId
+  };
+  return selection.reasoningLevel !== void 0 || reasoningLevel === void 0 ? selection : { ...selection, reasoningLevel };
+}
+function cursorCatalogModel(model) {
+  const selection = cursorParameterizedSelection(
+    model.id,
+    model.defaultReasoningEffort
+  );
+  const efforts = /* @__PURE__ */ new Map();
+  for (const effort of model.supportedReasoningEfforts) {
+    const level = cursorParameterizedSelection(model.id, effort.reasoningEffort).reasoningLevel ?? effort.reasoningEffort;
+    if (!efforts.has(level)) {
+      efforts.set(level, { ...effort, reasoningEffort: level });
+    }
+  }
+  return {
+    model: {
+      ...model,
+      id: selection.modelId,
+      model: selection.modelId,
+      supportedReasoningEfforts: [...efforts.values()].sort(
+        (a, b) => reasoningLevelValues.indexOf(a.reasoningEffort) - reasoningLevelValues.indexOf(b.reasoningEffort)
+      ),
+      defaultReasoningEffort: selection.reasoningLevel ?? model.defaultReasoningEffort
+    },
+    directFamily: bareCursorFamilyId(model.id) === selection.modelId
+  };
+}
+function buildCursorParameterizedModelCatalog(models) {
+  const normalized = /* @__PURE__ */ new Map();
+  for (const model of models) {
+    const candidate = cursorCatalogModel(model);
+    const current = normalized.get(candidate.model.id);
+    if (current === void 0) {
+      normalized.set(candidate.model.id, candidate);
+      continue;
+    }
+    const preferred = candidate.directFamily && !current.directFamily ? candidate : current;
+    const efforts = new Map(
+      preferred.model.supportedReasoningEfforts.map((effort) => [
+        effort.reasoningEffort,
+        effort
+      ])
+    );
+    for (const effort of [
+      ...current.model.supportedReasoningEfforts,
+      ...candidate.model.supportedReasoningEfforts
+    ]) {
+      if (!efforts.has(effort.reasoningEffort)) {
+        efforts.set(effort.reasoningEffort, effort);
+      }
+    }
+    normalized.set(candidate.model.id, {
+      model: {
+        ...preferred.model,
+        supportedReasoningEfforts: [...efforts.values()].sort(
+          (a, b) => reasoningLevelValues.indexOf(a.reasoningEffort) - reasoningLevelValues.indexOf(b.reasoningEffort)
+        ),
+        isDefault: current.model.isDefault || candidate.model.isDefault
+      },
+      directFamily: preferred.directFamily
+    });
+  }
+  return [...normalized.values()].map((entry) => entry.model);
+}
+
 // ../provider-bridge-acp/src/session-params.ts
 function sanitizeAcpSkillDescription(description) {
   const sanitized = description.replace(/[\r\n]+/gu, " ").replace(/\s+/gu, " ").replace(/[<>]/gu, "").trim();
@@ -6751,26 +6865,6 @@ function buildAcpModelListParams(launchSpec, options) {
     ...launchSpec.nativeReasoning !== void 0 ? { nativeReasoning: launchSpec.nativeReasoning } : {}
   };
 }
-var CURSOR_LEGACY_FAMILY_SELECTIONS = {
-  "claude-4-sonnet": { modelId: "claude-sonnet-4" },
-  "claude-4.5-opus": { modelId: "claude-opus-4-5" },
-  "claude-4.5-sonnet": { modelId: "claude-sonnet-4-5" },
-  "claude-4.6-opus": { modelId: "claude-opus-4-6" },
-  "claude-4.6-sonnet": { modelId: "claude-sonnet-4-6" },
-  "gemini-3.6-flash-minimal": {
-    modelId: "gemini-3.6-flash",
-    reasoningLevel: "low"
-  },
-  "gpt-5.1-codex-max": { modelId: "gpt-5.1" }
-};
-function cursorParameterizedSelection(model, reasoningLevel) {
-  const familyId = model === "auto" ? "default" : agentModelFamilyId(model);
-  const bareFamilyId = familyId.startsWith("cursor-") ? familyId.slice("cursor-".length) : familyId;
-  const selection = CURSOR_LEGACY_FAMILY_SELECTIONS[bareFamilyId] ?? {
-    modelId: bareFamilyId
-  };
-  return selection.reasoningLevel !== void 0 || reasoningLevel === void 0 ? selection : { ...selection, reasoningLevel };
-}
 function buildAcpModelSelectionParam(launchSpec, options, parameterizedModelPicker, dialectId) {
   const model = options.model;
   const listCommand = buildAcpModelListCommand(launchSpec);
@@ -8636,6 +8730,7 @@ async function startAgentSession(request) {
     },
     pendingInstructions: params.instructions,
     activePromptKind: null,
+    compactionAgentMessage: "",
     queuedInputs: [],
     promptRequestPending: false,
     cancelRequested: false,
@@ -8977,6 +9072,7 @@ function runTurn(session, firstInput) {
 }
 function startCompaction(session, pending) {
   session.activePromptKind = "compaction";
+  session.compactionAgentMessage = "";
   emitForSession(session, ACP_COMPACTION_STARTED_METHOD, {
     threadId: session.bbThreadId
   });
@@ -8994,7 +9090,10 @@ function startCompaction(session, pending) {
   acceptTurnInput(session, pending);
   session.turnSettled = promptResult.then((result) => {
     finish(
-      result.stopReason === "end_turn" ? { status: "completed" } : result.stopReason === "cancelled" ? { status: "interrupted" } : {
+      result.stopReason === "end_turn" ? compactionOutcomeForEndTurn(
+        session.dialect,
+        session.compactionAgentMessage
+      ) : result.stopReason === "cancelled" ? { status: "interrupted" } : {
         status: "failed",
         error: `Agent stopped compaction: ${result.stopReason}`
       }
@@ -9080,6 +9179,14 @@ function handleAgentNotification(session, method, params) {
   if (parsed.data.sessionId !== session.providerThreadId) {
     return;
   }
+  if (session.activePromptKind === "compaction") {
+    const chunk = acpAgentMessageChunkUpdateSchema.safeParse(
+      parsed.data.update
+    );
+    if (chunk.success) {
+      session.compactionAgentMessage += extractAcpContentText(chunk.data.content) ?? "";
+    }
+  }
   emitForSession(session, ACP_UPDATE_METHOD, update);
 }
 function decodeAcpBridgeJsonRpcRequest(raw) {
@@ -9113,13 +9220,14 @@ function decodeAcpBridgeJsonRpcRequest(raw) {
     issues: command.error.issues.map((issue) => `${issue.path.join(".")}: ${issue.message}`).join("; ")
   };
 }
-async function handleModelList(id, params) {
+async function handleModelList(id, params, dialectId) {
   const catalog = params.listCommand ? await loadAgentModelCatalog(params.listCommand) : null;
   if (catalog) {
+    const catalogModels = params.parameterizedModelPicker && dialectId === "cursor" ? buildCursorParameterizedModelCatalog(catalog.models) : catalog.models;
     sendResult(
       id,
       splitPrimaryModels(
-        applyConfiguredReasoningToModels(catalog.models, {
+        applyConfiguredReasoningToModels(catalogModels, {
           reasoningCli: params.reasoningCli,
           nativeReasoning: params.nativeReasoning
         }),
@@ -9221,7 +9329,8 @@ async function handleRequest2(request) {
         buildAcpModelListParams(
           decodeLaunchSpec(request.params.providerOptions),
           modelPicker
-        )
+        ),
+        decodeDialectId(request.params.providerOptions)
       );
       return;
     }

package/dist/testing/app.js

@@ -425,6 +425,7 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
   const collected = {
     homepageSections: [],
     settingsSections: [],
+    appOverlays: [],
     navPanels: [],
     threadPanelActions: [],
     newThreadPanelActions: [],
@@ -447,6 +448,7 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
   const seenIds = {
     homepageSection: /* @__PURE__ */ new Set(),
     settingsSection: /* @__PURE__ */ new Set(),
+    appOverlay: /* @__PURE__ */ new Set(),
     navPanel: /* @__PURE__ */ new Set(),
     threadPanelAction: /* @__PURE__ */ new Set(),
     newThreadPanelAction: /* @__PURE__ */ new Set(),
@@ -495,6 +497,15 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
           component: requireComponent(kind, registration.component)
         });
       },
+      experimental_appOverlay(registration) {
+        const kind = "slots.experimental_appOverlay";
+        const id = requireSlotId(kind, registration?.id);
+        requireUniqueId(kind, seenIds.appOverlay, id);
+        collected.appOverlays.push({
+          id,
+          component: requireComponent(kind, registration.component)
+        });
+      },
       navPanel(registration) {
         const kind = "slots.navPanel";
         const id = requireSlotId(kind, registration?.id);