@get-bb/plugin-sdk 0.4.88 → 0.4.94

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

@@ -55,6 +55,7 @@ declare const appSettingsSchema: z$1.ZodObject<{
     showKeyboardHints: z$1.ZodBoolean;
     steerActiveThreadOnEnter: z$1.ZodBoolean;
     streamerMode: z$1.ZodBoolean;
+    telemetryEnabled: z$1.ZodBoolean;
 }, z$1.core.$strict>;
 type AppSettings = z$1.infer<typeof appSettingsSchema>;
 declare const appSettingsUpdateSchema: z$1.ZodUnion<readonly [z$1.ZodObject<{
@@ -69,6 +70,7 @@ declare const appSettingsUpdateSchema: z$1.ZodUnion<readonly [z$1.ZodObject<{
     showUnhandledProviderEvents: z$1.ZodOptional<z$1.ZodBoolean>;
     steerActiveThreadOnEnter: z$1.ZodBoolean;
     streamerMode: z$1.ZodBoolean;
+    telemetryEnabled: z$1.ZodOptional<z$1.ZodBoolean>;
 }, z$1.core.$strict>, z$1.ZodObject<{
     defaultMachineAccess: z$1.ZodNullable<z$1.ZodString>;
     defaultProviderId: z$1.ZodNullable<z$1.ZodString>;
@@ -80,6 +82,7 @@ declare const appSettingsUpdateSchema: z$1.ZodUnion<readonly [z$1.ZodObject<{
     showUnhandledProviderEvents: z$1.ZodBoolean;
     steerActiveThreadOnEnter: z$1.ZodBoolean;
     streamerMode: z$1.ZodBoolean;
+    telemetryEnabled: z$1.ZodOptional<z$1.ZodBoolean>;
 }, z$1.core.$strict>]>;
 type AppSettingsUpdate = z$1.infer<typeof appSettingsUpdateSchema>;
 
@@ -136,7 +139,7 @@ type UiPreferenceEntries = {
 };
 
 declare const appKeybindingOverridesSchema: z$1.ZodArray<z$1.ZodObject<{
-    command: z$1.ZodEnum<{
+    command: z$1.ZodUnion<readonly [z$1.ZodEnum<{
         "app.back": "app.back";
         "browser.find": "browser.find";
         "browser.focusLocation": "browser.focusLocation";
@@ -200,7 +203,7 @@ declare const appKeybindingOverridesSchema: z$1.ZodArray<z$1.ZodObject<{
         "thread.search": "thread.search";
         "window.new": "window.new";
         "workspace.openPreferred": "workspace.openPreferred";
-    }>;
+    }>, z$1.ZodTemplateLiteral<`plugin:${string}/${string}`>]>;
     shortcut: z$1.ZodNullable<z$1.ZodObject<{
         alt: z$1.ZodBoolean;
         control: z$1.ZodBoolean;
@@ -446,6 +449,7 @@ type Environment = z$1.infer<typeof environmentSchema>;
 declare const experimentsSchema: z$1.ZodRecord<z$1.ZodEnum<{
     changelogPreview: "changelogPreview";
     mobileApp: "mobileApp";
+    multiMachinePicker: "multiMachinePicker";
     sidebarProgressiveDisclosure: "sidebarProgressiveDisclosure";
     timelineWindowing: "timelineWindowing";
 }>, z$1.ZodBoolean>;
@@ -2549,6 +2553,8 @@ declare const threadEventSchema: z$1.ZodPipe<z$1.ZodUnknown, z$1.ZodUnion<readon
     threadId: z$1.ZodString;
     tokenUsage: z$1.ZodObject<{
         last: z$1.ZodObject<{
+            cacheReadInputTokens: z$1.ZodOptional<z$1.ZodNumber>;
+            cacheWriteInputTokens: z$1.ZodOptional<z$1.ZodNumber>;
             cachedInputTokens: z$1.ZodNumber;
             inputTokens: z$1.ZodNumber;
             outputTokens: z$1.ZodNumber;
@@ -2557,6 +2563,8 @@ declare const threadEventSchema: z$1.ZodPipe<z$1.ZodUnknown, z$1.ZodUnion<readon
         }, z$1.core.$strip>;
         modelContextWindow: z$1.ZodNullable<z$1.ZodNumber>;
         total: z$1.ZodObject<{
+            cacheReadInputTokens: z$1.ZodOptional<z$1.ZodNumber>;
+            cacheWriteInputTokens: z$1.ZodOptional<z$1.ZodNumber>;
             cachedInputTokens: z$1.ZodNumber;
             inputTokens: z$1.ZodNumber;
             outputTokens: z$1.ZodNumber;
@@ -4204,6 +4212,8 @@ declare const threadQueuedMessageSchema: z$1.ZodObject<{
         kind: z$1.ZodLiteral<"time">;
     }, z$1.core.$strip>, z$1.ZodObject<{
         kind: z$1.ZodLiteral<"thread-busy">;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+        kind: z$1.ZodLiteral<"stopping">;
     }, z$1.core.$strip>, z$1.ZodObject<{
         kind: z$1.ZodLiteral<"turn-starting">;
     }, z$1.core.$strip>, z$1.ZodObject<{
@@ -6690,6 +6700,13 @@ declare const hostDaemonCommandRegistry: {
     }, z$1.core.$strict>, z$1.ZodObject<{
         providerCheckpointId: z$1.ZodNullable<z$1.ZodString>;
     }, z$1.core.$strict>, "settled", false>;
+    "thread.storage.delete": HostDaemonCommandDescriptor<"thread.storage.delete", z$1.ZodObject<{
+        environmentId: z$1.ZodString;
+        threadId: z$1.ZodString;
+        type: z$1.ZodLiteral<"thread.storage.delete">;
+    }, z$1.core.$strict>, z$1.ZodObject<{
+        providerCheckpointId: z$1.ZodNullable<z$1.ZodString>;
+    }, z$1.core.$strict>, "settled", false>;
     "thread.goal.clear": HostDaemonCommandDescriptor<"thread.goal.clear", z$1.ZodObject<{
         bridgeLaunch: z$1.ZodObject<{
             capabilities: z$1.ZodObject<{
@@ -9369,6 +9386,21 @@ declare const pluginMarketplaceRefreshResultSchema: z$1.ZodObject<{
     ok: z$1.ZodBoolean;
 }, z$1.core.$strip>;
 type PluginMarketplaceRefreshResult$1 = z$1.infer<typeof pluginMarketplaceRefreshResultSchema>;
+declare const pluginRpcDiscoveryQuerySchema: z$1.ZodObject<{
+    method: z$1.ZodOptional<z$1.ZodString>;
+    pluginId: z$1.ZodOptional<z$1.ZodString>;
+}, z$1.core.$strip>;
+type PluginRpcDiscoveryQuery = z$1.infer<typeof pluginRpcDiscoveryQuerySchema>;
+declare const publishedPluginRpcMethodSchema: z$1.ZodObject<{
+    displayName: z$1.ZodString;
+    inputSchema: z$1.ZodRecord<z$1.ZodString, z$1.ZodType<JsonValue$1, unknown, z$1.core.$ZodTypeInternals<JsonValue$1, unknown>>>;
+    method: z$1.ZodString;
+    methodDescription: z$1.ZodNullable<z$1.ZodString>;
+    outputSchema: z$1.ZodRecord<z$1.ZodString, z$1.ZodType<JsonValue$1, unknown, z$1.core.$ZodTypeInternals<JsonValue$1, unknown>>>;
+    pluginId: z$1.ZodString;
+    registrationDescription: z$1.ZodNullable<z$1.ZodString>;
+}, z$1.core.$strip>;
+type PublishedPluginRpcMethod = z$1.infer<typeof publishedPluginRpcMethodSchema>;
 
 declare const machineEnvironmentReplaceSchema: z$1.ZodObject<{
     variables: z$1.ZodArray<z$1.ZodObject<{
@@ -9624,7 +9656,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
     customThemes: z$1.ZodArray<z$1.ZodString>;
     dataDir: z$1.ZodString;
     defaultKeybindings: z$1.ZodArray<z$1.ZodObject<{
-        command: z$1.ZodEnum<{
+        command: z$1.ZodUnion<readonly [z$1.ZodEnum<{
             "app.back": "app.back";
             "browser.find": "browser.find";
             "browser.focusLocation": "browser.focusLocation";
@@ -9688,7 +9720,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "thread.search": "thread.search";
             "window.new": "window.new";
             "workspace.openPreferred": "workspace.openPreferred";
-        }>;
+        }>, z$1.ZodTemplateLiteral<`plugin:${string}/${string}`>]>;
         desktopOnly: z$1.ZodBoolean;
         shortcut: z$1.ZodNullable<z$1.ZodObject<{
             alt: z$1.ZodBoolean;
@@ -9730,6 +9762,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
     experiments: z$1.ZodRecord<z$1.ZodEnum<{
         changelogPreview: "changelogPreview";
         mobileApp: "mobileApp";
+        multiMachinePicker: "multiMachinePicker";
         sidebarProgressiveDisclosure: "sidebarProgressiveDisclosure";
         timelineWindowing: "timelineWindowing";
     }>, z$1.ZodBoolean>;
@@ -9749,10 +9782,11 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
         showUnhandledProviderEvents: z$1.ZodOptional<z$1.ZodBoolean>;
         steerActiveThreadOnEnter: z$1.ZodBoolean;
         streamerMode: z$1.ZodBoolean;
+        telemetryEnabled: z$1.ZodBoolean;
     }, z$1.core.$strict>;
     hostDaemonPort: z$1.ZodNullable<z$1.ZodNumber>;
     keybindingOverrides: z$1.ZodArray<z$1.ZodObject<{
-        command: z$1.ZodEnum<{
+        command: z$1.ZodUnion<readonly [z$1.ZodEnum<{
             "app.back": "app.back";
             "browser.find": "browser.find";
             "browser.focusLocation": "browser.focusLocation";
@@ -9816,7 +9850,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "thread.search": "thread.search";
             "window.new": "window.new";
             "workspace.openPreferred": "workspace.openPreferred";
-        }>;
+        }>, z$1.ZodTemplateLiteral<`plugin:${string}/${string}`>]>;
         shortcut: z$1.ZodNullable<z$1.ZodObject<{
             alt: z$1.ZodBoolean;
             control: z$1.ZodBoolean;
@@ -9827,7 +9861,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
         }, z$1.core.$strict>>;
     }, z$1.core.$strict>>;
     keybindings: z$1.ZodArray<z$1.ZodObject<{
-        command: z$1.ZodEnum<{
+        command: z$1.ZodUnion<readonly [z$1.ZodEnum<{
             "app.back": "app.back";
             "browser.find": "browser.find";
             "browser.focusLocation": "browser.focusLocation";
@@ -9891,7 +9925,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "thread.search": "thread.search";
             "window.new": "window.new";
             "workspace.openPreferred": "workspace.openPreferred";
-        }>;
+        }>, z$1.ZodTemplateLiteral<`plugin:${string}/${string}`>]>;
         desktopOnly: z$1.ZodBoolean;
         shortcut: z$1.ZodObject<{
             alt: z$1.ZodBoolean;
@@ -11492,6 +11526,10 @@ declare const createThreadRequestSchema: z$1.ZodObject<{
         full: "full";
     }>, z$1.ZodLiteral<"workspace-write">]>, z$1.ZodTransform<"accept-edits" | "auto" | "full", "accept-edits" | "auto" | "full" | "workspace-write">>>;
     pluginMetadata: z$1.ZodOptional<z$1.ZodType<JsonObject, unknown, z$1.core.$ZodTypeInternals<JsonObject, unknown>>>;
+    pluginSubmission: z$1.ZodOptional<z$1.ZodObject<{
+        data: z$1.ZodType<JsonValue$1, unknown, z$1.core.$ZodTypeInternals<JsonValue$1, unknown>>;
+        pluginId: z$1.ZodString;
+    }, z$1.core.$strip>>;
     projectId: z$1.ZodString;
     providerId: z$1.ZodOptional<z$1.ZodString>;
     reasoningLevel: z$1.ZodOptional<z$1.ZodEnum<{
@@ -11868,6 +11906,10 @@ declare const sendMessageRequestSchema: z$1.ZodObject<{
         auto: "auto";
         full: "full";
     }>, z$1.ZodLiteral<"workspace-write">]>, z$1.ZodTransform<"accept-edits" | "auto" | "full", "accept-edits" | "auto" | "full" | "workspace-write">>>;
+    pluginSubmission: z$1.ZodOptional<z$1.ZodObject<{
+        data: z$1.ZodType<JsonValue$1, unknown, z$1.core.$ZodTypeInternals<JsonValue$1, unknown>>;
+        pluginId: z$1.ZodString;
+    }, z$1.core.$strip>>;
     reasoningLevel: z$1.ZodOptional<z$1.ZodEnum<{
         high: "high";
         low: "low";
@@ -12025,6 +12067,8 @@ declare const sendMessageResponseSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObjec
             kind: z$1.ZodLiteral<"time">;
         }, z$1.core.$strip>, z$1.ZodObject<{
             kind: z$1.ZodLiteral<"thread-busy">;
+        }, z$1.core.$strip>, z$1.ZodObject<{
+            kind: z$1.ZodLiteral<"stopping">;
         }, z$1.core.$strip>, z$1.ZodObject<{
             kind: z$1.ZodLiteral<"turn-starting">;
         }, z$1.core.$strip>, z$1.ZodObject<{
@@ -12196,6 +12240,8 @@ declare const retryTurnResponseSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<
         kind: z$1.ZodLiteral<"time">;
     }, z$1.core.$strip>, z$1.ZodObject<{
         kind: z$1.ZodLiteral<"thread-busy">;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+        kind: z$1.ZodLiteral<"stopping">;
     }, z$1.core.$strip>, z$1.ZodObject<{
         kind: z$1.ZodLiteral<"turn-starting">;
     }, z$1.core.$strip>, z$1.ZodObject<{
@@ -12572,6 +12618,8 @@ declare const sendQueuedMessageResponseSchema: z$1.ZodDiscriminatedUnion<[z$1.Zo
             kind: z$1.ZodLiteral<"time">;
         }, z$1.core.$strip>, z$1.ZodObject<{
             kind: z$1.ZodLiteral<"thread-busy">;
+        }, z$1.core.$strip>, z$1.ZodObject<{
+            kind: z$1.ZodLiteral<"stopping">;
         }, z$1.core.$strip>, z$1.ZodObject<{
             kind: z$1.ZodLiteral<"turn-starting">;
         }, z$1.core.$strip>, z$1.ZodObject<{
@@ -13458,6 +13506,8 @@ declare const threadQueuedMessageListResponseSchema: z$1.ZodArray<z$1.ZodObject<
         kind: z$1.ZodLiteral<"time">;
     }, z$1.core.$strip>, z$1.ZodObject<{
         kind: z$1.ZodLiteral<"thread-busy">;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+        kind: z$1.ZodLiteral<"stopping">;
     }, z$1.core.$strip>, z$1.ZodObject<{
         kind: z$1.ZodLiteral<"turn-starting">;
     }, z$1.core.$strip>, z$1.ZodObject<{
@@ -13966,6 +14016,7 @@ declare const threadTimelineResponseSchema: z$1.ZodObject<{
             anchorId: z$1.ZodString;
             anchorSeq: z$1.ZodNumber;
         }, z$1.core.$strict>>;
+        olderRowsSourceSeqEnd: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodNumber>>;
         returnedSegmentCount: z$1.ZodNumber;
         segmentLimit: z$1.ZodNumber;
     }, z$1.core.$strict>;
@@ -14457,6 +14508,14 @@ interface StandardSchemaV1<Input = unknown, Output = Input> {
         readonly version: 1;
         readonly vendor: string;
         readonly validate: (value: unknown) => StandardSchemaV1Result<Output> | Promise<StandardSchemaV1Result<Output>>;
+        readonly jsonSchema?: {
+            readonly input: (options: {
+                target: string;
+            }) => Record<string, unknown>;
+            readonly output: (options: {
+                target: string;
+            }) => Record<string, unknown>;
+        };
         readonly types?: {
             readonly input: Input;
             readonly output: Output;
@@ -14478,6 +14537,7 @@ interface StandardSchemaV1Issue {
 type StandardSchemaV1InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["input"];
 type StandardSchemaV1InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["output"];
 interface PluginRpcMethodContract<InputSchema extends StandardSchemaV1 = StandardSchemaV1, OutputSchema extends StandardSchemaV1 = StandardSchemaV1> {
+    readonly experimental_description?: string;
     readonly input: InputSchema;
     readonly output: OutputSchema;
 }
@@ -14683,6 +14743,16 @@ interface PluginThreadHeaderActionProps {
      */
     isCompactViewport: boolean;
 }
+interface ExperimentalPluginBrowserToolbarActionProps {
+    /** Thread that owns the Browser tab. */
+    threadId: string;
+    /** Browser tab currently rendering the action. */
+    tabId: string;
+    /** Current top-level URL shown in the address bar. */
+    url: string;
+    /** True when the Browser chrome needs compact controls. */
+    isCompactViewport: boolean;
+}
 /**
  * Where a file being opened by a `fileOpener` lives. `path` semantics follow
  * the source: workspace paths are relative to the environment's worktree,
@@ -15406,6 +15476,14 @@ interface PluginThreadHeaderActionRegistration {
     title: string;
     component: ComponentType<PluginThreadHeaderActionProps>;
 }
+interface ExperimentalPluginBrowserToolbarActionRegistration {
+    /** Unique within the plugin; letters, digits, `-`, `_`. */
+    id: string;
+    /** Accessible name for the host-wrapped control group. */
+    title: string;
+    /** Component rendered beside the Browser address bar. */
+    component: ComponentType<ExperimentalPluginBrowserToolbarActionProps>;
+}
 /** One pane's place in the split layout, as fractions of the split area. */
 interface PluginSidebarSplitPane {
     paneId: string;
@@ -15618,8 +15696,8 @@ interface PluginMessageActionRegistration {
      */
     run(context: PluginMessageActionContext): void | Promise<void>;
 }
-/** Context handed to a `commandPaletteAction`'s `isAvailable` and `run`. */
-interface PluginCommandPaletteActionContext {
+/** Current context for palette and keyboard command invocations. */
+interface PluginCommandContext {
     /** The thread in view, or null on a surface without one. */
     threadId: string | null;
     projectId: string | null;
@@ -15635,27 +15713,49 @@ interface PluginCommandPaletteActionContext {
      */
     openPanel(options: PluginTargetedPanelActionOpenOptions): boolean;
 }
+/** A default keyboard shortcut. Omitted modifiers are false. */
+interface PluginCommandShortcut {
+    key: string;
+    /** Command on macOS, Control elsewhere. */
+    mod?: boolean;
+    meta?: boolean;
+    control?: boolean;
+    alt?: boolean;
+    shift?: boolean;
+}
 /**
- * A row in bb's quick palette (Mod+Shift+P), listed under the plugin's name
+ * A command registered with `app.commands.register`, listed in bb's quick
+ * palette (Mod+Shift+P) under the plugin's name
  * beside bb's own commands. Host-rendered: the plugin supplies a title and
  * `run`, and the host owns matching, ordering, and recency.
  */
-interface PluginCommandPaletteActionRegistration {
+interface PluginCommandRegistration {
+    /** Initial keyboard binding. Users can rebind every command, including ones without a default. Conflicting defaults remain unbound. */
+    defaultShortcut?: PluginCommandShortcut;
     /** Unique within the plugin; letters, digits, `-`, `_`. */
     id: string;
     /** The row's label, e.g. "Linear: open issue for this thread". */
     title: string;
     /**
      * Hide the row when it cannot do anything — typically when it needs a thread
-     * and there is none. Called while the palette is open; keep it cheap and
-     * synchronous. Omitted means always listed.
+     * and there is none. Called before palette listing and keyboard invocation;
+     * keep it cheap and synchronous. Omitted means always listed.
      */
-    isAvailable?(context: PluginCommandPaletteActionContext): boolean;
+    isAvailable?(context: PluginCommandContext): boolean;
     /**
-     * Runs after the palette closes and focus is restored. Errors (sync or
-     * async) are contained and logged; they never break the palette.
+     * Runs on keyboard invocation, or after the palette closes and focus is
+     * restored. Errors (sync or async) are contained and logged; they never break the palette.
      */
-    run(context: PluginCommandPaletteActionContext): void | Promise<void>;
+    run(context: PluginCommandContext): void | Promise<void>;
+}
+/** @deprecated Use PluginCommandContext. */
+type PluginCommandPaletteActionContext = PluginCommandContext;
+/** @deprecated Use PluginCommandRegistration. */
+type PluginCommandPaletteActionRegistration = PluginCommandRegistration;
+/** Registers commands for bb's command palette. */
+interface PluginAppCommands {
+    /** Register a command. IDs are unique within this plugin, including legacy slot registrations. */
+    register(registration: PluginCommandRegistration): void;
 }
 /**
  * Supply an inline React mark for a provider. Agent, machine, and environment
@@ -15886,6 +15986,8 @@ interface PluginAppSlots {
      * docs/api_to_audit.md.
      */
     experimental_threadHeaderAction(registration: PluginThreadHeaderActionRegistration): void;
+    /** Render a component beside each Browser tab's address bar. */
+    experimental_browserToolbarAction(registration: ExperimentalPluginBrowserToolbarActionRegistration): void;
     fileOpener(registration: PluginFileOpenerRegistration): void;
     /**
      * Replace BB's source-code renderer (see
@@ -15902,10 +16004,10 @@ interface PluginAppSlots {
     messageDirective(registration: PluginMessageDirectiveRegistration): void;
     messageAction(registration: PluginMessageActionRegistration): void;
     /**
-     * Add a row to the quick palette (see
-     * {@link PluginCommandPaletteActionRegistration}).
+     * @deprecated Use `app.commands.register` with the same registration.
+     * Both entry points share the same command registry and ID namespace.
      */
-    commandPaletteAction(registration: PluginCommandPaletteActionRegistration): void;
+    commandPaletteAction(registration: PluginCommandRegistration): void;
     /**
      * Draw one agent, environment, or machine provider's icon with an inline
      * React component instead of its masked logo asset (see
@@ -16037,6 +16139,7 @@ interface ExperimentalAppIcons {
 }
 interface PluginAppBuilder {
     experimental_icons: ExperimentalAppIcons;
+    commands: PluginAppCommands;
     slots: PluginAppSlots;
     composer: PluginAppComposer;
     contentScripts: PluginAppContentScripts;
@@ -16243,7 +16346,7 @@ interface PluginComposerApi {
     focus(): void;
     /**
      * Submit this composer's draft through the composer's OWN submit pipeline,
-     * queued until `sendAt` instead of dispatched now.
+     * optionally scheduling it or attaching plugin-owned dispatch data.
      *
      * This is a real submission, not a plugin-issued send: the host builds the
      * request exactly as pressing Enter would, so the draft's attachments and
@@ -16253,12 +16356,11 @@ interface PluginComposerApi {
      * tuple itself, which is why sending from the backend instead would silently
      * run the message with different settings than the ones in front of the user.
      *
-     * In a thread composer the message is queued as a row instead of being
-     * sent or queued for the next idle moment. In the new-thread composer the
-     * thread is created `pending` and its first message becomes the queued row.
-     * Either way the resulting row is core's: the queued card above the
-     * composer, the countdown, Send now and Delete all work with no further
-     * plugin involvement.
+     * `sendAt` queues the submission until that time. `experimental_data` is
+     * opaque JSON delivered to dispatch hooks together with the calling plugin's
+     * id on this initial attempt. Hooks run before operational core waits. If a
+     * hook queues the message, its existing plugin wait identifies the owner on
+     * later attempts; core does not persist or interpret the opaque data.
      *
      * Resolves once the host has accepted the submission and cleared the draft.
      * Rejects when the composer refused to submit — a scope with no submit
@@ -16275,18 +16377,17 @@ interface PluginComposerApi {
 /**
  * What `experimental_submit` does differently from pressing Enter.
  *
- * There is deliberately no zero-argument overload and no "submit now" arm: a
- * plugin that wants a draft sent immediately is asking for the affordance the
- * user already has, and handing plugins an unconditional "send this draft"
- * button is a much larger surface than scheduling needs.
+ * `experimental_data` is opaque JSON delivered to dispatch hooks. The runtime
+ * associates it with the calling plugin automatically for the initial
+ * dispatch attempt.
  */
-interface ExperimentalComposerSubmitOptions {
-    /**
-     * Epoch ms the submission should dispatch at. Must be in the future; the
-     * host does not second-guess how far ahead it is.
-     */
+type ExperimentalComposerSubmitOptions = {
     sendAt: number;
-}
+    experimental_data?: JsonValue;
+} | {
+    experimental_data: JsonValue;
+    sendAt?: never;
+};
 /**
  * A consumer-supplied action on the messages of one `ThreadChat` instance,
  * rendered in the embedded timeline's per-message action bar alongside the
@@ -17653,6 +17754,7 @@ interface PluginCheckUpdatesArgs {
     signal?: AbortSignal;
 }
 interface PluginRpcArgs<TOutput> extends PluginIdArgs {
+    signal?: AbortSignal;
     input?: JsonValue$1;
     method: string;
     outputSchema: z$1.ZodType<TOutput>;
@@ -17710,6 +17812,7 @@ interface PluginMarketplacesArea {
     remove(args: PluginMarketplaceRemoveArgs): Promise<PluginMarketplaceRemoveResult>;
 }
 interface PluginsArea {
+    experimental_discoverRpc(args?: PluginRpcDiscoveryQuery): Promise<PublishedPluginRpcMethod[]>;
     applyUpdate(args: PluginIdArgs): Promise<PluginApplyUpdateResult>;
     callRpc<TOutput>(args: PluginRpcArgs<TOutput>): Promise<TOutput>;
     checkUpdates(args?: PluginCheckUpdatesArgs): Promise<PluginCheckUpdatesResult>;
@@ -18884,8 +18987,8 @@ interface PluginThreadEventPayloads {
     /**
      * Fired after a dispatch attempt is queued as a row — by a `message.dispatch`
      * hook's `wait` decision, by a `sendAt` in the future, or by a core wait (the
-     * thread is busy, its turn is still starting, provisioning, or awaiting an
-     * interaction).
+     * thread is busy, its turn is still starting, provisioning, stopping, or
+     * awaiting an interaction).
      *
      * Every listener sees every queued row, not just the ones it is holding: an
      * observer that only wants its own filters on
@@ -19191,6 +19294,16 @@ interface MessageDispatchHookContext {
      * double-count.
      */
     queuedMessage: ThreadQueuedMessage | null;
+    /**
+     * Opaque JSON supplied by a plugin through the composer's
+     * `experimental_submit`, paired with that plugin's id. Null for ordinary
+     * submissions and queued re-attempts. Core does not persist or interpret
+     * the data.
+     */
+    experimental_submission: {
+        pluginId: string;
+        data: JsonValue;
+    } | null;
     /** How the dispatch was requested; null for internal/core-driven sends. */
     origin: ThreadCreateOrigin | null;
     originPluginId: string | null;
@@ -19335,7 +19448,10 @@ interface PluginRpc {
      * serialization. The response is `{ ok: true, result }` or
      * `{ ok: false, error: { code, message, issues? } }`.
      */
-    register<Contract extends PluginRpcContract>(contract: Contract, handlers: PluginRpcHandlers<Contract>): void;
+    register<Contract extends PluginRpcContract>(contract: Contract, handlers: PluginRpcHandlers<Contract>, options?: {
+        experimental_discoverable?: boolean;
+        experimental_description?: string;
+    }): void;
 }
 interface PluginRealtime {
     /**
@@ -20068,6 +20184,16 @@ interface PluginMentionItem {
     subtitle?: string;
     icon?: string;
 }
+/** Agent-only image context resolved with a plugin mention. */
+type ExperimentalPluginMentionImage = {
+    type: "image";
+    url: string;
+    context?: string;
+} | {
+    type: "localImage";
+    path: string;
+    context?: string;
+};
 interface PluginMentionProviderRegistration {
     /** Unique within this plugin: [a-zA-Z0-9_-]+ (no ":" — the host composes
      * wire item ids as "<providerId>:<itemId>"). */
@@ -20094,8 +20220,10 @@ interface PluginMentionProviderRegistration {
      */
     resolve(itemId: string): {
         context: string;
+        experimental_images?: readonly ExperimentalPluginMentionImage[];
     } | Promise<{
         context: string;
+        experimental_images?: readonly ExperimentalPluginMentionImage[];
     }>;
 }
 interface PluginUi {
@@ -20320,4 +20448,4 @@ interface BbPluginApi {
 }
 
 export { PLUGIN_CLI_OUTPUT_MAX_BYTES, defineRpcContract, experimental_defineHostEntry };
-export type { BbContext, BbNavigate, BbPluginApi, BranchPickerProps, BranchesState, CheckoutState, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppIcons, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSubmitOptions, ExperimentalDesktopBrowserAcquireInput, ExperimentalDesktopBrowserCreateInput, ExperimentalDesktopBrowserLease, ExperimentalDesktopBrowserScope, ExperimentalDesktopBrowsersArea, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalHostCallOptions, ExperimentalHostClient, ExperimentalHostEntry, ExperimentalHostPaths, ExperimentalHostRpcContext, ExperimentalHostRpcHandlers, ExperimentalHostSignalContract, ExperimentalHostSignalEvent, ExperimentalHostSignals, ExperimentalHostWatchChange, ExperimentalHostWatchChangeType, ExperimentalHostWatchEvent, ExperimentalHostWatchListener, ExperimentalHostWatchOptions, ExperimentalHostWatchSubscription, ExperimentalHostWorkerLease, ExperimentalIconProps, ExperimentalIconRegistration, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginFixedTabReference, ExperimentalPluginProviderEnvContext, ExperimentalPluginProviderEnvEntry, ExperimentalPluginProviderEnvHealth, ExperimentalPluginProviderEnvHealthContext, ExperimentalPluginWebSocket, ExperimentalPluginWebSocketContext, ExperimentalPluginWebSocketHandler, ExperimentalPluginWebSocketHandlers, ExperimentalProviderIconProps, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalSidebarFooter, ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterActionRegistration, ExperimentalSidebarFooterDisclosureController, ExperimentalSidebarFooterDisclosureProps, ExperimentalSidebarFooterDisclosureRegistration, ExperimentalSidebarFooterItemBase, ExperimentalSidebarFooterItemRegistration, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, JsonValue, MachineBootstrapApi, MachineBootstrapRequest, MachineExecutor, MachineExecutorRequest, MarkdownProps, MessageDispatchHookContext, MessageDispatchHookDecision, NewThreadComposerProps, NewThreadRequest, PluginAgentConfiguration, PluginAgentConfigurationContext, PluginAgentToolContentPart, PluginAgentToolContext, PluginAgentToolLabels, PluginAgentToolPresentation, PluginAgentToolRegistrationBase, PluginAgentToolResult, PluginAgentToolSelection, PluginAgents, PluginAiServiceDeclaration, PluginAiServiceKind, PluginAiServices, PluginAppBuilder, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginBackground, PluginBbSdk, PluginCli, PluginCliCommandInfo, PluginCliContext, PluginCliExecutionResult, PluginCliOutputLimitError, PluginCliRegistration, PluginCliResult, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandPaletteActionContext, PluginCommandPaletteActionRegistration, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginDispatchAttemptKind, PluginDispatchEnvironmentIntent, PluginDispatchExecution, PluginDispatchExecutionSources, PluginDispatchInput, PluginEnvironmentProviderDeclaration, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, PluginEnvironmentProviderRequirements, PluginEnvironmentValidateDecision, PluginEnvironments, PluginEvents, PluginFileOpenerProps, PluginFileOpenerRegistration, PluginFileOpenerSource, PluginFixedTabDeclaration, PluginFixedTabRegistration, PluginHomepageSectionProps, PluginHomepageSectionRegistration, PluginHookHandler, PluginHookName, PluginHookSignatures, PluginHooks, PluginHosts, PluginHttp, PluginHttpAuthMode, PluginHttpHandler, PluginInteractionCancelReason, PluginInteractionRequest, PluginInteractionResult, PluginKvStorage, PluginLogger, PluginMachineProviderDeclaration, PluginMachineProviderInputsChange, PluginMachineProviderInputsProps, PluginMachineProviderInputsRegistration, PluginMachineValidateDecision, PluginMachines, PluginMentionItem, PluginMentionProviderRegistration, PluginMentionSearchContext, PluginMentionTrigger, PluginMessageActionContext, PluginMessageActionRegistration, PluginMessageDirectiveMessage, PluginMessageDirectiveOpenWorkspaceFile, PluginMessageDirectiveProps, PluginMessageDirectiveRegistration, PluginNavPanelProps, PluginNavPanelRegistration, PluginNewThreadPanelActionContext, PluginNewThreadPanelActionRegistration, PluginNewThreadPanelProps, PluginPanelActionOpenOptions, PluginPendingInteractionProps, PluginPendingInteractionRegistration, PluginPendingInteractionView, PluginProviderCapabilities, PluginProviderComposerAction, PluginProviderDeclaration, PluginProviderExtensionKindDeclaration, PluginProviderFallbackModel, PluginProviderIconRegistration, PluginProviderMaintenance, PluginProviderModelCatalogScope, PluginProviderNativeRootEntry, PluginProviderNativeRoots, PluginProviderOptionDescriptor, PluginProviderOptionsContext, PluginProviderPermissionMode, PluginProviderReasoningLevel, PluginProviderStrings, PluginProviders, PluginProvidersState, PluginRealtime, PluginRealtimeConnectionState, PluginRpc, PluginRpcCallArgs, PluginRpcClient, PluginRpcContract, PluginRpcError, PluginRpcErrorCode, PluginRpcHandlers, PluginRpcIssuePathSegment, PluginRpcMethodContract, PluginRpcResult, PluginRpcValidationIssue, PluginSdkApp, PluginServerAccess, PluginServerApi, PluginSettingDescriptor, PluginSettingDescriptors, PluginSettingValue, PluginSettings, PluginSettingsHandle, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsState, PluginSettingsValues, PluginSharedPortTunnelIdentity, PluginSidebarFooterActionContext, PluginSidebarFooterActionProps, PluginSidebarFooterActionRegistration, PluginSidebarProject, PluginSidebarPullRequest, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginStatusApi, PluginStorage, PluginTargetedPanelActionOpenOptions, PluginThreadEventHandler, PluginThreadEventName, PluginThreadEventPayloads, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, PluginTurnFailedEvent, PluginUi, ReadonlyJsonValue, ServerAccessGrant, ServerAccessProviderDeclaration, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps, UseBranchesArgs, UseCheckoutStateArgs };
+export type { BbContext, BbNavigate, BbPluginApi, BranchPickerProps, BranchesState, CheckoutState, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppIcons, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSubmitOptions, ExperimentalDesktopBrowserAcquireInput, ExperimentalDesktopBrowserCreateInput, ExperimentalDesktopBrowserLease, ExperimentalDesktopBrowserScope, ExperimentalDesktopBrowsersArea, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalHostCallOptions, ExperimentalHostClient, ExperimentalHostEntry, ExperimentalHostPaths, ExperimentalHostRpcContext, ExperimentalHostRpcHandlers, ExperimentalHostSignalContract, ExperimentalHostSignalEvent, ExperimentalHostSignals, ExperimentalHostWatchChange, ExperimentalHostWatchChangeType, ExperimentalHostWatchEvent, ExperimentalHostWatchListener, ExperimentalHostWatchOptions, ExperimentalHostWatchSubscription, ExperimentalHostWorkerLease, ExperimentalIconProps, ExperimentalIconRegistration, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginBrowserToolbarActionProps, ExperimentalPluginBrowserToolbarActionRegistration, ExperimentalPluginFixedTabReference, ExperimentalPluginMentionImage, ExperimentalPluginProviderEnvContext, ExperimentalPluginProviderEnvEntry, ExperimentalPluginProviderEnvHealth, ExperimentalPluginProviderEnvHealthContext, ExperimentalPluginWebSocket, ExperimentalPluginWebSocketContext, ExperimentalPluginWebSocketHandler, ExperimentalPluginWebSocketHandlers, ExperimentalProviderIconProps, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalSidebarFooter, ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterActionRegistration, ExperimentalSidebarFooterDisclosureController, ExperimentalSidebarFooterDisclosureProps, ExperimentalSidebarFooterDisclosureRegistration, ExperimentalSidebarFooterItemBase, ExperimentalSidebarFooterItemRegistration, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, JsonValue, MachineBootstrapApi, MachineBootstrapRequest, MachineExecutor, MachineExecutorRequest, MarkdownProps, MessageDispatchHookContext, MessageDispatchHookDecision, NewThreadComposerProps, NewThreadRequest, PluginAgentConfiguration, PluginAgentConfigurationContext, PluginAgentToolContentPart, PluginAgentToolContext, PluginAgentToolLabels, PluginAgentToolPresentation, PluginAgentToolRegistrationBase, PluginAgentToolResult, PluginAgentToolSelection, PluginAgents, PluginAiServiceDeclaration, PluginAiServiceKind, PluginAiServices, PluginAppBuilder, PluginAppCommands, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginBackground, PluginBbSdk, PluginCli, PluginCliCommandInfo, PluginCliContext, PluginCliExecutionResult, PluginCliOutputLimitError, PluginCliRegistration, PluginCliResult, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandContext, PluginCommandPaletteActionContext, PluginCommandPaletteActionRegistration, PluginCommandRegistration, PluginCommandShortcut, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginDispatchAttemptKind, PluginDispatchEnvironmentIntent, PluginDispatchExecution, PluginDispatchExecutionSources, PluginDispatchInput, PluginEnvironmentProviderDeclaration, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, PluginEnvironmentProviderRequirements, PluginEnvironmentValidateDecision, PluginEnvironments, PluginEvents, PluginFileOpenerProps, PluginFileOpenerRegistration, PluginFileOpenerSource, PluginFixedTabDeclaration, PluginFixedTabRegistration, PluginHomepageSectionProps, PluginHomepageSectionRegistration, PluginHookHandler, PluginHookName, PluginHookSignatures, PluginHooks, PluginHosts, PluginHttp, PluginHttpAuthMode, PluginHttpHandler, PluginInteractionCancelReason, PluginInteractionRequest, PluginInteractionResult, PluginKvStorage, PluginLogger, PluginMachineProviderDeclaration, PluginMachineProviderInputsChange, PluginMachineProviderInputsProps, PluginMachineProviderInputsRegistration, PluginMachineValidateDecision, PluginMachines, PluginMentionItem, PluginMentionProviderRegistration, PluginMentionSearchContext, PluginMentionTrigger, PluginMessageActionContext, PluginMessageActionRegistration, PluginMessageDirectiveMessage, PluginMessageDirectiveOpenWorkspaceFile, PluginMessageDirectiveProps, PluginMessageDirectiveRegistration, PluginNavPanelProps, PluginNavPanelRegistration, PluginNewThreadPanelActionContext, PluginNewThreadPanelActionRegistration, PluginNewThreadPanelProps, PluginPanelActionOpenOptions, PluginPendingInteractionProps, PluginPendingInteractionRegistration, PluginPendingInteractionView, PluginProviderCapabilities, PluginProviderComposerAction, PluginProviderDeclaration, PluginProviderExtensionKindDeclaration, PluginProviderFallbackModel, PluginProviderIconRegistration, PluginProviderMaintenance, PluginProviderModelCatalogScope, PluginProviderNativeRootEntry, PluginProviderNativeRoots, PluginProviderOptionDescriptor, PluginProviderOptionsContext, PluginProviderPermissionMode, PluginProviderReasoningLevel, PluginProviderStrings, PluginProviders, PluginProvidersState, PluginRealtime, PluginRealtimeConnectionState, PluginRpc, PluginRpcCallArgs, PluginRpcClient, PluginRpcContract, PluginRpcError, PluginRpcErrorCode, PluginRpcHandlers, PluginRpcIssuePathSegment, PluginRpcMethodContract, PluginRpcResult, PluginRpcValidationIssue, PluginSdkApp, PluginServerAccess, PluginServerApi, PluginSettingDescriptor, PluginSettingDescriptors, PluginSettingValue, PluginSettings, PluginSettingsHandle, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsState, PluginSettingsValues, PluginSharedPortTunnelIdentity, PluginSidebarFooterActionContext, PluginSidebarFooterActionProps, PluginSidebarFooterActionRegistration, PluginSidebarProject, PluginSidebarPullRequest, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginStatusApi, PluginStorage, PluginTargetedPanelActionOpenOptions, PluginThreadEventHandler, PluginThreadEventName, PluginThreadEventPayloads, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, PluginTurnFailedEvent, PluginUi, ReadonlyJsonValue, ServerAccessGrant, ServerAccessProviderDeclaration, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps, UseBranchesArgs, UseCheckoutStateArgs };