@zhin.js/adapter-slack 1.0.78 → 1.1.2

package/agents/slack/skills/slack-channels/tools/unarchive/index.js

@@ -0,0 +1,19 @@
+// 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'),
+    }),
+    adapter: 'slack',
+    tags: ['slack'],
+    permissions: [platformPermission('slack', 'workspace_admin')],
+    async execute({ channel_id }, context) {
+        const client = context.$client;
+        await client.conversations.unarchive({ channel: channel_id });
+        const success = true;
+        return { success, message: success ? '频道已恢复' : '操作失败' };
+    },
+});

package/agents/slack/skills/slack-channels/tools/unarchive/index.ts

@@ -0,0 +1,21 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { platformPermission } from '@zhin.js/permission';
+
+export default defineAgentTool<{
+  channel_id: string;
+}>({
+  description: '恢复已归档的 Slack 频道',
+  inputSchema: z.object({
+    channel_id: z.string().describe('频道 ID'),
+  }),
+  adapter: 'slack',
+  tags: ['slack'],
+  permissions: [platformPermission('slack', 'workspace_admin')],
+  async execute({ channel_id }, context) {
+    const client = context.$client;
+    await client.conversations.unarchive({ channel: channel_id });
+    const success = true;
+    return { success, message: success ? '频道已恢复' : '操作失败' };
+  },
+});

package/agents/slack/skills/slack-channels/tools/user_info/index.js

@@ -0,0 +1,27 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '查询 Slack 用户详细信息',
+    inputSchema: z.object({
+        user_id: z.string().describe('用户 ID'),
+    }),
+    adapter: 'slack',
+    tags: ['slack'],
+    async execute({ user_id }, context) {
+        const client = context.$client;
+        const user = (await client.users.info({ user: user_id })).user;
+        if (!user)
+            throw new Error(`Slack 用户不存在: ${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,
+        };
+    },
+});

package/agents/slack/skills/slack-channels/tools/user_info/index.ts

@@ -0,0 +1,29 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import type { SlackUserInfo } from '@zhin.js/adapter-slack';
+
+export default defineAgentTool<{
+  user_id: string;
+}>({
+  description: '查询 Slack 用户详细信息',
+  inputSchema: z.object({
+    user_id: z.string().describe('用户 ID'),
+  }),
+  adapter: 'slack',
+  tags: ['slack'],
+  async execute({ user_id }, context) {
+    const client = context.$client;
+    const user = (await client.users.info({ user: user_id })).user as SlackUserInfo | undefined;
+    if (!user) throw new Error(`Slack 用户不存在: ${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,
+    };
+  },
+});

package/agents/slack/skills/slack-messages/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: slack-messages
+platforms:
+  - slack
+description: Slack 消息编辑、置顶和 reaction 管理能力。
+keywords:
+  - "slack"
+  - "message"
+  - "pin"
+  - "reaction"
+  - "edit"
+tools:
+  - "pin_message"
+  - "unpin_message"
+  - "add_reaction"
+  - "remove_reaction"
+  - "edit_message"
+---
+
+# slack-messages
+
+使用稳定频道 ID 与消息时间戳。编辑、置顶和 reaction 变更均遵守 Tool 审批。

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

@@ -0,0 +1,27 @@
+// 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: z.string().describe('频道 ID'),
+        timestamp: z.string().describe('消息时间戳'),
+        emoji: z.string().describe('表情名称（不含冒号）'),
+    }),
+    adapter: 'slack',
+    tags: ['slack'],
+    async execute({ channel, timestamp, emoji }, context) {
+        const client = context.$client;
+        const name = normalizeSlackReactionName(emoji);
+        try {
+            await client.reactions.add({ channel, timestamp, name });
+        }
+        catch (error) {
+            if (error?.data?.error !== 'already_reacted')
+                throw error;
+        }
+        const success = true;
+        return { success, message: success ? `已添加反应 :${emoji}:` : '操作失败' };
+    },
+});

package/agents/slack/skills/slack-messages/tools/add_reaction/index.ts

@@ -0,0 +1,29 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { normalizeSlackReactionName } from '@zhin.js/adapter-slack';
+
+export default defineAgentTool<{
+  channel: string;
+  timestamp: string;
+  emoji: string;
+}>({
+  description: '给 Slack 消息添加表情反应',
+  inputSchema: z.object({
+    channel: z.string().describe('频道 ID'),
+    timestamp: z.string().describe('消息时间戳'),
+    emoji: z.string().describe('表情名称（不含冒号）'),
+  }),
+  adapter: 'slack',
+  tags: ['slack'],
+  async execute({ channel, timestamp, emoji }, context) {
+    const client = context.$client;
+    const name = normalizeSlackReactionName(emoji);
+    try {
+      await client.reactions.add({ channel, timestamp, name });
+    } catch (error) {
+      if ((error as { data?: { error?: string } })?.data?.error !== 'already_reacted') throw error;
+    }
+    const success = true;
+    return { success, message: success ? `已添加反应 :${emoji}:` : '操作失败' };
+  },
+});

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

@@ -0,0 +1,21 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { editSlackContent } from '@zhin.js/adapter-slack';
+export default defineAgentTool({
+    description: '编辑 Slack 消息',
+    inputSchema: z.object({
+        channel: z.string().describe('频道 ID'),
+        message_ts: z.string().describe('消息时间戳'),
+        text: z.string().describe('新的消息文本'),
+    }),
+    adapter: 'slack',
+    tags: ['slack'],
+    async execute({ channel, message_ts, text }, context) {
+        const client = context.$client;
+        await editSlackContent(client, channel, message_ts, [
+            { type: 'text', data: { text } },
+        ]);
+        return { success: true, message: '消息已编辑' };
+    },
+});

package/agents/slack/skills/slack-messages/tools/edit_message/index.ts

@@ -0,0 +1,25 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { editSlackContent } from '@zhin.js/adapter-slack';
+
+export default defineAgentTool<{
+  channel: string;
+  message_ts: string;
+  text: string;
+}>({
+  description: '编辑 Slack 消息',
+  inputSchema: z.object({
+    channel: z.string().describe('频道 ID'),
+    message_ts: z.string().describe('消息时间戳'),
+    text: z.string().describe('新的消息文本'),
+  }),
+  adapter: 'slack',
+  tags: ['slack'],
+  async execute({ channel, message_ts, text }, context) {
+    const client = context.$client;
+    await editSlackContent(client, channel, message_ts, [
+      { type: 'text', data: { text } },
+    ]);
+    return { success: true, message: '消息已编辑' };
+  },
+});

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/agents/slack/skills/slack-messages/tools/pin_message/index.ts

@@ -0,0 +1,23 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { platformPermission } from '@zhin.js/permission';
+
+export default defineAgentTool<{
+  channel: string;
+  timestamp: string;
+}>({
+  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/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/agents/slack/skills/slack-messages/tools/remove_reaction/index.ts

@@ -0,0 +1,32 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { normalizeSlackReactionName } from '@zhin.js/adapter-slack';
+
+export default defineAgentTool<{
+  channel_id: string;
+  timestamp: string;
+  name: string;
+}>({
+  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 as { data?: { error?: string } })?.data?.error !== 'no_reaction') throw error;
+    }
+    const success = true;
+    return { success, message: success ? `已移除反应 :${name}:` : '操作失败' };
+  },
+});

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/agents/slack/skills/slack-messages/tools/unpin_message/index.ts

@@ -0,0 +1,23 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+import { platformPermission } from '@zhin.js/permission';
+
+export default defineAgentTool<{
+  channel_id: string;
+  timestamp: string;
+}>({
+  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/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/slack/endpoint/add/[id]/index.js

@@ -0,0 +1,3 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+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/commands/slack/endpoint/definition.js

@@ -0,0 +1,19 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+/**
+ * `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 "../../../lib/slack-runtime-state.js";
+export const slackEndpointCommands = createEndpointCommands({
+    adapterKey: 'slack',
+    adapterDisplayName: 'Slack',
+    fields: [
+        { key: 'token', required: true, env: true, description: 'Bot User OAuth Token（xoxb-...）' },
+        { key: 'signingSecret', env: true, description: '签名密钥（HTTP Events，socketMode: false 必填）' },
+        { key: 'appToken', env: true, description: 'App-Level Token（xapp-...，Socket Mode）' },
+    ],
+    running: (use) => use(slackRuntimeStateToken).endpoints.values(),
+    describeEntry: (entry) => `token: ${String(entry.token)}`,
+}, defineCommand);

package/commands/slack/endpoint/definition.ts

@@ -0,0 +1,19 @@
+/**
+ * `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 '../../../src/slack-runtime-state.js';
+
+export const slackEndpointCommands = createEndpointCommands({
+  adapterKey: 'slack',
+  adapterDisplayName: 'Slack',
+  fields: [
+    { key: 'token', required: true, env: true, description: 'Bot User OAuth Token（xoxb-...）' },
+    { key: 'signingSecret', env: true, description: '签名密钥（HTTP Events，socketMode: false 必填）' },
+    { key: 'appToken', env: true, description: 'App-Level Token（xapp-...，Socket Mode）' },
+  ],
+  running: (use) => use(slackRuntimeStateToken).endpoints.values(),
+  describeEntry: (entry) => `token: ${String(entry.token)}`,
+}, defineCommand);

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

@@ -0,0 +1,3 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+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/slack/endpoint/remove/[id]/index.js

@@ -0,0 +1,3 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+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/client.d.ts

@@ -0,0 +1,25 @@
+import type { SlackWebClientLike } from './endpoint.js';
+import type { SlackEvent } from './protocol.js';
+/** Slack users.info response fields projected by the bundled tools. */
+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 type SlackClientEventMap = Record<string, SlackEvent>;
+declare module '@zhin.js/feature-kit' {
+    interface AdapterClientRegistry {
+        readonly slack: {
+            readonly client: SlackWebClientLike;
+            readonly events: SlackClientEventMap;
+        };
+    }
+}
+export declare const slackClient: import("@zhin.js/adapter").EndpointClientToken<SlackWebClientLike, SlackClientEventMap>;

package/lib/client.js

@@ -0,0 +1,2 @@
+import { defineEndpointClient } from 'zhin.js/adapter';
+export const slackClient = defineEndpointClient('slack');

package/lib/endpoint.d.ts

@@ -0,0 +1,153 @@
+import { Endpoint } from 'zhin.js/adapter';
+import type { EndpointControl, EndpointManagement, EndpointSendRequest } from 'zhin.js/adapter';
+import type { HttpHost } from '@zhin.js/host-http';
+import type { CapabilityId } from 'zhin.js';
+import { type ResolvedSlackConfig, type SlackEvent, type SlackInteractionPayload, type SlackMessageEvent, type SlackSlashCommand } from './protocol.js';
+import { type SlackChatClient } from './slack-outbound.js';
+import { type SlackWebhookHandler } from './webhook.js';
+export interface SlackSocketLike {
+    on(event: string, handler: (args: {
+        ack: () => Promise<void>;
+        body: unknown;
+    }) => void | Promise<void>): void;
+    start(): Promise<void>;
+    disconnect(): Promise<void>;
+}
+export interface SlackWebClientLike extends SlackChatClient {
+    auth: {
+        test(): Promise<{
+            user_id?: string;
+            user?: string;
+        }>;
+    };
+    conversations: {
+        invite(opts: {
+            channel: string;
+            users: string;
+        }): Promise<unknown>;
+        kick(opts: {
+            channel: string;
+            user: string;
+        }): Promise<unknown>;
+        setTopic(opts: {
+            channel: string;
+            topic: string;
+        }): Promise<unknown>;
+        setPurpose(opts: {
+            channel: string;
+            purpose: string;
+        }): Promise<unknown>;
+        archive(opts: {
+            channel: string;
+        }): Promise<unknown>;
+        unarchive(opts: {
+            channel: string;
+        }): Promise<unknown>;
+        rename(opts: {
+            channel: string;
+            name: string;
+        }): Promise<unknown>;
+        members(opts: {
+            channel: string;
+        }): Promise<{
+            members?: string[];
+        }>;
+        info(opts: {
+            channel: string;
+        }): Promise<{
+            channel?: unknown;
+        }>;
+        list(opts?: {
+            types?: string;
+            limit?: number;
+            cursor?: string;
+            exclude_archived?: boolean;
+        }): Promise<{
+            channels?: unknown[];
+            response_metadata?: {
+                next_cursor?: string;
+            };
+        }>;
+    };
+    users: {
+        info(opts: {
+            user: string;
+        }): Promise<{
+            user?: unknown;
+        }>;
+        list(opts?: {
+            limit?: number;
+            cursor?: string;
+        }): Promise<{
+            members?: unknown[];
+            response_metadata?: {
+                next_cursor?: string;
+            };
+        }>;
+    };
+    reactions: {
+        add(opts: {
+            channel: string;
+            timestamp: string;
+            name: string;
+        }): Promise<unknown>;
+        remove(opts: {
+            channel: string;
+            timestamp: string;
+            name: string;
+        }): Promise<unknown>;
+    };
+    pins: {
+        add(opts: {
+            channel: string;
+            timestamp: string;
+        }): Promise<unknown>;
+        remove(opts: {
+            channel: string;
+            timestamp: string;
+        }): Promise<unknown>;
+    };
+    chat: SlackChatClient['chat'] & {
+        delete(opts: {
+            channel: string;
+            ts: string;
+        }): Promise<unknown>;
+    };
+}
+export interface SlackEndpointOptions {
+    readonly id: CapabilityId;
+    readonly config: ResolvedSlackConfig;
+    readonly http?: HttpHost;
+    readonly createClient?: (token: string) => SlackWebClientLike;
+    readonly createSocket?: (opts: {
+        readonly appToken: string;
+        readonly clientPingTimeout: number;
+    }) => SlackSocketLike;
+}
+export declare class SlackEndpoint extends Endpoint<SlackWebClientLike> implements SlackWebhookHandler {
+    #private;
+    readonly management: EndpointManagement;
+    readonly control: EndpointControl;
+    constructor(options: SlackEndpointOptions);
+    /** Console 展示 / AdapterIndex live name（多 endpoint 时与 entry name 一致）。 */
+    get name(): string;
+    get client(): SlackWebClientLike;
+    get platformUserId(): string | undefined;
+    get config(): ResolvedSlackConfig;
+    start(): Promise<void>;
+    open(): void;
+    close(): void;
+    stop(): Promise<void>;
+    send({ conversation, payload }: EndpointSendRequest): Promise<string>;
+    /** Test / internal: admit a message event when open. */
+    admit(event: SlackMessageEvent | SlackEvent): void;
+    admitInteraction(payload: SlackInteractionPayload): void;
+    admitSlashCommand(cmd: SlackSlashCommand): void;
+    handleEnvelope(body: unknown): void;
+    trackMessageChannel(ts: string, channel: string): void;
+    resolveMessageRef(messageId: string, channelHint?: string): {
+        channel: string;
+        ts: string;
+    } | null;
+    recallMessage(messageId: string): Promise<void>;
+}