@zhin.js/adapter-slack 1.1.0 → 1.1.2

package/CHANGELOG.md

@@ -1,5 +1,98 @@
 # Changelog
 
+## 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.
+- 40d2c8f: Reduce the default Agent Tool surface by moving process diagnostics into a Skill and splitting broad platform Skills into focused task domains. Restore ICQQ friend and group directory tools with `on-risk` approval and explicit owner, administrator, master, or trusted access.
+- 4380cf9: Colocate adapter command definitions and Agent Skill handlers with their owning capabilities, and provide a shared validated platform permission constructor.
+- 9f7cd76: Require the canonical expanded Slack endpoint configuration. The protocol no longer reinterprets nested `endpoints` or reads endpoint identity and credentials from `process.env`. The public config type is now `SlackEndpointConfig`, with mode-specific credential validation.
+- 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 [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
+
+## 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

@@ -8,7 +8,7 @@ Zhin.js Slack 适配器（Plugin Runtime），优先 Socket Mode，也可经 Run
 - **HTTP Events API**：`httpHostToken` POST（签名验证），**非** legacy host-router/Koa
 - 入站经 `Endpoint.emit(...)`；出站 `send({ conversation, payload })` → `chat.postMessage` / Block Kit
 - 约定式 `defineAdapter` / `definePlugin`（无需 `usePlugin`）
-- Block Kit 按钮、斜杠命令、消息编辑、表情反应等（见 `agent/tools/`）
+- Block Kit 按钮、斜杠命令、消息编辑、表情反应等（见 `tools/`）
 
 ## 安装
 
@@ -18,7 +18,7 @@ pnpm add @zhin.js/adapter-slack
 
 ## Plugin Runtime
 
-- `@zhin.js/adapter` — 约定式 `adapters/slack.ts`（`defineAdapter`）
+- `@zhin.js/adapter` — 约定式 `adapters/slack/index.ts`（`defineAdapter`）
 - `@zhin.js/core` — `Endpoint.emit(...)` 入站、`outboundMessageToken` 出站
 - `@zhin.js/host-http` — 仅 HTTP 模式需要 `httpHostToken` 注册 Events 路由
 - `zhin.js` — `plugin.ts`（`definePlugin`）
@@ -52,21 +52,21 @@ plugins:
   slack:
     socketMode: true          # 默认 true，可省略
     endpoints:
-      - name: my-slack-bot
+      - id: my-slack-bot
         token: ${SLACK_BOT_TOKEN}
         appToken: ${SLACK_APP_TOKEN}
 ```
 
-多 workspace：一个插件实例挂多个 endpoint（`endpoints` 数组逐项覆盖顶层字段，`name` 必填）：
+多 workspace：一个插件实例挂多个 endpoint（`endpoints` 数组逐项覆盖顶层字段，`id` 必填）：
 
 ```yaml
 plugins:
   slack:
     endpoints:
-      - name: team-a
+      - id: team-a
         token: ${SLACK_BOT_TOKEN_A}
         appToken: ${SLACK_APP_TOKEN_A}
-      - name: team-b
+      - id: team-b
         token: ${SLACK_BOT_TOKEN_B}
         appToken: ${SLACK_APP_TOKEN_B}
 ```
@@ -79,7 +79,7 @@ plugins:
     socketMode: false
     webhookPath: /slack/events   # 可选，默认 /slack/events
     endpoints:
-      - name: my-slack-bot
+      - id: my-slack-bot
         token: ${SLACK_BOT_TOKEN}
         signingSecret: ${SLACK_SIGNING_SECRET}
 ```
@@ -91,10 +91,9 @@ HTTP 模式下 Runtime Host（`http`）须已 listen；Slack App 的 Event Subsc
 
 | 变量 | 说明 |
 |------|------|
-| `SLACK_BOT_TOKEN` / `SLACK_TOKEN` | Bot User OAuth Token（`xoxb-...`） |
-| `SLACK_APP_TOKEN` | App-Level Token（Socket Mode，`xapp-...`） |
-| `SLACK_SIGNING_SECRET` | Signing Secret（HTTP 模式） |
-| `SLACK_BOT_NAME` | 可选 endpoint 名称 |
+| `SLACK_BOT_TOKEN` | 示例中由 YAML `${SLACK_BOT_TOKEN}` 引用的 Bot User OAuth Token；变量名可自行定义 |
+| `SLACK_APP_TOKEN` | 示例中由 YAML `${SLACK_APP_TOKEN}` 引用的 App-Level Token；变量名可自行定义 |
+| `SLACK_SIGNING_SECRET` | 示例中由 YAML `${SLACK_SIGNING_SECRET}` 引用的 Signing Secret；变量名可自行定义 |
 
 ## 消息格式
 
@@ -115,9 +114,9 @@ HTTP 模式下 Runtime Host（`http`）须已 listen；Slack App 的 Event Subsc
 
 | 类别 | 路径 |
 |------|------|
-| Permit 词汇 | `agent/PERMITS.md` |
-| 平台工具 | `agent/tools/`（邀请、话题、反应、置顶、编辑等） |
-| 技能说明 | `agent/skills/slack.md` |
+| Permit 词汇 | `PERMITS.md` |
+| 平台工具 | `tools/`（邀请、话题、反应、置顶、编辑等） |
+| 技能说明 | `agents/slack/skills/slack-channels/SKILL.md`、`agents/slack/skills/slack-messages/SKILL.md` |
 
 ## 限制
 

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

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

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

@@ -1,19 +1,19 @@
 /**
- * Convention entry: discover `adapters/slack.ts` → defineAdapter.
+ * Convention entry: discover `adapters/slack/index.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
 import { httpHostToken } from '@zhin.js/host-http';
-import { SlackEndpoint } from '../src/endpoint.js';
+import { SlackEndpoint } from '../../src/endpoint.js';
 import {
   resolveSlackConfig,
-  type SlackAdapterConfig,
-} from '../src/protocol.js';
-import { slackRuntimeStateToken } from '../src/slack-runtime-state.js';
+  type SlackEndpointConfig,
+} from '../../src/protocol.js';
+import { slackRuntimeStateToken } from '../../src/slack-runtime-state.js';
 
-export { SlackEndpoint } from '../src/endpoint.js';
-export type { SlackEndpointOptions, SlackSocketLike, SlackWebClientLike } from '../src/endpoint.js';
+export { SlackEndpoint } from '../../src/endpoint.js';
+export type { SlackEndpointOptions, SlackSocketLike, SlackWebClientLike } from '../../src/endpoint.js';
 
-export default defineAdapter<SlackAdapterConfig>({
+export default defineAdapter<SlackEndpointConfig>({
   capabilities: ['inbound', 'outbound'],
   operations: ['recall', 'edit', 'reaction'],
   // 媒体段（canonical MediaRef）：kind=url 直发（image 走 attachment image_url，
@@ -25,7 +25,7 @@ export default defineAdapter<SlackAdapterConfig>({
   },
   create(context) {
     const config = resolveSlackConfig(context.config);
-    // 注册到插件运行时状态（slack.endpoint list 的"运行中"数据源）
+    // 注册到插件运行时状态（slack endpoint list 的"运行中"数据源）
     context.use(slackRuntimeStateToken).endpoints.set(config.id, {
       id: config.id,
       mode: config.mode,

package/agents/slack/agent.json

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

package/agents/slack/boundaries.md

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

package/agents/slack/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/slack/skills/slack-channels/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: slack-channels
+platforms:
+  - slack
+description: Slack 用户查询、频道邀请、主题、用途和归档管理能力。
+keywords:
+  - "slack"
+  - "channel"
+  - "invite"
+  - "topic"
+  - "archive"
+  - "user"
+tools:
+  - "invite_to_channel"
+  - "set_topic"
+  - "set_purpose"
+  - "archive_channel"
+  - "unarchive"
+  - "user_info"
+---
+
+# slack-channels
+
+先查询用户 ID，再邀请或修改频道。归档和恢复属于频道状态变更，遵守 Tool 审批。

package/agents/slack/skills/slack-channels/tools/archive_channel/index.js

@@ -0,0 +1,19 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { platformPermission } from '@zhin.js/permission';
+export default defineAgentTool({
+    description: '归档 Slack 频道',
+    inputSchema: z.object({
+        channel: z.string().describe('频道 ID'),
+    }),
+    adapter: 'slack',
+    tags: ['slack'],
+    permissions: [platformPermission('slack', 'workspace_admin')],
+    async execute({ channel }, context) {
+        const client = context.$client;
+        await client.conversations.archive({ channel });
+        const success = true;
+        return { success, message: success ? '已归档频道' : '操作失败' };
+    },
+});

package/{agent/tools/archive_channel.ts → agents/slack/skills/slack-channels/tools/archive_channel/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { platformPermit } from '../../src/platform-permit.js';
+import { platformPermission } from '@zhin.js/permission';
 
 export default defineAgentTool<{
   channel: string;
@@ -11,7 +11,7 @@ export default defineAgentTool<{
   }),
   adapter: 'slack',
   tags: ['slack'],
-  permissions: [platformPermit('workspace_admin')],
+  permissions: [platformPermission('slack', 'workspace_admin')],
   async execute({ channel }, context) {
     const client = context.$client;
     await client.conversations.archive({ channel });

package/agents/slack/skills/slack-channels/tools/invite_to_channel/index.js

@@ -0,0 +1,20 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { platformPermission } from '@zhin.js/permission';
+export default defineAgentTool({
+    description: '邀请用户加入 Slack 频道',
+    inputSchema: z.object({
+        channel: z.string().describe('频道 ID'),
+        users: z.string().describe('用户 ID 列表（逗号分隔）'),
+    }),
+    adapter: 'slack',
+    tags: ['slack'],
+    permissions: [platformPermission('slack', 'channel_manager')],
+    async execute({ channel, users }, context) {
+        const client = context.$client;
+        await client.conversations.invite({ channel, users });
+        const success = true;
+        return { success, message: success ? '已邀请用户加入频道' : '操作失败' };
+    },
+});

package/{agent/tools/invite_to_channel.ts → agents/slack/skills/slack-channels/tools/invite_to_channel/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { platformPermit } from '../../src/platform-permit.js';
+import { platformPermission } from '@zhin.js/permission';
 
 export default defineAgentTool<{
   channel: string;
@@ -13,7 +13,7 @@ export default defineAgentTool<{
   }),
   adapter: 'slack',
   tags: ['slack'],
-  permissions: [platformPermit('channel_manager')],
+  permissions: [platformPermission('slack', 'channel_manager')],
   async execute({ channel, users }, context) {
     const client = context.$client;
     await client.conversations.invite({ channel, users });

package/agents/slack/skills/slack-channels/tools/set_purpose/index.js

@@ -0,0 +1,20 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { platformPermission } from '@zhin.js/permission';
+export default defineAgentTool({
+    description: '设置 Slack 频道的用途/目的',
+    inputSchema: z.object({
+        channel_id: z.string().describe('频道 ID'),
+        purpose: z.string().describe('频道用途描述'),
+    }),
+    adapter: 'slack',
+    tags: ['slack'],
+    permissions: [platformPermission('slack', 'channel_manager')],
+    async execute({ channel_id, purpose }, context) {
+        const client = context.$client;
+        await client.conversations.setPurpose({ channel: channel_id, purpose });
+        const success = true;
+        return { success, message: success ? '频道用途已更新' : '操作失败' };
+    },
+});

package/{agent/tools/set_purpose.ts → agents/slack/skills/slack-channels/tools/set_purpose/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { platformPermit } from '../../src/platform-permit.js';
+import { platformPermission } from '@zhin.js/permission';
 
 export default defineAgentTool<{
   channel_id: string;
@@ -13,7 +13,7 @@ export default defineAgentTool<{
   }),
   adapter: 'slack',
   tags: ['slack'],
-  permissions: [platformPermit('channel_manager')],
+  permissions: [platformPermission('slack', 'channel_manager')],
   async execute({ channel_id, purpose }, context) {
     const client = context.$client;
     await client.conversations.setPurpose({ channel: channel_id, purpose });

package/agents/slack/skills/slack-channels/tools/set_topic/index.js

@@ -0,0 +1,20 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { platformPermission } from '@zhin.js/permission';
+export default defineAgentTool({
+    description: '设置 Slack 频道话题',
+    inputSchema: z.object({
+        channel: z.string().describe('频道 ID'),
+        topic: z.string().describe('新话题'),
+    }),
+    adapter: 'slack',
+    tags: ['slack'],
+    permissions: [platformPermission('slack', 'channel_manager')],
+    async execute({ channel, topic }, context) {
+        const client = context.$client;
+        await client.conversations.setTopic({ channel, topic });
+        const success = true;
+        return { success, message: success ? '已设置频道话题' : '操作失败' };
+    },
+});

package/{agent/tools/set_topic.ts → agents/slack/skills/slack-channels/tools/set_topic/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { platformPermit } from '../../src/platform-permit.js';
+import { platformPermission } from '@zhin.js/permission';
 
 export default defineAgentTool<{
   channel: string;
@@ -13,7 +13,7 @@ export default defineAgentTool<{
   }),
   adapter: 'slack',
   tags: ['slack'],
-  permissions: [platformPermit('channel_manager')],
+  permissions: [platformPermission('slack', 'channel_manager')],
   async execute({ channel, topic }, context) {
     const client = context.$client;
     await client.conversations.setTopic({ channel, topic });

package/agents/slack/skills/slack-channels/tools/unarchive/index.js

@@ -0,0 +1,19 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { platformPermission } from '@zhin.js/permission';
+export default defineAgentTool({
+    description: '恢复已归档的 Slack 频道',
+    inputSchema: z.object({
+        channel_id: z.string().describe('频道 ID'),
+    }),
+    adapter: 'slack',
+    tags: ['slack'],
+    permissions: [platformPermission('slack', 'workspace_admin')],
+    async execute({ channel_id }, context) {
+        const client = context.$client;
+        await client.conversations.unarchive({ channel: channel_id });
+        const success = true;
+        return { success, message: success ? '频道已恢复' : '操作失败' };
+    },
+});

package/{agent/tools/unarchive.ts → agents/slack/skills/slack-channels/tools/unarchive/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { platformPermit } from '../../src/platform-permit.js';
+import { platformPermission } from '@zhin.js/permission';
 
 export default defineAgentTool<{
   channel_id: string;
@@ -11,7 +11,7 @@ export default defineAgentTool<{
   }),
   adapter: 'slack',
   tags: ['slack'],
-  permissions: [platformPermit('workspace_admin')],
+  permissions: [platformPermission('slack', 'workspace_admin')],
   async execute({ channel_id }, context) {
     const client = context.$client;
     await client.conversations.unarchive({ channel: channel_id });

package/agents/slack/skills/slack-channels/tools/user_info/index.js

@@ -0,0 +1,27 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '查询 Slack 用户详细信息',
+    inputSchema: z.object({
+        user_id: z.string().describe('用户 ID'),
+    }),
+    adapter: 'slack',
+    tags: ['slack'],
+    async execute({ user_id }, context) {
+        const client = context.$client;
+        const user = (await client.users.info({ user: user_id })).user;
+        if (!user)
+            throw new Error(`Slack 用户不存在: ${user_id}`);
+        return {
+            id: user.id,
+            name: user.name,
+            real_name: user.real_name,
+            display_name: user.profile?.display_name,
+            email: user.profile?.email,
+            is_admin: user.is_admin,
+            is_bot: user.is_bot,
+            status_text: user.profile?.status_text,
+        };
+    },
+});

package/{agent/tools/user_info.ts → agents/slack/skills/slack-channels/tools/user_info/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import type { SlackUserInfo } from '../../src/client.js';
+import type { SlackUserInfo } from '@zhin.js/adapter-slack';
 
 export default defineAgentTool<{
   user_id: string;

package/agents/slack/skills/slack-messages/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: slack-messages
+platforms:
+  - slack
+description: Slack 消息编辑、置顶和 reaction 管理能力。
+keywords:
+  - "slack"
+  - "message"
+  - "pin"
+  - "reaction"
+  - "edit"
+tools:
+  - "pin_message"
+  - "unpin_message"
+  - "add_reaction"
+  - "remove_reaction"
+  - "edit_message"
+---
+
+# slack-messages
+
+使用稳定频道 ID 与消息时间戳。编辑、置顶和 reaction 变更均遵守 Tool 审批。

package/agents/slack/skills/slack-messages/tools/add_reaction/index.js

@@ -0,0 +1,27 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { normalizeSlackReactionName } from '@zhin.js/adapter-slack';
+export default defineAgentTool({
+    description: '给 Slack 消息添加表情反应',
+    inputSchema: z.object({
+        channel: z.string().describe('频道 ID'),
+        timestamp: z.string().describe('消息时间戳'),
+        emoji: z.string().describe('表情名称（不含冒号）'),
+    }),
+    adapter: 'slack',
+    tags: ['slack'],
+    async execute({ channel, timestamp, emoji }, context) {
+        const client = context.$client;
+        const name = normalizeSlackReactionName(emoji);
+        try {
+            await client.reactions.add({ channel, timestamp, name });
+        }
+        catch (error) {
+            if (error?.data?.error !== 'already_reacted')
+                throw error;
+        }
+        const success = true;
+        return { success, message: success ? `已添加反应 :${emoji}:` : '操作失败' };
+    },
+});

package/{agent/tools/add_reaction.ts → agents/slack/skills/slack-messages/tools/add_reaction/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { normalizeSlackReactionName } from '../../src/slack-reaction.js';
+import { normalizeSlackReactionName } from '@zhin.js/adapter-slack';
 
 export default defineAgentTool<{
   channel: string;

package/agents/slack/skills/slack-messages/tools/edit_message/index.js

@@ -0,0 +1,21 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { editSlackContent } from '@zhin.js/adapter-slack';
+export default defineAgentTool({
+    description: '编辑 Slack 消息',
+    inputSchema: z.object({
+        channel: z.string().describe('频道 ID'),
+        message_ts: z.string().describe('消息时间戳'),
+        text: z.string().describe('新的消息文本'),
+    }),
+    adapter: 'slack',
+    tags: ['slack'],
+    async execute({ channel, message_ts, text }, context) {
+        const client = context.$client;
+        await editSlackContent(client, channel, message_ts, [
+            { type: 'text', data: { text } },
+        ]);
+        return { success: true, message: '消息已编辑' };
+    },
+});

package/{agent/tools/edit_message.ts → agents/slack/skills/slack-messages/tools/edit_message/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { editSlackContent } from '../../src/slack-outbound.js';
+import { editSlackContent } from '@zhin.js/adapter-slack';
 
 export default defineAgentTool<{
   channel: string;