@get-bb/plugin-sdk 0.4.84 → 0.4.88

package/bundled-types/bb-plugin-sdk-app.d.ts

@@ -18,6 +18,14 @@ import { z } from 'zod';
 type JsonValue$1 = string | number | boolean | null | JsonValue$1[] | {
     [key: string]: JsonValue$1;
 };
+/**
+ * A `JsonValue` that is read-only at every depth. BB uses it for JSON
+ * snapshots it deep-freezes before handing them to a plugin, where any write
+ * throws at runtime.
+ */
+type ReadonlyJsonValue = string | number | boolean | null | readonly ReadonlyJsonValue[] | {
+    readonly [key: string]: ReadonlyJsonValue;
+};
 
 /** A JSON-safe path segment reported by a Standard Schema validation issue. */
 type PluginRpcIssuePathSegment = string | number;
@@ -2821,4 +2829,4 @@ declare const experimental_useProviders: () => PluginProvidersState;
 declare const experimental_useCodeTheme: () => PluginCodeThemeState;
 
 export { Markdown, ThreadChat, UrlLink, definePluginApp, experimental_BranchPicker, experimental_Diff, experimental_FileLink, experimental_Icon, experimental_NewThreadComposer, experimental_PermissionModePicker, experimental_ProviderIcon, experimental_ProviderModelPicker, experimental_SourceCode, experimental_useAppPanel, experimental_useBranches, experimental_useCheckoutState, experimental_useCodeTheme, experimental_useFixedTabTarget, experimental_useProviders, experimental_useSidebarThreadActions, experimental_useSidebarThreadPullRequest, experimental_useSidebarThreadSplit, experimental_useSidebarThreads, useBbContext, useBbNavigate, useComposer, useComposerView, useRealtime, useRealtimeConnectionState, useRpc, useSettings };
-export type { BbContext, BbNavigate, BranchPickerProps, BranchesState, CheckoutState, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppIcons, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSubmitOptions, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalIconProps, ExperimentalIconRegistration, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginFixedTabReference, ExperimentalProviderIconProps, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalSidebarFooter, ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterActionRegistration, ExperimentalSidebarFooterDisclosureController, ExperimentalSidebarFooterDisclosureProps, ExperimentalSidebarFooterDisclosureRegistration, ExperimentalSidebarFooterItemBase, ExperimentalSidebarFooterItemRegistration, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, JsonValue$1 as JsonValue, MarkdownProps, NewThreadComposerProps, NewThreadRequest, PluginAppBuilder, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandPaletteActionContext, PluginCommandPaletteActionRegistration, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, PluginFileOpenerProps, PluginFileOpenerRegistration, PluginFileOpenerSource, PluginFixedTabDeclaration, PluginFixedTabRegistration, PluginHomepageSectionProps, PluginHomepageSectionRegistration, PluginMachineProviderInputsChange, PluginMachineProviderInputsProps, PluginMachineProviderInputsRegistration, PluginMessageActionContext, PluginMessageActionRegistration, PluginMessageDirectiveMessage, PluginMessageDirectiveOpenWorkspaceFile, PluginMessageDirectiveProps, PluginMessageDirectiveRegistration, PluginNavPanelProps, PluginNavPanelRegistration, PluginNewThreadPanelActionContext, PluginNewThreadPanelActionRegistration, PluginNewThreadPanelProps, PluginPanelActionOpenOptions, PluginPendingInteractionProps, PluginPendingInteractionRegistration, PluginPendingInteractionView, PluginProviderIconRegistration, PluginProvidersState, PluginRealtimeConnectionState, PluginRpcCallArgs, PluginRpcClient, PluginRpcContract, PluginRpcError, PluginRpcErrorCode, PluginRpcHandlers, PluginRpcIssuePathSegment, PluginRpcMethodContract, PluginRpcResult, PluginRpcValidationIssue, PluginSdkApp, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsState, PluginSidebarFooterActionContext, PluginSidebarFooterActionProps, PluginSidebarFooterActionRegistration, PluginSidebarProject, PluginSidebarPullRequest, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginTargetedPanelActionOpenOptions, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps, UseBranchesArgs, UseCheckoutStateArgs };
+export type { BbContext, BbNavigate, BranchPickerProps, BranchesState, CheckoutState, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppIcons, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSubmitOptions, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalIconProps, ExperimentalIconRegistration, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginFixedTabReference, ExperimentalProviderIconProps, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalSidebarFooter, ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterActionRegistration, ExperimentalSidebarFooterDisclosureController, ExperimentalSidebarFooterDisclosureProps, ExperimentalSidebarFooterDisclosureRegistration, ExperimentalSidebarFooterItemBase, ExperimentalSidebarFooterItemRegistration, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, JsonValue$1 as JsonValue, MarkdownProps, NewThreadComposerProps, NewThreadRequest, PluginAppBuilder, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandPaletteActionContext, PluginCommandPaletteActionRegistration, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, PluginFileOpenerProps, PluginFileOpenerRegistration, PluginFileOpenerSource, PluginFixedTabDeclaration, PluginFixedTabRegistration, PluginHomepageSectionProps, PluginHomepageSectionRegistration, PluginMachineProviderInputsChange, PluginMachineProviderInputsProps, PluginMachineProviderInputsRegistration, PluginMessageActionContext, PluginMessageActionRegistration, PluginMessageDirectiveMessage, PluginMessageDirectiveOpenWorkspaceFile, PluginMessageDirectiveProps, PluginMessageDirectiveRegistration, PluginNavPanelProps, PluginNavPanelRegistration, PluginNewThreadPanelActionContext, PluginNewThreadPanelActionRegistration, PluginNewThreadPanelProps, PluginPanelActionOpenOptions, PluginPendingInteractionProps, PluginPendingInteractionRegistration, PluginPendingInteractionView, PluginProviderIconRegistration, PluginProvidersState, PluginRealtimeConnectionState, PluginRpcCallArgs, PluginRpcClient, PluginRpcContract, PluginRpcError, PluginRpcErrorCode, PluginRpcHandlers, PluginRpcIssuePathSegment, PluginRpcMethodContract, PluginRpcResult, PluginRpcValidationIssue, PluginSdkApp, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsState, PluginSidebarFooterActionContext, PluginSidebarFooterActionProps, PluginSidebarFooterActionRegistration, PluginSidebarProject, PluginSidebarPullRequest, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginTargetedPanelActionOpenOptions, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, ReadonlyJsonValue, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps, UseBranchesArgs, UseCheckoutStateArgs };

package/bundled-types/bb-plugin-sdk-internal-host-policy.d.ts

@@ -7,6 +7,7 @@
 
 import { z } from 'zod';
 import { StandardSchemaV1 as StandardSchemaV1$1, PluginEnvironmentProviderRequirements as PluginEnvironmentProviderRequirements$1, StandardSchemaV1InferOutput, PluginEnvironmentValidateDecision, JsonValue as JsonValue$2, PluginMachineValidateDecision } from '@get-bb/plugin-sdk';
+import Database from 'better-sqlite3';
 
 /** Input-form entry: a path, or a path with options. */
 declare const providerNativeRootInputSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
@@ -707,6 +708,21 @@ type JsonValue = string | number | boolean | null | JsonValue[] | {
     [key: string]: JsonValue;
 };
 
+/** A JSON-safe path segment reported by a Standard Schema validation issue. */
+type PluginRpcIssuePathSegment = string | number;
+/** Validator-neutral validation detail carried by an RPC error envelope. */
+interface PluginRpcValidationIssue {
+    message: string;
+    path?: PluginRpcIssuePathSegment[];
+}
+/** Stable wire error categories for plugin RPC. */
+type PluginRpcErrorCode = "handler_error" | "invalid_input" | "invalid_json" | "invalid_output" | "non_json_result" | "unknown_method";
+/** Structured RPC failure returned as `{ ok: false, error }`. */
+interface PluginRpcError {
+    code: PluginRpcErrorCode;
+    message: string;
+    issues?: PluginRpcValidationIssue[];
+}
 /**
  * The validator-neutral subset of Standard Schema v1 used by plugin contracts.
  * Zod 4 schemas implement this interface directly; other validators can do
@@ -735,10 +751,6 @@ interface StandardSchemaV1Issue {
         readonly key: PropertyKey;
     })[];
 }
-interface PluginRpcMethodContract<InputSchema extends StandardSchemaV1 = StandardSchemaV1, OutputSchema extends StandardSchemaV1 = StandardSchemaV1> {
-    readonly input: InputSchema;
-    readonly output: OutputSchema;
-}
 
 type PluginSettingDescriptor = {
     type: "string";
@@ -1021,6 +1033,33 @@ interface PluginHookSignatures {
 }
 type PluginHookName = keyof PluginHookSignatures;
 type PluginHookHandler<K extends PluginHookName> = (context: PluginHookSignatures[K]["context"]) => PluginHookSignatures[K]["decision"] | Promise<PluginHookSignatures[K]["decision"]>;
+type PluginHttpAuthMode = "local" | "none" | "token";
+interface PluginCliCommandInfo {
+    name: string;
+    summary: string;
+    usage: string;
+}
+/** Context forwarded from the invoking CLI when known; all fields optional. */
+interface PluginCliContext {
+    cwd?: string;
+    threadId?: string;
+    projectId?: string;
+    /** Aborted when the invoking CLI HTTP request disconnects. */
+    signal?: AbortSignal;
+}
+interface PluginInteractionRequest {
+    threadId: string;
+    rendererId: string;
+    title: string;
+    payload: JsonValue;
+    /** Defaults to ten minutes; capped at one hour. */
+    timeoutMs?: number;
+}
+interface PluginCliResult {
+    exitCode: number;
+    stdout?: string;
+    stderr?: string;
+}
 interface PluginCliOutputLimitError {
     code: "plugin_cli_output_too_large";
     message: string;
@@ -1036,6 +1075,39 @@ interface PluginCliExecutionResult {
     stderr: string;
     error?: PluginCliOutputLimitError;
 }
+interface PluginCliRegistration {
+    /** Preferred top-level command name (`bb <name> …`): lowercase [a-z0-9-]+.
+     * A core collision logs an activation warning and remains available through
+     * `bb plugin run <plugin-id>`. */
+    name: string;
+    summary: string;
+    /** Subcommand metadata rendered in help and the plugin-commands skill
+     * without executing plugin code. Parsing argv is plugin-owned. */
+    commands?: PluginCliCommandInfo[];
+    run(argv: string[], ctx: PluginCliContext): PluginCliResult | Promise<PluginCliResult>;
+}
+/** Per-turn context handed to bb.agents context providers (design §4.4). */
+/** MCP-style content parts a native tool may return (design §4.4). */
+type PluginAgentToolContentPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    data: string;
+    mimeType: string;
+};
+type PluginAgentToolResult = string | {
+    content: PluginAgentToolContentPart[];
+    isError?: boolean;
+};
+/** Per-call context handed to a native tool's execute (design §4.4). */
+interface PluginAgentToolContext {
+    threadId: string;
+    projectId: string;
+    /** The tool-call request's abort signal (aborts if the daemon round-trip
+     * is torn down mid-call). */
+    signal: AbortSignal;
+}
 /**
  * The row title of a plugin tool call while it is pending and once it
  * settled. Each label is capped at 80 characters and rendered as plain text.
@@ -1421,6 +1493,52 @@ interface ExperimentalPluginProviderEnvEntry {
     reason: string;
 }
 type PluginMentionTrigger = "!" | "#" | "$" | "@" | "~";
+/** Search context handed to a mention provider (design §4.9). `projectId`/
+ * `threadId` are null when the composer has not committed one yet. */
+interface PluginMentionSearchContext {
+    trigger: PluginMentionTrigger;
+    query: string;
+    projectId: string | null;
+    threadId: string | null;
+}
+/** One row a mention provider returns from `search`. `id` is the provider's
+ * own item id — the host namespaces it before it reaches the wire. */
+interface PluginMentionItem {
+    id: string;
+    title: string;
+    subtitle?: string;
+    icon?: string;
+}
+interface PluginMentionProviderRegistration {
+    /** Unique within this plugin: [a-zA-Z0-9_-]+ (no ":" — the host composes
+     * wire item ids as "<providerId>:<itemId>"). */
+    id: string;
+    /** Section label shown above this provider's rows in the mention menu. */
+    label: string;
+    /**
+     * Composer trigger characters this provider should answer. Omit to use the
+     * default `@` mention trigger. Valid triggers are `@`, `#`, `$`, `!`, and `~`.
+     */
+    triggers?: readonly PluginMentionTrigger[];
+    /**
+     * Runs server-side as the user types after one of this provider's triggers
+     * in the composer. Each call is time-boxed (2s) and failure-isolated: a slow
+     * or throwing provider contributes an empty list — it can never break the
+     * mention menu.
+     */
+    search(ctx: PluginMentionSearchContext): PluginMentionItem[] | Promise<PluginMentionItem[]>;
+    /**
+     * Resolves one picked item into agent context, called once per unique
+     * item at message send time. The returned `context` is attached to the
+     * message as an agent-visible (user-hidden) prompt input. Throwing blocks
+     * the send with a visible error.
+     */
+    resolve(itemId: string): {
+        context: string;
+    } | Promise<{
+        context: string;
+    }>;
+}
 /**
  * What a plugin's AI service does. `inference` answers bb's server-side helper
  * completions (thread titles, commit messages: a prompt and a JSON Schema in,
@@ -1453,21 +1571,11 @@ declare function pluginCliCollisionWarning(pluginId: string, commandName: string
 declare const RESERVED_AGENT_TOOL_NAMES: readonly string[];
 /** JSON values ≤256KB; larger writes are rejected with a clear error. */
 declare const KV_VALUE_MAX_BYTES: number;
-declare const PLUGIN_HTTP_METHODS: ReadonlySet<string>;
-declare const RPC_METHOD_PATTERN: RegExp;
-declare const BACKGROUND_NAME_PATTERN: RegExp;
-declare const CLI_COMMAND_NAME_PATTERN: RegExp;
-declare const AGENT_TOOL_NAME_PATTERN: RegExp;
 declare const PLUGIN_PROVIDER_ENV_NAME_PATTERN: RegExp;
 declare const PLUGIN_PROVIDER_ENV_MAX_ENTRIES = 32;
 declare function validatePluginProviderEnvEntries(value: unknown): ExperimentalPluginProviderEnvEntry[];
-declare const PLUGIN_AGENT_STATIC_INSTRUCTIONS_MAX_CHARS = 4096;
 /** Status labels ride on every tool-call event and share one timeline row. */
 declare const PLUGIN_AGENT_STATUS_LABEL_MAX_CHARS = 80;
-declare const PLUGIN_AGENT_SELECTION_MAX_IDS = 256;
-declare const PLUGIN_AGENT_DYNAMIC_INSTRUCTIONS_MAX_CHARS = 4096;
-declare const PLUGIN_AGENT_TOOL_PARAMETERS_MAX_BYTES: number;
-declare const MENTION_PROVIDER_ID_PATTERN: RegExp;
 declare const PROVIDER_ID_PATTERN: RegExp;
 declare const PLUGIN_PROVIDER_BRIDGE_OPTIONS_MAX_BYTES: number;
 declare const SETTING_KEY_PATTERN: RegExp;
@@ -1479,9 +1587,9 @@ declare const SETTING_KEY_PATTERN: RegExp;
 declare function registerSettingDescriptors(target: PluginSettingDescriptors, added: Record<string, unknown>): PluginSettingDescriptors;
 /** Validate a settings update. `null` means unset. */
 declare function validateSettingsUpdate(descriptors: PluginSettingDescriptors, values: Record<string, unknown>): string[];
+declare function coerceStoredPluginSettingValue(descriptor: PluginSettingDescriptor, value: unknown): PluginSettingValue | undefined;
 declare const PLUGIN_MENTION_TRIGGER_VALUES: readonly ["@", "#", "$", "!", "~"];
 declare function isPluginMentionTrigger(value: unknown): value is PluginMentionTrigger;
-declare function normalizeMentionProviderTriggers(providerId: string, triggers: unknown): readonly PluginMentionTrigger[];
 declare const PLUGIN_PROVIDER_DISPLAY_NAME_MAX_CHARS = 80;
 declare const PLUGIN_PROVIDER_PERMISSION_MODE_VALUES: readonly ["accept-edits", "auto", "full"];
 declare const PLUGIN_PROVIDER_REASONING_LEVEL_VALUES: readonly ["none", "low", "medium", "high", "xhigh", "ultracode", "max", "ultra"];
@@ -1583,30 +1691,6 @@ declare function deriveValidatedProviderOptions(args: {
     context: Parameters<NonNullable<PluginProviderDeclaration["deriveProviderOptions"]>>[0];
 }): Readonly<Record<string, JsonValue>>;
 declare function isStandardSchema(value: unknown): value is StandardSchemaV1;
-declare function readRpcMethodContract(method: string, value: unknown): PluginRpcMethodContract;
-/** Duck-typed zod detection: plugin sources may carry their own zod copy,
- * so instanceof is useless — anything with safeParse is treated as zod. */
-type ZodSchemaLike = {
-    safeParse: z.ZodType["safeParse"];
-    toJSONSchema?: z.ZodType["toJSONSchema"];
-};
-declare function isZodSchemaLike(value: unknown): value is ZodSchemaLike;
-declare function zodSchemaToJsonSchema(schema: ZodSchemaLike): unknown;
-/**
- * Reject recursive local references before a tool schema reaches a provider.
- * Some providers reject the complete tool list when any one schema contains a
- * recursive `$ref`, so this is a shared production/fake-host boundary rule.
- */
-declare function assertNoRecursiveJsonSchemaReferences(schema: unknown, subject: string): void;
-/**
- * Reject the fields a registration never reads. Renamed fields get the
- * message above; any other `experimental_` field is unknown (the same
- * rule configure() output follows in the plugin service). The production
- * host and the fake host both call this before parsing `presentation`, so
- * a registration built against an older SDK fails a plugin's own unit test
- * with the message bb would give it.
- */
-declare function rejectStaleAgentToolFields(toolName: string, tool: object): void;
 /**
  * The declared shape of `presentation`, copied field by field so
  * a plugin's object cannot smuggle prototypes or extra markup into the
@@ -1618,7 +1702,6 @@ declare function rejectStaleAgentToolFields(toolName: string, tool: object): voi
 declare function parsePluginAgentToolPresentation(toolName: string, value: unknown): PluginAgentToolPresentation | null;
 /** Compact issue summary from a (possibly foreign-instance) zod error. */
 declare function summarizeStandardIssues(issues: readonly StandardSchemaV1Issue[]): string;
-declare function summarizeParseIssues(error: unknown): string;
 declare function enforcePluginCliOutputLimit(result: Omit<PluginCliExecutionResult, "error">, jsonOutput: boolean): PluginCliExecutionResult;
 /**
  * Adopt the value a plugin HTTP route handler returned.
@@ -1650,8 +1733,6 @@ declare function adoptHttpRouteResponse(value: unknown): Response;
 declare function undeclaredIconProblem(pluginId: string, declaredIconNames: ReadonlySet<string>, glyph: string): string | null;
 /** `bb.providers.register` refusal for an icon {@link undeclaredIconProblem} rejects. */
 declare function providerIconRefusalMessage(providerId: string, problem: string): string;
-/** `bb.agents.registerTool` refusal for a glyph {@link undeclaredIconProblem} rejects. */
-declare function agentToolIconRefusalMessage(toolName: string, problem: string): string;
 /**
  * `bb.providers.register` refusal for a plugin whose manifest declares no
  * `bb.host` entry: a declaration is metadata, and the bridge it runs on is
@@ -1726,6 +1807,111 @@ interface NormalizedPluginMachineProvider {
 }
 declare function validatePluginMachineProviderDeclaration(declaration: PluginMachineProviderDeclaration): NormalizedPluginMachineProvider;
 declare function validateServerAccessProviderDeclaration(declaration: ServerAccessProviderDeclaration): ServerAccessProviderDeclaration;
+declare function runPluginStorageMigrations(database: Database.Database, statements: string[]): void;
+declare function normalizeHttpRouteRegistration(method: string, path: string, handler: unknown, opts: {
+    auth?: PluginHttpAuthMode;
+} | undefined, existingRoutes: readonly {
+    method: string;
+    path: string;
+}[]): {
+    method: string;
+    path: string;
+    auth: PluginHttpAuthMode;
+};
+declare function normalizeWebSocketRouteRegistration(path: string, handler: unknown, opts: {
+    auth?: PluginHttpAuthMode;
+} | undefined, existingRoutes: readonly {
+    path: string;
+}[]): {
+    path: string;
+    auth: PluginHttpAuthMode;
+};
+type RpcRegistrationRecord = {
+    inputSchema: StandardSchemaV1;
+    outputSchema: StandardSchemaV1;
+    handler: (input: unknown) => unknown;
+};
+declare function normalizeRpcRegistration(contract: unknown, handlers: unknown, registered: ReadonlyMap<string, unknown>): Array<[string, RpcRegistrationRecord]>;
+declare function normalizeRealtimePayload(channel: string, payload: unknown): unknown;
+declare function validateBackgroundServiceRegistration(name: string, service: {
+    start(signal: AbortSignal): void | Promise<void>;
+}, existing: readonly {
+    name: string;
+}[]): {
+    name: string;
+    start: (signal: AbortSignal) => void | Promise<void>;
+};
+declare function validateScheduleRegistration(name: string, cron: string, fn: () => void | Promise<void>, existing: readonly {
+    name: string;
+}[], parseCron: (cron: string) => void): {
+    name: string;
+    cron: string;
+    fn: () => void | Promise<void>;
+};
+declare function normalizeCliRegistration(registration: PluginCliRegistration, alreadyRegistered: boolean): {
+    name: string;
+    summary: string;
+    commands: PluginCliCommandInfo[];
+    run: PluginCliRegistration["run"];
+};
+type AgentToolExecute = (params: unknown, ctx: PluginAgentToolContext) => PluginAgentToolResult | Promise<PluginAgentToolResult>;
+type AgentToolParse = (input: unknown) => {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    error: string;
+};
+declare function normalizeAgentToolRegistration(args: {
+    pluginId: string;
+    declaredIconNames: ReadonlySet<string>;
+    tool: {
+        name: string;
+        description: string;
+        instructions?: string;
+        presentation?: PluginAgentToolPresentation;
+        parameters: unknown;
+        execute(params: never, ctx: PluginAgentToolContext): PluginAgentToolResult | Promise<PluginAgentToolResult>;
+    };
+}): {
+    name: string;
+    description: string;
+    presentation: PluginAgentToolPresentation | null;
+    instructions: string | null;
+    inputSchema: unknown;
+    parse: AgentToolParse;
+    execute: AgentToolExecute;
+};
+declare function normalizeMentionProviderRegistration(provider: PluginMentionProviderRegistration, existing: readonly {
+    id: string;
+}[]): {
+    id: string;
+    label: string;
+    triggers: readonly PluginMentionTrigger[];
+    search: PluginMentionProviderRegistration["search"];
+    resolve: PluginMentionProviderRegistration["resolve"];
+};
+declare function normalizeInteractionRequest(request: PluginInteractionRequest): {
+    threadId: string;
+    rendererId: string;
+    title: string;
+    payload: JsonValue;
+    timeoutMs: number;
+};
+declare function validateProviderEnvContribution(label: "provider environment contribution" | "provider environment health contribution", providerId: string, resolve: unknown, registered: ReadonlyMap<string, unknown>): void;
+declare function normalizePluginAgentConfiguration(args: {
+    knownSkillIds: ReadonlySet<string>;
+    knownToolIds: ReadonlySet<string>;
+    pluginId: string;
+    value: unknown;
+}): {
+    toolIds: string[];
+    toolParameterOverrides: Map<string, Record<string, unknown>>;
+    skillIds: string[];
+    instructions: string | null;
+};
+declare function validateRpcValue(schema: StandardSchemaV1, value: unknown, phase: "input" | "output", fail: (error: PluginRpcError) => never): Promise<unknown>;
+declare function normalizeRpcJsonResult(value: unknown, fail: (error: PluginRpcError) => never): JsonValue;
 
-export { AGENT_TOOL_NAME_PATTERN, BACKGROUND_NAME_PATTERN, CLI_COMMAND_NAME_PATTERN, ENVIRONMENT_PROVIDER_DESCRIPTION_MAX_CHARS, ENVIRONMENT_PROVIDER_DISPLAY_NAME_MAX_CHARS, ENVIRONMENT_PROVIDER_ID_PATTERN, ENVIRONMENT_PROVIDER_REQUIREMENT_NAMES, KV_VALUE_MAX_BYTES, MACHINE_PROVIDER_DESCRIPTION_MAX_CHARS, MENTION_PROVIDER_ID_PATTERN, PLUGIN_AGENT_DYNAMIC_INSTRUCTIONS_MAX_CHARS, PLUGIN_AGENT_SELECTION_MAX_IDS, PLUGIN_AGENT_STATIC_INSTRUCTIONS_MAX_CHARS, PLUGIN_AGENT_STATUS_LABEL_MAX_CHARS, PLUGIN_AGENT_TOOL_PARAMETERS_MAX_BYTES, PLUGIN_HTTP_METHODS, PLUGIN_MENTION_TRIGGER_VALUES, 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, RESERVED_AGENT_TOOL_NAMES, RESERVED_BB_CLI_COMMANDS, RPC_METHOD_PATTERN, SERVER_DIRECT_AI_SERVICE_IDS, SETTING_KEY_PATTERN, adoptHttpRouteResponse, agentToolIconRefusalMessage, aiServiceAlreadyRegisteredMessage, assertAiServiceRegistrable, assertNoRecursiveJsonSchemaReferences, deriveValidatedProviderOptions, enforcePluginCliOutputLimit, environmentCompositionSchema, isPluginMentionTrigger, isStandardSchema, isZodSchemaLike, normalizeMentionProviderTriggers, parsePluginAgentToolPresentation, pluginCliCollisionWarning, pluginHookAlreadyRegisteredMessage, providerAlreadyRegisteredMessage, providerIconRefusalMessage, providerWithoutBridgeMessage, readRpcMethodContract, registerSettingDescriptors, rejectStaleAgentToolFields, storePluginHook, summarizeParseIssues, summarizeStandardIssues, undeclaredIconProblem, validatePluginAiServiceDeclaration, validatePluginEnvironmentProviderDeclaration, validatePluginMachineProviderDeclaration, validatePluginProviderDeclaration, validatePluginProviderEnvEntries, validateServerAccessProviderDeclaration, validateSettingsUpdate, zodSchemaToJsonSchema };
+export { ENVIRONMENT_PROVIDER_DESCRIPTION_MAX_CHARS, ENVIRONMENT_PROVIDER_DISPLAY_NAME_MAX_CHARS, ENVIRONMENT_PROVIDER_ID_PATTERN, ENVIRONMENT_PROVIDER_REQUIREMENT_NAMES, KV_VALUE_MAX_BYTES, MACHINE_PROVIDER_DESCRIPTION_MAX_CHARS, PLUGIN_AGENT_STATUS_LABEL_MAX_CHARS, PLUGIN_MENTION_TRIGGER_VALUES, 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, RESERVED_AGENT_TOOL_NAMES, RESERVED_BB_CLI_COMMANDS, SERVER_DIRECT_AI_SERVICE_IDS, SETTING_KEY_PATTERN, adoptHttpRouteResponse, aiServiceAlreadyRegisteredMessage, assertAiServiceRegistrable, coerceStoredPluginSettingValue, deriveValidatedProviderOptions, enforcePluginCliOutputLimit, environmentCompositionSchema, isPluginMentionTrigger, isStandardSchema, normalizeAgentToolRegistration, normalizeCliRegistration, normalizeHttpRouteRegistration, normalizeInteractionRequest, normalizeMentionProviderRegistration, normalizePluginAgentConfiguration, normalizeRealtimePayload, normalizeRpcJsonResult, normalizeRpcRegistration, normalizeWebSocketRouteRegistration, parsePluginAgentToolPresentation, pluginCliCollisionWarning, pluginHookAlreadyRegisteredMessage, providerAlreadyRegisteredMessage, providerIconRefusalMessage, providerWithoutBridgeMessage, registerSettingDescriptors, runPluginStorageMigrations, storePluginHook, summarizeStandardIssues, undeclaredIconProblem, validateBackgroundServiceRegistration, validatePluginAiServiceDeclaration, validatePluginEnvironmentProviderDeclaration, validatePluginMachineProviderDeclaration, validatePluginProviderDeclaration, validatePluginProviderEnvEntries, validateProviderEnvContribution, validateRpcValue, validateScheduleRegistration, validateServerAccessProviderDeclaration, validateSettingsUpdate };
 export type { AiServiceHostBinding, NormalizedPluginEnvironmentComposition, NormalizedPluginEnvironmentProvider, NormalizedPluginEnvironmentProviderRequirements, NormalizedPluginMachineProvider, NormalizedPluginProviderDeclaration };

package/bundled-types/bb-plugin-sdk-provider-bridge-testing.d.ts

@@ -3152,6 +3152,32 @@ declare const threadEventSchema: z.ZodPipe<z.ZodUnknown, z.ZodUnion<readonly [z.
     contextWindowUsage: z.ZodObject<{
         estimated: z.ZodBoolean;
         modelContextWindow: z.ZodNullable<z.ZodNumber>;
+        snapshot: z.ZodOptional<z.ZodObject<{
+            autoCompactAtTokens: z.ZodNullable<z.ZodNumber>;
+            capturedAt: z.ZodISODateTime;
+            categories: z.ZodArray<z.ZodObject<{
+                entries: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    label: z.ZodString;
+                    tokens: z.ZodNumber;
+                }, z.core.$strip>>;
+                id: z.ZodString;
+                kind: z.ZodEnum<{
+                    deferred: "deferred";
+                    free: "free";
+                    reserved: "reserved";
+                    used: "used";
+                }>;
+                label: z.ZodString;
+                tokens: z.ZodNumber;
+            }, z.core.$strip>>;
+            contextWindowTokens: z.ZodNumber;
+            estimated: z.ZodBoolean;
+            model: z.ZodString;
+            providerSessionId: z.ZodString;
+            providerTurnId: z.ZodNullable<z.ZodString>;
+            usedTokens: z.ZodNumber;
+        }, z.core.$strip>>;
         usedTokens: z.ZodNullable<z.ZodNumber>;
     }, z.core.$strip>;
     providerThreadId: z.ZodString;
@@ -4730,6 +4756,32 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"contextWindow">;
     providerTurnId: z.ZodOptional<z.ZodString>;
     size: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    snapshot: z.ZodOptional<z.ZodObject<{
+        autoCompactAtTokens: z.ZodNullable<z.ZodNumber>;
+        capturedAt: z.ZodISODateTime;
+        categories: z.ZodArray<z.ZodObject<{
+            entries: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                tokens: z.ZodNumber;
+            }, z.core.$strip>>;
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                deferred: "deferred";
+                free: "free";
+                reserved: "reserved";
+                used: "used";
+            }>;
+            label: z.ZodString;
+            tokens: z.ZodNumber;
+        }, z.core.$strip>>;
+        contextWindowTokens: z.ZodNumber;
+        estimated: z.ZodBoolean;
+        model: z.ZodString;
+        providerSessionId: z.ZodString;
+        providerTurnId: z.ZodNullable<z.ZodString>;
+        usedTokens: z.ZodNumber;
+    }, z.core.$strip>>;
     used: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"context.compacted">;