@zhin.js/adapter-slack 4.0.1 → 4.1.1

package/src/index.ts

@@ -1,280 +1,68 @@
-/**
- * Slack 适配器入口：类型扩展、导出、注册
- */
-import { usePlugin, type Plugin, type ISceneManagement, createSceneManagementTools, type ToolFeature } from "zhin.js";
-import { SlackAdapter } from "./adapter.js";
-import {
+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 {
+  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";
-
-declare module "zhin.js" {
-  interface Adapters {
-    slack: SlackAdapter;
-  }
-}
-
-export * from "./types.js";
-export { SlackEndpoint } from "./endpoint.js";
-export { SlackAdapter } from "./adapter.js";
-
-const plugin = usePlugin();
-const { provide, useContext } = plugin;
-
-provide({
-  name: "slack",
-  description: "Slack Endpoint 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 disposers: (() => void)[] = [];
-  disposers.push(registerSlackPlatformPermitChecker());
-  const sceneTools = createSceneManagementTools(
-    slack as unknown as ISceneManagement,
-    'slack',
-    { permitResolver: slackGroupPermitResolver, registerChecker: false },
-  );
-  disposers.push(...sceneTools.map(t => toolService.addTool(t, plugin.name)));
-
-  function getEndpoint(endpointId: string) {
-    const endpoint = slack.endpoints.get(endpointId);
-    if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
-    return endpoint;
-  }
-
-  disposers.push(toolService.addTool({
-    name: 'slack_invite_to_channel',
-    description: '邀请用户加入 Slack 频道',
-    parameters: {
-      type: 'object',
-      properties: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        channel: { type: 'string', description: '频道 ID' },
-        users: { type: 'string', description: '用户 ID 列表（逗号分隔）' },
-      },
-      required: ['endpoint_id', 'channel', 'users'],
-    },
-    platforms: ['slack'],
-    tags: ['slack'],
-    permissions: [platformPermit('channel_manager')],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = getEndpoint(args.endpoint_id);
-      const success = await endpoint.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: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        channel: { type: 'string', description: '频道 ID' },
-        topic: { type: 'string', description: '新话题' },
-      },
-      required: ['endpoint_id', 'channel', 'topic'],
-    },
-    platforms: ['slack'],
-    tags: ['slack'],
-    permissions: [platformPermit('channel_manager')],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = getEndpoint(args.endpoint_id);
-      const success = await endpoint.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: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        channel: { type: 'string', description: '频道 ID' },
-      },
-      required: ['endpoint_id', 'channel'],
-    },
-    platforms: ['slack'],
-    tags: ['slack'],
-    permissions: [platformPermit('workspace_admin')],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = getEndpoint(args.endpoint_id);
-      const success = await endpoint.archiveChannel(args.channel);
-      return { success, message: success ? '已归档频道' : '操作失败' };
-    },
-  }, plugin.name));
-
-  disposers.push(toolService.addTool({
-    name: 'slack_pin_message',
-    description: '置顶 Slack 消息',
-    parameters: {
-      type: 'object',
-      properties: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        channel: { type: 'string', description: '频道 ID' },
-        timestamp: { type: 'string', description: '消息时间戳' },
-      },
-      required: ['endpoint_id', 'channel', 'timestamp'],
-    },
-    platforms: ['slack'],
-    tags: ['slack'],
-    permissions: [platformPermit('channel_manager')],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = getEndpoint(args.endpoint_id);
-      const success = await endpoint.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: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        channel: { type: 'string', description: '频道 ID' },
-        timestamp: { type: 'string', description: '消息时间戳' },
-        emoji: { type: 'string', description: '表情名称（不含冒号）' },
-      },
-      required: ['endpoint_id', 'channel', 'timestamp', 'emoji'],
-    },
-    platforms: ['slack'],
-    tags: ['slack'],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = getEndpoint(args.endpoint_id);
-      const success = await endpoint.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: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        channel_id: { type: 'string', description: '频道 ID' },
-        timestamp: { type: 'string', description: '消息时间戳' },
-        name: { type: 'string', description: '表情名称（如 thumbsup、heart）' },
-      },
-      required: ['endpoint_id', 'channel_id', 'timestamp', 'name'],
-    },
-    platforms: ['slack'],
-    tags: ['slack'],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = getEndpoint(args.endpoint_id);
-      const success = await endpoint.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: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        channel_id: { type: 'string', description: '频道 ID' },
-        timestamp: { type: 'string', description: '消息时间戳' },
-      },
-      required: ['endpoint_id', 'channel_id', 'timestamp'],
-    },
-    platforms: ['slack'],
-    tags: ['slack'],
-    permissions: [platformPermit('channel_manager')],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = getEndpoint(args.endpoint_id);
-      const success = await endpoint.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: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        user_id: { type: 'string', description: '用户 ID' },
-      },
-      required: ['endpoint_id', 'user_id'],
-    },
-    platforms: ['slack'],
-    tags: ['slack'],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = getEndpoint(args.endpoint_id);
-      const user = await endpoint.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: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        channel_id: { type: 'string', description: '频道 ID' },
-        purpose: { type: 'string', description: '频道用途描述' },
-      },
-      required: ['endpoint_id', 'channel_id', 'purpose'],
-    },
-    platforms: ['slack'],
-    tags: ['slack'],
-    permissions: [platformPermit('channel_manager')],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = getEndpoint(args.endpoint_id);
-      const success = await endpoint.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: {
-        endpoint_id: { type: 'string', description: 'Endpoint 名称', contextKey: 'endpointId' },
-        channel_id: { type: 'string', description: '频道 ID' },
-      },
-      required: ['endpoint_id', 'channel_id'],
-    },
-    platforms: ['slack'],
-    tags: ['slack'],
-    permissions: [platformPermit('workspace_admin')],
-    execute: async (args: Record<string, any>) => {
-      const endpoint = getEndpoint(args.endpoint_id);
-      const success = await endpoint.unarchiveChannel(args.channel_id);
-      return { success, message: success ? '频道已恢复' : '操作失败' };
-    },
-  }, plugin.name));
-
-  return () => disposers.forEach(d => d());
-});
+} 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';
+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

@@ -1,8 +1,7 @@
 /**
  * Slack platform permit — workspace + channel 权限
  */
-import type { Message } from 'zhin.js';
-import { registerPlatformPermitChecker } from 'zhin.js';
+import { registerPlatformPermitChecker, type Message } from '@zhin.js/core';
 
 const ADAPTER = 'slack';