bn-slack-mcp-server 0.0.1

package/dist/schemas.js

@@ -0,0 +1,840 @@
+/**
+ * Zod schemas for Slack MCP Server tools
+ *
+ * Each schema includes comprehensive .describe() documentation for LLM-friendly usage.
+ * Descriptions include: use cases, examples, parameter relationships, and best practices.
+ */
+import { z } from "zod";
+// ============================================================================
+// Conversation Tools (5)
+// ============================================================================
+export const ConversationsHistorySchema = z.object({
+    channel_id: z.string().describe(`The Slack channel or direct message to fetch messages from.
+
+**Accepted Formats:**
+1. **Channel ID** (recommended for reliability):
+   - Public channels: C followed by 10 alphanumeric chars (e.g., "C01ABC2DEF3")
+   - Private channels: C or G followed by 10 chars (e.g., "G01ABC2DEF3")
+   - Direct messages: D followed by 10 chars (e.g., "D01ABC2DEF3")
+   - Group DMs: G followed by 10 chars
+
+2. **Channel Name** (auto-resolved to ID):
+   - "#general" - Public channel named "general"
+   - "#engineering-team" - Channel with hyphenated name
+   - "#project-alpha-2024" - Any public/private channel name
+
+3. **DM Shortcut** (opens/finds DM with user):
+   - "@john" - DM with user named john
+   - "@john_dm" - Alternative DM format
+   - "@john.smith" - User with period in name
+
+**How to Find Channel IDs:**
+- Use \`channels_list\` tool with channel_types="public_channel,private_channel"
+- From Slack URL: https://workspace.slack.com/archives/C01ABC2DEF3 → "C01ABC2DEF3"
+- In Slack app: Right-click channel → "Copy link" → extract ID from URL
+
+**Best Practice:** Use channel IDs for reliability; names may change.`),
+    limit: z.string().optional().default("1d").describe(`Controls how many messages to retrieve. Accepts time-based OR numeric formats.
+
+**Time-Based Limits (Recommended for recent messages):**
+- "1d" - Messages from the last 1 day (DEFAULT)
+- "2d" - Messages from the last 2 days
+- "1w" - Messages from the last 7 days (1 week)
+- "2w" - Messages from the last 14 days
+- "30d" - Messages from the last 30 days
+- "90d" - Messages from the last 90 days
+
+**Numeric Limits (For fixed count):**
+- "10" - Last 10 messages
+- "50" - Last 50 messages
+- "100" - Last 100 messages
+- "500" - Last 500 messages
+- "1000" - Maximum 1000 messages (API limit)
+
+**Choosing the Right Limit:**
+- For daily standups/recent activity: "1d" or "2d"
+- For weekly summaries: "1w"
+- For project retrospectives: "30d"
+- For specific message count: Use numeric like "50"
+- For high-traffic channels: Use time-based to avoid overwhelming data
+
+**Note:** Time-based limits internally set limit=1000 with oldest timestamp filter.`),
+    include_activity_messages: z.boolean().optional().default(false).describe(`Whether to include system/activity messages in the response.
+
+**When false (DEFAULT):** Only user-posted messages are returned. Best for:
+- Reading actual conversations
+- Summarizing discussions
+- Searching for specific content
+
+**When true:** Includes system messages like:
+- "john joined the channel"
+- "jane left the channel"
+- "Channel topic changed to: Q4 Planning"
+- "Channel purpose updated"
+- Bot integration messages
+- App notifications
+
+**Use Cases for true:**
+- Auditing channel membership changes
+- Tracking when users joined/left
+- Understanding channel timeline including config changes`),
+    include_user_details: z.boolean().optional().default(true).describe(`Whether to enrich each message with detailed user information.
+
+**When true (DEFAULT):** Each message includes user_details object:
+{
+  "user": "U01ABC2DEF3",
+  "user_details": {
+    "username": "john.smith",
+    "real_name": "John Smith",
+    "display_name": "John",
+    "is_bot": false
+  }
+}
+
+**Benefits:**
+- Immediately see WHO sent each message
+- No need for separate user_info calls
+- Useful for generating readable summaries
+
+**When false:** Only user ID is included (e.g., "user": "U01ABC2DEF3")
+- Faster response
+- Smaller payload
+- Use when you only need message content`),
+    cursor: z.string().optional().describe(`Pagination cursor for fetching additional messages beyond the first page.
+
+**How Pagination Works:**
+1. First call: Don't provide cursor
+2. Check response: Look for "has_more": true and "next_cursor": "dXNlc..."
+3. Next call: Pass the next_cursor value as cursor parameter
+4. Repeat until has_more is false
+
+**Example Flow:**
+Call 1: conversations_history(channel_id="#general", limit="100")
+Response: { messages: [...100...], has_more: true, next_cursor: "dXNlc..." }
+
+Call 2: conversations_history(channel_id="#general", limit="100", cursor="dXNlc...")
+Response: { messages: [...100...], has_more: true, next_cursor: "abc123..." }
+
+Call 3: ... continue until has_more: false
+
+**Note:** Cursor is typically not needed with time-based limits unless channel is very active.`),
+});
+export const ConversationsRepliesSchema = z.object({
+    channel_id: z.string().describe(`The channel containing the thread. Same formats as conversations_history:
+- Channel ID: "C01ABC2DEF3" (recommended)
+- Channel name: "#general", "#engineering"
+- DM: "@username" or "@username_dm"
+
+**Important:** The channel_id must match where the thread exists.
+Threads in DMs use the DM channel ID.`),
+    thread_ts: z.string().describe(`The timestamp of the parent message (thread starter).
+
+**Format:** Unix timestamp with microseconds as a string.
+Example: "1609459200.000100" (6 digits before dot, 6 after)
+
+**How to Find thread_ts:**
+1. From conversations_history response: Look for messages with "reply_count" > 0
+   The "ts" field of that message is the thread_ts
+
+2. From Slack URL: https://workspace.slack.com/archives/C01ABC/p1609459200000100
+   - Remove 'p' prefix: 1609459200000100
+   - Insert decimal: 1609459200.000100
+
+3. From message object: Use the "ts" field of the parent message
+
+**Example:**
+Parent message: { "ts": "1609459200.000100", "text": "Let's discuss...", "reply_count": 5 }
+To get replies: conversations_replies(channel_id="C01ABC", thread_ts="1609459200.000100")`),
+    limit: z.string().optional().default("1d").describe(`Limit for thread replies. Same format as conversations_history:
+- Time-based: "1d", "1w", "30d"
+- Numeric: "50", "100"
+
+Most threads have fewer than 100 replies, so numeric "100" usually gets all.`),
+    include_activity_messages: z.boolean().optional().default(false).describe(`Include system messages within the thread (rare in threads).`),
+    cursor: z.string().optional().describe(`Pagination cursor for long threads. Use next_cursor from previous response.`),
+});
+export const ConversationsAddMessageSchema = z.object({
+    channel_id: z.string().describe(`Where to post the message.
+
+**Accepted Formats:**
+- Channel ID: "C01ABC2DEF3" (most reliable)
+- Channel name: "#general", "#announcements"
+- DM to user: "@john" (creates/uses existing DM)
+- DM by ID: "D01ABC2DEF3"
+
+**Permissions Required:**
+- Public channels: chat:write scope
+- Private channels: Must be a member + chat:write
+- DMs: im:write scope
+
+**Tips:**
+- Use channel IDs to avoid issues with renamed channels
+- For DMs, @username will automatically open the DM conversation`),
+    payload: z.string().describe(`The message content to send.
+
+**Plain Text:**
+Just type your message: "Hello team!"
+
+**Slack Formatting (mrkdwn):**
+- *bold* → **bold text**
+- _italic_ → _italic text_
+- ~strikethrough~ → ~~struck through~~
+- \`code\` → inline code
+- \`\`\`code block\`\`\` → multi-line code
+
+**Links:**
+- Auto-linked: https://example.com
+- Named link: <https://example.com|Click here>
+
+**Mentions:**
+- User: <@U01ABC2DEF3> or @username (auto-resolved)
+- Channel: <#C01ABC2DEF3> or #channel-name
+- @here: <!here> - notify active members
+- @channel: <!channel> - notify all members
+
+**Emojis:**
+- :thumbsup: :rocket: :white_check_mark:
+- Custom workspace emojis work too
+
+**Lists:**
+• Bullet point (use • character)
+1. Numbered list
+
+**Example Messages:**
+- Status update: "Deployment complete :white_check_mark:"
+- Question: "Hey <@U01ABC2DEF3>, can you review the PR?"
+- Announcement: "*Important:* Team meeting at 3pm <!here>"`),
+    thread_ts: z.string().optional().describe(`Optional: Reply to a specific thread instead of posting a new message.
+
+**When to Use:**
+- Replying to a question in a thread
+- Keeping related discussion together
+- Following up on a previous message
+
+**Format:** Same as thread_ts in conversations_replies
+Example: "1609459200.000100"
+
+**How to Get thread_ts:**
+- From the parent message's "ts" field
+- From conversations_history response
+
+**Behavior:**
+- If provided: Posts as reply in that thread
+- If omitted: Posts as new message in channel`),
+    content_type: z.string().optional().default("text/markdown").describe(`Content type of the message payload.
+
+**Options:**
+- "text/markdown" (DEFAULT): Markdown syntax is converted to Slack mrkdwn
+  - **bold** → *bold*
+  - __italic__ → _italic_
+
+- "text/plain": Message sent as-is without conversion
+  - Use when you want literal asterisks
+  - Use for pre-formatted content
+
+Most use cases should use the default "text/markdown".`),
+});
+export const ConversationsSearchMessagesSchema = z.object({
+    search_query: z.string().optional().describe(`The search term(s) to find in messages, OR a Slack message URL.
+
+**Simple Text Search:**
+- "quarterly report" - Messages containing these words
+- "bug fix" - Messages about bug fixes
+- "deployment" - Deployment-related messages
+
+**Phrase Search (exact match):**
+- "\\"release notes\\"" - Exact phrase
+- "\\"action items\\"" - Exact phrase match
+
+**URL Lookup (retrieve specific message):**
+- Paste a Slack message URL directly:
+  "https://workspace.slack.com/archives/C01ABC/p1609459200000100"
+- The tool will parse the URL and return that exact message
+
+**Combining with Filters:**
+For precise results, combine search_query with filter parameters:
+- search_query="deployment" + filter_in_channel="#engineering"
+- search_query="review" + filter_users_from="@john"
+- search_query="bug" + filter_date_after="2024-01-01"
+
+**Note:** Either search_query OR at least one filter is required.`),
+    filter_in_channel: z.string().optional().describe(`Restrict search to a specific channel.
+
+**Formats:**
+- "#channel-name" - Channel by name
+- "C01ABC2DEF3" - Channel by ID
+
+**Examples:**
+- "#engineering" - Only engineering channel
+- "#support" - Only support channel
+
+**Use Case:** Find discussions about a topic within a specific team's channel.`),
+    filter_in_im_or_mpim: z.string().optional().describe(`Restrict search to a DM or group DM conversation.
+
+**Formats:**
+- "@username" - DM with specific user
+- "D01ABC2DEF3" - DM by channel ID
+- "G01ABC2DEF3" - Group DM by ID
+
+**Use Case:** Find past discussion with a specific colleague.`),
+    filter_users_from: z.string().optional().describe(`Only messages sent BY a specific user.
+
+**Formats:**
+- "@john" - Messages from user john
+- "@john.smith" - User with period in name
+- "U01ABC2DEF3" - User by ID
+
+**Use Case:**
+- Find all updates posted by a team lead
+- Review what a specific person said about a topic`),
+    filter_users_with: z.string().optional().describe(`Messages in conversations that include a specific user.
+
+**Formats:** Same as filter_users_from
+
+**Difference from filter_users_from:**
+- filter_users_from: Messages SENT BY the user
+- filter_users_with: Messages in channels/DMs WHERE the user is present
+
+**Use Case:** Find all conversations a user was part of (even if they didn't send the message).`),
+    filter_date_before: z.string().optional().describe(`Messages sent BEFORE this date (exclusive).
+
+**Formats:**
+- "2024-01-15" - Before January 15, 2024
+- "2024-12-01" - Before December 1, 2024
+- "yesterday" - Before yesterday
+- "last week" - Before last week started
+
+**Examples:**
+- Find old discussions: filter_date_before="2023-01-01"
+- Q4 messages: filter_date_before="2024-01-01" + filter_date_after="2023-10-01"`),
+    filter_date_after: z.string().optional().describe(`Messages sent AFTER this date (exclusive).
+
+**Formats:**
+- "2024-01-01" - After January 1, 2024
+- "2024-06-15" - After June 15, 2024
+- "yesterday" - After yesterday
+- "last month" - After last month started
+
+**Examples:**
+- Recent discussions: filter_date_after="2024-11-01"
+- This year: filter_date_after="2024-01-01"`),
+    filter_date_on: z.string().optional().describe(`Messages sent ON a specific date only.
+
+**Formats:**
+- "2024-01-15" - On January 15, 2024 only
+- "today" - Today only
+- "yesterday" - Yesterday only
+
+**Use Case:** Find what was discussed on a specific day (e.g., day of an incident).`),
+    filter_date_during: z.string().optional().describe(`Messages during a named time period.
+
+**Formats:**
+- "today" - Today's messages
+- "yesterday" - Yesterday's messages
+- "this week" - Current week
+- "last week" - Previous week
+- "this month" - Current month
+- "last month" - Previous month
+- "January" - During January (current or recent year)
+- "Q4" - Fourth quarter
+
+**Examples:**
+- "January" - All January messages
+- "last month" - Previous month's messages`),
+    filter_threads_only: z.boolean().optional().default(false).describe(`Only return messages that are part of threads.
+
+**When true:** Only returns:
+- Thread parent messages (with replies)
+- Thread reply messages
+
+**Use Case:**
+- Find threaded discussions (indicates deeper conversations)
+- Ignore simple announcements without engagement`),
+    limit: z.number().optional().default(20).describe(`Maximum number of search results to return.
+
+**Range:** 1 to 100
+**Default:** 20
+
+**Recommendations:**
+- Quick lookup: 10-20
+- Comprehensive search: 50-100
+- Finding specific message: 10
+
+**Note:** Results are sorted by relevance/timestamp.`),
+    cursor: z.string().optional().describe(`Pagination cursor for more search results. Use next_cursor from previous response.`),
+});
+export const BulkConversationsHistorySchema = z.object({
+    channel_ids: z.string().describe(`Comma-separated list of channels to fetch messages from.
+
+**Formats (can be mixed):**
+- "#general, #engineering, #support"
+- "C01ABC, C02DEF, C03GHI"
+- "#general, C01ABC, @john_dm"
+
+**Examples:**
+- All team channels: "#frontend, #backend, #devops"
+- Project channels: "#project-alpha, #project-beta"
+- Mix: "#general, @john, C01ABC2DEF3"
+
+**Why Use This Instead of Multiple conversations_history Calls:**
+1. **Performance:** Single cache load for all channels
+2. **Efficiency:** Better rate limit management
+3. **Convenience:** Results organized by channel
+
+**Response Structure:**
+{
+  "channels": [
+    { "channel_id": "C01ABC", "messages": [...], "message_count": 50 },
+    { "channel_id": "C02DEF", "messages": [...], "message_count": 30 }
+  ],
+  "summary": { "total_messages": 80, "api_calls": 2 }
+}
+
+**Limit:** Reasonable limit is 5-10 channels per call to avoid timeout.`),
+    limit: z.string().optional().default("1d").describe(`Message limit PER CHANNEL (not total). Same format as conversations_history:
+- "1d" (DEFAULT) - Last 24 hours from each channel
+- "1w" - Last 7 days from each channel
+- "50" - Last 50 messages from each channel
+
+**Tip:** Use time-based limits for consistent date ranges across channels.`),
+    include_user_details: z.boolean().optional().default(true).describe(`Enrich messages with user details (name, display_name). Default: true.
+
+Uses single cached user lookup for efficiency across all channels.`),
+    include_activity_messages: z.boolean().optional().default(false).describe(`Include system/activity messages. Default: false.`),
+    filter_user: z.string().optional().describe(`Filter to only return messages from a specific user across ALL channels.
+
+**Formats:**
+- "@username" - By username
+- "U01ABC2DEF3" - By user ID
+- "john.doe" - By name (without @)
+
+**Use Case:** See all messages from a specific person across multiple channels.
+Great for reviewing someone's updates across the organization.`),
+});
+// ============================================================================
+// User Tools (3)
+// ============================================================================
+export const UsersListSchema = z.object({
+    filter_type: z.string().optional().default("active").describe(`Filter users by their account status.
+
+**Options:**
+- "active" (DEFAULT) - Users with active accounts (not deleted)
+  - Best for: Finding current team members
+
+- "deleted" - Only deactivated/deleted users
+  - Best for: Auditing removed accounts
+
+- "admins" - Only workspace administrators
+  - Best for: Finding who has admin privileges
+
+- "all" - All users regardless of status
+  - Best for: Complete user audit
+
+**Note:** This tool always uses cached data (24h TTL) for performance.`),
+    include_bots: z.boolean().optional().default(false).describe(`Whether to include bot users in results.
+
+**When false (DEFAULT):** Only human users returned
+- Best for: Team member lists
+- Skips Slackbot, integration bots, apps
+
+**When true:** Includes all bot accounts
+- Useful for: Auditing installed apps/integrations
+- Bot users have is_bot: true in response`),
+    limit: z.number().optional().default(50).describe(`Maximum number of users to return.
+
+**Default:** 50
+**Set to 0:** Returns all users (no limit)
+
+**Recommendations:**
+- Small team lookup: 20-50
+- Full organization: 0 (unlimited)
+- Quick check: 10-20
+
+**Note:** Results come from cache, so large limits are fast.`),
+});
+export const UserInfoSchema = z.object({
+    user_ids: z.string().describe(`One or more users to get detailed information about.
+
+**Single User:**
+- "@john" - By username
+- "@john.smith" - Username with period
+- "U01ABC2DEF3" - By user ID
+- "john" - Without @ (also works)
+
+**Multiple Users (comma-separated):**
+- "@john, @jane, @bob"
+- "U01ABC, U02DEF, U03GHI"
+- "@john, U01ABC2DEF3" - Mixed formats
+
+**What's Returned:**
+- Full profile (name, email, title, phone)
+- Status (deleted, admin, bot)
+- Timezone information
+- Profile image URLs
+
+**Name Matching:** Flexibly matches:
+- username (e.g., "john.smith")
+- display_name (e.g., "John")
+- real_name (e.g., "John Smith")`),
+    use_cache: z.boolean().optional().default(true).describe(`Whether to try the local cache before making API calls.
+
+**When true (DEFAULT):**
+- Faster response (no API call if cached)
+- Data may be up to 24 hours old
+- Best for: Most lookups
+
+**When false:**
+- Always fetches fresh data from Slack API
+- Slower but guaranteed current
+- Best for: When you need real-time accuracy`),
+});
+export const UserPresenceSchema = z.object({
+    user_id: z.string().describe(`The user to check presence status for.
+
+**Formats:**
+- "@username" - By username
+- "U01ABC2DEF3" - By user ID
+
+**Returns:**
+- presence: "active" or "away"
+- online: true/false
+- auto_away: true if Slack set away automatically
+- manual_away: true if user set away manually
+- last_activity: timestamp of last activity
+
+**Use Cases:**
+- Check if someone is available before messaging
+- Verify if a user is currently online
+- See when someone was last active`),
+});
+// ============================================================================
+// Channel Tools (6)
+// ============================================================================
+export const ChannelInfoSchema = z.object({
+    channel_id: z.string().describe(`The channel to get information about.
+
+**Formats:**
+- "C01ABC2DEF3" - Channel ID (recommended)
+- "#general" - Channel name
+- "@username_dm" - DM channel
+
+**Returns:**
+- Basic info: name, id, created timestamp
+- Content: topic, purpose
+- Membership: member_count, is_member
+- Status: is_archived, is_private`),
+    include_locale: z.boolean().optional().default(false).describe(`Include locale/language information for the channel.
+
+Usually not needed. Set true for internationalization needs.`),
+    use_cache: z.boolean().optional().default(true).describe(`Try local cache first (6h TTL for channels).
+
+**true (DEFAULT):** Fast response from cache
+**false:** Fresh data from Slack API`),
+});
+export const ChannelMembersSchema = z.object({
+    channel_id: z.string().describe(`The channel to list members of.
+
+**Formats:**
+- "C01ABC2DEF3" - Channel ID
+- "#general" - Channel name
+
+**Returns:** List of members with:
+- User ID
+- Username, real_name, display_name
+- Admin status
+- Bot status`),
+    limit: z.number().optional().default(100).describe(`Maximum members to return.
+
+**Range:** 1 to 1000
+**Default:** 100
+
+For large channels, use pagination with cursor.`),
+    cursor: z.string().optional().describe(`Pagination cursor from previous response. Use for channels with 100+ members.`),
+});
+export const ChannelsListSchema = z.object({
+    channel_types: z.string().describe(`Types of channels to list (comma-separated).
+
+**Channel Types:**
+- "public_channel" - Public channels anyone can join
+- "private_channel" - Private channels (only those you're in)
+- "im" - Direct messages (1:1 conversations)
+- "mpim" - Multi-person direct messages (group DMs)
+
+**Common Combinations:**
+- "public_channel" - Just public channels
+- "public_channel,private_channel" - All regular channels
+- "im,mpim" - All direct messages
+- "public_channel,private_channel,im,mpim" - Everything
+
+**Note:** You can only see private channels you're a member of.`),
+    sort: z.string().optional().describe(`Sort order for results.
+
+**Options:**
+- "popularity" - Sort by member count (most members first)
+- (omit) - Default order from Slack API
+
+**Use Case:** Find most active/popular channels with sort="popularity"`),
+    limit: z.number().optional().default(100).describe(`Maximum channels to return.
+
+**Range:** 1 to 999
+**Default:** 100`),
+    cursor: z.string().optional().describe(`Pagination cursor for workspaces with many channels.`),
+});
+export const ChannelsDetailedSchema = z.object({
+    channel_types: z.string().optional().default("public_channel,private_channel").describe(`Channel types to fetch. Same options as channels_list.
+
+**Default:** "public_channel,private_channel"`),
+    sort: z.string().optional().describe(`Sort by "popularity" (member count) or omit for default order.`),
+    limit: z.number().optional().default(100).describe(`Maximum channels (1-999). Default: 100.`),
+    include_detailed_info: z.boolean().optional().default(false).describe(`Fetch extra details with additional API calls.
+
+**When false (DEFAULT):**
+- Single API call
+- Basic channel info
+- Fast and efficient
+
+**When true:**
+- Makes additional conversations.info call per channel
+- Gets full channel details
+- Slower but more complete
+
+**Recommendation:** Use false unless you need every detail.`),
+});
+export const SetChannelTopicSchema = z.object({
+    channel_id: z.string().describe(`Channel to update topic.
+
+**Formats:** "C01ABC2DEF3" or "#channel-name"
+
+**Permissions:** Must be able to edit channel (member with permissions or admin).`),
+    topic: z.string().describe(`New topic text for the channel.
+
+**Display:** Shows at the top of the channel
+**Max Length:** 250 characters
+**Formatting:** Plain text only (no markdown)
+
+**Examples:**
+- "Q4 Planning - Meeting Thursdays at 2pm"
+- "Support escalations - @oncall for urgent issues"
+- "Read-only announcements channel"`),
+});
+export const SetChannelPurposeSchema = z.object({
+    channel_id: z.string().describe(`Channel to update purpose.
+
+**Formats:** "C01ABC2DEF3" or "#channel-name"`),
+    purpose: z.string().describe(`New purpose text for the channel.
+
+**Display:** Shows in channel details/about section
+**Max Length:** 250 characters
+**Use:** Describes what the channel is for
+
+**Examples:**
+- "Engineering team discussions and updates"
+- "Customer support ticket overflow and escalations"
+- "Random watercooler chat and team bonding"`),
+});
+// ============================================================================
+// Message Tools (2)
+// ============================================================================
+export const MessagePermalinkSchema = z.object({
+    channel_id: z.string().describe(`Channel containing the message.
+
+**Formats:** "C01ABC2DEF3" or "#channel-name"`),
+    message_ts: z.string().describe(`Timestamp of the message to get permalink for.
+
+**Format:** "1609459200.000100" (Unix timestamp with microseconds)
+
+**Source:** From the "ts" field in any message object from conversations_history or search results.
+
+**Returns:** Permanent URL like:
+https://workspace.slack.com/archives/C01ABC/p1609459200000100`),
+});
+export const AddReactionSchema = z.object({
+    channel_id: z.string().describe(`Channel containing the message to react to.
+
+**Formats:** "C01ABC2DEF3" or "#channel-name"`),
+    message_ts: z.string().describe(`Timestamp of the message to add reaction to.
+
+**Format:** "1609459200.000100"
+**Source:** From message "ts" field`),
+    emoji_name: z.string().describe(`Emoji name WITHOUT the surrounding colons.
+
+**Format:** Just the name, not :name:
+
+**Common Emojis:**
+- "thumbsup" (👍) - NOT ":thumbsup:"
+- "thumbsdown" (👎)
+- "heart" (❤️)
+- "rocket" (🚀)
+- "eyes" (👀)
+- "white_check_mark" (✅)
+- "x" (❌)
+- "thinking_face" (🤔)
+- "tada" (🎉)
+- "fire" (🔥)
+- "+1" (same as thumbsup)
+- "-1" (same as thumbsdown)
+
+**Custom Emojis:** Your workspace's custom emojis also work.
+Find them in Slack: Type : in message field to see available emojis.`),
+});
+// ============================================================================
+// Files Tool (1)
+// ============================================================================
+export const FilesListSchema = z.object({
+    channel_id: z.string().optional().describe(`Filter to files shared in a specific channel.
+
+**Formats:** "C01ABC2DEF3" or "#channel-name"
+
+**Omit:** Returns files from all accessible channels`),
+    user_id: z.string().optional().describe(`Filter to files uploaded by a specific user.
+
+**Formats:** "@username" or "U01ABC2DEF3"
+
+**Omit:** Returns files from all users`),
+    count: z.number().optional().default(10).describe(`Number of files to return.
+
+**Range:** 1 to 1000
+**Default:** 10
+
+**Recommendation:** Start with 10-20, increase if needed.`),
+    types: z.string().optional().default("all").describe(`Filter by file type(s).
+
+**Options:**
+- "all" (DEFAULT) - All file types
+- "images" - png, jpg, gif, etc.
+- "videos" - mp4, mov, etc.
+- "pdfs" - PDF documents
+- "docs" - Documents (doc, docx)
+- "gdocs" - Google Docs
+- "zips" - Compressed archives
+- "spaces" - Slack posts/snippets
+
+**Multiple types:** Comma-separated
+- "images,pdfs" - Images and PDFs
+- "docs,gdocs,pdfs" - All document types`),
+});
+// ============================================================================
+// Workspace Tool (1)
+// ============================================================================
+export const WorkspaceInfoSchema = z.object({}).describe(`Get information about the current Slack workspace/team.
+
+**No parameters required.**
+
+**Returns:**
+- id: Team/workspace ID (T01ABC2DEF3)
+- name: Workspace name ("My Company")
+- domain: Slack domain (mycompany.slack.com → "mycompany")
+- email_domain: Email domain for members
+- enterprise_id: Enterprise Grid ID (if applicable)
+- enterprise_name: Enterprise Grid name (if applicable)
+
+**Required Scope:** team:read
+
+**Use Cases:**
+- Verify which workspace you're connected to
+- Get workspace domain for building URLs
+- Check Enterprise Grid membership`);
+// ============================================================================
+// Cache Tools (3)
+// ============================================================================
+export const InitializeCacheSchema = z.object({}).describe(`Pre-populate local caches with users and channels from Slack API.
+
+**No parameters required.**
+
+**What It Does:**
+1. Fetches all users → Saves to ~/slack-cache/users_cache.json
+2. Fetches all channels → Saves to ~/slack-cache/channels_cache_v2.json
+
+**Why Use This:**
+- Call at START of a session
+- Subsequent tools using @username or #channel will be faster
+- Name resolution (e.g., "#general" → "C01ABC") uses cache
+- users_list and channel_info use cache first
+
+**Cache Duration:**
+- Users: 24 hours TTL
+- Channels: 6 hours TTL
+
+**Best Practice:** Call initialize_cache once when starting work.`);
+export const CacheInfoSchema = z.object({}).describe(`Get details about the local cache files.
+
+**No parameters required.**
+
+**Returns:**
+- File paths (absolute locations)
+- File sizes (KB)
+- Last modified times
+- Age in hours
+- Freshness status (is_fresh)
+
+**Use Cases:**
+- Debug why name resolution isn't working
+- Check if cache is stale
+- Verify cache was created successfully`);
+export const ClearCacheSchema = z.object({
+    cache_type: z.enum(["users", "channels", "both"]).optional().default("both").describe(`Which cache file(s) to delete.
+
+**Options:**
+- "both" (DEFAULT) - Clear users AND channels cache
+- "users" - Clear only users cache
+- "channels" - Clear only channels cache
+
+**After Clearing:**
+Cache files will be recreated on next API call that needs them.
+
+**Use Cases:**
+- Force refresh when data seems stale
+- After workspace changes (new users, new channels)
+- Troubleshooting resolution issues`),
+});
+// ============================================================================
+// System Tools (2)
+// ============================================================================
+export const CheckPermissionsSchema = z.object({}).describe(`Test what Slack API scopes/permissions the current token has.
+
+**No parameters required.**
+
+**Tests These Scopes:**
+- users:read - Can list users
+- channels:read - Can list public channels
+- groups:read - Can list private channels
+- im:read - Can list DMs
+- mpim:read - Can list group DMs
+- team:read - Can get workspace info
+- channels:history - Can read messages
+- chat:write - Can send messages
+
+**Returns:**
+- Status for each scope (Available/Failed)
+- Summary: available_scopes, failed_scopes
+- Recommendations for cache/messaging
+
+**Use Cases:**
+- Debug "permission denied" errors
+- Verify token has needed scopes
+- Check what operations are possible`);
+export const AnalyticsSummarySchema = z.object({
+    date_range: z.string().optional().default("30d").describe(`Time period for analytics (affects label, not actual data).
+
+**Options:**
+- "7d" - Label as 7-day period
+- "30d" (DEFAULT) - Label as 30-day period
+- "90d" - Label as 90-day period
+
+**Note:** This tool uses CACHED data, so actual analytics are based on
+cached user/channel data, not historical message data.`),
+}).describe(`Get basic workspace analytics from cached data.
+
+**Returns:**
+- User stats: total, active (non-deleted), bots, admins
+- Channel stats: public, private, DMs, group DMs
+
+**Data Source:** Uses cached users/channels data
+- Not real-time activity metrics
+- Provides snapshot of workspace structure
+
+**Use Cases:**
+- Quick workspace overview
+- Understand team size
+- Count channels by type`);
+//# sourceMappingURL=schemas.js.map