@zhin.js/adapter-slack 4.1.0 → 4.1.1

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # Changelog
 
+## 4.1.1
+
+### Patch Changes
+
+- cc5c94d: 约定式插件运行时迁移（breaking）：插件与适配器由 `usePlugin()` / `extends Adapter` 迁移为 `definePlugin` / `defineAdapter` + `plugin.ts` + 约定目录（`adapters/`、`commands/`、`components/`、`tools/` 等）。
+
+  - 新增约定式运行时包：`@zhin.js/plugin-runtime`、`@zhin.js/adapter`、`@zhin.js/runtime`、`@zhin.js/host-http`（首版 1.0.0 走 init-publish，不在本 changeset 内 bump）。
+  - 全部 20 个平台适配器改为约定式 `defineAdapter`，旧 `usePlugin` / `extends Adapter` / `segment-mapper` 生产入口已删除；onebot11 反向 WSS、onebot12 webhook/wss、milky sse/webhook/wss、satori webhook、kook webhook、qq webhook/middleware 等 slice 1 推迟的连接模式已补齐。
+  - 游戏 / 工具 / 服务插件同步迁移到约定目录结构。
+  - CLI 增加 plugin-runtime host installer（http/database/outbound/schedule/console 等）。
+
+  后续加固（同批）：
+
+  - CLI：`zhin runtime start --daemon`（pidfile/崩溃拉起/风暴保护），orphan watchdog 防僵尸进程；legacy `zhin dev` / `zhin start` 已移除（含 `zhin restart`），`zhin stop` 兼容新 daemon。
+  - 安全：builtin 工具统一走 `security/policy-facade.ts` 的 `runToolPolicies`（声明式策略表，deny 优先）；审计日志 close flush + 背压队列；`splitCompoundCommand` 引号感知、`extractCommandName` 去引号堵绕过。
+  - 日志：Logger 双堆栈修复、本地时区、`getLogger` 挂树（`setLevel` 递归生效）、第三方库（log4js/discord）桥接、启动人读总结。
+  - 结构：`plugins/games/shared` 迁为 `packages/game-kit`（`@zhin.js/game-kit`）；死目录 `plugins/adapters/common` 删除。
+  - 脚手架：`create-zhin-app` / `zhin new` / scaffold-wizard 生成物改为 Plugin Runtime 形态（minimal-bot 同构，新配置格式）。
+  - Console：endpoint.list 真实名称与 phase、schema:get-all 按 instanceKey 映射、db:\* 接 DatabaseHost。
+
+  注：按仓库发布惯例（见 1bb345dd2），本次 breaking 迁移统一使用 patch，避免 zhin.js 5.0 级联。
+
+- 447f3e2: 迁移缺口修复（legacy 功能对齐）：
+
+  - html 段出站规范化：经 `@zhin.js/html-renderer` 渲染为 image 段（sandbox 豁免、无渲染器时降级文本），修复真实平台 `[object Object]`。
+  - 群聊 @ 触发 AI：适配器入站标注 `metadata.mentioned`（icqq/qq/slack/onebot11/onebot12/napcat/milky/discord/telegram/kook/dingtalk/satori），`matchAiTrigger` 补齐 ignorePrefixes/respondToAt/respondToPrivate/keywords（默认值与 legacy 对齐）。
+  - im_transcripts 全量流水恢复写入（chat_history 工具可用）；群聊旁听上下文回迁。
+  - `ai.trigger.timeout/thinkingMessage/errorTemplate` 生效；masters/trusted 角色解析对齐 legacy。
+  - `Message.sender` 统一为用户 ID（onebot11/12、napcat、milky 原误传显示名）；quote_id 经 metadata 接入 AI 引用上下文。
+
+- Updated dependencies [16ec4e8]
+- Updated dependencies [cc5c94d]
+- Updated dependencies [447f3e2]
+  - @zhin.js/core@1.3.5
+  - @zhin.js/agent@1.0.4
+  - @zhin.js/host-http@1.0.1
+  - zhin.js@4.1.3
+  - @zhin.js/logger@1.0.75
+  - @zhin.js/plugin-runtime@1.0.1
+  - @zhin.js/adapter@1.0.1
+
 ## 4.1.0
 
 ### Minor Changes

package/README.md

@@ -1,6 +1,14 @@
 # @zhin.js/adapter-slack
 
-Zhin.js 的 Slack 适配器，支持消息收发、Block Kit 交互与 Assistant API。
+Zhin.js Slack 适配器（Plugin Runtime），优先 Socket Mode，也可经 Runtime Host HTTP Events API 收发消息。
+
+## 功能
+
+- **Socket Mode**（默认）：WebSocket 长连接，无需公网 URL
+- **HTTP Events API**：`httpHostToken` POST（签名验证），**非** legacy host-router/Koa
+- 入站经 `messageGatewayToken`；出站 `send({ target, payload })` → `chat.postMessage` / Block Kit
+- 约定式 `defineAdapter` / `definePlugin`（无需 `usePlugin`）
+- Block Kit 按钮、斜杠命令、消息编辑、表情反应等（见 `agent/tools/`）
 
 ## 安装
 
@@ -8,293 +16,93 @@ Zhin.js 的 Slack 适配器，支持消息收发、Block Kit 交互与 Assistant
 pnpm add @zhin.js/adapter-slack
 ```
 
-## 配置
-
-通过 **`socketMode`** 选择连接方式。
+## Plugin Runtime
 
-### 模式对比
+- `@zhin.js/adapter` — 约定式 `adapters/slack.ts`（`defineAdapter`）
+- `@zhin.js/core` — `messageGatewayToken` 入站/出站
+- `@zhin.js/host-http` — 仅 HTTP 模式需要 `httpHostToken` 注册 Events 路由
+- `@zhin.js/plugin-runtime` — `plugin.ts`（`definePlugin`）
+- 配置经插件 `schema.json` 落到 `plugins.<instanceKey>`
 
-| 模式 | `socketMode` | 适用场景 | 额外字段 |
-|------|--------------|----------|----------|
-| **Socket Mode** | `true`（推荐本地/内网） | 无需公网 URL，WebSocket 长连接 | `appToken`（`xapp-...`） |
-| **HTTP Events** | `false` | 生产环境，有公网 HTTPS | 共享 zhin router 端口 8086 |
+入站：`gateway.receive({ adapter, target: channelId, content: text, sender, metadata })`  
+出站：`send({ target, payload })` → Web API（`target` 可为 `channel` 或 `channel:thread_ts`）
 
-### Socket Mode（推荐开发环境）
+### 平台权限（platform permit）
 
-可选 `clientPingTimeout`（毫秒，默认 `15000`）用于调整 Socket Mode 客户端心跳超时，减少误报 pong 警告。
+- `plugin.ts` 已注册 checker，Runtime Tool 权限统一经 Core `canAccessTool()`；当前 Slack 入站没有可靠 sender role 时，受限工具按 fail-closed 拒绝，不会静默放行。
 
-```typescript
-import { defineConfig } from 'zhin.js'
+## 模式对比
 
-export default defineConfig({
-  endpoints: [
-    {
-      name: 'my-slack-bot',
-      context: 'slack',
-      token: 'xoxb-your-bot-token',
-      signingSecret: 'your-signing-secret',
-      appToken: 'xapp-your-app-token',
-      socketMode: true
-    }
-  ]
-})
+| 模式 | `socketMode` | 适用场景 | 额外字段 |
+|------|--------------|----------|----------|
+| **Socket Mode**（默认） | `true` | 本地/内网，无需公网 URL | `appToken`（`xapp-...`） |
+| **HTTP Events** | `false` | 生产环境有公网 HTTPS | `signingSecret` + Runtime Host |
+
+## 最小配置（Socket Mode）
+
+```yaml
+# zhin.config.yml（Plugin Runtime）
+plugins:
+  slack:
+    name: my-slack-bot
+    token: ${SLACK_BOT_TOKEN}
+    appToken: ${SLACK_APP_TOKEN}
+    socketMode: true          # 默认 true，可省略
 ```
 
-### HTTP 模式（生产环境，使用 zhin Router）
-
-HTTP 模式共享 zhin.js 内置的 Koa Router（默认端口 8086），无需额外监听端口。
-
-```typescript
-import { defineConfig } from 'zhin.js'
+## HTTP Events 配置
 
-export default defineConfig({
-  endpoints: [
-    {
-      name: 'my-slack-bot',
-      context: 'slack',
-      token: 'xoxb-your-bot-token',
-      signingSecret: 'your-signing-secret',
-      socketMode: false
-    }
-  ]
-})
+```yaml
+plugins:
+  slack:
+    name: my-slack-bot
+    token: ${SLACK_BOT_TOKEN}
+    signingSecret: ${SLACK_SIGNING_SECRET}
+    socketMode: false
+    webhookPath: /slack/events   # 可选，默认 /slack/events
 ```
 
-**HTTP 模式前置条件：**
+根插件 `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`。
 
-- Slack App 中配置 **Event Subscriptions** 的 Request URL 为 `https://your-domain:8086/slack/events`
-- 配置 **Interactivity & Shortcuts** 的 Request URL 为同一地址
-- 配置 **Slash Commands** 的 Request URL 为同一地址
-- 防火墙 / 反向代理放行端口
+## 环境变量
 
-## 功能特性
-
-- 收发文本消息
-- 富媒体（图片、文件），经 `files.uploadV2` 上传
-- 消息格式化（Slack mrkdwn + Block Kit）
-- 回复消息与线程（`thread_ts`）
-- 提及（@用户、#频道）
-- 链接与附件
-- Socket Mode 与 HTTP 模式（共享 zhin router）
-- 私信与频道消息
-- Block Kit 交互按钮（`keyboard` 片段 → 原生 Slack 按钮）
-- 斜杠命令 → zhin Command 映射
-- 消息编辑（`$editMessage` / `chat.update`）
-- Notice 事件映射（`member_joined`、`reaction_added`、`pin_added` 等）
-- Assistant API 支持（`assistant_thread_started` 事件）
-- 出站 Markdown → Slack mrkdwn 自动转换（`**粗体**` → `*粗体*`）
-- 长消息自动分段（超 2900 字符切 section；超 48 blocks 分多条发送）
-- 斜杠命令即时 ephemeral 反馈（「处理中…」）；最终回复仍 `chat.postMessage`
-- 按钮点击即时 ephemeral 反馈（「已收到」）
-- 入站 Slack mrkdwn → 通用 Markdown（粗体/斜体/删除线/代码/链接）
+| 变量 | 说明 |
+|------|------|
+| `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 名称 |
 
 ## 消息格式
 
 ### 出站（Markdown → mrkdwn）
 
-AI 或命令输出的通用 Markdown（如 `**粗体**`、`*斜体*`）会自动转换为 Slack mrkdwn，并通过 Block Kit `section` 块发送，确保在 Slack 客户端正确渲染。
-
-### 长消息
-
-- 单条 `section` 文本超过约 2900 字符时自动切分为多个 section
-- 单条消息 blocks 超过 48 个时自动拆分为多条 `chat.postMessage`
+通用 Markdown（如 `**粗体**`）会转换为 Slack mrkdwn，并通过 Block Kit `section` 发送。
 
 ### 入站（mrkdwn → Markdown）
 
-用户发送的 Slack mrkdwn 在解析为 `text` 段前会转换为通用 Markdown：
-
 | Slack mrkdwn | 通用 Markdown |
 |--------------|---------------|
 | `*bold*` | `**bold**` |
 | `_italic_` | `*italic*` |
 | `~strike~` | `~~strike~~` |
-| `` `code` `` | 保持 |
 | `<url\|text>` | `[text](url)` |
 
-`<@U>` / `<#C>` 等特殊段仍由专用解析器处理，不在此转换。该转换为启发式，复杂嵌套格式不保证完美往返。
-
-## 交互反馈
-
-### 斜杠命令
-
-收到斜杠命令后，适配器会立即向触发者发送 ephemeral「处理中…」（仅触发者可见）。命令处理完成后的最终回复仍通过 `chat.postMessage` 发送到频道，与现有 `$reply` 行为一致。
-
-### Block Kit 按钮
-
-用户点击 `block_actions` 按钮后，适配器会向点击者发送 ephemeral「已收到」。如需在线程中回复，仍通过 `sendMessage`（`thread_ts`）发送。
-
-## 创建 Slack App
-
-1. 前往 [Slack API](https://api.slack.com/apps)
-2. 创建新应用
-3. 添加 Bot Token Scopes：
-   - `chat:write` — 发送消息
-   - `chat:write.public` — 向公开频道发送消息
-   - `channels:read` — 查看频道基本信息
-   - `channels:history` — 查看频道消息历史
-   - `channels:manage` — 管理频道
-   - `groups:read` — 查看私有频道基本信息
-   - `groups:history` — 查看私有频道消息历史
-   - `im:read` — 查看私信基本信息
-   - `im:history` — 查看私信消息历史
-   - `mpim:read` — 查看群组私信基本信息
-   - `mpim:history` — 查看群组私信消息历史
-   - `users:read` — 查看用户信息
-   - `files:read` — 查看文件
-   - `files:write` — 上传文件
-   - `reactions:read` — 查看表情回应
-   - `reactions:write` — 添加/移除表情回应
-   - `pins:read` — 查看置顶项
-   - `pins:write` — 置顶/取消置顶消息
-   - `commands` — 添加斜杠命令
-   - `assistant:write` — Assistant API（若使用 AI 功能）
-4. 启用 Socket Mode（若使用 Socket Mode）：
-   - 进入 Socket Mode 设置
-   - 启用 Socket Mode
-   - 生成带 `connections:write` scope 的应用级 Token
-5. 订阅 Bot 事件：
-   - `message.channels` — 公开频道消息
-   - `message.groups` — 私有频道消息
-   - `message.im` — 私信
-   - `message.mpim` — 群组私信
-   - `app_mention` — Bot 被 @ 提及时
-   - `member_joined_channel` — 用户加入频道
-   - `member_left_channel` — 用户离开频道
-   - `reaction_added` — 添加表情回应
-   - `reaction_removed` — 移除表情回应
-   - `channel_archive` / `channel_unarchive`
-   - `channel_rename` / `channel_created` / `channel_deleted`
-   - `pin_added` / `pin_removed`
-   - `team_join` — 新用户加入工作区
-   - `assistant_thread_started`（若使用 Assistant API）
-   - `assistant_thread_context_changed`（若使用 Assistant API）
-6. 将应用安装到工作区
-7. 复制 Bot User OAuth Token（`xoxb-...`）
-8. 复制 Signing Secret
-9. 若使用 Socket Mode，复制 App-Level Token（`xapp-...`）
-
-## 使用示例
-
-### 基础消息处理
-
-```typescript
-import { usePlugin, MessageCommand } from 'zhin.js'
-
-const { addCommand } = usePlugin()
-
-addCommand(new MessageCommand('hello')
-  .action(async (message) => {
-    return 'Hello from Slack!'
-  })
-)
-```
-
-### 发送带 Block Kit 按钮的富消息
-
-```typescript
-addCommand(new MessageCommand('vote')
-  .action(async (message) => {
-    return [
-      { type: 'text', data: { text: 'What do you think?' } },
-      {
-        type: 'keyboard',
-        data: {
-          rows: [[
-            { label: 'Approve', id: 'vote_yes', style: 'primary' },
-            { label: 'Reject', id: 'vote_no', style: 'danger' },
-          ]]
-        }
-      }
-    ]
-  })
-)
-```
-
-### 在线程中回复
-
-```typescript
-addCommand(new MessageCommand('thread')
-  .action(async (message) => {
-    await message.$reply('This is a threaded reply!', true)
-  })
-)
-```
-
-### 编辑消息
-
-适配器支持 core `EditMessageOptions` 契约。`messageId` 优先使用 `channel:ts` 格式；若仅为 `ts`，则使用 `options.id` 作为 channel。
-
-```typescript
-const adapter = inject('slack')
-
-// 旧 API（薄封装，仍可用）
-await adapter.editMessage('my-slack-bot', 'C001', '1700000000.000000', [
-  { type: 'text', data: { text: 'Updated message content' } }
-])
-
-// core 契约（推荐）
-await adapter.editMessage({
-  messageId: 'C001:1700000000.000000',
-  context: 'slack',
-  endpoint: 'my-slack-bot',
-  id: 'C001',
-  type: 'group',
-  content: [{ type: 'text', data: { text: 'Updated message content' } }],
-})
-```
-
-## Slack MCP Server 集成
-
-如果你的 zhin 实例使用了 `@zhin.js/agent`（AI 功能），可以将 Slack MCP Server 配置为 AI 的工具来源：
-
-```typescript
-export default defineConfig({
-  ai: {
-    mcpServers: {
-      slack: {
-        command: 'npx',
-        args: ['-y', '@anthropic/slack-mcp-server'],
-        env: {
-          SLACK_BOT_TOKEN: 'xoxb-your-bot-token',
-          SLACK_TEAM_ID: 'T0123456789'
-        }
-      }
-    }
-  }
-})
-```
-
-这将使 AI Agent 获得搜索 Slack 消息、管理频道等额外能力。
-
-## Notice 事件映射
-
-| Slack 事件 | zhin Notice 类型 |
-|---|---|
-| `member_joined_channel` | `notice.group.member_increase` |
-| `member_left_channel` | `notice.group.member_decrease` |
-| `reaction_added` / `reaction_removed` | `notice.group.emoji_reaction` |
-| `message_deleted` | `notice.group.recall` |
-| `team_join` | `notice.friend.increase` |
-| `channel_archive` | `notice.slack.channel_archive` |
-| `pin_added` / `pin_removed` | `notice.slack.pin_added` / `notice.slack.pin_removed` |
-
 ## AI 工具
 
 | 类别 | 路径 |
 |------|------|
 | Permit 词汇 | `agent/PERMITS.md` |
-| 平台工具（11 个） | `agent/tools/`（`slack_*`：邀请、话题、反应、置顶等） |
+| 平台工具 | `agent/tools/`（邀请、话题、反应、置顶、编辑等） |
 | 技能说明 | `agent/skills/slack.md` |
-| 群管标准工具 | `createSceneManagementTools()` |
-
 
 ## 限制
 
-- 入站 mrkdwn → Markdown 为启发式转换，复杂嵌套格式不保证完美往返
-- Modals / `view_submission` / `view_closed` — 暂不支持
-- Select menus / options load — 暂不支持
-- File 事件全系列（`file_created` / `file_shared` 等）— 暂不支持
+- 入站 mrkdwn → Markdown 为启发式转换
+- Modals / Select menus — 暂不支持
 - OAuth 安装流程 — 暂不支持
+- 旧 `usePlugin` / `extends Adapter` / host-router 生产入口已删除
 
 ## 许可证
 

package/adapters/slack.ts

@@ -0,0 +1,34 @@
+/**
+ * Convention entry: discover `adapters/slack.ts` → defineAdapter.
+ */
+import { defineAdapter } from '@zhin.js/adapter';
+import { messageGatewayToken } from '@zhin.js/core/runtime';
+import { httpHostToken } from '@zhin.js/host-http';
+import { SlackEndpoint } from '../src/endpoint.js';
+import {
+  resolveSlackConfig,
+  type SlackAdapterConfig,
+} from '../src/protocol.js';
+
+export { SlackEndpoint } from '../src/endpoint.js';
+export type { SlackEndpointOptions, SlackSocketLike, SlackWebClientLike } from '../src/endpoint.js';
+
+export default defineAdapter<SlackAdapterConfig>({
+  capabilities: ['inbound', 'outbound'],
+  create(context) {
+    const config = resolveSlackConfig(context.config);
+    if (config.mode === 'http') {
+      return new SlackEndpoint({
+        id: context.id,
+        gateway: context.use(messageGatewayToken),
+        http: context.use(httpHostToken),
+        config,
+      });
+    }
+    return new SlackEndpoint({
+      id: context.id,
+      gateway: context.use(messageGatewayToken),
+      config,
+    });
+  },
+});

package/agent/tools/add_reaction.ts

@@ -1,8 +1,8 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getSlackAgentDeps } from '../../src/slack-agent-deps.js';
 
-export default defineTool<{
+export default defineAgentTool<{
   endpoint_id: string;
   channel: string;
   timestamp: string;

package/agent/tools/archive_channel.ts

@@ -1,9 +1,9 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { platformPermit } from '../../src/platform-permit.js';
 import { getSlackAgentDeps } from '../../src/slack-agent-deps.js';
 
-export default defineTool<{
+export default defineAgentTool<{
   endpoint_id: string;
   channel: string;
 }>({

package/agent/tools/edit_message.ts

@@ -1,8 +1,8 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getSlackAgentDeps } from '../../src/slack-agent-deps.js';
 
-export default defineTool<{
+export default defineAgentTool<{
   endpoint_id: string;
   channel: string;
   message_ts: string;
@@ -18,8 +18,9 @@ export default defineTool<{
   platforms: ['slack'],
   tags: ['slack'],
   async execute({ endpoint_id, channel, message_ts, text }) {
-    const { getAdapter } = getSlackAgentDeps();
-    await getAdapter().editMessage(endpoint_id, channel, message_ts, [
+    const { getEndpoint } = getSlackAgentDeps();
+    const endpoint = getEndpoint(endpoint_id);
+    await endpoint.editMessage(channel, message_ts, [
       { type: 'text', data: { text } },
     ]);
     return { success: true, message: '消息已编辑' };

package/agent/tools/invite_to_channel.ts

@@ -1,9 +1,9 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { platformPermit } from '../../src/platform-permit.js';
 import { getSlackAgentDeps } from '../../src/slack-agent-deps.js';
 
-export default defineTool<{
+export default defineAgentTool<{
   endpoint_id: string;
   channel: string;
   users: string;

package/agent/tools/pin_message.ts

@@ -1,9 +1,9 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { platformPermit } from '../../src/platform-permit.js';
 import { getSlackAgentDeps } from '../../src/slack-agent-deps.js';
 
-export default defineTool<{
+export default defineAgentTool<{
   endpoint_id: string;
   channel: string;
   timestamp: string;

package/agent/tools/remove_reaction.ts

@@ -1,8 +1,8 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getSlackAgentDeps } from '../../src/slack-agent-deps.js';
 
-export default defineTool<{
+export default defineAgentTool<{
   endpoint_id: string;
   channel_id: string;
   timestamp: string;

package/agent/tools/set_purpose.ts

@@ -1,9 +1,9 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { platformPermit } from '../../src/platform-permit.js';
 import { getSlackAgentDeps } from '../../src/slack-agent-deps.js';
 
-export default defineTool<{
+export default defineAgentTool<{
   endpoint_id: string;
   channel_id: string;
   purpose: string;

package/agent/tools/set_topic.ts

@@ -1,9 +1,9 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { platformPermit } from '../../src/platform-permit.js';
 import { getSlackAgentDeps } from '../../src/slack-agent-deps.js';
 
-export default defineTool<{
+export default defineAgentTool<{
   endpoint_id: string;
   channel: string;
   topic: string;

package/agent/tools/unarchive.ts

@@ -1,9 +1,9 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { platformPermit } from '../../src/platform-permit.js';
 import { getSlackAgentDeps } from '../../src/slack-agent-deps.js';
 
-export default defineTool<{
+export default defineAgentTool<{
   endpoint_id: string;
   channel_id: string;
 }>({

package/agent/tools/unpin_message.ts

@@ -1,9 +1,9 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { platformPermit } from '../../src/platform-permit.js';
 import { getSlackAgentDeps } from '../../src/slack-agent-deps.js';
 
-export default defineTool<{
+export default defineAgentTool<{
   endpoint_id: string;
   channel_id: string;
   timestamp: string;

package/agent/tools/user_info.ts

@@ -1,8 +1,8 @@
-import { defineTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
 import { getSlackAgentDeps } from '../../src/slack-agent-deps.js';
 
-export default defineTool<{
+export default defineAgentTool<{
   endpoint_id: string;
   user_id: string;
 }>({