@get-bb/plugin-sdk 0.5.31 → 0.6.5

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

@@ -285,6 +285,11 @@ declare const appKeybindingOverridesSchema: z$1.ZodArray<z$1.ZodObject<{
         "window.new": "window.new";
         "workspace.openPreferred": "workspace.openPreferred";
     }>, z$1.ZodTemplateLiteral<`plugin:${string}/${string}`>]>;
+    platform: z$1.ZodOptional<z$1.ZodEnum<{
+        linux: "linux";
+        mac: "mac";
+        windows: "windows";
+    }>>;
     shortcut: z$1.ZodNullable<z$1.ZodObject<{
         alt: z$1.ZodBoolean;
         control: z$1.ZodBoolean;
@@ -528,6 +533,7 @@ declare const environmentSchema: z$1.ZodObject<{
 type Environment = z$1.infer<typeof environmentSchema>;
 
 declare const experimentsSchema: z$1.ZodRecord<z$1.ZodEnum<{
+    androidTesting: "androidTesting";
     changelogPreview: "changelogPreview";
     legacyJitiPluginLoader: "legacyJitiPluginLoader";
     mobileApp: "mobileApp";
@@ -10132,6 +10138,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             all: z$1.ZodArray<z$1.ZodEnum<{
                 browserFocus: "browserFocus";
                 editableFocus: "editableFocus";
+                linuxPlatform: "linuxPlatform";
                 macPlatform: "macPlatform";
                 mainSurface: "mainSurface";
                 modalOpen: "modalOpen";
@@ -10141,10 +10148,12 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
                 splitActive: "splitActive";
                 terminalFocus: "terminalFocus";
                 webSurface: "webSurface";
+                windowsPlatform: "windowsPlatform";
             }>>;
             none: z$1.ZodArray<z$1.ZodEnum<{
                 browserFocus: "browserFocus";
                 editableFocus: "editableFocus";
+                linuxPlatform: "linuxPlatform";
                 macPlatform: "macPlatform";
                 mainSurface: "mainSurface";
                 modalOpen: "modalOpen";
@@ -10154,10 +10163,12 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
                 splitActive: "splitActive";
                 terminalFocus: "terminalFocus";
                 webSurface: "webSurface";
+                windowsPlatform: "windowsPlatform";
             }>>;
         }, z$1.core.$strict>;
     }, z$1.core.$strict>>;
     experiments: z$1.ZodRecord<z$1.ZodEnum<{
+        androidTesting: "androidTesting";
         changelogPreview: "changelogPreview";
         legacyJitiPluginLoader: "legacyJitiPluginLoader";
         mobileApp: "mobileApp";
@@ -10266,6 +10277,11 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "window.new": "window.new";
             "workspace.openPreferred": "workspace.openPreferred";
         }>, z$1.ZodTemplateLiteral<`plugin:${string}/${string}`>]>;
+        platform: z$1.ZodOptional<z$1.ZodEnum<{
+            linux: "linux";
+            mac: "mac";
+            windows: "windows";
+        }>>;
         shortcut: z$1.ZodNullable<z$1.ZodObject<{
             alt: z$1.ZodBoolean;
             control: z$1.ZodBoolean;
@@ -10366,6 +10382,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             all: z$1.ZodArray<z$1.ZodEnum<{
                 browserFocus: "browserFocus";
                 editableFocus: "editableFocus";
+                linuxPlatform: "linuxPlatform";
                 macPlatform: "macPlatform";
                 mainSurface: "mainSurface";
                 modalOpen: "modalOpen";
@@ -10375,10 +10392,12 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
                 splitActive: "splitActive";
                 terminalFocus: "terminalFocus";
                 webSurface: "webSurface";
+                windowsPlatform: "windowsPlatform";
             }>>;
             none: z$1.ZodArray<z$1.ZodEnum<{
                 browserFocus: "browserFocus";
                 editableFocus: "editableFocus";
+                linuxPlatform: "linuxPlatform";
                 macPlatform: "macPlatform";
                 mainSurface: "mainSurface";
                 modalOpen: "modalOpen";
@@ -10388,6 +10407,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
                 splitActive: "splitActive";
                 terminalFocus: "terminalFocus";
                 webSurface: "webSurface";
+                windowsPlatform: "windowsPlatform";
             }>>;
         }, z$1.core.$strict>;
     }, z$1.core.$strict>>;
@@ -10655,6 +10675,27 @@ declare const systemMachineProviderSchema: z$1.ZodObject<{
     supportsSuspend: z$1.ZodBoolean;
 }, z$1.core.$strip>;
 type SystemMachineProvider = z$1.infer<typeof systemMachineProviderSchema>;
+declare const androidAppArtifactSchema: z$1.ZodObject<{
+    sha256: z$1.ZodString;
+    size: z$1.ZodNumber;
+    version: z$1.ZodString;
+    versionCode: z$1.ZodNumber;
+}, z$1.core.$strip>;
+type AndroidAppArtifact = z$1.infer<typeof androidAppArtifactSchema>;
+type SystemAndroidAppResponse = AndroidAppArtifact | null;
+declare const androidAppPrepareRequestSchema: z$1.ZodObject<{
+    source: z$1.ZodEnum<{
+        github: "github";
+        local: "local";
+    }>;
+}, z$1.core.$strip>;
+type AndroidAppPrepareRequest = z$1.infer<typeof androidAppPrepareRequestSchema>;
+interface AndroidAppPreparation {
+    status: "failed" | "idle" | "preparing" | "ready";
+    source: "github" | "local" | null;
+    message: string;
+    artifact: AndroidAppArtifact | null;
+}
 
 interface UiPreferencesResponse {
     preferences: UiPreferenceEntries;
@@ -12136,6 +12177,7 @@ declare const createThreadRequestSchema: 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">>>;
+    pinned: z$1.ZodOptional<z$1.ZodBoolean>;
     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, unknown, z$1.core.$ZodTypeInternals<JsonValue, unknown>>;
@@ -15460,6 +15502,9 @@ interface EnvironmentListProvidersArgs {
 }
 type EnvironmentListProvidersResult = SystemEnvironmentProvider[];
 interface EnvironmentsArea {
+    experimental_cleanup(args: EnvironmentActionArgs): Promise<{
+        ok: true;
+    }>;
     archiveThreads(args: EnvironmentActionArgs): Promise<EnvironmentArchiveThreadsResult>;
     commit(args: EnvironmentCommitArgs): Promise<EnvironmentCommitResult>;
     diff(args: EnvironmentDiffArgs): Promise<EnvironmentDiffResult>;
@@ -15609,6 +15654,7 @@ type HostDeleteResult = {
 type HostDirectoryResult = HostDirectoryListing;
 type HostGetResult = Host & {
     connectMachineId: string | null;
+    threadStorageRootPath: string | null;
 };
 type HostEnrollmentCommandResult = HostEnrollmentCommandResponse;
 type HostReconnectResult = HostReconnectResponse;
@@ -16279,6 +16325,9 @@ interface SystemArea {
     testAiService(args: SystemTestAiServiceArgs): Promise<SystemTestAiServiceResult>;
     transcribeVoice(args: SystemVoiceTranscriptionArgs): Promise<SystemVoiceTranscriptionResult>;
     uiPreferences: SystemUiPreferencesArea;
+    androidAppPreparation(): Promise<AndroidAppPreparation>;
+    prepareAndroidApp(input: AndroidAppPrepareRequest): Promise<AndroidAppPreparation>;
+    androidApp(): Promise<SystemAndroidAppResponse>;
     updateExperiments(args: Experiments): Promise<SystemUpdateExperimentsResult>;
     updateGeneralSettings(args: AppSettingsUpdate): Promise<SystemUpdateGeneralSettingsResult>;
     updateKeyboardSettings(args: AppKeybindingOverrides): Promise<SystemUpdateKeyboardSettingsResult>;
@@ -16988,7 +17037,7 @@ type ExperimentalSidebarNavigationAction = {
 /**
  * Semantic icon identity for one sidebar navigation item. Render it with
  * {@link PluginSdkApp.experimental_SidebarNavigationIcon} to match bb's
- * artwork, including plugin branding.
+ * artwork, including panel icons with plugin branding as their fallback.
  */
 type ExperimentalSidebarNavigationIcon = {
     kind: "host";
@@ -17514,6 +17563,7 @@ type ExperimentalPluginFixedTabReference<Target extends JsonValue$1 = never> = {
 /** A fixed tab declared by a plugin nav panel. */
 type PluginFixedTabRegistration<Target extends JsonValue$1 = never> = ExperimentalPluginFixedTabReference<Target> & {
     title: string;
+    /** Resolved names take precedence over plugin branding; unknown names fall back to branding. */
     icon: BbIconName;
     component: ComponentType<PluginNavPanelProps>;
     /** `flush` lets the component own padding and scrolling. */
@@ -17525,6 +17575,7 @@ interface PluginNavPanelRegistration {
     /** Unique within the plugin; letters, digits, `-`, `_`. */
     id: string;
     title: string;
+    /** Resolved names take precedence over plugin branding in navigation and the header; unknown names fall back to branding. */
     icon: BbIconName;
     /** URL segment under `/plugins/<pluginId>/`; letters, digits, `-`, `_`. */
     path: string;
@@ -17608,8 +17659,8 @@ interface PluginThreadPanelActionRegistration {
     /** Label of the action row in the panel's new-tab launcher. */
     title: string;
     /**
-     * Drawn only when the manifest declares no `bb.branding.icon`; the launcher
-     * row and opened tabs prefer that over this hint.
+     * Resolved names take precedence over plugin branding in the launcher and
+     * opened tabs. Omitted or unknown names fall back to plugin branding.
      */
     icon?: BbIconName;
     /** Rendered inside every panel tab this action opens. */
@@ -17648,7 +17699,7 @@ interface PluginNewThreadPanelActionRegistration {
     id: string;
     /** Label of the action row in the panel's new-tab launcher. */
     title: string;
-    /** Drawn only when the manifest declares no `bb.branding.icon`. */
+    /** Resolved names take precedence over plugin branding; omitted or unknown names fall back to branding. */
     icon?: BbIconName;
     /** Rendered inside every panel tab this action opens. */
     component: ComponentType<PluginNewThreadPanelProps>;
@@ -17693,7 +17744,7 @@ interface PluginSidebarFooterActionRegistration {
     id: string;
     /** Tooltip and accessible label for the icon button. */
     title: string;
-    /** Drawn only when the manifest declares no `bb.branding.icon`. */
+    /** Resolved names take precedence over plugin branding; omitted or unknown names fall back to branding. */
     icon: BbIconName;
     /**
      * Runs when the user activates the action (e.g. call `openSettings()`,
@@ -18078,7 +18129,7 @@ interface PluginSidebarThreadDraftState {
 }
 /**
  * The status another plugin's app-wide script set on a thread's row through
- * `useComposer().experimental_setThreadRowStatus` (see
+ * the content-script context's `experimental_setThreadRowStatus` (see
  * {@link PluginSdkApp.useSidebarThreadRowStatus}). bb's row draws it in
  * place of the draft glyph while it is set; a replaced list should do the
  * same so a status set by, say, the drafts or workflows plugin does not
@@ -18118,6 +18169,9 @@ interface PluginSidebarThreadActions {
      * `sectionId` files the new thread under that section, and
      * `environmentId` reuses that environment (the "New thread in
      * environment" affordance), both exactly as bb's own list does.
+     * `experimental_placement` explicitly selects the section and pin state,
+     * overriding `sectionId`. Omitting placement starts unpinned, outside sections
+     * unless `sectionId` is supplied; previous composer placement is cleared.
      * `hostId` selects a machine for a new environment when it
      * is known and supports an environment provider. `environmentId` wins when
      * both are supplied.
@@ -18125,6 +18179,10 @@ interface PluginSidebarThreadActions {
     openNewThread(options?: {
         projectId?: string;
         sectionId?: string;
+        experimental_placement?: {
+            sectionId: string | null;
+            pinned: boolean;
+        };
         environmentId?: string;
         hostId?: string;
         focusPrompt?: boolean;
@@ -18413,12 +18471,19 @@ interface PluginMessageActionContext {
      * is never thrown: the host logs it and reports it here.
      */
     openPanel(options: PluginTargetedPanelActionOpenOptions): boolean;
+    /**
+     * The composer of the thread the message is in, or null when that thread's
+     * composer is not available on this surface. The same handle
+     * `useComposer()` returns there.
+     */
+    composer: PluginComposerApi | null;
 }
 /**
  * An action on chat messages: an icon button in the per-message action bar
  * (user and assistant messages) and an entry in the assistant-message
  * text-selection menu. Host-rendered chrome — the plugin supplies title,
- * icon hint, and `run` behavior only.
+ * icon, and `run` behavior only. Resolved icon names take precedence over
+ * plugin branding; omitted or unknown names fall back to branding.
  */
 interface PluginMessageActionRegistration {
     /** Unique within the plugin; letters, digits, `-`, `_`. */
@@ -18928,12 +18993,6 @@ type PluginComposerScope = {
     kind: "queued-message";
     threadId: string;
     queuedMessageId: string;
-} | {
-    kind: "side-chat";
-    projectId: string;
-    parentThreadId: string;
-    tabId: string;
-    childThreadId: string | null;
 } | {
     kind: "new-thread";
     /** Root compose's effective selected project; null only while unresolved. */
@@ -18956,35 +19015,39 @@ interface ComposerCustomization {
         component: ComponentType;
     }[];
     plusMenu?: readonly ComposerPlusMenuItem[];
+    /** Host-rendered rows in the menu next to the composer's send button. */
+    sendMenu?: readonly ComposerSendMenuItem[];
     richText?: ComposerRichTextSpec;
 }
 /** Host-rendered menu row in the composer's `+` menu. */
 interface ComposerPlusMenuItem {
     id: string;
     label: string;
-    /** Drawn only when the manifest declares no `bb.branding.icon`. */
+    /** Takes precedence over the plugin's `bb.branding.icon`, which is drawn when this is omitted. */
     icon?: BbIconName;
     /** Accessible description for the host-rendered row. */
     description?: string;
-    disabled?: boolean | ((view: ComposerView) => boolean);
+    disabled?: boolean | ((composer: PluginComposerApi) => boolean);
     run(context: {
         composer: PluginComposerApi;
-        view: ComposerView;
     }): void | Promise<void>;
 }
-/** Reactive read-side of the composer a plugin surface is mounted in. */
-interface ComposerView {
-    scope: PluginComposerScope;
-    layout: "compact" | "expanded" | "zen";
-    draft: {
-        text: string;
-        isEmpty: boolean;
-        attachmentCount: number;
-    };
-    run: {
-        isRunning: boolean;
-        isSubmitting: boolean;
-    };
+/**
+ * Host-rendered row in the menu next to the composer's send button, for
+ * alternatives to sending right away (save as a draft, send later). The menu
+ * shows only while the composer can submit.
+ */
+interface ComposerSendMenuItem {
+    id: string;
+    label: string;
+    /** Takes precedence over the plugin's `bb.branding.icon`, which is drawn when this is omitted. */
+    icon?: BbIconName;
+    /** Accessible description for the host-rendered row. */
+    description?: string;
+    disabled?: boolean | ((composer: PluginComposerApi) => boolean);
+    run(context: {
+        composer: PluginComposerApi;
+    }): void | Promise<void>;
 }
 interface ComposerRichTextSpec {
     /** Content-derived paint: match ranges receive `className`; text is never mutated. */
@@ -18997,18 +19060,80 @@ interface ComposerRichTextSpec {
         }[];
         className: string;
     }[];
-    /** Debounced, read-only observation of the structured draft. */
-    onDraftChange?(draft: ComposerStructuredDraft, view: ComposerView): void;
 }
-interface ComposerStructuredDraft {
+/** The composer's text and the @-mention pills in it. */
+interface ComposerDraft {
     text: string;
-    mentions: readonly {
-        from: number;
-        to: number;
-        provider: string;
-        id: string;
-        label: string;
-    }[];
+    mentions: readonly ComposerMention[];
+}
+/** An already uploaded attachment; paths retain their original project or thread ownership. */
+type ComposerAttachment = UploadedPromptAttachment;
+/** The complete current draft. Snapshots and their entries are immutable. */
+interface ComposerDraftSnapshot extends ComposerDraft {
+    readonly attachments: readonly ComposerAttachment[];
+}
+/** Atomic text and mention replacement, optionally replacing uploaded attachments too. */
+interface ComposerDraftReplacement extends ComposerDraft {
+    /** Omit to preserve attachments; supply an empty array to remove them all. Does not upload or copy files. */
+    attachments?: readonly ComposerAttachment[];
+}
+/**
+ * One @-mention pill: its range in `ComposerDraft.text` plus everything the
+ * host needs to recreate it, so a mention read from `draft` can be passed
+ * back to `insert` unchanged.
+ */
+type ComposerMention = {
+    from: number;
+    to: number;
+    label: string;
+} & ({
+    kind: "thread";
+    threadId: string;
+    projectId?: string;
+} | {
+    kind: "project";
+    projectId: string;
+} | {
+    kind: "section";
+    sectionId: string;
+} | {
+    kind: "path";
+    path: string;
+    source: "thread-storage" | "workspace";
+    entryKind: "directory" | "file";
+} | {
+    kind: "command";
+    trigger: "$" | "/";
+    name: string;
+    source: "command" | "skill";
+    origin: "builtin" | "project" | "user";
+    argumentHint: string | null;
+} | {
+    kind: "plugin";
+    /** The plugin that owns the pill. */
+    pluginId: string;
+    /** The mention provider id that plugin registered. */
+    provider: string;
+    /** The item id the provider's `resolve` receives at send time. */
+    id: string;
+    icon?: string | null;
+});
+/**
+ * What `insert` accepts: text, a mention read from `draft` (any kind), or one
+ * of the calling plugin's own mentions (`{ provider, id, label }`, no `kind`).
+ */
+type ComposerInsertPart = string | ComposerMention | PluginComposerMention;
+/** Where `insert` puts its content. */
+interface ComposerInsertOptions {
+    /**
+     * `"cursor"` (default) inserts at the editor's selection, replacing any
+     * selected text; the selection is kept while focus is elsewhere, and the
+     * composer must be on screen. `"end"` inserts after the last character and
+     * also works for a composer that is not on screen.
+     */
+    at?: "cursor" | "end";
+    /** Put the content on its own paragraph, adding a paragraph break before and after only where text is adjacent. */
+    block?: boolean;
 }
 /** Host-rendered paint applied to the editable composer text. */
 interface PluginComposerTextEffect {
@@ -19040,31 +19165,77 @@ interface PluginComposerMention {
     label: string;
 }
 /**
- * Programmatic access to the chat composer draft — the same shared draft the
- * built-in "Add to chat" affordances (file preview, diff, terminal selections)
- * write to. While a queued message is being edited, writes land in that
- * message's inline editor. In a side chat, writes land in the visible side-chat
- * draft. Otherwise, inside a thread context writes land in that thread's draft;
- * anywhere else (nav panel, homepage section) they seed the new-thread composer
- * draft, which persists until the user sends or clears it.
+ * One composer: its state and the writes a plugin can make. `useComposer()`
+ * returns the composer the calling surface belongs to — inside a composer
+ * slot, that composer; in a thread's panels, that thread's composer;
+ * elsewhere, the current route's draft (the thread in view, or the new-thread
+ * draft).
+ *
+ * The handle is stable: the same composer returns the same object across
+ * renders, and its methods always act on the current draft, so it is safe to
+ * keep in effects, callbacks and async work. Its reactive fields (`text`,
+ * `draft`, `selection`, `isEmpty`, …) re-render the calling component when they change;
+ * depend on those fields, not on the handle, in memo dependency lists.
+ *
+ * A handle always writes to its own composer's draft. Thread and new-thread
+ * drafts persist, so a write after the composer left the screen still lands
+ * in that draft. When the draft no longer exists (a queued-message or
+ * sent-message editor that closed), `insert`, `replace`, `removeMention`, `submit` and
+ * `setSelection` throw "This composer is no longer available"; the older
+ * text methods log a warning and do nothing.
  */
 interface PluginComposerApi {
     scope: PluginComposerScope;
+    /**
+     * Stable identity for this composer's draft: the same across remounts and
+     * reloads for thread and new-thread composers (including a `ThreadChat`),
+     * and per editing session for queued-message and sent-message editors.
+     */
+    readonly key: string;
+    /** `"compact"` in the collapsed single-line layout, otherwise `"expanded"`. */
+    readonly layout: "compact" | "expanded";
+    /** The thread's agent is running or stopping. Always false in a new-thread composer. */
+    readonly isRunning: boolean;
+    /** The composer is submitting right now. */
+    readonly isSubmitting: boolean;
+    /**
+     * Pressing Enter would not submit right now: the same decision as the
+     * host's send button (empty draft, uploads in progress, loading, a
+     * selection or setup missing, a pending interaction, voice input, …).
+     */
+    readonly isSubmittingBlocked: boolean;
+    /** The host's message for why submitting is blocked, or null when it is not. */
+    readonly submittingBlockedReason: string | null;
+    /** No text (ignoring whitespace), no mentions and no attachments. */
+    readonly isEmpty: boolean;
+    /** Attachments that have finished uploading. */
+    readonly attachmentCount: number;
     /** Current plain text for this composer scope. */
     readonly text: string;
+    /** The complete current draft, including uploaded attachments. Stable until the draft changes. */
+    readonly draft: ComposerDraftSnapshot;
+    /** Current picker values, or null when this composer has no pickers. Stable until a picker value changes. */
+    readonly selection: ComposerSelection | null;
     /**
-     * Replace the draft's plain text. Attachments are preserved. Inline mentions
-     * outside the changed range are preserved and rebased; mentions overlapped
-     * by the replacement are removed because their text representation changed.
+     * Replace text and mentions together in one committed change. An updater
+     * receives the latest immutable snapshot, including attachments, and must
+     * return its result synchronously. Returning that same snapshot is a no-op.
+     * Omitted attachments are preserved; an explicit list replaces them, and
+     * an empty list clears them. Does not infer or rebase mention ranges.
+     * Ranges are non-overlapping UTF-16 offsets into the supplied text.
+     * Invalid results, throwing updaters, and unavailable editors leave the
+     * draft unchanged. Does not focus, submit, upload, or copy files between
+     * projects. Use `insert` for insertion at the editor's cursor.
      */
-    setText(next: string): void;
+    replace(next: ComposerDraftReplacement | ((current: ComposerDraftSnapshot) => ComposerDraftReplacement)): void;
     /**
-     * Replace the draft's plain text from the latest committed value. Uses the
-     * same structured-state reconciliation as `setText`.
+     * Insert text and mentions. See {@link ComposerInsertOptions} for placement.
+     * Mentions read from `draft` are recreated exactly; the calling plugin's
+     * own `{ provider, id, label }` resolves through its mention provider.
+     * Throws for another plugin's mention without `kind`, and for
+     * `at: "cursor"` when the composer is not on screen.
      */
-    updateText(updater: (current: string) => string): void;
-    /** Clear plain text without clearing independently attached files. */
-    clear(): void;
+    insert(parts: ComposerInsertPart | readonly ComposerInsertPart[], options?: ComposerInsertOptions): void;
     /**
      * Apply a host-rendered effect to this composer's editable text, or clear it.
      * Effects are scoped to the calling plugin and automatically clear when the
@@ -19077,38 +19248,22 @@ interface PluginComposerApi {
      * scope changes.
      */
     setInputLock(locked: boolean): void;
-    /**
-     * Append text to the draft as a `> ` blockquote block and focus the
-     * composer. Blank text is a no-op. This is the "reference this selection
-     * in chat" primitive.
-     */
-    addQuote(text: string): void;
-    /**
-     * Insert an @-mention pill that resolves through this plugin's mention
-     * provider at send time — the durable way to reference an entity whose
-     * content should be fetched fresh when the message is sent.
-     */
-    insertMention(mention: PluginComposerMention): void;
-    /** Remove this plugin's matching mention pills and their text from the current draft. */
-    experimental_removeMention(mention: {
-        provider: string;
-        id: string;
-    }): void;
     /** Subscribe to successful local submissions in this composer scope, including accepted queued messages. Failed sends and draft clearing do not notify. Dispose on unmount. */
-    experimental_onSubmitted(listener: () => void): () => void;
+    onSubmitted(listener: () => void): () => void;
     /** Focus the composer caret at the end of the draft. */
     focus(): void;
     /**
-     * Submit this composer's draft through the composer's OWN submit pipeline,
-     * 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
+     * Submit this composer's draft exactly as pressing Enter would: the same
+     * checks and the same action (send, or queue while the thread is busy; a
+     * provider handoff creates a new thread). The draft's attachments and
      * @-mentions, and — in the new-thread composer — the provider, model,
      * reasoning level, service tier, permission mode and environment the user
-     * has selected on screen, all travel with it. A plugin cannot assemble that
-     * 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.
+     * has selected on screen, all travel with it.
+     *
+     * While attachments are uploading it waits for them, then checks again; it
+     * rejects if an upload fails. Otherwise, when submitting is blocked it
+     * rejects with `submittingBlockedReason`, a message safe to show to the
+     * user. The queued-message and sent-message editors save edits and reject.
      *
      * `sendAt` queues the submission until that time. `experimental_data` is
      * opaque JSON delivered to dispatch hooks together with the calling plugin's
@@ -19117,16 +19272,10 @@ interface PluginComposerApi {
      * 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
-     * pipeline (a queued-message editor, a side chat), an empty draft, or a
-     * composer that is not ready (still loading its execution defaults, missing
-     * an environment). The rejection's message is safe to show to the user.
      * Failures of the underlying request are reported by bb's own submit error
      * handling and restore the draft, exactly as an interactive failure does.
-     *
-     * Experimental: see docs/api_to_audit.md.
      */
-    experimental_submit(options: ExperimentalComposerSubmitOptions): Promise<void>;
+    submit(options: ComposerSubmitOptions): Promise<void>;
     /**
      * Set this composer's pickers as if each value had been picked by hand.
      *
@@ -19173,18 +19322,15 @@ interface PluginComposerApi {
      * mounted outside any composer), when the calling surface is no longer
      * active, and when a value is not a known reasoning level, service tier or
      * permission mode.
-     *
-     * Experimental: see docs/api_to_audit.md.
      */
-    experimental_setSelection(selection: ExperimentalComposerSelection): Promise<ExperimentalComposerSelection>;
+    setSelection(selection: ComposerSelection): Promise<ComposerSelection>;
 }
 /**
- * Picker values for `experimental_setSelection`, and the shape it resolves
- * with. Field names match `NewThreadRequest` and the `default*` props of
+ * Current picker values in `selection`, input for `setSelection`, and the shape it resolves with. Field names match `NewThreadRequest` and the `default*` props of
  * `experimental_NewThreadComposer`, so one routed decision can feed the
  * composer, the embedded composer and `bb.sdk.threads.spawn` alike.
  */
-interface ExperimentalComposerSelection {
+interface ComposerSelection {
     /** New-thread composers only. BB's personal-project id means "Don't work in a project". */
     projectId?: string;
     /**
@@ -19205,13 +19351,13 @@ interface ExperimentalComposerSelection {
     permissionMode?: PermissionMode;
 }
 /**
- * What `experimental_submit` does differently from pressing Enter.
+ * What `submit` does differently from pressing Enter.
  *
  * `experimental_data` is opaque JSON delivered to dispatch hooks. The runtime
  * associates it with the calling plugin automatically for the initial
  * dispatch attempt.
  */
-type ExperimentalComposerSubmitOptions = {
+type ComposerSubmitOptions = {
     sendAt: number;
     experimental_data?: JsonValue$1;
 } | {
@@ -19436,7 +19582,7 @@ interface NewThreadRequest {
     input: PromptInput[];
     /**
      * Epoch ms the first turn should dispatch at. Present only when the
-     * submission came from `useComposer().experimental_submit` — a scheduled
+     * submission came from `useComposer().submit` — a scheduled
      * create — and absent otherwise, which is what makes an ordinary submission
      * start work at once. Forward it to `threads.spawn` unchanged: the thread is
      * created `pending` and its first message is queued as a row until then.
@@ -19740,6 +19886,20 @@ interface PluginSdkApp {
     /** Read or clear the owning tab's validated, session-scoped target. */
     experimental_useFixedTabTarget<Target extends JsonValue$1>(tab: ExperimentalPluginFixedTabReference<Target>): ExperimentalFixedTabTargetState<Target> | null;
     useComposer(): PluginComposerApi;
+    /**
+     * Every composer on screen that plugin composer customizations mount in,
+     * oldest first: the thread page's composer, a `ThreadChat`'s composer, the
+     * new-thread composer and open queued-message editors. Use it from a panel
+     * or page that writes into a composer the user picks — label each by its
+     * `scope`, then call `insert`, `focus` or `submit` on the chosen handle.
+     *
+     * Each handle is stable while its composer stays on screen and follows the
+     * same lifetime rule as `useComposer()`. `setTextEffect` and `setInputLock`
+     * have no effect here; call them from a composer slot's `useComposer()`.
+     * The calling component re-renders when the list or any listed draft
+     * changes.
+     */
+    useComposers(): readonly PluginComposerApi[];
     /**
      * The sidebar's live thread view (see {@link PluginSidebarThreadsState}).
      * Reads the host's own cache and realtime subscriptions, so it costs no
@@ -19800,7 +19960,7 @@ interface PluginSdkApp {
     experimental_useSidebarNavigationSplit(itemId: string, options?: ExperimentalSidebarNavigationSplitOptions): ExperimentalSidebarNavigationSplit;
     /**
      * bb's artwork for a navigation item's icon: bb's glyphs for its own items,
-     * and the contributing plugin's branding for plugin panels. Experimental:
+     * and the panel's explicit icon, falling back to plugin branding, for plugin panels. Experimental:
      * see docs/api_to_audit.md.
      */
     experimental_SidebarNavigationIcon: ComponentType<ExperimentalSidebarNavigationIconProps>;
@@ -19960,7 +20120,6 @@ interface PluginSdkApp {
      * docs/api_to_audit.md.
      */
     experimental_Diff: ComponentType<DiffProps>;
-    useComposerView(): ComposerView;
 }
 
 declare const experimental_Icon: react.ComponentType<ExperimentalIconProps>;
@@ -19989,7 +20148,7 @@ declare const useBbNavigate: () => BbNavigate;
 declare const experimental_useAppPanel: () => ExperimentalAppPanel;
 declare const experimental_useFixedTabTarget: <Target extends JsonValue$1>(tab: ExperimentalPluginFixedTabReference<Target>) => ExperimentalFixedTabTargetState<Target> | null;
 declare const useComposer: () => PluginComposerApi;
-declare const useComposerView: () => ComposerView;
+declare const useComposers: () => readonly PluginComposerApi[];
 declare const experimental_useSidebarThreads: (options?: {
     experimental_lifecycles: readonly ("active" | "archived")[];
 }) => PluginSidebarThreadsState;
@@ -20011,5 +20170,5 @@ declare const useSdk: () => PluginBrowserBbSdk;
 declare const experimental_useProviders: () => PluginProvidersState;
 declare const experimental_useCodeTheme: () => PluginCodeThemeState;
 
-export { Markdown, ThreadChat, ThreadTitle, UrlLink, definePluginApp, experimental_BranchPicker, experimental_Diff, experimental_FileLink, experimental_Icon, experimental_NewThreadComposer, experimental_PermissionModePicker, experimental_ProviderIcon, experimental_ProviderModelPicker, experimental_SidebarNavigationIcon, experimental_SourceCode, experimental_useAppPanel, experimental_useBranches, experimental_useCheckoutState, experimental_useCodeTheme, experimental_useFixedTabTarget, experimental_usePluginId, experimental_useProviders, experimental_useQuestionFormHost, experimental_useSidebarNavigation, experimental_useSidebarNavigationSplit, experimental_useSidebarThreadActions, experimental_useSidebarThreadPullRequest, experimental_useSidebarThreadSplit, experimental_useSidebarThreads, useBbContext, useBbNavigate, useComposer, useComposerView, useEnvironmentProviders, useRealtime, useRealtimeConnectionState, useRpc, useSdk, useSettings, useSidebarSplitLayout, useSidebarThreadDraft, useSidebarThreadDraftIds, useSidebarThreadRowStatus, useSidebarThreadRowStatuses, useSidebarThreadShortcut };
-export type { BbContext, BbNavigate, BranchPickerProps, BranchesState, CheckoutState, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppIcons, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSelection, ExperimentalComposerSubmitOptions, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalIconProps, ExperimentalIconRegistration, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginBrowserPage, ExperimentalPluginBrowserPageEvaluateOptions, ExperimentalPluginBrowserPageWorld, ExperimentalPluginBrowserToolbarActionProps, ExperimentalPluginBrowserToolbarActionRegistration, ExperimentalPluginFixedTabReference, ExperimentalProviderIconProps, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalQuestionFormHost, ExperimentalQuestionShortcut, ExperimentalSidebarFooter, ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterActionRegistration, ExperimentalSidebarFooterDisclosureController, ExperimentalSidebarFooterDisclosureProps, ExperimentalSidebarFooterDisclosureRegistration, ExperimentalSidebarFooterItemBase, ExperimentalSidebarFooterItemRegistration, ExperimentalSidebarHeaderProps, ExperimentalSidebarHeaderRegistration, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActions, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationIconProps, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, ExperimentalSidebarNavigationSplit, ExperimentalSidebarNavigationSplitOptions, ExperimentalSidebarNavigationState, JsonValue$1 as JsonValue, MarkdownProps, NewThreadComposerProps, NewThreadRequest, PluginAppBuilder, PluginAppCommands, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginBoundThreadsArea, PluginBrowserBbSdk, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandContext, PluginCommandRegistration, PluginCommandShortcut, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginEnvironmentProvider, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, PluginEnvironmentProvidersState, 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, PluginSidebarSection, PluginSidebarSplitLayout, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadDraftState, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadRowStatus, PluginSidebarThreadShortcut, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginTargetedPanelActionOpenOptions, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginThreadTitleProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, ReadonlyJsonValue, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps, UseBranchesArgs, UseCheckoutStateArgs };
+export { Markdown, ThreadChat, ThreadTitle, UrlLink, definePluginApp, experimental_BranchPicker, experimental_Diff, experimental_FileLink, experimental_Icon, experimental_NewThreadComposer, experimental_PermissionModePicker, experimental_ProviderIcon, experimental_ProviderModelPicker, experimental_SidebarNavigationIcon, experimental_SourceCode, experimental_useAppPanel, experimental_useBranches, experimental_useCheckoutState, experimental_useCodeTheme, experimental_useFixedTabTarget, experimental_usePluginId, experimental_useProviders, experimental_useQuestionFormHost, experimental_useSidebarNavigation, experimental_useSidebarNavigationSplit, experimental_useSidebarThreadActions, experimental_useSidebarThreadPullRequest, experimental_useSidebarThreadSplit, experimental_useSidebarThreads, useBbContext, useBbNavigate, useComposer, useComposers, useEnvironmentProviders, useRealtime, useRealtimeConnectionState, useRpc, useSdk, useSettings, useSidebarSplitLayout, useSidebarThreadDraft, useSidebarThreadDraftIds, useSidebarThreadRowStatus, useSidebarThreadRowStatuses, useSidebarThreadShortcut };
+export type { BbContext, BbNavigate, BranchPickerProps, BranchesState, CheckoutState, CodeOverflowMode, ComposerAttachment, ComposerCustomization, ComposerDraft, ComposerDraftReplacement, ComposerDraftSnapshot, ComposerInsertOptions, ComposerInsertPart, ComposerMention, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerSelection, ComposerSendMenuItem, ComposerSubmitOptions, DiffProps, DiffViewMode, ExperimentalAppIcons, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalIconProps, ExperimentalIconRegistration, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginBrowserPage, ExperimentalPluginBrowserPageEvaluateOptions, ExperimentalPluginBrowserPageWorld, ExperimentalPluginBrowserToolbarActionProps, ExperimentalPluginBrowserToolbarActionRegistration, ExperimentalPluginFixedTabReference, ExperimentalProviderIconProps, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalQuestionFormHost, ExperimentalQuestionShortcut, ExperimentalSidebarFooter, ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterActionRegistration, ExperimentalSidebarFooterDisclosureController, ExperimentalSidebarFooterDisclosureProps, ExperimentalSidebarFooterDisclosureRegistration, ExperimentalSidebarFooterItemBase, ExperimentalSidebarFooterItemRegistration, ExperimentalSidebarHeaderProps, ExperimentalSidebarHeaderRegistration, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActions, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationIconProps, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, ExperimentalSidebarNavigationSplit, ExperimentalSidebarNavigationSplitOptions, ExperimentalSidebarNavigationState, JsonValue$1 as JsonValue, MarkdownProps, NewThreadComposerProps, NewThreadRequest, PluginAppBuilder, PluginAppCommands, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginBoundThreadsArea, PluginBrowserBbSdk, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandContext, PluginCommandRegistration, PluginCommandShortcut, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginEnvironmentProvider, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, PluginEnvironmentProvidersState, 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, PluginSidebarSection, PluginSidebarSplitLayout, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadDraftState, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadRowStatus, PluginSidebarThreadShortcut, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginTargetedPanelActionOpenOptions, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginThreadTitleProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, ReadonlyJsonValue, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps, UseBranchesArgs, UseCheckoutStateArgs };