@zhin.js/adapter-discord 1.1.27 → 1.1.28

package/agents/discord/skills/discord/tools/send_embed/index.js

@@ -1,12 +1,11 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { messages as t } from "../../../../messages.js";
+import { sendToCurrentConversation } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
 export default defineAgentTool({
-    description: '发送 Discord 富文本嵌入消息（Embed）',
+    description: '在当前 Discord 频道（或线程）发送富文本嵌入消息（Embed）',
     inputSchema: z.object({
-        channel_id: z.string().describe('频道 ID'),
         title: z.string().optional().describe('Embed 标题'),
         description: z.string().optional().describe('Embed 描述'),
         color: z.number().optional().describe('颜色值（十进制，如 0x00ff00 = 65280）'),
@@ -15,8 +14,7 @@ export default defineAgentTool({
     }),
     adapter: 'discord',
     tags: ['discord'],
-    async execute({ channel_id, title, description, color, url, fields }, context) {
-        const client = requireDiscordGatewayClient(context.$client);
+    async execute({ title, description, color, url, fields }, context) {
         const embedData = {};
         if (title)
             embedData.title = title;
@@ -34,11 +32,8 @@ export default defineAgentTool({
                 return { success: false, message: t(context.locale, 'invalidFields') };
             }
         }
-        const channel = await client.channels.fetch(channel_id);
-        if (!channel?.isSendable()) {
-            throw new Error(t(context.locale, 'notTextChannel', { p0: channel_id }));
-        }
-        const msg = await channel.send({ embeds: [embedData] });
-        return { success: true, message_id: msg.id, message: t(context.locale, 'embedSent') };
+        // `discord:embed` is the Discord adapter's namespaced outbound segment (rendered by formatOutboundBody).
+        const result = await sendToCurrentConversation(context, { type: 'discord:embed', data: embedData });
+        return { ...result, message: t(context.locale, result.success ? 'embedSent' : 'operationFailed') };
     },
 });

package/agents/discord/skills/discord/tools/send_embed/index.ts

@@ -1,12 +1,11 @@
 import { messages as t } from "../../../../messages.js";
+import { sendToCurrentConversation } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
 
-export default defineAgentTool<{ channel_id: string; title?: string; description?: string; color?: number; url?: string; fields?: string }>({
-  description: '发送 Discord 富文本嵌入消息（Embed）',
+export default defineAgentTool<{ title?: string; description?: string; color?: number; url?: string; fields?: string }>({
+  description: '在当前 Discord 频道（或线程）发送富文本嵌入消息（Embed）',
   inputSchema: z.object({
-    channel_id: z.string().describe('频道 ID'),
     title: z.string().optional().describe('Embed 标题'),
     description: z.string().optional().describe('Embed 描述'),
     color: z.number().optional().describe('颜色值（十进制，如 0x00ff00 = 65280）'),
@@ -15,8 +14,7 @@ export default defineAgentTool<{ channel_id: string; title?: string; description
   }),
   adapter: 'discord',
   tags: ['discord'],
-  async execute({ channel_id, title, description, color, url, fields  }: { channel_id: string; title?: string; description?: string; color?: number; url?: string; fields?: string }, context) {
-    const client = requireDiscordGatewayClient(context.$client);
+  async execute({ title, description, color, url, fields }, context) {
     const embedData: Record<string, unknown> = {};
     if (title) embedData.title = title;
     if (description) embedData.description = description;
@@ -29,11 +27,8 @@ export default defineAgentTool<{ channel_id: string; title?: string; description
         return { success: false, message: t(context.locale, 'invalidFields') };
       }
     }
-    const channel = await client.channels.fetch(channel_id);
-    if (!channel?.isSendable()) {
-      throw new Error(t(context.locale, 'notTextChannel', { p0: channel_id }));
-    }
-    const msg = await channel.send({ embeds: [embedData] } as never);
-    return { success: true, message_id: msg.id, message: t(context.locale, 'embedSent') };
+    // `discord:embed` is the Discord adapter's namespaced outbound segment (rendered by formatOutboundBody).
+    const result = await sendToCurrentConversation(context, { type: 'discord:embed', data: embedData });
+    return { ...result, message: t(context.locale, result.success ? 'embedSent' : 'operationFailed') };
   },
 });

package/agents/discord/skills/discord-guild/tools/add_role/index.js

@@ -1,26 +1,28 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { messages as t } from "../../../../messages.js";
+import { currentGuildChannel, requireRoleBelowRequester } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
-import { platformPermission } from '@zhin.js/permission';
 export default defineAgentTool({
-    description: '给成员添加 Discord 角色',
+    description: '给当前 Discord 服务器的成员添加身份组（只能是低于你最高身份组的身份组）',
     inputSchema: z.object({
-        guild_id: z.string().describe('服务器 ID'),
         user_id: z.string().describe('用户 ID'),
-        role_id: z.string().describe('角色 ID'),
+        role_id: z.string().describe('身份组 ID'),
     }),
     adapter: 'discord',
     scopes: ["channel"],
     tags: ['discord'],
-    permissions: [platformPermission('discord', 'manage_roles')],
-    async execute({ guild_id, user_id, role_id }, context) {
+    permissions: ['platform-permission:manage_roles', 'bot-permission:manage_roles'],
+    async execute({ user_id, role_id }, context) {
+        const { guildId } = currentGuildChannel(context);
         const client = requireDiscordGatewayClient(context.$client);
-        const guild = await client.guilds.fetch(guild_id);
+        const guild = await client.guilds.fetch(guildId);
+        const denied = await requireRoleBelowRequester(context, guild, role_id);
+        if (denied)
+            return { success: false, message: denied };
         const member = await guild.members.fetch(user_id);
         await member.roles.add(role_id);
-        const success = true;
-        return { success, message: success ? t(context.locale, 'memberRoleAdded', { p0: user_id }) : t(context.locale, 'operationFailed') };
+        return { success: true, message: t(context.locale, 'memberRoleAdded', { p0: user_id }) };
     },
 });

package/agents/discord/skills/discord-guild/tools/add_role/index.ts

@@ -1,28 +1,29 @@
 import { messages as t } from "../../../../messages.js";
+import { currentGuildChannel, requireRoleBelowRequester } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
-import { platformPermission } from '@zhin.js/permission';
 
-export default defineAgentTool<{ guild_id: string; user_id: string; role_id: string }>({
-  description: '给成员添加 Discord 角色',
+export default defineAgentTool<{ user_id: string; role_id: string }>({
+  description: '给当前 Discord 服务器的成员添加身份组（只能是低于你最高身份组的身份组）',
   inputSchema: z.object({
-    guild_id: z.string().describe('服务器 ID'),
     user_id: z.string().describe('用户 ID'),
-    role_id: z.string().describe('角色 ID'),
+    role_id: z.string().describe('身份组 ID'),
   }),
   adapter: 'discord',
   scopes: ["channel"],
   tags: ['discord'],
-  permissions: [platformPermission('discord', 'manage_roles')],
-  async execute({ guild_id, user_id, role_id  }: { guild_id: string; user_id: string; role_id: string }, context) {
+  permissions: ['platform-permission:manage_roles', 'bot-permission:manage_roles'],
+  async execute({ user_id, role_id }, context) {
+    const { guildId } = currentGuildChannel(context);
     const client = requireDiscordGatewayClient(context.$client);
-    const guild = await client.guilds.fetch(guild_id);
+    const guild = await client.guilds.fetch(guildId);
+    const denied = await requireRoleBelowRequester(context, guild, role_id);
+    if (denied) return { success: false, message: denied };
     const member = await guild.members.fetch(user_id) as {
       roles: { add(id: string): Promise<unknown> };
     };
     await member.roles.add(role_id);
-    const success = true;
-    return { success, message: success ? t(context.locale, 'memberRoleAdded', { p0: user_id }) : t(context.locale, 'operationFailed') };
+    return { success: true, message: t(context.locale, 'memberRoleAdded', { p0: user_id }) };
   },
 });

package/agents/discord/skills/discord-guild/tools/create_thread/index.js

@@ -1,14 +1,13 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { messages as t } from "../../../../messages.js";
+import { currentGuildChannel } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
-import { platformPermission } from '@zhin.js/permission';
 import { ThreadAutoArchiveDuration } from 'discord.js';
 export default defineAgentTool({
-    description: '在 Discord 频道中创建帖子/子线程',
+    description: '在当前 Discord 频道中创建帖子/子线程',
     inputSchema: z.object({
-        channel_id: z.string().describe('频道 ID'),
         name: z.string().describe('帖子标题'),
         message_id: z.string().optional().describe('基于某条消息创建（可选）'),
         auto_archive_duration: z.number().optional().describe('自动归档时间（分钟：60/1440/4320/10080）'),
@@ -16,8 +15,9 @@ export default defineAgentTool({
     adapter: 'discord',
     scopes: ["channel"],
     tags: ['discord'],
-    permissions: [platformPermission('discord', 'manage_channels')],
-    async execute({ channel_id, name, message_id, auto_archive_duration }, context) {
+    permissions: ['platform-permission:manage_channels', 'bot-permission:create_public_threads'],
+    async execute({ name, message_id, auto_archive_duration }, context) {
+        const { channelId: channel_id } = currentGuildChannel(context);
         const client = requireDiscordGatewayClient(context.$client);
         const channel = await client.channels.fetch(channel_id);
         if (!channel || !('threads' in channel) || channel.isThreadOnly())

package/agents/discord/skills/discord-guild/tools/create_thread/index.ts

@@ -1,14 +1,13 @@
 import { messages as t } from "../../../../messages.js";
+import { currentGuildChannel } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
-import { platformPermission } from '@zhin.js/permission';
 import { ThreadAutoArchiveDuration } from 'discord.js';
 
-export default defineAgentTool<{ channel_id: string; name: string; message_id?: string; auto_archive_duration?: number }>({
-  description: '在 Discord 频道中创建帖子/子线程',
+export default defineAgentTool<{ name: string; message_id?: string; auto_archive_duration?: number }>({
+  description: '在当前 Discord 频道中创建帖子/子线程',
   inputSchema: z.object({
-    channel_id: z.string().describe('频道 ID'),
     name: z.string().describe('帖子标题'),
     message_id: z.string().optional().describe('基于某条消息创建（可选）'),
     auto_archive_duration: z.number().optional().describe('自动归档时间（分钟：60/1440/4320/10080）'),
@@ -16,8 +15,9 @@ export default defineAgentTool<{ channel_id: string; name: string; message_id?:
   adapter: 'discord',
   scopes: ["channel"],
   tags: ['discord'],
-  permissions: [platformPermission('discord', 'manage_channels')],
-  async execute({ channel_id, name, message_id, auto_archive_duration  }: { channel_id: string; name: string; message_id?: string; auto_archive_duration?: number }, context) {
+  permissions: ['platform-permission:manage_channels', 'bot-permission:create_public_threads'],
+  async execute({ name, message_id, auto_archive_duration }, context) {
+    const { channelId: channel_id } = currentGuildChannel(context);
     const client = requireDiscordGatewayClient(context.$client);
     const channel = await client.channels.fetch(channel_id);
     if (!channel || !('threads' in channel) || channel.isThreadOnly()) throw new Error(t(context.locale, 'threadsUnsupported', { p0: channel_id }));

package/agents/discord/skills/discord-guild/tools/forum_post/index.js

@@ -1,13 +1,13 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { messages as t } from "../../../../messages.js";
+import { currentChannel } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
 import { ChannelType } from 'discord.js';
 export default defineAgentTool({
-    description: '在 Discord 论坛频道中创建帖子',
+    description: '在当前 Discord 论坛频道中创建帖子（需在该论坛的帖子里发起）',
     inputSchema: z.object({
-        channel_id: z.string().describe('论坛频道 ID'),
         name: z.string().describe('帖子标题'),
         content: z.string().describe('帖子内容'),
         tags: z.string().optional().describe('标签名，逗号分隔（可选）'),
@@ -15,7 +15,11 @@ export default defineAgentTool({
     adapter: 'discord',
     scopes: ["channel"],
     tags: ['discord'],
-    async execute({ channel_id, name, content, tags }, context) {
+    async execute({ name, content, tags }, context) {
+        // A forum post reports the forum as its conversation id and the post as `threadId`.
+        const { conversationChannelId: channel_id, guildId } = currentChannel(context);
+        if (!guildId)
+            throw new Error(t(context.locale, 'guildChannelRequired'));
         const client = requireDiscordGatewayClient(context.$client);
         const tagList = tags ? tags.split(',').map((t) => t.trim()) : undefined;
         const channel = await client.channels.fetch(channel_id);

package/agents/discord/skills/discord-guild/tools/forum_post/index.ts

@@ -1,13 +1,13 @@
 import { messages as t } from "../../../../messages.js";
+import { currentChannel } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
 import { ChannelType } from 'discord.js';
 
-export default defineAgentTool<{ channel_id: string; name: string; content: string; tags?: string }>({
-  description: '在 Discord 论坛频道中创建帖子',
+export default defineAgentTool<{ name: string; content: string; tags?: string }>({
+  description: '在当前 Discord 论坛频道中创建帖子（需在该论坛的帖子里发起）',
   inputSchema: z.object({
-    channel_id: z.string().describe('论坛频道 ID'),
     name: z.string().describe('帖子标题'),
     content: z.string().describe('帖子内容'),
     tags: z.string().optional().describe('标签名，逗号分隔（可选）'),
@@ -15,7 +15,10 @@ export default defineAgentTool<{ channel_id: string; name: string; content: stri
   adapter: 'discord',
   scopes: ["channel"],
   tags: ['discord'],
-  async execute({ channel_id, name, content, tags  }: { channel_id: string; name: string; content: string; tags?: string }, context) {
+  async execute({ name, content, tags }, context) {
+    // A forum post reports the forum as its conversation id and the post as `threadId`.
+    const { conversationChannelId: channel_id, guildId } = currentChannel(context);
+    if (!guildId) throw new Error(t(context.locale, 'guildChannelRequired'));
     const client = requireDiscordGatewayClient(context.$client);
     const tagList = tags ? tags.split(',').map((t: string) => t.trim()) : undefined;
     const channel = await client.channels.fetch(channel_id);

package/agents/discord/skills/discord-guild/tools/list_roles/index.js

@@ -1,20 +1,19 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { currentGuildChannel } from '../../../../conversation.js';
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
-import { platformPermission } from '@zhin.js/permission';
 export default defineAgentTool({
-    description: '获取 Discord 服务器角色列表',
-    inputSchema: z.object({
-        guild_id: z.string().describe('服务器 ID'),
-    }),
+    description: '获取当前 Discord 服务器的身份组列表',
+    inputSchema: z.object({}),
     adapter: 'discord',
     scopes: ["channel"],
     tags: ['discord'],
-    permissions: [platformPermission('discord', 'manage_roles')],
-    async execute({ guild_id }, context) {
+    permissions: ['platform-permission:manage_roles'],
+    async execute(_args, context) {
+        const { guildId } = currentGuildChannel(context);
         const client = requireDiscordGatewayClient(context.$client);
-        const guild = await client.guilds.fetch(guild_id);
+        const guild = await client.guilds.fetch(guildId);
         await guild.roles.fetch();
         const cache = guild.roles.cache;
         const roles = [...cache.values()].map((role) => ({

package/agents/discord/skills/discord-guild/tools/list_roles/index.ts

@@ -1,20 +1,19 @@
+import { currentGuildChannel } from '../../../../conversation.js';
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
-import { platformPermission } from '@zhin.js/permission';
 
-export default defineAgentTool<{ guild_id: string }>({
-  description: '获取 Discord 服务器角色列表',
-  inputSchema: z.object({
-    guild_id: z.string().describe('服务器 ID'),
-  }),
+export default defineAgentTool<Record<string, never>>({
+  description: '获取当前 Discord 服务器的身份组列表',
+  inputSchema: z.object({}),
   adapter: 'discord',
   scopes: ["channel"],
   tags: ['discord'],
-  permissions: [platformPermission('discord', 'manage_roles')],
-  async execute({ guild_id  }: { guild_id: string }, context) {
+  permissions: ['platform-permission:manage_roles'],
+  async execute(_args, context) {
+    const { guildId } = currentGuildChannel(context);
     const client = requireDiscordGatewayClient(context.$client);
-    const guild = await client.guilds.fetch(guild_id);
+    const guild = await client.guilds.fetch(guildId);
     await guild.roles.fetch();
     const cache = guild.roles.cache as Map<string, {
       id: string;

package/agents/discord/skills/discord-guild/tools/remove_role/index.js

@@ -1,26 +1,28 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { messages as t } from "../../../../messages.js";
+import { currentGuildChannel, requireRoleBelowRequester } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
-import { platformPermission } from '@zhin.js/permission';
 export default defineAgentTool({
-    description: '移除成员的 Discord 角色',
+    description: '移除当前 Discord 服务器成员的身份组（只能是低于你最高身份组的身份组）',
     inputSchema: z.object({
-        guild_id: z.string().describe('服务器 ID'),
         user_id: z.string().describe('用户 ID'),
-        role_id: z.string().describe('角色 ID'),
+        role_id: z.string().describe('身份组 ID'),
     }),
     adapter: 'discord',
     scopes: ["channel"],
     tags: ['discord'],
-    permissions: [platformPermission('discord', 'manage_roles')],
-    async execute({ guild_id, user_id, role_id }, context) {
+    permissions: ['platform-permission:manage_roles', 'bot-permission:manage_roles'],
+    async execute({ user_id, role_id }, context) {
+        const { guildId } = currentGuildChannel(context);
         const client = requireDiscordGatewayClient(context.$client);
-        const guild = await client.guilds.fetch(guild_id);
+        const guild = await client.guilds.fetch(guildId);
+        const denied = await requireRoleBelowRequester(context, guild, role_id);
+        if (denied)
+            return { success: false, message: denied };
         const member = await guild.members.fetch(user_id);
         await member.roles.remove(role_id);
-        const success = true;
-        return { success, message: success ? t(context.locale, 'memberRoleRemoved', { p0: user_id }) : t(context.locale, 'operationFailed') };
+        return { success: true, message: t(context.locale, 'memberRoleRemoved', { p0: user_id }) };
     },
 });

package/agents/discord/skills/discord-guild/tools/remove_role/index.ts

@@ -1,28 +1,29 @@
 import { messages as t } from "../../../../messages.js";
+import { currentGuildChannel, requireRoleBelowRequester } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
-import { platformPermission } from '@zhin.js/permission';
 
-export default defineAgentTool<{ guild_id: string; user_id: string; role_id: string }>({
-  description: '移除成员的 Discord 角色',
+export default defineAgentTool<{ user_id: string; role_id: string }>({
+  description: '移除当前 Discord 服务器成员的身份组（只能是低于你最高身份组的身份组）',
   inputSchema: z.object({
-    guild_id: z.string().describe('服务器 ID'),
     user_id: z.string().describe('用户 ID'),
-    role_id: z.string().describe('角色 ID'),
+    role_id: z.string().describe('身份组 ID'),
   }),
   adapter: 'discord',
   scopes: ["channel"],
   tags: ['discord'],
-  permissions: [platformPermission('discord', 'manage_roles')],
-  async execute({ guild_id, user_id, role_id  }: { guild_id: string; user_id: string; role_id: string }, context) {
+  permissions: ['platform-permission:manage_roles', 'bot-permission:manage_roles'],
+  async execute({ user_id, role_id }, context) {
+    const { guildId } = currentGuildChannel(context);
     const client = requireDiscordGatewayClient(context.$client);
-    const guild = await client.guilds.fetch(guild_id);
+    const guild = await client.guilds.fetch(guildId);
+    const denied = await requireRoleBelowRequester(context, guild, role_id);
+    if (denied) return { success: false, message: denied };
     const member = await guild.members.fetch(user_id) as {
       roles: { remove(id: string): Promise<unknown> };
     };
     await member.roles.remove(role_id);
-    const success = true;
-    return { success, message: success ? t(context.locale, 'memberRoleRemoved', { p0: user_id }) : t(context.locale, 'operationFailed') };
+    return { success: true, message: t(context.locale, 'memberRoleRemoved', { p0: user_id }) };
   },
 });

package/lib/endpoint.js

@@ -7,10 +7,11 @@ import { isDiscordChannelObfuscated } from './channel-visibility.js';
 import { Client, ChannelType } from 'discord.js';
 import { createEndpointSpecification, endpointSpec, createEndpointLifecycle, createEndpointOperation, } from 'zhin.js/adapter';
 import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
-import { connectDiscordGatewayClient, discordClientOptions, DEFAULT_INTENTS, resolveSenderRole, toMessageCreateOptions, } from './gateway.js';
-import { discordInboundConversation, formatButtonContent, formatButtonSegments, formatInboundContent, formatInboundSegments, formatOutboundBody, senderDisplayName, } from './protocol.js';
+import { connectDiscordGatewayClient, discordClientOptions, DEFAULT_INTENTS, toMessageCreateOptions, } from './gateway.js';
+import { discordChannelOf, discordInboundConversation, formatButtonContent, formatButtonSegments, formatInboundContent, formatInboundSegments, formatOutboundBody, senderDisplayName, } from './protocol.js';
 import { registerDiscordInteractionRoutes } from './webhook.js';
 import { receiveDiscordGuildMemberSideEvent } from './side-event-dispatch.js';
+import { discordGuildPermissionNamesFromChannelBitfield, discordPermissionNames, discordSenderStanding, discordStandingFromPermissions, } from './sender-standing.js';
 const DISCORD_API = 'https://discord.com/api/v10';
 /** 出站 HTTP 调用统一 30s 超时。 */
 const OUTBOUND_TIMEOUT_MS = 30_000;
@@ -138,11 +139,11 @@ export class DiscordGatewayEndpoint extends Client {
     }
     async #sendFramework({ conversation, payload, signal }) {
         const body = formatOutboundBody(payload);
-        const snowflake = await this.#sendBody({ channelId: conversation.id, body, signal });
+        const snowflake = await this.#sendBody({ channelId: discordChannelOf(conversation), body, signal });
         this.#logger.debug(formatCompact({
             op: 'discord_send',
             endpoint: this.#options.config.id,
-            target: conversation.id,
+            target: discordChannelOf(conversation),
             messageId: snowflake,
         }));
         return snowflake;
@@ -151,7 +152,7 @@ export class DiscordGatewayEndpoint extends Client {
         if (!message.id)
             return;
         const operation = createEndpointOperation({ signal });
-        const channel = await operation.prepare(() => this.#requireClient().channels.fetch(message.conversation.id));
+        const channel = await operation.prepare(() => this.#requireClient().channels.fetch(discordChannelOf(message.conversation)));
         if (!channel?.isTextBased() || !channel.messages)
             return;
         const msg = await operation.prepare(() => channel.messages.fetch(message.id));
@@ -164,6 +165,7 @@ export class DiscordGatewayEndpoint extends Client {
         if (msg.authorBot)
             return;
         const conversation = discordInboundConversation(String(this.#options.id), msg);
+        const platform = discordSenderStanding(msg);
         void this[endpointSpec].events.emit('message.receive', {
             conversation,
             event: msg.event,
@@ -174,7 +176,7 @@ export class DiscordGatewayEndpoint extends Client {
             sender: {
                 id: msg.authorId,
                 name: senderDisplayName(msg) || undefined,
-                ...(resolveSenderRole(msg) ? { roles: [resolveSenderRole(msg)] } : {}),
+                ...(platform ? { platform } : {}),
             },
             endpointId: this.#options.config.id,
             ...(msg.mentionedBot ? { mentioned: true } : {}),
@@ -184,7 +186,7 @@ export class DiscordGatewayEndpoint extends Client {
                 userId: msg.authorId,
                 guildId: msg.guildId,
                 permissions: msg.permissionTokens,
-                role: resolveSenderRole(msg),
+                role: platform?.standing,
             }),
         }).catch((err) => {
             this.#logger.warn(formatCompact({
@@ -222,7 +224,7 @@ export class DiscordGatewayEndpoint extends Client {
         });
     }
     async #addReaction({ message, emoji, hint, signal }) {
-        const channelId = hint?.channelId ?? message.conversation.id;
+        const channelId = hint?.channelId ?? discordChannelOf(message.conversation);
         if (!channelId || !message.id)
             return null;
         const operation = createEndpointOperation({ signal });
@@ -326,6 +328,8 @@ export class DiscordRestClient {
         return this.request({ method: 'DELETE', path: `/channels/${channelId}/messages/${messageId}`, signal });
     }
 }
+const APP_PERMISSIONS_TTL_MS = 10 * 60_000;
+const APP_PERMISSIONS_MAX = 1_000;
 export class DiscordInteractionsEndpoint extends DiscordRestClient {
     [endpointSpec];
     #logger;
@@ -334,6 +338,8 @@ export class DiscordInteractionsEndpoint extends DiscordRestClient {
     #routeReleases = [];
     #open = false;
     #started = false;
+    /** Latest interaction `app_permissions` per guild (guild-level names), for the Bot's own standing. */
+    #appPermissions = new Map();
     #control = Object.freeze({
         recall: request => this.#recallMessage(request),
     });
@@ -348,6 +354,12 @@ export class DiscordInteractionsEndpoint extends DiscordRestClient {
         this[endpointSpec] = createEndpointSpecification(this, {
             start: () => this.#startFramework(), open: () => this.#openFramework(), close: () => this.#closeFramework(),
             stop: () => this.#stopFramework(), send: request => this.#sendFramework(request), name: options.config.id,
+            // Interactions mode has no gateway session to read the bot's guild member: its own standing
+            // comes from the latest interaction's `app_permissions` in that guild (ADR 0056 §1), reduced
+            // to guild-level names like senders; without a recent interaction it stays unknown.
+            management: Object.freeze({
+                inspectSelfStanding: async ({ conversation }) => this.#selfStandingFromInteractions(conversation),
+            }),
             control: this.#control, content: this.#content,
             profile: createDiscordRestSelfProfile(this, id => this[endpointSpec].reportSelfUserId(id)),
         });
@@ -385,18 +397,41 @@ export class DiscordInteractionsEndpoint extends DiscordRestClient {
     }
     async #sendFramework({ conversation, payload, signal }) {
         const body = formatOutboundBody(payload);
-        const data = await this.createMessage({ channelId: conversation.id, body, signal });
+        const data = await this.createMessage({ channelId: discordChannelOf(conversation), body, signal });
         return data.id ?? '';
     }
     async #recallMessage({ message, signal }) {
         if (!message.id)
             return;
-        await this.deleteMessage({ channelId: message.conversation.id, messageId: message.id, signal });
+        await this.deleteMessage({ channelId: discordChannelOf(message.conversation), messageId: message.id, signal });
+    }
+    #selfStandingFromInteractions(conversation) {
+        const guildId = conversation.kind === 'channel' && conversation.parent?.kind === 'channel' ? conversation.parent.id : undefined;
+        const entry = guildId ? this.#appPermissions.get(guildId) : undefined;
+        if (!entry || Date.now() - entry.at > APP_PERMISSIONS_TTL_MS)
+            return undefined;
+        // The guild owner is not visible to an interaction; `administrator` still reads as `admin`.
+        return { standing: discordStandingFromPermissions(entry.names), ...(entry.names.length ? { permissions: entry.names } : {}) };
+    }
+    #recordAppPermissions(msg) {
+        const appPermissions = msg.event?.app_permissions;
+        if (!msg.guildId || appPermissions === undefined)
+            return;
+        this.#appPermissions.delete(msg.guildId);
+        this.#appPermissions.set(msg.guildId, { names: discordGuildPermissionNamesFromChannelBitfield(appPermissions), at: Date.now() });
+        while (this.#appPermissions.size > APP_PERMISSIONS_MAX) {
+            const oldest = this.#appPermissions.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.#appPermissions.delete(oldest);
+        }
     }
     admit(msg) {
         if (!this.#open)
             return;
+        this.#recordAppPermissions(msg);
         const conversation = discordInboundConversation(String(this.#options.id), msg);
+        const platform = discordSenderStanding(msg);
         void this[endpointSpec].events.emit('message.receive', {
             conversation,
             event: msg.event,
@@ -407,7 +442,7 @@ export class DiscordInteractionsEndpoint extends DiscordRestClient {
             sender: {
                 id: msg.authorId,
                 name: senderDisplayName(msg) || undefined,
-                ...(resolveSenderRole(msg) ? { roles: [resolveSenderRole(msg)] } : {}),
+                ...(platform ? { platform } : {}),
             },
             endpointId: this.#options.config.id,
             metadata: Object.freeze({
@@ -475,7 +510,7 @@ async function resolveDiscordContent(fetch, token, reference, context) {
     }
     try {
         context.signal.throwIfAborted();
-        const response = await fetch(`${DISCORD_API}/channels/${reference.message.conversation.id}/messages/${reference.message.id}`, { headers: { Authorization: `Bot ${token}` }, signal: context.signal });
+        const response = await fetch(`${DISCORD_API}/channels/${discordChannelOf(reference.message.conversation)}/messages/${reference.message.id}`, { headers: { Authorization: `Bot ${token}` }, signal: context.signal });
         if (response.status === 404)
             return Object.freeze({ status: 'not_found', code: 'discord_message_not_found' });
         if (response.status === 403)
@@ -520,6 +555,30 @@ async function resolveDiscordContent(fetch, token, reference, context) {
  */
 export function createDiscordEndpointManagement(requireClient) {
     return Object.freeze({
+        /**
+         * ADR 0056 §1: the Bot's own guild member in the conversation's guild — guild owner → `owner`;
+         * `administrator` / `moderate_members` → `admin`; roles and **guild-level** permission names
+         * (`GuildMember.permissions`, as for senders) so `bot-permission:*` and `platform-permission:*`
+         * read the same scope. Channel overwrites are left to the platform at execution time.
+         */
+        async inspectSelfStanding({ conversation, signal }) {
+            if (conversation.kind === 'private')
+                return undefined;
+            const operation = createEndpointOperation({ signal });
+            const client = requireClient();
+            const channel = await operation.run(() => client.channels.fetch(conversation.threadId ?? conversation.id));
+            if (!channel || !('guild' in channel) || !client.user)
+                return undefined;
+            const guild = channel.guild;
+            const me = guild.members.me ?? await operation.run(() => guild.members.fetchMe());
+            const permissions = me.permissions;
+            const names = permissions ? discordPermissionNames(bit => permissions.has(bit)) : [];
+            const roles = [...me.roles.cache.values()]
+                .filter(role => role.id !== guild.id)
+                .map(role => (role.name ? { id: String(role.id), name: String(role.name) } : { id: String(role.id) }));
+            const standing = discordStandingFromPermissions(names, guild.ownerId === client.user.id);
+            return { standing, ...(roles.length ? { roles } : {}), ...(names.length ? { permissions: names } : {}) };
+        },
         async listGroups(request = {}) {
             return createEndpointOperation(request).run(() => {
                 const groups = [];

package/lib/gateway.d.ts

@@ -5,6 +5,7 @@ export declare const DEFAULT_INTENTS: GatewayIntentBits[];
 /** Native SDK surface; tests inject transport below the Client rather than replacing its identity. */
 export type DiscordClientTransport = Client;
 export declare function discordClientOptions(intents: readonly number[], gatewayFaultProxyUrl?: string, restOptions?: Partial<RESTOptions>): ClientOptions;
+/** Normalized standing word (`owner` / `admin` / `member`); `undefined` outside a guild. */
 export declare function resolveSenderRole(msg: DiscordInboundMessage): string | undefined;
 export declare function normalizeDiscordMessage(raw: unknown): DiscordInboundMessage | null;
 export declare function toMessageCreateOptions(body: DiscordOutboundBody): Promise<MessageCreateOptions>;