@get-bb/plugin-sdk 0.4.97 → 0.4.99

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

@@ -192,6 +192,7 @@ declare const promptInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             }>;
             trigger: z.ZodEnum<{
                 "/": "/";
+                $: "$";
             }>;
         }, z.core.$strip>, z.ZodObject<{
             icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -258,6 +259,7 @@ declare const providerInfoSchema: z.ZodObject<{
         kind: z.ZodLiteral<"skills">;
         trigger: z.ZodEnum<{
             "/": "/";
+            $: "$";
         }>;
     }, z.core.$strip>, z.ZodObject<{
         command: z.ZodObject<{
@@ -265,6 +267,7 @@ declare const providerInfoSchema: z.ZodObject<{
             trailingText: z.ZodString;
             trigger: z.ZodEnum<{
                 "/": "/";
+                $: "$";
             }>;
         }, z.core.$strip>;
         kind: z.ZodLiteral<"plan">;
@@ -274,6 +277,7 @@ declare const providerInfoSchema: z.ZodObject<{
             trailingText: z.ZodString;
             trigger: z.ZodEnum<{
                 "/": "/";
+                $: "$";
             }>;
         }, z.core.$strip>;
         kind: z.ZodLiteral<"goal">;
@@ -579,6 +583,34 @@ interface PluginThreadHeaderActionProps {
      */
     isCompactViewport: boolean;
 }
+/** JavaScript world a Browser page expression runs in. */
+type ExperimentalPluginBrowserPageWorld = "isolated" | "main";
+interface ExperimentalPluginBrowserPageEvaluateOptions {
+    /**
+     * `isolated` (default) runs in a BB-owned world that shares the page DOM but
+     * not page globals, and binds `bb.postMessage(data)`. `main` runs beside the
+     * page's own scripts, where `bb` is `null`.
+     */
+    world?: ExperimentalPluginBrowserPageWorld;
+}
+/**
+ * Script access to the top-level document of one Browser tab. Independent of
+ * CDP control leases: it never attaches a debugger or shows a control banner.
+ */
+interface ExperimentalPluginBrowserPage {
+    /**
+     * Evaluate a JavaScript expression and resolve its JSON-serialized value.
+     * Promises are awaited and `undefined` resolves to `null`. The expression
+     * can reference `bb`. Rejects when the tab is gone or the expression throws.
+     * Anything the expression installs is lost when the document navigates.
+     */
+    evaluate(expression: string, options?: ExperimentalPluginBrowserPageEvaluateOptions): Promise<JsonValue$1>;
+    /**
+     * Subscribe to values this plugin's isolated-world scripts in this tab send
+     * with `bb.postMessage(data)`. Returns the unsubscribe function.
+     */
+    onMessage(listener: (data: JsonValue$1) => void): () => void;
+}
 interface ExperimentalPluginBrowserToolbarActionProps {
     /** Thread that owns the Browser tab. */
     threadId: string;
@@ -588,6 +620,8 @@ interface ExperimentalPluginBrowserToolbarActionProps {
     url: string;
     /** True when the Browser chrome needs compact controls. */
     isCompactViewport: boolean;
+    /** Script access to this tab's page; `null` outside the desktop app. */
+    experimental_page: ExperimentalPluginBrowserPage | null;
 }
 /**
  * Where a file being opened by a `fileOpener` lives. `path` semantics follow
@@ -2178,6 +2212,13 @@ interface PluginComposerApi {
      * content should be fetched fresh when the message is sent.
      */
     insertMention(mention: PluginComposerMention): void;
+    /** Remove this plugin's matching mention pills and their text from the current draft. */
+    experimental_removeMention(mention: {
+        provider: string;
+        id: string;
+    }): void;
+    /** Subscribe to successful local submissions in this composer scope, including accepted queued messages. Failed sends and draft clearing do not notify. Dispose on unmount. */
+    experimental_onSubmitted(listener: () => void): () => void;
     /** Focus the composer caret at the end of the draft. */
     focus(): void;
     /**
@@ -2890,4 +2931,4 @@ declare const experimental_useProviders: () => PluginProvidersState;
 declare const experimental_useCodeTheme: () => PluginCodeThemeState;
 
 export { Markdown, ThreadChat, UrlLink, definePluginApp, experimental_BranchPicker, experimental_Diff, experimental_FileLink, experimental_Icon, experimental_NewThreadComposer, experimental_PermissionModePicker, experimental_ProviderIcon, experimental_ProviderModelPicker, experimental_SourceCode, experimental_useAppPanel, experimental_useBranches, experimental_useCheckoutState, experimental_useCodeTheme, experimental_useFixedTabTarget, experimental_useProviders, experimental_useSidebarThreadActions, experimental_useSidebarThreadPullRequest, experimental_useSidebarThreadSplit, experimental_useSidebarThreads, useBbContext, useBbNavigate, useComposer, useComposerView, useRealtime, useRealtimeConnectionState, useRpc, useSettings };
-export type { BbContext, BbNavigate, BranchPickerProps, BranchesState, CheckoutState, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppIcons, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSubmitOptions, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalIconProps, ExperimentalIconRegistration, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginBrowserToolbarActionProps, ExperimentalPluginBrowserToolbarActionRegistration, ExperimentalPluginFixedTabReference, ExperimentalProviderIconProps, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalSidebarFooter, ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterActionRegistration, ExperimentalSidebarFooterDisclosureController, ExperimentalSidebarFooterDisclosureProps, ExperimentalSidebarFooterDisclosureRegistration, ExperimentalSidebarFooterItemBase, ExperimentalSidebarFooterItemRegistration, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, JsonValue$1 as JsonValue, MarkdownProps, NewThreadComposerProps, NewThreadRequest, PluginAppBuilder, PluginAppCommands, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandContext, PluginCommandPaletteActionContext, PluginCommandPaletteActionRegistration, PluginCommandRegistration, PluginCommandShortcut, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, PluginFileOpenerProps, PluginFileOpenerRegistration, PluginFileOpenerSource, PluginFixedTabDeclaration, PluginFixedTabRegistration, PluginHomepageSectionProps, PluginHomepageSectionRegistration, PluginMachineProviderInputsChange, PluginMachineProviderInputsProps, PluginMachineProviderInputsRegistration, PluginMessageActionContext, PluginMessageActionRegistration, PluginMessageDirectiveMessage, PluginMessageDirectiveOpenWorkspaceFile, PluginMessageDirectiveProps, PluginMessageDirectiveRegistration, PluginNavPanelProps, PluginNavPanelRegistration, PluginNewThreadPanelActionContext, PluginNewThreadPanelActionRegistration, PluginNewThreadPanelProps, PluginPanelActionOpenOptions, PluginPendingInteractionProps, PluginPendingInteractionRegistration, PluginPendingInteractionView, PluginProviderIconRegistration, PluginProvidersState, PluginRealtimeConnectionState, PluginRpcCallArgs, PluginRpcClient, PluginRpcContract, PluginRpcError, PluginRpcErrorCode, PluginRpcHandlers, PluginRpcIssuePathSegment, PluginRpcMethodContract, PluginRpcResult, PluginRpcValidationIssue, PluginSdkApp, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsState, PluginSidebarFooterActionContext, PluginSidebarFooterActionProps, PluginSidebarFooterActionRegistration, PluginSidebarProject, PluginSidebarPullRequest, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginTargetedPanelActionOpenOptions, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, ReadonlyJsonValue, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps, UseBranchesArgs, UseCheckoutStateArgs };
+export type { BbContext, BbNavigate, BranchPickerProps, BranchesState, CheckoutState, CodeOverflowMode, ComposerCustomization, ComposerPlusMenuItem, ComposerRichTextSpec, ComposerStructuredDraft, ComposerView, DiffProps, DiffViewMode, ExperimentalAppIcons, ExperimentalAppOverlayProps, ExperimentalAppOverlayRegistration, ExperimentalAppPanel, ExperimentalAppPanelSurface, ExperimentalComposerSubmitOptions, ExperimentalDiffFileContent, ExperimentalDiffFullFileContents, ExperimentalFileLinkProps, ExperimentalFileLocation, ExperimentalFileOpenOptions, ExperimentalFixedTabTargetContract, ExperimentalFixedTabTargetState, ExperimentalIconProps, ExperimentalIconRegistration, ExperimentalLiveFileTarget, ExperimentalOpenFixedTabOptions, ExperimentalPermissionModePickerProps, ExperimentalPluginBrowserPage, ExperimentalPluginBrowserPageEvaluateOptions, ExperimentalPluginBrowserPageWorld, ExperimentalPluginBrowserToolbarActionProps, ExperimentalPluginBrowserToolbarActionRegistration, ExperimentalPluginFixedTabReference, ExperimentalProviderIconProps, ExperimentalProviderModelPickerProps, ExperimentalProviderModelPickerRouting, ExperimentalProviderModelPickerValue, ExperimentalSidebarFooter, ExperimentalSidebarFooterActionContext, ExperimentalSidebarFooterActionRegistration, ExperimentalSidebarFooterDisclosureController, ExperimentalSidebarFooterDisclosureProps, ExperimentalSidebarFooterDisclosureRegistration, ExperimentalSidebarFooterItemBase, ExperimentalSidebarFooterItemRegistration, ExperimentalSidebarNavigationAction, ExperimentalSidebarNavigationActivationOptions, ExperimentalSidebarNavigationIcon, ExperimentalSidebarNavigationItem, ExperimentalSidebarNavigationProps, ExperimentalSidebarNavigationRegistration, ExperimentalSidebarNavigationShortcut, JsonValue$1 as JsonValue, MarkdownProps, NewThreadComposerProps, NewThreadRequest, PluginAppBuilder, PluginAppCommands, PluginAppComposer, PluginAppContentScripts, PluginAppDefinition, PluginAppSetup, PluginAppSlots, PluginCodeThemeData, PluginCodeThemeState, PluginCodeThemeTokenRule, PluginCommandContext, PluginCommandPaletteActionContext, PluginCommandPaletteActionRegistration, PluginCommandRegistration, PluginCommandShortcut, PluginComposerApi, PluginComposerMention, PluginComposerScope, PluginComposerTextEffect, PluginComposerThreadRowStatus, PluginContentScriptContext, PluginContentScriptDisposer, PluginContentScriptRegistration, PluginDiffRendererProps, PluginDiffRendererRegistration, PluginEnvironmentProviderInputsChange, PluginEnvironmentProviderInputsProps, PluginEnvironmentProviderInputsRegistration, PluginFileOpenerProps, PluginFileOpenerRegistration, PluginFileOpenerSource, PluginFixedTabDeclaration, PluginFixedTabRegistration, PluginHomepageSectionProps, PluginHomepageSectionRegistration, PluginMachineProviderInputsChange, PluginMachineProviderInputsProps, PluginMachineProviderInputsRegistration, PluginMessageActionContext, PluginMessageActionRegistration, PluginMessageDirectiveMessage, PluginMessageDirectiveOpenWorkspaceFile, PluginMessageDirectiveProps, PluginMessageDirectiveRegistration, PluginNavPanelProps, PluginNavPanelRegistration, PluginNewThreadPanelActionContext, PluginNewThreadPanelActionRegistration, PluginNewThreadPanelProps, PluginPanelActionOpenOptions, PluginPendingInteractionProps, PluginPendingInteractionRegistration, PluginPendingInteractionView, PluginProviderIconRegistration, PluginProvidersState, PluginRealtimeConnectionState, PluginRpcCallArgs, PluginRpcClient, PluginRpcContract, PluginRpcError, PluginRpcErrorCode, PluginRpcHandlers, PluginRpcIssuePathSegment, PluginRpcMethodContract, PluginRpcResult, PluginRpcValidationIssue, PluginSdkApp, PluginSettingsSectionProps, PluginSettingsSectionRegistration, PluginSettingsState, PluginSidebarFooterActionContext, PluginSidebarFooterActionProps, PluginSidebarFooterActionRegistration, PluginSidebarProject, PluginSidebarPullRequest, PluginSidebarSplitPane, PluginSidebarThread, PluginSidebarThreadActions, PluginSidebarThreadActivity, PluginSidebarThreadIndicator, PluginSidebarThreadPullRequestState, PluginSidebarThreadSplit, PluginSidebarThreadsState, PluginSourceCodeRendererProps, PluginSourceCodeRendererRegistration, PluginTargetedPanelActionOpenOptions, PluginThreadHeaderActionProps, PluginThreadHeaderActionRegistration, PluginThreadListProps, PluginThreadListRegistration, PluginThreadPanelActionContext, PluginThreadPanelActionRegistration, PluginThreadPanelProps, PluginTimelineRendererProps, PluginTimelineRendererRegistration, PluginTimelineRendererRow, PluginTimelineRowPresentation, PluginTimelineRowStatus, ReadonlyJsonValue, SourceCodeLineRange, SourceCodeProps, StandardSchemaV1, StandardSchemaV1InferInput, StandardSchemaV1InferOutput, StandardSchemaV1Issue, StandardSchemaV1Result, ThreadChatMessageAction, ThreadChatMessageReference, ThreadChatProps, UrlLinkProps, UseBranchesArgs, UseCheckoutStateArgs };

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

@@ -143,6 +143,7 @@ declare const threadResponseSchema: z.ZodObject<{
     id: z.ZodString;
     lastReadAt: z.ZodNullable<z.ZodNumber>;
     latestAttentionAt: z.ZodNumber;
+    lifecycleOwnerThreadId: z.ZodNullable<z.ZodString>;
     originKind: z.ZodNullable<z.ZodEnum<{
         fork: "fork";
     }>>;

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

@@ -252,6 +252,7 @@ declare const promptInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             }>;
             trigger: z.ZodEnum<{
                 "/": "/";
+                $: "$";
             }>;
         }, z.core.$strip>, z.ZodObject<{
             icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -344,6 +345,7 @@ declare const threadQueuedMessageSchema: z.ZodObject<{
                 }>;
                 trigger: z.ZodEnum<{
                     "/": "/";
+                    $: "$";
                 }>;
             }, z.core.$strip>, z.ZodObject<{
                 icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -472,6 +474,7 @@ declare const threadResponseSchema: z.ZodObject<{
     id: z.ZodString;
     lastReadAt: z.ZodNullable<z.ZodNumber>;
     latestAttentionAt: z.ZodNumber;
+    lifecycleOwnerThreadId: z.ZodNullable<z.ZodString>;
     originKind: z.ZodNullable<z.ZodEnum<{
         fork: "fork";
     }>>;

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

@@ -3286,6 +3286,7 @@ declare const threadEventSchema: z.ZodPipe<z.ZodUnknown, z.ZodUnion<readonly [z.
             core: z.ZodEnum<{
                 "machine-environment": "machine-environment";
                 "machine-git": "machine-git";
+                "project-environment": "project-environment";
             }>;
         }, z.core.$strict>]>;
         value: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
@@ -3445,6 +3446,7 @@ declare const threadEventSchema: z.ZodPipe<z.ZodUnknown, z.ZodUnion<readonly [z.
                 }>;
                 trigger: z.ZodEnum<{
                     "/": "/";
+                    $: "$";
                 }>;
             }, z.core.$strip>, z.ZodObject<{
                 icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -3526,6 +3528,7 @@ declare const threadEventSchema: z.ZodPipe<z.ZodUnknown, z.ZodUnion<readonly [z.
                 }>;
                 trigger: z.ZodEnum<{
                     "/": "/";
+                    $: "$";
                 }>;
             }, z.core.$strip>, z.ZodObject<{
                 icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -4065,6 +4068,7 @@ declare const promptInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             }>;
             trigger: z.ZodEnum<{
                 "/": "/";
+                $: "$";
             }>;
         }, z.core.$strip>, z.ZodObject<{
             icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;

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

@@ -1375,6 +1375,7 @@ declare const permissionEscalationSchema: z.ZodEnum<{
 type PermissionEscalation = z.infer<typeof permissionEscalationSchema>;
 declare const promptMentionCommandTriggerSchema: z.ZodEnum<{
     "/": "/";
+    $: "$";
 }>;
 type PromptMentionCommandTrigger = z.infer<typeof promptMentionCommandTriggerSchema>;
 declare const promptInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1421,6 +1422,7 @@ declare const promptInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             }>;
             trigger: z.ZodEnum<{
                 "/": "/";
+                $: "$";
             }>;
         }, z.core.$strip>, z.ZodObject<{
             icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -4538,6 +4540,7 @@ declare const threadStartParamsSchema: z.ZodObject<{
                 }>;
                 trigger: z.ZodEnum<{
                     "/": "/";
+                    $: "$";
                 }>;
             }, z.core.$strip>, z.ZodObject<{
                 icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -4864,6 +4867,7 @@ declare const turnStartParamsSchema: z.ZodObject<{
                 }>;
                 trigger: z.ZodEnum<{
                     "/": "/";
+                    $: "$";
                 }>;
             }, z.core.$strip>, z.ZodObject<{
                 icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -4993,6 +4997,7 @@ declare const turnSteerParamsSchema: z.ZodObject<{
                 }>;
                 trigger: z.ZodEnum<{
                     "/": "/";
+                    $: "$";
                 }>;
             }, z.core.$strip>, z.ZodObject<{
                 icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;

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

@@ -274,6 +274,7 @@ declare const threadResponseSchema: z.ZodObject<{
     id: z.ZodString;
     lastReadAt: z.ZodNullable<z.ZodNumber>;
     latestAttentionAt: z.ZodNumber;
+    lifecycleOwnerThreadId: z.ZodNullable<z.ZodString>;
     originKind: z.ZodNullable<z.ZodEnum<{
         fork: "fork";
     }>>;