@zhin.js/adapter-slack 6.0.2 → 6.0.5

package/CHANGELOG.md

@@ -1,5 +1,100 @@
 # Changelog
 
+## 6.0.5
+
+### Patch Changes
+
+- 51015d6: refactor(adapters): migrate platform-permit to PermissionSubject
+
+  All adapter platform-permit checkers now accept PermissionSubject
+  (duck-typed from Message/CommandSession) instead of Message directly.
+  registerPlatformPermitChecker is replaced by host.registerPlatform in
+  the adapter plugin setup. activity-feedback service updated for new
+  PermissionHost integration.
+
+- Updated dependencies [6f9c366]
+- Updated dependencies [373a56b]
+- Updated dependencies [0de46a8]
+- Updated dependencies [c106ecc]
+- Updated dependencies [ca92e03]
+- Updated dependencies [b0f37ae]
+- Updated dependencies [ba08a2f]
+- Updated dependencies [b08f7fe]
+- Updated dependencies [daffd4c]
+- Updated dependencies [36c7400]
+- Updated dependencies [a9fa72e]
+- Updated dependencies [c8de3ef]
+- Updated dependencies [60f0fc8]
+- Updated dependencies [574c990]
+- Updated dependencies [d096f16]
+- Updated dependencies [3f29623]
+- Updated dependencies [2916852]
+- Updated dependencies [d047869]
+- Updated dependencies [162fa34]
+- Updated dependencies [e62561e]
+- Updated dependencies [3eeeb46]
+- Updated dependencies [85d0f82]
+- Updated dependencies [61bfc1c]
+- Updated dependencies [04bad47]
+- Updated dependencies [e40b048]
+- Updated dependencies [5a5b1bb]
+- Updated dependencies [f1708c3]
+- Updated dependencies [d254a81]
+- Updated dependencies [7123c47]
+- Updated dependencies [05befc1]
+- Updated dependencies [0663b6a]
+- Updated dependencies [f28f9b3]
+- Updated dependencies [9f340f7]
+- Updated dependencies [e53444f]
+- Updated dependencies [5eedd26]
+- Updated dependencies [92b0dd7]
+- Updated dependencies [f919b6f]
+- Updated dependencies [098e411]
+- Updated dependencies [e1b7c01]
+- Updated dependencies [9b94f87]
+- Updated dependencies [a7df753]
+  - @zhin.js/agent@1.1.5
+  - @zhin.js/host-http@1.0.8
+  - @zhin.js/permission@1.0.1
+  - @zhin.js/im-contract@1.0.3
+  - @zhin.js/adapter@1.1.7
+  - @zhin.js/plugin-runtime@1.1.5
+  - @zhin.js/command@1.0.9
+  - @zhin.js/core@1.5.4
+  - zhin.js@6.0.4
+
+## 6.0.4
+
+### Patch Changes
+
+- f8c7a54: fix: im
+- Updated dependencies [f8c7a54]
+  - @zhin.js/logger@1.0.76
+  - @zhin.js/host-http@1.0.7
+  - @zhin.js/adapter@1.1.6
+  - @zhin.js/agent@1.1.4
+  - @zhin.js/command@1.0.8
+  - @zhin.js/core@1.5.3
+  - @zhin.js/im-contract@1.0.2
+  - @zhin.js/plugin-runtime@1.1.4
+  - zhin.js@6.0.3
+
+## 6.0.3
+
+### Patch Changes
+
+- Updated dependencies [afc0e66]
+- Updated dependencies [2e41ad5]
+- Updated dependencies [9f57124]
+  - @zhin.js/core@1.5.2
+  - @zhin.js/adapter@1.1.5
+  - @zhin.js/im-contract@1.0.1
+  - @zhin.js/plugin-runtime@1.1.3
+  - @zhin.js/command@1.0.7
+  - @zhin.js/host-http@1.0.6
+  - @zhin.js/agent@1.1.3
+  - zhin.js@6.0.2
+
 ## 6.0.2
 
 ### Patch Changes

package/README.md

@@ -6,7 +6,7 @@ Zhin.js Slack 适配器（Plugin Runtime），优先 Socket Mode，也可经 Run
 
 - **Socket Mode**（默认）：WebSocket 长连接，无需公网 URL
 - **HTTP Events API**：`httpHostToken` POST（签名验证），**非** legacy host-router/Koa
-- 入站经 `messageGatewayToken`；出站 `send({ target, payload })` → `chat.postMessage` / Block Kit
+- 入站经 `messageGatewayToken`；出站 `send({ conversation, payload })` → `chat.postMessage` / Block Kit
 - 约定式 `defineAdapter` / `definePlugin`（无需 `usePlugin`）
 - Block Kit 按钮、斜杠命令、消息编辑、表情反应等（见 `agent/tools/`）
 
@@ -24,8 +24,8 @@ pnpm add @zhin.js/adapter-slack
 - `@zhin.js/plugin-runtime` — `plugin.ts`（`definePlugin`）
 - 配置经插件 `schema.json` 落到 `plugins.<instanceKey>`
 
-入站：`gateway.receive({ adapter, target: channelId, content: text, sender, metadata })`  
-出站：`send({ target, payload })` → Web API（`target` 可为 `channel` 或 `channel:thread_ts`）
+入站：`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）
 

package/adapters/slack.js

@@ -21,8 +21,8 @@ export default defineAdapter({
     create(context) {
         const config = resolveSlackConfig(context.config);
         // 注册到插件运行时状态（slack.endpoint list 的"运行中"数据源）
-        context.use(slackRuntimeStateToken).endpoints.set(config.name, {
-            name: config.name,
+        context.use(slackRuntimeStateToken).endpoints.set(config.id, {
+            id: config.id,
             mode: config.mode,
         });
         if (config.mode === 'http') {

package/adapters/slack.ts

@@ -26,8 +26,8 @@ export default defineAdapter<SlackAdapterConfig>({
   create(context) {
     const config = resolveSlackConfig(context.config);
     // 注册到插件运行时状态（slack.endpoint list 的"运行中"数据源）
-    context.use(slackRuntimeStateToken).endpoints.set(config.name, {
-      name: config.name,
+    context.use(slackRuntimeStateToken).endpoints.set(config.id, {
+      id: config.id,
       mode: config.mode,
     });
     if (config.mode === 'http') {

package/agent/tools/user_info.ts

@@ -17,6 +17,7 @@ export default defineAgentTool<{
     const { getEndpoint } = getSlackAgentDeps();
     const endpoint = getEndpoint(endpoint_id);
     const user = await endpoint.getUserInfo(user_id);
+    if (!user) throw new Error(`Slack 用户不存在: ${user_id}`);
     return {
       id: user.id,
       name: user.name,

package/lib/endpoint.d.ts

@@ -1,8 +1,9 @@
-import type { EndpointInstance, EndpointManagement } from '@zhin.js/adapter';
+import type { EndpointInstance, EndpointManagement, EndpointSendRequest } from '@zhin.js/adapter';
 import type { MessageGateway } from '@zhin.js/core/runtime';
 import type { HttpHost } from '@zhin.js/host-http';
 import type { CapabilityId } from '@zhin.js/plugin-runtime';
 import { type ResolvedSlackConfig, type SlackEvent, type SlackInteractionPayload, type SlackMessageEvent, type SlackSlashCommand } from './protocol.js';
+import { type SlackUserInfo } from './slack-agent-deps.js';
 import { type SlackChatClient } from './slack-outbound.js';
 import { type SlackWebhookHandler } from './webhook.js';
 export interface SlackSocketLike {
@@ -138,10 +139,7 @@ export declare class SlackEndpoint implements EndpointInstance, SlackWebhookHand
     open(): void;
     close(): void;
     stop(): Promise<void>;
-    send({ target, payload }: {
-        readonly target: string;
-        readonly payload: unknown;
-    }): Promise<string>;
+    send({ conversation, payload }: EndpointSendRequest): Promise<string>;
     /** Test / internal: admit a message event when open. */
     admit(event: SlackMessageEvent | SlackEvent): void;
     admitInteraction(payload: SlackInteractionPayload): void;
@@ -163,7 +161,7 @@ export declare class SlackEndpoint implements EndpointInstance, SlackWebhookHand
     renameChannel(channel: string, name: string): Promise<boolean>;
     getChannelMembers(channel: string): Promise<string[]>;
     getChannelInfo(channel: string): Promise<unknown>;
-    getUserInfo(user: string): Promise<unknown>;
+    getUserInfo(user: string): Promise<SlackUserInfo | undefined>;
     addReaction(channel: string, timestamp: string, name: string): Promise<boolean>;
     removeReaction(channel: string, timestamp: string, name: string): Promise<boolean>;
     pinMessage(channel: string, timestamp: string): Promise<boolean>;

package/lib/endpoint.js

@@ -3,8 +3,8 @@
  */
 import { SocketModeClient } from '@slack/socket-mode';
 import { WebClient } from '@slack/web-api';
-import { formatCompact, getLogger } from '@zhin.js/logger';
-import { formatInboundContent, formatInteractionContent, formatSlashContent, inboundMessageId, resolveSlackChannelType, } from './protocol.js';
+import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
+import { formatInboundContent, formatInteractionContent, formatSlashContent, resolveSlackChannelType, slackInboundConversation, } from './protocol.js';
 import { registerSlackAgentEndpoint } from './slack-agent-deps.js';
 import { createSlackInboundFilterState, shouldDropSlackInboundMessage, } from './slack-inbound-filter.js';
 import { formatSlackMessageRef, parseSlackMessageRef } from './slack-message-ref.js';
@@ -12,8 +12,8 @@ import { normalizeSlackReactionName } from './slack-reaction.js';
 import { postSlackEphemeral } from './slack-response-url.js';
 import { editSlackContent, sendSlackContent } from './slack-outbound.js';
 import { registerSlackWebhookRoutes } from './webhook.js';
-const logger = getLogger('slack');
 export class SlackEndpoint {
+    #logger;
     #options;
     #inboundFilter = createSlackInboundFilterState();
     #messageChannelMap = new Map();
@@ -26,11 +26,12 @@ export class SlackEndpoint {
     #unregisterAgent;
     management = createSlackEndpointManagement(this);
     constructor(options) {
+        this.#logger = getAdapterLogger('slack', options.config.id);
         this.#options = options;
     }
     /** Console 展示 / AdapterIndex live name（多 endpoint 时与 entry name 一致）。 */
     get name() {
-        return this.#options.config.name;
+        return this.#options.config.id;
     }
     get client() {
         return this.#client;
@@ -49,7 +50,7 @@ export class SlackEndpoint {
             const { config } = this.#options;
             this.#client = this.#options.createClient?.(config.token)
                 ?? new WebClient(config.token);
-            this.#unregisterAgent = registerSlackAgentEndpoint(config.name, this);
+            this.#unregisterAgent = registerSlackAgentEndpoint(config.id, this);
             if (config.mode === 'socket') {
                 await this.#startSocket();
             }
@@ -59,8 +60,8 @@ export class SlackEndpoint {
                     throw new Error('Slack HTTP Events API requires httpHostToken (Runtime Host)');
                 }
                 this.#routeReleases.push(...registerSlackWebhookRoutes(http, this));
-                logger.debug(formatCompact({
-                    endpoint: config.name,
+                this.#logger.debug(formatCompact({
+                    endpoint: config.id,
                     op: 'webhook',
                     path: config.webhookPath,
                 }));
@@ -68,16 +69,12 @@ export class SlackEndpoint {
             const authTest = await this.#client.auth.test();
             if (authTest.user_id)
                 this.#botUserId = String(authTest.user_id);
-            logger.info(formatCompact({
-                op: 'connect',
-                endpoint: config.name,
-                mode: config.mode,
-                platform_user_id: this.#botUserId,
-            }));
+            this.#logger.info(`connected (${config.mode})`
+                + (this.#botUserId ? ` | user: ${this.#botUserId}` : ''));
         }
         catch (error) {
             await this.stop();
-            logger.error('Failed to connect Slack endpoint:', error);
+            this.#logger.error('Failed to connect Slack endpoint:', error);
             throw error;
         }
     }
@@ -104,13 +101,14 @@ export class SlackEndpoint {
         this.#unregisterAgent = undefined;
         this.#client = undefined;
         this.#started = false;
-        logger.debug(formatCompact({ op: 'disconnect', endpoint: this.#options.config.name }));
+        this.#logger.debug(formatCompact({ op: 'disconnect' }));
     }
-    async send({ target, payload }) {
+    async send({ conversation, payload }) {
         if (!this.#client)
             throw new Error('Slack client not connected');
-        const { channel, threadTs } = parseSendTarget(target);
-        const result = await sendSlackContent(this.#client, payload, { channel, threadTs }, logger);
+        const channel = conversation.id;
+        const threadTs = conversation.threadId;
+        const result = await sendSlackContent(this.#client, payload, { channel, threadTs }, this.#logger);
         if (result.ts)
             this.trackMessageChannel(result.ts, channel);
         return formatSlackMessageRef(channel, result.ts || String(Date.now()));
@@ -127,25 +125,29 @@ export class SlackEndpoint {
         if (!msg.channel || !msg.ts)
             return;
         this.trackMessageChannel(msg.ts, msg.channel);
+        const threadTs = msg.thread_ts && msg.thread_ts !== msg.ts ? msg.thread_ts : undefined;
+        const conversation = slackInboundConversation(String(this.#options.id), {
+            channelId: msg.channel,
+            channelType: msg.channel_type,
+            threadId: threadTs,
+        });
         void this.#options.gateway.receive({
-            adapter: this.#options.id,
-            target: msg.channel,
+            conversation,
+            message: { conversation, id: msg.ts },
             content: formatInboundContent(msg),
-            sender: msg.user ?? msg.channel,
-            id: inboundMessageId(msg),
+            sender: { id: msg.user ?? msg.channel ?? '' },
+            endpointId: this.#options.config.id,
+            ...(msg.type === 'app_mention' ? { mentioned: true } : {}),
             metadata: Object.freeze({
-                endpoint: this.#options.config.name,
                 channelType: resolveSlackChannelType(msg),
                 userId: msg.user,
-                threadTs: msg.thread_ts && msg.thread_ts !== msg.ts ? msg.thread_ts : undefined,
+                threadTs,
                 ts: msg.ts,
-                // app_mention 事件本身即 @ 机器人；新 Runtime 纯文本 content 需经 metadata 传递
-                ...(msg.type === 'app_mention' ? { mentioned: true } : {}),
             }),
         }).catch((err) => {
-            logger.warn(formatCompact({
+            this.#logger.warn(formatCompact({
                 op: 'slack_gateway_receive_failed',
-                target: msg.channel,
+                target: `${conversation.kind}:${conversation.id}`,
                 error: err instanceof Error ? err.message : String(err),
             }));
         });
@@ -159,24 +161,29 @@ export class SlackEndpoint {
         const userId = payload.user.id;
         const messageTs = payload.message?.ts ?? '';
         if (payload.response_url) {
-            postSlackEphemeral(payload.response_url, '已收到', logger);
+            postSlackEphemeral(payload.response_url, '已收到', this.#logger);
         }
+        const actionTs = payload.actions[0]?.action_ts ?? messageTs ?? `action-${Date.now()}`;
+        const conversation = slackInboundConversation(String(this.#options.id), {
+            channelId: channelId || userId,
+            // block_actions 无 channel_type；无 channel 时按与发起用户的 DM 处理
+            channelType: channelId ? undefined : 'im',
+        });
         void this.#options.gateway.receive({
-            adapter: this.#options.id,
-            target: channelId || userId,
+            conversation,
+            message: { conversation, id: actionTs },
             content: formatInteractionContent(payload),
-            sender: userId,
-            id: payload.actions[0]?.action_ts ?? messageTs ?? `action-${Date.now()}`,
+            sender: { id: userId },
+            endpointId: this.#options.config.id,
             metadata: Object.freeze({
-                endpoint: this.#options.config.name,
                 eventType: 'block_actions',
                 actionId: payload.actions[0]?.action_id,
                 threadTs: messageTs || undefined,
             }),
         }).catch((err) => {
-            logger.warn(formatCompact({
+            this.#logger.warn(formatCompact({
                 op: 'slack_gateway_receive_failed',
-                target: channelId,
+                target: `${conversation.kind}:${conversation.id}`,
                 error: err instanceof Error ? err.message : String(err),
             }));
         });
@@ -184,22 +191,24 @@ export class SlackEndpoint {
     admitSlashCommand(cmd) {
         if (!this.#open)
             return;
-        postSlackEphemeral(cmd.response_url, '处理中…', logger);
+        postSlackEphemeral(cmd.response_url, '处理中…', this.#logger);
+        const conversation = slackInboundConversation(String(this.#options.id), {
+            channelId: cmd.channel_id,
+        });
         void this.#options.gateway.receive({
-            adapter: this.#options.id,
-            target: cmd.channel_id,
+            conversation,
+            message: { conversation, id: cmd.trigger_id },
             content: formatSlashContent(cmd),
-            sender: cmd.user_id,
-            id: cmd.trigger_id,
+            sender: { id: cmd.user_id, name: cmd.user_name },
+            endpointId: this.#options.config.id,
             metadata: Object.freeze({
-                endpoint: this.#options.config.name,
                 eventType: 'slash_command',
                 command: cmd.command,
             }),
         }).catch((err) => {
-            logger.warn(formatCompact({
+            this.#logger.warn(formatCompact({
                 op: 'slack_gateway_receive_failed',
-                target: cmd.channel_id,
+                target: `${conversation.kind}:${conversation.id}`,
                 error: err instanceof Error ? err.message : String(err),
             }));
         });
@@ -352,13 +361,6 @@ export class SlackEndpoint {
         await this.#socket.start();
     }
 }
-function parseSendTarget(target) {
-    const parsed = parseSlackMessageRef(target);
-    if (parsed && /^\d+\.\d+$/.test(parsed.ts)) {
-        return { channel: parsed.channel, threadTs: parsed.ts };
-    }
-    return { channel: target };
-}
 /** Slack Web API 分页上限（每页 1000，cursor 翻页直到 next_cursor 为空）。 */
 const SLACK_LIST_PAGE_SIZE = 1000;
 function createSlackEndpointManagement(endpoint) {

package/lib/index.d.ts

@@ -1,9 +1,8 @@
-export { formatInboundContent, formatInteractionContent, formatOutboundWire, formatSlashContent, headerValue, inboundMessageId, keyboardToBlockKitBlocks, normalizeWebhookPath, readTextBody, resolveSlackChannelType, resolveSlackConfig, verifySlackSignature, type ResolvedSlackConfig, type SlackAdapterConfig, type SlackBlockAction, type SlackEvent, type SlackEventEnvelope, type SlackInteractionPayload, type SlackMessageEvent, type SlackSlashCommand, type SlackUrlVerification, type SlackWireSegment, } from './protocol.js';
+export { formatInboundContent, formatInteractionContent, formatOutboundWire, formatSlashContent, headerValue, keyboardToBlockKitBlocks, normalizeWebhookPath, readTextBody, resolveSlackChannelType, resolveSlackConfig, slackInboundConversation, verifySlackSignature, type ResolvedSlackConfig, type SlackAdapterConfig, type SlackBlockAction, type SlackEvent, type SlackEventEnvelope, type SlackInteractionPayload, type SlackMessageEvent, type SlackSlashCommand, type SlackUrlVerification, type SlackWireSegment, } from './protocol.js';
 export { SlackEndpoint, type SlackEndpointOptions, type SlackSocketLike, type SlackWebClientLike, } from './endpoint.js';
 export { registerSlackWebhookRoutes, handleSlackWebhookRequest, type SlackWebhookHandler, } from './webhook.js';
 export { getSlackAgentDeps, registerSlackAgentEndpoint, setSlackAgentDeps, type SlackAgentDeps, type SlackAgentEndpoint, } from './slack-agent-deps.js';
-export { checkSlackPlatformPermit, normalizeSlackSenderForPermit, platformPermit, registerSlackPlatformPermitChecker, slackGroupPermitResolver, } from './platform-permit.js';
-export { formatSlackMessageRef, parseSlackMessageRef, slackMessageTs, } from './slack-message-ref.js';
+export { checkSlackPlatformPermit, normalizeSlackSenderForPermit, platformPermit, slackGroupPermitResolver, } from './platform-permit.js';
 export { normalizeSlackReactionName } from './slack-reaction.js';
 export { markdownToMrkdwn, mrkdwnToPlainFallback, splitMrkdwnText } from './markdown-to-mrkdwn.js';
 export { mrkdwnToMarkdown } from './mrkdwn-to-markdown.js';

package/lib/index.js

@@ -1,9 +1,8 @@
-export { formatInboundContent, formatInteractionContent, formatOutboundWire, formatSlashContent, headerValue, inboundMessageId, keyboardToBlockKitBlocks, normalizeWebhookPath, readTextBody, resolveSlackChannelType, resolveSlackConfig, verifySlackSignature, } from './protocol.js';
+export { formatInboundContent, formatInteractionContent, formatOutboundWire, formatSlashContent, headerValue, keyboardToBlockKitBlocks, normalizeWebhookPath, readTextBody, resolveSlackChannelType, resolveSlackConfig, slackInboundConversation, verifySlackSignature, } from './protocol.js';
 export { SlackEndpoint, } from './endpoint.js';
 export { registerSlackWebhookRoutes, handleSlackWebhookRequest, } from './webhook.js';
 export { getSlackAgentDeps, registerSlackAgentEndpoint, setSlackAgentDeps, } from './slack-agent-deps.js';
-export { checkSlackPlatformPermit, normalizeSlackSenderForPermit, platformPermit, registerSlackPlatformPermitChecker, slackGroupPermitResolver, } from './platform-permit.js';
-export { formatSlackMessageRef, parseSlackMessageRef, slackMessageTs, } from './slack-message-ref.js';
+export { checkSlackPlatformPermit, normalizeSlackSenderForPermit, platformPermit, slackGroupPermitResolver, } from './platform-permit.js';
 export { normalizeSlackReactionName } from './slack-reaction.js';
 export { markdownToMrkdwn, mrkdwnToPlainFallback, splitMrkdwnText } from './markdown-to-mrkdwn.js';
 export { mrkdwnToMarkdown } from './mrkdwn-to-markdown.js';

package/lib/platform-permit.d.ts

@@ -1,7 +1,7 @@
 /**
  * Slack platform permit — workspace + channel 权限
  */
-import { type Message } from '@zhin.js/core';
+import type { PermissionSubject } from '@zhin.js/permission';
 export declare function platformPermit(perm: string): string;
 export declare function slackGroupPermitResolver(logicalPerm: string): string;
 export declare function normalizeSlackSenderForPermit(input: {
@@ -12,5 +12,4 @@ export declare function normalizeSlackSenderForPermit(input: {
     role?: string;
     permissions?: string[];
 };
-export declare function checkSlackPlatformPermit(perm: string, message: Message<any>): boolean;
-export declare function registerSlackPlatformPermitChecker(): () => void;
+export declare function checkSlackPlatformPermit(perm: string, subject: PermissionSubject): boolean;

package/lib/platform-permit.js

@@ -1,7 +1,3 @@
-/**
- * Slack platform permit — workspace + channel 权限
- */
-import { registerPlatformPermitChecker } from '@zhin.js/core';
 const ADAPTER = 'slack';
 export function platformPermit(perm) {
     return `platform(${ADAPTER},${perm})`;
@@ -29,10 +25,9 @@ export function normalizeSlackSenderForPermit(input) {
     }
     return { role: 'member', permissions };
 }
-export function checkSlackPlatformPermit(perm, message) {
-    const sender = message.$sender;
-    const permissions = sender.permissions ?? [];
-    const role = sender.role;
+export function checkSlackPlatformPermit(perm, subject) {
+    const role = subject.sender?.role?.[0];
+    const permissions = subject.sender?.permissions ?? [];
     const has = (t) => permissions.includes(t);
     switch (perm) {
         case 'workspace_owner':
@@ -46,6 +41,3 @@ export function checkSlackPlatformPermit(perm, message) {
             return false;
     }
 }
-export function registerSlackPlatformPermitChecker() {
-    return registerPlatformPermitChecker(ADAPTER, checkSlackPlatformPermit);
-}

package/lib/protocol.d.ts

@@ -1,7 +1,8 @@
 import type { IncomingMessage } from 'node:http';
+import type { ConversationRef } from '@zhin.js/im-contract';
 /** Plugin Runtime owner config (`plugins.<instanceKey>` / schema.json). */
 export interface SlackAdapterConfig {
-    readonly name?: string;
+    readonly id?: string;
     readonly token?: string;
     readonly signingSecret?: string;
     readonly appToken?: string;
@@ -21,7 +22,7 @@ export interface SlackAdapterConfig {
 }
 export interface ResolvedSlackConfig {
     readonly context: 'slack';
-    readonly name: string;
+    readonly id: string;
     readonly token: string;
     readonly mode: 'socket' | 'http';
     readonly signingSecret: string;
@@ -115,11 +116,20 @@ export interface SlackWireSegment {
 export declare function resolveSlackConfig(config?: SlackAdapterConfig): ResolvedSlackConfig;
 export declare function normalizeWebhookPath(path: string): string;
 export declare function resolveSlackChannelType(event: Pick<SlackEvent, 'channel_type'>): 'private' | 'group';
+/**
+ * 入站归一化 → ConversationRef：channel_type `im` → private，其余（channel/group/mpim）
+ * → group；交互/斜杠命令无 channel_type 时按平台 id 前缀推断（D* 为 DM）。Slack 无
+ * guild 容器概念（team 为 workspace 级，不进 parent）；线程根 ts 进 `threadId`。
+ */
+export declare function slackInboundConversation(endpointKey: string, opts: {
+    readonly channelId: string;
+    readonly channelType?: string;
+    readonly threadId?: string;
+}): ConversationRef;
 /** Build inbound text for MessageGateway.receive. */
 export declare function formatInboundContent(event: SlackMessageEvent | SlackEvent): string;
 export declare function formatInteractionContent(payload: SlackInteractionPayload): string;
 export declare function formatSlashContent(cmd: SlackSlashCommand): string;
-export declare function inboundMessageId(event: SlackMessageEvent): string;
 /**
  * Wire-encode an already-rendered outbound payload into Slack text + Block Kit blocks.
  * Segment canonicalization is intentionally not done here.

package/lib/protocol.js

@@ -22,8 +22,8 @@ export function resolveSlackConfig(config = {}) {
     if (!token) {
         throw new TypeError('Slack adapter requires token (plugins.<key>.token or endpoints with context: slack)');
     }
-    const name = (typeof config.name === 'string' && config.name)
-        || (typeof entry?.name === 'string' && entry.name)
+    const id = (typeof config.id === 'string' && config.id)
+        || (typeof entry?.id === 'string' && entry.id)
         || process.env.SLACK_BOT_NAME
         || 'slack-bot';
     const socketMode = config.socketMode ?? entry?.socketMode;
@@ -45,7 +45,7 @@ export function resolveSlackConfig(config = {}) {
     }
     return {
         context: 'slack',
-        name,
+        id,
         token,
         mode,
         signingSecret,
@@ -63,6 +63,22 @@ export function normalizeWebhookPath(path) {
 export function resolveSlackChannelType(event) {
     return event.channel_type === 'im' ? 'private' : 'group';
 }
+/**
+ * 入站归一化 → ConversationRef：channel_type `im` → private，其余（channel/group/mpim）
+ * → group；交互/斜杠命令无 channel_type 时按平台 id 前缀推断（D* 为 DM）。Slack 无
+ * guild 容器概念（team 为 workspace 级，不进 parent）；线程根 ts 进 `threadId`。
+ */
+export function slackInboundConversation(endpointKey, opts) {
+    const kind = opts.channelType != null
+        ? (opts.channelType === 'im' ? 'private' : 'group')
+        : (opts.channelId.startsWith('D') ? 'private' : 'group');
+    return {
+        endpoint: { id: endpointKey, adapter: endpointKey.split('\0')[0] ?? endpointKey },
+        kind,
+        id: opts.channelId,
+        ...(opts.threadId ? { threadId: opts.threadId } : {}),
+    };
+}
 /** Build inbound text for MessageGateway.receive. */
 export function formatInboundContent(event) {
     const text = typeof event.text === 'string' ? event.text : '';
@@ -83,9 +99,6 @@ export function formatInteractionContent(payload) {
 export function formatSlashContent(cmd) {
     return `${cmd.command} ${cmd.text}`.trim();
 }
-export function inboundMessageId(event) {
-    return `${event.channel}:${event.ts}`;
-}
 /**
  * Wire-encode an already-rendered outbound payload into Slack text + Block Kit blocks.
  * Segment canonicalization is intentionally not done here.

package/lib/slack-agent-deps.d.ts

@@ -12,17 +12,30 @@ export interface SlackAgentEndpoint {
     renameChannel(channel: string, name: string): Promise<boolean>;
     getChannelMembers(channel: string): Promise<string[]>;
     getChannelInfo(channel: string): Promise<unknown>;
-    getUserInfo(user: string): Promise<unknown>;
+    getUserInfo(user: string): Promise<SlackUserInfo | undefined>;
     addReaction(channel: string, timestamp: string, name: string): Promise<boolean>;
     removeReaction(channel: string, timestamp: string, name: string): Promise<boolean>;
     pinMessage(channel: string, timestamp: string): Promise<boolean>;
     unpinMessage(channel: string, timestamp: string): Promise<boolean>;
     editMessage(channel: string, messageTs: string, content: unknown): Promise<void>;
 }
+/** Slack users.info 返回的用户对象（SDK 响应字段对 agent 工具的投影）。 */
+export interface SlackUserInfo {
+    id?: string;
+    name?: string;
+    real_name?: string;
+    is_admin?: boolean;
+    is_bot?: boolean;
+    profile?: {
+        display_name?: string;
+        email?: string;
+        status_text?: string;
+    };
+}
 export interface SlackAgentDeps {
-    getEndpoint: (endpointId: string) => SlackAgentEndpoint;
+    getEndpoint: (endpointKey: string) => SlackAgentEndpoint;
 }
-export declare function registerSlackAgentEndpoint(endpointId: string, endpoint: SlackAgentEndpoint): () => void;
+export declare function registerSlackAgentEndpoint(endpointKey: string, endpoint: SlackAgentEndpoint): () => void;
 /** Optional override used by tests / transitional callers. Pass `null` to clear. */
 export declare function setSlackAgentDeps(deps: SlackAgentDeps | null): void;
 export declare function getSlackAgentDeps(): SlackAgentDeps;

package/lib/slack-agent-deps.js

@@ -4,11 +4,11 @@
  */
 const endpoints = new Map();
 let override = null;
-export function registerSlackAgentEndpoint(endpointId, endpoint) {
-    endpoints.set(endpointId, endpoint);
+export function registerSlackAgentEndpoint(endpointKey, endpoint) {
+    endpoints.set(endpointKey, endpoint);
     return () => {
-        if (endpoints.get(endpointId) === endpoint) {
-            endpoints.delete(endpointId);
+        if (endpoints.get(endpointKey) === endpoint) {
+            endpoints.delete(endpointKey);
         }
     };
 }
@@ -20,10 +20,10 @@ export function getSlackAgentDeps() {
     if (override)
         return override;
     return {
-        getEndpoint(endpointId) {
-            const registered = endpoints.get(endpointId);
+        getEndpoint(endpointKey) {
+            const registered = endpoints.get(endpointKey);
             if (!registered)
-                throw new Error(`Endpoint ${endpointId} 不存在`);
+                throw new Error(`Endpoint ${endpointKey} 不存在`);
             return registered;
         },
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-slack",
-  "version": "6.0.2",
+  "version": "6.0.5",
   "description": "Zhin.js Slack adapter for Plugin Runtime (Socket Mode / HTTP Events)",
   "type": "module",
   "main": "./lib/index.js",
@@ -34,21 +34,23 @@
   "dependencies": {
     "@slack/socket-mode": "^2.0.7",
     "@slack/web-api": "^7.19.0",
-    "@zhin.js/adapter": "1.1.4",
-    "@zhin.js/command": "1.0.6",
-    "@zhin.js/core": "1.5.1",
-    "@zhin.js/host-http": "1.0.5",
-    "@zhin.js/logger": "1.0.75",
-    "@zhin.js/plugin-runtime": "1.1.2"
+    "@zhin.js/adapter": "1.1.7",
+    "@zhin.js/command": "1.0.9",
+    "@zhin.js/core": "1.5.4",
+    "@zhin.js/host-http": "1.0.8",
+    "@zhin.js/im-contract": "1.0.3",
+    "@zhin.js/logger": "1.0.76",
+    "@zhin.js/plugin-runtime": "1.1.5"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "1.1.4",
-    "@zhin.js/agent": "1.1.2",
-    "@zhin.js/core": "1.5.1",
-    "@zhin.js/host-http": "1.0.5",
-    "@zhin.js/plugin-runtime": "1.1.2",
-    "zhin.js": "6.0.1"
+    "@zhin.js/adapter": "1.1.7",
+    "@zhin.js/agent": "1.1.5",
+    "@zhin.js/core": "1.5.4",
+    "@zhin.js/host-http": "1.0.8",
+    "@zhin.js/permission": "1.0.1",
+    "@zhin.js/plugin-runtime": "1.1.5",
+    "zhin.js": "6.0.4"
   },
   "peerDependenciesMeta": {
     "zhin.js": {
@@ -66,8 +68,8 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/agent": "1.1.2",
-    "zhin.js": "6.0.1"
+    "@zhin.js/agent": "1.1.5",
+    "zhin.js": "6.0.4"
   },
   "files": [
     "adapters",

package/plugin.js

@@ -1,7 +1,8 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { createEndpointRuntimeState } from '@zhin.js/adapter';
 import { definePlugin } from '@zhin.js/plugin-runtime';
-import { registerSlackPlatformPermitChecker } from "./lib/platform-permit.js";
+import { permissionHostToken } from '@zhin.js/permission';
+import { checkSlackPlatformPermit } from "./lib/platform-permit.js";
 import { slackRuntimeStateToken } from "./lib/slack-runtime-state.js";
 export default definePlugin({
     name: 'slack',
@@ -9,9 +10,10 @@ export default definePlugin({
         displayName: 'Slack Adapter',
     },
     setup(context) {
-        // 运行中 endpoint 注册表（slack.endpoint list 的"运行中"数据源）
         context.resources.provide(slackRuntimeStateToken, createEndpointRuntimeState());
-        // 平台权限门禁：workspace_owner / channel_manager 等（agent 工具 platformPermit）
-        return registerSlackPlatformPermitChecker();
+        if (context.resources.has(permissionHostToken)) {
+            const host = context.resources.use(permissionHostToken);
+            return host.registerPlatform('slack', checkSlackPlatformPermit);
+        }
     },
 });

package/schema.json

@@ -17,16 +17,48 @@
       "default": 15000,
       "description": "Socket Mode client ping timeout (ms)"
     },
+    "master": {
+      "type": [
+        "string",
+        "number"
+      ],
+      "description": "框架 master（Slack user id；AI/工具权限、endpoint 管理）。endpoints[i].master 可逐项覆盖"
+    },
+    "trusted": {
+      "type": "array",
+      "items": {
+        "type": [
+          "string",
+          "number"
+        ],
+        "description": "Trusted Slack user id"
+      },
+      "description": "框架 trusted 用户列表（弱于 master）。endpoints[i].trusted 可逐项追加"
+    },
     "endpoints": {
       "type": "array",
-      "description": "多账号：一个插件实例挂多个 endpoint。每项与顶层字段同构（name 必填，其余覆盖顶层）",
+      "description": "多账号：一个插件实例挂多个 endpoint。每项与顶层字段同构（id 必填，其余覆盖顶层）",
       "items": {
         "type": "object",
         "additionalProperties": true,
         "properties": {
-          "name": {
-            "type": "string",
-            "description": "Slack bot name"
+          "master": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "本 endpoint 的框架 master（Slack user id）；覆盖顶层 master"
+          },
+          "trusted": {
+            "type": "array",
+            "items": {
+              "type": [
+                "string",
+                "number"
+              ],
+              "description": "Trusted Slack user id"
+            },
+            "description": "本 endpoint 的 trusted 列表"
           },
           "token": {
             "type": "string",
@@ -39,10 +71,14 @@
           "appToken": {
             "type": "string",
             "description": "App-Level Token (xapp-...) for Socket Mode"
+          },
+          "id": {
+            "type": "string",
+            "description": "Slack bot name"
           }
         },
         "required": [
-          "name",
+          "id",
           "token"
         ]
       }

package/src/endpoint.ts

@@ -8,17 +8,18 @@ import type {
   EndpointGroup,
   EndpointInstance,
   EndpointManagement,
+  EndpointSendRequest,
 } from '@zhin.js/adapter';
 import type { MessageGateway } from '@zhin.js/core/runtime';
 import type { HttpHost, HttpRouteRegistration } from '@zhin.js/host-http';
-import { formatCompact, getLogger } from '@zhin.js/logger';
+import { formatCompact, getAdapterLogger } from '@zhin.js/logger';
 import type { CapabilityId } from '@zhin.js/plugin-runtime';
 import {
   formatInboundContent,
   formatInteractionContent,
   formatSlashContent,
-  inboundMessageId,
   resolveSlackChannelType,
+  slackInboundConversation,
   type ResolvedSlackConfig,
   type SlackEvent,
   type SlackEventEnvelope,
@@ -26,7 +27,7 @@ import {
   type SlackMessageEvent,
   type SlackSlashCommand,
 } from './protocol.js';
-import { registerSlackAgentEndpoint } from './slack-agent-deps.js';
+import { registerSlackAgentEndpoint, type SlackUserInfo } from './slack-agent-deps.js';
 import {
   createSlackInboundFilterState,
   shouldDropSlackInboundMessage,
@@ -37,8 +38,6 @@ import { postSlackEphemeral } from './slack-response-url.js';
 import { editSlackContent, sendSlackContent, type SlackChatClient } from './slack-outbound.js';
 import { registerSlackWebhookRoutes, type SlackWebhookHandler } from './webhook.js';
 
-const logger = getLogger('slack');
-
 export interface SlackSocketLike {
   on(
     event: string,
@@ -102,6 +101,8 @@ export interface SlackEndpointOptions {
 }
 
 export class SlackEndpoint implements EndpointInstance, SlackWebhookHandler {
+  readonly #logger!: ReturnType<typeof getAdapterLogger>;
+
   readonly #options: SlackEndpointOptions;
   readonly #inboundFilter = createSlackInboundFilterState();
   readonly #messageChannelMap = new Map<string, string>();
@@ -115,12 +116,13 @@ export class SlackEndpoint implements EndpointInstance, SlackWebhookHandler {
   readonly management: EndpointManagement = createSlackEndpointManagement(this);
 
   constructor(options: SlackEndpointOptions) {
+    this.#logger = getAdapterLogger('slack', options.config.id);
     this.#options = options;
   }
 
   /** Console 展示 / AdapterIndex live name（多 endpoint 时与 entry name 一致）。 */
   get name(): string {
-    return this.#options.config.name;
+    return this.#options.config.id;
   }
 
   get client(): SlackWebClientLike | undefined {
@@ -143,7 +145,7 @@ export class SlackEndpoint implements EndpointInstance, SlackWebhookHandler {
       this.#client = this.#options.createClient?.(config.token)
         ?? (new WebClient(config.token) as unknown as SlackWebClientLike);
 
-      this.#unregisterAgent = registerSlackAgentEndpoint(config.name, this);
+      this.#unregisterAgent = registerSlackAgentEndpoint(config.id, this);
 
       if (config.mode === 'socket') {
         await this.#startSocket();
@@ -153,8 +155,8 @@ export class SlackEndpoint implements EndpointInstance, SlackWebhookHandler {
           throw new Error('Slack HTTP Events API requires httpHostToken (Runtime Host)');
         }
         this.#routeReleases.push(...registerSlackWebhookRoutes(http, this));
-        logger.debug(formatCompact({
-          endpoint: config.name,
+        this.#logger.debug(formatCompact({
+          endpoint: config.id,
           op: 'webhook',
           path: config.webhookPath,
         }));
@@ -163,15 +165,13 @@ export class SlackEndpoint implements EndpointInstance, SlackWebhookHandler {
       const authTest = await this.#client.auth.test();
       if (authTest.user_id) this.#botUserId = String(authTest.user_id);
 
-      logger.info(formatCompact({
-        op: 'connect',
-        endpoint: config.name,
-        mode: config.mode,
-        platform_user_id: this.#botUserId,
-      }));
+      this.#logger.info(
+        `connected (${config.mode})`
+        + (this.#botUserId ? ` | user: ${this.#botUserId}` : ''),
+      );
     } catch (error) {
       await this.stop();
-      logger.error('Failed to connect Slack endpoint:', error);
+      this.#logger.error('Failed to connect Slack endpoint:', error);
       throw error;
     }
   }
@@ -199,17 +199,18 @@ export class SlackEndpoint implements EndpointInstance, SlackWebhookHandler {
     this.#unregisterAgent = undefined;
     this.#client = undefined;
     this.#started = false;
-    logger.debug(formatCompact({ op: 'disconnect', endpoint: this.#options.config.name }));
+    this.#logger.debug(formatCompact({ op: 'disconnect' }));
   }
 
-  async send({ target, payload }: { readonly target: string; readonly payload: unknown }): Promise<string> {
+  async send({ conversation, payload }: EndpointSendRequest): Promise<string> {
     if (!this.#client) throw new Error('Slack client not connected');
-    const { channel, threadTs } = parseSendTarget(target);
+    const channel = conversation.id;
+    const threadTs = conversation.threadId;
     const result = await sendSlackContent(
       this.#client,
       payload,
       { channel, threadTs },
-      logger,
+      this.#logger,
     );
     if (result.ts) this.trackMessageChannel(result.ts, channel);
     return formatSlackMessageRef(channel, result.ts || String(Date.now()));
@@ -224,25 +225,29 @@ export class SlackEndpoint implements EndpointInstance, SlackWebhookHandler {
     if (!msg.channel || !msg.ts) return;
 
     this.trackMessageChannel(msg.ts, msg.channel);
+    const threadTs = msg.thread_ts && msg.thread_ts !== msg.ts ? msg.thread_ts : undefined;
+    const conversation = slackInboundConversation(String(this.#options.id), {
+      channelId: msg.channel,
+      channelType: msg.channel_type,
+      threadId: threadTs,
+    });
     void this.#options.gateway.receive({
-      adapter: this.#options.id,
-      target: msg.channel,
+      conversation,
+      message: { conversation, id: msg.ts },
       content: formatInboundContent(msg),
-      sender: msg.user ?? msg.channel,
-      id: inboundMessageId(msg),
+      sender: { id: msg.user ?? msg.channel ?? '' },
+      endpointId: this.#options.config.id,
+      ...(msg.type === 'app_mention' ? { mentioned: true } : {}),
       metadata: Object.freeze({
-        endpoint: this.#options.config.name,
         channelType: resolveSlackChannelType(msg),
         userId: msg.user,
-        threadTs: msg.thread_ts && msg.thread_ts !== msg.ts ? msg.thread_ts : undefined,
+        threadTs,
         ts: msg.ts,
-        // app_mention 事件本身即 @ 机器人；新 Runtime 纯文本 content 需经 metadata 传递
-        ...(msg.type === 'app_mention' ? { mentioned: true } : {}),
       }),
     }).catch((err) => {
-      logger.warn(formatCompact({
+      this.#logger.warn(formatCompact({
         op: 'slack_gateway_receive_failed',
-        target: msg.channel,
+        target: `${conversation.kind}:${conversation.id}`,
         error: err instanceof Error ? err.message : String(err),
       }));
     });
@@ -255,24 +260,29 @@ export class SlackEndpoint implements EndpointInstance, SlackWebhookHandler {
     const userId = payload.user.id;
     const messageTs = payload.message?.ts ?? '';
     if (payload.response_url) {
-      postSlackEphemeral(payload.response_url, '已收到', logger);
+      postSlackEphemeral(payload.response_url, '已收到', this.#logger);
     }
+    const actionTs = payload.actions[0]?.action_ts ?? messageTs ?? `action-${Date.now()}`;
+    const conversation = slackInboundConversation(String(this.#options.id), {
+      channelId: channelId || userId,
+      // block_actions 无 channel_type；无 channel 时按与发起用户的 DM 处理
+      channelType: channelId ? undefined : 'im',
+    });
     void this.#options.gateway.receive({
-      adapter: this.#options.id,
-      target: channelId || userId,
+      conversation,
+      message: { conversation, id: actionTs },
       content: formatInteractionContent(payload),
-      sender: userId,
-      id: payload.actions[0]?.action_ts ?? messageTs ?? `action-${Date.now()}`,
+      sender: { id: userId },
+      endpointId: this.#options.config.id,
       metadata: Object.freeze({
-        endpoint: this.#options.config.name,
         eventType: 'block_actions',
         actionId: payload.actions[0]?.action_id,
         threadTs: messageTs || undefined,
       }),
     }).catch((err) => {
-      logger.warn(formatCompact({
+      this.#logger.warn(formatCompact({
         op: 'slack_gateway_receive_failed',
-        target: channelId,
+        target: `${conversation.kind}:${conversation.id}`,
         error: err instanceof Error ? err.message : String(err),
       }));
     });
@@ -280,22 +290,24 @@ export class SlackEndpoint implements EndpointInstance, SlackWebhookHandler {
 
   admitSlashCommand(cmd: SlackSlashCommand): void {
     if (!this.#open) return;
-    postSlackEphemeral(cmd.response_url, '处理中…', logger);
+    postSlackEphemeral(cmd.response_url, '处理中…', this.#logger);
+    const conversation = slackInboundConversation(String(this.#options.id), {
+      channelId: cmd.channel_id,
+    });
     void this.#options.gateway.receive({
-      adapter: this.#options.id,
-      target: cmd.channel_id,
+      conversation,
+      message: { conversation, id: cmd.trigger_id },
       content: formatSlashContent(cmd),
-      sender: cmd.user_id,
-      id: cmd.trigger_id,
+      sender: { id: cmd.user_id, name: cmd.user_name },
+      endpointId: this.#options.config.id,
       metadata: Object.freeze({
-        endpoint: this.#options.config.name,
         eventType: 'slash_command',
         command: cmd.command,
       }),
     }).catch((err) => {
-      logger.warn(formatCompact({
+      this.#logger.warn(formatCompact({
         op: 'slack_gateway_receive_failed',
-        target: cmd.channel_id,
+        target: `${conversation.kind}:${conversation.id}`,
         error: err instanceof Error ? err.message : String(err),
       }));
     });
@@ -389,9 +401,9 @@ export class SlackEndpoint implements EndpointInstance, SlackWebhookHandler {
     return result.channel;
   }
 
-  async getUserInfo(user: string): Promise<unknown> {
+  async getUserInfo(user: string): Promise<SlackUserInfo | undefined> {
     const result = await this.#client!.users.info({ user });
-    return result.user;
+    return result.user as SlackUserInfo | undefined;
   }
 
   async addReaction(channel: string, timestamp: string, name: string): Promise<boolean> {
@@ -461,14 +473,6 @@ export class SlackEndpoint implements EndpointInstance, SlackWebhookHandler {
   }
 }
 
-function parseSendTarget(target: string): { channel: string; threadTs?: string } {
-  const parsed = parseSlackMessageRef(target);
-  if (parsed && /^\d+\.\d+$/.test(parsed.ts)) {
-    return { channel: parsed.channel, threadTs: parsed.ts };
-  }
-  return { channel: target };
-}
-
 /** Slack Web API 分页上限（每页 1000，cursor 翻页直到 next_cursor 为空）。 */
 const SLACK_LIST_PAGE_SIZE = 1000;
 

package/src/index.ts

@@ -4,12 +4,12 @@ export {
   formatOutboundWire,
   formatSlashContent,
   headerValue,
-  inboundMessageId,
   keyboardToBlockKitBlocks,
   normalizeWebhookPath,
   readTextBody,
   resolveSlackChannelType,
   resolveSlackConfig,
+  slackInboundConversation,
   verifySlackSignature,
   type ResolvedSlackConfig,
   type SlackAdapterConfig,
@@ -48,16 +48,9 @@ export {
   checkSlackPlatformPermit,
   normalizeSlackSenderForPermit,
   platformPermit,
-  registerSlackPlatformPermitChecker,
   slackGroupPermitResolver,
 } from './platform-permit.js';
 
-export {
-  formatSlackMessageRef,
-  parseSlackMessageRef,
-  slackMessageTs,
-} from './slack-message-ref.js';
-
 export { normalizeSlackReactionName } from './slack-reaction.js';
 export { markdownToMrkdwn, mrkdwnToPlainFallback, splitMrkdwnText } from './markdown-to-mrkdwn.js';
 export { mrkdwnToMarkdown } from './mrkdwn-to-markdown.js';

package/src/platform-permit.ts

@@ -1,7 +1,7 @@
 /**
  * Slack platform permit — workspace + channel 权限
  */
-import { registerPlatformPermitChecker, type Message } from '@zhin.js/core';
+import type { PermissionSubject } from '@zhin.js/permission';
 
 const ADAPTER = 'slack';
 
@@ -39,10 +39,9 @@ export function normalizeSlackSenderForPermit(input: {
   return { role: 'member', permissions };
 }
 
-export function checkSlackPlatformPermit(perm: string, message: Message<any>): boolean {
-  const sender = message.$sender as { role?: string; permissions?: string[] };
-  const permissions = sender.permissions ?? [];
-  const role = sender.role;
+export function checkSlackPlatformPermit(perm: string, subject: PermissionSubject): boolean {
+  const role = subject.sender?.role?.[0];
+  const permissions = subject.sender?.permissions ?? [];
   const has = (t: string) => permissions.includes(t);
 
   switch (perm) {
@@ -58,6 +57,3 @@ export function checkSlackPlatformPermit(perm: string, message: Message<any>): b
   }
 }
 
-export function registerSlackPlatformPermitChecker(): () => void {
-  return registerPlatformPermitChecker(ADAPTER, checkSlackPlatformPermit);
-}

package/src/protocol.ts

@@ -5,6 +5,7 @@
 import { createHmac, timingSafeEqual } from 'node:crypto';
 import type { IncomingMessage } from 'node:http';
 import { isMediaRef, type MediaRef } from '@zhin.js/core';
+import type { ConversationKind, ConversationRef } from '@zhin.js/im-contract';
 import { formatCompact, getLogger } from '@zhin.js/logger';
 import { mrkdwnToMarkdown } from './mrkdwn-to-markdown.js';
 
@@ -20,7 +21,7 @@ const MAX_TIMESTAMP_DRIFT_SECONDS = 300;
 
 /** Plugin Runtime owner config (`plugins.<instanceKey>` / schema.json). */
 export interface SlackAdapterConfig {
-  readonly name?: string;
+  readonly id?: string;
   readonly token?: string;
   readonly signingSecret?: string;
   readonly appToken?: string;
@@ -41,7 +42,7 @@ export interface SlackAdapterConfig {
 
 export interface ResolvedSlackConfig {
   readonly context: 'slack';
-  readonly name: string;
+  readonly id: string;
   readonly token: string;
   readonly mode: 'socket' | 'http';
   readonly signingSecret: string;
@@ -138,8 +139,8 @@ export function resolveSlackConfig(config: SlackAdapterConfig = {}): ResolvedSla
     );
   }
 
-  const name = (typeof config.name === 'string' && config.name)
-    || (typeof entry?.name === 'string' && entry.name)
+  const id = (typeof config.id === 'string' && config.id)
+    || (typeof entry?.id === 'string' && entry.id)
     || process.env.SLACK_BOT_NAME
     || 'slack-bot';
 
@@ -169,7 +170,7 @@ export function resolveSlackConfig(config: SlackAdapterConfig = {}): ResolvedSla
 
   return {
     context: 'slack',
-    name,
+    id,
     token,
     mode,
     signingSecret,
@@ -192,6 +193,30 @@ export function resolveSlackChannelType(event: Pick<SlackEvent, 'channel_type'>)
   return event.channel_type === 'im' ? 'private' : 'group';
 }
 
+/**
+ * 入站归一化 → ConversationRef：channel_type `im` → private，其余（channel/group/mpim）
+ * → group；交互/斜杠命令无 channel_type 时按平台 id 前缀推断（D* 为 DM）。Slack 无
+ * guild 容器概念（team 为 workspace 级，不进 parent）；线程根 ts 进 `threadId`。
+ */
+export function slackInboundConversation(
+  endpointKey: string,
+  opts: {
+    readonly channelId: string;
+    readonly channelType?: string;
+    readonly threadId?: string;
+  },
+): ConversationRef {
+  const kind: ConversationKind = opts.channelType != null
+    ? (opts.channelType === 'im' ? 'private' : 'group')
+    : (opts.channelId.startsWith('D') ? 'private' : 'group');
+  return {
+    endpoint: { id: endpointKey, adapter: endpointKey.split('\0')[0] ?? endpointKey },
+    kind,
+    id: opts.channelId,
+    ...(opts.threadId ? { threadId: opts.threadId } : {}),
+  };
+}
+
 /** Build inbound text for MessageGateway.receive. */
 export function formatInboundContent(event: SlackMessageEvent | SlackEvent): string {
   const text = typeof event.text === 'string' ? event.text : '';
@@ -213,10 +238,6 @@ export function formatSlashContent(cmd: SlackSlashCommand): string {
   return `${cmd.command} ${cmd.text}`.trim();
 }
 
-export function inboundMessageId(event: SlackMessageEvent): string {
-  return `${event.channel}:${event.ts}`;
-}
-
 /**
  * Wire-encode an already-rendered outbound payload into Slack text + Block Kit blocks.
  * Segment canonicalization is intentionally not done here.

package/src/slack-agent-deps.ts

@@ -13,7 +13,7 @@ export interface SlackAgentEndpoint {
   renameChannel(channel: string, name: string): Promise<boolean>;
   getChannelMembers(channel: string): Promise<string[]>;
   getChannelInfo(channel: string): Promise<unknown>;
-  getUserInfo(user: string): Promise<unknown>;
+  getUserInfo(user: string): Promise<SlackUserInfo | undefined>;
   addReaction(channel: string, timestamp: string, name: string): Promise<boolean>;
   removeReaction(channel: string, timestamp: string, name: string): Promise<boolean>;
   pinMessage(channel: string, timestamp: string): Promise<boolean>;
@@ -21,21 +21,35 @@ export interface SlackAgentEndpoint {
   editMessage(channel: string, messageTs: string, content: unknown): Promise<void>;
 }
 
+/** Slack users.info 返回的用户对象（SDK 响应字段对 agent 工具的投影）。 */
+export interface SlackUserInfo {
+  id?: string;
+  name?: string;
+  real_name?: string;
+  is_admin?: boolean;
+  is_bot?: boolean;
+  profile?: {
+    display_name?: string;
+    email?: string;
+    status_text?: string;
+  };
+}
+
 export interface SlackAgentDeps {
-  getEndpoint: (endpointId: string) => SlackAgentEndpoint;
+  getEndpoint: (endpointKey: string) => SlackAgentEndpoint;
 }
 
 const endpoints = new Map<string, SlackAgentEndpoint>();
 let override: SlackAgentDeps | null = null;
 
 export function registerSlackAgentEndpoint(
-  endpointId: string,
+  endpointKey: string,
   endpoint: SlackAgentEndpoint,
 ): () => void {
-  endpoints.set(endpointId, endpoint);
+  endpoints.set(endpointKey, endpoint);
   return () => {
-    if (endpoints.get(endpointId) === endpoint) {
-      endpoints.delete(endpointId);
+    if (endpoints.get(endpointKey) === endpoint) {
+      endpoints.delete(endpointKey);
     }
   };
 }
@@ -48,9 +62,9 @@ export function setSlackAgentDeps(deps: SlackAgentDeps | null): void {
 export function getSlackAgentDeps(): SlackAgentDeps {
   if (override) return override;
   return {
-    getEndpoint(endpointId: string): SlackAgentEndpoint {
-      const registered = endpoints.get(endpointId);
-      if (!registered) throw new Error(`Endpoint ${endpointId} 不存在`);
+    getEndpoint(endpointKey: string): SlackAgentEndpoint {
+      const registered = endpoints.get(endpointKey);
+      if (!registered) throw new Error(`Endpoint ${endpointKey} 不存在`);
       return registered;
     },
   };