@get-bb/plugin-sdk 0.4.101 → 0.4.106

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

@@ -3025,6 +3025,7 @@ declare const threadEventSchema: z$1.ZodPipe<z$1.ZodUnknown, z$1.ZodUnion<readon
         "child-outcome-batch": "child-outcome-batch";
         "ownership-assigned": "ownership-assigned";
         "ownership-removed": "ownership-removed";
+        "tool-result-delivered": "tool-result-delivered";
         unlabeled: "unlabeled";
     }>>;
     systemMessageSubject: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
@@ -3034,6 +3035,10 @@ declare const threadEventSchema: z$1.ZodPipe<z$1.ZodUnknown, z$1.ZodUnion<readon
     }, z$1.core.$strip>, z$1.ZodObject<{
         count: z$1.ZodNumber;
         kind: z$1.ZodLiteral<"thread-batch">;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+        kind: z$1.ZodLiteral<"tool-call">;
+        suppress: z$1.ZodBoolean;
+        toolName: z$1.ZodString;
     }, z$1.core.$strip>], "kind">>>;
     target: z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
         kind: z$1.ZodLiteral<"thread-start">;
@@ -3287,9 +3292,39 @@ declare const threadEventSchema: z$1.ZodPipe<z$1.ZodUnknown, z$1.ZodUnion<readon
         }, z$1.core.$strip>;
         payload: z$1.ZodObject<{
             kind: z$1.ZodLiteral<"plugin">;
+            presentation: z$1.ZodOptional<z$1.ZodObject<{
+                badge: z$1.ZodOptional<z$1.ZodObject<{
+                    glyph: z$1.ZodString;
+                    hint: z$1.ZodString;
+                    label: z$1.ZodString;
+                    tone: z$1.ZodEnum<{
+                        destructive: "destructive";
+                        neutral: "neutral";
+                    }>;
+                }, z$1.core.$strip>>;
+                detail: z$1.ZodOptional<z$1.ZodString>;
+                icon: z$1.ZodObject<{
+                    glyph: z$1.ZodString;
+                }, z$1.core.$strip>;
+                label: z$1.ZodObject<{
+                    completed: z$1.ZodString;
+                    pending: z$1.ZodString;
+                }, z$1.core.$strip>;
+                suppress: z$1.ZodOptional<z$1.ZodBoolean>;
+                tint: z$1.ZodOptional<z$1.ZodObject<{
+                    dark: z$1.ZodString;
+                    light: z$1.ZodString;
+                }, z$1.core.$strip>>;
+                title: z$1.ZodOptional<z$1.ZodString>;
+            }, z$1.core.$strip>>;
             title: z$1.ZodString;
         }, z$1.core.$strip>;
         resolution: z$1.ZodNullable<z$1.ZodObject<{
+            description: z$1.ZodOptional<z$1.ZodObject<{
+                detail: z$1.ZodOptional<z$1.ZodString>;
+                payload: z$1.ZodOptional<z$1.ZodType<JsonValue$1, unknown, z$1.core.$ZodTypeInternals<JsonValue$1, unknown>>>;
+                title: z$1.ZodOptional<z$1.ZodString>;
+            }, z$1.core.$strip>>;
             kind: z$1.ZodLiteral<"plugin_submitted">;
         }, z$1.core.$strip>>;
         status: z$1.ZodEnum<{
@@ -3492,6 +3527,11 @@ declare const pendingInteractionResolutionSchema: z$1.ZodUnion<readonly [z$1.Zod
     }, z$1.core.$strip>>;
     kind: z$1.ZodLiteral<"user_answer">;
 }, z$1.core.$strip>, z$1.ZodObject<{
+    description: z$1.ZodOptional<z$1.ZodObject<{
+        detail: z$1.ZodOptional<z$1.ZodString>;
+        payload: z$1.ZodOptional<z$1.ZodType<JsonValue$1, unknown, z$1.core.$ZodTypeInternals<JsonValue$1, unknown>>>;
+        title: z$1.ZodOptional<z$1.ZodString>;
+    }, z$1.core.$strip>>;
     kind: z$1.ZodLiteral<"plugin_submitted">;
 }, z$1.core.$strip>, z$1.ZodObject<{
     kind: z$1.ZodLiteral<"request_answer">;
@@ -3739,9 +3779,39 @@ declare const pluginPendingInteractionSchema: z$1.ZodObject<{
     payload: z$1.ZodObject<{
         data: z$1.ZodType<JsonValue$1, unknown, z$1.core.$ZodTypeInternals<JsonValue$1, unknown>>;
         kind: z$1.ZodLiteral<"plugin">;
+        presentation: z$1.ZodOptional<z$1.ZodObject<{
+            badge: z$1.ZodOptional<z$1.ZodObject<{
+                glyph: z$1.ZodString;
+                hint: z$1.ZodString;
+                label: z$1.ZodString;
+                tone: z$1.ZodEnum<{
+                    destructive: "destructive";
+                    neutral: "neutral";
+                }>;
+            }, z$1.core.$strip>>;
+            detail: z$1.ZodOptional<z$1.ZodString>;
+            icon: z$1.ZodObject<{
+                glyph: z$1.ZodString;
+            }, z$1.core.$strip>;
+            label: z$1.ZodObject<{
+                completed: z$1.ZodString;
+                pending: z$1.ZodString;
+            }, z$1.core.$strip>;
+            suppress: z$1.ZodOptional<z$1.ZodBoolean>;
+            tint: z$1.ZodOptional<z$1.ZodObject<{
+                dark: z$1.ZodString;
+                light: z$1.ZodString;
+            }, z$1.core.$strip>>;
+            title: z$1.ZodOptional<z$1.ZodString>;
+        }, z$1.core.$strip>>;
         title: z$1.ZodString;
     }, z$1.core.$strip>;
     resolution: z$1.ZodNullable<z$1.ZodObject<{
+        description: z$1.ZodOptional<z$1.ZodObject<{
+            detail: z$1.ZodOptional<z$1.ZodString>;
+            payload: z$1.ZodOptional<z$1.ZodType<JsonValue$1, unknown, z$1.core.$ZodTypeInternals<JsonValue$1, unknown>>>;
+            title: z$1.ZodOptional<z$1.ZodString>;
+        }, z$1.core.$strip>>;
         kind: z$1.ZodLiteral<"plugin_submitted">;
     }, z$1.core.$strip>>;
     resolvedAt: z$1.ZodNullable<z$1.ZodNumber>;
@@ -5828,6 +5898,7 @@ declare const hostDaemonCommandRegistry: {
                 chromium: "chromium";
                 edge: "edge";
                 firefox: "firefox";
+                helium: "helium";
                 opera: "opera";
                 safari: "safari";
                 vivaldi: "vivaldi";
@@ -5864,6 +5935,7 @@ declare const hostDaemonCommandRegistry: {
             chromium: "chromium";
             edge: "edge";
             firefox: "firefox";
+            helium: "helium";
             opera: "opera";
             safari: "safari";
             vivaldi: "vivaldi";
@@ -7076,6 +7148,11 @@ declare const hostDaemonCommandRegistry: {
             }, z$1.core.$strip>>;
             kind: z$1.ZodLiteral<"user_answer">;
         }, z$1.core.$strip>, z$1.ZodObject<{
+            description: z$1.ZodOptional<z$1.ZodObject<{
+                detail: z$1.ZodOptional<z$1.ZodString>;
+                payload: z$1.ZodOptional<z$1.ZodType<JsonValue$1, unknown, z$1.core.$ZodTypeInternals<JsonValue$1, unknown>>>;
+                title: z$1.ZodOptional<z$1.ZodString>;
+            }, z$1.core.$strip>>;
             kind: z$1.ZodLiteral<"plugin_submitted">;
         }, z$1.core.$strip>, z$1.ZodObject<{
             kind: z$1.ZodLiteral<"request_answer">;
@@ -8706,6 +8783,7 @@ declare const desktopBrowserCommandSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodObj
         chromium: "chromium";
         edge: "edge";
         firefox: "firefox";
+        helium: "helium";
         opera: "opera";
         safari: "safari";
         vivaldi: "vivaldi";
@@ -8803,6 +8881,7 @@ declare const desktopBrowserResultSchemas: {
                 chromium: "chromium";
                 edge: "edge";
                 firefox: "firefox";
+                helium: "helium";
                 opera: "opera";
                 safari: "safari";
                 vivaldi: "vivaldi";
@@ -10438,7 +10517,23 @@ declare const terminalOutputResponseSchema: z$1.ZodObject<{
         dataBase64: z$1.ZodString;
         seq: z$1.ZodNumber;
     }, z$1.core.$strict>>;
+    closeReason: z$1.ZodNullable<z$1.ZodEnum<{
+        "daemon-disconnect": "daemon-disconnect";
+        "environment-destroyed": "environment-destroyed";
+        "open-timeout": "open-timeout";
+        "process-exit": "process-exit";
+        "thread-archived": "thread-archived";
+        "thread-deleted": "thread-deleted";
+        user: "user";
+    }>>;
+    exitCode: z$1.ZodNullable<z$1.ZodNumber>;
     nextSeq: z$1.ZodNumber;
+    status: z$1.ZodEnum<{
+        disconnected: "disconnected";
+        exited: "exited";
+        running: "running";
+        starting: "starting";
+    }>;
     truncated: z$1.ZodBoolean;
 }, z$1.core.$strict>;
 type TerminalOutputResponse = z$1.infer<typeof terminalOutputResponseSchema>;
@@ -10544,6 +10639,7 @@ declare const timelineConversationRowSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodO
         "child-outcome-batch": "child-outcome-batch";
         "ownership-assigned": "ownership-assigned";
         "ownership-removed": "ownership-removed";
+        "tool-result-delivered": "tool-result-delivered";
         unlabeled: "unlabeled";
     }>;
     systemMessageSubject: z$1.ZodNullable<z$1.ZodDiscriminatedUnion<[z$1.ZodObject<{
@@ -10553,6 +10649,10 @@ declare const timelineConversationRowSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodO
     }, z$1.core.$strip>, z$1.ZodObject<{
         count: z$1.ZodNumber;
         kind: z$1.ZodLiteral<"thread-batch">;
+    }, z$1.core.$strip>, z$1.ZodObject<{
+        kind: z$1.ZodLiteral<"tool-call">;
+        suppress: z$1.ZodBoolean;
+        toolName: z$1.ZodString;
     }, z$1.core.$strip>], "kind">>;
     text: z$1.ZodString;
     threadId: z$1.ZodString;
@@ -11335,6 +11435,60 @@ declare const timelineApprovalWorkRowSchema: z$1.ZodDiscriminatedUnion<[z$1.ZodO
     workKind: z$1.ZodLiteral<"approval">;
 }, z$1.core.$strip>], "approvalKind">;
 type TimelineApprovalWorkRow = z$1.infer<typeof timelineApprovalWorkRowSchema>;
+declare const timelineFormWorkRowSchema: z$1.ZodObject<{
+    createdAt: z$1.ZodNumber;
+    id: z$1.ZodString;
+    interactionId: z$1.ZodString;
+    kind: z$1.ZodLiteral<"work">;
+    lifecycle: z$1.ZodEnum<{
+        cancelled: "cancelled";
+        pending: "pending";
+        submitted: "submitted";
+    }>;
+    payload: z$1.ZodNullable<z$1.ZodType<JsonValue$1, unknown, z$1.core.$ZodTypeInternals<JsonValue$1, unknown>>>;
+    pluginId: z$1.ZodString;
+    presentation: z$1.ZodObject<{
+        badge: z$1.ZodOptional<z$1.ZodObject<{
+            glyph: z$1.ZodString;
+            hint: z$1.ZodString;
+            label: z$1.ZodString;
+            tone: z$1.ZodEnum<{
+                destructive: "destructive";
+                neutral: "neutral";
+            }>;
+        }, z$1.core.$strip>>;
+        detail: z$1.ZodOptional<z$1.ZodString>;
+        icon: z$1.ZodObject<{
+            glyph: z$1.ZodString;
+        }, z$1.core.$strip>;
+        label: z$1.ZodObject<{
+            completed: z$1.ZodString;
+            pending: z$1.ZodString;
+        }, z$1.core.$strip>;
+        suppress: z$1.ZodOptional<z$1.ZodBoolean>;
+        tint: z$1.ZodOptional<z$1.ZodObject<{
+            dark: z$1.ZodString;
+            light: z$1.ZodString;
+        }, z$1.core.$strip>>;
+        title: z$1.ZodOptional<z$1.ZodString>;
+    }, z$1.core.$strip>;
+    rendererId: z$1.ZodString;
+    sourceSeqEnd: z$1.ZodNumber;
+    sourceSeqStart: z$1.ZodNumber;
+    startedAt: z$1.ZodNumber;
+    status: z$1.ZodEnum<{
+        completed: "completed";
+        error: "error";
+        interrupted: "interrupted";
+        pending: "pending";
+    }>;
+    statusReason: z$1.ZodNullable<z$1.ZodString>;
+    threadId: z$1.ZodString;
+    title: z$1.ZodString;
+    turnId: z$1.ZodNullable<z$1.ZodString>;
+    workKind: z$1.ZodLiteral<"form">;
+}, z$1.core.$strip>;
+type TimelineFormWorkRow = z$1.infer<typeof timelineFormWorkRowSchema>;
 declare const timelineQuestionWorkRowSchema: z$1.ZodObject<{
     answers: z$1.ZodNullable<z$1.ZodRecord<z$1.ZodString, z$1.ZodObject<{
         freeText: z$1.ZodOptional<z$1.ZodString>;
@@ -11491,7 +11645,7 @@ declare const timelineWorkflowWorkRowSchema: z$1.ZodObject<{
     workflowName: z$1.ZodNullable<z$1.ZodString>;
 }, z$1.core.$strip>;
 type TimelineWorkflowWorkRow = z$1.infer<typeof timelineWorkflowWorkRowSchema>;
-type TimelineWorkRow = TimelineCommandWorkRow | TimelineToolWorkRow | TimelineFileChangeWorkRow | TimelineWebSearchWorkRow | TimelineWebFetchWorkRow | TimelineImageGenerationWorkRow | TimelineImageViewWorkRow | TimelineFileReadWorkRow | TimelineSearchWorkRow | TimelinePlanStepsWorkRow | TimelineExtensionWorkRow | TimelineApprovalWorkRow | TimelineQuestionWorkRow | TimelineDelegationWorkRow | TimelineWorkflowWorkRow;
+type TimelineWorkRow = TimelineCommandWorkRow | TimelineToolWorkRow | TimelineFileChangeWorkRow | TimelineWebSearchWorkRow | TimelineWebFetchWorkRow | TimelineImageGenerationWorkRow | TimelineImageViewWorkRow | TimelineFileReadWorkRow | TimelineSearchWorkRow | TimelinePlanStepsWorkRow | TimelineExtensionWorkRow | TimelineApprovalWorkRow | TimelineQuestionWorkRow | TimelineFormWorkRow | TimelineDelegationWorkRow | TimelineWorkflowWorkRow;
 interface TimelineTurnRow extends TimelineRowBase {
     kind: "turn";
     turnId: string;
@@ -13556,9 +13710,39 @@ declare const threadPendingInteractionsResponseSchema: z$1.ZodArray<z$1.ZodUnion
     payload: z$1.ZodObject<{
         data: z$1.ZodType<JsonValue$1, unknown, z$1.core.$ZodTypeInternals<JsonValue$1, unknown>>;
         kind: z$1.ZodLiteral<"plugin">;
+        presentation: z$1.ZodOptional<z$1.ZodObject<{
+            badge: z$1.ZodOptional<z$1.ZodObject<{
+                glyph: z$1.ZodString;
+                hint: z$1.ZodString;
+                label: z$1.ZodString;
+                tone: z$1.ZodEnum<{
+                    destructive: "destructive";
+                    neutral: "neutral";
+                }>;
+            }, z$1.core.$strip>>;
+            detail: z$1.ZodOptional<z$1.ZodString>;
+            icon: z$1.ZodObject<{
+                glyph: z$1.ZodString;
+            }, z$1.core.$strip>;
+            label: z$1.ZodObject<{
+                completed: z$1.ZodString;
+                pending: z$1.ZodString;
+            }, z$1.core.$strip>;
+            suppress: z$1.ZodOptional<z$1.ZodBoolean>;
+            tint: z$1.ZodOptional<z$1.ZodObject<{
+                dark: z$1.ZodString;
+                light: z$1.ZodString;
+            }, z$1.core.$strip>>;
+            title: z$1.ZodOptional<z$1.ZodString>;
+        }, z$1.core.$strip>>;
         title: z$1.ZodString;
     }, z$1.core.$strip>;
     resolution: z$1.ZodNullable<z$1.ZodObject<{
+        description: z$1.ZodOptional<z$1.ZodObject<{
+            detail: z$1.ZodOptional<z$1.ZodString>;
+            payload: z$1.ZodOptional<z$1.ZodType<JsonValue$1, unknown, z$1.core.$ZodTypeInternals<JsonValue$1, unknown>>>;
+            title: z$1.ZodOptional<z$1.ZodString>;
+        }, z$1.core.$strip>>;
         kind: z$1.ZodLiteral<"plugin_submitted">;
     }, z$1.core.$strip>>;
     resolvedAt: z$1.ZodNullable<z$1.ZodNumber>;
@@ -14336,6 +14520,7 @@ declare const desktopBrowserImportCookiesRequestSchema: z$1.ZodObject<{
         chromium: "chromium";
         edge: "edge";
         firefox: "firefox";
+        helium: "helium";
         opera: "opera";
         safari: "safari";
         vivaldi: "vivaldi";
@@ -16191,10 +16376,6 @@ interface PluginCommandRegistration {
      */
     run(context: PluginCommandContext): void | Promise<void>;
 }
-/** @deprecated Use PluginCommandContext. */
-type PluginCommandPaletteActionContext = PluginCommandContext;
-/** @deprecated Use PluginCommandRegistration. */
-type PluginCommandPaletteActionRegistration = PluginCommandRegistration;
 /** Registers commands for bb's command palette. */
 interface PluginAppCommands {
     /** Register a command. IDs are unique within this plugin, including legacy slot registrations. */
@@ -16832,6 +17013,82 @@ interface PluginComposerApi {
      * Experimental: see docs/api_to_audit.md.
      */
     experimental_submit(options: ExperimentalComposerSubmitOptions): Promise<void>;
+    /**
+     * Set this composer's pickers as if each value had been picked by hand.
+     *
+     * Every field is optional. An omitted field is left alone. A field this
+     * composer has no picker for is ignored rather than rejected: a thread
+     * composer has no project or environment; a provider without service tiers
+     * has no tier; a fork draft locks its project, provider and environment.
+     * Values travel through the same paths the pickers use, so in the
+     * new-thread composer they become the remembered defaults for the next
+     * thread and are reported as the user's explicit choices, and in a thread
+     * composer a provider change starts the same handoff the picker starts:
+     * the handoff block is prepended to the draft and the next send creates a
+     * new thread. A same-provider model change in a thread does not start a
+     * handoff, exactly like the picker.
+     *
+     * In the new-thread composer the project is switched first and awaited
+     * (attachments are copied to the new project), then the environment and
+     * machine are applied to the new project, then provider, model, reasoning
+     * level, service tier and permission mode. A provider change reloads the
+     * model catalog before the model and reasoning level are applied to it.
+     * Because the project switch remounts plugin surfaces, the returned
+     * promise is owned by the composer and still resolves after the calling
+     * component has unmounted.
+     *
+     * Resolves with the composer's own selection once it has settled: the
+     * applied values have committed and the model catalog for the selected
+     * provider and machine has finished loading, so model, reasoning level and
+     * permission mode have reconciled against it. The catalog wait is bounded;
+     * if it has not finished after 15 seconds the promise resolves with the
+     * selection as it stands. The result carries only the fields this composer
+     * has, so a missing key means "no such picker here" and a value that
+     * differs from the one passed was reconciled (a reasoning level the model
+     * does not support, a permission mode above the machine's ceiling, a model
+     * the provider does not list). A provider the composer does not list is
+     * ignored together with the model and reasoning level meant for it, so the
+     * stored provider preference never names something the picker could not
+     * have chosen. `environment` is absent while the composer
+     * has no submittable environment; `providerId` and `model` are absent
+     * while nothing is selected; `serviceTier` is present only when the
+     * selected provider has tiers and one is chosen.
+     *
+     * Rejects, with a message safe to show to the user, in a composer with no
+     * pickers at all (a queued-message editor, a side chat, a plugin surface
+     * mounted outside any composer), when the calling surface is no longer
+     * active, and when a value is not a known reasoning level, service tier or
+     * permission mode.
+     *
+     * Experimental: see docs/api_to_audit.md.
+     */
+    experimental_setSelection(selection: ExperimentalComposerSelection): Promise<ExperimentalComposerSelection>;
+}
+/**
+ * Picker values for `experimental_setSelection`, and the shape it resolves
+ * with. Field names match `NewThreadRequest` and the `default*` props of
+ * `experimental_NewThreadComposer`, so one routed decision can feed the
+ * composer, the embedded composer and `bb.sdk.threads.spawn` alike.
+ */
+interface ExperimentalComposerSelection {
+    /** New-thread composers only. BB's personal-project id means "Don't work in a project". */
+    projectId?: string;
+    /**
+     * New-thread composers only. `{ type: "project-default" }` and a `host`
+     * environment without a `hostId` seed nothing and are ignored. Provider
+     * `inputs` are not applied; the provider's own inputs control keeps its
+     * value, and the result reports what the composer would submit.
+     */
+    environment?: CreateThreadEnvironmentArgs;
+    /** A provider the composer does not list is ignored, and `model` and `reasoningLevel` with it. */
+    providerId?: string;
+    /** Applied only when the composer ends up on the requested provider (or none was requested). */
+    model?: string;
+    /** Applied only when the composer ends up on the requested provider (or none was requested). */
+    reasoningLevel?: ReasoningLevel;
+    /** Ignored by a provider with no service tiers. */
+    serviceTier?: ServiceTier;
+    permissionMode?: PermissionMode;
 }
 /**
  * What `experimental_submit` does differently from pressing Enter.
@@ -16958,9 +17215,8 @@ interface ExperimentalProviderModelPickerProps {
 /**
  * Props of the host-owned `experimental_BranchPicker` component — bb's branch
  * picker bundled with its branch-options loading for the given host and
- * project, the control bb's own New Thread composer renders as "Branch from".
- * The host owns fetching, searching, and refreshing the branch list; the
- * caller owns only the selection.
+ * project. The host owns fetching, searching, and refreshing the branch list;
+ * the caller owns the selection and its meaning.
  */
 interface BranchPickerProps {
     /**
@@ -16971,21 +17227,21 @@ interface BranchPickerProps {
     /** The project whose source on `hostId` is listed; null disables loading. */
     projectId: string | null;
     /**
-     * The selected branch name, or null when no branch is chosen (the host
-     * shows its placeholder and the consumer falls back to its own default).
+     * The selected branch name, or null when no branch is chosen. A null value
+     * shows the placeholder without selecting or implying a default branch.
      */
     value: string | null;
     /** Called with the picked branch name, or null when the pick is cleared. */
     onChange(next: string | null): void;
     /**
-     * Text placed before the branch on the trigger, e.g. "Base:". Omitted, the
-     * trigger is the branch alone.
+     * Text placed before the branch on the trigger and used as the menu heading,
+     * e.g. "Compare with:". Omitted, the trigger is the branch alone and the menu
+     * uses the neutral "Branches" heading.
      */
     label?: string;
     /**
-     * The trigger while nothing is picked. Omitted, the host shows the resolved
-     * default worktree base branch muted, or a neutral `default` placeholder
-     * when the base cannot be resolved.
+     * The complete trigger text while nothing is picked, without the label
+     * prefix. Defaults to "Select branch".
      */
     placeholder?: string;
     /** Render the current selection without allowing changes. */
@@ -17660,6 +17916,8 @@ interface PluginEnvironmentProviderDefinition<R extends PluginEnvironmentProvide
     /** 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>;
+    /** Pure path selection from parsed inputs. Core reuses a recorded environment on the selected host before calling create; null requests normal creation. */
+    experimental_existingPath?(inputs: InputsValue<S>): string | null;
     create(context: PluginEnvironmentProviderCreateContext<R, S>): Promise<PluginEnvironmentProviderCreateResult>;
     remove(context: PluginEnvironmentProviderRemoveContext): Promise<PluginEnvironmentProviderRemoveResult>;
 }
@@ -20046,6 +20304,23 @@ type PluginInteractionResult = {
     outcome: "cancelled";
     reason: PluginInteractionCancelReason;
 };
+/**
+ * What a submitted form leaves in the thread timeline, chosen by the plugin.
+ * bb never stores the form's payload or the submitted value; it stores only
+ * this description, so a plugin decides what the transcript keeps.
+ */
+interface PluginInteractionDescription {
+    /** Row title once submitted; defaults to the presentation's completed label. */
+    title?: string;
+    /** Short Markdown for the expanded row. */
+    detail?: string;
+    /**
+     * Persisted with the row and handed to this plugin's
+     * `experimental_timelineRenderer` registered for `"<pluginId>/<rendererId>"`.
+     * Omit anything the transcript must not keep.
+     */
+    payload?: JsonValue;
+}
 interface PluginInteractionRequest {
     threadId: string;
     rendererId: string;
@@ -20053,6 +20328,19 @@ interface PluginInteractionRequest {
     payload: JsonValue;
     /** Defaults to ten minutes; capped at one hour. */
     timeoutMs?: number;
+    /**
+     * How the form reads as a timeline row while it waits and once it settles,
+     * in the same shape as a native tool's presentation. bb fills what is left
+     * out: "Waiting for <title>" / "Submitted <title>" and the plugin's glyph.
+     */
+    presentation?: PluginRowPresentation;
+    /**
+     * Called once with the submitted value, before the waiting `requestInput`
+     * promise resolves; never for a cancellation, which bb titles itself. Its
+     * return is persisted on the row. A throw or a slow return leaves the row
+     * with its completed label and nothing more.
+     */
+    describeSubmission?(value: JsonValue): PluginInteractionDescription | Promise<PluginInteractionDescription>;
 }
 interface PluginCliResult {
     exitCode: number;
@@ -20088,6 +20376,15 @@ interface PluginCliRegistration {
     /** Subcommand metadata rendered in help and the plugin-commands skill
      * without executing plugin code. Parsing argv is plugin-owned. */
     commands?: PluginCliCommandInfo[];
+    /**
+     * Set when `run` answers `--help` / `-h` itself, at every level, without
+     * executing a command. The `bb` CLI then forwards help requests to the
+     * plugin instead of printing the one-line `usage` from `commands`.
+     * `defineCli` sets it. Leave it unset for a hand-written `run`:
+     * the host cannot know that such a parser will not act on the other
+     * arguments.
+     */
+    rendersHelp?: boolean;
     run(argv: string[], ctx: PluginCliContext): PluginCliResult | Promise<PluginCliResult>;
 }
 interface PluginCli {
@@ -20116,30 +20413,37 @@ type PluginAgentToolResult = string | {
 interface PluginAgentToolContext {
     threadId: string;
     projectId: string;
-    /** The tool-call request's abort signal (aborts if the daemon round-trip
-     * is torn down mid-call). */
+    /**
+     * Aborts when the tool-call request is cancelled, the thread is stopped or
+     * deleted, or this plugin is disposed. Opening a form with `bb.ui.requestInput`
+     * detaches the call from its request: the agent receives a waiting notice,
+     * and request cancellation no longer aborts this signal. The tool's eventual
+     * result is delivered as a system message (success steers a running turn or
+     * starts a new one; an `isError` result only steers). Thread stop/delete and
+     * plugin disposal still abort the signal after detachment.
+     */
     signal: AbortSignal;
 }
 /**
- * The row title of a plugin tool call while it is pending and once it
+ * The title of a plugin-owned timeline row while it is pending and once it
  * settled. Each label is capped at 80 characters and rendered as plain text.
  */
-interface PluginAgentToolLabels {
-    /** Label shown while the tool call is pending. */
+interface PluginRowLabels {
+    /** Label shown while the row is pending. */
     pending: string;
-    /** Label shown after the tool call completes successfully. */
+    /** Label shown after the row completes successfully. */
     completed: string;
 }
 /**
- * How calls to a native plugin tool read as a timeline row (grammar v3). Every
- * field is optional at registration: the server fills what the plugin leaves
- * out (a generic `Running <name>` / `Ran <name>` label; the plugin's branding
- * glyph, then `Toolbox`) and hands one complete presentation to the provider
- * bridge with the tool definition.
+ * How something a plugin owns reads as a timeline row (grammar v3): a native
+ * tool's calls, or the row a `bb.ui.requestInput` form leaves behind. Every
+ * field is optional: the server fills what the plugin leaves out (a generic
+ * label; the plugin's branding glyph, then `Toolbox`) and hands one complete
+ * presentation to whatever renders the row.
  */
-interface PluginAgentToolPresentation {
-    /** Row title while the call is pending and once it settled. */
-    label?: PluginAgentToolLabels;
+interface PluginRowPresentation {
+    /** Row title while the row is pending and once it settled. */
+    label?: PluginRowLabels;
     /**
      * A named host glyph (`{ glyph: "Workflow" }`), or one of this plugin's
      * own declared icons by its namespaced glyph (`{ glyph: "<pluginId>/<name>" }`,
@@ -20177,7 +20481,7 @@ interface PluginAgentToolRegistrationBase {
      * plugin's branding glyph. Approval, error, and interruption states keep
      * BB's standard rendering. See docs/api_to_audit.md.
      */
-    presentation?: PluginAgentToolPresentation;
+    presentation?: PluginRowPresentation;
 }
 /** Stable, plain-data context resolved by the server for one agent session. */
 interface PluginAgentConfigurationContext {
@@ -20785,7 +21089,14 @@ interface PluginMentionProviderRegistration {
     }>;
 }
 interface PluginUi {
-    /** Block until the app submits or cancels a plugin-owned composer form. */
+    /**
+     * Block until the user submits or cancels this plugin's form in the
+     * thread composer. Inside a native tool's `execute`, calling this answers
+     * the tool call at once with a waiting notice and the eventual return value
+     * reaches the agent as a message; see {@link PluginAgentToolContext.signal}.
+     * The form leaves a timeline row described by `presentation` and
+     * `describeSubmission`.
+     */
     requestInput(request: PluginInteractionRequest, options?: {
         signal?: AbortSignal;
     }): Promise<PluginInteractionResult>;
@@ -21005,5 +21316,237 @@ interface BbPluginApi {
     onDispose(hook: () => void | Promise<void>): void;
 }
 
-export { PLUGIN_CLI_OUTPUT_MAX_BYTES, defineRpcContract, experimental_defineHostEntry };
-export type { BbContext, BbNavigate, BbPluginApi, BranchPickerProps, BranchesState, CheckoutState, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppIcons, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, 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, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, JsonValue, MachineBootstrapApi, MachineBootstrapRequest, MachineExecutor, MachineExecutorRequest, MarkdownProps, MessageDispatchHookContext, MessageDispatchHookDecision, NewThreadComposerProps, NewThreadRequest, PluginAgentConfiguration, PluginAgentConfigurationContext, PluginAgentToolContentPart, PluginAgentToolContext, PluginAgentToolLabels, PluginAgentToolPresentation, PluginAgentToolRegistrationBase, PluginAgentToolResult, PluginAgentToolSelection, PluginAgents, PluginAiServiceDeclaration, PluginAiServiceKind, PluginAiServices, PluginAppBuilder, PluginAppCommands, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginBackground, PluginBbSdk, PluginCli, PluginCliCommandInfo, PluginCliContext, PluginCliExecutionResult, PluginCliOutputLimitError, PluginCliRegistration, PluginCliResult, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandContext, PluginCommandPaletteActionContext, PluginCommandPaletteActionRegistration, PluginCommandRegistration, PluginCommandShortcut, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginDispatchAttemptKind, PluginDispatchEnvironmentIntent, PluginDispatchExecution, PluginDispatchExecutionSources, PluginDispatchInput, PluginEnvironmentProviderDeclaration, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, PluginEnvironmentProviderRequirements, PluginEnvironmentValidateDecision, PluginEnvironments, PluginEvents, PluginFileOpenerProps, PluginFileOpenerRegistration, PluginFileOpenerSource, PluginFixedTabDeclaration, PluginFixedTabRegistration, PluginHomepageSectionProps, PluginHomepageSectionRegistration, PluginHookHandler, PluginHookName, PluginHookSignatures, PluginHooks, PluginHosts, PluginHttp, PluginHttpAuthMode, PluginHttpHandler, PluginInteractionCancelReason, 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, 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, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginStatusApi, PluginStorage, PluginTargetedPanelActionOpenOptions, PluginThreadEventHandler, PluginThreadEventName, PluginThreadEventPayloads, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, PluginTurnFailedEvent, PluginUi, ReadonlyJsonValue, ServerAccessGrant, ServerAccessProviderDeclaration, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps, UseBranchesArgs, UseCheckoutStateArgs };
+/** Duration suffixes, shared with the core `bb` CLI grammar. */
+type PluginCliDurationUnit = "d" | "h" | "m" | "ms" | "s";
+/**
+ * Failure codes the parser itself emits in the `--json` error envelope.
+ * A command raising `PluginCliError` may use any snake_case code.
+ */
+type PluginCliErrorCode = "invalid_value" | "missing_command" | "missing_required" | "unexpected_argument" | "unknown_command" | "unknown_option";
+interface PluginCliOptionBase {
+    /** One line shown in `--help`; state the limits agents keep hitting. */
+    description: string;
+    /** Extra spellings accepted silently and mapped onto this option. */
+    aliases?: readonly string[];
+    /** Single-character form: `"f"` (or `"-f"`) accepts `-f`. */
+    short?: string;
+    /** Kept out of `--help` and the generated usage line. */
+    hidden?: boolean;
+    /** Value placeholder in help and usage; defaults to the value type. */
+    placeholder?: string;
+    /**
+     * Recognize `--<name>-stdin`. The `bb` CLI reads that value from stdin and
+     * rewrites it to `--<name> <value>` before the plugin runs, so a command
+     * that still sees it reports that instead of "unknown option".
+     */
+    stdin?: boolean;
+}
+/** A valueless flag; absent means `false`. */
+interface PluginCliBooleanOption extends PluginCliOptionBase {
+    type: "boolean";
+}
+interface PluginCliStringOption extends PluginCliOptionBase {
+    type: "string";
+    required?: boolean;
+    repeatable?: boolean;
+    /**
+     * Split each value on this separator, so `--tag a,b` is two tags. Only valid
+     * with `repeatable: true`; `defineCli` rejects it otherwise, because a
+     * single-valued option would silently drop every value after the first.
+     */
+    split?: string;
+    default?: string;
+}
+interface PluginCliIntegerOption extends PluginCliOptionBase {
+    type: "integer";
+    min: number;
+    max: number;
+    required?: boolean;
+    default?: number;
+}
+interface PluginCliEnumOption extends PluginCliOptionBase {
+    type: "enum";
+    values: readonly string[];
+    required?: boolean;
+    repeatable?: boolean;
+    /** Split each value on this separator, so `--kind a,b` is two values. */
+    split?: string;
+    default?: string;
+}
+/** A duration parsed to milliseconds with the core CLI's grammar. */
+interface PluginCliDurationOption extends PluginCliOptionBase {
+    type: "duration";
+    /** Unit assumed for a bare number when `bareUnits` is absent. */
+    defaultUnit: PluginCliDurationUnit;
+    /**
+     * Units tried in order for a bare number, taking the first whose
+     * milliseconds fall inside `min`/`max`. Declare it when two units are
+     * plausible and their valid ranges do not overlap (`90` seconds versus
+     * `1500` milliseconds); a number matching neither is rejected with both
+     * forms named.
+     */
+    bareUnits?: readonly PluginCliDurationUnit[];
+    /** Inclusive bounds in milliseconds. */
+    min?: number;
+    max?: number;
+    required?: boolean;
+    /** Default in milliseconds. */
+    default?: number;
+}
+type PluginCliOption = PluginCliBooleanOption | PluginCliStringOption | PluginCliIntegerOption | PluginCliEnumOption | PluginCliDurationOption;
+interface PluginCliPositional {
+    name: string;
+    description: string;
+    required?: boolean;
+    /** Collects every remaining bare token into a string array. */
+    variadic?: boolean;
+}
+/**
+ * Relationships between options that the parser enforces before `run`.
+ * Rules that depend on a value (which options a `--backend` choice allows)
+ * belong in `run`, raised as `PluginCliError`.
+ */
+type PluginCliConstraint = {
+    kind: "exactly-one";
+    options: readonly string[];
+} | {
+    kind: "at-most-one";
+    options: readonly string[];
+} | {
+    kind: "at-least-one";
+    options: readonly string[];
+} | {
+    kind: "requires";
+    option: string;
+    needs: readonly string[];
+};
+type CliOptions = Record<string, PluginCliOption>;
+type CliPositionals = readonly PluginCliPositional[];
+type OptionValue<TOption> = TOption extends {
+    type: "boolean";
+} ? boolean : TOption extends {
+    type: "enum";
+    values: readonly (infer TValue)[];
+} ? TValue : TOption extends {
+    type: "string";
+} ? string : number;
+type OptionResolved<TOption> = TOption extends {
+    type: "boolean";
+} ? boolean : TOption extends {
+    repeatable: true;
+} ? OptionValue<TOption>[] : TOption extends {
+    required: true;
+} ? OptionValue<TOption> : TOption extends {
+    default: unknown;
+} ? OptionValue<TOption> : OptionValue<TOption> | undefined;
+/** Validated option values, keyed by the spec's option names. */
+type PluginCliOptionValues<TOptions extends CliOptions> = {
+    [TName in keyof TOptions]: OptionResolved<TOptions[TName]>;
+};
+/** Validated positional values, keyed by the spec's positional names. */
+type PluginCliPositionalValues<TPositionals extends CliPositionals> = {
+    [TEntry in TPositionals[number] as TEntry["name"]]: TEntry extends {
+        variadic: true;
+    } ? string[] : TEntry extends {
+        required: true;
+    } ? string : string | undefined;
+};
+/** What a command's `run` receives once every value has been validated. */
+interface PluginCliRunInput<TOptions extends CliOptions = CliOptions, TPositionals extends CliPositionals = CliPositionals> {
+    options: PluginCliOptionValues<TOptions>;
+    positionals: PluginCliPositionalValues<TPositionals>;
+    /** Tokens after `--` when the command declares `passthrough`. */
+    passthrough: string[];
+    /** This command's rendered `--help` text. */
+    help: string;
+}
+type ErasedOptionValue = string | number | boolean | string[] | undefined;
+interface ErasedRunInput {
+    options: Record<string, ErasedOptionValue>;
+    positionals: Record<string, string | string[] | undefined>;
+    passthrough: string[];
+    help: string;
+}
+/**
+ * One command as `defineCli` consumes it. Build it with
+ * `cliCommand` so `run` receives typed values. The declaration
+ * is inert data: help and usage render from it without running the command.
+ */
+interface PluginCliCommand {
+    summary: string;
+    description?: string;
+    /** Extra invocation paths that run this command, hidden from help. */
+    aliases?: readonly string[];
+    /** Mistyped command names that should suggest this command. */
+    suggestFor?: readonly string[];
+    hidden?: boolean;
+    options?: CliOptions;
+    positionals?: CliPositionals;
+    constraints?: readonly PluginCliConstraint[];
+    /** Put tokens after `--` in `input.passthrough` instead of positionals. */
+    passthrough?: boolean;
+    /** Hint added when an unexpected bare token is passed. */
+    unexpectedPositionalHint?: string;
+    run(input: ErasedRunInput, ctx: PluginCliContext): PluginCliResult | Promise<PluginCliResult>;
+}
+/** The declarative CLI a plugin hands to `bb.cli.register`. */
+interface PluginCliSpec {
+    /** Top-level command name (`bb <name> …`): lowercase `[a-z0-9-]+`. */
+    name: string;
+    summary: string;
+    /** Prose printed under the summary in top-level help. */
+    description?: string;
+    /** Runs when the invocation names no command (`bb connect --code …`). */
+    root?: PluginCliCommand;
+    /** Commands keyed by invocation path (`"add"`, `"account add"`). */
+    commands: Record<string, PluginCliCommand>;
+    /** Exit code for usage errors; defaults to 1. */
+    usageErrorExitCode?: number;
+}
+/**
+ * A failure a command raises itself, reported exactly like a parse error:
+ * human text on stderr, plus the `{ ok: false, error }` envelope on stdout
+ * when the invocation carries `--json`.
+ */
+declare class PluginCliError extends Error {
+    readonly code: string;
+    readonly hint: string | undefined;
+    readonly exitCode: number;
+    constructor(message: string, options?: {
+        code?: string;
+        hint?: string;
+        exitCode?: number;
+    });
+}
+/**
+ * Declares one command. Inference flows from `options` and `positionals`
+ * into `run`, so `input.options.scope` is the declared enum union and a
+ * required option is never `undefined`.
+ */
+declare function cliCommand<const TOptions extends CliOptions = Record<string, never>, const TPositionals extends CliPositionals = readonly []>(command: {
+    summary: string;
+    description?: string;
+    aliases?: readonly string[];
+    suggestFor?: readonly string[];
+    hidden?: boolean;
+    options?: TOptions;
+    positionals?: TPositionals;
+    constraints?: readonly PluginCliConstraint[];
+    passthrough?: boolean;
+    unexpectedPositionalHint?: string;
+    run(input: PluginCliRunInput<TOptions, TPositionals>, ctx: PluginCliContext): PluginCliResult | Promise<PluginCliResult>;
+}): PluginCliCommand;
+/**
+ * Turns a declarative spec into a `PluginCliRegistration`, so every plugin
+ * CLI parses argv, renders `--help`, and fails the same way.
+ *
+ * `--help`, `-h` and a leading `help` word exit 0 at any level and never run
+ * a command. Unknown commands and options suggest the nearest declared name,
+ * every missing required value is reported in one error, and an invocation
+ * carrying `--json` adds the `{ ok: false, error: { code, message, hint? } }`
+ * envelope on stdout while stderr keeps the human-readable text.
+ */
+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, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, 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, 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, PluginEnvironmentProviderDeclaration, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, PluginEnvironmentProviderRequirements, 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, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginStatusApi, PluginStorage, PluginTargetedPanelActionOpenOptions, PluginThreadEventHandler, PluginThreadEventName, PluginThreadEventPayloads, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, PluginTurnFailedEvent, PluginUi, ReadonlyJsonValue, ServerAccessGrant, ServerAccessProviderDeclaration, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps, UseBranchesArgs, UseCheckoutStateArgs };