@zhin.js/adapter-slack 4.0.1 → 4.1.1

package/lib/index.d.ts

@@ -1,10 +1,11 @@
-import { SlackAdapter } from "./adapter.js";
-declare module "zhin.js" {
-    interface Adapters {
-        slack: SlackAdapter;
-    }
-}
-export * from "./types.js";
-export { SlackEndpoint } from "./endpoint.js";
-export { SlackAdapter } from "./adapter.js";
-//# sourceMappingURL=index.d.ts.map
+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';
+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/lib/index.js

@@ -1,252 +1,11 @@
-/**
- * Slack 适配器入口：类型扩展、导出、注册
- */
-import { usePlugin, createSceneManagementTools } from "zhin.js";
-import { SlackAdapter } from "./adapter.js";
-import { platformPermit, registerSlackPlatformPermitChecker, slackGroupPermitResolver, } from "./platform-permit.js";
-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) => {
-        const adapter = new SlackAdapter(p);
-        await adapter.start();
-        return adapter;
-    },
-    dispose: async (adapter) => {
-        await adapter.stop();
-    },
-});
-useContext('tool', 'slack', (toolService, slack) => {
-    const disposers = [];
-    disposers.push(registerSlackPlatformPermitChecker());
-    const sceneTools = createSceneManagementTools(slack, 'slack', { permitResolver: slackGroupPermitResolver, registerChecker: false });
-    disposers.push(...sceneTools.map(t => toolService.addTool(t, plugin.name)));
-    function getEndpoint(endpointId) {
-        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) => {
-            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) => {
-            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) => {
-            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) => {
-            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) => {
-            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) => {
-            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) => {
-            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) => {
-            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) => {
-            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) => {
-            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());
-});
-//# sourceMappingURL=index.js.map
+export { formatInboundContent, formatInteractionContent, formatOutboundWire, formatSlashContent, headerValue, inboundMessageId, keyboardToBlockKitBlocks, normalizeWebhookPath, readTextBody, resolveSlackChannelType, resolveSlackConfig, 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 { 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/lib/markdown-to-mrkdwn.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 常见 Markdown → Slack mrkdwn（Slack 粗体为 *text*，链接为 <url|text>）
+ */
+export declare const SLACK_MRKDWN_TEXT_MAX = 2900;
+export declare function markdownToMrkdwn(text: string): string;
+/** 按 Slack section mrkdwn 上限切分（尽量在换行/空格处断开） */
+export declare function splitMrkdwnText(text: string, maxLen?: number): string[];
+/** 通知栏 / 无障碍 fallback 用的纯文本 */
+export declare function mrkdwnToPlainFallback(text: string): string;

package/lib/markdown-to-mrkdwn.js

@@ -0,0 +1,121 @@
+/**
+ * 常见 Markdown → Slack mrkdwn（Slack 粗体为 *text*，链接为 <url|text>）
+ */
+export const SLACK_MRKDWN_TEXT_MAX = 2900;
+export function markdownToMrkdwn(text) {
+    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) {
+    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, maxLen = SLACK_MRKDWN_TEXT_MAX) {
+    if (text.length <= maxLen)
+        return [text];
+    const chunks = [];
+    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) {
+    return stripMrkdwnMarkers(stripAngleBrackets(rewriteAngleLinks(text)));
+}
+/**
+ * `<url|text>` → `text (url)`。
+ * 线性扫描，语义等价于 `/<([^|>]+)\|([^>]+)>/g`（分组一不含 `|`，
+ * 因此切分点恒为首个 `|`），但避免量词重叠在超长 `<...` 输入上的
+ * 二次方回溯（js/polynomial-redos）。
+ */
+function rewriteAngleLinks(text) {
+    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) {
+    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) {
+    let out = '';
+    for (const ch of text) {
+        if (ch !== '*' && ch !== '_' && ch !== '~' && ch !== '`')
+            out += ch;
+    }
+    return out;
+}

package/lib/mrkdwn-to-markdown.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Slack mrkdwn → 通用 Markdown（入站文本段）
+ */
+export declare function mrkdwnToMarkdown(text: string): string;

package/lib/mrkdwn-to-markdown.js

@@ -0,0 +1,30 @@
+/**
+ * Slack mrkdwn → 通用 Markdown（入站文本段）
+ */
+export function mrkdwnToMarkdown(text) {
+    let result = replaceSlackLinks(text);
+    result = result.replace(/\*([^*]+)\*/g, '**$1**');
+    result = result.replace(/_([^_]+)_/g, '*$1*');
+    result = result.replace(/~([^~]+)~/g, '~~$1~~');
+    return result;
+}
+function replaceSlackLinks(text) {
+    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/lib/platform-permit.d.ts

@@ -1,7 +1,7 @@
 /**
  * Slack platform permit — workspace + channel 权限
  */
-import type { Message } from 'zhin.js';
+import { type Message } from '@zhin.js/core';
 export declare function platformPermit(perm: string): string;
 export declare function slackGroupPermitResolver(logicalPerm: string): string;
 export declare function normalizeSlackSenderForPermit(input: {
@@ -14,4 +14,3 @@ export declare function normalizeSlackSenderForPermit(input: {
 };
 export declare function checkSlackPlatformPermit(perm: string, message: Message<any>): boolean;
 export declare function registerSlackPlatformPermitChecker(): () => void;
-//# sourceMappingURL=platform-permit.d.ts.map

package/lib/platform-permit.js

@@ -1,4 +1,7 @@
-import { registerPlatformPermitChecker } from 'zhin.js';
+/**
+ * Slack platform permit — workspace + channel 权限
+ */
+import { registerPlatformPermitChecker } from '@zhin.js/core';
 const ADAPTER = 'slack';
 export function platformPermit(perm) {
     return `platform(${ADAPTER},${perm})`;
@@ -46,4 +49,3 @@ export function checkSlackPlatformPermit(perm, message) {
 export function registerSlackPlatformPermitChecker() {
     return registerPlatformPermitChecker(ADAPTER, checkSlackPlatformPermit);
 }
-//# sourceMappingURL=platform-permit.js.map

package/lib/protocol.d.ts

@@ -0,0 +1,143 @@
+import type { IncomingMessage } from 'node:http';
+/** Plugin Runtime owner config (`plugins.<instanceKey>` / schema.json). */
+export interface SlackAdapterConfig {
+    readonly name?: 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';
+    readonly name: string;
+    readonly token: string;
+    readonly mode: 'socket' | 'http';
+    readonly signingSecret: string;
+    readonly appToken?: string;
+    readonly webhookPath: string;
+    readonly clientPingTimeout: number;
+}
+export interface SlackEventEnvelope {
+    readonly token?: string;
+    readonly team_id?: string;
+    readonly api_app_id?: string;
+    readonly event: SlackEvent;
+    readonly type: 'event_callback';
+    readonly event_id?: string;
+    readonly event_time?: number;
+}
+export interface SlackUrlVerification {
+    readonly type: 'url_verification';
+    readonly token: string;
+    readonly challenge: string;
+}
+export interface SlackInteractionPayload {
+    readonly type: 'block_actions' | 'message_action' | 'shortcut' | 'view_submission' | 'view_closed';
+    readonly trigger_id?: string;
+    readonly user: {
+        id: string;
+        username?: string;
+        name?: string;
+        team_id?: string;
+    };
+    readonly channel?: {
+        id: string;
+        name?: string;
+    };
+    readonly message?: {
+        ts: string;
+        text?: string;
+        [key: string]: unknown;
+    };
+    readonly actions?: SlackBlockAction[];
+    readonly response_url?: string;
+    readonly [key: string]: unknown;
+}
+export interface SlackBlockAction {
+    readonly type: string;
+    readonly action_id: string;
+    readonly block_id: string;
+    readonly value?: string;
+    readonly text?: {
+        type: string;
+        text: string;
+    };
+    readonly action_ts?: string;
+    readonly [key: string]: unknown;
+}
+export interface SlackSlashCommand {
+    readonly token: string;
+    readonly team_id: string;
+    readonly channel_id: string;
+    readonly channel_name: string;
+    readonly user_id: string;
+    readonly user_name: string;
+    readonly command: string;
+    readonly text: string;
+    readonly response_url: string;
+    readonly trigger_id: string;
+    readonly api_app_id?: string;
+}
+export interface SlackEvent {
+    readonly type: string;
+    readonly ts?: string;
+    readonly event_ts?: string;
+    readonly user?: string;
+    readonly channel?: string;
+    readonly channel_type?: string;
+    readonly text?: string;
+    readonly thread_ts?: string;
+    readonly subtype?: string;
+    readonly bot_id?: string;
+    readonly [key: string]: unknown;
+}
+export type SlackMessageEvent = SlackEvent & {
+    readonly type: 'message' | 'app_mention';
+    readonly ts: string;
+    readonly channel: string;
+};
+export interface SlackWireSegment {
+    readonly type: string;
+    readonly data?: Record<string, unknown>;
+}
+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';
+/** 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.
+ */
+export declare function formatOutboundWire(payload: unknown): {
+    text: string;
+    blocks: Record<string, unknown>[];
+    attachments: Record<string, unknown>[];
+    files: Array<{
+        buffer?: Buffer;
+        url?: string;
+        path?: string;
+        name?: string;
+    }>;
+};
+export declare function keyboardToBlockKitBlocks(data: Record<string, unknown>): Record<string, unknown>[];
+export declare function verifySlackSignature(signingSecret: string, rawBody: string, timestamp: string, signature: string): boolean;
+export declare function readTextBody(request: IncomingMessage, options?: {
+    readonly limit?: number;
+}): Promise<string>;
+export declare function headerValue(headers: IncomingMessage['headers'], name: string): string;