@get-bb/plugin-sdk 0.5.16 → 0.5.23

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

@@ -378,6 +378,7 @@ declare const changedMessageSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
     type: z$1.ZodLiteral<"changed">;
 }, z$1.core.$strict>, z$1.ZodObject<{
     changes: z$1.ZodReadonly<z$1.ZodArray<z$1.ZodEnum<{
+        "app-update-changed": "app-update-changed";
         "config-changed": "config-changed";
         "environment-availability-changed": "environment-availability-changed";
         "plugins-changed": "plugins-changed";
@@ -474,10 +475,8 @@ type Environment = z$1.infer<typeof environmentSchema>;
 declare const experimentsSchema: z$1.ZodRecord<z$1.ZodEnum<{
     changelogPreview: "changelogPreview";
     mobileApp: "mobileApp";
-    multiMachinePicker: "multiMachinePicker";
     serverMove: "serverMove";
     sidebarProgressiveDisclosure: "sidebarProgressiveDisclosure";
-    timelineWindowing: "timelineWindowing";
 }>, z$1.ZodBoolean>;
 type Experiments = z$1.infer<typeof experimentsSchema>;
 
@@ -9015,6 +9014,12 @@ declare const hostEnrollmentCommandResponseSchema: z$1.ZodNullable<z$1.ZodObject
     expiresAt: z$1.ZodNumber;
 }, z$1.core.$strip>>;
 type HostEnrollmentCommandResponse = z$1.infer<typeof hostEnrollmentCommandResponseSchema>;
+declare const hostReconnectResponseSchema: z$1.ZodObject<{
+    command: z$1.ZodString;
+    expiresAt: z$1.ZodNumber;
+    hostId: z$1.ZodString;
+}, z$1.core.$strict>;
+type HostReconnectResponse = z$1.infer<typeof hostReconnectResponseSchema>;
 declare const createHostJoinCodeResponseSchema: z$1.ZodObject<{
     expiresAt: z$1.ZodNumber;
     hostId: z$1.ZodString;
@@ -9702,6 +9707,7 @@ declare const systemExecutionOptionsResponseSchema: z$1.ZodObject<{
             provider_unavailable: "provider_unavailable";
             timeout: "timeout";
         }>;
+        detail: z$1.ZodNullable<z$1.ZodString>;
         providerId: z$1.ZodString;
     }, z$1.core.$strip>>;
     models: z$1.ZodArray<z$1.ZodObject<{
@@ -9908,21 +9914,93 @@ declare const systemProviderStatesResponseSchema: z$1.ZodObject<{
     }, z$1.core.$loose>>;
 }, z$1.core.$strip>;
 type SystemProviderStatesResponse = z$1.infer<typeof systemProviderStatesResponseSchema>;
-declare const systemConfigResponseSchema: z$1.ZodObject<{
-    aiServices: z$1.ZodObject<{
-        inference: z$1.ZodString;
-        inferenceFallback: z$1.ZodString;
-        services: z$1.ZodArray<z$1.ZodObject<{
-            displayName: z$1.ZodString;
-            id: z$1.ZodString;
-            kinds: z$1.ZodArray<z$1.ZodEnum<{
-                inference: "inference";
-                voice: "voice";
-            }>>;
+declare const systemAiServicesResponseSchema: z$1.ZodObject<{
+    selections: z$1.ZodObject<{
+        "commit-message": z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+            mode: z$1.ZodLiteral<"automatic">;
+        }, z$1.core.$strict>, z$1.ZodObject<{
+            mode: z$1.ZodLiteral<"off">;
+        }, z$1.core.$strict>, z$1.ZodObject<{
+            mode: z$1.ZodLiteral<"service">;
             pluginId: z$1.ZodString;
-        }, z$1.core.$strip>>;
-        transcription: z$1.ZodString;
-    }, z$1.core.$strip>;
+            serviceId: z$1.ZodString;
+        }, z$1.core.$strict>], "mode">;
+        "thread-title": z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+            mode: z$1.ZodLiteral<"automatic">;
+        }, z$1.core.$strict>, z$1.ZodObject<{
+            mode: z$1.ZodLiteral<"off">;
+        }, z$1.core.$strict>, z$1.ZodObject<{
+            mode: z$1.ZodLiteral<"service">;
+            pluginId: z$1.ZodString;
+            serviceId: z$1.ZodString;
+        }, z$1.core.$strict>], "mode">;
+        voice: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+            mode: z$1.ZodLiteral<"automatic">;
+        }, z$1.core.$strict>, z$1.ZodObject<{
+            mode: z$1.ZodLiteral<"off">;
+        }, z$1.core.$strict>, z$1.ZodObject<{
+            mode: z$1.ZodLiteral<"service">;
+            pluginId: z$1.ZodString;
+            serviceId: z$1.ZodString;
+        }, z$1.core.$strict>], "mode">;
+    }, z$1.core.$strict>;
+    services: z$1.ZodArray<z$1.ZodObject<{
+        automaticRank: z$1.ZodNullable<z$1.ZodNumber>;
+        displayName: z$1.ZodString;
+        id: z$1.ZodString;
+        pluginId: z$1.ZodString;
+        status: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+            ready: z$1.ZodLiteral<true>;
+        }, z$1.core.$strict>, z$1.ZodObject<{
+            message: z$1.ZodString;
+            ready: z$1.ZodLiteral<false>;
+        }, z$1.core.$strict>], "ready">;
+        tasks: z$1.ZodArray<z$1.ZodEnum<{
+            "commit-message": "commit-message";
+            "thread-title": "thread-title";
+            voice: "voice";
+        }>>;
+    }, z$1.core.$strip>>;
+}, z$1.core.$strip>;
+type SystemAiServicesResponse = z$1.infer<typeof systemAiServicesResponseSchema>;
+declare const setAiServiceSelectionRequestSchema: z$1.ZodObject<{
+    selection: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+        mode: z$1.ZodLiteral<"automatic">;
+    }, z$1.core.$strict>, z$1.ZodObject<{
+        mode: z$1.ZodLiteral<"off">;
+    }, z$1.core.$strict>, z$1.ZodObject<{
+        mode: z$1.ZodLiteral<"service">;
+        pluginId: z$1.ZodString;
+        serviceId: z$1.ZodString;
+    }, z$1.core.$strict>], "mode">;
+    task: z$1.ZodEnum<{
+        "commit-message": "commit-message";
+        "thread-title": "thread-title";
+        voice: "voice";
+    }>;
+}, z$1.core.$strict>;
+type SetAiServiceSelectionRequest = z$1.infer<typeof setAiServiceSelectionRequestSchema>;
+declare const testAiServiceRequestSchema: z$1.ZodObject<{
+    task: z$1.ZodEnum<{
+        "commit-message": "commit-message";
+        "thread-title": "thread-title";
+    }>;
+}, z$1.core.$strict>;
+type TestAiServiceRequest = z$1.infer<typeof testAiServiceRequestSchema>;
+declare const testAiServiceResponseSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+    displayName: z$1.ZodString;
+    durationMs: z$1.ZodNumber;
+    ok: z$1.ZodLiteral<true>;
+    pluginId: z$1.ZodString;
+    serviceId: z$1.ZodString;
+    text: z$1.ZodString;
+}, z$1.core.$strip>, z$1.ZodObject<{
+    durationMs: z$1.ZodNumber;
+    message: z$1.ZodString;
+    ok: z$1.ZodLiteral<false>;
+}, z$1.core.$strip>], "ok">;
+type TestAiServiceResponse = z$1.infer<typeof testAiServiceResponseSchema>;
+declare const systemConfigResponseSchema: z$1.ZodObject<{
     appearance: z$1.ZodObject<{
         customCss: z$1.ZodNullable<z$1.ZodString>;
         faviconColor: z$1.ZodEnum<{
@@ -10061,10 +10139,8 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
     experiments: z$1.ZodRecord<z$1.ZodEnum<{
         changelogPreview: "changelogPreview";
         mobileApp: "mobileApp";
-        multiMachinePicker: "multiMachinePicker";
         serverMove: "serverMove";
         sidebarProgressiveDisclosure: "sidebarProgressiveDisclosure";
-        timelineWindowing: "timelineWindowing";
     }>, z$1.ZodBoolean>;
     featureFlags: z$1.ZodObject<{
         placeholder: z$1.ZodBoolean;
@@ -10372,6 +10448,94 @@ declare const systemVersionResponseSchema: z$1.ZodObject<{
     upgradeCommand: z$1.ZodString;
 }, z$1.core.$strip>;
 type SystemVersionResponse = z$1.infer<typeof systemVersionResponseSchema>;
+declare const systemAppUpdateStatusSchema: z$1.ZodObject<{
+    activity: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+        phase: z$1.ZodLiteral<"idle">;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+        output: z$1.ZodArray<z$1.ZodString>;
+        phase: z$1.ZodLiteral<"preparing">;
+        startedAt: z$1.ZodString;
+        step: z$1.ZodString;
+        targetVersion: z$1.ZodString;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+        phase: z$1.ZodLiteral<"restarting">;
+        startedAt: z$1.ZodString;
+        targetVersion: z$1.ZodString;
+    }, z$1.core.$strip>], "phase">;
+    available: z$1.ZodNullable<z$1.ZodObject<{
+        channel: z$1.ZodEnum<{
+            latest: "latest";
+            main: "main";
+            nightly: "nightly";
+        }>;
+        commit: z$1.ZodNullable<z$1.ZodString>;
+        commitCount: z$1.ZodNullable<z$1.ZodNumber>;
+        subjects: z$1.ZodArray<z$1.ZodString>;
+        version: z$1.ZodString;
+    }, z$1.core.$strip>>;
+    blocked: z$1.ZodNullable<z$1.ZodObject<{
+        message: z$1.ZodString;
+        reason: z$1.ZodEnum<{
+            "detached-head": "detached-head";
+            "fetch-failed": "fetch-failed";
+            "not-on-main": "not-on-main";
+            "uncommitted-changes": "uncommitted-changes";
+            diverged: "diverged";
+        }>;
+    }, z$1.core.$strip>>;
+    current: z$1.ZodObject<{
+        commit: z$1.ZodNullable<z$1.ZodString>;
+        version: z$1.ZodString;
+    }, z$1.core.$strip>;
+    lastResult: z$1.ZodNullable<z$1.ZodObject<{
+        acknowledged: z$1.ZodBoolean;
+        finishedAt: z$1.ZodString;
+        from: z$1.ZodObject<{
+            commit: z$1.ZodNullable<z$1.ZodString>;
+            version: z$1.ZodString;
+        }, z$1.core.$strip>;
+        id: z$1.ZodString;
+        logTail: z$1.ZodArray<z$1.ZodString>;
+        message: z$1.ZodNullable<z$1.ZodString>;
+        outcome: z$1.ZodEnum<{
+            failed: "failed";
+            updated: "updated";
+        }>;
+        phase: z$1.ZodNullable<z$1.ZodEnum<{
+            install: "install";
+            prepare: "prepare";
+            startup: "startup";
+        }>>;
+        to: z$1.ZodObject<{
+            commit: z$1.ZodNullable<z$1.ZodString>;
+            version: z$1.ZodString;
+        }, z$1.core.$strip>;
+    }, z$1.core.$strip>>;
+    runningThreadCount: z$1.ZodNumber;
+    support: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+        kind: z$1.ZodLiteral<"supported">;
+        mode: z$1.ZodEnum<{
+            npm: "npm";
+            source: "source";
+        }>;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+        kind: z$1.ZodLiteral<"unsupported">;
+        reason: z$1.ZodEnum<{
+            desktop: "desktop";
+            development: "development";
+            unmanaged: "unmanaged";
+        }>;
+    }, z$1.core.$strip>], "kind">;
+}, z$1.core.$strip>;
+type SystemAppUpdateStatus = z$1.infer<typeof systemAppUpdateStatusSchema>;
+declare const systemAppUpdateApplyRequestSchema: z$1.ZodObject<{
+    confirmInterruptingThreads: z$1.ZodBoolean;
+}, z$1.core.$strip>;
+type SystemAppUpdateApplyRequest = z$1.infer<typeof systemAppUpdateApplyRequestSchema>;
+declare const systemAppUpdateAcknowledgeRequestSchema: z$1.ZodObject<{
+    id: z$1.ZodString;
+}, z$1.core.$strip>;
+type SystemAppUpdateAcknowledgeRequest = z$1.infer<typeof systemAppUpdateAcknowledgeRequestSchema>;
 declare const systemConfigReloadResponseSchema: z$1.ZodObject<{
     ok: z$1.ZodLiteral<true>;
 }, z$1.core.$strip>;
@@ -15352,6 +15516,9 @@ interface HostRetryUpdateArgs {
 interface HostActionArgs {
     hostId: string;
 }
+interface HostReconnectArgs extends HostActionArgs {
+    signal?: AbortSignal;
+}
 interface HostDirectoryArgs extends HostDirectoryQuery {
     hostId: string;
     signal?: AbortSignal;
@@ -15391,6 +15558,7 @@ type HostGetResult = Host & {
     connectMachineId: string | null;
 };
 type HostEnrollmentCommandResult = HostEnrollmentCommandResponse;
+type HostReconnectResult = HostReconnectResponse;
 type HostCloneDefaultPathResult = HostCloneDefaultPathResponse;
 type HostProviderCliInstallResult = HostProviderCliInstallEvent[];
 type HostListResult = Host[];
@@ -15404,6 +15572,7 @@ type MachineProviderListResult = SystemMachineProvider[];
 interface HostsArea {
     experimental_create(args: MachineCreateArgs): Promise<Host>;
     experimental_getEnrollmentCommand(args: HostGetArgs): Promise<HostEnrollmentCommandResult>;
+    experimental_reconnect(args: HostReconnectArgs): Promise<HostReconnectResult>;
     /** @deprecated Use experimental_create() and experimental_getEnrollmentCommand() for bootstrap enrollment. */
     createJoinCode(): Promise<HostCreateJoinCodeResult>;
     delete(args: HostDeleteArgs): Promise<HostDeleteResult>;
@@ -15969,6 +16138,13 @@ interface SystemVersionArgs {
     force?: boolean;
     signal?: AbortSignal;
 }
+interface SystemAppUpdateArgs {
+    force?: boolean;
+    signal?: AbortSignal;
+}
+type SystemApplyAppUpdateArgs = SystemAppUpdateApplyRequest;
+type SystemAcknowledgeAppUpdateArgs = SystemAppUpdateAcknowledgeRequest;
+type SystemAppUpdateStatusResult = SystemAppUpdateStatus;
 interface SystemVoiceTranscriptionArgs {
     file: Blob;
     prompt?: string;
@@ -15976,6 +16152,13 @@ interface SystemVoiceTranscriptionArgs {
 }
 type SystemAttentionResult = SystemAttentionResponse;
 type SystemConfigResult = SystemConfigResponse;
+type SystemAiServicesResult = SystemAiServicesResponse;
+type SystemSetAiServiceSelectionArgs = SetAiServiceSelectionRequest;
+type SystemTestAiServiceArgs = TestAiServiceRequest;
+type SystemTestAiServiceResult = TestAiServiceResponse;
+interface SystemAiServicesArgs {
+    signal?: AbortSignal;
+}
 type SystemExecutionOptionsResult = SystemExecutionOptionsResponse;
 type SystemReloadConfigResult = SystemConfigReloadResponse;
 type SystemInstallCliSkillsArgs = SystemInstallCliSkillsRequest;
@@ -16022,12 +16205,15 @@ interface SystemArea {
     }): Promise<MachineEnvironmentList>;
     machineEnvironment(): Promise<MachineEnvironmentList>;
     replaceMachineEnvironment(input: MachineEnvironmentReplace): Promise<MachineEnvironmentList>;
+    aiServices(args?: SystemAiServicesArgs): Promise<SystemAiServicesResult>;
     attention(args?: SystemAttentionArgs): Promise<SystemAttentionResult>;
     config(args?: SystemConfigArgs): Promise<SystemConfigResult>;
     executionOptions(args?: SystemExecutionOptionsArgs): Promise<SystemExecutionOptionsResult>;
     cliSkillsStatus(args?: SystemCliSkillsStatusArgs): Promise<SystemCliSkillsStatusResult>;
     installCliSkills(args: SystemInstallCliSkillsArgs): Promise<SystemInstallCliSkillsResult>;
     reloadConfig(): Promise<SystemReloadConfigResult>;
+    setAiServiceSelection(args: SystemSetAiServiceSelectionArgs): Promise<SystemAiServicesResult>;
+    testAiService(args: SystemTestAiServiceArgs): Promise<SystemTestAiServiceResult>;
     transcribeVoice(args: SystemVoiceTranscriptionArgs): Promise<SystemVoiceTranscriptionResult>;
     uiPreferences: SystemUiPreferencesArea;
     updateExperiments(args: Experiments): Promise<SystemUpdateExperimentsResult>;
@@ -16036,6 +16222,9 @@ interface SystemArea {
     providerStates(args?: SystemProviderStatesArgs): Promise<SystemProviderStatesResult>;
     usageLimits(args?: SystemUsageLimitsArgs): Promise<SystemUsageLimitsResult>;
     version(args?: SystemVersionArgs): Promise<SystemVersionResult>;
+    appUpdate(args?: SystemAppUpdateArgs): Promise<SystemAppUpdateStatusResult>;
+    applyAppUpdate(args: SystemApplyAppUpdateArgs): Promise<SystemAppUpdateStatusResult>;
+    acknowledgeAppUpdate(args: SystemAcknowledgeAppUpdateArgs): Promise<SystemAppUpdateStatusResult>;
 }
 
 interface TerminalThreadScope {
@@ -16758,6 +16947,30 @@ interface PluginPendingInteractionProps {
     submit(value: JsonValue): Promise<void>;
     cancel(): Promise<void>;
 }
+/** Display and accessibility metadata for a host-owned answer shortcut. */
+interface ExperimentalQuestionShortcut {
+    label: string;
+    ariaKeyshortcuts: string;
+}
+/**
+ * The keyboard shortcuts bb binds while a pending interaction is open. The
+ * host owns the bindings (users can remap them); a form shows them and decides
+ * what choosing an option means.
+ */
+interface ExperimentalQuestionFormHost {
+    /**
+     * Shortcut per zero-based option index, as a string (`"0"` is the first
+     * option). Missing entries have no binding.
+     */
+    shortcuts: ReadonlyMap<string, ExperimentalQuestionShortcut>;
+    /**
+     * Receive the index of the option the person chose with a shortcut while
+     * the thread's pane is focused. Return true when the index names an option
+     * the form handled. The last registered handler wins; call the returned
+     * function to unregister.
+     */
+    registerChoiceHandler(handler: (index: number) => boolean): () => void;
+}
 /**
  * Props for a `sidebarFooterAction` — host-rendered (no plugin component).
  * Deliberately empty; the registration's `run` carries the behavior.
@@ -17928,7 +18141,7 @@ interface PluginSidebarThreadActions {
     setRead(threadId: string, read: boolean): Promise<void>;
     /** Silent rename — no dialog. For inline editing in your own row. */
     rename(threadId: string, title: string): Promise<void>;
-    /** Opens bb's confirmation before archiving the thread and its children. */
+    /** Archives immediately, or confirms first if child threads will also be archived. */
     archive(threadId: string): void;
     /**
      * Opens bb's delete confirmation, which counts child threads first. Deletion
@@ -19520,6 +19733,13 @@ interface PluginSdkApp {
      * docs/api_to_audit.md.
      */
     experimental_usePluginId(): string;
+    /**
+     * The answer shortcuts bb binds while a pending interaction is open. Inside
+     * a `pendingInteraction` component the form shows each option's shortcut and
+     * registers a handler that chooses the option; outside one, the map is empty
+     * and handlers never run. Experimental: see docs/api_to_audit.md.
+     */
+    experimental_useQuestionFormHost(): ExperimentalQuestionFormHost;
     useBbNavigate(): BbNavigate;
     /** Select one of this plugin's eligible fixed tabs on the current surface. */
     experimental_useAppPanel(): ExperimentalAppPanel;
@@ -19651,9 +19871,10 @@ interface PluginSdkApp {
      * surfaces without further work. Reserve `useRpc` for work that needs your
      * server: secrets, host files, or your plugin's own storage.
      *
-     * Writes made here are not optimistic in bb's surfaces; they land when the
-     * realtime update does. `experimental_useSidebarThreadActions()` stays the
-     * optimistic path for pin, read state, rename, and archive.
+     * Thread title, section, and parent updates are optimistic in bb's surfaces
+     * and synchronous calls are applied as one cache transaction. Other writes
+     * land when their realtime update does. `experimental_useSidebarThreadActions()`
+     * stays the optimistic path for pin, read state, rename, and archive.
      *
      * The client is stable for the plugin's lifetime, so it is safe in effect
      * and callback dependency lists.
@@ -21680,35 +21901,77 @@ interface PluginServerApi {
      */
     readonly experimental_dataDir: string;
 }
+/** Options for one `complete` call. */
+interface PluginAiCompleteOptions {
+    /**
+     * Aborted when bb stops waiting: the task timed out (5 seconds for titles
+     * and commit messages) or the request was cancelled. Pass it to `fetch`.
+     */
+    readonly signal: AbortSignal;
+}
+/** Options for one `transcribe` call. */
+interface PluginAiTranscribeOptions {
+    /** Aborted when bb stops waiting (10 seconds) or the request was cancelled. */
+    readonly signal: AbortSignal;
+    /**
+     * Vocabulary the speaker is likely to use (names, identifiers), for
+     * services that accept a transcription prompt; `null` when there is none.
+     */
+    readonly hint: string | null;
+}
 /**
- * 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,
- * a structured value out); `voice` transcribes recorded speech.
+ * Whether a service can answer right now. `message` is shown to the user
+ * beside the service ("Sign in to your bb account") and should say how to
+ * make it ready.
  */
-type PluginAiServiceKind = "inference" | "voice";
+type PluginAiServiceStatus = {
+    readonly ready: true;
+} | {
+    readonly ready: false;
+    readonly message: string;
+};
 /**
- * An AI service a plugin offers from its `bb.host` entry, which implements
- * `experimental_aiServicesHostContract` (`@get-bb/plugin-sdk/ai-services`).
- * The user selects it with `BB_INFERENCE` / `BB_TRANSCRIPTION` set to
- * `<id>/<model>`; core calls the plugin's host entry on the primary host with
- * the `id` on every request, so one entry can serve several services.
+ * An AI service bb can use for its helper tasks: thread titles and commit
+ * messages (`complete`) and voice input (`transcribe`). The user picks a
+ * service per task in Settings → AI services or with
+ * `bb settings ai-services set`. The functions run in the plugin's server
+ * process; a plugin that needs host-local state (a login file, a local model)
+ * reaches its own `bb.host` entry through `bb.hosts.experimental_client`.
+ *
+ * bb owns the prompts and cleans up replies (think blocks, quotes, labels,
+ * extra lines), so a service returns the model's text as-is. The plugin owns
+ * everything behind the function: which model, which API, any retries.
+ * Failure is a rejected promise.
  */
 interface PluginAiServiceDeclaration {
-    /** The `<serviceId>` segment of the user's setting; stable, lowercase. */
+    /**
+     * Stable, lowercase id, unique within this plugin. bb identifies a service
+     * by plugin id and service id, so another plugin may use the same id.
+     * `automatic` and `off` are reserved.
+     */
     readonly id: string;
-    /** Shown beside the id wherever the setting's options are listed. */
+    /** Shown in the picker; 1-64 characters. */
     readonly displayName: string;
-    /** Which kinds this service answers; a kind it lacks is not offered. */
-    readonly kinds: readonly PluginAiServiceKind[];
+    /**
+     * Answer one prompt with plain text. Offered for thread titles and commit
+     * messages. Declare `complete`, `transcribe`, or both.
+     */
+    readonly complete?: (prompt: string, options: PluginAiCompleteOptions) => Promise<string>;
+    /** Transcribe recorded speech to text. Offered for voice input. */
+    readonly transcribe?: (audio: File, options: PluginAiTranscribeOptions) => Promise<string>;
+    /**
+     * Report whether the service can answer. bb calls it for the picker's
+     * status line and to decide whether Automatic skips the service and
+     * whether the microphone shows; results are cached for a few seconds.
+     * Omit it when the service is always ready.
+     */
+    readonly status?: () => Promise<PluginAiServiceStatus>;
 }
 interface PluginAiServices {
     /**
      * Register an AI service. Call during the factory; the registration lands
-     * when the plugin load commits and is removed on reload or disable. The
-     * plugin must declare a `bb.host` entry; registering without one fails the
-     * load. A declared entry that fails to build fails the load on the build
-     * error after the factory, with any provider the factory declared listed
-     * as unavailable. Throws on an id another live plugin already serves.
+     * when the plugin load commits and is removed on reload or disable. Throws
+     * when this plugin already registered the id.
      */
     register(declaration: PluginAiServiceDeclaration): {
         dispose(): void;
@@ -21830,8 +22093,8 @@ interface BbPluginApi {
     /** Server-to-daemon host control-plane declarations. */
     readonly hosts: PluginHosts;
     /**
-     * AI services this plugin serves from its `bb.host` entry (helper
-     * inference, voice transcription). See `@get-bb/plugin-sdk/ai-services`.
+     * AI services this plugin offers for bb's helper tasks: thread titles,
+     * commit messages, and voice input.
      */
     readonly experimental_aiServices: PluginAiServices;
     /**
@@ -22096,4 +22359,4 @@ declare function cliCommand<const TOptions extends CliOptions = Record<string, n
 declare function defineCli(spec: PluginCliSpec): PluginCliRegistration;
 
 export { PLUGIN_CLI_OUTPUT_MAX_BYTES, PluginCliError, cliCommand, defineCli, defineRpcContract, experimental_defineHostEntry };
-export type { BbContext, BbNavigate, BbPluginApi, BranchPickerProps, BranchesState, CheckoutState, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppIcons, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSelection, 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, ExperimentalPluginBrowserPage, ExperimentalPluginBrowserPageEvaluateOptions, ExperimentalPluginBrowserPageWorld, ExperimentalPluginBrowserToolbarActionProps, ExperimentalPluginBrowserToolbarActionRegistration, ExperimentalPluginFixedTabReference, ExperimentalPluginMentionImage, ExperimentalPluginProviderEnvContext, ExperimentalPluginProviderEnvEntry, ExperimentalPluginProviderEnvHealth, ExperimentalPluginProviderEnvHealthContext, ExperimentalPluginWebSocket, ExperimentalPluginWebSocketContext, ExperimentalPluginWebSocketHandler, ExperimentalPluginWebSocketHandlers, ExperimentalProviderIconProps, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalSidebarFooter, ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterActionRegistration, ExperimentalSidebarFooterDisclosureController, ExperimentalSidebarFooterDisclosureProps, ExperimentalSidebarFooterDisclosureRegistration, ExperimentalSidebarFooterItemBase, ExperimentalSidebarFooterItemRegistration, ExperimentalSidebarHeaderProps, ExperimentalSidebarHeaderRegistration, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActions, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationIconProps, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, ExperimentalSidebarNavigationSplit, ExperimentalSidebarNavigationSplitOptions, ExperimentalSidebarNavigationState, JsonValue, MachineBootstrapApi, MachineBootstrapRequest, MachineExecutor, MachineExecutorRequest, MarkdownProps, MessageDispatchHookContext, MessageDispatchHookDecision, NewThreadComposerProps, NewThreadRequest, PluginAgentConfiguration, PluginAgentConfigurationContext, PluginAgentToolContentPart, PluginAgentToolContext, PluginAgentToolRegistrationBase, PluginAgentToolResult, PluginAgentToolSelection, PluginAgents, PluginAiServiceDeclaration, PluginAiServiceKind, PluginAiServices, PluginAppBuilder, PluginAppCommands, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginBackground, PluginBbSdk, PluginBoundThreadsArea, PluginBrowserBbSdk, PluginCli, PluginCliBooleanOption, PluginCliCommand, PluginCliCommandInfo, PluginCliConstraint, PluginCliContext, PluginCliDurationOption, PluginCliDurationUnit, PluginCliEnumOption, PluginCliErrorCode, PluginCliExecutionResult, PluginCliIntegerOption, PluginCliOption, PluginCliOptionValues, PluginCliOutputLimitError, PluginCliPositional, PluginCliPositionalValues, PluginCliRegistration, PluginCliResult, PluginCliRunInput, PluginCliSpec, PluginCliStringOption, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandContext, PluginCommandRegistration, PluginCommandShortcut, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginDispatchAttemptKind, PluginDispatchEnvironmentIntent, PluginDispatchExecution, PluginDispatchExecutionSources, PluginDispatchInput, PluginEnvironmentProvider, PluginEnvironmentProviderDeclaration, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, PluginEnvironmentProviderRequirements, PluginEnvironmentProvidersState, PluginEnvironmentValidateDecision, PluginEnvironments, PluginEvents, PluginFileOpenerProps, PluginFileOpenerRegistration, PluginFileOpenerSource, PluginFixedTabDeclaration, PluginFixedTabRegistration, PluginHomepageSectionProps, PluginHomepageSectionRegistration, PluginHookHandler, PluginHookName, PluginHookSignatures, PluginHooks, PluginHosts, PluginHttp, PluginHttpAuthMode, PluginHttpHandler, PluginInteractionCancelReason, PluginInteractionDescription, 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, PluginProviderCompletedTurnDisplay, PluginProviderComposerAction, PluginProviderDeclaration, PluginProviderExtensionKindDeclaration, PluginProviderFallbackModel, PluginProviderIconRegistration, PluginProviderMaintenance, PluginProviderModelCatalogScope, PluginProviderNativeRootEntry, PluginProviderNativeRoots, PluginProviderOptionDescriptor, PluginProviderOptionsContext, PluginProviderPermissionMode, PluginProviderReasoningLevel, PluginProviderStrings, PluginProviders, PluginProvidersState, PluginRealtime, PluginRealtimeConnectionState, PluginRowLabels, PluginRowPresentation, 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, PluginSidebarSection, PluginSidebarSplitLayout, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadDraftState, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadRowStatus, PluginSidebarThreadShortcut, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginStatusApi, PluginStorage, PluginTargetedPanelActionOpenOptions, PluginThreadEventHandler, PluginThreadEventName, PluginThreadEventPayloads, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginThreadTitleProps, 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, ExperimentalComposerSelection, 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, ExperimentalPluginBrowserPage, ExperimentalPluginBrowserPageEvaluateOptions, ExperimentalPluginBrowserPageWorld, ExperimentalPluginBrowserToolbarActionProps, ExperimentalPluginBrowserToolbarActionRegistration, ExperimentalPluginFixedTabReference, ExperimentalPluginMentionImage, ExperimentalPluginProviderEnvContext, ExperimentalPluginProviderEnvEntry, ExperimentalPluginProviderEnvHealth, ExperimentalPluginProviderEnvHealthContext, ExperimentalPluginWebSocket, ExperimentalPluginWebSocketContext, ExperimentalPluginWebSocketHandler, ExperimentalPluginWebSocketHandlers, 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, MachineBootstrapApi, MachineBootstrapRequest, MachineExecutor, MachineExecutorRequest, MarkdownProps, MessageDispatchHookContext, MessageDispatchHookDecision, NewThreadComposerProps, NewThreadRequest, PluginAgentConfiguration, PluginAgentConfigurationContext, PluginAgentToolContentPart, PluginAgentToolContext, PluginAgentToolRegistrationBase, PluginAgentToolResult, PluginAgentToolSelection, PluginAgents, PluginAiCompleteOptions, PluginAiServiceDeclaration, PluginAiServiceStatus, PluginAiServices, PluginAiTranscribeOptions, PluginAppBuilder, PluginAppCommands, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginBackground, PluginBbSdk, PluginBoundThreadsArea, PluginBrowserBbSdk, PluginCli, PluginCliBooleanOption, PluginCliCommand, PluginCliCommandInfo, PluginCliConstraint, PluginCliContext, PluginCliDurationOption, PluginCliDurationUnit, PluginCliEnumOption, PluginCliErrorCode, PluginCliExecutionResult, PluginCliIntegerOption, PluginCliOption, PluginCliOptionValues, PluginCliOutputLimitError, PluginCliPositional, PluginCliPositionalValues, PluginCliRegistration, PluginCliResult, PluginCliRunInput, PluginCliSpec, PluginCliStringOption, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandContext, PluginCommandRegistration, PluginCommandShortcut, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginDispatchAttemptKind, PluginDispatchEnvironmentIntent, PluginDispatchExecution, PluginDispatchExecutionSources, PluginDispatchInput, PluginEnvironmentProvider, PluginEnvironmentProviderDeclaration, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, PluginEnvironmentProviderRequirements, PluginEnvironmentProvidersState, PluginEnvironmentValidateDecision, PluginEnvironments, PluginEvents, PluginFileOpenerProps, PluginFileOpenerRegistration, PluginFileOpenerSource, PluginFixedTabDeclaration, PluginFixedTabRegistration, PluginHomepageSectionProps, PluginHomepageSectionRegistration, PluginHookHandler, PluginHookName, PluginHookSignatures, PluginHooks, PluginHosts, PluginHttp, PluginHttpAuthMode, PluginHttpHandler, PluginInteractionCancelReason, PluginInteractionDescription, 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, PluginProviderCompletedTurnDisplay, PluginProviderComposerAction, PluginProviderDeclaration, PluginProviderExtensionKindDeclaration, PluginProviderFallbackModel, PluginProviderIconRegistration, PluginProviderMaintenance, PluginProviderModelCatalogScope, PluginProviderNativeRootEntry, PluginProviderNativeRoots, PluginProviderOptionDescriptor, PluginProviderOptionsContext, PluginProviderPermissionMode, PluginProviderReasoningLevel, PluginProviderStrings, PluginProviders, PluginProvidersState, PluginRealtime, PluginRealtimeConnectionState, PluginRowLabels, PluginRowPresentation, 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, PluginSidebarSection, PluginSidebarSplitLayout, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadDraftState, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadRowStatus, PluginSidebarThreadShortcut, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginStatusApi, PluginStorage, PluginTargetedPanelActionOpenOptions, PluginThreadEventHandler, PluginThreadEventName, PluginThreadEventPayloads, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginThreadTitleProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, PluginTurnFailedEvent, PluginUi, ReadonlyJsonValue, ServerAccessGrant, ServerAccessProviderDeclaration, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps, UseBranchesArgs, UseCheckoutStateArgs };

package/dist/app.js

@@ -79,6 +79,9 @@ var useBbContext = runtimeFunction("useBbContext");
 var experimental_usePluginId = runtimeFunction(
   "experimental_usePluginId"
 );
+var experimental_useQuestionFormHost = runtimeFunction(
+  "experimental_useQuestionFormHost"
+);
 var useBbNavigate = runtimeFunction("useBbNavigate");
 var experimental_useAppPanel = runtimeFunction(
   "experimental_useAppPanel"
@@ -157,6 +160,7 @@ export {
   experimental_useFixedTabTarget,
   experimental_usePluginId,
   experimental_useProviders,
+  experimental_useQuestionFormHost,
   experimental_useSidebarNavigation,
   experimental_useSidebarNavigationSplit,
   experimental_useSidebarThreadActions,