@get-bb/plugin-sdk 0.4.9 → 0.4.10

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

@@ -1195,10 +1195,39 @@ declare const jsonRpcErrorResponseSchema: z.ZodObject<{
 }, z.core.$strip>;
 type BridgeJsonRpcResponse = z.infer<typeof jsonRpcSuccessResponseSchema> | z.infer<typeof jsonRpcErrorResponseSchema>;
 declare function decodeBridgeJsonRpcResponse(input: unknown): BridgeJsonRpcResponse | null;
+/** An image on a tool call result, split out of an `inputImage` data URL. */
+interface BridgeToolCallImage {
+    data: string;
+    mimeType: string;
+}
+/**
+ * A tool result block in the one shape every consumer already accepts: MCP's
+ * `CallToolResult.content` (claude-code and acp) and pi's `AgentToolResult.content`
+ * declare the same two members with the same field names.
+ */
+type BridgeToolCallContent = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    data: string;
+    mimeType: string;
+};
 declare function decodeToolCallResponsePayload(result: unknown): {
     content: string;
+    contentBlocks: BridgeToolCallContent[];
+    images: BridgeToolCallImage[];
     isError: boolean;
 };
+/**
+ * Renders a decoded payload as tool result blocks, dropping empty text so an
+ * image-only result carries the image alone.
+ */
+declare function buildBridgeToolCallContent(result: {
+    content: string;
+    contentBlocks?: BridgeToolCallContent[];
+    images?: BridgeToolCallImage[];
+}): BridgeToolCallContent[];
 
 /**
  * Structural contracts shared by the runtime's generic adapter and the bridge
@@ -1296,6 +1325,10 @@ declare function mimeTypeFromExtension(filePath: string): string;
 
 interface BridgeToolCallResult {
     content: string;
+    /** Ordered provider result blocks; absent on local transport failures. */
+    contentBlocks?: BridgeToolCallContent[];
+    /** Absent on the failure paths below, which have no image to report. */
+    images?: BridgeToolCallImage[];
     isError?: boolean;
 }
 interface ForwardBridgeToolCallArgs {
@@ -1564,6 +1597,261 @@ declare const bridgeExecutionOptionsSchema: z.ZodIntersection<z.ZodObject<{
 }, z.core.$strip>], "permissionMode">>;
 type BridgeExecutionOptions = z.infer<typeof bridgeExecutionOptionsSchema>;
 
+/**
+ * Sessionless provider maintenance query. `providerOptions` carries the same
+ * provider-scoped statics as model/list (notably an ACP launch spec), while
+ * `providerId` lets one bridge implementation serve several provider ids.
+ */
+declare const experimental_providerMaintenanceParamsSchema: z.ZodObject<{
+    cwd: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodString;
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+type ExperimentalProviderMaintenanceParams = z.infer<typeof experimental_providerMaintenanceParamsSchema>;
+declare const experimental_providerInstallationRequirementSchema: z.ZodEnum<{
+    thread_rewind: "thread_rewind";
+}>;
+type ExperimentalProviderInstallationRequirement = z.infer<typeof experimental_providerInstallationRequirementSchema>;
+declare const experimental_providerInstallationStatusParamsSchema: z.ZodObject<{
+    cwd: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodString;
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    requirement: z.ZodOptional<z.ZodEnum<{
+        thread_rewind: "thread_rewind";
+    }>>;
+}, z.core.$loose>;
+type ExperimentalProviderInstallationStatusParams = z.infer<typeof experimental_providerInstallationStatusParamsSchema>;
+/**
+ * Cheap, host-local readiness reported by a provider implementation. Network
+ * usage and update checks deliberately live outside this result so choosing a
+ * provider for the composer never waits on them.
+ */
+declare const experimental_providerHealthSchema: z.ZodObject<{
+    accountEmail: z.ZodNullable<z.ZodString>;
+    canInstall: z.ZodBoolean;
+    canUpdate: z.ZodBoolean;
+    installedVersion: z.ZodNullable<z.ZodString>;
+    loginCommand: z.ZodNullable<z.ZodString>;
+    minimumSupportedVersion: z.ZodNullable<z.ZodString>;
+    planLabel: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        expired: "expired";
+        not_installed: "not_installed";
+        ready: "ready";
+        unauthenticated: "unauthenticated";
+        unknown: "unknown";
+        unsupported_version: "unsupported_version";
+    }>;
+    statusMessage: z.ZodNullable<z.ZodString>;
+}, z.core.$loose>;
+type ExperimentalProviderHealth = z.infer<typeof experimental_providerHealthSchema>;
+/** One usage window reported by a provider subscription. */
+declare const experimental_providerUsageWindowSchema: z.ZodObject<{
+    cost: z.ZodOptional<z.ZodObject<{
+        limitUsdCents: z.ZodNumber;
+        usedUsdCents: z.ZodNumber;
+    }, z.core.$strip>>;
+    label: z.ZodString;
+    resetsAt: z.ZodNullable<z.ZodString>;
+    usedPercent: z.ZodNumber;
+}, z.core.$loose>;
+type ExperimentalProviderUsageWindow = z.infer<typeof experimental_providerUsageWindowSchema>;
+/** Live usage for one provider, normalized by that provider's bridge. */
+declare const experimental_providerUsageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    accountEmail: z.ZodNullable<z.ZodString>;
+    planLabel: z.ZodNullable<z.ZodString>;
+    status: z.ZodLiteral<"ok">;
+    windows: z.ZodArray<z.ZodObject<{
+        cost: z.ZodOptional<z.ZodObject<{
+            limitUsdCents: z.ZodNumber;
+            usedUsdCents: z.ZodNumber;
+        }, z.core.$strip>>;
+        label: z.ZodString;
+        resetsAt: z.ZodNullable<z.ZodString>;
+        usedPercent: z.ZodNumber;
+    }, z.core.$loose>>;
+}, z.core.$loose>, z.ZodObject<{
+    status: z.ZodLiteral<"not_installed">;
+}, z.core.$loose>, z.ZodObject<{
+    status: z.ZodLiteral<"unauthenticated">;
+}, z.core.$loose>, z.ZodObject<{
+    status: z.ZodLiteral<"expired">;
+}, z.core.$loose>, z.ZodObject<{
+    accountEmail: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    message: z.ZodString;
+    planLabel: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    status: z.ZodLiteral<"error">;
+}, z.core.$loose>], "status">;
+type ExperimentalProviderUsage = z.infer<typeof experimental_providerUsageSchema>;
+declare const experimental_providerHealthResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    supported: z.ZodLiteral<false>;
+}, z.core.$loose>, z.ZodObject<{
+    health: z.ZodObject<{
+        accountEmail: z.ZodNullable<z.ZodString>;
+        canInstall: z.ZodBoolean;
+        canUpdate: z.ZodBoolean;
+        installedVersion: z.ZodNullable<z.ZodString>;
+        loginCommand: z.ZodNullable<z.ZodString>;
+        minimumSupportedVersion: z.ZodNullable<z.ZodString>;
+        planLabel: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<{
+            expired: "expired";
+            not_installed: "not_installed";
+            ready: "ready";
+            unauthenticated: "unauthenticated";
+            unknown: "unknown";
+            unsupported_version: "unsupported_version";
+        }>;
+        statusMessage: z.ZodNullable<z.ZodString>;
+    }, z.core.$loose>;
+    supported: z.ZodLiteral<true>;
+}, z.core.$loose>], "supported">;
+type ExperimentalProviderHealthResult = z.infer<typeof experimental_providerHealthResultSchema>;
+declare const experimental_providerUsageResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    supported: z.ZodLiteral<false>;
+}, z.core.$loose>, z.ZodObject<{
+    supported: z.ZodLiteral<true>;
+    usage: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        accountEmail: z.ZodNullable<z.ZodString>;
+        planLabel: z.ZodNullable<z.ZodString>;
+        status: z.ZodLiteral<"ok">;
+        windows: z.ZodArray<z.ZodObject<{
+            cost: z.ZodOptional<z.ZodObject<{
+                limitUsdCents: z.ZodNumber;
+                usedUsdCents: z.ZodNumber;
+            }, z.core.$strip>>;
+            label: z.ZodString;
+            resetsAt: z.ZodNullable<z.ZodString>;
+            usedPercent: z.ZodNumber;
+        }, z.core.$loose>>;
+    }, z.core.$loose>, z.ZodObject<{
+        status: z.ZodLiteral<"not_installed">;
+    }, z.core.$loose>, z.ZodObject<{
+        status: z.ZodLiteral<"unauthenticated">;
+    }, z.core.$loose>, z.ZodObject<{
+        status: z.ZodLiteral<"expired">;
+    }, z.core.$loose>, z.ZodObject<{
+        accountEmail: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        message: z.ZodString;
+        planLabel: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        status: z.ZodLiteral<"error">;
+    }, z.core.$loose>], "status">;
+}, z.core.$loose>], "supported">;
+type ExperimentalProviderUsageResult = z.infer<typeof experimental_providerUsageResultSchema>;
+declare const experimental_providerInstallationActionKindSchema: z.ZodEnum<{
+    install: "install";
+    update: "update";
+}>;
+type ExperimentalProviderInstallationActionKind = z.infer<typeof experimental_providerInstallationActionKindSchema>;
+/**
+ * An installation action that a provider currently knows how to perform.
+ * Only the display command crosses the product boundary; the executable plan
+ * is resolved afresh by `provider/installation/run` on the host.
+ */
+declare const experimental_providerInstallationActionSchema: z.ZodObject<{
+    command: z.ZodString;
+    kind: z.ZodEnum<{
+        install: "install";
+        update: "update";
+    }>;
+    label: z.ZodEnum<{
+        Install: "Install";
+        Update: "Update";
+    }>;
+}, z.core.$loose>;
+type ExperimentalProviderInstallationAction = z.infer<typeof experimental_providerInstallationActionSchema>;
+declare const experimental_providerInstallationSourceSchema: z.ZodEnum<{
+    external: "external";
+    notInstalled: "notInstalled";
+    npmGlobal: "npmGlobal";
+}>;
+type ExperimentalProviderInstallationSource = z.infer<typeof experimental_providerInstallationSourceSchema>;
+/** Provider-owned installation and update state for one host. */
+declare const experimental_providerInstallationStatusSchema: z.ZodObject<{
+    currentVersion: z.ZodNullable<z.ZodString>;
+    executableName: z.ZodString;
+    executablePath: z.ZodNullable<z.ZodString>;
+    installAction: z.ZodNullable<z.ZodObject<{
+        command: z.ZodString;
+        kind: z.ZodEnum<{
+            install: "install";
+            update: "update";
+        }>;
+        label: z.ZodEnum<{
+            Install: "Install";
+            Update: "Update";
+        }>;
+    }, z.core.$loose>>;
+    installSource: z.ZodEnum<{
+        external: "external";
+        notInstalled: "notInstalled";
+        npmGlobal: "npmGlobal";
+    }>;
+    installed: z.ZodBoolean;
+    latestVersion: z.ZodNullable<z.ZodString>;
+    minimumSupportedVersion: z.ZodNullable<z.ZodString>;
+    needsUpdate: z.ZodBoolean;
+    npmGlobalPackageVersion: z.ZodNullable<z.ZodString>;
+    npmPackageName: z.ZodNullable<z.ZodString>;
+    versionUnsupported: z.ZodBoolean;
+}, z.core.$loose>;
+type ExperimentalProviderInstallationStatus = z.infer<typeof experimental_providerInstallationStatusSchema>;
+declare const experimental_providerInstallationRunParamsSchema: z.ZodObject<{
+    action: z.ZodEnum<{
+        install: "install";
+        update: "update";
+    }>;
+    cwd: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodString;
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+type ExperimentalProviderInstallationRunParams = z.infer<typeof experimental_providerInstallationRunParamsSchema>;
+/**
+ * A typed process plan. The provider chooses the executable and arguments;
+ * the daemon chooses the environment and cwd and owns process supervision.
+ */
+declare const experimental_providerInstallationCommandSchema: z.ZodObject<{
+    args: z.ZodArray<z.ZodString>;
+    command: z.ZodString;
+    displayCommand: z.ZodString;
+}, z.core.$loose>;
+type ExperimentalProviderInstallationCommand = z.infer<typeof experimental_providerInstallationCommandSchema>;
+declare const experimental_providerInstallationVerificationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"installed">;
+}, z.core.$loose>, z.ZodObject<{
+    kind: z.ZodLiteral<"version_changed">;
+    previousVersion: z.ZodString;
+}, z.core.$loose>, z.ZodObject<{
+    kind: z.ZodLiteral<"version_at_least">;
+    version: z.ZodString;
+}, z.core.$loose>], "kind">;
+type ExperimentalProviderInstallationVerification = z.infer<typeof experimental_providerInstallationVerificationSchema>;
+/**
+ * `available: false` handles a stale action safely: status may have changed
+ * between rendering a button and the daemon resolving the execution plan.
+ */
+declare const experimental_providerInstallationRunResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    available: z.ZodLiteral<false>;
+    message: z.ZodString;
+}, z.core.$loose>, z.ZodObject<{
+    available: z.ZodLiteral<true>;
+    command: z.ZodObject<{
+        args: z.ZodArray<z.ZodString>;
+        command: z.ZodString;
+        displayCommand: z.ZodString;
+    }, z.core.$loose>;
+    verification: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"installed">;
+    }, z.core.$loose>, z.ZodObject<{
+        kind: z.ZodLiteral<"version_changed">;
+        previousVersion: z.ZodString;
+    }, z.core.$loose>, z.ZodObject<{
+        kind: z.ZodLiteral<"version_at_least">;
+        version: z.ZodString;
+    }, z.core.$loose>], "kind">;
+}, z.core.$loose>], "available">;
+type ExperimentalProviderInstallationRunResult = z.infer<typeof experimental_providerInstallationRunResultSchema>;
+
 /**
  * Canonical runtime → bridge request methods. One vocabulary for every
  * provider: a bridge maps these to its provider's native dialect internally
@@ -1574,6 +1862,10 @@ type BridgeExecutionOptions = z.infer<typeof bridgeExecutionOptionsSchema>;
 declare const BRIDGE_REQUEST_METHODS: {
     readonly initialize: "initialize";
     readonly modelList: "model/list";
+    readonly experimentalProviderHealth: "provider/health";
+    readonly experimentalProviderUsage: "provider/usage";
+    readonly experimentalProviderInstallationStatus: "provider/installation/status";
+    readonly experimentalProviderInstallationRun: "provider/installation/run";
     readonly threadStart: "thread/start";
     readonly threadResume: "thread/resume";
     readonly threadFork: "thread/fork";
@@ -4038,5 +4330,5 @@ declare const hostDaemonAcpLaunchSpecSchema: z.ZodObject<{
 type HostDaemonAcpLaunchSpec = z.infer<typeof hostDaemonAcpLaunchSpecSchema>;
 declare function normalizeHostDaemonAcpLaunchSpec(spec: HostDaemonAcpLaunchSpec): HostDaemonAcpLaunchSpec;
 
-export { BRIDGE_INBOUND_REQUEST_METHODS, BRIDGE_JSON_RPC_ERRORS, BRIDGE_NOTIFICATION_METHODS, BRIDGE_REQUEST_METHODS, HIGH_REASONING_EFFORT, LOCAL_BASH_TASK_TYPE, LOCAL_WORKFLOW_TASK_TYPE, LOW_REASONING_EFFORT, MAX_REASONING_EFFORT, MEDIUM_REASONING_EFFORT, PROVIDER_BRIDGE_EXPORT_NAME, PROVIDER_BRIDGE_PROTOCOL_VERSION, ProviderRequestDecodeError, ProviderResponseEncodeError, THREAD_DELTA_NOTIFICATION_METHOD, ULTRACODE_REASONING_EFFORT, USER_QUESTION_MAX_OPTIONS, USER_QUESTION_MAX_QUESTIONS, XHIGH_REASONING_EFFORT, acpNativeReasoningSchema, acpPermissionCliSchema, acpReasoningCliSchema, backgroundTaskItemStatus, bashArgsSchema, bridgeRequestEnvelopeSchema, buildShellEnvOverrides, claudeTaskToolNameSchema, claudeTaskToolOutputSchema, createBridgeIo, createBridgeLineHandler, createPendingToolCallTracker, createProviderVisibilityMetadata, decodeBridgeJsonRpcResponse, decodeToolCallResponsePayload, deltaBackgroundTaskShapeSchema, deltaFileChangeSchema, deltaItemKeySchema, deltaItemShapeSchema, deltaMessageChannelSchema, deltaNoTurnFallbackSchema, deltaOutputChannelSchema, deltaTextChannelSchema, dynamicToolSchema, errorEnvelopeSchema, experimental_defineProviderBridge, extractResultText, getRawSdkMessage, getRecordProperty, getStringProperty, hostDaemonAcpLaunchSpecSchema, initializeParamsSchema, instructionModeValues, isApprovalPendingInteractionPayload, isApprovalPendingInteractionResolution, isBackgroundAgentTaskType, isRecord, isSettledBackgroundTaskStatus, isStandaloneBuiltinCompactCommand, isUserQuestionPendingInteractionPayload, isUserQuestionPendingInteractionResolution, jsonRpcEnvelopeSchema, jsonValueSchema, mimeTypeFromExtension, modelListParamsSchema, normalizeHostDaemonAcpLaunchSpec, normalizeProviderCommandOutput, pendingInteractionCommandActionSchema, pendingInteractionFileSystemPermissionsSchema, pendingInteractionMacOsPermissionsSchema, pendingInteractionNetworkPermissionsSchema, pendingInteractionRequestedPermissionProfileSchema, pendingInteractionResolutionSchema, permissionEscalationValues, providerRawEventSchema, reasoningEffortsForLevels, reasoningLevelSchema, reasoningLevelValues, removeCommandMentionsFromPromptInput, runBridgeRequest, runtimePermissionScopeValues, sanitizeInheritedChildProcessEnv, sdkMessageEnvelopeSchema, shouldAutoDenyInteractiveRequest, skillsConfigureParamsSchema, textBlockSchema, threadArchiveParamsSchema, threadContextWindowUsageEnvelopeSchema, threadDeltaNotificationParamsSchema, threadDeltaSchema, threadDiscardParamsSchema, threadForkParamsSchema, threadGoalClearParamsSchema, threadIdentityEnvelopeSchema, threadNameSetParamsSchema, threadResumeParamsSchema, threadStartParamsSchema, threadStopParamsSchema, threadUnarchiveParamsSchema, toNonNegativeNumber, toOptionalRecord, toOptionalString, toPositiveNumber, turnStartParamsSchema, turnSteerParamsSchema, withoutBridgeRuntimeEnv };
-export type { ApprovalPendingInteractionPayload, AvailableModel, BackgroundTaskStatus, BackgroundTaskUsage, BridgeExecutionOptions, BridgeJsonRpcResponse, BridgeToolCallRequest, BuildInteractiveResponseArgs, ClaudeTaskToolOutput, ClientTurnRequestId, DecodedInteractiveRequest, DeltaBackgroundTaskShape, DeltaFileChange, DeltaItemKey, DeltaItemShape, DeltaMessageChannel, DeltaNoTurnFallback, DeltaOutputChannel, DeltaTextChannel, DynamicTool, HostDaemonAcpLaunchSpec, InitializeResult, InstructionMode, JsonObject, JsonRpcMessage, JsonValue, ModelReasoningEffort, PendingInteractionApprovalDecision, PendingInteractionApprovalSubject, PendingInteractionCommandAction, PendingInteractionGrantablePermissionProfile, PendingInteractionGrantedPermissionProfile, PendingInteractionPayload, PendingInteractionRequestedPermissionProfile, PendingInteractionResolution, PendingInteractionUserQuestionQuestion, PermissionEscalation, PermissionMode, PreparedProviderCommandDispatch, PromptInput, ProviderBridgeContext, ProviderBridgeDefinition, ProviderBridgeEntry, ProviderErrorCategory, ProviderErrorInfo, ProviderInboundRequest, ProviderPostInitializeRequest, ProviderRateLimitState, ProviderRateLimitStatus, ProviderRateLimitWindow, ProviderRawEvent, ProviderRawEventCoverage, ProviderRawEventDescription, ProviderRuntimeEvent, ProviderVisibilityMetadata, ReasoningLevel, RuntimePermissionPolicy, RuntimePermissionScope, ServiceTier, ThreadDelta, ThreadDeltaKind, ThreadDeltaNotificationParams, ThreadEventContextWindowUsage, ThreadEventItemStatus, ThreadEventPlanStep, ThreadEventTokenUsageBreakdown, ThreadEventTurnStatus, ThreadEventUserContent, UserQuestionPendingInteractionPayload, UserQuestionPendingInteractionResolution, WorkflowAgentSnapshot, WorkflowAgentState, WorkflowPhaseSnapshot, WorkflowProgressSnapshot };
+export { BRIDGE_INBOUND_REQUEST_METHODS, BRIDGE_JSON_RPC_ERRORS, BRIDGE_NOTIFICATION_METHODS, BRIDGE_REQUEST_METHODS, HIGH_REASONING_EFFORT, LOCAL_BASH_TASK_TYPE, LOCAL_WORKFLOW_TASK_TYPE, LOW_REASONING_EFFORT, MAX_REASONING_EFFORT, MEDIUM_REASONING_EFFORT, PROVIDER_BRIDGE_EXPORT_NAME, PROVIDER_BRIDGE_PROTOCOL_VERSION, ProviderRequestDecodeError, ProviderResponseEncodeError, THREAD_DELTA_NOTIFICATION_METHOD, ULTRACODE_REASONING_EFFORT, USER_QUESTION_MAX_OPTIONS, USER_QUESTION_MAX_QUESTIONS, XHIGH_REASONING_EFFORT, acpNativeReasoningSchema, acpPermissionCliSchema, acpReasoningCliSchema, backgroundTaskItemStatus, bashArgsSchema, bridgeRequestEnvelopeSchema, buildShellEnvOverrides, claudeTaskToolNameSchema, claudeTaskToolOutputSchema, createBridgeIo, createBridgeLineHandler, createPendingToolCallTracker, createProviderVisibilityMetadata, decodeBridgeJsonRpcResponse, decodeToolCallResponsePayload, deltaBackgroundTaskShapeSchema, deltaFileChangeSchema, deltaItemKeySchema, deltaItemShapeSchema, deltaMessageChannelSchema, deltaNoTurnFallbackSchema, deltaOutputChannelSchema, deltaTextChannelSchema, dynamicToolSchema, errorEnvelopeSchema, buildBridgeToolCallContent as experimental_buildBridgeToolCallContent, experimental_defineProviderBridge, experimental_providerHealthResultSchema, experimental_providerHealthSchema, experimental_providerInstallationActionKindSchema, experimental_providerInstallationActionSchema, experimental_providerInstallationCommandSchema, experimental_providerInstallationRequirementSchema, experimental_providerInstallationRunParamsSchema, experimental_providerInstallationRunResultSchema, experimental_providerInstallationSourceSchema, experimental_providerInstallationStatusParamsSchema, experimental_providerInstallationStatusSchema, experimental_providerInstallationVerificationSchema, experimental_providerMaintenanceParamsSchema, experimental_providerUsageResultSchema, experimental_providerUsageSchema, experimental_providerUsageWindowSchema, extractResultText, getRawSdkMessage, getRecordProperty, getStringProperty, hostDaemonAcpLaunchSpecSchema, initializeParamsSchema, instructionModeValues, isApprovalPendingInteractionPayload, isApprovalPendingInteractionResolution, isBackgroundAgentTaskType, isRecord, isSettledBackgroundTaskStatus, isStandaloneBuiltinCompactCommand, isUserQuestionPendingInteractionPayload, isUserQuestionPendingInteractionResolution, jsonRpcEnvelopeSchema, jsonValueSchema, mimeTypeFromExtension, modelListParamsSchema, normalizeHostDaemonAcpLaunchSpec, normalizeProviderCommandOutput, pendingInteractionCommandActionSchema, pendingInteractionFileSystemPermissionsSchema, pendingInteractionMacOsPermissionsSchema, pendingInteractionNetworkPermissionsSchema, pendingInteractionRequestedPermissionProfileSchema, pendingInteractionResolutionSchema, permissionEscalationValues, providerRawEventSchema, reasoningEffortsForLevels, reasoningLevelSchema, reasoningLevelValues, removeCommandMentionsFromPromptInput, runBridgeRequest, runtimePermissionScopeValues, sanitizeInheritedChildProcessEnv, sdkMessageEnvelopeSchema, shouldAutoDenyInteractiveRequest, skillsConfigureParamsSchema, textBlockSchema, threadArchiveParamsSchema, threadContextWindowUsageEnvelopeSchema, threadDeltaNotificationParamsSchema, threadDeltaSchema, threadDiscardParamsSchema, threadForkParamsSchema, threadGoalClearParamsSchema, threadIdentityEnvelopeSchema, threadNameSetParamsSchema, threadResumeParamsSchema, threadStartParamsSchema, threadStopParamsSchema, threadUnarchiveParamsSchema, toNonNegativeNumber, toOptionalRecord, toOptionalString, toPositiveNumber, turnStartParamsSchema, turnSteerParamsSchema, withoutBridgeRuntimeEnv };
+export type { ApprovalPendingInteractionPayload, AvailableModel, BackgroundTaskStatus, BackgroundTaskUsage, BridgeExecutionOptions, BridgeJsonRpcResponse, BridgeToolCallRequest, BuildInteractiveResponseArgs, ClaudeTaskToolOutput, ClientTurnRequestId, DecodedInteractiveRequest, DeltaBackgroundTaskShape, DeltaFileChange, DeltaItemKey, DeltaItemShape, DeltaMessageChannel, DeltaNoTurnFallback, DeltaOutputChannel, DeltaTextChannel, DynamicTool, ExperimentalProviderHealth, ExperimentalProviderHealthResult, ExperimentalProviderInstallationAction, ExperimentalProviderInstallationActionKind, ExperimentalProviderInstallationCommand, ExperimentalProviderInstallationRequirement, ExperimentalProviderInstallationRunParams, ExperimentalProviderInstallationRunResult, ExperimentalProviderInstallationSource, ExperimentalProviderInstallationStatus, ExperimentalProviderInstallationStatusParams, ExperimentalProviderInstallationVerification, ExperimentalProviderMaintenanceParams, ExperimentalProviderUsage, ExperimentalProviderUsageResult, ExperimentalProviderUsageWindow, HostDaemonAcpLaunchSpec, InitializeResult, InstructionMode, JsonObject, JsonRpcMessage, JsonValue, ModelReasoningEffort, PendingInteractionApprovalDecision, PendingInteractionApprovalSubject, PendingInteractionCommandAction, PendingInteractionGrantablePermissionProfile, PendingInteractionGrantedPermissionProfile, PendingInteractionPayload, PendingInteractionRequestedPermissionProfile, PendingInteractionResolution, PendingInteractionUserQuestionQuestion, PermissionEscalation, PermissionMode, PreparedProviderCommandDispatch, PromptInput, ProviderBridgeContext, ProviderBridgeDefinition, ProviderBridgeEntry, ProviderErrorCategory, ProviderErrorInfo, ProviderInboundRequest, ProviderPostInitializeRequest, ProviderRateLimitState, ProviderRateLimitStatus, ProviderRateLimitWindow, ProviderRawEvent, ProviderRawEventCoverage, ProviderRawEventDescription, ProviderRuntimeEvent, ProviderVisibilityMetadata, ReasoningLevel, RuntimePermissionPolicy, RuntimePermissionScope, ServiceTier, ThreadDelta, ThreadDeltaKind, ThreadDeltaNotificationParams, ThreadEventContextWindowUsage, ThreadEventItemStatus, ThreadEventPlanStep, ThreadEventTokenUsageBreakdown, ThreadEventTurnStatus, ThreadEventUserContent, UserQuestionPendingInteractionPayload, UserQuestionPendingInteractionResolution, WorkflowAgentSnapshot, WorkflowAgentState, WorkflowPhaseSnapshot, WorkflowProgressSnapshot };

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

@@ -7,7 +7,7 @@
 
 import { ReactNode, ComponentType } from 'react';
 import { RenderResult } from '@testing-library/react';
-import { PluginHomepageSectionRegistration, PluginSettingsSectionRegistration, PluginNavPanelRegistration, PluginThreadPanelActionRegistration, PluginNewThreadPanelActionRegistration, ComposerCustomization, PluginPendingInteractionRegistration, PluginSidebarFooterActionRegistration, PluginThreadListRegistration, PluginThreadHeaderActionRegistration, PluginFileOpenerRegistration, PluginSourceCodeRendererRegistration, PluginDiffRendererRegistration, PluginMessageDirectiveRegistration, PluginMessageActionRegistration, PluginProviderIconRegistration, PluginContentScriptRegistration, PluginComposerScope, PluginComposerTextEffect, PluginComposerMention, PluginComposerThreadRowStatus, BbNavigate, PluginAppDefinition, PluginRpcContract, StandardSchemaV1InferInput, PluginRpcResult, PluginRealtimeConnectionState, PluginSidebarThreadsState, PluginSidebarPullRequest, PluginSidebarThreadActions } from '@get-bb/plugin-sdk';
+import { PluginHomepageSectionRegistration, PluginSettingsSectionRegistration, PluginNavPanelRegistration, PluginThreadPanelActionRegistration, PluginNewThreadPanelActionRegistration, ComposerCustomization, PluginPendingInteractionRegistration, PluginSidebarFooterActionRegistration, PluginThreadListRegistration, PluginThreadHeaderActionRegistration, PluginFileOpenerRegistration, PluginSourceCodeRendererRegistration, PluginDiffRendererRegistration, PluginMessageDirectiveRegistration, PluginMessageActionRegistration, PluginProviderIconRegistration, PluginContentScriptRegistration, PluginComposerScope, PluginComposerTextEffect, PluginComposerMention, PluginComposerThreadRowStatus, ExperimentalOpenFixedTabOptions, JsonValue, BbNavigate, ExperimentalFileOpenOptions, PluginAppDefinition, PluginRpcContract, StandardSchemaV1InferInput, PluginRpcResult, PluginRealtimeConnectionState, PluginSidebarThreadsState, PluginSidebarPullRequest, PluginSidebarThreadActions } from '@get-bb/plugin-sdk';
 
 /**
  * `@get-bb/plugin-sdk/testing/app` — the frontend plugin test harness. Tests a
@@ -59,7 +59,22 @@ type NavigateCall = {
 } | {
     method: "openThreadPanel";
     options: Parameters<BbNavigate["openThreadPanel"]>[0];
+} | {
+    method: "experimental_openUrl";
+    url: string;
+} | {
+    method: "experimental_openFilePreview";
+    options: ExperimentalFileOpenOptions;
+} | {
+    method: "experimental_openFileExternally";
+    options: ExperimentalFileOpenOptions;
 };
+interface ExperimentalFixedTabOpenCall {
+    surface: ExperimentalOpenFixedTabOptions<JsonValue>["surface"];
+    panelId: string;
+    tabId: string;
+    target?: JsonValue;
+}
 interface ComposerLog {
     /** Latest plain text in this isolated composer scope. */
     readonly text: string;
@@ -193,6 +208,20 @@ interface RenderSlotOptions<Contract extends PluginRpcContract = PluginRpcContra
     sidebarPullRequests?: Record<string, PluginSidebarPullRequest>;
     /** Host acceptance for `useBbNavigate().openThreadPanel`. */
     openThreadPanel?: (options: Parameters<BbNavigate["openThreadPanel"]>[0]) => boolean;
+    /** Host acceptance for URL intents from the hook or `experimental_UrlLink`. */
+    openUrl?: (url: string) => boolean;
+    /** Host acceptance for preview intents from the hook or file link. */
+    openFilePreview?: (options: ExperimentalFileOpenOptions) => boolean;
+    /** Host acceptance for preferred-external file intents. */
+    openFileExternally?: (options: ExperimentalFileOpenOptions) => boolean;
+    /** Host acceptance for an owner-scoped fixed-tab selection. */
+    experimental_openFixedTab?: (call: ExperimentalFixedTabOpenCall) => boolean;
+    /** Initial session target visible to `experimental_useFixedTabTarget`. */
+    experimental_fixedTabTarget?: {
+        panelId: string;
+        tabId: string;
+        target: JsonValue;
+    };
 }
 /** Host-originated inputs a slot test can drive deterministically. */
 interface RenderedSlotBehaviorDrivers {
@@ -214,6 +243,8 @@ interface RenderedSlotInspectionState {
     readonly rpcCalls: RpcCall[];
     /** Every `useBbNavigate()` call, in order. */
     readonly navigateCalls: NavigateCall[];
+    /** Every validated `experimental_useAppPanel().openFixedTab` call. */
+    readonly experimental_fixedTabOpenCalls: ExperimentalFixedTabOpenCall[];
     /** Every `experimental_useSidebarThreadActions()` call, in order. */
     readonly sidebarActionCalls: SidebarActionCall[];
     /** Everything written through `useComposer()`. */
@@ -238,4 +269,4 @@ declare function renderSlot<Props extends object, Contract extends PluginRpcCont
 }, props: Props, options?: RenderSlotOptions<Contract>): RenderedSlot;
 
 export { installTestPluginRuntime, loadPluginApp, mountPluginContentScripts, renderSlot };
-export type { CapturedPluginApp, ComposerLog, ContentScriptTestMountOptions, ContentScriptThreadRowStatusCall, MountedPluginContentScripts, NavigateCall, PluginAppSource, PluginRpcTestHandlers, RenderSlotOptions, RenderedSlot, RenderedSlotBehaviorDrivers, RenderedSlotInspectionState, RenderedSlotLifecycleControls, RpcCall, SidebarActionCall };
+export type { CapturedPluginApp, ComposerLog, ContentScriptTestMountOptions, ContentScriptThreadRowStatusCall, ExperimentalFixedTabOpenCall, MountedPluginContentScripts, NavigateCall, PluginAppSource, PluginRpcTestHandlers, RenderSlotOptions, RenderedSlot, RenderedSlotBehaviorDrivers, RenderedSlotInspectionState, RenderedSlotLifecycleControls, RpcCall, SidebarActionCall };