@get-bb/plugin-sdk 0.4.53 → 0.4.56

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

@@ -577,6 +577,18 @@ interface PluginFileOpenerSource {
 interface PluginFileOpenerProps {
     path: string;
     source: PluginFileOpenerSource;
+    /**
+     * One-based, inclusive lines requested by the latest file open, or null when
+     * untargeted. BB supplies a new object for each targeted open, including an
+     * identical target in the active tab. Observe object identity to navigate
+     * again; keep the editor model intact. Older hosts may omit this prop.
+     *
+     * @experimental Audit navigation, remount, and persistence semantics before stabilizing.
+     */
+    experimental_lineRange?: {
+        startLineNumber: number;
+        endLineNumber: number;
+    } | null;
     /**
      * BB's file preview, bound to this file. Render it to delegate conditionally
      * without re-entering plugin replacement resolution.
@@ -2394,6 +2406,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";
@@ -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 create-time preflight: 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";
@@ -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 create-time preflight: 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-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";
@@ -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 create-time preflight: 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.d.ts

@@ -73,7 +73,7 @@ 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.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"];
+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;
@@ -92,6 +92,11 @@ declare const uiPreferenceDefinitions: {
         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>>;
@@ -334,6 +339,7 @@ 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";
@@ -344,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";
@@ -404,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";
@@ -420,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";
@@ -6943,6 +6950,7 @@ declare const hostDaemonCommandRegistry: {
         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<{
@@ -6959,6 +6967,7 @@ declare const hostDaemonCommandRegistry: {
         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<{
@@ -9507,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";
@@ -9822,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;
@@ -12681,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";
@@ -13311,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;
@@ -13340,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>;
@@ -13606,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";
@@ -14328,6 +14356,18 @@ interface PluginFileOpenerSource {
 interface PluginFileOpenerProps {
     path: string;
     source: PluginFileOpenerSource;
+    /**
+     * One-based, inclusive lines requested by the latest file open, or null when
+     * untargeted. BB supplies a new object for each targeted open, including an
+     * identical target in the active tab. Observe object identity to navigate
+     * again; keep the editor model intact. Older hosts may omit this prop.
+     *
+     * @experimental Audit navigation, remount, and persistence semantics before stabilizing.
+     */
+    experimental_lineRange?: {
+        startLineNumber: number;
+        endLineNumber: number;
+    } | null;
     /**
      * BB's file preview, bound to this file. Render it to delegate conditionally
      * without re-entering plugin replacement resolution.
@@ -16145,6 +16185,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
@@ -16476,7 +16524,6 @@ type PluginEnvironmentProviderCreateResult = {
     resource?: JsonValue$2;
 } | {
     status: "failed";
-    failure: "terminal" | "transient";
     message: string;
 };
 interface PluginEnvironmentProviderRemoveContext {
@@ -16511,7 +16558,7 @@ interface PluginEnvironmentProviderDefinition<R extends PluginEnvironmentProvide
     requires?: R;
     inputs?: S;
     policy?: Partial<PluginEnvironmentProviderPolicy>;
-    /** Experimental create-time preflight: 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>;

package/package.json

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