@get-bb/plugin-sdk 0.4.35 → 0.4.45

package/dist/internal/host-policy.js

@@ -276,10 +276,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;
@@ -299,6 +335,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"),
@@ -320,6 +359,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,
@@ -416,6 +461,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;
@@ -1692,6 +1752,8 @@ export {
   PLUGIN_PROVIDER_BRIDGE_OPTIONS_MAX_BYTES,
   PLUGIN_PROVIDER_COMPOSER_ACTION_VALUES,
   PLUGIN_PROVIDER_DISPLAY_NAME_MAX_CHARS,
+  PLUGIN_PROVIDER_ENV_MAX_ENTRIES,
+  PLUGIN_PROVIDER_ENV_NAME_PATTERN,
   PLUGIN_PROVIDER_PERMISSION_MODE_VALUES,
   PLUGIN_PROVIDER_REASONING_LEVEL_VALUES,
   PROVIDER_ID_PATTERN,
@@ -1725,6 +1787,7 @@ export {
   undeclaredIconProblem,
   validatePluginAiServiceDeclaration,
   validatePluginProviderDeclaration,
+  validatePluginProviderEnvEntries,
   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

@@ -684,13 +684,21 @@ var threadEventItemPresentationTintSchema = z6.object({
   light: z6.string().min(1),
   dark: z6.string().min(1)
 });
+var THREAD_EVENT_ITEM_PRESENTATION_BADGE_LABEL_MAX_LENGTH = 80;
+var threadEventItemPresentationBadgeSchema = z6.object({
+  glyph: z6.string().min(1),
+  label: z6.string().min(1).max(THREAD_EVENT_ITEM_PRESENTATION_BADGE_LABEL_MAX_LENGTH),
+  hint: z6.string().min(1).max(THREAD_EVENT_ITEM_PRESENTATION_BADGE_LABEL_MAX_LENGTH),
+  tone: z6.enum(["neutral", "destructive"])
+});
 var threadEventItemPresentationSchema = z6.object({
   label: threadEventItemPresentationLabelSchema,
   icon: threadEventItemPresentationIconSchema,
   title: z6.string().optional(),
   detail: z6.string().max(THREAD_EVENT_ITEM_PRESENTATION_DETAIL_MAX_LENGTH).optional(),
   suppress: z6.boolean().optional(),
-  tint: threadEventItemPresentationTintSchema.optional()
+  tint: threadEventItemPresentationTintSchema.optional(),
+  badge: threadEventItemPresentationBadgeSchema.optional()
 });
 
 // ../domain/src/provider-extension-kind.ts
@@ -1409,6 +1417,10 @@ var threadEventScopeDefinitionByType = {
     policy: "thread",
     rationale: "Subscription usage is account-scoped state that can affect multiple turns and threads."
   },
+  "provider.env-resolved": {
+    policy: "thread",
+    rationale: "Resolved provider environment is session state and can change between turns."
+  },
   "thread/extensionState/updated": {
     policy: "thread",
     rationale: "Plugin-declared thread state is current thread metadata (like goals), not part of a specific turn transcript; latest snapshot per kind wins."
@@ -2052,6 +2064,25 @@ var unscopedProviderEventSchema = z14.discriminatedUnion("type", [
     providerThreadId: z14.string(),
     rateLimits: providerRateLimitStateSchema
   }),
+  z14.object({
+    type: z14.literal("provider.env-resolved"),
+    threadId: z14.string(),
+    providerThreadId: z14.string(),
+    entries: z14.array(
+      z14.object({
+        name: z14.string(),
+        source: z14.union([
+          z14.literal("shell"),
+          z14.object({ plugin: z14.string() }).strict()
+        ]),
+        value: z14.union([
+          z14.string(),
+          z14.object({ masked: z14.literal(true) }).strict()
+        ]),
+        reason: z14.string().optional()
+      }).strict()
+    )
+  }),
   z14.object({
     type: z14.literal("thread/extensionState/updated"),
     threadId: z14.string(),
@@ -2705,7 +2736,8 @@ var sessionReplacedNotificationSchema = z23.object({
   threadId: z23.string().min(1),
   providerThreadId: z23.string().min(1).nullable(),
   reason: z23.string().min(1),
-  contextLost: z23.boolean().default(false)
+  contextLost: z23.boolean().default(false),
+  showRuntimeNote: z23.boolean().default(false)
 }).passthrough();
 var providerRawNotificationSchema = z23.object({
   threadId: z23.string().min(1).optional(),
@@ -4189,6 +4221,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 +4857,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 +6071,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 +6722,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 +6897,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 +8762,7 @@ async function startAgentSession(request) {
     },
     pendingInstructions: params.instructions,
     activePromptKind: null,
+    compactionAgentMessage: "",
     queuedInputs: [],
     promptRequestPending: false,
     cancelRequested: false,
@@ -8977,6 +9104,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 +9122,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 +9211,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 +9252,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 +9361,8 @@ async function handleRequest2(request) {
         buildAcpModelListParams(
           decodeLaunchSpec(request.params.providerOptions),
           modelPicker
-        )
+        ),
+        decodeDialectId(request.params.providerOptions)
       );
       return;
     }

package/dist/provider-bridge-testing.js

@@ -322,13 +322,21 @@ var threadEventItemPresentationTintSchema = z4.object({
   light: z4.string().min(1),
   dark: z4.string().min(1)
 });
+var THREAD_EVENT_ITEM_PRESENTATION_BADGE_LABEL_MAX_LENGTH = 80;
+var threadEventItemPresentationBadgeSchema = z4.object({
+  glyph: z4.string().min(1),
+  label: z4.string().min(1).max(THREAD_EVENT_ITEM_PRESENTATION_BADGE_LABEL_MAX_LENGTH),
+  hint: z4.string().min(1).max(THREAD_EVENT_ITEM_PRESENTATION_BADGE_LABEL_MAX_LENGTH),
+  tone: z4.enum(["neutral", "destructive"])
+});
 var threadEventItemPresentationSchema = z4.object({
   label: threadEventItemPresentationLabelSchema,
   icon: threadEventItemPresentationIconSchema,
   title: z4.string().optional(),
   detail: z4.string().max(THREAD_EVENT_ITEM_PRESENTATION_DETAIL_MAX_LENGTH).optional(),
   suppress: z4.boolean().optional(),
-  tint: threadEventItemPresentationTintSchema.optional()
+  tint: threadEventItemPresentationTintSchema.optional(),
+  badge: threadEventItemPresentationBadgeSchema.optional()
 });
 
 // ../domain/src/provider-extension-kind.ts
@@ -1041,6 +1049,10 @@ var threadEventScopeDefinitionByType = {
     policy: "thread",
     rationale: "Subscription usage is account-scoped state that can affect multiple turns and threads."
   },
+  "provider.env-resolved": {
+    policy: "thread",
+    rationale: "Resolved provider environment is session state and can change between turns."
+  },
   "thread/extensionState/updated": {
     policy: "thread",
     rationale: "Plugin-declared thread state is current thread metadata (like goals), not part of a specific turn transcript; latest snapshot per kind wins."
@@ -1693,6 +1705,25 @@ var unscopedProviderEventSchema = z12.discriminatedUnion("type", [
     providerThreadId: z12.string(),
     rateLimits: providerRateLimitStateSchema
   }),
+  z12.object({
+    type: z12.literal("provider.env-resolved"),
+    threadId: z12.string(),
+    providerThreadId: z12.string(),
+    entries: z12.array(
+      z12.object({
+        name: z12.string(),
+        source: z12.union([
+          z12.literal("shell"),
+          z12.object({ plugin: z12.string() }).strict()
+        ]),
+        value: z12.union([
+          z12.string(),
+          z12.object({ masked: z12.literal(true) }).strict()
+        ]),
+        reason: z12.string().optional()
+      }).strict()
+    )
+  }),
   z12.object({
     type: z12.literal("thread/extensionState/updated"),
     threadId: z12.string(),
@@ -4564,7 +4595,8 @@ var sessionReplacedNotificationSchema = z24.object({
   threadId: z24.string().min(1),
   providerThreadId: z24.string().min(1).nullable(),
   reason: z24.string().min(1),
-  contextLost: z24.boolean().default(false)
+  contextLost: z24.boolean().default(false),
+  showRuntimeNote: z24.boolean().default(false)
 }).passthrough();
 var providerRawNotificationSchema = z24.object({
   threadId: z24.string().min(1).optional(),

package/dist/provider-bridge.js

@@ -1980,13 +1980,21 @@ var threadEventItemPresentationTintSchema = z10.object({
   light: z10.string().min(1),
   dark: z10.string().min(1)
 });
+var THREAD_EVENT_ITEM_PRESENTATION_BADGE_LABEL_MAX_LENGTH = 80;
+var threadEventItemPresentationBadgeSchema = z10.object({
+  glyph: z10.string().min(1),
+  label: z10.string().min(1).max(THREAD_EVENT_ITEM_PRESENTATION_BADGE_LABEL_MAX_LENGTH),
+  hint: z10.string().min(1).max(THREAD_EVENT_ITEM_PRESENTATION_BADGE_LABEL_MAX_LENGTH),
+  tone: z10.enum(["neutral", "destructive"])
+});
 var threadEventItemPresentationSchema = z10.object({
   label: threadEventItemPresentationLabelSchema,
   icon: threadEventItemPresentationIconSchema,
   title: z10.string().optional(),
   detail: z10.string().max(THREAD_EVENT_ITEM_PRESENTATION_DETAIL_MAX_LENGTH).optional(),
   suppress: z10.boolean().optional(),
-  tint: threadEventItemPresentationTintSchema.optional()
+  tint: threadEventItemPresentationTintSchema.optional(),
+  badge: threadEventItemPresentationBadgeSchema.optional()
 });
 
 // ../domain/src/provider-extension-kind.ts
@@ -2714,6 +2722,10 @@ var threadEventScopeDefinitionByType = {
     policy: "thread",
     rationale: "Subscription usage is account-scoped state that can affect multiple turns and threads."
   },
+  "provider.env-resolved": {
+    policy: "thread",
+    rationale: "Resolved provider environment is session state and can change between turns."
+  },
   "thread/extensionState/updated": {
     policy: "thread",
     rationale: "Plugin-declared thread state is current thread metadata (like goals), not part of a specific turn transcript; latest snapshot per kind wins."
@@ -3357,6 +3369,25 @@ var unscopedProviderEventSchema = z18.discriminatedUnion("type", [
     providerThreadId: z18.string(),
     rateLimits: providerRateLimitStateSchema
   }),
+  z18.object({
+    type: z18.literal("provider.env-resolved"),
+    threadId: z18.string(),
+    providerThreadId: z18.string(),
+    entries: z18.array(
+      z18.object({
+        name: z18.string(),
+        source: z18.union([
+          z18.literal("shell"),
+          z18.object({ plugin: z18.string() }).strict()
+        ]),
+        value: z18.union([
+          z18.string(),
+          z18.object({ masked: z18.literal(true) }).strict()
+        ]),
+        reason: z18.string().optional()
+      }).strict()
+    )
+  }),
   z18.object({
     type: z18.literal("thread/extensionState/updated"),
     threadId: z18.string(),
@@ -4280,7 +4311,8 @@ var sessionReplacedNotificationSchema = z29.object({
   threadId: z29.string().min(1),
   providerThreadId: z29.string().min(1).nullable(),
   reason: z29.string().min(1),
-  contextLost: z29.boolean().default(false)
+  contextLost: z29.boolean().default(false),
+  showRuntimeNote: z29.boolean().default(false)
 }).passthrough();
 var providerRawNotificationSchema = z29.object({
   threadId: z29.string().min(1).optional(),

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);