@zhin.js/adapter-slack 1.0.78 → 1.1.2

package/PERMITS.md

@@ -0,0 +1,24 @@
+# Slack Platform Permits
+
+## 入站字段
+
+频道消息异步 enrich（`users.info` + `conversations.info`，TTL 60s）：
+
+| 字段 | 来源 |
+|------|------|
+| `$sender.role` | `owner` · `admin` · `channel_admin` · `member` |
+| `$sender.permissions` | `workspace_owner` · `workspace_admin` · `channel_manager` |
+
+`channel_manager`：频道 `creator === user` 或 workspace 管理员。
+
+## Permit 词汇表
+
+| `platform(slack,…)` | 含义 |
+|---------------------|------|
+| `workspace_owner` | Workspace 主 |
+| `workspace_admin` | Workspace 管理员 |
+| `channel_manager` | 频道管理者 |
+
+## 工厂映射
+
+`scene_admin` → `channel_manager` · `scene_owner` → `workspace_owner`

package/README.md

@@ -1,192 +1,145 @@
 # @zhin.js/adapter-slack
 
-Slack adapter for zhin.js framework.
+Zhin.js Slack 适配器（Plugin Runtime），优先 Socket Mode，也可经 Runtime Host HTTP Events API 收发消息。
 
-## Installation
+## 功能
+
+- **Socket Mode**（默认）：WebSocket 长连接，无需公网 URL
+- **HTTP Events API**：`httpHostToken` POST（签名验证），**非** legacy host-router/Koa
+- 入站经 `Endpoint.emit(...)`；出站 `send({ conversation, payload })` → `chat.postMessage` / Block Kit
+- 约定式 `defineAdapter` / `definePlugin`（无需 `usePlugin`）
+- Block Kit 按钮、斜杠命令、消息编辑、表情反应等（见 `tools/`）
+
+## 安装
 
 ```bash
 pnpm add @zhin.js/adapter-slack
 ```
 
-## Configuration
+## Plugin Runtime
+
+- `@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`）
+- 配置经插件 `schema.json` 落到 `plugins.<instanceKey>`
 
-通过 **`socketMode`** 选择连接方式（默认 `true` 时为 Socket Mode）。
+入站：`gateway.receive({ conversation, message: { conversation, id }, content: text, sender, metadata })`（`conversation` 为 ConversationRef：`channel_type: im` → kind `private`，其余 → kind `group`；线程根 ts 进 `threadId`）  
+出站：`send({ conversation, payload })` → Web API（`conversation.id` 为 channel，`conversation.threadId` 为 thread_ts）
 
-### 模式对比
+### 平台权限（platform permit）
+
+- `plugin.ts` 已注册 checker，Runtime Tool 权限统一经 Core `canAccessTool()`；当前 Slack 入站没有可靠 sender role 时，受限工具按 fail-closed 拒绝，不会静默放行。
+
+## 模式对比
 
 | 模式 | `socketMode` | 适用场景 | 额外字段 |
 |------|--------------|----------|----------|
-| **Socket Mode** | `true`（推荐本地/内网） | 无需公网 URL，WebSocket 长连接 | `appToken`（`xapp-...`） |
-| **HTTP Events** | `false` | 生产环境，有公网 HTTPS | `port`（Bolt 监听端口） |
-
-#### HTTP 模式前置条件
-
-- Slack App 中配置 **Event Subscriptions** 的 Request URL（须公网 HTTPS 可达）
-- 启用对应 Bot Events（`message.*`、`app_mention` 等）
-- 防火墙 / 反向代理放行 `port`
-- **不需要** `@zhin.js/host-router`（由 `@slack/bolt` 自行监听）
-
-### Socket Mode (Recommended for Development)
-
-```typescript
-import { defineConfig } from 'zhin.js'
-
-export default defineConfig({
-  bots: [
-    {
-      name: 'my-slack-bot',
-      context: 'slack',
-      token: 'xoxb-your-bot-token',
-      signingSecret: 'your-signing-secret',
-      appToken: 'xapp-your-app-token',
-      socketMode: true
-    }
-  ]
-})
+| **Socket Mode**（默认） | `true` | 本地/内网，无需公网 URL | `appToken`（`xapp-...`） |
+| **HTTP Events** | `false` | 生产环境有公网 HTTPS | `signingSecret` + Runtime Host |
+
+## 前置条件
+
+1. 创建 Slack App，安装到 Workspace，并授予收发消息所需 OAuth scopes。
+2. Socket Mode 创建 `connections:write` App-Level Token；HTTP 模式配置 Signing Secret 与 Events URL。
+3. 订阅需要的 bot events，并把应用加入目标频道。
+
+## 最小配置（Socket Mode）
+
+```yaml
+# zhin.config.yml（Plugin Runtime）
+plugins:
+  slack:
+    socketMode: true          # 默认 true，可省略
+    endpoints:
+      - id: my-slack-bot
+        token: ${SLACK_BOT_TOKEN}
+        appToken: ${SLACK_APP_TOKEN}
 ```
 
-### HTTP Mode (For Production with Public URL)
-
-```typescript
-import { defineConfig } from 'zhin.js'
-
-export default defineConfig({
-  bots: [
-    {
-      name: 'my-slack-bot',
-      context: 'slack',
-      token: 'xoxb-your-bot-token',
-      signingSecret: 'your-signing-secret',
-      socketMode: false,
-      port: 3000
-    }
-  ]
-})
+多 workspace：一个插件实例挂多个 endpoint（`endpoints` 数组逐项覆盖顶层字段，`id` 必填）：
+
+```yaml
+plugins:
+  slack:
+    endpoints:
+      - id: team-a
+        token: ${SLACK_BOT_TOKEN_A}
+        appToken: ${SLACK_APP_TOKEN_A}
+      - id: team-b
+        token: ${SLACK_BOT_TOKEN_B}
+        appToken: ${SLACK_APP_TOKEN_B}
 ```
 
-## Features
-
-- ✅ Send and receive text messages
-- ✅ Support for rich media (images, files)
-- ✅ Message formatting (Slack mrkdwn)
-- ✅ Reply to messages and threads
-- ✅ Mentions (@user, #channel)
-- ✅ Links and attachments
-- ✅ Socket Mode and HTTP mode
-- ✅ Private messages and channels
-
-## Setting Up Your Slack App
-
-1. Go to [Slack API](https://api.slack.com/apps)
-2. Create a new app
-3. Add Bot Token Scopes:
-   - `chat:write` - Send messages
-   - `chat:write.public` - Send messages to public channels
-   - `channels:read` - View basic channel info
-   - `channels:history` - View messages in channels
-   - `groups:read` - View basic private channel info
-   - `groups:history` - View messages in private channels
-   - `im:read` - View basic direct message info
-   - `im:history` - View messages in direct messages
-   - `mpim:read` - View basic group direct message info
-   - `mpim:history` - View messages in group direct messages
-   - `users:read` - View user info
-   - `files:read` - View files
-   - `files:write` - Upload files
-4. Enable Socket Mode (if using Socket Mode):
-   - Go to Socket Mode settings
-   - Enable Socket Mode
-   - Generate an app-level token with `connections:write` scope
-5. Subscribe to events:
-   - `message.channels` - Messages in public channels
-   - `message.groups` - Messages in private channels
-   - `message.im` - Direct messages
-   - `message.mpim` - Group direct messages
-   - `app_mention` - When the bot is mentioned
-6. Install the app to your workspace
-7. Copy the Bot User OAuth Token (`xoxb-...`)
-8. Copy the Signing Secret
-9. Copy the App-Level Token (`xapp-...`) if using Socket Mode
-
-## Usage Examples
-
-### Basic Message Handling
-
-```typescript
-import { usePlugin, MessageCommand } from 'zhin.js'
-
-const { addCommand } = usePlugin()
-
-addCommand(new MessageCommand('hello')
-  .action(async (message) => {
-    return 'Hello from Slack!'
-  })
-)
+## HTTP Events 配置
+
+```yaml
+plugins:
+  slack:
+    socketMode: false
+    webhookPath: /slack/events   # 可选，默认 /slack/events
+    endpoints:
+      - id: my-slack-bot
+        token: ${SLACK_BOT_TOKEN}
+        signingSecret: ${SLACK_SIGNING_SECRET}
 ```
 
-### Send Rich Messages
-
-```typescript
-addCommand(new MessageCommand('info')
-  .action(async (message) => {
-    return [
-      { type: 'text', data: { text: '*Bold* and _italic_ text\n' } },
-      { type: 'link', data: { url: 'https://slack.com', text: 'Visit Slack' } }
-    ]
-  })
-)
-```
+根插件 `zhin.plugins`（或项目图）需引用 `@zhin.js/adapter-slack`（`instanceKey: slack`）。  
+HTTP 模式下 Runtime Host（`http`）须已 listen；Slack App 的 Event Subscriptions / Interactivity / Slash Commands Request URL 指向 `https://your-domain/slack/events`。
 
-### Mention Users
-
-```typescript
-addCommand(new MessageCommand('mention <userId:text>')
-  .action(async (message, result) => {
-    return [
-      { type: 'at', data: { id: result.params.userId } },
-      { type: 'text', data: { text: ' Hello!' } }
-    ]
-  })
-)
-```
+## 环境变量
 
-### Reply in Thread
+| 变量 | 说明 |
+|------|------|
+| `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；变量名可自行定义 |
 
-```typescript
-addCommand(new MessageCommand('thread')
-  .action(async (message) => {
-    // Reply in a thread by passing the message timestamp
-    await message.$reply('This is a threaded reply!', true)
-  })
-)
-```
+## 消息格式
+
+### 出站（Markdown → mrkdwn）
 
-## Slack-Specific Features
+通用 Markdown（如 `**粗体**`）会转换为 Slack mrkdwn，并通过 Block Kit `section` 发送。
 
-### Slack Formatting
+### 入站（mrkdwn → Markdown）
 
-Slack uses mrkdwn format:
-- `*bold*` for **bold**
-- `_italic_` for *italic*
-- `~strike~` for ~~strikethrough~~
-- `` `code` `` for `code`
-- `> quote` for blockquotes
+| Slack mrkdwn | 通用 Markdown |
+|--------------|---------------|
+| `*bold*` | `**bold**` |
+| `_italic_` | `*italic*` |
+| `~strike~` | `~~strike~~` |
+| `<url\|text>` | `[text](url)` |
 
-### User and Channel Mentions
+## AI 工具
 
-The adapter automatically converts:
-- `<@U12345678>` to user mentions
-- `<#C12345678>` to channel mentions
+| 类别 | 路径 |
+|------|------|
+| Permit 词汇 | `PERMITS.md` |
+| 平台工具 | `tools/`（邀请、话题、反应、置顶、编辑等） |
+| 技能说明 | `agents/slack/skills/slack-channels/SKILL.md`、`agents/slack/skills/slack-messages/SKILL.md` |
 
-### File Uploads
+## 限制
 
-Upload files using the `file` segment type with a local file path.
+- 入站 mrkdwn → Markdown 为启发式转换
+- Modals / Select menus — 暂不支持
+- OAuth 安装流程 — 暂不支持
+- 旧 `usePlugin` / `extends Adapter` / host-router 生产入口已删除
 
-## Limitations
+## 故障排查
 
-- Message recall requires channel information (not available from message ID alone)
-- Some Slack features like interactive components require additional setup
+| 现象 | 排查 |
+| --- | --- |
+| Socket Mode 无法连接 | 检查 `xapp-` Token、Socket Mode 与 `connections:write` scope |
+| HTTP Events 返回 401 | 检查 Signing Secret、原始请求体、服务器时钟与反向代理 |
+| 频道消息未触发 | 确认事件订阅、OAuth scopes，并邀请 App 进入频道 |
+| 线程回复跑到主频道 | 检查入站 `thread_ts` 是否保留为 Conversation `threadId` |
 
-## License
+## 许可证
 
 MIT
+
+## 发送失败与回执
+
+成功发送返回平台 `ts` 组成的消息引用，不以本地时间替代缺失回执。
+文件上传失败会让本次发送失败；分段消息中某段缺少有效回执时，停止后续分段。
+前面已成功的文件或分段不会自动回滚；发送失败可能表示部分已送达，请先核对目标会话再重试。

package/adapters/slack/index.js

@@ -0,0 +1,40 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+/**
+ * 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";
+export default defineAdapter({
+    capabilities: ['inbound', 'outbound'],
+    operations: ['recall', 'edit', 'reaction'],
+    // 媒体段（canonical MediaRef）：kind=url 直发（image 走 attachment image_url，
+    // 其余拉取后上传）；kind=base64 解码后经 files.uploadV2 上传；kind=path 读盘上传；
+    // kind=file 无 Slack 对应物，丢弃留痕。Block Kit 原生按钮承载交互段。
+    segments: {
+        outboundMedia: ['url', 'upload', 'path'],
+        interactive: 'native',
+    },
+    create(context) {
+        const config = resolveSlackConfig(context.config);
+        // 注册到插件运行时状态（slack endpoint list 的"运行中"数据源）
+        context.use(slackRuntimeStateToken).endpoints.set(config.id, {
+            id: config.id,
+            mode: config.mode,
+        });
+        if (config.mode === 'http') {
+            return new SlackEndpoint({
+                id: context.id,
+                http: context.use(httpHostToken),
+                config,
+            });
+        }
+        return new SlackEndpoint({
+            id: context.id,
+            config,
+        });
+    },
+});

package/adapters/slack/index.ts

@@ -0,0 +1,45 @@
+/**
+ * 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 {
+  resolveSlackConfig,
+  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 default defineAdapter<SlackEndpointConfig>({
+  capabilities: ['inbound', 'outbound'],
+  operations: ['recall', 'edit', 'reaction'],
+  // 媒体段（canonical MediaRef）：kind=url 直发（image 走 attachment image_url，
+  // 其余拉取后上传）；kind=base64 解码后经 files.uploadV2 上传；kind=path 读盘上传；
+  // kind=file 无 Slack 对应物，丢弃留痕。Block Kit 原生按钮承载交互段。
+  segments: {
+    outboundMedia: ['url', 'upload', 'path'],
+    interactive: 'native',
+  },
+  create(context) {
+    const config = resolveSlackConfig(context.config);
+    // 注册到插件运行时状态（slack endpoint list 的"运行中"数据源）
+    context.use(slackRuntimeStateToken).endpoints.set(config.id, {
+      id: config.id,
+      mode: config.mode,
+    });
+    if (config.mode === 'http') {
+      return new SlackEndpoint({
+        id: context.id,
+        http: context.use(httpHostToken),
+        config,
+      });
+    }
+    return new SlackEndpoint({
+      id: context.id,
+      config,
+    });
+  },
+});

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/agents/slack/skills/slack-channels/tools/archive_channel/index.ts

@@ -0,0 +1,21 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { platformPermission } from '@zhin.js/permission';
+
+export default defineAgentTool<{
+  channel: string;
+}>({
+  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/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/agents/slack/skills/slack-channels/tools/invite_to_channel/index.ts

@@ -0,0 +1,23 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { platformPermission } from '@zhin.js/permission';
+
+export default defineAgentTool<{
+  channel: string;
+  users: string;
+}>({
+  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/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/agents/slack/skills/slack-channels/tools/set_purpose/index.ts

@@ -0,0 +1,23 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { platformPermission } from '@zhin.js/permission';
+
+export default defineAgentTool<{
+  channel_id: string;
+  purpose: string;
+}>({
+  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/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/agents/slack/skills/slack-channels/tools/set_topic/index.ts

@@ -0,0 +1,23 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { platformPermission } from '@zhin.js/permission';
+
+export default defineAgentTool<{
+  channel: string;
+  topic: string;
+}>({
+  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 ? '已设置频道话题' : '操作失败' };
+  },
+});