shardwire 1.4.0 → 1.4.5

package/README.md

@@ -106,7 +106,7 @@ app.on(
 ## Startup lifecycle
 
 - **`createBotBridge(...)`** starts the WebSocket server immediately; `await bridge.ready()` resolves when the Discord client has finished its initial `ready` handshake (same timing you would expect from a normal bot login).
-- **Register `app.on(...)` handlers before `await app.ready()`** so subscriptions are known when the app authenticates. `ready()` connects, completes auth, negotiates capabilities from intents + secret scope, then throws `BridgeCapabilityError` if any registered handler targets an event the app is not allowed to receive.
+- **Register `app.on(...)` handlers before `await app.ready()`** so subscriptions are known when the app authenticates. `ready()` connects, completes auth, negotiates capabilities from intents + secret scope, then throws `BridgeCapabilityError` if any registered handler targets an event the app is not allowed to receive. To probe connectivity and negotiated caps first (and validate a planned surface with `desired`), use **`await app.preflight(desired)`** before registering handlers.
 - **Sticky `ready`**: if the bot was already ready before the app connected, the bridge replays the latest `ready` payload to matching subscriptions after auth.
 
 ## Built-In Events
@@ -270,6 +270,16 @@ const capabilities = app.capabilities();
 console.log(capabilities.events, capabilities.actions);
 ```
 
+### Discovery, preflight, and workflow helpers
+
+- **`app.catalog()`** — static list of built-in events (with required gateway intents), actions, and subscription filter keys (no connection required).
+- **`getShardwireCatalog()`** — same data without an `AppBridge` instance.
+- **`app.explainCapability({ kind: 'event' | 'action', name })`** — whether a name is built-in and, after connect, whether the negotiated bridge allows it.
+- **`app.preflight(desired?)`** — awaits auth, returns `issues[]` (errors/warnings) for transport hints, `desired` vs negotiated caps, and subscription/capability mismatches. Prefer calling **before** `app.on(...)` if you want to validate `desired.events` / `desired.actions` without registering handlers yet.
+- **Workflows** — `deferThenEditInteractionReply`, `deferUpdateThenEditInteractionReply`, `createThreadThenSendMessage` chain common action sequences.
+
+`FORBIDDEN` results for actions outside negotiated capabilities include `error.details.reasonCode === 'action_not_in_capabilities'`. `BridgeCapabilityError` from `ready()` / `on()` may include `details.requiredIntents` for disallowed event subscriptions.
+
 ## Run the Included Examples
 
 ### Minimal (single shared secret)
@@ -319,13 +329,21 @@ SHARDWIRE_SECRET_MODERATION=moderation-secret \
 ## Public API
 
 ```ts
-import { createBotBridge, connectBotBridge } from 'shardwire';
+import {
+	connectBotBridge,
+	createBotBridge,
+	createThreadThenSendMessage,
+	deferThenEditInteractionReply,
+	getShardwireCatalog,
+} from 'shardwire';
 ```
 
 Main exports include:
 
 - `createBotBridge(options)`
 - `connectBotBridge(options)`
+- `getShardwireCatalog()`
+- `deferThenEditInteractionReply`, `deferUpdateThenEditInteractionReply`, `createThreadThenSendMessage`
 - `BridgeCapabilityError`
 - bot/app option types
 - normalized event payload types (for example `BridgeMessage`, `BridgeInteraction`, `BridgeGuildMember`)

package/dist/index.d.mts

@@ -469,6 +469,51 @@ interface EventSubscriptionFilter {
     /** Matches guild thread channels only: same as message `channelId` when `channelType` is a guild thread. */
     threadId?: Snowflake | readonly Snowflake[];
 }
+/** Keys supported on `EventSubscriptionFilter` for `app.on(..., filter)`. */
+type ShardwireSubscriptionFilterKey = keyof EventSubscriptionFilter;
+/** One built-in event and its gateway intent requirements (for `app.catalog()`). */
+interface ShardwireCatalogEvent {
+    name: BotEventName;
+    requiredIntents: readonly BotIntentName[];
+}
+/** Static discovery surface for built-in events, actions, and subscription filters. */
+interface ShardwireCatalog {
+    events: readonly ShardwireCatalogEvent[];
+    actions: readonly BotActionName[];
+    subscriptionFilters: readonly ShardwireSubscriptionFilterKey[];
+}
+type CapabilityExplanationKind = 'event' | 'action';
+type CapabilityExplanationReasonCode = 'unknown_name' | 'not_negotiated' | 'allowed' | 'denied_by_bridge';
+/** Result of `app.explainCapability(...)`. */
+interface CapabilityExplanation {
+    kind: CapabilityExplanationKind;
+    name: string;
+    /** Whether this name is a built-in Shardwire event or action. */
+    known: boolean;
+    /** Required gateway intents when `kind` is `event` and `known`. */
+    requiredIntents?: readonly BotIntentName[];
+    /** After authentication, whether the bridge allows this capability. */
+    allowedByBridge?: boolean;
+    reasonCode: CapabilityExplanationReasonCode;
+    remediation?: string;
+}
+type PreflightIssueSeverity = 'error' | 'warning';
+interface PreflightIssue {
+    severity: PreflightIssueSeverity;
+    code: string;
+    message: string;
+    remediation?: string;
+}
+interface PreflightReport {
+    ok: boolean;
+    connected: boolean;
+    capabilities: BridgeCapabilities | null;
+    issues: PreflightIssue[];
+}
+interface PreflightDesired {
+    events?: readonly BotEventName[];
+    actions?: readonly BotActionName[];
+}
 interface EventSubscription<K extends BotEventName = BotEventName> {
     name: K;
     filter?: EventSubscriptionFilter;
@@ -566,10 +611,19 @@ interface ActionFailure {
     error: ActionError;
 }
 type ActionResult<T> = ActionSuccess<T> | ActionFailure;
+/** Structured context on `BridgeCapabilityError` and capability-related action failures. */
+interface BridgeCapabilityErrorDetails {
+    reasonCode: 'not_in_capabilities' | 'unknown_event' | 'unknown_action';
+    kind?: 'event' | 'action';
+    name?: string;
+    remediation: string;
+    requiredIntents?: readonly BotIntentName[];
+}
 declare class BridgeCapabilityError extends Error {
     readonly kind: 'event' | 'action';
     readonly name: string;
-    constructor(kind: 'event' | 'action', name: string, message?: string);
+    readonly details?: BridgeCapabilityErrorDetails | undefined;
+    constructor(kind: 'event' | 'action', name: string, message?: string, details?: BridgeCapabilityErrorDetails | undefined);
 }
 type EventHandler<K extends BotEventName> = (payload: BotEventPayloadMap[K]) => void;
 type AppBridgeActionInvokeOptions = {
@@ -596,6 +650,27 @@ interface AppBridge {
     connected(): boolean;
     connectionId(): string | null;
     capabilities(): BridgeCapabilities;
+    /**
+     * Static discovery: built-in events (with intent hints), actions, and subscription filter keys.
+     * Does not require a connection.
+     */
+    catalog(): ShardwireCatalog;
+    /**
+     * Explain whether an event or action is built-in and whether the current connection allows it.
+     * Call after `await app.ready()` for `allowedByBridge` / `reasonCode` beyond `not_negotiated`.
+     */
+    explainCapability(query: {
+        kind: 'event';
+        name: BotEventName;
+    } | {
+        kind: 'action';
+        name: BotActionName;
+    }): CapabilityExplanation;
+    /**
+     * Run startup diagnostics after authenticating. Does not throw on subscription/capability mismatches;
+     * use `report.ok` and `report.issues`. Call before `app.on(...)` to validate `desired` against negotiated caps.
+     */
+    preflight(desired?: PreflightDesired): Promise<PreflightReport>;
     on<K extends BotEventName>(name: K, handler: EventHandler<K>, filter?: EventSubscriptionFilter): Unsubscribe;
     off<K extends BotEventName>(name: K, handler: EventHandler<K>): void;
 }
@@ -604,4 +679,35 @@ declare function createBotBridge(options: BotBridgeOptions): BotBridge;
 
 declare function connectBotBridge(options: AppBridgeOptions): AppBridge;
 
-export { type ActionError, type ActionErrorDetails, type ActionFailure, type ActionResult, type ActionSuccess, type AddMemberRoleActionPayload, type AddMessageReactionActionPayload, type AppBridge, type AppBridgeActionInvokeOptions, type AppBridgeActions, type AppBridgeMetricsHooks, type AppBridgeOptions, type ArchiveThreadActionPayload, type BanMemberActionPayload, type BotActionName, type BotActionPayloadMap, type BotActionResultDataMap, type BotBridge, type BotBridgeOptions, type BotBridgeSecret, type BotEventName, type BotEventPayloadMap, type BotIntentName, type BridgeAttachment, type BridgeCapabilities, BridgeCapabilityError, type BridgeChannel, type BridgeDeletedMessage, type BridgeGuild, type BridgeGuildMember, type BridgeInteraction, type BridgeInteractionKind, type BridgeMessage, type BridgeMessageInput, type BridgeMessageReaction, type BridgeMessageReference, type BridgeReactionEmoji, type BridgeThread, type BridgeUser, type ChannelCreateEventPayload, type ChannelDeleteEventPayload, type ChannelUpdateEventPayload, type CreateChannelActionPayload, type CreateThreadActionPayload, type DeferInteractionActionPayload, type DeferInteractionActionResult, type DeferUpdateInteractionActionPayload, type DeferUpdateInteractionActionResult, type DeleteChannelActionPayload, type DeleteChannelActionResult, type DeleteInteractionReplyActionPayload, type DeleteInteractionReplyActionResult, type DeleteMessageActionPayload, type DeleteMessageActionResult, type EditChannelActionPayload, type EditInteractionReplyActionPayload, type EditMessageActionPayload, type EventEnvelopeBase, type EventHandler, type EventSubscription, type EventSubscriptionFilter, type FetchMemberActionPayload, type FetchMessageActionPayload, type FollowUpInteractionActionPayload, type GuildCreateEventPayload, type GuildDeleteEventPayload, type GuildMemberAddEventPayload, type GuildMemberRemoveEventPayload, type GuildMemberUpdateEventPayload, type InteractionCreateEventPayload, type KickMemberActionPayload, type MemberModerationActionResult, type MessageBulkDeleteEventPayload, type MessageCreateEventPayload, type MessageDeleteEventPayload, type MessageReactionActionResult, type MessageReactionAddEventPayload, type MessageReactionRemoveEventPayload, type MessageUpdateEventPayload, type ReadyEventPayload, type RemoveMemberRoleActionPayload, type RemoveMemberTimeoutActionPayload, type RemoveOwnMessageReactionActionPayload, type ReplyToInteractionActionPayload, type ScopedSecretConfig, type SecretPermissions, type SendMessageActionPayload, type ShardwireLogger, type ShowModalActionPayload, type ShowModalActionResult, type ThreadCreateEventPayload, type ThreadDeleteEventPayload, type ThreadUpdateEventPayload, type TimeoutMemberActionPayload, type Unsubscribe, type UpdateInteractionActionPayload, connectBotBridge, createBotBridge };
+/** Returns the full static Shardwire catalog (not negotiated per-connection). */
+declare function getShardwireCatalog(): ShardwireCatalog;
+
+/**
+ * Defer a slash/menu interaction, then edit the deferred reply.
+ * Useful for long-running handlers that must acknowledge within Discord's window.
+ */
+declare function deferThenEditInteractionReply(app: Pick<AppBridge, 'actions'>, args: {
+    interactionId: DeferInteractionActionPayload['interactionId'];
+    defer?: Pick<DeferInteractionActionPayload, 'ephemeral'>;
+    edit: EditInteractionReplyActionPayload;
+}, options?: AppBridgeActionInvokeOptions): Promise<ActionResult<BotActionResultDataMap['editInteractionReply']>>;
+/**
+ * Defer a component interaction with type `DEFER_UPDATE_MESSAGE`, then edit the reply.
+ */
+declare function deferUpdateThenEditInteractionReply(app: Pick<AppBridge, 'actions'>, args: {
+    interactionId: DeferUpdateInteractionActionPayload['interactionId'];
+    edit: EditInteractionReplyActionPayload;
+}, options?: AppBridgeActionInvokeOptions): Promise<ActionResult<BotActionResultDataMap['editInteractionReply']>>;
+
+/**
+ * Create a thread from a parent channel (optionally on a message), then send a message in that thread.
+ */
+declare function createThreadThenSendMessage(app: Pick<AppBridge, 'actions'>, args: {
+    thread: CreateThreadActionPayload;
+    message: Omit<SendMessageActionPayload, 'channelId'>;
+}, options?: AppBridgeActionInvokeOptions): Promise<{
+    threadResult: ActionResult<BotActionResultDataMap['createThread']>;
+    messageResult: ActionResult<BotActionResultDataMap['sendMessage']>;
+}>;
+
+export { type ActionError, type ActionErrorDetails, type ActionFailure, type ActionResult, type ActionSuccess, type AddMemberRoleActionPayload, type AddMessageReactionActionPayload, type AppBridge, type AppBridgeActionInvokeOptions, type AppBridgeActions, type AppBridgeMetricsHooks, type AppBridgeOptions, type ArchiveThreadActionPayload, type BanMemberActionPayload, type BotActionName, type BotActionPayloadMap, type BotActionResultDataMap, type BotBridge, type BotBridgeOptions, type BotBridgeSecret, type BotEventName, type BotEventPayloadMap, type BotIntentName, type BridgeAttachment, type BridgeCapabilities, BridgeCapabilityError, type BridgeCapabilityErrorDetails, type BridgeChannel, type BridgeDeletedMessage, type BridgeGuild, type BridgeGuildMember, type BridgeInteraction, type BridgeInteractionKind, type BridgeMessage, type BridgeMessageInput, type BridgeMessageReaction, type BridgeMessageReference, type BridgeReactionEmoji, type BridgeThread, type BridgeUser, type CapabilityExplanation, type CapabilityExplanationKind, type CapabilityExplanationReasonCode, type ChannelCreateEventPayload, type ChannelDeleteEventPayload, type ChannelUpdateEventPayload, type CreateChannelActionPayload, type CreateThreadActionPayload, type DeferInteractionActionPayload, type DeferInteractionActionResult, type DeferUpdateInteractionActionPayload, type DeferUpdateInteractionActionResult, type DeleteChannelActionPayload, type DeleteChannelActionResult, type DeleteInteractionReplyActionPayload, type DeleteInteractionReplyActionResult, type DeleteMessageActionPayload, type DeleteMessageActionResult, type EditChannelActionPayload, type EditInteractionReplyActionPayload, type EditMessageActionPayload, type EventEnvelopeBase, type EventHandler, type EventSubscription, type EventSubscriptionFilter, type FetchMemberActionPayload, type FetchMessageActionPayload, type FollowUpInteractionActionPayload, type GuildCreateEventPayload, type GuildDeleteEventPayload, type GuildMemberAddEventPayload, type GuildMemberRemoveEventPayload, type GuildMemberUpdateEventPayload, type InteractionCreateEventPayload, type KickMemberActionPayload, type MemberModerationActionResult, type MessageBulkDeleteEventPayload, type MessageCreateEventPayload, type MessageDeleteEventPayload, type MessageReactionActionResult, type MessageReactionAddEventPayload, type MessageReactionRemoveEventPayload, type MessageUpdateEventPayload, type PreflightDesired, type PreflightIssue, type PreflightIssueSeverity, type PreflightReport, type ReadyEventPayload, type RemoveMemberRoleActionPayload, type RemoveMemberTimeoutActionPayload, type RemoveOwnMessageReactionActionPayload, type ReplyToInteractionActionPayload, type ScopedSecretConfig, type SecretPermissions, type SendMessageActionPayload, type ShardwireCatalog, type ShardwireCatalogEvent, type ShardwireLogger, type ShardwireSubscriptionFilterKey, type ShowModalActionPayload, type ShowModalActionResult, type ThreadCreateEventPayload, type ThreadDeleteEventPayload, type ThreadUpdateEventPayload, type TimeoutMemberActionPayload, type Unsubscribe, type UpdateInteractionActionPayload, connectBotBridge, createBotBridge, createThreadThenSendMessage, deferThenEditInteractionReply, deferUpdateThenEditInteractionReply, getShardwireCatalog };

package/dist/index.d.ts

@@ -469,6 +469,51 @@ interface EventSubscriptionFilter {
     /** Matches guild thread channels only: same as message `channelId` when `channelType` is a guild thread. */
     threadId?: Snowflake | readonly Snowflake[];
 }
+/** Keys supported on `EventSubscriptionFilter` for `app.on(..., filter)`. */
+type ShardwireSubscriptionFilterKey = keyof EventSubscriptionFilter;
+/** One built-in event and its gateway intent requirements (for `app.catalog()`). */
+interface ShardwireCatalogEvent {
+    name: BotEventName;
+    requiredIntents: readonly BotIntentName[];
+}
+/** Static discovery surface for built-in events, actions, and subscription filters. */
+interface ShardwireCatalog {
+    events: readonly ShardwireCatalogEvent[];
+    actions: readonly BotActionName[];
+    subscriptionFilters: readonly ShardwireSubscriptionFilterKey[];
+}
+type CapabilityExplanationKind = 'event' | 'action';
+type CapabilityExplanationReasonCode = 'unknown_name' | 'not_negotiated' | 'allowed' | 'denied_by_bridge';
+/** Result of `app.explainCapability(...)`. */
+interface CapabilityExplanation {
+    kind: CapabilityExplanationKind;
+    name: string;
+    /** Whether this name is a built-in Shardwire event or action. */
+    known: boolean;
+    /** Required gateway intents when `kind` is `event` and `known`. */
+    requiredIntents?: readonly BotIntentName[];
+    /** After authentication, whether the bridge allows this capability. */
+    allowedByBridge?: boolean;
+    reasonCode: CapabilityExplanationReasonCode;
+    remediation?: string;
+}
+type PreflightIssueSeverity = 'error' | 'warning';
+interface PreflightIssue {
+    severity: PreflightIssueSeverity;
+    code: string;
+    message: string;
+    remediation?: string;
+}
+interface PreflightReport {
+    ok: boolean;
+    connected: boolean;
+    capabilities: BridgeCapabilities | null;
+    issues: PreflightIssue[];
+}
+interface PreflightDesired {
+    events?: readonly BotEventName[];
+    actions?: readonly BotActionName[];
+}
 interface EventSubscription<K extends BotEventName = BotEventName> {
     name: K;
     filter?: EventSubscriptionFilter;
@@ -566,10 +611,19 @@ interface ActionFailure {
     error: ActionError;
 }
 type ActionResult<T> = ActionSuccess<T> | ActionFailure;
+/** Structured context on `BridgeCapabilityError` and capability-related action failures. */
+interface BridgeCapabilityErrorDetails {
+    reasonCode: 'not_in_capabilities' | 'unknown_event' | 'unknown_action';
+    kind?: 'event' | 'action';
+    name?: string;
+    remediation: string;
+    requiredIntents?: readonly BotIntentName[];
+}
 declare class BridgeCapabilityError extends Error {
     readonly kind: 'event' | 'action';
     readonly name: string;
-    constructor(kind: 'event' | 'action', name: string, message?: string);
+    readonly details?: BridgeCapabilityErrorDetails | undefined;
+    constructor(kind: 'event' | 'action', name: string, message?: string, details?: BridgeCapabilityErrorDetails | undefined);
 }
 type EventHandler<K extends BotEventName> = (payload: BotEventPayloadMap[K]) => void;
 type AppBridgeActionInvokeOptions = {
@@ -596,6 +650,27 @@ interface AppBridge {
     connected(): boolean;
     connectionId(): string | null;
     capabilities(): BridgeCapabilities;
+    /**
+     * Static discovery: built-in events (with intent hints), actions, and subscription filter keys.
+     * Does not require a connection.
+     */
+    catalog(): ShardwireCatalog;
+    /**
+     * Explain whether an event or action is built-in and whether the current connection allows it.
+     * Call after `await app.ready()` for `allowedByBridge` / `reasonCode` beyond `not_negotiated`.
+     */
+    explainCapability(query: {
+        kind: 'event';
+        name: BotEventName;
+    } | {
+        kind: 'action';
+        name: BotActionName;
+    }): CapabilityExplanation;
+    /**
+     * Run startup diagnostics after authenticating. Does not throw on subscription/capability mismatches;
+     * use `report.ok` and `report.issues`. Call before `app.on(...)` to validate `desired` against negotiated caps.
+     */
+    preflight(desired?: PreflightDesired): Promise<PreflightReport>;
     on<K extends BotEventName>(name: K, handler: EventHandler<K>, filter?: EventSubscriptionFilter): Unsubscribe;
     off<K extends BotEventName>(name: K, handler: EventHandler<K>): void;
 }
@@ -604,4 +679,35 @@ declare function createBotBridge(options: BotBridgeOptions): BotBridge;
 
 declare function connectBotBridge(options: AppBridgeOptions): AppBridge;
 
-export { type ActionError, type ActionErrorDetails, type ActionFailure, type ActionResult, type ActionSuccess, type AddMemberRoleActionPayload, type AddMessageReactionActionPayload, type AppBridge, type AppBridgeActionInvokeOptions, type AppBridgeActions, type AppBridgeMetricsHooks, type AppBridgeOptions, type ArchiveThreadActionPayload, type BanMemberActionPayload, type BotActionName, type BotActionPayloadMap, type BotActionResultDataMap, type BotBridge, type BotBridgeOptions, type BotBridgeSecret, type BotEventName, type BotEventPayloadMap, type BotIntentName, type BridgeAttachment, type BridgeCapabilities, BridgeCapabilityError, type BridgeChannel, type BridgeDeletedMessage, type BridgeGuild, type BridgeGuildMember, type BridgeInteraction, type BridgeInteractionKind, type BridgeMessage, type BridgeMessageInput, type BridgeMessageReaction, type BridgeMessageReference, type BridgeReactionEmoji, type BridgeThread, type BridgeUser, type ChannelCreateEventPayload, type ChannelDeleteEventPayload, type ChannelUpdateEventPayload, type CreateChannelActionPayload, type CreateThreadActionPayload, type DeferInteractionActionPayload, type DeferInteractionActionResult, type DeferUpdateInteractionActionPayload, type DeferUpdateInteractionActionResult, type DeleteChannelActionPayload, type DeleteChannelActionResult, type DeleteInteractionReplyActionPayload, type DeleteInteractionReplyActionResult, type DeleteMessageActionPayload, type DeleteMessageActionResult, type EditChannelActionPayload, type EditInteractionReplyActionPayload, type EditMessageActionPayload, type EventEnvelopeBase, type EventHandler, type EventSubscription, type EventSubscriptionFilter, type FetchMemberActionPayload, type FetchMessageActionPayload, type FollowUpInteractionActionPayload, type GuildCreateEventPayload, type GuildDeleteEventPayload, type GuildMemberAddEventPayload, type GuildMemberRemoveEventPayload, type GuildMemberUpdateEventPayload, type InteractionCreateEventPayload, type KickMemberActionPayload, type MemberModerationActionResult, type MessageBulkDeleteEventPayload, type MessageCreateEventPayload, type MessageDeleteEventPayload, type MessageReactionActionResult, type MessageReactionAddEventPayload, type MessageReactionRemoveEventPayload, type MessageUpdateEventPayload, type ReadyEventPayload, type RemoveMemberRoleActionPayload, type RemoveMemberTimeoutActionPayload, type RemoveOwnMessageReactionActionPayload, type ReplyToInteractionActionPayload, type ScopedSecretConfig, type SecretPermissions, type SendMessageActionPayload, type ShardwireLogger, type ShowModalActionPayload, type ShowModalActionResult, type ThreadCreateEventPayload, type ThreadDeleteEventPayload, type ThreadUpdateEventPayload, type TimeoutMemberActionPayload, type Unsubscribe, type UpdateInteractionActionPayload, connectBotBridge, createBotBridge };
+/** Returns the full static Shardwire catalog (not negotiated per-connection). */
+declare function getShardwireCatalog(): ShardwireCatalog;
+
+/**
+ * Defer a slash/menu interaction, then edit the deferred reply.
+ * Useful for long-running handlers that must acknowledge within Discord's window.
+ */
+declare function deferThenEditInteractionReply(app: Pick<AppBridge, 'actions'>, args: {
+    interactionId: DeferInteractionActionPayload['interactionId'];
+    defer?: Pick<DeferInteractionActionPayload, 'ephemeral'>;
+    edit: EditInteractionReplyActionPayload;
+}, options?: AppBridgeActionInvokeOptions): Promise<ActionResult<BotActionResultDataMap['editInteractionReply']>>;
+/**
+ * Defer a component interaction with type `DEFER_UPDATE_MESSAGE`, then edit the reply.
+ */
+declare function deferUpdateThenEditInteractionReply(app: Pick<AppBridge, 'actions'>, args: {
+    interactionId: DeferUpdateInteractionActionPayload['interactionId'];
+    edit: EditInteractionReplyActionPayload;
+}, options?: AppBridgeActionInvokeOptions): Promise<ActionResult<BotActionResultDataMap['editInteractionReply']>>;
+
+/**
+ * Create a thread from a parent channel (optionally on a message), then send a message in that thread.
+ */
+declare function createThreadThenSendMessage(app: Pick<AppBridge, 'actions'>, args: {
+    thread: CreateThreadActionPayload;
+    message: Omit<SendMessageActionPayload, 'channelId'>;
+}, options?: AppBridgeActionInvokeOptions): Promise<{
+    threadResult: ActionResult<BotActionResultDataMap['createThread']>;
+    messageResult: ActionResult<BotActionResultDataMap['sendMessage']>;
+}>;
+
+export { type ActionError, type ActionErrorDetails, type ActionFailure, type ActionResult, type ActionSuccess, type AddMemberRoleActionPayload, type AddMessageReactionActionPayload, type AppBridge, type AppBridgeActionInvokeOptions, type AppBridgeActions, type AppBridgeMetricsHooks, type AppBridgeOptions, type ArchiveThreadActionPayload, type BanMemberActionPayload, type BotActionName, type BotActionPayloadMap, type BotActionResultDataMap, type BotBridge, type BotBridgeOptions, type BotBridgeSecret, type BotEventName, type BotEventPayloadMap, type BotIntentName, type BridgeAttachment, type BridgeCapabilities, BridgeCapabilityError, type BridgeCapabilityErrorDetails, type BridgeChannel, type BridgeDeletedMessage, type BridgeGuild, type BridgeGuildMember, type BridgeInteraction, type BridgeInteractionKind, type BridgeMessage, type BridgeMessageInput, type BridgeMessageReaction, type BridgeMessageReference, type BridgeReactionEmoji, type BridgeThread, type BridgeUser, type CapabilityExplanation, type CapabilityExplanationKind, type CapabilityExplanationReasonCode, type ChannelCreateEventPayload, type ChannelDeleteEventPayload, type ChannelUpdateEventPayload, type CreateChannelActionPayload, type CreateThreadActionPayload, type DeferInteractionActionPayload, type DeferInteractionActionResult, type DeferUpdateInteractionActionPayload, type DeferUpdateInteractionActionResult, type DeleteChannelActionPayload, type DeleteChannelActionResult, type DeleteInteractionReplyActionPayload, type DeleteInteractionReplyActionResult, type DeleteMessageActionPayload, type DeleteMessageActionResult, type EditChannelActionPayload, type EditInteractionReplyActionPayload, type EditMessageActionPayload, type EventEnvelopeBase, type EventHandler, type EventSubscription, type EventSubscriptionFilter, type FetchMemberActionPayload, type FetchMessageActionPayload, type FollowUpInteractionActionPayload, type GuildCreateEventPayload, type GuildDeleteEventPayload, type GuildMemberAddEventPayload, type GuildMemberRemoveEventPayload, type GuildMemberUpdateEventPayload, type InteractionCreateEventPayload, type KickMemberActionPayload, type MemberModerationActionResult, type MessageBulkDeleteEventPayload, type MessageCreateEventPayload, type MessageDeleteEventPayload, type MessageReactionActionResult, type MessageReactionAddEventPayload, type MessageReactionRemoveEventPayload, type MessageUpdateEventPayload, type PreflightDesired, type PreflightIssue, type PreflightIssueSeverity, type PreflightReport, type ReadyEventPayload, type RemoveMemberRoleActionPayload, type RemoveMemberTimeoutActionPayload, type RemoveOwnMessageReactionActionPayload, type ReplyToInteractionActionPayload, type ScopedSecretConfig, type SecretPermissions, type SendMessageActionPayload, type ShardwireCatalog, type ShardwireCatalogEvent, type ShardwireLogger, type ShardwireSubscriptionFilterKey, type ShowModalActionPayload, type ShowModalActionResult, type ThreadCreateEventPayload, type ThreadDeleteEventPayload, type ThreadUpdateEventPayload, type TimeoutMemberActionPayload, type Unsubscribe, type UpdateInteractionActionPayload, connectBotBridge, createBotBridge, createThreadThenSendMessage, deferThenEditInteractionReply, deferUpdateThenEditInteractionReply, getShardwireCatalog };