@zhin.js/adapter-discord 1.1.0 → 1.1.3

package/CHANGELOG.md

@@ -1,5 +1,115 @@
 # @zhin.js/adapter-discord
 
+## 1.1.3
+
+### Patch Changes
+
+- Updated dependencies [5b5d270]
+- Updated dependencies [36c2eb9]
+  - @zhin.js/im-contract@1.1.2
+  - @zhin.js/core@1.1.38
+  - @zhin.js/adapter@1.1.15
+  - @zhin.js/host-http@1.1.2
+  - @zhin.js/agent-feature@1.1.2
+  - @zhin.js/feature-kit@1.1.2
+  - @zhin.js/permission@1.1.2
+  - @zhin.js/skill@1.1.2
+  - @zhin.js/tool@1.1.2
+
+## 1.1.2
+
+### Patch Changes
+
+- a9e4a40: Derive Command user routes only from explicit `commands/**/*/index.ts(x)` entry paths instead of prepending the plugin owner. Child plugins can now publish top-level static or dynamic commands, while duplicate routes across owners fail during generation construction. Adapter endpoint commands move to explicit paths such as `commands/qq/endpoint/list/index.ts` and are invoked as `qq endpoint list`.
+- 8740059: Standardize TypeScript capabilities on named module directories such as `commands/foo/index.ts`, `middlewares/audit/index.ts`, `handlers/message-receive/index.ts`, `pages/workroom/index.tsx`, and `mcps/filesystem/index.ts`. Only the fixed `index` entry is discovered; sibling files remain private helpers.
+
+  Command route segments come from directories, while `[name]`, `[[name]]`, `[...name]`, and `[[...name]]` directories declare dynamic parameters. Plugin owners do not enter the route unless their config explicitly sets `commandNamespace`; Endpoint `commandPrefix` remains platform-owned and defaults to an empty string.
+
+  Migrate the built-in adapters, plugins, examples, generators, migration tooling, hot reload classification, Agent authoring surfaces, documentation, and release artifacts to the explicit entry convention.
+
+  Make Tool ownership and progressive disclosure explicit across all four supported locations: plugin-public `tools/`, Agent-private `agents/<name>/tools/`, Skill-private `skills/<name>/tools/`, and Agent-Skill-private `agents/<name>/skills/<name>/tools/`. Move adapter and group-suite operations that require domain instructions into their owning Skills so `load_skill` is the only path that unlocks their schemas.
+
+  Remove the package-root `agent/` convention. Public capabilities now use named package-root directories, schedules use `schedules/<name>/index.ts` or `plugin.ts` injection, MCP connections use `mcps/<name>/index.ts`, Prompt Sections use `prompt-sections/<name>/index.ts`, Agent definitions use `agents/<name>/`, and permission vocabulary is published as `PERMITS.md`.
+
+- 25a845a: Unify Skills on `skills/<name>/SKILL.md`, support Agent-private Skills and nested Skill-private Tools, publish and mount existing plugin Skills, add governed Skill metadata and Turn access filtering, unlock only already-admitted same-owner Tools, and make `on-risk` and `once` approval behavior precise.
+- ddbb92e: Isolate adapter Skills under platform-specific Agents and automatically select the matching platform Agent for IM ingress, preventing unrelated adapter Skills from entering another platform's prompt surface.
+- 4380cf9: Colocate adapter command definitions and Agent Skill handlers with their owning capabilities, and provide a shared validated platform permission constructor.
+- bc0df3c: Require the canonical expanded Discord endpoint configuration. The protocol no longer reinterprets nested `endpoints` or reads endpoint identity and token from `process.env`. The public config type is now `DiscordEndpointConfig`, and each schema entry uses `id` as its identity.
+- 5c3858e: Make `@zhin.js/im-contract` the explicit zero-dependency owner of transport identities, canonical segments, media guards, conversation facts, stores, and delivery contracts. Platform adapters now read media contracts from that foundation instead of reaching through Core.
+- 33ea736: Use `tools/<name>/index.ts` and `defineAgentTool` from `@zhin.js/tool` as the sole Agent Tool authoring model. Remove the duplicate `@zhin.js/tools` definition, context, bridge, export, and discovery path; migrate plugin manifests, examples, scaffolding, HMR, and prepack compilation to the generation-owned Tool Feature.
+- Updated dependencies [c861789]
+- Updated dependencies [1414ccb]
+- Updated dependencies [743d470]
+- Updated dependencies [62dee52]
+- Updated dependencies [cd54131]
+- Updated dependencies [244e475]
+- Updated dependencies [a9e4a40]
+- Updated dependencies [5855db7]
+- Updated dependencies [ec921d2]
+- Updated dependencies [8740059]
+- Updated dependencies [63d1f7a]
+- Updated dependencies [25a845a]
+- Updated dependencies [103f2c3]
+- Updated dependencies [9110ab8]
+- Updated dependencies [cd2a888]
+- Updated dependencies [eb3227a]
+- Updated dependencies [b853dba]
+- Updated dependencies [e561309]
+- Updated dependencies [d4c6175]
+- Updated dependencies [7a0e1ca]
+- Updated dependencies [103b5d3]
+- Updated dependencies [5a7a7f7]
+- Updated dependencies [b076eae]
+- Updated dependencies [535fed1]
+- Updated dependencies [73a24b7]
+- Updated dependencies [4380cf9]
+- Updated dependencies [2dbbc15]
+- Updated dependencies [1cb1163]
+- Updated dependencies [be3061e]
+- Updated dependencies [75f8332]
+- Updated dependencies [81935e2]
+- Updated dependencies [f9ed01b]
+- Updated dependencies [ac0ab50]
+- Updated dependencies [5140ce1]
+- Updated dependencies [522d75f]
+- Updated dependencies [a7611b3]
+- Updated dependencies [8823044]
+- Updated dependencies [379439b]
+- Updated dependencies [11c9352]
+- Updated dependencies [6b70e46]
+- Updated dependencies [135ac91]
+- Updated dependencies [140cf0f]
+- Updated dependencies [251e4d2]
+- Updated dependencies [203ad34]
+- Updated dependencies [e6c5113]
+- Updated dependencies [e0f6478]
+- Updated dependencies [baef56b]
+- Updated dependencies [698f16f]
+- Updated dependencies [da0a8e3]
+- Updated dependencies [2fd8017]
+- Updated dependencies [5c3858e]
+- Updated dependencies [33ea736]
+- Updated dependencies [507d602]
+- Updated dependencies [df9f76b]
+  - @zhin.js/core@1.1.37
+  - @zhin.js/tool@1.1.1
+  - @zhin.js/host-http@1.1.1
+  - @zhin.js/adapter@1.1.14
+  - @zhin.js/feature-kit@1.1.1
+  - @zhin.js/agent-feature@1.1.1
+  - @zhin.js/skill@1.1.1
+  - @zhin.js/logger@1.1.1
+  - @zhin.js/im-contract@1.1.1
+  - @zhin.js/permission@1.1.1
+
+## 1.1.1
+
+### Patch Changes
+
+- Updated dependencies [769e67f]
+  - @zhin.js/adapter@1.1.13
+  - @zhin.js/core@1.1.36
+
 ## 1.1.0
 
 ### Minor Changes

package/README.md

@@ -19,7 +19,7 @@ pnpm add @zhin.js/adapter-discord discord.js
 
 ## Plugin Runtime
 
-- `@zhin.js/adapter` — 约定式 `adapters/discord.ts`（`defineAdapter`）
+- `@zhin.js/adapter` — 约定式 `adapters/discord/index.ts`（`defineAdapter`）
 - `@zhin.js/core` — `Endpoint.emit(...)` 入站、`outboundMessageToken` 出站
 - `zhin.js` — `plugin.ts`（`definePlugin`）
 - 配置经插件 `schema.json` 落到 `plugins.<instanceKey>`
@@ -42,7 +42,7 @@ pnpm add @zhin.js/adapter-discord discord.js
 | **Gateway（默认）** | 本地/生产均可；discord.js 连接 Gateway，无需公网 HTTPS |
 | **host-http** | Gateway **不需要**；Interactions webhook 延期至下一棒 |
 
-必填字段（`endpoints[i]`）：`name`、`token`。
+必填字段（`endpoints[i]`）：`id`、`token`。
 
 ## 最小配置
 
@@ -52,7 +52,7 @@ plugins:
   discord:
     # connection: gateway   # 默认
     endpoints:
-      - name: my-discord-bot
+      - id: my-discord-bot
         token: ${DISCORD_BOT_TOKEN}
 ```
 
@@ -62,8 +62,7 @@ plugins:
 
 | 变量 | 说明 |
 |------|------|
-| `DISCORD_BOT_TOKEN` | Bot Token |
-| `DISCORD_BOT_NAME` | 可选，默认 endpoint 名 |
+| `DISCORD_BOT_TOKEN` | YAML 示例中 `token` 引用的 Bot Token |
 
 ## Interactions（HTTP）
 
@@ -73,9 +72,9 @@ plugins:
 
 | 类别 | 路径 |
 |------|------|
-| Permit 词汇 | `agent/PERMITS.md` |
-| 平台工具（7 个） | `agent/tools/`（`discord_*`：角色、Embed、反应等） |
-| 技能说明 | `agent/skills/discord.md` |
+| Permit 词汇 | `PERMITS.md` |
+| 平台工具（7 个） | `agents/discord/skills/discord/tools/`（Skill 激活后披露 `discord_*`：角色、Embed、反应等） |
+| 技能说明 | `agents/discord/skills/discord/SKILL.md` |
 
 工具使用 Discord Snowflake ID 标识 `guild_id`、`user_id`、`channel_id`。
 

package/adapters/{discord.js → discord/index.js}

@@ -1,13 +1,13 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 /**
- * Convention entry: discover `adapters/discord.ts` → defineAdapter.
+ * Convention entry: discover `adapters/discord/index.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
 import { httpHostToken } from '@zhin.js/host-http';
-import { DiscordGatewayEndpoint, DiscordInteractionsEndpoint, } from "../lib/endpoint.js";
-import { resolveDiscordConfig, } from "../lib/protocol.js";
-import { discordRuntimeStateToken } from "../lib/discord-runtime-state.js";
-export { DiscordGatewayEndpoint, DiscordInteractionsEndpoint, } from "../lib/endpoint.js";
+import { DiscordGatewayEndpoint, DiscordInteractionsEndpoint, } from "../../lib/endpoint.js";
+import { resolveDiscordConfig, } from "../../lib/protocol.js";
+import { discordRuntimeStateToken } from "../../lib/discord-runtime-state.js";
+export { DiscordGatewayEndpoint, DiscordInteractionsEndpoint, } from "../../lib/endpoint.js";
 export default defineAdapter({
     capabilities: ['inbound', 'outbound'],
     operations: (context) => context.config.connection === 'interactions'
@@ -21,7 +21,7 @@ export default defineAdapter({
     },
     create(context) {
         const config = resolveDiscordConfig(context.config);
-        // 注册到插件运行时状态（discord.endpoint list 的"运行中"数据源）
+        // 注册到插件运行时状态（discord endpoint list 的"运行中"数据源）
         context.use(discordRuntimeStateToken).endpoints.set(config.id, {
             id: config.id,
             mode: config.connection,

package/adapters/{discord.ts → discord/index.ts}

@@ -1,30 +1,30 @@
 /**
- * Convention entry: discover `adapters/discord.ts` → defineAdapter.
+ * Convention entry: discover `adapters/discord/index.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
 import { httpHostToken } from '@zhin.js/host-http';
 import {
   DiscordGatewayEndpoint,
   DiscordInteractionsEndpoint,
-} from '../src/endpoint.js';
+} from '../../src/endpoint.js';
 import {
   resolveDiscordConfig,
-  type DiscordAdapterConfig,
-} from '../src/protocol.js';
-import { discordRuntimeStateToken } from '../src/discord-runtime-state.js';
+  type DiscordEndpointConfig,
+} from '../../src/protocol.js';
+import { discordRuntimeStateToken } from '../../src/discord-runtime-state.js';
 
 export {
   DiscordGatewayEndpoint,
   DiscordInteractionsEndpoint,
-} from '../src/endpoint.js';
+} from '../../src/endpoint.js';
 export type {
   CreateDiscordClient,
   DiscordClientTransport,
   DiscordEndpointOptions,
   DiscordInteractionsEndpointOptions,
-} from '../src/endpoint.js';
+} from '../../src/endpoint.js';
 
-export default defineAdapter<DiscordAdapterConfig>({
+export default defineAdapter<DiscordEndpointConfig>({
   capabilities: ['inbound', 'outbound'],
   operations: (context) => context.config.connection === 'interactions'
     ? ['recall']
@@ -37,7 +37,7 @@ export default defineAdapter<DiscordAdapterConfig>({
   },
   create(context) {
     const config = resolveDiscordConfig(context.config);
-    // 注册到插件运行时状态（discord.endpoint list 的"运行中"数据源）
+    // 注册到插件运行时状态（discord endpoint list 的"运行中"数据源）
     context.use(discordRuntimeStateToken).endpoints.set(config.id, {
       id: config.id,
       mode: config.connection,

package/agents/discord/agent.json

@@ -0,0 +1,20 @@
+{
+  "name": "DISCORD Platform Agent",
+  "version": "1.0.0",
+  "description": "Handles discord platform-specific operations and progressively loads only the required platform Skill.",
+  "trigger_rules": {
+    "file_patterns": [],
+    "keywords": [
+      "discord",
+      "adapter:discord"
+    ]
+  },
+  "entry_points": [
+    "system.md",
+    "boundaries.md",
+    "conventions.md"
+  ],
+  "platforms": [
+    "discord"
+  ]
+}

package/agents/discord/boundaries.md

@@ -0,0 +1,3 @@
+# Boundaries
+
+Operate only on the active discord endpoint and authenticated conversation context. Respect every Tool permission and approval policy. Do not infer identifiers, roles, or authorization from display names.

package/agents/discord/conventions.md

@@ -0,0 +1,3 @@
+# Conventions
+
+Use stable platform identifiers from the current turn or directory queries. Load one task-specific Skill at a time, and use the unified reply and outbound message path.

package/agents/discord/skills/discord/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: discord
+platforms: [discord]
+description: Discord 角色、线程、论坛帖子、反应和 Embed 操作能力。
+keywords: [discord, role, thread, forum, reaction, embed]
+tags: [adapter, community]
+tools:
+  - add_role
+  - remove_role
+  - list_roles
+  - create_thread
+  - react
+  - send_embed
+  - forum_post
+---
+
+# Discord
+
+按“先查询、后修改”执行：授予或移除角色前先用 `list_roles` 找到角色 ID；创建线程或论坛帖子时使用当前频道上下文；发送结构化内容时使用 `send_embed`；表情回应使用 `react`。
+
+当前 Agent Tool 不提供踢人、封禁、禁言、改昵称或成员列表操作，不要声称已经执行这些动作。

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

@@ -0,0 +1,24 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+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'),
+        user_id: z.string().describe('用户 ID'),
+        role_id: z.string().describe('角色 ID'),
+    }),
+    adapter: 'discord',
+    tags: ['discord'],
+    permissions: [platformPermission('discord', 'manage_roles')],
+    async execute({ guild_id, user_id, role_id }, context) {
+        const client = requireDiscordGatewayClient(context.$client);
+        const guild = await client.guilds.fetch(guild_id);
+        const member = await guild.members.fetch(user_id);
+        await member.roles.add(role_id);
+        const success = true;
+        return { success, message: success ? `已给用户 ${user_id} 添加角色` : '操作失败' };
+    },
+});

package/{agent/tools/add_role.ts → agents/discord/skills/discord/tools/add_role/index.ts}

@@ -1,7 +1,7 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { requireDiscordGatewayClient } from '../../src/client.js';
-import { platformPermit } from '../../src/platform-permit.js';
+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 角色',
@@ -12,7 +12,7 @@ export default defineAgentTool<{ guild_id: string; user_id: string; role_id: str
   }),
   adapter: 'discord',
   tags: ['discord'],
-  permissions: [platformPermit('manage_roles')],
+  permissions: [platformPermission('discord', 'manage_roles')],
   async execute({ guild_id, user_id, role_id  }: { guild_id: string; user_id: string; role_id: string }, context) {
     const client = requireDiscordGatewayClient(context.$client);
     const guild = await client.guilds.fetch(guild_id);

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

@@ -0,0 +1,29 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+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({
+        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）'),
+    }),
+    adapter: 'discord',
+    tags: ['discord'],
+    permissions: [platformPermission('discord', 'manage_channels')],
+    async execute({ channel_id, name, message_id, auto_archive_duration }, context) {
+        const client = requireDiscordGatewayClient(context.$client);
+        const channel = await client.channels.fetch(channel_id);
+        if (!channel?.threads)
+            throw new Error(`Channel ${channel_id} 不支持创建帖子`);
+        const thread = await channel.threads.create({
+            name,
+            autoArchiveDuration: auto_archive_duration || 1440,
+            ...(message_id ? { startMessage: message_id } : {}),
+        });
+        return { success: true, thread_id: thread.id, message: `帖子 "${name}" 已创建` };
+    },
+});

package/{agent/tools/create_thread.ts → agents/discord/skills/discord/tools/create_thread/index.ts}

@@ -1,7 +1,7 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { requireDiscordGatewayClient } from '../../src/client.js';
-import { platformPermit } from '../../src/platform-permit.js';
+import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
+import { platformPermission } from '@zhin.js/permission';
 
 export default defineAgentTool<{ channel_id: string; name: string; message_id?: string; auto_archive_duration?: number }>({
   description: '在 Discord 频道中创建帖子/子线程',
@@ -13,7 +13,7 @@ export default defineAgentTool<{ channel_id: string; name: string; message_id?:
   }),
   adapter: 'discord',
   tags: ['discord'],
-  permissions: [platformPermit('manage_channels')],
+  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) {
     const client = requireDiscordGatewayClient(context.$client);
     const channel = await client.channels.fetch(channel_id);

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

@@ -0,0 +1,33 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+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 论坛频道中创建帖子',
+    inputSchema: z.object({
+        channel_id: z.string().describe('论坛频道 ID'),
+        name: z.string().describe('帖子标题'),
+        content: z.string().describe('帖子内容'),
+        tags: z.string().optional().describe('标签名，逗号分隔（可选）'),
+    }),
+    adapter: 'discord',
+    tags: ['discord'],
+    async execute({ channel_id, name, content, tags }, context) {
+        const client = requireDiscordGatewayClient(context.$client);
+        const tagList = tags ? tags.split(',').map((t) => t.trim()) : undefined;
+        const channel = await client.channels.fetch(channel_id);
+        if (!channel?.threads || channel.type !== ChannelType.GuildForum) {
+            throw new Error(`Channel ${channel_id} 不是论坛频道`);
+        }
+        const tagIds = tagList?.length
+            ? channel.availableTags?.filter((tag) => tagList.includes(tag.name)).map((tag) => tag.id)
+            : undefined;
+        const thread = await channel.threads.create({
+            name,
+            message: { content },
+            ...(tagIds?.length ? { appliedTags: tagIds } : {}),
+        });
+        return { success: true, thread_id: thread.id, message: `论坛帖 "${name}" 已创建` };
+    },
+});

package/{agent/tools/forum_post.ts → agents/discord/skills/discord/tools/forum_post/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { requireDiscordGatewayClient } from '../../src/client.js';
+import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
 import { ChannelType } from 'discord.js';
 
 export default defineAgentTool<{ channel_id: string; name: string; content: string; tags?: string }>({

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

@@ -0,0 +1,28 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+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'),
+    }),
+    adapter: 'discord',
+    tags: ['discord'],
+    permissions: [platformPermission('discord', 'manage_roles')],
+    async execute({ guild_id }, context) {
+        const client = requireDiscordGatewayClient(context.$client);
+        const guild = await client.guilds.fetch(guild_id);
+        await guild.roles.fetch();
+        const cache = guild.roles.cache;
+        const roles = [...cache.values()].map((role) => ({
+            id: role.id,
+            name: role.name,
+            color: role.hexColor,
+            position: role.position,
+            permissions: role.permissions.bitfield.toString(),
+        }));
+        return { roles, count: roles.length };
+    },
+});

package/{agent/tools/list_roles.ts → agents/discord/skills/discord/tools/list_roles/index.ts}

@@ -1,7 +1,7 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { requireDiscordGatewayClient } from '../../src/client.js';
-import { platformPermit } from '../../src/platform-permit.js';
+import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
+import { platformPermission } from '@zhin.js/permission';
 
 export default defineAgentTool<{ guild_id: string }>({
   description: '获取 Discord 服务器角色列表',
@@ -10,7 +10,7 @@ export default defineAgentTool<{ guild_id: string }>({
   }),
   adapter: 'discord',
   tags: ['discord'],
-  permissions: [platformPermit('manage_roles')],
+  permissions: [platformPermission('discord', 'manage_roles')],
   async execute({ guild_id  }: { guild_id: string }, context) {
     const client = requireDiscordGatewayClient(context.$client);
     const guild = await client.guilds.fetch(guild_id);

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

@@ -0,0 +1,24 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
+export default defineAgentTool({
+    description: '对 Discord 消息添加表情反应',
+    inputSchema: z.object({
+        channel_id: z.string().describe('频道 ID'),
+        message_id: z.string().describe('消息 ID'),
+        emoji: z.string().describe('表情（Unicode 表情或自定义表情如 <:name:id>）'),
+    }),
+    adapter: 'discord',
+    tags: ['discord'],
+    async execute({ channel_id, message_id, emoji }, context) {
+        const client = requireDiscordGatewayClient(context.$client);
+        const channel = await client.channels.fetch(channel_id);
+        if (!channel?.isTextBased() || !channel.messages) {
+            throw new Error(`Channel ${channel_id} 不是文本频道`);
+        }
+        const message = await channel.messages.fetch(message_id);
+        await message.react(emoji);
+        return { success: true, message: `已添加反应 ${emoji}` };
+    },
+});

package/{agent/tools/react.ts → agents/discord/skills/discord/tools/react/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { requireDiscordGatewayClient } from '../../src/client.js';
+import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
 
 export default defineAgentTool<{ channel_id: string; message_id: string; emoji: string }>({
   description: '对 Discord 消息添加表情反应',

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

@@ -0,0 +1,24 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+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'),
+        user_id: z.string().describe('用户 ID'),
+        role_id: z.string().describe('角色 ID'),
+    }),
+    adapter: 'discord',
+    tags: ['discord'],
+    permissions: [platformPermission('discord', 'manage_roles')],
+    async execute({ guild_id, user_id, role_id }, context) {
+        const client = requireDiscordGatewayClient(context.$client);
+        const guild = await client.guilds.fetch(guild_id);
+        const member = await guild.members.fetch(user_id);
+        await member.roles.remove(role_id);
+        const success = true;
+        return { success, message: success ? `已移除用户 ${user_id} 的角色` : '操作失败' };
+    },
+});

package/{agent/tools/remove_role.ts → agents/discord/skills/discord/tools/remove_role/index.ts}

@@ -1,7 +1,7 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { requireDiscordGatewayClient } from '../../src/client.js';
-import { platformPermit } from '../../src/platform-permit.js';
+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 角色',
@@ -12,7 +12,7 @@ export default defineAgentTool<{ guild_id: string; user_id: string; role_id: str
   }),
   adapter: 'discord',
   tags: ['discord'],
-  permissions: [platformPermit('manage_roles')],
+  permissions: [platformPermission('discord', 'manage_roles')],
   async execute({ guild_id, user_id, role_id  }: { guild_id: string; user_id: string; role_id: string }, context) {
     const client = requireDiscordGatewayClient(context.$client);
     const guild = await client.guilds.fetch(guild_id);

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

@@ -0,0 +1,43 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { requireDiscordGatewayClient } from '@zhin.js/adapter-discord';
+export default defineAgentTool({
+    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）'),
+        url: z.string().optional().describe('标题链接（可选）'),
+        fields: z.string().optional().describe('字段，JSON 格式: [{"name":"k","value":"v","inline":false}]'),
+    }),
+    adapter: 'discord',
+    tags: ['discord'],
+    async execute({ channel_id, title, description, color, url, fields }, context) {
+        const client = requireDiscordGatewayClient(context.$client);
+        const embedData = {};
+        if (title)
+            embedData.title = title;
+        if (description)
+            embedData.description = description;
+        if (color)
+            embedData.color = color;
+        if (url)
+            embedData.url = url;
+        if (fields) {
+            try {
+                embedData.fields = JSON.parse(fields);
+            }
+            catch {
+                return { success: false, message: 'fields 格式错误，应为 JSON 数组' };
+            }
+        }
+        const channel = await client.channels.fetch(channel_id);
+        if (!channel?.isTextBased() || !channel.send) {
+            throw new Error(`Channel ${channel_id} 不是文本频道`);
+        }
+        const msg = await channel.send({ embeds: [embedData] });
+        return { success: true, message_id: msg.id, message: 'Embed 已发送' };
+    },
+});

package/{agent/tools/send_embed.ts → agents/discord/skills/discord/tools/send_embed/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { requireDiscordGatewayClient } from '../../src/client.js';
+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）',

package/agents/discord/system.md

@@ -0,0 +1,3 @@
+# DISCORD Platform Agent
+
+You are the discord platform specialist. Interpret requests in the current discord conversation and load only the narrowest private Skill needed for the task.

package/commands/{endpoint/add/[id].js → discord/endpoint/add/[id]/index.js}

@@ -1,3 +1,3 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { discordEndpointCommands } from "../../../lib/discord-endpoint-commands.js";
+import { discordEndpointCommands } from '../../definition.js';
 export default discordEndpointCommands.add;

package/commands/discord/endpoint/add/[id]/index.ts

@@ -0,0 +1,3 @@
+import { discordEndpointCommands } from '../../definition.js';
+
+export default discordEndpointCommands.add;