@get-bb/plugin-sdk 0.5.15 → 0.5.23

package/README.md

@@ -178,13 +178,15 @@ slot.lifecycle.unmount();
 await scripts.lifecycle.dispose();
 ```
 
-`loadPluginApp` installs the runtime before a thunk import and validates all
-registrations. `mountPluginContentScripts` mirrors the host's ordered mount,
+`loadPluginApp` installs the runtime and validates all registrations; pass the
+imported module or a thunk. `@get-bb/plugin-sdk/app` exports look the runtime
+up when they are called or rendered, so a static import of `app.tsx` or of
+components works too. `mountPluginContentScripts` mirrors the host's ordered mount,
 rollback, independent per-window signal, and exact-once disposal. `renderSlot` supplies
 RPC, realtime, settings, navigation, context, and scoped composer behavior,
 then returns Testing Library queries plus the same behavior/inspection/lifecycle
-split. Use a setup-file `installTestPluginRuntime()` only when a static app
-import is unavoidable.
+split; it installs the runtime too. Call `installTestPluginRuntime()` yourself
+only when a test renders plugin components without `renderSlot`.
 
 ## Fidelity boundaries
 

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

@@ -275,6 +275,7 @@ declare const appKeybindingOverridesSchema: z$1.ZodArray<z$1.ZodObject<{
         "thread.previous": "thread.previous";
         "thread.rename": "thread.rename";
         "thread.search": "thread.search";
+        "window.find": "window.find";
         "window.new": "window.new";
         "workspace.openPreferred": "workspace.openPreferred";
     }>, z$1.ZodTemplateLiteral<`plugin:${string}/${string}`>]>;
@@ -428,6 +429,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";
@@ -518,10 +520,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>;
 
@@ -8963,6 +8963,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;
@@ -9650,6 +9656,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<{
@@ -9856,21 +9863,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<{
@@ -9964,6 +10043,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "thread.previous": "thread.previous";
             "thread.rename": "thread.rename";
             "thread.search": "thread.search";
+            "window.find": "window.find";
             "window.new": "window.new";
             "workspace.openPreferred": "workspace.openPreferred";
         }>, z$1.ZodTemplateLiteral<`plugin:${string}/${string}`>]>;
@@ -10008,10 +10088,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;
@@ -10107,6 +10185,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "thread.previous": "thread.previous";
             "thread.rename": "thread.rename";
             "thread.search": "thread.search";
+            "window.find": "window.find";
             "window.new": "window.new";
             "workspace.openPreferred": "workspace.openPreferred";
         }>, z$1.ZodTemplateLiteral<`plugin:${string}/${string}`>]>;
@@ -10190,6 +10269,7 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
             "thread.previous": "thread.previous";
             "thread.rename": "thread.rename";
             "thread.search": "thread.search";
+            "window.find": "window.find";
             "window.new": "window.new";
             "workspace.openPreferred": "workspace.openPreferred";
         }>, z$1.ZodTemplateLiteral<`plugin:${string}/${string}`>]>;
@@ -10317,6 +10397,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>;
@@ -15285,6 +15453,9 @@ interface HostRetryUpdateArgs {
 interface HostActionArgs {
     hostId: string;
 }
+interface HostReconnectArgs extends HostActionArgs {
+    signal?: AbortSignal;
+}
 interface HostDirectoryArgs extends HostDirectoryQuery {
     hostId: string;
     signal?: AbortSignal;
@@ -15324,6 +15495,7 @@ type HostGetResult = Host & {
     connectMachineId: string | null;
 };
 type HostEnrollmentCommandResult = HostEnrollmentCommandResponse;
+type HostReconnectResult = HostReconnectResponse;
 type HostCloneDefaultPathResult = HostCloneDefaultPathResponse;
 type HostProviderCliInstallResult = HostProviderCliInstallEvent[];
 type HostListResult = Host[];
@@ -15337,6 +15509,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>;
@@ -15902,6 +16075,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;
@@ -15909,6 +16089,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;
@@ -15955,12 +16142,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>;
@@ -15969,6 +16159,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 {
@@ -16602,6 +16795,30 @@ interface PluginPendingInteractionProps {
     submit(value: JsonValue$1): 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.
@@ -17772,7 +17989,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>;
-    /** Archives the thread AND its children, closing any panes showing them. */
+    /** 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
@@ -19355,6 +19572,22 @@ interface PluginSdkApp {
     useRealtimeConnectionState(): PluginRealtimeConnectionState;
     useSettings(): PluginSettingsState;
     useBbContext(): BbContext;
+    /**
+     * The id of the plugin that owns the calling component: the same id
+     * `bb.pluginId` reports on the server, derived from the package name. Key
+     * state the plugin keeps outside bb's per-plugin storage with it, such as
+     * localStorage entries and log prefixes, so a copy of the plugin published
+     * under another name does not collide with the original. Experimental: see
+     * 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;
@@ -19486,9 +19719,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.
@@ -19585,7 +19819,7 @@ interface PluginSdkApp {
 
 declare const experimental_Icon: react.ComponentType<ExperimentalIconProps>;
 declare const experimental_ProviderIcon: react.ComponentType<ExperimentalProviderIconProps>;
-declare const definePluginApp: (setup: PluginAppSetup) => PluginAppDefinition;
+declare const definePluginApp: PluginSdkApp["definePluginApp"];
 declare const ThreadChat: react.ComponentType<ThreadChatProps>;
 declare const Markdown: react.ComponentType<MarkdownProps>;
 declare const experimental_FileLink: react.ComponentType<ExperimentalFileLinkProps>;
@@ -19603,6 +19837,8 @@ declare const useRealtime: (channel: string, handler: (payload: unknown) => void
 declare const useRealtimeConnectionState: () => PluginRealtimeConnectionState;
 declare const useSettings: () => PluginSettingsState;
 declare const useBbContext: () => BbContext;
+declare const experimental_usePluginId: () => string;
+declare const experimental_useQuestionFormHost: () => ExperimentalQuestionFormHost;
 declare const useBbNavigate: () => BbNavigate;
 declare const experimental_useAppPanel: () => ExperimentalAppPanel;
 declare const experimental_useFixedTabTarget: <Target extends JsonValue$1>(tab: ExperimentalPluginFixedTabReference<Target>) => ExperimentalFixedTabTargetState<Target> | null;
@@ -19629,5 +19865,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_useProviders, 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, 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, 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 };