@zhin.js/adapter-slack 1.0.78 → 1.1.2

package/src/index.ts

@@ -1,265 +1,59 @@
-/**
- * Slack 适配器入口：类型扩展、导出、注册
- */
-import { usePlugin, type Plugin, type IGroupManagement, createGroupManagementTools, type ToolFeature } from "zhin.js";
-import { SlackAdapter } from "./adapter.js";
-
-declare module "zhin.js" {
-  interface Adapters {
-    slack: SlackAdapter;
-  }
-}
-
-export * from "./types.js";
-export { SlackBot } from "./bot.js";
-export { SlackAdapter } from "./adapter.js";
-
-const plugin = usePlugin();
-const { provide, useContext } = plugin;
-
-provide({
-  name: "slack",
-  description: "Slack Bot Adapter",
-  mounted: async (p: Plugin) => {
-    const adapter = new SlackAdapter(p);
-    await adapter.start();
-    return adapter;
-  },
-  dispose: async (adapter: SlackAdapter) => {
-    await adapter.stop();
-  },
-});
-
-useContext('tool', 'slack', (toolService: ToolFeature, slack: SlackAdapter) => {
-  const groupTools = createGroupManagementTools(
-    slack as unknown as IGroupManagement,
-    'slack',
-  );
-  const disposers: (() => void)[] = groupTools.map(t => toolService.addTool(t, plugin.name));
-
-  function getBot(botId: string) {
-    const bot = slack.bots.get(botId);
-    if (!bot) throw new Error(`Bot ${botId} 不存在`);
-    return bot;
-  }
-
-  disposers.push(toolService.addTool({
-    name: 'slack_invite_to_channel',
-    description: '邀请用户加入 Slack 频道',
-    parameters: {
-      type: 'object',
-      properties: {
-        bot: { type: 'string', description: 'Bot 名称' },
-        channel: { type: 'string', description: '频道 ID' },
-        users: { type: 'string', description: '用户 ID 列表（逗号分隔）' },
-      },
-      required: ['bot', 'channel', 'users'],
-    },
-    platforms: ['slack'],
-    tags: ['slack'],
-    execute: async (args: Record<string, any>) => {
-      const bot = getBot(args.bot);
-      const success = await bot.inviteToChannel(args.channel, args.users.split(','));
-      return { success, message: success ? '已邀请用户加入频道' : '操作失败' };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'slack_set_topic',
-    description: '设置 Slack 频道话题',
-    parameters: {
-      type: 'object',
-      properties: {
-        bot: { type: 'string', description: 'Bot 名称' },
-        channel: { type: 'string', description: '频道 ID' },
-        topic: { type: 'string', description: '新话题' },
-      },
-      required: ['bot', 'channel', 'topic'],
-    },
-    platforms: ['slack'],
-    tags: ['slack'],
-    execute: async (args: Record<string, any>) => {
-      const bot = getBot(args.bot);
-      const success = await bot.setChannelTopic(args.channel, args.topic);
-      return { success, message: success ? '已设置频道话题' : '操作失败' };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'slack_archive_channel',
-    description: '归档 Slack 频道',
-    parameters: {
-      type: 'object',
-      properties: {
-        bot: { type: 'string', description: 'Bot 名称' },
-        channel: { type: 'string', description: '频道 ID' },
-      },
-      required: ['bot', 'channel'],
-    },
-    platforms: ['slack'],
-    tags: ['slack'],
-    execute: async (args: Record<string, any>) => {
-      const bot = getBot(args.bot);
-      const success = await bot.archiveChannel(args.channel);
-      return { success, message: success ? '已归档频道' : '操作失败' };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'slack_pin_message',
-    description: '置顶 Slack 消息',
-    parameters: {
-      type: 'object',
-      properties: {
-        bot: { type: 'string', description: 'Bot 名称' },
-        channel: { type: 'string', description: '频道 ID' },
-        timestamp: { type: 'string', description: '消息时间戳' },
-      },
-      required: ['bot', 'channel', 'timestamp'],
-    },
-    platforms: ['slack'],
-    tags: ['slack'],
-    execute: async (args: Record<string, any>) => {
-      const bot = getBot(args.bot);
-      const success = await bot.pinMessage(args.channel, args.timestamp);
-      return { success, message: success ? '已置顶消息' : '操作失败' };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'slack_add_reaction',
-    description: '给 Slack 消息添加表情反应',
-    parameters: {
-      type: 'object',
-      properties: {
-        bot: { type: 'string', description: 'Bot 名称' },
-        channel: { type: 'string', description: '频道 ID' },
-        timestamp: { type: 'string', description: '消息时间戳' },
-        emoji: { type: 'string', description: '表情名称（不含冒号）' },
-      },
-      required: ['bot', 'channel', 'timestamp', 'emoji'],
-    },
-    platforms: ['slack'],
-    tags: ['slack'],
-    execute: async (args: Record<string, any>) => {
-      const bot = getBot(args.bot);
-      const success = await bot.addReaction(args.channel, args.timestamp, args.emoji);
-      return { success, message: success ? `已添加反应 :${args.emoji}:` : '操作失败' };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'slack_remove_reaction',
-    description: '移除 Slack 消息上的表情反应',
-    parameters: {
-      type: 'object',
-      properties: {
-        bot: { type: 'string', description: 'Bot 名称' },
-        channel_id: { type: 'string', description: '频道 ID' },
-        timestamp: { type: 'string', description: '消息时间戳' },
-        name: { type: 'string', description: '表情名称（如 thumbsup、heart）' },
-      },
-      required: ['bot', 'channel_id', 'timestamp', 'name'],
-    },
-    platforms: ['slack'],
-    tags: ['slack'],
-    execute: async (args: Record<string, any>) => {
-      const bot = getBot(args.bot);
-      const success = await bot.removeReaction(args.channel_id, args.timestamp, args.name);
-      return { success, message: success ? `已移除反应 :${args.name}:` : '操作失败' };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'slack_unpin_message',
-    description: '取消 Slack 频道中消息的置顶',
-    parameters: {
-      type: 'object',
-      properties: {
-        bot: { type: 'string', description: 'Bot 名称' },
-        channel_id: { type: 'string', description: '频道 ID' },
-        timestamp: { type: 'string', description: '消息时间戳' },
-      },
-      required: ['bot', 'channel_id', 'timestamp'],
-    },
-    platforms: ['slack'],
-    tags: ['slack'],
-    execute: async (args: Record<string, any>) => {
-      const bot = getBot(args.bot);
-      const success = await bot.unpinMessage(args.channel_id, args.timestamp);
-      return { success, message: success ? '已取消置顶' : '操作失败' };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'slack_user_info',
-    description: '查询 Slack 用户详细信息',
-    parameters: {
-      type: 'object',
-      properties: {
-        bot: { type: 'string', description: 'Bot 名称' },
-        user_id: { type: 'string', description: '用户 ID' },
-      },
-      required: ['bot', 'user_id'],
-    },
-    platforms: ['slack'],
-    tags: ['slack'],
-    execute: async (args: Record<string, any>) => {
-      const bot = getBot(args.bot);
-      const user = await bot.getUserInfo(args.user_id);
-      return {
-        id: user.id,
-        name: user.name,
-        real_name: user.real_name,
-        display_name: user.profile?.display_name,
-        email: user.profile?.email,
-        is_admin: user.is_admin,
-        is_bot: user.is_bot,
-        status_text: user.profile?.status_text,
-      };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'slack_set_purpose',
-    description: '设置 Slack 频道的用途/目的',
-    parameters: {
-      type: 'object',
-      properties: {
-        bot: { type: 'string', description: 'Bot 名称' },
-        channel_id: { type: 'string', description: '频道 ID' },
-        purpose: { type: 'string', description: '频道用途描述' },
-      },
-      required: ['bot', 'channel_id', 'purpose'],
-    },
-    platforms: ['slack'],
-    tags: ['slack'],
-    execute: async (args: Record<string, any>) => {
-      const bot = getBot(args.bot);
-      const success = await bot.setChannelPurpose(args.channel_id, args.purpose);
-      return { success, message: success ? '频道用途已更新' : '操作失败' };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'slack_unarchive',
-    description: '恢复已归档的 Slack 频道',
-    parameters: {
-      type: 'object',
-      properties: {
-        bot: { type: 'string', description: 'Bot 名称' },
-        channel_id: { type: 'string', description: '频道 ID' },
-      },
-      required: ['bot', 'channel_id'],
-    },
-    platforms: ['slack'],
-    tags: ['slack'],
-    execute: async (args: Record<string, any>) => {
-      const bot = getBot(args.bot);
-      const success = await bot.unarchiveChannel(args.channel_id);
-      return { success, message: success ? '频道已恢复' : '操作失败' };
-    },
-  }, plugin.name));
-
-  return () => disposers.forEach(d => d());
-});
+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';
+
+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';
+export {
+  createSlackInboundFilterState,
+  shouldDropSlackInboundMessage,
+} from './slack-inbound-filter.js';
+export { editSlackContent, sendSlackContent } from './slack-outbound.js';

package/src/markdown-to-mrkdwn.ts

@@ -0,0 +1,117 @@
+/**
+ * 常见 Markdown → Slack mrkdwn（Slack 粗体为 *text*，链接为 <url|text>）
+ */
+export const SLACK_MRKDWN_TEXT_MAX = 2900;
+
+export function markdownToMrkdwn(text: string): string {
+  let result = replaceMarkdownLinks(text);
+  result = result.replace(/\*\*([^*]+)\*\*/g, '*$1*');
+  result = result.replace(/__([^_]+)__/g, '*$1*');
+  result = result.replace(/~~([^~]+)~~/g, '~$1~');
+  result = result.replace(/^#{1,6}\s+(.+)$/gm, '*$1*');
+  return result;
+}
+
+function replaceMarkdownLinks(text: string): string {
+  let out = '';
+  let cursor = 0;
+  while (cursor < text.length) {
+    const labelStart = text.indexOf('[', cursor);
+    if (labelStart < 0) break;
+    const labelEnd = text.indexOf(']', labelStart + 1);
+    if (labelEnd < 0 || text[labelEnd + 1] !== '(') {
+      out += text.slice(cursor, labelStart + 1);
+      cursor = labelStart + 1;
+      continue;
+    }
+    const urlEnd = text.indexOf(')', labelEnd + 2);
+    if (urlEnd < 0) break;
+    out += text.slice(cursor, labelStart);
+    out += `<${text.slice(labelEnd + 2, urlEnd)}|${text.slice(labelStart + 1, labelEnd)}>`;
+    cursor = urlEnd + 1;
+  }
+  return out + text.slice(cursor);
+}
+
+/** 按 Slack section mrkdwn 上限切分（尽量在换行/空格处断开） */
+export function splitMrkdwnText(text: string, maxLen = SLACK_MRKDWN_TEXT_MAX): string[] {
+  if (text.length <= maxLen) return [text];
+  const chunks: string[] = [];
+  let rest = text;
+  while (rest.length > maxLen) {
+    let cut = rest.lastIndexOf('\n', maxLen);
+    if (cut < maxLen * 0.4) cut = rest.lastIndexOf(' ', maxLen);
+    if (cut <= 0) cut = maxLen;
+    chunks.push(rest.slice(0, cut).trimEnd());
+    rest = rest.slice(cut).trimStart();
+  }
+  if (rest) chunks.push(rest);
+  return chunks.length > 0 ? chunks : [text];
+}
+
+/** 通知栏 / 无障碍 fallback 用的纯文本 */
+export function mrkdwnToPlainFallback(text: string): string {
+  return stripMrkdwnMarkers(stripAngleBrackets(rewriteAngleLinks(text)));
+}
+
+/**
+ * `<url|text>` → `text (url)`。
+ * 线性扫描，语义等价于 `/<([^|>]+)\|([^>]+)>/g`（分组一不含 `|`，
+ * 因此切分点恒为首个 `|`），但避免量词重叠在超长 `<...` 输入上的
+ * 二次方回溯（js/polynomial-redos）。
+ */
+function rewriteAngleLinks(text: string): string {
+  let out = '';
+  let i = 0;
+  while (i < text.length) {
+    const open = text.indexOf('<', i);
+    if (open < 0) break;
+    const close = text.indexOf('>', open + 1);
+    if (close < 0) break;
+    const inner = text.slice(open + 1, close);
+    const pipe = inner.indexOf('|');
+    if (pipe > 0 && pipe < inner.length - 1) {
+      out += text.slice(i, open);
+      out += `${inner.slice(pipe + 1)} (${inner.slice(0, pipe)})`;
+      i = close + 1;
+      continue;
+    }
+    // 非链接形态：本趟不匹配，原样保留 `<` 并继续（与原正则行为一致）。
+    out += text.slice(i, open + 1);
+    i = open + 1;
+  }
+  return out + text.slice(i);
+}
+
+/**
+ * 剥掉剩余 `<...>` 的尖括号。线性扫描，等价于 `/<([^>]+)>/g`
+ * （空内容 `<>` 不匹配、原样保留）。
+ */
+function stripAngleBrackets(text: string): string {
+  let out = '';
+  let i = 0;
+  while (i < text.length) {
+    const open = text.indexOf('<', i);
+    if (open < 0) break;
+    const close = text.indexOf('>', open + 1);
+    if (close < 0) break;
+    if (close === open + 1) {
+      out += text.slice(i, open + 1);
+      i = open + 1;
+      continue;
+    }
+    out += text.slice(i, open);
+    out += text.slice(open + 1, close);
+    i = close + 1;
+  }
+  return out + text.slice(i);
+}
+
+/** 去掉 `*` `_` `~` `` ` `` 样式符号（等价于 `/[*_~`]/g`，逐字符线性）。 */
+function stripMrkdwnMarkers(text: string): string {
+  let out = '';
+  for (const ch of text) {
+    if (ch !== '*' && ch !== '_' && ch !== '~' && ch !== '`') out += ch;
+  }
+  return out;
+}

package/src/mrkdwn-to-markdown.ts

@@ -0,0 +1,29 @@
+/**
+ * Slack mrkdwn → 通用 Markdown（入站文本段）
+ */
+export function mrkdwnToMarkdown(text: string): string {
+  let result = replaceSlackLinks(text);
+  result = result.replace(/\*([^*]+)\*/g, '**$1**');
+  result = result.replace(/_([^_]+)_/g, '*$1*');
+  result = result.replace(/~([^~]+)~/g, '~~$1~~');
+  return result;
+}
+
+function replaceSlackLinks(text: string): string {
+  let out = '';
+  let cursor = 0;
+  while (cursor < text.length) {
+    const start = text.indexOf('<', cursor);
+    if (start < 0) break;
+    const end = text.indexOf('>', start + 1);
+    if (end < 0) break;
+    out += text.slice(cursor, start);
+    const body = text.slice(start + 1, end);
+    const sep = body.indexOf('|');
+    const url = sep >= 0 ? body.slice(0, sep) : body;
+    const label = sep >= 0 ? body.slice(sep + 1) : url;
+    out += url.startsWith('http://') || url.startsWith('https://') ? `[${label}](${url})` : text.slice(start, end + 1);
+    cursor = end + 1;
+  }
+  return out + text.slice(cursor);
+}

package/src/platform-permit.ts

@@ -0,0 +1,59 @@
+/**
+ * Slack platform permit — workspace + channel 权限
+ */
+import type { PermissionSubject } from '@zhin.js/permission';
+
+const ADAPTER = 'slack';
+
+export function platformPermit(perm: string): string {
+  return `platform(${ADAPTER},${perm})`;
+}
+
+const FACTORY_PERM_MAP: Record<string, string> = {
+  scene_admin: 'channel_manager',
+  scene_owner: 'workspace_owner',
+};
+
+export function slackGroupPermitResolver(logicalPerm: string): string {
+  return platformPermit(FACTORY_PERM_MAP[logicalPerm] ?? logicalPerm);
+}
+
+export function normalizeSlackSenderForPermit(input: {
+  isWorkspaceOwner?: boolean;
+  isWorkspaceAdmin?: boolean;
+  isChannelManager?: boolean;
+}): { role?: string; permissions?: string[] } {
+  const permissions: string[] = [];
+  if (input.isWorkspaceOwner) {
+    permissions.push('workspace_owner', 'workspace_admin', 'channel_manager');
+    return { role: 'owner', permissions };
+  }
+  if (input.isWorkspaceAdmin) {
+    permissions.push('workspace_admin', 'channel_manager');
+    return { role: 'admin', permissions };
+  }
+  if (input.isChannelManager) {
+    permissions.push('channel_manager');
+    return { role: 'channel_admin', permissions };
+  }
+  return { role: 'member', permissions };
+}
+
+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) {
+    case 'workspace_owner':
+      return role === 'owner' || has('workspace_owner');
+    case 'workspace_admin':
+      return role === 'owner' || role === 'admin' || has('workspace_admin') || has('workspace_owner');
+    case 'channel_manager':
+      return role === 'owner' || role === 'admin' || role === 'channel_admin'
+        || has('channel_manager') || has('workspace_admin') || has('workspace_owner');
+    default:
+      return false;
+  }
+}
+