@zhin.js/adapter-slack 1.1.9 → 1.1.11

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## 1.1.11
+
+### Patch Changes
+
+- 064b06d: 保留 Slack 按钮回调所属的消息线程，使回调与普通消息使用一致的完整会话身份；普通频道消息不会误用按钮源消息时间戳创建线程。
+- 9816c18: 将应用插件装配改为 configVersion: 2：主配置 plugins 映射实例名到包，disable_plugins 控制启停，业务配置使用顶层同名块。package.json 继续保留 features、entry、engine 等包契约，并支持静态 displayName/icon。
+
+  这是配置格式的破坏性更新：旧配置不能继续运行，请先停止 Bot，运行 `zhin migrate instances` 预览，再使用 `--apply` 转换；提供备份与中断继续/回滚，无法无损转换的嵌套、optional 和别名碰撞需人工迁移。Runtime、Console、CLI 与创建向导统一使用新声明。
+
+  保留框架顶层 `menuKeyword` / `menuStyle`，通过当前 generation 的 Root 配置视图供 Command Feature 消费；严格校验和配置修改不会丢失菜单设置，子实例配置保持隔离。
+
+- Updated dependencies [c407bd2]
+- Updated dependencies [064b06d]
+- Updated dependencies [2b4d6dc]
+- Updated dependencies [b58548a]
+- Updated dependencies [e914a93]
+- Updated dependencies [e914a93]
+- Updated dependencies [064b06d]
+  - @zhin.js/core@1.1.46
+  - @zhin.js/feature-kit@1.1.6
+  - @zhin.js/host-http@1.1.7
+  - @zhin.js/adapter@1.1.20
+  - @zhin.js/agent-feature@1.1.7
+  - @zhin.js/skill@1.1.7
+  - @zhin.js/tool@1.1.7
+
+## 1.1.10
+
+### Patch Changes
+
+- Updated dependencies [dd7f25f]
+  - @zhin.js/core@1.1.45
+
 ## 1.1.9
 
 ### Patch Changes

package/README.md

@@ -22,7 +22,7 @@ pnpm add @zhin.js/adapter-slack
 - `@zhin.js/core` — `Endpoint.emit(...)` 入站、`outboundMessageToken` 出站
 - `@zhin.js/host-http` — 仅 HTTP 模式需要 `httpHostToken` 注册 Events 路由
 - `zhin.js` — `plugin.ts`（`definePlugin`）
-- 配置经插件 `schema.json` 落到 `plugins.<instanceKey>`
+- 配置经插件 `schema.json` 落到顶层 `<instanceKey>`
 
 入站：`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）
@@ -47,44 +47,50 @@ pnpm add @zhin.js/adapter-slack
 ## 最小配置（Socket Mode）
 
 ```yaml
+configVersion: 2
 # zhin.config.yml（Plugin Runtime）
 plugins:
-  slack:
-    socketMode: true          # 默认 true，可省略
-    endpoints:
-      - id: my-slack-bot
-        token: ${SLACK_BOT_TOKEN}
-        appToken: ${SLACK_APP_TOKEN}
+  slack: "@zhin.js/adapter-slack"
+slack:
+  socketMode: true # 默认 true，可省略
+  endpoints:
+    - id: my-slack-bot
+      token: ${SLACK_BOT_TOKEN}
+      appToken: ${SLACK_APP_TOKEN}
 ```
 
 多 workspace：一个插件实例挂多个 endpoint（`endpoints` 数组逐项覆盖顶层字段，`id` 必填）：
 
 ```yaml
+configVersion: 2
 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}
+  slack: "@zhin.js/adapter-slack"
+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}
 ```
 
 ## HTTP Events 配置
 
 ```yaml
+configVersion: 2
 plugins:
-  slack:
-    socketMode: false
-    webhookPath: /slack/events   # 可选，默认 /slack/events
-    endpoints:
-      - id: my-slack-bot
-        token: ${SLACK_BOT_TOKEN}
-        signingSecret: ${SLACK_SIGNING_SECRET}
+  slack: "@zhin.js/adapter-slack"
+slack:
+  socketMode: false
+  webhookPath: /slack/events # 可选，默认 /slack/events
+  endpoints:
+    - id: my-slack-bot
+      token: ${SLACK_BOT_TOKEN}
+      signingSecret: ${SLACK_SIGNING_SECRET}
 ```
 
-根插件 `zhin.plugins`（或项目图）需引用 `@zhin.js/adapter-slack`（`instanceKey: slack`）。  
+主配置 `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`。
 
 ## 环境变量

package/lib/endpoint.js

@@ -207,6 +207,8 @@ export class SlackEndpoint extends Endpoint {
         const channelId = payload.channel?.id ?? '';
         const userId = payload.user.id;
         const messageTs = payload.message?.ts ?? '';
+        const sourceThread = payload.message?.thread_ts;
+        const threadTs = typeof sourceThread === 'string' && sourceThread && sourceThread !== messageTs ? sourceThread : undefined;
         if (payload.response_url) {
             postSlackEphemeral(payload.response_url, '已收到', this.#logger);
         }
@@ -215,6 +217,7 @@ export class SlackEndpoint extends Endpoint {
             channelId: channelId || userId,
             // block_actions 无 channel_type；无 channel 时按与发起用户的 DM 处理
             channelType: channelId ? undefined : 'im',
+            threadId: threadTs,
         });
         void this.emit('message.receive', {
             conversation,
@@ -226,7 +229,7 @@ export class SlackEndpoint extends Endpoint {
             metadata: Object.freeze({
                 eventType: 'block_actions',
                 actionId: payload.actions[0]?.action_id,
-                threadTs: messageTs || undefined,
+                threadTs,
             }),
         }).catch((err) => {
             this.#logger.warn(formatCompact({

package/lib/protocol.d.ts

@@ -55,6 +55,7 @@ export interface SlackInteractionPayload {
     readonly message?: {
         ts: string;
         text?: string;
+        thread_ts?: string;
         [key: string]: unknown;
     };
     readonly actions?: SlackBlockAction[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-slack",
-  "version": "1.1.9",
+  "version": "1.1.11",
   "description": "Zhin.js Slack adapter for Plugin Runtime (Socket Mode / HTTP Events)",
   "type": "module",
   "main": "./lib/index.js",
@@ -33,24 +33,24 @@
   "dependencies": {
     "@slack/socket-mode": "^2.0.7",
     "@slack/web-api": "^7.19.0",
-    "@zhin.js/adapter": "1.1.19",
-    "@zhin.js/agent-feature": "1.1.6",
-    "@zhin.js/core": "1.1.44",
-    "@zhin.js/feature-kit": "1.1.5",
-    "@zhin.js/host-http": "1.1.6",
+    "@zhin.js/adapter": "1.1.20",
+    "@zhin.js/agent-feature": "1.1.7",
+    "@zhin.js/core": "1.1.46",
+    "@zhin.js/feature-kit": "1.1.6",
+    "@zhin.js/host-http": "1.1.7",
     "@zhin.js/im-contract": "1.1.4",
     "@zhin.js/logger": "1.1.2",
-    "@zhin.js/skill": "1.1.6",
-    "@zhin.js/tool": "1.1.6"
+    "@zhin.js/skill": "1.1.7",
+    "@zhin.js/tool": "1.1.7"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.19",
-    "@zhin.js/command": "^1.1.7",
-    "@zhin.js/core": "^1.1.44",
-    "@zhin.js/host-http": "^1.1.6",
-    "@zhin.js/permission": "^1.1.6",
-    "zhin.js": "^1.1.9"
+    "@zhin.js/adapter": "^1.1.20",
+    "@zhin.js/command": "^1.1.8",
+    "@zhin.js/core": "^1.1.46",
+    "@zhin.js/host-http": "^1.1.7",
+    "@zhin.js/permission": "^1.1.7",
+    "zhin.js": "^1.1.11"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {
@@ -68,7 +68,7 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "zhin.js": "1.1.9"
+    "zhin.js": "1.1.11"
   },
   "files": [
     "adapters",

package/src/endpoint.ts

@@ -298,6 +298,8 @@ export class SlackEndpoint extends Endpoint<SlackWebClientLike> implements Slack
     const channelId = payload.channel?.id ?? '';
     const userId = payload.user.id;
     const messageTs = payload.message?.ts ?? '';
+    const sourceThread = payload.message?.thread_ts;
+    const threadTs = typeof sourceThread === 'string' && sourceThread && sourceThread !== messageTs ? sourceThread : undefined;
     if (payload.response_url) {
       postSlackEphemeral(payload.response_url, '已收到', this.#logger);
     }
@@ -306,6 +308,7 @@ export class SlackEndpoint extends Endpoint<SlackWebClientLike> implements Slack
       channelId: channelId || userId,
       // block_actions 无 channel_type；无 channel 时按与发起用户的 DM 处理
       channelType: channelId ? undefined : 'im',
+      threadId: threadTs,
     });
     void this.emit('message.receive', {
       conversation,
@@ -317,7 +320,7 @@ export class SlackEndpoint extends Endpoint<SlackWebClientLike> implements Slack
       metadata: Object.freeze({
         eventType: 'block_actions',
         actionId: payload.actions[0]?.action_id,
-        threadTs: messageTs || undefined,
+        threadTs,
       }),
     }).catch((err) => {
       this.#logger.warn(formatCompact({

package/src/protocol.ts

@@ -66,7 +66,7 @@ export interface SlackInteractionPayload {
   readonly trigger_id?: string;
   readonly user: { id: string; username?: string; name?: string; team_id?: string };
   readonly channel?: { id: string; name?: string };
-  readonly message?: { ts: string; text?: string; [key: string]: unknown };
+  readonly message?: { ts: string; text?: string; thread_ts?: string; [key: string]: unknown };
   readonly actions?: SlackBlockAction[];
   readonly response_url?: string;
   readonly [key: string]: unknown;