integrate-sdk 0.8.28 → 0.8.30-dev.0

package/dist/src/integrations/slack-client.d.ts

@@ -0,0 +1,271 @@
+/**
+ * Slack Integration Client Types
+ * Fully typed interface for Slack integration methods
+ */
+import type { MCPToolCallResponse } from "../protocol/messages.js";
+/**
+ * Slack Channel
+ */
+export interface SlackChannel {
+    id: string;
+    name: string;
+    is_channel: boolean;
+    is_group: boolean;
+    is_im: boolean;
+    is_mpim: boolean;
+    is_private: boolean;
+    created: number;
+    creator: string;
+    is_archived: boolean;
+    is_general: boolean;
+    name_normalized: string;
+    is_member: boolean;
+    topic?: {
+        value: string;
+        creator: string;
+        last_set: number;
+    };
+    purpose?: {
+        value: string;
+        creator: string;
+        last_set: number;
+    };
+    num_members?: number;
+}
+/**
+ * Slack User
+ */
+export interface SlackUser {
+    id: string;
+    team_id: string;
+    name: string;
+    deleted: boolean;
+    real_name?: string;
+    tz?: string;
+    tz_label?: string;
+    tz_offset?: number;
+    profile: {
+        avatar_hash?: string;
+        status_text?: string;
+        status_emoji?: string;
+        real_name?: string;
+        display_name?: string;
+        email?: string;
+        image_24?: string;
+        image_32?: string;
+        image_48?: string;
+        image_72?: string;
+        image_192?: string;
+        image_512?: string;
+    };
+    is_admin?: boolean;
+    is_owner?: boolean;
+    is_primary_owner?: boolean;
+    is_bot?: boolean;
+    updated?: number;
+}
+/**
+ * Slack Message
+ */
+export interface SlackMessage {
+    type: string;
+    user?: string;
+    text: string;
+    ts: string;
+    thread_ts?: string;
+    reply_count?: number;
+    reply_users_count?: number;
+    latest_reply?: string;
+    reactions?: Array<{
+        name: string;
+        count: number;
+        users: string[];
+    }>;
+    attachments?: Array<Record<string, unknown>>;
+    blocks?: Array<Record<string, unknown>>;
+}
+/**
+ * Slack Integration Client Interface
+ * Provides type-safe methods for all Slack operations
+ */
+export interface SlackIntegrationClient {
+    /**
+     * Send a message to a Slack channel
+     *
+     * @example
+     * ```typescript
+     * const result = await client.slack.sendMessage({
+     *   channel: "C1234567890",
+     *   text: "Hello, World!"
+     * });
+     * ```
+     */
+    sendMessage(params: {
+        /** Channel, private group, or IM channel to send message to */
+        channel: string;
+        /** Text of the message to send */
+        text: string;
+        /** Thread timestamp to reply in a thread */
+        thread_ts?: string;
+        /** Disable link previews */
+        unfurl_links?: boolean;
+        /** Disable media previews */
+        unfurl_media?: boolean;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * List channels in the workspace
+     *
+     * @example
+     * ```typescript
+     * const channels = await client.slack.listChannels({
+     *   types: "public_channel,private_channel"
+     * });
+     * ```
+     */
+    listChannels(params?: {
+        /** Mix and match channel types */
+        types?: string;
+        /** Exclude archived channels */
+        exclude_archived?: boolean;
+        /** Limit results */
+        limit?: number;
+        /** Pagination cursor */
+        cursor?: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get information about a channel
+     *
+     * @example
+     * ```typescript
+     * const channel = await client.slack.getChannel({
+     *   channel: "C1234567890"
+     * });
+     * ```
+     */
+    getChannel(params: {
+        /** Channel to get info for */
+        channel: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * List users in the workspace
+     *
+     * @example
+     * ```typescript
+     * const users = await client.slack.listUsers({
+     *   limit: 100
+     * });
+     * ```
+     */
+    listUsers(params?: {
+        /** Limit results */
+        limit?: number;
+        /** Pagination cursor */
+        cursor?: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Get information about a user
+     *
+     * @example
+     * ```typescript
+     * const user = await client.slack.getUser({
+     *   user: "U1234567890"
+     * });
+     * ```
+     */
+    getUser(params: {
+        /** User to get info for */
+        user: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * List messages in a channel
+     *
+     * @example
+     * ```typescript
+     * const messages = await client.slack.listMessages({
+     *   channel: "C1234567890",
+     *   limit: 50
+     * });
+     * ```
+     */
+    listMessages(params: {
+        /** Channel to fetch messages from */
+        channel: string;
+        /** Number of messages to return */
+        limit?: number;
+        /** Start of time range */
+        oldest?: string;
+        /** End of time range */
+        latest?: string;
+        /** Pagination cursor */
+        cursor?: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Add a reaction to a message
+     *
+     * @example
+     * ```typescript
+     * await client.slack.addReaction({
+     *   channel: "C1234567890",
+     *   timestamp: "1234567890.123456",
+     *   name: "thumbsup"
+     * });
+     * ```
+     */
+    addReaction(params: {
+        /** Channel where the message is */
+        channel: string;
+        /** Timestamp of the message */
+        timestamp: string;
+        /** Reaction emoji name (without colons) */
+        name: string;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Search for messages
+     *
+     * @example
+     * ```typescript
+     * const results = await client.slack.searchMessages({
+     *   query: "important announcement"
+     * });
+     * ```
+     */
+    searchMessages(params: {
+        /** Search query */
+        query: string;
+        /** Sort order (score or timestamp) */
+        sort?: "score" | "timestamp";
+        /** Sort direction */
+        sort_dir?: "asc" | "desc";
+        /** Number of results per page */
+        count?: number;
+        /** Page number */
+        page?: number;
+    }): Promise<MCPToolCallResponse>;
+    /**
+     * Upload a file to Slack
+     *
+     * @example
+     * ```typescript
+     * await client.slack.uploadFile({
+     *   channels: "C1234567890",
+     *   content: "file content here",
+     *   filename: "example.txt"
+     * });
+     * ```
+     */
+    uploadFile(params: {
+        /** Comma-separated list of channel IDs */
+        channels?: string;
+        /** File contents */
+        content?: string;
+        /** Filename */
+        filename?: string;
+        /** File type identifier */
+        filetype?: string;
+        /** Initial comment */
+        initial_comment?: string;
+        /** Title of file */
+        title?: string;
+    }): Promise<MCPToolCallResponse>;
+}
+//# sourceMappingURL=slack-client.d.ts.map

package/dist/src/integrations/slack-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-client.d.ts","sourceRoot":"","sources":["../../../src/integrations/slack-client.ts"],"names":[],"mappings":"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"}

package/dist/src/integrations/slack.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Slack Integration
+ * Enables Slack tools with OAuth configuration
+ */
+import type { MCPIntegration } from "./types.js";
+/**
+ * Slack integration configuration
+ *
+ * SERVER-SIDE: Automatically reads SLACK_CLIENT_ID and SLACK_CLIENT_SECRET from environment.
+ * You can override by providing explicit clientId and clientSecret values.
+ * CLIENT-SIDE: Omit clientId and clientSecret when using createMCPClient()
+ */
+export interface SlackIntegrationConfig {
+    /** Slack OAuth client ID (defaults to SLACK_CLIENT_ID env var) */
+    clientId?: string;
+    /** Slack OAuth client secret (defaults to SLACK_CLIENT_SECRET env var) */
+    clientSecret?: string;
+    /** Additional OAuth scopes (default: ['chat:write', 'channels:read', 'users:read']) */
+    scopes?: string[];
+    /** OAuth redirect URI */
+    redirectUri?: string;
+}
+/**
+ * Default Slack tools that this integration enables
+ * These should match the tool names exposed by your MCP server
+ */
+declare const SLACK_TOOLS: readonly ["slack_send_message", "slack_list_channels", "slack_get_channel", "slack_list_users", "slack_get_user", "slack_list_messages", "slack_add_reaction", "slack_search_messages", "slack_upload_file"];
+export declare function slackIntegration(config?: SlackIntegrationConfig): MCPIntegration<"slack">;
+/**
+ * Export tool names for type inference
+ */
+export type SlackTools = typeof SLACK_TOOLS[number];
+/**
+ * Export Slack client types
+ */
+export type { SlackIntegrationClient } from "./slack-client.js";
+//# sourceMappingURL=slack.d.ts.map

package/dist/src/integrations/slack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../../../src/integrations/slack.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,YAAY,CAAC;AAG9D;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,QAAA,MAAM,WAAW,8MAUP,CAAC;AAGX,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,sBAA2B,GAAG,cAAc,CAAC,OAAO,CAAC,CAyB7F;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;AAEpD;;GAEG;AACH,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}