@get-bb/plugin-sdk 0.4.50 → 0.4.55

package/README.md

@@ -149,7 +149,8 @@ await host.harness.lifecycle.dispose();
 ```
 
 `makePluginAgentConfigurationContext`, `makeMessageDispatchHookContext`,
-`makeThreadResponse`, `makeQueueEntry`, and `makeTurnFailedEvent` return
+`makeHostResponse`, `makeThreadResponse`, `makeQueueEntry`, and
+`makeTurnFailedEvent` return
 complete deterministic SDK objects. Pass partial overrides so a behavioral
 test shows only the values relevant to its scenario. Nested context
 members merge partial overrides against complete defaults, so required contract

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

@@ -2394,6 +2394,14 @@ interface MarkdownProps {
     /** Markdown source, rendered exactly like a chat message body. */
     content: string;
     className?: string;
+    /** Resolve local destinations from this document; omission keeps message routing. */
+    experimental_document?: {
+        threadId: string;
+        rootPath: string;
+        target: Exclude<ExperimentalLiveFileTarget, {
+            kind: "host";
+        }>;
+    };
 }
 /**
  * Props for BB's semantic URL link. The host owns ordinary activation while

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

@@ -55,6 +55,7 @@ declare const environmentSchema: z.ZodObject<{
     path: z.ZodNullable<z.ZodString>;
     projectId: z.ZodString;
     status: z.ZodEnum<{
+        creating: "creating";
         destroyed: "destroyed";
         error: "error";
         provisioning: "provisioning";
@@ -183,7 +184,7 @@ interface PluginEnvironmentProviderValidateContext<R extends PluginEnvironmentPr
 }
 interface PluginEnvironmentProviderAvailabilityContext {
     project: Project;
-    host: Host | null;
+    host: Host;
     projectCheckout: {
         path: string;
     } | null;
@@ -221,7 +222,6 @@ type PluginEnvironmentProviderCreateResult = {
     resource?: JsonValue$1;
 } | {
     status: "failed";
-    failure: "terminal" | "transient";
     message: string;
 };
 interface PluginEnvironmentProviderRemoveContext {
@@ -256,7 +256,7 @@ interface PluginEnvironmentProviderDefinition<R extends PluginEnvironmentProvide
     requires?: R;
     inputs?: S;
     policy?: Partial<PluginEnvironmentProviderPolicy>;
-    /** Experimental: see docs/api_to_audit.md. */
+    /** Experimental per-machine availability, probed in the background for pickers and again at thread creation: see docs/api_to_audit.md. */
     availability?(context: PluginEnvironmentProviderAvailabilityContext): PluginEnvironmentProviderAvailability | Promise<PluginEnvironmentProviderAvailability>;
     validate?(context: PluginEnvironmentProviderValidateContext<R, S>): PluginEnvironmentValidateDecision | Promise<PluginEnvironmentValidateDecision>;
     create(context: PluginEnvironmentProviderCreateContext<R, S>): Promise<PluginEnvironmentProviderCreateResult>;

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

@@ -107,6 +107,7 @@ declare const environmentSchema: z.ZodObject<{
     path: z.ZodNullable<z.ZodString>;
     projectId: z.ZodString;
     status: z.ZodEnum<{
+        creating: "creating";
         destroyed: "destroyed";
         error: "error";
         provisioning: "provisioning";
@@ -509,7 +510,7 @@ interface PluginEnvironmentProviderValidateContext<R extends PluginEnvironmentPr
 }
 interface PluginEnvironmentProviderAvailabilityContext {
     project: Project;
-    host: Host | null;
+    host: Host;
     projectCheckout: {
         path: string;
     } | null;
@@ -547,7 +548,6 @@ type PluginEnvironmentProviderCreateResult = {
     resource?: JsonValue$2;
 } | {
     status: "failed";
-    failure: "terminal" | "transient";
     message: string;
 };
 interface PluginEnvironmentProviderRemoveContext {
@@ -582,7 +582,7 @@ interface PluginEnvironmentProviderDefinition<R extends PluginEnvironmentProvide
     requires?: R;
     inputs?: S;
     policy?: Partial<PluginEnvironmentProviderPolicy>;
-    /** Experimental: see docs/api_to_audit.md. */
+    /** Experimental per-machine availability, probed in the background for pickers and again at thread creation: see docs/api_to_audit.md. */
     availability?(context: PluginEnvironmentProviderAvailabilityContext): PluginEnvironmentProviderAvailability | Promise<PluginEnvironmentProviderAvailability>;
     validate?(context: PluginEnvironmentProviderValidateContext<R, S>): PluginEnvironmentValidateDecision | Promise<PluginEnvironmentValidateDecision>;
     create(context: PluginEnvironmentProviderCreateContext<R, S>): Promise<PluginEnvironmentProviderCreateResult>;
@@ -690,11 +690,10 @@ type PluginSettingValue = string | number | boolean;
  *   that machine, git or not, so core refuses a machine with no checkout of
  *   the project at create time and `context.projectCheckout` is non-null.
  * - `gitCheckout` — that directory must also be a git repository with at
- *   least one commit. The picker greys the row out where it is not, and core
- *   rejects an explicit selection using the same machine inspection before
- *   creating the thread. Implies `projectCheckout`.
- * - `gitRemote` — the provider clones the project itself, so it is greyed out
- *   in a project with no git remote and an explicit selection is rejected.
+ *   least one commit. Core inspects the selected machine and rejects an
+ *   invalid selection before creating the thread. Implies `projectCheckout`.
+ * - `gitRemote` — the provider clones the project itself, so an explicit
+ *   selection is rejected when the project has no git remote.
  * - `projectless` — this provider serves only threads that have no project,
  *   so it is offered for those and nowhere else. It cannot be combined with
  *   `projectCheckout`, `gitCheckout` or `gitRemote`, which need a project.

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

@@ -107,6 +107,7 @@ declare const environmentSchema: z.ZodObject<{
     path: z.ZodNullable<z.ZodString>;
     projectId: z.ZodString;
     status: z.ZodEnum<{
+        creating: "creating";
         destroyed: "destroyed";
         error: "error";
         provisioning: "provisioning";
@@ -238,7 +239,7 @@ interface PluginEnvironmentProviderValidateContext<R extends PluginEnvironmentPr
 }
 interface PluginEnvironmentProviderAvailabilityContext {
     project: Project;
-    host: Host | null;
+    host: Host;
     projectCheckout: {
         path: string;
     } | null;
@@ -276,7 +277,6 @@ type PluginEnvironmentProviderCreateResult = {
     resource?: JsonValue$2;
 } | {
     status: "failed";
-    failure: "terminal" | "transient";
     message: string;
 };
 interface PluginEnvironmentProviderRemoveContext {
@@ -311,7 +311,7 @@ interface PluginEnvironmentProviderDefinition<R extends PluginEnvironmentProvide
     requires?: R;
     inputs?: S;
     policy?: Partial<PluginEnvironmentProviderPolicy>;
-    /** Experimental: see docs/api_to_audit.md. */
+    /** Experimental per-machine availability, probed in the background for pickers and again at thread creation: see docs/api_to_audit.md. */
     availability?(context: PluginEnvironmentProviderAvailabilityContext): PluginEnvironmentProviderAvailability | Promise<PluginEnvironmentProviderAvailability>;
     validate?(context: PluginEnvironmentProviderValidateContext<R, S>): PluginEnvironmentValidateDecision | Promise<PluginEnvironmentValidateDecision>;
     create(context: PluginEnvironmentProviderCreateContext<R, S>): Promise<PluginEnvironmentProviderCreateResult>;
@@ -369,11 +369,10 @@ type PluginSettingValue = string | number | boolean;
  *   that machine, git or not, so core refuses a machine with no checkout of
  *   the project at create time and `context.projectCheckout` is non-null.
  * - `gitCheckout` — that directory must also be a git repository with at
- *   least one commit. The picker greys the row out where it is not, and core
- *   rejects an explicit selection using the same machine inspection before
- *   creating the thread. Implies `projectCheckout`.
- * - `gitRemote` — the provider clones the project itself, so it is greyed out
- *   in a project with no git remote and an explicit selection is rejected.
+ *   least one commit. Core inspects the selected machine and rejects an
+ *   invalid selection before creating the thread. Implies `projectCheckout`.
+ * - `gitRemote` — the provider clones the project itself, so an explicit
+ *   selection is rejected when the project has no git remote.
  * - `projectless` — this provider serves only threads that have no project,
  *   so it is offered for those and nowhere else. It cannot be combined with
  *   `projectCheckout`, `gitCheckout` or `gitRemote`, which need a project.
@@ -1152,6 +1151,7 @@ interface FakePluginHost {
 }
 declare function createFakePluginHost(options?: CreateFakePluginHostOptions): FakePluginHost;
 
+type HostResponse = Awaited<ReturnType<BbPluginApi["sdk"]["hosts"]["list"]>>[number];
 type ThreadResponse = PluginThreadEventPayloads["thread.created"]["thread"];
 type QueueEntry = PluginThreadEventPayloads["message.queued"]["entry"];
 type TurnFailedEvent = PluginThreadEventPayloads["turn.failed"];
@@ -1175,6 +1175,13 @@ type MessageDispatchHookContextOverrides = Omit<Partial<MessageDispatchHookConte
     executionSources?: Partial<MessageDispatchHookContext["executionSources"]>;
     queuedMessage?: Partial<NonNullable<MessageDispatchHookContext["queuedMessage"]>> | null;
 };
+/**
+ * A complete, deterministic host response for faking `bb.sdk.hosts.list()`
+ * and environment-provider contexts. Override only the fields the test cares
+ * about. If the contract grows a required field, this builder fails
+ * typecheck — update the default here.
+ */
+declare function makeHostResponse(overrides?: Partial<HostResponse>): HostResponse;
 /**
  * A complete, deterministic `ThreadResponse` for thread lifecycle event
  * payloads (`harness.emitThreadEvent`). Defaults are the minimal idle
@@ -1242,5 +1249,5 @@ interface PublicSdkOnlyScan {
  */
 declare function scanPublicSdkOnly(packageRoot: string, options?: PublicSdkOnlyScanOptions): PublicSdkOnlyScan;
 
-export { PluginContextStaleError, createFakePluginHost, createFakeSdk, scanPublicSdkOnly as experimental_scanPublicSdkOnly, makeMessageDispatchHookContext, makePluginAgentConfigurationContext, makeQueueEntry, makeThreadResponse, makeTurnFailedEvent };
+export { PluginContextStaleError, createFakePluginHost, createFakeSdk, scanPublicSdkOnly as experimental_scanPublicSdkOnly, makeHostResponse, makeMessageDispatchHookContext, makePluginAgentConfigurationContext, makeQueueEntry, makeThreadResponse, makeTurnFailedEvent };
 export type { CreateFakePluginHostOptions, ExperimentalFakeHostRpcCall, FakeAgentToolRecord, FakeCliRecord, FakeHttpRouteRecord, FakeLogEntry, FakeLogLevel, FakeMentionProviderRecord, FakePluginBehaviorDrivers, FakePluginHarness, FakePluginHost, FakePluginInspectionState, FakePluginLifecycleControls, FakePluginRegistrations, FakeRealtimeSignal, FakeScheduleRecord, FakeSdkCall, FakeSdkHarness, FakeSdkOverrides, FakeServiceRecord, PublicSdkOnlyScan, PublicSdkOnlyScanOptions, PublicSdkOnlyViolation };

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

@@ -73,6 +73,56 @@ declare const appSettingsUpdateSchema: z$1.ZodUnion<readonly [z$1.ZodObject<{
 }, z$1.core.$strict>]>;
 type AppSettingsUpdate = z$1.infer<typeof appSettingsUpdateSchema>;
 
+declare const UI_PREFERENCE_KEYS: readonly ["sidebar.organizationMode", "sidebar.chronologicalSort", "sidebar.sortDirection", "sidebar.sectionOrder", "sidebar.manualSectionOrder", "sidebar.machineSectionOrder", "sidebar.collapsedSections", "sidebar.collapsedProjects", "sidebar.collapsedThreads", "sidebar.collapsedEnvironments", "sidebar.collapsedThreadSections", "sidebar.collapsedMachines", "sidebar.pluginPanelOrder", "sidebar.visiblePluginPanels", "sidebar.navigationProvider", "sidebar.threadListProvider"];
+type UiPreferenceKey = (typeof UI_PREFERENCE_KEYS)[number];
+interface UiPreferenceDefinition<Schema extends z$1.ZodTypeAny = z$1.ZodTypeAny> {
+    schema: Schema;
+    defaultValue: z$1.infer<Schema>;
+    description: string;
+}
+declare const uiPreferenceDefinitions: {
+    readonly "sidebar.organizationMode": UiPreferenceDefinition<z$1.ZodEnum<{
+        chronological: "chronological";
+        machine: "machine";
+        project: "project";
+    }>>;
+    readonly "sidebar.chronologicalSort": UiPreferenceDefinition<z$1.ZodEnum<{
+        alpha: "alpha";
+        created: "created";
+        none: "none";
+        updated: "updated";
+    }>>;
+    readonly "sidebar.sortDirection": UiPreferenceDefinition<z$1.ZodEnum<{
+        ascending: "ascending";
+        default: "default";
+        descending: "descending";
+    }>>;
+    readonly "sidebar.sectionOrder": UiPreferenceDefinition<z$1.ZodArray<z$1.ZodString>>;
+    readonly "sidebar.manualSectionOrder": UiPreferenceDefinition<z$1.ZodArray<z$1.ZodString>>;
+    readonly "sidebar.machineSectionOrder": UiPreferenceDefinition<z$1.ZodArray<z$1.ZodString>>;
+    readonly "sidebar.collapsedSections": UiPreferenceDefinition<z$1.ZodArray<z$1.ZodEnum<{
+        pinned: "pinned";
+        threads: "threads";
+    }>>>;
+    readonly "sidebar.collapsedProjects": UiPreferenceDefinition<z$1.ZodArray<z$1.ZodString>>;
+    readonly "sidebar.collapsedThreads": UiPreferenceDefinition<z$1.ZodArray<z$1.ZodString>>;
+    readonly "sidebar.collapsedEnvironments": UiPreferenceDefinition<z$1.ZodArray<z$1.ZodString>>;
+    readonly "sidebar.collapsedThreadSections": UiPreferenceDefinition<z$1.ZodArray<z$1.ZodString>>;
+    readonly "sidebar.collapsedMachines": UiPreferenceDefinition<z$1.ZodArray<z$1.ZodString>>;
+    readonly "sidebar.pluginPanelOrder": UiPreferenceDefinition<z$1.ZodArray<z$1.ZodString>>;
+    readonly "sidebar.visiblePluginPanels": UiPreferenceDefinition<z$1.ZodNullable<z$1.ZodArray<z$1.ZodString>>>;
+    readonly "sidebar.navigationProvider": UiPreferenceDefinition<z$1.ZodString>;
+    readonly "sidebar.threadListProvider": UiPreferenceDefinition<z$1.ZodString>;
+};
+type UiPreferenceValue<Key extends UiPreferenceKey> = z$1.infer<(typeof uiPreferenceDefinitions)[Key]["schema"]>;
+interface UiPreferenceEntry<Key extends UiPreferenceKey = UiPreferenceKey> {
+    revision: number;
+    value: UiPreferenceValue<Key>;
+}
+type UiPreferenceEntries = {
+    [Key in UiPreferenceKey]: UiPreferenceEntry<Key>;
+};
+
 declare const appKeybindingOverridesSchema: z$1.ZodArray<z$1.ZodObject<{
     command: z$1.ZodEnum<{
         "app.back": "app.back";
@@ -289,8 +339,10 @@ declare const changedMessageSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
 }, z$1.core.$strict>, z$1.ZodObject<{
     changes: z$1.ZodReadonly<z$1.ZodArray<z$1.ZodEnum<{
         "config-changed": "config-changed";
+        "environment-availability-changed": "environment-availability-changed";
         "plugins-changed": "plugins-changed";
         "provider-registrations-changed": "provider-registrations-changed";
+        "ui-preferences-changed": "ui-preferences-changed";
     }>>>;
     entity: z$1.ZodLiteral<"system">;
     type: z$1.ZodLiteral<"changed">;
@@ -298,6 +350,7 @@ declare const changedMessageSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
 type ChangedMessage = z$1.infer<typeof changedMessageSchema>;
 
 declare const environmentStatusSchema: z$1.ZodEnum<{
+    creating: "creating";
     destroyed: "destroyed";
     error: "error";
     provisioning: "provisioning";
@@ -358,6 +411,7 @@ declare const environmentSchema: z$1.ZodObject<{
     path: z$1.ZodNullable<z$1.ZodString>;
     projectId: z$1.ZodString;
     status: z$1.ZodEnum<{
+        creating: "creating";
         destroyed: "destroyed";
         error: "error";
         provisioning: "provisioning";
@@ -374,7 +428,6 @@ type Environment = z$1.infer<typeof environmentSchema>;
 
 declare const experimentsSchema: z$1.ZodRecord<z$1.ZodEnum<{
     changelogPreview: "changelogPreview";
-    editMessages: "editMessages";
     mobileApp: "mobileApp";
     sidebarProgressiveDisclosure: "sidebarProgressiveDisclosure";
     timelineWindowing: "timelineWindowing";
@@ -5585,6 +5638,82 @@ declare const hostDaemonCommandRegistry: {
     }, z$1.core.$strict>, z$1.ZodObject<{
         ok: z$1.ZodLiteral<true>;
     }, z$1.core.$strip>, "onlineRpc", false>;
+    "desktop.browser.list_import_sources": HostDaemonCommandDescriptor<"desktop.browser.list_import_sources", z$1.ZodObject<{
+        generation: z$1.ZodString;
+        instanceId: z$1.ZodString;
+        type: z$1.ZodLiteral<"desktop.browser.list_import_sources">;
+    }, z$1.core.$strict>, z$1.ZodObject<{
+        sources: z$1.ZodArray<z$1.ZodObject<{
+            icon: z$1.ZodOptional<z$1.ZodString>;
+            id: z$1.ZodEnum<{
+                arc: "arc";
+                brave: "brave";
+                chrome: "chrome";
+                chromium: "chromium";
+                edge: "edge";
+                firefox: "firefox";
+                opera: "opera";
+                safari: "safari";
+                vivaldi: "vivaldi";
+            }>;
+            name: z$1.ZodString;
+            profiles: z$1.ZodArray<z$1.ZodObject<{
+                cookieCount: z$1.ZodOptional<z$1.ZodNumber>;
+                directory: z$1.ZodString;
+                name: z$1.ZodString;
+            }, z$1.core.$strict>>;
+            unavailable: z$1.ZodOptional<z$1.ZodEnum<{
+                browserRunning: "browserRunning";
+                keychainItemMissing: "keychainItemMissing";
+                needsFullDiskAccess: "needsFullDiskAccess";
+                needsKeychainApproval: "needsKeychainApproval";
+                notInstalled: "notInstalled";
+                unsupportedPlatform: "unsupportedPlatform";
+            }>>;
+        }, z$1.core.$strict>>;
+    }, z$1.core.$strip>, "onlineRpc", false>;
+    "desktop.browser.import_cookies": HostDaemonCommandDescriptor<"desktop.browser.import_cookies", z$1.ZodObject<{
+        generation: z$1.ZodString;
+        instanceId: z$1.ZodString;
+        profile: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+            id: z$1.ZodString;
+            kind: z$1.ZodLiteral<"automation">;
+        }, z$1.core.$strip>, z$1.ZodObject<{
+            kind: z$1.ZodLiteral<"personal">;
+        }, z$1.core.$strip>], "kind">;
+        sourceId: z$1.ZodEnum<{
+            arc: "arc";
+            brave: "brave";
+            chrome: "chrome";
+            chromium: "chromium";
+            edge: "edge";
+            firefox: "firefox";
+            opera: "opera";
+            safari: "safari";
+            vivaldi: "vivaldi";
+        }>;
+        sourceProfileDirectory: z$1.ZodString;
+        type: z$1.ZodLiteral<"desktop.browser.import_cookies">;
+    }, z$1.core.$strict>, z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+        imported: z$1.ZodNumber;
+        ok: z$1.ZodLiteral<true>;
+        skipped: z$1.ZodNumber;
+        skippedDomains: z$1.ZodArray<z$1.ZodString>;
+    }, z$1.core.$strict>, z$1.ZodObject<{
+        ok: z$1.ZodLiteral<false>;
+        reason: z$1.ZodEnum<{
+            browserRunning: "browserRunning";
+            keychainItemMissing: "keychainItemMissing";
+            keychainUnavailable: "keychainUnavailable";
+            needsFullDiskAccess: "needsFullDiskAccess";
+            needsKeychainApproval: "needsKeychainApproval";
+            notInstalled: "notInstalled";
+            readFailed: "readFailed";
+            unknownSource: "unknownSource";
+            unknownSourceProfile: "unknownSourceProfile";
+            unsupportedPlatform: "unsupportedPlatform";
+        }>;
+    }, z$1.core.$strict>], "ok">, "onlineRpc", false>;
     "thread.rewind.discard": HostDaemonCommandDescriptor<"thread.rewind.discard", z$1.ZodObject<{
         environmentId: z$1.ZodString;
         leaseId: z$1.ZodString;
@@ -6753,6 +6882,7 @@ declare const hostDaemonCommandRegistry: {
             threadId: z$1.ZodString;
         }, z$1.core.$strict>>;
         path: z$1.ZodString;
+        setupScriptTimeoutMs: z$1.ZodNullable<z$1.ZodNumber>;
         type: z$1.ZodLiteral<"environment.attach">;
     }, z$1.core.$strict>, z$1.ZodObject<{
         branchName: z$1.ZodNullable<z$1.ZodString>;
@@ -6815,9 +6945,12 @@ declare const hostDaemonCommandRegistry: {
         }, z$1.core.$strip>;
     }, z$1.core.$strict>], "operation">, z$1.ZodObject<{}, z$1.core.$strict>, "settled", false>;
     "host.list_files": HostDaemonCommandDescriptor<"host.list_files", z$1.ZodObject<{
+        excludeNames: z$1.ZodArray<z$1.ZodString>;
+        includeHidden: z$1.ZodBoolean;
         limit: z$1.ZodNumber;
         path: z$1.ZodString;
         query: z$1.ZodOptional<z$1.ZodString>;
+        respectGitIgnore: z$1.ZodBoolean;
         type: z$1.ZodLiteral<"host.list_files">;
     }, z$1.core.$strip>, z$1.ZodObject<{
         files: z$1.ZodArray<z$1.ZodObject<{
@@ -6827,11 +6960,14 @@ declare const hostDaemonCommandRegistry: {
         truncated: z$1.ZodBoolean;
     }, z$1.core.$strip>, "onlineRpc", true>;
     "host.list_paths": HostDaemonCommandDescriptor<"host.list_paths", z$1.ZodObject<{
+        excludeNames: z$1.ZodArray<z$1.ZodString>;
         includeDirectories: z$1.ZodBoolean;
         includeFiles: z$1.ZodBoolean;
+        includeHidden: z$1.ZodBoolean;
         limit: z$1.ZodNumber;
         path: z$1.ZodString;
         query: z$1.ZodOptional<z$1.ZodString>;
+        respectGitIgnore: z$1.ZodBoolean;
         type: z$1.ZodLiteral<"host.list_paths">;
     }, z$1.core.$strip>, z$1.ZodObject<{
         paths: z$1.ZodArray<z$1.ZodObject<{
@@ -8176,6 +8312,32 @@ declare const desktopBrowserCommandSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObj
     leaseId: z$1.ZodString;
     threadId: z$1.ZodString;
     type: z$1.ZodLiteral<"desktop.browser.release_control">;
+}, z$1.core.$strict>, z$1.ZodObject<{
+    generation: z$1.ZodString;
+    instanceId: z$1.ZodString;
+    type: z$1.ZodLiteral<"desktop.browser.list_import_sources">;
+}, z$1.core.$strict>, z$1.ZodObject<{
+    generation: z$1.ZodString;
+    instanceId: z$1.ZodString;
+    profile: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+        id: z$1.ZodString;
+        kind: z$1.ZodLiteral<"automation">;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+        kind: z$1.ZodLiteral<"personal">;
+    }, z$1.core.$strip>], "kind">;
+    sourceId: z$1.ZodEnum<{
+        arc: "arc";
+        brave: "brave";
+        chrome: "chrome";
+        chromium: "chromium";
+        edge: "edge";
+        firefox: "firefox";
+        opera: "opera";
+        safari: "safari";
+        vivaldi: "vivaldi";
+    }>;
+    sourceProfileDirectory: z$1.ZodString;
+    type: z$1.ZodLiteral<"desktop.browser.import_cookies">;
 }, z$1.core.$strict>], "type">;
 declare const desktopBrowserResultSchemas: {
     "desktop.browser.list_instances": z$1.ZodObject<{
@@ -8257,6 +8419,56 @@ declare const desktopBrowserResultSchemas: {
     "desktop.browser.release_control": z$1.ZodObject<{
         ok: z$1.ZodLiteral<true>;
     }, z$1.core.$strip>;
+    "desktop.browser.list_import_sources": z$1.ZodObject<{
+        sources: z$1.ZodArray<z$1.ZodObject<{
+            icon: z$1.ZodOptional<z$1.ZodString>;
+            id: z$1.ZodEnum<{
+                arc: "arc";
+                brave: "brave";
+                chrome: "chrome";
+                chromium: "chromium";
+                edge: "edge";
+                firefox: "firefox";
+                opera: "opera";
+                safari: "safari";
+                vivaldi: "vivaldi";
+            }>;
+            name: z$1.ZodString;
+            profiles: z$1.ZodArray<z$1.ZodObject<{
+                cookieCount: z$1.ZodOptional<z$1.ZodNumber>;
+                directory: z$1.ZodString;
+                name: z$1.ZodString;
+            }, z$1.core.$strict>>;
+            unavailable: z$1.ZodOptional<z$1.ZodEnum<{
+                browserRunning: "browserRunning";
+                keychainItemMissing: "keychainItemMissing";
+                needsFullDiskAccess: "needsFullDiskAccess";
+                needsKeychainApproval: "needsKeychainApproval";
+                notInstalled: "notInstalled";
+                unsupportedPlatform: "unsupportedPlatform";
+            }>>;
+        }, z$1.core.$strict>>;
+    }, z$1.core.$strip>;
+    "desktop.browser.import_cookies": z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+        imported: z$1.ZodNumber;
+        ok: z$1.ZodLiteral<true>;
+        skipped: z$1.ZodNumber;
+        skippedDomains: z$1.ZodArray<z$1.ZodString>;
+    }, z$1.core.$strict>, z$1.ZodObject<{
+        ok: z$1.ZodLiteral<false>;
+        reason: z$1.ZodEnum<{
+            browserRunning: "browserRunning";
+            keychainItemMissing: "keychainItemMissing";
+            keychainUnavailable: "keychainUnavailable";
+            needsFullDiskAccess: "needsFullDiskAccess";
+            needsKeychainApproval: "needsKeychainApproval";
+            notInstalled: "notInstalled";
+            readFailed: "readFailed";
+            unknownSource: "unknownSource";
+            unknownSourceProfile: "unknownSourceProfile";
+            unsupportedPlatform: "unsupportedPlatform";
+        }>;
+    }, z$1.core.$strict>], "ok">;
 };
 type DesktopBrowserCommand = z$1.infer<typeof desktopBrowserCommandSchema>;
 type DesktopBrowserCommandType = DesktopBrowserCommand["type"];
@@ -8483,6 +8695,7 @@ declare const installedPluginSchema: z$1.ZodObject<{
         incompatible: "incompatible";
         missing: "missing";
         running: "running";
+        starting: "starting";
     }>;
     statusDetail: z$1.ZodNullable<z$1.ZodString>;
     updateState: z$1.ZodObject<{
@@ -8602,6 +8815,7 @@ declare const pluginListResponseSchema: z$1.ZodObject<{
             incompatible: "incompatible";
             missing: "missing";
             running: "running";
+            starting: "starting";
         }>;
         statusDetail: z$1.ZodNullable<z$1.ZodString>;
         updateState: z$1.ZodObject<{
@@ -8723,6 +8937,7 @@ declare const pluginReloadResponseSchema: z$1.ZodObject<{
             incompatible: "incompatible";
             missing: "missing";
             running: "running";
+            starting: "starting";
         }>;
         statusDetail: z$1.ZodNullable<z$1.ZodString>;
         updateState: z$1.ZodObject<{
@@ -9301,7 +9516,6 @@ declare const systemConfigResponseSchema: z$1.ZodObject<{
     }, z$1.core.$strict>>;
     experiments: z$1.ZodRecord<z$1.ZodEnum<{
         changelogPreview: "changelogPreview";
-        editMessages: "editMessages";
         mobileApp: "mobileApp";
         sidebarProgressiveDisclosure: "sidebarProgressiveDisclosure";
         timelineWindowing: "timelineWindowing";
@@ -9616,6 +9830,15 @@ declare const systemEnvironmentProviderSchema: z$1.ZodObject<{
     id: z$1.ZodString;
     inputs: z$1.ZodNullable<z$1.ZodType<JsonValue$1, unknown, z$1.core.$ZodTypeInternals<JsonValue$1, unknown>>>;
     logoUrl: z$1.ZodNullable<z$1.ZodString>;
+    machineAvailability: z$1.ZodRecord<z$1.ZodString, z$1.ZodNullable<z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+        status: z$1.ZodLiteral<"available">;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+        message: z$1.ZodString;
+        status: z$1.ZodLiteral<"setup-required">;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+        message: z$1.ZodString;
+        status: z$1.ZodLiteral<"unavailable">;
+    }, z$1.core.$strip>], "status">>>;
     pluginId: z$1.ZodString;
     requires: z$1.ZodObject<{
         gitCheckout: z$1.ZodBoolean;
@@ -9626,6 +9849,15 @@ declare const systemEnvironmentProviderSchema: z$1.ZodObject<{
 }, z$1.core.$strip>;
 type SystemEnvironmentProvider = z$1.infer<typeof systemEnvironmentProviderSchema>;
 
+interface UiPreferencesResponse {
+    preferences: UiPreferenceEntries;
+}
+interface UiPreferenceResponse<Key extends UiPreferenceKey = UiPreferenceKey> {
+    key: Key;
+    revision: number;
+    value: UiPreferenceValue<Key>;
+}
+
 declare const terminalSessionSchema: z$1.ZodObject<{
     closeReason: z$1.ZodNullable<z$1.ZodEnum<{
         "daemon-disconnect": "daemon-disconnect";
@@ -12466,6 +12698,7 @@ declare const threadWithIncludesResponseSchema: z$1.ZodObject<{
         path: z$1.ZodNullable<z$1.ZodString>;
         projectId: z$1.ZodString;
         status: z$1.ZodEnum<{
+            creating: "creating";
             destroyed: "destroyed";
             error: "error";
             provisioning: "provisioning";
@@ -13096,6 +13329,7 @@ declare const threadTimelineQuerySchema: z$1.ZodObject<{
 }, z$1.core.$strip>;
 type ThreadTimelineQuery = z$1.infer<typeof threadTimelineQuerySchema>;
 declare const timelineTurnSummaryDetailsQuerySchema: z$1.ZodObject<{
+    beforeCursor: z$1.ZodOptional<z$1.ZodString>;
     sourceSeqEnd: z$1.ZodString;
     sourceSeqStart: z$1.ZodString;
     turnId: z$1.ZodString;
@@ -13125,6 +13359,8 @@ declare const threadStorageLocationResponseSchema: z$1.ZodObject<{
 }, z$1.core.$strict>;
 type ThreadStorageLocationResponse = z$1.infer<typeof threadStorageLocationResponseSchema>;
 declare const timelineTurnSummaryDetailsResponseSchema: z$1.ZodObject<{
+    historySnapshot: z$1.ZodOptional<z$1.ZodString>;
+    olderCursor: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodString>>;
     rows: z$1.ZodArray<z$1.ZodType<TimelineRow, unknown, z$1.core.$ZodTypeInternals<TimelineRow, unknown>>>;
 }, z$1.core.$strip>;
 type TimelineTurnSummaryDetailsResponse = z$1.infer<typeof timelineTurnSummaryDetailsResponseSchema>;
@@ -13391,7 +13627,14 @@ declare const threadTimelineResponseSchema: z$1.ZodObject<{
     }, z$1.core.$strip>>;
     rows: z$1.ZodArray<z$1.ZodType<TimelineRow, unknown, z$1.core.$ZodTypeInternals<TimelineRow, unknown>>>;
     timelinePage: z$1.ZodObject<{
+        contentPage: z$1.ZodOptional<z$1.ZodObject<{
+            anchorSeq: z$1.ZodNumber;
+            end: z$1.ZodNumber;
+            start: z$1.ZodNumber;
+            total: z$1.ZodNumber;
+        }, z$1.core.$strip>>;
         hasOlderRows: z$1.ZodBoolean;
+        historySnapshot: z$1.ZodOptional<z$1.ZodString>;
         kind: z$1.ZodEnum<{
             latest: "latest";
             older: "older";
@@ -13490,6 +13733,34 @@ declare const desktopBrowserLeaseRequestSchema: z$1.ZodObject<{
     leaseId: z$1.ZodString;
     threadId: z$1.ZodString;
 }, z$1.core.$strict>;
+declare const desktopBrowserInstanceRequestSchema: z$1.ZodObject<{
+    generation: z$1.ZodString;
+    hostId: z$1.ZodString;
+    instanceId: z$1.ZodString;
+}, z$1.core.$strict>;
+declare const desktopBrowserImportCookiesRequestSchema: z$1.ZodObject<{
+    generation: z$1.ZodString;
+    hostId: z$1.ZodString;
+    instanceId: z$1.ZodString;
+    profile: z$1.ZodDefault<z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
+        id: z$1.ZodString;
+        kind: z$1.ZodLiteral<"automation">;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+        kind: z$1.ZodLiteral<"personal">;
+    }, z$1.core.$strip>], "kind">>;
+    sourceId: z$1.ZodEnum<{
+        arc: "arc";
+        brave: "brave";
+        chrome: "chrome";
+        chromium: "chromium";
+        edge: "edge";
+        firefox: "firefox";
+        opera: "opera";
+        safari: "safari";
+        vivaldi: "vivaldi";
+    }>;
+    sourceProfileDirectory: z$1.ZodString;
+}, z$1.core.$strict>;
 type ExperimentalDesktopBrowserHostRequest = z$1.infer<typeof desktopBrowserHostRequestSchema>;
 type ExperimentalDesktopBrowserScope = z$1.infer<typeof desktopBrowserScopeSchema>;
 type ExperimentalDesktopBrowserTabRequest = z$1.infer<typeof desktopBrowserTabRequestSchema>;
@@ -13515,6 +13786,10 @@ type ExperimentalDesktopBrowserConnection = {
     wsEndpoint: string;
     expiresAt: number;
 };
+type ExperimentalDesktopBrowserInstanceRequest = z$1.infer<typeof desktopBrowserInstanceRequestSchema>;
+type ExperimentalDesktopBrowserImportCookiesInput = z$1.input<typeof desktopBrowserImportCookiesRequestSchema>;
+type ExperimentalDesktopBrowserImportSources = DesktopBrowserResult<"desktop.browser.list_import_sources">;
+type ExperimentalDesktopBrowserImportOutcome = DesktopBrowserResult<"desktop.browser.import_cookies">;
 
 declare const threadTabsResponseSchema: z$1.ZodObject<{
     revision: z$1.ZodNumber;
@@ -15898,6 +16173,14 @@ interface MarkdownProps {
     /** Markdown source, rendered exactly like a chat message body. */
     content: string;
     className?: string;
+    /** Resolve local destinations from this document; omission keeps message routing. */
+    experimental_document?: {
+        threadId: string;
+        rootPath: string;
+        target: Exclude<ExperimentalLiveFileTarget, {
+            kind: "host";
+        }>;
+    };
 }
 /**
  * Props for BB's semantic URL link. The host owns ordinary activation while
@@ -16191,7 +16474,7 @@ interface PluginEnvironmentProviderValidateContext<R extends PluginEnvironmentPr
 }
 interface PluginEnvironmentProviderAvailabilityContext {
     project: Project;
-    host: Host | null;
+    host: Host;
     projectCheckout: {
         path: string;
     } | null;
@@ -16229,7 +16512,6 @@ type PluginEnvironmentProviderCreateResult = {
     resource?: JsonValue$2;
 } | {
     status: "failed";
-    failure: "terminal" | "transient";
     message: string;
 };
 interface PluginEnvironmentProviderRemoveContext {
@@ -16264,7 +16546,7 @@ interface PluginEnvironmentProviderDefinition<R extends PluginEnvironmentProvide
     requires?: R;
     inputs?: S;
     policy?: Partial<PluginEnvironmentProviderPolicy>;
-    /** Experimental: see docs/api_to_audit.md. */
+    /** Experimental per-machine availability, probed in the background for pickers and again at thread creation: see docs/api_to_audit.md. */
     availability?(context: PluginEnvironmentProviderAvailabilityContext): PluginEnvironmentProviderAvailability | Promise<PluginEnvironmentProviderAvailability>;
     validate?(context: PluginEnvironmentProviderValidateContext<R, S>): PluginEnvironmentValidateDecision$1 | Promise<PluginEnvironmentValidateDecision$1>;
     create(context: PluginEnvironmentProviderCreateContext<R, S>): Promise<PluginEnvironmentProviderCreateResult>;
@@ -16287,6 +16569,8 @@ interface ExperimentalDesktopBrowsersArea {
         ok: true;
     }>;
     captureTab(input: ExperimentalDesktopBrowserTabRequest): Promise<ExperimentalDesktopBrowserCapture>;
+    listImportSources(input: ExperimentalDesktopBrowserInstanceRequest): Promise<ExperimentalDesktopBrowserImportSources>;
+    importCookies(input: ExperimentalDesktopBrowserImportCookiesInput): Promise<ExperimentalDesktopBrowserImportOutcome>;
     subscribe(input: ExperimentalDesktopBrowserScope & {
         onChange: (result: ExperimentalDesktopBrowserTabs) => void;
         onError: (error: Error) => void;
@@ -16427,6 +16711,8 @@ interface FileListArgs {
     path: string;
     query?: string;
     limit?: number;
+    includeHidden?: boolean;
+    excludeNames?: string[];
     signal?: AbortSignal;
 }
 interface PathListArgs extends FileListArgs {
@@ -17086,6 +17372,24 @@ interface SystemProviderStatesArgs extends SystemProvidersQuery {
 }
 type SystemProviderStatesResult = SystemProviderStatesResponse;
 type SystemVersionResult = SystemVersionResponse;
+interface SystemUiPreferencesArgs {
+    signal?: AbortSignal;
+}
+type SystemUiPreferencesResult = UiPreferencesResponse;
+interface SystemUpdateUiPreferenceArgs<Key extends UiPreferenceKey> {
+    expectedRevision: number;
+    key: Key;
+    value: UiPreferenceValue<Key>;
+}
+interface SystemResetUiPreferenceArgs<Key extends UiPreferenceKey> {
+    key: Key;
+}
+type SystemUiPreferenceResult<Key extends UiPreferenceKey> = UiPreferenceResponse<Key>;
+interface SystemUiPreferencesArea {
+    list(args?: SystemUiPreferencesArgs): Promise<SystemUiPreferencesResult>;
+    set<Key extends UiPreferenceKey>(args: SystemUpdateUiPreferenceArgs<Key>): Promise<SystemUiPreferenceResult<Key>>;
+    reset<Key extends UiPreferenceKey>(args: SystemResetUiPreferenceArgs<Key>): Promise<SystemUiPreferenceResult<Key>>;
+}
 interface SystemArea {
     attention(args?: SystemAttentionArgs): Promise<SystemAttentionResult>;
     config(args?: SystemConfigArgs): Promise<SystemConfigResult>;
@@ -17094,6 +17398,7 @@ interface SystemArea {
     installCliSkills(args: SystemInstallCliSkillsArgs): Promise<SystemInstallCliSkillsResult>;
     reloadConfig(): Promise<SystemReloadConfigResult>;
     transcribeVoice(args: SystemVoiceTranscriptionArgs): Promise<SystemVoiceTranscriptionResult>;
+    uiPreferences: SystemUiPreferencesArea;
     updateExperiments(args: Experiments): Promise<SystemUpdateExperimentsResult>;
     updateGeneralSettings(args: AppSettingsUpdate): Promise<SystemUpdateGeneralSettingsResult>;
     updateKeyboardSettings(args: AppKeybindingOverrides): Promise<SystemUpdateKeyboardSettingsResult>;
@@ -18018,11 +18323,10 @@ type PluginThreadEventHandler<E extends PluginThreadEventName> = (payload: Plugi
  *   that machine, git or not, so core refuses a machine with no checkout of
  *   the project at create time and `context.projectCheckout` is non-null.
  * - `gitCheckout` — that directory must also be a git repository with at
- *   least one commit. The picker greys the row out where it is not, and core
- *   rejects an explicit selection using the same machine inspection before
- *   creating the thread. Implies `projectCheckout`.
- * - `gitRemote` — the provider clones the project itself, so it is greyed out
- *   in a project with no git remote and an explicit selection is rejected.
+ *   least one commit. Core inspects the selected machine and rejects an
+ *   invalid selection before creating the thread. Implies `projectCheckout`.
+ * - `gitRemote` — the provider clones the project itself, so an explicit
+ *   selection is rejected when the project has no git remote.
  * - `projectless` — this provider serves only threads that have no project,
  *   so it is offered for those and nowhere else. It cannot be combined with
  *   `projectCheckout`, `gitCheckout` or `gitRemote`, which need a project.
@@ -18057,9 +18361,8 @@ interface PluginEnvironments {
     register<const Requires extends PluginEnvironmentProviderRequirements, const Inputs extends PluginEnvironmentProviderInputsSchema = undefined>(declaration: PluginEnvironmentProviderDeclaration<Requires, Inputs>): void;
     /**
      * Ask core to re-ask this plugin's waiting providers now instead of at their
-     * `sendAt` — call it whenever a launch advances (progress text changed, the
-     * environment became ready, a failure was recorded). Resolves on
-     * scheduling, exactly like `experimental_hooks.recheck`.
+     * `sendAt`. Resolves on scheduling, exactly like
+     * `experimental_hooks.recheck`.
      */
     recheck(): Promise<void>;
 }

package/dist/testing/index.js

@@ -3761,6 +3761,20 @@ function createFakePluginHostInternal(options, sharedState) {
 }
 
 // src/testing/fixtures.ts
+function makeHostResponse(overrides = {}) {
+  return {
+    id: "host-1",
+    name: "Test host",
+    status: "connected",
+    type: "persistent",
+    maxPermissionMode: "full",
+    lastSeenAt: null,
+    lastRejectedProtocolVersion: null,
+    createdAt: 0,
+    updatedAt: 0,
+    ...overrides
+  };
+}
 function makeThreadResponse(overrides = {}) {
   return {
     id: "thread-1",
@@ -4079,6 +4093,7 @@ export {
   createFakePluginHost,
   createFakeSdk,
   scanPublicSdkOnly as experimental_scanPublicSdkOnly,
+  makeHostResponse,
   makeMessageDispatchHookContext,
   makePluginAgentConfigurationContext,
   makeQueueEntry,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@get-bb/plugin-sdk",
-  "version": "0.4.50",
+  "version": "0.4.55",
   "homepage": "https://github.com/get-bb/bb#readme",
   "bugs": {
     "url": "https://github.com/get-bb/bb/issues"