@zhin.js/adapter-slack 1.1.0 → 1.1.3

package/agents/slack/skills/slack-messages/tools/pin_message/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'),
+        timestamp: z.string().describe('消息时间戳'),
+    }),
+    adapter: 'slack',
+    tags: ['slack'],
+    permissions: [platformPermission('slack', 'channel_manager')],
+    async execute({ channel, timestamp }, context) {
+        const client = context.$client;
+        await client.pins.add({ channel, timestamp });
+        const success = true;
+        return { success, message: success ? '已置顶消息' : '操作失败' };
+    },
+});

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

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

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

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

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

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

package/agents/slack/skills/slack-messages/tools/unpin_message/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'),
+        timestamp: z.string().describe('消息时间戳'),
+    }),
+    adapter: 'slack',
+    tags: ['slack'],
+    permissions: [platformPermission('slack', 'channel_manager')],
+    async execute({ channel_id, timestamp }, context) {
+        const client = context.$client;
+        await client.pins.remove({ channel: channel_id, timestamp });
+        const success = true;
+        return { success, message: success ? '已取消置顶' : '操作失败' };
+    },
+});

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

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

package/agents/slack/system.md

@@ -0,0 +1,3 @@
+# SLACK Platform Agent
+
+You are the slack platform specialist. Interpret requests in the current slack conversation and load only the narrowest private Skill needed for the task.

package/commands/{endpoint/add/[id].js → slack/endpoint/add/[id]/index.js}

@@ -1,3 +1,3 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { slackEndpointCommands } from "../../../lib/slack-endpoint-commands.js";
+import { slackEndpointCommands } from '../../definition.js';
 export default slackEndpointCommands.add;

package/commands/slack/endpoint/add/[id]/index.ts

@@ -0,0 +1,3 @@
+import { slackEndpointCommands } from '../../definition.js';
+
+export default slackEndpointCommands.add;

package/{lib/slack-endpoint-commands.js → commands/slack/endpoint/definition.js}

@@ -1,10 +1,11 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
 /**
- * `slack.endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
- * commands/endpoint/ 下的 list / add / remove 直接默认导出这三项。
+ * `slack endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
+ * commands/slack/endpoint/ 下的 list / add / remove 直接默认导出这三项。
  */
 import { createEndpointCommands } from 'zhin.js/adapter';
 import { defineCommand } from 'zhin.js/command';
-import { slackRuntimeStateToken } from './slack-runtime-state.js';
+import { slackRuntimeStateToken } from "../../../lib/slack-runtime-state.js";
 export const slackEndpointCommands = createEndpointCommands({
     adapterKey: 'slack',
     adapterDisplayName: 'Slack',

package/{src/slack-endpoint-commands.ts → commands/slack/endpoint/definition.ts}

@@ -1,10 +1,10 @@
 /**
- * `slack.endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
- * commands/endpoint/ 下的 list / add / remove 直接默认导出这三项。
+ * `slack endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
+ * commands/slack/endpoint/ 下的 list / add / remove 直接默认导出这三项。
  */
 import { createEndpointCommands } from 'zhin.js/adapter';
 import { defineCommand } from 'zhin.js/command';
-import { slackRuntimeStateToken } from './slack-runtime-state.js';
+import { slackRuntimeStateToken } from '../../../src/slack-runtime-state.js';
 
 export const slackEndpointCommands = createEndpointCommands({
   adapterKey: 'slack',

package/commands/{endpoint/list.js → slack/endpoint/list/index.js}

@@ -1,3 +1,3 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { slackEndpointCommands } from "../../lib/slack-endpoint-commands.js";
+import { slackEndpointCommands } from '../definition.js';
 export default slackEndpointCommands.list;

package/commands/slack/endpoint/list/index.ts

@@ -0,0 +1,3 @@
+import { slackEndpointCommands } from '../definition.js';
+
+export default slackEndpointCommands.list;

package/commands/{endpoint/remove/[id].js → slack/endpoint/remove/[id]/index.js}

@@ -1,3 +1,3 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { slackEndpointCommands } from "../../../lib/slack-endpoint-commands.js";
+import { slackEndpointCommands } from '../../definition.js';
 export default slackEndpointCommands.remove;

package/commands/slack/endpoint/remove/[id]/index.ts

@@ -0,0 +1,3 @@
+import { slackEndpointCommands } from '../../definition.js';
+
+export default slackEndpointCommands.remove;

package/lib/index.d.ts

@@ -1,4 +1,4 @@
-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 { formatInboundContent, formatInteractionContent, formatOutboundWire, formatSlashContent, headerValue, keyboardToBlockKitBlocks, normalizeWebhookPath, readTextBody, resolveSlackChannelType, resolveSlackConfig, slackInboundConversation, verifySlackSignature, type ResolvedSlackConfig, type SlackEndpointConfig, 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 { slackClient, type SlackClientEventMap, type SlackUserInfo, } from './client.js';

package/lib/protocol.d.ts

@@ -1,24 +1,15 @@
 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 id?: string;
-    readonly token?: string;
+import { type ConversationRef } from '@zhin.js/im-contract';
+/** One endpoint config after AdapterIndex expands `plugins.<instanceKey>.endpoints`. */
+export interface SlackEndpointConfig {
+    readonly id: string;
+    readonly token: string;
     readonly signingSecret?: string;
     readonly appToken?: string;
     /** Default true (Socket Mode). Set false for HTTP Events API via httpHostToken. */
     readonly socketMode?: boolean;
     readonly webhookPath?: string;
     readonly clientPingTimeout?: number;
-    /** Transitional: legacy root `endpoints[]` with `context: slack`. */
-    readonly endpoints?: ReadonlyArray<Partial<ResolvedSlackConfig> & {
-        readonly context?: string;
-        readonly socketMode?: boolean;
-        readonly signingSecret?: string;
-        readonly appToken?: string;
-        readonly webhookPath?: string;
-        readonly clientPingTimeout?: number;
-    }>;
 }
 export interface ResolvedSlackConfig {
     readonly context: 'slack';
@@ -113,7 +104,7 @@ export interface SlackWireSegment {
     readonly type: string;
     readonly data?: Record<string, unknown>;
 }
-export declare function resolveSlackConfig(config?: SlackAdapterConfig): ResolvedSlackConfig;
+export declare function resolveSlackConfig(config: SlackEndpointConfig): ResolvedSlackConfig;
 export declare function normalizeWebhookPath(path: string): string;
 export declare function resolveSlackChannelType(event: Pick<SlackEvent, 'channel_type'>): 'private' | 'group';
 /**

package/lib/protocol.js

@@ -3,7 +3,7 @@
  * Canonicalization is owned by gateway/core before endpoint.send.
  */
 import { createHmac, timingSafeEqual } from 'node:crypto';
-import { isMediaRef } from '@zhin.js/core';
+import { isMediaRef } from '@zhin.js/im-contract';
 import { formatCompact, getLogger } from '@zhin.js/logger';
 import { mrkdwnToMarkdown } from './mrkdwn-to-markdown.js';
 const logger = getLogger('slack');
@@ -13,36 +13,18 @@ function dropOutboundMedia(type, reason) {
 }
 const SLACK_SIG_VERSION = 'v0';
 const MAX_TIMESTAMP_DRIFT_SECONDS = 300;
-export function resolveSlackConfig(config = {}) {
-    const entry = config.endpoints?.find((item) => item.context === 'slack');
-    const token = config.token
-        ?? entry?.token
-        ?? process.env.SLACK_BOT_TOKEN
-        ?? process.env.SLACK_TOKEN;
-    if (!token) {
-        throw new TypeError('Slack adapter requires token (plugins.<key>.token or endpoints with context: slack)');
-    }
-    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;
+export function resolveSlackConfig(config) {
+    const id = requiredEndpointField(config.id, 'id');
+    const token = requiredEndpointField(config.token, 'token');
+    const socketMode = config.socketMode;
     // Prefer Socket Mode (default true) — no public URL required.
     const mode = socketMode === false ? 'http' : 'socket';
-    const signingSecret = config.signingSecret
-        ?? entry?.signingSecret
-        ?? process.env.SLACK_SIGNING_SECRET
-        ?? '';
-    const appToken = config.appToken
-        ?? entry?.appToken
-        ?? process.env.SLACK_APP_TOKEN
-        ?? undefined;
-    if (mode === 'socket' && !appToken) {
-        throw new TypeError('Slack Socket Mode requires appToken (xapp-...); set socketMode: false for HTTP Events API');
-    }
-    if (mode === 'http' && !signingSecret) {
-        throw new TypeError('Slack HTTP Events API requires signingSecret');
-    }
+    const signingSecret = mode === 'http'
+        ? requiredEndpointField(config.signingSecret, 'signingSecret')
+        : config.signingSecret?.trim() ?? '';
+    const appToken = mode === 'socket'
+        ? requiredEndpointField(config.appToken, 'appToken')
+        : config.appToken?.trim();
     return {
         context: 'slack',
         id,
@@ -50,12 +32,16 @@ export function resolveSlackConfig(config = {}) {
         mode,
         signingSecret,
         appToken,
-        webhookPath: normalizeWebhookPath(config.webhookPath ?? entry?.webhookPath ?? '/slack/events'),
-        clientPingTimeout: config.clientPingTimeout
-            ?? entry?.clientPingTimeout
-            ?? 15_000,
+        webhookPath: normalizeWebhookPath(config.webhookPath ?? '/slack/events'),
+        clientPingTimeout: config.clientPingTimeout ?? 15_000,
     };
 }
+function requiredEndpointField(value, field) {
+    if (typeof value !== 'string' || !value.trim()) {
+        throw new TypeError(`Slack endpoint requires a non-empty ${field}`);
+    }
+    return value.trim();
+}
 export function normalizeWebhookPath(path) {
     const trimmed = path.trim() || '/slack/events';
     return trimmed.startsWith('/') ? trimmed : `/${trimmed}`;

package/lib/slack-runtime-state.js

@@ -1,6 +1,6 @@
 /**
  * Slack 插件实例的运行时状态：adapter create() 注册的 endpoint 列表。
- * 由 plugin.ts setup() provide，adapter create 与 `slack.endpoint` 命令共享（同一 owner generation）。
+ * 由 plugin.ts setup() provide，adapter create 与 `slack endpoint` 命令共享（同一 owner generation）。
  */
 import { defineEndpointRuntimeStateToken } from 'zhin.js/adapter';
 export const slackRuntimeStateToken = defineEndpointRuntimeStateToken('slack');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-slack",
-  "version": "1.1.0",
+  "version": "1.1.3",
   "description": "Zhin.js Slack adapter for Plugin Runtime (Socket Mode / HTTP Events)",
   "type": "module",
   "main": "./lib/index.js",
@@ -34,27 +34,26 @@
   "dependencies": {
     "@slack/socket-mode": "^2.0.7",
     "@slack/web-api": "^7.19.0",
-    "@zhin.js/adapter": "1.1.12",
-    "@zhin.js/core": "1.1.35",
-    "@zhin.js/feature-kit": "1.1.0",
-    "@zhin.js/host-http": "1.1.0",
-    "@zhin.js/im-contract": "1.1.0",
-    "@zhin.js/logger": "1.1.0"
+    "@zhin.js/adapter": "1.1.15",
+    "@zhin.js/agent-feature": "1.1.2",
+    "@zhin.js/core": "1.1.38",
+    "@zhin.js/feature-kit": "1.1.2",
+    "@zhin.js/host-http": "1.1.2",
+    "@zhin.js/im-contract": "1.1.2",
+    "@zhin.js/logger": "1.1.1",
+    "@zhin.js/skill": "1.1.2",
+    "@zhin.js/tool": "1.1.2"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.12",
-    "@zhin.js/agent": "^1.1.23",
-    "@zhin.js/command": "^1.1.0",
-    "@zhin.js/core": "^1.1.35",
-    "@zhin.js/host-http": "^1.1.0",
-    "@zhin.js/permission": "^1.1.0",
-    "zhin.js": "^1.1.0"
+    "@zhin.js/adapter": "^1.1.15",
+    "@zhin.js/command": "^1.1.2",
+    "@zhin.js/core": "^1.1.38",
+    "@zhin.js/host-http": "^1.1.2",
+    "@zhin.js/permission": "^1.1.2",
+    "zhin.js": "^1.1.3"
   },
   "peerDependenciesMeta": {
-    "@zhin.js/agent": {
-      "optional": true
-    },
     "@zhin.js/command": {
       "optional": true
     },
@@ -70,8 +69,7 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/agent": "1.1.23",
-    "zhin.js": "1.1.0"
+    "zhin.js": "1.1.3"
   },
   "files": [
     "adapters",
@@ -80,9 +78,11 @@
     "schema.json",
     "src",
     "lib",
-    "agent",
+    "tools",
+    "agents",
     "README.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "PERMITS.md"
   ],
   "publishConfig": {
     "access": "public",
@@ -105,6 +105,18 @@
       {
         "package": "@zhin.js/command",
         "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/tool",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/skill",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/agent-feature",
+        "api": "^1.0.0"
       }
     ],
     "plugins": []

package/schema.json

@@ -37,10 +37,11 @@
     },
     "endpoints": {
       "type": "array",
+      "minItems": 1,
       "description": "多账号：一个插件实例挂多个 endpoint。每项与顶层字段同构（id 必填，其余覆盖顶层）",
       "items": {
         "type": "object",
-        "additionalProperties": true,
+        "additionalProperties": false,
         "properties": {
           "master": {
             "type": [
@@ -72,6 +73,18 @@
             "type": "string",
             "description": "App-Level Token (xapp-...) for Socket Mode"
           },
+          "socketMode": {
+            "type": "boolean"
+          },
+          "webhookPath": {
+            "type": "string"
+          },
+          "clientPingTimeout": {
+            "type": "number"
+          },
+          "commandPrefix": {
+            "type": "string"
+          },
           "id": {
             "type": "string",
             "description": "Slack bot name"

package/src/index.ts

@@ -12,7 +12,7 @@ export {
   slackInboundConversation,
   verifySlackSignature,
   type ResolvedSlackConfig,
-  type SlackAdapterConfig,
+  type SlackEndpointConfig,
   type SlackBlockAction,
   type SlackEvent,
   type SlackEventEnvelope,

package/src/protocol.ts

@@ -4,8 +4,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 { isMediaRef, type MediaRef, type ConversationKind, type ConversationRef } from '@zhin.js/im-contract';
 import { formatCompact, getLogger } from '@zhin.js/logger';
 import { mrkdwnToMarkdown } from './mrkdwn-to-markdown.js';
 
@@ -19,25 +18,16 @@ function dropOutboundMedia(type: string, reason: string): void {
 const SLACK_SIG_VERSION = 'v0';
 const MAX_TIMESTAMP_DRIFT_SECONDS = 300;
 
-/** Plugin Runtime owner config (`plugins.<instanceKey>` / schema.json). */
-export interface SlackAdapterConfig {
-  readonly id?: string;
-  readonly token?: string;
+/** One endpoint config after AdapterIndex expands `plugins.<instanceKey>.endpoints`. */
+export interface SlackEndpointConfig {
+  readonly id: string;
+  readonly token: string;
   readonly signingSecret?: string;
   readonly appToken?: string;
   /** Default true (Socket Mode). Set false for HTTP Events API via httpHostToken. */
   readonly socketMode?: boolean;
   readonly webhookPath?: string;
   readonly clientPingTimeout?: number;
-  /** Transitional: legacy root `endpoints[]` with `context: slack`. */
-  readonly endpoints?: ReadonlyArray<Partial<ResolvedSlackConfig> & {
-    readonly context?: string;
-    readonly socketMode?: boolean;
-    readonly signingSecret?: string;
-    readonly appToken?: string;
-    readonly webhookPath?: string;
-    readonly clientPingTimeout?: number;
-  }>;
 }
 
 export interface ResolvedSlackConfig {
@@ -127,46 +117,19 @@ export interface SlackWireSegment {
   readonly data?: Record<string, unknown>;
 }
 
-export function resolveSlackConfig(config: SlackAdapterConfig = {}): ResolvedSlackConfig {
-  const entry = config.endpoints?.find((item) => item.context === 'slack');
-  const token = config.token
-    ?? entry?.token
-    ?? process.env.SLACK_BOT_TOKEN
-    ?? process.env.SLACK_TOKEN;
-  if (!token) {
-    throw new TypeError(
-      'Slack adapter requires token (plugins.<key>.token or endpoints with context: slack)',
-    );
-  }
-
-  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;
+export function resolveSlackConfig(config: SlackEndpointConfig): ResolvedSlackConfig {
+  const id = requiredEndpointField(config.id, 'id');
+  const token = requiredEndpointField(config.token, 'token');
+  const socketMode = config.socketMode;
   // Prefer Socket Mode (default true) — no public URL required.
   const mode: 'socket' | 'http' = socketMode === false ? 'http' : 'socket';
 
-  const signingSecret = config.signingSecret
-    ?? entry?.signingSecret
-    ?? process.env.SLACK_SIGNING_SECRET
-    ?? '';
-  const appToken = config.appToken
-    ?? entry?.appToken
-    ?? process.env.SLACK_APP_TOKEN
-    ?? undefined;
-
-  if (mode === 'socket' && !appToken) {
-    throw new TypeError(
-      'Slack Socket Mode requires appToken (xapp-...); set socketMode: false for HTTP Events API',
-    );
-  }
-  if (mode === 'http' && !signingSecret) {
-    throw new TypeError(
-      'Slack HTTP Events API requires signingSecret',
-    );
-  }
+  const signingSecret = mode === 'http'
+    ? requiredEndpointField(config.signingSecret, 'signingSecret')
+    : config.signingSecret?.trim() ?? '';
+  const appToken = mode === 'socket'
+    ? requiredEndpointField(config.appToken, 'appToken')
+    : config.appToken?.trim();
 
   return {
     context: 'slack',
@@ -176,14 +139,22 @@ export function resolveSlackConfig(config: SlackAdapterConfig = {}): ResolvedSla
     signingSecret,
     appToken,
     webhookPath: normalizeWebhookPath(
-      config.webhookPath ?? entry?.webhookPath ?? '/slack/events',
+      config.webhookPath ?? '/slack/events',
     ),
-    clientPingTimeout: config.clientPingTimeout
-      ?? entry?.clientPingTimeout
-      ?? 15_000,
+    clientPingTimeout: config.clientPingTimeout ?? 15_000,
   };
 }
 
+function requiredEndpointField(
+  value: unknown,
+  field: 'id' | 'token' | 'signingSecret' | 'appToken',
+): string {
+  if (typeof value !== 'string' || !value.trim()) {
+    throw new TypeError(`Slack endpoint requires a non-empty ${field}`);
+  }
+  return value.trim();
+}
+
 export function normalizeWebhookPath(path: string): string {
   const trimmed = path.trim() || '/slack/events';
   return trimmed.startsWith('/') ? trimmed : `/${trimmed}`;

package/src/slack-runtime-state.ts

@@ -1,6 +1,6 @@
 /**
  * Slack 插件实例的运行时状态：adapter create() 注册的 endpoint 列表。
- * 由 plugin.ts setup() provide，adapter create 与 `slack.endpoint` 命令共享（同一 owner generation）。
+ * 由 plugin.ts setup() provide，adapter create 与 `slack endpoint` 命令共享（同一 owner generation）。
  */
 import { defineEndpointRuntimeStateToken } from 'zhin.js/adapter';