@openclaw/discord 2026.8.1-beta.2 → 2026.8.1

package/dist/{retry-CLpJcXXf.js → retry-DqHCW6PV.js}

@@ -2,22 +2,24 @@ import { t as parseDiscordRetryAfterBodySeconds } from "./retry-after-DdLPmPoa.j
 import "node:module";
 import { redactIdentifier, redactSensitiveFieldValue } from "openclaw/plugin-sdk/logging-core";
 import { ApplicationCommandOptionType, ApplicationCommandType, ButtonStyle, ComponentType, GatewayDispatchEvents, InteractionContextType, InteractionResponseType, InteractionType, MessageFlags, Routes, TextInputStyle } from "discord-api-types/v10";
+import { Type } from "typebox";
+import { Check } from "typebox/value";
 import { createHash } from "node:crypto";
 import { asDateTimestampMs, clampTimerTimeoutMs, parseStrictNonNegativeInteger, resolveExpiresAtMsFromDurationMs, resolveIntegerOption, resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime";
 import { expectDefined } from "openclaw/plugin-sdk/expect-runtime";
-import { Type } from "typebox";
-import { Check } from "typebox/value";
 import { inspect } from "node:util";
 import { gunzipSync } from "node:zlib";
 import { readResponseWithLimit } from "openclaw/plugin-sdk/response-limit-runtime";
 import { collectErrorGraphCandidates, extractErrorCode, formatErrorMessage, readErrorName } from "openclaw/plugin-sdk/error-runtime";
 import { classifyTransientNetworkErrorCode, createChannelApiRetryRunner, parseRetryAfterHeaderSeconds, resolveRetryConfig, retryAsync } from "openclaw/plugin-sdk/retry-runtime";
-import { sleepWithAbort } from "openclaw/plugin-sdk/runtime-env";
 import { buildMessagingTarget, parseMentionPrefixOrAtUserTarget, requireTargetKind } from "openclaw/plugin-sdk/channel-targets";
+import { sleepWithAbort } from "openclaw/plugin-sdk/runtime-env";
 import { resolveAllowlistMatchByCandidates } from "openclaw/plugin-sdk/allow-from";
 import { chunkMarkdownTextWithMode } from "openclaw/plugin-sdk/reply-chunking";
 import { chunkTextForOutbound } from "openclaw/plugin-sdk/text-chunking";
 import { isSingleUseReplyToMode } from "openclaw/plugin-sdk/reply-reference";
+import { createMessageReceiptFromOutboundResults } from "openclaw/plugin-sdk/channel-outbound";
+import { attachChannelToResults } from "openclaw/plugin-sdk/channel-send-result";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -65,6 +67,11 @@ async function overwriteGuildApplicationCommands(rest, clientId, guildId, body)
 }
 //#endregion
 //#region extensions/discord/src/internal/api.guild.ts
+const discordGuildEmojiListSchema = Type.Array(Type.Object({
+	id: Type.Union([Type.String(), Type.Null()]),
+	name: Type.Union([Type.String(), Type.Null()]),
+	animated: Type.Optional(Type.Boolean())
+}, { additionalProperties: true }));
 async function getGuild(rest, guildId) {
 	return await rest.get(Routes.guild(guildId));
 }
@@ -117,7 +124,9 @@ async function createGuildBan(rest, guildId, userId, data) {
 	await rest.put(Routes.guildBan(guildId, userId), data);
 }
 async function listGuildEmojis(rest, guildId) {
-	return await rest.get(Routes.guildEmojis(guildId));
+	const emojis = await rest.get(Routes.guildEmojis(guildId));
+	if (!Check(discordGuildEmojiListSchema, emojis)) throw new Error("Invalid Discord guild emoji response.");
+	return emojis;
 }
 async function createGuildEmoji(rest, guildId, data) {
 	return await rest.post(Routes.guildEmojis(guildId), data);
@@ -810,15 +819,12 @@ var Embed = class {
 };
 //#endregion
 //#region extensions/discord/src/internal/payload.ts
-function serializeAnyComponent(component) {
-	return component.serialize();
-}
-function payloadHasV2Components(payload) {
-	return Boolean(payload.components?.some((component) => component.isV2));
+function hasDiscordV2Components(components) {
+	return Boolean(components?.some((component) => "isV2" in component && component.isV2 || "type" in component && component.type !== ComponentType.ActionRow));
 }
 function normalizePayloadFlags(payload) {
 	const flags = payload.ephemeral ? (payload.flags ?? 0) | MessageFlags.Ephemeral : payload.flags;
-	if (!payloadHasV2Components(payload)) return flags;
+	if (!hasDiscordV2Components(payload.components)) return flags;
 	if (payload.content || payload.embeds?.length) throw new Error("Discord Components V2 payloads cannot include content or embeds");
 	return (flags ?? 0) | MessageFlags.IsComponentsV2;
 }
@@ -828,7 +834,7 @@ function serializePayload(payload) {
 	return stripUndefinedFields({
 		content: payload.content,
 		embeds: payload.embeds?.map((entry) => "serialize" in entry ? entry.serialize() : entry),
-		components: payload.components?.map((entry) => serializeAnyComponent(entry)),
+		components: payload.components?.map((entry) => "serialize" in entry ? entry.serialize() : entry),
 		allowed_mentions: payload.allowed_mentions ?? payload.allowedMentions,
 		flags,
 		tts: payload.tts,
@@ -993,6 +999,12 @@ var Guild = class extends Base {
 	get name() {
 		return this.rawDataValue?.name ?? "";
 	}
+	get icon() {
+		return this.rawDataValue?.icon;
+	}
+	get iconUrl() {
+		return this.icon ? `https://cdn.discordapp.com/icons/${this.id}/${this.icon}.png` : null;
+	}
 };
 var GuildMember = class extends Base {
 	constructor(client, rawData) {
@@ -1163,6 +1175,9 @@ var DiscordEntityCache = class {
 			return new GuildMember(this.params.client, raw);
 		});
 	}
+	async fetchGuildEmojis(guildId, fetcher) {
+		return await this.fetchCached(`guild-emojis:${guildId}`, fetcher);
+	}
 	invalidateForGatewayEvent(type, data) {
 		const raw = data && typeof data === "object" ? data : {};
 		const channelUpdate = GatewayDispatchEvents.ChannelUpdate;
@@ -1170,11 +1185,13 @@ var DiscordEntityCache = class {
 		const threadUpdate = GatewayDispatchEvents.ThreadUpdate;
 		const threadDelete = GatewayDispatchEvents.ThreadDelete;
 		const guildUpdate = GatewayDispatchEvents.GuildUpdate;
+		const guildEmojisUpdate = GatewayDispatchEvents.GuildEmojisUpdate;
 		const guildMemberAdd = GatewayDispatchEvents.GuildMemberAdd;
 		const guildMemberRemove = GatewayDispatchEvents.GuildMemberRemove;
 		const guildMemberUpdate = GatewayDispatchEvents.GuildMemberUpdate;
 		if (type === channelUpdate || type === channelDelete || type === threadUpdate || type === threadDelete) this.deleteId("channel", raw.id);
 		if (type === guildUpdate) this.deleteId("guild", raw.id);
+		if (type === guildEmojisUpdate) this.deleteId("guild-emojis", raw.guild_id);
 		if (type === guildMemberAdd || type === guildMemberRemove || type === guildMemberUpdate) {
 			const guildId = raw.guild_id;
 			const user = raw.user && typeof raw.user === "object" ? raw.user : {};
@@ -1381,12 +1398,9 @@ function findCommandOption(options, name) {
 	if (!name) return;
 	return options?.find((option) => option.name === name);
 }
-function hasCommandOptions(command) {
-	return "options" in command;
-}
 function resolveFocusedCommandOptionAutocompleteHandler(command, interaction) {
 	const focusedName = interaction.options.getFocused()?.name;
-	const autocomplete = findCommandOption("subcommands" in command && Array.isArray(command.subcommands) ? findSelectedSubcommand(command.subcommands, interaction)?.options : hasCommandOptions(command) ? command.options : void 0, focusedName)?.autocomplete;
+	const autocomplete = findCommandOption(command.commandKind === "group" ? findSelectedSubcommand(command.subcommands, interaction)?.options : command.options, focusedName)?.autocomplete;
 	return typeof autocomplete === "function" ? autocomplete : void 0;
 }
 var BaseCommand = class {
@@ -1417,6 +1431,7 @@ var BaseCommand = class {
 var Command = class extends BaseCommand {
 	constructor(..._args) {
 		super(..._args);
+		this.commandKind = "leaf";
 		this.type = ApplicationCommandType.ChatInput;
 	}
 	async autocomplete(interaction) {
@@ -1438,6 +1453,7 @@ var Command = class extends BaseCommand {
 var CommandWithSubcommands = class extends BaseCommand {
 	constructor(..._args2) {
 		super(..._args2);
+		this.commandKind = "group";
 		this.type = ApplicationCommandType.ChatInput;
 	}
 	async run(interaction) {
@@ -1660,6 +1676,7 @@ var BaseInteraction = class {
 		this.message = null;
 		this.response = new InteractionResponseController();
 		this.pendingResponse = Promise.resolve();
+		this.sentFollowUp = false;
 		this.id = rawData.id;
 		this.token = rawData.token;
 		this.user = readInteractionUser(rawData, client);
@@ -1676,6 +1693,14 @@ var BaseInteraction = class {
 	set responseState(nextState) {
 		this.response.state = nextState;
 	}
+	/**
+	* True once a follow-up message has been delivered. Follow-ups are visible to
+	* the user but never advance `responseState`, so this is the only record that
+	* the interaction has already produced output.
+	*/
+	get hasSentFollowUp() {
+		return this.sentFollowUp;
+	}
 	enqueueResponse(operation) {
 		const result = this.pendingResponse.then(operation);
 		this.pendingResponse = result.then(() => void 0, () => void 0);
@@ -1710,6 +1735,24 @@ var BaseInteraction = class {
 	async editReply(payload) {
 		return await this.enqueueResponse(() => this.performReplyEdit(payload));
 	}
+	/**
+	* Edits the deferred placeholder only if this interaction is still an
+	* unanswered spinner when the queue reaches this operation.
+	*
+	* Both conditions are re-read inside the queue. A follow-up that was still in
+	* flight when the caller decided to report will have settled — and recorded
+	* itself in `sentFollowUp` — by the time this runs, so the decision cannot be
+	* made against state that is about to change.
+	*
+	* Resolves true when the edit was sent.
+	*/
+	async editDeferredPlaceholderIfUnanswered(payload) {
+		return await this.enqueueResponse(async () => {
+			if (this.responseState !== "deferred" || this.sentFollowUp) return false;
+			await this.performReplyEdit(payload);
+			return true;
+		});
+	}
 	async performReplyEdit(payload) {
 		const body = serializePayload(payload);
 		const query = needsComponentsV2Query(body) ? { with_components: true } : void 0;
@@ -1739,7 +1782,9 @@ var BaseInteraction = class {
 	}
 	async performFollowUp(payload) {
 		const body = serializePayload(payload);
-		return await createWebhookMessage(this.client.rest, this.client.options.clientId, this.token, { body }, needsComponentsV2Query(body) ? { with_components: true } : void 0);
+		const result = await createWebhookMessage(this.client.rest, this.client.options.clientId, this.token, { body }, needsComponentsV2Query(body) ? { with_components: true } : void 0);
+		this.sentFollowUp = true;
+		return result;
 	}
 };
 var CommandInteraction = class extends BaseInteraction {
@@ -1825,12 +1870,20 @@ async function dispatchInteraction(client, rawData) {
 			await optionAutocomplete(autocompleteInteraction);
 			return;
 		}
-		if ("autocomplete" in command) await command.autocomplete(autocompleteInteraction);
+		if (command.commandKind === "leaf") await command.autocomplete(autocompleteInteraction);
 		return;
 	}
+	try {
+		await dispatchAcknowledgeableInteraction(client, rawData, interaction);
+	} catch (error) {
+		await reportInteractionFailure(interaction);
+		throw error;
+	}
+}
+async function dispatchAcknowledgeableInteraction(client, rawData, interaction) {
 	if (rawData.type === InteractionType.ApplicationCommand) {
 		const command = client.commands.find((entry) => entry.name === readInteractionName(rawData));
-		if (command && "run" in command) {
+		if (command) {
 			await deferCommandInteractionIfNeeded(command, interaction);
 			await command.run(interaction);
 		}
@@ -1863,6 +1916,44 @@ async function dispatchInteraction(client, rawData) {
 		if (modal) await modal.run(interaction, modal.customIdParser(customId).data);
 	}
 }
+/**
+* Fixed text. The thrown error is deliberately not echoed here: an interaction
+* response is visible to the whole channel, and handler exceptions routinely
+* carry absolute paths, config keys, and provider responses. The rethrow keeps
+* the detail in the Gateway log where operators already look for it.
+*/
+const INTERACTION_FAILURE_NOTICE = "Command failed. Check the Gateway logs for details.";
+/**
+* Best-effort user-visible notice for a failed interaction. Never throws: a
+* reporting failure must not mask the original error.
+*
+* Deliberately narrow. It reports only for `deferred`, where a spinner is known
+* to exist and the original response is a placeholder this dispatch created:
+*
+* - `deferred`        the deferring callback succeeded (state advances only
+*                     after a REST success), so editing the original response
+*                     resolves a spinner that would otherwise hang forever.
+* - `deferred-update` a component acknowledgement. Discord leaves no spinner,
+*                     and the original response is the message the component is
+*                     attached to, so editing it would overwrite content the
+*                     user is still reading.
+* - `unacknowledged`  nothing is known to have reached Discord. A second
+*                     initial callback risks "already acknowledged" if the
+*                     first one landed after all, and Discord already shows its
+*                     own "did not respond" notice.
+* - `replied`         the user has seen a message, and nextReplyAction() would
+*                     turn this into a contradictory follow-up beside it.
+*/
+async function reportInteractionFailure(interaction) {
+	if (interaction.responseState !== "deferred") return;
+	if (interaction.hasSentFollowUp) return;
+	try {
+		await interaction.editDeferredPlaceholderIfUnanswered({
+			content: INTERACTION_FAILURE_NOTICE,
+			allowed_mentions: { parse: [] }
+		});
+	} catch {}
+}
 function resolveConditionalComponentOption(value, interaction) {
 	return typeof value === "function" ? value(interaction) : value;
 }
@@ -2772,6 +2863,9 @@ var Client = class {
 	async fetchMember(guildId, userId) {
 		return await this.entityCache.fetchMember(guildId, userId);
 	}
+	async fetchGuildEmojis(guildId, fetcher) {
+		return await this.entityCache.fetchGuildEmojis(guildId, fetcher);
+	}
 	async deployCommands(options = {}) {
 		return await this.commandDeployer.deploy(options);
 	}
@@ -2965,6 +3059,7 @@ var discord_exports = /* @__PURE__ */ __exportAll({
 	getThreadMember: () => getThreadMember,
 	getUser: () => getUser,
 	getWebhookMessage: () => getWebhookMessage,
+	hasDiscordV2Components: () => hasDiscordV2Components,
 	isUnknownDiscordVoiceStateError: () => isUnknownDiscordVoiceStateError,
 	listApplicationCommands: () => listApplicationCommands,
 	listChannelArchivedThreads: () => listChannelArchivedThreads,
@@ -3125,6 +3220,79 @@ function resolveDiscordReplyMessageId(reply, isFirst) {
 	return reply && (isFirst || reply.scope === "all") ? reply.messageId : void 0;
 }
 //#endregion
+//#region extensions/discord/src/send.receipt.ts
+function toDiscordOutboundDeliveryResult(result) {
+	const { channelId, ...delivery } = result;
+	return {
+		...delivery,
+		target: {
+			kind: "channel",
+			id: channelId
+		}
+	};
+}
+function createDiscordSendReceiptFromResults(params) {
+	const receipt = createMessageReceiptFromOutboundResults({
+		results: attachChannelToResults("discord", params.results),
+		threadId: params.threadId
+	});
+	return {
+		...receipt,
+		parts: receipt.parts.map(({ platformMessageId, kind, threadId, replyToId, raw }, index) => ({
+			platformMessageId,
+			kind,
+			index,
+			threadId,
+			replyToId,
+			raw
+		}))
+	};
+}
+function createDiscordSendReceipt(params) {
+	return createMessageReceiptFromOutboundResults({
+		results: params.platformMessageIds.map((messageId) => messageId.trim()).filter((messageId) => messageId && messageId !== "unknown").map((messageId, index) => {
+			const result = {
+				channel: "discord",
+				messageId
+			};
+			if (params.channelId) result.channelId = params.channelId;
+			if (params.reply?.scope === "first" && index === 0) {
+				const rawResult = {
+					channel: "discord",
+					messageId
+				};
+				if (params.channelId) rawResult.channelId = params.channelId;
+				result.receipt = createMessageReceiptFromOutboundResults({
+					results: [rawResult],
+					kind: params.kind,
+					threadId: params.threadId,
+					replyToId: params.reply.messageId
+				});
+			}
+			return result;
+		}),
+		kind: params.kind,
+		threadId: params.threadId,
+		replyToId: params.reply?.scope === "all" ? params.reply.messageId : void 0
+	});
+}
+function createDiscordSendResult(params) {
+	const messageId = params.result.id || "unknown";
+	const channelId = params.result.channel_id ?? params.fallbackChannelId;
+	const receiptParams = {
+		platformMessageIds: params.result.platformMessageIds?.length ? params.result.platformMessageIds : [messageId],
+		channelId,
+		kind: params.kind
+	};
+	if (params.threadId != null) receiptParams.threadId = String(params.threadId);
+	if (params.reply) receiptParams.reply = params.reply;
+	return {
+		messageId,
+		channelId,
+		receipt: createDiscordSendReceipt(receiptParams)
+	};
+}
+//#endregion
 //#region extensions/discord/src/chunk.ts
 const DEFAULT_MAX_CHARS = 2e3;
 const DEFAULT_MAX_LINES = 17;
@@ -3447,4 +3615,4 @@ function createDiscordRetryRunner(params) {
 	};
 }
 //#endregion
-export { LinkButton as $, removeGuildMemberRole as $t, RequestClient as A, listChannelPins as At, Message as B, createGuildSticker as Bt, ReadyListener as C, editChannel as Ct, VoiceStateUpdateListener as D, getThreadMember as Dt, ThreadUpdateListener as E, getChannelMessage as Et, readDiscordMessage as F, addGuildMemberRole as Ft, Label as G, listGuildActiveThreads as Gt, serializePayload as H, getGuild as Ht, readRetryAfter as I, createGuildBan as It, TextInput as J, listGuildRoles as Jt, Modal as K, listGuildChannels as Kt, Command as L, createGuildChannel as Lt, RateLimitError as M, searchGuildMessages as Mt, isUnknownDiscordVoiceStateError as N, sendChannelTyping as Nt, Client as O, listChannelArchivedThreads as Ot, readDiscordCode as P, unpinChannelMessage as Pt, File as Q, removeGuildMember as Qt, CommandWithSubcommands as R, createGuildEmoji as Rt, PresenceUpdateListener as S, deleteChannelMessage as St, ThreadDeleteListener as T, getChannel as Tt, Embed as U, getGuildMember as Ut, User as V, deleteChannelPermission as Vt, CheckboxGroup as W, getGuildVoiceState as Wt, ChannelSelectMenu as X, moveGuildChannels as Xt, Button as Y, listGuildScheduledEvents as Yt, Container as Z, putChannelPermission as Zt, GuildDeleteListener as _, deleteOwnMessageReaction as _t, chunkDiscordTextWithMode as a, Separator as at, MessageReactionAddListener as b, createThread as bt, resolveDiscordReplyReference as c, Thumbnail as ct, normalizeDiscordMessagingTarget as d, parseCustomId as dt, timeoutGuildMember as en, MediaGallery as et, normalizeDiscordOutboundTarget as f, stripUndefinedFields as ft, GuildCreateListener as g, createOwnMessageReaction as gt, discord_exports as h, getCurrentUser as ht, recordDiscordMessageCreateAmbiguity as i, Section as it, DiscordError as j, pinChannelMessage as jt, Plugin as k, listChannelMessages as kt, allowFromContainsDiscordUserId as l, UserSelectMenu as lt, resolveDiscordChannelId as m, createUserDmChannel as mt, createDiscordRetryRunner as n, RoleSelectMenu as nt, createReusableDiscordReplyReference as o, StringSelectMenu as ot, parseDiscordTarget as p, createChannelWebhook as pt, RadioGroup as q, listGuildEmojis as qt, hasDiscordMessageCreateAmbiguity as r, Row as rt, resolveDiscordReplyMessageId as s, TextDisplay as st, classifyDiscordDeliveryFailure as t, __exportAll as tn, MentionableSelectMenu as tt, looksLikeDiscordTargetId as u, BaseMessageInteractiveComponent as ut, InteractionCreateListener as v, listMessageReactionUsers as vt, ResumedListener as w, editChannelMessage as wt, MessageReactionRemoveListener as x, deleteChannel as xt, MessageCreateListener as y, createChannelMessage as yt, Guild as z, createGuildScheduledEvent as zt };
+export { TextInput as $, listGuildRoles as $t, ThreadUpdateListener as A, getChannel as At, readRetryAfter as B, addGuildMemberRole as Bt, MessageCreateListener as C, listMessageReactionUsers as Ct, ReadyListener as D, deleteChannelMessage as Dt, PresenceUpdateListener as E, deleteChannel as Et, DiscordError as F, listChannelPins as Ft, User as G, createGuildSticker as Gt, CommandWithSubcommands as H, createGuildChannel as Ht, RateLimitError as I, pinChannelMessage as It, Embed as J, getGuildMember as Jt, hasDiscordV2Components as K, deleteChannelPermission as Kt, isUnknownDiscordVoiceStateError as L, searchGuildMessages as Lt, Client as M, getThreadMember as Mt, Plugin as N, listChannelArchivedThreads as Nt, ResumedListener as O, editChannel as Ot, RequestClient as P, listChannelMessages as Pt, RadioGroup as Q, listGuildEmojis as Qt, readDiscordCode as R, sendChannelTyping as Rt, InteractionCreateListener as S, deleteOwnMessageReaction as St, MessageReactionRemoveListener as T, createThread as Tt, Guild as U, createGuildEmoji as Ut, Command as V, createGuildBan as Vt, Message as W, createGuildScheduledEvent as Wt, Label as X, listGuildActiveThreads as Xt, CheckboxGroup as Y, getGuildVoiceState as Yt, Modal as Z, listGuildChannels as Zt, parseDiscordTarget as _, stripUndefinedFields as _t, chunkDiscordTextWithMode as a, timeoutGuildMember as an, MediaGallery as at, GuildCreateListener as b, getCurrentUser as bt, createDiscordSendResult as c, Row as ct, resolveDiscordReplyMessageId as d, StringSelectMenu as dt, listGuildScheduledEvents as en, Button as et, resolveDiscordReplyReference as f, TextDisplay as ft, normalizeDiscordOutboundTarget as g, parseCustomId as gt, normalizeDiscordMessagingTarget as h, BaseMessageInteractiveComponent as ht, recordDiscordMessageCreateAmbiguity as i, removeGuildMemberRole as in, LinkButton as it, VoiceStateUpdateListener as j, getChannelMessage as jt, ThreadDeleteListener as k, editChannelMessage as kt, toDiscordOutboundDeliveryResult as l, Section as lt, looksLikeDiscordTargetId as m, UserSelectMenu as mt, createDiscordRetryRunner as n, putChannelPermission as nn, Container as nt, createDiscordSendReceipt as o, __exportAll as on, MentionableSelectMenu as ot, allowFromContainsDiscordUserId as p, Thumbnail as pt, serializePayload as q, getGuild as qt, hasDiscordMessageCreateAmbiguity as r, removeGuildMember as rn, File as rt, createDiscordSendReceiptFromResults as s, RoleSelectMenu as st, classifyDiscordDeliveryFailure as t, moveGuildChannels as tn, ChannelSelectMenu as tt, createReusableDiscordReplyReference as u, Separator as ut, resolveDiscordChannelId as v, createChannelWebhook as vt, MessageReactionAddListener as w, createChannelMessage as wt, GuildDeleteListener as x, createOwnMessageReaction as xt, discord_exports as y, createUserDmChannel as yt, readDiscordMessage as z, unpinChannelMessage as zt };